diff --git a/.github/workflows/conformance-tests-bigtable-proxy.yaml b/.github/workflows/conformance-tests-bigtable-proxy.yaml index f47bea282396..fd0dc52ec468 100644 --- a/.github/workflows/conformance-tests-bigtable-proxy.yaml +++ b/.github/workflows/conformance-tests-bigtable-proxy.yaml @@ -31,7 +31,7 @@ jobs: runs-on: ubuntu-latest steps: - name: Checkout code - uses: actions/checkout@v5 + uses: actions/checkout@v6 - name: Setup PHP uses: shivammathur/setup-php@v2 @@ -40,7 +40,7 @@ jobs: extensions: grpc - name: Checkout Bigtable conformance tests - uses: actions/checkout@v5 + uses: actions/checkout@v6 with: repository: googleapis/cloud-bigtable-clients-test ref: v0.0.3 diff --git a/.github/workflows/conformance-tests-storage-emulator.yaml b/.github/workflows/conformance-tests-storage-emulator.yaml index 1057fc210805..d4ca0240229f 100644 --- a/.github/workflows/conformance-tests-storage-emulator.yaml +++ b/.github/workflows/conformance-tests-storage-emulator.yaml @@ -22,7 +22,7 @@ jobs: steps: - name: Checkout code - uses: actions/checkout@v5 + uses: actions/checkout@v6 - name: Setup PHP uses: shivammathur/setup-php@v2 diff --git a/.github/workflows/docs.yaml b/.github/workflows/docs.yaml index d210042ce30f..b5601be3f345 100644 --- a/.github/workflows/docs.yaml +++ b/.github/workflows/docs.yaml @@ -12,7 +12,7 @@ jobs: env: PHPDOC_ENV: prod steps: - - uses: actions/checkout@v5 + - uses: actions/checkout@v6 - name: Setup Python uses: actions/setup-python@v6 with: diff --git a/.github/workflows/emulator-system-tests-bigtable.yaml b/.github/workflows/emulator-system-tests-bigtable.yaml index fc49ee42f6a4..c9d4d6df8a3f 100644 --- a/.github/workflows/emulator-system-tests-bigtable.yaml +++ b/.github/workflows/emulator-system-tests-bigtable.yaml @@ -19,7 +19,7 @@ jobs: name: Bigtable runs-on: ubuntu-latest steps: - - uses: actions/checkout@v5 + - uses: actions/checkout@v6 - run: ./.github/emulator/start-emulator.sh bigtable 522.0.0-emulators diff --git a/.github/workflows/emulator-system-tests-datastore.yaml b/.github/workflows/emulator-system-tests-datastore.yaml index b562e9931b83..3ed465d21a3a 100644 --- a/.github/workflows/emulator-system-tests-datastore.yaml +++ b/.github/workflows/emulator-system-tests-datastore.yaml @@ -19,7 +19,7 @@ jobs: name: Datastore runs-on: ubuntu-latest steps: - - uses: actions/checkout@v5 + - uses: actions/checkout@v6 - run: ./.github/emulator/start-emulator.sh datastore 522.0.0-emulators diff --git a/.github/workflows/emulator-system-tests-firestore.yaml b/.github/workflows/emulator-system-tests-firestore.yaml index b95a4a45c4ec..5b0c23036fda 100644 --- a/.github/workflows/emulator-system-tests-firestore.yaml +++ b/.github/workflows/emulator-system-tests-firestore.yaml @@ -19,7 +19,7 @@ jobs: name: Firestore runs-on: ubuntu-latest steps: - - uses: actions/checkout@v5 + - uses: actions/checkout@v6 - run: ./.github/emulator/start-emulator.sh firestore 522.0.0-emulators diff --git a/.github/workflows/emulator-system-tests-pubsub.yaml b/.github/workflows/emulator-system-tests-pubsub.yaml index 222139fb55e4..58a5a88c8d69 100644 --- a/.github/workflows/emulator-system-tests-pubsub.yaml +++ b/.github/workflows/emulator-system-tests-pubsub.yaml @@ -19,7 +19,7 @@ jobs: name: PubSub runs-on: ubuntu-latest steps: - - uses: actions/checkout@v5 + - uses: actions/checkout@v6 - run: ./.github/emulator/start-emulator.sh pubsub diff --git a/.github/workflows/emulator-system-tests-spanner.yaml b/.github/workflows/emulator-system-tests-spanner.yaml index bf0e79356063..413ee6fdfd8d 100644 --- a/.github/workflows/emulator-system-tests-spanner.yaml +++ b/.github/workflows/emulator-system-tests-spanner.yaml @@ -25,7 +25,7 @@ jobs: steps: - name: Checkout code - uses: actions/checkout@v5 + uses: actions/checkout@v6 - name: Create Spanner instance uses: google-github-actions/setup-gcloud@v3 diff --git a/.github/workflows/lint.yaml b/.github/workflows/lint.yaml index 6698bc0488c1..c3c7e51f6908 100644 --- a/.github/workflows/lint.yaml +++ b/.github/workflows/lint.yaml @@ -12,7 +12,7 @@ jobs: runs-on: ubuntu-latest name: PHP Style Check steps: - - uses: actions/checkout@v5 + - uses: actions/checkout@v6 - name: Setup PHP uses: shivammathur/setup-php@v2 with: @@ -52,7 +52,7 @@ jobs: runs-on: ubuntu-latest name: PHPStan Static Analysis steps: - - uses: actions/checkout@v5 + - uses: actions/checkout@v6 - name: Install PHP uses: shivammathur/setup-php@v2 with: diff --git a/.github/workflows/owlbot-checks.yaml b/.github/workflows/owlbot-checks.yaml index da0a68929ad2..b38bde250e8d 100644 --- a/.github/workflows/owlbot-checks.yaml +++ b/.github/workflows/owlbot-checks.yaml @@ -12,7 +12,7 @@ jobs: runs-on: ubuntu-latest if: github.event.pull_request.user.login == 'gcf-owl-bot[bot]' steps: - - uses: actions/checkout@v5 + - uses: actions/checkout@v6 with: fetch-depth: 0 - name: "Install PHP" @@ -47,7 +47,7 @@ jobs: runs-on: ubuntu-latest if: github.event.pull_request.user.login == 'gcf-owl-bot[bot]' && github.event.pull_request.draft == false steps: - - uses: actions/checkout@v5 + - uses: actions/checkout@v6 - name: Ensure run: | directory_to_check="owl-bot-staging" diff --git a/.github/workflows/release-checks.yaml b/.github/workflows/release-checks.yaml index d53eb3e3575f..5305c365c25f 100644 --- a/.github/workflows/release-checks.yaml +++ b/.github/workflows/release-checks.yaml @@ -11,7 +11,7 @@ jobs: name: Breaking Change Detector runs-on: ubuntu-latest steps: - - uses: actions/checkout@v5 + - uses: actions/checkout@v6 with: fetch-depth: 0 - name: "Install PHP" @@ -58,7 +58,7 @@ jobs: runs-on: ubuntu-latest if: github.event.pull_request.user.login == 'release-please[bot]' steps: - - uses: actions/checkout@v5 + - uses: actions/checkout@v6 with: fetch-depth: 0 - name: Parse allowed major versions @@ -99,7 +99,7 @@ jobs: runs-on: ubuntu-latest if: github.event.pull_request.user.login == 'release-please[bot]' steps: - - uses: actions/checkout@v5 + - uses: actions/checkout@v6 with: fetch-depth: 0 - name: "Verify the subrepos exist for new components" diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml index c78ddffe64cf..c8dcf7a76d1a 100644 --- a/.github/workflows/release.yml +++ b/.github/workflows/release.yml @@ -41,7 +41,7 @@ jobs: go build -o splitsh-lite github.com/splitsh/lite mv splitsh-lite /usr/local/bin/splitsh-lite - name: Checkout google/cloud - uses: actions/checkout@v5 + uses: actions/checkout@v6 with: persist-credentials: false fetch-depth: 0 diff --git a/.github/workflows/system-tests.yaml b/.github/workflows/system-tests.yaml index eb7f5119bda8..50e90b5f622c 100644 --- a/.github/workflows/system-tests.yaml +++ b/.github/workflows/system-tests.yaml @@ -12,7 +12,7 @@ jobs: env: ASSET_TEST_BUCKET: cloud-php-testdata steps: - - uses: actions/checkout@v5 + - uses: actions/checkout@v6 with: fetch-depth: 0 - name: Setup PHP diff --git a/.github/workflows/unit-tests.yaml b/.github/workflows/unit-tests.yaml index 9959b5eec87d..76f273cd7e1a 100644 --- a/.github/workflows/unit-tests.yaml +++ b/.github/workflows/unit-tests.yaml @@ -24,7 +24,7 @@ jobs: runs-on: ${{ matrix.platform }} continue-on-error: true steps: - - uses: actions/checkout@v5 + - uses: actions/checkout@v6 - name: Setup cache environment id: extcache uses: shivammathur/cache-extensions@v1 @@ -61,7 +61,7 @@ jobs: name: Package Tests runs-on: ubuntu-latest steps: - - uses: actions/checkout@v5 + - uses: actions/checkout@v6 - name: Setup PHP uses: shivammathur/setup-php@verbose with: @@ -74,7 +74,7 @@ jobs: name: Package Tests (Lowest Dependencies) runs-on: ubuntu-latest steps: - - uses: actions/checkout@v5 + - uses: actions/checkout@v6 - name: Setup PHP uses: shivammathur/setup-php@verbose with: @@ -89,7 +89,7 @@ jobs: name: Dev Commands Unit Tests runs-on: ubuntu-latest steps: - - uses: actions/checkout@v5 + - uses: actions/checkout@v6 - name: Setup PHP uses: shivammathur/setup-php@verbose with: diff --git a/AiPlatform/metadata/V1/FeatureOnlineStore.php b/AiPlatform/metadata/V1/FeatureOnlineStore.php index a78a2db7abc5..df1108e6bba6 100644 Binary files a/AiPlatform/metadata/V1/FeatureOnlineStore.php and b/AiPlatform/metadata/V1/FeatureOnlineStore.php differ diff --git a/AiPlatform/src/V1/FeatureOnlineStore/Bigtable.php b/AiPlatform/src/V1/FeatureOnlineStore/Bigtable.php index fe4d5ba899ef..2ebb1b9fd53b 100644 --- a/AiPlatform/src/V1/FeatureOnlineStore/Bigtable.php +++ b/AiPlatform/src/V1/FeatureOnlineStore/Bigtable.php @@ -32,6 +32,14 @@ class Bigtable extends \Google\Protobuf\Internal\Message * Generated from protobuf field .google.cloud.aiplatform.v1.FeatureOnlineStore.Bigtable.BigtableMetadata bigtable_metadata = 4 [(.google.api.field_behavior) = OUTPUT_ONLY]; */ protected $bigtable_metadata = null; + /** + * Optional. The zone where the underlying Bigtable cluster for the primary + * Bigtable instance will be provisioned. Only the zone must be provided. + * For example, only "us-central1-a" should be provided. + * + * Generated from protobuf field string zone = 5 [(.google.api.field_behavior) = OPTIONAL]; + */ + protected $zone = ''; /** * Constructor. @@ -46,6 +54,10 @@ class Bigtable extends \Google\Protobuf\Internal\Message * not. * @type \Google\Cloud\AIPlatform\V1\FeatureOnlineStore\Bigtable\BigtableMetadata $bigtable_metadata * Output only. Metadata of the Bigtable instance. Output only. + * @type string $zone + * Optional. The zone where the underlying Bigtable cluster for the primary + * Bigtable instance will be provisioned. Only the zone must be provided. + * For example, only "us-central1-a" should be provided. * } */ public function __construct($data = NULL) { @@ -153,6 +165,36 @@ public function setBigtableMetadata($var) return $this; } + /** + * Optional. The zone where the underlying Bigtable cluster for the primary + * Bigtable instance will be provisioned. Only the zone must be provided. + * For example, only "us-central1-a" should be provided. + * + * Generated from protobuf field string zone = 5 [(.google.api.field_behavior) = OPTIONAL]; + * @return string + */ + public function getZone() + { + return $this->zone; + } + + /** + * Optional. The zone where the underlying Bigtable cluster for the primary + * Bigtable instance will be provisioned. Only the zone must be provided. + * For example, only "us-central1-a" should be provided. + * + * Generated from protobuf field string zone = 5 [(.google.api.field_behavior) = OPTIONAL]; + * @param string $var + * @return $this + */ + public function setZone($var) + { + GPBUtil::checkString($var, True); + $this->zone = $var; + + return $this; + } + } diff --git a/AiPlatform/src/V1/ReplicatedVoiceConfig.php b/AiPlatform/src/V1/ReplicatedVoiceConfig.php index 996bcc893cb0..2d07d7ee3b06 100644 --- a/AiPlatform/src/V1/ReplicatedVoiceConfig.php +++ b/AiPlatform/src/V1/ReplicatedVoiceConfig.php @@ -16,9 +16,10 @@ class ReplicatedVoiceConfig extends \Google\Protobuf\Internal\Message { /** - * Optional. The mimetype of the voice sample. Currently only - * mime_type=audio/pcm is supported, which is raw mono 16-bit signed - * little-endian pcm data, with 24k sampling rate. + * Optional. The mimetype of the voice sample. The only currently supported + * value is `audio/wav`. This represents 16-bit signed little-endian wav data, + * with a 24kHz sampling rate. `mime_type` will default to `audio/wav` if not + * set. * * Generated from protobuf field string mime_type = 1 [(.google.api.field_behavior) = OPTIONAL]; */ @@ -37,9 +38,10 @@ class ReplicatedVoiceConfig extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $mime_type - * Optional. The mimetype of the voice sample. Currently only - * mime_type=audio/pcm is supported, which is raw mono 16-bit signed - * little-endian pcm data, with 24k sampling rate. + * Optional. The mimetype of the voice sample. The only currently supported + * value is `audio/wav`. This represents 16-bit signed little-endian wav data, + * with a 24kHz sampling rate. `mime_type` will default to `audio/wav` if not + * set. * @type string $voice_sample_audio * Optional. The sample of the custom voice. * } @@ -50,9 +52,10 @@ public function __construct($data = NULL) { } /** - * Optional. The mimetype of the voice sample. Currently only - * mime_type=audio/pcm is supported, which is raw mono 16-bit signed - * little-endian pcm data, with 24k sampling rate. + * Optional. The mimetype of the voice sample. The only currently supported + * value is `audio/wav`. This represents 16-bit signed little-endian wav data, + * with a 24kHz sampling rate. `mime_type` will default to `audio/wav` if not + * set. * * Generated from protobuf field string mime_type = 1 [(.google.api.field_behavior) = OPTIONAL]; * @return string @@ -63,9 +66,10 @@ public function getMimeType() } /** - * Optional. The mimetype of the voice sample. Currently only - * mime_type=audio/pcm is supported, which is raw mono 16-bit signed - * little-endian pcm data, with 24k sampling rate. + * Optional. The mimetype of the voice sample. The only currently supported + * value is `audio/wav`. This represents 16-bit signed little-endian wav data, + * with a 24kHz sampling rate. `mime_type` will default to `audio/wav` if not + * set. * * Generated from protobuf field string mime_type = 1 [(.google.api.field_behavior) = OPTIONAL]; * @param string $var diff --git a/ArtifactRegistry/metadata/V1/Export.php b/ArtifactRegistry/metadata/V1/Export.php new file mode 100644 index 000000000000..24207ffe4ff3 Binary files /dev/null and b/ArtifactRegistry/metadata/V1/Export.php differ diff --git a/ArtifactRegistry/metadata/V1/Service.php b/ArtifactRegistry/metadata/V1/Service.php index 2fa797ac764f..65dff8b97c45 100644 --- a/ArtifactRegistry/metadata/V1/Service.php +++ b/ArtifactRegistry/metadata/V1/Service.php @@ -19,6 +19,7 @@ public static function initOnce() { \GPBMetadata\Google\Devtools\Artifactregistry\V1\AptArtifact::initOnce(); \GPBMetadata\Google\Devtools\Artifactregistry\V1\Artifact::initOnce(); \GPBMetadata\Google\Devtools\Artifactregistry\V1\Attachment::initOnce(); + \GPBMetadata\Google\Devtools\Artifactregistry\V1\Export::initOnce(); \GPBMetadata\Google\Devtools\Artifactregistry\V1\File::initOnce(); \GPBMetadata\Google\Devtools\Artifactregistry\V1\Package::initOnce(); \GPBMetadata\Google\Devtools\Artifactregistry\V1\Repository::initOnce(); @@ -34,9 +35,9 @@ public static function initOnce() { \GPBMetadata\Google\Protobuf\GPBEmpty::initOnce(); $pool->internalAddGeneratedFile( ' -` -1google/devtools/artifactregistry/v1/service.proto#google.devtools.artifactregistry.v1google/api/client.proto6google/devtools/artifactregistry/v1/apt_artifact.proto2google/devtools/artifactregistry/v1/artifact.proto4google/devtools/artifactregistry/v1/attachment.proto.google/devtools/artifactregistry/v1/file.proto1google/devtools/artifactregistry/v1/package.proto4google/devtools/artifactregistry/v1/repository.proto.google/devtools/artifactregistry/v1/rule.proto2google/devtools/artifactregistry/v1/settings.proto-google/devtools/artifactregistry/v1/tag.proto1google/devtools/artifactregistry/v1/version.proto6google/devtools/artifactregistry/v1/vpcsc_config.proto6google/devtools/artifactregistry/v1/yum_artifact.protogoogle/iam/v1/iam_policy.protogoogle/iam/v1/policy.proto#google/longrunning/operations.protogoogle/protobuf/empty.proto" -OperationMetadata2W +c +1google/devtools/artifactregistry/v1/service.proto#google.devtools.artifactregistry.v1google/api/client.proto6google/devtools/artifactregistry/v1/apt_artifact.proto2google/devtools/artifactregistry/v1/artifact.proto4google/devtools/artifactregistry/v1/attachment.proto0google/devtools/artifactregistry/v1/export.proto.google/devtools/artifactregistry/v1/file.proto1google/devtools/artifactregistry/v1/package.proto4google/devtools/artifactregistry/v1/repository.proto.google/devtools/artifactregistry/v1/rule.proto2google/devtools/artifactregistry/v1/settings.proto-google/devtools/artifactregistry/v1/tag.proto1google/devtools/artifactregistry/v1/version.proto6google/devtools/artifactregistry/v1/vpcsc_config.proto6google/devtools/artifactregistry/v1/yum_artifact.protogoogle/iam/v1/iam_policy.protogoogle/iam/v1/policy.proto#google/longrunning/operations.protogoogle/protobuf/empty.proto" +OperationMetadata2Z ArtifactRegistry ListDockerImages<.google.devtools.artifactregistry.v1.ListDockerImagesRequest=.google.devtools.artifactregistry.v1.ListDockerImagesResponse"PAparentA?/v1/{parent=projects/*/locations/*/repositories/*}/dockerImages GetDockerImage:.google.devtools.artifactregistry.v1.GetDockerImageRequest0.google.devtools.artifactregistry.v1.DockerImage"NAnameA?/v1/{name=projects/*/locations/*/repositories/*/dockerImages/*} @@ -106,7 +107,9 @@ public static function initOnce() { .google.devtools.artifactregistry.v1.Attachment5google.devtools.artifactregistry.v1.OperationMetadataAparent,attachment,attachment_idL">/v1/{parent=projects/*/locations/*/repositories/*}/attachments: attachment DeleteAttachment<.google.devtools.artifactregistry.v1.DeleteAttachmentRequest.google.longrunning.Operation"AN -google.protobuf.Empty5google.devtools.artifactregistry.v1.OperationMetadataAname@*>/v1/{name=projects/*/locations/*/repositories/*/attachments/*}Aartifactregistry.googleapis.comAghttps://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/cloud-platform.read-onlyB +google.protobuf.Empty5google.devtools.artifactregistry.v1.OperationMetadataAname@*>/v1/{name=projects/*/locations/*/repositories/*/attachments/*} +ExportArtifact:.google.devtools.artifactregistry.v1.ExportArtifactRequest.google.longrunning.Operation"Ax +:google.devtools.artifactregistry.v1.ExportArtifactResponse:google.devtools.artifactregistry.v1.ExportArtifactMetadataJ"E/v1/{repository=projects/*/locations/*/repositories/*}:exportArtifact:*Aartifactregistry.googleapis.comAghttps://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/cloud-platform.read-onlyB \'com.google.devtools.artifactregistry.v1B ServiceProtoPZPcloud.google.com/go/artifactregistry/apiv1/artifactregistrypb;artifactregistrypb Google.Cloud.ArtifactRegistry.V1 Google\\Cloud\\ArtifactRegistry\\V1#Google::Cloud::ArtifactRegistry::V1bproto3' , true); diff --git a/ArtifactRegistry/samples/V1/ArtifactRegistryClient/export_artifact.php b/ArtifactRegistry/samples/V1/ArtifactRegistryClient/export_artifact.php new file mode 100644 index 000000000000..0b1f28c100ac --- /dev/null +++ b/ArtifactRegistry/samples/V1/ArtifactRegistryClient/export_artifact.php @@ -0,0 +1,88 @@ +setRepository($formattedRepository); + + // Call the API and handle any network failures. + try { + /** @var OperationResponse $response */ + $response = $artifactRegistryClient->exportArtifact($request); + $response->pollUntilComplete(); + + if ($response->operationSucceeded()) { + /** @var ExportArtifactResponse $result */ + $result = $response->getResult(); + printf('Operation successful with response data: %s' . PHP_EOL, $result->serializeToJsonString()); + } else { + /** @var Status $error */ + $error = $response->getError(); + printf('Operation failed with error data: %s' . PHP_EOL, $error->serializeToJsonString()); + } + } catch (ApiException $ex) { + printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage()); + } +} + +/** + * Helper to execute the sample. + * + * This sample has been automatically generated and should be regarded as a code + * template only. It will require modifications to work: + * - It may require correct/in-range values for request initialization. + * - It may require specifying regional endpoints when creating the service client, + * please see the apiEndpoint client configuration option for more details. + */ +function callSample(): void +{ + $formattedRepository = ArtifactRegistryClient::repositoryName( + '[PROJECT]', + '[LOCATION]', + '[REPOSITORY]' + ); + + export_artifact_sample($formattedRepository); +} +// [END artifactregistry_v1_generated_ArtifactRegistry_ExportArtifact_sync] diff --git a/ArtifactRegistry/src/V1/Client/ArtifactRegistryClient.php b/ArtifactRegistry/src/V1/Client/ArtifactRegistryClient.php index 68a016548e0c..20b43644ab1a 100644 --- a/ArtifactRegistry/src/V1/Client/ArtifactRegistryClient.php +++ b/ArtifactRegistry/src/V1/Client/ArtifactRegistryClient.php @@ -49,6 +49,8 @@ use Google\Cloud\ArtifactRegistry\V1\DeleteTagRequest; use Google\Cloud\ArtifactRegistry\V1\DeleteVersionRequest; use Google\Cloud\ArtifactRegistry\V1\DockerImage; +use Google\Cloud\ArtifactRegistry\V1\ExportArtifactRequest; +use Google\Cloud\ArtifactRegistry\V1\ExportArtifactResponse; use Google\Cloud\ArtifactRegistry\V1\File; use Google\Cloud\ArtifactRegistry\V1\GetAttachmentRequest; use Google\Cloud\ArtifactRegistry\V1\GetDockerImageRequest; @@ -144,6 +146,7 @@ * @method PromiseInterface deleteRuleAsync(DeleteRuleRequest $request, array $optionalArgs = []) * @method PromiseInterface deleteTagAsync(DeleteTagRequest $request, array $optionalArgs = []) * @method PromiseInterface deleteVersionAsync(DeleteVersionRequest $request, array $optionalArgs = []) + * @method PromiseInterface exportArtifactAsync(ExportArtifactRequest $request, array $optionalArgs = []) * @method PromiseInterface getAttachmentAsync(GetAttachmentRequest $request, array $optionalArgs = []) * @method PromiseInterface getDockerImageAsync(GetDockerImageRequest $request, array $optionalArgs = []) * @method PromiseInterface getFileAsync(GetFileRequest $request, array $optionalArgs = []) @@ -1057,6 +1060,32 @@ public function deleteVersion(DeleteVersionRequest $request, array $callOptions return $this->startApiCall('DeleteVersion', $request, $callOptions)->wait(); } + /** + * Exports an artifact. + * + * The async variant is {@see ArtifactRegistryClient::exportArtifactAsync()} . + * + * @example samples/V1/ArtifactRegistryClient/export_artifact.php + * + * @param ExportArtifactRequest $request A request to house fields associated with the call. + * @param array $callOptions { + * Optional. + * + * @type RetrySettings|array $retrySettings + * Retry settings to use for this call. Can be a {@see RetrySettings} object, or an + * associative array of retry settings parameters. See the documentation on + * {@see RetrySettings} for example usage. + * } + * + * @return OperationResponse + * + * @throws ApiException Thrown if the API call fails. + */ + public function exportArtifact(ExportArtifactRequest $request, array $callOptions = []): OperationResponse + { + return $this->startApiCall('ExportArtifact', $request, $callOptions)->wait(); + } + /** * Gets an attachment. * diff --git a/ArtifactRegistry/src/V1/ExportArtifactMetadata.php b/ArtifactRegistry/src/V1/ExportArtifactMetadata.php new file mode 100644 index 000000000000..7ff2bff0d699 --- /dev/null +++ b/ArtifactRegistry/src/V1/ExportArtifactMetadata.php @@ -0,0 +1,67 @@ +google.devtools.artifactregistry.v1.ExportArtifactMetadata + */ +class ExportArtifactMetadata extends \Google\Protobuf\Internal\Message +{ + /** + * The exported artifact files. + * + * Generated from protobuf field repeated .google.devtools.artifactregistry.v1.ExportArtifactMetadata.ExportedFile exported_files = 1; + */ + private $exported_files; + + /** + * Constructor. + * + * @param array $data { + * Optional. Data for populating the Message object. + * + * @type array<\Google\Cloud\ArtifactRegistry\V1\ExportArtifactMetadata\ExportedFile>|\Google\Protobuf\Internal\RepeatedField $exported_files + * The exported artifact files. + * } + */ + public function __construct($data = NULL) { + \GPBMetadata\Google\Devtools\Artifactregistry\V1\Export::initOnce(); + parent::__construct($data); + } + + /** + * The exported artifact files. + * + * Generated from protobuf field repeated .google.devtools.artifactregistry.v1.ExportArtifactMetadata.ExportedFile exported_files = 1; + * @return \Google\Protobuf\Internal\RepeatedField + */ + public function getExportedFiles() + { + return $this->exported_files; + } + + /** + * The exported artifact files. + * + * Generated from protobuf field repeated .google.devtools.artifactregistry.v1.ExportArtifactMetadata.ExportedFile exported_files = 1; + * @param array<\Google\Cloud\ArtifactRegistry\V1\ExportArtifactMetadata\ExportedFile>|\Google\Protobuf\Internal\RepeatedField $var + * @return $this + */ + public function setExportedFiles($var) + { + $arr = GPBUtil::checkRepeatedField($var, \Google\Protobuf\Internal\GPBType::MESSAGE, \Google\Cloud\ArtifactRegistry\V1\ExportArtifactMetadata\ExportedFile::class); + $this->exported_files = $arr; + + return $this; + } + +} + diff --git a/ArtifactRegistry/src/V1/ExportArtifactMetadata/ExportedFile.php b/ArtifactRegistry/src/V1/ExportArtifactMetadata/ExportedFile.php new file mode 100644 index 000000000000..edd748f96e0d --- /dev/null +++ b/ArtifactRegistry/src/V1/ExportArtifactMetadata/ExportedFile.php @@ -0,0 +1,151 @@ +google.devtools.artifactregistry.v1.ExportArtifactMetadata.ExportedFile + */ +class ExportedFile extends \Google\Protobuf\Internal\Message +{ + /** + * Name of the exported artifact file. + * Format: `projects/p1/locations/us/repositories/repo1/files/file1` + * + * Generated from protobuf field string name = 1 [(.google.api.resource_reference) = { + */ + protected $name = ''; + /** + * The hashes of the file content. + * + * Generated from protobuf field repeated .google.devtools.artifactregistry.v1.Hash hashes = 3; + */ + private $hashes; + protected $destination; + + /** + * Constructor. + * + * @param array $data { + * Optional. Data for populating the Message object. + * + * @type string $gcs_object_path + * Cloud Storage Object path of the exported file. Examples: + * `dst_bucket/file1`, `dst_bucket/sub_dir/file1` + * @type string $name + * Name of the exported artifact file. + * Format: `projects/p1/locations/us/repositories/repo1/files/file1` + * @type array<\Google\Cloud\ArtifactRegistry\V1\Hash>|\Google\Protobuf\Internal\RepeatedField $hashes + * The hashes of the file content. + * } + */ + public function __construct($data = NULL) { + \GPBMetadata\Google\Devtools\Artifactregistry\V1\Export::initOnce(); + parent::__construct($data); + } + + /** + * Cloud Storage Object path of the exported file. Examples: + * `dst_bucket/file1`, `dst_bucket/sub_dir/file1` + * + * Generated from protobuf field string gcs_object_path = 2; + * @return string + */ + public function getGcsObjectPath() + { + return $this->readOneof(2); + } + + public function hasGcsObjectPath() + { + return $this->hasOneof(2); + } + + /** + * Cloud Storage Object path of the exported file. Examples: + * `dst_bucket/file1`, `dst_bucket/sub_dir/file1` + * + * Generated from protobuf field string gcs_object_path = 2; + * @param string $var + * @return $this + */ + public function setGcsObjectPath($var) + { + GPBUtil::checkString($var, True); + $this->writeOneof(2, $var); + + return $this; + } + + /** + * Name of the exported artifact file. + * Format: `projects/p1/locations/us/repositories/repo1/files/file1` + * + * Generated from protobuf field string name = 1 [(.google.api.resource_reference) = { + * @return string + */ + public function getName() + { + return $this->name; + } + + /** + * Name of the exported artifact file. + * Format: `projects/p1/locations/us/repositories/repo1/files/file1` + * + * Generated from protobuf field string name = 1 [(.google.api.resource_reference) = { + * @param string $var + * @return $this + */ + public function setName($var) + { + GPBUtil::checkString($var, True); + $this->name = $var; + + return $this; + } + + /** + * The hashes of the file content. + * + * Generated from protobuf field repeated .google.devtools.artifactregistry.v1.Hash hashes = 3; + * @return \Google\Protobuf\Internal\RepeatedField + */ + public function getHashes() + { + return $this->hashes; + } + + /** + * The hashes of the file content. + * + * Generated from protobuf field repeated .google.devtools.artifactregistry.v1.Hash hashes = 3; + * @param array<\Google\Cloud\ArtifactRegistry\V1\Hash>|\Google\Protobuf\Internal\RepeatedField $var + * @return $this + */ + public function setHashes($var) + { + $arr = GPBUtil::checkRepeatedField($var, \Google\Protobuf\Internal\GPBType::MESSAGE, \Google\Cloud\ArtifactRegistry\V1\Hash::class); + $this->hashes = $arr; + + return $this; + } + + /** + * @return string + */ + public function getDestination() + { + return $this->whichOneof("destination"); + } + +} + + diff --git a/ArtifactRegistry/src/V1/ExportArtifactRequest.php b/ArtifactRegistry/src/V1/ExportArtifactRequest.php new file mode 100644 index 000000000000..99d3d1b4524b --- /dev/null +++ b/ArtifactRegistry/src/V1/ExportArtifactRequest.php @@ -0,0 +1,206 @@ +google.devtools.artifactregistry.v1.ExportArtifactRequest + */ +class ExportArtifactRequest extends \Google\Protobuf\Internal\Message +{ + /** + * Required. The repository of the artifact to export. + * Format: projects/{project}/locations/{location}/repositories/{repository} + * + * Generated from protobuf field string repository = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { + */ + protected $repository = ''; + protected $source_artifact; + protected $destination; + + /** + * Constructor. + * + * @param array $data { + * Optional. Data for populating the Message object. + * + * @type string $source_version + * The artifact version to export. + * Format: + * projects/{project}/locations/{location}/repositories/{repository}/packages/{package}/versions/{version} + * @type string $source_tag + * The artifact tag to export. + * Format:projects/{project}/locations/{location}/repositories/{repository}/packages/{package}/tags/{tag} + * @type string $gcs_path + * The Cloud Storage path to export the artifact to. Should start with the + * bucket name, and optionally have a directory path. Examples: + * `dst_bucket`, `dst_bucket/sub_dir`. + * Existing objects with the same path will be overwritten. + * @type string $repository + * Required. The repository of the artifact to export. + * Format: projects/{project}/locations/{location}/repositories/{repository} + * } + */ + public function __construct($data = NULL) { + \GPBMetadata\Google\Devtools\Artifactregistry\V1\Export::initOnce(); + parent::__construct($data); + } + + /** + * The artifact version to export. + * Format: + * projects/{project}/locations/{location}/repositories/{repository}/packages/{package}/versions/{version} + * + * Generated from protobuf field string source_version = 2 [(.google.api.resource_reference) = { + * @return string + */ + public function getSourceVersion() + { + return $this->readOneof(2); + } + + public function hasSourceVersion() + { + return $this->hasOneof(2); + } + + /** + * The artifact version to export. + * Format: + * projects/{project}/locations/{location}/repositories/{repository}/packages/{package}/versions/{version} + * + * Generated from protobuf field string source_version = 2 [(.google.api.resource_reference) = { + * @param string $var + * @return $this + */ + public function setSourceVersion($var) + { + GPBUtil::checkString($var, True); + $this->writeOneof(2, $var); + + return $this; + } + + /** + * The artifact tag to export. + * Format:projects/{project}/locations/{location}/repositories/{repository}/packages/{package}/tags/{tag} + * + * Generated from protobuf field string source_tag = 4 [(.google.api.resource_reference) = { + * @return string + */ + public function getSourceTag() + { + return $this->readOneof(4); + } + + public function hasSourceTag() + { + return $this->hasOneof(4); + } + + /** + * The artifact tag to export. + * Format:projects/{project}/locations/{location}/repositories/{repository}/packages/{package}/tags/{tag} + * + * Generated from protobuf field string source_tag = 4 [(.google.api.resource_reference) = { + * @param string $var + * @return $this + */ + public function setSourceTag($var) + { + GPBUtil::checkString($var, True); + $this->writeOneof(4, $var); + + return $this; + } + + /** + * The Cloud Storage path to export the artifact to. Should start with the + * bucket name, and optionally have a directory path. Examples: + * `dst_bucket`, `dst_bucket/sub_dir`. + * Existing objects with the same path will be overwritten. + * + * Generated from protobuf field string gcs_path = 3; + * @return string + */ + public function getGcsPath() + { + return $this->readOneof(3); + } + + public function hasGcsPath() + { + return $this->hasOneof(3); + } + + /** + * The Cloud Storage path to export the artifact to. Should start with the + * bucket name, and optionally have a directory path. Examples: + * `dst_bucket`, `dst_bucket/sub_dir`. + * Existing objects with the same path will be overwritten. + * + * Generated from protobuf field string gcs_path = 3; + * @param string $var + * @return $this + */ + public function setGcsPath($var) + { + GPBUtil::checkString($var, True); + $this->writeOneof(3, $var); + + return $this; + } + + /** + * Required. The repository of the artifact to export. + * Format: projects/{project}/locations/{location}/repositories/{repository} + * + * Generated from protobuf field string repository = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { + * @return string + */ + public function getRepository() + { + return $this->repository; + } + + /** + * Required. The repository of the artifact to export. + * Format: projects/{project}/locations/{location}/repositories/{repository} + * + * Generated from protobuf field string repository = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { + * @param string $var + * @return $this + */ + public function setRepository($var) + { + GPBUtil::checkString($var, True); + $this->repository = $var; + + return $this; + } + + /** + * @return string + */ + public function getSourceArtifact() + { + return $this->whichOneof("source_artifact"); + } + + /** + * @return string + */ + public function getDestination() + { + return $this->whichOneof("destination"); + } + +} + diff --git a/ArtifactRegistry/src/V1/ExportArtifactResponse.php b/ArtifactRegistry/src/V1/ExportArtifactResponse.php new file mode 100644 index 000000000000..ffd8bb634a87 --- /dev/null +++ b/ArtifactRegistry/src/V1/ExportArtifactResponse.php @@ -0,0 +1,81 @@ +google.devtools.artifactregistry.v1.ExportArtifactResponse + */ +class ExportArtifactResponse extends \Google\Protobuf\Internal\Message +{ + /** + * The exported version. Should be the same as the request version with + * fingerprint resource name. + * + * Generated from protobuf field .google.devtools.artifactregistry.v1.Version exported_version = 1; + */ + protected $exported_version = null; + + /** + * Constructor. + * + * @param array $data { + * Optional. Data for populating the Message object. + * + * @type \Google\Cloud\ArtifactRegistry\V1\Version $exported_version + * The exported version. Should be the same as the request version with + * fingerprint resource name. + * } + */ + public function __construct($data = NULL) { + \GPBMetadata\Google\Devtools\Artifactregistry\V1\Export::initOnce(); + parent::__construct($data); + } + + /** + * The exported version. Should be the same as the request version with + * fingerprint resource name. + * + * Generated from protobuf field .google.devtools.artifactregistry.v1.Version exported_version = 1; + * @return \Google\Cloud\ArtifactRegistry\V1\Version|null + */ + public function getExportedVersion() + { + return $this->exported_version; + } + + public function hasExportedVersion() + { + return isset($this->exported_version); + } + + public function clearExportedVersion() + { + unset($this->exported_version); + } + + /** + * The exported version. Should be the same as the request version with + * fingerprint resource name. + * + * Generated from protobuf field .google.devtools.artifactregistry.v1.Version exported_version = 1; + * @param \Google\Cloud\ArtifactRegistry\V1\Version $var + * @return $this + */ + public function setExportedVersion($var) + { + GPBUtil::checkMessage($var, \Google\Cloud\ArtifactRegistry\V1\Version::class); + $this->exported_version = $var; + + return $this; + } + +} + diff --git a/ArtifactRegistry/src/V1/gapic_metadata.json b/ArtifactRegistry/src/V1/gapic_metadata.json index 304e0a5ee2f2..e147f0a8f611 100644 --- a/ArtifactRegistry/src/V1/gapic_metadata.json +++ b/ArtifactRegistry/src/V1/gapic_metadata.json @@ -70,6 +70,11 @@ "deleteVersion" ] }, + "ExportArtifact": { + "methods": [ + "exportArtifact" + ] + }, "GetAttachment": { "methods": [ "getAttachment" diff --git a/ArtifactRegistry/src/V1/resources/artifact_registry_client_config.json b/ArtifactRegistry/src/V1/resources/artifact_registry_client_config.json index 665bff1a7b12..bf7f90af8a6c 100644 --- a/ArtifactRegistry/src/V1/resources/artifact_registry_client_config.json +++ b/ArtifactRegistry/src/V1/resources/artifact_registry_client_config.json @@ -86,6 +86,11 @@ "retry_codes_name": "no_retry_1_codes", "retry_params_name": "no_retry_1_params" }, + "ExportArtifact": { + "timeout_millis": 60000, + "retry_codes_name": "no_retry_1_codes", + "retry_params_name": "no_retry_1_params" + }, "GetAttachment": { "timeout_millis": 60000, "retry_codes_name": "no_retry_1_codes", diff --git a/ArtifactRegistry/src/V1/resources/artifact_registry_descriptor_config.php b/ArtifactRegistry/src/V1/resources/artifact_registry_descriptor_config.php index 326ffcd9825b..eb7efcbedc43 100644 --- a/ArtifactRegistry/src/V1/resources/artifact_registry_descriptor_config.php +++ b/ArtifactRegistry/src/V1/resources/artifact_registry_descriptor_config.php @@ -175,6 +175,25 @@ ], ], ], + 'ExportArtifact' => [ + 'longRunning' => [ + 'operationReturnType' => '\Google\Cloud\ArtifactRegistry\V1\ExportArtifactResponse', + 'metadataReturnType' => '\Google\Cloud\ArtifactRegistry\V1\ExportArtifactMetadata', + 'initialPollDelayMillis' => '500', + 'pollDelayMultiplier' => '1.5', + 'maxPollDelayMillis' => '5000', + 'totalPollTimeoutMillis' => '300000', + ], + 'callType' => \Google\ApiCore\Call::LONGRUNNING_CALL, + 'headerParams' => [ + [ + 'keyName' => 'repository', + 'fieldAccessors' => [ + 'getRepository', + ], + ], + ], + ], 'ImportAptArtifacts' => [ 'longRunning' => [ 'operationReturnType' => '\Google\Cloud\ArtifactRegistry\V1\ImportAptArtifactsResponse', diff --git a/ArtifactRegistry/src/V1/resources/artifact_registry_rest_client_config.php b/ArtifactRegistry/src/V1/resources/artifact_registry_rest_client_config.php index 29ec04db60ad..6b77510a39de 100644 --- a/ArtifactRegistry/src/V1/resources/artifact_registry_rest_client_config.php +++ b/ArtifactRegistry/src/V1/resources/artifact_registry_rest_client_config.php @@ -187,6 +187,18 @@ ], ], ], + 'ExportArtifact' => [ + 'method' => 'post', + 'uriTemplate' => '/v1/{repository=projects/*/locations/*/repositories/*}:exportArtifact', + 'body' => '*', + 'placeholders' => [ + 'repository' => [ + 'getters' => [ + 'getRepository', + ], + ], + ], + ], 'GetAttachment' => [ 'method' => 'get', 'uriTemplate' => '/v1/{name=projects/*/locations/*/repositories/*/attachments/*}', diff --git a/ArtifactRegistry/tests/Unit/V1/Client/ArtifactRegistryClientTest.php b/ArtifactRegistry/tests/Unit/V1/Client/ArtifactRegistryClientTest.php index 20b4f6314a50..70bad707821a 100644 --- a/ArtifactRegistry/tests/Unit/V1/Client/ArtifactRegistryClientTest.php +++ b/ArtifactRegistry/tests/Unit/V1/Client/ArtifactRegistryClientTest.php @@ -41,6 +41,8 @@ use Google\Cloud\ArtifactRegistry\V1\DeleteTagRequest; use Google\Cloud\ArtifactRegistry\V1\DeleteVersionRequest; use Google\Cloud\ArtifactRegistry\V1\DockerImage; +use Google\Cloud\ArtifactRegistry\V1\ExportArtifactRequest; +use Google\Cloud\ArtifactRegistry\V1\ExportArtifactResponse; use Google\Cloud\ArtifactRegistry\V1\File; use Google\Cloud\ArtifactRegistry\V1\GetAttachmentRequest; use Google\Cloud\ArtifactRegistry\V1\GetDockerImageRequest; @@ -1420,6 +1422,128 @@ public function deleteVersionExceptionTest() $this->assertTrue($operationsTransport->isExhausted()); } + /** @test */ + public function exportArtifactTest() + { + $operationsTransport = $this->createTransport(); + $operationsClient = new OperationsClient([ + 'apiEndpoint' => '', + 'transport' => $operationsTransport, + 'credentials' => $this->createCredentials(), + ]); + $transport = $this->createTransport(); + $gapicClient = $this->createClient([ + 'transport' => $transport, + 'operationsClient' => $operationsClient, + ]); + $this->assertTrue($transport->isExhausted()); + $this->assertTrue($operationsTransport->isExhausted()); + // Mock response + $incompleteOperation = new Operation(); + $incompleteOperation->setName('operations/exportArtifactTest'); + $incompleteOperation->setDone(false); + $transport->addResponse($incompleteOperation); + $expectedResponse = new ExportArtifactResponse(); + $anyResponse = new Any(); + $anyResponse->setValue($expectedResponse->serializeToString()); + $completeOperation = new Operation(); + $completeOperation->setName('operations/exportArtifactTest'); + $completeOperation->setDone(true); + $completeOperation->setResponse($anyResponse); + $operationsTransport->addResponse($completeOperation); + // Mock request + $formattedRepository = $gapicClient->repositoryName('[PROJECT]', '[LOCATION]', '[REPOSITORY]'); + $request = (new ExportArtifactRequest())->setRepository($formattedRepository); + $response = $gapicClient->exportArtifact($request); + $this->assertFalse($response->isDone()); + $this->assertNull($response->getResult()); + $apiRequests = $transport->popReceivedCalls(); + $this->assertSame(1, count($apiRequests)); + $operationsRequestsEmpty = $operationsTransport->popReceivedCalls(); + $this->assertSame(0, count($operationsRequestsEmpty)); + $actualApiFuncCall = $apiRequests[0]->getFuncCall(); + $actualApiRequestObject = $apiRequests[0]->getRequestObject(); + $this->assertSame('/google.devtools.artifactregistry.v1.ArtifactRegistry/ExportArtifact', $actualApiFuncCall); + $actualValue = $actualApiRequestObject->getRepository(); + $this->assertProtobufEquals($formattedRepository, $actualValue); + $expectedOperationsRequestObject = new GetOperationRequest(); + $expectedOperationsRequestObject->setName('operations/exportArtifactTest'); + $response->pollUntilComplete([ + 'initialPollDelayMillis' => 1, + ]); + $this->assertTrue($response->isDone()); + $this->assertEquals($expectedResponse, $response->getResult()); + $apiRequestsEmpty = $transport->popReceivedCalls(); + $this->assertSame(0, count($apiRequestsEmpty)); + $operationsRequests = $operationsTransport->popReceivedCalls(); + $this->assertSame(1, count($operationsRequests)); + $actualOperationsFuncCall = $operationsRequests[0]->getFuncCall(); + $actualOperationsRequestObject = $operationsRequests[0]->getRequestObject(); + $this->assertSame('/google.longrunning.Operations/GetOperation', $actualOperationsFuncCall); + $this->assertEquals($expectedOperationsRequestObject, $actualOperationsRequestObject); + $this->assertTrue($transport->isExhausted()); + $this->assertTrue($operationsTransport->isExhausted()); + } + + /** @test */ + public function exportArtifactExceptionTest() + { + $operationsTransport = $this->createTransport(); + $operationsClient = new OperationsClient([ + 'apiEndpoint' => '', + 'transport' => $operationsTransport, + 'credentials' => $this->createCredentials(), + ]); + $transport = $this->createTransport(); + $gapicClient = $this->createClient([ + 'transport' => $transport, + 'operationsClient' => $operationsClient, + ]); + $this->assertTrue($transport->isExhausted()); + $this->assertTrue($operationsTransport->isExhausted()); + // Mock response + $incompleteOperation = new Operation(); + $incompleteOperation->setName('operations/exportArtifactTest'); + $incompleteOperation->setDone(false); + $transport->addResponse($incompleteOperation); + $status = new stdClass(); + $status->code = Code::DATA_LOSS; + $status->details = 'internal error'; + $expectedExceptionMessage = json_encode( + [ + 'message' => 'internal error', + 'code' => Code::DATA_LOSS, + 'status' => 'DATA_LOSS', + 'details' => [], + ], + JSON_PRETTY_PRINT + ); + $operationsTransport->addResponse(null, $status); + // Mock request + $formattedRepository = $gapicClient->repositoryName('[PROJECT]', '[LOCATION]', '[REPOSITORY]'); + $request = (new ExportArtifactRequest())->setRepository($formattedRepository); + $response = $gapicClient->exportArtifact($request); + $this->assertFalse($response->isDone()); + $this->assertNull($response->getResult()); + $expectedOperationsRequestObject = new GetOperationRequest(); + $expectedOperationsRequestObject->setName('operations/exportArtifactTest'); + try { + $response->pollUntilComplete([ + 'initialPollDelayMillis' => 1, + ]); + // If the pollUntilComplete() method call did not throw, fail the test + $this->fail('Expected an ApiException, but no exception was thrown.'); + } catch (ApiException $ex) { + $this->assertEquals($status->code, $ex->getCode()); + $this->assertEquals($expectedExceptionMessage, $ex->getMessage()); + } + // Call popReceivedCalls to ensure the stubs are exhausted + $transport->popReceivedCalls(); + $operationsTransport->popReceivedCalls(); + $this->assertTrue($transport->isExhausted()); + $this->assertTrue($operationsTransport->isExhausted()); + } + /** @test */ public function getAttachmentTest() { diff --git a/BigQuery/tests/System/DatasetConditionalAccessTest.php b/BigQuery/tests/System/DatasetConditionalAccessTest.php new file mode 100644 index 000000000000..cce17cfdabbe --- /dev/null +++ b/BigQuery/tests/System/DatasetConditionalAccessTest.php @@ -0,0 +1,166 @@ +testDataset = self::createDataset( + self::$client, + uniqid(self::TESTING_PREFIX), + ['accessPolicyVersion' => 3] + ); + $projectId = $this->testDataset->identity()['projectId']; + $this->userEmail = $projectId . '@appspot.gserviceaccount.com'; + $this->iamMember = 'serviceAccount:' . $this->userEmail; + } + + public function tearDown(): void + { + $this->testDataset->delete(); + } + + public function testConditionalAccessUserReader() + { + $this->runConditionalAccessTest('userByEmail', $this->userEmail, 'READER'); + } + + public function testConditionalAccessUserWriter() + { + $this->runConditionalAccessTest('userByEmail', $this->userEmail, 'WRITER'); + } + + public function testConditionalAccessUserOwner() + { + $this->runConditionalAccessTest('userByEmail', $this->userEmail, 'OWNER'); + } + + public function testConditionalAccessGroupReader() + { + $this->runConditionalAccessTest('groupByEmail', $this->groupEmail, 'READER'); + } + + public function testConditionalAccessGroupWriter() + { + $this->runConditionalAccessTest('groupByEmail', $this->groupEmail, 'WRITER'); + } + + public function testConditionalAccessGroupOwner() + { + $this->runConditionalAccessTest('groupByEmail', $this->groupEmail, 'OWNER'); + } + + public function testConditionalAccessDomainReader() + { + $this->runConditionalAccessTest('domain', $this->domain, 'READER'); + } + + public function testConditionalAccessDomainWriter() + { + $this->runConditionalAccessTest('domain', $this->domain, 'WRITER'); + } + + public function testConditionalAccessDomainOwner() + { + $this->runConditionalAccessTest('domain', $this->domain, 'OWNER'); + } + + public function testConditionalAccessIamMemberReader() + { + $this->runConditionalAccessTest('iamMember', $this->iamMember, 'READER'); + } + + public function testConditionalAccessIamMemberWriter() + { + $this->runConditionalAccessTest('iamMember', $this->iamMember, 'WRITER'); + } + + public function testConditionalAccessIamMemberOwner() + { + $this->runConditionalAccessTest('iamMember', $this->iamMember, 'OWNER'); + } + + private function runConditionalAccessTest($scopeType, $scopeValue, $role) + { + // Define a condition for the access entry + $condition = [ + 'expression' => 'true', + 'title' => 'example title', + 'description' => 'example description', + 'location' => 'path/to/example/location' + ]; + + // Get the dataset + $info = $this->testDataset->info(); + + // Append the new access entry to the access array + $access = $info['access']; + + $access[] = [ + 'role' => $role, + $scopeType => $scopeValue, + 'condition' => $condition + ]; + + // Update the dataset with the new access entry + $info = $this->testDataset->update(['access' => $access], ['accessPolicyVersion' => 3]); + + // Handle iamMember special case for assertion + if ($scopeType === 'iamMember' && strpos($scopeValue, 'serviceAccount:') === 0) { + $scopeType = 'userByEmail'; + $scopeValue = explode(':', $scopeValue)[1]; + } + + // Verify the access entry was added + $this->assertCount(1, array_filter($info['access'], function ($acl) use ($scopeType, $scopeValue, $condition) { + return isset($acl[$scopeType]) + && $acl[$scopeType] === $scopeValue + && isset($acl['condition']) && $acl['condition'] === $condition; + })); + + // Get the dataset again and remove the access entry + $info = $this->testDataset->info(); + $access = array_filter($info['access'], function ($acl) use ($scopeType, $scopeValue, $condition) { + return !(isset($acl[$scopeType]) + && $acl[$scopeType] === $scopeValue + && isset($acl['condition']) && $acl['condition'] === $condition); + }); + + // Update the dataset to remove the access entry + $this->testDataset->update(['access' => $access], ['accessPolicyVersion' => 3]); + + // Verify the access entry was removed + $info = $this->testDataset->reload(); + $this->assertCount(0, array_filter($info['access'], function ($acl) use ($scopeType, $scopeValue, $condition) { + return isset($acl[$scopeType]) + && $acl[$scopeType] === $scopeValue + && isset($acl['condition']) && $acl['condition'] === $condition; + })); + } +} diff --git a/Channel/metadata/V1/Entitlements.php b/Channel/metadata/V1/Entitlements.php index a9d3b3ff11fb..3169b2a7f2c0 100644 Binary files a/Channel/metadata/V1/Entitlements.php and b/Channel/metadata/V1/Entitlements.php differ diff --git a/Channel/metadata/V1/Offers.php b/Channel/metadata/V1/Offers.php index 69ae176a8c16..466db5ddda65 100644 Binary files a/Channel/metadata/V1/Offers.php and b/Channel/metadata/V1/Offers.php differ diff --git a/Channel/metadata/V1/Repricing.php b/Channel/metadata/V1/Repricing.php index 38196573d89a..c78ebc9462ce 100644 Binary files a/Channel/metadata/V1/Repricing.php and b/Channel/metadata/V1/Repricing.php differ diff --git a/Channel/metadata/V1/Service.php b/Channel/metadata/V1/Service.php index 7e02d5f6bc99..4e3c9adee1e1 100644 Binary files a/Channel/metadata/V1/Service.php and b/Channel/metadata/V1/Service.php differ diff --git a/Channel/samples/V1/CloudChannelServiceClient/create_channel_partner_repricing_config.php b/Channel/samples/V1/CloudChannelServiceClient/create_channel_partner_repricing_config.php index 2d876790ee4d..eceaf28ae937 100644 --- a/Channel/samples/V1/CloudChannelServiceClient/create_channel_partner_repricing_config.php +++ b/Channel/samples/V1/CloudChannelServiceClient/create_channel_partner_repricing_config.php @@ -30,6 +30,7 @@ use Google\Cloud\Channel\V1\RebillingBasis; use Google\Cloud\Channel\V1\RepricingAdjustment; use Google\Cloud\Channel\V1\RepricingConfig; +use Google\Cloud\Channel\V1\RepricingConfig\EntitlementGranularity; use Google\Type\Date; /** @@ -93,9 +94,11 @@ function create_channel_partner_repricing_config_sample( $cloudChannelServiceClient = new CloudChannelServiceClient(); // Prepare the request message. + $channelPartnerRepricingConfigRepricingConfigEntitlementGranularity = new EntitlementGranularity(); $channelPartnerRepricingConfigRepricingConfigEffectiveInvoiceMonth = new Date(); $channelPartnerRepricingConfigRepricingConfigAdjustment = new RepricingAdjustment(); $channelPartnerRepricingConfigRepricingConfig = (new RepricingConfig()) + ->setEntitlementGranularity($channelPartnerRepricingConfigRepricingConfigEntitlementGranularity) ->setEffectiveInvoiceMonth($channelPartnerRepricingConfigRepricingConfigEffectiveInvoiceMonth) ->setAdjustment($channelPartnerRepricingConfigRepricingConfigAdjustment) ->setRebillingBasis($channelPartnerRepricingConfigRepricingConfigRebillingBasis); diff --git a/Channel/samples/V1/CloudChannelServiceClient/create_customer_repricing_config.php b/Channel/samples/V1/CloudChannelServiceClient/create_customer_repricing_config.php index 6366ab41ace2..eb57c55f867f 100644 --- a/Channel/samples/V1/CloudChannelServiceClient/create_customer_repricing_config.php +++ b/Channel/samples/V1/CloudChannelServiceClient/create_customer_repricing_config.php @@ -30,6 +30,7 @@ use Google\Cloud\Channel\V1\RebillingBasis; use Google\Cloud\Channel\V1\RepricingAdjustment; use Google\Cloud\Channel\V1\RepricingConfig; +use Google\Cloud\Channel\V1\RepricingConfig\EntitlementGranularity; use Google\Type\Date; /** @@ -92,9 +93,11 @@ function create_customer_repricing_config_sample( $cloudChannelServiceClient = new CloudChannelServiceClient(); // Prepare the request message. + $customerRepricingConfigRepricingConfigEntitlementGranularity = new EntitlementGranularity(); $customerRepricingConfigRepricingConfigEffectiveInvoiceMonth = new Date(); $customerRepricingConfigRepricingConfigAdjustment = new RepricingAdjustment(); $customerRepricingConfigRepricingConfig = (new RepricingConfig()) + ->setEntitlementGranularity($customerRepricingConfigRepricingConfigEntitlementGranularity) ->setEffectiveInvoiceMonth($customerRepricingConfigRepricingConfigEffectiveInvoiceMonth) ->setAdjustment($customerRepricingConfigRepricingConfigAdjustment) ->setRebillingBasis($customerRepricingConfigRepricingConfigRebillingBasis); diff --git a/Channel/samples/V1/CloudChannelServiceClient/list_subscribers.php b/Channel/samples/V1/CloudChannelServiceClient/list_subscribers.php index bc1928cd6c6f..2268fc5857f5 100644 --- a/Channel/samples/V1/CloudChannelServiceClient/list_subscribers.php +++ b/Channel/samples/V1/CloudChannelServiceClient/list_subscribers.php @@ -29,8 +29,8 @@ use Google\Cloud\Channel\V1\ListSubscribersRequest; /** - * Lists service accounts with subscriber privileges on the Cloud Pub/Sub - * topic created for this Channel Services account. + * Lists service accounts with subscriber privileges on the Pub/Sub topic + * created for this Channel Services account or integrator. * * Possible error codes: * @@ -47,16 +47,19 @@ * Return value: * A list of service email addresses. * - * @param string $account Resource name of the account. + * This sample has been automatically generated and should be regarded as a code + * template only. It will require modifications to work: + * - It may require correct/in-range values for request initialization. + * - It may require specifying regional endpoints when creating the service client, + * please see the apiEndpoint client configuration option for more details. */ -function list_subscribers_sample(string $account): void +function list_subscribers_sample(): void { // Create a client. $cloudChannelServiceClient = new CloudChannelServiceClient(); // Prepare the request message. - $request = (new ListSubscribersRequest()) - ->setAccount($account); + $request = new ListSubscribersRequest(); // Call the API and handle any network failures. try { @@ -71,20 +74,4 @@ function list_subscribers_sample(string $account): void printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage()); } } - -/** - * Helper to execute the sample. - * - * This sample has been automatically generated and should be regarded as a code - * template only. It will require modifications to work: - * - It may require correct/in-range values for request initialization. - * - It may require specifying regional endpoints when creating the service client, - * please see the apiEndpoint client configuration option for more details. - */ -function callSample(): void -{ - $account = '[ACCOUNT]'; - - list_subscribers_sample($account); -} // [END cloudchannel_v1_generated_CloudChannelService_ListSubscribers_sync] diff --git a/Channel/samples/V1/CloudChannelServiceClient/register_subscriber.php b/Channel/samples/V1/CloudChannelServiceClient/register_subscriber.php index 1246dcbfd38f..d55560aae528 100644 --- a/Channel/samples/V1/CloudChannelServiceClient/register_subscriber.php +++ b/Channel/samples/V1/CloudChannelServiceClient/register_subscriber.php @@ -29,8 +29,8 @@ use Google\Cloud\Channel\V1\RegisterSubscriberResponse; /** - * Registers a service account with subscriber privileges on the Cloud Pub/Sub - * topic for this Channel Services account. After you create a + * Registers a service account with subscriber privileges on the Pub/Sub + * topic for this Channel Services account or integrator. After you create a * subscriber, you get the events through * [SubscriberEvent][google.cloud.channel.v1.SubscriberEvent] * @@ -48,18 +48,16 @@ * Return value: * The topic name with the registered service email address. * - * @param string $account Resource name of the account. * @param string $serviceAccount Service account that provides subscriber access to the registered * topic. */ -function register_subscriber_sample(string $account, string $serviceAccount): void +function register_subscriber_sample(string $serviceAccount): void { // Create a client. $cloudChannelServiceClient = new CloudChannelServiceClient(); // Prepare the request message. $request = (new RegisterSubscriberRequest()) - ->setAccount($account) ->setServiceAccount($serviceAccount); // Call the API and handle any network failures. @@ -83,9 +81,8 @@ function register_subscriber_sample(string $account, string $serviceAccount): vo */ function callSample(): void { - $account = '[ACCOUNT]'; $serviceAccount = '[SERVICE_ACCOUNT]'; - register_subscriber_sample($account, $serviceAccount); + register_subscriber_sample($serviceAccount); } // [END cloudchannel_v1_generated_CloudChannelService_RegisterSubscriber_sync] diff --git a/Channel/samples/V1/CloudChannelServiceClient/unregister_subscriber.php b/Channel/samples/V1/CloudChannelServiceClient/unregister_subscriber.php index 5ff96c84bf48..354f95f6c3b1 100644 --- a/Channel/samples/V1/CloudChannelServiceClient/unregister_subscriber.php +++ b/Channel/samples/V1/CloudChannelServiceClient/unregister_subscriber.php @@ -29,10 +29,10 @@ use Google\Cloud\Channel\V1\UnregisterSubscriberResponse; /** - * Unregisters a service account with subscriber privileges on the Cloud - * Pub/Sub topic created for this Channel Services account. If there are no - * service accounts left with subscriber privileges, this deletes the topic. - * You can call ListSubscribers to check for these accounts. + * Unregisters a service account with subscriber privileges on the Pub/Sub + * topic created for this Channel Services account or integrator. If there are + * no service accounts left with subscriber privileges, this deletes the + * topic. You can call ListSubscribers to check for these accounts. * * Possible error codes: * @@ -51,18 +51,16 @@ * Returns a success response if the service email address wasn't registered * with the topic. * - * @param string $account Resource name of the account. * @param string $serviceAccount Service account to unregister from subscriber access to the * topic. */ -function unregister_subscriber_sample(string $account, string $serviceAccount): void +function unregister_subscriber_sample(string $serviceAccount): void { // Create a client. $cloudChannelServiceClient = new CloudChannelServiceClient(); // Prepare the request message. $request = (new UnregisterSubscriberRequest()) - ->setAccount($account) ->setServiceAccount($serviceAccount); // Call the API and handle any network failures. @@ -86,9 +84,8 @@ function unregister_subscriber_sample(string $account, string $serviceAccount): */ function callSample(): void { - $account = '[ACCOUNT]'; $serviceAccount = '[SERVICE_ACCOUNT]'; - unregister_subscriber_sample($account, $serviceAccount); + unregister_subscriber_sample($serviceAccount); } // [END cloudchannel_v1_generated_CloudChannelService_UnregisterSubscriber_sync] diff --git a/Channel/samples/V1/CloudChannelServiceClient/update_channel_partner_repricing_config.php b/Channel/samples/V1/CloudChannelServiceClient/update_channel_partner_repricing_config.php index f1d2984742f2..23488f0ae895 100644 --- a/Channel/samples/V1/CloudChannelServiceClient/update_channel_partner_repricing_config.php +++ b/Channel/samples/V1/CloudChannelServiceClient/update_channel_partner_repricing_config.php @@ -29,6 +29,7 @@ use Google\Cloud\Channel\V1\RebillingBasis; use Google\Cloud\Channel\V1\RepricingAdjustment; use Google\Cloud\Channel\V1\RepricingConfig; +use Google\Cloud\Channel\V1\RepricingConfig\EntitlementGranularity; use Google\Cloud\Channel\V1\UpdateChannelPartnerRepricingConfigRequest; use Google\Type\Date; @@ -77,9 +78,11 @@ function update_channel_partner_repricing_config_sample( $cloudChannelServiceClient = new CloudChannelServiceClient(); // Prepare the request message. + $channelPartnerRepricingConfigRepricingConfigEntitlementGranularity = new EntitlementGranularity(); $channelPartnerRepricingConfigRepricingConfigEffectiveInvoiceMonth = new Date(); $channelPartnerRepricingConfigRepricingConfigAdjustment = new RepricingAdjustment(); $channelPartnerRepricingConfigRepricingConfig = (new RepricingConfig()) + ->setEntitlementGranularity($channelPartnerRepricingConfigRepricingConfigEntitlementGranularity) ->setEffectiveInvoiceMonth($channelPartnerRepricingConfigRepricingConfigEffectiveInvoiceMonth) ->setAdjustment($channelPartnerRepricingConfigRepricingConfigAdjustment) ->setRebillingBasis($channelPartnerRepricingConfigRepricingConfigRebillingBasis); diff --git a/Channel/samples/V1/CloudChannelServiceClient/update_customer_repricing_config.php b/Channel/samples/V1/CloudChannelServiceClient/update_customer_repricing_config.php index 092727b1af7b..b05e7d8b4e4b 100644 --- a/Channel/samples/V1/CloudChannelServiceClient/update_customer_repricing_config.php +++ b/Channel/samples/V1/CloudChannelServiceClient/update_customer_repricing_config.php @@ -29,6 +29,7 @@ use Google\Cloud\Channel\V1\RebillingBasis; use Google\Cloud\Channel\V1\RepricingAdjustment; use Google\Cloud\Channel\V1\RepricingConfig; +use Google\Cloud\Channel\V1\RepricingConfig\EntitlementGranularity; use Google\Cloud\Channel\V1\UpdateCustomerRepricingConfigRequest; use Google\Type\Date; @@ -77,9 +78,11 @@ function update_customer_repricing_config_sample( $cloudChannelServiceClient = new CloudChannelServiceClient(); // Prepare the request message. + $customerRepricingConfigRepricingConfigEntitlementGranularity = new EntitlementGranularity(); $customerRepricingConfigRepricingConfigEffectiveInvoiceMonth = new Date(); $customerRepricingConfigRepricingConfigAdjustment = new RepricingAdjustment(); $customerRepricingConfigRepricingConfig = (new RepricingConfig()) + ->setEntitlementGranularity($customerRepricingConfigRepricingConfigEntitlementGranularity) ->setEffectiveInvoiceMonth($customerRepricingConfigRepricingConfigEffectiveInvoiceMonth) ->setAdjustment($customerRepricingConfigRepricingConfigAdjustment) ->setRebillingBasis($customerRepricingConfigRepricingConfigRebillingBasis); diff --git a/Channel/src/V1/ChangeOfferRequest.php b/Channel/src/V1/ChangeOfferRequest.php index 84766268efc5..461d2e6d5f7d 100644 --- a/Channel/src/V1/ChangeOfferRequest.php +++ b/Channel/src/V1/ChangeOfferRequest.php @@ -70,6 +70,14 @@ class ChangeOfferRequest extends \Google\Protobuf\Internal\Message * Generated from protobuf field string billing_account = 7 [(.google.api.field_behavior) = OPTIONAL]; */ protected $billing_account = ''; + /** + * Optional. Price reference ID for the offer. Only for offers that require + * additional price information. Used to guarantee that the pricing is + * consistent between quoting the offer and placing the order. + * + * Generated from protobuf field string price_reference_id = 8 [(.google.api.field_behavior) = OPTIONAL]; + */ + protected $price_reference_id = ''; /** * Constructor. @@ -107,6 +115,10 @@ class ChangeOfferRequest extends \Google\Protobuf\Internal\Message * entitlement when setting up billing on a trial subscription. * This field is only relevant for multi-currency accounts. It should be * left empty for single currency accounts. + * @type string $price_reference_id + * Optional. Price reference ID for the offer. Only for offers that require + * additional price information. Used to guarantee that the pricing is + * consistent between quoting the offer and placing the order. * } */ public function __construct($data = NULL) { @@ -306,5 +318,35 @@ public function setBillingAccount($var) return $this; } + /** + * Optional. Price reference ID for the offer. Only for offers that require + * additional price information. Used to guarantee that the pricing is + * consistent between quoting the offer and placing the order. + * + * Generated from protobuf field string price_reference_id = 8 [(.google.api.field_behavior) = OPTIONAL]; + * @return string + */ + public function getPriceReferenceId() + { + return $this->price_reference_id; + } + + /** + * Optional. Price reference ID for the offer. Only for offers that require + * additional price information. Used to guarantee that the pricing is + * consistent between quoting the offer and placing the order. + * + * Generated from protobuf field string price_reference_id = 8 [(.google.api.field_behavior) = OPTIONAL]; + * @param string $var + * @return $this + */ + public function setPriceReferenceId($var) + { + GPBUtil::checkString($var, True); + $this->price_reference_id = $var; + + return $this; + } + } diff --git a/Channel/src/V1/ChangeParametersRequest.php b/Channel/src/V1/ChangeParametersRequest.php index e513cf5986c1..b84790f9599e 100644 --- a/Channel/src/V1/ChangeParametersRequest.php +++ b/Channel/src/V1/ChangeParametersRequest.php @@ -9,7 +9,8 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Request message for [CloudChannelService.ChangeParametersRequest][]. + * Request message for + * [CloudChannelService.ChangeParameters][google.cloud.channel.v1.CloudChannelService.ChangeParameters]. * * Generated from protobuf message google.cloud.channel.v1.ChangeParametersRequest */ diff --git a/Channel/src/V1/Client/CloudChannelServiceClient.php b/Channel/src/V1/Client/CloudChannelServiceClient.php index 61a05da0b118..143e221077cb 100644 --- a/Channel/src/V1/Client/CloudChannelServiceClient.php +++ b/Channel/src/V1/Client/CloudChannelServiceClient.php @@ -278,6 +278,21 @@ private function createOperationsClient(array $options) return new OperationsClient($options); } + /** + * Formats a string containing the fully-qualified path to represent a account + * resource. + * + * @param string $account + * + * @return string The formatted account resource. + */ + public static function accountName(string $account): string + { + return self::getPathTemplate('account')->render([ + 'account' => $account, + ]); + } + /** * Formats a string containing the fully-qualified path to represent a * channel_partner_link resource. @@ -428,6 +443,7 @@ public static function skuGroupName(string $account, string $skuGroup): string * Parses a formatted name string and returns an associative array of the components in the name. * The following name formats are supported: * Template: Pattern + * - account: accounts/{account} * - channelPartnerLink: accounts/{account}/channelPartnerLinks/{channel_partner_link} * - channelPartnerRepricingConfig: accounts/{account}/channelPartnerLinks/{channel_partner}/channelPartnerRepricingConfigs/{channel_partner_repricing_config} * - customer: accounts/{account}/customers/{customer} @@ -2025,8 +2041,8 @@ public function listSkus(ListSkusRequest $request, array $callOptions = []): Pag } /** - * Lists service accounts with subscriber privileges on the Cloud Pub/Sub - * topic created for this Channel Services account. + * Lists service accounts with subscriber privileges on the Pub/Sub topic + * created for this Channel Services account or integrator. * * Possible error codes: * @@ -2291,8 +2307,8 @@ public function queryEligibleBillingAccounts( } /** - * Registers a service account with subscriber privileges on the Cloud Pub/Sub - * topic for this Channel Services account. After you create a + * Registers a service account with subscriber privileges on the Pub/Sub + * topic for this Channel Services account or integrator. After you create a * subscriber, you get the events through * [SubscriberEvent][google.cloud.channel.v1.SubscriberEvent] * @@ -2550,10 +2566,10 @@ public function transferEntitlementsToGoogle( } /** - * Unregisters a service account with subscriber privileges on the Cloud - * Pub/Sub topic created for this Channel Services account. If there are no - * service accounts left with subscriber privileges, this deletes the topic. - * You can call ListSubscribers to check for these accounts. + * Unregisters a service account with subscriber privileges on the Pub/Sub + * topic created for this Channel Services account or integrator. If there are + * no service accounts left with subscriber privileges, this deletes the + * topic. You can call ListSubscribers to check for these accounts. * * Possible error codes: * diff --git a/Channel/src/V1/CloudIdentityCustomerAccount.php b/Channel/src/V1/CloudIdentityCustomerAccount.php index d0826c87fe24..9053b70718f1 100644 --- a/Channel/src/V1/CloudIdentityCustomerAccount.php +++ b/Channel/src/V1/CloudIdentityCustomerAccount.php @@ -24,7 +24,8 @@ class CloudIdentityCustomerAccount extends \Google\Protobuf\Internal\Message protected $existing = false; /** * Returns true if the Cloud Identity account is associated with a customer - * of the Channel Services partner. + * of the Channel Services partner (with active subscriptions or purchase + * consents). * * Generated from protobuf field bool owned = 2; */ @@ -68,7 +69,8 @@ class CloudIdentityCustomerAccount extends \Google\Protobuf\Internal\Message * Returns true if a Cloud Identity account exists for a specific domain. * @type bool $owned * Returns true if the Cloud Identity account is associated with a customer - * of the Channel Services partner. + * of the Channel Services partner (with active subscriptions or purchase + * consents). * @type string $customer_name * If owned = true, the name of the customer that owns the Cloud Identity * account. @@ -116,7 +118,8 @@ public function setExisting($var) /** * Returns true if the Cloud Identity account is associated with a customer - * of the Channel Services partner. + * of the Channel Services partner (with active subscriptions or purchase + * consents). * * Generated from protobuf field bool owned = 2; * @return bool @@ -128,7 +131,8 @@ public function getOwned() /** * Returns true if the Cloud Identity account is associated with a customer - * of the Channel Services partner. + * of the Channel Services partner (with active subscriptions or purchase + * consents). * * Generated from protobuf field bool owned = 2; * @param bool $var diff --git a/Channel/src/V1/Customer.php b/Channel/src/V1/Customer.php index b92ab12eb1d5..9315f9e37588 100644 --- a/Channel/src/V1/Customer.php +++ b/Channel/src/V1/Customer.php @@ -109,7 +109,7 @@ class Customer extends \Google\Protobuf\Internal\Message */ protected $correlation_id = ''; /** - * Optional. Indicate whether a customer is attesting about the correctness of + * Optional. Indicate if a customer is attesting about the correctness of * provided information. Only required if creating a GCP Entitlement. * * Generated from protobuf field .google.cloud.channel.v1.Customer.CustomerAttestationState customer_attestation_state = 16 [(.google.api.field_behavior) = OPTIONAL]; @@ -164,7 +164,7 @@ class Customer extends \Google\Protobuf\Internal\Message * Optional. External CRM ID for the customer. * Populated only if a CRM ID exists for this customer. * @type int $customer_attestation_state - * Optional. Indicate whether a customer is attesting about the correctness of + * Optional. Indicate if a customer is attesting about the correctness of * provided information. Only required if creating a GCP Entitlement. * } */ @@ -592,7 +592,7 @@ public function setCorrelationId($var) } /** - * Optional. Indicate whether a customer is attesting about the correctness of + * Optional. Indicate if a customer is attesting about the correctness of * provided information. Only required if creating a GCP Entitlement. * * Generated from protobuf field .google.cloud.channel.v1.Customer.CustomerAttestationState customer_attestation_state = 16 [(.google.api.field_behavior) = OPTIONAL]; @@ -604,7 +604,7 @@ public function getCustomerAttestationState() } /** - * Optional. Indicate whether a customer is attesting about the correctness of + * Optional. Indicate if a customer is attesting about the correctness of * provided information. Only required if creating a GCP Entitlement. * * Generated from protobuf field .google.cloud.channel.v1.Customer.CustomerAttestationState customer_attestation_state = 16 [(.google.api.field_behavior) = OPTIONAL]; diff --git a/Channel/src/V1/Customer/CustomerAttestationState.php b/Channel/src/V1/Customer/CustomerAttestationState.php index e73cfbb16f0d..55422a07564f 100644 --- a/Channel/src/V1/Customer/CustomerAttestationState.php +++ b/Channel/src/V1/Customer/CustomerAttestationState.php @@ -7,7 +7,7 @@ use UnexpectedValueException; /** - * The enum represents whether a customer belongs to public sector + * The enum represents if a customer belongs to public sector * * Protobuf type google.cloud.channel.v1.Customer.CustomerAttestationState */ diff --git a/Channel/src/V1/CustomerEvent.php b/Channel/src/V1/CustomerEvent.php index 1b50fe2c3685..028ba5e70d36 100644 --- a/Channel/src/V1/CustomerEvent.php +++ b/Channel/src/V1/CustomerEvent.php @@ -23,7 +23,7 @@ class CustomerEvent extends \Google\Protobuf\Internal\Message */ protected $customer = ''; /** - * Type of event which happened on the customer. + * Type of event which happened for the customer. * * Generated from protobuf field .google.cloud.channel.v1.CustomerEvent.Type event_type = 2; */ @@ -39,7 +39,7 @@ class CustomerEvent extends \Google\Protobuf\Internal\Message * Resource name of the customer. * Format: accounts/{account_id}/customers/{customer_id} * @type int $event_type - * Type of event which happened on the customer. + * Type of event which happened for the customer. * } */ public function __construct($data = NULL) { @@ -76,7 +76,7 @@ public function setCustomer($var) } /** - * Type of event which happened on the customer. + * Type of event which happened for the customer. * * Generated from protobuf field .google.cloud.channel.v1.CustomerEvent.Type event_type = 2; * @return int @@ -87,7 +87,7 @@ public function getEventType() } /** - * Type of event which happened on the customer. + * Type of event which happened for the customer. * * Generated from protobuf field .google.cloud.channel.v1.CustomerEvent.Type event_type = 2; * @param int $var diff --git a/Channel/src/V1/DiscountComponent.php b/Channel/src/V1/DiscountComponent.php new file mode 100644 index 000000000000..90ed4a8eedae --- /dev/null +++ b/Channel/src/V1/DiscountComponent.php @@ -0,0 +1,145 @@ +google.cloud.channel.v1.DiscountComponent + */ +class DiscountComponent extends \Google\Protobuf\Internal\Message +{ + /** + * Type of the discount. + * + * Generated from protobuf field .google.cloud.channel.v1.DiscountType discount_type = 2; + */ + protected $discount_type = 0; + protected $discount_value; + + /** + * Constructor. + * + * @param array $data { + * Optional. Data for populating the Message object. + * + * @type float $discount_percentage + * Discount percentage, represented as decimal. + * For example, a 20% discount will be represented as 0.2. + * @type \Google\Type\Money $discount_absolute + * Fixed value discount. + * @type int $discount_type + * Type of the discount. + * } + */ + public function __construct($data = NULL) { + \GPBMetadata\Google\Cloud\Channel\V1\Offers::initOnce(); + parent::__construct($data); + } + + /** + * Discount percentage, represented as decimal. + * For example, a 20% discount will be represented as 0.2. + * + * Generated from protobuf field double discount_percentage = 3; + * @return float + */ + public function getDiscountPercentage() + { + return $this->readOneof(3); + } + + public function hasDiscountPercentage() + { + return $this->hasOneof(3); + } + + /** + * Discount percentage, represented as decimal. + * For example, a 20% discount will be represented as 0.2. + * + * Generated from protobuf field double discount_percentage = 3; + * @param float $var + * @return $this + */ + public function setDiscountPercentage($var) + { + GPBUtil::checkDouble($var); + $this->writeOneof(3, $var); + + return $this; + } + + /** + * Fixed value discount. + * + * Generated from protobuf field .google.type.Money discount_absolute = 4; + * @return \Google\Type\Money|null + */ + public function getDiscountAbsolute() + { + return $this->readOneof(4); + } + + public function hasDiscountAbsolute() + { + return $this->hasOneof(4); + } + + /** + * Fixed value discount. + * + * Generated from protobuf field .google.type.Money discount_absolute = 4; + * @param \Google\Type\Money $var + * @return $this + */ + public function setDiscountAbsolute($var) + { + GPBUtil::checkMessage($var, \Google\Type\Money::class); + $this->writeOneof(4, $var); + + return $this; + } + + /** + * Type of the discount. + * + * Generated from protobuf field .google.cloud.channel.v1.DiscountType discount_type = 2; + * @return int + */ + public function getDiscountType() + { + return $this->discount_type; + } + + /** + * Type of the discount. + * + * Generated from protobuf field .google.cloud.channel.v1.DiscountType discount_type = 2; + * @param int $var + * @return $this + */ + public function setDiscountType($var) + { + GPBUtil::checkEnum($var, \Google\Cloud\Channel\V1\DiscountType::class); + $this->discount_type = $var; + + return $this; + } + + /** + * @return string + */ + public function getDiscountValue() + { + return $this->whichOneof("discount_value"); + } + +} + diff --git a/Channel/src/V1/DiscountType.php b/Channel/src/V1/DiscountType.php new file mode 100644 index 000000000000..8cc2f0fabac0 --- /dev/null +++ b/Channel/src/V1/DiscountType.php @@ -0,0 +1,82 @@ +google.cloud.channel.v1.DiscountType + */ +class DiscountType +{ + /** + * Not used. + * + * Generated from protobuf enum DISCOUNT_TYPE_UNSPECIFIED = 0; + */ + const DISCOUNT_TYPE_UNSPECIFIED = 0; + /** + * Regional discount. + * + * Generated from protobuf enum REGIONAL_DISCOUNT = 1; + */ + const REGIONAL_DISCOUNT = 1; + /** + * Promotional discount. + * + * Generated from protobuf enum PROMOTIONAL_DISCOUNT = 2; + */ + const PROMOTIONAL_DISCOUNT = 2; + /** + * Sales-provided discount. + * + * Generated from protobuf enum SALES_DISCOUNT = 3; + */ + const SALES_DISCOUNT = 3; + /** + * Reseller margin. + * + * Generated from protobuf enum RESELLER_MARGIN = 4; + */ + const RESELLER_MARGIN = 4; + /** + * Deal code discount. + * + * Generated from protobuf enum DEAL_CODE = 5; + */ + const DEAL_CODE = 5; + + private static $valueToName = [ + self::DISCOUNT_TYPE_UNSPECIFIED => 'DISCOUNT_TYPE_UNSPECIFIED', + self::REGIONAL_DISCOUNT => 'REGIONAL_DISCOUNT', + self::PROMOTIONAL_DISCOUNT => 'PROMOTIONAL_DISCOUNT', + self::SALES_DISCOUNT => 'SALES_DISCOUNT', + self::RESELLER_MARGIN => 'RESELLER_MARGIN', + self::DEAL_CODE => 'DEAL_CODE', + ]; + + public static function name($value) + { + if (!isset(self::$valueToName[$value])) { + throw new UnexpectedValueException(sprintf( + 'Enum %s has no name defined for value %s', __CLASS__, $value)); + } + return self::$valueToName[$value]; + } + + + public static function value($name) + { + $const = __CLASS__ . '::' . strtoupper($name); + if (!defined($const)) { + throw new UnexpectedValueException(sprintf( + 'Enum %s has no value defined for name %s', __CLASS__, $name)); + } + return constant($const); + } +} + diff --git a/Channel/src/V1/Entitlement.php b/Channel/src/V1/Entitlement.php index 355296213ccc..f34fc7294ebd 100644 --- a/Channel/src/V1/Entitlement.php +++ b/Channel/src/V1/Entitlement.php @@ -113,6 +113,14 @@ class Entitlement extends \Google\Protobuf\Internal\Message * Generated from protobuf field string billing_account = 28 [(.google.api.field_behavior) = OPTIONAL]; */ protected $billing_account = ''; + /** + * Optional. Price reference ID for the offer. Only for offers that require + * additional price information. Used to guarantee that the pricing is + * consistent between quoting the offer and placing the order. + * + * Generated from protobuf field string price_reference_id = 29 [(.google.api.field_behavior) = OPTIONAL]; + */ + protected $price_reference_id = ''; /** * Constructor. @@ -166,6 +174,10 @@ class Entitlement extends \Google\Protobuf\Internal\Message * @type string $billing_account * Optional. The billing account resource name that is used to pay for this * entitlement. + * @type string $price_reference_id + * Optional. Price reference ID for the offer. Only for offers that require + * additional price information. Used to guarantee that the pricing is + * consistent between quoting the offer and placing the order. * } */ public function __construct($data = NULL) { @@ -611,5 +623,35 @@ public function setBillingAccount($var) return $this; } + /** + * Optional. Price reference ID for the offer. Only for offers that require + * additional price information. Used to guarantee that the pricing is + * consistent between quoting the offer and placing the order. + * + * Generated from protobuf field string price_reference_id = 29 [(.google.api.field_behavior) = OPTIONAL]; + * @return string + */ + public function getPriceReferenceId() + { + return $this->price_reference_id; + } + + /** + * Optional. Price reference ID for the offer. Only for offers that require + * additional price information. Used to guarantee that the pricing is + * consistent between quoting the offer and placing the order. + * + * Generated from protobuf field string price_reference_id = 29 [(.google.api.field_behavior) = OPTIONAL]; + * @param string $var + * @return $this + */ + public function setPriceReferenceId($var) + { + GPBUtil::checkString($var, True); + $this->price_reference_id = $var; + + return $this; + } + } diff --git a/Channel/src/V1/EntitlementEvent.php b/Channel/src/V1/EntitlementEvent.php index a6cf1b568f90..99cc65175f21 100644 --- a/Channel/src/V1/EntitlementEvent.php +++ b/Channel/src/V1/EntitlementEvent.php @@ -23,7 +23,7 @@ class EntitlementEvent extends \Google\Protobuf\Internal\Message */ protected $entitlement = ''; /** - * Type of event which happened on the entitlement. + * Type of event which happened for the entitlement. * * Generated from protobuf field .google.cloud.channel.v1.EntitlementEvent.Type event_type = 2; */ @@ -39,7 +39,7 @@ class EntitlementEvent extends \Google\Protobuf\Internal\Message * Resource name of an entitlement of the form: * accounts/{account_id}/customers/{customer_id}/entitlements/{entitlement_id} * @type int $event_type - * Type of event which happened on the entitlement. + * Type of event which happened for the entitlement. * } */ public function __construct($data = NULL) { @@ -76,7 +76,7 @@ public function setEntitlement($var) } /** - * Type of event which happened on the entitlement. + * Type of event which happened for the entitlement. * * Generated from protobuf field .google.cloud.channel.v1.EntitlementEvent.Type event_type = 2; * @return int @@ -87,7 +87,7 @@ public function getEventType() } /** - * Type of event which happened on the entitlement. + * Type of event which happened for the entitlement. * * Generated from protobuf field .google.cloud.channel.v1.EntitlementEvent.Type event_type = 2; * @param int $var diff --git a/Channel/src/V1/ListOffersResponse.php b/Channel/src/V1/ListOffersResponse.php index 12c5a616197c..fff6c1532fe8 100644 --- a/Channel/src/V1/ListOffersResponse.php +++ b/Channel/src/V1/ListOffersResponse.php @@ -17,6 +17,8 @@ class ListOffersResponse extends \Google\Protobuf\Internal\Message { /** * The list of Offers requested. + * The pricing information for each Offer only includes the base price. + * Effective prices and discounts aren't populated. * * Generated from protobuf field repeated .google.cloud.channel.v1.Offer offers = 1; */ @@ -36,6 +38,8 @@ class ListOffersResponse extends \Google\Protobuf\Internal\Message * * @type array<\Google\Cloud\Channel\V1\Offer>|\Google\Protobuf\Internal\RepeatedField $offers * The list of Offers requested. + * The pricing information for each Offer only includes the base price. + * Effective prices and discounts aren't populated. * @type string $next_page_token * A token to retrieve the next page of results. * } @@ -47,6 +51,8 @@ public function __construct($data = NULL) { /** * The list of Offers requested. + * The pricing information for each Offer only includes the base price. + * Effective prices and discounts aren't populated. * * Generated from protobuf field repeated .google.cloud.channel.v1.Offer offers = 1; * @return \Google\Protobuf\Internal\RepeatedField @@ -58,6 +64,8 @@ public function getOffers() /** * The list of Offers requested. + * The pricing information for each Offer only includes the base price. + * Effective prices and discounts aren't populated. * * Generated from protobuf field repeated .google.cloud.channel.v1.Offer offers = 1; * @param array<\Google\Cloud\Channel\V1\Offer>|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Channel/src/V1/ListSkuGroupBillableSkusRequest.php b/Channel/src/V1/ListSkuGroupBillableSkusRequest.php index 9c824a3ea220..f1c9f7e9e817 100644 --- a/Channel/src/V1/ListSkuGroupBillableSkusRequest.php +++ b/Channel/src/V1/ListSkuGroupBillableSkusRequest.php @@ -33,7 +33,8 @@ class ListSkuGroupBillableSkusRequest extends \Google\Protobuf\Internal\Message /** * Optional. A token identifying a page of results beyond the first page. * Obtained through - * [ListSkuGroupBillableSkus.next_page_token][] of the previous + * [ListSkuGroupBillableSkusResponse.next_page_token][google.cloud.channel.v1.ListSkuGroupBillableSkusResponse.next_page_token] + * of the previous * [CloudChannelService.ListSkuGroupBillableSkus][google.cloud.channel.v1.CloudChannelService.ListSkuGroupBillableSkus] * call. * @@ -72,7 +73,8 @@ public static function build(string $parent): self * @type string $page_token * Optional. A token identifying a page of results beyond the first page. * Obtained through - * [ListSkuGroupBillableSkus.next_page_token][] of the previous + * [ListSkuGroupBillableSkusResponse.next_page_token][google.cloud.channel.v1.ListSkuGroupBillableSkusResponse.next_page_token] + * of the previous * [CloudChannelService.ListSkuGroupBillableSkus][google.cloud.channel.v1.CloudChannelService.ListSkuGroupBillableSkus] * call. * } @@ -143,7 +145,8 @@ public function setPageSize($var) /** * Optional. A token identifying a page of results beyond the first page. * Obtained through - * [ListSkuGroupBillableSkus.next_page_token][] of the previous + * [ListSkuGroupBillableSkusResponse.next_page_token][google.cloud.channel.v1.ListSkuGroupBillableSkusResponse.next_page_token] + * of the previous * [CloudChannelService.ListSkuGroupBillableSkus][google.cloud.channel.v1.CloudChannelService.ListSkuGroupBillableSkus] * call. * @@ -158,7 +161,8 @@ public function getPageToken() /** * Optional. A token identifying a page of results beyond the first page. * Obtained through - * [ListSkuGroupBillableSkus.next_page_token][] of the previous + * [ListSkuGroupBillableSkusResponse.next_page_token][google.cloud.channel.v1.ListSkuGroupBillableSkusResponse.next_page_token] + * of the previous * [CloudChannelService.ListSkuGroupBillableSkus][google.cloud.channel.v1.CloudChannelService.ListSkuGroupBillableSkus] * call. * diff --git a/Channel/src/V1/ListSkuGroupBillableSkusResponse.php b/Channel/src/V1/ListSkuGroupBillableSkusResponse.php index 245a4050adcd..f9b40ece803c 100644 --- a/Channel/src/V1/ListSkuGroupBillableSkusResponse.php +++ b/Channel/src/V1/ListSkuGroupBillableSkusResponse.php @@ -23,8 +23,9 @@ class ListSkuGroupBillableSkusResponse extends \Google\Protobuf\Internal\Message private $billable_skus; /** * A token to retrieve the next page of results. - * Pass to [ListSkuGroupBillableSkus.page_token][] to obtain that - * page. + * Pass to + * [ListSkuGroupBillableSkusRequest.page_token][google.cloud.channel.v1.ListSkuGroupBillableSkusRequest.page_token] + * to obtain that page. * * Generated from protobuf field string next_page_token = 2; */ @@ -40,8 +41,9 @@ class ListSkuGroupBillableSkusResponse extends \Google\Protobuf\Internal\Message * The list of billable SKUs in the requested SKU group. * @type string $next_page_token * A token to retrieve the next page of results. - * Pass to [ListSkuGroupBillableSkus.page_token][] to obtain that - * page. + * Pass to + * [ListSkuGroupBillableSkusRequest.page_token][google.cloud.channel.v1.ListSkuGroupBillableSkusRequest.page_token] + * to obtain that page. * } */ public function __construct($data = NULL) { @@ -77,8 +79,9 @@ public function setBillableSkus($var) /** * A token to retrieve the next page of results. - * Pass to [ListSkuGroupBillableSkus.page_token][] to obtain that - * page. + * Pass to + * [ListSkuGroupBillableSkusRequest.page_token][google.cloud.channel.v1.ListSkuGroupBillableSkusRequest.page_token] + * to obtain that page. * * Generated from protobuf field string next_page_token = 2; * @return string @@ -90,8 +93,9 @@ public function getNextPageToken() /** * A token to retrieve the next page of results. - * Pass to [ListSkuGroupBillableSkus.page_token][] to obtain that - * page. + * Pass to + * [ListSkuGroupBillableSkusRequest.page_token][google.cloud.channel.v1.ListSkuGroupBillableSkusRequest.page_token] + * to obtain that page. * * Generated from protobuf field string next_page_token = 2; * @param string $var diff --git a/Channel/src/V1/ListSkuGroupsRequest.php b/Channel/src/V1/ListSkuGroupsRequest.php index 65e3e7dc0499..4383ed56e6fc 100644 --- a/Channel/src/V1/ListSkuGroupsRequest.php +++ b/Channel/src/V1/ListSkuGroupsRequest.php @@ -34,7 +34,8 @@ class ListSkuGroupsRequest extends \Google\Protobuf\Internal\Message /** * Optional. A token identifying a page of results beyond the first page. * Obtained through - * [ListSkuGroups.next_page_token][] of the previous + * [ListSkuGroupsResponse.next_page_token][google.cloud.channel.v1.ListSkuGroupsResponse.next_page_token] + * of the previous * [CloudChannelService.ListSkuGroups][google.cloud.channel.v1.CloudChannelService.ListSkuGroups] * call. * @@ -73,7 +74,8 @@ public static function build(string $parent): self * @type string $page_token * Optional. A token identifying a page of results beyond the first page. * Obtained through - * [ListSkuGroups.next_page_token][] of the previous + * [ListSkuGroupsResponse.next_page_token][google.cloud.channel.v1.ListSkuGroupsResponse.next_page_token] + * of the previous * [CloudChannelService.ListSkuGroups][google.cloud.channel.v1.CloudChannelService.ListSkuGroups] * call. * } @@ -146,7 +148,8 @@ public function setPageSize($var) /** * Optional. A token identifying a page of results beyond the first page. * Obtained through - * [ListSkuGroups.next_page_token][] of the previous + * [ListSkuGroupsResponse.next_page_token][google.cloud.channel.v1.ListSkuGroupsResponse.next_page_token] + * of the previous * [CloudChannelService.ListSkuGroups][google.cloud.channel.v1.CloudChannelService.ListSkuGroups] * call. * @@ -161,7 +164,8 @@ public function getPageToken() /** * Optional. A token identifying a page of results beyond the first page. * Obtained through - * [ListSkuGroups.next_page_token][] of the previous + * [ListSkuGroupsResponse.next_page_token][google.cloud.channel.v1.ListSkuGroupsResponse.next_page_token] + * of the previous * [CloudChannelService.ListSkuGroups][google.cloud.channel.v1.CloudChannelService.ListSkuGroups] * call. * diff --git a/Channel/src/V1/ListSkuGroupsResponse.php b/Channel/src/V1/ListSkuGroupsResponse.php index 87b8f7893987..b8c476f2a3c7 100644 --- a/Channel/src/V1/ListSkuGroupsResponse.php +++ b/Channel/src/V1/ListSkuGroupsResponse.php @@ -23,8 +23,9 @@ class ListSkuGroupsResponse extends \Google\Protobuf\Internal\Message private $sku_groups; /** * A token to retrieve the next page of results. - * Pass to [ListSkuGroups.page_token][] to obtain that - * page. + * Pass to + * [ListSkuGroupsRequest.page_token][google.cloud.channel.v1.ListSkuGroupsRequest.page_token] + * to obtain that page. * * Generated from protobuf field string next_page_token = 2; */ @@ -40,8 +41,9 @@ class ListSkuGroupsResponse extends \Google\Protobuf\Internal\Message * The list of SKU groups requested. * @type string $next_page_token * A token to retrieve the next page of results. - * Pass to [ListSkuGroups.page_token][] to obtain that - * page. + * Pass to + * [ListSkuGroupsRequest.page_token][google.cloud.channel.v1.ListSkuGroupsRequest.page_token] + * to obtain that page. * } */ public function __construct($data = NULL) { @@ -77,8 +79,9 @@ public function setSkuGroups($var) /** * A token to retrieve the next page of results. - * Pass to [ListSkuGroups.page_token][] to obtain that - * page. + * Pass to + * [ListSkuGroupsRequest.page_token][google.cloud.channel.v1.ListSkuGroupsRequest.page_token] + * to obtain that page. * * Generated from protobuf field string next_page_token = 2; * @return string @@ -90,8 +93,9 @@ public function getNextPageToken() /** * A token to retrieve the next page of results. - * Pass to [ListSkuGroups.page_token][] to obtain that - * page. + * Pass to + * [ListSkuGroupsRequest.page_token][google.cloud.channel.v1.ListSkuGroupsRequest.page_token] + * to obtain that page. * * Generated from protobuf field string next_page_token = 2; * @param string $var diff --git a/Channel/src/V1/ListSubscribersRequest.php b/Channel/src/V1/ListSubscribersRequest.php index 916494ae8b29..e3ae70b7ec0d 100644 --- a/Channel/src/V1/ListSubscribersRequest.php +++ b/Channel/src/V1/ListSubscribersRequest.php @@ -16,9 +16,10 @@ class ListSubscribersRequest extends \Google\Protobuf\Internal\Message { /** - * Required. Resource name of the account. + * Optional. Resource name of the account. Required if integrator is not + * provided. Otherwise, leave this field empty/unset. * - * Generated from protobuf field string account = 1 [(.google.api.field_behavior) = REQUIRED]; + * Generated from protobuf field string account = 1 [(.google.api.field_behavior) = OPTIONAL, (.google.api.resource_reference) = { */ protected $account = ''; /** @@ -39,6 +40,13 @@ class ListSubscribersRequest extends \Google\Protobuf\Internal\Message * Generated from protobuf field string page_token = 3 [(.google.api.field_behavior) = OPTIONAL]; */ protected $page_token = ''; + /** + * Optional. Resource name of the integrator. Required if account is not + * provided. Otherwise, leave this field empty/unset. + * + * Generated from protobuf field optional string integrator = 4 [(.google.api.field_behavior) = OPTIONAL]; + */ + protected $integrator = null; /** * Constructor. @@ -47,7 +55,8 @@ class ListSubscribersRequest extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $account - * Required. Resource name of the account. + * Optional. Resource name of the account. Required if integrator is not + * provided. Otherwise, leave this field empty/unset. * @type int $page_size * Optional. The maximum number of service accounts to return. The service may * return fewer than this value. If unspecified, returns at most 100 service @@ -58,6 +67,9 @@ class ListSubscribersRequest extends \Google\Protobuf\Internal\Message * Provide this to retrieve the subsequent page. * When paginating, all other parameters provided to `ListSubscribers` must * match the call that provided the page token. + * @type string $integrator + * Optional. Resource name of the integrator. Required if account is not + * provided. Otherwise, leave this field empty/unset. * } */ public function __construct($data = NULL) { @@ -66,9 +78,10 @@ public function __construct($data = NULL) { } /** - * Required. Resource name of the account. + * Optional. Resource name of the account. Required if integrator is not + * provided. Otherwise, leave this field empty/unset. * - * Generated from protobuf field string account = 1 [(.google.api.field_behavior) = REQUIRED]; + * Generated from protobuf field string account = 1 [(.google.api.field_behavior) = OPTIONAL, (.google.api.resource_reference) = { * @return string */ public function getAccount() @@ -77,9 +90,10 @@ public function getAccount() } /** - * Required. Resource name of the account. + * Optional. Resource name of the account. Required if integrator is not + * provided. Otherwise, leave this field empty/unset. * - * Generated from protobuf field string account = 1 [(.google.api.field_behavior) = REQUIRED]; + * Generated from protobuf field string account = 1 [(.google.api.field_behavior) = OPTIONAL, (.google.api.resource_reference) = { * @param string $var * @return $this */ @@ -155,5 +169,43 @@ public function setPageToken($var) return $this; } + /** + * Optional. Resource name of the integrator. Required if account is not + * provided. Otherwise, leave this field empty/unset. + * + * Generated from protobuf field optional string integrator = 4 [(.google.api.field_behavior) = OPTIONAL]; + * @return string + */ + public function getIntegrator() + { + return isset($this->integrator) ? $this->integrator : ''; + } + + public function hasIntegrator() + { + return isset($this->integrator); + } + + public function clearIntegrator() + { + unset($this->integrator); + } + + /** + * Optional. Resource name of the integrator. Required if account is not + * provided. Otherwise, leave this field empty/unset. + * + * Generated from protobuf field optional string integrator = 4 [(.google.api.field_behavior) = OPTIONAL]; + * @param string $var + * @return $this + */ + public function setIntegrator($var) + { + GPBUtil::checkString($var, True); + $this->integrator = $var; + + return $this; + } + } diff --git a/Channel/src/V1/Price.php b/Channel/src/V1/Price.php index eca9e4739ee9..a3ae7fafae6a 100644 --- a/Channel/src/V1/Price.php +++ b/Channel/src/V1/Price.php @@ -34,12 +34,27 @@ class Price extends \Google\Protobuf\Internal\Message * Generated from protobuf field .google.type.Money effective_price = 3; */ protected $effective_price = null; + /** + * The time period with respect to which base and effective prices are + * defined. + * Example: 1 month, 6 months, 1 year, etc. + * + * Generated from protobuf field .google.cloud.channel.v1.Period price_period = 6; + */ + protected $price_period = null; /** * Link to external price list, such as link to Google Voice rate card. * * Generated from protobuf field string external_price_uri = 4; */ protected $external_price_uri = ''; + /** + * Breakdown of the discount into its components. + * This will be empty if there is no discount present. + * + * Generated from protobuf field repeated .google.cloud.channel.v1.DiscountComponent discount_components = 5; + */ + private $discount_components; /** * Constructor. @@ -54,8 +69,15 @@ class Price extends \Google\Protobuf\Internal\Message * For example, a 20% discount will be represent as 0.2. * @type \Google\Type\Money $effective_price * Effective Price after applying the discounts. + * @type \Google\Cloud\Channel\V1\Period $price_period + * The time period with respect to which base and effective prices are + * defined. + * Example: 1 month, 6 months, 1 year, etc. * @type string $external_price_uri * Link to external price list, such as link to Google Voice rate card. + * @type array<\Google\Cloud\Channel\V1\DiscountComponent>|\Google\Protobuf\Internal\RepeatedField $discount_components + * Breakdown of the discount into its components. + * This will be empty if there is no discount present. * } */ public function __construct($data = NULL) { @@ -163,6 +185,46 @@ public function setEffectivePrice($var) return $this; } + /** + * The time period with respect to which base and effective prices are + * defined. + * Example: 1 month, 6 months, 1 year, etc. + * + * Generated from protobuf field .google.cloud.channel.v1.Period price_period = 6; + * @return \Google\Cloud\Channel\V1\Period|null + */ + public function getPricePeriod() + { + return $this->price_period; + } + + public function hasPricePeriod() + { + return isset($this->price_period); + } + + public function clearPricePeriod() + { + unset($this->price_period); + } + + /** + * The time period with respect to which base and effective prices are + * defined. + * Example: 1 month, 6 months, 1 year, etc. + * + * Generated from protobuf field .google.cloud.channel.v1.Period price_period = 6; + * @param \Google\Cloud\Channel\V1\Period $var + * @return $this + */ + public function setPricePeriod($var) + { + GPBUtil::checkMessage($var, \Google\Cloud\Channel\V1\Period::class); + $this->price_period = $var; + + return $this; + } + /** * Link to external price list, such as link to Google Voice rate card. * @@ -189,5 +251,33 @@ public function setExternalPriceUri($var) return $this; } + /** + * Breakdown of the discount into its components. + * This will be empty if there is no discount present. + * + * Generated from protobuf field repeated .google.cloud.channel.v1.DiscountComponent discount_components = 5; + * @return \Google\Protobuf\Internal\RepeatedField + */ + public function getDiscountComponents() + { + return $this->discount_components; + } + + /** + * Breakdown of the discount into its components. + * This will be empty if there is no discount present. + * + * Generated from protobuf field repeated .google.cloud.channel.v1.DiscountComponent discount_components = 5; + * @param array<\Google\Cloud\Channel\V1\DiscountComponent>|\Google\Protobuf\Internal\RepeatedField $var + * @return $this + */ + public function setDiscountComponents($var) + { + $arr = GPBUtil::checkRepeatedField($var, \Google\Protobuf\Internal\GPBType::MESSAGE, \Google\Cloud\Channel\V1\DiscountComponent::class); + $this->discount_components = $arr; + + return $this; + } + } diff --git a/Channel/src/V1/PurchasableOffer.php b/Channel/src/V1/PurchasableOffer.php index 3a5e9a979bfd..79f4ce8d63bb 100644 --- a/Channel/src/V1/PurchasableOffer.php +++ b/Channel/src/V1/PurchasableOffer.php @@ -22,6 +22,14 @@ class PurchasableOffer extends \Google\Protobuf\Internal\Message * Generated from protobuf field .google.cloud.channel.v1.Offer offer = 1; */ protected $offer = null; + /** + * Optional. Price reference ID for the offer. Only for offers that require + * additional price information. Used to guarantee that the pricing is + * consistent between quoting the offer and placing the order. + * + * Generated from protobuf field string price_reference_id = 2 [(.google.api.field_behavior) = OPTIONAL]; + */ + protected $price_reference_id = ''; /** * Constructor. @@ -31,6 +39,10 @@ class PurchasableOffer extends \Google\Protobuf\Internal\Message * * @type \Google\Cloud\Channel\V1\Offer $offer * Offer. + * @type string $price_reference_id + * Optional. Price reference ID for the offer. Only for offers that require + * additional price information. Used to guarantee that the pricing is + * consistent between quoting the offer and placing the order. * } */ public function __construct($data = NULL) { @@ -74,5 +86,35 @@ public function setOffer($var) return $this; } + /** + * Optional. Price reference ID for the offer. Only for offers that require + * additional price information. Used to guarantee that the pricing is + * consistent between quoting the offer and placing the order. + * + * Generated from protobuf field string price_reference_id = 2 [(.google.api.field_behavior) = OPTIONAL]; + * @return string + */ + public function getPriceReferenceId() + { + return $this->price_reference_id; + } + + /** + * Optional. Price reference ID for the offer. Only for offers that require + * additional price information. Used to guarantee that the pricing is + * consistent between quoting the offer and placing the order. + * + * Generated from protobuf field string price_reference_id = 2 [(.google.api.field_behavior) = OPTIONAL]; + * @param string $var + * @return $this + */ + public function setPriceReferenceId($var) + { + GPBUtil::checkString($var, True); + $this->price_reference_id = $var; + + return $this; + } + } diff --git a/Channel/src/V1/RegisterSubscriberRequest.php b/Channel/src/V1/RegisterSubscriberRequest.php index ffcb4b546cdf..e459930458ef 100644 --- a/Channel/src/V1/RegisterSubscriberRequest.php +++ b/Channel/src/V1/RegisterSubscriberRequest.php @@ -16,9 +16,10 @@ class RegisterSubscriberRequest extends \Google\Protobuf\Internal\Message { /** - * Required. Resource name of the account. + * Optional. Resource name of the account. Required if integrator is not + * provided. Otherwise, leave this field empty/unset. * - * Generated from protobuf field string account = 1 [(.google.api.field_behavior) = REQUIRED]; + * Generated from protobuf field string account = 1 [(.google.api.field_behavior) = OPTIONAL, (.google.api.resource_reference) = { */ protected $account = ''; /** @@ -28,6 +29,13 @@ class RegisterSubscriberRequest extends \Google\Protobuf\Internal\Message * Generated from protobuf field string service_account = 2 [(.google.api.field_behavior) = REQUIRED]; */ protected $service_account = ''; + /** + * Optional. Resource name of the integrator. Required if account is not + * provided. Otherwise, leave this field empty/unset. + * + * Generated from protobuf field optional string integrator = 3 [(.google.api.field_behavior) = OPTIONAL]; + */ + protected $integrator = null; /** * Constructor. @@ -36,10 +44,14 @@ class RegisterSubscriberRequest extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $account - * Required. Resource name of the account. + * Optional. Resource name of the account. Required if integrator is not + * provided. Otherwise, leave this field empty/unset. * @type string $service_account * Required. Service account that provides subscriber access to the registered * topic. + * @type string $integrator + * Optional. Resource name of the integrator. Required if account is not + * provided. Otherwise, leave this field empty/unset. * } */ public function __construct($data = NULL) { @@ -48,9 +60,10 @@ public function __construct($data = NULL) { } /** - * Required. Resource name of the account. + * Optional. Resource name of the account. Required if integrator is not + * provided. Otherwise, leave this field empty/unset. * - * Generated from protobuf field string account = 1 [(.google.api.field_behavior) = REQUIRED]; + * Generated from protobuf field string account = 1 [(.google.api.field_behavior) = OPTIONAL, (.google.api.resource_reference) = { * @return string */ public function getAccount() @@ -59,9 +72,10 @@ public function getAccount() } /** - * Required. Resource name of the account. + * Optional. Resource name of the account. Required if integrator is not + * provided. Otherwise, leave this field empty/unset. * - * Generated from protobuf field string account = 1 [(.google.api.field_behavior) = REQUIRED]; + * Generated from protobuf field string account = 1 [(.google.api.field_behavior) = OPTIONAL, (.google.api.resource_reference) = { * @param string $var * @return $this */ @@ -101,5 +115,43 @@ public function setServiceAccount($var) return $this; } + /** + * Optional. Resource name of the integrator. Required if account is not + * provided. Otherwise, leave this field empty/unset. + * + * Generated from protobuf field optional string integrator = 3 [(.google.api.field_behavior) = OPTIONAL]; + * @return string + */ + public function getIntegrator() + { + return isset($this->integrator) ? $this->integrator : ''; + } + + public function hasIntegrator() + { + return isset($this->integrator); + } + + public function clearIntegrator() + { + unset($this->integrator); + } + + /** + * Optional. Resource name of the integrator. Required if account is not + * provided. Otherwise, leave this field empty/unset. + * + * Generated from protobuf field optional string integrator = 3 [(.google.api.field_behavior) = OPTIONAL]; + * @param string $var + * @return $this + */ + public function setIntegrator($var) + { + GPBUtil::checkString($var, True); + $this->integrator = $var; + + return $this; + } + } diff --git a/Channel/src/V1/RepricingConfig.php b/Channel/src/V1/RepricingConfig.php index 1c29048bb25b..dbeb8a61abec 100644 --- a/Channel/src/V1/RepricingConfig.php +++ b/Channel/src/V1/RepricingConfig.php @@ -53,7 +53,7 @@ class RepricingConfig extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type \Google\Cloud\Channel\V1\RepricingConfig\EntitlementGranularity $entitlement_granularity - * Applies the repricing configuration at the entitlement level. + * Required. Applies the repricing configuration at the entitlement level. * Note: If a * [ChannelPartnerRepricingConfig][google.cloud.channel.v1.ChannelPartnerRepricingConfig] * using @@ -94,7 +94,7 @@ public function __construct($data = NULL) { } /** - * Applies the repricing configuration at the entitlement level. + * Required. Applies the repricing configuration at the entitlement level. * Note: If a * [ChannelPartnerRepricingConfig][google.cloud.channel.v1.ChannelPartnerRepricingConfig] * using @@ -108,7 +108,7 @@ public function __construct($data = NULL) { * and * [ChannelPartnerRepricingConfig][google.cloud.channel.v1.ChannelPartnerRepricingConfig]. * - * Generated from protobuf field .google.cloud.channel.v1.RepricingConfig.EntitlementGranularity entitlement_granularity = 4; + * Generated from protobuf field .google.cloud.channel.v1.RepricingConfig.EntitlementGranularity entitlement_granularity = 4 [(.google.api.field_behavior) = REQUIRED]; * @return \Google\Cloud\Channel\V1\RepricingConfig\EntitlementGranularity|null */ public function getEntitlementGranularity() @@ -122,7 +122,7 @@ public function hasEntitlementGranularity() } /** - * Applies the repricing configuration at the entitlement level. + * Required. Applies the repricing configuration at the entitlement level. * Note: If a * [ChannelPartnerRepricingConfig][google.cloud.channel.v1.ChannelPartnerRepricingConfig] * using @@ -136,7 +136,7 @@ public function hasEntitlementGranularity() * and * [ChannelPartnerRepricingConfig][google.cloud.channel.v1.ChannelPartnerRepricingConfig]. * - * Generated from protobuf field .google.cloud.channel.v1.RepricingConfig.EntitlementGranularity entitlement_granularity = 4; + * Generated from protobuf field .google.cloud.channel.v1.RepricingConfig.EntitlementGranularity entitlement_granularity = 4 [(.google.api.field_behavior) = REQUIRED]; * @param \Google\Cloud\Channel\V1\RepricingConfig\EntitlementGranularity $var * @return $this */ diff --git a/Channel/src/V1/TransferableOffer.php b/Channel/src/V1/TransferableOffer.php index 1beb88ab7500..71e55d110696 100644 --- a/Channel/src/V1/TransferableOffer.php +++ b/Channel/src/V1/TransferableOffer.php @@ -22,6 +22,14 @@ class TransferableOffer extends \Google\Protobuf\Internal\Message * Generated from protobuf field .google.cloud.channel.v1.Offer offer = 1; */ protected $offer = null; + /** + * Optional. Price reference ID for the offer. Only for offers that require + * additional price information. Used to guarantee that the pricing is + * consistent between quoting the offer and placing the order. + * + * Generated from protobuf field string price_reference_id = 2 [(.google.api.field_behavior) = OPTIONAL]; + */ + protected $price_reference_id = ''; /** * Constructor. @@ -31,6 +39,10 @@ class TransferableOffer extends \Google\Protobuf\Internal\Message * * @type \Google\Cloud\Channel\V1\Offer $offer * Offer with parameter constraints updated to allow the Transfer. + * @type string $price_reference_id + * Optional. Price reference ID for the offer. Only for offers that require + * additional price information. Used to guarantee that the pricing is + * consistent between quoting the offer and placing the order. * } */ public function __construct($data = NULL) { @@ -74,5 +86,35 @@ public function setOffer($var) return $this; } + /** + * Optional. Price reference ID for the offer. Only for offers that require + * additional price information. Used to guarantee that the pricing is + * consistent between quoting the offer and placing the order. + * + * Generated from protobuf field string price_reference_id = 2 [(.google.api.field_behavior) = OPTIONAL]; + * @return string + */ + public function getPriceReferenceId() + { + return $this->price_reference_id; + } + + /** + * Optional. Price reference ID for the offer. Only for offers that require + * additional price information. Used to guarantee that the pricing is + * consistent between quoting the offer and placing the order. + * + * Generated from protobuf field string price_reference_id = 2 [(.google.api.field_behavior) = OPTIONAL]; + * @param string $var + * @return $this + */ + public function setPriceReferenceId($var) + { + GPBUtil::checkString($var, True); + $this->price_reference_id = $var; + + return $this; + } + } diff --git a/Channel/src/V1/UnregisterSubscriberRequest.php b/Channel/src/V1/UnregisterSubscriberRequest.php index f3a29099fb12..785d27125f47 100644 --- a/Channel/src/V1/UnregisterSubscriberRequest.php +++ b/Channel/src/V1/UnregisterSubscriberRequest.php @@ -16,9 +16,10 @@ class UnregisterSubscriberRequest extends \Google\Protobuf\Internal\Message { /** - * Required. Resource name of the account. + * Optional. Resource name of the account. Required if integrator is not + * provided. Otherwise, leave this field empty/unset. * - * Generated from protobuf field string account = 1 [(.google.api.field_behavior) = REQUIRED]; + * Generated from protobuf field string account = 1 [(.google.api.field_behavior) = OPTIONAL, (.google.api.resource_reference) = { */ protected $account = ''; /** @@ -28,6 +29,13 @@ class UnregisterSubscriberRequest extends \Google\Protobuf\Internal\Message * Generated from protobuf field string service_account = 2 [(.google.api.field_behavior) = REQUIRED]; */ protected $service_account = ''; + /** + * Optional. Resource name of the integrator. Required if account is not + * provided. Otherwise, leave this field empty/unset. + * + * Generated from protobuf field optional string integrator = 3 [(.google.api.field_behavior) = OPTIONAL]; + */ + protected $integrator = null; /** * Constructor. @@ -36,10 +44,14 @@ class UnregisterSubscriberRequest extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $account - * Required. Resource name of the account. + * Optional. Resource name of the account. Required if integrator is not + * provided. Otherwise, leave this field empty/unset. * @type string $service_account * Required. Service account to unregister from subscriber access to the * topic. + * @type string $integrator + * Optional. Resource name of the integrator. Required if account is not + * provided. Otherwise, leave this field empty/unset. * } */ public function __construct($data = NULL) { @@ -48,9 +60,10 @@ public function __construct($data = NULL) { } /** - * Required. Resource name of the account. + * Optional. Resource name of the account. Required if integrator is not + * provided. Otherwise, leave this field empty/unset. * - * Generated from protobuf field string account = 1 [(.google.api.field_behavior) = REQUIRED]; + * Generated from protobuf field string account = 1 [(.google.api.field_behavior) = OPTIONAL, (.google.api.resource_reference) = { * @return string */ public function getAccount() @@ -59,9 +72,10 @@ public function getAccount() } /** - * Required. Resource name of the account. + * Optional. Resource name of the account. Required if integrator is not + * provided. Otherwise, leave this field empty/unset. * - * Generated from protobuf field string account = 1 [(.google.api.field_behavior) = REQUIRED]; + * Generated from protobuf field string account = 1 [(.google.api.field_behavior) = OPTIONAL, (.google.api.resource_reference) = { * @param string $var * @return $this */ @@ -101,5 +115,43 @@ public function setServiceAccount($var) return $this; } + /** + * Optional. Resource name of the integrator. Required if account is not + * provided. Otherwise, leave this field empty/unset. + * + * Generated from protobuf field optional string integrator = 3 [(.google.api.field_behavior) = OPTIONAL]; + * @return string + */ + public function getIntegrator() + { + return isset($this->integrator) ? $this->integrator : ''; + } + + public function hasIntegrator() + { + return isset($this->integrator); + } + + public function clearIntegrator() + { + unset($this->integrator); + } + + /** + * Optional. Resource name of the integrator. Required if account is not + * provided. Otherwise, leave this field empty/unset. + * + * Generated from protobuf field optional string integrator = 3 [(.google.api.field_behavior) = OPTIONAL]; + * @param string $var + * @return $this + */ + public function setIntegrator($var) + { + GPBUtil::checkString($var, True); + $this->integrator = $var; + + return $this; + } + } diff --git a/Channel/src/V1/resources/cloud_channel_service_descriptor_config.php b/Channel/src/V1/resources/cloud_channel_service_descriptor_config.php index edcf6ca6b530..79fbf565af1d 100644 --- a/Channel/src/V1/resources/cloud_channel_service_descriptor_config.php +++ b/Channel/src/V1/resources/cloud_channel_service_descriptor_config.php @@ -664,6 +664,12 @@ 'callType' => \Google\ApiCore\Call::PAGINATED_CALL, 'responseType' => 'Google\Cloud\Channel\V1\ListSubscribersResponse', 'headerParams' => [ + [ + 'keyName' => 'integrator', + 'fieldAccessors' => [ + 'getIntegrator', + ], + ], [ 'keyName' => 'account', 'fieldAccessors' => [ @@ -740,6 +746,12 @@ 'callType' => \Google\ApiCore\Call::UNARY_CALL, 'responseType' => 'Google\Cloud\Channel\V1\RegisterSubscriberResponse', 'headerParams' => [ + [ + 'keyName' => 'integrator', + 'fieldAccessors' => [ + 'getIntegrator', + ], + ], [ 'keyName' => 'account', 'fieldAccessors' => [ @@ -752,6 +764,12 @@ 'callType' => \Google\ApiCore\Call::UNARY_CALL, 'responseType' => 'Google\Cloud\Channel\V1\UnregisterSubscriberResponse', 'headerParams' => [ + [ + 'keyName' => 'integrator', + 'fieldAccessors' => [ + 'getIntegrator', + ], + ], [ 'keyName' => 'account', 'fieldAccessors' => [ @@ -812,6 +830,7 @@ ], ], 'templateMap' => [ + 'account' => 'accounts/{account}', 'channelPartnerLink' => 'accounts/{account}/channelPartnerLinks/{channel_partner_link}', 'channelPartnerRepricingConfig' => 'accounts/{account}/channelPartnerLinks/{channel_partner}/channelPartnerRepricingConfigs/{channel_partner_repricing_config}', 'customer' => 'accounts/{account}/customers/{customer}', diff --git a/Channel/src/V1/resources/cloud_channel_service_rest_client_config.php b/Channel/src/V1/resources/cloud_channel_service_rest_client_config.php index 944a1b7fa7e6..92b2065c80b3 100644 --- a/Channel/src/V1/resources/cloud_channel_service_rest_client_config.php +++ b/Channel/src/V1/resources/cloud_channel_service_rest_client_config.php @@ -432,12 +432,23 @@ 'ListSubscribers' => [ 'method' => 'get', 'uriTemplate' => '/v1/{account=accounts/*}:listSubscribers', + 'additionalBindings' => [ + [ + 'method' => 'get', + 'uriTemplate' => '/v1/{integrator=integrators/*}:listSubscribers', + ], + ], 'placeholders' => [ 'account' => [ 'getters' => [ 'getAccount', ], ], + 'integrator' => [ + 'getters' => [ + 'getIntegrator', + ], + ], ], ], 'ListTransferableOffers' => [ @@ -502,12 +513,24 @@ 'method' => 'post', 'uriTemplate' => '/v1/{account=accounts/*}:register', 'body' => '*', + 'additionalBindings' => [ + [ + 'method' => 'post', + 'uriTemplate' => '/v1/{integrator=integrators/*}:registerSubscriber', + 'body' => '*', + ], + ], 'placeholders' => [ 'account' => [ 'getters' => [ 'getAccount', ], ], + 'integrator' => [ + 'getters' => [ + 'getIntegrator', + ], + ], ], ], 'StartPaidService' => [ @@ -562,12 +585,24 @@ 'method' => 'post', 'uriTemplate' => '/v1/{account=accounts/*}:unregister', 'body' => '*', + 'additionalBindings' => [ + [ + 'method' => 'post', + 'uriTemplate' => '/v1/{integrator=integrators/*}:unregisterSubscriber', + 'body' => '*', + ], + ], 'placeholders' => [ 'account' => [ 'getters' => [ 'getAccount', ], ], + 'integrator' => [ + 'getters' => [ + 'getIntegrator', + ], + ], ], ], 'UpdateChannelPartnerLink' => [ diff --git a/Channel/tests/Unit/V1/Client/CloudChannelServiceClientTest.php b/Channel/tests/Unit/V1/Client/CloudChannelServiceClientTest.php index 2a67567cd646..f455683b64a6 100644 --- a/Channel/tests/Unit/V1/Client/CloudChannelServiceClientTest.php +++ b/Channel/tests/Unit/V1/Client/CloudChannelServiceClientTest.php @@ -102,6 +102,7 @@ use Google\Cloud\Channel\V1\RenewalSettings; use Google\Cloud\Channel\V1\RepricingAdjustment; use Google\Cloud\Channel\V1\RepricingConfig; +use Google\Cloud\Channel\V1\RepricingConfig\EntitlementGranularity; use Google\Cloud\Channel\V1\Sku; use Google\Cloud\Channel\V1\SkuGroup; use Google\Cloud\Channel\V1\StartPaidServiceRequest; @@ -183,11 +184,13 @@ public function activateEntitlementTest() $offer = 'offer105650780'; $purchaseOrderId = 'purchaseOrderId548224298'; $billingAccount = 'billingAccount-545871767'; + $priceReferenceId = 'priceReferenceId-1320042043'; $expectedResponse = new Entitlement(); $expectedResponse->setName($name2); $expectedResponse->setOffer($offer); $expectedResponse->setPurchaseOrderId($purchaseOrderId); $expectedResponse->setBillingAccount($billingAccount); + $expectedResponse->setPriceReferenceId($priceReferenceId); $anyResponse = new Any(); $anyResponse->setValue($expectedResponse->serializeToString()); $completeOperation = new Operation(); @@ -435,11 +438,13 @@ public function changeOfferTest() $offer2 = 'offer2-1548812529'; $purchaseOrderId2 = 'purchaseOrderId2-1437424035'; $billingAccount2 = 'billingAccount2-596754980'; + $priceReferenceId2 = 'priceReferenceId2-1545048008'; $expectedResponse = new Entitlement(); $expectedResponse->setName($name2); $expectedResponse->setOffer($offer2); $expectedResponse->setPurchaseOrderId($purchaseOrderId2); $expectedResponse->setBillingAccount($billingAccount2); + $expectedResponse->setPriceReferenceId($priceReferenceId2); $anyResponse = new Any(); $anyResponse->setValue($expectedResponse->serializeToString()); $completeOperation = new Operation(); @@ -569,11 +574,13 @@ public function changeParametersTest() $offer = 'offer105650780'; $purchaseOrderId2 = 'purchaseOrderId2-1437424035'; $billingAccount = 'billingAccount-545871767'; + $priceReferenceId = 'priceReferenceId-1320042043'; $expectedResponse = new Entitlement(); $expectedResponse->setName($name2); $expectedResponse->setOffer($offer); $expectedResponse->setPurchaseOrderId($purchaseOrderId2); $expectedResponse->setBillingAccount($billingAccount); + $expectedResponse->setPriceReferenceId($priceReferenceId); $anyResponse = new Any(); $anyResponse->setValue($expectedResponse->serializeToString()); $completeOperation = new Operation(); @@ -703,11 +710,13 @@ public function changeRenewalSettingsTest() $offer = 'offer105650780'; $purchaseOrderId = 'purchaseOrderId548224298'; $billingAccount = 'billingAccount-545871767'; + $priceReferenceId = 'priceReferenceId-1320042043'; $expectedResponse = new Entitlement(); $expectedResponse->setName($name2); $expectedResponse->setOffer($offer); $expectedResponse->setPurchaseOrderId($purchaseOrderId); $expectedResponse->setBillingAccount($billingAccount); + $expectedResponse->setPriceReferenceId($priceReferenceId); $anyResponse = new Any(); $anyResponse->setValue($expectedResponse->serializeToString()); $completeOperation = new Operation(); @@ -992,6 +1001,10 @@ public function createChannelPartnerRepricingConfigTest() $channelPartnerRepricingConfigRepricingConfig->setAdjustment($repricingConfigAdjustment); $repricingConfigRebillingBasis = RebillingBasis::REBILLING_BASIS_UNSPECIFIED; $channelPartnerRepricingConfigRepricingConfig->setRebillingBasis($repricingConfigRebillingBasis); + $repricingConfigEntitlementGranularity = new EntitlementGranularity(); + $channelPartnerRepricingConfigRepricingConfig->setEntitlementGranularity( + $repricingConfigEntitlementGranularity + ); $channelPartnerRepricingConfig->setRepricingConfig($channelPartnerRepricingConfigRepricingConfig); $request = (new CreateChannelPartnerRepricingConfigRequest()) ->setParent($formattedParent) @@ -1044,6 +1057,10 @@ public function createChannelPartnerRepricingConfigExceptionTest() $channelPartnerRepricingConfigRepricingConfig->setAdjustment($repricingConfigAdjustment); $repricingConfigRebillingBasis = RebillingBasis::REBILLING_BASIS_UNSPECIFIED; $channelPartnerRepricingConfigRepricingConfig->setRebillingBasis($repricingConfigRebillingBasis); + $repricingConfigEntitlementGranularity = new EntitlementGranularity(); + $channelPartnerRepricingConfigRepricingConfig->setEntitlementGranularity( + $repricingConfigEntitlementGranularity + ); $channelPartnerRepricingConfig->setRepricingConfig($channelPartnerRepricingConfigRepricingConfig); $request = (new CreateChannelPartnerRepricingConfigRequest()) ->setParent($formattedParent) @@ -1179,6 +1196,8 @@ public function createCustomerRepricingConfigTest() $customerRepricingConfigRepricingConfig->setAdjustment($repricingConfigAdjustment); $repricingConfigRebillingBasis = RebillingBasis::REBILLING_BASIS_UNSPECIFIED; $customerRepricingConfigRepricingConfig->setRebillingBasis($repricingConfigRebillingBasis); + $repricingConfigEntitlementGranularity = new EntitlementGranularity(); + $customerRepricingConfigRepricingConfig->setEntitlementGranularity($repricingConfigEntitlementGranularity); $customerRepricingConfig->setRepricingConfig($customerRepricingConfigRepricingConfig); $request = (new CreateCustomerRepricingConfigRequest()) ->setParent($formattedParent) @@ -1231,6 +1250,8 @@ public function createCustomerRepricingConfigExceptionTest() $customerRepricingConfigRepricingConfig->setAdjustment($repricingConfigAdjustment); $repricingConfigRebillingBasis = RebillingBasis::REBILLING_BASIS_UNSPECIFIED; $customerRepricingConfigRepricingConfig->setRebillingBasis($repricingConfigRebillingBasis); + $repricingConfigEntitlementGranularity = new EntitlementGranularity(); + $customerRepricingConfigRepricingConfig->setEntitlementGranularity($repricingConfigEntitlementGranularity); $customerRepricingConfig->setRepricingConfig($customerRepricingConfigRepricingConfig); $request = (new CreateCustomerRepricingConfigRequest()) ->setParent($formattedParent) @@ -1273,11 +1294,13 @@ public function createEntitlementTest() $offer = 'offer105650780'; $purchaseOrderId = 'purchaseOrderId548224298'; $billingAccount = 'billingAccount-545871767'; + $priceReferenceId = 'priceReferenceId-1320042043'; $expectedResponse = new Entitlement(); $expectedResponse->setName($name); $expectedResponse->setOffer($offer); $expectedResponse->setPurchaseOrderId($purchaseOrderId); $expectedResponse->setBillingAccount($billingAccount); + $expectedResponse->setPriceReferenceId($priceReferenceId); $anyResponse = new Any(); $anyResponse->setValue($expectedResponse->serializeToString()); $completeOperation = new Operation(); @@ -1906,11 +1929,13 @@ public function getEntitlementTest() $offer = 'offer105650780'; $purchaseOrderId = 'purchaseOrderId548224298'; $billingAccount = 'billingAccount-545871767'; + $priceReferenceId = 'priceReferenceId-1320042043'; $expectedResponse = new Entitlement(); $expectedResponse->setName($name2); $expectedResponse->setOffer($offer); $expectedResponse->setPurchaseOrderId($purchaseOrderId); $expectedResponse->setBillingAccount($billingAccount); + $expectedResponse->setPriceReferenceId($priceReferenceId); $transport->addResponse($expectedResponse); // Mock request $formattedName = $gapicClient->entitlementName('[ACCOUNT]', '[CUSTOMER]', '[ENTITLEMENT]'); @@ -3005,9 +3030,7 @@ public function listSubscribersTest() $expectedResponse->setNextPageToken($nextPageToken); $expectedResponse->setServiceAccounts($serviceAccounts); $transport->addResponse($expectedResponse); - // Mock request - $account = 'account-1177318867'; - $request = (new ListSubscribersRequest())->setAccount($account); + $request = new ListSubscribersRequest(); $response = $gapicClient->listSubscribers($request); $this->assertEquals($expectedResponse, $response->getPage()->getResponseObject()); $resources = iterator_to_array($response->iterateAllElements()); @@ -3018,8 +3041,6 @@ public function listSubscribersTest() $actualFuncCall = $actualRequests[0]->getFuncCall(); $actualRequestObject = $actualRequests[0]->getRequestObject(); $this->assertSame('/google.cloud.channel.v1.CloudChannelService/ListSubscribers', $actualFuncCall); - $actualValue = $actualRequestObject->getAccount(); - $this->assertProtobufEquals($account, $actualValue); $this->assertTrue($transport->isExhausted()); } @@ -3044,9 +3065,7 @@ public function listSubscribersExceptionTest() JSON_PRETTY_PRINT ); $transport->addResponse(null, $status); - // Mock request - $account = 'account-1177318867'; - $request = (new ListSubscribersRequest())->setAccount($account); + $request = new ListSubscribersRequest(); try { $gapicClient->listSubscribers($request); // If the $gapicClient method call did not throw, fail the test @@ -3492,9 +3511,8 @@ public function registerSubscriberTest() $expectedResponse->setTopic($topic); $transport->addResponse($expectedResponse); // Mock request - $account = 'account-1177318867'; $serviceAccount = 'serviceAccount-1948028253'; - $request = (new RegisterSubscriberRequest())->setAccount($account)->setServiceAccount($serviceAccount); + $request = (new RegisterSubscriberRequest())->setServiceAccount($serviceAccount); $response = $gapicClient->registerSubscriber($request); $this->assertEquals($expectedResponse, $response); $actualRequests = $transport->popReceivedCalls(); @@ -3502,8 +3520,6 @@ public function registerSubscriberTest() $actualFuncCall = $actualRequests[0]->getFuncCall(); $actualRequestObject = $actualRequests[0]->getRequestObject(); $this->assertSame('/google.cloud.channel.v1.CloudChannelService/RegisterSubscriber', $actualFuncCall); - $actualValue = $actualRequestObject->getAccount(); - $this->assertProtobufEquals($account, $actualValue); $actualValue = $actualRequestObject->getServiceAccount(); $this->assertProtobufEquals($serviceAccount, $actualValue); $this->assertTrue($transport->isExhausted()); @@ -3531,9 +3547,8 @@ public function registerSubscriberExceptionTest() ); $transport->addResponse(null, $status); // Mock request - $account = 'account-1177318867'; $serviceAccount = 'serviceAccount-1948028253'; - $request = (new RegisterSubscriberRequest())->setAccount($account)->setServiceAccount($serviceAccount); + $request = (new RegisterSubscriberRequest())->setServiceAccount($serviceAccount); try { $gapicClient->registerSubscriber($request); // If the $gapicClient method call did not throw, fail the test @@ -3572,11 +3587,13 @@ public function startPaidServiceTest() $offer = 'offer105650780'; $purchaseOrderId = 'purchaseOrderId548224298'; $billingAccount = 'billingAccount-545871767'; + $priceReferenceId = 'priceReferenceId-1320042043'; $expectedResponse = new Entitlement(); $expectedResponse->setName($name2); $expectedResponse->setOffer($offer); $expectedResponse->setPurchaseOrderId($purchaseOrderId); $expectedResponse->setBillingAccount($billingAccount); + $expectedResponse->setPriceReferenceId($priceReferenceId); $anyResponse = new Any(); $anyResponse->setValue($expectedResponse->serializeToString()); $completeOperation = new Operation(); @@ -3702,11 +3719,13 @@ public function suspendEntitlementTest() $offer = 'offer105650780'; $purchaseOrderId = 'purchaseOrderId548224298'; $billingAccount = 'billingAccount-545871767'; + $priceReferenceId = 'priceReferenceId-1320042043'; $expectedResponse = new Entitlement(); $expectedResponse->setName($name2); $expectedResponse->setOffer($offer); $expectedResponse->setPurchaseOrderId($purchaseOrderId); $expectedResponse->setBillingAccount($billingAccount); + $expectedResponse->setPriceReferenceId($priceReferenceId); $anyResponse = new Any(); $anyResponse->setValue($expectedResponse->serializeToString()); $completeOperation = new Operation(); @@ -4076,9 +4095,8 @@ public function unregisterSubscriberTest() $expectedResponse->setTopic($topic); $transport->addResponse($expectedResponse); // Mock request - $account = 'account-1177318867'; $serviceAccount = 'serviceAccount-1948028253'; - $request = (new UnregisterSubscriberRequest())->setAccount($account)->setServiceAccount($serviceAccount); + $request = (new UnregisterSubscriberRequest())->setServiceAccount($serviceAccount); $response = $gapicClient->unregisterSubscriber($request); $this->assertEquals($expectedResponse, $response); $actualRequests = $transport->popReceivedCalls(); @@ -4086,8 +4104,6 @@ public function unregisterSubscriberTest() $actualFuncCall = $actualRequests[0]->getFuncCall(); $actualRequestObject = $actualRequests[0]->getRequestObject(); $this->assertSame('/google.cloud.channel.v1.CloudChannelService/UnregisterSubscriber', $actualFuncCall); - $actualValue = $actualRequestObject->getAccount(); - $this->assertProtobufEquals($account, $actualValue); $actualValue = $actualRequestObject->getServiceAccount(); $this->assertProtobufEquals($serviceAccount, $actualValue); $this->assertTrue($transport->isExhausted()); @@ -4115,9 +4131,8 @@ public function unregisterSubscriberExceptionTest() ); $transport->addResponse(null, $status); // Mock request - $account = 'account-1177318867'; $serviceAccount = 'serviceAccount-1948028253'; - $request = (new UnregisterSubscriberRequest())->setAccount($account)->setServiceAccount($serviceAccount); + $request = (new UnregisterSubscriberRequest())->setServiceAccount($serviceAccount); try { $gapicClient->unregisterSubscriber($request); // If the $gapicClient method call did not throw, fail the test @@ -4246,6 +4261,10 @@ public function updateChannelPartnerRepricingConfigTest() $channelPartnerRepricingConfigRepricingConfig->setAdjustment($repricingConfigAdjustment); $repricingConfigRebillingBasis = RebillingBasis::REBILLING_BASIS_UNSPECIFIED; $channelPartnerRepricingConfigRepricingConfig->setRebillingBasis($repricingConfigRebillingBasis); + $repricingConfigEntitlementGranularity = new EntitlementGranularity(); + $channelPartnerRepricingConfigRepricingConfig->setEntitlementGranularity( + $repricingConfigEntitlementGranularity + ); $channelPartnerRepricingConfig->setRepricingConfig($channelPartnerRepricingConfigRepricingConfig); $request = (new UpdateChannelPartnerRepricingConfigRequest())->setChannelPartnerRepricingConfig( $channelPartnerRepricingConfig @@ -4295,6 +4314,10 @@ public function updateChannelPartnerRepricingConfigExceptionTest() $channelPartnerRepricingConfigRepricingConfig->setAdjustment($repricingConfigAdjustment); $repricingConfigRebillingBasis = RebillingBasis::REBILLING_BASIS_UNSPECIFIED; $channelPartnerRepricingConfigRepricingConfig->setRebillingBasis($repricingConfigRebillingBasis); + $repricingConfigEntitlementGranularity = new EntitlementGranularity(); + $channelPartnerRepricingConfigRepricingConfig->setEntitlementGranularity( + $repricingConfigEntitlementGranularity + ); $channelPartnerRepricingConfig->setRepricingConfig($channelPartnerRepricingConfigRepricingConfig); $request = (new UpdateChannelPartnerRepricingConfigRequest())->setChannelPartnerRepricingConfig( $channelPartnerRepricingConfig @@ -4425,6 +4448,8 @@ public function updateCustomerRepricingConfigTest() $customerRepricingConfigRepricingConfig->setAdjustment($repricingConfigAdjustment); $repricingConfigRebillingBasis = RebillingBasis::REBILLING_BASIS_UNSPECIFIED; $customerRepricingConfigRepricingConfig->setRebillingBasis($repricingConfigRebillingBasis); + $repricingConfigEntitlementGranularity = new EntitlementGranularity(); + $customerRepricingConfigRepricingConfig->setEntitlementGranularity($repricingConfigEntitlementGranularity); $customerRepricingConfig->setRepricingConfig($customerRepricingConfigRepricingConfig); $request = (new UpdateCustomerRepricingConfigRequest())->setCustomerRepricingConfig($customerRepricingConfig); $response = $gapicClient->updateCustomerRepricingConfig($request); @@ -4472,6 +4497,8 @@ public function updateCustomerRepricingConfigExceptionTest() $customerRepricingConfigRepricingConfig->setAdjustment($repricingConfigAdjustment); $repricingConfigRebillingBasis = RebillingBasis::REBILLING_BASIS_UNSPECIFIED; $customerRepricingConfigRepricingConfig->setRebillingBasis($repricingConfigRebillingBasis); + $repricingConfigEntitlementGranularity = new EntitlementGranularity(); + $customerRepricingConfigRepricingConfig->setEntitlementGranularity($repricingConfigEntitlementGranularity); $customerRepricingConfig->setRepricingConfig($customerRepricingConfigRepricingConfig); $request = (new UpdateCustomerRepricingConfigRequest())->setCustomerRepricingConfig($customerRepricingConfig); try { @@ -4512,11 +4539,13 @@ public function activateEntitlementAsyncTest() $offer = 'offer105650780'; $purchaseOrderId = 'purchaseOrderId548224298'; $billingAccount = 'billingAccount-545871767'; + $priceReferenceId = 'priceReferenceId-1320042043'; $expectedResponse = new Entitlement(); $expectedResponse->setName($name2); $expectedResponse->setOffer($offer); $expectedResponse->setPurchaseOrderId($purchaseOrderId); $expectedResponse->setBillingAccount($billingAccount); + $expectedResponse->setPriceReferenceId($priceReferenceId); $anyResponse = new Any(); $anyResponse->setValue($expectedResponse->serializeToString()); $completeOperation = new Operation(); diff --git a/Compute/metadata/V1/Compute.php b/Compute/metadata/V1/Compute.php index 6f64bdeb4cd6..27fc3398aa8e 100644 Binary files a/Compute/metadata/V1/Compute.php and b/Compute/metadata/V1/Compute.php differ diff --git a/Compute/samples/V1/AcceleratorTypesClient/aggregated_list.php b/Compute/samples/V1/AcceleratorTypesClient/aggregated_list.php index 5f1f70653107..97290e763beb 100644 --- a/Compute/samples/V1/AcceleratorTypesClient/aggregated_list.php +++ b/Compute/samples/V1/AcceleratorTypesClient/aggregated_list.php @@ -29,7 +29,10 @@ use Google\Cloud\Compute\V1\Client\AcceleratorTypesClient; /** - * Retrieves an aggregated list of accelerator types. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. + * Retrieves an aggregated list of accelerator types. + * + * To prevent failure, it is recommended that you set the + * `returnPartialSuccess` parameter to `true`. * * @param string $project Project ID for this request. */ diff --git a/Compute/samples/V1/AcceleratorTypesClient/list.php b/Compute/samples/V1/AcceleratorTypesClient/list.php index e08a87a82a37..89278f4a2ce2 100644 --- a/Compute/samples/V1/AcceleratorTypesClient/list.php +++ b/Compute/samples/V1/AcceleratorTypesClient/list.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\ListAcceleratorTypesRequest; /** - * Retrieves a list of accelerator types that are available to the specified project. + * Retrieves a list of accelerator types that are available to the specified + * project. * * @param string $project Project ID for this request. * @param string $zone The name of the zone for this request. diff --git a/Compute/samples/V1/AddressesClient/aggregated_list.php b/Compute/samples/V1/AddressesClient/aggregated_list.php index 095440364dec..8a70bd8c2561 100644 --- a/Compute/samples/V1/AddressesClient/aggregated_list.php +++ b/Compute/samples/V1/AddressesClient/aggregated_list.php @@ -29,7 +29,10 @@ use Google\Cloud\Compute\V1\Client\AddressesClient; /** - * Retrieves an aggregated list of addresses. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. + * Retrieves an aggregated list of addresses. + * + * To prevent failure, it is recommended that you set the + * `returnPartialSuccess` parameter to `true`. * * @param string $project Project ID for this request. */ diff --git a/Compute/samples/V1/AddressesClient/insert.php b/Compute/samples/V1/AddressesClient/insert.php index 8313843b91f6..ff39185bc57e 100644 --- a/Compute/samples/V1/AddressesClient/insert.php +++ b/Compute/samples/V1/AddressesClient/insert.php @@ -31,7 +31,8 @@ use Google\Rpc\Status; /** - * Creates an address resource in the specified project by using the data included in the request. + * Creates an address resource in the specified project by using the data + * included in the request. * * @param string $project Project ID for this request. * @param string $region Name of the region for this request. diff --git a/Compute/samples/V1/AddressesClient/list.php b/Compute/samples/V1/AddressesClient/list.php index 201339cdb56d..4c73c9fe0781 100644 --- a/Compute/samples/V1/AddressesClient/list.php +++ b/Compute/samples/V1/AddressesClient/list.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\ListAddressesRequest; /** - * Retrieves a list of addresses contained within the specified region. + * Retrieves a list of addresses contained within + * the specified region. * * @param string $project Project ID for this request. * @param string $region Name of the region for this request. diff --git a/Compute/samples/V1/AddressesClient/set_labels.php b/Compute/samples/V1/AddressesClient/set_labels.php index df5bfab34174..fb9c80009ae5 100644 --- a/Compute/samples/V1/AddressesClient/set_labels.php +++ b/Compute/samples/V1/AddressesClient/set_labels.php @@ -31,7 +31,8 @@ use Google\Rpc\Status; /** - * Sets the labels on an Address. To learn more about labels, read the Labeling Resources documentation. + * Sets the labels on an Address. To learn more about labels, read theLabeling + * Resources documentation. * * @param string $project Project ID for this request. * @param string $region The region for this request. diff --git a/Compute/samples/V1/AutoscalersClient/aggregated_list.php b/Compute/samples/V1/AutoscalersClient/aggregated_list.php index dc49aa399d47..a1865c73c6d4 100644 --- a/Compute/samples/V1/AutoscalersClient/aggregated_list.php +++ b/Compute/samples/V1/AutoscalersClient/aggregated_list.php @@ -29,7 +29,10 @@ use Google\Cloud\Compute\V1\Client\AutoscalersClient; /** - * Retrieves an aggregated list of autoscalers. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. + * Retrieves an aggregated list of autoscalers. + * + * To prevent failure, it is recommended that you set the + * `returnPartialSuccess` parameter to `true`. * * @param string $project Project ID for this request. */ diff --git a/Compute/samples/V1/AutoscalersClient/insert.php b/Compute/samples/V1/AutoscalersClient/insert.php index 86daf23afc2b..8ba3533eecc1 100644 --- a/Compute/samples/V1/AutoscalersClient/insert.php +++ b/Compute/samples/V1/AutoscalersClient/insert.php @@ -31,7 +31,8 @@ use Google\Rpc\Status; /** - * Creates an autoscaler in the specified project using the data included in the request. + * Creates an autoscaler in the specified project using the data + * included in the request. * * @param string $project Project ID for this request. * @param string $zone Name of the zone for this request. diff --git a/Compute/samples/V1/AutoscalersClient/list.php b/Compute/samples/V1/AutoscalersClient/list.php index 92a58fe21ba2..55684536da8c 100644 --- a/Compute/samples/V1/AutoscalersClient/list.php +++ b/Compute/samples/V1/AutoscalersClient/list.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\ListAutoscalersRequest; /** - * Retrieves a list of autoscalers contained within the specified zone. + * Retrieves a list of autoscalers contained within + * the specified zone. * * @param string $project Project ID for this request. * @param string $zone Name of the zone for this request. diff --git a/Compute/samples/V1/AutoscalersClient/patch.php b/Compute/samples/V1/AutoscalersClient/patch.php index 535dcebaa3e1..8b24912fa438 100644 --- a/Compute/samples/V1/AutoscalersClient/patch.php +++ b/Compute/samples/V1/AutoscalersClient/patch.php @@ -31,7 +31,10 @@ use Google\Rpc\Status; /** - * Updates an autoscaler in the specified project using the data included in the request. This method supports PATCH semantics and uses the JSON merge patch format and processing rules. + * Updates an autoscaler in the specified project using the data + * included in the request. This method supportsPATCH + * semantics and uses theJSON merge + * patch format and processing rules. * * @param string $project Project ID for this request. * @param string $zone Name of the zone for this request. diff --git a/Compute/samples/V1/AutoscalersClient/update.php b/Compute/samples/V1/AutoscalersClient/update.php index ca78d981c910..1dbc9d535e4b 100644 --- a/Compute/samples/V1/AutoscalersClient/update.php +++ b/Compute/samples/V1/AutoscalersClient/update.php @@ -31,7 +31,8 @@ use Google\Rpc\Status; /** - * Updates an autoscaler in the specified project using the data included in the request. + * Updates an autoscaler in the specified project using the data + * included in the request. * * @param string $project Project ID for this request. * @param string $zone Name of the zone for this request. diff --git a/Compute/samples/V1/BackendBucketsClient/add_signed_url_key.php b/Compute/samples/V1/BackendBucketsClient/add_signed_url_key.php index 631ba963f25a..3c148853ee5f 100644 --- a/Compute/samples/V1/BackendBucketsClient/add_signed_url_key.php +++ b/Compute/samples/V1/BackendBucketsClient/add_signed_url_key.php @@ -31,9 +31,11 @@ use Google\Rpc\Status; /** - * Adds a key for validating requests with signed URLs for this backend bucket. + * Adds a key for validating requests with signed URLs for this backend + * bucket. * - * @param string $backendBucket Name of the BackendBucket resource to which the Signed URL Key should be added. The name should conform to RFC1035. + * @param string $backendBucket Name of the BackendBucket resource to which the Signed URL Key should be + * added. The name should conform to RFC1035. * @param string $project Project ID for this request. */ function add_signed_url_key_sample(string $backendBucket, string $project): void diff --git a/Compute/samples/V1/BackendBucketsClient/delete_signed_url_key.php b/Compute/samples/V1/BackendBucketsClient/delete_signed_url_key.php index 731c0005caf8..c8ab365c86d5 100644 --- a/Compute/samples/V1/BackendBucketsClient/delete_signed_url_key.php +++ b/Compute/samples/V1/BackendBucketsClient/delete_signed_url_key.php @@ -30,9 +30,11 @@ use Google\Rpc\Status; /** - * Deletes a key for validating requests with signed URLs for this backend bucket. + * Deletes a key for validating requests with signed URLs for this backend + * bucket. * - * @param string $backendBucket Name of the BackendBucket resource to which the Signed URL Key should be added. The name should conform to RFC1035. + * @param string $backendBucket Name of the BackendBucket resource to which the Signed URL Key should be + * added. The name should conform to RFC1035. * @param string $keyName The name of the Signed URL Key to delete. * @param string $project Project ID for this request. */ diff --git a/Compute/samples/V1/BackendBucketsClient/get_iam_policy.php b/Compute/samples/V1/BackendBucketsClient/get_iam_policy.php index e0162ce4ac31..22c01011d954 100644 --- a/Compute/samples/V1/BackendBucketsClient/get_iam_policy.php +++ b/Compute/samples/V1/BackendBucketsClient/get_iam_policy.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\Policy; /** - * Gets the access control policy for a resource. May be empty if no such policy or resource exists. + * Gets the access control policy for a resource. May be empty if no such + * policy or resource exists. * * @param string $project Project ID for this request. * @param string $resource Name or id of the resource for this request. diff --git a/Compute/samples/V1/BackendBucketsClient/insert.php b/Compute/samples/V1/BackendBucketsClient/insert.php index 99bfe4abf634..48c8deaeb449 100644 --- a/Compute/samples/V1/BackendBucketsClient/insert.php +++ b/Compute/samples/V1/BackendBucketsClient/insert.php @@ -31,7 +31,8 @@ use Google\Rpc\Status; /** - * Creates a BackendBucket resource in the specified project using the data included in the request. + * Creates a BackendBucket resource in the specified project using + * the data included in the request. * * @param string $project Project ID for this request. */ diff --git a/Compute/samples/V1/BackendBucketsClient/list.php b/Compute/samples/V1/BackendBucketsClient/list.php index 88b8bd5571ec..f16b8ddda432 100644 --- a/Compute/samples/V1/BackendBucketsClient/list.php +++ b/Compute/samples/V1/BackendBucketsClient/list.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\ListBackendBucketsRequest; /** - * Retrieves the list of BackendBucket resources available to the specified project. + * Retrieves the list of BackendBucket resources available to the specified + * project. * * @param string $project Project ID for this request. */ diff --git a/Compute/samples/V1/BackendBucketsClient/patch.php b/Compute/samples/V1/BackendBucketsClient/patch.php index 931c3adf8ca0..559c76698b5a 100644 --- a/Compute/samples/V1/BackendBucketsClient/patch.php +++ b/Compute/samples/V1/BackendBucketsClient/patch.php @@ -31,7 +31,10 @@ use Google\Rpc\Status; /** - * Updates the specified BackendBucket resource with the data included in the request. This method supports PATCH semantics and uses the JSON merge patch format and processing rules. + * Updates the specified BackendBucket resource with the data included in the + * request. This method supportsPATCH + * semantics and uses theJSON merge + * patch format and processing rules. * * @param string $backendBucket Name of the BackendBucket resource to patch. * @param string $project Project ID for this request. diff --git a/Compute/samples/V1/BackendBucketsClient/set_edge_security_policy.php b/Compute/samples/V1/BackendBucketsClient/set_edge_security_policy.php index 2786d2c59783..141fc82e67f7 100644 --- a/Compute/samples/V1/BackendBucketsClient/set_edge_security_policy.php +++ b/Compute/samples/V1/BackendBucketsClient/set_edge_security_policy.php @@ -33,7 +33,8 @@ /** * Sets the edge security policy for the specified backend bucket. * - * @param string $backendBucket Name of the BackendBucket resource to which the security policy should be set. The name should conform to RFC1035. + * @param string $backendBucket Name of the BackendBucket resource to which the security policy should be + * set. The name should conform to RFC1035. * @param string $project Project ID for this request. */ function set_edge_security_policy_sample(string $backendBucket, string $project): void diff --git a/Compute/samples/V1/BackendBucketsClient/set_iam_policy.php b/Compute/samples/V1/BackendBucketsClient/set_iam_policy.php index 22b614e86500..6a62863bb2bb 100644 --- a/Compute/samples/V1/BackendBucketsClient/set_iam_policy.php +++ b/Compute/samples/V1/BackendBucketsClient/set_iam_policy.php @@ -30,7 +30,8 @@ use Google\Cloud\Compute\V1\SetIamPolicyBackendBucketRequest; /** - * Sets the access control policy on the specified resource. Replaces any existing policy. + * Sets the access control policy on the specified resource. + * Replaces any existing policy. * * @param string $project Project ID for this request. * @param string $resource Name or id of the resource for this request. diff --git a/Compute/samples/V1/BackendBucketsClient/update.php b/Compute/samples/V1/BackendBucketsClient/update.php index d98d5ffa4a96..67078128a612 100644 --- a/Compute/samples/V1/BackendBucketsClient/update.php +++ b/Compute/samples/V1/BackendBucketsClient/update.php @@ -31,7 +31,8 @@ use Google\Rpc\Status; /** - * Updates the specified BackendBucket resource with the data included in the request. + * Updates the specified BackendBucket resource with the data included in the + * request. * * @param string $backendBucket Name of the BackendBucket resource to update. * @param string $project Project ID for this request. diff --git a/Compute/samples/V1/BackendServicesClient/add_signed_url_key.php b/Compute/samples/V1/BackendServicesClient/add_signed_url_key.php index b1159354e455..08c8c558b1f5 100644 --- a/Compute/samples/V1/BackendServicesClient/add_signed_url_key.php +++ b/Compute/samples/V1/BackendServicesClient/add_signed_url_key.php @@ -31,9 +31,11 @@ use Google\Rpc\Status; /** - * Adds a key for validating requests with signed URLs for this backend service. + * Adds a key for validating requests with signed URLs for this backend + * service. * - * @param string $backendService Name of the BackendService resource to which the Signed URL Key should be added. The name should conform to RFC1035. + * @param string $backendService Name of the BackendService resource to which the Signed URL Key should be + * added. The name should conform to RFC1035. * @param string $project Project ID for this request. */ function add_signed_url_key_sample(string $backendService, string $project): void diff --git a/Compute/samples/V1/BackendServicesClient/aggregated_list.php b/Compute/samples/V1/BackendServicesClient/aggregated_list.php index c6a2e048f116..88cae4b7954a 100644 --- a/Compute/samples/V1/BackendServicesClient/aggregated_list.php +++ b/Compute/samples/V1/BackendServicesClient/aggregated_list.php @@ -29,7 +29,11 @@ use Google\Cloud\Compute\V1\Client\BackendServicesClient; /** - * Retrieves the list of all BackendService resources, regional and global, available to the specified project. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. + * Retrieves the list of all BackendService resources, regional and global, + * available to the specified project. + * + * To prevent failure, it is recommended that you set the + * `returnPartialSuccess` parameter to `true`. * * @param string $project Name of the project scoping this request. */ diff --git a/Compute/samples/V1/BackendServicesClient/delete_signed_url_key.php b/Compute/samples/V1/BackendServicesClient/delete_signed_url_key.php index 4d7329b55a2d..30c2a4984912 100644 --- a/Compute/samples/V1/BackendServicesClient/delete_signed_url_key.php +++ b/Compute/samples/V1/BackendServicesClient/delete_signed_url_key.php @@ -30,9 +30,11 @@ use Google\Rpc\Status; /** - * Deletes a key for validating requests with signed URLs for this backend service. + * Deletes a key for validating requests with signed URLs for this backend + * service. * - * @param string $backendService Name of the BackendService resource to which the Signed URL Key should be added. The name should conform to RFC1035. + * @param string $backendService Name of the BackendService resource to which the Signed URL Key should be + * added. The name should conform to RFC1035. * @param string $keyName The name of the Signed URL Key to delete. * @param string $project Project ID for this request. */ diff --git a/Compute/samples/V1/BackendServicesClient/get_health.php b/Compute/samples/V1/BackendServicesClient/get_health.php index fade1c200635..f32693fb6df3 100644 --- a/Compute/samples/V1/BackendServicesClient/get_health.php +++ b/Compute/samples/V1/BackendServicesClient/get_health.php @@ -30,7 +30,14 @@ use Google\Cloud\Compute\V1\ResourceGroupReference; /** - * Gets the most recent health check results for this BackendService. Example request body: { "group": "/zones/us-east1-b/instanceGroups/lb-backend-example" } + * Gets the most recent health check results for this + * BackendService. + * + * Example request body: + * + * { + * "group": "/zones/us-east1-b/instanceGroups/lb-backend-example" + * } * * @param string $backendService Name of the BackendService resource to which the queried instance belongs. * @param string $project diff --git a/Compute/samples/V1/BackendServicesClient/get_iam_policy.php b/Compute/samples/V1/BackendServicesClient/get_iam_policy.php index 10a1416b0af1..7465f03e60b5 100644 --- a/Compute/samples/V1/BackendServicesClient/get_iam_policy.php +++ b/Compute/samples/V1/BackendServicesClient/get_iam_policy.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\Policy; /** - * Gets the access control policy for a resource. May be empty if no such policy or resource exists. + * Gets the access control policy for a resource. May be empty if no such + * policy or resource exists. * * @param string $project Project ID for this request. * @param string $resource Name or id of the resource for this request. diff --git a/Compute/samples/V1/BackendServicesClient/insert.php b/Compute/samples/V1/BackendServicesClient/insert.php index f4e89d70392c..18e40076da5b 100644 --- a/Compute/samples/V1/BackendServicesClient/insert.php +++ b/Compute/samples/V1/BackendServicesClient/insert.php @@ -31,7 +31,9 @@ use Google\Rpc\Status; /** - * Creates a BackendService resource in the specified project using the data included in the request. For more information, see Backend services overview . + * Creates a BackendService resource in the specified project using + * the data included in the request. For more information, see + * Backend services overview. * * @param string $project Project ID for this request. */ diff --git a/Compute/samples/V1/BackendServicesClient/list.php b/Compute/samples/V1/BackendServicesClient/list.php index 2b0623ed3264..46b20b638ca4 100644 --- a/Compute/samples/V1/BackendServicesClient/list.php +++ b/Compute/samples/V1/BackendServicesClient/list.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\ListBackendServicesRequest; /** - * Retrieves the list of BackendService resources available to the specified project. + * Retrieves the list of BackendService resources available to the specified + * project. * * @param string $project Project ID for this request. */ diff --git a/Compute/samples/V1/BackendServicesClient/patch.php b/Compute/samples/V1/BackendServicesClient/patch.php index 94d8a270ed18..b56cf187b9a0 100644 --- a/Compute/samples/V1/BackendServicesClient/patch.php +++ b/Compute/samples/V1/BackendServicesClient/patch.php @@ -31,7 +31,11 @@ use Google\Rpc\Status; /** - * Patches the specified BackendService resource with the data included in the request. For more information, see Backend services overview. This method supports PATCH semantics and uses the JSON merge patch format and processing rules. + * Patches the specified BackendService resource with the data included in the + * request. For more information, see + * Backend services overview. This method + * supports PATCH semantics and uses the JSON merge + * patch format and processing rules. * * @param string $backendService Name of the BackendService resource to patch. * @param string $project Project ID for this request. diff --git a/Compute/samples/V1/BackendServicesClient/set_edge_security_policy.php b/Compute/samples/V1/BackendServicesClient/set_edge_security_policy.php index 749f0c456c95..ee497e5a81e6 100644 --- a/Compute/samples/V1/BackendServicesClient/set_edge_security_policy.php +++ b/Compute/samples/V1/BackendServicesClient/set_edge_security_policy.php @@ -33,7 +33,8 @@ /** * Sets the edge security policy for the specified backend service. * - * @param string $backendService Name of the BackendService resource to which the edge security policy should be set. The name should conform to RFC1035. + * @param string $backendService Name of the BackendService resource to which the edge security policy + * should be set. The name should conform to RFC1035. * @param string $project Project ID for this request. */ function set_edge_security_policy_sample(string $backendService, string $project): void diff --git a/Compute/samples/V1/BackendServicesClient/set_iam_policy.php b/Compute/samples/V1/BackendServicesClient/set_iam_policy.php index 8439b2b3984e..24ccbbf79127 100644 --- a/Compute/samples/V1/BackendServicesClient/set_iam_policy.php +++ b/Compute/samples/V1/BackendServicesClient/set_iam_policy.php @@ -30,7 +30,8 @@ use Google\Cloud\Compute\V1\SetIamPolicyBackendServiceRequest; /** - * Sets the access control policy on the specified resource. Replaces any existing policy. + * Sets the access control policy on the specified resource. + * Replaces any existing policy. * * @param string $project Project ID for this request. * @param string $resource Name or id of the resource for this request. diff --git a/Compute/samples/V1/BackendServicesClient/set_security_policy.php b/Compute/samples/V1/BackendServicesClient/set_security_policy.php index 951853478ee4..e906f380a2f1 100644 --- a/Compute/samples/V1/BackendServicesClient/set_security_policy.php +++ b/Compute/samples/V1/BackendServicesClient/set_security_policy.php @@ -31,9 +31,12 @@ use Google\Rpc\Status; /** - * Sets the Google Cloud Armor security policy for the specified backend service. For more information, see Google Cloud Armor Overview + * Sets the Google Cloud Armor security policy for the specified backend + * service. For more information, seeGoogle + * Cloud Armor Overview * - * @param string $backendService Name of the BackendService resource to which the security policy should be set. The name should conform to RFC1035. + * @param string $backendService Name of the BackendService resource to which the security policy should be + * set. The name should conform to RFC1035. * @param string $project Project ID for this request. */ function set_security_policy_sample(string $backendService, string $project): void diff --git a/Compute/samples/V1/BackendServicesClient/update.php b/Compute/samples/V1/BackendServicesClient/update.php index e10b842dda0d..c10b160ae7f8 100644 --- a/Compute/samples/V1/BackendServicesClient/update.php +++ b/Compute/samples/V1/BackendServicesClient/update.php @@ -31,7 +31,9 @@ use Google\Rpc\Status; /** - * Updates the specified BackendService resource with the data included in the request. For more information, see Backend services overview. + * Updates the specified BackendService resource with the data included in the + * request. For more information, seeBackend + * services overview. * * @param string $backendService Name of the BackendService resource to update. * @param string $project Project ID for this request. diff --git a/Compute/samples/V1/CrossSiteNetworksClient/delete.php b/Compute/samples/V1/CrossSiteNetworksClient/delete.php new file mode 100644 index 000000000000..8b2abe9d3076 --- /dev/null +++ b/Compute/samples/V1/CrossSiteNetworksClient/delete.php @@ -0,0 +1,82 @@ +setCrossSiteNetwork($crossSiteNetwork) + ->setProject($project); + + // Call the API and handle any network failures. + try { + /** @var OperationResponse $response */ + $response = $crossSiteNetworksClient->delete($request); + $response->pollUntilComplete(); + + if ($response->operationSucceeded()) { + printf('Operation completed successfully.' . PHP_EOL); + } else { + /** @var Status $error */ + $error = $response->getError(); + printf('Operation failed with error data: %s' . PHP_EOL, $error->serializeToJsonString()); + } + } catch (ApiException $ex) { + printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage()); + } +} + +/** + * Helper to execute the sample. + * + * This sample has been automatically generated and should be regarded as a code + * template only. It will require modifications to work: + * - It may require correct/in-range values for request initialization. + * - It may require specifying regional endpoints when creating the service client, + * please see the apiEndpoint client configuration option for more details. + */ +function callSample(): void +{ + $crossSiteNetwork = '[CROSS_SITE_NETWORK]'; + $project = '[PROJECT]'; + + delete_sample($crossSiteNetwork, $project); +} +// [END compute_v1_generated_CrossSiteNetworks_Delete_sync] diff --git a/Compute/samples/V1/CrossSiteNetworksClient/get.php b/Compute/samples/V1/CrossSiteNetworksClient/get.php new file mode 100644 index 000000000000..a16ee650f6a9 --- /dev/null +++ b/Compute/samples/V1/CrossSiteNetworksClient/get.php @@ -0,0 +1,73 @@ +setCrossSiteNetwork($crossSiteNetwork) + ->setProject($project); + + // Call the API and handle any network failures. + try { + /** @var CrossSiteNetwork $response */ + $response = $crossSiteNetworksClient->get($request); + printf('Response data: %s' . PHP_EOL, $response->serializeToJsonString()); + } catch (ApiException $ex) { + printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage()); + } +} + +/** + * Helper to execute the sample. + * + * This sample has been automatically generated and should be regarded as a code + * template only. It will require modifications to work: + * - It may require correct/in-range values for request initialization. + * - It may require specifying regional endpoints when creating the service client, + * please see the apiEndpoint client configuration option for more details. + */ +function callSample(): void +{ + $crossSiteNetwork = '[CROSS_SITE_NETWORK]'; + $project = '[PROJECT]'; + + get_sample($crossSiteNetwork, $project); +} +// [END compute_v1_generated_CrossSiteNetworks_Get_sync] diff --git a/Compute/samples/V1/CrossSiteNetworksClient/insert.php b/Compute/samples/V1/CrossSiteNetworksClient/insert.php new file mode 100644 index 000000000000..e6823b26039e --- /dev/null +++ b/Compute/samples/V1/CrossSiteNetworksClient/insert.php @@ -0,0 +1,83 @@ +setCrossSiteNetworkResource($crossSiteNetworkResource) + ->setProject($project); + + // Call the API and handle any network failures. + try { + /** @var OperationResponse $response */ + $response = $crossSiteNetworksClient->insert($request); + $response->pollUntilComplete(); + + if ($response->operationSucceeded()) { + printf('Operation completed successfully.' . PHP_EOL); + } else { + /** @var Status $error */ + $error = $response->getError(); + printf('Operation failed with error data: %s' . PHP_EOL, $error->serializeToJsonString()); + } + } catch (ApiException $ex) { + printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage()); + } +} + +/** + * Helper to execute the sample. + * + * This sample has been automatically generated and should be regarded as a code + * template only. It will require modifications to work: + * - It may require correct/in-range values for request initialization. + * - It may require specifying regional endpoints when creating the service client, + * please see the apiEndpoint client configuration option for more details. + */ +function callSample(): void +{ + $project = '[PROJECT]'; + + insert_sample($project); +} +// [END compute_v1_generated_CrossSiteNetworks_Insert_sync] diff --git a/Compute/samples/V1/CrossSiteNetworksClient/list.php b/Compute/samples/V1/CrossSiteNetworksClient/list.php new file mode 100644 index 000000000000..b386b8935e06 --- /dev/null +++ b/Compute/samples/V1/CrossSiteNetworksClient/list.php @@ -0,0 +1,73 @@ +setProject($project); + + // Call the API and handle any network failures. + try { + /** @var PagedListResponse $response */ + $response = $crossSiteNetworksClient->list($request); + + foreach ($response as $element) { + printf('Element data: %s' . PHP_EOL, $element->serializeToJsonString()); + } + } catch (ApiException $ex) { + printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage()); + } +} + +/** + * Helper to execute the sample. + * + * This sample has been automatically generated and should be regarded as a code + * template only. It will require modifications to work: + * - It may require correct/in-range values for request initialization. + * - It may require specifying regional endpoints when creating the service client, + * please see the apiEndpoint client configuration option for more details. + */ +function callSample(): void +{ + $project = '[PROJECT]'; + + list_sample($project); +} +// [END compute_v1_generated_CrossSiteNetworks_List_sync] diff --git a/Compute/samples/V1/CrossSiteNetworksClient/patch.php b/Compute/samples/V1/CrossSiteNetworksClient/patch.php new file mode 100644 index 000000000000..0db2a37ca2b6 --- /dev/null +++ b/Compute/samples/V1/CrossSiteNetworksClient/patch.php @@ -0,0 +1,88 @@ +setCrossSiteNetwork($crossSiteNetwork) + ->setCrossSiteNetworkResource($crossSiteNetworkResource) + ->setProject($project); + + // Call the API and handle any network failures. + try { + /** @var OperationResponse $response */ + $response = $crossSiteNetworksClient->patch($request); + $response->pollUntilComplete(); + + if ($response->operationSucceeded()) { + printf('Operation completed successfully.' . PHP_EOL); + } else { + /** @var Status $error */ + $error = $response->getError(); + printf('Operation failed with error data: %s' . PHP_EOL, $error->serializeToJsonString()); + } + } catch (ApiException $ex) { + printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage()); + } +} + +/** + * Helper to execute the sample. + * + * This sample has been automatically generated and should be regarded as a code + * template only. It will require modifications to work: + * - It may require correct/in-range values for request initialization. + * - It may require specifying regional endpoints when creating the service client, + * please see the apiEndpoint client configuration option for more details. + */ +function callSample(): void +{ + $crossSiteNetwork = '[CROSS_SITE_NETWORK]'; + $project = '[PROJECT]'; + + patch_sample($crossSiteNetwork, $project); +} +// [END compute_v1_generated_CrossSiteNetworks_Patch_sync] diff --git a/Compute/samples/V1/DiskTypesClient/aggregated_list.php b/Compute/samples/V1/DiskTypesClient/aggregated_list.php index e2b2af2fc2cb..22ce27649808 100644 --- a/Compute/samples/V1/DiskTypesClient/aggregated_list.php +++ b/Compute/samples/V1/DiskTypesClient/aggregated_list.php @@ -29,7 +29,10 @@ use Google\Cloud\Compute\V1\Client\DiskTypesClient; /** - * Retrieves an aggregated list of disk types. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. + * Retrieves an aggregated list of disk types. + * + * To prevent failure, it is recommended that you set the + * `returnPartialSuccess` parameter to `true`. * * @param string $project Project ID for this request. */ diff --git a/Compute/samples/V1/DiskTypesClient/list.php b/Compute/samples/V1/DiskTypesClient/list.php index 21f5c2d7ba46..6b79b1b1331d 100644 --- a/Compute/samples/V1/DiskTypesClient/list.php +++ b/Compute/samples/V1/DiskTypesClient/list.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\ListDiskTypesRequest; /** - * Retrieves a list of disk types available to the specified project. + * Retrieves a list of disk types available to the specified + * project. * * @param string $project Project ID for this request. * @param string $zone The name of the zone for this request. diff --git a/Compute/samples/V1/DisksClient/add_resource_policies.php b/Compute/samples/V1/DisksClient/add_resource_policies.php index 8d2687cf80e7..27b462c2e899 100644 --- a/Compute/samples/V1/DisksClient/add_resource_policies.php +++ b/Compute/samples/V1/DisksClient/add_resource_policies.php @@ -31,7 +31,9 @@ use Google\Rpc\Status; /** - * Adds existing resource policies to a disk. You can only add one policy which will be applied to this disk for scheduling snapshot creation. + * Adds existing resource policies to a disk. You can only add one + * policy which will be applied to this disk for scheduling snapshot + * creation. * * @param string $disk The disk name for this request. * @param string $project Project ID for this request. diff --git a/Compute/samples/V1/DisksClient/aggregated_list.php b/Compute/samples/V1/DisksClient/aggregated_list.php index 014bc72c27ba..63991f6e9a9c 100644 --- a/Compute/samples/V1/DisksClient/aggregated_list.php +++ b/Compute/samples/V1/DisksClient/aggregated_list.php @@ -29,7 +29,10 @@ use Google\Cloud\Compute\V1\Client\DisksClient; /** - * Retrieves an aggregated list of persistent disks. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. + * Retrieves an aggregated list of persistent disks. + * + * To prevent failure, it is recommended that you set the + * `returnPartialSuccess` parameter to `true`. * * @param string $project Project ID for this request. */ diff --git a/Compute/samples/V1/DisksClient/bulk_set_labels.php b/Compute/samples/V1/DisksClient/bulk_set_labels.php index 38dc25fcdcca..9cd18c4369bb 100644 --- a/Compute/samples/V1/DisksClient/bulk_set_labels.php +++ b/Compute/samples/V1/DisksClient/bulk_set_labels.php @@ -31,7 +31,8 @@ use Google\Rpc\Status; /** - * Sets the labels on many disks at once. To learn more about labels, read the Labeling Resources documentation. + * Sets the labels on many disks at once. To learn more about labels, read theLabeling + * Resources documentation. * * @param string $project Project ID for this request. * @param string $zone The name of the zone for this request. diff --git a/Compute/samples/V1/DisksClient/create_snapshot.php b/Compute/samples/V1/DisksClient/create_snapshot.php index db1a6803ed7b..b7b121d4fa0b 100644 --- a/Compute/samples/V1/DisksClient/create_snapshot.php +++ b/Compute/samples/V1/DisksClient/create_snapshot.php @@ -31,7 +31,10 @@ use Google\Rpc\Status; /** - * Creates a snapshot of a specified persistent disk. For regular snapshot creation, consider using snapshots.insert instead, as that method supports more features, such as creating snapshots in a project different from the source disk project. + * Creates a snapshot of a specified persistent disk. For regular snapshot + * creation, consider using snapshots.insert + * instead, as that method supports more features, such as creating snapshots + * in a project different from the source disk project. * * @param string $disk Name of the persistent disk to snapshot. * @param string $project Project ID for this request. diff --git a/Compute/samples/V1/DisksClient/delete.php b/Compute/samples/V1/DisksClient/delete.php index 4d24456c19c8..28e029c8fe42 100644 --- a/Compute/samples/V1/DisksClient/delete.php +++ b/Compute/samples/V1/DisksClient/delete.php @@ -30,7 +30,11 @@ use Google\Rpc\Status; /** - * Deletes the specified persistent disk. Deleting a disk removes its data permanently and is irreversible. However, deleting a disk does not delete any snapshots previously made from the disk. You must separately delete snapshots. + * Deletes the specified persistent disk. Deleting a disk removes its data + * permanently and is irreversible. However, deleting a disk does not + * delete any snapshots + * previously made from the disk. You must separatelydelete + * snapshots. * * @param string $disk Name of the persistent disk to delete. * @param string $project Project ID for this request. diff --git a/Compute/samples/V1/DisksClient/get_iam_policy.php b/Compute/samples/V1/DisksClient/get_iam_policy.php index d4b92e93db63..31d4a9652bf3 100644 --- a/Compute/samples/V1/DisksClient/get_iam_policy.php +++ b/Compute/samples/V1/DisksClient/get_iam_policy.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\Policy; /** - * Gets the access control policy for a resource. May be empty if no such policy or resource exists. + * Gets the access control policy for a resource. May be empty if no such + * policy or resource exists. * * @param string $project Project ID for this request. * @param string $resource Name or id of the resource for this request. diff --git a/Compute/samples/V1/DisksClient/insert.php b/Compute/samples/V1/DisksClient/insert.php index 810b4cda4789..78077e92b0eb 100644 --- a/Compute/samples/V1/DisksClient/insert.php +++ b/Compute/samples/V1/DisksClient/insert.php @@ -31,7 +31,11 @@ use Google\Rpc\Status; /** - * Creates a persistent disk in the specified project using the data in the request. You can create a disk from a source (sourceImage, sourceSnapshot, or sourceDisk) or create an empty 500 GB data disk by omitting all properties. You can also create a disk that is larger than the default size by specifying the sizeGb property. + * Creates a persistent disk in the specified project using the data + * in the request. You can create a disk from a source + * (sourceImage, sourceSnapshot, orsourceDisk) or create an empty 500 GB data disk by + * omitting all properties. You can also create a disk that is larger than + * the default size by specifying the sizeGb property. * * @param string $project Project ID for this request. * @param string $zone The name of the zone for this request. diff --git a/Compute/samples/V1/DisksClient/list.php b/Compute/samples/V1/DisksClient/list.php index 4ffce2a6a4b5..5d12b17d4291 100644 --- a/Compute/samples/V1/DisksClient/list.php +++ b/Compute/samples/V1/DisksClient/list.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\ListDisksRequest; /** - * Retrieves a list of persistent disks contained within the specified zone. + * Retrieves a list of persistent disks contained within + * the specified zone. * * @param string $project Project ID for this request. * @param string $zone The name of the zone for this request. diff --git a/Compute/samples/V1/DisksClient/resize.php b/Compute/samples/V1/DisksClient/resize.php index 5a087701b821..63055d590ce7 100644 --- a/Compute/samples/V1/DisksClient/resize.php +++ b/Compute/samples/V1/DisksClient/resize.php @@ -31,7 +31,8 @@ use Google\Rpc\Status; /** - * Resizes the specified persistent disk. You can only increase the size of the disk. + * Resizes the specified persistent disk. + * You can only increase the size of the disk. * * @param string $disk The name of the persistent disk. * @param string $project Project ID for this request. diff --git a/Compute/samples/V1/DisksClient/set_iam_policy.php b/Compute/samples/V1/DisksClient/set_iam_policy.php index 3a7088cd2c81..e567dae7270e 100644 --- a/Compute/samples/V1/DisksClient/set_iam_policy.php +++ b/Compute/samples/V1/DisksClient/set_iam_policy.php @@ -30,7 +30,8 @@ use Google\Cloud\Compute\V1\ZoneSetPolicyRequest; /** - * Sets the access control policy on the specified resource. Replaces any existing policy. + * Sets the access control policy on the specified resource. + * Replaces any existing policy. * * @param string $project Project ID for this request. * @param string $resource Name or id of the resource for this request. diff --git a/Compute/samples/V1/DisksClient/set_labels.php b/Compute/samples/V1/DisksClient/set_labels.php index 889d7652a58c..5e13fc9c95a8 100644 --- a/Compute/samples/V1/DisksClient/set_labels.php +++ b/Compute/samples/V1/DisksClient/set_labels.php @@ -31,7 +31,8 @@ use Google\Rpc\Status; /** - * Sets the labels on a disk. To learn more about labels, read the Labeling Resources documentation. + * Sets the labels on a disk. To learn more about labels, read theLabeling + * Resources documentation. * * @param string $project Project ID for this request. * @param string $resource Name or id of the resource for this request. diff --git a/Compute/samples/V1/DisksClient/start_async_replication.php b/Compute/samples/V1/DisksClient/start_async_replication.php index 9ce938a2c2cc..c2039cd26a05 100644 --- a/Compute/samples/V1/DisksClient/start_async_replication.php +++ b/Compute/samples/V1/DisksClient/start_async_replication.php @@ -31,7 +31,8 @@ use Google\Rpc\Status; /** - * Starts asynchronous replication. Must be invoked on the primary disk. + * Starts asynchronous replication. + * Must be invoked on the primary disk. * * @param string $disk The name of the persistent disk. * @param string $project Project ID for this request. diff --git a/Compute/samples/V1/DisksClient/stop_async_replication.php b/Compute/samples/V1/DisksClient/stop_async_replication.php index 2b4c5a5108c8..130a7ae6c9a9 100644 --- a/Compute/samples/V1/DisksClient/stop_async_replication.php +++ b/Compute/samples/V1/DisksClient/stop_async_replication.php @@ -30,7 +30,8 @@ use Google\Rpc\Status; /** - * Stops asynchronous replication. Can be invoked either on the primary or on the secondary disk. + * Stops asynchronous replication. + * Can be invoked either on the primary or on the secondary disk. * * @param string $disk The name of the persistent disk. * @param string $project Project ID for this request. diff --git a/Compute/samples/V1/DisksClient/stop_group_async_replication.php b/Compute/samples/V1/DisksClient/stop_group_async_replication.php index 8678b05cac6f..216fac872a89 100644 --- a/Compute/samples/V1/DisksClient/stop_group_async_replication.php +++ b/Compute/samples/V1/DisksClient/stop_group_async_replication.php @@ -31,10 +31,12 @@ use Google\Rpc\Status; /** - * Stops asynchronous replication for a consistency group of disks. Can be invoked either in the primary or secondary scope. + * Stops asynchronous replication for a consistency group of disks. + * Can be invoked either in the primary or secondary scope. * * @param string $project Project ID for this request. - * @param string $zone The name of the zone for this request. This must be the zone of the primary or secondary disks in the consistency group. + * @param string $zone The name of the zone for this request. This must be the zone of the primary + * or secondary disks in the consistency group. */ function stop_group_async_replication_sample(string $project, string $zone): void { diff --git a/Compute/samples/V1/DisksClient/update.php b/Compute/samples/V1/DisksClient/update.php index 9241102caadb..c3643385a9c9 100644 --- a/Compute/samples/V1/DisksClient/update.php +++ b/Compute/samples/V1/DisksClient/update.php @@ -31,7 +31,9 @@ use Google\Rpc\Status; /** - * Updates the specified disk with the data included in the request. The update is performed only on selected fields included as part of update-mask. Only the following fields can be modified: user_license. + * Updates the specified disk with the data included in the request. + * The update is performed only on selected fields included as part + * of update-mask. Only the following fields can be modified: user_license. * * @param string $disk The disk name for this request. * @param string $project Project ID for this request. diff --git a/Compute/samples/V1/ExternalVpnGatewaysClient/get.php b/Compute/samples/V1/ExternalVpnGatewaysClient/get.php index 1aa1dd7ed782..133a3bd1f928 100644 --- a/Compute/samples/V1/ExternalVpnGatewaysClient/get.php +++ b/Compute/samples/V1/ExternalVpnGatewaysClient/get.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\GetExternalVpnGatewayRequest; /** - * Returns the specified externalVpnGateway. Get a list of available externalVpnGateways by making a list() request. + * Returns the specified externalVpnGateway. Get a list of available + * externalVpnGateways by making a list() request. * * @param string $externalVpnGateway Name of the externalVpnGateway to return. * @param string $project Project ID for this request. diff --git a/Compute/samples/V1/ExternalVpnGatewaysClient/insert.php b/Compute/samples/V1/ExternalVpnGatewaysClient/insert.php index a932503055d7..f828871b1f74 100644 --- a/Compute/samples/V1/ExternalVpnGatewaysClient/insert.php +++ b/Compute/samples/V1/ExternalVpnGatewaysClient/insert.php @@ -31,7 +31,8 @@ use Google\Rpc\Status; /** - * Creates a ExternalVpnGateway in the specified project using the data included in the request. + * Creates a ExternalVpnGateway in the specified project using + * the data included in the request. * * @param string $project Project ID for this request. */ diff --git a/Compute/samples/V1/ExternalVpnGatewaysClient/list.php b/Compute/samples/V1/ExternalVpnGatewaysClient/list.php index e79bd8713e6e..26a6548410d5 100644 --- a/Compute/samples/V1/ExternalVpnGatewaysClient/list.php +++ b/Compute/samples/V1/ExternalVpnGatewaysClient/list.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\ListExternalVpnGatewaysRequest; /** - * Retrieves the list of ExternalVpnGateway available to the specified project. + * Retrieves the list of ExternalVpnGateway available to the specified + * project. * * @param string $project Project ID for this request. */ diff --git a/Compute/samples/V1/ExternalVpnGatewaysClient/set_labels.php b/Compute/samples/V1/ExternalVpnGatewaysClient/set_labels.php index b2bd1832c773..17b6aa902e95 100644 --- a/Compute/samples/V1/ExternalVpnGatewaysClient/set_labels.php +++ b/Compute/samples/V1/ExternalVpnGatewaysClient/set_labels.php @@ -31,7 +31,9 @@ use Google\Rpc\Status; /** - * Sets the labels on an ExternalVpnGateway. To learn more about labels, read the Labeling Resources documentation. + * Sets the labels on an ExternalVpnGateway. To learn more about labels, + * read the Labeling + * Resources documentation. * * @param string $project Project ID for this request. * @param string $resource Name or id of the resource for this request. diff --git a/Compute/samples/V1/FirewallPoliciesClient/get_iam_policy.php b/Compute/samples/V1/FirewallPoliciesClient/get_iam_policy.php index dfc7c5ef51f8..6dab37943cd5 100644 --- a/Compute/samples/V1/FirewallPoliciesClient/get_iam_policy.php +++ b/Compute/samples/V1/FirewallPoliciesClient/get_iam_policy.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\Policy; /** - * Gets the access control policy for a resource. May be empty if no such policy or resource exists. + * Gets the access control policy for a resource. May be empty if no such + * policy or resource exists. * * @param string $resource Name or id of the resource for this request. */ diff --git a/Compute/samples/V1/FirewallPoliciesClient/insert.php b/Compute/samples/V1/FirewallPoliciesClient/insert.php index d14b30918719..5a47254bf762 100644 --- a/Compute/samples/V1/FirewallPoliciesClient/insert.php +++ b/Compute/samples/V1/FirewallPoliciesClient/insert.php @@ -31,9 +31,12 @@ use Google\Rpc\Status; /** - * Creates a new policy in the specified project using the data included in the request. + * Creates a new policy in the specified project using the data included in + * the request. * - * @param string $parentId Parent ID for this request. The ID can be either be "folders/[FOLDER_ID]" if the parent is a folder or "organizations/[ORGANIZATION_ID]" if the parent is an organization. + * @param string $parentId Parent ID for this request. The ID can be either be "folders/[FOLDER_ID]" + * if the parent is a folder or "organizations/[ORGANIZATION_ID]" if the + * parent is an organization. */ function insert_sample(string $parentId): void { diff --git a/Compute/samples/V1/FirewallPoliciesClient/list.php b/Compute/samples/V1/FirewallPoliciesClient/list.php index ff0507eba88b..7f4023efeccc 100644 --- a/Compute/samples/V1/FirewallPoliciesClient/list.php +++ b/Compute/samples/V1/FirewallPoliciesClient/list.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\ListFirewallPoliciesRequest; /** - * Lists all the policies that have been configured for the specified folder or organization. + * Lists all the policies that have been configured for the specified + * folder or organization. * * This sample has been automatically generated and should be regarded as a code * template only. It will require modifications to work: diff --git a/Compute/samples/V1/FirewallPoliciesClient/move.php b/Compute/samples/V1/FirewallPoliciesClient/move.php index 44ad21cecac6..a0b68466960e 100644 --- a/Compute/samples/V1/FirewallPoliciesClient/move.php +++ b/Compute/samples/V1/FirewallPoliciesClient/move.php @@ -33,7 +33,9 @@ * Moves the specified firewall policy. * * @param string $firewallPolicy Name of the firewall policy to update. - * @param string $parentId The new parent of the firewall policy. The ID can be either be "folders/[FOLDER_ID]" if the parent is a folder or "organizations/[ORGANIZATION_ID]" if the parent is an organization. + * @param string $parentId The new parent of the firewall policy. The ID can be either be + * "folders/[FOLDER_ID]" if the parent is a folder or + * "organizations/[ORGANIZATION_ID]" if the parent is an organization. */ function move_sample(string $firewallPolicy, string $parentId): void { diff --git a/Compute/samples/V1/FirewallPoliciesClient/set_iam_policy.php b/Compute/samples/V1/FirewallPoliciesClient/set_iam_policy.php index 70d176f8e10e..1a7927b330a8 100644 --- a/Compute/samples/V1/FirewallPoliciesClient/set_iam_policy.php +++ b/Compute/samples/V1/FirewallPoliciesClient/set_iam_policy.php @@ -30,7 +30,8 @@ use Google\Cloud\Compute\V1\SetIamPolicyFirewallPolicyRequest; /** - * Sets the access control policy on the specified resource. Replaces any existing policy. + * Sets the access control policy on the specified resource. + * Replaces any existing policy. * * @param string $resource Name or id of the resource for this request. */ diff --git a/Compute/samples/V1/FirewallsClient/insert.php b/Compute/samples/V1/FirewallsClient/insert.php index 5fe69e4247c2..d8c8cfec2da4 100644 --- a/Compute/samples/V1/FirewallsClient/insert.php +++ b/Compute/samples/V1/FirewallsClient/insert.php @@ -31,7 +31,8 @@ use Google\Rpc\Status; /** - * Creates a firewall rule in the specified project using the data included in the request. + * Creates a firewall rule in the specified project using the data + * included in the request. * * @param string $project Project ID for this request. */ diff --git a/Compute/samples/V1/FirewallsClient/list.php b/Compute/samples/V1/FirewallsClient/list.php index 7321c90e5dde..12b661cbebe3 100644 --- a/Compute/samples/V1/FirewallsClient/list.php +++ b/Compute/samples/V1/FirewallsClient/list.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\ListFirewallsRequest; /** - * Retrieves the list of firewall rules available to the specified project. + * Retrieves the list of firewall rules available to the specified + * project. * * @param string $project Project ID for this request. */ diff --git a/Compute/samples/V1/FirewallsClient/patch.php b/Compute/samples/V1/FirewallsClient/patch.php index 410e71e9dd66..c2a1662630b7 100644 --- a/Compute/samples/V1/FirewallsClient/patch.php +++ b/Compute/samples/V1/FirewallsClient/patch.php @@ -31,7 +31,10 @@ use Google\Rpc\Status; /** - * Updates the specified firewall rule with the data included in the request. This method supports PATCH semantics and uses the JSON merge patch format and processing rules. + * Updates the specified firewall rule with the data included in the + * request. This method supportsPATCH + * semantics and uses theJSON merge + * patch format and processing rules. * * @param string $firewall Name of the firewall rule to patch. * @param string $project Project ID for this request. diff --git a/Compute/samples/V1/FirewallsClient/test_iam_permissions.php b/Compute/samples/V1/FirewallsClient/test_iam_permissions.php new file mode 100644 index 000000000000..ab475b8a831c --- /dev/null +++ b/Compute/samples/V1/FirewallsClient/test_iam_permissions.php @@ -0,0 +1,76 @@ +setProject($project) + ->setResource($resource) + ->setTestPermissionsRequestResource($testPermissionsRequestResource); + + // Call the API and handle any network failures. + try { + /** @var TestPermissionsResponse $response */ + $response = $firewallsClient->testIamPermissions($request); + printf('Response data: %s' . PHP_EOL, $response->serializeToJsonString()); + } catch (ApiException $ex) { + printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage()); + } +} + +/** + * Helper to execute the sample. + * + * This sample has been automatically generated and should be regarded as a code + * template only. It will require modifications to work: + * - It may require correct/in-range values for request initialization. + * - It may require specifying regional endpoints when creating the service client, + * please see the apiEndpoint client configuration option for more details. + */ +function callSample(): void +{ + $project = '[PROJECT]'; + $resource = '[RESOURCE]'; + + test_iam_permissions_sample($project, $resource); +} +// [END compute_v1_generated_Firewalls_TestIamPermissions_sync] diff --git a/Compute/samples/V1/FirewallsClient/update.php b/Compute/samples/V1/FirewallsClient/update.php index bca645f4b3d7..64d5bec0567b 100644 --- a/Compute/samples/V1/FirewallsClient/update.php +++ b/Compute/samples/V1/FirewallsClient/update.php @@ -31,7 +31,10 @@ use Google\Rpc\Status; /** - * Updates the specified firewall rule with the data included in the request. Note that all fields will be updated if using PUT, even fields that are not specified. To update individual fields, please use PATCH instead. + * Updates the specified firewall rule with the data included in the + * request. + * Note that all fields will be updated if using PUT, even fields that are not + * specified. To update individual fields, please use PATCH instead. * * @param string $firewall Name of the firewall rule to update. * @param string $project Project ID for this request. diff --git a/Compute/samples/V1/ForwardingRulesClient/aggregated_list.php b/Compute/samples/V1/ForwardingRulesClient/aggregated_list.php index 50060223f5a3..be3cf23c8c83 100644 --- a/Compute/samples/V1/ForwardingRulesClient/aggregated_list.php +++ b/Compute/samples/V1/ForwardingRulesClient/aggregated_list.php @@ -29,7 +29,10 @@ use Google\Cloud\Compute\V1\Client\ForwardingRulesClient; /** - * Retrieves an aggregated list of forwarding rules. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. + * Retrieves an aggregated list of forwarding rules. + * + * To prevent failure, it is recommended that you set the + * `returnPartialSuccess` parameter to `true`. * * @param string $project Project ID for this request. */ diff --git a/Compute/samples/V1/ForwardingRulesClient/insert.php b/Compute/samples/V1/ForwardingRulesClient/insert.php index 7afe5028532d..3a8f467777d6 100644 --- a/Compute/samples/V1/ForwardingRulesClient/insert.php +++ b/Compute/samples/V1/ForwardingRulesClient/insert.php @@ -31,7 +31,8 @@ use Google\Rpc\Status; /** - * Creates a ForwardingRule resource in the specified project and region using the data included in the request. + * Creates a ForwardingRule resource in the specified project and region using + * the data included in the request. * * @param string $project Project ID for this request. * @param string $region Name of the region scoping this request. diff --git a/Compute/samples/V1/ForwardingRulesClient/list.php b/Compute/samples/V1/ForwardingRulesClient/list.php index 837771393faf..1a460be36ed1 100644 --- a/Compute/samples/V1/ForwardingRulesClient/list.php +++ b/Compute/samples/V1/ForwardingRulesClient/list.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\ListForwardingRulesRequest; /** - * Retrieves a list of ForwardingRule resources available to the specified project and region. + * Retrieves a list of ForwardingRule resources available to the specified + * project and region. * * @param string $project Project ID for this request. * @param string $region Name of the region scoping this request. diff --git a/Compute/samples/V1/ForwardingRulesClient/patch.php b/Compute/samples/V1/ForwardingRulesClient/patch.php index 44136208d3bc..b394b73218ea 100644 --- a/Compute/samples/V1/ForwardingRulesClient/patch.php +++ b/Compute/samples/V1/ForwardingRulesClient/patch.php @@ -31,7 +31,11 @@ use Google\Rpc\Status; /** - * Updates the specified forwarding rule with the data included in the request. This method supports PATCH semantics and uses the JSON merge patch format and processing rules. Currently, you can only patch the network_tier field. + * Updates the specified forwarding rule with the data included in the + * request. This method supportsPATCH + * semantics and uses theJSON merge + * patch format and processing rules. Currently, you can only + * patch the network_tier field. * * @param string $forwardingRule Name of the ForwardingRule resource to patch. * @param string $project Project ID for this request. diff --git a/Compute/samples/V1/ForwardingRulesClient/set_labels.php b/Compute/samples/V1/ForwardingRulesClient/set_labels.php index bf54123b9bd0..4be5c4f88f82 100644 --- a/Compute/samples/V1/ForwardingRulesClient/set_labels.php +++ b/Compute/samples/V1/ForwardingRulesClient/set_labels.php @@ -31,7 +31,9 @@ use Google\Rpc\Status; /** - * Sets the labels on the specified resource. To learn more about labels, read the Labeling Resources documentation. + * Sets the labels on the specified resource. To learn more about labels, + * read the + * Labeling Resources documentation. * * @param string $project Project ID for this request. * @param string $region The region for this request. diff --git a/Compute/samples/V1/ForwardingRulesClient/set_target.php b/Compute/samples/V1/ForwardingRulesClient/set_target.php index 2a4ea40cb9a0..4df7f23f4086 100644 --- a/Compute/samples/V1/ForwardingRulesClient/set_target.php +++ b/Compute/samples/V1/ForwardingRulesClient/set_target.php @@ -31,7 +31,8 @@ use Google\Rpc\Status; /** - * Changes target URL for forwarding rule. The new target should be of the same type as the old target. + * Changes target URL for forwarding rule. The new target should be of the + * same type as the old target. * * @param string $forwardingRule Name of the ForwardingRule resource in which target is to be set. * @param string $project Project ID for this request. diff --git a/Compute/samples/V1/FutureReservationsClient/aggregated_list.php b/Compute/samples/V1/FutureReservationsClient/aggregated_list.php new file mode 100644 index 000000000000..0343b653f6b0 --- /dev/null +++ b/Compute/samples/V1/FutureReservationsClient/aggregated_list.php @@ -0,0 +1,76 @@ +setProject($project); + + // Call the API and handle any network failures. + try { + /** @var PagedListResponse $response */ + $response = $futureReservationsClient->aggregatedList($request); + + foreach ($response as $element) { + printf('Element data: %s' . PHP_EOL, $element->serializeToJsonString()); + } + } catch (ApiException $ex) { + printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage()); + } +} + +/** + * Helper to execute the sample. + * + * This sample has been automatically generated and should be regarded as a code + * template only. It will require modifications to work: + * - It may require correct/in-range values for request initialization. + * - It may require specifying regional endpoints when creating the service client, + * please see the apiEndpoint client configuration option for more details. + */ +function callSample(): void +{ + $project = '[PROJECT]'; + + aggregated_list_sample($project); +} +// [END compute_v1_generated_FutureReservations_AggregatedList_sync] diff --git a/Compute/samples/V1/FutureReservationsClient/cancel.php b/Compute/samples/V1/FutureReservationsClient/cancel.php new file mode 100644 index 000000000000..9d97d9bb8b5d --- /dev/null +++ b/Compute/samples/V1/FutureReservationsClient/cancel.php @@ -0,0 +1,85 @@ +setFutureReservation($futureReservation) + ->setProject($project) + ->setZone($zone); + + // Call the API and handle any network failures. + try { + /** @var OperationResponse $response */ + $response = $futureReservationsClient->cancel($request); + $response->pollUntilComplete(); + + if ($response->operationSucceeded()) { + printf('Operation completed successfully.' . PHP_EOL); + } else { + /** @var Status $error */ + $error = $response->getError(); + printf('Operation failed with error data: %s' . PHP_EOL, $error->serializeToJsonString()); + } + } catch (ApiException $ex) { + printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage()); + } +} + +/** + * Helper to execute the sample. + * + * This sample has been automatically generated and should be regarded as a code + * template only. It will require modifications to work: + * - It may require correct/in-range values for request initialization. + * - It may require specifying regional endpoints when creating the service client, + * please see the apiEndpoint client configuration option for more details. + */ +function callSample(): void +{ + $futureReservation = '[FUTURE_RESERVATION]'; + $project = '[PROJECT]'; + $zone = '[ZONE]'; + + cancel_sample($futureReservation, $project, $zone); +} +// [END compute_v1_generated_FutureReservations_Cancel_sync] diff --git a/Compute/samples/V1/FutureReservationsClient/delete.php b/Compute/samples/V1/FutureReservationsClient/delete.php new file mode 100644 index 000000000000..24009e8e4eef --- /dev/null +++ b/Compute/samples/V1/FutureReservationsClient/delete.php @@ -0,0 +1,85 @@ +setFutureReservation($futureReservation) + ->setProject($project) + ->setZone($zone); + + // Call the API and handle any network failures. + try { + /** @var OperationResponse $response */ + $response = $futureReservationsClient->delete($request); + $response->pollUntilComplete(); + + if ($response->operationSucceeded()) { + printf('Operation completed successfully.' . PHP_EOL); + } else { + /** @var Status $error */ + $error = $response->getError(); + printf('Operation failed with error data: %s' . PHP_EOL, $error->serializeToJsonString()); + } + } catch (ApiException $ex) { + printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage()); + } +} + +/** + * Helper to execute the sample. + * + * This sample has been automatically generated and should be regarded as a code + * template only. It will require modifications to work: + * - It may require correct/in-range values for request initialization. + * - It may require specifying regional endpoints when creating the service client, + * please see the apiEndpoint client configuration option for more details. + */ +function callSample(): void +{ + $futureReservation = '[FUTURE_RESERVATION]'; + $project = '[PROJECT]'; + $zone = '[ZONE]'; + + delete_sample($futureReservation, $project, $zone); +} +// [END compute_v1_generated_FutureReservations_Delete_sync] diff --git a/Compute/samples/V1/FutureReservationsClient/get.php b/Compute/samples/V1/FutureReservationsClient/get.php new file mode 100644 index 000000000000..0715e2e6ccc8 --- /dev/null +++ b/Compute/samples/V1/FutureReservationsClient/get.php @@ -0,0 +1,76 @@ +setFutureReservation($futureReservation) + ->setProject($project) + ->setZone($zone); + + // Call the API and handle any network failures. + try { + /** @var FutureReservation $response */ + $response = $futureReservationsClient->get($request); + printf('Response data: %s' . PHP_EOL, $response->serializeToJsonString()); + } catch (ApiException $ex) { + printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage()); + } +} + +/** + * Helper to execute the sample. + * + * This sample has been automatically generated and should be regarded as a code + * template only. It will require modifications to work: + * - It may require correct/in-range values for request initialization. + * - It may require specifying regional endpoints when creating the service client, + * please see the apiEndpoint client configuration option for more details. + */ +function callSample(): void +{ + $futureReservation = '[FUTURE_RESERVATION]'; + $project = '[PROJECT]'; + $zone = '[ZONE]'; + + get_sample($futureReservation, $project, $zone); +} +// [END compute_v1_generated_FutureReservations_Get_sync] diff --git a/Compute/samples/V1/FutureReservationsClient/insert.php b/Compute/samples/V1/FutureReservationsClient/insert.php new file mode 100644 index 000000000000..26bb1f4a86a0 --- /dev/null +++ b/Compute/samples/V1/FutureReservationsClient/insert.php @@ -0,0 +1,85 @@ +setFutureReservationResource($futureReservationResource) + ->setProject($project) + ->setZone($zone); + + // Call the API and handle any network failures. + try { + /** @var OperationResponse $response */ + $response = $futureReservationsClient->insert($request); + $response->pollUntilComplete(); + + if ($response->operationSucceeded()) { + printf('Operation completed successfully.' . PHP_EOL); + } else { + /** @var Status $error */ + $error = $response->getError(); + printf('Operation failed with error data: %s' . PHP_EOL, $error->serializeToJsonString()); + } + } catch (ApiException $ex) { + printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage()); + } +} + +/** + * Helper to execute the sample. + * + * This sample has been automatically generated and should be regarded as a code + * template only. It will require modifications to work: + * - It may require correct/in-range values for request initialization. + * - It may require specifying regional endpoints when creating the service client, + * please see the apiEndpoint client configuration option for more details. + */ +function callSample(): void +{ + $project = '[PROJECT]'; + $zone = '[ZONE]'; + + insert_sample($project, $zone); +} +// [END compute_v1_generated_FutureReservations_Insert_sync] diff --git a/Compute/samples/V1/FutureReservationsClient/list.php b/Compute/samples/V1/FutureReservationsClient/list.php new file mode 100644 index 000000000000..fe56e72547b5 --- /dev/null +++ b/Compute/samples/V1/FutureReservationsClient/list.php @@ -0,0 +1,77 @@ +setProject($project) + ->setZone($zone); + + // Call the API and handle any network failures. + try { + /** @var PagedListResponse $response */ + $response = $futureReservationsClient->list($request); + + foreach ($response as $element) { + printf('Element data: %s' . PHP_EOL, $element->serializeToJsonString()); + } + } catch (ApiException $ex) { + printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage()); + } +} + +/** + * Helper to execute the sample. + * + * This sample has been automatically generated and should be regarded as a code + * template only. It will require modifications to work: + * - It may require correct/in-range values for request initialization. + * - It may require specifying regional endpoints when creating the service client, + * please see the apiEndpoint client configuration option for more details. + */ +function callSample(): void +{ + $project = '[PROJECT]'; + $zone = '[ZONE]'; + + list_sample($project, $zone); +} +// [END compute_v1_generated_FutureReservations_List_sync] diff --git a/Compute/samples/V1/FutureReservationsClient/update.php b/Compute/samples/V1/FutureReservationsClient/update.php new file mode 100644 index 000000000000..e5d895524fbd --- /dev/null +++ b/Compute/samples/V1/FutureReservationsClient/update.php @@ -0,0 +1,88 @@ +setFutureReservation($futureReservation) + ->setFutureReservationResource($futureReservationResource) + ->setProject($project) + ->setZone($zone); + + // Call the API and handle any network failures. + try { + /** @var OperationResponse $response */ + $response = $futureReservationsClient->update($request); + $response->pollUntilComplete(); + + if ($response->operationSucceeded()) { + printf('Operation completed successfully.' . PHP_EOL); + } else { + /** @var Status $error */ + $error = $response->getError(); + printf('Operation failed with error data: %s' . PHP_EOL, $error->serializeToJsonString()); + } + } catch (ApiException $ex) { + printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage()); + } +} + +/** + * Helper to execute the sample. + * + * This sample has been automatically generated and should be regarded as a code + * template only. It will require modifications to work: + * - It may require correct/in-range values for request initialization. + * - It may require specifying regional endpoints when creating the service client, + * please see the apiEndpoint client configuration option for more details. + */ +function callSample(): void +{ + $futureReservation = '[FUTURE_RESERVATION]'; + $project = '[PROJECT]'; + $zone = '[ZONE]'; + + update_sample($futureReservation, $project, $zone); +} +// [END compute_v1_generated_FutureReservations_Update_sync] diff --git a/Compute/samples/V1/GlobalAddressesClient/insert.php b/Compute/samples/V1/GlobalAddressesClient/insert.php index da94b5da66fb..ec5137e20611 100644 --- a/Compute/samples/V1/GlobalAddressesClient/insert.php +++ b/Compute/samples/V1/GlobalAddressesClient/insert.php @@ -31,7 +31,8 @@ use Google\Rpc\Status; /** - * Creates an address resource in the specified project by using the data included in the request. + * Creates an address resource in the specified project by using the data + * included in the request. * * @param string $project Project ID for this request. */ diff --git a/Compute/samples/V1/GlobalAddressesClient/set_labels.php b/Compute/samples/V1/GlobalAddressesClient/set_labels.php index 3f2b49c2a39a..f8d216858fbf 100644 --- a/Compute/samples/V1/GlobalAddressesClient/set_labels.php +++ b/Compute/samples/V1/GlobalAddressesClient/set_labels.php @@ -31,7 +31,8 @@ use Google\Rpc\Status; /** - * Sets the labels on a GlobalAddress. To learn more about labels, read the Labeling Resources documentation. + * Sets the labels on a GlobalAddress. To learn more about labels, read theLabeling + * Resources documentation. * * @param string $project Project ID for this request. * @param string $resource Name or id of the resource for this request. diff --git a/Compute/samples/V1/GlobalForwardingRulesClient/get.php b/Compute/samples/V1/GlobalForwardingRulesClient/get.php index e590ab952f6b..dd335a4c178d 100644 --- a/Compute/samples/V1/GlobalForwardingRulesClient/get.php +++ b/Compute/samples/V1/GlobalForwardingRulesClient/get.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\GetGlobalForwardingRuleRequest; /** - * Returns the specified GlobalForwardingRule resource. Gets a list of available forwarding rules by making a list() request. + * Returns the specified GlobalForwardingRule resource. Gets a list of + * available forwarding rules by making a list() request. * * @param string $forwardingRule Name of the ForwardingRule resource to return. * @param string $project Project ID for this request. diff --git a/Compute/samples/V1/GlobalForwardingRulesClient/insert.php b/Compute/samples/V1/GlobalForwardingRulesClient/insert.php index 7e6db064b562..801f1a012c57 100644 --- a/Compute/samples/V1/GlobalForwardingRulesClient/insert.php +++ b/Compute/samples/V1/GlobalForwardingRulesClient/insert.php @@ -31,7 +31,8 @@ use Google\Rpc\Status; /** - * Creates a GlobalForwardingRule resource in the specified project using the data included in the request. + * Creates a GlobalForwardingRule resource in the specified project using + * the data included in the request. * * @param string $project Project ID for this request. */ diff --git a/Compute/samples/V1/GlobalForwardingRulesClient/list.php b/Compute/samples/V1/GlobalForwardingRulesClient/list.php index 2fc816981e46..c6b5b682ee08 100644 --- a/Compute/samples/V1/GlobalForwardingRulesClient/list.php +++ b/Compute/samples/V1/GlobalForwardingRulesClient/list.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\ListGlobalForwardingRulesRequest; /** - * Retrieves a list of GlobalForwardingRule resources available to the specified project. + * Retrieves a list of GlobalForwardingRule resources available to the + * specified project. * * @param string $project Project ID for this request. */ diff --git a/Compute/samples/V1/GlobalForwardingRulesClient/patch.php b/Compute/samples/V1/GlobalForwardingRulesClient/patch.php index c7e4c5c0af26..68e4879e3ef9 100644 --- a/Compute/samples/V1/GlobalForwardingRulesClient/patch.php +++ b/Compute/samples/V1/GlobalForwardingRulesClient/patch.php @@ -31,7 +31,11 @@ use Google\Rpc\Status; /** - * Updates the specified forwarding rule with the data included in the request. This method supports PATCH semantics and uses the JSON merge patch format and processing rules. Currently, you can only patch the network_tier field. + * Updates the specified forwarding rule with the data included in the + * request. This method supportsPATCH + * semantics and uses theJSON merge + * patch format and processing rules. Currently, you can only + * patch the network_tier field. * * @param string $forwardingRule Name of the ForwardingRule resource to patch. * @param string $project Project ID for this request. diff --git a/Compute/samples/V1/GlobalForwardingRulesClient/set_labels.php b/Compute/samples/V1/GlobalForwardingRulesClient/set_labels.php index 1a3c023e7090..e0c2718c21e4 100644 --- a/Compute/samples/V1/GlobalForwardingRulesClient/set_labels.php +++ b/Compute/samples/V1/GlobalForwardingRulesClient/set_labels.php @@ -31,7 +31,9 @@ use Google\Rpc\Status; /** - * Sets the labels on the specified resource. To learn more about labels, read the Labeling resources documentation. + * Sets the labels on the specified resource. To learn more about labels, + * read the + * Labeling resources documentation. * * @param string $project Project ID for this request. * @param string $resource Name or id of the resource for this request. diff --git a/Compute/samples/V1/GlobalForwardingRulesClient/set_target.php b/Compute/samples/V1/GlobalForwardingRulesClient/set_target.php index c13e57aa8ec9..53a162d7952e 100644 --- a/Compute/samples/V1/GlobalForwardingRulesClient/set_target.php +++ b/Compute/samples/V1/GlobalForwardingRulesClient/set_target.php @@ -31,7 +31,8 @@ use Google\Rpc\Status; /** - * Changes target URL for the GlobalForwardingRule resource. The new target should be of the same type as the old target. + * Changes target URL for the GlobalForwardingRule resource. The new target + * should be of the same type as the old target. * * @param string $forwardingRule Name of the ForwardingRule resource in which target is to be set. * @param string $project Project ID for this request. diff --git a/Compute/samples/V1/GlobalNetworkEndpointGroupsClient/attach_network_endpoints.php b/Compute/samples/V1/GlobalNetworkEndpointGroupsClient/attach_network_endpoints.php index c38994335d8e..6801c03cafc5 100644 --- a/Compute/samples/V1/GlobalNetworkEndpointGroupsClient/attach_network_endpoints.php +++ b/Compute/samples/V1/GlobalNetworkEndpointGroupsClient/attach_network_endpoints.php @@ -33,7 +33,8 @@ /** * Attach a network endpoint to the specified network endpoint group. * - * @param string $networkEndpointGroup The name of the network endpoint group where you are attaching network endpoints to. It should comply with RFC1035. + * @param string $networkEndpointGroup The name of the network endpoint group where you are attaching network + * endpoints to. It should comply with RFC1035. * @param string $project Project ID for this request. */ function attach_network_endpoints_sample(string $networkEndpointGroup, string $project): void diff --git a/Compute/samples/V1/GlobalNetworkEndpointGroupsClient/delete.php b/Compute/samples/V1/GlobalNetworkEndpointGroupsClient/delete.php index 70b149630d67..95086259941b 100644 --- a/Compute/samples/V1/GlobalNetworkEndpointGroupsClient/delete.php +++ b/Compute/samples/V1/GlobalNetworkEndpointGroupsClient/delete.php @@ -30,9 +30,11 @@ use Google\Rpc\Status; /** - * Deletes the specified network endpoint group.Note that the NEG cannot be deleted if there are backend services referencing it. + * Deletes the specified network endpoint group.Note that the NEG cannot be + * deleted if there are backend services referencing it. * - * @param string $networkEndpointGroup The name of the network endpoint group to delete. It should comply with RFC1035. + * @param string $networkEndpointGroup The name of the network endpoint group to delete. It should comply with + * RFC1035. * @param string $project Project ID for this request. */ function delete_sample(string $networkEndpointGroup, string $project): void diff --git a/Compute/samples/V1/GlobalNetworkEndpointGroupsClient/detach_network_endpoints.php b/Compute/samples/V1/GlobalNetworkEndpointGroupsClient/detach_network_endpoints.php index 51dd823bc49c..a2753d6a36c7 100644 --- a/Compute/samples/V1/GlobalNetworkEndpointGroupsClient/detach_network_endpoints.php +++ b/Compute/samples/V1/GlobalNetworkEndpointGroupsClient/detach_network_endpoints.php @@ -33,7 +33,8 @@ /** * Detach the network endpoint from the specified network endpoint group. * - * @param string $networkEndpointGroup The name of the network endpoint group where you are removing network endpoints. It should comply with RFC1035. + * @param string $networkEndpointGroup The name of the network endpoint group where you are removing network + * endpoints. It should comply with RFC1035. * @param string $project Project ID for this request. */ function detach_network_endpoints_sample(string $networkEndpointGroup, string $project): void diff --git a/Compute/samples/V1/GlobalNetworkEndpointGroupsClient/insert.php b/Compute/samples/V1/GlobalNetworkEndpointGroupsClient/insert.php index 743c254a1e1e..6f409d8f061a 100644 --- a/Compute/samples/V1/GlobalNetworkEndpointGroupsClient/insert.php +++ b/Compute/samples/V1/GlobalNetworkEndpointGroupsClient/insert.php @@ -31,7 +31,8 @@ use Google\Rpc\Status; /** - * Creates a network endpoint group in the specified project using the parameters that are included in the request. + * Creates a network endpoint group in the specified project using the + * parameters that are included in the request. * * @param string $project Project ID for this request. */ diff --git a/Compute/samples/V1/GlobalNetworkEndpointGroupsClient/list.php b/Compute/samples/V1/GlobalNetworkEndpointGroupsClient/list.php index fe0e1aed8440..32b2398c9f3a 100644 --- a/Compute/samples/V1/GlobalNetworkEndpointGroupsClient/list.php +++ b/Compute/samples/V1/GlobalNetworkEndpointGroupsClient/list.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\ListGlobalNetworkEndpointGroupsRequest; /** - * Retrieves the list of network endpoint groups that are located in the specified project. + * Retrieves the list of network endpoint groups that are located in the + * specified project. * * @param string $project Project ID for this request. */ diff --git a/Compute/samples/V1/GlobalNetworkEndpointGroupsClient/list_network_endpoints.php b/Compute/samples/V1/GlobalNetworkEndpointGroupsClient/list_network_endpoints.php index 9f6518b7006f..31f969e457b3 100644 --- a/Compute/samples/V1/GlobalNetworkEndpointGroupsClient/list_network_endpoints.php +++ b/Compute/samples/V1/GlobalNetworkEndpointGroupsClient/list_network_endpoints.php @@ -31,7 +31,8 @@ /** * Lists the network endpoints in the specified network endpoint group. * - * @param string $networkEndpointGroup The name of the network endpoint group from which you want to generate a list of included network endpoints. It should comply with RFC1035. + * @param string $networkEndpointGroup The name of the network endpoint group from which you want to generate a + * list of included network endpoints. It should comply with RFC1035. * @param string $project Project ID for this request. */ function list_network_endpoints_sample(string $networkEndpointGroup, string $project): void diff --git a/Compute/samples/V1/GlobalOperationsClient/aggregated_list.php b/Compute/samples/V1/GlobalOperationsClient/aggregated_list.php index bb7e5571ebc6..6c4c2f0d07ae 100644 --- a/Compute/samples/V1/GlobalOperationsClient/aggregated_list.php +++ b/Compute/samples/V1/GlobalOperationsClient/aggregated_list.php @@ -29,7 +29,10 @@ use Google\Cloud\Compute\V1\Client\GlobalOperationsClient; /** - * Retrieves an aggregated list of all operations. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. + * Retrieves an aggregated list of all operations. + * + * To prevent failure, Google recommends that you set the + * `returnPartialSuccess` parameter to `true`. * * @param string $project Project ID for this request. */ diff --git a/Compute/samples/V1/GlobalOperationsClient/delete.php b/Compute/samples/V1/GlobalOperationsClient/delete.php index f050a90ed252..bc9ae91af64d 100644 --- a/Compute/samples/V1/GlobalOperationsClient/delete.php +++ b/Compute/samples/V1/GlobalOperationsClient/delete.php @@ -31,7 +31,8 @@ /** * Deletes the specified Operations resource. * - * @param string $operation Name of the Operations resource to delete, or its unique numeric identifier. + * @param string $operation Name of the Operations resource to delete, or its unique numeric + * identifier. * @param string $project Project ID for this request. */ function delete_sample(string $operation, string $project): void diff --git a/Compute/samples/V1/GlobalOperationsClient/get.php b/Compute/samples/V1/GlobalOperationsClient/get.php index e5457ef74ace..36f3b5fee0fe 100644 --- a/Compute/samples/V1/GlobalOperationsClient/get.php +++ b/Compute/samples/V1/GlobalOperationsClient/get.php @@ -31,7 +31,8 @@ /** * Retrieves the specified Operations resource. * - * @param string $operation Name of the Operations resource to return, or its unique numeric identifier. + * @param string $operation Name of the Operations resource to return, or its unique numeric + * identifier. * @param string $project Project ID for this request. */ function get_sample(string $operation, string $project): void diff --git a/Compute/samples/V1/GlobalOperationsClient/list.php b/Compute/samples/V1/GlobalOperationsClient/list.php index 7a9a0734d1bb..564d27c59790 100644 --- a/Compute/samples/V1/GlobalOperationsClient/list.php +++ b/Compute/samples/V1/GlobalOperationsClient/list.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\ListGlobalOperationsRequest; /** - * Retrieves a list of Operation resources contained within the specified project. + * Retrieves a list of Operation resources contained within the specified + * project. * * @param string $project Project ID for this request. */ diff --git a/Compute/samples/V1/GlobalOperationsClient/wait.php b/Compute/samples/V1/GlobalOperationsClient/wait.php index 91649b5b597b..de1aad23369d 100644 --- a/Compute/samples/V1/GlobalOperationsClient/wait.php +++ b/Compute/samples/V1/GlobalOperationsClient/wait.php @@ -29,9 +29,25 @@ use Google\Cloud\Compute\V1\WaitGlobalOperationRequest; /** - * Waits for the specified Operation resource to return as `DONE` or for the request to approach the 2 minute deadline, and retrieves the specified Operation resource. This method differs from the `GET` method in that it waits for no more than the default deadline (2 minutes) and then returns the current state of the operation, which might be `DONE` or still in progress. This method is called on a best-effort basis. Specifically: - In uncommon cases, when the server is overloaded, the request might return before the default deadline is reached, or might return after zero seconds. - If the default deadline is reached, there is no guarantee that the operation is actually done when the method returns. Be prepared to retry if the operation is not `DONE`. + * Waits for the specified Operation resource to return as `DONE` + * or for the request to approach the 2 minute deadline, and retrieves the + * specified Operation resource. This method differs from the + * `GET` method in that it waits for no more than the default + * deadline (2 minutes) and then returns the current state of the operation, + * which might be `DONE` or still in progress. * - * @param string $operation Name of the Operations resource to return, or its unique numeric identifier. + * This method is called on a best-effort basis. Specifically: + * + * + * - In uncommon cases, when the server is overloaded, the request might + * return before the default deadline is reached, or might return after zero + * seconds. + * - If the default deadline is reached, there is no guarantee that the + * operation is actually done when the method returns. Be prepared to retry + * if the operation is not `DONE`. + * + * @param string $operation Name of the Operations resource to return, or its unique numeric + * identifier. * @param string $project Project ID for this request. */ function wait_sample(string $operation, string $project): void diff --git a/Compute/samples/V1/GlobalOrganizationOperationsClient/delete.php b/Compute/samples/V1/GlobalOrganizationOperationsClient/delete.php index 5b35055f4369..f00d8bd35a92 100644 --- a/Compute/samples/V1/GlobalOrganizationOperationsClient/delete.php +++ b/Compute/samples/V1/GlobalOrganizationOperationsClient/delete.php @@ -31,7 +31,8 @@ /** * Deletes the specified Operations resource. * - * @param string $operation Name of the Operations resource to delete, or its unique numeric identifier. + * @param string $operation Name of the Operations resource to delete, or its unique numeric + * identifier. */ function delete_sample(string $operation): void { diff --git a/Compute/samples/V1/GlobalOrganizationOperationsClient/get.php b/Compute/samples/V1/GlobalOrganizationOperationsClient/get.php index fbe09bb7eb3d..389d1e859584 100644 --- a/Compute/samples/V1/GlobalOrganizationOperationsClient/get.php +++ b/Compute/samples/V1/GlobalOrganizationOperationsClient/get.php @@ -29,9 +29,11 @@ use Google\Cloud\Compute\V1\Operation; /** - * Retrieves the specified Operations resource. Gets a list of operations by making a `list()` request. + * Retrieves the specified Operations resource. Gets a list of operations + * by making a `list()` request. * - * @param string $operation Name of the Operations resource to return. Parent is derived from this field. + * @param string $operation Name of the Operations resource to return. Parent is derived from this + * field. */ function get_sample(string $operation): void { diff --git a/Compute/samples/V1/GlobalOrganizationOperationsClient/list.php b/Compute/samples/V1/GlobalOrganizationOperationsClient/list.php index 12f455c1fe0b..9e29bce5217e 100644 --- a/Compute/samples/V1/GlobalOrganizationOperationsClient/list.php +++ b/Compute/samples/V1/GlobalOrganizationOperationsClient/list.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\ListGlobalOrganizationOperationsRequest; /** - * Retrieves a list of Operation resources contained within the specified organization. + * Retrieves a list of Operation resources contained within the specified + * organization. * * This sample has been automatically generated and should be regarded as a code * template only. It will require modifications to work: diff --git a/Compute/samples/V1/GlobalPublicDelegatedPrefixesClient/insert.php b/Compute/samples/V1/GlobalPublicDelegatedPrefixesClient/insert.php index f71db89998f2..9b89dce1850e 100644 --- a/Compute/samples/V1/GlobalPublicDelegatedPrefixesClient/insert.php +++ b/Compute/samples/V1/GlobalPublicDelegatedPrefixesClient/insert.php @@ -31,7 +31,8 @@ use Google\Rpc\Status; /** - * Creates a global PublicDelegatedPrefix in the specified project using the parameters that are included in the request. + * Creates a global PublicDelegatedPrefix in the specified project using the + * parameters that are included in the request. * * @param string $project Project ID for this request. */ diff --git a/Compute/samples/V1/GlobalPublicDelegatedPrefixesClient/patch.php b/Compute/samples/V1/GlobalPublicDelegatedPrefixesClient/patch.php index 43fbc5429a85..e26132534d10 100644 --- a/Compute/samples/V1/GlobalPublicDelegatedPrefixesClient/patch.php +++ b/Compute/samples/V1/GlobalPublicDelegatedPrefixesClient/patch.php @@ -31,7 +31,10 @@ use Google\Rpc\Status; /** - * Patches the specified global PublicDelegatedPrefix resource with the data included in the request. This method supports PATCH semantics and uses JSON merge patch format and processing rules. + * Patches the specified global PublicDelegatedPrefix resource with the data + * included in the request. This method supportsPATCH + * semantics and usesJSON merge + * patch format and processing rules. * * @param string $project Project ID for this request. * @param string $publicDelegatedPrefix Name of the PublicDelegatedPrefix resource to patch. diff --git a/Compute/samples/V1/HealthChecksClient/aggregated_list.php b/Compute/samples/V1/HealthChecksClient/aggregated_list.php index b3bcb6b05294..4c10afdaf236 100644 --- a/Compute/samples/V1/HealthChecksClient/aggregated_list.php +++ b/Compute/samples/V1/HealthChecksClient/aggregated_list.php @@ -29,7 +29,11 @@ use Google\Cloud\Compute\V1\Client\HealthChecksClient; /** - * Retrieves the list of all HealthCheck resources, regional and global, available to the specified project. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. + * Retrieves the list of all HealthCheck resources, regional and global, + * available to the specified project. + * + * To prevent failure, Google recommends that you set the + * `returnPartialSuccess` parameter to `true`. * * @param string $project Name of the project scoping this request. */ diff --git a/Compute/samples/V1/HealthChecksClient/insert.php b/Compute/samples/V1/HealthChecksClient/insert.php index 3268073f5d30..b74ef8eda8dd 100644 --- a/Compute/samples/V1/HealthChecksClient/insert.php +++ b/Compute/samples/V1/HealthChecksClient/insert.php @@ -31,7 +31,8 @@ use Google\Rpc\Status; /** - * Creates a HealthCheck resource in the specified project using the data included in the request. + * Creates a HealthCheck resource in the specified project using the data + * included in the request. * * @param string $project Project ID for this request. */ diff --git a/Compute/samples/V1/HealthChecksClient/list.php b/Compute/samples/V1/HealthChecksClient/list.php index 2ea43b6cafb4..a06316c2b145 100644 --- a/Compute/samples/V1/HealthChecksClient/list.php +++ b/Compute/samples/V1/HealthChecksClient/list.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\ListHealthChecksRequest; /** - * Retrieves the list of HealthCheck resources available to the specified project. + * Retrieves the list of HealthCheck resources available to the specified + * project. * * @param string $project Project ID for this request. */ diff --git a/Compute/samples/V1/HealthChecksClient/patch.php b/Compute/samples/V1/HealthChecksClient/patch.php index f69c8ea66958..304e61fb5d39 100644 --- a/Compute/samples/V1/HealthChecksClient/patch.php +++ b/Compute/samples/V1/HealthChecksClient/patch.php @@ -31,7 +31,10 @@ use Google\Rpc\Status; /** - * Updates a HealthCheck resource in the specified project using the data included in the request. This method supports PATCH semantics and uses the JSON merge patch format and processing rules. + * Updates a HealthCheck resource in the specified project using the data + * included in the request. This method supportsPATCH + * semantics and uses theJSON merge + * patch format and processing rules. * * @param string $healthCheck Name of the HealthCheck resource to patch. * @param string $project Project ID for this request. diff --git a/Compute/samples/V1/HealthChecksClient/update.php b/Compute/samples/V1/HealthChecksClient/update.php index 696241283ebd..646851f27238 100644 --- a/Compute/samples/V1/HealthChecksClient/update.php +++ b/Compute/samples/V1/HealthChecksClient/update.php @@ -31,7 +31,8 @@ use Google\Rpc\Status; /** - * Updates a HealthCheck resource in the specified project using the data included in the request. + * Updates a HealthCheck resource in the specified project using the data + * included in the request. * * @param string $healthCheck Name of the HealthCheck resource to update. * @param string $project Project ID for this request. diff --git a/Compute/samples/V1/ImageFamilyViewsClient/get.php b/Compute/samples/V1/ImageFamilyViewsClient/get.php index 1ecc28fb8c4d..f6a85a53f213 100644 --- a/Compute/samples/V1/ImageFamilyViewsClient/get.php +++ b/Compute/samples/V1/ImageFamilyViewsClient/get.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\ImageFamilyView; /** - * Returns the latest image that is part of an image family, is not deprecated and is rolled out in the specified zone. + * Returns the latest image that is part of an image family, is not + * deprecated and is rolled out in the specified zone. * * @param string $family Name of the image family to search for. * @param string $project Project ID for this request. diff --git a/Compute/samples/V1/ImagesClient/deprecate.php b/Compute/samples/V1/ImagesClient/deprecate.php index 8de1133cd862..1db9c35e4023 100644 --- a/Compute/samples/V1/ImagesClient/deprecate.php +++ b/Compute/samples/V1/ImagesClient/deprecate.php @@ -31,7 +31,9 @@ use Google\Rpc\Status; /** - * Sets the deprecation status of an image. If an empty request body is given, clears the deprecation status instead. + * Sets the deprecation status of an image. + * + * If an empty request body is given, clears the deprecation status instead. * * @param string $image Image name. * @param string $project Project ID for this request. diff --git a/Compute/samples/V1/ImagesClient/get_from_family.php b/Compute/samples/V1/ImagesClient/get_from_family.php index 836ae3086fbe..8bd6e784f370 100644 --- a/Compute/samples/V1/ImagesClient/get_from_family.php +++ b/Compute/samples/V1/ImagesClient/get_from_family.php @@ -29,10 +29,13 @@ use Google\Cloud\Compute\V1\Image; /** - * Returns the latest image that is part of an image family and is not deprecated. For more information on image families, see Public image families documentation. + * Returns the latest image that is part of an image family and is not + * deprecated. For more information on image families, seePublic + * image families documentation. * * @param string $family Name of the image family to search for. - * @param string $project The image project that the image belongs to. For example, to get a CentOS image, specify centos-cloud as the image project. + * @param string $project The image project that the image belongs to. For example, to get a CentOS + * image, specify centos-cloud as the image project. */ function get_from_family_sample(string $family, string $project): void { diff --git a/Compute/samples/V1/ImagesClient/get_iam_policy.php b/Compute/samples/V1/ImagesClient/get_iam_policy.php index d8211d42646c..bdb922bb23c8 100644 --- a/Compute/samples/V1/ImagesClient/get_iam_policy.php +++ b/Compute/samples/V1/ImagesClient/get_iam_policy.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\Policy; /** - * Gets the access control policy for a resource. May be empty if no such policy or resource exists. + * Gets the access control policy for a resource. May be empty if no such + * policy or resource exists. * * @param string $project Project ID for this request. * @param string $resource Name or id of the resource for this request. diff --git a/Compute/samples/V1/ImagesClient/insert.php b/Compute/samples/V1/ImagesClient/insert.php index 26e49a978b7d..f227dd0f2d31 100644 --- a/Compute/samples/V1/ImagesClient/insert.php +++ b/Compute/samples/V1/ImagesClient/insert.php @@ -31,7 +31,8 @@ use Google\Rpc\Status; /** - * Creates an image in the specified project using the data included in the request. + * Creates an image in the specified project using the data included + * in the request. * * @param string $project Project ID for this request. */ diff --git a/Compute/samples/V1/ImagesClient/list.php b/Compute/samples/V1/ImagesClient/list.php index 5322b4e2b3f7..4c9555333800 100644 --- a/Compute/samples/V1/ImagesClient/list.php +++ b/Compute/samples/V1/ImagesClient/list.php @@ -29,7 +29,13 @@ use Google\Cloud\Compute\V1\ListImagesRequest; /** - * Retrieves the list of custom images available to the specified project. Custom images are images you create that belong to your project. This method does not get any images that belong to other projects, including publicly-available images, like Debian 8. If you want to get a list of publicly-available images, use this method to make a request to the respective image project, such as debian-cloud or windows-cloud. + * Retrieves the list of custom images + * available to the specified project. Custom images are images you + * create that belong to your project. This method does not + * get any images that belong to other projects, including publicly-available + * images, like Debian 8. If you want to get a list of publicly-available + * images, use this method to make a request to the respective image project, + * such as debian-cloud or windows-cloud. * * @param string $project Project ID for this request. */ diff --git a/Compute/samples/V1/ImagesClient/patch.php b/Compute/samples/V1/ImagesClient/patch.php index f91bb8493b85..d20f6b45fdd6 100644 --- a/Compute/samples/V1/ImagesClient/patch.php +++ b/Compute/samples/V1/ImagesClient/patch.php @@ -31,7 +31,9 @@ use Google\Rpc\Status; /** - * Patches the specified image with the data included in the request. Only the following fields can be modified: family, description, deprecation status. + * Patches the specified image with the data included in the request. + * Only the following fields can be modified: family, description, + * deprecation status. * * @param string $image Name of the image resource to patch. * @param string $project Project ID for this request. diff --git a/Compute/samples/V1/ImagesClient/set_iam_policy.php b/Compute/samples/V1/ImagesClient/set_iam_policy.php index 6c6c5899dbaf..8ad728fbf65d 100644 --- a/Compute/samples/V1/ImagesClient/set_iam_policy.php +++ b/Compute/samples/V1/ImagesClient/set_iam_policy.php @@ -30,7 +30,8 @@ use Google\Cloud\Compute\V1\SetIamPolicyImageRequest; /** - * Sets the access control policy on the specified resource. Replaces any existing policy. + * Sets the access control policy on the specified resource. + * Replaces any existing policy. * * @param string $project Project ID for this request. * @param string $resource Name or id of the resource for this request. diff --git a/Compute/samples/V1/ImagesClient/set_labels.php b/Compute/samples/V1/ImagesClient/set_labels.php index 135dde1da21a..03e7e29c39d5 100644 --- a/Compute/samples/V1/ImagesClient/set_labels.php +++ b/Compute/samples/V1/ImagesClient/set_labels.php @@ -31,7 +31,8 @@ use Google\Rpc\Status; /** - * Sets the labels on an image. To learn more about labels, read the Labeling Resources documentation. + * Sets the labels on an image. To learn more about labels, read theLabeling + * Resources documentation. * * @param string $project Project ID for this request. * @param string $resource Name or id of the resource for this request. diff --git a/Compute/samples/V1/InstanceGroupManagerResizeRequestsClient/cancel.php b/Compute/samples/V1/InstanceGroupManagerResizeRequestsClient/cancel.php index 1d9e3eaacf04..b1e4dfc23c8c 100644 --- a/Compute/samples/V1/InstanceGroupManagerResizeRequestsClient/cancel.php +++ b/Compute/samples/V1/InstanceGroupManagerResizeRequestsClient/cancel.php @@ -30,12 +30,18 @@ use Google\Rpc\Status; /** - * Cancels the specified resize request and removes it from the queue. Cancelled resize request does no longer wait for the resources to be provisioned. Cancel is only possible for requests that are accepted in the queue. + * Cancels the specified resize request and removes it from the queue. + * Cancelled resize request does no longer wait for the resources to be + * provisioned. Cancel is only possible for requests that are accepted in the + * queue. * - * @param string $instanceGroupManager The name of the managed instance group. The name should conform to RFC1035 or be a resource ID. + * @param string $instanceGroupManager The name of the managed instance group. + * The name should conform to RFC1035 or be a resource ID. * @param string $project Project ID for this request. - * @param string $resizeRequest The name of the resize request to cancel. The name should conform to RFC1035 or be a resource ID. - * @param string $zone The name of the zone where the managed instance group is located. The name should conform to RFC1035. + * @param string $resizeRequest The name of the resize request to cancel. + * The name should conform to RFC1035 or be a resource ID. + * @param string $zone The name of thezone where the managed + * instance group is located. The name should conform to RFC1035. */ function cancel_sample( string $instanceGroupManager, diff --git a/Compute/samples/V1/InstanceGroupManagerResizeRequestsClient/delete.php b/Compute/samples/V1/InstanceGroupManagerResizeRequestsClient/delete.php index 90fd57d0b7cd..b390f12e9fff 100644 --- a/Compute/samples/V1/InstanceGroupManagerResizeRequestsClient/delete.php +++ b/Compute/samples/V1/InstanceGroupManagerResizeRequestsClient/delete.php @@ -30,12 +30,17 @@ use Google\Rpc\Status; /** - * Deletes the specified, inactive resize request. Requests that are still active cannot be deleted. Deleting request does not delete instances that were provisioned previously. + * Deletes the specified, inactive resize request. Requests that are still + * active cannot be deleted. Deleting request does not delete instances that + * were provisioned previously. * - * @param string $instanceGroupManager The name of the managed instance group. The name should conform to RFC1035 or be a resource ID. + * @param string $instanceGroupManager The name of the managed instance group. + * The name should conform to RFC1035 or be a resource ID. * @param string $project Project ID for this request. - * @param string $resizeRequest The name of the resize request to delete. The name should conform to RFC1035 or be a resource ID. - * @param string $zone The name of the zone where the managed instance group is located. The name should conform to RFC1035. + * @param string $resizeRequest The name of the resize request to delete. + * The name should conform to RFC1035 or be a resource ID. + * @param string $zone The name of thezone where the managed + * instance group is located. The name should conform to RFC1035. */ function delete_sample( string $instanceGroupManager, diff --git a/Compute/samples/V1/InstanceGroupManagerResizeRequestsClient/get.php b/Compute/samples/V1/InstanceGroupManagerResizeRequestsClient/get.php index aaef1d3a7b86..99bd515aee3a 100644 --- a/Compute/samples/V1/InstanceGroupManagerResizeRequestsClient/get.php +++ b/Compute/samples/V1/InstanceGroupManagerResizeRequestsClient/get.php @@ -31,10 +31,13 @@ /** * Returns all of the details about the specified resize request. * - * @param string $instanceGroupManager The name of the managed instance group. Name should conform to RFC1035 or be a resource ID. + * @param string $instanceGroupManager The name of the managed instance group. + * Name should conform to RFC1035 or be a resource ID. * @param string $project Project ID for this request. - * @param string $resizeRequest The name of the resize request. Name should conform to RFC1035 or be a resource ID. - * @param string $zone Name of the href="/compute/docs/regions-zones/#available">zone scoping this request. Name should conform to RFC1035. + * @param string $resizeRequest The name of the resize request. + * Name should conform to RFC1035 or be a resource ID. + * @param string $zone Name of the href="/compute/docs/regions-zones/#available">zone + * scoping this request. Name should conform to RFC1035. */ function get_sample( string $instanceGroupManager, diff --git a/Compute/samples/V1/InstanceGroupManagerResizeRequestsClient/insert.php b/Compute/samples/V1/InstanceGroupManagerResizeRequestsClient/insert.php index 8afa90b62f53..3097b5101ef7 100644 --- a/Compute/samples/V1/InstanceGroupManagerResizeRequestsClient/insert.php +++ b/Compute/samples/V1/InstanceGroupManagerResizeRequestsClient/insert.php @@ -31,11 +31,16 @@ use Google\Rpc\Status; /** - * Creates a new resize request that starts provisioning VMs immediately or queues VM creation. + * Creates a new resize request that starts provisioning VMs immediately + * or queues VM creation. * - * @param string $instanceGroupManager The name of the managed instance group to which the resize request will be added. Name should conform to RFC1035 or be a resource ID. + * @param string $instanceGroupManager The name of the managed instance group to which the resize request will + * be added. + * Name should conform to RFC1035 or be a resource ID. * @param string $project Project ID for this request. - * @param string $zone The name of the zone where the managed instance group is located and where the resize request will be created. Name should conform to RFC1035. + * @param string $zone The name of thezone where the managed + * instance group is located and where the resize request will be created. + * Name should conform to RFC1035. */ function insert_sample(string $instanceGroupManager, string $project, string $zone): void { diff --git a/Compute/samples/V1/InstanceGroupManagerResizeRequestsClient/list.php b/Compute/samples/V1/InstanceGroupManagerResizeRequestsClient/list.php index a51e47b7168d..21f43229ce98 100644 --- a/Compute/samples/V1/InstanceGroupManagerResizeRequestsClient/list.php +++ b/Compute/samples/V1/InstanceGroupManagerResizeRequestsClient/list.php @@ -29,11 +29,13 @@ use Google\Cloud\Compute\V1\ListInstanceGroupManagerResizeRequestsRequest; /** - * Retrieves a list of resize requests that are contained in the managed instance group. + * Retrieves a list of resize requests that are contained in the + * managed instance group. * * @param string $instanceGroupManager The name of the managed instance group. The name should conform to RFC1035. * @param string $project Project ID for this request. - * @param string $zone The name of the zone where the managed instance group is located. The name should conform to RFC1035. + * @param string $zone The name of thezone where the managed + * instance group is located. The name should conform to RFC1035. */ function list_sample(string $instanceGroupManager, string $project, string $zone): void { diff --git a/Compute/samples/V1/InstanceGroupManagersClient/abandon_instances.php b/Compute/samples/V1/InstanceGroupManagersClient/abandon_instances.php index e35b67df9b6d..988605d347eb 100644 --- a/Compute/samples/V1/InstanceGroupManagersClient/abandon_instances.php +++ b/Compute/samples/V1/InstanceGroupManagersClient/abandon_instances.php @@ -31,11 +31,26 @@ use Google\Rpc\Status; /** - * Flags the specified instances to be removed from the managed instance group. Abandoning an instance does not delete the instance, but it does remove the instance from any target pools that are applied by the managed instance group. This method reduces the targetSize of the managed instance group by the number of instances that you abandon. This operation is marked as DONE when the action is scheduled even if the instances have not yet been removed from the group. You must separately verify the status of the abandoning action with the listmanagedinstances method. If the group is part of a backend service that has enabled connection draining, it can take up to 60 seconds after the connection draining duration has elapsed before the VM instance is removed or deleted. You can specify a maximum of 1000 instances with this method per request. + * Flags the specified instances to be removed from the + * managed instance group. Abandoning an instance does not delete the + * instance, but it does remove the instance from any target pools that are + * applied by the managed instance group. This method reduces thetargetSize of the managed instance group by the + * number of instances that you abandon. This operation is marked asDONE when the action is scheduled even if the instances have + * not yet been removed from the group. You must separately verify the + * status of the abandoning action with thelistmanagedinstances + * method. + * + * If the group is part of a backend + * service that has enabled + * connection draining, it can take up to 60 seconds after the connection + * draining duration has elapsed before the VM instance is removed or deleted. + * + * You can specify a maximum of 1000 instances with this method per request. * * @param string $instanceGroupManager The name of the managed instance group. * @param string $project Project ID for this request. - * @param string $zone The name of the zone where the managed instance group is located. + * @param string $zone The name of thezone where the managed + * instance group is located. */ function abandon_instances_sample( string $instanceGroupManager, diff --git a/Compute/samples/V1/InstanceGroupManagersClient/aggregated_list.php b/Compute/samples/V1/InstanceGroupManagersClient/aggregated_list.php index 2777d7353c80..8e1688ff79b4 100644 --- a/Compute/samples/V1/InstanceGroupManagersClient/aggregated_list.php +++ b/Compute/samples/V1/InstanceGroupManagersClient/aggregated_list.php @@ -29,7 +29,10 @@ use Google\Cloud\Compute\V1\Client\InstanceGroupManagersClient; /** - * Retrieves the list of managed instance groups and groups them by zone. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. + * Retrieves the list of managed instance groups and groups them by zone. + * + * To prevent failure, Google recommends that you set the + * `returnPartialSuccess` parameter to `true`. * * @param string $project Project ID for this request. */ diff --git a/Compute/samples/V1/InstanceGroupManagersClient/apply_updates_to_instances.php b/Compute/samples/V1/InstanceGroupManagersClient/apply_updates_to_instances.php index 3294e4f41555..cb4dbcb5c87e 100644 --- a/Compute/samples/V1/InstanceGroupManagersClient/apply_updates_to_instances.php +++ b/Compute/samples/V1/InstanceGroupManagersClient/apply_updates_to_instances.php @@ -31,11 +31,13 @@ use Google\Rpc\Status; /** - * Applies changes to selected instances on the managed instance group. This method can be used to apply new overrides and/or new versions. + * Applies changes to selected instances on the managed instance group. + * This method can be used to apply new overrides and/or new versions. * * @param string $instanceGroupManager The name of the managed instance group, should conform to RFC1035. * @param string $project Project ID for this request. - * @param string $zone The name of the zone where the managed instance group is located. Should conform to RFC1035. + * @param string $zone The name of thezone + * where the managed instance group is located. Should conform to RFC1035. */ function apply_updates_to_instances_sample( string $instanceGroupManager, diff --git a/Compute/samples/V1/InstanceGroupManagersClient/create_instances.php b/Compute/samples/V1/InstanceGroupManagersClient/create_instances.php index 974a320b9ffe..da07f217eaa7 100644 --- a/Compute/samples/V1/InstanceGroupManagersClient/create_instances.php +++ b/Compute/samples/V1/InstanceGroupManagersClient/create_instances.php @@ -31,11 +31,17 @@ use Google\Rpc\Status; /** - * Creates instances with per-instance configurations in this managed instance group. Instances are created using the current instance template. The create instances operation is marked DONE if the createInstances request is successful. The underlying actions take additional time. You must separately verify the status of the creating or actions with the listmanagedinstances method. + * Creates instances with per-instance configurations in this managed instance + * group. Instances are created using the current instance template. Thecreate instances operation is marked DONE if thecreateInstances request is successful. The underlying actions + * take additional time. You must separately verify the status of thecreating or actions with the listmanagedinstances + * method. * - * @param string $instanceGroupManager The name of the managed instance group. It should conform to RFC1035. + * @param string $instanceGroupManager The name of the managed instance group. + * It should conform to RFC1035. * @param string $project Project ID for this request. - * @param string $zone The name of the zone where the managed instance group is located. It should conform to RFC1035. + * @param string $zone The name of thezone + * where the managed instance group is located. + * It should conform to RFC1035. */ function create_instances_sample( string $instanceGroupManager, diff --git a/Compute/samples/V1/InstanceGroupManagersClient/delete.php b/Compute/samples/V1/InstanceGroupManagersClient/delete.php index c5832e2143fa..5944ec90dfeb 100644 --- a/Compute/samples/V1/InstanceGroupManagersClient/delete.php +++ b/Compute/samples/V1/InstanceGroupManagersClient/delete.php @@ -30,11 +30,15 @@ use Google\Rpc\Status; /** - * Deletes the specified managed instance group and all of the instances in that group. Note that the instance group must not belong to a backend service. Read Deleting an instance group for more information. + * Deletes the specified managed instance group and all of the instances + * in that group. Note that the instance group must not belong to a + * backend service. Read + * Deleting an instance group for more information. * * @param string $instanceGroupManager The name of the managed instance group to delete. * @param string $project Project ID for this request. - * @param string $zone The name of the zone where the managed instance group is located. + * @param string $zone The name of thezone where the managed + * instance group is located. */ function delete_sample(string $instanceGroupManager, string $project, string $zone): void { diff --git a/Compute/samples/V1/InstanceGroupManagersClient/delete_instances.php b/Compute/samples/V1/InstanceGroupManagersClient/delete_instances.php index 90152d7238e8..f71561c9ad5d 100644 --- a/Compute/samples/V1/InstanceGroupManagersClient/delete_instances.php +++ b/Compute/samples/V1/InstanceGroupManagersClient/delete_instances.php @@ -31,11 +31,26 @@ use Google\Rpc\Status; /** - * Flags the specified instances in the managed instance group for immediate deletion. The instances are also removed from any target pools of which they were a member. This method reduces the targetSize of the managed instance group by the number of instances that you delete. This operation is marked as DONE when the action is scheduled even if the instances are still being deleted. You must separately verify the status of the deleting action with the listmanagedinstances method. If the group is part of a backend service that has enabled connection draining, it can take up to 60 seconds after the connection draining duration has elapsed before the VM instance is removed or deleted. You can specify a maximum of 1000 instances with this method per request. + * Flags the specified instances in the managed instance group for immediate + * deletion. The instances are also removed from any target + * pools of which they were a member. This method reduces thetargetSize of the managed instance group by the number of + * instances that you delete. This operation is marked as DONE + * when the action is scheduled even if the instances are still being deleted. + * You must separately verify the status of the deleting action + * with thelistmanagedinstances + * method. + * + * If the group is part of a backend + * service that has enabled + * connection draining, it can take up to 60 seconds after the connection + * draining duration has elapsed before the VM instance is removed or deleted. + * + * You can specify a maximum of 1000 instances with this method per request. * * @param string $instanceGroupManager The name of the managed instance group. * @param string $project Project ID for this request. - * @param string $zone The name of the zone where the managed instance group is located. + * @param string $zone The name of thezone where the managed + * instance group is located. */ function delete_instances_sample( string $instanceGroupManager, diff --git a/Compute/samples/V1/InstanceGroupManagersClient/delete_per_instance_configs.php b/Compute/samples/V1/InstanceGroupManagersClient/delete_per_instance_configs.php index a5e1ca5d809f..fadca0f9fd09 100644 --- a/Compute/samples/V1/InstanceGroupManagersClient/delete_per_instance_configs.php +++ b/Compute/samples/V1/InstanceGroupManagersClient/delete_per_instance_configs.php @@ -31,11 +31,16 @@ use Google\Rpc\Status; /** - * Deletes selected per-instance configurations for the managed instance group. + * Deletes selected per-instance configurations for the managed instance + * group. * - * @param string $instanceGroupManager The name of the managed instance group. It should conform to RFC1035. + * @param string $instanceGroupManager The name of the managed instance group. + * It should conform to RFC1035. * @param string $project Project ID for this request. - * @param string $zone The name of the zone where the managed instance group is located. It should conform to RFC1035. + * @param string $zone The name of thezone + * where the managed instance + * group is located. + * It should conform to RFC1035. */ function delete_per_instance_configs_sample( string $instanceGroupManager, diff --git a/Compute/samples/V1/InstanceGroupManagersClient/get.php b/Compute/samples/V1/InstanceGroupManagersClient/get.php index ca8c59b49e06..a1f325c4a9e4 100644 --- a/Compute/samples/V1/InstanceGroupManagersClient/get.php +++ b/Compute/samples/V1/InstanceGroupManagersClient/get.php @@ -33,7 +33,8 @@ * * @param string $instanceGroupManager The name of the managed instance group. * @param string $project Project ID for this request. - * @param string $zone The name of the zone where the managed instance group is located. + * @param string $zone The name of thezone where the managed + * instance group is located. */ function get_sample(string $instanceGroupManager, string $project, string $zone): void { diff --git a/Compute/samples/V1/InstanceGroupManagersClient/insert.php b/Compute/samples/V1/InstanceGroupManagersClient/insert.php index 692ff5a8e0f9..660604833ea7 100644 --- a/Compute/samples/V1/InstanceGroupManagersClient/insert.php +++ b/Compute/samples/V1/InstanceGroupManagersClient/insert.php @@ -31,10 +31,21 @@ use Google\Rpc\Status; /** - * Creates a managed instance group using the information that you specify in the request. After the group is created, instances in the group are created using the specified instance template. This operation is marked as DONE when the group is created even if the instances in the group have not yet been created. You must separately verify the status of the individual instances with the listmanagedinstances method. A managed instance group can have up to 1000 VM instances per group. Please contact Cloud Support if you need an increase in this limit. + * Creates a managed instance group using the information that you specify + * in the request. After the group is created, instances in the group are + * created using the specified instance template. + * This operation is marked as DONE when the group is created + * even if the instances in the group have not yet been created. You + * must separately verify the status of the individual instances with thelistmanagedinstances + * method. + * + * A managed instance group can have up to 1000 VM instances per group. Please + * contact Cloud Support if you need an increase in + * this limit. * * @param string $project Project ID for this request. - * @param string $zone The name of the zone where you want to create the managed instance group. + * @param string $zone The name of the zone + * where you want to create the managed instance group. */ function insert_sample(string $project, string $zone): void { diff --git a/Compute/samples/V1/InstanceGroupManagersClient/list.php b/Compute/samples/V1/InstanceGroupManagersClient/list.php index dc08d5cbaf33..38e1f81ecaff 100644 --- a/Compute/samples/V1/InstanceGroupManagersClient/list.php +++ b/Compute/samples/V1/InstanceGroupManagersClient/list.php @@ -29,10 +29,12 @@ use Google\Cloud\Compute\V1\ListInstanceGroupManagersRequest; /** - * Retrieves a list of managed instance groups that are contained within the specified project and zone. + * Retrieves a list of managed instance groups that are contained within the + * specified project and zone. * * @param string $project Project ID for this request. - * @param string $zone The name of the zone where the managed instance group is located. + * @param string $zone The name of thezone where the managed + * instance group is located. */ function list_sample(string $project, string $zone): void { diff --git a/Compute/samples/V1/InstanceGroupManagersClient/list_errors.php b/Compute/samples/V1/InstanceGroupManagersClient/list_errors.php index e915daeb716a..0be87eedb90a 100644 --- a/Compute/samples/V1/InstanceGroupManagersClient/list_errors.php +++ b/Compute/samples/V1/InstanceGroupManagersClient/list_errors.php @@ -29,11 +29,18 @@ use Google\Cloud\Compute\V1\ListErrorsInstanceGroupManagersRequest; /** - * Lists all errors thrown by actions on instances for a given managed instance group. The filter and orderBy query parameters are not supported. + * Lists all errors thrown by actions on instances for a given managed + * instance group. The filter and orderBy query + * parameters are not supported. * - * @param string $instanceGroupManager The name of the managed instance group. It must be a string that meets the requirements in RFC1035, or an unsigned long integer: must match regexp pattern: (?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?)|1-9{0,19}. + * @param string $instanceGroupManager The name of the managed instance group. + * It must be a string that meets the requirements in RFC1035, or an + * unsigned long integer: must match regexp pattern: + * (?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?)|1-9{0,19}. * @param string $project Project ID for this request. - * @param string $zone The name of the zone where the managed instance group is located. It should conform to RFC1035. + * @param string $zone The name of thezone where the managed + * instance group is located. + * It should conform to RFC1035. */ function list_errors_sample(string $instanceGroupManager, string $project, string $zone): void { diff --git a/Compute/samples/V1/InstanceGroupManagersClient/list_managed_instances.php b/Compute/samples/V1/InstanceGroupManagersClient/list_managed_instances.php index e24dd4275477..ee5343adfb33 100644 --- a/Compute/samples/V1/InstanceGroupManagersClient/list_managed_instances.php +++ b/Compute/samples/V1/InstanceGroupManagersClient/list_managed_instances.php @@ -29,11 +29,20 @@ use Google\Cloud\Compute\V1\ListManagedInstancesInstanceGroupManagersRequest; /** - * Lists all of the instances in the managed instance group. Each instance in the list has a currentAction, which indicates the action that the managed instance group is performing on the instance. For example, if the group is still creating an instance, the currentAction is CREATING. If a previous action failed, the list displays the errors for that failed action. The orderBy query parameter is not supported. The `pageToken` query parameter is supported only if the group's `listManagedInstancesResults` field is set to `PAGINATED`. + * Lists all of the instances in the managed instance group. Each instance + * in the list has a currentAction, which indicates the action + * that the managed instance group is performing on the instance. For example, + * if the group is still creating an instance, the currentAction + * is CREATING. If a previous action failed, the + * list displays the errors for that failed action. The orderBy + * query parameter is not supported. The `pageToken` query parameter is + * supported only if the group's `listManagedInstancesResults` field is set + * to `PAGINATED`. * * @param string $instanceGroupManager The name of the managed instance group. * @param string $project Project ID for this request. - * @param string $zone The name of the zone where the managed instance group is located. + * @param string $zone The name of thezone where the managed + * instance group is located. */ function list_managed_instances_sample( string $instanceGroupManager, diff --git a/Compute/samples/V1/InstanceGroupManagersClient/list_per_instance_configs.php b/Compute/samples/V1/InstanceGroupManagersClient/list_per_instance_configs.php index 948c3a5c2f42..0b516e885b16 100644 --- a/Compute/samples/V1/InstanceGroupManagersClient/list_per_instance_configs.php +++ b/Compute/samples/V1/InstanceGroupManagersClient/list_per_instance_configs.php @@ -29,11 +29,14 @@ use Google\Cloud\Compute\V1\ListPerInstanceConfigsInstanceGroupManagersRequest; /** - * Lists all of the per-instance configurations defined for the managed instance group. The orderBy query parameter is not supported. + * Lists all of the per-instance configurations defined for the managed + * instance group. The orderBy query parameter is not supported. * * @param string $instanceGroupManager The name of the managed instance group. It should conform to RFC1035. * @param string $project Project ID for this request. - * @param string $zone The name of the zone where the managed instance group is located. It should conform to RFC1035. + * @param string $zone The name of thezone + * where the managed instance group is located. + * It should conform to RFC1035. */ function list_per_instance_configs_sample( string $instanceGroupManager, diff --git a/Compute/samples/V1/InstanceGroupManagersClient/patch.php b/Compute/samples/V1/InstanceGroupManagersClient/patch.php index 51b73d066a91..67fa6bb10c18 100644 --- a/Compute/samples/V1/InstanceGroupManagersClient/patch.php +++ b/Compute/samples/V1/InstanceGroupManagersClient/patch.php @@ -31,11 +31,26 @@ use Google\Rpc\Status; /** - * Updates a managed instance group using the information that you specify in the request. This operation is marked as DONE when the group is patched even if the instances in the group are still in the process of being patched. You must separately verify the status of the individual instances with the listManagedInstances method. This method supports PATCH semantics and uses the JSON merge patch format and processing rules. If you update your group to specify a new template or instance configuration, it's possible that your intended specification for each VM in the group is different from the current state of that VM. To learn how to apply an updated configuration to the VMs in a MIG, see Updating instances in a MIG. + * Updates a managed instance group using the information that you specify + * in the request. + * This operation is marked as DONE when the group is patched + * even if the instances in the group are still in the process of being + * patched. You must separately verify the status of the individual instances + * with thelistManagedInstances + * method. This method supportsPATCH + * semantics and uses theJSON merge + * patch format and processing rules. + * + * If you update your group to specify a new template or instance + * configuration, it's possible that your intended specification for each VM + * in the group is different from the current state of that VM. To learn how + * to apply an updated configuration to the VMs in a MIG, seeUpdating instances in + * a MIG. * * @param string $instanceGroupManager The name of the instance group manager. * @param string $project Project ID for this request. - * @param string $zone The name of the zone where you want to create the managed instance group. + * @param string $zone The name of the zone where + * you want to create the managed instance group. */ function patch_sample(string $instanceGroupManager, string $project, string $zone): void { diff --git a/Compute/samples/V1/InstanceGroupManagersClient/patch_per_instance_configs.php b/Compute/samples/V1/InstanceGroupManagersClient/patch_per_instance_configs.php index bcf3fdab164a..86e7e5d8aabf 100644 --- a/Compute/samples/V1/InstanceGroupManagersClient/patch_per_instance_configs.php +++ b/Compute/samples/V1/InstanceGroupManagersClient/patch_per_instance_configs.php @@ -31,11 +31,16 @@ use Google\Rpc\Status; /** - * Inserts or patches per-instance configurations for the managed instance group. perInstanceConfig.name serves as a key used to distinguish whether to perform insert or patch. + * Inserts or patches per-instance configurations for the managed instance + * group. perInstanceConfig.name serves as a key used to + * distinguish whether to perform insert or patch. * - * @param string $instanceGroupManager The name of the managed instance group. It should conform to RFC1035. + * @param string $instanceGroupManager The name of the managed instance group. + * It should conform to RFC1035. * @param string $project Project ID for this request. - * @param string $zone The name of the zone where the managed instance group is located. It should conform to RFC1035. + * @param string $zone The name of thezone + * where the managed instance group is located. + * It should conform to RFC1035. */ function patch_per_instance_configs_sample( string $instanceGroupManager, diff --git a/Compute/samples/V1/InstanceGroupManagersClient/recreate_instances.php b/Compute/samples/V1/InstanceGroupManagersClient/recreate_instances.php index 71b345df43f8..47e75db50c5c 100644 --- a/Compute/samples/V1/InstanceGroupManagersClient/recreate_instances.php +++ b/Compute/samples/V1/InstanceGroupManagersClient/recreate_instances.php @@ -31,11 +31,24 @@ use Google\Rpc\Status; /** - * Flags the specified VM instances in the managed instance group to be immediately recreated. Each instance is recreated using the group's current configuration. This operation is marked as DONE when the flag is set even if the instances have not yet been recreated. You must separately verify the status of each instance by checking its currentAction field; for more information, see Checking the status of managed instances. If the group is part of a backend service that has enabled connection draining, it can take up to 60 seconds after the connection draining duration has elapsed before the VM instance is removed or deleted. You can specify a maximum of 1000 instances with this method per request. + * Flags the specified VM instances in the managed instance group to be + * immediately recreated. Each instance is recreated using the group's current + * configuration. This operation is marked as DONE when the flag + * is set even if the instances have not yet been recreated. You must + * separately verify the status of each instance by checking itscurrentAction field; for more information, see Checking + * the status of managed instances. + * + * If the group is part of a backend + * service that has enabled + * connection draining, it can take up to 60 seconds after the connection + * draining duration has elapsed before the VM instance is removed or deleted. + * + * You can specify a maximum of 1000 instances with this method per request. * * @param string $instanceGroupManager The name of the managed instance group. * @param string $project Project ID for this request. - * @param string $zone The name of the zone where the managed instance group is located. + * @param string $zone The name of thezone where the managed + * instance group is located. */ function recreate_instances_sample( string $instanceGroupManager, diff --git a/Compute/samples/V1/InstanceGroupManagersClient/resize.php b/Compute/samples/V1/InstanceGroupManagersClient/resize.php index bce829e5f784..3587d314a5de 100644 --- a/Compute/samples/V1/InstanceGroupManagersClient/resize.php +++ b/Compute/samples/V1/InstanceGroupManagersClient/resize.php @@ -30,12 +30,37 @@ use Google\Rpc\Status; /** - * Resizes the managed instance group. If you increase the size, the group creates new instances using the current instance template. If you decrease the size, the group deletes instances. The resize operation is marked DONE when the resize actions are scheduled even if the group has not yet added or deleted any instances. You must separately verify the status of the creating or deleting actions with the listmanagedinstances method. When resizing down, the instance group arbitrarily chooses the order in which VMs are deleted. The group takes into account some VM attributes when making the selection including: + The status of the VM instance. + The health of the VM instance. + The instance template version the VM is based on. + For regional managed instance groups, the location of the VM instance. This list is subject to change. If the group is part of a backend service that has enabled connection draining, it can take up to 60 seconds after the connection draining duration has elapsed before the VM instance is removed or deleted. + * Resizes the managed instance group. If you increase the size, the group + * creates new instances using the current instance template. If you decrease + * the size, the group deletes instances. The resize operation is markedDONE when the resize actions are scheduled even if the group + * has not yet added or deleted any instances. You must separately + * verify the status of the creating or deleting + * actions with thelistmanagedinstances + * method. + * + * When resizing down, the instance group arbitrarily chooses the order in + * which VMs are deleted. The group takes into account some VM attributes when + * making the selection including: + * + * + The status of the VM instance. + * + The health of the VM instance. + * + The instance template version the VM is based on. + * + For regional managed instance groups, the location of the VM instance. + * + * This list is subject to change. + * + * If the group is part of a backend + * service that has enabled + * connection draining, it can take up to 60 seconds after the connection + * draining duration has elapsed before the VM instance is removed or deleted. * * @param string $instanceGroupManager The name of the managed instance group. * @param string $project Project ID for this request. - * @param int $size The number of running instances that the managed instance group should maintain at any given time. The group automatically adds or removes instances to maintain the number of instances specified by this parameter. - * @param string $zone The name of the zone where the managed instance group is located. + * @param int $size The number of running instances that the managed instance group should + * maintain at any given time. The group automatically adds or removes + * instances to maintain the number of instances specified by this parameter. + * @param string $zone The name of thezone where the managed + * instance group is located. */ function resize_sample( string $instanceGroupManager, diff --git a/Compute/samples/V1/InstanceGroupManagersClient/resume_instances.php b/Compute/samples/V1/InstanceGroupManagersClient/resume_instances.php index 450cdf53a828..cfa3ca73cde0 100644 --- a/Compute/samples/V1/InstanceGroupManagersClient/resume_instances.php +++ b/Compute/samples/V1/InstanceGroupManagersClient/resume_instances.php @@ -31,11 +31,27 @@ use Google\Rpc\Status; /** - * Flags the specified instances in the managed instance group to be resumed. This method increases the targetSize and decreases the targetSuspendedSize of the managed instance group by the number of instances that you resume. The resumeInstances operation is marked DONE if the resumeInstances request is successful. The underlying actions take additional time. You must separately verify the status of the RESUMING action with the listmanagedinstances method. In this request, you can only specify instances that are suspended. For example, if an instance was previously suspended using the suspendInstances method, it can be resumed using the resumeInstances method. If a health check is attached to the managed instance group, the specified instances will be verified as healthy after they are resumed. You can specify a maximum of 1000 instances with this method per request. + * Flags the specified instances in the managed instance group to be + * resumed. This method increases thetargetSize and decreases the targetSuspendedSize + * of the managed instance group by the number of instances that you resume. + * The resumeInstances operation is marked DONE if + * the resumeInstances request is successful. The underlying + * actions take additional time. You must separately verify the status of theRESUMING action with thelistmanagedinstances + * method. + * + * In this request, you can only specify instances that are suspended. For + * example, if an instance was previously suspended using the suspendInstances + * method, it can be resumed using the resumeInstances method. + * + * If a health check is attached to the managed instance group, the specified + * instances will be verified as healthy after they are resumed. + * + * You can specify a maximum of 1000 instances with this method per request. * * @param string $instanceGroupManager The name of the managed instance group. * @param string $project Project ID for this request. - * @param string $zone The name of the zone where the managed instance group is located. + * @param string $zone The name of thezone where the managed + * instance group is located. */ function resume_instances_sample( string $instanceGroupManager, diff --git a/Compute/samples/V1/InstanceGroupManagersClient/set_instance_template.php b/Compute/samples/V1/InstanceGroupManagersClient/set_instance_template.php index 09de5a236b91..10d6dcde5db4 100644 --- a/Compute/samples/V1/InstanceGroupManagersClient/set_instance_template.php +++ b/Compute/samples/V1/InstanceGroupManagersClient/set_instance_template.php @@ -31,11 +31,14 @@ use Google\Rpc\Status; /** - * Specifies the instance template to use when creating new instances in this group. The templates for existing instances in the group do not change unless you run recreateInstances, run applyUpdatesToInstances, or set the group's updatePolicy.type to PROACTIVE. + * Specifies the instance template to use when creating new instances in this + * group. The templates for existing instances in the group do not change + * unless you run recreateInstances, runapplyUpdatesToInstances, or set the group'supdatePolicy.type to PROACTIVE. * * @param string $instanceGroupManager The name of the managed instance group. * @param string $project Project ID for this request. - * @param string $zone The name of the zone where the managed instance group is located. + * @param string $zone The name of thezone where the managed + * instance group is located. */ function set_instance_template_sample( string $instanceGroupManager, diff --git a/Compute/samples/V1/InstanceGroupManagersClient/set_target_pools.php b/Compute/samples/V1/InstanceGroupManagersClient/set_target_pools.php index c90f52d18e55..2e1cf62c7de3 100644 --- a/Compute/samples/V1/InstanceGroupManagersClient/set_target_pools.php +++ b/Compute/samples/V1/InstanceGroupManagersClient/set_target_pools.php @@ -31,11 +31,17 @@ use Google\Rpc\Status; /** - * Modifies the target pools to which all instances in this managed instance group are assigned. The target pools automatically apply to all of the instances in the managed instance group. This operation is marked DONE when you make the request even if the instances have not yet been added to their target pools. The change might take some time to apply to all of the instances in the group depending on the size of the group. + * Modifies the target pools to which all instances in this managed instance + * group are assigned. The target pools automatically apply to all of the + * instances in the managed instance group. This operation is markedDONE when you make the request even if the instances have not + * yet been added to their target pools. The change might take some time to + * apply to all of the instances in the group depending on the size of the + * group. * * @param string $instanceGroupManager The name of the managed instance group. * @param string $project Project ID for this request. - * @param string $zone The name of the zone where the managed instance group is located. + * @param string $zone The name of thezone where the managed + * instance group is located. */ function set_target_pools_sample( string $instanceGroupManager, diff --git a/Compute/samples/V1/InstanceGroupManagersClient/start_instances.php b/Compute/samples/V1/InstanceGroupManagersClient/start_instances.php index 646b7c8ff331..a9a806a32a8c 100644 --- a/Compute/samples/V1/InstanceGroupManagersClient/start_instances.php +++ b/Compute/samples/V1/InstanceGroupManagersClient/start_instances.php @@ -31,11 +31,27 @@ use Google\Rpc\Status; /** - * Flags the specified instances in the managed instance group to be started. This method increases the targetSize and decreases the targetStoppedSize of the managed instance group by the number of instances that you start. The startInstances operation is marked DONE if the startInstances request is successful. The underlying actions take additional time. You must separately verify the status of the STARTING action with the listmanagedinstances method. In this request, you can only specify instances that are stopped. For example, if an instance was previously stopped using the stopInstances method, it can be started using the startInstances method. If a health check is attached to the managed instance group, the specified instances will be verified as healthy after they are started. You can specify a maximum of 1000 instances with this method per request. + * Flags the specified instances in the managed instance group to be + * started. This method increases thetargetSize and decreases the targetStoppedSize + * of the managed instance group by the number of instances that you start. + * The startInstances operation is marked DONE if + * the startInstances request is successful. The underlying + * actions take additional time. You must separately verify the status of theSTARTING action with thelistmanagedinstances + * method. + * + * In this request, you can only specify instances that are stopped. For + * example, if an instance was previously stopped using the stopInstances + * method, it can be started using the startInstances method. + * + * If a health check is attached to the managed instance group, the specified + * instances will be verified as healthy after they are started. + * + * You can specify a maximum of 1000 instances with this method per request. * * @param string $instanceGroupManager The name of the managed instance group. * @param string $project Project ID for this request. - * @param string $zone The name of the zone where the managed instance group is located. + * @param string $zone The name of thezone where the managed + * instance group is located. */ function start_instances_sample(string $instanceGroupManager, string $project, string $zone): void { diff --git a/Compute/samples/V1/InstanceGroupManagersClient/stop_instances.php b/Compute/samples/V1/InstanceGroupManagersClient/stop_instances.php index 65d96d82547c..52a7976bcf71 100644 --- a/Compute/samples/V1/InstanceGroupManagersClient/stop_instances.php +++ b/Compute/samples/V1/InstanceGroupManagersClient/stop_instances.php @@ -31,11 +31,36 @@ use Google\Rpc\Status; /** - * Flags the specified instances in the managed instance group to be immediately stopped. You can only specify instances that are running in this request. This method reduces the targetSize and increases the targetStoppedSize of the managed instance group by the number of instances that you stop. The stopInstances operation is marked DONE if the stopInstances request is successful. The underlying actions take additional time. You must separately verify the status of the STOPPING action with the listmanagedinstances method. If the standbyPolicy.initialDelaySec field is set, the group delays stopping the instances until initialDelaySec have passed from instance.creationTimestamp (that is, when the instance was created). This delay gives your application time to set itself up and initialize on the instance. If more than initialDelaySec seconds have passed since instance.creationTimestamp when this method is called, there will be zero delay. If the group is part of a backend service that has enabled connection draining, it can take up to 60 seconds after the connection draining duration has elapsed before the VM instance is stopped. Stopped instances can be started using the startInstances method. You can specify a maximum of 1000 instances with this method per request. + * Flags the specified instances in the managed instance group to be + * immediately stopped. You can only specify instances that are running in + * this request. This method reduces thetargetSize and increases the targetStoppedSize + * of the managed instance group by the number of instances that you stop. + * The stopInstances operation is marked DONE if + * the stopInstances request is successful. The underlying + * actions take additional time. You must separately verify the status of theSTOPPING action with thelistmanagedinstances + * method. + * + * If the standbyPolicy.initialDelaySec field is set, the group + * delays stopping the instances until initialDelaySec have + * passed from instance.creationTimestamp (that is, when the + * instance was created). This delay gives your application time to + * set itself up and initialize on the instance. If more thaninitialDelaySec seconds have passed sinceinstance.creationTimestamp when this method is called, there + * will be zero delay. + * + * If the group is part of a backend + * service that has enabled + * connection draining, it can take up to 60 seconds after the connection + * draining duration has elapsed before the VM instance is stopped. + * + * Stopped instances can be started using the startInstances + * method. + * + * You can specify a maximum of 1000 instances with this method per request. * * @param string $instanceGroupManager The name of the managed instance group. * @param string $project Project ID for this request. - * @param string $zone The name of the zone where the managed instance group is located. + * @param string $zone The name of thezone where the managed + * instance group is located. */ function stop_instances_sample(string $instanceGroupManager, string $project, string $zone): void { diff --git a/Compute/samples/V1/InstanceGroupManagersClient/suspend_instances.php b/Compute/samples/V1/InstanceGroupManagersClient/suspend_instances.php index aec4e6e4b778..16b590069e95 100644 --- a/Compute/samples/V1/InstanceGroupManagersClient/suspend_instances.php +++ b/Compute/samples/V1/InstanceGroupManagersClient/suspend_instances.php @@ -31,11 +31,36 @@ use Google\Rpc\Status; /** - * Flags the specified instances in the managed instance group to be immediately suspended. You can only specify instances that are running in this request. This method reduces the targetSize and increases the targetSuspendedSize of the managed instance group by the number of instances that you suspend. The suspendInstances operation is marked DONE if the suspendInstances request is successful. The underlying actions take additional time. You must separately verify the status of the SUSPENDING action with the listmanagedinstances method. If the standbyPolicy.initialDelaySec field is set, the group delays suspension of the instances until initialDelaySec have passed from instance.creationTimestamp (that is, when the instance was created). This delay gives your application time to set itself up and initialize on the instance. If more than initialDelaySec seconds have passed since instance.creationTimestamp when this method is called, there will be zero delay. If the group is part of a backend service that has enabled connection draining, it can take up to 60 seconds after the connection draining duration has elapsed before the VM instance is suspended. Suspended instances can be resumed using the resumeInstances method. You can specify a maximum of 1000 instances with this method per request. + * Flags the specified instances in the managed instance group to be + * immediately suspended. You can only specify instances that are running in + * this request. This method reduces thetargetSize and increases the targetSuspendedSize + * of the managed instance group by the number of instances that you suspend. + * The suspendInstances operation is marked DONE if + * the suspendInstances request is successful. The underlying + * actions take additional time. You must separately verify the status of theSUSPENDING action with thelistmanagedinstances + * method. + * + * If the standbyPolicy.initialDelaySec field is set, the group + * delays suspension of the instances until initialDelaySec have + * passed from instance.creationTimestamp (that is, when the + * instance was created). This delay gives your application time to + * set itself up and initialize on the instance. If more thaninitialDelaySec seconds have passed sinceinstance.creationTimestamp when this method is called, there + * will be zero delay. + * + * If the group is part of a backend + * service that has enabled + * connection draining, it can take up to 60 seconds after the connection + * draining duration has elapsed before the VM instance is suspended. + * + * Suspended instances can be resumed using the resumeInstances + * method. + * + * You can specify a maximum of 1000 instances with this method per request. * * @param string $instanceGroupManager The name of the managed instance group. * @param string $project Project ID for this request. - * @param string $zone The name of the zone where the managed instance group is located. + * @param string $zone The name of thezone where the managed + * instance group is located. */ function suspend_instances_sample( string $instanceGroupManager, diff --git a/Compute/samples/V1/InstanceGroupManagersClient/update_per_instance_configs.php b/Compute/samples/V1/InstanceGroupManagersClient/update_per_instance_configs.php index da101b162c63..1d3cd7753e0c 100644 --- a/Compute/samples/V1/InstanceGroupManagersClient/update_per_instance_configs.php +++ b/Compute/samples/V1/InstanceGroupManagersClient/update_per_instance_configs.php @@ -31,11 +31,16 @@ use Google\Rpc\Status; /** - * Inserts or updates per-instance configurations for the managed instance group. perInstanceConfig.name serves as a key used to distinguish whether to perform insert or patch. + * Inserts or updates per-instance configurations for the managed instance + * group. perInstanceConfig.name serves as a key used to + * distinguish whether to perform insert or patch. * - * @param string $instanceGroupManager The name of the managed instance group. It should conform to RFC1035. + * @param string $instanceGroupManager The name of the managed instance group. + * It should conform to RFC1035. * @param string $project Project ID for this request. - * @param string $zone The name of the zone where the managed instance group is located. It should conform to RFC1035. + * @param string $zone The name of thezone + * where the managed instance group is located. + * It should conform to RFC1035. */ function update_per_instance_configs_sample( string $instanceGroupManager, diff --git a/Compute/samples/V1/InstanceGroupsClient/add_instances.php b/Compute/samples/V1/InstanceGroupsClient/add_instances.php index fdc458b817da..33c5069374b3 100644 --- a/Compute/samples/V1/InstanceGroupsClient/add_instances.php +++ b/Compute/samples/V1/InstanceGroupsClient/add_instances.php @@ -31,11 +31,15 @@ use Google\Rpc\Status; /** - * Adds a list of instances to the specified instance group. All of the instances in the instance group must be in the same network/subnetwork. Read Adding instances for more information. + * Adds a list of instances to the specified instance group. All of the + * instances in the instance group must be in the same network/subnetwork. + * Read + * Adding instances for more information. * * @param string $instanceGroup The name of the instance group where you are adding instances. * @param string $project Project ID for this request. - * @param string $zone The name of the zone where the instance group is located. + * @param string $zone The name of the zone + * where the instance group is located. */ function add_instances_sample(string $instanceGroup, string $project, string $zone): void { diff --git a/Compute/samples/V1/InstanceGroupsClient/aggregated_list.php b/Compute/samples/V1/InstanceGroupsClient/aggregated_list.php index decd697ad44b..1c48d6a9aa22 100644 --- a/Compute/samples/V1/InstanceGroupsClient/aggregated_list.php +++ b/Compute/samples/V1/InstanceGroupsClient/aggregated_list.php @@ -29,7 +29,10 @@ use Google\Cloud\Compute\V1\Client\InstanceGroupsClient; /** - * Retrieves the list of instance groups and sorts them by zone. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. + * Retrieves the list of instance groups and sorts them by zone. + * + * To prevent failure, Google recommends that you set the + * `returnPartialSuccess` parameter to `true`. * * @param string $project Project ID for this request. */ diff --git a/Compute/samples/V1/InstanceGroupsClient/delete.php b/Compute/samples/V1/InstanceGroupsClient/delete.php index a64f52aa298d..e87a2b527718 100644 --- a/Compute/samples/V1/InstanceGroupsClient/delete.php +++ b/Compute/samples/V1/InstanceGroupsClient/delete.php @@ -30,11 +30,15 @@ use Google\Rpc\Status; /** - * Deletes the specified instance group. The instances in the group are not deleted. Note that instance group must not belong to a backend service. Read Deleting an instance group for more information. + * Deletes the specified instance group. The instances in the group are not + * deleted. Note that instance group must not belong to a backend service. + * Read + * Deleting an instance group for more information. * * @param string $instanceGroup The name of the instance group to delete. * @param string $project Project ID for this request. - * @param string $zone The name of the zone where the instance group is located. + * @param string $zone The name of the zone + * where the instance group is located. */ function delete_sample(string $instanceGroup, string $project, string $zone): void { diff --git a/Compute/samples/V1/InstanceGroupsClient/get.php b/Compute/samples/V1/InstanceGroupsClient/get.php index 99d86356863f..c4c03eff1177 100644 --- a/Compute/samples/V1/InstanceGroupsClient/get.php +++ b/Compute/samples/V1/InstanceGroupsClient/get.php @@ -29,11 +29,17 @@ use Google\Cloud\Compute\V1\InstanceGroup; /** - * Returns the specified zonal instance group. Get a list of available zonal instance groups by making a list() request. For managed instance groups, use the instanceGroupManagers or regionInstanceGroupManagers methods instead. + * Returns the specified zonal instance group. Get a list of available zonal + * instance groups by making a list() request. + * + * For managed instance groups, use theinstanceGroupManagers + * or regionInstanceGroupManagers + * methods instead. * * @param string $instanceGroup The name of the instance group. * @param string $project Project ID for this request. - * @param string $zone The name of the zone where the instance group is located. + * @param string $zone The name of the zone + * where the instance group is located. */ function get_sample(string $instanceGroup, string $project, string $zone): void { diff --git a/Compute/samples/V1/InstanceGroupsClient/insert.php b/Compute/samples/V1/InstanceGroupsClient/insert.php index 30e887394075..8a775f3c14f0 100644 --- a/Compute/samples/V1/InstanceGroupsClient/insert.php +++ b/Compute/samples/V1/InstanceGroupsClient/insert.php @@ -31,10 +31,12 @@ use Google\Rpc\Status; /** - * Creates an instance group in the specified project using the parameters that are included in the request. + * Creates an instance group in the specified project using the + * parameters that are included in the request. * * @param string $project Project ID for this request. - * @param string $zone The name of the zone where you want to create the instance group. + * @param string $zone The name of the zone + * where you want to create the instance group. */ function insert_sample(string $project, string $zone): void { diff --git a/Compute/samples/V1/InstanceGroupsClient/list.php b/Compute/samples/V1/InstanceGroupsClient/list.php index e0eee3c2b57b..8c8e8ee1592e 100644 --- a/Compute/samples/V1/InstanceGroupsClient/list.php +++ b/Compute/samples/V1/InstanceGroupsClient/list.php @@ -29,10 +29,16 @@ use Google\Cloud\Compute\V1\ListInstanceGroupsRequest; /** - * Retrieves the list of zonal instance group resources contained within the specified zone. For managed instance groups, use the instanceGroupManagers or regionInstanceGroupManagers methods instead. + * Retrieves the list of zonal instance group resources contained within the + * specified zone. + * + * For managed instance groups, use theinstanceGroupManagers + * or regionInstanceGroupManagers + * methods instead. * * @param string $project Project ID for this request. - * @param string $zone The name of the zone where the instance group is located. + * @param string $zone The name of thezone + * where the instance group is located. */ function list_sample(string $project, string $zone): void { diff --git a/Compute/samples/V1/InstanceGroupsClient/list_instances.php b/Compute/samples/V1/InstanceGroupsClient/list_instances.php index fb636792e243..3aa1d25a454d 100644 --- a/Compute/samples/V1/InstanceGroupsClient/list_instances.php +++ b/Compute/samples/V1/InstanceGroupsClient/list_instances.php @@ -30,11 +30,16 @@ use Google\Cloud\Compute\V1\ListInstancesInstanceGroupsRequest; /** - * Lists the instances in the specified instance group. The orderBy query parameter is not supported. The filter query parameter is supported, but only for expressions that use `eq` (equal) or `ne` (not equal) operators. + * Lists the instances in the specified instance group. + * The orderBy query parameter is not supported. + * The filter query parameter is supported, but only for + * expressions that use `eq` (equal) or `ne` (not equal) operators. * - * @param string $instanceGroup The name of the instance group from which you want to generate a list of included instances. + * @param string $instanceGroup The name of the instance group from which you want to generate a list + * of included instances. * @param string $project Project ID for this request. - * @param string $zone The name of the zone where the instance group is located. + * @param string $zone The name of the zone + * where the instance group is located. */ function list_instances_sample(string $instanceGroup, string $project, string $zone): void { diff --git a/Compute/samples/V1/InstanceGroupsClient/remove_instances.php b/Compute/samples/V1/InstanceGroupsClient/remove_instances.php index b63243587c72..ee9fc480ca6c 100644 --- a/Compute/samples/V1/InstanceGroupsClient/remove_instances.php +++ b/Compute/samples/V1/InstanceGroupsClient/remove_instances.php @@ -31,11 +31,19 @@ use Google\Rpc\Status; /** - * Removes one or more instances from the specified instance group, but does not delete those instances. If the group is part of a backend service that has enabled connection draining, it can take up to 60 seconds after the connection draining duration before the VM instance is removed or deleted. + * Removes one or more instances from the specified instance group, but does + * not delete those instances. * - * @param string $instanceGroup The name of the instance group where the specified instances will be removed. + * If the group is part of a backend + * service that has enabled + * connection draining, it can take up to 60 seconds after the connection + * draining duration before the VM instance is removed or deleted. + * + * @param string $instanceGroup The name of the instance group where the specified instances will be + * removed. * @param string $project Project ID for this request. - * @param string $zone The name of the zone where the instance group is located. + * @param string $zone The name of the zone + * where the instance group is located. */ function remove_instances_sample(string $instanceGroup, string $project, string $zone): void { diff --git a/Compute/samples/V1/InstanceGroupsClient/set_named_ports.php b/Compute/samples/V1/InstanceGroupsClient/set_named_ports.php index 1151a363eb82..0473cf220d63 100644 --- a/Compute/samples/V1/InstanceGroupsClient/set_named_ports.php +++ b/Compute/samples/V1/InstanceGroupsClient/set_named_ports.php @@ -35,7 +35,8 @@ * * @param string $instanceGroup The name of the instance group where the named ports are updated. * @param string $project Project ID for this request. - * @param string $zone The name of the zone where the instance group is located. + * @param string $zone The name of the zone + * where the instance group is located. */ function set_named_ports_sample(string $instanceGroup, string $project, string $zone): void { diff --git a/Compute/samples/V1/InstanceTemplatesClient/aggregated_list.php b/Compute/samples/V1/InstanceTemplatesClient/aggregated_list.php index 39e7fc807009..4eb37255986a 100644 --- a/Compute/samples/V1/InstanceTemplatesClient/aggregated_list.php +++ b/Compute/samples/V1/InstanceTemplatesClient/aggregated_list.php @@ -29,7 +29,11 @@ use Google\Cloud\Compute\V1\Client\InstanceTemplatesClient; /** - * Retrieves the list of all InstanceTemplates resources, regional and global, available to the specified project. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. + * Retrieves the list of all InstanceTemplates resources, regional and global, + * available to the specified project. + * + * To prevent failure, Google recommends that you set the + * `returnPartialSuccess` parameter to `true`. * * @param string $project Name of the project scoping this request. */ diff --git a/Compute/samples/V1/InstanceTemplatesClient/delete.php b/Compute/samples/V1/InstanceTemplatesClient/delete.php index 31231982a6aa..e49908792e13 100644 --- a/Compute/samples/V1/InstanceTemplatesClient/delete.php +++ b/Compute/samples/V1/InstanceTemplatesClient/delete.php @@ -30,7 +30,9 @@ use Google\Rpc\Status; /** - * Deletes the specified instance template. Deleting an instance template is permanent and cannot be undone. It is not possible to delete templates that are already in use by a managed instance group. + * Deletes the specified instance template. Deleting an instance template is + * permanent and cannot be undone. It is not possible to delete templates + * that are already in use by a managed instance group. * * @param string $instanceTemplate The name of the instance template to delete. * @param string $project Project ID for this request. diff --git a/Compute/samples/V1/InstanceTemplatesClient/get_iam_policy.php b/Compute/samples/V1/InstanceTemplatesClient/get_iam_policy.php index fba2b57c4702..f4aa3655e6f7 100644 --- a/Compute/samples/V1/InstanceTemplatesClient/get_iam_policy.php +++ b/Compute/samples/V1/InstanceTemplatesClient/get_iam_policy.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\Policy; /** - * Gets the access control policy for a resource. May be empty if no such policy or resource exists. + * Gets the access control policy for a resource. May be empty if no such + * policy or resource exists. * * @param string $project Project ID for this request. * @param string $resource Name or id of the resource for this request. diff --git a/Compute/samples/V1/InstanceTemplatesClient/insert.php b/Compute/samples/V1/InstanceTemplatesClient/insert.php index e07d2a6762ad..01ebe035419f 100644 --- a/Compute/samples/V1/InstanceTemplatesClient/insert.php +++ b/Compute/samples/V1/InstanceTemplatesClient/insert.php @@ -31,7 +31,11 @@ use Google\Rpc\Status; /** - * Creates an instance template in the specified project using the data that is included in the request. If you are creating a new template to update an existing instance group, your new instance template must use the same network or, if applicable, the same subnetwork as the original template. + * Creates an instance template in the specified project using the + * data that is included in the request. If you are creating a new template to + * update an existing instance group, your new instance template must use the + * same network or, if applicable, the same subnetwork as the original + * template. * * @param string $project Project ID for this request. */ diff --git a/Compute/samples/V1/InstanceTemplatesClient/list.php b/Compute/samples/V1/InstanceTemplatesClient/list.php index 446e0c72e8db..7ba1f15c1a1c 100644 --- a/Compute/samples/V1/InstanceTemplatesClient/list.php +++ b/Compute/samples/V1/InstanceTemplatesClient/list.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\ListInstanceTemplatesRequest; /** - * Retrieves a list of instance templates that are contained within the specified project. + * Retrieves a list of instance templates that are contained within + * the specified project. * * @param string $project Project ID for this request. */ diff --git a/Compute/samples/V1/InstanceTemplatesClient/set_iam_policy.php b/Compute/samples/V1/InstanceTemplatesClient/set_iam_policy.php index 4d2adcfbf1be..78e2ed8e4b53 100644 --- a/Compute/samples/V1/InstanceTemplatesClient/set_iam_policy.php +++ b/Compute/samples/V1/InstanceTemplatesClient/set_iam_policy.php @@ -30,7 +30,8 @@ use Google\Cloud\Compute\V1\SetIamPolicyInstanceTemplateRequest; /** - * Sets the access control policy on the specified resource. Replaces any existing policy. + * Sets the access control policy on the specified resource. + * Replaces any existing policy. * * @param string $project Project ID for this request. * @param string $resource Name or id of the resource for this request. diff --git a/Compute/samples/V1/InstancesClient/add_network_interface.php b/Compute/samples/V1/InstancesClient/add_network_interface.php index 93137a532d90..7c2015852c2f 100644 --- a/Compute/samples/V1/InstancesClient/add_network_interface.php +++ b/Compute/samples/V1/InstancesClient/add_network_interface.php @@ -33,7 +33,8 @@ /** * Adds one dynamic network interface to an active instance. * - * @param string $instance The instance name for this request stored as resource_id. Name should conform to RFC1035 or be an unsigned long integer. + * @param string $instance The instance name for this request stored as resource_id. + * Name should conform to RFC1035 or be an unsigned long integer. * @param string $project Project ID for this request. * @param string $zone The name of the zone for this request. */ diff --git a/Compute/samples/V1/InstancesClient/add_resource_policies.php b/Compute/samples/V1/InstancesClient/add_resource_policies.php index b864598a9a7c..4e2207c459ea 100644 --- a/Compute/samples/V1/InstancesClient/add_resource_policies.php +++ b/Compute/samples/V1/InstancesClient/add_resource_policies.php @@ -31,7 +31,9 @@ use Google\Rpc\Status; /** - * Adds existing resource policies to an instance. You can only add one policy right now which will be applied to this instance for scheduling live migrations. + * Adds existing resource policies to an instance. You can only add one + * policy right now which will be applied to this instance for scheduling live + * migrations. * * @param string $instance The instance name for this request. * @param string $project Project ID for this request. diff --git a/Compute/samples/V1/InstancesClient/aggregated_list.php b/Compute/samples/V1/InstancesClient/aggregated_list.php index 58a0472dfc0b..936fd4b42907 100644 --- a/Compute/samples/V1/InstancesClient/aggregated_list.php +++ b/Compute/samples/V1/InstancesClient/aggregated_list.php @@ -29,7 +29,14 @@ use Google\Cloud\Compute\V1\Client\InstancesClient; /** - * Retrieves an aggregated list of all of the instances in your project across all regions and zones. The performance of this method degrades when a filter is specified on a project that has a very large number of instances. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. + * Retrieves an aggregated list of all of the instances in your project + * across all regions and zones. + * + * The performance of this method degrades when a filter is specified on a + * project that has a very large number of instances. + * + * To prevent failure, Google recommends that you set the + * `returnPartialSuccess` parameter to `true`. * * @param string $project Project ID for this request. */ diff --git a/Compute/samples/V1/InstancesClient/attach_disk.php b/Compute/samples/V1/InstancesClient/attach_disk.php index 2a97e97404b3..64f7e381d5b1 100644 --- a/Compute/samples/V1/InstancesClient/attach_disk.php +++ b/Compute/samples/V1/InstancesClient/attach_disk.php @@ -31,7 +31,10 @@ use Google\Rpc\Status; /** - * Attaches an existing Disk resource to an instance. You must first create the disk before you can attach it. It is not possible to create and attach a disk at the same time. For more information, read Adding a persistent disk to your instance. + * Attaches an existing Disk resource to an instance. You must first + * create the disk before you can attach it. It is not possible to create + * and attach a disk at the same time. For more information, readAdding a + * persistent disk to your instance. * * @param string $instance The instance name for this request. * @param string $project Project ID for this request. diff --git a/Compute/samples/V1/InstancesClient/bulk_insert.php b/Compute/samples/V1/InstancesClient/bulk_insert.php index c4f17ed6cd8c..1f940e0f2c18 100644 --- a/Compute/samples/V1/InstancesClient/bulk_insert.php +++ b/Compute/samples/V1/InstancesClient/bulk_insert.php @@ -31,7 +31,9 @@ use Google\Rpc\Status; /** - * Creates multiple instances. Count specifies the number of instances to create. For more information, see About bulk creation of VMs. + * Creates multiple instances. Count specifies the number of instances to + * create. For more information, seeAbout bulk + * creation of VMs. * * @param string $project Project ID for this request. * @param string $zone The name of the zone for this request. diff --git a/Compute/samples/V1/InstancesClient/delete.php b/Compute/samples/V1/InstancesClient/delete.php index 7b8c645cb3d2..772113010370 100644 --- a/Compute/samples/V1/InstancesClient/delete.php +++ b/Compute/samples/V1/InstancesClient/delete.php @@ -30,7 +30,8 @@ use Google\Rpc\Status; /** - * Deletes the specified Instance resource. For more information, see Deleting an instance. + * Deletes the specified Instance resource. For more information, seeDeleting + * an instance. * * @param string $instance Name of the instance resource to delete. * @param string $project Project ID for this request. diff --git a/Compute/samples/V1/InstancesClient/delete_network_interface.php b/Compute/samples/V1/InstancesClient/delete_network_interface.php index cd5f48547b28..b60607ad7aab 100644 --- a/Compute/samples/V1/InstancesClient/delete_network_interface.php +++ b/Compute/samples/V1/InstancesClient/delete_network_interface.php @@ -30,9 +30,14 @@ use Google\Rpc\Status; /** - * Deletes one dynamic network interface from an active instance. InstancesDeleteNetworkInterfaceRequest indicates: - instance from which to delete, using project+zone+resource_id fields; - dynamic network interface to be deleted, using network_interface_name field; + * Deletes one dynamic network interface from an active instance. + * InstancesDeleteNetworkInterfaceRequest indicates: + * - instance from which to delete, using project+zone+resource_id fields; + * - dynamic network interface to be deleted, using network_interface_name + * field; * - * @param string $instance The instance name for this request stored as resource_id. Name should conform to RFC1035 or be an unsigned long integer. + * @param string $instance The instance name for this request stored as resource_id. + * Name should conform to RFC1035 or be an unsigned long integer. * @param string $networkInterfaceName The name of the dynamic network interface to be deleted from the instance. * @param string $project Project ID for this request. * @param string $zone The name of the zone for this request. diff --git a/Compute/samples/V1/InstancesClient/detach_disk.php b/Compute/samples/V1/InstancesClient/detach_disk.php index 706a3c79d083..1897e35167e0 100644 --- a/Compute/samples/V1/InstancesClient/detach_disk.php +++ b/Compute/samples/V1/InstancesClient/detach_disk.php @@ -32,7 +32,8 @@ /** * Detaches a disk from an instance. * - * @param string $deviceName The device name of the disk to detach. Make a get() request on the instance to view currently attached disks and device names. + * @param string $deviceName The device name of the disk to detach. Make a get() request on + * the instance to view currently attached disks and device names. * @param string $instance Instance name for this request. * @param string $project Project ID for this request. * @param string $zone The name of the zone for this request. diff --git a/Compute/samples/V1/InstancesClient/get_iam_policy.php b/Compute/samples/V1/InstancesClient/get_iam_policy.php index b7cd99615c06..b6ebcfcc53ca 100644 --- a/Compute/samples/V1/InstancesClient/get_iam_policy.php +++ b/Compute/samples/V1/InstancesClient/get_iam_policy.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\Policy; /** - * Gets the access control policy for a resource. May be empty if no such policy or resource exists. + * Gets the access control policy for a resource. May be empty if no such + * policy or resource exists. * * @param string $project Project ID for this request. * @param string $resource Name or id of the resource for this request. diff --git a/Compute/samples/V1/InstancesClient/insert.php b/Compute/samples/V1/InstancesClient/insert.php index 055ec9fcb84f..45eeb1f03007 100644 --- a/Compute/samples/V1/InstancesClient/insert.php +++ b/Compute/samples/V1/InstancesClient/insert.php @@ -31,7 +31,8 @@ use Google\Rpc\Status; /** - * Creates an instance resource in the specified project using the data included in the request. + * Creates an instance resource in the specified project using the data + * included in the request. * * @param string $project Project ID for this request. * @param string $zone The name of the zone for this request. diff --git a/Compute/samples/V1/InstancesClient/list.php b/Compute/samples/V1/InstancesClient/list.php index 7d5133949e30..b034d33bcb64 100644 --- a/Compute/samples/V1/InstancesClient/list.php +++ b/Compute/samples/V1/InstancesClient/list.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\ListInstancesRequest; /** - * Retrieves the list of instances contained within the specified zone. + * Retrieves the list of instances contained within + * the specified zone. * * @param string $project Project ID for this request. * @param string $zone The name of the zone for this request. diff --git a/Compute/samples/V1/InstancesClient/list_referrers.php b/Compute/samples/V1/InstancesClient/list_referrers.php index 8b12ff5261a1..52d1cf2407b7 100644 --- a/Compute/samples/V1/InstancesClient/list_referrers.php +++ b/Compute/samples/V1/InstancesClient/list_referrers.php @@ -29,9 +29,14 @@ use Google\Cloud\Compute\V1\ListReferrersInstancesRequest; /** - * Retrieves a list of resources that refer to the VM instance specified in the request. For example, if the VM instance is part of a managed or unmanaged instance group, the referrers list includes the instance group. For more information, read Viewing referrers to VM instances. + * Retrieves a list of resources that refer to the VM instance specified in + * the request. For example, if the VM instance is part of a managed or + * unmanaged instance group, the referrers list includes the instance group. + * For more information, readViewing + * referrers to VM instances. * - * @param string $instance Name of the target instance scoping this request, or '-' if the request should span over all instances in the container. + * @param string $instance Name of the target instance scoping this request, or '-' if the + * request should span over all instances in the container. * @param string $project Project ID for this request. * @param string $zone The name of the zone for this request. */ diff --git a/Compute/samples/V1/InstancesClient/reset.php b/Compute/samples/V1/InstancesClient/reset.php index ab59811f40ea..96616fd69f80 100644 --- a/Compute/samples/V1/InstancesClient/reset.php +++ b/Compute/samples/V1/InstancesClient/reset.php @@ -30,7 +30,9 @@ use Google\Rpc\Status; /** - * Performs a reset on the instance. This is a hard reset. The VM does not do a graceful shutdown. For more information, see Resetting an instance. + * Performs a reset on the instance. This is a hard reset. The VM + * does not do a graceful shutdown. For more information, seeResetting + * an instance. * * @param string $instance Name of the instance scoping this request. * @param string $project Project ID for this request. diff --git a/Compute/samples/V1/InstancesClient/resume.php b/Compute/samples/V1/InstancesClient/resume.php index 24382da6aef6..78bbc81c7f55 100644 --- a/Compute/samples/V1/InstancesClient/resume.php +++ b/Compute/samples/V1/InstancesClient/resume.php @@ -30,7 +30,8 @@ use Google\Rpc\Status; /** - * Resumes an instance that was suspended using the instances().suspend method. + * Resumes an instance that was suspended using theinstances().suspend + * method. * * @param string $instance Name of the instance resource to resume. * @param string $project Project ID for this request. diff --git a/Compute/samples/V1/InstancesClient/set_disk_auto_delete.php b/Compute/samples/V1/InstancesClient/set_disk_auto_delete.php index 43be2134a8c4..3c24e43e3111 100644 --- a/Compute/samples/V1/InstancesClient/set_disk_auto_delete.php +++ b/Compute/samples/V1/InstancesClient/set_disk_auto_delete.php @@ -33,7 +33,8 @@ * Sets the auto-delete flag for a disk attached to an instance. * * @param bool $autoDelete Whether to auto-delete the disk when the instance is deleted. - * @param string $deviceName The device name of the disk to modify. Make a get() request on the instance to view currently attached disks and device names. + * @param string $deviceName The device name of the disk to modify. Make a get() request + * on the instance to view currently attached disks and device names. * @param string $instance The instance name for this request. * @param string $project Project ID for this request. * @param string $zone The name of the zone for this request. diff --git a/Compute/samples/V1/InstancesClient/set_iam_policy.php b/Compute/samples/V1/InstancesClient/set_iam_policy.php index fef89c92dd97..e5da68783e3a 100644 --- a/Compute/samples/V1/InstancesClient/set_iam_policy.php +++ b/Compute/samples/V1/InstancesClient/set_iam_policy.php @@ -30,7 +30,8 @@ use Google\Cloud\Compute\V1\ZoneSetPolicyRequest; /** - * Sets the access control policy on the specified resource. Replaces any existing policy. + * Sets the access control policy on the specified resource. + * Replaces any existing policy. * * @param string $project Project ID for this request. * @param string $resource Name or id of the resource for this request. diff --git a/Compute/samples/V1/InstancesClient/set_labels.php b/Compute/samples/V1/InstancesClient/set_labels.php index 7678dadf0004..0099c6bcc091 100644 --- a/Compute/samples/V1/InstancesClient/set_labels.php +++ b/Compute/samples/V1/InstancesClient/set_labels.php @@ -31,7 +31,8 @@ use Google\Rpc\Status; /** - * Sets labels on an instance. To learn more about labels, read the Labeling Resources documentation. + * Sets labels on an instance. To learn more about labels, read theLabeling + * Resources documentation. * * @param string $instance Name of the instance scoping this request. * @param string $project Project ID for this request. diff --git a/Compute/samples/V1/InstancesClient/set_machine_resources.php b/Compute/samples/V1/InstancesClient/set_machine_resources.php index 382f8de9a52f..d10861c2183b 100644 --- a/Compute/samples/V1/InstancesClient/set_machine_resources.php +++ b/Compute/samples/V1/InstancesClient/set_machine_resources.php @@ -31,7 +31,8 @@ use Google\Rpc\Status; /** - * Changes the number and/or type of accelerator for a stopped instance to the values specified in the request. + * Changes the number and/or type of accelerator for a stopped instance to the + * values specified in the request. * * @param string $instance Name of the instance scoping this request. * @param string $project Project ID for this request. diff --git a/Compute/samples/V1/InstancesClient/set_machine_type.php b/Compute/samples/V1/InstancesClient/set_machine_type.php index b08c10ea7aec..a14f58a7b001 100644 --- a/Compute/samples/V1/InstancesClient/set_machine_type.php +++ b/Compute/samples/V1/InstancesClient/set_machine_type.php @@ -31,7 +31,8 @@ use Google\Rpc\Status; /** - * Changes the machine type for a stopped instance to the machine type specified in the request. + * Changes the machine type for a stopped instance to the machine + * type specified in the request. * * @param string $instance Name of the instance scoping this request. * @param string $project Project ID for this request. diff --git a/Compute/samples/V1/InstancesClient/set_metadata.php b/Compute/samples/V1/InstancesClient/set_metadata.php index eba016bae5ae..812f07adba40 100644 --- a/Compute/samples/V1/InstancesClient/set_metadata.php +++ b/Compute/samples/V1/InstancesClient/set_metadata.php @@ -31,7 +31,8 @@ use Google\Rpc\Status; /** - * Sets metadata for the specified instance to the data included in the request. + * Sets metadata for the specified instance to the data included + * in the request. * * @param string $instance Name of the instance scoping this request. * @param string $project Project ID for this request. diff --git a/Compute/samples/V1/InstancesClient/set_min_cpu_platform.php b/Compute/samples/V1/InstancesClient/set_min_cpu_platform.php index 38c6c7c6fe62..a69f39fd8674 100644 --- a/Compute/samples/V1/InstancesClient/set_min_cpu_platform.php +++ b/Compute/samples/V1/InstancesClient/set_min_cpu_platform.php @@ -31,7 +31,10 @@ use Google\Rpc\Status; /** - * Changes the minimum CPU platform that this instance should use. This method can only be called on a stopped instance. For more information, read Specifying a Minimum CPU Platform. + * Changes the minimum CPU platform that this instance should use. + * This method can only + * be called on a stopped instance. For more information, readSpecifying a + * Minimum CPU Platform. * * @param string $instance Name of the instance scoping this request. * @param string $project Project ID for this request. diff --git a/Compute/samples/V1/InstancesClient/set_scheduling.php b/Compute/samples/V1/InstancesClient/set_scheduling.php index 58bd88a5afed..31ca02e144fc 100644 --- a/Compute/samples/V1/InstancesClient/set_scheduling.php +++ b/Compute/samples/V1/InstancesClient/set_scheduling.php @@ -31,7 +31,11 @@ use Google\Rpc\Status; /** - * Sets an instance's scheduling options. You can only call this method on a stopped instance, that is, a VM instance that is in a `TERMINATED` state. See Instance Life Cycle for more information on the possible instance states. For more information about setting scheduling options for a VM, see Set VM host maintenance policy. + * Sets an instance's scheduling options. You can only call this method on astopped instance, + * that is, a VM instance that is in a `TERMINATED` state. SeeInstance Life + * Cycle for more information on the possible instance states. + * For more information about setting scheduling options for a VM, seeSet + * VM host maintenance policy. * * @param string $instance Instance name for this request. * @param string $project Project ID for this request. diff --git a/Compute/samples/V1/InstancesClient/set_security_policy.php b/Compute/samples/V1/InstancesClient/set_security_policy.php index dd9c0073fd3a..edea68056692 100644 --- a/Compute/samples/V1/InstancesClient/set_security_policy.php +++ b/Compute/samples/V1/InstancesClient/set_security_policy.php @@ -31,9 +31,12 @@ use Google\Rpc\Status; /** - * Sets the Google Cloud Armor security policy for the specified instance. For more information, see Google Cloud Armor Overview + * Sets the Google Cloud Armor security policy for the specified instance. + * For more information, seeGoogle + * Cloud Armor Overview * - * @param string $instance Name of the Instance resource to which the security policy should be set. The name should conform to RFC1035. + * @param string $instance Name of the Instance resource to which the security policy should be + * set. The name should conform to RFC1035. * @param string $project Project ID for this request. * @param string $zone Name of the zone scoping this request. */ diff --git a/Compute/samples/V1/InstancesClient/set_service_account.php b/Compute/samples/V1/InstancesClient/set_service_account.php index 55fb08ecf1b9..52605ea657c2 100644 --- a/Compute/samples/V1/InstancesClient/set_service_account.php +++ b/Compute/samples/V1/InstancesClient/set_service_account.php @@ -31,7 +31,9 @@ use Google\Rpc\Status; /** - * Sets the service account on the instance. For more information, read Changing the service account and access scopes for an instance. + * Sets the service account on the instance. For more information, + * readChanging + * the service account and access scopes for an instance. * * @param string $instance Name of the instance resource to start. * @param string $project Project ID for this request. diff --git a/Compute/samples/V1/InstancesClient/set_shielded_instance_integrity_policy.php b/Compute/samples/V1/InstancesClient/set_shielded_instance_integrity_policy.php index 408afff73641..5c665310fd59 100644 --- a/Compute/samples/V1/InstancesClient/set_shielded_instance_integrity_policy.php +++ b/Compute/samples/V1/InstancesClient/set_shielded_instance_integrity_policy.php @@ -31,7 +31,10 @@ use Google\Rpc\Status; /** - * Sets the Shielded Instance integrity policy for an instance. You can only use this method on a running instance. This method supports PATCH semantics and uses the JSON merge patch format and processing rules. + * Sets the Shielded Instance integrity policy for an instance. You can + * only use this method on a running instance. This method + * supports PATCH semantics and uses the JSON merge + * patch format and processing rules. * * @param string $instance Name or id of the instance scoping this request. * @param string $project Project ID for this request. diff --git a/Compute/samples/V1/InstancesClient/set_tags.php b/Compute/samples/V1/InstancesClient/set_tags.php index 9287352d252d..5d3b1e510681 100644 --- a/Compute/samples/V1/InstancesClient/set_tags.php +++ b/Compute/samples/V1/InstancesClient/set_tags.php @@ -31,7 +31,8 @@ use Google\Rpc\Status; /** - * Sets network tags for the specified instance to the data included in the request. + * Sets network tags + * for the specified instance to the data included in the request. * * @param string $instance Name of the instance scoping this request. * @param string $project Project ID for this request. diff --git a/Compute/samples/V1/InstancesClient/simulate_maintenance_event.php b/Compute/samples/V1/InstancesClient/simulate_maintenance_event.php index 2a57e34c5a5e..623b491bf879 100644 --- a/Compute/samples/V1/InstancesClient/simulate_maintenance_event.php +++ b/Compute/samples/V1/InstancesClient/simulate_maintenance_event.php @@ -30,7 +30,8 @@ use Google\Rpc\Status; /** - * Simulates a host maintenance event on a VM. For more information, see Simulate a host maintenance event. + * Simulates a host maintenance event on a VM. For more information, see + * Simulate a host maintenance event. * * @param string $instance Name of the instance scoping this request. * @param string $project Project ID for this request. diff --git a/Compute/samples/V1/InstancesClient/start.php b/Compute/samples/V1/InstancesClient/start.php index 46db4990325f..2cfe96d63a9a 100644 --- a/Compute/samples/V1/InstancesClient/start.php +++ b/Compute/samples/V1/InstancesClient/start.php @@ -30,7 +30,9 @@ use Google\Rpc\Status; /** - * Starts an instance that was stopped using the instances().stop method. For more information, see Restart an instance. + * Starts an instance that was stopped using theinstances().stop + * method. For more information, seeRestart an + * instance. * * @param string $instance Name of the instance resource to start. * @param string $project Project ID for this request. diff --git a/Compute/samples/V1/InstancesClient/start_with_encryption_key.php b/Compute/samples/V1/InstancesClient/start_with_encryption_key.php index 893507d0b36b..4409ee42973b 100644 --- a/Compute/samples/V1/InstancesClient/start_with_encryption_key.php +++ b/Compute/samples/V1/InstancesClient/start_with_encryption_key.php @@ -31,7 +31,9 @@ use Google\Rpc\Status; /** - * Starts an instance that was stopped using the instances().stop method. For more information, see Restart an instance. + * Starts an instance that was stopped using theinstances().stop + * method. For more information, seeRestart an + * instance. * * @param string $instance Name of the instance resource to start. * @param string $project Project ID for this request. diff --git a/Compute/samples/V1/InstancesClient/stop.php b/Compute/samples/V1/InstancesClient/stop.php index 84224d66f320..48b0ce5aab4b 100644 --- a/Compute/samples/V1/InstancesClient/stop.php +++ b/Compute/samples/V1/InstancesClient/stop.php @@ -30,7 +30,12 @@ use Google\Rpc\Status; /** - * Stops a running instance, shutting it down cleanly, and allows you to restart the instance at a later time. Stopped instances do not incur VM usage charges while they are stopped. However, resources that the VM is using, such as persistent disks and static IP addresses, will continue to be charged until they are deleted. For more information, see Stopping an instance. + * Stops a running instance, shutting it down cleanly, and allows + * you to restart the instance at a later time. Stopped instances do not incur + * VM usage charges while they are stopped. However, resources that the VM is + * using, such as persistent disks and static IP addresses, will continue to + * be charged until they are deleted. For more information, seeStopping + * an instance. * * @param string $instance Name of the instance resource to stop. * @param string $project Project ID for this request. diff --git a/Compute/samples/V1/InstancesClient/suspend.php b/Compute/samples/V1/InstancesClient/suspend.php index f46a2e6cc683..b05054cf8b20 100644 --- a/Compute/samples/V1/InstancesClient/suspend.php +++ b/Compute/samples/V1/InstancesClient/suspend.php @@ -30,7 +30,14 @@ use Google\Rpc\Status; /** - * This method suspends a running instance, saving its state to persistent storage, and allows you to resume the instance at a later time. Suspended instances have no compute costs (cores or RAM), and incur only storage charges for the saved VM memory and localSSD data. Any charged resources the virtual machine was using, such as persistent disks and static IP addresses, will continue to be charged while the instance is suspended. For more information, see Suspending and resuming an instance. + * This method suspends a running instance, saving its state to persistent + * storage, and allows you to resume the instance at a later time. Suspended + * instances have no compute costs (cores or RAM), and incur only storage + * charges for the saved VM memory and localSSD data. Any charged resources + * the virtual machine was using, such as persistent disks and static IP + * addresses, will continue to be charged while the instance is suspended. + * For more information, see + * Suspending and resuming an instance. * * @param string $instance Name of the instance resource to suspend. * @param string $project Project ID for this request. diff --git a/Compute/samples/V1/InstancesClient/update.php b/Compute/samples/V1/InstancesClient/update.php index 34f9716a6962..ee17c30ca8f7 100644 --- a/Compute/samples/V1/InstancesClient/update.php +++ b/Compute/samples/V1/InstancesClient/update.php @@ -31,7 +31,10 @@ use Google\Rpc\Status; /** - * Updates an instance only if the necessary resources are available. This method can update only a specific set of instance properties. See Updating a running instance for a list of updatable instance properties. + * Updates an instance only if the necessary resources are available. This + * method can update only a specific set of instance properties. See + * Updating a running instance for a list of updatable instance + * properties. * * @param string $instance Name of the instance resource to update. * @param string $project Project ID for this request. diff --git a/Compute/samples/V1/InstancesClient/update_access_config.php b/Compute/samples/V1/InstancesClient/update_access_config.php index dad4c29346ab..098fdd467f96 100644 --- a/Compute/samples/V1/InstancesClient/update_access_config.php +++ b/Compute/samples/V1/InstancesClient/update_access_config.php @@ -31,7 +31,10 @@ use Google\Rpc\Status; /** - * Updates the specified access config from an instance's network interface with the data included in the request. This method supports PATCH semantics and uses the JSON merge patch format and processing rules. + * Updates the specified access config from an instance's network interface + * with the data included in the request. This method supportsPATCH + * semantics and uses theJSON merge + * patch format and processing rules. * * @param string $instance The instance name for this request. * @param string $networkInterface The name of the network interface where the access config is attached. diff --git a/Compute/samples/V1/InstancesClient/update_display_device.php b/Compute/samples/V1/InstancesClient/update_display_device.php index 4f3c667d0e44..4c29d1267dd5 100644 --- a/Compute/samples/V1/InstancesClient/update_display_device.php +++ b/Compute/samples/V1/InstancesClient/update_display_device.php @@ -31,7 +31,10 @@ use Google\Rpc\Status; /** - * Updates the Display config for a VM instance. You can only use this method on a stopped VM instance. This method supports PATCH semantics and uses the JSON merge patch format and processing rules. + * Updates the Display config for a VM instance. You can + * only use this method on a stopped VM instance. This method supportsPATCH + * semantics and uses theJSON merge + * patch format and processing rules. * * @param string $instance Name of the instance scoping this request. * @param string $project Project ID for this request. diff --git a/Compute/samples/V1/InstancesClient/update_network_interface.php b/Compute/samples/V1/InstancesClient/update_network_interface.php index 695b1bbe56c1..766688e9fe1c 100644 --- a/Compute/samples/V1/InstancesClient/update_network_interface.php +++ b/Compute/samples/V1/InstancesClient/update_network_interface.php @@ -31,7 +31,12 @@ use Google\Rpc\Status; /** - * Updates an instance's network interface. This method can only update an interface's alias IP range and attached network. See Modifying alias IP ranges for an existing instance for instructions on changing alias IP ranges. See Migrating a VM between networks for instructions on migrating an interface. This method follows PATCH semantics. + * Updates an instance's network interface. This method can only update an + * interface's alias IP range and attached network. See Modifying + * alias IP ranges for an existing instance for instructions on + * changing alias IP ranges. See Migrating + * a VM between networks for instructions on migrating an interface. + * This method follows PATCH semantics. * * @param string $instance The instance name for this request. * @param string $networkInterface The name of the network interface to update. diff --git a/Compute/samples/V1/InstancesClient/update_shielded_instance_config.php b/Compute/samples/V1/InstancesClient/update_shielded_instance_config.php index d9074a14355a..4acae07e2fce 100644 --- a/Compute/samples/V1/InstancesClient/update_shielded_instance_config.php +++ b/Compute/samples/V1/InstancesClient/update_shielded_instance_config.php @@ -31,7 +31,10 @@ use Google\Rpc\Status; /** - * Updates the Shielded Instance config for an instance. You can only use this method on a stopped instance. This method supports PATCH semantics and uses the JSON merge patch format and processing rules. + * Updates the Shielded Instance config for an instance. You can + * only use this method on a stopped instance. This method supportsPATCH + * semantics and uses theJSON merge + * patch format and processing rules. * * @param string $instance Name or id of the instance scoping this request. * @param string $project Project ID for this request. diff --git a/Compute/samples/V1/InstantSnapshotsClient/aggregated_list.php b/Compute/samples/V1/InstantSnapshotsClient/aggregated_list.php index 2053ca9c6a67..df171d67fbcf 100644 --- a/Compute/samples/V1/InstantSnapshotsClient/aggregated_list.php +++ b/Compute/samples/V1/InstantSnapshotsClient/aggregated_list.php @@ -29,7 +29,10 @@ use Google\Cloud\Compute\V1\Client\InstantSnapshotsClient; /** - * Retrieves an aggregated list of instantSnapshots. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. + * Retrieves an aggregated list of instantSnapshots. + * + * To prevent failure, Google recommends that you set the + * `returnPartialSuccess` parameter to `true`. * * @param string $project Project ID for this request. */ diff --git a/Compute/samples/V1/InstantSnapshotsClient/delete.php b/Compute/samples/V1/InstantSnapshotsClient/delete.php index ccbaa8e7d5d8..2b268c2c60db 100644 --- a/Compute/samples/V1/InstantSnapshotsClient/delete.php +++ b/Compute/samples/V1/InstantSnapshotsClient/delete.php @@ -30,7 +30,14 @@ use Google\Rpc\Status; /** - * Deletes the specified InstantSnapshot resource. Keep in mind that deleting a single instantSnapshot might not necessarily delete all the data on that instantSnapshot. If any data on the instantSnapshot that is marked for deletion is needed for subsequent instantSnapshots, the data will be moved to the next corresponding instantSnapshot. For more information, see Deleting instantSnapshots. + * Deletes the specified InstantSnapshot resource. Keep in mind that deleting + * a single instantSnapshot might not necessarily delete all the data on that + * instantSnapshot. If any data on the instantSnapshot that is marked for + * deletion is needed for subsequent instantSnapshots, the data will be moved + * to the next corresponding instantSnapshot. + * + * For more information, seeDeleting + * instantSnapshots. * * @param string $instantSnapshot Name of the InstantSnapshot resource to delete. * @param string $project Project ID for this request. diff --git a/Compute/samples/V1/InstantSnapshotsClient/get_iam_policy.php b/Compute/samples/V1/InstantSnapshotsClient/get_iam_policy.php index 384abe63de37..4e54b4be0d56 100644 --- a/Compute/samples/V1/InstantSnapshotsClient/get_iam_policy.php +++ b/Compute/samples/V1/InstantSnapshotsClient/get_iam_policy.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\Policy; /** - * Gets the access control policy for a resource. May be empty if no such policy or resource exists. + * Gets the access control policy for a resource. May be empty if no such + * policy or resource exists. * * @param string $project Project ID for this request. * @param string $resource Name or id of the resource for this request. diff --git a/Compute/samples/V1/InstantSnapshotsClient/list.php b/Compute/samples/V1/InstantSnapshotsClient/list.php index 0a2a3522fa30..d31dca933795 100644 --- a/Compute/samples/V1/InstantSnapshotsClient/list.php +++ b/Compute/samples/V1/InstantSnapshotsClient/list.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\ListInstantSnapshotsRequest; /** - * Retrieves the list of InstantSnapshot resources contained within the specified zone. + * Retrieves the list of InstantSnapshot resources contained within + * the specified zone. * * @param string $project Project ID for this request. * @param string $zone The name of the zone for this request. diff --git a/Compute/samples/V1/InstantSnapshotsClient/set_iam_policy.php b/Compute/samples/V1/InstantSnapshotsClient/set_iam_policy.php index 7b8ddeea5c5a..7e31ff172e01 100644 --- a/Compute/samples/V1/InstantSnapshotsClient/set_iam_policy.php +++ b/Compute/samples/V1/InstantSnapshotsClient/set_iam_policy.php @@ -30,7 +30,8 @@ use Google\Cloud\Compute\V1\ZoneSetPolicyRequest; /** - * Sets the access control policy on the specified resource. Replaces any existing policy. + * Sets the access control policy on the specified resource. + * Replaces any existing policy. * * @param string $project Project ID for this request. * @param string $resource Name or id of the resource for this request. diff --git a/Compute/samples/V1/InstantSnapshotsClient/set_labels.php b/Compute/samples/V1/InstantSnapshotsClient/set_labels.php index 0f3dd644405f..01b5675eaaf8 100644 --- a/Compute/samples/V1/InstantSnapshotsClient/set_labels.php +++ b/Compute/samples/V1/InstantSnapshotsClient/set_labels.php @@ -31,7 +31,9 @@ use Google\Rpc\Status; /** - * Sets the labels on a instantSnapshot in the given zone. To learn more about labels, read the Labeling Resources documentation. + * Sets the labels on a instantSnapshot in the given zone. To learn more about + * labels, read the Labeling + * Resources documentation. * * @param string $project Project ID for this request. * @param string $resource Name or id of the resource for this request. diff --git a/Compute/samples/V1/InterconnectAttachmentGroupsClient/get.php b/Compute/samples/V1/InterconnectAttachmentGroupsClient/get.php index 5afd558b84d9..2da9f6feb22d 100644 --- a/Compute/samples/V1/InterconnectAttachmentGroupsClient/get.php +++ b/Compute/samples/V1/InterconnectAttachmentGroupsClient/get.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\InterconnectAttachmentGroup; /** - * Returns the specified InterconnectAttachmentGroup resource in the given scope. + * Returns the specified InterconnectAttachmentGroup resource in the given + * scope. * * @param string $interconnectAttachmentGroup Name of the InterconnectAttachmentGroup resource to return. * @param string $project Project ID for this request. diff --git a/Compute/samples/V1/InterconnectAttachmentGroupsClient/get_iam_policy.php b/Compute/samples/V1/InterconnectAttachmentGroupsClient/get_iam_policy.php index 9e108cf6d730..d170246599a7 100644 --- a/Compute/samples/V1/InterconnectAttachmentGroupsClient/get_iam_policy.php +++ b/Compute/samples/V1/InterconnectAttachmentGroupsClient/get_iam_policy.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\Policy; /** - * Gets the access control policy for a resource. May be empty if no such policy or resource exists. + * Gets the access control policy for a resource. May be empty if no such + * policy or resource exists. * * @param string $project Project ID for this request. * @param string $resource Name or id of the resource for this request. diff --git a/Compute/samples/V1/InterconnectAttachmentGroupsClient/get_operational_status.php b/Compute/samples/V1/InterconnectAttachmentGroupsClient/get_operational_status.php index d1f43f72f0eb..b75b10b19c01 100644 --- a/Compute/samples/V1/InterconnectAttachmentGroupsClient/get_operational_status.php +++ b/Compute/samples/V1/InterconnectAttachmentGroupsClient/get_operational_status.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\InterconnectAttachmentGroupsGetOperationalStatusResponse; /** - * Returns the InterconnectAttachmentStatuses for the specified InterconnectAttachmentGroup resource. + * Returns the InterconnectAttachmentStatuses for the specified + * InterconnectAttachmentGroup resource. * * @param string $interconnectAttachmentGroup Name of the interconnectAttachmentGroup resource to query. * @param string $project Project ID for this request. diff --git a/Compute/samples/V1/InterconnectAttachmentGroupsClient/insert.php b/Compute/samples/V1/InterconnectAttachmentGroupsClient/insert.php index e4905cbc71fa..63e3061e3093 100644 --- a/Compute/samples/V1/InterconnectAttachmentGroupsClient/insert.php +++ b/Compute/samples/V1/InterconnectAttachmentGroupsClient/insert.php @@ -31,7 +31,8 @@ use Google\Rpc\Status; /** - * Creates a InterconnectAttachmentGroup in the specified project in the given scope using the parameters that are included in the request. + * Creates a InterconnectAttachmentGroup in the specified project in the given + * scope using the parameters that are included in the request. * * @param string $project Project ID for this request. */ diff --git a/Compute/samples/V1/InterconnectAttachmentGroupsClient/patch.php b/Compute/samples/V1/InterconnectAttachmentGroupsClient/patch.php index 8f255509fa47..01b840577209 100644 --- a/Compute/samples/V1/InterconnectAttachmentGroupsClient/patch.php +++ b/Compute/samples/V1/InterconnectAttachmentGroupsClient/patch.php @@ -31,7 +31,10 @@ use Google\Rpc\Status; /** - * Patches the specified InterconnectAttachmentGroup resource with the data included in the request. This method supports PATCH semantics and uses JSON merge patch format and processing rules. + * Patches the specified InterconnectAttachmentGroup resource with the data + * included in the request. This method supports PATCH + * semantics and usesJSON merge + * patch format and processing rules. * * @param string $interconnectAttachmentGroup Name of the InterconnectAttachmentGroup resource to patch. * @param string $project Project ID for this request. diff --git a/Compute/samples/V1/InterconnectAttachmentGroupsClient/set_iam_policy.php b/Compute/samples/V1/InterconnectAttachmentGroupsClient/set_iam_policy.php index 9775a2175daa..d188721697d5 100644 --- a/Compute/samples/V1/InterconnectAttachmentGroupsClient/set_iam_policy.php +++ b/Compute/samples/V1/InterconnectAttachmentGroupsClient/set_iam_policy.php @@ -30,7 +30,8 @@ use Google\Cloud\Compute\V1\SetIamPolicyInterconnectAttachmentGroupRequest; /** - * Sets the access control policy on the specified resource. Replaces any existing policy. + * Sets the access control policy on the specified resource. + * Replaces any existing policy. * * @param string $project Project ID for this request. * @param string $resource Name or id of the resource for this request. diff --git a/Compute/samples/V1/InterconnectAttachmentsClient/aggregated_list.php b/Compute/samples/V1/InterconnectAttachmentsClient/aggregated_list.php index d4377e4176fe..1f0307f61ade 100644 --- a/Compute/samples/V1/InterconnectAttachmentsClient/aggregated_list.php +++ b/Compute/samples/V1/InterconnectAttachmentsClient/aggregated_list.php @@ -29,7 +29,10 @@ use Google\Cloud\Compute\V1\Client\InterconnectAttachmentsClient; /** - * Retrieves an aggregated list of interconnect attachments. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. + * Retrieves an aggregated list of interconnect attachments. + * + * To prevent failure, Google recommends that you set the + * `returnPartialSuccess` parameter to `true`. * * @param string $project Project ID for this request. */ diff --git a/Compute/samples/V1/InterconnectAttachmentsClient/insert.php b/Compute/samples/V1/InterconnectAttachmentsClient/insert.php index a290938033d3..22d9e13c4ce3 100644 --- a/Compute/samples/V1/InterconnectAttachmentsClient/insert.php +++ b/Compute/samples/V1/InterconnectAttachmentsClient/insert.php @@ -31,7 +31,8 @@ use Google\Rpc\Status; /** - * Creates an InterconnectAttachment in the specified project using the data included in the request. + * Creates an InterconnectAttachment in the specified project using the data + * included in the request. * * @param string $project Project ID for this request. * @param string $region Name of the region for this request. diff --git a/Compute/samples/V1/InterconnectAttachmentsClient/list.php b/Compute/samples/V1/InterconnectAttachmentsClient/list.php index 75f4b72c4912..b5a09eb8152a 100644 --- a/Compute/samples/V1/InterconnectAttachmentsClient/list.php +++ b/Compute/samples/V1/InterconnectAttachmentsClient/list.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\ListInterconnectAttachmentsRequest; /** - * Retrieves the list of interconnect attachments contained within the specified region. + * Retrieves the list of interconnect attachments contained within + * the specified region. * * @param string $project Project ID for this request. * @param string $region Name of the region for this request. diff --git a/Compute/samples/V1/InterconnectAttachmentsClient/patch.php b/Compute/samples/V1/InterconnectAttachmentsClient/patch.php index 66f25ded1c83..c140d9fd5f77 100644 --- a/Compute/samples/V1/InterconnectAttachmentsClient/patch.php +++ b/Compute/samples/V1/InterconnectAttachmentsClient/patch.php @@ -31,7 +31,10 @@ use Google\Rpc\Status; /** - * Updates the specified interconnect attachment with the data included in the request. This method supports PATCH semantics and uses the JSON merge patch format and processing rules. + * Updates the specified interconnect attachment with the data included in the + * request. This method supportsPATCH + * semantics and uses theJSON merge + * patch format and processing rules. * * @param string $interconnectAttachment Name of the interconnect attachment to patch. * @param string $project Project ID for this request. diff --git a/Compute/samples/V1/InterconnectAttachmentsClient/set_labels.php b/Compute/samples/V1/InterconnectAttachmentsClient/set_labels.php index 2d61ac20072f..53c8aeaf4851 100644 --- a/Compute/samples/V1/InterconnectAttachmentsClient/set_labels.php +++ b/Compute/samples/V1/InterconnectAttachmentsClient/set_labels.php @@ -31,7 +31,9 @@ use Google\Rpc\Status; /** - * Sets the labels on an InterconnectAttachment. To learn more about labels, read the Labeling Resources documentation. + * Sets the labels on an InterconnectAttachment. To learn more about labels, + * read the Labeling + * Resources documentation. * * @param string $project Project ID for this request. * @param string $region The region for this request. diff --git a/Compute/samples/V1/InterconnectGroupsClient/create_members.php b/Compute/samples/V1/InterconnectGroupsClient/create_members.php index 5c5c8b78dc4d..0772e1da8644 100644 --- a/Compute/samples/V1/InterconnectGroupsClient/create_members.php +++ b/Compute/samples/V1/InterconnectGroupsClient/create_members.php @@ -31,7 +31,8 @@ use Google\Rpc\Status; /** - * Create Interconnects with redundancy by creating them in a specified interconnect group. + * Create Interconnects with redundancy by creating them in a specified + * interconnect group. * * @param string $interconnectGroup Name of the group resource to create members for. * @param string $project Project ID for this request. diff --git a/Compute/samples/V1/InterconnectGroupsClient/get_iam_policy.php b/Compute/samples/V1/InterconnectGroupsClient/get_iam_policy.php index ea298ecfa32e..3ceae60cc6f8 100644 --- a/Compute/samples/V1/InterconnectGroupsClient/get_iam_policy.php +++ b/Compute/samples/V1/InterconnectGroupsClient/get_iam_policy.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\Policy; /** - * Gets the access control policy for a resource. May be empty if no such policy or resource exists. + * Gets the access control policy for a resource. May be empty if no such + * policy or resource exists. * * @param string $project Project ID for this request. * @param string $resource Name or id of the resource for this request. diff --git a/Compute/samples/V1/InterconnectGroupsClient/get_operational_status.php b/Compute/samples/V1/InterconnectGroupsClient/get_operational_status.php index 81c106db1c83..6890716d5baa 100644 --- a/Compute/samples/V1/InterconnectGroupsClient/get_operational_status.php +++ b/Compute/samples/V1/InterconnectGroupsClient/get_operational_status.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\InterconnectGroupsGetOperationalStatusResponse; /** - * Returns the interconnectStatuses for the specified InterconnectGroup. + * Returns the interconnectStatuses for the specified + * InterconnectGroup. * * @param string $interconnectGroup Name of the interconnectGroup resource to query. * @param string $project Project ID for this request. diff --git a/Compute/samples/V1/InterconnectGroupsClient/insert.php b/Compute/samples/V1/InterconnectGroupsClient/insert.php index d6236c1cbcb1..5956b70e0d43 100644 --- a/Compute/samples/V1/InterconnectGroupsClient/insert.php +++ b/Compute/samples/V1/InterconnectGroupsClient/insert.php @@ -31,7 +31,8 @@ use Google\Rpc\Status; /** - * Creates a InterconnectGroup in the specified project in the given scope using the parameters that are included in the request. + * Creates a InterconnectGroup in the specified project in the given scope + * using the parameters that are included in the request. * * @param string $project Project ID for this request. */ diff --git a/Compute/samples/V1/InterconnectGroupsClient/patch.php b/Compute/samples/V1/InterconnectGroupsClient/patch.php index f8ab18096aaa..48ff46783736 100644 --- a/Compute/samples/V1/InterconnectGroupsClient/patch.php +++ b/Compute/samples/V1/InterconnectGroupsClient/patch.php @@ -31,7 +31,10 @@ use Google\Rpc\Status; /** - * Patches the specified InterconnectGroup resource with the data included in the request. This method supports PATCH semantics and uses JSON merge patch format and processing rules. + * Patches the specified InterconnectGroup resource with the data included in + * the request. This method supports PATCH + * semantics and usesJSON merge + * patch format and processing rules. * * @param string $interconnectGroup Name of the InterconnectGroup resource to patch. * @param string $project Project ID for this request. diff --git a/Compute/samples/V1/InterconnectGroupsClient/set_iam_policy.php b/Compute/samples/V1/InterconnectGroupsClient/set_iam_policy.php index a14e3bcd80fc..8ba77d160503 100644 --- a/Compute/samples/V1/InterconnectGroupsClient/set_iam_policy.php +++ b/Compute/samples/V1/InterconnectGroupsClient/set_iam_policy.php @@ -30,7 +30,8 @@ use Google\Cloud\Compute\V1\SetIamPolicyInterconnectGroupRequest; /** - * Sets the access control policy on the specified resource. Replaces any existing policy. + * Sets the access control policy on the specified resource. + * Replaces any existing policy. * * @param string $project Project ID for this request. * @param string $resource Name or id of the resource for this request. diff --git a/Compute/samples/V1/InterconnectLocationsClient/get.php b/Compute/samples/V1/InterconnectLocationsClient/get.php index 3620ebbb3916..26f122dedb2c 100644 --- a/Compute/samples/V1/InterconnectLocationsClient/get.php +++ b/Compute/samples/V1/InterconnectLocationsClient/get.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\InterconnectLocation; /** - * Returns the details for the specified interconnect location. Gets a list of available interconnect locations by making a list() request. + * Returns the details for the specified interconnect location. Gets a list of + * available interconnect locations by making a list() request. * * @param string $interconnectLocation Name of the interconnect location to return. * @param string $project Project ID for this request. diff --git a/Compute/samples/V1/InterconnectLocationsClient/list.php b/Compute/samples/V1/InterconnectLocationsClient/list.php index 8c8953a3d959..04be5722e861 100644 --- a/Compute/samples/V1/InterconnectLocationsClient/list.php +++ b/Compute/samples/V1/InterconnectLocationsClient/list.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\ListInterconnectLocationsRequest; /** - * Retrieves the list of interconnect locations available to the specified project. + * Retrieves the list of interconnect locations available to the specified + * project. * * @param string $project Project ID for this request. */ diff --git a/Compute/samples/V1/InterconnectRemoteLocationsClient/get.php b/Compute/samples/V1/InterconnectRemoteLocationsClient/get.php index 70634af53db0..9184b2951f0a 100644 --- a/Compute/samples/V1/InterconnectRemoteLocationsClient/get.php +++ b/Compute/samples/V1/InterconnectRemoteLocationsClient/get.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\InterconnectRemoteLocation; /** - * Returns the details for the specified interconnect remote location. Gets a list of available interconnect remote locations by making a list() request. + * Returns the details for the specified interconnect remote location. Gets a + * list of available interconnect remote locations by making alist() request. * * @param string $interconnectRemoteLocation Name of the interconnect remote location to return. * @param string $project Project ID for this request. diff --git a/Compute/samples/V1/InterconnectRemoteLocationsClient/list.php b/Compute/samples/V1/InterconnectRemoteLocationsClient/list.php index 28a5cf60a06b..7488ff70af87 100644 --- a/Compute/samples/V1/InterconnectRemoteLocationsClient/list.php +++ b/Compute/samples/V1/InterconnectRemoteLocationsClient/list.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\ListInterconnectRemoteLocationsRequest; /** - * Retrieves the list of interconnect remote locations available to the specified project. + * Retrieves the list of interconnect remote locations available to the + * specified project. * * @param string $project Project ID for this request. */ diff --git a/Compute/samples/V1/InterconnectsClient/get.php b/Compute/samples/V1/InterconnectsClient/get.php index 635503972525..801c7ab86ac9 100644 --- a/Compute/samples/V1/InterconnectsClient/get.php +++ b/Compute/samples/V1/InterconnectsClient/get.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\Interconnect; /** - * Returns the specified Interconnect. Get a list of available Interconnects by making a list() request. + * Returns the specified Interconnect. Get a list of available Interconnects + * by making a list() request. * * @param string $interconnect Name of the interconnect to return. * @param string $project Project ID for this request. diff --git a/Compute/samples/V1/InterconnectsClient/get_diagnostics.php b/Compute/samples/V1/InterconnectsClient/get_diagnostics.php index 30ab83427555..d94f57c41eba 100644 --- a/Compute/samples/V1/InterconnectsClient/get_diagnostics.php +++ b/Compute/samples/V1/InterconnectsClient/get_diagnostics.php @@ -29,7 +29,16 @@ use Google\Cloud\Compute\V1\InterconnectsGetDiagnosticsResponse; /** - * Returns the interconnectDiagnostics for the specified Interconnect. In the event of a global outage, do not use this API to make decisions about where to redirect your network traffic. Unlike a VLAN attachment, which is regional, a Cloud Interconnect connection is a global resource. A global outage can prevent this API from functioning properly. + * Returns the interconnectDiagnostics for the specified + * Interconnect. + * + * In the event of a + * global outage, do not use this API to make decisions about where to + * redirect your network traffic. + * + * Unlike a VLAN attachment, which is regional, a Cloud Interconnect + * connection is a global resource. A global outage can prevent this + * API from functioning properly. * * @param string $interconnect Name of the interconnect resource to query. * @param string $project Project ID for this request. diff --git a/Compute/samples/V1/InterconnectsClient/get_macsec_config.php b/Compute/samples/V1/InterconnectsClient/get_macsec_config.php index 10509d4b4476..f7631dceee11 100644 --- a/Compute/samples/V1/InterconnectsClient/get_macsec_config.php +++ b/Compute/samples/V1/InterconnectsClient/get_macsec_config.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\InterconnectsGetMacsecConfigResponse; /** - * Returns the interconnectMacsecConfig for the specified Interconnect. + * Returns the interconnectMacsecConfig for the specified + * Interconnect. * * @param string $interconnect Name of the interconnect resource to query. * @param string $project Project ID for this request. diff --git a/Compute/samples/V1/InterconnectsClient/insert.php b/Compute/samples/V1/InterconnectsClient/insert.php index 273fd5af8694..0f16062975b6 100644 --- a/Compute/samples/V1/InterconnectsClient/insert.php +++ b/Compute/samples/V1/InterconnectsClient/insert.php @@ -31,7 +31,8 @@ use Google\Rpc\Status; /** - * Creates an Interconnect in the specified project using the data included in the request. + * Creates an Interconnect in the specified project using + * the data included in the request. * * @param string $project Project ID for this request. */ diff --git a/Compute/samples/V1/InterconnectsClient/patch.php b/Compute/samples/V1/InterconnectsClient/patch.php index 3b24e0e5f717..8179ab423f99 100644 --- a/Compute/samples/V1/InterconnectsClient/patch.php +++ b/Compute/samples/V1/InterconnectsClient/patch.php @@ -31,7 +31,10 @@ use Google\Rpc\Status; /** - * Updates the specified Interconnect with the data included in the request. This method supports PATCH semantics and uses the JSON merge patch format and processing rules. + * Updates the specified Interconnect with the data included in the request. + * This method supportsPATCH + * semantics and uses theJSON merge + * patch format and processing rules. * * @param string $interconnect Name of the interconnect to update. * @param string $project Project ID for this request. diff --git a/Compute/samples/V1/InterconnectsClient/set_labels.php b/Compute/samples/V1/InterconnectsClient/set_labels.php index 2af2526162ee..e3eb57d54ddb 100644 --- a/Compute/samples/V1/InterconnectsClient/set_labels.php +++ b/Compute/samples/V1/InterconnectsClient/set_labels.php @@ -31,7 +31,9 @@ use Google\Rpc\Status; /** - * Sets the labels on an Interconnect. To learn more about labels, read the Labeling Resources documentation. + * Sets the labels on an Interconnect. To learn more about labels, + * read the Labeling + * Resources documentation. * * @param string $project Project ID for this request. * @param string $resource Name or id of the resource for this request. diff --git a/Compute/samples/V1/LicenseCodesClient/get.php b/Compute/samples/V1/LicenseCodesClient/get.php index bda5cee9dc91..937185a98db6 100644 --- a/Compute/samples/V1/LicenseCodesClient/get.php +++ b/Compute/samples/V1/LicenseCodesClient/get.php @@ -29,7 +29,11 @@ use Google\Cloud\Compute\V1\LicenseCode; /** - * Return a specified license code. License codes are mirrored across all projects that have permissions to read the License Code. *Caution* This resource is intended for use only by third-party partners who are creating Cloud Marketplace images. + * Return a specified license code. License codes are mirrored across + * all projects that have permissions to read the License Code. + * *Caution* This resource is intended + * for use only by third-party partners who are creatingCloud Marketplace + * images. * * @param string $licenseCode Number corresponding to the License code resource to return. * @param string $project Project ID for this request. diff --git a/Compute/samples/V1/LicenseCodesClient/test_iam_permissions.php b/Compute/samples/V1/LicenseCodesClient/test_iam_permissions.php index dc1c64fce5ef..23437f2fcf56 100644 --- a/Compute/samples/V1/LicenseCodesClient/test_iam_permissions.php +++ b/Compute/samples/V1/LicenseCodesClient/test_iam_permissions.php @@ -30,7 +30,10 @@ use Google\Cloud\Compute\V1\TestPermissionsResponse; /** - * Returns permissions that a caller has on the specified resource. *Caution* This resource is intended for use only by third-party partners who are creating Cloud Marketplace images. + * Returns permissions that a caller has on the specified resource. + * *Caution* This resource is intended + * for use only by third-party partners who are creatingCloud Marketplace + * images. * * @param string $project Project ID for this request. * @param string $resource Name or id of the resource for this request. diff --git a/Compute/samples/V1/LicensesClient/delete.php b/Compute/samples/V1/LicensesClient/delete.php index 623dc0561eea..a0f8beba9abc 100644 --- a/Compute/samples/V1/LicensesClient/delete.php +++ b/Compute/samples/V1/LicensesClient/delete.php @@ -30,7 +30,10 @@ use Google\Rpc\Status; /** - * Deletes the specified license. *Caution* This resource is intended for use only by third-party partners who are creating Cloud Marketplace images. + * Deletes the specified license. + * *Caution* This resource is intended + * for use only by third-party partners who are creatingCloud Marketplace + * images. * * @param string $license Name of the license resource to delete. * @param string $project Project ID for this request. diff --git a/Compute/samples/V1/LicensesClient/get.php b/Compute/samples/V1/LicensesClient/get.php index 81f6b561cd67..02b45e64e107 100644 --- a/Compute/samples/V1/LicensesClient/get.php +++ b/Compute/samples/V1/LicensesClient/get.php @@ -29,7 +29,10 @@ use Google\Cloud\Compute\V1\License; /** - * Returns the specified License resource. *Caution* This resource is intended for use only by third-party partners who are creating Cloud Marketplace images. + * Returns the specified License resource. + * *Caution* This resource is intended + * for use only by third-party partners who are creatingCloud Marketplace + * images. * * @param string $license Name of the License resource to return. * @param string $project Project ID for this request. diff --git a/Compute/samples/V1/LicensesClient/get_iam_policy.php b/Compute/samples/V1/LicensesClient/get_iam_policy.php index 4fbda8bdb7b2..a8e76ef9d2fc 100644 --- a/Compute/samples/V1/LicensesClient/get_iam_policy.php +++ b/Compute/samples/V1/LicensesClient/get_iam_policy.php @@ -29,7 +29,11 @@ use Google\Cloud\Compute\V1\Policy; /** - * Gets the access control policy for a resource. May be empty if no such policy or resource exists. *Caution* This resource is intended for use only by third-party partners who are creating Cloud Marketplace images. + * Gets the access control policy for a resource. May be empty if no such + * policy or resource exists. + * *Caution* This resource is intended + * for use only by third-party partners who are creatingCloud Marketplace + * images. * * @param string $project Project ID for this request. * @param string $resource Name or id of the resource for this request. diff --git a/Compute/samples/V1/LicensesClient/insert.php b/Compute/samples/V1/LicensesClient/insert.php index 107cad103883..a677ca4f27e9 100644 --- a/Compute/samples/V1/LicensesClient/insert.php +++ b/Compute/samples/V1/LicensesClient/insert.php @@ -31,7 +31,10 @@ use Google\Rpc\Status; /** - * Create a License resource in the specified project. *Caution* This resource is intended for use only by third-party partners who are creating Cloud Marketplace images. + * Create a License resource in the specified project. + * *Caution* This resource is intended + * for use only by third-party partners who are creatingCloud Marketplace + * images. * * @param string $project Project ID for this request. */ diff --git a/Compute/samples/V1/LicensesClient/list.php b/Compute/samples/V1/LicensesClient/list.php index fd4de2ff50a9..35674c525728 100644 --- a/Compute/samples/V1/LicensesClient/list.php +++ b/Compute/samples/V1/LicensesClient/list.php @@ -29,7 +29,15 @@ use Google\Cloud\Compute\V1\ListLicensesRequest; /** - * Retrieves the list of licenses available in the specified project. This method does not get any licenses that belong to other projects, including licenses attached to publicly-available images, like Debian 9. If you want to get a list of publicly-available licenses, use this method to make a request to the respective image project, such as debian-cloud or windows-cloud. *Caution* This resource is intended for use only by third-party partners who are creating Cloud Marketplace images. + * Retrieves the list of licenses + * available in the specified project. This method does not + * get any licenses that belong to other projects, including licenses attached + * to publicly-available images, like Debian 9. If you want to get a list of + * publicly-available licenses, use this method to make a request to the + * respective image project, such as debian-cloud orwindows-cloud. + * *Caution* This resource is intended + * for use only by third-party partners who are creatingCloud Marketplace + * images. * * @param string $project Project ID for this request. */ diff --git a/Compute/samples/V1/LicensesClient/set_iam_policy.php b/Compute/samples/V1/LicensesClient/set_iam_policy.php index 907ed62479fb..8fea349db2e1 100644 --- a/Compute/samples/V1/LicensesClient/set_iam_policy.php +++ b/Compute/samples/V1/LicensesClient/set_iam_policy.php @@ -30,7 +30,11 @@ use Google\Cloud\Compute\V1\SetIamPolicyLicenseRequest; /** - * Sets the access control policy on the specified resource. Replaces any existing policy. *Caution* This resource is intended for use only by third-party partners who are creating Cloud Marketplace images. + * Sets the access control policy on the specified resource. + * Replaces any existing policy. + * *Caution* This resource is intended + * for use only by third-party partners who are creatingCloud Marketplace + * images. * * @param string $project Project ID for this request. * @param string $resource Name or id of the resource for this request. diff --git a/Compute/samples/V1/LicensesClient/test_iam_permissions.php b/Compute/samples/V1/LicensesClient/test_iam_permissions.php index be52030e92e0..027364d3a156 100644 --- a/Compute/samples/V1/LicensesClient/test_iam_permissions.php +++ b/Compute/samples/V1/LicensesClient/test_iam_permissions.php @@ -30,7 +30,10 @@ use Google\Cloud\Compute\V1\TestPermissionsResponse; /** - * Returns permissions that a caller has on the specified resource. *Caution* This resource is intended for use only by third-party partners who are creating Cloud Marketplace images. + * Returns permissions that a caller has on the specified resource. + * *Caution* This resource is intended + * for use only by third-party partners who are creatingCloud Marketplace + * images. * * @param string $project Project ID for this request. * @param string $resource Name or id of the resource for this request. diff --git a/Compute/samples/V1/LicensesClient/update.php b/Compute/samples/V1/LicensesClient/update.php index d1b97e0b1fff..ac62d63ced16 100644 --- a/Compute/samples/V1/LicensesClient/update.php +++ b/Compute/samples/V1/LicensesClient/update.php @@ -31,7 +31,10 @@ use Google\Rpc\Status; /** - * Updates a License resource in the specified project. *Caution* This resource is intended for use only by third-party partners who are creating Cloud Marketplace images. + * Updates a License resource in the specified project. + * *Caution* This resource is intended + * for use only by third-party partners who are creatingCloud Marketplace + * images. * * @param string $license The license name for this request. * @param string $project Project ID for this request. diff --git a/Compute/samples/V1/MachineImagesClient/delete.php b/Compute/samples/V1/MachineImagesClient/delete.php index 847e79adbf70..b0aa170c3a6f 100644 --- a/Compute/samples/V1/MachineImagesClient/delete.php +++ b/Compute/samples/V1/MachineImagesClient/delete.php @@ -30,7 +30,8 @@ use Google\Rpc\Status; /** - * Deletes the specified machine image. Deleting a machine image is permanent and cannot be undone. + * Deletes the specified machine image. Deleting a machine image is permanent + * and cannot be undone. * * @param string $machineImage The name of the machine image to delete. * @param string $project Project ID for this request. diff --git a/Compute/samples/V1/MachineImagesClient/get_iam_policy.php b/Compute/samples/V1/MachineImagesClient/get_iam_policy.php index c9c91e1e9fca..a162ab082eb3 100644 --- a/Compute/samples/V1/MachineImagesClient/get_iam_policy.php +++ b/Compute/samples/V1/MachineImagesClient/get_iam_policy.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\Policy; /** - * Gets the access control policy for a resource. May be empty if no such policy or resource exists. + * Gets the access control policy for a resource. May be empty if no such + * policy or resource exists. * * @param string $project Project ID for this request. * @param string $resource Name or id of the resource for this request. diff --git a/Compute/samples/V1/MachineImagesClient/insert.php b/Compute/samples/V1/MachineImagesClient/insert.php index f42c4f5b60bb..01b3d3f84529 100644 --- a/Compute/samples/V1/MachineImagesClient/insert.php +++ b/Compute/samples/V1/MachineImagesClient/insert.php @@ -31,7 +31,11 @@ use Google\Rpc\Status; /** - * Creates a machine image in the specified project using the data that is included in the request. If you are creating a new machine image to update an existing instance, your new machine image should use the same network or, if applicable, the same subnetwork as the original instance. + * Creates a machine image in the specified project using the + * data that is included in the request. If you are creating a new machine + * image to update an existing instance, your new machine image should use the + * same network or, if applicable, the same subnetwork as the original + * instance. * * @param string $project Project ID for this request. */ diff --git a/Compute/samples/V1/MachineImagesClient/list.php b/Compute/samples/V1/MachineImagesClient/list.php index 63865c677a31..bc048371e3d4 100644 --- a/Compute/samples/V1/MachineImagesClient/list.php +++ b/Compute/samples/V1/MachineImagesClient/list.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\ListMachineImagesRequest; /** - * Retrieves a list of machine images that are contained within the specified project. + * Retrieves a list of machine images that are contained within + * the specified project. * * @param string $project Project ID for this request. */ diff --git a/Compute/samples/V1/MachineImagesClient/set_iam_policy.php b/Compute/samples/V1/MachineImagesClient/set_iam_policy.php index 66cbc2c87658..b23a63866168 100644 --- a/Compute/samples/V1/MachineImagesClient/set_iam_policy.php +++ b/Compute/samples/V1/MachineImagesClient/set_iam_policy.php @@ -30,7 +30,8 @@ use Google\Cloud\Compute\V1\SetIamPolicyMachineImageRequest; /** - * Sets the access control policy on the specified resource. Replaces any existing policy. + * Sets the access control policy on the specified resource. + * Replaces any existing policy. * * @param string $project Project ID for this request. * @param string $resource Name or id of the resource for this request. diff --git a/Compute/samples/V1/MachineImagesClient/set_labels.php b/Compute/samples/V1/MachineImagesClient/set_labels.php index 5aa8da0cbb4e..afedef697e56 100644 --- a/Compute/samples/V1/MachineImagesClient/set_labels.php +++ b/Compute/samples/V1/MachineImagesClient/set_labels.php @@ -31,7 +31,8 @@ use Google\Rpc\Status; /** - * Sets the labels on a machine image. To learn more about labels, read the Labeling Resources documentation. + * Sets the labels on a machine image. To learn more about labels, read theLabeling + * Resources documentation. * * @param string $project Project ID for this request. * @param string $resource Name or id of the resource for this request. diff --git a/Compute/samples/V1/MachineTypesClient/aggregated_list.php b/Compute/samples/V1/MachineTypesClient/aggregated_list.php index 44c1a52f9e89..c74887c97817 100644 --- a/Compute/samples/V1/MachineTypesClient/aggregated_list.php +++ b/Compute/samples/V1/MachineTypesClient/aggregated_list.php @@ -29,7 +29,10 @@ use Google\Cloud\Compute\V1\Client\MachineTypesClient; /** - * Retrieves an aggregated list of machine types. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. + * Retrieves an aggregated list of machine types. + * + * To prevent failure, Google recommends that you set the + * `returnPartialSuccess` parameter to `true`. * * @param string $project Project ID for this request. */ diff --git a/Compute/samples/V1/MachineTypesClient/list.php b/Compute/samples/V1/MachineTypesClient/list.php index ce9be0b7056c..0363b02c4af7 100644 --- a/Compute/samples/V1/MachineTypesClient/list.php +++ b/Compute/samples/V1/MachineTypesClient/list.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\ListMachineTypesRequest; /** - * Retrieves a list of machine types available to the specified project. + * Retrieves a list of machine types available to the specified + * project. * * @param string $project Project ID for this request. * @param string $zone The name of the zone for this request. diff --git a/Compute/samples/V1/NetworkAttachmentsClient/aggregated_list.php b/Compute/samples/V1/NetworkAttachmentsClient/aggregated_list.php index d4075db38ae9..b4162e63b980 100644 --- a/Compute/samples/V1/NetworkAttachmentsClient/aggregated_list.php +++ b/Compute/samples/V1/NetworkAttachmentsClient/aggregated_list.php @@ -29,7 +29,11 @@ use Google\Cloud\Compute\V1\Client\NetworkAttachmentsClient; /** - * Retrieves the list of all NetworkAttachment resources, regional and global, available to the specified project. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. + * Retrieves the list of all NetworkAttachment resources, + * regional and global, available to the specified project. + * + * To prevent failure, Google recommends that you set the + * `returnPartialSuccess` parameter to `true`. * * @param string $project Project ID for this request. */ diff --git a/Compute/samples/V1/NetworkAttachmentsClient/get_iam_policy.php b/Compute/samples/V1/NetworkAttachmentsClient/get_iam_policy.php index 76d4c82c0353..39e04d9a08bc 100644 --- a/Compute/samples/V1/NetworkAttachmentsClient/get_iam_policy.php +++ b/Compute/samples/V1/NetworkAttachmentsClient/get_iam_policy.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\Policy; /** - * Gets the access control policy for a resource. May be empty if no such policy or resource exists. + * Gets the access control policy for a resource. May be empty if no such + * policy or resource exists. * * @param string $project Project ID for this request. * @param string $region The name of the region for this request. diff --git a/Compute/samples/V1/NetworkAttachmentsClient/insert.php b/Compute/samples/V1/NetworkAttachmentsClient/insert.php index 2d9d638ea8ad..142e53b66a45 100644 --- a/Compute/samples/V1/NetworkAttachmentsClient/insert.php +++ b/Compute/samples/V1/NetworkAttachmentsClient/insert.php @@ -31,7 +31,8 @@ use Google\Rpc\Status; /** - * Creates a NetworkAttachment in the specified project in the given scope using the parameters that are included in the request. + * Creates a NetworkAttachment in the specified project in the given scope + * using the parameters that are included in the request. * * @param string $project Project ID for this request. * @param string $region Name of the region of this request. diff --git a/Compute/samples/V1/NetworkAttachmentsClient/patch.php b/Compute/samples/V1/NetworkAttachmentsClient/patch.php index 1186a31d1c2e..25e0ebb4a33b 100644 --- a/Compute/samples/V1/NetworkAttachmentsClient/patch.php +++ b/Compute/samples/V1/NetworkAttachmentsClient/patch.php @@ -31,7 +31,10 @@ use Google\Rpc\Status; /** - * Patches the specified NetworkAttachment resource with the data included in the request. This method supports PATCH semantics and uses JSON merge patch format and processing rules. + * Patches the specified NetworkAttachment resource with the data included in + * the request. This method supports PATCH + * semantics and usesJSON merge + * patch format and processing rules. * * @param string $networkAttachment Name of the NetworkAttachment resource to patch. * @param string $project Project ID for this request. diff --git a/Compute/samples/V1/NetworkAttachmentsClient/set_iam_policy.php b/Compute/samples/V1/NetworkAttachmentsClient/set_iam_policy.php index c96b1c0f303b..010e9fcf8a2b 100644 --- a/Compute/samples/V1/NetworkAttachmentsClient/set_iam_policy.php +++ b/Compute/samples/V1/NetworkAttachmentsClient/set_iam_policy.php @@ -30,7 +30,8 @@ use Google\Cloud\Compute\V1\SetIamPolicyNetworkAttachmentRequest; /** - * Sets the access control policy on the specified resource. Replaces any existing policy. + * Sets the access control policy on the specified resource. + * Replaces any existing policy. * * @param string $project Project ID for this request. * @param string $region The name of the region for this request. diff --git a/Compute/samples/V1/NetworkEdgeSecurityServicesClient/aggregated_list.php b/Compute/samples/V1/NetworkEdgeSecurityServicesClient/aggregated_list.php index 7a389071b7f3..78b88ba42772 100644 --- a/Compute/samples/V1/NetworkEdgeSecurityServicesClient/aggregated_list.php +++ b/Compute/samples/V1/NetworkEdgeSecurityServicesClient/aggregated_list.php @@ -29,7 +29,11 @@ use Google\Cloud\Compute\V1\Client\NetworkEdgeSecurityServicesClient; /** - * Retrieves the list of all NetworkEdgeSecurityService resources available to the specified project. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. + * Retrieves the list of all NetworkEdgeSecurityService resources available to + * the specified project. + * + * To prevent failure, Google recommends that you set the + * `returnPartialSuccess` parameter to `true`. * * @param string $project Name of the project scoping this request. */ diff --git a/Compute/samples/V1/NetworkEdgeSecurityServicesClient/insert.php b/Compute/samples/V1/NetworkEdgeSecurityServicesClient/insert.php index d65e33d4ec31..e87a61393b63 100644 --- a/Compute/samples/V1/NetworkEdgeSecurityServicesClient/insert.php +++ b/Compute/samples/V1/NetworkEdgeSecurityServicesClient/insert.php @@ -31,7 +31,8 @@ use Google\Rpc\Status; /** - * Creates a new service in the specified project using the data included in the request. + * Creates a new service in the specified project using the data included in + * the request. * * @param string $project Project ID for this request. * @param string $region Name of the region scoping this request. diff --git a/Compute/samples/V1/NetworkEndpointGroupsClient/aggregated_list.php b/Compute/samples/V1/NetworkEndpointGroupsClient/aggregated_list.php index aab4287e5f39..d263b763fd00 100644 --- a/Compute/samples/V1/NetworkEndpointGroupsClient/aggregated_list.php +++ b/Compute/samples/V1/NetworkEndpointGroupsClient/aggregated_list.php @@ -29,7 +29,10 @@ use Google\Cloud\Compute\V1\Client\NetworkEndpointGroupsClient; /** - * Retrieves the list of network endpoint groups and sorts them by zone. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. + * Retrieves the list of network endpoint groups and sorts them by zone. + * + * To prevent failure, Google recommends that you set the + * `returnPartialSuccess` parameter to `true`. * * @param string $project Project ID for this request. */ diff --git a/Compute/samples/V1/NetworkEndpointGroupsClient/attach_network_endpoints.php b/Compute/samples/V1/NetworkEndpointGroupsClient/attach_network_endpoints.php index c5db4dd447bb..07b84ec10716 100644 --- a/Compute/samples/V1/NetworkEndpointGroupsClient/attach_network_endpoints.php +++ b/Compute/samples/V1/NetworkEndpointGroupsClient/attach_network_endpoints.php @@ -33,9 +33,11 @@ /** * Attach a list of network endpoints to the specified network endpoint group. * - * @param string $networkEndpointGroup The name of the network endpoint group where you are attaching network endpoints to. It should comply with RFC1035. + * @param string $networkEndpointGroup The name of the network endpoint group where you are attaching network + * endpoints to. It should comply with RFC1035. * @param string $project Project ID for this request. - * @param string $zone The name of the zone where the network endpoint group is located. It should comply with RFC1035. + * @param string $zone The name of the zone where + * the network endpoint group is located. It should comply with RFC1035. */ function attach_network_endpoints_sample( string $networkEndpointGroup, diff --git a/Compute/samples/V1/NetworkEndpointGroupsClient/delete.php b/Compute/samples/V1/NetworkEndpointGroupsClient/delete.php index 82fd32574d12..08527b15136f 100644 --- a/Compute/samples/V1/NetworkEndpointGroupsClient/delete.php +++ b/Compute/samples/V1/NetworkEndpointGroupsClient/delete.php @@ -30,11 +30,16 @@ use Google\Rpc\Status; /** - * Deletes the specified network endpoint group. The network endpoints in the NEG and the VM instances they belong to are not terminated when the NEG is deleted. Note that the NEG cannot be deleted if there are backend services referencing it. + * Deletes the specified network endpoint group. The network endpoints in the + * NEG and the VM instances they belong to are not terminated when the NEG is + * deleted. Note that the NEG cannot be deleted if there are backend services + * referencing it. * - * @param string $networkEndpointGroup The name of the network endpoint group to delete. It should comply with RFC1035. + * @param string $networkEndpointGroup The name of the network endpoint group to delete. It should comply with + * RFC1035. * @param string $project Project ID for this request. - * @param string $zone The name of the zone where the network endpoint group is located. It should comply with RFC1035. + * @param string $zone The name of the zone where + * the network endpoint group is located. It should comply with RFC1035. */ function delete_sample(string $networkEndpointGroup, string $project, string $zone): void { diff --git a/Compute/samples/V1/NetworkEndpointGroupsClient/detach_network_endpoints.php b/Compute/samples/V1/NetworkEndpointGroupsClient/detach_network_endpoints.php index 291df911dd6a..40d831d55e49 100644 --- a/Compute/samples/V1/NetworkEndpointGroupsClient/detach_network_endpoints.php +++ b/Compute/samples/V1/NetworkEndpointGroupsClient/detach_network_endpoints.php @@ -31,11 +31,14 @@ use Google\Rpc\Status; /** - * Detach a list of network endpoints from the specified network endpoint group. + * Detach a list of network endpoints from the specified network endpoint + * group. * - * @param string $networkEndpointGroup The name of the network endpoint group where you are removing network endpoints. It should comply with RFC1035. + * @param string $networkEndpointGroup The name of the network endpoint group where you are removing network + * endpoints. It should comply with RFC1035. * @param string $project Project ID for this request. - * @param string $zone The name of the zone where the network endpoint group is located. It should comply with RFC1035. + * @param string $zone The name of the zone where + * the network endpoint group is located. It should comply with RFC1035. */ function detach_network_endpoints_sample( string $networkEndpointGroup, diff --git a/Compute/samples/V1/NetworkEndpointGroupsClient/get.php b/Compute/samples/V1/NetworkEndpointGroupsClient/get.php index fd8e41265da8..ac3d59941237 100644 --- a/Compute/samples/V1/NetworkEndpointGroupsClient/get.php +++ b/Compute/samples/V1/NetworkEndpointGroupsClient/get.php @@ -33,7 +33,8 @@ * * @param string $networkEndpointGroup The name of the network endpoint group. It should comply with RFC1035. * @param string $project Project ID for this request. - * @param string $zone The name of the zone where the network endpoint group is located. It should comply with RFC1035. + * @param string $zone The name of the zone where + * the network endpoint group is located. It should comply with RFC1035. */ function get_sample(string $networkEndpointGroup, string $project, string $zone): void { diff --git a/Compute/samples/V1/NetworkEndpointGroupsClient/insert.php b/Compute/samples/V1/NetworkEndpointGroupsClient/insert.php index 52ff615237f2..26e75e5b89fc 100644 --- a/Compute/samples/V1/NetworkEndpointGroupsClient/insert.php +++ b/Compute/samples/V1/NetworkEndpointGroupsClient/insert.php @@ -31,10 +31,13 @@ use Google\Rpc\Status; /** - * Creates a network endpoint group in the specified project using the parameters that are included in the request. + * Creates a network endpoint group in the specified project using the + * parameters that are included in the request. * * @param string $project Project ID for this request. - * @param string $zone The name of the zone where you want to create the network endpoint group. It should comply with RFC1035. + * @param string $zone The name of the zone where + * you want to create the network endpoint group. It should comply with + * RFC1035. */ function insert_sample(string $project, string $zone): void { diff --git a/Compute/samples/V1/NetworkEndpointGroupsClient/list.php b/Compute/samples/V1/NetworkEndpointGroupsClient/list.php index 81f4cd736f59..22c856329410 100644 --- a/Compute/samples/V1/NetworkEndpointGroupsClient/list.php +++ b/Compute/samples/V1/NetworkEndpointGroupsClient/list.php @@ -29,10 +29,12 @@ use Google\Cloud\Compute\V1\ListNetworkEndpointGroupsRequest; /** - * Retrieves the list of network endpoint groups that are located in the specified project and zone. + * Retrieves the list of network endpoint groups that are located in the + * specified project and zone. * * @param string $project Project ID for this request. - * @param string $zone The name of the zone where the network endpoint group is located. It should comply with RFC1035. + * @param string $zone The name of thezone + * where the network endpoint group is located. It should comply with RFC1035. */ function list_sample(string $project, string $zone): void { diff --git a/Compute/samples/V1/NetworkEndpointGroupsClient/list_network_endpoints.php b/Compute/samples/V1/NetworkEndpointGroupsClient/list_network_endpoints.php index 0636631194f5..5842e8017703 100644 --- a/Compute/samples/V1/NetworkEndpointGroupsClient/list_network_endpoints.php +++ b/Compute/samples/V1/NetworkEndpointGroupsClient/list_network_endpoints.php @@ -32,9 +32,11 @@ /** * Lists the network endpoints in the specified network endpoint group. * - * @param string $networkEndpointGroup The name of the network endpoint group from which you want to generate a list of included network endpoints. It should comply with RFC1035. + * @param string $networkEndpointGroup The name of the network endpoint group from which you want to generate a + * list of included network endpoints. It should comply with RFC1035. * @param string $project Project ID for this request. - * @param string $zone The name of the zone where the network endpoint group is located. It should comply with RFC1035. + * @param string $zone The name of the zone where + * the network endpoint group is located. It should comply with RFC1035. */ function list_network_endpoints_sample( string $networkEndpointGroup, diff --git a/Compute/samples/V1/NetworkFirewallPoliciesClient/aggregated_list.php b/Compute/samples/V1/NetworkFirewallPoliciesClient/aggregated_list.php index 30e5b9ca6354..a89ad7879911 100644 --- a/Compute/samples/V1/NetworkFirewallPoliciesClient/aggregated_list.php +++ b/Compute/samples/V1/NetworkFirewallPoliciesClient/aggregated_list.php @@ -29,7 +29,12 @@ use Google\Cloud\Compute\V1\Client\NetworkFirewallPoliciesClient; /** - * Retrieves an aggregated list of network firewall policies, listing network firewall policies from all applicable scopes (global and regional) and grouping the results per scope. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. + * Retrieves an aggregated list of network firewall policies, listing network + * firewall policies from all applicable scopes (global and regional) and + * grouping the results per scope. + * + * To prevent failure, it is recommended that you set the + * `returnPartialSuccess` parameter to `true`. * * @param string $project Project ID for this request. */ diff --git a/Compute/samples/V1/NetworkFirewallPoliciesClient/get_iam_policy.php b/Compute/samples/V1/NetworkFirewallPoliciesClient/get_iam_policy.php index e4261d07c248..66038a70d6f8 100644 --- a/Compute/samples/V1/NetworkFirewallPoliciesClient/get_iam_policy.php +++ b/Compute/samples/V1/NetworkFirewallPoliciesClient/get_iam_policy.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\Policy; /** - * Gets the access control policy for a resource. May be empty if no such policy or resource exists. + * Gets the access control policy for a resource. May be empty if no such + * policy or resource exists. * * @param string $project Project ID for this request. * @param string $resource Name or id of the resource for this request. diff --git a/Compute/samples/V1/NetworkFirewallPoliciesClient/insert.php b/Compute/samples/V1/NetworkFirewallPoliciesClient/insert.php index 286da4d17b38..2599b5d03534 100644 --- a/Compute/samples/V1/NetworkFirewallPoliciesClient/insert.php +++ b/Compute/samples/V1/NetworkFirewallPoliciesClient/insert.php @@ -31,7 +31,8 @@ use Google\Rpc\Status; /** - * Creates a new policy in the specified project using the data included in the request. + * Creates a new policy in the specified project using the data included in + * the request. * * @param string $project Project ID for this request. */ diff --git a/Compute/samples/V1/NetworkFirewallPoliciesClient/set_iam_policy.php b/Compute/samples/V1/NetworkFirewallPoliciesClient/set_iam_policy.php index 154e50c3b88e..f8f1f3946b52 100644 --- a/Compute/samples/V1/NetworkFirewallPoliciesClient/set_iam_policy.php +++ b/Compute/samples/V1/NetworkFirewallPoliciesClient/set_iam_policy.php @@ -30,7 +30,8 @@ use Google\Cloud\Compute\V1\SetIamPolicyNetworkFirewallPolicyRequest; /** - * Sets the access control policy on the specified resource. Replaces any existing policy. + * Sets the access control policy on the specified resource. + * Replaces any existing policy. * * @param string $project Project ID for this request. * @param string $resource Name or id of the resource for this request. diff --git a/Compute/samples/V1/NetworkProfilesClient/list.php b/Compute/samples/V1/NetworkProfilesClient/list.php index e847498af58d..5b770f46e24e 100644 --- a/Compute/samples/V1/NetworkProfilesClient/list.php +++ b/Compute/samples/V1/NetworkProfilesClient/list.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\ListNetworkProfilesRequest; /** - * Retrieves a list of network profiles available to the specified project. + * Retrieves a list of network profiles available to the specified + * project. * * @param string $project Project ID for this request. */ diff --git a/Compute/samples/V1/NetworksClient/insert.php b/Compute/samples/V1/NetworksClient/insert.php index 91395fc0a67f..dd5d6dea8a61 100644 --- a/Compute/samples/V1/NetworksClient/insert.php +++ b/Compute/samples/V1/NetworksClient/insert.php @@ -31,7 +31,8 @@ use Google\Rpc\Status; /** - * Creates a network in the specified project using the data included in the request. + * Creates a network in the specified project using the data included + * in the request. * * @param string $project Project ID for this request. */ diff --git a/Compute/samples/V1/NetworksClient/patch.php b/Compute/samples/V1/NetworksClient/patch.php index 7da1cee27a25..9f71cad85352 100644 --- a/Compute/samples/V1/NetworksClient/patch.php +++ b/Compute/samples/V1/NetworksClient/patch.php @@ -31,7 +31,8 @@ use Google\Rpc\Status; /** - * Patches the specified network with the data included in the request. Only routingConfig can be modified. + * Patches the specified network with the data included in the request. + * Only routingConfig can be modified. * * @param string $network Name of the network to update. * @param string $project Project ID for this request. diff --git a/Compute/samples/V1/NetworksClient/request_remove_peering.php b/Compute/samples/V1/NetworksClient/request_remove_peering.php index a0dba70cb786..ac8f9c435525 100644 --- a/Compute/samples/V1/NetworksClient/request_remove_peering.php +++ b/Compute/samples/V1/NetworksClient/request_remove_peering.php @@ -31,7 +31,8 @@ use Google\Rpc\Status; /** - * Requests to remove a peering from the specified network. Applicable only for PeeringConnection with update_strategy=CONSENSUS. + * Requests to remove a peering from the specified network. Applicable only + * for PeeringConnection with update_strategy=CONSENSUS. * * @param string $network Name of the network resource to remove peering from. * @param string $project Project ID for this request. diff --git a/Compute/samples/V1/NetworksClient/update_peering.php b/Compute/samples/V1/NetworksClient/update_peering.php index b992645993c7..3c6482388fb5 100644 --- a/Compute/samples/V1/NetworksClient/update_peering.php +++ b/Compute/samples/V1/NetworksClient/update_peering.php @@ -31,7 +31,9 @@ use Google\Rpc\Status; /** - * Updates the specified network peering with the data included in the request. You can only modify the NetworkPeering.export_custom_routes field and the NetworkPeering.import_custom_routes field. + * Updates the specified network peering with the data included in the + * request. You can only modify the NetworkPeering.export_custom_routes field + * and the NetworkPeering.import_custom_routes field. * * @param string $network Name of the network resource which the updated peering is belonging to. * @param string $project Project ID for this request. diff --git a/Compute/samples/V1/NodeGroupsClient/aggregated_list.php b/Compute/samples/V1/NodeGroupsClient/aggregated_list.php index cc6aa2c9fe1e..b5d46cf91b76 100644 --- a/Compute/samples/V1/NodeGroupsClient/aggregated_list.php +++ b/Compute/samples/V1/NodeGroupsClient/aggregated_list.php @@ -29,7 +29,11 @@ use Google\Cloud\Compute\V1\Client\NodeGroupsClient; /** - * Retrieves an aggregated list of node groups. Note: use nodeGroups.listNodes for more details about each group. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. + * Retrieves an aggregated list of node groups. + * Note: use nodeGroups.listNodes for more details about each group. + * + * To prevent failure, Google recommends that you set the + * `returnPartialSuccess` parameter to `true`. * * @param string $project Project ID for this request. */ diff --git a/Compute/samples/V1/NodeGroupsClient/get.php b/Compute/samples/V1/NodeGroupsClient/get.php index 6721522f5bf0..057937449fbd 100644 --- a/Compute/samples/V1/NodeGroupsClient/get.php +++ b/Compute/samples/V1/NodeGroupsClient/get.php @@ -29,7 +29,10 @@ use Google\Cloud\Compute\V1\NodeGroup; /** - * Returns the specified NodeGroup. Get a list of available NodeGroups by making a list() request. Note: the "nodes" field should not be used. Use nodeGroups.listNodes instead. + * Returns the specified NodeGroup. Get a list of available NodeGroups + * by making a list() request. + * Note: the "nodes" field should not be used. Use nodeGroups.listNodes + * instead. * * @param string $nodeGroup Name of the node group to return. * @param string $project Project ID for this request. diff --git a/Compute/samples/V1/NodeGroupsClient/get_iam_policy.php b/Compute/samples/V1/NodeGroupsClient/get_iam_policy.php index 60d9faffd392..1eb98585e3d8 100644 --- a/Compute/samples/V1/NodeGroupsClient/get_iam_policy.php +++ b/Compute/samples/V1/NodeGroupsClient/get_iam_policy.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\Policy; /** - * Gets the access control policy for a resource. May be empty if no such policy or resource exists. + * Gets the access control policy for a resource. May be empty if no such + * policy or resource exists. * * @param string $project Project ID for this request. * @param string $resource Name or id of the resource for this request. diff --git a/Compute/samples/V1/NodeGroupsClient/insert.php b/Compute/samples/V1/NodeGroupsClient/insert.php index acbf54e8fba6..76e539718a93 100644 --- a/Compute/samples/V1/NodeGroupsClient/insert.php +++ b/Compute/samples/V1/NodeGroupsClient/insert.php @@ -31,7 +31,8 @@ use Google\Rpc\Status; /** - * Creates a NodeGroup resource in the specified project using the data included in the request. + * Creates a NodeGroup resource in the specified project using the data + * included in the request. * * @param int $initialNodeCount Initial count of nodes in the node group. * @param string $project Project ID for this request. diff --git a/Compute/samples/V1/NodeGroupsClient/list.php b/Compute/samples/V1/NodeGroupsClient/list.php index f2c4f1cabbec..879bcd736b08 100644 --- a/Compute/samples/V1/NodeGroupsClient/list.php +++ b/Compute/samples/V1/NodeGroupsClient/list.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\ListNodeGroupsRequest; /** - * Retrieves a list of node groups available to the specified project. Note: use nodeGroups.listNodes for more details about each group. + * Retrieves a list of node groups available to the specified project. + * Note: use nodeGroups.listNodes for more details about each group. * * @param string $project Project ID for this request. * @param string $zone The name of the zone for this request. diff --git a/Compute/samples/V1/NodeGroupsClient/set_iam_policy.php b/Compute/samples/V1/NodeGroupsClient/set_iam_policy.php index 065a8e29d830..bf4d92e044b7 100644 --- a/Compute/samples/V1/NodeGroupsClient/set_iam_policy.php +++ b/Compute/samples/V1/NodeGroupsClient/set_iam_policy.php @@ -30,7 +30,8 @@ use Google\Cloud\Compute\V1\ZoneSetPolicyRequest; /** - * Sets the access control policy on the specified resource. Replaces any existing policy. + * Sets the access control policy on the specified resource. + * Replaces any existing policy. * * @param string $project Project ID for this request. * @param string $resource Name or id of the resource for this request. diff --git a/Compute/samples/V1/NodeGroupsClient/simulate_maintenance_event.php b/Compute/samples/V1/NodeGroupsClient/simulate_maintenance_event.php index 7d4fe1346360..d4256d33616e 100644 --- a/Compute/samples/V1/NodeGroupsClient/simulate_maintenance_event.php +++ b/Compute/samples/V1/NodeGroupsClient/simulate_maintenance_event.php @@ -33,7 +33,8 @@ /** * Simulates maintenance event on specified nodes from the node group. * - * @param string $nodeGroup Name of the NodeGroup resource whose nodes will go under maintenance simulation. + * @param string $nodeGroup Name of the NodeGroup resource whose nodes will go under maintenance + * simulation. * @param string $project Project ID for this request. * @param string $zone The name of the zone for this request. */ diff --git a/Compute/samples/V1/NodeTemplatesClient/aggregated_list.php b/Compute/samples/V1/NodeTemplatesClient/aggregated_list.php index 1992b8235fe9..2490cb90c851 100644 --- a/Compute/samples/V1/NodeTemplatesClient/aggregated_list.php +++ b/Compute/samples/V1/NodeTemplatesClient/aggregated_list.php @@ -29,7 +29,10 @@ use Google\Cloud\Compute\V1\Client\NodeTemplatesClient; /** - * Retrieves an aggregated list of node templates. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. + * Retrieves an aggregated list of node templates. + * + * To prevent failure, Google recommends that you set the + * `returnPartialSuccess` parameter to `true`. * * @param string $project Project ID for this request. */ diff --git a/Compute/samples/V1/NodeTemplatesClient/get_iam_policy.php b/Compute/samples/V1/NodeTemplatesClient/get_iam_policy.php index 17cb2b7e33f4..f4a056402e24 100644 --- a/Compute/samples/V1/NodeTemplatesClient/get_iam_policy.php +++ b/Compute/samples/V1/NodeTemplatesClient/get_iam_policy.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\Policy; /** - * Gets the access control policy for a resource. May be empty if no such policy or resource exists. + * Gets the access control policy for a resource. May be empty if no such + * policy or resource exists. * * @param string $project Project ID for this request. * @param string $region The name of the region for this request. diff --git a/Compute/samples/V1/NodeTemplatesClient/insert.php b/Compute/samples/V1/NodeTemplatesClient/insert.php index c9b383bfd526..dbbe0cc3a890 100644 --- a/Compute/samples/V1/NodeTemplatesClient/insert.php +++ b/Compute/samples/V1/NodeTemplatesClient/insert.php @@ -31,7 +31,8 @@ use Google\Rpc\Status; /** - * Creates a NodeTemplate resource in the specified project using the data included in the request. + * Creates a NodeTemplate resource in the specified project using the data + * included in the request. * * @param string $project Project ID for this request. * @param string $region The name of the region for this request. diff --git a/Compute/samples/V1/NodeTemplatesClient/list.php b/Compute/samples/V1/NodeTemplatesClient/list.php index b93839441c9f..0de632c32bd0 100644 --- a/Compute/samples/V1/NodeTemplatesClient/list.php +++ b/Compute/samples/V1/NodeTemplatesClient/list.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\ListNodeTemplatesRequest; /** - * Retrieves a list of node templates available to the specified project. + * Retrieves a list of node templates available to the specified + * project. * * @param string $project Project ID for this request. * @param string $region The name of the region for this request. diff --git a/Compute/samples/V1/NodeTemplatesClient/set_iam_policy.php b/Compute/samples/V1/NodeTemplatesClient/set_iam_policy.php index c18c304513a1..678ad3105544 100644 --- a/Compute/samples/V1/NodeTemplatesClient/set_iam_policy.php +++ b/Compute/samples/V1/NodeTemplatesClient/set_iam_policy.php @@ -30,7 +30,8 @@ use Google\Cloud\Compute\V1\SetIamPolicyNodeTemplateRequest; /** - * Sets the access control policy on the specified resource. Replaces any existing policy. + * Sets the access control policy on the specified resource. + * Replaces any existing policy. * * @param string $project Project ID for this request. * @param string $region The name of the region for this request. diff --git a/Compute/samples/V1/NodeTypesClient/aggregated_list.php b/Compute/samples/V1/NodeTypesClient/aggregated_list.php index 636f23d564d5..f4a1da42a64c 100644 --- a/Compute/samples/V1/NodeTypesClient/aggregated_list.php +++ b/Compute/samples/V1/NodeTypesClient/aggregated_list.php @@ -29,7 +29,10 @@ use Google\Cloud\Compute\V1\Client\NodeTypesClient; /** - * Retrieves an aggregated list of node types. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. + * Retrieves an aggregated list of node types. + * + * To prevent failure, Google recommends that you set the + * `returnPartialSuccess` parameter to `true`. * * @param string $project Project ID for this request. */ diff --git a/Compute/samples/V1/NodeTypesClient/list.php b/Compute/samples/V1/NodeTypesClient/list.php index 9b0b08845474..ca5f04b32b20 100644 --- a/Compute/samples/V1/NodeTypesClient/list.php +++ b/Compute/samples/V1/NodeTypesClient/list.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\ListNodeTypesRequest; /** - * Retrieves a list of node types available to the specified project. + * Retrieves a list of node types available to the specified + * project. * * @param string $project Project ID for this request. * @param string $zone The name of the zone for this request. diff --git a/Compute/samples/V1/OrganizationSecurityPoliciesClient/add_association.php b/Compute/samples/V1/OrganizationSecurityPoliciesClient/add_association.php index 3fbaa95dd339..9edf4e88fc4b 100644 --- a/Compute/samples/V1/OrganizationSecurityPoliciesClient/add_association.php +++ b/Compute/samples/V1/OrganizationSecurityPoliciesClient/add_association.php @@ -31,7 +31,16 @@ use Google\Rpc\Status; /** - * Inserts an association for the specified security policy. This has billing implications. Projects in the hierarchy with effective hierarchical security policies will be automatically enrolled into Cloud Armor Enterprise if not already enrolled. Use of this API to modify firewall policies is deprecated. Use firewallPolicies.addAssociation instead if possible. + * Inserts an association for the specified security policy. + * + * This has billing implications. Projects in the hierarchy with effective + * hierarchical security policies will be automatically enrolled into Cloud + * Armor Enterprise if not already enrolled. + * + * Use this API to modify Cloud Armor policies. Previously, alpha and beta + * versions of this API were used to modify firewall policies. This usage is + * now disabled for most organizations. Use firewallPolicies.addAssociation + * instead. * * @param string $securityPolicy Name of the security policy to update. */ diff --git a/Compute/samples/V1/OrganizationSecurityPoliciesClient/add_rule.php b/Compute/samples/V1/OrganizationSecurityPoliciesClient/add_rule.php index 1a180a08bb2f..93bc5366e0e9 100644 --- a/Compute/samples/V1/OrganizationSecurityPoliciesClient/add_rule.php +++ b/Compute/samples/V1/OrganizationSecurityPoliciesClient/add_rule.php @@ -33,6 +33,10 @@ /** * Inserts a rule into a security policy. * + * Use this API to modify Cloud Armor policies. Previously, alpha and beta + * versions of this API were used to modify firewall policies. This usage is + * now disabled for most organizations. Use firewallPolicies.addRule instead. + * * @param string $securityPolicy Name of the security policy to update. */ function add_rule_sample(string $securityPolicy): void diff --git a/Compute/samples/V1/OrganizationSecurityPoliciesClient/copy_rules.php b/Compute/samples/V1/OrganizationSecurityPoliciesClient/copy_rules.php index 2a74fa4f87c1..4b1fac644504 100644 --- a/Compute/samples/V1/OrganizationSecurityPoliciesClient/copy_rules.php +++ b/Compute/samples/V1/OrganizationSecurityPoliciesClient/copy_rules.php @@ -30,7 +30,12 @@ use Google\Rpc\Status; /** - * Copies rules to the specified security policy. Use of this API to modify firewall policies is deprecated. Use firewallPolicies.copyRules instead. + * Copies rules to the specified security policy. + * + * Use this API to modify Cloud Armor policies. Previously, alpha and beta + * versions of this API were used to modify firewall policies. This usage is + * now disabled for most organizations. Use firewallPolicies.cloneRules + * instead. * * @param string $securityPolicy Name of the security policy to update. */ diff --git a/Compute/samples/V1/OrganizationSecurityPoliciesClient/delete.php b/Compute/samples/V1/OrganizationSecurityPoliciesClient/delete.php index 015e6a30008e..53f9ccc89f08 100644 --- a/Compute/samples/V1/OrganizationSecurityPoliciesClient/delete.php +++ b/Compute/samples/V1/OrganizationSecurityPoliciesClient/delete.php @@ -30,7 +30,11 @@ use Google\Rpc\Status; /** - * Deletes the specified policy. Use of this API to remove firewall policies is deprecated. Use firewallPolicies.delete instead. + * Deletes the specified policy. + * + * Use this API to remove Cloud Armor policies. Previously, alpha and beta + * versions of this API were used to remove firewall policies. This usage is + * now disabled for most organizations. Use firewallPolicies.delete instead. * * @param string $securityPolicy Name of the security policy to delete. */ diff --git a/Compute/samples/V1/OrganizationSecurityPoliciesClient/get.php b/Compute/samples/V1/OrganizationSecurityPoliciesClient/get.php index bedce100f3bd..baff75d13632 100644 --- a/Compute/samples/V1/OrganizationSecurityPoliciesClient/get.php +++ b/Compute/samples/V1/OrganizationSecurityPoliciesClient/get.php @@ -29,7 +29,11 @@ use Google\Cloud\Compute\V1\SecurityPolicy; /** - * List all of the ordered rules present in a single specified policy. Use of this API to read firewall policies is deprecated. Use firewallPolicies.get instead. + * List all of the ordered rules present in a single specified policy. + * + * Use this API to read Cloud Armor policies. Previously, alpha and beta + * versions of this API were used to read firewall policies. This usage is now + * disabled for most organizations. Use firewallPolicies.get instead. * * @param string $securityPolicy Name of the security policy to get. */ diff --git a/Compute/samples/V1/OrganizationSecurityPoliciesClient/get_association.php b/Compute/samples/V1/OrganizationSecurityPoliciesClient/get_association.php index 51c645acdd0f..e4560a0c287c 100644 --- a/Compute/samples/V1/OrganizationSecurityPoliciesClient/get_association.php +++ b/Compute/samples/V1/OrganizationSecurityPoliciesClient/get_association.php @@ -29,7 +29,12 @@ use Google\Cloud\Compute\V1\SecurityPolicyAssociation; /** - * Gets an association with the specified name. Use of this API to read firewall policies is deprecated. Use firewallPolicies.getAssociation instead if possible. + * Gets an association with the specified name. + * + * Use this API to read Cloud Armor policies. Previously, alpha and beta + * versions of this API were used to read firewall policies. This usage is + * now disabled for most organizations. Use firewallPolicies.getAssociation + * instead. * * @param string $securityPolicy Name of the security policy to which the queried rule belongs. */ diff --git a/Compute/samples/V1/OrganizationSecurityPoliciesClient/get_rule.php b/Compute/samples/V1/OrganizationSecurityPoliciesClient/get_rule.php index 145397d81ccc..034972bc0972 100644 --- a/Compute/samples/V1/OrganizationSecurityPoliciesClient/get_rule.php +++ b/Compute/samples/V1/OrganizationSecurityPoliciesClient/get_rule.php @@ -29,7 +29,11 @@ use Google\Cloud\Compute\V1\SecurityPolicyRule; /** - * Gets a rule at the specified priority. Use of this API to read firewall policies is deprecated. Use firewallPolicies.getRule instead. + * Gets a rule at the specified priority. + * + * Use this API to read Cloud Armor policies. Previously, alpha and beta + * versions of this API were used to read firewall policies. This usage is now + * disabled for most organizations. Use firewallPolicies.getRule instead. * * @param string $securityPolicy Name of the security policy to which the queried rule belongs. */ diff --git a/Compute/samples/V1/OrganizationSecurityPoliciesClient/insert.php b/Compute/samples/V1/OrganizationSecurityPoliciesClient/insert.php index 577f7808737a..9306fc7079b0 100644 --- a/Compute/samples/V1/OrganizationSecurityPoliciesClient/insert.php +++ b/Compute/samples/V1/OrganizationSecurityPoliciesClient/insert.php @@ -31,7 +31,12 @@ use Google\Rpc\Status; /** - * Creates a new policy in the specified project using the data included in the request. Use of this API to insert firewall policies is deprecated. Use firewallPolicies.insert instead. + * Creates a new policy in the specified organization using the data included + * in the request. + * + * Use this API to add Cloud Armor policies. Previously, alpha and beta + * versions of this API were used to add firewall policies. This usage is now + * disabled for most organizations. Use firewallPolicies.insert instead. * * This sample has been automatically generated and should be regarded as a code * template only. It will require modifications to work: diff --git a/Compute/samples/V1/OrganizationSecurityPoliciesClient/list.php b/Compute/samples/V1/OrganizationSecurityPoliciesClient/list.php index abe76743a781..950b51ddc87d 100644 --- a/Compute/samples/V1/OrganizationSecurityPoliciesClient/list.php +++ b/Compute/samples/V1/OrganizationSecurityPoliciesClient/list.php @@ -29,7 +29,12 @@ use Google\Cloud\Compute\V1\ListOrganizationSecurityPoliciesRequest; /** - * List all the policies that have been configured for the specified project. Use of this API to read firewall policies is deprecated. Use firewallPolicies.list instead. + * List all the policies that have been configured for the specified + * organization. + * + * Use this API to read Cloud Armor policies. Previously, alpha and beta + * versions of this API were used to read firewall policies. This usage is now + * disabled for most organizations. Use firewallPolicies.list instead. * * This sample has been automatically generated and should be regarded as a code * template only. It will require modifications to work: diff --git a/Compute/samples/V1/OrganizationSecurityPoliciesClient/list_associations.php b/Compute/samples/V1/OrganizationSecurityPoliciesClient/list_associations.php index 12bb673399e7..aa432d477d1f 100644 --- a/Compute/samples/V1/OrganizationSecurityPoliciesClient/list_associations.php +++ b/Compute/samples/V1/OrganizationSecurityPoliciesClient/list_associations.php @@ -29,7 +29,12 @@ use Google\Cloud\Compute\V1\OrganizationSecurityPoliciesListAssociationsResponse; /** - * Lists associations of a specified target, i.e., organization or folder. Use of this API to read firewall policies is deprecated. Use firewallPolicies.listAssociations instead if possible. + * Lists associations of a specified target, i.e., organization or folder. + * + * Use this API to read Cloud Armor policies. Previously, alpha and beta + * versions of this API were used to read firewall policies. This usage is + * now disabled for most organizations. Use firewallPolicies.listAssociations + * instead. * * This sample has been automatically generated and should be regarded as a code * template only. It will require modifications to work: diff --git a/Compute/samples/V1/OrganizationSecurityPoliciesClient/list_preconfigured_expression_sets.php b/Compute/samples/V1/OrganizationSecurityPoliciesClient/list_preconfigured_expression_sets.php index 48415579ed44..5a9d1f0b2eb4 100644 --- a/Compute/samples/V1/OrganizationSecurityPoliciesClient/list_preconfigured_expression_sets.php +++ b/Compute/samples/V1/OrganizationSecurityPoliciesClient/list_preconfigured_expression_sets.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\SecurityPoliciesListPreconfiguredExpressionSetsResponse; /** - * Gets the current list of preconfigured Web Application Firewall (WAF) expressions. + * Gets the current list of preconfigured Web Application Firewall (WAF) + * expressions. * * This sample has been automatically generated and should be regarded as a code * template only. It will require modifications to work: diff --git a/Compute/samples/V1/OrganizationSecurityPoliciesClient/move.php b/Compute/samples/V1/OrganizationSecurityPoliciesClient/move.php index 18f887c036e7..c0d2da215701 100644 --- a/Compute/samples/V1/OrganizationSecurityPoliciesClient/move.php +++ b/Compute/samples/V1/OrganizationSecurityPoliciesClient/move.php @@ -30,7 +30,11 @@ use Google\Rpc\Status; /** - * Moves the specified security policy. Use of this API to modify firewall policies is deprecated. Use firewallPolicies.move instead. + * Moves the specified security policy. + * + * Use this API to modify Cloud Armor policies. Previously, alpha and beta + * versions of this API were used to modify firewall policies. This usage is + * now disabled for most organizations. Use firewallPolicies.move instead. * * @param string $securityPolicy Name of the security policy to update. */ diff --git a/Compute/samples/V1/OrganizationSecurityPoliciesClient/patch.php b/Compute/samples/V1/OrganizationSecurityPoliciesClient/patch.php index c87975f11cf2..ec5e248b7439 100644 --- a/Compute/samples/V1/OrganizationSecurityPoliciesClient/patch.php +++ b/Compute/samples/V1/OrganizationSecurityPoliciesClient/patch.php @@ -31,7 +31,11 @@ use Google\Rpc\Status; /** - * Patches the specified policy with the data included in the request. Use of this API to modify firewall policies is deprecated. Use firewallPolicies.patch instead. + * Patches the specified policy with the data included in the request. + * + * Use this API to modify Cloud Armor policies. Previously, alpha and beta + * versions of this API were used to modify firewall policies. This usage is + * now disabled for most organizations. Use firewallPolicies.patch instead. * * @param string $securityPolicy Name of the security policy to update. */ diff --git a/Compute/samples/V1/OrganizationSecurityPoliciesClient/patch_rule.php b/Compute/samples/V1/OrganizationSecurityPoliciesClient/patch_rule.php index 0e72ba367904..44b3c91c2c2e 100644 --- a/Compute/samples/V1/OrganizationSecurityPoliciesClient/patch_rule.php +++ b/Compute/samples/V1/OrganizationSecurityPoliciesClient/patch_rule.php @@ -31,7 +31,12 @@ use Google\Rpc\Status; /** - * Patches a rule at the specified priority. Use of this API to modify firewall policies is deprecated. Use firewallPolicies.patchRule instead. + * Patches a rule at the specified priority. + * + * Use this API to modify Cloud Armor policies. Previously, alpha and beta + * versions of this API were used to modify firewall policies. This usage is + * now disabled for most organizations. Use firewallPolicies.patchRule + * instead. * * @param string $securityPolicy Name of the security policy to update. */ diff --git a/Compute/samples/V1/OrganizationSecurityPoliciesClient/remove_association.php b/Compute/samples/V1/OrganizationSecurityPoliciesClient/remove_association.php index 5a5108989b23..bc80a2fe5274 100644 --- a/Compute/samples/V1/OrganizationSecurityPoliciesClient/remove_association.php +++ b/Compute/samples/V1/OrganizationSecurityPoliciesClient/remove_association.php @@ -30,7 +30,12 @@ use Google\Rpc\Status; /** - * Removes an association for the specified security policy. Use of this API to modify firewall policies is deprecated. Use firewallPolicies.removeAssociation instead if possible. + * Removes an association for the specified security policy. + * + * Use this API to modify Cloud Armor policies. Previously, alpha and beta + * versions of this API were used to modify firewall policies. This usage is + * now disabled for most organizations. Use firewallPolicies.removeAssociation + * instead. * * @param string $securityPolicy Name of the security policy to update. */ diff --git a/Compute/samples/V1/OrganizationSecurityPoliciesClient/remove_rule.php b/Compute/samples/V1/OrganizationSecurityPoliciesClient/remove_rule.php index 9fcda08d1083..6844c36bfee8 100644 --- a/Compute/samples/V1/OrganizationSecurityPoliciesClient/remove_rule.php +++ b/Compute/samples/V1/OrganizationSecurityPoliciesClient/remove_rule.php @@ -32,6 +32,11 @@ /** * Deletes a rule at the specified priority. * + * Use this API to modify Cloud Armor policies. Previously, alpha and beta + * versions of this API were used to modify firewall policies. This usage is + * now disabled for most organizations. Use firewallPolicies.removeRule + * instead. + * * @param string $securityPolicy Name of the security policy to update. */ function remove_rule_sample(string $securityPolicy): void diff --git a/Compute/samples/V1/PacketMirroringsClient/aggregated_list.php b/Compute/samples/V1/PacketMirroringsClient/aggregated_list.php index 620125087267..eedba74b39a2 100644 --- a/Compute/samples/V1/PacketMirroringsClient/aggregated_list.php +++ b/Compute/samples/V1/PacketMirroringsClient/aggregated_list.php @@ -29,7 +29,10 @@ use Google\Cloud\Compute\V1\Client\PacketMirroringsClient; /** - * Retrieves an aggregated list of packetMirrorings. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. + * Retrieves an aggregated list of packetMirrorings. + * + * To prevent failure, Google recommends that you set the + * `returnPartialSuccess` parameter to `true`. * * @param string $project Project ID for this request. */ diff --git a/Compute/samples/V1/PacketMirroringsClient/insert.php b/Compute/samples/V1/PacketMirroringsClient/insert.php index c27ac3360b5a..d88d73d44c6e 100644 --- a/Compute/samples/V1/PacketMirroringsClient/insert.php +++ b/Compute/samples/V1/PacketMirroringsClient/insert.php @@ -31,7 +31,8 @@ use Google\Rpc\Status; /** - * Creates a PacketMirroring resource in the specified project and region using the data included in the request. + * Creates a PacketMirroring resource in the specified project and region + * using the data included in the request. * * @param string $project Project ID for this request. * @param string $region Name of the region for this request. diff --git a/Compute/samples/V1/PacketMirroringsClient/list.php b/Compute/samples/V1/PacketMirroringsClient/list.php index 301a32da93b3..2dea1ecda5d6 100644 --- a/Compute/samples/V1/PacketMirroringsClient/list.php +++ b/Compute/samples/V1/PacketMirroringsClient/list.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\ListPacketMirroringsRequest; /** - * Retrieves a list of PacketMirroring resources available to the specified project and region. + * Retrieves a list of PacketMirroring resources available to the specified + * project and region. * * @param string $project Project ID for this request. * @param string $region Name of the region for this request. diff --git a/Compute/samples/V1/PacketMirroringsClient/patch.php b/Compute/samples/V1/PacketMirroringsClient/patch.php index 76f9d658c044..ffc261568ade 100644 --- a/Compute/samples/V1/PacketMirroringsClient/patch.php +++ b/Compute/samples/V1/PacketMirroringsClient/patch.php @@ -31,7 +31,10 @@ use Google\Rpc\Status; /** - * Patches the specified PacketMirroring resource with the data included in the request. This method supports PATCH semantics and uses JSON merge patch format and processing rules. + * Patches the specified PacketMirroring resource with the data included in + * the request. This method supportsPATCH + * semantics and usesJSON merge + * patch format and processing rules. * * @param string $packetMirroring Name of the PacketMirroring resource to patch. * @param string $project Project ID for this request. diff --git a/Compute/samples/V1/PreviewFeaturesClient/update.php b/Compute/samples/V1/PreviewFeaturesClient/update.php index 10f53403e9bf..38a36a59f5b5 100644 --- a/Compute/samples/V1/PreviewFeaturesClient/update.php +++ b/Compute/samples/V1/PreviewFeaturesClient/update.php @@ -31,7 +31,8 @@ use Google\Rpc\Status; /** - * Patches the given PreviewFeature. This method is used to enable or disable a PreviewFeature. + * Patches the given PreviewFeature. This method is used to enable or disable + * a PreviewFeature. * * @param string $previewFeature Name of the PreviewFeature for this request. * @param string $project Project ID for this request. diff --git a/Compute/samples/V1/ProjectsClient/disable_xpn_resource.php b/Compute/samples/V1/ProjectsClient/disable_xpn_resource.php index 033537965a4d..df5d028002e6 100644 --- a/Compute/samples/V1/ProjectsClient/disable_xpn_resource.php +++ b/Compute/samples/V1/ProjectsClient/disable_xpn_resource.php @@ -31,7 +31,8 @@ use Google\Rpc\Status; /** - * Disable a service resource (also known as service project) associated with this host project. + * Disable a service resource (also known as service project) associated with + * this host project. * * @param string $project Project ID for this request. */ diff --git a/Compute/samples/V1/ProjectsClient/enable_xpn_resource.php b/Compute/samples/V1/ProjectsClient/enable_xpn_resource.php index 809277a8bdb0..2b09285c8a05 100644 --- a/Compute/samples/V1/ProjectsClient/enable_xpn_resource.php +++ b/Compute/samples/V1/ProjectsClient/enable_xpn_resource.php @@ -31,7 +31,9 @@ use Google\Rpc\Status; /** - * Enable service resource (a.k.a service project) for a host project, so that subnets in the host project can be used by instances in the service project. + * Enable service resource (a.k.a service project) for a host project, so that + * subnets in the host project can be used by instances in the service + * project. * * @param string $project Project ID for this request. */ diff --git a/Compute/samples/V1/ProjectsClient/get.php b/Compute/samples/V1/ProjectsClient/get.php index d88296131b81..1c9927941322 100644 --- a/Compute/samples/V1/ProjectsClient/get.php +++ b/Compute/samples/V1/ProjectsClient/get.php @@ -29,7 +29,15 @@ use Google\Cloud\Compute\V1\Project; /** - * Returns the specified Project resource. To decrease latency for this method, you can optionally omit any unneeded information from the response by using a field mask. This practice is especially recommended for unused quota information (the `quotas` field). To exclude one or more fields, set your request's `fields` query parameter to only include the fields you need. For example, to only include the `id` and `selfLink` fields, add the query parameter `?fields=id,selfLink` to your request. + * Returns the specified Project resource. + * + * To decrease latency for this method, you can optionally omit any unneeded + * information from the response by using a field mask. This practice is + * especially recommended for unused quota information (the `quotas` field). + * To exclude one or more fields, set your request's `fields` query parameter + * to only include the fields you need. For example, to only include the `id` + * and `selfLink` fields, add the query parameter `?fields=id,selfLink` to + * your request. * * @param string $project Project ID for this request. */ diff --git a/Compute/samples/V1/ProjectsClient/get_xpn_host.php b/Compute/samples/V1/ProjectsClient/get_xpn_host.php index bb068eff35dd..a64b7cbb4b74 100644 --- a/Compute/samples/V1/ProjectsClient/get_xpn_host.php +++ b/Compute/samples/V1/ProjectsClient/get_xpn_host.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\Project; /** - * Gets the shared VPC host project that this project links to. May be empty if no link exists. + * Gets the shared VPC host project that this project links to. May be empty + * if no link exists. * * @param string $project Project ID for this request. */ diff --git a/Compute/samples/V1/ProjectsClient/get_xpn_resources.php b/Compute/samples/V1/ProjectsClient/get_xpn_resources.php index d84f1a1017e8..b46891293a5f 100644 --- a/Compute/samples/V1/ProjectsClient/get_xpn_resources.php +++ b/Compute/samples/V1/ProjectsClient/get_xpn_resources.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\GetXpnResourcesProjectsRequest; /** - * Gets service resources (a.k.a service project) associated with this host project. + * Gets service resources (a.k.a service project) associated with this host + * project. * * @param string $project Project ID for this request. */ diff --git a/Compute/samples/V1/ProjectsClient/move_disk.php b/Compute/samples/V1/ProjectsClient/move_disk.php index 966991c847e8..8f64267c25fe 100644 --- a/Compute/samples/V1/ProjectsClient/move_disk.php +++ b/Compute/samples/V1/ProjectsClient/move_disk.php @@ -31,7 +31,20 @@ use Google\Rpc\Status; /** - * Starting September 29, 2025, you can't use the moveDisk API on new projects. To move a disk to a different region or zone, follow the steps in [Change the location of a disk](https://{$universe.dns_names.final_documentation_domain}/compute/docs/disks/migrate-to-hyperdisk#migrate-to-hd). Projects that already use the moveDisk API can continue usage until September 29, 2026. Starting November 1, 2025, API responses will include a warning message in the response body about the upcoming deprecation. You can skip the message to continue using the service without interruption. + * Moves a persistent disk from one zone to another. + * *Note*: The moveDisk API will be deprecated on September 29, 2026. + * + * Starting September 29, 2025, you can't use the moveDisk API on new + * projects. To move a disk to a different region or zone, follow the steps in + * [Change the location of a + * disk](https://cloud.google.com/compute/docs/disks/migrate-to-hyperdisk#migrate-to-hd). + * + * Projects that already use the moveDisk API can continue usage until + * September 29, 2026. + * + * Starting November 1, 2025, API responses will include a warning message in + * the response body about the upcoming deprecation. You can skip the message + * to continue using the service without interruption. * * @param string $project Project ID for this request. */ diff --git a/Compute/samples/V1/ProjectsClient/move_instance.php b/Compute/samples/V1/ProjectsClient/move_instance.php index e641675e7dde..1ee139aa5a0b 100644 --- a/Compute/samples/V1/ProjectsClient/move_instance.php +++ b/Compute/samples/V1/ProjectsClient/move_instance.php @@ -31,7 +31,13 @@ use Google\Rpc\Status; /** - * Moves an instance and its attached persistent disks from one zone to another. *Note*: Moving VMs or disks by using this method might cause unexpected behavior. For more information, see the [known issue](/compute/docs/troubleshooting/known-issues#moving_vms_or_disks_using_the_moveinstance_api_or_the_causes_unexpected_behavior). [Deprecated] This method is deprecated. See [moving instance across zones](/compute/docs/instances/moving-instance-across-zones) instead. + * Moves an instance and its attached persistent disks from one zone to + * another. + * *Note*: Moving VMs or disks by using this method might + * cause unexpected behavior. For more information, see the [known + * issue](/compute/docs/troubleshooting/known-issues#moving_vms_or_disks_using_the_moveinstance_api_or_the_causes_unexpected_behavior). + * [Deprecated] This method is deprecated. See [moving instance across + * zones](/compute/docs/instances/moving-instance-across-zones) instead. * * @param string $project Project ID for this request. */ diff --git a/Compute/samples/V1/ProjectsClient/set_cloud_armor_tier.php b/Compute/samples/V1/ProjectsClient/set_cloud_armor_tier.php index de4cbfb92b96..4e2051d5810e 100644 --- a/Compute/samples/V1/ProjectsClient/set_cloud_armor_tier.php +++ b/Compute/samples/V1/ProjectsClient/set_cloud_armor_tier.php @@ -31,7 +31,10 @@ use Google\Rpc\Status; /** - * Sets the Cloud Armor tier of the project. To set ENTERPRISE or above the billing account of the project must be subscribed to Cloud Armor Enterprise. See Subscribing to Cloud Armor Enterprise for more information. + * Sets the Cloud Armor tier of the project. To set ENTERPRISE or above the + * billing account of the project must be subscribed to Cloud Armor + * Enterprise. See Subscribing + * to Cloud Armor Enterprise for more information. * * @param string $project Project ID for this request. */ diff --git a/Compute/samples/V1/ProjectsClient/set_common_instance_metadata.php b/Compute/samples/V1/ProjectsClient/set_common_instance_metadata.php index fb54a1da871e..7aa6f7d7048a 100644 --- a/Compute/samples/V1/ProjectsClient/set_common_instance_metadata.php +++ b/Compute/samples/V1/ProjectsClient/set_common_instance_metadata.php @@ -31,7 +31,8 @@ use Google\Rpc\Status; /** - * Sets metadata common to all instances within the specified project using the data included in the request. + * Sets metadata common to all instances within the specified project using + * the data included in the request. * * @param string $project Project ID for this request. */ diff --git a/Compute/samples/V1/ProjectsClient/set_default_network_tier.php b/Compute/samples/V1/ProjectsClient/set_default_network_tier.php index 71d062693b51..d7e8c53101b9 100644 --- a/Compute/samples/V1/ProjectsClient/set_default_network_tier.php +++ b/Compute/samples/V1/ProjectsClient/set_default_network_tier.php @@ -31,7 +31,9 @@ use Google\Rpc\Status; /** - * Sets the default network tier of the project. The default network tier is used when an address/forwardingRule/instance is created without specifying the network tier field. + * Sets the default network tier of the project. The default network tier is + * used when an address/forwardingRule/instance is created without specifying + * the network tier field. * * @param string $project Project ID for this request. */ diff --git a/Compute/samples/V1/ProjectsClient/set_usage_export_bucket.php b/Compute/samples/V1/ProjectsClient/set_usage_export_bucket.php index e46730fcd647..4500efc7eb99 100644 --- a/Compute/samples/V1/ProjectsClient/set_usage_export_bucket.php +++ b/Compute/samples/V1/ProjectsClient/set_usage_export_bucket.php @@ -31,7 +31,9 @@ use Google\Rpc\Status; /** - * Enables the usage export feature and sets the usage export bucket where reports are stored. If you provide an empty request body using this method, the usage export feature will be disabled. + * Enables the usage export feature and sets theusage export bucket + * where reports are stored. If you provide an empty request body using this + * method, the usage export feature will be disabled. * * @param string $project Project ID for this request. */ diff --git a/Compute/samples/V1/PublicAdvertisedPrefixesClient/insert.php b/Compute/samples/V1/PublicAdvertisedPrefixesClient/insert.php index 9ed715ee6eaa..d2eeedcde84c 100644 --- a/Compute/samples/V1/PublicAdvertisedPrefixesClient/insert.php +++ b/Compute/samples/V1/PublicAdvertisedPrefixesClient/insert.php @@ -31,7 +31,8 @@ use Google\Rpc\Status; /** - * Creates a PublicAdvertisedPrefix in the specified project using the parameters that are included in the request. + * Creates a PublicAdvertisedPrefix in the specified project + * using the parameters that are included in the request. * * @param string $project Project ID for this request. */ diff --git a/Compute/samples/V1/PublicAdvertisedPrefixesClient/patch.php b/Compute/samples/V1/PublicAdvertisedPrefixesClient/patch.php index 3a2f7195d87b..149523c07df0 100644 --- a/Compute/samples/V1/PublicAdvertisedPrefixesClient/patch.php +++ b/Compute/samples/V1/PublicAdvertisedPrefixesClient/patch.php @@ -31,7 +31,10 @@ use Google\Rpc\Status; /** - * Patches the specified Router resource with the data included in the request. This method supports PATCH semantics and uses JSON merge patch format and processing rules. + * Patches the specified Router resource with the data included in the + * request. This method supportsPATCH + * semantics and usesJSON merge + * patch format and processing rules. * * @param string $project Project ID for this request. * @param string $publicAdvertisedPrefix Name of the PublicAdvertisedPrefix resource to patch. diff --git a/Compute/samples/V1/PublicDelegatedPrefixesClient/aggregated_list.php b/Compute/samples/V1/PublicDelegatedPrefixesClient/aggregated_list.php index 93f101a8fcd2..34fb63352294 100644 --- a/Compute/samples/V1/PublicDelegatedPrefixesClient/aggregated_list.php +++ b/Compute/samples/V1/PublicDelegatedPrefixesClient/aggregated_list.php @@ -29,7 +29,11 @@ use Google\Cloud\Compute\V1\Client\PublicDelegatedPrefixesClient; /** - * Lists all PublicDelegatedPrefix resources owned by the specific project across all scopes. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. + * Lists all PublicDelegatedPrefix resources owned by the specific project + * across all scopes. + * + * To prevent failure, Google recommends that you set the + * `returnPartialSuccess` parameter to `true`. * * @param string $project Name of the project scoping this request. */ diff --git a/Compute/samples/V1/PublicDelegatedPrefixesClient/announce.php b/Compute/samples/V1/PublicDelegatedPrefixesClient/announce.php index ad420813eba0..e04a060bf521 100644 --- a/Compute/samples/V1/PublicDelegatedPrefixesClient/announce.php +++ b/Compute/samples/V1/PublicDelegatedPrefixesClient/announce.php @@ -34,7 +34,8 @@ * * @param string $project Project ID for this request. * @param string $publicDelegatedPrefix The name of the public delegated prefix. It should comply with RFC1035. - * @param string $region The name of the region where the public delegated prefix is located. It should comply with RFC1035. + * @param string $region The name of theregion where + * the public delegated prefix is located. It should comply with RFC1035. */ function announce_sample(string $project, string $publicDelegatedPrefix, string $region): void { diff --git a/Compute/samples/V1/PublicDelegatedPrefixesClient/insert.php b/Compute/samples/V1/PublicDelegatedPrefixesClient/insert.php index 75bc37c24bee..48c69e01297c 100644 --- a/Compute/samples/V1/PublicDelegatedPrefixesClient/insert.php +++ b/Compute/samples/V1/PublicDelegatedPrefixesClient/insert.php @@ -31,7 +31,8 @@ use Google\Rpc\Status; /** - * Creates a PublicDelegatedPrefix in the specified project in the given region using the parameters that are included in the request. + * Creates a PublicDelegatedPrefix in the specified project in the given + * region using the parameters that are included in the request. * * @param string $project Project ID for this request. * @param string $region Name of the region of this request. diff --git a/Compute/samples/V1/PublicDelegatedPrefixesClient/patch.php b/Compute/samples/V1/PublicDelegatedPrefixesClient/patch.php index e6fc9de3d0f8..8e54afb608de 100644 --- a/Compute/samples/V1/PublicDelegatedPrefixesClient/patch.php +++ b/Compute/samples/V1/PublicDelegatedPrefixesClient/patch.php @@ -31,7 +31,10 @@ use Google\Rpc\Status; /** - * Patches the specified PublicDelegatedPrefix resource with the data included in the request. This method supports PATCH semantics and uses JSON merge patch format and processing rules. + * Patches the specified PublicDelegatedPrefix resource with the data included + * in the request. This method supportsPATCH + * semantics and usesJSON merge + * patch format and processing rules. * * @param string $project Project ID for this request. * @param string $publicDelegatedPrefix Name of the PublicDelegatedPrefix resource to patch. diff --git a/Compute/samples/V1/PublicDelegatedPrefixesClient/withdraw.php b/Compute/samples/V1/PublicDelegatedPrefixesClient/withdraw.php index a25045da240e..03177b5742b0 100644 --- a/Compute/samples/V1/PublicDelegatedPrefixesClient/withdraw.php +++ b/Compute/samples/V1/PublicDelegatedPrefixesClient/withdraw.php @@ -34,7 +34,8 @@ * * @param string $project Project ID for this request. * @param string $publicDelegatedPrefix The name of the public delegated prefix. It should comply with RFC1035. - * @param string $region The name of the region where the public delegated prefix is located. It should comply with RFC1035. + * @param string $region The name of theregion where + * the public delegated prefix is located. It should comply with RFC1035. */ function withdraw_sample(string $project, string $publicDelegatedPrefix, string $region): void { diff --git a/Compute/samples/V1/RegionAutoscalersClient/insert.php b/Compute/samples/V1/RegionAutoscalersClient/insert.php index c534ede42954..15f485cb5ad3 100644 --- a/Compute/samples/V1/RegionAutoscalersClient/insert.php +++ b/Compute/samples/V1/RegionAutoscalersClient/insert.php @@ -31,7 +31,8 @@ use Google\Rpc\Status; /** - * Creates an autoscaler in the specified project using the data included in the request. + * Creates an autoscaler in the specified project using + * the data included in the request. * * @param string $project Project ID for this request. * @param string $region Name of the region scoping this request. diff --git a/Compute/samples/V1/RegionAutoscalersClient/list.php b/Compute/samples/V1/RegionAutoscalersClient/list.php index a43395f41a51..8d5f4435f701 100644 --- a/Compute/samples/V1/RegionAutoscalersClient/list.php +++ b/Compute/samples/V1/RegionAutoscalersClient/list.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\ListRegionAutoscalersRequest; /** - * Retrieves a list of autoscalers contained within the specified region. + * Retrieves a list of autoscalers contained within + * the specified region. * * @param string $project Project ID for this request. * @param string $region Name of the region scoping this request. diff --git a/Compute/samples/V1/RegionAutoscalersClient/patch.php b/Compute/samples/V1/RegionAutoscalersClient/patch.php index 39898737e535..65ee8d6c0670 100644 --- a/Compute/samples/V1/RegionAutoscalersClient/patch.php +++ b/Compute/samples/V1/RegionAutoscalersClient/patch.php @@ -31,7 +31,10 @@ use Google\Rpc\Status; /** - * Updates an autoscaler in the specified project using the data included in the request. This method supports PATCH semantics and uses the JSON merge patch format and processing rules. + * Updates an autoscaler in the specified project using + * the data included in the request. This method supportsPATCH + * semantics and uses theJSON merge + * patch format and processing rules. * * @param string $project Project ID for this request. * @param string $region Name of the region scoping this request. diff --git a/Compute/samples/V1/RegionAutoscalersClient/update.php b/Compute/samples/V1/RegionAutoscalersClient/update.php index 36413f6badb1..3714a09f46e7 100644 --- a/Compute/samples/V1/RegionAutoscalersClient/update.php +++ b/Compute/samples/V1/RegionAutoscalersClient/update.php @@ -31,7 +31,8 @@ use Google\Rpc\Status; /** - * Updates an autoscaler in the specified project using the data included in the request. + * Updates an autoscaler in the specified project using + * the data included in the request. * * @param string $project Project ID for this request. * @param string $region Name of the region scoping this request. diff --git a/Compute/samples/V1/RegionBackendServicesClient/get_health.php b/Compute/samples/V1/RegionBackendServicesClient/get_health.php index 3d01a1016f5e..dd3d42d6c12b 100644 --- a/Compute/samples/V1/RegionBackendServicesClient/get_health.php +++ b/Compute/samples/V1/RegionBackendServicesClient/get_health.php @@ -30,7 +30,8 @@ use Google\Cloud\Compute\V1\ResourceGroupReference; /** - * Gets the most recent health check results for this regional BackendService. + * Gets the most recent health check results for this + * regional BackendService. * * @param string $backendService Name of the BackendService resource for which to get health. * @param string $project diff --git a/Compute/samples/V1/RegionBackendServicesClient/get_iam_policy.php b/Compute/samples/V1/RegionBackendServicesClient/get_iam_policy.php index 74cf7c2d7fc0..2b436f9462b9 100644 --- a/Compute/samples/V1/RegionBackendServicesClient/get_iam_policy.php +++ b/Compute/samples/V1/RegionBackendServicesClient/get_iam_policy.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\Policy; /** - * Gets the access control policy for a resource. May be empty if no such policy or resource exists. + * Gets the access control policy for a resource. May be empty if no such + * policy or resource exists. * * @param string $project Project ID for this request. * @param string $region The name of the region for this request. diff --git a/Compute/samples/V1/RegionBackendServicesClient/insert.php b/Compute/samples/V1/RegionBackendServicesClient/insert.php index d7a268fa63c0..1b858cb67f07 100644 --- a/Compute/samples/V1/RegionBackendServicesClient/insert.php +++ b/Compute/samples/V1/RegionBackendServicesClient/insert.php @@ -31,7 +31,9 @@ use Google\Rpc\Status; /** - * Creates a regional BackendService resource in the specified project using the data included in the request. For more information, see Backend services overview. + * Creates a regional BackendService resource in the specified project using + * the data included in the request. For more information, see + * Backend services overview. * * @param string $project Project ID for this request. * @param string $region Name of the region scoping this request. diff --git a/Compute/samples/V1/RegionBackendServicesClient/list.php b/Compute/samples/V1/RegionBackendServicesClient/list.php index c9d6348f1ff1..5010d7e491a7 100644 --- a/Compute/samples/V1/RegionBackendServicesClient/list.php +++ b/Compute/samples/V1/RegionBackendServicesClient/list.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\ListRegionBackendServicesRequest; /** - * Retrieves the list of regional BackendService resources available to the specified project in the given region. + * Retrieves the list of regional BackendService resources available to the + * specified project in the given region. * * @param string $project Project ID for this request. * @param string $region Name of the region scoping this request. diff --git a/Compute/samples/V1/RegionBackendServicesClient/list_usable.php b/Compute/samples/V1/RegionBackendServicesClient/list_usable.php index 91b2228910b1..c7346b1ff3f2 100644 --- a/Compute/samples/V1/RegionBackendServicesClient/list_usable.php +++ b/Compute/samples/V1/RegionBackendServicesClient/list_usable.php @@ -29,10 +29,12 @@ use Google\Cloud\Compute\V1\ListUsableRegionBackendServicesRequest; /** - * Retrieves a list of all usable backend services in the specified project in the given region. + * Retrieves a list of all usable backend services in the specified project in + * the given region. * * @param string $project Project ID for this request. - * @param string $region Name of the region scoping this request. It must be a string that meets the requirements in RFC1035. + * @param string $region Name of the region scoping this request. + * It must be a string that meets the requirements in RFC1035. */ function list_usable_sample(string $project, string $region): void { diff --git a/Compute/samples/V1/RegionBackendServicesClient/patch.php b/Compute/samples/V1/RegionBackendServicesClient/patch.php index 291ec651e2ef..f120f8b400cd 100644 --- a/Compute/samples/V1/RegionBackendServicesClient/patch.php +++ b/Compute/samples/V1/RegionBackendServicesClient/patch.php @@ -31,7 +31,11 @@ use Google\Rpc\Status; /** - * Updates the specified regional BackendService resource with the data included in the request. For more information, see Understanding backend services This method supports PATCH semantics and uses the JSON merge patch format and processing rules. + * Updates the specified regional BackendService resource with the data + * included in the request. For more information, see + * Understanding backend services This method + * supports PATCH semantics and uses the JSON merge + * patch format and processing rules. * * @param string $backendService Name of the BackendService resource to patch. * @param string $project Project ID for this request. diff --git a/Compute/samples/V1/RegionBackendServicesClient/set_iam_policy.php b/Compute/samples/V1/RegionBackendServicesClient/set_iam_policy.php index abbd55db41ad..c95ea6bf7416 100644 --- a/Compute/samples/V1/RegionBackendServicesClient/set_iam_policy.php +++ b/Compute/samples/V1/RegionBackendServicesClient/set_iam_policy.php @@ -30,7 +30,8 @@ use Google\Cloud\Compute\V1\SetIamPolicyRegionBackendServiceRequest; /** - * Sets the access control policy on the specified resource. Replaces any existing policy. + * Sets the access control policy on the specified resource. + * Replaces any existing policy. * * @param string $project Project ID for this request. * @param string $region The name of the region for this request. diff --git a/Compute/samples/V1/RegionBackendServicesClient/set_security_policy.php b/Compute/samples/V1/RegionBackendServicesClient/set_security_policy.php index e74a1e618630..a541bc18b289 100644 --- a/Compute/samples/V1/RegionBackendServicesClient/set_security_policy.php +++ b/Compute/samples/V1/RegionBackendServicesClient/set_security_policy.php @@ -31,9 +31,12 @@ use Google\Rpc\Status; /** - * Sets the Google Cloud Armor security policy for the specified backend service. For more information, see Google Cloud Armor Overview + * Sets the Google Cloud Armor security policy for the specified backend + * service. For more information, seeGoogle + * Cloud Armor Overview * - * @param string $backendService Name of the BackendService resource to which the security policy should be set. The name should conform to RFC1035. + * @param string $backendService Name of the BackendService resource to which the security policy should be + * set. The name should conform to RFC1035. * @param string $project Project ID for this request. * @param string $region Name of the region scoping this request. */ diff --git a/Compute/samples/V1/RegionBackendServicesClient/update.php b/Compute/samples/V1/RegionBackendServicesClient/update.php index 983b0ce568d8..d603d2460de2 100644 --- a/Compute/samples/V1/RegionBackendServicesClient/update.php +++ b/Compute/samples/V1/RegionBackendServicesClient/update.php @@ -31,7 +31,10 @@ use Google\Rpc\Status; /** - * Updates the specified regional BackendService resource with the data included in the request. For more information, see Backend services overview . + * Updates the specified regional BackendService resource with the data + * included in the request. For more information, + * see + * Backend services overview. * * @param string $backendService Name of the BackendService resource to update. * @param string $project Project ID for this request. diff --git a/Compute/samples/V1/RegionCommitmentsClient/aggregated_list.php b/Compute/samples/V1/RegionCommitmentsClient/aggregated_list.php index 0e2da4038ebb..e88cd34b5d09 100644 --- a/Compute/samples/V1/RegionCommitmentsClient/aggregated_list.php +++ b/Compute/samples/V1/RegionCommitmentsClient/aggregated_list.php @@ -29,7 +29,10 @@ use Google\Cloud\Compute\V1\Client\RegionCommitmentsClient; /** - * Retrieves an aggregated list of commitments by region. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. + * Retrieves an aggregated list of commitments by region. + * + * To prevent failure, it is recommended that you set the + * `returnPartialSuccess` parameter to `true`. * * @param string $project Project ID for this request. */ diff --git a/Compute/samples/V1/RegionCommitmentsClient/insert.php b/Compute/samples/V1/RegionCommitmentsClient/insert.php index e27b063f155d..8241c5ded3d7 100644 --- a/Compute/samples/V1/RegionCommitmentsClient/insert.php +++ b/Compute/samples/V1/RegionCommitmentsClient/insert.php @@ -31,7 +31,8 @@ use Google\Rpc\Status; /** - * Creates a commitment in the specified project using the data included in the request. + * Creates a commitment in the specified project using the data + * included in the request. * * @param string $project Project ID for this request. * @param string $region Name of the region for this request. diff --git a/Compute/samples/V1/RegionCommitmentsClient/list.php b/Compute/samples/V1/RegionCommitmentsClient/list.php index 2b597a88ae3d..e80202096b0c 100644 --- a/Compute/samples/V1/RegionCommitmentsClient/list.php +++ b/Compute/samples/V1/RegionCommitmentsClient/list.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\ListRegionCommitmentsRequest; /** - * Retrieves a list of commitments contained within the specified region. + * Retrieves a list of commitments contained within + * the specified region. * * @param string $project Project ID for this request. * @param string $region Name of the region for this request. diff --git a/Compute/samples/V1/RegionCommitmentsClient/update.php b/Compute/samples/V1/RegionCommitmentsClient/update.php index 31fb5999c6db..5a261cce039d 100644 --- a/Compute/samples/V1/RegionCommitmentsClient/update.php +++ b/Compute/samples/V1/RegionCommitmentsClient/update.php @@ -31,7 +31,9 @@ use Google\Rpc\Status; /** - * Updates the specified commitment with the data included in the request. Update is performed only on selected fields included as part of update-mask. Only the following fields can be updated: auto_renew and plan. + * Updates the specified commitment with the data included in the request. + * Update is performed only on selected fields included as part of + * update-mask. Only the following fields can be updated: auto_renew and plan. * * @param string $commitment Name of the commitment that you want to update. * @param string $project Project ID for this request. diff --git a/Compute/samples/V1/RegionDisksClient/add_resource_policies.php b/Compute/samples/V1/RegionDisksClient/add_resource_policies.php index 76e9b780978a..8bbfb49d6a2d 100644 --- a/Compute/samples/V1/RegionDisksClient/add_resource_policies.php +++ b/Compute/samples/V1/RegionDisksClient/add_resource_policies.php @@ -31,7 +31,9 @@ use Google\Rpc\Status; /** - * Adds existing resource policies to a regional disk. You can only add one policy which will be applied to this disk for scheduling snapshot creation. + * Adds existing resource policies to a regional disk. You can only add one + * policy which will be applied to this disk for scheduling snapshot + * creation. * * @param string $disk The disk name for this request. * @param string $project Project ID for this request. diff --git a/Compute/samples/V1/RegionDisksClient/create_snapshot.php b/Compute/samples/V1/RegionDisksClient/create_snapshot.php index 514f4c20235b..4a8daf97c37f 100644 --- a/Compute/samples/V1/RegionDisksClient/create_snapshot.php +++ b/Compute/samples/V1/RegionDisksClient/create_snapshot.php @@ -31,7 +31,10 @@ use Google\Rpc\Status; /** - * Creates a snapshot of a specified persistent disk. For regular snapshot creation, consider using snapshots.insert instead, as that method supports more features, such as creating snapshots in a project different from the source disk project. + * Creates a snapshot of a specified persistent disk. For regular snapshot + * creation, consider using snapshots.insert + * instead, as that method supports more features, such as creating snapshots + * in a project different from the source disk project. * * @param string $disk Name of the regional persistent disk to snapshot. * @param string $project Project ID for this request. diff --git a/Compute/samples/V1/RegionDisksClient/delete.php b/Compute/samples/V1/RegionDisksClient/delete.php index 64a3eb73d6e1..6cc49b8c4809 100644 --- a/Compute/samples/V1/RegionDisksClient/delete.php +++ b/Compute/samples/V1/RegionDisksClient/delete.php @@ -30,7 +30,11 @@ use Google\Rpc\Status; /** - * Deletes the specified regional persistent disk. Deleting a regional disk removes all the replicas of its data permanently and is irreversible. However, deleting a disk does not delete any snapshots previously made from the disk. You must separately delete snapshots. + * Deletes the specified regional persistent disk. Deleting a regional disk + * removes all the replicas of its data permanently and is irreversible. + * However, deleting a disk does not delete anysnapshots + * previously made from the disk. You must separatelydelete + * snapshots. * * @param string $disk Name of the regional persistent disk to delete. * @param string $project Project ID for this request. diff --git a/Compute/samples/V1/RegionDisksClient/get_iam_policy.php b/Compute/samples/V1/RegionDisksClient/get_iam_policy.php index 7fb1b58bcc17..1337e733fab9 100644 --- a/Compute/samples/V1/RegionDisksClient/get_iam_policy.php +++ b/Compute/samples/V1/RegionDisksClient/get_iam_policy.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\Policy; /** - * Gets the access control policy for a resource. May be empty if no such policy or resource exists. + * Gets the access control policy for a resource. May be empty if no such + * policy or resource exists. * * @param string $project Project ID for this request. * @param string $region The name of the region for this request. diff --git a/Compute/samples/V1/RegionDisksClient/insert.php b/Compute/samples/V1/RegionDisksClient/insert.php index c04c6d0ea5a5..69f8d34db845 100644 --- a/Compute/samples/V1/RegionDisksClient/insert.php +++ b/Compute/samples/V1/RegionDisksClient/insert.php @@ -31,7 +31,8 @@ use Google\Rpc\Status; /** - * Creates a persistent regional disk in the specified project using the data included in the request. + * Creates a persistent regional disk in the specified project using the data + * included in the request. * * @param string $project Project ID for this request. * @param string $region Name of the region for this request. diff --git a/Compute/samples/V1/RegionDisksClient/list.php b/Compute/samples/V1/RegionDisksClient/list.php index c1c2d8d4ee2b..56f45fa48627 100644 --- a/Compute/samples/V1/RegionDisksClient/list.php +++ b/Compute/samples/V1/RegionDisksClient/list.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\ListRegionDisksRequest; /** - * Retrieves the list of persistent disks contained within the specified region. + * Retrieves the list of persistent disks contained within + * the specified region. * * @param string $project Project ID for this request. * @param string $region Name of the region for this request. diff --git a/Compute/samples/V1/RegionDisksClient/set_iam_policy.php b/Compute/samples/V1/RegionDisksClient/set_iam_policy.php index 443b55603cb8..9e2ccce70eb6 100644 --- a/Compute/samples/V1/RegionDisksClient/set_iam_policy.php +++ b/Compute/samples/V1/RegionDisksClient/set_iam_policy.php @@ -30,7 +30,8 @@ use Google\Cloud\Compute\V1\SetIamPolicyRegionDiskRequest; /** - * Sets the access control policy on the specified resource. Replaces any existing policy. + * Sets the access control policy on the specified resource. + * Replaces any existing policy. * * @param string $project Project ID for this request. * @param string $region The name of the region for this request. diff --git a/Compute/samples/V1/RegionDisksClient/start_async_replication.php b/Compute/samples/V1/RegionDisksClient/start_async_replication.php index 16c323469d0b..390cd7fb6a58 100644 --- a/Compute/samples/V1/RegionDisksClient/start_async_replication.php +++ b/Compute/samples/V1/RegionDisksClient/start_async_replication.php @@ -31,7 +31,8 @@ use Google\Rpc\Status; /** - * Starts asynchronous replication. Must be invoked on the primary disk. + * Starts asynchronous replication. + * Must be invoked on the primary disk. * * @param string $disk The name of the persistent disk. * @param string $project Project ID for this request. diff --git a/Compute/samples/V1/RegionDisksClient/stop_async_replication.php b/Compute/samples/V1/RegionDisksClient/stop_async_replication.php index f1408f0f253d..9e65630a458e 100644 --- a/Compute/samples/V1/RegionDisksClient/stop_async_replication.php +++ b/Compute/samples/V1/RegionDisksClient/stop_async_replication.php @@ -30,7 +30,8 @@ use Google\Rpc\Status; /** - * Stops asynchronous replication. Can be invoked either on the primary or on the secondary disk. + * Stops asynchronous replication. + * Can be invoked either on the primary or on the secondary disk. * * @param string $disk The name of the persistent disk. * @param string $project Project ID for this request. diff --git a/Compute/samples/V1/RegionDisksClient/stop_group_async_replication.php b/Compute/samples/V1/RegionDisksClient/stop_group_async_replication.php index e2b3731f60c3..274adc7459d1 100644 --- a/Compute/samples/V1/RegionDisksClient/stop_group_async_replication.php +++ b/Compute/samples/V1/RegionDisksClient/stop_group_async_replication.php @@ -31,10 +31,12 @@ use Google\Rpc\Status; /** - * Stops asynchronous replication for a consistency group of disks. Can be invoked either in the primary or secondary scope. + * Stops asynchronous replication for a consistency group of disks. + * Can be invoked either in the primary or secondary scope. * * @param string $project Project ID for this request. - * @param string $region The name of the region for this request. This must be the region of the primary or secondary disks in the consistency group. + * @param string $region The name of the region for this request. This must be the region of the + * primary or secondary disks in the consistency group. */ function stop_group_async_replication_sample(string $project, string $region): void { diff --git a/Compute/samples/V1/RegionDisksClient/update.php b/Compute/samples/V1/RegionDisksClient/update.php index 28b9b7c1a034..5d1bd12e2d48 100644 --- a/Compute/samples/V1/RegionDisksClient/update.php +++ b/Compute/samples/V1/RegionDisksClient/update.php @@ -31,7 +31,9 @@ use Google\Rpc\Status; /** - * Update the specified disk with the data included in the request. Update is performed only on selected fields included as part of update-mask. Only the following fields can be modified: user_license. + * Update the specified disk with the data included in the request. Update is + * performed only on selected fields included as part of update-mask. Only the + * following fields can be modified: user_license. * * @param string $disk The disk name for this request. * @param string $project Project ID for this request. diff --git a/Compute/samples/V1/RegionHealthCheckServicesClient/delete.php b/Compute/samples/V1/RegionHealthCheckServicesClient/delete.php index fc94d6e8e86a..14622c805466 100644 --- a/Compute/samples/V1/RegionHealthCheckServicesClient/delete.php +++ b/Compute/samples/V1/RegionHealthCheckServicesClient/delete.php @@ -32,7 +32,8 @@ /** * Deletes the specified regional HealthCheckService. * - * @param string $healthCheckService Name of the HealthCheckService to delete. The name must be 1-63 characters long, and comply with RFC1035. + * @param string $healthCheckService Name of the HealthCheckService to delete. The name + * must be 1-63 characters long, and comply with RFC1035. * @param string $project Project ID for this request. * @param string $region Name of the region scoping this request. */ diff --git a/Compute/samples/V1/RegionHealthCheckServicesClient/get.php b/Compute/samples/V1/RegionHealthCheckServicesClient/get.php index bad38d2ae0e2..f8511ed81660 100644 --- a/Compute/samples/V1/RegionHealthCheckServicesClient/get.php +++ b/Compute/samples/V1/RegionHealthCheckServicesClient/get.php @@ -31,7 +31,8 @@ /** * Returns the specified regional HealthCheckService resource. * - * @param string $healthCheckService Name of the HealthCheckService to update. The name must be 1-63 characters long, and comply with RFC1035. + * @param string $healthCheckService Name of the HealthCheckService to update. The name + * must be 1-63 characters long, and comply with RFC1035. * @param string $project Project ID for this request. * @param string $region Name of the region scoping this request. */ diff --git a/Compute/samples/V1/RegionHealthCheckServicesClient/insert.php b/Compute/samples/V1/RegionHealthCheckServicesClient/insert.php index 8a3393802bc5..d7a9d859c52f 100644 --- a/Compute/samples/V1/RegionHealthCheckServicesClient/insert.php +++ b/Compute/samples/V1/RegionHealthCheckServicesClient/insert.php @@ -31,7 +31,8 @@ use Google\Rpc\Status; /** - * Creates a regional HealthCheckService resource in the specified project and region using the data included in the request. + * Creates a regional HealthCheckService resource in the + * specified project and region using the data included in the request. * * @param string $project Project ID for this request. * @param string $region Name of the region scoping this request. diff --git a/Compute/samples/V1/RegionHealthCheckServicesClient/list.php b/Compute/samples/V1/RegionHealthCheckServicesClient/list.php index c95f2c84494b..dc47eaac8a00 100644 --- a/Compute/samples/V1/RegionHealthCheckServicesClient/list.php +++ b/Compute/samples/V1/RegionHealthCheckServicesClient/list.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\ListRegionHealthCheckServicesRequest; /** - * Lists all the HealthCheckService resources that have been configured for the specified project in the given region. + * Lists all the HealthCheckService resources that have been + * configured for the specified project in the given region. * * @param string $project Project ID for this request. * @param string $region Name of the region scoping this request. diff --git a/Compute/samples/V1/RegionHealthCheckServicesClient/patch.php b/Compute/samples/V1/RegionHealthCheckServicesClient/patch.php index 42242487e92d..7325970c09b0 100644 --- a/Compute/samples/V1/RegionHealthCheckServicesClient/patch.php +++ b/Compute/samples/V1/RegionHealthCheckServicesClient/patch.php @@ -31,9 +31,13 @@ use Google\Rpc\Status; /** - * Updates the specified regional HealthCheckService resource with the data included in the request. This method supports PATCH semantics and uses the JSON merge patch format and processing rules. + * Updates the specified regional HealthCheckService resource + * with the data included in the request. This method supportsPATCH + * semantics and uses theJSON merge + * patch format and processing rules. * - * @param string $healthCheckService Name of the HealthCheckService to update. The name must be 1-63 characters long, and comply with RFC1035. + * @param string $healthCheckService Name of the HealthCheckService to update. The name + * must be 1-63 characters long, and comply with RFC1035. * @param string $project Project ID for this request. * @param string $region Name of the region scoping this request. */ diff --git a/Compute/samples/V1/RegionHealthChecksClient/insert.php b/Compute/samples/V1/RegionHealthChecksClient/insert.php index 2704bdcc5c66..089e3e5a45ff 100644 --- a/Compute/samples/V1/RegionHealthChecksClient/insert.php +++ b/Compute/samples/V1/RegionHealthChecksClient/insert.php @@ -31,7 +31,8 @@ use Google\Rpc\Status; /** - * Creates a HealthCheck resource in the specified project using the data included in the request. + * Creates a HealthCheck resource in the specified project using the data + * included in the request. * * @param string $project Project ID for this request. * @param string $region Name of the region scoping this request. diff --git a/Compute/samples/V1/RegionHealthChecksClient/list.php b/Compute/samples/V1/RegionHealthChecksClient/list.php index d26b23911037..888d63a69720 100644 --- a/Compute/samples/V1/RegionHealthChecksClient/list.php +++ b/Compute/samples/V1/RegionHealthChecksClient/list.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\ListRegionHealthChecksRequest; /** - * Retrieves the list of HealthCheck resources available to the specified project. + * Retrieves the list of HealthCheck resources available to the specified + * project. * * @param string $project Project ID for this request. * @param string $region Name of the region scoping this request. diff --git a/Compute/samples/V1/RegionHealthChecksClient/patch.php b/Compute/samples/V1/RegionHealthChecksClient/patch.php index 2d59d2904046..43d1856cb5ad 100644 --- a/Compute/samples/V1/RegionHealthChecksClient/patch.php +++ b/Compute/samples/V1/RegionHealthChecksClient/patch.php @@ -31,7 +31,10 @@ use Google\Rpc\Status; /** - * Updates a HealthCheck resource in the specified project using the data included in the request. This method supports PATCH semantics and uses the JSON merge patch format and processing rules. + * Updates a HealthCheck resource in the specified project using the data + * included in the request. This method supportsPATCH + * semantics and uses theJSON merge + * patch format and processing rules. * * @param string $healthCheck Name of the HealthCheck resource to patch. * @param string $project Project ID for this request. diff --git a/Compute/samples/V1/RegionHealthChecksClient/update.php b/Compute/samples/V1/RegionHealthChecksClient/update.php index 00fc2ebb5095..8225b464bd1f 100644 --- a/Compute/samples/V1/RegionHealthChecksClient/update.php +++ b/Compute/samples/V1/RegionHealthChecksClient/update.php @@ -31,7 +31,8 @@ use Google\Rpc\Status; /** - * Updates a HealthCheck resource in the specified project using the data included in the request. + * Updates a HealthCheck resource in the specified project using the data + * included in the request. * * @param string $healthCheck Name of the HealthCheck resource to update. * @param string $project Project ID for this request. diff --git a/Compute/samples/V1/RegionInstanceGroupManagersClient/abandon_instances.php b/Compute/samples/V1/RegionInstanceGroupManagersClient/abandon_instances.php index b1f59f6b04e1..1fb6967a6dba 100644 --- a/Compute/samples/V1/RegionInstanceGroupManagersClient/abandon_instances.php +++ b/Compute/samples/V1/RegionInstanceGroupManagersClient/abandon_instances.php @@ -31,7 +31,21 @@ use Google\Rpc\Status; /** - * Flags the specified instances to be immediately removed from the managed instance group. Abandoning an instance does not delete the instance, but it does remove the instance from any target pools that are applied by the managed instance group. This method reduces the targetSize of the managed instance group by the number of instances that you abandon. This operation is marked as DONE when the action is scheduled even if the instances have not yet been removed from the group. You must separately verify the status of the abandoning action with the listmanagedinstances method. If the group is part of a backend service that has enabled connection draining, it can take up to 60 seconds after the connection draining duration has elapsed before the VM instance is removed or deleted. You can specify a maximum of 1000 instances with this method per request. + * Flags the specified instances to be immediately removed from the managed + * instance group. Abandoning an instance does not delete the + * instance, but it does remove the instance from any target pools that are + * applied by the managed instance group. This method reduces thetargetSize of the managed instance group by the + * number of instances that you abandon. This operation is marked asDONE when the action is scheduled even if the instances have + * not yet been removed from the group. You must separately verify the + * status of the abandoning action with thelistmanagedinstances + * method. + * + * If the group is part of a backend + * service that has enabled + * connection draining, it can take up to 60 seconds after the connection + * draining duration has elapsed before the VM instance is removed or deleted. + * + * You can specify a maximum of 1000 instances with this method per request. * * @param string $instanceGroupManager Name of the managed instance group. * @param string $project Project ID for this request. diff --git a/Compute/samples/V1/RegionInstanceGroupManagersClient/create_instances.php b/Compute/samples/V1/RegionInstanceGroupManagersClient/create_instances.php index 9b0a59019f59..0b928717bbbb 100644 --- a/Compute/samples/V1/RegionInstanceGroupManagersClient/create_instances.php +++ b/Compute/samples/V1/RegionInstanceGroupManagersClient/create_instances.php @@ -31,11 +31,19 @@ use Google\Rpc\Status; /** - * Creates instances with per-instance configurations in this regional managed instance group. Instances are created using the current instance template. The create instances operation is marked DONE if the createInstances request is successful. The underlying actions take additional time. You must separately verify the status of the creating or actions with the listmanagedinstances method. + * Creates instances with per-instance configurations in this regional managed + * instance group. Instances are created using the current instance template. + * The create instances operation is marked DONE if + * the createInstances request is successful. The underlying + * actions take additional time. You must separately verify the status of thecreating or actions with the listmanagedinstances + * method. * - * @param string $instanceGroupManager The name of the managed instance group. It should conform to RFC1035. + * @param string $instanceGroupManager The name of the managed instance group. + * It should conform to RFC1035. * @param string $project Project ID for this request. - * @param string $region The name of the region where the managed instance group is located. It should conform to RFC1035. + * @param string $region The name of theregion + * where the managed instance group is located. + * It should conform to RFC1035. */ function create_instances_sample( string $instanceGroupManager, diff --git a/Compute/samples/V1/RegionInstanceGroupManagersClient/delete.php b/Compute/samples/V1/RegionInstanceGroupManagersClient/delete.php index ddba25e845e0..164ecd82e2c9 100644 --- a/Compute/samples/V1/RegionInstanceGroupManagersClient/delete.php +++ b/Compute/samples/V1/RegionInstanceGroupManagersClient/delete.php @@ -30,7 +30,8 @@ use Google\Rpc\Status; /** - * Deletes the specified managed instance group and all of the instances in that group. + * Deletes the specified managed instance group and all of the instances + * in that group. * * @param string $instanceGroupManager Name of the managed instance group to delete. * @param string $project Project ID for this request. diff --git a/Compute/samples/V1/RegionInstanceGroupManagersClient/delete_instances.php b/Compute/samples/V1/RegionInstanceGroupManagersClient/delete_instances.php index a8bad09f71cf..fd52aa1ec4b0 100644 --- a/Compute/samples/V1/RegionInstanceGroupManagersClient/delete_instances.php +++ b/Compute/samples/V1/RegionInstanceGroupManagersClient/delete_instances.php @@ -31,7 +31,21 @@ use Google\Rpc\Status; /** - * Flags the specified instances in the managed instance group to be immediately deleted. The instances are also removed from any target pools of which they were a member. This method reduces the targetSize of the managed instance group by the number of instances that you delete. The deleteInstances operation is marked DONE if the deleteInstances request is successful. The underlying actions take additional time. You must separately verify the status of the deleting action with the listmanagedinstances method. If the group is part of a backend service that has enabled connection draining, it can take up to 60 seconds after the connection draining duration has elapsed before the VM instance is removed or deleted. You can specify a maximum of 1000 instances with this method per request. + * Flags the specified instances in the managed instance group to be + * immediately deleted. The instances are also removed from any target + * pools of which they were a member. This method reduces thetargetSize of the managed instance group by the number of + * instances that you delete. + * The deleteInstances operation is marked DONE if + * the deleteInstances request is successful. The underlying + * actions take additional time. You must separately verify the status of thedeleting action with thelistmanagedinstances + * method. + * + * If the group is part of a backend + * service that has enabled + * connection draining, it can take up to 60 seconds after the connection + * draining duration has elapsed before the VM instance is removed or deleted. + * + * You can specify a maximum of 1000 instances with this method per request. * * @param string $instanceGroupManager Name of the managed instance group. * @param string $project Project ID for this request. diff --git a/Compute/samples/V1/RegionInstanceGroupManagersClient/delete_per_instance_configs.php b/Compute/samples/V1/RegionInstanceGroupManagersClient/delete_per_instance_configs.php index 76e0fd11a846..4ef9a1a00bd4 100644 --- a/Compute/samples/V1/RegionInstanceGroupManagersClient/delete_per_instance_configs.php +++ b/Compute/samples/V1/RegionInstanceGroupManagersClient/delete_per_instance_configs.php @@ -31,7 +31,8 @@ use Google\Rpc\Status; /** - * Deletes selected per-instance configurations for the managed instance group. + * Deletes selected per-instance configurations for the managed instance + * group. * * @param string $instanceGroupManager The name of the managed instance group. It should conform to RFC1035. * @param string $project Project ID for this request. diff --git a/Compute/samples/V1/RegionInstanceGroupManagersClient/insert.php b/Compute/samples/V1/RegionInstanceGroupManagersClient/insert.php index 3f196a3a0657..ff27941b2d67 100644 --- a/Compute/samples/V1/RegionInstanceGroupManagersClient/insert.php +++ b/Compute/samples/V1/RegionInstanceGroupManagersClient/insert.php @@ -31,7 +31,15 @@ use Google\Rpc\Status; /** - * Creates a managed instance group using the information that you specify in the request. After the group is created, instances in the group are created using the specified instance template. This operation is marked as DONE when the group is created even if the instances in the group have not yet been created. You must separately verify the status of the individual instances with the listmanagedinstances method. A regional managed instance group can contain up to 2000 instances. + * Creates a managed instance group using the information that you specify + * in the request. After the group is created, instances in the group are + * created using the specified instance template. + * This operation is marked as DONE when the group is created + * even if the instances in the group have not yet been created. You must + * separately verify the status of the individual instances with thelistmanagedinstances + * method. + * + * A regional managed instance group can contain up to 2000 instances. * * @param string $project Project ID for this request. * @param string $region Name of the region scoping this request. diff --git a/Compute/samples/V1/RegionInstanceGroupManagersClient/list.php b/Compute/samples/V1/RegionInstanceGroupManagersClient/list.php index 700ed5ef1ffb..69dcd31edb77 100644 --- a/Compute/samples/V1/RegionInstanceGroupManagersClient/list.php +++ b/Compute/samples/V1/RegionInstanceGroupManagersClient/list.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\ListRegionInstanceGroupManagersRequest; /** - * Retrieves the list of managed instance groups that are contained within the specified region. + * Retrieves the list of managed instance groups that are contained + * within the specified region. * * @param string $project Project ID for this request. * @param string $region Name of the region scoping this request. diff --git a/Compute/samples/V1/RegionInstanceGroupManagersClient/list_errors.php b/Compute/samples/V1/RegionInstanceGroupManagersClient/list_errors.php index 0118c0317124..b89f7929872f 100644 --- a/Compute/samples/V1/RegionInstanceGroupManagersClient/list_errors.php +++ b/Compute/samples/V1/RegionInstanceGroupManagersClient/list_errors.php @@ -29,11 +29,16 @@ use Google\Cloud\Compute\V1\ListErrorsRegionInstanceGroupManagersRequest; /** - * Lists all errors thrown by actions on instances for a given regional managed instance group. The filter and orderBy query parameters are not supported. + * Lists all errors thrown by actions on instances for a given regional + * managed instance group. The filter andorderBy query parameters are not supported. * - * @param string $instanceGroupManager The name of the managed instance group. It must be a string that meets the requirements in RFC1035, or an unsigned long integer: must match regexp pattern: (?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?)|1-9{0,19}. + * @param string $instanceGroupManager The name of the managed instance group. + * It must be a string that meets the requirements in RFC1035, or an + * unsigned long integer: must match regexp pattern: + * (?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?)|1-9{0,19}. * @param string $project Project ID for this request. - * @param string $region Name of the region scoping this request. This should conform to RFC1035. + * @param string $region Name of the region scoping this request. + * This should conform to RFC1035. */ function list_errors_sample(string $instanceGroupManager, string $project, string $region): void { diff --git a/Compute/samples/V1/RegionInstanceGroupManagersClient/list_managed_instances.php b/Compute/samples/V1/RegionInstanceGroupManagersClient/list_managed_instances.php index f009d9a589c1..fb790dc2fb0b 100644 --- a/Compute/samples/V1/RegionInstanceGroupManagersClient/list_managed_instances.php +++ b/Compute/samples/V1/RegionInstanceGroupManagersClient/list_managed_instances.php @@ -29,7 +29,12 @@ use Google\Cloud\Compute\V1\ListManagedInstancesRegionInstanceGroupManagersRequest; /** - * Lists the instances in the managed instance group and instances that are scheduled to be created. The list includes any current actions that the group has scheduled for its instances. The orderBy query parameter is not supported. The `pageToken` query parameter is supported only if the group's `listManagedInstancesResults` field is set to `PAGINATED`. + * Lists the instances in the managed instance group and instances that are + * scheduled to be created. The list includes any current actions + * that the group has scheduled for its instances. The orderBy + * query parameter is not supported. The `pageToken` query parameter is + * supported only if the group's `listManagedInstancesResults` field is set + * to `PAGINATED`. * * @param string $instanceGroupManager The name of the managed instance group. * @param string $project Project ID for this request. diff --git a/Compute/samples/V1/RegionInstanceGroupManagersClient/list_per_instance_configs.php b/Compute/samples/V1/RegionInstanceGroupManagersClient/list_per_instance_configs.php index 425a7350241a..b58b7fb249ef 100644 --- a/Compute/samples/V1/RegionInstanceGroupManagersClient/list_per_instance_configs.php +++ b/Compute/samples/V1/RegionInstanceGroupManagersClient/list_per_instance_configs.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\ListPerInstanceConfigsRegionInstanceGroupManagersRequest; /** - * Lists all of the per-instance configurations defined for the managed instance group. The orderBy query parameter is not supported. + * Lists all of the per-instance configurations defined for the managed + * instance group. The orderBy query parameter is not supported. * * @param string $instanceGroupManager The name of the managed instance group. It should conform to RFC1035. * @param string $project Project ID for this request. diff --git a/Compute/samples/V1/RegionInstanceGroupManagersClient/patch.php b/Compute/samples/V1/RegionInstanceGroupManagersClient/patch.php index 9d3ef89f8787..6d75e1c99164 100644 --- a/Compute/samples/V1/RegionInstanceGroupManagersClient/patch.php +++ b/Compute/samples/V1/RegionInstanceGroupManagersClient/patch.php @@ -31,7 +31,21 @@ use Google\Rpc\Status; /** - * Updates a managed instance group using the information that you specify in the request. This operation is marked as DONE when the group is patched even if the instances in the group are still in the process of being patched. You must separately verify the status of the individual instances with the listmanagedinstances method. This method supports PATCH semantics and uses the JSON merge patch format and processing rules. If you update your group to specify a new template or instance configuration, it's possible that your intended specification for each VM in the group is different from the current state of that VM. To learn how to apply an updated configuration to the VMs in a MIG, see Updating instances in a MIG. + * Updates a managed instance group using the information that you specify + * in the request. + * This operation is marked as DONE when the group is patched + * even if the instances in the group are still in the process of being + * patched. You must separately verify the status of the individual instances + * with the listmanagedinstances + * method. This method supportsPATCH + * semantics and uses theJSON merge + * patch format and processing rules. + * + * If you update your group to specify a new template or instance + * configuration, it's possible that your intended specification for each VM + * in the group is different from the current state of that VM. To learn how + * to apply an updated configuration to the VMs in a MIG, seeUpdating instances in + * a MIG. * * @param string $instanceGroupManager The name of the instance group manager. * @param string $project Project ID for this request. diff --git a/Compute/samples/V1/RegionInstanceGroupManagersClient/patch_per_instance_configs.php b/Compute/samples/V1/RegionInstanceGroupManagersClient/patch_per_instance_configs.php index df08548e49d6..064c46ed0839 100644 --- a/Compute/samples/V1/RegionInstanceGroupManagersClient/patch_per_instance_configs.php +++ b/Compute/samples/V1/RegionInstanceGroupManagersClient/patch_per_instance_configs.php @@ -31,9 +31,12 @@ use Google\Rpc\Status; /** - * Inserts or patches per-instance configurations for the managed instance group. perInstanceConfig.name serves as a key used to distinguish whether to perform insert or patch. + * Inserts or patches per-instance configurations for the managed instance + * group. perInstanceConfig.name serves as a key used to + * distinguish whether to perform insert or patch. * - * @param string $instanceGroupManager The name of the managed instance group. It should conform to RFC1035. + * @param string $instanceGroupManager The name of the managed instance group. + * It should conform to RFC1035. * @param string $project Project ID for this request. * @param string $region Name of the region scoping this request, should conform to RFC1035. */ diff --git a/Compute/samples/V1/RegionInstanceGroupManagersClient/recreate_instances.php b/Compute/samples/V1/RegionInstanceGroupManagersClient/recreate_instances.php index 1ab1b1e8801c..adaaf627e438 100644 --- a/Compute/samples/V1/RegionInstanceGroupManagersClient/recreate_instances.php +++ b/Compute/samples/V1/RegionInstanceGroupManagersClient/recreate_instances.php @@ -31,7 +31,19 @@ use Google\Rpc\Status; /** - * Flags the specified VM instances in the managed instance group to be immediately recreated. Each instance is recreated using the group's current configuration. This operation is marked as DONE when the flag is set even if the instances have not yet been recreated. You must separately verify the status of each instance by checking its currentAction field; for more information, see Checking the status of managed instances. If the group is part of a backend service that has enabled connection draining, it can take up to 60 seconds after the connection draining duration has elapsed before the VM instance is removed or deleted. You can specify a maximum of 1000 instances with this method per request. + * Flags the specified VM instances in the managed instance group to be + * immediately recreated. Each instance is recreated using the group's current + * configuration. This operation is marked as DONE when the flag + * is set even if the instances have not yet been recreated. You must + * separately verify the status of each instance by checking itscurrentAction field; for more information, see Checking + * the status of managed instances. + * + * If the group is part of a backend + * service that has enabled + * connection draining, it can take up to 60 seconds after the connection + * draining duration has elapsed before the VM instance is removed or deleted. + * + * You can specify a maximum of 1000 instances with this method per request. * * @param string $instanceGroupManager Name of the managed instance group. * @param string $project Project ID for this request. diff --git a/Compute/samples/V1/RegionInstanceGroupManagersClient/resize.php b/Compute/samples/V1/RegionInstanceGroupManagersClient/resize.php index e68598012041..59d89b69e31f 100644 --- a/Compute/samples/V1/RegionInstanceGroupManagersClient/resize.php +++ b/Compute/samples/V1/RegionInstanceGroupManagersClient/resize.php @@ -30,12 +30,25 @@ use Google\Rpc\Status; /** - * Changes the intended size of the managed instance group. If you increase the size, the group creates new instances using the current instance template. If you decrease the size, the group deletes one or more instances. The resize operation is marked DONE if the resize request is successful. The underlying actions take additional time. You must separately verify the status of the creating or deleting actions with the listmanagedinstances method. If the group is part of a backend service that has enabled connection draining, it can take up to 60 seconds after the connection draining duration has elapsed before the VM instance is removed or deleted. + * Changes the intended size of the managed instance group. If you increase + * the size, the group creates new instances using the current instance + * template. If you decrease the size, the group deletes one or more + * instances. + * + * The resize operation is marked DONE if theresize request is successful. The underlying actions take + * additional time. You must separately verify the status of thecreating or deleting actions with thelistmanagedinstances + * method. + * + * If the group is part of a backend + * service that has enabled + * connection draining, it can take up to 60 seconds after the connection + * draining duration has elapsed before the VM instance is removed or deleted. * * @param string $instanceGroupManager Name of the managed instance group. * @param string $project Project ID for this request. * @param string $region Name of the region scoping this request. - * @param int $size Number of instances that should exist in this instance group manager. + * @param int $size Number of instances that should exist in this instance group + * manager. */ function resize_sample( string $instanceGroupManager, diff --git a/Compute/samples/V1/RegionInstanceGroupManagersClient/resume_instances.php b/Compute/samples/V1/RegionInstanceGroupManagersClient/resume_instances.php index 9e55a0a7c8d4..2cb20bc756f9 100644 --- a/Compute/samples/V1/RegionInstanceGroupManagersClient/resume_instances.php +++ b/Compute/samples/V1/RegionInstanceGroupManagersClient/resume_instances.php @@ -31,7 +31,22 @@ use Google\Rpc\Status; /** - * Flags the specified instances in the managed instance group to be resumed. This method increases the targetSize and decreases the targetSuspendedSize of the managed instance group by the number of instances that you resume. The resumeInstances operation is marked DONE if the resumeInstances request is successful. The underlying actions take additional time. You must separately verify the status of the RESUMING action with the listmanagedinstances method. In this request, you can only specify instances that are suspended. For example, if an instance was previously suspended using the suspendInstances method, it can be resumed using the resumeInstances method. If a health check is attached to the managed instance group, the specified instances will be verified as healthy after they are resumed. You can specify a maximum of 1000 instances with this method per request. + * Flags the specified instances in the managed instance group to be + * resumed. This method increases thetargetSize and decreases the targetSuspendedSize + * of the managed instance group by the number of instances that you resume. + * The resumeInstances operation is marked DONE if + * the resumeInstances request is successful. The underlying + * actions take additional time. You must separately verify the status of theRESUMING action with thelistmanagedinstances + * method. + * + * In this request, you can only specify instances that are suspended. For + * example, if an instance was previously suspended using the suspendInstances + * method, it can be resumed using the resumeInstances method. + * + * If a health check is attached to the managed instance group, the specified + * instances will be verified as healthy after they are resumed. + * + * You can specify a maximum of 1000 instances with this method per request. * * @param string $instanceGroupManager Name of the managed instance group. * @param string $project Project ID for this request. diff --git a/Compute/samples/V1/RegionInstanceGroupManagersClient/set_instance_template.php b/Compute/samples/V1/RegionInstanceGroupManagersClient/set_instance_template.php index bdc8376e61ee..4db1588e1be3 100644 --- a/Compute/samples/V1/RegionInstanceGroupManagersClient/set_instance_template.php +++ b/Compute/samples/V1/RegionInstanceGroupManagersClient/set_instance_template.php @@ -31,7 +31,8 @@ use Google\Rpc\Status; /** - * Sets the instance template to use when creating new instances or recreating instances in this group. Existing instances are not affected. + * Sets the instance template to use when creating new instances or recreating + * instances in this group. Existing instances are not affected. * * @param string $instanceGroupManager The name of the managed instance group. * @param string $project Project ID for this request. diff --git a/Compute/samples/V1/RegionInstanceGroupManagersClient/set_target_pools.php b/Compute/samples/V1/RegionInstanceGroupManagersClient/set_target_pools.php index f96008d5dd1c..f1ea128698d1 100644 --- a/Compute/samples/V1/RegionInstanceGroupManagersClient/set_target_pools.php +++ b/Compute/samples/V1/RegionInstanceGroupManagersClient/set_target_pools.php @@ -31,7 +31,8 @@ use Google\Rpc\Status; /** - * Modifies the target pools to which all new instances in this group are assigned. Existing instances in the group are not affected. + * Modifies the target pools to which all new instances in this group are + * assigned. Existing instances in the group are not affected. * * @param string $instanceGroupManager Name of the managed instance group. * @param string $project Project ID for this request. diff --git a/Compute/samples/V1/RegionInstanceGroupManagersClient/start_instances.php b/Compute/samples/V1/RegionInstanceGroupManagersClient/start_instances.php index 8ec12fcb3b60..5f05c9088df0 100644 --- a/Compute/samples/V1/RegionInstanceGroupManagersClient/start_instances.php +++ b/Compute/samples/V1/RegionInstanceGroupManagersClient/start_instances.php @@ -31,7 +31,22 @@ use Google\Rpc\Status; /** - * Flags the specified instances in the managed instance group to be started. This method increases the targetSize and decreases the targetStoppedSize of the managed instance group by the number of instances that you start. The startInstances operation is marked DONE if the startInstances request is successful. The underlying actions take additional time. You must separately verify the status of the STARTING action with the listmanagedinstances method. In this request, you can only specify instances that are stopped. For example, if an instance was previously stopped using the stopInstances method, it can be started using the startInstances method. If a health check is attached to the managed instance group, the specified instances will be verified as healthy after they are started. You can specify a maximum of 1000 instances with this method per request. + * Flags the specified instances in the managed instance group to be + * started. This method increases thetargetSize and decreases the targetStoppedSize + * of the managed instance group by the number of instances that you start. + * The startInstances operation is marked DONE if + * the startInstances request is successful. The underlying + * actions take additional time. You must separately verify the status of theSTARTING action with thelistmanagedinstances + * method. + * + * In this request, you can only specify instances that are stopped. For + * example, if an instance was previously stopped using the stopInstances + * method, it can be started using the startInstances method. + * + * If a health check is attached to the managed instance group, the specified + * instances will be verified as healthy after they are started. + * + * You can specify a maximum of 1000 instances with this method per request. * * @param string $instanceGroupManager Name of the managed instance group. * @param string $project Project ID for this request. diff --git a/Compute/samples/V1/RegionInstanceGroupManagersClient/stop_instances.php b/Compute/samples/V1/RegionInstanceGroupManagersClient/stop_instances.php index 8abe0fcd78b8..904d965c576b 100644 --- a/Compute/samples/V1/RegionInstanceGroupManagersClient/stop_instances.php +++ b/Compute/samples/V1/RegionInstanceGroupManagersClient/stop_instances.php @@ -31,7 +31,31 @@ use Google\Rpc\Status; /** - * Flags the specified instances in the managed instance group to be immediately stopped. You can only specify instances that are running in this request. This method reduces the targetSize and increases the targetStoppedSize of the managed instance group by the number of instances that you stop. The stopInstances operation is marked DONE if the stopInstances request is successful. The underlying actions take additional time. You must separately verify the status of the STOPPING action with the listmanagedinstances method. If the standbyPolicy.initialDelaySec field is set, the group delays stopping the instances until initialDelaySec have passed from instance.creationTimestamp (that is, when the instance was created). This delay gives your application time to set itself up and initialize on the instance. If more than initialDelaySec seconds have passed since instance.creationTimestamp when this method is called, there will be zero delay. If the group is part of a backend service that has enabled connection draining, it can take up to 60 seconds after the connection draining duration has elapsed before the VM instance is stopped. Stopped instances can be started using the startInstances method. You can specify a maximum of 1000 instances with this method per request. + * Flags the specified instances in the managed instance group to be + * immediately stopped. You can only specify instances that are running in + * this request. This method reduces thetargetSize and increases the targetStoppedSize + * of the managed instance group by the number of instances that you stop. + * The stopInstances operation is marked DONE if + * the stopInstances request is successful. The underlying + * actions take additional time. You must separately verify the status of theSTOPPING action with thelistmanagedinstances + * method. + * + * If the standbyPolicy.initialDelaySec field is set, the group + * delays stopping the instances until initialDelaySec have + * passed from instance.creationTimestamp (that is, when the + * instance was created). This delay gives your application time to + * set itself up and initialize on the instance. If more thaninitialDelaySec seconds have passed sinceinstance.creationTimestamp when this method is called, there + * will be zero delay. + * + * If the group is part of a backend + * service that has enabled + * connection draining, it can take up to 60 seconds after the connection + * draining duration has elapsed before the VM instance is stopped. + * + * Stopped instances can be started using the startInstances + * method. + * + * You can specify a maximum of 1000 instances with this method per request. * * @param string $instanceGroupManager The name of the managed instance group. * @param string $project Project ID for this request. diff --git a/Compute/samples/V1/RegionInstanceGroupManagersClient/suspend_instances.php b/Compute/samples/V1/RegionInstanceGroupManagersClient/suspend_instances.php index 2bdc949ec758..acba499b0fed 100644 --- a/Compute/samples/V1/RegionInstanceGroupManagersClient/suspend_instances.php +++ b/Compute/samples/V1/RegionInstanceGroupManagersClient/suspend_instances.php @@ -31,7 +31,31 @@ use Google\Rpc\Status; /** - * Flags the specified instances in the managed instance group to be immediately suspended. You can only specify instances that are running in this request. This method reduces the targetSize and increases the targetSuspendedSize of the managed instance group by the number of instances that you suspend. The suspendInstances operation is marked DONE if the suspendInstances request is successful. The underlying actions take additional time. You must separately verify the status of the SUSPENDING action with the listmanagedinstances method. If the standbyPolicy.initialDelaySec field is set, the group delays suspension of the instances until initialDelaySec have passed from instance.creationTimestamp (that is, when the instance was created). This delay gives your application time to set itself up and initialize on the instance. If more than initialDelaySec seconds have passed since instance.creationTimestamp when this method is called, there will be zero delay. If the group is part of a backend service that has enabled connection draining, it can take up to 60 seconds after the connection draining duration has elapsed before the VM instance is suspended. Suspended instances can be resumed using the resumeInstances method. You can specify a maximum of 1000 instances with this method per request. + * Flags the specified instances in the managed instance group to be + * immediately suspended. You can only specify instances that are running in + * this request. This method reduces thetargetSize and increases the targetSuspendedSize + * of the managed instance group by the number of instances that you suspend. + * The suspendInstances operation is marked DONE if + * the suspendInstances request is successful. The underlying + * actions take additional time. You must separately verify the status of theSUSPENDING action with thelistmanagedinstances + * method. + * + * If the standbyPolicy.initialDelaySec field is set, the group + * delays suspension of the instances until initialDelaySec have + * passed from instance.creationTimestamp (that is, when the + * instance was created). This delay gives your application time to + * set itself up and initialize on the instance. If more thaninitialDelaySec seconds have passed sinceinstance.creationTimestamp when this method is called, there + * will be zero delay. + * + * If the group is part of a backend + * service that has enabled + * connection draining, it can take up to 60 seconds after the connection + * draining duration has elapsed before the VM instance is suspended. + * + * Suspended instances can be resumed using the resumeInstances + * method. + * + * You can specify a maximum of 1000 instances with this method per request. * * @param string $instanceGroupManager Name of the managed instance group. * @param string $project Project ID for this request. diff --git a/Compute/samples/V1/RegionInstanceGroupManagersClient/update_per_instance_configs.php b/Compute/samples/V1/RegionInstanceGroupManagersClient/update_per_instance_configs.php index 8c4903dc3846..56903e880584 100644 --- a/Compute/samples/V1/RegionInstanceGroupManagersClient/update_per_instance_configs.php +++ b/Compute/samples/V1/RegionInstanceGroupManagersClient/update_per_instance_configs.php @@ -31,9 +31,12 @@ use Google\Rpc\Status; /** - * Inserts or updates per-instance configurations for the managed instance group. perInstanceConfig.name serves as a key used to distinguish whether to perform insert or patch. + * Inserts or updates per-instance configurations for the managed instance + * group. perInstanceConfig.name serves as a key used to + * distinguish whether to perform insert or patch. * - * @param string $instanceGroupManager The name of the managed instance group. It should conform to RFC1035. + * @param string $instanceGroupManager The name of the managed instance group. + * It should conform to RFC1035. * @param string $project Project ID for this request. * @param string $region Name of the region scoping this request, should conform to RFC1035. */ diff --git a/Compute/samples/V1/RegionInstanceGroupsClient/list.php b/Compute/samples/V1/RegionInstanceGroupsClient/list.php index 109568f18d14..f79772d7112b 100644 --- a/Compute/samples/V1/RegionInstanceGroupsClient/list.php +++ b/Compute/samples/V1/RegionInstanceGroupsClient/list.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\ListRegionInstanceGroupsRequest; /** - * Retrieves the list of instance group resources contained within the specified region. + * Retrieves the list of instance group resources contained within + * the specified region. * * @param string $project Project ID for this request. * @param string $region Name of the region scoping this request. diff --git a/Compute/samples/V1/RegionInstanceGroupsClient/list_instances.php b/Compute/samples/V1/RegionInstanceGroupsClient/list_instances.php index bc44edcafbc4..02df50466ded 100644 --- a/Compute/samples/V1/RegionInstanceGroupsClient/list_instances.php +++ b/Compute/samples/V1/RegionInstanceGroupsClient/list_instances.php @@ -30,9 +30,13 @@ use Google\Cloud\Compute\V1\RegionInstanceGroupsListInstancesRequest; /** - * Lists the instances in the specified instance group and displays information about the named ports. Depending on the specified options, this method can list all instances or only the instances that are running. The orderBy query parameter is not supported. + * Lists the instances in the specified instance group and displays + * information about the named ports. Depending on the specified options, this + * method can list all instances or only the instances that are running. + * The orderBy query parameter is not supported. * - * @param string $instanceGroup Name of the regional instance group for which we want to list the instances. + * @param string $instanceGroup Name of the regional instance group for which we want to list the + * instances. * @param string $project Project ID for this request. * @param string $region Name of the region scoping this request. */ diff --git a/Compute/samples/V1/RegionInstanceTemplatesClient/delete.php b/Compute/samples/V1/RegionInstanceTemplatesClient/delete.php index 24c59237ad54..cc287982fb95 100644 --- a/Compute/samples/V1/RegionInstanceTemplatesClient/delete.php +++ b/Compute/samples/V1/RegionInstanceTemplatesClient/delete.php @@ -30,7 +30,8 @@ use Google\Rpc\Status; /** - * Deletes the specified instance template. Deleting an instance template is permanent and cannot be undone. + * Deletes the specified instance template. Deleting an instance template is + * permanent and cannot be undone. * * @param string $instanceTemplate The name of the instance template to delete. * @param string $project Project ID for this request. diff --git a/Compute/samples/V1/RegionInstanceTemplatesClient/insert.php b/Compute/samples/V1/RegionInstanceTemplatesClient/insert.php index b56372502ff9..a168c49e97f5 100644 --- a/Compute/samples/V1/RegionInstanceTemplatesClient/insert.php +++ b/Compute/samples/V1/RegionInstanceTemplatesClient/insert.php @@ -31,7 +31,8 @@ use Google\Rpc\Status; /** - * Creates an instance template in the specified project and region using the global instance template whose URL is included in the request. + * Creates an instance template in the specified project and region using the + * global instance template whose URL is included in the request. * * @param string $project Project ID for this request. * @param string $region The name of the region for this request. diff --git a/Compute/samples/V1/RegionInstanceTemplatesClient/list.php b/Compute/samples/V1/RegionInstanceTemplatesClient/list.php index 03c1126d25d2..54a65be875b4 100644 --- a/Compute/samples/V1/RegionInstanceTemplatesClient/list.php +++ b/Compute/samples/V1/RegionInstanceTemplatesClient/list.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\ListRegionInstanceTemplatesRequest; /** - * Retrieves a list of instance templates that are contained within the specified project and region. + * Retrieves a list of instance templates that are contained within the + * specified project and region. * * @param string $project Project ID for this request. * @param string $region The name of the regions for this request. diff --git a/Compute/samples/V1/RegionInstancesClient/bulk_insert.php b/Compute/samples/V1/RegionInstancesClient/bulk_insert.php index 3cbf15451aa3..13c8cf670e10 100644 --- a/Compute/samples/V1/RegionInstancesClient/bulk_insert.php +++ b/Compute/samples/V1/RegionInstancesClient/bulk_insert.php @@ -31,7 +31,8 @@ use Google\Rpc\Status; /** - * Creates multiple instances in a given region. Count specifies the number of instances to create. + * Creates multiple instances in a given region. Count specifies the number of + * instances to create. * * @param string $project Project ID for this request. * @param string $region The name of the region for this request. diff --git a/Compute/samples/V1/RegionInstantSnapshotsClient/delete.php b/Compute/samples/V1/RegionInstantSnapshotsClient/delete.php index 3df532007368..e9e970d2aef7 100644 --- a/Compute/samples/V1/RegionInstantSnapshotsClient/delete.php +++ b/Compute/samples/V1/RegionInstantSnapshotsClient/delete.php @@ -30,7 +30,14 @@ use Google\Rpc\Status; /** - * Deletes the specified InstantSnapshot resource. Keep in mind that deleting a single instantSnapshot might not necessarily delete all the data on that instantSnapshot. If any data on the instantSnapshot that is marked for deletion is needed for subsequent instantSnapshots, the data will be moved to the next corresponding instantSnapshot. For more information, see Deleting instantSnapshots. + * Deletes the specified InstantSnapshot resource. Keep in mind that deleting + * a single instantSnapshot might not necessarily delete all the data on that + * instantSnapshot. If any data on the instantSnapshot that is marked for + * deletion is needed for subsequent instantSnapshots, the data will be moved + * to the next corresponding instantSnapshot. + * + * For more information, seeDeleting + * instantSnapshots. * * @param string $instantSnapshot Name of the InstantSnapshot resource to delete. * @param string $project Project ID for this request. diff --git a/Compute/samples/V1/RegionInstantSnapshotsClient/get_iam_policy.php b/Compute/samples/V1/RegionInstantSnapshotsClient/get_iam_policy.php index 9c8f1d378f79..ce642771f10b 100644 --- a/Compute/samples/V1/RegionInstantSnapshotsClient/get_iam_policy.php +++ b/Compute/samples/V1/RegionInstantSnapshotsClient/get_iam_policy.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\Policy; /** - * Gets the access control policy for a resource. May be empty if no such policy or resource exists. + * Gets the access control policy for a resource. May be empty if no such + * policy or resource exists. * * @param string $project Project ID for this request. * @param string $region The name of the region for this request. diff --git a/Compute/samples/V1/RegionInstantSnapshotsClient/list.php b/Compute/samples/V1/RegionInstantSnapshotsClient/list.php index 18e6649d2bce..59d67f853d8d 100644 --- a/Compute/samples/V1/RegionInstantSnapshotsClient/list.php +++ b/Compute/samples/V1/RegionInstantSnapshotsClient/list.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\ListRegionInstantSnapshotsRequest; /** - * Retrieves the list of InstantSnapshot resources contained within the specified region. + * Retrieves the list of InstantSnapshot resources contained within + * the specified region. * * @param string $project Project ID for this request. * @param string $region The name of the region for this request. diff --git a/Compute/samples/V1/RegionInstantSnapshotsClient/set_iam_policy.php b/Compute/samples/V1/RegionInstantSnapshotsClient/set_iam_policy.php index 01f1bffa912e..8b675b70a82e 100644 --- a/Compute/samples/V1/RegionInstantSnapshotsClient/set_iam_policy.php +++ b/Compute/samples/V1/RegionInstantSnapshotsClient/set_iam_policy.php @@ -30,7 +30,8 @@ use Google\Cloud\Compute\V1\SetIamPolicyRegionInstantSnapshotRequest; /** - * Sets the access control policy on the specified resource. Replaces any existing policy. + * Sets the access control policy on the specified resource. + * Replaces any existing policy. * * @param string $project Project ID for this request. * @param string $region The name of the region for this request. diff --git a/Compute/samples/V1/RegionInstantSnapshotsClient/set_labels.php b/Compute/samples/V1/RegionInstantSnapshotsClient/set_labels.php index dd54f5792a0c..5cd5910142e3 100644 --- a/Compute/samples/V1/RegionInstantSnapshotsClient/set_labels.php +++ b/Compute/samples/V1/RegionInstantSnapshotsClient/set_labels.php @@ -31,7 +31,9 @@ use Google\Rpc\Status; /** - * Sets the labels on a instantSnapshot in the given region. To learn more about labels, read the Labeling Resources documentation. + * Sets the labels on a instantSnapshot in the given region. To learn more + * about labels, read the Labeling + * Resources documentation. * * @param string $project Project ID for this request. * @param string $region The region for this request. diff --git a/Compute/samples/V1/RegionNetworkEndpointGroupsClient/attach_network_endpoints.php b/Compute/samples/V1/RegionNetworkEndpointGroupsClient/attach_network_endpoints.php index 0d577e5ebf69..f4dc4257d945 100644 --- a/Compute/samples/V1/RegionNetworkEndpointGroupsClient/attach_network_endpoints.php +++ b/Compute/samples/V1/RegionNetworkEndpointGroupsClient/attach_network_endpoints.php @@ -33,9 +33,12 @@ /** * Attach a list of network endpoints to the specified network endpoint group. * - * @param string $networkEndpointGroup The name of the network endpoint group where you are attaching network endpoints to. It should comply with RFC1035. + * @param string $networkEndpointGroup The name of the network endpoint group where you are attaching network + * endpoints to. It should comply with RFC1035. * @param string $project Project ID for this request. - * @param string $region The name of the region where you want to create the network endpoint group. It should comply with RFC1035. + * @param string $region The name of the region where + * you want to create the network endpoint group. It should comply with + * RFC1035. */ function attach_network_endpoints_sample( string $networkEndpointGroup, diff --git a/Compute/samples/V1/RegionNetworkEndpointGroupsClient/delete.php b/Compute/samples/V1/RegionNetworkEndpointGroupsClient/delete.php index 46e4962ab54f..53524c797239 100644 --- a/Compute/samples/V1/RegionNetworkEndpointGroupsClient/delete.php +++ b/Compute/samples/V1/RegionNetworkEndpointGroupsClient/delete.php @@ -30,11 +30,14 @@ use Google\Rpc\Status; /** - * Deletes the specified network endpoint group. Note that the NEG cannot be deleted if it is configured as a backend of a backend service. + * Deletes the specified network endpoint group. Note that the NEG cannot be + * deleted if it is configured as a backend of a backend service. * - * @param string $networkEndpointGroup The name of the network endpoint group to delete. It should comply with RFC1035. + * @param string $networkEndpointGroup The name of the network endpoint group to delete. It should comply with + * RFC1035. * @param string $project Project ID for this request. - * @param string $region The name of the region where the network endpoint group is located. It should comply with RFC1035. + * @param string $region The name of the region where + * the network endpoint group is located. It should comply with RFC1035. */ function delete_sample(string $networkEndpointGroup, string $project, string $region): void { diff --git a/Compute/samples/V1/RegionNetworkEndpointGroupsClient/detach_network_endpoints.php b/Compute/samples/V1/RegionNetworkEndpointGroupsClient/detach_network_endpoints.php index b9146ea38d75..d6f8db9b338e 100644 --- a/Compute/samples/V1/RegionNetworkEndpointGroupsClient/detach_network_endpoints.php +++ b/Compute/samples/V1/RegionNetworkEndpointGroupsClient/detach_network_endpoints.php @@ -33,9 +33,12 @@ /** * Detach the network endpoint from the specified network endpoint group. * - * @param string $networkEndpointGroup The name of the network endpoint group you are detaching network endpoints from. It should comply with RFC1035. + * @param string $networkEndpointGroup The name of the network endpoint group you are detaching network + * endpoints from. It should comply with RFC1035. * @param string $project Project ID for this request. - * @param string $region The name of the region where the network endpoint group is located. It should comply with RFC1035. + * @param string $region The name of the region where + * the network endpoint group is located. It should comply with + * RFC1035. */ function detach_network_endpoints_sample( string $networkEndpointGroup, diff --git a/Compute/samples/V1/RegionNetworkEndpointGroupsClient/get.php b/Compute/samples/V1/RegionNetworkEndpointGroupsClient/get.php index a21dfcea21fd..69130f7cf353 100644 --- a/Compute/samples/V1/RegionNetworkEndpointGroupsClient/get.php +++ b/Compute/samples/V1/RegionNetworkEndpointGroupsClient/get.php @@ -33,7 +33,8 @@ * * @param string $networkEndpointGroup The name of the network endpoint group. It should comply with RFC1035. * @param string $project Project ID for this request. - * @param string $region The name of the region where the network endpoint group is located. It should comply with RFC1035. + * @param string $region The name of the region where + * the network endpoint group is located. It should comply with RFC1035. */ function get_sample(string $networkEndpointGroup, string $project, string $region): void { diff --git a/Compute/samples/V1/RegionNetworkEndpointGroupsClient/insert.php b/Compute/samples/V1/RegionNetworkEndpointGroupsClient/insert.php index 76435f6d517d..e59c73b0953a 100644 --- a/Compute/samples/V1/RegionNetworkEndpointGroupsClient/insert.php +++ b/Compute/samples/V1/RegionNetworkEndpointGroupsClient/insert.php @@ -31,10 +31,13 @@ use Google\Rpc\Status; /** - * Creates a network endpoint group in the specified project using the parameters that are included in the request. + * Creates a network endpoint group in the specified project using the + * parameters that are included in the request. * * @param string $project Project ID for this request. - * @param string $region The name of the region where you want to create the network endpoint group. It should comply with RFC1035. + * @param string $region The name of the region where + * you want to create the network endpoint group. It should comply with + * RFC1035. */ function insert_sample(string $project, string $region): void { diff --git a/Compute/samples/V1/RegionNetworkEndpointGroupsClient/list.php b/Compute/samples/V1/RegionNetworkEndpointGroupsClient/list.php index 7d2bcb14a5de..2b1acf80e776 100644 --- a/Compute/samples/V1/RegionNetworkEndpointGroupsClient/list.php +++ b/Compute/samples/V1/RegionNetworkEndpointGroupsClient/list.php @@ -29,10 +29,12 @@ use Google\Cloud\Compute\V1\ListRegionNetworkEndpointGroupsRequest; /** - * Retrieves the list of regional network endpoint groups available to the specified project in the given region. + * Retrieves the list of regional network endpoint groups available to the + * specified project in the given region. * * @param string $project Project ID for this request. - * @param string $region The name of the region where the network endpoint group is located. It should comply with RFC1035. + * @param string $region The name of theregion + * where the network endpoint group is located. It should comply with RFC1035. */ function list_sample(string $project, string $region): void { diff --git a/Compute/samples/V1/RegionNetworkEndpointGroupsClient/list_network_endpoints.php b/Compute/samples/V1/RegionNetworkEndpointGroupsClient/list_network_endpoints.php index 9281183c28ff..25ab3753e1ce 100644 --- a/Compute/samples/V1/RegionNetworkEndpointGroupsClient/list_network_endpoints.php +++ b/Compute/samples/V1/RegionNetworkEndpointGroupsClient/list_network_endpoints.php @@ -31,9 +31,11 @@ /** * Lists the network endpoints in the specified network endpoint group. * - * @param string $networkEndpointGroup The name of the network endpoint group from which you want to generate a list of included network endpoints. It should comply with RFC1035. + * @param string $networkEndpointGroup The name of the network endpoint group from which you want to generate a + * list of included network endpoints. It should comply with RFC1035. * @param string $project Project ID for this request. - * @param string $region The name of the region where the network endpoint group is located. It should comply with RFC1035. + * @param string $region The name of theregion + * where the network endpoint group is located. It should comply with RFC1035. */ function list_network_endpoints_sample( string $networkEndpointGroup, diff --git a/Compute/samples/V1/RegionNetworkFirewallPoliciesClient/get_iam_policy.php b/Compute/samples/V1/RegionNetworkFirewallPoliciesClient/get_iam_policy.php index 67a83d037b01..b0448fa63a38 100644 --- a/Compute/samples/V1/RegionNetworkFirewallPoliciesClient/get_iam_policy.php +++ b/Compute/samples/V1/RegionNetworkFirewallPoliciesClient/get_iam_policy.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\Policy; /** - * Gets the access control policy for a resource. May be empty if no such policy or resource exists. + * Gets the access control policy for a resource. May be empty if no such + * policy or resource exists. * * @param string $project Project ID for this request. * @param string $region The name of the region for this request. diff --git a/Compute/samples/V1/RegionNetworkFirewallPoliciesClient/list.php b/Compute/samples/V1/RegionNetworkFirewallPoliciesClient/list.php index f4b01150162f..afe9ca9ee997 100644 --- a/Compute/samples/V1/RegionNetworkFirewallPoliciesClient/list.php +++ b/Compute/samples/V1/RegionNetworkFirewallPoliciesClient/list.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\ListRegionNetworkFirewallPoliciesRequest; /** - * Lists all the network firewall policies that have been configured for the specified project in the given region. + * Lists all the network firewall policies that have been configured + * for the specified project in the given region. * * @param string $project Project ID for this request. * @param string $region Name of the region scoping this request. diff --git a/Compute/samples/V1/RegionNetworkFirewallPoliciesClient/set_iam_policy.php b/Compute/samples/V1/RegionNetworkFirewallPoliciesClient/set_iam_policy.php index 285b7c2c9c2a..05aeadc4fe0e 100644 --- a/Compute/samples/V1/RegionNetworkFirewallPoliciesClient/set_iam_policy.php +++ b/Compute/samples/V1/RegionNetworkFirewallPoliciesClient/set_iam_policy.php @@ -30,7 +30,8 @@ use Google\Cloud\Compute\V1\SetIamPolicyRegionNetworkFirewallPolicyRequest; /** - * Sets the access control policy on the specified resource. Replaces any existing policy. + * Sets the access control policy on the specified resource. + * Replaces any existing policy. * * @param string $project Project ID for this request. * @param string $region The name of the region for this request. diff --git a/Compute/samples/V1/RegionNotificationEndpointsClient/insert.php b/Compute/samples/V1/RegionNotificationEndpointsClient/insert.php index fe55d860502a..a229734fb652 100644 --- a/Compute/samples/V1/RegionNotificationEndpointsClient/insert.php +++ b/Compute/samples/V1/RegionNotificationEndpointsClient/insert.php @@ -31,7 +31,8 @@ use Google\Rpc\Status; /** - * Create a NotificationEndpoint in the specified project in the given region using the parameters that are included in the request. + * Create a NotificationEndpoint in the specified project in the given region + * using the parameters that are included in the request. * * @param string $project Project ID for this request. * @param string $region Name of the region scoping this request. diff --git a/Compute/samples/V1/RegionOperationsClient/delete.php b/Compute/samples/V1/RegionOperationsClient/delete.php index 2f1c1e43dd5e..c2b25f218862 100644 --- a/Compute/samples/V1/RegionOperationsClient/delete.php +++ b/Compute/samples/V1/RegionOperationsClient/delete.php @@ -31,7 +31,8 @@ /** * Deletes the specified region-specific Operations resource. * - * @param string $operation Name of the Operations resource to delete, or its unique numeric identifier. + * @param string $operation Name of the Operations resource to delete, or its unique numeric + * identifier. * @param string $project Project ID for this request. * @param string $region Name of the region for this request. */ diff --git a/Compute/samples/V1/RegionOperationsClient/get.php b/Compute/samples/V1/RegionOperationsClient/get.php index b202f68380b4..3e5c042c5ccd 100644 --- a/Compute/samples/V1/RegionOperationsClient/get.php +++ b/Compute/samples/V1/RegionOperationsClient/get.php @@ -31,7 +31,8 @@ /** * Retrieves the specified region-specific Operations resource. * - * @param string $operation Name of the Operations resource to return, or its unique numeric identifier. + * @param string $operation Name of the Operations resource to return, or its unique numeric + * identifier. * @param string $project Project ID for this request. * @param string $region Name of the region for this request. */ diff --git a/Compute/samples/V1/RegionOperationsClient/list.php b/Compute/samples/V1/RegionOperationsClient/list.php index fbae8276336d..31b6b425f330 100644 --- a/Compute/samples/V1/RegionOperationsClient/list.php +++ b/Compute/samples/V1/RegionOperationsClient/list.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\ListRegionOperationsRequest; /** - * Retrieves a list of Operation resources contained within the specified region. + * Retrieves a list of Operation resources contained within + * the specified region. * * @param string $project Project ID for this request. * @param string $region Name of the region for this request. diff --git a/Compute/samples/V1/RegionOperationsClient/wait.php b/Compute/samples/V1/RegionOperationsClient/wait.php index 5c7d6dfb578f..ea497bffb778 100644 --- a/Compute/samples/V1/RegionOperationsClient/wait.php +++ b/Compute/samples/V1/RegionOperationsClient/wait.php @@ -29,9 +29,25 @@ use Google\Cloud\Compute\V1\WaitRegionOperationRequest; /** - * Waits for the specified Operation resource to return as `DONE` or for the request to approach the 2 minute deadline, and retrieves the specified Operation resource. This method differs from the `GET` method in that it waits for no more than the default deadline (2 minutes) and then returns the current state of the operation, which might be `DONE` or still in progress. This method is called on a best-effort basis. Specifically: - In uncommon cases, when the server is overloaded, the request might return before the default deadline is reached, or might return after zero seconds. - If the default deadline is reached, there is no guarantee that the operation is actually done when the method returns. Be prepared to retry if the operation is not `DONE`. + * Waits for the specified Operation resource to return as `DONE` + * or for the request to approach the 2 minute deadline, and retrieves the + * specified Operation resource. This method differs from the + * `GET` method in that it waits for no more than the default + * deadline (2 minutes) and then returns the current state of the operation, + * which might be `DONE` or still in progress. * - * @param string $operation Name of the Operations resource to return, or its unique numeric identifier. + * This method is called on a best-effort basis. Specifically: + * + * + * - In uncommon cases, when the server is overloaded, the request might + * return before the default deadline is reached, or might return after zero + * seconds. + * - If the default deadline is reached, there is no guarantee that the + * operation is actually done when the method returns. Be prepared to retry + * if the operation is not `DONE`. + * + * @param string $operation Name of the Operations resource to return, or its unique numeric + * identifier. * @param string $project Project ID for this request. * @param string $region Name of the region for this request. */ diff --git a/Compute/samples/V1/RegionSecurityPoliciesClient/insert.php b/Compute/samples/V1/RegionSecurityPoliciesClient/insert.php index 403666bea646..b358b37c396e 100644 --- a/Compute/samples/V1/RegionSecurityPoliciesClient/insert.php +++ b/Compute/samples/V1/RegionSecurityPoliciesClient/insert.php @@ -31,7 +31,8 @@ use Google\Rpc\Status; /** - * Creates a new policy in the specified project using the data included in the request. + * Creates a new policy in the specified project using the data included in + * the request. * * @param string $project Project ID for this request. * @param string $region Name of the region scoping this request. diff --git a/Compute/samples/V1/RegionSecurityPoliciesClient/list.php b/Compute/samples/V1/RegionSecurityPoliciesClient/list.php index 930d7def45e9..b358cea2590c 100644 --- a/Compute/samples/V1/RegionSecurityPoliciesClient/list.php +++ b/Compute/samples/V1/RegionSecurityPoliciesClient/list.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\ListRegionSecurityPoliciesRequest; /** - * List all the policies that have been configured for the specified project and region. + * List all the policies that have been configured for the specified project + * and region. * * @param string $project Project ID for this request. * @param string $region Name of the region scoping this request. diff --git a/Compute/samples/V1/RegionSecurityPoliciesClient/patch.php b/Compute/samples/V1/RegionSecurityPoliciesClient/patch.php index 3c11f2eea33a..784f88633c80 100644 --- a/Compute/samples/V1/RegionSecurityPoliciesClient/patch.php +++ b/Compute/samples/V1/RegionSecurityPoliciesClient/patch.php @@ -31,7 +31,11 @@ use Google\Rpc\Status; /** - * Patches the specified policy with the data included in the request. To clear fields in the policy, leave the fields empty and specify them in the updateMask. This cannot be used to be update the rules in the policy. Please use the per rule methods like addRule, patchRule, and removeRule instead. + * Patches the specified policy with the data included in the request. To + * clear fields in the policy, leave the fields empty and specify them in the + * updateMask. This cannot be used to be update the rules in the policy. + * Please use the per rule methods like addRule, patchRule, and removeRule + * instead. * * @param string $project Project ID for this request. * @param string $region Name of the region scoping this request. diff --git a/Compute/samples/V1/RegionSecurityPoliciesClient/patch_rule.php b/Compute/samples/V1/RegionSecurityPoliciesClient/patch_rule.php index 247c43be89f8..4fa2818f0eb5 100644 --- a/Compute/samples/V1/RegionSecurityPoliciesClient/patch_rule.php +++ b/Compute/samples/V1/RegionSecurityPoliciesClient/patch_rule.php @@ -31,7 +31,8 @@ use Google\Rpc\Status; /** - * Patches a rule at the specified priority. To clear fields in the rule, leave the fields empty and specify them in the updateMask. + * Patches a rule at the specified priority. To clear fields in the rule, + * leave the fields empty and specify them in the updateMask. * * @param string $project Project ID for this request. * @param string $region Name of the region scoping this request. diff --git a/Compute/samples/V1/RegionSecurityPoliciesClient/set_labels.php b/Compute/samples/V1/RegionSecurityPoliciesClient/set_labels.php index 18376f8bc446..507a78809b70 100644 --- a/Compute/samples/V1/RegionSecurityPoliciesClient/set_labels.php +++ b/Compute/samples/V1/RegionSecurityPoliciesClient/set_labels.php @@ -31,7 +31,9 @@ use Google\Rpc\Status; /** - * Sets the labels on a security policy. To learn more about labels, read the Labeling Resources documentation. + * Sets the labels on a security policy. To learn more about labels, + * read the Labeling Resources + * documentation. * * @param string $project Project ID for this request. * @param string $region The region for this request. diff --git a/Compute/samples/V1/RegionSslCertificatesClient/get.php b/Compute/samples/V1/RegionSslCertificatesClient/get.php index e2195495b9bd..4d54b88f133c 100644 --- a/Compute/samples/V1/RegionSslCertificatesClient/get.php +++ b/Compute/samples/V1/RegionSslCertificatesClient/get.php @@ -29,7 +29,9 @@ use Google\Cloud\Compute\V1\SslCertificate; /** - * Returns the specified SslCertificate resource in the specified region. Get a list of available SSL certificates by making a list() request. + * Returns the specified SslCertificate resource in the specified region. Get + * a list of available SSL certificates by making a list() + * request. * * @param string $project Project ID for this request. * @param string $region Name of the region scoping this request. diff --git a/Compute/samples/V1/RegionSslCertificatesClient/insert.php b/Compute/samples/V1/RegionSslCertificatesClient/insert.php index 82823fd3a544..59b22e352b89 100644 --- a/Compute/samples/V1/RegionSslCertificatesClient/insert.php +++ b/Compute/samples/V1/RegionSslCertificatesClient/insert.php @@ -31,7 +31,8 @@ use Google\Rpc\Status; /** - * Creates a SslCertificate resource in the specified project and region using the data included in the request + * Creates a SslCertificate resource in the specified project and region using + * the data included in the request * * @param string $project Project ID for this request. * @param string $region Name of the region scoping this request. diff --git a/Compute/samples/V1/RegionSslCertificatesClient/list.php b/Compute/samples/V1/RegionSslCertificatesClient/list.php index a5c38de9e47a..ed2986504997 100644 --- a/Compute/samples/V1/RegionSslCertificatesClient/list.php +++ b/Compute/samples/V1/RegionSslCertificatesClient/list.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\ListRegionSslCertificatesRequest; /** - * Retrieves the list of SslCertificate resources available to the specified project in the specified region. + * Retrieves the list of SslCertificate resources available to the specified + * project in the specified region. * * @param string $project Project ID for this request. * @param string $region Name of the region scoping this request. diff --git a/Compute/samples/V1/RegionSslPoliciesClient/delete.php b/Compute/samples/V1/RegionSslPoliciesClient/delete.php index 5e308a87d2f9..a26eb2ae6cc6 100644 --- a/Compute/samples/V1/RegionSslPoliciesClient/delete.php +++ b/Compute/samples/V1/RegionSslPoliciesClient/delete.php @@ -30,11 +30,14 @@ use Google\Rpc\Status; /** - * Deletes the specified SSL policy. The SSL policy resource can be deleted only if it is not in use by any TargetHttpsProxy or TargetSslProxy resources. + * Deletes the specified SSL policy. The SSL policy resource can be deleted + * only if it is not in use by any TargetHttpsProxy or TargetSslProxy + * resources. * * @param string $project Project ID for this request. * @param string $region Name of the region scoping this request. - * @param string $sslPolicy Name of the SSL policy to delete. The name must be 1-63 characters long, and comply with RFC1035. + * @param string $sslPolicy Name of the SSL policy to delete. The name must be 1-63 characters long, + * and comply with RFC1035. */ function delete_sample(string $project, string $region, string $sslPolicy): void { diff --git a/Compute/samples/V1/RegionSslPoliciesClient/get.php b/Compute/samples/V1/RegionSslPoliciesClient/get.php index 4d469ab07a86..d41450c219f5 100644 --- a/Compute/samples/V1/RegionSslPoliciesClient/get.php +++ b/Compute/samples/V1/RegionSslPoliciesClient/get.php @@ -33,7 +33,8 @@ * * @param string $project Project ID for this request. * @param string $region Name of the region scoping this request. - * @param string $sslPolicy Name of the SSL policy to update. The name must be 1-63 characters long, and comply with RFC1035. + * @param string $sslPolicy Name of the SSL policy to update. The name must be 1-63 characters long, + * and comply with RFC1035. */ function get_sample(string $project, string $region, string $sslPolicy): void { diff --git a/Compute/samples/V1/RegionSslPoliciesClient/insert.php b/Compute/samples/V1/RegionSslPoliciesClient/insert.php index 04bbaadfa367..01019e22146b 100644 --- a/Compute/samples/V1/RegionSslPoliciesClient/insert.php +++ b/Compute/samples/V1/RegionSslPoliciesClient/insert.php @@ -31,7 +31,8 @@ use Google\Rpc\Status; /** - * Creates a new policy in the specified project and region using the data included in the request. + * Creates a new policy in the specified project and region using the data + * included in the request. * * @param string $project Project ID for this request. * @param string $region Name of the region scoping this request. diff --git a/Compute/samples/V1/RegionSslPoliciesClient/list.php b/Compute/samples/V1/RegionSslPoliciesClient/list.php index f9419ad26677..8c54fe1f33df 100644 --- a/Compute/samples/V1/RegionSslPoliciesClient/list.php +++ b/Compute/samples/V1/RegionSslPoliciesClient/list.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\ListRegionSslPoliciesRequest; /** - * Lists all the SSL policies that have been configured for the specified project and region. + * Lists all the SSL policies that have been configured for the specified + * project and region. * * @param string $project Project ID for this request. * @param string $region Name of the region scoping this request. diff --git a/Compute/samples/V1/RegionSslPoliciesClient/list_available_features.php b/Compute/samples/V1/RegionSslPoliciesClient/list_available_features.php index fe5e24401411..06f6855ead34 100644 --- a/Compute/samples/V1/RegionSslPoliciesClient/list_available_features.php +++ b/Compute/samples/V1/RegionSslPoliciesClient/list_available_features.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\SslPoliciesListAvailableFeaturesResponse; /** - * Lists all features that can be specified in the SSL policy when using custom profile. + * Lists all features that can be specified in the SSL policy when using + * custom profile. * * @param string $project Project ID for this request. * @param string $region Name of the region scoping this request. diff --git a/Compute/samples/V1/RegionSslPoliciesClient/patch.php b/Compute/samples/V1/RegionSslPoliciesClient/patch.php index 15f8865fb92a..7638b1762cb8 100644 --- a/Compute/samples/V1/RegionSslPoliciesClient/patch.php +++ b/Compute/samples/V1/RegionSslPoliciesClient/patch.php @@ -35,7 +35,8 @@ * * @param string $project Project ID for this request. * @param string $region Name of the region scoping this request. - * @param string $sslPolicy Name of the SSL policy to update. The name must be 1-63 characters long, and comply with RFC1035. + * @param string $sslPolicy Name of the SSL policy to update. The name must be 1-63 characters long, + * and comply with RFC1035. */ function patch_sample(string $project, string $region, string $sslPolicy): void { diff --git a/Compute/samples/V1/RegionTargetHttpProxiesClient/insert.php b/Compute/samples/V1/RegionTargetHttpProxiesClient/insert.php index 785e8d4dd99e..b8004ab8c4c0 100644 --- a/Compute/samples/V1/RegionTargetHttpProxiesClient/insert.php +++ b/Compute/samples/V1/RegionTargetHttpProxiesClient/insert.php @@ -31,7 +31,8 @@ use Google\Rpc\Status; /** - * Creates a TargetHttpProxy resource in the specified project and region using the data included in the request. + * Creates a TargetHttpProxy resource in the specified project and region + * using the data included in the request. * * @param string $project Project ID for this request. * @param string $region Name of the region scoping this request. diff --git a/Compute/samples/V1/RegionTargetHttpProxiesClient/list.php b/Compute/samples/V1/RegionTargetHttpProxiesClient/list.php index 2c89e7df3102..21299bfb3c7f 100644 --- a/Compute/samples/V1/RegionTargetHttpProxiesClient/list.php +++ b/Compute/samples/V1/RegionTargetHttpProxiesClient/list.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\ListRegionTargetHttpProxiesRequest; /** - * Retrieves the list of TargetHttpProxy resources available to the specified project in the specified region. + * Retrieves the list of TargetHttpProxy resources available + * to the specified project in the specified region. * * @param string $project Project ID for this request. * @param string $region Name of the region scoping this request. diff --git a/Compute/samples/V1/RegionTargetHttpsProxiesClient/insert.php b/Compute/samples/V1/RegionTargetHttpsProxiesClient/insert.php index 60c4aac050a8..5e52539dae8c 100644 --- a/Compute/samples/V1/RegionTargetHttpsProxiesClient/insert.php +++ b/Compute/samples/V1/RegionTargetHttpsProxiesClient/insert.php @@ -31,7 +31,8 @@ use Google\Rpc\Status; /** - * Creates a TargetHttpsProxy resource in the specified project and region using the data included in the request. + * Creates a TargetHttpsProxy resource in the specified project and region + * using the data included in the request. * * @param string $project Project ID for this request. * @param string $region Name of the region scoping this request. diff --git a/Compute/samples/V1/RegionTargetHttpsProxiesClient/list.php b/Compute/samples/V1/RegionTargetHttpsProxiesClient/list.php index 109a3cbe223e..f3475d85bfeb 100644 --- a/Compute/samples/V1/RegionTargetHttpsProxiesClient/list.php +++ b/Compute/samples/V1/RegionTargetHttpsProxiesClient/list.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\ListRegionTargetHttpsProxiesRequest; /** - * Retrieves the list of TargetHttpsProxy resources available to the specified project in the specified region. + * Retrieves the list of TargetHttpsProxy resources available + * to the specified project in the specified region. * * @param string $project Project ID for this request. * @param string $region Name of the region scoping this request. diff --git a/Compute/samples/V1/RegionTargetHttpsProxiesClient/patch.php b/Compute/samples/V1/RegionTargetHttpsProxiesClient/patch.php index 8cc6b90f839b..f3b702f48125 100644 --- a/Compute/samples/V1/RegionTargetHttpsProxiesClient/patch.php +++ b/Compute/samples/V1/RegionTargetHttpsProxiesClient/patch.php @@ -31,7 +31,10 @@ use Google\Rpc\Status; /** - * Patches the specified regional TargetHttpsProxy resource with the data included in the request. This method supports PATCH semantics and uses JSON merge patch format and processing rules. + * Patches the specified regional TargetHttpsProxy resource with the data + * included in the request. This method supports PATCH + * semantics and usesJSON merge + * patch format and processing rules. * * @param string $project Project ID for this request. * @param string $region Name of the region for this request. diff --git a/Compute/samples/V1/RegionTargetHttpsProxiesClient/set_ssl_certificates.php b/Compute/samples/V1/RegionTargetHttpsProxiesClient/set_ssl_certificates.php index e3d5feb7f1a3..e6f396e1c4bf 100644 --- a/Compute/samples/V1/RegionTargetHttpsProxiesClient/set_ssl_certificates.php +++ b/Compute/samples/V1/RegionTargetHttpsProxiesClient/set_ssl_certificates.php @@ -35,7 +35,8 @@ * * @param string $project Project ID for this request. * @param string $region Name of the region scoping this request. - * @param string $targetHttpsProxy Name of the TargetHttpsProxy resource to set an SslCertificates resource for. + * @param string $targetHttpsProxy Name of the TargetHttpsProxy resource to set an + * SslCertificates resource for. */ function set_ssl_certificates_sample( string $project, diff --git a/Compute/samples/V1/RegionTargetTcpProxiesClient/insert.php b/Compute/samples/V1/RegionTargetTcpProxiesClient/insert.php index ab9e9023b2b5..bc2e872ffb63 100644 --- a/Compute/samples/V1/RegionTargetTcpProxiesClient/insert.php +++ b/Compute/samples/V1/RegionTargetTcpProxiesClient/insert.php @@ -31,7 +31,8 @@ use Google\Rpc\Status; /** - * Creates a TargetTcpProxy resource in the specified project and region using the data included in the request. + * Creates a TargetTcpProxy resource in the specified project and region using + * the data included in the request. * * @param string $project Project ID for this request. * @param string $region Name of the region scoping this request. diff --git a/Compute/samples/V1/RegionTargetTcpProxiesClient/list.php b/Compute/samples/V1/RegionTargetTcpProxiesClient/list.php index d3394f2ef14e..987f42f61639 100644 --- a/Compute/samples/V1/RegionTargetTcpProxiesClient/list.php +++ b/Compute/samples/V1/RegionTargetTcpProxiesClient/list.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\ListRegionTargetTcpProxiesRequest; /** - * Retrieves a list of TargetTcpProxy resources available to the specified project in a given region. + * Retrieves a list of TargetTcpProxy resources + * available to the specified project in a given region. * * @param string $project Project ID for this request. * @param string $region Name of the region scoping this request. diff --git a/Compute/samples/V1/RegionUrlMapsClient/insert.php b/Compute/samples/V1/RegionUrlMapsClient/insert.php index ed454435f46f..a558a6659d98 100644 --- a/Compute/samples/V1/RegionUrlMapsClient/insert.php +++ b/Compute/samples/V1/RegionUrlMapsClient/insert.php @@ -31,7 +31,8 @@ use Google\Rpc\Status; /** - * Creates a UrlMap resource in the specified project using the data included in the request. + * Creates a UrlMap resource in the specified project using + * the data included in the request. * * @param string $project Project ID for this request. * @param string $region Name of the region scoping this request. diff --git a/Compute/samples/V1/RegionUrlMapsClient/list.php b/Compute/samples/V1/RegionUrlMapsClient/list.php index 6ab8968dd8ec..8af11e207347 100644 --- a/Compute/samples/V1/RegionUrlMapsClient/list.php +++ b/Compute/samples/V1/RegionUrlMapsClient/list.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\ListRegionUrlMapsRequest; /** - * Retrieves the list of UrlMap resources available to the specified project in the specified region. + * Retrieves the list of UrlMap resources available to the specified + * project in the specified region. * * @param string $project Project ID for this request. * @param string $region Name of the region scoping this request. diff --git a/Compute/samples/V1/RegionUrlMapsClient/patch.php b/Compute/samples/V1/RegionUrlMapsClient/patch.php index 44cd84fcaba2..b8a151f7833b 100644 --- a/Compute/samples/V1/RegionUrlMapsClient/patch.php +++ b/Compute/samples/V1/RegionUrlMapsClient/patch.php @@ -31,7 +31,10 @@ use Google\Rpc\Status; /** - * Patches the specified UrlMap resource with the data included in the request. This method supports PATCH semantics and uses JSON merge patch format and processing rules. + * Patches the specified UrlMap resource with the data included in the + * request. This method supportsPATCH + * semantics and usesJSON merge + * patch format and processing rules. * * @param string $project Project ID for this request. * @param string $region Name of the region scoping this request. diff --git a/Compute/samples/V1/RegionUrlMapsClient/update.php b/Compute/samples/V1/RegionUrlMapsClient/update.php index 18f7b9149256..63e3173cfb04 100644 --- a/Compute/samples/V1/RegionUrlMapsClient/update.php +++ b/Compute/samples/V1/RegionUrlMapsClient/update.php @@ -31,7 +31,8 @@ use Google\Rpc\Status; /** - * Updates the specified UrlMap resource with the data included in the request. + * Updates the specified UrlMap resource with the data included in the + * request. * * @param string $project Project ID for this request. * @param string $region Name of the region scoping this request. diff --git a/Compute/samples/V1/RegionUrlMapsClient/validate.php b/Compute/samples/V1/RegionUrlMapsClient/validate.php index 98bc83833431..a3017dcc5053 100644 --- a/Compute/samples/V1/RegionUrlMapsClient/validate.php +++ b/Compute/samples/V1/RegionUrlMapsClient/validate.php @@ -30,7 +30,9 @@ use Google\Cloud\Compute\V1\ValidateRegionUrlMapRequest; /** - * Runs static validation for the UrlMap. In particular, the tests of the provided UrlMap will be run. Calling this method does NOT create the UrlMap. + * Runs static validation for the UrlMap. In particular, the tests of the + * provided UrlMap will be run. Calling this method does NOT create the + * UrlMap. * * @param string $project Project ID for this request. * @param string $region Name of the region scoping this request. diff --git a/Compute/samples/V1/RegionZonesClient/list.php b/Compute/samples/V1/RegionZonesClient/list.php index b17d27970a6a..c8c2f8652884 100644 --- a/Compute/samples/V1/RegionZonesClient/list.php +++ b/Compute/samples/V1/RegionZonesClient/list.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\ListRegionZonesRequest; /** - * Retrieves the list of Zone resources under the specific region available to the specified project. + * Retrieves the list of Zone resources under the specific region available to + * the specified project. * * @param string $project Project ID for this request. * @param string $region Region for this request. diff --git a/Compute/samples/V1/RegionsClient/get.php b/Compute/samples/V1/RegionsClient/get.php index 6b2450984049..58ea3aa879ba 100644 --- a/Compute/samples/V1/RegionsClient/get.php +++ b/Compute/samples/V1/RegionsClient/get.php @@ -29,7 +29,24 @@ use Google\Cloud\Compute\V1\Region; /** - * Returns the specified Region resource. To decrease latency for this method, you can optionally omit any unneeded information from the response by using a field mask. This practice is especially recommended for unused quota information (the `quotas` field). To exclude one or more fields, set your request's `fields` query parameter to only include the fields you need. For example, to only include the `id` and `selfLink` fields, add the query parameter `?fields=id,selfLink` to your request. This method fails if the quota information is unavailable for the region and if the organization policy constraint compute.requireBasicQuotaInResponse is enforced. This constraint, when enforced, disables the fail-open behaviour when quota information (the `items.quotas` field) is unavailable for the region. It is recommended to use the default setting for the constraint unless your application requires the fail-closed behaviour for this method. + * Returns the specified Region resource. + * + * To decrease latency for this method, you can optionally omit any unneeded + * information from the response by using a field mask. This practice is + * especially recommended for unused quota information (the `quotas` field). + * To exclude one or more fields, set your request's `fields` query parameter + * to only include the fields you need. For example, to only include the `id` + * and `selfLink` fields, add the query parameter `?fields=id,selfLink` to + * your request. + * + * This method fails if the quota information is unavailable for the region + * and if the organization policy constraint + * compute.requireBasicQuotaInResponse is enforced. This + * constraint, when enforced, disables the fail-open behaviour when quota + * information (the `items.quotas` field) is unavailable for the region. + * It is recommended to use the default setting + * for the constraint unless your application requires the fail-closed + * behaviour for this method. * * @param string $project Project ID for this request. * @param string $region Name of the region resource to return. diff --git a/Compute/samples/V1/RegionsClient/list.php b/Compute/samples/V1/RegionsClient/list.php index ae5e7c52a133..1904f92d01d8 100644 --- a/Compute/samples/V1/RegionsClient/list.php +++ b/Compute/samples/V1/RegionsClient/list.php @@ -29,7 +29,25 @@ use Google\Cloud\Compute\V1\ListRegionsRequest; /** - * Retrieves the list of region resources available to the specified project. To decrease latency for this method, you can optionally omit any unneeded information from the response by using a field mask. This practice is especially recommended for unused quota information (the `items.quotas` field). To exclude one or more fields, set your request's `fields` query parameter to only include the fields you need. For example, to only include the `id` and `selfLink` fields, add the query parameter `?fields=id,selfLink` to your request. This method fails if the quota information is unavailable for the region and if the organization policy constraint compute.requireBasicQuotaInResponse is enforced. This constraint, when enforced, disables the fail-open behaviour when quota information (the `items.quotas` field) is unavailable for the region. It is recommended to use the default setting for the constraint unless your application requires the fail-closed behaviour for this method. + * Retrieves the list of region resources available to the specified project. + * + * To decrease latency for this method, you can optionally omit any unneeded + * information from the response by using a field mask. This practice is + * especially recommended for unused quota information + * (the `items.quotas` field). + * To exclude one or more fields, set your request's `fields` query parameter + * to only include the fields you need. For example, to only include the `id` + * and `selfLink` fields, add the query parameter `?fields=id,selfLink` to + * your request. + * + * This method fails if the quota information is unavailable for the region + * and if the organization policy constraint + * compute.requireBasicQuotaInResponse is enforced. This + * constraint, when enforced, disables the fail-open behaviour when quota + * information (the `items.quotas` field) is unavailable for the region. + * It is recommended to use the default setting + * for the constraint unless your application requires the fail-closed + * behaviour for this method. * * @param string $project Project ID for this request. */ diff --git a/Compute/samples/V1/ReservationBlocksClient/get.php b/Compute/samples/V1/ReservationBlocksClient/get.php index e28f433bcf3a..bf72c4fcdbe1 100644 --- a/Compute/samples/V1/ReservationBlocksClient/get.php +++ b/Compute/samples/V1/ReservationBlocksClient/get.php @@ -32,8 +32,10 @@ * Retrieves information about the specified reservation block. * * @param string $project Project ID for this request. - * @param string $reservation The name of the reservation. Name should conform to RFC1035 or be a resource ID. - * @param string $reservationBlock The name of the reservation block. Name should conform to RFC1035 or be a resource ID. + * @param string $reservation The name of the reservation. + * Name should conform to RFC1035 or be a resource ID. + * @param string $reservationBlock The name of the reservation block. + * Name should conform to RFC1035 or be a resource ID. * @param string $zone Name of the zone for this request. Zone name should conform to RFC1035. */ function get_sample( diff --git a/Compute/samples/V1/ReservationBlocksClient/get_iam_policy.php b/Compute/samples/V1/ReservationBlocksClient/get_iam_policy.php new file mode 100644 index 000000000000..ab7f7b05df72 --- /dev/null +++ b/Compute/samples/V1/ReservationBlocksClient/get_iam_policy.php @@ -0,0 +1,84 @@ +setParentResource($parentResource) + ->setProject($project) + ->setResource($resource) + ->setZone($zone); + + // Call the API and handle any network failures. + try { + /** @var Policy $response */ + $response = $reservationBlocksClient->getIamPolicy($request); + printf('Response data: %s' . PHP_EOL, $response->serializeToJsonString()); + } catch (ApiException $ex) { + printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage()); + } +} + +/** + * Helper to execute the sample. + * + * This sample has been automatically generated and should be regarded as a code + * template only. It will require modifications to work: + * - It may require correct/in-range values for request initialization. + * - It may require specifying regional endpoints when creating the service client, + * please see the apiEndpoint client configuration option for more details. + */ +function callSample(): void +{ + $parentResource = '[PARENT_RESOURCE]'; + $project = '[PROJECT]'; + $resource = '[RESOURCE]'; + $zone = '[ZONE]'; + + get_iam_policy_sample($parentResource, $project, $resource, $zone); +} +// [END compute_v1_generated_ReservationBlocks_GetIamPolicy_sync] diff --git a/Compute/samples/V1/ReservationBlocksClient/list.php b/Compute/samples/V1/ReservationBlocksClient/list.php index d0dd32b9394d..9e61fbd56a77 100644 --- a/Compute/samples/V1/ReservationBlocksClient/list.php +++ b/Compute/samples/V1/ReservationBlocksClient/list.php @@ -32,7 +32,8 @@ * Retrieves a list of reservation blocks under a single reservation. * * @param string $project Project ID for this request. - * @param string $reservation The name of the reservation. Name should conform to RFC1035 or be a resource ID. + * @param string $reservation The name of the reservation. + * Name should conform to RFC1035 or be a resource ID. * @param string $zone Name of the zone for this request. Zone name should conform to RFC1035. */ function list_sample(string $project, string $reservation, string $zone): void diff --git a/Compute/samples/V1/ReservationBlocksClient/perform_maintenance.php b/Compute/samples/V1/ReservationBlocksClient/perform_maintenance.php index c1cafd040bfc..7f233008892d 100644 --- a/Compute/samples/V1/ReservationBlocksClient/perform_maintenance.php +++ b/Compute/samples/V1/ReservationBlocksClient/perform_maintenance.php @@ -34,8 +34,10 @@ * Allows customers to perform maintenance on a reservation block * * @param string $project Project ID for this request. - * @param string $reservation The name of the reservation. Name should conform to RFC1035 or be a resource ID. - * @param string $reservationBlock The name of the reservation block. Name should conform to RFC1035 or be a resource ID. + * @param string $reservation The name of the reservation. + * Name should conform to RFC1035 or be a resource ID. + * @param string $reservationBlock The name of the reservation block. + * Name should conform to RFC1035 or be a resource ID. * @param string $zone Name of the zone for this request. Zone name should conform to RFC1035. */ function perform_maintenance_sample( diff --git a/Compute/samples/V1/ReservationBlocksClient/set_iam_policy.php b/Compute/samples/V1/ReservationBlocksClient/set_iam_policy.php new file mode 100644 index 000000000000..5d152d622d80 --- /dev/null +++ b/Compute/samples/V1/ReservationBlocksClient/set_iam_policy.php @@ -0,0 +1,87 @@ +setParentResource($parentResource) + ->setProject($project) + ->setResource($resource) + ->setZone($zone) + ->setZoneSetNestedPolicyRequestResource($zoneSetNestedPolicyRequestResource); + + // Call the API and handle any network failures. + try { + /** @var Policy $response */ + $response = $reservationBlocksClient->setIamPolicy($request); + printf('Response data: %s' . PHP_EOL, $response->serializeToJsonString()); + } catch (ApiException $ex) { + printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage()); + } +} + +/** + * Helper to execute the sample. + * + * This sample has been automatically generated and should be regarded as a code + * template only. It will require modifications to work: + * - It may require correct/in-range values for request initialization. + * - It may require specifying regional endpoints when creating the service client, + * please see the apiEndpoint client configuration option for more details. + */ +function callSample(): void +{ + $parentResource = '[PARENT_RESOURCE]'; + $project = '[PROJECT]'; + $resource = '[RESOURCE]'; + $zone = '[ZONE]'; + + set_iam_policy_sample($parentResource, $project, $resource, $zone); +} +// [END compute_v1_generated_ReservationBlocks_SetIamPolicy_sync] diff --git a/Compute/samples/V1/ReservationBlocksClient/test_iam_permissions.php b/Compute/samples/V1/ReservationBlocksClient/test_iam_permissions.php new file mode 100644 index 000000000000..560d852c2a11 --- /dev/null +++ b/Compute/samples/V1/ReservationBlocksClient/test_iam_permissions.php @@ -0,0 +1,86 @@ +setParentResource($parentResource) + ->setProject($project) + ->setResource($resource) + ->setTestPermissionsRequestResource($testPermissionsRequestResource) + ->setZone($zone); + + // Call the API and handle any network failures. + try { + /** @var TestPermissionsResponse $response */ + $response = $reservationBlocksClient->testIamPermissions($request); + printf('Response data: %s' . PHP_EOL, $response->serializeToJsonString()); + } catch (ApiException $ex) { + printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage()); + } +} + +/** + * Helper to execute the sample. + * + * This sample has been automatically generated and should be regarded as a code + * template only. It will require modifications to work: + * - It may require correct/in-range values for request initialization. + * - It may require specifying regional endpoints when creating the service client, + * please see the apiEndpoint client configuration option for more details. + */ +function callSample(): void +{ + $parentResource = '[PARENT_RESOURCE]'; + $project = '[PROJECT]'; + $resource = '[RESOURCE]'; + $zone = '[ZONE]'; + + test_iam_permissions_sample($parentResource, $project, $resource, $zone); +} +// [END compute_v1_generated_ReservationBlocks_TestIamPermissions_sync] diff --git a/Compute/samples/V1/ReservationSubBlocksClient/get.php b/Compute/samples/V1/ReservationSubBlocksClient/get.php index c0d58da48904..033a3238a63e 100644 --- a/Compute/samples/V1/ReservationSubBlocksClient/get.php +++ b/Compute/samples/V1/ReservationSubBlocksClient/get.php @@ -31,9 +31,11 @@ /** * Retrieves information about the specified reservation subBlock. * - * @param string $parentName The name of the parent reservation and parent block. In the format of reservations/{reservation_name}/reservationBlocks/{reservation_block_name} + * @param string $parentName The name of the parent reservation and parent block. In the format of + * reservations/{reservation_name}/reservationBlocks/{reservation_block_name} * @param string $project Project ID for this request. - * @param string $reservationSubBlock The name of the reservation subBlock. Name should conform to RFC1035 or be a resource ID. + * @param string $reservationSubBlock The name of the reservation subBlock. + * Name should conform to RFC1035 or be a resource ID. * @param string $zone Name of the zone for this request. Zone name should conform to RFC1035. */ function get_sample( diff --git a/Compute/samples/V1/ReservationSubBlocksClient/get_iam_policy.php b/Compute/samples/V1/ReservationSubBlocksClient/get_iam_policy.php new file mode 100644 index 000000000000..ad52b50e7f4b --- /dev/null +++ b/Compute/samples/V1/ReservationSubBlocksClient/get_iam_policy.php @@ -0,0 +1,84 @@ +setParentResource($parentResource) + ->setProject($project) + ->setResource($resource) + ->setZone($zone); + + // Call the API and handle any network failures. + try { + /** @var Policy $response */ + $response = $reservationSubBlocksClient->getIamPolicy($request); + printf('Response data: %s' . PHP_EOL, $response->serializeToJsonString()); + } catch (ApiException $ex) { + printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage()); + } +} + +/** + * Helper to execute the sample. + * + * This sample has been automatically generated and should be regarded as a code + * template only. It will require modifications to work: + * - It may require correct/in-range values for request initialization. + * - It may require specifying regional endpoints when creating the service client, + * please see the apiEndpoint client configuration option for more details. + */ +function callSample(): void +{ + $parentResource = '[PARENT_RESOURCE]'; + $project = '[PROJECT]'; + $resource = '[RESOURCE]'; + $zone = '[ZONE]'; + + get_iam_policy_sample($parentResource, $project, $resource, $zone); +} +// [END compute_v1_generated_ReservationSubBlocks_GetIamPolicy_sync] diff --git a/Compute/samples/V1/ReservationSubBlocksClient/list.php b/Compute/samples/V1/ReservationSubBlocksClient/list.php index ee6654ade3b7..bd2f9786f86d 100644 --- a/Compute/samples/V1/ReservationSubBlocksClient/list.php +++ b/Compute/samples/V1/ReservationSubBlocksClient/list.php @@ -31,7 +31,8 @@ /** * Retrieves a list of reservation subBlocks under a single reservation. * - * @param string $parentName The name of the parent reservation and parent block. In the format of reservations/{reservation_name}/reservationBlocks/{reservation_block_name} + * @param string $parentName The name of the parent reservation and parent block. In the format of + * reservations/{reservation_name}/reservationBlocks/{reservation_block_name} * @param string $project Project ID for this request. * @param string $zone Name of the zone for this request. Zone name should conform to RFC1035. */ diff --git a/Compute/samples/V1/ReservationSubBlocksClient/perform_maintenance.php b/Compute/samples/V1/ReservationSubBlocksClient/perform_maintenance.php index b9e3bba7dc55..b89f4ad2bdc7 100644 --- a/Compute/samples/V1/ReservationSubBlocksClient/perform_maintenance.php +++ b/Compute/samples/V1/ReservationSubBlocksClient/perform_maintenance.php @@ -32,9 +32,11 @@ /** * Allows customers to perform maintenance on a reservation subBlock * - * @param string $parentName The name of the parent reservation and parent block. In the format of reservations/{reservation_name}/reservationBlocks/{reservation_block_name} + * @param string $parentName The name of the parent reservation and parent block. In the format of + * reservations/{reservation_name}/reservationBlocks/{reservation_block_name} * @param string $project Project ID for this request. - * @param string $reservationSubBlock The name of the reservation subBlock. Name should conform to RFC1035 or be a resource ID. + * @param string $reservationSubBlock The name of the reservation subBlock. + * Name should conform to RFC1035 or be a resource ID. * @param string $zone Name of the zone for this request. Zone name should conform to RFC1035. */ function perform_maintenance_sample( diff --git a/Compute/samples/V1/ReservationSubBlocksClient/report_faulty.php b/Compute/samples/V1/ReservationSubBlocksClient/report_faulty.php index 577896ef8fcb..928595b6aefe 100644 --- a/Compute/samples/V1/ReservationSubBlocksClient/report_faulty.php +++ b/Compute/samples/V1/ReservationSubBlocksClient/report_faulty.php @@ -33,9 +33,11 @@ /** * Allows customers to report a faulty subBlock. * - * @param string $parentName The name of the parent reservation and parent block. In the format of reservations/{reservation_name}/reservationBlocks/{reservation_block_name} + * @param string $parentName The name of the parent reservation and parent block. In the format of + * reservations/{reservation_name}/reservationBlocks/{reservation_block_name} * @param string $project Project ID for this request. - * @param string $reservationSubBlock The name of the reservation subBlock. Name should conform to RFC1035 or be a resource ID. + * @param string $reservationSubBlock The name of the reservation subBlock. + * Name should conform to RFC1035 or be a resource ID. * @param string $zone Name of the zone for this request. Zone name should conform to RFC1035. */ function report_faulty_sample( diff --git a/Compute/samples/V1/ReservationSubBlocksClient/set_iam_policy.php b/Compute/samples/V1/ReservationSubBlocksClient/set_iam_policy.php new file mode 100644 index 000000000000..827f3309dc75 --- /dev/null +++ b/Compute/samples/V1/ReservationSubBlocksClient/set_iam_policy.php @@ -0,0 +1,87 @@ +setParentResource($parentResource) + ->setProject($project) + ->setResource($resource) + ->setZone($zone) + ->setZoneSetNestedPolicyRequestResource($zoneSetNestedPolicyRequestResource); + + // Call the API and handle any network failures. + try { + /** @var Policy $response */ + $response = $reservationSubBlocksClient->setIamPolicy($request); + printf('Response data: %s' . PHP_EOL, $response->serializeToJsonString()); + } catch (ApiException $ex) { + printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage()); + } +} + +/** + * Helper to execute the sample. + * + * This sample has been automatically generated and should be regarded as a code + * template only. It will require modifications to work: + * - It may require correct/in-range values for request initialization. + * - It may require specifying regional endpoints when creating the service client, + * please see the apiEndpoint client configuration option for more details. + */ +function callSample(): void +{ + $parentResource = '[PARENT_RESOURCE]'; + $project = '[PROJECT]'; + $resource = '[RESOURCE]'; + $zone = '[ZONE]'; + + set_iam_policy_sample($parentResource, $project, $resource, $zone); +} +// [END compute_v1_generated_ReservationSubBlocks_SetIamPolicy_sync] diff --git a/Compute/samples/V1/ReservationSubBlocksClient/test_iam_permissions.php b/Compute/samples/V1/ReservationSubBlocksClient/test_iam_permissions.php new file mode 100644 index 000000000000..f3f7c814fe74 --- /dev/null +++ b/Compute/samples/V1/ReservationSubBlocksClient/test_iam_permissions.php @@ -0,0 +1,86 @@ +setParentResource($parentResource) + ->setProject($project) + ->setResource($resource) + ->setTestPermissionsRequestResource($testPermissionsRequestResource) + ->setZone($zone); + + // Call the API and handle any network failures. + try { + /** @var TestPermissionsResponse $response */ + $response = $reservationSubBlocksClient->testIamPermissions($request); + printf('Response data: %s' . PHP_EOL, $response->serializeToJsonString()); + } catch (ApiException $ex) { + printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage()); + } +} + +/** + * Helper to execute the sample. + * + * This sample has been automatically generated and should be regarded as a code + * template only. It will require modifications to work: + * - It may require correct/in-range values for request initialization. + * - It may require specifying regional endpoints when creating the service client, + * please see the apiEndpoint client configuration option for more details. + */ +function callSample(): void +{ + $parentResource = '[PARENT_RESOURCE]'; + $project = '[PROJECT]'; + $resource = '[RESOURCE]'; + $zone = '[ZONE]'; + + test_iam_permissions_sample($parentResource, $project, $resource, $zone); +} +// [END compute_v1_generated_ReservationSubBlocks_TestIamPermissions_sync] diff --git a/Compute/samples/V1/ReservationsClient/aggregated_list.php b/Compute/samples/V1/ReservationsClient/aggregated_list.php index 86c0e9dcbeb5..8e854d6eb586 100644 --- a/Compute/samples/V1/ReservationsClient/aggregated_list.php +++ b/Compute/samples/V1/ReservationsClient/aggregated_list.php @@ -29,7 +29,10 @@ use Google\Cloud\Compute\V1\Client\ReservationsClient; /** - * Retrieves an aggregated list of reservations. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. + * Retrieves an aggregated list of reservations. + * + * To prevent failure, it is recommended that you set the + * `returnPartialSuccess` parameter to `true`. * * @param string $project Project ID for this request. */ diff --git a/Compute/samples/V1/ReservationsClient/get_iam_policy.php b/Compute/samples/V1/ReservationsClient/get_iam_policy.php index 286dcc1a1984..d53e73e0e8fc 100644 --- a/Compute/samples/V1/ReservationsClient/get_iam_policy.php +++ b/Compute/samples/V1/ReservationsClient/get_iam_policy.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\Policy; /** - * Gets the access control policy for a resource. May be empty if no such policy or resource exists. + * Gets the access control policy for a resource. May be empty if no such + * policy or resource exists. * * @param string $project Project ID for this request. * @param string $resource Name or id of the resource for this request. diff --git a/Compute/samples/V1/ReservationsClient/insert.php b/Compute/samples/V1/ReservationsClient/insert.php index 9120b13ca72f..1e6d2a3ee7fe 100644 --- a/Compute/samples/V1/ReservationsClient/insert.php +++ b/Compute/samples/V1/ReservationsClient/insert.php @@ -31,7 +31,8 @@ use Google\Rpc\Status; /** - * Creates a new reservation. For more information, read Reserving zonal resources. + * Creates a new reservation. For more information, readReserving zonal + * resources. * * @param string $project Project ID for this request. * @param string $zone Name of the zone for this request. diff --git a/Compute/samples/V1/ReservationsClient/list.php b/Compute/samples/V1/ReservationsClient/list.php index 768ffe6a49f6..7f01b09a9eff 100644 --- a/Compute/samples/V1/ReservationsClient/list.php +++ b/Compute/samples/V1/ReservationsClient/list.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\ListReservationsRequest; /** - * A list of all the reservations that have been configured for the specified project in specified zone. + * A list of all the reservations that have been configured for the + * specified project in specified zone. * * @param string $project Project ID for this request. * @param string $zone Name of the zone for this request. diff --git a/Compute/samples/V1/ReservationsClient/perform_maintenance.php b/Compute/samples/V1/ReservationsClient/perform_maintenance.php index 024e61eae79f..80dd5b49b90b 100644 --- a/Compute/samples/V1/ReservationsClient/perform_maintenance.php +++ b/Compute/samples/V1/ReservationsClient/perform_maintenance.php @@ -34,7 +34,8 @@ * Perform maintenance on an extended reservation * * @param string $project Project ID for this request. - * @param string $reservation The name of the reservation. Name should conform to RFC1035 or be a resource ID. + * @param string $reservation The name of the reservation. + * Name should conform to RFC1035 or be a resource ID. * @param string $zone Name of the zone for this request. Zone name should conform to RFC1035. */ function perform_maintenance_sample(string $project, string $reservation, string $zone): void diff --git a/Compute/samples/V1/ReservationsClient/resize.php b/Compute/samples/V1/ReservationsClient/resize.php index 5efacbb4ca1b..e6d5cc65b9b6 100644 --- a/Compute/samples/V1/ReservationsClient/resize.php +++ b/Compute/samples/V1/ReservationsClient/resize.php @@ -31,7 +31,9 @@ use Google\Rpc\Status; /** - * Resizes the reservation (applicable to standalone reservations only). For more information, read Modifying reservations. + * Resizes the reservation (applicable to standalone reservations only). For + * more information, readModifying + * reservations. * * @param string $project Project ID for this request. * @param string $reservation Name of the reservation to update. diff --git a/Compute/samples/V1/ReservationsClient/set_iam_policy.php b/Compute/samples/V1/ReservationsClient/set_iam_policy.php index 3fd2358d2b24..ec985e91b22f 100644 --- a/Compute/samples/V1/ReservationsClient/set_iam_policy.php +++ b/Compute/samples/V1/ReservationsClient/set_iam_policy.php @@ -30,7 +30,8 @@ use Google\Cloud\Compute\V1\ZoneSetPolicyRequest; /** - * Sets the access control policy on the specified resource. Replaces any existing policy. + * Sets the access control policy on the specified resource. + * Replaces any existing policy. * * @param string $project Project ID for this request. * @param string $resource Name or id of the resource for this request. diff --git a/Compute/samples/V1/ResourcePoliciesClient/aggregated_list.php b/Compute/samples/V1/ResourcePoliciesClient/aggregated_list.php index 3469fc357423..8772ce718496 100644 --- a/Compute/samples/V1/ResourcePoliciesClient/aggregated_list.php +++ b/Compute/samples/V1/ResourcePoliciesClient/aggregated_list.php @@ -29,7 +29,10 @@ use Google\Cloud\Compute\V1\Client\ResourcePoliciesClient; /** - * Retrieves an aggregated list of resource policies. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. + * Retrieves an aggregated list of resource policies. + * + * To prevent failure, Google recommends that you set the + * `returnPartialSuccess` parameter to `true`. * * @param string $project Project ID for this request. */ diff --git a/Compute/samples/V1/ResourcePoliciesClient/get_iam_policy.php b/Compute/samples/V1/ResourcePoliciesClient/get_iam_policy.php index df504b3b2bff..5106afff34bb 100644 --- a/Compute/samples/V1/ResourcePoliciesClient/get_iam_policy.php +++ b/Compute/samples/V1/ResourcePoliciesClient/get_iam_policy.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\Policy; /** - * Gets the access control policy for a resource. May be empty if no such policy or resource exists. + * Gets the access control policy for a resource. May be empty if no such + * policy or resource exists. * * @param string $project Project ID for this request. * @param string $region The name of the region for this request. diff --git a/Compute/samples/V1/ResourcePoliciesClient/list.php b/Compute/samples/V1/ResourcePoliciesClient/list.php index 230fea43f35e..370dd3fa8dc5 100644 --- a/Compute/samples/V1/ResourcePoliciesClient/list.php +++ b/Compute/samples/V1/ResourcePoliciesClient/list.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\ListResourcePoliciesRequest; /** - * A list all the resource policies that have been configured for the specified project in specified region. + * A list all the resource policies that have been configured for the + * specified project in specified region. * * @param string $project Project ID for this request. * @param string $region Name of the region for this request. diff --git a/Compute/samples/V1/ResourcePoliciesClient/set_iam_policy.php b/Compute/samples/V1/ResourcePoliciesClient/set_iam_policy.php index 5942f57c5759..bcdc67f97792 100644 --- a/Compute/samples/V1/ResourcePoliciesClient/set_iam_policy.php +++ b/Compute/samples/V1/ResourcePoliciesClient/set_iam_policy.php @@ -30,7 +30,8 @@ use Google\Cloud\Compute\V1\SetIamPolicyResourcePolicyRequest; /** - * Sets the access control policy on the specified resource. Replaces any existing policy. + * Sets the access control policy on the specified resource. + * Replaces any existing policy. * * @param string $project Project ID for this request. * @param string $region The name of the region for this request. diff --git a/Compute/samples/V1/RoutersClient/aggregated_list.php b/Compute/samples/V1/RoutersClient/aggregated_list.php index 4e325b20b432..cafaf5a53830 100644 --- a/Compute/samples/V1/RoutersClient/aggregated_list.php +++ b/Compute/samples/V1/RoutersClient/aggregated_list.php @@ -29,7 +29,10 @@ use Google\Cloud\Compute\V1\Client\RoutersClient; /** - * Retrieves an aggregated list of routers. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. + * Retrieves an aggregated list of routers. + * + * To prevent failure, Google recommends that you set the + * `returnPartialSuccess` parameter to `true`. * * @param string $project Project ID for this request. */ diff --git a/Compute/samples/V1/RoutersClient/get_nat_ip_info.php b/Compute/samples/V1/RoutersClient/get_nat_ip_info.php index e6346b7473ff..1468a6fda643 100644 --- a/Compute/samples/V1/RoutersClient/get_nat_ip_info.php +++ b/Compute/samples/V1/RoutersClient/get_nat_ip_info.php @@ -33,7 +33,8 @@ * * @param string $project Project ID for this request. * @param string $region Name of the region for this request. - * @param string $router Name of the Router resource to query for Nat IP information. The name should conform to RFC1035. + * @param string $router Name of the Router resource to query for Nat IP information. The name + * should conform to RFC1035. */ function get_nat_ip_info_sample(string $project, string $region, string $router): void { diff --git a/Compute/samples/V1/RoutersClient/get_nat_mapping_info.php b/Compute/samples/V1/RoutersClient/get_nat_mapping_info.php index 0e7c1a4cf7ec..82114278a775 100644 --- a/Compute/samples/V1/RoutersClient/get_nat_mapping_info.php +++ b/Compute/samples/V1/RoutersClient/get_nat_mapping_info.php @@ -33,7 +33,8 @@ * * @param string $project Project ID for this request. * @param string $region Name of the region for this request. - * @param string $router Name of the Router resource to query for Nat Mapping information of VM endpoints. + * @param string $router Name of the Router resource to query for Nat Mapping information of + * VM endpoints. */ function get_nat_mapping_info_sample(string $project, string $region, string $router): void { diff --git a/Compute/samples/V1/RoutersClient/get_route_policy.php b/Compute/samples/V1/RoutersClient/get_route_policy.php index 2e5ea2bb79e6..380dd28ec7e1 100644 --- a/Compute/samples/V1/RoutersClient/get_route_policy.php +++ b/Compute/samples/V1/RoutersClient/get_route_policy.php @@ -33,7 +33,8 @@ * * @param string $project Project ID for this request. * @param string $region Name of the region for this request. - * @param string $router Name of the Router resource to query for the route policy. The name should conform to RFC1035. + * @param string $router Name of the Router resource to query for the route policy. The name should + * conform to RFC1035. */ function get_route_policy_sample(string $project, string $region, string $router): void { diff --git a/Compute/samples/V1/RoutersClient/insert.php b/Compute/samples/V1/RoutersClient/insert.php index a482713196fd..62cf0842e2f8 100644 --- a/Compute/samples/V1/RoutersClient/insert.php +++ b/Compute/samples/V1/RoutersClient/insert.php @@ -31,7 +31,8 @@ use Google\Rpc\Status; /** - * Creates a Router resource in the specified project and region using the data included in the request. + * Creates a Router resource in the specified project and region using + * the data included in the request. * * @param string $project Project ID for this request. * @param string $region Name of the region for this request. diff --git a/Compute/samples/V1/RoutersClient/list_bgp_routes.php b/Compute/samples/V1/RoutersClient/list_bgp_routes.php index ee45abe7bee8..c2bc084d5ef7 100644 --- a/Compute/samples/V1/RoutersClient/list_bgp_routes.php +++ b/Compute/samples/V1/RoutersClient/list_bgp_routes.php @@ -33,7 +33,8 @@ * * @param string $project Project ID for this request. * @param string $region Name of the region for this request. - * @param string $router Name or id of the resource for this request. Name should conform to RFC1035. + * @param string $router Name or id of the resource for this request. + * Name should conform to RFC1035. */ function list_bgp_routes_sample(string $project, string $region, string $router): void { diff --git a/Compute/samples/V1/RoutersClient/list_route_policies.php b/Compute/samples/V1/RoutersClient/list_route_policies.php index 9bc16b5cad14..8751ef02c9e4 100644 --- a/Compute/samples/V1/RoutersClient/list_route_policies.php +++ b/Compute/samples/V1/RoutersClient/list_route_policies.php @@ -29,11 +29,13 @@ use Google\Cloud\Compute\V1\ListRoutePoliciesRoutersRequest; /** - * Retrieves a list of router route policy subresources available to the specified project. + * Retrieves a list of router route policy subresources available to the + * specified project. * * @param string $project Project ID for this request. * @param string $region Name of the region for this request. - * @param string $router Name or id of the resource for this request. Name should conform to RFC1035. + * @param string $router Name or id of the resource for this request. + * Name should conform to RFC1035. */ function list_route_policies_sample(string $project, string $region, string $router): void { diff --git a/Compute/samples/V1/RoutersClient/patch.php b/Compute/samples/V1/RoutersClient/patch.php index 422d3f6462c8..70082b1aa9a1 100644 --- a/Compute/samples/V1/RoutersClient/patch.php +++ b/Compute/samples/V1/RoutersClient/patch.php @@ -31,7 +31,10 @@ use Google\Rpc\Status; /** - * Patches the specified Router resource with the data included in the request. This method supports PATCH semantics and uses JSON merge patch format and processing rules. + * Patches the specified Router resource with the data included in the + * request. This method supportsPATCH + * semantics and usesJSON merge + * patch format and processing rules. * * @param string $project Project ID for this request. * @param string $region Name of the region for this request. diff --git a/Compute/samples/V1/RoutersClient/preview.php b/Compute/samples/V1/RoutersClient/preview.php index ae32f62ce0b5..d59df1cd06e9 100644 --- a/Compute/samples/V1/RoutersClient/preview.php +++ b/Compute/samples/V1/RoutersClient/preview.php @@ -30,7 +30,8 @@ use Google\Cloud\Compute\V1\RoutersPreviewResponse; /** - * Preview fields auto-generated during router create and update operations. Calling this method does NOT create or update the router. + * Preview fields auto-generated during router create andupdate operations. + * Calling this method does NOT create or update the router. * * @param string $project Project ID for this request. * @param string $region Name of the region for this request. diff --git a/Compute/samples/V1/RoutersClient/update.php b/Compute/samples/V1/RoutersClient/update.php index 828002679d3d..c0b660b498d9 100644 --- a/Compute/samples/V1/RoutersClient/update.php +++ b/Compute/samples/V1/RoutersClient/update.php @@ -31,7 +31,10 @@ use Google\Rpc\Status; /** - * Updates the specified Router resource with the data included in the request. This method conforms to PUT semantics, which requests that the state of the target resource be created or replaced with the state defined by the representation enclosed in the request message payload. + * Updates the specified Router resource with the data included in the + * request. This method conforms toPUT semantics, which requests that the state of the + * target resource be created or replaced with the state defined by the + * representation enclosed in the request message payload. * * @param string $project Project ID for this request. * @param string $region Name of the region for this request. diff --git a/Compute/samples/V1/RoutesClient/insert.php b/Compute/samples/V1/RoutesClient/insert.php index 30187f4ff9ba..b553f11803c4 100644 --- a/Compute/samples/V1/RoutesClient/insert.php +++ b/Compute/samples/V1/RoutesClient/insert.php @@ -31,7 +31,8 @@ use Google\Rpc\Status; /** - * Creates a Route resource in the specified project using the data included in the request. + * Creates a Route resource in the specified project using the data included + * in the request. * * @param string $project Project ID for this request. */ diff --git a/Compute/samples/V1/SecurityPoliciesClient/aggregated_list.php b/Compute/samples/V1/SecurityPoliciesClient/aggregated_list.php index 8bcb781e07a0..edca5d6dec6a 100644 --- a/Compute/samples/V1/SecurityPoliciesClient/aggregated_list.php +++ b/Compute/samples/V1/SecurityPoliciesClient/aggregated_list.php @@ -29,7 +29,11 @@ use Google\Cloud\Compute\V1\Client\SecurityPoliciesClient; /** - * Retrieves the list of all SecurityPolicy resources, regional and global, available to the specified project. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. + * Retrieves the list of all SecurityPolicy resources, regional and global, + * available to the specified project. + * + * To prevent failure, Google recommends that you set the + * `returnPartialSuccess` parameter to `true`. * * @param string $project Name of the project scoping this request. */ diff --git a/Compute/samples/V1/SecurityPoliciesClient/insert.php b/Compute/samples/V1/SecurityPoliciesClient/insert.php index 52f5121ba742..d3d9a2aea6a3 100644 --- a/Compute/samples/V1/SecurityPoliciesClient/insert.php +++ b/Compute/samples/V1/SecurityPoliciesClient/insert.php @@ -31,7 +31,8 @@ use Google\Rpc\Status; /** - * Creates a new policy in the specified project using the data included in the request. + * Creates a new policy in the specified project using the data included in + * the request. * * @param string $project Project ID for this request. */ diff --git a/Compute/samples/V1/SecurityPoliciesClient/list_preconfigured_expression_sets.php b/Compute/samples/V1/SecurityPoliciesClient/list_preconfigured_expression_sets.php index bc36f85a0e0a..5b26c3467732 100644 --- a/Compute/samples/V1/SecurityPoliciesClient/list_preconfigured_expression_sets.php +++ b/Compute/samples/V1/SecurityPoliciesClient/list_preconfigured_expression_sets.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\SecurityPoliciesListPreconfiguredExpressionSetsResponse; /** - * Gets the current list of preconfigured Web Application Firewall (WAF) expressions. + * Gets the current list of preconfigured Web Application Firewall (WAF) + * expressions. * * @param string $project Project ID for this request. */ diff --git a/Compute/samples/V1/SecurityPoliciesClient/patch.php b/Compute/samples/V1/SecurityPoliciesClient/patch.php index 625d3cd087fb..532de38ca6ee 100644 --- a/Compute/samples/V1/SecurityPoliciesClient/patch.php +++ b/Compute/samples/V1/SecurityPoliciesClient/patch.php @@ -31,7 +31,11 @@ use Google\Rpc\Status; /** - * Patches the specified policy with the data included in the request. To clear fields in the policy, leave the fields empty and specify them in the updateMask. This cannot be used to be update the rules in the policy. Please use the per rule methods like addRule, patchRule, and removeRule instead. + * Patches the specified policy with the data included in the request. To + * clear fields in the policy, leave the fields empty and specify them in the + * updateMask. This cannot be used to be update the rules in the policy. + * Please use the per rule methods like addRule, patchRule, and removeRule + * instead. * * @param string $project Project ID for this request. * @param string $securityPolicy Name of the security policy to update. diff --git a/Compute/samples/V1/SecurityPoliciesClient/patch_rule.php b/Compute/samples/V1/SecurityPoliciesClient/patch_rule.php index 05f0436e217d..b2f31bddb904 100644 --- a/Compute/samples/V1/SecurityPoliciesClient/patch_rule.php +++ b/Compute/samples/V1/SecurityPoliciesClient/patch_rule.php @@ -31,7 +31,8 @@ use Google\Rpc\Status; /** - * Patches a rule at the specified priority. To clear fields in the rule, leave the fields empty and specify them in the updateMask. + * Patches a rule at the specified priority. To clear fields in the rule, + * leave the fields empty and specify them in the updateMask. * * @param string $project Project ID for this request. * @param string $securityPolicy Name of the security policy to update. diff --git a/Compute/samples/V1/SecurityPoliciesClient/set_labels.php b/Compute/samples/V1/SecurityPoliciesClient/set_labels.php index 44e45fc69b45..989f6959a54a 100644 --- a/Compute/samples/V1/SecurityPoliciesClient/set_labels.php +++ b/Compute/samples/V1/SecurityPoliciesClient/set_labels.php @@ -31,7 +31,9 @@ use Google\Rpc\Status; /** - * Sets the labels on a security policy. To learn more about labels, read the Labeling Resources documentation. + * Sets the labels on a security policy. To learn more about labels, + * read the Labeling Resources + * documentation. * * @param string $project Project ID for this request. * @param string $resource Name or id of the resource for this request. diff --git a/Compute/samples/V1/ServiceAttachmentsClient/aggregated_list.php b/Compute/samples/V1/ServiceAttachmentsClient/aggregated_list.php index ff9ddf0ef431..06fe5ddb38ac 100644 --- a/Compute/samples/V1/ServiceAttachmentsClient/aggregated_list.php +++ b/Compute/samples/V1/ServiceAttachmentsClient/aggregated_list.php @@ -29,7 +29,11 @@ use Google\Cloud\Compute\V1\Client\ServiceAttachmentsClient; /** - * Retrieves the list of all ServiceAttachment resources, regional and global, available to the specified project. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. + * Retrieves the list of all ServiceAttachment resources, + * regional and global, available to the specified project. + * + * To prevent failure, Google recommends that you set the + * `returnPartialSuccess` parameter to `true`. * * @param string $project Name of the project scoping this request. */ diff --git a/Compute/samples/V1/ServiceAttachmentsClient/get_iam_policy.php b/Compute/samples/V1/ServiceAttachmentsClient/get_iam_policy.php index b2413f38f328..d870ec36331d 100644 --- a/Compute/samples/V1/ServiceAttachmentsClient/get_iam_policy.php +++ b/Compute/samples/V1/ServiceAttachmentsClient/get_iam_policy.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\Policy; /** - * Gets the access control policy for a resource. May be empty if no such policy or resource exists. + * Gets the access control policy for a resource. May be empty if no such + * policy or resource exists. * * @param string $project Project ID for this request. * @param string $region The name of the region for this request. diff --git a/Compute/samples/V1/ServiceAttachmentsClient/insert.php b/Compute/samples/V1/ServiceAttachmentsClient/insert.php index 88ad092d5fc9..a48a985d7994 100644 --- a/Compute/samples/V1/ServiceAttachmentsClient/insert.php +++ b/Compute/samples/V1/ServiceAttachmentsClient/insert.php @@ -31,7 +31,8 @@ use Google\Rpc\Status; /** - * Creates a ServiceAttachment in the specified project in the given scope using the parameters that are included in the request. + * Creates a ServiceAttachment in the specified project in the given scope + * using the parameters that are included in the request. * * @param string $project Project ID for this request. * @param string $region Name of the region of this request. diff --git a/Compute/samples/V1/ServiceAttachmentsClient/patch.php b/Compute/samples/V1/ServiceAttachmentsClient/patch.php index 131ac68c6e66..769ec5f1dcbb 100644 --- a/Compute/samples/V1/ServiceAttachmentsClient/patch.php +++ b/Compute/samples/V1/ServiceAttachmentsClient/patch.php @@ -31,11 +31,15 @@ use Google\Rpc\Status; /** - * Patches the specified ServiceAttachment resource with the data included in the request. This method supports PATCH semantics and uses JSON merge patch format and processing rules. + * Patches the specified ServiceAttachment resource with the data included in + * the request. This method supports PATCH + * semantics and usesJSON merge + * patch format and processing rules. * * @param string $project Project ID for this request. * @param string $region The region scoping this request and should conform to RFC1035. - * @param string $serviceAttachment The resource id of the ServiceAttachment to patch. It should conform to RFC1035 resource name or be a string form on an unsigned long number. + * @param string $serviceAttachment The resource id of the ServiceAttachment to patch. It should conform to + * RFC1035 resource name or be a string form on an unsigned long number. */ function patch_sample(string $project, string $region, string $serviceAttachment): void { diff --git a/Compute/samples/V1/ServiceAttachmentsClient/set_iam_policy.php b/Compute/samples/V1/ServiceAttachmentsClient/set_iam_policy.php index 556313a9e8e9..0d57ce0834f8 100644 --- a/Compute/samples/V1/ServiceAttachmentsClient/set_iam_policy.php +++ b/Compute/samples/V1/ServiceAttachmentsClient/set_iam_policy.php @@ -30,7 +30,8 @@ use Google\Cloud\Compute\V1\SetIamPolicyServiceAttachmentRequest; /** - * Sets the access control policy on the specified resource. Replaces any existing policy. + * Sets the access control policy on the specified resource. + * Replaces any existing policy. * * @param string $project Project ID for this request. * @param string $region The name of the region for this request. diff --git a/Compute/samples/V1/SnapshotsClient/delete.php b/Compute/samples/V1/SnapshotsClient/delete.php index 8663ce8d6c8f..bbbd8ce4480e 100644 --- a/Compute/samples/V1/SnapshotsClient/delete.php +++ b/Compute/samples/V1/SnapshotsClient/delete.php @@ -30,7 +30,14 @@ use Google\Rpc\Status; /** - * Deletes the specified Snapshot resource. Keep in mind that deleting a single snapshot might not necessarily delete all the data on that snapshot. If any data on the snapshot that is marked for deletion is needed for subsequent snapshots, the data will be moved to the next corresponding snapshot. For more information, see Deleting snapshots. + * Deletes the specified Snapshot resource. Keep in mind that deleting + * a single snapshot might not necessarily delete all the data on that + * snapshot. If any data on the snapshot that is marked for deletion is + * needed for subsequent snapshots, the data will be moved to the next + * corresponding snapshot. + * + * For more information, seeDeleting + * snapshots. * * @param string $project Project ID for this request. * @param string $snapshot Name of the Snapshot resource to delete. diff --git a/Compute/samples/V1/SnapshotsClient/get_iam_policy.php b/Compute/samples/V1/SnapshotsClient/get_iam_policy.php index b59ddd7aabec..0641f1c8fd9d 100644 --- a/Compute/samples/V1/SnapshotsClient/get_iam_policy.php +++ b/Compute/samples/V1/SnapshotsClient/get_iam_policy.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\Policy; /** - * Gets the access control policy for a resource. May be empty if no such policy or resource exists. + * Gets the access control policy for a resource. May be empty if no such + * policy or resource exists. * * @param string $project Project ID for this request. * @param string $resource Name or id of the resource for this request. diff --git a/Compute/samples/V1/SnapshotsClient/insert.php b/Compute/samples/V1/SnapshotsClient/insert.php index 03218427c68c..d9e9103e09a4 100644 --- a/Compute/samples/V1/SnapshotsClient/insert.php +++ b/Compute/samples/V1/SnapshotsClient/insert.php @@ -31,7 +31,11 @@ use Google\Rpc\Status; /** - * Creates a snapshot in the specified project using the data included in the request. For regular snapshot creation, consider using this method instead of disks.createSnapshot, as this method supports more features, such as creating snapshots in a project different from the source disk project. + * Creates a snapshot in the specified project using the data included + * in the request. For regular snapshot creation, consider using this method + * instead of disks.createSnapshot, + * as this method supports more features, such as creating snapshots in a + * project different from the source disk project. * * @param string $project Project ID for this request. */ diff --git a/Compute/samples/V1/SnapshotsClient/list.php b/Compute/samples/V1/SnapshotsClient/list.php index 59c339c3b235..81bd1111e165 100644 --- a/Compute/samples/V1/SnapshotsClient/list.php +++ b/Compute/samples/V1/SnapshotsClient/list.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\ListSnapshotsRequest; /** - * Retrieves the list of Snapshot resources contained within the specified project. + * Retrieves the list of Snapshot resources contained within + * the specified project. * * @param string $project Project ID for this request. */ diff --git a/Compute/samples/V1/SnapshotsClient/set_iam_policy.php b/Compute/samples/V1/SnapshotsClient/set_iam_policy.php index d494c28988bd..630e76836b86 100644 --- a/Compute/samples/V1/SnapshotsClient/set_iam_policy.php +++ b/Compute/samples/V1/SnapshotsClient/set_iam_policy.php @@ -30,7 +30,8 @@ use Google\Cloud\Compute\V1\SetIamPolicySnapshotRequest; /** - * Sets the access control policy on the specified resource. Replaces any existing policy. + * Sets the access control policy on the specified resource. + * Replaces any existing policy. * * @param string $project Project ID for this request. * @param string $resource Name or id of the resource for this request. diff --git a/Compute/samples/V1/SnapshotsClient/set_labels.php b/Compute/samples/V1/SnapshotsClient/set_labels.php index 366791429fa6..f87a0ba01a81 100644 --- a/Compute/samples/V1/SnapshotsClient/set_labels.php +++ b/Compute/samples/V1/SnapshotsClient/set_labels.php @@ -31,7 +31,8 @@ use Google\Rpc\Status; /** - * Sets the labels on a snapshot. To learn more about labels, read the Labeling Resources documentation. + * Sets the labels on a snapshot. To learn more about labels, read theLabeling + * Resources documentation. * * @param string $project Project ID for this request. * @param string $resource Name or id of the resource for this request. diff --git a/Compute/samples/V1/SslCertificatesClient/aggregated_list.php b/Compute/samples/V1/SslCertificatesClient/aggregated_list.php index 97ed32aabfd9..d665c0d9eaf1 100644 --- a/Compute/samples/V1/SslCertificatesClient/aggregated_list.php +++ b/Compute/samples/V1/SslCertificatesClient/aggregated_list.php @@ -29,7 +29,11 @@ use Google\Cloud\Compute\V1\Client\SslCertificatesClient; /** - * Retrieves the list of all SslCertificate resources, regional and global, available to the specified project. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. + * Retrieves the list of all SslCertificate resources, regional and global, + * available to the specified project. + * + * To prevent failure, Google recommends that you set the + * `returnPartialSuccess` parameter to `true`. * * @param string $project Name of the project scoping this request. */ diff --git a/Compute/samples/V1/SslCertificatesClient/insert.php b/Compute/samples/V1/SslCertificatesClient/insert.php index 148c87ec1c6f..447f56103adf 100644 --- a/Compute/samples/V1/SslCertificatesClient/insert.php +++ b/Compute/samples/V1/SslCertificatesClient/insert.php @@ -31,7 +31,8 @@ use Google\Rpc\Status; /** - * Creates a SslCertificate resource in the specified project using the data included in the request. + * Creates a SslCertificate resource in the specified project using the data + * included in the request. * * @param string $project Project ID for this request. */ diff --git a/Compute/samples/V1/SslCertificatesClient/list.php b/Compute/samples/V1/SslCertificatesClient/list.php index 49e2781c4ef5..901f8f12256d 100644 --- a/Compute/samples/V1/SslCertificatesClient/list.php +++ b/Compute/samples/V1/SslCertificatesClient/list.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\ListSslCertificatesRequest; /** - * Retrieves the list of SslCertificate resources available to the specified project. + * Retrieves the list of SslCertificate resources available to the specified + * project. * * @param string $project Project ID for this request. */ diff --git a/Compute/samples/V1/SslPoliciesClient/aggregated_list.php b/Compute/samples/V1/SslPoliciesClient/aggregated_list.php index 6efd5c7b2869..1afff981722f 100644 --- a/Compute/samples/V1/SslPoliciesClient/aggregated_list.php +++ b/Compute/samples/V1/SslPoliciesClient/aggregated_list.php @@ -29,7 +29,11 @@ use Google\Cloud\Compute\V1\Client\SslPoliciesClient; /** - * Retrieves the list of all SslPolicy resources, regional and global, available to the specified project. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. + * Retrieves the list of all SslPolicy resources, regional and global, + * available to the specified project. + * + * To prevent failure, Google recommends that you set the + * `returnPartialSuccess` parameter to `true`. * * @param string $project Name of the project scoping this request. */ diff --git a/Compute/samples/V1/SslPoliciesClient/delete.php b/Compute/samples/V1/SslPoliciesClient/delete.php index 257d5c46ab2a..f0d63b9e6ae6 100644 --- a/Compute/samples/V1/SslPoliciesClient/delete.php +++ b/Compute/samples/V1/SslPoliciesClient/delete.php @@ -30,10 +30,13 @@ use Google\Rpc\Status; /** - * Deletes the specified SSL policy. The SSL policy resource can be deleted only if it is not in use by any TargetHttpsProxy or TargetSslProxy resources. + * Deletes the specified SSL policy. The SSL policy resource can be deleted + * only if it is not in use by any TargetHttpsProxy or TargetSslProxy + * resources. * * @param string $project Project ID for this request. - * @param string $sslPolicy Name of the SSL policy to delete. The name must be 1-63 characters long, and comply with RFC1035. + * @param string $sslPolicy Name of the SSL policy to delete. The name must be 1-63 characters long, + * and comply with RFC1035. */ function delete_sample(string $project, string $sslPolicy): void { diff --git a/Compute/samples/V1/SslPoliciesClient/get.php b/Compute/samples/V1/SslPoliciesClient/get.php index ebe92276280b..3316befe2b52 100644 --- a/Compute/samples/V1/SslPoliciesClient/get.php +++ b/Compute/samples/V1/SslPoliciesClient/get.php @@ -32,7 +32,8 @@ * Lists all of the ordered rules present in a single specified policy. * * @param string $project Project ID for this request. - * @param string $sslPolicy Name of the SSL policy to update. The name must be 1-63 characters long, and comply with RFC1035. + * @param string $sslPolicy Name of the SSL policy to update. The name must be 1-63 characters long, + * and comply with RFC1035. */ function get_sample(string $project, string $sslPolicy): void { diff --git a/Compute/samples/V1/SslPoliciesClient/list.php b/Compute/samples/V1/SslPoliciesClient/list.php index 851bbcc6664d..b9ee39f6b3fb 100644 --- a/Compute/samples/V1/SslPoliciesClient/list.php +++ b/Compute/samples/V1/SslPoliciesClient/list.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\ListSslPoliciesRequest; /** - * Lists all the SSL policies that have been configured for the specified project. + * Lists all the SSL policies that have been configured for the specified + * project. * * @param string $project Project ID for this request. */ diff --git a/Compute/samples/V1/SslPoliciesClient/list_available_features.php b/Compute/samples/V1/SslPoliciesClient/list_available_features.php index 26ba560bc1ae..502a67e3bfa2 100644 --- a/Compute/samples/V1/SslPoliciesClient/list_available_features.php +++ b/Compute/samples/V1/SslPoliciesClient/list_available_features.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\SslPoliciesListAvailableFeaturesResponse; /** - * Lists all features that can be specified in the SSL policy when using custom profile. + * Lists all features that can be specified in the SSL policy when using + * custom profile. * * @param string $project Project ID for this request. */ diff --git a/Compute/samples/V1/SslPoliciesClient/patch.php b/Compute/samples/V1/SslPoliciesClient/patch.php index 600d311cad83..7a2a076937bf 100644 --- a/Compute/samples/V1/SslPoliciesClient/patch.php +++ b/Compute/samples/V1/SslPoliciesClient/patch.php @@ -34,7 +34,8 @@ * Patches the specified SSL policy with the data included in the request. * * @param string $project Project ID for this request. - * @param string $sslPolicy Name of the SSL policy to update. The name must be 1-63 characters long, and comply with RFC1035. + * @param string $sslPolicy Name of the SSL policy to update. The name must be 1-63 characters long, + * and comply with RFC1035. */ function patch_sample(string $project, string $sslPolicy): void { diff --git a/Compute/samples/V1/StoragePoolTypesClient/aggregated_list.php b/Compute/samples/V1/StoragePoolTypesClient/aggregated_list.php index 14cae8ef8214..f6735264eca1 100644 --- a/Compute/samples/V1/StoragePoolTypesClient/aggregated_list.php +++ b/Compute/samples/V1/StoragePoolTypesClient/aggregated_list.php @@ -29,7 +29,10 @@ use Google\Cloud\Compute\V1\Client\StoragePoolTypesClient; /** - * Retrieves an aggregated list of storage pool types. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. + * Retrieves an aggregated list of storage pool types. + * + * To prevent failure, Google recommends that you set the + * `returnPartialSuccess` parameter to `true`. * * @param string $project Project ID for this request. */ diff --git a/Compute/samples/V1/StoragePoolTypesClient/list.php b/Compute/samples/V1/StoragePoolTypesClient/list.php index 2a67ea8fd3eb..50db8a4c0230 100644 --- a/Compute/samples/V1/StoragePoolTypesClient/list.php +++ b/Compute/samples/V1/StoragePoolTypesClient/list.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\ListStoragePoolTypesRequest; /** - * Retrieves a list of storage pool types available to the specified project. + * Retrieves a list of storage pool types available to the specified + * project. * * @param string $project Project ID for this request. * @param string $zone The name of the zone for this request. diff --git a/Compute/samples/V1/StoragePoolsClient/aggregated_list.php b/Compute/samples/V1/StoragePoolsClient/aggregated_list.php index 1e328a002d7c..8d7e1c5d91f0 100644 --- a/Compute/samples/V1/StoragePoolsClient/aggregated_list.php +++ b/Compute/samples/V1/StoragePoolsClient/aggregated_list.php @@ -29,7 +29,10 @@ use Google\Cloud\Compute\V1\Client\StoragePoolsClient; /** - * Retrieves an aggregated list of storage pools. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. + * Retrieves an aggregated list of storage pools. + * + * To prevent failure, Google recommends that you set the + * `returnPartialSuccess` parameter to `true`. * * @param string $project Project ID for this request. */ diff --git a/Compute/samples/V1/StoragePoolsClient/delete.php b/Compute/samples/V1/StoragePoolsClient/delete.php index 9824c0188fdf..98c98f256ffd 100644 --- a/Compute/samples/V1/StoragePoolsClient/delete.php +++ b/Compute/samples/V1/StoragePoolsClient/delete.php @@ -30,7 +30,11 @@ use Google\Rpc\Status; /** - * Deletes the specified storage pool. Deleting a storagePool removes its data permanently and is irreversible. However, deleting a storagePool does not delete any snapshots previously made from the storagePool. You must separately delete snapshots. + * Deletes the specified storage pool. Deleting a storagePool + * removes its data permanently and is irreversible. However, deleting a + * storagePool does not delete any snapshots previously + * made from the storagePool. You must separately delete + * snapshots. * * @param string $project Project ID for this request. * @param string $storagePool Name of the storage pool to delete. diff --git a/Compute/samples/V1/StoragePoolsClient/get.php b/Compute/samples/V1/StoragePoolsClient/get.php index 92c7649b0c66..9403a312e4aa 100644 --- a/Compute/samples/V1/StoragePoolsClient/get.php +++ b/Compute/samples/V1/StoragePoolsClient/get.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\StoragePool; /** - * Returns a specified storage pool. Gets a list of available storage pools by making a list() request. + * Returns a specified storage pool. Gets a list of available + * storage pools by making a list() request. * * @param string $project Project ID for this request. * @param string $storagePool Name of the storage pool to return. diff --git a/Compute/samples/V1/StoragePoolsClient/get_iam_policy.php b/Compute/samples/V1/StoragePoolsClient/get_iam_policy.php index 24e955e17907..38b68fc5337e 100644 --- a/Compute/samples/V1/StoragePoolsClient/get_iam_policy.php +++ b/Compute/samples/V1/StoragePoolsClient/get_iam_policy.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\Policy; /** - * Gets the access control policy for a resource. May be empty if no such policy or resource exists. + * Gets the access control policy for a resource. May be empty if no such + * policy or resource exists. * * @param string $project Project ID for this request. * @param string $resource Name or id of the resource for this request. diff --git a/Compute/samples/V1/StoragePoolsClient/insert.php b/Compute/samples/V1/StoragePoolsClient/insert.php index 4abac2d3ee55..a38bed48f8fb 100644 --- a/Compute/samples/V1/StoragePoolsClient/insert.php +++ b/Compute/samples/V1/StoragePoolsClient/insert.php @@ -31,7 +31,8 @@ use Google\Rpc\Status; /** - * Creates a storage pool in the specified project using the data in the request. + * Creates a storage pool in the specified project using the data + * in the request. * * @param string $project Project ID for this request. * @param string $zone The name of the zone for this request. diff --git a/Compute/samples/V1/StoragePoolsClient/list.php b/Compute/samples/V1/StoragePoolsClient/list.php index eff746fa70dc..69acfc90d201 100644 --- a/Compute/samples/V1/StoragePoolsClient/list.php +++ b/Compute/samples/V1/StoragePoolsClient/list.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\ListStoragePoolsRequest; /** - * Retrieves a list of storage pools contained within the specified zone. + * Retrieves a list of storage pools contained within + * the specified zone. * * @param string $project Project ID for this request. * @param string $zone The name of the zone for this request. diff --git a/Compute/samples/V1/StoragePoolsClient/set_iam_policy.php b/Compute/samples/V1/StoragePoolsClient/set_iam_policy.php index d20fd01386f8..1134bac5427e 100644 --- a/Compute/samples/V1/StoragePoolsClient/set_iam_policy.php +++ b/Compute/samples/V1/StoragePoolsClient/set_iam_policy.php @@ -30,7 +30,8 @@ use Google\Cloud\Compute\V1\ZoneSetPolicyRequest; /** - * Sets the access control policy on the specified resource. Replaces any existing policy. + * Sets the access control policy on the specified resource. + * Replaces any existing policy. * * @param string $project Project ID for this request. * @param string $resource Name or id of the resource for this request. diff --git a/Compute/samples/V1/StoragePoolsClient/update.php b/Compute/samples/V1/StoragePoolsClient/update.php index 36815576acab..37f5a06b1e8d 100644 --- a/Compute/samples/V1/StoragePoolsClient/update.php +++ b/Compute/samples/V1/StoragePoolsClient/update.php @@ -31,7 +31,11 @@ use Google\Rpc\Status; /** - * Updates the specified storagePool with the data included in the request. The update is performed only on selected fields included as part of update-mask. Only the following fields can be modified: pool_provisioned_capacity_gb, pool_provisioned_iops and pool_provisioned_throughput. + * Updates the specified storagePool with the data included in the request. + * The update is performed only on selected fields included as part + * of update-mask. Only the following fields can be modified: + * pool_provisioned_capacity_gb, pool_provisioned_iops and + * pool_provisioned_throughput. * * @param string $project Project ID for this request. * @param string $storagePool The storagePool name for this request. diff --git a/Compute/samples/V1/SubnetworksClient/aggregated_list.php b/Compute/samples/V1/SubnetworksClient/aggregated_list.php index f80b206d0811..9d88c8317235 100644 --- a/Compute/samples/V1/SubnetworksClient/aggregated_list.php +++ b/Compute/samples/V1/SubnetworksClient/aggregated_list.php @@ -29,7 +29,10 @@ use Google\Cloud\Compute\V1\Client\SubnetworksClient; /** - * Retrieves an aggregated list of subnetworks. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. + * Retrieves an aggregated list of subnetworks. + * + * To prevent failure, Google recommends that you set the + * `returnPartialSuccess` parameter to `true`. * * @param string $project Project ID for this request. */ diff --git a/Compute/samples/V1/SubnetworksClient/get_iam_policy.php b/Compute/samples/V1/SubnetworksClient/get_iam_policy.php index e0fe6191c31d..1183c569aaf9 100644 --- a/Compute/samples/V1/SubnetworksClient/get_iam_policy.php +++ b/Compute/samples/V1/SubnetworksClient/get_iam_policy.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\Policy; /** - * Gets the access control policy for a resource. May be empty if no such policy or resource exists. + * Gets the access control policy for a resource. May be empty if no such + * policy or resource exists. * * @param string $project Project ID for this request. * @param string $region The name of the region for this request. diff --git a/Compute/samples/V1/SubnetworksClient/insert.php b/Compute/samples/V1/SubnetworksClient/insert.php index 7e01f2f2378f..49b7c356e218 100644 --- a/Compute/samples/V1/SubnetworksClient/insert.php +++ b/Compute/samples/V1/SubnetworksClient/insert.php @@ -31,7 +31,8 @@ use Google\Rpc\Status; /** - * Creates a subnetwork in the specified project using the data included in the request. + * Creates a subnetwork in the specified project using the data + * included in the request. * * @param string $project Project ID for this request. * @param string $region Name of the region scoping this request. diff --git a/Compute/samples/V1/SubnetworksClient/list.php b/Compute/samples/V1/SubnetworksClient/list.php index b2abdc868205..948d429dc0cd 100644 --- a/Compute/samples/V1/SubnetworksClient/list.php +++ b/Compute/samples/V1/SubnetworksClient/list.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\ListSubnetworksRequest; /** - * Retrieves a list of subnetworks available to the specified project. + * Retrieves a list of subnetworks available to the specified + * project. * * @param string $project Project ID for this request. * @param string $region Name of the region scoping this request. diff --git a/Compute/samples/V1/SubnetworksClient/patch.php b/Compute/samples/V1/SubnetworksClient/patch.php index cd18685c48a9..504781696802 100644 --- a/Compute/samples/V1/SubnetworksClient/patch.php +++ b/Compute/samples/V1/SubnetworksClient/patch.php @@ -31,7 +31,11 @@ use Google\Rpc\Status; /** - * Patches the specified subnetwork with the data included in the request. Only certain fields can be updated with a patch request as indicated in the field descriptions. You must specify the current fingerprint of the subnetwork resource being patched. + * Patches the specified subnetwork with the data included in the request. + * Only certain fields can be updated with a patch request + * as indicated in the field descriptions. + * You must specify the current fingerprint of the + * subnetwork resource being patched. * * @param string $project Project ID for this request. * @param string $region Name of the region scoping this request. diff --git a/Compute/samples/V1/SubnetworksClient/set_iam_policy.php b/Compute/samples/V1/SubnetworksClient/set_iam_policy.php index 1c4b8394a2ab..bf524c2da490 100644 --- a/Compute/samples/V1/SubnetworksClient/set_iam_policy.php +++ b/Compute/samples/V1/SubnetworksClient/set_iam_policy.php @@ -30,7 +30,8 @@ use Google\Cloud\Compute\V1\SetIamPolicySubnetworkRequest; /** - * Sets the access control policy on the specified resource. Replaces any existing policy. + * Sets the access control policy on the specified resource. + * Replaces any existing policy. * * @param string $project Project ID for this request. * @param string $region The name of the region for this request. diff --git a/Compute/samples/V1/SubnetworksClient/set_private_ip_google_access.php b/Compute/samples/V1/SubnetworksClient/set_private_ip_google_access.php index 5f97b80bf9c4..505535166a4d 100644 --- a/Compute/samples/V1/SubnetworksClient/set_private_ip_google_access.php +++ b/Compute/samples/V1/SubnetworksClient/set_private_ip_google_access.php @@ -31,7 +31,8 @@ use Google\Rpc\Status; /** - * Set whether VMs in this subnet can access Google services without assigning external IP addresses through Private Google Access. + * Set whether VMs in this subnet can access Google services without assigning + * external IP addresses through Private Google Access. * * @param string $project Project ID for this request. * @param string $region Name of the region scoping this request. diff --git a/Compute/samples/V1/TargetGrpcProxiesClient/insert.php b/Compute/samples/V1/TargetGrpcProxiesClient/insert.php index 2cc63a6b86cb..d577917eefae 100644 --- a/Compute/samples/V1/TargetGrpcProxiesClient/insert.php +++ b/Compute/samples/V1/TargetGrpcProxiesClient/insert.php @@ -31,7 +31,8 @@ use Google\Rpc\Status; /** - * Creates a TargetGrpcProxy in the specified project in the given scope using the parameters that are included in the request. + * Creates a TargetGrpcProxy in the specified project in the given scope + * using the parameters that are included in the request. * * @param string $project Project ID for this request. */ diff --git a/Compute/samples/V1/TargetGrpcProxiesClient/patch.php b/Compute/samples/V1/TargetGrpcProxiesClient/patch.php index 08030c06b633..d8ecd0d73d97 100644 --- a/Compute/samples/V1/TargetGrpcProxiesClient/patch.php +++ b/Compute/samples/V1/TargetGrpcProxiesClient/patch.php @@ -31,7 +31,10 @@ use Google\Rpc\Status; /** - * Patches the specified TargetGrpcProxy resource with the data included in the request. This method supports PATCH semantics and uses JSON merge patch format and processing rules. + * Patches the specified TargetGrpcProxy resource with the data included in + * the request. This method supports PATCH + * semantics and usesJSON merge + * patch format and processing rules. * * @param string $project Project ID for this request. * @param string $targetGrpcProxy Name of the TargetGrpcProxy resource to patch. diff --git a/Compute/samples/V1/TargetHttpProxiesClient/aggregated_list.php b/Compute/samples/V1/TargetHttpProxiesClient/aggregated_list.php index cec545ac187c..604a4af7b358 100644 --- a/Compute/samples/V1/TargetHttpProxiesClient/aggregated_list.php +++ b/Compute/samples/V1/TargetHttpProxiesClient/aggregated_list.php @@ -29,7 +29,11 @@ use Google\Cloud\Compute\V1\Client\TargetHttpProxiesClient; /** - * Retrieves the list of all TargetHttpProxy resources, regional and global, available to the specified project. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. + * Retrieves the list of all TargetHttpProxy resources, regional and global, + * available to the specified project. + * + * To prevent failure, Google recommends that you set the + * `returnPartialSuccess` parameter to `true`. * * @param string $project Name of the project scoping this request. */ diff --git a/Compute/samples/V1/TargetHttpProxiesClient/insert.php b/Compute/samples/V1/TargetHttpProxiesClient/insert.php index 901d5dbe315f..1f280e858097 100644 --- a/Compute/samples/V1/TargetHttpProxiesClient/insert.php +++ b/Compute/samples/V1/TargetHttpProxiesClient/insert.php @@ -31,7 +31,8 @@ use Google\Rpc\Status; /** - * Creates a TargetHttpProxy resource in the specified project using the data included in the request. + * Creates a TargetHttpProxy resource in the specified + * project using the data included in the request. * * @param string $project Project ID for this request. */ diff --git a/Compute/samples/V1/TargetHttpProxiesClient/list.php b/Compute/samples/V1/TargetHttpProxiesClient/list.php index 11fbd7c28264..9e737e669ef4 100644 --- a/Compute/samples/V1/TargetHttpProxiesClient/list.php +++ b/Compute/samples/V1/TargetHttpProxiesClient/list.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\ListTargetHttpProxiesRequest; /** - * Retrieves the list of TargetHttpProxy resources available to the specified project. + * Retrieves the list of TargetHttpProxy resources available + * to the specified project. * * @param string $project Project ID for this request. */ diff --git a/Compute/samples/V1/TargetHttpProxiesClient/patch.php b/Compute/samples/V1/TargetHttpProxiesClient/patch.php index fdfc5dcaaa23..7644ae7b9189 100644 --- a/Compute/samples/V1/TargetHttpProxiesClient/patch.php +++ b/Compute/samples/V1/TargetHttpProxiesClient/patch.php @@ -31,7 +31,10 @@ use Google\Rpc\Status; /** - * Patches the specified TargetHttpProxy resource with the data included in the request. This method supports PATCH semantics and uses JSON merge patch format and processing rules. + * Patches the specified TargetHttpProxy resource with the data included in + * the request. This method supports PATCH + * semantics and usesJSON merge + * patch format and processing rules. * * @param string $project Project ID for this request. * @param string $targetHttpProxy Name of the TargetHttpProxy resource to patch. diff --git a/Compute/samples/V1/TargetHttpsProxiesClient/aggregated_list.php b/Compute/samples/V1/TargetHttpsProxiesClient/aggregated_list.php index eccdeb507ad0..df1241855afd 100644 --- a/Compute/samples/V1/TargetHttpsProxiesClient/aggregated_list.php +++ b/Compute/samples/V1/TargetHttpsProxiesClient/aggregated_list.php @@ -29,7 +29,11 @@ use Google\Cloud\Compute\V1\Client\TargetHttpsProxiesClient; /** - * Retrieves the list of all TargetHttpsProxy resources, regional and global, available to the specified project. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. + * Retrieves the list of all TargetHttpsProxy resources, regional and global, + * available to the specified project. + * + * To prevent failure, Google recommends that you set the + * `returnPartialSuccess` parameter to `true`. * * @param string $project Name of the project scoping this request. */ diff --git a/Compute/samples/V1/TargetHttpsProxiesClient/insert.php b/Compute/samples/V1/TargetHttpsProxiesClient/insert.php index 6300f1aecc5f..04cf9dd64bb4 100644 --- a/Compute/samples/V1/TargetHttpsProxiesClient/insert.php +++ b/Compute/samples/V1/TargetHttpsProxiesClient/insert.php @@ -31,7 +31,8 @@ use Google\Rpc\Status; /** - * Creates a TargetHttpsProxy resource in the specified project using the data included in the request. + * Creates a TargetHttpsProxy resource in the specified + * project using the data included in the request. * * @param string $project Project ID for this request. */ diff --git a/Compute/samples/V1/TargetHttpsProxiesClient/list.php b/Compute/samples/V1/TargetHttpsProxiesClient/list.php index a645152342d5..a26d9220f649 100644 --- a/Compute/samples/V1/TargetHttpsProxiesClient/list.php +++ b/Compute/samples/V1/TargetHttpsProxiesClient/list.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\ListTargetHttpsProxiesRequest; /** - * Retrieves the list of TargetHttpsProxy resources available to the specified project. + * Retrieves the list of TargetHttpsProxy resources + * available to the specified project. * * @param string $project Project ID for this request. */ diff --git a/Compute/samples/V1/TargetHttpsProxiesClient/patch.php b/Compute/samples/V1/TargetHttpsProxiesClient/patch.php index b89583a88b19..333eeed5c0c4 100644 --- a/Compute/samples/V1/TargetHttpsProxiesClient/patch.php +++ b/Compute/samples/V1/TargetHttpsProxiesClient/patch.php @@ -31,7 +31,10 @@ use Google\Rpc\Status; /** - * Patches the specified TargetHttpsProxy resource with the data included in the request. This method supports PATCH semantics and uses JSON merge patch format and processing rules. + * Patches the specified TargetHttpsProxy resource with the data included in + * the request. This method supports PATCH + * semantics and usesJSON merge + * patch format and processing rules. * * @param string $project Project ID for this request. * @param string $targetHttpsProxy Name of the TargetHttpsProxy resource to patch. diff --git a/Compute/samples/V1/TargetHttpsProxiesClient/set_certificate_map.php b/Compute/samples/V1/TargetHttpsProxiesClient/set_certificate_map.php index e075e503edc5..22dd798a0b0a 100644 --- a/Compute/samples/V1/TargetHttpsProxiesClient/set_certificate_map.php +++ b/Compute/samples/V1/TargetHttpsProxiesClient/set_certificate_map.php @@ -34,7 +34,8 @@ * Changes the Certificate Map for TargetHttpsProxy. * * @param string $project Project ID for this request. - * @param string $targetHttpsProxy Name of the TargetHttpsProxy resource whose CertificateMap is to be set. The name must be 1-63 characters long, and comply with RFC1035. + * @param string $targetHttpsProxy Name of the TargetHttpsProxy resource whose CertificateMap is + * to be set. The name must be 1-63 characters long, and comply with RFC1035. */ function set_certificate_map_sample(string $project, string $targetHttpsProxy): void { diff --git a/Compute/samples/V1/TargetHttpsProxiesClient/set_quic_override.php b/Compute/samples/V1/TargetHttpsProxiesClient/set_quic_override.php index a50b9e034d5a..c217eb65f567 100644 --- a/Compute/samples/V1/TargetHttpsProxiesClient/set_quic_override.php +++ b/Compute/samples/V1/TargetHttpsProxiesClient/set_quic_override.php @@ -34,7 +34,8 @@ * Sets the QUIC override policy for TargetHttpsProxy. * * @param string $project Project ID for this request. - * @param string $targetHttpsProxy Name of the TargetHttpsProxy resource to set the QUIC override policy for. The name should conform to RFC1035. + * @param string $targetHttpsProxy Name of the TargetHttpsProxy resource to set the QUIC override policy for. + * The name should conform to RFC1035. */ function set_quic_override_sample(string $project, string $targetHttpsProxy): void { diff --git a/Compute/samples/V1/TargetHttpsProxiesClient/set_ssl_certificates.php b/Compute/samples/V1/TargetHttpsProxiesClient/set_ssl_certificates.php index f787815e5b3d..b97b6f8083d1 100644 --- a/Compute/samples/V1/TargetHttpsProxiesClient/set_ssl_certificates.php +++ b/Compute/samples/V1/TargetHttpsProxiesClient/set_ssl_certificates.php @@ -34,7 +34,8 @@ * Replaces SslCertificates for TargetHttpsProxy. * * @param string $project Project ID for this request. - * @param string $targetHttpsProxy Name of the TargetHttpsProxy resource to set an SslCertificates resource for. + * @param string $targetHttpsProxy Name of the TargetHttpsProxy resource to set an + * SslCertificates resource for. */ function set_ssl_certificates_sample(string $project, string $targetHttpsProxy): void { diff --git a/Compute/samples/V1/TargetHttpsProxiesClient/set_ssl_policy.php b/Compute/samples/V1/TargetHttpsProxiesClient/set_ssl_policy.php index 021947d5f857..63d1811923de 100644 --- a/Compute/samples/V1/TargetHttpsProxiesClient/set_ssl_policy.php +++ b/Compute/samples/V1/TargetHttpsProxiesClient/set_ssl_policy.php @@ -31,10 +31,14 @@ use Google\Rpc\Status; /** - * Sets the SSL policy for TargetHttpsProxy. The SSL policy specifies the server-side support for SSL features. This affects connections between clients and the HTTPS proxy load balancer. They do not affect the connection between the load balancer and the backends. + * Sets the SSL policy for TargetHttpsProxy. The SSL policy specifies the + * server-side support for SSL features. This affects connections between + * clients and the HTTPS proxy load balancer. They do not affect the + * connection between the load balancer and the backends. * * @param string $project Project ID for this request. - * @param string $targetHttpsProxy Name of the TargetHttpsProxy resource whose SSL policy is to be set. The name must be 1-63 characters long, and comply with RFC1035. + * @param string $targetHttpsProxy Name of the TargetHttpsProxy resource whose SSL policy is + * to be set. The name must be 1-63 characters long, and comply with RFC1035. */ function set_ssl_policy_sample(string $project, string $targetHttpsProxy): void { diff --git a/Compute/samples/V1/TargetHttpsProxiesClient/set_url_map.php b/Compute/samples/V1/TargetHttpsProxiesClient/set_url_map.php index ea815b0b3301..ea872d31cb5a 100644 --- a/Compute/samples/V1/TargetHttpsProxiesClient/set_url_map.php +++ b/Compute/samples/V1/TargetHttpsProxiesClient/set_url_map.php @@ -34,7 +34,8 @@ * Changes the URL map for TargetHttpsProxy. * * @param string $project Project ID for this request. - * @param string $targetHttpsProxy Name of the TargetHttpsProxy resource whose URL map is to be set. + * @param string $targetHttpsProxy Name of the TargetHttpsProxy resource whose URL map is + * to be set. */ function set_url_map_sample(string $project, string $targetHttpsProxy): void { diff --git a/Compute/samples/V1/TargetInstancesClient/aggregated_list.php b/Compute/samples/V1/TargetInstancesClient/aggregated_list.php index ebbc4ccab212..2605ad078b9e 100644 --- a/Compute/samples/V1/TargetInstancesClient/aggregated_list.php +++ b/Compute/samples/V1/TargetInstancesClient/aggregated_list.php @@ -29,7 +29,10 @@ use Google\Cloud\Compute\V1\Client\TargetInstancesClient; /** - * Retrieves an aggregated list of target instances. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. + * Retrieves an aggregated list of target instances. + * + * To prevent failure, Google recommends that you set the + * `returnPartialSuccess` parameter to `true`. * * @param string $project Project ID for this request. */ diff --git a/Compute/samples/V1/TargetInstancesClient/insert.php b/Compute/samples/V1/TargetInstancesClient/insert.php index 74b7364465be..7dbf29c41a3e 100644 --- a/Compute/samples/V1/TargetInstancesClient/insert.php +++ b/Compute/samples/V1/TargetInstancesClient/insert.php @@ -31,7 +31,8 @@ use Google\Rpc\Status; /** - * Creates a TargetInstance resource in the specified project and zone using the data included in the request. + * Creates a TargetInstance resource in the specified project and zone using + * the data included in the request. * * @param string $project Project ID for this request. * @param string $zone Name of the zone scoping this request. diff --git a/Compute/samples/V1/TargetInstancesClient/list.php b/Compute/samples/V1/TargetInstancesClient/list.php index 076ad0cc4997..be62c3f11d54 100644 --- a/Compute/samples/V1/TargetInstancesClient/list.php +++ b/Compute/samples/V1/TargetInstancesClient/list.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\ListTargetInstancesRequest; /** - * Retrieves a list of TargetInstance resources available to the specified project and zone. + * Retrieves a list of TargetInstance resources available to the specified + * project and zone. * * @param string $project Project ID for this request. * @param string $zone Name of the zone scoping this request. diff --git a/Compute/samples/V1/TargetInstancesClient/set_security_policy.php b/Compute/samples/V1/TargetInstancesClient/set_security_policy.php index 3a959cd2b339..3a3777bc773a 100644 --- a/Compute/samples/V1/TargetInstancesClient/set_security_policy.php +++ b/Compute/samples/V1/TargetInstancesClient/set_security_policy.php @@ -31,10 +31,13 @@ use Google\Rpc\Status; /** - * Sets the Google Cloud Armor security policy for the specified target instance. For more information, see Google Cloud Armor Overview + * Sets the Google Cloud Armor security policy for the specified target + * instance. For more information, seeGoogle + * Cloud Armor Overview * * @param string $project Project ID for this request. - * @param string $targetInstance Name of the TargetInstance resource to which the security policy should be set. The name should conform to RFC1035. + * @param string $targetInstance Name of the TargetInstance resource to which the security policy should be + * set. The name should conform to RFC1035. * @param string $zone Name of the zone scoping this request. */ function set_security_policy_sample(string $project, string $targetInstance, string $zone): void diff --git a/Compute/samples/V1/TargetPoolsClient/aggregated_list.php b/Compute/samples/V1/TargetPoolsClient/aggregated_list.php index c686ee305934..232cb7b63496 100644 --- a/Compute/samples/V1/TargetPoolsClient/aggregated_list.php +++ b/Compute/samples/V1/TargetPoolsClient/aggregated_list.php @@ -29,7 +29,10 @@ use Google\Cloud\Compute\V1\Client\TargetPoolsClient; /** - * Retrieves an aggregated list of target pools. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. + * Retrieves an aggregated list of target pools. + * + * To prevent failure, Google recommends that you set the + * `returnPartialSuccess` parameter to `true`. * * @param string $project Project ID for this request. */ diff --git a/Compute/samples/V1/TargetPoolsClient/get_health.php b/Compute/samples/V1/TargetPoolsClient/get_health.php index 01bac9e3cf26..028ccaee8d2f 100644 --- a/Compute/samples/V1/TargetPoolsClient/get_health.php +++ b/Compute/samples/V1/TargetPoolsClient/get_health.php @@ -30,7 +30,8 @@ use Google\Cloud\Compute\V1\TargetPoolInstanceHealth; /** - * Gets the most recent health check results for each IP for the instance that is referenced by the given target pool. + * Gets the most recent health check results for each IP for the + * instance that is referenced by the given target pool. * * @param string $project Project ID for this request. * @param string $region Name of the region scoping this request. diff --git a/Compute/samples/V1/TargetPoolsClient/insert.php b/Compute/samples/V1/TargetPoolsClient/insert.php index 674ac1552f20..16249b255cab 100644 --- a/Compute/samples/V1/TargetPoolsClient/insert.php +++ b/Compute/samples/V1/TargetPoolsClient/insert.php @@ -31,7 +31,8 @@ use Google\Rpc\Status; /** - * Creates a target pool in the specified project and region using the data included in the request. + * Creates a target pool in the specified project and region using + * the data included in the request. * * @param string $project Project ID for this request. * @param string $region Name of the region scoping this request. diff --git a/Compute/samples/V1/TargetPoolsClient/list.php b/Compute/samples/V1/TargetPoolsClient/list.php index 23318fefa39f..a72503a668d7 100644 --- a/Compute/samples/V1/TargetPoolsClient/list.php +++ b/Compute/samples/V1/TargetPoolsClient/list.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\ListTargetPoolsRequest; /** - * Retrieves a list of target pools available to the specified project and region. + * Retrieves a list of target pools available to the specified + * project and region. * * @param string $project Project ID for this request. * @param string $region Name of the region scoping this request. diff --git a/Compute/samples/V1/TargetPoolsClient/set_security_policy.php b/Compute/samples/V1/TargetPoolsClient/set_security_policy.php index 6fb96d6e181b..8e815ea3c175 100644 --- a/Compute/samples/V1/TargetPoolsClient/set_security_policy.php +++ b/Compute/samples/V1/TargetPoolsClient/set_security_policy.php @@ -31,11 +31,14 @@ use Google\Rpc\Status; /** - * Sets the Google Cloud Armor security policy for the specified target pool. For more information, see Google Cloud Armor Overview + * Sets the Google Cloud Armor security policy for the specified target pool. + * For more information, seeGoogle + * Cloud Armor Overview * * @param string $project Project ID for this request. * @param string $region Name of the region scoping this request. - * @param string $targetPool Name of the TargetPool resource to which the security policy should be set. The name should conform to RFC1035. + * @param string $targetPool Name of the TargetPool resource to which the security policy should be + * set. The name should conform to RFC1035. */ function set_security_policy_sample(string $project, string $region, string $targetPool): void { diff --git a/Compute/samples/V1/TargetSslProxiesClient/insert.php b/Compute/samples/V1/TargetSslProxiesClient/insert.php index 6bbb53c7545b..9afd58ae3c8a 100644 --- a/Compute/samples/V1/TargetSslProxiesClient/insert.php +++ b/Compute/samples/V1/TargetSslProxiesClient/insert.php @@ -31,7 +31,8 @@ use Google\Rpc\Status; /** - * Creates a TargetSslProxy resource in the specified project using the data included in the request. + * Creates a TargetSslProxy resource in the specified project using + * the data included in the request. * * @param string $project Project ID for this request. */ diff --git a/Compute/samples/V1/TargetSslProxiesClient/list.php b/Compute/samples/V1/TargetSslProxiesClient/list.php index d5829a6d1e4f..4c4248c6ba31 100644 --- a/Compute/samples/V1/TargetSslProxiesClient/list.php +++ b/Compute/samples/V1/TargetSslProxiesClient/list.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\ListTargetSslProxiesRequest; /** - * Retrieves the list of TargetSslProxy resources available to the specified project. + * Retrieves the list of TargetSslProxy resources + * available to the specified project. * * @param string $project Project ID for this request. */ diff --git a/Compute/samples/V1/TargetSslProxiesClient/set_backend_service.php b/Compute/samples/V1/TargetSslProxiesClient/set_backend_service.php index 89d470be6f1d..b2733df1fe98 100644 --- a/Compute/samples/V1/TargetSslProxiesClient/set_backend_service.php +++ b/Compute/samples/V1/TargetSslProxiesClient/set_backend_service.php @@ -34,7 +34,8 @@ * Changes the BackendService for TargetSslProxy. * * @param string $project Project ID for this request. - * @param string $targetSslProxy Name of the TargetSslProxy resource whose BackendService resource is to be set. + * @param string $targetSslProxy Name of the TargetSslProxy resource whose BackendService resource + * is to be set. */ function set_backend_service_sample(string $project, string $targetSslProxy): void { diff --git a/Compute/samples/V1/TargetSslProxiesClient/set_certificate_map.php b/Compute/samples/V1/TargetSslProxiesClient/set_certificate_map.php index bc16c1f341c8..ca00a96cbbfb 100644 --- a/Compute/samples/V1/TargetSslProxiesClient/set_certificate_map.php +++ b/Compute/samples/V1/TargetSslProxiesClient/set_certificate_map.php @@ -34,7 +34,8 @@ * Changes the Certificate Map for TargetSslProxy. * * @param string $project Project ID for this request. - * @param string $targetSslProxy Name of the TargetSslProxy resource whose CertificateMap is to be set. The name must be 1-63 characters long, and comply with RFC1035. + * @param string $targetSslProxy Name of the TargetSslProxy resource whose CertificateMap is + * to be set. The name must be 1-63 characters long, and comply with RFC1035. */ function set_certificate_map_sample(string $project, string $targetSslProxy): void { diff --git a/Compute/samples/V1/TargetSslProxiesClient/set_ssl_certificates.php b/Compute/samples/V1/TargetSslProxiesClient/set_ssl_certificates.php index 76479c770282..2e8964ecc63d 100644 --- a/Compute/samples/V1/TargetSslProxiesClient/set_ssl_certificates.php +++ b/Compute/samples/V1/TargetSslProxiesClient/set_ssl_certificates.php @@ -34,7 +34,8 @@ * Changes SslCertificates for TargetSslProxy. * * @param string $project Project ID for this request. - * @param string $targetSslProxy Name of the TargetSslProxy resource whose SslCertificate resource is to be set. + * @param string $targetSslProxy Name of the TargetSslProxy resource whose SslCertificate resource + * is to be set. */ function set_ssl_certificates_sample(string $project, string $targetSslProxy): void { diff --git a/Compute/samples/V1/TargetSslProxiesClient/set_ssl_policy.php b/Compute/samples/V1/TargetSslProxiesClient/set_ssl_policy.php index 9400ea722495..d97fd72ab565 100644 --- a/Compute/samples/V1/TargetSslProxiesClient/set_ssl_policy.php +++ b/Compute/samples/V1/TargetSslProxiesClient/set_ssl_policy.php @@ -31,10 +31,14 @@ use Google\Rpc\Status; /** - * Sets the SSL policy for TargetSslProxy. The SSL policy specifies the server-side support for SSL features. This affects connections between clients and the load balancer. They do not affect the connection between the load balancer and the backends. + * Sets the SSL policy for TargetSslProxy. The SSL policy specifies the + * server-side support for SSL features. This affects connections between + * clients and the load balancer. They do not affect the + * connection between the load balancer and the backends. * * @param string $project Project ID for this request. - * @param string $targetSslProxy Name of the TargetSslProxy resource whose SSL policy is to be set. The name must be 1-63 characters long, and comply with RFC1035. + * @param string $targetSslProxy Name of the TargetSslProxy resource whose SSL policy is + * to be set. The name must be 1-63 characters long, and comply with RFC1035. */ function set_ssl_policy_sample(string $project, string $targetSslProxy): void { diff --git a/Compute/samples/V1/TargetTcpProxiesClient/aggregated_list.php b/Compute/samples/V1/TargetTcpProxiesClient/aggregated_list.php index 4804c2bfa1ee..e5cc9cf39243 100644 --- a/Compute/samples/V1/TargetTcpProxiesClient/aggregated_list.php +++ b/Compute/samples/V1/TargetTcpProxiesClient/aggregated_list.php @@ -29,7 +29,11 @@ use Google\Cloud\Compute\V1\Client\TargetTcpProxiesClient; /** - * Retrieves the list of all TargetTcpProxy resources, regional and global, available to the specified project. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. + * Retrieves the list of all TargetTcpProxy resources, regional and global, + * available to the specified project. + * + * To prevent failure, Google recommends that you set the + * `returnPartialSuccess` parameter to `true`. * * @param string $project Name of the project scoping this request. */ diff --git a/Compute/samples/V1/TargetTcpProxiesClient/insert.php b/Compute/samples/V1/TargetTcpProxiesClient/insert.php index c9acebc3dd25..d0a52b6fba61 100644 --- a/Compute/samples/V1/TargetTcpProxiesClient/insert.php +++ b/Compute/samples/V1/TargetTcpProxiesClient/insert.php @@ -31,7 +31,8 @@ use Google\Rpc\Status; /** - * Creates a TargetTcpProxy resource in the specified project using the data included in the request. + * Creates a TargetTcpProxy resource in the specified project using + * the data included in the request. * * @param string $project Project ID for this request. */ diff --git a/Compute/samples/V1/TargetTcpProxiesClient/list.php b/Compute/samples/V1/TargetTcpProxiesClient/list.php index f633b8f17580..c0f45a23a1d5 100644 --- a/Compute/samples/V1/TargetTcpProxiesClient/list.php +++ b/Compute/samples/V1/TargetTcpProxiesClient/list.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\ListTargetTcpProxiesRequest; /** - * Retrieves the list of TargetTcpProxy resources available to the specified project. + * Retrieves the list of TargetTcpProxy resources + * available to the specified project. * * @param string $project Project ID for this request. */ diff --git a/Compute/samples/V1/TargetTcpProxiesClient/set_backend_service.php b/Compute/samples/V1/TargetTcpProxiesClient/set_backend_service.php index 75a12917735f..6b4627025c86 100644 --- a/Compute/samples/V1/TargetTcpProxiesClient/set_backend_service.php +++ b/Compute/samples/V1/TargetTcpProxiesClient/set_backend_service.php @@ -34,7 +34,8 @@ * Changes the BackendService for TargetTcpProxy. * * @param string $project Project ID for this request. - * @param string $targetTcpProxy Name of the TargetTcpProxy resource whose BackendService resource is to be set. + * @param string $targetTcpProxy Name of the TargetTcpProxy resource whose BackendService resource + * is to be set. */ function set_backend_service_sample(string $project, string $targetTcpProxy): void { diff --git a/Compute/samples/V1/TargetVpnGatewaysClient/aggregated_list.php b/Compute/samples/V1/TargetVpnGatewaysClient/aggregated_list.php index b5850f84709d..7c600ba3f07c 100644 --- a/Compute/samples/V1/TargetVpnGatewaysClient/aggregated_list.php +++ b/Compute/samples/V1/TargetVpnGatewaysClient/aggregated_list.php @@ -29,7 +29,10 @@ use Google\Cloud\Compute\V1\Client\TargetVpnGatewaysClient; /** - * Retrieves an aggregated list of target VPN gateways. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. + * Retrieves an aggregated list of target VPN gateways. + * + * To prevent failure, Google recommends that you set the + * `returnPartialSuccess` parameter to `true`. * * @param string $project Project ID for this request. */ diff --git a/Compute/samples/V1/TargetVpnGatewaysClient/insert.php b/Compute/samples/V1/TargetVpnGatewaysClient/insert.php index 3361c22e7276..7802f366864a 100644 --- a/Compute/samples/V1/TargetVpnGatewaysClient/insert.php +++ b/Compute/samples/V1/TargetVpnGatewaysClient/insert.php @@ -31,7 +31,8 @@ use Google\Rpc\Status; /** - * Creates a target VPN gateway in the specified project and region using the data included in the request. + * Creates a target VPN gateway in the specified project and region using + * the data included in the request. * * @param string $project Project ID for this request. * @param string $region Name of the region for this request. diff --git a/Compute/samples/V1/TargetVpnGatewaysClient/list.php b/Compute/samples/V1/TargetVpnGatewaysClient/list.php index 05ff29005a60..f57f61f57e01 100644 --- a/Compute/samples/V1/TargetVpnGatewaysClient/list.php +++ b/Compute/samples/V1/TargetVpnGatewaysClient/list.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\ListTargetVpnGatewaysRequest; /** - * Retrieves a list of target VPN gateways available to the specified project and region. + * Retrieves a list of target VPN gateways available to the specified + * project and region. * * @param string $project Project ID for this request. * @param string $region Name of the region for this request. diff --git a/Compute/samples/V1/TargetVpnGatewaysClient/set_labels.php b/Compute/samples/V1/TargetVpnGatewaysClient/set_labels.php index 686fab02ef73..f97288e4b43a 100644 --- a/Compute/samples/V1/TargetVpnGatewaysClient/set_labels.php +++ b/Compute/samples/V1/TargetVpnGatewaysClient/set_labels.php @@ -31,7 +31,8 @@ use Google\Rpc\Status; /** - * Sets the labels on a TargetVpnGateway. To learn more about labels, read the Labeling Resources documentation. + * Sets the labels on a TargetVpnGateway. To learn more about labels, read theLabeling + * Resources documentation. * * @param string $project Project ID for this request. * @param string $region The region for this request. diff --git a/Compute/samples/V1/UrlMapsClient/aggregated_list.php b/Compute/samples/V1/UrlMapsClient/aggregated_list.php index 30b3e026be7a..98ca53748f39 100644 --- a/Compute/samples/V1/UrlMapsClient/aggregated_list.php +++ b/Compute/samples/V1/UrlMapsClient/aggregated_list.php @@ -29,7 +29,11 @@ use Google\Cloud\Compute\V1\Client\UrlMapsClient; /** - * Retrieves the list of all UrlMap resources, regional and global, available to the specified project. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. + * Retrieves the list of all UrlMap resources, regional and global, + * available to the specified project. + * + * To prevent failure, Google recommends that you set the + * `returnPartialSuccess` parameter to `true`. * * @param string $project Name of the project scoping this request. */ diff --git a/Compute/samples/V1/UrlMapsClient/insert.php b/Compute/samples/V1/UrlMapsClient/insert.php index a149e7e7e21b..0a8306e00093 100644 --- a/Compute/samples/V1/UrlMapsClient/insert.php +++ b/Compute/samples/V1/UrlMapsClient/insert.php @@ -31,7 +31,8 @@ use Google\Rpc\Status; /** - * Creates a UrlMap resource in the specified project using the data included in the request. + * Creates a UrlMap resource in the specified project using + * the data included in the request. * * @param string $project Project ID for this request. */ diff --git a/Compute/samples/V1/UrlMapsClient/invalidate_cache.php b/Compute/samples/V1/UrlMapsClient/invalidate_cache.php index 229f5d427be9..5b6e13b13a04 100644 --- a/Compute/samples/V1/UrlMapsClient/invalidate_cache.php +++ b/Compute/samples/V1/UrlMapsClient/invalidate_cache.php @@ -31,7 +31,11 @@ use Google\Rpc\Status; /** - * Initiates a cache invalidation operation, invalidating the specified path, scoped to the specified UrlMap. For more information, see [Invalidating cached content](/cdn/docs/invalidating-cached-content). + * Initiates a cache invalidation operation, invalidating the specified path, + * scoped to the specified UrlMap. + * + * For more information, see [Invalidating cached + * content](/cdn/docs/invalidating-cached-content). * * @param string $project Project ID for this request. * @param string $urlMap Name of the UrlMap scoping this request. diff --git a/Compute/samples/V1/UrlMapsClient/list.php b/Compute/samples/V1/UrlMapsClient/list.php index 379f0e7ae929..78a0ed854066 100644 --- a/Compute/samples/V1/UrlMapsClient/list.php +++ b/Compute/samples/V1/UrlMapsClient/list.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\ListUrlMapsRequest; /** - * Retrieves the list of UrlMap resources available to the specified project. + * Retrieves the list of UrlMap resources available to the specified + * project. * * @param string $project Project ID for this request. */ diff --git a/Compute/samples/V1/UrlMapsClient/patch.php b/Compute/samples/V1/UrlMapsClient/patch.php index 62260630ac16..9933e6d45e96 100644 --- a/Compute/samples/V1/UrlMapsClient/patch.php +++ b/Compute/samples/V1/UrlMapsClient/patch.php @@ -31,7 +31,10 @@ use Google\Rpc\Status; /** - * Patches the specified UrlMap resource with the data included in the request. This method supports PATCH semantics and uses the JSON merge patch format and processing rules. + * Patches the specified UrlMap resource with the data included in the + * request. This method supportsPATCH + * semantics and uses theJSON merge + * patch format and processing rules. * * @param string $project Project ID for this request. * @param string $urlMap Name of the UrlMap resource to patch. diff --git a/Compute/samples/V1/UrlMapsClient/update.php b/Compute/samples/V1/UrlMapsClient/update.php index c1e36cc8e34b..b01361bede8f 100644 --- a/Compute/samples/V1/UrlMapsClient/update.php +++ b/Compute/samples/V1/UrlMapsClient/update.php @@ -31,7 +31,8 @@ use Google\Rpc\Status; /** - * Updates the specified UrlMap resource with the data included in the request. + * Updates the specified UrlMap resource with the data included in the + * request. * * @param string $project Project ID for this request. * @param string $urlMap Name of the UrlMap resource to update. diff --git a/Compute/samples/V1/UrlMapsClient/validate.php b/Compute/samples/V1/UrlMapsClient/validate.php index ca9bc52562bc..a9e3af1db048 100644 --- a/Compute/samples/V1/UrlMapsClient/validate.php +++ b/Compute/samples/V1/UrlMapsClient/validate.php @@ -30,7 +30,9 @@ use Google\Cloud\Compute\V1\ValidateUrlMapRequest; /** - * Runs static validation for the UrlMap. In particular, the tests of the provided UrlMap will be run. Calling this method does NOT create the UrlMap. + * Runs static validation for the UrlMap. In particular, the tests of the + * provided UrlMap will be run. Calling this method does NOT create the + * UrlMap. * * @param string $project Project ID for this request. * @param string $urlMap Name of the UrlMap resource to be validated as. diff --git a/Compute/samples/V1/VpnGatewaysClient/aggregated_list.php b/Compute/samples/V1/VpnGatewaysClient/aggregated_list.php index 2f6125fec218..c4435d1cb539 100644 --- a/Compute/samples/V1/VpnGatewaysClient/aggregated_list.php +++ b/Compute/samples/V1/VpnGatewaysClient/aggregated_list.php @@ -29,7 +29,10 @@ use Google\Cloud\Compute\V1\Client\VpnGatewaysClient; /** - * Retrieves an aggregated list of VPN gateways. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. + * Retrieves an aggregated list of VPN gateways. + * + * To prevent failure, Google recommends that you set the + * `returnPartialSuccess` parameter to `true`. * * @param string $project Project ID for this request. */ diff --git a/Compute/samples/V1/VpnGatewaysClient/insert.php b/Compute/samples/V1/VpnGatewaysClient/insert.php index c377cbfddbc3..ae1ec78d8488 100644 --- a/Compute/samples/V1/VpnGatewaysClient/insert.php +++ b/Compute/samples/V1/VpnGatewaysClient/insert.php @@ -31,7 +31,8 @@ use Google\Rpc\Status; /** - * Creates a VPN gateway in the specified project and region using the data included in the request. + * Creates a VPN gateway in the specified project and region using + * the data included in the request. * * @param string $project Project ID for this request. * @param string $region Name of the region for this request. diff --git a/Compute/samples/V1/VpnGatewaysClient/list.php b/Compute/samples/V1/VpnGatewaysClient/list.php index 21e83adcb6dc..f4491e02fe5e 100644 --- a/Compute/samples/V1/VpnGatewaysClient/list.php +++ b/Compute/samples/V1/VpnGatewaysClient/list.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\ListVpnGatewaysRequest; /** - * Retrieves a list of VPN gateways available to the specified project and region. + * Retrieves a list of VPN gateways available to the specified + * project and region. * * @param string $project Project ID for this request. * @param string $region Name of the region for this request. diff --git a/Compute/samples/V1/VpnGatewaysClient/set_labels.php b/Compute/samples/V1/VpnGatewaysClient/set_labels.php index 28c5c30ef2b1..92989fd87571 100644 --- a/Compute/samples/V1/VpnGatewaysClient/set_labels.php +++ b/Compute/samples/V1/VpnGatewaysClient/set_labels.php @@ -31,7 +31,8 @@ use Google\Rpc\Status; /** - * Sets the labels on a VpnGateway. To learn more about labels, read the Labeling Resources documentation. + * Sets the labels on a VpnGateway. To learn more about labels, read theLabeling + * Resources documentation. * * @param string $project Project ID for this request. * @param string $region The region for this request. diff --git a/Compute/samples/V1/VpnTunnelsClient/aggregated_list.php b/Compute/samples/V1/VpnTunnelsClient/aggregated_list.php index d76b8d684e6c..75fc65fd3955 100644 --- a/Compute/samples/V1/VpnTunnelsClient/aggregated_list.php +++ b/Compute/samples/V1/VpnTunnelsClient/aggregated_list.php @@ -29,7 +29,10 @@ use Google\Cloud\Compute\V1\Client\VpnTunnelsClient; /** - * Retrieves an aggregated list of VPN tunnels. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. + * Retrieves an aggregated list of VPN tunnels. + * + * To prevent failure, Google recommends that you set the + * `returnPartialSuccess` parameter to `true`. * * @param string $project Project ID for this request. */ diff --git a/Compute/samples/V1/VpnTunnelsClient/insert.php b/Compute/samples/V1/VpnTunnelsClient/insert.php index 297c8bb7378b..424e8724773c 100644 --- a/Compute/samples/V1/VpnTunnelsClient/insert.php +++ b/Compute/samples/V1/VpnTunnelsClient/insert.php @@ -31,7 +31,8 @@ use Google\Rpc\Status; /** - * Creates a VpnTunnel resource in the specified project and region using the data included in the request. + * Creates a VpnTunnel resource in the specified project and region using + * the data included in the request. * * @param string $project Project ID for this request. * @param string $region Name of the region for this request. diff --git a/Compute/samples/V1/VpnTunnelsClient/list.php b/Compute/samples/V1/VpnTunnelsClient/list.php index f64aa97fde62..d26214e8d7d0 100644 --- a/Compute/samples/V1/VpnTunnelsClient/list.php +++ b/Compute/samples/V1/VpnTunnelsClient/list.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\ListVpnTunnelsRequest; /** - * Retrieves a list of VpnTunnel resources contained in the specified project and region. + * Retrieves a list of VpnTunnel resources contained in the specified + * project and region. * * @param string $project Project ID for this request. * @param string $region Name of the region for this request. diff --git a/Compute/samples/V1/VpnTunnelsClient/set_labels.php b/Compute/samples/V1/VpnTunnelsClient/set_labels.php index c44873aaa046..abbee8cbd80d 100644 --- a/Compute/samples/V1/VpnTunnelsClient/set_labels.php +++ b/Compute/samples/V1/VpnTunnelsClient/set_labels.php @@ -31,7 +31,8 @@ use Google\Rpc\Status; /** - * Sets the labels on a VpnTunnel. To learn more about labels, read the Labeling Resources documentation. + * Sets the labels on a VpnTunnel. To learn more about labels, read theLabeling + * Resources documentation. * * @param string $project Project ID for this request. * @param string $region The region for this request. diff --git a/Compute/samples/V1/WireGroupsClient/delete.php b/Compute/samples/V1/WireGroupsClient/delete.php new file mode 100644 index 000000000000..343749368ad2 --- /dev/null +++ b/Compute/samples/V1/WireGroupsClient/delete.php @@ -0,0 +1,85 @@ +setCrossSiteNetwork($crossSiteNetwork) + ->setProject($project) + ->setWireGroup($wireGroup); + + // Call the API and handle any network failures. + try { + /** @var OperationResponse $response */ + $response = $wireGroupsClient->delete($request); + $response->pollUntilComplete(); + + if ($response->operationSucceeded()) { + printf('Operation completed successfully.' . PHP_EOL); + } else { + /** @var Status $error */ + $error = $response->getError(); + printf('Operation failed with error data: %s' . PHP_EOL, $error->serializeToJsonString()); + } + } catch (ApiException $ex) { + printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage()); + } +} + +/** + * Helper to execute the sample. + * + * This sample has been automatically generated and should be regarded as a code + * template only. It will require modifications to work: + * - It may require correct/in-range values for request initialization. + * - It may require specifying regional endpoints when creating the service client, + * please see the apiEndpoint client configuration option for more details. + */ +function callSample(): void +{ + $crossSiteNetwork = '[CROSS_SITE_NETWORK]'; + $project = '[PROJECT]'; + $wireGroup = '[WIRE_GROUP]'; + + delete_sample($crossSiteNetwork, $project, $wireGroup); +} +// [END compute_v1_generated_WireGroups_Delete_sync] diff --git a/Compute/samples/V1/WireGroupsClient/get.php b/Compute/samples/V1/WireGroupsClient/get.php new file mode 100644 index 000000000000..fdbed0254c73 --- /dev/null +++ b/Compute/samples/V1/WireGroupsClient/get.php @@ -0,0 +1,76 @@ +setCrossSiteNetwork($crossSiteNetwork) + ->setProject($project) + ->setWireGroup($wireGroup); + + // Call the API and handle any network failures. + try { + /** @var WireGroup $response */ + $response = $wireGroupsClient->get($request); + printf('Response data: %s' . PHP_EOL, $response->serializeToJsonString()); + } catch (ApiException $ex) { + printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage()); + } +} + +/** + * Helper to execute the sample. + * + * This sample has been automatically generated and should be regarded as a code + * template only. It will require modifications to work: + * - It may require correct/in-range values for request initialization. + * - It may require specifying regional endpoints when creating the service client, + * please see the apiEndpoint client configuration option for more details. + */ +function callSample(): void +{ + $crossSiteNetwork = '[CROSS_SITE_NETWORK]'; + $project = '[PROJECT]'; + $wireGroup = '[WIRE_GROUP]'; + + get_sample($crossSiteNetwork, $project, $wireGroup); +} +// [END compute_v1_generated_WireGroups_Get_sync] diff --git a/Compute/samples/V1/WireGroupsClient/insert.php b/Compute/samples/V1/WireGroupsClient/insert.php new file mode 100644 index 000000000000..5bd75405f5e1 --- /dev/null +++ b/Compute/samples/V1/WireGroupsClient/insert.php @@ -0,0 +1,86 @@ +setCrossSiteNetwork($crossSiteNetwork) + ->setProject($project) + ->setWireGroupResource($wireGroupResource); + + // Call the API and handle any network failures. + try { + /** @var OperationResponse $response */ + $response = $wireGroupsClient->insert($request); + $response->pollUntilComplete(); + + if ($response->operationSucceeded()) { + printf('Operation completed successfully.' . PHP_EOL); + } else { + /** @var Status $error */ + $error = $response->getError(); + printf('Operation failed with error data: %s' . PHP_EOL, $error->serializeToJsonString()); + } + } catch (ApiException $ex) { + printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage()); + } +} + +/** + * Helper to execute the sample. + * + * This sample has been automatically generated and should be regarded as a code + * template only. It will require modifications to work: + * - It may require correct/in-range values for request initialization. + * - It may require specifying regional endpoints when creating the service client, + * please see the apiEndpoint client configuration option for more details. + */ +function callSample(): void +{ + $crossSiteNetwork = '[CROSS_SITE_NETWORK]'; + $project = '[PROJECT]'; + + insert_sample($crossSiteNetwork, $project); +} +// [END compute_v1_generated_WireGroups_Insert_sync] diff --git a/Compute/samples/V1/WireGroupsClient/list.php b/Compute/samples/V1/WireGroupsClient/list.php new file mode 100644 index 000000000000..ce792c422fae --- /dev/null +++ b/Compute/samples/V1/WireGroupsClient/list.php @@ -0,0 +1,76 @@ +setCrossSiteNetwork($crossSiteNetwork) + ->setProject($project); + + // Call the API and handle any network failures. + try { + /** @var PagedListResponse $response */ + $response = $wireGroupsClient->list($request); + + foreach ($response as $element) { + printf('Element data: %s' . PHP_EOL, $element->serializeToJsonString()); + } + } catch (ApiException $ex) { + printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage()); + } +} + +/** + * Helper to execute the sample. + * + * This sample has been automatically generated and should be regarded as a code + * template only. It will require modifications to work: + * - It may require correct/in-range values for request initialization. + * - It may require specifying regional endpoints when creating the service client, + * please see the apiEndpoint client configuration option for more details. + */ +function callSample(): void +{ + $crossSiteNetwork = '[CROSS_SITE_NETWORK]'; + $project = '[PROJECT]'; + + list_sample($crossSiteNetwork, $project); +} +// [END compute_v1_generated_WireGroups_List_sync] diff --git a/Compute/samples/V1/WireGroupsClient/patch.php b/Compute/samples/V1/WireGroupsClient/patch.php new file mode 100644 index 000000000000..e583726486c5 --- /dev/null +++ b/Compute/samples/V1/WireGroupsClient/patch.php @@ -0,0 +1,91 @@ +setCrossSiteNetwork($crossSiteNetwork) + ->setProject($project) + ->setWireGroup($wireGroup) + ->setWireGroupResource($wireGroupResource); + + // Call the API and handle any network failures. + try { + /** @var OperationResponse $response */ + $response = $wireGroupsClient->patch($request); + $response->pollUntilComplete(); + + if ($response->operationSucceeded()) { + printf('Operation completed successfully.' . PHP_EOL); + } else { + /** @var Status $error */ + $error = $response->getError(); + printf('Operation failed with error data: %s' . PHP_EOL, $error->serializeToJsonString()); + } + } catch (ApiException $ex) { + printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage()); + } +} + +/** + * Helper to execute the sample. + * + * This sample has been automatically generated and should be regarded as a code + * template only. It will require modifications to work: + * - It may require correct/in-range values for request initialization. + * - It may require specifying regional endpoints when creating the service client, + * please see the apiEndpoint client configuration option for more details. + */ +function callSample(): void +{ + $crossSiteNetwork = '[CROSS_SITE_NETWORK]'; + $project = '[PROJECT]'; + $wireGroup = '[WIRE_GROUP]'; + + patch_sample($crossSiteNetwork, $project, $wireGroup); +} +// [END compute_v1_generated_WireGroups_Patch_sync] diff --git a/Compute/samples/V1/ZoneOperationsClient/delete.php b/Compute/samples/V1/ZoneOperationsClient/delete.php index 19c460904c55..9a3bb00e4a4a 100644 --- a/Compute/samples/V1/ZoneOperationsClient/delete.php +++ b/Compute/samples/V1/ZoneOperationsClient/delete.php @@ -31,7 +31,8 @@ /** * Deletes the specified zone-specific Operations resource. * - * @param string $operation Name of the Operations resource to delete, or its unique numeric identifier. + * @param string $operation Name of the Operations resource to delete, or its unique numeric + * identifier. * @param string $project Project ID for this request. * @param string $zone Name of the zone for this request. */ diff --git a/Compute/samples/V1/ZoneOperationsClient/get.php b/Compute/samples/V1/ZoneOperationsClient/get.php index 19a1edcf7c02..77098b533d02 100644 --- a/Compute/samples/V1/ZoneOperationsClient/get.php +++ b/Compute/samples/V1/ZoneOperationsClient/get.php @@ -31,7 +31,8 @@ /** * Retrieves the specified zone-specific Operations resource. * - * @param string $operation Name of the Operations resource to return, or its unique numeric identifier. + * @param string $operation Name of the Operations resource to return, or its unique numeric + * identifier. * @param string $project Project ID for this request. * @param string $zone Name of the zone for this request. */ diff --git a/Compute/samples/V1/ZoneOperationsClient/list.php b/Compute/samples/V1/ZoneOperationsClient/list.php index 8a84b18e870b..12d4ad73c25e 100644 --- a/Compute/samples/V1/ZoneOperationsClient/list.php +++ b/Compute/samples/V1/ZoneOperationsClient/list.php @@ -29,7 +29,8 @@ use Google\Cloud\Compute\V1\ListZoneOperationsRequest; /** - * Retrieves a list of Operation resources contained within the specified zone. + * Retrieves a list of Operation resources contained within + * the specified zone. * * @param string $project Project ID for this request. * @param string $zone Name of the zone for request. diff --git a/Compute/samples/V1/ZoneOperationsClient/wait.php b/Compute/samples/V1/ZoneOperationsClient/wait.php index 2d1c6feddb79..3b6cb7888952 100644 --- a/Compute/samples/V1/ZoneOperationsClient/wait.php +++ b/Compute/samples/V1/ZoneOperationsClient/wait.php @@ -29,9 +29,24 @@ use Google\Cloud\Compute\V1\WaitZoneOperationRequest; /** - * Waits for the specified Operation resource to return as `DONE` or for the request to approach the 2 minute deadline, and retrieves the specified Operation resource. This method waits for no more than the 2 minutes and then returns the current state of the operation, which might be `DONE` or still in progress. This method is called on a best-effort basis. Specifically: - In uncommon cases, when the server is overloaded, the request might return before the default deadline is reached, or might return after zero seconds. - If the default deadline is reached, there is no guarantee that the operation is actually done when the method returns. Be prepared to retry if the operation is not `DONE`. + * Waits for the specified Operation resource to return as `DONE` + * or for the request to approach the 2 minute deadline, and retrieves the + * specified Operation resource. This method waits for no more than the + * 2 minutes and then returns the current state of the + * operation, which might be `DONE` or still in progress. * - * @param string $operation Name of the Operations resource to return, or its unique numeric identifier. + * This method is called on a best-effort basis. Specifically: + * + * + * - In uncommon cases, when the server is overloaded, the request might + * return before the default deadline is reached, or might return after zero + * seconds. + * - If the default deadline is reached, there is no guarantee that the + * operation is actually done when the method returns. Be prepared to retry + * if the operation is not `DONE`. + * + * @param string $operation Name of the Operations resource to return, or its unique numeric + * identifier. * @param string $project Project ID for this request. * @param string $zone Name of the zone for this request. */ diff --git a/Compute/src/V1/AWSV4Signature.php b/Compute/src/V1/AWSV4Signature.php index cf620347465c..a9fcc6d7cb12 100644 --- a/Compute/src/V1/AWSV4Signature.php +++ b/Compute/src/V1/AWSV4Signature.php @@ -10,14 +10,21 @@ /** * Messages - * Contains the configurations necessary to generate a signature for access to private storage buckets that support Signature Version 4 for authentication. The service name for generating the authentication header will always default to 's3'. + * Contains the configurations necessary to generate a signature for access to + * private storage buckets that support Signature Version 4 for authentication. + * The service name for generating the authentication header will always default + * to 's3'. * * Generated from protobuf message google.cloud.compute.v1.AWSV4Signature */ class AWSV4Signature extends \Google\Protobuf\Internal\Message { /** - * The access key used for s3 bucket authentication. Required for updating or creating a backend that uses AWS v4 signature authentication, but will not be returned as part of the configuration when queried with a REST API GET request. @InputOnly + * The access key used for s3 bucket authentication. Required for updating or + * creating a backend that uses AWS v4 signature authentication, but will not + * be returned as part of the configuration when queried with a REST API GET + * request. + * @InputOnly * * Generated from protobuf field optional string access_key = 468922628; */ @@ -29,13 +36,16 @@ class AWSV4Signature extends \Google\Protobuf\Internal\Message */ protected $access_key_id = null; /** - * The optional version identifier for the access key. You can use this to keep track of different iterations of your access key. + * The optional version identifier for the access key. You can use this to + * keep track of different iterations of your access key. * * Generated from protobuf field optional string access_key_version = 80261277; */ protected $access_key_version = null; /** - * The name of the cloud region of your origin. This is a free-form field with the name of the region your cloud uses to host your origin. For example, "us-east-1" for AWS or "us-ashburn-1" for OCI. + * The name of the cloud region of your origin. This is a free-form field with + * the name of the region your cloud uses to host your origin. For example, + * "us-east-1" for AWS or "us-ashburn-1" for OCI. * * Generated from protobuf field optional string origin_region = 265305645; */ @@ -48,13 +58,20 @@ class AWSV4Signature extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $access_key - * The access key used for s3 bucket authentication. Required for updating or creating a backend that uses AWS v4 signature authentication, but will not be returned as part of the configuration when queried with a REST API GET request. @InputOnly + * The access key used for s3 bucket authentication. Required for updating or + * creating a backend that uses AWS v4 signature authentication, but will not + * be returned as part of the configuration when queried with a REST API GET + * request. + * @InputOnly * @type string $access_key_id * The identifier of an access key used for s3 bucket authentication. * @type string $access_key_version - * The optional version identifier for the access key. You can use this to keep track of different iterations of your access key. + * The optional version identifier for the access key. You can use this to + * keep track of different iterations of your access key. * @type string $origin_region - * The name of the cloud region of your origin. This is a free-form field with the name of the region your cloud uses to host your origin. For example, "us-east-1" for AWS or "us-ashburn-1" for OCI. + * The name of the cloud region of your origin. This is a free-form field with + * the name of the region your cloud uses to host your origin. For example, + * "us-east-1" for AWS or "us-ashburn-1" for OCI. * } */ public function __construct($data = NULL) { @@ -63,7 +80,11 @@ public function __construct($data = NULL) { } /** - * The access key used for s3 bucket authentication. Required for updating or creating a backend that uses AWS v4 signature authentication, but will not be returned as part of the configuration when queried with a REST API GET request. @InputOnly + * The access key used for s3 bucket authentication. Required for updating or + * creating a backend that uses AWS v4 signature authentication, but will not + * be returned as part of the configuration when queried with a REST API GET + * request. + * @InputOnly * * Generated from protobuf field optional string access_key = 468922628; * @return string @@ -84,7 +105,11 @@ public function clearAccessKey() } /** - * The access key used for s3 bucket authentication. Required for updating or creating a backend that uses AWS v4 signature authentication, but will not be returned as part of the configuration when queried with a REST API GET request. @InputOnly + * The access key used for s3 bucket authentication. Required for updating or + * creating a backend that uses AWS v4 signature authentication, but will not + * be returned as part of the configuration when queried with a REST API GET + * request. + * @InputOnly * * Generated from protobuf field optional string access_key = 468922628; * @param string $var @@ -135,7 +160,8 @@ public function setAccessKeyId($var) } /** - * The optional version identifier for the access key. You can use this to keep track of different iterations of your access key. + * The optional version identifier for the access key. You can use this to + * keep track of different iterations of your access key. * * Generated from protobuf field optional string access_key_version = 80261277; * @return string @@ -156,7 +182,8 @@ public function clearAccessKeyVersion() } /** - * The optional version identifier for the access key. You can use this to keep track of different iterations of your access key. + * The optional version identifier for the access key. You can use this to + * keep track of different iterations of your access key. * * Generated from protobuf field optional string access_key_version = 80261277; * @param string $var @@ -171,7 +198,9 @@ public function setAccessKeyVersion($var) } /** - * The name of the cloud region of your origin. This is a free-form field with the name of the region your cloud uses to host your origin. For example, "us-east-1" for AWS or "us-ashburn-1" for OCI. + * The name of the cloud region of your origin. This is a free-form field with + * the name of the region your cloud uses to host your origin. For example, + * "us-east-1" for AWS or "us-ashburn-1" for OCI. * * Generated from protobuf field optional string origin_region = 265305645; * @return string @@ -192,7 +221,9 @@ public function clearOriginRegion() } /** - * The name of the cloud region of your origin. This is a free-form field with the name of the region your cloud uses to host your origin. For example, "us-east-1" for AWS or "us-ashburn-1" for OCI. + * The name of the cloud region of your origin. This is a free-form field with + * the name of the region your cloud uses to host your origin. For example, + * "us-east-1" for AWS or "us-ashburn-1" for OCI. * * Generated from protobuf field optional string origin_region = 265305645; * @param string $var diff --git a/Compute/src/V1/AbandonInstancesInstanceGroupManagerRequest.php b/Compute/src/V1/AbandonInstancesInstanceGroupManagerRequest.php index e4fb4fadf755..2173e6f4f97a 100644 --- a/Compute/src/V1/AbandonInstancesInstanceGroupManagerRequest.php +++ b/Compute/src/V1/AbandonInstancesInstanceGroupManagerRequest.php @@ -34,13 +34,24 @@ class AbandonInstancesInstanceGroupManagerRequest extends \Google\Protobuf\Inter */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ protected $request_id = null; /** - * The name of the zone where the managed instance group is located. + * The name of thezone where the managed + * instance group is located. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; */ @@ -48,7 +59,8 @@ class AbandonInstancesInstanceGroupManagerRequest extends \Google\Protobuf\Inter /** * @param string $project Project ID for this request. - * @param string $zone The name of the zone where the managed instance group is located. + * @param string $zone The name of thezone where the managed + * instance group is located. * @param string $instanceGroupManager The name of the managed instance group. * @param \Google\Cloud\Compute\V1\InstanceGroupManagersAbandonInstancesRequest $instanceGroupManagersAbandonInstancesRequestResource The body resource for this request * @@ -78,9 +90,20 @@ public static function build(string $project, string $zone, string $instanceGrou * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $zone - * The name of the zone where the managed instance group is located. + * The name of thezone where the managed + * instance group is located. * } */ public function __construct($data = NULL) { @@ -177,7 +200,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -198,7 +231,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var @@ -213,7 +256,8 @@ public function setRequestId($var) } /** - * The name of the zone where the managed instance group is located. + * The name of thezone where the managed + * instance group is located. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; * @return string @@ -224,7 +268,8 @@ public function getZone() } /** - * The name of the zone where the managed instance group is located. + * The name of thezone where the managed + * instance group is located. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; * @param string $var diff --git a/Compute/src/V1/AbandonInstancesRegionInstanceGroupManagerRequest.php b/Compute/src/V1/AbandonInstancesRegionInstanceGroupManagerRequest.php index ada15c902ddb..641a9f2abe97 100644 --- a/Compute/src/V1/AbandonInstancesRegionInstanceGroupManagerRequest.php +++ b/Compute/src/V1/AbandonInstancesRegionInstanceGroupManagerRequest.php @@ -40,7 +40,17 @@ class AbandonInstancesRegionInstanceGroupManagerRequest extends \Google\Protobuf */ protected $region_instance_group_managers_abandon_instances_request_resource = null; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -80,7 +90,17 @@ public static function build(string $project, string $region, string $instanceGr * @type \Google\Cloud\Compute\V1\RegionInstanceGroupManagersAbandonInstancesRequest $region_instance_group_managers_abandon_instances_request_resource * The body resource for this request * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -203,7 +223,17 @@ public function setRegionInstanceGroupManagersAbandonInstancesRequestResource($v } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -224,7 +254,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/AcceleratorConfig.php b/Compute/src/V1/AcceleratorConfig.php index f54b2d3d8f09..97f3c0e919b5 100644 --- a/Compute/src/V1/AcceleratorConfig.php +++ b/Compute/src/V1/AcceleratorConfig.php @@ -9,7 +9,8 @@ use Google\Protobuf\Internal\GPBUtil; /** - * A specification of the type and number of accelerator cards attached to the instance. + * A specification of the type and number of accelerator cards attached to the + * instance. * * Generated from protobuf message google.cloud.compute.v1.AcceleratorConfig */ @@ -22,7 +23,12 @@ class AcceleratorConfig extends \Google\Protobuf\Internal\Message */ protected $accelerator_count = null; /** - * Full or partial URL of the accelerator type resource to attach to this instance. For example: projects/my-project/zones/us-central1-c/acceleratorTypes/nvidia-tesla-p100 If you are creating an instance template, specify only the accelerator name. See GPUs on Compute Engine for a full list of accelerator types. + * Full or partial URL of the accelerator type resource to attach to this + * instance. For example:projects/my-project/zones/us-central1-c/acceleratorTypes/nvidia-tesla-p100 + * If you are creating an instance template, specify only the + * accelerator name. + * See GPUs on Compute Engine + * for a full list of accelerator types. * * Generated from protobuf field optional string accelerator_type = 138031246; */ @@ -37,7 +43,12 @@ class AcceleratorConfig extends \Google\Protobuf\Internal\Message * @type int $accelerator_count * The number of the guest accelerator cards exposed to this instance. * @type string $accelerator_type - * Full or partial URL of the accelerator type resource to attach to this instance. For example: projects/my-project/zones/us-central1-c/acceleratorTypes/nvidia-tesla-p100 If you are creating an instance template, specify only the accelerator name. See GPUs on Compute Engine for a full list of accelerator types. + * Full or partial URL of the accelerator type resource to attach to this + * instance. For example:projects/my-project/zones/us-central1-c/acceleratorTypes/nvidia-tesla-p100 + * If you are creating an instance template, specify only the + * accelerator name. + * See GPUs on Compute Engine + * for a full list of accelerator types. * } */ public function __construct($data = NULL) { @@ -82,7 +93,12 @@ public function setAcceleratorCount($var) } /** - * Full or partial URL of the accelerator type resource to attach to this instance. For example: projects/my-project/zones/us-central1-c/acceleratorTypes/nvidia-tesla-p100 If you are creating an instance template, specify only the accelerator name. See GPUs on Compute Engine for a full list of accelerator types. + * Full or partial URL of the accelerator type resource to attach to this + * instance. For example:projects/my-project/zones/us-central1-c/acceleratorTypes/nvidia-tesla-p100 + * If you are creating an instance template, specify only the + * accelerator name. + * See GPUs on Compute Engine + * for a full list of accelerator types. * * Generated from protobuf field optional string accelerator_type = 138031246; * @return string @@ -103,7 +119,12 @@ public function clearAcceleratorType() } /** - * Full or partial URL of the accelerator type resource to attach to this instance. For example: projects/my-project/zones/us-central1-c/acceleratorTypes/nvidia-tesla-p100 If you are creating an instance template, specify only the accelerator name. See GPUs on Compute Engine for a full list of accelerator types. + * Full or partial URL of the accelerator type resource to attach to this + * instance. For example:projects/my-project/zones/us-central1-c/acceleratorTypes/nvidia-tesla-p100 + * If you are creating an instance template, specify only the + * accelerator name. + * See GPUs on Compute Engine + * for a full list of accelerator types. * * Generated from protobuf field optional string accelerator_type = 138031246; * @param string $var diff --git a/Compute/src/V1/AcceleratorTopologiesInfo.php b/Compute/src/V1/AcceleratorTopologiesInfo.php new file mode 100644 index 000000000000..bdbddcfd483e --- /dev/null +++ b/Compute/src/V1/AcceleratorTopologiesInfo.php @@ -0,0 +1,67 @@ +google.cloud.compute.v1.AcceleratorTopologiesInfo + */ +class AcceleratorTopologiesInfo extends \Google\Protobuf\Internal\Message +{ + /** + * Info for each accelerator topology. + * + * Generated from protobuf field repeated .google.cloud.compute.v1.AcceleratorTopologiesInfoAcceleratorTopologyInfo accelerator_topology_infos = 219451401; + */ + private $accelerator_topology_infos; + + /** + * Constructor. + * + * @param array $data { + * Optional. Data for populating the Message object. + * + * @type array<\Google\Cloud\Compute\V1\AcceleratorTopologiesInfoAcceleratorTopologyInfo>|\Google\Protobuf\Internal\RepeatedField $accelerator_topology_infos + * Info for each accelerator topology. + * } + */ + public function __construct($data = NULL) { + \GPBMetadata\Google\Cloud\Compute\V1\Compute::initOnce(); + parent::__construct($data); + } + + /** + * Info for each accelerator topology. + * + * Generated from protobuf field repeated .google.cloud.compute.v1.AcceleratorTopologiesInfoAcceleratorTopologyInfo accelerator_topology_infos = 219451401; + * @return \Google\Protobuf\Internal\RepeatedField + */ + public function getAcceleratorTopologyInfos() + { + return $this->accelerator_topology_infos; + } + + /** + * Info for each accelerator topology. + * + * Generated from protobuf field repeated .google.cloud.compute.v1.AcceleratorTopologiesInfoAcceleratorTopologyInfo accelerator_topology_infos = 219451401; + * @param array<\Google\Cloud\Compute\V1\AcceleratorTopologiesInfoAcceleratorTopologyInfo>|\Google\Protobuf\Internal\RepeatedField $var + * @return $this + */ + public function setAcceleratorTopologyInfos($var) + { + $arr = GPBUtil::checkRepeatedField($var, \Google\Protobuf\Internal\GPBType::MESSAGE, \Google\Cloud\Compute\V1\AcceleratorTopologiesInfoAcceleratorTopologyInfo::class); + $this->accelerator_topology_infos = $arr; + + return $this; + } + +} + diff --git a/Compute/src/V1/AcceleratorTopologiesInfoAcceleratorTopologyInfo.php b/Compute/src/V1/AcceleratorTopologiesInfoAcceleratorTopologyInfo.php new file mode 100644 index 000000000000..742fd8ef8175 --- /dev/null +++ b/Compute/src/V1/AcceleratorTopologiesInfoAcceleratorTopologyInfo.php @@ -0,0 +1,111 @@ +google.cloud.compute.v1.AcceleratorTopologiesInfoAcceleratorTopologyInfo + */ +class AcceleratorTopologiesInfoAcceleratorTopologyInfo extends \Google\Protobuf\Internal\Message +{ + /** + * The accelerator topology. + * + * Generated from protobuf field optional string accelerator_topology = 389323203; + */ + protected $accelerator_topology = null; + /** + * Info for each topology state. + * + * Generated from protobuf field repeated .google.cloud.compute.v1.AcceleratorTopologiesInfoAcceleratorTopologyInfoInfoPerTopologyState info_per_topology_states = 183777695; + */ + private $info_per_topology_states; + + /** + * Constructor. + * + * @param array $data { + * Optional. Data for populating the Message object. + * + * @type string $accelerator_topology + * The accelerator topology. + * @type array<\Google\Cloud\Compute\V1\AcceleratorTopologiesInfoAcceleratorTopologyInfoInfoPerTopologyState>|\Google\Protobuf\Internal\RepeatedField $info_per_topology_states + * Info for each topology state. + * } + */ + public function __construct($data = NULL) { + \GPBMetadata\Google\Cloud\Compute\V1\Compute::initOnce(); + parent::__construct($data); + } + + /** + * The accelerator topology. + * + * Generated from protobuf field optional string accelerator_topology = 389323203; + * @return string + */ + public function getAcceleratorTopology() + { + return isset($this->accelerator_topology) ? $this->accelerator_topology : ''; + } + + public function hasAcceleratorTopology() + { + return isset($this->accelerator_topology); + } + + public function clearAcceleratorTopology() + { + unset($this->accelerator_topology); + } + + /** + * The accelerator topology. + * + * Generated from protobuf field optional string accelerator_topology = 389323203; + * @param string $var + * @return $this + */ + public function setAcceleratorTopology($var) + { + GPBUtil::checkString($var, True); + $this->accelerator_topology = $var; + + return $this; + } + + /** + * Info for each topology state. + * + * Generated from protobuf field repeated .google.cloud.compute.v1.AcceleratorTopologiesInfoAcceleratorTopologyInfoInfoPerTopologyState info_per_topology_states = 183777695; + * @return \Google\Protobuf\Internal\RepeatedField + */ + public function getInfoPerTopologyStates() + { + return $this->info_per_topology_states; + } + + /** + * Info for each topology state. + * + * Generated from protobuf field repeated .google.cloud.compute.v1.AcceleratorTopologiesInfoAcceleratorTopologyInfoInfoPerTopologyState info_per_topology_states = 183777695; + * @param array<\Google\Cloud\Compute\V1\AcceleratorTopologiesInfoAcceleratorTopologyInfoInfoPerTopologyState>|\Google\Protobuf\Internal\RepeatedField $var + * @return $this + */ + public function setInfoPerTopologyStates($var) + { + $arr = GPBUtil::checkRepeatedField($var, \Google\Protobuf\Internal\GPBType::MESSAGE, \Google\Cloud\Compute\V1\AcceleratorTopologiesInfoAcceleratorTopologyInfoInfoPerTopologyState::class); + $this->info_per_topology_states = $arr; + + return $this; + } + +} + diff --git a/Compute/src/V1/AcceleratorTopologiesInfoAcceleratorTopologyInfoInfoPerTopologyState.php b/Compute/src/V1/AcceleratorTopologiesInfoAcceleratorTopologyInfoInfoPerTopologyState.php new file mode 100644 index 000000000000..8cc3c7e811c7 --- /dev/null +++ b/Compute/src/V1/AcceleratorTopologiesInfoAcceleratorTopologyInfoInfoPerTopologyState.php @@ -0,0 +1,125 @@ +google.cloud.compute.v1.AcceleratorTopologiesInfoAcceleratorTopologyInfoInfoPerTopologyState + */ +class AcceleratorTopologiesInfoAcceleratorTopologyInfoInfoPerTopologyState extends \Google\Protobuf\Internal\Message +{ + /** + * The number of accelerator topologies in this state. + * + * Generated from protobuf field optional int32 count = 94851343; + */ + protected $count = null; + /** + * The state of the accelerator topology. + * Check the State enum for the list of possible values. + * + * Generated from protobuf field optional string state = 109757585; + */ + protected $state = null; + + /** + * Constructor. + * + * @param array $data { + * Optional. Data for populating the Message object. + * + * @type int $count + * The number of accelerator topologies in this state. + * @type string $state + * The state of the accelerator topology. + * Check the State enum for the list of possible values. + * } + */ + public function __construct($data = NULL) { + \GPBMetadata\Google\Cloud\Compute\V1\Compute::initOnce(); + parent::__construct($data); + } + + /** + * The number of accelerator topologies in this state. + * + * Generated from protobuf field optional int32 count = 94851343; + * @return int + */ + public function getCount() + { + return isset($this->count) ? $this->count : 0; + } + + public function hasCount() + { + return isset($this->count); + } + + public function clearCount() + { + unset($this->count); + } + + /** + * The number of accelerator topologies in this state. + * + * Generated from protobuf field optional int32 count = 94851343; + * @param int $var + * @return $this + */ + public function setCount($var) + { + GPBUtil::checkInt32($var); + $this->count = $var; + + return $this; + } + + /** + * The state of the accelerator topology. + * Check the State enum for the list of possible values. + * + * Generated from protobuf field optional string state = 109757585; + * @return string + */ + public function getState() + { + return isset($this->state) ? $this->state : ''; + } + + public function hasState() + { + return isset($this->state); + } + + public function clearState() + { + unset($this->state); + } + + /** + * The state of the accelerator topology. + * Check the State enum for the list of possible values. + * + * Generated from protobuf field optional string state = 109757585; + * @param string $var + * @return $this + */ + public function setState($var) + { + GPBUtil::checkString($var, True); + $this->state = $var; + + return $this; + } + +} + diff --git a/Compute/src/V1/AcceleratorTopologiesInfoAcceleratorTopologyInfoInfoPerTopologyState/State.php b/Compute/src/V1/AcceleratorTopologiesInfoAcceleratorTopologyInfoInfoPerTopologyState/State.php new file mode 100644 index 000000000000..0ec28ba6be6b --- /dev/null +++ b/Compute/src/V1/AcceleratorTopologiesInfoAcceleratorTopologyInfoInfoPerTopologyState/State.php @@ -0,0 +1,76 @@ +google.cloud.compute.v1.AcceleratorTopologiesInfoAcceleratorTopologyInfoInfoPerTopologyState.State + */ +class State +{ + /** + * A value indicating that the enum field is not set. + * + * Generated from protobuf enum UNDEFINED_STATE = 0; + */ + const UNDEFINED_STATE = 0; + /** + * The accelerator topology is available. + * + * Generated from protobuf enum AVAILABLE = 442079913; + */ + const AVAILABLE = 442079913; + /** + * The accelerator topology is running. + * + * Generated from protobuf enum RUNNING = 121282975; + */ + const RUNNING = 121282975; + /** + * The state of the topology is unspecified. + * + * Generated from protobuf enum TOPOLOGY_STATE_UNSPECIFIED = 188327545; + */ + const TOPOLOGY_STATE_UNSPECIFIED = 188327545; + /** + * The accelerator topology is unhealthy. + * + * Generated from protobuf enum UNHEALTHY = 462118084; + */ + const UNHEALTHY = 462118084; + + private static $valueToName = [ + self::UNDEFINED_STATE => 'UNDEFINED_STATE', + self::AVAILABLE => 'AVAILABLE', + self::RUNNING => 'RUNNING', + self::TOPOLOGY_STATE_UNSPECIFIED => 'TOPOLOGY_STATE_UNSPECIFIED', + self::UNHEALTHY => 'UNHEALTHY', + ]; + + public static function name($value) + { + if (!isset(self::$valueToName[$value])) { + throw new UnexpectedValueException(sprintf( + 'Enum %s has no name defined for value %s', __CLASS__, $value)); + } + return self::$valueToName[$value]; + } + + + public static function value($name) + { + $const = __CLASS__ . '::' . strtoupper($name); + if (!defined($const)) { + throw new UnexpectedValueException(sprintf( + 'Enum %s has no value defined for name %s', __CLASS__, $name)); + } + return constant($const); + } +} + + diff --git a/Compute/src/V1/AcceleratorType.php b/Compute/src/V1/AcceleratorType.php index fc39ab2d1fb0..3c42f4d65391 100644 --- a/Compute/src/V1/AcceleratorType.php +++ b/Compute/src/V1/AcceleratorType.php @@ -9,14 +9,17 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Represents an Accelerator Type resource. Google Cloud Platform provides graphics processing units (accelerators) that you can add to VM instances to improve or accelerate performance when working with intensive workloads. For more information, read GPUs on Compute Engine. + * Represents an Accelerator Type resource. + * Google Cloud Platform provides graphics processing units (accelerators) that + * you can add to VM instances to improve or accelerate performance when working + * with intensive workloads. For more information, readGPUs on Compute Engine. * * Generated from protobuf message google.cloud.compute.v1.AcceleratorType */ class AcceleratorType extends \Google\Protobuf\Internal\Message { /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; */ @@ -34,13 +37,14 @@ class AcceleratorType extends \Google\Protobuf\Internal\Message */ protected $description = null; /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; */ protected $id = null; /** - * [Output Only] The type of the resource. Always compute#acceleratorType for accelerator types. + * [Output Only] The type of the resource. Alwayscompute#acceleratorType for accelerator types. * * Generated from protobuf field optional string kind = 3292052; */ @@ -64,7 +68,10 @@ class AcceleratorType extends \Google\Protobuf\Internal\Message */ protected $self_link = null; /** - * [Output Only] The name of the zone where the accelerator type resides, such as us-central1-a. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * [Output Only] The name of the zone where the accelerator type resides, + * such as us-central1-a. + * You must specify this field as part of the HTTP request URL. It is + * not settable as a field in the request body. * * Generated from protobuf field optional string zone = 3744684; */ @@ -77,15 +84,16 @@ class AcceleratorType extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $creation_timestamp - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 text format. * @type \Google\Cloud\Compute\V1\DeprecationStatus $deprecated * [Output Only] The deprecation status associated with this accelerator type. * @type string $description * [Output Only] An optional textual description of the resource. * @type int|string $id - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * @type string $kind - * [Output Only] The type of the resource. Always compute#acceleratorType for accelerator types. + * [Output Only] The type of the resource. Alwayscompute#acceleratorType for accelerator types. * @type int $maximum_cards_per_instance * [Output Only] Maximum number of accelerator cards allowed per instance. * @type string $name @@ -93,7 +101,10 @@ class AcceleratorType extends \Google\Protobuf\Internal\Message * @type string $self_link * [Output Only] Server-defined, fully qualified URL for this resource. * @type string $zone - * [Output Only] The name of the zone where the accelerator type resides, such as us-central1-a. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * [Output Only] The name of the zone where the accelerator type resides, + * such as us-central1-a. + * You must specify this field as part of the HTTP request URL. It is + * not settable as a field in the request body. * } */ public function __construct($data = NULL) { @@ -102,7 +113,7 @@ public function __construct($data = NULL) { } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @return string @@ -123,7 +134,7 @@ public function clearCreationTimestamp() } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @param string $var @@ -210,7 +221,8 @@ public function setDescription($var) } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @return int|string @@ -231,7 +243,8 @@ public function clearId() } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @param int|string $var @@ -246,7 +259,7 @@ public function setId($var) } /** - * [Output Only] The type of the resource. Always compute#acceleratorType for accelerator types. + * [Output Only] The type of the resource. Alwayscompute#acceleratorType for accelerator types. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -267,7 +280,7 @@ public function clearKind() } /** - * [Output Only] The type of the resource. Always compute#acceleratorType for accelerator types. + * [Output Only] The type of the resource. Alwayscompute#acceleratorType for accelerator types. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -390,7 +403,10 @@ public function setSelfLink($var) } /** - * [Output Only] The name of the zone where the accelerator type resides, such as us-central1-a. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * [Output Only] The name of the zone where the accelerator type resides, + * such as us-central1-a. + * You must specify this field as part of the HTTP request URL. It is + * not settable as a field in the request body. * * Generated from protobuf field optional string zone = 3744684; * @return string @@ -411,7 +427,10 @@ public function clearZone() } /** - * [Output Only] The name of the zone where the accelerator type resides, such as us-central1-a. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * [Output Only] The name of the zone where the accelerator type resides, + * such as us-central1-a. + * You must specify this field as part of the HTTP request URL. It is + * not settable as a field in the request body. * * Generated from protobuf field optional string zone = 3744684; * @param string $var diff --git a/Compute/src/V1/AcceleratorTypeAggregatedList.php b/Compute/src/V1/AcceleratorTypeAggregatedList.php index b93dc3d9a1ae..100071cb185e 100644 --- a/Compute/src/V1/AcceleratorTypeAggregatedList.php +++ b/Compute/src/V1/AcceleratorTypeAggregatedList.php @@ -27,13 +27,18 @@ class AcceleratorTypeAggregatedList extends \Google\Protobuf\Internal\Message */ private $items; /** - * [Output Only] Type of resource. Always compute#acceleratorTypeAggregatedList for aggregated lists of accelerator types. + * [Output Only] Type of resource. Alwayscompute#acceleratorTypeAggregatedList for aggregated lists of + * accelerator types. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -68,9 +73,14 @@ class AcceleratorTypeAggregatedList extends \Google\Protobuf\Internal\Message * @type array|\Google\Protobuf\Internal\MapField $items * A list of AcceleratorTypesScopedList resources. * @type string $kind - * [Output Only] Type of resource. Always compute#acceleratorTypeAggregatedList for aggregated lists of accelerator types. + * [Output Only] Type of resource. Alwayscompute#acceleratorTypeAggregatedList for aggregated lists of + * accelerator types. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type array|\Google\Protobuf\Internal\RepeatedField $unreachables @@ -147,7 +157,8 @@ public function setItems($var) } /** - * [Output Only] Type of resource. Always compute#acceleratorTypeAggregatedList for aggregated lists of accelerator types. + * [Output Only] Type of resource. Alwayscompute#acceleratorTypeAggregatedList for aggregated lists of + * accelerator types. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -168,7 +179,8 @@ public function clearKind() } /** - * [Output Only] Type of resource. Always compute#acceleratorTypeAggregatedList for aggregated lists of accelerator types. + * [Output Only] Type of resource. Alwayscompute#acceleratorTypeAggregatedList for aggregated lists of + * accelerator types. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -183,7 +195,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -204,7 +220,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/AcceleratorTypeList.php b/Compute/src/V1/AcceleratorTypeList.php index bc85350a2c8a..81d69b40d1f0 100644 --- a/Compute/src/V1/AcceleratorTypeList.php +++ b/Compute/src/V1/AcceleratorTypeList.php @@ -28,13 +28,17 @@ class AcceleratorTypeList extends \Google\Protobuf\Internal\Message */ private $items; /** - * [Output Only] Type of resource. Always compute#acceleratorTypeList for lists of accelerator types. + * [Output Only] Type of resource. Alwayscompute#acceleratorTypeList for lists of accelerator types. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -63,9 +67,13 @@ class AcceleratorTypeList extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\AcceleratorType>|\Google\Protobuf\Internal\RepeatedField $items * A list of AcceleratorType resources. * @type string $kind - * [Output Only] Type of resource. Always compute#acceleratorTypeList for lists of accelerator types. + * [Output Only] Type of resource. Alwayscompute#acceleratorTypeList for lists of accelerator types. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type \Google\Cloud\Compute\V1\Warning $warning @@ -140,7 +148,7 @@ public function setItems($var) } /** - * [Output Only] Type of resource. Always compute#acceleratorTypeList for lists of accelerator types. + * [Output Only] Type of resource. Alwayscompute#acceleratorTypeList for lists of accelerator types. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -161,7 +169,7 @@ public function clearKind() } /** - * [Output Only] Type of resource. Always compute#acceleratorTypeList for lists of accelerator types. + * [Output Only] Type of resource. Alwayscompute#acceleratorTypeList for lists of accelerator types. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -176,7 +184,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -197,7 +209,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/AcceleratorTypesScopedList.php b/Compute/src/V1/AcceleratorTypesScopedList.php index ab3525e88596..01e29651fbf1 100644 --- a/Compute/src/V1/AcceleratorTypesScopedList.php +++ b/Compute/src/V1/AcceleratorTypesScopedList.php @@ -21,7 +21,8 @@ class AcceleratorTypesScopedList extends \Google\Protobuf\Internal\Message */ private $accelerator_types; /** - * [Output Only] An informational warning that appears when the accelerator types list is empty. + * [Output Only] An informational warning that appears when the accelerator + * types list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; */ @@ -36,7 +37,8 @@ class AcceleratorTypesScopedList extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\AcceleratorType>|\Google\Protobuf\Internal\RepeatedField $accelerator_types * [Output Only] A list of accelerator types contained in this scope. * @type \Google\Cloud\Compute\V1\Warning $warning - * [Output Only] An informational warning that appears when the accelerator types list is empty. + * [Output Only] An informational warning that appears when the accelerator + * types list is empty. * } */ public function __construct($data = NULL) { @@ -71,7 +73,8 @@ public function setAcceleratorTypes($var) } /** - * [Output Only] An informational warning that appears when the accelerator types list is empty. + * [Output Only] An informational warning that appears when the accelerator + * types list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; * @return \Google\Cloud\Compute\V1\Warning|null @@ -92,7 +95,8 @@ public function clearWarning() } /** - * [Output Only] An informational warning that appears when the accelerator types list is empty. + * [Output Only] An informational warning that appears when the accelerator + * types list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; * @param \Google\Cloud\Compute\V1\Warning $var diff --git a/Compute/src/V1/Accelerators.php b/Compute/src/V1/Accelerators.php index d7c8d6d37d00..e24945b0e0ff 100644 --- a/Compute/src/V1/Accelerators.php +++ b/Compute/src/V1/Accelerators.php @@ -21,7 +21,7 @@ class Accelerators extends \Google\Protobuf\Internal\Message */ protected $guest_accelerator_count = null; /** - * The accelerator type resource name, not a full URL, e.g. nvidia-tesla-t4. + * The accelerator type resource name, not a full URL, e.g.nvidia-tesla-t4. * * Generated from protobuf field optional string guest_accelerator_type = 293064725; */ @@ -36,7 +36,7 @@ class Accelerators extends \Google\Protobuf\Internal\Message * @type int $guest_accelerator_count * Number of accelerator cards exposed to the guest. * @type string $guest_accelerator_type - * The accelerator type resource name, not a full URL, e.g. nvidia-tesla-t4. + * The accelerator type resource name, not a full URL, e.g.nvidia-tesla-t4. * } */ public function __construct($data = NULL) { @@ -81,7 +81,7 @@ public function setGuestAcceleratorCount($var) } /** - * The accelerator type resource name, not a full URL, e.g. nvidia-tesla-t4. + * The accelerator type resource name, not a full URL, e.g.nvidia-tesla-t4. * * Generated from protobuf field optional string guest_accelerator_type = 293064725; * @return string @@ -102,7 +102,7 @@ public function clearGuestAcceleratorType() } /** - * The accelerator type resource name, not a full URL, e.g. nvidia-tesla-t4. + * The accelerator type resource name, not a full URL, e.g.nvidia-tesla-t4. * * Generated from protobuf field optional string guest_accelerator_type = 293064725; * @param string $var diff --git a/Compute/src/V1/AccessConfig.php b/Compute/src/V1/AccessConfig.php index 9fe75e709585..828aa073ba2d 100644 --- a/Compute/src/V1/AccessConfig.php +++ b/Compute/src/V1/AccessConfig.php @@ -9,69 +9,97 @@ use Google\Protobuf\Internal\GPBUtil; /** - * An access configuration attached to an instance's network interface. Only one access config per instance is supported. + * An access configuration attached to an instance's network interface. + * Only one access config per instance is supported. * * Generated from protobuf message google.cloud.compute.v1.AccessConfig */ class AccessConfig extends \Google\Protobuf\Internal\Message { /** - * Applies to ipv6AccessConfigs only. The first IPv6 address of the external IPv6 range associated with this instance, prefix length is stored in externalIpv6PrefixLength in ipv6AccessConfig. To use a static external IP address, it must be unused and in the same region as the instance's zone. If not specified, Google Cloud will automatically assign an external IPv6 address from the instance's subnetwork. + * Applies to ipv6AccessConfigs only. + * The first IPv6 address of the external IPv6 range associated + * with this instance, prefix length is stored inexternalIpv6PrefixLength in ipv6AccessConfig. To + * use a static external IP address, it must be unused and in the same region + * as the instance's zone. If not specified, Google Cloud will automatically + * assign an external IPv6 address from the instance's subnetwork. * * Generated from protobuf field optional string external_ipv6 = 532703707; */ protected $external_ipv6 = null; /** - * Applies to ipv6AccessConfigs only. The prefix length of the external IPv6 range. + * Applies to ipv6AccessConfigs only. The prefix length of the + * external IPv6 range. * * Generated from protobuf field optional int32 external_ipv6_prefix_length = 425672143; */ protected $external_ipv6_prefix_length = null; /** - * [Output Only] Type of the resource. Always compute#accessConfig for access configs. + * [Output Only] Type of the resource. Alwayscompute#accessConfig for access configs. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * The name of this access configuration. In accessConfigs (IPv4), the default and recommended name is External NAT, but you can use any arbitrary string, such as My external IP or Network Access. In ipv6AccessConfigs, the recommend name is External IPv6. + * The name of this access configuration. In accessConfigs + * (IPv4), the default and recommended name is External NAT, but + * you can use any arbitrary string, such as My external IP orNetwork Access. In ipv6AccessConfigs, the + * recommend name is External IPv6. * * Generated from protobuf field optional string name = 3373707; */ protected $name = null; /** - * Applies to accessConfigs (IPv4) only. An external IP address associated with this instance. Specify an unused static external IP address available to the project or leave this field undefined to use an IP from a shared ephemeral IP address pool. If you specify a static external IP address, it must live in the same region as the zone of the instance. + * Applies to accessConfigs (IPv4) only. Anexternal IP + * address associated with this instance. Specify an unused static + * external IP address available to the project or leave this field undefined + * to use an IP from a shared ephemeral IP address pool. If you specify a + * static external IP address, it must live in the same region as the zone of + * the instance. * * Generated from protobuf field optional string nat_i_p = 117634556; */ protected $nat_i_p = null; /** - * This signifies the networking tier used for configuring this access configuration and can only take the following values: PREMIUM, STANDARD. If an AccessConfig is specified without a valid external IP address, an ephemeral IP will be created with this networkTier. If an AccessConfig with a valid external IP address is specified, it must match that of the networkTier associated with the Address resource owning that IP. + * This signifies the networking tier used for configuring this access + * configuration and can only take the following values: PREMIUM,STANDARD. + * If an AccessConfig is specified without a valid external IP address, an + * ephemeral IP will be created with this networkTier. + * If an AccessConfig with a valid external IP address is specified, it must + * match that of the networkTier associated with the Address resource owning + * that IP. * Check the NetworkTier enum for the list of possible values. * * Generated from protobuf field optional string network_tier = 517397843; */ protected $network_tier = null; /** - * The DNS domain name for the public PTR record. You can set this field only if the `setPublicPtr` field is enabled in accessConfig. If this field is unspecified in ipv6AccessConfig, a default PTR record will be created for first IP in associated external IPv6 range. + * The DNS domain name for the public PTR record. + * You can set this field only if the `setPublicPtr` field is enabled inaccessConfig. If this field is unspecified inipv6AccessConfig, a default PTR record will be created for + * first IP in associated external IPv6 range. * * Generated from protobuf field optional string public_ptr_domain_name = 316599167; */ protected $public_ptr_domain_name = null; /** - * The resource URL for the security policy associated with this access config. + * The resource URL for the security policy associated with this access + * config. * * Generated from protobuf field optional string security_policy = 171082513; */ protected $security_policy = null; /** - * Specifies whether a public DNS 'PTR' record should be created to map the external IP address of the instance to a DNS domain name. This field is not used in ipv6AccessConfig. A default PTR record will be created if the VM has external IPv6 range associated. + * Specifies whether a public DNS 'PTR' record should be created to map the + * external IP address of the instance to a DNS domain name. + * This field is not used in ipv6AccessConfig. A default PTR + * record will be created if the VM has external IPv6 range associated. * * Generated from protobuf field optional bool set_public_ptr = 523870229; */ protected $set_public_ptr = null; /** - * The type of configuration. In accessConfigs (IPv4), the default and only option is ONE_TO_ONE_NAT. In ipv6AccessConfigs, the default and only option is DIRECT_IPV6. + * The type of configuration. In accessConfigs (IPv4), the + * default and only option is ONE_TO_ONE_NAT. Inipv6AccessConfigs, the default and only option isDIRECT_IPV6. * Check the Type enum for the list of possible values. * * Generated from protobuf field optional string type = 3575610; @@ -85,26 +113,53 @@ class AccessConfig extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $external_ipv6 - * Applies to ipv6AccessConfigs only. The first IPv6 address of the external IPv6 range associated with this instance, prefix length is stored in externalIpv6PrefixLength in ipv6AccessConfig. To use a static external IP address, it must be unused and in the same region as the instance's zone. If not specified, Google Cloud will automatically assign an external IPv6 address from the instance's subnetwork. + * Applies to ipv6AccessConfigs only. + * The first IPv6 address of the external IPv6 range associated + * with this instance, prefix length is stored inexternalIpv6PrefixLength in ipv6AccessConfig. To + * use a static external IP address, it must be unused and in the same region + * as the instance's zone. If not specified, Google Cloud will automatically + * assign an external IPv6 address from the instance's subnetwork. * @type int $external_ipv6_prefix_length - * Applies to ipv6AccessConfigs only. The prefix length of the external IPv6 range. + * Applies to ipv6AccessConfigs only. The prefix length of the + * external IPv6 range. * @type string $kind - * [Output Only] Type of the resource. Always compute#accessConfig for access configs. + * [Output Only] Type of the resource. Alwayscompute#accessConfig for access configs. * @type string $name - * The name of this access configuration. In accessConfigs (IPv4), the default and recommended name is External NAT, but you can use any arbitrary string, such as My external IP or Network Access. In ipv6AccessConfigs, the recommend name is External IPv6. + * The name of this access configuration. In accessConfigs + * (IPv4), the default and recommended name is External NAT, but + * you can use any arbitrary string, such as My external IP orNetwork Access. In ipv6AccessConfigs, the + * recommend name is External IPv6. * @type string $nat_i_p - * Applies to accessConfigs (IPv4) only. An external IP address associated with this instance. Specify an unused static external IP address available to the project or leave this field undefined to use an IP from a shared ephemeral IP address pool. If you specify a static external IP address, it must live in the same region as the zone of the instance. + * Applies to accessConfigs (IPv4) only. Anexternal IP + * address associated with this instance. Specify an unused static + * external IP address available to the project or leave this field undefined + * to use an IP from a shared ephemeral IP address pool. If you specify a + * static external IP address, it must live in the same region as the zone of + * the instance. * @type string $network_tier - * This signifies the networking tier used for configuring this access configuration and can only take the following values: PREMIUM, STANDARD. If an AccessConfig is specified without a valid external IP address, an ephemeral IP will be created with this networkTier. If an AccessConfig with a valid external IP address is specified, it must match that of the networkTier associated with the Address resource owning that IP. + * This signifies the networking tier used for configuring this access + * configuration and can only take the following values: PREMIUM,STANDARD. + * If an AccessConfig is specified without a valid external IP address, an + * ephemeral IP will be created with this networkTier. + * If an AccessConfig with a valid external IP address is specified, it must + * match that of the networkTier associated with the Address resource owning + * that IP. * Check the NetworkTier enum for the list of possible values. * @type string $public_ptr_domain_name - * The DNS domain name for the public PTR record. You can set this field only if the `setPublicPtr` field is enabled in accessConfig. If this field is unspecified in ipv6AccessConfig, a default PTR record will be created for first IP in associated external IPv6 range. + * The DNS domain name for the public PTR record. + * You can set this field only if the `setPublicPtr` field is enabled inaccessConfig. If this field is unspecified inipv6AccessConfig, a default PTR record will be created for + * first IP in associated external IPv6 range. * @type string $security_policy - * The resource URL for the security policy associated with this access config. + * The resource URL for the security policy associated with this access + * config. * @type bool $set_public_ptr - * Specifies whether a public DNS 'PTR' record should be created to map the external IP address of the instance to a DNS domain name. This field is not used in ipv6AccessConfig. A default PTR record will be created if the VM has external IPv6 range associated. + * Specifies whether a public DNS 'PTR' record should be created to map the + * external IP address of the instance to a DNS domain name. + * This field is not used in ipv6AccessConfig. A default PTR + * record will be created if the VM has external IPv6 range associated. * @type string $type - * The type of configuration. In accessConfigs (IPv4), the default and only option is ONE_TO_ONE_NAT. In ipv6AccessConfigs, the default and only option is DIRECT_IPV6. + * The type of configuration. In accessConfigs (IPv4), the + * default and only option is ONE_TO_ONE_NAT. Inipv6AccessConfigs, the default and only option isDIRECT_IPV6. * Check the Type enum for the list of possible values. * } */ @@ -114,7 +169,12 @@ public function __construct($data = NULL) { } /** - * Applies to ipv6AccessConfigs only. The first IPv6 address of the external IPv6 range associated with this instance, prefix length is stored in externalIpv6PrefixLength in ipv6AccessConfig. To use a static external IP address, it must be unused and in the same region as the instance's zone. If not specified, Google Cloud will automatically assign an external IPv6 address from the instance's subnetwork. + * Applies to ipv6AccessConfigs only. + * The first IPv6 address of the external IPv6 range associated + * with this instance, prefix length is stored inexternalIpv6PrefixLength in ipv6AccessConfig. To + * use a static external IP address, it must be unused and in the same region + * as the instance's zone. If not specified, Google Cloud will automatically + * assign an external IPv6 address from the instance's subnetwork. * * Generated from protobuf field optional string external_ipv6 = 532703707; * @return string @@ -135,7 +195,12 @@ public function clearExternalIpv6() } /** - * Applies to ipv6AccessConfigs only. The first IPv6 address of the external IPv6 range associated with this instance, prefix length is stored in externalIpv6PrefixLength in ipv6AccessConfig. To use a static external IP address, it must be unused and in the same region as the instance's zone. If not specified, Google Cloud will automatically assign an external IPv6 address from the instance's subnetwork. + * Applies to ipv6AccessConfigs only. + * The first IPv6 address of the external IPv6 range associated + * with this instance, prefix length is stored inexternalIpv6PrefixLength in ipv6AccessConfig. To + * use a static external IP address, it must be unused and in the same region + * as the instance's zone. If not specified, Google Cloud will automatically + * assign an external IPv6 address from the instance's subnetwork. * * Generated from protobuf field optional string external_ipv6 = 532703707; * @param string $var @@ -150,7 +215,8 @@ public function setExternalIpv6($var) } /** - * Applies to ipv6AccessConfigs only. The prefix length of the external IPv6 range. + * Applies to ipv6AccessConfigs only. The prefix length of the + * external IPv6 range. * * Generated from protobuf field optional int32 external_ipv6_prefix_length = 425672143; * @return int @@ -171,7 +237,8 @@ public function clearExternalIpv6PrefixLength() } /** - * Applies to ipv6AccessConfigs only. The prefix length of the external IPv6 range. + * Applies to ipv6AccessConfigs only. The prefix length of the + * external IPv6 range. * * Generated from protobuf field optional int32 external_ipv6_prefix_length = 425672143; * @param int $var @@ -186,7 +253,7 @@ public function setExternalIpv6PrefixLength($var) } /** - * [Output Only] Type of the resource. Always compute#accessConfig for access configs. + * [Output Only] Type of the resource. Alwayscompute#accessConfig for access configs. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -207,7 +274,7 @@ public function clearKind() } /** - * [Output Only] Type of the resource. Always compute#accessConfig for access configs. + * [Output Only] Type of the resource. Alwayscompute#accessConfig for access configs. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -222,7 +289,10 @@ public function setKind($var) } /** - * The name of this access configuration. In accessConfigs (IPv4), the default and recommended name is External NAT, but you can use any arbitrary string, such as My external IP or Network Access. In ipv6AccessConfigs, the recommend name is External IPv6. + * The name of this access configuration. In accessConfigs + * (IPv4), the default and recommended name is External NAT, but + * you can use any arbitrary string, such as My external IP orNetwork Access. In ipv6AccessConfigs, the + * recommend name is External IPv6. * * Generated from protobuf field optional string name = 3373707; * @return string @@ -243,7 +313,10 @@ public function clearName() } /** - * The name of this access configuration. In accessConfigs (IPv4), the default and recommended name is External NAT, but you can use any arbitrary string, such as My external IP or Network Access. In ipv6AccessConfigs, the recommend name is External IPv6. + * The name of this access configuration. In accessConfigs + * (IPv4), the default and recommended name is External NAT, but + * you can use any arbitrary string, such as My external IP orNetwork Access. In ipv6AccessConfigs, the + * recommend name is External IPv6. * * Generated from protobuf field optional string name = 3373707; * @param string $var @@ -258,7 +331,12 @@ public function setName($var) } /** - * Applies to accessConfigs (IPv4) only. An external IP address associated with this instance. Specify an unused static external IP address available to the project or leave this field undefined to use an IP from a shared ephemeral IP address pool. If you specify a static external IP address, it must live in the same region as the zone of the instance. + * Applies to accessConfigs (IPv4) only. Anexternal IP + * address associated with this instance. Specify an unused static + * external IP address available to the project or leave this field undefined + * to use an IP from a shared ephemeral IP address pool. If you specify a + * static external IP address, it must live in the same region as the zone of + * the instance. * * Generated from protobuf field optional string nat_i_p = 117634556; * @return string @@ -279,7 +357,12 @@ public function clearNatIP() } /** - * Applies to accessConfigs (IPv4) only. An external IP address associated with this instance. Specify an unused static external IP address available to the project or leave this field undefined to use an IP from a shared ephemeral IP address pool. If you specify a static external IP address, it must live in the same region as the zone of the instance. + * Applies to accessConfigs (IPv4) only. Anexternal IP + * address associated with this instance. Specify an unused static + * external IP address available to the project or leave this field undefined + * to use an IP from a shared ephemeral IP address pool. If you specify a + * static external IP address, it must live in the same region as the zone of + * the instance. * * Generated from protobuf field optional string nat_i_p = 117634556; * @param string $var @@ -294,7 +377,13 @@ public function setNatIP($var) } /** - * This signifies the networking tier used for configuring this access configuration and can only take the following values: PREMIUM, STANDARD. If an AccessConfig is specified without a valid external IP address, an ephemeral IP will be created with this networkTier. If an AccessConfig with a valid external IP address is specified, it must match that of the networkTier associated with the Address resource owning that IP. + * This signifies the networking tier used for configuring this access + * configuration and can only take the following values: PREMIUM,STANDARD. + * If an AccessConfig is specified without a valid external IP address, an + * ephemeral IP will be created with this networkTier. + * If an AccessConfig with a valid external IP address is specified, it must + * match that of the networkTier associated with the Address resource owning + * that IP. * Check the NetworkTier enum for the list of possible values. * * Generated from protobuf field optional string network_tier = 517397843; @@ -316,7 +405,13 @@ public function clearNetworkTier() } /** - * This signifies the networking tier used for configuring this access configuration and can only take the following values: PREMIUM, STANDARD. If an AccessConfig is specified without a valid external IP address, an ephemeral IP will be created with this networkTier. If an AccessConfig with a valid external IP address is specified, it must match that of the networkTier associated with the Address resource owning that IP. + * This signifies the networking tier used for configuring this access + * configuration and can only take the following values: PREMIUM,STANDARD. + * If an AccessConfig is specified without a valid external IP address, an + * ephemeral IP will be created with this networkTier. + * If an AccessConfig with a valid external IP address is specified, it must + * match that of the networkTier associated with the Address resource owning + * that IP. * Check the NetworkTier enum for the list of possible values. * * Generated from protobuf field optional string network_tier = 517397843; @@ -332,7 +427,9 @@ public function setNetworkTier($var) } /** - * The DNS domain name for the public PTR record. You can set this field only if the `setPublicPtr` field is enabled in accessConfig. If this field is unspecified in ipv6AccessConfig, a default PTR record will be created for first IP in associated external IPv6 range. + * The DNS domain name for the public PTR record. + * You can set this field only if the `setPublicPtr` field is enabled inaccessConfig. If this field is unspecified inipv6AccessConfig, a default PTR record will be created for + * first IP in associated external IPv6 range. * * Generated from protobuf field optional string public_ptr_domain_name = 316599167; * @return string @@ -353,7 +450,9 @@ public function clearPublicPtrDomainName() } /** - * The DNS domain name for the public PTR record. You can set this field only if the `setPublicPtr` field is enabled in accessConfig. If this field is unspecified in ipv6AccessConfig, a default PTR record will be created for first IP in associated external IPv6 range. + * The DNS domain name for the public PTR record. + * You can set this field only if the `setPublicPtr` field is enabled inaccessConfig. If this field is unspecified inipv6AccessConfig, a default PTR record will be created for + * first IP in associated external IPv6 range. * * Generated from protobuf field optional string public_ptr_domain_name = 316599167; * @param string $var @@ -368,7 +467,8 @@ public function setPublicPtrDomainName($var) } /** - * The resource URL for the security policy associated with this access config. + * The resource URL for the security policy associated with this access + * config. * * Generated from protobuf field optional string security_policy = 171082513; * @return string @@ -389,7 +489,8 @@ public function clearSecurityPolicy() } /** - * The resource URL for the security policy associated with this access config. + * The resource URL for the security policy associated with this access + * config. * * Generated from protobuf field optional string security_policy = 171082513; * @param string $var @@ -404,7 +505,10 @@ public function setSecurityPolicy($var) } /** - * Specifies whether a public DNS 'PTR' record should be created to map the external IP address of the instance to a DNS domain name. This field is not used in ipv6AccessConfig. A default PTR record will be created if the VM has external IPv6 range associated. + * Specifies whether a public DNS 'PTR' record should be created to map the + * external IP address of the instance to a DNS domain name. + * This field is not used in ipv6AccessConfig. A default PTR + * record will be created if the VM has external IPv6 range associated. * * Generated from protobuf field optional bool set_public_ptr = 523870229; * @return bool @@ -425,7 +529,10 @@ public function clearSetPublicPtr() } /** - * Specifies whether a public DNS 'PTR' record should be created to map the external IP address of the instance to a DNS domain name. This field is not used in ipv6AccessConfig. A default PTR record will be created if the VM has external IPv6 range associated. + * Specifies whether a public DNS 'PTR' record should be created to map the + * external IP address of the instance to a DNS domain name. + * This field is not used in ipv6AccessConfig. A default PTR + * record will be created if the VM has external IPv6 range associated. * * Generated from protobuf field optional bool set_public_ptr = 523870229; * @param bool $var @@ -440,7 +547,8 @@ public function setSetPublicPtr($var) } /** - * The type of configuration. In accessConfigs (IPv4), the default and only option is ONE_TO_ONE_NAT. In ipv6AccessConfigs, the default and only option is DIRECT_IPV6. + * The type of configuration. In accessConfigs (IPv4), the + * default and only option is ONE_TO_ONE_NAT. Inipv6AccessConfigs, the default and only option isDIRECT_IPV6. * Check the Type enum for the list of possible values. * * Generated from protobuf field optional string type = 3575610; @@ -462,7 +570,8 @@ public function clearType() } /** - * The type of configuration. In accessConfigs (IPv4), the default and only option is ONE_TO_ONE_NAT. In ipv6AccessConfigs, the default and only option is DIRECT_IPV6. + * The type of configuration. In accessConfigs (IPv4), the + * default and only option is ONE_TO_ONE_NAT. Inipv6AccessConfigs, the default and only option isDIRECT_IPV6. * Check the Type enum for the list of possible values. * * Generated from protobuf field optional string type = 3575610; diff --git a/Compute/src/V1/AccessConfig/NetworkTier.php b/Compute/src/V1/AccessConfig/NetworkTier.php index c5a78231a2c0..be3f30916fc8 100644 --- a/Compute/src/V1/AccessConfig/NetworkTier.php +++ b/Compute/src/V1/AccessConfig/NetworkTier.php @@ -7,7 +7,13 @@ use UnexpectedValueException; /** - * This signifies the networking tier used for configuring this access configuration and can only take the following values: PREMIUM, STANDARD. If an AccessConfig is specified without a valid external IP address, an ephemeral IP will be created with this networkTier. If an AccessConfig with a valid external IP address is specified, it must match that of the networkTier associated with the Address resource owning that IP. + * This signifies the networking tier used for configuring this access + * configuration and can only take the following values: PREMIUM,STANDARD. + * If an AccessConfig is specified without a valid external IP address, an + * ephemeral IP will be created with this networkTier. + * If an AccessConfig with a valid external IP address is specified, it must + * match that of the networkTier associated with the Address resource owning + * that IP. * * Protobuf type google.cloud.compute.v1.AccessConfig.NetworkTier */ @@ -26,19 +32,22 @@ class NetworkTier */ const FIXED_STANDARD = 310464328; /** - * High quality, Google-grade network tier, support for all networking products. + * High quality, Google-grade network tier, support for all networking + * products. * * Generated from protobuf enum PREMIUM = 399530551; */ const PREMIUM = 399530551; /** - * Public internet quality, only limited support for other networking products. + * Public internet quality, only limited support for other networking + * products. * * Generated from protobuf enum STANDARD = 484642493; */ const STANDARD = 484642493; /** - * (Output only) Temporary tier for FIXED_STANDARD when fixed standard tier is expired or not configured. + * (Output only) Temporary tier for FIXED_STANDARD when fixed standard tier + * is expired or not configured. * * Generated from protobuf enum STANDARD_OVERRIDES_FIXED_STANDARD = 465847234; */ diff --git a/Compute/src/V1/AccessConfig/Type.php b/Compute/src/V1/AccessConfig/Type.php index 1ed64d09d0e4..707387892970 100644 --- a/Compute/src/V1/AccessConfig/Type.php +++ b/Compute/src/V1/AccessConfig/Type.php @@ -7,7 +7,8 @@ use UnexpectedValueException; /** - * The type of configuration. In accessConfigs (IPv4), the default and only option is ONE_TO_ONE_NAT. In ipv6AccessConfigs, the default and only option is DIRECT_IPV6. + * The type of configuration. In accessConfigs (IPv4), the + * default and only option is ONE_TO_ONE_NAT. Inipv6AccessConfigs, the default and only option isDIRECT_IPV6. * * Protobuf type google.cloud.compute.v1.AccessConfig.Type */ diff --git a/Compute/src/V1/AddAccessConfigInstanceRequest.php b/Compute/src/V1/AddAccessConfigInstanceRequest.php index 38193ebd2628..390413fa7133 100644 --- a/Compute/src/V1/AddAccessConfigInstanceRequest.php +++ b/Compute/src/V1/AddAccessConfigInstanceRequest.php @@ -40,7 +40,17 @@ class AddAccessConfigInstanceRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -88,7 +98,17 @@ public static function build(string $project, string $zone, string $instance, st * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $zone * The name of the zone for this request. * } @@ -213,7 +233,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -234,7 +264,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/AddAssociationFirewallPolicyRequest.php b/Compute/src/V1/AddAssociationFirewallPolicyRequest.php index e364b2cb6d90..c6c67f3b568c 100644 --- a/Compute/src/V1/AddAssociationFirewallPolicyRequest.php +++ b/Compute/src/V1/AddAssociationFirewallPolicyRequest.php @@ -28,13 +28,25 @@ class AddAssociationFirewallPolicyRequest extends \Google\Protobuf\Internal\Mess */ protected $firewall_policy_association_resource = null; /** - * Indicates whether or not to replace it if an association of the attachment already exists. This is false by default, in which case an error will be returned if an association already exists. + * Indicates whether or not to replace it if an association of the attachment + * already exists. This is false by default, in which case an error will be + * returned if an association already exists. * * Generated from protobuf field optional bool replace_existing_association = 209541240; */ protected $replace_existing_association = null; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -66,9 +78,21 @@ public static function build(string $firewallPolicy, \Google\Cloud\Compute\V1\Fi * @type \Google\Cloud\Compute\V1\FirewallPolicyAssociation $firewall_policy_association_resource * The body resource for this request * @type bool $replace_existing_association - * Indicates whether or not to replace it if an association of the attachment already exists. This is false by default, in which case an error will be returned if an association already exists. + * Indicates whether or not to replace it if an association of the attachment + * already exists. This is false by default, in which case an error will be + * returned if an association already exists. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -139,7 +163,9 @@ public function setFirewallPolicyAssociationResource($var) } /** - * Indicates whether or not to replace it if an association of the attachment already exists. This is false by default, in which case an error will be returned if an association already exists. + * Indicates whether or not to replace it if an association of the attachment + * already exists. This is false by default, in which case an error will be + * returned if an association already exists. * * Generated from protobuf field optional bool replace_existing_association = 209541240; * @return bool @@ -160,7 +186,9 @@ public function clearReplaceExistingAssociation() } /** - * Indicates whether or not to replace it if an association of the attachment already exists. This is false by default, in which case an error will be returned if an association already exists. + * Indicates whether or not to replace it if an association of the attachment + * already exists. This is false by default, in which case an error will be + * returned if an association already exists. * * Generated from protobuf field optional bool replace_existing_association = 209541240; * @param bool $var @@ -175,7 +203,17 @@ public function setReplaceExistingAssociation($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -196,7 +234,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/AddAssociationNetworkFirewallPolicyRequest.php b/Compute/src/V1/AddAssociationNetworkFirewallPolicyRequest.php index 9d72d53939b8..74aa8531d4ae 100644 --- a/Compute/src/V1/AddAssociationNetworkFirewallPolicyRequest.php +++ b/Compute/src/V1/AddAssociationNetworkFirewallPolicyRequest.php @@ -34,13 +34,25 @@ class AddAssociationNetworkFirewallPolicyRequest extends \Google\Protobuf\Intern */ protected $project = ''; /** - * Indicates whether or not to replace it if an association of the attachment already exists. This is false by default, in which case an error will be returned if an association already exists. + * Indicates whether or not to replace it if an association of the attachment + * already exists. This is false by default, in which case an error will be + * returned if an association already exists. * * Generated from protobuf field optional bool replace_existing_association = 209541240; */ protected $replace_existing_association = null; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -76,9 +88,21 @@ public static function build(string $project, string $firewallPolicy, \Google\Cl * @type string $project * Project ID for this request. * @type bool $replace_existing_association - * Indicates whether or not to replace it if an association of the attachment already exists. This is false by default, in which case an error will be returned if an association already exists. + * Indicates whether or not to replace it if an association of the attachment + * already exists. This is false by default, in which case an error will be + * returned if an association already exists. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -175,7 +199,9 @@ public function setProject($var) } /** - * Indicates whether or not to replace it if an association of the attachment already exists. This is false by default, in which case an error will be returned if an association already exists. + * Indicates whether or not to replace it if an association of the attachment + * already exists. This is false by default, in which case an error will be + * returned if an association already exists. * * Generated from protobuf field optional bool replace_existing_association = 209541240; * @return bool @@ -196,7 +222,9 @@ public function clearReplaceExistingAssociation() } /** - * Indicates whether or not to replace it if an association of the attachment already exists. This is false by default, in which case an error will be returned if an association already exists. + * Indicates whether or not to replace it if an association of the attachment + * already exists. This is false by default, in which case an error will be + * returned if an association already exists. * * Generated from protobuf field optional bool replace_existing_association = 209541240; * @param bool $var @@ -211,7 +239,17 @@ public function setReplaceExistingAssociation($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -232,7 +270,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/AddAssociationOrganizationSecurityPolicyRequest.php b/Compute/src/V1/AddAssociationOrganizationSecurityPolicyRequest.php index 3fb0c3c1fdf6..1bea5348aef9 100644 --- a/Compute/src/V1/AddAssociationOrganizationSecurityPolicyRequest.php +++ b/Compute/src/V1/AddAssociationOrganizationSecurityPolicyRequest.php @@ -16,13 +16,25 @@ class AddAssociationOrganizationSecurityPolicyRequest extends \Google\Protobuf\Internal\Message { /** - * Indicates whether or not to replace it if an association of the attachment already exists. This is false by default, in which case an error will be returned if an association already exists. + * Indicates whether or not to replace it if an association of the attachment + * already exists. This is false by default, in which case an error will be + * returned if an association already exists. * * Generated from protobuf field optional bool replace_existing_association = 209541240; */ protected $replace_existing_association = null; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -62,9 +74,21 @@ public static function build(string $securityPolicy, \Google\Cloud\Compute\V1\Se * Optional. Data for populating the Message object. * * @type bool $replace_existing_association - * Indicates whether or not to replace it if an association of the attachment already exists. This is false by default, in which case an error will be returned if an association already exists. + * Indicates whether or not to replace it if an association of the attachment + * already exists. This is false by default, in which case an error will be + * returned if an association already exists. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $security_policy * Name of the security policy to update. * @type \Google\Cloud\Compute\V1\SecurityPolicyAssociation $security_policy_association_resource @@ -77,7 +101,9 @@ public function __construct($data = NULL) { } /** - * Indicates whether or not to replace it if an association of the attachment already exists. This is false by default, in which case an error will be returned if an association already exists. + * Indicates whether or not to replace it if an association of the attachment + * already exists. This is false by default, in which case an error will be + * returned if an association already exists. * * Generated from protobuf field optional bool replace_existing_association = 209541240; * @return bool @@ -98,7 +124,9 @@ public function clearReplaceExistingAssociation() } /** - * Indicates whether or not to replace it if an association of the attachment already exists. This is false by default, in which case an error will be returned if an association already exists. + * Indicates whether or not to replace it if an association of the attachment + * already exists. This is false by default, in which case an error will be + * returned if an association already exists. * * Generated from protobuf field optional bool replace_existing_association = 209541240; * @param bool $var @@ -113,7 +141,17 @@ public function setReplaceExistingAssociation($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -134,7 +172,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/AddAssociationRegionNetworkFirewallPolicyRequest.php b/Compute/src/V1/AddAssociationRegionNetworkFirewallPolicyRequest.php index 07b9d57253bf..8b8eb119965c 100644 --- a/Compute/src/V1/AddAssociationRegionNetworkFirewallPolicyRequest.php +++ b/Compute/src/V1/AddAssociationRegionNetworkFirewallPolicyRequest.php @@ -40,13 +40,25 @@ class AddAssociationRegionNetworkFirewallPolicyRequest extends \Google\Protobuf\ */ protected $region = ''; /** - * Indicates whether or not to replace it if an association already exists. This is false by default, in which case an error will be returned if an association already exists. + * Indicates whether or not to replace it if an association already exists. + * This is false by default, in which case an error will be returned if an + * association already exists. * * Generated from protobuf field optional bool replace_existing_association = 209541240; */ protected $replace_existing_association = null; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -86,9 +98,21 @@ public static function build(string $project, string $region, string $firewallPo * @type string $region * Name of the region scoping this request. * @type bool $replace_existing_association - * Indicates whether or not to replace it if an association already exists. This is false by default, in which case an error will be returned if an association already exists. + * Indicates whether or not to replace it if an association already exists. + * This is false by default, in which case an error will be returned if an + * association already exists. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -211,7 +235,9 @@ public function setRegion($var) } /** - * Indicates whether or not to replace it if an association already exists. This is false by default, in which case an error will be returned if an association already exists. + * Indicates whether or not to replace it if an association already exists. + * This is false by default, in which case an error will be returned if an + * association already exists. * * Generated from protobuf field optional bool replace_existing_association = 209541240; * @return bool @@ -232,7 +258,9 @@ public function clearReplaceExistingAssociation() } /** - * Indicates whether or not to replace it if an association already exists. This is false by default, in which case an error will be returned if an association already exists. + * Indicates whether or not to replace it if an association already exists. + * This is false by default, in which case an error will be returned if an + * association already exists. * * Generated from protobuf field optional bool replace_existing_association = 209541240; * @param bool $var @@ -247,7 +275,17 @@ public function setReplaceExistingAssociation($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -268,7 +306,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/AddHealthCheckTargetPoolRequest.php b/Compute/src/V1/AddHealthCheckTargetPoolRequest.php index b44e6f60b3e1..d5c112ade98a 100644 --- a/Compute/src/V1/AddHealthCheckTargetPoolRequest.php +++ b/Compute/src/V1/AddHealthCheckTargetPoolRequest.php @@ -28,7 +28,17 @@ class AddHealthCheckTargetPoolRequest extends \Google\Protobuf\Internal\Message */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -76,7 +86,17 @@ public static function build(string $project, string $region, string $targetPool * @type string $region * Name of the region scoping this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $target_pool * Name of the target pool to add a health check to. * @type \Google\Cloud\Compute\V1\TargetPoolsAddHealthCheckRequest $target_pools_add_health_check_request_resource @@ -141,7 +161,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -162,7 +192,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/AddInstanceTargetPoolRequest.php b/Compute/src/V1/AddInstanceTargetPoolRequest.php index e26a6283d4f9..65dd9044d30f 100644 --- a/Compute/src/V1/AddInstanceTargetPoolRequest.php +++ b/Compute/src/V1/AddInstanceTargetPoolRequest.php @@ -28,7 +28,17 @@ class AddInstanceTargetPoolRequest extends \Google\Protobuf\Internal\Message */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -76,7 +86,17 @@ public static function build(string $project, string $region, string $targetPool * @type string $region * Name of the region scoping this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $target_pool * Name of the TargetPool resource to add instances to. * @type \Google\Cloud\Compute\V1\TargetPoolsAddInstanceRequest $target_pools_add_instance_request_resource @@ -141,7 +161,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -162,7 +192,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/AddInstancesInstanceGroupRequest.php b/Compute/src/V1/AddInstancesInstanceGroupRequest.php index 82b3270db0ae..f42c1b9b98dc 100644 --- a/Compute/src/V1/AddInstancesInstanceGroupRequest.php +++ b/Compute/src/V1/AddInstancesInstanceGroupRequest.php @@ -34,13 +34,24 @@ class AddInstancesInstanceGroupRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ protected $request_id = null; /** - * The name of the zone where the instance group is located. + * The name of the zone + * where the instance group is located. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; */ @@ -48,7 +59,8 @@ class AddInstancesInstanceGroupRequest extends \Google\Protobuf\Internal\Message /** * @param string $project Project ID for this request. - * @param string $zone The name of the zone where the instance group is located. + * @param string $zone The name of the zone + * where the instance group is located. * @param string $instanceGroup The name of the instance group where you are adding instances. * @param \Google\Cloud\Compute\V1\InstanceGroupsAddInstancesRequest $instanceGroupsAddInstancesRequestResource The body resource for this request * @@ -78,9 +90,20 @@ public static function build(string $project, string $zone, string $instanceGrou * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $zone - * The name of the zone where the instance group is located. + * The name of the zone + * where the instance group is located. * } */ public function __construct($data = NULL) { @@ -177,7 +200,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -198,7 +231,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var @@ -213,7 +256,8 @@ public function setRequestId($var) } /** - * The name of the zone where the instance group is located. + * The name of the zone + * where the instance group is located. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; * @return string @@ -224,7 +268,8 @@ public function getZone() } /** - * The name of the zone where the instance group is located. + * The name of the zone + * where the instance group is located. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; * @param string $var diff --git a/Compute/src/V1/AddNetworkInterfaceInstanceRequest.php b/Compute/src/V1/AddNetworkInterfaceInstanceRequest.php index b572994728fa..2cce51ddec0d 100644 --- a/Compute/src/V1/AddNetworkInterfaceInstanceRequest.php +++ b/Compute/src/V1/AddNetworkInterfaceInstanceRequest.php @@ -16,7 +16,8 @@ class AddNetworkInterfaceInstanceRequest extends \Google\Protobuf\Internal\Message { /** - * The instance name for this request stored as resource_id. Name should conform to RFC1035 or be an unsigned long integer. + * The instance name for this request stored as resource_id. + * Name should conform to RFC1035 or be an unsigned long integer. * * Generated from protobuf field string instance = 18257045 [(.google.api.field_behavior) = REQUIRED]; */ @@ -34,7 +35,17 @@ class AddNetworkInterfaceInstanceRequest extends \Google\Protobuf\Internal\Messa */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -49,7 +60,8 @@ class AddNetworkInterfaceInstanceRequest extends \Google\Protobuf\Internal\Messa /** * @param string $project Project ID for this request. * @param string $zone The name of the zone for this request. - * @param string $instance The instance name for this request stored as resource_id. Name should conform to RFC1035 or be an unsigned long integer. + * @param string $instance The instance name for this request stored as resource_id. + * Name should conform to RFC1035 or be an unsigned long integer. * @param \Google\Cloud\Compute\V1\NetworkInterface $networkInterfaceResource The body resource for this request * * @return \Google\Cloud\Compute\V1\AddNetworkInterfaceInstanceRequest @@ -72,13 +84,24 @@ public static function build(string $project, string $zone, string $instance, \G * Optional. Data for populating the Message object. * * @type string $instance - * The instance name for this request stored as resource_id. Name should conform to RFC1035 or be an unsigned long integer. + * The instance name for this request stored as resource_id. + * Name should conform to RFC1035 or be an unsigned long integer. * @type \Google\Cloud\Compute\V1\NetworkInterface $network_interface_resource * The body resource for this request * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $zone * The name of the zone for this request. * } @@ -89,7 +112,8 @@ public function __construct($data = NULL) { } /** - * The instance name for this request stored as resource_id. Name should conform to RFC1035 or be an unsigned long integer. + * The instance name for this request stored as resource_id. + * Name should conform to RFC1035 or be an unsigned long integer. * * Generated from protobuf field string instance = 18257045 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -100,7 +124,8 @@ public function getInstance() } /** - * The instance name for this request stored as resource_id. Name should conform to RFC1035 or be an unsigned long integer. + * The instance name for this request stored as resource_id. + * Name should conform to RFC1035 or be an unsigned long integer. * * Generated from protobuf field string instance = 18257045 [(.google.api.field_behavior) = REQUIRED]; * @param string $var @@ -177,7 +202,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -198,7 +233,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/AddNodesNodeGroupRequest.php b/Compute/src/V1/AddNodesNodeGroupRequest.php index 2b9e93785055..4039b670626f 100644 --- a/Compute/src/V1/AddNodesNodeGroupRequest.php +++ b/Compute/src/V1/AddNodesNodeGroupRequest.php @@ -34,7 +34,17 @@ class AddNodesNodeGroupRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -78,7 +88,17 @@ public static function build(string $project, string $zone, string $nodeGroup, \ * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $zone * The name of the zone for this request. * } @@ -177,7 +197,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -198,7 +228,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/AddPacketMirroringRuleNetworkFirewallPolicyRequest.php b/Compute/src/V1/AddPacketMirroringRuleNetworkFirewallPolicyRequest.php index e89b0c59a0c8..df8b4c097be3 100644 --- a/Compute/src/V1/AddPacketMirroringRuleNetworkFirewallPolicyRequest.php +++ b/Compute/src/V1/AddPacketMirroringRuleNetworkFirewallPolicyRequest.php @@ -28,13 +28,15 @@ class AddPacketMirroringRuleNetworkFirewallPolicyRequest extends \Google\Protobu */ protected $firewall_policy_rule_resource = null; /** - * When rule.priority is not specified, auto choose a unused priority between minPriority and maxPriority>. This field is exclusive with rule.priority. + * When rule.priority is not specified, auto choose a unused priority betweenminPriority and maxPriority>. + * This field is exclusive with rule.priority. * * Generated from protobuf field optional int32 max_priority = 329635359; */ protected $max_priority = null; /** - * When rule.priority is not specified, auto choose a unused priority between minPriority and maxPriority>. This field is exclusive with rule.priority. + * When rule.priority is not specified, auto choose a unused priority betweenminPriority and maxPriority>. + * This field is exclusive with rule.priority. * * Generated from protobuf field optional int32 min_priority = 267190513; */ @@ -46,7 +48,17 @@ class AddPacketMirroringRuleNetworkFirewallPolicyRequest extends \Google\Protobu */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -80,13 +92,25 @@ public static function build(string $project, string $firewallPolicy, \Google\Cl * @type \Google\Cloud\Compute\V1\FirewallPolicyRule $firewall_policy_rule_resource * The body resource for this request * @type int $max_priority - * When rule.priority is not specified, auto choose a unused priority between minPriority and maxPriority>. This field is exclusive with rule.priority. + * When rule.priority is not specified, auto choose a unused priority betweenminPriority and maxPriority>. + * This field is exclusive with rule.priority. * @type int $min_priority - * When rule.priority is not specified, auto choose a unused priority between minPriority and maxPriority>. This field is exclusive with rule.priority. + * When rule.priority is not specified, auto choose a unused priority betweenminPriority and maxPriority>. + * This field is exclusive with rule.priority. * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -157,7 +181,8 @@ public function setFirewallPolicyRuleResource($var) } /** - * When rule.priority is not specified, auto choose a unused priority between minPriority and maxPriority>. This field is exclusive with rule.priority. + * When rule.priority is not specified, auto choose a unused priority betweenminPriority and maxPriority>. + * This field is exclusive with rule.priority. * * Generated from protobuf field optional int32 max_priority = 329635359; * @return int @@ -178,7 +203,8 @@ public function clearMaxPriority() } /** - * When rule.priority is not specified, auto choose a unused priority between minPriority and maxPriority>. This field is exclusive with rule.priority. + * When rule.priority is not specified, auto choose a unused priority betweenminPriority and maxPriority>. + * This field is exclusive with rule.priority. * * Generated from protobuf field optional int32 max_priority = 329635359; * @param int $var @@ -193,7 +219,8 @@ public function setMaxPriority($var) } /** - * When rule.priority is not specified, auto choose a unused priority between minPriority and maxPriority>. This field is exclusive with rule.priority. + * When rule.priority is not specified, auto choose a unused priority betweenminPriority and maxPriority>. + * This field is exclusive with rule.priority. * * Generated from protobuf field optional int32 min_priority = 267190513; * @return int @@ -214,7 +241,8 @@ public function clearMinPriority() } /** - * When rule.priority is not specified, auto choose a unused priority between minPriority and maxPriority>. This field is exclusive with rule.priority. + * When rule.priority is not specified, auto choose a unused priority betweenminPriority and maxPriority>. + * This field is exclusive with rule.priority. * * Generated from protobuf field optional int32 min_priority = 267190513; * @param int $var @@ -255,7 +283,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -276,7 +314,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/AddPeeringNetworkRequest.php b/Compute/src/V1/AddPeeringNetworkRequest.php index 7801fb7cdbc0..7c68c0a9968e 100644 --- a/Compute/src/V1/AddPeeringNetworkRequest.php +++ b/Compute/src/V1/AddPeeringNetworkRequest.php @@ -34,7 +34,17 @@ class AddPeeringNetworkRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -70,7 +80,17 @@ public static function build(string $project, string $network, \Google\Cloud\Com * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -167,7 +187,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -188,7 +218,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/AddResourcePoliciesDiskRequest.php b/Compute/src/V1/AddResourcePoliciesDiskRequest.php index c3e5b1a6ffa6..8b0a15e0a377 100644 --- a/Compute/src/V1/AddResourcePoliciesDiskRequest.php +++ b/Compute/src/V1/AddResourcePoliciesDiskRequest.php @@ -34,7 +34,17 @@ class AddResourcePoliciesDiskRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -78,7 +88,17 @@ public static function build(string $project, string $zone, string $disk, \Googl * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $zone * The name of the zone for this request. * } @@ -177,7 +197,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -198,7 +228,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/AddResourcePoliciesInstanceRequest.php b/Compute/src/V1/AddResourcePoliciesInstanceRequest.php index db723866ea8d..7ee99ac4d56c 100644 --- a/Compute/src/V1/AddResourcePoliciesInstanceRequest.php +++ b/Compute/src/V1/AddResourcePoliciesInstanceRequest.php @@ -34,7 +34,17 @@ class AddResourcePoliciesInstanceRequest extends \Google\Protobuf\Internal\Messa */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -78,7 +88,17 @@ public static function build(string $project, string $zone, string $instance, \G * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $zone * The name of the zone for this request. * } @@ -177,7 +197,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -198,7 +228,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/AddResourcePoliciesRegionDiskRequest.php b/Compute/src/V1/AddResourcePoliciesRegionDiskRequest.php index 28d5f293bb19..a2061e02d411 100644 --- a/Compute/src/V1/AddResourcePoliciesRegionDiskRequest.php +++ b/Compute/src/V1/AddResourcePoliciesRegionDiskRequest.php @@ -40,7 +40,17 @@ class AddResourcePoliciesRegionDiskRequest extends \Google\Protobuf\Internal\Mes */ protected $region_disks_add_resource_policies_request_resource = null; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -80,7 +90,17 @@ public static function build(string $project, string $region, string $disk, \Goo * @type \Google\Cloud\Compute\V1\RegionDisksAddResourcePoliciesRequest $region_disks_add_resource_policies_request_resource * The body resource for this request * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -203,7 +223,17 @@ public function setRegionDisksAddResourcePoliciesRequestResource($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -224,7 +254,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/AddRuleFirewallPolicyRequest.php b/Compute/src/V1/AddRuleFirewallPolicyRequest.php index 011cae00f6f2..80d6e5ed1c67 100644 --- a/Compute/src/V1/AddRuleFirewallPolicyRequest.php +++ b/Compute/src/V1/AddRuleFirewallPolicyRequest.php @@ -28,7 +28,17 @@ class AddRuleFirewallPolicyRequest extends \Google\Protobuf\Internal\Message */ protected $firewall_policy_rule_resource = null; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -60,7 +70,17 @@ public static function build(string $firewallPolicy, \Google\Cloud\Compute\V1\Fi * @type \Google\Cloud\Compute\V1\FirewallPolicyRule $firewall_policy_rule_resource * The body resource for this request * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -131,7 +151,17 @@ public function setFirewallPolicyRuleResource($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -152,7 +182,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/AddRuleNetworkFirewallPolicyRequest.php b/Compute/src/V1/AddRuleNetworkFirewallPolicyRequest.php index 39651a211773..51e2049cecd3 100644 --- a/Compute/src/V1/AddRuleNetworkFirewallPolicyRequest.php +++ b/Compute/src/V1/AddRuleNetworkFirewallPolicyRequest.php @@ -28,13 +28,15 @@ class AddRuleNetworkFirewallPolicyRequest extends \Google\Protobuf\Internal\Mess */ protected $firewall_policy_rule_resource = null; /** - * When rule.priority is not specified, auto choose a unused priority between minPriority and maxPriority>. This field is exclusive with rule.priority. + * When rule.priority is not specified, auto choose a unused priority betweenminPriority and maxPriority>. + * This field is exclusive with rule.priority. * * Generated from protobuf field optional int32 max_priority = 329635359; */ protected $max_priority = null; /** - * When rule.priority is not specified, auto choose a unused priority between minPriority and maxPriority>. This field is exclusive with rule.priority. + * When rule.priority is not specified, auto choose a unused priority betweenminPriority and maxPriority>. + * This field is exclusive with rule.priority. * * Generated from protobuf field optional int32 min_priority = 267190513; */ @@ -46,7 +48,17 @@ class AddRuleNetworkFirewallPolicyRequest extends \Google\Protobuf\Internal\Mess */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -80,13 +92,25 @@ public static function build(string $project, string $firewallPolicy, \Google\Cl * @type \Google\Cloud\Compute\V1\FirewallPolicyRule $firewall_policy_rule_resource * The body resource for this request * @type int $max_priority - * When rule.priority is not specified, auto choose a unused priority between minPriority and maxPriority>. This field is exclusive with rule.priority. + * When rule.priority is not specified, auto choose a unused priority betweenminPriority and maxPriority>. + * This field is exclusive with rule.priority. * @type int $min_priority - * When rule.priority is not specified, auto choose a unused priority between minPriority and maxPriority>. This field is exclusive with rule.priority. + * When rule.priority is not specified, auto choose a unused priority betweenminPriority and maxPriority>. + * This field is exclusive with rule.priority. * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -157,7 +181,8 @@ public function setFirewallPolicyRuleResource($var) } /** - * When rule.priority is not specified, auto choose a unused priority between minPriority and maxPriority>. This field is exclusive with rule.priority. + * When rule.priority is not specified, auto choose a unused priority betweenminPriority and maxPriority>. + * This field is exclusive with rule.priority. * * Generated from protobuf field optional int32 max_priority = 329635359; * @return int @@ -178,7 +203,8 @@ public function clearMaxPriority() } /** - * When rule.priority is not specified, auto choose a unused priority between minPriority and maxPriority>. This field is exclusive with rule.priority. + * When rule.priority is not specified, auto choose a unused priority betweenminPriority and maxPriority>. + * This field is exclusive with rule.priority. * * Generated from protobuf field optional int32 max_priority = 329635359; * @param int $var @@ -193,7 +219,8 @@ public function setMaxPriority($var) } /** - * When rule.priority is not specified, auto choose a unused priority between minPriority and maxPriority>. This field is exclusive with rule.priority. + * When rule.priority is not specified, auto choose a unused priority betweenminPriority and maxPriority>. + * This field is exclusive with rule.priority. * * Generated from protobuf field optional int32 min_priority = 267190513; * @return int @@ -214,7 +241,8 @@ public function clearMinPriority() } /** - * When rule.priority is not specified, auto choose a unused priority between minPriority and maxPriority>. This field is exclusive with rule.priority. + * When rule.priority is not specified, auto choose a unused priority betweenminPriority and maxPriority>. + * This field is exclusive with rule.priority. * * Generated from protobuf field optional int32 min_priority = 267190513; * @param int $var @@ -255,7 +283,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -276,7 +314,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/AddRuleOrganizationSecurityPolicyRequest.php b/Compute/src/V1/AddRuleOrganizationSecurityPolicyRequest.php index 6084b52b2605..4becb9d007df 100644 --- a/Compute/src/V1/AddRuleOrganizationSecurityPolicyRequest.php +++ b/Compute/src/V1/AddRuleOrganizationSecurityPolicyRequest.php @@ -16,7 +16,17 @@ class AddRuleOrganizationSecurityPolicyRequest extends \Google\Protobuf\Internal\Message { /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -56,7 +66,17 @@ public static function build(string $securityPolicy, \Google\Cloud\Compute\V1\Se * Optional. Data for populating the Message object. * * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $security_policy * Name of the security policy to update. * @type \Google\Cloud\Compute\V1\SecurityPolicyRule $security_policy_rule_resource @@ -69,7 +89,17 @@ public function __construct($data = NULL) { } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -90,7 +120,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/AddRuleRegionNetworkFirewallPolicyRequest.php b/Compute/src/V1/AddRuleRegionNetworkFirewallPolicyRequest.php index 3f92a5437662..50c6a1846e0c 100644 --- a/Compute/src/V1/AddRuleRegionNetworkFirewallPolicyRequest.php +++ b/Compute/src/V1/AddRuleRegionNetworkFirewallPolicyRequest.php @@ -28,13 +28,15 @@ class AddRuleRegionNetworkFirewallPolicyRequest extends \Google\Protobuf\Interna */ protected $firewall_policy_rule_resource = null; /** - * When rule.priority is not specified, auto choose a unused priority between minPriority and maxPriority>. This field is exclusive with rule.priority. + * When rule.priority is not specified, auto choose a unused priority betweenminPriority and maxPriority>. + * This field is exclusive with rule.priority. * * Generated from protobuf field optional int32 max_priority = 329635359; */ protected $max_priority = null; /** - * When rule.priority is not specified, auto choose a unused priority between minPriority and maxPriority>. This field is exclusive with rule.priority. + * When rule.priority is not specified, auto choose a unused priority betweenminPriority and maxPriority>. + * This field is exclusive with rule.priority. * * Generated from protobuf field optional int32 min_priority = 267190513; */ @@ -52,7 +54,17 @@ class AddRuleRegionNetworkFirewallPolicyRequest extends \Google\Protobuf\Interna */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -88,15 +100,27 @@ public static function build(string $project, string $region, string $firewallPo * @type \Google\Cloud\Compute\V1\FirewallPolicyRule $firewall_policy_rule_resource * The body resource for this request * @type int $max_priority - * When rule.priority is not specified, auto choose a unused priority between minPriority and maxPriority>. This field is exclusive with rule.priority. + * When rule.priority is not specified, auto choose a unused priority betweenminPriority and maxPriority>. + * This field is exclusive with rule.priority. * @type int $min_priority - * When rule.priority is not specified, auto choose a unused priority between minPriority and maxPriority>. This field is exclusive with rule.priority. + * When rule.priority is not specified, auto choose a unused priority betweenminPriority and maxPriority>. + * This field is exclusive with rule.priority. * @type string $project * Project ID for this request. * @type string $region * Name of the region scoping this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -167,7 +191,8 @@ public function setFirewallPolicyRuleResource($var) } /** - * When rule.priority is not specified, auto choose a unused priority between minPriority and maxPriority>. This field is exclusive with rule.priority. + * When rule.priority is not specified, auto choose a unused priority betweenminPriority and maxPriority>. + * This field is exclusive with rule.priority. * * Generated from protobuf field optional int32 max_priority = 329635359; * @return int @@ -188,7 +213,8 @@ public function clearMaxPriority() } /** - * When rule.priority is not specified, auto choose a unused priority between minPriority and maxPriority>. This field is exclusive with rule.priority. + * When rule.priority is not specified, auto choose a unused priority betweenminPriority and maxPriority>. + * This field is exclusive with rule.priority. * * Generated from protobuf field optional int32 max_priority = 329635359; * @param int $var @@ -203,7 +229,8 @@ public function setMaxPriority($var) } /** - * When rule.priority is not specified, auto choose a unused priority between minPriority and maxPriority>. This field is exclusive with rule.priority. + * When rule.priority is not specified, auto choose a unused priority betweenminPriority and maxPriority>. + * This field is exclusive with rule.priority. * * Generated from protobuf field optional int32 min_priority = 267190513; * @return int @@ -224,7 +251,8 @@ public function clearMinPriority() } /** - * When rule.priority is not specified, auto choose a unused priority between minPriority and maxPriority>. This field is exclusive with rule.priority. + * When rule.priority is not specified, auto choose a unused priority betweenminPriority and maxPriority>. + * This field is exclusive with rule.priority. * * Generated from protobuf field optional int32 min_priority = 267190513; * @param int $var @@ -291,7 +319,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -312,7 +350,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/AddSignedUrlKeyBackendBucketRequest.php b/Compute/src/V1/AddSignedUrlKeyBackendBucketRequest.php index d18c6b9c98bd..06f2044b7e35 100644 --- a/Compute/src/V1/AddSignedUrlKeyBackendBucketRequest.php +++ b/Compute/src/V1/AddSignedUrlKeyBackendBucketRequest.php @@ -16,7 +16,8 @@ class AddSignedUrlKeyBackendBucketRequest extends \Google\Protobuf\Internal\Message { /** - * Name of the BackendBucket resource to which the Signed URL Key should be added. The name should conform to RFC1035. + * Name of the BackendBucket resource to which the Signed URL Key should be + * added. The name should conform to RFC1035. * * Generated from protobuf field string backend_bucket = 91714037 [(.google.api.field_behavior) = REQUIRED]; */ @@ -28,7 +29,17 @@ class AddSignedUrlKeyBackendBucketRequest extends \Google\Protobuf\Internal\Mess */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -42,7 +53,8 @@ class AddSignedUrlKeyBackendBucketRequest extends \Google\Protobuf\Internal\Mess /** * @param string $project Project ID for this request. - * @param string $backendBucket Name of the BackendBucket resource to which the Signed URL Key should be added. The name should conform to RFC1035. + * @param string $backendBucket Name of the BackendBucket resource to which the Signed URL Key should be + * added. The name should conform to RFC1035. * @param \Google\Cloud\Compute\V1\SignedUrlKey $signedUrlKeyResource The body resource for this request * * @return \Google\Cloud\Compute\V1\AddSignedUrlKeyBackendBucketRequest @@ -64,11 +76,22 @@ public static function build(string $project, string $backendBucket, \Google\Clo * Optional. Data for populating the Message object. * * @type string $backend_bucket - * Name of the BackendBucket resource to which the Signed URL Key should be added. The name should conform to RFC1035. + * Name of the BackendBucket resource to which the Signed URL Key should be + * added. The name should conform to RFC1035. * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type \Google\Cloud\Compute\V1\SignedUrlKey $signed_url_key_resource * The body resource for this request * } @@ -79,7 +102,8 @@ public function __construct($data = NULL) { } /** - * Name of the BackendBucket resource to which the Signed URL Key should be added. The name should conform to RFC1035. + * Name of the BackendBucket resource to which the Signed URL Key should be + * added. The name should conform to RFC1035. * * Generated from protobuf field string backend_bucket = 91714037 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -90,7 +114,8 @@ public function getBackendBucket() } /** - * Name of the BackendBucket resource to which the Signed URL Key should be added. The name should conform to RFC1035. + * Name of the BackendBucket resource to which the Signed URL Key should be + * added. The name should conform to RFC1035. * * Generated from protobuf field string backend_bucket = 91714037 [(.google.api.field_behavior) = REQUIRED]; * @param string $var @@ -131,7 +156,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -152,7 +187,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/AddSignedUrlKeyBackendServiceRequest.php b/Compute/src/V1/AddSignedUrlKeyBackendServiceRequest.php index b8b7fd554072..1ee4a602c46c 100644 --- a/Compute/src/V1/AddSignedUrlKeyBackendServiceRequest.php +++ b/Compute/src/V1/AddSignedUrlKeyBackendServiceRequest.php @@ -16,7 +16,8 @@ class AddSignedUrlKeyBackendServiceRequest extends \Google\Protobuf\Internal\Message { /** - * Name of the BackendService resource to which the Signed URL Key should be added. The name should conform to RFC1035. + * Name of the BackendService resource to which the Signed URL Key should be + * added. The name should conform to RFC1035. * * Generated from protobuf field string backend_service = 306946058 [(.google.api.field_behavior) = REQUIRED]; */ @@ -28,7 +29,17 @@ class AddSignedUrlKeyBackendServiceRequest extends \Google\Protobuf\Internal\Mes */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -42,7 +53,8 @@ class AddSignedUrlKeyBackendServiceRequest extends \Google\Protobuf\Internal\Mes /** * @param string $project Project ID for this request. - * @param string $backendService Name of the BackendService resource to which the Signed URL Key should be added. The name should conform to RFC1035. + * @param string $backendService Name of the BackendService resource to which the Signed URL Key should be + * added. The name should conform to RFC1035. * @param \Google\Cloud\Compute\V1\SignedUrlKey $signedUrlKeyResource The body resource for this request * * @return \Google\Cloud\Compute\V1\AddSignedUrlKeyBackendServiceRequest @@ -64,11 +76,22 @@ public static function build(string $project, string $backendService, \Google\Cl * Optional. Data for populating the Message object. * * @type string $backend_service - * Name of the BackendService resource to which the Signed URL Key should be added. The name should conform to RFC1035. + * Name of the BackendService resource to which the Signed URL Key should be + * added. The name should conform to RFC1035. * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type \Google\Cloud\Compute\V1\SignedUrlKey $signed_url_key_resource * The body resource for this request * } @@ -79,7 +102,8 @@ public function __construct($data = NULL) { } /** - * Name of the BackendService resource to which the Signed URL Key should be added. The name should conform to RFC1035. + * Name of the BackendService resource to which the Signed URL Key should be + * added. The name should conform to RFC1035. * * Generated from protobuf field string backend_service = 306946058 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -90,7 +114,8 @@ public function getBackendService() } /** - * Name of the BackendService resource to which the Signed URL Key should be added. The name should conform to RFC1035. + * Name of the BackendService resource to which the Signed URL Key should be + * added. The name should conform to RFC1035. * * Generated from protobuf field string backend_service = 306946058 [(.google.api.field_behavior) = REQUIRED]; * @param string $var @@ -131,7 +156,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -152,7 +187,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/Address.php b/Compute/src/V1/Address.php index f50b5bc9b8f8..1db363e3e57c 100644 --- a/Compute/src/V1/Address.php +++ b/Compute/src/V1/Address.php @@ -9,7 +9,14 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Represents an IP Address resource. Google Compute Engine has two IP Address resources: * [Global (external and internal)](https://cloud.google.com/compute/docs/reference/rest/v1/globalAddresses) * [Regional (external and internal)](https://cloud.google.com/compute/docs/reference/rest/v1/addresses) For more information, see Reserving a static external IP address. + * Represents an IP Address resource. + * Google Compute Engine has two IP Address resources: + * * [Global (external and + * internal)](https://cloud.google.com/compute/docs/reference/rest/v1/globalAddresses) + * * [Regional (external and + * internal)](https://cloud.google.com/compute/docs/reference/rest/v1/addresses) + * For more information, see + * Reserving a static external IP address. * * Generated from protobuf message google.cloud.compute.v1.Address */ @@ -22,76 +29,101 @@ class Address extends \Google\Protobuf\Internal\Message */ protected $address = null; /** - * The type of address to reserve, either INTERNAL or EXTERNAL. If unspecified, defaults to EXTERNAL. + * The type of address to reserve, either INTERNAL orEXTERNAL. If unspecified, defaults to EXTERNAL. * Check the AddressType enum for the list of possible values. * * Generated from protobuf field optional string address_type = 264307877; */ protected $address_type = null; /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; */ protected $creation_timestamp = null; /** - * An optional description of this resource. Provide this field when you create the resource. + * An optional description of this resource. Provide this field when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; */ protected $description = null; /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; */ protected $id = null; /** - * The IP version that will be used by this address. Valid options are IPV4 or IPV6. + * The IP version that will be used by this address. Valid options areIPV4 or IPV6. * Check the IpVersion enum for the list of possible values. * * Generated from protobuf field optional string ip_version = 294959552; */ protected $ip_version = null; /** - * The endpoint type of this address, which should be VM or NETLB. This is used for deciding which type of endpoint this address can be used after the external IPv6 address reservation. + * The endpoint type of this address, which should be VM + * or NETLB. This is used for deciding which type of endpoint + * this address can be used after the external IPv6 address reservation. * Check the Ipv6EndpointType enum for the list of possible values. * * Generated from protobuf field optional string ipv6_endpoint_type = 97501004; */ protected $ipv6_endpoint_type = null; /** - * [Output Only] Type of the resource. Always compute#address for addresses. + * [Output Only] Type of the resource. Always compute#address for + * addresses. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * A fingerprint for the labels being applied to this Address, which is essentially a hash of the labels set used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve an Address. + * A fingerprint for the labels being applied to this Address, which is + * essentially a hash of the labels set used for optimistic locking. The + * fingerprint is initially generated by Compute Engine and changes after + * every request to modify or update labels. You must always provide an + * up-to-date fingerprint hash in order to update or change labels, + * otherwise the request will fail with error412 conditionNotMet. + * To see the latest fingerprint, make a get() request to + * retrieve an Address. * * Generated from protobuf field optional string label_fingerprint = 178124825; */ protected $label_fingerprint = null; /** - * Labels for this resource. These can only be added or modified by the setLabels method. Each label key/value pair must comply with RFC1035. Label values may be empty. + * Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035. + * Label values may be empty. * * Generated from protobuf field map labels = 500195327; */ private $labels; /** - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?`. The first character must be a lowercase letter, and all following characters (except for the last character) must be a dash, lowercase letter, or digit. The last character must be a lowercase letter or digit. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?`. The first character + * must be a lowercase letter, and all following characters (except for the + * last character) must be a dash, lowercase letter, or digit. The last + * character must be a lowercase letter or digit. * * Generated from protobuf field optional string name = 3373707; */ protected $name = null; /** - * The URL of the network in which to reserve the address. This field can only be used with INTERNAL type with the VPC_PEERING purpose. + * The URL of the network in which to reserve the address. This field can + * only be used with INTERNAL type with theVPC_PEERING purpose. * * Generated from protobuf field optional string network = 232872494; */ protected $network = null; /** - * This signifies the networking tier used for configuring this address and can only take the following values: PREMIUM or STANDARD. Internal IP addresses are always Premium Tier; global external IP addresses are always Premium Tier; regional external IP addresses can be either Standard or Premium Tier. If this field is not specified, it is assumed to be PREMIUM. + * This signifies the networking tier used for configuring this address and + * can only take the following values: PREMIUM orSTANDARD. Internal IP addresses are always Premium Tier; + * global external IP addresses are always Premium Tier; regional external IP + * addresses can be either Standard or Premium Tier. + * If this field is not specified, it is assumed to be PREMIUM. * Check the NetworkTier enum for the list of possible values. * * Generated from protobuf field optional string network_tier = 517397843; @@ -104,14 +136,37 @@ class Address extends \Google\Protobuf\Internal\Message */ protected $prefix_length = null; /** - * The purpose of this resource, which can be one of the following values: - GCE_ENDPOINT for addresses that are used by VM instances, alias IP ranges, load balancers, and similar resources. - DNS_RESOLVER for a DNS resolver address in a subnetwork for a Cloud DNS inbound forwarder IP addresses (regional internal IP address in a subnet of a VPC network) - VPC_PEERING for global internal IP addresses used for private services access allocated ranges. - NAT_AUTO for the regional external IP addresses used by Cloud NAT when allocating addresses using automatic NAT IP address allocation. - IPSEC_INTERCONNECT for addresses created from a private IP range that are reserved for a VLAN attachment in an *HA VPN over Cloud Interconnect* configuration. These addresses are regional resources. - `SHARED_LOADBALANCER_VIP` for an internal IP address that is assigned to multiple internal forwarding rules. - `PRIVATE_SERVICE_CONNECT` for a private network address that is used to configure Private Service Connect. Only global internal addresses can use this purpose. + * The purpose of this resource, which can be one of the following values: + * - GCE_ENDPOINT for addresses that are used by VM + * instances, alias IP ranges, load balancers, and similar resources. + * - DNS_RESOLVER for a DNS resolver address in a subnetwork + * for a Cloud DNS inbound + * forwarder IP addresses (regional internal IP address in a subnet of + * a VPC network) + * - VPC_PEERING for global internal IP addresses used for + * private services access allocated ranges. + * - NAT_AUTO for the regional external IP addresses used by + * Cloud NAT when allocating addresses using + * automatic NAT IP address allocation. + * - IPSEC_INTERCONNECT for addresses created from a private + * IP range that are reserved for a VLAN attachment in an + * *HA VPN over Cloud Interconnect* configuration. These addresses + * are regional resources. + * - `SHARED_LOADBALANCER_VIP` for an internal IP address that is assigned + * to multiple internal forwarding rules. + * - `PRIVATE_SERVICE_CONNECT` for a private network address that is + * used to configure Private Service Connect. Only global internal addresses + * can use this purpose. * Check the Purpose enum for the list of possible values. * * Generated from protobuf field optional string purpose = 316407070; */ protected $purpose = null; /** - * [Output Only] The URL of the region where a regional address resides. For regional addresses, you must specify the region as a path parameter in the HTTP request URL. *This field is not applicable to global addresses.* + * [Output Only] The URL of the region where a regional address resides. + * For regional addresses, you must specify the region as a path parameter in + * the HTTP request URL. *This field is not applicable to global + * addresses.* * * Generated from protobuf field optional string region = 138946292; */ @@ -123,14 +178,20 @@ class Address extends \Google\Protobuf\Internal\Message */ protected $self_link = null; /** - * [Output Only] The status of the address, which can be one of RESERVING, RESERVED, or IN_USE. An address that is RESERVING is currently in the process of being reserved. A RESERVED address is currently reserved and available to use. An IN_USE address is currently being used by another resource and is not available. + * [Output Only] The status of the address, which can be one ofRESERVING, RESERVED, or IN_USE. + * An address that is RESERVING is currently in the process of + * being reserved. A RESERVED address is currently reserved and + * available to use. An IN_USE address is currently being used + * by another resource and is not available. * Check the Status enum for the list of possible values. * * Generated from protobuf field optional string status = 181260274; */ protected $status = null; /** - * The URL of the subnetwork in which to reserve the address. If an IP address is specified, it must be within the subnetwork's IP range. This field can only be used with INTERNAL type with a GCE_ENDPOINT or DNS_RESOLVER purpose. + * The URL of the subnetwork in which to reserve the address. If an IP address + * is specified, it must be within the subnetwork's IP range. This field can + * only be used with INTERNAL type with aGCE_ENDPOINT or DNS_RESOLVER purpose. * * Generated from protobuf field optional string subnetwork = 307827694; */ @@ -151,47 +212,101 @@ class Address extends \Google\Protobuf\Internal\Message * @type string $address * The static IP address represented by this resource. * @type string $address_type - * The type of address to reserve, either INTERNAL or EXTERNAL. If unspecified, defaults to EXTERNAL. + * The type of address to reserve, either INTERNAL orEXTERNAL. If unspecified, defaults to EXTERNAL. * Check the AddressType enum for the list of possible values. * @type string $creation_timestamp - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * @type string $description - * An optional description of this resource. Provide this field when you create the resource. + * An optional description of this resource. Provide this field when you + * create the resource. * @type int|string $id - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * @type string $ip_version - * The IP version that will be used by this address. Valid options are IPV4 or IPV6. + * The IP version that will be used by this address. Valid options areIPV4 or IPV6. * Check the IpVersion enum for the list of possible values. * @type string $ipv6_endpoint_type - * The endpoint type of this address, which should be VM or NETLB. This is used for deciding which type of endpoint this address can be used after the external IPv6 address reservation. + * The endpoint type of this address, which should be VM + * or NETLB. This is used for deciding which type of endpoint + * this address can be used after the external IPv6 address reservation. * Check the Ipv6EndpointType enum for the list of possible values. * @type string $kind - * [Output Only] Type of the resource. Always compute#address for addresses. + * [Output Only] Type of the resource. Always compute#address for + * addresses. * @type string $label_fingerprint - * A fingerprint for the labels being applied to this Address, which is essentially a hash of the labels set used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve an Address. + * A fingerprint for the labels being applied to this Address, which is + * essentially a hash of the labels set used for optimistic locking. The + * fingerprint is initially generated by Compute Engine and changes after + * every request to modify or update labels. You must always provide an + * up-to-date fingerprint hash in order to update or change labels, + * otherwise the request will fail with error412 conditionNotMet. + * To see the latest fingerprint, make a get() request to + * retrieve an Address. * @type array|\Google\Protobuf\Internal\MapField $labels - * Labels for this resource. These can only be added or modified by the setLabels method. Each label key/value pair must comply with RFC1035. Label values may be empty. + * Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035. + * Label values may be empty. * @type string $name - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?`. The first character must be a lowercase letter, and all following characters (except for the last character) must be a dash, lowercase letter, or digit. The last character must be a lowercase letter or digit. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?`. The first character + * must be a lowercase letter, and all following characters (except for the + * last character) must be a dash, lowercase letter, or digit. The last + * character must be a lowercase letter or digit. * @type string $network - * The URL of the network in which to reserve the address. This field can only be used with INTERNAL type with the VPC_PEERING purpose. + * The URL of the network in which to reserve the address. This field can + * only be used with INTERNAL type with theVPC_PEERING purpose. * @type string $network_tier - * This signifies the networking tier used for configuring this address and can only take the following values: PREMIUM or STANDARD. Internal IP addresses are always Premium Tier; global external IP addresses are always Premium Tier; regional external IP addresses can be either Standard or Premium Tier. If this field is not specified, it is assumed to be PREMIUM. + * This signifies the networking tier used for configuring this address and + * can only take the following values: PREMIUM orSTANDARD. Internal IP addresses are always Premium Tier; + * global external IP addresses are always Premium Tier; regional external IP + * addresses can be either Standard or Premium Tier. + * If this field is not specified, it is assumed to be PREMIUM. * Check the NetworkTier enum for the list of possible values. * @type int $prefix_length * The prefix length if the resource represents an IP range. * @type string $purpose - * The purpose of this resource, which can be one of the following values: - GCE_ENDPOINT for addresses that are used by VM instances, alias IP ranges, load balancers, and similar resources. - DNS_RESOLVER for a DNS resolver address in a subnetwork for a Cloud DNS inbound forwarder IP addresses (regional internal IP address in a subnet of a VPC network) - VPC_PEERING for global internal IP addresses used for private services access allocated ranges. - NAT_AUTO for the regional external IP addresses used by Cloud NAT when allocating addresses using automatic NAT IP address allocation. - IPSEC_INTERCONNECT for addresses created from a private IP range that are reserved for a VLAN attachment in an *HA VPN over Cloud Interconnect* configuration. These addresses are regional resources. - `SHARED_LOADBALANCER_VIP` for an internal IP address that is assigned to multiple internal forwarding rules. - `PRIVATE_SERVICE_CONNECT` for a private network address that is used to configure Private Service Connect. Only global internal addresses can use this purpose. + * The purpose of this resource, which can be one of the following values: + * - GCE_ENDPOINT for addresses that are used by VM + * instances, alias IP ranges, load balancers, and similar resources. + * - DNS_RESOLVER for a DNS resolver address in a subnetwork + * for a Cloud DNS inbound + * forwarder IP addresses (regional internal IP address in a subnet of + * a VPC network) + * - VPC_PEERING for global internal IP addresses used for + * private services access allocated ranges. + * - NAT_AUTO for the regional external IP addresses used by + * Cloud NAT when allocating addresses using + * automatic NAT IP address allocation. + * - IPSEC_INTERCONNECT for addresses created from a private + * IP range that are reserved for a VLAN attachment in an + * *HA VPN over Cloud Interconnect* configuration. These addresses + * are regional resources. + * - `SHARED_LOADBALANCER_VIP` for an internal IP address that is assigned + * to multiple internal forwarding rules. + * - `PRIVATE_SERVICE_CONNECT` for a private network address that is + * used to configure Private Service Connect. Only global internal addresses + * can use this purpose. * Check the Purpose enum for the list of possible values. * @type string $region - * [Output Only] The URL of the region where a regional address resides. For regional addresses, you must specify the region as a path parameter in the HTTP request URL. *This field is not applicable to global addresses.* + * [Output Only] The URL of the region where a regional address resides. + * For regional addresses, you must specify the region as a path parameter in + * the HTTP request URL. *This field is not applicable to global + * addresses.* * @type string $self_link * [Output Only] Server-defined URL for the resource. * @type string $status - * [Output Only] The status of the address, which can be one of RESERVING, RESERVED, or IN_USE. An address that is RESERVING is currently in the process of being reserved. A RESERVED address is currently reserved and available to use. An IN_USE address is currently being used by another resource and is not available. + * [Output Only] The status of the address, which can be one ofRESERVING, RESERVED, or IN_USE. + * An address that is RESERVING is currently in the process of + * being reserved. A RESERVED address is currently reserved and + * available to use. An IN_USE address is currently being used + * by another resource and is not available. * Check the Status enum for the list of possible values. * @type string $subnetwork - * The URL of the subnetwork in which to reserve the address. If an IP address is specified, it must be within the subnetwork's IP range. This field can only be used with INTERNAL type with a GCE_ENDPOINT or DNS_RESOLVER purpose. + * The URL of the subnetwork in which to reserve the address. If an IP address + * is specified, it must be within the subnetwork's IP range. This field can + * only be used with INTERNAL type with aGCE_ENDPOINT or DNS_RESOLVER purpose. * @type array|\Google\Protobuf\Internal\RepeatedField $users * [Output Only] The URLs of the resources that are using this address. * } @@ -238,7 +353,7 @@ public function setAddress($var) } /** - * The type of address to reserve, either INTERNAL or EXTERNAL. If unspecified, defaults to EXTERNAL. + * The type of address to reserve, either INTERNAL orEXTERNAL. If unspecified, defaults to EXTERNAL. * Check the AddressType enum for the list of possible values. * * Generated from protobuf field optional string address_type = 264307877; @@ -260,7 +375,7 @@ public function clearAddressType() } /** - * The type of address to reserve, either INTERNAL or EXTERNAL. If unspecified, defaults to EXTERNAL. + * The type of address to reserve, either INTERNAL orEXTERNAL. If unspecified, defaults to EXTERNAL. * Check the AddressType enum for the list of possible values. * * Generated from protobuf field optional string address_type = 264307877; @@ -276,7 +391,8 @@ public function setAddressType($var) } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @return string @@ -297,7 +413,8 @@ public function clearCreationTimestamp() } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @param string $var @@ -312,7 +429,8 @@ public function setCreationTimestamp($var) } /** - * An optional description of this resource. Provide this field when you create the resource. + * An optional description of this resource. Provide this field when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @return string @@ -333,7 +451,8 @@ public function clearDescription() } /** - * An optional description of this resource. Provide this field when you create the resource. + * An optional description of this resource. Provide this field when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @param string $var @@ -348,7 +467,8 @@ public function setDescription($var) } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @return int|string @@ -369,7 +489,8 @@ public function clearId() } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @param int|string $var @@ -384,7 +505,7 @@ public function setId($var) } /** - * The IP version that will be used by this address. Valid options are IPV4 or IPV6. + * The IP version that will be used by this address. Valid options areIPV4 or IPV6. * Check the IpVersion enum for the list of possible values. * * Generated from protobuf field optional string ip_version = 294959552; @@ -406,7 +527,7 @@ public function clearIpVersion() } /** - * The IP version that will be used by this address. Valid options are IPV4 or IPV6. + * The IP version that will be used by this address. Valid options areIPV4 or IPV6. * Check the IpVersion enum for the list of possible values. * * Generated from protobuf field optional string ip_version = 294959552; @@ -422,7 +543,9 @@ public function setIpVersion($var) } /** - * The endpoint type of this address, which should be VM or NETLB. This is used for deciding which type of endpoint this address can be used after the external IPv6 address reservation. + * The endpoint type of this address, which should be VM + * or NETLB. This is used for deciding which type of endpoint + * this address can be used after the external IPv6 address reservation. * Check the Ipv6EndpointType enum for the list of possible values. * * Generated from protobuf field optional string ipv6_endpoint_type = 97501004; @@ -444,7 +567,9 @@ public function clearIpv6EndpointType() } /** - * The endpoint type of this address, which should be VM or NETLB. This is used for deciding which type of endpoint this address can be used after the external IPv6 address reservation. + * The endpoint type of this address, which should be VM + * or NETLB. This is used for deciding which type of endpoint + * this address can be used after the external IPv6 address reservation. * Check the Ipv6EndpointType enum for the list of possible values. * * Generated from protobuf field optional string ipv6_endpoint_type = 97501004; @@ -460,7 +585,8 @@ public function setIpv6EndpointType($var) } /** - * [Output Only] Type of the resource. Always compute#address for addresses. + * [Output Only] Type of the resource. Always compute#address for + * addresses. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -481,7 +607,8 @@ public function clearKind() } /** - * [Output Only] Type of the resource. Always compute#address for addresses. + * [Output Only] Type of the resource. Always compute#address for + * addresses. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -496,7 +623,14 @@ public function setKind($var) } /** - * A fingerprint for the labels being applied to this Address, which is essentially a hash of the labels set used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve an Address. + * A fingerprint for the labels being applied to this Address, which is + * essentially a hash of the labels set used for optimistic locking. The + * fingerprint is initially generated by Compute Engine and changes after + * every request to modify or update labels. You must always provide an + * up-to-date fingerprint hash in order to update or change labels, + * otherwise the request will fail with error412 conditionNotMet. + * To see the latest fingerprint, make a get() request to + * retrieve an Address. * * Generated from protobuf field optional string label_fingerprint = 178124825; * @return string @@ -517,7 +651,14 @@ public function clearLabelFingerprint() } /** - * A fingerprint for the labels being applied to this Address, which is essentially a hash of the labels set used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve an Address. + * A fingerprint for the labels being applied to this Address, which is + * essentially a hash of the labels set used for optimistic locking. The + * fingerprint is initially generated by Compute Engine and changes after + * every request to modify or update labels. You must always provide an + * up-to-date fingerprint hash in order to update or change labels, + * otherwise the request will fail with error412 conditionNotMet. + * To see the latest fingerprint, make a get() request to + * retrieve an Address. * * Generated from protobuf field optional string label_fingerprint = 178124825; * @param string $var @@ -532,7 +673,8 @@ public function setLabelFingerprint($var) } /** - * Labels for this resource. These can only be added or modified by the setLabels method. Each label key/value pair must comply with RFC1035. Label values may be empty. + * Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035. + * Label values may be empty. * * Generated from protobuf field map labels = 500195327; * @return \Google\Protobuf\Internal\MapField @@ -543,7 +685,8 @@ public function getLabels() } /** - * Labels for this resource. These can only be added or modified by the setLabels method. Each label key/value pair must comply with RFC1035. Label values may be empty. + * Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035. + * Label values may be empty. * * Generated from protobuf field map labels = 500195327; * @param array|\Google\Protobuf\Internal\MapField $var @@ -558,7 +701,13 @@ public function setLabels($var) } /** - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?`. The first character must be a lowercase letter, and all following characters (except for the last character) must be a dash, lowercase letter, or digit. The last character must be a lowercase letter or digit. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?`. The first character + * must be a lowercase letter, and all following characters (except for the + * last character) must be a dash, lowercase letter, or digit. The last + * character must be a lowercase letter or digit. * * Generated from protobuf field optional string name = 3373707; * @return string @@ -579,7 +728,13 @@ public function clearName() } /** - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?`. The first character must be a lowercase letter, and all following characters (except for the last character) must be a dash, lowercase letter, or digit. The last character must be a lowercase letter or digit. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?`. The first character + * must be a lowercase letter, and all following characters (except for the + * last character) must be a dash, lowercase letter, or digit. The last + * character must be a lowercase letter or digit. * * Generated from protobuf field optional string name = 3373707; * @param string $var @@ -594,7 +749,8 @@ public function setName($var) } /** - * The URL of the network in which to reserve the address. This field can only be used with INTERNAL type with the VPC_PEERING purpose. + * The URL of the network in which to reserve the address. This field can + * only be used with INTERNAL type with theVPC_PEERING purpose. * * Generated from protobuf field optional string network = 232872494; * @return string @@ -615,7 +771,8 @@ public function clearNetwork() } /** - * The URL of the network in which to reserve the address. This field can only be used with INTERNAL type with the VPC_PEERING purpose. + * The URL of the network in which to reserve the address. This field can + * only be used with INTERNAL type with theVPC_PEERING purpose. * * Generated from protobuf field optional string network = 232872494; * @param string $var @@ -630,7 +787,11 @@ public function setNetwork($var) } /** - * This signifies the networking tier used for configuring this address and can only take the following values: PREMIUM or STANDARD. Internal IP addresses are always Premium Tier; global external IP addresses are always Premium Tier; regional external IP addresses can be either Standard or Premium Tier. If this field is not specified, it is assumed to be PREMIUM. + * This signifies the networking tier used for configuring this address and + * can only take the following values: PREMIUM orSTANDARD. Internal IP addresses are always Premium Tier; + * global external IP addresses are always Premium Tier; regional external IP + * addresses can be either Standard or Premium Tier. + * If this field is not specified, it is assumed to be PREMIUM. * Check the NetworkTier enum for the list of possible values. * * Generated from protobuf field optional string network_tier = 517397843; @@ -652,7 +813,11 @@ public function clearNetworkTier() } /** - * This signifies the networking tier used for configuring this address and can only take the following values: PREMIUM or STANDARD. Internal IP addresses are always Premium Tier; global external IP addresses are always Premium Tier; regional external IP addresses can be either Standard or Premium Tier. If this field is not specified, it is assumed to be PREMIUM. + * This signifies the networking tier used for configuring this address and + * can only take the following values: PREMIUM orSTANDARD. Internal IP addresses are always Premium Tier; + * global external IP addresses are always Premium Tier; regional external IP + * addresses can be either Standard or Premium Tier. + * If this field is not specified, it is assumed to be PREMIUM. * Check the NetworkTier enum for the list of possible values. * * Generated from protobuf field optional string network_tier = 517397843; @@ -704,7 +869,27 @@ public function setPrefixLength($var) } /** - * The purpose of this resource, which can be one of the following values: - GCE_ENDPOINT for addresses that are used by VM instances, alias IP ranges, load balancers, and similar resources. - DNS_RESOLVER for a DNS resolver address in a subnetwork for a Cloud DNS inbound forwarder IP addresses (regional internal IP address in a subnet of a VPC network) - VPC_PEERING for global internal IP addresses used for private services access allocated ranges. - NAT_AUTO for the regional external IP addresses used by Cloud NAT when allocating addresses using automatic NAT IP address allocation. - IPSEC_INTERCONNECT for addresses created from a private IP range that are reserved for a VLAN attachment in an *HA VPN over Cloud Interconnect* configuration. These addresses are regional resources. - `SHARED_LOADBALANCER_VIP` for an internal IP address that is assigned to multiple internal forwarding rules. - `PRIVATE_SERVICE_CONNECT` for a private network address that is used to configure Private Service Connect. Only global internal addresses can use this purpose. + * The purpose of this resource, which can be one of the following values: + * - GCE_ENDPOINT for addresses that are used by VM + * instances, alias IP ranges, load balancers, and similar resources. + * - DNS_RESOLVER for a DNS resolver address in a subnetwork + * for a Cloud DNS inbound + * forwarder IP addresses (regional internal IP address in a subnet of + * a VPC network) + * - VPC_PEERING for global internal IP addresses used for + * private services access allocated ranges. + * - NAT_AUTO for the regional external IP addresses used by + * Cloud NAT when allocating addresses using + * automatic NAT IP address allocation. + * - IPSEC_INTERCONNECT for addresses created from a private + * IP range that are reserved for a VLAN attachment in an + * *HA VPN over Cloud Interconnect* configuration. These addresses + * are regional resources. + * - `SHARED_LOADBALANCER_VIP` for an internal IP address that is assigned + * to multiple internal forwarding rules. + * - `PRIVATE_SERVICE_CONNECT` for a private network address that is + * used to configure Private Service Connect. Only global internal addresses + * can use this purpose. * Check the Purpose enum for the list of possible values. * * Generated from protobuf field optional string purpose = 316407070; @@ -726,7 +911,27 @@ public function clearPurpose() } /** - * The purpose of this resource, which can be one of the following values: - GCE_ENDPOINT for addresses that are used by VM instances, alias IP ranges, load balancers, and similar resources. - DNS_RESOLVER for a DNS resolver address in a subnetwork for a Cloud DNS inbound forwarder IP addresses (regional internal IP address in a subnet of a VPC network) - VPC_PEERING for global internal IP addresses used for private services access allocated ranges. - NAT_AUTO for the regional external IP addresses used by Cloud NAT when allocating addresses using automatic NAT IP address allocation. - IPSEC_INTERCONNECT for addresses created from a private IP range that are reserved for a VLAN attachment in an *HA VPN over Cloud Interconnect* configuration. These addresses are regional resources. - `SHARED_LOADBALANCER_VIP` for an internal IP address that is assigned to multiple internal forwarding rules. - `PRIVATE_SERVICE_CONNECT` for a private network address that is used to configure Private Service Connect. Only global internal addresses can use this purpose. + * The purpose of this resource, which can be one of the following values: + * - GCE_ENDPOINT for addresses that are used by VM + * instances, alias IP ranges, load balancers, and similar resources. + * - DNS_RESOLVER for a DNS resolver address in a subnetwork + * for a Cloud DNS inbound + * forwarder IP addresses (regional internal IP address in a subnet of + * a VPC network) + * - VPC_PEERING for global internal IP addresses used for + * private services access allocated ranges. + * - NAT_AUTO for the regional external IP addresses used by + * Cloud NAT when allocating addresses using + * automatic NAT IP address allocation. + * - IPSEC_INTERCONNECT for addresses created from a private + * IP range that are reserved for a VLAN attachment in an + * *HA VPN over Cloud Interconnect* configuration. These addresses + * are regional resources. + * - `SHARED_LOADBALANCER_VIP` for an internal IP address that is assigned + * to multiple internal forwarding rules. + * - `PRIVATE_SERVICE_CONNECT` for a private network address that is + * used to configure Private Service Connect. Only global internal addresses + * can use this purpose. * Check the Purpose enum for the list of possible values. * * Generated from protobuf field optional string purpose = 316407070; @@ -742,7 +947,10 @@ public function setPurpose($var) } /** - * [Output Only] The URL of the region where a regional address resides. For regional addresses, you must specify the region as a path parameter in the HTTP request URL. *This field is not applicable to global addresses.* + * [Output Only] The URL of the region where a regional address resides. + * For regional addresses, you must specify the region as a path parameter in + * the HTTP request URL. *This field is not applicable to global + * addresses.* * * Generated from protobuf field optional string region = 138946292; * @return string @@ -763,7 +971,10 @@ public function clearRegion() } /** - * [Output Only] The URL of the region where a regional address resides. For regional addresses, you must specify the region as a path parameter in the HTTP request URL. *This field is not applicable to global addresses.* + * [Output Only] The URL of the region where a regional address resides. + * For regional addresses, you must specify the region as a path parameter in + * the HTTP request URL. *This field is not applicable to global + * addresses.* * * Generated from protobuf field optional string region = 138946292; * @param string $var @@ -814,7 +1025,11 @@ public function setSelfLink($var) } /** - * [Output Only] The status of the address, which can be one of RESERVING, RESERVED, or IN_USE. An address that is RESERVING is currently in the process of being reserved. A RESERVED address is currently reserved and available to use. An IN_USE address is currently being used by another resource and is not available. + * [Output Only] The status of the address, which can be one ofRESERVING, RESERVED, or IN_USE. + * An address that is RESERVING is currently in the process of + * being reserved. A RESERVED address is currently reserved and + * available to use. An IN_USE address is currently being used + * by another resource and is not available. * Check the Status enum for the list of possible values. * * Generated from protobuf field optional string status = 181260274; @@ -836,7 +1051,11 @@ public function clearStatus() } /** - * [Output Only] The status of the address, which can be one of RESERVING, RESERVED, or IN_USE. An address that is RESERVING is currently in the process of being reserved. A RESERVED address is currently reserved and available to use. An IN_USE address is currently being used by another resource and is not available. + * [Output Only] The status of the address, which can be one ofRESERVING, RESERVED, or IN_USE. + * An address that is RESERVING is currently in the process of + * being reserved. A RESERVED address is currently reserved and + * available to use. An IN_USE address is currently being used + * by another resource and is not available. * Check the Status enum for the list of possible values. * * Generated from protobuf field optional string status = 181260274; @@ -852,7 +1071,9 @@ public function setStatus($var) } /** - * The URL of the subnetwork in which to reserve the address. If an IP address is specified, it must be within the subnetwork's IP range. This field can only be used with INTERNAL type with a GCE_ENDPOINT or DNS_RESOLVER purpose. + * The URL of the subnetwork in which to reserve the address. If an IP address + * is specified, it must be within the subnetwork's IP range. This field can + * only be used with INTERNAL type with aGCE_ENDPOINT or DNS_RESOLVER purpose. * * Generated from protobuf field optional string subnetwork = 307827694; * @return string @@ -873,7 +1094,9 @@ public function clearSubnetwork() } /** - * The URL of the subnetwork in which to reserve the address. If an IP address is specified, it must be within the subnetwork's IP range. This field can only be used with INTERNAL type with a GCE_ENDPOINT or DNS_RESOLVER purpose. + * The URL of the subnetwork in which to reserve the address. If an IP address + * is specified, it must be within the subnetwork's IP range. This field can + * only be used with INTERNAL type with aGCE_ENDPOINT or DNS_RESOLVER purpose. * * Generated from protobuf field optional string subnetwork = 307827694; * @param string $var diff --git a/Compute/src/V1/Address/AddressType.php b/Compute/src/V1/Address/AddressType.php index 5275b9b5a2d4..9b8f6a612f27 100644 --- a/Compute/src/V1/Address/AddressType.php +++ b/Compute/src/V1/Address/AddressType.php @@ -7,7 +7,7 @@ use UnexpectedValueException; /** - * The type of address to reserve, either INTERNAL or EXTERNAL. If unspecified, defaults to EXTERNAL. + * The type of address to reserve, either INTERNAL orEXTERNAL. If unspecified, defaults to EXTERNAL. * * Protobuf type google.cloud.compute.v1.Address.AddressType */ @@ -26,7 +26,8 @@ class AddressType */ const EXTERNAL = 35607499; /** - * A private network IP address, for use with an Instance or Internal Load Balancer forwarding rule. + * A private network IP address, for use with an Instance or Internal Load + * Balancer forwarding rule. * * Generated from protobuf enum INTERNAL = 279295677; */ diff --git a/Compute/src/V1/Address/IpVersion.php b/Compute/src/V1/Address/IpVersion.php index 3474d1d67e18..ca11bb87cc97 100644 --- a/Compute/src/V1/Address/IpVersion.php +++ b/Compute/src/V1/Address/IpVersion.php @@ -7,7 +7,7 @@ use UnexpectedValueException; /** - * The IP version that will be used by this address. Valid options are IPV4 or IPV6. + * The IP version that will be used by this address. Valid options areIPV4 or IPV6. * * Protobuf type google.cloud.compute.v1.Address.IpVersion */ diff --git a/Compute/src/V1/Address/Ipv6EndpointType.php b/Compute/src/V1/Address/Ipv6EndpointType.php index 989bce6e29d0..861dd7027f90 100644 --- a/Compute/src/V1/Address/Ipv6EndpointType.php +++ b/Compute/src/V1/Address/Ipv6EndpointType.php @@ -7,7 +7,9 @@ use UnexpectedValueException; /** - * The endpoint type of this address, which should be VM or NETLB. This is used for deciding which type of endpoint this address can be used after the external IPv6 address reservation. + * The endpoint type of this address, which should be VM + * or NETLB. This is used for deciding which type of endpoint + * this address can be used after the external IPv6 address reservation. * * Protobuf type google.cloud.compute.v1.Address.Ipv6EndpointType */ diff --git a/Compute/src/V1/Address/NetworkTier.php b/Compute/src/V1/Address/NetworkTier.php index 5e768e183119..8e48d7b60947 100644 --- a/Compute/src/V1/Address/NetworkTier.php +++ b/Compute/src/V1/Address/NetworkTier.php @@ -7,7 +7,11 @@ use UnexpectedValueException; /** - * This signifies the networking tier used for configuring this address and can only take the following values: PREMIUM or STANDARD. Internal IP addresses are always Premium Tier; global external IP addresses are always Premium Tier; regional external IP addresses can be either Standard or Premium Tier. If this field is not specified, it is assumed to be PREMIUM. + * This signifies the networking tier used for configuring this address and + * can only take the following values: PREMIUM orSTANDARD. Internal IP addresses are always Premium Tier; + * global external IP addresses are always Premium Tier; regional external IP + * addresses can be either Standard or Premium Tier. + * If this field is not specified, it is assumed to be PREMIUM. * * Protobuf type google.cloud.compute.v1.Address.NetworkTier */ @@ -26,19 +30,22 @@ class NetworkTier */ const FIXED_STANDARD = 310464328; /** - * High quality, Google-grade network tier, support for all networking products. + * High quality, Google-grade network tier, support for all networking + * products. * * Generated from protobuf enum PREMIUM = 399530551; */ const PREMIUM = 399530551; /** - * Public internet quality, only limited support for other networking products. + * Public internet quality, only limited support for other networking + * products. * * Generated from protobuf enum STANDARD = 484642493; */ const STANDARD = 484642493; /** - * (Output only) Temporary tier for FIXED_STANDARD when fixed standard tier is expired or not configured. + * (Output only) Temporary tier for FIXED_STANDARD when fixed standard tier + * is expired or not configured. * * Generated from protobuf enum STANDARD_OVERRIDES_FIXED_STANDARD = 465847234; */ diff --git a/Compute/src/V1/Address/Purpose.php b/Compute/src/V1/Address/Purpose.php index 7c04c7708895..d4f0f7c9fd0e 100644 --- a/Compute/src/V1/Address/Purpose.php +++ b/Compute/src/V1/Address/Purpose.php @@ -7,7 +7,27 @@ use UnexpectedValueException; /** - * The purpose of this resource, which can be one of the following values: - GCE_ENDPOINT for addresses that are used by VM instances, alias IP ranges, load balancers, and similar resources. - DNS_RESOLVER for a DNS resolver address in a subnetwork for a Cloud DNS inbound forwarder IP addresses (regional internal IP address in a subnet of a VPC network) - VPC_PEERING for global internal IP addresses used for private services access allocated ranges. - NAT_AUTO for the regional external IP addresses used by Cloud NAT when allocating addresses using automatic NAT IP address allocation. - IPSEC_INTERCONNECT for addresses created from a private IP range that are reserved for a VLAN attachment in an *HA VPN over Cloud Interconnect* configuration. These addresses are regional resources. - `SHARED_LOADBALANCER_VIP` for an internal IP address that is assigned to multiple internal forwarding rules. - `PRIVATE_SERVICE_CONNECT` for a private network address that is used to configure Private Service Connect. Only global internal addresses can use this purpose. + * The purpose of this resource, which can be one of the following values: + * - GCE_ENDPOINT for addresses that are used by VM + * instances, alias IP ranges, load balancers, and similar resources. + * - DNS_RESOLVER for a DNS resolver address in a subnetwork + * for a Cloud DNS inbound + * forwarder IP addresses (regional internal IP address in a subnet of + * a VPC network) + * - VPC_PEERING for global internal IP addresses used for + * private services access allocated ranges. + * - NAT_AUTO for the regional external IP addresses used by + * Cloud NAT when allocating addresses using + * automatic NAT IP address allocation. + * - IPSEC_INTERCONNECT for addresses created from a private + * IP range that are reserved for a VLAN attachment in an + * *HA VPN over Cloud Interconnect* configuration. These addresses + * are regional resources. + * - `SHARED_LOADBALANCER_VIP` for an internal IP address that is assigned + * to multiple internal forwarding rules. + * - `PRIVATE_SERVICE_CONNECT` for a private network address that is + * used to configure Private Service Connect. Only global internal addresses + * can use this purpose. * * Protobuf type google.cloud.compute.v1.Address.Purpose */ @@ -32,7 +52,13 @@ class Purpose */ const GCE_ENDPOINT = 230515243; /** - * A regional internal IP address range reserved for the VLAN attachment that is used in HA VPN over Cloud Interconnect. This regional internal IP address range must not overlap with any IP address range of subnet/route in the VPC network and its peering networks. After the VLAN attachment is created with the reserved IP address range, when creating a new VPN gateway, its interface IP address is allocated from the associated VLAN attachment’s IP address range. + * A regional internal IP address range reserved for the VLAN attachment + * that is used in HA VPN over Cloud Interconnect. This regional + * internal IP address range must not overlap with any IP address range + * of subnet/route in the VPC network and its peering networks. After the + * VLAN attachment is created with the reserved IP address range, when + * creating a new VPN gateway, its interface IP address is allocated + * from the associated VLAN attachment’s IP address range. * * Generated from protobuf enum IPSEC_INTERCONNECT = 340437251; */ @@ -44,7 +70,8 @@ class Purpose */ const NAT_AUTO = 163666477; /** - * A private network IP address that can be used to configure Private Service Connect. This purpose can be specified only for GLOBAL addresses of Type INTERNAL + * A private network IP address that can be used to configure Private + * Service Connect. This purpose can be specified only forGLOBAL addresses of Type INTERNAL * * Generated from protobuf enum PRIVATE_SERVICE_CONNECT = 48134724; */ @@ -56,7 +83,8 @@ class Purpose */ const SERVERLESS = 270492508; /** - * A private network IP address that can be shared by multiple Internal Load Balancer forwarding rules. + * A private network IP address that can be shared by multiple Internal + * Load Balancer forwarding rules. * * Generated from protobuf enum SHARED_LOADBALANCER_VIP = 294447572; */ diff --git a/Compute/src/V1/Address/Status.php b/Compute/src/V1/Address/Status.php index 5d62d0b46f8e..63b7953dd09c 100644 --- a/Compute/src/V1/Address/Status.php +++ b/Compute/src/V1/Address/Status.php @@ -7,7 +7,11 @@ use UnexpectedValueException; /** - * [Output Only] The status of the address, which can be one of RESERVING, RESERVED, or IN_USE. An address that is RESERVING is currently in the process of being reserved. A RESERVED address is currently reserved and available to use. An IN_USE address is currently being used by another resource and is not available. + * [Output Only] The status of the address, which can be one ofRESERVING, RESERVED, or IN_USE. + * An address that is RESERVING is currently in the process of + * being reserved. A RESERVED address is currently reserved and + * available to use. An IN_USE address is currently being used + * by another resource and is not available. * * Protobuf type google.cloud.compute.v1.Address.Status */ diff --git a/Compute/src/V1/AddressAggregatedList.php b/Compute/src/V1/AddressAggregatedList.php index ffef64f54854..eb094fd2c861 100644 --- a/Compute/src/V1/AddressAggregatedList.php +++ b/Compute/src/V1/AddressAggregatedList.php @@ -27,13 +27,18 @@ class AddressAggregatedList extends \Google\Protobuf\Internal\Message */ private $items; /** - * [Output Only] Type of resource. Always compute#addressAggregatedList for aggregated lists of addresses. + * [Output Only] Type of resource. Alwayscompute#addressAggregatedList for aggregated lists of + * addresses. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -68,9 +73,14 @@ class AddressAggregatedList extends \Google\Protobuf\Internal\Message * @type array|\Google\Protobuf\Internal\MapField $items * A list of AddressesScopedList resources. * @type string $kind - * [Output Only] Type of resource. Always compute#addressAggregatedList for aggregated lists of addresses. + * [Output Only] Type of resource. Alwayscompute#addressAggregatedList for aggregated lists of + * addresses. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type array|\Google\Protobuf\Internal\RepeatedField $unreachables @@ -147,7 +157,8 @@ public function setItems($var) } /** - * [Output Only] Type of resource. Always compute#addressAggregatedList for aggregated lists of addresses. + * [Output Only] Type of resource. Alwayscompute#addressAggregatedList for aggregated lists of + * addresses. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -168,7 +179,8 @@ public function clearKind() } /** - * [Output Only] Type of resource. Always compute#addressAggregatedList for aggregated lists of addresses. + * [Output Only] Type of resource. Alwayscompute#addressAggregatedList for aggregated lists of + * addresses. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -183,7 +195,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -204,7 +220,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/AddressList.php b/Compute/src/V1/AddressList.php index ec6897b6d480..eec11b6969e1 100644 --- a/Compute/src/V1/AddressList.php +++ b/Compute/src/V1/AddressList.php @@ -28,13 +28,18 @@ class AddressList extends \Google\Protobuf\Internal\Message */ private $items; /** - * [Output Only] Type of resource. Always compute#addressList for lists of addresses. + * [Output Only] Type of resource. Always compute#addressList for + * lists of addresses. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -63,9 +68,14 @@ class AddressList extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\Address>|\Google\Protobuf\Internal\RepeatedField $items * A list of Address resources. * @type string $kind - * [Output Only] Type of resource. Always compute#addressList for lists of addresses. + * [Output Only] Type of resource. Always compute#addressList for + * lists of addresses. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type \Google\Cloud\Compute\V1\Warning $warning @@ -140,7 +150,8 @@ public function setItems($var) } /** - * [Output Only] Type of resource. Always compute#addressList for lists of addresses. + * [Output Only] Type of resource. Always compute#addressList for + * lists of addresses. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -161,7 +172,8 @@ public function clearKind() } /** - * [Output Only] Type of resource. Always compute#addressList for lists of addresses. + * [Output Only] Type of resource. Always compute#addressList for + * lists of addresses. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -176,7 +188,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -197,7 +213,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/AddressesScopedList.php b/Compute/src/V1/AddressesScopedList.php index 0a4a79b278a8..0383aeac466f 100644 --- a/Compute/src/V1/AddressesScopedList.php +++ b/Compute/src/V1/AddressesScopedList.php @@ -21,7 +21,8 @@ class AddressesScopedList extends \Google\Protobuf\Internal\Message */ private $addresses; /** - * [Output Only] Informational warning which replaces the list of addresses when the list is empty. + * [Output Only] Informational warning which replaces the list of addresses + * when the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; */ @@ -36,7 +37,8 @@ class AddressesScopedList extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\Address>|\Google\Protobuf\Internal\RepeatedField $addresses * [Output Only] A list of addresses contained in this scope. * @type \Google\Cloud\Compute\V1\Warning $warning - * [Output Only] Informational warning which replaces the list of addresses when the list is empty. + * [Output Only] Informational warning which replaces the list of addresses + * when the list is empty. * } */ public function __construct($data = NULL) { @@ -71,7 +73,8 @@ public function setAddresses($var) } /** - * [Output Only] Informational warning which replaces the list of addresses when the list is empty. + * [Output Only] Informational warning which replaces the list of addresses + * when the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; * @return \Google\Cloud\Compute\V1\Warning|null @@ -92,7 +95,8 @@ public function clearWarning() } /** - * [Output Only] Informational warning which replaces the list of addresses when the list is empty. + * [Output Only] Informational warning which replaces the list of addresses + * when the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; * @param \Google\Cloud\Compute\V1\Warning $var diff --git a/Compute/src/V1/AdvancedMachineFeatures.php b/Compute/src/V1/AdvancedMachineFeatures.php index 24b9618da89e..3bbc24e1f3ef 100644 --- a/Compute/src/V1/AdvancedMachineFeatures.php +++ b/Compute/src/V1/AdvancedMachineFeatures.php @@ -9,7 +9,11 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Specifies options for controlling advanced machine features. Options that would traditionally be configured in a BIOS belong here. Features that require operating system support may have corresponding entries in the GuestOsFeatures of an Image (e.g., whether or not the OS in the Image supports nested virtualization being enabled or disabled). + * Specifies options for controlling advanced machine features. + * Options that would traditionally be configured in a BIOS belong + * here. Features that require operating system support may have + * corresponding entries in the GuestOsFeatures of anImage (e.g., whether or not the OS in theImage supports nested virtualization being enabled or + * disabled). * * Generated from protobuf message google.cloud.compute.v1.AdvancedMachineFeatures */ @@ -35,19 +39,30 @@ class AdvancedMachineFeatures extends \Google\Protobuf\Internal\Message */ protected $performance_monitoring_unit = null; /** - * The number of threads per physical core. To disable simultaneous multithreading (SMT) set this to 1. If unset, the maximum number of threads supported per core by the underlying processor is assumed. + * The number of threads per physical core. To disable simultaneous + * multithreading (SMT) set this to 1. If unset, the maximum number + * of threads supported per core by the underlying processor is + * assumed. * * Generated from protobuf field optional int32 threads_per_core = 352611671; */ protected $threads_per_core = null; /** - * Turbo frequency mode to use for the instance. Supported modes include: * ALL_CORE_MAX Using empty string or not setting this field will use the platform-specific default turbo mode. + * Turbo frequency mode to use for the instance. + * Supported modes include: + * * ALL_CORE_MAX + * Using empty string or not setting this field will use the platform-specific + * default turbo mode. * * Generated from protobuf field optional string turbo_mode = 432965412; */ protected $turbo_mode = null; /** - * The number of physical cores to expose to an instance. Multiply by the number of threads per core to compute the total number of virtual CPUs to expose to the instance. If unset, the number of cores is inferred from the instance's nominal CPU count and the underlying platform's SMT width. + * The number of physical cores to expose to an instance. Multiply by + * the number of threads per core to compute the total number of virtual + * CPUs to expose to the instance. If unset, the number of cores is + * inferred from the instance's nominal CPU count and the underlying + * platform's SMT width. * * Generated from protobuf field optional int32 visible_core_count = 193198684; */ @@ -67,11 +82,22 @@ class AdvancedMachineFeatures extends \Google\Protobuf\Internal\Message * Type of Performance Monitoring Unit requested on instance. * Check the PerformanceMonitoringUnit enum for the list of possible values. * @type int $threads_per_core - * The number of threads per physical core. To disable simultaneous multithreading (SMT) set this to 1. If unset, the maximum number of threads supported per core by the underlying processor is assumed. + * The number of threads per physical core. To disable simultaneous + * multithreading (SMT) set this to 1. If unset, the maximum number + * of threads supported per core by the underlying processor is + * assumed. * @type string $turbo_mode - * Turbo frequency mode to use for the instance. Supported modes include: * ALL_CORE_MAX Using empty string or not setting this field will use the platform-specific default turbo mode. + * Turbo frequency mode to use for the instance. + * Supported modes include: + * * ALL_CORE_MAX + * Using empty string or not setting this field will use the platform-specific + * default turbo mode. * @type int $visible_core_count - * The number of physical cores to expose to an instance. Multiply by the number of threads per core to compute the total number of virtual CPUs to expose to the instance. If unset, the number of cores is inferred from the instance's nominal CPU count and the underlying platform's SMT width. + * The number of physical cores to expose to an instance. Multiply by + * the number of threads per core to compute the total number of virtual + * CPUs to expose to the instance. If unset, the number of cores is + * inferred from the instance's nominal CPU count and the underlying + * platform's SMT width. * } */ public function __construct($data = NULL) { @@ -190,7 +216,10 @@ public function setPerformanceMonitoringUnit($var) } /** - * The number of threads per physical core. To disable simultaneous multithreading (SMT) set this to 1. If unset, the maximum number of threads supported per core by the underlying processor is assumed. + * The number of threads per physical core. To disable simultaneous + * multithreading (SMT) set this to 1. If unset, the maximum number + * of threads supported per core by the underlying processor is + * assumed. * * Generated from protobuf field optional int32 threads_per_core = 352611671; * @return int @@ -211,7 +240,10 @@ public function clearThreadsPerCore() } /** - * The number of threads per physical core. To disable simultaneous multithreading (SMT) set this to 1. If unset, the maximum number of threads supported per core by the underlying processor is assumed. + * The number of threads per physical core. To disable simultaneous + * multithreading (SMT) set this to 1. If unset, the maximum number + * of threads supported per core by the underlying processor is + * assumed. * * Generated from protobuf field optional int32 threads_per_core = 352611671; * @param int $var @@ -226,7 +258,11 @@ public function setThreadsPerCore($var) } /** - * Turbo frequency mode to use for the instance. Supported modes include: * ALL_CORE_MAX Using empty string or not setting this field will use the platform-specific default turbo mode. + * Turbo frequency mode to use for the instance. + * Supported modes include: + * * ALL_CORE_MAX + * Using empty string or not setting this field will use the platform-specific + * default turbo mode. * * Generated from protobuf field optional string turbo_mode = 432965412; * @return string @@ -247,7 +283,11 @@ public function clearTurboMode() } /** - * Turbo frequency mode to use for the instance. Supported modes include: * ALL_CORE_MAX Using empty string or not setting this field will use the platform-specific default turbo mode. + * Turbo frequency mode to use for the instance. + * Supported modes include: + * * ALL_CORE_MAX + * Using empty string or not setting this field will use the platform-specific + * default turbo mode. * * Generated from protobuf field optional string turbo_mode = 432965412; * @param string $var @@ -262,7 +302,11 @@ public function setTurboMode($var) } /** - * The number of physical cores to expose to an instance. Multiply by the number of threads per core to compute the total number of virtual CPUs to expose to the instance. If unset, the number of cores is inferred from the instance's nominal CPU count and the underlying platform's SMT width. + * The number of physical cores to expose to an instance. Multiply by + * the number of threads per core to compute the total number of virtual + * CPUs to expose to the instance. If unset, the number of cores is + * inferred from the instance's nominal CPU count and the underlying + * platform's SMT width. * * Generated from protobuf field optional int32 visible_core_count = 193198684; * @return int @@ -283,7 +327,11 @@ public function clearVisibleCoreCount() } /** - * The number of physical cores to expose to an instance. Multiply by the number of threads per core to compute the total number of virtual CPUs to expose to the instance. If unset, the number of cores is inferred from the instance's nominal CPU count and the underlying platform's SMT width. + * The number of physical cores to expose to an instance. Multiply by + * the number of threads per core to compute the total number of virtual + * CPUs to expose to the instance. If unset, the number of cores is + * inferred from the instance's nominal CPU count and the underlying + * platform's SMT width. * * Generated from protobuf field optional int32 visible_core_count = 193198684; * @param int $var diff --git a/Compute/src/V1/AggregatedListAcceleratorTypesRequest.php b/Compute/src/V1/AggregatedListAcceleratorTypesRequest.php index f13d2263ebf9..e683a627c964 100644 --- a/Compute/src/V1/AggregatedListAcceleratorTypesRequest.php +++ b/Compute/src/V1/AggregatedListAcceleratorTypesRequest.php @@ -16,31 +16,98 @@ class AggregatedListAcceleratorTypesRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; */ protected $include_all_scopes = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -52,13 +119,18 @@ class AggregatedListAcceleratorTypesRequest extends \Google\Protobuf\Internal\Me */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ protected $return_partial_success = null; /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; */ @@ -84,21 +156,93 @@ public static function build(string $project): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type bool $include_all_scopes - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * @type int|string $service_project_number - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * } */ public function __construct($data = NULL) { @@ -107,7 +251,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -128,7 +319,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -143,7 +381,13 @@ public function setFilter($var) } /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; * @return bool @@ -164,7 +408,13 @@ public function clearIncludeAllScopes() } /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; * @param bool $var @@ -179,7 +429,11 @@ public function setIncludeAllScopes($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -200,7 +454,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -215,7 +473,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -236,7 +502,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -251,7 +525,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -272,7 +548,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -313,7 +591,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -334,7 +616,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var @@ -349,7 +635,8 @@ public function setReturnPartialSuccess($var) } /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; * @return int|string @@ -370,7 +657,8 @@ public function clearServiceProjectNumber() } /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; * @param int|string $var diff --git a/Compute/src/V1/AggregatedListAddressesRequest.php b/Compute/src/V1/AggregatedListAddressesRequest.php index c101c3ce5704..63adb314d4e8 100644 --- a/Compute/src/V1/AggregatedListAddressesRequest.php +++ b/Compute/src/V1/AggregatedListAddressesRequest.php @@ -16,31 +16,98 @@ class AggregatedListAddressesRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; */ protected $include_all_scopes = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -52,13 +119,18 @@ class AggregatedListAddressesRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ protected $return_partial_success = null; /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; */ @@ -84,21 +156,93 @@ public static function build(string $project): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type bool $include_all_scopes - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * @type int|string $service_project_number - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * } */ public function __construct($data = NULL) { @@ -107,7 +251,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -128,7 +319,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -143,7 +381,13 @@ public function setFilter($var) } /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; * @return bool @@ -164,7 +408,13 @@ public function clearIncludeAllScopes() } /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; * @param bool $var @@ -179,7 +429,11 @@ public function setIncludeAllScopes($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -200,7 +454,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -215,7 +473,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -236,7 +502,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -251,7 +525,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -272,7 +548,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -313,7 +591,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -334,7 +616,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var @@ -349,7 +635,8 @@ public function setReturnPartialSuccess($var) } /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; * @return int|string @@ -370,7 +657,8 @@ public function clearServiceProjectNumber() } /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; * @param int|string $var diff --git a/Compute/src/V1/AggregatedListAutoscalersRequest.php b/Compute/src/V1/AggregatedListAutoscalersRequest.php index 1ec5e79a77f2..0aca8e9200c6 100644 --- a/Compute/src/V1/AggregatedListAutoscalersRequest.php +++ b/Compute/src/V1/AggregatedListAutoscalersRequest.php @@ -16,31 +16,98 @@ class AggregatedListAutoscalersRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; */ protected $include_all_scopes = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -52,13 +119,18 @@ class AggregatedListAutoscalersRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ protected $return_partial_success = null; /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; */ @@ -84,21 +156,93 @@ public static function build(string $project): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type bool $include_all_scopes - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * @type int|string $service_project_number - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * } */ public function __construct($data = NULL) { @@ -107,7 +251,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -128,7 +319,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -143,7 +381,13 @@ public function setFilter($var) } /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; * @return bool @@ -164,7 +408,13 @@ public function clearIncludeAllScopes() } /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; * @param bool $var @@ -179,7 +429,11 @@ public function setIncludeAllScopes($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -200,7 +454,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -215,7 +473,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -236,7 +502,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -251,7 +525,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -272,7 +548,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -313,7 +591,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -334,7 +616,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var @@ -349,7 +635,8 @@ public function setReturnPartialSuccess($var) } /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; * @return int|string @@ -370,7 +657,8 @@ public function clearServiceProjectNumber() } /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; * @param int|string $var diff --git a/Compute/src/V1/AggregatedListBackendServicesRequest.php b/Compute/src/V1/AggregatedListBackendServicesRequest.php index 1309a9a1d63d..962cacf69fce 100644 --- a/Compute/src/V1/AggregatedListBackendServicesRequest.php +++ b/Compute/src/V1/AggregatedListBackendServicesRequest.php @@ -16,31 +16,98 @@ class AggregatedListBackendServicesRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; */ protected $include_all_scopes = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -52,13 +119,18 @@ class AggregatedListBackendServicesRequest extends \Google\Protobuf\Internal\Mes */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ protected $return_partial_success = null; /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; */ @@ -84,21 +156,93 @@ public static function build(string $project): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type bool $include_all_scopes - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Name of the project scoping this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * @type int|string $service_project_number - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * } */ public function __construct($data = NULL) { @@ -107,7 +251,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -128,7 +319,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -143,7 +381,13 @@ public function setFilter($var) } /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; * @return bool @@ -164,7 +408,13 @@ public function clearIncludeAllScopes() } /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; * @param bool $var @@ -179,7 +429,11 @@ public function setIncludeAllScopes($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -200,7 +454,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -215,7 +473,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -236,7 +502,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -251,7 +525,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -272,7 +548,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -313,7 +591,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -334,7 +616,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var @@ -349,7 +635,8 @@ public function setReturnPartialSuccess($var) } /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; * @return int|string @@ -370,7 +657,8 @@ public function clearServiceProjectNumber() } /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; * @param int|string $var diff --git a/Compute/src/V1/AggregatedListDiskTypesRequest.php b/Compute/src/V1/AggregatedListDiskTypesRequest.php index 4862fab08c07..6375e65527c5 100644 --- a/Compute/src/V1/AggregatedListDiskTypesRequest.php +++ b/Compute/src/V1/AggregatedListDiskTypesRequest.php @@ -16,31 +16,98 @@ class AggregatedListDiskTypesRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; */ protected $include_all_scopes = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -52,13 +119,18 @@ class AggregatedListDiskTypesRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ protected $return_partial_success = null; /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; */ @@ -84,21 +156,93 @@ public static function build(string $project): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type bool $include_all_scopes - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * @type int|string $service_project_number - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * } */ public function __construct($data = NULL) { @@ -107,7 +251,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -128,7 +319,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -143,7 +381,13 @@ public function setFilter($var) } /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; * @return bool @@ -164,7 +408,13 @@ public function clearIncludeAllScopes() } /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; * @param bool $var @@ -179,7 +429,11 @@ public function setIncludeAllScopes($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -200,7 +454,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -215,7 +473,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -236,7 +502,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -251,7 +525,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -272,7 +548,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -313,7 +591,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -334,7 +616,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var @@ -349,7 +635,8 @@ public function setReturnPartialSuccess($var) } /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; * @return int|string @@ -370,7 +657,8 @@ public function clearServiceProjectNumber() } /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; * @param int|string $var diff --git a/Compute/src/V1/AggregatedListDisksRequest.php b/Compute/src/V1/AggregatedListDisksRequest.php index a73f0e5d4f7b..bb117fac0023 100644 --- a/Compute/src/V1/AggregatedListDisksRequest.php +++ b/Compute/src/V1/AggregatedListDisksRequest.php @@ -16,31 +16,98 @@ class AggregatedListDisksRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; */ protected $include_all_scopes = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -52,13 +119,18 @@ class AggregatedListDisksRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ protected $return_partial_success = null; /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; */ @@ -84,21 +156,93 @@ public static function build(string $project): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type bool $include_all_scopes - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * @type int|string $service_project_number - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * } */ public function __construct($data = NULL) { @@ -107,7 +251,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -128,7 +319,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -143,7 +381,13 @@ public function setFilter($var) } /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; * @return bool @@ -164,7 +408,13 @@ public function clearIncludeAllScopes() } /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; * @param bool $var @@ -179,7 +429,11 @@ public function setIncludeAllScopes($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -200,7 +454,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -215,7 +473,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -236,7 +502,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -251,7 +525,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -272,7 +548,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -313,7 +591,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -334,7 +616,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var @@ -349,7 +635,8 @@ public function setReturnPartialSuccess($var) } /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; * @return int|string @@ -370,7 +657,8 @@ public function clearServiceProjectNumber() } /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; * @param int|string $var diff --git a/Compute/src/V1/AggregatedListForwardingRulesRequest.php b/Compute/src/V1/AggregatedListForwardingRulesRequest.php index f2784259d846..175cb4225792 100644 --- a/Compute/src/V1/AggregatedListForwardingRulesRequest.php +++ b/Compute/src/V1/AggregatedListForwardingRulesRequest.php @@ -16,31 +16,98 @@ class AggregatedListForwardingRulesRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; */ protected $include_all_scopes = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -52,13 +119,18 @@ class AggregatedListForwardingRulesRequest extends \Google\Protobuf\Internal\Mes */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ protected $return_partial_success = null; /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; */ @@ -84,21 +156,93 @@ public static function build(string $project): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type bool $include_all_scopes - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * @type int|string $service_project_number - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * } */ public function __construct($data = NULL) { @@ -107,7 +251,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -128,7 +319,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -143,7 +381,13 @@ public function setFilter($var) } /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; * @return bool @@ -164,7 +408,13 @@ public function clearIncludeAllScopes() } /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; * @param bool $var @@ -179,7 +429,11 @@ public function setIncludeAllScopes($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -200,7 +454,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -215,7 +473,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -236,7 +502,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -251,7 +525,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -272,7 +548,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -313,7 +591,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -334,7 +616,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var @@ -349,7 +635,8 @@ public function setReturnPartialSuccess($var) } /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; * @return int|string @@ -370,7 +657,8 @@ public function clearServiceProjectNumber() } /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; * @param int|string $var diff --git a/Compute/src/V1/AggregatedListFutureReservationsRequest.php b/Compute/src/V1/AggregatedListFutureReservationsRequest.php new file mode 100644 index 000000000000..a8018d97e34f --- /dev/null +++ b/Compute/src/V1/AggregatedListFutureReservationsRequest.php @@ -0,0 +1,676 @@ +google.cloud.compute.v1.AggregatedListFutureReservationsRequest + */ +class AggregatedListFutureReservationsRequest extends \Google\Protobuf\Internal\Message +{ + /** + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. + * + * Generated from protobuf field optional string filter = 336120696; + */ + protected $filter = null; + /** + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. + * + * Generated from protobuf field optional bool include_all_scopes = 391327988; + */ + protected $include_all_scopes = null; + /** + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) + * + * Generated from protobuf field optional uint32 max_results = 54715419; + */ + protected $max_results = null; + /** + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. + * + * Generated from protobuf field optional string order_by = 160562920; + */ + protected $order_by = null; + /** + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. + * + * Generated from protobuf field optional string page_token = 19994697; + */ + protected $page_token = null; + /** + * Project ID for this request. + * + * Generated from protobuf field string project = 227560217 [(.google.api.field_behavior) = REQUIRED]; + */ + protected $project = ''; + /** + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. + * + * Generated from protobuf field optional bool return_partial_success = 517198390; + */ + protected $return_partial_success = null; + /** + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. + * + * Generated from protobuf field optional int64 service_project_number = 316757497; + */ + protected $service_project_number = null; + + /** + * @param string $project Project ID for this request. + * + * @return \Google\Cloud\Compute\V1\AggregatedListFutureReservationsRequest + * + * @experimental + */ + public static function build(string $project): self + { + return (new self()) + ->setProject($project); + } + + /** + * Constructor. + * + * @param array $data { + * Optional. Data for populating the Message object. + * + * @type string $filter + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. + * @type bool $include_all_scopes + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. + * @type int $max_results + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) + * @type string $order_by + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. + * @type string $page_token + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. + * @type string $project + * Project ID for this request. + * @type bool $return_partial_success + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. + * @type int|string $service_project_number + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. + * } + */ + public function __construct($data = NULL) { + \GPBMetadata\Google\Cloud\Compute\V1\Compute::initOnce(); + parent::__construct($data); + } + + /** + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. + * + * Generated from protobuf field optional string filter = 336120696; + * @return string + */ + public function getFilter() + { + return isset($this->filter) ? $this->filter : ''; + } + + public function hasFilter() + { + return isset($this->filter); + } + + public function clearFilter() + { + unset($this->filter); + } + + /** + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. + * + * Generated from protobuf field optional string filter = 336120696; + * @param string $var + * @return $this + */ + public function setFilter($var) + { + GPBUtil::checkString($var, True); + $this->filter = $var; + + return $this; + } + + /** + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. + * + * Generated from protobuf field optional bool include_all_scopes = 391327988; + * @return bool + */ + public function getIncludeAllScopes() + { + return isset($this->include_all_scopes) ? $this->include_all_scopes : false; + } + + public function hasIncludeAllScopes() + { + return isset($this->include_all_scopes); + } + + public function clearIncludeAllScopes() + { + unset($this->include_all_scopes); + } + + /** + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. + * + * Generated from protobuf field optional bool include_all_scopes = 391327988; + * @param bool $var + * @return $this + */ + public function setIncludeAllScopes($var) + { + GPBUtil::checkBool($var); + $this->include_all_scopes = $var; + + return $this; + } + + /** + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) + * + * Generated from protobuf field optional uint32 max_results = 54715419; + * @return int + */ + public function getMaxResults() + { + return isset($this->max_results) ? $this->max_results : 0; + } + + public function hasMaxResults() + { + return isset($this->max_results); + } + + public function clearMaxResults() + { + unset($this->max_results); + } + + /** + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) + * + * Generated from protobuf field optional uint32 max_results = 54715419; + * @param int $var + * @return $this + */ + public function setMaxResults($var) + { + GPBUtil::checkUint32($var); + $this->max_results = $var; + + return $this; + } + + /** + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. + * + * Generated from protobuf field optional string order_by = 160562920; + * @return string + */ + public function getOrderBy() + { + return isset($this->order_by) ? $this->order_by : ''; + } + + public function hasOrderBy() + { + return isset($this->order_by); + } + + public function clearOrderBy() + { + unset($this->order_by); + } + + /** + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. + * + * Generated from protobuf field optional string order_by = 160562920; + * @param string $var + * @return $this + */ + public function setOrderBy($var) + { + GPBUtil::checkString($var, True); + $this->order_by = $var; + + return $this; + } + + /** + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. + * + * Generated from protobuf field optional string page_token = 19994697; + * @return string + */ + public function getPageToken() + { + return isset($this->page_token) ? $this->page_token : ''; + } + + public function hasPageToken() + { + return isset($this->page_token); + } + + public function clearPageToken() + { + unset($this->page_token); + } + + /** + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. + * + * Generated from protobuf field optional string page_token = 19994697; + * @param string $var + * @return $this + */ + public function setPageToken($var) + { + GPBUtil::checkString($var, True); + $this->page_token = $var; + + return $this; + } + + /** + * Project ID for this request. + * + * Generated from protobuf field string project = 227560217 [(.google.api.field_behavior) = REQUIRED]; + * @return string + */ + public function getProject() + { + return $this->project; + } + + /** + * Project ID for this request. + * + * Generated from protobuf field string project = 227560217 [(.google.api.field_behavior) = REQUIRED]; + * @param string $var + * @return $this + */ + public function setProject($var) + { + GPBUtil::checkString($var, True); + $this->project = $var; + + return $this; + } + + /** + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. + * + * Generated from protobuf field optional bool return_partial_success = 517198390; + * @return bool + */ + public function getReturnPartialSuccess() + { + return isset($this->return_partial_success) ? $this->return_partial_success : false; + } + + public function hasReturnPartialSuccess() + { + return isset($this->return_partial_success); + } + + public function clearReturnPartialSuccess() + { + unset($this->return_partial_success); + } + + /** + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. + * + * Generated from protobuf field optional bool return_partial_success = 517198390; + * @param bool $var + * @return $this + */ + public function setReturnPartialSuccess($var) + { + GPBUtil::checkBool($var); + $this->return_partial_success = $var; + + return $this; + } + + /** + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. + * + * Generated from protobuf field optional int64 service_project_number = 316757497; + * @return int|string + */ + public function getServiceProjectNumber() + { + return isset($this->service_project_number) ? $this->service_project_number : 0; + } + + public function hasServiceProjectNumber() + { + return isset($this->service_project_number); + } + + public function clearServiceProjectNumber() + { + unset($this->service_project_number); + } + + /** + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. + * + * Generated from protobuf field optional int64 service_project_number = 316757497; + * @param int|string $var + * @return $this + */ + public function setServiceProjectNumber($var) + { + GPBUtil::checkInt64($var); + $this->service_project_number = $var; + + return $this; + } + +} + diff --git a/Compute/src/V1/AggregatedListGlobalOperationsRequest.php b/Compute/src/V1/AggregatedListGlobalOperationsRequest.php index c93d36c9c9d7..59f95ceb13d8 100644 --- a/Compute/src/V1/AggregatedListGlobalOperationsRequest.php +++ b/Compute/src/V1/AggregatedListGlobalOperationsRequest.php @@ -16,31 +16,98 @@ class AggregatedListGlobalOperationsRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; */ protected $include_all_scopes = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -52,13 +119,18 @@ class AggregatedListGlobalOperationsRequest extends \Google\Protobuf\Internal\Me */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ protected $return_partial_success = null; /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; */ @@ -84,21 +156,93 @@ public static function build(string $project): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type bool $include_all_scopes - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * @type int|string $service_project_number - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * } */ public function __construct($data = NULL) { @@ -107,7 +251,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -128,7 +319,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -143,7 +381,13 @@ public function setFilter($var) } /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; * @return bool @@ -164,7 +408,13 @@ public function clearIncludeAllScopes() } /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; * @param bool $var @@ -179,7 +429,11 @@ public function setIncludeAllScopes($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -200,7 +454,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -215,7 +473,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -236,7 +502,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -251,7 +525,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -272,7 +548,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -313,7 +591,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -334,7 +616,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var @@ -349,7 +635,8 @@ public function setReturnPartialSuccess($var) } /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; * @return int|string @@ -370,7 +657,8 @@ public function clearServiceProjectNumber() } /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; * @param int|string $var diff --git a/Compute/src/V1/AggregatedListHealthChecksRequest.php b/Compute/src/V1/AggregatedListHealthChecksRequest.php index ec11ea6e303a..69b0cdf3f8a1 100644 --- a/Compute/src/V1/AggregatedListHealthChecksRequest.php +++ b/Compute/src/V1/AggregatedListHealthChecksRequest.php @@ -16,31 +16,98 @@ class AggregatedListHealthChecksRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; */ protected $include_all_scopes = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -52,13 +119,18 @@ class AggregatedListHealthChecksRequest extends \Google\Protobuf\Internal\Messag */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ protected $return_partial_success = null; /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; */ @@ -84,21 +156,93 @@ public static function build(string $project): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type bool $include_all_scopes - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Name of the project scoping this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * @type int|string $service_project_number - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * } */ public function __construct($data = NULL) { @@ -107,7 +251,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -128,7 +319,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -143,7 +381,13 @@ public function setFilter($var) } /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; * @return bool @@ -164,7 +408,13 @@ public function clearIncludeAllScopes() } /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; * @param bool $var @@ -179,7 +429,11 @@ public function setIncludeAllScopes($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -200,7 +454,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -215,7 +473,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -236,7 +502,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -251,7 +525,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -272,7 +548,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -313,7 +591,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -334,7 +616,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var @@ -349,7 +635,8 @@ public function setReturnPartialSuccess($var) } /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; * @return int|string @@ -370,7 +657,8 @@ public function clearServiceProjectNumber() } /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; * @param int|string $var diff --git a/Compute/src/V1/AggregatedListInstanceGroupManagersRequest.php b/Compute/src/V1/AggregatedListInstanceGroupManagersRequest.php index edf47bf1aa28..19bf560f370f 100644 --- a/Compute/src/V1/AggregatedListInstanceGroupManagersRequest.php +++ b/Compute/src/V1/AggregatedListInstanceGroupManagersRequest.php @@ -16,31 +16,98 @@ class AggregatedListInstanceGroupManagersRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; */ protected $include_all_scopes = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -52,13 +119,18 @@ class AggregatedListInstanceGroupManagersRequest extends \Google\Protobuf\Intern */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ protected $return_partial_success = null; /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; */ @@ -84,21 +156,93 @@ public static function build(string $project): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type bool $include_all_scopes - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * @type int|string $service_project_number - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * } */ public function __construct($data = NULL) { @@ -107,7 +251,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -128,7 +319,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -143,7 +381,13 @@ public function setFilter($var) } /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; * @return bool @@ -164,7 +408,13 @@ public function clearIncludeAllScopes() } /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; * @param bool $var @@ -179,7 +429,11 @@ public function setIncludeAllScopes($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -200,7 +454,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -215,7 +473,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -236,7 +502,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -251,7 +525,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -272,7 +548,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -313,7 +591,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -334,7 +616,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var @@ -349,7 +635,8 @@ public function setReturnPartialSuccess($var) } /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; * @return int|string @@ -370,7 +657,8 @@ public function clearServiceProjectNumber() } /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; * @param int|string $var diff --git a/Compute/src/V1/AggregatedListInstanceGroupsRequest.php b/Compute/src/V1/AggregatedListInstanceGroupsRequest.php index 56f8a50d2802..5dc9e5136548 100644 --- a/Compute/src/V1/AggregatedListInstanceGroupsRequest.php +++ b/Compute/src/V1/AggregatedListInstanceGroupsRequest.php @@ -16,31 +16,98 @@ class AggregatedListInstanceGroupsRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; */ protected $include_all_scopes = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -52,13 +119,18 @@ class AggregatedListInstanceGroupsRequest extends \Google\Protobuf\Internal\Mess */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ protected $return_partial_success = null; /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; */ @@ -84,21 +156,93 @@ public static function build(string $project): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type bool $include_all_scopes - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * @type int|string $service_project_number - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * } */ public function __construct($data = NULL) { @@ -107,7 +251,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -128,7 +319,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -143,7 +381,13 @@ public function setFilter($var) } /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; * @return bool @@ -164,7 +408,13 @@ public function clearIncludeAllScopes() } /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; * @param bool $var @@ -179,7 +429,11 @@ public function setIncludeAllScopes($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -200,7 +454,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -215,7 +473,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -236,7 +502,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -251,7 +525,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -272,7 +548,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -313,7 +591,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -334,7 +616,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var @@ -349,7 +635,8 @@ public function setReturnPartialSuccess($var) } /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; * @return int|string @@ -370,7 +657,8 @@ public function clearServiceProjectNumber() } /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; * @param int|string $var diff --git a/Compute/src/V1/AggregatedListInstanceTemplatesRequest.php b/Compute/src/V1/AggregatedListInstanceTemplatesRequest.php index 3eb9e5938445..04850f362e6a 100644 --- a/Compute/src/V1/AggregatedListInstanceTemplatesRequest.php +++ b/Compute/src/V1/AggregatedListInstanceTemplatesRequest.php @@ -16,31 +16,98 @@ class AggregatedListInstanceTemplatesRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; */ protected $include_all_scopes = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -52,13 +119,18 @@ class AggregatedListInstanceTemplatesRequest extends \Google\Protobuf\Internal\M */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ protected $return_partial_success = null; /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; */ @@ -84,21 +156,93 @@ public static function build(string $project): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type bool $include_all_scopes - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Name of the project scoping this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * @type int|string $service_project_number - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * } */ public function __construct($data = NULL) { @@ -107,7 +251,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -128,7 +319,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -143,7 +381,13 @@ public function setFilter($var) } /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; * @return bool @@ -164,7 +408,13 @@ public function clearIncludeAllScopes() } /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; * @param bool $var @@ -179,7 +429,11 @@ public function setIncludeAllScopes($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -200,7 +454,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -215,7 +473,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -236,7 +502,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -251,7 +525,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -272,7 +548,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -313,7 +591,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -334,7 +616,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var @@ -349,7 +635,8 @@ public function setReturnPartialSuccess($var) } /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; * @return int|string @@ -370,7 +657,8 @@ public function clearServiceProjectNumber() } /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; * @param int|string $var diff --git a/Compute/src/V1/AggregatedListInstancesRequest.php b/Compute/src/V1/AggregatedListInstancesRequest.php index b6bb5cf1b790..f97bbafd75b7 100644 --- a/Compute/src/V1/AggregatedListInstancesRequest.php +++ b/Compute/src/V1/AggregatedListInstancesRequest.php @@ -16,31 +16,98 @@ class AggregatedListInstancesRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; */ protected $include_all_scopes = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -52,13 +119,18 @@ class AggregatedListInstancesRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ protected $return_partial_success = null; /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; */ @@ -84,21 +156,93 @@ public static function build(string $project): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type bool $include_all_scopes - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * @type int|string $service_project_number - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * } */ public function __construct($data = NULL) { @@ -107,7 +251,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -128,7 +319,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -143,7 +381,13 @@ public function setFilter($var) } /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; * @return bool @@ -164,7 +408,13 @@ public function clearIncludeAllScopes() } /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; * @param bool $var @@ -179,7 +429,11 @@ public function setIncludeAllScopes($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -200,7 +454,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -215,7 +473,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -236,7 +502,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -251,7 +525,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -272,7 +548,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -313,7 +591,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -334,7 +616,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var @@ -349,7 +635,8 @@ public function setReturnPartialSuccess($var) } /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; * @return int|string @@ -370,7 +657,8 @@ public function clearServiceProjectNumber() } /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; * @param int|string $var diff --git a/Compute/src/V1/AggregatedListInstantSnapshotsRequest.php b/Compute/src/V1/AggregatedListInstantSnapshotsRequest.php index 558031241b5f..1df52787cada 100644 --- a/Compute/src/V1/AggregatedListInstantSnapshotsRequest.php +++ b/Compute/src/V1/AggregatedListInstantSnapshotsRequest.php @@ -16,31 +16,98 @@ class AggregatedListInstantSnapshotsRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; */ protected $include_all_scopes = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -52,13 +119,18 @@ class AggregatedListInstantSnapshotsRequest extends \Google\Protobuf\Internal\Me */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ protected $return_partial_success = null; /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; */ @@ -84,21 +156,93 @@ public static function build(string $project): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type bool $include_all_scopes - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * @type int|string $service_project_number - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * } */ public function __construct($data = NULL) { @@ -107,7 +251,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -128,7 +319,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -143,7 +381,13 @@ public function setFilter($var) } /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; * @return bool @@ -164,7 +408,13 @@ public function clearIncludeAllScopes() } /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; * @param bool $var @@ -179,7 +429,11 @@ public function setIncludeAllScopes($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -200,7 +454,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -215,7 +473,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -236,7 +502,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -251,7 +525,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -272,7 +548,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -313,7 +591,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -334,7 +616,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var @@ -349,7 +635,8 @@ public function setReturnPartialSuccess($var) } /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; * @return int|string @@ -370,7 +657,8 @@ public function clearServiceProjectNumber() } /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; * @param int|string $var diff --git a/Compute/src/V1/AggregatedListInterconnectAttachmentsRequest.php b/Compute/src/V1/AggregatedListInterconnectAttachmentsRequest.php index be138c42e9ea..3820f3f34d9c 100644 --- a/Compute/src/V1/AggregatedListInterconnectAttachmentsRequest.php +++ b/Compute/src/V1/AggregatedListInterconnectAttachmentsRequest.php @@ -16,31 +16,98 @@ class AggregatedListInterconnectAttachmentsRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; */ protected $include_all_scopes = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -52,13 +119,18 @@ class AggregatedListInterconnectAttachmentsRequest extends \Google\Protobuf\Inte */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ protected $return_partial_success = null; /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; */ @@ -84,21 +156,93 @@ public static function build(string $project): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type bool $include_all_scopes - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * @type int|string $service_project_number - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * } */ public function __construct($data = NULL) { @@ -107,7 +251,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -128,7 +319,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -143,7 +381,13 @@ public function setFilter($var) } /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; * @return bool @@ -164,7 +408,13 @@ public function clearIncludeAllScopes() } /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; * @param bool $var @@ -179,7 +429,11 @@ public function setIncludeAllScopes($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -200,7 +454,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -215,7 +473,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -236,7 +502,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -251,7 +525,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -272,7 +548,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -313,7 +591,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -334,7 +616,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var @@ -349,7 +635,8 @@ public function setReturnPartialSuccess($var) } /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; * @return int|string @@ -370,7 +657,8 @@ public function clearServiceProjectNumber() } /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; * @param int|string $var diff --git a/Compute/src/V1/AggregatedListMachineTypesRequest.php b/Compute/src/V1/AggregatedListMachineTypesRequest.php index abb58ff1b5ab..90f510686c54 100644 --- a/Compute/src/V1/AggregatedListMachineTypesRequest.php +++ b/Compute/src/V1/AggregatedListMachineTypesRequest.php @@ -16,31 +16,98 @@ class AggregatedListMachineTypesRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; */ protected $include_all_scopes = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -52,13 +119,18 @@ class AggregatedListMachineTypesRequest extends \Google\Protobuf\Internal\Messag */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ protected $return_partial_success = null; /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; */ @@ -84,21 +156,93 @@ public static function build(string $project): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type bool $include_all_scopes - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * @type int|string $service_project_number - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * } */ public function __construct($data = NULL) { @@ -107,7 +251,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -128,7 +319,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -143,7 +381,13 @@ public function setFilter($var) } /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; * @return bool @@ -164,7 +408,13 @@ public function clearIncludeAllScopes() } /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; * @param bool $var @@ -179,7 +429,11 @@ public function setIncludeAllScopes($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -200,7 +454,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -215,7 +473,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -236,7 +502,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -251,7 +525,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -272,7 +548,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -313,7 +591,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -334,7 +616,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var @@ -349,7 +635,8 @@ public function setReturnPartialSuccess($var) } /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; * @return int|string @@ -370,7 +657,8 @@ public function clearServiceProjectNumber() } /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; * @param int|string $var diff --git a/Compute/src/V1/AggregatedListNetworkAttachmentsRequest.php b/Compute/src/V1/AggregatedListNetworkAttachmentsRequest.php index 82f010eb2e8f..9797269448d9 100644 --- a/Compute/src/V1/AggregatedListNetworkAttachmentsRequest.php +++ b/Compute/src/V1/AggregatedListNetworkAttachmentsRequest.php @@ -16,31 +16,98 @@ class AggregatedListNetworkAttachmentsRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; */ protected $include_all_scopes = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -52,13 +119,18 @@ class AggregatedListNetworkAttachmentsRequest extends \Google\Protobuf\Internal\ */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ protected $return_partial_success = null; /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; */ @@ -84,21 +156,93 @@ public static function build(string $project): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type bool $include_all_scopes - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * @type int|string $service_project_number - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * } */ public function __construct($data = NULL) { @@ -107,7 +251,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -128,7 +319,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -143,7 +381,13 @@ public function setFilter($var) } /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; * @return bool @@ -164,7 +408,13 @@ public function clearIncludeAllScopes() } /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; * @param bool $var @@ -179,7 +429,11 @@ public function setIncludeAllScopes($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -200,7 +454,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -215,7 +473,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -236,7 +502,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -251,7 +525,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -272,7 +548,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -313,7 +591,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -334,7 +616,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var @@ -349,7 +635,8 @@ public function setReturnPartialSuccess($var) } /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; * @return int|string @@ -370,7 +657,8 @@ public function clearServiceProjectNumber() } /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; * @param int|string $var diff --git a/Compute/src/V1/AggregatedListNetworkEdgeSecurityServicesRequest.php b/Compute/src/V1/AggregatedListNetworkEdgeSecurityServicesRequest.php index 11d3c5597bf4..143bb8dc5455 100644 --- a/Compute/src/V1/AggregatedListNetworkEdgeSecurityServicesRequest.php +++ b/Compute/src/V1/AggregatedListNetworkEdgeSecurityServicesRequest.php @@ -16,31 +16,98 @@ class AggregatedListNetworkEdgeSecurityServicesRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; */ protected $include_all_scopes = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -52,13 +119,18 @@ class AggregatedListNetworkEdgeSecurityServicesRequest extends \Google\Protobuf\ */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ protected $return_partial_success = null; /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; */ @@ -84,21 +156,93 @@ public static function build(string $project): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type bool $include_all_scopes - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Name of the project scoping this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * @type int|string $service_project_number - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * } */ public function __construct($data = NULL) { @@ -107,7 +251,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -128,7 +319,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -143,7 +381,13 @@ public function setFilter($var) } /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; * @return bool @@ -164,7 +408,13 @@ public function clearIncludeAllScopes() } /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; * @param bool $var @@ -179,7 +429,11 @@ public function setIncludeAllScopes($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -200,7 +454,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -215,7 +473,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -236,7 +502,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -251,7 +525,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -272,7 +548,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -313,7 +591,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -334,7 +616,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var @@ -349,7 +635,8 @@ public function setReturnPartialSuccess($var) } /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; * @return int|string @@ -370,7 +657,8 @@ public function clearServiceProjectNumber() } /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; * @param int|string $var diff --git a/Compute/src/V1/AggregatedListNetworkEndpointGroupsRequest.php b/Compute/src/V1/AggregatedListNetworkEndpointGroupsRequest.php index dfa580dd58ba..f6817ce10218 100644 --- a/Compute/src/V1/AggregatedListNetworkEndpointGroupsRequest.php +++ b/Compute/src/V1/AggregatedListNetworkEndpointGroupsRequest.php @@ -16,31 +16,98 @@ class AggregatedListNetworkEndpointGroupsRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; */ protected $include_all_scopes = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -52,13 +119,18 @@ class AggregatedListNetworkEndpointGroupsRequest extends \Google\Protobuf\Intern */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ protected $return_partial_success = null; /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; */ @@ -84,21 +156,93 @@ public static function build(string $project): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type bool $include_all_scopes - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * @type int|string $service_project_number - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * } */ public function __construct($data = NULL) { @@ -107,7 +251,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -128,7 +319,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -143,7 +381,13 @@ public function setFilter($var) } /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; * @return bool @@ -164,7 +408,13 @@ public function clearIncludeAllScopes() } /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; * @param bool $var @@ -179,7 +429,11 @@ public function setIncludeAllScopes($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -200,7 +454,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -215,7 +473,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -236,7 +502,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -251,7 +525,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -272,7 +548,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -313,7 +591,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -334,7 +616,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var @@ -349,7 +635,8 @@ public function setReturnPartialSuccess($var) } /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; * @return int|string @@ -370,7 +657,8 @@ public function clearServiceProjectNumber() } /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; * @param int|string $var diff --git a/Compute/src/V1/AggregatedListNetworkFirewallPoliciesRequest.php b/Compute/src/V1/AggregatedListNetworkFirewallPoliciesRequest.php index e88069ddb46e..30ea4183be3e 100644 --- a/Compute/src/V1/AggregatedListNetworkFirewallPoliciesRequest.php +++ b/Compute/src/V1/AggregatedListNetworkFirewallPoliciesRequest.php @@ -16,31 +16,98 @@ class AggregatedListNetworkFirewallPoliciesRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; */ protected $include_all_scopes = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -52,13 +119,18 @@ class AggregatedListNetworkFirewallPoliciesRequest extends \Google\Protobuf\Inte */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ protected $return_partial_success = null; /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; */ @@ -84,21 +156,93 @@ public static function build(string $project): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type bool $include_all_scopes - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * @type int|string $service_project_number - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * } */ public function __construct($data = NULL) { @@ -107,7 +251,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -128,7 +319,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -143,7 +381,13 @@ public function setFilter($var) } /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; * @return bool @@ -164,7 +408,13 @@ public function clearIncludeAllScopes() } /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; * @param bool $var @@ -179,7 +429,11 @@ public function setIncludeAllScopes($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -200,7 +454,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -215,7 +473,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -236,7 +502,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -251,7 +525,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -272,7 +548,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -313,7 +591,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -334,7 +616,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var @@ -349,7 +635,8 @@ public function setReturnPartialSuccess($var) } /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; * @return int|string @@ -370,7 +657,8 @@ public function clearServiceProjectNumber() } /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; * @param int|string $var diff --git a/Compute/src/V1/AggregatedListNodeGroupsRequest.php b/Compute/src/V1/AggregatedListNodeGroupsRequest.php index 83e4a758d879..571d2bb0ade3 100644 --- a/Compute/src/V1/AggregatedListNodeGroupsRequest.php +++ b/Compute/src/V1/AggregatedListNodeGroupsRequest.php @@ -16,31 +16,98 @@ class AggregatedListNodeGroupsRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; */ protected $include_all_scopes = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -52,13 +119,18 @@ class AggregatedListNodeGroupsRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ protected $return_partial_success = null; /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; */ @@ -84,21 +156,93 @@ public static function build(string $project): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type bool $include_all_scopes - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * @type int|string $service_project_number - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * } */ public function __construct($data = NULL) { @@ -107,7 +251,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -128,7 +319,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -143,7 +381,13 @@ public function setFilter($var) } /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; * @return bool @@ -164,7 +408,13 @@ public function clearIncludeAllScopes() } /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; * @param bool $var @@ -179,7 +429,11 @@ public function setIncludeAllScopes($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -200,7 +454,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -215,7 +473,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -236,7 +502,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -251,7 +525,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -272,7 +548,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -313,7 +591,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -334,7 +616,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var @@ -349,7 +635,8 @@ public function setReturnPartialSuccess($var) } /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; * @return int|string @@ -370,7 +657,8 @@ public function clearServiceProjectNumber() } /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; * @param int|string $var diff --git a/Compute/src/V1/AggregatedListNodeTemplatesRequest.php b/Compute/src/V1/AggregatedListNodeTemplatesRequest.php index 1dc616bb5b1b..9082aad64dc2 100644 --- a/Compute/src/V1/AggregatedListNodeTemplatesRequest.php +++ b/Compute/src/V1/AggregatedListNodeTemplatesRequest.php @@ -16,31 +16,98 @@ class AggregatedListNodeTemplatesRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; */ protected $include_all_scopes = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -52,13 +119,18 @@ class AggregatedListNodeTemplatesRequest extends \Google\Protobuf\Internal\Messa */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ protected $return_partial_success = null; /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; */ @@ -84,21 +156,93 @@ public static function build(string $project): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type bool $include_all_scopes - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * @type int|string $service_project_number - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * } */ public function __construct($data = NULL) { @@ -107,7 +251,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -128,7 +319,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -143,7 +381,13 @@ public function setFilter($var) } /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; * @return bool @@ -164,7 +408,13 @@ public function clearIncludeAllScopes() } /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; * @param bool $var @@ -179,7 +429,11 @@ public function setIncludeAllScopes($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -200,7 +454,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -215,7 +473,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -236,7 +502,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -251,7 +525,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -272,7 +548,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -313,7 +591,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -334,7 +616,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var @@ -349,7 +635,8 @@ public function setReturnPartialSuccess($var) } /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; * @return int|string @@ -370,7 +657,8 @@ public function clearServiceProjectNumber() } /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; * @param int|string $var diff --git a/Compute/src/V1/AggregatedListNodeTypesRequest.php b/Compute/src/V1/AggregatedListNodeTypesRequest.php index 7ed07a3ef260..4847b37ec4c2 100644 --- a/Compute/src/V1/AggregatedListNodeTypesRequest.php +++ b/Compute/src/V1/AggregatedListNodeTypesRequest.php @@ -16,31 +16,98 @@ class AggregatedListNodeTypesRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; */ protected $include_all_scopes = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -52,13 +119,18 @@ class AggregatedListNodeTypesRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ protected $return_partial_success = null; /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; */ @@ -84,21 +156,93 @@ public static function build(string $project): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type bool $include_all_scopes - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * @type int|string $service_project_number - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * } */ public function __construct($data = NULL) { @@ -107,7 +251,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -128,7 +319,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -143,7 +381,13 @@ public function setFilter($var) } /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; * @return bool @@ -164,7 +408,13 @@ public function clearIncludeAllScopes() } /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; * @param bool $var @@ -179,7 +429,11 @@ public function setIncludeAllScopes($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -200,7 +454,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -215,7 +473,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -236,7 +502,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -251,7 +525,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -272,7 +548,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -313,7 +591,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -334,7 +616,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var @@ -349,7 +635,8 @@ public function setReturnPartialSuccess($var) } /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; * @return int|string @@ -370,7 +657,8 @@ public function clearServiceProjectNumber() } /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; * @param int|string $var diff --git a/Compute/src/V1/AggregatedListPacketMirroringsRequest.php b/Compute/src/V1/AggregatedListPacketMirroringsRequest.php index d3a3bef11799..890e37c3f4f9 100644 --- a/Compute/src/V1/AggregatedListPacketMirroringsRequest.php +++ b/Compute/src/V1/AggregatedListPacketMirroringsRequest.php @@ -16,31 +16,98 @@ class AggregatedListPacketMirroringsRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; */ protected $include_all_scopes = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -52,13 +119,18 @@ class AggregatedListPacketMirroringsRequest extends \Google\Protobuf\Internal\Me */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ protected $return_partial_success = null; /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; */ @@ -84,21 +156,93 @@ public static function build(string $project): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type bool $include_all_scopes - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * @type int|string $service_project_number - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * } */ public function __construct($data = NULL) { @@ -107,7 +251,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -128,7 +319,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -143,7 +381,13 @@ public function setFilter($var) } /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; * @return bool @@ -164,7 +408,13 @@ public function clearIncludeAllScopes() } /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; * @param bool $var @@ -179,7 +429,11 @@ public function setIncludeAllScopes($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -200,7 +454,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -215,7 +473,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -236,7 +502,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -251,7 +525,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -272,7 +548,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -313,7 +591,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -334,7 +616,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var @@ -349,7 +635,8 @@ public function setReturnPartialSuccess($var) } /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; * @return int|string @@ -370,7 +657,8 @@ public function clearServiceProjectNumber() } /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; * @param int|string $var diff --git a/Compute/src/V1/AggregatedListPublicDelegatedPrefixesRequest.php b/Compute/src/V1/AggregatedListPublicDelegatedPrefixesRequest.php index ab76002e6758..8cbc32dc357c 100644 --- a/Compute/src/V1/AggregatedListPublicDelegatedPrefixesRequest.php +++ b/Compute/src/V1/AggregatedListPublicDelegatedPrefixesRequest.php @@ -16,31 +16,98 @@ class AggregatedListPublicDelegatedPrefixesRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; */ protected $include_all_scopes = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -52,13 +119,18 @@ class AggregatedListPublicDelegatedPrefixesRequest extends \Google\Protobuf\Inte */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ protected $return_partial_success = null; /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; */ @@ -84,21 +156,93 @@ public static function build(string $project): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type bool $include_all_scopes - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Name of the project scoping this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * @type int|string $service_project_number - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * } */ public function __construct($data = NULL) { @@ -107,7 +251,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -128,7 +319,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -143,7 +381,13 @@ public function setFilter($var) } /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; * @return bool @@ -164,7 +408,13 @@ public function clearIncludeAllScopes() } /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; * @param bool $var @@ -179,7 +429,11 @@ public function setIncludeAllScopes($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -200,7 +454,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -215,7 +473,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -236,7 +502,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -251,7 +525,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -272,7 +548,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -313,7 +591,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -334,7 +616,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var @@ -349,7 +635,8 @@ public function setReturnPartialSuccess($var) } /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; * @return int|string @@ -370,7 +657,8 @@ public function clearServiceProjectNumber() } /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; * @param int|string $var diff --git a/Compute/src/V1/AggregatedListRegionCommitmentsRequest.php b/Compute/src/V1/AggregatedListRegionCommitmentsRequest.php index 592178644c7c..8d210e6a0daa 100644 --- a/Compute/src/V1/AggregatedListRegionCommitmentsRequest.php +++ b/Compute/src/V1/AggregatedListRegionCommitmentsRequest.php @@ -16,31 +16,98 @@ class AggregatedListRegionCommitmentsRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; */ protected $include_all_scopes = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -52,13 +119,18 @@ class AggregatedListRegionCommitmentsRequest extends \Google\Protobuf\Internal\M */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ protected $return_partial_success = null; /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; */ @@ -84,21 +156,93 @@ public static function build(string $project): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type bool $include_all_scopes - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * @type int|string $service_project_number - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * } */ public function __construct($data = NULL) { @@ -107,7 +251,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -128,7 +319,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -143,7 +381,13 @@ public function setFilter($var) } /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; * @return bool @@ -164,7 +408,13 @@ public function clearIncludeAllScopes() } /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; * @param bool $var @@ -179,7 +429,11 @@ public function setIncludeAllScopes($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -200,7 +454,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -215,7 +473,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -236,7 +502,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -251,7 +525,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -272,7 +548,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -313,7 +591,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -334,7 +616,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var @@ -349,7 +635,8 @@ public function setReturnPartialSuccess($var) } /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; * @return int|string @@ -370,7 +657,8 @@ public function clearServiceProjectNumber() } /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; * @param int|string $var diff --git a/Compute/src/V1/AggregatedListReservationsRequest.php b/Compute/src/V1/AggregatedListReservationsRequest.php index 19fd8ba660de..24affcaa3d8b 100644 --- a/Compute/src/V1/AggregatedListReservationsRequest.php +++ b/Compute/src/V1/AggregatedListReservationsRequest.php @@ -16,31 +16,98 @@ class AggregatedListReservationsRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; */ protected $include_all_scopes = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -52,13 +119,18 @@ class AggregatedListReservationsRequest extends \Google\Protobuf\Internal\Messag */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ protected $return_partial_success = null; /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; */ @@ -84,21 +156,93 @@ public static function build(string $project): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type bool $include_all_scopes - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * @type int|string $service_project_number - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * } */ public function __construct($data = NULL) { @@ -107,7 +251,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -128,7 +319,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -143,7 +381,13 @@ public function setFilter($var) } /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; * @return bool @@ -164,7 +408,13 @@ public function clearIncludeAllScopes() } /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; * @param bool $var @@ -179,7 +429,11 @@ public function setIncludeAllScopes($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -200,7 +454,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -215,7 +473,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -236,7 +502,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -251,7 +525,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -272,7 +548,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -313,7 +591,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -334,7 +616,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var @@ -349,7 +635,8 @@ public function setReturnPartialSuccess($var) } /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; * @return int|string @@ -370,7 +657,8 @@ public function clearServiceProjectNumber() } /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; * @param int|string $var diff --git a/Compute/src/V1/AggregatedListResourcePoliciesRequest.php b/Compute/src/V1/AggregatedListResourcePoliciesRequest.php index 942a024991da..03f5898597f0 100644 --- a/Compute/src/V1/AggregatedListResourcePoliciesRequest.php +++ b/Compute/src/V1/AggregatedListResourcePoliciesRequest.php @@ -16,31 +16,98 @@ class AggregatedListResourcePoliciesRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; */ protected $include_all_scopes = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -52,13 +119,18 @@ class AggregatedListResourcePoliciesRequest extends \Google\Protobuf\Internal\Me */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ protected $return_partial_success = null; /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; */ @@ -84,21 +156,93 @@ public static function build(string $project): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type bool $include_all_scopes - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * @type int|string $service_project_number - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * } */ public function __construct($data = NULL) { @@ -107,7 +251,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -128,7 +319,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -143,7 +381,13 @@ public function setFilter($var) } /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; * @return bool @@ -164,7 +408,13 @@ public function clearIncludeAllScopes() } /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; * @param bool $var @@ -179,7 +429,11 @@ public function setIncludeAllScopes($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -200,7 +454,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -215,7 +473,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -236,7 +502,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -251,7 +525,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -272,7 +548,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -313,7 +591,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -334,7 +616,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var @@ -349,7 +635,8 @@ public function setReturnPartialSuccess($var) } /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; * @return int|string @@ -370,7 +657,8 @@ public function clearServiceProjectNumber() } /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; * @param int|string $var diff --git a/Compute/src/V1/AggregatedListRoutersRequest.php b/Compute/src/V1/AggregatedListRoutersRequest.php index 9f22dc83f559..f6cef6fac855 100644 --- a/Compute/src/V1/AggregatedListRoutersRequest.php +++ b/Compute/src/V1/AggregatedListRoutersRequest.php @@ -16,31 +16,98 @@ class AggregatedListRoutersRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; */ protected $include_all_scopes = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -52,13 +119,18 @@ class AggregatedListRoutersRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ protected $return_partial_success = null; /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; */ @@ -84,21 +156,93 @@ public static function build(string $project): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type bool $include_all_scopes - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * @type int|string $service_project_number - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * } */ public function __construct($data = NULL) { @@ -107,7 +251,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -128,7 +319,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -143,7 +381,13 @@ public function setFilter($var) } /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; * @return bool @@ -164,7 +408,13 @@ public function clearIncludeAllScopes() } /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; * @param bool $var @@ -179,7 +429,11 @@ public function setIncludeAllScopes($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -200,7 +454,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -215,7 +473,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -236,7 +502,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -251,7 +525,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -272,7 +548,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -313,7 +591,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -334,7 +616,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var @@ -349,7 +635,8 @@ public function setReturnPartialSuccess($var) } /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; * @return int|string @@ -370,7 +657,8 @@ public function clearServiceProjectNumber() } /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; * @param int|string $var diff --git a/Compute/src/V1/AggregatedListSecurityPoliciesRequest.php b/Compute/src/V1/AggregatedListSecurityPoliciesRequest.php index 6d85ad2789f5..0fc81b4dd554 100644 --- a/Compute/src/V1/AggregatedListSecurityPoliciesRequest.php +++ b/Compute/src/V1/AggregatedListSecurityPoliciesRequest.php @@ -16,31 +16,98 @@ class AggregatedListSecurityPoliciesRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; */ protected $include_all_scopes = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -52,13 +119,18 @@ class AggregatedListSecurityPoliciesRequest extends \Google\Protobuf\Internal\Me */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ protected $return_partial_success = null; /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; */ @@ -84,21 +156,93 @@ public static function build(string $project): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type bool $include_all_scopes - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Name of the project scoping this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * @type int|string $service_project_number - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * } */ public function __construct($data = NULL) { @@ -107,7 +251,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -128,7 +319,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -143,7 +381,13 @@ public function setFilter($var) } /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; * @return bool @@ -164,7 +408,13 @@ public function clearIncludeAllScopes() } /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; * @param bool $var @@ -179,7 +429,11 @@ public function setIncludeAllScopes($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -200,7 +454,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -215,7 +473,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -236,7 +502,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -251,7 +525,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -272,7 +548,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -313,7 +591,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -334,7 +616,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var @@ -349,7 +635,8 @@ public function setReturnPartialSuccess($var) } /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; * @return int|string @@ -370,7 +657,8 @@ public function clearServiceProjectNumber() } /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; * @param int|string $var diff --git a/Compute/src/V1/AggregatedListServiceAttachmentsRequest.php b/Compute/src/V1/AggregatedListServiceAttachmentsRequest.php index ec2c67d98d21..c48c11883ed0 100644 --- a/Compute/src/V1/AggregatedListServiceAttachmentsRequest.php +++ b/Compute/src/V1/AggregatedListServiceAttachmentsRequest.php @@ -16,31 +16,98 @@ class AggregatedListServiceAttachmentsRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; */ protected $include_all_scopes = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -52,13 +119,18 @@ class AggregatedListServiceAttachmentsRequest extends \Google\Protobuf\Internal\ */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ protected $return_partial_success = null; /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; */ @@ -84,21 +156,93 @@ public static function build(string $project): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type bool $include_all_scopes - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Name of the project scoping this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * @type int|string $service_project_number - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * } */ public function __construct($data = NULL) { @@ -107,7 +251,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -128,7 +319,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -143,7 +381,13 @@ public function setFilter($var) } /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; * @return bool @@ -164,7 +408,13 @@ public function clearIncludeAllScopes() } /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; * @param bool $var @@ -179,7 +429,11 @@ public function setIncludeAllScopes($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -200,7 +454,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -215,7 +473,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -236,7 +502,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -251,7 +525,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -272,7 +548,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -313,7 +591,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -334,7 +616,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var @@ -349,7 +635,8 @@ public function setReturnPartialSuccess($var) } /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; * @return int|string @@ -370,7 +657,8 @@ public function clearServiceProjectNumber() } /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; * @param int|string $var diff --git a/Compute/src/V1/AggregatedListSslCertificatesRequest.php b/Compute/src/V1/AggregatedListSslCertificatesRequest.php index 12cab1f4df69..1e27ca863651 100644 --- a/Compute/src/V1/AggregatedListSslCertificatesRequest.php +++ b/Compute/src/V1/AggregatedListSslCertificatesRequest.php @@ -16,31 +16,98 @@ class AggregatedListSslCertificatesRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; */ protected $include_all_scopes = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -52,13 +119,18 @@ class AggregatedListSslCertificatesRequest extends \Google\Protobuf\Internal\Mes */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ protected $return_partial_success = null; /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; */ @@ -84,21 +156,93 @@ public static function build(string $project): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type bool $include_all_scopes - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Name of the project scoping this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * @type int|string $service_project_number - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * } */ public function __construct($data = NULL) { @@ -107,7 +251,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -128,7 +319,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -143,7 +381,13 @@ public function setFilter($var) } /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; * @return bool @@ -164,7 +408,13 @@ public function clearIncludeAllScopes() } /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; * @param bool $var @@ -179,7 +429,11 @@ public function setIncludeAllScopes($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -200,7 +454,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -215,7 +473,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -236,7 +502,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -251,7 +525,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -272,7 +548,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -313,7 +591,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -334,7 +616,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var @@ -349,7 +635,8 @@ public function setReturnPartialSuccess($var) } /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; * @return int|string @@ -370,7 +657,8 @@ public function clearServiceProjectNumber() } /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; * @param int|string $var diff --git a/Compute/src/V1/AggregatedListSslPoliciesRequest.php b/Compute/src/V1/AggregatedListSslPoliciesRequest.php index 6192b9a0e1a8..a9b275d1e390 100644 --- a/Compute/src/V1/AggregatedListSslPoliciesRequest.php +++ b/Compute/src/V1/AggregatedListSslPoliciesRequest.php @@ -16,31 +16,98 @@ class AggregatedListSslPoliciesRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; */ protected $include_all_scopes = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -52,13 +119,18 @@ class AggregatedListSslPoliciesRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ protected $return_partial_success = null; /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; */ @@ -84,21 +156,93 @@ public static function build(string $project): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type bool $include_all_scopes - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Name of the project scoping this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * @type int|string $service_project_number - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * } */ public function __construct($data = NULL) { @@ -107,7 +251,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -128,7 +319,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -143,7 +381,13 @@ public function setFilter($var) } /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; * @return bool @@ -164,7 +408,13 @@ public function clearIncludeAllScopes() } /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; * @param bool $var @@ -179,7 +429,11 @@ public function setIncludeAllScopes($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -200,7 +454,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -215,7 +473,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -236,7 +502,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -251,7 +525,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -272,7 +548,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -313,7 +591,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -334,7 +616,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var @@ -349,7 +635,8 @@ public function setReturnPartialSuccess($var) } /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; * @return int|string @@ -370,7 +657,8 @@ public function clearServiceProjectNumber() } /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; * @param int|string $var diff --git a/Compute/src/V1/AggregatedListStoragePoolTypesRequest.php b/Compute/src/V1/AggregatedListStoragePoolTypesRequest.php index 864771e4e8b6..9caaeaccb3a4 100644 --- a/Compute/src/V1/AggregatedListStoragePoolTypesRequest.php +++ b/Compute/src/V1/AggregatedListStoragePoolTypesRequest.php @@ -16,31 +16,98 @@ class AggregatedListStoragePoolTypesRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; */ protected $include_all_scopes = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -52,13 +119,18 @@ class AggregatedListStoragePoolTypesRequest extends \Google\Protobuf\Internal\Me */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ protected $return_partial_success = null; /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; */ @@ -84,21 +156,93 @@ public static function build(string $project): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type bool $include_all_scopes - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * @type int|string $service_project_number - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * } */ public function __construct($data = NULL) { @@ -107,7 +251,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -128,7 +319,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -143,7 +381,13 @@ public function setFilter($var) } /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; * @return bool @@ -164,7 +408,13 @@ public function clearIncludeAllScopes() } /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; * @param bool $var @@ -179,7 +429,11 @@ public function setIncludeAllScopes($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -200,7 +454,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -215,7 +473,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -236,7 +502,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -251,7 +525,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -272,7 +548,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -313,7 +591,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -334,7 +616,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var @@ -349,7 +635,8 @@ public function setReturnPartialSuccess($var) } /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; * @return int|string @@ -370,7 +657,8 @@ public function clearServiceProjectNumber() } /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; * @param int|string $var diff --git a/Compute/src/V1/AggregatedListStoragePoolsRequest.php b/Compute/src/V1/AggregatedListStoragePoolsRequest.php index 5227898d2e71..e1239fe1a0ba 100644 --- a/Compute/src/V1/AggregatedListStoragePoolsRequest.php +++ b/Compute/src/V1/AggregatedListStoragePoolsRequest.php @@ -16,31 +16,98 @@ class AggregatedListStoragePoolsRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; */ protected $include_all_scopes = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -52,13 +119,18 @@ class AggregatedListStoragePoolsRequest extends \Google\Protobuf\Internal\Messag */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ protected $return_partial_success = null; /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; */ @@ -84,21 +156,93 @@ public static function build(string $project): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type bool $include_all_scopes - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * @type int|string $service_project_number - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * } */ public function __construct($data = NULL) { @@ -107,7 +251,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -128,7 +319,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -143,7 +381,13 @@ public function setFilter($var) } /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; * @return bool @@ -164,7 +408,13 @@ public function clearIncludeAllScopes() } /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; * @param bool $var @@ -179,7 +429,11 @@ public function setIncludeAllScopes($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -200,7 +454,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -215,7 +473,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -236,7 +502,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -251,7 +525,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -272,7 +548,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -313,7 +591,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -334,7 +616,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var @@ -349,7 +635,8 @@ public function setReturnPartialSuccess($var) } /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; * @return int|string @@ -370,7 +657,8 @@ public function clearServiceProjectNumber() } /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; * @param int|string $var diff --git a/Compute/src/V1/AggregatedListSubnetworksRequest.php b/Compute/src/V1/AggregatedListSubnetworksRequest.php index ab63f9aca6a7..4b5583bdec9e 100644 --- a/Compute/src/V1/AggregatedListSubnetworksRequest.php +++ b/Compute/src/V1/AggregatedListSubnetworksRequest.php @@ -16,31 +16,98 @@ class AggregatedListSubnetworksRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; */ protected $include_all_scopes = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -52,17 +119,32 @@ class AggregatedListSubnetworksRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ protected $return_partial_success = null; /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; */ protected $service_project_number = null; + /** + * Defines the extra views returned back in the subnetwork resource. + * Supported values: + * - WITH_UTILIZATION: Utilization data is included in the + * response. + * Check the Views enum for the list of possible values. + * + * Generated from protobuf field optional string views = 112204398; + */ + protected $views = null; /** * @param string $project Project ID for this request. @@ -84,21 +166,99 @@ public static function build(string $project): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type bool $include_all_scopes - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * @type int|string $service_project_number - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. + * @type string $views + * Defines the extra views returned back in the subnetwork resource. + * Supported values: + * - WITH_UTILIZATION: Utilization data is included in the + * response. + * Check the Views enum for the list of possible values. * } */ public function __construct($data = NULL) { @@ -107,7 +267,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -128,7 +335,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -143,7 +397,13 @@ public function setFilter($var) } /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; * @return bool @@ -164,7 +424,13 @@ public function clearIncludeAllScopes() } /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; * @param bool $var @@ -179,7 +445,11 @@ public function setIncludeAllScopes($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -200,7 +470,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -215,7 +489,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -236,7 +518,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -251,7 +541,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -272,7 +564,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -313,7 +607,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -334,7 +632,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var @@ -349,7 +651,8 @@ public function setReturnPartialSuccess($var) } /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; * @return int|string @@ -370,7 +673,8 @@ public function clearServiceProjectNumber() } /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; * @param int|string $var @@ -384,5 +688,49 @@ public function setServiceProjectNumber($var) return $this; } + /** + * Defines the extra views returned back in the subnetwork resource. + * Supported values: + * - WITH_UTILIZATION: Utilization data is included in the + * response. + * Check the Views enum for the list of possible values. + * + * Generated from protobuf field optional string views = 112204398; + * @return string + */ + public function getViews() + { + return isset($this->views) ? $this->views : ''; + } + + public function hasViews() + { + return isset($this->views); + } + + public function clearViews() + { + unset($this->views); + } + + /** + * Defines the extra views returned back in the subnetwork resource. + * Supported values: + * - WITH_UTILIZATION: Utilization data is included in the + * response. + * Check the Views enum for the list of possible values. + * + * Generated from protobuf field optional string views = 112204398; + * @param string $var + * @return $this + */ + public function setViews($var) + { + GPBUtil::checkString($var, True); + $this->views = $var; + + return $this; + } + } diff --git a/Compute/src/V1/AggregatedListSubnetworksRequest/Views.php b/Compute/src/V1/AggregatedListSubnetworksRequest/Views.php new file mode 100644 index 000000000000..f55db45d9163 --- /dev/null +++ b/Compute/src/V1/AggregatedListSubnetworksRequest/Views.php @@ -0,0 +1,67 @@ +google.cloud.compute.v1.AggregatedListSubnetworksRequest.Views + */ +class Views +{ + /** + * A value indicating that the enum field is not set. + * + * Generated from protobuf enum UNDEFINED_VIEWS = 0; + */ + const UNDEFINED_VIEWS = 0; + /** + * Generated from protobuf enum DEFAULT = 115302945; + */ + const PBDEFAULT = 115302945; + /** + * Utilization data is included in the response. + * + * Generated from protobuf enum WITH_UTILIZATION = 504090633; + */ + const WITH_UTILIZATION = 504090633; + + private static $valueToName = [ + self::UNDEFINED_VIEWS => 'UNDEFINED_VIEWS', + self::PBDEFAULT => 'DEFAULT', + self::WITH_UTILIZATION => 'WITH_UTILIZATION', + ]; + + public static function name($value) + { + if (!isset(self::$valueToName[$value])) { + throw new UnexpectedValueException(sprintf( + 'Enum %s has no name defined for value %s', __CLASS__, $value)); + } + return self::$valueToName[$value]; + } + + + public static function value($name) + { + $const = __CLASS__ . '::' . strtoupper($name); + if (!defined($const)) { + $pbconst = __CLASS__. '::PB' . strtoupper($name); + if (!defined($pbconst)) { + throw new UnexpectedValueException(sprintf( + 'Enum %s has no value defined for name %s', __CLASS__, $name)); + } + return constant($pbconst); + } + return constant($const); + } +} + + diff --git a/Compute/src/V1/AggregatedListTargetHttpProxiesRequest.php b/Compute/src/V1/AggregatedListTargetHttpProxiesRequest.php index 9a1db4308420..364ec4897cb4 100644 --- a/Compute/src/V1/AggregatedListTargetHttpProxiesRequest.php +++ b/Compute/src/V1/AggregatedListTargetHttpProxiesRequest.php @@ -16,31 +16,98 @@ class AggregatedListTargetHttpProxiesRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; */ protected $include_all_scopes = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -52,13 +119,18 @@ class AggregatedListTargetHttpProxiesRequest extends \Google\Protobuf\Internal\M */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ protected $return_partial_success = null; /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; */ @@ -84,21 +156,93 @@ public static function build(string $project): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type bool $include_all_scopes - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Name of the project scoping this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * @type int|string $service_project_number - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * } */ public function __construct($data = NULL) { @@ -107,7 +251,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -128,7 +319,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -143,7 +381,13 @@ public function setFilter($var) } /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; * @return bool @@ -164,7 +408,13 @@ public function clearIncludeAllScopes() } /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; * @param bool $var @@ -179,7 +429,11 @@ public function setIncludeAllScopes($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -200,7 +454,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -215,7 +473,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -236,7 +502,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -251,7 +525,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -272,7 +548,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -313,7 +591,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -334,7 +616,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var @@ -349,7 +635,8 @@ public function setReturnPartialSuccess($var) } /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; * @return int|string @@ -370,7 +657,8 @@ public function clearServiceProjectNumber() } /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; * @param int|string $var diff --git a/Compute/src/V1/AggregatedListTargetHttpsProxiesRequest.php b/Compute/src/V1/AggregatedListTargetHttpsProxiesRequest.php index f9b472196d0a..cf5770f7a02a 100644 --- a/Compute/src/V1/AggregatedListTargetHttpsProxiesRequest.php +++ b/Compute/src/V1/AggregatedListTargetHttpsProxiesRequest.php @@ -16,31 +16,98 @@ class AggregatedListTargetHttpsProxiesRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; */ protected $include_all_scopes = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -52,13 +119,18 @@ class AggregatedListTargetHttpsProxiesRequest extends \Google\Protobuf\Internal\ */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ protected $return_partial_success = null; /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; */ @@ -84,21 +156,93 @@ public static function build(string $project): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type bool $include_all_scopes - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Name of the project scoping this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * @type int|string $service_project_number - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * } */ public function __construct($data = NULL) { @@ -107,7 +251,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -128,7 +319,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -143,7 +381,13 @@ public function setFilter($var) } /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; * @return bool @@ -164,7 +408,13 @@ public function clearIncludeAllScopes() } /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; * @param bool $var @@ -179,7 +429,11 @@ public function setIncludeAllScopes($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -200,7 +454,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -215,7 +473,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -236,7 +502,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -251,7 +525,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -272,7 +548,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -313,7 +591,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -334,7 +616,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var @@ -349,7 +635,8 @@ public function setReturnPartialSuccess($var) } /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; * @return int|string @@ -370,7 +657,8 @@ public function clearServiceProjectNumber() } /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; * @param int|string $var diff --git a/Compute/src/V1/AggregatedListTargetInstancesRequest.php b/Compute/src/V1/AggregatedListTargetInstancesRequest.php index 5c4a2153b133..4508488b2497 100644 --- a/Compute/src/V1/AggregatedListTargetInstancesRequest.php +++ b/Compute/src/V1/AggregatedListTargetInstancesRequest.php @@ -16,31 +16,98 @@ class AggregatedListTargetInstancesRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; */ protected $include_all_scopes = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -52,13 +119,18 @@ class AggregatedListTargetInstancesRequest extends \Google\Protobuf\Internal\Mes */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ protected $return_partial_success = null; /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; */ @@ -84,21 +156,93 @@ public static function build(string $project): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type bool $include_all_scopes - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * @type int|string $service_project_number - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * } */ public function __construct($data = NULL) { @@ -107,7 +251,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -128,7 +319,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -143,7 +381,13 @@ public function setFilter($var) } /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; * @return bool @@ -164,7 +408,13 @@ public function clearIncludeAllScopes() } /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; * @param bool $var @@ -179,7 +429,11 @@ public function setIncludeAllScopes($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -200,7 +454,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -215,7 +473,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -236,7 +502,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -251,7 +525,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -272,7 +548,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -313,7 +591,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -334,7 +616,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var @@ -349,7 +635,8 @@ public function setReturnPartialSuccess($var) } /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; * @return int|string @@ -370,7 +657,8 @@ public function clearServiceProjectNumber() } /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; * @param int|string $var diff --git a/Compute/src/V1/AggregatedListTargetPoolsRequest.php b/Compute/src/V1/AggregatedListTargetPoolsRequest.php index 5e23007ccba1..e09882d546c5 100644 --- a/Compute/src/V1/AggregatedListTargetPoolsRequest.php +++ b/Compute/src/V1/AggregatedListTargetPoolsRequest.php @@ -16,31 +16,98 @@ class AggregatedListTargetPoolsRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; */ protected $include_all_scopes = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -52,13 +119,18 @@ class AggregatedListTargetPoolsRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ protected $return_partial_success = null; /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; */ @@ -84,21 +156,93 @@ public static function build(string $project): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type bool $include_all_scopes - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * @type int|string $service_project_number - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * } */ public function __construct($data = NULL) { @@ -107,7 +251,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -128,7 +319,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -143,7 +381,13 @@ public function setFilter($var) } /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; * @return bool @@ -164,7 +408,13 @@ public function clearIncludeAllScopes() } /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; * @param bool $var @@ -179,7 +429,11 @@ public function setIncludeAllScopes($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -200,7 +454,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -215,7 +473,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -236,7 +502,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -251,7 +525,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -272,7 +548,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -313,7 +591,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -334,7 +616,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var @@ -349,7 +635,8 @@ public function setReturnPartialSuccess($var) } /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; * @return int|string @@ -370,7 +657,8 @@ public function clearServiceProjectNumber() } /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; * @param int|string $var diff --git a/Compute/src/V1/AggregatedListTargetTcpProxiesRequest.php b/Compute/src/V1/AggregatedListTargetTcpProxiesRequest.php index 235d2859ade0..bea671fb183b 100644 --- a/Compute/src/V1/AggregatedListTargetTcpProxiesRequest.php +++ b/Compute/src/V1/AggregatedListTargetTcpProxiesRequest.php @@ -16,31 +16,98 @@ class AggregatedListTargetTcpProxiesRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; */ protected $include_all_scopes = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -52,13 +119,18 @@ class AggregatedListTargetTcpProxiesRequest extends \Google\Protobuf\Internal\Me */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ protected $return_partial_success = null; /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; */ @@ -84,21 +156,93 @@ public static function build(string $project): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type bool $include_all_scopes - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Name of the project scoping this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * @type int|string $service_project_number - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * } */ public function __construct($data = NULL) { @@ -107,7 +251,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -128,7 +319,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -143,7 +381,13 @@ public function setFilter($var) } /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; * @return bool @@ -164,7 +408,13 @@ public function clearIncludeAllScopes() } /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; * @param bool $var @@ -179,7 +429,11 @@ public function setIncludeAllScopes($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -200,7 +454,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -215,7 +473,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -236,7 +502,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -251,7 +525,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -272,7 +548,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -313,7 +591,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -334,7 +616,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var @@ -349,7 +635,8 @@ public function setReturnPartialSuccess($var) } /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; * @return int|string @@ -370,7 +657,8 @@ public function clearServiceProjectNumber() } /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; * @param int|string $var diff --git a/Compute/src/V1/AggregatedListTargetVpnGatewaysRequest.php b/Compute/src/V1/AggregatedListTargetVpnGatewaysRequest.php index 80bf05d3ecc5..90d36c0ff97e 100644 --- a/Compute/src/V1/AggregatedListTargetVpnGatewaysRequest.php +++ b/Compute/src/V1/AggregatedListTargetVpnGatewaysRequest.php @@ -16,31 +16,98 @@ class AggregatedListTargetVpnGatewaysRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; */ protected $include_all_scopes = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -52,13 +119,18 @@ class AggregatedListTargetVpnGatewaysRequest extends \Google\Protobuf\Internal\M */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ protected $return_partial_success = null; /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; */ @@ -84,21 +156,93 @@ public static function build(string $project): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type bool $include_all_scopes - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * @type int|string $service_project_number - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * } */ public function __construct($data = NULL) { @@ -107,7 +251,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -128,7 +319,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -143,7 +381,13 @@ public function setFilter($var) } /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; * @return bool @@ -164,7 +408,13 @@ public function clearIncludeAllScopes() } /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; * @param bool $var @@ -179,7 +429,11 @@ public function setIncludeAllScopes($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -200,7 +454,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -215,7 +473,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -236,7 +502,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -251,7 +525,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -272,7 +548,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -313,7 +591,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -334,7 +616,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var @@ -349,7 +635,8 @@ public function setReturnPartialSuccess($var) } /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; * @return int|string @@ -370,7 +657,8 @@ public function clearServiceProjectNumber() } /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; * @param int|string $var diff --git a/Compute/src/V1/AggregatedListUrlMapsRequest.php b/Compute/src/V1/AggregatedListUrlMapsRequest.php index 636fc4676ba6..18807837f15f 100644 --- a/Compute/src/V1/AggregatedListUrlMapsRequest.php +++ b/Compute/src/V1/AggregatedListUrlMapsRequest.php @@ -16,31 +16,98 @@ class AggregatedListUrlMapsRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; */ protected $include_all_scopes = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -52,13 +119,18 @@ class AggregatedListUrlMapsRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ protected $return_partial_success = null; /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; */ @@ -84,21 +156,93 @@ public static function build(string $project): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type bool $include_all_scopes - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Name of the project scoping this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * @type int|string $service_project_number - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * } */ public function __construct($data = NULL) { @@ -107,7 +251,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -128,7 +319,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -143,7 +381,13 @@ public function setFilter($var) } /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; * @return bool @@ -164,7 +408,13 @@ public function clearIncludeAllScopes() } /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; * @param bool $var @@ -179,7 +429,11 @@ public function setIncludeAllScopes($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -200,7 +454,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -215,7 +473,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -236,7 +502,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -251,7 +525,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -272,7 +548,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -313,7 +591,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -334,7 +616,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var @@ -349,7 +635,8 @@ public function setReturnPartialSuccess($var) } /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; * @return int|string @@ -370,7 +657,8 @@ public function clearServiceProjectNumber() } /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; * @param int|string $var diff --git a/Compute/src/V1/AggregatedListVpnGatewaysRequest.php b/Compute/src/V1/AggregatedListVpnGatewaysRequest.php index 4feb678576eb..b494d8d379c4 100644 --- a/Compute/src/V1/AggregatedListVpnGatewaysRequest.php +++ b/Compute/src/V1/AggregatedListVpnGatewaysRequest.php @@ -16,31 +16,98 @@ class AggregatedListVpnGatewaysRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; */ protected $include_all_scopes = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -52,13 +119,18 @@ class AggregatedListVpnGatewaysRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ protected $return_partial_success = null; /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; */ @@ -84,21 +156,93 @@ public static function build(string $project): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type bool $include_all_scopes - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * @type int|string $service_project_number - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * } */ public function __construct($data = NULL) { @@ -107,7 +251,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -128,7 +319,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -143,7 +381,13 @@ public function setFilter($var) } /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; * @return bool @@ -164,7 +408,13 @@ public function clearIncludeAllScopes() } /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; * @param bool $var @@ -179,7 +429,11 @@ public function setIncludeAllScopes($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -200,7 +454,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -215,7 +473,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -236,7 +502,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -251,7 +525,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -272,7 +548,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -313,7 +591,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -334,7 +616,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var @@ -349,7 +635,8 @@ public function setReturnPartialSuccess($var) } /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; * @return int|string @@ -370,7 +657,8 @@ public function clearServiceProjectNumber() } /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; * @param int|string $var diff --git a/Compute/src/V1/AggregatedListVpnTunnelsRequest.php b/Compute/src/V1/AggregatedListVpnTunnelsRequest.php index b5b22510dca1..23559e42ba24 100644 --- a/Compute/src/V1/AggregatedListVpnTunnelsRequest.php +++ b/Compute/src/V1/AggregatedListVpnTunnelsRequest.php @@ -16,31 +16,98 @@ class AggregatedListVpnTunnelsRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; */ protected $include_all_scopes = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -52,13 +119,18 @@ class AggregatedListVpnTunnelsRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ protected $return_partial_success = null; /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; */ @@ -84,21 +156,93 @@ public static function build(string $project): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type bool $include_all_scopes - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * @type int|string $service_project_number - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * } */ public function __construct($data = NULL) { @@ -107,7 +251,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -128,7 +319,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -143,7 +381,13 @@ public function setFilter($var) } /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; * @return bool @@ -164,7 +408,13 @@ public function clearIncludeAllScopes() } /** - * Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included. + * Indicates whether every visible scope for each scope type (zone, region, + * global) should be included in the response. For new resource types added + * after this field, the flag has no effect as new resource types will always + * include every visible scope for each scope type in response. For resource + * types which predate this field, if this flag is omitted or false, only + * scopes of the scope types where the resource type is expected to be found + * will be included. * * Generated from protobuf field optional bool include_all_scopes = 391327988; * @param bool $var @@ -179,7 +429,11 @@ public function setIncludeAllScopes($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -200,7 +454,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -215,7 +473,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -236,7 +502,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -251,7 +525,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -272,7 +548,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -313,7 +591,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -334,7 +616,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var @@ -349,7 +635,8 @@ public function setReturnPartialSuccess($var) } /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; * @return int|string @@ -370,7 +657,8 @@ public function clearServiceProjectNumber() } /** - * The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api. + * The Shared VPC service project id or service project number for which + * aggregated list request is invoked for subnetworks list-usable api. * * Generated from protobuf field optional int64 service_project_number = 316757497; * @param int|string $var diff --git a/Compute/src/V1/AliasIpRange.php b/Compute/src/V1/AliasIpRange.php index 0793eb5ad565..51dd1678ffbd 100644 --- a/Compute/src/V1/AliasIpRange.php +++ b/Compute/src/V1/AliasIpRange.php @@ -16,13 +16,17 @@ class AliasIpRange extends \Google\Protobuf\Internal\Message { /** - * The IP alias ranges to allocate for this interface. This IP CIDR range must belong to the specified subnetwork and cannot contain IP addresses reserved by system or used by other network interfaces. This range may be a single IP address (such as 10.2.3.4), a netmask (such as /24) or a CIDR-formatted string (such as 10.1.2.0/24). + * The IP alias ranges to allocate for this interface. This IP CIDR range + * must belong to the specified subnetwork and cannot contain IP addresses + * reserved by system or used by other network interfaces. This range may be + * a single IP address (such as 10.2.3.4), a netmask (such as/24) or a CIDR-formatted string (such as10.1.2.0/24). * * Generated from protobuf field optional string ip_cidr_range = 98117322; */ protected $ip_cidr_range = null; /** - * The name of a subnetwork secondary IP range from which to allocate an IP alias range. If not specified, the primary range of the subnetwork is used. + * The name of a subnetwork secondary IP range from which to allocate an IP + * alias range. If not specified, the primary range of the subnetwork is used. * * Generated from protobuf field optional string subnetwork_range_name = 387995966; */ @@ -35,9 +39,13 @@ class AliasIpRange extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $ip_cidr_range - * The IP alias ranges to allocate for this interface. This IP CIDR range must belong to the specified subnetwork and cannot contain IP addresses reserved by system or used by other network interfaces. This range may be a single IP address (such as 10.2.3.4), a netmask (such as /24) or a CIDR-formatted string (such as 10.1.2.0/24). + * The IP alias ranges to allocate for this interface. This IP CIDR range + * must belong to the specified subnetwork and cannot contain IP addresses + * reserved by system or used by other network interfaces. This range may be + * a single IP address (such as 10.2.3.4), a netmask (such as/24) or a CIDR-formatted string (such as10.1.2.0/24). * @type string $subnetwork_range_name - * The name of a subnetwork secondary IP range from which to allocate an IP alias range. If not specified, the primary range of the subnetwork is used. + * The name of a subnetwork secondary IP range from which to allocate an IP + * alias range. If not specified, the primary range of the subnetwork is used. * } */ public function __construct($data = NULL) { @@ -46,7 +54,10 @@ public function __construct($data = NULL) { } /** - * The IP alias ranges to allocate for this interface. This IP CIDR range must belong to the specified subnetwork and cannot contain IP addresses reserved by system or used by other network interfaces. This range may be a single IP address (such as 10.2.3.4), a netmask (such as /24) or a CIDR-formatted string (such as 10.1.2.0/24). + * The IP alias ranges to allocate for this interface. This IP CIDR range + * must belong to the specified subnetwork and cannot contain IP addresses + * reserved by system or used by other network interfaces. This range may be + * a single IP address (such as 10.2.3.4), a netmask (such as/24) or a CIDR-formatted string (such as10.1.2.0/24). * * Generated from protobuf field optional string ip_cidr_range = 98117322; * @return string @@ -67,7 +78,10 @@ public function clearIpCidrRange() } /** - * The IP alias ranges to allocate for this interface. This IP CIDR range must belong to the specified subnetwork and cannot contain IP addresses reserved by system or used by other network interfaces. This range may be a single IP address (such as 10.2.3.4), a netmask (such as /24) or a CIDR-formatted string (such as 10.1.2.0/24). + * The IP alias ranges to allocate for this interface. This IP CIDR range + * must belong to the specified subnetwork and cannot contain IP addresses + * reserved by system or used by other network interfaces. This range may be + * a single IP address (such as 10.2.3.4), a netmask (such as/24) or a CIDR-formatted string (such as10.1.2.0/24). * * Generated from protobuf field optional string ip_cidr_range = 98117322; * @param string $var @@ -82,7 +96,8 @@ public function setIpCidrRange($var) } /** - * The name of a subnetwork secondary IP range from which to allocate an IP alias range. If not specified, the primary range of the subnetwork is used. + * The name of a subnetwork secondary IP range from which to allocate an IP + * alias range. If not specified, the primary range of the subnetwork is used. * * Generated from protobuf field optional string subnetwork_range_name = 387995966; * @return string @@ -103,7 +118,8 @@ public function clearSubnetworkRangeName() } /** - * The name of a subnetwork secondary IP range from which to allocate an IP alias range. If not specified, the primary range of the subnetwork is used. + * The name of a subnetwork secondary IP range from which to allocate an IP + * alias range. If not specified, the primary range of the subnetwork is used. * * Generated from protobuf field optional string subnetwork_range_name = 387995966; * @param string $var diff --git a/Compute/src/V1/AllocationAggregateReservation.php b/Compute/src/V1/AllocationAggregateReservation.php index 13d7605c79a3..98fc07f16269 100644 --- a/Compute/src/V1/AllocationAggregateReservation.php +++ b/Compute/src/V1/AllocationAggregateReservation.php @@ -9,7 +9,9 @@ use Google\Protobuf\Internal\GPBUtil; /** - * This reservation type is specified by total resource amounts (e.g. total count of CPUs) and can account for multiple instance SKUs. In other words, one can create instances of varying shapes against this reservation. + * This reservation type is specified by total resource amounts (e.g. total + * count of CPUs) and can account for multiple instance SKUs. In other words, + * one can create instances of varying shapes against this reservation. * * Generated from protobuf message google.cloud.compute.v1.AllocationAggregateReservation */ @@ -28,7 +30,8 @@ class AllocationAggregateReservation extends \Google\Protobuf\Internal\Message */ private $reserved_resources; /** - * The VM family that all instances scheduled against this reservation must belong to. + * The VM family that all instances scheduled against this reservation must + * belong to. * Check the VmFamily enum for the list of possible values. * * Generated from protobuf field optional string vm_family = 125017580; @@ -53,7 +56,8 @@ class AllocationAggregateReservation extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\AllocationAggregateReservationReservedResourceInfo>|\Google\Protobuf\Internal\RepeatedField $reserved_resources * List of reserved resources (CPUs, memory, accelerators). * @type string $vm_family - * The VM family that all instances scheduled against this reservation must belong to. + * The VM family that all instances scheduled against this reservation must + * belong to. * Check the VmFamily enum for the list of possible values. * @type string $workload_type * The workload type of the instances that will target this reservation. @@ -118,7 +122,8 @@ public function setReservedResources($var) } /** - * The VM family that all instances scheduled against this reservation must belong to. + * The VM family that all instances scheduled against this reservation must + * belong to. * Check the VmFamily enum for the list of possible values. * * Generated from protobuf field optional string vm_family = 125017580; @@ -140,7 +145,8 @@ public function clearVmFamily() } /** - * The VM family that all instances scheduled against this reservation must belong to. + * The VM family that all instances scheduled against this reservation must + * belong to. * Check the VmFamily enum for the list of possible values. * * Generated from protobuf field optional string vm_family = 125017580; diff --git a/Compute/src/V1/AllocationAggregateReservation/VmFamily.php b/Compute/src/V1/AllocationAggregateReservation/VmFamily.php index 565911156b8a..d31a8c77f6de 100644 --- a/Compute/src/V1/AllocationAggregateReservation/VmFamily.php +++ b/Compute/src/V1/AllocationAggregateReservation/VmFamily.php @@ -7,7 +7,8 @@ use UnexpectedValueException; /** - * The VM family that all instances scheduled against this reservation must belong to. + * The VM family that all instances scheduled against this reservation must + * belong to. * * Protobuf type google.cloud.compute.v1.AllocationAggregateReservation.VmFamily */ @@ -47,6 +48,10 @@ class VmFamily * Generated from protobuf enum VM_FAMILY_CLOUD_TPU_POD_SLICE_CT5P = 517384438; */ const VM_FAMILY_CLOUD_TPU_POD_SLICE_CT5P = 517384438; + /** + * Generated from protobuf enum VM_FAMILY_CLOUD_TPU_POD_SLICE_TPU7X = 485271888; + */ + const VM_FAMILY_CLOUD_TPU_POD_SLICE_TPU7X = 485271888; private static $valueToName = [ self::UNDEFINED_VM_FAMILY => 'UNDEFINED_VM_FAMILY', @@ -57,6 +62,7 @@ class VmFamily self::VM_FAMILY_CLOUD_TPU_POD_SLICE_CT3P => 'VM_FAMILY_CLOUD_TPU_POD_SLICE_CT3P', self::VM_FAMILY_CLOUD_TPU_POD_SLICE_CT4P => 'VM_FAMILY_CLOUD_TPU_POD_SLICE_CT4P', self::VM_FAMILY_CLOUD_TPU_POD_SLICE_CT5P => 'VM_FAMILY_CLOUD_TPU_POD_SLICE_CT5P', + self::VM_FAMILY_CLOUD_TPU_POD_SLICE_TPU7X => 'VM_FAMILY_CLOUD_TPU_POD_SLICE_TPU7X', ]; public static function name($value) diff --git a/Compute/src/V1/AllocationAggregateReservation/WorkloadType.php b/Compute/src/V1/AllocationAggregateReservation/WorkloadType.php index 7fc117b994c0..9a33de27a1c9 100644 --- a/Compute/src/V1/AllocationAggregateReservation/WorkloadType.php +++ b/Compute/src/V1/AllocationAggregateReservation/WorkloadType.php @@ -20,13 +20,15 @@ class WorkloadType */ const UNDEFINED_WORKLOAD_TYPE = 0; /** - * Reserved resources will be optimized for BATCH workloads, such as ML training. + * Reserved resources will be optimized for BATCH workloads, such as ML + * training. * * Generated from protobuf enum BATCH = 62971674; */ const BATCH = 62971674; /** - * Reserved resources will be optimized for SERVING workloads, such as ML inference. + * Reserved resources will be optimized for SERVING workloads, such as ML + * inference. * * Generated from protobuf enum SERVING = 17781740; */ diff --git a/Compute/src/V1/AllocationAggregateReservationReservedResourceInfoAccelerator.php b/Compute/src/V1/AllocationAggregateReservationReservedResourceInfoAccelerator.php index bc88f54d671a..4d88364bd274 100644 --- a/Compute/src/V1/AllocationAggregateReservationReservedResourceInfoAccelerator.php +++ b/Compute/src/V1/AllocationAggregateReservationReservedResourceInfoAccelerator.php @@ -21,7 +21,8 @@ class AllocationAggregateReservationReservedResourceInfoAccelerator extends \Goo */ protected $accelerator_count = null; /** - * Full or partial URL to accelerator type. e.g. "projects/{PROJECT}/zones/{ZONE}/acceleratorTypes/ct4l" + * Full or partial URL to accelerator type. e.g. + * "projects/{PROJECT}/zones/{ZONE}/acceleratorTypes/ct4l" * * Generated from protobuf field optional string accelerator_type = 138031246; */ @@ -36,7 +37,8 @@ class AllocationAggregateReservationReservedResourceInfoAccelerator extends \Goo * @type int $accelerator_count * Number of accelerators of specified type. * @type string $accelerator_type - * Full or partial URL to accelerator type. e.g. "projects/{PROJECT}/zones/{ZONE}/acceleratorTypes/ct4l" + * Full or partial URL to accelerator type. e.g. + * "projects/{PROJECT}/zones/{ZONE}/acceleratorTypes/ct4l" * } */ public function __construct($data = NULL) { @@ -81,7 +83,8 @@ public function setAcceleratorCount($var) } /** - * Full or partial URL to accelerator type. e.g. "projects/{PROJECT}/zones/{ZONE}/acceleratorTypes/ct4l" + * Full or partial URL to accelerator type. e.g. + * "projects/{PROJECT}/zones/{ZONE}/acceleratorTypes/ct4l" * * Generated from protobuf field optional string accelerator_type = 138031246; * @return string @@ -102,7 +105,8 @@ public function clearAcceleratorType() } /** - * Full or partial URL to accelerator type. e.g. "projects/{PROJECT}/zones/{ZONE}/acceleratorTypes/ct4l" + * Full or partial URL to accelerator type. e.g. + * "projects/{PROJECT}/zones/{ZONE}/acceleratorTypes/ct4l" * * Generated from protobuf field optional string accelerator_type = 138031246; * @param string $var diff --git a/Compute/src/V1/AllocationResourceStatusSpecificSKUAllocation.php b/Compute/src/V1/AllocationResourceStatusSpecificSKUAllocation.php index 8fc93f33c7c3..cb8d2519f5ce 100644 --- a/Compute/src/V1/AllocationResourceStatusSpecificSKUAllocation.php +++ b/Compute/src/V1/AllocationResourceStatusSpecificSKUAllocation.php @@ -22,7 +22,8 @@ class AllocationResourceStatusSpecificSKUAllocation extends \Google\Protobuf\Int */ protected $source_instance_template_id = null; /** - * Per service utilization breakdown. The Key is the Google Cloud managed service name. + * Per service utilization breakdown. The Key is the Google Cloud managed + * service name. * * Generated from protobuf field map utilizations = 402495121; */ @@ -37,7 +38,8 @@ class AllocationResourceStatusSpecificSKUAllocation extends \Google\Protobuf\Int * @type string $source_instance_template_id * ID of the instance template used to populate reservation properties. * @type array|\Google\Protobuf\Internal\MapField $utilizations - * Per service utilization breakdown. The Key is the Google Cloud managed service name. + * Per service utilization breakdown. The Key is the Google Cloud managed + * service name. * } */ public function __construct($data = NULL) { @@ -82,7 +84,8 @@ public function setSourceInstanceTemplateId($var) } /** - * Per service utilization breakdown. The Key is the Google Cloud managed service name. + * Per service utilization breakdown. The Key is the Google Cloud managed + * service name. * * Generated from protobuf field map utilizations = 402495121; * @return \Google\Protobuf\Internal\MapField @@ -93,7 +96,8 @@ public function getUtilizations() } /** - * Per service utilization breakdown. The Key is the Google Cloud managed service name. + * Per service utilization breakdown. The Key is the Google Cloud managed + * service name. * * Generated from protobuf field map utilizations = 402495121; * @param array|\Google\Protobuf\Internal\MapField $var diff --git a/Compute/src/V1/AllocationSpecificSKUAllocationAllocatedInstancePropertiesReservedDisk.php b/Compute/src/V1/AllocationSpecificSKUAllocationAllocatedInstancePropertiesReservedDisk.php index d33bf0b12190..801da6bac6ef 100644 --- a/Compute/src/V1/AllocationSpecificSKUAllocationAllocatedInstancePropertiesReservedDisk.php +++ b/Compute/src/V1/AllocationSpecificSKUAllocationAllocatedInstancePropertiesReservedDisk.php @@ -21,7 +21,9 @@ class AllocationSpecificSKUAllocationAllocatedInstancePropertiesReservedDisk ext */ protected $disk_size_gb = null; /** - * Specifies the disk interface to use for attaching this disk, which is either SCSI or NVME. The default is SCSI. For performance characteristics of SCSI over NVMe, see Local SSD performance. + * Specifies the disk interface to use for attaching this disk, which is + * either SCSI or NVME. The default isSCSI. + * For performance characteristics of SCSI over NVMe, seeLocal SSD performance. * Check the Interface enum for the list of possible values. * * Generated from protobuf field optional string interface = 502623545; @@ -37,7 +39,9 @@ class AllocationSpecificSKUAllocationAllocatedInstancePropertiesReservedDisk ext * @type int|string $disk_size_gb * Specifies the size of the disk in base-2 GB. * @type string $interface - * Specifies the disk interface to use for attaching this disk, which is either SCSI or NVME. The default is SCSI. For performance characteristics of SCSI over NVMe, see Local SSD performance. + * Specifies the disk interface to use for attaching this disk, which is + * either SCSI or NVME. The default isSCSI. + * For performance characteristics of SCSI over NVMe, seeLocal SSD performance. * Check the Interface enum for the list of possible values. * } */ @@ -83,7 +87,9 @@ public function setDiskSizeGb($var) } /** - * Specifies the disk interface to use for attaching this disk, which is either SCSI or NVME. The default is SCSI. For performance characteristics of SCSI over NVMe, see Local SSD performance. + * Specifies the disk interface to use for attaching this disk, which is + * either SCSI or NVME. The default isSCSI. + * For performance characteristics of SCSI over NVMe, seeLocal SSD performance. * Check the Interface enum for the list of possible values. * * Generated from protobuf field optional string interface = 502623545; @@ -105,7 +111,9 @@ public function clearInterface() } /** - * Specifies the disk interface to use for attaching this disk, which is either SCSI or NVME. The default is SCSI. For performance characteristics of SCSI over NVMe, see Local SSD performance. + * Specifies the disk interface to use for attaching this disk, which is + * either SCSI or NVME. The default isSCSI. + * For performance characteristics of SCSI over NVMe, seeLocal SSD performance. * Check the Interface enum for the list of possible values. * * Generated from protobuf field optional string interface = 502623545; diff --git a/Compute/src/V1/AllocationSpecificSKUAllocationAllocatedInstancePropertiesReservedDisk/PBInterface.php b/Compute/src/V1/AllocationSpecificSKUAllocationAllocatedInstancePropertiesReservedDisk/PBInterface.php index 60d9eb4ecbef..cc1d7d0b049e 100644 --- a/Compute/src/V1/AllocationSpecificSKUAllocationAllocatedInstancePropertiesReservedDisk/PBInterface.php +++ b/Compute/src/V1/AllocationSpecificSKUAllocationAllocatedInstancePropertiesReservedDisk/PBInterface.php @@ -7,7 +7,9 @@ use UnexpectedValueException; /** - * Specifies the disk interface to use for attaching this disk, which is either SCSI or NVME. The default is SCSI. For performance characteristics of SCSI over NVMe, see Local SSD performance. + * Specifies the disk interface to use for attaching this disk, which is + * either SCSI or NVME. The default isSCSI. + * For performance characteristics of SCSI over NVMe, seeLocal SSD performance. * * Protobuf type google.cloud.compute.v1.AllocationSpecificSKUAllocationAllocatedInstancePropertiesReservedDisk.Interface */ diff --git a/Compute/src/V1/AllocationSpecificSKUAllocationReservedInstanceProperties.php b/Compute/src/V1/AllocationSpecificSKUAllocationReservedInstanceProperties.php index 85279346b0df..e6eda6443f8a 100644 --- a/Compute/src/V1/AllocationSpecificSKUAllocationReservedInstanceProperties.php +++ b/Compute/src/V1/AllocationSpecificSKUAllocationReservedInstanceProperties.php @@ -9,7 +9,8 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Properties of the SKU instances being reserved. Next ID: 9 + * Properties of the SKU instances being reserved. + * Next ID: 9 * * Generated from protobuf message google.cloud.compute.v1.AllocationSpecificSKUAllocationReservedInstanceProperties */ @@ -22,19 +23,24 @@ class AllocationSpecificSKUAllocationReservedInstanceProperties extends \Google\ */ private $guest_accelerators; /** - * Specifies amount of local ssd to reserve with each instance. The type of disk is local-ssd. + * Specifies amount of local ssd to reserve with each instance. The type + * of disk is local-ssd. * * Generated from protobuf field repeated .google.cloud.compute.v1.AllocationSpecificSKUAllocationAllocatedInstancePropertiesReservedDisk local_ssds = 229951299; */ private $local_ssds; /** - * An opaque location hint used to place the allocation close to other resources. This field is for use by internal tools that use the public API. + * An opaque location hint used to place the allocation close to other + * resources. + * This field is for use by internal tools that use the public API. * * Generated from protobuf field optional string location_hint = 350519505; */ protected $location_hint = null; /** - * Specifies type of machine (name only) which has fixed number of vCPUs and fixed amount of memory. This also includes specifying custom machine type following custom-NUMBER_OF_CPUS-AMOUNT_OF_MEMORY pattern. + * Specifies type of machine (name only) which has fixed number of vCPUs + * and fixed amount of memory. This also includes specifying custom + * machine type following custom-NUMBER_OF_CPUS-AMOUNT_OF_MEMORY pattern. * * Generated from protobuf field optional string machine_type = 227711026; */ @@ -55,11 +61,16 @@ class AllocationSpecificSKUAllocationReservedInstanceProperties extends \Google\ * @type array<\Google\Cloud\Compute\V1\AcceleratorConfig>|\Google\Protobuf\Internal\RepeatedField $guest_accelerators * Specifies accelerator type and count. * @type array<\Google\Cloud\Compute\V1\AllocationSpecificSKUAllocationAllocatedInstancePropertiesReservedDisk>|\Google\Protobuf\Internal\RepeatedField $local_ssds - * Specifies amount of local ssd to reserve with each instance. The type of disk is local-ssd. + * Specifies amount of local ssd to reserve with each instance. The type + * of disk is local-ssd. * @type string $location_hint - * An opaque location hint used to place the allocation close to other resources. This field is for use by internal tools that use the public API. + * An opaque location hint used to place the allocation close to other + * resources. + * This field is for use by internal tools that use the public API. * @type string $machine_type - * Specifies type of machine (name only) which has fixed number of vCPUs and fixed amount of memory. This also includes specifying custom machine type following custom-NUMBER_OF_CPUS-AMOUNT_OF_MEMORY pattern. + * Specifies type of machine (name only) which has fixed number of vCPUs + * and fixed amount of memory. This also includes specifying custom + * machine type following custom-NUMBER_OF_CPUS-AMOUNT_OF_MEMORY pattern. * @type string $min_cpu_platform * Minimum cpu platform the reservation. * } @@ -96,7 +107,8 @@ public function setGuestAccelerators($var) } /** - * Specifies amount of local ssd to reserve with each instance. The type of disk is local-ssd. + * Specifies amount of local ssd to reserve with each instance. The type + * of disk is local-ssd. * * Generated from protobuf field repeated .google.cloud.compute.v1.AllocationSpecificSKUAllocationAllocatedInstancePropertiesReservedDisk local_ssds = 229951299; * @return \Google\Protobuf\Internal\RepeatedField @@ -107,7 +119,8 @@ public function getLocalSsds() } /** - * Specifies amount of local ssd to reserve with each instance. The type of disk is local-ssd. + * Specifies amount of local ssd to reserve with each instance. The type + * of disk is local-ssd. * * Generated from protobuf field repeated .google.cloud.compute.v1.AllocationSpecificSKUAllocationAllocatedInstancePropertiesReservedDisk local_ssds = 229951299; * @param array<\Google\Cloud\Compute\V1\AllocationSpecificSKUAllocationAllocatedInstancePropertiesReservedDisk>|\Google\Protobuf\Internal\RepeatedField $var @@ -122,7 +135,9 @@ public function setLocalSsds($var) } /** - * An opaque location hint used to place the allocation close to other resources. This field is for use by internal tools that use the public API. + * An opaque location hint used to place the allocation close to other + * resources. + * This field is for use by internal tools that use the public API. * * Generated from protobuf field optional string location_hint = 350519505; * @return string @@ -143,7 +158,9 @@ public function clearLocationHint() } /** - * An opaque location hint used to place the allocation close to other resources. This field is for use by internal tools that use the public API. + * An opaque location hint used to place the allocation close to other + * resources. + * This field is for use by internal tools that use the public API. * * Generated from protobuf field optional string location_hint = 350519505; * @param string $var @@ -158,7 +175,9 @@ public function setLocationHint($var) } /** - * Specifies type of machine (name only) which has fixed number of vCPUs and fixed amount of memory. This also includes specifying custom machine type following custom-NUMBER_OF_CPUS-AMOUNT_OF_MEMORY pattern. + * Specifies type of machine (name only) which has fixed number of vCPUs + * and fixed amount of memory. This also includes specifying custom + * machine type following custom-NUMBER_OF_CPUS-AMOUNT_OF_MEMORY pattern. * * Generated from protobuf field optional string machine_type = 227711026; * @return string @@ -179,7 +198,9 @@ public function clearMachineType() } /** - * Specifies type of machine (name only) which has fixed number of vCPUs and fixed amount of memory. This also includes specifying custom machine type following custom-NUMBER_OF_CPUS-AMOUNT_OF_MEMORY pattern. + * Specifies type of machine (name only) which has fixed number of vCPUs + * and fixed amount of memory. This also includes specifying custom + * machine type following custom-NUMBER_OF_CPUS-AMOUNT_OF_MEMORY pattern. * * Generated from protobuf field optional string machine_type = 227711026; * @param string $var diff --git a/Compute/src/V1/AllocationSpecificSKUReservation.php b/Compute/src/V1/AllocationSpecificSKUReservation.php index 32da10c3c3f5..78539b26ec12 100644 --- a/Compute/src/V1/AllocationSpecificSKUReservation.php +++ b/Compute/src/V1/AllocationSpecificSKUReservation.php @@ -9,7 +9,8 @@ use Google\Protobuf\Internal\GPBUtil; /** - * This reservation type allows to pre allocate specific instance configuration. + * This reservation type allows to pre allocate specific instance + * configuration. * * Generated from protobuf message google.cloud.compute.v1.AllocationSpecificSKUReservation */ @@ -40,7 +41,13 @@ class AllocationSpecificSKUReservation extends \Google\Protobuf\Internal\Message */ protected $instance_properties = null; /** - * Specifies the instance template to create the reservation. If you use this field, you must exclude the instanceProperties field. This field is optional, and it can be a full or partial URL. For example, the following are all valid URLs to an instance template: - https://www.googleapis.com/compute/v1/projects/project /global/instanceTemplates/instanceTemplate - projects/project/global/instanceTemplates/instanceTemplate - global/instanceTemplates/instanceTemplate + * Specifies the instance template to create the reservation. If you use + * this field, you must exclude the instanceProperties field. + * This field is optional, and it can be a full or partial URL. For example, + * the following are all valid URLs to an instance template: + * - https://www.googleapis.com/compute/v1/projects/project/global/instanceTemplates/instanceTemplate + * - projects/project/global/instanceTemplates/instanceTemplate + * - global/instanceTemplates/instanceTemplate * * Generated from protobuf field optional string source_instance_template = 332423616; */ @@ -61,7 +68,13 @@ class AllocationSpecificSKUReservation extends \Google\Protobuf\Internal\Message * @type \Google\Cloud\Compute\V1\AllocationSpecificSKUAllocationReservedInstanceProperties $instance_properties * The instance properties for the reservation. * @type string $source_instance_template - * Specifies the instance template to create the reservation. If you use this field, you must exclude the instanceProperties field. This field is optional, and it can be a full or partial URL. For example, the following are all valid URLs to an instance template: - https://www.googleapis.com/compute/v1/projects/project /global/instanceTemplates/instanceTemplate - projects/project/global/instanceTemplates/instanceTemplate - global/instanceTemplates/instanceTemplate + * Specifies the instance template to create the reservation. If you use + * this field, you must exclude the instanceProperties field. + * This field is optional, and it can be a full or partial URL. For example, + * the following are all valid URLs to an instance template: + * - https://www.googleapis.com/compute/v1/projects/project/global/instanceTemplates/instanceTemplate + * - projects/project/global/instanceTemplates/instanceTemplate + * - global/instanceTemplates/instanceTemplate * } */ public function __construct($data = NULL) { @@ -214,7 +227,13 @@ public function setInstanceProperties($var) } /** - * Specifies the instance template to create the reservation. If you use this field, you must exclude the instanceProperties field. This field is optional, and it can be a full or partial URL. For example, the following are all valid URLs to an instance template: - https://www.googleapis.com/compute/v1/projects/project /global/instanceTemplates/instanceTemplate - projects/project/global/instanceTemplates/instanceTemplate - global/instanceTemplates/instanceTemplate + * Specifies the instance template to create the reservation. If you use + * this field, you must exclude the instanceProperties field. + * This field is optional, and it can be a full or partial URL. For example, + * the following are all valid URLs to an instance template: + * - https://www.googleapis.com/compute/v1/projects/project/global/instanceTemplates/instanceTemplate + * - projects/project/global/instanceTemplates/instanceTemplate + * - global/instanceTemplates/instanceTemplate * * Generated from protobuf field optional string source_instance_template = 332423616; * @return string @@ -235,7 +254,13 @@ public function clearSourceInstanceTemplate() } /** - * Specifies the instance template to create the reservation. If you use this field, you must exclude the instanceProperties field. This field is optional, and it can be a full or partial URL. For example, the following are all valid URLs to an instance template: - https://www.googleapis.com/compute/v1/projects/project /global/instanceTemplates/instanceTemplate - projects/project/global/instanceTemplates/instanceTemplate - global/instanceTemplates/instanceTemplate + * Specifies the instance template to create the reservation. If you use + * this field, you must exclude the instanceProperties field. + * This field is optional, and it can be a full or partial URL. For example, + * the following are all valid URLs to an instance template: + * - https://www.googleapis.com/compute/v1/projects/project/global/instanceTemplates/instanceTemplate + * - projects/project/global/instanceTemplates/instanceTemplate + * - global/instanceTemplates/instanceTemplate * * Generated from protobuf field optional string source_instance_template = 332423616; * @param string $var diff --git a/Compute/src/V1/Allowed.php b/Compute/src/V1/Allowed.php index 9e6e9fe0f44c..dea0f5bef808 100644 --- a/Compute/src/V1/Allowed.php +++ b/Compute/src/V1/Allowed.php @@ -15,13 +15,20 @@ class Allowed extends \Google\Protobuf\Internal\Message { /** - * The IP protocol to which this rule applies. The protocol type is required when creating a firewall rule. This value can either be one of the following well known protocol strings (tcp, udp, icmp, esp, ah, ipip, sctp) or the IP protocol number. + * The IP protocol to which this rule applies. The protocol type is + * required when creating a firewall rule. This value can either be one of the + * following well known protocol strings (tcp, udp,icmp, esp, ah, ipip,sctp) or the IP protocol number. * * Generated from protobuf field optional string I_p_protocol = 488094525; */ protected $I_p_protocol = null; /** - * An optional list of ports to which this rule applies. This field is only applicable for the UDP or TCP protocol. Each entry must be either an integer or a range. If not specified, this rule applies to connections through any port. Example inputs include: ["22"], ["80","443"], and ["12345-12349"]. + * An optional list of ports to which this rule applies. + * This field is only applicable for the UDP or TCP protocol. + * Each entry must be either an integer or a range. + * If not specified, this rule applies to connections through any port. + * Example inputs include: ["22"], ["80","443"], + * and ["12345-12349"]. * * Generated from protobuf field repeated string ports = 106854418; */ @@ -34,9 +41,16 @@ class Allowed extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $I_p_protocol - * The IP protocol to which this rule applies. The protocol type is required when creating a firewall rule. This value can either be one of the following well known protocol strings (tcp, udp, icmp, esp, ah, ipip, sctp) or the IP protocol number. + * The IP protocol to which this rule applies. The protocol type is + * required when creating a firewall rule. This value can either be one of the + * following well known protocol strings (tcp, udp,icmp, esp, ah, ipip,sctp) or the IP protocol number. * @type array|\Google\Protobuf\Internal\RepeatedField $ports - * An optional list of ports to which this rule applies. This field is only applicable for the UDP or TCP protocol. Each entry must be either an integer or a range. If not specified, this rule applies to connections through any port. Example inputs include: ["22"], ["80","443"], and ["12345-12349"]. + * An optional list of ports to which this rule applies. + * This field is only applicable for the UDP or TCP protocol. + * Each entry must be either an integer or a range. + * If not specified, this rule applies to connections through any port. + * Example inputs include: ["22"], ["80","443"], + * and ["12345-12349"]. * } */ public function __construct($data = NULL) { @@ -45,7 +59,9 @@ public function __construct($data = NULL) { } /** - * The IP protocol to which this rule applies. The protocol type is required when creating a firewall rule. This value can either be one of the following well known protocol strings (tcp, udp, icmp, esp, ah, ipip, sctp) or the IP protocol number. + * The IP protocol to which this rule applies. The protocol type is + * required when creating a firewall rule. This value can either be one of the + * following well known protocol strings (tcp, udp,icmp, esp, ah, ipip,sctp) or the IP protocol number. * * Generated from protobuf field optional string I_p_protocol = 488094525; * @return string @@ -66,7 +82,9 @@ public function clearIPProtocol() } /** - * The IP protocol to which this rule applies. The protocol type is required when creating a firewall rule. This value can either be one of the following well known protocol strings (tcp, udp, icmp, esp, ah, ipip, sctp) or the IP protocol number. + * The IP protocol to which this rule applies. The protocol type is + * required when creating a firewall rule. This value can either be one of the + * following well known protocol strings (tcp, udp,icmp, esp, ah, ipip,sctp) or the IP protocol number. * * Generated from protobuf field optional string I_p_protocol = 488094525; * @param string $var @@ -81,7 +99,12 @@ public function setIPProtocol($var) } /** - * An optional list of ports to which this rule applies. This field is only applicable for the UDP or TCP protocol. Each entry must be either an integer or a range. If not specified, this rule applies to connections through any port. Example inputs include: ["22"], ["80","443"], and ["12345-12349"]. + * An optional list of ports to which this rule applies. + * This field is only applicable for the UDP or TCP protocol. + * Each entry must be either an integer or a range. + * If not specified, this rule applies to connections through any port. + * Example inputs include: ["22"], ["80","443"], + * and ["12345-12349"]. * * Generated from protobuf field repeated string ports = 106854418; * @return \Google\Protobuf\Internal\RepeatedField @@ -92,7 +115,12 @@ public function getPorts() } /** - * An optional list of ports to which this rule applies. This field is only applicable for the UDP or TCP protocol. Each entry must be either an integer or a range. If not specified, this rule applies to connections through any port. Example inputs include: ["22"], ["80","443"], and ["12345-12349"]. + * An optional list of ports to which this rule applies. + * This field is only applicable for the UDP or TCP protocol. + * Each entry must be either an integer or a range. + * If not specified, this rule applies to connections through any port. + * Example inputs include: ["22"], ["80","443"], + * and ["12345-12349"]. * * Generated from protobuf field repeated string ports = 106854418; * @param array|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/AnnouncePublicAdvertisedPrefixeRequest.php b/Compute/src/V1/AnnouncePublicAdvertisedPrefixeRequest.php index b0090235f546..8eb1c2c0aec5 100644 --- a/Compute/src/V1/AnnouncePublicAdvertisedPrefixeRequest.php +++ b/Compute/src/V1/AnnouncePublicAdvertisedPrefixeRequest.php @@ -28,7 +28,17 @@ class AnnouncePublicAdvertisedPrefixeRequest extends \Google\Protobuf\Internal\M */ protected $public_advertised_prefix = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -60,7 +70,17 @@ public static function build(string $project, string $publicAdvertisedPrefix): s * @type string $public_advertised_prefix * The name of the public advertised prefix. It should comply with RFC1035. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -121,7 +141,17 @@ public function setPublicAdvertisedPrefix($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -142,7 +172,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/AnnouncePublicDelegatedPrefixeRequest.php b/Compute/src/V1/AnnouncePublicDelegatedPrefixeRequest.php index de067036128c..eb75ed82e3ed 100644 --- a/Compute/src/V1/AnnouncePublicDelegatedPrefixeRequest.php +++ b/Compute/src/V1/AnnouncePublicDelegatedPrefixeRequest.php @@ -28,13 +28,24 @@ class AnnouncePublicDelegatedPrefixeRequest extends \Google\Protobuf\Internal\Me */ protected $public_delegated_prefix = ''; /** - * The name of the region where the public delegated prefix is located. It should comply with RFC1035. + * The name of theregion where + * the public delegated prefix is located. It should comply with RFC1035. * * Generated from protobuf field string region = 138946292 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "region"]; */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -42,7 +53,8 @@ class AnnouncePublicDelegatedPrefixeRequest extends \Google\Protobuf\Internal\Me /** * @param string $project Project ID for this request. - * @param string $region The name of the region where the public delegated prefix is located. It should comply with RFC1035. + * @param string $region The name of theregion where + * the public delegated prefix is located. It should comply with RFC1035. * @param string $publicDelegatedPrefix The name of the public delegated prefix. It should comply with RFC1035. * * @return \Google\Cloud\Compute\V1\AnnouncePublicDelegatedPrefixeRequest @@ -68,9 +80,20 @@ public static function build(string $project, string $region, string $publicDele * @type string $public_delegated_prefix * The name of the public delegated prefix. It should comply with RFC1035. * @type string $region - * The name of the region where the public delegated prefix is located. It should comply with RFC1035. + * The name of theregion where + * the public delegated prefix is located. It should comply with RFC1035. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -131,7 +154,8 @@ public function setPublicDelegatedPrefix($var) } /** - * The name of the region where the public delegated prefix is located. It should comply with RFC1035. + * The name of theregion where + * the public delegated prefix is located. It should comply with RFC1035. * * Generated from protobuf field string region = 138946292 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "region"]; * @return string @@ -142,7 +166,8 @@ public function getRegion() } /** - * The name of the region where the public delegated prefix is located. It should comply with RFC1035. + * The name of theregion where + * the public delegated prefix is located. It should comply with RFC1035. * * Generated from protobuf field string region = 138946292 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "region"]; * @param string $var @@ -157,7 +182,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -178,7 +213,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/ApplyUpdatesToInstancesInstanceGroupManagerRequest.php b/Compute/src/V1/ApplyUpdatesToInstancesInstanceGroupManagerRequest.php index 56cec6c850bf..e6e8c69631c0 100644 --- a/Compute/src/V1/ApplyUpdatesToInstancesInstanceGroupManagerRequest.php +++ b/Compute/src/V1/ApplyUpdatesToInstancesInstanceGroupManagerRequest.php @@ -34,7 +34,8 @@ class ApplyUpdatesToInstancesInstanceGroupManagerRequest extends \Google\Protobu */ protected $project = ''; /** - * The name of the zone where the managed instance group is located. Should conform to RFC1035. + * The name of thezone + * where the managed instance group is located. Should conform to RFC1035. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; */ @@ -42,7 +43,8 @@ class ApplyUpdatesToInstancesInstanceGroupManagerRequest extends \Google\Protobu /** * @param string $project Project ID for this request. - * @param string $zone The name of the zone where the managed instance group is located. Should conform to RFC1035. + * @param string $zone The name of thezone + * where the managed instance group is located. Should conform to RFC1035. * @param string $instanceGroupManager The name of the managed instance group, should conform to RFC1035. * @param \Google\Cloud\Compute\V1\InstanceGroupManagersApplyUpdatesRequest $instanceGroupManagersApplyUpdatesRequestResource The body resource for this request * @@ -72,7 +74,8 @@ public static function build(string $project, string $zone, string $instanceGrou * @type string $project * Project ID for this request. * @type string $zone - * The name of the zone where the managed instance group is located. Should conform to RFC1035. + * The name of thezone + * where the managed instance group is located. Should conform to RFC1035. * } */ public function __construct($data = NULL) { @@ -169,7 +172,8 @@ public function setProject($var) } /** - * The name of the zone where the managed instance group is located. Should conform to RFC1035. + * The name of thezone + * where the managed instance group is located. Should conform to RFC1035. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; * @return string @@ -180,7 +184,8 @@ public function getZone() } /** - * The name of the zone where the managed instance group is located. Should conform to RFC1035. + * The name of thezone + * where the managed instance group is located. Should conform to RFC1035. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; * @param string $var diff --git a/Compute/src/V1/AttachDiskInstanceRequest.php b/Compute/src/V1/AttachDiskInstanceRequest.php index 3fe86109c07e..25d2a3f07067 100644 --- a/Compute/src/V1/AttachDiskInstanceRequest.php +++ b/Compute/src/V1/AttachDiskInstanceRequest.php @@ -22,7 +22,9 @@ class AttachDiskInstanceRequest extends \Google\Protobuf\Internal\Message */ protected $attached_disk_resource = null; /** - * Whether to force attach the regional disk even if it's currently attached to another instance. If you try to force attach a zonal disk to an instance, you will receive an error. + * Whether to force attach the regional disk even if it's currently attached + * to another instance. If you try to force attach a zonal disk to an + * instance, you will receive an error. * * Generated from protobuf field optional bool force_attach = 142758425; */ @@ -40,7 +42,17 @@ class AttachDiskInstanceRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -80,13 +92,25 @@ public static function build(string $project, string $zone, string $instance, \G * @type \Google\Cloud\Compute\V1\AttachedDisk $attached_disk_resource * The body resource for this request * @type bool $force_attach - * Whether to force attach the regional disk even if it's currently attached to another instance. If you try to force attach a zonal disk to an instance, you will receive an error. + * Whether to force attach the regional disk even if it's currently attached + * to another instance. If you try to force attach a zonal disk to an + * instance, you will receive an error. * @type string $instance * The instance name for this request. * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $zone * The name of the zone for this request. * } @@ -133,7 +157,9 @@ public function setAttachedDiskResource($var) } /** - * Whether to force attach the regional disk even if it's currently attached to another instance. If you try to force attach a zonal disk to an instance, you will receive an error. + * Whether to force attach the regional disk even if it's currently attached + * to another instance. If you try to force attach a zonal disk to an + * instance, you will receive an error. * * Generated from protobuf field optional bool force_attach = 142758425; * @return bool @@ -154,7 +180,9 @@ public function clearForceAttach() } /** - * Whether to force attach the regional disk even if it's currently attached to another instance. If you try to force attach a zonal disk to an instance, you will receive an error. + * Whether to force attach the regional disk even if it's currently attached + * to another instance. If you try to force attach a zonal disk to an + * instance, you will receive an error. * * Generated from protobuf field optional bool force_attach = 142758425; * @param bool $var @@ -221,7 +249,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -242,7 +280,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/AttachNetworkEndpointsGlobalNetworkEndpointGroupRequest.php b/Compute/src/V1/AttachNetworkEndpointsGlobalNetworkEndpointGroupRequest.php index cac3a8502abd..391780620277 100644 --- a/Compute/src/V1/AttachNetworkEndpointsGlobalNetworkEndpointGroupRequest.php +++ b/Compute/src/V1/AttachNetworkEndpointsGlobalNetworkEndpointGroupRequest.php @@ -22,7 +22,8 @@ class AttachNetworkEndpointsGlobalNetworkEndpointGroupRequest extends \Google\Pr */ protected $global_network_endpoint_groups_attach_endpoints_request_resource = null; /** - * The name of the network endpoint group where you are attaching network endpoints to. It should comply with RFC1035. + * The name of the network endpoint group where you are attaching network + * endpoints to. It should comply with RFC1035. * * Generated from protobuf field string network_endpoint_group = 433907078 [(.google.api.field_behavior) = REQUIRED]; */ @@ -34,7 +35,17 @@ class AttachNetworkEndpointsGlobalNetworkEndpointGroupRequest extends \Google\Pr */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -42,7 +53,8 @@ class AttachNetworkEndpointsGlobalNetworkEndpointGroupRequest extends \Google\Pr /** * @param string $project Project ID for this request. - * @param string $networkEndpointGroup The name of the network endpoint group where you are attaching network endpoints to. It should comply with RFC1035. + * @param string $networkEndpointGroup The name of the network endpoint group where you are attaching network + * endpoints to. It should comply with RFC1035. * @param \Google\Cloud\Compute\V1\GlobalNetworkEndpointGroupsAttachEndpointsRequest $globalNetworkEndpointGroupsAttachEndpointsRequestResource The body resource for this request * * @return \Google\Cloud\Compute\V1\AttachNetworkEndpointsGlobalNetworkEndpointGroupRequest @@ -66,11 +78,22 @@ public static function build(string $project, string $networkEndpointGroup, \Goo * @type \Google\Cloud\Compute\V1\GlobalNetworkEndpointGroupsAttachEndpointsRequest $global_network_endpoint_groups_attach_endpoints_request_resource * The body resource for this request * @type string $network_endpoint_group - * The name of the network endpoint group where you are attaching network endpoints to. It should comply with RFC1035. + * The name of the network endpoint group where you are attaching network + * endpoints to. It should comply with RFC1035. * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -115,7 +138,8 @@ public function setGlobalNetworkEndpointGroupsAttachEndpointsRequestResource($va } /** - * The name of the network endpoint group where you are attaching network endpoints to. It should comply with RFC1035. + * The name of the network endpoint group where you are attaching network + * endpoints to. It should comply with RFC1035. * * Generated from protobuf field string network_endpoint_group = 433907078 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -126,7 +150,8 @@ public function getNetworkEndpointGroup() } /** - * The name of the network endpoint group where you are attaching network endpoints to. It should comply with RFC1035. + * The name of the network endpoint group where you are attaching network + * endpoints to. It should comply with RFC1035. * * Generated from protobuf field string network_endpoint_group = 433907078 [(.google.api.field_behavior) = REQUIRED]; * @param string $var @@ -167,7 +192,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -188,7 +223,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/AttachNetworkEndpointsNetworkEndpointGroupRequest.php b/Compute/src/V1/AttachNetworkEndpointsNetworkEndpointGroupRequest.php index 12546b00b515..f4ed24957d56 100644 --- a/Compute/src/V1/AttachNetworkEndpointsNetworkEndpointGroupRequest.php +++ b/Compute/src/V1/AttachNetworkEndpointsNetworkEndpointGroupRequest.php @@ -16,7 +16,8 @@ class AttachNetworkEndpointsNetworkEndpointGroupRequest extends \Google\Protobuf\Internal\Message { /** - * The name of the network endpoint group where you are attaching network endpoints to. It should comply with RFC1035. + * The name of the network endpoint group where you are attaching network + * endpoints to. It should comply with RFC1035. * * Generated from protobuf field string network_endpoint_group = 433907078 [(.google.api.field_behavior) = REQUIRED]; */ @@ -34,13 +35,24 @@ class AttachNetworkEndpointsNetworkEndpointGroupRequest extends \Google\Protobuf */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ protected $request_id = null; /** - * The name of the zone where the network endpoint group is located. It should comply with RFC1035. + * The name of the zone where + * the network endpoint group is located. It should comply with RFC1035. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; */ @@ -48,8 +60,10 @@ class AttachNetworkEndpointsNetworkEndpointGroupRequest extends \Google\Protobuf /** * @param string $project Project ID for this request. - * @param string $zone The name of the zone where the network endpoint group is located. It should comply with RFC1035. - * @param string $networkEndpointGroup The name of the network endpoint group where you are attaching network endpoints to. It should comply with RFC1035. + * @param string $zone The name of the zone where + * the network endpoint group is located. It should comply with RFC1035. + * @param string $networkEndpointGroup The name of the network endpoint group where you are attaching network + * endpoints to. It should comply with RFC1035. * @param \Google\Cloud\Compute\V1\NetworkEndpointGroupsAttachEndpointsRequest $networkEndpointGroupsAttachEndpointsRequestResource The body resource for this request * * @return \Google\Cloud\Compute\V1\AttachNetworkEndpointsNetworkEndpointGroupRequest @@ -72,15 +86,27 @@ public static function build(string $project, string $zone, string $networkEndpo * Optional. Data for populating the Message object. * * @type string $network_endpoint_group - * The name of the network endpoint group where you are attaching network endpoints to. It should comply with RFC1035. + * The name of the network endpoint group where you are attaching network + * endpoints to. It should comply with RFC1035. * @type \Google\Cloud\Compute\V1\NetworkEndpointGroupsAttachEndpointsRequest $network_endpoint_groups_attach_endpoints_request_resource * The body resource for this request * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $zone - * The name of the zone where the network endpoint group is located. It should comply with RFC1035. + * The name of the zone where + * the network endpoint group is located. It should comply with RFC1035. * } */ public function __construct($data = NULL) { @@ -89,7 +115,8 @@ public function __construct($data = NULL) { } /** - * The name of the network endpoint group where you are attaching network endpoints to. It should comply with RFC1035. + * The name of the network endpoint group where you are attaching network + * endpoints to. It should comply with RFC1035. * * Generated from protobuf field string network_endpoint_group = 433907078 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -100,7 +127,8 @@ public function getNetworkEndpointGroup() } /** - * The name of the network endpoint group where you are attaching network endpoints to. It should comply with RFC1035. + * The name of the network endpoint group where you are attaching network + * endpoints to. It should comply with RFC1035. * * Generated from protobuf field string network_endpoint_group = 433907078 [(.google.api.field_behavior) = REQUIRED]; * @param string $var @@ -177,7 +205,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -198,7 +236,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var @@ -213,7 +261,8 @@ public function setRequestId($var) } /** - * The name of the zone where the network endpoint group is located. It should comply with RFC1035. + * The name of the zone where + * the network endpoint group is located. It should comply with RFC1035. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; * @return string @@ -224,7 +273,8 @@ public function getZone() } /** - * The name of the zone where the network endpoint group is located. It should comply with RFC1035. + * The name of the zone where + * the network endpoint group is located. It should comply with RFC1035. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; * @param string $var diff --git a/Compute/src/V1/AttachNetworkEndpointsRegionNetworkEndpointGroupRequest.php b/Compute/src/V1/AttachNetworkEndpointsRegionNetworkEndpointGroupRequest.php index 116c6deb2d4c..5a09ed4ba98d 100644 --- a/Compute/src/V1/AttachNetworkEndpointsRegionNetworkEndpointGroupRequest.php +++ b/Compute/src/V1/AttachNetworkEndpointsRegionNetworkEndpointGroupRequest.php @@ -16,7 +16,8 @@ class AttachNetworkEndpointsRegionNetworkEndpointGroupRequest extends \Google\Protobuf\Internal\Message { /** - * The name of the network endpoint group where you are attaching network endpoints to. It should comply with RFC1035. + * The name of the network endpoint group where you are attaching network + * endpoints to. It should comply with RFC1035. * * Generated from protobuf field string network_endpoint_group = 433907078 [(.google.api.field_behavior) = REQUIRED]; */ @@ -28,7 +29,9 @@ class AttachNetworkEndpointsRegionNetworkEndpointGroupRequest extends \Google\Pr */ protected $project = ''; /** - * The name of the region where you want to create the network endpoint group. It should comply with RFC1035. + * The name of the region where + * you want to create the network endpoint group. It should comply with + * RFC1035. * * Generated from protobuf field string region = 138946292 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "region"]; */ @@ -40,7 +43,17 @@ class AttachNetworkEndpointsRegionNetworkEndpointGroupRequest extends \Google\Pr */ protected $region_network_endpoint_groups_attach_endpoints_request_resource = null; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -48,8 +61,11 @@ class AttachNetworkEndpointsRegionNetworkEndpointGroupRequest extends \Google\Pr /** * @param string $project Project ID for this request. - * @param string $region The name of the region where you want to create the network endpoint group. It should comply with RFC1035. - * @param string $networkEndpointGroup The name of the network endpoint group where you are attaching network endpoints to. It should comply with RFC1035. + * @param string $region The name of the region where + * you want to create the network endpoint group. It should comply with + * RFC1035. + * @param string $networkEndpointGroup The name of the network endpoint group where you are attaching network + * endpoints to. It should comply with RFC1035. * @param \Google\Cloud\Compute\V1\RegionNetworkEndpointGroupsAttachEndpointsRequest $regionNetworkEndpointGroupsAttachEndpointsRequestResource The body resource for this request * * @return \Google\Cloud\Compute\V1\AttachNetworkEndpointsRegionNetworkEndpointGroupRequest @@ -72,15 +88,28 @@ public static function build(string $project, string $region, string $networkEnd * Optional. Data for populating the Message object. * * @type string $network_endpoint_group - * The name of the network endpoint group where you are attaching network endpoints to. It should comply with RFC1035. + * The name of the network endpoint group where you are attaching network + * endpoints to. It should comply with RFC1035. * @type string $project * Project ID for this request. * @type string $region - * The name of the region where you want to create the network endpoint group. It should comply with RFC1035. + * The name of the region where + * you want to create the network endpoint group. It should comply with + * RFC1035. * @type \Google\Cloud\Compute\V1\RegionNetworkEndpointGroupsAttachEndpointsRequest $region_network_endpoint_groups_attach_endpoints_request_resource * The body resource for this request * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -89,7 +118,8 @@ public function __construct($data = NULL) { } /** - * The name of the network endpoint group where you are attaching network endpoints to. It should comply with RFC1035. + * The name of the network endpoint group where you are attaching network + * endpoints to. It should comply with RFC1035. * * Generated from protobuf field string network_endpoint_group = 433907078 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -100,7 +130,8 @@ public function getNetworkEndpointGroup() } /** - * The name of the network endpoint group where you are attaching network endpoints to. It should comply with RFC1035. + * The name of the network endpoint group where you are attaching network + * endpoints to. It should comply with RFC1035. * * Generated from protobuf field string network_endpoint_group = 433907078 [(.google.api.field_behavior) = REQUIRED]; * @param string $var @@ -141,7 +172,9 @@ public function setProject($var) } /** - * The name of the region where you want to create the network endpoint group. It should comply with RFC1035. + * The name of the region where + * you want to create the network endpoint group. It should comply with + * RFC1035. * * Generated from protobuf field string region = 138946292 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "region"]; * @return string @@ -152,7 +185,9 @@ public function getRegion() } /** - * The name of the region where you want to create the network endpoint group. It should comply with RFC1035. + * The name of the region where + * you want to create the network endpoint group. It should comply with + * RFC1035. * * Generated from protobuf field string region = 138946292 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "region"]; * @param string $var @@ -203,7 +238,17 @@ public function setRegionNetworkEndpointGroupsAttachEndpointsRequestResource($va } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -224,7 +269,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/AttachedDisk.php b/Compute/src/V1/AttachedDisk.php index f4d4b85cdd42..9f3686a0eb02 100644 --- a/Compute/src/V1/AttachedDisk.php +++ b/Compute/src/V1/AttachedDisk.php @@ -16,32 +16,59 @@ class AttachedDisk extends \Google\Protobuf\Internal\Message { /** - * [Output Only] The architecture of the attached disk. Valid values are ARM64 or X86_64. + * [Output Only] The architecture of the attached disk. Valid values are ARM64 + * or X86_64. * Check the Architecture enum for the list of possible values. * * Generated from protobuf field optional string architecture = 302803283; */ protected $architecture = null; /** - * Specifies whether the disk will be auto-deleted when the instance is deleted (but not when the disk is detached from the instance). + * Specifies whether the disk will be auto-deleted when the instance is + * deleted (but not when the disk is detached from the instance). * * Generated from protobuf field optional bool auto_delete = 464761403; */ protected $auto_delete = null; /** - * Indicates that this is a boot disk. The virtual machine will use the first partition of the disk for its root filesystem. + * Indicates that this is a boot disk. The virtual machine will use the first + * partition of the disk for its root filesystem. * * Generated from protobuf field optional bool boot = 3029746; */ protected $boot = null; /** - * Specifies a unique device name of your choice that is reflected into the /dev/disk/by-id/google-* tree of a Linux operating system running within the instance. This name can be used to reference the device for mounting, resizing, and so on, from within the instance. If not specified, the server chooses a default device name to apply to this disk, in the form persistent-disk-x, where x is a number assigned by Google Compute Engine. This field is only applicable for persistent disks. + * Specifies a unique device name of your choice that is reflected into the/dev/disk/by-id/google-* tree of a Linux operating system + * running within the instance. This name can be used to reference the device + * for mounting, resizing, and so on, from within the instance. + * If not specified, the server chooses a default device name to apply to this + * disk, in the form persistent-disk-x, where x is a number + * assigned by Google Compute Engine. This field is only applicable for + * persistent disks. * * Generated from protobuf field optional string device_name = 67541716; */ protected $device_name = null; /** - * Encrypts or decrypts a disk using a customer-supplied encryption key. If you are creating a new disk, this field encrypts the new disk using an encryption key that you provide. If you are attaching an existing disk that is already encrypted, this field decrypts the disk using the customer-supplied encryption key. If you encrypt a disk using a customer-supplied key, you must provide the same key again when you attempt to use this resource at a later time. For example, you must provide the key when you create a snapshot or an image from the disk or when you attach the disk to a virtual machine instance. If you do not provide an encryption key, then the disk will be encrypted using an automatically generated key and you do not need to provide a key to use the disk later. Note: Instance templates do not store customer-supplied encryption keys, so you cannot use your own keys to encrypt disks in a managed instance group. You cannot create VMs that have disks with customer-supplied keys using the bulk insert method. + * Encrypts or decrypts a disk using acustomer-supplied + * encryption key. + * If you are creating a new disk, this field encrypts the new disk using + * an encryption key that you provide. If you are attaching an existing + * disk that is already encrypted, this field decrypts the disk using + * the customer-supplied encryption key. + * If you encrypt a disk using a customer-supplied key, you must provide the + * same key again when you attempt to use this resource at a later time. For + * example, you must provide the key when you create a snapshot or an image + * from the disk or when you attach the disk to a virtual machine instance. + * If you do not provide an encryption key, then the disk will be encrypted + * using an automatically generated key and you do not need to provide a key + * to use the disk later. + * Note: + * Instance templates do not storecustomer-supplied + * encryption keys, so you cannot use your own keys to encrypt disks in amanaged instance group. + * You cannot create VMs that have disks with customer-supplied keys using + * the bulk + * insert method. * * Generated from protobuf field optional .google.cloud.compute.v1.CustomerEncryptionKey disk_encryption_key = 271660677; */ @@ -53,38 +80,54 @@ class AttachedDisk extends \Google\Protobuf\Internal\Message */ protected $disk_size_gb = null; /** - * [Input Only] Whether to force attach the regional disk even if it's currently attached to another instance. If you try to force attach a zonal disk to an instance, you will receive an error. + * [Input Only] Whether to force attach the regional disk even if it's + * currently attached to another instance. If you try to force attach a zonal + * disk to an instance, you will receive an error. * * Generated from protobuf field optional bool force_attach = 142758425; */ protected $force_attach = null; /** - * A list of features to enable on the guest operating system. Applicable only for bootable images. Read Enabling guest operating system features to see a list of available options. + * A list of features to enable on the guest operating system. Applicable + * only for bootable images. Read + * Enabling guest operating system features to see a list of available + * options. * * Generated from protobuf field repeated .google.cloud.compute.v1.GuestOsFeature guest_os_features = 79294545; */ private $guest_os_features; /** - * [Output Only] A zero-based index to this disk, where 0 is reserved for the boot disk. If you have many disks attached to an instance, each disk would have a unique index number. + * [Output Only] A zero-based index to this disk, where 0 is reserved for the + * boot disk. If you have many disks attached to an instance, each + * disk would have a unique index number. * * Generated from protobuf field optional int32 index = 100346066; */ protected $index = null; /** - * [Input Only] Specifies the parameters for a new disk that will be created alongside the new instance. Use initialization parameters to create boot disks or local SSDs attached to the new instance. This property is mutually exclusive with the source property; you can only define one or the other, but not both. + * [Input Only] Specifies the parameters for a new disk that will be created + * alongside the new instance. Use initialization parameters to create boot + * disks or local SSDs attached to the new instance. + * This property is mutually exclusive with the source property; + * you can only define one or the other, but not both. * * Generated from protobuf field optional .google.cloud.compute.v1.AttachedDiskInitializeParams initialize_params = 17697045; */ protected $initialize_params = null; /** - * Specifies the disk interface to use for attaching this disk, which is either SCSI or NVME. For most machine types, the default is SCSI. Local SSDs can use either NVME or SCSI. In certain configurations, persistent disks can use NVMe. For more information, see About persistent disks. + * Specifies the disk interface to use for attaching this disk, which is + * either SCSI or NVME. For most machine types, the + * default is SCSI. Local SSDs can use either NVME or SCSI. + * In certain configurations, persistent disks can use NVMe. For more + * information, seeAbout + * persistent disks. * Check the Interface enum for the list of possible values. * * Generated from protobuf field optional string interface = 502623545; */ protected $interface = null; /** - * [Output Only] Type of the resource. Always compute#attachedDisk for attached disks. + * [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks. * * Generated from protobuf field optional string kind = 3292052; */ @@ -96,14 +139,19 @@ class AttachedDisk extends \Google\Protobuf\Internal\Message */ private $licenses; /** - * The mode in which to attach this disk, either READ_WRITE or READ_ONLY. If not specified, the default is to attach the disk in READ_WRITE mode. + * The mode in which to attach this disk, either READ_WRITE orREAD_ONLY. If not specified, the default is to attach the disk + * in READ_WRITE mode. * Check the Mode enum for the list of possible values. * * Generated from protobuf field optional string mode = 3357091; */ protected $mode = null; /** - * For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this field is set to PRESERVED if the LocalSSD data has been saved to a persistent location by customer request. (see the discard_local_ssd option on Stop/Suspend). Read-only in the api. + * For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this + * field is set to PRESERVED if the LocalSSD data has been saved + * to a persistent location by customer request. (see the + * discard_local_ssd option on Stop/Suspend). + * Read-only in the api. * Check the SavedState enum for the list of possible values. * * Generated from protobuf field optional string saved_state = 411587801; @@ -116,13 +164,19 @@ class AttachedDisk extends \Google\Protobuf\Internal\Message */ protected $shielded_instance_initial_state = null; /** - * Specifies a valid partial or full URL to an existing Persistent Disk resource. When creating a new instance boot disk, one of initializeParams.sourceImage or initializeParams.sourceSnapshot or disks.source is required. If desired, you can also attach existing non-root persistent disks using this property. This field is only applicable for persistent disks. Note that for InstanceTemplate, specify the disk name for zonal disk, and the URL for regional disk. + * Specifies a valid partial or full URL to an existing Persistent Disk + * resource. When creating a new instance boot disk, one ofinitializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source + * is required. + * If desired, you can also attach existing non-root persistent disks using + * this property. This field is only applicable for persistent disks. + * Note that for InstanceTemplate, specify the disk name for zonal disk, + * and the URL for regional disk. * * Generated from protobuf field optional string source = 177235995; */ protected $source = null; /** - * Specifies the type of the disk, either SCRATCH or PERSISTENT. If not specified, the default is PERSISTENT. + * Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT. * Check the Type enum for the list of possible values. * * Generated from protobuf field optional string type = 3575610; @@ -136,45 +190,99 @@ class AttachedDisk extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $architecture - * [Output Only] The architecture of the attached disk. Valid values are ARM64 or X86_64. + * [Output Only] The architecture of the attached disk. Valid values are ARM64 + * or X86_64. * Check the Architecture enum for the list of possible values. * @type bool $auto_delete - * Specifies whether the disk will be auto-deleted when the instance is deleted (but not when the disk is detached from the instance). + * Specifies whether the disk will be auto-deleted when the instance is + * deleted (but not when the disk is detached from the instance). * @type bool $boot - * Indicates that this is a boot disk. The virtual machine will use the first partition of the disk for its root filesystem. + * Indicates that this is a boot disk. The virtual machine will use the first + * partition of the disk for its root filesystem. * @type string $device_name - * Specifies a unique device name of your choice that is reflected into the /dev/disk/by-id/google-* tree of a Linux operating system running within the instance. This name can be used to reference the device for mounting, resizing, and so on, from within the instance. If not specified, the server chooses a default device name to apply to this disk, in the form persistent-disk-x, where x is a number assigned by Google Compute Engine. This field is only applicable for persistent disks. + * Specifies a unique device name of your choice that is reflected into the/dev/disk/by-id/google-* tree of a Linux operating system + * running within the instance. This name can be used to reference the device + * for mounting, resizing, and so on, from within the instance. + * If not specified, the server chooses a default device name to apply to this + * disk, in the form persistent-disk-x, where x is a number + * assigned by Google Compute Engine. This field is only applicable for + * persistent disks. * @type \Google\Cloud\Compute\V1\CustomerEncryptionKey $disk_encryption_key - * Encrypts or decrypts a disk using a customer-supplied encryption key. If you are creating a new disk, this field encrypts the new disk using an encryption key that you provide. If you are attaching an existing disk that is already encrypted, this field decrypts the disk using the customer-supplied encryption key. If you encrypt a disk using a customer-supplied key, you must provide the same key again when you attempt to use this resource at a later time. For example, you must provide the key when you create a snapshot or an image from the disk or when you attach the disk to a virtual machine instance. If you do not provide an encryption key, then the disk will be encrypted using an automatically generated key and you do not need to provide a key to use the disk later. Note: Instance templates do not store customer-supplied encryption keys, so you cannot use your own keys to encrypt disks in a managed instance group. You cannot create VMs that have disks with customer-supplied keys using the bulk insert method. + * Encrypts or decrypts a disk using acustomer-supplied + * encryption key. + * If you are creating a new disk, this field encrypts the new disk using + * an encryption key that you provide. If you are attaching an existing + * disk that is already encrypted, this field decrypts the disk using + * the customer-supplied encryption key. + * If you encrypt a disk using a customer-supplied key, you must provide the + * same key again when you attempt to use this resource at a later time. For + * example, you must provide the key when you create a snapshot or an image + * from the disk or when you attach the disk to a virtual machine instance. + * If you do not provide an encryption key, then the disk will be encrypted + * using an automatically generated key and you do not need to provide a key + * to use the disk later. + * Note: + * Instance templates do not storecustomer-supplied + * encryption keys, so you cannot use your own keys to encrypt disks in amanaged instance group. + * You cannot create VMs that have disks with customer-supplied keys using + * the bulk + * insert method. * @type int|string $disk_size_gb * The size of the disk in GB. * @type bool $force_attach - * [Input Only] Whether to force attach the regional disk even if it's currently attached to another instance. If you try to force attach a zonal disk to an instance, you will receive an error. + * [Input Only] Whether to force attach the regional disk even if it's + * currently attached to another instance. If you try to force attach a zonal + * disk to an instance, you will receive an error. * @type array<\Google\Cloud\Compute\V1\GuestOsFeature>|\Google\Protobuf\Internal\RepeatedField $guest_os_features - * A list of features to enable on the guest operating system. Applicable only for bootable images. Read Enabling guest operating system features to see a list of available options. + * A list of features to enable on the guest operating system. Applicable + * only for bootable images. Read + * Enabling guest operating system features to see a list of available + * options. * @type int $index - * [Output Only] A zero-based index to this disk, where 0 is reserved for the boot disk. If you have many disks attached to an instance, each disk would have a unique index number. + * [Output Only] A zero-based index to this disk, where 0 is reserved for the + * boot disk. If you have many disks attached to an instance, each + * disk would have a unique index number. * @type \Google\Cloud\Compute\V1\AttachedDiskInitializeParams $initialize_params - * [Input Only] Specifies the parameters for a new disk that will be created alongside the new instance. Use initialization parameters to create boot disks or local SSDs attached to the new instance. This property is mutually exclusive with the source property; you can only define one or the other, but not both. + * [Input Only] Specifies the parameters for a new disk that will be created + * alongside the new instance. Use initialization parameters to create boot + * disks or local SSDs attached to the new instance. + * This property is mutually exclusive with the source property; + * you can only define one or the other, but not both. * @type string $interface - * Specifies the disk interface to use for attaching this disk, which is either SCSI or NVME. For most machine types, the default is SCSI. Local SSDs can use either NVME or SCSI. In certain configurations, persistent disks can use NVMe. For more information, see About persistent disks. + * Specifies the disk interface to use for attaching this disk, which is + * either SCSI or NVME. For most machine types, the + * default is SCSI. Local SSDs can use either NVME or SCSI. + * In certain configurations, persistent disks can use NVMe. For more + * information, seeAbout + * persistent disks. * Check the Interface enum for the list of possible values. * @type string $kind - * [Output Only] Type of the resource. Always compute#attachedDisk for attached disks. + * [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks. * @type array|\Google\Protobuf\Internal\RepeatedField $licenses * [Output Only] Any valid publicly visible licenses. * @type string $mode - * The mode in which to attach this disk, either READ_WRITE or READ_ONLY. If not specified, the default is to attach the disk in READ_WRITE mode. + * The mode in which to attach this disk, either READ_WRITE orREAD_ONLY. If not specified, the default is to attach the disk + * in READ_WRITE mode. * Check the Mode enum for the list of possible values. * @type string $saved_state - * For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this field is set to PRESERVED if the LocalSSD data has been saved to a persistent location by customer request. (see the discard_local_ssd option on Stop/Suspend). Read-only in the api. + * For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this + * field is set to PRESERVED if the LocalSSD data has been saved + * to a persistent location by customer request. (see the + * discard_local_ssd option on Stop/Suspend). + * Read-only in the api. * Check the SavedState enum for the list of possible values. * @type \Google\Cloud\Compute\V1\InitialStateConfig $shielded_instance_initial_state * [Output Only] shielded vm initial state stored on disk * @type string $source - * Specifies a valid partial or full URL to an existing Persistent Disk resource. When creating a new instance boot disk, one of initializeParams.sourceImage or initializeParams.sourceSnapshot or disks.source is required. If desired, you can also attach existing non-root persistent disks using this property. This field is only applicable for persistent disks. Note that for InstanceTemplate, specify the disk name for zonal disk, and the URL for regional disk. + * Specifies a valid partial or full URL to an existing Persistent Disk + * resource. When creating a new instance boot disk, one ofinitializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source + * is required. + * If desired, you can also attach existing non-root persistent disks using + * this property. This field is only applicable for persistent disks. + * Note that for InstanceTemplate, specify the disk name for zonal disk, + * and the URL for regional disk. * @type string $type - * Specifies the type of the disk, either SCRATCH or PERSISTENT. If not specified, the default is PERSISTENT. + * Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT. * Check the Type enum for the list of possible values. * } */ @@ -184,7 +292,8 @@ public function __construct($data = NULL) { } /** - * [Output Only] The architecture of the attached disk. Valid values are ARM64 or X86_64. + * [Output Only] The architecture of the attached disk. Valid values are ARM64 + * or X86_64. * Check the Architecture enum for the list of possible values. * * Generated from protobuf field optional string architecture = 302803283; @@ -206,7 +315,8 @@ public function clearArchitecture() } /** - * [Output Only] The architecture of the attached disk. Valid values are ARM64 or X86_64. + * [Output Only] The architecture of the attached disk. Valid values are ARM64 + * or X86_64. * Check the Architecture enum for the list of possible values. * * Generated from protobuf field optional string architecture = 302803283; @@ -222,7 +332,8 @@ public function setArchitecture($var) } /** - * Specifies whether the disk will be auto-deleted when the instance is deleted (but not when the disk is detached from the instance). + * Specifies whether the disk will be auto-deleted when the instance is + * deleted (but not when the disk is detached from the instance). * * Generated from protobuf field optional bool auto_delete = 464761403; * @return bool @@ -243,7 +354,8 @@ public function clearAutoDelete() } /** - * Specifies whether the disk will be auto-deleted when the instance is deleted (but not when the disk is detached from the instance). + * Specifies whether the disk will be auto-deleted when the instance is + * deleted (but not when the disk is detached from the instance). * * Generated from protobuf field optional bool auto_delete = 464761403; * @param bool $var @@ -258,7 +370,8 @@ public function setAutoDelete($var) } /** - * Indicates that this is a boot disk. The virtual machine will use the first partition of the disk for its root filesystem. + * Indicates that this is a boot disk. The virtual machine will use the first + * partition of the disk for its root filesystem. * * Generated from protobuf field optional bool boot = 3029746; * @return bool @@ -279,7 +392,8 @@ public function clearBoot() } /** - * Indicates that this is a boot disk. The virtual machine will use the first partition of the disk for its root filesystem. + * Indicates that this is a boot disk. The virtual machine will use the first + * partition of the disk for its root filesystem. * * Generated from protobuf field optional bool boot = 3029746; * @param bool $var @@ -294,7 +408,13 @@ public function setBoot($var) } /** - * Specifies a unique device name of your choice that is reflected into the /dev/disk/by-id/google-* tree of a Linux operating system running within the instance. This name can be used to reference the device for mounting, resizing, and so on, from within the instance. If not specified, the server chooses a default device name to apply to this disk, in the form persistent-disk-x, where x is a number assigned by Google Compute Engine. This field is only applicable for persistent disks. + * Specifies a unique device name of your choice that is reflected into the/dev/disk/by-id/google-* tree of a Linux operating system + * running within the instance. This name can be used to reference the device + * for mounting, resizing, and so on, from within the instance. + * If not specified, the server chooses a default device name to apply to this + * disk, in the form persistent-disk-x, where x is a number + * assigned by Google Compute Engine. This field is only applicable for + * persistent disks. * * Generated from protobuf field optional string device_name = 67541716; * @return string @@ -315,7 +435,13 @@ public function clearDeviceName() } /** - * Specifies a unique device name of your choice that is reflected into the /dev/disk/by-id/google-* tree of a Linux operating system running within the instance. This name can be used to reference the device for mounting, resizing, and so on, from within the instance. If not specified, the server chooses a default device name to apply to this disk, in the form persistent-disk-x, where x is a number assigned by Google Compute Engine. This field is only applicable for persistent disks. + * Specifies a unique device name of your choice that is reflected into the/dev/disk/by-id/google-* tree of a Linux operating system + * running within the instance. This name can be used to reference the device + * for mounting, resizing, and so on, from within the instance. + * If not specified, the server chooses a default device name to apply to this + * disk, in the form persistent-disk-x, where x is a number + * assigned by Google Compute Engine. This field is only applicable for + * persistent disks. * * Generated from protobuf field optional string device_name = 67541716; * @param string $var @@ -330,7 +456,25 @@ public function setDeviceName($var) } /** - * Encrypts or decrypts a disk using a customer-supplied encryption key. If you are creating a new disk, this field encrypts the new disk using an encryption key that you provide. If you are attaching an existing disk that is already encrypted, this field decrypts the disk using the customer-supplied encryption key. If you encrypt a disk using a customer-supplied key, you must provide the same key again when you attempt to use this resource at a later time. For example, you must provide the key when you create a snapshot or an image from the disk or when you attach the disk to a virtual machine instance. If you do not provide an encryption key, then the disk will be encrypted using an automatically generated key and you do not need to provide a key to use the disk later. Note: Instance templates do not store customer-supplied encryption keys, so you cannot use your own keys to encrypt disks in a managed instance group. You cannot create VMs that have disks with customer-supplied keys using the bulk insert method. + * Encrypts or decrypts a disk using acustomer-supplied + * encryption key. + * If you are creating a new disk, this field encrypts the new disk using + * an encryption key that you provide. If you are attaching an existing + * disk that is already encrypted, this field decrypts the disk using + * the customer-supplied encryption key. + * If you encrypt a disk using a customer-supplied key, you must provide the + * same key again when you attempt to use this resource at a later time. For + * example, you must provide the key when you create a snapshot or an image + * from the disk or when you attach the disk to a virtual machine instance. + * If you do not provide an encryption key, then the disk will be encrypted + * using an automatically generated key and you do not need to provide a key + * to use the disk later. + * Note: + * Instance templates do not storecustomer-supplied + * encryption keys, so you cannot use your own keys to encrypt disks in amanaged instance group. + * You cannot create VMs that have disks with customer-supplied keys using + * the bulk + * insert method. * * Generated from protobuf field optional .google.cloud.compute.v1.CustomerEncryptionKey disk_encryption_key = 271660677; * @return \Google\Cloud\Compute\V1\CustomerEncryptionKey|null @@ -351,7 +495,25 @@ public function clearDiskEncryptionKey() } /** - * Encrypts or decrypts a disk using a customer-supplied encryption key. If you are creating a new disk, this field encrypts the new disk using an encryption key that you provide. If you are attaching an existing disk that is already encrypted, this field decrypts the disk using the customer-supplied encryption key. If you encrypt a disk using a customer-supplied key, you must provide the same key again when you attempt to use this resource at a later time. For example, you must provide the key when you create a snapshot or an image from the disk or when you attach the disk to a virtual machine instance. If you do not provide an encryption key, then the disk will be encrypted using an automatically generated key and you do not need to provide a key to use the disk later. Note: Instance templates do not store customer-supplied encryption keys, so you cannot use your own keys to encrypt disks in a managed instance group. You cannot create VMs that have disks with customer-supplied keys using the bulk insert method. + * Encrypts or decrypts a disk using acustomer-supplied + * encryption key. + * If you are creating a new disk, this field encrypts the new disk using + * an encryption key that you provide. If you are attaching an existing + * disk that is already encrypted, this field decrypts the disk using + * the customer-supplied encryption key. + * If you encrypt a disk using a customer-supplied key, you must provide the + * same key again when you attempt to use this resource at a later time. For + * example, you must provide the key when you create a snapshot or an image + * from the disk or when you attach the disk to a virtual machine instance. + * If you do not provide an encryption key, then the disk will be encrypted + * using an automatically generated key and you do not need to provide a key + * to use the disk later. + * Note: + * Instance templates do not storecustomer-supplied + * encryption keys, so you cannot use your own keys to encrypt disks in amanaged instance group. + * You cannot create VMs that have disks with customer-supplied keys using + * the bulk + * insert method. * * Generated from protobuf field optional .google.cloud.compute.v1.CustomerEncryptionKey disk_encryption_key = 271660677; * @param \Google\Cloud\Compute\V1\CustomerEncryptionKey $var @@ -402,7 +564,9 @@ public function setDiskSizeGb($var) } /** - * [Input Only] Whether to force attach the regional disk even if it's currently attached to another instance. If you try to force attach a zonal disk to an instance, you will receive an error. + * [Input Only] Whether to force attach the regional disk even if it's + * currently attached to another instance. If you try to force attach a zonal + * disk to an instance, you will receive an error. * * Generated from protobuf field optional bool force_attach = 142758425; * @return bool @@ -423,7 +587,9 @@ public function clearForceAttach() } /** - * [Input Only] Whether to force attach the regional disk even if it's currently attached to another instance. If you try to force attach a zonal disk to an instance, you will receive an error. + * [Input Only] Whether to force attach the regional disk even if it's + * currently attached to another instance. If you try to force attach a zonal + * disk to an instance, you will receive an error. * * Generated from protobuf field optional bool force_attach = 142758425; * @param bool $var @@ -438,7 +604,10 @@ public function setForceAttach($var) } /** - * A list of features to enable on the guest operating system. Applicable only for bootable images. Read Enabling guest operating system features to see a list of available options. + * A list of features to enable on the guest operating system. Applicable + * only for bootable images. Read + * Enabling guest operating system features to see a list of available + * options. * * Generated from protobuf field repeated .google.cloud.compute.v1.GuestOsFeature guest_os_features = 79294545; * @return \Google\Protobuf\Internal\RepeatedField @@ -449,7 +618,10 @@ public function getGuestOsFeatures() } /** - * A list of features to enable on the guest operating system. Applicable only for bootable images. Read Enabling guest operating system features to see a list of available options. + * A list of features to enable on the guest operating system. Applicable + * only for bootable images. Read + * Enabling guest operating system features to see a list of available + * options. * * Generated from protobuf field repeated .google.cloud.compute.v1.GuestOsFeature guest_os_features = 79294545; * @param array<\Google\Cloud\Compute\V1\GuestOsFeature>|\Google\Protobuf\Internal\RepeatedField $var @@ -464,7 +636,9 @@ public function setGuestOsFeatures($var) } /** - * [Output Only] A zero-based index to this disk, where 0 is reserved for the boot disk. If you have many disks attached to an instance, each disk would have a unique index number. + * [Output Only] A zero-based index to this disk, where 0 is reserved for the + * boot disk. If you have many disks attached to an instance, each + * disk would have a unique index number. * * Generated from protobuf field optional int32 index = 100346066; * @return int @@ -485,7 +659,9 @@ public function clearIndex() } /** - * [Output Only] A zero-based index to this disk, where 0 is reserved for the boot disk. If you have many disks attached to an instance, each disk would have a unique index number. + * [Output Only] A zero-based index to this disk, where 0 is reserved for the + * boot disk. If you have many disks attached to an instance, each + * disk would have a unique index number. * * Generated from protobuf field optional int32 index = 100346066; * @param int $var @@ -500,7 +676,11 @@ public function setIndex($var) } /** - * [Input Only] Specifies the parameters for a new disk that will be created alongside the new instance. Use initialization parameters to create boot disks or local SSDs attached to the new instance. This property is mutually exclusive with the source property; you can only define one or the other, but not both. + * [Input Only] Specifies the parameters for a new disk that will be created + * alongside the new instance. Use initialization parameters to create boot + * disks or local SSDs attached to the new instance. + * This property is mutually exclusive with the source property; + * you can only define one or the other, but not both. * * Generated from protobuf field optional .google.cloud.compute.v1.AttachedDiskInitializeParams initialize_params = 17697045; * @return \Google\Cloud\Compute\V1\AttachedDiskInitializeParams|null @@ -521,7 +701,11 @@ public function clearInitializeParams() } /** - * [Input Only] Specifies the parameters for a new disk that will be created alongside the new instance. Use initialization parameters to create boot disks or local SSDs attached to the new instance. This property is mutually exclusive with the source property; you can only define one or the other, but not both. + * [Input Only] Specifies the parameters for a new disk that will be created + * alongside the new instance. Use initialization parameters to create boot + * disks or local SSDs attached to the new instance. + * This property is mutually exclusive with the source property; + * you can only define one or the other, but not both. * * Generated from protobuf field optional .google.cloud.compute.v1.AttachedDiskInitializeParams initialize_params = 17697045; * @param \Google\Cloud\Compute\V1\AttachedDiskInitializeParams $var @@ -536,7 +720,12 @@ public function setInitializeParams($var) } /** - * Specifies the disk interface to use for attaching this disk, which is either SCSI or NVME. For most machine types, the default is SCSI. Local SSDs can use either NVME or SCSI. In certain configurations, persistent disks can use NVMe. For more information, see About persistent disks. + * Specifies the disk interface to use for attaching this disk, which is + * either SCSI or NVME. For most machine types, the + * default is SCSI. Local SSDs can use either NVME or SCSI. + * In certain configurations, persistent disks can use NVMe. For more + * information, seeAbout + * persistent disks. * Check the Interface enum for the list of possible values. * * Generated from protobuf field optional string interface = 502623545; @@ -558,7 +747,12 @@ public function clearInterface() } /** - * Specifies the disk interface to use for attaching this disk, which is either SCSI or NVME. For most machine types, the default is SCSI. Local SSDs can use either NVME or SCSI. In certain configurations, persistent disks can use NVMe. For more information, see About persistent disks. + * Specifies the disk interface to use for attaching this disk, which is + * either SCSI or NVME. For most machine types, the + * default is SCSI. Local SSDs can use either NVME or SCSI. + * In certain configurations, persistent disks can use NVMe. For more + * information, seeAbout + * persistent disks. * Check the Interface enum for the list of possible values. * * Generated from protobuf field optional string interface = 502623545; @@ -574,7 +768,7 @@ public function setInterface($var) } /** - * [Output Only] Type of the resource. Always compute#attachedDisk for attached disks. + * [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -595,7 +789,7 @@ public function clearKind() } /** - * [Output Only] Type of the resource. Always compute#attachedDisk for attached disks. + * [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -636,7 +830,8 @@ public function setLicenses($var) } /** - * The mode in which to attach this disk, either READ_WRITE or READ_ONLY. If not specified, the default is to attach the disk in READ_WRITE mode. + * The mode in which to attach this disk, either READ_WRITE orREAD_ONLY. If not specified, the default is to attach the disk + * in READ_WRITE mode. * Check the Mode enum for the list of possible values. * * Generated from protobuf field optional string mode = 3357091; @@ -658,7 +853,8 @@ public function clearMode() } /** - * The mode in which to attach this disk, either READ_WRITE or READ_ONLY. If not specified, the default is to attach the disk in READ_WRITE mode. + * The mode in which to attach this disk, either READ_WRITE orREAD_ONLY. If not specified, the default is to attach the disk + * in READ_WRITE mode. * Check the Mode enum for the list of possible values. * * Generated from protobuf field optional string mode = 3357091; @@ -674,7 +870,11 @@ public function setMode($var) } /** - * For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this field is set to PRESERVED if the LocalSSD data has been saved to a persistent location by customer request. (see the discard_local_ssd option on Stop/Suspend). Read-only in the api. + * For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this + * field is set to PRESERVED if the LocalSSD data has been saved + * to a persistent location by customer request. (see the + * discard_local_ssd option on Stop/Suspend). + * Read-only in the api. * Check the SavedState enum for the list of possible values. * * Generated from protobuf field optional string saved_state = 411587801; @@ -696,7 +896,11 @@ public function clearSavedState() } /** - * For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this field is set to PRESERVED if the LocalSSD data has been saved to a persistent location by customer request. (see the discard_local_ssd option on Stop/Suspend). Read-only in the api. + * For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this + * field is set to PRESERVED if the LocalSSD data has been saved + * to a persistent location by customer request. (see the + * discard_local_ssd option on Stop/Suspend). + * Read-only in the api. * Check the SavedState enum for the list of possible values. * * Generated from protobuf field optional string saved_state = 411587801; @@ -748,7 +952,13 @@ public function setShieldedInstanceInitialState($var) } /** - * Specifies a valid partial or full URL to an existing Persistent Disk resource. When creating a new instance boot disk, one of initializeParams.sourceImage or initializeParams.sourceSnapshot or disks.source is required. If desired, you can also attach existing non-root persistent disks using this property. This field is only applicable for persistent disks. Note that for InstanceTemplate, specify the disk name for zonal disk, and the URL for regional disk. + * Specifies a valid partial or full URL to an existing Persistent Disk + * resource. When creating a new instance boot disk, one ofinitializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source + * is required. + * If desired, you can also attach existing non-root persistent disks using + * this property. This field is only applicable for persistent disks. + * Note that for InstanceTemplate, specify the disk name for zonal disk, + * and the URL for regional disk. * * Generated from protobuf field optional string source = 177235995; * @return string @@ -769,7 +979,13 @@ public function clearSource() } /** - * Specifies a valid partial or full URL to an existing Persistent Disk resource. When creating a new instance boot disk, one of initializeParams.sourceImage or initializeParams.sourceSnapshot or disks.source is required. If desired, you can also attach existing non-root persistent disks using this property. This field is only applicable for persistent disks. Note that for InstanceTemplate, specify the disk name for zonal disk, and the URL for regional disk. + * Specifies a valid partial or full URL to an existing Persistent Disk + * resource. When creating a new instance boot disk, one ofinitializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source + * is required. + * If desired, you can also attach existing non-root persistent disks using + * this property. This field is only applicable for persistent disks. + * Note that for InstanceTemplate, specify the disk name for zonal disk, + * and the URL for regional disk. * * Generated from protobuf field optional string source = 177235995; * @param string $var @@ -784,7 +1000,7 @@ public function setSource($var) } /** - * Specifies the type of the disk, either SCRATCH or PERSISTENT. If not specified, the default is PERSISTENT. + * Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT. * Check the Type enum for the list of possible values. * * Generated from protobuf field optional string type = 3575610; @@ -806,7 +1022,7 @@ public function clearType() } /** - * Specifies the type of the disk, either SCRATCH or PERSISTENT. If not specified, the default is PERSISTENT. + * Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT. * Check the Type enum for the list of possible values. * * Generated from protobuf field optional string type = 3575610; diff --git a/Compute/src/V1/AttachedDisk/Architecture.php b/Compute/src/V1/AttachedDisk/Architecture.php index aac95c367d31..fbec46be494b 100644 --- a/Compute/src/V1/AttachedDisk/Architecture.php +++ b/Compute/src/V1/AttachedDisk/Architecture.php @@ -7,7 +7,8 @@ use UnexpectedValueException; /** - * [Output Only] The architecture of the attached disk. Valid values are ARM64 or X86_64. + * [Output Only] The architecture of the attached disk. Valid values are ARM64 + * or X86_64. * * Protobuf type google.cloud.compute.v1.AttachedDisk.Architecture */ diff --git a/Compute/src/V1/AttachedDisk/Mode.php b/Compute/src/V1/AttachedDisk/Mode.php index 466ab30c4066..58444bdf0bba 100644 --- a/Compute/src/V1/AttachedDisk/Mode.php +++ b/Compute/src/V1/AttachedDisk/Mode.php @@ -7,7 +7,8 @@ use UnexpectedValueException; /** - * The mode in which to attach this disk, either READ_WRITE or READ_ONLY. If not specified, the default is to attach the disk in READ_WRITE mode. + * The mode in which to attach this disk, either READ_WRITE orREAD_ONLY. If not specified, the default is to attach the disk + * in READ_WRITE mode. * * Protobuf type google.cloud.compute.v1.AttachedDisk.Mode */ @@ -20,13 +21,15 @@ class Mode */ const UNDEFINED_MODE = 0; /** - * Attaches this disk in read-only mode. Multiple virtual machines can use a disk in read-only mode at a time. + * Attaches this disk in read-only mode. Multiple virtual machines can use + * a disk in read-only mode at a time. * * Generated from protobuf enum READ_ONLY = 91950261; */ const READ_ONLY = 91950261; /** - * *[Default]* Attaches this disk in read-write mode. Only one virtual machine at a time can be attached to a disk in read-write mode. + * *[Default]* Attaches this disk in read-write mode. Only one + * virtual machine at a time can be attached to a disk in read-write mode. * * Generated from protobuf enum READ_WRITE = 173607894; */ diff --git a/Compute/src/V1/AttachedDisk/PBInterface.php b/Compute/src/V1/AttachedDisk/PBInterface.php index 2cb6d0dc2687..9f2aad95580a 100644 --- a/Compute/src/V1/AttachedDisk/PBInterface.php +++ b/Compute/src/V1/AttachedDisk/PBInterface.php @@ -7,7 +7,12 @@ use UnexpectedValueException; /** - * Specifies the disk interface to use for attaching this disk, which is either SCSI or NVME. For most machine types, the default is SCSI. Local SSDs can use either NVME or SCSI. In certain configurations, persistent disks can use NVMe. For more information, see About persistent disks. + * Specifies the disk interface to use for attaching this disk, which is + * either SCSI or NVME. For most machine types, the + * default is SCSI. Local SSDs can use either NVME or SCSI. + * In certain configurations, persistent disks can use NVMe. For more + * information, seeAbout + * persistent disks. * * Protobuf type google.cloud.compute.v1.AttachedDisk.Interface */ diff --git a/Compute/src/V1/AttachedDisk/SavedState.php b/Compute/src/V1/AttachedDisk/SavedState.php index bd2be02eb925..ad9fa61f4c87 100644 --- a/Compute/src/V1/AttachedDisk/SavedState.php +++ b/Compute/src/V1/AttachedDisk/SavedState.php @@ -7,7 +7,11 @@ use UnexpectedValueException; /** - * For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this field is set to PRESERVED if the LocalSSD data has been saved to a persistent location by customer request. (see the discard_local_ssd option on Stop/Suspend). Read-only in the api. + * For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this + * field is set to PRESERVED if the LocalSSD data has been saved + * to a persistent location by customer request. (see the + * discard_local_ssd option on Stop/Suspend). + * Read-only in the api. * * Protobuf type google.cloud.compute.v1.AttachedDisk.SavedState */ diff --git a/Compute/src/V1/AttachedDisk/Type.php b/Compute/src/V1/AttachedDisk/Type.php index ef8dfa675151..68b0ce99b911 100644 --- a/Compute/src/V1/AttachedDisk/Type.php +++ b/Compute/src/V1/AttachedDisk/Type.php @@ -7,7 +7,7 @@ use UnexpectedValueException; /** - * Specifies the type of the disk, either SCRATCH or PERSISTENT. If not specified, the default is PERSISTENT. + * Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT. * * Protobuf type google.cloud.compute.v1.AttachedDisk.Type */ diff --git a/Compute/src/V1/AttachedDiskInitializeParams.php b/Compute/src/V1/AttachedDiskInitializeParams.php index 9396837320f8..dcb8410931ae 100644 --- a/Compute/src/V1/AttachedDiskInitializeParams.php +++ b/Compute/src/V1/AttachedDiskInitializeParams.php @@ -9,14 +9,21 @@ use Google\Protobuf\Internal\GPBUtil; /** - * [Input Only] Specifies the parameters for a new disk that will be created alongside the new instance. Use initialization parameters to create boot disks or local SSDs attached to the new instance. This field is persisted and returned for instanceTemplate and not returned in the context of instance. This property is mutually exclusive with the source property; you can only define one or the other, but not both. + * [Input Only] Specifies the parameters for a new disk that will be created + * alongside the new instance. Use initialization parameters to create boot + * disks or local SSDs attached to the new instance. + * This field is persisted and returned for instanceTemplate and not returned + * in the context of instance. + * This property is mutually exclusive with the source property; + * you can only define one or the other, but not both. * * Generated from protobuf message google.cloud.compute.v1.AttachedDiskInitializeParams */ class AttachedDiskInitializeParams extends \Google\Protobuf\Internal\Message { /** - * The architecture of the attached disk. Valid values are arm64 or x86_64. + * The architecture of the attached disk. Valid values are + * arm64 or x86_64. * Check the Architecture enum for the list of possible values. * * Generated from protobuf field optional string architecture = 302803283; @@ -29,19 +36,39 @@ class AttachedDiskInitializeParams extends \Google\Protobuf\Internal\Message */ protected $description = null; /** - * Specifies the disk name. If not specified, the default is to use the name of the instance. If a disk with the same name already exists in the given region, the existing disk is attached to the new instance and the new disk is not created. + * Specifies the disk name. If not specified, the default is to use the name + * of the instance. If a disk with the same name already exists in the given + * region, the existing disk is attached to the new instance and the + * new disk is not created. * * Generated from protobuf field optional string disk_name = 92807149; */ protected $disk_name = null; /** - * Specifies the size of the disk in base-2 GB. The size must be at least 10 GB. If you specify a sourceImage, which is required for boot disks, the default size is the size of the sourceImage. If you do not specify a sourceImage, the default disk size is 500 GB. + * Specifies the size of the disk in base-2 GB. The size must be at least + * 10 GB. If you specify a sourceImage, which is required for + * boot disks, the default size is the size of the sourceImage. + * If you do not specify a sourceImage, the default disk size + * is 500 GB. * * Generated from protobuf field optional int64 disk_size_gb = 316263735; */ protected $disk_size_gb = null; /** - * Specifies the disk type to use to create the instance. If not specified, the default is pd-standard, specified using the full URL. For example: https://www.googleapis.com/compute/v1/projects/project/zones/zone /diskTypes/pd-standard For a full list of acceptable values, see Persistent disk types. If you specify this field when creating a VM, you can provide either the full or partial URL. For example, the following values are valid: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /diskTypes/diskType - projects/project/zones/zone/diskTypes/diskType - zones/zone/diskTypes/diskType If you specify this field when creating or updating an instance template or all-instances configuration, specify the type of the disk, not the URL. For example: pd-standard. + * Specifies the disk type to use to create the instance. If not specified, + * the default is pd-standard, specified using the full URL. + * For example: + * https://www.googleapis.com/compute/v1/projects/project/zones/zone/diskTypes/pd-standard + * For a full list of acceptable values, seePersistent disk + * types. If you specify this field when creating a VM, you can provide + * either the full or partial URL. For example, the following values are + * valid: + * - https://www.googleapis.com/compute/v1/projects/project/zones/zone/diskTypes/diskType + * - projects/project/zones/zone/diskTypes/diskType + * - zones/zone/diskTypes/diskType + * If you specify this field when creating or updating an instance template + * or all-instances configuration, specify the type of the disk, not the + * URL. For example: pd-standard. * * Generated from protobuf field optional string disk_type = 93009052; */ @@ -53,7 +80,8 @@ class AttachedDiskInitializeParams extends \Google\Protobuf\Internal\Message */ protected $enable_confidential_compute = null; /** - * Labels to apply to this disk. These can be later modified by the disks.setLabels method. This field is only applicable for persistent disks. + * Labels to apply to this disk. These can be later modified by thedisks.setLabels method. This field is only applicable for + * persistent disks. * * Generated from protobuf field map labels = 500195327; */ @@ -65,68 +93,119 @@ class AttachedDiskInitializeParams extends \Google\Protobuf\Internal\Message */ private $licenses; /** - * Specifies which action to take on instance update with this disk. Default is to use the existing disk. + * Specifies which action to take on instance update with this disk. Default + * is to use the existing disk. * Check the OnUpdateAction enum for the list of possible values. * * Generated from protobuf field optional string on_update_action = 202451980; */ protected $on_update_action = null; /** - * Indicates how many IOPS to provision for the disk. This sets the number of I/O operations per second that the disk can handle. Values must be between 10,000 and 120,000. For more details, see the Extreme persistent disk documentation. + * Indicates how many IOPS to provision for the disk. This sets the number + * of I/O operations per second that the disk can handle. Values must be + * between 10,000 and 120,000. For more details, see theExtreme persistent + * disk documentation. * * Generated from protobuf field optional int64 provisioned_iops = 186769108; */ protected $provisioned_iops = null; /** - * Indicates how much throughput to provision for the disk. This sets the number of throughput mb per second that the disk can handle. Values must greater than or equal to 1. + * Indicates how much throughput to provision for the disk. This sets the + * number of throughput mb per second that the disk can handle. Values must + * greater than or equal to 1. * * Generated from protobuf field optional int64 provisioned_throughput = 526524181; */ protected $provisioned_throughput = null; /** - * Required for each regional disk associated with the instance. Specify the URLs of the zones where the disk should be replicated to. You must provide exactly two replica zones, and one zone must be the same as the instance zone. + * Required for each regional disk associated with the instance. Specify + * the URLs of the zones where the disk should be replicated to. + * You must provide exactly two replica zones, and one zone must be the same + * as the instance zone. * * Generated from protobuf field repeated string replica_zones = 48438272; */ private $replica_zones; /** - * Resource manager tags to be bound to the disk. Tag keys and values have the same definition as resource manager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and values are in the format `tagValues/456`. The field is ignored (both PUT & PATCH) when empty. + * Resource manager tags to be bound to the disk. Tag keys and values + * have the same definition as resource + * manager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and + * values are in the format `tagValues/456`. The field is ignored (both PUT + * & PATCH) when empty. * * Generated from protobuf field map resource_manager_tags = 377671164; */ private $resource_manager_tags; /** - * Resource policies applied to this disk for automatic snapshot creations. Specified using the full or partial URL. For instance template, specify only the resource policy name. + * Resource policies applied to this disk for automatic snapshot creations. + * Specified using the full or partial URL. For instance template, specify + * only the resource policy name. * * Generated from protobuf field repeated string resource_policies = 22220385; */ private $resource_policies; /** - * The source image to create this disk. When creating a new instance boot disk, one of initializeParams.sourceImage or initializeParams.sourceSnapshot or disks.source is required. To create a disk with one of the public operating system images, specify the image by its family name. For example, specify family/debian-9 to use the latest Debian 9 image: projects/debian-cloud/global/images/family/debian-9 Alternatively, use a specific version of a public operating system image: projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD To create a disk with a custom image that you created, specify the image name in the following format: global/images/my-custom-image You can also specify a custom image by its image family, which returns the latest version of the image in that family. Replace the image name with family/family-name: global/images/family/my-image-family If the source image is deleted later, this field will not be set. + * The source image to create this disk. When creating a new instance boot + * disk, one of initializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source + * is required. + * To create a disk with one of the public operating system + * images, specify the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image: + * projects/debian-cloud/global/images/family/debian-9 + * Alternatively, use a specific version of a public operating system image: + * projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD + * To create a disk with a custom image that you created, specify the + * image name in the following format: + * global/images/my-custom-image + * You can also specify a custom image by its image family, which returns + * the latest version of the image in that family. Replace the image name + * with family/family-name: + * global/images/family/my-image-family + * If the source image is deleted later, this field will not be set. * * Generated from protobuf field optional string source_image = 50443319; */ protected $source_image = null; /** - * The customer-supplied encryption key of the source image. Required if the source image is protected by a customer-supplied encryption key. InstanceTemplate and InstancePropertiesPatch do not store customer-supplied encryption keys, so you cannot create disks for instances in a managed instance group if the source images are encrypted with your own keys. + * Thecustomer-supplied + * encryption key of the source image. Required if the source image is + * protected by a customer-supplied encryption key. + * InstanceTemplate and InstancePropertiesPatch do not storecustomer-supplied + * encryption keys, so you cannot create disks for instances in a managed instance group if the + * source images are encrypted with your own keys. * * Generated from protobuf field optional .google.cloud.compute.v1.CustomerEncryptionKey source_image_encryption_key = 381503659; */ protected $source_image_encryption_key = null; /** - * The source snapshot to create this disk. When creating a new instance boot disk, one of initializeParams.sourceSnapshot or initializeParams.sourceImage or disks.source is required. To create a disk with a snapshot that you created, specify the snapshot name in the following format: global/snapshots/my-backup If the source snapshot is deleted later, this field will not be set. Note: You cannot create VMs in bulk using a snapshot as the source. Use an image instead when you create VMs using the bulk insert method. + * The source snapshot to create this disk. When creating a new instance + * boot disk, one of initializeParams.sourceSnapshot orinitializeParams.sourceImage or disks.source + * is required. + * To create a disk with a snapshot that you created, specify the + * snapshot name in the following format: + * global/snapshots/my-backup + * If the source snapshot is deleted later, this field will not be set. + * Note: You cannot create VMs in bulk using a snapshot as the source. Use + * an image instead when you create VMs using + * the bulk + * insert method. * * Generated from protobuf field optional string source_snapshot = 126061928; */ protected $source_snapshot = null; /** - * The customer-supplied encryption key of the source snapshot. + * Thecustomer-supplied + * encryption key of the source snapshot. * * Generated from protobuf field optional .google.cloud.compute.v1.CustomerEncryptionKey source_snapshot_encryption_key = 303679322; */ protected $source_snapshot_encryption_key = null; /** - * The storage pool in which the new disk is created. You can provide this as a partial or full URL to the resource. For example, the following are valid values: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /storagePools/storagePool - projects/project/zones/zone/storagePools/storagePool - zones/zone/storagePools/storagePool + * The storage pool in which the new disk is created. You can provide + * this as a partial or full URL to the resource. For example, the following + * are valid values: + * - https://www.googleapis.com/compute/v1/projects/project/zones/zone/storagePools/storagePool + * - projects/project/zones/zone/storagePools/storagePool + * - zones/zone/storagePools/storagePool * * Generated from protobuf field optional string storage_pool = 360473440; */ @@ -139,45 +218,118 @@ class AttachedDiskInitializeParams extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $architecture - * The architecture of the attached disk. Valid values are arm64 or x86_64. + * The architecture of the attached disk. Valid values are + * arm64 or x86_64. * Check the Architecture enum for the list of possible values. * @type string $description * An optional description. Provide this property when creating the disk. * @type string $disk_name - * Specifies the disk name. If not specified, the default is to use the name of the instance. If a disk with the same name already exists in the given region, the existing disk is attached to the new instance and the new disk is not created. + * Specifies the disk name. If not specified, the default is to use the name + * of the instance. If a disk with the same name already exists in the given + * region, the existing disk is attached to the new instance and the + * new disk is not created. * @type int|string $disk_size_gb - * Specifies the size of the disk in base-2 GB. The size must be at least 10 GB. If you specify a sourceImage, which is required for boot disks, the default size is the size of the sourceImage. If you do not specify a sourceImage, the default disk size is 500 GB. + * Specifies the size of the disk in base-2 GB. The size must be at least + * 10 GB. If you specify a sourceImage, which is required for + * boot disks, the default size is the size of the sourceImage. + * If you do not specify a sourceImage, the default disk size + * is 500 GB. * @type string $disk_type - * Specifies the disk type to use to create the instance. If not specified, the default is pd-standard, specified using the full URL. For example: https://www.googleapis.com/compute/v1/projects/project/zones/zone /diskTypes/pd-standard For a full list of acceptable values, see Persistent disk types. If you specify this field when creating a VM, you can provide either the full or partial URL. For example, the following values are valid: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /diskTypes/diskType - projects/project/zones/zone/diskTypes/diskType - zones/zone/diskTypes/diskType If you specify this field when creating or updating an instance template or all-instances configuration, specify the type of the disk, not the URL. For example: pd-standard. + * Specifies the disk type to use to create the instance. If not specified, + * the default is pd-standard, specified using the full URL. + * For example: + * https://www.googleapis.com/compute/v1/projects/project/zones/zone/diskTypes/pd-standard + * For a full list of acceptable values, seePersistent disk + * types. If you specify this field when creating a VM, you can provide + * either the full or partial URL. For example, the following values are + * valid: + * - https://www.googleapis.com/compute/v1/projects/project/zones/zone/diskTypes/diskType + * - projects/project/zones/zone/diskTypes/diskType + * - zones/zone/diskTypes/diskType + * If you specify this field when creating or updating an instance template + * or all-instances configuration, specify the type of the disk, not the + * URL. For example: pd-standard. * @type bool $enable_confidential_compute * Whether this disk is using confidential compute mode. * @type array|\Google\Protobuf\Internal\MapField $labels - * Labels to apply to this disk. These can be later modified by the disks.setLabels method. This field is only applicable for persistent disks. + * Labels to apply to this disk. These can be later modified by thedisks.setLabels method. This field is only applicable for + * persistent disks. * @type array|\Google\Protobuf\Internal\RepeatedField $licenses * A list of publicly visible licenses. Reserved for Google's use. * @type string $on_update_action - * Specifies which action to take on instance update with this disk. Default is to use the existing disk. + * Specifies which action to take on instance update with this disk. Default + * is to use the existing disk. * Check the OnUpdateAction enum for the list of possible values. * @type int|string $provisioned_iops - * Indicates how many IOPS to provision for the disk. This sets the number of I/O operations per second that the disk can handle. Values must be between 10,000 and 120,000. For more details, see the Extreme persistent disk documentation. + * Indicates how many IOPS to provision for the disk. This sets the number + * of I/O operations per second that the disk can handle. Values must be + * between 10,000 and 120,000. For more details, see theExtreme persistent + * disk documentation. * @type int|string $provisioned_throughput - * Indicates how much throughput to provision for the disk. This sets the number of throughput mb per second that the disk can handle. Values must greater than or equal to 1. + * Indicates how much throughput to provision for the disk. This sets the + * number of throughput mb per second that the disk can handle. Values must + * greater than or equal to 1. * @type array|\Google\Protobuf\Internal\RepeatedField $replica_zones - * Required for each regional disk associated with the instance. Specify the URLs of the zones where the disk should be replicated to. You must provide exactly two replica zones, and one zone must be the same as the instance zone. + * Required for each regional disk associated with the instance. Specify + * the URLs of the zones where the disk should be replicated to. + * You must provide exactly two replica zones, and one zone must be the same + * as the instance zone. * @type array|\Google\Protobuf\Internal\MapField $resource_manager_tags - * Resource manager tags to be bound to the disk. Tag keys and values have the same definition as resource manager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and values are in the format `tagValues/456`. The field is ignored (both PUT & PATCH) when empty. + * Resource manager tags to be bound to the disk. Tag keys and values + * have the same definition as resource + * manager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and + * values are in the format `tagValues/456`. The field is ignored (both PUT + * & PATCH) when empty. * @type array|\Google\Protobuf\Internal\RepeatedField $resource_policies - * Resource policies applied to this disk for automatic snapshot creations. Specified using the full or partial URL. For instance template, specify only the resource policy name. + * Resource policies applied to this disk for automatic snapshot creations. + * Specified using the full or partial URL. For instance template, specify + * only the resource policy name. * @type string $source_image - * The source image to create this disk. When creating a new instance boot disk, one of initializeParams.sourceImage or initializeParams.sourceSnapshot or disks.source is required. To create a disk with one of the public operating system images, specify the image by its family name. For example, specify family/debian-9 to use the latest Debian 9 image: projects/debian-cloud/global/images/family/debian-9 Alternatively, use a specific version of a public operating system image: projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD To create a disk with a custom image that you created, specify the image name in the following format: global/images/my-custom-image You can also specify a custom image by its image family, which returns the latest version of the image in that family. Replace the image name with family/family-name: global/images/family/my-image-family If the source image is deleted later, this field will not be set. + * The source image to create this disk. When creating a new instance boot + * disk, one of initializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source + * is required. + * To create a disk with one of the public operating system + * images, specify the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image: + * projects/debian-cloud/global/images/family/debian-9 + * Alternatively, use a specific version of a public operating system image: + * projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD + * To create a disk with a custom image that you created, specify the + * image name in the following format: + * global/images/my-custom-image + * You can also specify a custom image by its image family, which returns + * the latest version of the image in that family. Replace the image name + * with family/family-name: + * global/images/family/my-image-family + * If the source image is deleted later, this field will not be set. * @type \Google\Cloud\Compute\V1\CustomerEncryptionKey $source_image_encryption_key - * The customer-supplied encryption key of the source image. Required if the source image is protected by a customer-supplied encryption key. InstanceTemplate and InstancePropertiesPatch do not store customer-supplied encryption keys, so you cannot create disks for instances in a managed instance group if the source images are encrypted with your own keys. + * Thecustomer-supplied + * encryption key of the source image. Required if the source image is + * protected by a customer-supplied encryption key. + * InstanceTemplate and InstancePropertiesPatch do not storecustomer-supplied + * encryption keys, so you cannot create disks for instances in a managed instance group if the + * source images are encrypted with your own keys. * @type string $source_snapshot - * The source snapshot to create this disk. When creating a new instance boot disk, one of initializeParams.sourceSnapshot or initializeParams.sourceImage or disks.source is required. To create a disk with a snapshot that you created, specify the snapshot name in the following format: global/snapshots/my-backup If the source snapshot is deleted later, this field will not be set. Note: You cannot create VMs in bulk using a snapshot as the source. Use an image instead when you create VMs using the bulk insert method. + * The source snapshot to create this disk. When creating a new instance + * boot disk, one of initializeParams.sourceSnapshot orinitializeParams.sourceImage or disks.source + * is required. + * To create a disk with a snapshot that you created, specify the + * snapshot name in the following format: + * global/snapshots/my-backup + * If the source snapshot is deleted later, this field will not be set. + * Note: You cannot create VMs in bulk using a snapshot as the source. Use + * an image instead when you create VMs using + * the bulk + * insert method. * @type \Google\Cloud\Compute\V1\CustomerEncryptionKey $source_snapshot_encryption_key - * The customer-supplied encryption key of the source snapshot. + * Thecustomer-supplied + * encryption key of the source snapshot. * @type string $storage_pool - * The storage pool in which the new disk is created. You can provide this as a partial or full URL to the resource. For example, the following are valid values: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /storagePools/storagePool - projects/project/zones/zone/storagePools/storagePool - zones/zone/storagePools/storagePool + * The storage pool in which the new disk is created. You can provide + * this as a partial or full URL to the resource. For example, the following + * are valid values: + * - https://www.googleapis.com/compute/v1/projects/project/zones/zone/storagePools/storagePool + * - projects/project/zones/zone/storagePools/storagePool + * - zones/zone/storagePools/storagePool * } */ public function __construct($data = NULL) { @@ -186,7 +338,8 @@ public function __construct($data = NULL) { } /** - * The architecture of the attached disk. Valid values are arm64 or x86_64. + * The architecture of the attached disk. Valid values are + * arm64 or x86_64. * Check the Architecture enum for the list of possible values. * * Generated from protobuf field optional string architecture = 302803283; @@ -208,7 +361,8 @@ public function clearArchitecture() } /** - * The architecture of the attached disk. Valid values are arm64 or x86_64. + * The architecture of the attached disk. Valid values are + * arm64 or x86_64. * Check the Architecture enum for the list of possible values. * * Generated from protobuf field optional string architecture = 302803283; @@ -260,7 +414,10 @@ public function setDescription($var) } /** - * Specifies the disk name. If not specified, the default is to use the name of the instance. If a disk with the same name already exists in the given region, the existing disk is attached to the new instance and the new disk is not created. + * Specifies the disk name. If not specified, the default is to use the name + * of the instance. If a disk with the same name already exists in the given + * region, the existing disk is attached to the new instance and the + * new disk is not created. * * Generated from protobuf field optional string disk_name = 92807149; * @return string @@ -281,7 +438,10 @@ public function clearDiskName() } /** - * Specifies the disk name. If not specified, the default is to use the name of the instance. If a disk with the same name already exists in the given region, the existing disk is attached to the new instance and the new disk is not created. + * Specifies the disk name. If not specified, the default is to use the name + * of the instance. If a disk with the same name already exists in the given + * region, the existing disk is attached to the new instance and the + * new disk is not created. * * Generated from protobuf field optional string disk_name = 92807149; * @param string $var @@ -296,7 +456,11 @@ public function setDiskName($var) } /** - * Specifies the size of the disk in base-2 GB. The size must be at least 10 GB. If you specify a sourceImage, which is required for boot disks, the default size is the size of the sourceImage. If you do not specify a sourceImage, the default disk size is 500 GB. + * Specifies the size of the disk in base-2 GB. The size must be at least + * 10 GB. If you specify a sourceImage, which is required for + * boot disks, the default size is the size of the sourceImage. + * If you do not specify a sourceImage, the default disk size + * is 500 GB. * * Generated from protobuf field optional int64 disk_size_gb = 316263735; * @return int|string @@ -317,7 +481,11 @@ public function clearDiskSizeGb() } /** - * Specifies the size of the disk in base-2 GB. The size must be at least 10 GB. If you specify a sourceImage, which is required for boot disks, the default size is the size of the sourceImage. If you do not specify a sourceImage, the default disk size is 500 GB. + * Specifies the size of the disk in base-2 GB. The size must be at least + * 10 GB. If you specify a sourceImage, which is required for + * boot disks, the default size is the size of the sourceImage. + * If you do not specify a sourceImage, the default disk size + * is 500 GB. * * Generated from protobuf field optional int64 disk_size_gb = 316263735; * @param int|string $var @@ -332,7 +500,20 @@ public function setDiskSizeGb($var) } /** - * Specifies the disk type to use to create the instance. If not specified, the default is pd-standard, specified using the full URL. For example: https://www.googleapis.com/compute/v1/projects/project/zones/zone /diskTypes/pd-standard For a full list of acceptable values, see Persistent disk types. If you specify this field when creating a VM, you can provide either the full or partial URL. For example, the following values are valid: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /diskTypes/diskType - projects/project/zones/zone/diskTypes/diskType - zones/zone/diskTypes/diskType If you specify this field when creating or updating an instance template or all-instances configuration, specify the type of the disk, not the URL. For example: pd-standard. + * Specifies the disk type to use to create the instance. If not specified, + * the default is pd-standard, specified using the full URL. + * For example: + * https://www.googleapis.com/compute/v1/projects/project/zones/zone/diskTypes/pd-standard + * For a full list of acceptable values, seePersistent disk + * types. If you specify this field when creating a VM, you can provide + * either the full or partial URL. For example, the following values are + * valid: + * - https://www.googleapis.com/compute/v1/projects/project/zones/zone/diskTypes/diskType + * - projects/project/zones/zone/diskTypes/diskType + * - zones/zone/diskTypes/diskType + * If you specify this field when creating or updating an instance template + * or all-instances configuration, specify the type of the disk, not the + * URL. For example: pd-standard. * * Generated from protobuf field optional string disk_type = 93009052; * @return string @@ -353,7 +534,20 @@ public function clearDiskType() } /** - * Specifies the disk type to use to create the instance. If not specified, the default is pd-standard, specified using the full URL. For example: https://www.googleapis.com/compute/v1/projects/project/zones/zone /diskTypes/pd-standard For a full list of acceptable values, see Persistent disk types. If you specify this field when creating a VM, you can provide either the full or partial URL. For example, the following values are valid: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /diskTypes/diskType - projects/project/zones/zone/diskTypes/diskType - zones/zone/diskTypes/diskType If you specify this field when creating or updating an instance template or all-instances configuration, specify the type of the disk, not the URL. For example: pd-standard. + * Specifies the disk type to use to create the instance. If not specified, + * the default is pd-standard, specified using the full URL. + * For example: + * https://www.googleapis.com/compute/v1/projects/project/zones/zone/diskTypes/pd-standard + * For a full list of acceptable values, seePersistent disk + * types. If you specify this field when creating a VM, you can provide + * either the full or partial URL. For example, the following values are + * valid: + * - https://www.googleapis.com/compute/v1/projects/project/zones/zone/diskTypes/diskType + * - projects/project/zones/zone/diskTypes/diskType + * - zones/zone/diskTypes/diskType + * If you specify this field when creating or updating an instance template + * or all-instances configuration, specify the type of the disk, not the + * URL. For example: pd-standard. * * Generated from protobuf field optional string disk_type = 93009052; * @param string $var @@ -404,7 +598,8 @@ public function setEnableConfidentialCompute($var) } /** - * Labels to apply to this disk. These can be later modified by the disks.setLabels method. This field is only applicable for persistent disks. + * Labels to apply to this disk. These can be later modified by thedisks.setLabels method. This field is only applicable for + * persistent disks. * * Generated from protobuf field map labels = 500195327; * @return \Google\Protobuf\Internal\MapField @@ -415,7 +610,8 @@ public function getLabels() } /** - * Labels to apply to this disk. These can be later modified by the disks.setLabels method. This field is only applicable for persistent disks. + * Labels to apply to this disk. These can be later modified by thedisks.setLabels method. This field is only applicable for + * persistent disks. * * Generated from protobuf field map labels = 500195327; * @param array|\Google\Protobuf\Internal\MapField $var @@ -456,7 +652,8 @@ public function setLicenses($var) } /** - * Specifies which action to take on instance update with this disk. Default is to use the existing disk. + * Specifies which action to take on instance update with this disk. Default + * is to use the existing disk. * Check the OnUpdateAction enum for the list of possible values. * * Generated from protobuf field optional string on_update_action = 202451980; @@ -478,7 +675,8 @@ public function clearOnUpdateAction() } /** - * Specifies which action to take on instance update with this disk. Default is to use the existing disk. + * Specifies which action to take on instance update with this disk. Default + * is to use the existing disk. * Check the OnUpdateAction enum for the list of possible values. * * Generated from protobuf field optional string on_update_action = 202451980; @@ -494,7 +692,10 @@ public function setOnUpdateAction($var) } /** - * Indicates how many IOPS to provision for the disk. This sets the number of I/O operations per second that the disk can handle. Values must be between 10,000 and 120,000. For more details, see the Extreme persistent disk documentation. + * Indicates how many IOPS to provision for the disk. This sets the number + * of I/O operations per second that the disk can handle. Values must be + * between 10,000 and 120,000. For more details, see theExtreme persistent + * disk documentation. * * Generated from protobuf field optional int64 provisioned_iops = 186769108; * @return int|string @@ -515,7 +716,10 @@ public function clearProvisionedIops() } /** - * Indicates how many IOPS to provision for the disk. This sets the number of I/O operations per second that the disk can handle. Values must be between 10,000 and 120,000. For more details, see the Extreme persistent disk documentation. + * Indicates how many IOPS to provision for the disk. This sets the number + * of I/O operations per second that the disk can handle. Values must be + * between 10,000 and 120,000. For more details, see theExtreme persistent + * disk documentation. * * Generated from protobuf field optional int64 provisioned_iops = 186769108; * @param int|string $var @@ -530,7 +734,9 @@ public function setProvisionedIops($var) } /** - * Indicates how much throughput to provision for the disk. This sets the number of throughput mb per second that the disk can handle. Values must greater than or equal to 1. + * Indicates how much throughput to provision for the disk. This sets the + * number of throughput mb per second that the disk can handle. Values must + * greater than or equal to 1. * * Generated from protobuf field optional int64 provisioned_throughput = 526524181; * @return int|string @@ -551,7 +757,9 @@ public function clearProvisionedThroughput() } /** - * Indicates how much throughput to provision for the disk. This sets the number of throughput mb per second that the disk can handle. Values must greater than or equal to 1. + * Indicates how much throughput to provision for the disk. This sets the + * number of throughput mb per second that the disk can handle. Values must + * greater than or equal to 1. * * Generated from protobuf field optional int64 provisioned_throughput = 526524181; * @param int|string $var @@ -566,7 +774,10 @@ public function setProvisionedThroughput($var) } /** - * Required for each regional disk associated with the instance. Specify the URLs of the zones where the disk should be replicated to. You must provide exactly two replica zones, and one zone must be the same as the instance zone. + * Required for each regional disk associated with the instance. Specify + * the URLs of the zones where the disk should be replicated to. + * You must provide exactly two replica zones, and one zone must be the same + * as the instance zone. * * Generated from protobuf field repeated string replica_zones = 48438272; * @return \Google\Protobuf\Internal\RepeatedField @@ -577,7 +788,10 @@ public function getReplicaZones() } /** - * Required for each regional disk associated with the instance. Specify the URLs of the zones where the disk should be replicated to. You must provide exactly two replica zones, and one zone must be the same as the instance zone. + * Required for each regional disk associated with the instance. Specify + * the URLs of the zones where the disk should be replicated to. + * You must provide exactly two replica zones, and one zone must be the same + * as the instance zone. * * Generated from protobuf field repeated string replica_zones = 48438272; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -592,7 +806,11 @@ public function setReplicaZones($var) } /** - * Resource manager tags to be bound to the disk. Tag keys and values have the same definition as resource manager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and values are in the format `tagValues/456`. The field is ignored (both PUT & PATCH) when empty. + * Resource manager tags to be bound to the disk. Tag keys and values + * have the same definition as resource + * manager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and + * values are in the format `tagValues/456`. The field is ignored (both PUT + * & PATCH) when empty. * * Generated from protobuf field map resource_manager_tags = 377671164; * @return \Google\Protobuf\Internal\MapField @@ -603,7 +821,11 @@ public function getResourceManagerTags() } /** - * Resource manager tags to be bound to the disk. Tag keys and values have the same definition as resource manager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and values are in the format `tagValues/456`. The field is ignored (both PUT & PATCH) when empty. + * Resource manager tags to be bound to the disk. Tag keys and values + * have the same definition as resource + * manager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and + * values are in the format `tagValues/456`. The field is ignored (both PUT + * & PATCH) when empty. * * Generated from protobuf field map resource_manager_tags = 377671164; * @param array|\Google\Protobuf\Internal\MapField $var @@ -618,7 +840,9 @@ public function setResourceManagerTags($var) } /** - * Resource policies applied to this disk for automatic snapshot creations. Specified using the full or partial URL. For instance template, specify only the resource policy name. + * Resource policies applied to this disk for automatic snapshot creations. + * Specified using the full or partial URL. For instance template, specify + * only the resource policy name. * * Generated from protobuf field repeated string resource_policies = 22220385; * @return \Google\Protobuf\Internal\RepeatedField @@ -629,7 +853,9 @@ public function getResourcePolicies() } /** - * Resource policies applied to this disk for automatic snapshot creations. Specified using the full or partial URL. For instance template, specify only the resource policy name. + * Resource policies applied to this disk for automatic snapshot creations. + * Specified using the full or partial URL. For instance template, specify + * only the resource policy name. * * Generated from protobuf field repeated string resource_policies = 22220385; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -644,7 +870,22 @@ public function setResourcePolicies($var) } /** - * The source image to create this disk. When creating a new instance boot disk, one of initializeParams.sourceImage or initializeParams.sourceSnapshot or disks.source is required. To create a disk with one of the public operating system images, specify the image by its family name. For example, specify family/debian-9 to use the latest Debian 9 image: projects/debian-cloud/global/images/family/debian-9 Alternatively, use a specific version of a public operating system image: projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD To create a disk with a custom image that you created, specify the image name in the following format: global/images/my-custom-image You can also specify a custom image by its image family, which returns the latest version of the image in that family. Replace the image name with family/family-name: global/images/family/my-image-family If the source image is deleted later, this field will not be set. + * The source image to create this disk. When creating a new instance boot + * disk, one of initializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source + * is required. + * To create a disk with one of the public operating system + * images, specify the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image: + * projects/debian-cloud/global/images/family/debian-9 + * Alternatively, use a specific version of a public operating system image: + * projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD + * To create a disk with a custom image that you created, specify the + * image name in the following format: + * global/images/my-custom-image + * You can also specify a custom image by its image family, which returns + * the latest version of the image in that family. Replace the image name + * with family/family-name: + * global/images/family/my-image-family + * If the source image is deleted later, this field will not be set. * * Generated from protobuf field optional string source_image = 50443319; * @return string @@ -665,7 +906,22 @@ public function clearSourceImage() } /** - * The source image to create this disk. When creating a new instance boot disk, one of initializeParams.sourceImage or initializeParams.sourceSnapshot or disks.source is required. To create a disk with one of the public operating system images, specify the image by its family name. For example, specify family/debian-9 to use the latest Debian 9 image: projects/debian-cloud/global/images/family/debian-9 Alternatively, use a specific version of a public operating system image: projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD To create a disk with a custom image that you created, specify the image name in the following format: global/images/my-custom-image You can also specify a custom image by its image family, which returns the latest version of the image in that family. Replace the image name with family/family-name: global/images/family/my-image-family If the source image is deleted later, this field will not be set. + * The source image to create this disk. When creating a new instance boot + * disk, one of initializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source + * is required. + * To create a disk with one of the public operating system + * images, specify the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image: + * projects/debian-cloud/global/images/family/debian-9 + * Alternatively, use a specific version of a public operating system image: + * projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD + * To create a disk with a custom image that you created, specify the + * image name in the following format: + * global/images/my-custom-image + * You can also specify a custom image by its image family, which returns + * the latest version of the image in that family. Replace the image name + * with family/family-name: + * global/images/family/my-image-family + * If the source image is deleted later, this field will not be set. * * Generated from protobuf field optional string source_image = 50443319; * @param string $var @@ -680,7 +936,12 @@ public function setSourceImage($var) } /** - * The customer-supplied encryption key of the source image. Required if the source image is protected by a customer-supplied encryption key. InstanceTemplate and InstancePropertiesPatch do not store customer-supplied encryption keys, so you cannot create disks for instances in a managed instance group if the source images are encrypted with your own keys. + * Thecustomer-supplied + * encryption key of the source image. Required if the source image is + * protected by a customer-supplied encryption key. + * InstanceTemplate and InstancePropertiesPatch do not storecustomer-supplied + * encryption keys, so you cannot create disks for instances in a managed instance group if the + * source images are encrypted with your own keys. * * Generated from protobuf field optional .google.cloud.compute.v1.CustomerEncryptionKey source_image_encryption_key = 381503659; * @return \Google\Cloud\Compute\V1\CustomerEncryptionKey|null @@ -701,7 +962,12 @@ public function clearSourceImageEncryptionKey() } /** - * The customer-supplied encryption key of the source image. Required if the source image is protected by a customer-supplied encryption key. InstanceTemplate and InstancePropertiesPatch do not store customer-supplied encryption keys, so you cannot create disks for instances in a managed instance group if the source images are encrypted with your own keys. + * Thecustomer-supplied + * encryption key of the source image. Required if the source image is + * protected by a customer-supplied encryption key. + * InstanceTemplate and InstancePropertiesPatch do not storecustomer-supplied + * encryption keys, so you cannot create disks for instances in a managed instance group if the + * source images are encrypted with your own keys. * * Generated from protobuf field optional .google.cloud.compute.v1.CustomerEncryptionKey source_image_encryption_key = 381503659; * @param \Google\Cloud\Compute\V1\CustomerEncryptionKey $var @@ -716,7 +982,17 @@ public function setSourceImageEncryptionKey($var) } /** - * The source snapshot to create this disk. When creating a new instance boot disk, one of initializeParams.sourceSnapshot or initializeParams.sourceImage or disks.source is required. To create a disk with a snapshot that you created, specify the snapshot name in the following format: global/snapshots/my-backup If the source snapshot is deleted later, this field will not be set. Note: You cannot create VMs in bulk using a snapshot as the source. Use an image instead when you create VMs using the bulk insert method. + * The source snapshot to create this disk. When creating a new instance + * boot disk, one of initializeParams.sourceSnapshot orinitializeParams.sourceImage or disks.source + * is required. + * To create a disk with a snapshot that you created, specify the + * snapshot name in the following format: + * global/snapshots/my-backup + * If the source snapshot is deleted later, this field will not be set. + * Note: You cannot create VMs in bulk using a snapshot as the source. Use + * an image instead when you create VMs using + * the bulk + * insert method. * * Generated from protobuf field optional string source_snapshot = 126061928; * @return string @@ -737,7 +1013,17 @@ public function clearSourceSnapshot() } /** - * The source snapshot to create this disk. When creating a new instance boot disk, one of initializeParams.sourceSnapshot or initializeParams.sourceImage or disks.source is required. To create a disk with a snapshot that you created, specify the snapshot name in the following format: global/snapshots/my-backup If the source snapshot is deleted later, this field will not be set. Note: You cannot create VMs in bulk using a snapshot as the source. Use an image instead when you create VMs using the bulk insert method. + * The source snapshot to create this disk. When creating a new instance + * boot disk, one of initializeParams.sourceSnapshot orinitializeParams.sourceImage or disks.source + * is required. + * To create a disk with a snapshot that you created, specify the + * snapshot name in the following format: + * global/snapshots/my-backup + * If the source snapshot is deleted later, this field will not be set. + * Note: You cannot create VMs in bulk using a snapshot as the source. Use + * an image instead when you create VMs using + * the bulk + * insert method. * * Generated from protobuf field optional string source_snapshot = 126061928; * @param string $var @@ -752,7 +1038,8 @@ public function setSourceSnapshot($var) } /** - * The customer-supplied encryption key of the source snapshot. + * Thecustomer-supplied + * encryption key of the source snapshot. * * Generated from protobuf field optional .google.cloud.compute.v1.CustomerEncryptionKey source_snapshot_encryption_key = 303679322; * @return \Google\Cloud\Compute\V1\CustomerEncryptionKey|null @@ -773,7 +1060,8 @@ public function clearSourceSnapshotEncryptionKey() } /** - * The customer-supplied encryption key of the source snapshot. + * Thecustomer-supplied + * encryption key of the source snapshot. * * Generated from protobuf field optional .google.cloud.compute.v1.CustomerEncryptionKey source_snapshot_encryption_key = 303679322; * @param \Google\Cloud\Compute\V1\CustomerEncryptionKey $var @@ -788,7 +1076,12 @@ public function setSourceSnapshotEncryptionKey($var) } /** - * The storage pool in which the new disk is created. You can provide this as a partial or full URL to the resource. For example, the following are valid values: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /storagePools/storagePool - projects/project/zones/zone/storagePools/storagePool - zones/zone/storagePools/storagePool + * The storage pool in which the new disk is created. You can provide + * this as a partial or full URL to the resource. For example, the following + * are valid values: + * - https://www.googleapis.com/compute/v1/projects/project/zones/zone/storagePools/storagePool + * - projects/project/zones/zone/storagePools/storagePool + * - zones/zone/storagePools/storagePool * * Generated from protobuf field optional string storage_pool = 360473440; * @return string @@ -809,7 +1102,12 @@ public function clearStoragePool() } /** - * The storage pool in which the new disk is created. You can provide this as a partial or full URL to the resource. For example, the following are valid values: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /storagePools/storagePool - projects/project/zones/zone/storagePools/storagePool - zones/zone/storagePools/storagePool + * The storage pool in which the new disk is created. You can provide + * this as a partial or full URL to the resource. For example, the following + * are valid values: + * - https://www.googleapis.com/compute/v1/projects/project/zones/zone/storagePools/storagePool + * - projects/project/zones/zone/storagePools/storagePool + * - zones/zone/storagePools/storagePool * * Generated from protobuf field optional string storage_pool = 360473440; * @param string $var diff --git a/Compute/src/V1/AttachedDiskInitializeParams/Architecture.php b/Compute/src/V1/AttachedDiskInitializeParams/Architecture.php index bb43b94837eb..6464fcb125c5 100644 --- a/Compute/src/V1/AttachedDiskInitializeParams/Architecture.php +++ b/Compute/src/V1/AttachedDiskInitializeParams/Architecture.php @@ -7,7 +7,8 @@ use UnexpectedValueException; /** - * The architecture of the attached disk. Valid values are arm64 or x86_64. + * The architecture of the attached disk. Valid values are + * arm64 or x86_64. * * Protobuf type google.cloud.compute.v1.AttachedDiskInitializeParams.Architecture */ diff --git a/Compute/src/V1/AttachedDiskInitializeParams/OnUpdateAction.php b/Compute/src/V1/AttachedDiskInitializeParams/OnUpdateAction.php index 83676fb3ed20..d3cf3989d0a7 100644 --- a/Compute/src/V1/AttachedDiskInitializeParams/OnUpdateAction.php +++ b/Compute/src/V1/AttachedDiskInitializeParams/OnUpdateAction.php @@ -7,7 +7,8 @@ use UnexpectedValueException; /** - * Specifies which action to take on instance update with this disk. Default is to use the existing disk. + * Specifies which action to take on instance update with this disk. Default + * is to use the existing disk. * * Protobuf type google.cloud.compute.v1.AttachedDiskInitializeParams.OnUpdateAction */ @@ -26,7 +27,8 @@ class OnUpdateAction */ const RECREATE_DISK = 494767853; /** - * Recreate the disk if source (image, snapshot) of this disk is different from source of existing disk. + * Recreate the disk if source (image, snapshot) of this disk is different + * from source of existing disk. * * Generated from protobuf enum RECREATE_DISK_IF_SOURCE_CHANGED = 398099712; */ diff --git a/Compute/src/V1/AuditConfig.php b/Compute/src/V1/AuditConfig.php index ba2325a3abfc..5a391dea4677 100644 --- a/Compute/src/V1/AuditConfig.php +++ b/Compute/src/V1/AuditConfig.php @@ -9,7 +9,53 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Specifies the audit configuration for a service. The configuration determines which permission types are logged, and what identities, if any, are exempted from logging. An AuditConfig must have one or more AuditLogConfigs. If there are AuditConfigs for both `allServices` and a specific service, the union of the two AuditConfigs is used for that service: the log_types specified in each AuditConfig are enabled, and the exempted_members in each AuditLogConfig are exempted. Example Policy with multiple AuditConfigs: { "audit_configs": [ { "service": "allServices", "audit_log_configs": [ { "log_type": "DATA_READ", "exempted_members": [ "user:jose@example.com" ] }, { "log_type": "DATA_WRITE" }, { "log_type": "ADMIN_READ" } ] }, { "service": "sampleservice.googleapis.com", "audit_log_configs": [ { "log_type": "DATA_READ" }, { "log_type": "DATA_WRITE", "exempted_members": [ "user:aliya@example.com" ] } ] } ] } For sampleservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ logging. It also exempts `jose@example.com` from DATA_READ logging, and `aliya@example.com` from DATA_WRITE logging. + * Specifies the audit configuration for a service. + * The configuration determines which permission types are logged, and what + * identities, if any, are exempted from logging. + * An AuditConfig must have one or more AuditLogConfigs. + * If there are AuditConfigs for both `allServices` and a specific service, + * the union of the two AuditConfigs is used for that service: the log_types + * specified in each AuditConfig are enabled, and the exempted_members in each + * AuditLogConfig are exempted. + * Example Policy with multiple AuditConfigs: + * { + * "audit_configs": [ + * { + * "service": "allServices", + * "audit_log_configs": [ + * { + * "log_type": "DATA_READ", + * "exempted_members": [ + * "user:jose@example.com" + * ] + * }, + * { + * "log_type": "DATA_WRITE" + * }, + * { + * "log_type": "ADMIN_READ" + * } + * ] + * }, + * { + * "service": "sampleservice.googleapis.com", + * "audit_log_configs": [ + * { + * "log_type": "DATA_READ" + * }, + * { + * "log_type": "DATA_WRITE", + * "exempted_members": [ + * "user:aliya@example.com" + * ] + * } + * ] + * } + * ] + * } + * For sampleservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ + * logging. It also exempts `jose@example.com` from DATA_READ logging, and + * `aliya@example.com` from DATA_WRITE logging. * * Generated from protobuf message google.cloud.compute.v1.AuditConfig */ @@ -26,7 +72,9 @@ class AuditConfig extends \Google\Protobuf\Internal\Message */ private $exempted_members; /** - * Specifies a service that will be enabled for audit logging. For example, `storage.googleapis.com`, `cloudsql.googleapis.com`. `allServices` is a special value that covers all services. + * Specifies a service that will be enabled for audit logging. + * For example, `storage.googleapis.com`, `cloudsql.googleapis.com`. + * `allServices` is a special value that covers all services. * * Generated from protobuf field optional string service = 373540533; */ @@ -42,7 +90,9 @@ class AuditConfig extends \Google\Protobuf\Internal\Message * The configuration for logging of each type of permission. * @type array|\Google\Protobuf\Internal\RepeatedField $exempted_members * @type string $service - * Specifies a service that will be enabled for audit logging. For example, `storage.googleapis.com`, `cloudsql.googleapis.com`. `allServices` is a special value that covers all services. + * Specifies a service that will be enabled for audit logging. + * For example, `storage.googleapis.com`, `cloudsql.googleapis.com`. + * `allServices` is a special value that covers all services. * } */ public function __construct($data = NULL) { @@ -99,7 +149,9 @@ public function setExemptedMembers($var) } /** - * Specifies a service that will be enabled for audit logging. For example, `storage.googleapis.com`, `cloudsql.googleapis.com`. `allServices` is a special value that covers all services. + * Specifies a service that will be enabled for audit logging. + * For example, `storage.googleapis.com`, `cloudsql.googleapis.com`. + * `allServices` is a special value that covers all services. * * Generated from protobuf field optional string service = 373540533; * @return string @@ -120,7 +172,9 @@ public function clearService() } /** - * Specifies a service that will be enabled for audit logging. For example, `storage.googleapis.com`, `cloudsql.googleapis.com`. `allServices` is a special value that covers all services. + * Specifies a service that will be enabled for audit logging. + * For example, `storage.googleapis.com`, `cloudsql.googleapis.com`. + * `allServices` is a special value that covers all services. * * Generated from protobuf field optional string service = 373540533; * @param string $var diff --git a/Compute/src/V1/AuditLogConfig.php b/Compute/src/V1/AuditLogConfig.php index 9ed971092a38..e1a5dd1a8ba0 100644 --- a/Compute/src/V1/AuditLogConfig.php +++ b/Compute/src/V1/AuditLogConfig.php @@ -9,14 +9,32 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Provides the configuration for logging a type of permissions. Example: { "audit_log_configs": [ { "log_type": "DATA_READ", "exempted_members": [ "user:jose@example.com" ] }, { "log_type": "DATA_WRITE" } ] } This enables 'DATA_READ' and 'DATA_WRITE' logging, while exempting jose@example.com from DATA_READ logging. + * Provides the configuration for logging a type of permissions. + * Example: + * { + * "audit_log_configs": [ + * { + * "log_type": "DATA_READ", + * "exempted_members": [ + * "user:jose@example.com" + * ] + * }, + * { + * "log_type": "DATA_WRITE" + * } + * ] + * } + * This enables 'DATA_READ' and 'DATA_WRITE' logging, while exempting + * jose@example.com from DATA_READ logging. * * Generated from protobuf message google.cloud.compute.v1.AuditLogConfig */ class AuditLogConfig extends \Google\Protobuf\Internal\Message { /** - * Specifies the identities that do not cause logging for this type of permission. Follows the same format of Binding.members. + * Specifies the identities that do not cause logging for this type of + * permission. + * Follows the same format of Binding.members. * * Generated from protobuf field repeated string exempted_members = 232615576; */ @@ -40,7 +58,9 @@ class AuditLogConfig extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type array|\Google\Protobuf\Internal\RepeatedField $exempted_members - * Specifies the identities that do not cause logging for this type of permission. Follows the same format of Binding.members. + * Specifies the identities that do not cause logging for this type of + * permission. + * Follows the same format of Binding.members. * @type bool $ignore_child_exemptions * @type string $log_type * The log type that this config enables. @@ -53,7 +73,9 @@ public function __construct($data = NULL) { } /** - * Specifies the identities that do not cause logging for this type of permission. Follows the same format of Binding.members. + * Specifies the identities that do not cause logging for this type of + * permission. + * Follows the same format of Binding.members. * * Generated from protobuf field repeated string exempted_members = 232615576; * @return \Google\Protobuf\Internal\RepeatedField @@ -64,7 +86,9 @@ public function getExemptedMembers() } /** - * Specifies the identities that do not cause logging for this type of permission. Follows the same format of Binding.members. + * Specifies the identities that do not cause logging for this type of + * permission. + * Follows the same format of Binding.members. * * Generated from protobuf field repeated string exempted_members = 232615576; * @param array|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/Autoscaler.php b/Compute/src/V1/Autoscaler.php index 15536b19fcc7..2e7e61f06994 100644 --- a/Compute/src/V1/Autoscaler.php +++ b/Compute/src/V1/Autoscaler.php @@ -9,56 +9,83 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Represents an Autoscaler resource. Google Compute Engine has two Autoscaler resources: * [Zonal](/compute/docs/reference/rest/v1/autoscalers) * [Regional](/compute/docs/reference/rest/v1/regionAutoscalers) Use autoscalers to automatically add or delete instances from a managed instance group according to your defined autoscaling policy. For more information, read Autoscaling Groups of Instances. For zonal managed instance groups resource, use the autoscaler resource. For regional managed instance groups, use the regionAutoscalers resource. + * Represents an Autoscaler resource. + * Google Compute Engine has two Autoscaler resources: + * * [Zonal](/compute/docs/reference/rest/v1/autoscalers) + * * [Regional](/compute/docs/reference/rest/v1/regionAutoscalers) + * Use autoscalers to automatically add or delete instances from a + * managed instance group according to your defined autoscaling policy. + * For more information, read Autoscaling Groups of Instances. + * For zonal managed instance groups resource, use the autoscaler + * resource. + * For regional managed instance groups, use theregionAutoscalers resource. * * Generated from protobuf message google.cloud.compute.v1.Autoscaler */ class Autoscaler extends \Google\Protobuf\Internal\Message { /** - * The configuration parameters for the autoscaling algorithm. You can define one or more signals for an autoscaler: cpuUtilization, customMetricUtilizations, and loadBalancingUtilization. If none of these are specified, the default will be to autoscale based on cpuUtilization to 0.6 or 60%. + * The configuration parameters for the autoscaling algorithm. You can define + * one or more signals for an autoscaler: cpuUtilization,customMetricUtilizations, andloadBalancingUtilization. + * If none of these are specified, the default will be to autoscale based oncpuUtilization to 0.6 or 60%. * * Generated from protobuf field optional .google.cloud.compute.v1.AutoscalingPolicy autoscaling_policy = 221950041; */ protected $autoscaling_policy = null; /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; */ protected $creation_timestamp = null; /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; */ protected $description = null; /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; */ protected $id = null; /** - * [Output Only] Type of the resource. Always compute#autoscaler for autoscalers. + * [Output Only] Type of the resource. Always compute#autoscaler + * for autoscalers. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * * Generated from protobuf field optional string name = 3373707; */ protected $name = null; /** - * [Output Only] Target recommended MIG size (number of instances) computed by autoscaler. Autoscaler calculates the recommended MIG size even when the autoscaling policy mode is different from ON. This field is empty when autoscaler is not connected to an existing managed instance group or autoscaler did not generate its prediction. + * [Output Only] Target recommended MIG size (number of instances) computed by + * autoscaler. Autoscaler calculates the recommended MIG size even when the + * autoscaling policy mode is different from ON. This field is empty when + * autoscaler is not connected to an existing managed instance group or + * autoscaler did not generate its prediction. * * Generated from protobuf field optional int32 recommended_size = 257915749; */ protected $recommended_size = null; /** - * [Output Only] URL of the region where the instance group resides (for autoscalers living in regional scope). + * [Output Only] URL of theregion + * where the instance group resides (for autoscalers living in regional + * scope). * * Generated from protobuf field optional string region = 138946292; */ @@ -76,26 +103,43 @@ class Autoscaler extends \Google\Protobuf\Internal\Message */ protected $self_link = null; /** - * [Output Only] The status of the autoscaler configuration. Current set of possible values: - PENDING: Autoscaler backend hasn't read new/updated configuration. - DELETING: Configuration is being deleted. - ACTIVE: Configuration is acknowledged to be effective. Some warnings might be present in the statusDetails field. - ERROR: Configuration has errors. Actionable for users. Details are present in the statusDetails field. New values might be added in the future. + * [Output Only] The status of the autoscaler configuration. Current set of + * possible values: + * - PENDING: + * Autoscaler backend hasn't read new/updated configuration. + * - DELETING: + * Configuration is being deleted. + * - ACTIVE: + * Configuration is acknowledged to be effective. Some warnings might + * be present in the statusDetails field. + * - ERROR: + * Configuration has errors. Actionable for users. Details are present in + * the statusDetails field. + * New values might be added in the future. * Check the Status enum for the list of possible values. * * Generated from protobuf field optional string status = 181260274; */ protected $status = null; /** - * [Output Only] Human-readable details about the current state of the autoscaler. Read the documentation for Commonly returned status messages for examples of status messages you might encounter. + * [Output Only] Human-readable details about the current state of the + * autoscaler. Read the documentation forCommonly + * returned status messages for examples of status messages you might + * encounter. * * Generated from protobuf field repeated .google.cloud.compute.v1.AutoscalerStatusDetails status_details = 363353845; */ private $status_details; /** - * URL of the managed instance group that this autoscaler will scale. This field is required when creating an autoscaler. + * URL of the managed instance group that this autoscaler will scale. This + * field is required when creating an autoscaler. * * Generated from protobuf field optional string target = 192835985; */ protected $target = null; /** - * [Output Only] URL of the zone where the instance group resides (for autoscalers living in zonal scope). + * [Output Only] URL of thezone + * where the instance group resides (for autoscalers living in zonal scope). * * Generated from protobuf field optional string zone = 3744684; */ @@ -108,34 +152,69 @@ class Autoscaler extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type \Google\Cloud\Compute\V1\AutoscalingPolicy $autoscaling_policy - * The configuration parameters for the autoscaling algorithm. You can define one or more signals for an autoscaler: cpuUtilization, customMetricUtilizations, and loadBalancingUtilization. If none of these are specified, the default will be to autoscale based on cpuUtilization to 0.6 or 60%. + * The configuration parameters for the autoscaling algorithm. You can define + * one or more signals for an autoscaler: cpuUtilization,customMetricUtilizations, andloadBalancingUtilization. + * If none of these are specified, the default will be to autoscale based oncpuUtilization to 0.6 or 60%. * @type string $creation_timestamp - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * @type string $description - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * @type int|string $id - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * @type string $kind - * [Output Only] Type of the resource. Always compute#autoscaler for autoscalers. + * [Output Only] Type of the resource. Always compute#autoscaler + * for autoscalers. * @type string $name - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * @type int $recommended_size - * [Output Only] Target recommended MIG size (number of instances) computed by autoscaler. Autoscaler calculates the recommended MIG size even when the autoscaling policy mode is different from ON. This field is empty when autoscaler is not connected to an existing managed instance group or autoscaler did not generate its prediction. + * [Output Only] Target recommended MIG size (number of instances) computed by + * autoscaler. Autoscaler calculates the recommended MIG size even when the + * autoscaling policy mode is different from ON. This field is empty when + * autoscaler is not connected to an existing managed instance group or + * autoscaler did not generate its prediction. * @type string $region - * [Output Only] URL of the region where the instance group resides (for autoscalers living in regional scope). + * [Output Only] URL of theregion + * where the instance group resides (for autoscalers living in regional + * scope). * @type array|\Google\Protobuf\Internal\MapField $scaling_schedule_status * [Output Only] Status information of existing scaling schedules. * @type string $self_link * [Output Only] Server-defined URL for the resource. * @type string $status - * [Output Only] The status of the autoscaler configuration. Current set of possible values: - PENDING: Autoscaler backend hasn't read new/updated configuration. - DELETING: Configuration is being deleted. - ACTIVE: Configuration is acknowledged to be effective. Some warnings might be present in the statusDetails field. - ERROR: Configuration has errors. Actionable for users. Details are present in the statusDetails field. New values might be added in the future. + * [Output Only] The status of the autoscaler configuration. Current set of + * possible values: + * - PENDING: + * Autoscaler backend hasn't read new/updated configuration. + * - DELETING: + * Configuration is being deleted. + * - ACTIVE: + * Configuration is acknowledged to be effective. Some warnings might + * be present in the statusDetails field. + * - ERROR: + * Configuration has errors. Actionable for users. Details are present in + * the statusDetails field. + * New values might be added in the future. * Check the Status enum for the list of possible values. * @type array<\Google\Cloud\Compute\V1\AutoscalerStatusDetails>|\Google\Protobuf\Internal\RepeatedField $status_details - * [Output Only] Human-readable details about the current state of the autoscaler. Read the documentation for Commonly returned status messages for examples of status messages you might encounter. + * [Output Only] Human-readable details about the current state of the + * autoscaler. Read the documentation forCommonly + * returned status messages for examples of status messages you might + * encounter. * @type string $target - * URL of the managed instance group that this autoscaler will scale. This field is required when creating an autoscaler. + * URL of the managed instance group that this autoscaler will scale. This + * field is required when creating an autoscaler. * @type string $zone - * [Output Only] URL of the zone where the instance group resides (for autoscalers living in zonal scope). + * [Output Only] URL of thezone + * where the instance group resides (for autoscalers living in zonal scope). * } */ public function __construct($data = NULL) { @@ -144,7 +223,9 @@ public function __construct($data = NULL) { } /** - * The configuration parameters for the autoscaling algorithm. You can define one or more signals for an autoscaler: cpuUtilization, customMetricUtilizations, and loadBalancingUtilization. If none of these are specified, the default will be to autoscale based on cpuUtilization to 0.6 or 60%. + * The configuration parameters for the autoscaling algorithm. You can define + * one or more signals for an autoscaler: cpuUtilization,customMetricUtilizations, andloadBalancingUtilization. + * If none of these are specified, the default will be to autoscale based oncpuUtilization to 0.6 or 60%. * * Generated from protobuf field optional .google.cloud.compute.v1.AutoscalingPolicy autoscaling_policy = 221950041; * @return \Google\Cloud\Compute\V1\AutoscalingPolicy|null @@ -165,7 +246,9 @@ public function clearAutoscalingPolicy() } /** - * The configuration parameters for the autoscaling algorithm. You can define one or more signals for an autoscaler: cpuUtilization, customMetricUtilizations, and loadBalancingUtilization. If none of these are specified, the default will be to autoscale based on cpuUtilization to 0.6 or 60%. + * The configuration parameters for the autoscaling algorithm. You can define + * one or more signals for an autoscaler: cpuUtilization,customMetricUtilizations, andloadBalancingUtilization. + * If none of these are specified, the default will be to autoscale based oncpuUtilization to 0.6 or 60%. * * Generated from protobuf field optional .google.cloud.compute.v1.AutoscalingPolicy autoscaling_policy = 221950041; * @param \Google\Cloud\Compute\V1\AutoscalingPolicy $var @@ -180,7 +263,8 @@ public function setAutoscalingPolicy($var) } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @return string @@ -201,7 +285,8 @@ public function clearCreationTimestamp() } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @param string $var @@ -216,7 +301,8 @@ public function setCreationTimestamp($var) } /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @return string @@ -237,7 +323,8 @@ public function clearDescription() } /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @param string $var @@ -252,7 +339,8 @@ public function setDescription($var) } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @return int|string @@ -273,7 +361,8 @@ public function clearId() } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @param int|string $var @@ -288,7 +377,8 @@ public function setId($var) } /** - * [Output Only] Type of the resource. Always compute#autoscaler for autoscalers. + * [Output Only] Type of the resource. Always compute#autoscaler + * for autoscalers. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -309,7 +399,8 @@ public function clearKind() } /** - * [Output Only] Type of the resource. Always compute#autoscaler for autoscalers. + * [Output Only] Type of the resource. Always compute#autoscaler + * for autoscalers. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -324,7 +415,13 @@ public function setKind($var) } /** - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * * Generated from protobuf field optional string name = 3373707; * @return string @@ -345,7 +442,13 @@ public function clearName() } /** - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * * Generated from protobuf field optional string name = 3373707; * @param string $var @@ -360,7 +463,11 @@ public function setName($var) } /** - * [Output Only] Target recommended MIG size (number of instances) computed by autoscaler. Autoscaler calculates the recommended MIG size even when the autoscaling policy mode is different from ON. This field is empty when autoscaler is not connected to an existing managed instance group or autoscaler did not generate its prediction. + * [Output Only] Target recommended MIG size (number of instances) computed by + * autoscaler. Autoscaler calculates the recommended MIG size even when the + * autoscaling policy mode is different from ON. This field is empty when + * autoscaler is not connected to an existing managed instance group or + * autoscaler did not generate its prediction. * * Generated from protobuf field optional int32 recommended_size = 257915749; * @return int @@ -381,7 +488,11 @@ public function clearRecommendedSize() } /** - * [Output Only] Target recommended MIG size (number of instances) computed by autoscaler. Autoscaler calculates the recommended MIG size even when the autoscaling policy mode is different from ON. This field is empty when autoscaler is not connected to an existing managed instance group or autoscaler did not generate its prediction. + * [Output Only] Target recommended MIG size (number of instances) computed by + * autoscaler. Autoscaler calculates the recommended MIG size even when the + * autoscaling policy mode is different from ON. This field is empty when + * autoscaler is not connected to an existing managed instance group or + * autoscaler did not generate its prediction. * * Generated from protobuf field optional int32 recommended_size = 257915749; * @param int $var @@ -396,7 +507,9 @@ public function setRecommendedSize($var) } /** - * [Output Only] URL of the region where the instance group resides (for autoscalers living in regional scope). + * [Output Only] URL of theregion + * where the instance group resides (for autoscalers living in regional + * scope). * * Generated from protobuf field optional string region = 138946292; * @return string @@ -417,7 +530,9 @@ public function clearRegion() } /** - * [Output Only] URL of the region where the instance group resides (for autoscalers living in regional scope). + * [Output Only] URL of theregion + * where the instance group resides (for autoscalers living in regional + * scope). * * Generated from protobuf field optional string region = 138946292; * @param string $var @@ -494,7 +609,19 @@ public function setSelfLink($var) } /** - * [Output Only] The status of the autoscaler configuration. Current set of possible values: - PENDING: Autoscaler backend hasn't read new/updated configuration. - DELETING: Configuration is being deleted. - ACTIVE: Configuration is acknowledged to be effective. Some warnings might be present in the statusDetails field. - ERROR: Configuration has errors. Actionable for users. Details are present in the statusDetails field. New values might be added in the future. + * [Output Only] The status of the autoscaler configuration. Current set of + * possible values: + * - PENDING: + * Autoscaler backend hasn't read new/updated configuration. + * - DELETING: + * Configuration is being deleted. + * - ACTIVE: + * Configuration is acknowledged to be effective. Some warnings might + * be present in the statusDetails field. + * - ERROR: + * Configuration has errors. Actionable for users. Details are present in + * the statusDetails field. + * New values might be added in the future. * Check the Status enum for the list of possible values. * * Generated from protobuf field optional string status = 181260274; @@ -516,7 +643,19 @@ public function clearStatus() } /** - * [Output Only] The status of the autoscaler configuration. Current set of possible values: - PENDING: Autoscaler backend hasn't read new/updated configuration. - DELETING: Configuration is being deleted. - ACTIVE: Configuration is acknowledged to be effective. Some warnings might be present in the statusDetails field. - ERROR: Configuration has errors. Actionable for users. Details are present in the statusDetails field. New values might be added in the future. + * [Output Only] The status of the autoscaler configuration. Current set of + * possible values: + * - PENDING: + * Autoscaler backend hasn't read new/updated configuration. + * - DELETING: + * Configuration is being deleted. + * - ACTIVE: + * Configuration is acknowledged to be effective. Some warnings might + * be present in the statusDetails field. + * - ERROR: + * Configuration has errors. Actionable for users. Details are present in + * the statusDetails field. + * New values might be added in the future. * Check the Status enum for the list of possible values. * * Generated from protobuf field optional string status = 181260274; @@ -532,7 +671,10 @@ public function setStatus($var) } /** - * [Output Only] Human-readable details about the current state of the autoscaler. Read the documentation for Commonly returned status messages for examples of status messages you might encounter. + * [Output Only] Human-readable details about the current state of the + * autoscaler. Read the documentation forCommonly + * returned status messages for examples of status messages you might + * encounter. * * Generated from protobuf field repeated .google.cloud.compute.v1.AutoscalerStatusDetails status_details = 363353845; * @return \Google\Protobuf\Internal\RepeatedField @@ -543,7 +685,10 @@ public function getStatusDetails() } /** - * [Output Only] Human-readable details about the current state of the autoscaler. Read the documentation for Commonly returned status messages for examples of status messages you might encounter. + * [Output Only] Human-readable details about the current state of the + * autoscaler. Read the documentation forCommonly + * returned status messages for examples of status messages you might + * encounter. * * Generated from protobuf field repeated .google.cloud.compute.v1.AutoscalerStatusDetails status_details = 363353845; * @param array<\Google\Cloud\Compute\V1\AutoscalerStatusDetails>|\Google\Protobuf\Internal\RepeatedField $var @@ -558,7 +703,8 @@ public function setStatusDetails($var) } /** - * URL of the managed instance group that this autoscaler will scale. This field is required when creating an autoscaler. + * URL of the managed instance group that this autoscaler will scale. This + * field is required when creating an autoscaler. * * Generated from protobuf field optional string target = 192835985; * @return string @@ -579,7 +725,8 @@ public function clearTarget() } /** - * URL of the managed instance group that this autoscaler will scale. This field is required when creating an autoscaler. + * URL of the managed instance group that this autoscaler will scale. This + * field is required when creating an autoscaler. * * Generated from protobuf field optional string target = 192835985; * @param string $var @@ -594,7 +741,8 @@ public function setTarget($var) } /** - * [Output Only] URL of the zone where the instance group resides (for autoscalers living in zonal scope). + * [Output Only] URL of thezone + * where the instance group resides (for autoscalers living in zonal scope). * * Generated from protobuf field optional string zone = 3744684; * @return string @@ -615,7 +763,8 @@ public function clearZone() } /** - * [Output Only] URL of the zone where the instance group resides (for autoscalers living in zonal scope). + * [Output Only] URL of thezone + * where the instance group resides (for autoscalers living in zonal scope). * * Generated from protobuf field optional string zone = 3744684; * @param string $var diff --git a/Compute/src/V1/Autoscaler/Status.php b/Compute/src/V1/Autoscaler/Status.php index ed269f1a7e16..84ae6567bd67 100644 --- a/Compute/src/V1/Autoscaler/Status.php +++ b/Compute/src/V1/Autoscaler/Status.php @@ -7,7 +7,19 @@ use UnexpectedValueException; /** - * [Output Only] The status of the autoscaler configuration. Current set of possible values: - PENDING: Autoscaler backend hasn't read new/updated configuration. - DELETING: Configuration is being deleted. - ACTIVE: Configuration is acknowledged to be effective. Some warnings might be present in the statusDetails field. - ERROR: Configuration has errors. Actionable for users. Details are present in the statusDetails field. New values might be added in the future. + * [Output Only] The status of the autoscaler configuration. Current set of + * possible values: + * - PENDING: + * Autoscaler backend hasn't read new/updated configuration. + * - DELETING: + * Configuration is being deleted. + * - ACTIVE: + * Configuration is acknowledged to be effective. Some warnings might + * be present in the statusDetails field. + * - ERROR: + * Configuration has errors. Actionable for users. Details are present in + * the statusDetails field. + * New values might be added in the future. * * Protobuf type google.cloud.compute.v1.Autoscaler.Status */ diff --git a/Compute/src/V1/AutoscalerAggregatedList.php b/Compute/src/V1/AutoscalerAggregatedList.php index 7645a49e2e77..640e2ff093ba 100644 --- a/Compute/src/V1/AutoscalerAggregatedList.php +++ b/Compute/src/V1/AutoscalerAggregatedList.php @@ -27,13 +27,18 @@ class AutoscalerAggregatedList extends \Google\Protobuf\Internal\Message */ private $items; /** - * [Output Only] Type of resource. Always compute#autoscalerAggregatedList for aggregated lists of autoscalers. + * [Output Only] Type of resource. Alwayscompute#autoscalerAggregatedList for aggregated lists of + * autoscalers. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -45,7 +50,8 @@ class AutoscalerAggregatedList extends \Google\Protobuf\Internal\Message */ protected $self_link = null; /** - * [Output Only] Unreachable resources. end_interface: MixerListResponseWithEtagBuilder + * [Output Only] Unreachable resources. + * end_interface: MixerListResponseWithEtagBuilder * * Generated from protobuf field repeated string unreachables = 243372063; */ @@ -68,13 +74,19 @@ class AutoscalerAggregatedList extends \Google\Protobuf\Internal\Message * @type array|\Google\Protobuf\Internal\MapField $items * A list of AutoscalersScopedList resources. * @type string $kind - * [Output Only] Type of resource. Always compute#autoscalerAggregatedList for aggregated lists of autoscalers. + * [Output Only] Type of resource. Alwayscompute#autoscalerAggregatedList for aggregated lists of + * autoscalers. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type array|\Google\Protobuf\Internal\RepeatedField $unreachables - * [Output Only] Unreachable resources. end_interface: MixerListResponseWithEtagBuilder + * [Output Only] Unreachable resources. + * end_interface: MixerListResponseWithEtagBuilder * @type \Google\Cloud\Compute\V1\Warning $warning * [Output Only] Informational warning message. * } @@ -147,7 +159,8 @@ public function setItems($var) } /** - * [Output Only] Type of resource. Always compute#autoscalerAggregatedList for aggregated lists of autoscalers. + * [Output Only] Type of resource. Alwayscompute#autoscalerAggregatedList for aggregated lists of + * autoscalers. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -168,7 +181,8 @@ public function clearKind() } /** - * [Output Only] Type of resource. Always compute#autoscalerAggregatedList for aggregated lists of autoscalers. + * [Output Only] Type of resource. Alwayscompute#autoscalerAggregatedList for aggregated lists of + * autoscalers. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -183,7 +197,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -204,7 +222,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var @@ -255,7 +277,8 @@ public function setSelfLink($var) } /** - * [Output Only] Unreachable resources. end_interface: MixerListResponseWithEtagBuilder + * [Output Only] Unreachable resources. + * end_interface: MixerListResponseWithEtagBuilder * * Generated from protobuf field repeated string unreachables = 243372063; * @return \Google\Protobuf\Internal\RepeatedField @@ -266,7 +289,8 @@ public function getUnreachables() } /** - * [Output Only] Unreachable resources. end_interface: MixerListResponseWithEtagBuilder + * [Output Only] Unreachable resources. + * end_interface: MixerListResponseWithEtagBuilder * * Generated from protobuf field repeated string unreachables = 243372063; * @param array|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/AutoscalerList.php b/Compute/src/V1/AutoscalerList.php index 282203b7cc84..92c8e33052a5 100644 --- a/Compute/src/V1/AutoscalerList.php +++ b/Compute/src/V1/AutoscalerList.php @@ -28,13 +28,18 @@ class AutoscalerList extends \Google\Protobuf\Internal\Message */ private $items; /** - * [Output Only] Type of resource. Always compute#autoscalerList for lists of autoscalers. + * [Output Only] Type of resource. Always compute#autoscalerList + * for lists of autoscalers. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -63,9 +68,14 @@ class AutoscalerList extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\Autoscaler>|\Google\Protobuf\Internal\RepeatedField $items * A list of Autoscaler resources. * @type string $kind - * [Output Only] Type of resource. Always compute#autoscalerList for lists of autoscalers. + * [Output Only] Type of resource. Always compute#autoscalerList + * for lists of autoscalers. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type \Google\Cloud\Compute\V1\Warning $warning @@ -140,7 +150,8 @@ public function setItems($var) } /** - * [Output Only] Type of resource. Always compute#autoscalerList for lists of autoscalers. + * [Output Only] Type of resource. Always compute#autoscalerList + * for lists of autoscalers. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -161,7 +172,8 @@ public function clearKind() } /** - * [Output Only] Type of resource. Always compute#autoscalerList for lists of autoscalers. + * [Output Only] Type of resource. Always compute#autoscalerList + * for lists of autoscalers. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -176,7 +188,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -197,7 +213,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/AutoscalerStatusDetails.php b/Compute/src/V1/AutoscalerStatusDetails.php index 665cadb7c0db..1dbcf5b1b122 100644 --- a/Compute/src/V1/AutoscalerStatusDetails.php +++ b/Compute/src/V1/AutoscalerStatusDetails.php @@ -21,7 +21,57 @@ class AutoscalerStatusDetails extends \Google\Protobuf\Internal\Message */ protected $message = null; /** - * The type of error, warning, or notice returned. Current set of possible values: - ALL_INSTANCES_UNHEALTHY (WARNING): All instances in the instance group are unhealthy (not in RUNNING state). - BACKEND_SERVICE_DOES_NOT_EXIST (ERROR): There is no backend service attached to the instance group. - CAPPED_AT_MAX_NUM_REPLICAS (WARNING): Autoscaler recommends a size greater than maxNumReplicas. - CUSTOM_METRIC_DATA_POINTS_TOO_SPARSE (WARNING): The custom metric samples are not exported often enough to be a credible base for autoscaling. - CUSTOM_METRIC_INVALID (ERROR): The custom metric that was specified does not exist or does not have the necessary labels. - MIN_EQUALS_MAX (WARNING): The minNumReplicas is equal to maxNumReplicas. This means the autoscaler cannot add or remove instances from the instance group. - MISSING_CUSTOM_METRIC_DATA_POINTS (WARNING): The autoscaler did not receive any data from the custom metric configured for autoscaling. - MISSING_LOAD_BALANCING_DATA_POINTS (WARNING): The autoscaler is configured to scale based on a load balancing signal but the instance group has not received any requests from the load balancer. - MODE_OFF (WARNING): Autoscaling is turned off. The number of instances in the group won't change automatically. The autoscaling configuration is preserved. - MODE_ONLY_UP (WARNING): Autoscaling is in the "Autoscale only out" mode. The autoscaler can add instances but not remove any. - MORE_THAN_ONE_BACKEND_SERVICE (ERROR): The instance group cannot be autoscaled because it has more than one backend service attached to it. - NOT_ENOUGH_QUOTA_AVAILABLE (ERROR): There is insufficient quota for the necessary resources, such as CPU or number of instances. - REGION_RESOURCE_STOCKOUT (ERROR): Shown only for regional autoscalers: there is a resource stockout in the chosen region. - SCALING_TARGET_DOES_NOT_EXIST (ERROR): The target to be scaled does not exist. - UNSUPPORTED_MAX_RATE_LOAD_BALANCING_CONFIGURATION (ERROR): Autoscaling does not work with an HTTP/S load balancer that has been configured for maxRate. - ZONE_RESOURCE_STOCKOUT (ERROR): For zonal autoscalers: there is a resource stockout in the chosen zone. For regional autoscalers: in at least one of the zones you're using there is a resource stockout. New values might be added in the future. Some of the values might not be available in all API versions. + * The type of error, warning, or notice returned. Current set of possible + * values: + * - ALL_INSTANCES_UNHEALTHY (WARNING): + * All instances in the instance group are unhealthy (not in RUNNING + * state). + * - BACKEND_SERVICE_DOES_NOT_EXIST (ERROR): + * There is no backend service attached to the instance group. + * - CAPPED_AT_MAX_NUM_REPLICAS (WARNING): + * Autoscaler recommends a size greater than maxNumReplicas. + * - CUSTOM_METRIC_DATA_POINTS_TOO_SPARSE (WARNING): + * The custom metric samples are not exported often enough to be + * a credible base for autoscaling. + * - CUSTOM_METRIC_INVALID (ERROR): + * The custom metric that was specified does not exist or does not have + * the necessary labels. + * - MIN_EQUALS_MAX (WARNING): + * The minNumReplicas is equal to maxNumReplicas. This means the + * autoscaler cannot add or remove instances from the instance group. + * - MISSING_CUSTOM_METRIC_DATA_POINTS (WARNING): + * The autoscaler did not receive any data from the custom metric + * configured for autoscaling. + * - MISSING_LOAD_BALANCING_DATA_POINTS (WARNING): + * The autoscaler is configured to scale based on a load balancing signal + * but the instance group has not received any requests from the load + * balancer. + * - MODE_OFF (WARNING): + * Autoscaling is turned off. The number of instances in the group won't + * change automatically. The autoscaling configuration is preserved. + * - MODE_ONLY_UP (WARNING): + * Autoscaling is in the "Autoscale only out" mode. The autoscaler can add + * instances but not remove any. + * - MORE_THAN_ONE_BACKEND_SERVICE (ERROR): + * The instance group cannot be autoscaled because it has more than one + * backend service attached to it. + * - NOT_ENOUGH_QUOTA_AVAILABLE (ERROR): + * There is insufficient quota for the necessary resources, such as CPU or + * number of instances. + * - REGION_RESOURCE_STOCKOUT (ERROR): + * Shown only for regional autoscalers: there is a resource stockout in + * the chosen region. + * - SCALING_TARGET_DOES_NOT_EXIST (ERROR): + * The target to be scaled does not exist. + * - UNSUPPORTED_MAX_RATE_LOAD_BALANCING_CONFIGURATION + * (ERROR): Autoscaling does not work with an HTTP/S load balancer that + * has been configured for maxRate. + * - ZONE_RESOURCE_STOCKOUT (ERROR): + * For zonal autoscalers: there is a resource stockout in the chosen zone. + * For regional autoscalers: in at least one of the zones you're using + * there is a resource stockout. + * New values might be added in the future. Some of the values might not be + * available in all API versions. * Check the Type enum for the list of possible values. * * Generated from protobuf field optional string type = 3575610; @@ -37,7 +87,57 @@ class AutoscalerStatusDetails extends \Google\Protobuf\Internal\Message * @type string $message * The status message. * @type string $type - * The type of error, warning, or notice returned. Current set of possible values: - ALL_INSTANCES_UNHEALTHY (WARNING): All instances in the instance group are unhealthy (not in RUNNING state). - BACKEND_SERVICE_DOES_NOT_EXIST (ERROR): There is no backend service attached to the instance group. - CAPPED_AT_MAX_NUM_REPLICAS (WARNING): Autoscaler recommends a size greater than maxNumReplicas. - CUSTOM_METRIC_DATA_POINTS_TOO_SPARSE (WARNING): The custom metric samples are not exported often enough to be a credible base for autoscaling. - CUSTOM_METRIC_INVALID (ERROR): The custom metric that was specified does not exist or does not have the necessary labels. - MIN_EQUALS_MAX (WARNING): The minNumReplicas is equal to maxNumReplicas. This means the autoscaler cannot add or remove instances from the instance group. - MISSING_CUSTOM_METRIC_DATA_POINTS (WARNING): The autoscaler did not receive any data from the custom metric configured for autoscaling. - MISSING_LOAD_BALANCING_DATA_POINTS (WARNING): The autoscaler is configured to scale based on a load balancing signal but the instance group has not received any requests from the load balancer. - MODE_OFF (WARNING): Autoscaling is turned off. The number of instances in the group won't change automatically. The autoscaling configuration is preserved. - MODE_ONLY_UP (WARNING): Autoscaling is in the "Autoscale only out" mode. The autoscaler can add instances but not remove any. - MORE_THAN_ONE_BACKEND_SERVICE (ERROR): The instance group cannot be autoscaled because it has more than one backend service attached to it. - NOT_ENOUGH_QUOTA_AVAILABLE (ERROR): There is insufficient quota for the necessary resources, such as CPU or number of instances. - REGION_RESOURCE_STOCKOUT (ERROR): Shown only for regional autoscalers: there is a resource stockout in the chosen region. - SCALING_TARGET_DOES_NOT_EXIST (ERROR): The target to be scaled does not exist. - UNSUPPORTED_MAX_RATE_LOAD_BALANCING_CONFIGURATION (ERROR): Autoscaling does not work with an HTTP/S load balancer that has been configured for maxRate. - ZONE_RESOURCE_STOCKOUT (ERROR): For zonal autoscalers: there is a resource stockout in the chosen zone. For regional autoscalers: in at least one of the zones you're using there is a resource stockout. New values might be added in the future. Some of the values might not be available in all API versions. + * The type of error, warning, or notice returned. Current set of possible + * values: + * - ALL_INSTANCES_UNHEALTHY (WARNING): + * All instances in the instance group are unhealthy (not in RUNNING + * state). + * - BACKEND_SERVICE_DOES_NOT_EXIST (ERROR): + * There is no backend service attached to the instance group. + * - CAPPED_AT_MAX_NUM_REPLICAS (WARNING): + * Autoscaler recommends a size greater than maxNumReplicas. + * - CUSTOM_METRIC_DATA_POINTS_TOO_SPARSE (WARNING): + * The custom metric samples are not exported often enough to be + * a credible base for autoscaling. + * - CUSTOM_METRIC_INVALID (ERROR): + * The custom metric that was specified does not exist or does not have + * the necessary labels. + * - MIN_EQUALS_MAX (WARNING): + * The minNumReplicas is equal to maxNumReplicas. This means the + * autoscaler cannot add or remove instances from the instance group. + * - MISSING_CUSTOM_METRIC_DATA_POINTS (WARNING): + * The autoscaler did not receive any data from the custom metric + * configured for autoscaling. + * - MISSING_LOAD_BALANCING_DATA_POINTS (WARNING): + * The autoscaler is configured to scale based on a load balancing signal + * but the instance group has not received any requests from the load + * balancer. + * - MODE_OFF (WARNING): + * Autoscaling is turned off. The number of instances in the group won't + * change automatically. The autoscaling configuration is preserved. + * - MODE_ONLY_UP (WARNING): + * Autoscaling is in the "Autoscale only out" mode. The autoscaler can add + * instances but not remove any. + * - MORE_THAN_ONE_BACKEND_SERVICE (ERROR): + * The instance group cannot be autoscaled because it has more than one + * backend service attached to it. + * - NOT_ENOUGH_QUOTA_AVAILABLE (ERROR): + * There is insufficient quota for the necessary resources, such as CPU or + * number of instances. + * - REGION_RESOURCE_STOCKOUT (ERROR): + * Shown only for regional autoscalers: there is a resource stockout in + * the chosen region. + * - SCALING_TARGET_DOES_NOT_EXIST (ERROR): + * The target to be scaled does not exist. + * - UNSUPPORTED_MAX_RATE_LOAD_BALANCING_CONFIGURATION + * (ERROR): Autoscaling does not work with an HTTP/S load balancer that + * has been configured for maxRate. + * - ZONE_RESOURCE_STOCKOUT (ERROR): + * For zonal autoscalers: there is a resource stockout in the chosen zone. + * For regional autoscalers: in at least one of the zones you're using + * there is a resource stockout. + * New values might be added in the future. Some of the values might not be + * available in all API versions. * Check the Type enum for the list of possible values. * } */ @@ -83,7 +183,57 @@ public function setMessage($var) } /** - * The type of error, warning, or notice returned. Current set of possible values: - ALL_INSTANCES_UNHEALTHY (WARNING): All instances in the instance group are unhealthy (not in RUNNING state). - BACKEND_SERVICE_DOES_NOT_EXIST (ERROR): There is no backend service attached to the instance group. - CAPPED_AT_MAX_NUM_REPLICAS (WARNING): Autoscaler recommends a size greater than maxNumReplicas. - CUSTOM_METRIC_DATA_POINTS_TOO_SPARSE (WARNING): The custom metric samples are not exported often enough to be a credible base for autoscaling. - CUSTOM_METRIC_INVALID (ERROR): The custom metric that was specified does not exist or does not have the necessary labels. - MIN_EQUALS_MAX (WARNING): The minNumReplicas is equal to maxNumReplicas. This means the autoscaler cannot add or remove instances from the instance group. - MISSING_CUSTOM_METRIC_DATA_POINTS (WARNING): The autoscaler did not receive any data from the custom metric configured for autoscaling. - MISSING_LOAD_BALANCING_DATA_POINTS (WARNING): The autoscaler is configured to scale based on a load balancing signal but the instance group has not received any requests from the load balancer. - MODE_OFF (WARNING): Autoscaling is turned off. The number of instances in the group won't change automatically. The autoscaling configuration is preserved. - MODE_ONLY_UP (WARNING): Autoscaling is in the "Autoscale only out" mode. The autoscaler can add instances but not remove any. - MORE_THAN_ONE_BACKEND_SERVICE (ERROR): The instance group cannot be autoscaled because it has more than one backend service attached to it. - NOT_ENOUGH_QUOTA_AVAILABLE (ERROR): There is insufficient quota for the necessary resources, such as CPU or number of instances. - REGION_RESOURCE_STOCKOUT (ERROR): Shown only for regional autoscalers: there is a resource stockout in the chosen region. - SCALING_TARGET_DOES_NOT_EXIST (ERROR): The target to be scaled does not exist. - UNSUPPORTED_MAX_RATE_LOAD_BALANCING_CONFIGURATION (ERROR): Autoscaling does not work with an HTTP/S load balancer that has been configured for maxRate. - ZONE_RESOURCE_STOCKOUT (ERROR): For zonal autoscalers: there is a resource stockout in the chosen zone. For regional autoscalers: in at least one of the zones you're using there is a resource stockout. New values might be added in the future. Some of the values might not be available in all API versions. + * The type of error, warning, or notice returned. Current set of possible + * values: + * - ALL_INSTANCES_UNHEALTHY (WARNING): + * All instances in the instance group are unhealthy (not in RUNNING + * state). + * - BACKEND_SERVICE_DOES_NOT_EXIST (ERROR): + * There is no backend service attached to the instance group. + * - CAPPED_AT_MAX_NUM_REPLICAS (WARNING): + * Autoscaler recommends a size greater than maxNumReplicas. + * - CUSTOM_METRIC_DATA_POINTS_TOO_SPARSE (WARNING): + * The custom metric samples are not exported often enough to be + * a credible base for autoscaling. + * - CUSTOM_METRIC_INVALID (ERROR): + * The custom metric that was specified does not exist or does not have + * the necessary labels. + * - MIN_EQUALS_MAX (WARNING): + * The minNumReplicas is equal to maxNumReplicas. This means the + * autoscaler cannot add or remove instances from the instance group. + * - MISSING_CUSTOM_METRIC_DATA_POINTS (WARNING): + * The autoscaler did not receive any data from the custom metric + * configured for autoscaling. + * - MISSING_LOAD_BALANCING_DATA_POINTS (WARNING): + * The autoscaler is configured to scale based on a load balancing signal + * but the instance group has not received any requests from the load + * balancer. + * - MODE_OFF (WARNING): + * Autoscaling is turned off. The number of instances in the group won't + * change automatically. The autoscaling configuration is preserved. + * - MODE_ONLY_UP (WARNING): + * Autoscaling is in the "Autoscale only out" mode. The autoscaler can add + * instances but not remove any. + * - MORE_THAN_ONE_BACKEND_SERVICE (ERROR): + * The instance group cannot be autoscaled because it has more than one + * backend service attached to it. + * - NOT_ENOUGH_QUOTA_AVAILABLE (ERROR): + * There is insufficient quota for the necessary resources, such as CPU or + * number of instances. + * - REGION_RESOURCE_STOCKOUT (ERROR): + * Shown only for regional autoscalers: there is a resource stockout in + * the chosen region. + * - SCALING_TARGET_DOES_NOT_EXIST (ERROR): + * The target to be scaled does not exist. + * - UNSUPPORTED_MAX_RATE_LOAD_BALANCING_CONFIGURATION + * (ERROR): Autoscaling does not work with an HTTP/S load balancer that + * has been configured for maxRate. + * - ZONE_RESOURCE_STOCKOUT (ERROR): + * For zonal autoscalers: there is a resource stockout in the chosen zone. + * For regional autoscalers: in at least one of the zones you're using + * there is a resource stockout. + * New values might be added in the future. Some of the values might not be + * available in all API versions. * Check the Type enum for the list of possible values. * * Generated from protobuf field optional string type = 3575610; @@ -105,7 +255,57 @@ public function clearType() } /** - * The type of error, warning, or notice returned. Current set of possible values: - ALL_INSTANCES_UNHEALTHY (WARNING): All instances in the instance group are unhealthy (not in RUNNING state). - BACKEND_SERVICE_DOES_NOT_EXIST (ERROR): There is no backend service attached to the instance group. - CAPPED_AT_MAX_NUM_REPLICAS (WARNING): Autoscaler recommends a size greater than maxNumReplicas. - CUSTOM_METRIC_DATA_POINTS_TOO_SPARSE (WARNING): The custom metric samples are not exported often enough to be a credible base for autoscaling. - CUSTOM_METRIC_INVALID (ERROR): The custom metric that was specified does not exist or does not have the necessary labels. - MIN_EQUALS_MAX (WARNING): The minNumReplicas is equal to maxNumReplicas. This means the autoscaler cannot add or remove instances from the instance group. - MISSING_CUSTOM_METRIC_DATA_POINTS (WARNING): The autoscaler did not receive any data from the custom metric configured for autoscaling. - MISSING_LOAD_BALANCING_DATA_POINTS (WARNING): The autoscaler is configured to scale based on a load balancing signal but the instance group has not received any requests from the load balancer. - MODE_OFF (WARNING): Autoscaling is turned off. The number of instances in the group won't change automatically. The autoscaling configuration is preserved. - MODE_ONLY_UP (WARNING): Autoscaling is in the "Autoscale only out" mode. The autoscaler can add instances but not remove any. - MORE_THAN_ONE_BACKEND_SERVICE (ERROR): The instance group cannot be autoscaled because it has more than one backend service attached to it. - NOT_ENOUGH_QUOTA_AVAILABLE (ERROR): There is insufficient quota for the necessary resources, such as CPU or number of instances. - REGION_RESOURCE_STOCKOUT (ERROR): Shown only for regional autoscalers: there is a resource stockout in the chosen region. - SCALING_TARGET_DOES_NOT_EXIST (ERROR): The target to be scaled does not exist. - UNSUPPORTED_MAX_RATE_LOAD_BALANCING_CONFIGURATION (ERROR): Autoscaling does not work with an HTTP/S load balancer that has been configured for maxRate. - ZONE_RESOURCE_STOCKOUT (ERROR): For zonal autoscalers: there is a resource stockout in the chosen zone. For regional autoscalers: in at least one of the zones you're using there is a resource stockout. New values might be added in the future. Some of the values might not be available in all API versions. + * The type of error, warning, or notice returned. Current set of possible + * values: + * - ALL_INSTANCES_UNHEALTHY (WARNING): + * All instances in the instance group are unhealthy (not in RUNNING + * state). + * - BACKEND_SERVICE_DOES_NOT_EXIST (ERROR): + * There is no backend service attached to the instance group. + * - CAPPED_AT_MAX_NUM_REPLICAS (WARNING): + * Autoscaler recommends a size greater than maxNumReplicas. + * - CUSTOM_METRIC_DATA_POINTS_TOO_SPARSE (WARNING): + * The custom metric samples are not exported often enough to be + * a credible base for autoscaling. + * - CUSTOM_METRIC_INVALID (ERROR): + * The custom metric that was specified does not exist or does not have + * the necessary labels. + * - MIN_EQUALS_MAX (WARNING): + * The minNumReplicas is equal to maxNumReplicas. This means the + * autoscaler cannot add or remove instances from the instance group. + * - MISSING_CUSTOM_METRIC_DATA_POINTS (WARNING): + * The autoscaler did not receive any data from the custom metric + * configured for autoscaling. + * - MISSING_LOAD_BALANCING_DATA_POINTS (WARNING): + * The autoscaler is configured to scale based on a load balancing signal + * but the instance group has not received any requests from the load + * balancer. + * - MODE_OFF (WARNING): + * Autoscaling is turned off. The number of instances in the group won't + * change automatically. The autoscaling configuration is preserved. + * - MODE_ONLY_UP (WARNING): + * Autoscaling is in the "Autoscale only out" mode. The autoscaler can add + * instances but not remove any. + * - MORE_THAN_ONE_BACKEND_SERVICE (ERROR): + * The instance group cannot be autoscaled because it has more than one + * backend service attached to it. + * - NOT_ENOUGH_QUOTA_AVAILABLE (ERROR): + * There is insufficient quota for the necessary resources, such as CPU or + * number of instances. + * - REGION_RESOURCE_STOCKOUT (ERROR): + * Shown only for regional autoscalers: there is a resource stockout in + * the chosen region. + * - SCALING_TARGET_DOES_NOT_EXIST (ERROR): + * The target to be scaled does not exist. + * - UNSUPPORTED_MAX_RATE_LOAD_BALANCING_CONFIGURATION + * (ERROR): Autoscaling does not work with an HTTP/S load balancer that + * has been configured for maxRate. + * - ZONE_RESOURCE_STOCKOUT (ERROR): + * For zonal autoscalers: there is a resource stockout in the chosen zone. + * For regional autoscalers: in at least one of the zones you're using + * there is a resource stockout. + * New values might be added in the future. Some of the values might not be + * available in all API versions. * Check the Type enum for the list of possible values. * * Generated from protobuf field optional string type = 3575610; diff --git a/Compute/src/V1/AutoscalerStatusDetails/Type.php b/Compute/src/V1/AutoscalerStatusDetails/Type.php index 93d0b9533e1d..d403cc1031e4 100644 --- a/Compute/src/V1/AutoscalerStatusDetails/Type.php +++ b/Compute/src/V1/AutoscalerStatusDetails/Type.php @@ -7,7 +7,57 @@ use UnexpectedValueException; /** - * The type of error, warning, or notice returned. Current set of possible values: - ALL_INSTANCES_UNHEALTHY (WARNING): All instances in the instance group are unhealthy (not in RUNNING state). - BACKEND_SERVICE_DOES_NOT_EXIST (ERROR): There is no backend service attached to the instance group. - CAPPED_AT_MAX_NUM_REPLICAS (WARNING): Autoscaler recommends a size greater than maxNumReplicas. - CUSTOM_METRIC_DATA_POINTS_TOO_SPARSE (WARNING): The custom metric samples are not exported often enough to be a credible base for autoscaling. - CUSTOM_METRIC_INVALID (ERROR): The custom metric that was specified does not exist or does not have the necessary labels. - MIN_EQUALS_MAX (WARNING): The minNumReplicas is equal to maxNumReplicas. This means the autoscaler cannot add or remove instances from the instance group. - MISSING_CUSTOM_METRIC_DATA_POINTS (WARNING): The autoscaler did not receive any data from the custom metric configured for autoscaling. - MISSING_LOAD_BALANCING_DATA_POINTS (WARNING): The autoscaler is configured to scale based on a load balancing signal but the instance group has not received any requests from the load balancer. - MODE_OFF (WARNING): Autoscaling is turned off. The number of instances in the group won't change automatically. The autoscaling configuration is preserved. - MODE_ONLY_UP (WARNING): Autoscaling is in the "Autoscale only out" mode. The autoscaler can add instances but not remove any. - MORE_THAN_ONE_BACKEND_SERVICE (ERROR): The instance group cannot be autoscaled because it has more than one backend service attached to it. - NOT_ENOUGH_QUOTA_AVAILABLE (ERROR): There is insufficient quota for the necessary resources, such as CPU or number of instances. - REGION_RESOURCE_STOCKOUT (ERROR): Shown only for regional autoscalers: there is a resource stockout in the chosen region. - SCALING_TARGET_DOES_NOT_EXIST (ERROR): The target to be scaled does not exist. - UNSUPPORTED_MAX_RATE_LOAD_BALANCING_CONFIGURATION (ERROR): Autoscaling does not work with an HTTP/S load balancer that has been configured for maxRate. - ZONE_RESOURCE_STOCKOUT (ERROR): For zonal autoscalers: there is a resource stockout in the chosen zone. For regional autoscalers: in at least one of the zones you're using there is a resource stockout. New values might be added in the future. Some of the values might not be available in all API versions. + * The type of error, warning, or notice returned. Current set of possible + * values: + * - ALL_INSTANCES_UNHEALTHY (WARNING): + * All instances in the instance group are unhealthy (not in RUNNING + * state). + * - BACKEND_SERVICE_DOES_NOT_EXIST (ERROR): + * There is no backend service attached to the instance group. + * - CAPPED_AT_MAX_NUM_REPLICAS (WARNING): + * Autoscaler recommends a size greater than maxNumReplicas. + * - CUSTOM_METRIC_DATA_POINTS_TOO_SPARSE (WARNING): + * The custom metric samples are not exported often enough to be + * a credible base for autoscaling. + * - CUSTOM_METRIC_INVALID (ERROR): + * The custom metric that was specified does not exist or does not have + * the necessary labels. + * - MIN_EQUALS_MAX (WARNING): + * The minNumReplicas is equal to maxNumReplicas. This means the + * autoscaler cannot add or remove instances from the instance group. + * - MISSING_CUSTOM_METRIC_DATA_POINTS (WARNING): + * The autoscaler did not receive any data from the custom metric + * configured for autoscaling. + * - MISSING_LOAD_BALANCING_DATA_POINTS (WARNING): + * The autoscaler is configured to scale based on a load balancing signal + * but the instance group has not received any requests from the load + * balancer. + * - MODE_OFF (WARNING): + * Autoscaling is turned off. The number of instances in the group won't + * change automatically. The autoscaling configuration is preserved. + * - MODE_ONLY_UP (WARNING): + * Autoscaling is in the "Autoscale only out" mode. The autoscaler can add + * instances but not remove any. + * - MORE_THAN_ONE_BACKEND_SERVICE (ERROR): + * The instance group cannot be autoscaled because it has more than one + * backend service attached to it. + * - NOT_ENOUGH_QUOTA_AVAILABLE (ERROR): + * There is insufficient quota for the necessary resources, such as CPU or + * number of instances. + * - REGION_RESOURCE_STOCKOUT (ERROR): + * Shown only for regional autoscalers: there is a resource stockout in + * the chosen region. + * - SCALING_TARGET_DOES_NOT_EXIST (ERROR): + * The target to be scaled does not exist. + * - UNSUPPORTED_MAX_RATE_LOAD_BALANCING_CONFIGURATION + * (ERROR): Autoscaling does not work with an HTTP/S load balancer that + * has been configured for maxRate. + * - ZONE_RESOURCE_STOCKOUT (ERROR): + * For zonal autoscalers: there is a resource stockout in the chosen zone. + * For regional autoscalers: in at least one of the zones you're using + * there is a resource stockout. + * New values might be added in the future. Some of the values might not be + * available in all API versions. * * Protobuf type google.cloud.compute.v1.AutoscalerStatusDetails.Type */ @@ -38,67 +88,79 @@ class Type */ const CAPPED_AT_MAX_NUM_REPLICAS = 518617; /** - * The custom metric samples are not exported often enough to be a credible base for autoscaling. + * The custom metric samples are not exported often enough to be a credible + * base for autoscaling. * * Generated from protobuf enum CUSTOM_METRIC_DATA_POINTS_TOO_SPARSE = 328964659; */ const CUSTOM_METRIC_DATA_POINTS_TOO_SPARSE = 328964659; /** - * The custom metric that was specified does not exist or does not have the necessary labels. + * The custom metric that was specified does not exist or does not have the + * necessary labels. * * Generated from protobuf enum CUSTOM_METRIC_INVALID = 204430550; */ const CUSTOM_METRIC_INVALID = 204430550; /** - * The minNumReplicas is equal to maxNumReplicas. This means the autoscaler cannot add or remove instances from the instance group. + * The minNumReplicas is equal to maxNumReplicas. This means the autoscaler + * cannot add or remove instances from the instance group. * * Generated from protobuf enum MIN_EQUALS_MAX = 2821361; */ const MIN_EQUALS_MAX = 2821361; /** - * The autoscaler did not receive any data from the custom metric configured for autoscaling. + * The autoscaler did not receive any data from the custom metric configured + * for autoscaling. * * Generated from protobuf enum MISSING_CUSTOM_METRIC_DATA_POINTS = 94885086; */ const MISSING_CUSTOM_METRIC_DATA_POINTS = 94885086; /** - * The autoscaler is configured to scale based on a load balancing signal but the instance group has not received any requests from the load balancer. + * The autoscaler is configured to scale based on a load balancing signal + * but the instance group has not received any requests from the load + * balancer. * * Generated from protobuf enum MISSING_LOAD_BALANCING_DATA_POINTS = 509858898; */ const MISSING_LOAD_BALANCING_DATA_POINTS = 509858898; /** - * Autoscaling is turned off. The number of instances in the group won't change automatically. The autoscaling configuration is preserved. + * Autoscaling is turned off. The number of instances in the group won't + * change automatically. The autoscaling configuration is preserved. * * Generated from protobuf enum MODE_OFF = 164169907; */ const MODE_OFF = 164169907; /** - * Autoscaling is in the "Autoscale only scale out" mode. Instances in the group will be only added. + * Autoscaling is in the "Autoscale only scale out" mode. + * Instances in the group will be only added. * * Generated from protobuf enum MODE_ONLY_SCALE_OUT = 3840994; */ const MODE_ONLY_SCALE_OUT = 3840994; /** - * Autoscaling is in the "Autoscale only out" mode. Instances in the group will be only added. + * Autoscaling is in the "Autoscale only out" mode. Instances in the group + * will be only added. * * Generated from protobuf enum MODE_ONLY_UP = 100969842; */ const MODE_ONLY_UP = 100969842; /** - * The instance group cannot be autoscaled because it has more than one backend service attached to it. + * The instance group cannot be autoscaled because it has more than one + * backend service attached to it. * * Generated from protobuf enum MORE_THAN_ONE_BACKEND_SERVICE = 151922141; */ const MORE_THAN_ONE_BACKEND_SERVICE = 151922141; /** - * There is insufficient quota for the necessary resources, such as CPU or number of instances. + * There is insufficient quota for the necessary resources, such as CPU or + * number of instances. * * Generated from protobuf enum NOT_ENOUGH_QUOTA_AVAILABLE = 403101631; */ const NOT_ENOUGH_QUOTA_AVAILABLE = 403101631; /** - * Showed only for regional autoscalers: there is a resource stockout in the chosen region. + * Showed only for regional autoscalers: there is a resource stockout in + * the chosen region. * * Generated from protobuf enum REGION_RESOURCE_STOCKOUT = 528622846; */ @@ -110,13 +172,17 @@ class Type */ const SCALING_TARGET_DOES_NOT_EXIST = 122636699; /** - * For some scaling schedules minRequiredReplicas is greater than maxNumReplicas. Autoscaler always recommends at most maxNumReplicas instances. + * For some scaling schedules minRequiredReplicas is greater than + * maxNumReplicas. Autoscaler always recommends at most maxNumReplicas + * instances. * * Generated from protobuf enum SCHEDULED_INSTANCES_GREATER_THAN_AUTOSCALER_MAX = 29275586; */ const SCHEDULED_INSTANCES_GREATER_THAN_AUTOSCALER_MAX = 29275586; /** - * For some scaling schedules minRequiredReplicas is less than minNumReplicas. Autoscaler always recommends at least minNumReplicas instances. + * For some scaling schedules minRequiredReplicas is less than + * minNumReplicas. Autoscaler always recommends at least minNumReplicas + * instances. * * Generated from protobuf enum SCHEDULED_INSTANCES_LESS_THAN_AUTOSCALER_MIN = 398287669; */ @@ -126,13 +192,16 @@ class Type */ const UNKNOWN = 433141802; /** - * Autoscaling does not work with an HTTP/S load balancer that has been configured for maxRate. + * Autoscaling does not work with an HTTP/S load balancer that has been + * configured for maxRate. * * Generated from protobuf enum UNSUPPORTED_MAX_RATE_LOAD_BALANCING_CONFIGURATION = 330845009; */ const UNSUPPORTED_MAX_RATE_LOAD_BALANCING_CONFIGURATION = 330845009; /** - * For zonal autoscalers: there is a resource stockout in the chosen zone. For regional autoscalers: in at least one of the zones you're using there is a resource stockout. + * For zonal autoscalers: there is a resource stockout in the chosen zone. + * For regional autoscalers: in at least one of the zones you're using there + * is a resource stockout. * * Generated from protobuf enum ZONE_RESOURCE_STOCKOUT = 210200502; */ diff --git a/Compute/src/V1/AutoscalersScopedList.php b/Compute/src/V1/AutoscalersScopedList.php index 820f3df7774c..9e05768678b9 100644 --- a/Compute/src/V1/AutoscalersScopedList.php +++ b/Compute/src/V1/AutoscalersScopedList.php @@ -21,7 +21,8 @@ class AutoscalersScopedList extends \Google\Protobuf\Internal\Message */ private $autoscalers; /** - * [Output Only] Informational warning which replaces the list of autoscalers when the list is empty. + * [Output Only] Informational warning which replaces the list of autoscalers + * when the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; */ @@ -36,7 +37,8 @@ class AutoscalersScopedList extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\Autoscaler>|\Google\Protobuf\Internal\RepeatedField $autoscalers * [Output Only] A list of autoscalers contained in this scope. * @type \Google\Cloud\Compute\V1\Warning $warning - * [Output Only] Informational warning which replaces the list of autoscalers when the list is empty. + * [Output Only] Informational warning which replaces the list of autoscalers + * when the list is empty. * } */ public function __construct($data = NULL) { @@ -71,7 +73,8 @@ public function setAutoscalers($var) } /** - * [Output Only] Informational warning which replaces the list of autoscalers when the list is empty. + * [Output Only] Informational warning which replaces the list of autoscalers + * when the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; * @return \Google\Cloud\Compute\V1\Warning|null @@ -92,7 +95,8 @@ public function clearWarning() } /** - * [Output Only] Informational warning which replaces the list of autoscalers when the list is empty. + * [Output Only] Informational warning which replaces the list of autoscalers + * when the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; * @param \Google\Cloud\Compute\V1\Warning $var diff --git a/Compute/src/V1/AutoscalingPolicy.php b/Compute/src/V1/AutoscalingPolicy.php index 602da2478593..c1d0f5f0f8c5 100644 --- a/Compute/src/V1/AutoscalingPolicy.php +++ b/Compute/src/V1/AutoscalingPolicy.php @@ -16,13 +16,25 @@ class AutoscalingPolicy extends \Google\Protobuf\Internal\Message { /** - * The number of seconds that your application takes to initialize on a VM instance. This is referred to as the [initialization period](/compute/docs/autoscaler#cool_down_period). Specifying an accurate initialization period improves autoscaler decisions. For example, when scaling out, the autoscaler ignores data from VMs that are still initializing because those VMs might not yet represent normal usage of your application. The default initialization period is 60 seconds. Initialization periods might vary because of numerous factors. We recommend that you test how long your application takes to initialize. To do this, create a VM and time your application's startup process. + * The number of seconds that your application takes to initialize on a VM + * instance. This is referred to as the + * [initialization period](/compute/docs/autoscaler#cool_down_period). + * Specifying an accurate initialization period improves + * autoscaler decisions. For example, when scaling out, the autoscaler ignores + * data from VMs that are still initializing because those VMs might not yet + * represent normal usage of your application. The default initialization + * period is 60 seconds. + * Initialization periods might vary because of numerous + * factors. We recommend that you test how long your application takes to + * initialize. To do this, create a VM and time your application's startup + * process. * * Generated from protobuf field optional int32 cool_down_period_sec = 107692954; */ protected $cool_down_period_sec = null; /** - * Defines the CPU utilization policy that allows the autoscaler to scale based on the average CPU utilization of a managed instance group. + * Defines the CPU utilization policy that allows the autoscaler to scale + * based on the average CPU utilization of a managed instance group. * * Generated from protobuf field optional .google.cloud.compute.v1.AutoscalingPolicyCpuUtilization cpu_utilization = 381211147; */ @@ -40,19 +52,32 @@ class AutoscalingPolicy extends \Google\Protobuf\Internal\Message */ protected $load_balancing_utilization = null; /** - * The maximum number of instances that the autoscaler can scale out to. This is required when creating or updating an autoscaler. The maximum number of replicas must not be lower than minimal number of replicas. + * The maximum number of instances that the autoscaler can scale out to. This + * is required when creating or updating an autoscaler. The maximum number + * of replicas must not be lower than minimal number of replicas. * * Generated from protobuf field optional int32 max_num_replicas = 62327375; */ protected $max_num_replicas = null; /** - * The minimum number of replicas that the autoscaler can scale in to. This cannot be less than 0. If not provided, autoscaler chooses a default value depending on maximum number of instances allowed. + * The minimum number of replicas that the autoscaler can scale in to. + * This cannot be less than 0. If not provided, autoscaler chooses a + * default value depending on maximum number of instances allowed. * * Generated from protobuf field optional int32 min_num_replicas = 535329825; */ protected $min_num_replicas = null; /** - * Defines the operating mode for this policy. The following modes are available: - OFF: Disables the autoscaler but maintains its configuration. - ONLY_SCALE_OUT: Restricts the autoscaler to add VM instances only. - ON: Enables all autoscaler activities according to its policy. For more information, see "Turning off or restricting an autoscaler" + * Defines the operating mode for this policy. + * The following modes are available: + * - OFF: Disables the autoscaler but maintains its + * configuration. + * - ONLY_SCALE_OUT: Restricts the autoscaler to add + * VM instances only. + * - ON: Enables all autoscaler activities according to its + * policy. + * For more information, see + * "Turning off or restricting an autoscaler" * Check the Mode enum for the list of possible values. * * Generated from protobuf field optional string mode = 3357091; @@ -63,7 +88,10 @@ class AutoscalingPolicy extends \Google\Protobuf\Internal\Message */ protected $scale_in_control = null; /** - * Scaling schedules defined for an autoscaler. Multiple schedules can be set on an autoscaler, and they can overlap. During overlapping periods the greatest min_required_replicas of all scaling schedules is applied. Up to 128 scaling schedules are allowed. + * Scaling schedules defined for an autoscaler. Multiple schedules + * can be set on an autoscaler, and they can overlap. During overlapping + * periods the greatest min_required_replicas of all scaling schedules is + * applied. Up to 128 scaling schedules are allowed. * * Generated from protobuf field map scaling_schedules = 355416580; */ @@ -76,23 +104,51 @@ class AutoscalingPolicy extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type int $cool_down_period_sec - * The number of seconds that your application takes to initialize on a VM instance. This is referred to as the [initialization period](/compute/docs/autoscaler#cool_down_period). Specifying an accurate initialization period improves autoscaler decisions. For example, when scaling out, the autoscaler ignores data from VMs that are still initializing because those VMs might not yet represent normal usage of your application. The default initialization period is 60 seconds. Initialization periods might vary because of numerous factors. We recommend that you test how long your application takes to initialize. To do this, create a VM and time your application's startup process. + * The number of seconds that your application takes to initialize on a VM + * instance. This is referred to as the + * [initialization period](/compute/docs/autoscaler#cool_down_period). + * Specifying an accurate initialization period improves + * autoscaler decisions. For example, when scaling out, the autoscaler ignores + * data from VMs that are still initializing because those VMs might not yet + * represent normal usage of your application. The default initialization + * period is 60 seconds. + * Initialization periods might vary because of numerous + * factors. We recommend that you test how long your application takes to + * initialize. To do this, create a VM and time your application's startup + * process. * @type \Google\Cloud\Compute\V1\AutoscalingPolicyCpuUtilization $cpu_utilization - * Defines the CPU utilization policy that allows the autoscaler to scale based on the average CPU utilization of a managed instance group. + * Defines the CPU utilization policy that allows the autoscaler to scale + * based on the average CPU utilization of a managed instance group. * @type array<\Google\Cloud\Compute\V1\AutoscalingPolicyCustomMetricUtilization>|\Google\Protobuf\Internal\RepeatedField $custom_metric_utilizations * Configuration parameters of autoscaling based on a custom metric. * @type \Google\Cloud\Compute\V1\AutoscalingPolicyLoadBalancingUtilization $load_balancing_utilization * Configuration parameters of autoscaling based on load balancer. * @type int $max_num_replicas - * The maximum number of instances that the autoscaler can scale out to. This is required when creating or updating an autoscaler. The maximum number of replicas must not be lower than minimal number of replicas. + * The maximum number of instances that the autoscaler can scale out to. This + * is required when creating or updating an autoscaler. The maximum number + * of replicas must not be lower than minimal number of replicas. * @type int $min_num_replicas - * The minimum number of replicas that the autoscaler can scale in to. This cannot be less than 0. If not provided, autoscaler chooses a default value depending on maximum number of instances allowed. + * The minimum number of replicas that the autoscaler can scale in to. + * This cannot be less than 0. If not provided, autoscaler chooses a + * default value depending on maximum number of instances allowed. * @type string $mode - * Defines the operating mode for this policy. The following modes are available: - OFF: Disables the autoscaler but maintains its configuration. - ONLY_SCALE_OUT: Restricts the autoscaler to add VM instances only. - ON: Enables all autoscaler activities according to its policy. For more information, see "Turning off or restricting an autoscaler" + * Defines the operating mode for this policy. + * The following modes are available: + * - OFF: Disables the autoscaler but maintains its + * configuration. + * - ONLY_SCALE_OUT: Restricts the autoscaler to add + * VM instances only. + * - ON: Enables all autoscaler activities according to its + * policy. + * For more information, see + * "Turning off or restricting an autoscaler" * Check the Mode enum for the list of possible values. * @type \Google\Cloud\Compute\V1\AutoscalingPolicyScaleInControl $scale_in_control * @type array|\Google\Protobuf\Internal\MapField $scaling_schedules - * Scaling schedules defined for an autoscaler. Multiple schedules can be set on an autoscaler, and they can overlap. During overlapping periods the greatest min_required_replicas of all scaling schedules is applied. Up to 128 scaling schedules are allowed. + * Scaling schedules defined for an autoscaler. Multiple schedules + * can be set on an autoscaler, and they can overlap. During overlapping + * periods the greatest min_required_replicas of all scaling schedules is + * applied. Up to 128 scaling schedules are allowed. * } */ public function __construct($data = NULL) { @@ -101,7 +157,18 @@ public function __construct($data = NULL) { } /** - * The number of seconds that your application takes to initialize on a VM instance. This is referred to as the [initialization period](/compute/docs/autoscaler#cool_down_period). Specifying an accurate initialization period improves autoscaler decisions. For example, when scaling out, the autoscaler ignores data from VMs that are still initializing because those VMs might not yet represent normal usage of your application. The default initialization period is 60 seconds. Initialization periods might vary because of numerous factors. We recommend that you test how long your application takes to initialize. To do this, create a VM and time your application's startup process. + * The number of seconds that your application takes to initialize on a VM + * instance. This is referred to as the + * [initialization period](/compute/docs/autoscaler#cool_down_period). + * Specifying an accurate initialization period improves + * autoscaler decisions. For example, when scaling out, the autoscaler ignores + * data from VMs that are still initializing because those VMs might not yet + * represent normal usage of your application. The default initialization + * period is 60 seconds. + * Initialization periods might vary because of numerous + * factors. We recommend that you test how long your application takes to + * initialize. To do this, create a VM and time your application's startup + * process. * * Generated from protobuf field optional int32 cool_down_period_sec = 107692954; * @return int @@ -122,7 +189,18 @@ public function clearCoolDownPeriodSec() } /** - * The number of seconds that your application takes to initialize on a VM instance. This is referred to as the [initialization period](/compute/docs/autoscaler#cool_down_period). Specifying an accurate initialization period improves autoscaler decisions. For example, when scaling out, the autoscaler ignores data from VMs that are still initializing because those VMs might not yet represent normal usage of your application. The default initialization period is 60 seconds. Initialization periods might vary because of numerous factors. We recommend that you test how long your application takes to initialize. To do this, create a VM and time your application's startup process. + * The number of seconds that your application takes to initialize on a VM + * instance. This is referred to as the + * [initialization period](/compute/docs/autoscaler#cool_down_period). + * Specifying an accurate initialization period improves + * autoscaler decisions. For example, when scaling out, the autoscaler ignores + * data from VMs that are still initializing because those VMs might not yet + * represent normal usage of your application. The default initialization + * period is 60 seconds. + * Initialization periods might vary because of numerous + * factors. We recommend that you test how long your application takes to + * initialize. To do this, create a VM and time your application's startup + * process. * * Generated from protobuf field optional int32 cool_down_period_sec = 107692954; * @param int $var @@ -137,7 +215,8 @@ public function setCoolDownPeriodSec($var) } /** - * Defines the CPU utilization policy that allows the autoscaler to scale based on the average CPU utilization of a managed instance group. + * Defines the CPU utilization policy that allows the autoscaler to scale + * based on the average CPU utilization of a managed instance group. * * Generated from protobuf field optional .google.cloud.compute.v1.AutoscalingPolicyCpuUtilization cpu_utilization = 381211147; * @return \Google\Cloud\Compute\V1\AutoscalingPolicyCpuUtilization|null @@ -158,7 +237,8 @@ public function clearCpuUtilization() } /** - * Defines the CPU utilization policy that allows the autoscaler to scale based on the average CPU utilization of a managed instance group. + * Defines the CPU utilization policy that allows the autoscaler to scale + * based on the average CPU utilization of a managed instance group. * * Generated from protobuf field optional .google.cloud.compute.v1.AutoscalingPolicyCpuUtilization cpu_utilization = 381211147; * @param \Google\Cloud\Compute\V1\AutoscalingPolicyCpuUtilization $var @@ -235,7 +315,9 @@ public function setLoadBalancingUtilization($var) } /** - * The maximum number of instances that the autoscaler can scale out to. This is required when creating or updating an autoscaler. The maximum number of replicas must not be lower than minimal number of replicas. + * The maximum number of instances that the autoscaler can scale out to. This + * is required when creating or updating an autoscaler. The maximum number + * of replicas must not be lower than minimal number of replicas. * * Generated from protobuf field optional int32 max_num_replicas = 62327375; * @return int @@ -256,7 +338,9 @@ public function clearMaxNumReplicas() } /** - * The maximum number of instances that the autoscaler can scale out to. This is required when creating or updating an autoscaler. The maximum number of replicas must not be lower than minimal number of replicas. + * The maximum number of instances that the autoscaler can scale out to. This + * is required when creating or updating an autoscaler. The maximum number + * of replicas must not be lower than minimal number of replicas. * * Generated from protobuf field optional int32 max_num_replicas = 62327375; * @param int $var @@ -271,7 +355,9 @@ public function setMaxNumReplicas($var) } /** - * The minimum number of replicas that the autoscaler can scale in to. This cannot be less than 0. If not provided, autoscaler chooses a default value depending on maximum number of instances allowed. + * The minimum number of replicas that the autoscaler can scale in to. + * This cannot be less than 0. If not provided, autoscaler chooses a + * default value depending on maximum number of instances allowed. * * Generated from protobuf field optional int32 min_num_replicas = 535329825; * @return int @@ -292,7 +378,9 @@ public function clearMinNumReplicas() } /** - * The minimum number of replicas that the autoscaler can scale in to. This cannot be less than 0. If not provided, autoscaler chooses a default value depending on maximum number of instances allowed. + * The minimum number of replicas that the autoscaler can scale in to. + * This cannot be less than 0. If not provided, autoscaler chooses a + * default value depending on maximum number of instances allowed. * * Generated from protobuf field optional int32 min_num_replicas = 535329825; * @param int $var @@ -307,7 +395,16 @@ public function setMinNumReplicas($var) } /** - * Defines the operating mode for this policy. The following modes are available: - OFF: Disables the autoscaler but maintains its configuration. - ONLY_SCALE_OUT: Restricts the autoscaler to add VM instances only. - ON: Enables all autoscaler activities according to its policy. For more information, see "Turning off or restricting an autoscaler" + * Defines the operating mode for this policy. + * The following modes are available: + * - OFF: Disables the autoscaler but maintains its + * configuration. + * - ONLY_SCALE_OUT: Restricts the autoscaler to add + * VM instances only. + * - ON: Enables all autoscaler activities according to its + * policy. + * For more information, see + * "Turning off or restricting an autoscaler" * Check the Mode enum for the list of possible values. * * Generated from protobuf field optional string mode = 3357091; @@ -329,7 +426,16 @@ public function clearMode() } /** - * Defines the operating mode for this policy. The following modes are available: - OFF: Disables the autoscaler but maintains its configuration. - ONLY_SCALE_OUT: Restricts the autoscaler to add VM instances only. - ON: Enables all autoscaler activities according to its policy. For more information, see "Turning off or restricting an autoscaler" + * Defines the operating mode for this policy. + * The following modes are available: + * - OFF: Disables the autoscaler but maintains its + * configuration. + * - ONLY_SCALE_OUT: Restricts the autoscaler to add + * VM instances only. + * - ON: Enables all autoscaler activities according to its + * policy. + * For more information, see + * "Turning off or restricting an autoscaler" * Check the Mode enum for the list of possible values. * * Generated from protobuf field optional string mode = 3357091; @@ -377,7 +483,10 @@ public function setScaleInControl($var) } /** - * Scaling schedules defined for an autoscaler. Multiple schedules can be set on an autoscaler, and they can overlap. During overlapping periods the greatest min_required_replicas of all scaling schedules is applied. Up to 128 scaling schedules are allowed. + * Scaling schedules defined for an autoscaler. Multiple schedules + * can be set on an autoscaler, and they can overlap. During overlapping + * periods the greatest min_required_replicas of all scaling schedules is + * applied. Up to 128 scaling schedules are allowed. * * Generated from protobuf field map scaling_schedules = 355416580; * @return \Google\Protobuf\Internal\MapField @@ -388,7 +497,10 @@ public function getScalingSchedules() } /** - * Scaling schedules defined for an autoscaler. Multiple schedules can be set on an autoscaler, and they can overlap. During overlapping periods the greatest min_required_replicas of all scaling schedules is applied. Up to 128 scaling schedules are allowed. + * Scaling schedules defined for an autoscaler. Multiple schedules + * can be set on an autoscaler, and they can overlap. During overlapping + * periods the greatest min_required_replicas of all scaling schedules is + * applied. Up to 128 scaling schedules are allowed. * * Generated from protobuf field map scaling_schedules = 355416580; * @param array|\Google\Protobuf\Internal\MapField $var diff --git a/Compute/src/V1/AutoscalingPolicy/Mode.php b/Compute/src/V1/AutoscalingPolicy/Mode.php index 20303e01cc62..fb6f97a84774 100644 --- a/Compute/src/V1/AutoscalingPolicy/Mode.php +++ b/Compute/src/V1/AutoscalingPolicy/Mode.php @@ -7,7 +7,16 @@ use UnexpectedValueException; /** - * Defines the operating mode for this policy. The following modes are available: - OFF: Disables the autoscaler but maintains its configuration. - ONLY_SCALE_OUT: Restricts the autoscaler to add VM instances only. - ON: Enables all autoscaler activities according to its policy. For more information, see "Turning off or restricting an autoscaler" + * Defines the operating mode for this policy. + * The following modes are available: + * - OFF: Disables the autoscaler but maintains its + * configuration. + * - ONLY_SCALE_OUT: Restricts the autoscaler to add + * VM instances only. + * - ON: Enables all autoscaler activities according to its + * policy. + * For more information, see + * "Turning off or restricting an autoscaler" * * Protobuf type google.cloud.compute.v1.AutoscalingPolicy.Mode */ @@ -20,7 +29,9 @@ class Mode */ const UNDEFINED_MODE = 0; /** - * Do not automatically scale the MIG in or out. The recommended_size field contains the size of MIG that would be set if the actuation mode was enabled. + * Do not automatically scale the MIG in or out. + * The recommended_size field contains the size of MIG that would be set if + * the actuation mode was enabled. * * Generated from protobuf enum OFF = 78159; */ @@ -32,13 +43,15 @@ class Mode */ const ON = 2527; /** - * Automatically create VMs according to the policy, but do not scale the MIG in. + * Automatically create VMs according to the policy, but do not scale + * the MIG in. * * Generated from protobuf enum ONLY_SCALE_OUT = 152713670; */ const ONLY_SCALE_OUT = 152713670; /** - * Automatically create VMs according to the policy, but do not scale the MIG in. + * Automatically create VMs according to the policy, but do not scale + * the MIG in. * * Generated from protobuf enum ONLY_UP = 478095374; */ diff --git a/Compute/src/V1/AutoscalingPolicyCpuUtilization.php b/Compute/src/V1/AutoscalingPolicyCpuUtilization.php index 7cfd66c0e455..88288f11ade5 100644 --- a/Compute/src/V1/AutoscalingPolicyCpuUtilization.php +++ b/Compute/src/V1/AutoscalingPolicyCpuUtilization.php @@ -16,14 +16,29 @@ class AutoscalingPolicyCpuUtilization extends \Google\Protobuf\Internal\Message { /** - * Indicates whether predictive autoscaling based on CPU metric is enabled. Valid values are: * NONE (default). No predictive method is used. The autoscaler scales the group to meet current demand based on real-time metrics. * OPTIMIZE_AVAILABILITY. Predictive autoscaling improves availability by monitoring daily and weekly load patterns and scaling out ahead of anticipated demand. + * Indicates whether predictive autoscaling based on CPU metric is enabled. + * Valid values are: + * * NONE (default). No predictive method is used. The autoscaler scales the + * group to meet current demand based on real-time metrics. + * * OPTIMIZE_AVAILABILITY. Predictive autoscaling improves availability by + * monitoring daily and weekly load patterns and scaling out ahead of + * anticipated demand. * Check the PredictiveMethod enum for the list of possible values. * * Generated from protobuf field optional string predictive_method = 390220737; */ protected $predictive_method = null; /** - * The target CPU utilization that the autoscaler maintains. Must be a float value in the range (0, 1]. If not specified, the default is 0.6. If the CPU level is below the target utilization, the autoscaler scales in the number of instances until it reaches the minimum number of instances you specified or until the average CPU of your instances reaches the target utilization. If the average CPU is above the target utilization, the autoscaler scales out until it reaches the maximum number of instances you specified or until the average utilization reaches the target utilization. + * The target CPU utilization that the autoscaler maintains. Must be + * a float value in the range (0, 1]. If not specified, the default is0.6. + * If the CPU level is below the target utilization, the autoscaler scales + * in the number of instances until it reaches the minimum number of + * instances you specified or until the average CPU of your instances + * reaches the target utilization. + * If the average CPU is above the target utilization, the autoscaler + * scales out until it reaches the maximum number of instances you + * specified or until the average utilization reaches the target + * utilization. * * Generated from protobuf field optional double utilization_target = 215905870; */ @@ -36,10 +51,25 @@ class AutoscalingPolicyCpuUtilization extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $predictive_method - * Indicates whether predictive autoscaling based on CPU metric is enabled. Valid values are: * NONE (default). No predictive method is used. The autoscaler scales the group to meet current demand based on real-time metrics. * OPTIMIZE_AVAILABILITY. Predictive autoscaling improves availability by monitoring daily and weekly load patterns and scaling out ahead of anticipated demand. + * Indicates whether predictive autoscaling based on CPU metric is enabled. + * Valid values are: + * * NONE (default). No predictive method is used. The autoscaler scales the + * group to meet current demand based on real-time metrics. + * * OPTIMIZE_AVAILABILITY. Predictive autoscaling improves availability by + * monitoring daily and weekly load patterns and scaling out ahead of + * anticipated demand. * Check the PredictiveMethod enum for the list of possible values. * @type float $utilization_target - * The target CPU utilization that the autoscaler maintains. Must be a float value in the range (0, 1]. If not specified, the default is 0.6. If the CPU level is below the target utilization, the autoscaler scales in the number of instances until it reaches the minimum number of instances you specified or until the average CPU of your instances reaches the target utilization. If the average CPU is above the target utilization, the autoscaler scales out until it reaches the maximum number of instances you specified or until the average utilization reaches the target utilization. + * The target CPU utilization that the autoscaler maintains. Must be + * a float value in the range (0, 1]. If not specified, the default is0.6. + * If the CPU level is below the target utilization, the autoscaler scales + * in the number of instances until it reaches the minimum number of + * instances you specified or until the average CPU of your instances + * reaches the target utilization. + * If the average CPU is above the target utilization, the autoscaler + * scales out until it reaches the maximum number of instances you + * specified or until the average utilization reaches the target + * utilization. * } */ public function __construct($data = NULL) { @@ -48,7 +78,13 @@ public function __construct($data = NULL) { } /** - * Indicates whether predictive autoscaling based on CPU metric is enabled. Valid values are: * NONE (default). No predictive method is used. The autoscaler scales the group to meet current demand based on real-time metrics. * OPTIMIZE_AVAILABILITY. Predictive autoscaling improves availability by monitoring daily and weekly load patterns and scaling out ahead of anticipated demand. + * Indicates whether predictive autoscaling based on CPU metric is enabled. + * Valid values are: + * * NONE (default). No predictive method is used. The autoscaler scales the + * group to meet current demand based on real-time metrics. + * * OPTIMIZE_AVAILABILITY. Predictive autoscaling improves availability by + * monitoring daily and weekly load patterns and scaling out ahead of + * anticipated demand. * Check the PredictiveMethod enum for the list of possible values. * * Generated from protobuf field optional string predictive_method = 390220737; @@ -70,7 +106,13 @@ public function clearPredictiveMethod() } /** - * Indicates whether predictive autoscaling based on CPU metric is enabled. Valid values are: * NONE (default). No predictive method is used. The autoscaler scales the group to meet current demand based on real-time metrics. * OPTIMIZE_AVAILABILITY. Predictive autoscaling improves availability by monitoring daily and weekly load patterns and scaling out ahead of anticipated demand. + * Indicates whether predictive autoscaling based on CPU metric is enabled. + * Valid values are: + * * NONE (default). No predictive method is used. The autoscaler scales the + * group to meet current demand based on real-time metrics. + * * OPTIMIZE_AVAILABILITY. Predictive autoscaling improves availability by + * monitoring daily and weekly load patterns and scaling out ahead of + * anticipated demand. * Check the PredictiveMethod enum for the list of possible values. * * Generated from protobuf field optional string predictive_method = 390220737; @@ -86,7 +128,16 @@ public function setPredictiveMethod($var) } /** - * The target CPU utilization that the autoscaler maintains. Must be a float value in the range (0, 1]. If not specified, the default is 0.6. If the CPU level is below the target utilization, the autoscaler scales in the number of instances until it reaches the minimum number of instances you specified or until the average CPU of your instances reaches the target utilization. If the average CPU is above the target utilization, the autoscaler scales out until it reaches the maximum number of instances you specified or until the average utilization reaches the target utilization. + * The target CPU utilization that the autoscaler maintains. Must be + * a float value in the range (0, 1]. If not specified, the default is0.6. + * If the CPU level is below the target utilization, the autoscaler scales + * in the number of instances until it reaches the minimum number of + * instances you specified or until the average CPU of your instances + * reaches the target utilization. + * If the average CPU is above the target utilization, the autoscaler + * scales out until it reaches the maximum number of instances you + * specified or until the average utilization reaches the target + * utilization. * * Generated from protobuf field optional double utilization_target = 215905870; * @return float @@ -107,7 +158,16 @@ public function clearUtilizationTarget() } /** - * The target CPU utilization that the autoscaler maintains. Must be a float value in the range (0, 1]. If not specified, the default is 0.6. If the CPU level is below the target utilization, the autoscaler scales in the number of instances until it reaches the minimum number of instances you specified or until the average CPU of your instances reaches the target utilization. If the average CPU is above the target utilization, the autoscaler scales out until it reaches the maximum number of instances you specified or until the average utilization reaches the target utilization. + * The target CPU utilization that the autoscaler maintains. Must be + * a float value in the range (0, 1]. If not specified, the default is0.6. + * If the CPU level is below the target utilization, the autoscaler scales + * in the number of instances until it reaches the minimum number of + * instances you specified or until the average CPU of your instances + * reaches the target utilization. + * If the average CPU is above the target utilization, the autoscaler + * scales out until it reaches the maximum number of instances you + * specified or until the average utilization reaches the target + * utilization. * * Generated from protobuf field optional double utilization_target = 215905870; * @param float $var diff --git a/Compute/src/V1/AutoscalingPolicyCpuUtilization/PredictiveMethod.php b/Compute/src/V1/AutoscalingPolicyCpuUtilization/PredictiveMethod.php index 049c087a8266..a3d968fbe17b 100644 --- a/Compute/src/V1/AutoscalingPolicyCpuUtilization/PredictiveMethod.php +++ b/Compute/src/V1/AutoscalingPolicyCpuUtilization/PredictiveMethod.php @@ -7,7 +7,13 @@ use UnexpectedValueException; /** - * Indicates whether predictive autoscaling based on CPU metric is enabled. Valid values are: * NONE (default). No predictive method is used. The autoscaler scales the group to meet current demand based on real-time metrics. * OPTIMIZE_AVAILABILITY. Predictive autoscaling improves availability by monitoring daily and weekly load patterns and scaling out ahead of anticipated demand. + * Indicates whether predictive autoscaling based on CPU metric is enabled. + * Valid values are: + * * NONE (default). No predictive method is used. The autoscaler scales the + * group to meet current demand based on real-time metrics. + * * OPTIMIZE_AVAILABILITY. Predictive autoscaling improves availability by + * monitoring daily and weekly load patterns and scaling out ahead of + * anticipated demand. * * Protobuf type google.cloud.compute.v1.AutoscalingPolicyCpuUtilization.PredictiveMethod */ @@ -20,13 +26,15 @@ class PredictiveMethod */ const UNDEFINED_PREDICTIVE_METHOD = 0; /** - * No predictive method is used. The autoscaler scales the group to meet current demand based on real-time metrics + * No predictive method is used. The autoscaler scales the group to meet + * current demand based on real-time metrics * * Generated from protobuf enum NONE = 2402104; */ const NONE = 2402104; /** - * Predictive autoscaling improves availability by monitoring daily and weekly load patterns and scaling out ahead of anticipated demand. + * Predictive autoscaling improves availability by monitoring daily and + * weekly load patterns and scaling out ahead of anticipated demand. * * Generated from protobuf enum OPTIMIZE_AVAILABILITY = 11629437; */ diff --git a/Compute/src/V1/AutoscalingPolicyCustomMetricUtilization.php b/Compute/src/V1/AutoscalingPolicyCustomMetricUtilization.php index c9784d1dbe87..d5038be28061 100644 --- a/Compute/src/V1/AutoscalingPolicyCustomMetricUtilization.php +++ b/Compute/src/V1/AutoscalingPolicyCustomMetricUtilization.php @@ -16,31 +16,80 @@ class AutoscalingPolicyCustomMetricUtilization extends \Google\Protobuf\Internal\Message { /** - * A filter string, compatible with a Stackdriver Monitoring filter string for TimeSeries.list API call. This filter is used to select a specific TimeSeries for the purpose of autoscaling and to determine whether the metric is exporting per-instance or per-group data. For the filter to be valid for autoscaling purposes, the following rules apply: - You can only use the AND operator for joining selectors. - You can only use direct equality comparison operator (=) without any functions for each selector. - You can specify the metric in both the filter string and in the metric field. However, if specified in both places, the metric must be identical. - The monitored resource type determines what kind of values are expected for the metric. If it is a gce_instance, the autoscaler expects the metric to include a separate TimeSeries for each instance in a group. In such a case, you cannot filter on resource labels. If the resource type is any other value, the autoscaler expects this metric to contain values that apply to the entire autoscaled instance group and resource label filtering can be performed to point autoscaler at the correct TimeSeries to scale upon. This is called a *per-group metric* for the purpose of autoscaling. If not specified, the type defaults to gce_instance. Try to provide a filter that is selective enough to pick just one TimeSeries for the autoscaled group or for each of the instances (if you are using gce_instance resource type). If multiple TimeSeries are returned upon the query execution, the autoscaler will sum their respective values to obtain its scaling value. + * A filter string, compatible with a Stackdriver Monitoringfilter string forTimeSeries.list API call. This filter is + * used to select a specific TimeSeries for the purpose of autoscaling and + * to determine whether the metric is exporting per-instance or + * per-group data. + * For the filter to be valid for autoscaling purposes, the following rules + * apply: + * - You can only use the AND operator for joining + * selectors. + * - You can only use direct equality comparison operator + * (=) without any functions for each selector. + * - You can specify the metric in both the filter string and in the + * metric field. However, if specified in both places, the metric must + * be identical. + * - The monitored resource type + * determines what kind of values are expected for the metric. If it is + * a gce_instance, the autoscaler expects the metric to + * include a separate TimeSeries for each instance in a group. In such a + * case, you cannot filter on resource labels. + * If the resource type is any other value, the autoscaler expects + * this metric to contain values that apply to the entire autoscaled + * instance group and resource label filtering can be performed to + * point autoscaler at the correct TimeSeries to scale upon. This is + * called a *per-group metric* for the purpose of autoscaling. + * If not specified, the type defaults to + * gce_instance. + * Try to provide a filter that is selective enough to pick just one + * TimeSeries for the autoscaled group or for each of the instances (if you + * are using gce_instance resource type). If multiple + * TimeSeries are returned upon the query execution, the autoscaler will sum + * their respective values to obtain its scaling value. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The identifier (type) of the Stackdriver Monitoring metric. The metric cannot have negative values. The metric must have a value type of INT64 or DOUBLE. + * The identifier (type) of the Stackdriver Monitoring metric. The metric + * cannot have negative values. + * The metric must have a value type of INT64 orDOUBLE. * * Generated from protobuf field optional string metric = 533067184; */ protected $metric = null; /** - * If scaling is based on a per-group metric value that represents the total amount of work to be done or resource usage, set this value to an amount assigned for a single instance of the scaled group. Autoscaler keeps the number of instances proportional to the value of this metric. The metric itself does not change value due to group resizing. A good metric to use with the target is for example pubsub.googleapis.com/subscription/num_undelivered_messages or a custom metric exporting the total number of requests coming to your instances. A bad example would be a metric exporting an average or median latency, since this value can't include a chunk assignable to a single instance, it could be better used with utilization_target instead. + * If scaling is based on a per-group metric value that represents the + * total amount of work to be done or resource usage, set this value to an + * amount assigned for a single instance of the scaled group. Autoscaler + * keeps the number of instances proportional to the value of this + * metric. The metric itself does not change value due to group + * resizing. + * A good metric to use with the target is for examplepubsub.googleapis.com/subscription/num_undelivered_messages + * or a custom metric exporting the total number of requests coming to + * your instances. + * A bad example would be a metric exporting an average or median latency, + * since this value can't include a chunk assignable to a single instance, + * it could be better used with utilization_target instead. * * Generated from protobuf field optional double single_instance_assignment = 504768064; */ protected $single_instance_assignment = null; /** - * The target value of the metric that autoscaler maintains. This must be a positive value. A utilization metric scales number of virtual machines handling requests to increase or decrease proportionally to the metric. For example, a good metric to use as a utilization_target is https://www.googleapis.com/compute/v1/instance/network/received_bytes_count. The autoscaler works to keep this value constant for each of the instances. + * The target value of the metric that autoscaler maintains. This + * must be a positive value. A utilization metric scales number of + * virtual machines handling requests to increase or decrease + * proportionally to the metric. + * For example, a good metric to use as a utilization_target ishttps://www.googleapis.com/compute/v1/instance/network/received_bytes_count. + * The autoscaler works to keep this value constant for each of the + * instances. * * Generated from protobuf field optional double utilization_target = 215905870; */ protected $utilization_target = null; /** - * Defines how target utilization value is expressed for a Stackdriver Monitoring metric. Either GAUGE, DELTA_PER_SECOND, or DELTA_PER_MINUTE. + * Defines how target utilization value is expressed for a Stackdriver + * Monitoring metric. Either GAUGE,DELTA_PER_SECOND, or DELTA_PER_MINUTE. * Check the UtilizationTargetType enum for the list of possible values. * * Generated from protobuf field optional string utilization_target_type = 340169355; @@ -54,15 +103,64 @@ class AutoscalingPolicyCustomMetricUtilization extends \Google\Protobuf\Internal * Optional. Data for populating the Message object. * * @type string $filter - * A filter string, compatible with a Stackdriver Monitoring filter string for TimeSeries.list API call. This filter is used to select a specific TimeSeries for the purpose of autoscaling and to determine whether the metric is exporting per-instance or per-group data. For the filter to be valid for autoscaling purposes, the following rules apply: - You can only use the AND operator for joining selectors. - You can only use direct equality comparison operator (=) without any functions for each selector. - You can specify the metric in both the filter string and in the metric field. However, if specified in both places, the metric must be identical. - The monitored resource type determines what kind of values are expected for the metric. If it is a gce_instance, the autoscaler expects the metric to include a separate TimeSeries for each instance in a group. In such a case, you cannot filter on resource labels. If the resource type is any other value, the autoscaler expects this metric to contain values that apply to the entire autoscaled instance group and resource label filtering can be performed to point autoscaler at the correct TimeSeries to scale upon. This is called a *per-group metric* for the purpose of autoscaling. If not specified, the type defaults to gce_instance. Try to provide a filter that is selective enough to pick just one TimeSeries for the autoscaled group or for each of the instances (if you are using gce_instance resource type). If multiple TimeSeries are returned upon the query execution, the autoscaler will sum their respective values to obtain its scaling value. + * A filter string, compatible with a Stackdriver Monitoringfilter string forTimeSeries.list API call. This filter is + * used to select a specific TimeSeries for the purpose of autoscaling and + * to determine whether the metric is exporting per-instance or + * per-group data. + * For the filter to be valid for autoscaling purposes, the following rules + * apply: + * - You can only use the AND operator for joining + * selectors. + * - You can only use direct equality comparison operator + * (=) without any functions for each selector. + * - You can specify the metric in both the filter string and in the + * metric field. However, if specified in both places, the metric must + * be identical. + * - The monitored resource type + * determines what kind of values are expected for the metric. If it is + * a gce_instance, the autoscaler expects the metric to + * include a separate TimeSeries for each instance in a group. In such a + * case, you cannot filter on resource labels. + * If the resource type is any other value, the autoscaler expects + * this metric to contain values that apply to the entire autoscaled + * instance group and resource label filtering can be performed to + * point autoscaler at the correct TimeSeries to scale upon. This is + * called a *per-group metric* for the purpose of autoscaling. + * If not specified, the type defaults to + * gce_instance. + * Try to provide a filter that is selective enough to pick just one + * TimeSeries for the autoscaled group or for each of the instances (if you + * are using gce_instance resource type). If multiple + * TimeSeries are returned upon the query execution, the autoscaler will sum + * their respective values to obtain its scaling value. * @type string $metric - * The identifier (type) of the Stackdriver Monitoring metric. The metric cannot have negative values. The metric must have a value type of INT64 or DOUBLE. + * The identifier (type) of the Stackdriver Monitoring metric. The metric + * cannot have negative values. + * The metric must have a value type of INT64 orDOUBLE. * @type float $single_instance_assignment - * If scaling is based on a per-group metric value that represents the total amount of work to be done or resource usage, set this value to an amount assigned for a single instance of the scaled group. Autoscaler keeps the number of instances proportional to the value of this metric. The metric itself does not change value due to group resizing. A good metric to use with the target is for example pubsub.googleapis.com/subscription/num_undelivered_messages or a custom metric exporting the total number of requests coming to your instances. A bad example would be a metric exporting an average or median latency, since this value can't include a chunk assignable to a single instance, it could be better used with utilization_target instead. + * If scaling is based on a per-group metric value that represents the + * total amount of work to be done or resource usage, set this value to an + * amount assigned for a single instance of the scaled group. Autoscaler + * keeps the number of instances proportional to the value of this + * metric. The metric itself does not change value due to group + * resizing. + * A good metric to use with the target is for examplepubsub.googleapis.com/subscription/num_undelivered_messages + * or a custom metric exporting the total number of requests coming to + * your instances. + * A bad example would be a metric exporting an average or median latency, + * since this value can't include a chunk assignable to a single instance, + * it could be better used with utilization_target instead. * @type float $utilization_target - * The target value of the metric that autoscaler maintains. This must be a positive value. A utilization metric scales number of virtual machines handling requests to increase or decrease proportionally to the metric. For example, a good metric to use as a utilization_target is https://www.googleapis.com/compute/v1/instance/network/received_bytes_count. The autoscaler works to keep this value constant for each of the instances. + * The target value of the metric that autoscaler maintains. This + * must be a positive value. A utilization metric scales number of + * virtual machines handling requests to increase or decrease + * proportionally to the metric. + * For example, a good metric to use as a utilization_target ishttps://www.googleapis.com/compute/v1/instance/network/received_bytes_count. + * The autoscaler works to keep this value constant for each of the + * instances. * @type string $utilization_target_type - * Defines how target utilization value is expressed for a Stackdriver Monitoring metric. Either GAUGE, DELTA_PER_SECOND, or DELTA_PER_MINUTE. + * Defines how target utilization value is expressed for a Stackdriver + * Monitoring metric. Either GAUGE,DELTA_PER_SECOND, or DELTA_PER_MINUTE. * Check the UtilizationTargetType enum for the list of possible values. * } */ @@ -72,7 +170,36 @@ public function __construct($data = NULL) { } /** - * A filter string, compatible with a Stackdriver Monitoring filter string for TimeSeries.list API call. This filter is used to select a specific TimeSeries for the purpose of autoscaling and to determine whether the metric is exporting per-instance or per-group data. For the filter to be valid for autoscaling purposes, the following rules apply: - You can only use the AND operator for joining selectors. - You can only use direct equality comparison operator (=) without any functions for each selector. - You can specify the metric in both the filter string and in the metric field. However, if specified in both places, the metric must be identical. - The monitored resource type determines what kind of values are expected for the metric. If it is a gce_instance, the autoscaler expects the metric to include a separate TimeSeries for each instance in a group. In such a case, you cannot filter on resource labels. If the resource type is any other value, the autoscaler expects this metric to contain values that apply to the entire autoscaled instance group and resource label filtering can be performed to point autoscaler at the correct TimeSeries to scale upon. This is called a *per-group metric* for the purpose of autoscaling. If not specified, the type defaults to gce_instance. Try to provide a filter that is selective enough to pick just one TimeSeries for the autoscaled group or for each of the instances (if you are using gce_instance resource type). If multiple TimeSeries are returned upon the query execution, the autoscaler will sum their respective values to obtain its scaling value. + * A filter string, compatible with a Stackdriver Monitoringfilter string forTimeSeries.list API call. This filter is + * used to select a specific TimeSeries for the purpose of autoscaling and + * to determine whether the metric is exporting per-instance or + * per-group data. + * For the filter to be valid for autoscaling purposes, the following rules + * apply: + * - You can only use the AND operator for joining + * selectors. + * - You can only use direct equality comparison operator + * (=) without any functions for each selector. + * - You can specify the metric in both the filter string and in the + * metric field. However, if specified in both places, the metric must + * be identical. + * - The monitored resource type + * determines what kind of values are expected for the metric. If it is + * a gce_instance, the autoscaler expects the metric to + * include a separate TimeSeries for each instance in a group. In such a + * case, you cannot filter on resource labels. + * If the resource type is any other value, the autoscaler expects + * this metric to contain values that apply to the entire autoscaled + * instance group and resource label filtering can be performed to + * point autoscaler at the correct TimeSeries to scale upon. This is + * called a *per-group metric* for the purpose of autoscaling. + * If not specified, the type defaults to + * gce_instance. + * Try to provide a filter that is selective enough to pick just one + * TimeSeries for the autoscaled group or for each of the instances (if you + * are using gce_instance resource type). If multiple + * TimeSeries are returned upon the query execution, the autoscaler will sum + * their respective values to obtain its scaling value. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -93,7 +220,36 @@ public function clearFilter() } /** - * A filter string, compatible with a Stackdriver Monitoring filter string for TimeSeries.list API call. This filter is used to select a specific TimeSeries for the purpose of autoscaling and to determine whether the metric is exporting per-instance or per-group data. For the filter to be valid for autoscaling purposes, the following rules apply: - You can only use the AND operator for joining selectors. - You can only use direct equality comparison operator (=) without any functions for each selector. - You can specify the metric in both the filter string and in the metric field. However, if specified in both places, the metric must be identical. - The monitored resource type determines what kind of values are expected for the metric. If it is a gce_instance, the autoscaler expects the metric to include a separate TimeSeries for each instance in a group. In such a case, you cannot filter on resource labels. If the resource type is any other value, the autoscaler expects this metric to contain values that apply to the entire autoscaled instance group and resource label filtering can be performed to point autoscaler at the correct TimeSeries to scale upon. This is called a *per-group metric* for the purpose of autoscaling. If not specified, the type defaults to gce_instance. Try to provide a filter that is selective enough to pick just one TimeSeries for the autoscaled group or for each of the instances (if you are using gce_instance resource type). If multiple TimeSeries are returned upon the query execution, the autoscaler will sum their respective values to obtain its scaling value. + * A filter string, compatible with a Stackdriver Monitoringfilter string forTimeSeries.list API call. This filter is + * used to select a specific TimeSeries for the purpose of autoscaling and + * to determine whether the metric is exporting per-instance or + * per-group data. + * For the filter to be valid for autoscaling purposes, the following rules + * apply: + * - You can only use the AND operator for joining + * selectors. + * - You can only use direct equality comparison operator + * (=) without any functions for each selector. + * - You can specify the metric in both the filter string and in the + * metric field. However, if specified in both places, the metric must + * be identical. + * - The monitored resource type + * determines what kind of values are expected for the metric. If it is + * a gce_instance, the autoscaler expects the metric to + * include a separate TimeSeries for each instance in a group. In such a + * case, you cannot filter on resource labels. + * If the resource type is any other value, the autoscaler expects + * this metric to contain values that apply to the entire autoscaled + * instance group and resource label filtering can be performed to + * point autoscaler at the correct TimeSeries to scale upon. This is + * called a *per-group metric* for the purpose of autoscaling. + * If not specified, the type defaults to + * gce_instance. + * Try to provide a filter that is selective enough to pick just one + * TimeSeries for the autoscaled group or for each of the instances (if you + * are using gce_instance resource type). If multiple + * TimeSeries are returned upon the query execution, the autoscaler will sum + * their respective values to obtain its scaling value. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -108,7 +264,9 @@ public function setFilter($var) } /** - * The identifier (type) of the Stackdriver Monitoring metric. The metric cannot have negative values. The metric must have a value type of INT64 or DOUBLE. + * The identifier (type) of the Stackdriver Monitoring metric. The metric + * cannot have negative values. + * The metric must have a value type of INT64 orDOUBLE. * * Generated from protobuf field optional string metric = 533067184; * @return string @@ -129,7 +287,9 @@ public function clearMetric() } /** - * The identifier (type) of the Stackdriver Monitoring metric. The metric cannot have negative values. The metric must have a value type of INT64 or DOUBLE. + * The identifier (type) of the Stackdriver Monitoring metric. The metric + * cannot have negative values. + * The metric must have a value type of INT64 orDOUBLE. * * Generated from protobuf field optional string metric = 533067184; * @param string $var @@ -144,7 +304,18 @@ public function setMetric($var) } /** - * If scaling is based on a per-group metric value that represents the total amount of work to be done or resource usage, set this value to an amount assigned for a single instance of the scaled group. Autoscaler keeps the number of instances proportional to the value of this metric. The metric itself does not change value due to group resizing. A good metric to use with the target is for example pubsub.googleapis.com/subscription/num_undelivered_messages or a custom metric exporting the total number of requests coming to your instances. A bad example would be a metric exporting an average or median latency, since this value can't include a chunk assignable to a single instance, it could be better used with utilization_target instead. + * If scaling is based on a per-group metric value that represents the + * total amount of work to be done or resource usage, set this value to an + * amount assigned for a single instance of the scaled group. Autoscaler + * keeps the number of instances proportional to the value of this + * metric. The metric itself does not change value due to group + * resizing. + * A good metric to use with the target is for examplepubsub.googleapis.com/subscription/num_undelivered_messages + * or a custom metric exporting the total number of requests coming to + * your instances. + * A bad example would be a metric exporting an average or median latency, + * since this value can't include a chunk assignable to a single instance, + * it could be better used with utilization_target instead. * * Generated from protobuf field optional double single_instance_assignment = 504768064; * @return float @@ -165,7 +336,18 @@ public function clearSingleInstanceAssignment() } /** - * If scaling is based on a per-group metric value that represents the total amount of work to be done or resource usage, set this value to an amount assigned for a single instance of the scaled group. Autoscaler keeps the number of instances proportional to the value of this metric. The metric itself does not change value due to group resizing. A good metric to use with the target is for example pubsub.googleapis.com/subscription/num_undelivered_messages or a custom metric exporting the total number of requests coming to your instances. A bad example would be a metric exporting an average or median latency, since this value can't include a chunk assignable to a single instance, it could be better used with utilization_target instead. + * If scaling is based on a per-group metric value that represents the + * total amount of work to be done or resource usage, set this value to an + * amount assigned for a single instance of the scaled group. Autoscaler + * keeps the number of instances proportional to the value of this + * metric. The metric itself does not change value due to group + * resizing. + * A good metric to use with the target is for examplepubsub.googleapis.com/subscription/num_undelivered_messages + * or a custom metric exporting the total number of requests coming to + * your instances. + * A bad example would be a metric exporting an average or median latency, + * since this value can't include a chunk assignable to a single instance, + * it could be better used with utilization_target instead. * * Generated from protobuf field optional double single_instance_assignment = 504768064; * @param float $var @@ -180,7 +362,13 @@ public function setSingleInstanceAssignment($var) } /** - * The target value of the metric that autoscaler maintains. This must be a positive value. A utilization metric scales number of virtual machines handling requests to increase or decrease proportionally to the metric. For example, a good metric to use as a utilization_target is https://www.googleapis.com/compute/v1/instance/network/received_bytes_count. The autoscaler works to keep this value constant for each of the instances. + * The target value of the metric that autoscaler maintains. This + * must be a positive value. A utilization metric scales number of + * virtual machines handling requests to increase or decrease + * proportionally to the metric. + * For example, a good metric to use as a utilization_target ishttps://www.googleapis.com/compute/v1/instance/network/received_bytes_count. + * The autoscaler works to keep this value constant for each of the + * instances. * * Generated from protobuf field optional double utilization_target = 215905870; * @return float @@ -201,7 +389,13 @@ public function clearUtilizationTarget() } /** - * The target value of the metric that autoscaler maintains. This must be a positive value. A utilization metric scales number of virtual machines handling requests to increase or decrease proportionally to the metric. For example, a good metric to use as a utilization_target is https://www.googleapis.com/compute/v1/instance/network/received_bytes_count. The autoscaler works to keep this value constant for each of the instances. + * The target value of the metric that autoscaler maintains. This + * must be a positive value. A utilization metric scales number of + * virtual machines handling requests to increase or decrease + * proportionally to the metric. + * For example, a good metric to use as a utilization_target ishttps://www.googleapis.com/compute/v1/instance/network/received_bytes_count. + * The autoscaler works to keep this value constant for each of the + * instances. * * Generated from protobuf field optional double utilization_target = 215905870; * @param float $var @@ -216,7 +410,8 @@ public function setUtilizationTarget($var) } /** - * Defines how target utilization value is expressed for a Stackdriver Monitoring metric. Either GAUGE, DELTA_PER_SECOND, or DELTA_PER_MINUTE. + * Defines how target utilization value is expressed for a Stackdriver + * Monitoring metric. Either GAUGE,DELTA_PER_SECOND, or DELTA_PER_MINUTE. * Check the UtilizationTargetType enum for the list of possible values. * * Generated from protobuf field optional string utilization_target_type = 340169355; @@ -238,7 +433,8 @@ public function clearUtilizationTargetType() } /** - * Defines how target utilization value is expressed for a Stackdriver Monitoring metric. Either GAUGE, DELTA_PER_SECOND, or DELTA_PER_MINUTE. + * Defines how target utilization value is expressed for a Stackdriver + * Monitoring metric. Either GAUGE,DELTA_PER_SECOND, or DELTA_PER_MINUTE. * Check the UtilizationTargetType enum for the list of possible values. * * Generated from protobuf field optional string utilization_target_type = 340169355; diff --git a/Compute/src/V1/AutoscalingPolicyCustomMetricUtilization/UtilizationTargetType.php b/Compute/src/V1/AutoscalingPolicyCustomMetricUtilization/UtilizationTargetType.php index c6f8fe986695..7f08e18e543e 100644 --- a/Compute/src/V1/AutoscalingPolicyCustomMetricUtilization/UtilizationTargetType.php +++ b/Compute/src/V1/AutoscalingPolicyCustomMetricUtilization/UtilizationTargetType.php @@ -7,7 +7,8 @@ use UnexpectedValueException; /** - * Defines how target utilization value is expressed for a Stackdriver Monitoring metric. Either GAUGE, DELTA_PER_SECOND, or DELTA_PER_MINUTE. + * Defines how target utilization value is expressed for a Stackdriver + * Monitoring metric. Either GAUGE,DELTA_PER_SECOND, or DELTA_PER_MINUTE. * * Protobuf type google.cloud.compute.v1.AutoscalingPolicyCustomMetricUtilization.UtilizationTargetType */ @@ -20,19 +21,24 @@ class UtilizationTargetType */ const UNDEFINED_UTILIZATION_TARGET_TYPE = 0; /** - * Sets the utilization target value for a cumulative or delta metric, expressed as the rate of growth per minute. + * Sets the utilization target value for a cumulative or delta metric, + * expressed as the rate of growth per minute. * * Generated from protobuf enum DELTA_PER_MINUTE = 87432861; */ const DELTA_PER_MINUTE = 87432861; /** - * Sets the utilization target value for a cumulative or delta metric, expressed as the rate of growth per second. + * Sets the utilization target value for a cumulative or delta metric, + * expressed as the rate of growth per second. * * Generated from protobuf enum DELTA_PER_SECOND = 255180029; */ const DELTA_PER_SECOND = 255180029; /** - * Sets the utilization target value for a gauge metric. The autoscaler will collect the average utilization of the virtual machines from the last couple of minutes, and compare the value to the utilization target value to perform autoscaling. + * Sets the utilization target value for a gauge metric. The autoscaler + * will collect the average utilization of the virtual machines from the + * last couple of minutes, and compare the value to the utilization + * target value to perform autoscaling. * * Generated from protobuf enum GAUGE = 67590361; */ diff --git a/Compute/src/V1/AutoscalingPolicyLoadBalancingUtilization.php b/Compute/src/V1/AutoscalingPolicyLoadBalancingUtilization.php index 392eaf66b682..8efdca1ed414 100644 --- a/Compute/src/V1/AutoscalingPolicyLoadBalancingUtilization.php +++ b/Compute/src/V1/AutoscalingPolicyLoadBalancingUtilization.php @@ -16,7 +16,9 @@ class AutoscalingPolicyLoadBalancingUtilization extends \Google\Protobuf\Internal\Message { /** - * Fraction of backend capacity utilization (set in HTTP(S) load balancing configuration) that the autoscaler maintains. Must be a positive float value. If not defined, the default is 0.8. + * Fraction of backend capacity utilization (set in HTTP(S) load balancing + * configuration) that the autoscaler maintains. Must be a positive float + * value. If not defined, the default is 0.8. * * Generated from protobuf field optional double utilization_target = 215905870; */ @@ -29,7 +31,9 @@ class AutoscalingPolicyLoadBalancingUtilization extends \Google\Protobuf\Interna * Optional. Data for populating the Message object. * * @type float $utilization_target - * Fraction of backend capacity utilization (set in HTTP(S) load balancing configuration) that the autoscaler maintains. Must be a positive float value. If not defined, the default is 0.8. + * Fraction of backend capacity utilization (set in HTTP(S) load balancing + * configuration) that the autoscaler maintains. Must be a positive float + * value. If not defined, the default is 0.8. * } */ public function __construct($data = NULL) { @@ -38,7 +42,9 @@ public function __construct($data = NULL) { } /** - * Fraction of backend capacity utilization (set in HTTP(S) load balancing configuration) that the autoscaler maintains. Must be a positive float value. If not defined, the default is 0.8. + * Fraction of backend capacity utilization (set in HTTP(S) load balancing + * configuration) that the autoscaler maintains. Must be a positive float + * value. If not defined, the default is 0.8. * * Generated from protobuf field optional double utilization_target = 215905870; * @return float @@ -59,7 +65,9 @@ public function clearUtilizationTarget() } /** - * Fraction of backend capacity utilization (set in HTTP(S) load balancing configuration) that the autoscaler maintains. Must be a positive float value. If not defined, the default is 0.8. + * Fraction of backend capacity utilization (set in HTTP(S) load balancing + * configuration) that the autoscaler maintains. Must be a positive float + * value. If not defined, the default is 0.8. * * Generated from protobuf field optional double utilization_target = 215905870; * @param float $var diff --git a/Compute/src/V1/AutoscalingPolicyScaleInControl.php b/Compute/src/V1/AutoscalingPolicyScaleInControl.php index 7eaad9298951..5eb063b9a7f3 100644 --- a/Compute/src/V1/AutoscalingPolicyScaleInControl.php +++ b/Compute/src/V1/AutoscalingPolicyScaleInControl.php @@ -9,20 +9,26 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Configuration that allows for slower scale in so that even if Autoscaler recommends an abrupt scale in of a MIG, it will be throttled as specified by the parameters below. + * Configuration that allows for slower scale in so that even if Autoscaler + * recommends an abrupt scale in of a MIG, it will be throttled as specified + * by the parameters below. * * Generated from protobuf message google.cloud.compute.v1.AutoscalingPolicyScaleInControl */ class AutoscalingPolicyScaleInControl extends \Google\Protobuf\Internal\Message { /** - * Maximum allowed number (or %) of VMs that can be deducted from the peak recommendation during the window autoscaler looks at when computing recommendations. Possibly all these VMs can be deleted at once so user service needs to be prepared to lose that many VMs in one step. + * Maximum allowed number (or %) of VMs that can be deducted from the peak + * recommendation during the window autoscaler looks at when computing + * recommendations. Possibly all these VMs can be deleted at once so user + * service needs to be prepared to lose that many VMs in one step. * * Generated from protobuf field optional .google.cloud.compute.v1.FixedOrPercent max_scaled_in_replicas = 180710123; */ protected $max_scaled_in_replicas = null; /** - * How far back autoscaling looks when computing recommendations to include directives regarding slower scale in, as described above. + * How far back autoscaling looks when computing recommendations to + * include directives regarding slower scale in, as described above. * * Generated from protobuf field optional int32 time_window_sec = 36405300; */ @@ -35,9 +41,13 @@ class AutoscalingPolicyScaleInControl extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type \Google\Cloud\Compute\V1\FixedOrPercent $max_scaled_in_replicas - * Maximum allowed number (or %) of VMs that can be deducted from the peak recommendation during the window autoscaler looks at when computing recommendations. Possibly all these VMs can be deleted at once so user service needs to be prepared to lose that many VMs in one step. + * Maximum allowed number (or %) of VMs that can be deducted from the peak + * recommendation during the window autoscaler looks at when computing + * recommendations. Possibly all these VMs can be deleted at once so user + * service needs to be prepared to lose that many VMs in one step. * @type int $time_window_sec - * How far back autoscaling looks when computing recommendations to include directives regarding slower scale in, as described above. + * How far back autoscaling looks when computing recommendations to + * include directives regarding slower scale in, as described above. * } */ public function __construct($data = NULL) { @@ -46,7 +56,10 @@ public function __construct($data = NULL) { } /** - * Maximum allowed number (or %) of VMs that can be deducted from the peak recommendation during the window autoscaler looks at when computing recommendations. Possibly all these VMs can be deleted at once so user service needs to be prepared to lose that many VMs in one step. + * Maximum allowed number (or %) of VMs that can be deducted from the peak + * recommendation during the window autoscaler looks at when computing + * recommendations. Possibly all these VMs can be deleted at once so user + * service needs to be prepared to lose that many VMs in one step. * * Generated from protobuf field optional .google.cloud.compute.v1.FixedOrPercent max_scaled_in_replicas = 180710123; * @return \Google\Cloud\Compute\V1\FixedOrPercent|null @@ -67,7 +80,10 @@ public function clearMaxScaledInReplicas() } /** - * Maximum allowed number (or %) of VMs that can be deducted from the peak recommendation during the window autoscaler looks at when computing recommendations. Possibly all these VMs can be deleted at once so user service needs to be prepared to lose that many VMs in one step. + * Maximum allowed number (or %) of VMs that can be deducted from the peak + * recommendation during the window autoscaler looks at when computing + * recommendations. Possibly all these VMs can be deleted at once so user + * service needs to be prepared to lose that many VMs in one step. * * Generated from protobuf field optional .google.cloud.compute.v1.FixedOrPercent max_scaled_in_replicas = 180710123; * @param \Google\Cloud\Compute\V1\FixedOrPercent $var @@ -82,7 +98,8 @@ public function setMaxScaledInReplicas($var) } /** - * How far back autoscaling looks when computing recommendations to include directives regarding slower scale in, as described above. + * How far back autoscaling looks when computing recommendations to + * include directives regarding slower scale in, as described above. * * Generated from protobuf field optional int32 time_window_sec = 36405300; * @return int @@ -103,7 +120,8 @@ public function clearTimeWindowSec() } /** - * How far back autoscaling looks when computing recommendations to include directives regarding slower scale in, as described above. + * How far back autoscaling looks when computing recommendations to + * include directives regarding slower scale in, as described above. * * Generated from protobuf field optional int32 time_window_sec = 36405300; * @param int $var diff --git a/Compute/src/V1/AutoscalingPolicyScalingSchedule.php b/Compute/src/V1/AutoscalingPolicyScalingSchedule.php index 048b63f5ab8c..84faef7a5a92 100644 --- a/Compute/src/V1/AutoscalingPolicyScalingSchedule.php +++ b/Compute/src/V1/AutoscalingPolicyScalingSchedule.php @@ -9,7 +9,9 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Scaling based on user-defined schedule. The message describes a single scaling schedule. A scaling schedule changes the minimum number of VM instances an autoscaler can recommend, which can trigger scaling out. + * Scaling based on user-defined schedule. The message describes a single + * scaling schedule. A scaling schedule changes the minimum number of VM + * instances an autoscaler can recommend, which can trigger scaling out. * * Generated from protobuf message google.cloud.compute.v1.AutoscalingPolicyScalingSchedule */ @@ -22,31 +24,47 @@ class AutoscalingPolicyScalingSchedule extends \Google\Protobuf\Internal\Message */ protected $description = null; /** - * A boolean value that specifies whether a scaling schedule can influence autoscaler recommendations. If set to true, then a scaling schedule has no effect. This field is optional, and its value is false by default. + * A boolean value that specifies whether a scaling schedule can influence + * autoscaler recommendations. If set to true, then a scaling schedule has + * no effect. This field is optional, and its value is false by default. * * Generated from protobuf field optional bool disabled = 270940796; */ protected $disabled = null; /** - * The duration of time intervals, in seconds, for which this scaling schedule is to run. The minimum allowed value is 300. This field is required. + * The duration of time intervals, in seconds, for which this + * scaling schedule is to run. The minimum allowed value is 300. + * This field is required. * * Generated from protobuf field optional int32 duration_sec = 212356902; */ protected $duration_sec = null; /** - * The minimum number of VM instances that the autoscaler will recommend in time intervals starting according to schedule. This field is required. + * The minimum number of VM instances that the autoscaler will + * recommend in time intervals starting according to schedule. This field is + * required. * * Generated from protobuf field optional int32 min_required_replicas = 365514414; */ protected $min_required_replicas = null; /** - * The start timestamps of time intervals when this scaling schedule is to provide a scaling signal. This field uses the extended cron format (with an optional year field). The expression can describe a single timestamp if the optional year is set, in which case the scaling schedule runs once. The schedule is interpreted with respect to time_zone. This field is required. Note: These timestamps only describe when autoscaler starts providing the scaling signal. The VMs need additional time to become serving. + * The start timestamps of time intervals when this scaling + * schedule is to provide a scaling signal. This field uses the extended + * cron format (with an optional year field). The expression can describe a + * single timestamp if the optional year is set, in which case the scaling + * schedule runs once. The schedule is interpreted with respect to + * time_zone. This field is required. Note: These timestamps only describe + * when autoscaler starts providing the scaling signal. The VMs + * need additional time to become serving. * * Generated from protobuf field optional string schedule = 375820951; */ protected $schedule = null; /** - * The time zone to use when interpreting the schedule. The value of this field must be a time zone name from the tz database: https://en.wikipedia.org/wiki/Tz_database. This field is assigned a default value of "UTC" if left empty. + * The time zone to use when interpreting the schedule. + * The value of this field must be a time zone name from the tz database: + * https://en.wikipedia.org/wiki/Tz_database. This field is assigned a + * default value of "UTC" if left empty. * * Generated from protobuf field optional string time_zone = 36848094; */ @@ -61,15 +79,31 @@ class AutoscalingPolicyScalingSchedule extends \Google\Protobuf\Internal\Message * @type string $description * A description of a scaling schedule. * @type bool $disabled - * A boolean value that specifies whether a scaling schedule can influence autoscaler recommendations. If set to true, then a scaling schedule has no effect. This field is optional, and its value is false by default. + * A boolean value that specifies whether a scaling schedule can influence + * autoscaler recommendations. If set to true, then a scaling schedule has + * no effect. This field is optional, and its value is false by default. * @type int $duration_sec - * The duration of time intervals, in seconds, for which this scaling schedule is to run. The minimum allowed value is 300. This field is required. + * The duration of time intervals, in seconds, for which this + * scaling schedule is to run. The minimum allowed value is 300. + * This field is required. * @type int $min_required_replicas - * The minimum number of VM instances that the autoscaler will recommend in time intervals starting according to schedule. This field is required. + * The minimum number of VM instances that the autoscaler will + * recommend in time intervals starting according to schedule. This field is + * required. * @type string $schedule - * The start timestamps of time intervals when this scaling schedule is to provide a scaling signal. This field uses the extended cron format (with an optional year field). The expression can describe a single timestamp if the optional year is set, in which case the scaling schedule runs once. The schedule is interpreted with respect to time_zone. This field is required. Note: These timestamps only describe when autoscaler starts providing the scaling signal. The VMs need additional time to become serving. + * The start timestamps of time intervals when this scaling + * schedule is to provide a scaling signal. This field uses the extended + * cron format (with an optional year field). The expression can describe a + * single timestamp if the optional year is set, in which case the scaling + * schedule runs once. The schedule is interpreted with respect to + * time_zone. This field is required. Note: These timestamps only describe + * when autoscaler starts providing the scaling signal. The VMs + * need additional time to become serving. * @type string $time_zone - * The time zone to use when interpreting the schedule. The value of this field must be a time zone name from the tz database: https://en.wikipedia.org/wiki/Tz_database. This field is assigned a default value of "UTC" if left empty. + * The time zone to use when interpreting the schedule. + * The value of this field must be a time zone name from the tz database: + * https://en.wikipedia.org/wiki/Tz_database. This field is assigned a + * default value of "UTC" if left empty. * } */ public function __construct($data = NULL) { @@ -114,7 +148,9 @@ public function setDescription($var) } /** - * A boolean value that specifies whether a scaling schedule can influence autoscaler recommendations. If set to true, then a scaling schedule has no effect. This field is optional, and its value is false by default. + * A boolean value that specifies whether a scaling schedule can influence + * autoscaler recommendations. If set to true, then a scaling schedule has + * no effect. This field is optional, and its value is false by default. * * Generated from protobuf field optional bool disabled = 270940796; * @return bool @@ -135,7 +171,9 @@ public function clearDisabled() } /** - * A boolean value that specifies whether a scaling schedule can influence autoscaler recommendations. If set to true, then a scaling schedule has no effect. This field is optional, and its value is false by default. + * A boolean value that specifies whether a scaling schedule can influence + * autoscaler recommendations. If set to true, then a scaling schedule has + * no effect. This field is optional, and its value is false by default. * * Generated from protobuf field optional bool disabled = 270940796; * @param bool $var @@ -150,7 +188,9 @@ public function setDisabled($var) } /** - * The duration of time intervals, in seconds, for which this scaling schedule is to run. The minimum allowed value is 300. This field is required. + * The duration of time intervals, in seconds, for which this + * scaling schedule is to run. The minimum allowed value is 300. + * This field is required. * * Generated from protobuf field optional int32 duration_sec = 212356902; * @return int @@ -171,7 +211,9 @@ public function clearDurationSec() } /** - * The duration of time intervals, in seconds, for which this scaling schedule is to run. The minimum allowed value is 300. This field is required. + * The duration of time intervals, in seconds, for which this + * scaling schedule is to run. The minimum allowed value is 300. + * This field is required. * * Generated from protobuf field optional int32 duration_sec = 212356902; * @param int $var @@ -186,7 +228,9 @@ public function setDurationSec($var) } /** - * The minimum number of VM instances that the autoscaler will recommend in time intervals starting according to schedule. This field is required. + * The minimum number of VM instances that the autoscaler will + * recommend in time intervals starting according to schedule. This field is + * required. * * Generated from protobuf field optional int32 min_required_replicas = 365514414; * @return int @@ -207,7 +251,9 @@ public function clearMinRequiredReplicas() } /** - * The minimum number of VM instances that the autoscaler will recommend in time intervals starting according to schedule. This field is required. + * The minimum number of VM instances that the autoscaler will + * recommend in time intervals starting according to schedule. This field is + * required. * * Generated from protobuf field optional int32 min_required_replicas = 365514414; * @param int $var @@ -222,7 +268,14 @@ public function setMinRequiredReplicas($var) } /** - * The start timestamps of time intervals when this scaling schedule is to provide a scaling signal. This field uses the extended cron format (with an optional year field). The expression can describe a single timestamp if the optional year is set, in which case the scaling schedule runs once. The schedule is interpreted with respect to time_zone. This field is required. Note: These timestamps only describe when autoscaler starts providing the scaling signal. The VMs need additional time to become serving. + * The start timestamps of time intervals when this scaling + * schedule is to provide a scaling signal. This field uses the extended + * cron format (with an optional year field). The expression can describe a + * single timestamp if the optional year is set, in which case the scaling + * schedule runs once. The schedule is interpreted with respect to + * time_zone. This field is required. Note: These timestamps only describe + * when autoscaler starts providing the scaling signal. The VMs + * need additional time to become serving. * * Generated from protobuf field optional string schedule = 375820951; * @return string @@ -243,7 +296,14 @@ public function clearSchedule() } /** - * The start timestamps of time intervals when this scaling schedule is to provide a scaling signal. This field uses the extended cron format (with an optional year field). The expression can describe a single timestamp if the optional year is set, in which case the scaling schedule runs once. The schedule is interpreted with respect to time_zone. This field is required. Note: These timestamps only describe when autoscaler starts providing the scaling signal. The VMs need additional time to become serving. + * The start timestamps of time intervals when this scaling + * schedule is to provide a scaling signal. This field uses the extended + * cron format (with an optional year field). The expression can describe a + * single timestamp if the optional year is set, in which case the scaling + * schedule runs once. The schedule is interpreted with respect to + * time_zone. This field is required. Note: These timestamps only describe + * when autoscaler starts providing the scaling signal. The VMs + * need additional time to become serving. * * Generated from protobuf field optional string schedule = 375820951; * @param string $var @@ -258,7 +318,10 @@ public function setSchedule($var) } /** - * The time zone to use when interpreting the schedule. The value of this field must be a time zone name from the tz database: https://en.wikipedia.org/wiki/Tz_database. This field is assigned a default value of "UTC" if left empty. + * The time zone to use when interpreting the schedule. + * The value of this field must be a time zone name from the tz database: + * https://en.wikipedia.org/wiki/Tz_database. This field is assigned a + * default value of "UTC" if left empty. * * Generated from protobuf field optional string time_zone = 36848094; * @return string @@ -279,7 +342,10 @@ public function clearTimeZone() } /** - * The time zone to use when interpreting the schedule. The value of this field must be a time zone name from the tz database: https://en.wikipedia.org/wiki/Tz_database. This field is assigned a default value of "UTC" if left empty. + * The time zone to use when interpreting the schedule. + * The value of this field must be a time zone name from the tz database: + * https://en.wikipedia.org/wiki/Tz_database. This field is assigned a + * default value of "UTC" if left empty. * * Generated from protobuf field optional string time_zone = 36848094; * @param string $var diff --git a/Compute/src/V1/Backend.php b/Compute/src/V1/Backend.php index 0b22d2519651..344e85c865a1 100644 --- a/Compute/src/V1/Backend.php +++ b/Compute/src/V1/Backend.php @@ -16,86 +16,150 @@ class Backend extends \Google\Protobuf\Internal\Message { /** - * Specifies how to determine whether the backend of a load balancer can handle additional traffic or is fully loaded. For usage guidelines, see Connection balancing mode. Backends must use compatible balancing modes. For more information, see Supported balancing modes and target capacity settings and Restrictions and guidance for instance groups. Note: Currently, if you use the API to configure incompatible balancing modes, the configuration might be accepted even though it has no impact and is ignored. Specifically, Backend.maxUtilization is ignored when Backend.balancingMode is RATE. In the future, this incompatible combination will be rejected. + * Specifies how to determine whether the backend of a load balancer can + * handle additional traffic or is fully loaded. For usage guidelines, see + * Connection balancing mode. + * Backends must use compatible balancing modes. For more information, see + * Supported balancing modes and target capacity settings and + * Restrictions and guidance for instance groups. + * Note: Currently, if you use the API to configure incompatible balancing + * modes, the configuration might be accepted even though it has no impact + * and is ignored. Specifically, Backend.maxUtilization is ignored when + * Backend.balancingMode is RATE. In the future, this incompatible combination + * will be rejected. * Check the BalancingMode enum for the list of possible values. * * Generated from protobuf field optional string balancing_mode = 430286217; */ protected $balancing_mode = null; /** - * A multiplier applied to the backend's target capacity of its balancing mode. The default value is 1, which means the group serves up to 100% of its configured capacity (depending on balancingMode). A setting of 0 means the group is completely drained, offering 0% of its available capacity. The valid ranges are 0.0 and [0.1,1.0]. You cannot configure a setting larger than 0 and smaller than 0.1. You cannot configure a setting of 0 when there is only one backend attached to the backend service. Not available with backends that don't support using a balancingMode. This includes backends such as global internet NEGs, regional serverless NEGs, and PSC NEGs. + * A multiplier applied to the backend's target capacity of its balancing + * mode. + * The default value is 1, which means the group serves up to + * 100% of its configured capacity (depending onbalancingMode). A setting of 0 means the group is + * completely drained, offering 0% of its available capacity. The valid ranges + * are 0.0 and [0.1,1.0]. + * You cannot configure a setting larger than 0 and smaller than0.1. + * You cannot configure a setting of 0 when there is only one + * backend attached to the backend service. + * Not available with backends that don't support using abalancingMode. This includes backends such as global + * internet NEGs, regional serverless NEGs, and PSC NEGs. * * Generated from protobuf field optional float capacity_scaler = 315958157; */ protected $capacity_scaler = null; /** - * List of custom metrics that are used for CUSTOM_METRICS BalancingMode. + * List of custom metrics that are used for CUSTOM_METRICS + * BalancingMode. * * Generated from protobuf field repeated .google.cloud.compute.v1.BackendCustomMetric custom_metrics = 429453813; */ private $custom_metrics; /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; */ protected $description = null; /** - * This field designates whether this is a failover backend. More than one failover backend can be configured for a given BackendService. + * This field designates whether this is a failover backend. More than one + * failover backend can be configured for a given BackendService. * * Generated from protobuf field optional bool failover = 138892530; */ protected $failover = null; /** - * The fully-qualified URL of an instance group or network endpoint group (NEG) resource. To determine what types of backends a load balancer supports, see the [Backend services overview](https://cloud.google.com/load-balancing/docs/backend-service#backends). You must use the *fully-qualified* URL (starting with https://www.googleapis.com/) to specify the instance group or NEG. Partial URLs are not supported. If haPolicy is specified, backends must refer to NEG resources of type GCE_VM_IP. + * The fully-qualified URL of aninstance + * group or network endpoint + * group (NEG) resource. To determine what types of backends a load + * balancer supports, see the [Backend services + * overview](https://cloud.google.com/load-balancing/docs/backend-service#backends). + * You must use the *fully-qualified* URL (starting withhttps://www.googleapis.com/) to specify the instance group + * or NEG. Partial URLs are not supported. + * If haPolicy is specified, backends must refer to NEG resources of type + * GCE_VM_IP. * * Generated from protobuf field optional string group = 98629247; */ protected $group = null; /** - * Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE. + * Defines a target maximum number of simultaneous connections. For usage + * guidelines, seeConnection + * balancing mode and Utilization + * balancing mode. Not available if the backend'sbalancingMode is RATE. * * Generated from protobuf field optional int32 max_connections = 110652154; */ protected $max_connections = null; /** - * Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE. + * Defines a target maximum number of simultaneous connections. For usage + * guidelines, seeConnection + * balancing mode and Utilization + * balancing mode. + * Not available if the backend's balancingMode isRATE. * * Generated from protobuf field optional int32 max_connections_per_endpoint = 216904604; */ protected $max_connections_per_endpoint = null; /** - * Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE. + * Defines a target maximum number of simultaneous connections. + * For usage guidelines, seeConnection + * balancing mode and Utilization + * balancing mode. + * Not available if the backend's balancingMode isRATE. * * Generated from protobuf field optional int32 max_connections_per_instance = 104671900; */ protected $max_connections_per_instance = null; /** - * Defines a maximum number of HTTP requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION. + * Defines a maximum number of HTTP requests per second (RPS). For + * usage guidelines, seeRate + * balancing mode and Utilization + * balancing mode. + * Not available if the backend's balancingMode isCONNECTION. * * Generated from protobuf field optional int32 max_rate = 408035035; */ protected $max_rate = null; /** - * Defines a maximum target for requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION. + * Defines a maximum target for requests per second (RPS). For usage + * guidelines, seeRate + * balancing mode and Utilization + * balancing mode. + * Not available if the backend's balancingMode isCONNECTION. * * Generated from protobuf field optional float max_rate_per_endpoint = 129832283; */ protected $max_rate_per_endpoint = null; /** - * Defines a maximum target for requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION. + * Defines a maximum target for requests per second (RPS). For usage + * guidelines, seeRate + * balancing mode and Utilization + * balancing mode. + * Not available if the backend's balancingMode isCONNECTION. * * Generated from protobuf field optional float max_rate_per_instance = 17599579; */ protected $max_rate_per_instance = null; /** - * Optional parameter to define a target capacity for the UTILIZATION balancing mode. The valid range is [0.0, 1.0]. For usage guidelines, see Utilization balancing mode. + * Optional parameter to define a target capacity for theUTILIZATION balancing mode. The valid range is[0.0, 1.0]. + * For usage guidelines, seeUtilization + * balancing mode. * * Generated from protobuf field optional float max_utilization = 148192199; */ protected $max_utilization = null; /** - * This field indicates whether this backend should be fully utilized before sending traffic to backends with default preference. The possible values are: - PREFERRED: Backends with this preference level will be filled up to their capacity limits first, based on RTT. - DEFAULT: If preferred backends don't have enough capacity, backends in this layer would be used and traffic would be assigned based on the load balancing algorithm you use. This is the default + * This field indicates whether this backend should be fully utilized before + * sending traffic to backends with default preference. The possible values + * are: + * - PREFERRED: Backends with this preference level will be + * filled up to their capacity limits first, based on RTT. + * - DEFAULT: If preferred backends don't have enough + * capacity, backends in this layer would be used and traffic would be + * assigned based on the load balancing algorithm you use. This is the + * default * Check the Preference enum for the list of possible values. * * Generated from protobuf field optional string preference = 150781147; @@ -109,34 +173,98 @@ class Backend extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $balancing_mode - * Specifies how to determine whether the backend of a load balancer can handle additional traffic or is fully loaded. For usage guidelines, see Connection balancing mode. Backends must use compatible balancing modes. For more information, see Supported balancing modes and target capacity settings and Restrictions and guidance for instance groups. Note: Currently, if you use the API to configure incompatible balancing modes, the configuration might be accepted even though it has no impact and is ignored. Specifically, Backend.maxUtilization is ignored when Backend.balancingMode is RATE. In the future, this incompatible combination will be rejected. + * Specifies how to determine whether the backend of a load balancer can + * handle additional traffic or is fully loaded. For usage guidelines, see + * Connection balancing mode. + * Backends must use compatible balancing modes. For more information, see + * Supported balancing modes and target capacity settings and + * Restrictions and guidance for instance groups. + * Note: Currently, if you use the API to configure incompatible balancing + * modes, the configuration might be accepted even though it has no impact + * and is ignored. Specifically, Backend.maxUtilization is ignored when + * Backend.balancingMode is RATE. In the future, this incompatible combination + * will be rejected. * Check the BalancingMode enum for the list of possible values. * @type float $capacity_scaler - * A multiplier applied to the backend's target capacity of its balancing mode. The default value is 1, which means the group serves up to 100% of its configured capacity (depending on balancingMode). A setting of 0 means the group is completely drained, offering 0% of its available capacity. The valid ranges are 0.0 and [0.1,1.0]. You cannot configure a setting larger than 0 and smaller than 0.1. You cannot configure a setting of 0 when there is only one backend attached to the backend service. Not available with backends that don't support using a balancingMode. This includes backends such as global internet NEGs, regional serverless NEGs, and PSC NEGs. + * A multiplier applied to the backend's target capacity of its balancing + * mode. + * The default value is 1, which means the group serves up to + * 100% of its configured capacity (depending onbalancingMode). A setting of 0 means the group is + * completely drained, offering 0% of its available capacity. The valid ranges + * are 0.0 and [0.1,1.0]. + * You cannot configure a setting larger than 0 and smaller than0.1. + * You cannot configure a setting of 0 when there is only one + * backend attached to the backend service. + * Not available with backends that don't support using abalancingMode. This includes backends such as global + * internet NEGs, regional serverless NEGs, and PSC NEGs. * @type array<\Google\Cloud\Compute\V1\BackendCustomMetric>|\Google\Protobuf\Internal\RepeatedField $custom_metrics - * List of custom metrics that are used for CUSTOM_METRICS BalancingMode. + * List of custom metrics that are used for CUSTOM_METRICS + * BalancingMode. * @type string $description - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * @type bool $failover - * This field designates whether this is a failover backend. More than one failover backend can be configured for a given BackendService. + * This field designates whether this is a failover backend. More than one + * failover backend can be configured for a given BackendService. * @type string $group - * The fully-qualified URL of an instance group or network endpoint group (NEG) resource. To determine what types of backends a load balancer supports, see the [Backend services overview](https://cloud.google.com/load-balancing/docs/backend-service#backends). You must use the *fully-qualified* URL (starting with https://www.googleapis.com/) to specify the instance group or NEG. Partial URLs are not supported. If haPolicy is specified, backends must refer to NEG resources of type GCE_VM_IP. + * The fully-qualified URL of aninstance + * group or network endpoint + * group (NEG) resource. To determine what types of backends a load + * balancer supports, see the [Backend services + * overview](https://cloud.google.com/load-balancing/docs/backend-service#backends). + * You must use the *fully-qualified* URL (starting withhttps://www.googleapis.com/) to specify the instance group + * or NEG. Partial URLs are not supported. + * If haPolicy is specified, backends must refer to NEG resources of type + * GCE_VM_IP. * @type int $max_connections - * Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE. + * Defines a target maximum number of simultaneous connections. For usage + * guidelines, seeConnection + * balancing mode and Utilization + * balancing mode. Not available if the backend'sbalancingMode is RATE. * @type int $max_connections_per_endpoint - * Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE. + * Defines a target maximum number of simultaneous connections. For usage + * guidelines, seeConnection + * balancing mode and Utilization + * balancing mode. + * Not available if the backend's balancingMode isRATE. * @type int $max_connections_per_instance - * Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE. + * Defines a target maximum number of simultaneous connections. + * For usage guidelines, seeConnection + * balancing mode and Utilization + * balancing mode. + * Not available if the backend's balancingMode isRATE. * @type int $max_rate - * Defines a maximum number of HTTP requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION. + * Defines a maximum number of HTTP requests per second (RPS). For + * usage guidelines, seeRate + * balancing mode and Utilization + * balancing mode. + * Not available if the backend's balancingMode isCONNECTION. * @type float $max_rate_per_endpoint - * Defines a maximum target for requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION. + * Defines a maximum target for requests per second (RPS). For usage + * guidelines, seeRate + * balancing mode and Utilization + * balancing mode. + * Not available if the backend's balancingMode isCONNECTION. * @type float $max_rate_per_instance - * Defines a maximum target for requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION. + * Defines a maximum target for requests per second (RPS). For usage + * guidelines, seeRate + * balancing mode and Utilization + * balancing mode. + * Not available if the backend's balancingMode isCONNECTION. * @type float $max_utilization - * Optional parameter to define a target capacity for the UTILIZATION balancing mode. The valid range is [0.0, 1.0]. For usage guidelines, see Utilization balancing mode. + * Optional parameter to define a target capacity for theUTILIZATION balancing mode. The valid range is[0.0, 1.0]. + * For usage guidelines, seeUtilization + * balancing mode. * @type string $preference - * This field indicates whether this backend should be fully utilized before sending traffic to backends with default preference. The possible values are: - PREFERRED: Backends with this preference level will be filled up to their capacity limits first, based on RTT. - DEFAULT: If preferred backends don't have enough capacity, backends in this layer would be used and traffic would be assigned based on the load balancing algorithm you use. This is the default + * This field indicates whether this backend should be fully utilized before + * sending traffic to backends with default preference. The possible values + * are: + * - PREFERRED: Backends with this preference level will be + * filled up to their capacity limits first, based on RTT. + * - DEFAULT: If preferred backends don't have enough + * capacity, backends in this layer would be used and traffic would be + * assigned based on the load balancing algorithm you use. This is the + * default * Check the Preference enum for the list of possible values. * } */ @@ -146,7 +274,17 @@ public function __construct($data = NULL) { } /** - * Specifies how to determine whether the backend of a load balancer can handle additional traffic or is fully loaded. For usage guidelines, see Connection balancing mode. Backends must use compatible balancing modes. For more information, see Supported balancing modes and target capacity settings and Restrictions and guidance for instance groups. Note: Currently, if you use the API to configure incompatible balancing modes, the configuration might be accepted even though it has no impact and is ignored. Specifically, Backend.maxUtilization is ignored when Backend.balancingMode is RATE. In the future, this incompatible combination will be rejected. + * Specifies how to determine whether the backend of a load balancer can + * handle additional traffic or is fully loaded. For usage guidelines, see + * Connection balancing mode. + * Backends must use compatible balancing modes. For more information, see + * Supported balancing modes and target capacity settings and + * Restrictions and guidance for instance groups. + * Note: Currently, if you use the API to configure incompatible balancing + * modes, the configuration might be accepted even though it has no impact + * and is ignored. Specifically, Backend.maxUtilization is ignored when + * Backend.balancingMode is RATE. In the future, this incompatible combination + * will be rejected. * Check the BalancingMode enum for the list of possible values. * * Generated from protobuf field optional string balancing_mode = 430286217; @@ -168,7 +306,17 @@ public function clearBalancingMode() } /** - * Specifies how to determine whether the backend of a load balancer can handle additional traffic or is fully loaded. For usage guidelines, see Connection balancing mode. Backends must use compatible balancing modes. For more information, see Supported balancing modes and target capacity settings and Restrictions and guidance for instance groups. Note: Currently, if you use the API to configure incompatible balancing modes, the configuration might be accepted even though it has no impact and is ignored. Specifically, Backend.maxUtilization is ignored when Backend.balancingMode is RATE. In the future, this incompatible combination will be rejected. + * Specifies how to determine whether the backend of a load balancer can + * handle additional traffic or is fully loaded. For usage guidelines, see + * Connection balancing mode. + * Backends must use compatible balancing modes. For more information, see + * Supported balancing modes and target capacity settings and + * Restrictions and guidance for instance groups. + * Note: Currently, if you use the API to configure incompatible balancing + * modes, the configuration might be accepted even though it has no impact + * and is ignored. Specifically, Backend.maxUtilization is ignored when + * Backend.balancingMode is RATE. In the future, this incompatible combination + * will be rejected. * Check the BalancingMode enum for the list of possible values. * * Generated from protobuf field optional string balancing_mode = 430286217; @@ -184,7 +332,17 @@ public function setBalancingMode($var) } /** - * A multiplier applied to the backend's target capacity of its balancing mode. The default value is 1, which means the group serves up to 100% of its configured capacity (depending on balancingMode). A setting of 0 means the group is completely drained, offering 0% of its available capacity. The valid ranges are 0.0 and [0.1,1.0]. You cannot configure a setting larger than 0 and smaller than 0.1. You cannot configure a setting of 0 when there is only one backend attached to the backend service. Not available with backends that don't support using a balancingMode. This includes backends such as global internet NEGs, regional serverless NEGs, and PSC NEGs. + * A multiplier applied to the backend's target capacity of its balancing + * mode. + * The default value is 1, which means the group serves up to + * 100% of its configured capacity (depending onbalancingMode). A setting of 0 means the group is + * completely drained, offering 0% of its available capacity. The valid ranges + * are 0.0 and [0.1,1.0]. + * You cannot configure a setting larger than 0 and smaller than0.1. + * You cannot configure a setting of 0 when there is only one + * backend attached to the backend service. + * Not available with backends that don't support using abalancingMode. This includes backends such as global + * internet NEGs, regional serverless NEGs, and PSC NEGs. * * Generated from protobuf field optional float capacity_scaler = 315958157; * @return float @@ -205,7 +363,17 @@ public function clearCapacityScaler() } /** - * A multiplier applied to the backend's target capacity of its balancing mode. The default value is 1, which means the group serves up to 100% of its configured capacity (depending on balancingMode). A setting of 0 means the group is completely drained, offering 0% of its available capacity. The valid ranges are 0.0 and [0.1,1.0]. You cannot configure a setting larger than 0 and smaller than 0.1. You cannot configure a setting of 0 when there is only one backend attached to the backend service. Not available with backends that don't support using a balancingMode. This includes backends such as global internet NEGs, regional serverless NEGs, and PSC NEGs. + * A multiplier applied to the backend's target capacity of its balancing + * mode. + * The default value is 1, which means the group serves up to + * 100% of its configured capacity (depending onbalancingMode). A setting of 0 means the group is + * completely drained, offering 0% of its available capacity. The valid ranges + * are 0.0 and [0.1,1.0]. + * You cannot configure a setting larger than 0 and smaller than0.1. + * You cannot configure a setting of 0 when there is only one + * backend attached to the backend service. + * Not available with backends that don't support using abalancingMode. This includes backends such as global + * internet NEGs, regional serverless NEGs, and PSC NEGs. * * Generated from protobuf field optional float capacity_scaler = 315958157; * @param float $var @@ -220,7 +388,8 @@ public function setCapacityScaler($var) } /** - * List of custom metrics that are used for CUSTOM_METRICS BalancingMode. + * List of custom metrics that are used for CUSTOM_METRICS + * BalancingMode. * * Generated from protobuf field repeated .google.cloud.compute.v1.BackendCustomMetric custom_metrics = 429453813; * @return \Google\Protobuf\Internal\RepeatedField @@ -231,7 +400,8 @@ public function getCustomMetrics() } /** - * List of custom metrics that are used for CUSTOM_METRICS BalancingMode. + * List of custom metrics that are used for CUSTOM_METRICS + * BalancingMode. * * Generated from protobuf field repeated .google.cloud.compute.v1.BackendCustomMetric custom_metrics = 429453813; * @param array<\Google\Cloud\Compute\V1\BackendCustomMetric>|\Google\Protobuf\Internal\RepeatedField $var @@ -246,7 +416,8 @@ public function setCustomMetrics($var) } /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @return string @@ -267,7 +438,8 @@ public function clearDescription() } /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @param string $var @@ -282,7 +454,8 @@ public function setDescription($var) } /** - * This field designates whether this is a failover backend. More than one failover backend can be configured for a given BackendService. + * This field designates whether this is a failover backend. More than one + * failover backend can be configured for a given BackendService. * * Generated from protobuf field optional bool failover = 138892530; * @return bool @@ -303,7 +476,8 @@ public function clearFailover() } /** - * This field designates whether this is a failover backend. More than one failover backend can be configured for a given BackendService. + * This field designates whether this is a failover backend. More than one + * failover backend can be configured for a given BackendService. * * Generated from protobuf field optional bool failover = 138892530; * @param bool $var @@ -318,7 +492,15 @@ public function setFailover($var) } /** - * The fully-qualified URL of an instance group or network endpoint group (NEG) resource. To determine what types of backends a load balancer supports, see the [Backend services overview](https://cloud.google.com/load-balancing/docs/backend-service#backends). You must use the *fully-qualified* URL (starting with https://www.googleapis.com/) to specify the instance group or NEG. Partial URLs are not supported. If haPolicy is specified, backends must refer to NEG resources of type GCE_VM_IP. + * The fully-qualified URL of aninstance + * group or network endpoint + * group (NEG) resource. To determine what types of backends a load + * balancer supports, see the [Backend services + * overview](https://cloud.google.com/load-balancing/docs/backend-service#backends). + * You must use the *fully-qualified* URL (starting withhttps://www.googleapis.com/) to specify the instance group + * or NEG. Partial URLs are not supported. + * If haPolicy is specified, backends must refer to NEG resources of type + * GCE_VM_IP. * * Generated from protobuf field optional string group = 98629247; * @return string @@ -339,7 +521,15 @@ public function clearGroup() } /** - * The fully-qualified URL of an instance group or network endpoint group (NEG) resource. To determine what types of backends a load balancer supports, see the [Backend services overview](https://cloud.google.com/load-balancing/docs/backend-service#backends). You must use the *fully-qualified* URL (starting with https://www.googleapis.com/) to specify the instance group or NEG. Partial URLs are not supported. If haPolicy is specified, backends must refer to NEG resources of type GCE_VM_IP. + * The fully-qualified URL of aninstance + * group or network endpoint + * group (NEG) resource. To determine what types of backends a load + * balancer supports, see the [Backend services + * overview](https://cloud.google.com/load-balancing/docs/backend-service#backends). + * You must use the *fully-qualified* URL (starting withhttps://www.googleapis.com/) to specify the instance group + * or NEG. Partial URLs are not supported. + * If haPolicy is specified, backends must refer to NEG resources of type + * GCE_VM_IP. * * Generated from protobuf field optional string group = 98629247; * @param string $var @@ -354,7 +544,10 @@ public function setGroup($var) } /** - * Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE. + * Defines a target maximum number of simultaneous connections. For usage + * guidelines, seeConnection + * balancing mode and Utilization + * balancing mode. Not available if the backend'sbalancingMode is RATE. * * Generated from protobuf field optional int32 max_connections = 110652154; * @return int @@ -375,7 +568,10 @@ public function clearMaxConnections() } /** - * Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE. + * Defines a target maximum number of simultaneous connections. For usage + * guidelines, seeConnection + * balancing mode and Utilization + * balancing mode. Not available if the backend'sbalancingMode is RATE. * * Generated from protobuf field optional int32 max_connections = 110652154; * @param int $var @@ -390,7 +586,11 @@ public function setMaxConnections($var) } /** - * Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE. + * Defines a target maximum number of simultaneous connections. For usage + * guidelines, seeConnection + * balancing mode and Utilization + * balancing mode. + * Not available if the backend's balancingMode isRATE. * * Generated from protobuf field optional int32 max_connections_per_endpoint = 216904604; * @return int @@ -411,7 +611,11 @@ public function clearMaxConnectionsPerEndpoint() } /** - * Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE. + * Defines a target maximum number of simultaneous connections. For usage + * guidelines, seeConnection + * balancing mode and Utilization + * balancing mode. + * Not available if the backend's balancingMode isRATE. * * Generated from protobuf field optional int32 max_connections_per_endpoint = 216904604; * @param int $var @@ -426,7 +630,11 @@ public function setMaxConnectionsPerEndpoint($var) } /** - * Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE. + * Defines a target maximum number of simultaneous connections. + * For usage guidelines, seeConnection + * balancing mode and Utilization + * balancing mode. + * Not available if the backend's balancingMode isRATE. * * Generated from protobuf field optional int32 max_connections_per_instance = 104671900; * @return int @@ -447,7 +655,11 @@ public function clearMaxConnectionsPerInstance() } /** - * Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE. + * Defines a target maximum number of simultaneous connections. + * For usage guidelines, seeConnection + * balancing mode and Utilization + * balancing mode. + * Not available if the backend's balancingMode isRATE. * * Generated from protobuf field optional int32 max_connections_per_instance = 104671900; * @param int $var @@ -462,7 +674,11 @@ public function setMaxConnectionsPerInstance($var) } /** - * Defines a maximum number of HTTP requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION. + * Defines a maximum number of HTTP requests per second (RPS). For + * usage guidelines, seeRate + * balancing mode and Utilization + * balancing mode. + * Not available if the backend's balancingMode isCONNECTION. * * Generated from protobuf field optional int32 max_rate = 408035035; * @return int @@ -483,7 +699,11 @@ public function clearMaxRate() } /** - * Defines a maximum number of HTTP requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION. + * Defines a maximum number of HTTP requests per second (RPS). For + * usage guidelines, seeRate + * balancing mode and Utilization + * balancing mode. + * Not available if the backend's balancingMode isCONNECTION. * * Generated from protobuf field optional int32 max_rate = 408035035; * @param int $var @@ -498,7 +718,11 @@ public function setMaxRate($var) } /** - * Defines a maximum target for requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION. + * Defines a maximum target for requests per second (RPS). For usage + * guidelines, seeRate + * balancing mode and Utilization + * balancing mode. + * Not available if the backend's balancingMode isCONNECTION. * * Generated from protobuf field optional float max_rate_per_endpoint = 129832283; * @return float @@ -519,7 +743,11 @@ public function clearMaxRatePerEndpoint() } /** - * Defines a maximum target for requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION. + * Defines a maximum target for requests per second (RPS). For usage + * guidelines, seeRate + * balancing mode and Utilization + * balancing mode. + * Not available if the backend's balancingMode isCONNECTION. * * Generated from protobuf field optional float max_rate_per_endpoint = 129832283; * @param float $var @@ -534,7 +762,11 @@ public function setMaxRatePerEndpoint($var) } /** - * Defines a maximum target for requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION. + * Defines a maximum target for requests per second (RPS). For usage + * guidelines, seeRate + * balancing mode and Utilization + * balancing mode. + * Not available if the backend's balancingMode isCONNECTION. * * Generated from protobuf field optional float max_rate_per_instance = 17599579; * @return float @@ -555,7 +787,11 @@ public function clearMaxRatePerInstance() } /** - * Defines a maximum target for requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION. + * Defines a maximum target for requests per second (RPS). For usage + * guidelines, seeRate + * balancing mode and Utilization + * balancing mode. + * Not available if the backend's balancingMode isCONNECTION. * * Generated from protobuf field optional float max_rate_per_instance = 17599579; * @param float $var @@ -570,7 +806,9 @@ public function setMaxRatePerInstance($var) } /** - * Optional parameter to define a target capacity for the UTILIZATION balancing mode. The valid range is [0.0, 1.0]. For usage guidelines, see Utilization balancing mode. + * Optional parameter to define a target capacity for theUTILIZATION balancing mode. The valid range is[0.0, 1.0]. + * For usage guidelines, seeUtilization + * balancing mode. * * Generated from protobuf field optional float max_utilization = 148192199; * @return float @@ -591,7 +829,9 @@ public function clearMaxUtilization() } /** - * Optional parameter to define a target capacity for the UTILIZATION balancing mode. The valid range is [0.0, 1.0]. For usage guidelines, see Utilization balancing mode. + * Optional parameter to define a target capacity for theUTILIZATION balancing mode. The valid range is[0.0, 1.0]. + * For usage guidelines, seeUtilization + * balancing mode. * * Generated from protobuf field optional float max_utilization = 148192199; * @param float $var @@ -606,7 +846,15 @@ public function setMaxUtilization($var) } /** - * This field indicates whether this backend should be fully utilized before sending traffic to backends with default preference. The possible values are: - PREFERRED: Backends with this preference level will be filled up to their capacity limits first, based on RTT. - DEFAULT: If preferred backends don't have enough capacity, backends in this layer would be used and traffic would be assigned based on the load balancing algorithm you use. This is the default + * This field indicates whether this backend should be fully utilized before + * sending traffic to backends with default preference. The possible values + * are: + * - PREFERRED: Backends with this preference level will be + * filled up to their capacity limits first, based on RTT. + * - DEFAULT: If preferred backends don't have enough + * capacity, backends in this layer would be used and traffic would be + * assigned based on the load balancing algorithm you use. This is the + * default * Check the Preference enum for the list of possible values. * * Generated from protobuf field optional string preference = 150781147; @@ -628,7 +876,15 @@ public function clearPreference() } /** - * This field indicates whether this backend should be fully utilized before sending traffic to backends with default preference. The possible values are: - PREFERRED: Backends with this preference level will be filled up to their capacity limits first, based on RTT. - DEFAULT: If preferred backends don't have enough capacity, backends in this layer would be used and traffic would be assigned based on the load balancing algorithm you use. This is the default + * This field indicates whether this backend should be fully utilized before + * sending traffic to backends with default preference. The possible values + * are: + * - PREFERRED: Backends with this preference level will be + * filled up to their capacity limits first, based on RTT. + * - DEFAULT: If preferred backends don't have enough + * capacity, backends in this layer would be used and traffic would be + * assigned based on the load balancing algorithm you use. This is the + * default * Check the Preference enum for the list of possible values. * * Generated from protobuf field optional string preference = 150781147; diff --git a/Compute/src/V1/Backend/BalancingMode.php b/Compute/src/V1/Backend/BalancingMode.php index 9ee35c8883b9..975f2c04f49c 100644 --- a/Compute/src/V1/Backend/BalancingMode.php +++ b/Compute/src/V1/Backend/BalancingMode.php @@ -7,7 +7,17 @@ use UnexpectedValueException; /** - * Specifies how to determine whether the backend of a load balancer can handle additional traffic or is fully loaded. For usage guidelines, see Connection balancing mode. Backends must use compatible balancing modes. For more information, see Supported balancing modes and target capacity settings and Restrictions and guidance for instance groups. Note: Currently, if you use the API to configure incompatible balancing modes, the configuration might be accepted even though it has no impact and is ignored. Specifically, Backend.maxUtilization is ignored when Backend.balancingMode is RATE. In the future, this incompatible combination will be rejected. + * Specifies how to determine whether the backend of a load balancer can + * handle additional traffic or is fully loaded. For usage guidelines, see + * Connection balancing mode. + * Backends must use compatible balancing modes. For more information, see + * Supported balancing modes and target capacity settings and + * Restrictions and guidance for instance groups. + * Note: Currently, if you use the API to configure incompatible balancing + * modes, the configuration might be accepted even though it has no impact + * and is ignored. Specifically, Backend.maxUtilization is ignored when + * Backend.balancingMode is RATE. In the future, this incompatible combination + * will be rejected. * * Protobuf type google.cloud.compute.v1.Backend.BalancingMode */ diff --git a/Compute/src/V1/Backend/Preference.php b/Compute/src/V1/Backend/Preference.php index ecef70e51d00..5bcbd2beebc5 100644 --- a/Compute/src/V1/Backend/Preference.php +++ b/Compute/src/V1/Backend/Preference.php @@ -7,7 +7,15 @@ use UnexpectedValueException; /** - * This field indicates whether this backend should be fully utilized before sending traffic to backends with default preference. The possible values are: - PREFERRED: Backends with this preference level will be filled up to their capacity limits first, based on RTT. - DEFAULT: If preferred backends don't have enough capacity, backends in this layer would be used and traffic would be assigned based on the load balancing algorithm you use. This is the default + * This field indicates whether this backend should be fully utilized before + * sending traffic to backends with default preference. The possible values + * are: + * - PREFERRED: Backends with this preference level will be + * filled up to their capacity limits first, based on RTT. + * - DEFAULT: If preferred backends don't have enough + * capacity, backends in this layer would be used and traffic would be + * assigned based on the load balancing algorithm you use. This is the + * default * * Protobuf type google.cloud.compute.v1.Backend.Preference */ diff --git a/Compute/src/V1/BackendBucket.php b/Compute/src/V1/BackendBucket.php index 8b9bb0dce94f..f3a1ea73188b 100644 --- a/Compute/src/V1/BackendBucket.php +++ b/Compute/src/V1/BackendBucket.php @@ -9,7 +9,9 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Represents a Cloud Storage Bucket resource. This Cloud Storage bucket resource is referenced by a URL map of a load balancer. For more information, read Backend Buckets. + * Represents a Cloud Storage Bucket resource. + * This Cloud Storage bucket resource is referenced by a URL map of a load + * balancer. For more information, readBackend Buckets. * * Generated from protobuf message google.cloud.compute.v1.BackendBucket */ @@ -28,14 +30,16 @@ class BackendBucket extends \Google\Protobuf\Internal\Message */ protected $cdn_policy = null; /** - * Compress text responses using Brotli or gzip compression, based on the client's Accept-Encoding header. + * Compress text responses using Brotli or gzip compression, based on + * the client's Accept-Encoding header. * Check the CompressionMode enum for the list of possible values. * * Generated from protobuf field optional string compression_mode = 95520988; */ protected $compression_mode = null; /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; */ @@ -47,13 +51,15 @@ class BackendBucket extends \Google\Protobuf\Internal\Message */ private $custom_response_headers; /** - * An optional textual description of the resource; provided by the client when the resource is created. + * An optional textual description of the resource; provided by the client + * when the resource is created. * * Generated from protobuf field optional string description = 422937596; */ protected $description = null; /** - * [Output Only] The resource URL for the edge security policy associated with this backend bucket. + * [Output Only] The resource URL for the edge security policy associated with + * this backend bucket. * * Generated from protobuf field optional string edge_security_policy = 41036943; */ @@ -77,20 +83,31 @@ class BackendBucket extends \Google\Protobuf\Internal\Message */ protected $kind = null; /** - * The value can only be INTERNAL_MANAGED for cross-region internal layer 7 load balancer. If loadBalancingScheme is not specified, the backend bucket can be used by classic global external load balancers, or global application external load balancers, or both. + * The value can only be INTERNAL_MANAGED for cross-region internal layer 7 + * load balancer. + * If loadBalancingScheme is not specified, the backend bucket can be used by + * classic global external load balancers, or global application external load + * balancers, or both. * Check the LoadBalancingScheme enum for the list of possible values. * * Generated from protobuf field optional string load_balancing_scheme = 363890244; */ protected $load_balancing_scheme = null; /** - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * * Generated from protobuf field optional string name = 3373707; */ protected $name = null; /** - * Input only. [Input Only] Additional params passed with the request, but not persisted as part of resource payload. + * Input only. [Input Only] Additional params passed with the request, but not persisted + * as part of resource payload. * * Generated from protobuf field optional .google.cloud.compute.v1.BackendBucketParams params = 78313862; */ @@ -119,16 +136,20 @@ class BackendBucket extends \Google\Protobuf\Internal\Message * @type \Google\Cloud\Compute\V1\BackendBucketCdnPolicy $cdn_policy * Cloud CDN configuration for this BackendBucket. * @type string $compression_mode - * Compress text responses using Brotli or gzip compression, based on the client's Accept-Encoding header. + * Compress text responses using Brotli or gzip compression, based on + * the client's Accept-Encoding header. * Check the CompressionMode enum for the list of possible values. * @type string $creation_timestamp - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * @type array|\Google\Protobuf\Internal\RepeatedField $custom_response_headers * Headers that the Application Load Balancer should add to proxied responses. * @type string $description - * An optional textual description of the resource; provided by the client when the resource is created. + * An optional textual description of the resource; provided by the client + * when the resource is created. * @type string $edge_security_policy - * [Output Only] The resource URL for the edge security policy associated with this backend bucket. + * [Output Only] The resource URL for the edge security policy associated with + * this backend bucket. * @type bool $enable_cdn * If true, enable Cloud CDN for this BackendBucket. * @type int|string $id @@ -136,12 +157,23 @@ class BackendBucket extends \Google\Protobuf\Internal\Message * @type string $kind * Type of the resource. * @type string $load_balancing_scheme - * The value can only be INTERNAL_MANAGED for cross-region internal layer 7 load balancer. If loadBalancingScheme is not specified, the backend bucket can be used by classic global external load balancers, or global application external load balancers, or both. + * The value can only be INTERNAL_MANAGED for cross-region internal layer 7 + * load balancer. + * If loadBalancingScheme is not specified, the backend bucket can be used by + * classic global external load balancers, or global application external load + * balancers, or both. * Check the LoadBalancingScheme enum for the list of possible values. * @type string $name - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * @type \Google\Cloud\Compute\V1\BackendBucketParams $params - * Input only. [Input Only] Additional params passed with the request, but not persisted as part of resource payload. + * Input only. [Input Only] Additional params passed with the request, but not persisted + * as part of resource payload. * @type string $self_link * [Output Only] Server-defined URL for the resource. * @type array<\Google\Cloud\Compute\V1\BackendBucketUsedBy>|\Google\Protobuf\Internal\RepeatedField $used_by @@ -226,7 +258,8 @@ public function setCdnPolicy($var) } /** - * Compress text responses using Brotli or gzip compression, based on the client's Accept-Encoding header. + * Compress text responses using Brotli or gzip compression, based on + * the client's Accept-Encoding header. * Check the CompressionMode enum for the list of possible values. * * Generated from protobuf field optional string compression_mode = 95520988; @@ -248,7 +281,8 @@ public function clearCompressionMode() } /** - * Compress text responses using Brotli or gzip compression, based on the client's Accept-Encoding header. + * Compress text responses using Brotli or gzip compression, based on + * the client's Accept-Encoding header. * Check the CompressionMode enum for the list of possible values. * * Generated from protobuf field optional string compression_mode = 95520988; @@ -264,7 +298,8 @@ public function setCompressionMode($var) } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @return string @@ -285,7 +320,8 @@ public function clearCreationTimestamp() } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @param string $var @@ -326,7 +362,8 @@ public function setCustomResponseHeaders($var) } /** - * An optional textual description of the resource; provided by the client when the resource is created. + * An optional textual description of the resource; provided by the client + * when the resource is created. * * Generated from protobuf field optional string description = 422937596; * @return string @@ -347,7 +384,8 @@ public function clearDescription() } /** - * An optional textual description of the resource; provided by the client when the resource is created. + * An optional textual description of the resource; provided by the client + * when the resource is created. * * Generated from protobuf field optional string description = 422937596; * @param string $var @@ -362,7 +400,8 @@ public function setDescription($var) } /** - * [Output Only] The resource URL for the edge security policy associated with this backend bucket. + * [Output Only] The resource URL for the edge security policy associated with + * this backend bucket. * * Generated from protobuf field optional string edge_security_policy = 41036943; * @return string @@ -383,7 +422,8 @@ public function clearEdgeSecurityPolicy() } /** - * [Output Only] The resource URL for the edge security policy associated with this backend bucket. + * [Output Only] The resource URL for the edge security policy associated with + * this backend bucket. * * Generated from protobuf field optional string edge_security_policy = 41036943; * @param string $var @@ -506,7 +546,11 @@ public function setKind($var) } /** - * The value can only be INTERNAL_MANAGED for cross-region internal layer 7 load balancer. If loadBalancingScheme is not specified, the backend bucket can be used by classic global external load balancers, or global application external load balancers, or both. + * The value can only be INTERNAL_MANAGED for cross-region internal layer 7 + * load balancer. + * If loadBalancingScheme is not specified, the backend bucket can be used by + * classic global external load balancers, or global application external load + * balancers, or both. * Check the LoadBalancingScheme enum for the list of possible values. * * Generated from protobuf field optional string load_balancing_scheme = 363890244; @@ -528,7 +572,11 @@ public function clearLoadBalancingScheme() } /** - * The value can only be INTERNAL_MANAGED for cross-region internal layer 7 load balancer. If loadBalancingScheme is not specified, the backend bucket can be used by classic global external load balancers, or global application external load balancers, or both. + * The value can only be INTERNAL_MANAGED for cross-region internal layer 7 + * load balancer. + * If loadBalancingScheme is not specified, the backend bucket can be used by + * classic global external load balancers, or global application external load + * balancers, or both. * Check the LoadBalancingScheme enum for the list of possible values. * * Generated from protobuf field optional string load_balancing_scheme = 363890244; @@ -544,7 +592,13 @@ public function setLoadBalancingScheme($var) } /** - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * * Generated from protobuf field optional string name = 3373707; * @return string @@ -565,7 +619,13 @@ public function clearName() } /** - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * * Generated from protobuf field optional string name = 3373707; * @param string $var @@ -580,7 +640,8 @@ public function setName($var) } /** - * Input only. [Input Only] Additional params passed with the request, but not persisted as part of resource payload. + * Input only. [Input Only] Additional params passed with the request, but not persisted + * as part of resource payload. * * Generated from protobuf field optional .google.cloud.compute.v1.BackendBucketParams params = 78313862; * @return \Google\Cloud\Compute\V1\BackendBucketParams|null @@ -601,7 +662,8 @@ public function clearParams() } /** - * Input only. [Input Only] Additional params passed with the request, but not persisted as part of resource payload. + * Input only. [Input Only] Additional params passed with the request, but not persisted + * as part of resource payload. * * Generated from protobuf field optional .google.cloud.compute.v1.BackendBucketParams params = 78313862; * @param \Google\Cloud\Compute\V1\BackendBucketParams $var diff --git a/Compute/src/V1/BackendBucket/CompressionMode.php b/Compute/src/V1/BackendBucket/CompressionMode.php index 5f5e122ed152..1e27ad0e4b93 100644 --- a/Compute/src/V1/BackendBucket/CompressionMode.php +++ b/Compute/src/V1/BackendBucket/CompressionMode.php @@ -7,7 +7,8 @@ use UnexpectedValueException; /** - * Compress text responses using Brotli or gzip compression, based on the client's Accept-Encoding header. + * Compress text responses using Brotli or gzip compression, based on + * the client's Accept-Encoding header. * * Protobuf type google.cloud.compute.v1.BackendBucket.CompressionMode */ @@ -20,13 +21,15 @@ class CompressionMode */ const UNDEFINED_COMPRESSION_MODE = 0; /** - * Automatically uses the best compression based on the Accept-Encoding header sent by the client. + * Automatically uses the best compression based on the Accept-Encoding + * header sent by the client. * * Generated from protobuf enum AUTOMATIC = 165298699; */ const AUTOMATIC = 165298699; /** - * Disables compression. Existing compressed responses cached by Cloud CDN will not be served to clients. + * Disables compression. Existing compressed responses cached by + * Cloud CDN will not be served to clients. * * Generated from protobuf enum DISABLED = 516696700; */ diff --git a/Compute/src/V1/BackendBucket/LoadBalancingScheme.php b/Compute/src/V1/BackendBucket/LoadBalancingScheme.php index 6d450051b079..79044ac50b4b 100644 --- a/Compute/src/V1/BackendBucket/LoadBalancingScheme.php +++ b/Compute/src/V1/BackendBucket/LoadBalancingScheme.php @@ -7,7 +7,11 @@ use UnexpectedValueException; /** - * The value can only be INTERNAL_MANAGED for cross-region internal layer 7 load balancer. If loadBalancingScheme is not specified, the backend bucket can be used by classic global external load balancers, or global application external load balancers, or both. + * The value can only be INTERNAL_MANAGED for cross-region internal layer 7 + * load balancer. + * If loadBalancingScheme is not specified, the backend bucket can be used by + * classic global external load balancers, or global application external load + * balancers, or both. * * Protobuf type google.cloud.compute.v1.BackendBucket.LoadBalancingScheme */ diff --git a/Compute/src/V1/BackendBucketCdnPolicy.php b/Compute/src/V1/BackendBucketCdnPolicy.php index 2f30989e39ab..cd191661760d 100644 --- a/Compute/src/V1/BackendBucketCdnPolicy.php +++ b/Compute/src/V1/BackendBucketCdnPolicy.php @@ -16,7 +16,9 @@ class BackendBucketCdnPolicy extends \Google\Protobuf\Internal\Message { /** - * Bypass the cache when the specified request headers are matched - e.g. Pragma or Authorization headers. Up to 5 headers can be specified. The cache is bypassed for all cdnPolicy.cacheMode settings. + * Bypass the cache when the specified request headers are matched - e.g. + * Pragma or Authorization headers. Up to 5 headers can be specified. + * The cache is bypassed for all cdnPolicy.cacheMode settings. * * Generated from protobuf field repeated .google.cloud.compute.v1.BackendBucketCdnPolicyBypassCacheOnRequestHeader bypass_cache_on_request_headers = 486203082; */ @@ -28,56 +30,138 @@ class BackendBucketCdnPolicy extends \Google\Protobuf\Internal\Message */ protected $cache_key_policy = null; /** - * Specifies the cache setting for all responses from this backend. The possible values are: USE_ORIGIN_HEADERS Requires the origin to set valid caching headers to cache content. Responses without these headers will not be cached at Google's edge, and will require a full trip to the origin on every request, potentially impacting performance and increasing load on the origin server. FORCE_CACHE_ALL Cache all content, ignoring any "private", "no-store" or "no-cache" directives in Cache-Control response headers. Warning: this may result in Cloud CDN caching private, per-user (user identifiable) content. CACHE_ALL_STATIC Automatically cache static content, including common image formats, media (video and audio), and web assets (JavaScript and CSS). Requests and responses that are marked as uncacheable, as well as dynamic content (including HTML), will not be cached. If no value is provided for cdnPolicy.cacheMode, it defaults to CACHE_ALL_STATIC. + * Specifies the cache setting for all responses from this backend. + * The possible values are:USE_ORIGIN_HEADERS Requires the origin to set valid caching + * headers to cache content. Responses without these headers will not be + * cached at Google's edge, and will require a full trip to the origin on + * every request, potentially impacting performance and increasing load on + * the origin server.FORCE_CACHE_ALL Cache all content, ignoring any "private", + * "no-store" or "no-cache" directives in Cache-Control response headers. + * Warning: this may result in Cloud CDN caching private, + * per-user (user identifiable) content.CACHE_ALL_STATIC Automatically cache static content, + * including common image formats, media (video and audio), and web assets + * (JavaScript and CSS). Requests and responses that are marked as + * uncacheable, as well as dynamic content (including HTML), will not be + * cached. + * If no value is provided for cdnPolicy.cacheMode, it defaults + * to CACHE_ALL_STATIC. * Check the CacheMode enum for the list of possible values. * * Generated from protobuf field optional string cache_mode = 28877888; */ protected $cache_mode = null; /** - * Specifies a separate client (e.g. browser client) maximum TTL. This is used to clamp the max-age (or Expires) value sent to the client. With FORCE_CACHE_ALL, the lesser of client_ttl and default_ttl is used for the response max-age directive, along with a "public" directive. For cacheable content in CACHE_ALL_STATIC mode, client_ttl clamps the max-age from the origin (if specified), or else sets the response max-age directive to the lesser of the client_ttl and default_ttl, and also ensures a "public" cache-control directive is present. If a client TTL is not specified, a default value (1 hour) will be used. The maximum allowed value is 31,622,400s (1 year). + * Specifies a separate client (e.g. browser client) maximum TTL. This is + * used to clamp the max-age (or Expires) value sent to the client. With + * FORCE_CACHE_ALL, the lesser of client_ttl and default_ttl is used for the + * response max-age directive, along with a "public" directive. For + * cacheable content in CACHE_ALL_STATIC mode, client_ttl clamps the max-age + * from the origin (if specified), or else sets the response max-age + * directive to the lesser of the client_ttl and default_ttl, and also + * ensures a "public" cache-control directive is present. + * If a client TTL is not specified, a default value (1 hour) will be used. + * The maximum allowed value is 31,622,400s (1 year). * * Generated from protobuf field optional int32 client_ttl = 29034360; */ protected $client_ttl = null; /** - * Specifies the default TTL for cached content served by this origin for responses that do not have an existing valid TTL (max-age or s-maxage). Setting a TTL of "0" means "always revalidate". The value of defaultTTL cannot be set to a value greater than that of maxTTL, but can be equal. When the cacheMode is set to FORCE_CACHE_ALL, the defaultTTL will overwrite the TTL set in all responses. The maximum allowed value is 31,622,400s (1 year), noting that infrequently accessed objects may be evicted from the cache before the defined TTL. + * Specifies the default TTL for cached content served by this origin for + * responses that do not have an existing valid TTL (max-age or s-maxage). + * Setting a TTL of "0" means "always revalidate". + * The value of defaultTTL cannot be set to a value greater than that of + * maxTTL, but can be equal. + * When the cacheMode is set to FORCE_CACHE_ALL, the defaultTTL + * will overwrite the TTL set in all responses. The maximum allowed value is + * 31,622,400s (1 year), noting that infrequently accessed objects may be + * evicted from the cache before the defined TTL. * * Generated from protobuf field optional int32 default_ttl = 100253422; */ protected $default_ttl = null; /** - * Specifies the maximum allowed TTL for cached content served by this origin. Cache directives that attempt to set a max-age or s-maxage higher than this, or an Expires header more than maxTTL seconds in the future will be capped at the value of maxTTL, as if it were the value of an s-maxage Cache-Control directive. Headers sent to the client will not be modified. Setting a TTL of "0" means "always revalidate". The maximum allowed value is 31,622,400s (1 year), noting that infrequently accessed objects may be evicted from the cache before the defined TTL. + * Specifies the maximum allowed TTL for cached content served by this + * origin. + * Cache directives that attempt to set a max-age or s-maxage higher than + * this, or an Expires header more than maxTTL seconds in the future will + * be capped at the value of maxTTL, as if it were the value of an + * s-maxage Cache-Control directive. + * Headers sent to the client will not be modified. + * Setting a TTL of "0" means "always revalidate". + * The maximum allowed value is 31,622,400s (1 year), noting that + * infrequently accessed objects may be evicted from the cache before + * the defined TTL. * * Generated from protobuf field optional int32 max_ttl = 307578001; */ protected $max_ttl = null; /** - * Negative caching allows per-status code TTLs to be set, in order to apply fine-grained caching for common errors or redirects. This can reduce the load on your origin and improve end-user experience by reducing response latency. When the cache mode is set to CACHE_ALL_STATIC or USE_ORIGIN_HEADERS, negative caching applies to responses with the specified response code that lack any Cache-Control, Expires, or Pragma: no-cache directives. When the cache mode is set to FORCE_CACHE_ALL, negative caching applies to all responses with the specified response code, and override any caching headers. By default, Cloud CDN will apply the following default TTLs to these status codes: HTTP 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m HTTP 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s HTTP 405 (Method Not Found), 501 (Not Implemented): 60s. These defaults can be overridden in negative_caching_policy. + * Negative caching allows per-status code TTLs to be set, in order + * to apply fine-grained caching for common errors or redirects. + * This can reduce the load on your origin and improve end-user + * experience by reducing response latency. + * When the cache mode is set to CACHE_ALL_STATIC or USE_ORIGIN_HEADERS, + * negative caching applies to responses with the specified response code + * that lack any Cache-Control, Expires, or Pragma: no-cache directives. + * When the cache mode is set to FORCE_CACHE_ALL, negative caching applies + * to all responses with the specified response code, and override any + * caching headers. + * By default, Cloud CDN will apply the following default TTLs to these + * status codes: + * HTTP 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m + * HTTP 404 (Not Found), 410 (Gone), + * 451 (Unavailable For Legal Reasons): 120s + * HTTP 405 (Method Not Found), 501 (Not Implemented): 60s. + * These defaults can be overridden in negative_caching_policy. * * Generated from protobuf field optional bool negative_caching = 336110005; */ protected $negative_caching = null; /** - * Sets a cache TTL for the specified HTTP status code. negative_caching must be enabled to configure negative_caching_policy. Omitting the policy and leaving negative_caching enabled will use Cloud CDN's default cache TTLs. Note that when specifying an explicit negative_caching_policy, you should take care to specify a cache TTL for all response codes that you wish to cache. Cloud CDN will not apply any default negative caching when a policy exists. + * Sets a cache TTL for the specified HTTP status code. + * negative_caching must be enabled to configure negative_caching_policy. + * Omitting the policy and leaving negative_caching enabled will use + * Cloud CDN's default cache TTLs. + * Note that when specifying an explicit negative_caching_policy, you + * should take care to specify a cache TTL for all response codes + * that you wish to cache. Cloud CDN will not apply any default + * negative caching when a policy exists. * * Generated from protobuf field repeated .google.cloud.compute.v1.BackendBucketCdnPolicyNegativeCachingPolicy negative_caching_policy = 155359996; */ private $negative_caching_policy; /** - * If true then Cloud CDN will combine multiple concurrent cache fill requests into a small number of requests to the origin. + * If true then Cloud CDN will combine multiple concurrent cache fill + * requests into a small number of requests to the origin. * * Generated from protobuf field optional bool request_coalescing = 532808276; */ protected $request_coalescing = null; /** - * Serve existing content from the cache (if available) when revalidating content with the origin, or when an error is encountered when refreshing the cache. This setting defines the default "max-stale" duration for any cached responses that do not specify a max-stale directive. Stale responses that exceed the TTL configured here will not be served. The default limit (max-stale) is 86400s (1 day), which will allow stale content to be served up to this limit beyond the max-age (or s-maxage) of a cached response. The maximum allowed value is 604800 (1 week). Set this to zero (0) to disable serve-while-stale. + * Serve existing content from the cache (if available) when revalidating + * content with the origin, or when an error is encountered when refreshing + * the cache. + * This setting defines the default "max-stale" duration for any cached + * responses that do not specify a max-stale directive. Stale responses that + * exceed the TTL configured here will not be served. The default limit + * (max-stale) is 86400s (1 day), which will allow stale content to be + * served up to this limit beyond the max-age (or s-maxage) of a cached + * response. + * The maximum allowed value is 604800 (1 week). + * Set this to zero (0) to disable serve-while-stale. * * Generated from protobuf field optional int32 serve_while_stale = 236682203; */ protected $serve_while_stale = null; /** - * Maximum number of seconds the response to a signed URL request will be considered fresh. After this time period, the response will be revalidated before being served. Defaults to 1hr (3600s). When serving responses to signed URL requests, Cloud CDN will internally behave as though all responses from this backend had a "Cache-Control: public, max-age=[TTL]" header, regardless of any existing Cache-Control header. The actual headers served in responses will not be altered. + * Maximum number of seconds the response to a signed URL request will be + * considered fresh. After this time period, the response will be + * revalidated before being served. Defaults to 1hr (3600s). When serving + * responses to signed URL requests, Cloud CDN will internally behave as + * though all responses from this backend had a "Cache-Control: + * public, max-age=[TTL]" header, regardless of any existing + * Cache-Control header. The actual headers served in responses will not be + * altered. * * Generated from protobuf field optional int64 signed_url_cache_max_age_sec = 269374534; */ @@ -96,28 +180,112 @@ class BackendBucketCdnPolicy extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type array<\Google\Cloud\Compute\V1\BackendBucketCdnPolicyBypassCacheOnRequestHeader>|\Google\Protobuf\Internal\RepeatedField $bypass_cache_on_request_headers - * Bypass the cache when the specified request headers are matched - e.g. Pragma or Authorization headers. Up to 5 headers can be specified. The cache is bypassed for all cdnPolicy.cacheMode settings. + * Bypass the cache when the specified request headers are matched - e.g. + * Pragma or Authorization headers. Up to 5 headers can be specified. + * The cache is bypassed for all cdnPolicy.cacheMode settings. * @type \Google\Cloud\Compute\V1\BackendBucketCdnPolicyCacheKeyPolicy $cache_key_policy * The CacheKeyPolicy for this CdnPolicy. * @type string $cache_mode - * Specifies the cache setting for all responses from this backend. The possible values are: USE_ORIGIN_HEADERS Requires the origin to set valid caching headers to cache content. Responses without these headers will not be cached at Google's edge, and will require a full trip to the origin on every request, potentially impacting performance and increasing load on the origin server. FORCE_CACHE_ALL Cache all content, ignoring any "private", "no-store" or "no-cache" directives in Cache-Control response headers. Warning: this may result in Cloud CDN caching private, per-user (user identifiable) content. CACHE_ALL_STATIC Automatically cache static content, including common image formats, media (video and audio), and web assets (JavaScript and CSS). Requests and responses that are marked as uncacheable, as well as dynamic content (including HTML), will not be cached. If no value is provided for cdnPolicy.cacheMode, it defaults to CACHE_ALL_STATIC. + * Specifies the cache setting for all responses from this backend. + * The possible values are:USE_ORIGIN_HEADERS Requires the origin to set valid caching + * headers to cache content. Responses without these headers will not be + * cached at Google's edge, and will require a full trip to the origin on + * every request, potentially impacting performance and increasing load on + * the origin server.FORCE_CACHE_ALL Cache all content, ignoring any "private", + * "no-store" or "no-cache" directives in Cache-Control response headers. + * Warning: this may result in Cloud CDN caching private, + * per-user (user identifiable) content.CACHE_ALL_STATIC Automatically cache static content, + * including common image formats, media (video and audio), and web assets + * (JavaScript and CSS). Requests and responses that are marked as + * uncacheable, as well as dynamic content (including HTML), will not be + * cached. + * If no value is provided for cdnPolicy.cacheMode, it defaults + * to CACHE_ALL_STATIC. * Check the CacheMode enum for the list of possible values. * @type int $client_ttl - * Specifies a separate client (e.g. browser client) maximum TTL. This is used to clamp the max-age (or Expires) value sent to the client. With FORCE_CACHE_ALL, the lesser of client_ttl and default_ttl is used for the response max-age directive, along with a "public" directive. For cacheable content in CACHE_ALL_STATIC mode, client_ttl clamps the max-age from the origin (if specified), or else sets the response max-age directive to the lesser of the client_ttl and default_ttl, and also ensures a "public" cache-control directive is present. If a client TTL is not specified, a default value (1 hour) will be used. The maximum allowed value is 31,622,400s (1 year). + * Specifies a separate client (e.g. browser client) maximum TTL. This is + * used to clamp the max-age (or Expires) value sent to the client. With + * FORCE_CACHE_ALL, the lesser of client_ttl and default_ttl is used for the + * response max-age directive, along with a "public" directive. For + * cacheable content in CACHE_ALL_STATIC mode, client_ttl clamps the max-age + * from the origin (if specified), or else sets the response max-age + * directive to the lesser of the client_ttl and default_ttl, and also + * ensures a "public" cache-control directive is present. + * If a client TTL is not specified, a default value (1 hour) will be used. + * The maximum allowed value is 31,622,400s (1 year). * @type int $default_ttl - * Specifies the default TTL for cached content served by this origin for responses that do not have an existing valid TTL (max-age or s-maxage). Setting a TTL of "0" means "always revalidate". The value of defaultTTL cannot be set to a value greater than that of maxTTL, but can be equal. When the cacheMode is set to FORCE_CACHE_ALL, the defaultTTL will overwrite the TTL set in all responses. The maximum allowed value is 31,622,400s (1 year), noting that infrequently accessed objects may be evicted from the cache before the defined TTL. + * Specifies the default TTL for cached content served by this origin for + * responses that do not have an existing valid TTL (max-age or s-maxage). + * Setting a TTL of "0" means "always revalidate". + * The value of defaultTTL cannot be set to a value greater than that of + * maxTTL, but can be equal. + * When the cacheMode is set to FORCE_CACHE_ALL, the defaultTTL + * will overwrite the TTL set in all responses. The maximum allowed value is + * 31,622,400s (1 year), noting that infrequently accessed objects may be + * evicted from the cache before the defined TTL. * @type int $max_ttl - * Specifies the maximum allowed TTL for cached content served by this origin. Cache directives that attempt to set a max-age or s-maxage higher than this, or an Expires header more than maxTTL seconds in the future will be capped at the value of maxTTL, as if it were the value of an s-maxage Cache-Control directive. Headers sent to the client will not be modified. Setting a TTL of "0" means "always revalidate". The maximum allowed value is 31,622,400s (1 year), noting that infrequently accessed objects may be evicted from the cache before the defined TTL. + * Specifies the maximum allowed TTL for cached content served by this + * origin. + * Cache directives that attempt to set a max-age or s-maxage higher than + * this, or an Expires header more than maxTTL seconds in the future will + * be capped at the value of maxTTL, as if it were the value of an + * s-maxage Cache-Control directive. + * Headers sent to the client will not be modified. + * Setting a TTL of "0" means "always revalidate". + * The maximum allowed value is 31,622,400s (1 year), noting that + * infrequently accessed objects may be evicted from the cache before + * the defined TTL. * @type bool $negative_caching - * Negative caching allows per-status code TTLs to be set, in order to apply fine-grained caching for common errors or redirects. This can reduce the load on your origin and improve end-user experience by reducing response latency. When the cache mode is set to CACHE_ALL_STATIC or USE_ORIGIN_HEADERS, negative caching applies to responses with the specified response code that lack any Cache-Control, Expires, or Pragma: no-cache directives. When the cache mode is set to FORCE_CACHE_ALL, negative caching applies to all responses with the specified response code, and override any caching headers. By default, Cloud CDN will apply the following default TTLs to these status codes: HTTP 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m HTTP 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s HTTP 405 (Method Not Found), 501 (Not Implemented): 60s. These defaults can be overridden in negative_caching_policy. + * Negative caching allows per-status code TTLs to be set, in order + * to apply fine-grained caching for common errors or redirects. + * This can reduce the load on your origin and improve end-user + * experience by reducing response latency. + * When the cache mode is set to CACHE_ALL_STATIC or USE_ORIGIN_HEADERS, + * negative caching applies to responses with the specified response code + * that lack any Cache-Control, Expires, or Pragma: no-cache directives. + * When the cache mode is set to FORCE_CACHE_ALL, negative caching applies + * to all responses with the specified response code, and override any + * caching headers. + * By default, Cloud CDN will apply the following default TTLs to these + * status codes: + * HTTP 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m + * HTTP 404 (Not Found), 410 (Gone), + * 451 (Unavailable For Legal Reasons): 120s + * HTTP 405 (Method Not Found), 501 (Not Implemented): 60s. + * These defaults can be overridden in negative_caching_policy. * @type array<\Google\Cloud\Compute\V1\BackendBucketCdnPolicyNegativeCachingPolicy>|\Google\Protobuf\Internal\RepeatedField $negative_caching_policy - * Sets a cache TTL for the specified HTTP status code. negative_caching must be enabled to configure negative_caching_policy. Omitting the policy and leaving negative_caching enabled will use Cloud CDN's default cache TTLs. Note that when specifying an explicit negative_caching_policy, you should take care to specify a cache TTL for all response codes that you wish to cache. Cloud CDN will not apply any default negative caching when a policy exists. + * Sets a cache TTL for the specified HTTP status code. + * negative_caching must be enabled to configure negative_caching_policy. + * Omitting the policy and leaving negative_caching enabled will use + * Cloud CDN's default cache TTLs. + * Note that when specifying an explicit negative_caching_policy, you + * should take care to specify a cache TTL for all response codes + * that you wish to cache. Cloud CDN will not apply any default + * negative caching when a policy exists. * @type bool $request_coalescing - * If true then Cloud CDN will combine multiple concurrent cache fill requests into a small number of requests to the origin. + * If true then Cloud CDN will combine multiple concurrent cache fill + * requests into a small number of requests to the origin. * @type int $serve_while_stale - * Serve existing content from the cache (if available) when revalidating content with the origin, or when an error is encountered when refreshing the cache. This setting defines the default "max-stale" duration for any cached responses that do not specify a max-stale directive. Stale responses that exceed the TTL configured here will not be served. The default limit (max-stale) is 86400s (1 day), which will allow stale content to be served up to this limit beyond the max-age (or s-maxage) of a cached response. The maximum allowed value is 604800 (1 week). Set this to zero (0) to disable serve-while-stale. + * Serve existing content from the cache (if available) when revalidating + * content with the origin, or when an error is encountered when refreshing + * the cache. + * This setting defines the default "max-stale" duration for any cached + * responses that do not specify a max-stale directive. Stale responses that + * exceed the TTL configured here will not be served. The default limit + * (max-stale) is 86400s (1 day), which will allow stale content to be + * served up to this limit beyond the max-age (or s-maxage) of a cached + * response. + * The maximum allowed value is 604800 (1 week). + * Set this to zero (0) to disable serve-while-stale. * @type int|string $signed_url_cache_max_age_sec - * Maximum number of seconds the response to a signed URL request will be considered fresh. After this time period, the response will be revalidated before being served. Defaults to 1hr (3600s). When serving responses to signed URL requests, Cloud CDN will internally behave as though all responses from this backend had a "Cache-Control: public, max-age=[TTL]" header, regardless of any existing Cache-Control header. The actual headers served in responses will not be altered. + * Maximum number of seconds the response to a signed URL request will be + * considered fresh. After this time period, the response will be + * revalidated before being served. Defaults to 1hr (3600s). When serving + * responses to signed URL requests, Cloud CDN will internally behave as + * though all responses from this backend had a "Cache-Control: + * public, max-age=[TTL]" header, regardless of any existing + * Cache-Control header. The actual headers served in responses will not be + * altered. * @type array|\Google\Protobuf\Internal\RepeatedField $signed_url_key_names * [Output Only] Names of the keys for signing request URLs. * } @@ -128,7 +296,9 @@ public function __construct($data = NULL) { } /** - * Bypass the cache when the specified request headers are matched - e.g. Pragma or Authorization headers. Up to 5 headers can be specified. The cache is bypassed for all cdnPolicy.cacheMode settings. + * Bypass the cache when the specified request headers are matched - e.g. + * Pragma or Authorization headers. Up to 5 headers can be specified. + * The cache is bypassed for all cdnPolicy.cacheMode settings. * * Generated from protobuf field repeated .google.cloud.compute.v1.BackendBucketCdnPolicyBypassCacheOnRequestHeader bypass_cache_on_request_headers = 486203082; * @return \Google\Protobuf\Internal\RepeatedField @@ -139,7 +309,9 @@ public function getBypassCacheOnRequestHeaders() } /** - * Bypass the cache when the specified request headers are matched - e.g. Pragma or Authorization headers. Up to 5 headers can be specified. The cache is bypassed for all cdnPolicy.cacheMode settings. + * Bypass the cache when the specified request headers are matched - e.g. + * Pragma or Authorization headers. Up to 5 headers can be specified. + * The cache is bypassed for all cdnPolicy.cacheMode settings. * * Generated from protobuf field repeated .google.cloud.compute.v1.BackendBucketCdnPolicyBypassCacheOnRequestHeader bypass_cache_on_request_headers = 486203082; * @param array<\Google\Cloud\Compute\V1\BackendBucketCdnPolicyBypassCacheOnRequestHeader>|\Google\Protobuf\Internal\RepeatedField $var @@ -190,7 +362,21 @@ public function setCacheKeyPolicy($var) } /** - * Specifies the cache setting for all responses from this backend. The possible values are: USE_ORIGIN_HEADERS Requires the origin to set valid caching headers to cache content. Responses without these headers will not be cached at Google's edge, and will require a full trip to the origin on every request, potentially impacting performance and increasing load on the origin server. FORCE_CACHE_ALL Cache all content, ignoring any "private", "no-store" or "no-cache" directives in Cache-Control response headers. Warning: this may result in Cloud CDN caching private, per-user (user identifiable) content. CACHE_ALL_STATIC Automatically cache static content, including common image formats, media (video and audio), and web assets (JavaScript and CSS). Requests and responses that are marked as uncacheable, as well as dynamic content (including HTML), will not be cached. If no value is provided for cdnPolicy.cacheMode, it defaults to CACHE_ALL_STATIC. + * Specifies the cache setting for all responses from this backend. + * The possible values are:USE_ORIGIN_HEADERS Requires the origin to set valid caching + * headers to cache content. Responses without these headers will not be + * cached at Google's edge, and will require a full trip to the origin on + * every request, potentially impacting performance and increasing load on + * the origin server.FORCE_CACHE_ALL Cache all content, ignoring any "private", + * "no-store" or "no-cache" directives in Cache-Control response headers. + * Warning: this may result in Cloud CDN caching private, + * per-user (user identifiable) content.CACHE_ALL_STATIC Automatically cache static content, + * including common image formats, media (video and audio), and web assets + * (JavaScript and CSS). Requests and responses that are marked as + * uncacheable, as well as dynamic content (including HTML), will not be + * cached. + * If no value is provided for cdnPolicy.cacheMode, it defaults + * to CACHE_ALL_STATIC. * Check the CacheMode enum for the list of possible values. * * Generated from protobuf field optional string cache_mode = 28877888; @@ -212,7 +398,21 @@ public function clearCacheMode() } /** - * Specifies the cache setting for all responses from this backend. The possible values are: USE_ORIGIN_HEADERS Requires the origin to set valid caching headers to cache content. Responses without these headers will not be cached at Google's edge, and will require a full trip to the origin on every request, potentially impacting performance and increasing load on the origin server. FORCE_CACHE_ALL Cache all content, ignoring any "private", "no-store" or "no-cache" directives in Cache-Control response headers. Warning: this may result in Cloud CDN caching private, per-user (user identifiable) content. CACHE_ALL_STATIC Automatically cache static content, including common image formats, media (video and audio), and web assets (JavaScript and CSS). Requests and responses that are marked as uncacheable, as well as dynamic content (including HTML), will not be cached. If no value is provided for cdnPolicy.cacheMode, it defaults to CACHE_ALL_STATIC. + * Specifies the cache setting for all responses from this backend. + * The possible values are:USE_ORIGIN_HEADERS Requires the origin to set valid caching + * headers to cache content. Responses without these headers will not be + * cached at Google's edge, and will require a full trip to the origin on + * every request, potentially impacting performance and increasing load on + * the origin server.FORCE_CACHE_ALL Cache all content, ignoring any "private", + * "no-store" or "no-cache" directives in Cache-Control response headers. + * Warning: this may result in Cloud CDN caching private, + * per-user (user identifiable) content.CACHE_ALL_STATIC Automatically cache static content, + * including common image formats, media (video and audio), and web assets + * (JavaScript and CSS). Requests and responses that are marked as + * uncacheable, as well as dynamic content (including HTML), will not be + * cached. + * If no value is provided for cdnPolicy.cacheMode, it defaults + * to CACHE_ALL_STATIC. * Check the CacheMode enum for the list of possible values. * * Generated from protobuf field optional string cache_mode = 28877888; @@ -228,7 +428,16 @@ public function setCacheMode($var) } /** - * Specifies a separate client (e.g. browser client) maximum TTL. This is used to clamp the max-age (or Expires) value sent to the client. With FORCE_CACHE_ALL, the lesser of client_ttl and default_ttl is used for the response max-age directive, along with a "public" directive. For cacheable content in CACHE_ALL_STATIC mode, client_ttl clamps the max-age from the origin (if specified), or else sets the response max-age directive to the lesser of the client_ttl and default_ttl, and also ensures a "public" cache-control directive is present. If a client TTL is not specified, a default value (1 hour) will be used. The maximum allowed value is 31,622,400s (1 year). + * Specifies a separate client (e.g. browser client) maximum TTL. This is + * used to clamp the max-age (or Expires) value sent to the client. With + * FORCE_CACHE_ALL, the lesser of client_ttl and default_ttl is used for the + * response max-age directive, along with a "public" directive. For + * cacheable content in CACHE_ALL_STATIC mode, client_ttl clamps the max-age + * from the origin (if specified), or else sets the response max-age + * directive to the lesser of the client_ttl and default_ttl, and also + * ensures a "public" cache-control directive is present. + * If a client TTL is not specified, a default value (1 hour) will be used. + * The maximum allowed value is 31,622,400s (1 year). * * Generated from protobuf field optional int32 client_ttl = 29034360; * @return int @@ -249,7 +458,16 @@ public function clearClientTtl() } /** - * Specifies a separate client (e.g. browser client) maximum TTL. This is used to clamp the max-age (or Expires) value sent to the client. With FORCE_CACHE_ALL, the lesser of client_ttl and default_ttl is used for the response max-age directive, along with a "public" directive. For cacheable content in CACHE_ALL_STATIC mode, client_ttl clamps the max-age from the origin (if specified), or else sets the response max-age directive to the lesser of the client_ttl and default_ttl, and also ensures a "public" cache-control directive is present. If a client TTL is not specified, a default value (1 hour) will be used. The maximum allowed value is 31,622,400s (1 year). + * Specifies a separate client (e.g. browser client) maximum TTL. This is + * used to clamp the max-age (or Expires) value sent to the client. With + * FORCE_CACHE_ALL, the lesser of client_ttl and default_ttl is used for the + * response max-age directive, along with a "public" directive. For + * cacheable content in CACHE_ALL_STATIC mode, client_ttl clamps the max-age + * from the origin (if specified), or else sets the response max-age + * directive to the lesser of the client_ttl and default_ttl, and also + * ensures a "public" cache-control directive is present. + * If a client TTL is not specified, a default value (1 hour) will be used. + * The maximum allowed value is 31,622,400s (1 year). * * Generated from protobuf field optional int32 client_ttl = 29034360; * @param int $var @@ -264,7 +482,15 @@ public function setClientTtl($var) } /** - * Specifies the default TTL for cached content served by this origin for responses that do not have an existing valid TTL (max-age or s-maxage). Setting a TTL of "0" means "always revalidate". The value of defaultTTL cannot be set to a value greater than that of maxTTL, but can be equal. When the cacheMode is set to FORCE_CACHE_ALL, the defaultTTL will overwrite the TTL set in all responses. The maximum allowed value is 31,622,400s (1 year), noting that infrequently accessed objects may be evicted from the cache before the defined TTL. + * Specifies the default TTL for cached content served by this origin for + * responses that do not have an existing valid TTL (max-age or s-maxage). + * Setting a TTL of "0" means "always revalidate". + * The value of defaultTTL cannot be set to a value greater than that of + * maxTTL, but can be equal. + * When the cacheMode is set to FORCE_CACHE_ALL, the defaultTTL + * will overwrite the TTL set in all responses. The maximum allowed value is + * 31,622,400s (1 year), noting that infrequently accessed objects may be + * evicted from the cache before the defined TTL. * * Generated from protobuf field optional int32 default_ttl = 100253422; * @return int @@ -285,7 +511,15 @@ public function clearDefaultTtl() } /** - * Specifies the default TTL for cached content served by this origin for responses that do not have an existing valid TTL (max-age or s-maxage). Setting a TTL of "0" means "always revalidate". The value of defaultTTL cannot be set to a value greater than that of maxTTL, but can be equal. When the cacheMode is set to FORCE_CACHE_ALL, the defaultTTL will overwrite the TTL set in all responses. The maximum allowed value is 31,622,400s (1 year), noting that infrequently accessed objects may be evicted from the cache before the defined TTL. + * Specifies the default TTL for cached content served by this origin for + * responses that do not have an existing valid TTL (max-age or s-maxage). + * Setting a TTL of "0" means "always revalidate". + * The value of defaultTTL cannot be set to a value greater than that of + * maxTTL, but can be equal. + * When the cacheMode is set to FORCE_CACHE_ALL, the defaultTTL + * will overwrite the TTL set in all responses. The maximum allowed value is + * 31,622,400s (1 year), noting that infrequently accessed objects may be + * evicted from the cache before the defined TTL. * * Generated from protobuf field optional int32 default_ttl = 100253422; * @param int $var @@ -300,7 +534,17 @@ public function setDefaultTtl($var) } /** - * Specifies the maximum allowed TTL for cached content served by this origin. Cache directives that attempt to set a max-age or s-maxage higher than this, or an Expires header more than maxTTL seconds in the future will be capped at the value of maxTTL, as if it were the value of an s-maxage Cache-Control directive. Headers sent to the client will not be modified. Setting a TTL of "0" means "always revalidate". The maximum allowed value is 31,622,400s (1 year), noting that infrequently accessed objects may be evicted from the cache before the defined TTL. + * Specifies the maximum allowed TTL for cached content served by this + * origin. + * Cache directives that attempt to set a max-age or s-maxage higher than + * this, or an Expires header more than maxTTL seconds in the future will + * be capped at the value of maxTTL, as if it were the value of an + * s-maxage Cache-Control directive. + * Headers sent to the client will not be modified. + * Setting a TTL of "0" means "always revalidate". + * The maximum allowed value is 31,622,400s (1 year), noting that + * infrequently accessed objects may be evicted from the cache before + * the defined TTL. * * Generated from protobuf field optional int32 max_ttl = 307578001; * @return int @@ -321,7 +565,17 @@ public function clearMaxTtl() } /** - * Specifies the maximum allowed TTL for cached content served by this origin. Cache directives that attempt to set a max-age or s-maxage higher than this, or an Expires header more than maxTTL seconds in the future will be capped at the value of maxTTL, as if it were the value of an s-maxage Cache-Control directive. Headers sent to the client will not be modified. Setting a TTL of "0" means "always revalidate". The maximum allowed value is 31,622,400s (1 year), noting that infrequently accessed objects may be evicted from the cache before the defined TTL. + * Specifies the maximum allowed TTL for cached content served by this + * origin. + * Cache directives that attempt to set a max-age or s-maxage higher than + * this, or an Expires header more than maxTTL seconds in the future will + * be capped at the value of maxTTL, as if it were the value of an + * s-maxage Cache-Control directive. + * Headers sent to the client will not be modified. + * Setting a TTL of "0" means "always revalidate". + * The maximum allowed value is 31,622,400s (1 year), noting that + * infrequently accessed objects may be evicted from the cache before + * the defined TTL. * * Generated from protobuf field optional int32 max_ttl = 307578001; * @param int $var @@ -336,7 +590,23 @@ public function setMaxTtl($var) } /** - * Negative caching allows per-status code TTLs to be set, in order to apply fine-grained caching for common errors or redirects. This can reduce the load on your origin and improve end-user experience by reducing response latency. When the cache mode is set to CACHE_ALL_STATIC or USE_ORIGIN_HEADERS, negative caching applies to responses with the specified response code that lack any Cache-Control, Expires, or Pragma: no-cache directives. When the cache mode is set to FORCE_CACHE_ALL, negative caching applies to all responses with the specified response code, and override any caching headers. By default, Cloud CDN will apply the following default TTLs to these status codes: HTTP 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m HTTP 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s HTTP 405 (Method Not Found), 501 (Not Implemented): 60s. These defaults can be overridden in negative_caching_policy. + * Negative caching allows per-status code TTLs to be set, in order + * to apply fine-grained caching for common errors or redirects. + * This can reduce the load on your origin and improve end-user + * experience by reducing response latency. + * When the cache mode is set to CACHE_ALL_STATIC or USE_ORIGIN_HEADERS, + * negative caching applies to responses with the specified response code + * that lack any Cache-Control, Expires, or Pragma: no-cache directives. + * When the cache mode is set to FORCE_CACHE_ALL, negative caching applies + * to all responses with the specified response code, and override any + * caching headers. + * By default, Cloud CDN will apply the following default TTLs to these + * status codes: + * HTTP 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m + * HTTP 404 (Not Found), 410 (Gone), + * 451 (Unavailable For Legal Reasons): 120s + * HTTP 405 (Method Not Found), 501 (Not Implemented): 60s. + * These defaults can be overridden in negative_caching_policy. * * Generated from protobuf field optional bool negative_caching = 336110005; * @return bool @@ -357,7 +627,23 @@ public function clearNegativeCaching() } /** - * Negative caching allows per-status code TTLs to be set, in order to apply fine-grained caching for common errors or redirects. This can reduce the load on your origin and improve end-user experience by reducing response latency. When the cache mode is set to CACHE_ALL_STATIC or USE_ORIGIN_HEADERS, negative caching applies to responses with the specified response code that lack any Cache-Control, Expires, or Pragma: no-cache directives. When the cache mode is set to FORCE_CACHE_ALL, negative caching applies to all responses with the specified response code, and override any caching headers. By default, Cloud CDN will apply the following default TTLs to these status codes: HTTP 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m HTTP 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s HTTP 405 (Method Not Found), 501 (Not Implemented): 60s. These defaults can be overridden in negative_caching_policy. + * Negative caching allows per-status code TTLs to be set, in order + * to apply fine-grained caching for common errors or redirects. + * This can reduce the load on your origin and improve end-user + * experience by reducing response latency. + * When the cache mode is set to CACHE_ALL_STATIC or USE_ORIGIN_HEADERS, + * negative caching applies to responses with the specified response code + * that lack any Cache-Control, Expires, or Pragma: no-cache directives. + * When the cache mode is set to FORCE_CACHE_ALL, negative caching applies + * to all responses with the specified response code, and override any + * caching headers. + * By default, Cloud CDN will apply the following default TTLs to these + * status codes: + * HTTP 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m + * HTTP 404 (Not Found), 410 (Gone), + * 451 (Unavailable For Legal Reasons): 120s + * HTTP 405 (Method Not Found), 501 (Not Implemented): 60s. + * These defaults can be overridden in negative_caching_policy. * * Generated from protobuf field optional bool negative_caching = 336110005; * @param bool $var @@ -372,7 +658,14 @@ public function setNegativeCaching($var) } /** - * Sets a cache TTL for the specified HTTP status code. negative_caching must be enabled to configure negative_caching_policy. Omitting the policy and leaving negative_caching enabled will use Cloud CDN's default cache TTLs. Note that when specifying an explicit negative_caching_policy, you should take care to specify a cache TTL for all response codes that you wish to cache. Cloud CDN will not apply any default negative caching when a policy exists. + * Sets a cache TTL for the specified HTTP status code. + * negative_caching must be enabled to configure negative_caching_policy. + * Omitting the policy and leaving negative_caching enabled will use + * Cloud CDN's default cache TTLs. + * Note that when specifying an explicit negative_caching_policy, you + * should take care to specify a cache TTL for all response codes + * that you wish to cache. Cloud CDN will not apply any default + * negative caching when a policy exists. * * Generated from protobuf field repeated .google.cloud.compute.v1.BackendBucketCdnPolicyNegativeCachingPolicy negative_caching_policy = 155359996; * @return \Google\Protobuf\Internal\RepeatedField @@ -383,7 +676,14 @@ public function getNegativeCachingPolicy() } /** - * Sets a cache TTL for the specified HTTP status code. negative_caching must be enabled to configure negative_caching_policy. Omitting the policy and leaving negative_caching enabled will use Cloud CDN's default cache TTLs. Note that when specifying an explicit negative_caching_policy, you should take care to specify a cache TTL for all response codes that you wish to cache. Cloud CDN will not apply any default negative caching when a policy exists. + * Sets a cache TTL for the specified HTTP status code. + * negative_caching must be enabled to configure negative_caching_policy. + * Omitting the policy and leaving negative_caching enabled will use + * Cloud CDN's default cache TTLs. + * Note that when specifying an explicit negative_caching_policy, you + * should take care to specify a cache TTL for all response codes + * that you wish to cache. Cloud CDN will not apply any default + * negative caching when a policy exists. * * Generated from protobuf field repeated .google.cloud.compute.v1.BackendBucketCdnPolicyNegativeCachingPolicy negative_caching_policy = 155359996; * @param array<\Google\Cloud\Compute\V1\BackendBucketCdnPolicyNegativeCachingPolicy>|\Google\Protobuf\Internal\RepeatedField $var @@ -398,7 +698,8 @@ public function setNegativeCachingPolicy($var) } /** - * If true then Cloud CDN will combine multiple concurrent cache fill requests into a small number of requests to the origin. + * If true then Cloud CDN will combine multiple concurrent cache fill + * requests into a small number of requests to the origin. * * Generated from protobuf field optional bool request_coalescing = 532808276; * @return bool @@ -419,7 +720,8 @@ public function clearRequestCoalescing() } /** - * If true then Cloud CDN will combine multiple concurrent cache fill requests into a small number of requests to the origin. + * If true then Cloud CDN will combine multiple concurrent cache fill + * requests into a small number of requests to the origin. * * Generated from protobuf field optional bool request_coalescing = 532808276; * @param bool $var @@ -434,7 +736,17 @@ public function setRequestCoalescing($var) } /** - * Serve existing content from the cache (if available) when revalidating content with the origin, or when an error is encountered when refreshing the cache. This setting defines the default "max-stale" duration for any cached responses that do not specify a max-stale directive. Stale responses that exceed the TTL configured here will not be served. The default limit (max-stale) is 86400s (1 day), which will allow stale content to be served up to this limit beyond the max-age (or s-maxage) of a cached response. The maximum allowed value is 604800 (1 week). Set this to zero (0) to disable serve-while-stale. + * Serve existing content from the cache (if available) when revalidating + * content with the origin, or when an error is encountered when refreshing + * the cache. + * This setting defines the default "max-stale" duration for any cached + * responses that do not specify a max-stale directive. Stale responses that + * exceed the TTL configured here will not be served. The default limit + * (max-stale) is 86400s (1 day), which will allow stale content to be + * served up to this limit beyond the max-age (or s-maxage) of a cached + * response. + * The maximum allowed value is 604800 (1 week). + * Set this to zero (0) to disable serve-while-stale. * * Generated from protobuf field optional int32 serve_while_stale = 236682203; * @return int @@ -455,7 +767,17 @@ public function clearServeWhileStale() } /** - * Serve existing content from the cache (if available) when revalidating content with the origin, or when an error is encountered when refreshing the cache. This setting defines the default "max-stale" duration for any cached responses that do not specify a max-stale directive. Stale responses that exceed the TTL configured here will not be served. The default limit (max-stale) is 86400s (1 day), which will allow stale content to be served up to this limit beyond the max-age (or s-maxage) of a cached response. The maximum allowed value is 604800 (1 week). Set this to zero (0) to disable serve-while-stale. + * Serve existing content from the cache (if available) when revalidating + * content with the origin, or when an error is encountered when refreshing + * the cache. + * This setting defines the default "max-stale" duration for any cached + * responses that do not specify a max-stale directive. Stale responses that + * exceed the TTL configured here will not be served. The default limit + * (max-stale) is 86400s (1 day), which will allow stale content to be + * served up to this limit beyond the max-age (or s-maxage) of a cached + * response. + * The maximum allowed value is 604800 (1 week). + * Set this to zero (0) to disable serve-while-stale. * * Generated from protobuf field optional int32 serve_while_stale = 236682203; * @param int $var @@ -470,7 +792,14 @@ public function setServeWhileStale($var) } /** - * Maximum number of seconds the response to a signed URL request will be considered fresh. After this time period, the response will be revalidated before being served. Defaults to 1hr (3600s). When serving responses to signed URL requests, Cloud CDN will internally behave as though all responses from this backend had a "Cache-Control: public, max-age=[TTL]" header, regardless of any existing Cache-Control header. The actual headers served in responses will not be altered. + * Maximum number of seconds the response to a signed URL request will be + * considered fresh. After this time period, the response will be + * revalidated before being served. Defaults to 1hr (3600s). When serving + * responses to signed URL requests, Cloud CDN will internally behave as + * though all responses from this backend had a "Cache-Control: + * public, max-age=[TTL]" header, regardless of any existing + * Cache-Control header. The actual headers served in responses will not be + * altered. * * Generated from protobuf field optional int64 signed_url_cache_max_age_sec = 269374534; * @return int|string @@ -491,7 +820,14 @@ public function clearSignedUrlCacheMaxAgeSec() } /** - * Maximum number of seconds the response to a signed URL request will be considered fresh. After this time period, the response will be revalidated before being served. Defaults to 1hr (3600s). When serving responses to signed URL requests, Cloud CDN will internally behave as though all responses from this backend had a "Cache-Control: public, max-age=[TTL]" header, regardless of any existing Cache-Control header. The actual headers served in responses will not be altered. + * Maximum number of seconds the response to a signed URL request will be + * considered fresh. After this time period, the response will be + * revalidated before being served. Defaults to 1hr (3600s). When serving + * responses to signed URL requests, Cloud CDN will internally behave as + * though all responses from this backend had a "Cache-Control: + * public, max-age=[TTL]" header, regardless of any existing + * Cache-Control header. The actual headers served in responses will not be + * altered. * * Generated from protobuf field optional int64 signed_url_cache_max_age_sec = 269374534; * @param int|string $var diff --git a/Compute/src/V1/BackendBucketCdnPolicy/CacheMode.php b/Compute/src/V1/BackendBucketCdnPolicy/CacheMode.php index 1c3bec082844..eb4970f947ed 100644 --- a/Compute/src/V1/BackendBucketCdnPolicy/CacheMode.php +++ b/Compute/src/V1/BackendBucketCdnPolicy/CacheMode.php @@ -7,7 +7,21 @@ use UnexpectedValueException; /** - * Specifies the cache setting for all responses from this backend. The possible values are: USE_ORIGIN_HEADERS Requires the origin to set valid caching headers to cache content. Responses without these headers will not be cached at Google's edge, and will require a full trip to the origin on every request, potentially impacting performance and increasing load on the origin server. FORCE_CACHE_ALL Cache all content, ignoring any "private", "no-store" or "no-cache" directives in Cache-Control response headers. Warning: this may result in Cloud CDN caching private, per-user (user identifiable) content. CACHE_ALL_STATIC Automatically cache static content, including common image formats, media (video and audio), and web assets (JavaScript and CSS). Requests and responses that are marked as uncacheable, as well as dynamic content (including HTML), will not be cached. If no value is provided for cdnPolicy.cacheMode, it defaults to CACHE_ALL_STATIC. + * Specifies the cache setting for all responses from this backend. + * The possible values are:USE_ORIGIN_HEADERS Requires the origin to set valid caching + * headers to cache content. Responses without these headers will not be + * cached at Google's edge, and will require a full trip to the origin on + * every request, potentially impacting performance and increasing load on + * the origin server.FORCE_CACHE_ALL Cache all content, ignoring any "private", + * "no-store" or "no-cache" directives in Cache-Control response headers. + * Warning: this may result in Cloud CDN caching private, + * per-user (user identifiable) content.CACHE_ALL_STATIC Automatically cache static content, + * including common image formats, media (video and audio), and web assets + * (JavaScript and CSS). Requests and responses that are marked as + * uncacheable, as well as dynamic content (including HTML), will not be + * cached. + * If no value is provided for cdnPolicy.cacheMode, it defaults + * to CACHE_ALL_STATIC. * * Protobuf type google.cloud.compute.v1.BackendBucketCdnPolicy.CacheMode */ @@ -20,13 +34,19 @@ class CacheMode */ const UNDEFINED_CACHE_MODE = 0; /** - * Automatically cache static content, including common image formats, media (video and audio), and web assets (JavaScript and CSS). Requests and responses that are marked as uncacheable, as well as dynamic content (including HTML), will not be cached. + * Automatically cache static content, including common image formats, + * media (video and audio), and web assets (JavaScript and CSS). + * Requests and responses that are marked as uncacheable, as well as + * dynamic content (including HTML), will not be cached. * * Generated from protobuf enum CACHE_ALL_STATIC = 355027945; */ const CACHE_ALL_STATIC = 355027945; /** - * Cache all content, ignoring any "private", "no-store" or "no-cache" directives in Cache-Control response headers. Warning: this may result in Cloud CDN caching private, per-user (user identifiable) content. + * Cache all content, ignoring any "private", "no-store" or "no-cache" + * directives in Cache-Control response headers. + * Warning: this may result in Cloud CDN caching private, + * per-user (user identifiable) content. * * Generated from protobuf enum FORCE_CACHE_ALL = 486026928; */ @@ -36,7 +56,11 @@ class CacheMode */ const INVALID_CACHE_MODE = 381295560; /** - * Requires the origin to set valid caching headers to cache content. Responses without these headers will not be cached at Google's edge, and will require a full trip to the origin on every request, potentially impacting performance and increasing load on the origin server. + * Requires the origin to set valid caching headers to cache content. + * Responses without these headers will not be cached at Google's edge, + * and will require a full trip to the origin on every request, + * potentially impacting performance and increasing load on the + * origin server. * * Generated from protobuf enum USE_ORIGIN_HEADERS = 55380261; */ diff --git a/Compute/src/V1/BackendBucketCdnPolicyBypassCacheOnRequestHeader.php b/Compute/src/V1/BackendBucketCdnPolicyBypassCacheOnRequestHeader.php index 381725e21bb9..b1177f819482 100644 --- a/Compute/src/V1/BackendBucketCdnPolicyBypassCacheOnRequestHeader.php +++ b/Compute/src/V1/BackendBucketCdnPolicyBypassCacheOnRequestHeader.php @@ -9,14 +9,17 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Bypass the cache when the specified request headers are present, e.g. Pragma or Authorization headers. Values are case insensitive. The presence of such a header overrides the cache_mode setting. + * Bypass the cache when the specified request headers are present, + * e.g. Pragma or Authorization headers. Values are case insensitive. + * The presence of such a header overrides the cache_mode setting. * * Generated from protobuf message google.cloud.compute.v1.BackendBucketCdnPolicyBypassCacheOnRequestHeader */ class BackendBucketCdnPolicyBypassCacheOnRequestHeader extends \Google\Protobuf\Internal\Message { /** - * The header field name to match on when bypassing cache. Values are case-insensitive. + * The header field name to match on when bypassing cache. + * Values are case-insensitive. * * Generated from protobuf field optional string header_name = 110223613; */ @@ -29,7 +32,8 @@ class BackendBucketCdnPolicyBypassCacheOnRequestHeader extends \Google\Protobuf\ * Optional. Data for populating the Message object. * * @type string $header_name - * The header field name to match on when bypassing cache. Values are case-insensitive. + * The header field name to match on when bypassing cache. + * Values are case-insensitive. * } */ public function __construct($data = NULL) { @@ -38,7 +42,8 @@ public function __construct($data = NULL) { } /** - * The header field name to match on when bypassing cache. Values are case-insensitive. + * The header field name to match on when bypassing cache. + * Values are case-insensitive. * * Generated from protobuf field optional string header_name = 110223613; * @return string @@ -59,7 +64,8 @@ public function clearHeaderName() } /** - * The header field name to match on when bypassing cache. Values are case-insensitive. + * The header field name to match on when bypassing cache. + * Values are case-insensitive. * * Generated from protobuf field optional string header_name = 110223613; * @param string $var diff --git a/Compute/src/V1/BackendBucketCdnPolicyCacheKeyPolicy.php b/Compute/src/V1/BackendBucketCdnPolicyCacheKeyPolicy.php index 0d0514da7bd1..e639f9f1e949 100644 --- a/Compute/src/V1/BackendBucketCdnPolicyCacheKeyPolicy.php +++ b/Compute/src/V1/BackendBucketCdnPolicyCacheKeyPolicy.php @@ -9,7 +9,8 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Message containing what to include in the cache key for a request for Cloud CDN. + * Message containing what to include in the cache key for a request for + * Cloud CDN. * * Generated from protobuf message google.cloud.compute.v1.BackendBucketCdnPolicyCacheKeyPolicy */ @@ -22,7 +23,9 @@ class BackendBucketCdnPolicyCacheKeyPolicy extends \Google\Protobuf\Internal\Mes */ private $include_http_headers; /** - * Names of query string parameters to include in cache keys. Default parameters are always included. '&' and '=' will be percent encoded and not treated as delimiters. + * Names of query string parameters to include in cache keys. Default + * parameters are always included. '&' and '=' will be percent encoded + * and not treated as delimiters. * * Generated from protobuf field repeated string query_string_whitelist = 52456496; */ @@ -37,7 +40,9 @@ class BackendBucketCdnPolicyCacheKeyPolicy extends \Google\Protobuf\Internal\Mes * @type array|\Google\Protobuf\Internal\RepeatedField $include_http_headers * Allows HTTP request headers (by name) to be used in the cache key. * @type array|\Google\Protobuf\Internal\RepeatedField $query_string_whitelist - * Names of query string parameters to include in cache keys. Default parameters are always included. '&' and '=' will be percent encoded and not treated as delimiters. + * Names of query string parameters to include in cache keys. Default + * parameters are always included. '&' and '=' will be percent encoded + * and not treated as delimiters. * } */ public function __construct($data = NULL) { @@ -72,7 +77,9 @@ public function setIncludeHttpHeaders($var) } /** - * Names of query string parameters to include in cache keys. Default parameters are always included. '&' and '=' will be percent encoded and not treated as delimiters. + * Names of query string parameters to include in cache keys. Default + * parameters are always included. '&' and '=' will be percent encoded + * and not treated as delimiters. * * Generated from protobuf field repeated string query_string_whitelist = 52456496; * @return \Google\Protobuf\Internal\RepeatedField @@ -83,7 +90,9 @@ public function getQueryStringWhitelist() } /** - * Names of query string parameters to include in cache keys. Default parameters are always included. '&' and '=' will be percent encoded and not treated as delimiters. + * Names of query string parameters to include in cache keys. Default + * parameters are always included. '&' and '=' will be percent encoded + * and not treated as delimiters. * * Generated from protobuf field repeated string query_string_whitelist = 52456496; * @param array|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/BackendBucketCdnPolicyNegativeCachingPolicy.php b/Compute/src/V1/BackendBucketCdnPolicyNegativeCachingPolicy.php index afefc245d1eb..9d0e0f3e498f 100644 --- a/Compute/src/V1/BackendBucketCdnPolicyNegativeCachingPolicy.php +++ b/Compute/src/V1/BackendBucketCdnPolicyNegativeCachingPolicy.php @@ -16,13 +16,20 @@ class BackendBucketCdnPolicyNegativeCachingPolicy extends \Google\Protobuf\Internal\Message { /** - * The HTTP status code to define a TTL against. Only HTTP status codes 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 are can be specified as values, and you cannot specify a status code more than once. + * The HTTP status code to define a TTL against. Only HTTP status codes + * 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be + * specified as values, and you cannot specify a status code more than + * once. * * Generated from protobuf field optional int32 code = 3059181; */ protected $code = null; /** - * The TTL (in seconds) for which to cache responses with the corresponding status code. The maximum allowed value is 1800s (30 minutes), noting that infrequently accessed objects may be evicted from the cache before the defined TTL. + * The TTL (in seconds) for which to cache responses with the + * corresponding status code. + * The maximum allowed value is 1800s (30 minutes), noting that + * infrequently accessed objects may be evicted from the cache before the + * defined TTL. * * Generated from protobuf field optional int32 ttl = 115180; */ @@ -35,9 +42,16 @@ class BackendBucketCdnPolicyNegativeCachingPolicy extends \Google\Protobuf\Inter * Optional. Data for populating the Message object. * * @type int $code - * The HTTP status code to define a TTL against. Only HTTP status codes 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 are can be specified as values, and you cannot specify a status code more than once. + * The HTTP status code to define a TTL against. Only HTTP status codes + * 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be + * specified as values, and you cannot specify a status code more than + * once. * @type int $ttl - * The TTL (in seconds) for which to cache responses with the corresponding status code. The maximum allowed value is 1800s (30 minutes), noting that infrequently accessed objects may be evicted from the cache before the defined TTL. + * The TTL (in seconds) for which to cache responses with the + * corresponding status code. + * The maximum allowed value is 1800s (30 minutes), noting that + * infrequently accessed objects may be evicted from the cache before the + * defined TTL. * } */ public function __construct($data = NULL) { @@ -46,7 +60,10 @@ public function __construct($data = NULL) { } /** - * The HTTP status code to define a TTL against. Only HTTP status codes 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 are can be specified as values, and you cannot specify a status code more than once. + * The HTTP status code to define a TTL against. Only HTTP status codes + * 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be + * specified as values, and you cannot specify a status code more than + * once. * * Generated from protobuf field optional int32 code = 3059181; * @return int @@ -67,7 +84,10 @@ public function clearCode() } /** - * The HTTP status code to define a TTL against. Only HTTP status codes 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 are can be specified as values, and you cannot specify a status code more than once. + * The HTTP status code to define a TTL against. Only HTTP status codes + * 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be + * specified as values, and you cannot specify a status code more than + * once. * * Generated from protobuf field optional int32 code = 3059181; * @param int $var @@ -82,7 +102,11 @@ public function setCode($var) } /** - * The TTL (in seconds) for which to cache responses with the corresponding status code. The maximum allowed value is 1800s (30 minutes), noting that infrequently accessed objects may be evicted from the cache before the defined TTL. + * The TTL (in seconds) for which to cache responses with the + * corresponding status code. + * The maximum allowed value is 1800s (30 minutes), noting that + * infrequently accessed objects may be evicted from the cache before the + * defined TTL. * * Generated from protobuf field optional int32 ttl = 115180; * @return int @@ -103,7 +127,11 @@ public function clearTtl() } /** - * The TTL (in seconds) for which to cache responses with the corresponding status code. The maximum allowed value is 1800s (30 minutes), noting that infrequently accessed objects may be evicted from the cache before the defined TTL. + * The TTL (in seconds) for which to cache responses with the + * corresponding status code. + * The maximum allowed value is 1800s (30 minutes), noting that + * infrequently accessed objects may be evicted from the cache before the + * defined TTL. * * Generated from protobuf field optional int32 ttl = 115180; * @param int $var diff --git a/Compute/src/V1/BackendBucketList.php b/Compute/src/V1/BackendBucketList.php index 7314a3ea61ef..9a26d99fac24 100644 --- a/Compute/src/V1/BackendBucketList.php +++ b/Compute/src/V1/BackendBucketList.php @@ -34,7 +34,11 @@ class BackendBucketList extends \Google\Protobuf\Internal\Message */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -65,7 +69,11 @@ class BackendBucketList extends \Google\Protobuf\Internal\Message * @type string $kind * Type of resource. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type \Google\Cloud\Compute\V1\Warning $warning @@ -176,7 +184,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -197,7 +209,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/BackendBucketParams.php b/Compute/src/V1/BackendBucketParams.php index 599f6e6e7c7d..9286fdfae0f8 100644 --- a/Compute/src/V1/BackendBucketParams.php +++ b/Compute/src/V1/BackendBucketParams.php @@ -16,7 +16,18 @@ class BackendBucketParams extends \Google\Protobuf\Internal\Message { /** - * Tag keys/values directly bound to this resource. Tag keys and values have the same definition as resource manager tags. The field is allowed for INSERT only. The keys/values to set on the resource should be specified in either ID { : } or Namespaced format { : }. For example the following are valid inputs: * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} * {"123/environment" : "production", "345/abc" : "xyz"} Note: * Invalid combinations of ID & namespaced format is not supported. For instance: {"123/environment" : "tagValues/444"} is invalid. + * Tag keys/values directly bound to this resource. + * Tag keys and values have the same definition as resource + * manager tags. The field is allowed for INSERT + * only. The keys/values to set on the resource should be specified in + * either ID { : } or Namespaced format + * { : }. + * For example the following are valid inputs: + * * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} + * * {"123/environment" : "production", "345/abc" : "xyz"} + * Note: + * * Invalid combinations of ID & namespaced format is not supported. For + * instance: {"123/environment" : "tagValues/444"} is invalid. * * Generated from protobuf field map resource_manager_tags = 377671164; */ @@ -29,7 +40,18 @@ class BackendBucketParams extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type array|\Google\Protobuf\Internal\MapField $resource_manager_tags - * Tag keys/values directly bound to this resource. Tag keys and values have the same definition as resource manager tags. The field is allowed for INSERT only. The keys/values to set on the resource should be specified in either ID { : } or Namespaced format { : }. For example the following are valid inputs: * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} * {"123/environment" : "production", "345/abc" : "xyz"} Note: * Invalid combinations of ID & namespaced format is not supported. For instance: {"123/environment" : "tagValues/444"} is invalid. + * Tag keys/values directly bound to this resource. + * Tag keys and values have the same definition as resource + * manager tags. The field is allowed for INSERT + * only. The keys/values to set on the resource should be specified in + * either ID { : } or Namespaced format + * { : }. + * For example the following are valid inputs: + * * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} + * * {"123/environment" : "production", "345/abc" : "xyz"} + * Note: + * * Invalid combinations of ID & namespaced format is not supported. For + * instance: {"123/environment" : "tagValues/444"} is invalid. * } */ public function __construct($data = NULL) { @@ -38,7 +60,18 @@ public function __construct($data = NULL) { } /** - * Tag keys/values directly bound to this resource. Tag keys and values have the same definition as resource manager tags. The field is allowed for INSERT only. The keys/values to set on the resource should be specified in either ID { : } or Namespaced format { : }. For example the following are valid inputs: * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} * {"123/environment" : "production", "345/abc" : "xyz"} Note: * Invalid combinations of ID & namespaced format is not supported. For instance: {"123/environment" : "tagValues/444"} is invalid. + * Tag keys/values directly bound to this resource. + * Tag keys and values have the same definition as resource + * manager tags. The field is allowed for INSERT + * only. The keys/values to set on the resource should be specified in + * either ID { : } or Namespaced format + * { : }. + * For example the following are valid inputs: + * * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} + * * {"123/environment" : "production", "345/abc" : "xyz"} + * Note: + * * Invalid combinations of ID & namespaced format is not supported. For + * instance: {"123/environment" : "tagValues/444"} is invalid. * * Generated from protobuf field map resource_manager_tags = 377671164; * @return \Google\Protobuf\Internal\MapField @@ -49,7 +82,18 @@ public function getResourceManagerTags() } /** - * Tag keys/values directly bound to this resource. Tag keys and values have the same definition as resource manager tags. The field is allowed for INSERT only. The keys/values to set on the resource should be specified in either ID { : } or Namespaced format { : }. For example the following are valid inputs: * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} * {"123/environment" : "production", "345/abc" : "xyz"} Note: * Invalid combinations of ID & namespaced format is not supported. For instance: {"123/environment" : "tagValues/444"} is invalid. + * Tag keys/values directly bound to this resource. + * Tag keys and values have the same definition as resource + * manager tags. The field is allowed for INSERT + * only. The keys/values to set on the resource should be specified in + * either ID { : } or Namespaced format + * { : }. + * For example the following are valid inputs: + * * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} + * * {"123/environment" : "production", "345/abc" : "xyz"} + * Note: + * * Invalid combinations of ID & namespaced format is not supported. For + * instance: {"123/environment" : "tagValues/444"} is invalid. * * Generated from protobuf field map resource_manager_tags = 377671164; * @param array|\Google\Protobuf\Internal\MapField $var diff --git a/Compute/src/V1/BackendBucketUsedBy.php b/Compute/src/V1/BackendBucketUsedBy.php index f1c68dfba688..6d587cfd9385 100644 --- a/Compute/src/V1/BackendBucketUsedBy.php +++ b/Compute/src/V1/BackendBucketUsedBy.php @@ -15,7 +15,8 @@ class BackendBucketUsedBy extends \Google\Protobuf\Internal\Message { /** - * [Output Only] Server-defined URL for UrlMaps referencing that BackendBucket. + * [Output Only] Server-defined URL for UrlMaps referencing that + * BackendBucket. * * Generated from protobuf field optional string reference = 148586315; */ @@ -28,7 +29,8 @@ class BackendBucketUsedBy extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $reference - * [Output Only] Server-defined URL for UrlMaps referencing that BackendBucket. + * [Output Only] Server-defined URL for UrlMaps referencing that + * BackendBucket. * } */ public function __construct($data = NULL) { @@ -37,7 +39,8 @@ public function __construct($data = NULL) { } /** - * [Output Only] Server-defined URL for UrlMaps referencing that BackendBucket. + * [Output Only] Server-defined URL for UrlMaps referencing that + * BackendBucket. * * Generated from protobuf field optional string reference = 148586315; * @return string @@ -58,7 +61,8 @@ public function clearReference() } /** - * [Output Only] Server-defined URL for UrlMaps referencing that BackendBucket. + * [Output Only] Server-defined URL for UrlMaps referencing that + * BackendBucket. * * Generated from protobuf field optional string reference = 148586315; * @param string $var diff --git a/Compute/src/V1/BackendCustomMetric.php b/Compute/src/V1/BackendCustomMetric.php index b7e530d51a11..5263265ae1e6 100644 --- a/Compute/src/V1/BackendCustomMetric.php +++ b/Compute/src/V1/BackendCustomMetric.php @@ -16,19 +16,29 @@ class BackendCustomMetric extends \Google\Protobuf\Internal\Message { /** - * If true, the metric data is collected and reported to Cloud Monitoring, but is not used for load balancing. + * If true, the metric data is collected and reported to Cloud + * Monitoring, but is not used for load balancing. * * Generated from protobuf field optional bool dry_run = 323854839; */ protected $dry_run = null; /** - * Optional parameter to define a target utilization for the Custom Metrics balancing mode. The valid range is [0.0, 1.0]. + * Optional parameter to define a target utilization for the Custom Metrics + * balancing mode. The valid range is [0.0, 1.0]. * * Generated from protobuf field optional float max_utilization = 148192199; */ protected $max_utilization = null; /** - * Name of a custom utilization signal. The name must be 1-64 characters long and match the regular expression [a-z]([-_.a-z0-9]*[a-z0-9])? which means that the first character must be a lowercase letter, and all following characters must be a dash, period, underscore, lowercase letter, or digit, except the last character, which cannot be a dash, period, or underscore. For usage guidelines, see Custom Metrics balancing mode. This field can only be used for a global or regional backend service with the loadBalancingScheme set to EXTERNAL_MANAGED, INTERNAL_MANAGED INTERNAL_SELF_MANAGED. + * Name of a custom utilization signal. The name must be 1-64 characters + * long and match the regular expression + * `[a-z]([-_.a-z0-9]*[a-z0-9])?` which means that the + * first character must be a lowercase letter, and all following + * characters must be a dash, period, underscore, lowercase letter, or + * digit, except the last character, which cannot be a dash, period, or + * underscore. For usage guidelines, see Custom Metrics balancing mode. This + * field can only be used for a global or regional backend service with the + * loadBalancingScheme set to EXTERNAL_MANAGED,INTERNAL_MANAGED INTERNAL_SELF_MANAGED. * * Generated from protobuf field optional string name = 3373707; */ @@ -41,11 +51,21 @@ class BackendCustomMetric extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type bool $dry_run - * If true, the metric data is collected and reported to Cloud Monitoring, but is not used for load balancing. + * If true, the metric data is collected and reported to Cloud + * Monitoring, but is not used for load balancing. * @type float $max_utilization - * Optional parameter to define a target utilization for the Custom Metrics balancing mode. The valid range is [0.0, 1.0]. + * Optional parameter to define a target utilization for the Custom Metrics + * balancing mode. The valid range is [0.0, 1.0]. * @type string $name - * Name of a custom utilization signal. The name must be 1-64 characters long and match the regular expression [a-z]([-_.a-z0-9]*[a-z0-9])? which means that the first character must be a lowercase letter, and all following characters must be a dash, period, underscore, lowercase letter, or digit, except the last character, which cannot be a dash, period, or underscore. For usage guidelines, see Custom Metrics balancing mode. This field can only be used for a global or regional backend service with the loadBalancingScheme set to EXTERNAL_MANAGED, INTERNAL_MANAGED INTERNAL_SELF_MANAGED. + * Name of a custom utilization signal. The name must be 1-64 characters + * long and match the regular expression + * `[a-z]([-_.a-z0-9]*[a-z0-9])?` which means that the + * first character must be a lowercase letter, and all following + * characters must be a dash, period, underscore, lowercase letter, or + * digit, except the last character, which cannot be a dash, period, or + * underscore. For usage guidelines, see Custom Metrics balancing mode. This + * field can only be used for a global or regional backend service with the + * loadBalancingScheme set to EXTERNAL_MANAGED,INTERNAL_MANAGED INTERNAL_SELF_MANAGED. * } */ public function __construct($data = NULL) { @@ -54,7 +74,8 @@ public function __construct($data = NULL) { } /** - * If true, the metric data is collected and reported to Cloud Monitoring, but is not used for load balancing. + * If true, the metric data is collected and reported to Cloud + * Monitoring, but is not used for load balancing. * * Generated from protobuf field optional bool dry_run = 323854839; * @return bool @@ -75,7 +96,8 @@ public function clearDryRun() } /** - * If true, the metric data is collected and reported to Cloud Monitoring, but is not used for load balancing. + * If true, the metric data is collected and reported to Cloud + * Monitoring, but is not used for load balancing. * * Generated from protobuf field optional bool dry_run = 323854839; * @param bool $var @@ -90,7 +112,8 @@ public function setDryRun($var) } /** - * Optional parameter to define a target utilization for the Custom Metrics balancing mode. The valid range is [0.0, 1.0]. + * Optional parameter to define a target utilization for the Custom Metrics + * balancing mode. The valid range is [0.0, 1.0]. * * Generated from protobuf field optional float max_utilization = 148192199; * @return float @@ -111,7 +134,8 @@ public function clearMaxUtilization() } /** - * Optional parameter to define a target utilization for the Custom Metrics balancing mode. The valid range is [0.0, 1.0]. + * Optional parameter to define a target utilization for the Custom Metrics + * balancing mode. The valid range is [0.0, 1.0]. * * Generated from protobuf field optional float max_utilization = 148192199; * @param float $var @@ -126,7 +150,15 @@ public function setMaxUtilization($var) } /** - * Name of a custom utilization signal. The name must be 1-64 characters long and match the regular expression [a-z]([-_.a-z0-9]*[a-z0-9])? which means that the first character must be a lowercase letter, and all following characters must be a dash, period, underscore, lowercase letter, or digit, except the last character, which cannot be a dash, period, or underscore. For usage guidelines, see Custom Metrics balancing mode. This field can only be used for a global or regional backend service with the loadBalancingScheme set to EXTERNAL_MANAGED, INTERNAL_MANAGED INTERNAL_SELF_MANAGED. + * Name of a custom utilization signal. The name must be 1-64 characters + * long and match the regular expression + * `[a-z]([-_.a-z0-9]*[a-z0-9])?` which means that the + * first character must be a lowercase letter, and all following + * characters must be a dash, period, underscore, lowercase letter, or + * digit, except the last character, which cannot be a dash, period, or + * underscore. For usage guidelines, see Custom Metrics balancing mode. This + * field can only be used for a global or regional backend service with the + * loadBalancingScheme set to EXTERNAL_MANAGED,INTERNAL_MANAGED INTERNAL_SELF_MANAGED. * * Generated from protobuf field optional string name = 3373707; * @return string @@ -147,7 +179,15 @@ public function clearName() } /** - * Name of a custom utilization signal. The name must be 1-64 characters long and match the regular expression [a-z]([-_.a-z0-9]*[a-z0-9])? which means that the first character must be a lowercase letter, and all following characters must be a dash, period, underscore, lowercase letter, or digit, except the last character, which cannot be a dash, period, or underscore. For usage guidelines, see Custom Metrics balancing mode. This field can only be used for a global or regional backend service with the loadBalancingScheme set to EXTERNAL_MANAGED, INTERNAL_MANAGED INTERNAL_SELF_MANAGED. + * Name of a custom utilization signal. The name must be 1-64 characters + * long and match the regular expression + * `[a-z]([-_.a-z0-9]*[a-z0-9])?` which means that the + * first character must be a lowercase letter, and all following + * characters must be a dash, period, underscore, lowercase letter, or + * digit, except the last character, which cannot be a dash, period, or + * underscore. For usage guidelines, see Custom Metrics balancing mode. This + * field can only be used for a global or regional backend service with the + * loadBalancingScheme set to EXTERNAL_MANAGED,INTERNAL_MANAGED INTERNAL_SELF_MANAGED. * * Generated from protobuf field optional string name = 3373707; * @param string $var diff --git a/Compute/src/V1/BackendService.php b/Compute/src/V1/BackendService.php index 17bfef0463a4..c4a0197a94ee 100644 --- a/Compute/src/V1/BackendService.php +++ b/Compute/src/V1/BackendService.php @@ -9,14 +9,34 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Represents a Backend Service resource. A backend service defines how Google Cloud load balancers distribute traffic. The backend service configuration contains a set of values, such as the protocol used to connect to backends, various distribution and session settings, health checks, and timeouts. These settings provide fine-grained control over how your load balancer behaves. Most of the settings have default values that allow for easy configuration if you need to get started quickly. Backend services in Google Compute Engine can be either regionally or globally scoped. * [Global](https://cloud.google.com/compute/docs/reference/rest/v1/backendServices) * [Regional](https://cloud.google.com/compute/docs/reference/rest/v1/regionBackendServices) For more information, see Backend Services. + * Represents a Backend Service resource. + * A backend service defines how Google Cloud load balancers distribute traffic. + * The backend service configuration contains a set of values, such as the + * protocol used to connect to backends, various distribution and session + * settings, health checks, and timeouts. These settings provide fine-grained + * control over how your load balancer behaves. Most of the settings have + * default values that allow for easy configuration if you need to get started + * quickly. + * Backend services in Google Compute Engine can be either regionally or + * globally scoped. + * * [Global](https://cloud.google.com/compute/docs/reference/rest/v1/backendServices) + * * [Regional](https://cloud.google.com/compute/docs/reference/rest/v1/regionBackendServices) + * For more information, seeBackend + * Services. * * Generated from protobuf message google.cloud.compute.v1.BackendService */ class BackendService extends \Google\Protobuf\Internal\Message { /** - * Lifetime of cookies in seconds. This setting is applicable to Application Load Balancers and Traffic Director and requires GENERATED_COOKIE or HTTP_COOKIE session affinity. If set to 0, the cookie is non-persistent and lasts only until the end of the browser session (or equivalent). The maximum allowed value is two weeks (1,209,600). Not supported when the backend service is referenced by a URL map that is bound to target gRPC proxy that has validateForProxyless field set to true. + * Lifetime of cookies in seconds. This setting is applicable to Application + * Load Balancers and Traffic Director and requires + * GENERATED_COOKIE or HTTP_COOKIE session affinity. + * If set to 0, the cookie is non-persistent and lasts only until + * the end of the browser session (or equivalent). The maximum allowed value + * is two weeks (1,209,600). + * Not supported when the backend service is referenced by a URL map that is + * bound to target gRPC proxy that has validateForProxyless field set to true. * * Generated from protobuf field optional int32 affinity_cookie_ttl_sec = 369996954; */ @@ -28,7 +48,8 @@ class BackendService extends \Google\Protobuf\Internal\Message */ private $backends; /** - * Cloud CDN configuration for this BackendService. Only available for specified load balancer types. + * Cloud CDN configuration for this BackendService. Only available for + * specified load balancer types. * * Generated from protobuf field optional .google.cloud.compute.v1.BackendServiceCdnPolicy cdn_policy = 213976452; */ @@ -38,7 +59,8 @@ class BackendService extends \Google\Protobuf\Internal\Message */ protected $circuit_breakers = null; /** - * Compress text responses using Brotli or gzip compression, based on the client's Accept-Encoding header. + * Compress text responses using Brotli or gzip compression, based on + * the client's Accept-Encoding header. * Check the CompressionMode enum for the list of possible values. * * Generated from protobuf field optional string compression_mode = 95520988; @@ -51,216 +73,458 @@ class BackendService extends \Google\Protobuf\Internal\Message */ protected $connection_draining = null; /** - * Connection Tracking configuration for this BackendService. Connection tracking policy settings are only available for external passthrough Network Load Balancers and internal passthrough Network Load Balancers. connectionTrackingPolicy cannot be specified with haPolicy. + * Connection Tracking configuration for this BackendService. Connection + * tracking policy settings are only available for external passthrough + * Network Load Balancers and internal passthrough Network Load Balancers. + * connectionTrackingPolicy cannot be specified with haPolicy. * * Generated from protobuf field optional .google.cloud.compute.v1.BackendServiceConnectionTrackingPolicy connection_tracking_policy = 143994969; */ protected $connection_tracking_policy = null; /** - * Consistent Hash-based load balancing can be used to provide soft session affinity based on HTTP headers, cookies or other properties. This load balancing policy is applicable only for HTTP connections. The affinity to a particular destination host will be lost when one or more hosts are added/removed from the destination service. This field specifies parameters that control consistent hashing. This field is only applicable when localityLbPolicy is set to MAGLEV or RING_HASH. This field is applicable to either: - A regional backend service with the service_protocol set to HTTP, HTTPS, HTTP2 or H2C, and load_balancing_scheme set to INTERNAL_MANAGED. - A global backend service with the load_balancing_scheme set to INTERNAL_SELF_MANAGED. + * Consistent Hash-based load balancing can be used to provide soft session + * affinity based on HTTP headers, cookies or other properties. This load + * balancing policy is applicable only for HTTP connections. The affinity to a + * particular destination host will be lost when one or more hosts are + * added/removed from the destination service. This field specifies parameters + * that control consistent hashing. This field is only applicable whenlocalityLbPolicy is set to MAGLEV orRING_HASH. + * This field is applicable to either: + * - A regional backend service with the service_protocol set to HTTP, + * HTTPS, HTTP2 or H2C, and load_balancing_scheme set to + * INTERNAL_MANAGED. + * - A global backend service with the + * load_balancing_scheme set to INTERNAL_SELF_MANAGED. * * Generated from protobuf field optional .google.cloud.compute.v1.ConsistentHashLoadBalancerSettings consistent_hash = 905883; */ protected $consistent_hash = null; /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; */ protected $creation_timestamp = null; /** - * List of custom metrics that are used for the WEIGHTED_ROUND_ROBIN locality_lb_policy. + * List of custom metrics that are used for theWEIGHTED_ROUND_ROBIN locality_lb_policy. * * Generated from protobuf field repeated .google.cloud.compute.v1.BackendServiceCustomMetric custom_metrics = 429453813; */ private $custom_metrics; /** - * Headers that the load balancer adds to proxied requests. See [Creating custom headers](https://cloud.google.com/load-balancing/docs/custom-headers). + * Headers that the load balancer adds to proxied requests. See [Creating + * custom + * headers](https://cloud.google.com/load-balancing/docs/custom-headers). * * Generated from protobuf field repeated string custom_request_headers = 27977992; */ private $custom_request_headers; /** - * Headers that the load balancer adds to proxied responses. See [Creating custom headers](https://cloud.google.com/load-balancing/docs/custom-headers). + * Headers that the load balancer adds to proxied responses. See [Creating + * custom + * headers](https://cloud.google.com/load-balancing/docs/custom-headers). * * Generated from protobuf field repeated string custom_response_headers = 387539094; */ private $custom_response_headers; /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; */ protected $description = null; /** - * [Output Only] The resource URL for the edge security policy associated with this backend service. + * [Output Only] The resource URL for the edge security policy associated with + * this backend service. * * Generated from protobuf field optional string edge_security_policy = 41036943; */ protected $edge_security_policy = null; /** - * If true, enables Cloud CDN for the backend service of a global external Application Load Balancer. + * If true, enables Cloud CDN for the backend service of a + * global external Application Load Balancer. * * Generated from protobuf field optional bool enable_c_d_n = 250733499; */ protected $enable_c_d_n = null; /** - * Specifies the canary migration state. Possible values are PREPARE, TEST_BY_PERCENTAGE, and TEST_ALL_TRAFFIC. To begin the migration from EXTERNAL to EXTERNAL_MANAGED, the state must be changed to PREPARE. The state must be changed to TEST_ALL_TRAFFIC before the loadBalancingScheme can be changed to EXTERNAL_MANAGED. Optionally, the TEST_BY_PERCENTAGE state can be used to migrate traffic by percentage using externalManagedMigrationTestingPercentage. Rolling back a migration requires the states to be set in reverse order. So changing the scheme from EXTERNAL_MANAGED to EXTERNAL requires the state to be set to TEST_ALL_TRAFFIC at the same time. Optionally, the TEST_BY_PERCENTAGE state can be used to migrate some traffic back to EXTERNAL or PREPARE can be used to migrate all traffic back to EXTERNAL. + * Specifies the canary migration state. Possible values are PREPARE, + * TEST_BY_PERCENTAGE, and TEST_ALL_TRAFFIC. + * To begin the migration from EXTERNAL to EXTERNAL_MANAGED, the state must be + * changed to PREPARE. The state must be changed to TEST_ALL_TRAFFIC before + * the loadBalancingScheme can be changed to EXTERNAL_MANAGED. Optionally, the + * TEST_BY_PERCENTAGE state can be used to migrate traffic by percentage using + * externalManagedMigrationTestingPercentage. + * Rolling back a migration requires the states to be set in reverse order. So + * changing the scheme from EXTERNAL_MANAGED to EXTERNAL requires the state to + * be set to TEST_ALL_TRAFFIC at the same time. Optionally, the + * TEST_BY_PERCENTAGE state can be used to migrate some traffic back to + * EXTERNAL or PREPARE can be used to migrate all traffic back to EXTERNAL. * Check the ExternalManagedMigrationState enum for the list of possible values. * * Generated from protobuf field optional string external_managed_migration_state = 66947020; */ protected $external_managed_migration_state = null; /** - * Determines the fraction of requests that should be processed by the Global external Application Load Balancer. The value of this field must be in the range [0, 100]. Session affinity options will slightly affect this routing behavior, for more details, see: Session Affinity. This value can only be set if the loadBalancingScheme in the BackendService is set to EXTERNAL (when using the classic Application Load Balancer) and the migration state is TEST_BY_PERCENTAGE. + * Determines the fraction of requests that should be processed by the Global + * external Application Load Balancer. + * The value of this field must be in the range [0, 100]. + * Session affinity options will slightly affect this routing behavior, for + * more details, see:Session + * Affinity. + * This value can only be set if the loadBalancingScheme in the BackendService + * is set to EXTERNAL (when using the classic Application Load Balancer) and + * the migration state is TEST_BY_PERCENTAGE. * * Generated from protobuf field optional float external_managed_migration_testing_percentage = 507232462; */ protected $external_managed_migration_testing_percentage = null; /** - * Requires at least one backend instance group to be defined as a backup (failover) backend. For load balancers that have configurable failover: [Internal passthrough Network Load Balancers](https://cloud.google.com/load-balancing/docs/internal/failover-overview) and [external passthrough Network Load Balancers](https://cloud.google.com/load-balancing/docs/network/networklb-failover-overview). failoverPolicy cannot be specified with haPolicy. + * Requires at least one backend instance group to be defined + * as a backup (failover) backend. + * For load balancers that have configurable failover: + * [Internal passthrough Network Load + * Balancers](https://cloud.google.com/load-balancing/docs/internal/failover-overview) + * and [external passthrough Network Load + * Balancers](https://cloud.google.com/load-balancing/docs/network/networklb-failover-overview). + * failoverPolicy cannot be specified with haPolicy. * * Generated from protobuf field optional .google.cloud.compute.v1.BackendServiceFailoverPolicy failover_policy = 105658655; */ protected $failover_policy = null; /** - * Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking. This field will be ignored when inserting a BackendService. An up-to-date fingerprint must be provided in order to update the BackendService, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a BackendService. + * Fingerprint of this resource. A hash of the contents stored in this object. + * This field is used in optimistic locking. This field will be ignored when + * inserting a BackendService. An up-to-date fingerprint must be provided in + * order to update the BackendService, otherwise the request will + * fail with error 412 conditionNotMet. + * To see the latest fingerprint, make a get() request to + * retrieve a BackendService. * * Generated from protobuf field optional string fingerprint = 234678500; */ protected $fingerprint = null; /** - * Configures self-managed High Availability (HA) for External and Internal Protocol Forwarding. The backends of this regional backend service must only specify zonal network endpoint groups (NEGs) of type GCE_VM_IP. When haPolicy is set for an Internal Passthrough Network Load Balancer, the regional backend service must set the network field. All zonal NEGs must belong to the same network. However, individual NEGs can belong to different subnetworks of that network. When haPolicy is specified, the set of attached network endpoints across all backends comprise an High Availability domain from which one endpoint is selected as the active endpoint (the leader) that receives all traffic. haPolicy can be added only at backend service creation time. Once set up, it cannot be deleted. Note that haPolicy is not for load balancing, and therefore cannot be specified with sessionAffinity, connectionTrackingPolicy, and failoverPolicy. haPolicy requires customers to be responsible for tracking backend endpoint health and electing a leader among the healthy endpoints. Therefore, haPolicy cannot be specified with healthChecks. haPolicy can only be specified for External Passthrough Network Load Balancers and Internal Passthrough Network Load Balancers. + * Configures self-managed High Availability (HA) for External and Internal + * Protocol Forwarding. + * The backends of this regional backend service must only specify zonal + * network endpoint groups (NEGs) of type GCE_VM_IP. + * When haPolicy is set for an Internal Passthrough Network Load Balancer, the + * regional backend service must set the network field. All zonal NEGs must + * belong to the same network. However, individual NEGs can + * belong to different subnetworks of that network. + * When haPolicy is specified, the set of attached network endpoints across + * all backends comprise an High Availability domain from which one endpoint + * is selected as the active endpoint (the leader) that receives all + * traffic. + * haPolicy can be added only at backend service creation time. Once set up, + * it cannot be deleted. + * Note that haPolicy is not for load balancing, and therefore cannot be + * specified with sessionAffinity, connectionTrackingPolicy, and + * failoverPolicy. + * haPolicy requires customers to be responsible for tracking backend + * endpoint health and electing a leader among the healthy endpoints. + * Therefore, haPolicy cannot be specified with healthChecks. + * haPolicy can only be specified for External Passthrough Network Load + * Balancers and Internal Passthrough Network Load Balancers. * * Generated from protobuf field optional .google.cloud.compute.v1.BackendServiceHAPolicy ha_policy = 519879480; */ protected $ha_policy = null; /** - * The list of URLs to the healthChecks, httpHealthChecks (legacy), or httpsHealthChecks (legacy) resource for health checking this backend service. Not all backend services support legacy health checks. See Load balancer guide. Currently, at most one health check can be specified for each backend service. Backend services with instance group or zonal NEG backends must have a health check unless haPolicy is specified. Backend services with internet or serverless NEG backends must not have a health check. healthChecks[] cannot be specified with haPolicy. + * The list of URLs to the healthChecks, httpHealthChecks (legacy), or + * httpsHealthChecks (legacy) resource for health checking this backend + * service. Not all backend services support legacy health checks. See + * Load balancer guide. Currently, at most one health check can be + * specified for each backend service. Backend services with + * instance group or zonal NEG backends must have a health check unless + * haPolicy is specified. Backend services with internet or serverless NEG + * backends must not have a health check. + * healthChecks[] cannot be specified with haPolicy. * * Generated from protobuf field repeated string health_checks = 448370606; */ private $health_checks; /** - * The configurations for Identity-Aware Proxy on this resource. Not available for internal passthrough Network Load Balancers and external passthrough Network Load Balancers. + * The configurations for Identity-Aware Proxy on this resource. + * Not available for internal passthrough Network Load Balancers and external + * passthrough Network Load Balancers. * * Generated from protobuf field optional .google.cloud.compute.v1.BackendServiceIAP iap = 104024; */ protected $iap = null; /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; */ protected $id = null; /** - * Specifies a preference for traffic sent from the proxy to the backend (or from the client to the backend for proxyless gRPC). The possible values are: - IPV4_ONLY: Only send IPv4 traffic to the backends of the backend service (Instance Group, Managed Instance Group, Network Endpoint Group), regardless of traffic from the client to the proxy. Only IPv4 health checks are used to check the health of the backends. This is the default setting. - PREFER_IPV6: Prioritize the connection to the endpoint's IPv6 address over its IPv4 address (provided there is a healthy IPv6 address). - IPV6_ONLY: Only send IPv6 traffic to the backends of the backend service (Instance Group, Managed Instance Group, Network Endpoint Group), regardless of traffic from the client to the proxy. Only IPv6 health checks are used to check the health of the backends. This field is applicable to either: - Advanced global external Application Load Balancer (load balancing scheme EXTERNAL_MANAGED), - Regional external Application Load Balancer, - Internal proxy Network Load Balancer (load balancing scheme INTERNAL_MANAGED), - Regional internal Application Load Balancer (load balancing scheme INTERNAL_MANAGED), - Traffic Director with Envoy proxies and proxyless gRPC (load balancing scheme INTERNAL_SELF_MANAGED). + * Specifies a preference for traffic sent from the proxy to the backend (or + * from the client to the backend for proxyless gRPC). + * The possible values are: + * - IPV4_ONLY: Only send IPv4 traffic to the backends of the + * backend service (Instance Group, Managed Instance Group, Network Endpoint + * Group), regardless of traffic from the client to the proxy. Only IPv4 + * health checks are used to check the health of the backends. This is the + * default setting. + * - PREFER_IPV6: Prioritize the connection to the endpoint's + * IPv6 address over its IPv4 address (provided there is a healthy IPv6 + * address). + * - IPV6_ONLY: Only send IPv6 traffic to the backends of the + * backend service (Instance Group, Managed Instance Group, Network Endpoint + * Group), regardless of traffic from the client to the proxy. Only IPv6 + * health checks are used to check the health of the backends. + * This field is applicable to either: + * - Advanced global external Application Load Balancer (load balancing + * scheme EXTERNAL_MANAGED), + * - Regional external Application Load + * Balancer, + * - Internal proxy Network Load Balancer (load balancing + * scheme INTERNAL_MANAGED), + * - Regional internal Application Load + * Balancer (load balancing scheme INTERNAL_MANAGED), + * - Traffic + * Director with Envoy proxies and proxyless gRPC (load balancing scheme + * INTERNAL_SELF_MANAGED). * Check the IpAddressSelectionPolicy enum for the list of possible values. * * Generated from protobuf field optional string ip_address_selection_policy = 77600840; */ protected $ip_address_selection_policy = null; /** - * [Output Only] Type of resource. Always compute#backendService for backend services. + * [Output Only] Type of resource. Always compute#backendService + * for backend services. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * Specifies the load balancer type. A backend service created for one type of load balancer cannot be used with another. For more information, refer to Choosing a load balancer. + * Specifies the load balancer type. A backend service + * created for one type of load balancer cannot be used with another. + * For more information, refer toChoosing + * a load balancer. * Check the LoadBalancingScheme enum for the list of possible values. * * Generated from protobuf field optional string load_balancing_scheme = 363890244; */ protected $load_balancing_scheme = null; /** - * A list of locality load-balancing policies to be used in order of preference. When you use localityLbPolicies, you must set at least one value for either the localityLbPolicies[].policy or the localityLbPolicies[].customPolicy field. localityLbPolicies overrides any value set in the localityLbPolicy field. For an example of how to use this field, see Define a list of preferred policies. Caution: This field and its children are intended for use in a service mesh that includes gRPC clients only. Envoy proxies can't use backend services that have this configuration. + * A list of locality load-balancing policies to be used in order of + * preference. When you use localityLbPolicies, you must set at least one + * value for either the localityLbPolicies[].policy or the + * localityLbPolicies[].customPolicy field. localityLbPolicies overrides any + * value set in the localityLbPolicy field. + * For an example of how to use this field, seeDefine + * a list of preferred policies. + * Caution: This field and its children are intended for use in a service mesh + * that includes gRPC clients only. Envoy proxies can't use backend services + * that have this configuration. * * Generated from protobuf field repeated .google.cloud.compute.v1.BackendServiceLocalityLoadBalancingPolicyConfig locality_lb_policies = 140982557; */ private $locality_lb_policies; /** - * The load balancing algorithm used within the scope of the locality. The possible values are: - ROUND_ROBIN: This is a simple policy in which each healthy backend is selected in round robin order. This is the default. - LEAST_REQUEST: An O(1) algorithm which selects two random healthy hosts and picks the host which has fewer active requests. - RING_HASH: The ring/modulo hash load balancer implements consistent hashing to backends. The algorithm has the property that the addition/removal of a host from a set of N hosts only affects 1/N of the requests. - RANDOM: The load balancer selects a random healthy host. - ORIGINAL_DESTINATION: Backend host is selected based on the client connection metadata, i.e., connections are opened to the same address as the destination address of the incoming connection before the connection was redirected to the load balancer. - MAGLEV: used as a drop in replacement for the ring hash load balancer. Maglev is not as stable as ring hash but has faster table lookup build times and host selection times. For more information about Maglev, see Maglev: A Fast and Reliable Software Network Load Balancer. - WEIGHTED_ROUND_ROBIN: Per-endpoint Weighted Round Robin Load Balancing using weights computed from Backend reported Custom Metrics. If set, the Backend Service responses are expected to contain non-standard HTTP response header field Endpoint-Load-Metrics. The reported metrics to use for computing the weights are specified via the customMetrics field. This field is applicable to either: - A regional backend service with the service_protocol set to HTTP, HTTPS, HTTP2 or H2C, and load_balancing_scheme set to INTERNAL_MANAGED. - A global backend service with the load_balancing_scheme set to INTERNAL_SELF_MANAGED, INTERNAL_MANAGED, or EXTERNAL_MANAGED. If sessionAffinity is not configured—that is, if session affinity remains at the default value of NONE—then the default value for localityLbPolicy is ROUND_ROBIN. If session affinity is set to a value other than NONE, then the default value for localityLbPolicy is MAGLEV. Only ROUND_ROBIN and RING_HASH are supported when the backend service is referenced by a URL map that is bound to target gRPC proxy that has validateForProxyless field set to true. localityLbPolicy cannot be specified with haPolicy. + * The load balancing algorithm used within the scope of the locality. The + * possible values are: + * - ROUND_ROBIN: This is a simple policy in which each healthy + * backend is selected in round robin order. This is the default. + * - LEAST_REQUEST: An O(1) algorithm which + * selects two random healthy hosts and picks the host which has fewer active + * requests. + * - RING_HASH: The ring/modulo hash load balancer implements + * consistent hashing to backends. The algorithm has the property that the + * addition/removal of a host from a set of N hosts only affects 1/N of the + * requests. + * - RANDOM: The load balancer selects a random healthy + * host. + * - ORIGINAL_DESTINATION: Backend host is selected + * based on the client connection metadata, i.e., connections are opened to + * the same address as the destination address of the incoming connection + * before the connection was redirected to the load balancer. + * - MAGLEV: used as a drop in replacement for the ring hash + * load balancer. Maglev is not as stable as ring hash but has faster table + * lookup build times and host selection times. For more information about + * Maglev, see Maglev: + * A Fast and Reliable Software Network Load Balancer. + * - WEIGHTED_ROUND_ROBIN: Per-endpoint Weighted Round Robin + * Load Balancing using weights computed from Backend reported Custom Metrics. + * If set, the Backend Service responses are expected to contain non-standard + * HTTP response header field Endpoint-Load-Metrics. The reported + * metrics to use for computing the weights are specified via thecustomMetrics field. + * This field is applicable to either: + * - A regional backend service with the service_protocol set to HTTP, + * HTTPS, HTTP2 or H2C, and load_balancing_scheme set to + * INTERNAL_MANAGED. + * - A global backend service with the + * load_balancing_scheme set to INTERNAL_SELF_MANAGED, INTERNAL_MANAGED, or + * EXTERNAL_MANAGED. + * If sessionAffinity is not configured—that is, if session + * affinity remains at the default value of NONE—then the + * default value for localityLbPolicy + * is ROUND_ROBIN. If session affinity is set to a value other + * than NONE, + * then the default value for localityLbPolicy isMAGLEV. + * Only ROUND_ROBIN and RING_HASH are supported + * when the backend service is referenced by a URL map that is bound to + * target gRPC proxy that has validateForProxyless field set to true. + * localityLbPolicy cannot be specified with haPolicy. * Check the LocalityLbPolicy enum for the list of possible values. * * Generated from protobuf field optional string locality_lb_policy = 131431487; */ protected $locality_lb_policy = null; /** - * This field denotes the logging options for the load balancer traffic served by this backend service. If logging is enabled, logs will be exported to Stackdriver. + * This field denotes the logging options for the load balancer traffic served + * by this backend service. If logging is enabled, logs will be exported to + * Stackdriver. * * Generated from protobuf field optional .google.cloud.compute.v1.BackendServiceLogConfig log_config = 351299741; */ protected $log_config = null; /** - * Specifies the default maximum duration (timeout) for streams to this service. Duration is computed from the beginning of the stream until the response has been completely processed, including all retries. A stream that does not complete in this duration is closed. If not specified, there will be no timeout limit, i.e. the maximum duration is infinite. This value can be overridden in the PathMatcher configuration of the UrlMap that references this backend service. This field is only allowed when the loadBalancingScheme of the backend service is INTERNAL_SELF_MANAGED. + * Specifies the default maximum duration (timeout) for streams to this + * service. Duration is computed from the beginning of the stream until the + * response has been completely processed, including all retries. A stream + * that does not complete in this duration is closed. + * If not specified, there will be no timeout limit, i.e. the maximum + * duration is infinite. + * This value can be overridden in the PathMatcher configuration of the + * UrlMap that references this backend service. + * This field is only allowed when the loadBalancingScheme of + * the backend service is INTERNAL_SELF_MANAGED. * * Generated from protobuf field optional .google.cloud.compute.v1.Duration max_stream_duration = 61428376; */ protected $max_stream_duration = null; /** - * Deployment metadata associated with the resource to be set by a GKE hub controller and read by the backend RCTH + * Deployment metadata associated with the resource to be set by a GKE hub + * controller and read by the backend RCTH * * Generated from protobuf field map metadatas = 8514340; */ private $metadatas; /** - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * * Generated from protobuf field optional string name = 3373707; */ protected $name = null; /** - * The URL of the network to which this backend service belongs. This field must be set for Internal Passthrough Network Load Balancers when the haPolicy is enabled, and for External Passthrough Network Load Balancers when the haPolicy fastIpMove is enabled. This field can only be specified when the load balancing scheme is set to INTERNAL, or when the load balancing scheme is set to EXTERNAL and haPolicy fastIpMove is enabled. + * The URL of the network to which this backend service belongs. + * This field must be set for Internal Passthrough Network Load Balancers when + * the haPolicy is enabled, and for External Passthrough Network Load + * Balancers when the haPolicy fastIpMove is enabled. + * This field can only be specified when the load balancing scheme is set toINTERNAL, or when the load balancing scheme is set toEXTERNAL and haPolicy fastIpMove is enabled. * * Generated from protobuf field optional string network = 232872494; */ protected $network = null; /** - * Settings controlling the ejection of unhealthy backend endpoints from the load balancing pool of each individual proxy instance that processes the traffic for the given backend service. If not set, this feature is considered disabled. Results of the outlier detection algorithm (ejection of endpoints from the load balancing pool and returning them back to the pool) are executed independently by each proxy instance of the load balancer. In most cases, more than one proxy instance handles the traffic received by a backend service. Thus, it is possible that an unhealthy endpoint is detected and ejected by only some of the proxies, and while this happens, other proxies may continue to send requests to the same unhealthy endpoint until they detect and eject the unhealthy endpoint. Applicable backend endpoints can be: - VM instances in an Instance Group - Endpoints in a Zonal NEG (GCE_VM_IP, GCE_VM_IP_PORT) - Endpoints in a Hybrid Connectivity NEG (NON_GCP_PRIVATE_IP_PORT) - Serverless NEGs, that resolve to Cloud Run, App Engine, or Cloud Functions Services - Private Service Connect NEGs, that resolve to Google-managed regional API endpoints or managed services published using Private Service Connect Applicable backend service types can be: - A global backend service with the loadBalancingScheme set to INTERNAL_SELF_MANAGED or EXTERNAL_MANAGED. - A regional backend service with the serviceProtocol set to HTTP, HTTPS, HTTP2 or H2C, and loadBalancingScheme set to INTERNAL_MANAGED or EXTERNAL_MANAGED. Not supported for Serverless NEGs. Not supported when the backend service is referenced by a URL map that is bound to target gRPC proxy that has validateForProxyless field set to true. + * Settings controlling the ejection of unhealthy backend endpoints from the + * load balancing pool of each individual proxy instance that processes the + * traffic for the given backend service. If not set, this feature is + * considered disabled. + * Results of the outlier detection algorithm (ejection of endpoints from the + * load balancing pool and returning them back to the pool) are executed + * independently by each proxy instance of the load balancer. In most cases, + * more than one proxy instance handles the traffic received by a backend + * service. Thus, it is possible that an unhealthy endpoint is detected and + * ejected by only some of the proxies, and while this happens, other proxies + * may continue to send requests to the same unhealthy endpoint until they + * detect and eject the unhealthy endpoint. + * Applicable backend endpoints can be: + * - VM instances in an Instance Group + * - Endpoints in a Zonal NEG (GCE_VM_IP, GCE_VM_IP_PORT) + * - Endpoints in a Hybrid Connectivity NEG (NON_GCP_PRIVATE_IP_PORT) + * - Serverless NEGs, that resolve to Cloud Run, App Engine, or Cloud + * Functions Services + * - Private Service Connect NEGs, that resolve to + * Google-managed regional API endpoints or managed services published using + * Private Service Connect + * Applicable backend service types can be: + * - A global backend service with the loadBalancingScheme set to + * INTERNAL_SELF_MANAGED or EXTERNAL_MANAGED. + * - A regional backend + * service with the serviceProtocol set to HTTP, HTTPS, HTTP2 or H2C, and + * loadBalancingScheme set to INTERNAL_MANAGED or EXTERNAL_MANAGED. Not + * supported for Serverless NEGs. + * Not supported when the backend service is referenced by a URL map that is + * bound to target gRPC proxy that has validateForProxyless field set to true. * * Generated from protobuf field optional .google.cloud.compute.v1.OutlierDetection outlier_detection = 354625086; */ protected $outlier_detection = null; /** - * Input only. [Input Only] Additional params passed with the request, but not persisted as part of resource payload. + * Input only. [Input Only] Additional params passed with the request, but not persisted + * as part of resource payload. * * Generated from protobuf field optional .google.cloud.compute.v1.BackendServiceParams params = 78313862; */ protected $params = null; /** - * Deprecated in favor of portName. The TCP port to connect on the backend. The default value is 80. For internal passthrough Network Load Balancers and external passthrough Network Load Balancers, omit port. + * Deprecated in favor of portName. The TCP port to connect on + * the backend. The default value is 80. + * For internal passthrough Network Load Balancers and external passthrough + * Network Load Balancers, omit port. * * Generated from protobuf field optional int32 port = 3446913; */ protected $port = null; /** - * A named port on a backend instance group representing the port for communication to the backend VMs in that group. The named port must be [defined on each backend instance group](https://cloud.google.com/load-balancing/docs/backend-service#named_ports). This parameter has no meaning if the backends are NEGs. For internal passthrough Network Load Balancers and external passthrough Network Load Balancers, omit port_name. + * A named port on a backend instance group representing the port for + * communication to the backend VMs in that group. The + * named port must be [defined on each backend instance + * group](https://cloud.google.com/load-balancing/docs/backend-service#named_ports). + * This parameter has no meaning if the backends are NEGs. For internal + * passthrough Network Load Balancers and external passthrough Network Load + * Balancers, omit port_name. * * Generated from protobuf field optional string port_name = 41534345; */ protected $port_name = null; /** - * The protocol this BackendService uses to communicate with backends. Possible values are HTTP, HTTPS, HTTP2, H2C, TCP, SSL, UDP or GRPC. depending on the chosen load balancer or Traffic Director configuration. Refer to the documentation for the load balancers or for Traffic Director for more information. Must be set to GRPC when the backend service is referenced by a URL map that is bound to target gRPC proxy. + * The protocol this BackendService uses to communicate + * with backends. + * Possible values are HTTP, HTTPS, HTTP2, H2C, TCP, SSL, UDP or GRPC. + * depending on the chosen load balancer or Traffic Director configuration. + * Refer to the documentation for the load balancers or for Traffic Director + * for more information. + * Must be set to GRPC when the backend service is referenced by a URL map + * that is bound to target gRPC proxy. * Check the Protocol enum for the list of possible values. * * Generated from protobuf field optional string protocol = 84577944; */ protected $protocol = null; /** - * [Output Only] URL of the region where the regional backend service resides. This field is not applicable to global backend services. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * [Output Only] URL of the region where the regional backend service + * resides. This field is not applicable to global backend services. + * You must specify this field as part of the HTTP request URL. It is + * not settable as a field in the request body. * * Generated from protobuf field optional string region = 138946292; */ protected $region = null; /** - * [Output Only] The resource URL for the security policy associated with this backend service. + * [Output Only] The resource URL for the security policy associated with this + * backend service. * * Generated from protobuf field optional string security_policy = 171082513; */ protected $security_policy = null; /** - * This field specifies the security settings that apply to this backend service. This field is applicable to a global backend service with the load_balancing_scheme set to INTERNAL_SELF_MANAGED. + * This field specifies the security settings that apply to this backend + * service. This field is applicable to a global backend service with the + * load_balancing_scheme set to INTERNAL_SELF_MANAGED. * * Generated from protobuf field optional .google.cloud.compute.v1.SecuritySettings security_settings = 478649922; */ @@ -272,26 +536,38 @@ class BackendService extends \Google\Protobuf\Internal\Message */ protected $self_link = null; /** - * URLs of networkservices.ServiceBinding resources. Can only be set if load balancing scheme is INTERNAL_SELF_MANAGED. If set, lists of backends and health checks must be both empty. + * URLs of networkservices.ServiceBinding resources. + * Can only be set if load balancing scheme is INTERNAL_SELF_MANAGED. + * If set, lists of backends and health checks must be both empty. * * Generated from protobuf field repeated string service_bindings = 133581016; */ private $service_bindings; /** - * URL to networkservices.ServiceLbPolicy resource. Can only be set if load balancing scheme is EXTERNAL_MANAGED, INTERNAL_MANAGED or INTERNAL_SELF_MANAGED and the scope is global. + * URL to networkservices.ServiceLbPolicy resource. + * Can only be set if load balancing scheme is EXTERNAL_MANAGED, + * INTERNAL_MANAGED or INTERNAL_SELF_MANAGED and the scope is global. * * Generated from protobuf field optional string service_lb_policy = 94848785; */ protected $service_lb_policy = null; /** - * Type of session affinity to use. The default is NONE. Only NONE and HEADER_FIELD are supported when the backend service is referenced by a URL map that is bound to target gRPC proxy that has validateForProxyless field set to true. For more details, see: [Session Affinity](https://cloud.google.com/load-balancing/docs/backend-service#session_affinity). sessionAffinity cannot be specified with haPolicy. + * Type of session affinity to use. The default is NONE. + * Only NONE and HEADER_FIELD are supported + * when the backend service is referenced by a URL map that is bound to + * target gRPC proxy that has validateForProxyless field set to true. + * For more details, see: + * [Session + * Affinity](https://cloud.google.com/load-balancing/docs/backend-service#session_affinity). + * sessionAffinity cannot be specified with haPolicy. * Check the SessionAffinity enum for the list of possible values. * * Generated from protobuf field optional string session_affinity = 463888561; */ protected $session_affinity = null; /** - * Describes the HTTP cookie used for stateful session affinity. This field is applicable and required if the sessionAffinity is set to STRONG_COOKIE_AFFINITY. + * Describes the HTTP cookie used for stateful session affinity. This field is + * applicable and required if the sessionAffinity is set toSTRONG_COOKIE_AFFINITY. * * Generated from protobuf field optional .google.cloud.compute.v1.BackendServiceHttpCookie strong_session_affinity_cookie = 238195722; */ @@ -303,13 +579,24 @@ class BackendService extends \Google\Protobuf\Internal\Message */ protected $subsetting = null; /** - * The backend service timeout has a different meaning depending on the type of load balancer. For more information see, Backend service settings. The default is 30 seconds. The full range of timeout values allowed goes from 1 through 2,147,483,647 seconds. This value can be overridden in the PathMatcher configuration of the UrlMap that references this backend service. Not supported when the backend service is referenced by a URL map that is bound to target gRPC proxy that has validateForProxyless field set to true. Instead, use maxStreamDuration. + * The backend service timeout has a different meaning depending on the + * type of load balancer. For more information see, + * Backend service settings. + * The default is 30 seconds. + * The full range of timeout values allowed goes from 1 + * through 2,147,483,647 seconds. + * This value can be overridden in the PathMatcher configuration of the + * UrlMap that references this backend service. + * Not supported when the backend service is referenced by a URL map that is + * bound to target gRPC proxy that has validateForProxyless field set to true. + * Instead, use maxStreamDuration. * * Generated from protobuf field optional int32 timeout_sec = 79994995; */ protected $timeout_sec = null; /** - * Configuration for Backend Authenticated TLS and mTLS. May only be specified when the backend protocol is SSL, HTTPS or HTTP2. + * Configuration for Backend Authenticated TLS and mTLS. May only be specified + * when the backend protocol is SSL, HTTPS or HTTP2. * * Generated from protobuf field optional .google.cloud.compute.v1.BackendServiceTlsSettings tls_settings = 81794791; */ @@ -328,109 +615,383 @@ class BackendService extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type int $affinity_cookie_ttl_sec - * Lifetime of cookies in seconds. This setting is applicable to Application Load Balancers and Traffic Director and requires GENERATED_COOKIE or HTTP_COOKIE session affinity. If set to 0, the cookie is non-persistent and lasts only until the end of the browser session (or equivalent). The maximum allowed value is two weeks (1,209,600). Not supported when the backend service is referenced by a URL map that is bound to target gRPC proxy that has validateForProxyless field set to true. + * Lifetime of cookies in seconds. This setting is applicable to Application + * Load Balancers and Traffic Director and requires + * GENERATED_COOKIE or HTTP_COOKIE session affinity. + * If set to 0, the cookie is non-persistent and lasts only until + * the end of the browser session (or equivalent). The maximum allowed value + * is two weeks (1,209,600). + * Not supported when the backend service is referenced by a URL map that is + * bound to target gRPC proxy that has validateForProxyless field set to true. * @type array<\Google\Cloud\Compute\V1\Backend>|\Google\Protobuf\Internal\RepeatedField $backends * The list of backends that serve this BackendService. * @type \Google\Cloud\Compute\V1\BackendServiceCdnPolicy $cdn_policy - * Cloud CDN configuration for this BackendService. Only available for specified load balancer types. + * Cloud CDN configuration for this BackendService. Only available for + * specified load balancer types. * @type \Google\Cloud\Compute\V1\CircuitBreakers $circuit_breakers * @type string $compression_mode - * Compress text responses using Brotli or gzip compression, based on the client's Accept-Encoding header. + * Compress text responses using Brotli or gzip compression, based on + * the client's Accept-Encoding header. * Check the CompressionMode enum for the list of possible values. * @type \Google\Cloud\Compute\V1\ConnectionDraining $connection_draining * connectionDraining cannot be specified with haPolicy. * @type \Google\Cloud\Compute\V1\BackendServiceConnectionTrackingPolicy $connection_tracking_policy - * Connection Tracking configuration for this BackendService. Connection tracking policy settings are only available for external passthrough Network Load Balancers and internal passthrough Network Load Balancers. connectionTrackingPolicy cannot be specified with haPolicy. + * Connection Tracking configuration for this BackendService. Connection + * tracking policy settings are only available for external passthrough + * Network Load Balancers and internal passthrough Network Load Balancers. + * connectionTrackingPolicy cannot be specified with haPolicy. * @type \Google\Cloud\Compute\V1\ConsistentHashLoadBalancerSettings $consistent_hash - * Consistent Hash-based load balancing can be used to provide soft session affinity based on HTTP headers, cookies or other properties. This load balancing policy is applicable only for HTTP connections. The affinity to a particular destination host will be lost when one or more hosts are added/removed from the destination service. This field specifies parameters that control consistent hashing. This field is only applicable when localityLbPolicy is set to MAGLEV or RING_HASH. This field is applicable to either: - A regional backend service with the service_protocol set to HTTP, HTTPS, HTTP2 or H2C, and load_balancing_scheme set to INTERNAL_MANAGED. - A global backend service with the load_balancing_scheme set to INTERNAL_SELF_MANAGED. + * Consistent Hash-based load balancing can be used to provide soft session + * affinity based on HTTP headers, cookies or other properties. This load + * balancing policy is applicable only for HTTP connections. The affinity to a + * particular destination host will be lost when one or more hosts are + * added/removed from the destination service. This field specifies parameters + * that control consistent hashing. This field is only applicable whenlocalityLbPolicy is set to MAGLEV orRING_HASH. + * This field is applicable to either: + * - A regional backend service with the service_protocol set to HTTP, + * HTTPS, HTTP2 or H2C, and load_balancing_scheme set to + * INTERNAL_MANAGED. + * - A global backend service with the + * load_balancing_scheme set to INTERNAL_SELF_MANAGED. * @type string $creation_timestamp - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * @type array<\Google\Cloud\Compute\V1\BackendServiceCustomMetric>|\Google\Protobuf\Internal\RepeatedField $custom_metrics - * List of custom metrics that are used for the WEIGHTED_ROUND_ROBIN locality_lb_policy. + * List of custom metrics that are used for theWEIGHTED_ROUND_ROBIN locality_lb_policy. * @type array|\Google\Protobuf\Internal\RepeatedField $custom_request_headers - * Headers that the load balancer adds to proxied requests. See [Creating custom headers](https://cloud.google.com/load-balancing/docs/custom-headers). + * Headers that the load balancer adds to proxied requests. See [Creating + * custom + * headers](https://cloud.google.com/load-balancing/docs/custom-headers). * @type array|\Google\Protobuf\Internal\RepeatedField $custom_response_headers - * Headers that the load balancer adds to proxied responses. See [Creating custom headers](https://cloud.google.com/load-balancing/docs/custom-headers). + * Headers that the load balancer adds to proxied responses. See [Creating + * custom + * headers](https://cloud.google.com/load-balancing/docs/custom-headers). * @type string $description - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * @type string $edge_security_policy - * [Output Only] The resource URL for the edge security policy associated with this backend service. + * [Output Only] The resource URL for the edge security policy associated with + * this backend service. * @type bool $enable_c_d_n - * If true, enables Cloud CDN for the backend service of a global external Application Load Balancer. + * If true, enables Cloud CDN for the backend service of a + * global external Application Load Balancer. * @type string $external_managed_migration_state - * Specifies the canary migration state. Possible values are PREPARE, TEST_BY_PERCENTAGE, and TEST_ALL_TRAFFIC. To begin the migration from EXTERNAL to EXTERNAL_MANAGED, the state must be changed to PREPARE. The state must be changed to TEST_ALL_TRAFFIC before the loadBalancingScheme can be changed to EXTERNAL_MANAGED. Optionally, the TEST_BY_PERCENTAGE state can be used to migrate traffic by percentage using externalManagedMigrationTestingPercentage. Rolling back a migration requires the states to be set in reverse order. So changing the scheme from EXTERNAL_MANAGED to EXTERNAL requires the state to be set to TEST_ALL_TRAFFIC at the same time. Optionally, the TEST_BY_PERCENTAGE state can be used to migrate some traffic back to EXTERNAL or PREPARE can be used to migrate all traffic back to EXTERNAL. + * Specifies the canary migration state. Possible values are PREPARE, + * TEST_BY_PERCENTAGE, and TEST_ALL_TRAFFIC. + * To begin the migration from EXTERNAL to EXTERNAL_MANAGED, the state must be + * changed to PREPARE. The state must be changed to TEST_ALL_TRAFFIC before + * the loadBalancingScheme can be changed to EXTERNAL_MANAGED. Optionally, the + * TEST_BY_PERCENTAGE state can be used to migrate traffic by percentage using + * externalManagedMigrationTestingPercentage. + * Rolling back a migration requires the states to be set in reverse order. So + * changing the scheme from EXTERNAL_MANAGED to EXTERNAL requires the state to + * be set to TEST_ALL_TRAFFIC at the same time. Optionally, the + * TEST_BY_PERCENTAGE state can be used to migrate some traffic back to + * EXTERNAL or PREPARE can be used to migrate all traffic back to EXTERNAL. * Check the ExternalManagedMigrationState enum for the list of possible values. * @type float $external_managed_migration_testing_percentage - * Determines the fraction of requests that should be processed by the Global external Application Load Balancer. The value of this field must be in the range [0, 100]. Session affinity options will slightly affect this routing behavior, for more details, see: Session Affinity. This value can only be set if the loadBalancingScheme in the BackendService is set to EXTERNAL (when using the classic Application Load Balancer) and the migration state is TEST_BY_PERCENTAGE. + * Determines the fraction of requests that should be processed by the Global + * external Application Load Balancer. + * The value of this field must be in the range [0, 100]. + * Session affinity options will slightly affect this routing behavior, for + * more details, see:Session + * Affinity. + * This value can only be set if the loadBalancingScheme in the BackendService + * is set to EXTERNAL (when using the classic Application Load Balancer) and + * the migration state is TEST_BY_PERCENTAGE. * @type \Google\Cloud\Compute\V1\BackendServiceFailoverPolicy $failover_policy - * Requires at least one backend instance group to be defined as a backup (failover) backend. For load balancers that have configurable failover: [Internal passthrough Network Load Balancers](https://cloud.google.com/load-balancing/docs/internal/failover-overview) and [external passthrough Network Load Balancers](https://cloud.google.com/load-balancing/docs/network/networklb-failover-overview). failoverPolicy cannot be specified with haPolicy. + * Requires at least one backend instance group to be defined + * as a backup (failover) backend. + * For load balancers that have configurable failover: + * [Internal passthrough Network Load + * Balancers](https://cloud.google.com/load-balancing/docs/internal/failover-overview) + * and [external passthrough Network Load + * Balancers](https://cloud.google.com/load-balancing/docs/network/networklb-failover-overview). + * failoverPolicy cannot be specified with haPolicy. * @type string $fingerprint - * Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking. This field will be ignored when inserting a BackendService. An up-to-date fingerprint must be provided in order to update the BackendService, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a BackendService. + * Fingerprint of this resource. A hash of the contents stored in this object. + * This field is used in optimistic locking. This field will be ignored when + * inserting a BackendService. An up-to-date fingerprint must be provided in + * order to update the BackendService, otherwise the request will + * fail with error 412 conditionNotMet. + * To see the latest fingerprint, make a get() request to + * retrieve a BackendService. * @type \Google\Cloud\Compute\V1\BackendServiceHAPolicy $ha_policy - * Configures self-managed High Availability (HA) for External and Internal Protocol Forwarding. The backends of this regional backend service must only specify zonal network endpoint groups (NEGs) of type GCE_VM_IP. When haPolicy is set for an Internal Passthrough Network Load Balancer, the regional backend service must set the network field. All zonal NEGs must belong to the same network. However, individual NEGs can belong to different subnetworks of that network. When haPolicy is specified, the set of attached network endpoints across all backends comprise an High Availability domain from which one endpoint is selected as the active endpoint (the leader) that receives all traffic. haPolicy can be added only at backend service creation time. Once set up, it cannot be deleted. Note that haPolicy is not for load balancing, and therefore cannot be specified with sessionAffinity, connectionTrackingPolicy, and failoverPolicy. haPolicy requires customers to be responsible for tracking backend endpoint health and electing a leader among the healthy endpoints. Therefore, haPolicy cannot be specified with healthChecks. haPolicy can only be specified for External Passthrough Network Load Balancers and Internal Passthrough Network Load Balancers. + * Configures self-managed High Availability (HA) for External and Internal + * Protocol Forwarding. + * The backends of this regional backend service must only specify zonal + * network endpoint groups (NEGs) of type GCE_VM_IP. + * When haPolicy is set for an Internal Passthrough Network Load Balancer, the + * regional backend service must set the network field. All zonal NEGs must + * belong to the same network. However, individual NEGs can + * belong to different subnetworks of that network. + * When haPolicy is specified, the set of attached network endpoints across + * all backends comprise an High Availability domain from which one endpoint + * is selected as the active endpoint (the leader) that receives all + * traffic. + * haPolicy can be added only at backend service creation time. Once set up, + * it cannot be deleted. + * Note that haPolicy is not for load balancing, and therefore cannot be + * specified with sessionAffinity, connectionTrackingPolicy, and + * failoverPolicy. + * haPolicy requires customers to be responsible for tracking backend + * endpoint health and electing a leader among the healthy endpoints. + * Therefore, haPolicy cannot be specified with healthChecks. + * haPolicy can only be specified for External Passthrough Network Load + * Balancers and Internal Passthrough Network Load Balancers. * @type array|\Google\Protobuf\Internal\RepeatedField $health_checks - * The list of URLs to the healthChecks, httpHealthChecks (legacy), or httpsHealthChecks (legacy) resource for health checking this backend service. Not all backend services support legacy health checks. See Load balancer guide. Currently, at most one health check can be specified for each backend service. Backend services with instance group or zonal NEG backends must have a health check unless haPolicy is specified. Backend services with internet or serverless NEG backends must not have a health check. healthChecks[] cannot be specified with haPolicy. + * The list of URLs to the healthChecks, httpHealthChecks (legacy), or + * httpsHealthChecks (legacy) resource for health checking this backend + * service. Not all backend services support legacy health checks. See + * Load balancer guide. Currently, at most one health check can be + * specified for each backend service. Backend services with + * instance group or zonal NEG backends must have a health check unless + * haPolicy is specified. Backend services with internet or serverless NEG + * backends must not have a health check. + * healthChecks[] cannot be specified with haPolicy. * @type \Google\Cloud\Compute\V1\BackendServiceIAP $iap - * The configurations for Identity-Aware Proxy on this resource. Not available for internal passthrough Network Load Balancers and external passthrough Network Load Balancers. + * The configurations for Identity-Aware Proxy on this resource. + * Not available for internal passthrough Network Load Balancers and external + * passthrough Network Load Balancers. * @type int|string $id - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * @type string $ip_address_selection_policy - * Specifies a preference for traffic sent from the proxy to the backend (or from the client to the backend for proxyless gRPC). The possible values are: - IPV4_ONLY: Only send IPv4 traffic to the backends of the backend service (Instance Group, Managed Instance Group, Network Endpoint Group), regardless of traffic from the client to the proxy. Only IPv4 health checks are used to check the health of the backends. This is the default setting. - PREFER_IPV6: Prioritize the connection to the endpoint's IPv6 address over its IPv4 address (provided there is a healthy IPv6 address). - IPV6_ONLY: Only send IPv6 traffic to the backends of the backend service (Instance Group, Managed Instance Group, Network Endpoint Group), regardless of traffic from the client to the proxy. Only IPv6 health checks are used to check the health of the backends. This field is applicable to either: - Advanced global external Application Load Balancer (load balancing scheme EXTERNAL_MANAGED), - Regional external Application Load Balancer, - Internal proxy Network Load Balancer (load balancing scheme INTERNAL_MANAGED), - Regional internal Application Load Balancer (load balancing scheme INTERNAL_MANAGED), - Traffic Director with Envoy proxies and proxyless gRPC (load balancing scheme INTERNAL_SELF_MANAGED). + * Specifies a preference for traffic sent from the proxy to the backend (or + * from the client to the backend for proxyless gRPC). + * The possible values are: + * - IPV4_ONLY: Only send IPv4 traffic to the backends of the + * backend service (Instance Group, Managed Instance Group, Network Endpoint + * Group), regardless of traffic from the client to the proxy. Only IPv4 + * health checks are used to check the health of the backends. This is the + * default setting. + * - PREFER_IPV6: Prioritize the connection to the endpoint's + * IPv6 address over its IPv4 address (provided there is a healthy IPv6 + * address). + * - IPV6_ONLY: Only send IPv6 traffic to the backends of the + * backend service (Instance Group, Managed Instance Group, Network Endpoint + * Group), regardless of traffic from the client to the proxy. Only IPv6 + * health checks are used to check the health of the backends. + * This field is applicable to either: + * - Advanced global external Application Load Balancer (load balancing + * scheme EXTERNAL_MANAGED), + * - Regional external Application Load + * Balancer, + * - Internal proxy Network Load Balancer (load balancing + * scheme INTERNAL_MANAGED), + * - Regional internal Application Load + * Balancer (load balancing scheme INTERNAL_MANAGED), + * - Traffic + * Director with Envoy proxies and proxyless gRPC (load balancing scheme + * INTERNAL_SELF_MANAGED). * Check the IpAddressSelectionPolicy enum for the list of possible values. * @type string $kind - * [Output Only] Type of resource. Always compute#backendService for backend services. + * [Output Only] Type of resource. Always compute#backendService + * for backend services. * @type string $load_balancing_scheme - * Specifies the load balancer type. A backend service created for one type of load balancer cannot be used with another. For more information, refer to Choosing a load balancer. + * Specifies the load balancer type. A backend service + * created for one type of load balancer cannot be used with another. + * For more information, refer toChoosing + * a load balancer. * Check the LoadBalancingScheme enum for the list of possible values. * @type array<\Google\Cloud\Compute\V1\BackendServiceLocalityLoadBalancingPolicyConfig>|\Google\Protobuf\Internal\RepeatedField $locality_lb_policies - * A list of locality load-balancing policies to be used in order of preference. When you use localityLbPolicies, you must set at least one value for either the localityLbPolicies[].policy or the localityLbPolicies[].customPolicy field. localityLbPolicies overrides any value set in the localityLbPolicy field. For an example of how to use this field, see Define a list of preferred policies. Caution: This field and its children are intended for use in a service mesh that includes gRPC clients only. Envoy proxies can't use backend services that have this configuration. + * A list of locality load-balancing policies to be used in order of + * preference. When you use localityLbPolicies, you must set at least one + * value for either the localityLbPolicies[].policy or the + * localityLbPolicies[].customPolicy field. localityLbPolicies overrides any + * value set in the localityLbPolicy field. + * For an example of how to use this field, seeDefine + * a list of preferred policies. + * Caution: This field and its children are intended for use in a service mesh + * that includes gRPC clients only. Envoy proxies can't use backend services + * that have this configuration. * @type string $locality_lb_policy - * The load balancing algorithm used within the scope of the locality. The possible values are: - ROUND_ROBIN: This is a simple policy in which each healthy backend is selected in round robin order. This is the default. - LEAST_REQUEST: An O(1) algorithm which selects two random healthy hosts and picks the host which has fewer active requests. - RING_HASH: The ring/modulo hash load balancer implements consistent hashing to backends. The algorithm has the property that the addition/removal of a host from a set of N hosts only affects 1/N of the requests. - RANDOM: The load balancer selects a random healthy host. - ORIGINAL_DESTINATION: Backend host is selected based on the client connection metadata, i.e., connections are opened to the same address as the destination address of the incoming connection before the connection was redirected to the load balancer. - MAGLEV: used as a drop in replacement for the ring hash load balancer. Maglev is not as stable as ring hash but has faster table lookup build times and host selection times. For more information about Maglev, see Maglev: A Fast and Reliable Software Network Load Balancer. - WEIGHTED_ROUND_ROBIN: Per-endpoint Weighted Round Robin Load Balancing using weights computed from Backend reported Custom Metrics. If set, the Backend Service responses are expected to contain non-standard HTTP response header field Endpoint-Load-Metrics. The reported metrics to use for computing the weights are specified via the customMetrics field. This field is applicable to either: - A regional backend service with the service_protocol set to HTTP, HTTPS, HTTP2 or H2C, and load_balancing_scheme set to INTERNAL_MANAGED. - A global backend service with the load_balancing_scheme set to INTERNAL_SELF_MANAGED, INTERNAL_MANAGED, or EXTERNAL_MANAGED. If sessionAffinity is not configured—that is, if session affinity remains at the default value of NONE—then the default value for localityLbPolicy is ROUND_ROBIN. If session affinity is set to a value other than NONE, then the default value for localityLbPolicy is MAGLEV. Only ROUND_ROBIN and RING_HASH are supported when the backend service is referenced by a URL map that is bound to target gRPC proxy that has validateForProxyless field set to true. localityLbPolicy cannot be specified with haPolicy. + * The load balancing algorithm used within the scope of the locality. The + * possible values are: + * - ROUND_ROBIN: This is a simple policy in which each healthy + * backend is selected in round robin order. This is the default. + * - LEAST_REQUEST: An O(1) algorithm which + * selects two random healthy hosts and picks the host which has fewer active + * requests. + * - RING_HASH: The ring/modulo hash load balancer implements + * consistent hashing to backends. The algorithm has the property that the + * addition/removal of a host from a set of N hosts only affects 1/N of the + * requests. + * - RANDOM: The load balancer selects a random healthy + * host. + * - ORIGINAL_DESTINATION: Backend host is selected + * based on the client connection metadata, i.e., connections are opened to + * the same address as the destination address of the incoming connection + * before the connection was redirected to the load balancer. + * - MAGLEV: used as a drop in replacement for the ring hash + * load balancer. Maglev is not as stable as ring hash but has faster table + * lookup build times and host selection times. For more information about + * Maglev, see Maglev: + * A Fast and Reliable Software Network Load Balancer. + * - WEIGHTED_ROUND_ROBIN: Per-endpoint Weighted Round Robin + * Load Balancing using weights computed from Backend reported Custom Metrics. + * If set, the Backend Service responses are expected to contain non-standard + * HTTP response header field Endpoint-Load-Metrics. The reported + * metrics to use for computing the weights are specified via thecustomMetrics field. + * This field is applicable to either: + * - A regional backend service with the service_protocol set to HTTP, + * HTTPS, HTTP2 or H2C, and load_balancing_scheme set to + * INTERNAL_MANAGED. + * - A global backend service with the + * load_balancing_scheme set to INTERNAL_SELF_MANAGED, INTERNAL_MANAGED, or + * EXTERNAL_MANAGED. + * If sessionAffinity is not configured—that is, if session + * affinity remains at the default value of NONE—then the + * default value for localityLbPolicy + * is ROUND_ROBIN. If session affinity is set to a value other + * than NONE, + * then the default value for localityLbPolicy isMAGLEV. + * Only ROUND_ROBIN and RING_HASH are supported + * when the backend service is referenced by a URL map that is bound to + * target gRPC proxy that has validateForProxyless field set to true. + * localityLbPolicy cannot be specified with haPolicy. * Check the LocalityLbPolicy enum for the list of possible values. * @type \Google\Cloud\Compute\V1\BackendServiceLogConfig $log_config - * This field denotes the logging options for the load balancer traffic served by this backend service. If logging is enabled, logs will be exported to Stackdriver. + * This field denotes the logging options for the load balancer traffic served + * by this backend service. If logging is enabled, logs will be exported to + * Stackdriver. * @type \Google\Cloud\Compute\V1\Duration $max_stream_duration - * Specifies the default maximum duration (timeout) for streams to this service. Duration is computed from the beginning of the stream until the response has been completely processed, including all retries. A stream that does not complete in this duration is closed. If not specified, there will be no timeout limit, i.e. the maximum duration is infinite. This value can be overridden in the PathMatcher configuration of the UrlMap that references this backend service. This field is only allowed when the loadBalancingScheme of the backend service is INTERNAL_SELF_MANAGED. + * Specifies the default maximum duration (timeout) for streams to this + * service. Duration is computed from the beginning of the stream until the + * response has been completely processed, including all retries. A stream + * that does not complete in this duration is closed. + * If not specified, there will be no timeout limit, i.e. the maximum + * duration is infinite. + * This value can be overridden in the PathMatcher configuration of the + * UrlMap that references this backend service. + * This field is only allowed when the loadBalancingScheme of + * the backend service is INTERNAL_SELF_MANAGED. * @type array|\Google\Protobuf\Internal\MapField $metadatas - * Deployment metadata associated with the resource to be set by a GKE hub controller and read by the backend RCTH + * Deployment metadata associated with the resource to be set by a GKE hub + * controller and read by the backend RCTH * @type string $name - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * @type string $network - * The URL of the network to which this backend service belongs. This field must be set for Internal Passthrough Network Load Balancers when the haPolicy is enabled, and for External Passthrough Network Load Balancers when the haPolicy fastIpMove is enabled. This field can only be specified when the load balancing scheme is set to INTERNAL, or when the load balancing scheme is set to EXTERNAL and haPolicy fastIpMove is enabled. + * The URL of the network to which this backend service belongs. + * This field must be set for Internal Passthrough Network Load Balancers when + * the haPolicy is enabled, and for External Passthrough Network Load + * Balancers when the haPolicy fastIpMove is enabled. + * This field can only be specified when the load balancing scheme is set toINTERNAL, or when the load balancing scheme is set toEXTERNAL and haPolicy fastIpMove is enabled. * @type \Google\Cloud\Compute\V1\OutlierDetection $outlier_detection - * Settings controlling the ejection of unhealthy backend endpoints from the load balancing pool of each individual proxy instance that processes the traffic for the given backend service. If not set, this feature is considered disabled. Results of the outlier detection algorithm (ejection of endpoints from the load balancing pool and returning them back to the pool) are executed independently by each proxy instance of the load balancer. In most cases, more than one proxy instance handles the traffic received by a backend service. Thus, it is possible that an unhealthy endpoint is detected and ejected by only some of the proxies, and while this happens, other proxies may continue to send requests to the same unhealthy endpoint until they detect and eject the unhealthy endpoint. Applicable backend endpoints can be: - VM instances in an Instance Group - Endpoints in a Zonal NEG (GCE_VM_IP, GCE_VM_IP_PORT) - Endpoints in a Hybrid Connectivity NEG (NON_GCP_PRIVATE_IP_PORT) - Serverless NEGs, that resolve to Cloud Run, App Engine, or Cloud Functions Services - Private Service Connect NEGs, that resolve to Google-managed regional API endpoints or managed services published using Private Service Connect Applicable backend service types can be: - A global backend service with the loadBalancingScheme set to INTERNAL_SELF_MANAGED or EXTERNAL_MANAGED. - A regional backend service with the serviceProtocol set to HTTP, HTTPS, HTTP2 or H2C, and loadBalancingScheme set to INTERNAL_MANAGED or EXTERNAL_MANAGED. Not supported for Serverless NEGs. Not supported when the backend service is referenced by a URL map that is bound to target gRPC proxy that has validateForProxyless field set to true. + * Settings controlling the ejection of unhealthy backend endpoints from the + * load balancing pool of each individual proxy instance that processes the + * traffic for the given backend service. If not set, this feature is + * considered disabled. + * Results of the outlier detection algorithm (ejection of endpoints from the + * load balancing pool and returning them back to the pool) are executed + * independently by each proxy instance of the load balancer. In most cases, + * more than one proxy instance handles the traffic received by a backend + * service. Thus, it is possible that an unhealthy endpoint is detected and + * ejected by only some of the proxies, and while this happens, other proxies + * may continue to send requests to the same unhealthy endpoint until they + * detect and eject the unhealthy endpoint. + * Applicable backend endpoints can be: + * - VM instances in an Instance Group + * - Endpoints in a Zonal NEG (GCE_VM_IP, GCE_VM_IP_PORT) + * - Endpoints in a Hybrid Connectivity NEG (NON_GCP_PRIVATE_IP_PORT) + * - Serverless NEGs, that resolve to Cloud Run, App Engine, or Cloud + * Functions Services + * - Private Service Connect NEGs, that resolve to + * Google-managed regional API endpoints or managed services published using + * Private Service Connect + * Applicable backend service types can be: + * - A global backend service with the loadBalancingScheme set to + * INTERNAL_SELF_MANAGED or EXTERNAL_MANAGED. + * - A regional backend + * service with the serviceProtocol set to HTTP, HTTPS, HTTP2 or H2C, and + * loadBalancingScheme set to INTERNAL_MANAGED or EXTERNAL_MANAGED. Not + * supported for Serverless NEGs. + * Not supported when the backend service is referenced by a URL map that is + * bound to target gRPC proxy that has validateForProxyless field set to true. * @type \Google\Cloud\Compute\V1\BackendServiceParams $params - * Input only. [Input Only] Additional params passed with the request, but not persisted as part of resource payload. + * Input only. [Input Only] Additional params passed with the request, but not persisted + * as part of resource payload. * @type int $port - * Deprecated in favor of portName. The TCP port to connect on the backend. The default value is 80. For internal passthrough Network Load Balancers and external passthrough Network Load Balancers, omit port. + * Deprecated in favor of portName. The TCP port to connect on + * the backend. The default value is 80. + * For internal passthrough Network Load Balancers and external passthrough + * Network Load Balancers, omit port. * @type string $port_name - * A named port on a backend instance group representing the port for communication to the backend VMs in that group. The named port must be [defined on each backend instance group](https://cloud.google.com/load-balancing/docs/backend-service#named_ports). This parameter has no meaning if the backends are NEGs. For internal passthrough Network Load Balancers and external passthrough Network Load Balancers, omit port_name. + * A named port on a backend instance group representing the port for + * communication to the backend VMs in that group. The + * named port must be [defined on each backend instance + * group](https://cloud.google.com/load-balancing/docs/backend-service#named_ports). + * This parameter has no meaning if the backends are NEGs. For internal + * passthrough Network Load Balancers and external passthrough Network Load + * Balancers, omit port_name. * @type string $protocol - * The protocol this BackendService uses to communicate with backends. Possible values are HTTP, HTTPS, HTTP2, H2C, TCP, SSL, UDP or GRPC. depending on the chosen load balancer or Traffic Director configuration. Refer to the documentation for the load balancers or for Traffic Director for more information. Must be set to GRPC when the backend service is referenced by a URL map that is bound to target gRPC proxy. + * The protocol this BackendService uses to communicate + * with backends. + * Possible values are HTTP, HTTPS, HTTP2, H2C, TCP, SSL, UDP or GRPC. + * depending on the chosen load balancer or Traffic Director configuration. + * Refer to the documentation for the load balancers or for Traffic Director + * for more information. + * Must be set to GRPC when the backend service is referenced by a URL map + * that is bound to target gRPC proxy. * Check the Protocol enum for the list of possible values. * @type string $region - * [Output Only] URL of the region where the regional backend service resides. This field is not applicable to global backend services. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * [Output Only] URL of the region where the regional backend service + * resides. This field is not applicable to global backend services. + * You must specify this field as part of the HTTP request URL. It is + * not settable as a field in the request body. * @type string $security_policy - * [Output Only] The resource URL for the security policy associated with this backend service. + * [Output Only] The resource URL for the security policy associated with this + * backend service. * @type \Google\Cloud\Compute\V1\SecuritySettings $security_settings - * This field specifies the security settings that apply to this backend service. This field is applicable to a global backend service with the load_balancing_scheme set to INTERNAL_SELF_MANAGED. + * This field specifies the security settings that apply to this backend + * service. This field is applicable to a global backend service with the + * load_balancing_scheme set to INTERNAL_SELF_MANAGED. * @type string $self_link * [Output Only] Server-defined URL for the resource. * @type array|\Google\Protobuf\Internal\RepeatedField $service_bindings - * URLs of networkservices.ServiceBinding resources. Can only be set if load balancing scheme is INTERNAL_SELF_MANAGED. If set, lists of backends and health checks must be both empty. + * URLs of networkservices.ServiceBinding resources. + * Can only be set if load balancing scheme is INTERNAL_SELF_MANAGED. + * If set, lists of backends and health checks must be both empty. * @type string $service_lb_policy - * URL to networkservices.ServiceLbPolicy resource. Can only be set if load balancing scheme is EXTERNAL_MANAGED, INTERNAL_MANAGED or INTERNAL_SELF_MANAGED and the scope is global. + * URL to networkservices.ServiceLbPolicy resource. + * Can only be set if load balancing scheme is EXTERNAL_MANAGED, + * INTERNAL_MANAGED or INTERNAL_SELF_MANAGED and the scope is global. * @type string $session_affinity - * Type of session affinity to use. The default is NONE. Only NONE and HEADER_FIELD are supported when the backend service is referenced by a URL map that is bound to target gRPC proxy that has validateForProxyless field set to true. For more details, see: [Session Affinity](https://cloud.google.com/load-balancing/docs/backend-service#session_affinity). sessionAffinity cannot be specified with haPolicy. + * Type of session affinity to use. The default is NONE. + * Only NONE and HEADER_FIELD are supported + * when the backend service is referenced by a URL map that is bound to + * target gRPC proxy that has validateForProxyless field set to true. + * For more details, see: + * [Session + * Affinity](https://cloud.google.com/load-balancing/docs/backend-service#session_affinity). + * sessionAffinity cannot be specified with haPolicy. * Check the SessionAffinity enum for the list of possible values. * @type \Google\Cloud\Compute\V1\BackendServiceHttpCookie $strong_session_affinity_cookie - * Describes the HTTP cookie used for stateful session affinity. This field is applicable and required if the sessionAffinity is set to STRONG_COOKIE_AFFINITY. + * Describes the HTTP cookie used for stateful session affinity. This field is + * applicable and required if the sessionAffinity is set toSTRONG_COOKIE_AFFINITY. * @type \Google\Cloud\Compute\V1\Subsetting $subsetting * subsetting cannot be specified with haPolicy. * @type int $timeout_sec - * The backend service timeout has a different meaning depending on the type of load balancer. For more information see, Backend service settings. The default is 30 seconds. The full range of timeout values allowed goes from 1 through 2,147,483,647 seconds. This value can be overridden in the PathMatcher configuration of the UrlMap that references this backend service. Not supported when the backend service is referenced by a URL map that is bound to target gRPC proxy that has validateForProxyless field set to true. Instead, use maxStreamDuration. + * The backend service timeout has a different meaning depending on the + * type of load balancer. For more information see, + * Backend service settings. + * The default is 30 seconds. + * The full range of timeout values allowed goes from 1 + * through 2,147,483,647 seconds. + * This value can be overridden in the PathMatcher configuration of the + * UrlMap that references this backend service. + * Not supported when the backend service is referenced by a URL map that is + * bound to target gRPC proxy that has validateForProxyless field set to true. + * Instead, use maxStreamDuration. * @type \Google\Cloud\Compute\V1\BackendServiceTlsSettings $tls_settings - * Configuration for Backend Authenticated TLS and mTLS. May only be specified when the backend protocol is SSL, HTTPS or HTTP2. + * Configuration for Backend Authenticated TLS and mTLS. May only be specified + * when the backend protocol is SSL, HTTPS or HTTP2. * @type array<\Google\Cloud\Compute\V1\BackendServiceUsedBy>|\Google\Protobuf\Internal\RepeatedField $used_by * [Output Only] List of resources referencing given backend service. * } @@ -441,7 +1002,14 @@ public function __construct($data = NULL) { } /** - * Lifetime of cookies in seconds. This setting is applicable to Application Load Balancers and Traffic Director and requires GENERATED_COOKIE or HTTP_COOKIE session affinity. If set to 0, the cookie is non-persistent and lasts only until the end of the browser session (or equivalent). The maximum allowed value is two weeks (1,209,600). Not supported when the backend service is referenced by a URL map that is bound to target gRPC proxy that has validateForProxyless field set to true. + * Lifetime of cookies in seconds. This setting is applicable to Application + * Load Balancers and Traffic Director and requires + * GENERATED_COOKIE or HTTP_COOKIE session affinity. + * If set to 0, the cookie is non-persistent and lasts only until + * the end of the browser session (or equivalent). The maximum allowed value + * is two weeks (1,209,600). + * Not supported when the backend service is referenced by a URL map that is + * bound to target gRPC proxy that has validateForProxyless field set to true. * * Generated from protobuf field optional int32 affinity_cookie_ttl_sec = 369996954; * @return int @@ -462,7 +1030,14 @@ public function clearAffinityCookieTtlSec() } /** - * Lifetime of cookies in seconds. This setting is applicable to Application Load Balancers and Traffic Director and requires GENERATED_COOKIE or HTTP_COOKIE session affinity. If set to 0, the cookie is non-persistent and lasts only until the end of the browser session (or equivalent). The maximum allowed value is two weeks (1,209,600). Not supported when the backend service is referenced by a URL map that is bound to target gRPC proxy that has validateForProxyless field set to true. + * Lifetime of cookies in seconds. This setting is applicable to Application + * Load Balancers and Traffic Director and requires + * GENERATED_COOKIE or HTTP_COOKIE session affinity. + * If set to 0, the cookie is non-persistent and lasts only until + * the end of the browser session (or equivalent). The maximum allowed value + * is two weeks (1,209,600). + * Not supported when the backend service is referenced by a URL map that is + * bound to target gRPC proxy that has validateForProxyless field set to true. * * Generated from protobuf field optional int32 affinity_cookie_ttl_sec = 369996954; * @param int $var @@ -503,7 +1078,8 @@ public function setBackends($var) } /** - * Cloud CDN configuration for this BackendService. Only available for specified load balancer types. + * Cloud CDN configuration for this BackendService. Only available for + * specified load balancer types. * * Generated from protobuf field optional .google.cloud.compute.v1.BackendServiceCdnPolicy cdn_policy = 213976452; * @return \Google\Cloud\Compute\V1\BackendServiceCdnPolicy|null @@ -524,7 +1100,8 @@ public function clearCdnPolicy() } /** - * Cloud CDN configuration for this BackendService. Only available for specified load balancer types. + * Cloud CDN configuration for this BackendService. Only available for + * specified load balancer types. * * Generated from protobuf field optional .google.cloud.compute.v1.BackendServiceCdnPolicy cdn_policy = 213976452; * @param \Google\Cloud\Compute\V1\BackendServiceCdnPolicy $var @@ -571,7 +1148,8 @@ public function setCircuitBreakers($var) } /** - * Compress text responses using Brotli or gzip compression, based on the client's Accept-Encoding header. + * Compress text responses using Brotli or gzip compression, based on + * the client's Accept-Encoding header. * Check the CompressionMode enum for the list of possible values. * * Generated from protobuf field optional string compression_mode = 95520988; @@ -593,7 +1171,8 @@ public function clearCompressionMode() } /** - * Compress text responses using Brotli or gzip compression, based on the client's Accept-Encoding header. + * Compress text responses using Brotli or gzip compression, based on + * the client's Accept-Encoding header. * Check the CompressionMode enum for the list of possible values. * * Generated from protobuf field optional string compression_mode = 95520988; @@ -645,7 +1224,10 @@ public function setConnectionDraining($var) } /** - * Connection Tracking configuration for this BackendService. Connection tracking policy settings are only available for external passthrough Network Load Balancers and internal passthrough Network Load Balancers. connectionTrackingPolicy cannot be specified with haPolicy. + * Connection Tracking configuration for this BackendService. Connection + * tracking policy settings are only available for external passthrough + * Network Load Balancers and internal passthrough Network Load Balancers. + * connectionTrackingPolicy cannot be specified with haPolicy. * * Generated from protobuf field optional .google.cloud.compute.v1.BackendServiceConnectionTrackingPolicy connection_tracking_policy = 143994969; * @return \Google\Cloud\Compute\V1\BackendServiceConnectionTrackingPolicy|null @@ -666,7 +1248,10 @@ public function clearConnectionTrackingPolicy() } /** - * Connection Tracking configuration for this BackendService. Connection tracking policy settings are only available for external passthrough Network Load Balancers and internal passthrough Network Load Balancers. connectionTrackingPolicy cannot be specified with haPolicy. + * Connection Tracking configuration for this BackendService. Connection + * tracking policy settings are only available for external passthrough + * Network Load Balancers and internal passthrough Network Load Balancers. + * connectionTrackingPolicy cannot be specified with haPolicy. * * Generated from protobuf field optional .google.cloud.compute.v1.BackendServiceConnectionTrackingPolicy connection_tracking_policy = 143994969; * @param \Google\Cloud\Compute\V1\BackendServiceConnectionTrackingPolicy $var @@ -681,7 +1266,18 @@ public function setConnectionTrackingPolicy($var) } /** - * Consistent Hash-based load balancing can be used to provide soft session affinity based on HTTP headers, cookies or other properties. This load balancing policy is applicable only for HTTP connections. The affinity to a particular destination host will be lost when one or more hosts are added/removed from the destination service. This field specifies parameters that control consistent hashing. This field is only applicable when localityLbPolicy is set to MAGLEV or RING_HASH. This field is applicable to either: - A regional backend service with the service_protocol set to HTTP, HTTPS, HTTP2 or H2C, and load_balancing_scheme set to INTERNAL_MANAGED. - A global backend service with the load_balancing_scheme set to INTERNAL_SELF_MANAGED. + * Consistent Hash-based load balancing can be used to provide soft session + * affinity based on HTTP headers, cookies or other properties. This load + * balancing policy is applicable only for HTTP connections. The affinity to a + * particular destination host will be lost when one or more hosts are + * added/removed from the destination service. This field specifies parameters + * that control consistent hashing. This field is only applicable whenlocalityLbPolicy is set to MAGLEV orRING_HASH. + * This field is applicable to either: + * - A regional backend service with the service_protocol set to HTTP, + * HTTPS, HTTP2 or H2C, and load_balancing_scheme set to + * INTERNAL_MANAGED. + * - A global backend service with the + * load_balancing_scheme set to INTERNAL_SELF_MANAGED. * * Generated from protobuf field optional .google.cloud.compute.v1.ConsistentHashLoadBalancerSettings consistent_hash = 905883; * @return \Google\Cloud\Compute\V1\ConsistentHashLoadBalancerSettings|null @@ -702,7 +1298,18 @@ public function clearConsistentHash() } /** - * Consistent Hash-based load balancing can be used to provide soft session affinity based on HTTP headers, cookies or other properties. This load balancing policy is applicable only for HTTP connections. The affinity to a particular destination host will be lost when one or more hosts are added/removed from the destination service. This field specifies parameters that control consistent hashing. This field is only applicable when localityLbPolicy is set to MAGLEV or RING_HASH. This field is applicable to either: - A regional backend service with the service_protocol set to HTTP, HTTPS, HTTP2 or H2C, and load_balancing_scheme set to INTERNAL_MANAGED. - A global backend service with the load_balancing_scheme set to INTERNAL_SELF_MANAGED. + * Consistent Hash-based load balancing can be used to provide soft session + * affinity based on HTTP headers, cookies or other properties. This load + * balancing policy is applicable only for HTTP connections. The affinity to a + * particular destination host will be lost when one or more hosts are + * added/removed from the destination service. This field specifies parameters + * that control consistent hashing. This field is only applicable whenlocalityLbPolicy is set to MAGLEV orRING_HASH. + * This field is applicable to either: + * - A regional backend service with the service_protocol set to HTTP, + * HTTPS, HTTP2 or H2C, and load_balancing_scheme set to + * INTERNAL_MANAGED. + * - A global backend service with the + * load_balancing_scheme set to INTERNAL_SELF_MANAGED. * * Generated from protobuf field optional .google.cloud.compute.v1.ConsistentHashLoadBalancerSettings consistent_hash = 905883; * @param \Google\Cloud\Compute\V1\ConsistentHashLoadBalancerSettings $var @@ -717,7 +1324,8 @@ public function setConsistentHash($var) } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @return string @@ -738,7 +1346,8 @@ public function clearCreationTimestamp() } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @param string $var @@ -753,7 +1362,7 @@ public function setCreationTimestamp($var) } /** - * List of custom metrics that are used for the WEIGHTED_ROUND_ROBIN locality_lb_policy. + * List of custom metrics that are used for theWEIGHTED_ROUND_ROBIN locality_lb_policy. * * Generated from protobuf field repeated .google.cloud.compute.v1.BackendServiceCustomMetric custom_metrics = 429453813; * @return \Google\Protobuf\Internal\RepeatedField @@ -764,7 +1373,7 @@ public function getCustomMetrics() } /** - * List of custom metrics that are used for the WEIGHTED_ROUND_ROBIN locality_lb_policy. + * List of custom metrics that are used for theWEIGHTED_ROUND_ROBIN locality_lb_policy. * * Generated from protobuf field repeated .google.cloud.compute.v1.BackendServiceCustomMetric custom_metrics = 429453813; * @param array<\Google\Cloud\Compute\V1\BackendServiceCustomMetric>|\Google\Protobuf\Internal\RepeatedField $var @@ -779,7 +1388,9 @@ public function setCustomMetrics($var) } /** - * Headers that the load balancer adds to proxied requests. See [Creating custom headers](https://cloud.google.com/load-balancing/docs/custom-headers). + * Headers that the load balancer adds to proxied requests. See [Creating + * custom + * headers](https://cloud.google.com/load-balancing/docs/custom-headers). * * Generated from protobuf field repeated string custom_request_headers = 27977992; * @return \Google\Protobuf\Internal\RepeatedField @@ -790,7 +1401,9 @@ public function getCustomRequestHeaders() } /** - * Headers that the load balancer adds to proxied requests. See [Creating custom headers](https://cloud.google.com/load-balancing/docs/custom-headers). + * Headers that the load balancer adds to proxied requests. See [Creating + * custom + * headers](https://cloud.google.com/load-balancing/docs/custom-headers). * * Generated from protobuf field repeated string custom_request_headers = 27977992; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -805,7 +1418,9 @@ public function setCustomRequestHeaders($var) } /** - * Headers that the load balancer adds to proxied responses. See [Creating custom headers](https://cloud.google.com/load-balancing/docs/custom-headers). + * Headers that the load balancer adds to proxied responses. See [Creating + * custom + * headers](https://cloud.google.com/load-balancing/docs/custom-headers). * * Generated from protobuf field repeated string custom_response_headers = 387539094; * @return \Google\Protobuf\Internal\RepeatedField @@ -816,7 +1431,9 @@ public function getCustomResponseHeaders() } /** - * Headers that the load balancer adds to proxied responses. See [Creating custom headers](https://cloud.google.com/load-balancing/docs/custom-headers). + * Headers that the load balancer adds to proxied responses. See [Creating + * custom + * headers](https://cloud.google.com/load-balancing/docs/custom-headers). * * Generated from protobuf field repeated string custom_response_headers = 387539094; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -831,7 +1448,8 @@ public function setCustomResponseHeaders($var) } /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @return string @@ -852,7 +1470,8 @@ public function clearDescription() } /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @param string $var @@ -867,7 +1486,8 @@ public function setDescription($var) } /** - * [Output Only] The resource URL for the edge security policy associated with this backend service. + * [Output Only] The resource URL for the edge security policy associated with + * this backend service. * * Generated from protobuf field optional string edge_security_policy = 41036943; * @return string @@ -888,7 +1508,8 @@ public function clearEdgeSecurityPolicy() } /** - * [Output Only] The resource URL for the edge security policy associated with this backend service. + * [Output Only] The resource URL for the edge security policy associated with + * this backend service. * * Generated from protobuf field optional string edge_security_policy = 41036943; * @param string $var @@ -903,7 +1524,8 @@ public function setEdgeSecurityPolicy($var) } /** - * If true, enables Cloud CDN for the backend service of a global external Application Load Balancer. + * If true, enables Cloud CDN for the backend service of a + * global external Application Load Balancer. * * Generated from protobuf field optional bool enable_c_d_n = 250733499; * @return bool @@ -924,7 +1546,8 @@ public function clearEnableCDN() } /** - * If true, enables Cloud CDN for the backend service of a global external Application Load Balancer. + * If true, enables Cloud CDN for the backend service of a + * global external Application Load Balancer. * * Generated from protobuf field optional bool enable_c_d_n = 250733499; * @param bool $var @@ -939,7 +1562,18 @@ public function setEnableCDN($var) } /** - * Specifies the canary migration state. Possible values are PREPARE, TEST_BY_PERCENTAGE, and TEST_ALL_TRAFFIC. To begin the migration from EXTERNAL to EXTERNAL_MANAGED, the state must be changed to PREPARE. The state must be changed to TEST_ALL_TRAFFIC before the loadBalancingScheme can be changed to EXTERNAL_MANAGED. Optionally, the TEST_BY_PERCENTAGE state can be used to migrate traffic by percentage using externalManagedMigrationTestingPercentage. Rolling back a migration requires the states to be set in reverse order. So changing the scheme from EXTERNAL_MANAGED to EXTERNAL requires the state to be set to TEST_ALL_TRAFFIC at the same time. Optionally, the TEST_BY_PERCENTAGE state can be used to migrate some traffic back to EXTERNAL or PREPARE can be used to migrate all traffic back to EXTERNAL. + * Specifies the canary migration state. Possible values are PREPARE, + * TEST_BY_PERCENTAGE, and TEST_ALL_TRAFFIC. + * To begin the migration from EXTERNAL to EXTERNAL_MANAGED, the state must be + * changed to PREPARE. The state must be changed to TEST_ALL_TRAFFIC before + * the loadBalancingScheme can be changed to EXTERNAL_MANAGED. Optionally, the + * TEST_BY_PERCENTAGE state can be used to migrate traffic by percentage using + * externalManagedMigrationTestingPercentage. + * Rolling back a migration requires the states to be set in reverse order. So + * changing the scheme from EXTERNAL_MANAGED to EXTERNAL requires the state to + * be set to TEST_ALL_TRAFFIC at the same time. Optionally, the + * TEST_BY_PERCENTAGE state can be used to migrate some traffic back to + * EXTERNAL or PREPARE can be used to migrate all traffic back to EXTERNAL. * Check the ExternalManagedMigrationState enum for the list of possible values. * * Generated from protobuf field optional string external_managed_migration_state = 66947020; @@ -961,7 +1595,18 @@ public function clearExternalManagedMigrationState() } /** - * Specifies the canary migration state. Possible values are PREPARE, TEST_BY_PERCENTAGE, and TEST_ALL_TRAFFIC. To begin the migration from EXTERNAL to EXTERNAL_MANAGED, the state must be changed to PREPARE. The state must be changed to TEST_ALL_TRAFFIC before the loadBalancingScheme can be changed to EXTERNAL_MANAGED. Optionally, the TEST_BY_PERCENTAGE state can be used to migrate traffic by percentage using externalManagedMigrationTestingPercentage. Rolling back a migration requires the states to be set in reverse order. So changing the scheme from EXTERNAL_MANAGED to EXTERNAL requires the state to be set to TEST_ALL_TRAFFIC at the same time. Optionally, the TEST_BY_PERCENTAGE state can be used to migrate some traffic back to EXTERNAL or PREPARE can be used to migrate all traffic back to EXTERNAL. + * Specifies the canary migration state. Possible values are PREPARE, + * TEST_BY_PERCENTAGE, and TEST_ALL_TRAFFIC. + * To begin the migration from EXTERNAL to EXTERNAL_MANAGED, the state must be + * changed to PREPARE. The state must be changed to TEST_ALL_TRAFFIC before + * the loadBalancingScheme can be changed to EXTERNAL_MANAGED. Optionally, the + * TEST_BY_PERCENTAGE state can be used to migrate traffic by percentage using + * externalManagedMigrationTestingPercentage. + * Rolling back a migration requires the states to be set in reverse order. So + * changing the scheme from EXTERNAL_MANAGED to EXTERNAL requires the state to + * be set to TEST_ALL_TRAFFIC at the same time. Optionally, the + * TEST_BY_PERCENTAGE state can be used to migrate some traffic back to + * EXTERNAL or PREPARE can be used to migrate all traffic back to EXTERNAL. * Check the ExternalManagedMigrationState enum for the list of possible values. * * Generated from protobuf field optional string external_managed_migration_state = 66947020; @@ -977,7 +1622,15 @@ public function setExternalManagedMigrationState($var) } /** - * Determines the fraction of requests that should be processed by the Global external Application Load Balancer. The value of this field must be in the range [0, 100]. Session affinity options will slightly affect this routing behavior, for more details, see: Session Affinity. This value can only be set if the loadBalancingScheme in the BackendService is set to EXTERNAL (when using the classic Application Load Balancer) and the migration state is TEST_BY_PERCENTAGE. + * Determines the fraction of requests that should be processed by the Global + * external Application Load Balancer. + * The value of this field must be in the range [0, 100]. + * Session affinity options will slightly affect this routing behavior, for + * more details, see:Session + * Affinity. + * This value can only be set if the loadBalancingScheme in the BackendService + * is set to EXTERNAL (when using the classic Application Load Balancer) and + * the migration state is TEST_BY_PERCENTAGE. * * Generated from protobuf field optional float external_managed_migration_testing_percentage = 507232462; * @return float @@ -998,7 +1651,15 @@ public function clearExternalManagedMigrationTestingPercentage() } /** - * Determines the fraction of requests that should be processed by the Global external Application Load Balancer. The value of this field must be in the range [0, 100]. Session affinity options will slightly affect this routing behavior, for more details, see: Session Affinity. This value can only be set if the loadBalancingScheme in the BackendService is set to EXTERNAL (when using the classic Application Load Balancer) and the migration state is TEST_BY_PERCENTAGE. + * Determines the fraction of requests that should be processed by the Global + * external Application Load Balancer. + * The value of this field must be in the range [0, 100]. + * Session affinity options will slightly affect this routing behavior, for + * more details, see:Session + * Affinity. + * This value can only be set if the loadBalancingScheme in the BackendService + * is set to EXTERNAL (when using the classic Application Load Balancer) and + * the migration state is TEST_BY_PERCENTAGE. * * Generated from protobuf field optional float external_managed_migration_testing_percentage = 507232462; * @param float $var @@ -1013,7 +1674,14 @@ public function setExternalManagedMigrationTestingPercentage($var) } /** - * Requires at least one backend instance group to be defined as a backup (failover) backend. For load balancers that have configurable failover: [Internal passthrough Network Load Balancers](https://cloud.google.com/load-balancing/docs/internal/failover-overview) and [external passthrough Network Load Balancers](https://cloud.google.com/load-balancing/docs/network/networklb-failover-overview). failoverPolicy cannot be specified with haPolicy. + * Requires at least one backend instance group to be defined + * as a backup (failover) backend. + * For load balancers that have configurable failover: + * [Internal passthrough Network Load + * Balancers](https://cloud.google.com/load-balancing/docs/internal/failover-overview) + * and [external passthrough Network Load + * Balancers](https://cloud.google.com/load-balancing/docs/network/networklb-failover-overview). + * failoverPolicy cannot be specified with haPolicy. * * Generated from protobuf field optional .google.cloud.compute.v1.BackendServiceFailoverPolicy failover_policy = 105658655; * @return \Google\Cloud\Compute\V1\BackendServiceFailoverPolicy|null @@ -1034,7 +1702,14 @@ public function clearFailoverPolicy() } /** - * Requires at least one backend instance group to be defined as a backup (failover) backend. For load balancers that have configurable failover: [Internal passthrough Network Load Balancers](https://cloud.google.com/load-balancing/docs/internal/failover-overview) and [external passthrough Network Load Balancers](https://cloud.google.com/load-balancing/docs/network/networklb-failover-overview). failoverPolicy cannot be specified with haPolicy. + * Requires at least one backend instance group to be defined + * as a backup (failover) backend. + * For load balancers that have configurable failover: + * [Internal passthrough Network Load + * Balancers](https://cloud.google.com/load-balancing/docs/internal/failover-overview) + * and [external passthrough Network Load + * Balancers](https://cloud.google.com/load-balancing/docs/network/networklb-failover-overview). + * failoverPolicy cannot be specified with haPolicy. * * Generated from protobuf field optional .google.cloud.compute.v1.BackendServiceFailoverPolicy failover_policy = 105658655; * @param \Google\Cloud\Compute\V1\BackendServiceFailoverPolicy $var @@ -1049,7 +1724,13 @@ public function setFailoverPolicy($var) } /** - * Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking. This field will be ignored when inserting a BackendService. An up-to-date fingerprint must be provided in order to update the BackendService, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a BackendService. + * Fingerprint of this resource. A hash of the contents stored in this object. + * This field is used in optimistic locking. This field will be ignored when + * inserting a BackendService. An up-to-date fingerprint must be provided in + * order to update the BackendService, otherwise the request will + * fail with error 412 conditionNotMet. + * To see the latest fingerprint, make a get() request to + * retrieve a BackendService. * * Generated from protobuf field optional string fingerprint = 234678500; * @return string @@ -1070,7 +1751,13 @@ public function clearFingerprint() } /** - * Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking. This field will be ignored when inserting a BackendService. An up-to-date fingerprint must be provided in order to update the BackendService, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a BackendService. + * Fingerprint of this resource. A hash of the contents stored in this object. + * This field is used in optimistic locking. This field will be ignored when + * inserting a BackendService. An up-to-date fingerprint must be provided in + * order to update the BackendService, otherwise the request will + * fail with error 412 conditionNotMet. + * To see the latest fingerprint, make a get() request to + * retrieve a BackendService. * * Generated from protobuf field optional string fingerprint = 234678500; * @param string $var @@ -1085,7 +1772,28 @@ public function setFingerprint($var) } /** - * Configures self-managed High Availability (HA) for External and Internal Protocol Forwarding. The backends of this regional backend service must only specify zonal network endpoint groups (NEGs) of type GCE_VM_IP. When haPolicy is set for an Internal Passthrough Network Load Balancer, the regional backend service must set the network field. All zonal NEGs must belong to the same network. However, individual NEGs can belong to different subnetworks of that network. When haPolicy is specified, the set of attached network endpoints across all backends comprise an High Availability domain from which one endpoint is selected as the active endpoint (the leader) that receives all traffic. haPolicy can be added only at backend service creation time. Once set up, it cannot be deleted. Note that haPolicy is not for load balancing, and therefore cannot be specified with sessionAffinity, connectionTrackingPolicy, and failoverPolicy. haPolicy requires customers to be responsible for tracking backend endpoint health and electing a leader among the healthy endpoints. Therefore, haPolicy cannot be specified with healthChecks. haPolicy can only be specified for External Passthrough Network Load Balancers and Internal Passthrough Network Load Balancers. + * Configures self-managed High Availability (HA) for External and Internal + * Protocol Forwarding. + * The backends of this regional backend service must only specify zonal + * network endpoint groups (NEGs) of type GCE_VM_IP. + * When haPolicy is set for an Internal Passthrough Network Load Balancer, the + * regional backend service must set the network field. All zonal NEGs must + * belong to the same network. However, individual NEGs can + * belong to different subnetworks of that network. + * When haPolicy is specified, the set of attached network endpoints across + * all backends comprise an High Availability domain from which one endpoint + * is selected as the active endpoint (the leader) that receives all + * traffic. + * haPolicy can be added only at backend service creation time. Once set up, + * it cannot be deleted. + * Note that haPolicy is not for load balancing, and therefore cannot be + * specified with sessionAffinity, connectionTrackingPolicy, and + * failoverPolicy. + * haPolicy requires customers to be responsible for tracking backend + * endpoint health and electing a leader among the healthy endpoints. + * Therefore, haPolicy cannot be specified with healthChecks. + * haPolicy can only be specified for External Passthrough Network Load + * Balancers and Internal Passthrough Network Load Balancers. * * Generated from protobuf field optional .google.cloud.compute.v1.BackendServiceHAPolicy ha_policy = 519879480; * @return \Google\Cloud\Compute\V1\BackendServiceHAPolicy|null @@ -1106,7 +1814,28 @@ public function clearHaPolicy() } /** - * Configures self-managed High Availability (HA) for External and Internal Protocol Forwarding. The backends of this regional backend service must only specify zonal network endpoint groups (NEGs) of type GCE_VM_IP. When haPolicy is set for an Internal Passthrough Network Load Balancer, the regional backend service must set the network field. All zonal NEGs must belong to the same network. However, individual NEGs can belong to different subnetworks of that network. When haPolicy is specified, the set of attached network endpoints across all backends comprise an High Availability domain from which one endpoint is selected as the active endpoint (the leader) that receives all traffic. haPolicy can be added only at backend service creation time. Once set up, it cannot be deleted. Note that haPolicy is not for load balancing, and therefore cannot be specified with sessionAffinity, connectionTrackingPolicy, and failoverPolicy. haPolicy requires customers to be responsible for tracking backend endpoint health and electing a leader among the healthy endpoints. Therefore, haPolicy cannot be specified with healthChecks. haPolicy can only be specified for External Passthrough Network Load Balancers and Internal Passthrough Network Load Balancers. + * Configures self-managed High Availability (HA) for External and Internal + * Protocol Forwarding. + * The backends of this regional backend service must only specify zonal + * network endpoint groups (NEGs) of type GCE_VM_IP. + * When haPolicy is set for an Internal Passthrough Network Load Balancer, the + * regional backend service must set the network field. All zonal NEGs must + * belong to the same network. However, individual NEGs can + * belong to different subnetworks of that network. + * When haPolicy is specified, the set of attached network endpoints across + * all backends comprise an High Availability domain from which one endpoint + * is selected as the active endpoint (the leader) that receives all + * traffic. + * haPolicy can be added only at backend service creation time. Once set up, + * it cannot be deleted. + * Note that haPolicy is not for load balancing, and therefore cannot be + * specified with sessionAffinity, connectionTrackingPolicy, and + * failoverPolicy. + * haPolicy requires customers to be responsible for tracking backend + * endpoint health and electing a leader among the healthy endpoints. + * Therefore, haPolicy cannot be specified with healthChecks. + * haPolicy can only be specified for External Passthrough Network Load + * Balancers and Internal Passthrough Network Load Balancers. * * Generated from protobuf field optional .google.cloud.compute.v1.BackendServiceHAPolicy ha_policy = 519879480; * @param \Google\Cloud\Compute\V1\BackendServiceHAPolicy $var @@ -1121,7 +1850,15 @@ public function setHaPolicy($var) } /** - * The list of URLs to the healthChecks, httpHealthChecks (legacy), or httpsHealthChecks (legacy) resource for health checking this backend service. Not all backend services support legacy health checks. See Load balancer guide. Currently, at most one health check can be specified for each backend service. Backend services with instance group or zonal NEG backends must have a health check unless haPolicy is specified. Backend services with internet or serverless NEG backends must not have a health check. healthChecks[] cannot be specified with haPolicy. + * The list of URLs to the healthChecks, httpHealthChecks (legacy), or + * httpsHealthChecks (legacy) resource for health checking this backend + * service. Not all backend services support legacy health checks. See + * Load balancer guide. Currently, at most one health check can be + * specified for each backend service. Backend services with + * instance group or zonal NEG backends must have a health check unless + * haPolicy is specified. Backend services with internet or serverless NEG + * backends must not have a health check. + * healthChecks[] cannot be specified with haPolicy. * * Generated from protobuf field repeated string health_checks = 448370606; * @return \Google\Protobuf\Internal\RepeatedField @@ -1132,7 +1869,15 @@ public function getHealthChecks() } /** - * The list of URLs to the healthChecks, httpHealthChecks (legacy), or httpsHealthChecks (legacy) resource for health checking this backend service. Not all backend services support legacy health checks. See Load balancer guide. Currently, at most one health check can be specified for each backend service. Backend services with instance group or zonal NEG backends must have a health check unless haPolicy is specified. Backend services with internet or serverless NEG backends must not have a health check. healthChecks[] cannot be specified with haPolicy. + * The list of URLs to the healthChecks, httpHealthChecks (legacy), or + * httpsHealthChecks (legacy) resource for health checking this backend + * service. Not all backend services support legacy health checks. See + * Load balancer guide. Currently, at most one health check can be + * specified for each backend service. Backend services with + * instance group or zonal NEG backends must have a health check unless + * haPolicy is specified. Backend services with internet or serverless NEG + * backends must not have a health check. + * healthChecks[] cannot be specified with haPolicy. * * Generated from protobuf field repeated string health_checks = 448370606; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -1147,7 +1892,9 @@ public function setHealthChecks($var) } /** - * The configurations for Identity-Aware Proxy on this resource. Not available for internal passthrough Network Load Balancers and external passthrough Network Load Balancers. + * The configurations for Identity-Aware Proxy on this resource. + * Not available for internal passthrough Network Load Balancers and external + * passthrough Network Load Balancers. * * Generated from protobuf field optional .google.cloud.compute.v1.BackendServiceIAP iap = 104024; * @return \Google\Cloud\Compute\V1\BackendServiceIAP|null @@ -1168,7 +1915,9 @@ public function clearIap() } /** - * The configurations for Identity-Aware Proxy on this resource. Not available for internal passthrough Network Load Balancers and external passthrough Network Load Balancers. + * The configurations for Identity-Aware Proxy on this resource. + * Not available for internal passthrough Network Load Balancers and external + * passthrough Network Load Balancers. * * Generated from protobuf field optional .google.cloud.compute.v1.BackendServiceIAP iap = 104024; * @param \Google\Cloud\Compute\V1\BackendServiceIAP $var @@ -1183,7 +1932,8 @@ public function setIap($var) } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @return int|string @@ -1204,7 +1954,8 @@ public function clearId() } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @param int|string $var @@ -1219,7 +1970,33 @@ public function setId($var) } /** - * Specifies a preference for traffic sent from the proxy to the backend (or from the client to the backend for proxyless gRPC). The possible values are: - IPV4_ONLY: Only send IPv4 traffic to the backends of the backend service (Instance Group, Managed Instance Group, Network Endpoint Group), regardless of traffic from the client to the proxy. Only IPv4 health checks are used to check the health of the backends. This is the default setting. - PREFER_IPV6: Prioritize the connection to the endpoint's IPv6 address over its IPv4 address (provided there is a healthy IPv6 address). - IPV6_ONLY: Only send IPv6 traffic to the backends of the backend service (Instance Group, Managed Instance Group, Network Endpoint Group), regardless of traffic from the client to the proxy. Only IPv6 health checks are used to check the health of the backends. This field is applicable to either: - Advanced global external Application Load Balancer (load balancing scheme EXTERNAL_MANAGED), - Regional external Application Load Balancer, - Internal proxy Network Load Balancer (load balancing scheme INTERNAL_MANAGED), - Regional internal Application Load Balancer (load balancing scheme INTERNAL_MANAGED), - Traffic Director with Envoy proxies and proxyless gRPC (load balancing scheme INTERNAL_SELF_MANAGED). + * Specifies a preference for traffic sent from the proxy to the backend (or + * from the client to the backend for proxyless gRPC). + * The possible values are: + * - IPV4_ONLY: Only send IPv4 traffic to the backends of the + * backend service (Instance Group, Managed Instance Group, Network Endpoint + * Group), regardless of traffic from the client to the proxy. Only IPv4 + * health checks are used to check the health of the backends. This is the + * default setting. + * - PREFER_IPV6: Prioritize the connection to the endpoint's + * IPv6 address over its IPv4 address (provided there is a healthy IPv6 + * address). + * - IPV6_ONLY: Only send IPv6 traffic to the backends of the + * backend service (Instance Group, Managed Instance Group, Network Endpoint + * Group), regardless of traffic from the client to the proxy. Only IPv6 + * health checks are used to check the health of the backends. + * This field is applicable to either: + * - Advanced global external Application Load Balancer (load balancing + * scheme EXTERNAL_MANAGED), + * - Regional external Application Load + * Balancer, + * - Internal proxy Network Load Balancer (load balancing + * scheme INTERNAL_MANAGED), + * - Regional internal Application Load + * Balancer (load balancing scheme INTERNAL_MANAGED), + * - Traffic + * Director with Envoy proxies and proxyless gRPC (load balancing scheme + * INTERNAL_SELF_MANAGED). * Check the IpAddressSelectionPolicy enum for the list of possible values. * * Generated from protobuf field optional string ip_address_selection_policy = 77600840; @@ -1241,7 +2018,33 @@ public function clearIpAddressSelectionPolicy() } /** - * Specifies a preference for traffic sent from the proxy to the backend (or from the client to the backend for proxyless gRPC). The possible values are: - IPV4_ONLY: Only send IPv4 traffic to the backends of the backend service (Instance Group, Managed Instance Group, Network Endpoint Group), regardless of traffic from the client to the proxy. Only IPv4 health checks are used to check the health of the backends. This is the default setting. - PREFER_IPV6: Prioritize the connection to the endpoint's IPv6 address over its IPv4 address (provided there is a healthy IPv6 address). - IPV6_ONLY: Only send IPv6 traffic to the backends of the backend service (Instance Group, Managed Instance Group, Network Endpoint Group), regardless of traffic from the client to the proxy. Only IPv6 health checks are used to check the health of the backends. This field is applicable to either: - Advanced global external Application Load Balancer (load balancing scheme EXTERNAL_MANAGED), - Regional external Application Load Balancer, - Internal proxy Network Load Balancer (load balancing scheme INTERNAL_MANAGED), - Regional internal Application Load Balancer (load balancing scheme INTERNAL_MANAGED), - Traffic Director with Envoy proxies and proxyless gRPC (load balancing scheme INTERNAL_SELF_MANAGED). + * Specifies a preference for traffic sent from the proxy to the backend (or + * from the client to the backend for proxyless gRPC). + * The possible values are: + * - IPV4_ONLY: Only send IPv4 traffic to the backends of the + * backend service (Instance Group, Managed Instance Group, Network Endpoint + * Group), regardless of traffic from the client to the proxy. Only IPv4 + * health checks are used to check the health of the backends. This is the + * default setting. + * - PREFER_IPV6: Prioritize the connection to the endpoint's + * IPv6 address over its IPv4 address (provided there is a healthy IPv6 + * address). + * - IPV6_ONLY: Only send IPv6 traffic to the backends of the + * backend service (Instance Group, Managed Instance Group, Network Endpoint + * Group), regardless of traffic from the client to the proxy. Only IPv6 + * health checks are used to check the health of the backends. + * This field is applicable to either: + * - Advanced global external Application Load Balancer (load balancing + * scheme EXTERNAL_MANAGED), + * - Regional external Application Load + * Balancer, + * - Internal proxy Network Load Balancer (load balancing + * scheme INTERNAL_MANAGED), + * - Regional internal Application Load + * Balancer (load balancing scheme INTERNAL_MANAGED), + * - Traffic + * Director with Envoy proxies and proxyless gRPC (load balancing scheme + * INTERNAL_SELF_MANAGED). * Check the IpAddressSelectionPolicy enum for the list of possible values. * * Generated from protobuf field optional string ip_address_selection_policy = 77600840; @@ -1257,7 +2060,8 @@ public function setIpAddressSelectionPolicy($var) } /** - * [Output Only] Type of resource. Always compute#backendService for backend services. + * [Output Only] Type of resource. Always compute#backendService + * for backend services. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -1278,7 +2082,8 @@ public function clearKind() } /** - * [Output Only] Type of resource. Always compute#backendService for backend services. + * [Output Only] Type of resource. Always compute#backendService + * for backend services. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -1293,7 +2098,10 @@ public function setKind($var) } /** - * Specifies the load balancer type. A backend service created for one type of load balancer cannot be used with another. For more information, refer to Choosing a load balancer. + * Specifies the load balancer type. A backend service + * created for one type of load balancer cannot be used with another. + * For more information, refer toChoosing + * a load balancer. * Check the LoadBalancingScheme enum for the list of possible values. * * Generated from protobuf field optional string load_balancing_scheme = 363890244; @@ -1315,7 +2123,10 @@ public function clearLoadBalancingScheme() } /** - * Specifies the load balancer type. A backend service created for one type of load balancer cannot be used with another. For more information, refer to Choosing a load balancer. + * Specifies the load balancer type. A backend service + * created for one type of load balancer cannot be used with another. + * For more information, refer toChoosing + * a load balancer. * Check the LoadBalancingScheme enum for the list of possible values. * * Generated from protobuf field optional string load_balancing_scheme = 363890244; @@ -1331,7 +2142,16 @@ public function setLoadBalancingScheme($var) } /** - * A list of locality load-balancing policies to be used in order of preference. When you use localityLbPolicies, you must set at least one value for either the localityLbPolicies[].policy or the localityLbPolicies[].customPolicy field. localityLbPolicies overrides any value set in the localityLbPolicy field. For an example of how to use this field, see Define a list of preferred policies. Caution: This field and its children are intended for use in a service mesh that includes gRPC clients only. Envoy proxies can't use backend services that have this configuration. + * A list of locality load-balancing policies to be used in order of + * preference. When you use localityLbPolicies, you must set at least one + * value for either the localityLbPolicies[].policy or the + * localityLbPolicies[].customPolicy field. localityLbPolicies overrides any + * value set in the localityLbPolicy field. + * For an example of how to use this field, seeDefine + * a list of preferred policies. + * Caution: This field and its children are intended for use in a service mesh + * that includes gRPC clients only. Envoy proxies can't use backend services + * that have this configuration. * * Generated from protobuf field repeated .google.cloud.compute.v1.BackendServiceLocalityLoadBalancingPolicyConfig locality_lb_policies = 140982557; * @return \Google\Protobuf\Internal\RepeatedField @@ -1342,7 +2162,16 @@ public function getLocalityLbPolicies() } /** - * A list of locality load-balancing policies to be used in order of preference. When you use localityLbPolicies, you must set at least one value for either the localityLbPolicies[].policy or the localityLbPolicies[].customPolicy field. localityLbPolicies overrides any value set in the localityLbPolicy field. For an example of how to use this field, see Define a list of preferred policies. Caution: This field and its children are intended for use in a service mesh that includes gRPC clients only. Envoy proxies can't use backend services that have this configuration. + * A list of locality load-balancing policies to be used in order of + * preference. When you use localityLbPolicies, you must set at least one + * value for either the localityLbPolicies[].policy or the + * localityLbPolicies[].customPolicy field. localityLbPolicies overrides any + * value set in the localityLbPolicy field. + * For an example of how to use this field, seeDefine + * a list of preferred policies. + * Caution: This field and its children are intended for use in a service mesh + * that includes gRPC clients only. Envoy proxies can't use backend services + * that have this configuration. * * Generated from protobuf field repeated .google.cloud.compute.v1.BackendServiceLocalityLoadBalancingPolicyConfig locality_lb_policies = 140982557; * @param array<\Google\Cloud\Compute\V1\BackendServiceLocalityLoadBalancingPolicyConfig>|\Google\Protobuf\Internal\RepeatedField $var @@ -1357,7 +2186,50 @@ public function setLocalityLbPolicies($var) } /** - * The load balancing algorithm used within the scope of the locality. The possible values are: - ROUND_ROBIN: This is a simple policy in which each healthy backend is selected in round robin order. This is the default. - LEAST_REQUEST: An O(1) algorithm which selects two random healthy hosts and picks the host which has fewer active requests. - RING_HASH: The ring/modulo hash load balancer implements consistent hashing to backends. The algorithm has the property that the addition/removal of a host from a set of N hosts only affects 1/N of the requests. - RANDOM: The load balancer selects a random healthy host. - ORIGINAL_DESTINATION: Backend host is selected based on the client connection metadata, i.e., connections are opened to the same address as the destination address of the incoming connection before the connection was redirected to the load balancer. - MAGLEV: used as a drop in replacement for the ring hash load balancer. Maglev is not as stable as ring hash but has faster table lookup build times and host selection times. For more information about Maglev, see Maglev: A Fast and Reliable Software Network Load Balancer. - WEIGHTED_ROUND_ROBIN: Per-endpoint Weighted Round Robin Load Balancing using weights computed from Backend reported Custom Metrics. If set, the Backend Service responses are expected to contain non-standard HTTP response header field Endpoint-Load-Metrics. The reported metrics to use for computing the weights are specified via the customMetrics field. This field is applicable to either: - A regional backend service with the service_protocol set to HTTP, HTTPS, HTTP2 or H2C, and load_balancing_scheme set to INTERNAL_MANAGED. - A global backend service with the load_balancing_scheme set to INTERNAL_SELF_MANAGED, INTERNAL_MANAGED, or EXTERNAL_MANAGED. If sessionAffinity is not configured—that is, if session affinity remains at the default value of NONE—then the default value for localityLbPolicy is ROUND_ROBIN. If session affinity is set to a value other than NONE, then the default value for localityLbPolicy is MAGLEV. Only ROUND_ROBIN and RING_HASH are supported when the backend service is referenced by a URL map that is bound to target gRPC proxy that has validateForProxyless field set to true. localityLbPolicy cannot be specified with haPolicy. + * The load balancing algorithm used within the scope of the locality. The + * possible values are: + * - ROUND_ROBIN: This is a simple policy in which each healthy + * backend is selected in round robin order. This is the default. + * - LEAST_REQUEST: An O(1) algorithm which + * selects two random healthy hosts and picks the host which has fewer active + * requests. + * - RING_HASH: The ring/modulo hash load balancer implements + * consistent hashing to backends. The algorithm has the property that the + * addition/removal of a host from a set of N hosts only affects 1/N of the + * requests. + * - RANDOM: The load balancer selects a random healthy + * host. + * - ORIGINAL_DESTINATION: Backend host is selected + * based on the client connection metadata, i.e., connections are opened to + * the same address as the destination address of the incoming connection + * before the connection was redirected to the load balancer. + * - MAGLEV: used as a drop in replacement for the ring hash + * load balancer. Maglev is not as stable as ring hash but has faster table + * lookup build times and host selection times. For more information about + * Maglev, see Maglev: + * A Fast and Reliable Software Network Load Balancer. + * - WEIGHTED_ROUND_ROBIN: Per-endpoint Weighted Round Robin + * Load Balancing using weights computed from Backend reported Custom Metrics. + * If set, the Backend Service responses are expected to contain non-standard + * HTTP response header field Endpoint-Load-Metrics. The reported + * metrics to use for computing the weights are specified via thecustomMetrics field. + * This field is applicable to either: + * - A regional backend service with the service_protocol set to HTTP, + * HTTPS, HTTP2 or H2C, and load_balancing_scheme set to + * INTERNAL_MANAGED. + * - A global backend service with the + * load_balancing_scheme set to INTERNAL_SELF_MANAGED, INTERNAL_MANAGED, or + * EXTERNAL_MANAGED. + * If sessionAffinity is not configured—that is, if session + * affinity remains at the default value of NONE—then the + * default value for localityLbPolicy + * is ROUND_ROBIN. If session affinity is set to a value other + * than NONE, + * then the default value for localityLbPolicy isMAGLEV. + * Only ROUND_ROBIN and RING_HASH are supported + * when the backend service is referenced by a URL map that is bound to + * target gRPC proxy that has validateForProxyless field set to true. + * localityLbPolicy cannot be specified with haPolicy. * Check the LocalityLbPolicy enum for the list of possible values. * * Generated from protobuf field optional string locality_lb_policy = 131431487; @@ -1379,7 +2251,50 @@ public function clearLocalityLbPolicy() } /** - * The load balancing algorithm used within the scope of the locality. The possible values are: - ROUND_ROBIN: This is a simple policy in which each healthy backend is selected in round robin order. This is the default. - LEAST_REQUEST: An O(1) algorithm which selects two random healthy hosts and picks the host which has fewer active requests. - RING_HASH: The ring/modulo hash load balancer implements consistent hashing to backends. The algorithm has the property that the addition/removal of a host from a set of N hosts only affects 1/N of the requests. - RANDOM: The load balancer selects a random healthy host. - ORIGINAL_DESTINATION: Backend host is selected based on the client connection metadata, i.e., connections are opened to the same address as the destination address of the incoming connection before the connection was redirected to the load balancer. - MAGLEV: used as a drop in replacement for the ring hash load balancer. Maglev is not as stable as ring hash but has faster table lookup build times and host selection times. For more information about Maglev, see Maglev: A Fast and Reliable Software Network Load Balancer. - WEIGHTED_ROUND_ROBIN: Per-endpoint Weighted Round Robin Load Balancing using weights computed from Backend reported Custom Metrics. If set, the Backend Service responses are expected to contain non-standard HTTP response header field Endpoint-Load-Metrics. The reported metrics to use for computing the weights are specified via the customMetrics field. This field is applicable to either: - A regional backend service with the service_protocol set to HTTP, HTTPS, HTTP2 or H2C, and load_balancing_scheme set to INTERNAL_MANAGED. - A global backend service with the load_balancing_scheme set to INTERNAL_SELF_MANAGED, INTERNAL_MANAGED, or EXTERNAL_MANAGED. If sessionAffinity is not configured—that is, if session affinity remains at the default value of NONE—then the default value for localityLbPolicy is ROUND_ROBIN. If session affinity is set to a value other than NONE, then the default value for localityLbPolicy is MAGLEV. Only ROUND_ROBIN and RING_HASH are supported when the backend service is referenced by a URL map that is bound to target gRPC proxy that has validateForProxyless field set to true. localityLbPolicy cannot be specified with haPolicy. + * The load balancing algorithm used within the scope of the locality. The + * possible values are: + * - ROUND_ROBIN: This is a simple policy in which each healthy + * backend is selected in round robin order. This is the default. + * - LEAST_REQUEST: An O(1) algorithm which + * selects two random healthy hosts and picks the host which has fewer active + * requests. + * - RING_HASH: The ring/modulo hash load balancer implements + * consistent hashing to backends. The algorithm has the property that the + * addition/removal of a host from a set of N hosts only affects 1/N of the + * requests. + * - RANDOM: The load balancer selects a random healthy + * host. + * - ORIGINAL_DESTINATION: Backend host is selected + * based on the client connection metadata, i.e., connections are opened to + * the same address as the destination address of the incoming connection + * before the connection was redirected to the load balancer. + * - MAGLEV: used as a drop in replacement for the ring hash + * load balancer. Maglev is not as stable as ring hash but has faster table + * lookup build times and host selection times. For more information about + * Maglev, see Maglev: + * A Fast and Reliable Software Network Load Balancer. + * - WEIGHTED_ROUND_ROBIN: Per-endpoint Weighted Round Robin + * Load Balancing using weights computed from Backend reported Custom Metrics. + * If set, the Backend Service responses are expected to contain non-standard + * HTTP response header field Endpoint-Load-Metrics. The reported + * metrics to use for computing the weights are specified via thecustomMetrics field. + * This field is applicable to either: + * - A regional backend service with the service_protocol set to HTTP, + * HTTPS, HTTP2 or H2C, and load_balancing_scheme set to + * INTERNAL_MANAGED. + * - A global backend service with the + * load_balancing_scheme set to INTERNAL_SELF_MANAGED, INTERNAL_MANAGED, or + * EXTERNAL_MANAGED. + * If sessionAffinity is not configured—that is, if session + * affinity remains at the default value of NONE—then the + * default value for localityLbPolicy + * is ROUND_ROBIN. If session affinity is set to a value other + * than NONE, + * then the default value for localityLbPolicy isMAGLEV. + * Only ROUND_ROBIN and RING_HASH are supported + * when the backend service is referenced by a URL map that is bound to + * target gRPC proxy that has validateForProxyless field set to true. + * localityLbPolicy cannot be specified with haPolicy. * Check the LocalityLbPolicy enum for the list of possible values. * * Generated from protobuf field optional string locality_lb_policy = 131431487; @@ -1395,7 +2310,9 @@ public function setLocalityLbPolicy($var) } /** - * This field denotes the logging options for the load balancer traffic served by this backend service. If logging is enabled, logs will be exported to Stackdriver. + * This field denotes the logging options for the load balancer traffic served + * by this backend service. If logging is enabled, logs will be exported to + * Stackdriver. * * Generated from protobuf field optional .google.cloud.compute.v1.BackendServiceLogConfig log_config = 351299741; * @return \Google\Cloud\Compute\V1\BackendServiceLogConfig|null @@ -1416,7 +2333,9 @@ public function clearLogConfig() } /** - * This field denotes the logging options for the load balancer traffic served by this backend service. If logging is enabled, logs will be exported to Stackdriver. + * This field denotes the logging options for the load balancer traffic served + * by this backend service. If logging is enabled, logs will be exported to + * Stackdriver. * * Generated from protobuf field optional .google.cloud.compute.v1.BackendServiceLogConfig log_config = 351299741; * @param \Google\Cloud\Compute\V1\BackendServiceLogConfig $var @@ -1431,7 +2350,16 @@ public function setLogConfig($var) } /** - * Specifies the default maximum duration (timeout) for streams to this service. Duration is computed from the beginning of the stream until the response has been completely processed, including all retries. A stream that does not complete in this duration is closed. If not specified, there will be no timeout limit, i.e. the maximum duration is infinite. This value can be overridden in the PathMatcher configuration of the UrlMap that references this backend service. This field is only allowed when the loadBalancingScheme of the backend service is INTERNAL_SELF_MANAGED. + * Specifies the default maximum duration (timeout) for streams to this + * service. Duration is computed from the beginning of the stream until the + * response has been completely processed, including all retries. A stream + * that does not complete in this duration is closed. + * If not specified, there will be no timeout limit, i.e. the maximum + * duration is infinite. + * This value can be overridden in the PathMatcher configuration of the + * UrlMap that references this backend service. + * This field is only allowed when the loadBalancingScheme of + * the backend service is INTERNAL_SELF_MANAGED. * * Generated from protobuf field optional .google.cloud.compute.v1.Duration max_stream_duration = 61428376; * @return \Google\Cloud\Compute\V1\Duration|null @@ -1452,7 +2380,16 @@ public function clearMaxStreamDuration() } /** - * Specifies the default maximum duration (timeout) for streams to this service. Duration is computed from the beginning of the stream until the response has been completely processed, including all retries. A stream that does not complete in this duration is closed. If not specified, there will be no timeout limit, i.e. the maximum duration is infinite. This value can be overridden in the PathMatcher configuration of the UrlMap that references this backend service. This field is only allowed when the loadBalancingScheme of the backend service is INTERNAL_SELF_MANAGED. + * Specifies the default maximum duration (timeout) for streams to this + * service. Duration is computed from the beginning of the stream until the + * response has been completely processed, including all retries. A stream + * that does not complete in this duration is closed. + * If not specified, there will be no timeout limit, i.e. the maximum + * duration is infinite. + * This value can be overridden in the PathMatcher configuration of the + * UrlMap that references this backend service. + * This field is only allowed when the loadBalancingScheme of + * the backend service is INTERNAL_SELF_MANAGED. * * Generated from protobuf field optional .google.cloud.compute.v1.Duration max_stream_duration = 61428376; * @param \Google\Cloud\Compute\V1\Duration $var @@ -1467,7 +2404,8 @@ public function setMaxStreamDuration($var) } /** - * Deployment metadata associated with the resource to be set by a GKE hub controller and read by the backend RCTH + * Deployment metadata associated with the resource to be set by a GKE hub + * controller and read by the backend RCTH * * Generated from protobuf field map metadatas = 8514340; * @return \Google\Protobuf\Internal\MapField @@ -1478,7 +2416,8 @@ public function getMetadatas() } /** - * Deployment metadata associated with the resource to be set by a GKE hub controller and read by the backend RCTH + * Deployment metadata associated with the resource to be set by a GKE hub + * controller and read by the backend RCTH * * Generated from protobuf field map metadatas = 8514340; * @param array|\Google\Protobuf\Internal\MapField $var @@ -1493,7 +2432,13 @@ public function setMetadatas($var) } /** - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * * Generated from protobuf field optional string name = 3373707; * @return string @@ -1514,7 +2459,13 @@ public function clearName() } /** - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * * Generated from protobuf field optional string name = 3373707; * @param string $var @@ -1529,7 +2480,11 @@ public function setName($var) } /** - * The URL of the network to which this backend service belongs. This field must be set for Internal Passthrough Network Load Balancers when the haPolicy is enabled, and for External Passthrough Network Load Balancers when the haPolicy fastIpMove is enabled. This field can only be specified when the load balancing scheme is set to INTERNAL, or when the load balancing scheme is set to EXTERNAL and haPolicy fastIpMove is enabled. + * The URL of the network to which this backend service belongs. + * This field must be set for Internal Passthrough Network Load Balancers when + * the haPolicy is enabled, and for External Passthrough Network Load + * Balancers when the haPolicy fastIpMove is enabled. + * This field can only be specified when the load balancing scheme is set toINTERNAL, or when the load balancing scheme is set toEXTERNAL and haPolicy fastIpMove is enabled. * * Generated from protobuf field optional string network = 232872494; * @return string @@ -1550,7 +2505,11 @@ public function clearNetwork() } /** - * The URL of the network to which this backend service belongs. This field must be set for Internal Passthrough Network Load Balancers when the haPolicy is enabled, and for External Passthrough Network Load Balancers when the haPolicy fastIpMove is enabled. This field can only be specified when the load balancing scheme is set to INTERNAL, or when the load balancing scheme is set to EXTERNAL and haPolicy fastIpMove is enabled. + * The URL of the network to which this backend service belongs. + * This field must be set for Internal Passthrough Network Load Balancers when + * the haPolicy is enabled, and for External Passthrough Network Load + * Balancers when the haPolicy fastIpMove is enabled. + * This field can only be specified when the load balancing scheme is set toINTERNAL, or when the load balancing scheme is set toEXTERNAL and haPolicy fastIpMove is enabled. * * Generated from protobuf field optional string network = 232872494; * @param string $var @@ -1565,7 +2524,36 @@ public function setNetwork($var) } /** - * Settings controlling the ejection of unhealthy backend endpoints from the load balancing pool of each individual proxy instance that processes the traffic for the given backend service. If not set, this feature is considered disabled. Results of the outlier detection algorithm (ejection of endpoints from the load balancing pool and returning them back to the pool) are executed independently by each proxy instance of the load balancer. In most cases, more than one proxy instance handles the traffic received by a backend service. Thus, it is possible that an unhealthy endpoint is detected and ejected by only some of the proxies, and while this happens, other proxies may continue to send requests to the same unhealthy endpoint until they detect and eject the unhealthy endpoint. Applicable backend endpoints can be: - VM instances in an Instance Group - Endpoints in a Zonal NEG (GCE_VM_IP, GCE_VM_IP_PORT) - Endpoints in a Hybrid Connectivity NEG (NON_GCP_PRIVATE_IP_PORT) - Serverless NEGs, that resolve to Cloud Run, App Engine, or Cloud Functions Services - Private Service Connect NEGs, that resolve to Google-managed regional API endpoints or managed services published using Private Service Connect Applicable backend service types can be: - A global backend service with the loadBalancingScheme set to INTERNAL_SELF_MANAGED or EXTERNAL_MANAGED. - A regional backend service with the serviceProtocol set to HTTP, HTTPS, HTTP2 or H2C, and loadBalancingScheme set to INTERNAL_MANAGED or EXTERNAL_MANAGED. Not supported for Serverless NEGs. Not supported when the backend service is referenced by a URL map that is bound to target gRPC proxy that has validateForProxyless field set to true. + * Settings controlling the ejection of unhealthy backend endpoints from the + * load balancing pool of each individual proxy instance that processes the + * traffic for the given backend service. If not set, this feature is + * considered disabled. + * Results of the outlier detection algorithm (ejection of endpoints from the + * load balancing pool and returning them back to the pool) are executed + * independently by each proxy instance of the load balancer. In most cases, + * more than one proxy instance handles the traffic received by a backend + * service. Thus, it is possible that an unhealthy endpoint is detected and + * ejected by only some of the proxies, and while this happens, other proxies + * may continue to send requests to the same unhealthy endpoint until they + * detect and eject the unhealthy endpoint. + * Applicable backend endpoints can be: + * - VM instances in an Instance Group + * - Endpoints in a Zonal NEG (GCE_VM_IP, GCE_VM_IP_PORT) + * - Endpoints in a Hybrid Connectivity NEG (NON_GCP_PRIVATE_IP_PORT) + * - Serverless NEGs, that resolve to Cloud Run, App Engine, or Cloud + * Functions Services + * - Private Service Connect NEGs, that resolve to + * Google-managed regional API endpoints or managed services published using + * Private Service Connect + * Applicable backend service types can be: + * - A global backend service with the loadBalancingScheme set to + * INTERNAL_SELF_MANAGED or EXTERNAL_MANAGED. + * - A regional backend + * service with the serviceProtocol set to HTTP, HTTPS, HTTP2 or H2C, and + * loadBalancingScheme set to INTERNAL_MANAGED or EXTERNAL_MANAGED. Not + * supported for Serverless NEGs. + * Not supported when the backend service is referenced by a URL map that is + * bound to target gRPC proxy that has validateForProxyless field set to true. * * Generated from protobuf field optional .google.cloud.compute.v1.OutlierDetection outlier_detection = 354625086; * @return \Google\Cloud\Compute\V1\OutlierDetection|null @@ -1586,7 +2574,36 @@ public function clearOutlierDetection() } /** - * Settings controlling the ejection of unhealthy backend endpoints from the load balancing pool of each individual proxy instance that processes the traffic for the given backend service. If not set, this feature is considered disabled. Results of the outlier detection algorithm (ejection of endpoints from the load balancing pool and returning them back to the pool) are executed independently by each proxy instance of the load balancer. In most cases, more than one proxy instance handles the traffic received by a backend service. Thus, it is possible that an unhealthy endpoint is detected and ejected by only some of the proxies, and while this happens, other proxies may continue to send requests to the same unhealthy endpoint until they detect and eject the unhealthy endpoint. Applicable backend endpoints can be: - VM instances in an Instance Group - Endpoints in a Zonal NEG (GCE_VM_IP, GCE_VM_IP_PORT) - Endpoints in a Hybrid Connectivity NEG (NON_GCP_PRIVATE_IP_PORT) - Serverless NEGs, that resolve to Cloud Run, App Engine, or Cloud Functions Services - Private Service Connect NEGs, that resolve to Google-managed regional API endpoints or managed services published using Private Service Connect Applicable backend service types can be: - A global backend service with the loadBalancingScheme set to INTERNAL_SELF_MANAGED or EXTERNAL_MANAGED. - A regional backend service with the serviceProtocol set to HTTP, HTTPS, HTTP2 or H2C, and loadBalancingScheme set to INTERNAL_MANAGED or EXTERNAL_MANAGED. Not supported for Serverless NEGs. Not supported when the backend service is referenced by a URL map that is bound to target gRPC proxy that has validateForProxyless field set to true. + * Settings controlling the ejection of unhealthy backend endpoints from the + * load balancing pool of each individual proxy instance that processes the + * traffic for the given backend service. If not set, this feature is + * considered disabled. + * Results of the outlier detection algorithm (ejection of endpoints from the + * load balancing pool and returning them back to the pool) are executed + * independently by each proxy instance of the load balancer. In most cases, + * more than one proxy instance handles the traffic received by a backend + * service. Thus, it is possible that an unhealthy endpoint is detected and + * ejected by only some of the proxies, and while this happens, other proxies + * may continue to send requests to the same unhealthy endpoint until they + * detect and eject the unhealthy endpoint. + * Applicable backend endpoints can be: + * - VM instances in an Instance Group + * - Endpoints in a Zonal NEG (GCE_VM_IP, GCE_VM_IP_PORT) + * - Endpoints in a Hybrid Connectivity NEG (NON_GCP_PRIVATE_IP_PORT) + * - Serverless NEGs, that resolve to Cloud Run, App Engine, or Cloud + * Functions Services + * - Private Service Connect NEGs, that resolve to + * Google-managed regional API endpoints or managed services published using + * Private Service Connect + * Applicable backend service types can be: + * - A global backend service with the loadBalancingScheme set to + * INTERNAL_SELF_MANAGED or EXTERNAL_MANAGED. + * - A regional backend + * service with the serviceProtocol set to HTTP, HTTPS, HTTP2 or H2C, and + * loadBalancingScheme set to INTERNAL_MANAGED or EXTERNAL_MANAGED. Not + * supported for Serverless NEGs. + * Not supported when the backend service is referenced by a URL map that is + * bound to target gRPC proxy that has validateForProxyless field set to true. * * Generated from protobuf field optional .google.cloud.compute.v1.OutlierDetection outlier_detection = 354625086; * @param \Google\Cloud\Compute\V1\OutlierDetection $var @@ -1601,7 +2618,8 @@ public function setOutlierDetection($var) } /** - * Input only. [Input Only] Additional params passed with the request, but not persisted as part of resource payload. + * Input only. [Input Only] Additional params passed with the request, but not persisted + * as part of resource payload. * * Generated from protobuf field optional .google.cloud.compute.v1.BackendServiceParams params = 78313862; * @return \Google\Cloud\Compute\V1\BackendServiceParams|null @@ -1622,7 +2640,8 @@ public function clearParams() } /** - * Input only. [Input Only] Additional params passed with the request, but not persisted as part of resource payload. + * Input only. [Input Only] Additional params passed with the request, but not persisted + * as part of resource payload. * * Generated from protobuf field optional .google.cloud.compute.v1.BackendServiceParams params = 78313862; * @param \Google\Cloud\Compute\V1\BackendServiceParams $var @@ -1637,7 +2656,10 @@ public function setParams($var) } /** - * Deprecated in favor of portName. The TCP port to connect on the backend. The default value is 80. For internal passthrough Network Load Balancers and external passthrough Network Load Balancers, omit port. + * Deprecated in favor of portName. The TCP port to connect on + * the backend. The default value is 80. + * For internal passthrough Network Load Balancers and external passthrough + * Network Load Balancers, omit port. * * Generated from protobuf field optional int32 port = 3446913; * @return int @@ -1658,7 +2680,10 @@ public function clearPort() } /** - * Deprecated in favor of portName. The TCP port to connect on the backend. The default value is 80. For internal passthrough Network Load Balancers and external passthrough Network Load Balancers, omit port. + * Deprecated in favor of portName. The TCP port to connect on + * the backend. The default value is 80. + * For internal passthrough Network Load Balancers and external passthrough + * Network Load Balancers, omit port. * * Generated from protobuf field optional int32 port = 3446913; * @param int $var @@ -1673,7 +2698,13 @@ public function setPort($var) } /** - * A named port on a backend instance group representing the port for communication to the backend VMs in that group. The named port must be [defined on each backend instance group](https://cloud.google.com/load-balancing/docs/backend-service#named_ports). This parameter has no meaning if the backends are NEGs. For internal passthrough Network Load Balancers and external passthrough Network Load Balancers, omit port_name. + * A named port on a backend instance group representing the port for + * communication to the backend VMs in that group. The + * named port must be [defined on each backend instance + * group](https://cloud.google.com/load-balancing/docs/backend-service#named_ports). + * This parameter has no meaning if the backends are NEGs. For internal + * passthrough Network Load Balancers and external passthrough Network Load + * Balancers, omit port_name. * * Generated from protobuf field optional string port_name = 41534345; * @return string @@ -1694,7 +2725,13 @@ public function clearPortName() } /** - * A named port on a backend instance group representing the port for communication to the backend VMs in that group. The named port must be [defined on each backend instance group](https://cloud.google.com/load-balancing/docs/backend-service#named_ports). This parameter has no meaning if the backends are NEGs. For internal passthrough Network Load Balancers and external passthrough Network Load Balancers, omit port_name. + * A named port on a backend instance group representing the port for + * communication to the backend VMs in that group. The + * named port must be [defined on each backend instance + * group](https://cloud.google.com/load-balancing/docs/backend-service#named_ports). + * This parameter has no meaning if the backends are NEGs. For internal + * passthrough Network Load Balancers and external passthrough Network Load + * Balancers, omit port_name. * * Generated from protobuf field optional string port_name = 41534345; * @param string $var @@ -1709,7 +2746,14 @@ public function setPortName($var) } /** - * The protocol this BackendService uses to communicate with backends. Possible values are HTTP, HTTPS, HTTP2, H2C, TCP, SSL, UDP or GRPC. depending on the chosen load balancer or Traffic Director configuration. Refer to the documentation for the load balancers or for Traffic Director for more information. Must be set to GRPC when the backend service is referenced by a URL map that is bound to target gRPC proxy. + * The protocol this BackendService uses to communicate + * with backends. + * Possible values are HTTP, HTTPS, HTTP2, H2C, TCP, SSL, UDP or GRPC. + * depending on the chosen load balancer or Traffic Director configuration. + * Refer to the documentation for the load balancers or for Traffic Director + * for more information. + * Must be set to GRPC when the backend service is referenced by a URL map + * that is bound to target gRPC proxy. * Check the Protocol enum for the list of possible values. * * Generated from protobuf field optional string protocol = 84577944; @@ -1731,7 +2775,14 @@ public function clearProtocol() } /** - * The protocol this BackendService uses to communicate with backends. Possible values are HTTP, HTTPS, HTTP2, H2C, TCP, SSL, UDP or GRPC. depending on the chosen load balancer or Traffic Director configuration. Refer to the documentation for the load balancers or for Traffic Director for more information. Must be set to GRPC when the backend service is referenced by a URL map that is bound to target gRPC proxy. + * The protocol this BackendService uses to communicate + * with backends. + * Possible values are HTTP, HTTPS, HTTP2, H2C, TCP, SSL, UDP or GRPC. + * depending on the chosen load balancer or Traffic Director configuration. + * Refer to the documentation for the load balancers or for Traffic Director + * for more information. + * Must be set to GRPC when the backend service is referenced by a URL map + * that is bound to target gRPC proxy. * Check the Protocol enum for the list of possible values. * * Generated from protobuf field optional string protocol = 84577944; @@ -1747,7 +2798,10 @@ public function setProtocol($var) } /** - * [Output Only] URL of the region where the regional backend service resides. This field is not applicable to global backend services. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * [Output Only] URL of the region where the regional backend service + * resides. This field is not applicable to global backend services. + * You must specify this field as part of the HTTP request URL. It is + * not settable as a field in the request body. * * Generated from protobuf field optional string region = 138946292; * @return string @@ -1768,7 +2822,10 @@ public function clearRegion() } /** - * [Output Only] URL of the region where the regional backend service resides. This field is not applicable to global backend services. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * [Output Only] URL of the region where the regional backend service + * resides. This field is not applicable to global backend services. + * You must specify this field as part of the HTTP request URL. It is + * not settable as a field in the request body. * * Generated from protobuf field optional string region = 138946292; * @param string $var @@ -1783,7 +2840,8 @@ public function setRegion($var) } /** - * [Output Only] The resource URL for the security policy associated with this backend service. + * [Output Only] The resource URL for the security policy associated with this + * backend service. * * Generated from protobuf field optional string security_policy = 171082513; * @return string @@ -1804,7 +2862,8 @@ public function clearSecurityPolicy() } /** - * [Output Only] The resource URL for the security policy associated with this backend service. + * [Output Only] The resource URL for the security policy associated with this + * backend service. * * Generated from protobuf field optional string security_policy = 171082513; * @param string $var @@ -1819,7 +2878,9 @@ public function setSecurityPolicy($var) } /** - * This field specifies the security settings that apply to this backend service. This field is applicable to a global backend service with the load_balancing_scheme set to INTERNAL_SELF_MANAGED. + * This field specifies the security settings that apply to this backend + * service. This field is applicable to a global backend service with the + * load_balancing_scheme set to INTERNAL_SELF_MANAGED. * * Generated from protobuf field optional .google.cloud.compute.v1.SecuritySettings security_settings = 478649922; * @return \Google\Cloud\Compute\V1\SecuritySettings|null @@ -1840,7 +2901,9 @@ public function clearSecuritySettings() } /** - * This field specifies the security settings that apply to this backend service. This field is applicable to a global backend service with the load_balancing_scheme set to INTERNAL_SELF_MANAGED. + * This field specifies the security settings that apply to this backend + * service. This field is applicable to a global backend service with the + * load_balancing_scheme set to INTERNAL_SELF_MANAGED. * * Generated from protobuf field optional .google.cloud.compute.v1.SecuritySettings security_settings = 478649922; * @param \Google\Cloud\Compute\V1\SecuritySettings $var @@ -1891,7 +2954,9 @@ public function setSelfLink($var) } /** - * URLs of networkservices.ServiceBinding resources. Can only be set if load balancing scheme is INTERNAL_SELF_MANAGED. If set, lists of backends and health checks must be both empty. + * URLs of networkservices.ServiceBinding resources. + * Can only be set if load balancing scheme is INTERNAL_SELF_MANAGED. + * If set, lists of backends and health checks must be both empty. * * Generated from protobuf field repeated string service_bindings = 133581016; * @return \Google\Protobuf\Internal\RepeatedField @@ -1902,7 +2967,9 @@ public function getServiceBindings() } /** - * URLs of networkservices.ServiceBinding resources. Can only be set if load balancing scheme is INTERNAL_SELF_MANAGED. If set, lists of backends and health checks must be both empty. + * URLs of networkservices.ServiceBinding resources. + * Can only be set if load balancing scheme is INTERNAL_SELF_MANAGED. + * If set, lists of backends and health checks must be both empty. * * Generated from protobuf field repeated string service_bindings = 133581016; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -1917,7 +2984,9 @@ public function setServiceBindings($var) } /** - * URL to networkservices.ServiceLbPolicy resource. Can only be set if load balancing scheme is EXTERNAL_MANAGED, INTERNAL_MANAGED or INTERNAL_SELF_MANAGED and the scope is global. + * URL to networkservices.ServiceLbPolicy resource. + * Can only be set if load balancing scheme is EXTERNAL_MANAGED, + * INTERNAL_MANAGED or INTERNAL_SELF_MANAGED and the scope is global. * * Generated from protobuf field optional string service_lb_policy = 94848785; * @return string @@ -1938,7 +3007,9 @@ public function clearServiceLbPolicy() } /** - * URL to networkservices.ServiceLbPolicy resource. Can only be set if load balancing scheme is EXTERNAL_MANAGED, INTERNAL_MANAGED or INTERNAL_SELF_MANAGED and the scope is global. + * URL to networkservices.ServiceLbPolicy resource. + * Can only be set if load balancing scheme is EXTERNAL_MANAGED, + * INTERNAL_MANAGED or INTERNAL_SELF_MANAGED and the scope is global. * * Generated from protobuf field optional string service_lb_policy = 94848785; * @param string $var @@ -1953,7 +3024,14 @@ public function setServiceLbPolicy($var) } /** - * Type of session affinity to use. The default is NONE. Only NONE and HEADER_FIELD are supported when the backend service is referenced by a URL map that is bound to target gRPC proxy that has validateForProxyless field set to true. For more details, see: [Session Affinity](https://cloud.google.com/load-balancing/docs/backend-service#session_affinity). sessionAffinity cannot be specified with haPolicy. + * Type of session affinity to use. The default is NONE. + * Only NONE and HEADER_FIELD are supported + * when the backend service is referenced by a URL map that is bound to + * target gRPC proxy that has validateForProxyless field set to true. + * For more details, see: + * [Session + * Affinity](https://cloud.google.com/load-balancing/docs/backend-service#session_affinity). + * sessionAffinity cannot be specified with haPolicy. * Check the SessionAffinity enum for the list of possible values. * * Generated from protobuf field optional string session_affinity = 463888561; @@ -1975,7 +3053,14 @@ public function clearSessionAffinity() } /** - * Type of session affinity to use. The default is NONE. Only NONE and HEADER_FIELD are supported when the backend service is referenced by a URL map that is bound to target gRPC proxy that has validateForProxyless field set to true. For more details, see: [Session Affinity](https://cloud.google.com/load-balancing/docs/backend-service#session_affinity). sessionAffinity cannot be specified with haPolicy. + * Type of session affinity to use. The default is NONE. + * Only NONE and HEADER_FIELD are supported + * when the backend service is referenced by a URL map that is bound to + * target gRPC proxy that has validateForProxyless field set to true. + * For more details, see: + * [Session + * Affinity](https://cloud.google.com/load-balancing/docs/backend-service#session_affinity). + * sessionAffinity cannot be specified with haPolicy. * Check the SessionAffinity enum for the list of possible values. * * Generated from protobuf field optional string session_affinity = 463888561; @@ -1991,7 +3076,8 @@ public function setSessionAffinity($var) } /** - * Describes the HTTP cookie used for stateful session affinity. This field is applicable and required if the sessionAffinity is set to STRONG_COOKIE_AFFINITY. + * Describes the HTTP cookie used for stateful session affinity. This field is + * applicable and required if the sessionAffinity is set toSTRONG_COOKIE_AFFINITY. * * Generated from protobuf field optional .google.cloud.compute.v1.BackendServiceHttpCookie strong_session_affinity_cookie = 238195722; * @return \Google\Cloud\Compute\V1\BackendServiceHttpCookie|null @@ -2012,7 +3098,8 @@ public function clearStrongSessionAffinityCookie() } /** - * Describes the HTTP cookie used for stateful session affinity. This field is applicable and required if the sessionAffinity is set to STRONG_COOKIE_AFFINITY. + * Describes the HTTP cookie used for stateful session affinity. This field is + * applicable and required if the sessionAffinity is set toSTRONG_COOKIE_AFFINITY. * * Generated from protobuf field optional .google.cloud.compute.v1.BackendServiceHttpCookie strong_session_affinity_cookie = 238195722; * @param \Google\Cloud\Compute\V1\BackendServiceHttpCookie $var @@ -2063,7 +3150,17 @@ public function setSubsetting($var) } /** - * The backend service timeout has a different meaning depending on the type of load balancer. For more information see, Backend service settings. The default is 30 seconds. The full range of timeout values allowed goes from 1 through 2,147,483,647 seconds. This value can be overridden in the PathMatcher configuration of the UrlMap that references this backend service. Not supported when the backend service is referenced by a URL map that is bound to target gRPC proxy that has validateForProxyless field set to true. Instead, use maxStreamDuration. + * The backend service timeout has a different meaning depending on the + * type of load balancer. For more information see, + * Backend service settings. + * The default is 30 seconds. + * The full range of timeout values allowed goes from 1 + * through 2,147,483,647 seconds. + * This value can be overridden in the PathMatcher configuration of the + * UrlMap that references this backend service. + * Not supported when the backend service is referenced by a URL map that is + * bound to target gRPC proxy that has validateForProxyless field set to true. + * Instead, use maxStreamDuration. * * Generated from protobuf field optional int32 timeout_sec = 79994995; * @return int @@ -2084,7 +3181,17 @@ public function clearTimeoutSec() } /** - * The backend service timeout has a different meaning depending on the type of load balancer. For more information see, Backend service settings. The default is 30 seconds. The full range of timeout values allowed goes from 1 through 2,147,483,647 seconds. This value can be overridden in the PathMatcher configuration of the UrlMap that references this backend service. Not supported when the backend service is referenced by a URL map that is bound to target gRPC proxy that has validateForProxyless field set to true. Instead, use maxStreamDuration. + * The backend service timeout has a different meaning depending on the + * type of load balancer. For more information see, + * Backend service settings. + * The default is 30 seconds. + * The full range of timeout values allowed goes from 1 + * through 2,147,483,647 seconds. + * This value can be overridden in the PathMatcher configuration of the + * UrlMap that references this backend service. + * Not supported when the backend service is referenced by a URL map that is + * bound to target gRPC proxy that has validateForProxyless field set to true. + * Instead, use maxStreamDuration. * * Generated from protobuf field optional int32 timeout_sec = 79994995; * @param int $var @@ -2099,7 +3206,8 @@ public function setTimeoutSec($var) } /** - * Configuration for Backend Authenticated TLS and mTLS. May only be specified when the backend protocol is SSL, HTTPS or HTTP2. + * Configuration for Backend Authenticated TLS and mTLS. May only be specified + * when the backend protocol is SSL, HTTPS or HTTP2. * * Generated from protobuf field optional .google.cloud.compute.v1.BackendServiceTlsSettings tls_settings = 81794791; * @return \Google\Cloud\Compute\V1\BackendServiceTlsSettings|null @@ -2120,7 +3228,8 @@ public function clearTlsSettings() } /** - * Configuration for Backend Authenticated TLS and mTLS. May only be specified when the backend protocol is SSL, HTTPS or HTTP2. + * Configuration for Backend Authenticated TLS and mTLS. May only be specified + * when the backend protocol is SSL, HTTPS or HTTP2. * * Generated from protobuf field optional .google.cloud.compute.v1.BackendServiceTlsSettings tls_settings = 81794791; * @param \Google\Cloud\Compute\V1\BackendServiceTlsSettings $var diff --git a/Compute/src/V1/BackendService/CompressionMode.php b/Compute/src/V1/BackendService/CompressionMode.php index 13514cb9ba46..b8bd34bf7bfb 100644 --- a/Compute/src/V1/BackendService/CompressionMode.php +++ b/Compute/src/V1/BackendService/CompressionMode.php @@ -7,7 +7,8 @@ use UnexpectedValueException; /** - * Compress text responses using Brotli or gzip compression, based on the client's Accept-Encoding header. + * Compress text responses using Brotli or gzip compression, based on + * the client's Accept-Encoding header. * * Protobuf type google.cloud.compute.v1.BackendService.CompressionMode */ @@ -20,13 +21,15 @@ class CompressionMode */ const UNDEFINED_COMPRESSION_MODE = 0; /** - * Automatically uses the best compression based on the Accept-Encoding header sent by the client. + * Automatically uses the best compression based on the Accept-Encoding + * header sent by the client. * * Generated from protobuf enum AUTOMATIC = 165298699; */ const AUTOMATIC = 165298699; /** - * Disables compression. Existing compressed responses cached by Cloud CDN will not be served to clients. + * Disables compression. Existing compressed responses cached by + * Cloud CDN will not be served to clients. * * Generated from protobuf enum DISABLED = 516696700; */ diff --git a/Compute/src/V1/BackendService/ExternalManagedMigrationState.php b/Compute/src/V1/BackendService/ExternalManagedMigrationState.php index a98017bd1528..12fda63f01d3 100644 --- a/Compute/src/V1/BackendService/ExternalManagedMigrationState.php +++ b/Compute/src/V1/BackendService/ExternalManagedMigrationState.php @@ -7,7 +7,18 @@ use UnexpectedValueException; /** - * Specifies the canary migration state. Possible values are PREPARE, TEST_BY_PERCENTAGE, and TEST_ALL_TRAFFIC. To begin the migration from EXTERNAL to EXTERNAL_MANAGED, the state must be changed to PREPARE. The state must be changed to TEST_ALL_TRAFFIC before the loadBalancingScheme can be changed to EXTERNAL_MANAGED. Optionally, the TEST_BY_PERCENTAGE state can be used to migrate traffic by percentage using externalManagedMigrationTestingPercentage. Rolling back a migration requires the states to be set in reverse order. So changing the scheme from EXTERNAL_MANAGED to EXTERNAL requires the state to be set to TEST_ALL_TRAFFIC at the same time. Optionally, the TEST_BY_PERCENTAGE state can be used to migrate some traffic back to EXTERNAL or PREPARE can be used to migrate all traffic back to EXTERNAL. + * Specifies the canary migration state. Possible values are PREPARE, + * TEST_BY_PERCENTAGE, and TEST_ALL_TRAFFIC. + * To begin the migration from EXTERNAL to EXTERNAL_MANAGED, the state must be + * changed to PREPARE. The state must be changed to TEST_ALL_TRAFFIC before + * the loadBalancingScheme can be changed to EXTERNAL_MANAGED. Optionally, the + * TEST_BY_PERCENTAGE state can be used to migrate traffic by percentage using + * externalManagedMigrationTestingPercentage. + * Rolling back a migration requires the states to be set in reverse order. So + * changing the scheme from EXTERNAL_MANAGED to EXTERNAL requires the state to + * be set to TEST_ALL_TRAFFIC at the same time. Optionally, the + * TEST_BY_PERCENTAGE state can be used to migrate some traffic back to + * EXTERNAL or PREPARE can be used to migrate all traffic back to EXTERNAL. * * Protobuf type google.cloud.compute.v1.BackendService.ExternalManagedMigrationState */ diff --git a/Compute/src/V1/BackendService/IpAddressSelectionPolicy.php b/Compute/src/V1/BackendService/IpAddressSelectionPolicy.php index cdc9e4ca56ef..89110b6e4156 100644 --- a/Compute/src/V1/BackendService/IpAddressSelectionPolicy.php +++ b/Compute/src/V1/BackendService/IpAddressSelectionPolicy.php @@ -7,7 +7,33 @@ use UnexpectedValueException; /** - * Specifies a preference for traffic sent from the proxy to the backend (or from the client to the backend for proxyless gRPC). The possible values are: - IPV4_ONLY: Only send IPv4 traffic to the backends of the backend service (Instance Group, Managed Instance Group, Network Endpoint Group), regardless of traffic from the client to the proxy. Only IPv4 health checks are used to check the health of the backends. This is the default setting. - PREFER_IPV6: Prioritize the connection to the endpoint's IPv6 address over its IPv4 address (provided there is a healthy IPv6 address). - IPV6_ONLY: Only send IPv6 traffic to the backends of the backend service (Instance Group, Managed Instance Group, Network Endpoint Group), regardless of traffic from the client to the proxy. Only IPv6 health checks are used to check the health of the backends. This field is applicable to either: - Advanced global external Application Load Balancer (load balancing scheme EXTERNAL_MANAGED), - Regional external Application Load Balancer, - Internal proxy Network Load Balancer (load balancing scheme INTERNAL_MANAGED), - Regional internal Application Load Balancer (load balancing scheme INTERNAL_MANAGED), - Traffic Director with Envoy proxies and proxyless gRPC (load balancing scheme INTERNAL_SELF_MANAGED). + * Specifies a preference for traffic sent from the proxy to the backend (or + * from the client to the backend for proxyless gRPC). + * The possible values are: + * - IPV4_ONLY: Only send IPv4 traffic to the backends of the + * backend service (Instance Group, Managed Instance Group, Network Endpoint + * Group), regardless of traffic from the client to the proxy. Only IPv4 + * health checks are used to check the health of the backends. This is the + * default setting. + * - PREFER_IPV6: Prioritize the connection to the endpoint's + * IPv6 address over its IPv4 address (provided there is a healthy IPv6 + * address). + * - IPV6_ONLY: Only send IPv6 traffic to the backends of the + * backend service (Instance Group, Managed Instance Group, Network Endpoint + * Group), regardless of traffic from the client to the proxy. Only IPv6 + * health checks are used to check the health of the backends. + * This field is applicable to either: + * - Advanced global external Application Load Balancer (load balancing + * scheme EXTERNAL_MANAGED), + * - Regional external Application Load + * Balancer, + * - Internal proxy Network Load Balancer (load balancing + * scheme INTERNAL_MANAGED), + * - Regional internal Application Load + * Balancer (load balancing scheme INTERNAL_MANAGED), + * - Traffic + * Director with Envoy proxies and proxyless gRPC (load balancing scheme + * INTERNAL_SELF_MANAGED). * * Protobuf type google.cloud.compute.v1.BackendService.IpAddressSelectionPolicy */ @@ -20,13 +46,20 @@ class IpAddressSelectionPolicy */ const UNDEFINED_IP_ADDRESS_SELECTION_POLICY = 0; /** - * Only send IPv4 traffic to the backends of the Backend Service (Instance Group, Managed Instance Group, Network Endpoint Group) regardless of traffic from the client to the proxy. Only IPv4 health-checks are used to check the health of the backends. This is the default setting. + * Only send IPv4 traffic to the backends of the Backend Service + * (Instance Group, Managed Instance Group, Network Endpoint Group) + * regardless of traffic from the client to the proxy. + * Only IPv4 health-checks are used to check the health of the backends. + * This is the default setting. * * Generated from protobuf enum IPV4_ONLY = 22373798; */ const IPV4_ONLY = 22373798; /** - * Only send IPv6 traffic to the backends of the Backend Service (Instance Group, Managed Instance Group, Network Endpoint Group) regardless of traffic from the client to the proxy. Only IPv6 health-checks are used to check the health of the backends. + * Only send IPv6 traffic to the backends of the Backend Service + * (Instance Group, Managed Instance Group, Network Endpoint Group) + * regardless of traffic from the client to the proxy. Only IPv6 + * health-checks are used to check the health of the backends. * * Generated from protobuf enum IPV6_ONLY = 79632100; */ @@ -38,7 +71,8 @@ class IpAddressSelectionPolicy */ const IP_ADDRESS_SELECTION_POLICY_UNSPECIFIED = 36210144; /** - * Prioritize the connection to the endpoints IPv6 address over its IPv4 address (provided there is a healthy IPv6 address). + * Prioritize the connection to the endpoints IPv6 address + * over its IPv4 address (provided there is a healthy IPv6 address). * * Generated from protobuf enum PREFER_IPV6 = 408601302; */ diff --git a/Compute/src/V1/BackendService/LoadBalancingScheme.php b/Compute/src/V1/BackendService/LoadBalancingScheme.php index 52ce4c416139..ed7625d8fd37 100644 --- a/Compute/src/V1/BackendService/LoadBalancingScheme.php +++ b/Compute/src/V1/BackendService/LoadBalancingScheme.php @@ -7,7 +7,10 @@ use UnexpectedValueException; /** - * Specifies the load balancer type. A backend service created for one type of load balancer cannot be used with another. For more information, refer to Choosing a load balancer. + * Specifies the load balancer type. A backend service + * created for one type of load balancer cannot be used with another. + * For more information, refer toChoosing + * a load balancer. * * Protobuf type google.cloud.compute.v1.BackendService.LoadBalancingScheme */ @@ -20,19 +23,24 @@ class LoadBalancingScheme */ const UNDEFINED_LOAD_BALANCING_SCHEME = 0; /** - * Signifies that this will be used for classic Application Load Balancers, global external proxy Network Load Balancers, or external passthrough Network Load Balancers. + * Signifies that this will be used for classic Application Load Balancers, + * global external proxy Network Load Balancers, + * or external passthrough Network Load Balancers. * * Generated from protobuf enum EXTERNAL = 35607499; */ const EXTERNAL = 35607499; /** - * Signifies that this will be used for global external Application Load Balancers, regional external Application Load Balancers, or regional external proxy Network Load Balancers. + * Signifies that this will be used for global external Application Load + * Balancers, regional external Application Load Balancers, or regional + * external proxy Network Load Balancers. * * Generated from protobuf enum EXTERNAL_MANAGED = 512006923; */ const EXTERNAL_MANAGED = 512006923; /** - * Signifies that this will be used for internal passthrough Network Load Balancers. + * Signifies that this will be used for internal passthrough Network Load + * Balancers. * * Generated from protobuf enum INTERNAL = 279295677; */ diff --git a/Compute/src/V1/BackendService/LocalityLbPolicy.php b/Compute/src/V1/BackendService/LocalityLbPolicy.php index a5cc80b340c2..17c3a0731293 100644 --- a/Compute/src/V1/BackendService/LocalityLbPolicy.php +++ b/Compute/src/V1/BackendService/LocalityLbPolicy.php @@ -7,7 +7,50 @@ use UnexpectedValueException; /** - * The load balancing algorithm used within the scope of the locality. The possible values are: - ROUND_ROBIN: This is a simple policy in which each healthy backend is selected in round robin order. This is the default. - LEAST_REQUEST: An O(1) algorithm which selects two random healthy hosts and picks the host which has fewer active requests. - RING_HASH: The ring/modulo hash load balancer implements consistent hashing to backends. The algorithm has the property that the addition/removal of a host from a set of N hosts only affects 1/N of the requests. - RANDOM: The load balancer selects a random healthy host. - ORIGINAL_DESTINATION: Backend host is selected based on the client connection metadata, i.e., connections are opened to the same address as the destination address of the incoming connection before the connection was redirected to the load balancer. - MAGLEV: used as a drop in replacement for the ring hash load balancer. Maglev is not as stable as ring hash but has faster table lookup build times and host selection times. For more information about Maglev, see Maglev: A Fast and Reliable Software Network Load Balancer. - WEIGHTED_ROUND_ROBIN: Per-endpoint Weighted Round Robin Load Balancing using weights computed from Backend reported Custom Metrics. If set, the Backend Service responses are expected to contain non-standard HTTP response header field Endpoint-Load-Metrics. The reported metrics to use for computing the weights are specified via the customMetrics field. This field is applicable to either: - A regional backend service with the service_protocol set to HTTP, HTTPS, HTTP2 or H2C, and load_balancing_scheme set to INTERNAL_MANAGED. - A global backend service with the load_balancing_scheme set to INTERNAL_SELF_MANAGED, INTERNAL_MANAGED, or EXTERNAL_MANAGED. If sessionAffinity is not configured—that is, if session affinity remains at the default value of NONE—then the default value for localityLbPolicy is ROUND_ROBIN. If session affinity is set to a value other than NONE, then the default value for localityLbPolicy is MAGLEV. Only ROUND_ROBIN and RING_HASH are supported when the backend service is referenced by a URL map that is bound to target gRPC proxy that has validateForProxyless field set to true. localityLbPolicy cannot be specified with haPolicy. + * The load balancing algorithm used within the scope of the locality. The + * possible values are: + * - ROUND_ROBIN: This is a simple policy in which each healthy + * backend is selected in round robin order. This is the default. + * - LEAST_REQUEST: An O(1) algorithm which + * selects two random healthy hosts and picks the host which has fewer active + * requests. + * - RING_HASH: The ring/modulo hash load balancer implements + * consistent hashing to backends. The algorithm has the property that the + * addition/removal of a host from a set of N hosts only affects 1/N of the + * requests. + * - RANDOM: The load balancer selects a random healthy + * host. + * - ORIGINAL_DESTINATION: Backend host is selected + * based on the client connection metadata, i.e., connections are opened to + * the same address as the destination address of the incoming connection + * before the connection was redirected to the load balancer. + * - MAGLEV: used as a drop in replacement for the ring hash + * load balancer. Maglev is not as stable as ring hash but has faster table + * lookup build times and host selection times. For more information about + * Maglev, see Maglev: + * A Fast and Reliable Software Network Load Balancer. + * - WEIGHTED_ROUND_ROBIN: Per-endpoint Weighted Round Robin + * Load Balancing using weights computed from Backend reported Custom Metrics. + * If set, the Backend Service responses are expected to contain non-standard + * HTTP response header field Endpoint-Load-Metrics. The reported + * metrics to use for computing the weights are specified via thecustomMetrics field. + * This field is applicable to either: + * - A regional backend service with the service_protocol set to HTTP, + * HTTPS, HTTP2 or H2C, and load_balancing_scheme set to + * INTERNAL_MANAGED. + * - A global backend service with the + * load_balancing_scheme set to INTERNAL_SELF_MANAGED, INTERNAL_MANAGED, or + * EXTERNAL_MANAGED. + * If sessionAffinity is not configured—that is, if session + * affinity remains at the default value of NONE—then the + * default value for localityLbPolicy + * is ROUND_ROBIN. If session affinity is set to a value other + * than NONE, + * then the default value for localityLbPolicy isMAGLEV. + * Only ROUND_ROBIN and RING_HASH are supported + * when the backend service is referenced by a URL map that is bound to + * target gRPC proxy that has validateForProxyless field set to true. + * localityLbPolicy cannot be specified with haPolicy. * * Protobuf type google.cloud.compute.v1.BackendService.LocalityLbPolicy */ @@ -24,19 +67,27 @@ class LocalityLbPolicy */ const INVALID_LB_POLICY = 323318707; /** - * An O(1) algorithm which selects two random healthy hosts and picks the host which has fewer active requests. + * An O(1) algorithm which selects two random healthy hosts and + * picks the host which has fewer active requests. * * Generated from protobuf enum LEAST_REQUEST = 46604921; */ const LEAST_REQUEST = 46604921; /** - * This algorithm implements consistent hashing to backends. Maglev can be used as a drop in replacement for the ring hash load balancer. Maglev is not as stable as ring hash but has faster table lookup build times and host selection times. For more information about Maglev, see Maglev: A Fast and Reliable Software Network Load Balancer. + * This algorithm implements consistent hashing to backends. Maglev can be + * used as a drop in replacement for the ring hash load balancer. Maglev is + * not as stable as ring hash but has faster table lookup build times and + * host selection times. For more information about Maglev, seeMaglev: + * A Fast and Reliable Software Network Load Balancer. * * Generated from protobuf enum MAGLEV = 119180266; */ const MAGLEV = 119180266; /** - * Backend host is selected based on the client connection metadata, i.e., connections are opened to the same address as the destination address of the incoming connection before the connection was redirected to the load balancer. + * Backend host is selected based on the client connection metadata, i.e., + * connections are opened to the same address as the destination address of + * the incoming connection before the connection was redirected to the load + * balancer. * * Generated from protobuf enum ORIGINAL_DESTINATION = 166297216; */ @@ -48,31 +99,52 @@ class LocalityLbPolicy */ const RANDOM = 262527171; /** - * The ring/modulo hash load balancer implements consistent hashing to backends. The algorithm has the property that the addition/removal of a host from a set of N hosts only affects 1/N of the requests. + * The ring/modulo hash load balancer implements consistent hashing to + * backends. The algorithm has the property that the addition/removal + * of a host from a set of N hosts only affects 1/N of the requests. * * Generated from protobuf enum RING_HASH = 432795069; */ const RING_HASH = 432795069; /** - * This is a simple policy in which each healthy backend is selected in round robin order. This is the default. + * This is a simple policy in which each healthy backend is selected + * in round robin order. This is the default. * * Generated from protobuf enum ROUND_ROBIN = 153895801; */ const ROUND_ROBIN = 153895801; /** - * Per-instance weighted Load Balancing via health check reported weights. In internal passthrough network load balancing, it is weighted rendezvous hashing. This option is only supported in internal passthrough network load balancing. + * Per-instance weighted Load Balancing via health check reported weights. + * In internal passthrough network load balancing, it is weighted + * rendezvous hashing. + * This option is only supported in internal passthrough network load + * balancing. * * Generated from protobuf enum WEIGHTED_GCP_RENDEZVOUS = 82501640; */ const WEIGHTED_GCP_RENDEZVOUS = 82501640; /** - * Per-instance weighted Load Balancing via health check reported weights. If set, the Backend Service must configure a non legacy HTTP-based Health Check, and health check replies are expected to contain non-standard HTTP response header field X-Load-Balancing-Endpoint-Weight to specify the per-instance weights. If set, Load Balancing is weighted based on the per-instance weights reported in the last processed health check replies, as long as every instance either reported a valid weight or had UNAVAILABLE_WEIGHT. Otherwise, Load Balancing remains equal-weight. This option is only supported in Network Load Balancing. + * Per-instance weighted Load Balancing via health check reported weights. + * If set, the Backend Service must configure a non legacy HTTP-based Health + * Check, and health check replies are expected to contain non-standard HTTP + * response header field X-Load-Balancing-Endpoint-Weight to specify the + * per-instance weights. + * If set, Load Balancing is weighted based on the + * per-instance weights reported in the last processed health check replies, + * as long as every instance either reported a valid weight or had + * UNAVAILABLE_WEIGHT. Otherwise, Load Balancing remains equal-weight. + * This option is only supported in Network Load Balancing. * * Generated from protobuf enum WEIGHTED_MAGLEV = 254930962; */ const WEIGHTED_MAGLEV = 254930962; /** - * Per-endpoint weighted round-robin Load Balancing using weights computed from Backend reported Custom Metrics. If set, the Backend Service responses are expected to contain non-standard HTTP response header field Endpoint-Load-Metrics. The reported metrics to use for computing the weights are specified via the customMetrics fields. + * Per-endpoint weighted round-robin Load Balancing using weights computed + * from Backend reported Custom Metrics. If set, the Backend Service + * responses are expected to contain non-standard HTTP response header field + * Endpoint-Load-Metrics. The reported metrics + * to use for computing the weights are specified via the + * customMetrics fields. * * Generated from protobuf enum WEIGHTED_ROUND_ROBIN = 5584977; */ diff --git a/Compute/src/V1/BackendService/Protocol.php b/Compute/src/V1/BackendService/Protocol.php index af854ad78d67..ee9c4ef38ade 100644 --- a/Compute/src/V1/BackendService/Protocol.php +++ b/Compute/src/V1/BackendService/Protocol.php @@ -7,7 +7,14 @@ use UnexpectedValueException; /** - * The protocol this BackendService uses to communicate with backends. Possible values are HTTP, HTTPS, HTTP2, H2C, TCP, SSL, UDP or GRPC. depending on the chosen load balancer or Traffic Director configuration. Refer to the documentation for the load balancers or for Traffic Director for more information. Must be set to GRPC when the backend service is referenced by a URL map that is bound to target gRPC proxy. + * The protocol this BackendService uses to communicate + * with backends. + * Possible values are HTTP, HTTPS, HTTP2, H2C, TCP, SSL, UDP or GRPC. + * depending on the chosen load balancer or Traffic Director configuration. + * Refer to the documentation for the load balancers or for Traffic Director + * for more information. + * Must be set to GRPC when the backend service is referenced by a URL map + * that is bound to target gRPC proxy. * * Protobuf type google.cloud.compute.v1.BackendService.Protocol */ @@ -64,7 +71,8 @@ class Protocol */ const UDP = 83873; /** - * If a Backend Service has UNSPECIFIED as its protocol, it can be used with any L3/L4 Forwarding Rules. + * If a Backend Service has UNSPECIFIED as its protocol, it can be used with + * any L3/L4 Forwarding Rules. * * Generated from protobuf enum UNSPECIFIED = 526786327; */ diff --git a/Compute/src/V1/BackendService/SessionAffinity.php b/Compute/src/V1/BackendService/SessionAffinity.php index 17a85c26c30d..3432c9fe59e2 100644 --- a/Compute/src/V1/BackendService/SessionAffinity.php +++ b/Compute/src/V1/BackendService/SessionAffinity.php @@ -7,7 +7,14 @@ use UnexpectedValueException; /** - * Type of session affinity to use. The default is NONE. Only NONE and HEADER_FIELD are supported when the backend service is referenced by a URL map that is bound to target gRPC proxy that has validateForProxyless field set to true. For more details, see: [Session Affinity](https://cloud.google.com/load-balancing/docs/backend-service#session_affinity). sessionAffinity cannot be specified with haPolicy. + * Type of session affinity to use. The default is NONE. + * Only NONE and HEADER_FIELD are supported + * when the backend service is referenced by a URL map that is bound to + * target gRPC proxy that has validateForProxyless field set to true. + * For more details, see: + * [Session + * Affinity](https://cloud.google.com/load-balancing/docs/backend-service#session_affinity). + * sessionAffinity cannot be specified with haPolicy. * * Protobuf type google.cloud.compute.v1.BackendService.SessionAffinity */ @@ -20,31 +27,45 @@ class SessionAffinity */ const UNDEFINED_SESSION_AFFINITY = 0; /** - * 2-tuple hash on packet's source and destination IP addresses. Connections from the same source IP address to the same destination IP address will be served by the same backend VM while that VM remains healthy. + * 2-tuple hash on packet's source and destination IP addresses. Connections + * from the same source IP address to the same destination IP address will be + * served by the same backend VM while that VM remains healthy. * * Generated from protobuf enum CLIENT_IP = 345665051; */ const CLIENT_IP = 345665051; /** - * 1-tuple hash only on packet's source IP address. Connections from the same source IP address will be served by the same backend VM while that VM remains healthy. This option can only be used for Internal TCP/UDP Load Balancing. + * 1-tuple hash only on packet's source IP address. Connections from the + * same source IP address will be served by the same backend VM while that VM + * remains healthy. This option can only be used for Internal TCP/UDP + * Load Balancing. * * Generated from protobuf enum CLIENT_IP_NO_DESTINATION = 106122516; */ const CLIENT_IP_NO_DESTINATION = 106122516; /** - * 5-tuple hash on packet's source and destination IP addresses, IP protocol, and source and destination ports. Connections for the same IP protocol from the same source IP address and port to the same destination IP address and port will be served by the same backend VM while that VM remains healthy. This option cannot be used for HTTP(S) load balancing. + * 5-tuple hash on packet's source and destination IP addresses, IP protocol, + * and source and destination ports. Connections for the same IP protocol + * from the same source IP address and port to the same destination IP address + * and port will be served by the same backend VM while that VM remains + * healthy. This option cannot be used for HTTP(S) load balancing. * * Generated from protobuf enum CLIENT_IP_PORT_PROTO = 221722926; */ const CLIENT_IP_PORT_PROTO = 221722926; /** - * 3-tuple hash on packet's source and destination IP addresses, and IP protocol. Connections for the same IP protocol from the same source IP address to the same destination IP address will be served by the same backend VM while that VM remains healthy. This option cannot be used for HTTP(S) load balancing. + * 3-tuple hash on packet's source and destination IP addresses, and IP + * protocol. Connections for the same IP protocol from the same source IP + * address to the same destination IP address will be served by the same + * backend VM while that VM remains healthy. This option cannot be used for + * HTTP(S) load balancing. * * Generated from protobuf enum CLIENT_IP_PROTO = 25322148; */ const CLIENT_IP_PROTO = 25322148; /** - * Hash based on a cookie generated by the L7 loadbalancer. Only valid for HTTP(S) load balancing. + * Hash based on a cookie generated by the L7 loadbalancer. + * Only valid for HTTP(S) load balancing. * * Generated from protobuf enum GENERATED_COOKIE = 370321204; */ @@ -62,13 +83,16 @@ class SessionAffinity */ const HTTP_COOKIE = 494981627; /** - * No session affinity. Connections from the same client IP may go to any instance in the pool. + * No session affinity. Connections from the same client IP may go + * to any instance in the pool. * * Generated from protobuf enum NONE = 2402104; */ const NONE = 2402104; /** - * Strong cookie-based affinity. Connections bearing the same cookie will be served by the same backend VM while that VM remains healthy, as long as the cookie has not expired. + * Strong cookie-based affinity. Connections bearing the same cookie will be + * served by the same backend VM while that VM remains healthy, as long as the + * cookie has not expired. * * Generated from protobuf enum STRONG_COOKIE_AFFINITY = 438628091; */ diff --git a/Compute/src/V1/BackendServiceAggregatedList.php b/Compute/src/V1/BackendServiceAggregatedList.php index c1e5e2d3254c..c2645daa47a1 100644 --- a/Compute/src/V1/BackendServiceAggregatedList.php +++ b/Compute/src/V1/BackendServiceAggregatedList.php @@ -34,7 +34,11 @@ class BackendServiceAggregatedList extends \Google\Protobuf\Internal\Message */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -71,7 +75,11 @@ class BackendServiceAggregatedList extends \Google\Protobuf\Internal\Message * @type string $kind * Type of resource. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type array|\Google\Protobuf\Internal\RepeatedField $unreachables @@ -184,7 +192,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -205,7 +217,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/BackendServiceCdnPolicy.php b/Compute/src/V1/BackendServiceCdnPolicy.php index 5e053e989cb1..bb923db6eab1 100644 --- a/Compute/src/V1/BackendServiceCdnPolicy.php +++ b/Compute/src/V1/BackendServiceCdnPolicy.php @@ -16,7 +16,9 @@ class BackendServiceCdnPolicy extends \Google\Protobuf\Internal\Message { /** - * Bypass the cache when the specified request headers are matched - e.g. Pragma or Authorization headers. Up to 5 headers can be specified. The cache is bypassed for all cdnPolicy.cacheMode settings. + * Bypass the cache when the specified request headers are matched - e.g. + * Pragma or Authorization headers. Up to 5 headers can be specified. + * The cache is bypassed for all cdnPolicy.cacheMode settings. * * Generated from protobuf field repeated .google.cloud.compute.v1.BackendServiceCdnPolicyBypassCacheOnRequestHeader bypass_cache_on_request_headers = 486203082; */ @@ -28,56 +30,138 @@ class BackendServiceCdnPolicy extends \Google\Protobuf\Internal\Message */ protected $cache_key_policy = null; /** - * Specifies the cache setting for all responses from this backend. The possible values are: USE_ORIGIN_HEADERS Requires the origin to set valid caching headers to cache content. Responses without these headers will not be cached at Google's edge, and will require a full trip to the origin on every request, potentially impacting performance and increasing load on the origin server. FORCE_CACHE_ALL Cache all content, ignoring any "private", "no-store" or "no-cache" directives in Cache-Control response headers. Warning: this may result in Cloud CDN caching private, per-user (user identifiable) content. CACHE_ALL_STATIC Automatically cache static content, including common image formats, media (video and audio), and web assets (JavaScript and CSS). Requests and responses that are marked as uncacheable, as well as dynamic content (including HTML), will not be cached. If no value is provided for cdnPolicy.cacheMode, it defaults to CACHE_ALL_STATIC. + * Specifies the cache setting for all responses from this backend. + * The possible values are:USE_ORIGIN_HEADERS Requires the origin to set valid caching + * headers to cache content. Responses without these headers will not be + * cached at Google's edge, and will require a full trip to the origin on + * every request, potentially impacting performance and increasing load on + * the origin server.FORCE_CACHE_ALL Cache all content, ignoring any "private", + * "no-store" or "no-cache" directives in Cache-Control response headers. + * Warning: this may result in Cloud CDN caching private, + * per-user (user identifiable) content.CACHE_ALL_STATIC Automatically cache static content, + * including common image formats, media (video and audio), and web assets + * (JavaScript and CSS). Requests and responses that are marked as + * uncacheable, as well as dynamic content (including HTML), will not be + * cached. + * If no value is provided for cdnPolicy.cacheMode, it defaults + * to CACHE_ALL_STATIC. * Check the CacheMode enum for the list of possible values. * * Generated from protobuf field optional string cache_mode = 28877888; */ protected $cache_mode = null; /** - * Specifies a separate client (e.g. browser client) maximum TTL. This is used to clamp the max-age (or Expires) value sent to the client. With FORCE_CACHE_ALL, the lesser of client_ttl and default_ttl is used for the response max-age directive, along with a "public" directive. For cacheable content in CACHE_ALL_STATIC mode, client_ttl clamps the max-age from the origin (if specified), or else sets the response max-age directive to the lesser of the client_ttl and default_ttl, and also ensures a "public" cache-control directive is present. If a client TTL is not specified, a default value (1 hour) will be used. The maximum allowed value is 31,622,400s (1 year). + * Specifies a separate client (e.g. browser client) maximum TTL. This is + * used to clamp the max-age (or Expires) value sent to the client. With + * FORCE_CACHE_ALL, the lesser of client_ttl and default_ttl is used for the + * response max-age directive, along with a "public" directive. For + * cacheable content in CACHE_ALL_STATIC mode, client_ttl clamps the max-age + * from the origin (if specified), or else sets the response max-age + * directive to the lesser of the client_ttl and default_ttl, and also + * ensures a "public" cache-control directive is present. + * If a client TTL is not specified, a default value (1 hour) will be used. + * The maximum allowed value is 31,622,400s (1 year). * * Generated from protobuf field optional int32 client_ttl = 29034360; */ protected $client_ttl = null; /** - * Specifies the default TTL for cached content served by this origin for responses that do not have an existing valid TTL (max-age or s-maxage). Setting a TTL of "0" means "always revalidate". The value of defaultTTL cannot be set to a value greater than that of maxTTL, but can be equal. When the cacheMode is set to FORCE_CACHE_ALL, the defaultTTL will overwrite the TTL set in all responses. The maximum allowed value is 31,622,400s (1 year), noting that infrequently accessed objects may be evicted from the cache before the defined TTL. + * Specifies the default TTL for cached content served by this origin for + * responses that do not have an existing valid TTL (max-age or s-maxage). + * Setting a TTL of "0" means "always revalidate". + * The value of defaultTTL cannot be set to a value greater than that of + * maxTTL, but can be equal. + * When the cacheMode is set to FORCE_CACHE_ALL, the defaultTTL + * will overwrite the TTL set in all responses. The maximum allowed value is + * 31,622,400s (1 year), noting that infrequently accessed objects may be + * evicted from the cache before the defined TTL. * * Generated from protobuf field optional int32 default_ttl = 100253422; */ protected $default_ttl = null; /** - * Specifies the maximum allowed TTL for cached content served by this origin. Cache directives that attempt to set a max-age or s-maxage higher than this, or an Expires header more than maxTTL seconds in the future will be capped at the value of maxTTL, as if it were the value of an s-maxage Cache-Control directive. Headers sent to the client will not be modified. Setting a TTL of "0" means "always revalidate". The maximum allowed value is 31,622,400s (1 year), noting that infrequently accessed objects may be evicted from the cache before the defined TTL. + * Specifies the maximum allowed TTL for cached content served by this + * origin. + * Cache directives that attempt to set a max-age or s-maxage higher than + * this, or an Expires header more than maxTTL seconds in the future will + * be capped at the value of maxTTL, as if it were the value of an + * s-maxage Cache-Control directive. + * Headers sent to the client will not be modified. + * Setting a TTL of "0" means "always revalidate". + * The maximum allowed value is 31,622,400s (1 year), noting that + * infrequently accessed objects may be evicted from the cache before + * the defined TTL. * * Generated from protobuf field optional int32 max_ttl = 307578001; */ protected $max_ttl = null; /** - * Negative caching allows per-status code TTLs to be set, in order to apply fine-grained caching for common errors or redirects. This can reduce the load on your origin and improve end-user experience by reducing response latency. When the cache mode is set to CACHE_ALL_STATIC or USE_ORIGIN_HEADERS, negative caching applies to responses with the specified response code that lack any Cache-Control, Expires, or Pragma: no-cache directives. When the cache mode is set to FORCE_CACHE_ALL, negative caching applies to all responses with the specified response code, and override any caching headers. By default, Cloud CDN will apply the following default TTLs to these status codes: HTTP 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m HTTP 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s HTTP 405 (Method Not Found), 501 (Not Implemented): 60s. These defaults can be overridden in negative_caching_policy. + * Negative caching allows per-status code TTLs to be set, in order + * to apply fine-grained caching for common errors or redirects. + * This can reduce the load on your origin and improve end-user + * experience by reducing response latency. + * When the cache mode is set to CACHE_ALL_STATIC or USE_ORIGIN_HEADERS, + * negative caching applies to responses with the specified response code + * that lack any Cache-Control, Expires, or Pragma: no-cache directives. + * When the cache mode is set to FORCE_CACHE_ALL, negative caching applies + * to all responses with the specified response code, and override any + * caching headers. + * By default, Cloud CDN will apply the following default TTLs to these + * status codes: + * HTTP 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m + * HTTP 404 (Not Found), 410 (Gone), + * 451 (Unavailable For Legal Reasons): 120s + * HTTP 405 (Method Not Found), 501 (Not Implemented): 60s. + * These defaults can be overridden in negative_caching_policy. * * Generated from protobuf field optional bool negative_caching = 336110005; */ protected $negative_caching = null; /** - * Sets a cache TTL for the specified HTTP status code. negative_caching must be enabled to configure negative_caching_policy. Omitting the policy and leaving negative_caching enabled will use Cloud CDN's default cache TTLs. Note that when specifying an explicit negative_caching_policy, you should take care to specify a cache TTL for all response codes that you wish to cache. Cloud CDN will not apply any default negative caching when a policy exists. + * Sets a cache TTL for the specified HTTP status code. + * negative_caching must be enabled to configure negative_caching_policy. + * Omitting the policy and leaving negative_caching enabled will use + * Cloud CDN's default cache TTLs. + * Note that when specifying an explicit negative_caching_policy, you + * should take care to specify a cache TTL for all response codes + * that you wish to cache. Cloud CDN will not apply any default + * negative caching when a policy exists. * * Generated from protobuf field repeated .google.cloud.compute.v1.BackendServiceCdnPolicyNegativeCachingPolicy negative_caching_policy = 155359996; */ private $negative_caching_policy; /** - * If true then Cloud CDN will combine multiple concurrent cache fill requests into a small number of requests to the origin. + * If true then Cloud CDN will combine multiple concurrent cache fill + * requests into a small number of requests to the origin. * * Generated from protobuf field optional bool request_coalescing = 532808276; */ protected $request_coalescing = null; /** - * Serve existing content from the cache (if available) when revalidating content with the origin, or when an error is encountered when refreshing the cache. This setting defines the default "max-stale" duration for any cached responses that do not specify a max-stale directive. Stale responses that exceed the TTL configured here will not be served. The default limit (max-stale) is 86400s (1 day), which will allow stale content to be served up to this limit beyond the max-age (or s-maxage) of a cached response. The maximum allowed value is 604800 (1 week). Set this to zero (0) to disable serve-while-stale. + * Serve existing content from the cache (if available) when revalidating + * content with the origin, or when an error is encountered when refreshing + * the cache. + * This setting defines the default "max-stale" duration for any cached + * responses that do not specify a max-stale directive. Stale responses that + * exceed the TTL configured here will not be served. The default limit + * (max-stale) is 86400s (1 day), which will allow stale content to be + * served up to this limit beyond the max-age (or s-maxage) of a cached + * response. + * The maximum allowed value is 604800 (1 week). + * Set this to zero (0) to disable serve-while-stale. * * Generated from protobuf field optional int32 serve_while_stale = 236682203; */ protected $serve_while_stale = null; /** - * Maximum number of seconds the response to a signed URL request will be considered fresh. After this time period, the response will be revalidated before being served. Defaults to 1hr (3600s). When serving responses to signed URL requests, Cloud CDN will internally behave as though all responses from this backend had a "Cache-Control: public, max-age=[TTL]" header, regardless of any existing Cache-Control header. The actual headers served in responses will not be altered. + * Maximum number of seconds the response to a signed URL request will be + * considered fresh. After this time period, the response will be + * revalidated before being served. Defaults to 1hr (3600s). When serving + * responses to signed URL requests, Cloud CDN will internally behave as + * though all responses from this backend had a "Cache-Control: + * public, max-age=[TTL]" header, regardless of any existing + * Cache-Control header. The actual headers served in responses will not be + * altered. * * Generated from protobuf field optional int64 signed_url_cache_max_age_sec = 269374534; */ @@ -96,28 +180,112 @@ class BackendServiceCdnPolicy extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type array<\Google\Cloud\Compute\V1\BackendServiceCdnPolicyBypassCacheOnRequestHeader>|\Google\Protobuf\Internal\RepeatedField $bypass_cache_on_request_headers - * Bypass the cache when the specified request headers are matched - e.g. Pragma or Authorization headers. Up to 5 headers can be specified. The cache is bypassed for all cdnPolicy.cacheMode settings. + * Bypass the cache when the specified request headers are matched - e.g. + * Pragma or Authorization headers. Up to 5 headers can be specified. + * The cache is bypassed for all cdnPolicy.cacheMode settings. * @type \Google\Cloud\Compute\V1\CacheKeyPolicy $cache_key_policy * The CacheKeyPolicy for this CdnPolicy. * @type string $cache_mode - * Specifies the cache setting for all responses from this backend. The possible values are: USE_ORIGIN_HEADERS Requires the origin to set valid caching headers to cache content. Responses without these headers will not be cached at Google's edge, and will require a full trip to the origin on every request, potentially impacting performance and increasing load on the origin server. FORCE_CACHE_ALL Cache all content, ignoring any "private", "no-store" or "no-cache" directives in Cache-Control response headers. Warning: this may result in Cloud CDN caching private, per-user (user identifiable) content. CACHE_ALL_STATIC Automatically cache static content, including common image formats, media (video and audio), and web assets (JavaScript and CSS). Requests and responses that are marked as uncacheable, as well as dynamic content (including HTML), will not be cached. If no value is provided for cdnPolicy.cacheMode, it defaults to CACHE_ALL_STATIC. + * Specifies the cache setting for all responses from this backend. + * The possible values are:USE_ORIGIN_HEADERS Requires the origin to set valid caching + * headers to cache content. Responses without these headers will not be + * cached at Google's edge, and will require a full trip to the origin on + * every request, potentially impacting performance and increasing load on + * the origin server.FORCE_CACHE_ALL Cache all content, ignoring any "private", + * "no-store" or "no-cache" directives in Cache-Control response headers. + * Warning: this may result in Cloud CDN caching private, + * per-user (user identifiable) content.CACHE_ALL_STATIC Automatically cache static content, + * including common image formats, media (video and audio), and web assets + * (JavaScript and CSS). Requests and responses that are marked as + * uncacheable, as well as dynamic content (including HTML), will not be + * cached. + * If no value is provided for cdnPolicy.cacheMode, it defaults + * to CACHE_ALL_STATIC. * Check the CacheMode enum for the list of possible values. * @type int $client_ttl - * Specifies a separate client (e.g. browser client) maximum TTL. This is used to clamp the max-age (or Expires) value sent to the client. With FORCE_CACHE_ALL, the lesser of client_ttl and default_ttl is used for the response max-age directive, along with a "public" directive. For cacheable content in CACHE_ALL_STATIC mode, client_ttl clamps the max-age from the origin (if specified), or else sets the response max-age directive to the lesser of the client_ttl and default_ttl, and also ensures a "public" cache-control directive is present. If a client TTL is not specified, a default value (1 hour) will be used. The maximum allowed value is 31,622,400s (1 year). + * Specifies a separate client (e.g. browser client) maximum TTL. This is + * used to clamp the max-age (or Expires) value sent to the client. With + * FORCE_CACHE_ALL, the lesser of client_ttl and default_ttl is used for the + * response max-age directive, along with a "public" directive. For + * cacheable content in CACHE_ALL_STATIC mode, client_ttl clamps the max-age + * from the origin (if specified), or else sets the response max-age + * directive to the lesser of the client_ttl and default_ttl, and also + * ensures a "public" cache-control directive is present. + * If a client TTL is not specified, a default value (1 hour) will be used. + * The maximum allowed value is 31,622,400s (1 year). * @type int $default_ttl - * Specifies the default TTL for cached content served by this origin for responses that do not have an existing valid TTL (max-age or s-maxage). Setting a TTL of "0" means "always revalidate". The value of defaultTTL cannot be set to a value greater than that of maxTTL, but can be equal. When the cacheMode is set to FORCE_CACHE_ALL, the defaultTTL will overwrite the TTL set in all responses. The maximum allowed value is 31,622,400s (1 year), noting that infrequently accessed objects may be evicted from the cache before the defined TTL. + * Specifies the default TTL for cached content served by this origin for + * responses that do not have an existing valid TTL (max-age or s-maxage). + * Setting a TTL of "0" means "always revalidate". + * The value of defaultTTL cannot be set to a value greater than that of + * maxTTL, but can be equal. + * When the cacheMode is set to FORCE_CACHE_ALL, the defaultTTL + * will overwrite the TTL set in all responses. The maximum allowed value is + * 31,622,400s (1 year), noting that infrequently accessed objects may be + * evicted from the cache before the defined TTL. * @type int $max_ttl - * Specifies the maximum allowed TTL for cached content served by this origin. Cache directives that attempt to set a max-age or s-maxage higher than this, or an Expires header more than maxTTL seconds in the future will be capped at the value of maxTTL, as if it were the value of an s-maxage Cache-Control directive. Headers sent to the client will not be modified. Setting a TTL of "0" means "always revalidate". The maximum allowed value is 31,622,400s (1 year), noting that infrequently accessed objects may be evicted from the cache before the defined TTL. + * Specifies the maximum allowed TTL for cached content served by this + * origin. + * Cache directives that attempt to set a max-age or s-maxage higher than + * this, or an Expires header more than maxTTL seconds in the future will + * be capped at the value of maxTTL, as if it were the value of an + * s-maxage Cache-Control directive. + * Headers sent to the client will not be modified. + * Setting a TTL of "0" means "always revalidate". + * The maximum allowed value is 31,622,400s (1 year), noting that + * infrequently accessed objects may be evicted from the cache before + * the defined TTL. * @type bool $negative_caching - * Negative caching allows per-status code TTLs to be set, in order to apply fine-grained caching for common errors or redirects. This can reduce the load on your origin and improve end-user experience by reducing response latency. When the cache mode is set to CACHE_ALL_STATIC or USE_ORIGIN_HEADERS, negative caching applies to responses with the specified response code that lack any Cache-Control, Expires, or Pragma: no-cache directives. When the cache mode is set to FORCE_CACHE_ALL, negative caching applies to all responses with the specified response code, and override any caching headers. By default, Cloud CDN will apply the following default TTLs to these status codes: HTTP 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m HTTP 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s HTTP 405 (Method Not Found), 501 (Not Implemented): 60s. These defaults can be overridden in negative_caching_policy. + * Negative caching allows per-status code TTLs to be set, in order + * to apply fine-grained caching for common errors or redirects. + * This can reduce the load on your origin and improve end-user + * experience by reducing response latency. + * When the cache mode is set to CACHE_ALL_STATIC or USE_ORIGIN_HEADERS, + * negative caching applies to responses with the specified response code + * that lack any Cache-Control, Expires, or Pragma: no-cache directives. + * When the cache mode is set to FORCE_CACHE_ALL, negative caching applies + * to all responses with the specified response code, and override any + * caching headers. + * By default, Cloud CDN will apply the following default TTLs to these + * status codes: + * HTTP 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m + * HTTP 404 (Not Found), 410 (Gone), + * 451 (Unavailable For Legal Reasons): 120s + * HTTP 405 (Method Not Found), 501 (Not Implemented): 60s. + * These defaults can be overridden in negative_caching_policy. * @type array<\Google\Cloud\Compute\V1\BackendServiceCdnPolicyNegativeCachingPolicy>|\Google\Protobuf\Internal\RepeatedField $negative_caching_policy - * Sets a cache TTL for the specified HTTP status code. negative_caching must be enabled to configure negative_caching_policy. Omitting the policy and leaving negative_caching enabled will use Cloud CDN's default cache TTLs. Note that when specifying an explicit negative_caching_policy, you should take care to specify a cache TTL for all response codes that you wish to cache. Cloud CDN will not apply any default negative caching when a policy exists. + * Sets a cache TTL for the specified HTTP status code. + * negative_caching must be enabled to configure negative_caching_policy. + * Omitting the policy and leaving negative_caching enabled will use + * Cloud CDN's default cache TTLs. + * Note that when specifying an explicit negative_caching_policy, you + * should take care to specify a cache TTL for all response codes + * that you wish to cache. Cloud CDN will not apply any default + * negative caching when a policy exists. * @type bool $request_coalescing - * If true then Cloud CDN will combine multiple concurrent cache fill requests into a small number of requests to the origin. + * If true then Cloud CDN will combine multiple concurrent cache fill + * requests into a small number of requests to the origin. * @type int $serve_while_stale - * Serve existing content from the cache (if available) when revalidating content with the origin, or when an error is encountered when refreshing the cache. This setting defines the default "max-stale" duration for any cached responses that do not specify a max-stale directive. Stale responses that exceed the TTL configured here will not be served. The default limit (max-stale) is 86400s (1 day), which will allow stale content to be served up to this limit beyond the max-age (or s-maxage) of a cached response. The maximum allowed value is 604800 (1 week). Set this to zero (0) to disable serve-while-stale. + * Serve existing content from the cache (if available) when revalidating + * content with the origin, or when an error is encountered when refreshing + * the cache. + * This setting defines the default "max-stale" duration for any cached + * responses that do not specify a max-stale directive. Stale responses that + * exceed the TTL configured here will not be served. The default limit + * (max-stale) is 86400s (1 day), which will allow stale content to be + * served up to this limit beyond the max-age (or s-maxage) of a cached + * response. + * The maximum allowed value is 604800 (1 week). + * Set this to zero (0) to disable serve-while-stale. * @type int|string $signed_url_cache_max_age_sec - * Maximum number of seconds the response to a signed URL request will be considered fresh. After this time period, the response will be revalidated before being served. Defaults to 1hr (3600s). When serving responses to signed URL requests, Cloud CDN will internally behave as though all responses from this backend had a "Cache-Control: public, max-age=[TTL]" header, regardless of any existing Cache-Control header. The actual headers served in responses will not be altered. + * Maximum number of seconds the response to a signed URL request will be + * considered fresh. After this time period, the response will be + * revalidated before being served. Defaults to 1hr (3600s). When serving + * responses to signed URL requests, Cloud CDN will internally behave as + * though all responses from this backend had a "Cache-Control: + * public, max-age=[TTL]" header, regardless of any existing + * Cache-Control header. The actual headers served in responses will not be + * altered. * @type array|\Google\Protobuf\Internal\RepeatedField $signed_url_key_names * [Output Only] Names of the keys for signing request URLs. * } @@ -128,7 +296,9 @@ public function __construct($data = NULL) { } /** - * Bypass the cache when the specified request headers are matched - e.g. Pragma or Authorization headers. Up to 5 headers can be specified. The cache is bypassed for all cdnPolicy.cacheMode settings. + * Bypass the cache when the specified request headers are matched - e.g. + * Pragma or Authorization headers. Up to 5 headers can be specified. + * The cache is bypassed for all cdnPolicy.cacheMode settings. * * Generated from protobuf field repeated .google.cloud.compute.v1.BackendServiceCdnPolicyBypassCacheOnRequestHeader bypass_cache_on_request_headers = 486203082; * @return \Google\Protobuf\Internal\RepeatedField @@ -139,7 +309,9 @@ public function getBypassCacheOnRequestHeaders() } /** - * Bypass the cache when the specified request headers are matched - e.g. Pragma or Authorization headers. Up to 5 headers can be specified. The cache is bypassed for all cdnPolicy.cacheMode settings. + * Bypass the cache when the specified request headers are matched - e.g. + * Pragma or Authorization headers. Up to 5 headers can be specified. + * The cache is bypassed for all cdnPolicy.cacheMode settings. * * Generated from protobuf field repeated .google.cloud.compute.v1.BackendServiceCdnPolicyBypassCacheOnRequestHeader bypass_cache_on_request_headers = 486203082; * @param array<\Google\Cloud\Compute\V1\BackendServiceCdnPolicyBypassCacheOnRequestHeader>|\Google\Protobuf\Internal\RepeatedField $var @@ -190,7 +362,21 @@ public function setCacheKeyPolicy($var) } /** - * Specifies the cache setting for all responses from this backend. The possible values are: USE_ORIGIN_HEADERS Requires the origin to set valid caching headers to cache content. Responses without these headers will not be cached at Google's edge, and will require a full trip to the origin on every request, potentially impacting performance and increasing load on the origin server. FORCE_CACHE_ALL Cache all content, ignoring any "private", "no-store" or "no-cache" directives in Cache-Control response headers. Warning: this may result in Cloud CDN caching private, per-user (user identifiable) content. CACHE_ALL_STATIC Automatically cache static content, including common image formats, media (video and audio), and web assets (JavaScript and CSS). Requests and responses that are marked as uncacheable, as well as dynamic content (including HTML), will not be cached. If no value is provided for cdnPolicy.cacheMode, it defaults to CACHE_ALL_STATIC. + * Specifies the cache setting for all responses from this backend. + * The possible values are:USE_ORIGIN_HEADERS Requires the origin to set valid caching + * headers to cache content. Responses without these headers will not be + * cached at Google's edge, and will require a full trip to the origin on + * every request, potentially impacting performance and increasing load on + * the origin server.FORCE_CACHE_ALL Cache all content, ignoring any "private", + * "no-store" or "no-cache" directives in Cache-Control response headers. + * Warning: this may result in Cloud CDN caching private, + * per-user (user identifiable) content.CACHE_ALL_STATIC Automatically cache static content, + * including common image formats, media (video and audio), and web assets + * (JavaScript and CSS). Requests and responses that are marked as + * uncacheable, as well as dynamic content (including HTML), will not be + * cached. + * If no value is provided for cdnPolicy.cacheMode, it defaults + * to CACHE_ALL_STATIC. * Check the CacheMode enum for the list of possible values. * * Generated from protobuf field optional string cache_mode = 28877888; @@ -212,7 +398,21 @@ public function clearCacheMode() } /** - * Specifies the cache setting for all responses from this backend. The possible values are: USE_ORIGIN_HEADERS Requires the origin to set valid caching headers to cache content. Responses without these headers will not be cached at Google's edge, and will require a full trip to the origin on every request, potentially impacting performance and increasing load on the origin server. FORCE_CACHE_ALL Cache all content, ignoring any "private", "no-store" or "no-cache" directives in Cache-Control response headers. Warning: this may result in Cloud CDN caching private, per-user (user identifiable) content. CACHE_ALL_STATIC Automatically cache static content, including common image formats, media (video and audio), and web assets (JavaScript and CSS). Requests and responses that are marked as uncacheable, as well as dynamic content (including HTML), will not be cached. If no value is provided for cdnPolicy.cacheMode, it defaults to CACHE_ALL_STATIC. + * Specifies the cache setting for all responses from this backend. + * The possible values are:USE_ORIGIN_HEADERS Requires the origin to set valid caching + * headers to cache content. Responses without these headers will not be + * cached at Google's edge, and will require a full trip to the origin on + * every request, potentially impacting performance and increasing load on + * the origin server.FORCE_CACHE_ALL Cache all content, ignoring any "private", + * "no-store" or "no-cache" directives in Cache-Control response headers. + * Warning: this may result in Cloud CDN caching private, + * per-user (user identifiable) content.CACHE_ALL_STATIC Automatically cache static content, + * including common image formats, media (video and audio), and web assets + * (JavaScript and CSS). Requests and responses that are marked as + * uncacheable, as well as dynamic content (including HTML), will not be + * cached. + * If no value is provided for cdnPolicy.cacheMode, it defaults + * to CACHE_ALL_STATIC. * Check the CacheMode enum for the list of possible values. * * Generated from protobuf field optional string cache_mode = 28877888; @@ -228,7 +428,16 @@ public function setCacheMode($var) } /** - * Specifies a separate client (e.g. browser client) maximum TTL. This is used to clamp the max-age (or Expires) value sent to the client. With FORCE_CACHE_ALL, the lesser of client_ttl and default_ttl is used for the response max-age directive, along with a "public" directive. For cacheable content in CACHE_ALL_STATIC mode, client_ttl clamps the max-age from the origin (if specified), or else sets the response max-age directive to the lesser of the client_ttl and default_ttl, and also ensures a "public" cache-control directive is present. If a client TTL is not specified, a default value (1 hour) will be used. The maximum allowed value is 31,622,400s (1 year). + * Specifies a separate client (e.g. browser client) maximum TTL. This is + * used to clamp the max-age (or Expires) value sent to the client. With + * FORCE_CACHE_ALL, the lesser of client_ttl and default_ttl is used for the + * response max-age directive, along with a "public" directive. For + * cacheable content in CACHE_ALL_STATIC mode, client_ttl clamps the max-age + * from the origin (if specified), or else sets the response max-age + * directive to the lesser of the client_ttl and default_ttl, and also + * ensures a "public" cache-control directive is present. + * If a client TTL is not specified, a default value (1 hour) will be used. + * The maximum allowed value is 31,622,400s (1 year). * * Generated from protobuf field optional int32 client_ttl = 29034360; * @return int @@ -249,7 +458,16 @@ public function clearClientTtl() } /** - * Specifies a separate client (e.g. browser client) maximum TTL. This is used to clamp the max-age (or Expires) value sent to the client. With FORCE_CACHE_ALL, the lesser of client_ttl and default_ttl is used for the response max-age directive, along with a "public" directive. For cacheable content in CACHE_ALL_STATIC mode, client_ttl clamps the max-age from the origin (if specified), or else sets the response max-age directive to the lesser of the client_ttl and default_ttl, and also ensures a "public" cache-control directive is present. If a client TTL is not specified, a default value (1 hour) will be used. The maximum allowed value is 31,622,400s (1 year). + * Specifies a separate client (e.g. browser client) maximum TTL. This is + * used to clamp the max-age (or Expires) value sent to the client. With + * FORCE_CACHE_ALL, the lesser of client_ttl and default_ttl is used for the + * response max-age directive, along with a "public" directive. For + * cacheable content in CACHE_ALL_STATIC mode, client_ttl clamps the max-age + * from the origin (if specified), or else sets the response max-age + * directive to the lesser of the client_ttl and default_ttl, and also + * ensures a "public" cache-control directive is present. + * If a client TTL is not specified, a default value (1 hour) will be used. + * The maximum allowed value is 31,622,400s (1 year). * * Generated from protobuf field optional int32 client_ttl = 29034360; * @param int $var @@ -264,7 +482,15 @@ public function setClientTtl($var) } /** - * Specifies the default TTL for cached content served by this origin for responses that do not have an existing valid TTL (max-age or s-maxage). Setting a TTL of "0" means "always revalidate". The value of defaultTTL cannot be set to a value greater than that of maxTTL, but can be equal. When the cacheMode is set to FORCE_CACHE_ALL, the defaultTTL will overwrite the TTL set in all responses. The maximum allowed value is 31,622,400s (1 year), noting that infrequently accessed objects may be evicted from the cache before the defined TTL. + * Specifies the default TTL for cached content served by this origin for + * responses that do not have an existing valid TTL (max-age or s-maxage). + * Setting a TTL of "0" means "always revalidate". + * The value of defaultTTL cannot be set to a value greater than that of + * maxTTL, but can be equal. + * When the cacheMode is set to FORCE_CACHE_ALL, the defaultTTL + * will overwrite the TTL set in all responses. The maximum allowed value is + * 31,622,400s (1 year), noting that infrequently accessed objects may be + * evicted from the cache before the defined TTL. * * Generated from protobuf field optional int32 default_ttl = 100253422; * @return int @@ -285,7 +511,15 @@ public function clearDefaultTtl() } /** - * Specifies the default TTL for cached content served by this origin for responses that do not have an existing valid TTL (max-age or s-maxage). Setting a TTL of "0" means "always revalidate". The value of defaultTTL cannot be set to a value greater than that of maxTTL, but can be equal. When the cacheMode is set to FORCE_CACHE_ALL, the defaultTTL will overwrite the TTL set in all responses. The maximum allowed value is 31,622,400s (1 year), noting that infrequently accessed objects may be evicted from the cache before the defined TTL. + * Specifies the default TTL for cached content served by this origin for + * responses that do not have an existing valid TTL (max-age or s-maxage). + * Setting a TTL of "0" means "always revalidate". + * The value of defaultTTL cannot be set to a value greater than that of + * maxTTL, but can be equal. + * When the cacheMode is set to FORCE_CACHE_ALL, the defaultTTL + * will overwrite the TTL set in all responses. The maximum allowed value is + * 31,622,400s (1 year), noting that infrequently accessed objects may be + * evicted from the cache before the defined TTL. * * Generated from protobuf field optional int32 default_ttl = 100253422; * @param int $var @@ -300,7 +534,17 @@ public function setDefaultTtl($var) } /** - * Specifies the maximum allowed TTL for cached content served by this origin. Cache directives that attempt to set a max-age or s-maxage higher than this, or an Expires header more than maxTTL seconds in the future will be capped at the value of maxTTL, as if it were the value of an s-maxage Cache-Control directive. Headers sent to the client will not be modified. Setting a TTL of "0" means "always revalidate". The maximum allowed value is 31,622,400s (1 year), noting that infrequently accessed objects may be evicted from the cache before the defined TTL. + * Specifies the maximum allowed TTL for cached content served by this + * origin. + * Cache directives that attempt to set a max-age or s-maxage higher than + * this, or an Expires header more than maxTTL seconds in the future will + * be capped at the value of maxTTL, as if it were the value of an + * s-maxage Cache-Control directive. + * Headers sent to the client will not be modified. + * Setting a TTL of "0" means "always revalidate". + * The maximum allowed value is 31,622,400s (1 year), noting that + * infrequently accessed objects may be evicted from the cache before + * the defined TTL. * * Generated from protobuf field optional int32 max_ttl = 307578001; * @return int @@ -321,7 +565,17 @@ public function clearMaxTtl() } /** - * Specifies the maximum allowed TTL for cached content served by this origin. Cache directives that attempt to set a max-age or s-maxage higher than this, or an Expires header more than maxTTL seconds in the future will be capped at the value of maxTTL, as if it were the value of an s-maxage Cache-Control directive. Headers sent to the client will not be modified. Setting a TTL of "0" means "always revalidate". The maximum allowed value is 31,622,400s (1 year), noting that infrequently accessed objects may be evicted from the cache before the defined TTL. + * Specifies the maximum allowed TTL for cached content served by this + * origin. + * Cache directives that attempt to set a max-age or s-maxage higher than + * this, or an Expires header more than maxTTL seconds in the future will + * be capped at the value of maxTTL, as if it were the value of an + * s-maxage Cache-Control directive. + * Headers sent to the client will not be modified. + * Setting a TTL of "0" means "always revalidate". + * The maximum allowed value is 31,622,400s (1 year), noting that + * infrequently accessed objects may be evicted from the cache before + * the defined TTL. * * Generated from protobuf field optional int32 max_ttl = 307578001; * @param int $var @@ -336,7 +590,23 @@ public function setMaxTtl($var) } /** - * Negative caching allows per-status code TTLs to be set, in order to apply fine-grained caching for common errors or redirects. This can reduce the load on your origin and improve end-user experience by reducing response latency. When the cache mode is set to CACHE_ALL_STATIC or USE_ORIGIN_HEADERS, negative caching applies to responses with the specified response code that lack any Cache-Control, Expires, or Pragma: no-cache directives. When the cache mode is set to FORCE_CACHE_ALL, negative caching applies to all responses with the specified response code, and override any caching headers. By default, Cloud CDN will apply the following default TTLs to these status codes: HTTP 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m HTTP 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s HTTP 405 (Method Not Found), 501 (Not Implemented): 60s. These defaults can be overridden in negative_caching_policy. + * Negative caching allows per-status code TTLs to be set, in order + * to apply fine-grained caching for common errors or redirects. + * This can reduce the load on your origin and improve end-user + * experience by reducing response latency. + * When the cache mode is set to CACHE_ALL_STATIC or USE_ORIGIN_HEADERS, + * negative caching applies to responses with the specified response code + * that lack any Cache-Control, Expires, or Pragma: no-cache directives. + * When the cache mode is set to FORCE_CACHE_ALL, negative caching applies + * to all responses with the specified response code, and override any + * caching headers. + * By default, Cloud CDN will apply the following default TTLs to these + * status codes: + * HTTP 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m + * HTTP 404 (Not Found), 410 (Gone), + * 451 (Unavailable For Legal Reasons): 120s + * HTTP 405 (Method Not Found), 501 (Not Implemented): 60s. + * These defaults can be overridden in negative_caching_policy. * * Generated from protobuf field optional bool negative_caching = 336110005; * @return bool @@ -357,7 +627,23 @@ public function clearNegativeCaching() } /** - * Negative caching allows per-status code TTLs to be set, in order to apply fine-grained caching for common errors or redirects. This can reduce the load on your origin and improve end-user experience by reducing response latency. When the cache mode is set to CACHE_ALL_STATIC or USE_ORIGIN_HEADERS, negative caching applies to responses with the specified response code that lack any Cache-Control, Expires, or Pragma: no-cache directives. When the cache mode is set to FORCE_CACHE_ALL, negative caching applies to all responses with the specified response code, and override any caching headers. By default, Cloud CDN will apply the following default TTLs to these status codes: HTTP 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m HTTP 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s HTTP 405 (Method Not Found), 501 (Not Implemented): 60s. These defaults can be overridden in negative_caching_policy. + * Negative caching allows per-status code TTLs to be set, in order + * to apply fine-grained caching for common errors or redirects. + * This can reduce the load on your origin and improve end-user + * experience by reducing response latency. + * When the cache mode is set to CACHE_ALL_STATIC or USE_ORIGIN_HEADERS, + * negative caching applies to responses with the specified response code + * that lack any Cache-Control, Expires, or Pragma: no-cache directives. + * When the cache mode is set to FORCE_CACHE_ALL, negative caching applies + * to all responses with the specified response code, and override any + * caching headers. + * By default, Cloud CDN will apply the following default TTLs to these + * status codes: + * HTTP 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m + * HTTP 404 (Not Found), 410 (Gone), + * 451 (Unavailable For Legal Reasons): 120s + * HTTP 405 (Method Not Found), 501 (Not Implemented): 60s. + * These defaults can be overridden in negative_caching_policy. * * Generated from protobuf field optional bool negative_caching = 336110005; * @param bool $var @@ -372,7 +658,14 @@ public function setNegativeCaching($var) } /** - * Sets a cache TTL for the specified HTTP status code. negative_caching must be enabled to configure negative_caching_policy. Omitting the policy and leaving negative_caching enabled will use Cloud CDN's default cache TTLs. Note that when specifying an explicit negative_caching_policy, you should take care to specify a cache TTL for all response codes that you wish to cache. Cloud CDN will not apply any default negative caching when a policy exists. + * Sets a cache TTL for the specified HTTP status code. + * negative_caching must be enabled to configure negative_caching_policy. + * Omitting the policy and leaving negative_caching enabled will use + * Cloud CDN's default cache TTLs. + * Note that when specifying an explicit negative_caching_policy, you + * should take care to specify a cache TTL for all response codes + * that you wish to cache. Cloud CDN will not apply any default + * negative caching when a policy exists. * * Generated from protobuf field repeated .google.cloud.compute.v1.BackendServiceCdnPolicyNegativeCachingPolicy negative_caching_policy = 155359996; * @return \Google\Protobuf\Internal\RepeatedField @@ -383,7 +676,14 @@ public function getNegativeCachingPolicy() } /** - * Sets a cache TTL for the specified HTTP status code. negative_caching must be enabled to configure negative_caching_policy. Omitting the policy and leaving negative_caching enabled will use Cloud CDN's default cache TTLs. Note that when specifying an explicit negative_caching_policy, you should take care to specify a cache TTL for all response codes that you wish to cache. Cloud CDN will not apply any default negative caching when a policy exists. + * Sets a cache TTL for the specified HTTP status code. + * negative_caching must be enabled to configure negative_caching_policy. + * Omitting the policy and leaving negative_caching enabled will use + * Cloud CDN's default cache TTLs. + * Note that when specifying an explicit negative_caching_policy, you + * should take care to specify a cache TTL for all response codes + * that you wish to cache. Cloud CDN will not apply any default + * negative caching when a policy exists. * * Generated from protobuf field repeated .google.cloud.compute.v1.BackendServiceCdnPolicyNegativeCachingPolicy negative_caching_policy = 155359996; * @param array<\Google\Cloud\Compute\V1\BackendServiceCdnPolicyNegativeCachingPolicy>|\Google\Protobuf\Internal\RepeatedField $var @@ -398,7 +698,8 @@ public function setNegativeCachingPolicy($var) } /** - * If true then Cloud CDN will combine multiple concurrent cache fill requests into a small number of requests to the origin. + * If true then Cloud CDN will combine multiple concurrent cache fill + * requests into a small number of requests to the origin. * * Generated from protobuf field optional bool request_coalescing = 532808276; * @return bool @@ -419,7 +720,8 @@ public function clearRequestCoalescing() } /** - * If true then Cloud CDN will combine multiple concurrent cache fill requests into a small number of requests to the origin. + * If true then Cloud CDN will combine multiple concurrent cache fill + * requests into a small number of requests to the origin. * * Generated from protobuf field optional bool request_coalescing = 532808276; * @param bool $var @@ -434,7 +736,17 @@ public function setRequestCoalescing($var) } /** - * Serve existing content from the cache (if available) when revalidating content with the origin, or when an error is encountered when refreshing the cache. This setting defines the default "max-stale" duration for any cached responses that do not specify a max-stale directive. Stale responses that exceed the TTL configured here will not be served. The default limit (max-stale) is 86400s (1 day), which will allow stale content to be served up to this limit beyond the max-age (or s-maxage) of a cached response. The maximum allowed value is 604800 (1 week). Set this to zero (0) to disable serve-while-stale. + * Serve existing content from the cache (if available) when revalidating + * content with the origin, or when an error is encountered when refreshing + * the cache. + * This setting defines the default "max-stale" duration for any cached + * responses that do not specify a max-stale directive. Stale responses that + * exceed the TTL configured here will not be served. The default limit + * (max-stale) is 86400s (1 day), which will allow stale content to be + * served up to this limit beyond the max-age (or s-maxage) of a cached + * response. + * The maximum allowed value is 604800 (1 week). + * Set this to zero (0) to disable serve-while-stale. * * Generated from protobuf field optional int32 serve_while_stale = 236682203; * @return int @@ -455,7 +767,17 @@ public function clearServeWhileStale() } /** - * Serve existing content from the cache (if available) when revalidating content with the origin, or when an error is encountered when refreshing the cache. This setting defines the default "max-stale" duration for any cached responses that do not specify a max-stale directive. Stale responses that exceed the TTL configured here will not be served. The default limit (max-stale) is 86400s (1 day), which will allow stale content to be served up to this limit beyond the max-age (or s-maxage) of a cached response. The maximum allowed value is 604800 (1 week). Set this to zero (0) to disable serve-while-stale. + * Serve existing content from the cache (if available) when revalidating + * content with the origin, or when an error is encountered when refreshing + * the cache. + * This setting defines the default "max-stale" duration for any cached + * responses that do not specify a max-stale directive. Stale responses that + * exceed the TTL configured here will not be served. The default limit + * (max-stale) is 86400s (1 day), which will allow stale content to be + * served up to this limit beyond the max-age (or s-maxage) of a cached + * response. + * The maximum allowed value is 604800 (1 week). + * Set this to zero (0) to disable serve-while-stale. * * Generated from protobuf field optional int32 serve_while_stale = 236682203; * @param int $var @@ -470,7 +792,14 @@ public function setServeWhileStale($var) } /** - * Maximum number of seconds the response to a signed URL request will be considered fresh. After this time period, the response will be revalidated before being served. Defaults to 1hr (3600s). When serving responses to signed URL requests, Cloud CDN will internally behave as though all responses from this backend had a "Cache-Control: public, max-age=[TTL]" header, regardless of any existing Cache-Control header. The actual headers served in responses will not be altered. + * Maximum number of seconds the response to a signed URL request will be + * considered fresh. After this time period, the response will be + * revalidated before being served. Defaults to 1hr (3600s). When serving + * responses to signed URL requests, Cloud CDN will internally behave as + * though all responses from this backend had a "Cache-Control: + * public, max-age=[TTL]" header, regardless of any existing + * Cache-Control header. The actual headers served in responses will not be + * altered. * * Generated from protobuf field optional int64 signed_url_cache_max_age_sec = 269374534; * @return int|string @@ -491,7 +820,14 @@ public function clearSignedUrlCacheMaxAgeSec() } /** - * Maximum number of seconds the response to a signed URL request will be considered fresh. After this time period, the response will be revalidated before being served. Defaults to 1hr (3600s). When serving responses to signed URL requests, Cloud CDN will internally behave as though all responses from this backend had a "Cache-Control: public, max-age=[TTL]" header, regardless of any existing Cache-Control header. The actual headers served in responses will not be altered. + * Maximum number of seconds the response to a signed URL request will be + * considered fresh. After this time period, the response will be + * revalidated before being served. Defaults to 1hr (3600s). When serving + * responses to signed URL requests, Cloud CDN will internally behave as + * though all responses from this backend had a "Cache-Control: + * public, max-age=[TTL]" header, regardless of any existing + * Cache-Control header. The actual headers served in responses will not be + * altered. * * Generated from protobuf field optional int64 signed_url_cache_max_age_sec = 269374534; * @param int|string $var diff --git a/Compute/src/V1/BackendServiceCdnPolicy/CacheMode.php b/Compute/src/V1/BackendServiceCdnPolicy/CacheMode.php index bad2e84f89bf..21a02fb07fff 100644 --- a/Compute/src/V1/BackendServiceCdnPolicy/CacheMode.php +++ b/Compute/src/V1/BackendServiceCdnPolicy/CacheMode.php @@ -7,7 +7,21 @@ use UnexpectedValueException; /** - * Specifies the cache setting for all responses from this backend. The possible values are: USE_ORIGIN_HEADERS Requires the origin to set valid caching headers to cache content. Responses without these headers will not be cached at Google's edge, and will require a full trip to the origin on every request, potentially impacting performance and increasing load on the origin server. FORCE_CACHE_ALL Cache all content, ignoring any "private", "no-store" or "no-cache" directives in Cache-Control response headers. Warning: this may result in Cloud CDN caching private, per-user (user identifiable) content. CACHE_ALL_STATIC Automatically cache static content, including common image formats, media (video and audio), and web assets (JavaScript and CSS). Requests and responses that are marked as uncacheable, as well as dynamic content (including HTML), will not be cached. If no value is provided for cdnPolicy.cacheMode, it defaults to CACHE_ALL_STATIC. + * Specifies the cache setting for all responses from this backend. + * The possible values are:USE_ORIGIN_HEADERS Requires the origin to set valid caching + * headers to cache content. Responses without these headers will not be + * cached at Google's edge, and will require a full trip to the origin on + * every request, potentially impacting performance and increasing load on + * the origin server.FORCE_CACHE_ALL Cache all content, ignoring any "private", + * "no-store" or "no-cache" directives in Cache-Control response headers. + * Warning: this may result in Cloud CDN caching private, + * per-user (user identifiable) content.CACHE_ALL_STATIC Automatically cache static content, + * including common image formats, media (video and audio), and web assets + * (JavaScript and CSS). Requests and responses that are marked as + * uncacheable, as well as dynamic content (including HTML), will not be + * cached. + * If no value is provided for cdnPolicy.cacheMode, it defaults + * to CACHE_ALL_STATIC. * * Protobuf type google.cloud.compute.v1.BackendServiceCdnPolicy.CacheMode */ @@ -20,13 +34,19 @@ class CacheMode */ const UNDEFINED_CACHE_MODE = 0; /** - * Automatically cache static content, including common image formats, media (video and audio), and web assets (JavaScript and CSS). Requests and responses that are marked as uncacheable, as well as dynamic content (including HTML), will not be cached. + * Automatically cache static content, including common image formats, + * media (video and audio), and web assets (JavaScript and CSS). + * Requests and responses that are marked as uncacheable, as well as + * dynamic content (including HTML), will not be cached. * * Generated from protobuf enum CACHE_ALL_STATIC = 355027945; */ const CACHE_ALL_STATIC = 355027945; /** - * Cache all content, ignoring any "private", "no-store" or "no-cache" directives in Cache-Control response headers. Warning: this may result in Cloud CDN caching private, per-user (user identifiable) content. + * Cache all content, ignoring any "private", "no-store" or "no-cache" + * directives in Cache-Control response headers. + * Warning: this may result in Cloud CDN caching private, + * per-user (user identifiable) content. * * Generated from protobuf enum FORCE_CACHE_ALL = 486026928; */ @@ -36,7 +56,11 @@ class CacheMode */ const INVALID_CACHE_MODE = 381295560; /** - * Requires the origin to set valid caching headers to cache content. Responses without these headers will not be cached at Google's edge, and will require a full trip to the origin on every request, potentially impacting performance and increasing load on the origin server. + * Requires the origin to set valid caching headers to cache content. + * Responses without these headers will not be cached at Google's edge, + * and will require a full trip to the origin on every request, + * potentially impacting performance and increasing load on the + * origin server. * * Generated from protobuf enum USE_ORIGIN_HEADERS = 55380261; */ diff --git a/Compute/src/V1/BackendServiceCdnPolicyBypassCacheOnRequestHeader.php b/Compute/src/V1/BackendServiceCdnPolicyBypassCacheOnRequestHeader.php index c47444b2c2b3..4b6536d3609b 100644 --- a/Compute/src/V1/BackendServiceCdnPolicyBypassCacheOnRequestHeader.php +++ b/Compute/src/V1/BackendServiceCdnPolicyBypassCacheOnRequestHeader.php @@ -9,14 +9,17 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Bypass the cache when the specified request headers are present, e.g. Pragma or Authorization headers. Values are case insensitive. The presence of such a header overrides the cache_mode setting. + * Bypass the cache when the specified request headers are present, + * e.g. Pragma or Authorization headers. Values are case insensitive. + * The presence of such a header overrides the cache_mode setting. * * Generated from protobuf message google.cloud.compute.v1.BackendServiceCdnPolicyBypassCacheOnRequestHeader */ class BackendServiceCdnPolicyBypassCacheOnRequestHeader extends \Google\Protobuf\Internal\Message { /** - * The header field name to match on when bypassing cache. Values are case-insensitive. + * The header field name to match on when bypassing cache. + * Values are case-insensitive. * * Generated from protobuf field optional string header_name = 110223613; */ @@ -29,7 +32,8 @@ class BackendServiceCdnPolicyBypassCacheOnRequestHeader extends \Google\Protobuf * Optional. Data for populating the Message object. * * @type string $header_name - * The header field name to match on when bypassing cache. Values are case-insensitive. + * The header field name to match on when bypassing cache. + * Values are case-insensitive. * } */ public function __construct($data = NULL) { @@ -38,7 +42,8 @@ public function __construct($data = NULL) { } /** - * The header field name to match on when bypassing cache. Values are case-insensitive. + * The header field name to match on when bypassing cache. + * Values are case-insensitive. * * Generated from protobuf field optional string header_name = 110223613; * @return string @@ -59,7 +64,8 @@ public function clearHeaderName() } /** - * The header field name to match on when bypassing cache. Values are case-insensitive. + * The header field name to match on when bypassing cache. + * Values are case-insensitive. * * Generated from protobuf field optional string header_name = 110223613; * @param string $var diff --git a/Compute/src/V1/BackendServiceCdnPolicyNegativeCachingPolicy.php b/Compute/src/V1/BackendServiceCdnPolicyNegativeCachingPolicy.php index 9a336afe5a4e..f27fe18aa09d 100644 --- a/Compute/src/V1/BackendServiceCdnPolicyNegativeCachingPolicy.php +++ b/Compute/src/V1/BackendServiceCdnPolicyNegativeCachingPolicy.php @@ -16,13 +16,20 @@ class BackendServiceCdnPolicyNegativeCachingPolicy extends \Google\Protobuf\Internal\Message { /** - * The HTTP status code to define a TTL against. Only HTTP status codes 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 are can be specified as values, and you cannot specify a status code more than once. + * The HTTP status code to define a TTL against. Only HTTP status codes + * 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be + * specified as values, and you cannot specify a status code more than + * once. * * Generated from protobuf field optional int32 code = 3059181; */ protected $code = null; /** - * The TTL (in seconds) for which to cache responses with the corresponding status code. The maximum allowed value is 1800s (30 minutes), noting that infrequently accessed objects may be evicted from the cache before the defined TTL. + * The TTL (in seconds) for which to cache responses with the + * corresponding status code. + * The maximum allowed value is 1800s (30 minutes), noting that + * infrequently accessed objects may be evicted from the cache before the + * defined TTL. * * Generated from protobuf field optional int32 ttl = 115180; */ @@ -35,9 +42,16 @@ class BackendServiceCdnPolicyNegativeCachingPolicy extends \Google\Protobuf\Inte * Optional. Data for populating the Message object. * * @type int $code - * The HTTP status code to define a TTL against. Only HTTP status codes 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 are can be specified as values, and you cannot specify a status code more than once. + * The HTTP status code to define a TTL against. Only HTTP status codes + * 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be + * specified as values, and you cannot specify a status code more than + * once. * @type int $ttl - * The TTL (in seconds) for which to cache responses with the corresponding status code. The maximum allowed value is 1800s (30 minutes), noting that infrequently accessed objects may be evicted from the cache before the defined TTL. + * The TTL (in seconds) for which to cache responses with the + * corresponding status code. + * The maximum allowed value is 1800s (30 minutes), noting that + * infrequently accessed objects may be evicted from the cache before the + * defined TTL. * } */ public function __construct($data = NULL) { @@ -46,7 +60,10 @@ public function __construct($data = NULL) { } /** - * The HTTP status code to define a TTL against. Only HTTP status codes 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 are can be specified as values, and you cannot specify a status code more than once. + * The HTTP status code to define a TTL against. Only HTTP status codes + * 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be + * specified as values, and you cannot specify a status code more than + * once. * * Generated from protobuf field optional int32 code = 3059181; * @return int @@ -67,7 +84,10 @@ public function clearCode() } /** - * The HTTP status code to define a TTL against. Only HTTP status codes 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 are can be specified as values, and you cannot specify a status code more than once. + * The HTTP status code to define a TTL against. Only HTTP status codes + * 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be + * specified as values, and you cannot specify a status code more than + * once. * * Generated from protobuf field optional int32 code = 3059181; * @param int $var @@ -82,7 +102,11 @@ public function setCode($var) } /** - * The TTL (in seconds) for which to cache responses with the corresponding status code. The maximum allowed value is 1800s (30 minutes), noting that infrequently accessed objects may be evicted from the cache before the defined TTL. + * The TTL (in seconds) for which to cache responses with the + * corresponding status code. + * The maximum allowed value is 1800s (30 minutes), noting that + * infrequently accessed objects may be evicted from the cache before the + * defined TTL. * * Generated from protobuf field optional int32 ttl = 115180; * @return int @@ -103,7 +127,11 @@ public function clearTtl() } /** - * The TTL (in seconds) for which to cache responses with the corresponding status code. The maximum allowed value is 1800s (30 minutes), noting that infrequently accessed objects may be evicted from the cache before the defined TTL. + * The TTL (in seconds) for which to cache responses with the + * corresponding status code. + * The maximum allowed value is 1800s (30 minutes), noting that + * infrequently accessed objects may be evicted from the cache before the + * defined TTL. * * Generated from protobuf field optional int32 ttl = 115180; * @param int $var diff --git a/Compute/src/V1/BackendServiceConnectionTrackingPolicy.php b/Compute/src/V1/BackendServiceConnectionTrackingPolicy.php index 2512102d7135..8cf259ca6a12 100644 --- a/Compute/src/V1/BackendServiceConnectionTrackingPolicy.php +++ b/Compute/src/V1/BackendServiceConnectionTrackingPolicy.php @@ -16,26 +16,63 @@ class BackendServiceConnectionTrackingPolicy extends \Google\Protobuf\Internal\Message { /** - * Specifies connection persistence when backends are unhealthy. The default value is DEFAULT_FOR_PROTOCOL. If set to DEFAULT_FOR_PROTOCOL, the existing connections persist on unhealthy backends only for connection-oriented protocols (TCP and SCTP) and only if the Tracking Mode is PER_CONNECTION (default tracking mode) or the Session Affinity is configured for 5-tuple. They do not persist for UDP. If set to NEVER_PERSIST, after a backend becomes unhealthy, the existing connections on the unhealthy backend are never persisted on the unhealthy backend. They are always diverted to newly selected healthy backends (unless all backends are unhealthy). If set to ALWAYS_PERSIST, existing connections always persist on unhealthy backends regardless of protocol and session affinity. It is generally not recommended to use this mode overriding the default. For more details, see [Connection Persistence for Network Load Balancing](https://cloud.google.com/load-balancing/docs/network/networklb-backend-service#connection-persistence) and [Connection Persistence for Internal TCP/UDP Load Balancing](https://cloud.google.com/load-balancing/docs/internal#connection-persistence). + * Specifies connection persistence when backends are unhealthy. The default + * value is DEFAULT_FOR_PROTOCOL. + * If set to DEFAULT_FOR_PROTOCOL, the existing connections + * persist on unhealthy backends only for connection-oriented protocols + * (TCP and SCTP) and only if the Tracking Mode isPER_CONNECTION (default tracking mode) or the Session + * Affinity is configured for 5-tuple. They do not persist forUDP. + * If set to NEVER_PERSIST, after a backend becomes unhealthy, + * the existing connections on the unhealthy backend are never persisted on + * the unhealthy backend. They are always diverted to newly selected healthy + * backends (unless all backends are unhealthy). + * If set to ALWAYS_PERSIST, existing connections always + * persist on unhealthy backends regardless of protocol and session + * affinity. It is generally not recommended to use this mode overriding the + * default. + * For more details, see [Connection Persistence for Network Load + * Balancing](https://cloud.google.com/load-balancing/docs/network/networklb-backend-service#connection-persistence) + * and [Connection Persistence for Internal TCP/UDP Load + * Balancing](https://cloud.google.com/load-balancing/docs/internal#connection-persistence). * Check the ConnectionPersistenceOnUnhealthyBackends enum for the list of possible values. * * Generated from protobuf field optional string connection_persistence_on_unhealthy_backends = 152439033; */ protected $connection_persistence_on_unhealthy_backends = null; /** - * Enable Strong Session Affinity for external passthrough Network Load Balancers. This option is not available publicly. + * Enable Strong Session Affinity for external passthrough Network Load + * Balancers. This option is not available publicly. * * Generated from protobuf field optional bool enable_strong_affinity = 24539924; */ protected $enable_strong_affinity = null; /** - * Specifies how long to keep a Connection Tracking entry while there is no matching traffic (in seconds). For internal passthrough Network Load Balancers: - The minimum (default) is 10 minutes and the maximum is 16 hours. - It can be set only if Connection Tracking is less than 5-tuple (i.e. Session Affinity is CLIENT_IP_NO_DESTINATION, CLIENT_IP or CLIENT_IP_PROTO, and Tracking Mode is PER_SESSION). For external passthrough Network Load Balancers the default is 60 seconds. This option is not available publicly. + * Specifies how long to keep a Connection Tracking entry while there is no + * matching traffic (in seconds). + * For internal passthrough Network Load Balancers: + * - The minimum (default) is 10 minutes and the maximum is 16 hours. + * - It can be set only if Connection Tracking is less than 5-tuple + * (i.e. Session Affinity is CLIENT_IP_NO_DESTINATION,CLIENT_IP or CLIENT_IP_PROTO, and Tracking + * Mode is PER_SESSION). + * For external passthrough Network Load Balancers the default is 60 + * seconds. This option is not available publicly. * * Generated from protobuf field optional int32 idle_timeout_sec = 24977544; */ protected $idle_timeout_sec = null; /** - * Specifies the key used for connection tracking. There are two options: - PER_CONNECTION: This is the default mode. The Connection Tracking is performed as per the Connection Key (default Hash Method) for the specific protocol. - PER_SESSION: The Connection Tracking is performed as per the configured Session Affinity. It matches the configured Session Affinity. For more details, see [Tracking Mode for Network Load Balancing](https://cloud.google.com/load-balancing/docs/network/networklb-backend-service#tracking-mode) and [Tracking Mode for Internal TCP/UDP Load Balancing](https://cloud.google.com/load-balancing/docs/internal#tracking-mode). + * Specifies the key used for connection tracking. There are two + * options: + * - PER_CONNECTION: This is the default mode. The Connection + * Tracking is performed as per the Connection Key (default Hash Method) for + * the specific protocol. + * - PER_SESSION: The Connection Tracking is performed as per + * the configured Session Affinity. It matches the configured Session + * Affinity. + * For more details, see [Tracking Mode for Network Load + * Balancing](https://cloud.google.com/load-balancing/docs/network/networklb-backend-service#tracking-mode) + * and [Tracking Mode for Internal TCP/UDP Load + * Balancing](https://cloud.google.com/load-balancing/docs/internal#tracking-mode). * Check the TrackingMode enum for the list of possible values. * * Generated from protobuf field optional string tracking_mode = 127757867; @@ -49,14 +86,51 @@ class BackendServiceConnectionTrackingPolicy extends \Google\Protobuf\Internal\M * Optional. Data for populating the Message object. * * @type string $connection_persistence_on_unhealthy_backends - * Specifies connection persistence when backends are unhealthy. The default value is DEFAULT_FOR_PROTOCOL. If set to DEFAULT_FOR_PROTOCOL, the existing connections persist on unhealthy backends only for connection-oriented protocols (TCP and SCTP) and only if the Tracking Mode is PER_CONNECTION (default tracking mode) or the Session Affinity is configured for 5-tuple. They do not persist for UDP. If set to NEVER_PERSIST, after a backend becomes unhealthy, the existing connections on the unhealthy backend are never persisted on the unhealthy backend. They are always diverted to newly selected healthy backends (unless all backends are unhealthy). If set to ALWAYS_PERSIST, existing connections always persist on unhealthy backends regardless of protocol and session affinity. It is generally not recommended to use this mode overriding the default. For more details, see [Connection Persistence for Network Load Balancing](https://cloud.google.com/load-balancing/docs/network/networklb-backend-service#connection-persistence) and [Connection Persistence for Internal TCP/UDP Load Balancing](https://cloud.google.com/load-balancing/docs/internal#connection-persistence). + * Specifies connection persistence when backends are unhealthy. The default + * value is DEFAULT_FOR_PROTOCOL. + * If set to DEFAULT_FOR_PROTOCOL, the existing connections + * persist on unhealthy backends only for connection-oriented protocols + * (TCP and SCTP) and only if the Tracking Mode isPER_CONNECTION (default tracking mode) or the Session + * Affinity is configured for 5-tuple. They do not persist forUDP. + * If set to NEVER_PERSIST, after a backend becomes unhealthy, + * the existing connections on the unhealthy backend are never persisted on + * the unhealthy backend. They are always diverted to newly selected healthy + * backends (unless all backends are unhealthy). + * If set to ALWAYS_PERSIST, existing connections always + * persist on unhealthy backends regardless of protocol and session + * affinity. It is generally not recommended to use this mode overriding the + * default. + * For more details, see [Connection Persistence for Network Load + * Balancing](https://cloud.google.com/load-balancing/docs/network/networklb-backend-service#connection-persistence) + * and [Connection Persistence for Internal TCP/UDP Load + * Balancing](https://cloud.google.com/load-balancing/docs/internal#connection-persistence). * Check the ConnectionPersistenceOnUnhealthyBackends enum for the list of possible values. * @type bool $enable_strong_affinity - * Enable Strong Session Affinity for external passthrough Network Load Balancers. This option is not available publicly. + * Enable Strong Session Affinity for external passthrough Network Load + * Balancers. This option is not available publicly. * @type int $idle_timeout_sec - * Specifies how long to keep a Connection Tracking entry while there is no matching traffic (in seconds). For internal passthrough Network Load Balancers: - The minimum (default) is 10 minutes and the maximum is 16 hours. - It can be set only if Connection Tracking is less than 5-tuple (i.e. Session Affinity is CLIENT_IP_NO_DESTINATION, CLIENT_IP or CLIENT_IP_PROTO, and Tracking Mode is PER_SESSION). For external passthrough Network Load Balancers the default is 60 seconds. This option is not available publicly. + * Specifies how long to keep a Connection Tracking entry while there is no + * matching traffic (in seconds). + * For internal passthrough Network Load Balancers: + * - The minimum (default) is 10 minutes and the maximum is 16 hours. + * - It can be set only if Connection Tracking is less than 5-tuple + * (i.e. Session Affinity is CLIENT_IP_NO_DESTINATION,CLIENT_IP or CLIENT_IP_PROTO, and Tracking + * Mode is PER_SESSION). + * For external passthrough Network Load Balancers the default is 60 + * seconds. This option is not available publicly. * @type string $tracking_mode - * Specifies the key used for connection tracking. There are two options: - PER_CONNECTION: This is the default mode. The Connection Tracking is performed as per the Connection Key (default Hash Method) for the specific protocol. - PER_SESSION: The Connection Tracking is performed as per the configured Session Affinity. It matches the configured Session Affinity. For more details, see [Tracking Mode for Network Load Balancing](https://cloud.google.com/load-balancing/docs/network/networklb-backend-service#tracking-mode) and [Tracking Mode for Internal TCP/UDP Load Balancing](https://cloud.google.com/load-balancing/docs/internal#tracking-mode). + * Specifies the key used for connection tracking. There are two + * options: + * - PER_CONNECTION: This is the default mode. The Connection + * Tracking is performed as per the Connection Key (default Hash Method) for + * the specific protocol. + * - PER_SESSION: The Connection Tracking is performed as per + * the configured Session Affinity. It matches the configured Session + * Affinity. + * For more details, see [Tracking Mode for Network Load + * Balancing](https://cloud.google.com/load-balancing/docs/network/networklb-backend-service#tracking-mode) + * and [Tracking Mode for Internal TCP/UDP Load + * Balancing](https://cloud.google.com/load-balancing/docs/internal#tracking-mode). * Check the TrackingMode enum for the list of possible values. * } */ @@ -66,7 +140,24 @@ public function __construct($data = NULL) { } /** - * Specifies connection persistence when backends are unhealthy. The default value is DEFAULT_FOR_PROTOCOL. If set to DEFAULT_FOR_PROTOCOL, the existing connections persist on unhealthy backends only for connection-oriented protocols (TCP and SCTP) and only if the Tracking Mode is PER_CONNECTION (default tracking mode) or the Session Affinity is configured for 5-tuple. They do not persist for UDP. If set to NEVER_PERSIST, after a backend becomes unhealthy, the existing connections on the unhealthy backend are never persisted on the unhealthy backend. They are always diverted to newly selected healthy backends (unless all backends are unhealthy). If set to ALWAYS_PERSIST, existing connections always persist on unhealthy backends regardless of protocol and session affinity. It is generally not recommended to use this mode overriding the default. For more details, see [Connection Persistence for Network Load Balancing](https://cloud.google.com/load-balancing/docs/network/networklb-backend-service#connection-persistence) and [Connection Persistence for Internal TCP/UDP Load Balancing](https://cloud.google.com/load-balancing/docs/internal#connection-persistence). + * Specifies connection persistence when backends are unhealthy. The default + * value is DEFAULT_FOR_PROTOCOL. + * If set to DEFAULT_FOR_PROTOCOL, the existing connections + * persist on unhealthy backends only for connection-oriented protocols + * (TCP and SCTP) and only if the Tracking Mode isPER_CONNECTION (default tracking mode) or the Session + * Affinity is configured for 5-tuple. They do not persist forUDP. + * If set to NEVER_PERSIST, after a backend becomes unhealthy, + * the existing connections on the unhealthy backend are never persisted on + * the unhealthy backend. They are always diverted to newly selected healthy + * backends (unless all backends are unhealthy). + * If set to ALWAYS_PERSIST, existing connections always + * persist on unhealthy backends regardless of protocol and session + * affinity. It is generally not recommended to use this mode overriding the + * default. + * For more details, see [Connection Persistence for Network Load + * Balancing](https://cloud.google.com/load-balancing/docs/network/networklb-backend-service#connection-persistence) + * and [Connection Persistence for Internal TCP/UDP Load + * Balancing](https://cloud.google.com/load-balancing/docs/internal#connection-persistence). * Check the ConnectionPersistenceOnUnhealthyBackends enum for the list of possible values. * * Generated from protobuf field optional string connection_persistence_on_unhealthy_backends = 152439033; @@ -88,7 +179,24 @@ public function clearConnectionPersistenceOnUnhealthyBackends() } /** - * Specifies connection persistence when backends are unhealthy. The default value is DEFAULT_FOR_PROTOCOL. If set to DEFAULT_FOR_PROTOCOL, the existing connections persist on unhealthy backends only for connection-oriented protocols (TCP and SCTP) and only if the Tracking Mode is PER_CONNECTION (default tracking mode) or the Session Affinity is configured for 5-tuple. They do not persist for UDP. If set to NEVER_PERSIST, after a backend becomes unhealthy, the existing connections on the unhealthy backend are never persisted on the unhealthy backend. They are always diverted to newly selected healthy backends (unless all backends are unhealthy). If set to ALWAYS_PERSIST, existing connections always persist on unhealthy backends regardless of protocol and session affinity. It is generally not recommended to use this mode overriding the default. For more details, see [Connection Persistence for Network Load Balancing](https://cloud.google.com/load-balancing/docs/network/networklb-backend-service#connection-persistence) and [Connection Persistence for Internal TCP/UDP Load Balancing](https://cloud.google.com/load-balancing/docs/internal#connection-persistence). + * Specifies connection persistence when backends are unhealthy. The default + * value is DEFAULT_FOR_PROTOCOL. + * If set to DEFAULT_FOR_PROTOCOL, the existing connections + * persist on unhealthy backends only for connection-oriented protocols + * (TCP and SCTP) and only if the Tracking Mode isPER_CONNECTION (default tracking mode) or the Session + * Affinity is configured for 5-tuple. They do not persist forUDP. + * If set to NEVER_PERSIST, after a backend becomes unhealthy, + * the existing connections on the unhealthy backend are never persisted on + * the unhealthy backend. They are always diverted to newly selected healthy + * backends (unless all backends are unhealthy). + * If set to ALWAYS_PERSIST, existing connections always + * persist on unhealthy backends regardless of protocol and session + * affinity. It is generally not recommended to use this mode overriding the + * default. + * For more details, see [Connection Persistence for Network Load + * Balancing](https://cloud.google.com/load-balancing/docs/network/networklb-backend-service#connection-persistence) + * and [Connection Persistence for Internal TCP/UDP Load + * Balancing](https://cloud.google.com/load-balancing/docs/internal#connection-persistence). * Check the ConnectionPersistenceOnUnhealthyBackends enum for the list of possible values. * * Generated from protobuf field optional string connection_persistence_on_unhealthy_backends = 152439033; @@ -104,7 +212,8 @@ public function setConnectionPersistenceOnUnhealthyBackends($var) } /** - * Enable Strong Session Affinity for external passthrough Network Load Balancers. This option is not available publicly. + * Enable Strong Session Affinity for external passthrough Network Load + * Balancers. This option is not available publicly. * * Generated from protobuf field optional bool enable_strong_affinity = 24539924; * @return bool @@ -125,7 +234,8 @@ public function clearEnableStrongAffinity() } /** - * Enable Strong Session Affinity for external passthrough Network Load Balancers. This option is not available publicly. + * Enable Strong Session Affinity for external passthrough Network Load + * Balancers. This option is not available publicly. * * Generated from protobuf field optional bool enable_strong_affinity = 24539924; * @param bool $var @@ -140,7 +250,15 @@ public function setEnableStrongAffinity($var) } /** - * Specifies how long to keep a Connection Tracking entry while there is no matching traffic (in seconds). For internal passthrough Network Load Balancers: - The minimum (default) is 10 minutes and the maximum is 16 hours. - It can be set only if Connection Tracking is less than 5-tuple (i.e. Session Affinity is CLIENT_IP_NO_DESTINATION, CLIENT_IP or CLIENT_IP_PROTO, and Tracking Mode is PER_SESSION). For external passthrough Network Load Balancers the default is 60 seconds. This option is not available publicly. + * Specifies how long to keep a Connection Tracking entry while there is no + * matching traffic (in seconds). + * For internal passthrough Network Load Balancers: + * - The minimum (default) is 10 minutes and the maximum is 16 hours. + * - It can be set only if Connection Tracking is less than 5-tuple + * (i.e. Session Affinity is CLIENT_IP_NO_DESTINATION,CLIENT_IP or CLIENT_IP_PROTO, and Tracking + * Mode is PER_SESSION). + * For external passthrough Network Load Balancers the default is 60 + * seconds. This option is not available publicly. * * Generated from protobuf field optional int32 idle_timeout_sec = 24977544; * @return int @@ -161,7 +279,15 @@ public function clearIdleTimeoutSec() } /** - * Specifies how long to keep a Connection Tracking entry while there is no matching traffic (in seconds). For internal passthrough Network Load Balancers: - The minimum (default) is 10 minutes and the maximum is 16 hours. - It can be set only if Connection Tracking is less than 5-tuple (i.e. Session Affinity is CLIENT_IP_NO_DESTINATION, CLIENT_IP or CLIENT_IP_PROTO, and Tracking Mode is PER_SESSION). For external passthrough Network Load Balancers the default is 60 seconds. This option is not available publicly. + * Specifies how long to keep a Connection Tracking entry while there is no + * matching traffic (in seconds). + * For internal passthrough Network Load Balancers: + * - The minimum (default) is 10 minutes and the maximum is 16 hours. + * - It can be set only if Connection Tracking is less than 5-tuple + * (i.e. Session Affinity is CLIENT_IP_NO_DESTINATION,CLIENT_IP or CLIENT_IP_PROTO, and Tracking + * Mode is PER_SESSION). + * For external passthrough Network Load Balancers the default is 60 + * seconds. This option is not available publicly. * * Generated from protobuf field optional int32 idle_timeout_sec = 24977544; * @param int $var @@ -176,7 +302,18 @@ public function setIdleTimeoutSec($var) } /** - * Specifies the key used for connection tracking. There are two options: - PER_CONNECTION: This is the default mode. The Connection Tracking is performed as per the Connection Key (default Hash Method) for the specific protocol. - PER_SESSION: The Connection Tracking is performed as per the configured Session Affinity. It matches the configured Session Affinity. For more details, see [Tracking Mode for Network Load Balancing](https://cloud.google.com/load-balancing/docs/network/networklb-backend-service#tracking-mode) and [Tracking Mode for Internal TCP/UDP Load Balancing](https://cloud.google.com/load-balancing/docs/internal#tracking-mode). + * Specifies the key used for connection tracking. There are two + * options: + * - PER_CONNECTION: This is the default mode. The Connection + * Tracking is performed as per the Connection Key (default Hash Method) for + * the specific protocol. + * - PER_SESSION: The Connection Tracking is performed as per + * the configured Session Affinity. It matches the configured Session + * Affinity. + * For more details, see [Tracking Mode for Network Load + * Balancing](https://cloud.google.com/load-balancing/docs/network/networklb-backend-service#tracking-mode) + * and [Tracking Mode for Internal TCP/UDP Load + * Balancing](https://cloud.google.com/load-balancing/docs/internal#tracking-mode). * Check the TrackingMode enum for the list of possible values. * * Generated from protobuf field optional string tracking_mode = 127757867; @@ -198,7 +335,18 @@ public function clearTrackingMode() } /** - * Specifies the key used for connection tracking. There are two options: - PER_CONNECTION: This is the default mode. The Connection Tracking is performed as per the Connection Key (default Hash Method) for the specific protocol. - PER_SESSION: The Connection Tracking is performed as per the configured Session Affinity. It matches the configured Session Affinity. For more details, see [Tracking Mode for Network Load Balancing](https://cloud.google.com/load-balancing/docs/network/networklb-backend-service#tracking-mode) and [Tracking Mode for Internal TCP/UDP Load Balancing](https://cloud.google.com/load-balancing/docs/internal#tracking-mode). + * Specifies the key used for connection tracking. There are two + * options: + * - PER_CONNECTION: This is the default mode. The Connection + * Tracking is performed as per the Connection Key (default Hash Method) for + * the specific protocol. + * - PER_SESSION: The Connection Tracking is performed as per + * the configured Session Affinity. It matches the configured Session + * Affinity. + * For more details, see [Tracking Mode for Network Load + * Balancing](https://cloud.google.com/load-balancing/docs/network/networklb-backend-service#tracking-mode) + * and [Tracking Mode for Internal TCP/UDP Load + * Balancing](https://cloud.google.com/load-balancing/docs/internal#tracking-mode). * Check the TrackingMode enum for the list of possible values. * * Generated from protobuf field optional string tracking_mode = 127757867; diff --git a/Compute/src/V1/BackendServiceConnectionTrackingPolicy/ConnectionPersistenceOnUnhealthyBackends.php b/Compute/src/V1/BackendServiceConnectionTrackingPolicy/ConnectionPersistenceOnUnhealthyBackends.php index 5c2cb5876fb1..dda1e0c9287b 100644 --- a/Compute/src/V1/BackendServiceConnectionTrackingPolicy/ConnectionPersistenceOnUnhealthyBackends.php +++ b/Compute/src/V1/BackendServiceConnectionTrackingPolicy/ConnectionPersistenceOnUnhealthyBackends.php @@ -7,7 +7,24 @@ use UnexpectedValueException; /** - * Specifies connection persistence when backends are unhealthy. The default value is DEFAULT_FOR_PROTOCOL. If set to DEFAULT_FOR_PROTOCOL, the existing connections persist on unhealthy backends only for connection-oriented protocols (TCP and SCTP) and only if the Tracking Mode is PER_CONNECTION (default tracking mode) or the Session Affinity is configured for 5-tuple. They do not persist for UDP. If set to NEVER_PERSIST, after a backend becomes unhealthy, the existing connections on the unhealthy backend are never persisted on the unhealthy backend. They are always diverted to newly selected healthy backends (unless all backends are unhealthy). If set to ALWAYS_PERSIST, existing connections always persist on unhealthy backends regardless of protocol and session affinity. It is generally not recommended to use this mode overriding the default. For more details, see [Connection Persistence for Network Load Balancing](https://cloud.google.com/load-balancing/docs/network/networklb-backend-service#connection-persistence) and [Connection Persistence for Internal TCP/UDP Load Balancing](https://cloud.google.com/load-balancing/docs/internal#connection-persistence). + * Specifies connection persistence when backends are unhealthy. The default + * value is DEFAULT_FOR_PROTOCOL. + * If set to DEFAULT_FOR_PROTOCOL, the existing connections + * persist on unhealthy backends only for connection-oriented protocols + * (TCP and SCTP) and only if the Tracking Mode isPER_CONNECTION (default tracking mode) or the Session + * Affinity is configured for 5-tuple. They do not persist forUDP. + * If set to NEVER_PERSIST, after a backend becomes unhealthy, + * the existing connections on the unhealthy backend are never persisted on + * the unhealthy backend. They are always diverted to newly selected healthy + * backends (unless all backends are unhealthy). + * If set to ALWAYS_PERSIST, existing connections always + * persist on unhealthy backends regardless of protocol and session + * affinity. It is generally not recommended to use this mode overriding the + * default. + * For more details, see [Connection Persistence for Network Load + * Balancing](https://cloud.google.com/load-balancing/docs/network/networklb-backend-service#connection-persistence) + * and [Connection Persistence for Internal TCP/UDP Load + * Balancing](https://cloud.google.com/load-balancing/docs/internal#connection-persistence). * * Protobuf type google.cloud.compute.v1.BackendServiceConnectionTrackingPolicy.ConnectionPersistenceOnUnhealthyBackends */ diff --git a/Compute/src/V1/BackendServiceConnectionTrackingPolicy/TrackingMode.php b/Compute/src/V1/BackendServiceConnectionTrackingPolicy/TrackingMode.php index aa859e9d4a14..5e14e67b0398 100644 --- a/Compute/src/V1/BackendServiceConnectionTrackingPolicy/TrackingMode.php +++ b/Compute/src/V1/BackendServiceConnectionTrackingPolicy/TrackingMode.php @@ -7,7 +7,18 @@ use UnexpectedValueException; /** - * Specifies the key used for connection tracking. There are two options: - PER_CONNECTION: This is the default mode. The Connection Tracking is performed as per the Connection Key (default Hash Method) for the specific protocol. - PER_SESSION: The Connection Tracking is performed as per the configured Session Affinity. It matches the configured Session Affinity. For more details, see [Tracking Mode for Network Load Balancing](https://cloud.google.com/load-balancing/docs/network/networklb-backend-service#tracking-mode) and [Tracking Mode for Internal TCP/UDP Load Balancing](https://cloud.google.com/load-balancing/docs/internal#tracking-mode). + * Specifies the key used for connection tracking. There are two + * options: + * - PER_CONNECTION: This is the default mode. The Connection + * Tracking is performed as per the Connection Key (default Hash Method) for + * the specific protocol. + * - PER_SESSION: The Connection Tracking is performed as per + * the configured Session Affinity. It matches the configured Session + * Affinity. + * For more details, see [Tracking Mode for Network Load + * Balancing](https://cloud.google.com/load-balancing/docs/network/networklb-backend-service#tracking-mode) + * and [Tracking Mode for Internal TCP/UDP Load + * Balancing](https://cloud.google.com/load-balancing/docs/internal#tracking-mode). * * Protobuf type google.cloud.compute.v1.BackendServiceConnectionTrackingPolicy.TrackingMode */ diff --git a/Compute/src/V1/BackendServiceCustomMetric.php b/Compute/src/V1/BackendServiceCustomMetric.php index 992623c94e20..eeac6129ae96 100644 --- a/Compute/src/V1/BackendServiceCustomMetric.php +++ b/Compute/src/V1/BackendServiceCustomMetric.php @@ -9,7 +9,8 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Custom Metrics are used for WEIGHTED_ROUND_ROBIN locality_lb_policy. + * Custom Metrics are used for WEIGHTED_ROUND_ROBIN + * locality_lb_policy. * * Generated from protobuf message google.cloud.compute.v1.BackendServiceCustomMetric */ @@ -22,7 +23,15 @@ class BackendServiceCustomMetric extends \Google\Protobuf\Internal\Message */ protected $dry_run = null; /** - * Name of a custom utilization signal. The name must be 1-64 characters long and match the regular expression [a-z]([-_.a-z0-9]*[a-z0-9])? which means that the first character must be a lowercase letter, and all following characters must be a dash, period, underscore, lowercase letter, or digit, except the last character, which cannot be a dash, period, or underscore. For usage guidelines, see Custom Metrics balancing mode. This field can only be used for a global or regional backend service with the loadBalancingScheme set to EXTERNAL_MANAGED, INTERNAL_MANAGED INTERNAL_SELF_MANAGED. + * Name of a custom utilization signal. The name must be 1-64 characters + * long and match the regular expression + * `[a-z]([-_.a-z0-9]*[a-z0-9])?` which means that the + * first character must be a lowercase letter, and all following + * characters must be a dash, period, underscore, lowercase letter, or + * digit, except the last character, which cannot be a dash, period, or + * underscore. For usage guidelines, see Custom Metrics balancing mode. This + * field can only be used for a global or regional backend service with the + * loadBalancingScheme set to EXTERNAL_MANAGED,INTERNAL_MANAGED INTERNAL_SELF_MANAGED. * * Generated from protobuf field optional string name = 3373707; */ @@ -37,7 +46,15 @@ class BackendServiceCustomMetric extends \Google\Protobuf\Internal\Message * @type bool $dry_run * If true, the metric data is not used for load balancing. * @type string $name - * Name of a custom utilization signal. The name must be 1-64 characters long and match the regular expression [a-z]([-_.a-z0-9]*[a-z0-9])? which means that the first character must be a lowercase letter, and all following characters must be a dash, period, underscore, lowercase letter, or digit, except the last character, which cannot be a dash, period, or underscore. For usage guidelines, see Custom Metrics balancing mode. This field can only be used for a global or regional backend service with the loadBalancingScheme set to EXTERNAL_MANAGED, INTERNAL_MANAGED INTERNAL_SELF_MANAGED. + * Name of a custom utilization signal. The name must be 1-64 characters + * long and match the regular expression + * `[a-z]([-_.a-z0-9]*[a-z0-9])?` which means that the + * first character must be a lowercase letter, and all following + * characters must be a dash, period, underscore, lowercase letter, or + * digit, except the last character, which cannot be a dash, period, or + * underscore. For usage guidelines, see Custom Metrics balancing mode. This + * field can only be used for a global or regional backend service with the + * loadBalancingScheme set to EXTERNAL_MANAGED,INTERNAL_MANAGED INTERNAL_SELF_MANAGED. * } */ public function __construct($data = NULL) { @@ -82,7 +99,15 @@ public function setDryRun($var) } /** - * Name of a custom utilization signal. The name must be 1-64 characters long and match the regular expression [a-z]([-_.a-z0-9]*[a-z0-9])? which means that the first character must be a lowercase letter, and all following characters must be a dash, period, underscore, lowercase letter, or digit, except the last character, which cannot be a dash, period, or underscore. For usage guidelines, see Custom Metrics balancing mode. This field can only be used for a global or regional backend service with the loadBalancingScheme set to EXTERNAL_MANAGED, INTERNAL_MANAGED INTERNAL_SELF_MANAGED. + * Name of a custom utilization signal. The name must be 1-64 characters + * long and match the regular expression + * `[a-z]([-_.a-z0-9]*[a-z0-9])?` which means that the + * first character must be a lowercase letter, and all following + * characters must be a dash, period, underscore, lowercase letter, or + * digit, except the last character, which cannot be a dash, period, or + * underscore. For usage guidelines, see Custom Metrics balancing mode. This + * field can only be used for a global or regional backend service with the + * loadBalancingScheme set to EXTERNAL_MANAGED,INTERNAL_MANAGED INTERNAL_SELF_MANAGED. * * Generated from protobuf field optional string name = 3373707; * @return string @@ -103,7 +128,15 @@ public function clearName() } /** - * Name of a custom utilization signal. The name must be 1-64 characters long and match the regular expression [a-z]([-_.a-z0-9]*[a-z0-9])? which means that the first character must be a lowercase letter, and all following characters must be a dash, period, underscore, lowercase letter, or digit, except the last character, which cannot be a dash, period, or underscore. For usage guidelines, see Custom Metrics balancing mode. This field can only be used for a global or regional backend service with the loadBalancingScheme set to EXTERNAL_MANAGED, INTERNAL_MANAGED INTERNAL_SELF_MANAGED. + * Name of a custom utilization signal. The name must be 1-64 characters + * long and match the regular expression + * `[a-z]([-_.a-z0-9]*[a-z0-9])?` which means that the + * first character must be a lowercase letter, and all following + * characters must be a dash, period, underscore, lowercase letter, or + * digit, except the last character, which cannot be a dash, period, or + * underscore. For usage guidelines, see Custom Metrics balancing mode. This + * field can only be used for a global or regional backend service with the + * loadBalancingScheme set to EXTERNAL_MANAGED,INTERNAL_MANAGED INTERNAL_SELF_MANAGED. * * Generated from protobuf field optional string name = 3373707; * @param string $var diff --git a/Compute/src/V1/BackendServiceFailoverPolicy.php b/Compute/src/V1/BackendServiceFailoverPolicy.php index eedf9d113150..820f90aef38f 100644 --- a/Compute/src/V1/BackendServiceFailoverPolicy.php +++ b/Compute/src/V1/BackendServiceFailoverPolicy.php @@ -9,26 +9,62 @@ use Google\Protobuf\Internal\GPBUtil; /** - * For load balancers that have configurable failover: [Internal passthrough Network Load Balancers](https://cloud.google.com/load-balancing/docs/internal/failover-overview) and [external passthrough Network Load Balancers](https://cloud.google.com/load-balancing/docs/network/networklb-failover-overview). On failover or failback, this field indicates whether connection draining will be honored. Google Cloud has a fixed connection draining timeout of 10 minutes. A setting of true terminates existing TCP connections to the active pool during failover and failback, immediately draining traffic. A setting of false allows existing TCP connections to persist, even on VMs no longer in the active pool, for up to the duration of the connection draining timeout (10 minutes). + * For load balancers that have configurable + * failover: + * [Internal passthrough Network Load + * Balancers](https://cloud.google.com/load-balancing/docs/internal/failover-overview) + * and [external passthrough + * Network Load + * Balancers](https://cloud.google.com/load-balancing/docs/network/networklb-failover-overview). + * On failover or failback, this field indicates whether connection draining + * will be honored. Google Cloud has a fixed connection draining timeout of + * 10 minutes. A setting of true terminates existing TCP + * connections to the active pool during failover and failback, immediately + * draining traffic. A setting of false allows existing TCP + * connections to persist, even on VMs no longer in the active pool, for up + * to the duration of the connection draining timeout (10 minutes). * * Generated from protobuf message google.cloud.compute.v1.BackendServiceFailoverPolicy */ class BackendServiceFailoverPolicy extends \Google\Protobuf\Internal\Message { /** - * This can be set to true only if the protocol is TCP. The default is false. + * This can be set to true only if the protocol isTCP. + * The default is false. * * Generated from protobuf field optional bool disable_connection_drain_on_failover = 182150753; */ protected $disable_connection_drain_on_failover = null; /** - * If set to true, connections to the load balancer are dropped when all primary and all backup backend VMs are unhealthy.If set to false, connections are distributed among all primary VMs when all primary and all backup backend VMs are unhealthy. For load balancers that have configurable failover: [Internal passthrough Network Load Balancers](https://cloud.google.com/load-balancing/docs/internal/failover-overview) and [external passthrough Network Load Balancers](https://cloud.google.com/load-balancing/docs/network/networklb-failover-overview). The default is false. + * If set to true, connections to the + * load balancer are dropped when all primary and all backup backend VMs are + * unhealthy.If set to false, connections are distributed + * among all primary VMs when all primary and all backup backend VMs are + * unhealthy. + * For load balancers that have configurable + * failover: + * [Internal passthrough + * Network Load + * Balancers](https://cloud.google.com/load-balancing/docs/internal/failover-overview) + * and [external passthrough + * Network Load + * Balancers](https://cloud.google.com/load-balancing/docs/network/networklb-failover-overview). + * The default is false. * * Generated from protobuf field optional bool drop_traffic_if_unhealthy = 112289428; */ protected $drop_traffic_if_unhealthy = null; /** - * The value of the field must be in the range [0, 1]. If the value is 0, the load balancer performs a failover when the number of healthy primary VMs equals zero. For all other values, the load balancer performs a failover when the total number of healthy primary VMs is less than this ratio. For load balancers that have configurable failover: [Internal TCP/UDP Load Balancing](https://cloud.google.com/load-balancing/docs/internal/failover-overview) and [external TCP/UDP Load Balancing](https://cloud.google.com/load-balancing/docs/network/networklb-failover-overview). + * The value of the field must be in the range[0, 1]. If the value is 0, the load balancer performs a + * failover when the number of healthy primary VMs equals zero. + * For all other values, the load balancer performs a failover when the + * total number of healthy primary VMs is less than this ratio. + * For load balancers that have configurable + * failover: + * [Internal TCP/UDP Load + * Balancing](https://cloud.google.com/load-balancing/docs/internal/failover-overview) + * and [external TCP/UDP Load + * Balancing](https://cloud.google.com/load-balancing/docs/network/networklb-failover-overview). * * Generated from protobuf field optional float failover_ratio = 212667006; */ @@ -41,11 +77,34 @@ class BackendServiceFailoverPolicy extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type bool $disable_connection_drain_on_failover - * This can be set to true only if the protocol is TCP. The default is false. + * This can be set to true only if the protocol isTCP. + * The default is false. * @type bool $drop_traffic_if_unhealthy - * If set to true, connections to the load balancer are dropped when all primary and all backup backend VMs are unhealthy.If set to false, connections are distributed among all primary VMs when all primary and all backup backend VMs are unhealthy. For load balancers that have configurable failover: [Internal passthrough Network Load Balancers](https://cloud.google.com/load-balancing/docs/internal/failover-overview) and [external passthrough Network Load Balancers](https://cloud.google.com/load-balancing/docs/network/networklb-failover-overview). The default is false. + * If set to true, connections to the + * load balancer are dropped when all primary and all backup backend VMs are + * unhealthy.If set to false, connections are distributed + * among all primary VMs when all primary and all backup backend VMs are + * unhealthy. + * For load balancers that have configurable + * failover: + * [Internal passthrough + * Network Load + * Balancers](https://cloud.google.com/load-balancing/docs/internal/failover-overview) + * and [external passthrough + * Network Load + * Balancers](https://cloud.google.com/load-balancing/docs/network/networklb-failover-overview). + * The default is false. * @type float $failover_ratio - * The value of the field must be in the range [0, 1]. If the value is 0, the load balancer performs a failover when the number of healthy primary VMs equals zero. For all other values, the load balancer performs a failover when the total number of healthy primary VMs is less than this ratio. For load balancers that have configurable failover: [Internal TCP/UDP Load Balancing](https://cloud.google.com/load-balancing/docs/internal/failover-overview) and [external TCP/UDP Load Balancing](https://cloud.google.com/load-balancing/docs/network/networklb-failover-overview). + * The value of the field must be in the range[0, 1]. If the value is 0, the load balancer performs a + * failover when the number of healthy primary VMs equals zero. + * For all other values, the load balancer performs a failover when the + * total number of healthy primary VMs is less than this ratio. + * For load balancers that have configurable + * failover: + * [Internal TCP/UDP Load + * Balancing](https://cloud.google.com/load-balancing/docs/internal/failover-overview) + * and [external TCP/UDP Load + * Balancing](https://cloud.google.com/load-balancing/docs/network/networklb-failover-overview). * } */ public function __construct($data = NULL) { @@ -54,7 +113,8 @@ public function __construct($data = NULL) { } /** - * This can be set to true only if the protocol is TCP. The default is false. + * This can be set to true only if the protocol isTCP. + * The default is false. * * Generated from protobuf field optional bool disable_connection_drain_on_failover = 182150753; * @return bool @@ -75,7 +135,8 @@ public function clearDisableConnectionDrainOnFailover() } /** - * This can be set to true only if the protocol is TCP. The default is false. + * This can be set to true only if the protocol isTCP. + * The default is false. * * Generated from protobuf field optional bool disable_connection_drain_on_failover = 182150753; * @param bool $var @@ -90,7 +151,20 @@ public function setDisableConnectionDrainOnFailover($var) } /** - * If set to true, connections to the load balancer are dropped when all primary and all backup backend VMs are unhealthy.If set to false, connections are distributed among all primary VMs when all primary and all backup backend VMs are unhealthy. For load balancers that have configurable failover: [Internal passthrough Network Load Balancers](https://cloud.google.com/load-balancing/docs/internal/failover-overview) and [external passthrough Network Load Balancers](https://cloud.google.com/load-balancing/docs/network/networklb-failover-overview). The default is false. + * If set to true, connections to the + * load balancer are dropped when all primary and all backup backend VMs are + * unhealthy.If set to false, connections are distributed + * among all primary VMs when all primary and all backup backend VMs are + * unhealthy. + * For load balancers that have configurable + * failover: + * [Internal passthrough + * Network Load + * Balancers](https://cloud.google.com/load-balancing/docs/internal/failover-overview) + * and [external passthrough + * Network Load + * Balancers](https://cloud.google.com/load-balancing/docs/network/networklb-failover-overview). + * The default is false. * * Generated from protobuf field optional bool drop_traffic_if_unhealthy = 112289428; * @return bool @@ -111,7 +185,20 @@ public function clearDropTrafficIfUnhealthy() } /** - * If set to true, connections to the load balancer are dropped when all primary and all backup backend VMs are unhealthy.If set to false, connections are distributed among all primary VMs when all primary and all backup backend VMs are unhealthy. For load balancers that have configurable failover: [Internal passthrough Network Load Balancers](https://cloud.google.com/load-balancing/docs/internal/failover-overview) and [external passthrough Network Load Balancers](https://cloud.google.com/load-balancing/docs/network/networklb-failover-overview). The default is false. + * If set to true, connections to the + * load balancer are dropped when all primary and all backup backend VMs are + * unhealthy.If set to false, connections are distributed + * among all primary VMs when all primary and all backup backend VMs are + * unhealthy. + * For load balancers that have configurable + * failover: + * [Internal passthrough + * Network Load + * Balancers](https://cloud.google.com/load-balancing/docs/internal/failover-overview) + * and [external passthrough + * Network Load + * Balancers](https://cloud.google.com/load-balancing/docs/network/networklb-failover-overview). + * The default is false. * * Generated from protobuf field optional bool drop_traffic_if_unhealthy = 112289428; * @param bool $var @@ -126,7 +213,16 @@ public function setDropTrafficIfUnhealthy($var) } /** - * The value of the field must be in the range [0, 1]. If the value is 0, the load balancer performs a failover when the number of healthy primary VMs equals zero. For all other values, the load balancer performs a failover when the total number of healthy primary VMs is less than this ratio. For load balancers that have configurable failover: [Internal TCP/UDP Load Balancing](https://cloud.google.com/load-balancing/docs/internal/failover-overview) and [external TCP/UDP Load Balancing](https://cloud.google.com/load-balancing/docs/network/networklb-failover-overview). + * The value of the field must be in the range[0, 1]. If the value is 0, the load balancer performs a + * failover when the number of healthy primary VMs equals zero. + * For all other values, the load balancer performs a failover when the + * total number of healthy primary VMs is less than this ratio. + * For load balancers that have configurable + * failover: + * [Internal TCP/UDP Load + * Balancing](https://cloud.google.com/load-balancing/docs/internal/failover-overview) + * and [external TCP/UDP Load + * Balancing](https://cloud.google.com/load-balancing/docs/network/networklb-failover-overview). * * Generated from protobuf field optional float failover_ratio = 212667006; * @return float @@ -147,7 +243,16 @@ public function clearFailoverRatio() } /** - * The value of the field must be in the range [0, 1]. If the value is 0, the load balancer performs a failover when the number of healthy primary VMs equals zero. For all other values, the load balancer performs a failover when the total number of healthy primary VMs is less than this ratio. For load balancers that have configurable failover: [Internal TCP/UDP Load Balancing](https://cloud.google.com/load-balancing/docs/internal/failover-overview) and [external TCP/UDP Load Balancing](https://cloud.google.com/load-balancing/docs/network/networklb-failover-overview). + * The value of the field must be in the range[0, 1]. If the value is 0, the load balancer performs a + * failover when the number of healthy primary VMs equals zero. + * For all other values, the load balancer performs a failover when the + * total number of healthy primary VMs is less than this ratio. + * For load balancers that have configurable + * failover: + * [Internal TCP/UDP Load + * Balancing](https://cloud.google.com/load-balancing/docs/internal/failover-overview) + * and [external TCP/UDP Load + * Balancing](https://cloud.google.com/load-balancing/docs/network/networklb-failover-overview). * * Generated from protobuf field optional float failover_ratio = 212667006; * @param float $var diff --git a/Compute/src/V1/BackendServiceGroupHealth.php b/Compute/src/V1/BackendServiceGroupHealth.php index 55d0c4c92fd4..a1c2340893d9 100644 --- a/Compute/src/V1/BackendServiceGroupHealth.php +++ b/Compute/src/V1/BackendServiceGroupHealth.php @@ -21,13 +21,15 @@ class BackendServiceGroupHealth extends \Google\Protobuf\Internal\Message */ private $annotations; /** - * Health state of the backend instances or endpoints in requested instance or network endpoint group, determined based on configured health checks. + * Health state of the backend instances or endpoints in requested instance or + * network endpoint group, determined based on configured health checks. * * Generated from protobuf field repeated .google.cloud.compute.v1.HealthStatus health_status = 380545845; */ private $health_status; /** - * [Output Only] Type of resource. Always compute#backendServiceGroupHealth for the health of backend services. + * [Output Only] Type of resource. Alwayscompute#backendServiceGroupHealth for the health of backend + * services. * * Generated from protobuf field optional string kind = 3292052; */ @@ -42,9 +44,11 @@ class BackendServiceGroupHealth extends \Google\Protobuf\Internal\Message * @type array|\Google\Protobuf\Internal\MapField $annotations * Metadata defined as annotations on the network endpoint group. * @type array<\Google\Cloud\Compute\V1\HealthStatus>|\Google\Protobuf\Internal\RepeatedField $health_status - * Health state of the backend instances or endpoints in requested instance or network endpoint group, determined based on configured health checks. + * Health state of the backend instances or endpoints in requested instance or + * network endpoint group, determined based on configured health checks. * @type string $kind - * [Output Only] Type of resource. Always compute#backendServiceGroupHealth for the health of backend services. + * [Output Only] Type of resource. Alwayscompute#backendServiceGroupHealth for the health of backend + * services. * } */ public function __construct($data = NULL) { @@ -79,7 +83,8 @@ public function setAnnotations($var) } /** - * Health state of the backend instances or endpoints in requested instance or network endpoint group, determined based on configured health checks. + * Health state of the backend instances or endpoints in requested instance or + * network endpoint group, determined based on configured health checks. * * Generated from protobuf field repeated .google.cloud.compute.v1.HealthStatus health_status = 380545845; * @return \Google\Protobuf\Internal\RepeatedField @@ -90,7 +95,8 @@ public function getHealthStatus() } /** - * Health state of the backend instances or endpoints in requested instance or network endpoint group, determined based on configured health checks. + * Health state of the backend instances or endpoints in requested instance or + * network endpoint group, determined based on configured health checks. * * Generated from protobuf field repeated .google.cloud.compute.v1.HealthStatus health_status = 380545845; * @param array<\Google\Cloud\Compute\V1\HealthStatus>|\Google\Protobuf\Internal\RepeatedField $var @@ -105,7 +111,8 @@ public function setHealthStatus($var) } /** - * [Output Only] Type of resource. Always compute#backendServiceGroupHealth for the health of backend services. + * [Output Only] Type of resource. Alwayscompute#backendServiceGroupHealth for the health of backend + * services. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -126,7 +133,8 @@ public function clearKind() } /** - * [Output Only] Type of resource. Always compute#backendServiceGroupHealth for the health of backend services. + * [Output Only] Type of resource. Alwayscompute#backendServiceGroupHealth for the health of backend + * services. * * Generated from protobuf field optional string kind = 3292052; * @param string $var diff --git a/Compute/src/V1/BackendServiceHAPolicy.php b/Compute/src/V1/BackendServiceHAPolicy.php index 50c876e06277..459d567e0e35 100644 --- a/Compute/src/V1/BackendServiceHAPolicy.php +++ b/Compute/src/V1/BackendServiceHAPolicy.php @@ -15,14 +15,83 @@ class BackendServiceHAPolicy extends \Google\Protobuf\Internal\Message { /** - * Specifies whether fast IP move is enabled, and if so, the mechanism to achieve it. Supported values are: - DISABLED: Fast IP Move is disabled. You can only use the haPolicy.leader API to update the leader. - >GARP_RA: Provides a method to very quickly define a new network endpoint as the leader. This method is faster than updating the leader using the haPolicy.leader API. Fast IP move works as follows: The VM hosting the network endpoint that should become the new leader sends either a Gratuitous ARP (GARP) packet (IPv4) or an ICMPv6 Router Advertisement(RA) packet (IPv6). Google Cloud immediately but temporarily associates the forwarding rule IP address with that VM, and both new and in-flight packets are quickly delivered to that VM. Note the important properties of the Fast IP Move functionality: - The GARP/RA-initiated re-routing stays active for approximately 20 minutes. After triggering fast failover, you must also appropriately set the haPolicy.leader. - The new leader instance should continue to send GARP/RA packets periodically every 10 seconds until at least 10 minutes after updating the haPolicy.leader (but stop immediately if it is no longer the leader). - After triggering a fast failover, we recommend that you wait at least 3 seconds before sending another GARP/RA packet from a different VM instance to avoid race conditions. - Don't send GARP/RA packets from different VM instances at the same time. If multiple instances continue to send GARP/RA packets, traffic might be routed to different destinations in an alternating order. This condition ceases when a single instance issues a GARP/RA packet. - The GARP/RA request always takes priority over the leader API. Using the haPolicy.leader API to change the leader to a different instance will have no effect until the GARP/RA request becomes inactive. - The GARP/RA packets should follow the GARP/RA Packet Specifications.. - When multiple forwarding rules refer to a regional backend service, you need only send a GARP or RA packet for a single forwarding rule virtual IP. The virtual IPs for all forwarding rules targeting the same backend service will also be moved to the sender of the GARP or RA packet. The following are the Fast IP Move limitations (that is, when fastIPMove is not DISABLED): - Multiple forwarding rules cannot use the same IP address if one of them refers to a regional backend service with fastIPMove. - The regional backend service must set the network field, and all NEGs must belong to that network. However, individual NEGs can belong to different subnetworks of that network. - The maximum number of network endpoints across all backends of a backend service with fastIPMove is 32. - The maximum number of backend services with fastIPMove that can have the same network endpoint attached to one of its backends is 64. - The maximum number of backend services with fastIPMove in a VPC in a region is 64. - The network endpoints that are attached to a backend of a backend service with fastIPMove cannot resolve to Gen3+ machines for IPv6. - Traffic directed to the leader by a static route next hop will not be redirected to a new leader by fast failover. Such traffic will only be redirected once an haPolicy.leader update has taken effect. Only traffic to the forwarding rule's virtual IP will be redirected to a new leader by fast failover. haPolicy.fastIPMove can be set only at backend service creation time. Once set, it cannot be updated. By default, fastIpMove is set to DISABLED. + * Specifies whether fast IP move is enabled, and if so, the mechanism to + * achieve it. + * Supported values are: + * - DISABLED: Fast IP Move is disabled. You can only use the + * haPolicy.leader API to update the leader. + * - >GARP_RA: Provides a method to very quickly define a new network + * endpoint as the leader. This method is faster than updating the leader + * using the haPolicy.leader API. Fast IP move works as follows: The VM + * hosting the network endpoint that should become the new leader sends + * either a Gratuitous ARP (GARP) packet (IPv4) or an ICMPv6 Router + * Advertisement(RA) packet (IPv6). Google Cloud immediately but + * temporarily associates the forwarding rule IP address with that VM, and + * both new and in-flight packets are quickly delivered to that VM. + * Note the important properties of the Fast IP Move functionality: + * - The GARP/RA-initiated re-routing stays active for approximately 20 + * minutes. After triggering fast failover, you must also + * appropriately set the haPolicy.leader. + * - The new leader instance should continue to send GARP/RA packets + * periodically every 10 seconds until at least 10 minutes after updating + * the haPolicy.leader (but stop immediately if it is no longer the leader). + * - After triggering a fast failover, we recommend that you wait at least + * 3 seconds before sending another GARP/RA packet from a different VM + * instance to avoid race conditions. + * - Don't send GARP/RA packets from different VM + * instances at the same time. If multiple instances continue to send + * GARP/RA packets, traffic might be routed to different destinations in an + * alternating order. This condition ceases when a single instance + * issues a GARP/RA packet. + * - The GARP/RA request always takes priority over the leader API. + * Using the haPolicy.leader API to change the leader to a different + * instance will have no effect until the GARP/RA request becomes + * inactive. + * - The GARP/RA packets should follow the GARP/RA + * Packet Specifications.. + * - When multiple forwarding rules refer to a regional backend service, + * you need only send a GARP or RA packet for a single forwarding rule + * virtual IP. The virtual IPs for all forwarding rules targeting the same + * backend service will also be moved to the sender of the GARP or RA + * packet. + * The following are the Fast IP Move limitations (that is, when fastIPMove + * is not DISABLED): + * - Multiple forwarding rules cannot use the same IP address if one of + * them refers to a regional backend service with fastIPMove. + * - The regional backend service must set the network field, and all + * NEGs must belong to that network. However, individual + * NEGs can belong to different subnetworks of that network. + * - The maximum number of network endpoints across all backends of a + * backend service with fastIPMove is 32. + * - The maximum number of backend services with fastIPMove that can have + * the same network endpoint attached to one of its backends is 64. + * - The maximum number of backend services with fastIPMove in a VPC in a + * region is 64. + * - The network endpoints that are attached to a backend of a backend + * service with fastIPMove cannot resolve to Gen3+ machines for IPv6. + * - Traffic directed to the leader by a static route next hop will not be + * redirected to a new leader by fast failover. Such traffic will only be + * redirected once an haPolicy.leader update has taken effect. Only traffic + * to the forwarding rule's virtual IP will be redirected to a new leader by + * fast failover. + * haPolicy.fastIPMove can be set only at backend service creation time. + * Once set, it cannot be updated. + * By default, fastIpMove is set to DISABLED. * Check the FastIPMove enum for the list of possible values. * * Generated from protobuf field optional string fast_i_p_move = 222633817; */ protected $fast_i_p_move = null; /** - * Selects one of the network endpoints attached to the backend NEGs of this service as the active endpoint (the leader) that receives all traffic. When the leader changes, there is no connection draining to persist existing connections on the old leader. You are responsible for selecting a suitable endpoint as the leader. For example, preferring a healthy endpoint over unhealthy ones. Note that this service does not track backend endpoint health, and selects the configured leader unconditionally. + * Selects one of the network endpoints attached to the backend NEGs of + * this service as the active endpoint (the leader) that receives all + * traffic. + * When the leader changes, there is no connection draining to persist + * existing connections on the old leader. + * You are responsible for selecting a suitable endpoint as the + * leader. For example, preferring a healthy endpoint over unhealthy ones. + * Note that this service does not track backend endpoint health, and + * selects the configured leader unconditionally. * * Generated from protobuf field optional .google.cloud.compute.v1.BackendServiceHAPolicyLeader leader = 503858441; */ @@ -35,10 +104,79 @@ class BackendServiceHAPolicy extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $fast_i_p_move - * Specifies whether fast IP move is enabled, and if so, the mechanism to achieve it. Supported values are: - DISABLED: Fast IP Move is disabled. You can only use the haPolicy.leader API to update the leader. - >GARP_RA: Provides a method to very quickly define a new network endpoint as the leader. This method is faster than updating the leader using the haPolicy.leader API. Fast IP move works as follows: The VM hosting the network endpoint that should become the new leader sends either a Gratuitous ARP (GARP) packet (IPv4) or an ICMPv6 Router Advertisement(RA) packet (IPv6). Google Cloud immediately but temporarily associates the forwarding rule IP address with that VM, and both new and in-flight packets are quickly delivered to that VM. Note the important properties of the Fast IP Move functionality: - The GARP/RA-initiated re-routing stays active for approximately 20 minutes. After triggering fast failover, you must also appropriately set the haPolicy.leader. - The new leader instance should continue to send GARP/RA packets periodically every 10 seconds until at least 10 minutes after updating the haPolicy.leader (but stop immediately if it is no longer the leader). - After triggering a fast failover, we recommend that you wait at least 3 seconds before sending another GARP/RA packet from a different VM instance to avoid race conditions. - Don't send GARP/RA packets from different VM instances at the same time. If multiple instances continue to send GARP/RA packets, traffic might be routed to different destinations in an alternating order. This condition ceases when a single instance issues a GARP/RA packet. - The GARP/RA request always takes priority over the leader API. Using the haPolicy.leader API to change the leader to a different instance will have no effect until the GARP/RA request becomes inactive. - The GARP/RA packets should follow the GARP/RA Packet Specifications.. - When multiple forwarding rules refer to a regional backend service, you need only send a GARP or RA packet for a single forwarding rule virtual IP. The virtual IPs for all forwarding rules targeting the same backend service will also be moved to the sender of the GARP or RA packet. The following are the Fast IP Move limitations (that is, when fastIPMove is not DISABLED): - Multiple forwarding rules cannot use the same IP address if one of them refers to a regional backend service with fastIPMove. - The regional backend service must set the network field, and all NEGs must belong to that network. However, individual NEGs can belong to different subnetworks of that network. - The maximum number of network endpoints across all backends of a backend service with fastIPMove is 32. - The maximum number of backend services with fastIPMove that can have the same network endpoint attached to one of its backends is 64. - The maximum number of backend services with fastIPMove in a VPC in a region is 64. - The network endpoints that are attached to a backend of a backend service with fastIPMove cannot resolve to Gen3+ machines for IPv6. - Traffic directed to the leader by a static route next hop will not be redirected to a new leader by fast failover. Such traffic will only be redirected once an haPolicy.leader update has taken effect. Only traffic to the forwarding rule's virtual IP will be redirected to a new leader by fast failover. haPolicy.fastIPMove can be set only at backend service creation time. Once set, it cannot be updated. By default, fastIpMove is set to DISABLED. + * Specifies whether fast IP move is enabled, and if so, the mechanism to + * achieve it. + * Supported values are: + * - DISABLED: Fast IP Move is disabled. You can only use the + * haPolicy.leader API to update the leader. + * - >GARP_RA: Provides a method to very quickly define a new network + * endpoint as the leader. This method is faster than updating the leader + * using the haPolicy.leader API. Fast IP move works as follows: The VM + * hosting the network endpoint that should become the new leader sends + * either a Gratuitous ARP (GARP) packet (IPv4) or an ICMPv6 Router + * Advertisement(RA) packet (IPv6). Google Cloud immediately but + * temporarily associates the forwarding rule IP address with that VM, and + * both new and in-flight packets are quickly delivered to that VM. + * Note the important properties of the Fast IP Move functionality: + * - The GARP/RA-initiated re-routing stays active for approximately 20 + * minutes. After triggering fast failover, you must also + * appropriately set the haPolicy.leader. + * - The new leader instance should continue to send GARP/RA packets + * periodically every 10 seconds until at least 10 minutes after updating + * the haPolicy.leader (but stop immediately if it is no longer the leader). + * - After triggering a fast failover, we recommend that you wait at least + * 3 seconds before sending another GARP/RA packet from a different VM + * instance to avoid race conditions. + * - Don't send GARP/RA packets from different VM + * instances at the same time. If multiple instances continue to send + * GARP/RA packets, traffic might be routed to different destinations in an + * alternating order. This condition ceases when a single instance + * issues a GARP/RA packet. + * - The GARP/RA request always takes priority over the leader API. + * Using the haPolicy.leader API to change the leader to a different + * instance will have no effect until the GARP/RA request becomes + * inactive. + * - The GARP/RA packets should follow the GARP/RA + * Packet Specifications.. + * - When multiple forwarding rules refer to a regional backend service, + * you need only send a GARP or RA packet for a single forwarding rule + * virtual IP. The virtual IPs for all forwarding rules targeting the same + * backend service will also be moved to the sender of the GARP or RA + * packet. + * The following are the Fast IP Move limitations (that is, when fastIPMove + * is not DISABLED): + * - Multiple forwarding rules cannot use the same IP address if one of + * them refers to a regional backend service with fastIPMove. + * - The regional backend service must set the network field, and all + * NEGs must belong to that network. However, individual + * NEGs can belong to different subnetworks of that network. + * - The maximum number of network endpoints across all backends of a + * backend service with fastIPMove is 32. + * - The maximum number of backend services with fastIPMove that can have + * the same network endpoint attached to one of its backends is 64. + * - The maximum number of backend services with fastIPMove in a VPC in a + * region is 64. + * - The network endpoints that are attached to a backend of a backend + * service with fastIPMove cannot resolve to Gen3+ machines for IPv6. + * - Traffic directed to the leader by a static route next hop will not be + * redirected to a new leader by fast failover. Such traffic will only be + * redirected once an haPolicy.leader update has taken effect. Only traffic + * to the forwarding rule's virtual IP will be redirected to a new leader by + * fast failover. + * haPolicy.fastIPMove can be set only at backend service creation time. + * Once set, it cannot be updated. + * By default, fastIpMove is set to DISABLED. * Check the FastIPMove enum for the list of possible values. * @type \Google\Cloud\Compute\V1\BackendServiceHAPolicyLeader $leader - * Selects one of the network endpoints attached to the backend NEGs of this service as the active endpoint (the leader) that receives all traffic. When the leader changes, there is no connection draining to persist existing connections on the old leader. You are responsible for selecting a suitable endpoint as the leader. For example, preferring a healthy endpoint over unhealthy ones. Note that this service does not track backend endpoint health, and selects the configured leader unconditionally. + * Selects one of the network endpoints attached to the backend NEGs of + * this service as the active endpoint (the leader) that receives all + * traffic. + * When the leader changes, there is no connection draining to persist + * existing connections on the old leader. + * You are responsible for selecting a suitable endpoint as the + * leader. For example, preferring a healthy endpoint over unhealthy ones. + * Note that this service does not track backend endpoint health, and + * selects the configured leader unconditionally. * } */ public function __construct($data = NULL) { @@ -47,7 +185,68 @@ public function __construct($data = NULL) { } /** - * Specifies whether fast IP move is enabled, and if so, the mechanism to achieve it. Supported values are: - DISABLED: Fast IP Move is disabled. You can only use the haPolicy.leader API to update the leader. - >GARP_RA: Provides a method to very quickly define a new network endpoint as the leader. This method is faster than updating the leader using the haPolicy.leader API. Fast IP move works as follows: The VM hosting the network endpoint that should become the new leader sends either a Gratuitous ARP (GARP) packet (IPv4) or an ICMPv6 Router Advertisement(RA) packet (IPv6). Google Cloud immediately but temporarily associates the forwarding rule IP address with that VM, and both new and in-flight packets are quickly delivered to that VM. Note the important properties of the Fast IP Move functionality: - The GARP/RA-initiated re-routing stays active for approximately 20 minutes. After triggering fast failover, you must also appropriately set the haPolicy.leader. - The new leader instance should continue to send GARP/RA packets periodically every 10 seconds until at least 10 minutes after updating the haPolicy.leader (but stop immediately if it is no longer the leader). - After triggering a fast failover, we recommend that you wait at least 3 seconds before sending another GARP/RA packet from a different VM instance to avoid race conditions. - Don't send GARP/RA packets from different VM instances at the same time. If multiple instances continue to send GARP/RA packets, traffic might be routed to different destinations in an alternating order. This condition ceases when a single instance issues a GARP/RA packet. - The GARP/RA request always takes priority over the leader API. Using the haPolicy.leader API to change the leader to a different instance will have no effect until the GARP/RA request becomes inactive. - The GARP/RA packets should follow the GARP/RA Packet Specifications.. - When multiple forwarding rules refer to a regional backend service, you need only send a GARP or RA packet for a single forwarding rule virtual IP. The virtual IPs for all forwarding rules targeting the same backend service will also be moved to the sender of the GARP or RA packet. The following are the Fast IP Move limitations (that is, when fastIPMove is not DISABLED): - Multiple forwarding rules cannot use the same IP address if one of them refers to a regional backend service with fastIPMove. - The regional backend service must set the network field, and all NEGs must belong to that network. However, individual NEGs can belong to different subnetworks of that network. - The maximum number of network endpoints across all backends of a backend service with fastIPMove is 32. - The maximum number of backend services with fastIPMove that can have the same network endpoint attached to one of its backends is 64. - The maximum number of backend services with fastIPMove in a VPC in a region is 64. - The network endpoints that are attached to a backend of a backend service with fastIPMove cannot resolve to Gen3+ machines for IPv6. - Traffic directed to the leader by a static route next hop will not be redirected to a new leader by fast failover. Such traffic will only be redirected once an haPolicy.leader update has taken effect. Only traffic to the forwarding rule's virtual IP will be redirected to a new leader by fast failover. haPolicy.fastIPMove can be set only at backend service creation time. Once set, it cannot be updated. By default, fastIpMove is set to DISABLED. + * Specifies whether fast IP move is enabled, and if so, the mechanism to + * achieve it. + * Supported values are: + * - DISABLED: Fast IP Move is disabled. You can only use the + * haPolicy.leader API to update the leader. + * - >GARP_RA: Provides a method to very quickly define a new network + * endpoint as the leader. This method is faster than updating the leader + * using the haPolicy.leader API. Fast IP move works as follows: The VM + * hosting the network endpoint that should become the new leader sends + * either a Gratuitous ARP (GARP) packet (IPv4) or an ICMPv6 Router + * Advertisement(RA) packet (IPv6). Google Cloud immediately but + * temporarily associates the forwarding rule IP address with that VM, and + * both new and in-flight packets are quickly delivered to that VM. + * Note the important properties of the Fast IP Move functionality: + * - The GARP/RA-initiated re-routing stays active for approximately 20 + * minutes. After triggering fast failover, you must also + * appropriately set the haPolicy.leader. + * - The new leader instance should continue to send GARP/RA packets + * periodically every 10 seconds until at least 10 minutes after updating + * the haPolicy.leader (but stop immediately if it is no longer the leader). + * - After triggering a fast failover, we recommend that you wait at least + * 3 seconds before sending another GARP/RA packet from a different VM + * instance to avoid race conditions. + * - Don't send GARP/RA packets from different VM + * instances at the same time. If multiple instances continue to send + * GARP/RA packets, traffic might be routed to different destinations in an + * alternating order. This condition ceases when a single instance + * issues a GARP/RA packet. + * - The GARP/RA request always takes priority over the leader API. + * Using the haPolicy.leader API to change the leader to a different + * instance will have no effect until the GARP/RA request becomes + * inactive. + * - The GARP/RA packets should follow the GARP/RA + * Packet Specifications.. + * - When multiple forwarding rules refer to a regional backend service, + * you need only send a GARP or RA packet for a single forwarding rule + * virtual IP. The virtual IPs for all forwarding rules targeting the same + * backend service will also be moved to the sender of the GARP or RA + * packet. + * The following are the Fast IP Move limitations (that is, when fastIPMove + * is not DISABLED): + * - Multiple forwarding rules cannot use the same IP address if one of + * them refers to a regional backend service with fastIPMove. + * - The regional backend service must set the network field, and all + * NEGs must belong to that network. However, individual + * NEGs can belong to different subnetworks of that network. + * - The maximum number of network endpoints across all backends of a + * backend service with fastIPMove is 32. + * - The maximum number of backend services with fastIPMove that can have + * the same network endpoint attached to one of its backends is 64. + * - The maximum number of backend services with fastIPMove in a VPC in a + * region is 64. + * - The network endpoints that are attached to a backend of a backend + * service with fastIPMove cannot resolve to Gen3+ machines for IPv6. + * - Traffic directed to the leader by a static route next hop will not be + * redirected to a new leader by fast failover. Such traffic will only be + * redirected once an haPolicy.leader update has taken effect. Only traffic + * to the forwarding rule's virtual IP will be redirected to a new leader by + * fast failover. + * haPolicy.fastIPMove can be set only at backend service creation time. + * Once set, it cannot be updated. + * By default, fastIpMove is set to DISABLED. * Check the FastIPMove enum for the list of possible values. * * Generated from protobuf field optional string fast_i_p_move = 222633817; @@ -69,7 +268,68 @@ public function clearFastIPMove() } /** - * Specifies whether fast IP move is enabled, and if so, the mechanism to achieve it. Supported values are: - DISABLED: Fast IP Move is disabled. You can only use the haPolicy.leader API to update the leader. - >GARP_RA: Provides a method to very quickly define a new network endpoint as the leader. This method is faster than updating the leader using the haPolicy.leader API. Fast IP move works as follows: The VM hosting the network endpoint that should become the new leader sends either a Gratuitous ARP (GARP) packet (IPv4) or an ICMPv6 Router Advertisement(RA) packet (IPv6). Google Cloud immediately but temporarily associates the forwarding rule IP address with that VM, and both new and in-flight packets are quickly delivered to that VM. Note the important properties of the Fast IP Move functionality: - The GARP/RA-initiated re-routing stays active for approximately 20 minutes. After triggering fast failover, you must also appropriately set the haPolicy.leader. - The new leader instance should continue to send GARP/RA packets periodically every 10 seconds until at least 10 minutes after updating the haPolicy.leader (but stop immediately if it is no longer the leader). - After triggering a fast failover, we recommend that you wait at least 3 seconds before sending another GARP/RA packet from a different VM instance to avoid race conditions. - Don't send GARP/RA packets from different VM instances at the same time. If multiple instances continue to send GARP/RA packets, traffic might be routed to different destinations in an alternating order. This condition ceases when a single instance issues a GARP/RA packet. - The GARP/RA request always takes priority over the leader API. Using the haPolicy.leader API to change the leader to a different instance will have no effect until the GARP/RA request becomes inactive. - The GARP/RA packets should follow the GARP/RA Packet Specifications.. - When multiple forwarding rules refer to a regional backend service, you need only send a GARP or RA packet for a single forwarding rule virtual IP. The virtual IPs for all forwarding rules targeting the same backend service will also be moved to the sender of the GARP or RA packet. The following are the Fast IP Move limitations (that is, when fastIPMove is not DISABLED): - Multiple forwarding rules cannot use the same IP address if one of them refers to a regional backend service with fastIPMove. - The regional backend service must set the network field, and all NEGs must belong to that network. However, individual NEGs can belong to different subnetworks of that network. - The maximum number of network endpoints across all backends of a backend service with fastIPMove is 32. - The maximum number of backend services with fastIPMove that can have the same network endpoint attached to one of its backends is 64. - The maximum number of backend services with fastIPMove in a VPC in a region is 64. - The network endpoints that are attached to a backend of a backend service with fastIPMove cannot resolve to Gen3+ machines for IPv6. - Traffic directed to the leader by a static route next hop will not be redirected to a new leader by fast failover. Such traffic will only be redirected once an haPolicy.leader update has taken effect. Only traffic to the forwarding rule's virtual IP will be redirected to a new leader by fast failover. haPolicy.fastIPMove can be set only at backend service creation time. Once set, it cannot be updated. By default, fastIpMove is set to DISABLED. + * Specifies whether fast IP move is enabled, and if so, the mechanism to + * achieve it. + * Supported values are: + * - DISABLED: Fast IP Move is disabled. You can only use the + * haPolicy.leader API to update the leader. + * - >GARP_RA: Provides a method to very quickly define a new network + * endpoint as the leader. This method is faster than updating the leader + * using the haPolicy.leader API. Fast IP move works as follows: The VM + * hosting the network endpoint that should become the new leader sends + * either a Gratuitous ARP (GARP) packet (IPv4) or an ICMPv6 Router + * Advertisement(RA) packet (IPv6). Google Cloud immediately but + * temporarily associates the forwarding rule IP address with that VM, and + * both new and in-flight packets are quickly delivered to that VM. + * Note the important properties of the Fast IP Move functionality: + * - The GARP/RA-initiated re-routing stays active for approximately 20 + * minutes. After triggering fast failover, you must also + * appropriately set the haPolicy.leader. + * - The new leader instance should continue to send GARP/RA packets + * periodically every 10 seconds until at least 10 minutes after updating + * the haPolicy.leader (but stop immediately if it is no longer the leader). + * - After triggering a fast failover, we recommend that you wait at least + * 3 seconds before sending another GARP/RA packet from a different VM + * instance to avoid race conditions. + * - Don't send GARP/RA packets from different VM + * instances at the same time. If multiple instances continue to send + * GARP/RA packets, traffic might be routed to different destinations in an + * alternating order. This condition ceases when a single instance + * issues a GARP/RA packet. + * - The GARP/RA request always takes priority over the leader API. + * Using the haPolicy.leader API to change the leader to a different + * instance will have no effect until the GARP/RA request becomes + * inactive. + * - The GARP/RA packets should follow the GARP/RA + * Packet Specifications.. + * - When multiple forwarding rules refer to a regional backend service, + * you need only send a GARP or RA packet for a single forwarding rule + * virtual IP. The virtual IPs for all forwarding rules targeting the same + * backend service will also be moved to the sender of the GARP or RA + * packet. + * The following are the Fast IP Move limitations (that is, when fastIPMove + * is not DISABLED): + * - Multiple forwarding rules cannot use the same IP address if one of + * them refers to a regional backend service with fastIPMove. + * - The regional backend service must set the network field, and all + * NEGs must belong to that network. However, individual + * NEGs can belong to different subnetworks of that network. + * - The maximum number of network endpoints across all backends of a + * backend service with fastIPMove is 32. + * - The maximum number of backend services with fastIPMove that can have + * the same network endpoint attached to one of its backends is 64. + * - The maximum number of backend services with fastIPMove in a VPC in a + * region is 64. + * - The network endpoints that are attached to a backend of a backend + * service with fastIPMove cannot resolve to Gen3+ machines for IPv6. + * - Traffic directed to the leader by a static route next hop will not be + * redirected to a new leader by fast failover. Such traffic will only be + * redirected once an haPolicy.leader update has taken effect. Only traffic + * to the forwarding rule's virtual IP will be redirected to a new leader by + * fast failover. + * haPolicy.fastIPMove can be set only at backend service creation time. + * Once set, it cannot be updated. + * By default, fastIpMove is set to DISABLED. * Check the FastIPMove enum for the list of possible values. * * Generated from protobuf field optional string fast_i_p_move = 222633817; @@ -85,7 +345,15 @@ public function setFastIPMove($var) } /** - * Selects one of the network endpoints attached to the backend NEGs of this service as the active endpoint (the leader) that receives all traffic. When the leader changes, there is no connection draining to persist existing connections on the old leader. You are responsible for selecting a suitable endpoint as the leader. For example, preferring a healthy endpoint over unhealthy ones. Note that this service does not track backend endpoint health, and selects the configured leader unconditionally. + * Selects one of the network endpoints attached to the backend NEGs of + * this service as the active endpoint (the leader) that receives all + * traffic. + * When the leader changes, there is no connection draining to persist + * existing connections on the old leader. + * You are responsible for selecting a suitable endpoint as the + * leader. For example, preferring a healthy endpoint over unhealthy ones. + * Note that this service does not track backend endpoint health, and + * selects the configured leader unconditionally. * * Generated from protobuf field optional .google.cloud.compute.v1.BackendServiceHAPolicyLeader leader = 503858441; * @return \Google\Cloud\Compute\V1\BackendServiceHAPolicyLeader|null @@ -106,7 +374,15 @@ public function clearLeader() } /** - * Selects one of the network endpoints attached to the backend NEGs of this service as the active endpoint (the leader) that receives all traffic. When the leader changes, there is no connection draining to persist existing connections on the old leader. You are responsible for selecting a suitable endpoint as the leader. For example, preferring a healthy endpoint over unhealthy ones. Note that this service does not track backend endpoint health, and selects the configured leader unconditionally. + * Selects one of the network endpoints attached to the backend NEGs of + * this service as the active endpoint (the leader) that receives all + * traffic. + * When the leader changes, there is no connection draining to persist + * existing connections on the old leader. + * You are responsible for selecting a suitable endpoint as the + * leader. For example, preferring a healthy endpoint over unhealthy ones. + * Note that this service does not track backend endpoint health, and + * selects the configured leader unconditionally. * * Generated from protobuf field optional .google.cloud.compute.v1.BackendServiceHAPolicyLeader leader = 503858441; * @param \Google\Cloud\Compute\V1\BackendServiceHAPolicyLeader $var diff --git a/Compute/src/V1/BackendServiceHAPolicy/FastIPMove.php b/Compute/src/V1/BackendServiceHAPolicy/FastIPMove.php index 5dfa8ad693bb..3cd37ac8949e 100644 --- a/Compute/src/V1/BackendServiceHAPolicy/FastIPMove.php +++ b/Compute/src/V1/BackendServiceHAPolicy/FastIPMove.php @@ -7,7 +7,68 @@ use UnexpectedValueException; /** - * Specifies whether fast IP move is enabled, and if so, the mechanism to achieve it. Supported values are: - DISABLED: Fast IP Move is disabled. You can only use the haPolicy.leader API to update the leader. - >GARP_RA: Provides a method to very quickly define a new network endpoint as the leader. This method is faster than updating the leader using the haPolicy.leader API. Fast IP move works as follows: The VM hosting the network endpoint that should become the new leader sends either a Gratuitous ARP (GARP) packet (IPv4) or an ICMPv6 Router Advertisement(RA) packet (IPv6). Google Cloud immediately but temporarily associates the forwarding rule IP address with that VM, and both new and in-flight packets are quickly delivered to that VM. Note the important properties of the Fast IP Move functionality: - The GARP/RA-initiated re-routing stays active for approximately 20 minutes. After triggering fast failover, you must also appropriately set the haPolicy.leader. - The new leader instance should continue to send GARP/RA packets periodically every 10 seconds until at least 10 minutes after updating the haPolicy.leader (but stop immediately if it is no longer the leader). - After triggering a fast failover, we recommend that you wait at least 3 seconds before sending another GARP/RA packet from a different VM instance to avoid race conditions. - Don't send GARP/RA packets from different VM instances at the same time. If multiple instances continue to send GARP/RA packets, traffic might be routed to different destinations in an alternating order. This condition ceases when a single instance issues a GARP/RA packet. - The GARP/RA request always takes priority over the leader API. Using the haPolicy.leader API to change the leader to a different instance will have no effect until the GARP/RA request becomes inactive. - The GARP/RA packets should follow the GARP/RA Packet Specifications.. - When multiple forwarding rules refer to a regional backend service, you need only send a GARP or RA packet for a single forwarding rule virtual IP. The virtual IPs for all forwarding rules targeting the same backend service will also be moved to the sender of the GARP or RA packet. The following are the Fast IP Move limitations (that is, when fastIPMove is not DISABLED): - Multiple forwarding rules cannot use the same IP address if one of them refers to a regional backend service with fastIPMove. - The regional backend service must set the network field, and all NEGs must belong to that network. However, individual NEGs can belong to different subnetworks of that network. - The maximum number of network endpoints across all backends of a backend service with fastIPMove is 32. - The maximum number of backend services with fastIPMove that can have the same network endpoint attached to one of its backends is 64. - The maximum number of backend services with fastIPMove in a VPC in a region is 64. - The network endpoints that are attached to a backend of a backend service with fastIPMove cannot resolve to Gen3+ machines for IPv6. - Traffic directed to the leader by a static route next hop will not be redirected to a new leader by fast failover. Such traffic will only be redirected once an haPolicy.leader update has taken effect. Only traffic to the forwarding rule's virtual IP will be redirected to a new leader by fast failover. haPolicy.fastIPMove can be set only at backend service creation time. Once set, it cannot be updated. By default, fastIpMove is set to DISABLED. + * Specifies whether fast IP move is enabled, and if so, the mechanism to + * achieve it. + * Supported values are: + * - DISABLED: Fast IP Move is disabled. You can only use the + * haPolicy.leader API to update the leader. + * - >GARP_RA: Provides a method to very quickly define a new network + * endpoint as the leader. This method is faster than updating the leader + * using the haPolicy.leader API. Fast IP move works as follows: The VM + * hosting the network endpoint that should become the new leader sends + * either a Gratuitous ARP (GARP) packet (IPv4) or an ICMPv6 Router + * Advertisement(RA) packet (IPv6). Google Cloud immediately but + * temporarily associates the forwarding rule IP address with that VM, and + * both new and in-flight packets are quickly delivered to that VM. + * Note the important properties of the Fast IP Move functionality: + * - The GARP/RA-initiated re-routing stays active for approximately 20 + * minutes. After triggering fast failover, you must also + * appropriately set the haPolicy.leader. + * - The new leader instance should continue to send GARP/RA packets + * periodically every 10 seconds until at least 10 minutes after updating + * the haPolicy.leader (but stop immediately if it is no longer the leader). + * - After triggering a fast failover, we recommend that you wait at least + * 3 seconds before sending another GARP/RA packet from a different VM + * instance to avoid race conditions. + * - Don't send GARP/RA packets from different VM + * instances at the same time. If multiple instances continue to send + * GARP/RA packets, traffic might be routed to different destinations in an + * alternating order. This condition ceases when a single instance + * issues a GARP/RA packet. + * - The GARP/RA request always takes priority over the leader API. + * Using the haPolicy.leader API to change the leader to a different + * instance will have no effect until the GARP/RA request becomes + * inactive. + * - The GARP/RA packets should follow the GARP/RA + * Packet Specifications.. + * - When multiple forwarding rules refer to a regional backend service, + * you need only send a GARP or RA packet for a single forwarding rule + * virtual IP. The virtual IPs for all forwarding rules targeting the same + * backend service will also be moved to the sender of the GARP or RA + * packet. + * The following are the Fast IP Move limitations (that is, when fastIPMove + * is not DISABLED): + * - Multiple forwarding rules cannot use the same IP address if one of + * them refers to a regional backend service with fastIPMove. + * - The regional backend service must set the network field, and all + * NEGs must belong to that network. However, individual + * NEGs can belong to different subnetworks of that network. + * - The maximum number of network endpoints across all backends of a + * backend service with fastIPMove is 32. + * - The maximum number of backend services with fastIPMove that can have + * the same network endpoint attached to one of its backends is 64. + * - The maximum number of backend services with fastIPMove in a VPC in a + * region is 64. + * - The network endpoints that are attached to a backend of a backend + * service with fastIPMove cannot resolve to Gen3+ machines for IPv6. + * - Traffic directed to the leader by a static route next hop will not be + * redirected to a new leader by fast failover. Such traffic will only be + * redirected once an haPolicy.leader update has taken effect. Only traffic + * to the forwarding rule's virtual IP will be redirected to a new leader by + * fast failover. + * haPolicy.fastIPMove can be set only at backend service creation time. + * Once set, it cannot be updated. + * By default, fastIpMove is set to DISABLED. * * Protobuf type google.cloud.compute.v1.BackendServiceHAPolicy.FastIPMove */ diff --git a/Compute/src/V1/BackendServiceHAPolicyLeader.php b/Compute/src/V1/BackendServiceHAPolicyLeader.php index 4518557019d6..4a59b053dd92 100644 --- a/Compute/src/V1/BackendServiceHAPolicyLeader.php +++ b/Compute/src/V1/BackendServiceHAPolicyLeader.php @@ -15,13 +15,22 @@ class BackendServiceHAPolicyLeader extends \Google\Protobuf\Internal\Message { /** - * A fully-qualified URL (starting with https://www.googleapis.com/) of the zonal Network Endpoint Group (NEG) with `GCE_VM_IP` endpoints that the leader is attached to. The leader's backendGroup must already be specified as a backend of this backend service. Removing a backend that is designated as the leader's backendGroup is not permitted. + * A fully-qualified URL (starting with https://www.googleapis.com/) + * of the zonal Network Endpoint Group (NEG) with `GCE_VM_IP` endpoints + * that the leader is attached to. + * The leader's backendGroup must already be specified as a backend of + * this backend service. Removing a backend that is designated as the + * leader's backendGroup is not permitted. * * Generated from protobuf field optional string backend_group = 457777428; */ protected $backend_group = null; /** - * The network endpoint within the leader.backendGroup that is designated as the leader. This network endpoint cannot be detached from the NEG specified in the haPolicy.leader.backendGroup until the leader is updated with another network endpoint, or the leader is removed from the haPolicy. + * The network endpoint within the leader.backendGroup that is + * designated as the leader. + * This network endpoint cannot be detached from the NEG specified in + * the haPolicy.leader.backendGroup until the leader is updated with + * another network endpoint, or the leader is removed from the haPolicy. * * Generated from protobuf field optional .google.cloud.compute.v1.BackendServiceHAPolicyLeaderNetworkEndpoint network_endpoint = 56789126; */ @@ -34,9 +43,18 @@ class BackendServiceHAPolicyLeader extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $backend_group - * A fully-qualified URL (starting with https://www.googleapis.com/) of the zonal Network Endpoint Group (NEG) with `GCE_VM_IP` endpoints that the leader is attached to. The leader's backendGroup must already be specified as a backend of this backend service. Removing a backend that is designated as the leader's backendGroup is not permitted. + * A fully-qualified URL (starting with https://www.googleapis.com/) + * of the zonal Network Endpoint Group (NEG) with `GCE_VM_IP` endpoints + * that the leader is attached to. + * The leader's backendGroup must already be specified as a backend of + * this backend service. Removing a backend that is designated as the + * leader's backendGroup is not permitted. * @type \Google\Cloud\Compute\V1\BackendServiceHAPolicyLeaderNetworkEndpoint $network_endpoint - * The network endpoint within the leader.backendGroup that is designated as the leader. This network endpoint cannot be detached from the NEG specified in the haPolicy.leader.backendGroup until the leader is updated with another network endpoint, or the leader is removed from the haPolicy. + * The network endpoint within the leader.backendGroup that is + * designated as the leader. + * This network endpoint cannot be detached from the NEG specified in + * the haPolicy.leader.backendGroup until the leader is updated with + * another network endpoint, or the leader is removed from the haPolicy. * } */ public function __construct($data = NULL) { @@ -45,7 +63,12 @@ public function __construct($data = NULL) { } /** - * A fully-qualified URL (starting with https://www.googleapis.com/) of the zonal Network Endpoint Group (NEG) with `GCE_VM_IP` endpoints that the leader is attached to. The leader's backendGroup must already be specified as a backend of this backend service. Removing a backend that is designated as the leader's backendGroup is not permitted. + * A fully-qualified URL (starting with https://www.googleapis.com/) + * of the zonal Network Endpoint Group (NEG) with `GCE_VM_IP` endpoints + * that the leader is attached to. + * The leader's backendGroup must already be specified as a backend of + * this backend service. Removing a backend that is designated as the + * leader's backendGroup is not permitted. * * Generated from protobuf field optional string backend_group = 457777428; * @return string @@ -66,7 +89,12 @@ public function clearBackendGroup() } /** - * A fully-qualified URL (starting with https://www.googleapis.com/) of the zonal Network Endpoint Group (NEG) with `GCE_VM_IP` endpoints that the leader is attached to. The leader's backendGroup must already be specified as a backend of this backend service. Removing a backend that is designated as the leader's backendGroup is not permitted. + * A fully-qualified URL (starting with https://www.googleapis.com/) + * of the zonal Network Endpoint Group (NEG) with `GCE_VM_IP` endpoints + * that the leader is attached to. + * The leader's backendGroup must already be specified as a backend of + * this backend service. Removing a backend that is designated as the + * leader's backendGroup is not permitted. * * Generated from protobuf field optional string backend_group = 457777428; * @param string $var @@ -81,7 +109,11 @@ public function setBackendGroup($var) } /** - * The network endpoint within the leader.backendGroup that is designated as the leader. This network endpoint cannot be detached from the NEG specified in the haPolicy.leader.backendGroup until the leader is updated with another network endpoint, or the leader is removed from the haPolicy. + * The network endpoint within the leader.backendGroup that is + * designated as the leader. + * This network endpoint cannot be detached from the NEG specified in + * the haPolicy.leader.backendGroup until the leader is updated with + * another network endpoint, or the leader is removed from the haPolicy. * * Generated from protobuf field optional .google.cloud.compute.v1.BackendServiceHAPolicyLeaderNetworkEndpoint network_endpoint = 56789126; * @return \Google\Cloud\Compute\V1\BackendServiceHAPolicyLeaderNetworkEndpoint|null @@ -102,7 +134,11 @@ public function clearNetworkEndpoint() } /** - * The network endpoint within the leader.backendGroup that is designated as the leader. This network endpoint cannot be detached from the NEG specified in the haPolicy.leader.backendGroup until the leader is updated with another network endpoint, or the leader is removed from the haPolicy. + * The network endpoint within the leader.backendGroup that is + * designated as the leader. + * This network endpoint cannot be detached from the NEG specified in + * the haPolicy.leader.backendGroup until the leader is updated with + * another network endpoint, or the leader is removed from the haPolicy. * * Generated from protobuf field optional .google.cloud.compute.v1.BackendServiceHAPolicyLeaderNetworkEndpoint network_endpoint = 56789126; * @param \Google\Cloud\Compute\V1\BackendServiceHAPolicyLeaderNetworkEndpoint $var diff --git a/Compute/src/V1/BackendServiceHAPolicyLeaderNetworkEndpoint.php b/Compute/src/V1/BackendServiceHAPolicyLeaderNetworkEndpoint.php index 0044bcf2f691..4a5d1e2750e6 100644 --- a/Compute/src/V1/BackendServiceHAPolicyLeaderNetworkEndpoint.php +++ b/Compute/src/V1/BackendServiceHAPolicyLeaderNetworkEndpoint.php @@ -15,7 +15,12 @@ class BackendServiceHAPolicyLeaderNetworkEndpoint extends \Google\Protobuf\Internal\Message { /** - * The name of the VM instance of the leader network endpoint. The instance must already be attached to the NEG specified in the haPolicy.leader.backendGroup. The name must be 1-63 characters long, and comply with RFC1035. Authorization requires the following IAM permission on the specified resource instance: compute.instances.use + * The name of the VM instance of the leader network endpoint. The + * instance must already be attached to the NEG specified in the + * haPolicy.leader.backendGroup. + * The name must be 1-63 characters long, and comply with RFC1035. + * Authorization requires the following IAM permission on the + * specified resource instance: compute.instances.use * * Generated from protobuf field optional string instance = 18257045; */ @@ -28,7 +33,12 @@ class BackendServiceHAPolicyLeaderNetworkEndpoint extends \Google\Protobuf\Inter * Optional. Data for populating the Message object. * * @type string $instance - * The name of the VM instance of the leader network endpoint. The instance must already be attached to the NEG specified in the haPolicy.leader.backendGroup. The name must be 1-63 characters long, and comply with RFC1035. Authorization requires the following IAM permission on the specified resource instance: compute.instances.use + * The name of the VM instance of the leader network endpoint. The + * instance must already be attached to the NEG specified in the + * haPolicy.leader.backendGroup. + * The name must be 1-63 characters long, and comply with RFC1035. + * Authorization requires the following IAM permission on the + * specified resource instance: compute.instances.use * } */ public function __construct($data = NULL) { @@ -37,7 +47,12 @@ public function __construct($data = NULL) { } /** - * The name of the VM instance of the leader network endpoint. The instance must already be attached to the NEG specified in the haPolicy.leader.backendGroup. The name must be 1-63 characters long, and comply with RFC1035. Authorization requires the following IAM permission on the specified resource instance: compute.instances.use + * The name of the VM instance of the leader network endpoint. The + * instance must already be attached to the NEG specified in the + * haPolicy.leader.backendGroup. + * The name must be 1-63 characters long, and comply with RFC1035. + * Authorization requires the following IAM permission on the + * specified resource instance: compute.instances.use * * Generated from protobuf field optional string instance = 18257045; * @return string @@ -58,7 +73,12 @@ public function clearInstance() } /** - * The name of the VM instance of the leader network endpoint. The instance must already be attached to the NEG specified in the haPolicy.leader.backendGroup. The name must be 1-63 characters long, and comply with RFC1035. Authorization requires the following IAM permission on the specified resource instance: compute.instances.use + * The name of the VM instance of the leader network endpoint. The + * instance must already be attached to the NEG specified in the + * haPolicy.leader.backendGroup. + * The name must be 1-63 characters long, and comply with RFC1035. + * Authorization requires the following IAM permission on the + * specified resource instance: compute.instances.use * * Generated from protobuf field optional string instance = 18257045; * @param string $var diff --git a/Compute/src/V1/BackendServiceIAP.php b/Compute/src/V1/BackendServiceIAP.php index 025a9a5ac8d5..8acba5a9dfe2 100644 --- a/Compute/src/V1/BackendServiceIAP.php +++ b/Compute/src/V1/BackendServiceIAP.php @@ -16,7 +16,8 @@ class BackendServiceIAP extends \Google\Protobuf\Internal\Message { /** - * Whether the serving infrastructure will authenticate and authorize all incoming requests. + * Whether the serving infrastructure will authenticate and authorize all + * incoming requests. * * Generated from protobuf field optional bool enabled = 1018689; */ @@ -28,7 +29,11 @@ class BackendServiceIAP extends \Google\Protobuf\Internal\Message */ protected $oauth2_client_id = null; /** - * OAuth2 client secret to use for the authentication flow. For security reasons, this value cannot be retrieved via the API. Instead, the SHA-256 hash of the value is returned in the oauth2ClientSecretSha256 field. @InputOnly + * OAuth2 client secret to use for the authentication flow. + * For security reasons, this value cannot be retrieved via the API. + * Instead, the SHA-256 hash of the value is returned in the + * oauth2ClientSecretSha256 field. + * @InputOnly * * Generated from protobuf field optional string oauth2_client_secret = 50999520; */ @@ -47,11 +52,16 @@ class BackendServiceIAP extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type bool $enabled - * Whether the serving infrastructure will authenticate and authorize all incoming requests. + * Whether the serving infrastructure will authenticate and authorize all + * incoming requests. * @type string $oauth2_client_id * OAuth2 client ID to use for the authentication flow. * @type string $oauth2_client_secret - * OAuth2 client secret to use for the authentication flow. For security reasons, this value cannot be retrieved via the API. Instead, the SHA-256 hash of the value is returned in the oauth2ClientSecretSha256 field. @InputOnly + * OAuth2 client secret to use for the authentication flow. + * For security reasons, this value cannot be retrieved via the API. + * Instead, the SHA-256 hash of the value is returned in the + * oauth2ClientSecretSha256 field. + * @InputOnly * @type string $oauth2_client_secret_sha256 * [Output Only] SHA256 hash value for the field oauth2_client_secret above. * } @@ -62,7 +72,8 @@ public function __construct($data = NULL) { } /** - * Whether the serving infrastructure will authenticate and authorize all incoming requests. + * Whether the serving infrastructure will authenticate and authorize all + * incoming requests. * * Generated from protobuf field optional bool enabled = 1018689; * @return bool @@ -83,7 +94,8 @@ public function clearEnabled() } /** - * Whether the serving infrastructure will authenticate and authorize all incoming requests. + * Whether the serving infrastructure will authenticate and authorize all + * incoming requests. * * Generated from protobuf field optional bool enabled = 1018689; * @param bool $var @@ -134,7 +146,11 @@ public function setOauth2ClientId($var) } /** - * OAuth2 client secret to use for the authentication flow. For security reasons, this value cannot be retrieved via the API. Instead, the SHA-256 hash of the value is returned in the oauth2ClientSecretSha256 field. @InputOnly + * OAuth2 client secret to use for the authentication flow. + * For security reasons, this value cannot be retrieved via the API. + * Instead, the SHA-256 hash of the value is returned in the + * oauth2ClientSecretSha256 field. + * @InputOnly * * Generated from protobuf field optional string oauth2_client_secret = 50999520; * @return string @@ -155,7 +171,11 @@ public function clearOauth2ClientSecret() } /** - * OAuth2 client secret to use for the authentication flow. For security reasons, this value cannot be retrieved via the API. Instead, the SHA-256 hash of the value is returned in the oauth2ClientSecretSha256 field. @InputOnly + * OAuth2 client secret to use for the authentication flow. + * For security reasons, this value cannot be retrieved via the API. + * Instead, the SHA-256 hash of the value is returned in the + * oauth2ClientSecretSha256 field. + * @InputOnly * * Generated from protobuf field optional string oauth2_client_secret = 50999520; * @param string $var diff --git a/Compute/src/V1/BackendServiceList.php b/Compute/src/V1/BackendServiceList.php index 3cda4ee81652..85728c6425dd 100644 --- a/Compute/src/V1/BackendServiceList.php +++ b/Compute/src/V1/BackendServiceList.php @@ -28,13 +28,17 @@ class BackendServiceList extends \Google\Protobuf\Internal\Message */ private $items; /** - * [Output Only] Type of resource. Always compute#backendServiceList for lists of backend services. + * [Output Only] Type of resource. Alwayscompute#backendServiceList for lists of backend services. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -63,9 +67,13 @@ class BackendServiceList extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\BackendService>|\Google\Protobuf\Internal\RepeatedField $items * A list of BackendService resources. * @type string $kind - * [Output Only] Type of resource. Always compute#backendServiceList for lists of backend services. + * [Output Only] Type of resource. Alwayscompute#backendServiceList for lists of backend services. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type \Google\Cloud\Compute\V1\Warning $warning @@ -140,7 +148,7 @@ public function setItems($var) } /** - * [Output Only] Type of resource. Always compute#backendServiceList for lists of backend services. + * [Output Only] Type of resource. Alwayscompute#backendServiceList for lists of backend services. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -161,7 +169,7 @@ public function clearKind() } /** - * [Output Only] Type of resource. Always compute#backendServiceList for lists of backend services. + * [Output Only] Type of resource. Alwayscompute#backendServiceList for lists of backend services. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -176,7 +184,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -197,7 +209,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/BackendServiceListUsable.php b/Compute/src/V1/BackendServiceListUsable.php index 3cc7c05f4e11..f3be79125e9b 100644 --- a/Compute/src/V1/BackendServiceListUsable.php +++ b/Compute/src/V1/BackendServiceListUsable.php @@ -28,13 +28,18 @@ class BackendServiceListUsable extends \Google\Protobuf\Internal\Message */ private $items; /** - * [Output Only] Type of resource. Always compute#usableBackendServiceList for lists of usable backend services. + * [Output Only] Type of resource. Alwayscompute#usableBackendServiceList for lists of usable backend + * services. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -63,9 +68,14 @@ class BackendServiceListUsable extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\BackendService>|\Google\Protobuf\Internal\RepeatedField $items * A list of BackendService resources. * @type string $kind - * [Output Only] Type of resource. Always compute#usableBackendServiceList for lists of usable backend services. + * [Output Only] Type of resource. Alwayscompute#usableBackendServiceList for lists of usable backend + * services. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type \Google\Cloud\Compute\V1\Warning $warning @@ -140,7 +150,8 @@ public function setItems($var) } /** - * [Output Only] Type of resource. Always compute#usableBackendServiceList for lists of usable backend services. + * [Output Only] Type of resource. Alwayscompute#usableBackendServiceList for lists of usable backend + * services. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -161,7 +172,8 @@ public function clearKind() } /** - * [Output Only] Type of resource. Always compute#usableBackendServiceList for lists of usable backend services. + * [Output Only] Type of resource. Alwayscompute#usableBackendServiceList for lists of usable backend + * services. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -176,7 +188,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -197,7 +213,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/BackendServiceLocalityLoadBalancingPolicyConfig.php b/Compute/src/V1/BackendServiceLocalityLoadBalancingPolicyConfig.php index bbf1f1c9ebe0..bff035411e73 100644 --- a/Compute/src/V1/BackendServiceLocalityLoadBalancingPolicyConfig.php +++ b/Compute/src/V1/BackendServiceLocalityLoadBalancingPolicyConfig.php @@ -9,7 +9,8 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Container for either a built-in LB policy supported by gRPC or Envoy or a custom one implemented by the end user. + * Container for either a built-in LB policy supported by gRPC or Envoy or + * a custom one implemented by the end user. * * Generated from protobuf message google.cloud.compute.v1.BackendServiceLocalityLoadBalancingPolicyConfig */ diff --git a/Compute/src/V1/BackendServiceLocalityLoadBalancingPolicyConfigCustomPolicy.php b/Compute/src/V1/BackendServiceLocalityLoadBalancingPolicyConfigCustomPolicy.php index d3e4339a3dde..f6333c105901 100644 --- a/Compute/src/V1/BackendServiceLocalityLoadBalancingPolicyConfigCustomPolicy.php +++ b/Compute/src/V1/BackendServiceLocalityLoadBalancingPolicyConfigCustomPolicy.php @@ -9,20 +9,30 @@ use Google\Protobuf\Internal\GPBUtil; /** - * The configuration for a custom policy implemented by the user and deployed with the client. + * The configuration for a custom policy implemented by the user and + * deployed with the client. * * Generated from protobuf message google.cloud.compute.v1.BackendServiceLocalityLoadBalancingPolicyConfigCustomPolicy */ class BackendServiceLocalityLoadBalancingPolicyConfigCustomPolicy extends \Google\Protobuf\Internal\Message { /** - * An optional, arbitrary JSON object with configuration data, understood by a locally installed custom policy implementation. + * An optional, arbitrary JSON object with configuration data, understood + * by a locally installed custom policy implementation. * * Generated from protobuf field optional string data = 3076010; */ protected $data = null; /** - * Identifies the custom policy. The value should match the name of a custom implementation registered on the gRPC clients. It should follow protocol buffer message naming conventions and include the full path (for example, myorg.CustomLbPolicy). The maximum length is 256 characters. Do not specify the same custom policy more than once for a backend. If you do, the configuration is rejected. For an example of how to use this field, see Use a custom policy. + * Identifies the custom policy. + * The value should match the name of a custom implementation registered + * on the gRPC clients. It should follow protocol buffer message naming + * conventions and include the full path (for example, + * myorg.CustomLbPolicy). The maximum length is 256 characters. + * Do not specify the same custom policy more than once for a + * backend. If you do, the configuration is rejected. + * For an example of how to use this field, seeUse + * a custom policy. * * Generated from protobuf field optional string name = 3373707; */ @@ -35,9 +45,18 @@ class BackendServiceLocalityLoadBalancingPolicyConfigCustomPolicy extends \Googl * Optional. Data for populating the Message object. * * @type string $data - * An optional, arbitrary JSON object with configuration data, understood by a locally installed custom policy implementation. + * An optional, arbitrary JSON object with configuration data, understood + * by a locally installed custom policy implementation. * @type string $name - * Identifies the custom policy. The value should match the name of a custom implementation registered on the gRPC clients. It should follow protocol buffer message naming conventions and include the full path (for example, myorg.CustomLbPolicy). The maximum length is 256 characters. Do not specify the same custom policy more than once for a backend. If you do, the configuration is rejected. For an example of how to use this field, see Use a custom policy. + * Identifies the custom policy. + * The value should match the name of a custom implementation registered + * on the gRPC clients. It should follow protocol buffer message naming + * conventions and include the full path (for example, + * myorg.CustomLbPolicy). The maximum length is 256 characters. + * Do not specify the same custom policy more than once for a + * backend. If you do, the configuration is rejected. + * For an example of how to use this field, seeUse + * a custom policy. * } */ public function __construct($data = NULL) { @@ -46,7 +65,8 @@ public function __construct($data = NULL) { } /** - * An optional, arbitrary JSON object with configuration data, understood by a locally installed custom policy implementation. + * An optional, arbitrary JSON object with configuration data, understood + * by a locally installed custom policy implementation. * * Generated from protobuf field optional string data = 3076010; * @return string @@ -67,7 +87,8 @@ public function clearData() } /** - * An optional, arbitrary JSON object with configuration data, understood by a locally installed custom policy implementation. + * An optional, arbitrary JSON object with configuration data, understood + * by a locally installed custom policy implementation. * * Generated from protobuf field optional string data = 3076010; * @param string $var @@ -82,7 +103,15 @@ public function setData($var) } /** - * Identifies the custom policy. The value should match the name of a custom implementation registered on the gRPC clients. It should follow protocol buffer message naming conventions and include the full path (for example, myorg.CustomLbPolicy). The maximum length is 256 characters. Do not specify the same custom policy more than once for a backend. If you do, the configuration is rejected. For an example of how to use this field, see Use a custom policy. + * Identifies the custom policy. + * The value should match the name of a custom implementation registered + * on the gRPC clients. It should follow protocol buffer message naming + * conventions and include the full path (for example, + * myorg.CustomLbPolicy). The maximum length is 256 characters. + * Do not specify the same custom policy more than once for a + * backend. If you do, the configuration is rejected. + * For an example of how to use this field, seeUse + * a custom policy. * * Generated from protobuf field optional string name = 3373707; * @return string @@ -103,7 +132,15 @@ public function clearName() } /** - * Identifies the custom policy. The value should match the name of a custom implementation registered on the gRPC clients. It should follow protocol buffer message naming conventions and include the full path (for example, myorg.CustomLbPolicy). The maximum length is 256 characters. Do not specify the same custom policy more than once for a backend. If you do, the configuration is rejected. For an example of how to use this field, see Use a custom policy. + * Identifies the custom policy. + * The value should match the name of a custom implementation registered + * on the gRPC clients. It should follow protocol buffer message naming + * conventions and include the full path (for example, + * myorg.CustomLbPolicy). The maximum length is 256 characters. + * Do not specify the same custom policy more than once for a + * backend. If you do, the configuration is rejected. + * For an example of how to use this field, seeUse + * a custom policy. * * Generated from protobuf field optional string name = 3373707; * @param string $var diff --git a/Compute/src/V1/BackendServiceLocalityLoadBalancingPolicyConfigPolicy.php b/Compute/src/V1/BackendServiceLocalityLoadBalancingPolicyConfigPolicy.php index 11d2d4197429..7894a9809ba6 100644 --- a/Compute/src/V1/BackendServiceLocalityLoadBalancingPolicyConfigPolicy.php +++ b/Compute/src/V1/BackendServiceLocalityLoadBalancingPolicyConfigPolicy.php @@ -16,7 +16,11 @@ class BackendServiceLocalityLoadBalancingPolicyConfigPolicy extends \Google\Protobuf\Internal\Message { /** - * The name of a locality load-balancing policy. Valid values include ROUND_ROBIN and, for Java clients, LEAST_REQUEST. For information about these values, see the description of localityLbPolicy. Do not specify the same policy more than once for a backend. If you do, the configuration is rejected. + * The name of a locality load-balancing policy. Valid values include + * ROUND_ROBIN and, for Java clients, LEAST_REQUEST. For information + * about these values, see the description of localityLbPolicy. + * Do not specify the same policy more than once for a + * backend. If you do, the configuration is rejected. * Check the Name enum for the list of possible values. * * Generated from protobuf field optional string name = 3373707; @@ -30,7 +34,11 @@ class BackendServiceLocalityLoadBalancingPolicyConfigPolicy extends \Google\Prot * Optional. Data for populating the Message object. * * @type string $name - * The name of a locality load-balancing policy. Valid values include ROUND_ROBIN and, for Java clients, LEAST_REQUEST. For information about these values, see the description of localityLbPolicy. Do not specify the same policy more than once for a backend. If you do, the configuration is rejected. + * The name of a locality load-balancing policy. Valid values include + * ROUND_ROBIN and, for Java clients, LEAST_REQUEST. For information + * about these values, see the description of localityLbPolicy. + * Do not specify the same policy more than once for a + * backend. If you do, the configuration is rejected. * Check the Name enum for the list of possible values. * } */ @@ -40,7 +48,11 @@ public function __construct($data = NULL) { } /** - * The name of a locality load-balancing policy. Valid values include ROUND_ROBIN and, for Java clients, LEAST_REQUEST. For information about these values, see the description of localityLbPolicy. Do not specify the same policy more than once for a backend. If you do, the configuration is rejected. + * The name of a locality load-balancing policy. Valid values include + * ROUND_ROBIN and, for Java clients, LEAST_REQUEST. For information + * about these values, see the description of localityLbPolicy. + * Do not specify the same policy more than once for a + * backend. If you do, the configuration is rejected. * Check the Name enum for the list of possible values. * * Generated from protobuf field optional string name = 3373707; @@ -62,7 +74,11 @@ public function clearName() } /** - * The name of a locality load-balancing policy. Valid values include ROUND_ROBIN and, for Java clients, LEAST_REQUEST. For information about these values, see the description of localityLbPolicy. Do not specify the same policy more than once for a backend. If you do, the configuration is rejected. + * The name of a locality load-balancing policy. Valid values include + * ROUND_ROBIN and, for Java clients, LEAST_REQUEST. For information + * about these values, see the description of localityLbPolicy. + * Do not specify the same policy more than once for a + * backend. If you do, the configuration is rejected. * Check the Name enum for the list of possible values. * * Generated from protobuf field optional string name = 3373707; diff --git a/Compute/src/V1/BackendServiceLocalityLoadBalancingPolicyConfigPolicy/Name.php b/Compute/src/V1/BackendServiceLocalityLoadBalancingPolicyConfigPolicy/Name.php index d056a346a2f9..f0858d2dff4c 100644 --- a/Compute/src/V1/BackendServiceLocalityLoadBalancingPolicyConfigPolicy/Name.php +++ b/Compute/src/V1/BackendServiceLocalityLoadBalancingPolicyConfigPolicy/Name.php @@ -7,7 +7,11 @@ use UnexpectedValueException; /** - * The name of a locality load-balancing policy. Valid values include ROUND_ROBIN and, for Java clients, LEAST_REQUEST. For information about these values, see the description of localityLbPolicy. Do not specify the same policy more than once for a backend. If you do, the configuration is rejected. + * The name of a locality load-balancing policy. Valid values include + * ROUND_ROBIN and, for Java clients, LEAST_REQUEST. For information + * about these values, see the description of localityLbPolicy. + * Do not specify the same policy more than once for a + * backend. If you do, the configuration is rejected. * * Protobuf type google.cloud.compute.v1.BackendServiceLocalityLoadBalancingPolicyConfigPolicy.Name */ @@ -24,19 +28,27 @@ class Name */ const INVALID_LB_POLICY = 323318707; /** - * An O(1) algorithm which selects two random healthy hosts and picks the host which has fewer active requests. + * An O(1) algorithm which selects two random healthy hosts and + * picks the host which has fewer active requests. * * Generated from protobuf enum LEAST_REQUEST = 46604921; */ const LEAST_REQUEST = 46604921; /** - * This algorithm implements consistent hashing to backends. Maglev can be used as a drop in replacement for the ring hash load balancer. Maglev is not as stable as ring hash but has faster table lookup build times and host selection times. For more information about Maglev, see Maglev: A Fast and Reliable Software Network Load Balancer. + * This algorithm implements consistent hashing to backends. Maglev can be + * used as a drop in replacement for the ring hash load balancer. Maglev is + * not as stable as ring hash but has faster table lookup build times and + * host selection times. For more information about Maglev, seeMaglev: + * A Fast and Reliable Software Network Load Balancer. * * Generated from protobuf enum MAGLEV = 119180266; */ const MAGLEV = 119180266; /** - * Backend host is selected based on the client connection metadata, i.e., connections are opened to the same address as the destination address of the incoming connection before the connection was redirected to the load balancer. + * Backend host is selected based on the client connection metadata, i.e., + * connections are opened to the same address as the destination address of + * the incoming connection before the connection was redirected to the load + * balancer. * * Generated from protobuf enum ORIGINAL_DESTINATION = 166297216; */ @@ -48,31 +60,52 @@ class Name */ const RANDOM = 262527171; /** - * The ring/modulo hash load balancer implements consistent hashing to backends. The algorithm has the property that the addition/removal of a host from a set of N hosts only affects 1/N of the requests. + * The ring/modulo hash load balancer implements consistent hashing to + * backends. The algorithm has the property that the addition/removal + * of a host from a set of N hosts only affects 1/N of the requests. * * Generated from protobuf enum RING_HASH = 432795069; */ const RING_HASH = 432795069; /** - * This is a simple policy in which each healthy backend is selected in round robin order. This is the default. + * This is a simple policy in which each healthy backend is selected + * in round robin order. This is the default. * * Generated from protobuf enum ROUND_ROBIN = 153895801; */ const ROUND_ROBIN = 153895801; /** - * Per-instance weighted Load Balancing via health check reported weights. In internal passthrough network load balancing, it is weighted rendezvous hashing. This option is only supported in internal passthrough network load balancing. + * Per-instance weighted Load Balancing via health check reported weights. + * In internal passthrough network load balancing, it is weighted + * rendezvous hashing. + * This option is only supported in internal passthrough network load + * balancing. * * Generated from protobuf enum WEIGHTED_GCP_RENDEZVOUS = 82501640; */ const WEIGHTED_GCP_RENDEZVOUS = 82501640; /** - * Per-instance weighted Load Balancing via health check reported weights. If set, the Backend Service must configure a non legacy HTTP-based Health Check, and health check replies are expected to contain non-standard HTTP response header field X-Load-Balancing-Endpoint-Weight to specify the per-instance weights. If set, Load Balancing is weighted based on the per-instance weights reported in the last processed health check replies, as long as every instance either reported a valid weight or had UNAVAILABLE_WEIGHT. Otherwise, Load Balancing remains equal-weight. This option is only supported in Network Load Balancing. + * Per-instance weighted Load Balancing via health check reported weights. + * If set, the Backend Service must configure a non legacy HTTP-based Health + * Check, and health check replies are expected to contain non-standard HTTP + * response header field X-Load-Balancing-Endpoint-Weight to specify the + * per-instance weights. + * If set, Load Balancing is weighted based on the + * per-instance weights reported in the last processed health check replies, + * as long as every instance either reported a valid weight or had + * UNAVAILABLE_WEIGHT. Otherwise, Load Balancing remains equal-weight. + * This option is only supported in Network Load Balancing. * * Generated from protobuf enum WEIGHTED_MAGLEV = 254930962; */ const WEIGHTED_MAGLEV = 254930962; /** - * Per-endpoint weighted round-robin Load Balancing using weights computed from Backend reported Custom Metrics. If set, the Backend Service responses are expected to contain non-standard HTTP response header field Endpoint-Load-Metrics. The reported metrics to use for computing the weights are specified via the customMetrics fields. + * Per-endpoint weighted round-robin Load Balancing using weights computed + * from Backend reported Custom Metrics. If set, the Backend Service + * responses are expected to contain non-standard HTTP response header field + * Endpoint-Load-Metrics. The reported metrics + * to use for computing the weights are specified via the + * customMetrics fields. * * Generated from protobuf enum WEIGHTED_ROUND_ROBIN = 5584977; */ diff --git a/Compute/src/V1/BackendServiceLogConfig.php b/Compute/src/V1/BackendServiceLogConfig.php index fd676ea5fa12..4ab2d7b4b20b 100644 --- a/Compute/src/V1/BackendServiceLogConfig.php +++ b/Compute/src/V1/BackendServiceLogConfig.php @@ -9,33 +9,46 @@ use Google\Protobuf\Internal\GPBUtil; /** - * The available logging options for the load balancer traffic served by this backend service. + * The available logging options for the load balancer traffic served by this + * backend service. * * Generated from protobuf message google.cloud.compute.v1.BackendServiceLogConfig */ class BackendServiceLogConfig extends \Google\Protobuf\Internal\Message { /** - * Denotes whether to enable logging for the load balancer traffic served by this backend service. The default value is false. + * Denotes whether to enable logging for the load balancer + * traffic served by this backend service. The default value is false. * * Generated from protobuf field optional bool enable = 311764355; */ protected $enable = null; /** - * This field can only be specified if logging is enabled for this backend service and "logConfig.optionalMode" was set to CUSTOM. Contains a list of optional fields you want to include in the logs. For example: serverInstance, serverGkeDetails.cluster, serverGkeDetails.pod.podNamespace + * This field can only be specified if logging is enabled for this backend + * service and "logConfig.optionalMode" was set to CUSTOM. Contains a list + * of optional fields you want to include in the logs. For example: + * serverInstance, serverGkeDetails.cluster, + * serverGkeDetails.pod.podNamespace * * Generated from protobuf field repeated string optional_fields = 528589944; */ private $optional_fields; /** - * This field can only be specified if logging is enabled for this backend service. Configures whether all, none or a subset of optional fields should be added to the reported logs. One of [INCLUDE_ALL_OPTIONAL, EXCLUDE_ALL_OPTIONAL, CUSTOM]. Default is EXCLUDE_ALL_OPTIONAL. + * This field can only be specified if logging is enabled for this backend + * service. Configures whether all, none or a subset of optional fields + * should be added to the reported logs. One of [INCLUDE_ALL_OPTIONAL, + * EXCLUDE_ALL_OPTIONAL, CUSTOM]. Default is EXCLUDE_ALL_OPTIONAL. * Check the OptionalMode enum for the list of possible values. * * Generated from protobuf field optional string optional_mode = 128697122; */ protected $optional_mode = null; /** - * This field can only be specified if logging is enabled for this backend service. The value of the field must be in [0, 1]. This configures the sampling rate of requests to the load balancer where 1.0 means all logged requests are reported and 0.0 means no logged requests are reported. The default value is 1.0. + * This field can only be specified if logging is enabled for this backend + * service. The value of the field must be in [0, 1]. This configures the + * sampling rate of requests to the load balancer where 1.0 means all logged + * requests are reported and 0.0 means no logged requests are reported. The + * default value is 1.0. * * Generated from protobuf field optional float sample_rate = 153193045; */ @@ -48,14 +61,26 @@ class BackendServiceLogConfig extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type bool $enable - * Denotes whether to enable logging for the load balancer traffic served by this backend service. The default value is false. + * Denotes whether to enable logging for the load balancer + * traffic served by this backend service. The default value is false. * @type array|\Google\Protobuf\Internal\RepeatedField $optional_fields - * This field can only be specified if logging is enabled for this backend service and "logConfig.optionalMode" was set to CUSTOM. Contains a list of optional fields you want to include in the logs. For example: serverInstance, serverGkeDetails.cluster, serverGkeDetails.pod.podNamespace + * This field can only be specified if logging is enabled for this backend + * service and "logConfig.optionalMode" was set to CUSTOM. Contains a list + * of optional fields you want to include in the logs. For example: + * serverInstance, serverGkeDetails.cluster, + * serverGkeDetails.pod.podNamespace * @type string $optional_mode - * This field can only be specified if logging is enabled for this backend service. Configures whether all, none or a subset of optional fields should be added to the reported logs. One of [INCLUDE_ALL_OPTIONAL, EXCLUDE_ALL_OPTIONAL, CUSTOM]. Default is EXCLUDE_ALL_OPTIONAL. + * This field can only be specified if logging is enabled for this backend + * service. Configures whether all, none or a subset of optional fields + * should be added to the reported logs. One of [INCLUDE_ALL_OPTIONAL, + * EXCLUDE_ALL_OPTIONAL, CUSTOM]. Default is EXCLUDE_ALL_OPTIONAL. * Check the OptionalMode enum for the list of possible values. * @type float $sample_rate - * This field can only be specified if logging is enabled for this backend service. The value of the field must be in [0, 1]. This configures the sampling rate of requests to the load balancer where 1.0 means all logged requests are reported and 0.0 means no logged requests are reported. The default value is 1.0. + * This field can only be specified if logging is enabled for this backend + * service. The value of the field must be in [0, 1]. This configures the + * sampling rate of requests to the load balancer where 1.0 means all logged + * requests are reported and 0.0 means no logged requests are reported. The + * default value is 1.0. * } */ public function __construct($data = NULL) { @@ -64,7 +89,8 @@ public function __construct($data = NULL) { } /** - * Denotes whether to enable logging for the load balancer traffic served by this backend service. The default value is false. + * Denotes whether to enable logging for the load balancer + * traffic served by this backend service. The default value is false. * * Generated from protobuf field optional bool enable = 311764355; * @return bool @@ -85,7 +111,8 @@ public function clearEnable() } /** - * Denotes whether to enable logging for the load balancer traffic served by this backend service. The default value is false. + * Denotes whether to enable logging for the load balancer + * traffic served by this backend service. The default value is false. * * Generated from protobuf field optional bool enable = 311764355; * @param bool $var @@ -100,7 +127,11 @@ public function setEnable($var) } /** - * This field can only be specified if logging is enabled for this backend service and "logConfig.optionalMode" was set to CUSTOM. Contains a list of optional fields you want to include in the logs. For example: serverInstance, serverGkeDetails.cluster, serverGkeDetails.pod.podNamespace + * This field can only be specified if logging is enabled for this backend + * service and "logConfig.optionalMode" was set to CUSTOM. Contains a list + * of optional fields you want to include in the logs. For example: + * serverInstance, serverGkeDetails.cluster, + * serverGkeDetails.pod.podNamespace * * Generated from protobuf field repeated string optional_fields = 528589944; * @return \Google\Protobuf\Internal\RepeatedField @@ -111,7 +142,11 @@ public function getOptionalFields() } /** - * This field can only be specified if logging is enabled for this backend service and "logConfig.optionalMode" was set to CUSTOM. Contains a list of optional fields you want to include in the logs. For example: serverInstance, serverGkeDetails.cluster, serverGkeDetails.pod.podNamespace + * This field can only be specified if logging is enabled for this backend + * service and "logConfig.optionalMode" was set to CUSTOM. Contains a list + * of optional fields you want to include in the logs. For example: + * serverInstance, serverGkeDetails.cluster, + * serverGkeDetails.pod.podNamespace * * Generated from protobuf field repeated string optional_fields = 528589944; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -126,7 +161,10 @@ public function setOptionalFields($var) } /** - * This field can only be specified if logging is enabled for this backend service. Configures whether all, none or a subset of optional fields should be added to the reported logs. One of [INCLUDE_ALL_OPTIONAL, EXCLUDE_ALL_OPTIONAL, CUSTOM]. Default is EXCLUDE_ALL_OPTIONAL. + * This field can only be specified if logging is enabled for this backend + * service. Configures whether all, none or a subset of optional fields + * should be added to the reported logs. One of [INCLUDE_ALL_OPTIONAL, + * EXCLUDE_ALL_OPTIONAL, CUSTOM]. Default is EXCLUDE_ALL_OPTIONAL. * Check the OptionalMode enum for the list of possible values. * * Generated from protobuf field optional string optional_mode = 128697122; @@ -148,7 +186,10 @@ public function clearOptionalMode() } /** - * This field can only be specified if logging is enabled for this backend service. Configures whether all, none or a subset of optional fields should be added to the reported logs. One of [INCLUDE_ALL_OPTIONAL, EXCLUDE_ALL_OPTIONAL, CUSTOM]. Default is EXCLUDE_ALL_OPTIONAL. + * This field can only be specified if logging is enabled for this backend + * service. Configures whether all, none or a subset of optional fields + * should be added to the reported logs. One of [INCLUDE_ALL_OPTIONAL, + * EXCLUDE_ALL_OPTIONAL, CUSTOM]. Default is EXCLUDE_ALL_OPTIONAL. * Check the OptionalMode enum for the list of possible values. * * Generated from protobuf field optional string optional_mode = 128697122; @@ -164,7 +205,11 @@ public function setOptionalMode($var) } /** - * This field can only be specified if logging is enabled for this backend service. The value of the field must be in [0, 1]. This configures the sampling rate of requests to the load balancer where 1.0 means all logged requests are reported and 0.0 means no logged requests are reported. The default value is 1.0. + * This field can only be specified if logging is enabled for this backend + * service. The value of the field must be in [0, 1]. This configures the + * sampling rate of requests to the load balancer where 1.0 means all logged + * requests are reported and 0.0 means no logged requests are reported. The + * default value is 1.0. * * Generated from protobuf field optional float sample_rate = 153193045; * @return float @@ -185,7 +230,11 @@ public function clearSampleRate() } /** - * This field can only be specified if logging is enabled for this backend service. The value of the field must be in [0, 1]. This configures the sampling rate of requests to the load balancer where 1.0 means all logged requests are reported and 0.0 means no logged requests are reported. The default value is 1.0. + * This field can only be specified if logging is enabled for this backend + * service. The value of the field must be in [0, 1]. This configures the + * sampling rate of requests to the load balancer where 1.0 means all logged + * requests are reported and 0.0 means no logged requests are reported. The + * default value is 1.0. * * Generated from protobuf field optional float sample_rate = 153193045; * @param float $var diff --git a/Compute/src/V1/BackendServiceLogConfig/OptionalMode.php b/Compute/src/V1/BackendServiceLogConfig/OptionalMode.php index cd0c5670bc65..f7de302f1fae 100644 --- a/Compute/src/V1/BackendServiceLogConfig/OptionalMode.php +++ b/Compute/src/V1/BackendServiceLogConfig/OptionalMode.php @@ -7,7 +7,10 @@ use UnexpectedValueException; /** - * This field can only be specified if logging is enabled for this backend service. Configures whether all, none or a subset of optional fields should be added to the reported logs. One of [INCLUDE_ALL_OPTIONAL, EXCLUDE_ALL_OPTIONAL, CUSTOM]. Default is EXCLUDE_ALL_OPTIONAL. + * This field can only be specified if logging is enabled for this backend + * service. Configures whether all, none or a subset of optional fields + * should be added to the reported logs. One of [INCLUDE_ALL_OPTIONAL, + * EXCLUDE_ALL_OPTIONAL, CUSTOM]. Default is EXCLUDE_ALL_OPTIONAL. * * Protobuf type google.cloud.compute.v1.BackendServiceLogConfig.OptionalMode */ diff --git a/Compute/src/V1/BackendServiceParams.php b/Compute/src/V1/BackendServiceParams.php index b02c51fa949d..990b58d41918 100644 --- a/Compute/src/V1/BackendServiceParams.php +++ b/Compute/src/V1/BackendServiceParams.php @@ -16,7 +16,18 @@ class BackendServiceParams extends \Google\Protobuf\Internal\Message { /** - * Tag keys/values directly bound to this resource. Tag keys and values have the same definition as resource manager tags. The field is allowed for INSERT only. The keys/values to set on the resource should be specified in either ID { : } or Namespaced format { : }. For example the following are valid inputs: * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} * {"123/environment" : "production", "345/abc" : "xyz"} Note: * Invalid combinations of ID & namespaced format is not supported. For instance: {"123/environment" : "tagValues/444"} is invalid. + * Tag keys/values directly bound to this resource. + * Tag keys and values have the same definition as resource + * manager tags. The field is allowed for INSERT + * only. The keys/values to set on the resource should be specified in + * either ID { : } or Namespaced format + * { : }. + * For example the following are valid inputs: + * * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} + * * {"123/environment" : "production", "345/abc" : "xyz"} + * Note: + * * Invalid combinations of ID & namespaced format is not supported. For + * instance: {"123/environment" : "tagValues/444"} is invalid. * * Generated from protobuf field map resource_manager_tags = 377671164; */ @@ -29,7 +40,18 @@ class BackendServiceParams extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type array|\Google\Protobuf\Internal\MapField $resource_manager_tags - * Tag keys/values directly bound to this resource. Tag keys and values have the same definition as resource manager tags. The field is allowed for INSERT only. The keys/values to set on the resource should be specified in either ID { : } or Namespaced format { : }. For example the following are valid inputs: * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} * {"123/environment" : "production", "345/abc" : "xyz"} Note: * Invalid combinations of ID & namespaced format is not supported. For instance: {"123/environment" : "tagValues/444"} is invalid. + * Tag keys/values directly bound to this resource. + * Tag keys and values have the same definition as resource + * manager tags. The field is allowed for INSERT + * only. The keys/values to set on the resource should be specified in + * either ID { : } or Namespaced format + * { : }. + * For example the following are valid inputs: + * * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} + * * {"123/environment" : "production", "345/abc" : "xyz"} + * Note: + * * Invalid combinations of ID & namespaced format is not supported. For + * instance: {"123/environment" : "tagValues/444"} is invalid. * } */ public function __construct($data = NULL) { @@ -38,7 +60,18 @@ public function __construct($data = NULL) { } /** - * Tag keys/values directly bound to this resource. Tag keys and values have the same definition as resource manager tags. The field is allowed for INSERT only. The keys/values to set on the resource should be specified in either ID { : } or Namespaced format { : }. For example the following are valid inputs: * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} * {"123/environment" : "production", "345/abc" : "xyz"} Note: * Invalid combinations of ID & namespaced format is not supported. For instance: {"123/environment" : "tagValues/444"} is invalid. + * Tag keys/values directly bound to this resource. + * Tag keys and values have the same definition as resource + * manager tags. The field is allowed for INSERT + * only. The keys/values to set on the resource should be specified in + * either ID { : } or Namespaced format + * { : }. + * For example the following are valid inputs: + * * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} + * * {"123/environment" : "production", "345/abc" : "xyz"} + * Note: + * * Invalid combinations of ID & namespaced format is not supported. For + * instance: {"123/environment" : "tagValues/444"} is invalid. * * Generated from protobuf field map resource_manager_tags = 377671164; * @return \Google\Protobuf\Internal\MapField @@ -49,7 +82,18 @@ public function getResourceManagerTags() } /** - * Tag keys/values directly bound to this resource. Tag keys and values have the same definition as resource manager tags. The field is allowed for INSERT only. The keys/values to set on the resource should be specified in either ID { : } or Namespaced format { : }. For example the following are valid inputs: * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} * {"123/environment" : "production", "345/abc" : "xyz"} Note: * Invalid combinations of ID & namespaced format is not supported. For instance: {"123/environment" : "tagValues/444"} is invalid. + * Tag keys/values directly bound to this resource. + * Tag keys and values have the same definition as resource + * manager tags. The field is allowed for INSERT + * only. The keys/values to set on the resource should be specified in + * either ID { : } or Namespaced format + * { : }. + * For example the following are valid inputs: + * * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} + * * {"123/environment" : "production", "345/abc" : "xyz"} + * Note: + * * Invalid combinations of ID & namespaced format is not supported. For + * instance: {"123/environment" : "tagValues/444"} is invalid. * * Generated from protobuf field map resource_manager_tags = 377671164; * @param array|\Google\Protobuf\Internal\MapField $var diff --git a/Compute/src/V1/BackendServiceTlsSettings.php b/Compute/src/V1/BackendServiceTlsSettings.php index 00ddb7919943..01a67e6ba740 100644 --- a/Compute/src/V1/BackendServiceTlsSettings.php +++ b/Compute/src/V1/BackendServiceTlsSettings.php @@ -15,19 +15,36 @@ class BackendServiceTlsSettings extends \Google\Protobuf\Internal\Message { /** - * Reference to the BackendAuthenticationConfig resource from the networksecurity.googleapis.com namespace. Can be used in authenticating TLS connections to the backend, as specified by the authenticationMode field. Can only be specified if authenticationMode is not NONE. + * Reference to the BackendAuthenticationConfig resource from the + * networksecurity.googleapis.com namespace. Can be used in authenticating + * TLS connections to the backend, as specified by the authenticationMode + * field. Can only be specified if authenticationMode is not NONE. * * Generated from protobuf field optional string authentication_config = 408053481; */ protected $authentication_config = null; /** - * Server Name Indication - see RFC3546 section 3.1. If set, the load balancer sends this string as the SNI hostname in the TLS connection to the backend, and requires that this string match a Subject Alternative Name (SAN) in the backend's server certificate. With a Regional Internet NEG backend, if the SNI is specified here, the load balancer uses it regardless of whether the Regional Internet NEG is specified with FQDN or IP address and port. When both sni and subjectAltNames[] are specified, the load balancer matches the backend certificate's SAN only to subjectAltNames[]. + * Server Name Indication - see RFC3546 section 3.1. If set, the load + * balancer sends this string as the SNI hostname in the TLS connection to + * the backend, and requires that this string match a Subject Alternative + * Name (SAN) in the backend's server certificate. With a Regional Internet + * NEG backend, if the SNI is specified here, the load balancer uses it + * regardless of whether the Regional Internet NEG is specified with FQDN or + * IP address and port. When both sni and subjectAltNames[] are specified, + * the load balancer matches the backend certificate's SAN only to + * subjectAltNames[]. * * Generated from protobuf field optional string sni = 114030; */ protected $sni = null; /** - * A list of Subject Alternative Names (SANs) that the Load Balancer verifies during a TLS handshake with the backend. When the server presents its X.509 certificate to the Load Balancer, the Load Balancer inspects the certificate's SAN field, and requires that at least one SAN match one of the subjectAltNames in the list. This field is limited to 5 entries. When both sni and subjectAltNames[] are specified, the load balancer matches the backend certificate's SAN only to subjectAltNames[]. + * A list of Subject Alternative Names (SANs) that the Load Balancer + * verifies during a TLS handshake with the backend. When the server + * presents its X.509 certificate to the Load Balancer, the Load Balancer + * inspects the certificate's SAN field, and requires that at least one SAN + * match one of the subjectAltNames in the list. This field is limited to 5 + * entries. When both sni and subjectAltNames[] are specified, the load + * balancer matches the backend certificate's SAN only to subjectAltNames[]. * * Generated from protobuf field repeated .google.cloud.compute.v1.BackendServiceTlsSettingsSubjectAltName subject_alt_names = 330029535; */ @@ -40,11 +57,28 @@ class BackendServiceTlsSettings extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $authentication_config - * Reference to the BackendAuthenticationConfig resource from the networksecurity.googleapis.com namespace. Can be used in authenticating TLS connections to the backend, as specified by the authenticationMode field. Can only be specified if authenticationMode is not NONE. + * Reference to the BackendAuthenticationConfig resource from the + * networksecurity.googleapis.com namespace. Can be used in authenticating + * TLS connections to the backend, as specified by the authenticationMode + * field. Can only be specified if authenticationMode is not NONE. * @type string $sni - * Server Name Indication - see RFC3546 section 3.1. If set, the load balancer sends this string as the SNI hostname in the TLS connection to the backend, and requires that this string match a Subject Alternative Name (SAN) in the backend's server certificate. With a Regional Internet NEG backend, if the SNI is specified here, the load balancer uses it regardless of whether the Regional Internet NEG is specified with FQDN or IP address and port. When both sni and subjectAltNames[] are specified, the load balancer matches the backend certificate's SAN only to subjectAltNames[]. + * Server Name Indication - see RFC3546 section 3.1. If set, the load + * balancer sends this string as the SNI hostname in the TLS connection to + * the backend, and requires that this string match a Subject Alternative + * Name (SAN) in the backend's server certificate. With a Regional Internet + * NEG backend, if the SNI is specified here, the load balancer uses it + * regardless of whether the Regional Internet NEG is specified with FQDN or + * IP address and port. When both sni and subjectAltNames[] are specified, + * the load balancer matches the backend certificate's SAN only to + * subjectAltNames[]. * @type array<\Google\Cloud\Compute\V1\BackendServiceTlsSettingsSubjectAltName>|\Google\Protobuf\Internal\RepeatedField $subject_alt_names - * A list of Subject Alternative Names (SANs) that the Load Balancer verifies during a TLS handshake with the backend. When the server presents its X.509 certificate to the Load Balancer, the Load Balancer inspects the certificate's SAN field, and requires that at least one SAN match one of the subjectAltNames in the list. This field is limited to 5 entries. When both sni and subjectAltNames[] are specified, the load balancer matches the backend certificate's SAN only to subjectAltNames[]. + * A list of Subject Alternative Names (SANs) that the Load Balancer + * verifies during a TLS handshake with the backend. When the server + * presents its X.509 certificate to the Load Balancer, the Load Balancer + * inspects the certificate's SAN field, and requires that at least one SAN + * match one of the subjectAltNames in the list. This field is limited to 5 + * entries. When both sni and subjectAltNames[] are specified, the load + * balancer matches the backend certificate's SAN only to subjectAltNames[]. * } */ public function __construct($data = NULL) { @@ -53,7 +87,10 @@ public function __construct($data = NULL) { } /** - * Reference to the BackendAuthenticationConfig resource from the networksecurity.googleapis.com namespace. Can be used in authenticating TLS connections to the backend, as specified by the authenticationMode field. Can only be specified if authenticationMode is not NONE. + * Reference to the BackendAuthenticationConfig resource from the + * networksecurity.googleapis.com namespace. Can be used in authenticating + * TLS connections to the backend, as specified by the authenticationMode + * field. Can only be specified if authenticationMode is not NONE. * * Generated from protobuf field optional string authentication_config = 408053481; * @return string @@ -74,7 +111,10 @@ public function clearAuthenticationConfig() } /** - * Reference to the BackendAuthenticationConfig resource from the networksecurity.googleapis.com namespace. Can be used in authenticating TLS connections to the backend, as specified by the authenticationMode field. Can only be specified if authenticationMode is not NONE. + * Reference to the BackendAuthenticationConfig resource from the + * networksecurity.googleapis.com namespace. Can be used in authenticating + * TLS connections to the backend, as specified by the authenticationMode + * field. Can only be specified if authenticationMode is not NONE. * * Generated from protobuf field optional string authentication_config = 408053481; * @param string $var @@ -89,7 +129,15 @@ public function setAuthenticationConfig($var) } /** - * Server Name Indication - see RFC3546 section 3.1. If set, the load balancer sends this string as the SNI hostname in the TLS connection to the backend, and requires that this string match a Subject Alternative Name (SAN) in the backend's server certificate. With a Regional Internet NEG backend, if the SNI is specified here, the load balancer uses it regardless of whether the Regional Internet NEG is specified with FQDN or IP address and port. When both sni and subjectAltNames[] are specified, the load balancer matches the backend certificate's SAN only to subjectAltNames[]. + * Server Name Indication - see RFC3546 section 3.1. If set, the load + * balancer sends this string as the SNI hostname in the TLS connection to + * the backend, and requires that this string match a Subject Alternative + * Name (SAN) in the backend's server certificate. With a Regional Internet + * NEG backend, if the SNI is specified here, the load balancer uses it + * regardless of whether the Regional Internet NEG is specified with FQDN or + * IP address and port. When both sni and subjectAltNames[] are specified, + * the load balancer matches the backend certificate's SAN only to + * subjectAltNames[]. * * Generated from protobuf field optional string sni = 114030; * @return string @@ -110,7 +158,15 @@ public function clearSni() } /** - * Server Name Indication - see RFC3546 section 3.1. If set, the load balancer sends this string as the SNI hostname in the TLS connection to the backend, and requires that this string match a Subject Alternative Name (SAN) in the backend's server certificate. With a Regional Internet NEG backend, if the SNI is specified here, the load balancer uses it regardless of whether the Regional Internet NEG is specified with FQDN or IP address and port. When both sni and subjectAltNames[] are specified, the load balancer matches the backend certificate's SAN only to subjectAltNames[]. + * Server Name Indication - see RFC3546 section 3.1. If set, the load + * balancer sends this string as the SNI hostname in the TLS connection to + * the backend, and requires that this string match a Subject Alternative + * Name (SAN) in the backend's server certificate. With a Regional Internet + * NEG backend, if the SNI is specified here, the load balancer uses it + * regardless of whether the Regional Internet NEG is specified with FQDN or + * IP address and port. When both sni and subjectAltNames[] are specified, + * the load balancer matches the backend certificate's SAN only to + * subjectAltNames[]. * * Generated from protobuf field optional string sni = 114030; * @param string $var @@ -125,7 +181,13 @@ public function setSni($var) } /** - * A list of Subject Alternative Names (SANs) that the Load Balancer verifies during a TLS handshake with the backend. When the server presents its X.509 certificate to the Load Balancer, the Load Balancer inspects the certificate's SAN field, and requires that at least one SAN match one of the subjectAltNames in the list. This field is limited to 5 entries. When both sni and subjectAltNames[] are specified, the load balancer matches the backend certificate's SAN only to subjectAltNames[]. + * A list of Subject Alternative Names (SANs) that the Load Balancer + * verifies during a TLS handshake with the backend. When the server + * presents its X.509 certificate to the Load Balancer, the Load Balancer + * inspects the certificate's SAN field, and requires that at least one SAN + * match one of the subjectAltNames in the list. This field is limited to 5 + * entries. When both sni and subjectAltNames[] are specified, the load + * balancer matches the backend certificate's SAN only to subjectAltNames[]. * * Generated from protobuf field repeated .google.cloud.compute.v1.BackendServiceTlsSettingsSubjectAltName subject_alt_names = 330029535; * @return \Google\Protobuf\Internal\RepeatedField @@ -136,7 +198,13 @@ public function getSubjectAltNames() } /** - * A list of Subject Alternative Names (SANs) that the Load Balancer verifies during a TLS handshake with the backend. When the server presents its X.509 certificate to the Load Balancer, the Load Balancer inspects the certificate's SAN field, and requires that at least one SAN match one of the subjectAltNames in the list. This field is limited to 5 entries. When both sni and subjectAltNames[] are specified, the load balancer matches the backend certificate's SAN only to subjectAltNames[]. + * A list of Subject Alternative Names (SANs) that the Load Balancer + * verifies during a TLS handshake with the backend. When the server + * presents its X.509 certificate to the Load Balancer, the Load Balancer + * inspects the certificate's SAN field, and requires that at least one SAN + * match one of the subjectAltNames in the list. This field is limited to 5 + * entries. When both sni and subjectAltNames[] are specified, the load + * balancer matches the backend certificate's SAN only to subjectAltNames[]. * * Generated from protobuf field repeated .google.cloud.compute.v1.BackendServiceTlsSettingsSubjectAltName subject_alt_names = 330029535; * @param array<\Google\Cloud\Compute\V1\BackendServiceTlsSettingsSubjectAltName>|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/BackendServiceTlsSettingsSubjectAltName.php b/Compute/src/V1/BackendServiceTlsSettingsSubjectAltName.php index 80672e723045..f4067b2dd86d 100644 --- a/Compute/src/V1/BackendServiceTlsSettingsSubjectAltName.php +++ b/Compute/src/V1/BackendServiceTlsSettingsSubjectAltName.php @@ -9,7 +9,9 @@ use Google\Protobuf\Internal\GPBUtil; /** - * A Subject Alternative Name that the load balancer matches against the SAN field in the TLS certificate provided by the backend, specified as either a DNS name or a URI, in accordance with RFC 5280 4.2.1.6 + * A Subject Alternative Name that the load balancer matches against the SAN + * field in the TLS certificate provided by the backend, specified as either + * a DNS name or a URI, in accordance with RFC 5280 4.2.1.6 * * Generated from protobuf message google.cloud.compute.v1.BackendServiceTlsSettingsSubjectAltName */ diff --git a/Compute/src/V1/BackendServiceUsedBy.php b/Compute/src/V1/BackendServiceUsedBy.php index 7531442bd4fb..2bba1703953d 100644 --- a/Compute/src/V1/BackendServiceUsedBy.php +++ b/Compute/src/V1/BackendServiceUsedBy.php @@ -15,7 +15,9 @@ class BackendServiceUsedBy extends \Google\Protobuf\Internal\Message { /** - * [Output Only] Server-defined URL for resources referencing given BackendService like UrlMaps, TargetTcpProxies, TargetSslProxies and ForwardingRule. + * [Output Only] Server-defined URL for resources referencing given + * BackendService like UrlMaps, TargetTcpProxies, TargetSslProxies + * and ForwardingRule. * * Generated from protobuf field optional string reference = 148586315; */ @@ -28,7 +30,9 @@ class BackendServiceUsedBy extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $reference - * [Output Only] Server-defined URL for resources referencing given BackendService like UrlMaps, TargetTcpProxies, TargetSslProxies and ForwardingRule. + * [Output Only] Server-defined URL for resources referencing given + * BackendService like UrlMaps, TargetTcpProxies, TargetSslProxies + * and ForwardingRule. * } */ public function __construct($data = NULL) { @@ -37,7 +41,9 @@ public function __construct($data = NULL) { } /** - * [Output Only] Server-defined URL for resources referencing given BackendService like UrlMaps, TargetTcpProxies, TargetSslProxies and ForwardingRule. + * [Output Only] Server-defined URL for resources referencing given + * BackendService like UrlMaps, TargetTcpProxies, TargetSslProxies + * and ForwardingRule. * * Generated from protobuf field optional string reference = 148586315; * @return string @@ -58,7 +64,9 @@ public function clearReference() } /** - * [Output Only] Server-defined URL for resources referencing given BackendService like UrlMaps, TargetTcpProxies, TargetSslProxies and ForwardingRule. + * [Output Only] Server-defined URL for resources referencing given + * BackendService like UrlMaps, TargetTcpProxies, TargetSslProxies + * and ForwardingRule. * * Generated from protobuf field optional string reference = 148586315; * @param string $var diff --git a/Compute/src/V1/BackendServicesScopedList.php b/Compute/src/V1/BackendServicesScopedList.php index 103c1da93f9c..a68f0500608b 100644 --- a/Compute/src/V1/BackendServicesScopedList.php +++ b/Compute/src/V1/BackendServicesScopedList.php @@ -21,7 +21,8 @@ class BackendServicesScopedList extends \Google\Protobuf\Internal\Message */ private $backend_services; /** - * Informational warning which replaces the list of backend services when the list is empty. + * Informational warning which replaces the list of + * backend services when the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; */ @@ -36,7 +37,8 @@ class BackendServicesScopedList extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\BackendService>|\Google\Protobuf\Internal\RepeatedField $backend_services * A list of BackendServices contained in this scope. * @type \Google\Cloud\Compute\V1\Warning $warning - * Informational warning which replaces the list of backend services when the list is empty. + * Informational warning which replaces the list of + * backend services when the list is empty. * } */ public function __construct($data = NULL) { @@ -71,7 +73,8 @@ public function setBackendServices($var) } /** - * Informational warning which replaces the list of backend services when the list is empty. + * Informational warning which replaces the list of + * backend services when the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; * @return \Google\Cloud\Compute\V1\Warning|null @@ -92,7 +95,8 @@ public function clearWarning() } /** - * Informational warning which replaces the list of backend services when the list is empty. + * Informational warning which replaces the list of + * backend services when the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; * @param \Google\Cloud\Compute\V1\Warning $var diff --git a/Compute/src/V1/BfdPacket.php b/Compute/src/V1/BfdPacket.php index 62fc9a675e98..aff137958f16 100644 --- a/Compute/src/V1/BfdPacket.php +++ b/Compute/src/V1/BfdPacket.php @@ -15,99 +15,112 @@ class BfdPacket extends \Google\Protobuf\Internal\Message { /** - * The Authentication Present bit of the BFD packet. This is specified in section 4.1 of RFC5880 + * The Authentication Present bit of the BFD packet. This is specified in + * section 4.1 ofRFC5880 * * Generated from protobuf field optional bool authentication_present = 105974260; */ protected $authentication_present = null; /** - * The Control Plane Independent bit of the BFD packet. This is specified in section 4.1 of RFC5880 + * The Control Plane Independent bit of the BFD packet. This is specified in + * section 4.1 ofRFC5880 * * Generated from protobuf field optional bool control_plane_independent = 62363573; */ protected $control_plane_independent = null; /** - * The demand bit of the BFD packet. This is specified in section 4.1 of RFC5880 + * The demand bit of the BFD packet. This is specified in section 4.1 ofRFC5880 * * Generated from protobuf field optional bool demand = 275180107; */ protected $demand = null; /** - * The diagnostic code specifies the local system's reason for the last change in session state. This allows remote systems to determine the reason that the previous session failed, for example. These diagnostic codes are specified in section 4.1 of RFC5880 + * The diagnostic code specifies the local system's reason for the last change + * in session state. This allows remote systems to determine the reason that + * the previous session failed, for example. These diagnostic codes are + * specified in section 4.1 ofRFC5880 * Check the Diagnostic enum for the list of possible values. * * Generated from protobuf field optional string diagnostic = 62708647; */ protected $diagnostic = null; /** - * The Final bit of the BFD packet. This is specified in section 4.1 of RFC5880 + * The Final bit of the BFD packet. This is specified in section 4.1 ofRFC5880 * * Generated from protobuf field optional bool final = 97436022; */ protected $final = null; /** - * The length of the BFD Control packet in bytes. This is specified in section 4.1 of RFC5880 + * The length of the BFD Control packet in bytes. This is specified in section + * 4.1 ofRFC5880 * * Generated from protobuf field optional uint32 length = 504249062; */ protected $length = null; /** - * The Required Min Echo RX Interval value in the BFD packet. This is specified in section 4.1 of RFC5880 + * The Required Min Echo RX Interval value in the BFD packet. This is + * specified in section 4.1 ofRFC5880 * * Generated from protobuf field optional uint32 min_echo_rx_interval_ms = 97286868; */ protected $min_echo_rx_interval_ms = null; /** - * The Required Min RX Interval value in the BFD packet. This is specified in section 4.1 of RFC5880 + * The Required Min RX Interval value in the BFD packet. This is specified in + * section 4.1 ofRFC5880 * * Generated from protobuf field optional uint32 min_rx_interval_ms = 463399028; */ protected $min_rx_interval_ms = null; /** - * The Desired Min TX Interval value in the BFD packet. This is specified in section 4.1 of RFC5880 + * The Desired Min TX Interval value in the BFD packet. This is specified in + * section 4.1 ofRFC5880 * * Generated from protobuf field optional uint32 min_tx_interval_ms = 526023602; */ protected $min_tx_interval_ms = null; /** - * The detection time multiplier of the BFD packet. This is specified in section 4.1 of RFC5880 + * The detection time multiplier of the BFD packet. This is specified in + * section 4.1 ofRFC5880 * * Generated from protobuf field optional uint32 multiplier = 191331777; */ protected $multiplier = null; /** - * The multipoint bit of the BFD packet. This is specified in section 4.1 of RFC5880 + * The multipoint bit of the BFD packet. This is specified in section 4.1 ofRFC5880 * * Generated from protobuf field optional bool multipoint = 191421431; */ protected $multipoint = null; /** - * The My Discriminator value in the BFD packet. This is specified in section 4.1 of RFC5880 + * The My Discriminator value in the BFD packet. This is specified in section + * 4.1 ofRFC5880 * * Generated from protobuf field optional uint32 my_discriminator = 76663113; */ protected $my_discriminator = null; /** - * The Poll bit of the BFD packet. This is specified in section 4.1 of RFC5880 + * The Poll bit of the BFD packet. This is specified in section 4.1 ofRFC5880 * * Generated from protobuf field optional bool poll = 3446719; */ protected $poll = null; /** - * The current BFD session state as seen by the transmitting system. These states are specified in section 4.1 of RFC5880 + * The current BFD session state as seen by the transmitting system. These + * states are specified in section 4.1 ofRFC5880 * Check the State enum for the list of possible values. * * Generated from protobuf field optional string state = 109757585; */ protected $state = null; /** - * The version number of the BFD protocol, as specified in section 4.1 of RFC5880. + * The version number of the BFD protocol, as specified in section 4.1 ofRFC5880. * * Generated from protobuf field optional uint32 version = 351608024; */ protected $version = null; /** - * The Your Discriminator value in the BFD packet. This is specified in section 4.1 of RFC5880 + * The Your Discriminator value in the BFD packet. This is specified in + * section 4.1 ofRFC5880 * * Generated from protobuf field optional uint32 your_discriminator = 515634064; */ @@ -120,39 +133,52 @@ class BfdPacket extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type bool $authentication_present - * The Authentication Present bit of the BFD packet. This is specified in section 4.1 of RFC5880 + * The Authentication Present bit of the BFD packet. This is specified in + * section 4.1 ofRFC5880 * @type bool $control_plane_independent - * The Control Plane Independent bit of the BFD packet. This is specified in section 4.1 of RFC5880 + * The Control Plane Independent bit of the BFD packet. This is specified in + * section 4.1 ofRFC5880 * @type bool $demand - * The demand bit of the BFD packet. This is specified in section 4.1 of RFC5880 + * The demand bit of the BFD packet. This is specified in section 4.1 ofRFC5880 * @type string $diagnostic - * The diagnostic code specifies the local system's reason for the last change in session state. This allows remote systems to determine the reason that the previous session failed, for example. These diagnostic codes are specified in section 4.1 of RFC5880 + * The diagnostic code specifies the local system's reason for the last change + * in session state. This allows remote systems to determine the reason that + * the previous session failed, for example. These diagnostic codes are + * specified in section 4.1 ofRFC5880 * Check the Diagnostic enum for the list of possible values. * @type bool $final - * The Final bit of the BFD packet. This is specified in section 4.1 of RFC5880 + * The Final bit of the BFD packet. This is specified in section 4.1 ofRFC5880 * @type int $length - * The length of the BFD Control packet in bytes. This is specified in section 4.1 of RFC5880 + * The length of the BFD Control packet in bytes. This is specified in section + * 4.1 ofRFC5880 * @type int $min_echo_rx_interval_ms - * The Required Min Echo RX Interval value in the BFD packet. This is specified in section 4.1 of RFC5880 + * The Required Min Echo RX Interval value in the BFD packet. This is + * specified in section 4.1 ofRFC5880 * @type int $min_rx_interval_ms - * The Required Min RX Interval value in the BFD packet. This is specified in section 4.1 of RFC5880 + * The Required Min RX Interval value in the BFD packet. This is specified in + * section 4.1 ofRFC5880 * @type int $min_tx_interval_ms - * The Desired Min TX Interval value in the BFD packet. This is specified in section 4.1 of RFC5880 + * The Desired Min TX Interval value in the BFD packet. This is specified in + * section 4.1 ofRFC5880 * @type int $multiplier - * The detection time multiplier of the BFD packet. This is specified in section 4.1 of RFC5880 + * The detection time multiplier of the BFD packet. This is specified in + * section 4.1 ofRFC5880 * @type bool $multipoint - * The multipoint bit of the BFD packet. This is specified in section 4.1 of RFC5880 + * The multipoint bit of the BFD packet. This is specified in section 4.1 ofRFC5880 * @type int $my_discriminator - * The My Discriminator value in the BFD packet. This is specified in section 4.1 of RFC5880 + * The My Discriminator value in the BFD packet. This is specified in section + * 4.1 ofRFC5880 * @type bool $poll - * The Poll bit of the BFD packet. This is specified in section 4.1 of RFC5880 + * The Poll bit of the BFD packet. This is specified in section 4.1 ofRFC5880 * @type string $state - * The current BFD session state as seen by the transmitting system. These states are specified in section 4.1 of RFC5880 + * The current BFD session state as seen by the transmitting system. These + * states are specified in section 4.1 ofRFC5880 * Check the State enum for the list of possible values. * @type int $version - * The version number of the BFD protocol, as specified in section 4.1 of RFC5880. + * The version number of the BFD protocol, as specified in section 4.1 ofRFC5880. * @type int $your_discriminator - * The Your Discriminator value in the BFD packet. This is specified in section 4.1 of RFC5880 + * The Your Discriminator value in the BFD packet. This is specified in + * section 4.1 ofRFC5880 * } */ public function __construct($data = NULL) { @@ -161,7 +187,8 @@ public function __construct($data = NULL) { } /** - * The Authentication Present bit of the BFD packet. This is specified in section 4.1 of RFC5880 + * The Authentication Present bit of the BFD packet. This is specified in + * section 4.1 ofRFC5880 * * Generated from protobuf field optional bool authentication_present = 105974260; * @return bool @@ -182,7 +209,8 @@ public function clearAuthenticationPresent() } /** - * The Authentication Present bit of the BFD packet. This is specified in section 4.1 of RFC5880 + * The Authentication Present bit of the BFD packet. This is specified in + * section 4.1 ofRFC5880 * * Generated from protobuf field optional bool authentication_present = 105974260; * @param bool $var @@ -197,7 +225,8 @@ public function setAuthenticationPresent($var) } /** - * The Control Plane Independent bit of the BFD packet. This is specified in section 4.1 of RFC5880 + * The Control Plane Independent bit of the BFD packet. This is specified in + * section 4.1 ofRFC5880 * * Generated from protobuf field optional bool control_plane_independent = 62363573; * @return bool @@ -218,7 +247,8 @@ public function clearControlPlaneIndependent() } /** - * The Control Plane Independent bit of the BFD packet. This is specified in section 4.1 of RFC5880 + * The Control Plane Independent bit of the BFD packet. This is specified in + * section 4.1 ofRFC5880 * * Generated from protobuf field optional bool control_plane_independent = 62363573; * @param bool $var @@ -233,7 +263,7 @@ public function setControlPlaneIndependent($var) } /** - * The demand bit of the BFD packet. This is specified in section 4.1 of RFC5880 + * The demand bit of the BFD packet. This is specified in section 4.1 ofRFC5880 * * Generated from protobuf field optional bool demand = 275180107; * @return bool @@ -254,7 +284,7 @@ public function clearDemand() } /** - * The demand bit of the BFD packet. This is specified in section 4.1 of RFC5880 + * The demand bit of the BFD packet. This is specified in section 4.1 ofRFC5880 * * Generated from protobuf field optional bool demand = 275180107; * @param bool $var @@ -269,7 +299,10 @@ public function setDemand($var) } /** - * The diagnostic code specifies the local system's reason for the last change in session state. This allows remote systems to determine the reason that the previous session failed, for example. These diagnostic codes are specified in section 4.1 of RFC5880 + * The diagnostic code specifies the local system's reason for the last change + * in session state. This allows remote systems to determine the reason that + * the previous session failed, for example. These diagnostic codes are + * specified in section 4.1 ofRFC5880 * Check the Diagnostic enum for the list of possible values. * * Generated from protobuf field optional string diagnostic = 62708647; @@ -291,7 +324,10 @@ public function clearDiagnostic() } /** - * The diagnostic code specifies the local system's reason for the last change in session state. This allows remote systems to determine the reason that the previous session failed, for example. These diagnostic codes are specified in section 4.1 of RFC5880 + * The diagnostic code specifies the local system's reason for the last change + * in session state. This allows remote systems to determine the reason that + * the previous session failed, for example. These diagnostic codes are + * specified in section 4.1 ofRFC5880 * Check the Diagnostic enum for the list of possible values. * * Generated from protobuf field optional string diagnostic = 62708647; @@ -307,7 +343,7 @@ public function setDiagnostic($var) } /** - * The Final bit of the BFD packet. This is specified in section 4.1 of RFC5880 + * The Final bit of the BFD packet. This is specified in section 4.1 ofRFC5880 * * Generated from protobuf field optional bool final = 97436022; * @return bool @@ -328,7 +364,7 @@ public function clearFinal() } /** - * The Final bit of the BFD packet. This is specified in section 4.1 of RFC5880 + * The Final bit of the BFD packet. This is specified in section 4.1 ofRFC5880 * * Generated from protobuf field optional bool final = 97436022; * @param bool $var @@ -343,7 +379,8 @@ public function setFinal($var) } /** - * The length of the BFD Control packet in bytes. This is specified in section 4.1 of RFC5880 + * The length of the BFD Control packet in bytes. This is specified in section + * 4.1 ofRFC5880 * * Generated from protobuf field optional uint32 length = 504249062; * @return int @@ -364,7 +401,8 @@ public function clearLength() } /** - * The length of the BFD Control packet in bytes. This is specified in section 4.1 of RFC5880 + * The length of the BFD Control packet in bytes. This is specified in section + * 4.1 ofRFC5880 * * Generated from protobuf field optional uint32 length = 504249062; * @param int $var @@ -379,7 +417,8 @@ public function setLength($var) } /** - * The Required Min Echo RX Interval value in the BFD packet. This is specified in section 4.1 of RFC5880 + * The Required Min Echo RX Interval value in the BFD packet. This is + * specified in section 4.1 ofRFC5880 * * Generated from protobuf field optional uint32 min_echo_rx_interval_ms = 97286868; * @return int @@ -400,7 +439,8 @@ public function clearMinEchoRxIntervalMs() } /** - * The Required Min Echo RX Interval value in the BFD packet. This is specified in section 4.1 of RFC5880 + * The Required Min Echo RX Interval value in the BFD packet. This is + * specified in section 4.1 ofRFC5880 * * Generated from protobuf field optional uint32 min_echo_rx_interval_ms = 97286868; * @param int $var @@ -415,7 +455,8 @@ public function setMinEchoRxIntervalMs($var) } /** - * The Required Min RX Interval value in the BFD packet. This is specified in section 4.1 of RFC5880 + * The Required Min RX Interval value in the BFD packet. This is specified in + * section 4.1 ofRFC5880 * * Generated from protobuf field optional uint32 min_rx_interval_ms = 463399028; * @return int @@ -436,7 +477,8 @@ public function clearMinRxIntervalMs() } /** - * The Required Min RX Interval value in the BFD packet. This is specified in section 4.1 of RFC5880 + * The Required Min RX Interval value in the BFD packet. This is specified in + * section 4.1 ofRFC5880 * * Generated from protobuf field optional uint32 min_rx_interval_ms = 463399028; * @param int $var @@ -451,7 +493,8 @@ public function setMinRxIntervalMs($var) } /** - * The Desired Min TX Interval value in the BFD packet. This is specified in section 4.1 of RFC5880 + * The Desired Min TX Interval value in the BFD packet. This is specified in + * section 4.1 ofRFC5880 * * Generated from protobuf field optional uint32 min_tx_interval_ms = 526023602; * @return int @@ -472,7 +515,8 @@ public function clearMinTxIntervalMs() } /** - * The Desired Min TX Interval value in the BFD packet. This is specified in section 4.1 of RFC5880 + * The Desired Min TX Interval value in the BFD packet. This is specified in + * section 4.1 ofRFC5880 * * Generated from protobuf field optional uint32 min_tx_interval_ms = 526023602; * @param int $var @@ -487,7 +531,8 @@ public function setMinTxIntervalMs($var) } /** - * The detection time multiplier of the BFD packet. This is specified in section 4.1 of RFC5880 + * The detection time multiplier of the BFD packet. This is specified in + * section 4.1 ofRFC5880 * * Generated from protobuf field optional uint32 multiplier = 191331777; * @return int @@ -508,7 +553,8 @@ public function clearMultiplier() } /** - * The detection time multiplier of the BFD packet. This is specified in section 4.1 of RFC5880 + * The detection time multiplier of the BFD packet. This is specified in + * section 4.1 ofRFC5880 * * Generated from protobuf field optional uint32 multiplier = 191331777; * @param int $var @@ -523,7 +569,7 @@ public function setMultiplier($var) } /** - * The multipoint bit of the BFD packet. This is specified in section 4.1 of RFC5880 + * The multipoint bit of the BFD packet. This is specified in section 4.1 ofRFC5880 * * Generated from protobuf field optional bool multipoint = 191421431; * @return bool @@ -544,7 +590,7 @@ public function clearMultipoint() } /** - * The multipoint bit of the BFD packet. This is specified in section 4.1 of RFC5880 + * The multipoint bit of the BFD packet. This is specified in section 4.1 ofRFC5880 * * Generated from protobuf field optional bool multipoint = 191421431; * @param bool $var @@ -559,7 +605,8 @@ public function setMultipoint($var) } /** - * The My Discriminator value in the BFD packet. This is specified in section 4.1 of RFC5880 + * The My Discriminator value in the BFD packet. This is specified in section + * 4.1 ofRFC5880 * * Generated from protobuf field optional uint32 my_discriminator = 76663113; * @return int @@ -580,7 +627,8 @@ public function clearMyDiscriminator() } /** - * The My Discriminator value in the BFD packet. This is specified in section 4.1 of RFC5880 + * The My Discriminator value in the BFD packet. This is specified in section + * 4.1 ofRFC5880 * * Generated from protobuf field optional uint32 my_discriminator = 76663113; * @param int $var @@ -595,7 +643,7 @@ public function setMyDiscriminator($var) } /** - * The Poll bit of the BFD packet. This is specified in section 4.1 of RFC5880 + * The Poll bit of the BFD packet. This is specified in section 4.1 ofRFC5880 * * Generated from protobuf field optional bool poll = 3446719; * @return bool @@ -616,7 +664,7 @@ public function clearPoll() } /** - * The Poll bit of the BFD packet. This is specified in section 4.1 of RFC5880 + * The Poll bit of the BFD packet. This is specified in section 4.1 ofRFC5880 * * Generated from protobuf field optional bool poll = 3446719; * @param bool $var @@ -631,7 +679,8 @@ public function setPoll($var) } /** - * The current BFD session state as seen by the transmitting system. These states are specified in section 4.1 of RFC5880 + * The current BFD session state as seen by the transmitting system. These + * states are specified in section 4.1 ofRFC5880 * Check the State enum for the list of possible values. * * Generated from protobuf field optional string state = 109757585; @@ -653,7 +702,8 @@ public function clearState() } /** - * The current BFD session state as seen by the transmitting system. These states are specified in section 4.1 of RFC5880 + * The current BFD session state as seen by the transmitting system. These + * states are specified in section 4.1 ofRFC5880 * Check the State enum for the list of possible values. * * Generated from protobuf field optional string state = 109757585; @@ -669,7 +719,7 @@ public function setState($var) } /** - * The version number of the BFD protocol, as specified in section 4.1 of RFC5880. + * The version number of the BFD protocol, as specified in section 4.1 ofRFC5880. * * Generated from protobuf field optional uint32 version = 351608024; * @return int @@ -690,7 +740,7 @@ public function clearVersion() } /** - * The version number of the BFD protocol, as specified in section 4.1 of RFC5880. + * The version number of the BFD protocol, as specified in section 4.1 ofRFC5880. * * Generated from protobuf field optional uint32 version = 351608024; * @param int $var @@ -705,7 +755,8 @@ public function setVersion($var) } /** - * The Your Discriminator value in the BFD packet. This is specified in section 4.1 of RFC5880 + * The Your Discriminator value in the BFD packet. This is specified in + * section 4.1 ofRFC5880 * * Generated from protobuf field optional uint32 your_discriminator = 515634064; * @return int @@ -726,7 +777,8 @@ public function clearYourDiscriminator() } /** - * The Your Discriminator value in the BFD packet. This is specified in section 4.1 of RFC5880 + * The Your Discriminator value in the BFD packet. This is specified in + * section 4.1 ofRFC5880 * * Generated from protobuf field optional uint32 your_discriminator = 515634064; * @param int $var diff --git a/Compute/src/V1/BfdPacket/Diagnostic.php b/Compute/src/V1/BfdPacket/Diagnostic.php index 7879d840a97c..4b42d16522cb 100644 --- a/Compute/src/V1/BfdPacket/Diagnostic.php +++ b/Compute/src/V1/BfdPacket/Diagnostic.php @@ -7,7 +7,10 @@ use UnexpectedValueException; /** - * The diagnostic code specifies the local system's reason for the last change in session state. This allows remote systems to determine the reason that the previous session failed, for example. These diagnostic codes are specified in section 4.1 of RFC5880 + * The diagnostic code specifies the local system's reason for the last change + * in session state. This allows remote systems to determine the reason that + * the previous session failed, for example. These diagnostic codes are + * specified in section 4.1 ofRFC5880 * * Protobuf type google.cloud.compute.v1.BfdPacket.Diagnostic */ diff --git a/Compute/src/V1/BfdPacket/State.php b/Compute/src/V1/BfdPacket/State.php index 6581f1e01d16..b288732625ba 100644 --- a/Compute/src/V1/BfdPacket/State.php +++ b/Compute/src/V1/BfdPacket/State.php @@ -7,7 +7,8 @@ use UnexpectedValueException; /** - * The current BFD session state as seen by the transmitting system. These states are specified in section 4.1 of RFC5880 + * The current BFD session state as seen by the transmitting system. These + * states are specified in section 4.1 ofRFC5880 * * Protobuf type google.cloud.compute.v1.BfdPacket.State */ diff --git a/Compute/src/V1/BfdStatus.php b/Compute/src/V1/BfdStatus.php index 654b40e895fd..8a205bd37054 100644 --- a/Compute/src/V1/BfdStatus.php +++ b/Compute/src/V1/BfdStatus.php @@ -16,7 +16,11 @@ class BfdStatus extends \Google\Protobuf\Internal\Message { /** - * The BFD session initialization mode for this BGP peer. If set to ACTIVE, the Cloud Router will initiate the BFD session for this BGP peer. If set to PASSIVE, the Cloud Router will wait for the peer router to initiate the BFD session for this BGP peer. If set to DISABLED, BFD is disabled for this BGP peer. + * The BFD session initialization mode for this BGP peer. + * If set to ACTIVE, the Cloud Router will initiate the BFD session for + * this BGP peer. If set to PASSIVE, the Cloud Router will wait for the + * peer router to initiate the BFD session for this BGP peer. If set to + * DISABLED, BFD is disabled for this BGP peer. * Check the BfdSessionInitializationMode enum for the list of possible values. * * Generated from protobuf field optional string bfd_session_initialization_mode = 218156954; @@ -41,14 +45,18 @@ class BfdStatus extends \Google\Protobuf\Internal\Message */ private $control_packet_intervals; /** - * The diagnostic code specifies the local system's reason for the last change in session state. This allows remote systems to determine the reason that the previous session failed, for example. These diagnostic codes are specified in section 4.1 of RFC5880 + * The diagnostic code specifies the local system's reason for the last change + * in session state. This allows remote systems to determine the reason that + * the previous session failed, for example. These diagnostic codes are + * specified in section 4.1 ofRFC5880 * Check the LocalDiagnostic enum for the list of possible values. * * Generated from protobuf field optional string local_diagnostic = 463737083; */ protected $local_diagnostic = null; /** - * The current BFD session state as seen by the transmitting system. These states are specified in section 4.1 of RFC5880 + * The current BFD session state as seen by the transmitting system. These + * states are specified in section 4.1 ofRFC5880 * Check the LocalState enum for the list of possible values. * * Generated from protobuf field optional string local_state = 149195453; @@ -86,7 +94,11 @@ class BfdStatus extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $bfd_session_initialization_mode - * The BFD session initialization mode for this BGP peer. If set to ACTIVE, the Cloud Router will initiate the BFD session for this BGP peer. If set to PASSIVE, the Cloud Router will wait for the peer router to initiate the BFD session for this BGP peer. If set to DISABLED, BFD is disabled for this BGP peer. + * The BFD session initialization mode for this BGP peer. + * If set to ACTIVE, the Cloud Router will initiate the BFD session for + * this BGP peer. If set to PASSIVE, the Cloud Router will wait for the + * peer router to initiate the BFD session for this BGP peer. If set to + * DISABLED, BFD is disabled for this BGP peer. * Check the BfdSessionInitializationMode enum for the list of possible values. * @type int|string $config_update_timestamp_micros * Unix timestamp of the most recent config update. @@ -95,10 +107,14 @@ class BfdStatus extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\PacketIntervals>|\Google\Protobuf\Internal\RepeatedField $control_packet_intervals * Inter-packet time interval statistics for control packets. * @type string $local_diagnostic - * The diagnostic code specifies the local system's reason for the last change in session state. This allows remote systems to determine the reason that the previous session failed, for example. These diagnostic codes are specified in section 4.1 of RFC5880 + * The diagnostic code specifies the local system's reason for the last change + * in session state. This allows remote systems to determine the reason that + * the previous session failed, for example. These diagnostic codes are + * specified in section 4.1 ofRFC5880 * Check the LocalDiagnostic enum for the list of possible values. * @type string $local_state - * The current BFD session state as seen by the transmitting system. These states are specified in section 4.1 of RFC5880 + * The current BFD session state as seen by the transmitting system. These + * states are specified in section 4.1 ofRFC5880 * Check the LocalState enum for the list of possible values. * @type int $negotiated_local_control_tx_interval_ms * Negotiated transmit interval for control packets. @@ -116,7 +132,11 @@ public function __construct($data = NULL) { } /** - * The BFD session initialization mode for this BGP peer. If set to ACTIVE, the Cloud Router will initiate the BFD session for this BGP peer. If set to PASSIVE, the Cloud Router will wait for the peer router to initiate the BFD session for this BGP peer. If set to DISABLED, BFD is disabled for this BGP peer. + * The BFD session initialization mode for this BGP peer. + * If set to ACTIVE, the Cloud Router will initiate the BFD session for + * this BGP peer. If set to PASSIVE, the Cloud Router will wait for the + * peer router to initiate the BFD session for this BGP peer. If set to + * DISABLED, BFD is disabled for this BGP peer. * Check the BfdSessionInitializationMode enum for the list of possible values. * * Generated from protobuf field optional string bfd_session_initialization_mode = 218156954; @@ -138,7 +158,11 @@ public function clearBfdSessionInitializationMode() } /** - * The BFD session initialization mode for this BGP peer. If set to ACTIVE, the Cloud Router will initiate the BFD session for this BGP peer. If set to PASSIVE, the Cloud Router will wait for the peer router to initiate the BFD session for this BGP peer. If set to DISABLED, BFD is disabled for this BGP peer. + * The BFD session initialization mode for this BGP peer. + * If set to ACTIVE, the Cloud Router will initiate the BFD session for + * this BGP peer. If set to PASSIVE, the Cloud Router will wait for the + * peer router to initiate the BFD session for this BGP peer. If set to + * DISABLED, BFD is disabled for this BGP peer. * Check the BfdSessionInitializationMode enum for the list of possible values. * * Generated from protobuf field optional string bfd_session_initialization_mode = 218156954; @@ -252,7 +276,10 @@ public function setControlPacketIntervals($var) } /** - * The diagnostic code specifies the local system's reason for the last change in session state. This allows remote systems to determine the reason that the previous session failed, for example. These diagnostic codes are specified in section 4.1 of RFC5880 + * The diagnostic code specifies the local system's reason for the last change + * in session state. This allows remote systems to determine the reason that + * the previous session failed, for example. These diagnostic codes are + * specified in section 4.1 ofRFC5880 * Check the LocalDiagnostic enum for the list of possible values. * * Generated from protobuf field optional string local_diagnostic = 463737083; @@ -274,7 +301,10 @@ public function clearLocalDiagnostic() } /** - * The diagnostic code specifies the local system's reason for the last change in session state. This allows remote systems to determine the reason that the previous session failed, for example. These diagnostic codes are specified in section 4.1 of RFC5880 + * The diagnostic code specifies the local system's reason for the last change + * in session state. This allows remote systems to determine the reason that + * the previous session failed, for example. These diagnostic codes are + * specified in section 4.1 ofRFC5880 * Check the LocalDiagnostic enum for the list of possible values. * * Generated from protobuf field optional string local_diagnostic = 463737083; @@ -290,7 +320,8 @@ public function setLocalDiagnostic($var) } /** - * The current BFD session state as seen by the transmitting system. These states are specified in section 4.1 of RFC5880 + * The current BFD session state as seen by the transmitting system. These + * states are specified in section 4.1 ofRFC5880 * Check the LocalState enum for the list of possible values. * * Generated from protobuf field optional string local_state = 149195453; @@ -312,7 +343,8 @@ public function clearLocalState() } /** - * The current BFD session state as seen by the transmitting system. These states are specified in section 4.1 of RFC5880 + * The current BFD session state as seen by the transmitting system. These + * states are specified in section 4.1 ofRFC5880 * Check the LocalState enum for the list of possible values. * * Generated from protobuf field optional string local_state = 149195453; diff --git a/Compute/src/V1/BfdStatus/BfdSessionInitializationMode.php b/Compute/src/V1/BfdStatus/BfdSessionInitializationMode.php index fd1c738a00e9..c9b323c18249 100644 --- a/Compute/src/V1/BfdStatus/BfdSessionInitializationMode.php +++ b/Compute/src/V1/BfdStatus/BfdSessionInitializationMode.php @@ -7,7 +7,11 @@ use UnexpectedValueException; /** - * The BFD session initialization mode for this BGP peer. If set to ACTIVE, the Cloud Router will initiate the BFD session for this BGP peer. If set to PASSIVE, the Cloud Router will wait for the peer router to initiate the BFD session for this BGP peer. If set to DISABLED, BFD is disabled for this BGP peer. + * The BFD session initialization mode for this BGP peer. + * If set to ACTIVE, the Cloud Router will initiate the BFD session for + * this BGP peer. If set to PASSIVE, the Cloud Router will wait for the + * peer router to initiate the BFD session for this BGP peer. If set to + * DISABLED, BFD is disabled for this BGP peer. * * Protobuf type google.cloud.compute.v1.BfdStatus.BfdSessionInitializationMode */ diff --git a/Compute/src/V1/BfdStatus/LocalDiagnostic.php b/Compute/src/V1/BfdStatus/LocalDiagnostic.php index 21d3a465769a..d7f43699fd2f 100644 --- a/Compute/src/V1/BfdStatus/LocalDiagnostic.php +++ b/Compute/src/V1/BfdStatus/LocalDiagnostic.php @@ -7,7 +7,10 @@ use UnexpectedValueException; /** - * The diagnostic code specifies the local system's reason for the last change in session state. This allows remote systems to determine the reason that the previous session failed, for example. These diagnostic codes are specified in section 4.1 of RFC5880 + * The diagnostic code specifies the local system's reason for the last change + * in session state. This allows remote systems to determine the reason that + * the previous session failed, for example. These diagnostic codes are + * specified in section 4.1 ofRFC5880 * * Protobuf type google.cloud.compute.v1.BfdStatus.LocalDiagnostic */ diff --git a/Compute/src/V1/BfdStatus/LocalState.php b/Compute/src/V1/BfdStatus/LocalState.php index 60cd5a6b7b55..ef65b588c416 100644 --- a/Compute/src/V1/BfdStatus/LocalState.php +++ b/Compute/src/V1/BfdStatus/LocalState.php @@ -7,7 +7,8 @@ use UnexpectedValueException; /** - * The current BFD session state as seen by the transmitting system. These states are specified in section 4.1 of RFC5880 + * The current BFD session state as seen by the transmitting system. These + * states are specified in section 4.1 ofRFC5880 * * Protobuf type google.cloud.compute.v1.BfdStatus.LocalState */ diff --git a/Compute/src/V1/BfdStatusPacketCounts.php b/Compute/src/V1/BfdStatusPacketCounts.php index ac61018e6224..294b42ff2496 100644 --- a/Compute/src/V1/BfdStatusPacketCounts.php +++ b/Compute/src/V1/BfdStatusPacketCounts.php @@ -15,25 +15,29 @@ class BfdStatusPacketCounts extends \Google\Protobuf\Internal\Message { /** - * Number of packets received since the beginning of the current BFD session. + * Number of packets received since the beginning of the current BFD + * session. * * Generated from protobuf field optional uint32 num_rx = 39375263; */ protected $num_rx = null; /** - * Number of packets received that were rejected because of errors since the beginning of the current BFD session. + * Number of packets received that were rejected because of errors since the + * beginning of the current BFD session. * * Generated from protobuf field optional uint32 num_rx_rejected = 281007902; */ protected $num_rx_rejected = null; /** - * Number of packets received that were successfully processed since the beginning of the current BFD session. + * Number of packets received that were successfully processed since the + * beginning of the current BFD session. * * Generated from protobuf field optional uint32 num_rx_successful = 455361850; */ protected $num_rx_successful = null; /** - * Number of packets transmitted since the beginning of the current BFD session. + * Number of packets transmitted since the beginning of the current BFD + * session. * * Generated from protobuf field optional uint32 num_tx = 39375325; */ @@ -46,13 +50,17 @@ class BfdStatusPacketCounts extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type int $num_rx - * Number of packets received since the beginning of the current BFD session. + * Number of packets received since the beginning of the current BFD + * session. * @type int $num_rx_rejected - * Number of packets received that were rejected because of errors since the beginning of the current BFD session. + * Number of packets received that were rejected because of errors since the + * beginning of the current BFD session. * @type int $num_rx_successful - * Number of packets received that were successfully processed since the beginning of the current BFD session. + * Number of packets received that were successfully processed since the + * beginning of the current BFD session. * @type int $num_tx - * Number of packets transmitted since the beginning of the current BFD session. + * Number of packets transmitted since the beginning of the current BFD + * session. * } */ public function __construct($data = NULL) { @@ -61,7 +69,8 @@ public function __construct($data = NULL) { } /** - * Number of packets received since the beginning of the current BFD session. + * Number of packets received since the beginning of the current BFD + * session. * * Generated from protobuf field optional uint32 num_rx = 39375263; * @return int @@ -82,7 +91,8 @@ public function clearNumRx() } /** - * Number of packets received since the beginning of the current BFD session. + * Number of packets received since the beginning of the current BFD + * session. * * Generated from protobuf field optional uint32 num_rx = 39375263; * @param int $var @@ -97,7 +107,8 @@ public function setNumRx($var) } /** - * Number of packets received that were rejected because of errors since the beginning of the current BFD session. + * Number of packets received that were rejected because of errors since the + * beginning of the current BFD session. * * Generated from protobuf field optional uint32 num_rx_rejected = 281007902; * @return int @@ -118,7 +129,8 @@ public function clearNumRxRejected() } /** - * Number of packets received that were rejected because of errors since the beginning of the current BFD session. + * Number of packets received that were rejected because of errors since the + * beginning of the current BFD session. * * Generated from protobuf field optional uint32 num_rx_rejected = 281007902; * @param int $var @@ -133,7 +145,8 @@ public function setNumRxRejected($var) } /** - * Number of packets received that were successfully processed since the beginning of the current BFD session. + * Number of packets received that were successfully processed since the + * beginning of the current BFD session. * * Generated from protobuf field optional uint32 num_rx_successful = 455361850; * @return int @@ -154,7 +167,8 @@ public function clearNumRxSuccessful() } /** - * Number of packets received that were successfully processed since the beginning of the current BFD session. + * Number of packets received that were successfully processed since the + * beginning of the current BFD session. * * Generated from protobuf field optional uint32 num_rx_successful = 455361850; * @param int $var @@ -169,7 +183,8 @@ public function setNumRxSuccessful($var) } /** - * Number of packets transmitted since the beginning of the current BFD session. + * Number of packets transmitted since the beginning of the current BFD + * session. * * Generated from protobuf field optional uint32 num_tx = 39375325; * @return int @@ -190,7 +205,8 @@ public function clearNumTx() } /** - * Number of packets transmitted since the beginning of the current BFD session. + * Number of packets transmitted since the beginning of the current BFD + * session. * * Generated from protobuf field optional uint32 num_tx = 39375325; * @param int $var diff --git a/Compute/src/V1/BgpRoute.php b/Compute/src/V1/BgpRoute.php index 05486bcaaa24..d01d45ee217e 100644 --- a/Compute/src/V1/BgpRoute.php +++ b/Compute/src/V1/BgpRoute.php @@ -27,7 +27,8 @@ class BgpRoute extends \Google\Protobuf\Internal\Message */ private $communities; /** - * [Output only] Destination IP range for the route, in human-readable CIDR format + * [Output only] Destination IP range for the route, in human-readable CIDR + * format * * Generated from protobuf field optional .google.cloud.compute.v1.BgpRouteNetworkLayerReachabilityInformation destination = 180765710; */ @@ -57,7 +58,8 @@ class BgpRoute extends \Google\Protobuf\Internal\Message * @type array|\Google\Protobuf\Internal\RepeatedField $communities * [Output only] BGP communities in human-readable A:B format. * @type \Google\Cloud\Compute\V1\BgpRouteNetworkLayerReachabilityInformation $destination - * [Output only] Destination IP range for the route, in human-readable CIDR format + * [Output only] Destination IP range for the route, in human-readable CIDR + * format * @type int $med * [Output only] BGP multi-exit discriminator * @type string $origin @@ -123,7 +125,8 @@ public function setCommunities($var) } /** - * [Output only] Destination IP range for the route, in human-readable CIDR format + * [Output only] Destination IP range for the route, in human-readable CIDR + * format * * Generated from protobuf field optional .google.cloud.compute.v1.BgpRouteNetworkLayerReachabilityInformation destination = 180765710; * @return \Google\Cloud\Compute\V1\BgpRouteNetworkLayerReachabilityInformation|null @@ -144,7 +147,8 @@ public function clearDestination() } /** - * [Output only] Destination IP range for the route, in human-readable CIDR format + * [Output only] Destination IP range for the route, in human-readable CIDR + * format * * Generated from protobuf field optional .google.cloud.compute.v1.BgpRouteNetworkLayerReachabilityInformation destination = 180765710; * @param \Google\Cloud\Compute\V1\BgpRouteNetworkLayerReachabilityInformation $var diff --git a/Compute/src/V1/BgpRouteAsPath.php b/Compute/src/V1/BgpRouteAsPath.php index 75f1b13c9d3d..7e5a75a6411d 100644 --- a/Compute/src/V1/BgpRouteAsPath.php +++ b/Compute/src/V1/BgpRouteAsPath.php @@ -15,11 +15,20 @@ class BgpRouteAsPath extends \Google\Protobuf\Internal\Message { /** - * [Output only] ASNs in the path segment. When type is SEQUENCE, these are ordered. + * [Output only] ASNs in the path segment. When type is SEQUENCE, these are + * ordered. * * Generated from protobuf field repeated int32 asns = 3003767; */ private $asns; + /** + * [Output only] ASNs in the path segment. This field is for better + * support of 32 bit ASNs as the other asns field suffers from overflow when + * the ASN is larger. When type is SEQUENCE, these are ordered. + * + * Generated from protobuf field repeated uint32 asns32 = 202267158; + */ + private $asns32; /** * [Output only] Type of AS-PATH segment (SEQUENCE or SET) * Check the Type enum for the list of possible values. @@ -35,7 +44,12 @@ class BgpRouteAsPath extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type array|\Google\Protobuf\Internal\RepeatedField $asns - * [Output only] ASNs in the path segment. When type is SEQUENCE, these are ordered. + * [Output only] ASNs in the path segment. When type is SEQUENCE, these are + * ordered. + * @type array|\Google\Protobuf\Internal\RepeatedField $asns32 + * [Output only] ASNs in the path segment. This field is for better + * support of 32 bit ASNs as the other asns field suffers from overflow when + * the ASN is larger. When type is SEQUENCE, these are ordered. * @type string $type * [Output only] Type of AS-PATH segment (SEQUENCE or SET) * Check the Type enum for the list of possible values. @@ -47,7 +61,8 @@ public function __construct($data = NULL) { } /** - * [Output only] ASNs in the path segment. When type is SEQUENCE, these are ordered. + * [Output only] ASNs in the path segment. When type is SEQUENCE, these are + * ordered. * * Generated from protobuf field repeated int32 asns = 3003767; * @return \Google\Protobuf\Internal\RepeatedField @@ -58,7 +73,8 @@ public function getAsns() } /** - * [Output only] ASNs in the path segment. When type is SEQUENCE, these are ordered. + * [Output only] ASNs in the path segment. When type is SEQUENCE, these are + * ordered. * * Generated from protobuf field repeated int32 asns = 3003767; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -72,6 +88,36 @@ public function setAsns($var) return $this; } + /** + * [Output only] ASNs in the path segment. This field is for better + * support of 32 bit ASNs as the other asns field suffers from overflow when + * the ASN is larger. When type is SEQUENCE, these are ordered. + * + * Generated from protobuf field repeated uint32 asns32 = 202267158; + * @return \Google\Protobuf\Internal\RepeatedField + */ + public function getAsns32() + { + return $this->asns32; + } + + /** + * [Output only] ASNs in the path segment. This field is for better + * support of 32 bit ASNs as the other asns field suffers from overflow when + * the ASN is larger. When type is SEQUENCE, these are ordered. + * + * Generated from protobuf field repeated uint32 asns32 = 202267158; + * @param array|\Google\Protobuf\Internal\RepeatedField $var + * @return $this + */ + public function setAsns32($var) + { + $arr = GPBUtil::checkRepeatedField($var, \Google\Protobuf\Internal\GPBType::UINT32); + $this->asns32 = $arr; + + return $this; + } + /** * [Output only] Type of AS-PATH segment (SEQUENCE or SET) * Check the Type enum for the list of possible values. diff --git a/Compute/src/V1/BgpRouteNetworkLayerReachabilityInformation.php b/Compute/src/V1/BgpRouteNetworkLayerReachabilityInformation.php index 61678edd5d66..093c117094d5 100644 --- a/Compute/src/V1/BgpRouteNetworkLayerReachabilityInformation.php +++ b/Compute/src/V1/BgpRouteNetworkLayerReachabilityInformation.php @@ -16,7 +16,8 @@ class BgpRouteNetworkLayerReachabilityInformation extends \Google\Protobuf\Internal\Message { /** - * If the BGP session supports multiple paths (RFC 7911), the path identifier for this route. + * If the BGP session supports multiple paths (RFC 7911), the path + * identifier for this route. * * Generated from protobuf field optional uint32 path_id = 282287989; */ @@ -35,7 +36,8 @@ class BgpRouteNetworkLayerReachabilityInformation extends \Google\Protobuf\Inter * Optional. Data for populating the Message object. * * @type int $path_id - * If the BGP session supports multiple paths (RFC 7911), the path identifier for this route. + * If the BGP session supports multiple paths (RFC 7911), the path + * identifier for this route. * @type string $prefix * Human readable CIDR notation for a prefix. E.g. 10.42.0.0/16. * } @@ -46,7 +48,8 @@ public function __construct($data = NULL) { } /** - * If the BGP session supports multiple paths (RFC 7911), the path identifier for this route. + * If the BGP session supports multiple paths (RFC 7911), the path + * identifier for this route. * * Generated from protobuf field optional uint32 path_id = 282287989; * @return int @@ -67,7 +70,8 @@ public function clearPathId() } /** - * If the BGP session supports multiple paths (RFC 7911), the path identifier for this route. + * If the BGP session supports multiple paths (RFC 7911), the path + * identifier for this route. * * Generated from protobuf field optional uint32 path_id = 282287989; * @param int $var diff --git a/Compute/src/V1/Binding.php b/Compute/src/V1/Binding.php index 274655beadf9..fc8fd5080dcd 100644 --- a/Compute/src/V1/Binding.php +++ b/Compute/src/V1/Binding.php @@ -20,19 +20,89 @@ class Binding extends \Google\Protobuf\Internal\Message */ protected $binding_id = null; /** - * The condition that is associated with this binding. If the condition evaluates to `true`, then this binding applies to the current request. If the condition evaluates to `false`, then this binding does not apply to the current request. However, a different role binding might grant the same role to one or more of the principals in this binding. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies). + * The condition that is associated with this binding. + * If the condition evaluates to `true`, then this binding applies to the + * current request. + * If the condition evaluates to `false`, then this binding does not apply to + * the current request. However, a different role binding might grant the same + * role to one or more of the principals in this binding. + * To learn which resources support conditions in their IAM policies, see the + * [IAM + * documentation](https://cloud.google.com/iam/help/conditions/resource-policies). * * Generated from protobuf field optional .google.cloud.compute.v1.Expr condition = 212430107; */ protected $condition = null; /** - * Specifies the principals requesting access for a Google Cloud resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. Does not include identities that come from external identity providers (IdPs) through identity federation. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a Google service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: An identifier for a [Kubernetes service account](https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts). For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. * `principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`: A single identity in a workforce identity pool. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/group/{group_id}`: All workforce identities in a group. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/attribute.{attribute_name}/{attribute_value}`: All workforce identities with a specific attribute value. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/*`: All identities in a workforce identity pool. * `principal://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/subject/{subject_attribute_value}`: A single identity in a workload identity pool. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/group/{group_id}`: A workload identity pool group. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/attribute.{attribute_name}/{attribute_value}`: All identities in a workload identity pool with a certain attribute. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/*`: All identities in a workload identity pool. * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a user that has been recently deleted. For example, `alice@example.com?uid=123456789012345678901`. If the user is recovered, this value reverts to `user:{emailid}` and the recovered user retains the role in the binding. * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a service account that has been recently deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If the service account is undeleted, this value reverts to `serviceAccount:{emailid}` and the undeleted service account retains the role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a Google group that has been recently deleted. For example, `admins@example.com?uid=123456789012345678901`. If the group is recovered, this value reverts to `group:{emailid}` and the recovered group retains the role in the binding. * `deleted:principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`: Deleted single identity in a workforce identity pool. For example, `deleted:principal://iam.googleapis.com/locations/global/workforcePools/my-pool-id/subject/my-subject-attribute-value`. + * Specifies the principals requesting access for a Google Cloud resource. + * `members` can have the following values: + * * `allUsers`: A special identifier that represents anyone who is + * on the internet; with or without a Google account. + * * `allAuthenticatedUsers`: A special identifier that represents anyone + * who is authenticated with a Google account or a service account. + * Does not include identities that come from external identity providers + * (IdPs) through identity federation. + * * `user:{emailid}`: An email address that represents a specific Google + * account. For example, `alice@example.com` . + * * `serviceAccount:{emailid}`: An email address that represents a Google + * service account. For example, + * `my-other-app@appspot.gserviceaccount.com`. + * * `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: An + * identifier for a + * [Kubernetes service + * account](https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts). + * For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`. + * * `group:{emailid}`: An email address that represents a Google group. + * For example, `admins@example.com`. + * * `domain:{domain}`: The G Suite domain (primary) that represents all the + * users of that domain. For example, `google.com` or `example.com`. + * * `principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`: + * A single identity in a workforce identity pool. + * * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/group/{group_id}`: + * All workforce identities in a group. + * * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/attribute.{attribute_name}/{attribute_value}`: + * All workforce identities with a specific attribute value. + * * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/*`: + * All identities in a workforce identity pool. + * * `principal://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/subject/{subject_attribute_value}`: + * A single identity in a workload identity pool. + * * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/group/{group_id}`: + * A workload identity pool group. + * * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/attribute.{attribute_name}/{attribute_value}`: + * All identities in a workload identity pool with a certain attribute. + * * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/*`: + * All identities in a workload identity pool. + * * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique + * identifier) representing a user that has been recently deleted. For + * example, `alice@example.com?uid=123456789012345678901`. If the user is + * recovered, this value reverts to `user:{emailid}` and the recovered user + * retains the role in the binding. + * * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus + * unique identifier) representing a service account that has been recently + * deleted. For example, + * `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. + * If the service account is undeleted, this value reverts to + * `serviceAccount:{emailid}` and the undeleted service account retains the + * role in the binding. + * * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique + * identifier) representing a Google group that has been recently + * deleted. For example, `admins@example.com?uid=123456789012345678901`. If + * the group is recovered, this value reverts to `group:{emailid}` and the + * recovered group retains the role in the binding. + * * `deleted:principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`: + * Deleted single identity in a workforce identity pool. For example, + * `deleted:principal://iam.googleapis.com/locations/global/workforcePools/my-pool-id/subject/my-subject-attribute-value`. * * Generated from protobuf field repeated string members = 412010777; */ private $members; /** - * Role that is assigned to the list of `members`, or principals. For example, `roles/viewer`, `roles/editor`, or `roles/owner`. For an overview of the IAM roles and permissions, see the [IAM documentation](https://cloud.google.com/iam/docs/roles-overview). For a list of the available pre-defined roles, see [here](https://cloud.google.com/iam/docs/understanding-roles). + * Role that is assigned to the list of `members`, or principals. + * For example, `roles/viewer`, `roles/editor`, or `roles/owner`. + * For an overview of the IAM roles and permissions, see the + * [IAM documentation](https://cloud.google.com/iam/docs/roles-overview). For + * a list of the available pre-defined roles, see + * [here](https://cloud.google.com/iam/docs/understanding-roles). * * Generated from protobuf field optional string role = 3506294; */ @@ -46,11 +116,81 @@ class Binding extends \Google\Protobuf\Internal\Message * * @type string $binding_id * @type \Google\Cloud\Compute\V1\Expr $condition - * The condition that is associated with this binding. If the condition evaluates to `true`, then this binding applies to the current request. If the condition evaluates to `false`, then this binding does not apply to the current request. However, a different role binding might grant the same role to one or more of the principals in this binding. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies). + * The condition that is associated with this binding. + * If the condition evaluates to `true`, then this binding applies to the + * current request. + * If the condition evaluates to `false`, then this binding does not apply to + * the current request. However, a different role binding might grant the same + * role to one or more of the principals in this binding. + * To learn which resources support conditions in their IAM policies, see the + * [IAM + * documentation](https://cloud.google.com/iam/help/conditions/resource-policies). * @type array|\Google\Protobuf\Internal\RepeatedField $members - * Specifies the principals requesting access for a Google Cloud resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. Does not include identities that come from external identity providers (IdPs) through identity federation. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a Google service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: An identifier for a [Kubernetes service account](https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts). For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. * `principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`: A single identity in a workforce identity pool. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/group/{group_id}`: All workforce identities in a group. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/attribute.{attribute_name}/{attribute_value}`: All workforce identities with a specific attribute value. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/*`: All identities in a workforce identity pool. * `principal://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/subject/{subject_attribute_value}`: A single identity in a workload identity pool. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/group/{group_id}`: A workload identity pool group. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/attribute.{attribute_name}/{attribute_value}`: All identities in a workload identity pool with a certain attribute. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/*`: All identities in a workload identity pool. * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a user that has been recently deleted. For example, `alice@example.com?uid=123456789012345678901`. If the user is recovered, this value reverts to `user:{emailid}` and the recovered user retains the role in the binding. * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a service account that has been recently deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If the service account is undeleted, this value reverts to `serviceAccount:{emailid}` and the undeleted service account retains the role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a Google group that has been recently deleted. For example, `admins@example.com?uid=123456789012345678901`. If the group is recovered, this value reverts to `group:{emailid}` and the recovered group retains the role in the binding. * `deleted:principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`: Deleted single identity in a workforce identity pool. For example, `deleted:principal://iam.googleapis.com/locations/global/workforcePools/my-pool-id/subject/my-subject-attribute-value`. + * Specifies the principals requesting access for a Google Cloud resource. + * `members` can have the following values: + * * `allUsers`: A special identifier that represents anyone who is + * on the internet; with or without a Google account. + * * `allAuthenticatedUsers`: A special identifier that represents anyone + * who is authenticated with a Google account or a service account. + * Does not include identities that come from external identity providers + * (IdPs) through identity federation. + * * `user:{emailid}`: An email address that represents a specific Google + * account. For example, `alice@example.com` . + * * `serviceAccount:{emailid}`: An email address that represents a Google + * service account. For example, + * `my-other-app@appspot.gserviceaccount.com`. + * * `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: An + * identifier for a + * [Kubernetes service + * account](https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts). + * For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`. + * * `group:{emailid}`: An email address that represents a Google group. + * For example, `admins@example.com`. + * * `domain:{domain}`: The G Suite domain (primary) that represents all the + * users of that domain. For example, `google.com` or `example.com`. + * * `principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`: + * A single identity in a workforce identity pool. + * * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/group/{group_id}`: + * All workforce identities in a group. + * * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/attribute.{attribute_name}/{attribute_value}`: + * All workforce identities with a specific attribute value. + * * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/*`: + * All identities in a workforce identity pool. + * * `principal://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/subject/{subject_attribute_value}`: + * A single identity in a workload identity pool. + * * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/group/{group_id}`: + * A workload identity pool group. + * * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/attribute.{attribute_name}/{attribute_value}`: + * All identities in a workload identity pool with a certain attribute. + * * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/*`: + * All identities in a workload identity pool. + * * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique + * identifier) representing a user that has been recently deleted. For + * example, `alice@example.com?uid=123456789012345678901`. If the user is + * recovered, this value reverts to `user:{emailid}` and the recovered user + * retains the role in the binding. + * * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus + * unique identifier) representing a service account that has been recently + * deleted. For example, + * `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. + * If the service account is undeleted, this value reverts to + * `serviceAccount:{emailid}` and the undeleted service account retains the + * role in the binding. + * * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique + * identifier) representing a Google group that has been recently + * deleted. For example, `admins@example.com?uid=123456789012345678901`. If + * the group is recovered, this value reverts to `group:{emailid}` and the + * recovered group retains the role in the binding. + * * `deleted:principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`: + * Deleted single identity in a workforce identity pool. For example, + * `deleted:principal://iam.googleapis.com/locations/global/workforcePools/my-pool-id/subject/my-subject-attribute-value`. * @type string $role - * Role that is assigned to the list of `members`, or principals. For example, `roles/viewer`, `roles/editor`, or `roles/owner`. For an overview of the IAM roles and permissions, see the [IAM documentation](https://cloud.google.com/iam/docs/roles-overview). For a list of the available pre-defined roles, see [here](https://cloud.google.com/iam/docs/understanding-roles). + * Role that is assigned to the list of `members`, or principals. + * For example, `roles/viewer`, `roles/editor`, or `roles/owner`. + * For an overview of the IAM roles and permissions, see the + * [IAM documentation](https://cloud.google.com/iam/docs/roles-overview). For + * a list of the available pre-defined roles, see + * [here](https://cloud.google.com/iam/docs/understanding-roles). * } */ public function __construct($data = NULL) { @@ -91,7 +231,15 @@ public function setBindingId($var) } /** - * The condition that is associated with this binding. If the condition evaluates to `true`, then this binding applies to the current request. If the condition evaluates to `false`, then this binding does not apply to the current request. However, a different role binding might grant the same role to one or more of the principals in this binding. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies). + * The condition that is associated with this binding. + * If the condition evaluates to `true`, then this binding applies to the + * current request. + * If the condition evaluates to `false`, then this binding does not apply to + * the current request. However, a different role binding might grant the same + * role to one or more of the principals in this binding. + * To learn which resources support conditions in their IAM policies, see the + * [IAM + * documentation](https://cloud.google.com/iam/help/conditions/resource-policies). * * Generated from protobuf field optional .google.cloud.compute.v1.Expr condition = 212430107; * @return \Google\Cloud\Compute\V1\Expr|null @@ -112,7 +260,15 @@ public function clearCondition() } /** - * The condition that is associated with this binding. If the condition evaluates to `true`, then this binding applies to the current request. If the condition evaluates to `false`, then this binding does not apply to the current request. However, a different role binding might grant the same role to one or more of the principals in this binding. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies). + * The condition that is associated with this binding. + * If the condition evaluates to `true`, then this binding applies to the + * current request. + * If the condition evaluates to `false`, then this binding does not apply to + * the current request. However, a different role binding might grant the same + * role to one or more of the principals in this binding. + * To learn which resources support conditions in their IAM policies, see the + * [IAM + * documentation](https://cloud.google.com/iam/help/conditions/resource-policies). * * Generated from protobuf field optional .google.cloud.compute.v1.Expr condition = 212430107; * @param \Google\Cloud\Compute\V1\Expr $var @@ -127,7 +283,64 @@ public function setCondition($var) } /** - * Specifies the principals requesting access for a Google Cloud resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. Does not include identities that come from external identity providers (IdPs) through identity federation. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a Google service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: An identifier for a [Kubernetes service account](https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts). For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. * `principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`: A single identity in a workforce identity pool. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/group/{group_id}`: All workforce identities in a group. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/attribute.{attribute_name}/{attribute_value}`: All workforce identities with a specific attribute value. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/*`: All identities in a workforce identity pool. * `principal://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/subject/{subject_attribute_value}`: A single identity in a workload identity pool. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/group/{group_id}`: A workload identity pool group. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/attribute.{attribute_name}/{attribute_value}`: All identities in a workload identity pool with a certain attribute. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/*`: All identities in a workload identity pool. * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a user that has been recently deleted. For example, `alice@example.com?uid=123456789012345678901`. If the user is recovered, this value reverts to `user:{emailid}` and the recovered user retains the role in the binding. * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a service account that has been recently deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If the service account is undeleted, this value reverts to `serviceAccount:{emailid}` and the undeleted service account retains the role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a Google group that has been recently deleted. For example, `admins@example.com?uid=123456789012345678901`. If the group is recovered, this value reverts to `group:{emailid}` and the recovered group retains the role in the binding. * `deleted:principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`: Deleted single identity in a workforce identity pool. For example, `deleted:principal://iam.googleapis.com/locations/global/workforcePools/my-pool-id/subject/my-subject-attribute-value`. + * Specifies the principals requesting access for a Google Cloud resource. + * `members` can have the following values: + * * `allUsers`: A special identifier that represents anyone who is + * on the internet; with or without a Google account. + * * `allAuthenticatedUsers`: A special identifier that represents anyone + * who is authenticated with a Google account or a service account. + * Does not include identities that come from external identity providers + * (IdPs) through identity federation. + * * `user:{emailid}`: An email address that represents a specific Google + * account. For example, `alice@example.com` . + * * `serviceAccount:{emailid}`: An email address that represents a Google + * service account. For example, + * `my-other-app@appspot.gserviceaccount.com`. + * * `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: An + * identifier for a + * [Kubernetes service + * account](https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts). + * For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`. + * * `group:{emailid}`: An email address that represents a Google group. + * For example, `admins@example.com`. + * * `domain:{domain}`: The G Suite domain (primary) that represents all the + * users of that domain. For example, `google.com` or `example.com`. + * * `principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`: + * A single identity in a workforce identity pool. + * * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/group/{group_id}`: + * All workforce identities in a group. + * * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/attribute.{attribute_name}/{attribute_value}`: + * All workforce identities with a specific attribute value. + * * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/*`: + * All identities in a workforce identity pool. + * * `principal://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/subject/{subject_attribute_value}`: + * A single identity in a workload identity pool. + * * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/group/{group_id}`: + * A workload identity pool group. + * * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/attribute.{attribute_name}/{attribute_value}`: + * All identities in a workload identity pool with a certain attribute. + * * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/*`: + * All identities in a workload identity pool. + * * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique + * identifier) representing a user that has been recently deleted. For + * example, `alice@example.com?uid=123456789012345678901`. If the user is + * recovered, this value reverts to `user:{emailid}` and the recovered user + * retains the role in the binding. + * * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus + * unique identifier) representing a service account that has been recently + * deleted. For example, + * `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. + * If the service account is undeleted, this value reverts to + * `serviceAccount:{emailid}` and the undeleted service account retains the + * role in the binding. + * * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique + * identifier) representing a Google group that has been recently + * deleted. For example, `admins@example.com?uid=123456789012345678901`. If + * the group is recovered, this value reverts to `group:{emailid}` and the + * recovered group retains the role in the binding. + * * `deleted:principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`: + * Deleted single identity in a workforce identity pool. For example, + * `deleted:principal://iam.googleapis.com/locations/global/workforcePools/my-pool-id/subject/my-subject-attribute-value`. * * Generated from protobuf field repeated string members = 412010777; * @return \Google\Protobuf\Internal\RepeatedField @@ -138,7 +351,64 @@ public function getMembers() } /** - * Specifies the principals requesting access for a Google Cloud resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. Does not include identities that come from external identity providers (IdPs) through identity federation. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a Google service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: An identifier for a [Kubernetes service account](https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts). For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. * `principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`: A single identity in a workforce identity pool. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/group/{group_id}`: All workforce identities in a group. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/attribute.{attribute_name}/{attribute_value}`: All workforce identities with a specific attribute value. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/*`: All identities in a workforce identity pool. * `principal://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/subject/{subject_attribute_value}`: A single identity in a workload identity pool. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/group/{group_id}`: A workload identity pool group. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/attribute.{attribute_name}/{attribute_value}`: All identities in a workload identity pool with a certain attribute. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/*`: All identities in a workload identity pool. * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a user that has been recently deleted. For example, `alice@example.com?uid=123456789012345678901`. If the user is recovered, this value reverts to `user:{emailid}` and the recovered user retains the role in the binding. * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a service account that has been recently deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If the service account is undeleted, this value reverts to `serviceAccount:{emailid}` and the undeleted service account retains the role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a Google group that has been recently deleted. For example, `admins@example.com?uid=123456789012345678901`. If the group is recovered, this value reverts to `group:{emailid}` and the recovered group retains the role in the binding. * `deleted:principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`: Deleted single identity in a workforce identity pool. For example, `deleted:principal://iam.googleapis.com/locations/global/workforcePools/my-pool-id/subject/my-subject-attribute-value`. + * Specifies the principals requesting access for a Google Cloud resource. + * `members` can have the following values: + * * `allUsers`: A special identifier that represents anyone who is + * on the internet; with or without a Google account. + * * `allAuthenticatedUsers`: A special identifier that represents anyone + * who is authenticated with a Google account or a service account. + * Does not include identities that come from external identity providers + * (IdPs) through identity federation. + * * `user:{emailid}`: An email address that represents a specific Google + * account. For example, `alice@example.com` . + * * `serviceAccount:{emailid}`: An email address that represents a Google + * service account. For example, + * `my-other-app@appspot.gserviceaccount.com`. + * * `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: An + * identifier for a + * [Kubernetes service + * account](https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts). + * For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`. + * * `group:{emailid}`: An email address that represents a Google group. + * For example, `admins@example.com`. + * * `domain:{domain}`: The G Suite domain (primary) that represents all the + * users of that domain. For example, `google.com` or `example.com`. + * * `principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`: + * A single identity in a workforce identity pool. + * * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/group/{group_id}`: + * All workforce identities in a group. + * * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/attribute.{attribute_name}/{attribute_value}`: + * All workforce identities with a specific attribute value. + * * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/*`: + * All identities in a workforce identity pool. + * * `principal://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/subject/{subject_attribute_value}`: + * A single identity in a workload identity pool. + * * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/group/{group_id}`: + * A workload identity pool group. + * * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/attribute.{attribute_name}/{attribute_value}`: + * All identities in a workload identity pool with a certain attribute. + * * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/*`: + * All identities in a workload identity pool. + * * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique + * identifier) representing a user that has been recently deleted. For + * example, `alice@example.com?uid=123456789012345678901`. If the user is + * recovered, this value reverts to `user:{emailid}` and the recovered user + * retains the role in the binding. + * * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus + * unique identifier) representing a service account that has been recently + * deleted. For example, + * `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. + * If the service account is undeleted, this value reverts to + * `serviceAccount:{emailid}` and the undeleted service account retains the + * role in the binding. + * * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique + * identifier) representing a Google group that has been recently + * deleted. For example, `admins@example.com?uid=123456789012345678901`. If + * the group is recovered, this value reverts to `group:{emailid}` and the + * recovered group retains the role in the binding. + * * `deleted:principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`: + * Deleted single identity in a workforce identity pool. For example, + * `deleted:principal://iam.googleapis.com/locations/global/workforcePools/my-pool-id/subject/my-subject-attribute-value`. * * Generated from protobuf field repeated string members = 412010777; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -153,7 +423,12 @@ public function setMembers($var) } /** - * Role that is assigned to the list of `members`, or principals. For example, `roles/viewer`, `roles/editor`, or `roles/owner`. For an overview of the IAM roles and permissions, see the [IAM documentation](https://cloud.google.com/iam/docs/roles-overview). For a list of the available pre-defined roles, see [here](https://cloud.google.com/iam/docs/understanding-roles). + * Role that is assigned to the list of `members`, or principals. + * For example, `roles/viewer`, `roles/editor`, or `roles/owner`. + * For an overview of the IAM roles and permissions, see the + * [IAM documentation](https://cloud.google.com/iam/docs/roles-overview). For + * a list of the available pre-defined roles, see + * [here](https://cloud.google.com/iam/docs/understanding-roles). * * Generated from protobuf field optional string role = 3506294; * @return string @@ -174,7 +449,12 @@ public function clearRole() } /** - * Role that is assigned to the list of `members`, or principals. For example, `roles/viewer`, `roles/editor`, or `roles/owner`. For an overview of the IAM roles and permissions, see the [IAM documentation](https://cloud.google.com/iam/docs/roles-overview). For a list of the available pre-defined roles, see [here](https://cloud.google.com/iam/docs/understanding-roles). + * Role that is assigned to the list of `members`, or principals. + * For example, `roles/viewer`, `roles/editor`, or `roles/owner`. + * For an overview of the IAM roles and permissions, see the + * [IAM documentation](https://cloud.google.com/iam/docs/roles-overview). For + * a list of the available pre-defined roles, see + * [here](https://cloud.google.com/iam/docs/understanding-roles). * * Generated from protobuf field optional string role = 3506294; * @param string $var diff --git a/Compute/src/V1/BulkInsertDiskRequest.php b/Compute/src/V1/BulkInsertDiskRequest.php index d60771e992a2..3b8d6a66542f 100644 --- a/Compute/src/V1/BulkInsertDiskRequest.php +++ b/Compute/src/V1/BulkInsertDiskRequest.php @@ -28,7 +28,17 @@ class BulkInsertDiskRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -68,7 +78,17 @@ public static function build(string $project, string $zone, \Google\Cloud\Comput * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $zone * The name of the zone for this request. * } @@ -141,7 +161,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -162,7 +192,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/BulkInsertDiskResource.php b/Compute/src/V1/BulkInsertDiskResource.php index 4af890eddc9a..cf4dc0b32d05 100644 --- a/Compute/src/V1/BulkInsertDiskResource.php +++ b/Compute/src/V1/BulkInsertDiskResource.php @@ -9,14 +9,23 @@ use Google\Protobuf\Internal\GPBUtil; /** - * A transient resource used in compute.disks.bulkInsert and compute.regionDisks.bulkInsert. It is only used to process requests and is not persisted. + * A transient resource used in compute.disks.bulkInsert and + * compute.regionDisks.bulkInsert. It is only used to process + * requests and is not persisted. * * Generated from protobuf message google.cloud.compute.v1.BulkInsertDiskResource */ class BulkInsertDiskResource extends \Google\Protobuf\Internal\Message { /** - * The URL of the DiskConsistencyGroupPolicy for the group of disks to clone. This may be a full or partial URL, such as: - https://www.googleapis.com/compute/v1/projects/project/regions/region /resourcePolicies/resourcePolicy - projects/project/regions/region/resourcePolicies/resourcePolicy - regions/region/resourcePolicies/resourcePolicy + * The URL of the DiskConsistencyGroupPolicy for the group of disks to clone. + * This may be a full or partial URL, such as: + * - + * https://www.googleapis.com/compute/v1/projects/project/regions/region/resourcePolicies/resourcePolicy + * - + * projects/project/regions/region/resourcePolicies/resourcePolicy + * - + * regions/region/resourcePolicies/resourcePolicy * * Generated from protobuf field optional string source_consistency_group_policy = 19616093; */ @@ -29,7 +38,14 @@ class BulkInsertDiskResource extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $source_consistency_group_policy - * The URL of the DiskConsistencyGroupPolicy for the group of disks to clone. This may be a full or partial URL, such as: - https://www.googleapis.com/compute/v1/projects/project/regions/region /resourcePolicies/resourcePolicy - projects/project/regions/region/resourcePolicies/resourcePolicy - regions/region/resourcePolicies/resourcePolicy + * The URL of the DiskConsistencyGroupPolicy for the group of disks to clone. + * This may be a full or partial URL, such as: + * - + * https://www.googleapis.com/compute/v1/projects/project/regions/region/resourcePolicies/resourcePolicy + * - + * projects/project/regions/region/resourcePolicies/resourcePolicy + * - + * regions/region/resourcePolicies/resourcePolicy * } */ public function __construct($data = NULL) { @@ -38,7 +54,14 @@ public function __construct($data = NULL) { } /** - * The URL of the DiskConsistencyGroupPolicy for the group of disks to clone. This may be a full or partial URL, such as: - https://www.googleapis.com/compute/v1/projects/project/regions/region /resourcePolicies/resourcePolicy - projects/project/regions/region/resourcePolicies/resourcePolicy - regions/region/resourcePolicies/resourcePolicy + * The URL of the DiskConsistencyGroupPolicy for the group of disks to clone. + * This may be a full or partial URL, such as: + * - + * https://www.googleapis.com/compute/v1/projects/project/regions/region/resourcePolicies/resourcePolicy + * - + * projects/project/regions/region/resourcePolicies/resourcePolicy + * - + * regions/region/resourcePolicies/resourcePolicy * * Generated from protobuf field optional string source_consistency_group_policy = 19616093; * @return string @@ -59,7 +82,14 @@ public function clearSourceConsistencyGroupPolicy() } /** - * The URL of the DiskConsistencyGroupPolicy for the group of disks to clone. This may be a full or partial URL, such as: - https://www.googleapis.com/compute/v1/projects/project/regions/region /resourcePolicies/resourcePolicy - projects/project/regions/region/resourcePolicies/resourcePolicy - regions/region/resourcePolicies/resourcePolicy + * The URL of the DiskConsistencyGroupPolicy for the group of disks to clone. + * This may be a full or partial URL, such as: + * - + * https://www.googleapis.com/compute/v1/projects/project/regions/region/resourcePolicies/resourcePolicy + * - + * projects/project/regions/region/resourcePolicies/resourcePolicy + * - + * regions/region/resourcePolicies/resourcePolicy * * Generated from protobuf field optional string source_consistency_group_policy = 19616093; * @param string $var diff --git a/Compute/src/V1/BulkInsertInstanceRequest.php b/Compute/src/V1/BulkInsertInstanceRequest.php index 27a57ccdb4b9..0a1981d96e87 100644 --- a/Compute/src/V1/BulkInsertInstanceRequest.php +++ b/Compute/src/V1/BulkInsertInstanceRequest.php @@ -28,7 +28,17 @@ class BulkInsertInstanceRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -68,7 +78,17 @@ public static function build(string $project, string $zone, \Google\Cloud\Comput * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $zone * The name of the zone for this request. * } @@ -141,7 +161,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -162,7 +192,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/BulkInsertInstanceResource.php b/Compute/src/V1/BulkInsertInstanceResource.php index 83ead47987d9..a09f3ef2ed57 100644 --- a/Compute/src/V1/BulkInsertInstanceResource.php +++ b/Compute/src/V1/BulkInsertInstanceResource.php @@ -9,7 +9,9 @@ use Google\Protobuf\Internal\GPBUtil; /** - * A transient resource used in compute.instances.bulkInsert and compute.regionInstances.bulkInsert . This resource is not persisted anywhere, it is used only for processing the requests. + * A transient resource used in compute.instances.bulkInsert and + * compute.regionInstances.bulkInsert . This resource is not persisted + * anywhere, it is used only for processing the requests. * * Generated from protobuf message google.cloud.compute.v1.BulkInsertInstanceResource */ @@ -22,37 +24,62 @@ class BulkInsertInstanceResource extends \Google\Protobuf\Internal\Message */ protected $count = null; /** - * The instance properties defining the VM instances to be created. Required if sourceInstanceTemplate is not provided. + * The instance properties defining the VM instances to be created. Required + * if sourceInstanceTemplate is not provided. * * Generated from protobuf field optional .google.cloud.compute.v1.InstanceProperties instance_properties = 215355165; */ protected $instance_properties = null; /** - * Policy for choosing target zone. For more information, see Create VMs in bulk. + * Policy for choosing target zone. For more information, seeCreate VMs in + * bulk. * * Generated from protobuf field optional .google.cloud.compute.v1.LocationPolicy location_policy = 465689852; */ protected $location_policy = null; /** - * The minimum number of instances to create. If no min_count is specified then count is used as the default value. If min_count instances cannot be created, then no instances will be created and instances already created will be deleted. + * The minimum number of instances to create. If no min_count is + * specified then count is used as the default value. Ifmin_count instances cannot be created, then no instances will + * be created and instances already created will be deleted. * * Generated from protobuf field optional int64 min_count = 523228386; */ protected $min_count = null; /** - * The string pattern used for the names of the VMs. Either name_pattern or per_instance_properties must be set. The pattern must contain one continuous sequence of placeholder hash characters (#) with each character corresponding to one digit of the generated instance name. Example: a name_pattern of inst-#### generates instance names such as inst-0001 and inst-0002. If existing instances in the same project and zone have names that match the name pattern then the generated instance numbers start after the biggest existing number. For example, if there exists an instance with name inst-0050, then instance names generated using the pattern inst-#### begin with inst-0051. The name pattern placeholder #...# can contain up to 18 characters. + * The string pattern used for the names of the VMs. + * Either name_pattern or per_instance_properties + * must be set. The pattern must contain one continuous sequence of + * placeholder hash characters (#) with each character corresponding to one + * digit of the generated instance name. Example: a name_pattern + * of inst-#### generates instance names such asinst-0001 and inst-0002. If existing instances + * in the same project and zone have names that match the name pattern + * then the generated instance numbers start after the biggest + * existing number. For example, if there exists an instance with nameinst-0050, then instance names generated using the patterninst-#### begin with inst-0051. The name pattern + * placeholder #...# can contain up to 18 characters. * * Generated from protobuf field optional string name_pattern = 413815260; */ protected $name_pattern = null; /** - * Per-instance properties to be set on individual instances. Keys of this map specify requested instance names. Can be empty if name_pattern is used. + * Per-instance properties to be set on individual instances. + * Keys of this map specify requested instance names. + * Can be empty if name_pattern is used. * * Generated from protobuf field map per_instance_properties = 108502267; */ private $per_instance_properties; /** - * Specifies the instance template from which to create instances. You may combine sourceInstanceTemplate with instanceProperties to override specific values from an existing instance template. Bulk API follows the semantics of JSON Merge Patch described by RFC 7396. It can be a full or partial URL. For example, the following are all valid URLs to an instance template: - https://www.googleapis.com/compute/v1/projects/project /global/instanceTemplates/instanceTemplate - projects/project/global/instanceTemplates/instanceTemplate - global/instanceTemplates/instanceTemplate This field is optional. + * Specifies the instance template from which to create instances. You may + * combine sourceInstanceTemplate withinstanceProperties to override specific values from an + * existing instance template. Bulk API follows the semantics of JSON Merge + * Patch described by RFC + * 7396. + * It can be a full or partial URL. For example, the following are + * all valid URLs to an instance template: + * - https://www.googleapis.com/compute/v1/projects/project/global/instanceTemplates/instanceTemplate + * - projects/project/global/instanceTemplates/instanceTemplate + * - global/instanceTemplates/instanceTemplate + * This field is optional. * * Generated from protobuf field optional string source_instance_template = 332423616; */ @@ -67,17 +94,42 @@ class BulkInsertInstanceResource extends \Google\Protobuf\Internal\Message * @type int|string $count * The maximum number of instances to create. * @type \Google\Cloud\Compute\V1\InstanceProperties $instance_properties - * The instance properties defining the VM instances to be created. Required if sourceInstanceTemplate is not provided. + * The instance properties defining the VM instances to be created. Required + * if sourceInstanceTemplate is not provided. * @type \Google\Cloud\Compute\V1\LocationPolicy $location_policy - * Policy for choosing target zone. For more information, see Create VMs in bulk. + * Policy for choosing target zone. For more information, seeCreate VMs in + * bulk. * @type int|string $min_count - * The minimum number of instances to create. If no min_count is specified then count is used as the default value. If min_count instances cannot be created, then no instances will be created and instances already created will be deleted. + * The minimum number of instances to create. If no min_count is + * specified then count is used as the default value. Ifmin_count instances cannot be created, then no instances will + * be created and instances already created will be deleted. * @type string $name_pattern - * The string pattern used for the names of the VMs. Either name_pattern or per_instance_properties must be set. The pattern must contain one continuous sequence of placeholder hash characters (#) with each character corresponding to one digit of the generated instance name. Example: a name_pattern of inst-#### generates instance names such as inst-0001 and inst-0002. If existing instances in the same project and zone have names that match the name pattern then the generated instance numbers start after the biggest existing number. For example, if there exists an instance with name inst-0050, then instance names generated using the pattern inst-#### begin with inst-0051. The name pattern placeholder #...# can contain up to 18 characters. + * The string pattern used for the names of the VMs. + * Either name_pattern or per_instance_properties + * must be set. The pattern must contain one continuous sequence of + * placeholder hash characters (#) with each character corresponding to one + * digit of the generated instance name. Example: a name_pattern + * of inst-#### generates instance names such asinst-0001 and inst-0002. If existing instances + * in the same project and zone have names that match the name pattern + * then the generated instance numbers start after the biggest + * existing number. For example, if there exists an instance with nameinst-0050, then instance names generated using the patterninst-#### begin with inst-0051. The name pattern + * placeholder #...# can contain up to 18 characters. * @type array|\Google\Protobuf\Internal\MapField $per_instance_properties - * Per-instance properties to be set on individual instances. Keys of this map specify requested instance names. Can be empty if name_pattern is used. + * Per-instance properties to be set on individual instances. + * Keys of this map specify requested instance names. + * Can be empty if name_pattern is used. * @type string $source_instance_template - * Specifies the instance template from which to create instances. You may combine sourceInstanceTemplate with instanceProperties to override specific values from an existing instance template. Bulk API follows the semantics of JSON Merge Patch described by RFC 7396. It can be a full or partial URL. For example, the following are all valid URLs to an instance template: - https://www.googleapis.com/compute/v1/projects/project /global/instanceTemplates/instanceTemplate - projects/project/global/instanceTemplates/instanceTemplate - global/instanceTemplates/instanceTemplate This field is optional. + * Specifies the instance template from which to create instances. You may + * combine sourceInstanceTemplate withinstanceProperties to override specific values from an + * existing instance template. Bulk API follows the semantics of JSON Merge + * Patch described by RFC + * 7396. + * It can be a full or partial URL. For example, the following are + * all valid URLs to an instance template: + * - https://www.googleapis.com/compute/v1/projects/project/global/instanceTemplates/instanceTemplate + * - projects/project/global/instanceTemplates/instanceTemplate + * - global/instanceTemplates/instanceTemplate + * This field is optional. * } */ public function __construct($data = NULL) { @@ -122,7 +174,8 @@ public function setCount($var) } /** - * The instance properties defining the VM instances to be created. Required if sourceInstanceTemplate is not provided. + * The instance properties defining the VM instances to be created. Required + * if sourceInstanceTemplate is not provided. * * Generated from protobuf field optional .google.cloud.compute.v1.InstanceProperties instance_properties = 215355165; * @return \Google\Cloud\Compute\V1\InstanceProperties|null @@ -143,7 +196,8 @@ public function clearInstanceProperties() } /** - * The instance properties defining the VM instances to be created. Required if sourceInstanceTemplate is not provided. + * The instance properties defining the VM instances to be created. Required + * if sourceInstanceTemplate is not provided. * * Generated from protobuf field optional .google.cloud.compute.v1.InstanceProperties instance_properties = 215355165; * @param \Google\Cloud\Compute\V1\InstanceProperties $var @@ -158,7 +212,8 @@ public function setInstanceProperties($var) } /** - * Policy for choosing target zone. For more information, see Create VMs in bulk. + * Policy for choosing target zone. For more information, seeCreate VMs in + * bulk. * * Generated from protobuf field optional .google.cloud.compute.v1.LocationPolicy location_policy = 465689852; * @return \Google\Cloud\Compute\V1\LocationPolicy|null @@ -179,7 +234,8 @@ public function clearLocationPolicy() } /** - * Policy for choosing target zone. For more information, see Create VMs in bulk. + * Policy for choosing target zone. For more information, seeCreate VMs in + * bulk. * * Generated from protobuf field optional .google.cloud.compute.v1.LocationPolicy location_policy = 465689852; * @param \Google\Cloud\Compute\V1\LocationPolicy $var @@ -194,7 +250,9 @@ public function setLocationPolicy($var) } /** - * The minimum number of instances to create. If no min_count is specified then count is used as the default value. If min_count instances cannot be created, then no instances will be created and instances already created will be deleted. + * The minimum number of instances to create. If no min_count is + * specified then count is used as the default value. Ifmin_count instances cannot be created, then no instances will + * be created and instances already created will be deleted. * * Generated from protobuf field optional int64 min_count = 523228386; * @return int|string @@ -215,7 +273,9 @@ public function clearMinCount() } /** - * The minimum number of instances to create. If no min_count is specified then count is used as the default value. If min_count instances cannot be created, then no instances will be created and instances already created will be deleted. + * The minimum number of instances to create. If no min_count is + * specified then count is used as the default value. Ifmin_count instances cannot be created, then no instances will + * be created and instances already created will be deleted. * * Generated from protobuf field optional int64 min_count = 523228386; * @param int|string $var @@ -230,7 +290,16 @@ public function setMinCount($var) } /** - * The string pattern used for the names of the VMs. Either name_pattern or per_instance_properties must be set. The pattern must contain one continuous sequence of placeholder hash characters (#) with each character corresponding to one digit of the generated instance name. Example: a name_pattern of inst-#### generates instance names such as inst-0001 and inst-0002. If existing instances in the same project and zone have names that match the name pattern then the generated instance numbers start after the biggest existing number. For example, if there exists an instance with name inst-0050, then instance names generated using the pattern inst-#### begin with inst-0051. The name pattern placeholder #...# can contain up to 18 characters. + * The string pattern used for the names of the VMs. + * Either name_pattern or per_instance_properties + * must be set. The pattern must contain one continuous sequence of + * placeholder hash characters (#) with each character corresponding to one + * digit of the generated instance name. Example: a name_pattern + * of inst-#### generates instance names such asinst-0001 and inst-0002. If existing instances + * in the same project and zone have names that match the name pattern + * then the generated instance numbers start after the biggest + * existing number. For example, if there exists an instance with nameinst-0050, then instance names generated using the patterninst-#### begin with inst-0051. The name pattern + * placeholder #...# can contain up to 18 characters. * * Generated from protobuf field optional string name_pattern = 413815260; * @return string @@ -251,7 +320,16 @@ public function clearNamePattern() } /** - * The string pattern used for the names of the VMs. Either name_pattern or per_instance_properties must be set. The pattern must contain one continuous sequence of placeholder hash characters (#) with each character corresponding to one digit of the generated instance name. Example: a name_pattern of inst-#### generates instance names such as inst-0001 and inst-0002. If existing instances in the same project and zone have names that match the name pattern then the generated instance numbers start after the biggest existing number. For example, if there exists an instance with name inst-0050, then instance names generated using the pattern inst-#### begin with inst-0051. The name pattern placeholder #...# can contain up to 18 characters. + * The string pattern used for the names of the VMs. + * Either name_pattern or per_instance_properties + * must be set. The pattern must contain one continuous sequence of + * placeholder hash characters (#) with each character corresponding to one + * digit of the generated instance name. Example: a name_pattern + * of inst-#### generates instance names such asinst-0001 and inst-0002. If existing instances + * in the same project and zone have names that match the name pattern + * then the generated instance numbers start after the biggest + * existing number. For example, if there exists an instance with nameinst-0050, then instance names generated using the patterninst-#### begin with inst-0051. The name pattern + * placeholder #...# can contain up to 18 characters. * * Generated from protobuf field optional string name_pattern = 413815260; * @param string $var @@ -266,7 +344,9 @@ public function setNamePattern($var) } /** - * Per-instance properties to be set on individual instances. Keys of this map specify requested instance names. Can be empty if name_pattern is used. + * Per-instance properties to be set on individual instances. + * Keys of this map specify requested instance names. + * Can be empty if name_pattern is used. * * Generated from protobuf field map per_instance_properties = 108502267; * @return \Google\Protobuf\Internal\MapField @@ -277,7 +357,9 @@ public function getPerInstanceProperties() } /** - * Per-instance properties to be set on individual instances. Keys of this map specify requested instance names. Can be empty if name_pattern is used. + * Per-instance properties to be set on individual instances. + * Keys of this map specify requested instance names. + * Can be empty if name_pattern is used. * * Generated from protobuf field map per_instance_properties = 108502267; * @param array|\Google\Protobuf\Internal\MapField $var @@ -292,7 +374,17 @@ public function setPerInstanceProperties($var) } /** - * Specifies the instance template from which to create instances. You may combine sourceInstanceTemplate with instanceProperties to override specific values from an existing instance template. Bulk API follows the semantics of JSON Merge Patch described by RFC 7396. It can be a full or partial URL. For example, the following are all valid URLs to an instance template: - https://www.googleapis.com/compute/v1/projects/project /global/instanceTemplates/instanceTemplate - projects/project/global/instanceTemplates/instanceTemplate - global/instanceTemplates/instanceTemplate This field is optional. + * Specifies the instance template from which to create instances. You may + * combine sourceInstanceTemplate withinstanceProperties to override specific values from an + * existing instance template. Bulk API follows the semantics of JSON Merge + * Patch described by RFC + * 7396. + * It can be a full or partial URL. For example, the following are + * all valid URLs to an instance template: + * - https://www.googleapis.com/compute/v1/projects/project/global/instanceTemplates/instanceTemplate + * - projects/project/global/instanceTemplates/instanceTemplate + * - global/instanceTemplates/instanceTemplate + * This field is optional. * * Generated from protobuf field optional string source_instance_template = 332423616; * @return string @@ -313,7 +405,17 @@ public function clearSourceInstanceTemplate() } /** - * Specifies the instance template from which to create instances. You may combine sourceInstanceTemplate with instanceProperties to override specific values from an existing instance template. Bulk API follows the semantics of JSON Merge Patch described by RFC 7396. It can be a full or partial URL. For example, the following are all valid URLs to an instance template: - https://www.googleapis.com/compute/v1/projects/project /global/instanceTemplates/instanceTemplate - projects/project/global/instanceTemplates/instanceTemplate - global/instanceTemplates/instanceTemplate This field is optional. + * Specifies the instance template from which to create instances. You may + * combine sourceInstanceTemplate withinstanceProperties to override specific values from an + * existing instance template. Bulk API follows the semantics of JSON Merge + * Patch described by RFC + * 7396. + * It can be a full or partial URL. For example, the following are + * all valid URLs to an instance template: + * - https://www.googleapis.com/compute/v1/projects/project/global/instanceTemplates/instanceTemplate + * - projects/project/global/instanceTemplates/instanceTemplate + * - global/instanceTemplates/instanceTemplate + * This field is optional. * * Generated from protobuf field optional string source_instance_template = 332423616; * @param string $var diff --git a/Compute/src/V1/BulkInsertInstanceResourcePerInstanceProperties.php b/Compute/src/V1/BulkInsertInstanceResourcePerInstanceProperties.php index 394fdae695c9..0ba1bb4efd46 100644 --- a/Compute/src/V1/BulkInsertInstanceResourcePerInstanceProperties.php +++ b/Compute/src/V1/BulkInsertInstanceResourcePerInstanceProperties.php @@ -9,14 +9,16 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Per-instance properties to be set on individual instances. To be extended in the future. + * Per-instance properties to be set on individual instances. + * To be extended in the future. * * Generated from protobuf message google.cloud.compute.v1.BulkInsertInstanceResourcePerInstanceProperties */ class BulkInsertInstanceResourcePerInstanceProperties extends \Google\Protobuf\Internal\Message { /** - * Specifies the hostname of the instance. More details in: https://cloud.google.com/compute/docs/instances/custom-hostname-vm#naming_convention + * Specifies the hostname of the instance. More details in: + * https://cloud.google.com/compute/docs/instances/custom-hostname-vm#naming_convention * * Generated from protobuf field optional string hostname = 237067315; */ @@ -35,7 +37,8 @@ class BulkInsertInstanceResourcePerInstanceProperties extends \Google\Protobuf\I * Optional. Data for populating the Message object. * * @type string $hostname - * Specifies the hostname of the instance. More details in: https://cloud.google.com/compute/docs/instances/custom-hostname-vm#naming_convention + * Specifies the hostname of the instance. More details in: + * https://cloud.google.com/compute/docs/instances/custom-hostname-vm#naming_convention * @type string $name * This field is only temporary. It will be removed. Do not use it. * } @@ -46,7 +49,8 @@ public function __construct($data = NULL) { } /** - * Specifies the hostname of the instance. More details in: https://cloud.google.com/compute/docs/instances/custom-hostname-vm#naming_convention + * Specifies the hostname of the instance. More details in: + * https://cloud.google.com/compute/docs/instances/custom-hostname-vm#naming_convention * * Generated from protobuf field optional string hostname = 237067315; * @return string @@ -67,7 +71,8 @@ public function clearHostname() } /** - * Specifies the hostname of the instance. More details in: https://cloud.google.com/compute/docs/instances/custom-hostname-vm#naming_convention + * Specifies the hostname of the instance. More details in: + * https://cloud.google.com/compute/docs/instances/custom-hostname-vm#naming_convention * * Generated from protobuf field optional string hostname = 237067315; * @param string $var diff --git a/Compute/src/V1/BulkInsertOperationStatus.php b/Compute/src/V1/BulkInsertOperationStatus.php index 7a4be2a061f4..3ef23bfdbb76 100644 --- a/Compute/src/V1/BulkInsertOperationStatus.php +++ b/Compute/src/V1/BulkInsertOperationStatus.php @@ -27,13 +27,15 @@ class BulkInsertOperationStatus extends \Google\Protobuf\Internal\Message */ protected $deleted_vm_count = null; /** - * [Output Only] Count of VMs that started creating but encountered an error. + * [Output Only] Count of VMs that started creating but encountered an + * error. * * Generated from protobuf field optional int32 failed_to_create_vm_count = 58384104; */ protected $failed_to_create_vm_count = null; /** - * [Output Only] Creation status of BulkInsert operation - information if the flow is rolling forward or rolling back. + * [Output Only] Creation status of BulkInsert operation - information + * if the flow is rolling forward or rolling back. * Check the Status enum for the list of possible values. * * Generated from protobuf field optional string status = 181260274; @@ -57,9 +59,11 @@ class BulkInsertOperationStatus extends \Google\Protobuf\Internal\Message * @type int $deleted_vm_count * [Output Only] Count of VMs that got deleted during rollback. * @type int $failed_to_create_vm_count - * [Output Only] Count of VMs that started creating but encountered an error. + * [Output Only] Count of VMs that started creating but encountered an + * error. * @type string $status - * [Output Only] Creation status of BulkInsert operation - information if the flow is rolling forward or rolling back. + * [Output Only] Creation status of BulkInsert operation - information + * if the flow is rolling forward or rolling back. * Check the Status enum for the list of possible values. * @type int $target_vm_count * [Output Only] Count of VMs originally planned to be created. @@ -143,7 +147,8 @@ public function setDeletedVmCount($var) } /** - * [Output Only] Count of VMs that started creating but encountered an error. + * [Output Only] Count of VMs that started creating but encountered an + * error. * * Generated from protobuf field optional int32 failed_to_create_vm_count = 58384104; * @return int @@ -164,7 +169,8 @@ public function clearFailedToCreateVmCount() } /** - * [Output Only] Count of VMs that started creating but encountered an error. + * [Output Only] Count of VMs that started creating but encountered an + * error. * * Generated from protobuf field optional int32 failed_to_create_vm_count = 58384104; * @param int $var @@ -179,7 +185,8 @@ public function setFailedToCreateVmCount($var) } /** - * [Output Only] Creation status of BulkInsert operation - information if the flow is rolling forward or rolling back. + * [Output Only] Creation status of BulkInsert operation - information + * if the flow is rolling forward or rolling back. * Check the Status enum for the list of possible values. * * Generated from protobuf field optional string status = 181260274; @@ -201,7 +208,8 @@ public function clearStatus() } /** - * [Output Only] Creation status of BulkInsert operation - information if the flow is rolling forward or rolling back. + * [Output Only] Creation status of BulkInsert operation - information + * if the flow is rolling forward or rolling back. * Check the Status enum for the list of possible values. * * Generated from protobuf field optional string status = 181260274; diff --git a/Compute/src/V1/BulkInsertOperationStatus/Status.php b/Compute/src/V1/BulkInsertOperationStatus/Status.php index e35bf534f7b6..5be5af0fecae 100644 --- a/Compute/src/V1/BulkInsertOperationStatus/Status.php +++ b/Compute/src/V1/BulkInsertOperationStatus/Status.php @@ -7,7 +7,8 @@ use UnexpectedValueException; /** - * [Output Only] Creation status of BulkInsert operation - information if the flow is rolling forward or rolling back. + * [Output Only] Creation status of BulkInsert operation - information + * if the flow is rolling forward or rolling back. * * Protobuf type google.cloud.compute.v1.BulkInsertOperationStatus.Status */ diff --git a/Compute/src/V1/BulkInsertRegionDiskRequest.php b/Compute/src/V1/BulkInsertRegionDiskRequest.php index 751f8b18af09..fe06a74b9c7e 100644 --- a/Compute/src/V1/BulkInsertRegionDiskRequest.php +++ b/Compute/src/V1/BulkInsertRegionDiskRequest.php @@ -34,7 +34,17 @@ class BulkInsertRegionDiskRequest extends \Google\Protobuf\Internal\Message */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -70,7 +80,17 @@ public static function build(string $project, string $region, \Google\Cloud\Comp * @type string $region * The name of the region for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -167,7 +187,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -188,7 +218,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/BulkInsertRegionInstanceRequest.php b/Compute/src/V1/BulkInsertRegionInstanceRequest.php index 33f6340d830f..3b621ec9f1ce 100644 --- a/Compute/src/V1/BulkInsertRegionInstanceRequest.php +++ b/Compute/src/V1/BulkInsertRegionInstanceRequest.php @@ -34,7 +34,17 @@ class BulkInsertRegionInstanceRequest extends \Google\Protobuf\Internal\Message */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -70,7 +80,17 @@ public static function build(string $project, string $region, \Google\Cloud\Comp * @type string $region * The name of the region for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -167,7 +187,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -188,7 +218,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/BulkSetLabelsDiskRequest.php b/Compute/src/V1/BulkSetLabelsDiskRequest.php index 102db2f87026..c313587400fc 100644 --- a/Compute/src/V1/BulkSetLabelsDiskRequest.php +++ b/Compute/src/V1/BulkSetLabelsDiskRequest.php @@ -28,7 +28,17 @@ class BulkSetLabelsDiskRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -74,7 +84,17 @@ public static function build(string $project, string $zone, \Google\Cloud\Comput * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $resource * Name or id of the resource for this request. * @type string $zone @@ -149,7 +169,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -170,7 +200,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/BulkSetLabelsRequest.php b/Compute/src/V1/BulkSetLabelsRequest.php index cfda7f60b035..70a6a8a83625 100644 --- a/Compute/src/V1/BulkSetLabelsRequest.php +++ b/Compute/src/V1/BulkSetLabelsRequest.php @@ -15,7 +15,12 @@ class BulkSetLabelsRequest extends \Google\Protobuf\Internal\Message { /** - * The fingerprint of the previous set of labels for this resource, used to detect conflicts. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You may optionally provide an up-to-date fingerprint hash in order to update or change labels. Make a get() request to the resource to get the latest fingerprint. + * The fingerprint of the previous set of labels for this resource, + * used to detect conflicts. The fingerprint is initially generated by Compute + * Engine and changes after every request to modify or update labels. You may + * optionally provide an up-to-date fingerprint hash in order to update or + * change labels. Make a get() request to the resource to get the + * latest fingerprint. * * Generated from protobuf field optional string label_fingerprint = 178124825; */ @@ -34,7 +39,12 @@ class BulkSetLabelsRequest extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $label_fingerprint - * The fingerprint of the previous set of labels for this resource, used to detect conflicts. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You may optionally provide an up-to-date fingerprint hash in order to update or change labels. Make a get() request to the resource to get the latest fingerprint. + * The fingerprint of the previous set of labels for this resource, + * used to detect conflicts. The fingerprint is initially generated by Compute + * Engine and changes after every request to modify or update labels. You may + * optionally provide an up-to-date fingerprint hash in order to update or + * change labels. Make a get() request to the resource to get the + * latest fingerprint. * @type array|\Google\Protobuf\Internal\MapField $labels * The labels to set for this resource. * } @@ -45,7 +55,12 @@ public function __construct($data = NULL) { } /** - * The fingerprint of the previous set of labels for this resource, used to detect conflicts. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You may optionally provide an up-to-date fingerprint hash in order to update or change labels. Make a get() request to the resource to get the latest fingerprint. + * The fingerprint of the previous set of labels for this resource, + * used to detect conflicts. The fingerprint is initially generated by Compute + * Engine and changes after every request to modify or update labels. You may + * optionally provide an up-to-date fingerprint hash in order to update or + * change labels. Make a get() request to the resource to get the + * latest fingerprint. * * Generated from protobuf field optional string label_fingerprint = 178124825; * @return string @@ -66,7 +81,12 @@ public function clearLabelFingerprint() } /** - * The fingerprint of the previous set of labels for this resource, used to detect conflicts. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You may optionally provide an up-to-date fingerprint hash in order to update or change labels. Make a get() request to the resource to get the latest fingerprint. + * The fingerprint of the previous set of labels for this resource, + * used to detect conflicts. The fingerprint is initially generated by Compute + * Engine and changes after every request to modify or update labels. You may + * optionally provide an up-to-date fingerprint hash in order to update or + * change labels. Make a get() request to the resource to get the + * latest fingerprint. * * Generated from protobuf field optional string label_fingerprint = 178124825; * @param string $var diff --git a/Compute/src/V1/CacheInvalidationRule.php b/Compute/src/V1/CacheInvalidationRule.php index 39830311328d..f2b9a4793e3a 100644 --- a/Compute/src/V1/CacheInvalidationRule.php +++ b/Compute/src/V1/CacheInvalidationRule.php @@ -15,13 +15,21 @@ class CacheInvalidationRule extends \Google\Protobuf\Internal\Message { /** - * A list of cache tags used to identify cached objects. - Cache tags are specified when the response is first cached, by setting the `Cache-Tag` response header at the origin. - Multiple cache tags in the same invalidation request are treated as Boolean `OR` - for example, `tag1 OR tag2 OR tag3`. - If other fields are also specified, these are treated as Boolean `AND` with any tags. Up to 10 tags can be specified in a single invalidation request. + * A list of cache tags used to identify cached objects. + * - Cache tags are specified when the response is first cached, by setting + * the `Cache-Tag` response header at the origin. + * - Multiple cache tags in the same invalidation request are treated as + * Boolean `OR` - for example, `tag1 OR tag2 OR tag3`. + * - If other fields are also specified, these are treated as Boolean `AND` + * with any tags. + * Up to 10 tags can be specified in a single invalidation request. * * Generated from protobuf field repeated string cache_tags = 29073078; */ private $cache_tags; /** - * If set, this invalidation rule will only apply to requests with a Host header matching host. + * If set, this invalidation rule will only apply to requests with a Host + * header matching host. * * Generated from protobuf field optional string host = 3208616; */ @@ -38,9 +46,17 @@ class CacheInvalidationRule extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type array|\Google\Protobuf\Internal\RepeatedField $cache_tags - * A list of cache tags used to identify cached objects. - Cache tags are specified when the response is first cached, by setting the `Cache-Tag` response header at the origin. - Multiple cache tags in the same invalidation request are treated as Boolean `OR` - for example, `tag1 OR tag2 OR tag3`. - If other fields are also specified, these are treated as Boolean `AND` with any tags. Up to 10 tags can be specified in a single invalidation request. + * A list of cache tags used to identify cached objects. + * - Cache tags are specified when the response is first cached, by setting + * the `Cache-Tag` response header at the origin. + * - Multiple cache tags in the same invalidation request are treated as + * Boolean `OR` - for example, `tag1 OR tag2 OR tag3`. + * - If other fields are also specified, these are treated as Boolean `AND` + * with any tags. + * Up to 10 tags can be specified in a single invalidation request. * @type string $host - * If set, this invalidation rule will only apply to requests with a Host header matching host. + * If set, this invalidation rule will only apply to requests with a Host + * header matching host. * @type string $path * } */ @@ -50,7 +66,14 @@ public function __construct($data = NULL) { } /** - * A list of cache tags used to identify cached objects. - Cache tags are specified when the response is first cached, by setting the `Cache-Tag` response header at the origin. - Multiple cache tags in the same invalidation request are treated as Boolean `OR` - for example, `tag1 OR tag2 OR tag3`. - If other fields are also specified, these are treated as Boolean `AND` with any tags. Up to 10 tags can be specified in a single invalidation request. + * A list of cache tags used to identify cached objects. + * - Cache tags are specified when the response is first cached, by setting + * the `Cache-Tag` response header at the origin. + * - Multiple cache tags in the same invalidation request are treated as + * Boolean `OR` - for example, `tag1 OR tag2 OR tag3`. + * - If other fields are also specified, these are treated as Boolean `AND` + * with any tags. + * Up to 10 tags can be specified in a single invalidation request. * * Generated from protobuf field repeated string cache_tags = 29073078; * @return \Google\Protobuf\Internal\RepeatedField @@ -61,7 +84,14 @@ public function getCacheTags() } /** - * A list of cache tags used to identify cached objects. - Cache tags are specified when the response is first cached, by setting the `Cache-Tag` response header at the origin. - Multiple cache tags in the same invalidation request are treated as Boolean `OR` - for example, `tag1 OR tag2 OR tag3`. - If other fields are also specified, these are treated as Boolean `AND` with any tags. Up to 10 tags can be specified in a single invalidation request. + * A list of cache tags used to identify cached objects. + * - Cache tags are specified when the response is first cached, by setting + * the `Cache-Tag` response header at the origin. + * - Multiple cache tags in the same invalidation request are treated as + * Boolean `OR` - for example, `tag1 OR tag2 OR tag3`. + * - If other fields are also specified, these are treated as Boolean `AND` + * with any tags. + * Up to 10 tags can be specified in a single invalidation request. * * Generated from protobuf field repeated string cache_tags = 29073078; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -76,7 +106,8 @@ public function setCacheTags($var) } /** - * If set, this invalidation rule will only apply to requests with a Host header matching host. + * If set, this invalidation rule will only apply to requests with a Host + * header matching host. * * Generated from protobuf field optional string host = 3208616; * @return string @@ -97,7 +128,8 @@ public function clearHost() } /** - * If set, this invalidation rule will only apply to requests with a Host header matching host. + * If set, this invalidation rule will only apply to requests with a Host + * header matching host. * * Generated from protobuf field optional string host = 3208616; * @param string $var diff --git a/Compute/src/V1/CacheKeyPolicy.php b/Compute/src/V1/CacheKeyPolicy.php index e2b55657b05b..e2c514378635 100644 --- a/Compute/src/V1/CacheKeyPolicy.php +++ b/Compute/src/V1/CacheKeyPolicy.php @@ -9,7 +9,8 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Message containing what to include in the cache key for a request for Cloud CDN. + * Message containing what to include in the cache key for a request for Cloud + * CDN. * * Generated from protobuf message google.cloud.compute.v1.CacheKeyPolicy */ @@ -28,7 +29,8 @@ class CacheKeyPolicy extends \Google\Protobuf\Internal\Message */ private $include_http_headers; /** - * Allows HTTP cookies (by name) to be used in the cache key. The name=value pair will be used in the cache key Cloud CDN generates. + * Allows HTTP cookies (by name) to be used in the cache key. + * The name=value pair will be used in the cache key Cloud CDN generates. * * Generated from protobuf field repeated string include_named_cookies = 87316530; */ @@ -40,19 +42,28 @@ class CacheKeyPolicy extends \Google\Protobuf\Internal\Message */ protected $include_protocol = null; /** - * If true, include query string parameters in the cache key according to query_string_whitelist and query_string_blacklist. If neither is set, the entire query string will be included. If false, the query string will be excluded from the cache key entirely. + * If true, include query string parameters in the cache key according to + * query_string_whitelist and query_string_blacklist. If neither is set, the + * entire query string will be included. If false, the query string will be + * excluded from the cache key entirely. * * Generated from protobuf field optional bool include_query_string = 474036639; */ protected $include_query_string = null; /** - * Names of query string parameters to exclude in cache keys. All other parameters will be included. Either specify query_string_whitelist or query_string_blacklist, not both. '&' and '=' will be percent encoded and not treated as delimiters. + * Names of query string parameters to exclude in cache keys. All other + * parameters will be included. Either specify query_string_whitelist or + * query_string_blacklist, not both. '&' and '=' will be percent encoded and + * not treated as delimiters. * * Generated from protobuf field repeated string query_string_blacklist = 354964742; */ private $query_string_blacklist; /** - * Names of query string parameters to include in cache keys. All other parameters will be excluded. Either specify query_string_whitelist or query_string_blacklist, not both. '&' and '=' will be percent encoded and not treated as delimiters. + * Names of query string parameters to include in cache keys. All other + * parameters will be excluded. Either specify query_string_whitelist or + * query_string_blacklist, not both. '&' and '=' will be percent encoded and + * not treated as delimiters. * * Generated from protobuf field repeated string query_string_whitelist = 52456496; */ @@ -69,15 +80,25 @@ class CacheKeyPolicy extends \Google\Protobuf\Internal\Message * @type array|\Google\Protobuf\Internal\RepeatedField $include_http_headers * Allows HTTP request headers (by name) to be used in the cache key. * @type array|\Google\Protobuf\Internal\RepeatedField $include_named_cookies - * Allows HTTP cookies (by name) to be used in the cache key. The name=value pair will be used in the cache key Cloud CDN generates. + * Allows HTTP cookies (by name) to be used in the cache key. + * The name=value pair will be used in the cache key Cloud CDN generates. * @type bool $include_protocol * If true, http and https requests will be cached separately. * @type bool $include_query_string - * If true, include query string parameters in the cache key according to query_string_whitelist and query_string_blacklist. If neither is set, the entire query string will be included. If false, the query string will be excluded from the cache key entirely. + * If true, include query string parameters in the cache key according to + * query_string_whitelist and query_string_blacklist. If neither is set, the + * entire query string will be included. If false, the query string will be + * excluded from the cache key entirely. * @type array|\Google\Protobuf\Internal\RepeatedField $query_string_blacklist - * Names of query string parameters to exclude in cache keys. All other parameters will be included. Either specify query_string_whitelist or query_string_blacklist, not both. '&' and '=' will be percent encoded and not treated as delimiters. + * Names of query string parameters to exclude in cache keys. All other + * parameters will be included. Either specify query_string_whitelist or + * query_string_blacklist, not both. '&' and '=' will be percent encoded and + * not treated as delimiters. * @type array|\Google\Protobuf\Internal\RepeatedField $query_string_whitelist - * Names of query string parameters to include in cache keys. All other parameters will be excluded. Either specify query_string_whitelist or query_string_blacklist, not both. '&' and '=' will be percent encoded and not treated as delimiters. + * Names of query string parameters to include in cache keys. All other + * parameters will be excluded. Either specify query_string_whitelist or + * query_string_blacklist, not both. '&' and '=' will be percent encoded and + * not treated as delimiters. * } */ public function __construct($data = NULL) { @@ -148,7 +169,8 @@ public function setIncludeHttpHeaders($var) } /** - * Allows HTTP cookies (by name) to be used in the cache key. The name=value pair will be used in the cache key Cloud CDN generates. + * Allows HTTP cookies (by name) to be used in the cache key. + * The name=value pair will be used in the cache key Cloud CDN generates. * * Generated from protobuf field repeated string include_named_cookies = 87316530; * @return \Google\Protobuf\Internal\RepeatedField @@ -159,7 +181,8 @@ public function getIncludeNamedCookies() } /** - * Allows HTTP cookies (by name) to be used in the cache key. The name=value pair will be used in the cache key Cloud CDN generates. + * Allows HTTP cookies (by name) to be used in the cache key. + * The name=value pair will be used in the cache key Cloud CDN generates. * * Generated from protobuf field repeated string include_named_cookies = 87316530; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -210,7 +233,10 @@ public function setIncludeProtocol($var) } /** - * If true, include query string parameters in the cache key according to query_string_whitelist and query_string_blacklist. If neither is set, the entire query string will be included. If false, the query string will be excluded from the cache key entirely. + * If true, include query string parameters in the cache key according to + * query_string_whitelist and query_string_blacklist. If neither is set, the + * entire query string will be included. If false, the query string will be + * excluded from the cache key entirely. * * Generated from protobuf field optional bool include_query_string = 474036639; * @return bool @@ -231,7 +257,10 @@ public function clearIncludeQueryString() } /** - * If true, include query string parameters in the cache key according to query_string_whitelist and query_string_blacklist. If neither is set, the entire query string will be included. If false, the query string will be excluded from the cache key entirely. + * If true, include query string parameters in the cache key according to + * query_string_whitelist and query_string_blacklist. If neither is set, the + * entire query string will be included. If false, the query string will be + * excluded from the cache key entirely. * * Generated from protobuf field optional bool include_query_string = 474036639; * @param bool $var @@ -246,7 +275,10 @@ public function setIncludeQueryString($var) } /** - * Names of query string parameters to exclude in cache keys. All other parameters will be included. Either specify query_string_whitelist or query_string_blacklist, not both. '&' and '=' will be percent encoded and not treated as delimiters. + * Names of query string parameters to exclude in cache keys. All other + * parameters will be included. Either specify query_string_whitelist or + * query_string_blacklist, not both. '&' and '=' will be percent encoded and + * not treated as delimiters. * * Generated from protobuf field repeated string query_string_blacklist = 354964742; * @return \Google\Protobuf\Internal\RepeatedField @@ -257,7 +289,10 @@ public function getQueryStringBlacklist() } /** - * Names of query string parameters to exclude in cache keys. All other parameters will be included. Either specify query_string_whitelist or query_string_blacklist, not both. '&' and '=' will be percent encoded and not treated as delimiters. + * Names of query string parameters to exclude in cache keys. All other + * parameters will be included. Either specify query_string_whitelist or + * query_string_blacklist, not both. '&' and '=' will be percent encoded and + * not treated as delimiters. * * Generated from protobuf field repeated string query_string_blacklist = 354964742; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -272,7 +307,10 @@ public function setQueryStringBlacklist($var) } /** - * Names of query string parameters to include in cache keys. All other parameters will be excluded. Either specify query_string_whitelist or query_string_blacklist, not both. '&' and '=' will be percent encoded and not treated as delimiters. + * Names of query string parameters to include in cache keys. All other + * parameters will be excluded. Either specify query_string_whitelist or + * query_string_blacklist, not both. '&' and '=' will be percent encoded and + * not treated as delimiters. * * Generated from protobuf field repeated string query_string_whitelist = 52456496; * @return \Google\Protobuf\Internal\RepeatedField @@ -283,7 +321,10 @@ public function getQueryStringWhitelist() } /** - * Names of query string parameters to include in cache keys. All other parameters will be excluded. Either specify query_string_whitelist or query_string_blacklist, not both. '&' and '=' will be percent encoded and not treated as delimiters. + * Names of query string parameters to include in cache keys. All other + * parameters will be excluded. Either specify query_string_whitelist or + * query_string_blacklist, not both. '&' and '=' will be percent encoded and + * not treated as delimiters. * * Generated from protobuf field repeated string query_string_whitelist = 52456496; * @param array|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/CancelFutureReservationRequest.php b/Compute/src/V1/CancelFutureReservationRequest.php new file mode 100644 index 000000000000..09e9ed1b9599 --- /dev/null +++ b/Compute/src/V1/CancelFutureReservationRequest.php @@ -0,0 +1,236 @@ +google.cloud.compute.v1.CancelFutureReservationRequest + */ +class CancelFutureReservationRequest extends \Google\Protobuf\Internal\Message +{ + /** + * Name of the future reservation to retrieve. Name should conform to RFC1035. + * + * Generated from protobuf field string future_reservation = 56206160 [(.google.api.field_behavior) = REQUIRED]; + */ + protected $future_reservation = ''; + /** + * Project ID for this request. + * + * Generated from protobuf field string project = 227560217 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "project"]; + */ + protected $project = ''; + /** + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). + * + * Generated from protobuf field optional string request_id = 37109963; + */ + protected $request_id = null; + /** + * Name of the zone for this request. Name should conform to RFC1035. + * + * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; + */ + protected $zone = ''; + + /** + * @param string $project Project ID for this request. + * @param string $zone Name of the zone for this request. Name should conform to RFC1035. + * @param string $futureReservation Name of the future reservation to retrieve. Name should conform to RFC1035. + * + * @return \Google\Cloud\Compute\V1\CancelFutureReservationRequest + * + * @experimental + */ + public static function build(string $project, string $zone, string $futureReservation): self + { + return (new self()) + ->setProject($project) + ->setZone($zone) + ->setFutureReservation($futureReservation); + } + + /** + * Constructor. + * + * @param array $data { + * Optional. Data for populating the Message object. + * + * @type string $future_reservation + * Name of the future reservation to retrieve. Name should conform to RFC1035. + * @type string $project + * Project ID for this request. + * @type string $request_id + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). + * @type string $zone + * Name of the zone for this request. Name should conform to RFC1035. + * } + */ + public function __construct($data = NULL) { + \GPBMetadata\Google\Cloud\Compute\V1\Compute::initOnce(); + parent::__construct($data); + } + + /** + * Name of the future reservation to retrieve. Name should conform to RFC1035. + * + * Generated from protobuf field string future_reservation = 56206160 [(.google.api.field_behavior) = REQUIRED]; + * @return string + */ + public function getFutureReservation() + { + return $this->future_reservation; + } + + /** + * Name of the future reservation to retrieve. Name should conform to RFC1035. + * + * Generated from protobuf field string future_reservation = 56206160 [(.google.api.field_behavior) = REQUIRED]; + * @param string $var + * @return $this + */ + public function setFutureReservation($var) + { + GPBUtil::checkString($var, True); + $this->future_reservation = $var; + + return $this; + } + + /** + * Project ID for this request. + * + * Generated from protobuf field string project = 227560217 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "project"]; + * @return string + */ + public function getProject() + { + return $this->project; + } + + /** + * Project ID for this request. + * + * Generated from protobuf field string project = 227560217 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "project"]; + * @param string $var + * @return $this + */ + public function setProject($var) + { + GPBUtil::checkString($var, True); + $this->project = $var; + + return $this; + } + + /** + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). + * + * Generated from protobuf field optional string request_id = 37109963; + * @return string + */ + public function getRequestId() + { + return isset($this->request_id) ? $this->request_id : ''; + } + + public function hasRequestId() + { + return isset($this->request_id); + } + + public function clearRequestId() + { + unset($this->request_id); + } + + /** + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). + * + * Generated from protobuf field optional string request_id = 37109963; + * @param string $var + * @return $this + */ + public function setRequestId($var) + { + GPBUtil::checkString($var, True); + $this->request_id = $var; + + return $this; + } + + /** + * Name of the zone for this request. Name should conform to RFC1035. + * + * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; + * @return string + */ + public function getZone() + { + return $this->zone; + } + + /** + * Name of the zone for this request. Name should conform to RFC1035. + * + * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; + * @param string $var + * @return $this + */ + public function setZone($var) + { + GPBUtil::checkString($var, True); + $this->zone = $var; + + return $this; + } + +} + diff --git a/Compute/src/V1/CancelInstanceGroupManagerResizeRequestRequest.php b/Compute/src/V1/CancelInstanceGroupManagerResizeRequestRequest.php index 56e9f3608759..077441b9c666 100644 --- a/Compute/src/V1/CancelInstanceGroupManagerResizeRequestRequest.php +++ b/Compute/src/V1/CancelInstanceGroupManagerResizeRequestRequest.php @@ -16,7 +16,8 @@ class CancelInstanceGroupManagerResizeRequestRequest extends \Google\Protobuf\Internal\Message { /** - * The name of the managed instance group. The name should conform to RFC1035 or be a resource ID. + * The name of the managed instance group. + * The name should conform to RFC1035 or be a resource ID. * * Generated from protobuf field string instance_group_manager = 249363395 [(.google.api.field_behavior) = REQUIRED]; */ @@ -28,19 +29,31 @@ class CancelInstanceGroupManagerResizeRequestRequest extends \Google\Protobuf\In */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ protected $request_id = null; /** - * The name of the resize request to cancel. The name should conform to RFC1035 or be a resource ID. + * The name of the resize request to cancel. + * The name should conform to RFC1035 or be a resource ID. * * Generated from protobuf field string resize_request = 216941060 [(.google.api.field_behavior) = REQUIRED]; */ protected $resize_request = ''; /** - * The name of the zone where the managed instance group is located. The name should conform to RFC1035. + * The name of thezone where the managed + * instance group is located. The name should conform to RFC1035. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; */ @@ -48,9 +61,12 @@ class CancelInstanceGroupManagerResizeRequestRequest extends \Google\Protobuf\In /** * @param string $project Project ID for this request. - * @param string $zone The name of the zone where the managed instance group is located. The name should conform to RFC1035. - * @param string $instanceGroupManager The name of the managed instance group. The name should conform to RFC1035 or be a resource ID. - * @param string $resizeRequest The name of the resize request to cancel. The name should conform to RFC1035 or be a resource ID. + * @param string $zone The name of thezone where the managed + * instance group is located. The name should conform to RFC1035. + * @param string $instanceGroupManager The name of the managed instance group. + * The name should conform to RFC1035 or be a resource ID. + * @param string $resizeRequest The name of the resize request to cancel. + * The name should conform to RFC1035 or be a resource ID. * * @return \Google\Cloud\Compute\V1\CancelInstanceGroupManagerResizeRequestRequest * @@ -72,15 +88,28 @@ public static function build(string $project, string $zone, string $instanceGrou * Optional. Data for populating the Message object. * * @type string $instance_group_manager - * The name of the managed instance group. The name should conform to RFC1035 or be a resource ID. + * The name of the managed instance group. + * The name should conform to RFC1035 or be a resource ID. * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $resize_request - * The name of the resize request to cancel. The name should conform to RFC1035 or be a resource ID. + * The name of the resize request to cancel. + * The name should conform to RFC1035 or be a resource ID. * @type string $zone - * The name of the zone where the managed instance group is located. The name should conform to RFC1035. + * The name of thezone where the managed + * instance group is located. The name should conform to RFC1035. * } */ public function __construct($data = NULL) { @@ -89,7 +118,8 @@ public function __construct($data = NULL) { } /** - * The name of the managed instance group. The name should conform to RFC1035 or be a resource ID. + * The name of the managed instance group. + * The name should conform to RFC1035 or be a resource ID. * * Generated from protobuf field string instance_group_manager = 249363395 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -100,7 +130,8 @@ public function getInstanceGroupManager() } /** - * The name of the managed instance group. The name should conform to RFC1035 or be a resource ID. + * The name of the managed instance group. + * The name should conform to RFC1035 or be a resource ID. * * Generated from protobuf field string instance_group_manager = 249363395 [(.google.api.field_behavior) = REQUIRED]; * @param string $var @@ -141,7 +172,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -162,7 +203,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var @@ -177,7 +228,8 @@ public function setRequestId($var) } /** - * The name of the resize request to cancel. The name should conform to RFC1035 or be a resource ID. + * The name of the resize request to cancel. + * The name should conform to RFC1035 or be a resource ID. * * Generated from protobuf field string resize_request = 216941060 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -188,7 +240,8 @@ public function getResizeRequest() } /** - * The name of the resize request to cancel. The name should conform to RFC1035 or be a resource ID. + * The name of the resize request to cancel. + * The name should conform to RFC1035 or be a resource ID. * * Generated from protobuf field string resize_request = 216941060 [(.google.api.field_behavior) = REQUIRED]; * @param string $var @@ -203,7 +256,8 @@ public function setResizeRequest($var) } /** - * The name of the zone where the managed instance group is located. The name should conform to RFC1035. + * The name of thezone where the managed + * instance group is located. The name should conform to RFC1035. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; * @return string @@ -214,7 +268,8 @@ public function getZone() } /** - * The name of the zone where the managed instance group is located. The name should conform to RFC1035. + * The name of thezone where the managed + * instance group is located. The name should conform to RFC1035. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; * @param string $var diff --git a/Compute/src/V1/CircuitBreakers.php b/Compute/src/V1/CircuitBreakers.php index d996fe70835a..e8e03647f151 100644 --- a/Compute/src/V1/CircuitBreakers.php +++ b/Compute/src/V1/CircuitBreakers.php @@ -9,38 +9,54 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Settings controlling the volume of requests, connections and retries to this backend service. + * Settings controlling the volume of requests, connections and retries to this + * backend service. * * Generated from protobuf message google.cloud.compute.v1.CircuitBreakers */ class CircuitBreakers extends \Google\Protobuf\Internal\Message { /** - * The maximum number of connections to the backend service. If not specified, there is no limit. Not supported when the backend service is referenced by a URL map that is bound to target gRPC proxy that has validateForProxyless field set to true. + * The maximum number of connections to the backend service. If not specified, + * there is no limit. + * Not supported when the backend service is referenced by a URL map that is + * bound to target gRPC proxy that has validateForProxyless field set to true. * * Generated from protobuf field optional int32 max_connections = 110652154; */ protected $max_connections = null; /** - * The maximum number of pending requests allowed to the backend service. If not specified, there is no limit. Not supported when the backend service is referenced by a URL map that is bound to target gRPC proxy that has validateForProxyless field set to true. + * The maximum number of pending requests allowed to the backend service. If + * not specified, there is no limit. + * Not supported when the backend service is referenced by a URL map that is + * bound to target gRPC proxy that has validateForProxyless field set to true. * * Generated from protobuf field optional int32 max_pending_requests = 375558887; */ protected $max_pending_requests = null; /** - * The maximum number of parallel requests that allowed to the backend service. If not specified, there is no limit. + * The maximum number of parallel requests that allowed to the backend + * service. If not specified, there is no limit. * * Generated from protobuf field optional int32 max_requests = 28097599; */ protected $max_requests = null; /** - * Maximum requests for a single connection to the backend service. This parameter is respected by both the HTTP/1.1 and HTTP/2 implementations. If not specified, there is no limit. Setting this parameter to 1 will effectively disable keep alive. Not supported when the backend service is referenced by a URL map that is bound to target gRPC proxy that has validateForProxyless field set to true. + * Maximum requests for a single connection to the backend service. + * This parameter is respected by both the HTTP/1.1 and HTTP/2 + * implementations. If not specified, there is no limit. Setting this + * parameter to 1 will effectively disable keep alive. + * Not supported when the backend service is referenced by a URL map that is + * bound to target gRPC proxy that has validateForProxyless field set to true. * * Generated from protobuf field optional int32 max_requests_per_connection = 361630528; */ protected $max_requests_per_connection = null; /** - * The maximum number of parallel retries allowed to the backend cluster. If not specified, the default is 1. Not supported when the backend service is referenced by a URL map that is bound to target gRPC proxy that has validateForProxyless field set to true. + * The maximum number of parallel retries allowed to the backend cluster. If + * not specified, the default is 1. + * Not supported when the backend service is referenced by a URL map that is + * bound to target gRPC proxy that has validateForProxyless field set to true. * * Generated from protobuf field optional int32 max_retries = 55546219; */ @@ -53,15 +69,30 @@ class CircuitBreakers extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type int $max_connections - * The maximum number of connections to the backend service. If not specified, there is no limit. Not supported when the backend service is referenced by a URL map that is bound to target gRPC proxy that has validateForProxyless field set to true. + * The maximum number of connections to the backend service. If not specified, + * there is no limit. + * Not supported when the backend service is referenced by a URL map that is + * bound to target gRPC proxy that has validateForProxyless field set to true. * @type int $max_pending_requests - * The maximum number of pending requests allowed to the backend service. If not specified, there is no limit. Not supported when the backend service is referenced by a URL map that is bound to target gRPC proxy that has validateForProxyless field set to true. + * The maximum number of pending requests allowed to the backend service. If + * not specified, there is no limit. + * Not supported when the backend service is referenced by a URL map that is + * bound to target gRPC proxy that has validateForProxyless field set to true. * @type int $max_requests - * The maximum number of parallel requests that allowed to the backend service. If not specified, there is no limit. + * The maximum number of parallel requests that allowed to the backend + * service. If not specified, there is no limit. * @type int $max_requests_per_connection - * Maximum requests for a single connection to the backend service. This parameter is respected by both the HTTP/1.1 and HTTP/2 implementations. If not specified, there is no limit. Setting this parameter to 1 will effectively disable keep alive. Not supported when the backend service is referenced by a URL map that is bound to target gRPC proxy that has validateForProxyless field set to true. + * Maximum requests for a single connection to the backend service. + * This parameter is respected by both the HTTP/1.1 and HTTP/2 + * implementations. If not specified, there is no limit. Setting this + * parameter to 1 will effectively disable keep alive. + * Not supported when the backend service is referenced by a URL map that is + * bound to target gRPC proxy that has validateForProxyless field set to true. * @type int $max_retries - * The maximum number of parallel retries allowed to the backend cluster. If not specified, the default is 1. Not supported when the backend service is referenced by a URL map that is bound to target gRPC proxy that has validateForProxyless field set to true. + * The maximum number of parallel retries allowed to the backend cluster. If + * not specified, the default is 1. + * Not supported when the backend service is referenced by a URL map that is + * bound to target gRPC proxy that has validateForProxyless field set to true. * } */ public function __construct($data = NULL) { @@ -70,7 +101,10 @@ public function __construct($data = NULL) { } /** - * The maximum number of connections to the backend service. If not specified, there is no limit. Not supported when the backend service is referenced by a URL map that is bound to target gRPC proxy that has validateForProxyless field set to true. + * The maximum number of connections to the backend service. If not specified, + * there is no limit. + * Not supported when the backend service is referenced by a URL map that is + * bound to target gRPC proxy that has validateForProxyless field set to true. * * Generated from protobuf field optional int32 max_connections = 110652154; * @return int @@ -91,7 +125,10 @@ public function clearMaxConnections() } /** - * The maximum number of connections to the backend service. If not specified, there is no limit. Not supported when the backend service is referenced by a URL map that is bound to target gRPC proxy that has validateForProxyless field set to true. + * The maximum number of connections to the backend service. If not specified, + * there is no limit. + * Not supported when the backend service is referenced by a URL map that is + * bound to target gRPC proxy that has validateForProxyless field set to true. * * Generated from protobuf field optional int32 max_connections = 110652154; * @param int $var @@ -106,7 +143,10 @@ public function setMaxConnections($var) } /** - * The maximum number of pending requests allowed to the backend service. If not specified, there is no limit. Not supported when the backend service is referenced by a URL map that is bound to target gRPC proxy that has validateForProxyless field set to true. + * The maximum number of pending requests allowed to the backend service. If + * not specified, there is no limit. + * Not supported when the backend service is referenced by a URL map that is + * bound to target gRPC proxy that has validateForProxyless field set to true. * * Generated from protobuf field optional int32 max_pending_requests = 375558887; * @return int @@ -127,7 +167,10 @@ public function clearMaxPendingRequests() } /** - * The maximum number of pending requests allowed to the backend service. If not specified, there is no limit. Not supported when the backend service is referenced by a URL map that is bound to target gRPC proxy that has validateForProxyless field set to true. + * The maximum number of pending requests allowed to the backend service. If + * not specified, there is no limit. + * Not supported when the backend service is referenced by a URL map that is + * bound to target gRPC proxy that has validateForProxyless field set to true. * * Generated from protobuf field optional int32 max_pending_requests = 375558887; * @param int $var @@ -142,7 +185,8 @@ public function setMaxPendingRequests($var) } /** - * The maximum number of parallel requests that allowed to the backend service. If not specified, there is no limit. + * The maximum number of parallel requests that allowed to the backend + * service. If not specified, there is no limit. * * Generated from protobuf field optional int32 max_requests = 28097599; * @return int @@ -163,7 +207,8 @@ public function clearMaxRequests() } /** - * The maximum number of parallel requests that allowed to the backend service. If not specified, there is no limit. + * The maximum number of parallel requests that allowed to the backend + * service. If not specified, there is no limit. * * Generated from protobuf field optional int32 max_requests = 28097599; * @param int $var @@ -178,7 +223,12 @@ public function setMaxRequests($var) } /** - * Maximum requests for a single connection to the backend service. This parameter is respected by both the HTTP/1.1 and HTTP/2 implementations. If not specified, there is no limit. Setting this parameter to 1 will effectively disable keep alive. Not supported when the backend service is referenced by a URL map that is bound to target gRPC proxy that has validateForProxyless field set to true. + * Maximum requests for a single connection to the backend service. + * This parameter is respected by both the HTTP/1.1 and HTTP/2 + * implementations. If not specified, there is no limit. Setting this + * parameter to 1 will effectively disable keep alive. + * Not supported when the backend service is referenced by a URL map that is + * bound to target gRPC proxy that has validateForProxyless field set to true. * * Generated from protobuf field optional int32 max_requests_per_connection = 361630528; * @return int @@ -199,7 +249,12 @@ public function clearMaxRequestsPerConnection() } /** - * Maximum requests for a single connection to the backend service. This parameter is respected by both the HTTP/1.1 and HTTP/2 implementations. If not specified, there is no limit. Setting this parameter to 1 will effectively disable keep alive. Not supported when the backend service is referenced by a URL map that is bound to target gRPC proxy that has validateForProxyless field set to true. + * Maximum requests for a single connection to the backend service. + * This parameter is respected by both the HTTP/1.1 and HTTP/2 + * implementations. If not specified, there is no limit. Setting this + * parameter to 1 will effectively disable keep alive. + * Not supported when the backend service is referenced by a URL map that is + * bound to target gRPC proxy that has validateForProxyless field set to true. * * Generated from protobuf field optional int32 max_requests_per_connection = 361630528; * @param int $var @@ -214,7 +269,10 @@ public function setMaxRequestsPerConnection($var) } /** - * The maximum number of parallel retries allowed to the backend cluster. If not specified, the default is 1. Not supported when the backend service is referenced by a URL map that is bound to target gRPC proxy that has validateForProxyless field set to true. + * The maximum number of parallel retries allowed to the backend cluster. If + * not specified, the default is 1. + * Not supported when the backend service is referenced by a URL map that is + * bound to target gRPC proxy that has validateForProxyless field set to true. * * Generated from protobuf field optional int32 max_retries = 55546219; * @return int @@ -235,7 +293,10 @@ public function clearMaxRetries() } /** - * The maximum number of parallel retries allowed to the backend cluster. If not specified, the default is 1. Not supported when the backend service is referenced by a URL map that is bound to target gRPC proxy that has validateForProxyless field set to true. + * The maximum number of parallel retries allowed to the backend cluster. If + * not specified, the default is 1. + * Not supported when the backend service is referenced by a URL map that is + * bound to target gRPC proxy that has validateForProxyless field set to true. * * Generated from protobuf field optional int32 max_retries = 55546219; * @param int $var diff --git a/Compute/src/V1/Client/AcceleratorTypesClient.php b/Compute/src/V1/Client/AcceleratorTypesClient.php index c59e53276eec..ff534f9ea356 100644 --- a/Compute/src/V1/Client/AcceleratorTypesClient.php +++ b/Compute/src/V1/Client/AcceleratorTypesClient.php @@ -197,7 +197,10 @@ public function __call($method, $args) } /** - * Retrieves an aggregated list of accelerator types. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. + * Retrieves an aggregated list of accelerator types. + * + * To prevent failure, it is recommended that you set the + * `returnPartialSuccess` parameter to `true`. * * The async variant is {@see AcceleratorTypesClient::aggregatedListAsync()} . * @@ -251,7 +254,8 @@ public function get(GetAcceleratorTypeRequest $request, array $callOptions = []) } /** - * Retrieves a list of accelerator types that are available to the specified project. + * Retrieves a list of accelerator types that are available to the specified + * project. * * The async variant is {@see AcceleratorTypesClient::listAsync()} . * diff --git a/Compute/src/V1/Client/AddressesClient.php b/Compute/src/V1/Client/AddressesClient.php index afd51fcb9ee5..f146e8d98c80 100644 --- a/Compute/src/V1/Client/AddressesClient.php +++ b/Compute/src/V1/Client/AddressesClient.php @@ -275,7 +275,10 @@ public function __call($method, $args) } /** - * Retrieves an aggregated list of addresses. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. + * Retrieves an aggregated list of addresses. + * + * To prevent failure, it is recommended that you set the + * `returnPartialSuccess` parameter to `true`. * * The async variant is {@see AddressesClient::aggregatedListAsync()} . * @@ -353,7 +356,8 @@ public function get(GetAddressRequest $request, array $callOptions = []): Addres } /** - * Creates an address resource in the specified project by using the data included in the request. + * Creates an address resource in the specified project by using the data + * included in the request. * * The async variant is {@see AddressesClient::insertAsync()} . * @@ -379,7 +383,8 @@ public function insert(InsertAddressRequest $request, array $callOptions = []): } /** - * Retrieves a list of addresses contained within the specified region. + * Retrieves a list of addresses contained within + * the specified region. * * The async variant is {@see AddressesClient::listAsync()} . * @@ -431,7 +436,8 @@ public function move(MoveAddressRequest $request, array $callOptions = []): Oper } /** - * Sets the labels on an Address. To learn more about labels, read the Labeling Resources documentation. + * Sets the labels on an Address. To learn more about labels, read theLabeling + * Resources documentation. * * The async variant is {@see AddressesClient::setLabelsAsync()} . * diff --git a/Compute/src/V1/Client/AutoscalersClient.php b/Compute/src/V1/Client/AutoscalersClient.php index a9cfd609126f..48780d2aa5c1 100644 --- a/Compute/src/V1/Client/AutoscalersClient.php +++ b/Compute/src/V1/Client/AutoscalersClient.php @@ -272,7 +272,10 @@ public function __call($method, $args) } /** - * Retrieves an aggregated list of autoscalers. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. + * Retrieves an aggregated list of autoscalers. + * + * To prevent failure, it is recommended that you set the + * `returnPartialSuccess` parameter to `true`. * * The async variant is {@see AutoscalersClient::aggregatedListAsync()} . * @@ -352,7 +355,8 @@ public function get(GetAutoscalerRequest $request, array $callOptions = []): Aut } /** - * Creates an autoscaler in the specified project using the data included in the request. + * Creates an autoscaler in the specified project using the data + * included in the request. * * The async variant is {@see AutoscalersClient::insertAsync()} . * @@ -378,7 +382,8 @@ public function insert(InsertAutoscalerRequest $request, array $callOptions = [] } /** - * Retrieves a list of autoscalers contained within the specified zone. + * Retrieves a list of autoscalers contained within + * the specified zone. * * The async variant is {@see AutoscalersClient::listAsync()} . * @@ -404,7 +409,10 @@ public function list(ListAutoscalersRequest $request, array $callOptions = []): } /** - * Updates an autoscaler in the specified project using the data included in the request. This method supports PATCH semantics and uses the JSON merge patch format and processing rules. + * Updates an autoscaler in the specified project using the data + * included in the request. This method supportsPATCH + * semantics and uses theJSON merge + * patch format and processing rules. * * The async variant is {@see AutoscalersClient::patchAsync()} . * @@ -430,7 +438,8 @@ public function patch(PatchAutoscalerRequest $request, array $callOptions = []): } /** - * Updates an autoscaler in the specified project using the data included in the request. + * Updates an autoscaler in the specified project using the data + * included in the request. * * The async variant is {@see AutoscalersClient::updateAsync()} . * diff --git a/Compute/src/V1/Client/BackendBucketsClient.php b/Compute/src/V1/Client/BackendBucketsClient.php index 9233bbf7d6c7..4c5780371e78 100644 --- a/Compute/src/V1/Client/BackendBucketsClient.php +++ b/Compute/src/V1/Client/BackendBucketsClient.php @@ -284,7 +284,8 @@ public function __call($method, $args) } /** - * Adds a key for validating requests with signed URLs for this backend bucket. + * Adds a key for validating requests with signed URLs for this backend + * bucket. * * The async variant is {@see BackendBucketsClient::addSignedUrlKeyAsync()} . * @@ -338,7 +339,8 @@ public function delete(DeleteBackendBucketRequest $request, array $callOptions = } /** - * Deletes a key for validating requests with signed URLs for this backend bucket. + * Deletes a key for validating requests with signed URLs for this backend + * bucket. * * The async variant is {@see BackendBucketsClient::deleteSignedUrlKeyAsync()} . * @@ -392,7 +394,8 @@ public function get(GetBackendBucketRequest $request, array $callOptions = []): } /** - * Gets the access control policy for a resource. May be empty if no such policy or resource exists. + * Gets the access control policy for a resource. May be empty if no such + * policy or resource exists. * * The async variant is {@see BackendBucketsClient::getIamPolicyAsync()} . * @@ -418,7 +421,8 @@ public function getIamPolicy(GetIamPolicyBackendBucketRequest $request, array $c } /** - * Creates a BackendBucket resource in the specified project using the data included in the request. + * Creates a BackendBucket resource in the specified project using + * the data included in the request. * * The async variant is {@see BackendBucketsClient::insertAsync()} . * @@ -444,7 +448,8 @@ public function insert(InsertBackendBucketRequest $request, array $callOptions = } /** - * Retrieves the list of BackendBucket resources available to the specified project. + * Retrieves the list of BackendBucket resources available to the specified + * project. * * The async variant is {@see BackendBucketsClient::listAsync()} . * @@ -470,7 +475,10 @@ public function list(ListBackendBucketsRequest $request, array $callOptions = [] } /** - * Updates the specified BackendBucket resource with the data included in the request. This method supports PATCH semantics and uses the JSON merge patch format and processing rules. + * Updates the specified BackendBucket resource with the data included in the + * request. This method supportsPATCH + * semantics and uses theJSON merge + * patch format and processing rules. * * The async variant is {@see BackendBucketsClient::patchAsync()} . * @@ -524,7 +532,8 @@ public function setEdgeSecurityPolicy( } /** - * Sets the access control policy on the specified resource. Replaces any existing policy. + * Sets the access control policy on the specified resource. + * Replaces any existing policy. * * The async variant is {@see BackendBucketsClient::setIamPolicyAsync()} . * @@ -578,7 +587,8 @@ public function testIamPermissions( } /** - * Updates the specified BackendBucket resource with the data included in the request. + * Updates the specified BackendBucket resource with the data included in the + * request. * * The async variant is {@see BackendBucketsClient::updateAsync()} . * diff --git a/Compute/src/V1/Client/BackendServicesClient.php b/Compute/src/V1/Client/BackendServicesClient.php index cedf67002e77..4852da3a9b80 100644 --- a/Compute/src/V1/Client/BackendServicesClient.php +++ b/Compute/src/V1/Client/BackendServicesClient.php @@ -296,7 +296,8 @@ public function __call($method, $args) } /** - * Adds a key for validating requests with signed URLs for this backend service. + * Adds a key for validating requests with signed URLs for this backend + * service. * * The async variant is {@see BackendServicesClient::addSignedUrlKeyAsync()} . * @@ -324,7 +325,11 @@ public function addSignedUrlKey( } /** - * Retrieves the list of all BackendService resources, regional and global, available to the specified project. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. + * Retrieves the list of all BackendService resources, regional and global, + * available to the specified project. + * + * To prevent failure, it is recommended that you set the + * `returnPartialSuccess` parameter to `true`. * * The async variant is {@see BackendServicesClient::aggregatedListAsync()} . * @@ -378,7 +383,8 @@ public function delete(DeleteBackendServiceRequest $request, array $callOptions } /** - * Deletes a key for validating requests with signed URLs for this backend service. + * Deletes a key for validating requests with signed URLs for this backend + * service. * * The async variant is {@see BackendServicesClient::deleteSignedUrlKeyAsync()} . * @@ -461,7 +467,14 @@ public function getEffectiveSecurityPolicies( } /** - * Gets the most recent health check results for this BackendService. Example request body: { "group": "/zones/us-east1-b/instanceGroups/lb-backend-example" } + * Gets the most recent health check results for this + * BackendService. + * + * Example request body: + * + * { + * "group": "/zones/us-east1-b/instanceGroups/lb-backend-example" + * } * * The async variant is {@see BackendServicesClient::getHealthAsync()} . * @@ -489,7 +502,8 @@ public function getHealth( } /** - * Gets the access control policy for a resource. May be empty if no such policy or resource exists. + * Gets the access control policy for a resource. May be empty if no such + * policy or resource exists. * * The async variant is {@see BackendServicesClient::getIamPolicyAsync()} . * @@ -515,7 +529,9 @@ public function getIamPolicy(GetIamPolicyBackendServiceRequest $request, array $ } /** - * Creates a BackendService resource in the specified project using the data included in the request. For more information, see Backend services overview . + * Creates a BackendService resource in the specified project using + * the data included in the request. For more information, see + * Backend services overview. * * The async variant is {@see BackendServicesClient::insertAsync()} . * @@ -541,7 +557,8 @@ public function insert(InsertBackendServiceRequest $request, array $callOptions } /** - * Retrieves the list of BackendService resources available to the specified project. + * Retrieves the list of BackendService resources available to the specified + * project. * * The async variant is {@see BackendServicesClient::listAsync()} . * @@ -593,7 +610,11 @@ public function listUsable(ListUsableBackendServicesRequest $request, array $cal } /** - * Patches the specified BackendService resource with the data included in the request. For more information, see Backend services overview. This method supports PATCH semantics and uses the JSON merge patch format and processing rules. + * Patches the specified BackendService resource with the data included in the + * request. For more information, see + * Backend services overview. This method + * supports PATCH semantics and uses the JSON merge + * patch format and processing rules. * * The async variant is {@see BackendServicesClient::patchAsync()} . * @@ -648,7 +669,8 @@ public function setEdgeSecurityPolicy( } /** - * Sets the access control policy on the specified resource. Replaces any existing policy. + * Sets the access control policy on the specified resource. + * Replaces any existing policy. * * The async variant is {@see BackendServicesClient::setIamPolicyAsync()} . * @@ -674,7 +696,9 @@ public function setIamPolicy(SetIamPolicyBackendServiceRequest $request, array $ } /** - * Sets the Google Cloud Armor security policy for the specified backend service. For more information, see Google Cloud Armor Overview + * Sets the Google Cloud Armor security policy for the specified backend + * service. For more information, seeGoogle + * Cloud Armor Overview * * The async variant is {@see BackendServicesClient::setSecurityPolicyAsync()} . * @@ -730,7 +754,9 @@ public function testIamPermissions( } /** - * Updates the specified BackendService resource with the data included in the request. For more information, see Backend services overview. + * Updates the specified BackendService resource with the data included in the + * request. For more information, seeBackend + * services overview. * * The async variant is {@see BackendServicesClient::updateAsync()} . * diff --git a/Compute/src/V1/Client/CrossSiteNetworksClient.php b/Compute/src/V1/Client/CrossSiteNetworksClient.php new file mode 100644 index 000000000000..0355d14762f4 --- /dev/null +++ b/Compute/src/V1/Client/CrossSiteNetworksClient.php @@ -0,0 +1,403 @@ + deleteAsync(DeleteCrossSiteNetworkRequest $request, array $optionalArgs = []) + * @method PromiseInterface getAsync(GetCrossSiteNetworkRequest $request, array $optionalArgs = []) + * @method PromiseInterface insertAsync(InsertCrossSiteNetworkRequest $request, array $optionalArgs = []) + * @method PromiseInterface listAsync(ListCrossSiteNetworksRequest $request, array $optionalArgs = []) + * @method PromiseInterface patchAsync(PatchCrossSiteNetworkRequest $request, array $optionalArgs = []) + */ +final class CrossSiteNetworksClient +{ + use GapicClientTrait; + + /** The name of the service. */ + private const SERVICE_NAME = 'google.cloud.compute.v1.CrossSiteNetworks'; + + /** + * The default address of the service. + * + * @deprecated SERVICE_ADDRESS_TEMPLATE should be used instead. + */ + private const SERVICE_ADDRESS = 'compute.googleapis.com'; + + /** The address template of the service. */ + private const SERVICE_ADDRESS_TEMPLATE = 'compute.UNIVERSE_DOMAIN'; + + /** The default port of the service. */ + private const DEFAULT_SERVICE_PORT = 443; + + /** The name of the code generator, to be included in the agent header. */ + private const CODEGEN_NAME = 'gapic'; + + /** The default scopes required by the service. */ + public static $serviceScopes = [ + 'https://www.googleapis.com/auth/compute', + 'https://www.googleapis.com/auth/cloud-platform', + ]; + + private $operationsClient; + + private static function getClientDefaults() + { + return [ + 'serviceName' => self::SERVICE_NAME, + 'apiEndpoint' => self::SERVICE_ADDRESS . ':' . self::DEFAULT_SERVICE_PORT, + 'clientConfig' => __DIR__ . '/../resources/cross_site_networks_client_config.json', + 'descriptorsConfigPath' => __DIR__ . '/../resources/cross_site_networks_descriptor_config.php', + 'credentialsConfig' => [ + 'defaultScopes' => self::$serviceScopes, + 'useJwtAccessWithScope' => false, + ], + 'transportConfig' => [ + 'rest' => [ + 'restClientConfigPath' => __DIR__ . '/../resources/cross_site_networks_rest_client_config.php', + ], + ], + ]; + } + + /** Implements GapicClientTrait::defaultTransport. */ + private static function defaultTransport() + { + return 'rest'; + } + + /** Implements ClientOptionsTrait::supportedTransports. */ + private static function supportedTransports() + { + return ['rest']; + } + + /** + * Return an GlobalOperationsClient object with the same endpoint as $this. + * + * @return GlobalOperationsClient + */ + public function getOperationsClient() + { + return $this->operationsClient; + } + + /** Return the default longrunning operation descriptor config. */ + private function getDefaultOperationDescriptor() + { + return [ + 'additionalArgumentMethods' => ['getProject'], + 'getOperationMethod' => 'get', + 'cancelOperationMethod' => null, + 'deleteOperationMethod' => 'delete', + 'operationErrorCodeMethod' => 'getHttpErrorStatusCode', + 'operationErrorMessageMethod' => 'getHttpErrorMessage', + 'operationNameMethod' => 'getName', + 'operationStatusMethod' => 'getStatus', + 'operationStatusDoneValue' => \Google\Cloud\Compute\V1\Operation\Status::DONE, + 'getOperationRequest' => '\Google\Cloud\Compute\V1\GetGlobalOperationRequest', + 'cancelOperationRequest' => null, + 'deleteOperationRequest' => '\Google\Cloud\Compute\V1\DeleteGlobalOperationRequest', + ]; + } + + /** + * Resume an existing long running operation that was previously started by a long + * running API method. If $methodName is not provided, or does not match a long + * running API method, then the operation can still be resumed, but the + * OperationResponse object will not deserialize the final response. + * + * @param string $operationName The name of the long running operation + * @param string $methodName The name of the method used to start the operation + * + * @return OperationResponse + */ + public function resumeOperation($operationName, $methodName = null) + { + $options = $this->descriptors[$methodName]['longRunning'] ?? $this->getDefaultOperationDescriptor(); + $operation = new OperationResponse($operationName, $this->getOperationsClient(), $options); + $operation->reload(); + return $operation; + } + + /** + * Create the default operation client for the service. + * + * @param array $options ClientOptions for the client. + * + * @return GlobalOperationsClient + */ + private function createOperationsClient(array $options) + { + // Unset client-specific configuration options + unset($options['serviceName'], $options['clientConfig'], $options['descriptorsConfigPath']); + + if (isset($options['operationsClient'])) { + return $options['operationsClient']; + } + + return new GlobalOperationsClient($options); + } + + /** + * Constructor. + * + * @param array|ClientOptions $options { + * Optional. Options for configuring the service API wrapper. + * + * @type string $apiEndpoint + * The address of the API remote host. May optionally include the port, formatted + * as ":". Default 'compute.googleapis.com:443'. + * @type FetchAuthTokenInterface|CredentialsWrapper $credentials + * This option should only be used with a pre-constructed + * {@see FetchAuthTokenInterface} or {@see CredentialsWrapper} object. Note that + * when one of these objects are provided, any settings in $credentialsConfig will + * be ignored. + * **Important**: If you are providing a path to a credentials file, or a decoded + * credentials file as a PHP array, this usage is now DEPRECATED. Providing an + * unvalidated credential configuration to Google APIs can compromise the security + * of your systems and data. It is recommended to create the credentials explicitly + * ``` + * use Google\Auth\Credentials\ServiceAccountCredentials; + * use Google\Cloud\Compute\V1\CrossSiteNetworksClient; + * $creds = new ServiceAccountCredentials($scopes, $json); + * $options = new CrossSiteNetworksClient(['credentials' => $creds]); + * ``` + * {@see + * https://cloud.google.com/docs/authentication/external/externally-sourced-credentials} + * @type array $credentialsConfig + * Options used to configure credentials, including auth token caching, for the + * client. For a full list of supporting configuration options, see + * {@see \Google\ApiCore\CredentialsWrapper::build()} . + * @type bool $disableRetries + * Determines whether or not retries defined by the client configuration should be + * disabled. Defaults to `false`. + * @type string|array $clientConfig + * Client method configuration, including retry settings. This option can be either + * a path to a JSON file, or a PHP array containing the decoded JSON data. By + * default this settings points to the default client config file, which is + * provided in the resources folder. + * @type string|TransportInterface $transport + * The transport used for executing network requests. At the moment, supports only + * `rest`. *Advanced usage*: Additionally, it is possible to pass in an already + * instantiated {@see \Google\ApiCore\Transport\TransportInterface} object. Note + * that when this object is provided, any settings in $transportConfig, and any + * $apiEndpoint setting, will be ignored. + * @type array $transportConfig + * Configuration options that will be used to construct the transport. Options for + * each supported transport type should be passed in a key for that transport. For + * example: + * $transportConfig = [ + * 'rest' => [...], + * ]; + * See the {@see \Google\ApiCore\Transport\RestTransport::build()} method for the + * supported options. + * @type callable $clientCertSource + * A callable which returns the client cert as a string. This can be used to + * provide a certificate and private key to the transport layer for mTLS. + * @type false|LoggerInterface $logger + * A PSR-3 compliant logger. If set to false, logging is disabled, ignoring the + * 'GOOGLE_SDK_PHP_LOGGING' environment flag + * @type string $universeDomain + * The service domain for the client. Defaults to 'googleapis.com'. + * } + * + * @throws ValidationException + */ + public function __construct(array|ClientOptions $options = []) + { + $clientOptions = $this->buildClientOptions($options); + $this->setClientOptions($clientOptions); + $this->operationsClient = $this->createOperationsClient($clientOptions); + } + + /** Handles execution of the async variants for each documented method. */ + public function __call($method, $args) + { + if (substr($method, -5) !== 'Async') { + trigger_error('Call to undefined method ' . __CLASS__ . "::$method()", E_USER_ERROR); + } + + array_unshift($args, substr($method, 0, -5)); + return call_user_func_array([$this, 'startAsyncCall'], $args); + } + + /** + * Deletes the specified cross-site network in the given scope. + * + * The async variant is {@see CrossSiteNetworksClient::deleteAsync()} . + * + * @example samples/V1/CrossSiteNetworksClient/delete.php + * + * @param DeleteCrossSiteNetworkRequest $request A request to house fields associated with the call. + * @param array $callOptions { + * Optional. + * + * @type RetrySettings|array $retrySettings + * Retry settings to use for this call. Can be a {@see RetrySettings} object, or an + * associative array of retry settings parameters. See the documentation on + * {@see RetrySettings} for example usage. + * } + * + * @return OperationResponse + * + * @throws ApiException Thrown if the API call fails. + */ + public function delete(DeleteCrossSiteNetworkRequest $request, array $callOptions = []): OperationResponse + { + return $this->startApiCall('Delete', $request, $callOptions)->wait(); + } + + /** + * Returns the specified cross-site network in the given scope. + * + * The async variant is {@see CrossSiteNetworksClient::getAsync()} . + * + * @example samples/V1/CrossSiteNetworksClient/get.php + * + * @param GetCrossSiteNetworkRequest $request A request to house fields associated with the call. + * @param array $callOptions { + * Optional. + * + * @type RetrySettings|array $retrySettings + * Retry settings to use for this call. Can be a {@see RetrySettings} object, or an + * associative array of retry settings parameters. See the documentation on + * {@see RetrySettings} for example usage. + * } + * + * @return CrossSiteNetwork + * + * @throws ApiException Thrown if the API call fails. + */ + public function get(GetCrossSiteNetworkRequest $request, array $callOptions = []): CrossSiteNetwork + { + return $this->startApiCall('Get', $request, $callOptions)->wait(); + } + + /** + * Creates a cross-site network in the specified project in the given scope + * using the parameters that are included in the request. + * + * The async variant is {@see CrossSiteNetworksClient::insertAsync()} . + * + * @example samples/V1/CrossSiteNetworksClient/insert.php + * + * @param InsertCrossSiteNetworkRequest $request A request to house fields associated with the call. + * @param array $callOptions { + * Optional. + * + * @type RetrySettings|array $retrySettings + * Retry settings to use for this call. Can be a {@see RetrySettings} object, or an + * associative array of retry settings parameters. See the documentation on + * {@see RetrySettings} for example usage. + * } + * + * @return OperationResponse + * + * @throws ApiException Thrown if the API call fails. + */ + public function insert(InsertCrossSiteNetworkRequest $request, array $callOptions = []): OperationResponse + { + return $this->startApiCall('Insert', $request, $callOptions)->wait(); + } + + /** + * Lists the cross-site networks for a project in the given scope. + * + * The async variant is {@see CrossSiteNetworksClient::listAsync()} . + * + * @example samples/V1/CrossSiteNetworksClient/list.php + * + * @param ListCrossSiteNetworksRequest $request A request to house fields associated with the call. + * @param array $callOptions { + * Optional. + * + * @type RetrySettings|array $retrySettings + * Retry settings to use for this call. Can be a {@see RetrySettings} object, or an + * associative array of retry settings parameters. See the documentation on + * {@see RetrySettings} for example usage. + * } + * + * @return PagedListResponse + * + * @throws ApiException Thrown if the API call fails. + */ + public function list(ListCrossSiteNetworksRequest $request, array $callOptions = []): PagedListResponse + { + return $this->startApiCall('List', $request, $callOptions); + } + + /** + * Updates the specified cross-site network with the data included in + * the request. This method supportsPATCH + * semantics and uses theJSON merge + * patch format and processing rules. + * + * The async variant is {@see CrossSiteNetworksClient::patchAsync()} . + * + * @example samples/V1/CrossSiteNetworksClient/patch.php + * + * @param PatchCrossSiteNetworkRequest $request A request to house fields associated with the call. + * @param array $callOptions { + * Optional. + * + * @type RetrySettings|array $retrySettings + * Retry settings to use for this call. Can be a {@see RetrySettings} object, or an + * associative array of retry settings parameters. See the documentation on + * {@see RetrySettings} for example usage. + * } + * + * @return OperationResponse + * + * @throws ApiException Thrown if the API call fails. + */ + public function patch(PatchCrossSiteNetworkRequest $request, array $callOptions = []): OperationResponse + { + return $this->startApiCall('Patch', $request, $callOptions)->wait(); + } +} diff --git a/Compute/src/V1/Client/DiskTypesClient.php b/Compute/src/V1/Client/DiskTypesClient.php index 0ad5785c198b..de04e5ff6525 100644 --- a/Compute/src/V1/Client/DiskTypesClient.php +++ b/Compute/src/V1/Client/DiskTypesClient.php @@ -194,7 +194,10 @@ public function __call($method, $args) } /** - * Retrieves an aggregated list of disk types. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. + * Retrieves an aggregated list of disk types. + * + * To prevent failure, it is recommended that you set the + * `returnPartialSuccess` parameter to `true`. * * The async variant is {@see DiskTypesClient::aggregatedListAsync()} . * @@ -246,7 +249,8 @@ public function get(GetDiskTypeRequest $request, array $callOptions = []): DiskT } /** - * Retrieves a list of disk types available to the specified project. + * Retrieves a list of disk types available to the specified + * project. * * The async variant is {@see DiskTypesClient::listAsync()} . * diff --git a/Compute/src/V1/Client/DisksClient.php b/Compute/src/V1/Client/DisksClient.php index 93a31ff15bdf..676c77a7b5e0 100644 --- a/Compute/src/V1/Client/DisksClient.php +++ b/Compute/src/V1/Client/DisksClient.php @@ -298,7 +298,9 @@ public function __call($method, $args) } /** - * Adds existing resource policies to a disk. You can only add one policy which will be applied to this disk for scheduling snapshot creation. + * Adds existing resource policies to a disk. You can only add one + * policy which will be applied to this disk for scheduling snapshot + * creation. * * The async variant is {@see DisksClient::addResourcePoliciesAsync()} . * @@ -326,7 +328,10 @@ public function addResourcePolicies( } /** - * Retrieves an aggregated list of persistent disks. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. + * Retrieves an aggregated list of persistent disks. + * + * To prevent failure, it is recommended that you set the + * `returnPartialSuccess` parameter to `true`. * * The async variant is {@see DisksClient::aggregatedListAsync()} . * @@ -378,7 +383,8 @@ public function bulkInsert(BulkInsertDiskRequest $request, array $callOptions = } /** - * Sets the labels on many disks at once. To learn more about labels, read the Labeling Resources documentation. + * Sets the labels on many disks at once. To learn more about labels, read theLabeling + * Resources documentation. * * The async variant is {@see DisksClient::bulkSetLabelsAsync()} . * @@ -404,7 +410,10 @@ public function bulkSetLabels(BulkSetLabelsDiskRequest $request, array $callOpti } /** - * Creates a snapshot of a specified persistent disk. For regular snapshot creation, consider using snapshots.insert instead, as that method supports more features, such as creating snapshots in a project different from the source disk project. + * Creates a snapshot of a specified persistent disk. For regular snapshot + * creation, consider using snapshots.insert + * instead, as that method supports more features, such as creating snapshots + * in a project different from the source disk project. * * The async variant is {@see DisksClient::createSnapshotAsync()} . * @@ -430,7 +439,11 @@ public function createSnapshot(CreateSnapshotDiskRequest $request, array $callOp } /** - * Deletes the specified persistent disk. Deleting a disk removes its data permanently and is irreversible. However, deleting a disk does not delete any snapshots previously made from the disk. You must separately delete snapshots. + * Deletes the specified persistent disk. Deleting a disk removes its data + * permanently and is irreversible. However, deleting a disk does not + * delete any snapshots + * previously made from the disk. You must separatelydelete + * snapshots. * * The async variant is {@see DisksClient::deleteAsync()} . * @@ -482,7 +495,8 @@ public function get(GetDiskRequest $request, array $callOptions = []): Disk } /** - * Gets the access control policy for a resource. May be empty if no such policy or resource exists. + * Gets the access control policy for a resource. May be empty if no such + * policy or resource exists. * * The async variant is {@see DisksClient::getIamPolicyAsync()} . * @@ -508,7 +522,11 @@ public function getIamPolicy(GetIamPolicyDiskRequest $request, array $callOption } /** - * Creates a persistent disk in the specified project using the data in the request. You can create a disk from a source (sourceImage, sourceSnapshot, or sourceDisk) or create an empty 500 GB data disk by omitting all properties. You can also create a disk that is larger than the default size by specifying the sizeGb property. + * Creates a persistent disk in the specified project using the data + * in the request. You can create a disk from a source + * (sourceImage, sourceSnapshot, orsourceDisk) or create an empty 500 GB data disk by + * omitting all properties. You can also create a disk that is larger than + * the default size by specifying the sizeGb property. * * The async variant is {@see DisksClient::insertAsync()} . * @@ -534,7 +552,8 @@ public function insert(InsertDiskRequest $request, array $callOptions = []): Ope } /** - * Retrieves a list of persistent disks contained within the specified zone. + * Retrieves a list of persistent disks contained within + * the specified zone. * * The async variant is {@see DisksClient::listAsync()} . * @@ -588,7 +607,8 @@ public function removeResourcePolicies( } /** - * Resizes the specified persistent disk. You can only increase the size of the disk. + * Resizes the specified persistent disk. + * You can only increase the size of the disk. * * The async variant is {@see DisksClient::resizeAsync()} . * @@ -614,7 +634,8 @@ public function resize(ResizeDiskRequest $request, array $callOptions = []): Ope } /** - * Sets the access control policy on the specified resource. Replaces any existing policy. + * Sets the access control policy on the specified resource. + * Replaces any existing policy. * * The async variant is {@see DisksClient::setIamPolicyAsync()} . * @@ -640,7 +661,8 @@ public function setIamPolicy(SetIamPolicyDiskRequest $request, array $callOption } /** - * Sets the labels on a disk. To learn more about labels, read the Labeling Resources documentation. + * Sets the labels on a disk. To learn more about labels, read theLabeling + * Resources documentation. * * The async variant is {@see DisksClient::setLabelsAsync()} . * @@ -666,7 +688,8 @@ public function setLabels(SetLabelsDiskRequest $request, array $callOptions = [] } /** - * Starts asynchronous replication. Must be invoked on the primary disk. + * Starts asynchronous replication. + * Must be invoked on the primary disk. * * The async variant is {@see DisksClient::startAsyncReplicationAsync()} . * @@ -694,7 +717,8 @@ public function startAsyncReplication( } /** - * Stops asynchronous replication. Can be invoked either on the primary or on the secondary disk. + * Stops asynchronous replication. + * Can be invoked either on the primary or on the secondary disk. * * The async variant is {@see DisksClient::stopAsyncReplicationAsync()} . * @@ -722,7 +746,8 @@ public function stopAsyncReplication( } /** - * Stops asynchronous replication for a consistency group of disks. Can be invoked either in the primary or secondary scope. + * Stops asynchronous replication for a consistency group of disks. + * Can be invoked either in the primary or secondary scope. * * The async variant is {@see DisksClient::stopGroupAsyncReplicationAsync()} . * @@ -778,7 +803,9 @@ public function testIamPermissions( } /** - * Updates the specified disk with the data included in the request. The update is performed only on selected fields included as part of update-mask. Only the following fields can be modified: user_license. + * Updates the specified disk with the data included in the request. + * The update is performed only on selected fields included as part + * of update-mask. Only the following fields can be modified: user_license. * * The async variant is {@see DisksClient::updateAsync()} . * diff --git a/Compute/src/V1/Client/ExternalVpnGatewaysClient.php b/Compute/src/V1/Client/ExternalVpnGatewaysClient.php index 5211fab62183..005bb88f68cd 100644 --- a/Compute/src/V1/Client/ExternalVpnGatewaysClient.php +++ b/Compute/src/V1/Client/ExternalVpnGatewaysClient.php @@ -297,7 +297,8 @@ public function delete(DeleteExternalVpnGatewayRequest $request, array $callOpti } /** - * Returns the specified externalVpnGateway. Get a list of available externalVpnGateways by making a list() request. + * Returns the specified externalVpnGateway. Get a list of available + * externalVpnGateways by making a list() request. * * The async variant is {@see ExternalVpnGatewaysClient::getAsync()} . * @@ -323,7 +324,8 @@ public function get(GetExternalVpnGatewayRequest $request, array $callOptions = } /** - * Creates a ExternalVpnGateway in the specified project using the data included in the request. + * Creates a ExternalVpnGateway in the specified project using + * the data included in the request. * * The async variant is {@see ExternalVpnGatewaysClient::insertAsync()} . * @@ -349,7 +351,8 @@ public function insert(InsertExternalVpnGatewayRequest $request, array $callOpti } /** - * Retrieves the list of ExternalVpnGateway available to the specified project. + * Retrieves the list of ExternalVpnGateway available to the specified + * project. * * The async variant is {@see ExternalVpnGatewaysClient::listAsync()} . * @@ -375,7 +378,9 @@ public function list(ListExternalVpnGatewaysRequest $request, array $callOptions } /** - * Sets the labels on an ExternalVpnGateway. To learn more about labels, read the Labeling Resources documentation. + * Sets the labels on an ExternalVpnGateway. To learn more about labels, + * read the Labeling + * Resources documentation. * * The async variant is {@see ExternalVpnGatewaysClient::setLabelsAsync()} . * diff --git a/Compute/src/V1/Client/FirewallPoliciesClient.php b/Compute/src/V1/Client/FirewallPoliciesClient.php index 7919dd9792c2..59148d339013 100644 --- a/Compute/src/V1/Client/FirewallPoliciesClient.php +++ b/Compute/src/V1/Client/FirewallPoliciesClient.php @@ -460,7 +460,8 @@ public function getAssociation( } /** - * Gets the access control policy for a resource. May be empty if no such policy or resource exists. + * Gets the access control policy for a resource. May be empty if no such + * policy or resource exists. * * The async variant is {@see FirewallPoliciesClient::getIamPolicyAsync()} . * @@ -512,7 +513,8 @@ public function getRule(GetRuleFirewallPolicyRequest $request, array $callOption } /** - * Creates a new policy in the specified project using the data included in the request. + * Creates a new policy in the specified project using the data included in + * the request. * * The async variant is {@see FirewallPoliciesClient::insertAsync()} . * @@ -538,7 +540,8 @@ public function insert(InsertFirewallPolicyRequest $request, array $callOptions } /** - * Lists all the policies that have been configured for the specified folder or organization. + * Lists all the policies that have been configured for the specified + * folder or organization. * * The async variant is {@see FirewallPoliciesClient::listAsync()} . * @@ -724,7 +727,8 @@ public function removeRule(RemoveRuleFirewallPolicyRequest $request, array $call } /** - * Sets the access control policy on the specified resource. Replaces any existing policy. + * Sets the access control policy on the specified resource. + * Replaces any existing policy. * * The async variant is {@see FirewallPoliciesClient::setIamPolicyAsync()} . * diff --git a/Compute/src/V1/Client/FirewallsClient.php b/Compute/src/V1/Client/FirewallsClient.php index 713cfd12712c..266b36ccf2fd 100644 --- a/Compute/src/V1/Client/FirewallsClient.php +++ b/Compute/src/V1/Client/FirewallsClient.php @@ -40,6 +40,8 @@ use Google\Cloud\Compute\V1\InsertFirewallRequest; use Google\Cloud\Compute\V1\ListFirewallsRequest; use Google\Cloud\Compute\V1\PatchFirewallRequest; +use Google\Cloud\Compute\V1\TestIamPermissionsFirewallRequest; +use Google\Cloud\Compute\V1\TestPermissionsResponse; use Google\Cloud\Compute\V1\UpdateFirewallRequest; use GuzzleHttp\Promise\PromiseInterface; use Psr\Log\LoggerInterface; @@ -55,6 +57,7 @@ * @method PromiseInterface insertAsync(InsertFirewallRequest $request, array $optionalArgs = []) * @method PromiseInterface listAsync(ListFirewallsRequest $request, array $optionalArgs = []) * @method PromiseInterface patchAsync(PatchFirewallRequest $request, array $optionalArgs = []) + * @method PromiseInterface testIamPermissionsAsync(TestIamPermissionsFirewallRequest $request, array $optionalArgs = []) * @method PromiseInterface updateAsync(UpdateFirewallRequest $request, array $optionalArgs = []) */ final class FirewallsClient @@ -322,7 +325,8 @@ public function get(GetFirewallRequest $request, array $callOptions = []): Firew } /** - * Creates a firewall rule in the specified project using the data included in the request. + * Creates a firewall rule in the specified project using the data + * included in the request. * * The async variant is {@see FirewallsClient::insertAsync()} . * @@ -348,7 +352,8 @@ public function insert(InsertFirewallRequest $request, array $callOptions = []): } /** - * Retrieves the list of firewall rules available to the specified project. + * Retrieves the list of firewall rules available to the specified + * project. * * The async variant is {@see FirewallsClient::listAsync()} . * @@ -374,7 +379,10 @@ public function list(ListFirewallsRequest $request, array $callOptions = []): Pa } /** - * Updates the specified firewall rule with the data included in the request. This method supports PATCH semantics and uses the JSON merge patch format and processing rules. + * Updates the specified firewall rule with the data included in the + * request. This method supportsPATCH + * semantics and uses theJSON merge + * patch format and processing rules. * * The async variant is {@see FirewallsClient::patchAsync()} . * @@ -400,7 +408,38 @@ public function patch(PatchFirewallRequest $request, array $callOptions = []): O } /** - * Updates the specified firewall rule with the data included in the request. Note that all fields will be updated if using PUT, even fields that are not specified. To update individual fields, please use PATCH instead. + * Returns permissions that a caller has on the specified resource. + * + * The async variant is {@see FirewallsClient::testIamPermissionsAsync()} . + * + * @example samples/V1/FirewallsClient/test_iam_permissions.php + * + * @param TestIamPermissionsFirewallRequest $request A request to house fields associated with the call. + * @param array $callOptions { + * Optional. + * + * @type RetrySettings|array $retrySettings + * Retry settings to use for this call. Can be a {@see RetrySettings} object, or an + * associative array of retry settings parameters. See the documentation on + * {@see RetrySettings} for example usage. + * } + * + * @return TestPermissionsResponse + * + * @throws ApiException Thrown if the API call fails. + */ + public function testIamPermissions( + TestIamPermissionsFirewallRequest $request, + array $callOptions = [] + ): TestPermissionsResponse { + return $this->startApiCall('TestIamPermissions', $request, $callOptions)->wait(); + } + + /** + * Updates the specified firewall rule with the data included in the + * request. + * Note that all fields will be updated if using PUT, even fields that are not + * specified. To update individual fields, please use PATCH instead. * * The async variant is {@see FirewallsClient::updateAsync()} . * diff --git a/Compute/src/V1/Client/ForwardingRulesClient.php b/Compute/src/V1/Client/ForwardingRulesClient.php index 801a01c0bd45..40b087599618 100644 --- a/Compute/src/V1/Client/ForwardingRulesClient.php +++ b/Compute/src/V1/Client/ForwardingRulesClient.php @@ -274,7 +274,10 @@ public function __call($method, $args) } /** - * Retrieves an aggregated list of forwarding rules. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. + * Retrieves an aggregated list of forwarding rules. + * + * To prevent failure, it is recommended that you set the + * `returnPartialSuccess` parameter to `true`. * * The async variant is {@see ForwardingRulesClient::aggregatedListAsync()} . * @@ -354,7 +357,8 @@ public function get(GetForwardingRuleRequest $request, array $callOptions = []): } /** - * Creates a ForwardingRule resource in the specified project and region using the data included in the request. + * Creates a ForwardingRule resource in the specified project and region using + * the data included in the request. * * The async variant is {@see ForwardingRulesClient::insertAsync()} . * @@ -380,7 +384,8 @@ public function insert(InsertForwardingRuleRequest $request, array $callOptions } /** - * Retrieves a list of ForwardingRule resources available to the specified project and region. + * Retrieves a list of ForwardingRule resources available to the specified + * project and region. * * The async variant is {@see ForwardingRulesClient::listAsync()} . * @@ -406,7 +411,11 @@ public function list(ListForwardingRulesRequest $request, array $callOptions = [ } /** - * Updates the specified forwarding rule with the data included in the request. This method supports PATCH semantics and uses the JSON merge patch format and processing rules. Currently, you can only patch the network_tier field. + * Updates the specified forwarding rule with the data included in the + * request. This method supportsPATCH + * semantics and uses theJSON merge + * patch format and processing rules. Currently, you can only + * patch the network_tier field. * * The async variant is {@see ForwardingRulesClient::patchAsync()} . * @@ -432,7 +441,9 @@ public function patch(PatchForwardingRuleRequest $request, array $callOptions = } /** - * Sets the labels on the specified resource. To learn more about labels, read the Labeling Resources documentation. + * Sets the labels on the specified resource. To learn more about labels, + * read the + * Labeling Resources documentation. * * The async variant is {@see ForwardingRulesClient::setLabelsAsync()} . * @@ -458,7 +469,8 @@ public function setLabels(SetLabelsForwardingRuleRequest $request, array $callOp } /** - * Changes target URL for forwarding rule. The new target should be of the same type as the old target. + * Changes target URL for forwarding rule. The new target should be of the + * same type as the old target. * * The async variant is {@see ForwardingRulesClient::setTargetAsync()} . * diff --git a/Compute/src/V1/Client/FutureReservationsClient.php b/Compute/src/V1/Client/FutureReservationsClient.php new file mode 100644 index 000000000000..e04b3faabbf9 --- /dev/null +++ b/Compute/src/V1/Client/FutureReservationsClient.php @@ -0,0 +1,461 @@ + aggregatedListAsync(AggregatedListFutureReservationsRequest $request, array $optionalArgs = []) + * @method PromiseInterface cancelAsync(CancelFutureReservationRequest $request, array $optionalArgs = []) + * @method PromiseInterface deleteAsync(DeleteFutureReservationRequest $request, array $optionalArgs = []) + * @method PromiseInterface getAsync(GetFutureReservationRequest $request, array $optionalArgs = []) + * @method PromiseInterface insertAsync(InsertFutureReservationRequest $request, array $optionalArgs = []) + * @method PromiseInterface listAsync(ListFutureReservationsRequest $request, array $optionalArgs = []) + * @method PromiseInterface updateAsync(UpdateFutureReservationRequest $request, array $optionalArgs = []) + */ +final class FutureReservationsClient +{ + use GapicClientTrait; + + /** The name of the service. */ + private const SERVICE_NAME = 'google.cloud.compute.v1.FutureReservations'; + + /** + * The default address of the service. + * + * @deprecated SERVICE_ADDRESS_TEMPLATE should be used instead. + */ + private const SERVICE_ADDRESS = 'compute.googleapis.com'; + + /** The address template of the service. */ + private const SERVICE_ADDRESS_TEMPLATE = 'compute.UNIVERSE_DOMAIN'; + + /** The default port of the service. */ + private const DEFAULT_SERVICE_PORT = 443; + + /** The name of the code generator, to be included in the agent header. */ + private const CODEGEN_NAME = 'gapic'; + + /** The default scopes required by the service. */ + public static $serviceScopes = [ + 'https://www.googleapis.com/auth/compute', + 'https://www.googleapis.com/auth/cloud-platform', + ]; + + private $operationsClient; + + private static function getClientDefaults() + { + return [ + 'serviceName' => self::SERVICE_NAME, + 'apiEndpoint' => self::SERVICE_ADDRESS . ':' . self::DEFAULT_SERVICE_PORT, + 'clientConfig' => __DIR__ . '/../resources/future_reservations_client_config.json', + 'descriptorsConfigPath' => __DIR__ . '/../resources/future_reservations_descriptor_config.php', + 'credentialsConfig' => [ + 'defaultScopes' => self::$serviceScopes, + 'useJwtAccessWithScope' => false, + ], + 'transportConfig' => [ + 'rest' => [ + 'restClientConfigPath' => __DIR__ . '/../resources/future_reservations_rest_client_config.php', + ], + ], + ]; + } + + /** Implements GapicClientTrait::defaultTransport. */ + private static function defaultTransport() + { + return 'rest'; + } + + /** Implements ClientOptionsTrait::supportedTransports. */ + private static function supportedTransports() + { + return ['rest']; + } + + /** + * Return an ZoneOperationsClient object with the same endpoint as $this. + * + * @return ZoneOperationsClient + */ + public function getOperationsClient() + { + return $this->operationsClient; + } + + /** Return the default longrunning operation descriptor config. */ + private function getDefaultOperationDescriptor() + { + return [ + 'additionalArgumentMethods' => ['getProject', 'getZone'], + 'getOperationMethod' => 'get', + 'cancelOperationMethod' => null, + 'deleteOperationMethod' => 'delete', + 'operationErrorCodeMethod' => 'getHttpErrorStatusCode', + 'operationErrorMessageMethod' => 'getHttpErrorMessage', + 'operationNameMethod' => 'getName', + 'operationStatusMethod' => 'getStatus', + 'operationStatusDoneValue' => \Google\Cloud\Compute\V1\Operation\Status::DONE, + 'getOperationRequest' => '\Google\Cloud\Compute\V1\GetZoneOperationRequest', + 'cancelOperationRequest' => null, + 'deleteOperationRequest' => '\Google\Cloud\Compute\V1\DeleteZoneOperationRequest', + ]; + } + + /** + * Resume an existing long running operation that was previously started by a long + * running API method. If $methodName is not provided, or does not match a long + * running API method, then the operation can still be resumed, but the + * OperationResponse object will not deserialize the final response. + * + * @param string $operationName The name of the long running operation + * @param string $methodName The name of the method used to start the operation + * + * @return OperationResponse + */ + public function resumeOperation($operationName, $methodName = null) + { + $options = $this->descriptors[$methodName]['longRunning'] ?? $this->getDefaultOperationDescriptor(); + $operation = new OperationResponse($operationName, $this->getOperationsClient(), $options); + $operation->reload(); + return $operation; + } + + /** + * Create the default operation client for the service. + * + * @param array $options ClientOptions for the client. + * + * @return ZoneOperationsClient + */ + private function createOperationsClient(array $options) + { + // Unset client-specific configuration options + unset($options['serviceName'], $options['clientConfig'], $options['descriptorsConfigPath']); + + if (isset($options['operationsClient'])) { + return $options['operationsClient']; + } + + return new ZoneOperationsClient($options); + } + + /** + * Constructor. + * + * @param array|ClientOptions $options { + * Optional. Options for configuring the service API wrapper. + * + * @type string $apiEndpoint + * The address of the API remote host. May optionally include the port, formatted + * as ":". Default 'compute.googleapis.com:443'. + * @type FetchAuthTokenInterface|CredentialsWrapper $credentials + * This option should only be used with a pre-constructed + * {@see FetchAuthTokenInterface} or {@see CredentialsWrapper} object. Note that + * when one of these objects are provided, any settings in $credentialsConfig will + * be ignored. + * **Important**: If you are providing a path to a credentials file, or a decoded + * credentials file as a PHP array, this usage is now DEPRECATED. Providing an + * unvalidated credential configuration to Google APIs can compromise the security + * of your systems and data. It is recommended to create the credentials explicitly + * ``` + * use Google\Auth\Credentials\ServiceAccountCredentials; + * use Google\Cloud\Compute\V1\FutureReservationsClient; + * $creds = new ServiceAccountCredentials($scopes, $json); + * $options = new FutureReservationsClient(['credentials' => $creds]); + * ``` + * {@see + * https://cloud.google.com/docs/authentication/external/externally-sourced-credentials} + * @type array $credentialsConfig + * Options used to configure credentials, including auth token caching, for the + * client. For a full list of supporting configuration options, see + * {@see \Google\ApiCore\CredentialsWrapper::build()} . + * @type bool $disableRetries + * Determines whether or not retries defined by the client configuration should be + * disabled. Defaults to `false`. + * @type string|array $clientConfig + * Client method configuration, including retry settings. This option can be either + * a path to a JSON file, or a PHP array containing the decoded JSON data. By + * default this settings points to the default client config file, which is + * provided in the resources folder. + * @type string|TransportInterface $transport + * The transport used for executing network requests. At the moment, supports only + * `rest`. *Advanced usage*: Additionally, it is possible to pass in an already + * instantiated {@see \Google\ApiCore\Transport\TransportInterface} object. Note + * that when this object is provided, any settings in $transportConfig, and any + * $apiEndpoint setting, will be ignored. + * @type array $transportConfig + * Configuration options that will be used to construct the transport. Options for + * each supported transport type should be passed in a key for that transport. For + * example: + * $transportConfig = [ + * 'rest' => [...], + * ]; + * See the {@see \Google\ApiCore\Transport\RestTransport::build()} method for the + * supported options. + * @type callable $clientCertSource + * A callable which returns the client cert as a string. This can be used to + * provide a certificate and private key to the transport layer for mTLS. + * @type false|LoggerInterface $logger + * A PSR-3 compliant logger. If set to false, logging is disabled, ignoring the + * 'GOOGLE_SDK_PHP_LOGGING' environment flag + * @type string $universeDomain + * The service domain for the client. Defaults to 'googleapis.com'. + * } + * + * @throws ValidationException + */ + public function __construct(array|ClientOptions $options = []) + { + $clientOptions = $this->buildClientOptions($options); + $this->setClientOptions($clientOptions); + $this->operationsClient = $this->createOperationsClient($clientOptions); + } + + /** Handles execution of the async variants for each documented method. */ + public function __call($method, $args) + { + if (substr($method, -5) !== 'Async') { + trigger_error('Call to undefined method ' . __CLASS__ . "::$method()", E_USER_ERROR); + } + + array_unshift($args, substr($method, 0, -5)); + return call_user_func_array([$this, 'startAsyncCall'], $args); + } + + /** + * Retrieves an aggregated list of future reservations. + * + * To prevent failure, it is recommended that you set the + * `returnPartialSuccess` parameter to `true`. + * + * The async variant is {@see FutureReservationsClient::aggregatedListAsync()} . + * + * @example samples/V1/FutureReservationsClient/aggregated_list.php + * + * @param AggregatedListFutureReservationsRequest $request A request to house fields associated with the call. + * @param array $callOptions { + * Optional. + * + * @type RetrySettings|array $retrySettings + * Retry settings to use for this call. Can be a {@see RetrySettings} object, or an + * associative array of retry settings parameters. See the documentation on + * {@see RetrySettings} for example usage. + * } + * + * @return PagedListResponse + * + * @throws ApiException Thrown if the API call fails. + */ + public function aggregatedList( + AggregatedListFutureReservationsRequest $request, + array $callOptions = [] + ): PagedListResponse { + return $this->startApiCall('AggregatedList', $request, $callOptions); + } + + /** + * Cancel the specified future reservation. + * + * The async variant is {@see FutureReservationsClient::cancelAsync()} . + * + * @example samples/V1/FutureReservationsClient/cancel.php + * + * @param CancelFutureReservationRequest $request A request to house fields associated with the call. + * @param array $callOptions { + * Optional. + * + * @type RetrySettings|array $retrySettings + * Retry settings to use for this call. Can be a {@see RetrySettings} object, or an + * associative array of retry settings parameters. See the documentation on + * {@see RetrySettings} for example usage. + * } + * + * @return OperationResponse + * + * @throws ApiException Thrown if the API call fails. + */ + public function cancel(CancelFutureReservationRequest $request, array $callOptions = []): OperationResponse + { + return $this->startApiCall('Cancel', $request, $callOptions)->wait(); + } + + /** + * Deletes the specified future reservation. + * + * The async variant is {@see FutureReservationsClient::deleteAsync()} . + * + * @example samples/V1/FutureReservationsClient/delete.php + * + * @param DeleteFutureReservationRequest $request A request to house fields associated with the call. + * @param array $callOptions { + * Optional. + * + * @type RetrySettings|array $retrySettings + * Retry settings to use for this call. Can be a {@see RetrySettings} object, or an + * associative array of retry settings parameters. See the documentation on + * {@see RetrySettings} for example usage. + * } + * + * @return OperationResponse + * + * @throws ApiException Thrown if the API call fails. + */ + public function delete(DeleteFutureReservationRequest $request, array $callOptions = []): OperationResponse + { + return $this->startApiCall('Delete', $request, $callOptions)->wait(); + } + + /** + * Retrieves information about the specified future reservation. + * + * The async variant is {@see FutureReservationsClient::getAsync()} . + * + * @example samples/V1/FutureReservationsClient/get.php + * + * @param GetFutureReservationRequest $request A request to house fields associated with the call. + * @param array $callOptions { + * Optional. + * + * @type RetrySettings|array $retrySettings + * Retry settings to use for this call. Can be a {@see RetrySettings} object, or an + * associative array of retry settings parameters. See the documentation on + * {@see RetrySettings} for example usage. + * } + * + * @return FutureReservation + * + * @throws ApiException Thrown if the API call fails. + */ + public function get(GetFutureReservationRequest $request, array $callOptions = []): FutureReservation + { + return $this->startApiCall('Get', $request, $callOptions)->wait(); + } + + /** + * Creates a new Future Reservation. + * + * The async variant is {@see FutureReservationsClient::insertAsync()} . + * + * @example samples/V1/FutureReservationsClient/insert.php + * + * @param InsertFutureReservationRequest $request A request to house fields associated with the call. + * @param array $callOptions { + * Optional. + * + * @type RetrySettings|array $retrySettings + * Retry settings to use for this call. Can be a {@see RetrySettings} object, or an + * associative array of retry settings parameters. See the documentation on + * {@see RetrySettings} for example usage. + * } + * + * @return OperationResponse + * + * @throws ApiException Thrown if the API call fails. + */ + public function insert(InsertFutureReservationRequest $request, array $callOptions = []): OperationResponse + { + return $this->startApiCall('Insert', $request, $callOptions)->wait(); + } + + /** + * A list of all the future reservations that have been configured for the + * specified project in specified zone. + * + * The async variant is {@see FutureReservationsClient::listAsync()} . + * + * @example samples/V1/FutureReservationsClient/list.php + * + * @param ListFutureReservationsRequest $request A request to house fields associated with the call. + * @param array $callOptions { + * Optional. + * + * @type RetrySettings|array $retrySettings + * Retry settings to use for this call. Can be a {@see RetrySettings} object, or an + * associative array of retry settings parameters. See the documentation on + * {@see RetrySettings} for example usage. + * } + * + * @return PagedListResponse + * + * @throws ApiException Thrown if the API call fails. + */ + public function list(ListFutureReservationsRequest $request, array $callOptions = []): PagedListResponse + { + return $this->startApiCall('List', $request, $callOptions); + } + + /** + * Updates the specified future reservation. + * + * The async variant is {@see FutureReservationsClient::updateAsync()} . + * + * @example samples/V1/FutureReservationsClient/update.php + * + * @param UpdateFutureReservationRequest $request A request to house fields associated with the call. + * @param array $callOptions { + * Optional. + * + * @type RetrySettings|array $retrySettings + * Retry settings to use for this call. Can be a {@see RetrySettings} object, or an + * associative array of retry settings parameters. See the documentation on + * {@see RetrySettings} for example usage. + * } + * + * @return OperationResponse + * + * @throws ApiException Thrown if the API call fails. + */ + public function update(UpdateFutureReservationRequest $request, array $callOptions = []): OperationResponse + { + return $this->startApiCall('Update', $request, $callOptions)->wait(); + } +} diff --git a/Compute/src/V1/Client/GlobalAddressesClient.php b/Compute/src/V1/Client/GlobalAddressesClient.php index 2ae1fda6ca02..8b4bb6b00f6f 100644 --- a/Compute/src/V1/Client/GlobalAddressesClient.php +++ b/Compute/src/V1/Client/GlobalAddressesClient.php @@ -325,7 +325,8 @@ public function get(GetGlobalAddressRequest $request, array $callOptions = []): } /** - * Creates an address resource in the specified project by using the data included in the request. + * Creates an address resource in the specified project by using the data + * included in the request. * * The async variant is {@see GlobalAddressesClient::insertAsync()} . * @@ -403,7 +404,8 @@ public function move(MoveGlobalAddressRequest $request, array $callOptions = []) } /** - * Sets the labels on a GlobalAddress. To learn more about labels, read the Labeling Resources documentation. + * Sets the labels on a GlobalAddress. To learn more about labels, read theLabeling + * Resources documentation. * * The async variant is {@see GlobalAddressesClient::setLabelsAsync()} . * diff --git a/Compute/src/V1/Client/GlobalForwardingRulesClient.php b/Compute/src/V1/Client/GlobalForwardingRulesClient.php index 3cb8a4a07d68..b2fc27a0c674 100644 --- a/Compute/src/V1/Client/GlobalForwardingRulesClient.php +++ b/Compute/src/V1/Client/GlobalForwardingRulesClient.php @@ -298,7 +298,8 @@ public function delete(DeleteGlobalForwardingRuleRequest $request, array $callOp } /** - * Returns the specified GlobalForwardingRule resource. Gets a list of available forwarding rules by making a list() request. + * Returns the specified GlobalForwardingRule resource. Gets a list of + * available forwarding rules by making a list() request. * * The async variant is {@see GlobalForwardingRulesClient::getAsync()} . * @@ -324,7 +325,8 @@ public function get(GetGlobalForwardingRuleRequest $request, array $callOptions } /** - * Creates a GlobalForwardingRule resource in the specified project using the data included in the request. + * Creates a GlobalForwardingRule resource in the specified project using + * the data included in the request. * * The async variant is {@see GlobalForwardingRulesClient::insertAsync()} . * @@ -350,7 +352,8 @@ public function insert(InsertGlobalForwardingRuleRequest $request, array $callOp } /** - * Retrieves a list of GlobalForwardingRule resources available to the specified project. + * Retrieves a list of GlobalForwardingRule resources available to the + * specified project. * * The async variant is {@see GlobalForwardingRulesClient::listAsync()} . * @@ -376,7 +379,11 @@ public function list(ListGlobalForwardingRulesRequest $request, array $callOptio } /** - * Updates the specified forwarding rule with the data included in the request. This method supports PATCH semantics and uses the JSON merge patch format and processing rules. Currently, you can only patch the network_tier field. + * Updates the specified forwarding rule with the data included in the + * request. This method supportsPATCH + * semantics and uses theJSON merge + * patch format and processing rules. Currently, you can only + * patch the network_tier field. * * The async variant is {@see GlobalForwardingRulesClient::patchAsync()} . * @@ -402,7 +409,9 @@ public function patch(PatchGlobalForwardingRuleRequest $request, array $callOpti } /** - * Sets the labels on the specified resource. To learn more about labels, read the Labeling resources documentation. + * Sets the labels on the specified resource. To learn more about labels, + * read the + * Labeling resources documentation. * * The async variant is {@see GlobalForwardingRulesClient::setLabelsAsync()} . * @@ -428,7 +437,8 @@ public function setLabels(SetLabelsGlobalForwardingRuleRequest $request, array $ } /** - * Changes target URL for the GlobalForwardingRule resource. The new target should be of the same type as the old target. + * Changes target URL for the GlobalForwardingRule resource. The new target + * should be of the same type as the old target. * * The async variant is {@see GlobalForwardingRulesClient::setTargetAsync()} . * diff --git a/Compute/src/V1/Client/GlobalNetworkEndpointGroupsClient.php b/Compute/src/V1/Client/GlobalNetworkEndpointGroupsClient.php index eb2d0b0eb1c6..276eb7e2b264 100644 --- a/Compute/src/V1/Client/GlobalNetworkEndpointGroupsClient.php +++ b/Compute/src/V1/Client/GlobalNetworkEndpointGroupsClient.php @@ -302,7 +302,8 @@ public function attachNetworkEndpoints( } /** - * Deletes the specified network endpoint group.Note that the NEG cannot be deleted if there are backend services referencing it. + * Deletes the specified network endpoint group.Note that the NEG cannot be + * deleted if there are backend services referencing it. * * The async variant is {@see GlobalNetworkEndpointGroupsClient::deleteAsync()} . * @@ -383,7 +384,8 @@ public function get(GetGlobalNetworkEndpointGroupRequest $request, array $callOp } /** - * Creates a network endpoint group in the specified project using the parameters that are included in the request. + * Creates a network endpoint group in the specified project using the + * parameters that are included in the request. * * The async variant is {@see GlobalNetworkEndpointGroupsClient::insertAsync()} . * @@ -409,7 +411,8 @@ public function insert(InsertGlobalNetworkEndpointGroupRequest $request, array $ } /** - * Retrieves the list of network endpoint groups that are located in the specified project. + * Retrieves the list of network endpoint groups that are located in the + * specified project. * * The async variant is {@see GlobalNetworkEndpointGroupsClient::listAsync()} . * diff --git a/Compute/src/V1/Client/GlobalOperationsClient.php b/Compute/src/V1/Client/GlobalOperationsClient.php index 05408d585574..5c32abc73917 100644 --- a/Compute/src/V1/Client/GlobalOperationsClient.php +++ b/Compute/src/V1/Client/GlobalOperationsClient.php @@ -198,7 +198,10 @@ public function __call($method, $args) } /** - * Retrieves an aggregated list of all operations. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. + * Retrieves an aggregated list of all operations. + * + * To prevent failure, Google recommends that you set the + * `returnPartialSuccess` parameter to `true`. * * The async variant is {@see GlobalOperationsClient::aggregatedListAsync()} . * @@ -280,7 +283,8 @@ public function get(GetGlobalOperationRequest $request, array $callOptions = []) } /** - * Retrieves a list of Operation resources contained within the specified project. + * Retrieves a list of Operation resources contained within the specified + * project. * * The async variant is {@see GlobalOperationsClient::listAsync()} . * @@ -306,7 +310,22 @@ public function list(ListGlobalOperationsRequest $request, array $callOptions = } /** - * Waits for the specified Operation resource to return as `DONE` or for the request to approach the 2 minute deadline, and retrieves the specified Operation resource. This method differs from the `GET` method in that it waits for no more than the default deadline (2 minutes) and then returns the current state of the operation, which might be `DONE` or still in progress. This method is called on a best-effort basis. Specifically: - In uncommon cases, when the server is overloaded, the request might return before the default deadline is reached, or might return after zero seconds. - If the default deadline is reached, there is no guarantee that the operation is actually done when the method returns. Be prepared to retry if the operation is not `DONE`. + * Waits for the specified Operation resource to return as `DONE` + * or for the request to approach the 2 minute deadline, and retrieves the + * specified Operation resource. This method differs from the + * `GET` method in that it waits for no more than the default + * deadline (2 minutes) and then returns the current state of the operation, + * which might be `DONE` or still in progress. + * + * This method is called on a best-effort basis. Specifically: + * + * + * - In uncommon cases, when the server is overloaded, the request might + * return before the default deadline is reached, or might return after zero + * seconds. + * - If the default deadline is reached, there is no guarantee that the + * operation is actually done when the method returns. Be prepared to retry + * if the operation is not `DONE`. * * The async variant is {@see GlobalOperationsClient::waitAsync()} . * diff --git a/Compute/src/V1/Client/GlobalOrganizationOperationsClient.php b/Compute/src/V1/Client/GlobalOrganizationOperationsClient.php index 235c20f17fdc..127567e13845 100644 --- a/Compute/src/V1/Client/GlobalOrganizationOperationsClient.php +++ b/Compute/src/V1/Client/GlobalOrganizationOperationsClient.php @@ -223,7 +223,8 @@ public function delete( } /** - * Retrieves the specified Operations resource. Gets a list of operations by making a `list()` request. + * Retrieves the specified Operations resource. Gets a list of operations + * by making a `list()` request. * * The async variant is {@see GlobalOrganizationOperationsClient::getAsync()} . * @@ -249,7 +250,8 @@ public function get(GetGlobalOrganizationOperationRequest $request, array $callO } /** - * Retrieves a list of Operation resources contained within the specified organization. + * Retrieves a list of Operation resources contained within the specified + * organization. * * The async variant is {@see GlobalOrganizationOperationsClient::listAsync()} . * diff --git a/Compute/src/V1/Client/GlobalPublicDelegatedPrefixesClient.php b/Compute/src/V1/Client/GlobalPublicDelegatedPrefixesClient.php index 87ab3f27eb2a..4d6a131e034a 100644 --- a/Compute/src/V1/Client/GlobalPublicDelegatedPrefixesClient.php +++ b/Compute/src/V1/Client/GlobalPublicDelegatedPrefixesClient.php @@ -323,7 +323,8 @@ public function get(GetGlobalPublicDelegatedPrefixeRequest $request, array $call } /** - * Creates a global PublicDelegatedPrefix in the specified project using the parameters that are included in the request. + * Creates a global PublicDelegatedPrefix in the specified project using the + * parameters that are included in the request. * * The async variant is {@see GlobalPublicDelegatedPrefixesClient::insertAsync()} . * @@ -377,7 +378,10 @@ public function list(ListGlobalPublicDelegatedPrefixesRequest $request, array $c } /** - * Patches the specified global PublicDelegatedPrefix resource with the data included in the request. This method supports PATCH semantics and uses JSON merge patch format and processing rules. + * Patches the specified global PublicDelegatedPrefix resource with the data + * included in the request. This method supportsPATCH + * semantics and usesJSON merge + * patch format and processing rules. * * The async variant is {@see GlobalPublicDelegatedPrefixesClient::patchAsync()} . * diff --git a/Compute/src/V1/Client/HealthChecksClient.php b/Compute/src/V1/Client/HealthChecksClient.php index 2fbe4a4957df..35e5bcb97961 100644 --- a/Compute/src/V1/Client/HealthChecksClient.php +++ b/Compute/src/V1/Client/HealthChecksClient.php @@ -272,7 +272,11 @@ public function __call($method, $args) } /** - * Retrieves the list of all HealthCheck resources, regional and global, available to the specified project. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. + * Retrieves the list of all HealthCheck resources, regional and global, + * available to the specified project. + * + * To prevent failure, Google recommends that you set the + * `returnPartialSuccess` parameter to `true`. * * The async variant is {@see HealthChecksClient::aggregatedListAsync()} . * @@ -352,7 +356,8 @@ public function get(GetHealthCheckRequest $request, array $callOptions = []): He } /** - * Creates a HealthCheck resource in the specified project using the data included in the request. + * Creates a HealthCheck resource in the specified project using the data + * included in the request. * * The async variant is {@see HealthChecksClient::insertAsync()} . * @@ -378,7 +383,8 @@ public function insert(InsertHealthCheckRequest $request, array $callOptions = [ } /** - * Retrieves the list of HealthCheck resources available to the specified project. + * Retrieves the list of HealthCheck resources available to the specified + * project. * * The async variant is {@see HealthChecksClient::listAsync()} . * @@ -404,7 +410,10 @@ public function list(ListHealthChecksRequest $request, array $callOptions = []): } /** - * Updates a HealthCheck resource in the specified project using the data included in the request. This method supports PATCH semantics and uses the JSON merge patch format and processing rules. + * Updates a HealthCheck resource in the specified project using the data + * included in the request. This method supportsPATCH + * semantics and uses theJSON merge + * patch format and processing rules. * * The async variant is {@see HealthChecksClient::patchAsync()} . * @@ -430,7 +439,8 @@ public function patch(PatchHealthCheckRequest $request, array $callOptions = []) } /** - * Updates a HealthCheck resource in the specified project using the data included in the request. + * Updates a HealthCheck resource in the specified project using the data + * included in the request. * * The async variant is {@see HealthChecksClient::updateAsync()} . * diff --git a/Compute/src/V1/Client/ImageFamilyViewsClient.php b/Compute/src/V1/Client/ImageFamilyViewsClient.php index e629a6f905db..a505e7e8d8c5 100644 --- a/Compute/src/V1/Client/ImageFamilyViewsClient.php +++ b/Compute/src/V1/Client/ImageFamilyViewsClient.php @@ -189,7 +189,8 @@ public function __call($method, $args) } /** - * Returns the latest image that is part of an image family, is not deprecated and is rolled out in the specified zone. + * Returns the latest image that is part of an image family, is not + * deprecated and is rolled out in the specified zone. * * The async variant is {@see ImageFamilyViewsClient::getAsync()} . * diff --git a/Compute/src/V1/Client/ImagesClient.php b/Compute/src/V1/Client/ImagesClient.php index 37e1bee02457..bca47394e468 100644 --- a/Compute/src/V1/Client/ImagesClient.php +++ b/Compute/src/V1/Client/ImagesClient.php @@ -308,7 +308,9 @@ public function delete(DeleteImageRequest $request, array $callOptions = []): Op } /** - * Sets the deprecation status of an image. If an empty request body is given, clears the deprecation status instead. + * Sets the deprecation status of an image. + * + * If an empty request body is given, clears the deprecation status instead. * * The async variant is {@see ImagesClient::deprecateAsync()} . * @@ -360,7 +362,9 @@ public function get(GetImageRequest $request, array $callOptions = []): Image } /** - * Returns the latest image that is part of an image family and is not deprecated. For more information on image families, see Public image families documentation. + * Returns the latest image that is part of an image family and is not + * deprecated. For more information on image families, seePublic + * image families documentation. * * The async variant is {@see ImagesClient::getFromFamilyAsync()} . * @@ -386,7 +390,8 @@ public function getFromFamily(GetFromFamilyImageRequest $request, array $callOpt } /** - * Gets the access control policy for a resource. May be empty if no such policy or resource exists. + * Gets the access control policy for a resource. May be empty if no such + * policy or resource exists. * * The async variant is {@see ImagesClient::getIamPolicyAsync()} . * @@ -412,7 +417,8 @@ public function getIamPolicy(GetIamPolicyImageRequest $request, array $callOptio } /** - * Creates an image in the specified project using the data included in the request. + * Creates an image in the specified project using the data included + * in the request. * * The async variant is {@see ImagesClient::insertAsync()} . * @@ -438,7 +444,13 @@ public function insert(InsertImageRequest $request, array $callOptions = []): Op } /** - * Retrieves the list of custom images available to the specified project. Custom images are images you create that belong to your project. This method does not get any images that belong to other projects, including publicly-available images, like Debian 8. If you want to get a list of publicly-available images, use this method to make a request to the respective image project, such as debian-cloud or windows-cloud. + * Retrieves the list of custom images + * available to the specified project. Custom images are images you + * create that belong to your project. This method does not + * get any images that belong to other projects, including publicly-available + * images, like Debian 8. If you want to get a list of publicly-available + * images, use this method to make a request to the respective image project, + * such as debian-cloud or windows-cloud. * * The async variant is {@see ImagesClient::listAsync()} . * @@ -464,7 +476,9 @@ public function list(ListImagesRequest $request, array $callOptions = []): Paged } /** - * Patches the specified image with the data included in the request. Only the following fields can be modified: family, description, deprecation status. + * Patches the specified image with the data included in the request. + * Only the following fields can be modified: family, description, + * deprecation status. * * The async variant is {@see ImagesClient::patchAsync()} . * @@ -490,7 +504,8 @@ public function patch(PatchImageRequest $request, array $callOptions = []): Oper } /** - * Sets the access control policy on the specified resource. Replaces any existing policy. + * Sets the access control policy on the specified resource. + * Replaces any existing policy. * * The async variant is {@see ImagesClient::setIamPolicyAsync()} . * @@ -516,7 +531,8 @@ public function setIamPolicy(SetIamPolicyImageRequest $request, array $callOptio } /** - * Sets the labels on an image. To learn more about labels, read the Labeling Resources documentation. + * Sets the labels on an image. To learn more about labels, read theLabeling + * Resources documentation. * * The async variant is {@see ImagesClient::setLabelsAsync()} . * diff --git a/Compute/src/V1/Client/InstanceGroupManagerResizeRequestsClient.php b/Compute/src/V1/Client/InstanceGroupManagerResizeRequestsClient.php index bea56baab3e9..b300477478ce 100644 --- a/Compute/src/V1/Client/InstanceGroupManagerResizeRequestsClient.php +++ b/Compute/src/V1/Client/InstanceGroupManagerResizeRequestsClient.php @@ -271,7 +271,10 @@ public function __call($method, $args) } /** - * Cancels the specified resize request and removes it from the queue. Cancelled resize request does no longer wait for the resources to be provisioned. Cancel is only possible for requests that are accepted in the queue. + * Cancels the specified resize request and removes it from the queue. + * Cancelled resize request does no longer wait for the resources to be + * provisioned. Cancel is only possible for requests that are accepted in the + * queue. * * The async variant is * {@see InstanceGroupManagerResizeRequestsClient::cancelAsync()} . @@ -300,7 +303,9 @@ public function cancel( } /** - * Deletes the specified, inactive resize request. Requests that are still active cannot be deleted. Deleting request does not delete instances that were provisioned previously. + * Deletes the specified, inactive resize request. Requests that are still + * active cannot be deleted. Deleting request does not delete instances that + * were provisioned previously. * * The async variant is * {@see InstanceGroupManagerResizeRequestsClient::deleteAsync()} . @@ -358,7 +363,8 @@ public function get( } /** - * Creates a new resize request that starts provisioning VMs immediately or queues VM creation. + * Creates a new resize request that starts provisioning VMs immediately + * or queues VM creation. * * The async variant is * {@see InstanceGroupManagerResizeRequestsClient::insertAsync()} . @@ -387,7 +393,8 @@ public function insert( } /** - * Retrieves a list of resize requests that are contained in the managed instance group. + * Retrieves a list of resize requests that are contained in the + * managed instance group. * * The async variant is * {@see InstanceGroupManagerResizeRequestsClient::listAsync()} . diff --git a/Compute/src/V1/Client/InstanceGroupManagersClient.php b/Compute/src/V1/Client/InstanceGroupManagersClient.php index 9463f1b8c0f5..ade5a14edb52 100644 --- a/Compute/src/V1/Client/InstanceGroupManagersClient.php +++ b/Compute/src/V1/Client/InstanceGroupManagersClient.php @@ -306,7 +306,21 @@ public function __call($method, $args) } /** - * Flags the specified instances to be removed from the managed instance group. Abandoning an instance does not delete the instance, but it does remove the instance from any target pools that are applied by the managed instance group. This method reduces the targetSize of the managed instance group by the number of instances that you abandon. This operation is marked as DONE when the action is scheduled even if the instances have not yet been removed from the group. You must separately verify the status of the abandoning action with the listmanagedinstances method. If the group is part of a backend service that has enabled connection draining, it can take up to 60 seconds after the connection draining duration has elapsed before the VM instance is removed or deleted. You can specify a maximum of 1000 instances with this method per request. + * Flags the specified instances to be removed from the + * managed instance group. Abandoning an instance does not delete the + * instance, but it does remove the instance from any target pools that are + * applied by the managed instance group. This method reduces thetargetSize of the managed instance group by the + * number of instances that you abandon. This operation is marked asDONE when the action is scheduled even if the instances have + * not yet been removed from the group. You must separately verify the + * status of the abandoning action with thelistmanagedinstances + * method. + * + * If the group is part of a backend + * service that has enabled + * connection draining, it can take up to 60 seconds after the connection + * draining duration has elapsed before the VM instance is removed or deleted. + * + * You can specify a maximum of 1000 instances with this method per request. * * The async variant is {@see InstanceGroupManagersClient::abandonInstancesAsync()} * . @@ -335,7 +349,10 @@ public function abandonInstances( } /** - * Retrieves the list of managed instance groups and groups them by zone. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. + * Retrieves the list of managed instance groups and groups them by zone. + * + * To prevent failure, Google recommends that you set the + * `returnPartialSuccess` parameter to `true`. * * The async variant is {@see InstanceGroupManagersClient::aggregatedListAsync()} . * @@ -363,7 +380,8 @@ public function aggregatedList( } /** - * Applies changes to selected instances on the managed instance group. This method can be used to apply new overrides and/or new versions. + * Applies changes to selected instances on the managed instance group. + * This method can be used to apply new overrides and/or new versions. * * The async variant is * {@see InstanceGroupManagersClient::applyUpdatesToInstancesAsync()} . @@ -392,7 +410,10 @@ public function applyUpdatesToInstances( } /** - * Creates instances with per-instance configurations in this managed instance group. Instances are created using the current instance template. The create instances operation is marked DONE if the createInstances request is successful. The underlying actions take additional time. You must separately verify the status of the creating or actions with the listmanagedinstances method. + * Creates instances with per-instance configurations in this managed instance + * group. Instances are created using the current instance template. Thecreate instances operation is marked DONE if thecreateInstances request is successful. The underlying actions + * take additional time. You must separately verify the status of thecreating or actions with the listmanagedinstances + * method. * * The async variant is {@see InstanceGroupManagersClient::createInstancesAsync()} * . @@ -421,7 +442,10 @@ public function createInstances( } /** - * Deletes the specified managed instance group and all of the instances in that group. Note that the instance group must not belong to a backend service. Read Deleting an instance group for more information. + * Deletes the specified managed instance group and all of the instances + * in that group. Note that the instance group must not belong to a + * backend service. Read + * Deleting an instance group for more information. * * The async variant is {@see InstanceGroupManagersClient::deleteAsync()} . * @@ -447,7 +471,21 @@ public function delete(DeleteInstanceGroupManagerRequest $request, array $callOp } /** - * Flags the specified instances in the managed instance group for immediate deletion. The instances are also removed from any target pools of which they were a member. This method reduces the targetSize of the managed instance group by the number of instances that you delete. This operation is marked as DONE when the action is scheduled even if the instances are still being deleted. You must separately verify the status of the deleting action with the listmanagedinstances method. If the group is part of a backend service that has enabled connection draining, it can take up to 60 seconds after the connection draining duration has elapsed before the VM instance is removed or deleted. You can specify a maximum of 1000 instances with this method per request. + * Flags the specified instances in the managed instance group for immediate + * deletion. The instances are also removed from any target + * pools of which they were a member. This method reduces thetargetSize of the managed instance group by the number of + * instances that you delete. This operation is marked as DONE + * when the action is scheduled even if the instances are still being deleted. + * You must separately verify the status of the deleting action + * with thelistmanagedinstances + * method. + * + * If the group is part of a backend + * service that has enabled + * connection draining, it can take up to 60 seconds after the connection + * draining duration has elapsed before the VM instance is removed or deleted. + * + * You can specify a maximum of 1000 instances with this method per request. * * The async variant is {@see InstanceGroupManagersClient::deleteInstancesAsync()} * . @@ -476,7 +514,8 @@ public function deleteInstances( } /** - * Deletes selected per-instance configurations for the managed instance group. + * Deletes selected per-instance configurations for the managed instance + * group. * * The async variant is * {@see InstanceGroupManagersClient::deletePerInstanceConfigsAsync()} . @@ -531,7 +570,17 @@ public function get(GetInstanceGroupManagerRequest $request, array $callOptions } /** - * Creates a managed instance group using the information that you specify in the request. After the group is created, instances in the group are created using the specified instance template. This operation is marked as DONE when the group is created even if the instances in the group have not yet been created. You must separately verify the status of the individual instances with the listmanagedinstances method. A managed instance group can have up to 1000 VM instances per group. Please contact Cloud Support if you need an increase in this limit. + * Creates a managed instance group using the information that you specify + * in the request. After the group is created, instances in the group are + * created using the specified instance template. + * This operation is marked as DONE when the group is created + * even if the instances in the group have not yet been created. You + * must separately verify the status of the individual instances with thelistmanagedinstances + * method. + * + * A managed instance group can have up to 1000 VM instances per group. Please + * contact Cloud Support if you need an increase in + * this limit. * * The async variant is {@see InstanceGroupManagersClient::insertAsync()} . * @@ -557,7 +606,8 @@ public function insert(InsertInstanceGroupManagerRequest $request, array $callOp } /** - * Retrieves a list of managed instance groups that are contained within the specified project and zone. + * Retrieves a list of managed instance groups that are contained within the + * specified project and zone. * * The async variant is {@see InstanceGroupManagersClient::listAsync()} . * @@ -583,7 +633,9 @@ public function list(ListInstanceGroupManagersRequest $request, array $callOptio } /** - * Lists all errors thrown by actions on instances for a given managed instance group. The filter and orderBy query parameters are not supported. + * Lists all errors thrown by actions on instances for a given managed + * instance group. The filter and orderBy query + * parameters are not supported. * * The async variant is {@see InstanceGroupManagersClient::listErrorsAsync()} . * @@ -611,7 +663,15 @@ public function listErrors( } /** - * Lists all of the instances in the managed instance group. Each instance in the list has a currentAction, which indicates the action that the managed instance group is performing on the instance. For example, if the group is still creating an instance, the currentAction is CREATING. If a previous action failed, the list displays the errors for that failed action. The orderBy query parameter is not supported. The `pageToken` query parameter is supported only if the group's `listManagedInstancesResults` field is set to `PAGINATED`. + * Lists all of the instances in the managed instance group. Each instance + * in the list has a currentAction, which indicates the action + * that the managed instance group is performing on the instance. For example, + * if the group is still creating an instance, the currentAction + * is CREATING. If a previous action failed, the + * list displays the errors for that failed action. The orderBy + * query parameter is not supported. The `pageToken` query parameter is + * supported only if the group's `listManagedInstancesResults` field is set + * to `PAGINATED`. * * The async variant is * {@see InstanceGroupManagersClient::listManagedInstancesAsync()} . @@ -640,7 +700,8 @@ public function listManagedInstances( } /** - * Lists all of the per-instance configurations defined for the managed instance group. The orderBy query parameter is not supported. + * Lists all of the per-instance configurations defined for the managed + * instance group. The orderBy query parameter is not supported. * * The async variant is * {@see InstanceGroupManagersClient::listPerInstanceConfigsAsync()} . @@ -669,7 +730,21 @@ public function listPerInstanceConfigs( } /** - * Updates a managed instance group using the information that you specify in the request. This operation is marked as DONE when the group is patched even if the instances in the group are still in the process of being patched. You must separately verify the status of the individual instances with the listManagedInstances method. This method supports PATCH semantics and uses the JSON merge patch format and processing rules. If you update your group to specify a new template or instance configuration, it's possible that your intended specification for each VM in the group is different from the current state of that VM. To learn how to apply an updated configuration to the VMs in a MIG, see Updating instances in a MIG. + * Updates a managed instance group using the information that you specify + * in the request. + * This operation is marked as DONE when the group is patched + * even if the instances in the group are still in the process of being + * patched. You must separately verify the status of the individual instances + * with thelistManagedInstances + * method. This method supportsPATCH + * semantics and uses theJSON merge + * patch format and processing rules. + * + * If you update your group to specify a new template or instance + * configuration, it's possible that your intended specification for each VM + * in the group is different from the current state of that VM. To learn how + * to apply an updated configuration to the VMs in a MIG, seeUpdating instances in + * a MIG. * * The async variant is {@see InstanceGroupManagersClient::patchAsync()} . * @@ -695,7 +770,9 @@ public function patch(PatchInstanceGroupManagerRequest $request, array $callOpti } /** - * Inserts or patches per-instance configurations for the managed instance group. perInstanceConfig.name serves as a key used to distinguish whether to perform insert or patch. + * Inserts or patches per-instance configurations for the managed instance + * group. perInstanceConfig.name serves as a key used to + * distinguish whether to perform insert or patch. * * The async variant is * {@see InstanceGroupManagersClient::patchPerInstanceConfigsAsync()} . @@ -724,7 +801,19 @@ public function patchPerInstanceConfigs( } /** - * Flags the specified VM instances in the managed instance group to be immediately recreated. Each instance is recreated using the group's current configuration. This operation is marked as DONE when the flag is set even if the instances have not yet been recreated. You must separately verify the status of each instance by checking its currentAction field; for more information, see Checking the status of managed instances. If the group is part of a backend service that has enabled connection draining, it can take up to 60 seconds after the connection draining duration has elapsed before the VM instance is removed or deleted. You can specify a maximum of 1000 instances with this method per request. + * Flags the specified VM instances in the managed instance group to be + * immediately recreated. Each instance is recreated using the group's current + * configuration. This operation is marked as DONE when the flag + * is set even if the instances have not yet been recreated. You must + * separately verify the status of each instance by checking itscurrentAction field; for more information, see Checking + * the status of managed instances. + * + * If the group is part of a backend + * service that has enabled + * connection draining, it can take up to 60 seconds after the connection + * draining duration has elapsed before the VM instance is removed or deleted. + * + * You can specify a maximum of 1000 instances with this method per request. * * The async variant is * {@see InstanceGroupManagersClient::recreateInstancesAsync()} . @@ -753,7 +842,29 @@ public function recreateInstances( } /** - * Resizes the managed instance group. If you increase the size, the group creates new instances using the current instance template. If you decrease the size, the group deletes instances. The resize operation is marked DONE when the resize actions are scheduled even if the group has not yet added or deleted any instances. You must separately verify the status of the creating or deleting actions with the listmanagedinstances method. When resizing down, the instance group arbitrarily chooses the order in which VMs are deleted. The group takes into account some VM attributes when making the selection including: + The status of the VM instance. + The health of the VM instance. + The instance template version the VM is based on. + For regional managed instance groups, the location of the VM instance. This list is subject to change. If the group is part of a backend service that has enabled connection draining, it can take up to 60 seconds after the connection draining duration has elapsed before the VM instance is removed or deleted. + * Resizes the managed instance group. If you increase the size, the group + * creates new instances using the current instance template. If you decrease + * the size, the group deletes instances. The resize operation is markedDONE when the resize actions are scheduled even if the group + * has not yet added or deleted any instances. You must separately + * verify the status of the creating or deleting + * actions with thelistmanagedinstances + * method. + * + * When resizing down, the instance group arbitrarily chooses the order in + * which VMs are deleted. The group takes into account some VM attributes when + * making the selection including: + * + * + The status of the VM instance. + * + The health of the VM instance. + * + The instance template version the VM is based on. + * + For regional managed instance groups, the location of the VM instance. + * + * This list is subject to change. + * + * If the group is part of a backend + * service that has enabled + * connection draining, it can take up to 60 seconds after the connection + * draining duration has elapsed before the VM instance is removed or deleted. * * The async variant is {@see InstanceGroupManagersClient::resizeAsync()} . * @@ -779,7 +890,22 @@ public function resize(ResizeInstanceGroupManagerRequest $request, array $callOp } /** - * Flags the specified instances in the managed instance group to be resumed. This method increases the targetSize and decreases the targetSuspendedSize of the managed instance group by the number of instances that you resume. The resumeInstances operation is marked DONE if the resumeInstances request is successful. The underlying actions take additional time. You must separately verify the status of the RESUMING action with the listmanagedinstances method. In this request, you can only specify instances that are suspended. For example, if an instance was previously suspended using the suspendInstances method, it can be resumed using the resumeInstances method. If a health check is attached to the managed instance group, the specified instances will be verified as healthy after they are resumed. You can specify a maximum of 1000 instances with this method per request. + * Flags the specified instances in the managed instance group to be + * resumed. This method increases thetargetSize and decreases the targetSuspendedSize + * of the managed instance group by the number of instances that you resume. + * The resumeInstances operation is marked DONE if + * the resumeInstances request is successful. The underlying + * actions take additional time. You must separately verify the status of theRESUMING action with thelistmanagedinstances + * method. + * + * In this request, you can only specify instances that are suspended. For + * example, if an instance was previously suspended using the suspendInstances + * method, it can be resumed using the resumeInstances method. + * + * If a health check is attached to the managed instance group, the specified + * instances will be verified as healthy after they are resumed. + * + * You can specify a maximum of 1000 instances with this method per request. * * The async variant is {@see InstanceGroupManagersClient::resumeInstancesAsync()} * . @@ -808,7 +934,9 @@ public function resumeInstances( } /** - * Specifies the instance template to use when creating new instances in this group. The templates for existing instances in the group do not change unless you run recreateInstances, run applyUpdatesToInstances, or set the group's updatePolicy.type to PROACTIVE. + * Specifies the instance template to use when creating new instances in this + * group. The templates for existing instances in the group do not change + * unless you run recreateInstances, runapplyUpdatesToInstances, or set the group'supdatePolicy.type to PROACTIVE. * * The async variant is * {@see InstanceGroupManagersClient::setInstanceTemplateAsync()} . @@ -837,7 +965,12 @@ public function setInstanceTemplate( } /** - * Modifies the target pools to which all instances in this managed instance group are assigned. The target pools automatically apply to all of the instances in the managed instance group. This operation is marked DONE when you make the request even if the instances have not yet been added to their target pools. The change might take some time to apply to all of the instances in the group depending on the size of the group. + * Modifies the target pools to which all instances in this managed instance + * group are assigned. The target pools automatically apply to all of the + * instances in the managed instance group. This operation is markedDONE when you make the request even if the instances have not + * yet been added to their target pools. The change might take some time to + * apply to all of the instances in the group depending on the size of the + * group. * * The async variant is {@see InstanceGroupManagersClient::setTargetPoolsAsync()} . * @@ -865,7 +998,22 @@ public function setTargetPools( } /** - * Flags the specified instances in the managed instance group to be started. This method increases the targetSize and decreases the targetStoppedSize of the managed instance group by the number of instances that you start. The startInstances operation is marked DONE if the startInstances request is successful. The underlying actions take additional time. You must separately verify the status of the STARTING action with the listmanagedinstances method. In this request, you can only specify instances that are stopped. For example, if an instance was previously stopped using the stopInstances method, it can be started using the startInstances method. If a health check is attached to the managed instance group, the specified instances will be verified as healthy after they are started. You can specify a maximum of 1000 instances with this method per request. + * Flags the specified instances in the managed instance group to be + * started. This method increases thetargetSize and decreases the targetStoppedSize + * of the managed instance group by the number of instances that you start. + * The startInstances operation is marked DONE if + * the startInstances request is successful. The underlying + * actions take additional time. You must separately verify the status of theSTARTING action with thelistmanagedinstances + * method. + * + * In this request, you can only specify instances that are stopped. For + * example, if an instance was previously stopped using the stopInstances + * method, it can be started using the startInstances method. + * + * If a health check is attached to the managed instance group, the specified + * instances will be verified as healthy after they are started. + * + * You can specify a maximum of 1000 instances with this method per request. * * The async variant is {@see InstanceGroupManagersClient::startInstancesAsync()} . * @@ -893,7 +1041,31 @@ public function startInstances( } /** - * Flags the specified instances in the managed instance group to be immediately stopped. You can only specify instances that are running in this request. This method reduces the targetSize and increases the targetStoppedSize of the managed instance group by the number of instances that you stop. The stopInstances operation is marked DONE if the stopInstances request is successful. The underlying actions take additional time. You must separately verify the status of the STOPPING action with the listmanagedinstances method. If the standbyPolicy.initialDelaySec field is set, the group delays stopping the instances until initialDelaySec have passed from instance.creationTimestamp (that is, when the instance was created). This delay gives your application time to set itself up and initialize on the instance. If more than initialDelaySec seconds have passed since instance.creationTimestamp when this method is called, there will be zero delay. If the group is part of a backend service that has enabled connection draining, it can take up to 60 seconds after the connection draining duration has elapsed before the VM instance is stopped. Stopped instances can be started using the startInstances method. You can specify a maximum of 1000 instances with this method per request. + * Flags the specified instances in the managed instance group to be + * immediately stopped. You can only specify instances that are running in + * this request. This method reduces thetargetSize and increases the targetStoppedSize + * of the managed instance group by the number of instances that you stop. + * The stopInstances operation is marked DONE if + * the stopInstances request is successful. The underlying + * actions take additional time. You must separately verify the status of theSTOPPING action with thelistmanagedinstances + * method. + * + * If the standbyPolicy.initialDelaySec field is set, the group + * delays stopping the instances until initialDelaySec have + * passed from instance.creationTimestamp (that is, when the + * instance was created). This delay gives your application time to + * set itself up and initialize on the instance. If more thaninitialDelaySec seconds have passed sinceinstance.creationTimestamp when this method is called, there + * will be zero delay. + * + * If the group is part of a backend + * service that has enabled + * connection draining, it can take up to 60 seconds after the connection + * draining duration has elapsed before the VM instance is stopped. + * + * Stopped instances can be started using the startInstances + * method. + * + * You can specify a maximum of 1000 instances with this method per request. * * The async variant is {@see InstanceGroupManagersClient::stopInstancesAsync()} . * @@ -921,7 +1093,31 @@ public function stopInstances( } /** - * Flags the specified instances in the managed instance group to be immediately suspended. You can only specify instances that are running in this request. This method reduces the targetSize and increases the targetSuspendedSize of the managed instance group by the number of instances that you suspend. The suspendInstances operation is marked DONE if the suspendInstances request is successful. The underlying actions take additional time. You must separately verify the status of the SUSPENDING action with the listmanagedinstances method. If the standbyPolicy.initialDelaySec field is set, the group delays suspension of the instances until initialDelaySec have passed from instance.creationTimestamp (that is, when the instance was created). This delay gives your application time to set itself up and initialize on the instance. If more than initialDelaySec seconds have passed since instance.creationTimestamp when this method is called, there will be zero delay. If the group is part of a backend service that has enabled connection draining, it can take up to 60 seconds after the connection draining duration has elapsed before the VM instance is suspended. Suspended instances can be resumed using the resumeInstances method. You can specify a maximum of 1000 instances with this method per request. + * Flags the specified instances in the managed instance group to be + * immediately suspended. You can only specify instances that are running in + * this request. This method reduces thetargetSize and increases the targetSuspendedSize + * of the managed instance group by the number of instances that you suspend. + * The suspendInstances operation is marked DONE if + * the suspendInstances request is successful. The underlying + * actions take additional time. You must separately verify the status of theSUSPENDING action with thelistmanagedinstances + * method. + * + * If the standbyPolicy.initialDelaySec field is set, the group + * delays suspension of the instances until initialDelaySec have + * passed from instance.creationTimestamp (that is, when the + * instance was created). This delay gives your application time to + * set itself up and initialize on the instance. If more thaninitialDelaySec seconds have passed sinceinstance.creationTimestamp when this method is called, there + * will be zero delay. + * + * If the group is part of a backend + * service that has enabled + * connection draining, it can take up to 60 seconds after the connection + * draining duration has elapsed before the VM instance is suspended. + * + * Suspended instances can be resumed using the resumeInstances + * method. + * + * You can specify a maximum of 1000 instances with this method per request. * * The async variant is {@see InstanceGroupManagersClient::suspendInstancesAsync()} * . @@ -950,7 +1146,9 @@ public function suspendInstances( } /** - * Inserts or updates per-instance configurations for the managed instance group. perInstanceConfig.name serves as a key used to distinguish whether to perform insert or patch. + * Inserts or updates per-instance configurations for the managed instance + * group. perInstanceConfig.name serves as a key used to + * distinguish whether to perform insert or patch. * * The async variant is * {@see InstanceGroupManagersClient::updatePerInstanceConfigsAsync()} . diff --git a/Compute/src/V1/Client/InstanceGroupsClient.php b/Compute/src/V1/Client/InstanceGroupsClient.php index 64310281a0df..fccd9f8102cb 100644 --- a/Compute/src/V1/Client/InstanceGroupsClient.php +++ b/Compute/src/V1/Client/InstanceGroupsClient.php @@ -279,7 +279,10 @@ public function __call($method, $args) } /** - * Adds a list of instances to the specified instance group. All of the instances in the instance group must be in the same network/subnetwork. Read Adding instances for more information. + * Adds a list of instances to the specified instance group. All of the + * instances in the instance group must be in the same network/subnetwork. + * Read + * Adding instances for more information. * * The async variant is {@see InstanceGroupsClient::addInstancesAsync()} . * @@ -305,7 +308,10 @@ public function addInstances(AddInstancesInstanceGroupRequest $request, array $c } /** - * Retrieves the list of instance groups and sorts them by zone. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. + * Retrieves the list of instance groups and sorts them by zone. + * + * To prevent failure, Google recommends that you set the + * `returnPartialSuccess` parameter to `true`. * * The async variant is {@see InstanceGroupsClient::aggregatedListAsync()} . * @@ -333,7 +339,10 @@ public function aggregatedList( } /** - * Deletes the specified instance group. The instances in the group are not deleted. Note that instance group must not belong to a backend service. Read Deleting an instance group for more information. + * Deletes the specified instance group. The instances in the group are not + * deleted. Note that instance group must not belong to a backend service. + * Read + * Deleting an instance group for more information. * * The async variant is {@see InstanceGroupsClient::deleteAsync()} . * @@ -359,7 +368,12 @@ public function delete(DeleteInstanceGroupRequest $request, array $callOptions = } /** - * Returns the specified zonal instance group. Get a list of available zonal instance groups by making a list() request. For managed instance groups, use the instanceGroupManagers or regionInstanceGroupManagers methods instead. + * Returns the specified zonal instance group. Get a list of available zonal + * instance groups by making a list() request. + * + * For managed instance groups, use theinstanceGroupManagers + * or regionInstanceGroupManagers + * methods instead. * * The async variant is {@see InstanceGroupsClient::getAsync()} . * @@ -385,7 +399,8 @@ public function get(GetInstanceGroupRequest $request, array $callOptions = []): } /** - * Creates an instance group in the specified project using the parameters that are included in the request. + * Creates an instance group in the specified project using the + * parameters that are included in the request. * * The async variant is {@see InstanceGroupsClient::insertAsync()} . * @@ -411,7 +426,12 @@ public function insert(InsertInstanceGroupRequest $request, array $callOptions = } /** - * Retrieves the list of zonal instance group resources contained within the specified zone. For managed instance groups, use the instanceGroupManagers or regionInstanceGroupManagers methods instead. + * Retrieves the list of zonal instance group resources contained within the + * specified zone. + * + * For managed instance groups, use theinstanceGroupManagers + * or regionInstanceGroupManagers + * methods instead. * * The async variant is {@see InstanceGroupsClient::listAsync()} . * @@ -437,7 +457,10 @@ public function list(ListInstanceGroupsRequest $request, array $callOptions = [] } /** - * Lists the instances in the specified instance group. The orderBy query parameter is not supported. The filter query parameter is supported, but only for expressions that use `eq` (equal) or `ne` (not equal) operators. + * Lists the instances in the specified instance group. + * The orderBy query parameter is not supported. + * The filter query parameter is supported, but only for + * expressions that use `eq` (equal) or `ne` (not equal) operators. * * The async variant is {@see InstanceGroupsClient::listInstancesAsync()} . * @@ -465,7 +488,13 @@ public function listInstances( } /** - * Removes one or more instances from the specified instance group, but does not delete those instances. If the group is part of a backend service that has enabled connection draining, it can take up to 60 seconds after the connection draining duration before the VM instance is removed or deleted. + * Removes one or more instances from the specified instance group, but does + * not delete those instances. + * + * If the group is part of a backend + * service that has enabled + * connection draining, it can take up to 60 seconds after the connection + * draining duration before the VM instance is removed or deleted. * * The async variant is {@see InstanceGroupsClient::removeInstancesAsync()} . * diff --git a/Compute/src/V1/Client/InstanceTemplatesClient.php b/Compute/src/V1/Client/InstanceTemplatesClient.php index 8ba8c864c576..925b6b0282be 100644 --- a/Compute/src/V1/Client/InstanceTemplatesClient.php +++ b/Compute/src/V1/Client/InstanceTemplatesClient.php @@ -276,7 +276,11 @@ public function __call($method, $args) } /** - * Retrieves the list of all InstanceTemplates resources, regional and global, available to the specified project. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. + * Retrieves the list of all InstanceTemplates resources, regional and global, + * available to the specified project. + * + * To prevent failure, Google recommends that you set the + * `returnPartialSuccess` parameter to `true`. * * The async variant is {@see InstanceTemplatesClient::aggregatedListAsync()} . * @@ -304,7 +308,9 @@ public function aggregatedList( } /** - * Deletes the specified instance template. Deleting an instance template is permanent and cannot be undone. It is not possible to delete templates that are already in use by a managed instance group. + * Deletes the specified instance template. Deleting an instance template is + * permanent and cannot be undone. It is not possible to delete templates + * that are already in use by a managed instance group. * * The async variant is {@see InstanceTemplatesClient::deleteAsync()} . * @@ -356,7 +362,8 @@ public function get(GetInstanceTemplateRequest $request, array $callOptions = [] } /** - * Gets the access control policy for a resource. May be empty if no such policy or resource exists. + * Gets the access control policy for a resource. May be empty if no such + * policy or resource exists. * * The async variant is {@see InstanceTemplatesClient::getIamPolicyAsync()} . * @@ -382,7 +389,11 @@ public function getIamPolicy(GetIamPolicyInstanceTemplateRequest $request, array } /** - * Creates an instance template in the specified project using the data that is included in the request. If you are creating a new template to update an existing instance group, your new instance template must use the same network or, if applicable, the same subnetwork as the original template. + * Creates an instance template in the specified project using the + * data that is included in the request. If you are creating a new template to + * update an existing instance group, your new instance template must use the + * same network or, if applicable, the same subnetwork as the original + * template. * * The async variant is {@see InstanceTemplatesClient::insertAsync()} . * @@ -408,7 +419,8 @@ public function insert(InsertInstanceTemplateRequest $request, array $callOption } /** - * Retrieves a list of instance templates that are contained within the specified project. + * Retrieves a list of instance templates that are contained within + * the specified project. * * The async variant is {@see InstanceTemplatesClient::listAsync()} . * @@ -434,7 +446,8 @@ public function list(ListInstanceTemplatesRequest $request, array $callOptions = } /** - * Sets the access control policy on the specified resource. Replaces any existing policy. + * Sets the access control policy on the specified resource. + * Replaces any existing policy. * * The async variant is {@see InstanceTemplatesClient::setIamPolicyAsync()} . * diff --git a/Compute/src/V1/Client/InstancesClient.php b/Compute/src/V1/Client/InstancesClient.php index 0c6d29498bd0..49d06e914459 100644 --- a/Compute/src/V1/Client/InstancesClient.php +++ b/Compute/src/V1/Client/InstancesClient.php @@ -422,7 +422,9 @@ public function addNetworkInterface( } /** - * Adds existing resource policies to an instance. You can only add one policy right now which will be applied to this instance for scheduling live migrations. + * Adds existing resource policies to an instance. You can only add one + * policy right now which will be applied to this instance for scheduling live + * migrations. * * The async variant is {@see InstancesClient::addResourcePoliciesAsync()} . * @@ -450,7 +452,14 @@ public function addResourcePolicies( } /** - * Retrieves an aggregated list of all of the instances in your project across all regions and zones. The performance of this method degrades when a filter is specified on a project that has a very large number of instances. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. + * Retrieves an aggregated list of all of the instances in your project + * across all regions and zones. + * + * The performance of this method degrades when a filter is specified on a + * project that has a very large number of instances. + * + * To prevent failure, Google recommends that you set the + * `returnPartialSuccess` parameter to `true`. * * The async variant is {@see InstancesClient::aggregatedListAsync()} . * @@ -476,7 +485,10 @@ public function aggregatedList(AggregatedListInstancesRequest $request, array $c } /** - * Attaches an existing Disk resource to an instance. You must first create the disk before you can attach it. It is not possible to create and attach a disk at the same time. For more information, read Adding a persistent disk to your instance. + * Attaches an existing Disk resource to an instance. You must first + * create the disk before you can attach it. It is not possible to create + * and attach a disk at the same time. For more information, readAdding a + * persistent disk to your instance. * * The async variant is {@see InstancesClient::attachDiskAsync()} . * @@ -502,7 +514,9 @@ public function attachDisk(AttachDiskInstanceRequest $request, array $callOption } /** - * Creates multiple instances. Count specifies the number of instances to create. For more information, see About bulk creation of VMs. + * Creates multiple instances. Count specifies the number of instances to + * create. For more information, seeAbout bulk + * creation of VMs. * * The async variant is {@see InstancesClient::bulkInsertAsync()} . * @@ -528,7 +542,8 @@ public function bulkInsert(BulkInsertInstanceRequest $request, array $callOption } /** - * Deletes the specified Instance resource. For more information, see Deleting an instance. + * Deletes the specified Instance resource. For more information, seeDeleting + * an instance. * * The async variant is {@see InstancesClient::deleteAsync()} . * @@ -582,7 +597,11 @@ public function deleteAccessConfig( } /** - * Deletes one dynamic network interface from an active instance. InstancesDeleteNetworkInterfaceRequest indicates: - instance from which to delete, using project+zone+resource_id fields; - dynamic network interface to be deleted, using network_interface_name field; + * Deletes one dynamic network interface from an active instance. + * InstancesDeleteNetworkInterfaceRequest indicates: + * - instance from which to delete, using project+zone+resource_id fields; + * - dynamic network interface to be deleted, using network_interface_name + * field; * * The async variant is {@see InstancesClient::deleteNetworkInterfaceAsync()} . * @@ -718,7 +737,8 @@ public function getGuestAttributes( } /** - * Gets the access control policy for a resource. May be empty if no such policy or resource exists. + * Gets the access control policy for a resource. May be empty if no such + * policy or resource exists. * * The async variant is {@see InstancesClient::getIamPolicyAsync()} . * @@ -827,7 +847,8 @@ public function getShieldedInstanceIdentity( } /** - * Creates an instance resource in the specified project using the data included in the request. + * Creates an instance resource in the specified project using the data + * included in the request. * * The async variant is {@see InstancesClient::insertAsync()} . * @@ -853,7 +874,8 @@ public function insert(InsertInstanceRequest $request, array $callOptions = []): } /** - * Retrieves the list of instances contained within the specified zone. + * Retrieves the list of instances contained within + * the specified zone. * * The async variant is {@see InstancesClient::listAsync()} . * @@ -879,7 +901,11 @@ public function list(ListInstancesRequest $request, array $callOptions = []): Pa } /** - * Retrieves a list of resources that refer to the VM instance specified in the request. For example, if the VM instance is part of a managed or unmanaged instance group, the referrers list includes the instance group. For more information, read Viewing referrers to VM instances. + * Retrieves a list of resources that refer to the VM instance specified in + * the request. For example, if the VM instance is part of a managed or + * unmanaged instance group, the referrers list includes the instance group. + * For more information, readViewing + * referrers to VM instances. * * The async variant is {@see InstancesClient::listReferrersAsync()} . * @@ -989,7 +1015,9 @@ public function reportHostAsFaulty( } /** - * Performs a reset on the instance. This is a hard reset. The VM does not do a graceful shutdown. For more information, see Resetting an instance. + * Performs a reset on the instance. This is a hard reset. The VM + * does not do a graceful shutdown. For more information, seeResetting + * an instance. * * The async variant is {@see InstancesClient::resetAsync()} . * @@ -1015,7 +1043,8 @@ public function reset(ResetInstanceRequest $request, array $callOptions = []): O } /** - * Resumes an instance that was suspended using the instances().suspend method. + * Resumes an instance that was suspended using theinstances().suspend + * method. * * The async variant is {@see InstancesClient::resumeAsync()} . * @@ -1125,7 +1154,8 @@ public function setDiskAutoDelete( } /** - * Sets the access control policy on the specified resource. Replaces any existing policy. + * Sets the access control policy on the specified resource. + * Replaces any existing policy. * * The async variant is {@see InstancesClient::setIamPolicyAsync()} . * @@ -1151,7 +1181,8 @@ public function setIamPolicy(SetIamPolicyInstanceRequest $request, array $callOp } /** - * Sets labels on an instance. To learn more about labels, read the Labeling Resources documentation. + * Sets labels on an instance. To learn more about labels, read theLabeling + * Resources documentation. * * The async variant is {@see InstancesClient::setLabelsAsync()} . * @@ -1177,7 +1208,8 @@ public function setLabels(SetLabelsInstanceRequest $request, array $callOptions } /** - * Changes the number and/or type of accelerator for a stopped instance to the values specified in the request. + * Changes the number and/or type of accelerator for a stopped instance to the + * values specified in the request. * * The async variant is {@see InstancesClient::setMachineResourcesAsync()} . * @@ -1205,7 +1237,8 @@ public function setMachineResources( } /** - * Changes the machine type for a stopped instance to the machine type specified in the request. + * Changes the machine type for a stopped instance to the machine + * type specified in the request. * * The async variant is {@see InstancesClient::setMachineTypeAsync()} . * @@ -1231,7 +1264,8 @@ public function setMachineType(SetMachineTypeInstanceRequest $request, array $ca } /** - * Sets metadata for the specified instance to the data included in the request. + * Sets metadata for the specified instance to the data included + * in the request. * * The async variant is {@see InstancesClient::setMetadataAsync()} . * @@ -1257,7 +1291,10 @@ public function setMetadata(SetMetadataInstanceRequest $request, array $callOpti } /** - * Changes the minimum CPU platform that this instance should use. This method can only be called on a stopped instance. For more information, read Specifying a Minimum CPU Platform. + * Changes the minimum CPU platform that this instance should use. + * This method can only + * be called on a stopped instance. For more information, readSpecifying a + * Minimum CPU Platform. * * The async variant is {@see InstancesClient::setMinCpuPlatformAsync()} . * @@ -1311,7 +1348,11 @@ public function setName(SetNameInstanceRequest $request, array $callOptions = [] } /** - * Sets an instance's scheduling options. You can only call this method on a stopped instance, that is, a VM instance that is in a `TERMINATED` state. See Instance Life Cycle for more information on the possible instance states. For more information about setting scheduling options for a VM, see Set VM host maintenance policy. + * Sets an instance's scheduling options. You can only call this method on astopped instance, + * that is, a VM instance that is in a `TERMINATED` state. SeeInstance Life + * Cycle for more information on the possible instance states. + * For more information about setting scheduling options for a VM, seeSet + * VM host maintenance policy. * * The async variant is {@see InstancesClient::setSchedulingAsync()} . * @@ -1337,7 +1378,9 @@ public function setScheduling(SetSchedulingInstanceRequest $request, array $call } /** - * Sets the Google Cloud Armor security policy for the specified instance. For more information, see Google Cloud Armor Overview + * Sets the Google Cloud Armor security policy for the specified instance. + * For more information, seeGoogle + * Cloud Armor Overview * * The async variant is {@see InstancesClient::setSecurityPolicyAsync()} . * @@ -1365,7 +1408,9 @@ public function setSecurityPolicy( } /** - * Sets the service account on the instance. For more information, read Changing the service account and access scopes for an instance. + * Sets the service account on the instance. For more information, + * readChanging + * the service account and access scopes for an instance. * * The async variant is {@see InstancesClient::setServiceAccountAsync()} . * @@ -1393,7 +1438,10 @@ public function setServiceAccount( } /** - * Sets the Shielded Instance integrity policy for an instance. You can only use this method on a running instance. This method supports PATCH semantics and uses the JSON merge patch format and processing rules. + * Sets the Shielded Instance integrity policy for an instance. You can + * only use this method on a running instance. This method + * supports PATCH semantics and uses the JSON merge + * patch format and processing rules. * * The async variant is * {@see InstancesClient::setShieldedInstanceIntegrityPolicyAsync()} . @@ -1422,7 +1470,8 @@ public function setShieldedInstanceIntegrityPolicy( } /** - * Sets network tags for the specified instance to the data included in the request. + * Sets network tags + * for the specified instance to the data included in the request. * * The async variant is {@see InstancesClient::setTagsAsync()} . * @@ -1448,7 +1497,8 @@ public function setTags(SetTagsInstanceRequest $request, array $callOptions = [] } /** - * Simulates a host maintenance event on a VM. For more information, see Simulate a host maintenance event. + * Simulates a host maintenance event on a VM. For more information, see + * Simulate a host maintenance event. * * The async variant is {@see InstancesClient::simulateMaintenanceEventAsync()} . * @@ -1476,7 +1526,9 @@ public function simulateMaintenanceEvent( } /** - * Starts an instance that was stopped using the instances().stop method. For more information, see Restart an instance. + * Starts an instance that was stopped using theinstances().stop + * method. For more information, seeRestart an + * instance. * * The async variant is {@see InstancesClient::startAsync()} . * @@ -1502,7 +1554,9 @@ public function start(StartInstanceRequest $request, array $callOptions = []): O } /** - * Starts an instance that was stopped using the instances().stop method. For more information, see Restart an instance. + * Starts an instance that was stopped using theinstances().stop + * method. For more information, seeRestart an + * instance. * * The async variant is {@see InstancesClient::startWithEncryptionKeyAsync()} . * @@ -1530,7 +1584,12 @@ public function startWithEncryptionKey( } /** - * Stops a running instance, shutting it down cleanly, and allows you to restart the instance at a later time. Stopped instances do not incur VM usage charges while they are stopped. However, resources that the VM is using, such as persistent disks and static IP addresses, will continue to be charged until they are deleted. For more information, see Stopping an instance. + * Stops a running instance, shutting it down cleanly, and allows + * you to restart the instance at a later time. Stopped instances do not incur + * VM usage charges while they are stopped. However, resources that the VM is + * using, such as persistent disks and static IP addresses, will continue to + * be charged until they are deleted. For more information, seeStopping + * an instance. * * The async variant is {@see InstancesClient::stopAsync()} . * @@ -1556,7 +1615,14 @@ public function stop(StopInstanceRequest $request, array $callOptions = []): Ope } /** - * This method suspends a running instance, saving its state to persistent storage, and allows you to resume the instance at a later time. Suspended instances have no compute costs (cores or RAM), and incur only storage charges for the saved VM memory and localSSD data. Any charged resources the virtual machine was using, such as persistent disks and static IP addresses, will continue to be charged while the instance is suspended. For more information, see Suspending and resuming an instance. + * This method suspends a running instance, saving its state to persistent + * storage, and allows you to resume the instance at a later time. Suspended + * instances have no compute costs (cores or RAM), and incur only storage + * charges for the saved VM memory and localSSD data. Any charged resources + * the virtual machine was using, such as persistent disks and static IP + * addresses, will continue to be charged while the instance is suspended. + * For more information, see + * Suspending and resuming an instance. * * The async variant is {@see InstancesClient::suspendAsync()} . * @@ -1610,7 +1676,10 @@ public function testIamPermissions( } /** - * Updates an instance only if the necessary resources are available. This method can update only a specific set of instance properties. See Updating a running instance for a list of updatable instance properties. + * Updates an instance only if the necessary resources are available. This + * method can update only a specific set of instance properties. See + * Updating a running instance for a list of updatable instance + * properties. * * The async variant is {@see InstancesClient::updateAsync()} . * @@ -1636,7 +1705,10 @@ public function update(UpdateInstanceRequest $request, array $callOptions = []): } /** - * Updates the specified access config from an instance's network interface with the data included in the request. This method supports PATCH semantics and uses the JSON merge patch format and processing rules. + * Updates the specified access config from an instance's network interface + * with the data included in the request. This method supportsPATCH + * semantics and uses theJSON merge + * patch format and processing rules. * * The async variant is {@see InstancesClient::updateAccessConfigAsync()} . * @@ -1664,7 +1736,10 @@ public function updateAccessConfig( } /** - * Updates the Display config for a VM instance. You can only use this method on a stopped VM instance. This method supports PATCH semantics and uses the JSON merge patch format and processing rules. + * Updates the Display config for a VM instance. You can + * only use this method on a stopped VM instance. This method supportsPATCH + * semantics and uses theJSON merge + * patch format and processing rules. * * The async variant is {@see InstancesClient::updateDisplayDeviceAsync()} . * @@ -1692,7 +1767,12 @@ public function updateDisplayDevice( } /** - * Updates an instance's network interface. This method can only update an interface's alias IP range and attached network. See Modifying alias IP ranges for an existing instance for instructions on changing alias IP ranges. See Migrating a VM between networks for instructions on migrating an interface. This method follows PATCH semantics. + * Updates an instance's network interface. This method can only update an + * interface's alias IP range and attached network. See Modifying + * alias IP ranges for an existing instance for instructions on + * changing alias IP ranges. See Migrating + * a VM between networks for instructions on migrating an interface. + * This method follows PATCH semantics. * * The async variant is {@see InstancesClient::updateNetworkInterfaceAsync()} . * @@ -1720,7 +1800,10 @@ public function updateNetworkInterface( } /** - * Updates the Shielded Instance config for an instance. You can only use this method on a stopped instance. This method supports PATCH semantics and uses the JSON merge patch format and processing rules. + * Updates the Shielded Instance config for an instance. You can + * only use this method on a stopped instance. This method supportsPATCH + * semantics and uses theJSON merge + * patch format and processing rules. * * The async variant is {@see InstancesClient::updateShieldedInstanceConfigAsync()} * . diff --git a/Compute/src/V1/Client/InstantSnapshotsClient.php b/Compute/src/V1/Client/InstantSnapshotsClient.php index 1147b13a6dd5..53843e7db167 100644 --- a/Compute/src/V1/Client/InstantSnapshotsClient.php +++ b/Compute/src/V1/Client/InstantSnapshotsClient.php @@ -278,7 +278,10 @@ public function __call($method, $args) } /** - * Retrieves an aggregated list of instantSnapshots. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. + * Retrieves an aggregated list of instantSnapshots. + * + * To prevent failure, Google recommends that you set the + * `returnPartialSuccess` parameter to `true`. * * The async variant is {@see InstantSnapshotsClient::aggregatedListAsync()} . * @@ -306,7 +309,14 @@ public function aggregatedList( } /** - * Deletes the specified InstantSnapshot resource. Keep in mind that deleting a single instantSnapshot might not necessarily delete all the data on that instantSnapshot. If any data on the instantSnapshot that is marked for deletion is needed for subsequent instantSnapshots, the data will be moved to the next corresponding instantSnapshot. For more information, see Deleting instantSnapshots. + * Deletes the specified InstantSnapshot resource. Keep in mind that deleting + * a single instantSnapshot might not necessarily delete all the data on that + * instantSnapshot. If any data on the instantSnapshot that is marked for + * deletion is needed for subsequent instantSnapshots, the data will be moved + * to the next corresponding instantSnapshot. + * + * For more information, seeDeleting + * instantSnapshots. * * The async variant is {@see InstantSnapshotsClient::deleteAsync()} . * @@ -358,7 +368,8 @@ public function get(GetInstantSnapshotRequest $request, array $callOptions = []) } /** - * Gets the access control policy for a resource. May be empty if no such policy or resource exists. + * Gets the access control policy for a resource. May be empty if no such + * policy or resource exists. * * The async variant is {@see InstantSnapshotsClient::getIamPolicyAsync()} . * @@ -410,7 +421,8 @@ public function insert(InsertInstantSnapshotRequest $request, array $callOptions } /** - * Retrieves the list of InstantSnapshot resources contained within the specified zone. + * Retrieves the list of InstantSnapshot resources contained within + * the specified zone. * * The async variant is {@see InstantSnapshotsClient::listAsync()} . * @@ -436,7 +448,8 @@ public function list(ListInstantSnapshotsRequest $request, array $callOptions = } /** - * Sets the access control policy on the specified resource. Replaces any existing policy. + * Sets the access control policy on the specified resource. + * Replaces any existing policy. * * The async variant is {@see InstantSnapshotsClient::setIamPolicyAsync()} . * @@ -462,7 +475,9 @@ public function setIamPolicy(SetIamPolicyInstantSnapshotRequest $request, array } /** - * Sets the labels on a instantSnapshot in the given zone. To learn more about labels, read the Labeling Resources documentation. + * Sets the labels on a instantSnapshot in the given zone. To learn more about + * labels, read the Labeling + * Resources documentation. * * The async variant is {@see InstantSnapshotsClient::setLabelsAsync()} . * diff --git a/Compute/src/V1/Client/InterconnectAttachmentGroupsClient.php b/Compute/src/V1/Client/InterconnectAttachmentGroupsClient.php index ff0458ff7e80..f4b1cdb3d83f 100644 --- a/Compute/src/V1/Client/InterconnectAttachmentGroupsClient.php +++ b/Compute/src/V1/Client/InterconnectAttachmentGroupsClient.php @@ -308,7 +308,8 @@ public function delete( } /** - * Returns the specified InterconnectAttachmentGroup resource in the given scope. + * Returns the specified InterconnectAttachmentGroup resource in the given + * scope. * * The async variant is {@see InterconnectAttachmentGroupsClient::getAsync()} . * @@ -336,7 +337,8 @@ public function get( } /** - * Gets the access control policy for a resource. May be empty if no such policy or resource exists. + * Gets the access control policy for a resource. May be empty if no such + * policy or resource exists. * * The async variant is * {@see InterconnectAttachmentGroupsClient::getIamPolicyAsync()} . @@ -365,7 +367,8 @@ public function getIamPolicy( } /** - * Returns the InterconnectAttachmentStatuses for the specified InterconnectAttachmentGroup resource. + * Returns the InterconnectAttachmentStatuses for the specified + * InterconnectAttachmentGroup resource. * * The async variant is * {@see InterconnectAttachmentGroupsClient::getOperationalStatusAsync()} . @@ -394,7 +397,8 @@ public function getOperationalStatus( } /** - * Creates a InterconnectAttachmentGroup in the specified project in the given scope using the parameters that are included in the request. + * Creates a InterconnectAttachmentGroup in the specified project in the given + * scope using the parameters that are included in the request. * * The async variant is {@see InterconnectAttachmentGroupsClient::insertAsync()} . * @@ -448,7 +452,10 @@ public function list(ListInterconnectAttachmentGroupsRequest $request, array $ca } /** - * Patches the specified InterconnectAttachmentGroup resource with the data included in the request. This method supports PATCH semantics and uses JSON merge patch format and processing rules. + * Patches the specified InterconnectAttachmentGroup resource with the data + * included in the request. This method supports PATCH + * semantics and usesJSON merge + * patch format and processing rules. * * The async variant is {@see InterconnectAttachmentGroupsClient::patchAsync()} . * @@ -474,7 +481,8 @@ public function patch(PatchInterconnectAttachmentGroupRequest $request, array $c } /** - * Sets the access control policy on the specified resource. Replaces any existing policy. + * Sets the access control policy on the specified resource. + * Replaces any existing policy. * * The async variant is * {@see InterconnectAttachmentGroupsClient::setIamPolicyAsync()} . diff --git a/Compute/src/V1/Client/InterconnectAttachmentsClient.php b/Compute/src/V1/Client/InterconnectAttachmentsClient.php index 77c21f3a5992..af534786efaa 100644 --- a/Compute/src/V1/Client/InterconnectAttachmentsClient.php +++ b/Compute/src/V1/Client/InterconnectAttachmentsClient.php @@ -272,7 +272,10 @@ public function __call($method, $args) } /** - * Retrieves an aggregated list of interconnect attachments. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. + * Retrieves an aggregated list of interconnect attachments. + * + * To prevent failure, Google recommends that you set the + * `returnPartialSuccess` parameter to `true`. * * The async variant is {@see InterconnectAttachmentsClient::aggregatedListAsync()} * . @@ -353,7 +356,8 @@ public function get(GetInterconnectAttachmentRequest $request, array $callOption } /** - * Creates an InterconnectAttachment in the specified project using the data included in the request. + * Creates an InterconnectAttachment in the specified project using the data + * included in the request. * * The async variant is {@see InterconnectAttachmentsClient::insertAsync()} . * @@ -379,7 +383,8 @@ public function insert(InsertInterconnectAttachmentRequest $request, array $call } /** - * Retrieves the list of interconnect attachments contained within the specified region. + * Retrieves the list of interconnect attachments contained within + * the specified region. * * The async variant is {@see InterconnectAttachmentsClient::listAsync()} . * @@ -405,7 +410,10 @@ public function list(ListInterconnectAttachmentsRequest $request, array $callOpt } /** - * Updates the specified interconnect attachment with the data included in the request. This method supports PATCH semantics and uses the JSON merge patch format and processing rules. + * Updates the specified interconnect attachment with the data included in the + * request. This method supportsPATCH + * semantics and uses theJSON merge + * patch format and processing rules. * * The async variant is {@see InterconnectAttachmentsClient::patchAsync()} . * @@ -431,7 +439,9 @@ public function patch(PatchInterconnectAttachmentRequest $request, array $callOp } /** - * Sets the labels on an InterconnectAttachment. To learn more about labels, read the Labeling Resources documentation. + * Sets the labels on an InterconnectAttachment. To learn more about labels, + * read the Labeling + * Resources documentation. * * The async variant is {@see InterconnectAttachmentsClient::setLabelsAsync()} . * diff --git a/Compute/src/V1/Client/InterconnectGroupsClient.php b/Compute/src/V1/Client/InterconnectGroupsClient.php index cedfc49f0878..ad2ffd70624f 100644 --- a/Compute/src/V1/Client/InterconnectGroupsClient.php +++ b/Compute/src/V1/Client/InterconnectGroupsClient.php @@ -281,7 +281,8 @@ public function __call($method, $args) } /** - * Create Interconnects with redundancy by creating them in a specified interconnect group. + * Create Interconnects with redundancy by creating them in a specified + * interconnect group. * * The async variant is {@see InterconnectGroupsClient::createMembersAsync()} . * @@ -361,7 +362,8 @@ public function get(GetInterconnectGroupRequest $request, array $callOptions = [ } /** - * Gets the access control policy for a resource. May be empty if no such policy or resource exists. + * Gets the access control policy for a resource. May be empty if no such + * policy or resource exists. * * The async variant is {@see InterconnectGroupsClient::getIamPolicyAsync()} . * @@ -387,7 +389,8 @@ public function getIamPolicy(GetIamPolicyInterconnectGroupRequest $request, arra } /** - * Returns the interconnectStatuses for the specified InterconnectGroup. + * Returns the interconnectStatuses for the specified + * InterconnectGroup. * * The async variant is * {@see InterconnectGroupsClient::getOperationalStatusAsync()} . @@ -416,7 +419,8 @@ public function getOperationalStatus( } /** - * Creates a InterconnectGroup in the specified project in the given scope using the parameters that are included in the request. + * Creates a InterconnectGroup in the specified project in the given scope + * using the parameters that are included in the request. * * The async variant is {@see InterconnectGroupsClient::insertAsync()} . * @@ -468,7 +472,10 @@ public function list(ListInterconnectGroupsRequest $request, array $callOptions } /** - * Patches the specified InterconnectGroup resource with the data included in the request. This method supports PATCH semantics and uses JSON merge patch format and processing rules. + * Patches the specified InterconnectGroup resource with the data included in + * the request. This method supports PATCH + * semantics and usesJSON merge + * patch format and processing rules. * * The async variant is {@see InterconnectGroupsClient::patchAsync()} . * @@ -494,7 +501,8 @@ public function patch(PatchInterconnectGroupRequest $request, array $callOptions } /** - * Sets the access control policy on the specified resource. Replaces any existing policy. + * Sets the access control policy on the specified resource. + * Replaces any existing policy. * * The async variant is {@see InterconnectGroupsClient::setIamPolicyAsync()} . * diff --git a/Compute/src/V1/Client/InterconnectLocationsClient.php b/Compute/src/V1/Client/InterconnectLocationsClient.php index 279e05b8473d..4208d854473e 100644 --- a/Compute/src/V1/Client/InterconnectLocationsClient.php +++ b/Compute/src/V1/Client/InterconnectLocationsClient.php @@ -192,7 +192,8 @@ public function __call($method, $args) } /** - * Returns the details for the specified interconnect location. Gets a list of available interconnect locations by making a list() request. + * Returns the details for the specified interconnect location. Gets a list of + * available interconnect locations by making a list() request. * * The async variant is {@see InterconnectLocationsClient::getAsync()} . * @@ -218,7 +219,8 @@ public function get(GetInterconnectLocationRequest $request, array $callOptions } /** - * Retrieves the list of interconnect locations available to the specified project. + * Retrieves the list of interconnect locations available to the specified + * project. * * The async variant is {@see InterconnectLocationsClient::listAsync()} . * diff --git a/Compute/src/V1/Client/InterconnectRemoteLocationsClient.php b/Compute/src/V1/Client/InterconnectRemoteLocationsClient.php index 4f68474a9dba..6e9e5a28c659 100644 --- a/Compute/src/V1/Client/InterconnectRemoteLocationsClient.php +++ b/Compute/src/V1/Client/InterconnectRemoteLocationsClient.php @@ -193,7 +193,8 @@ public function __call($method, $args) } /** - * Returns the details for the specified interconnect remote location. Gets a list of available interconnect remote locations by making a list() request. + * Returns the details for the specified interconnect remote location. Gets a + * list of available interconnect remote locations by making alist() request. * * The async variant is {@see InterconnectRemoteLocationsClient::getAsync()} . * @@ -221,7 +222,8 @@ public function get( } /** - * Retrieves the list of interconnect remote locations available to the specified project. + * Retrieves the list of interconnect remote locations available to the + * specified project. * * The async variant is {@see InterconnectRemoteLocationsClient::listAsync()} . * diff --git a/Compute/src/V1/Client/InterconnectsClient.php b/Compute/src/V1/Client/InterconnectsClient.php index cc3e6891716f..1a39a06cb815 100644 --- a/Compute/src/V1/Client/InterconnectsClient.php +++ b/Compute/src/V1/Client/InterconnectsClient.php @@ -302,7 +302,8 @@ public function delete(DeleteInterconnectRequest $request, array $callOptions = } /** - * Returns the specified Interconnect. Get a list of available Interconnects by making a list() request. + * Returns the specified Interconnect. Get a list of available Interconnects + * by making a list() request. * * The async variant is {@see InterconnectsClient::getAsync()} . * @@ -328,7 +329,16 @@ public function get(GetInterconnectRequest $request, array $callOptions = []): I } /** - * Returns the interconnectDiagnostics for the specified Interconnect. In the event of a global outage, do not use this API to make decisions about where to redirect your network traffic. Unlike a VLAN attachment, which is regional, a Cloud Interconnect connection is a global resource. A global outage can prevent this API from functioning properly. + * Returns the interconnectDiagnostics for the specified + * Interconnect. + * + * In the event of a + * global outage, do not use this API to make decisions about where to + * redirect your network traffic. + * + * Unlike a VLAN attachment, which is regional, a Cloud Interconnect + * connection is a global resource. A global outage can prevent this + * API from functioning properly. * * The async variant is {@see InterconnectsClient::getDiagnosticsAsync()} . * @@ -356,7 +366,8 @@ public function getDiagnostics( } /** - * Returns the interconnectMacsecConfig for the specified Interconnect. + * Returns the interconnectMacsecConfig for the specified + * Interconnect. * * The async variant is {@see InterconnectsClient::getMacsecConfigAsync()} . * @@ -384,7 +395,8 @@ public function getMacsecConfig( } /** - * Creates an Interconnect in the specified project using the data included in the request. + * Creates an Interconnect in the specified project using + * the data included in the request. * * The async variant is {@see InterconnectsClient::insertAsync()} . * @@ -436,7 +448,10 @@ public function list(ListInterconnectsRequest $request, array $callOptions = []) } /** - * Updates the specified Interconnect with the data included in the request. This method supports PATCH semantics and uses the JSON merge patch format and processing rules. + * Updates the specified Interconnect with the data included in the request. + * This method supportsPATCH + * semantics and uses theJSON merge + * patch format and processing rules. * * The async variant is {@see InterconnectsClient::patchAsync()} . * @@ -462,7 +477,9 @@ public function patch(PatchInterconnectRequest $request, array $callOptions = [] } /** - * Sets the labels on an Interconnect. To learn more about labels, read the Labeling Resources documentation. + * Sets the labels on an Interconnect. To learn more about labels, + * read the Labeling + * Resources documentation. * * The async variant is {@see InterconnectsClient::setLabelsAsync()} . * diff --git a/Compute/src/V1/Client/LicenseCodesClient.php b/Compute/src/V1/Client/LicenseCodesClient.php index cbe3653b1ff4..90576d9e8bb0 100644 --- a/Compute/src/V1/Client/LicenseCodesClient.php +++ b/Compute/src/V1/Client/LicenseCodesClient.php @@ -192,7 +192,11 @@ public function __call($method, $args) } /** - * Return a specified license code. License codes are mirrored across all projects that have permissions to read the License Code. *Caution* This resource is intended for use only by third-party partners who are creating Cloud Marketplace images. + * Return a specified license code. License codes are mirrored across + * all projects that have permissions to read the License Code. + * *Caution* This resource is intended + * for use only by third-party partners who are creatingCloud Marketplace + * images. * * The async variant is {@see LicenseCodesClient::getAsync()} . * @@ -218,7 +222,10 @@ public function get(GetLicenseCodeRequest $request, array $callOptions = []): Li } /** - * Returns permissions that a caller has on the specified resource. *Caution* This resource is intended for use only by third-party partners who are creating Cloud Marketplace images. + * Returns permissions that a caller has on the specified resource. + * *Caution* This resource is intended + * for use only by third-party partners who are creatingCloud Marketplace + * images. * * The async variant is {@see LicenseCodesClient::testIamPermissionsAsync()} . * diff --git a/Compute/src/V1/Client/LicensesClient.php b/Compute/src/V1/Client/LicensesClient.php index 2d3f6dbd291b..0852d714ed5b 100644 --- a/Compute/src/V1/Client/LicensesClient.php +++ b/Compute/src/V1/Client/LicensesClient.php @@ -276,7 +276,10 @@ public function __call($method, $args) } /** - * Deletes the specified license. *Caution* This resource is intended for use only by third-party partners who are creating Cloud Marketplace images. + * Deletes the specified license. + * *Caution* This resource is intended + * for use only by third-party partners who are creatingCloud Marketplace + * images. * * The async variant is {@see LicensesClient::deleteAsync()} . * @@ -302,7 +305,10 @@ public function delete(DeleteLicenseRequest $request, array $callOptions = []): } /** - * Returns the specified License resource. *Caution* This resource is intended for use only by third-party partners who are creating Cloud Marketplace images. + * Returns the specified License resource. + * *Caution* This resource is intended + * for use only by third-party partners who are creatingCloud Marketplace + * images. * * The async variant is {@see LicensesClient::getAsync()} . * @@ -328,7 +334,11 @@ public function get(GetLicenseRequest $request, array $callOptions = []): Licens } /** - * Gets the access control policy for a resource. May be empty if no such policy or resource exists. *Caution* This resource is intended for use only by third-party partners who are creating Cloud Marketplace images. + * Gets the access control policy for a resource. May be empty if no such + * policy or resource exists. + * *Caution* This resource is intended + * for use only by third-party partners who are creatingCloud Marketplace + * images. * * The async variant is {@see LicensesClient::getIamPolicyAsync()} . * @@ -354,7 +364,10 @@ public function getIamPolicy(GetIamPolicyLicenseRequest $request, array $callOpt } /** - * Create a License resource in the specified project. *Caution* This resource is intended for use only by third-party partners who are creating Cloud Marketplace images. + * Create a License resource in the specified project. + * *Caution* This resource is intended + * for use only by third-party partners who are creatingCloud Marketplace + * images. * * The async variant is {@see LicensesClient::insertAsync()} . * @@ -380,7 +393,15 @@ public function insert(InsertLicenseRequest $request, array $callOptions = []): } /** - * Retrieves the list of licenses available in the specified project. This method does not get any licenses that belong to other projects, including licenses attached to publicly-available images, like Debian 9. If you want to get a list of publicly-available licenses, use this method to make a request to the respective image project, such as debian-cloud or windows-cloud. *Caution* This resource is intended for use only by third-party partners who are creating Cloud Marketplace images. + * Retrieves the list of licenses + * available in the specified project. This method does not + * get any licenses that belong to other projects, including licenses attached + * to publicly-available images, like Debian 9. If you want to get a list of + * publicly-available licenses, use this method to make a request to the + * respective image project, such as debian-cloud orwindows-cloud. + * *Caution* This resource is intended + * for use only by third-party partners who are creatingCloud Marketplace + * images. * * The async variant is {@see LicensesClient::listAsync()} . * @@ -406,7 +427,11 @@ public function list(ListLicensesRequest $request, array $callOptions = []): Pag } /** - * Sets the access control policy on the specified resource. Replaces any existing policy. *Caution* This resource is intended for use only by third-party partners who are creating Cloud Marketplace images. + * Sets the access control policy on the specified resource. + * Replaces any existing policy. + * *Caution* This resource is intended + * for use only by third-party partners who are creatingCloud Marketplace + * images. * * The async variant is {@see LicensesClient::setIamPolicyAsync()} . * @@ -432,7 +457,10 @@ public function setIamPolicy(SetIamPolicyLicenseRequest $request, array $callOpt } /** - * Returns permissions that a caller has on the specified resource. *Caution* This resource is intended for use only by third-party partners who are creating Cloud Marketplace images. + * Returns permissions that a caller has on the specified resource. + * *Caution* This resource is intended + * for use only by third-party partners who are creatingCloud Marketplace + * images. * * The async variant is {@see LicensesClient::testIamPermissionsAsync()} . * @@ -460,7 +488,10 @@ public function testIamPermissions( } /** - * Updates a License resource in the specified project. *Caution* This resource is intended for use only by third-party partners who are creating Cloud Marketplace images. + * Updates a License resource in the specified project. + * *Caution* This resource is intended + * for use only by third-party partners who are creatingCloud Marketplace + * images. * * The async variant is {@see LicensesClient::updateAsync()} . * diff --git a/Compute/src/V1/Client/MachineImagesClient.php b/Compute/src/V1/Client/MachineImagesClient.php index 3de533ab3d65..3226c0ac3d70 100644 --- a/Compute/src/V1/Client/MachineImagesClient.php +++ b/Compute/src/V1/Client/MachineImagesClient.php @@ -276,7 +276,8 @@ public function __call($method, $args) } /** - * Deletes the specified machine image. Deleting a machine image is permanent and cannot be undone. + * Deletes the specified machine image. Deleting a machine image is permanent + * and cannot be undone. * * The async variant is {@see MachineImagesClient::deleteAsync()} . * @@ -328,7 +329,8 @@ public function get(GetMachineImageRequest $request, array $callOptions = []): M } /** - * Gets the access control policy for a resource. May be empty if no such policy or resource exists. + * Gets the access control policy for a resource. May be empty if no such + * policy or resource exists. * * The async variant is {@see MachineImagesClient::getIamPolicyAsync()} . * @@ -354,7 +356,11 @@ public function getIamPolicy(GetIamPolicyMachineImageRequest $request, array $ca } /** - * Creates a machine image in the specified project using the data that is included in the request. If you are creating a new machine image to update an existing instance, your new machine image should use the same network or, if applicable, the same subnetwork as the original instance. + * Creates a machine image in the specified project using the + * data that is included in the request. If you are creating a new machine + * image to update an existing instance, your new machine image should use the + * same network or, if applicable, the same subnetwork as the original + * instance. * * The async variant is {@see MachineImagesClient::insertAsync()} . * @@ -380,7 +386,8 @@ public function insert(InsertMachineImageRequest $request, array $callOptions = } /** - * Retrieves a list of machine images that are contained within the specified project. + * Retrieves a list of machine images that are contained within + * the specified project. * * The async variant is {@see MachineImagesClient::listAsync()} . * @@ -406,7 +413,8 @@ public function list(ListMachineImagesRequest $request, array $callOptions = []) } /** - * Sets the access control policy on the specified resource. Replaces any existing policy. + * Sets the access control policy on the specified resource. + * Replaces any existing policy. * * The async variant is {@see MachineImagesClient::setIamPolicyAsync()} . * @@ -432,7 +440,8 @@ public function setIamPolicy(SetIamPolicyMachineImageRequest $request, array $ca } /** - * Sets the labels on a machine image. To learn more about labels, read the Labeling Resources documentation. + * Sets the labels on a machine image. To learn more about labels, read theLabeling + * Resources documentation. * * The async variant is {@see MachineImagesClient::setLabelsAsync()} . * diff --git a/Compute/src/V1/Client/MachineTypesClient.php b/Compute/src/V1/Client/MachineTypesClient.php index cb2a09cb5ae1..ccda8b09c1d3 100644 --- a/Compute/src/V1/Client/MachineTypesClient.php +++ b/Compute/src/V1/Client/MachineTypesClient.php @@ -194,7 +194,10 @@ public function __call($method, $args) } /** - * Retrieves an aggregated list of machine types. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. + * Retrieves an aggregated list of machine types. + * + * To prevent failure, Google recommends that you set the + * `returnPartialSuccess` parameter to `true`. * * The async variant is {@see MachineTypesClient::aggregatedListAsync()} . * @@ -248,7 +251,8 @@ public function get(GetMachineTypeRequest $request, array $callOptions = []): Ma } /** - * Retrieves a list of machine types available to the specified project. + * Retrieves a list of machine types available to the specified + * project. * * The async variant is {@see MachineTypesClient::listAsync()} . * diff --git a/Compute/src/V1/Client/NetworkAttachmentsClient.php b/Compute/src/V1/Client/NetworkAttachmentsClient.php index 17dfcdcd20a2..66993dc66e74 100644 --- a/Compute/src/V1/Client/NetworkAttachmentsClient.php +++ b/Compute/src/V1/Client/NetworkAttachmentsClient.php @@ -278,7 +278,11 @@ public function __call($method, $args) } /** - * Retrieves the list of all NetworkAttachment resources, regional and global, available to the specified project. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. + * Retrieves the list of all NetworkAttachment resources, + * regional and global, available to the specified project. + * + * To prevent failure, Google recommends that you set the + * `returnPartialSuccess` parameter to `true`. * * The async variant is {@see NetworkAttachmentsClient::aggregatedListAsync()} . * @@ -358,7 +362,8 @@ public function get(GetNetworkAttachmentRequest $request, array $callOptions = [ } /** - * Gets the access control policy for a resource. May be empty if no such policy or resource exists. + * Gets the access control policy for a resource. May be empty if no such + * policy or resource exists. * * The async variant is {@see NetworkAttachmentsClient::getIamPolicyAsync()} . * @@ -384,7 +389,8 @@ public function getIamPolicy(GetIamPolicyNetworkAttachmentRequest $request, arra } /** - * Creates a NetworkAttachment in the specified project in the given scope using the parameters that are included in the request. + * Creates a NetworkAttachment in the specified project in the given scope + * using the parameters that are included in the request. * * The async variant is {@see NetworkAttachmentsClient::insertAsync()} . * @@ -436,7 +442,10 @@ public function list(ListNetworkAttachmentsRequest $request, array $callOptions } /** - * Patches the specified NetworkAttachment resource with the data included in the request. This method supports PATCH semantics and uses JSON merge patch format and processing rules. + * Patches the specified NetworkAttachment resource with the data included in + * the request. This method supports PATCH + * semantics and usesJSON merge + * patch format and processing rules. * * The async variant is {@see NetworkAttachmentsClient::patchAsync()} . * @@ -462,7 +471,8 @@ public function patch(PatchNetworkAttachmentRequest $request, array $callOptions } /** - * Sets the access control policy on the specified resource. Replaces any existing policy. + * Sets the access control policy on the specified resource. + * Replaces any existing policy. * * The async variant is {@see NetworkAttachmentsClient::setIamPolicyAsync()} . * diff --git a/Compute/src/V1/Client/NetworkEdgeSecurityServicesClient.php b/Compute/src/V1/Client/NetworkEdgeSecurityServicesClient.php index bccb95688a89..46cc03f28d95 100644 --- a/Compute/src/V1/Client/NetworkEdgeSecurityServicesClient.php +++ b/Compute/src/V1/Client/NetworkEdgeSecurityServicesClient.php @@ -269,7 +269,11 @@ public function __call($method, $args) } /** - * Retrieves the list of all NetworkEdgeSecurityService resources available to the specified project. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. + * Retrieves the list of all NetworkEdgeSecurityService resources available to + * the specified project. + * + * To prevent failure, Google recommends that you set the + * `returnPartialSuccess` parameter to `true`. * * The async variant is * {@see NetworkEdgeSecurityServicesClient::aggregatedListAsync()} . @@ -352,7 +356,8 @@ public function get( } /** - * Creates a new service in the specified project using the data included in the request. + * Creates a new service in the specified project using the data included in + * the request. * * The async variant is {@see NetworkEdgeSecurityServicesClient::insertAsync()} . * diff --git a/Compute/src/V1/Client/NetworkEndpointGroupsClient.php b/Compute/src/V1/Client/NetworkEndpointGroupsClient.php index 221b0ff975dd..a88db2b4f2d8 100644 --- a/Compute/src/V1/Client/NetworkEndpointGroupsClient.php +++ b/Compute/src/V1/Client/NetworkEndpointGroupsClient.php @@ -277,7 +277,10 @@ public function __call($method, $args) } /** - * Retrieves the list of network endpoint groups and sorts them by zone. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. + * Retrieves the list of network endpoint groups and sorts them by zone. + * + * To prevent failure, Google recommends that you set the + * `returnPartialSuccess` parameter to `true`. * * The async variant is {@see NetworkEndpointGroupsClient::aggregatedListAsync()} . * @@ -334,7 +337,10 @@ public function attachNetworkEndpoints( } /** - * Deletes the specified network endpoint group. The network endpoints in the NEG and the VM instances they belong to are not terminated when the NEG is deleted. Note that the NEG cannot be deleted if there are backend services referencing it. + * Deletes the specified network endpoint group. The network endpoints in the + * NEG and the VM instances they belong to are not terminated when the NEG is + * deleted. Note that the NEG cannot be deleted if there are backend services + * referencing it. * * The async variant is {@see NetworkEndpointGroupsClient::deleteAsync()} . * @@ -360,7 +366,8 @@ public function delete(DeleteNetworkEndpointGroupRequest $request, array $callOp } /** - * Detach a list of network endpoints from the specified network endpoint group. + * Detach a list of network endpoints from the specified network endpoint + * group. * * The async variant is * {@see NetworkEndpointGroupsClient::detachNetworkEndpointsAsync()} . @@ -415,7 +422,8 @@ public function get(GetNetworkEndpointGroupRequest $request, array $callOptions } /** - * Creates a network endpoint group in the specified project using the parameters that are included in the request. + * Creates a network endpoint group in the specified project using the + * parameters that are included in the request. * * The async variant is {@see NetworkEndpointGroupsClient::insertAsync()} . * @@ -441,7 +449,8 @@ public function insert(InsertNetworkEndpointGroupRequest $request, array $callOp } /** - * Retrieves the list of network endpoint groups that are located in the specified project and zone. + * Retrieves the list of network endpoint groups that are located in the + * specified project and zone. * * The async variant is {@see NetworkEndpointGroupsClient::listAsync()} . * diff --git a/Compute/src/V1/Client/NetworkFirewallPoliciesClient.php b/Compute/src/V1/Client/NetworkFirewallPoliciesClient.php index 629db6f4b92c..b485d67f47a4 100644 --- a/Compute/src/V1/Client/NetworkFirewallPoliciesClient.php +++ b/Compute/src/V1/Client/NetworkFirewallPoliciesClient.php @@ -389,7 +389,12 @@ public function addRule(AddRuleNetworkFirewallPolicyRequest $request, array $cal } /** - * Retrieves an aggregated list of network firewall policies, listing network firewall policies from all applicable scopes (global and regional) and grouping the results per scope. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. + * Retrieves an aggregated list of network firewall policies, listing network + * firewall policies from all applicable scopes (global and regional) and + * grouping the results per scope. + * + * To prevent failure, it is recommended that you set the + * `returnPartialSuccess` parameter to `true`. * * The async variant is {@see NetworkFirewallPoliciesClient::aggregatedListAsync()} * . @@ -527,7 +532,8 @@ public function getAssociation( } /** - * Gets the access control policy for a resource. May be empty if no such policy or resource exists. + * Gets the access control policy for a resource. May be empty if no such + * policy or resource exists. * * The async variant is {@see NetworkFirewallPoliciesClient::getIamPolicyAsync()} . * @@ -608,7 +614,8 @@ public function getRule(GetRuleNetworkFirewallPolicyRequest $request, array $cal } /** - * Creates a new policy in the specified project using the data included in the request. + * Creates a new policy in the specified project using the data included in + * the request. * * The async variant is {@see NetworkFirewallPoliciesClient::insertAsync()} . * @@ -829,7 +836,8 @@ public function removeRule( } /** - * Sets the access control policy on the specified resource. Replaces any existing policy. + * Sets the access control policy on the specified resource. + * Replaces any existing policy. * * The async variant is {@see NetworkFirewallPoliciesClient::setIamPolicyAsync()} . * diff --git a/Compute/src/V1/Client/NetworkProfilesClient.php b/Compute/src/V1/Client/NetworkProfilesClient.php index 388181b57075..4cb2764938cf 100644 --- a/Compute/src/V1/Client/NetworkProfilesClient.php +++ b/Compute/src/V1/Client/NetworkProfilesClient.php @@ -218,7 +218,8 @@ public function get(GetNetworkProfileRequest $request, array $callOptions = []): } /** - * Retrieves a list of network profiles available to the specified project. + * Retrieves a list of network profiles available to the specified + * project. * * The async variant is {@see NetworkProfilesClient::listAsync()} . * diff --git a/Compute/src/V1/Client/NetworksClient.php b/Compute/src/V1/Client/NetworksClient.php index dbc7254148de..90353a74484f 100644 --- a/Compute/src/V1/Client/NetworksClient.php +++ b/Compute/src/V1/Client/NetworksClient.php @@ -389,7 +389,8 @@ public function getEffectiveFirewalls( } /** - * Creates a network in the specified project using the data included in the request. + * Creates a network in the specified project using the data included + * in the request. * * The async variant is {@see NetworksClient::insertAsync()} . * @@ -469,7 +470,8 @@ public function listPeeringRoutes( } /** - * Patches the specified network with the data included in the request. Only routingConfig can be modified. + * Patches the specified network with the data included in the request. + * Only routingConfig can be modified. * * The async variant is {@see NetworksClient::patchAsync()} . * @@ -521,7 +523,8 @@ public function removePeering(RemovePeeringNetworkRequest $request, array $callO } /** - * Requests to remove a peering from the specified network. Applicable only for PeeringConnection with update_strategy=CONSENSUS. + * Requests to remove a peering from the specified network. Applicable only + * for PeeringConnection with update_strategy=CONSENSUS. * * The async variant is {@see NetworksClient::requestRemovePeeringAsync()} . * @@ -577,7 +580,9 @@ public function switchToCustomMode( } /** - * Updates the specified network peering with the data included in the request. You can only modify the NetworkPeering.export_custom_routes field and the NetworkPeering.import_custom_routes field. + * Updates the specified network peering with the data included in the + * request. You can only modify the NetworkPeering.export_custom_routes field + * and the NetworkPeering.import_custom_routes field. * * The async variant is {@see NetworksClient::updatePeeringAsync()} . * diff --git a/Compute/src/V1/Client/NodeGroupsClient.php b/Compute/src/V1/Client/NodeGroupsClient.php index 40e4ac91f80f..03604b4e1723 100644 --- a/Compute/src/V1/Client/NodeGroupsClient.php +++ b/Compute/src/V1/Client/NodeGroupsClient.php @@ -316,7 +316,11 @@ public function addNodes(AddNodesNodeGroupRequest $request, array $callOptions = } /** - * Retrieves an aggregated list of node groups. Note: use nodeGroups.listNodes for more details about each group. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. + * Retrieves an aggregated list of node groups. + * Note: use nodeGroups.listNodes for more details about each group. + * + * To prevent failure, Google recommends that you set the + * `returnPartialSuccess` parameter to `true`. * * The async variant is {@see NodeGroupsClient::aggregatedListAsync()} . * @@ -394,7 +398,10 @@ public function deleteNodes(DeleteNodesNodeGroupRequest $request, array $callOpt } /** - * Returns the specified NodeGroup. Get a list of available NodeGroups by making a list() request. Note: the "nodes" field should not be used. Use nodeGroups.listNodes instead. + * Returns the specified NodeGroup. Get a list of available NodeGroups + * by making a list() request. + * Note: the "nodes" field should not be used. Use nodeGroups.listNodes + * instead. * * The async variant is {@see NodeGroupsClient::getAsync()} . * @@ -420,7 +427,8 @@ public function get(GetNodeGroupRequest $request, array $callOptions = []): Node } /** - * Gets the access control policy for a resource. May be empty if no such policy or resource exists. + * Gets the access control policy for a resource. May be empty if no such + * policy or resource exists. * * The async variant is {@see NodeGroupsClient::getIamPolicyAsync()} . * @@ -446,7 +454,8 @@ public function getIamPolicy(GetIamPolicyNodeGroupRequest $request, array $callO } /** - * Creates a NodeGroup resource in the specified project using the data included in the request. + * Creates a NodeGroup resource in the specified project using the data + * included in the request. * * The async variant is {@see NodeGroupsClient::insertAsync()} . * @@ -472,7 +481,8 @@ public function insert(InsertNodeGroupRequest $request, array $callOptions = []) } /** - * Retrieves a list of node groups available to the specified project. Note: use nodeGroups.listNodes for more details about each group. + * Retrieves a list of node groups available to the specified project. + * Note: use nodeGroups.listNodes for more details about each group. * * The async variant is {@see NodeGroupsClient::listAsync()} . * @@ -578,7 +588,8 @@ public function performMaintenance( } /** - * Sets the access control policy on the specified resource. Replaces any existing policy. + * Sets the access control policy on the specified resource. + * Replaces any existing policy. * * The async variant is {@see NodeGroupsClient::setIamPolicyAsync()} . * diff --git a/Compute/src/V1/Client/NodeTemplatesClient.php b/Compute/src/V1/Client/NodeTemplatesClient.php index b44f489b539a..b6c86b018b43 100644 --- a/Compute/src/V1/Client/NodeTemplatesClient.php +++ b/Compute/src/V1/Client/NodeTemplatesClient.php @@ -276,7 +276,10 @@ public function __call($method, $args) } /** - * Retrieves an aggregated list of node templates. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. + * Retrieves an aggregated list of node templates. + * + * To prevent failure, Google recommends that you set the + * `returnPartialSuccess` parameter to `true`. * * The async variant is {@see NodeTemplatesClient::aggregatedListAsync()} . * @@ -356,7 +359,8 @@ public function get(GetNodeTemplateRequest $request, array $callOptions = []): N } /** - * Gets the access control policy for a resource. May be empty if no such policy or resource exists. + * Gets the access control policy for a resource. May be empty if no such + * policy or resource exists. * * The async variant is {@see NodeTemplatesClient::getIamPolicyAsync()} . * @@ -382,7 +386,8 @@ public function getIamPolicy(GetIamPolicyNodeTemplateRequest $request, array $ca } /** - * Creates a NodeTemplate resource in the specified project using the data included in the request. + * Creates a NodeTemplate resource in the specified project using the data + * included in the request. * * The async variant is {@see NodeTemplatesClient::insertAsync()} . * @@ -408,7 +413,8 @@ public function insert(InsertNodeTemplateRequest $request, array $callOptions = } /** - * Retrieves a list of node templates available to the specified project. + * Retrieves a list of node templates available to the specified + * project. * * The async variant is {@see NodeTemplatesClient::listAsync()} . * @@ -434,7 +440,8 @@ public function list(ListNodeTemplatesRequest $request, array $callOptions = []) } /** - * Sets the access control policy on the specified resource. Replaces any existing policy. + * Sets the access control policy on the specified resource. + * Replaces any existing policy. * * The async variant is {@see NodeTemplatesClient::setIamPolicyAsync()} . * diff --git a/Compute/src/V1/Client/NodeTypesClient.php b/Compute/src/V1/Client/NodeTypesClient.php index 70028c559359..6f5e4ffecaf1 100644 --- a/Compute/src/V1/Client/NodeTypesClient.php +++ b/Compute/src/V1/Client/NodeTypesClient.php @@ -194,7 +194,10 @@ public function __call($method, $args) } /** - * Retrieves an aggregated list of node types. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. + * Retrieves an aggregated list of node types. + * + * To prevent failure, Google recommends that you set the + * `returnPartialSuccess` parameter to `true`. * * The async variant is {@see NodeTypesClient::aggregatedListAsync()} . * @@ -246,7 +249,8 @@ public function get(GetNodeTypeRequest $request, array $callOptions = []): NodeT } /** - * Retrieves a list of node types available to the specified project. + * Retrieves a list of node types available to the specified + * project. * * The async variant is {@see NodeTypesClient::listAsync()} . * diff --git a/Compute/src/V1/Client/OrganizationSecurityPoliciesClient.php b/Compute/src/V1/Client/OrganizationSecurityPoliciesClient.php index 8fb9b48bc683..5752badfbab0 100644 --- a/Compute/src/V1/Client/OrganizationSecurityPoliciesClient.php +++ b/Compute/src/V1/Client/OrganizationSecurityPoliciesClient.php @@ -296,7 +296,16 @@ public function __call($method, $args) } /** - * Inserts an association for the specified security policy. This has billing implications. Projects in the hierarchy with effective hierarchical security policies will be automatically enrolled into Cloud Armor Enterprise if not already enrolled. Use of this API to modify firewall policies is deprecated. Use firewallPolicies.addAssociation instead if possible. + * Inserts an association for the specified security policy. + * + * This has billing implications. Projects in the hierarchy with effective + * hierarchical security policies will be automatically enrolled into Cloud + * Armor Enterprise if not already enrolled. + * + * Use this API to modify Cloud Armor policies. Previously, alpha and beta + * versions of this API were used to modify firewall policies. This usage is + * now disabled for most organizations. Use firewallPolicies.addAssociation + * instead. * * The async variant is * {@see OrganizationSecurityPoliciesClient::addAssociationAsync()} . @@ -327,6 +336,10 @@ public function addAssociation( /** * Inserts a rule into a security policy. * + * Use this API to modify Cloud Armor policies. Previously, alpha and beta + * versions of this API were used to modify firewall policies. This usage is + * now disabled for most organizations. Use firewallPolicies.addRule instead. + * * The async variant is {@see OrganizationSecurityPoliciesClient::addRuleAsync()} . * * @example samples/V1/OrganizationSecurityPoliciesClient/add_rule.php @@ -353,7 +366,12 @@ public function addRule( } /** - * Copies rules to the specified security policy. Use of this API to modify firewall policies is deprecated. Use firewallPolicies.copyRules instead. + * Copies rules to the specified security policy. + * + * Use this API to modify Cloud Armor policies. Previously, alpha and beta + * versions of this API were used to modify firewall policies. This usage is + * now disabled for most organizations. Use firewallPolicies.cloneRules + * instead. * * The async variant is {@see OrganizationSecurityPoliciesClient::copyRulesAsync()} * . @@ -382,7 +400,11 @@ public function copyRules( } /** - * Deletes the specified policy. Use of this API to remove firewall policies is deprecated. Use firewallPolicies.delete instead. + * Deletes the specified policy. + * + * Use this API to remove Cloud Armor policies. Previously, alpha and beta + * versions of this API were used to remove firewall policies. This usage is + * now disabled for most organizations. Use firewallPolicies.delete instead. * * The async variant is {@see OrganizationSecurityPoliciesClient::deleteAsync()} . * @@ -408,7 +430,11 @@ public function delete(DeleteOrganizationSecurityPolicyRequest $request, array $ } /** - * List all of the ordered rules present in a single specified policy. Use of this API to read firewall policies is deprecated. Use firewallPolicies.get instead. + * List all of the ordered rules present in a single specified policy. + * + * Use this API to read Cloud Armor policies. Previously, alpha and beta + * versions of this API were used to read firewall policies. This usage is now + * disabled for most organizations. Use firewallPolicies.get instead. * * The async variant is {@see OrganizationSecurityPoliciesClient::getAsync()} . * @@ -434,7 +460,12 @@ public function get(GetOrganizationSecurityPolicyRequest $request, array $callOp } /** - * Gets an association with the specified name. Use of this API to read firewall policies is deprecated. Use firewallPolicies.getAssociation instead if possible. + * Gets an association with the specified name. + * + * Use this API to read Cloud Armor policies. Previously, alpha and beta + * versions of this API were used to read firewall policies. This usage is + * now disabled for most organizations. Use firewallPolicies.getAssociation + * instead. * * The async variant is * {@see OrganizationSecurityPoliciesClient::getAssociationAsync()} . @@ -463,7 +494,11 @@ public function getAssociation( } /** - * Gets a rule at the specified priority. Use of this API to read firewall policies is deprecated. Use firewallPolicies.getRule instead. + * Gets a rule at the specified priority. + * + * Use this API to read Cloud Armor policies. Previously, alpha and beta + * versions of this API were used to read firewall policies. This usage is now + * disabled for most organizations. Use firewallPolicies.getRule instead. * * The async variant is {@see OrganizationSecurityPoliciesClient::getRuleAsync()} . * @@ -491,7 +526,12 @@ public function getRule( } /** - * Creates a new policy in the specified project using the data included in the request. Use of this API to insert firewall policies is deprecated. Use firewallPolicies.insert instead. + * Creates a new policy in the specified organization using the data included + * in the request. + * + * Use this API to add Cloud Armor policies. Previously, alpha and beta + * versions of this API were used to add firewall policies. This usage is now + * disabled for most organizations. Use firewallPolicies.insert instead. * * The async variant is {@see OrganizationSecurityPoliciesClient::insertAsync()} . * @@ -517,7 +557,12 @@ public function insert(InsertOrganizationSecurityPolicyRequest $request, array $ } /** - * List all the policies that have been configured for the specified project. Use of this API to read firewall policies is deprecated. Use firewallPolicies.list instead. + * List all the policies that have been configured for the specified + * organization. + * + * Use this API to read Cloud Armor policies. Previously, alpha and beta + * versions of this API were used to read firewall policies. This usage is now + * disabled for most organizations. Use firewallPolicies.list instead. * * The async variant is {@see OrganizationSecurityPoliciesClient::listAsync()} . * @@ -543,7 +588,12 @@ public function list(ListOrganizationSecurityPoliciesRequest $request, array $ca } /** - * Lists associations of a specified target, i.e., organization or folder. Use of this API to read firewall policies is deprecated. Use firewallPolicies.listAssociations instead if possible. + * Lists associations of a specified target, i.e., organization or folder. + * + * Use this API to read Cloud Armor policies. Previously, alpha and beta + * versions of this API were used to read firewall policies. This usage is + * now disabled for most organizations. Use firewallPolicies.listAssociations + * instead. * * The async variant is * {@see OrganizationSecurityPoliciesClient::listAssociationsAsync()} . @@ -572,7 +622,8 @@ public function listAssociations( } /** - * Gets the current list of preconfigured Web Application Firewall (WAF) expressions. + * Gets the current list of preconfigured Web Application Firewall (WAF) + * expressions. * * The async variant is * {@see OrganizationSecurityPoliciesClient::listPreconfiguredExpressionSetsAsync()} @@ -602,7 +653,11 @@ public function listPreconfiguredExpressionSets( } /** - * Moves the specified security policy. Use of this API to modify firewall policies is deprecated. Use firewallPolicies.move instead. + * Moves the specified security policy. + * + * Use this API to modify Cloud Armor policies. Previously, alpha and beta + * versions of this API were used to modify firewall policies. This usage is + * now disabled for most organizations. Use firewallPolicies.move instead. * * The async variant is {@see OrganizationSecurityPoliciesClient::moveAsync()} . * @@ -628,7 +683,11 @@ public function move(MoveOrganizationSecurityPolicyRequest $request, array $call } /** - * Patches the specified policy with the data included in the request. Use of this API to modify firewall policies is deprecated. Use firewallPolicies.patch instead. + * Patches the specified policy with the data included in the request. + * + * Use this API to modify Cloud Armor policies. Previously, alpha and beta + * versions of this API were used to modify firewall policies. This usage is + * now disabled for most organizations. Use firewallPolicies.patch instead. * * The async variant is {@see OrganizationSecurityPoliciesClient::patchAsync()} . * @@ -654,7 +713,12 @@ public function patch(PatchOrganizationSecurityPolicyRequest $request, array $ca } /** - * Patches a rule at the specified priority. Use of this API to modify firewall policies is deprecated. Use firewallPolicies.patchRule instead. + * Patches a rule at the specified priority. + * + * Use this API to modify Cloud Armor policies. Previously, alpha and beta + * versions of this API were used to modify firewall policies. This usage is + * now disabled for most organizations. Use firewallPolicies.patchRule + * instead. * * The async variant is {@see OrganizationSecurityPoliciesClient::patchRuleAsync()} * . @@ -683,7 +747,12 @@ public function patchRule( } /** - * Removes an association for the specified security policy. Use of this API to modify firewall policies is deprecated. Use firewallPolicies.removeAssociation instead if possible. + * Removes an association for the specified security policy. + * + * Use this API to modify Cloud Armor policies. Previously, alpha and beta + * versions of this API were used to modify firewall policies. This usage is + * now disabled for most organizations. Use firewallPolicies.removeAssociation + * instead. * * The async variant is * {@see OrganizationSecurityPoliciesClient::removeAssociationAsync()} . @@ -714,6 +783,11 @@ public function removeAssociation( /** * Deletes a rule at the specified priority. * + * Use this API to modify Cloud Armor policies. Previously, alpha and beta + * versions of this API were used to modify firewall policies. This usage is + * now disabled for most organizations. Use firewallPolicies.removeRule + * instead. + * * The async variant is * {@see OrganizationSecurityPoliciesClient::removeRuleAsync()} . * diff --git a/Compute/src/V1/Client/PacketMirroringsClient.php b/Compute/src/V1/Client/PacketMirroringsClient.php index 4ebb58162929..1ee0264cc3bf 100644 --- a/Compute/src/V1/Client/PacketMirroringsClient.php +++ b/Compute/src/V1/Client/PacketMirroringsClient.php @@ -273,7 +273,10 @@ public function __call($method, $args) } /** - * Retrieves an aggregated list of packetMirrorings. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. + * Retrieves an aggregated list of packetMirrorings. + * + * To prevent failure, Google recommends that you set the + * `returnPartialSuccess` parameter to `true`. * * The async variant is {@see PacketMirroringsClient::aggregatedListAsync()} . * @@ -353,7 +356,8 @@ public function get(GetPacketMirroringRequest $request, array $callOptions = []) } /** - * Creates a PacketMirroring resource in the specified project and region using the data included in the request. + * Creates a PacketMirroring resource in the specified project and region + * using the data included in the request. * * The async variant is {@see PacketMirroringsClient::insertAsync()} . * @@ -379,7 +383,8 @@ public function insert(InsertPacketMirroringRequest $request, array $callOptions } /** - * Retrieves a list of PacketMirroring resources available to the specified project and region. + * Retrieves a list of PacketMirroring resources available to the specified + * project and region. * * The async variant is {@see PacketMirroringsClient::listAsync()} . * @@ -405,7 +410,10 @@ public function list(ListPacketMirroringsRequest $request, array $callOptions = } /** - * Patches the specified PacketMirroring resource with the data included in the request. This method supports PATCH semantics and uses JSON merge patch format and processing rules. + * Patches the specified PacketMirroring resource with the data included in + * the request. This method supportsPATCH + * semantics and usesJSON merge + * patch format and processing rules. * * The async variant is {@see PacketMirroringsClient::patchAsync()} . * diff --git a/Compute/src/V1/Client/PreviewFeaturesClient.php b/Compute/src/V1/Client/PreviewFeaturesClient.php index e6ccf91dd397..48899490f344 100644 --- a/Compute/src/V1/Client/PreviewFeaturesClient.php +++ b/Compute/src/V1/Client/PreviewFeaturesClient.php @@ -316,7 +316,8 @@ public function list(ListPreviewFeaturesRequest $request, array $callOptions = [ } /** - * Patches the given PreviewFeature. This method is used to enable or disable a PreviewFeature. + * Patches the given PreviewFeature. This method is used to enable or disable + * a PreviewFeature. * * The async variant is {@see PreviewFeaturesClient::updateAsync()} . * diff --git a/Compute/src/V1/Client/ProjectsClient.php b/Compute/src/V1/Client/ProjectsClient.php index 6c4ff46961d0..50f4712bad8b 100644 --- a/Compute/src/V1/Client/ProjectsClient.php +++ b/Compute/src/V1/Client/ProjectsClient.php @@ -312,7 +312,8 @@ public function disableXpnHost(DisableXpnHostProjectRequest $request, array $cal } /** - * Disable a service resource (also known as service project) associated with this host project. + * Disable a service resource (also known as service project) associated with + * this host project. * * The async variant is {@see ProjectsClient::disableXpnResourceAsync()} . * @@ -366,7 +367,9 @@ public function enableXpnHost(EnableXpnHostProjectRequest $request, array $callO } /** - * Enable service resource (a.k.a service project) for a host project, so that subnets in the host project can be used by instances in the service project. + * Enable service resource (a.k.a service project) for a host project, so that + * subnets in the host project can be used by instances in the service + * project. * * The async variant is {@see ProjectsClient::enableXpnResourceAsync()} . * @@ -394,7 +397,15 @@ public function enableXpnResource( } /** - * Returns the specified Project resource. To decrease latency for this method, you can optionally omit any unneeded information from the response by using a field mask. This practice is especially recommended for unused quota information (the `quotas` field). To exclude one or more fields, set your request's `fields` query parameter to only include the fields you need. For example, to only include the `id` and `selfLink` fields, add the query parameter `?fields=id,selfLink` to your request. + * Returns the specified Project resource. + * + * To decrease latency for this method, you can optionally omit any unneeded + * information from the response by using a field mask. This practice is + * especially recommended for unused quota information (the `quotas` field). + * To exclude one or more fields, set your request's `fields` query parameter + * to only include the fields you need. For example, to only include the `id` + * and `selfLink` fields, add the query parameter `?fields=id,selfLink` to + * your request. * * The async variant is {@see ProjectsClient::getAsync()} . * @@ -420,7 +431,8 @@ public function get(GetProjectRequest $request, array $callOptions = []): Projec } /** - * Gets the shared VPC host project that this project links to. May be empty if no link exists. + * Gets the shared VPC host project that this project links to. May be empty + * if no link exists. * * The async variant is {@see ProjectsClient::getXpnHostAsync()} . * @@ -446,7 +458,8 @@ public function getXpnHost(GetXpnHostProjectRequest $request, array $callOptions } /** - * Gets service resources (a.k.a service project) associated with this host project. + * Gets service resources (a.k.a service project) associated with this host + * project. * * The async variant is {@see ProjectsClient::getXpnResourcesAsync()} . * @@ -498,7 +511,20 @@ public function listXpnHosts(ListXpnHostsProjectsRequest $request, array $callOp } /** - * Starting September 29, 2025, you can't use the moveDisk API on new projects. To move a disk to a different region or zone, follow the steps in [Change the location of a disk](https://{$universe.dns_names.final_documentation_domain}/compute/docs/disks/migrate-to-hyperdisk#migrate-to-hd). Projects that already use the moveDisk API can continue usage until September 29, 2026. Starting November 1, 2025, API responses will include a warning message in the response body about the upcoming deprecation. You can skip the message to continue using the service without interruption. + * Moves a persistent disk from one zone to another. + * *Note*: The moveDisk API will be deprecated on September 29, 2026. + * + * Starting September 29, 2025, you can't use the moveDisk API on new + * projects. To move a disk to a different region or zone, follow the steps in + * [Change the location of a + * disk](https://cloud.google.com/compute/docs/disks/migrate-to-hyperdisk#migrate-to-hd). + * + * Projects that already use the moveDisk API can continue usage until + * September 29, 2026. + * + * Starting November 1, 2025, API responses will include a warning message in + * the response body about the upcoming deprecation. You can skip the message + * to continue using the service without interruption. * * The async variant is {@see ProjectsClient::moveDiskAsync()} . * @@ -524,7 +550,13 @@ public function moveDisk(MoveDiskProjectRequest $request, array $callOptions = [ } /** - * Moves an instance and its attached persistent disks from one zone to another. *Note*: Moving VMs or disks by using this method might cause unexpected behavior. For more information, see the [known issue](/compute/docs/troubleshooting/known-issues#moving_vms_or_disks_using_the_moveinstance_api_or_the_causes_unexpected_behavior). [Deprecated] This method is deprecated. See [moving instance across zones](/compute/docs/instances/moving-instance-across-zones) instead. + * Moves an instance and its attached persistent disks from one zone to + * another. + * *Note*: Moving VMs or disks by using this method might + * cause unexpected behavior. For more information, see the [known + * issue](/compute/docs/troubleshooting/known-issues#moving_vms_or_disks_using_the_moveinstance_api_or_the_causes_unexpected_behavior). + * [Deprecated] This method is deprecated. See [moving instance across + * zones](/compute/docs/instances/moving-instance-across-zones) instead. * * The async variant is {@see ProjectsClient::moveInstanceAsync()} . * @@ -550,7 +582,10 @@ public function moveInstance(MoveInstanceProjectRequest $request, array $callOpt } /** - * Sets the Cloud Armor tier of the project. To set ENTERPRISE or above the billing account of the project must be subscribed to Cloud Armor Enterprise. See Subscribing to Cloud Armor Enterprise for more information. + * Sets the Cloud Armor tier of the project. To set ENTERPRISE or above the + * billing account of the project must be subscribed to Cloud Armor + * Enterprise. See Subscribing + * to Cloud Armor Enterprise for more information. * * The async variant is {@see ProjectsClient::setCloudArmorTierAsync()} . * @@ -578,7 +613,8 @@ public function setCloudArmorTier( } /** - * Sets metadata common to all instances within the specified project using the data included in the request. + * Sets metadata common to all instances within the specified project using + * the data included in the request. * * The async variant is {@see ProjectsClient::setCommonInstanceMetadataAsync()} . * @@ -606,7 +642,9 @@ public function setCommonInstanceMetadata( } /** - * Sets the default network tier of the project. The default network tier is used when an address/forwardingRule/instance is created without specifying the network tier field. + * Sets the default network tier of the project. The default network tier is + * used when an address/forwardingRule/instance is created without specifying + * the network tier field. * * The async variant is {@see ProjectsClient::setDefaultNetworkTierAsync()} . * @@ -634,7 +672,9 @@ public function setDefaultNetworkTier( } /** - * Enables the usage export feature and sets the usage export bucket where reports are stored. If you provide an empty request body using this method, the usage export feature will be disabled. + * Enables the usage export feature and sets theusage export bucket + * where reports are stored. If you provide an empty request body using this + * method, the usage export feature will be disabled. * * The async variant is {@see ProjectsClient::setUsageExportBucketAsync()} . * diff --git a/Compute/src/V1/Client/PublicAdvertisedPrefixesClient.php b/Compute/src/V1/Client/PublicAdvertisedPrefixesClient.php index f5c0d6f912c0..b7c5f8e78b29 100644 --- a/Compute/src/V1/Client/PublicAdvertisedPrefixesClient.php +++ b/Compute/src/V1/Client/PublicAdvertisedPrefixesClient.php @@ -353,7 +353,8 @@ public function get(GetPublicAdvertisedPrefixeRequest $request, array $callOptio } /** - * Creates a PublicAdvertisedPrefix in the specified project using the parameters that are included in the request. + * Creates a PublicAdvertisedPrefix in the specified project + * using the parameters that are included in the request. * * The async variant is {@see PublicAdvertisedPrefixesClient::insertAsync()} . * @@ -405,7 +406,10 @@ public function list(ListPublicAdvertisedPrefixesRequest $request, array $callOp } /** - * Patches the specified Router resource with the data included in the request. This method supports PATCH semantics and uses JSON merge patch format and processing rules. + * Patches the specified Router resource with the data included in the + * request. This method supportsPATCH + * semantics and usesJSON merge + * patch format and processing rules. * * The async variant is {@see PublicAdvertisedPrefixesClient::patchAsync()} . * diff --git a/Compute/src/V1/Client/PublicDelegatedPrefixesClient.php b/Compute/src/V1/Client/PublicDelegatedPrefixesClient.php index ab641f0525fd..46905c32e5c7 100644 --- a/Compute/src/V1/Client/PublicDelegatedPrefixesClient.php +++ b/Compute/src/V1/Client/PublicDelegatedPrefixesClient.php @@ -275,7 +275,11 @@ public function __call($method, $args) } /** - * Lists all PublicDelegatedPrefix resources owned by the specific project across all scopes. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. + * Lists all PublicDelegatedPrefix resources owned by the specific project + * across all scopes. + * + * To prevent failure, Google recommends that you set the + * `returnPartialSuccess` parameter to `true`. * * The async variant is {@see PublicDelegatedPrefixesClient::aggregatedListAsync()} * . @@ -382,7 +386,8 @@ public function get(GetPublicDelegatedPrefixeRequest $request, array $callOption } /** - * Creates a PublicDelegatedPrefix in the specified project in the given region using the parameters that are included in the request. + * Creates a PublicDelegatedPrefix in the specified project in the given + * region using the parameters that are included in the request. * * The async variant is {@see PublicDelegatedPrefixesClient::insertAsync()} . * @@ -434,7 +439,10 @@ public function list(ListPublicDelegatedPrefixesRequest $request, array $callOpt } /** - * Patches the specified PublicDelegatedPrefix resource with the data included in the request. This method supports PATCH semantics and uses JSON merge patch format and processing rules. + * Patches the specified PublicDelegatedPrefix resource with the data included + * in the request. This method supportsPATCH + * semantics and usesJSON merge + * patch format and processing rules. * * The async variant is {@see PublicDelegatedPrefixesClient::patchAsync()} . * diff --git a/Compute/src/V1/Client/RegionAutoscalersClient.php b/Compute/src/V1/Client/RegionAutoscalersClient.php index 02e6e220d37e..06f2633f1712 100644 --- a/Compute/src/V1/Client/RegionAutoscalersClient.php +++ b/Compute/src/V1/Client/RegionAutoscalersClient.php @@ -322,7 +322,8 @@ public function get(GetRegionAutoscalerRequest $request, array $callOptions = [] } /** - * Creates an autoscaler in the specified project using the data included in the request. + * Creates an autoscaler in the specified project using + * the data included in the request. * * The async variant is {@see RegionAutoscalersClient::insertAsync()} . * @@ -348,7 +349,8 @@ public function insert(InsertRegionAutoscalerRequest $request, array $callOption } /** - * Retrieves a list of autoscalers contained within the specified region. + * Retrieves a list of autoscalers contained within + * the specified region. * * The async variant is {@see RegionAutoscalersClient::listAsync()} . * @@ -374,7 +376,10 @@ public function list(ListRegionAutoscalersRequest $request, array $callOptions = } /** - * Updates an autoscaler in the specified project using the data included in the request. This method supports PATCH semantics and uses the JSON merge patch format and processing rules. + * Updates an autoscaler in the specified project using + * the data included in the request. This method supportsPATCH + * semantics and uses theJSON merge + * patch format and processing rules. * * The async variant is {@see RegionAutoscalersClient::patchAsync()} . * @@ -400,7 +405,8 @@ public function patch(PatchRegionAutoscalerRequest $request, array $callOptions } /** - * Updates an autoscaler in the specified project using the data included in the request. + * Updates an autoscaler in the specified project using + * the data included in the request. * * The async variant is {@see RegionAutoscalersClient::updateAsync()} . * diff --git a/Compute/src/V1/Client/RegionBackendServicesClient.php b/Compute/src/V1/Client/RegionBackendServicesClient.php index 87624bb7ad1e..16850cbb5ee0 100644 --- a/Compute/src/V1/Client/RegionBackendServicesClient.php +++ b/Compute/src/V1/Client/RegionBackendServicesClient.php @@ -337,7 +337,8 @@ public function get(GetRegionBackendServiceRequest $request, array $callOptions } /** - * Gets the most recent health check results for this regional BackendService. + * Gets the most recent health check results for this + * regional BackendService. * * The async variant is {@see RegionBackendServicesClient::getHealthAsync()} . * @@ -365,7 +366,8 @@ public function getHealth( } /** - * Gets the access control policy for a resource. May be empty if no such policy or resource exists. + * Gets the access control policy for a resource. May be empty if no such + * policy or resource exists. * * The async variant is {@see RegionBackendServicesClient::getIamPolicyAsync()} . * @@ -391,7 +393,9 @@ public function getIamPolicy(GetIamPolicyRegionBackendServiceRequest $request, a } /** - * Creates a regional BackendService resource in the specified project using the data included in the request. For more information, see Backend services overview. + * Creates a regional BackendService resource in the specified project using + * the data included in the request. For more information, see + * Backend services overview. * * The async variant is {@see RegionBackendServicesClient::insertAsync()} . * @@ -417,7 +421,8 @@ public function insert(InsertRegionBackendServiceRequest $request, array $callOp } /** - * Retrieves the list of regional BackendService resources available to the specified project in the given region. + * Retrieves the list of regional BackendService resources available to the + * specified project in the given region. * * The async variant is {@see RegionBackendServicesClient::listAsync()} . * @@ -443,7 +448,8 @@ public function list(ListRegionBackendServicesRequest $request, array $callOptio } /** - * Retrieves a list of all usable backend services in the specified project in the given region. + * Retrieves a list of all usable backend services in the specified project in + * the given region. * * The async variant is {@see RegionBackendServicesClient::listUsableAsync()} . * @@ -471,7 +477,11 @@ public function listUsable( } /** - * Updates the specified regional BackendService resource with the data included in the request. For more information, see Understanding backend services This method supports PATCH semantics and uses the JSON merge patch format and processing rules. + * Updates the specified regional BackendService resource with the data + * included in the request. For more information, see + * Understanding backend services This method + * supports PATCH semantics and uses the JSON merge + * patch format and processing rules. * * The async variant is {@see RegionBackendServicesClient::patchAsync()} . * @@ -497,7 +507,8 @@ public function patch(PatchRegionBackendServiceRequest $request, array $callOpti } /** - * Sets the access control policy on the specified resource. Replaces any existing policy. + * Sets the access control policy on the specified resource. + * Replaces any existing policy. * * The async variant is {@see RegionBackendServicesClient::setIamPolicyAsync()} . * @@ -523,7 +534,9 @@ public function setIamPolicy(SetIamPolicyRegionBackendServiceRequest $request, a } /** - * Sets the Google Cloud Armor security policy for the specified backend service. For more information, see Google Cloud Armor Overview + * Sets the Google Cloud Armor security policy for the specified backend + * service. For more information, seeGoogle + * Cloud Armor Overview * * The async variant is * {@see RegionBackendServicesClient::setSecurityPolicyAsync()} . @@ -581,7 +594,10 @@ public function testIamPermissions( } /** - * Updates the specified regional BackendService resource with the data included in the request. For more information, see Backend services overview . + * Updates the specified regional BackendService resource with the data + * included in the request. For more information, + * see + * Backend services overview. * * The async variant is {@see RegionBackendServicesClient::updateAsync()} . * diff --git a/Compute/src/V1/Client/RegionCommitmentsClient.php b/Compute/src/V1/Client/RegionCommitmentsClient.php index c87d26b7daa8..37ff5cafc592 100644 --- a/Compute/src/V1/Client/RegionCommitmentsClient.php +++ b/Compute/src/V1/Client/RegionCommitmentsClient.php @@ -268,7 +268,10 @@ public function __call($method, $args) } /** - * Retrieves an aggregated list of commitments by region. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. + * Retrieves an aggregated list of commitments by region. + * + * To prevent failure, it is recommended that you set the + * `returnPartialSuccess` parameter to `true`. * * The async variant is {@see RegionCommitmentsClient::aggregatedListAsync()} . * @@ -322,7 +325,8 @@ public function get(GetRegionCommitmentRequest $request, array $callOptions = [] } /** - * Creates a commitment in the specified project using the data included in the request. + * Creates a commitment in the specified project using the data + * included in the request. * * The async variant is {@see RegionCommitmentsClient::insertAsync()} . * @@ -348,7 +352,8 @@ public function insert(InsertRegionCommitmentRequest $request, array $callOption } /** - * Retrieves a list of commitments contained within the specified region. + * Retrieves a list of commitments contained within + * the specified region. * * The async variant is {@see RegionCommitmentsClient::listAsync()} . * @@ -374,7 +379,9 @@ public function list(ListRegionCommitmentsRequest $request, array $callOptions = } /** - * Updates the specified commitment with the data included in the request. Update is performed only on selected fields included as part of update-mask. Only the following fields can be updated: auto_renew and plan. + * Updates the specified commitment with the data included in the request. + * Update is performed only on selected fields included as part of + * update-mask. Only the following fields can be updated: auto_renew and plan. * * The async variant is {@see RegionCommitmentsClient::updateAsync()} . * diff --git a/Compute/src/V1/Client/RegionDisksClient.php b/Compute/src/V1/Client/RegionDisksClient.php index d7030e3841f5..2266954bfec0 100644 --- a/Compute/src/V1/Client/RegionDisksClient.php +++ b/Compute/src/V1/Client/RegionDisksClient.php @@ -294,7 +294,9 @@ public function __call($method, $args) } /** - * Adds existing resource policies to a regional disk. You can only add one policy which will be applied to this disk for scheduling snapshot creation. + * Adds existing resource policies to a regional disk. You can only add one + * policy which will be applied to this disk for scheduling snapshot + * creation. * * The async variant is {@see RegionDisksClient::addResourcePoliciesAsync()} . * @@ -348,7 +350,10 @@ public function bulkInsert(BulkInsertRegionDiskRequest $request, array $callOpti } /** - * Creates a snapshot of a specified persistent disk. For regular snapshot creation, consider using snapshots.insert instead, as that method supports more features, such as creating snapshots in a project different from the source disk project. + * Creates a snapshot of a specified persistent disk. For regular snapshot + * creation, consider using snapshots.insert + * instead, as that method supports more features, such as creating snapshots + * in a project different from the source disk project. * * The async variant is {@see RegionDisksClient::createSnapshotAsync()} . * @@ -374,7 +379,11 @@ public function createSnapshot(CreateSnapshotRegionDiskRequest $request, array $ } /** - * Deletes the specified regional persistent disk. Deleting a regional disk removes all the replicas of its data permanently and is irreversible. However, deleting a disk does not delete any snapshots previously made from the disk. You must separately delete snapshots. + * Deletes the specified regional persistent disk. Deleting a regional disk + * removes all the replicas of its data permanently and is irreversible. + * However, deleting a disk does not delete anysnapshots + * previously made from the disk. You must separatelydelete + * snapshots. * * The async variant is {@see RegionDisksClient::deleteAsync()} . * @@ -426,7 +435,8 @@ public function get(GetRegionDiskRequest $request, array $callOptions = []): Dis } /** - * Gets the access control policy for a resource. May be empty if no such policy or resource exists. + * Gets the access control policy for a resource. May be empty if no such + * policy or resource exists. * * The async variant is {@see RegionDisksClient::getIamPolicyAsync()} . * @@ -452,7 +462,8 @@ public function getIamPolicy(GetIamPolicyRegionDiskRequest $request, array $call } /** - * Creates a persistent regional disk in the specified project using the data included in the request. + * Creates a persistent regional disk in the specified project using the data + * included in the request. * * The async variant is {@see RegionDisksClient::insertAsync()} . * @@ -478,7 +489,8 @@ public function insert(InsertRegionDiskRequest $request, array $callOptions = [] } /** - * Retrieves the list of persistent disks contained within the specified region. + * Retrieves the list of persistent disks contained within + * the specified region. * * The async variant is {@see RegionDisksClient::listAsync()} . * @@ -558,7 +570,8 @@ public function resize(ResizeRegionDiskRequest $request, array $callOptions = [] } /** - * Sets the access control policy on the specified resource. Replaces any existing policy. + * Sets the access control policy on the specified resource. + * Replaces any existing policy. * * The async variant is {@see RegionDisksClient::setIamPolicyAsync()} . * @@ -610,7 +623,8 @@ public function setLabels(SetLabelsRegionDiskRequest $request, array $callOption } /** - * Starts asynchronous replication. Must be invoked on the primary disk. + * Starts asynchronous replication. + * Must be invoked on the primary disk. * * The async variant is {@see RegionDisksClient::startAsyncReplicationAsync()} . * @@ -638,7 +652,8 @@ public function startAsyncReplication( } /** - * Stops asynchronous replication. Can be invoked either on the primary or on the secondary disk. + * Stops asynchronous replication. + * Can be invoked either on the primary or on the secondary disk. * * The async variant is {@see RegionDisksClient::stopAsyncReplicationAsync()} . * @@ -666,7 +681,8 @@ public function stopAsyncReplication( } /** - * Stops asynchronous replication for a consistency group of disks. Can be invoked either in the primary or secondary scope. + * Stops asynchronous replication for a consistency group of disks. + * Can be invoked either in the primary or secondary scope. * * The async variant is {@see RegionDisksClient::stopGroupAsyncReplicationAsync()} * . @@ -723,7 +739,9 @@ public function testIamPermissions( } /** - * Update the specified disk with the data included in the request. Update is performed only on selected fields included as part of update-mask. Only the following fields can be modified: user_license. + * Update the specified disk with the data included in the request. Update is + * performed only on selected fields included as part of update-mask. Only the + * following fields can be modified: user_license. * * The async variant is {@see RegionDisksClient::updateAsync()} . * diff --git a/Compute/src/V1/Client/RegionHealthCheckServicesClient.php b/Compute/src/V1/Client/RegionHealthCheckServicesClient.php index 7d30b84413d9..b73dba27bb63 100644 --- a/Compute/src/V1/Client/RegionHealthCheckServicesClient.php +++ b/Compute/src/V1/Client/RegionHealthCheckServicesClient.php @@ -321,7 +321,8 @@ public function get(GetRegionHealthCheckServiceRequest $request, array $callOpti } /** - * Creates a regional HealthCheckService resource in the specified project and region using the data included in the request. + * Creates a regional HealthCheckService resource in the + * specified project and region using the data included in the request. * * The async variant is {@see RegionHealthCheckServicesClient::insertAsync()} . * @@ -347,7 +348,8 @@ public function insert(InsertRegionHealthCheckServiceRequest $request, array $ca } /** - * Lists all the HealthCheckService resources that have been configured for the specified project in the given region. + * Lists all the HealthCheckService resources that have been + * configured for the specified project in the given region. * * The async variant is {@see RegionHealthCheckServicesClient::listAsync()} . * @@ -373,7 +375,10 @@ public function list(ListRegionHealthCheckServicesRequest $request, array $callO } /** - * Updates the specified regional HealthCheckService resource with the data included in the request. This method supports PATCH semantics and uses the JSON merge patch format and processing rules. + * Updates the specified regional HealthCheckService resource + * with the data included in the request. This method supportsPATCH + * semantics and uses theJSON merge + * patch format and processing rules. * * The async variant is {@see RegionHealthCheckServicesClient::patchAsync()} . * diff --git a/Compute/src/V1/Client/RegionHealthChecksClient.php b/Compute/src/V1/Client/RegionHealthChecksClient.php index b0b3710b412e..90ce115db918 100644 --- a/Compute/src/V1/Client/RegionHealthChecksClient.php +++ b/Compute/src/V1/Client/RegionHealthChecksClient.php @@ -322,7 +322,8 @@ public function get(GetRegionHealthCheckRequest $request, array $callOptions = [ } /** - * Creates a HealthCheck resource in the specified project using the data included in the request. + * Creates a HealthCheck resource in the specified project using the data + * included in the request. * * The async variant is {@see RegionHealthChecksClient::insertAsync()} . * @@ -348,7 +349,8 @@ public function insert(InsertRegionHealthCheckRequest $request, array $callOptio } /** - * Retrieves the list of HealthCheck resources available to the specified project. + * Retrieves the list of HealthCheck resources available to the specified + * project. * * The async variant is {@see RegionHealthChecksClient::listAsync()} . * @@ -374,7 +376,10 @@ public function list(ListRegionHealthChecksRequest $request, array $callOptions } /** - * Updates a HealthCheck resource in the specified project using the data included in the request. This method supports PATCH semantics and uses the JSON merge patch format and processing rules. + * Updates a HealthCheck resource in the specified project using the data + * included in the request. This method supportsPATCH + * semantics and uses theJSON merge + * patch format and processing rules. * * The async variant is {@see RegionHealthChecksClient::patchAsync()} . * @@ -400,7 +405,8 @@ public function patch(PatchRegionHealthCheckRequest $request, array $callOptions } /** - * Updates a HealthCheck resource in the specified project using the data included in the request. + * Updates a HealthCheck resource in the specified project using the data + * included in the request. * * The async variant is {@see RegionHealthChecksClient::updateAsync()} . * diff --git a/Compute/src/V1/Client/RegionInstanceGroupManagersClient.php b/Compute/src/V1/Client/RegionInstanceGroupManagersClient.php index f11f0acf9f01..9cb2f26924a6 100644 --- a/Compute/src/V1/Client/RegionInstanceGroupManagersClient.php +++ b/Compute/src/V1/Client/RegionInstanceGroupManagersClient.php @@ -305,7 +305,21 @@ public function __call($method, $args) } /** - * Flags the specified instances to be immediately removed from the managed instance group. Abandoning an instance does not delete the instance, but it does remove the instance from any target pools that are applied by the managed instance group. This method reduces the targetSize of the managed instance group by the number of instances that you abandon. This operation is marked as DONE when the action is scheduled even if the instances have not yet been removed from the group. You must separately verify the status of the abandoning action with the listmanagedinstances method. If the group is part of a backend service that has enabled connection draining, it can take up to 60 seconds after the connection draining duration has elapsed before the VM instance is removed or deleted. You can specify a maximum of 1000 instances with this method per request. + * Flags the specified instances to be immediately removed from the managed + * instance group. Abandoning an instance does not delete the + * instance, but it does remove the instance from any target pools that are + * applied by the managed instance group. This method reduces thetargetSize of the managed instance group by the + * number of instances that you abandon. This operation is marked asDONE when the action is scheduled even if the instances have + * not yet been removed from the group. You must separately verify the + * status of the abandoning action with thelistmanagedinstances + * method. + * + * If the group is part of a backend + * service that has enabled + * connection draining, it can take up to 60 seconds after the connection + * draining duration has elapsed before the VM instance is removed or deleted. + * + * You can specify a maximum of 1000 instances with this method per request. * * The async variant is * {@see RegionInstanceGroupManagersClient::abandonInstancesAsync()} . @@ -363,7 +377,12 @@ public function applyUpdatesToInstances( } /** - * Creates instances with per-instance configurations in this regional managed instance group. Instances are created using the current instance template. The create instances operation is marked DONE if the createInstances request is successful. The underlying actions take additional time. You must separately verify the status of the creating or actions with the listmanagedinstances method. + * Creates instances with per-instance configurations in this regional managed + * instance group. Instances are created using the current instance template. + * The create instances operation is marked DONE if + * the createInstances request is successful. The underlying + * actions take additional time. You must separately verify the status of thecreating or actions with the listmanagedinstances + * method. * * The async variant is * {@see RegionInstanceGroupManagersClient::createInstancesAsync()} . @@ -392,7 +411,8 @@ public function createInstances( } /** - * Deletes the specified managed instance group and all of the instances in that group. + * Deletes the specified managed instance group and all of the instances + * in that group. * * The async variant is {@see RegionInstanceGroupManagersClient::deleteAsync()} . * @@ -418,7 +438,21 @@ public function delete(DeleteRegionInstanceGroupManagerRequest $request, array $ } /** - * Flags the specified instances in the managed instance group to be immediately deleted. The instances are also removed from any target pools of which they were a member. This method reduces the targetSize of the managed instance group by the number of instances that you delete. The deleteInstances operation is marked DONE if the deleteInstances request is successful. The underlying actions take additional time. You must separately verify the status of the deleting action with the listmanagedinstances method. If the group is part of a backend service that has enabled connection draining, it can take up to 60 seconds after the connection draining duration has elapsed before the VM instance is removed or deleted. You can specify a maximum of 1000 instances with this method per request. + * Flags the specified instances in the managed instance group to be + * immediately deleted. The instances are also removed from any target + * pools of which they were a member. This method reduces thetargetSize of the managed instance group by the number of + * instances that you delete. + * The deleteInstances operation is marked DONE if + * the deleteInstances request is successful. The underlying + * actions take additional time. You must separately verify the status of thedeleting action with thelistmanagedinstances + * method. + * + * If the group is part of a backend + * service that has enabled + * connection draining, it can take up to 60 seconds after the connection + * draining duration has elapsed before the VM instance is removed or deleted. + * + * You can specify a maximum of 1000 instances with this method per request. * * The async variant is * {@see RegionInstanceGroupManagersClient::deleteInstancesAsync()} . @@ -447,7 +481,8 @@ public function deleteInstances( } /** - * Deletes selected per-instance configurations for the managed instance group. + * Deletes selected per-instance configurations for the managed instance + * group. * * The async variant is * {@see RegionInstanceGroupManagersClient::deletePerInstanceConfigsAsync()} . @@ -502,7 +537,15 @@ public function get(GetRegionInstanceGroupManagerRequest $request, array $callOp } /** - * Creates a managed instance group using the information that you specify in the request. After the group is created, instances in the group are created using the specified instance template. This operation is marked as DONE when the group is created even if the instances in the group have not yet been created. You must separately verify the status of the individual instances with the listmanagedinstances method. A regional managed instance group can contain up to 2000 instances. + * Creates a managed instance group using the information that you specify + * in the request. After the group is created, instances in the group are + * created using the specified instance template. + * This operation is marked as DONE when the group is created + * even if the instances in the group have not yet been created. You must + * separately verify the status of the individual instances with thelistmanagedinstances + * method. + * + * A regional managed instance group can contain up to 2000 instances. * * The async variant is {@see RegionInstanceGroupManagersClient::insertAsync()} . * @@ -528,7 +571,8 @@ public function insert(InsertRegionInstanceGroupManagerRequest $request, array $ } /** - * Retrieves the list of managed instance groups that are contained within the specified region. + * Retrieves the list of managed instance groups that are contained + * within the specified region. * * The async variant is {@see RegionInstanceGroupManagersClient::listAsync()} . * @@ -554,7 +598,8 @@ public function list(ListRegionInstanceGroupManagersRequest $request, array $cal } /** - * Lists all errors thrown by actions on instances for a given regional managed instance group. The filter and orderBy query parameters are not supported. + * Lists all errors thrown by actions on instances for a given regional + * managed instance group. The filter andorderBy query parameters are not supported. * * The async variant is {@see RegionInstanceGroupManagersClient::listErrorsAsync()} * . @@ -583,7 +628,12 @@ public function listErrors( } /** - * Lists the instances in the managed instance group and instances that are scheduled to be created. The list includes any current actions that the group has scheduled for its instances. The orderBy query parameter is not supported. The `pageToken` query parameter is supported only if the group's `listManagedInstancesResults` field is set to `PAGINATED`. + * Lists the instances in the managed instance group and instances that are + * scheduled to be created. The list includes any current actions + * that the group has scheduled for its instances. The orderBy + * query parameter is not supported. The `pageToken` query parameter is + * supported only if the group's `listManagedInstancesResults` field is set + * to `PAGINATED`. * * The async variant is * {@see RegionInstanceGroupManagersClient::listManagedInstancesAsync()} . @@ -612,7 +662,8 @@ public function listManagedInstances( } /** - * Lists all of the per-instance configurations defined for the managed instance group. The orderBy query parameter is not supported. + * Lists all of the per-instance configurations defined for the managed + * instance group. The orderBy query parameter is not supported. * * The async variant is * {@see RegionInstanceGroupManagersClient::listPerInstanceConfigsAsync()} . @@ -641,7 +692,21 @@ public function listPerInstanceConfigs( } /** - * Updates a managed instance group using the information that you specify in the request. This operation is marked as DONE when the group is patched even if the instances in the group are still in the process of being patched. You must separately verify the status of the individual instances with the listmanagedinstances method. This method supports PATCH semantics and uses the JSON merge patch format and processing rules. If you update your group to specify a new template or instance configuration, it's possible that your intended specification for each VM in the group is different from the current state of that VM. To learn how to apply an updated configuration to the VMs in a MIG, see Updating instances in a MIG. + * Updates a managed instance group using the information that you specify + * in the request. + * This operation is marked as DONE when the group is patched + * even if the instances in the group are still in the process of being + * patched. You must separately verify the status of the individual instances + * with the listmanagedinstances + * method. This method supportsPATCH + * semantics and uses theJSON merge + * patch format and processing rules. + * + * If you update your group to specify a new template or instance + * configuration, it's possible that your intended specification for each VM + * in the group is different from the current state of that VM. To learn how + * to apply an updated configuration to the VMs in a MIG, seeUpdating instances in + * a MIG. * * The async variant is {@see RegionInstanceGroupManagersClient::patchAsync()} . * @@ -667,7 +732,9 @@ public function patch(PatchRegionInstanceGroupManagerRequest $request, array $ca } /** - * Inserts or patches per-instance configurations for the managed instance group. perInstanceConfig.name serves as a key used to distinguish whether to perform insert or patch. + * Inserts or patches per-instance configurations for the managed instance + * group. perInstanceConfig.name serves as a key used to + * distinguish whether to perform insert or patch. * * The async variant is * {@see RegionInstanceGroupManagersClient::patchPerInstanceConfigsAsync()} . @@ -696,7 +763,19 @@ public function patchPerInstanceConfigs( } /** - * Flags the specified VM instances in the managed instance group to be immediately recreated. Each instance is recreated using the group's current configuration. This operation is marked as DONE when the flag is set even if the instances have not yet been recreated. You must separately verify the status of each instance by checking its currentAction field; for more information, see Checking the status of managed instances. If the group is part of a backend service that has enabled connection draining, it can take up to 60 seconds after the connection draining duration has elapsed before the VM instance is removed or deleted. You can specify a maximum of 1000 instances with this method per request. + * Flags the specified VM instances in the managed instance group to be + * immediately recreated. Each instance is recreated using the group's current + * configuration. This operation is marked as DONE when the flag + * is set even if the instances have not yet been recreated. You must + * separately verify the status of each instance by checking itscurrentAction field; for more information, see Checking + * the status of managed instances. + * + * If the group is part of a backend + * service that has enabled + * connection draining, it can take up to 60 seconds after the connection + * draining duration has elapsed before the VM instance is removed or deleted. + * + * You can specify a maximum of 1000 instances with this method per request. * * The async variant is * {@see RegionInstanceGroupManagersClient::recreateInstancesAsync()} . @@ -725,7 +804,19 @@ public function recreateInstances( } /** - * Changes the intended size of the managed instance group. If you increase the size, the group creates new instances using the current instance template. If you decrease the size, the group deletes one or more instances. The resize operation is marked DONE if the resize request is successful. The underlying actions take additional time. You must separately verify the status of the creating or deleting actions with the listmanagedinstances method. If the group is part of a backend service that has enabled connection draining, it can take up to 60 seconds after the connection draining duration has elapsed before the VM instance is removed or deleted. + * Changes the intended size of the managed instance group. If you increase + * the size, the group creates new instances using the current instance + * template. If you decrease the size, the group deletes one or more + * instances. + * + * The resize operation is marked DONE if theresize request is successful. The underlying actions take + * additional time. You must separately verify the status of thecreating or deleting actions with thelistmanagedinstances + * method. + * + * If the group is part of a backend + * service that has enabled + * connection draining, it can take up to 60 seconds after the connection + * draining duration has elapsed before the VM instance is removed or deleted. * * The async variant is {@see RegionInstanceGroupManagersClient::resizeAsync()} . * @@ -751,7 +842,22 @@ public function resize(ResizeRegionInstanceGroupManagerRequest $request, array $ } /** - * Flags the specified instances in the managed instance group to be resumed. This method increases the targetSize and decreases the targetSuspendedSize of the managed instance group by the number of instances that you resume. The resumeInstances operation is marked DONE if the resumeInstances request is successful. The underlying actions take additional time. You must separately verify the status of the RESUMING action with the listmanagedinstances method. In this request, you can only specify instances that are suspended. For example, if an instance was previously suspended using the suspendInstances method, it can be resumed using the resumeInstances method. If a health check is attached to the managed instance group, the specified instances will be verified as healthy after they are resumed. You can specify a maximum of 1000 instances with this method per request. + * Flags the specified instances in the managed instance group to be + * resumed. This method increases thetargetSize and decreases the targetSuspendedSize + * of the managed instance group by the number of instances that you resume. + * The resumeInstances operation is marked DONE if + * the resumeInstances request is successful. The underlying + * actions take additional time. You must separately verify the status of theRESUMING action with thelistmanagedinstances + * method. + * + * In this request, you can only specify instances that are suspended. For + * example, if an instance was previously suspended using the suspendInstances + * method, it can be resumed using the resumeInstances method. + * + * If a health check is attached to the managed instance group, the specified + * instances will be verified as healthy after they are resumed. + * + * You can specify a maximum of 1000 instances with this method per request. * * The async variant is * {@see RegionInstanceGroupManagersClient::resumeInstancesAsync()} . @@ -780,7 +886,8 @@ public function resumeInstances( } /** - * Sets the instance template to use when creating new instances or recreating instances in this group. Existing instances are not affected. + * Sets the instance template to use when creating new instances or recreating + * instances in this group. Existing instances are not affected. * * The async variant is * {@see RegionInstanceGroupManagersClient::setInstanceTemplateAsync()} . @@ -809,7 +916,8 @@ public function setInstanceTemplate( } /** - * Modifies the target pools to which all new instances in this group are assigned. Existing instances in the group are not affected. + * Modifies the target pools to which all new instances in this group are + * assigned. Existing instances in the group are not affected. * * The async variant is * {@see RegionInstanceGroupManagersClient::setTargetPoolsAsync()} . @@ -838,7 +946,22 @@ public function setTargetPools( } /** - * Flags the specified instances in the managed instance group to be started. This method increases the targetSize and decreases the targetStoppedSize of the managed instance group by the number of instances that you start. The startInstances operation is marked DONE if the startInstances request is successful. The underlying actions take additional time. You must separately verify the status of the STARTING action with the listmanagedinstances method. In this request, you can only specify instances that are stopped. For example, if an instance was previously stopped using the stopInstances method, it can be started using the startInstances method. If a health check is attached to the managed instance group, the specified instances will be verified as healthy after they are started. You can specify a maximum of 1000 instances with this method per request. + * Flags the specified instances in the managed instance group to be + * started. This method increases thetargetSize and decreases the targetStoppedSize + * of the managed instance group by the number of instances that you start. + * The startInstances operation is marked DONE if + * the startInstances request is successful. The underlying + * actions take additional time. You must separately verify the status of theSTARTING action with thelistmanagedinstances + * method. + * + * In this request, you can only specify instances that are stopped. For + * example, if an instance was previously stopped using the stopInstances + * method, it can be started using the startInstances method. + * + * If a health check is attached to the managed instance group, the specified + * instances will be verified as healthy after they are started. + * + * You can specify a maximum of 1000 instances with this method per request. * * The async variant is * {@see RegionInstanceGroupManagersClient::startInstancesAsync()} . @@ -867,7 +990,31 @@ public function startInstances( } /** - * Flags the specified instances in the managed instance group to be immediately stopped. You can only specify instances that are running in this request. This method reduces the targetSize and increases the targetStoppedSize of the managed instance group by the number of instances that you stop. The stopInstances operation is marked DONE if the stopInstances request is successful. The underlying actions take additional time. You must separately verify the status of the STOPPING action with the listmanagedinstances method. If the standbyPolicy.initialDelaySec field is set, the group delays stopping the instances until initialDelaySec have passed from instance.creationTimestamp (that is, when the instance was created). This delay gives your application time to set itself up and initialize on the instance. If more than initialDelaySec seconds have passed since instance.creationTimestamp when this method is called, there will be zero delay. If the group is part of a backend service that has enabled connection draining, it can take up to 60 seconds after the connection draining duration has elapsed before the VM instance is stopped. Stopped instances can be started using the startInstances method. You can specify a maximum of 1000 instances with this method per request. + * Flags the specified instances in the managed instance group to be + * immediately stopped. You can only specify instances that are running in + * this request. This method reduces thetargetSize and increases the targetStoppedSize + * of the managed instance group by the number of instances that you stop. + * The stopInstances operation is marked DONE if + * the stopInstances request is successful. The underlying + * actions take additional time. You must separately verify the status of theSTOPPING action with thelistmanagedinstances + * method. + * + * If the standbyPolicy.initialDelaySec field is set, the group + * delays stopping the instances until initialDelaySec have + * passed from instance.creationTimestamp (that is, when the + * instance was created). This delay gives your application time to + * set itself up and initialize on the instance. If more thaninitialDelaySec seconds have passed sinceinstance.creationTimestamp when this method is called, there + * will be zero delay. + * + * If the group is part of a backend + * service that has enabled + * connection draining, it can take up to 60 seconds after the connection + * draining duration has elapsed before the VM instance is stopped. + * + * Stopped instances can be started using the startInstances + * method. + * + * You can specify a maximum of 1000 instances with this method per request. * * The async variant is * {@see RegionInstanceGroupManagersClient::stopInstancesAsync()} . @@ -896,7 +1043,31 @@ public function stopInstances( } /** - * Flags the specified instances in the managed instance group to be immediately suspended. You can only specify instances that are running in this request. This method reduces the targetSize and increases the targetSuspendedSize of the managed instance group by the number of instances that you suspend. The suspendInstances operation is marked DONE if the suspendInstances request is successful. The underlying actions take additional time. You must separately verify the status of the SUSPENDING action with the listmanagedinstances method. If the standbyPolicy.initialDelaySec field is set, the group delays suspension of the instances until initialDelaySec have passed from instance.creationTimestamp (that is, when the instance was created). This delay gives your application time to set itself up and initialize on the instance. If more than initialDelaySec seconds have passed since instance.creationTimestamp when this method is called, there will be zero delay. If the group is part of a backend service that has enabled connection draining, it can take up to 60 seconds after the connection draining duration has elapsed before the VM instance is suspended. Suspended instances can be resumed using the resumeInstances method. You can specify a maximum of 1000 instances with this method per request. + * Flags the specified instances in the managed instance group to be + * immediately suspended. You can only specify instances that are running in + * this request. This method reduces thetargetSize and increases the targetSuspendedSize + * of the managed instance group by the number of instances that you suspend. + * The suspendInstances operation is marked DONE if + * the suspendInstances request is successful. The underlying + * actions take additional time. You must separately verify the status of theSUSPENDING action with thelistmanagedinstances + * method. + * + * If the standbyPolicy.initialDelaySec field is set, the group + * delays suspension of the instances until initialDelaySec have + * passed from instance.creationTimestamp (that is, when the + * instance was created). This delay gives your application time to + * set itself up and initialize on the instance. If more thaninitialDelaySec seconds have passed sinceinstance.creationTimestamp when this method is called, there + * will be zero delay. + * + * If the group is part of a backend + * service that has enabled + * connection draining, it can take up to 60 seconds after the connection + * draining duration has elapsed before the VM instance is suspended. + * + * Suspended instances can be resumed using the resumeInstances + * method. + * + * You can specify a maximum of 1000 instances with this method per request. * * The async variant is * {@see RegionInstanceGroupManagersClient::suspendInstancesAsync()} . @@ -925,7 +1096,9 @@ public function suspendInstances( } /** - * Inserts or updates per-instance configurations for the managed instance group. perInstanceConfig.name serves as a key used to distinguish whether to perform insert or patch. + * Inserts or updates per-instance configurations for the managed instance + * group. perInstanceConfig.name serves as a key used to + * distinguish whether to perform insert or patch. * * The async variant is * {@see RegionInstanceGroupManagersClient::updatePerInstanceConfigsAsync()} . diff --git a/Compute/src/V1/Client/RegionInstanceGroupsClient.php b/Compute/src/V1/Client/RegionInstanceGroupsClient.php index 463c50f9e463..fe1b18241d7a 100644 --- a/Compute/src/V1/Client/RegionInstanceGroupsClient.php +++ b/Compute/src/V1/Client/RegionInstanceGroupsClient.php @@ -295,7 +295,8 @@ public function get(GetRegionInstanceGroupRequest $request, array $callOptions = } /** - * Retrieves the list of instance group resources contained within the specified region. + * Retrieves the list of instance group resources contained within + * the specified region. * * The async variant is {@see RegionInstanceGroupsClient::listAsync()} . * @@ -321,7 +322,10 @@ public function list(ListRegionInstanceGroupsRequest $request, array $callOption } /** - * Lists the instances in the specified instance group and displays information about the named ports. Depending on the specified options, this method can list all instances or only the instances that are running. The orderBy query parameter is not supported. + * Lists the instances in the specified instance group and displays + * information about the named ports. Depending on the specified options, this + * method can list all instances or only the instances that are running. + * The orderBy query parameter is not supported. * * The async variant is {@see RegionInstanceGroupsClient::listInstancesAsync()} . * diff --git a/Compute/src/V1/Client/RegionInstanceTemplatesClient.php b/Compute/src/V1/Client/RegionInstanceTemplatesClient.php index 51b26b4c19eb..818ee206278f 100644 --- a/Compute/src/V1/Client/RegionInstanceTemplatesClient.php +++ b/Compute/src/V1/Client/RegionInstanceTemplatesClient.php @@ -267,7 +267,8 @@ public function __call($method, $args) } /** - * Deletes the specified instance template. Deleting an instance template is permanent and cannot be undone. + * Deletes the specified instance template. Deleting an instance template is + * permanent and cannot be undone. * * The async variant is {@see RegionInstanceTemplatesClient::deleteAsync()} . * @@ -319,7 +320,8 @@ public function get(GetRegionInstanceTemplateRequest $request, array $callOption } /** - * Creates an instance template in the specified project and region using the global instance template whose URL is included in the request. + * Creates an instance template in the specified project and region using the + * global instance template whose URL is included in the request. * * The async variant is {@see RegionInstanceTemplatesClient::insertAsync()} . * @@ -345,7 +347,8 @@ public function insert(InsertRegionInstanceTemplateRequest $request, array $call } /** - * Retrieves a list of instance templates that are contained within the specified project and region. + * Retrieves a list of instance templates that are contained within the + * specified project and region. * * The async variant is {@see RegionInstanceTemplatesClient::listAsync()} . * diff --git a/Compute/src/V1/Client/RegionInstancesClient.php b/Compute/src/V1/Client/RegionInstancesClient.php index 4e378e31fbbf..ce6f30785f7c 100644 --- a/Compute/src/V1/Client/RegionInstancesClient.php +++ b/Compute/src/V1/Client/RegionInstancesClient.php @@ -258,7 +258,8 @@ public function __call($method, $args) } /** - * Creates multiple instances in a given region. Count specifies the number of instances to create. + * Creates multiple instances in a given region. Count specifies the number of + * instances to create. * * The async variant is {@see RegionInstancesClient::bulkInsertAsync()} . * diff --git a/Compute/src/V1/Client/RegionInstantSnapshotsClient.php b/Compute/src/V1/Client/RegionInstantSnapshotsClient.php index 680c53afab39..f95f847f9d57 100644 --- a/Compute/src/V1/Client/RegionInstantSnapshotsClient.php +++ b/Compute/src/V1/Client/RegionInstantSnapshotsClient.php @@ -276,7 +276,14 @@ public function __call($method, $args) } /** - * Deletes the specified InstantSnapshot resource. Keep in mind that deleting a single instantSnapshot might not necessarily delete all the data on that instantSnapshot. If any data on the instantSnapshot that is marked for deletion is needed for subsequent instantSnapshots, the data will be moved to the next corresponding instantSnapshot. For more information, see Deleting instantSnapshots. + * Deletes the specified InstantSnapshot resource. Keep in mind that deleting + * a single instantSnapshot might not necessarily delete all the data on that + * instantSnapshot. If any data on the instantSnapshot that is marked for + * deletion is needed for subsequent instantSnapshots, the data will be moved + * to the next corresponding instantSnapshot. + * + * For more information, seeDeleting + * instantSnapshots. * * The async variant is {@see RegionInstantSnapshotsClient::deleteAsync()} . * @@ -328,7 +335,8 @@ public function get(GetRegionInstantSnapshotRequest $request, array $callOptions } /** - * Gets the access control policy for a resource. May be empty if no such policy or resource exists. + * Gets the access control policy for a resource. May be empty if no such + * policy or resource exists. * * The async variant is {@see RegionInstantSnapshotsClient::getIamPolicyAsync()} . * @@ -380,7 +388,8 @@ public function insert(InsertRegionInstantSnapshotRequest $request, array $callO } /** - * Retrieves the list of InstantSnapshot resources contained within the specified region. + * Retrieves the list of InstantSnapshot resources contained within + * the specified region. * * The async variant is {@see RegionInstantSnapshotsClient::listAsync()} . * @@ -406,7 +415,8 @@ public function list(ListRegionInstantSnapshotsRequest $request, array $callOpti } /** - * Sets the access control policy on the specified resource. Replaces any existing policy. + * Sets the access control policy on the specified resource. + * Replaces any existing policy. * * The async variant is {@see RegionInstantSnapshotsClient::setIamPolicyAsync()} . * @@ -432,7 +442,9 @@ public function setIamPolicy(SetIamPolicyRegionInstantSnapshotRequest $request, } /** - * Sets the labels on a instantSnapshot in the given region. To learn more about labels, read the Labeling Resources documentation. + * Sets the labels on a instantSnapshot in the given region. To learn more + * about labels, read the Labeling + * Resources documentation. * * The async variant is {@see RegionInstantSnapshotsClient::setLabelsAsync()} . * diff --git a/Compute/src/V1/Client/RegionNetworkEndpointGroupsClient.php b/Compute/src/V1/Client/RegionNetworkEndpointGroupsClient.php index fe10433505da..4b0b2d9cfe24 100644 --- a/Compute/src/V1/Client/RegionNetworkEndpointGroupsClient.php +++ b/Compute/src/V1/Client/RegionNetworkEndpointGroupsClient.php @@ -302,7 +302,8 @@ public function attachNetworkEndpoints( } /** - * Deletes the specified network endpoint group. Note that the NEG cannot be deleted if it is configured as a backend of a backend service. + * Deletes the specified network endpoint group. Note that the NEG cannot be + * deleted if it is configured as a backend of a backend service. * * The async variant is {@see RegionNetworkEndpointGroupsClient::deleteAsync()} . * @@ -383,7 +384,8 @@ public function get(GetRegionNetworkEndpointGroupRequest $request, array $callOp } /** - * Creates a network endpoint group in the specified project using the parameters that are included in the request. + * Creates a network endpoint group in the specified project using the + * parameters that are included in the request. * * The async variant is {@see RegionNetworkEndpointGroupsClient::insertAsync()} . * @@ -409,7 +411,8 @@ public function insert(InsertRegionNetworkEndpointGroupRequest $request, array $ } /** - * Retrieves the list of regional network endpoint groups available to the specified project in the given region. + * Retrieves the list of regional network endpoint groups available to the + * specified project in the given region. * * The async variant is {@see RegionNetworkEndpointGroupsClient::listAsync()} . * diff --git a/Compute/src/V1/Client/RegionNetworkFirewallPoliciesClient.php b/Compute/src/V1/Client/RegionNetworkFirewallPoliciesClient.php index 827d79b8f757..17ad135884ca 100644 --- a/Compute/src/V1/Client/RegionNetworkFirewallPoliciesClient.php +++ b/Compute/src/V1/Client/RegionNetworkFirewallPoliciesClient.php @@ -497,7 +497,8 @@ public function getEffectiveFirewalls( } /** - * Gets the access control policy for a resource. May be empty if no such policy or resource exists. + * Gets the access control policy for a resource. May be empty if no such + * policy or resource exists. * * The async variant is * {@see RegionNetworkFirewallPoliciesClient::getIamPolicyAsync()} . @@ -583,7 +584,8 @@ public function insert( } /** - * Lists all the network firewall policies that have been configured for the specified project in the given region. + * Lists all the network firewall policies that have been configured + * for the specified project in the given region. * * The async variant is {@see RegionNetworkFirewallPoliciesClient::listAsync()} . * @@ -722,7 +724,8 @@ public function removeRule( } /** - * Sets the access control policy on the specified resource. Replaces any existing policy. + * Sets the access control policy on the specified resource. + * Replaces any existing policy. * * The async variant is * {@see RegionNetworkFirewallPoliciesClient::setIamPolicyAsync()} . diff --git a/Compute/src/V1/Client/RegionNotificationEndpointsClient.php b/Compute/src/V1/Client/RegionNotificationEndpointsClient.php index 5401057ac69c..1306cf2d1ead 100644 --- a/Compute/src/V1/Client/RegionNotificationEndpointsClient.php +++ b/Compute/src/V1/Client/RegionNotificationEndpointsClient.php @@ -319,7 +319,8 @@ public function get(GetRegionNotificationEndpointRequest $request, array $callOp } /** - * Create a NotificationEndpoint in the specified project in the given region using the parameters that are included in the request. + * Create a NotificationEndpoint in the specified project in the given region + * using the parameters that are included in the request. * * The async variant is {@see RegionNotificationEndpointsClient::insertAsync()} . * diff --git a/Compute/src/V1/Client/RegionOperationsClient.php b/Compute/src/V1/Client/RegionOperationsClient.php index 99565441e181..75233a59da2a 100644 --- a/Compute/src/V1/Client/RegionOperationsClient.php +++ b/Compute/src/V1/Client/RegionOperationsClient.php @@ -250,7 +250,8 @@ public function get(GetRegionOperationRequest $request, array $callOptions = []) } /** - * Retrieves a list of Operation resources contained within the specified region. + * Retrieves a list of Operation resources contained within + * the specified region. * * The async variant is {@see RegionOperationsClient::listAsync()} . * @@ -276,7 +277,22 @@ public function list(ListRegionOperationsRequest $request, array $callOptions = } /** - * Waits for the specified Operation resource to return as `DONE` or for the request to approach the 2 minute deadline, and retrieves the specified Operation resource. This method differs from the `GET` method in that it waits for no more than the default deadline (2 minutes) and then returns the current state of the operation, which might be `DONE` or still in progress. This method is called on a best-effort basis. Specifically: - In uncommon cases, when the server is overloaded, the request might return before the default deadline is reached, or might return after zero seconds. - If the default deadline is reached, there is no guarantee that the operation is actually done when the method returns. Be prepared to retry if the operation is not `DONE`. + * Waits for the specified Operation resource to return as `DONE` + * or for the request to approach the 2 minute deadline, and retrieves the + * specified Operation resource. This method differs from the + * `GET` method in that it waits for no more than the default + * deadline (2 minutes) and then returns the current state of the operation, + * which might be `DONE` or still in progress. + * + * This method is called on a best-effort basis. Specifically: + * + * + * - In uncommon cases, when the server is overloaded, the request might + * return before the default deadline is reached, or might return after zero + * seconds. + * - If the default deadline is reached, there is no guarantee that the + * operation is actually done when the method returns. Be prepared to retry + * if the operation is not `DONE`. * * The async variant is {@see RegionOperationsClient::waitAsync()} . * diff --git a/Compute/src/V1/Client/RegionSecurityPoliciesClient.php b/Compute/src/V1/Client/RegionSecurityPoliciesClient.php index 934b9d15fcc7..62983cef389d 100644 --- a/Compute/src/V1/Client/RegionSecurityPoliciesClient.php +++ b/Compute/src/V1/Client/RegionSecurityPoliciesClient.php @@ -383,7 +383,8 @@ public function getRule(GetRuleRegionSecurityPolicyRequest $request, array $call } /** - * Creates a new policy in the specified project using the data included in the request. + * Creates a new policy in the specified project using the data included in + * the request. * * The async variant is {@see RegionSecurityPoliciesClient::insertAsync()} . * @@ -409,7 +410,8 @@ public function insert(InsertRegionSecurityPolicyRequest $request, array $callOp } /** - * List all the policies that have been configured for the specified project and region. + * List all the policies that have been configured for the specified project + * and region. * * The async variant is {@see RegionSecurityPoliciesClient::listAsync()} . * @@ -435,7 +437,11 @@ public function list(ListRegionSecurityPoliciesRequest $request, array $callOpti } /** - * Patches the specified policy with the data included in the request. To clear fields in the policy, leave the fields empty and specify them in the updateMask. This cannot be used to be update the rules in the policy. Please use the per rule methods like addRule, patchRule, and removeRule instead. + * Patches the specified policy with the data included in the request. To + * clear fields in the policy, leave the fields empty and specify them in the + * updateMask. This cannot be used to be update the rules in the policy. + * Please use the per rule methods like addRule, patchRule, and removeRule + * instead. * * The async variant is {@see RegionSecurityPoliciesClient::patchAsync()} . * @@ -461,7 +467,8 @@ public function patch(PatchRegionSecurityPolicyRequest $request, array $callOpti } /** - * Patches a rule at the specified priority. To clear fields in the rule, leave the fields empty and specify them in the updateMask. + * Patches a rule at the specified priority. To clear fields in the rule, + * leave the fields empty and specify them in the updateMask. * * The async variant is {@see RegionSecurityPoliciesClient::patchRuleAsync()} . * @@ -515,7 +522,9 @@ public function removeRule( } /** - * Sets the labels on a security policy. To learn more about labels, read the Labeling Resources documentation. + * Sets the labels on a security policy. To learn more about labels, + * read the Labeling Resources + * documentation. * * The async variant is {@see RegionSecurityPoliciesClient::setLabelsAsync()} . * diff --git a/Compute/src/V1/Client/RegionSslCertificatesClient.php b/Compute/src/V1/Client/RegionSslCertificatesClient.php index a5ee12f2466d..cd5ac8384242 100644 --- a/Compute/src/V1/Client/RegionSslCertificatesClient.php +++ b/Compute/src/V1/Client/RegionSslCertificatesClient.php @@ -292,7 +292,9 @@ public function delete(DeleteRegionSslCertificateRequest $request, array $callOp } /** - * Returns the specified SslCertificate resource in the specified region. Get a list of available SSL certificates by making a list() request. + * Returns the specified SslCertificate resource in the specified region. Get + * a list of available SSL certificates by making a list() + * request. * * The async variant is {@see RegionSslCertificatesClient::getAsync()} . * @@ -318,7 +320,8 @@ public function get(GetRegionSslCertificateRequest $request, array $callOptions } /** - * Creates a SslCertificate resource in the specified project and region using the data included in the request + * Creates a SslCertificate resource in the specified project and region using + * the data included in the request * * The async variant is {@see RegionSslCertificatesClient::insertAsync()} . * @@ -344,7 +347,8 @@ public function insert(InsertRegionSslCertificateRequest $request, array $callOp } /** - * Retrieves the list of SslCertificate resources available to the specified project in the specified region. + * Retrieves the list of SslCertificate resources available to the specified + * project in the specified region. * * The async variant is {@see RegionSslCertificatesClient::listAsync()} . * diff --git a/Compute/src/V1/Client/RegionSslPoliciesClient.php b/Compute/src/V1/Client/RegionSslPoliciesClient.php index 53e7073e43c1..330632d7acbc 100644 --- a/Compute/src/V1/Client/RegionSslPoliciesClient.php +++ b/Compute/src/V1/Client/RegionSslPoliciesClient.php @@ -271,7 +271,9 @@ public function __call($method, $args) } /** - * Deletes the specified SSL policy. The SSL policy resource can be deleted only if it is not in use by any TargetHttpsProxy or TargetSslProxy resources. + * Deletes the specified SSL policy. The SSL policy resource can be deleted + * only if it is not in use by any TargetHttpsProxy or TargetSslProxy + * resources. * * The async variant is {@see RegionSslPoliciesClient::deleteAsync()} . * @@ -323,7 +325,8 @@ public function get(GetRegionSslPolicyRequest $request, array $callOptions = []) } /** - * Creates a new policy in the specified project and region using the data included in the request. + * Creates a new policy in the specified project and region using the data + * included in the request. * * The async variant is {@see RegionSslPoliciesClient::insertAsync()} . * @@ -349,7 +352,8 @@ public function insert(InsertRegionSslPolicyRequest $request, array $callOptions } /** - * Lists all the SSL policies that have been configured for the specified project and region. + * Lists all the SSL policies that have been configured for the specified + * project and region. * * The async variant is {@see RegionSslPoliciesClient::listAsync()} . * @@ -375,7 +379,8 @@ public function list(ListRegionSslPoliciesRequest $request, array $callOptions = } /** - * Lists all features that can be specified in the SSL policy when using custom profile. + * Lists all features that can be specified in the SSL policy when using + * custom profile. * * The async variant is * {@see RegionSslPoliciesClient::listAvailableFeaturesAsync()} . diff --git a/Compute/src/V1/Client/RegionTargetHttpProxiesClient.php b/Compute/src/V1/Client/RegionTargetHttpProxiesClient.php index 9d753b3b850c..955492f02505 100644 --- a/Compute/src/V1/Client/RegionTargetHttpProxiesClient.php +++ b/Compute/src/V1/Client/RegionTargetHttpProxiesClient.php @@ -321,7 +321,8 @@ public function get(GetRegionTargetHttpProxyRequest $request, array $callOptions } /** - * Creates a TargetHttpProxy resource in the specified project and region using the data included in the request. + * Creates a TargetHttpProxy resource in the specified project and region + * using the data included in the request. * * The async variant is {@see RegionTargetHttpProxiesClient::insertAsync()} . * @@ -347,7 +348,8 @@ public function insert(InsertRegionTargetHttpProxyRequest $request, array $callO } /** - * Retrieves the list of TargetHttpProxy resources available to the specified project in the specified region. + * Retrieves the list of TargetHttpProxy resources available + * to the specified project in the specified region. * * The async variant is {@see RegionTargetHttpProxiesClient::listAsync()} . * diff --git a/Compute/src/V1/Client/RegionTargetHttpsProxiesClient.php b/Compute/src/V1/Client/RegionTargetHttpsProxiesClient.php index 8d8fe1c75820..fb5251949a46 100644 --- a/Compute/src/V1/Client/RegionTargetHttpsProxiesClient.php +++ b/Compute/src/V1/Client/RegionTargetHttpsProxiesClient.php @@ -325,7 +325,8 @@ public function get(GetRegionTargetHttpsProxyRequest $request, array $callOption } /** - * Creates a TargetHttpsProxy resource in the specified project and region using the data included in the request. + * Creates a TargetHttpsProxy resource in the specified project and region + * using the data included in the request. * * The async variant is {@see RegionTargetHttpsProxiesClient::insertAsync()} . * @@ -351,7 +352,8 @@ public function insert(InsertRegionTargetHttpsProxyRequest $request, array $call } /** - * Retrieves the list of TargetHttpsProxy resources available to the specified project in the specified region. + * Retrieves the list of TargetHttpsProxy resources available + * to the specified project in the specified region. * * The async variant is {@see RegionTargetHttpsProxiesClient::listAsync()} . * @@ -377,7 +379,10 @@ public function list(ListRegionTargetHttpsProxiesRequest $request, array $callOp } /** - * Patches the specified regional TargetHttpsProxy resource with the data included in the request. This method supports PATCH semantics and uses JSON merge patch format and processing rules. + * Patches the specified regional TargetHttpsProxy resource with the data + * included in the request. This method supports PATCH + * semantics and usesJSON merge + * patch format and processing rules. * * The async variant is {@see RegionTargetHttpsProxiesClient::patchAsync()} . * diff --git a/Compute/src/V1/Client/RegionTargetTcpProxiesClient.php b/Compute/src/V1/Client/RegionTargetTcpProxiesClient.php index 5da096ca238c..24b48dc0acb8 100644 --- a/Compute/src/V1/Client/RegionTargetTcpProxiesClient.php +++ b/Compute/src/V1/Client/RegionTargetTcpProxiesClient.php @@ -319,7 +319,8 @@ public function get(GetRegionTargetTcpProxyRequest $request, array $callOptions } /** - * Creates a TargetTcpProxy resource in the specified project and region using the data included in the request. + * Creates a TargetTcpProxy resource in the specified project and region using + * the data included in the request. * * The async variant is {@see RegionTargetTcpProxiesClient::insertAsync()} . * @@ -345,7 +346,8 @@ public function insert(InsertRegionTargetTcpProxyRequest $request, array $callOp } /** - * Retrieves a list of TargetTcpProxy resources available to the specified project in a given region. + * Retrieves a list of TargetTcpProxy resources + * available to the specified project in a given region. * * The async variant is {@see RegionTargetTcpProxiesClient::listAsync()} . * diff --git a/Compute/src/V1/Client/RegionUrlMapsClient.php b/Compute/src/V1/Client/RegionUrlMapsClient.php index 1684a1328e0c..da83f8dea5fd 100644 --- a/Compute/src/V1/Client/RegionUrlMapsClient.php +++ b/Compute/src/V1/Client/RegionUrlMapsClient.php @@ -325,7 +325,8 @@ public function get(GetRegionUrlMapRequest $request, array $callOptions = []): U } /** - * Creates a UrlMap resource in the specified project using the data included in the request. + * Creates a UrlMap resource in the specified project using + * the data included in the request. * * The async variant is {@see RegionUrlMapsClient::insertAsync()} . * @@ -351,7 +352,8 @@ public function insert(InsertRegionUrlMapRequest $request, array $callOptions = } /** - * Retrieves the list of UrlMap resources available to the specified project in the specified region. + * Retrieves the list of UrlMap resources available to the specified + * project in the specified region. * * The async variant is {@see RegionUrlMapsClient::listAsync()} . * @@ -377,7 +379,10 @@ public function list(ListRegionUrlMapsRequest $request, array $callOptions = []) } /** - * Patches the specified UrlMap resource with the data included in the request. This method supports PATCH semantics and uses JSON merge patch format and processing rules. + * Patches the specified UrlMap resource with the data included in the + * request. This method supportsPATCH + * semantics and usesJSON merge + * patch format and processing rules. * * The async variant is {@see RegionUrlMapsClient::patchAsync()} . * @@ -403,7 +408,8 @@ public function patch(PatchRegionUrlMapRequest $request, array $callOptions = [] } /** - * Updates the specified UrlMap resource with the data included in the request. + * Updates the specified UrlMap resource with the data included in the + * request. * * The async variant is {@see RegionUrlMapsClient::updateAsync()} . * @@ -429,7 +435,9 @@ public function update(UpdateRegionUrlMapRequest $request, array $callOptions = } /** - * Runs static validation for the UrlMap. In particular, the tests of the provided UrlMap will be run. Calling this method does NOT create the UrlMap. + * Runs static validation for the UrlMap. In particular, the tests of the + * provided UrlMap will be run. Calling this method does NOT create the + * UrlMap. * * The async variant is {@see RegionUrlMapsClient::validateAsync()} . * diff --git a/Compute/src/V1/Client/RegionZonesClient.php b/Compute/src/V1/Client/RegionZonesClient.php index b3b5bfeaf374..707bcbab9048 100644 --- a/Compute/src/V1/Client/RegionZonesClient.php +++ b/Compute/src/V1/Client/RegionZonesClient.php @@ -189,7 +189,8 @@ public function __call($method, $args) } /** - * Retrieves the list of Zone resources under the specific region available to the specified project. + * Retrieves the list of Zone resources under the specific region available to + * the specified project. * * The async variant is {@see RegionZonesClient::listAsync()} . * diff --git a/Compute/src/V1/Client/RegionsClient.php b/Compute/src/V1/Client/RegionsClient.php index 8e505829d94f..ec41d41390a1 100644 --- a/Compute/src/V1/Client/RegionsClient.php +++ b/Compute/src/V1/Client/RegionsClient.php @@ -192,7 +192,24 @@ public function __call($method, $args) } /** - * Returns the specified Region resource. To decrease latency for this method, you can optionally omit any unneeded information from the response by using a field mask. This practice is especially recommended for unused quota information (the `quotas` field). To exclude one or more fields, set your request's `fields` query parameter to only include the fields you need. For example, to only include the `id` and `selfLink` fields, add the query parameter `?fields=id,selfLink` to your request. This method fails if the quota information is unavailable for the region and if the organization policy constraint compute.requireBasicQuotaInResponse is enforced. This constraint, when enforced, disables the fail-open behaviour when quota information (the `items.quotas` field) is unavailable for the region. It is recommended to use the default setting for the constraint unless your application requires the fail-closed behaviour for this method. + * Returns the specified Region resource. + * + * To decrease latency for this method, you can optionally omit any unneeded + * information from the response by using a field mask. This practice is + * especially recommended for unused quota information (the `quotas` field). + * To exclude one or more fields, set your request's `fields` query parameter + * to only include the fields you need. For example, to only include the `id` + * and `selfLink` fields, add the query parameter `?fields=id,selfLink` to + * your request. + * + * This method fails if the quota information is unavailable for the region + * and if the organization policy constraint + * compute.requireBasicQuotaInResponse is enforced. This + * constraint, when enforced, disables the fail-open behaviour when quota + * information (the `items.quotas` field) is unavailable for the region. + * It is recommended to use the default setting + * for the constraint unless your application requires the fail-closed + * behaviour for this method. * * The async variant is {@see RegionsClient::getAsync()} . * @@ -218,7 +235,25 @@ public function get(GetRegionRequest $request, array $callOptions = []): Region } /** - * Retrieves the list of region resources available to the specified project. To decrease latency for this method, you can optionally omit any unneeded information from the response by using a field mask. This practice is especially recommended for unused quota information (the `items.quotas` field). To exclude one or more fields, set your request's `fields` query parameter to only include the fields you need. For example, to only include the `id` and `selfLink` fields, add the query parameter `?fields=id,selfLink` to your request. This method fails if the quota information is unavailable for the region and if the organization policy constraint compute.requireBasicQuotaInResponse is enforced. This constraint, when enforced, disables the fail-open behaviour when quota information (the `items.quotas` field) is unavailable for the region. It is recommended to use the default setting for the constraint unless your application requires the fail-closed behaviour for this method. + * Retrieves the list of region resources available to the specified project. + * + * To decrease latency for this method, you can optionally omit any unneeded + * information from the response by using a field mask. This practice is + * especially recommended for unused quota information + * (the `items.quotas` field). + * To exclude one or more fields, set your request's `fields` query parameter + * to only include the fields you need. For example, to only include the `id` + * and `selfLink` fields, add the query parameter `?fields=id,selfLink` to + * your request. + * + * This method fails if the quota information is unavailable for the region + * and if the organization policy constraint + * compute.requireBasicQuotaInResponse is enforced. This + * constraint, when enforced, disables the fail-open behaviour when quota + * information (the `items.quotas` field) is unavailable for the region. + * It is recommended to use the default setting + * for the constraint unless your application requires the fail-closed + * behaviour for this method. * * The async variant is {@see RegionsClient::listAsync()} . * diff --git a/Compute/src/V1/Client/ReservationBlocksClient.php b/Compute/src/V1/Client/ReservationBlocksClient.php index 5bd6c47c2b9c..c02bcf53ec80 100644 --- a/Compute/src/V1/Client/ReservationBlocksClient.php +++ b/Compute/src/V1/Client/ReservationBlocksClient.php @@ -34,10 +34,15 @@ use Google\ApiCore\Transport\TransportInterface; use Google\ApiCore\ValidationException; use Google\Auth\FetchAuthTokenInterface; +use Google\Cloud\Compute\V1\GetIamPolicyReservationBlockRequest; use Google\Cloud\Compute\V1\GetReservationBlockRequest; use Google\Cloud\Compute\V1\ListReservationBlocksRequest; use Google\Cloud\Compute\V1\PerformMaintenanceReservationBlockRequest; +use Google\Cloud\Compute\V1\Policy; use Google\Cloud\Compute\V1\ReservationBlocksGetResponse; +use Google\Cloud\Compute\V1\SetIamPolicyReservationBlockRequest; +use Google\Cloud\Compute\V1\TestIamPermissionsReservationBlockRequest; +use Google\Cloud\Compute\V1\TestPermissionsResponse; use GuzzleHttp\Promise\PromiseInterface; use Psr\Log\LoggerInterface; @@ -48,8 +53,11 @@ * calls that map to API methods. * * @method PromiseInterface getAsync(GetReservationBlockRequest $request, array $optionalArgs = []) + * @method PromiseInterface getIamPolicyAsync(GetIamPolicyReservationBlockRequest $request, array $optionalArgs = []) * @method PromiseInterface listAsync(ListReservationBlocksRequest $request, array $optionalArgs = []) * @method PromiseInterface performMaintenanceAsync(PerformMaintenanceReservationBlockRequest $request, array $optionalArgs = []) + * @method PromiseInterface setIamPolicyAsync(SetIamPolicyReservationBlockRequest $request, array $optionalArgs = []) + * @method PromiseInterface testIamPermissionsAsync(TestIamPermissionsReservationBlockRequest $request, array $optionalArgs = []) */ final class ReservationBlocksClient { @@ -289,6 +297,33 @@ public function get(GetReservationBlockRequest $request, array $callOptions = [] return $this->startApiCall('Get', $request, $callOptions)->wait(); } + /** + * Gets the access control policy for a resource. May be empty if no such + * policy or resource exists. + * + * The async variant is {@see ReservationBlocksClient::getIamPolicyAsync()} . + * + * @example samples/V1/ReservationBlocksClient/get_iam_policy.php + * + * @param GetIamPolicyReservationBlockRequest $request A request to house fields associated with the call. + * @param array $callOptions { + * Optional. + * + * @type RetrySettings|array $retrySettings + * Retry settings to use for this call. Can be a {@see RetrySettings} object, or an + * associative array of retry settings parameters. See the documentation on + * {@see RetrySettings} for example usage. + * } + * + * @return Policy + * + * @throws ApiException Thrown if the API call fails. + */ + public function getIamPolicy(GetIamPolicyReservationBlockRequest $request, array $callOptions = []): Policy + { + return $this->startApiCall('GetIamPolicy', $request, $callOptions)->wait(); + } + /** * Retrieves a list of reservation blocks under a single reservation. * @@ -342,4 +377,59 @@ public function performMaintenance( ): OperationResponse { return $this->startApiCall('PerformMaintenance', $request, $callOptions)->wait(); } + + /** + * Sets the access control policy on the specified resource. + * Replaces any existing policy. + * + * The async variant is {@see ReservationBlocksClient::setIamPolicyAsync()} . + * + * @example samples/V1/ReservationBlocksClient/set_iam_policy.php + * + * @param SetIamPolicyReservationBlockRequest $request A request to house fields associated with the call. + * @param array $callOptions { + * Optional. + * + * @type RetrySettings|array $retrySettings + * Retry settings to use for this call. Can be a {@see RetrySettings} object, or an + * associative array of retry settings parameters. See the documentation on + * {@see RetrySettings} for example usage. + * } + * + * @return Policy + * + * @throws ApiException Thrown if the API call fails. + */ + public function setIamPolicy(SetIamPolicyReservationBlockRequest $request, array $callOptions = []): Policy + { + return $this->startApiCall('SetIamPolicy', $request, $callOptions)->wait(); + } + + /** + * Returns permissions that a caller has on the specified resource. + * + * The async variant is {@see ReservationBlocksClient::testIamPermissionsAsync()} . + * + * @example samples/V1/ReservationBlocksClient/test_iam_permissions.php + * + * @param TestIamPermissionsReservationBlockRequest $request A request to house fields associated with the call. + * @param array $callOptions { + * Optional. + * + * @type RetrySettings|array $retrySettings + * Retry settings to use for this call. Can be a {@see RetrySettings} object, or an + * associative array of retry settings parameters. See the documentation on + * {@see RetrySettings} for example usage. + * } + * + * @return TestPermissionsResponse + * + * @throws ApiException Thrown if the API call fails. + */ + public function testIamPermissions( + TestIamPermissionsReservationBlockRequest $request, + array $callOptions = [] + ): TestPermissionsResponse { + return $this->startApiCall('TestIamPermissions', $request, $callOptions)->wait(); + } } diff --git a/Compute/src/V1/Client/ReservationSubBlocksClient.php b/Compute/src/V1/Client/ReservationSubBlocksClient.php index 9c6a27adedd8..e08350fbe962 100644 --- a/Compute/src/V1/Client/ReservationSubBlocksClient.php +++ b/Compute/src/V1/Client/ReservationSubBlocksClient.php @@ -34,11 +34,16 @@ use Google\ApiCore\Transport\TransportInterface; use Google\ApiCore\ValidationException; use Google\Auth\FetchAuthTokenInterface; +use Google\Cloud\Compute\V1\GetIamPolicyReservationSubBlockRequest; use Google\Cloud\Compute\V1\GetReservationSubBlockRequest; use Google\Cloud\Compute\V1\ListReservationSubBlocksRequest; use Google\Cloud\Compute\V1\PerformMaintenanceReservationSubBlockRequest; +use Google\Cloud\Compute\V1\Policy; use Google\Cloud\Compute\V1\ReportFaultyReservationSubBlockRequest; use Google\Cloud\Compute\V1\ReservationSubBlocksGetResponse; +use Google\Cloud\Compute\V1\SetIamPolicyReservationSubBlockRequest; +use Google\Cloud\Compute\V1\TestIamPermissionsReservationSubBlockRequest; +use Google\Cloud\Compute\V1\TestPermissionsResponse; use GuzzleHttp\Promise\PromiseInterface; use Psr\Log\LoggerInterface; @@ -49,9 +54,12 @@ * calls that map to API methods. * * @method PromiseInterface getAsync(GetReservationSubBlockRequest $request, array $optionalArgs = []) + * @method PromiseInterface getIamPolicyAsync(GetIamPolicyReservationSubBlockRequest $request, array $optionalArgs = []) * @method PromiseInterface listAsync(ListReservationSubBlocksRequest $request, array $optionalArgs = []) * @method PromiseInterface performMaintenanceAsync(PerformMaintenanceReservationSubBlockRequest $request, array $optionalArgs = []) * @method PromiseInterface reportFaultyAsync(ReportFaultyReservationSubBlockRequest $request, array $optionalArgs = []) + * @method PromiseInterface setIamPolicyAsync(SetIamPolicyReservationSubBlockRequest $request, array $optionalArgs = []) + * @method PromiseInterface testIamPermissionsAsync(TestIamPermissionsReservationSubBlockRequest $request, array $optionalArgs = []) */ final class ReservationSubBlocksClient { @@ -293,6 +301,33 @@ public function get( return $this->startApiCall('Get', $request, $callOptions)->wait(); } + /** + * Gets the access control policy for a resource. May be empty if no such + * policy or resource exists. + * + * The async variant is {@see ReservationSubBlocksClient::getIamPolicyAsync()} . + * + * @example samples/V1/ReservationSubBlocksClient/get_iam_policy.php + * + * @param GetIamPolicyReservationSubBlockRequest $request A request to house fields associated with the call. + * @param array $callOptions { + * Optional. + * + * @type RetrySettings|array $retrySettings + * Retry settings to use for this call. Can be a {@see RetrySettings} object, or an + * associative array of retry settings parameters. See the documentation on + * {@see RetrySettings} for example usage. + * } + * + * @return Policy + * + * @throws ApiException Thrown if the API call fails. + */ + public function getIamPolicy(GetIamPolicyReservationSubBlockRequest $request, array $callOptions = []): Policy + { + return $this->startApiCall('GetIamPolicy', $request, $callOptions)->wait(); + } + /** * Retrieves a list of reservation subBlocks under a single reservation. * @@ -375,4 +410,60 @@ public function reportFaulty( ): OperationResponse { return $this->startApiCall('ReportFaulty', $request, $callOptions)->wait(); } + + /** + * Sets the access control policy on the specified resource. + * Replaces any existing policy. + * + * The async variant is {@see ReservationSubBlocksClient::setIamPolicyAsync()} . + * + * @example samples/V1/ReservationSubBlocksClient/set_iam_policy.php + * + * @param SetIamPolicyReservationSubBlockRequest $request A request to house fields associated with the call. + * @param array $callOptions { + * Optional. + * + * @type RetrySettings|array $retrySettings + * Retry settings to use for this call. Can be a {@see RetrySettings} object, or an + * associative array of retry settings parameters. See the documentation on + * {@see RetrySettings} for example usage. + * } + * + * @return Policy + * + * @throws ApiException Thrown if the API call fails. + */ + public function setIamPolicy(SetIamPolicyReservationSubBlockRequest $request, array $callOptions = []): Policy + { + return $this->startApiCall('SetIamPolicy', $request, $callOptions)->wait(); + } + + /** + * Returns permissions that a caller has on the specified resource. + * + * The async variant is + * {@see ReservationSubBlocksClient::testIamPermissionsAsync()} . + * + * @example samples/V1/ReservationSubBlocksClient/test_iam_permissions.php + * + * @param TestIamPermissionsReservationSubBlockRequest $request A request to house fields associated with the call. + * @param array $callOptions { + * Optional. + * + * @type RetrySettings|array $retrySettings + * Retry settings to use for this call. Can be a {@see RetrySettings} object, or an + * associative array of retry settings parameters. See the documentation on + * {@see RetrySettings} for example usage. + * } + * + * @return TestPermissionsResponse + * + * @throws ApiException Thrown if the API call fails. + */ + public function testIamPermissions( + TestIamPermissionsReservationSubBlockRequest $request, + array $callOptions = [] + ): TestPermissionsResponse { + return $this->startApiCall('TestIamPermissions', $request, $callOptions)->wait(); + } } diff --git a/Compute/src/V1/Client/ReservationsClient.php b/Compute/src/V1/Client/ReservationsClient.php index 43182fc5f448..6c22ff80bc3c 100644 --- a/Compute/src/V1/Client/ReservationsClient.php +++ b/Compute/src/V1/Client/ReservationsClient.php @@ -282,7 +282,10 @@ public function __call($method, $args) } /** - * Retrieves an aggregated list of reservations. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. + * Retrieves an aggregated list of reservations. + * + * To prevent failure, it is recommended that you set the + * `returnPartialSuccess` parameter to `true`. * * The async variant is {@see ReservationsClient::aggregatedListAsync()} . * @@ -362,7 +365,8 @@ public function get(GetReservationRequest $request, array $callOptions = []): Re } /** - * Gets the access control policy for a resource. May be empty if no such policy or resource exists. + * Gets the access control policy for a resource. May be empty if no such + * policy or resource exists. * * The async variant is {@see ReservationsClient::getIamPolicyAsync()} . * @@ -388,7 +392,8 @@ public function getIamPolicy(GetIamPolicyReservationRequest $request, array $cal } /** - * Creates a new reservation. For more information, read Reserving zonal resources. + * Creates a new reservation. For more information, readReserving zonal + * resources. * * The async variant is {@see ReservationsClient::insertAsync()} . * @@ -414,7 +419,8 @@ public function insert(InsertReservationRequest $request, array $callOptions = [ } /** - * A list of all the reservations that have been configured for the specified project in specified zone. + * A list of all the reservations that have been configured for the + * specified project in specified zone. * * The async variant is {@see ReservationsClient::listAsync()} . * @@ -468,7 +474,9 @@ public function performMaintenance( } /** - * Resizes the reservation (applicable to standalone reservations only). For more information, read Modifying reservations. + * Resizes the reservation (applicable to standalone reservations only). For + * more information, readModifying + * reservations. * * The async variant is {@see ReservationsClient::resizeAsync()} . * @@ -494,7 +502,8 @@ public function resize(ResizeReservationRequest $request, array $callOptions = [ } /** - * Sets the access control policy on the specified resource. Replaces any existing policy. + * Sets the access control policy on the specified resource. + * Replaces any existing policy. * * The async variant is {@see ReservationsClient::setIamPolicyAsync()} . * diff --git a/Compute/src/V1/Client/ResourcePoliciesClient.php b/Compute/src/V1/Client/ResourcePoliciesClient.php index 89cf33319930..60bc686d0f8e 100644 --- a/Compute/src/V1/Client/ResourcePoliciesClient.php +++ b/Compute/src/V1/Client/ResourcePoliciesClient.php @@ -278,7 +278,10 @@ public function __call($method, $args) } /** - * Retrieves an aggregated list of resource policies. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. + * Retrieves an aggregated list of resource policies. + * + * To prevent failure, Google recommends that you set the + * `returnPartialSuccess` parameter to `true`. * * The async variant is {@see ResourcePoliciesClient::aggregatedListAsync()} . * @@ -358,7 +361,8 @@ public function get(GetResourcePolicyRequest $request, array $callOptions = []): } /** - * Gets the access control policy for a resource. May be empty if no such policy or resource exists. + * Gets the access control policy for a resource. May be empty if no such + * policy or resource exists. * * The async variant is {@see ResourcePoliciesClient::getIamPolicyAsync()} . * @@ -410,7 +414,8 @@ public function insert(InsertResourcePolicyRequest $request, array $callOptions } /** - * A list all the resource policies that have been configured for the specified project in specified region. + * A list all the resource policies that have been configured for the + * specified project in specified region. * * The async variant is {@see ResourcePoliciesClient::listAsync()} . * @@ -462,7 +467,8 @@ public function patch(PatchResourcePolicyRequest $request, array $callOptions = } /** - * Sets the access control policy on the specified resource. Replaces any existing policy. + * Sets the access control policy on the specified resource. + * Replaces any existing policy. * * The async variant is {@see ResourcePoliciesClient::setIamPolicyAsync()} . * diff --git a/Compute/src/V1/Client/RoutersClient.php b/Compute/src/V1/Client/RoutersClient.php index c3b835397d56..238c9eeeab68 100644 --- a/Compute/src/V1/Client/RoutersClient.php +++ b/Compute/src/V1/Client/RoutersClient.php @@ -296,7 +296,10 @@ public function __call($method, $args) } /** - * Retrieves an aggregated list of routers. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. + * Retrieves an aggregated list of routers. + * + * To prevent failure, Google recommends that you set the + * `returnPartialSuccess` parameter to `true`. * * The async variant is {@see RoutersClient::aggregatedListAsync()} . * @@ -512,7 +515,8 @@ public function getRouterStatus( } /** - * Creates a Router resource in the specified project and region using the data included in the request. + * Creates a Router resource in the specified project and region using + * the data included in the request. * * The async variant is {@see RoutersClient::insertAsync()} . * @@ -590,7 +594,8 @@ public function listBgpRoutes(ListBgpRoutesRoutersRequest $request, array $callO } /** - * Retrieves a list of router route policy subresources available to the specified project. + * Retrieves a list of router route policy subresources available to the + * specified project. * * The async variant is {@see RoutersClient::listRoutePoliciesAsync()} . * @@ -618,7 +623,10 @@ public function listRoutePolicies( } /** - * Patches the specified Router resource with the data included in the request. This method supports PATCH semantics and uses JSON merge patch format and processing rules. + * Patches the specified Router resource with the data included in the + * request. This method supportsPATCH + * semantics and usesJSON merge + * patch format and processing rules. * * The async variant is {@see RoutersClient::patchAsync()} . * @@ -670,7 +678,8 @@ public function patchRoutePolicy(PatchRoutePolicyRouterRequest $request, array $ } /** - * Preview fields auto-generated during router create and update operations. Calling this method does NOT create or update the router. + * Preview fields auto-generated during router create andupdate operations. + * Calling this method does NOT create or update the router. * * The async variant is {@see RoutersClient::previewAsync()} . * @@ -696,7 +705,10 @@ public function preview(PreviewRouterRequest $request, array $callOptions = []): } /** - * Updates the specified Router resource with the data included in the request. This method conforms to PUT semantics, which requests that the state of the target resource be created or replaced with the state defined by the representation enclosed in the request message payload. + * Updates the specified Router resource with the data included in the + * request. This method conforms toPUT semantics, which requests that the state of the + * target resource be created or replaced with the state defined by the + * representation enclosed in the request message payload. * * The async variant is {@see RoutersClient::updateAsync()} . * diff --git a/Compute/src/V1/Client/RoutesClient.php b/Compute/src/V1/Client/RoutesClient.php index 82f972decabd..f16d83e8afe7 100644 --- a/Compute/src/V1/Client/RoutesClient.php +++ b/Compute/src/V1/Client/RoutesClient.php @@ -318,7 +318,8 @@ public function get(GetRouteRequest $request, array $callOptions = []): Route } /** - * Creates a Route resource in the specified project using the data included in the request. + * Creates a Route resource in the specified project using the data included + * in the request. * * The async variant is {@see RoutesClient::insertAsync()} . * diff --git a/Compute/src/V1/Client/SecurityPoliciesClient.php b/Compute/src/V1/Client/SecurityPoliciesClient.php index bd50975d4e93..432d3cc4eb34 100644 --- a/Compute/src/V1/Client/SecurityPoliciesClient.php +++ b/Compute/src/V1/Client/SecurityPoliciesClient.php @@ -310,7 +310,11 @@ public function addRule(AddRuleSecurityPolicyRequest $request, array $callOption } /** - * Retrieves the list of all SecurityPolicy resources, regional and global, available to the specified project. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. + * Retrieves the list of all SecurityPolicy resources, regional and global, + * available to the specified project. + * + * To prevent failure, Google recommends that you set the + * `returnPartialSuccess` parameter to `true`. * * The async variant is {@see SecurityPoliciesClient::aggregatedListAsync()} . * @@ -416,7 +420,8 @@ public function getRule(GetRuleSecurityPolicyRequest $request, array $callOption } /** - * Creates a new policy in the specified project using the data included in the request. + * Creates a new policy in the specified project using the data included in + * the request. * * The async variant is {@see SecurityPoliciesClient::insertAsync()} . * @@ -468,7 +473,8 @@ public function list(ListSecurityPoliciesRequest $request, array $callOptions = } /** - * Gets the current list of preconfigured Web Application Firewall (WAF) expressions. + * Gets the current list of preconfigured Web Application Firewall (WAF) + * expressions. * * The async variant is * {@see SecurityPoliciesClient::listPreconfiguredExpressionSetsAsync()} . @@ -497,7 +503,11 @@ public function listPreconfiguredExpressionSets( } /** - * Patches the specified policy with the data included in the request. To clear fields in the policy, leave the fields empty and specify them in the updateMask. This cannot be used to be update the rules in the policy. Please use the per rule methods like addRule, patchRule, and removeRule instead. + * Patches the specified policy with the data included in the request. To + * clear fields in the policy, leave the fields empty and specify them in the + * updateMask. This cannot be used to be update the rules in the policy. + * Please use the per rule methods like addRule, patchRule, and removeRule + * instead. * * The async variant is {@see SecurityPoliciesClient::patchAsync()} . * @@ -523,7 +533,8 @@ public function patch(PatchSecurityPolicyRequest $request, array $callOptions = } /** - * Patches a rule at the specified priority. To clear fields in the rule, leave the fields empty and specify them in the updateMask. + * Patches a rule at the specified priority. To clear fields in the rule, + * leave the fields empty and specify them in the updateMask. * * The async variant is {@see SecurityPoliciesClient::patchRuleAsync()} . * @@ -575,7 +586,9 @@ public function removeRule(RemoveRuleSecurityPolicyRequest $request, array $call } /** - * Sets the labels on a security policy. To learn more about labels, read the Labeling Resources documentation. + * Sets the labels on a security policy. To learn more about labels, + * read the Labeling Resources + * documentation. * * The async variant is {@see SecurityPoliciesClient::setLabelsAsync()} . * diff --git a/Compute/src/V1/Client/ServiceAttachmentsClient.php b/Compute/src/V1/Client/ServiceAttachmentsClient.php index cd2a7725af1f..83f79fd72c7e 100644 --- a/Compute/src/V1/Client/ServiceAttachmentsClient.php +++ b/Compute/src/V1/Client/ServiceAttachmentsClient.php @@ -278,7 +278,11 @@ public function __call($method, $args) } /** - * Retrieves the list of all ServiceAttachment resources, regional and global, available to the specified project. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. + * Retrieves the list of all ServiceAttachment resources, + * regional and global, available to the specified project. + * + * To prevent failure, Google recommends that you set the + * `returnPartialSuccess` parameter to `true`. * * The async variant is {@see ServiceAttachmentsClient::aggregatedListAsync()} . * @@ -358,7 +362,8 @@ public function get(GetServiceAttachmentRequest $request, array $callOptions = [ } /** - * Gets the access control policy for a resource. May be empty if no such policy or resource exists. + * Gets the access control policy for a resource. May be empty if no such + * policy or resource exists. * * The async variant is {@see ServiceAttachmentsClient::getIamPolicyAsync()} . * @@ -384,7 +389,8 @@ public function getIamPolicy(GetIamPolicyServiceAttachmentRequest $request, arra } /** - * Creates a ServiceAttachment in the specified project in the given scope using the parameters that are included in the request. + * Creates a ServiceAttachment in the specified project in the given scope + * using the parameters that are included in the request. * * The async variant is {@see ServiceAttachmentsClient::insertAsync()} . * @@ -436,7 +442,10 @@ public function list(ListServiceAttachmentsRequest $request, array $callOptions } /** - * Patches the specified ServiceAttachment resource with the data included in the request. This method supports PATCH semantics and uses JSON merge patch format and processing rules. + * Patches the specified ServiceAttachment resource with the data included in + * the request. This method supports PATCH + * semantics and usesJSON merge + * patch format and processing rules. * * The async variant is {@see ServiceAttachmentsClient::patchAsync()} . * @@ -462,7 +471,8 @@ public function patch(PatchServiceAttachmentRequest $request, array $callOptions } /** - * Sets the access control policy on the specified resource. Replaces any existing policy. + * Sets the access control policy on the specified resource. + * Replaces any existing policy. * * The async variant is {@see ServiceAttachmentsClient::setIamPolicyAsync()} . * diff --git a/Compute/src/V1/Client/SnapshotsClient.php b/Compute/src/V1/Client/SnapshotsClient.php index 68d56955f577..c9159e9b006e 100644 --- a/Compute/src/V1/Client/SnapshotsClient.php +++ b/Compute/src/V1/Client/SnapshotsClient.php @@ -276,7 +276,14 @@ public function __call($method, $args) } /** - * Deletes the specified Snapshot resource. Keep in mind that deleting a single snapshot might not necessarily delete all the data on that snapshot. If any data on the snapshot that is marked for deletion is needed for subsequent snapshots, the data will be moved to the next corresponding snapshot. For more information, see Deleting snapshots. + * Deletes the specified Snapshot resource. Keep in mind that deleting + * a single snapshot might not necessarily delete all the data on that + * snapshot. If any data on the snapshot that is marked for deletion is + * needed for subsequent snapshots, the data will be moved to the next + * corresponding snapshot. + * + * For more information, seeDeleting + * snapshots. * * The async variant is {@see SnapshotsClient::deleteAsync()} . * @@ -328,7 +335,8 @@ public function get(GetSnapshotRequest $request, array $callOptions = []): Snaps } /** - * Gets the access control policy for a resource. May be empty if no such policy or resource exists. + * Gets the access control policy for a resource. May be empty if no such + * policy or resource exists. * * The async variant is {@see SnapshotsClient::getIamPolicyAsync()} . * @@ -354,7 +362,11 @@ public function getIamPolicy(GetIamPolicySnapshotRequest $request, array $callOp } /** - * Creates a snapshot in the specified project using the data included in the request. For regular snapshot creation, consider using this method instead of disks.createSnapshot, as this method supports more features, such as creating snapshots in a project different from the source disk project. + * Creates a snapshot in the specified project using the data included + * in the request. For regular snapshot creation, consider using this method + * instead of disks.createSnapshot, + * as this method supports more features, such as creating snapshots in a + * project different from the source disk project. * * The async variant is {@see SnapshotsClient::insertAsync()} . * @@ -380,7 +392,8 @@ public function insert(InsertSnapshotRequest $request, array $callOptions = []): } /** - * Retrieves the list of Snapshot resources contained within the specified project. + * Retrieves the list of Snapshot resources contained within + * the specified project. * * The async variant is {@see SnapshotsClient::listAsync()} . * @@ -406,7 +419,8 @@ public function list(ListSnapshotsRequest $request, array $callOptions = []): Pa } /** - * Sets the access control policy on the specified resource. Replaces any existing policy. + * Sets the access control policy on the specified resource. + * Replaces any existing policy. * * The async variant is {@see SnapshotsClient::setIamPolicyAsync()} . * @@ -432,7 +446,8 @@ public function setIamPolicy(SetIamPolicySnapshotRequest $request, array $callOp } /** - * Sets the labels on a snapshot. To learn more about labels, read the Labeling Resources documentation. + * Sets the labels on a snapshot. To learn more about labels, read theLabeling + * Resources documentation. * * The async variant is {@see SnapshotsClient::setLabelsAsync()} . * diff --git a/Compute/src/V1/Client/SslCertificatesClient.php b/Compute/src/V1/Client/SslCertificatesClient.php index 028bbd24f2df..10a2093138b1 100644 --- a/Compute/src/V1/Client/SslCertificatesClient.php +++ b/Compute/src/V1/Client/SslCertificatesClient.php @@ -268,7 +268,11 @@ public function __call($method, $args) } /** - * Retrieves the list of all SslCertificate resources, regional and global, available to the specified project. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. + * Retrieves the list of all SslCertificate resources, regional and global, + * available to the specified project. + * + * To prevent failure, Google recommends that you set the + * `returnPartialSuccess` parameter to `true`. * * The async variant is {@see SslCertificatesClient::aggregatedListAsync()} . * @@ -348,7 +352,8 @@ public function get(GetSslCertificateRequest $request, array $callOptions = []): } /** - * Creates a SslCertificate resource in the specified project using the data included in the request. + * Creates a SslCertificate resource in the specified project using the data + * included in the request. * * The async variant is {@see SslCertificatesClient::insertAsync()} . * @@ -374,7 +379,8 @@ public function insert(InsertSslCertificateRequest $request, array $callOptions } /** - * Retrieves the list of SslCertificate resources available to the specified project. + * Retrieves the list of SslCertificate resources available to the specified + * project. * * The async variant is {@see SslCertificatesClient::listAsync()} . * diff --git a/Compute/src/V1/Client/SslPoliciesClient.php b/Compute/src/V1/Client/SslPoliciesClient.php index 68bb3340552c..e0360b40a7b3 100644 --- a/Compute/src/V1/Client/SslPoliciesClient.php +++ b/Compute/src/V1/Client/SslPoliciesClient.php @@ -273,7 +273,11 @@ public function __call($method, $args) } /** - * Retrieves the list of all SslPolicy resources, regional and global, available to the specified project. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. + * Retrieves the list of all SslPolicy resources, regional and global, + * available to the specified project. + * + * To prevent failure, Google recommends that you set the + * `returnPartialSuccess` parameter to `true`. * * The async variant is {@see SslPoliciesClient::aggregatedListAsync()} . * @@ -301,7 +305,9 @@ public function aggregatedList( } /** - * Deletes the specified SSL policy. The SSL policy resource can be deleted only if it is not in use by any TargetHttpsProxy or TargetSslProxy resources. + * Deletes the specified SSL policy. The SSL policy resource can be deleted + * only if it is not in use by any TargetHttpsProxy or TargetSslProxy + * resources. * * The async variant is {@see SslPoliciesClient::deleteAsync()} . * @@ -379,7 +385,8 @@ public function insert(InsertSslPolicyRequest $request, array $callOptions = []) } /** - * Lists all the SSL policies that have been configured for the specified project. + * Lists all the SSL policies that have been configured for the specified + * project. * * The async variant is {@see SslPoliciesClient::listAsync()} . * @@ -405,7 +412,8 @@ public function list(ListSslPoliciesRequest $request, array $callOptions = []): } /** - * Lists all features that can be specified in the SSL policy when using custom profile. + * Lists all features that can be specified in the SSL policy when using + * custom profile. * * The async variant is {@see SslPoliciesClient::listAvailableFeaturesAsync()} . * diff --git a/Compute/src/V1/Client/StoragePoolTypesClient.php b/Compute/src/V1/Client/StoragePoolTypesClient.php index f5e2a1e7a02c..f7ba1915d0e9 100644 --- a/Compute/src/V1/Client/StoragePoolTypesClient.php +++ b/Compute/src/V1/Client/StoragePoolTypesClient.php @@ -194,7 +194,10 @@ public function __call($method, $args) } /** - * Retrieves an aggregated list of storage pool types. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. + * Retrieves an aggregated list of storage pool types. + * + * To prevent failure, Google recommends that you set the + * `returnPartialSuccess` parameter to `true`. * * The async variant is {@see StoragePoolTypesClient::aggregatedListAsync()} . * @@ -248,7 +251,8 @@ public function get(GetStoragePoolTypeRequest $request, array $callOptions = []) } /** - * Retrieves a list of storage pool types available to the specified project. + * Retrieves a list of storage pool types available to the specified + * project. * * The async variant is {@see StoragePoolTypesClient::listAsync()} . * diff --git a/Compute/src/V1/Client/StoragePoolsClient.php b/Compute/src/V1/Client/StoragePoolsClient.php index 692f7efd1892..92547a4da8b3 100644 --- a/Compute/src/V1/Client/StoragePoolsClient.php +++ b/Compute/src/V1/Client/StoragePoolsClient.php @@ -280,7 +280,10 @@ public function __call($method, $args) } /** - * Retrieves an aggregated list of storage pools. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. + * Retrieves an aggregated list of storage pools. + * + * To prevent failure, Google recommends that you set the + * `returnPartialSuccess` parameter to `true`. * * The async variant is {@see StoragePoolsClient::aggregatedListAsync()} . * @@ -308,7 +311,11 @@ public function aggregatedList( } /** - * Deletes the specified storage pool. Deleting a storagePool removes its data permanently and is irreversible. However, deleting a storagePool does not delete any snapshots previously made from the storagePool. You must separately delete snapshots. + * Deletes the specified storage pool. Deleting a storagePool + * removes its data permanently and is irreversible. However, deleting a + * storagePool does not delete any snapshots previously + * made from the storagePool. You must separately delete + * snapshots. * * The async variant is {@see StoragePoolsClient::deleteAsync()} . * @@ -334,7 +341,8 @@ public function delete(DeleteStoragePoolRequest $request, array $callOptions = [ } /** - * Returns a specified storage pool. Gets a list of available storage pools by making a list() request. + * Returns a specified storage pool. Gets a list of available + * storage pools by making a list() request. * * The async variant is {@see StoragePoolsClient::getAsync()} . * @@ -360,7 +368,8 @@ public function get(GetStoragePoolRequest $request, array $callOptions = []): St } /** - * Gets the access control policy for a resource. May be empty if no such policy or resource exists. + * Gets the access control policy for a resource. May be empty if no such + * policy or resource exists. * * The async variant is {@see StoragePoolsClient::getIamPolicyAsync()} . * @@ -386,7 +395,8 @@ public function getIamPolicy(GetIamPolicyStoragePoolRequest $request, array $cal } /** - * Creates a storage pool in the specified project using the data in the request. + * Creates a storage pool in the specified project using the data + * in the request. * * The async variant is {@see StoragePoolsClient::insertAsync()} . * @@ -412,7 +422,8 @@ public function insert(InsertStoragePoolRequest $request, array $callOptions = [ } /** - * Retrieves a list of storage pools contained within the specified zone. + * Retrieves a list of storage pools contained within + * the specified zone. * * The async variant is {@see StoragePoolsClient::listAsync()} . * @@ -464,7 +475,8 @@ public function listDisks(ListDisksStoragePoolsRequest $request, array $callOpti } /** - * Sets the access control policy on the specified resource. Replaces any existing policy. + * Sets the access control policy on the specified resource. + * Replaces any existing policy. * * The async variant is {@see StoragePoolsClient::setIamPolicyAsync()} . * @@ -518,7 +530,11 @@ public function testIamPermissions( } /** - * Updates the specified storagePool with the data included in the request. The update is performed only on selected fields included as part of update-mask. Only the following fields can be modified: pool_provisioned_capacity_gb, pool_provisioned_iops and pool_provisioned_throughput. + * Updates the specified storagePool with the data included in the request. + * The update is performed only on selected fields included as part + * of update-mask. Only the following fields can be modified: + * pool_provisioned_capacity_gb, pool_provisioned_iops and + * pool_provisioned_throughput. * * The async variant is {@see StoragePoolsClient::updateAsync()} . * diff --git a/Compute/src/V1/Client/SubnetworksClient.php b/Compute/src/V1/Client/SubnetworksClient.php index f6f0cb9c28e8..e8082cdefad2 100644 --- a/Compute/src/V1/Client/SubnetworksClient.php +++ b/Compute/src/V1/Client/SubnetworksClient.php @@ -284,7 +284,10 @@ public function __call($method, $args) } /** - * Retrieves an aggregated list of subnetworks. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. + * Retrieves an aggregated list of subnetworks. + * + * To prevent failure, Google recommends that you set the + * `returnPartialSuccess` parameter to `true`. * * The async variant is {@see SubnetworksClient::aggregatedListAsync()} . * @@ -392,7 +395,8 @@ public function get(GetSubnetworkRequest $request, array $callOptions = []): Sub } /** - * Gets the access control policy for a resource. May be empty if no such policy or resource exists. + * Gets the access control policy for a resource. May be empty if no such + * policy or resource exists. * * The async variant is {@see SubnetworksClient::getIamPolicyAsync()} . * @@ -418,7 +422,8 @@ public function getIamPolicy(GetIamPolicySubnetworkRequest $request, array $call } /** - * Creates a subnetwork in the specified project using the data included in the request. + * Creates a subnetwork in the specified project using the data + * included in the request. * * The async variant is {@see SubnetworksClient::insertAsync()} . * @@ -444,7 +449,8 @@ public function insert(InsertSubnetworkRequest $request, array $callOptions = [] } /** - * Retrieves a list of subnetworks available to the specified project. + * Retrieves a list of subnetworks available to the specified + * project. * * The async variant is {@see SubnetworksClient::listAsync()} . * @@ -496,7 +502,11 @@ public function listUsable(ListUsableSubnetworksRequest $request, array $callOpt } /** - * Patches the specified subnetwork with the data included in the request. Only certain fields can be updated with a patch request as indicated in the field descriptions. You must specify the current fingerprint of the subnetwork resource being patched. + * Patches the specified subnetwork with the data included in the request. + * Only certain fields can be updated with a patch request + * as indicated in the field descriptions. + * You must specify the current fingerprint of the + * subnetwork resource being patched. * * The async variant is {@see SubnetworksClient::patchAsync()} . * @@ -522,7 +532,8 @@ public function patch(PatchSubnetworkRequest $request, array $callOptions = []): } /** - * Sets the access control policy on the specified resource. Replaces any existing policy. + * Sets the access control policy on the specified resource. + * Replaces any existing policy. * * The async variant is {@see SubnetworksClient::setIamPolicyAsync()} . * @@ -548,7 +559,8 @@ public function setIamPolicy(SetIamPolicySubnetworkRequest $request, array $call } /** - * Set whether VMs in this subnet can access Google services without assigning external IP addresses through Private Google Access. + * Set whether VMs in this subnet can access Google services without assigning + * external IP addresses through Private Google Access. * * The async variant is {@see SubnetworksClient::setPrivateIpGoogleAccessAsync()} . * diff --git a/Compute/src/V1/Client/TargetGrpcProxiesClient.php b/Compute/src/V1/Client/TargetGrpcProxiesClient.php index 09308f28671a..d14c83c06317 100644 --- a/Compute/src/V1/Client/TargetGrpcProxiesClient.php +++ b/Compute/src/V1/Client/TargetGrpcProxiesClient.php @@ -320,7 +320,8 @@ public function get(GetTargetGrpcProxyRequest $request, array $callOptions = []) } /** - * Creates a TargetGrpcProxy in the specified project in the given scope using the parameters that are included in the request. + * Creates a TargetGrpcProxy in the specified project in the given scope + * using the parameters that are included in the request. * * The async variant is {@see TargetGrpcProxiesClient::insertAsync()} . * @@ -372,7 +373,10 @@ public function list(ListTargetGrpcProxiesRequest $request, array $callOptions = } /** - * Patches the specified TargetGrpcProxy resource with the data included in the request. This method supports PATCH semantics and uses JSON merge patch format and processing rules. + * Patches the specified TargetGrpcProxy resource with the data included in + * the request. This method supports PATCH + * semantics and usesJSON merge + * patch format and processing rules. * * The async variant is {@see TargetGrpcProxiesClient::patchAsync()} . * diff --git a/Compute/src/V1/Client/TargetHttpProxiesClient.php b/Compute/src/V1/Client/TargetHttpProxiesClient.php index f5d8419c7f21..d35b827d275b 100644 --- a/Compute/src/V1/Client/TargetHttpProxiesClient.php +++ b/Compute/src/V1/Client/TargetHttpProxiesClient.php @@ -272,7 +272,11 @@ public function __call($method, $args) } /** - * Retrieves the list of all TargetHttpProxy resources, regional and global, available to the specified project. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. + * Retrieves the list of all TargetHttpProxy resources, regional and global, + * available to the specified project. + * + * To prevent failure, Google recommends that you set the + * `returnPartialSuccess` parameter to `true`. * * The async variant is {@see TargetHttpProxiesClient::aggregatedListAsync()} . * @@ -352,7 +356,8 @@ public function get(GetTargetHttpProxyRequest $request, array $callOptions = []) } /** - * Creates a TargetHttpProxy resource in the specified project using the data included in the request. + * Creates a TargetHttpProxy resource in the specified + * project using the data included in the request. * * The async variant is {@see TargetHttpProxiesClient::insertAsync()} . * @@ -378,7 +383,8 @@ public function insert(InsertTargetHttpProxyRequest $request, array $callOptions } /** - * Retrieves the list of TargetHttpProxy resources available to the specified project. + * Retrieves the list of TargetHttpProxy resources available + * to the specified project. * * The async variant is {@see TargetHttpProxiesClient::listAsync()} . * @@ -404,7 +410,10 @@ public function list(ListTargetHttpProxiesRequest $request, array $callOptions = } /** - * Patches the specified TargetHttpProxy resource with the data included in the request. This method supports PATCH semantics and uses JSON merge patch format and processing rules. + * Patches the specified TargetHttpProxy resource with the data included in + * the request. This method supports PATCH + * semantics and usesJSON merge + * patch format and processing rules. * * The async variant is {@see TargetHttpProxiesClient::patchAsync()} . * diff --git a/Compute/src/V1/Client/TargetHttpsProxiesClient.php b/Compute/src/V1/Client/TargetHttpsProxiesClient.php index 60b862f54d02..5df263b86045 100644 --- a/Compute/src/V1/Client/TargetHttpsProxiesClient.php +++ b/Compute/src/V1/Client/TargetHttpsProxiesClient.php @@ -280,7 +280,11 @@ public function __call($method, $args) } /** - * Retrieves the list of all TargetHttpsProxy resources, regional and global, available to the specified project. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. + * Retrieves the list of all TargetHttpsProxy resources, regional and global, + * available to the specified project. + * + * To prevent failure, Google recommends that you set the + * `returnPartialSuccess` parameter to `true`. * * The async variant is {@see TargetHttpsProxiesClient::aggregatedListAsync()} . * @@ -360,7 +364,8 @@ public function get(GetTargetHttpsProxyRequest $request, array $callOptions = [] } /** - * Creates a TargetHttpsProxy resource in the specified project using the data included in the request. + * Creates a TargetHttpsProxy resource in the specified + * project using the data included in the request. * * The async variant is {@see TargetHttpsProxiesClient::insertAsync()} . * @@ -386,7 +391,8 @@ public function insert(InsertTargetHttpsProxyRequest $request, array $callOption } /** - * Retrieves the list of TargetHttpsProxy resources available to the specified project. + * Retrieves the list of TargetHttpsProxy resources + * available to the specified project. * * The async variant is {@see TargetHttpsProxiesClient::listAsync()} . * @@ -412,7 +418,10 @@ public function list(ListTargetHttpsProxiesRequest $request, array $callOptions } /** - * Patches the specified TargetHttpsProxy resource with the data included in the request. This method supports PATCH semantics and uses JSON merge patch format and processing rules. + * Patches the specified TargetHttpsProxy resource with the data included in + * the request. This method supports PATCH + * semantics and usesJSON merge + * patch format and processing rules. * * The async variant is {@see TargetHttpsProxiesClient::patchAsync()} . * @@ -523,7 +532,10 @@ public function setSslCertificates( } /** - * Sets the SSL policy for TargetHttpsProxy. The SSL policy specifies the server-side support for SSL features. This affects connections between clients and the HTTPS proxy load balancer. They do not affect the connection between the load balancer and the backends. + * Sets the SSL policy for TargetHttpsProxy. The SSL policy specifies the + * server-side support for SSL features. This affects connections between + * clients and the HTTPS proxy load balancer. They do not affect the + * connection between the load balancer and the backends. * * The async variant is {@see TargetHttpsProxiesClient::setSslPolicyAsync()} . * diff --git a/Compute/src/V1/Client/TargetInstancesClient.php b/Compute/src/V1/Client/TargetInstancesClient.php index 34a90c3e0324..66bbd5ef7951 100644 --- a/Compute/src/V1/Client/TargetInstancesClient.php +++ b/Compute/src/V1/Client/TargetInstancesClient.php @@ -273,7 +273,10 @@ public function __call($method, $args) } /** - * Retrieves an aggregated list of target instances. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. + * Retrieves an aggregated list of target instances. + * + * To prevent failure, Google recommends that you set the + * `returnPartialSuccess` parameter to `true`. * * The async variant is {@see TargetInstancesClient::aggregatedListAsync()} . * @@ -353,7 +356,8 @@ public function get(GetTargetInstanceRequest $request, array $callOptions = []): } /** - * Creates a TargetInstance resource in the specified project and zone using the data included in the request. + * Creates a TargetInstance resource in the specified project and zone using + * the data included in the request. * * The async variant is {@see TargetInstancesClient::insertAsync()} . * @@ -379,7 +383,8 @@ public function insert(InsertTargetInstanceRequest $request, array $callOptions } /** - * Retrieves a list of TargetInstance resources available to the specified project and zone. + * Retrieves a list of TargetInstance resources available to the specified + * project and zone. * * The async variant is {@see TargetInstancesClient::listAsync()} . * @@ -405,7 +410,9 @@ public function list(ListTargetInstancesRequest $request, array $callOptions = [ } /** - * Sets the Google Cloud Armor security policy for the specified target instance. For more information, see Google Cloud Armor Overview + * Sets the Google Cloud Armor security policy for the specified target + * instance. For more information, seeGoogle + * Cloud Armor Overview * * The async variant is {@see TargetInstancesClient::setSecurityPolicyAsync()} . * diff --git a/Compute/src/V1/Client/TargetPoolsClient.php b/Compute/src/V1/Client/TargetPoolsClient.php index aab9490615c5..c12b4a1814e6 100644 --- a/Compute/src/V1/Client/TargetPoolsClient.php +++ b/Compute/src/V1/Client/TargetPoolsClient.php @@ -338,7 +338,10 @@ public function addInstance(AddInstanceTargetPoolRequest $request, array $callOp } /** - * Retrieves an aggregated list of target pools. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. + * Retrieves an aggregated list of target pools. + * + * To prevent failure, Google recommends that you set the + * `returnPartialSuccess` parameter to `true`. * * The async variant is {@see TargetPoolsClient::aggregatedListAsync()} . * @@ -418,7 +421,8 @@ public function get(GetTargetPoolRequest $request, array $callOptions = []): Tar } /** - * Gets the most recent health check results for each IP for the instance that is referenced by the given target pool. + * Gets the most recent health check results for each IP for the + * instance that is referenced by the given target pool. * * The async variant is {@see TargetPoolsClient::getHealthAsync()} . * @@ -444,7 +448,8 @@ public function getHealth(GetHealthTargetPoolRequest $request, array $callOption } /** - * Creates a target pool in the specified project and region using the data included in the request. + * Creates a target pool in the specified project and region using + * the data included in the request. * * The async variant is {@see TargetPoolsClient::insertAsync()} . * @@ -470,7 +475,8 @@ public function insert(InsertTargetPoolRequest $request, array $callOptions = [] } /** - * Retrieves a list of target pools available to the specified project and region. + * Retrieves a list of target pools available to the specified + * project and region. * * The async variant is {@see TargetPoolsClient::listAsync()} . * @@ -576,7 +582,9 @@ public function setBackup(SetBackupTargetPoolRequest $request, array $callOption } /** - * Sets the Google Cloud Armor security policy for the specified target pool. For more information, see Google Cloud Armor Overview + * Sets the Google Cloud Armor security policy for the specified target pool. + * For more information, seeGoogle + * Cloud Armor Overview * * The async variant is {@see TargetPoolsClient::setSecurityPolicyAsync()} . * diff --git a/Compute/src/V1/Client/TargetSslProxiesClient.php b/Compute/src/V1/Client/TargetSslProxiesClient.php index 05ff2f5f6b85..720cf3035996 100644 --- a/Compute/src/V1/Client/TargetSslProxiesClient.php +++ b/Compute/src/V1/Client/TargetSslProxiesClient.php @@ -328,7 +328,8 @@ public function get(GetTargetSslProxyRequest $request, array $callOptions = []): } /** - * Creates a TargetSslProxy resource in the specified project using the data included in the request. + * Creates a TargetSslProxy resource in the specified project using + * the data included in the request. * * The async variant is {@see TargetSslProxiesClient::insertAsync()} . * @@ -354,7 +355,8 @@ public function insert(InsertTargetSslProxyRequest $request, array $callOptions } /** - * Retrieves the list of TargetSslProxy resources available to the specified project. + * Retrieves the list of TargetSslProxy resources + * available to the specified project. * * The async variant is {@see TargetSslProxiesClient::listAsync()} . * @@ -492,7 +494,10 @@ public function setSslCertificates( } /** - * Sets the SSL policy for TargetSslProxy. The SSL policy specifies the server-side support for SSL features. This affects connections between clients and the load balancer. They do not affect the connection between the load balancer and the backends. + * Sets the SSL policy for TargetSslProxy. The SSL policy specifies the + * server-side support for SSL features. This affects connections between + * clients and the load balancer. They do not affect the + * connection between the load balancer and the backends. * * The async variant is {@see TargetSslProxiesClient::setSslPolicyAsync()} . * diff --git a/Compute/src/V1/Client/TargetTcpProxiesClient.php b/Compute/src/V1/Client/TargetTcpProxiesClient.php index 9a553ea5a496..f2c9d7f688b9 100644 --- a/Compute/src/V1/Client/TargetTcpProxiesClient.php +++ b/Compute/src/V1/Client/TargetTcpProxiesClient.php @@ -272,7 +272,11 @@ public function __call($method, $args) } /** - * Retrieves the list of all TargetTcpProxy resources, regional and global, available to the specified project. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. + * Retrieves the list of all TargetTcpProxy resources, regional and global, + * available to the specified project. + * + * To prevent failure, Google recommends that you set the + * `returnPartialSuccess` parameter to `true`. * * The async variant is {@see TargetTcpProxiesClient::aggregatedListAsync()} . * @@ -352,7 +356,8 @@ public function get(GetTargetTcpProxyRequest $request, array $callOptions = []): } /** - * Creates a TargetTcpProxy resource in the specified project using the data included in the request. + * Creates a TargetTcpProxy resource in the specified project using + * the data included in the request. * * The async variant is {@see TargetTcpProxiesClient::insertAsync()} . * @@ -378,7 +383,8 @@ public function insert(InsertTargetTcpProxyRequest $request, array $callOptions } /** - * Retrieves the list of TargetTcpProxy resources available to the specified project. + * Retrieves the list of TargetTcpProxy resources + * available to the specified project. * * The async variant is {@see TargetTcpProxiesClient::listAsync()} . * diff --git a/Compute/src/V1/Client/TargetVpnGatewaysClient.php b/Compute/src/V1/Client/TargetVpnGatewaysClient.php index 978af91607bd..f743caae7779 100644 --- a/Compute/src/V1/Client/TargetVpnGatewaysClient.php +++ b/Compute/src/V1/Client/TargetVpnGatewaysClient.php @@ -270,7 +270,10 @@ public function __call($method, $args) } /** - * Retrieves an aggregated list of target VPN gateways. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. + * Retrieves an aggregated list of target VPN gateways. + * + * To prevent failure, Google recommends that you set the + * `returnPartialSuccess` parameter to `true`. * * The async variant is {@see TargetVpnGatewaysClient::aggregatedListAsync()} . * @@ -350,7 +353,8 @@ public function get(GetTargetVpnGatewayRequest $request, array $callOptions = [] } /** - * Creates a target VPN gateway in the specified project and region using the data included in the request. + * Creates a target VPN gateway in the specified project and region using + * the data included in the request. * * The async variant is {@see TargetVpnGatewaysClient::insertAsync()} . * @@ -376,7 +380,8 @@ public function insert(InsertTargetVpnGatewayRequest $request, array $callOption } /** - * Retrieves a list of target VPN gateways available to the specified project and region. + * Retrieves a list of target VPN gateways available to the specified + * project and region. * * The async variant is {@see TargetVpnGatewaysClient::listAsync()} . * @@ -402,7 +407,8 @@ public function list(ListTargetVpnGatewaysRequest $request, array $callOptions = } /** - * Sets the labels on a TargetVpnGateway. To learn more about labels, read the Labeling Resources documentation. + * Sets the labels on a TargetVpnGateway. To learn more about labels, read theLabeling + * Resources documentation. * * The async variant is {@see TargetVpnGatewaysClient::setLabelsAsync()} . * diff --git a/Compute/src/V1/Client/UrlMapsClient.php b/Compute/src/V1/Client/UrlMapsClient.php index 4eb4ec858cfc..843ef62ea687 100644 --- a/Compute/src/V1/Client/UrlMapsClient.php +++ b/Compute/src/V1/Client/UrlMapsClient.php @@ -277,7 +277,11 @@ public function __call($method, $args) } /** - * Retrieves the list of all UrlMap resources, regional and global, available to the specified project. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. + * Retrieves the list of all UrlMap resources, regional and global, + * available to the specified project. + * + * To prevent failure, Google recommends that you set the + * `returnPartialSuccess` parameter to `true`. * * The async variant is {@see UrlMapsClient::aggregatedListAsync()} . * @@ -355,7 +359,8 @@ public function get(GetUrlMapRequest $request, array $callOptions = []): UrlMap } /** - * Creates a UrlMap resource in the specified project using the data included in the request. + * Creates a UrlMap resource in the specified project using + * the data included in the request. * * The async variant is {@see UrlMapsClient::insertAsync()} . * @@ -381,7 +386,11 @@ public function insert(InsertUrlMapRequest $request, array $callOptions = []): O } /** - * Initiates a cache invalidation operation, invalidating the specified path, scoped to the specified UrlMap. For more information, see [Invalidating cached content](/cdn/docs/invalidating-cached-content). + * Initiates a cache invalidation operation, invalidating the specified path, + * scoped to the specified UrlMap. + * + * For more information, see [Invalidating cached + * content](/cdn/docs/invalidating-cached-content). * * The async variant is {@see UrlMapsClient::invalidateCacheAsync()} . * @@ -407,7 +416,8 @@ public function invalidateCache(InvalidateCacheUrlMapRequest $request, array $ca } /** - * Retrieves the list of UrlMap resources available to the specified project. + * Retrieves the list of UrlMap resources available to the specified + * project. * * The async variant is {@see UrlMapsClient::listAsync()} . * @@ -433,7 +443,10 @@ public function list(ListUrlMapsRequest $request, array $callOptions = []): Page } /** - * Patches the specified UrlMap resource with the data included in the request. This method supports PATCH semantics and uses the JSON merge patch format and processing rules. + * Patches the specified UrlMap resource with the data included in the + * request. This method supportsPATCH + * semantics and uses theJSON merge + * patch format and processing rules. * * The async variant is {@see UrlMapsClient::patchAsync()} . * @@ -459,7 +472,8 @@ public function patch(PatchUrlMapRequest $request, array $callOptions = []): Ope } /** - * Updates the specified UrlMap resource with the data included in the request. + * Updates the specified UrlMap resource with the data included in the + * request. * * The async variant is {@see UrlMapsClient::updateAsync()} . * @@ -485,7 +499,9 @@ public function update(UpdateUrlMapRequest $request, array $callOptions = []): O } /** - * Runs static validation for the UrlMap. In particular, the tests of the provided UrlMap will be run. Calling this method does NOT create the UrlMap. + * Runs static validation for the UrlMap. In particular, the tests of the + * provided UrlMap will be run. Calling this method does NOT create the + * UrlMap. * * The async variant is {@see UrlMapsClient::validateAsync()} . * diff --git a/Compute/src/V1/Client/VpnGatewaysClient.php b/Compute/src/V1/Client/VpnGatewaysClient.php index 538f5bb0ba89..18f4f9b5b932 100644 --- a/Compute/src/V1/Client/VpnGatewaysClient.php +++ b/Compute/src/V1/Client/VpnGatewaysClient.php @@ -276,7 +276,10 @@ public function __call($method, $args) } /** - * Retrieves an aggregated list of VPN gateways. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. + * Retrieves an aggregated list of VPN gateways. + * + * To prevent failure, Google recommends that you set the + * `returnPartialSuccess` parameter to `true`. * * The async variant is {@see VpnGatewaysClient::aggregatedListAsync()} . * @@ -384,7 +387,8 @@ public function getStatus( } /** - * Creates a VPN gateway in the specified project and region using the data included in the request. + * Creates a VPN gateway in the specified project and region using + * the data included in the request. * * The async variant is {@see VpnGatewaysClient::insertAsync()} . * @@ -410,7 +414,8 @@ public function insert(InsertVpnGatewayRequest $request, array $callOptions = [] } /** - * Retrieves a list of VPN gateways available to the specified project and region. + * Retrieves a list of VPN gateways available to the specified + * project and region. * * The async variant is {@see VpnGatewaysClient::listAsync()} . * @@ -436,7 +441,8 @@ public function list(ListVpnGatewaysRequest $request, array $callOptions = []): } /** - * Sets the labels on a VpnGateway. To learn more about labels, read the Labeling Resources documentation. + * Sets the labels on a VpnGateway. To learn more about labels, read theLabeling + * Resources documentation. * * The async variant is {@see VpnGatewaysClient::setLabelsAsync()} . * diff --git a/Compute/src/V1/Client/VpnTunnelsClient.php b/Compute/src/V1/Client/VpnTunnelsClient.php index b2f60b027738..d186de3bc355 100644 --- a/Compute/src/V1/Client/VpnTunnelsClient.php +++ b/Compute/src/V1/Client/VpnTunnelsClient.php @@ -270,7 +270,10 @@ public function __call($method, $args) } /** - * Retrieves an aggregated list of VPN tunnels. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`. + * Retrieves an aggregated list of VPN tunnels. + * + * To prevent failure, Google recommends that you set the + * `returnPartialSuccess` parameter to `true`. * * The async variant is {@see VpnTunnelsClient::aggregatedListAsync()} . * @@ -348,7 +351,8 @@ public function get(GetVpnTunnelRequest $request, array $callOptions = []): VpnT } /** - * Creates a VpnTunnel resource in the specified project and region using the data included in the request. + * Creates a VpnTunnel resource in the specified project and region using + * the data included in the request. * * The async variant is {@see VpnTunnelsClient::insertAsync()} . * @@ -374,7 +378,8 @@ public function insert(InsertVpnTunnelRequest $request, array $callOptions = []) } /** - * Retrieves a list of VpnTunnel resources contained in the specified project and region. + * Retrieves a list of VpnTunnel resources contained in the specified + * project and region. * * The async variant is {@see VpnTunnelsClient::listAsync()} . * @@ -400,7 +405,8 @@ public function list(ListVpnTunnelsRequest $request, array $callOptions = []): P } /** - * Sets the labels on a VpnTunnel. To learn more about labels, read the Labeling Resources documentation. + * Sets the labels on a VpnTunnel. To learn more about labels, read theLabeling + * Resources documentation. * * The async variant is {@see VpnTunnelsClient::setLabelsAsync()} . * diff --git a/Compute/src/V1/Client/WireGroupsClient.php b/Compute/src/V1/Client/WireGroupsClient.php new file mode 100644 index 000000000000..3f30a13f14f0 --- /dev/null +++ b/Compute/src/V1/Client/WireGroupsClient.php @@ -0,0 +1,403 @@ + deleteAsync(DeleteWireGroupRequest $request, array $optionalArgs = []) + * @method PromiseInterface getAsync(GetWireGroupRequest $request, array $optionalArgs = []) + * @method PromiseInterface insertAsync(InsertWireGroupRequest $request, array $optionalArgs = []) + * @method PromiseInterface listAsync(ListWireGroupsRequest $request, array $optionalArgs = []) + * @method PromiseInterface patchAsync(PatchWireGroupRequest $request, array $optionalArgs = []) + */ +final class WireGroupsClient +{ + use GapicClientTrait; + + /** The name of the service. */ + private const SERVICE_NAME = 'google.cloud.compute.v1.WireGroups'; + + /** + * The default address of the service. + * + * @deprecated SERVICE_ADDRESS_TEMPLATE should be used instead. + */ + private const SERVICE_ADDRESS = 'compute.googleapis.com'; + + /** The address template of the service. */ + private const SERVICE_ADDRESS_TEMPLATE = 'compute.UNIVERSE_DOMAIN'; + + /** The default port of the service. */ + private const DEFAULT_SERVICE_PORT = 443; + + /** The name of the code generator, to be included in the agent header. */ + private const CODEGEN_NAME = 'gapic'; + + /** The default scopes required by the service. */ + public static $serviceScopes = [ + 'https://www.googleapis.com/auth/compute', + 'https://www.googleapis.com/auth/cloud-platform', + ]; + + private $operationsClient; + + private static function getClientDefaults() + { + return [ + 'serviceName' => self::SERVICE_NAME, + 'apiEndpoint' => self::SERVICE_ADDRESS . ':' . self::DEFAULT_SERVICE_PORT, + 'clientConfig' => __DIR__ . '/../resources/wire_groups_client_config.json', + 'descriptorsConfigPath' => __DIR__ . '/../resources/wire_groups_descriptor_config.php', + 'credentialsConfig' => [ + 'defaultScopes' => self::$serviceScopes, + 'useJwtAccessWithScope' => false, + ], + 'transportConfig' => [ + 'rest' => [ + 'restClientConfigPath' => __DIR__ . '/../resources/wire_groups_rest_client_config.php', + ], + ], + ]; + } + + /** Implements GapicClientTrait::defaultTransport. */ + private static function defaultTransport() + { + return 'rest'; + } + + /** Implements ClientOptionsTrait::supportedTransports. */ + private static function supportedTransports() + { + return ['rest']; + } + + /** + * Return an GlobalOperationsClient object with the same endpoint as $this. + * + * @return GlobalOperationsClient + */ + public function getOperationsClient() + { + return $this->operationsClient; + } + + /** Return the default longrunning operation descriptor config. */ + private function getDefaultOperationDescriptor() + { + return [ + 'additionalArgumentMethods' => ['getProject'], + 'getOperationMethod' => 'get', + 'cancelOperationMethod' => null, + 'deleteOperationMethod' => 'delete', + 'operationErrorCodeMethod' => 'getHttpErrorStatusCode', + 'operationErrorMessageMethod' => 'getHttpErrorMessage', + 'operationNameMethod' => 'getName', + 'operationStatusMethod' => 'getStatus', + 'operationStatusDoneValue' => \Google\Cloud\Compute\V1\Operation\Status::DONE, + 'getOperationRequest' => '\Google\Cloud\Compute\V1\GetGlobalOperationRequest', + 'cancelOperationRequest' => null, + 'deleteOperationRequest' => '\Google\Cloud\Compute\V1\DeleteGlobalOperationRequest', + ]; + } + + /** + * Resume an existing long running operation that was previously started by a long + * running API method. If $methodName is not provided, or does not match a long + * running API method, then the operation can still be resumed, but the + * OperationResponse object will not deserialize the final response. + * + * @param string $operationName The name of the long running operation + * @param string $methodName The name of the method used to start the operation + * + * @return OperationResponse + */ + public function resumeOperation($operationName, $methodName = null) + { + $options = $this->descriptors[$methodName]['longRunning'] ?? $this->getDefaultOperationDescriptor(); + $operation = new OperationResponse($operationName, $this->getOperationsClient(), $options); + $operation->reload(); + return $operation; + } + + /** + * Create the default operation client for the service. + * + * @param array $options ClientOptions for the client. + * + * @return GlobalOperationsClient + */ + private function createOperationsClient(array $options) + { + // Unset client-specific configuration options + unset($options['serviceName'], $options['clientConfig'], $options['descriptorsConfigPath']); + + if (isset($options['operationsClient'])) { + return $options['operationsClient']; + } + + return new GlobalOperationsClient($options); + } + + /** + * Constructor. + * + * @param array|ClientOptions $options { + * Optional. Options for configuring the service API wrapper. + * + * @type string $apiEndpoint + * The address of the API remote host. May optionally include the port, formatted + * as ":". Default 'compute.googleapis.com:443'. + * @type FetchAuthTokenInterface|CredentialsWrapper $credentials + * This option should only be used with a pre-constructed + * {@see FetchAuthTokenInterface} or {@see CredentialsWrapper} object. Note that + * when one of these objects are provided, any settings in $credentialsConfig will + * be ignored. + * **Important**: If you are providing a path to a credentials file, or a decoded + * credentials file as a PHP array, this usage is now DEPRECATED. Providing an + * unvalidated credential configuration to Google APIs can compromise the security + * of your systems and data. It is recommended to create the credentials explicitly + * ``` + * use Google\Auth\Credentials\ServiceAccountCredentials; + * use Google\Cloud\Compute\V1\WireGroupsClient; + * $creds = new ServiceAccountCredentials($scopes, $json); + * $options = new WireGroupsClient(['credentials' => $creds]); + * ``` + * {@see + * https://cloud.google.com/docs/authentication/external/externally-sourced-credentials} + * @type array $credentialsConfig + * Options used to configure credentials, including auth token caching, for the + * client. For a full list of supporting configuration options, see + * {@see \Google\ApiCore\CredentialsWrapper::build()} . + * @type bool $disableRetries + * Determines whether or not retries defined by the client configuration should be + * disabled. Defaults to `false`. + * @type string|array $clientConfig + * Client method configuration, including retry settings. This option can be either + * a path to a JSON file, or a PHP array containing the decoded JSON data. By + * default this settings points to the default client config file, which is + * provided in the resources folder. + * @type string|TransportInterface $transport + * The transport used for executing network requests. At the moment, supports only + * `rest`. *Advanced usage*: Additionally, it is possible to pass in an already + * instantiated {@see \Google\ApiCore\Transport\TransportInterface} object. Note + * that when this object is provided, any settings in $transportConfig, and any + * $apiEndpoint setting, will be ignored. + * @type array $transportConfig + * Configuration options that will be used to construct the transport. Options for + * each supported transport type should be passed in a key for that transport. For + * example: + * $transportConfig = [ + * 'rest' => [...], + * ]; + * See the {@see \Google\ApiCore\Transport\RestTransport::build()} method for the + * supported options. + * @type callable $clientCertSource + * A callable which returns the client cert as a string. This can be used to + * provide a certificate and private key to the transport layer for mTLS. + * @type false|LoggerInterface $logger + * A PSR-3 compliant logger. If set to false, logging is disabled, ignoring the + * 'GOOGLE_SDK_PHP_LOGGING' environment flag + * @type string $universeDomain + * The service domain for the client. Defaults to 'googleapis.com'. + * } + * + * @throws ValidationException + */ + public function __construct(array|ClientOptions $options = []) + { + $clientOptions = $this->buildClientOptions($options); + $this->setClientOptions($clientOptions); + $this->operationsClient = $this->createOperationsClient($clientOptions); + } + + /** Handles execution of the async variants for each documented method. */ + public function __call($method, $args) + { + if (substr($method, -5) !== 'Async') { + trigger_error('Call to undefined method ' . __CLASS__ . "::$method()", E_USER_ERROR); + } + + array_unshift($args, substr($method, 0, -5)); + return call_user_func_array([$this, 'startAsyncCall'], $args); + } + + /** + * Deletes the specified wire group in the given scope. + * + * The async variant is {@see WireGroupsClient::deleteAsync()} . + * + * @example samples/V1/WireGroupsClient/delete.php + * + * @param DeleteWireGroupRequest $request A request to house fields associated with the call. + * @param array $callOptions { + * Optional. + * + * @type RetrySettings|array $retrySettings + * Retry settings to use for this call. Can be a {@see RetrySettings} object, or an + * associative array of retry settings parameters. See the documentation on + * {@see RetrySettings} for example usage. + * } + * + * @return OperationResponse + * + * @throws ApiException Thrown if the API call fails. + */ + public function delete(DeleteWireGroupRequest $request, array $callOptions = []): OperationResponse + { + return $this->startApiCall('Delete', $request, $callOptions)->wait(); + } + + /** + * Gets the specified wire group resource in the given scope. + * + * The async variant is {@see WireGroupsClient::getAsync()} . + * + * @example samples/V1/WireGroupsClient/get.php + * + * @param GetWireGroupRequest $request A request to house fields associated with the call. + * @param array $callOptions { + * Optional. + * + * @type RetrySettings|array $retrySettings + * Retry settings to use for this call. Can be a {@see RetrySettings} object, or an + * associative array of retry settings parameters. See the documentation on + * {@see RetrySettings} for example usage. + * } + * + * @return WireGroup + * + * @throws ApiException Thrown if the API call fails. + */ + public function get(GetWireGroupRequest $request, array $callOptions = []): WireGroup + { + return $this->startApiCall('Get', $request, $callOptions)->wait(); + } + + /** + * Creates a wire group in the specified project in the given scope + * using the parameters that are included in the request. + * + * The async variant is {@see WireGroupsClient::insertAsync()} . + * + * @example samples/V1/WireGroupsClient/insert.php + * + * @param InsertWireGroupRequest $request A request to house fields associated with the call. + * @param array $callOptions { + * Optional. + * + * @type RetrySettings|array $retrySettings + * Retry settings to use for this call. Can be a {@see RetrySettings} object, or an + * associative array of retry settings parameters. See the documentation on + * {@see RetrySettings} for example usage. + * } + * + * @return OperationResponse + * + * @throws ApiException Thrown if the API call fails. + */ + public function insert(InsertWireGroupRequest $request, array $callOptions = []): OperationResponse + { + return $this->startApiCall('Insert', $request, $callOptions)->wait(); + } + + /** + * Lists the wire groups for a project in the given scope. + * + * The async variant is {@see WireGroupsClient::listAsync()} . + * + * @example samples/V1/WireGroupsClient/list.php + * + * @param ListWireGroupsRequest $request A request to house fields associated with the call. + * @param array $callOptions { + * Optional. + * + * @type RetrySettings|array $retrySettings + * Retry settings to use for this call. Can be a {@see RetrySettings} object, or an + * associative array of retry settings parameters. See the documentation on + * {@see RetrySettings} for example usage. + * } + * + * @return PagedListResponse + * + * @throws ApiException Thrown if the API call fails. + */ + public function list(ListWireGroupsRequest $request, array $callOptions = []): PagedListResponse + { + return $this->startApiCall('List', $request, $callOptions); + } + + /** + * Updates the specified wire group resource with the data included in the + * request. This method supportsPATCH + * semantics and usesJSON merge + * patch format and processing rules. + * + * The async variant is {@see WireGroupsClient::patchAsync()} . + * + * @example samples/V1/WireGroupsClient/patch.php + * + * @param PatchWireGroupRequest $request A request to house fields associated with the call. + * @param array $callOptions { + * Optional. + * + * @type RetrySettings|array $retrySettings + * Retry settings to use for this call. Can be a {@see RetrySettings} object, or an + * associative array of retry settings parameters. See the documentation on + * {@see RetrySettings} for example usage. + * } + * + * @return OperationResponse + * + * @throws ApiException Thrown if the API call fails. + */ + public function patch(PatchWireGroupRequest $request, array $callOptions = []): OperationResponse + { + return $this->startApiCall('Patch', $request, $callOptions)->wait(); + } +} diff --git a/Compute/src/V1/Client/ZoneOperationsClient.php b/Compute/src/V1/Client/ZoneOperationsClient.php index 2b17f8423f7f..0ab145c2679d 100644 --- a/Compute/src/V1/Client/ZoneOperationsClient.php +++ b/Compute/src/V1/Client/ZoneOperationsClient.php @@ -248,7 +248,8 @@ public function get(GetZoneOperationRequest $request, array $callOptions = []): } /** - * Retrieves a list of Operation resources contained within the specified zone. + * Retrieves a list of Operation resources contained within + * the specified zone. * * The async variant is {@see ZoneOperationsClient::listAsync()} . * @@ -274,7 +275,21 @@ public function list(ListZoneOperationsRequest $request, array $callOptions = [] } /** - * Waits for the specified Operation resource to return as `DONE` or for the request to approach the 2 minute deadline, and retrieves the specified Operation resource. This method waits for no more than the 2 minutes and then returns the current state of the operation, which might be `DONE` or still in progress. This method is called on a best-effort basis. Specifically: - In uncommon cases, when the server is overloaded, the request might return before the default deadline is reached, or might return after zero seconds. - If the default deadline is reached, there is no guarantee that the operation is actually done when the method returns. Be prepared to retry if the operation is not `DONE`. + * Waits for the specified Operation resource to return as `DONE` + * or for the request to approach the 2 minute deadline, and retrieves the + * specified Operation resource. This method waits for no more than the + * 2 minutes and then returns the current state of the + * operation, which might be `DONE` or still in progress. + * + * This method is called on a best-effort basis. Specifically: + * + * + * - In uncommon cases, when the server is overloaded, the request might + * return before the default deadline is reached, or might return after zero + * seconds. + * - If the default deadline is reached, there is no guarantee that the + * operation is actually done when the method returns. Be prepared to retry + * if the operation is not `DONE`. * * The async variant is {@see ZoneOperationsClient::waitAsync()} . * diff --git a/Compute/src/V1/CloneRulesFirewallPolicyRequest.php b/Compute/src/V1/CloneRulesFirewallPolicyRequest.php index 08c504b4bec4..365a7a93baac 100644 --- a/Compute/src/V1/CloneRulesFirewallPolicyRequest.php +++ b/Compute/src/V1/CloneRulesFirewallPolicyRequest.php @@ -22,7 +22,17 @@ class CloneRulesFirewallPolicyRequest extends \Google\Protobuf\Internal\Message */ protected $firewall_policy = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -56,7 +66,17 @@ public static function build(string $firewallPolicy): self * @type string $firewall_policy * Name of the firewall policy to update. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $source_firewall_policy * The firewall policy from which to copy rules. * } @@ -93,7 +113,17 @@ public function setFirewallPolicy($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -114,7 +144,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/CloneRulesNetworkFirewallPolicyRequest.php b/Compute/src/V1/CloneRulesNetworkFirewallPolicyRequest.php index 393414f16d35..6d598527689d 100644 --- a/Compute/src/V1/CloneRulesNetworkFirewallPolicyRequest.php +++ b/Compute/src/V1/CloneRulesNetworkFirewallPolicyRequest.php @@ -28,7 +28,17 @@ class CloneRulesNetworkFirewallPolicyRequest extends \Google\Protobuf\Internal\M */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -66,7 +76,17 @@ public static function build(string $project, string $firewallPolicy): self * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $source_firewall_policy * The firewall policy from which to copy rules. * } @@ -129,7 +149,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -150,7 +180,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/CloneRulesRegionNetworkFirewallPolicyRequest.php b/Compute/src/V1/CloneRulesRegionNetworkFirewallPolicyRequest.php index 3a812a3eddab..c282bdbd9943 100644 --- a/Compute/src/V1/CloneRulesRegionNetworkFirewallPolicyRequest.php +++ b/Compute/src/V1/CloneRulesRegionNetworkFirewallPolicyRequest.php @@ -34,7 +34,17 @@ class CloneRulesRegionNetworkFirewallPolicyRequest extends \Google\Protobuf\Inte */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -76,7 +86,17 @@ public static function build(string $project, string $region, string $firewallPo * @type string $region * Name of the region scoping this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $source_firewall_policy * The firewall policy from which to copy rules. * } @@ -165,7 +185,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -186,7 +216,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/Commitment.php b/Compute/src/V1/Commitment.php index d06b32fed988..91a4cec065ba 100644 --- a/Compute/src/V1/Commitment.php +++ b/Compute/src/V1/Commitment.php @@ -9,45 +9,67 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Represents a regional resource-based commitment resource. Creating this commitment resource means that you are purchasing a resource-based committed use contract, with an explicit start and end time. You can purchase resource-based commitments for both hardware and software resources. For more information, read Resource-based committed use discounts + * Represents a regional resource-based commitment resource. + * Creating this commitment resource means that you are purchasing a + * resource-based committed use contract, with an explicit start and end time. + * You can purchase resource-based commitments for both hardware and software + * resources. For more information, read + * Resource-based committed use discounts * * Generated from protobuf message google.cloud.compute.v1.Commitment */ class Commitment extends \Google\Protobuf\Internal\Message { /** - * Specifies whether to automatically renew the commitment at the end of its current term. The default value is false. If you set the field to true, each time your commitment reaches the end of its term, Compute Engine automatically renews it for another term. You can update this field anytime before the commitment expires. For example, if the commitment is set to expire at 12 AM UTC-8 on January 3, 2027, you can update this field until 11:59 PM UTC-8 on January 2, 2027. + * Specifies whether to automatically renew the commitment at the end of its + * current term. The default value is false. If you set the field + * to true, each time your commitment reaches the end of its + * term, Compute Engine automatically renews it for another term. You can + * update this field anytime before the commitment expires. For example, if + * the commitment is set to expire at 12 AM UTC-8 on January 3, 2027, you can + * update this field until 11:59 PM UTC-8 on January 2, 2027. * * Generated from protobuf field optional bool auto_renew = 495520765; */ protected $auto_renew = null; /** - * The category of the commitment; specifies whether the commitment is for hardware or software resources. Category MACHINE specifies that you are committing to hardware machine resources such as VCPU or MEMORY, listed in resources. Category LICENSE specifies that you are committing to software licenses, listed in licenseResources. Note that if you specify MACHINE commitments, then you must also specify a type to indicate the machine series of the hardware resource that you are committing to. + * The category of the commitment; specifies whether the commitment is for + * hardware or software resources. Category MACHINE specifies + * that you are committing to hardware machine resources such asVCPU or MEMORY, listed in resources. + * Category LICENSE specifies that you are committing to software + * licenses, listed in licenseResources. + * Note that if you specify MACHINE commitments, then you must + * also specify a type to indicate the machine series of the + * hardware resource that you are committing to. * Check the Category enum for the list of possible values. * * Generated from protobuf field optional string category = 50511102; */ protected $category = null; /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; */ protected $creation_timestamp = null; /** - * [Input Only] Optional, specifies the requested commitment end time in RFC3339 text format. Use this option when the desired commitment's end date is later than the start date + term duration. + * [Input Only] Optional, specifies the requested commitment end time inRFC3339 text format. Use this option when the desired + * commitment's end date is later than the start date + term duration. * * Generated from protobuf field optional string custom_end_timestamp = 181770852; */ protected $custom_end_timestamp = null; /** - * An optional description of the commitment. You can provide this property when you create the resource. + * An optional description of the commitment. You can provide this property + * when you create the resource. * * Generated from protobuf field optional string description = 422937596; */ protected $description = null; /** - * [Output Only] Commitment end time in RFC3339 text format. + * [Output Only] Commitment end time inRFC3339 + * text format. * * Generated from protobuf field optional string end_timestamp = 468096690; */ @@ -57,13 +79,15 @@ class Commitment extends \Google\Protobuf\Internal\Message */ private $existing_reservations; /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; */ protected $id = null; /** - * [Output Only] Type of the resource. Always compute#commitment for commitments. + * [Output Only] Type of the resource. Always compute#commitment + * for commitments. * * Generated from protobuf field optional string kind = 3292052; */ @@ -75,32 +99,52 @@ class Commitment extends \Google\Protobuf\Internal\Message */ protected $license_resource = null; /** - * The list of source commitments that you are merging to create the new merged commitment. For more information, see Merging commitments. + * The list of source commitments that you are merging to create the new + * merged commitment. For more information, see + * Merging commitments. * * Generated from protobuf field repeated string merge_source_commitments = 188093761; */ private $merge_source_commitments; /** - * Name of the commitment. You must specify a name when you purchase the commitment. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the commitment. You must specify a name when you purchase the + * commitment. The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * * Generated from protobuf field optional string name = 3373707; */ protected $name = null; /** - * The minimum time duration that you commit to purchasing resources. The plan that you choose determines the preset term length of the commitment (which is 1 year or 3 years) and affects the discount rate that you receive for your resources. Committing to a longer time duration typically gives you a higher discount rate. The supported values for this field are TWELVE_MONTH (1 year), and THIRTY_SIX_MONTH (3 years). + * The minimum time duration that you commit to purchasing resources. + * The plan that you choose determines the preset term length of the + * commitment (which is 1 year or 3 years) and affects the discount rate that + * you receive for your resources. Committing to a longer time duration + * typically gives you a higher discount rate. The supported values for this + * field are TWELVE_MONTH (1 year), andTHIRTY_SIX_MONTH (3 years). * Check the Plan enum for the list of possible values. * * Generated from protobuf field optional string plan = 3443497; */ protected $plan = null; /** - * [Output Only] URL of the region where the commitment and committed resources are located. + * [Output Only] URL of the region where the commitment and committed + * resources are located. * * Generated from protobuf field optional string region = 138946292; */ protected $region = null; /** - * The list of new reservations that you want to create and attach to this commitment. You must attach reservations to your commitment if your commitment specifies any GPUs or Local SSD disks. For more information, see Attach reservations to resource-based commitments. Specify this property only if you want to create new reservations to attach. To attach existing reservations, specify the existingReservations property instead. + * The list of new reservations that you want to create and attach to this + * commitment. + * You must attach reservations to your commitment if your commitment + * specifies any GPUs or Local SSD disks. For more information, see + * Attach reservations to resource-based commitments. + * Specify this property only if you want to create new + * reservations to attach. To attach existing reservations, specify theexistingReservations property instead. * * Generated from protobuf field repeated .google.cloud.compute.v1.Reservation reservations = 399717927; */ @@ -112,7 +156,9 @@ class Commitment extends \Google\Protobuf\Internal\Message */ protected $resource_status = null; /** - * The list of all the hardware resources, with their types and amounts, that you want to commit to. Specify as a separate entry in the list for each individual resource type. + * The list of all the hardware resources, with their types and amounts, that + * you want to commit to. Specify as a separate entry in the list for each + * individual resource type. * * Generated from protobuf field repeated .google.cloud.compute.v1.ResourceCommitment resources = 164412965; */ @@ -124,19 +170,24 @@ class Commitment extends \Google\Protobuf\Internal\Message */ protected $self_link = null; /** - * The source commitment from which you are transferring resources to create the new split commitment. For more information, see Split commitments. + * The source commitment from which you are transferring resources to create + * the new split commitment. For more information, see + * Split commitments. * * Generated from protobuf field optional string split_source_commitment = 402611156; */ protected $split_source_commitment = null; /** - * [Output Only] Commitment start time in RFC3339 text format. + * [Output Only] Commitment start time inRFC3339 + * text format. * * Generated from protobuf field optional string start_timestamp = 83645817; */ protected $start_timestamp = null; /** - * [Output Only] Status of the commitment with regards to eventual expiration (each commitment has an end date defined). Status can be one of the following values: NOT_YET_ACTIVE, ACTIVE, or EXPIRED. + * [Output Only] Status of the commitment with regards to eventual expiration + * (each commitment has an end date defined). Status can be one of the + * following values: NOT_YET_ACTIVE, ACTIVE, orEXPIRED. * Check the Status enum for the list of possible values. * * Generated from protobuf field optional string status = 181260274; @@ -149,7 +200,17 @@ class Commitment extends \Google\Protobuf\Internal\Message */ protected $status_message = null; /** - * The type of commitment; specifies the machine series for which you want to commit to purchasing resources. The choice of machine series affects the discount rate and the eligible resource types. The type must be one of the following: ACCELERATOR_OPTIMIZED, ACCELERATOR_OPTIMIZED_A3, ACCELERATOR_OPTIMIZED_A3_MEGA, COMPUTE_OPTIMIZED, COMPUTE_OPTIMIZED_C2D, COMPUTE_OPTIMIZED_C3, COMPUTE_OPTIMIZED_C3D, COMPUTE_OPTIMIZED_H3, GENERAL_PURPOSE, GENERAL_PURPOSE_C4, GENERAL_PURPOSE_E2, GENERAL_PURPOSE_N2, GENERAL_PURPOSE_N2D, GENERAL_PURPOSE_N4, GENERAL_PURPOSE_T2D, GRAPHICS_OPTIMIZED, MEMORY_OPTIMIZED, MEMORY_OPTIMIZED_M3, MEMORY_OPTIMIZED_X4, STORAGE_OPTIMIZED_Z3. For example, type MEMORY_OPTIMIZED specifies a commitment that applies only to eligible resources of memory optimized M1 and M2 machine series. Type GENERAL_PURPOSE specifies a commitment that applies only to eligible resources of general purpose N1 machine series. + * The type of commitment; specifies the + * machine series for which you want to commit to purchasing resources. + * The choice of machine series affects the discount rate and the eligible + * resource types. + * The type must be one of the following:ACCELERATOR_OPTIMIZED, ACCELERATOR_OPTIMIZED_A3,ACCELERATOR_OPTIMIZED_A3_MEGA,COMPUTE_OPTIMIZED, COMPUTE_OPTIMIZED_C2D, + * COMPUTE_OPTIMIZED_C3, COMPUTE_OPTIMIZED_C3D,COMPUTE_OPTIMIZED_H3, GENERAL_PURPOSE,GENERAL_PURPOSE_C4, GENERAL_PURPOSE_E2,GENERAL_PURPOSE_N2, GENERAL_PURPOSE_N2D,GENERAL_PURPOSE_N4, GENERAL_PURPOSE_T2D,GRAPHICS_OPTIMIZED, MEMORY_OPTIMIZED,MEMORY_OPTIMIZED_M3, MEMORY_OPTIMIZED_X4,STORAGE_OPTIMIZED_Z3. + * For example, type MEMORY_OPTIMIZED specifies a commitment + * that applies only to eligible resources of memory optimized M1 and M2 + * machine series. Type GENERAL_PURPOSE specifies a commitment + * that applies only to eligible resources of general purpose N1 machine + * series. * Check the Type enum for the list of possible values. * * Generated from protobuf field optional string type = 3575610; @@ -163,53 +224,109 @@ class Commitment extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type bool $auto_renew - * Specifies whether to automatically renew the commitment at the end of its current term. The default value is false. If you set the field to true, each time your commitment reaches the end of its term, Compute Engine automatically renews it for another term. You can update this field anytime before the commitment expires. For example, if the commitment is set to expire at 12 AM UTC-8 on January 3, 2027, you can update this field until 11:59 PM UTC-8 on January 2, 2027. + * Specifies whether to automatically renew the commitment at the end of its + * current term. The default value is false. If you set the field + * to true, each time your commitment reaches the end of its + * term, Compute Engine automatically renews it for another term. You can + * update this field anytime before the commitment expires. For example, if + * the commitment is set to expire at 12 AM UTC-8 on January 3, 2027, you can + * update this field until 11:59 PM UTC-8 on January 2, 2027. * @type string $category - * The category of the commitment; specifies whether the commitment is for hardware or software resources. Category MACHINE specifies that you are committing to hardware machine resources such as VCPU or MEMORY, listed in resources. Category LICENSE specifies that you are committing to software licenses, listed in licenseResources. Note that if you specify MACHINE commitments, then you must also specify a type to indicate the machine series of the hardware resource that you are committing to. + * The category of the commitment; specifies whether the commitment is for + * hardware or software resources. Category MACHINE specifies + * that you are committing to hardware machine resources such asVCPU or MEMORY, listed in resources. + * Category LICENSE specifies that you are committing to software + * licenses, listed in licenseResources. + * Note that if you specify MACHINE commitments, then you must + * also specify a type to indicate the machine series of the + * hardware resource that you are committing to. * Check the Category enum for the list of possible values. * @type string $creation_timestamp - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * @type string $custom_end_timestamp - * [Input Only] Optional, specifies the requested commitment end time in RFC3339 text format. Use this option when the desired commitment's end date is later than the start date + term duration. + * [Input Only] Optional, specifies the requested commitment end time inRFC3339 text format. Use this option when the desired + * commitment's end date is later than the start date + term duration. * @type string $description - * An optional description of the commitment. You can provide this property when you create the resource. + * An optional description of the commitment. You can provide this property + * when you create the resource. * @type string $end_timestamp - * [Output Only] Commitment end time in RFC3339 text format. + * [Output Only] Commitment end time inRFC3339 + * text format. * @type array|\Google\Protobuf\Internal\RepeatedField $existing_reservations * @type int|string $id - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * @type string $kind - * [Output Only] Type of the resource. Always compute#commitment for commitments. + * [Output Only] Type of the resource. Always compute#commitment + * for commitments. * @type \Google\Cloud\Compute\V1\LicenseResourceCommitment $license_resource * The license specification required as part of a license commitment. * @type array|\Google\Protobuf\Internal\RepeatedField $merge_source_commitments - * The list of source commitments that you are merging to create the new merged commitment. For more information, see Merging commitments. + * The list of source commitments that you are merging to create the new + * merged commitment. For more information, see + * Merging commitments. * @type string $name - * Name of the commitment. You must specify a name when you purchase the commitment. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the commitment. You must specify a name when you purchase the + * commitment. The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * @type string $plan - * The minimum time duration that you commit to purchasing resources. The plan that you choose determines the preset term length of the commitment (which is 1 year or 3 years) and affects the discount rate that you receive for your resources. Committing to a longer time duration typically gives you a higher discount rate. The supported values for this field are TWELVE_MONTH (1 year), and THIRTY_SIX_MONTH (3 years). + * The minimum time duration that you commit to purchasing resources. + * The plan that you choose determines the preset term length of the + * commitment (which is 1 year or 3 years) and affects the discount rate that + * you receive for your resources. Committing to a longer time duration + * typically gives you a higher discount rate. The supported values for this + * field are TWELVE_MONTH (1 year), andTHIRTY_SIX_MONTH (3 years). * Check the Plan enum for the list of possible values. * @type string $region - * [Output Only] URL of the region where the commitment and committed resources are located. + * [Output Only] URL of the region where the commitment and committed + * resources are located. * @type array<\Google\Cloud\Compute\V1\Reservation>|\Google\Protobuf\Internal\RepeatedField $reservations - * The list of new reservations that you want to create and attach to this commitment. You must attach reservations to your commitment if your commitment specifies any GPUs or Local SSD disks. For more information, see Attach reservations to resource-based commitments. Specify this property only if you want to create new reservations to attach. To attach existing reservations, specify the existingReservations property instead. + * The list of new reservations that you want to create and attach to this + * commitment. + * You must attach reservations to your commitment if your commitment + * specifies any GPUs or Local SSD disks. For more information, see + * Attach reservations to resource-based commitments. + * Specify this property only if you want to create new + * reservations to attach. To attach existing reservations, specify theexistingReservations property instead. * @type \Google\Cloud\Compute\V1\CommitmentResourceStatus $resource_status * [Output Only] Status information for Commitment resource. * @type array<\Google\Cloud\Compute\V1\ResourceCommitment>|\Google\Protobuf\Internal\RepeatedField $resources - * The list of all the hardware resources, with their types and amounts, that you want to commit to. Specify as a separate entry in the list for each individual resource type. + * The list of all the hardware resources, with their types and amounts, that + * you want to commit to. Specify as a separate entry in the list for each + * individual resource type. * @type string $self_link * [Output Only] Server-defined URL for the resource. * @type string $split_source_commitment - * The source commitment from which you are transferring resources to create the new split commitment. For more information, see Split commitments. + * The source commitment from which you are transferring resources to create + * the new split commitment. For more information, see + * Split commitments. * @type string $start_timestamp - * [Output Only] Commitment start time in RFC3339 text format. + * [Output Only] Commitment start time inRFC3339 + * text format. * @type string $status - * [Output Only] Status of the commitment with regards to eventual expiration (each commitment has an end date defined). Status can be one of the following values: NOT_YET_ACTIVE, ACTIVE, or EXPIRED. + * [Output Only] Status of the commitment with regards to eventual expiration + * (each commitment has an end date defined). Status can be one of the + * following values: NOT_YET_ACTIVE, ACTIVE, orEXPIRED. * Check the Status enum for the list of possible values. * @type string $status_message * [Output Only] An optional, human-readable explanation of the status. * @type string $type - * The type of commitment; specifies the machine series for which you want to commit to purchasing resources. The choice of machine series affects the discount rate and the eligible resource types. The type must be one of the following: ACCELERATOR_OPTIMIZED, ACCELERATOR_OPTIMIZED_A3, ACCELERATOR_OPTIMIZED_A3_MEGA, COMPUTE_OPTIMIZED, COMPUTE_OPTIMIZED_C2D, COMPUTE_OPTIMIZED_C3, COMPUTE_OPTIMIZED_C3D, COMPUTE_OPTIMIZED_H3, GENERAL_PURPOSE, GENERAL_PURPOSE_C4, GENERAL_PURPOSE_E2, GENERAL_PURPOSE_N2, GENERAL_PURPOSE_N2D, GENERAL_PURPOSE_N4, GENERAL_PURPOSE_T2D, GRAPHICS_OPTIMIZED, MEMORY_OPTIMIZED, MEMORY_OPTIMIZED_M3, MEMORY_OPTIMIZED_X4, STORAGE_OPTIMIZED_Z3. For example, type MEMORY_OPTIMIZED specifies a commitment that applies only to eligible resources of memory optimized M1 and M2 machine series. Type GENERAL_PURPOSE specifies a commitment that applies only to eligible resources of general purpose N1 machine series. + * The type of commitment; specifies the + * machine series for which you want to commit to purchasing resources. + * The choice of machine series affects the discount rate and the eligible + * resource types. + * The type must be one of the following:ACCELERATOR_OPTIMIZED, ACCELERATOR_OPTIMIZED_A3,ACCELERATOR_OPTIMIZED_A3_MEGA,COMPUTE_OPTIMIZED, COMPUTE_OPTIMIZED_C2D, + * COMPUTE_OPTIMIZED_C3, COMPUTE_OPTIMIZED_C3D,COMPUTE_OPTIMIZED_H3, GENERAL_PURPOSE,GENERAL_PURPOSE_C4, GENERAL_PURPOSE_E2,GENERAL_PURPOSE_N2, GENERAL_PURPOSE_N2D,GENERAL_PURPOSE_N4, GENERAL_PURPOSE_T2D,GRAPHICS_OPTIMIZED, MEMORY_OPTIMIZED,MEMORY_OPTIMIZED_M3, MEMORY_OPTIMIZED_X4,STORAGE_OPTIMIZED_Z3. + * For example, type MEMORY_OPTIMIZED specifies a commitment + * that applies only to eligible resources of memory optimized M1 and M2 + * machine series. Type GENERAL_PURPOSE specifies a commitment + * that applies only to eligible resources of general purpose N1 machine + * series. * Check the Type enum for the list of possible values. * } */ @@ -219,7 +336,13 @@ public function __construct($data = NULL) { } /** - * Specifies whether to automatically renew the commitment at the end of its current term. The default value is false. If you set the field to true, each time your commitment reaches the end of its term, Compute Engine automatically renews it for another term. You can update this field anytime before the commitment expires. For example, if the commitment is set to expire at 12 AM UTC-8 on January 3, 2027, you can update this field until 11:59 PM UTC-8 on January 2, 2027. + * Specifies whether to automatically renew the commitment at the end of its + * current term. The default value is false. If you set the field + * to true, each time your commitment reaches the end of its + * term, Compute Engine automatically renews it for another term. You can + * update this field anytime before the commitment expires. For example, if + * the commitment is set to expire at 12 AM UTC-8 on January 3, 2027, you can + * update this field until 11:59 PM UTC-8 on January 2, 2027. * * Generated from protobuf field optional bool auto_renew = 495520765; * @return bool @@ -240,7 +363,13 @@ public function clearAutoRenew() } /** - * Specifies whether to automatically renew the commitment at the end of its current term. The default value is false. If you set the field to true, each time your commitment reaches the end of its term, Compute Engine automatically renews it for another term. You can update this field anytime before the commitment expires. For example, if the commitment is set to expire at 12 AM UTC-8 on January 3, 2027, you can update this field until 11:59 PM UTC-8 on January 2, 2027. + * Specifies whether to automatically renew the commitment at the end of its + * current term. The default value is false. If you set the field + * to true, each time your commitment reaches the end of its + * term, Compute Engine automatically renews it for another term. You can + * update this field anytime before the commitment expires. For example, if + * the commitment is set to expire at 12 AM UTC-8 on January 3, 2027, you can + * update this field until 11:59 PM UTC-8 on January 2, 2027. * * Generated from protobuf field optional bool auto_renew = 495520765; * @param bool $var @@ -255,7 +384,14 @@ public function setAutoRenew($var) } /** - * The category of the commitment; specifies whether the commitment is for hardware or software resources. Category MACHINE specifies that you are committing to hardware machine resources such as VCPU or MEMORY, listed in resources. Category LICENSE specifies that you are committing to software licenses, listed in licenseResources. Note that if you specify MACHINE commitments, then you must also specify a type to indicate the machine series of the hardware resource that you are committing to. + * The category of the commitment; specifies whether the commitment is for + * hardware or software resources. Category MACHINE specifies + * that you are committing to hardware machine resources such asVCPU or MEMORY, listed in resources. + * Category LICENSE specifies that you are committing to software + * licenses, listed in licenseResources. + * Note that if you specify MACHINE commitments, then you must + * also specify a type to indicate the machine series of the + * hardware resource that you are committing to. * Check the Category enum for the list of possible values. * * Generated from protobuf field optional string category = 50511102; @@ -277,7 +413,14 @@ public function clearCategory() } /** - * The category of the commitment; specifies whether the commitment is for hardware or software resources. Category MACHINE specifies that you are committing to hardware machine resources such as VCPU or MEMORY, listed in resources. Category LICENSE specifies that you are committing to software licenses, listed in licenseResources. Note that if you specify MACHINE commitments, then you must also specify a type to indicate the machine series of the hardware resource that you are committing to. + * The category of the commitment; specifies whether the commitment is for + * hardware or software resources. Category MACHINE specifies + * that you are committing to hardware machine resources such asVCPU or MEMORY, listed in resources. + * Category LICENSE specifies that you are committing to software + * licenses, listed in licenseResources. + * Note that if you specify MACHINE commitments, then you must + * also specify a type to indicate the machine series of the + * hardware resource that you are committing to. * Check the Category enum for the list of possible values. * * Generated from protobuf field optional string category = 50511102; @@ -293,7 +436,8 @@ public function setCategory($var) } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @return string @@ -314,7 +458,8 @@ public function clearCreationTimestamp() } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @param string $var @@ -329,7 +474,8 @@ public function setCreationTimestamp($var) } /** - * [Input Only] Optional, specifies the requested commitment end time in RFC3339 text format. Use this option when the desired commitment's end date is later than the start date + term duration. + * [Input Only] Optional, specifies the requested commitment end time inRFC3339 text format. Use this option when the desired + * commitment's end date is later than the start date + term duration. * * Generated from protobuf field optional string custom_end_timestamp = 181770852; * @return string @@ -350,7 +496,8 @@ public function clearCustomEndTimestamp() } /** - * [Input Only] Optional, specifies the requested commitment end time in RFC3339 text format. Use this option when the desired commitment's end date is later than the start date + term duration. + * [Input Only] Optional, specifies the requested commitment end time inRFC3339 text format. Use this option when the desired + * commitment's end date is later than the start date + term duration. * * Generated from protobuf field optional string custom_end_timestamp = 181770852; * @param string $var @@ -365,7 +512,8 @@ public function setCustomEndTimestamp($var) } /** - * An optional description of the commitment. You can provide this property when you create the resource. + * An optional description of the commitment. You can provide this property + * when you create the resource. * * Generated from protobuf field optional string description = 422937596; * @return string @@ -386,7 +534,8 @@ public function clearDescription() } /** - * An optional description of the commitment. You can provide this property when you create the resource. + * An optional description of the commitment. You can provide this property + * when you create the resource. * * Generated from protobuf field optional string description = 422937596; * @param string $var @@ -401,7 +550,8 @@ public function setDescription($var) } /** - * [Output Only] Commitment end time in RFC3339 text format. + * [Output Only] Commitment end time inRFC3339 + * text format. * * Generated from protobuf field optional string end_timestamp = 468096690; * @return string @@ -422,7 +572,8 @@ public function clearEndTimestamp() } /** - * [Output Only] Commitment end time in RFC3339 text format. + * [Output Only] Commitment end time inRFC3339 + * text format. * * Generated from protobuf field optional string end_timestamp = 468096690; * @param string $var @@ -459,7 +610,8 @@ public function setExistingReservations($var) } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @return int|string @@ -480,7 +632,8 @@ public function clearId() } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @param int|string $var @@ -495,7 +648,8 @@ public function setId($var) } /** - * [Output Only] Type of the resource. Always compute#commitment for commitments. + * [Output Only] Type of the resource. Always compute#commitment + * for commitments. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -516,7 +670,8 @@ public function clearKind() } /** - * [Output Only] Type of the resource. Always compute#commitment for commitments. + * [Output Only] Type of the resource. Always compute#commitment + * for commitments. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -567,7 +722,9 @@ public function setLicenseResource($var) } /** - * The list of source commitments that you are merging to create the new merged commitment. For more information, see Merging commitments. + * The list of source commitments that you are merging to create the new + * merged commitment. For more information, see + * Merging commitments. * * Generated from protobuf field repeated string merge_source_commitments = 188093761; * @return \Google\Protobuf\Internal\RepeatedField @@ -578,7 +735,9 @@ public function getMergeSourceCommitments() } /** - * The list of source commitments that you are merging to create the new merged commitment. For more information, see Merging commitments. + * The list of source commitments that you are merging to create the new + * merged commitment. For more information, see + * Merging commitments. * * Generated from protobuf field repeated string merge_source_commitments = 188093761; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -593,7 +752,13 @@ public function setMergeSourceCommitments($var) } /** - * Name of the commitment. You must specify a name when you purchase the commitment. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the commitment. You must specify a name when you purchase the + * commitment. The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * * Generated from protobuf field optional string name = 3373707; * @return string @@ -614,7 +779,13 @@ public function clearName() } /** - * Name of the commitment. You must specify a name when you purchase the commitment. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the commitment. You must specify a name when you purchase the + * commitment. The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * * Generated from protobuf field optional string name = 3373707; * @param string $var @@ -629,7 +800,12 @@ public function setName($var) } /** - * The minimum time duration that you commit to purchasing resources. The plan that you choose determines the preset term length of the commitment (which is 1 year or 3 years) and affects the discount rate that you receive for your resources. Committing to a longer time duration typically gives you a higher discount rate. The supported values for this field are TWELVE_MONTH (1 year), and THIRTY_SIX_MONTH (3 years). + * The minimum time duration that you commit to purchasing resources. + * The plan that you choose determines the preset term length of the + * commitment (which is 1 year or 3 years) and affects the discount rate that + * you receive for your resources. Committing to a longer time duration + * typically gives you a higher discount rate. The supported values for this + * field are TWELVE_MONTH (1 year), andTHIRTY_SIX_MONTH (3 years). * Check the Plan enum for the list of possible values. * * Generated from protobuf field optional string plan = 3443497; @@ -651,7 +827,12 @@ public function clearPlan() } /** - * The minimum time duration that you commit to purchasing resources. The plan that you choose determines the preset term length of the commitment (which is 1 year or 3 years) and affects the discount rate that you receive for your resources. Committing to a longer time duration typically gives you a higher discount rate. The supported values for this field are TWELVE_MONTH (1 year), and THIRTY_SIX_MONTH (3 years). + * The minimum time duration that you commit to purchasing resources. + * The plan that you choose determines the preset term length of the + * commitment (which is 1 year or 3 years) and affects the discount rate that + * you receive for your resources. Committing to a longer time duration + * typically gives you a higher discount rate. The supported values for this + * field are TWELVE_MONTH (1 year), andTHIRTY_SIX_MONTH (3 years). * Check the Plan enum for the list of possible values. * * Generated from protobuf field optional string plan = 3443497; @@ -667,7 +848,8 @@ public function setPlan($var) } /** - * [Output Only] URL of the region where the commitment and committed resources are located. + * [Output Only] URL of the region where the commitment and committed + * resources are located. * * Generated from protobuf field optional string region = 138946292; * @return string @@ -688,7 +870,8 @@ public function clearRegion() } /** - * [Output Only] URL of the region where the commitment and committed resources are located. + * [Output Only] URL of the region where the commitment and committed + * resources are located. * * Generated from protobuf field optional string region = 138946292; * @param string $var @@ -703,7 +886,13 @@ public function setRegion($var) } /** - * The list of new reservations that you want to create and attach to this commitment. You must attach reservations to your commitment if your commitment specifies any GPUs or Local SSD disks. For more information, see Attach reservations to resource-based commitments. Specify this property only if you want to create new reservations to attach. To attach existing reservations, specify the existingReservations property instead. + * The list of new reservations that you want to create and attach to this + * commitment. + * You must attach reservations to your commitment if your commitment + * specifies any GPUs or Local SSD disks. For more information, see + * Attach reservations to resource-based commitments. + * Specify this property only if you want to create new + * reservations to attach. To attach existing reservations, specify theexistingReservations property instead. * * Generated from protobuf field repeated .google.cloud.compute.v1.Reservation reservations = 399717927; * @return \Google\Protobuf\Internal\RepeatedField @@ -714,7 +903,13 @@ public function getReservations() } /** - * The list of new reservations that you want to create and attach to this commitment. You must attach reservations to your commitment if your commitment specifies any GPUs or Local SSD disks. For more information, see Attach reservations to resource-based commitments. Specify this property only if you want to create new reservations to attach. To attach existing reservations, specify the existingReservations property instead. + * The list of new reservations that you want to create and attach to this + * commitment. + * You must attach reservations to your commitment if your commitment + * specifies any GPUs or Local SSD disks. For more information, see + * Attach reservations to resource-based commitments. + * Specify this property only if you want to create new + * reservations to attach. To attach existing reservations, specify theexistingReservations property instead. * * Generated from protobuf field repeated .google.cloud.compute.v1.Reservation reservations = 399717927; * @param array<\Google\Cloud\Compute\V1\Reservation>|\Google\Protobuf\Internal\RepeatedField $var @@ -765,7 +960,9 @@ public function setResourceStatus($var) } /** - * The list of all the hardware resources, with their types and amounts, that you want to commit to. Specify as a separate entry in the list for each individual resource type. + * The list of all the hardware resources, with their types and amounts, that + * you want to commit to. Specify as a separate entry in the list for each + * individual resource type. * * Generated from protobuf field repeated .google.cloud.compute.v1.ResourceCommitment resources = 164412965; * @return \Google\Protobuf\Internal\RepeatedField @@ -776,7 +973,9 @@ public function getResources() } /** - * The list of all the hardware resources, with their types and amounts, that you want to commit to. Specify as a separate entry in the list for each individual resource type. + * The list of all the hardware resources, with their types and amounts, that + * you want to commit to. Specify as a separate entry in the list for each + * individual resource type. * * Generated from protobuf field repeated .google.cloud.compute.v1.ResourceCommitment resources = 164412965; * @param array<\Google\Cloud\Compute\V1\ResourceCommitment>|\Google\Protobuf\Internal\RepeatedField $var @@ -827,7 +1026,9 @@ public function setSelfLink($var) } /** - * The source commitment from which you are transferring resources to create the new split commitment. For more information, see Split commitments. + * The source commitment from which you are transferring resources to create + * the new split commitment. For more information, see + * Split commitments. * * Generated from protobuf field optional string split_source_commitment = 402611156; * @return string @@ -848,7 +1049,9 @@ public function clearSplitSourceCommitment() } /** - * The source commitment from which you are transferring resources to create the new split commitment. For more information, see Split commitments. + * The source commitment from which you are transferring resources to create + * the new split commitment. For more information, see + * Split commitments. * * Generated from protobuf field optional string split_source_commitment = 402611156; * @param string $var @@ -863,7 +1066,8 @@ public function setSplitSourceCommitment($var) } /** - * [Output Only] Commitment start time in RFC3339 text format. + * [Output Only] Commitment start time inRFC3339 + * text format. * * Generated from protobuf field optional string start_timestamp = 83645817; * @return string @@ -884,7 +1088,8 @@ public function clearStartTimestamp() } /** - * [Output Only] Commitment start time in RFC3339 text format. + * [Output Only] Commitment start time inRFC3339 + * text format. * * Generated from protobuf field optional string start_timestamp = 83645817; * @param string $var @@ -899,7 +1104,9 @@ public function setStartTimestamp($var) } /** - * [Output Only] Status of the commitment with regards to eventual expiration (each commitment has an end date defined). Status can be one of the following values: NOT_YET_ACTIVE, ACTIVE, or EXPIRED. + * [Output Only] Status of the commitment with regards to eventual expiration + * (each commitment has an end date defined). Status can be one of the + * following values: NOT_YET_ACTIVE, ACTIVE, orEXPIRED. * Check the Status enum for the list of possible values. * * Generated from protobuf field optional string status = 181260274; @@ -921,7 +1128,9 @@ public function clearStatus() } /** - * [Output Only] Status of the commitment with regards to eventual expiration (each commitment has an end date defined). Status can be one of the following values: NOT_YET_ACTIVE, ACTIVE, or EXPIRED. + * [Output Only] Status of the commitment with regards to eventual expiration + * (each commitment has an end date defined). Status can be one of the + * following values: NOT_YET_ACTIVE, ACTIVE, orEXPIRED. * Check the Status enum for the list of possible values. * * Generated from protobuf field optional string status = 181260274; @@ -973,7 +1182,17 @@ public function setStatusMessage($var) } /** - * The type of commitment; specifies the machine series for which you want to commit to purchasing resources. The choice of machine series affects the discount rate and the eligible resource types. The type must be one of the following: ACCELERATOR_OPTIMIZED, ACCELERATOR_OPTIMIZED_A3, ACCELERATOR_OPTIMIZED_A3_MEGA, COMPUTE_OPTIMIZED, COMPUTE_OPTIMIZED_C2D, COMPUTE_OPTIMIZED_C3, COMPUTE_OPTIMIZED_C3D, COMPUTE_OPTIMIZED_H3, GENERAL_PURPOSE, GENERAL_PURPOSE_C4, GENERAL_PURPOSE_E2, GENERAL_PURPOSE_N2, GENERAL_PURPOSE_N2D, GENERAL_PURPOSE_N4, GENERAL_PURPOSE_T2D, GRAPHICS_OPTIMIZED, MEMORY_OPTIMIZED, MEMORY_OPTIMIZED_M3, MEMORY_OPTIMIZED_X4, STORAGE_OPTIMIZED_Z3. For example, type MEMORY_OPTIMIZED specifies a commitment that applies only to eligible resources of memory optimized M1 and M2 machine series. Type GENERAL_PURPOSE specifies a commitment that applies only to eligible resources of general purpose N1 machine series. + * The type of commitment; specifies the + * machine series for which you want to commit to purchasing resources. + * The choice of machine series affects the discount rate and the eligible + * resource types. + * The type must be one of the following:ACCELERATOR_OPTIMIZED, ACCELERATOR_OPTIMIZED_A3,ACCELERATOR_OPTIMIZED_A3_MEGA,COMPUTE_OPTIMIZED, COMPUTE_OPTIMIZED_C2D, + * COMPUTE_OPTIMIZED_C3, COMPUTE_OPTIMIZED_C3D,COMPUTE_OPTIMIZED_H3, GENERAL_PURPOSE,GENERAL_PURPOSE_C4, GENERAL_PURPOSE_E2,GENERAL_PURPOSE_N2, GENERAL_PURPOSE_N2D,GENERAL_PURPOSE_N4, GENERAL_PURPOSE_T2D,GRAPHICS_OPTIMIZED, MEMORY_OPTIMIZED,MEMORY_OPTIMIZED_M3, MEMORY_OPTIMIZED_X4,STORAGE_OPTIMIZED_Z3. + * For example, type MEMORY_OPTIMIZED specifies a commitment + * that applies only to eligible resources of memory optimized M1 and M2 + * machine series. Type GENERAL_PURPOSE specifies a commitment + * that applies only to eligible resources of general purpose N1 machine + * series. * Check the Type enum for the list of possible values. * * Generated from protobuf field optional string type = 3575610; @@ -995,7 +1214,17 @@ public function clearType() } /** - * The type of commitment; specifies the machine series for which you want to commit to purchasing resources. The choice of machine series affects the discount rate and the eligible resource types. The type must be one of the following: ACCELERATOR_OPTIMIZED, ACCELERATOR_OPTIMIZED_A3, ACCELERATOR_OPTIMIZED_A3_MEGA, COMPUTE_OPTIMIZED, COMPUTE_OPTIMIZED_C2D, COMPUTE_OPTIMIZED_C3, COMPUTE_OPTIMIZED_C3D, COMPUTE_OPTIMIZED_H3, GENERAL_PURPOSE, GENERAL_PURPOSE_C4, GENERAL_PURPOSE_E2, GENERAL_PURPOSE_N2, GENERAL_PURPOSE_N2D, GENERAL_PURPOSE_N4, GENERAL_PURPOSE_T2D, GRAPHICS_OPTIMIZED, MEMORY_OPTIMIZED, MEMORY_OPTIMIZED_M3, MEMORY_OPTIMIZED_X4, STORAGE_OPTIMIZED_Z3. For example, type MEMORY_OPTIMIZED specifies a commitment that applies only to eligible resources of memory optimized M1 and M2 machine series. Type GENERAL_PURPOSE specifies a commitment that applies only to eligible resources of general purpose N1 machine series. + * The type of commitment; specifies the + * machine series for which you want to commit to purchasing resources. + * The choice of machine series affects the discount rate and the eligible + * resource types. + * The type must be one of the following:ACCELERATOR_OPTIMIZED, ACCELERATOR_OPTIMIZED_A3,ACCELERATOR_OPTIMIZED_A3_MEGA,COMPUTE_OPTIMIZED, COMPUTE_OPTIMIZED_C2D, + * COMPUTE_OPTIMIZED_C3, COMPUTE_OPTIMIZED_C3D,COMPUTE_OPTIMIZED_H3, GENERAL_PURPOSE,GENERAL_PURPOSE_C4, GENERAL_PURPOSE_E2,GENERAL_PURPOSE_N2, GENERAL_PURPOSE_N2D,GENERAL_PURPOSE_N4, GENERAL_PURPOSE_T2D,GRAPHICS_OPTIMIZED, MEMORY_OPTIMIZED,MEMORY_OPTIMIZED_M3, MEMORY_OPTIMIZED_X4,STORAGE_OPTIMIZED_Z3. + * For example, type MEMORY_OPTIMIZED specifies a commitment + * that applies only to eligible resources of memory optimized M1 and M2 + * machine series. Type GENERAL_PURPOSE specifies a commitment + * that applies only to eligible resources of general purpose N1 machine + * series. * Check the Type enum for the list of possible values. * * Generated from protobuf field optional string type = 3575610; diff --git a/Compute/src/V1/Commitment/Category.php b/Compute/src/V1/Commitment/Category.php index dda923cb69bf..26d79990af27 100644 --- a/Compute/src/V1/Commitment/Category.php +++ b/Compute/src/V1/Commitment/Category.php @@ -7,7 +7,14 @@ use UnexpectedValueException; /** - * The category of the commitment; specifies whether the commitment is for hardware or software resources. Category MACHINE specifies that you are committing to hardware machine resources such as VCPU or MEMORY, listed in resources. Category LICENSE specifies that you are committing to software licenses, listed in licenseResources. Note that if you specify MACHINE commitments, then you must also specify a type to indicate the machine series of the hardware resource that you are committing to. + * The category of the commitment; specifies whether the commitment is for + * hardware or software resources. Category MACHINE specifies + * that you are committing to hardware machine resources such asVCPU or MEMORY, listed in resources. + * Category LICENSE specifies that you are committing to software + * licenses, listed in licenseResources. + * Note that if you specify MACHINE commitments, then you must + * also specify a type to indicate the machine series of the + * hardware resource that you are committing to. * * Protobuf type google.cloud.compute.v1.Commitment.Category */ diff --git a/Compute/src/V1/Commitment/Plan.php b/Compute/src/V1/Commitment/Plan.php index 2a6bae05a9bd..8b87900507ea 100644 --- a/Compute/src/V1/Commitment/Plan.php +++ b/Compute/src/V1/Commitment/Plan.php @@ -7,7 +7,12 @@ use UnexpectedValueException; /** - * The minimum time duration that you commit to purchasing resources. The plan that you choose determines the preset term length of the commitment (which is 1 year or 3 years) and affects the discount rate that you receive for your resources. Committing to a longer time duration typically gives you a higher discount rate. The supported values for this field are TWELVE_MONTH (1 year), and THIRTY_SIX_MONTH (3 years). + * The minimum time duration that you commit to purchasing resources. + * The plan that you choose determines the preset term length of the + * commitment (which is 1 year or 3 years) and affects the discount rate that + * you receive for your resources. Committing to a longer time duration + * typically gives you a higher discount rate. The supported values for this + * field are TWELVE_MONTH (1 year), andTHIRTY_SIX_MONTH (3 years). * * Protobuf type google.cloud.compute.v1.Commitment.Plan */ diff --git a/Compute/src/V1/Commitment/Status.php b/Compute/src/V1/Commitment/Status.php index 814e466a59f5..28a10f7a9ddd 100644 --- a/Compute/src/V1/Commitment/Status.php +++ b/Compute/src/V1/Commitment/Status.php @@ -7,7 +7,9 @@ use UnexpectedValueException; /** - * [Output Only] Status of the commitment with regards to eventual expiration (each commitment has an end date defined). Status can be one of the following values: NOT_YET_ACTIVE, ACTIVE, or EXPIRED. + * [Output Only] Status of the commitment with regards to eventual expiration + * (each commitment has an end date defined). Status can be one of the + * following values: NOT_YET_ACTIVE, ACTIVE, orEXPIRED. * * Protobuf type google.cloud.compute.v1.Commitment.Status */ @@ -24,7 +26,8 @@ class Status */ const ACTIVE = 314733318; /** - * Deprecate CANCELED status. Will use separate status to differentiate cancel by mergeCud or manual cancellation. + * Deprecate CANCELED status. Will use separate status to differentiate + * cancel by mergeCud or manual cancellation. * * Generated from protobuf enum CANCELLED = 41957681; */ diff --git a/Compute/src/V1/Commitment/Type.php b/Compute/src/V1/Commitment/Type.php index c8cc14402fe3..c4028d6fcd4b 100644 --- a/Compute/src/V1/Commitment/Type.php +++ b/Compute/src/V1/Commitment/Type.php @@ -7,7 +7,17 @@ use UnexpectedValueException; /** - * The type of commitment; specifies the machine series for which you want to commit to purchasing resources. The choice of machine series affects the discount rate and the eligible resource types. The type must be one of the following: ACCELERATOR_OPTIMIZED, ACCELERATOR_OPTIMIZED_A3, ACCELERATOR_OPTIMIZED_A3_MEGA, COMPUTE_OPTIMIZED, COMPUTE_OPTIMIZED_C2D, COMPUTE_OPTIMIZED_C3, COMPUTE_OPTIMIZED_C3D, COMPUTE_OPTIMIZED_H3, GENERAL_PURPOSE, GENERAL_PURPOSE_C4, GENERAL_PURPOSE_E2, GENERAL_PURPOSE_N2, GENERAL_PURPOSE_N2D, GENERAL_PURPOSE_N4, GENERAL_PURPOSE_T2D, GRAPHICS_OPTIMIZED, MEMORY_OPTIMIZED, MEMORY_OPTIMIZED_M3, MEMORY_OPTIMIZED_X4, STORAGE_OPTIMIZED_Z3. For example, type MEMORY_OPTIMIZED specifies a commitment that applies only to eligible resources of memory optimized M1 and M2 machine series. Type GENERAL_PURPOSE specifies a commitment that applies only to eligible resources of general purpose N1 machine series. + * The type of commitment; specifies the + * machine series for which you want to commit to purchasing resources. + * The choice of machine series affects the discount rate and the eligible + * resource types. + * The type must be one of the following:ACCELERATOR_OPTIMIZED, ACCELERATOR_OPTIMIZED_A3,ACCELERATOR_OPTIMIZED_A3_MEGA,COMPUTE_OPTIMIZED, COMPUTE_OPTIMIZED_C2D, + * COMPUTE_OPTIMIZED_C3, COMPUTE_OPTIMIZED_C3D,COMPUTE_OPTIMIZED_H3, GENERAL_PURPOSE,GENERAL_PURPOSE_C4, GENERAL_PURPOSE_E2,GENERAL_PURPOSE_N2, GENERAL_PURPOSE_N2D,GENERAL_PURPOSE_N4, GENERAL_PURPOSE_T2D,GRAPHICS_OPTIMIZED, MEMORY_OPTIMIZED,MEMORY_OPTIMIZED_M3, MEMORY_OPTIMIZED_X4,STORAGE_OPTIMIZED_Z3. + * For example, type MEMORY_OPTIMIZED specifies a commitment + * that applies only to eligible resources of memory optimized M1 and M2 + * machine series. Type GENERAL_PURPOSE specifies a commitment + * that applies only to eligible resources of general purpose N1 machine + * series. * * Protobuf type google.cloud.compute.v1.Commitment.Type */ @@ -95,6 +105,10 @@ class Type * Generated from protobuf enum GENERAL_PURPOSE_N4 = 301912158; */ const GENERAL_PURPOSE_N4 = 301912158; + /** + * Generated from protobuf enum GENERAL_PURPOSE_N4D = 232471462; + */ + const GENERAL_PURPOSE_N4D = 232471462; /** * Generated from protobuf enum GENERAL_PURPOSE_T2D = 232477166; */ @@ -136,7 +150,9 @@ class Type */ const STORAGE_OPTIMIZED_Z3 = 316796085; /** - * Note for internal users: When adding a new enum Type for v1, make sure to also add it in the comment for the `optional Type type` definition. This ensures that the public documentation displays the new enum Type. + * Note for internal users: When adding a new enum Type for v1, make sure + * to also add it in the comment for the `optional Type type` definition. + * This ensures that the public documentation displays the new enum Type. * * Generated from protobuf enum TYPE_UNSPECIFIED = 437714322; */ @@ -163,6 +179,7 @@ class Type self::GENERAL_PURPOSE_N2 => 'GENERAL_PURPOSE_N2', self::GENERAL_PURPOSE_N2D => 'GENERAL_PURPOSE_N2D', self::GENERAL_PURPOSE_N4 => 'GENERAL_PURPOSE_N4', + self::GENERAL_PURPOSE_N4D => 'GENERAL_PURPOSE_N4D', self::GENERAL_PURPOSE_T2D => 'GENERAL_PURPOSE_T2D', self::GRAPHICS_OPTIMIZED => 'GRAPHICS_OPTIMIZED', self::MEMORY_OPTIMIZED => 'MEMORY_OPTIMIZED', diff --git a/Compute/src/V1/CommitmentAggregatedList.php b/Compute/src/V1/CommitmentAggregatedList.php index b1a63b295e64..7ec02e8732d9 100644 --- a/Compute/src/V1/CommitmentAggregatedList.php +++ b/Compute/src/V1/CommitmentAggregatedList.php @@ -27,13 +27,18 @@ class CommitmentAggregatedList extends \Google\Protobuf\Internal\Message */ private $items; /** - * [Output Only] Type of resource. Always compute#commitmentAggregatedList for aggregated lists of commitments. + * [Output Only] Type of resource. Alwayscompute#commitmentAggregatedList for aggregated lists of + * commitments. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -68,9 +73,14 @@ class CommitmentAggregatedList extends \Google\Protobuf\Internal\Message * @type array|\Google\Protobuf\Internal\MapField $items * A list of CommitmentsScopedList resources. * @type string $kind - * [Output Only] Type of resource. Always compute#commitmentAggregatedList for aggregated lists of commitments. + * [Output Only] Type of resource. Alwayscompute#commitmentAggregatedList for aggregated lists of + * commitments. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type array|\Google\Protobuf\Internal\RepeatedField $unreachables @@ -147,7 +157,8 @@ public function setItems($var) } /** - * [Output Only] Type of resource. Always compute#commitmentAggregatedList for aggregated lists of commitments. + * [Output Only] Type of resource. Alwayscompute#commitmentAggregatedList for aggregated lists of + * commitments. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -168,7 +179,8 @@ public function clearKind() } /** - * [Output Only] Type of resource. Always compute#commitmentAggregatedList for aggregated lists of commitments. + * [Output Only] Type of resource. Alwayscompute#commitmentAggregatedList for aggregated lists of + * commitments. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -183,7 +195,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -204,7 +220,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/CommitmentList.php b/Compute/src/V1/CommitmentList.php index 0452101976dc..11be8e9f9858 100644 --- a/Compute/src/V1/CommitmentList.php +++ b/Compute/src/V1/CommitmentList.php @@ -28,13 +28,18 @@ class CommitmentList extends \Google\Protobuf\Internal\Message */ private $items; /** - * [Output Only] Type of resource. Always compute#commitmentList for lists of commitments. + * [Output Only] Type of resource. Always compute#commitmentList + * for lists of commitments. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -63,9 +68,14 @@ class CommitmentList extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\Commitment>|\Google\Protobuf\Internal\RepeatedField $items * A list of Commitment resources. * @type string $kind - * [Output Only] Type of resource. Always compute#commitmentList for lists of commitments. + * [Output Only] Type of resource. Always compute#commitmentList + * for lists of commitments. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type \Google\Cloud\Compute\V1\Warning $warning @@ -140,7 +150,8 @@ public function setItems($var) } /** - * [Output Only] Type of resource. Always compute#commitmentList for lists of commitments. + * [Output Only] Type of resource. Always compute#commitmentList + * for lists of commitments. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -161,7 +172,8 @@ public function clearKind() } /** - * [Output Only] Type of resource. Always compute#commitmentList for lists of commitments. + * [Output Only] Type of resource. Always compute#commitmentList + * for lists of commitments. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -176,7 +188,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -197,7 +213,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/CommitmentResourceStatus.php b/Compute/src/V1/CommitmentResourceStatus.php index 9803184c5f75..39be8e2a92ac 100644 --- a/Compute/src/V1/CommitmentResourceStatus.php +++ b/Compute/src/V1/CommitmentResourceStatus.php @@ -16,7 +16,9 @@ class CommitmentResourceStatus extends \Google\Protobuf\Internal\Message { /** - * [Output Only] Indicates the end time of customer's eligibility to send custom term requests in RFC3339 text format. Term extension requests that (not the end time in the request) after this time will be rejected. + * [Output Only] Indicates the end time of customer's eligibility to send + * custom term requests in RFC3339 text format. Term extension requests that + * (not the end time in the request) after this time will be rejected. * * Generated from protobuf field optional string custom_term_eligibility_end_timestamp = 363976187; */ @@ -29,7 +31,9 @@ class CommitmentResourceStatus extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $custom_term_eligibility_end_timestamp - * [Output Only] Indicates the end time of customer's eligibility to send custom term requests in RFC3339 text format. Term extension requests that (not the end time in the request) after this time will be rejected. + * [Output Only] Indicates the end time of customer's eligibility to send + * custom term requests in RFC3339 text format. Term extension requests that + * (not the end time in the request) after this time will be rejected. * } */ public function __construct($data = NULL) { @@ -38,7 +42,9 @@ public function __construct($data = NULL) { } /** - * [Output Only] Indicates the end time of customer's eligibility to send custom term requests in RFC3339 text format. Term extension requests that (not the end time in the request) after this time will be rejected. + * [Output Only] Indicates the end time of customer's eligibility to send + * custom term requests in RFC3339 text format. Term extension requests that + * (not the end time in the request) after this time will be rejected. * * Generated from protobuf field optional string custom_term_eligibility_end_timestamp = 363976187; * @return string @@ -59,7 +65,9 @@ public function clearCustomTermEligibilityEndTimestamp() } /** - * [Output Only] Indicates the end time of customer's eligibility to send custom term requests in RFC3339 text format. Term extension requests that (not the end time in the request) after this time will be rejected. + * [Output Only] Indicates the end time of customer's eligibility to send + * custom term requests in RFC3339 text format. Term extension requests that + * (not the end time in the request) after this time will be rejected. * * Generated from protobuf field optional string custom_term_eligibility_end_timestamp = 363976187; * @param string $var diff --git a/Compute/src/V1/CommitmentsScopedList.php b/Compute/src/V1/CommitmentsScopedList.php index d6b84033f228..4541959e8aeb 100644 --- a/Compute/src/V1/CommitmentsScopedList.php +++ b/Compute/src/V1/CommitmentsScopedList.php @@ -21,7 +21,8 @@ class CommitmentsScopedList extends \Google\Protobuf\Internal\Message */ private $commitments; /** - * [Output Only] Informational warning which replaces the list of commitments when the list is empty. + * [Output Only] Informational warning which replaces the list of commitments + * when the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; */ @@ -36,7 +37,8 @@ class CommitmentsScopedList extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\Commitment>|\Google\Protobuf\Internal\RepeatedField $commitments * [Output Only] The list of commitments contained in this scope. * @type \Google\Cloud\Compute\V1\Warning $warning - * [Output Only] Informational warning which replaces the list of commitments when the list is empty. + * [Output Only] Informational warning which replaces the list of commitments + * when the list is empty. * } */ public function __construct($data = NULL) { @@ -71,7 +73,8 @@ public function setCommitments($var) } /** - * [Output Only] Informational warning which replaces the list of commitments when the list is empty. + * [Output Only] Informational warning which replaces the list of commitments + * when the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; * @return \Google\Cloud\Compute\V1\Warning|null @@ -92,7 +95,8 @@ public function clearWarning() } /** - * [Output Only] Informational warning which replaces the list of commitments when the list is empty. + * [Output Only] Informational warning which replaces the list of commitments + * when the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; * @param \Google\Cloud\Compute\V1\Warning $var diff --git a/Compute/src/V1/ConnectionDraining.php b/Compute/src/V1/ConnectionDraining.php index 18e70071893a..3ae18d173e1a 100644 --- a/Compute/src/V1/ConnectionDraining.php +++ b/Compute/src/V1/ConnectionDraining.php @@ -16,7 +16,9 @@ class ConnectionDraining extends \Google\Protobuf\Internal\Message { /** - * Configures a duration timeout for existing requests on a removed backend instance. For supported load balancers and protocols, as described in Enabling connection draining. + * Configures a duration timeout for existing requests on a removed backend + * instance. For supported load balancers and protocols, as described inEnabling + * connection draining. * * Generated from protobuf field optional int32 draining_timeout_sec = 225127070; */ @@ -29,7 +31,9 @@ class ConnectionDraining extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type int $draining_timeout_sec - * Configures a duration timeout for existing requests on a removed backend instance. For supported load balancers and protocols, as described in Enabling connection draining. + * Configures a duration timeout for existing requests on a removed backend + * instance. For supported load balancers and protocols, as described inEnabling + * connection draining. * } */ public function __construct($data = NULL) { @@ -38,7 +42,9 @@ public function __construct($data = NULL) { } /** - * Configures a duration timeout for existing requests on a removed backend instance. For supported load balancers and protocols, as described in Enabling connection draining. + * Configures a duration timeout for existing requests on a removed backend + * instance. For supported load balancers and protocols, as described inEnabling + * connection draining. * * Generated from protobuf field optional int32 draining_timeout_sec = 225127070; * @return int @@ -59,7 +65,9 @@ public function clearDrainingTimeoutSec() } /** - * Configures a duration timeout for existing requests on a removed backend instance. For supported load balancers and protocols, as described in Enabling connection draining. + * Configures a duration timeout for existing requests on a removed backend + * instance. For supported load balancers and protocols, as described inEnabling + * connection draining. * * Generated from protobuf field optional int32 draining_timeout_sec = 225127070; * @param int $var diff --git a/Compute/src/V1/ConsistentHashLoadBalancerSettings.php b/Compute/src/V1/ConsistentHashLoadBalancerSettings.php index c1f481293536..92505fe7d989 100644 --- a/Compute/src/V1/ConsistentHashLoadBalancerSettings.php +++ b/Compute/src/V1/ConsistentHashLoadBalancerSettings.php @@ -16,19 +16,28 @@ class ConsistentHashLoadBalancerSettings extends \Google\Protobuf\Internal\Message { /** - * Hash is based on HTTP Cookie. This field describes a HTTP cookie that will be used as the hash key for the consistent hash load balancer. If the cookie is not present, it will be generated. This field is applicable if the sessionAffinity is set to HTTP_COOKIE. Not supported when the backend service is referenced by a URL map that is bound to target gRPC proxy that has validateForProxyless field set to true. + * Hash is based on HTTP Cookie. This field describes a HTTP cookie that will + * be used as the hash key for the consistent hash load balancer. If the + * cookie is not present, it will be generated. This field is applicable if + * the sessionAffinity is set to HTTP_COOKIE. + * Not supported when the backend service is referenced by a URL map that is + * bound to target gRPC proxy that has validateForProxyless field set to true. * * Generated from protobuf field optional .google.cloud.compute.v1.ConsistentHashLoadBalancerSettingsHttpCookie http_cookie = 6673915; */ protected $http_cookie = null; /** - * The hash based on the value of the specified header field. This field is applicable if the sessionAffinity is set to HEADER_FIELD. + * The hash based on the value of the specified header field. This field is + * applicable if the sessionAffinity is set toHEADER_FIELD. * * Generated from protobuf field optional string http_header_name = 234798022; */ protected $http_header_name = null; /** - * The minimum number of virtual nodes to use for the hash ring. Defaults to 1024. Larger ring sizes result in more granular load distributions. If the number of hosts in the load balancing pool is larger than the ring size, each host will be assigned a single virtual node. + * The minimum number of virtual nodes to use for the hash ring. Defaults to + * 1024. Larger ring sizes result in more granular load distributions. If the + * number of hosts in the load balancing pool is larger than the ring size, + * each host will be assigned a single virtual node. * * Generated from protobuf field optional int64 minimum_ring_size = 234380735; */ @@ -41,11 +50,20 @@ class ConsistentHashLoadBalancerSettings extends \Google\Protobuf\Internal\Messa * Optional. Data for populating the Message object. * * @type \Google\Cloud\Compute\V1\ConsistentHashLoadBalancerSettingsHttpCookie $http_cookie - * Hash is based on HTTP Cookie. This field describes a HTTP cookie that will be used as the hash key for the consistent hash load balancer. If the cookie is not present, it will be generated. This field is applicable if the sessionAffinity is set to HTTP_COOKIE. Not supported when the backend service is referenced by a URL map that is bound to target gRPC proxy that has validateForProxyless field set to true. + * Hash is based on HTTP Cookie. This field describes a HTTP cookie that will + * be used as the hash key for the consistent hash load balancer. If the + * cookie is not present, it will be generated. This field is applicable if + * the sessionAffinity is set to HTTP_COOKIE. + * Not supported when the backend service is referenced by a URL map that is + * bound to target gRPC proxy that has validateForProxyless field set to true. * @type string $http_header_name - * The hash based on the value of the specified header field. This field is applicable if the sessionAffinity is set to HEADER_FIELD. + * The hash based on the value of the specified header field. This field is + * applicable if the sessionAffinity is set toHEADER_FIELD. * @type int|string $minimum_ring_size - * The minimum number of virtual nodes to use for the hash ring. Defaults to 1024. Larger ring sizes result in more granular load distributions. If the number of hosts in the load balancing pool is larger than the ring size, each host will be assigned a single virtual node. + * The minimum number of virtual nodes to use for the hash ring. Defaults to + * 1024. Larger ring sizes result in more granular load distributions. If the + * number of hosts in the load balancing pool is larger than the ring size, + * each host will be assigned a single virtual node. * } */ public function __construct($data = NULL) { @@ -54,7 +72,12 @@ public function __construct($data = NULL) { } /** - * Hash is based on HTTP Cookie. This field describes a HTTP cookie that will be used as the hash key for the consistent hash load balancer. If the cookie is not present, it will be generated. This field is applicable if the sessionAffinity is set to HTTP_COOKIE. Not supported when the backend service is referenced by a URL map that is bound to target gRPC proxy that has validateForProxyless field set to true. + * Hash is based on HTTP Cookie. This field describes a HTTP cookie that will + * be used as the hash key for the consistent hash load balancer. If the + * cookie is not present, it will be generated. This field is applicable if + * the sessionAffinity is set to HTTP_COOKIE. + * Not supported when the backend service is referenced by a URL map that is + * bound to target gRPC proxy that has validateForProxyless field set to true. * * Generated from protobuf field optional .google.cloud.compute.v1.ConsistentHashLoadBalancerSettingsHttpCookie http_cookie = 6673915; * @return \Google\Cloud\Compute\V1\ConsistentHashLoadBalancerSettingsHttpCookie|null @@ -75,7 +98,12 @@ public function clearHttpCookie() } /** - * Hash is based on HTTP Cookie. This field describes a HTTP cookie that will be used as the hash key for the consistent hash load balancer. If the cookie is not present, it will be generated. This field is applicable if the sessionAffinity is set to HTTP_COOKIE. Not supported when the backend service is referenced by a URL map that is bound to target gRPC proxy that has validateForProxyless field set to true. + * Hash is based on HTTP Cookie. This field describes a HTTP cookie that will + * be used as the hash key for the consistent hash load balancer. If the + * cookie is not present, it will be generated. This field is applicable if + * the sessionAffinity is set to HTTP_COOKIE. + * Not supported when the backend service is referenced by a URL map that is + * bound to target gRPC proxy that has validateForProxyless field set to true. * * Generated from protobuf field optional .google.cloud.compute.v1.ConsistentHashLoadBalancerSettingsHttpCookie http_cookie = 6673915; * @param \Google\Cloud\Compute\V1\ConsistentHashLoadBalancerSettingsHttpCookie $var @@ -90,7 +118,8 @@ public function setHttpCookie($var) } /** - * The hash based on the value of the specified header field. This field is applicable if the sessionAffinity is set to HEADER_FIELD. + * The hash based on the value of the specified header field. This field is + * applicable if the sessionAffinity is set toHEADER_FIELD. * * Generated from protobuf field optional string http_header_name = 234798022; * @return string @@ -111,7 +140,8 @@ public function clearHttpHeaderName() } /** - * The hash based on the value of the specified header field. This field is applicable if the sessionAffinity is set to HEADER_FIELD. + * The hash based on the value of the specified header field. This field is + * applicable if the sessionAffinity is set toHEADER_FIELD. * * Generated from protobuf field optional string http_header_name = 234798022; * @param string $var @@ -126,7 +156,10 @@ public function setHttpHeaderName($var) } /** - * The minimum number of virtual nodes to use for the hash ring. Defaults to 1024. Larger ring sizes result in more granular load distributions. If the number of hosts in the load balancing pool is larger than the ring size, each host will be assigned a single virtual node. + * The minimum number of virtual nodes to use for the hash ring. Defaults to + * 1024. Larger ring sizes result in more granular load distributions. If the + * number of hosts in the load balancing pool is larger than the ring size, + * each host will be assigned a single virtual node. * * Generated from protobuf field optional int64 minimum_ring_size = 234380735; * @return int|string @@ -147,7 +180,10 @@ public function clearMinimumRingSize() } /** - * The minimum number of virtual nodes to use for the hash ring. Defaults to 1024. Larger ring sizes result in more granular load distributions. If the number of hosts in the load balancing pool is larger than the ring size, each host will be assigned a single virtual node. + * The minimum number of virtual nodes to use for the hash ring. Defaults to + * 1024. Larger ring sizes result in more granular load distributions. If the + * number of hosts in the load balancing pool is larger than the ring size, + * each host will be assigned a single virtual node. * * Generated from protobuf field optional int64 minimum_ring_size = 234380735; * @param int|string $var diff --git a/Compute/src/V1/ConsistentHashLoadBalancerSettingsHttpCookie.php b/Compute/src/V1/ConsistentHashLoadBalancerSettingsHttpCookie.php index 964b87a9026c..0ac70f76b1f6 100644 --- a/Compute/src/V1/ConsistentHashLoadBalancerSettingsHttpCookie.php +++ b/Compute/src/V1/ConsistentHashLoadBalancerSettingsHttpCookie.php @@ -9,7 +9,8 @@ use Google\Protobuf\Internal\GPBUtil; /** - * The information about the HTTP Cookie on which the hash function is based for load balancing policies that use a consistent hash. + * The information about the HTTP Cookie on which the hash function is based + * for load balancing policies that use a consistent hash. * * Generated from protobuf message google.cloud.compute.v1.ConsistentHashLoadBalancerSettingsHttpCookie */ diff --git a/Compute/src/V1/CopyRulesOrganizationSecurityPolicyRequest.php b/Compute/src/V1/CopyRulesOrganizationSecurityPolicyRequest.php index a2d33911b5bb..512985493aaa 100644 --- a/Compute/src/V1/CopyRulesOrganizationSecurityPolicyRequest.php +++ b/Compute/src/V1/CopyRulesOrganizationSecurityPolicyRequest.php @@ -16,7 +16,17 @@ class CopyRulesOrganizationSecurityPolicyRequest extends \Google\Protobuf\Internal\Message { /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -54,7 +64,17 @@ public static function build(string $securityPolicy): self * Optional. Data for populating the Message object. * * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $security_policy * Name of the security policy to update. * @type string $source_security_policy @@ -67,7 +87,17 @@ public function __construct($data = NULL) { } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -88,7 +118,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/CorsPolicy.php b/Compute/src/V1/CorsPolicy.php index fda854a647c1..d3e17b6e9b2d 100644 --- a/Compute/src/V1/CorsPolicy.php +++ b/Compute/src/V1/CorsPolicy.php @@ -9,56 +9,75 @@ use Google\Protobuf\Internal\GPBUtil; /** - * The specification for allowing client-side cross-origin requests. For more information about the W3C recommendation for cross-origin resource sharing (CORS), see Fetch API Living Standard. + * The specification for allowing client-side cross-origin requests. For more + * information about the W3C recommendation for cross-origin resource sharing + * (CORS), see Fetch API Living + * Standard. * * Generated from protobuf message google.cloud.compute.v1.CorsPolicy */ class CorsPolicy extends \Google\Protobuf\Internal\Message { /** - * In response to a preflight request, setting this to true indicates that the actual request can include user credentials. This field translates to the Access-Control-Allow-Credentials header. Default is false. + * In response to a preflight request, setting this to true + * indicates that + * the actual request can include user credentials. This field translates to + * the Access-Control-Allow-Credentials header. + * Default is false. * * Generated from protobuf field optional bool allow_credentials = 481263366; */ protected $allow_credentials = null; /** - * Specifies the content for the Access-Control-Allow-Headers header. + * Specifies the content for the Access-Control-Allow-Headers + * header. * * Generated from protobuf field repeated string allow_headers = 45179024; */ private $allow_headers; /** - * Specifies the content for the Access-Control-Allow-Methods header. + * Specifies the content for the Access-Control-Allow-Methods + * header. * * Generated from protobuf field repeated string allow_methods = 205405372; */ private $allow_methods; /** - * Specifies a regular expression that matches allowed origins. For more information, see regular expression syntax . An origin is allowed if it matches either an item in allowOrigins or an item in allowOriginRegexes. Regular expressions can only be used when the loadBalancingScheme is set to INTERNAL_SELF_MANAGED. + * Specifies a regular expression that matches allowed origins. For + * more information, see regular expression syntax. + * An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes. + * Regular expressions can only be used when the loadBalancingScheme is + * set to INTERNAL_SELF_MANAGED. * * Generated from protobuf field repeated string allow_origin_regexes = 215385810; */ private $allow_origin_regexes; /** - * Specifies the list of origins that is allowed to do CORS requests. An origin is allowed if it matches either an item in allowOrigins or an item in allowOriginRegexes. + * Specifies the list of origins that is allowed to do CORS requests. + * An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes. * * Generated from protobuf field repeated string allow_origins = 194914071; */ private $allow_origins; /** - * If true, disables the CORS policy. The default value is false, which indicates that the CORS policy is in effect. + * If true, disables the CORS policy. + * The default value is false, which indicates that the CORS + * policy is in effect. * * Generated from protobuf field optional bool disabled = 270940796; */ protected $disabled = null; /** - * Specifies the content for the Access-Control-Expose-Headers header. + * Specifies the content for the Access-Control-Expose-Headers + * header. * * Generated from protobuf field repeated string expose_headers = 247604747; */ private $expose_headers; /** - * Specifies how long results of a preflight request can be cached in seconds. This field translates to the Access-Control-Max-Age header. + * Specifies how long results of a preflight request can be cached in + * seconds. This field translates to the Access-Control-Max-Age + * header. * * Generated from protobuf field optional int32 max_age = 307559332; */ @@ -71,21 +90,37 @@ class CorsPolicy extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type bool $allow_credentials - * In response to a preflight request, setting this to true indicates that the actual request can include user credentials. This field translates to the Access-Control-Allow-Credentials header. Default is false. + * In response to a preflight request, setting this to true + * indicates that + * the actual request can include user credentials. This field translates to + * the Access-Control-Allow-Credentials header. + * Default is false. * @type array|\Google\Protobuf\Internal\RepeatedField $allow_headers - * Specifies the content for the Access-Control-Allow-Headers header. + * Specifies the content for the Access-Control-Allow-Headers + * header. * @type array|\Google\Protobuf\Internal\RepeatedField $allow_methods - * Specifies the content for the Access-Control-Allow-Methods header. + * Specifies the content for the Access-Control-Allow-Methods + * header. * @type array|\Google\Protobuf\Internal\RepeatedField $allow_origin_regexes - * Specifies a regular expression that matches allowed origins. For more information, see regular expression syntax . An origin is allowed if it matches either an item in allowOrigins or an item in allowOriginRegexes. Regular expressions can only be used when the loadBalancingScheme is set to INTERNAL_SELF_MANAGED. + * Specifies a regular expression that matches allowed origins. For + * more information, see regular expression syntax. + * An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes. + * Regular expressions can only be used when the loadBalancingScheme is + * set to INTERNAL_SELF_MANAGED. * @type array|\Google\Protobuf\Internal\RepeatedField $allow_origins - * Specifies the list of origins that is allowed to do CORS requests. An origin is allowed if it matches either an item in allowOrigins or an item in allowOriginRegexes. + * Specifies the list of origins that is allowed to do CORS requests. + * An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes. * @type bool $disabled - * If true, disables the CORS policy. The default value is false, which indicates that the CORS policy is in effect. + * If true, disables the CORS policy. + * The default value is false, which indicates that the CORS + * policy is in effect. * @type array|\Google\Protobuf\Internal\RepeatedField $expose_headers - * Specifies the content for the Access-Control-Expose-Headers header. + * Specifies the content for the Access-Control-Expose-Headers + * header. * @type int $max_age - * Specifies how long results of a preflight request can be cached in seconds. This field translates to the Access-Control-Max-Age header. + * Specifies how long results of a preflight request can be cached in + * seconds. This field translates to the Access-Control-Max-Age + * header. * } */ public function __construct($data = NULL) { @@ -94,7 +129,11 @@ public function __construct($data = NULL) { } /** - * In response to a preflight request, setting this to true indicates that the actual request can include user credentials. This field translates to the Access-Control-Allow-Credentials header. Default is false. + * In response to a preflight request, setting this to true + * indicates that + * the actual request can include user credentials. This field translates to + * the Access-Control-Allow-Credentials header. + * Default is false. * * Generated from protobuf field optional bool allow_credentials = 481263366; * @return bool @@ -115,7 +154,11 @@ public function clearAllowCredentials() } /** - * In response to a preflight request, setting this to true indicates that the actual request can include user credentials. This field translates to the Access-Control-Allow-Credentials header. Default is false. + * In response to a preflight request, setting this to true + * indicates that + * the actual request can include user credentials. This field translates to + * the Access-Control-Allow-Credentials header. + * Default is false. * * Generated from protobuf field optional bool allow_credentials = 481263366; * @param bool $var @@ -130,7 +173,8 @@ public function setAllowCredentials($var) } /** - * Specifies the content for the Access-Control-Allow-Headers header. + * Specifies the content for the Access-Control-Allow-Headers + * header. * * Generated from protobuf field repeated string allow_headers = 45179024; * @return \Google\Protobuf\Internal\RepeatedField @@ -141,7 +185,8 @@ public function getAllowHeaders() } /** - * Specifies the content for the Access-Control-Allow-Headers header. + * Specifies the content for the Access-Control-Allow-Headers + * header. * * Generated from protobuf field repeated string allow_headers = 45179024; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -156,7 +201,8 @@ public function setAllowHeaders($var) } /** - * Specifies the content for the Access-Control-Allow-Methods header. + * Specifies the content for the Access-Control-Allow-Methods + * header. * * Generated from protobuf field repeated string allow_methods = 205405372; * @return \Google\Protobuf\Internal\RepeatedField @@ -167,7 +213,8 @@ public function getAllowMethods() } /** - * Specifies the content for the Access-Control-Allow-Methods header. + * Specifies the content for the Access-Control-Allow-Methods + * header. * * Generated from protobuf field repeated string allow_methods = 205405372; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -182,7 +229,11 @@ public function setAllowMethods($var) } /** - * Specifies a regular expression that matches allowed origins. For more information, see regular expression syntax . An origin is allowed if it matches either an item in allowOrigins or an item in allowOriginRegexes. Regular expressions can only be used when the loadBalancingScheme is set to INTERNAL_SELF_MANAGED. + * Specifies a regular expression that matches allowed origins. For + * more information, see regular expression syntax. + * An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes. + * Regular expressions can only be used when the loadBalancingScheme is + * set to INTERNAL_SELF_MANAGED. * * Generated from protobuf field repeated string allow_origin_regexes = 215385810; * @return \Google\Protobuf\Internal\RepeatedField @@ -193,7 +244,11 @@ public function getAllowOriginRegexes() } /** - * Specifies a regular expression that matches allowed origins. For more information, see regular expression syntax . An origin is allowed if it matches either an item in allowOrigins or an item in allowOriginRegexes. Regular expressions can only be used when the loadBalancingScheme is set to INTERNAL_SELF_MANAGED. + * Specifies a regular expression that matches allowed origins. For + * more information, see regular expression syntax. + * An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes. + * Regular expressions can only be used when the loadBalancingScheme is + * set to INTERNAL_SELF_MANAGED. * * Generated from protobuf field repeated string allow_origin_regexes = 215385810; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -208,7 +263,8 @@ public function setAllowOriginRegexes($var) } /** - * Specifies the list of origins that is allowed to do CORS requests. An origin is allowed if it matches either an item in allowOrigins or an item in allowOriginRegexes. + * Specifies the list of origins that is allowed to do CORS requests. + * An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes. * * Generated from protobuf field repeated string allow_origins = 194914071; * @return \Google\Protobuf\Internal\RepeatedField @@ -219,7 +275,8 @@ public function getAllowOrigins() } /** - * Specifies the list of origins that is allowed to do CORS requests. An origin is allowed if it matches either an item in allowOrigins or an item in allowOriginRegexes. + * Specifies the list of origins that is allowed to do CORS requests. + * An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes. * * Generated from protobuf field repeated string allow_origins = 194914071; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -234,7 +291,9 @@ public function setAllowOrigins($var) } /** - * If true, disables the CORS policy. The default value is false, which indicates that the CORS policy is in effect. + * If true, disables the CORS policy. + * The default value is false, which indicates that the CORS + * policy is in effect. * * Generated from protobuf field optional bool disabled = 270940796; * @return bool @@ -255,7 +314,9 @@ public function clearDisabled() } /** - * If true, disables the CORS policy. The default value is false, which indicates that the CORS policy is in effect. + * If true, disables the CORS policy. + * The default value is false, which indicates that the CORS + * policy is in effect. * * Generated from protobuf field optional bool disabled = 270940796; * @param bool $var @@ -270,7 +331,8 @@ public function setDisabled($var) } /** - * Specifies the content for the Access-Control-Expose-Headers header. + * Specifies the content for the Access-Control-Expose-Headers + * header. * * Generated from protobuf field repeated string expose_headers = 247604747; * @return \Google\Protobuf\Internal\RepeatedField @@ -281,7 +343,8 @@ public function getExposeHeaders() } /** - * Specifies the content for the Access-Control-Expose-Headers header. + * Specifies the content for the Access-Control-Expose-Headers + * header. * * Generated from protobuf field repeated string expose_headers = 247604747; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -296,7 +359,9 @@ public function setExposeHeaders($var) } /** - * Specifies how long results of a preflight request can be cached in seconds. This field translates to the Access-Control-Max-Age header. + * Specifies how long results of a preflight request can be cached in + * seconds. This field translates to the Access-Control-Max-Age + * header. * * Generated from protobuf field optional int32 max_age = 307559332; * @return int @@ -317,7 +382,9 @@ public function clearMaxAge() } /** - * Specifies how long results of a preflight request can be cached in seconds. This field translates to the Access-Control-Max-Age header. + * Specifies how long results of a preflight request can be cached in + * seconds. This field translates to the Access-Control-Max-Age + * header. * * Generated from protobuf field optional int32 max_age = 307559332; * @param int $var diff --git a/Compute/src/V1/CreateInstancesInstanceGroupManagerRequest.php b/Compute/src/V1/CreateInstancesInstanceGroupManagerRequest.php index d51a8dabea87..f441dda7f01d 100644 --- a/Compute/src/V1/CreateInstancesInstanceGroupManagerRequest.php +++ b/Compute/src/V1/CreateInstancesInstanceGroupManagerRequest.php @@ -16,7 +16,8 @@ class CreateInstancesInstanceGroupManagerRequest extends \Google\Protobuf\Internal\Message { /** - * The name of the managed instance group. It should conform to RFC1035. + * The name of the managed instance group. + * It should conform to RFC1035. * * Generated from protobuf field string instance_group_manager = 249363395 [(.google.api.field_behavior) = REQUIRED]; */ @@ -34,13 +35,24 @@ class CreateInstancesInstanceGroupManagerRequest extends \Google\Protobuf\Intern */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ protected $request_id = null; /** - * The name of the zone where the managed instance group is located. It should conform to RFC1035. + * The name of thezone + * where the managed instance group is located. + * It should conform to RFC1035. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; */ @@ -48,8 +60,11 @@ class CreateInstancesInstanceGroupManagerRequest extends \Google\Protobuf\Intern /** * @param string $project Project ID for this request. - * @param string $zone The name of the zone where the managed instance group is located. It should conform to RFC1035. - * @param string $instanceGroupManager The name of the managed instance group. It should conform to RFC1035. + * @param string $zone The name of thezone + * where the managed instance group is located. + * It should conform to RFC1035. + * @param string $instanceGroupManager The name of the managed instance group. + * It should conform to RFC1035. * @param \Google\Cloud\Compute\V1\InstanceGroupManagersCreateInstancesRequest $instanceGroupManagersCreateInstancesRequestResource The body resource for this request * * @return \Google\Cloud\Compute\V1\CreateInstancesInstanceGroupManagerRequest @@ -72,15 +87,27 @@ public static function build(string $project, string $zone, string $instanceGrou * Optional. Data for populating the Message object. * * @type string $instance_group_manager - * The name of the managed instance group. It should conform to RFC1035. + * The name of the managed instance group. + * It should conform to RFC1035. * @type \Google\Cloud\Compute\V1\InstanceGroupManagersCreateInstancesRequest $instance_group_managers_create_instances_request_resource * The body resource for this request * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $zone - * The name of the zone where the managed instance group is located. It should conform to RFC1035. + * The name of thezone + * where the managed instance group is located. + * It should conform to RFC1035. * } */ public function __construct($data = NULL) { @@ -89,7 +116,8 @@ public function __construct($data = NULL) { } /** - * The name of the managed instance group. It should conform to RFC1035. + * The name of the managed instance group. + * It should conform to RFC1035. * * Generated from protobuf field string instance_group_manager = 249363395 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -100,7 +128,8 @@ public function getInstanceGroupManager() } /** - * The name of the managed instance group. It should conform to RFC1035. + * The name of the managed instance group. + * It should conform to RFC1035. * * Generated from protobuf field string instance_group_manager = 249363395 [(.google.api.field_behavior) = REQUIRED]; * @param string $var @@ -177,7 +206,16 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -198,7 +236,16 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var @@ -213,7 +260,9 @@ public function setRequestId($var) } /** - * The name of the zone where the managed instance group is located. It should conform to RFC1035. + * The name of thezone + * where the managed instance group is located. + * It should conform to RFC1035. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; * @return string @@ -224,7 +273,9 @@ public function getZone() } /** - * The name of the zone where the managed instance group is located. It should conform to RFC1035. + * The name of thezone + * where the managed instance group is located. + * It should conform to RFC1035. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; * @param string $var diff --git a/Compute/src/V1/CreateInstancesRegionInstanceGroupManagerRequest.php b/Compute/src/V1/CreateInstancesRegionInstanceGroupManagerRequest.php index 799663b8e322..513a86f4c809 100644 --- a/Compute/src/V1/CreateInstancesRegionInstanceGroupManagerRequest.php +++ b/Compute/src/V1/CreateInstancesRegionInstanceGroupManagerRequest.php @@ -16,7 +16,8 @@ class CreateInstancesRegionInstanceGroupManagerRequest extends \Google\Protobuf\Internal\Message { /** - * The name of the managed instance group. It should conform to RFC1035. + * The name of the managed instance group. + * It should conform to RFC1035. * * Generated from protobuf field string instance_group_manager = 249363395 [(.google.api.field_behavior) = REQUIRED]; */ @@ -28,7 +29,9 @@ class CreateInstancesRegionInstanceGroupManagerRequest extends \Google\Protobuf\ */ protected $project = ''; /** - * The name of the region where the managed instance group is located. It should conform to RFC1035. + * The name of theregion + * where the managed instance group is located. + * It should conform to RFC1035. * * Generated from protobuf field string region = 138946292 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "region"]; */ @@ -40,7 +43,16 @@ class CreateInstancesRegionInstanceGroupManagerRequest extends \Google\Protobuf\ */ protected $region_instance_group_managers_create_instances_request_resource = null; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -48,8 +60,11 @@ class CreateInstancesRegionInstanceGroupManagerRequest extends \Google\Protobuf\ /** * @param string $project Project ID for this request. - * @param string $region The name of the region where the managed instance group is located. It should conform to RFC1035. - * @param string $instanceGroupManager The name of the managed instance group. It should conform to RFC1035. + * @param string $region The name of theregion + * where the managed instance group is located. + * It should conform to RFC1035. + * @param string $instanceGroupManager The name of the managed instance group. + * It should conform to RFC1035. * @param \Google\Cloud\Compute\V1\RegionInstanceGroupManagersCreateInstancesRequest $regionInstanceGroupManagersCreateInstancesRequestResource The body resource for this request * * @return \Google\Cloud\Compute\V1\CreateInstancesRegionInstanceGroupManagerRequest @@ -72,15 +87,27 @@ public static function build(string $project, string $region, string $instanceGr * Optional. Data for populating the Message object. * * @type string $instance_group_manager - * The name of the managed instance group. It should conform to RFC1035. + * The name of the managed instance group. + * It should conform to RFC1035. * @type string $project * Project ID for this request. * @type string $region - * The name of the region where the managed instance group is located. It should conform to RFC1035. + * The name of theregion + * where the managed instance group is located. + * It should conform to RFC1035. * @type \Google\Cloud\Compute\V1\RegionInstanceGroupManagersCreateInstancesRequest $region_instance_group_managers_create_instances_request_resource * The body resource for this request * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -89,7 +116,8 @@ public function __construct($data = NULL) { } /** - * The name of the managed instance group. It should conform to RFC1035. + * The name of the managed instance group. + * It should conform to RFC1035. * * Generated from protobuf field string instance_group_manager = 249363395 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -100,7 +128,8 @@ public function getInstanceGroupManager() } /** - * The name of the managed instance group. It should conform to RFC1035. + * The name of the managed instance group. + * It should conform to RFC1035. * * Generated from protobuf field string instance_group_manager = 249363395 [(.google.api.field_behavior) = REQUIRED]; * @param string $var @@ -141,7 +170,9 @@ public function setProject($var) } /** - * The name of the region where the managed instance group is located. It should conform to RFC1035. + * The name of theregion + * where the managed instance group is located. + * It should conform to RFC1035. * * Generated from protobuf field string region = 138946292 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "region"]; * @return string @@ -152,7 +183,9 @@ public function getRegion() } /** - * The name of the region where the managed instance group is located. It should conform to RFC1035. + * The name of theregion + * where the managed instance group is located. + * It should conform to RFC1035. * * Generated from protobuf field string region = 138946292 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "region"]; * @param string $var @@ -203,7 +236,16 @@ public function setRegionInstanceGroupManagersCreateInstancesRequestResource($va } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -224,7 +266,16 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/CreateSnapshotDiskRequest.php b/Compute/src/V1/CreateSnapshotDiskRequest.php index 3f2f81645bb9..ba25145f038f 100644 --- a/Compute/src/V1/CreateSnapshotDiskRequest.php +++ b/Compute/src/V1/CreateSnapshotDiskRequest.php @@ -22,7 +22,8 @@ class CreateSnapshotDiskRequest extends \Google\Protobuf\Internal\Message */ protected $disk = ''; /** - * [Input Only] Whether to attempt an application consistent snapshot by informing the OS to prepare for the snapshot process. + * [Input Only] Whether to attempt an application consistent snapshot by + * informing the OS to prepare for the snapshot process. * * Generated from protobuf field optional bool guest_flush = 385550813; */ @@ -34,7 +35,17 @@ class CreateSnapshotDiskRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -80,11 +91,22 @@ public static function build(string $project, string $zone, string $disk, \Googl * @type string $disk * Name of the persistent disk to snapshot. * @type bool $guest_flush - * [Input Only] Whether to attempt an application consistent snapshot by informing the OS to prepare for the snapshot process. + * [Input Only] Whether to attempt an application consistent snapshot by + * informing the OS to prepare for the snapshot process. * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type \Google\Cloud\Compute\V1\Snapshot $snapshot_resource * The body resource for this request * @type string $zone @@ -123,7 +145,8 @@ public function setDisk($var) } /** - * [Input Only] Whether to attempt an application consistent snapshot by informing the OS to prepare for the snapshot process. + * [Input Only] Whether to attempt an application consistent snapshot by + * informing the OS to prepare for the snapshot process. * * Generated from protobuf field optional bool guest_flush = 385550813; * @return bool @@ -144,7 +167,8 @@ public function clearGuestFlush() } /** - * [Input Only] Whether to attempt an application consistent snapshot by informing the OS to prepare for the snapshot process. + * [Input Only] Whether to attempt an application consistent snapshot by + * informing the OS to prepare for the snapshot process. * * Generated from protobuf field optional bool guest_flush = 385550813; * @param bool $var @@ -185,7 +209,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -206,7 +240,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/CreateSnapshotRegionDiskRequest.php b/Compute/src/V1/CreateSnapshotRegionDiskRequest.php index e4586e901089..b3faa2323d6b 100644 --- a/Compute/src/V1/CreateSnapshotRegionDiskRequest.php +++ b/Compute/src/V1/CreateSnapshotRegionDiskRequest.php @@ -34,7 +34,17 @@ class CreateSnapshotRegionDiskRequest extends \Google\Protobuf\Internal\Message */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -78,7 +88,17 @@ public static function build(string $project, string $region, string $disk, \Goo * @type string $region * Name of the region for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type \Google\Cloud\Compute\V1\Snapshot $snapshot_resource * The body resource for this request * } @@ -167,7 +187,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -188,7 +218,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/CrossSiteNetwork.php b/Compute/src/V1/CrossSiteNetwork.php new file mode 100644 index 000000000000..ae32e1713bd7 --- /dev/null +++ b/Compute/src/V1/CrossSiteNetwork.php @@ -0,0 +1,331 @@ +google.cloud.compute.v1.CrossSiteNetwork + */ +class CrossSiteNetwork extends \Google\Protobuf\Internal\Message +{ + /** + * [Output Only] Creation timestamp inRFC3339 + * text format. + * + * Generated from protobuf field optional string creation_timestamp = 30525366; + */ + protected $creation_timestamp = null; + /** + * An optional description of the cross-site network. + * + * Generated from protobuf field optional string description = 422937596; + */ + protected $description = null; + /** + * [Output Only] The unique identifier for the resource type. The server + * generates this identifier. + * + * Generated from protobuf field optional uint64 id = 3355; + */ + protected $id = null; + /** + * [Output Only] Type of the resource. Alwayscompute#crossSiteNetwork for cross-site networks. + * + * Generated from protobuf field optional string kind = 3292052; + */ + protected $kind = null; + /** + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. + * + * Generated from protobuf field optional string name = 3373707; + */ + protected $name = null; + /** + * [Output Only] Server-defined URL for the resource. + * + * Generated from protobuf field optional string self_link = 456214797; + */ + protected $self_link = null; + + /** + * Constructor. + * + * @param array $data { + * Optional. Data for populating the Message object. + * + * @type string $creation_timestamp + * [Output Only] Creation timestamp inRFC3339 + * text format. + * @type string $description + * An optional description of the cross-site network. + * @type int|string $id + * [Output Only] The unique identifier for the resource type. The server + * generates this identifier. + * @type string $kind + * [Output Only] Type of the resource. Alwayscompute#crossSiteNetwork for cross-site networks. + * @type string $name + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. + * @type string $self_link + * [Output Only] Server-defined URL for the resource. + * } + */ + public function __construct($data = NULL) { + \GPBMetadata\Google\Cloud\Compute\V1\Compute::initOnce(); + parent::__construct($data); + } + + /** + * [Output Only] Creation timestamp inRFC3339 + * text format. + * + * Generated from protobuf field optional string creation_timestamp = 30525366; + * @return string + */ + public function getCreationTimestamp() + { + return isset($this->creation_timestamp) ? $this->creation_timestamp : ''; + } + + public function hasCreationTimestamp() + { + return isset($this->creation_timestamp); + } + + public function clearCreationTimestamp() + { + unset($this->creation_timestamp); + } + + /** + * [Output Only] Creation timestamp inRFC3339 + * text format. + * + * Generated from protobuf field optional string creation_timestamp = 30525366; + * @param string $var + * @return $this + */ + public function setCreationTimestamp($var) + { + GPBUtil::checkString($var, True); + $this->creation_timestamp = $var; + + return $this; + } + + /** + * An optional description of the cross-site network. + * + * Generated from protobuf field optional string description = 422937596; + * @return string + */ + public function getDescription() + { + return isset($this->description) ? $this->description : ''; + } + + public function hasDescription() + { + return isset($this->description); + } + + public function clearDescription() + { + unset($this->description); + } + + /** + * An optional description of the cross-site network. + * + * Generated from protobuf field optional string description = 422937596; + * @param string $var + * @return $this + */ + public function setDescription($var) + { + GPBUtil::checkString($var, True); + $this->description = $var; + + return $this; + } + + /** + * [Output Only] The unique identifier for the resource type. The server + * generates this identifier. + * + * Generated from protobuf field optional uint64 id = 3355; + * @return int|string + */ + public function getId() + { + return isset($this->id) ? $this->id : 0; + } + + public function hasId() + { + return isset($this->id); + } + + public function clearId() + { + unset($this->id); + } + + /** + * [Output Only] The unique identifier for the resource type. The server + * generates this identifier. + * + * Generated from protobuf field optional uint64 id = 3355; + * @param int|string $var + * @return $this + */ + public function setId($var) + { + GPBUtil::checkUint64($var); + $this->id = $var; + + return $this; + } + + /** + * [Output Only] Type of the resource. Alwayscompute#crossSiteNetwork for cross-site networks. + * + * Generated from protobuf field optional string kind = 3292052; + * @return string + */ + public function getKind() + { + return isset($this->kind) ? $this->kind : ''; + } + + public function hasKind() + { + return isset($this->kind); + } + + public function clearKind() + { + unset($this->kind); + } + + /** + * [Output Only] Type of the resource. Alwayscompute#crossSiteNetwork for cross-site networks. + * + * Generated from protobuf field optional string kind = 3292052; + * @param string $var + * @return $this + */ + public function setKind($var) + { + GPBUtil::checkString($var, True); + $this->kind = $var; + + return $this; + } + + /** + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. + * + * Generated from protobuf field optional string name = 3373707; + * @return string + */ + public function getName() + { + return isset($this->name) ? $this->name : ''; + } + + public function hasName() + { + return isset($this->name); + } + + public function clearName() + { + unset($this->name); + } + + /** + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. + * + * Generated from protobuf field optional string name = 3373707; + * @param string $var + * @return $this + */ + public function setName($var) + { + GPBUtil::checkString($var, True); + $this->name = $var; + + return $this; + } + + /** + * [Output Only] Server-defined URL for the resource. + * + * Generated from protobuf field optional string self_link = 456214797; + * @return string + */ + public function getSelfLink() + { + return isset($this->self_link) ? $this->self_link : ''; + } + + public function hasSelfLink() + { + return isset($this->self_link); + } + + public function clearSelfLink() + { + unset($this->self_link); + } + + /** + * [Output Only] Server-defined URL for the resource. + * + * Generated from protobuf field optional string self_link = 456214797; + * @param string $var + * @return $this + */ + public function setSelfLink($var) + { + GPBUtil::checkString($var, True); + $this->self_link = $var; + + return $this; + } + +} + diff --git a/Compute/src/V1/CrossSiteNetworkList.php b/Compute/src/V1/CrossSiteNetworkList.php new file mode 100644 index 000000000000..70d1d27a77de --- /dev/null +++ b/Compute/src/V1/CrossSiteNetworkList.php @@ -0,0 +1,378 @@ +google.cloud.compute.v1.CrossSiteNetworkList + */ +class CrossSiteNetworkList extends \Google\Protobuf\Internal\Message +{ + /** + * Generated from protobuf field optional string etag = 3123477; + */ + protected $etag = null; + /** + * [Output Only] Unique identifier for the resource; defined by the server. + * + * Generated from protobuf field optional string id = 3355; + */ + protected $id = null; + /** + * A list of CrossSiteNetwork resources. + * + * Generated from protobuf field repeated .google.cloud.compute.v1.CrossSiteNetwork items = 100526016; + */ + private $items; + /** + * [Output Only] Type of the resource. Alwayscompute#crossSiteNetwork for cross-site networks. + * + * Generated from protobuf field optional string kind = 3292052; + */ + protected $kind = null; + /** + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. + * + * Generated from protobuf field optional string next_page_token = 79797525; + */ + protected $next_page_token = null; + /** + * [Output Only] Server-defined URL for this resource. + * + * Generated from protobuf field optional string self_link = 456214797; + */ + protected $self_link = null; + /** + * [Output Only] Unreachable resources. + * end_interface: MixerListResponseWithEtagBuilder + * + * Generated from protobuf field repeated string unreachables = 243372063; + */ + private $unreachables; + /** + * [Output Only] Informational warning message. + * + * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; + */ + protected $warning = null; + + /** + * Constructor. + * + * @param array $data { + * Optional. Data for populating the Message object. + * + * @type string $etag + * @type string $id + * [Output Only] Unique identifier for the resource; defined by the server. + * @type array<\Google\Cloud\Compute\V1\CrossSiteNetwork>|\Google\Protobuf\Internal\RepeatedField $items + * A list of CrossSiteNetwork resources. + * @type string $kind + * [Output Only] Type of the resource. Alwayscompute#crossSiteNetwork for cross-site networks. + * @type string $next_page_token + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. + * @type string $self_link + * [Output Only] Server-defined URL for this resource. + * @type array|\Google\Protobuf\Internal\RepeatedField $unreachables + * [Output Only] Unreachable resources. + * end_interface: MixerListResponseWithEtagBuilder + * @type \Google\Cloud\Compute\V1\Warning $warning + * [Output Only] Informational warning message. + * } + */ + public function __construct($data = NULL) { + \GPBMetadata\Google\Cloud\Compute\V1\Compute::initOnce(); + parent::__construct($data); + } + + /** + * Generated from protobuf field optional string etag = 3123477; + * @return string + */ + public function getEtag() + { + return isset($this->etag) ? $this->etag : ''; + } + + public function hasEtag() + { + return isset($this->etag); + } + + public function clearEtag() + { + unset($this->etag); + } + + /** + * Generated from protobuf field optional string etag = 3123477; + * @param string $var + * @return $this + */ + public function setEtag($var) + { + GPBUtil::checkString($var, True); + $this->etag = $var; + + return $this; + } + + /** + * [Output Only] Unique identifier for the resource; defined by the server. + * + * Generated from protobuf field optional string id = 3355; + * @return string + */ + public function getId() + { + return isset($this->id) ? $this->id : ''; + } + + public function hasId() + { + return isset($this->id); + } + + public function clearId() + { + unset($this->id); + } + + /** + * [Output Only] Unique identifier for the resource; defined by the server. + * + * Generated from protobuf field optional string id = 3355; + * @param string $var + * @return $this + */ + public function setId($var) + { + GPBUtil::checkString($var, True); + $this->id = $var; + + return $this; + } + + /** + * A list of CrossSiteNetwork resources. + * + * Generated from protobuf field repeated .google.cloud.compute.v1.CrossSiteNetwork items = 100526016; + * @return \Google\Protobuf\Internal\RepeatedField + */ + public function getItems() + { + return $this->items; + } + + /** + * A list of CrossSiteNetwork resources. + * + * Generated from protobuf field repeated .google.cloud.compute.v1.CrossSiteNetwork items = 100526016; + * @param array<\Google\Cloud\Compute\V1\CrossSiteNetwork>|\Google\Protobuf\Internal\RepeatedField $var + * @return $this + */ + public function setItems($var) + { + $arr = GPBUtil::checkRepeatedField($var, \Google\Protobuf\Internal\GPBType::MESSAGE, \Google\Cloud\Compute\V1\CrossSiteNetwork::class); + $this->items = $arr; + + return $this; + } + + /** + * [Output Only] Type of the resource. Alwayscompute#crossSiteNetwork for cross-site networks. + * + * Generated from protobuf field optional string kind = 3292052; + * @return string + */ + public function getKind() + { + return isset($this->kind) ? $this->kind : ''; + } + + public function hasKind() + { + return isset($this->kind); + } + + public function clearKind() + { + unset($this->kind); + } + + /** + * [Output Only] Type of the resource. Alwayscompute#crossSiteNetwork for cross-site networks. + * + * Generated from protobuf field optional string kind = 3292052; + * @param string $var + * @return $this + */ + public function setKind($var) + { + GPBUtil::checkString($var, True); + $this->kind = $var; + + return $this; + } + + /** + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. + * + * Generated from protobuf field optional string next_page_token = 79797525; + * @return string + */ + public function getNextPageToken() + { + return isset($this->next_page_token) ? $this->next_page_token : ''; + } + + public function hasNextPageToken() + { + return isset($this->next_page_token); + } + + public function clearNextPageToken() + { + unset($this->next_page_token); + } + + /** + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. + * + * Generated from protobuf field optional string next_page_token = 79797525; + * @param string $var + * @return $this + */ + public function setNextPageToken($var) + { + GPBUtil::checkString($var, True); + $this->next_page_token = $var; + + return $this; + } + + /** + * [Output Only] Server-defined URL for this resource. + * + * Generated from protobuf field optional string self_link = 456214797; + * @return string + */ + public function getSelfLink() + { + return isset($this->self_link) ? $this->self_link : ''; + } + + public function hasSelfLink() + { + return isset($this->self_link); + } + + public function clearSelfLink() + { + unset($this->self_link); + } + + /** + * [Output Only] Server-defined URL for this resource. + * + * Generated from protobuf field optional string self_link = 456214797; + * @param string $var + * @return $this + */ + public function setSelfLink($var) + { + GPBUtil::checkString($var, True); + $this->self_link = $var; + + return $this; + } + + /** + * [Output Only] Unreachable resources. + * end_interface: MixerListResponseWithEtagBuilder + * + * Generated from protobuf field repeated string unreachables = 243372063; + * @return \Google\Protobuf\Internal\RepeatedField + */ + public function getUnreachables() + { + return $this->unreachables; + } + + /** + * [Output Only] Unreachable resources. + * end_interface: MixerListResponseWithEtagBuilder + * + * Generated from protobuf field repeated string unreachables = 243372063; + * @param array|\Google\Protobuf\Internal\RepeatedField $var + * @return $this + */ + public function setUnreachables($var) + { + $arr = GPBUtil::checkRepeatedField($var, \Google\Protobuf\Internal\GPBType::STRING); + $this->unreachables = $arr; + + return $this; + } + + /** + * [Output Only] Informational warning message. + * + * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; + * @return \Google\Cloud\Compute\V1\Warning|null + */ + public function getWarning() + { + return $this->warning; + } + + public function hasWarning() + { + return isset($this->warning); + } + + public function clearWarning() + { + unset($this->warning); + } + + /** + * [Output Only] Informational warning message. + * + * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; + * @param \Google\Cloud\Compute\V1\Warning $var + * @return $this + */ + public function setWarning($var) + { + GPBUtil::checkMessage($var, \Google\Cloud\Compute\V1\Warning::class); + $this->warning = $var; + + return $this; + } + +} + diff --git a/Compute/src/V1/CustomErrorResponsePolicy.php b/Compute/src/V1/CustomErrorResponsePolicy.php index 25a44acdc4e4..63ed6f1ae0e2 100644 --- a/Compute/src/V1/CustomErrorResponsePolicy.php +++ b/Compute/src/V1/CustomErrorResponsePolicy.php @@ -9,20 +9,37 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Specifies the custom error response policy that must be applied when the backend service or backend bucket responds with an error. + * Specifies the custom error response policy that must be applied when the + * backend service or backend bucket responds with an error. * * Generated from protobuf message google.cloud.compute.v1.CustomErrorResponsePolicy */ class CustomErrorResponsePolicy extends \Google\Protobuf\Internal\Message { /** - * Specifies rules for returning error responses. In a given policy, if you specify rules for both a range of error codes as well as rules for specific error codes then rules with specific error codes have a higher priority. For example, assume that you configure a rule for 401 (Un-authorized) code, and another for all 4 series error codes (4XX). If the backend service returns a 401, then the rule for 401 will be applied. However if the backend service returns a 403, the rule for 4xx takes effect. + * Specifies rules for returning error responses. + * In a given policy, if you specify rules for both a range of error codes + * as well as rules for specific error codes then rules with specific error + * codes have a higher priority. For example, assume that you configure a rule + * for 401 (Un-authorized) code, and another for all 4 series + * error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied. + * However if the backend service returns a 403, the rule for4xx takes effect. * * Generated from protobuf field repeated .google.cloud.compute.v1.CustomErrorResponsePolicyCustomErrorResponseRule error_response_rules = 14620304; */ private $error_response_rules; /** - * The full or partial URL to the BackendBucket resource that contains the custom error content. Examples are: - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket - compute/v1/projects/project/global/backendBuckets/myBackendBucket - global/backendBuckets/myBackendBucket If errorService is not specified at lower levels like pathMatcher, pathRule and routeRule, an errorService specified at a higher level in the UrlMap will be used. If UrlMap.defaultCustomErrorResponsePolicy contains one or more errorResponseRules[], it must specify errorService. If load balancer cannot reach the backendBucket, a simple Not Found Error will be returned, with the original response code (or overrideResponseCode if configured). errorService is not supported for internal or regional HTTP/HTTPS load balancers. + * The full or partial URL to the BackendBucket resource that + * contains the custom error content. Examples are: + * - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket + * - compute/v1/projects/project/global/backendBuckets/myBackendBucket + * - global/backendBuckets/myBackendBucket + * If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule, + * an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService. + * If load balancer cannot reach + * the backendBucket, a simple Not Found Error will + * be returned, with the original response code (oroverrideResponseCode if configured). + * errorService is not supported for internal or regionalHTTP/HTTPS load balancers. * * Generated from protobuf field optional string error_service = 164214654; */ @@ -35,9 +52,25 @@ class CustomErrorResponsePolicy extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type array<\Google\Cloud\Compute\V1\CustomErrorResponsePolicyCustomErrorResponseRule>|\Google\Protobuf\Internal\RepeatedField $error_response_rules - * Specifies rules for returning error responses. In a given policy, if you specify rules for both a range of error codes as well as rules for specific error codes then rules with specific error codes have a higher priority. For example, assume that you configure a rule for 401 (Un-authorized) code, and another for all 4 series error codes (4XX). If the backend service returns a 401, then the rule for 401 will be applied. However if the backend service returns a 403, the rule for 4xx takes effect. + * Specifies rules for returning error responses. + * In a given policy, if you specify rules for both a range of error codes + * as well as rules for specific error codes then rules with specific error + * codes have a higher priority. For example, assume that you configure a rule + * for 401 (Un-authorized) code, and another for all 4 series + * error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied. + * However if the backend service returns a 403, the rule for4xx takes effect. * @type string $error_service - * The full or partial URL to the BackendBucket resource that contains the custom error content. Examples are: - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket - compute/v1/projects/project/global/backendBuckets/myBackendBucket - global/backendBuckets/myBackendBucket If errorService is not specified at lower levels like pathMatcher, pathRule and routeRule, an errorService specified at a higher level in the UrlMap will be used. If UrlMap.defaultCustomErrorResponsePolicy contains one or more errorResponseRules[], it must specify errorService. If load balancer cannot reach the backendBucket, a simple Not Found Error will be returned, with the original response code (or overrideResponseCode if configured). errorService is not supported for internal or regional HTTP/HTTPS load balancers. + * The full or partial URL to the BackendBucket resource that + * contains the custom error content. Examples are: + * - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket + * - compute/v1/projects/project/global/backendBuckets/myBackendBucket + * - global/backendBuckets/myBackendBucket + * If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule, + * an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService. + * If load balancer cannot reach + * the backendBucket, a simple Not Found Error will + * be returned, with the original response code (oroverrideResponseCode if configured). + * errorService is not supported for internal or regionalHTTP/HTTPS load balancers. * } */ public function __construct($data = NULL) { @@ -46,7 +79,13 @@ public function __construct($data = NULL) { } /** - * Specifies rules for returning error responses. In a given policy, if you specify rules for both a range of error codes as well as rules for specific error codes then rules with specific error codes have a higher priority. For example, assume that you configure a rule for 401 (Un-authorized) code, and another for all 4 series error codes (4XX). If the backend service returns a 401, then the rule for 401 will be applied. However if the backend service returns a 403, the rule for 4xx takes effect. + * Specifies rules for returning error responses. + * In a given policy, if you specify rules for both a range of error codes + * as well as rules for specific error codes then rules with specific error + * codes have a higher priority. For example, assume that you configure a rule + * for 401 (Un-authorized) code, and another for all 4 series + * error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied. + * However if the backend service returns a 403, the rule for4xx takes effect. * * Generated from protobuf field repeated .google.cloud.compute.v1.CustomErrorResponsePolicyCustomErrorResponseRule error_response_rules = 14620304; * @return \Google\Protobuf\Internal\RepeatedField @@ -57,7 +96,13 @@ public function getErrorResponseRules() } /** - * Specifies rules for returning error responses. In a given policy, if you specify rules for both a range of error codes as well as rules for specific error codes then rules with specific error codes have a higher priority. For example, assume that you configure a rule for 401 (Un-authorized) code, and another for all 4 series error codes (4XX). If the backend service returns a 401, then the rule for 401 will be applied. However if the backend service returns a 403, the rule for 4xx takes effect. + * Specifies rules for returning error responses. + * In a given policy, if you specify rules for both a range of error codes + * as well as rules for specific error codes then rules with specific error + * codes have a higher priority. For example, assume that you configure a rule + * for 401 (Un-authorized) code, and another for all 4 series + * error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied. + * However if the backend service returns a 403, the rule for4xx takes effect. * * Generated from protobuf field repeated .google.cloud.compute.v1.CustomErrorResponsePolicyCustomErrorResponseRule error_response_rules = 14620304; * @param array<\Google\Cloud\Compute\V1\CustomErrorResponsePolicyCustomErrorResponseRule>|\Google\Protobuf\Internal\RepeatedField $var @@ -72,7 +117,17 @@ public function setErrorResponseRules($var) } /** - * The full or partial URL to the BackendBucket resource that contains the custom error content. Examples are: - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket - compute/v1/projects/project/global/backendBuckets/myBackendBucket - global/backendBuckets/myBackendBucket If errorService is not specified at lower levels like pathMatcher, pathRule and routeRule, an errorService specified at a higher level in the UrlMap will be used. If UrlMap.defaultCustomErrorResponsePolicy contains one or more errorResponseRules[], it must specify errorService. If load balancer cannot reach the backendBucket, a simple Not Found Error will be returned, with the original response code (or overrideResponseCode if configured). errorService is not supported for internal or regional HTTP/HTTPS load balancers. + * The full or partial URL to the BackendBucket resource that + * contains the custom error content. Examples are: + * - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket + * - compute/v1/projects/project/global/backendBuckets/myBackendBucket + * - global/backendBuckets/myBackendBucket + * If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule, + * an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService. + * If load balancer cannot reach + * the backendBucket, a simple Not Found Error will + * be returned, with the original response code (oroverrideResponseCode if configured). + * errorService is not supported for internal or regionalHTTP/HTTPS load balancers. * * Generated from protobuf field optional string error_service = 164214654; * @return string @@ -93,7 +148,17 @@ public function clearErrorService() } /** - * The full or partial URL to the BackendBucket resource that contains the custom error content. Examples are: - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket - compute/v1/projects/project/global/backendBuckets/myBackendBucket - global/backendBuckets/myBackendBucket If errorService is not specified at lower levels like pathMatcher, pathRule and routeRule, an errorService specified at a higher level in the UrlMap will be used. If UrlMap.defaultCustomErrorResponsePolicy contains one or more errorResponseRules[], it must specify errorService. If load balancer cannot reach the backendBucket, a simple Not Found Error will be returned, with the original response code (or overrideResponseCode if configured). errorService is not supported for internal or regional HTTP/HTTPS load balancers. + * The full or partial URL to the BackendBucket resource that + * contains the custom error content. Examples are: + * - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket + * - compute/v1/projects/project/global/backendBuckets/myBackendBucket + * - global/backendBuckets/myBackendBucket + * If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule, + * an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService. + * If load balancer cannot reach + * the backendBucket, a simple Not Found Error will + * be returned, with the original response code (oroverrideResponseCode if configured). + * errorService is not supported for internal or regionalHTTP/HTTPS load balancers. * * Generated from protobuf field optional string error_service = 164214654; * @param string $var diff --git a/Compute/src/V1/CustomErrorResponsePolicyCustomErrorResponseRule.php b/Compute/src/V1/CustomErrorResponsePolicyCustomErrorResponseRule.php index 4c1a744e7d3b..19b2e122f94e 100644 --- a/Compute/src/V1/CustomErrorResponsePolicyCustomErrorResponseRule.php +++ b/Compute/src/V1/CustomErrorResponsePolicyCustomErrorResponseRule.php @@ -9,26 +9,48 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Specifies the mapping between the response code that will be returned along with the custom error content and the response code returned by the backend service. + * Specifies the mapping between the response code that will be returned along + * with the custom error content and the response code returned by the backend + * service. * * Generated from protobuf message google.cloud.compute.v1.CustomErrorResponsePolicyCustomErrorResponseRule */ class CustomErrorResponsePolicyCustomErrorResponseRule extends \Google\Protobuf\Internal\Message { /** - * Valid values include: - A number between 400 and 599: For example 401 or 503, in which case the load balancer applies the policy if the error code exactly matches this value. - 5xx: Load Balancer will apply the policy if the backend service responds with any response code in the range of 500 to 599. - 4xx: Load Balancer will apply the policy if the backend service responds with any response code in the range of 400 to 499. Values must be unique within matchResponseCodes and across all errorResponseRules of CustomErrorResponsePolicy. + * Valid values include: + * - A number between 400 and 599: For example + * 401 or 503, in which case the load balancer + * applies the policy if the error code exactly matches this value. + * - 5xx: Load Balancer will apply the policy if the + * backend service responds with any response code in the range of + * 500 to 599. + * - 4xx: Load + * Balancer will apply the policy if the backend service responds with any + * response code in the range of 400 to + * 499. + * Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy. * * Generated from protobuf field repeated string match_response_codes = 104973410; */ private $match_response_codes; /** - * The HTTP status code returned with the response containing the custom error content. If overrideResponseCode is not supplied, the same response code returned by the original backend bucket or backend service is returned to the client. + * The HTTP status code returned with the response containing the custom + * error content. If overrideResponseCode is not supplied, the + * same response code returned by the original backend bucket or backend + * service is returned to the client. * * Generated from protobuf field optional int32 override_response_code = 530328568; */ protected $override_response_code = null; /** - * The full path to a file within backendBucket . For example: /errors/defaultError.html path must start with a leading slash. path cannot have trailing slashes. If the file is not available in backendBucket or the load balancer cannot reach the BackendBucket, a simple Not Found Error is returned to the client. The value must be from 1 to 1024 characters + * The full path to a file within backendBucket . For example:/errors/defaultError.html + * path must start + * with a leading slash. path cannot have trailing slashes. + * If the file is not available in backendBucket or the + * load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client. + * The value must + * be from 1 to 1024 characters * * Generated from protobuf field optional string path = 3433509; */ @@ -41,11 +63,31 @@ class CustomErrorResponsePolicyCustomErrorResponseRule extends \Google\Protobuf\ * Optional. Data for populating the Message object. * * @type array|\Google\Protobuf\Internal\RepeatedField $match_response_codes - * Valid values include: - A number between 400 and 599: For example 401 or 503, in which case the load balancer applies the policy if the error code exactly matches this value. - 5xx: Load Balancer will apply the policy if the backend service responds with any response code in the range of 500 to 599. - 4xx: Load Balancer will apply the policy if the backend service responds with any response code in the range of 400 to 499. Values must be unique within matchResponseCodes and across all errorResponseRules of CustomErrorResponsePolicy. + * Valid values include: + * - A number between 400 and 599: For example + * 401 or 503, in which case the load balancer + * applies the policy if the error code exactly matches this value. + * - 5xx: Load Balancer will apply the policy if the + * backend service responds with any response code in the range of + * 500 to 599. + * - 4xx: Load + * Balancer will apply the policy if the backend service responds with any + * response code in the range of 400 to + * 499. + * Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy. * @type int $override_response_code - * The HTTP status code returned with the response containing the custom error content. If overrideResponseCode is not supplied, the same response code returned by the original backend bucket or backend service is returned to the client. + * The HTTP status code returned with the response containing the custom + * error content. If overrideResponseCode is not supplied, the + * same response code returned by the original backend bucket or backend + * service is returned to the client. * @type string $path - * The full path to a file within backendBucket . For example: /errors/defaultError.html path must start with a leading slash. path cannot have trailing slashes. If the file is not available in backendBucket or the load balancer cannot reach the BackendBucket, a simple Not Found Error is returned to the client. The value must be from 1 to 1024 characters + * The full path to a file within backendBucket . For example:/errors/defaultError.html + * path must start + * with a leading slash. path cannot have trailing slashes. + * If the file is not available in backendBucket or the + * load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client. + * The value must + * be from 1 to 1024 characters * } */ public function __construct($data = NULL) { @@ -54,7 +96,18 @@ public function __construct($data = NULL) { } /** - * Valid values include: - A number between 400 and 599: For example 401 or 503, in which case the load balancer applies the policy if the error code exactly matches this value. - 5xx: Load Balancer will apply the policy if the backend service responds with any response code in the range of 500 to 599. - 4xx: Load Balancer will apply the policy if the backend service responds with any response code in the range of 400 to 499. Values must be unique within matchResponseCodes and across all errorResponseRules of CustomErrorResponsePolicy. + * Valid values include: + * - A number between 400 and 599: For example + * 401 or 503, in which case the load balancer + * applies the policy if the error code exactly matches this value. + * - 5xx: Load Balancer will apply the policy if the + * backend service responds with any response code in the range of + * 500 to 599. + * - 4xx: Load + * Balancer will apply the policy if the backend service responds with any + * response code in the range of 400 to + * 499. + * Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy. * * Generated from protobuf field repeated string match_response_codes = 104973410; * @return \Google\Protobuf\Internal\RepeatedField @@ -65,7 +118,18 @@ public function getMatchResponseCodes() } /** - * Valid values include: - A number between 400 and 599: For example 401 or 503, in which case the load balancer applies the policy if the error code exactly matches this value. - 5xx: Load Balancer will apply the policy if the backend service responds with any response code in the range of 500 to 599. - 4xx: Load Balancer will apply the policy if the backend service responds with any response code in the range of 400 to 499. Values must be unique within matchResponseCodes and across all errorResponseRules of CustomErrorResponsePolicy. + * Valid values include: + * - A number between 400 and 599: For example + * 401 or 503, in which case the load balancer + * applies the policy if the error code exactly matches this value. + * - 5xx: Load Balancer will apply the policy if the + * backend service responds with any response code in the range of + * 500 to 599. + * - 4xx: Load + * Balancer will apply the policy if the backend service responds with any + * response code in the range of 400 to + * 499. + * Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy. * * Generated from protobuf field repeated string match_response_codes = 104973410; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -80,7 +144,10 @@ public function setMatchResponseCodes($var) } /** - * The HTTP status code returned with the response containing the custom error content. If overrideResponseCode is not supplied, the same response code returned by the original backend bucket or backend service is returned to the client. + * The HTTP status code returned with the response containing the custom + * error content. If overrideResponseCode is not supplied, the + * same response code returned by the original backend bucket or backend + * service is returned to the client. * * Generated from protobuf field optional int32 override_response_code = 530328568; * @return int @@ -101,7 +168,10 @@ public function clearOverrideResponseCode() } /** - * The HTTP status code returned with the response containing the custom error content. If overrideResponseCode is not supplied, the same response code returned by the original backend bucket or backend service is returned to the client. + * The HTTP status code returned with the response containing the custom + * error content. If overrideResponseCode is not supplied, the + * same response code returned by the original backend bucket or backend + * service is returned to the client. * * Generated from protobuf field optional int32 override_response_code = 530328568; * @param int $var @@ -116,7 +186,13 @@ public function setOverrideResponseCode($var) } /** - * The full path to a file within backendBucket . For example: /errors/defaultError.html path must start with a leading slash. path cannot have trailing slashes. If the file is not available in backendBucket or the load balancer cannot reach the BackendBucket, a simple Not Found Error is returned to the client. The value must be from 1 to 1024 characters + * The full path to a file within backendBucket . For example:/errors/defaultError.html + * path must start + * with a leading slash. path cannot have trailing slashes. + * If the file is not available in backendBucket or the + * load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client. + * The value must + * be from 1 to 1024 characters * * Generated from protobuf field optional string path = 3433509; * @return string @@ -137,7 +213,13 @@ public function clearPath() } /** - * The full path to a file within backendBucket . For example: /errors/defaultError.html path must start with a leading slash. path cannot have trailing slashes. If the file is not available in backendBucket or the load balancer cannot reach the BackendBucket, a simple Not Found Error is returned to the client. The value must be from 1 to 1024 characters + * The full path to a file within backendBucket . For example:/errors/defaultError.html + * path must start + * with a leading slash. path cannot have trailing slashes. + * If the file is not available in backendBucket or the + * load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client. + * The value must + * be from 1 to 1024 characters * * Generated from protobuf field optional string path = 3433509; * @param string $var diff --git a/Compute/src/V1/CustomerEncryptionKey.php b/Compute/src/V1/CustomerEncryptionKey.php index 668e43d26db7..c4e35caa7f11 100644 --- a/Compute/src/V1/CustomerEncryptionKey.php +++ b/Compute/src/V1/CustomerEncryptionKey.php @@ -15,31 +15,65 @@ class CustomerEncryptionKey extends \Google\Protobuf\Internal\Message { /** - * The name of the encryption key that is stored in Google Cloud KMS. For example: "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/ key_region/cryptoKeys/key The fully-qualifed key name may be returned for resource GET requests. For example: "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/ key_region/cryptoKeys/key /cryptoKeyVersions/1 + * The name of the encryption key that is stored in Google Cloud KMS. + * For example: + * "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/ + * key_region/cryptoKeys/key + * The fully-qualifed key name may be returned for resource GET requests. For + * example: + * "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/ + * key_region/cryptoKeys/key + * /cryptoKeyVersions/1 * * Generated from protobuf field optional string kms_key_name = 484373913; */ protected $kms_key_name = null; /** - * The service account being used for the encryption request for the given KMS key. If absent, the Compute Engine default service account is used. For example: "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/ + * The service account being used for the encryption request for the given KMS + * key. If absent, the Compute Engine default service account is used. + * For example: + * "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/ * * Generated from protobuf field optional string kms_key_service_account = 209986261; */ protected $kms_key_service_account = null; /** - * Specifies a 256-bit customer-supplied encryption key, encoded in RFC 4648 base64 to either encrypt or decrypt this resource. You can provide either the rawKey or the rsaEncryptedKey. For example: "rawKey": "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=" + * Specifies a 256-bit customer-supplied + * encryption key, encoded in RFC + * 4648 base64 to either encrypt or decrypt this resource. You can + * provide either the rawKey or thersaEncryptedKey. + * For example: + * "rawKey": + * "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=" * * Generated from protobuf field optional string raw_key = 449196488; */ protected $raw_key = null; /** - * Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit customer-supplied encryption key to either encrypt or decrypt this resource. You can provide either the rawKey or the rsaEncryptedKey. For example: "rsaEncryptedKey": "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==" The key must meet the following requirements before you can provide it to Compute Engine: 1. The key is wrapped using a RSA public key certificate provided by Google. 2. After being wrapped, the key must be encoded in RFC 4648 base64 encoding. Gets the RSA public key certificate provided by Google at: https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem + * Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit + * customer-supplied encryption key to either encrypt or decrypt this + * resource. You can provide either the rawKey or thersaEncryptedKey. + * For example: + * "rsaEncryptedKey": + * "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH + * z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD + * D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==" + * The key must meet the following requirements before you can provide it to + * Compute Engine: + * 1. The key is wrapped using a RSA public key certificate provided by + * Google. + * 2. After being wrapped, the key must be encoded in RFC 4648 base64 + * encoding. + * Gets the RSA public key certificate provided by Google at: + * https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem * * Generated from protobuf field optional string rsa_encrypted_key = 335487397; */ protected $rsa_encrypted_key = null; /** - * [Output only] The RFC 4648 base64 encoded SHA-256 hash of the customer-supplied encryption key that protects this resource. + * [Output only] TheRFC + * 4648 base64 encoded SHA-256 hash of the customer-supplied + * encryption key that protects this resource. * * Generated from protobuf field optional string sha256 = 170112551; */ @@ -52,15 +86,49 @@ class CustomerEncryptionKey extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $kms_key_name - * The name of the encryption key that is stored in Google Cloud KMS. For example: "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/ key_region/cryptoKeys/key The fully-qualifed key name may be returned for resource GET requests. For example: "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/ key_region/cryptoKeys/key /cryptoKeyVersions/1 + * The name of the encryption key that is stored in Google Cloud KMS. + * For example: + * "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/ + * key_region/cryptoKeys/key + * The fully-qualifed key name may be returned for resource GET requests. For + * example: + * "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/ + * key_region/cryptoKeys/key + * /cryptoKeyVersions/1 * @type string $kms_key_service_account - * The service account being used for the encryption request for the given KMS key. If absent, the Compute Engine default service account is used. For example: "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/ + * The service account being used for the encryption request for the given KMS + * key. If absent, the Compute Engine default service account is used. + * For example: + * "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/ * @type string $raw_key - * Specifies a 256-bit customer-supplied encryption key, encoded in RFC 4648 base64 to either encrypt or decrypt this resource. You can provide either the rawKey or the rsaEncryptedKey. For example: "rawKey": "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=" + * Specifies a 256-bit customer-supplied + * encryption key, encoded in RFC + * 4648 base64 to either encrypt or decrypt this resource. You can + * provide either the rawKey or thersaEncryptedKey. + * For example: + * "rawKey": + * "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=" * @type string $rsa_encrypted_key - * Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit customer-supplied encryption key to either encrypt or decrypt this resource. You can provide either the rawKey or the rsaEncryptedKey. For example: "rsaEncryptedKey": "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==" The key must meet the following requirements before you can provide it to Compute Engine: 1. The key is wrapped using a RSA public key certificate provided by Google. 2. After being wrapped, the key must be encoded in RFC 4648 base64 encoding. Gets the RSA public key certificate provided by Google at: https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem + * Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit + * customer-supplied encryption key to either encrypt or decrypt this + * resource. You can provide either the rawKey or thersaEncryptedKey. + * For example: + * "rsaEncryptedKey": + * "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH + * z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD + * D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==" + * The key must meet the following requirements before you can provide it to + * Compute Engine: + * 1. The key is wrapped using a RSA public key certificate provided by + * Google. + * 2. After being wrapped, the key must be encoded in RFC 4648 base64 + * encoding. + * Gets the RSA public key certificate provided by Google at: + * https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem * @type string $sha256 - * [Output only] The RFC 4648 base64 encoded SHA-256 hash of the customer-supplied encryption key that protects this resource. + * [Output only] TheRFC + * 4648 base64 encoded SHA-256 hash of the customer-supplied + * encryption key that protects this resource. * } */ public function __construct($data = NULL) { @@ -69,7 +137,15 @@ public function __construct($data = NULL) { } /** - * The name of the encryption key that is stored in Google Cloud KMS. For example: "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/ key_region/cryptoKeys/key The fully-qualifed key name may be returned for resource GET requests. For example: "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/ key_region/cryptoKeys/key /cryptoKeyVersions/1 + * The name of the encryption key that is stored in Google Cloud KMS. + * For example: + * "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/ + * key_region/cryptoKeys/key + * The fully-qualifed key name may be returned for resource GET requests. For + * example: + * "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/ + * key_region/cryptoKeys/key + * /cryptoKeyVersions/1 * * Generated from protobuf field optional string kms_key_name = 484373913; * @return string @@ -90,7 +166,15 @@ public function clearKmsKeyName() } /** - * The name of the encryption key that is stored in Google Cloud KMS. For example: "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/ key_region/cryptoKeys/key The fully-qualifed key name may be returned for resource GET requests. For example: "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/ key_region/cryptoKeys/key /cryptoKeyVersions/1 + * The name of the encryption key that is stored in Google Cloud KMS. + * For example: + * "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/ + * key_region/cryptoKeys/key + * The fully-qualifed key name may be returned for resource GET requests. For + * example: + * "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/ + * key_region/cryptoKeys/key + * /cryptoKeyVersions/1 * * Generated from protobuf field optional string kms_key_name = 484373913; * @param string $var @@ -105,7 +189,10 @@ public function setKmsKeyName($var) } /** - * The service account being used for the encryption request for the given KMS key. If absent, the Compute Engine default service account is used. For example: "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/ + * The service account being used for the encryption request for the given KMS + * key. If absent, the Compute Engine default service account is used. + * For example: + * "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/ * * Generated from protobuf field optional string kms_key_service_account = 209986261; * @return string @@ -126,7 +213,10 @@ public function clearKmsKeyServiceAccount() } /** - * The service account being used for the encryption request for the given KMS key. If absent, the Compute Engine default service account is used. For example: "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/ + * The service account being used for the encryption request for the given KMS + * key. If absent, the Compute Engine default service account is used. + * For example: + * "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/ * * Generated from protobuf field optional string kms_key_service_account = 209986261; * @param string $var @@ -141,7 +231,13 @@ public function setKmsKeyServiceAccount($var) } /** - * Specifies a 256-bit customer-supplied encryption key, encoded in RFC 4648 base64 to either encrypt or decrypt this resource. You can provide either the rawKey or the rsaEncryptedKey. For example: "rawKey": "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=" + * Specifies a 256-bit customer-supplied + * encryption key, encoded in RFC + * 4648 base64 to either encrypt or decrypt this resource. You can + * provide either the rawKey or thersaEncryptedKey. + * For example: + * "rawKey": + * "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=" * * Generated from protobuf field optional string raw_key = 449196488; * @return string @@ -162,7 +258,13 @@ public function clearRawKey() } /** - * Specifies a 256-bit customer-supplied encryption key, encoded in RFC 4648 base64 to either encrypt or decrypt this resource. You can provide either the rawKey or the rsaEncryptedKey. For example: "rawKey": "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=" + * Specifies a 256-bit customer-supplied + * encryption key, encoded in RFC + * 4648 base64 to either encrypt or decrypt this resource. You can + * provide either the rawKey or thersaEncryptedKey. + * For example: + * "rawKey": + * "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=" * * Generated from protobuf field optional string raw_key = 449196488; * @param string $var @@ -177,7 +279,22 @@ public function setRawKey($var) } /** - * Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit customer-supplied encryption key to either encrypt or decrypt this resource. You can provide either the rawKey or the rsaEncryptedKey. For example: "rsaEncryptedKey": "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==" The key must meet the following requirements before you can provide it to Compute Engine: 1. The key is wrapped using a RSA public key certificate provided by Google. 2. After being wrapped, the key must be encoded in RFC 4648 base64 encoding. Gets the RSA public key certificate provided by Google at: https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem + * Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit + * customer-supplied encryption key to either encrypt or decrypt this + * resource. You can provide either the rawKey or thersaEncryptedKey. + * For example: + * "rsaEncryptedKey": + * "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH + * z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD + * D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==" + * The key must meet the following requirements before you can provide it to + * Compute Engine: + * 1. The key is wrapped using a RSA public key certificate provided by + * Google. + * 2. After being wrapped, the key must be encoded in RFC 4648 base64 + * encoding. + * Gets the RSA public key certificate provided by Google at: + * https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem * * Generated from protobuf field optional string rsa_encrypted_key = 335487397; * @return string @@ -198,7 +315,22 @@ public function clearRsaEncryptedKey() } /** - * Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit customer-supplied encryption key to either encrypt or decrypt this resource. You can provide either the rawKey or the rsaEncryptedKey. For example: "rsaEncryptedKey": "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==" The key must meet the following requirements before you can provide it to Compute Engine: 1. The key is wrapped using a RSA public key certificate provided by Google. 2. After being wrapped, the key must be encoded in RFC 4648 base64 encoding. Gets the RSA public key certificate provided by Google at: https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem + * Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit + * customer-supplied encryption key to either encrypt or decrypt this + * resource. You can provide either the rawKey or thersaEncryptedKey. + * For example: + * "rsaEncryptedKey": + * "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH + * z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD + * D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==" + * The key must meet the following requirements before you can provide it to + * Compute Engine: + * 1. The key is wrapped using a RSA public key certificate provided by + * Google. + * 2. After being wrapped, the key must be encoded in RFC 4648 base64 + * encoding. + * Gets the RSA public key certificate provided by Google at: + * https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem * * Generated from protobuf field optional string rsa_encrypted_key = 335487397; * @param string $var @@ -213,7 +345,9 @@ public function setRsaEncryptedKey($var) } /** - * [Output only] The RFC 4648 base64 encoded SHA-256 hash of the customer-supplied encryption key that protects this resource. + * [Output only] TheRFC + * 4648 base64 encoded SHA-256 hash of the customer-supplied + * encryption key that protects this resource. * * Generated from protobuf field optional string sha256 = 170112551; * @return string @@ -234,7 +368,9 @@ public function clearSha256() } /** - * [Output only] The RFC 4648 base64 encoded SHA-256 hash of the customer-supplied encryption key that protects this resource. + * [Output only] TheRFC + * 4648 base64 encoded SHA-256 hash of the customer-supplied + * encryption key that protects this resource. * * Generated from protobuf field optional string sha256 = 170112551; * @param string $var diff --git a/Compute/src/V1/CustomerEncryptionKeyProtectedDisk.php b/Compute/src/V1/CustomerEncryptionKeyProtectedDisk.php index cd4ca6141b55..de0ac84bdc7e 100644 --- a/Compute/src/V1/CustomerEncryptionKeyProtectedDisk.php +++ b/Compute/src/V1/CustomerEncryptionKeyProtectedDisk.php @@ -15,13 +15,18 @@ class CustomerEncryptionKeyProtectedDisk extends \Google\Protobuf\Internal\Message { /** - * Decrypts data associated with the disk with a customer-supplied encryption key. + * Decrypts data associated with the disk with acustomer-supplied + * encryption key. * * Generated from protobuf field optional .google.cloud.compute.v1.CustomerEncryptionKey disk_encryption_key = 271660677; */ protected $disk_encryption_key = null; /** - * Specifies a valid partial or full URL to an existing Persistent Disk resource. This field is only applicable for persistent disks. For example: "source": "/compute/v1/projects/project_id/zones/zone/disks/ disk_name + * Specifies a valid partial or full URL to an existing Persistent Disk + * resource. This field is only applicable for persistent disks. + * For example: + * "source": "/compute/v1/projects/project_id/zones/zone/disks/ + * disk_name * * Generated from protobuf field optional string source = 177235995; */ @@ -34,9 +39,14 @@ class CustomerEncryptionKeyProtectedDisk extends \Google\Protobuf\Internal\Messa * Optional. Data for populating the Message object. * * @type \Google\Cloud\Compute\V1\CustomerEncryptionKey $disk_encryption_key - * Decrypts data associated with the disk with a customer-supplied encryption key. + * Decrypts data associated with the disk with acustomer-supplied + * encryption key. * @type string $source - * Specifies a valid partial or full URL to an existing Persistent Disk resource. This field is only applicable for persistent disks. For example: "source": "/compute/v1/projects/project_id/zones/zone/disks/ disk_name + * Specifies a valid partial or full URL to an existing Persistent Disk + * resource. This field is only applicable for persistent disks. + * For example: + * "source": "/compute/v1/projects/project_id/zones/zone/disks/ + * disk_name * } */ public function __construct($data = NULL) { @@ -45,7 +55,8 @@ public function __construct($data = NULL) { } /** - * Decrypts data associated with the disk with a customer-supplied encryption key. + * Decrypts data associated with the disk with acustomer-supplied + * encryption key. * * Generated from protobuf field optional .google.cloud.compute.v1.CustomerEncryptionKey disk_encryption_key = 271660677; * @return \Google\Cloud\Compute\V1\CustomerEncryptionKey|null @@ -66,7 +77,8 @@ public function clearDiskEncryptionKey() } /** - * Decrypts data associated with the disk with a customer-supplied encryption key. + * Decrypts data associated with the disk with acustomer-supplied + * encryption key. * * Generated from protobuf field optional .google.cloud.compute.v1.CustomerEncryptionKey disk_encryption_key = 271660677; * @param \Google\Cloud\Compute\V1\CustomerEncryptionKey $var @@ -81,7 +93,11 @@ public function setDiskEncryptionKey($var) } /** - * Specifies a valid partial or full URL to an existing Persistent Disk resource. This field is only applicable for persistent disks. For example: "source": "/compute/v1/projects/project_id/zones/zone/disks/ disk_name + * Specifies a valid partial or full URL to an existing Persistent Disk + * resource. This field is only applicable for persistent disks. + * For example: + * "source": "/compute/v1/projects/project_id/zones/zone/disks/ + * disk_name * * Generated from protobuf field optional string source = 177235995; * @return string @@ -102,7 +118,11 @@ public function clearSource() } /** - * Specifies a valid partial or full URL to an existing Persistent Disk resource. This field is only applicable for persistent disks. For example: "source": "/compute/v1/projects/project_id/zones/zone/disks/ disk_name + * Specifies a valid partial or full URL to an existing Persistent Disk + * resource. This field is only applicable for persistent disks. + * For example: + * "source": "/compute/v1/projects/project_id/zones/zone/disks/ + * disk_name * * Generated from protobuf field optional string source = 177235995; * @param string $var diff --git a/Compute/src/V1/Data.php b/Compute/src/V1/Data.php index 182d0504db39..743924824e12 100644 --- a/Compute/src/V1/Data.php +++ b/Compute/src/V1/Data.php @@ -15,7 +15,13 @@ class Data extends \Google\Protobuf\Internal\Message { /** - * [Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding). + * [Output Only] A key that provides more detail on the warning being + * returned. For example, for warnings where there are no results in a list + * request for a particular zone, this key might be scope and + * the key value might be the zone name. Other examples might be a key + * indicating a deprecated resource and a suggested replacement, or a + * warning about invalid network settings (for example, if an instance + * attempts to perform IP forwarding but is not enabled for IP forwarding). * * Generated from protobuf field optional string key = 106079; */ @@ -34,7 +40,13 @@ class Data extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $key - * [Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding). + * [Output Only] A key that provides more detail on the warning being + * returned. For example, for warnings where there are no results in a list + * request for a particular zone, this key might be scope and + * the key value might be the zone name. Other examples might be a key + * indicating a deprecated resource and a suggested replacement, or a + * warning about invalid network settings (for example, if an instance + * attempts to perform IP forwarding but is not enabled for IP forwarding). * @type string $value * [Output Only] A warning data value corresponding to the key. * } @@ -45,7 +57,13 @@ public function __construct($data = NULL) { } /** - * [Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding). + * [Output Only] A key that provides more detail on the warning being + * returned. For example, for warnings where there are no results in a list + * request for a particular zone, this key might be scope and + * the key value might be the zone name. Other examples might be a key + * indicating a deprecated resource and a suggested replacement, or a + * warning about invalid network settings (for example, if an instance + * attempts to perform IP forwarding but is not enabled for IP forwarding). * * Generated from protobuf field optional string key = 106079; * @return string @@ -66,7 +84,13 @@ public function clearKey() } /** - * [Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding). + * [Output Only] A key that provides more detail on the warning being + * returned. For example, for warnings where there are no results in a list + * request for a particular zone, this key might be scope and + * the key value might be the zone name. Other examples might be a key + * indicating a deprecated resource and a suggested replacement, or a + * warning about invalid network settings (for example, if an instance + * attempts to perform IP forwarding but is not enabled for IP forwarding). * * Generated from protobuf field optional string key = 106079; * @param string $var diff --git a/Compute/src/V1/Date.php b/Compute/src/V1/Date.php index 98e3381999b8..667283892210 100644 --- a/Compute/src/V1/Date.php +++ b/Compute/src/V1/Date.php @@ -9,26 +9,42 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp + * Represents a whole or partial calendar date, such as a birthday. The time of + * day and time zone are either specified elsewhere or are insignificant. The + * date is relative to the Gregorian Calendar. This can represent one of the + * following: + * * A full date, with non-zero year, month, and day values. + * * A month and day, with a zero year (for example, an anniversary). + * * A year on its own, with a zero month and a zero day. + * * A year and month, with a zero day (for example, a credit card expiration + * date). + * Related types: + * * google.type.TimeOfDay + * * google.type.DateTime + * * google.protobuf.Timestamp * * Generated from protobuf message google.cloud.compute.v1.Date */ class Date extends \Google\Protobuf\Internal\Message { /** - * Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant. + * Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 + * to specify a year by itself or a year and month where the day isn't + * significant. * * Generated from protobuf field optional int32 day = 99228; */ protected $day = null; /** - * Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day. + * Month of a year. Must be from 1 to 12, or 0 to specify a year without a + * month and day. * * Generated from protobuf field optional int32 month = 104080000; */ protected $month = null; /** - * Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year. + * Year of the date. Must be from 1 to 9999, or 0 to specify a date without + * a year. * * Generated from protobuf field optional int32 year = 3704893; */ @@ -41,11 +57,15 @@ class Date extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type int $day - * Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant. + * Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 + * to specify a year by itself or a year and month where the day isn't + * significant. * @type int $month - * Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day. + * Month of a year. Must be from 1 to 12, or 0 to specify a year without a + * month and day. * @type int $year - * Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year. + * Year of the date. Must be from 1 to 9999, or 0 to specify a date without + * a year. * } */ public function __construct($data = NULL) { @@ -54,7 +74,9 @@ public function __construct($data = NULL) { } /** - * Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant. + * Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 + * to specify a year by itself or a year and month where the day isn't + * significant. * * Generated from protobuf field optional int32 day = 99228; * @return int @@ -75,7 +97,9 @@ public function clearDay() } /** - * Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant. + * Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 + * to specify a year by itself or a year and month where the day isn't + * significant. * * Generated from protobuf field optional int32 day = 99228; * @param int $var @@ -90,7 +114,8 @@ public function setDay($var) } /** - * Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day. + * Month of a year. Must be from 1 to 12, or 0 to specify a year without a + * month and day. * * Generated from protobuf field optional int32 month = 104080000; * @return int @@ -111,7 +136,8 @@ public function clearMonth() } /** - * Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day. + * Month of a year. Must be from 1 to 12, or 0 to specify a year without a + * month and day. * * Generated from protobuf field optional int32 month = 104080000; * @param int $var @@ -126,7 +152,8 @@ public function setMonth($var) } /** - * Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year. + * Year of the date. Must be from 1 to 9999, or 0 to specify a date without + * a year. * * Generated from protobuf field optional int32 year = 3704893; * @return int @@ -147,7 +174,8 @@ public function clearYear() } /** - * Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year. + * Year of the date. Must be from 1 to 9999, or 0 to specify a date without + * a year. * * Generated from protobuf field optional int32 year = 3704893; * @param int $var diff --git a/Compute/src/V1/DeleteAccessConfigInstanceRequest.php b/Compute/src/V1/DeleteAccessConfigInstanceRequest.php index 83808a46a0ac..aea88ee3e4ea 100644 --- a/Compute/src/V1/DeleteAccessConfigInstanceRequest.php +++ b/Compute/src/V1/DeleteAccessConfigInstanceRequest.php @@ -40,7 +40,17 @@ class DeleteAccessConfigInstanceRequest extends \Google\Protobuf\Internal\Messag */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -88,7 +98,17 @@ public static function build(string $project, string $zone, string $instance, st * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $zone * The name of the zone for this request. * } @@ -203,7 +223,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -224,7 +254,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/DeleteAddressRequest.php b/Compute/src/V1/DeleteAddressRequest.php index a11c30051a82..e68ccec56188 100644 --- a/Compute/src/V1/DeleteAddressRequest.php +++ b/Compute/src/V1/DeleteAddressRequest.php @@ -34,7 +34,17 @@ class DeleteAddressRequest extends \Google\Protobuf\Internal\Message */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -70,7 +80,17 @@ public static function build(string $project, string $region, string $address): * @type string $region * Name of the region for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -157,7 +177,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -178,7 +208,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/DeleteAutoscalerRequest.php b/Compute/src/V1/DeleteAutoscalerRequest.php index c67c60b3b9f3..52acf6a16e73 100644 --- a/Compute/src/V1/DeleteAutoscalerRequest.php +++ b/Compute/src/V1/DeleteAutoscalerRequest.php @@ -28,7 +28,17 @@ class DeleteAutoscalerRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -68,7 +78,17 @@ public static function build(string $project, string $zone, string $autoscaler): * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $zone * Name of the zone for this request. * } @@ -131,7 +151,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -152,7 +182,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/DeleteBackendBucketRequest.php b/Compute/src/V1/DeleteBackendBucketRequest.php index 4a24375dee05..b4e23a9becce 100644 --- a/Compute/src/V1/DeleteBackendBucketRequest.php +++ b/Compute/src/V1/DeleteBackendBucketRequest.php @@ -28,7 +28,17 @@ class DeleteBackendBucketRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -60,7 +70,17 @@ public static function build(string $project, string $backendBucket): self * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -121,7 +141,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -142,7 +172,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/DeleteBackendServiceRequest.php b/Compute/src/V1/DeleteBackendServiceRequest.php index 651a6177bf8c..84732b6ef526 100644 --- a/Compute/src/V1/DeleteBackendServiceRequest.php +++ b/Compute/src/V1/DeleteBackendServiceRequest.php @@ -28,7 +28,17 @@ class DeleteBackendServiceRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -60,7 +70,17 @@ public static function build(string $project, string $backendService): self * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -121,7 +141,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -142,7 +172,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/DeleteCrossSiteNetworkRequest.php b/Compute/src/V1/DeleteCrossSiteNetworkRequest.php new file mode 100644 index 000000000000..49d7ccfacb92 --- /dev/null +++ b/Compute/src/V1/DeleteCrossSiteNetworkRequest.php @@ -0,0 +1,204 @@ +google.cloud.compute.v1.DeleteCrossSiteNetworkRequest + */ +class DeleteCrossSiteNetworkRequest extends \Google\Protobuf\Internal\Message +{ + /** + * Name of the cross-site network to delete. + * + * Generated from protobuf field string cross_site_network = 108192469 [(.google.api.field_behavior) = REQUIRED]; + */ + protected $cross_site_network = ''; + /** + * Project ID for this request. + * + * Generated from protobuf field string project = 227560217 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "project"]; + */ + protected $project = ''; + /** + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). + * end_interface: MixerMutationRequestBuilder + * + * Generated from protobuf field optional string request_id = 37109963; + */ + protected $request_id = null; + + /** + * @param string $project Project ID for this request. + * @param string $crossSiteNetwork Name of the cross-site network to delete. + * + * @return \Google\Cloud\Compute\V1\DeleteCrossSiteNetworkRequest + * + * @experimental + */ + public static function build(string $project, string $crossSiteNetwork): self + { + return (new self()) + ->setProject($project) + ->setCrossSiteNetwork($crossSiteNetwork); + } + + /** + * Constructor. + * + * @param array $data { + * Optional. Data for populating the Message object. + * + * @type string $cross_site_network + * Name of the cross-site network to delete. + * @type string $project + * Project ID for this request. + * @type string $request_id + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). + * end_interface: MixerMutationRequestBuilder + * } + */ + public function __construct($data = NULL) { + \GPBMetadata\Google\Cloud\Compute\V1\Compute::initOnce(); + parent::__construct($data); + } + + /** + * Name of the cross-site network to delete. + * + * Generated from protobuf field string cross_site_network = 108192469 [(.google.api.field_behavior) = REQUIRED]; + * @return string + */ + public function getCrossSiteNetwork() + { + return $this->cross_site_network; + } + + /** + * Name of the cross-site network to delete. + * + * Generated from protobuf field string cross_site_network = 108192469 [(.google.api.field_behavior) = REQUIRED]; + * @param string $var + * @return $this + */ + public function setCrossSiteNetwork($var) + { + GPBUtil::checkString($var, True); + $this->cross_site_network = $var; + + return $this; + } + + /** + * Project ID for this request. + * + * Generated from protobuf field string project = 227560217 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "project"]; + * @return string + */ + public function getProject() + { + return $this->project; + } + + /** + * Project ID for this request. + * + * Generated from protobuf field string project = 227560217 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "project"]; + * @param string $var + * @return $this + */ + public function setProject($var) + { + GPBUtil::checkString($var, True); + $this->project = $var; + + return $this; + } + + /** + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). + * end_interface: MixerMutationRequestBuilder + * + * Generated from protobuf field optional string request_id = 37109963; + * @return string + */ + public function getRequestId() + { + return isset($this->request_id) ? $this->request_id : ''; + } + + public function hasRequestId() + { + return isset($this->request_id); + } + + public function clearRequestId() + { + unset($this->request_id); + } + + /** + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). + * end_interface: MixerMutationRequestBuilder + * + * Generated from protobuf field optional string request_id = 37109963; + * @param string $var + * @return $this + */ + public function setRequestId($var) + { + GPBUtil::checkString($var, True); + $this->request_id = $var; + + return $this; + } + +} + diff --git a/Compute/src/V1/DeleteDiskRequest.php b/Compute/src/V1/DeleteDiskRequest.php index e63a19c54995..85bae01046f0 100644 --- a/Compute/src/V1/DeleteDiskRequest.php +++ b/Compute/src/V1/DeleteDiskRequest.php @@ -28,7 +28,17 @@ class DeleteDiskRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -68,7 +78,17 @@ public static function build(string $project, string $zone, string $disk): self * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $zone * The name of the zone for this request. * } @@ -131,7 +151,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -152,7 +182,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/DeleteExternalVpnGatewayRequest.php b/Compute/src/V1/DeleteExternalVpnGatewayRequest.php index 55b4b2204962..05788609194c 100644 --- a/Compute/src/V1/DeleteExternalVpnGatewayRequest.php +++ b/Compute/src/V1/DeleteExternalVpnGatewayRequest.php @@ -28,7 +28,17 @@ class DeleteExternalVpnGatewayRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -60,7 +70,17 @@ public static function build(string $project, string $externalVpnGateway): self * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -121,7 +141,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -142,7 +172,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/DeleteFirewallPolicyRequest.php b/Compute/src/V1/DeleteFirewallPolicyRequest.php index 5a92dc55f450..2003df3d34a8 100644 --- a/Compute/src/V1/DeleteFirewallPolicyRequest.php +++ b/Compute/src/V1/DeleteFirewallPolicyRequest.php @@ -22,7 +22,17 @@ class DeleteFirewallPolicyRequest extends \Google\Protobuf\Internal\Message */ protected $firewall_policy = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -50,7 +60,17 @@ public static function build(string $firewallPolicy): self * @type string $firewall_policy * Name of the firewall policy to delete. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -85,7 +105,17 @@ public function setFirewallPolicy($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -106,7 +136,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/DeleteFirewallRequest.php b/Compute/src/V1/DeleteFirewallRequest.php index af6ab6708021..5f46887980a5 100644 --- a/Compute/src/V1/DeleteFirewallRequest.php +++ b/Compute/src/V1/DeleteFirewallRequest.php @@ -28,7 +28,17 @@ class DeleteFirewallRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -60,7 +70,17 @@ public static function build(string $project, string $firewall): self * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -121,7 +141,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -142,7 +172,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/DeleteForwardingRuleRequest.php b/Compute/src/V1/DeleteForwardingRuleRequest.php index 50054e9a73c7..7f3354b21680 100644 --- a/Compute/src/V1/DeleteForwardingRuleRequest.php +++ b/Compute/src/V1/DeleteForwardingRuleRequest.php @@ -34,7 +34,17 @@ class DeleteForwardingRuleRequest extends \Google\Protobuf\Internal\Message */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -70,7 +80,17 @@ public static function build(string $project, string $region, string $forwarding * @type string $region * Name of the region scoping this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -157,7 +177,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -178,7 +208,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/DeleteFutureReservationRequest.php b/Compute/src/V1/DeleteFutureReservationRequest.php new file mode 100644 index 000000000000..93c956cab888 --- /dev/null +++ b/Compute/src/V1/DeleteFutureReservationRequest.php @@ -0,0 +1,236 @@ +google.cloud.compute.v1.DeleteFutureReservationRequest + */ +class DeleteFutureReservationRequest extends \Google\Protobuf\Internal\Message +{ + /** + * Name of the future reservation to retrieve. Name should conform to RFC1035. + * + * Generated from protobuf field string future_reservation = 56206160 [(.google.api.field_behavior) = REQUIRED]; + */ + protected $future_reservation = ''; + /** + * Project ID for this request. + * + * Generated from protobuf field string project = 227560217 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "project"]; + */ + protected $project = ''; + /** + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). + * + * Generated from protobuf field optional string request_id = 37109963; + */ + protected $request_id = null; + /** + * Name of the zone for this request. Name should conform to RFC1035. + * + * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; + */ + protected $zone = ''; + + /** + * @param string $project Project ID for this request. + * @param string $zone Name of the zone for this request. Name should conform to RFC1035. + * @param string $futureReservation Name of the future reservation to retrieve. Name should conform to RFC1035. + * + * @return \Google\Cloud\Compute\V1\DeleteFutureReservationRequest + * + * @experimental + */ + public static function build(string $project, string $zone, string $futureReservation): self + { + return (new self()) + ->setProject($project) + ->setZone($zone) + ->setFutureReservation($futureReservation); + } + + /** + * Constructor. + * + * @param array $data { + * Optional. Data for populating the Message object. + * + * @type string $future_reservation + * Name of the future reservation to retrieve. Name should conform to RFC1035. + * @type string $project + * Project ID for this request. + * @type string $request_id + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). + * @type string $zone + * Name of the zone for this request. Name should conform to RFC1035. + * } + */ + public function __construct($data = NULL) { + \GPBMetadata\Google\Cloud\Compute\V1\Compute::initOnce(); + parent::__construct($data); + } + + /** + * Name of the future reservation to retrieve. Name should conform to RFC1035. + * + * Generated from protobuf field string future_reservation = 56206160 [(.google.api.field_behavior) = REQUIRED]; + * @return string + */ + public function getFutureReservation() + { + return $this->future_reservation; + } + + /** + * Name of the future reservation to retrieve. Name should conform to RFC1035. + * + * Generated from protobuf field string future_reservation = 56206160 [(.google.api.field_behavior) = REQUIRED]; + * @param string $var + * @return $this + */ + public function setFutureReservation($var) + { + GPBUtil::checkString($var, True); + $this->future_reservation = $var; + + return $this; + } + + /** + * Project ID for this request. + * + * Generated from protobuf field string project = 227560217 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "project"]; + * @return string + */ + public function getProject() + { + return $this->project; + } + + /** + * Project ID for this request. + * + * Generated from protobuf field string project = 227560217 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "project"]; + * @param string $var + * @return $this + */ + public function setProject($var) + { + GPBUtil::checkString($var, True); + $this->project = $var; + + return $this; + } + + /** + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). + * + * Generated from protobuf field optional string request_id = 37109963; + * @return string + */ + public function getRequestId() + { + return isset($this->request_id) ? $this->request_id : ''; + } + + public function hasRequestId() + { + return isset($this->request_id); + } + + public function clearRequestId() + { + unset($this->request_id); + } + + /** + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). + * + * Generated from protobuf field optional string request_id = 37109963; + * @param string $var + * @return $this + */ + public function setRequestId($var) + { + GPBUtil::checkString($var, True); + $this->request_id = $var; + + return $this; + } + + /** + * Name of the zone for this request. Name should conform to RFC1035. + * + * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; + * @return string + */ + public function getZone() + { + return $this->zone; + } + + /** + * Name of the zone for this request. Name should conform to RFC1035. + * + * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; + * @param string $var + * @return $this + */ + public function setZone($var) + { + GPBUtil::checkString($var, True); + $this->zone = $var; + + return $this; + } + +} + diff --git a/Compute/src/V1/DeleteGlobalAddressRequest.php b/Compute/src/V1/DeleteGlobalAddressRequest.php index fd095f71804e..5a8adf184a54 100644 --- a/Compute/src/V1/DeleteGlobalAddressRequest.php +++ b/Compute/src/V1/DeleteGlobalAddressRequest.php @@ -28,7 +28,17 @@ class DeleteGlobalAddressRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -60,7 +70,17 @@ public static function build(string $project, string $address): self * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -121,7 +141,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -142,7 +172,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/DeleteGlobalForwardingRuleRequest.php b/Compute/src/V1/DeleteGlobalForwardingRuleRequest.php index 6c4ba14f8ac7..1f005e4b2f72 100644 --- a/Compute/src/V1/DeleteGlobalForwardingRuleRequest.php +++ b/Compute/src/V1/DeleteGlobalForwardingRuleRequest.php @@ -28,7 +28,17 @@ class DeleteGlobalForwardingRuleRequest extends \Google\Protobuf\Internal\Messag */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -60,7 +70,17 @@ public static function build(string $project, string $forwardingRule): self * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -121,7 +141,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -142,7 +172,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/DeleteGlobalNetworkEndpointGroupRequest.php b/Compute/src/V1/DeleteGlobalNetworkEndpointGroupRequest.php index 6ccd7f9280cd..ceca158fbc71 100644 --- a/Compute/src/V1/DeleteGlobalNetworkEndpointGroupRequest.php +++ b/Compute/src/V1/DeleteGlobalNetworkEndpointGroupRequest.php @@ -16,7 +16,8 @@ class DeleteGlobalNetworkEndpointGroupRequest extends \Google\Protobuf\Internal\Message { /** - * The name of the network endpoint group to delete. It should comply with RFC1035. + * The name of the network endpoint group to delete. It should comply with + * RFC1035. * * Generated from protobuf field string network_endpoint_group = 433907078 [(.google.api.field_behavior) = REQUIRED]; */ @@ -28,7 +29,17 @@ class DeleteGlobalNetworkEndpointGroupRequest extends \Google\Protobuf\Internal\ */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -36,7 +47,8 @@ class DeleteGlobalNetworkEndpointGroupRequest extends \Google\Protobuf\Internal\ /** * @param string $project Project ID for this request. - * @param string $networkEndpointGroup The name of the network endpoint group to delete. It should comply with RFC1035. + * @param string $networkEndpointGroup The name of the network endpoint group to delete. It should comply with + * RFC1035. * * @return \Google\Cloud\Compute\V1\DeleteGlobalNetworkEndpointGroupRequest * @@ -56,11 +68,22 @@ public static function build(string $project, string $networkEndpointGroup): sel * Optional. Data for populating the Message object. * * @type string $network_endpoint_group - * The name of the network endpoint group to delete. It should comply with RFC1035. + * The name of the network endpoint group to delete. It should comply with + * RFC1035. * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -69,7 +92,8 @@ public function __construct($data = NULL) { } /** - * The name of the network endpoint group to delete. It should comply with RFC1035. + * The name of the network endpoint group to delete. It should comply with + * RFC1035. * * Generated from protobuf field string network_endpoint_group = 433907078 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -80,7 +104,8 @@ public function getNetworkEndpointGroup() } /** - * The name of the network endpoint group to delete. It should comply with RFC1035. + * The name of the network endpoint group to delete. It should comply with + * RFC1035. * * Generated from protobuf field string network_endpoint_group = 433907078 [(.google.api.field_behavior) = REQUIRED]; * @param string $var @@ -121,7 +146,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -142,7 +177,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/DeleteGlobalOperationRequest.php b/Compute/src/V1/DeleteGlobalOperationRequest.php index 3dbc7cde41f3..0c167f303507 100644 --- a/Compute/src/V1/DeleteGlobalOperationRequest.php +++ b/Compute/src/V1/DeleteGlobalOperationRequest.php @@ -16,7 +16,8 @@ class DeleteGlobalOperationRequest extends \Google\Protobuf\Internal\Message { /** - * Name of the Operations resource to delete, or its unique numeric identifier. + * Name of the Operations resource to delete, or its unique numeric + * identifier. * * Generated from protobuf field string operation = 52090215 [(.google.api.field_behavior) = REQUIRED]; */ @@ -30,7 +31,8 @@ class DeleteGlobalOperationRequest extends \Google\Protobuf\Internal\Message /** * @param string $project Project ID for this request. - * @param string $operation Name of the Operations resource to delete, or its unique numeric identifier. + * @param string $operation Name of the Operations resource to delete, or its unique numeric + * identifier. * * @return \Google\Cloud\Compute\V1\DeleteGlobalOperationRequest * @@ -50,7 +52,8 @@ public static function build(string $project, string $operation): self * Optional. Data for populating the Message object. * * @type string $operation - * Name of the Operations resource to delete, or its unique numeric identifier. + * Name of the Operations resource to delete, or its unique numeric + * identifier. * @type string $project * Project ID for this request. * } @@ -61,7 +64,8 @@ public function __construct($data = NULL) { } /** - * Name of the Operations resource to delete, or its unique numeric identifier. + * Name of the Operations resource to delete, or its unique numeric + * identifier. * * Generated from protobuf field string operation = 52090215 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -72,7 +76,8 @@ public function getOperation() } /** - * Name of the Operations resource to delete, or its unique numeric identifier. + * Name of the Operations resource to delete, or its unique numeric + * identifier. * * Generated from protobuf field string operation = 52090215 [(.google.api.field_behavior) = REQUIRED]; * @param string $var diff --git a/Compute/src/V1/DeleteGlobalOrganizationOperationRequest.php b/Compute/src/V1/DeleteGlobalOrganizationOperationRequest.php index 7df4dcdd349c..fdd0d430e3e8 100644 --- a/Compute/src/V1/DeleteGlobalOrganizationOperationRequest.php +++ b/Compute/src/V1/DeleteGlobalOrganizationOperationRequest.php @@ -16,7 +16,8 @@ class DeleteGlobalOrganizationOperationRequest extends \Google\Protobuf\Internal\Message { /** - * Name of the Operations resource to delete, or its unique numeric identifier. + * Name of the Operations resource to delete, or its unique numeric + * identifier. * * Generated from protobuf field string operation = 52090215 [(.google.api.field_behavior) = REQUIRED]; */ @@ -29,7 +30,8 @@ class DeleteGlobalOrganizationOperationRequest extends \Google\Protobuf\Internal protected $parent_id = null; /** - * @param string $operation Name of the Operations resource to delete, or its unique numeric identifier. + * @param string $operation Name of the Operations resource to delete, or its unique numeric + * identifier. * * @return \Google\Cloud\Compute\V1\DeleteGlobalOrganizationOperationRequest * @@ -48,7 +50,8 @@ public static function build(string $operation): self * Optional. Data for populating the Message object. * * @type string $operation - * Name of the Operations resource to delete, or its unique numeric identifier. + * Name of the Operations resource to delete, or its unique numeric + * identifier. * @type string $parent_id * Parent ID for this request. * } @@ -59,7 +62,8 @@ public function __construct($data = NULL) { } /** - * Name of the Operations resource to delete, or its unique numeric identifier. + * Name of the Operations resource to delete, or its unique numeric + * identifier. * * Generated from protobuf field string operation = 52090215 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -70,7 +74,8 @@ public function getOperation() } /** - * Name of the Operations resource to delete, or its unique numeric identifier. + * Name of the Operations resource to delete, or its unique numeric + * identifier. * * Generated from protobuf field string operation = 52090215 [(.google.api.field_behavior) = REQUIRED]; * @param string $var diff --git a/Compute/src/V1/DeleteGlobalPublicDelegatedPrefixeRequest.php b/Compute/src/V1/DeleteGlobalPublicDelegatedPrefixeRequest.php index 7fc4b03a47d7..6ae1f82e444b 100644 --- a/Compute/src/V1/DeleteGlobalPublicDelegatedPrefixeRequest.php +++ b/Compute/src/V1/DeleteGlobalPublicDelegatedPrefixeRequest.php @@ -28,7 +28,17 @@ class DeleteGlobalPublicDelegatedPrefixeRequest extends \Google\Protobuf\Interna */ protected $public_delegated_prefix = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -60,7 +70,17 @@ public static function build(string $project, string $publicDelegatedPrefix): se * @type string $public_delegated_prefix * Name of the PublicDelegatedPrefix resource to delete. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -121,7 +141,17 @@ public function setPublicDelegatedPrefix($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -142,7 +172,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/DeleteHealthCheckRequest.php b/Compute/src/V1/DeleteHealthCheckRequest.php index d5f6ac1852f0..5ad5952c2450 100644 --- a/Compute/src/V1/DeleteHealthCheckRequest.php +++ b/Compute/src/V1/DeleteHealthCheckRequest.php @@ -28,7 +28,17 @@ class DeleteHealthCheckRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -60,7 +70,17 @@ public static function build(string $project, string $healthCheck): self * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -121,7 +141,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -142,7 +172,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/DeleteImageRequest.php b/Compute/src/V1/DeleteImageRequest.php index f74d6ebe5f1d..78272cf23036 100644 --- a/Compute/src/V1/DeleteImageRequest.php +++ b/Compute/src/V1/DeleteImageRequest.php @@ -28,7 +28,17 @@ class DeleteImageRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -60,7 +70,17 @@ public static function build(string $project, string $image): self * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -121,7 +141,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -142,7 +172,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/DeleteInstanceGroupManagerRequest.php b/Compute/src/V1/DeleteInstanceGroupManagerRequest.php index b0dabaf711fc..a0d0e20e5e6d 100644 --- a/Compute/src/V1/DeleteInstanceGroupManagerRequest.php +++ b/Compute/src/V1/DeleteInstanceGroupManagerRequest.php @@ -28,13 +28,24 @@ class DeleteInstanceGroupManagerRequest extends \Google\Protobuf\Internal\Messag */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ protected $request_id = null; /** - * The name of the zone where the managed instance group is located. + * The name of thezone where the managed + * instance group is located. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; */ @@ -42,7 +53,8 @@ class DeleteInstanceGroupManagerRequest extends \Google\Protobuf\Internal\Messag /** * @param string $project Project ID for this request. - * @param string $zone The name of the zone where the managed instance group is located. + * @param string $zone The name of thezone where the managed + * instance group is located. * @param string $instanceGroupManager The name of the managed instance group to delete. * * @return \Google\Cloud\Compute\V1\DeleteInstanceGroupManagerRequest @@ -68,9 +80,20 @@ public static function build(string $project, string $zone, string $instanceGrou * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $zone - * The name of the zone where the managed instance group is located. + * The name of thezone where the managed + * instance group is located. * } */ public function __construct($data = NULL) { @@ -131,7 +154,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -152,7 +185,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var @@ -167,7 +210,8 @@ public function setRequestId($var) } /** - * The name of the zone where the managed instance group is located. + * The name of thezone where the managed + * instance group is located. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; * @return string @@ -178,7 +222,8 @@ public function getZone() } /** - * The name of the zone where the managed instance group is located. + * The name of thezone where the managed + * instance group is located. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; * @param string $var diff --git a/Compute/src/V1/DeleteInstanceGroupManagerResizeRequestRequest.php b/Compute/src/V1/DeleteInstanceGroupManagerResizeRequestRequest.php index 31433b7f5b72..b3725a8266db 100644 --- a/Compute/src/V1/DeleteInstanceGroupManagerResizeRequestRequest.php +++ b/Compute/src/V1/DeleteInstanceGroupManagerResizeRequestRequest.php @@ -16,7 +16,8 @@ class DeleteInstanceGroupManagerResizeRequestRequest extends \Google\Protobuf\Internal\Message { /** - * The name of the managed instance group. The name should conform to RFC1035 or be a resource ID. + * The name of the managed instance group. + * The name should conform to RFC1035 or be a resource ID. * * Generated from protobuf field string instance_group_manager = 249363395 [(.google.api.field_behavior) = REQUIRED]; */ @@ -28,19 +29,31 @@ class DeleteInstanceGroupManagerResizeRequestRequest extends \Google\Protobuf\In */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ protected $request_id = null; /** - * The name of the resize request to delete. The name should conform to RFC1035 or be a resource ID. + * The name of the resize request to delete. + * The name should conform to RFC1035 or be a resource ID. * * Generated from protobuf field string resize_request = 216941060 [(.google.api.field_behavior) = REQUIRED]; */ protected $resize_request = ''; /** - * The name of the zone where the managed instance group is located. The name should conform to RFC1035. + * The name of thezone where the managed + * instance group is located. The name should conform to RFC1035. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; */ @@ -48,9 +61,12 @@ class DeleteInstanceGroupManagerResizeRequestRequest extends \Google\Protobuf\In /** * @param string $project Project ID for this request. - * @param string $zone The name of the zone where the managed instance group is located. The name should conform to RFC1035. - * @param string $instanceGroupManager The name of the managed instance group. The name should conform to RFC1035 or be a resource ID. - * @param string $resizeRequest The name of the resize request to delete. The name should conform to RFC1035 or be a resource ID. + * @param string $zone The name of thezone where the managed + * instance group is located. The name should conform to RFC1035. + * @param string $instanceGroupManager The name of the managed instance group. + * The name should conform to RFC1035 or be a resource ID. + * @param string $resizeRequest The name of the resize request to delete. + * The name should conform to RFC1035 or be a resource ID. * * @return \Google\Cloud\Compute\V1\DeleteInstanceGroupManagerResizeRequestRequest * @@ -72,15 +88,28 @@ public static function build(string $project, string $zone, string $instanceGrou * Optional. Data for populating the Message object. * * @type string $instance_group_manager - * The name of the managed instance group. The name should conform to RFC1035 or be a resource ID. + * The name of the managed instance group. + * The name should conform to RFC1035 or be a resource ID. * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $resize_request - * The name of the resize request to delete. The name should conform to RFC1035 or be a resource ID. + * The name of the resize request to delete. + * The name should conform to RFC1035 or be a resource ID. * @type string $zone - * The name of the zone where the managed instance group is located. The name should conform to RFC1035. + * The name of thezone where the managed + * instance group is located. The name should conform to RFC1035. * } */ public function __construct($data = NULL) { @@ -89,7 +118,8 @@ public function __construct($data = NULL) { } /** - * The name of the managed instance group. The name should conform to RFC1035 or be a resource ID. + * The name of the managed instance group. + * The name should conform to RFC1035 or be a resource ID. * * Generated from protobuf field string instance_group_manager = 249363395 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -100,7 +130,8 @@ public function getInstanceGroupManager() } /** - * The name of the managed instance group. The name should conform to RFC1035 or be a resource ID. + * The name of the managed instance group. + * The name should conform to RFC1035 or be a resource ID. * * Generated from protobuf field string instance_group_manager = 249363395 [(.google.api.field_behavior) = REQUIRED]; * @param string $var @@ -141,7 +172,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -162,7 +203,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var @@ -177,7 +228,8 @@ public function setRequestId($var) } /** - * The name of the resize request to delete. The name should conform to RFC1035 or be a resource ID. + * The name of the resize request to delete. + * The name should conform to RFC1035 or be a resource ID. * * Generated from protobuf field string resize_request = 216941060 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -188,7 +240,8 @@ public function getResizeRequest() } /** - * The name of the resize request to delete. The name should conform to RFC1035 or be a resource ID. + * The name of the resize request to delete. + * The name should conform to RFC1035 or be a resource ID. * * Generated from protobuf field string resize_request = 216941060 [(.google.api.field_behavior) = REQUIRED]; * @param string $var @@ -203,7 +256,8 @@ public function setResizeRequest($var) } /** - * The name of the zone where the managed instance group is located. The name should conform to RFC1035. + * The name of thezone where the managed + * instance group is located. The name should conform to RFC1035. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; * @return string @@ -214,7 +268,8 @@ public function getZone() } /** - * The name of the zone where the managed instance group is located. The name should conform to RFC1035. + * The name of thezone where the managed + * instance group is located. The name should conform to RFC1035. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; * @param string $var diff --git a/Compute/src/V1/DeleteInstanceGroupRequest.php b/Compute/src/V1/DeleteInstanceGroupRequest.php index 85b64ebf23b2..b3db3ee6f191 100644 --- a/Compute/src/V1/DeleteInstanceGroupRequest.php +++ b/Compute/src/V1/DeleteInstanceGroupRequest.php @@ -28,13 +28,24 @@ class DeleteInstanceGroupRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ protected $request_id = null; /** - * The name of the zone where the instance group is located. + * The name of the zone + * where the instance group is located. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; */ @@ -42,7 +53,8 @@ class DeleteInstanceGroupRequest extends \Google\Protobuf\Internal\Message /** * @param string $project Project ID for this request. - * @param string $zone The name of the zone where the instance group is located. + * @param string $zone The name of the zone + * where the instance group is located. * @param string $instanceGroup The name of the instance group to delete. * * @return \Google\Cloud\Compute\V1\DeleteInstanceGroupRequest @@ -68,9 +80,20 @@ public static function build(string $project, string $zone, string $instanceGrou * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $zone - * The name of the zone where the instance group is located. + * The name of the zone + * where the instance group is located. * } */ public function __construct($data = NULL) { @@ -131,7 +154,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -152,7 +185,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var @@ -167,7 +210,8 @@ public function setRequestId($var) } /** - * The name of the zone where the instance group is located. + * The name of the zone + * where the instance group is located. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; * @return string @@ -178,7 +222,8 @@ public function getZone() } /** - * The name of the zone where the instance group is located. + * The name of the zone + * where the instance group is located. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; * @param string $var diff --git a/Compute/src/V1/DeleteInstanceRequest.php b/Compute/src/V1/DeleteInstanceRequest.php index d80de01acdf8..eb18121389d9 100644 --- a/Compute/src/V1/DeleteInstanceRequest.php +++ b/Compute/src/V1/DeleteInstanceRequest.php @@ -28,7 +28,17 @@ class DeleteInstanceRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -68,7 +78,17 @@ public static function build(string $project, string $zone, string $instance): s * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $zone * The name of the zone for this request. * } @@ -131,7 +151,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -152,7 +182,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/DeleteInstanceTemplateRequest.php b/Compute/src/V1/DeleteInstanceTemplateRequest.php index db0357032127..b75265234b8f 100644 --- a/Compute/src/V1/DeleteInstanceTemplateRequest.php +++ b/Compute/src/V1/DeleteInstanceTemplateRequest.php @@ -28,7 +28,17 @@ class DeleteInstanceTemplateRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -60,7 +70,17 @@ public static function build(string $project, string $instanceTemplate): self * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -121,7 +141,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -142,7 +172,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/DeleteInstancesInstanceGroupManagerRequest.php b/Compute/src/V1/DeleteInstancesInstanceGroupManagerRequest.php index 2f718c34feb2..d134b82c7931 100644 --- a/Compute/src/V1/DeleteInstancesInstanceGroupManagerRequest.php +++ b/Compute/src/V1/DeleteInstancesInstanceGroupManagerRequest.php @@ -34,13 +34,24 @@ class DeleteInstancesInstanceGroupManagerRequest extends \Google\Protobuf\Intern */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ protected $request_id = null; /** - * The name of the zone where the managed instance group is located. + * The name of thezone where the managed + * instance group is located. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; */ @@ -48,7 +59,8 @@ class DeleteInstancesInstanceGroupManagerRequest extends \Google\Protobuf\Intern /** * @param string $project Project ID for this request. - * @param string $zone The name of the zone where the managed instance group is located. + * @param string $zone The name of thezone where the managed + * instance group is located. * @param string $instanceGroupManager The name of the managed instance group. * @param \Google\Cloud\Compute\V1\InstanceGroupManagersDeleteInstancesRequest $instanceGroupManagersDeleteInstancesRequestResource The body resource for this request * @@ -78,9 +90,20 @@ public static function build(string $project, string $zone, string $instanceGrou * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $zone - * The name of the zone where the managed instance group is located. + * The name of thezone where the managed + * instance group is located. * } */ public function __construct($data = NULL) { @@ -177,7 +200,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -198,7 +231,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var @@ -213,7 +256,8 @@ public function setRequestId($var) } /** - * The name of the zone where the managed instance group is located. + * The name of thezone where the managed + * instance group is located. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; * @return string @@ -224,7 +268,8 @@ public function getZone() } /** - * The name of the zone where the managed instance group is located. + * The name of thezone where the managed + * instance group is located. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; * @param string $var diff --git a/Compute/src/V1/DeleteInstancesRegionInstanceGroupManagerRequest.php b/Compute/src/V1/DeleteInstancesRegionInstanceGroupManagerRequest.php index 3379183b9249..01f2355dc6d3 100644 --- a/Compute/src/V1/DeleteInstancesRegionInstanceGroupManagerRequest.php +++ b/Compute/src/V1/DeleteInstancesRegionInstanceGroupManagerRequest.php @@ -40,7 +40,17 @@ class DeleteInstancesRegionInstanceGroupManagerRequest extends \Google\Protobuf\ */ protected $region_instance_group_managers_delete_instances_request_resource = null; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -80,7 +90,17 @@ public static function build(string $project, string $region, string $instanceGr * @type \Google\Cloud\Compute\V1\RegionInstanceGroupManagersDeleteInstancesRequest $region_instance_group_managers_delete_instances_request_resource * The body resource for this request * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -203,7 +223,17 @@ public function setRegionInstanceGroupManagersDeleteInstancesRequestResource($va } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -224,7 +254,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/DeleteInstantSnapshotRequest.php b/Compute/src/V1/DeleteInstantSnapshotRequest.php index cfef609a04a4..767170855d83 100644 --- a/Compute/src/V1/DeleteInstantSnapshotRequest.php +++ b/Compute/src/V1/DeleteInstantSnapshotRequest.php @@ -28,7 +28,17 @@ class DeleteInstantSnapshotRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -68,7 +78,17 @@ public static function build(string $project, string $zone, string $instantSnaps * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $zone * The name of the zone for this request. * } @@ -131,7 +151,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -152,7 +182,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/DeleteInterconnectAttachmentGroupRequest.php b/Compute/src/V1/DeleteInterconnectAttachmentGroupRequest.php index a97e1eac6a2f..9861efca29e4 100644 --- a/Compute/src/V1/DeleteInterconnectAttachmentGroupRequest.php +++ b/Compute/src/V1/DeleteInterconnectAttachmentGroupRequest.php @@ -28,7 +28,18 @@ class DeleteInterconnectAttachmentGroupRequest extends \Google\Protobuf\Internal */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). end_interface: MixerMutationRequestBuilder + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). + * end_interface: MixerMutationRequestBuilder * * Generated from protobuf field optional string request_id = 37109963; */ @@ -60,7 +71,18 @@ public static function build(string $project, string $interconnectAttachmentGrou * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). end_interface: MixerMutationRequestBuilder + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). + * end_interface: MixerMutationRequestBuilder * } */ public function __construct($data = NULL) { @@ -121,7 +143,18 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). end_interface: MixerMutationRequestBuilder + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). + * end_interface: MixerMutationRequestBuilder * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -142,7 +175,18 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). end_interface: MixerMutationRequestBuilder + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). + * end_interface: MixerMutationRequestBuilder * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/DeleteInterconnectAttachmentRequest.php b/Compute/src/V1/DeleteInterconnectAttachmentRequest.php index 9c12870fae06..03cdf91c0ccb 100644 --- a/Compute/src/V1/DeleteInterconnectAttachmentRequest.php +++ b/Compute/src/V1/DeleteInterconnectAttachmentRequest.php @@ -34,7 +34,17 @@ class DeleteInterconnectAttachmentRequest extends \Google\Protobuf\Internal\Mess */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -70,7 +80,17 @@ public static function build(string $project, string $region, string $interconne * @type string $region * Name of the region for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -157,7 +177,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -178,7 +208,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/DeleteInterconnectGroupRequest.php b/Compute/src/V1/DeleteInterconnectGroupRequest.php index 32e436379f23..62673b623bbc 100644 --- a/Compute/src/V1/DeleteInterconnectGroupRequest.php +++ b/Compute/src/V1/DeleteInterconnectGroupRequest.php @@ -28,7 +28,18 @@ class DeleteInterconnectGroupRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). end_interface: MixerMutationRequestBuilder + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). + * end_interface: MixerMutationRequestBuilder * * Generated from protobuf field optional string request_id = 37109963; */ @@ -60,7 +71,18 @@ public static function build(string $project, string $interconnectGroup): self * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). end_interface: MixerMutationRequestBuilder + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). + * end_interface: MixerMutationRequestBuilder * } */ public function __construct($data = NULL) { @@ -121,7 +143,18 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). end_interface: MixerMutationRequestBuilder + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). + * end_interface: MixerMutationRequestBuilder * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -142,7 +175,18 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). end_interface: MixerMutationRequestBuilder + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). + * end_interface: MixerMutationRequestBuilder * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/DeleteInterconnectRequest.php b/Compute/src/V1/DeleteInterconnectRequest.php index 20d086f3e0d0..9566d0d35c75 100644 --- a/Compute/src/V1/DeleteInterconnectRequest.php +++ b/Compute/src/V1/DeleteInterconnectRequest.php @@ -28,7 +28,17 @@ class DeleteInterconnectRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -60,7 +70,17 @@ public static function build(string $project, string $interconnect): self * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -121,7 +141,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -142,7 +172,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/DeleteLicenseRequest.php b/Compute/src/V1/DeleteLicenseRequest.php index ed8681ad2da3..ab1bfa62c07b 100644 --- a/Compute/src/V1/DeleteLicenseRequest.php +++ b/Compute/src/V1/DeleteLicenseRequest.php @@ -28,7 +28,17 @@ class DeleteLicenseRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -60,7 +70,17 @@ public static function build(string $project, string $license): self * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -121,7 +141,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -142,7 +172,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/DeleteMachineImageRequest.php b/Compute/src/V1/DeleteMachineImageRequest.php index ef53d66ddff0..df3553f90cce 100644 --- a/Compute/src/V1/DeleteMachineImageRequest.php +++ b/Compute/src/V1/DeleteMachineImageRequest.php @@ -28,7 +28,17 @@ class DeleteMachineImageRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -60,7 +70,17 @@ public static function build(string $project, string $machineImage): self * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -121,7 +141,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -142,7 +172,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/DeleteNetworkAttachmentRequest.php b/Compute/src/V1/DeleteNetworkAttachmentRequest.php index 7bd52f26c713..1dffe1d2c622 100644 --- a/Compute/src/V1/DeleteNetworkAttachmentRequest.php +++ b/Compute/src/V1/DeleteNetworkAttachmentRequest.php @@ -34,7 +34,18 @@ class DeleteNetworkAttachmentRequest extends \Google\Protobuf\Internal\Message */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). end_interface: MixerMutationRequestBuilder + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). + * end_interface: MixerMutationRequestBuilder * * Generated from protobuf field optional string request_id = 37109963; */ @@ -70,7 +81,18 @@ public static function build(string $project, string $region, string $networkAtt * @type string $region * Name of the region of this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). end_interface: MixerMutationRequestBuilder + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). + * end_interface: MixerMutationRequestBuilder * } */ public function __construct($data = NULL) { @@ -157,7 +179,18 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). end_interface: MixerMutationRequestBuilder + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). + * end_interface: MixerMutationRequestBuilder * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -178,7 +211,18 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). end_interface: MixerMutationRequestBuilder + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). + * end_interface: MixerMutationRequestBuilder * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/DeleteNetworkEdgeSecurityServiceRequest.php b/Compute/src/V1/DeleteNetworkEdgeSecurityServiceRequest.php index 02bfdc310fbe..08b4bc05d6e4 100644 --- a/Compute/src/V1/DeleteNetworkEdgeSecurityServiceRequest.php +++ b/Compute/src/V1/DeleteNetworkEdgeSecurityServiceRequest.php @@ -34,7 +34,17 @@ class DeleteNetworkEdgeSecurityServiceRequest extends \Google\Protobuf\Internal\ */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -70,7 +80,17 @@ public static function build(string $project, string $region, string $networkEdg * @type string $region * Name of the region scoping this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -157,7 +177,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -178,7 +208,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/DeleteNetworkEndpointGroupRequest.php b/Compute/src/V1/DeleteNetworkEndpointGroupRequest.php index 1a56a6fc4115..ef659f612ced 100644 --- a/Compute/src/V1/DeleteNetworkEndpointGroupRequest.php +++ b/Compute/src/V1/DeleteNetworkEndpointGroupRequest.php @@ -16,7 +16,8 @@ class DeleteNetworkEndpointGroupRequest extends \Google\Protobuf\Internal\Message { /** - * The name of the network endpoint group to delete. It should comply with RFC1035. + * The name of the network endpoint group to delete. It should comply with + * RFC1035. * * Generated from protobuf field string network_endpoint_group = 433907078 [(.google.api.field_behavior) = REQUIRED]; */ @@ -28,13 +29,24 @@ class DeleteNetworkEndpointGroupRequest extends \Google\Protobuf\Internal\Messag */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ protected $request_id = null; /** - * The name of the zone where the network endpoint group is located. It should comply with RFC1035. + * The name of the zone where + * the network endpoint group is located. It should comply with RFC1035. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; */ @@ -42,8 +54,10 @@ class DeleteNetworkEndpointGroupRequest extends \Google\Protobuf\Internal\Messag /** * @param string $project Project ID for this request. - * @param string $zone The name of the zone where the network endpoint group is located. It should comply with RFC1035. - * @param string $networkEndpointGroup The name of the network endpoint group to delete. It should comply with RFC1035. + * @param string $zone The name of the zone where + * the network endpoint group is located. It should comply with RFC1035. + * @param string $networkEndpointGroup The name of the network endpoint group to delete. It should comply with + * RFC1035. * * @return \Google\Cloud\Compute\V1\DeleteNetworkEndpointGroupRequest * @@ -64,13 +78,25 @@ public static function build(string $project, string $zone, string $networkEndpo * Optional. Data for populating the Message object. * * @type string $network_endpoint_group - * The name of the network endpoint group to delete. It should comply with RFC1035. + * The name of the network endpoint group to delete. It should comply with + * RFC1035. * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $zone - * The name of the zone where the network endpoint group is located. It should comply with RFC1035. + * The name of the zone where + * the network endpoint group is located. It should comply with RFC1035. * } */ public function __construct($data = NULL) { @@ -79,7 +105,8 @@ public function __construct($data = NULL) { } /** - * The name of the network endpoint group to delete. It should comply with RFC1035. + * The name of the network endpoint group to delete. It should comply with + * RFC1035. * * Generated from protobuf field string network_endpoint_group = 433907078 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -90,7 +117,8 @@ public function getNetworkEndpointGroup() } /** - * The name of the network endpoint group to delete. It should comply with RFC1035. + * The name of the network endpoint group to delete. It should comply with + * RFC1035. * * Generated from protobuf field string network_endpoint_group = 433907078 [(.google.api.field_behavior) = REQUIRED]; * @param string $var @@ -131,7 +159,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -152,7 +190,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var @@ -167,7 +215,8 @@ public function setRequestId($var) } /** - * The name of the zone where the network endpoint group is located. It should comply with RFC1035. + * The name of the zone where + * the network endpoint group is located. It should comply with RFC1035. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; * @return string @@ -178,7 +227,8 @@ public function getZone() } /** - * The name of the zone where the network endpoint group is located. It should comply with RFC1035. + * The name of the zone where + * the network endpoint group is located. It should comply with RFC1035. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; * @param string $var diff --git a/Compute/src/V1/DeleteNetworkFirewallPolicyRequest.php b/Compute/src/V1/DeleteNetworkFirewallPolicyRequest.php index 1c7e5b3d62a9..2ef08c58ff17 100644 --- a/Compute/src/V1/DeleteNetworkFirewallPolicyRequest.php +++ b/Compute/src/V1/DeleteNetworkFirewallPolicyRequest.php @@ -28,7 +28,17 @@ class DeleteNetworkFirewallPolicyRequest extends \Google\Protobuf\Internal\Messa */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -60,7 +70,17 @@ public static function build(string $project, string $firewallPolicy): self * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -121,7 +141,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -142,7 +172,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/DeleteNetworkInterfaceInstanceRequest.php b/Compute/src/V1/DeleteNetworkInterfaceInstanceRequest.php index da134d34e856..d8b52746d09d 100644 --- a/Compute/src/V1/DeleteNetworkInterfaceInstanceRequest.php +++ b/Compute/src/V1/DeleteNetworkInterfaceInstanceRequest.php @@ -16,7 +16,8 @@ class DeleteNetworkInterfaceInstanceRequest extends \Google\Protobuf\Internal\Message { /** - * The instance name for this request stored as resource_id. Name should conform to RFC1035 or be an unsigned long integer. + * The instance name for this request stored as resource_id. + * Name should conform to RFC1035 or be an unsigned long integer. * * Generated from protobuf field string instance = 18257045 [(.google.api.field_behavior) = REQUIRED]; */ @@ -34,7 +35,17 @@ class DeleteNetworkInterfaceInstanceRequest extends \Google\Protobuf\Internal\Me */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -49,7 +60,8 @@ class DeleteNetworkInterfaceInstanceRequest extends \Google\Protobuf\Internal\Me /** * @param string $project Project ID for this request. * @param string $zone The name of the zone for this request. - * @param string $instance The instance name for this request stored as resource_id. Name should conform to RFC1035 or be an unsigned long integer. + * @param string $instance The instance name for this request stored as resource_id. + * Name should conform to RFC1035 or be an unsigned long integer. * @param string $networkInterfaceName The name of the dynamic network interface to be deleted from the instance. * * @return \Google\Cloud\Compute\V1\DeleteNetworkInterfaceInstanceRequest @@ -72,13 +84,24 @@ public static function build(string $project, string $zone, string $instance, st * Optional. Data for populating the Message object. * * @type string $instance - * The instance name for this request stored as resource_id. Name should conform to RFC1035 or be an unsigned long integer. + * The instance name for this request stored as resource_id. + * Name should conform to RFC1035 or be an unsigned long integer. * @type string $network_interface_name * The name of the dynamic network interface to be deleted from the instance. * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $zone * The name of the zone for this request. * } @@ -89,7 +112,8 @@ public function __construct($data = NULL) { } /** - * The instance name for this request stored as resource_id. Name should conform to RFC1035 or be an unsigned long integer. + * The instance name for this request stored as resource_id. + * Name should conform to RFC1035 or be an unsigned long integer. * * Generated from protobuf field string instance = 18257045 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -100,7 +124,8 @@ public function getInstance() } /** - * The instance name for this request stored as resource_id. Name should conform to RFC1035 or be an unsigned long integer. + * The instance name for this request stored as resource_id. + * Name should conform to RFC1035 or be an unsigned long integer. * * Generated from protobuf field string instance = 18257045 [(.google.api.field_behavior) = REQUIRED]; * @param string $var @@ -167,7 +192,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -188,7 +223,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/DeleteNetworkRequest.php b/Compute/src/V1/DeleteNetworkRequest.php index 8e51626cfbbb..e15f0f19bc1d 100644 --- a/Compute/src/V1/DeleteNetworkRequest.php +++ b/Compute/src/V1/DeleteNetworkRequest.php @@ -28,7 +28,17 @@ class DeleteNetworkRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -60,7 +70,17 @@ public static function build(string $project, string $network): self * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -121,7 +141,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -142,7 +172,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/DeleteNodeGroupRequest.php b/Compute/src/V1/DeleteNodeGroupRequest.php index 2d813cd4ac3e..98265b3029cd 100644 --- a/Compute/src/V1/DeleteNodeGroupRequest.php +++ b/Compute/src/V1/DeleteNodeGroupRequest.php @@ -28,7 +28,17 @@ class DeleteNodeGroupRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -68,7 +78,17 @@ public static function build(string $project, string $zone, string $nodeGroup): * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $zone * The name of the zone for this request. * } @@ -131,7 +151,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -152,7 +182,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/DeleteNodeTemplateRequest.php b/Compute/src/V1/DeleteNodeTemplateRequest.php index b298db1b7c4e..b89373dd08f5 100644 --- a/Compute/src/V1/DeleteNodeTemplateRequest.php +++ b/Compute/src/V1/DeleteNodeTemplateRequest.php @@ -34,7 +34,17 @@ class DeleteNodeTemplateRequest extends \Google\Protobuf\Internal\Message */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -70,7 +80,17 @@ public static function build(string $project, string $region, string $nodeTempla * @type string $region * The name of the region for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -157,7 +177,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -178,7 +208,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/DeleteNodesNodeGroupRequest.php b/Compute/src/V1/DeleteNodesNodeGroupRequest.php index 9ca8acbf6332..e5f3bb768c14 100644 --- a/Compute/src/V1/DeleteNodesNodeGroupRequest.php +++ b/Compute/src/V1/DeleteNodesNodeGroupRequest.php @@ -34,7 +34,17 @@ class DeleteNodesNodeGroupRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -78,7 +88,17 @@ public static function build(string $project, string $zone, string $nodeGroup, \ * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $zone * The name of the zone for this request. * } @@ -177,7 +197,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -198,7 +228,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/DeleteOrganizationSecurityPolicyRequest.php b/Compute/src/V1/DeleteOrganizationSecurityPolicyRequest.php index 9bf3b994b215..a4b6c1554eef 100644 --- a/Compute/src/V1/DeleteOrganizationSecurityPolicyRequest.php +++ b/Compute/src/V1/DeleteOrganizationSecurityPolicyRequest.php @@ -16,7 +16,17 @@ class DeleteOrganizationSecurityPolicyRequest extends \Google\Protobuf\Internal\Message { /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -48,7 +58,17 @@ public static function build(string $securityPolicy): self * Optional. Data for populating the Message object. * * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $security_policy * Name of the security policy to delete. * } @@ -59,7 +79,17 @@ public function __construct($data = NULL) { } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -80,7 +110,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/DeletePacketMirroringRequest.php b/Compute/src/V1/DeletePacketMirroringRequest.php index 946ddac2188d..8c3a73d9cc3d 100644 --- a/Compute/src/V1/DeletePacketMirroringRequest.php +++ b/Compute/src/V1/DeletePacketMirroringRequest.php @@ -34,7 +34,17 @@ class DeletePacketMirroringRequest extends \Google\Protobuf\Internal\Message */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -70,7 +80,17 @@ public static function build(string $project, string $region, string $packetMirr * @type string $region * Name of the region for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -157,7 +177,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -178,7 +208,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/DeletePerInstanceConfigsInstanceGroupManagerRequest.php b/Compute/src/V1/DeletePerInstanceConfigsInstanceGroupManagerRequest.php index ef0a7993a104..18196625dbe5 100644 --- a/Compute/src/V1/DeletePerInstanceConfigsInstanceGroupManagerRequest.php +++ b/Compute/src/V1/DeletePerInstanceConfigsInstanceGroupManagerRequest.php @@ -16,7 +16,8 @@ class DeletePerInstanceConfigsInstanceGroupManagerRequest extends \Google\Protobuf\Internal\Message { /** - * The name of the managed instance group. It should conform to RFC1035. + * The name of the managed instance group. + * It should conform to RFC1035. * * Generated from protobuf field string instance_group_manager = 249363395 [(.google.api.field_behavior) = REQUIRED]; */ @@ -34,7 +35,10 @@ class DeletePerInstanceConfigsInstanceGroupManagerRequest extends \Google\Protob */ protected $project = ''; /** - * The name of the zone where the managed instance group is located. It should conform to RFC1035. + * The name of thezone + * where the managed instance + * group is located. + * It should conform to RFC1035. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; */ @@ -42,8 +46,12 @@ class DeletePerInstanceConfigsInstanceGroupManagerRequest extends \Google\Protob /** * @param string $project Project ID for this request. - * @param string $zone The name of the zone where the managed instance group is located. It should conform to RFC1035. - * @param string $instanceGroupManager The name of the managed instance group. It should conform to RFC1035. + * @param string $zone The name of thezone + * where the managed instance + * group is located. + * It should conform to RFC1035. + * @param string $instanceGroupManager The name of the managed instance group. + * It should conform to RFC1035. * @param \Google\Cloud\Compute\V1\InstanceGroupManagersDeletePerInstanceConfigsReq $instanceGroupManagersDeletePerInstanceConfigsReqResource The body resource for this request * * @return \Google\Cloud\Compute\V1\DeletePerInstanceConfigsInstanceGroupManagerRequest @@ -66,13 +74,17 @@ public static function build(string $project, string $zone, string $instanceGrou * Optional. Data for populating the Message object. * * @type string $instance_group_manager - * The name of the managed instance group. It should conform to RFC1035. + * The name of the managed instance group. + * It should conform to RFC1035. * @type \Google\Cloud\Compute\V1\InstanceGroupManagersDeletePerInstanceConfigsReq $instance_group_managers_delete_per_instance_configs_req_resource * The body resource for this request * @type string $project * Project ID for this request. * @type string $zone - * The name of the zone where the managed instance group is located. It should conform to RFC1035. + * The name of thezone + * where the managed instance + * group is located. + * It should conform to RFC1035. * } */ public function __construct($data = NULL) { @@ -81,7 +93,8 @@ public function __construct($data = NULL) { } /** - * The name of the managed instance group. It should conform to RFC1035. + * The name of the managed instance group. + * It should conform to RFC1035. * * Generated from protobuf field string instance_group_manager = 249363395 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -92,7 +105,8 @@ public function getInstanceGroupManager() } /** - * The name of the managed instance group. It should conform to RFC1035. + * The name of the managed instance group. + * It should conform to RFC1035. * * Generated from protobuf field string instance_group_manager = 249363395 [(.google.api.field_behavior) = REQUIRED]; * @param string $var @@ -169,7 +183,10 @@ public function setProject($var) } /** - * The name of the zone where the managed instance group is located. It should conform to RFC1035. + * The name of thezone + * where the managed instance + * group is located. + * It should conform to RFC1035. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; * @return string @@ -180,7 +197,10 @@ public function getZone() } /** - * The name of the zone where the managed instance group is located. It should conform to RFC1035. + * The name of thezone + * where the managed instance + * group is located. + * It should conform to RFC1035. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; * @param string $var diff --git a/Compute/src/V1/DeletePublicAdvertisedPrefixeRequest.php b/Compute/src/V1/DeletePublicAdvertisedPrefixeRequest.php index 924eda03a58b..4d42c8925612 100644 --- a/Compute/src/V1/DeletePublicAdvertisedPrefixeRequest.php +++ b/Compute/src/V1/DeletePublicAdvertisedPrefixeRequest.php @@ -28,7 +28,17 @@ class DeletePublicAdvertisedPrefixeRequest extends \Google\Protobuf\Internal\Mes */ protected $public_advertised_prefix = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -60,7 +70,17 @@ public static function build(string $project, string $publicAdvertisedPrefix): s * @type string $public_advertised_prefix * Name of the PublicAdvertisedPrefix resource to delete. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -121,7 +141,17 @@ public function setPublicAdvertisedPrefix($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -142,7 +172,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/DeletePublicDelegatedPrefixeRequest.php b/Compute/src/V1/DeletePublicDelegatedPrefixeRequest.php index a2c01a9ac080..1e22b134e25e 100644 --- a/Compute/src/V1/DeletePublicDelegatedPrefixeRequest.php +++ b/Compute/src/V1/DeletePublicDelegatedPrefixeRequest.php @@ -34,7 +34,17 @@ class DeletePublicDelegatedPrefixeRequest extends \Google\Protobuf\Internal\Mess */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -70,7 +80,17 @@ public static function build(string $project, string $region, string $publicDele * @type string $region * Name of the region of this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -157,7 +177,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -178,7 +208,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/DeleteRegionAutoscalerRequest.php b/Compute/src/V1/DeleteRegionAutoscalerRequest.php index 604f0c38eab7..e831d9bcdd59 100644 --- a/Compute/src/V1/DeleteRegionAutoscalerRequest.php +++ b/Compute/src/V1/DeleteRegionAutoscalerRequest.php @@ -34,7 +34,17 @@ class DeleteRegionAutoscalerRequest extends \Google\Protobuf\Internal\Message */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -70,7 +80,17 @@ public static function build(string $project, string $region, string $autoscaler * @type string $region * Name of the region scoping this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -157,7 +177,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -178,7 +208,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/DeleteRegionBackendServiceRequest.php b/Compute/src/V1/DeleteRegionBackendServiceRequest.php index afd66b4c47ac..b810ed43a079 100644 --- a/Compute/src/V1/DeleteRegionBackendServiceRequest.php +++ b/Compute/src/V1/DeleteRegionBackendServiceRequest.php @@ -34,7 +34,17 @@ class DeleteRegionBackendServiceRequest extends \Google\Protobuf\Internal\Messag */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -70,7 +80,17 @@ public static function build(string $project, string $region, string $backendSer * @type string $region * Name of the region scoping this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -157,7 +177,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -178,7 +208,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/DeleteRegionDiskRequest.php b/Compute/src/V1/DeleteRegionDiskRequest.php index 072f6a3b0ac6..4c687ae3654a 100644 --- a/Compute/src/V1/DeleteRegionDiskRequest.php +++ b/Compute/src/V1/DeleteRegionDiskRequest.php @@ -34,7 +34,17 @@ class DeleteRegionDiskRequest extends \Google\Protobuf\Internal\Message */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -70,7 +80,17 @@ public static function build(string $project, string $region, string $disk): sel * @type string $region * Name of the region for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -157,7 +177,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -178,7 +208,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/DeleteRegionHealthCheckRequest.php b/Compute/src/V1/DeleteRegionHealthCheckRequest.php index 9cc2dac5f584..7ab4805bd37a 100644 --- a/Compute/src/V1/DeleteRegionHealthCheckRequest.php +++ b/Compute/src/V1/DeleteRegionHealthCheckRequest.php @@ -34,7 +34,17 @@ class DeleteRegionHealthCheckRequest extends \Google\Protobuf\Internal\Message */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -70,7 +80,17 @@ public static function build(string $project, string $region, string $healthChec * @type string $region * Name of the region scoping this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -157,7 +177,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -178,7 +208,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/DeleteRegionHealthCheckServiceRequest.php b/Compute/src/V1/DeleteRegionHealthCheckServiceRequest.php index 814ea05db8ba..60fff443ba9d 100644 --- a/Compute/src/V1/DeleteRegionHealthCheckServiceRequest.php +++ b/Compute/src/V1/DeleteRegionHealthCheckServiceRequest.php @@ -16,7 +16,8 @@ class DeleteRegionHealthCheckServiceRequest extends \Google\Protobuf\Internal\Message { /** - * Name of the HealthCheckService to delete. The name must be 1-63 characters long, and comply with RFC1035. + * Name of the HealthCheckService to delete. The name + * must be 1-63 characters long, and comply with RFC1035. * * Generated from protobuf field string health_check_service = 408374747 [(.google.api.field_behavior) = REQUIRED]; */ @@ -34,7 +35,17 @@ class DeleteRegionHealthCheckServiceRequest extends \Google\Protobuf\Internal\Me */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -43,7 +54,8 @@ class DeleteRegionHealthCheckServiceRequest extends \Google\Protobuf\Internal\Me /** * @param string $project Project ID for this request. * @param string $region Name of the region scoping this request. - * @param string $healthCheckService Name of the HealthCheckService to delete. The name must be 1-63 characters long, and comply with RFC1035. + * @param string $healthCheckService Name of the HealthCheckService to delete. The name + * must be 1-63 characters long, and comply with RFC1035. * * @return \Google\Cloud\Compute\V1\DeleteRegionHealthCheckServiceRequest * @@ -64,13 +76,24 @@ public static function build(string $project, string $region, string $healthChec * Optional. Data for populating the Message object. * * @type string $health_check_service - * Name of the HealthCheckService to delete. The name must be 1-63 characters long, and comply with RFC1035. + * Name of the HealthCheckService to delete. The name + * must be 1-63 characters long, and comply with RFC1035. * @type string $project * Project ID for this request. * @type string $region * Name of the region scoping this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -79,7 +102,8 @@ public function __construct($data = NULL) { } /** - * Name of the HealthCheckService to delete. The name must be 1-63 characters long, and comply with RFC1035. + * Name of the HealthCheckService to delete. The name + * must be 1-63 characters long, and comply with RFC1035. * * Generated from protobuf field string health_check_service = 408374747 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -90,7 +114,8 @@ public function getHealthCheckService() } /** - * Name of the HealthCheckService to delete. The name must be 1-63 characters long, and comply with RFC1035. + * Name of the HealthCheckService to delete. The name + * must be 1-63 characters long, and comply with RFC1035. * * Generated from protobuf field string health_check_service = 408374747 [(.google.api.field_behavior) = REQUIRED]; * @param string $var @@ -157,7 +182,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -178,7 +213,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/DeleteRegionInstanceGroupManagerRequest.php b/Compute/src/V1/DeleteRegionInstanceGroupManagerRequest.php index 440c7660b4eb..7853a60a0f32 100644 --- a/Compute/src/V1/DeleteRegionInstanceGroupManagerRequest.php +++ b/Compute/src/V1/DeleteRegionInstanceGroupManagerRequest.php @@ -34,7 +34,17 @@ class DeleteRegionInstanceGroupManagerRequest extends \Google\Protobuf\Internal\ */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -70,7 +80,17 @@ public static function build(string $project, string $region, string $instanceGr * @type string $region * Name of the region scoping this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -157,7 +177,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -178,7 +208,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/DeleteRegionInstanceTemplateRequest.php b/Compute/src/V1/DeleteRegionInstanceTemplateRequest.php index 7086be486330..dabe2c6f6542 100644 --- a/Compute/src/V1/DeleteRegionInstanceTemplateRequest.php +++ b/Compute/src/V1/DeleteRegionInstanceTemplateRequest.php @@ -34,7 +34,17 @@ class DeleteRegionInstanceTemplateRequest extends \Google\Protobuf\Internal\Mess */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -70,7 +80,17 @@ public static function build(string $project, string $region, string $instanceTe * @type string $region * The name of the region for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -157,7 +177,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -178,7 +208,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/DeleteRegionInstantSnapshotRequest.php b/Compute/src/V1/DeleteRegionInstantSnapshotRequest.php index d51beda56198..89ec4ed95e5c 100644 --- a/Compute/src/V1/DeleteRegionInstantSnapshotRequest.php +++ b/Compute/src/V1/DeleteRegionInstantSnapshotRequest.php @@ -34,7 +34,17 @@ class DeleteRegionInstantSnapshotRequest extends \Google\Protobuf\Internal\Messa */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -70,7 +80,17 @@ public static function build(string $project, string $region, string $instantSna * @type string $region * The name of the region for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -157,7 +177,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -178,7 +208,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/DeleteRegionNetworkEndpointGroupRequest.php b/Compute/src/V1/DeleteRegionNetworkEndpointGroupRequest.php index cd7825917c03..b09a1e241635 100644 --- a/Compute/src/V1/DeleteRegionNetworkEndpointGroupRequest.php +++ b/Compute/src/V1/DeleteRegionNetworkEndpointGroupRequest.php @@ -16,7 +16,8 @@ class DeleteRegionNetworkEndpointGroupRequest extends \Google\Protobuf\Internal\Message { /** - * The name of the network endpoint group to delete. It should comply with RFC1035. + * The name of the network endpoint group to delete. It should comply with + * RFC1035. * * Generated from protobuf field string network_endpoint_group = 433907078 [(.google.api.field_behavior) = REQUIRED]; */ @@ -28,13 +29,24 @@ class DeleteRegionNetworkEndpointGroupRequest extends \Google\Protobuf\Internal\ */ protected $project = ''; /** - * The name of the region where the network endpoint group is located. It should comply with RFC1035. + * The name of the region where + * the network endpoint group is located. It should comply with RFC1035. * * Generated from protobuf field string region = 138946292 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "region"]; */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -42,8 +54,10 @@ class DeleteRegionNetworkEndpointGroupRequest extends \Google\Protobuf\Internal\ /** * @param string $project Project ID for this request. - * @param string $region The name of the region where the network endpoint group is located. It should comply with RFC1035. - * @param string $networkEndpointGroup The name of the network endpoint group to delete. It should comply with RFC1035. + * @param string $region The name of the region where + * the network endpoint group is located. It should comply with RFC1035. + * @param string $networkEndpointGroup The name of the network endpoint group to delete. It should comply with + * RFC1035. * * @return \Google\Cloud\Compute\V1\DeleteRegionNetworkEndpointGroupRequest * @@ -64,13 +78,25 @@ public static function build(string $project, string $region, string $networkEnd * Optional. Data for populating the Message object. * * @type string $network_endpoint_group - * The name of the network endpoint group to delete. It should comply with RFC1035. + * The name of the network endpoint group to delete. It should comply with + * RFC1035. * @type string $project * Project ID for this request. * @type string $region - * The name of the region where the network endpoint group is located. It should comply with RFC1035. + * The name of the region where + * the network endpoint group is located. It should comply with RFC1035. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -79,7 +105,8 @@ public function __construct($data = NULL) { } /** - * The name of the network endpoint group to delete. It should comply with RFC1035. + * The name of the network endpoint group to delete. It should comply with + * RFC1035. * * Generated from protobuf field string network_endpoint_group = 433907078 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -90,7 +117,8 @@ public function getNetworkEndpointGroup() } /** - * The name of the network endpoint group to delete. It should comply with RFC1035. + * The name of the network endpoint group to delete. It should comply with + * RFC1035. * * Generated from protobuf field string network_endpoint_group = 433907078 [(.google.api.field_behavior) = REQUIRED]; * @param string $var @@ -131,7 +159,8 @@ public function setProject($var) } /** - * The name of the region where the network endpoint group is located. It should comply with RFC1035. + * The name of the region where + * the network endpoint group is located. It should comply with RFC1035. * * Generated from protobuf field string region = 138946292 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "region"]; * @return string @@ -142,7 +171,8 @@ public function getRegion() } /** - * The name of the region where the network endpoint group is located. It should comply with RFC1035. + * The name of the region where + * the network endpoint group is located. It should comply with RFC1035. * * Generated from protobuf field string region = 138946292 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "region"]; * @param string $var @@ -157,7 +187,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -178,7 +218,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/DeleteRegionNetworkFirewallPolicyRequest.php b/Compute/src/V1/DeleteRegionNetworkFirewallPolicyRequest.php index 523493331572..e43126bb39c9 100644 --- a/Compute/src/V1/DeleteRegionNetworkFirewallPolicyRequest.php +++ b/Compute/src/V1/DeleteRegionNetworkFirewallPolicyRequest.php @@ -34,7 +34,17 @@ class DeleteRegionNetworkFirewallPolicyRequest extends \Google\Protobuf\Internal */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -70,7 +80,17 @@ public static function build(string $project, string $region, string $firewallPo * @type string $region * Name of the region scoping this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -157,7 +177,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -178,7 +208,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/DeleteRegionNotificationEndpointRequest.php b/Compute/src/V1/DeleteRegionNotificationEndpointRequest.php index 22d00a7512ba..12ef54db66b1 100644 --- a/Compute/src/V1/DeleteRegionNotificationEndpointRequest.php +++ b/Compute/src/V1/DeleteRegionNotificationEndpointRequest.php @@ -34,7 +34,17 @@ class DeleteRegionNotificationEndpointRequest extends \Google\Protobuf\Internal\ */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -70,7 +80,17 @@ public static function build(string $project, string $region, string $notificati * @type string $region * Name of the region scoping this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -157,7 +177,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -178,7 +208,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/DeleteRegionOperationRequest.php b/Compute/src/V1/DeleteRegionOperationRequest.php index e96f80d5c5ed..2e4cc342c6f4 100644 --- a/Compute/src/V1/DeleteRegionOperationRequest.php +++ b/Compute/src/V1/DeleteRegionOperationRequest.php @@ -16,7 +16,8 @@ class DeleteRegionOperationRequest extends \Google\Protobuf\Internal\Message { /** - * Name of the Operations resource to delete, or its unique numeric identifier. + * Name of the Operations resource to delete, or its unique numeric + * identifier. * * Generated from protobuf field string operation = 52090215 [(.google.api.field_behavior) = REQUIRED]; */ @@ -37,7 +38,8 @@ class DeleteRegionOperationRequest extends \Google\Protobuf\Internal\Message /** * @param string $project Project ID for this request. * @param string $region Name of the region for this request. - * @param string $operation Name of the Operations resource to delete, or its unique numeric identifier. + * @param string $operation Name of the Operations resource to delete, or its unique numeric + * identifier. * * @return \Google\Cloud\Compute\V1\DeleteRegionOperationRequest * @@ -58,7 +60,8 @@ public static function build(string $project, string $region, string $operation) * Optional. Data for populating the Message object. * * @type string $operation - * Name of the Operations resource to delete, or its unique numeric identifier. + * Name of the Operations resource to delete, or its unique numeric + * identifier. * @type string $project * Project ID for this request. * @type string $region @@ -71,7 +74,8 @@ public function __construct($data = NULL) { } /** - * Name of the Operations resource to delete, or its unique numeric identifier. + * Name of the Operations resource to delete, or its unique numeric + * identifier. * * Generated from protobuf field string operation = 52090215 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -82,7 +86,8 @@ public function getOperation() } /** - * Name of the Operations resource to delete, or its unique numeric identifier. + * Name of the Operations resource to delete, or its unique numeric + * identifier. * * Generated from protobuf field string operation = 52090215 [(.google.api.field_behavior) = REQUIRED]; * @param string $var diff --git a/Compute/src/V1/DeleteRegionSecurityPolicyRequest.php b/Compute/src/V1/DeleteRegionSecurityPolicyRequest.php index c52c83418a55..9b890993aad1 100644 --- a/Compute/src/V1/DeleteRegionSecurityPolicyRequest.php +++ b/Compute/src/V1/DeleteRegionSecurityPolicyRequest.php @@ -28,7 +28,17 @@ class DeleteRegionSecurityPolicyRequest extends \Google\Protobuf\Internal\Messag */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -68,7 +78,17 @@ public static function build(string $project, string $region, string $securityPo * @type string $region * Name of the region scoping this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $security_policy * Name of the security policy to delete. * } @@ -131,7 +151,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -152,7 +182,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/DeleteRegionSslCertificateRequest.php b/Compute/src/V1/DeleteRegionSslCertificateRequest.php index 76f186fe84e0..a0dd3c135a8e 100644 --- a/Compute/src/V1/DeleteRegionSslCertificateRequest.php +++ b/Compute/src/V1/DeleteRegionSslCertificateRequest.php @@ -28,7 +28,17 @@ class DeleteRegionSslCertificateRequest extends \Google\Protobuf\Internal\Messag */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -68,7 +78,17 @@ public static function build(string $project, string $region, string $sslCertifi * @type string $region * Name of the region scoping this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $ssl_certificate * Name of the SslCertificate resource to delete. * } @@ -131,7 +151,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -152,7 +182,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/DeleteRegionSslPolicyRequest.php b/Compute/src/V1/DeleteRegionSslPolicyRequest.php index 14c9e6262a7e..8f61ce858b43 100644 --- a/Compute/src/V1/DeleteRegionSslPolicyRequest.php +++ b/Compute/src/V1/DeleteRegionSslPolicyRequest.php @@ -28,13 +28,24 @@ class DeleteRegionSslPolicyRequest extends \Google\Protobuf\Internal\Message */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ protected $request_id = null; /** - * Name of the SSL policy to delete. The name must be 1-63 characters long, and comply with RFC1035. + * Name of the SSL policy to delete. The name must be 1-63 characters long, + * and comply with RFC1035. * * Generated from protobuf field string ssl_policy = 295190213 [(.google.api.field_behavior) = REQUIRED]; */ @@ -43,7 +54,8 @@ class DeleteRegionSslPolicyRequest extends \Google\Protobuf\Internal\Message /** * @param string $project Project ID for this request. * @param string $region Name of the region scoping this request. - * @param string $sslPolicy Name of the SSL policy to delete. The name must be 1-63 characters long, and comply with RFC1035. + * @param string $sslPolicy Name of the SSL policy to delete. The name must be 1-63 characters long, + * and comply with RFC1035. * * @return \Google\Cloud\Compute\V1\DeleteRegionSslPolicyRequest * @@ -68,9 +80,20 @@ public static function build(string $project, string $region, string $sslPolicy) * @type string $region * Name of the region scoping this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $ssl_policy - * Name of the SSL policy to delete. The name must be 1-63 characters long, and comply with RFC1035. + * Name of the SSL policy to delete. The name must be 1-63 characters long, + * and comply with RFC1035. * } */ public function __construct($data = NULL) { @@ -131,7 +154,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -152,7 +185,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var @@ -167,7 +210,8 @@ public function setRequestId($var) } /** - * Name of the SSL policy to delete. The name must be 1-63 characters long, and comply with RFC1035. + * Name of the SSL policy to delete. The name must be 1-63 characters long, + * and comply with RFC1035. * * Generated from protobuf field string ssl_policy = 295190213 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -178,7 +222,8 @@ public function getSslPolicy() } /** - * Name of the SSL policy to delete. The name must be 1-63 characters long, and comply with RFC1035. + * Name of the SSL policy to delete. The name must be 1-63 characters long, + * and comply with RFC1035. * * Generated from protobuf field string ssl_policy = 295190213 [(.google.api.field_behavior) = REQUIRED]; * @param string $var diff --git a/Compute/src/V1/DeleteRegionTargetHttpProxyRequest.php b/Compute/src/V1/DeleteRegionTargetHttpProxyRequest.php index fec987d6a913..fcbf8a6c821a 100644 --- a/Compute/src/V1/DeleteRegionTargetHttpProxyRequest.php +++ b/Compute/src/V1/DeleteRegionTargetHttpProxyRequest.php @@ -28,7 +28,17 @@ class DeleteRegionTargetHttpProxyRequest extends \Google\Protobuf\Internal\Messa */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -68,7 +78,17 @@ public static function build(string $project, string $region, string $targetHttp * @type string $region * Name of the region scoping this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $target_http_proxy * Name of the TargetHttpProxy resource to delete. * } @@ -131,7 +151,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -152,7 +182,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/DeleteRegionTargetHttpsProxyRequest.php b/Compute/src/V1/DeleteRegionTargetHttpsProxyRequest.php index 5b1b71cf7320..0520cd6b095e 100644 --- a/Compute/src/V1/DeleteRegionTargetHttpsProxyRequest.php +++ b/Compute/src/V1/DeleteRegionTargetHttpsProxyRequest.php @@ -28,7 +28,17 @@ class DeleteRegionTargetHttpsProxyRequest extends \Google\Protobuf\Internal\Mess */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -68,7 +78,17 @@ public static function build(string $project, string $region, string $targetHttp * @type string $region * Name of the region scoping this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $target_https_proxy * Name of the TargetHttpsProxy resource to delete. * } @@ -131,7 +151,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -152,7 +182,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/DeleteRegionTargetTcpProxyRequest.php b/Compute/src/V1/DeleteRegionTargetTcpProxyRequest.php index 7f8c10f25370..b02f3ccdc29b 100644 --- a/Compute/src/V1/DeleteRegionTargetTcpProxyRequest.php +++ b/Compute/src/V1/DeleteRegionTargetTcpProxyRequest.php @@ -28,7 +28,17 @@ class DeleteRegionTargetTcpProxyRequest extends \Google\Protobuf\Internal\Messag */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -68,7 +78,17 @@ public static function build(string $project, string $region, string $targetTcpP * @type string $region * Name of the region scoping this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $target_tcp_proxy * Name of the TargetTcpProxy resource to delete. * } @@ -131,7 +151,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -152,7 +182,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/DeleteRegionUrlMapRequest.php b/Compute/src/V1/DeleteRegionUrlMapRequest.php index a2ded264c587..c7d3e048aa80 100644 --- a/Compute/src/V1/DeleteRegionUrlMapRequest.php +++ b/Compute/src/V1/DeleteRegionUrlMapRequest.php @@ -28,7 +28,8 @@ class DeleteRegionUrlMapRequest extends \Google\Protobuf\Internal\Message */ protected $region = ''; /** - * begin_interface: MixerMutationRequestBuilder Request ID to support idempotency. + * begin_interface: MixerMutationRequestBuilder + * Request ID to support idempotency. * * Generated from protobuf field optional string request_id = 37109963; */ @@ -68,7 +69,8 @@ public static function build(string $project, string $region, string $urlMap): s * @type string $region * Name of the region scoping this request. * @type string $request_id - * begin_interface: MixerMutationRequestBuilder Request ID to support idempotency. + * begin_interface: MixerMutationRequestBuilder + * Request ID to support idempotency. * @type string $url_map * Name of the UrlMap resource to delete. * } @@ -131,7 +133,8 @@ public function setRegion($var) } /** - * begin_interface: MixerMutationRequestBuilder Request ID to support idempotency. + * begin_interface: MixerMutationRequestBuilder + * Request ID to support idempotency. * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -152,7 +155,8 @@ public function clearRequestId() } /** - * begin_interface: MixerMutationRequestBuilder Request ID to support idempotency. + * begin_interface: MixerMutationRequestBuilder + * Request ID to support idempotency. * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/DeleteReservationRequest.php b/Compute/src/V1/DeleteReservationRequest.php index 00511e3d303a..736027c42b89 100644 --- a/Compute/src/V1/DeleteReservationRequest.php +++ b/Compute/src/V1/DeleteReservationRequest.php @@ -22,7 +22,17 @@ class DeleteReservationRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -66,7 +76,17 @@ public static function build(string $project, string $zone, string $reservation) * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $reservation * Name of the reservation to delete. * @type string $zone @@ -105,7 +125,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -126,7 +156,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/DeleteResourcePolicyRequest.php b/Compute/src/V1/DeleteResourcePolicyRequest.php index 270a46a67665..1925c6a98cc6 100644 --- a/Compute/src/V1/DeleteResourcePolicyRequest.php +++ b/Compute/src/V1/DeleteResourcePolicyRequest.php @@ -28,7 +28,17 @@ class DeleteResourcePolicyRequest extends \Google\Protobuf\Internal\Message */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -68,7 +78,17 @@ public static function build(string $project, string $region, string $resourcePo * @type string $region * Name of the region for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $resource_policy * Name of the resource policy to delete. * } @@ -131,7 +151,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -152,7 +182,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/DeleteRoutePolicyRouterRequest.php b/Compute/src/V1/DeleteRoutePolicyRouterRequest.php index fffae84e2cf1..a10f9ecdad6c 100644 --- a/Compute/src/V1/DeleteRoutePolicyRouterRequest.php +++ b/Compute/src/V1/DeleteRoutePolicyRouterRequest.php @@ -34,7 +34,17 @@ class DeleteRoutePolicyRouterRequest extends \Google\Protobuf\Internal\Message */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -76,7 +86,17 @@ public static function build(string $project, string $region, string $router): s * @type string $region * Name of the region for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $router * Name of the Router resource where Route Policy is defined. * } @@ -175,7 +195,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -196,7 +226,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/DeleteRouteRequest.php b/Compute/src/V1/DeleteRouteRequest.php index cad8da12a967..8c31430fb505 100644 --- a/Compute/src/V1/DeleteRouteRequest.php +++ b/Compute/src/V1/DeleteRouteRequest.php @@ -22,7 +22,17 @@ class DeleteRouteRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -58,7 +68,17 @@ public static function build(string $project, string $route): self * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $route * Name of the Route resource to delete. * } @@ -95,7 +115,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -116,7 +146,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/DeleteRouterRequest.php b/Compute/src/V1/DeleteRouterRequest.php index bcc52268c573..3c2e0bc4b9dc 100644 --- a/Compute/src/V1/DeleteRouterRequest.php +++ b/Compute/src/V1/DeleteRouterRequest.php @@ -28,7 +28,17 @@ class DeleteRouterRequest extends \Google\Protobuf\Internal\Message */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -68,7 +78,17 @@ public static function build(string $project, string $region, string $router): s * @type string $region * Name of the region for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $router * Name of the Router resource to delete. * } @@ -131,7 +151,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -152,7 +182,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/DeleteSecurityPolicyRequest.php b/Compute/src/V1/DeleteSecurityPolicyRequest.php index a365299ada2e..95e47e2af31d 100644 --- a/Compute/src/V1/DeleteSecurityPolicyRequest.php +++ b/Compute/src/V1/DeleteSecurityPolicyRequest.php @@ -22,7 +22,17 @@ class DeleteSecurityPolicyRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -58,7 +68,17 @@ public static function build(string $project, string $securityPolicy): self * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $security_policy * Name of the security policy to delete. * } @@ -95,7 +115,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -116,7 +146,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/DeleteServiceAttachmentRequest.php b/Compute/src/V1/DeleteServiceAttachmentRequest.php index 1df40c90e65f..3cc6184c38ca 100644 --- a/Compute/src/V1/DeleteServiceAttachmentRequest.php +++ b/Compute/src/V1/DeleteServiceAttachmentRequest.php @@ -28,7 +28,17 @@ class DeleteServiceAttachmentRequest extends \Google\Protobuf\Internal\Message */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -68,7 +78,17 @@ public static function build(string $project, string $region, string $serviceAtt * @type string $region * Name of the region of this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $service_attachment * Name of the ServiceAttachment resource to delete. * } @@ -131,7 +151,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -152,7 +182,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/DeleteSignedUrlKeyBackendBucketRequest.php b/Compute/src/V1/DeleteSignedUrlKeyBackendBucketRequest.php index f4933a4b70d6..5013c3ad26ff 100644 --- a/Compute/src/V1/DeleteSignedUrlKeyBackendBucketRequest.php +++ b/Compute/src/V1/DeleteSignedUrlKeyBackendBucketRequest.php @@ -16,7 +16,8 @@ class DeleteSignedUrlKeyBackendBucketRequest extends \Google\Protobuf\Internal\Message { /** - * Name of the BackendBucket resource to which the Signed URL Key should be added. The name should conform to RFC1035. + * Name of the BackendBucket resource to which the Signed URL Key should be + * added. The name should conform to RFC1035. * * Generated from protobuf field string backend_bucket = 91714037 [(.google.api.field_behavior) = REQUIRED]; */ @@ -34,7 +35,17 @@ class DeleteSignedUrlKeyBackendBucketRequest extends \Google\Protobuf\Internal\M */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -42,7 +53,8 @@ class DeleteSignedUrlKeyBackendBucketRequest extends \Google\Protobuf\Internal\M /** * @param string $project Project ID for this request. - * @param string $backendBucket Name of the BackendBucket resource to which the Signed URL Key should be added. The name should conform to RFC1035. + * @param string $backendBucket Name of the BackendBucket resource to which the Signed URL Key should be + * added. The name should conform to RFC1035. * @param string $keyName The name of the Signed URL Key to delete. * * @return \Google\Cloud\Compute\V1\DeleteSignedUrlKeyBackendBucketRequest @@ -64,13 +76,24 @@ public static function build(string $project, string $backendBucket, string $key * Optional. Data for populating the Message object. * * @type string $backend_bucket - * Name of the BackendBucket resource to which the Signed URL Key should be added. The name should conform to RFC1035. + * Name of the BackendBucket resource to which the Signed URL Key should be + * added. The name should conform to RFC1035. * @type string $key_name * The name of the Signed URL Key to delete. * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -79,7 +102,8 @@ public function __construct($data = NULL) { } /** - * Name of the BackendBucket resource to which the Signed URL Key should be added. The name should conform to RFC1035. + * Name of the BackendBucket resource to which the Signed URL Key should be + * added. The name should conform to RFC1035. * * Generated from protobuf field string backend_bucket = 91714037 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -90,7 +114,8 @@ public function getBackendBucket() } /** - * Name of the BackendBucket resource to which the Signed URL Key should be added. The name should conform to RFC1035. + * Name of the BackendBucket resource to which the Signed URL Key should be + * added. The name should conform to RFC1035. * * Generated from protobuf field string backend_bucket = 91714037 [(.google.api.field_behavior) = REQUIRED]; * @param string $var @@ -157,7 +182,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -178,7 +213,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/DeleteSignedUrlKeyBackendServiceRequest.php b/Compute/src/V1/DeleteSignedUrlKeyBackendServiceRequest.php index c0178f9f0405..480372df178c 100644 --- a/Compute/src/V1/DeleteSignedUrlKeyBackendServiceRequest.php +++ b/Compute/src/V1/DeleteSignedUrlKeyBackendServiceRequest.php @@ -16,7 +16,8 @@ class DeleteSignedUrlKeyBackendServiceRequest extends \Google\Protobuf\Internal\Message { /** - * Name of the BackendService resource to which the Signed URL Key should be added. The name should conform to RFC1035. + * Name of the BackendService resource to which the Signed URL Key should be + * added. The name should conform to RFC1035. * * Generated from protobuf field string backend_service = 306946058 [(.google.api.field_behavior) = REQUIRED]; */ @@ -34,7 +35,17 @@ class DeleteSignedUrlKeyBackendServiceRequest extends \Google\Protobuf\Internal\ */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -42,7 +53,8 @@ class DeleteSignedUrlKeyBackendServiceRequest extends \Google\Protobuf\Internal\ /** * @param string $project Project ID for this request. - * @param string $backendService Name of the BackendService resource to which the Signed URL Key should be added. The name should conform to RFC1035. + * @param string $backendService Name of the BackendService resource to which the Signed URL Key should be + * added. The name should conform to RFC1035. * @param string $keyName The name of the Signed URL Key to delete. * * @return \Google\Cloud\Compute\V1\DeleteSignedUrlKeyBackendServiceRequest @@ -64,13 +76,24 @@ public static function build(string $project, string $backendService, string $ke * Optional. Data for populating the Message object. * * @type string $backend_service - * Name of the BackendService resource to which the Signed URL Key should be added. The name should conform to RFC1035. + * Name of the BackendService resource to which the Signed URL Key should be + * added. The name should conform to RFC1035. * @type string $key_name * The name of the Signed URL Key to delete. * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -79,7 +102,8 @@ public function __construct($data = NULL) { } /** - * Name of the BackendService resource to which the Signed URL Key should be added. The name should conform to RFC1035. + * Name of the BackendService resource to which the Signed URL Key should be + * added. The name should conform to RFC1035. * * Generated from protobuf field string backend_service = 306946058 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -90,7 +114,8 @@ public function getBackendService() } /** - * Name of the BackendService resource to which the Signed URL Key should be added. The name should conform to RFC1035. + * Name of the BackendService resource to which the Signed URL Key should be + * added. The name should conform to RFC1035. * * Generated from protobuf field string backend_service = 306946058 [(.google.api.field_behavior) = REQUIRED]; * @param string $var @@ -157,7 +182,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -178,7 +213,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/DeleteSnapshotRequest.php b/Compute/src/V1/DeleteSnapshotRequest.php index f9c364f4bfaf..53d201e510c2 100644 --- a/Compute/src/V1/DeleteSnapshotRequest.php +++ b/Compute/src/V1/DeleteSnapshotRequest.php @@ -22,7 +22,17 @@ class DeleteSnapshotRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -58,7 +68,17 @@ public static function build(string $project, string $snapshot): self * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $snapshot * Name of the Snapshot resource to delete. * } @@ -95,7 +115,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -116,7 +146,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/DeleteSslCertificateRequest.php b/Compute/src/V1/DeleteSslCertificateRequest.php index 41860141b225..3e75925acf13 100644 --- a/Compute/src/V1/DeleteSslCertificateRequest.php +++ b/Compute/src/V1/DeleteSslCertificateRequest.php @@ -22,7 +22,17 @@ class DeleteSslCertificateRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -58,7 +68,17 @@ public static function build(string $project, string $sslCertificate): self * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $ssl_certificate * Name of the SslCertificate resource to delete. * } @@ -95,7 +115,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -116,7 +146,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/DeleteSslPolicyRequest.php b/Compute/src/V1/DeleteSslPolicyRequest.php index 43358777bbd1..b739cd769ee2 100644 --- a/Compute/src/V1/DeleteSslPolicyRequest.php +++ b/Compute/src/V1/DeleteSslPolicyRequest.php @@ -22,13 +22,24 @@ class DeleteSslPolicyRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ protected $request_id = null; /** - * Name of the SSL policy to delete. The name must be 1-63 characters long, and comply with RFC1035. + * Name of the SSL policy to delete. The name must be 1-63 characters long, + * and comply with RFC1035. * * Generated from protobuf field string ssl_policy = 295190213 [(.google.api.field_behavior) = REQUIRED]; */ @@ -36,7 +47,8 @@ class DeleteSslPolicyRequest extends \Google\Protobuf\Internal\Message /** * @param string $project Project ID for this request. - * @param string $sslPolicy Name of the SSL policy to delete. The name must be 1-63 characters long, and comply with RFC1035. + * @param string $sslPolicy Name of the SSL policy to delete. The name must be 1-63 characters long, + * and comply with RFC1035. * * @return \Google\Cloud\Compute\V1\DeleteSslPolicyRequest * @@ -58,9 +70,20 @@ public static function build(string $project, string $sslPolicy): self * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $ssl_policy - * Name of the SSL policy to delete. The name must be 1-63 characters long, and comply with RFC1035. + * Name of the SSL policy to delete. The name must be 1-63 characters long, + * and comply with RFC1035. * } */ public function __construct($data = NULL) { @@ -95,7 +118,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -116,7 +149,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var @@ -131,7 +174,8 @@ public function setRequestId($var) } /** - * Name of the SSL policy to delete. The name must be 1-63 characters long, and comply with RFC1035. + * Name of the SSL policy to delete. The name must be 1-63 characters long, + * and comply with RFC1035. * * Generated from protobuf field string ssl_policy = 295190213 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -142,7 +186,8 @@ public function getSslPolicy() } /** - * Name of the SSL policy to delete. The name must be 1-63 characters long, and comply with RFC1035. + * Name of the SSL policy to delete. The name must be 1-63 characters long, + * and comply with RFC1035. * * Generated from protobuf field string ssl_policy = 295190213 [(.google.api.field_behavior) = REQUIRED]; * @param string $var diff --git a/Compute/src/V1/DeleteStoragePoolRequest.php b/Compute/src/V1/DeleteStoragePoolRequest.php index 88e6be1f22c4..1f1e40d901af 100644 --- a/Compute/src/V1/DeleteStoragePoolRequest.php +++ b/Compute/src/V1/DeleteStoragePoolRequest.php @@ -22,7 +22,17 @@ class DeleteStoragePoolRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -66,7 +76,17 @@ public static function build(string $project, string $zone, string $storagePool) * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $storage_pool * Name of the storage pool to delete. * @type string $zone @@ -105,7 +125,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -126,7 +156,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/DeleteSubnetworkRequest.php b/Compute/src/V1/DeleteSubnetworkRequest.php index d11748215191..e5a75239e8ac 100644 --- a/Compute/src/V1/DeleteSubnetworkRequest.php +++ b/Compute/src/V1/DeleteSubnetworkRequest.php @@ -28,7 +28,17 @@ class DeleteSubnetworkRequest extends \Google\Protobuf\Internal\Message */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -68,7 +78,17 @@ public static function build(string $project, string $region, string $subnetwork * @type string $region * Name of the region scoping this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $subnetwork * Name of the Subnetwork resource to delete. * } @@ -131,7 +151,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -152,7 +182,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/DeleteTargetGrpcProxyRequest.php b/Compute/src/V1/DeleteTargetGrpcProxyRequest.php index ee031595bb0e..ad40715797cc 100644 --- a/Compute/src/V1/DeleteTargetGrpcProxyRequest.php +++ b/Compute/src/V1/DeleteTargetGrpcProxyRequest.php @@ -22,7 +22,17 @@ class DeleteTargetGrpcProxyRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -58,7 +68,17 @@ public static function build(string $project, string $targetGrpcProxy): self * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $target_grpc_proxy * Name of the TargetGrpcProxy resource to delete. * } @@ -95,7 +115,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -116,7 +146,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/DeleteTargetHttpProxyRequest.php b/Compute/src/V1/DeleteTargetHttpProxyRequest.php index 4c471adbb5be..e8a9e4a9e6b2 100644 --- a/Compute/src/V1/DeleteTargetHttpProxyRequest.php +++ b/Compute/src/V1/DeleteTargetHttpProxyRequest.php @@ -22,7 +22,17 @@ class DeleteTargetHttpProxyRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -58,7 +68,17 @@ public static function build(string $project, string $targetHttpProxy): self * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $target_http_proxy * Name of the TargetHttpProxy resource to delete. * } @@ -95,7 +115,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -116,7 +146,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/DeleteTargetHttpsProxyRequest.php b/Compute/src/V1/DeleteTargetHttpsProxyRequest.php index c7bb6d404f32..0ba4616a07dc 100644 --- a/Compute/src/V1/DeleteTargetHttpsProxyRequest.php +++ b/Compute/src/V1/DeleteTargetHttpsProxyRequest.php @@ -22,7 +22,17 @@ class DeleteTargetHttpsProxyRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -58,7 +68,17 @@ public static function build(string $project, string $targetHttpsProxy): self * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $target_https_proxy * Name of the TargetHttpsProxy resource to delete. * } @@ -95,7 +115,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -116,7 +146,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/DeleteTargetInstanceRequest.php b/Compute/src/V1/DeleteTargetInstanceRequest.php index 7f53264b7ca7..0c0049b3717b 100644 --- a/Compute/src/V1/DeleteTargetInstanceRequest.php +++ b/Compute/src/V1/DeleteTargetInstanceRequest.php @@ -22,7 +22,17 @@ class DeleteTargetInstanceRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -66,7 +76,17 @@ public static function build(string $project, string $zone, string $targetInstan * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $target_instance * Name of the TargetInstance resource to delete. * @type string $zone @@ -105,7 +125,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -126,7 +156,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/DeleteTargetPoolRequest.php b/Compute/src/V1/DeleteTargetPoolRequest.php index 846aa41f799e..d86b9314ed91 100644 --- a/Compute/src/V1/DeleteTargetPoolRequest.php +++ b/Compute/src/V1/DeleteTargetPoolRequest.php @@ -28,7 +28,17 @@ class DeleteTargetPoolRequest extends \Google\Protobuf\Internal\Message */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -68,7 +78,17 @@ public static function build(string $project, string $region, string $targetPool * @type string $region * Name of the region scoping this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $target_pool * Name of the TargetPool resource to delete. * } @@ -131,7 +151,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -152,7 +182,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/DeleteTargetSslProxyRequest.php b/Compute/src/V1/DeleteTargetSslProxyRequest.php index c78a98106373..1fa749328ecb 100644 --- a/Compute/src/V1/DeleteTargetSslProxyRequest.php +++ b/Compute/src/V1/DeleteTargetSslProxyRequest.php @@ -22,7 +22,17 @@ class DeleteTargetSslProxyRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -58,7 +68,17 @@ public static function build(string $project, string $targetSslProxy): self * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $target_ssl_proxy * Name of the TargetSslProxy resource to delete. * } @@ -95,7 +115,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -116,7 +146,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/DeleteTargetTcpProxyRequest.php b/Compute/src/V1/DeleteTargetTcpProxyRequest.php index 5c2e8195c735..9b63bc15bbb8 100644 --- a/Compute/src/V1/DeleteTargetTcpProxyRequest.php +++ b/Compute/src/V1/DeleteTargetTcpProxyRequest.php @@ -22,7 +22,17 @@ class DeleteTargetTcpProxyRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -58,7 +68,17 @@ public static function build(string $project, string $targetTcpProxy): self * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $target_tcp_proxy * Name of the TargetTcpProxy resource to delete. * } @@ -95,7 +115,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -116,7 +146,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/DeleteTargetVpnGatewayRequest.php b/Compute/src/V1/DeleteTargetVpnGatewayRequest.php index f5364a433bad..f9f8a7f71dc5 100644 --- a/Compute/src/V1/DeleteTargetVpnGatewayRequest.php +++ b/Compute/src/V1/DeleteTargetVpnGatewayRequest.php @@ -28,7 +28,17 @@ class DeleteTargetVpnGatewayRequest extends \Google\Protobuf\Internal\Message */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -68,7 +78,17 @@ public static function build(string $project, string $region, string $targetVpnG * @type string $region * Name of the region for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $target_vpn_gateway * Name of the target VPN gateway to delete. * } @@ -131,7 +151,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -152,7 +182,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/DeleteUrlMapRequest.php b/Compute/src/V1/DeleteUrlMapRequest.php index 7af276966097..2905e3707076 100644 --- a/Compute/src/V1/DeleteUrlMapRequest.php +++ b/Compute/src/V1/DeleteUrlMapRequest.php @@ -22,7 +22,17 @@ class DeleteUrlMapRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -58,7 +68,17 @@ public static function build(string $project, string $urlMap): self * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $url_map * Name of the UrlMap resource to delete. * } @@ -95,7 +115,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -116,7 +146,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/DeleteVpnGatewayRequest.php b/Compute/src/V1/DeleteVpnGatewayRequest.php index ae66d648f27a..91f8ec344c95 100644 --- a/Compute/src/V1/DeleteVpnGatewayRequest.php +++ b/Compute/src/V1/DeleteVpnGatewayRequest.php @@ -28,7 +28,17 @@ class DeleteVpnGatewayRequest extends \Google\Protobuf\Internal\Message */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -68,7 +78,17 @@ public static function build(string $project, string $region, string $vpnGateway * @type string $region * Name of the region for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $vpn_gateway * Name of the VPN gateway to delete. * } @@ -131,7 +151,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -152,7 +182,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/DeleteVpnTunnelRequest.php b/Compute/src/V1/DeleteVpnTunnelRequest.php index 9912f05ffd4f..94e0f13f98e9 100644 --- a/Compute/src/V1/DeleteVpnTunnelRequest.php +++ b/Compute/src/V1/DeleteVpnTunnelRequest.php @@ -28,7 +28,17 @@ class DeleteVpnTunnelRequest extends \Google\Protobuf\Internal\Message */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -68,7 +78,17 @@ public static function build(string $project, string $region, string $vpnTunnel) * @type string $region * Name of the region for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $vpn_tunnel * Name of the VpnTunnel resource to delete. * } @@ -131,7 +151,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -152,7 +182,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/DeleteWireGroupRequest.php b/Compute/src/V1/DeleteWireGroupRequest.php new file mode 100644 index 000000000000..83e944b37bba --- /dev/null +++ b/Compute/src/V1/DeleteWireGroupRequest.php @@ -0,0 +1,233 @@ +google.cloud.compute.v1.DeleteWireGroupRequest + */ +class DeleteWireGroupRequest extends \Google\Protobuf\Internal\Message +{ + /** + * Generated from protobuf field string cross_site_network = 108192469 [(.google.api.field_behavior) = REQUIRED]; + */ + protected $cross_site_network = ''; + /** + * Project ID for this request. + * + * Generated from protobuf field string project = 227560217 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "project"]; + */ + protected $project = ''; + /** + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). + * end_interface: MixerMutationRequestBuilder + * + * Generated from protobuf field optional string request_id = 37109963; + */ + protected $request_id = null; + /** + * Name of the wire group resource to delete. + * + * Generated from protobuf field string wire_group = 122540613 [(.google.api.field_behavior) = REQUIRED]; + */ + protected $wire_group = ''; + + /** + * @param string $project Project ID for this request. + * @param string $crossSiteNetwork + * @param string $wireGroup Name of the wire group resource to delete. + * + * @return \Google\Cloud\Compute\V1\DeleteWireGroupRequest + * + * @experimental + */ + public static function build(string $project, string $crossSiteNetwork, string $wireGroup): self + { + return (new self()) + ->setProject($project) + ->setCrossSiteNetwork($crossSiteNetwork) + ->setWireGroup($wireGroup); + } + + /** + * Constructor. + * + * @param array $data { + * Optional. Data for populating the Message object. + * + * @type string $cross_site_network + * @type string $project + * Project ID for this request. + * @type string $request_id + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). + * end_interface: MixerMutationRequestBuilder + * @type string $wire_group + * Name of the wire group resource to delete. + * } + */ + public function __construct($data = NULL) { + \GPBMetadata\Google\Cloud\Compute\V1\Compute::initOnce(); + parent::__construct($data); + } + + /** + * Generated from protobuf field string cross_site_network = 108192469 [(.google.api.field_behavior) = REQUIRED]; + * @return string + */ + public function getCrossSiteNetwork() + { + return $this->cross_site_network; + } + + /** + * Generated from protobuf field string cross_site_network = 108192469 [(.google.api.field_behavior) = REQUIRED]; + * @param string $var + * @return $this + */ + public function setCrossSiteNetwork($var) + { + GPBUtil::checkString($var, True); + $this->cross_site_network = $var; + + return $this; + } + + /** + * Project ID for this request. + * + * Generated from protobuf field string project = 227560217 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "project"]; + * @return string + */ + public function getProject() + { + return $this->project; + } + + /** + * Project ID for this request. + * + * Generated from protobuf field string project = 227560217 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "project"]; + * @param string $var + * @return $this + */ + public function setProject($var) + { + GPBUtil::checkString($var, True); + $this->project = $var; + + return $this; + } + + /** + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). + * end_interface: MixerMutationRequestBuilder + * + * Generated from protobuf field optional string request_id = 37109963; + * @return string + */ + public function getRequestId() + { + return isset($this->request_id) ? $this->request_id : ''; + } + + public function hasRequestId() + { + return isset($this->request_id); + } + + public function clearRequestId() + { + unset($this->request_id); + } + + /** + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). + * end_interface: MixerMutationRequestBuilder + * + * Generated from protobuf field optional string request_id = 37109963; + * @param string $var + * @return $this + */ + public function setRequestId($var) + { + GPBUtil::checkString($var, True); + $this->request_id = $var; + + return $this; + } + + /** + * Name of the wire group resource to delete. + * + * Generated from protobuf field string wire_group = 122540613 [(.google.api.field_behavior) = REQUIRED]; + * @return string + */ + public function getWireGroup() + { + return $this->wire_group; + } + + /** + * Name of the wire group resource to delete. + * + * Generated from protobuf field string wire_group = 122540613 [(.google.api.field_behavior) = REQUIRED]; + * @param string $var + * @return $this + */ + public function setWireGroup($var) + { + GPBUtil::checkString($var, True); + $this->wire_group = $var; + + return $this; + } + +} + diff --git a/Compute/src/V1/DeleteZoneOperationRequest.php b/Compute/src/V1/DeleteZoneOperationRequest.php index 648e8e45b66b..8583b699fe89 100644 --- a/Compute/src/V1/DeleteZoneOperationRequest.php +++ b/Compute/src/V1/DeleteZoneOperationRequest.php @@ -16,7 +16,8 @@ class DeleteZoneOperationRequest extends \Google\Protobuf\Internal\Message { /** - * Name of the Operations resource to delete, or its unique numeric identifier. + * Name of the Operations resource to delete, or its unique numeric + * identifier. * * Generated from protobuf field string operation = 52090215 [(.google.api.field_behavior) = REQUIRED]; */ @@ -37,7 +38,8 @@ class DeleteZoneOperationRequest extends \Google\Protobuf\Internal\Message /** * @param string $project Project ID for this request. * @param string $zone Name of the zone for this request. - * @param string $operation Name of the Operations resource to delete, or its unique numeric identifier. + * @param string $operation Name of the Operations resource to delete, or its unique numeric + * identifier. * * @return \Google\Cloud\Compute\V1\DeleteZoneOperationRequest * @@ -58,7 +60,8 @@ public static function build(string $project, string $zone, string $operation): * Optional. Data for populating the Message object. * * @type string $operation - * Name of the Operations resource to delete, or its unique numeric identifier. + * Name of the Operations resource to delete, or its unique numeric + * identifier. * @type string $project * Project ID for this request. * @type string $zone @@ -71,7 +74,8 @@ public function __construct($data = NULL) { } /** - * Name of the Operations resource to delete, or its unique numeric identifier. + * Name of the Operations resource to delete, or its unique numeric + * identifier. * * Generated from protobuf field string operation = 52090215 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -82,7 +86,8 @@ public function getOperation() } /** - * Name of the Operations resource to delete, or its unique numeric identifier. + * Name of the Operations resource to delete, or its unique numeric + * identifier. * * Generated from protobuf field string operation = 52090215 [(.google.api.field_behavior) = REQUIRED]; * @param string $var diff --git a/Compute/src/V1/Denied.php b/Compute/src/V1/Denied.php index a34c497c0238..232f33da4347 100644 --- a/Compute/src/V1/Denied.php +++ b/Compute/src/V1/Denied.php @@ -15,13 +15,20 @@ class Denied extends \Google\Protobuf\Internal\Message { /** - * The IP protocol to which this rule applies. The protocol type is required when creating a firewall rule. This value can either be one of the following well known protocol strings (tcp, udp, icmp, esp, ah, ipip, sctp) or the IP protocol number. + * The IP protocol to which this rule applies. The protocol type is + * required when creating a firewall rule. This value can either be one of the + * following well known protocol strings (tcp, udp,icmp, esp, ah, ipip,sctp) or the IP protocol number. * * Generated from protobuf field optional string I_p_protocol = 488094525; */ protected $I_p_protocol = null; /** - * An optional list of ports to which this rule applies. This field is only applicable for the UDP or TCP protocol. Each entry must be either an integer or a range. If not specified, this rule applies to connections through any port. Example inputs include: ["22"], ["80","443"], and ["12345-12349"]. + * An optional list of ports to which this rule applies. + * This field is only applicable for the UDP or TCP protocol. + * Each entry must be either an integer or a range. + * If not specified, this rule applies to connections through any port. + * Example inputs include: ["22"], ["80","443"], + * and ["12345-12349"]. * * Generated from protobuf field repeated string ports = 106854418; */ @@ -34,9 +41,16 @@ class Denied extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $I_p_protocol - * The IP protocol to which this rule applies. The protocol type is required when creating a firewall rule. This value can either be one of the following well known protocol strings (tcp, udp, icmp, esp, ah, ipip, sctp) or the IP protocol number. + * The IP protocol to which this rule applies. The protocol type is + * required when creating a firewall rule. This value can either be one of the + * following well known protocol strings (tcp, udp,icmp, esp, ah, ipip,sctp) or the IP protocol number. * @type array|\Google\Protobuf\Internal\RepeatedField $ports - * An optional list of ports to which this rule applies. This field is only applicable for the UDP or TCP protocol. Each entry must be either an integer or a range. If not specified, this rule applies to connections through any port. Example inputs include: ["22"], ["80","443"], and ["12345-12349"]. + * An optional list of ports to which this rule applies. + * This field is only applicable for the UDP or TCP protocol. + * Each entry must be either an integer or a range. + * If not specified, this rule applies to connections through any port. + * Example inputs include: ["22"], ["80","443"], + * and ["12345-12349"]. * } */ public function __construct($data = NULL) { @@ -45,7 +59,9 @@ public function __construct($data = NULL) { } /** - * The IP protocol to which this rule applies. The protocol type is required when creating a firewall rule. This value can either be one of the following well known protocol strings (tcp, udp, icmp, esp, ah, ipip, sctp) or the IP protocol number. + * The IP protocol to which this rule applies. The protocol type is + * required when creating a firewall rule. This value can either be one of the + * following well known protocol strings (tcp, udp,icmp, esp, ah, ipip,sctp) or the IP protocol number. * * Generated from protobuf field optional string I_p_protocol = 488094525; * @return string @@ -66,7 +82,9 @@ public function clearIPProtocol() } /** - * The IP protocol to which this rule applies. The protocol type is required when creating a firewall rule. This value can either be one of the following well known protocol strings (tcp, udp, icmp, esp, ah, ipip, sctp) or the IP protocol number. + * The IP protocol to which this rule applies. The protocol type is + * required when creating a firewall rule. This value can either be one of the + * following well known protocol strings (tcp, udp,icmp, esp, ah, ipip,sctp) or the IP protocol number. * * Generated from protobuf field optional string I_p_protocol = 488094525; * @param string $var @@ -81,7 +99,12 @@ public function setIPProtocol($var) } /** - * An optional list of ports to which this rule applies. This field is only applicable for the UDP or TCP protocol. Each entry must be either an integer or a range. If not specified, this rule applies to connections through any port. Example inputs include: ["22"], ["80","443"], and ["12345-12349"]. + * An optional list of ports to which this rule applies. + * This field is only applicable for the UDP or TCP protocol. + * Each entry must be either an integer or a range. + * If not specified, this rule applies to connections through any port. + * Example inputs include: ["22"], ["80","443"], + * and ["12345-12349"]. * * Generated from protobuf field repeated string ports = 106854418; * @return \Google\Protobuf\Internal\RepeatedField @@ -92,7 +115,12 @@ public function getPorts() } /** - * An optional list of ports to which this rule applies. This field is only applicable for the UDP or TCP protocol. Each entry must be either an integer or a range. If not specified, this rule applies to connections through any port. Example inputs include: ["22"], ["80","443"], and ["12345-12349"]. + * An optional list of ports to which this rule applies. + * This field is only applicable for the UDP or TCP protocol. + * Each entry must be either an integer or a range. + * If not specified, this rule applies to connections through any port. + * Example inputs include: ["22"], ["80","443"], + * and ["12345-12349"]. * * Generated from protobuf field repeated string ports = 106854418; * @param array|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/DeprecateImageRequest.php b/Compute/src/V1/DeprecateImageRequest.php index 5e1fea3b3ce8..8d07fb2243e9 100644 --- a/Compute/src/V1/DeprecateImageRequest.php +++ b/Compute/src/V1/DeprecateImageRequest.php @@ -34,7 +34,17 @@ class DeprecateImageRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -70,7 +80,17 @@ public static function build(string $project, string $image, \Google\Cloud\Compu * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -167,7 +187,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -188,7 +218,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/DeprecationStatus.php b/Compute/src/V1/DeprecationStatus.php index 72a0b9bc2324..e53635706d63 100644 --- a/Compute/src/V1/DeprecationStatus.php +++ b/Compute/src/V1/DeprecationStatus.php @@ -16,31 +16,45 @@ class DeprecationStatus extends \Google\Protobuf\Internal\Message { /** - * An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DELETED. This is only informational and the status will not change unless the client explicitly changes it. + * An optional RFC3339 timestamp on or after which the state of this + * resource is intended to change to DELETED. This is only + * informational and the status will not change unless the client explicitly + * changes it. * * Generated from protobuf field optional string deleted = 476721177; */ protected $deleted = null; /** - * An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DEPRECATED. This is only informational and the status will not change unless the client explicitly changes it. + * An optional RFC3339 timestamp on or after which the state of this + * resource is intended to change to DEPRECATED. This is only + * informational and the status will not change unless the client explicitly + * changes it. * * Generated from protobuf field optional string deprecated = 515138995; */ protected $deprecated = null; /** - * An optional RFC3339 timestamp on or after which the state of this resource is intended to change to OBSOLETE. This is only informational and the status will not change unless the client explicitly changes it. + * An optional RFC3339 timestamp on or after which the state of this + * resource is intended to change to OBSOLETE. This is only + * informational and the status will not change unless the client explicitly + * changes it. * * Generated from protobuf field optional string obsolete = 357647769; */ protected $obsolete = null; /** - * The URL of the suggested replacement for a deprecated resource. The suggested replacement resource must be the same kind of resource as the deprecated resource. + * The URL of the suggested replacement for a deprecated resource. + * The suggested replacement resource must be the same kind of resource as the + * deprecated resource. * * Generated from protobuf field optional string replacement = 430919186; */ protected $replacement = null; /** - * The deprecation state of this resource. This can be ACTIVE, DEPRECATED, OBSOLETE, or DELETED. Operations which communicate the end of life date for an image, can use ACTIVE. Operations which create a new resource using a DEPRECATED resource will return successfully, but with a warning indicating the deprecated resource and recommending its replacement. Operations which use OBSOLETE or DELETED resources will be rejected and result in an error. + * The deprecation state of this resource. This can be ACTIVE,DEPRECATED, OBSOLETE, or DELETED. + * Operations which communicate the end of life date for an image, can useACTIVE. Operations which create a new resource using aDEPRECATED resource will return successfully, but with a + * warning indicating the deprecated resource and recommending its + * replacement. Operations which use OBSOLETE orDELETED resources will be rejected and result in an error. * Check the State enum for the list of possible values. * * Generated from protobuf field optional string state = 109757585; @@ -54,15 +68,29 @@ class DeprecationStatus extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $deleted - * An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DELETED. This is only informational and the status will not change unless the client explicitly changes it. + * An optional RFC3339 timestamp on or after which the state of this + * resource is intended to change to DELETED. This is only + * informational and the status will not change unless the client explicitly + * changes it. * @type string $deprecated - * An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DEPRECATED. This is only informational and the status will not change unless the client explicitly changes it. + * An optional RFC3339 timestamp on or after which the state of this + * resource is intended to change to DEPRECATED. This is only + * informational and the status will not change unless the client explicitly + * changes it. * @type string $obsolete - * An optional RFC3339 timestamp on or after which the state of this resource is intended to change to OBSOLETE. This is only informational and the status will not change unless the client explicitly changes it. + * An optional RFC3339 timestamp on or after which the state of this + * resource is intended to change to OBSOLETE. This is only + * informational and the status will not change unless the client explicitly + * changes it. * @type string $replacement - * The URL of the suggested replacement for a deprecated resource. The suggested replacement resource must be the same kind of resource as the deprecated resource. + * The URL of the suggested replacement for a deprecated resource. + * The suggested replacement resource must be the same kind of resource as the + * deprecated resource. * @type string $state - * The deprecation state of this resource. This can be ACTIVE, DEPRECATED, OBSOLETE, or DELETED. Operations which communicate the end of life date for an image, can use ACTIVE. Operations which create a new resource using a DEPRECATED resource will return successfully, but with a warning indicating the deprecated resource and recommending its replacement. Operations which use OBSOLETE or DELETED resources will be rejected and result in an error. + * The deprecation state of this resource. This can be ACTIVE,DEPRECATED, OBSOLETE, or DELETED. + * Operations which communicate the end of life date for an image, can useACTIVE. Operations which create a new resource using aDEPRECATED resource will return successfully, but with a + * warning indicating the deprecated resource and recommending its + * replacement. Operations which use OBSOLETE orDELETED resources will be rejected and result in an error. * Check the State enum for the list of possible values. * } */ @@ -72,7 +100,10 @@ public function __construct($data = NULL) { } /** - * An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DELETED. This is only informational and the status will not change unless the client explicitly changes it. + * An optional RFC3339 timestamp on or after which the state of this + * resource is intended to change to DELETED. This is only + * informational and the status will not change unless the client explicitly + * changes it. * * Generated from protobuf field optional string deleted = 476721177; * @return string @@ -93,7 +124,10 @@ public function clearDeleted() } /** - * An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DELETED. This is only informational and the status will not change unless the client explicitly changes it. + * An optional RFC3339 timestamp on or after which the state of this + * resource is intended to change to DELETED. This is only + * informational and the status will not change unless the client explicitly + * changes it. * * Generated from protobuf field optional string deleted = 476721177; * @param string $var @@ -108,7 +142,10 @@ public function setDeleted($var) } /** - * An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DEPRECATED. This is only informational and the status will not change unless the client explicitly changes it. + * An optional RFC3339 timestamp on or after which the state of this + * resource is intended to change to DEPRECATED. This is only + * informational and the status will not change unless the client explicitly + * changes it. * * Generated from protobuf field optional string deprecated = 515138995; * @return string @@ -129,7 +166,10 @@ public function clearDeprecated() } /** - * An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DEPRECATED. This is only informational and the status will not change unless the client explicitly changes it. + * An optional RFC3339 timestamp on or after which the state of this + * resource is intended to change to DEPRECATED. This is only + * informational and the status will not change unless the client explicitly + * changes it. * * Generated from protobuf field optional string deprecated = 515138995; * @param string $var @@ -144,7 +184,10 @@ public function setDeprecated($var) } /** - * An optional RFC3339 timestamp on or after which the state of this resource is intended to change to OBSOLETE. This is only informational and the status will not change unless the client explicitly changes it. + * An optional RFC3339 timestamp on or after which the state of this + * resource is intended to change to OBSOLETE. This is only + * informational and the status will not change unless the client explicitly + * changes it. * * Generated from protobuf field optional string obsolete = 357647769; * @return string @@ -165,7 +208,10 @@ public function clearObsolete() } /** - * An optional RFC3339 timestamp on or after which the state of this resource is intended to change to OBSOLETE. This is only informational and the status will not change unless the client explicitly changes it. + * An optional RFC3339 timestamp on or after which the state of this + * resource is intended to change to OBSOLETE. This is only + * informational and the status will not change unless the client explicitly + * changes it. * * Generated from protobuf field optional string obsolete = 357647769; * @param string $var @@ -180,7 +226,9 @@ public function setObsolete($var) } /** - * The URL of the suggested replacement for a deprecated resource. The suggested replacement resource must be the same kind of resource as the deprecated resource. + * The URL of the suggested replacement for a deprecated resource. + * The suggested replacement resource must be the same kind of resource as the + * deprecated resource. * * Generated from protobuf field optional string replacement = 430919186; * @return string @@ -201,7 +249,9 @@ public function clearReplacement() } /** - * The URL of the suggested replacement for a deprecated resource. The suggested replacement resource must be the same kind of resource as the deprecated resource. + * The URL of the suggested replacement for a deprecated resource. + * The suggested replacement resource must be the same kind of resource as the + * deprecated resource. * * Generated from protobuf field optional string replacement = 430919186; * @param string $var @@ -216,7 +266,10 @@ public function setReplacement($var) } /** - * The deprecation state of this resource. This can be ACTIVE, DEPRECATED, OBSOLETE, or DELETED. Operations which communicate the end of life date for an image, can use ACTIVE. Operations which create a new resource using a DEPRECATED resource will return successfully, but with a warning indicating the deprecated resource and recommending its replacement. Operations which use OBSOLETE or DELETED resources will be rejected and result in an error. + * The deprecation state of this resource. This can be ACTIVE,DEPRECATED, OBSOLETE, or DELETED. + * Operations which communicate the end of life date for an image, can useACTIVE. Operations which create a new resource using aDEPRECATED resource will return successfully, but with a + * warning indicating the deprecated resource and recommending its + * replacement. Operations which use OBSOLETE orDELETED resources will be rejected and result in an error. * Check the State enum for the list of possible values. * * Generated from protobuf field optional string state = 109757585; @@ -238,7 +291,10 @@ public function clearState() } /** - * The deprecation state of this resource. This can be ACTIVE, DEPRECATED, OBSOLETE, or DELETED. Operations which communicate the end of life date for an image, can use ACTIVE. Operations which create a new resource using a DEPRECATED resource will return successfully, but with a warning indicating the deprecated resource and recommending its replacement. Operations which use OBSOLETE or DELETED resources will be rejected and result in an error. + * The deprecation state of this resource. This can be ACTIVE,DEPRECATED, OBSOLETE, or DELETED. + * Operations which communicate the end of life date for an image, can useACTIVE. Operations which create a new resource using aDEPRECATED resource will return successfully, but with a + * warning indicating the deprecated resource and recommending its + * replacement. Operations which use OBSOLETE orDELETED resources will be rejected and result in an error. * Check the State enum for the list of possible values. * * Generated from protobuf field optional string state = 109757585; diff --git a/Compute/src/V1/DeprecationStatus/State.php b/Compute/src/V1/DeprecationStatus/State.php index e3b3ac26c675..e4f31807866d 100644 --- a/Compute/src/V1/DeprecationStatus/State.php +++ b/Compute/src/V1/DeprecationStatus/State.php @@ -7,7 +7,10 @@ use UnexpectedValueException; /** - * The deprecation state of this resource. This can be ACTIVE, DEPRECATED, OBSOLETE, or DELETED. Operations which communicate the end of life date for an image, can use ACTIVE. Operations which create a new resource using a DEPRECATED resource will return successfully, but with a warning indicating the deprecated resource and recommending its replacement. Operations which use OBSOLETE or DELETED resources will be rejected and result in an error. + * The deprecation state of this resource. This can be ACTIVE,DEPRECATED, OBSOLETE, or DELETED. + * Operations which communicate the end of life date for an image, can useACTIVE. Operations which create a new resource using aDEPRECATED resource will return successfully, but with a + * warning indicating the deprecated resource and recommending its + * replacement. Operations which use OBSOLETE orDELETED resources will be rejected and result in an error. * * Protobuf type google.cloud.compute.v1.DeprecationStatus.State */ diff --git a/Compute/src/V1/DetachDiskInstanceRequest.php b/Compute/src/V1/DetachDiskInstanceRequest.php index cdaeaf8cf24b..05e3a383b310 100644 --- a/Compute/src/V1/DetachDiskInstanceRequest.php +++ b/Compute/src/V1/DetachDiskInstanceRequest.php @@ -16,7 +16,8 @@ class DetachDiskInstanceRequest extends \Google\Protobuf\Internal\Message { /** - * The device name of the disk to detach. Make a get() request on the instance to view currently attached disks and device names. + * The device name of the disk to detach. Make a get() request on + * the instance to view currently attached disks and device names. * * Generated from protobuf field string device_name = 67541716 [(.google.api.field_behavior) = REQUIRED]; */ @@ -34,7 +35,17 @@ class DetachDiskInstanceRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -50,7 +61,8 @@ class DetachDiskInstanceRequest extends \Google\Protobuf\Internal\Message * @param string $project Project ID for this request. * @param string $zone The name of the zone for this request. * @param string $instance Instance name for this request. - * @param string $deviceName The device name of the disk to detach. Make a get() request on the instance to view currently attached disks and device names. + * @param string $deviceName The device name of the disk to detach. Make a get() request on + * the instance to view currently attached disks and device names. * * @return \Google\Cloud\Compute\V1\DetachDiskInstanceRequest * @@ -72,13 +84,24 @@ public static function build(string $project, string $zone, string $instance, st * Optional. Data for populating the Message object. * * @type string $device_name - * The device name of the disk to detach. Make a get() request on the instance to view currently attached disks and device names. + * The device name of the disk to detach. Make a get() request on + * the instance to view currently attached disks and device names. * @type string $instance * Instance name for this request. * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $zone * The name of the zone for this request. * } @@ -89,7 +112,8 @@ public function __construct($data = NULL) { } /** - * The device name of the disk to detach. Make a get() request on the instance to view currently attached disks and device names. + * The device name of the disk to detach. Make a get() request on + * the instance to view currently attached disks and device names. * * Generated from protobuf field string device_name = 67541716 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -100,7 +124,8 @@ public function getDeviceName() } /** - * The device name of the disk to detach. Make a get() request on the instance to view currently attached disks and device names. + * The device name of the disk to detach. Make a get() request on + * the instance to view currently attached disks and device names. * * Generated from protobuf field string device_name = 67541716 [(.google.api.field_behavior) = REQUIRED]; * @param string $var @@ -167,7 +192,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -188,7 +223,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/DetachNetworkEndpointsGlobalNetworkEndpointGroupRequest.php b/Compute/src/V1/DetachNetworkEndpointsGlobalNetworkEndpointGroupRequest.php index 9a7434a18c47..1cea6ce426d1 100644 --- a/Compute/src/V1/DetachNetworkEndpointsGlobalNetworkEndpointGroupRequest.php +++ b/Compute/src/V1/DetachNetworkEndpointsGlobalNetworkEndpointGroupRequest.php @@ -22,7 +22,8 @@ class DetachNetworkEndpointsGlobalNetworkEndpointGroupRequest extends \Google\Pr */ protected $global_network_endpoint_groups_detach_endpoints_request_resource = null; /** - * The name of the network endpoint group where you are removing network endpoints. It should comply with RFC1035. + * The name of the network endpoint group where you are removing network + * endpoints. It should comply with RFC1035. * * Generated from protobuf field string network_endpoint_group = 433907078 [(.google.api.field_behavior) = REQUIRED]; */ @@ -34,7 +35,17 @@ class DetachNetworkEndpointsGlobalNetworkEndpointGroupRequest extends \Google\Pr */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -42,7 +53,8 @@ class DetachNetworkEndpointsGlobalNetworkEndpointGroupRequest extends \Google\Pr /** * @param string $project Project ID for this request. - * @param string $networkEndpointGroup The name of the network endpoint group where you are removing network endpoints. It should comply with RFC1035. + * @param string $networkEndpointGroup The name of the network endpoint group where you are removing network + * endpoints. It should comply with RFC1035. * @param \Google\Cloud\Compute\V1\GlobalNetworkEndpointGroupsDetachEndpointsRequest $globalNetworkEndpointGroupsDetachEndpointsRequestResource The body resource for this request * * @return \Google\Cloud\Compute\V1\DetachNetworkEndpointsGlobalNetworkEndpointGroupRequest @@ -66,11 +78,22 @@ public static function build(string $project, string $networkEndpointGroup, \Goo * @type \Google\Cloud\Compute\V1\GlobalNetworkEndpointGroupsDetachEndpointsRequest $global_network_endpoint_groups_detach_endpoints_request_resource * The body resource for this request * @type string $network_endpoint_group - * The name of the network endpoint group where you are removing network endpoints. It should comply with RFC1035. + * The name of the network endpoint group where you are removing network + * endpoints. It should comply with RFC1035. * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -115,7 +138,8 @@ public function setGlobalNetworkEndpointGroupsDetachEndpointsRequestResource($va } /** - * The name of the network endpoint group where you are removing network endpoints. It should comply with RFC1035. + * The name of the network endpoint group where you are removing network + * endpoints. It should comply with RFC1035. * * Generated from protobuf field string network_endpoint_group = 433907078 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -126,7 +150,8 @@ public function getNetworkEndpointGroup() } /** - * The name of the network endpoint group where you are removing network endpoints. It should comply with RFC1035. + * The name of the network endpoint group where you are removing network + * endpoints. It should comply with RFC1035. * * Generated from protobuf field string network_endpoint_group = 433907078 [(.google.api.field_behavior) = REQUIRED]; * @param string $var @@ -167,7 +192,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -188,7 +223,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/DetachNetworkEndpointsNetworkEndpointGroupRequest.php b/Compute/src/V1/DetachNetworkEndpointsNetworkEndpointGroupRequest.php index f0575729ea85..8fed3e4a60ea 100644 --- a/Compute/src/V1/DetachNetworkEndpointsNetworkEndpointGroupRequest.php +++ b/Compute/src/V1/DetachNetworkEndpointsNetworkEndpointGroupRequest.php @@ -16,7 +16,8 @@ class DetachNetworkEndpointsNetworkEndpointGroupRequest extends \Google\Protobuf\Internal\Message { /** - * The name of the network endpoint group where you are removing network endpoints. It should comply with RFC1035. + * The name of the network endpoint group where you are removing network + * endpoints. It should comply with RFC1035. * * Generated from protobuf field string network_endpoint_group = 433907078 [(.google.api.field_behavior) = REQUIRED]; */ @@ -34,13 +35,24 @@ class DetachNetworkEndpointsNetworkEndpointGroupRequest extends \Google\Protobuf */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ protected $request_id = null; /** - * The name of the zone where the network endpoint group is located. It should comply with RFC1035. + * The name of the zone where + * the network endpoint group is located. It should comply with RFC1035. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; */ @@ -48,8 +60,10 @@ class DetachNetworkEndpointsNetworkEndpointGroupRequest extends \Google\Protobuf /** * @param string $project Project ID for this request. - * @param string $zone The name of the zone where the network endpoint group is located. It should comply with RFC1035. - * @param string $networkEndpointGroup The name of the network endpoint group where you are removing network endpoints. It should comply with RFC1035. + * @param string $zone The name of the zone where + * the network endpoint group is located. It should comply with RFC1035. + * @param string $networkEndpointGroup The name of the network endpoint group where you are removing network + * endpoints. It should comply with RFC1035. * @param \Google\Cloud\Compute\V1\NetworkEndpointGroupsDetachEndpointsRequest $networkEndpointGroupsDetachEndpointsRequestResource The body resource for this request * * @return \Google\Cloud\Compute\V1\DetachNetworkEndpointsNetworkEndpointGroupRequest @@ -72,15 +86,27 @@ public static function build(string $project, string $zone, string $networkEndpo * Optional. Data for populating the Message object. * * @type string $network_endpoint_group - * The name of the network endpoint group where you are removing network endpoints. It should comply with RFC1035. + * The name of the network endpoint group where you are removing network + * endpoints. It should comply with RFC1035. * @type \Google\Cloud\Compute\V1\NetworkEndpointGroupsDetachEndpointsRequest $network_endpoint_groups_detach_endpoints_request_resource * The body resource for this request * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $zone - * The name of the zone where the network endpoint group is located. It should comply with RFC1035. + * The name of the zone where + * the network endpoint group is located. It should comply with RFC1035. * } */ public function __construct($data = NULL) { @@ -89,7 +115,8 @@ public function __construct($data = NULL) { } /** - * The name of the network endpoint group where you are removing network endpoints. It should comply with RFC1035. + * The name of the network endpoint group where you are removing network + * endpoints. It should comply with RFC1035. * * Generated from protobuf field string network_endpoint_group = 433907078 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -100,7 +127,8 @@ public function getNetworkEndpointGroup() } /** - * The name of the network endpoint group where you are removing network endpoints. It should comply with RFC1035. + * The name of the network endpoint group where you are removing network + * endpoints. It should comply with RFC1035. * * Generated from protobuf field string network_endpoint_group = 433907078 [(.google.api.field_behavior) = REQUIRED]; * @param string $var @@ -177,7 +205,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -198,7 +236,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var @@ -213,7 +261,8 @@ public function setRequestId($var) } /** - * The name of the zone where the network endpoint group is located. It should comply with RFC1035. + * The name of the zone where + * the network endpoint group is located. It should comply with RFC1035. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; * @return string @@ -224,7 +273,8 @@ public function getZone() } /** - * The name of the zone where the network endpoint group is located. It should comply with RFC1035. + * The name of the zone where + * the network endpoint group is located. It should comply with RFC1035. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; * @param string $var diff --git a/Compute/src/V1/DetachNetworkEndpointsRegionNetworkEndpointGroupRequest.php b/Compute/src/V1/DetachNetworkEndpointsRegionNetworkEndpointGroupRequest.php index ac33a492c615..761cdd7e31b1 100644 --- a/Compute/src/V1/DetachNetworkEndpointsRegionNetworkEndpointGroupRequest.php +++ b/Compute/src/V1/DetachNetworkEndpointsRegionNetworkEndpointGroupRequest.php @@ -16,7 +16,8 @@ class DetachNetworkEndpointsRegionNetworkEndpointGroupRequest extends \Google\Protobuf\Internal\Message { /** - * The name of the network endpoint group you are detaching network endpoints from. It should comply with RFC1035. + * The name of the network endpoint group you are detaching network + * endpoints from. It should comply with RFC1035. * * Generated from protobuf field string network_endpoint_group = 433907078 [(.google.api.field_behavior) = REQUIRED]; */ @@ -28,7 +29,9 @@ class DetachNetworkEndpointsRegionNetworkEndpointGroupRequest extends \Google\Pr */ protected $project = ''; /** - * The name of the region where the network endpoint group is located. It should comply with RFC1035. + * The name of the region where + * the network endpoint group is located. It should comply with + * RFC1035. * * Generated from protobuf field string region = 138946292 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "region"]; */ @@ -40,7 +43,18 @@ class DetachNetworkEndpointsRegionNetworkEndpointGroupRequest extends \Google\Pr */ protected $region_network_endpoint_groups_detach_endpoints_request_resource = null; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). end_interface: MixerMutationRequestBuilder + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). + * end_interface: MixerMutationRequestBuilder * * Generated from protobuf field optional string request_id = 37109963; */ @@ -48,8 +62,11 @@ class DetachNetworkEndpointsRegionNetworkEndpointGroupRequest extends \Google\Pr /** * @param string $project Project ID for this request. - * @param string $region The name of the region where the network endpoint group is located. It should comply with RFC1035. - * @param string $networkEndpointGroup The name of the network endpoint group you are detaching network endpoints from. It should comply with RFC1035. + * @param string $region The name of the region where + * the network endpoint group is located. It should comply with + * RFC1035. + * @param string $networkEndpointGroup The name of the network endpoint group you are detaching network + * endpoints from. It should comply with RFC1035. * @param \Google\Cloud\Compute\V1\RegionNetworkEndpointGroupsDetachEndpointsRequest $regionNetworkEndpointGroupsDetachEndpointsRequestResource The body resource for this request * * @return \Google\Cloud\Compute\V1\DetachNetworkEndpointsRegionNetworkEndpointGroupRequest @@ -72,15 +89,29 @@ public static function build(string $project, string $region, string $networkEnd * Optional. Data for populating the Message object. * * @type string $network_endpoint_group - * The name of the network endpoint group you are detaching network endpoints from. It should comply with RFC1035. + * The name of the network endpoint group you are detaching network + * endpoints from. It should comply with RFC1035. * @type string $project * Project ID for this request. * @type string $region - * The name of the region where the network endpoint group is located. It should comply with RFC1035. + * The name of the region where + * the network endpoint group is located. It should comply with + * RFC1035. * @type \Google\Cloud\Compute\V1\RegionNetworkEndpointGroupsDetachEndpointsRequest $region_network_endpoint_groups_detach_endpoints_request_resource * The body resource for this request * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). end_interface: MixerMutationRequestBuilder + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). + * end_interface: MixerMutationRequestBuilder * } */ public function __construct($data = NULL) { @@ -89,7 +120,8 @@ public function __construct($data = NULL) { } /** - * The name of the network endpoint group you are detaching network endpoints from. It should comply with RFC1035. + * The name of the network endpoint group you are detaching network + * endpoints from. It should comply with RFC1035. * * Generated from protobuf field string network_endpoint_group = 433907078 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -100,7 +132,8 @@ public function getNetworkEndpointGroup() } /** - * The name of the network endpoint group you are detaching network endpoints from. It should comply with RFC1035. + * The name of the network endpoint group you are detaching network + * endpoints from. It should comply with RFC1035. * * Generated from protobuf field string network_endpoint_group = 433907078 [(.google.api.field_behavior) = REQUIRED]; * @param string $var @@ -141,7 +174,9 @@ public function setProject($var) } /** - * The name of the region where the network endpoint group is located. It should comply with RFC1035. + * The name of the region where + * the network endpoint group is located. It should comply with + * RFC1035. * * Generated from protobuf field string region = 138946292 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "region"]; * @return string @@ -152,7 +187,9 @@ public function getRegion() } /** - * The name of the region where the network endpoint group is located. It should comply with RFC1035. + * The name of the region where + * the network endpoint group is located. It should comply with + * RFC1035. * * Generated from protobuf field string region = 138946292 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "region"]; * @param string $var @@ -203,7 +240,18 @@ public function setRegionNetworkEndpointGroupsDetachEndpointsRequestResource($va } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). end_interface: MixerMutationRequestBuilder + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). + * end_interface: MixerMutationRequestBuilder * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -224,7 +272,18 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). end_interface: MixerMutationRequestBuilder + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). + * end_interface: MixerMutationRequestBuilder * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/DisableXpnHostProjectRequest.php b/Compute/src/V1/DisableXpnHostProjectRequest.php index a1b79ab98e4e..c08ad37a90ab 100644 --- a/Compute/src/V1/DisableXpnHostProjectRequest.php +++ b/Compute/src/V1/DisableXpnHostProjectRequest.php @@ -22,7 +22,17 @@ class DisableXpnHostProjectRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -50,7 +60,17 @@ public static function build(string $project): self * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -85,7 +105,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -106,7 +136,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/DisableXpnResourceProjectRequest.php b/Compute/src/V1/DisableXpnResourceProjectRequest.php index 63675243e7ad..7edcf0ae57dd 100644 --- a/Compute/src/V1/DisableXpnResourceProjectRequest.php +++ b/Compute/src/V1/DisableXpnResourceProjectRequest.php @@ -28,7 +28,17 @@ class DisableXpnResourceProjectRequest extends \Google\Protobuf\Internal\Message */ protected $projects_disable_xpn_resource_request_resource = null; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -60,7 +70,17 @@ public static function build(string $project, \Google\Cloud\Compute\V1\ProjectsD * @type \Google\Cloud\Compute\V1\ProjectsDisableXpnResourceRequest $projects_disable_xpn_resource_request_resource * The body resource for this request * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -131,7 +151,17 @@ public function setProjectsDisableXpnResourceRequestResource($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -152,7 +182,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/Disk.php b/Compute/src/V1/Disk.php index 10d3af32a934..0d33ac366a5c 100644 --- a/Compute/src/V1/Disk.php +++ b/Compute/src/V1/Disk.php @@ -9,21 +9,41 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Represents a Persistent Disk resource. Google Compute Engine has two Disk resources: * [Zonal](/compute/docs/reference/rest/v1/disks) * [Regional](/compute/docs/reference/rest/v1/regionDisks) Persistent disks are required for running your VM instances. Create both boot and non-boot (data) persistent disks. For more information, read Persistent Disks. For more storage options, read Storage options. The disks resource represents a zonal persistent disk. For more information, read Zonal persistent disks. The regionDisks resource represents a regional persistent disk. For more information, read Regional resources. + * Represents a Persistent Disk resource. + * Google Compute Engine has two Disk resources: + * * [Zonal](/compute/docs/reference/rest/v1/disks) + * * [Regional](/compute/docs/reference/rest/v1/regionDisks) + * Persistent disks are required for running your VM instances. + * Create both boot and non-boot (data) persistent disks. For more information, + * read Persistent Disks. For more + * storage options, read Storage options. + * The disks resource represents a zonal persistent disk. + * For more information, readZonal persistent disks. + * The regionDisks resource represents a + * regional persistent disk. For more information, read + * Regional resources. * * Generated from protobuf message google.cloud.compute.v1.Disk */ class Disk extends \Google\Protobuf\Internal\Message { /** - * The access mode of the disk. - READ_WRITE_SINGLE: The default AccessMode, means the disk can be attached to single instance in RW mode. - READ_WRITE_MANY: The AccessMode means the disk can be attached to multiple instances in RW mode. - READ_ONLY_MANY: The AccessMode means the disk can be attached to multiple instances in RO mode. The AccessMode is only valid for Hyperdisk disk types. + * The access mode of the disk. + * - READ_WRITE_SINGLE: The default AccessMode, means the + * disk can be attached to single instance in RW mode. + * - READ_WRITE_MANY: The AccessMode means the disk can be + * attached to multiple instances in RW mode. + * - READ_ONLY_MANY: The AccessMode means the disk can be + * attached to multiple instances in RO mode. + * The AccessMode is only valid for Hyperdisk disk types. * Check the AccessMode enum for the list of possible values. * * Generated from protobuf field optional string access_mode = 41155486; */ protected $access_mode = null; /** - * The architecture of the disk. Valid values are ARM64 or X86_64. + * The architecture of the disk. Valid values are + * ARM64 or X86_64. * Check the Architecture enum for the list of possible values. * * Generated from protobuf field optional string architecture = 302803283; @@ -42,19 +62,39 @@ class Disk extends \Google\Protobuf\Internal\Message */ private $async_secondary_disks; /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; */ protected $creation_timestamp = null; /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; */ protected $description = null; /** - * Encrypts the disk using a customer-supplied encryption key or a customer-managed encryption key. Encryption keys do not protect access to metadata of the disk. After you encrypt a disk with a customer-supplied key, you must provide the same key if you use the disk later. For example, to create a disk snapshot, to create a disk image, to create a machine image, or to attach the disk to a virtual machine. After you encrypt a disk with a customer-managed key, the diskEncryptionKey.kmsKeyName is set to a key *version* name once the disk is created. The disk is encrypted with this version of the key. In the response, diskEncryptionKey.kmsKeyName appears in the following format: "diskEncryptionKey.kmsKeyName": "projects/kms_project_id/locations/region/keyRings/ key_region/cryptoKeys/key /cryptoKeysVersions/version If you do not provide an encryption key when creating the disk, then the disk is encrypted using an automatically generated key and you don't need to provide a key to use the disk later. + * Encrypts the disk using a + * customer-supplied encryption key or a + * customer-managed encryption key. + * Encryption keys do not protect access to metadata of the disk. + * After you encrypt a disk with a customer-supplied key, you must provide the + * same key if you use the disk later. For example, to create a disk snapshot, + * to create a disk image, to create a machine image, or to attach the disk to + * a virtual machine. + * After you encrypt a disk with a customer-managed key, thediskEncryptionKey.kmsKeyName is set to a key *version* + * name once the disk is created. The disk is encrypted with this version of + * the key. In the response, diskEncryptionKey.kmsKeyName appears + * in the following format: + * "diskEncryptionKey.kmsKeyName": + * "projects/kms_project_id/locations/region/keyRings/ + * key_region/cryptoKeys/key + * /cryptoKeysVersions/version + * If you do not provide an encryption key when creating the disk, then the + * disk is encrypted using an automatically generated key and you don't need + * to provide a key to use the disk later. * * Generated from protobuf field optional .google.cloud.compute.v1.CustomerEncryptionKey disk_encryption_key = 271660677; */ @@ -66,43 +106,58 @@ class Disk extends \Google\Protobuf\Internal\Message */ protected $enable_confidential_compute = null; /** - * A list of features to enable on the guest operating system. Applicable only for bootable images. Read Enabling guest operating system features to see a list of available options. + * A list of features to enable on the guest operating system. Applicable + * only for bootable images. Read + * Enabling guest operating system features to see a list of available + * options. * * Generated from protobuf field repeated .google.cloud.compute.v1.GuestOsFeature guest_os_features = 79294545; */ private $guest_os_features; /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; */ protected $id = null; /** - * [Output Only] Type of the resource. Always compute#disk for disks. + * [Output Only] Type of the resource. Always compute#disk for + * disks. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * A fingerprint for the labels being applied to this disk, which is essentially a hash of the labels set used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a disk. + * A fingerprint for the labels being applied to this disk, which is + * essentially a hash of the labels set used for optimistic locking. The + * fingerprint is initially generated by Compute Engine and changes after + * every request to modify or update labels. You must always provide an + * up-to-date fingerprint hash in order to update or change labels, + * otherwise the request will fail with error412 conditionNotMet. + * To see the latest fingerprint, make a get() request to + * retrieve a disk. * * Generated from protobuf field optional string label_fingerprint = 178124825; */ protected $label_fingerprint = null; /** - * Labels to apply to this disk. These can be later modified by the setLabels method. + * Labels to apply to this disk. These can be later modified by + * the setLabels method. * * Generated from protobuf field map labels = 500195327; */ private $labels; /** - * [Output Only] Last attach timestamp in RFC3339 text format. + * [Output Only] Last attach timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string last_attach_timestamp = 42159653; */ protected $last_attach_timestamp = null; /** - * [Output Only] Last detach timestamp in RFC3339 text format. + * [Output Only] Last detach timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string last_detach_timestamp = 56471027; */ @@ -120,13 +175,20 @@ class Disk extends \Google\Protobuf\Internal\Message */ private $licenses; /** - * An opaque location hint used to place the disk close to other resources. This field is for use by internal tools that use the public API. + * An opaque location hint used to place the disk close to other resources. + * This field is for use by internal tools that use the public API. * * Generated from protobuf field optional string location_hint = 350519505; */ protected $location_hint = null; /** - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` + * which means the first character must be a lowercase letter, and all + * following characters must be a dash, lowercase letter, or digit, except + * the last character, which cannot be a dash. * * Generated from protobuf field optional string name = 3373707; */ @@ -138,37 +200,52 @@ class Disk extends \Google\Protobuf\Internal\Message */ protected $options = null; /** - * Input only. [Input Only] Additional params passed with the request, but not persisted as part of resource payload. + * Input only. [Input Only] Additional params passed with the request, but not persisted + * as part of resource payload. * * Generated from protobuf field optional .google.cloud.compute.v1.DiskParams params = 78313862; */ protected $params = null; /** - * Physical block size of the persistent disk, in bytes. If not present in a request, a default value is used. The currently supported size is 4096, other sizes may be added in the future. If an unsupported value is requested, the error message will list the supported values for the caller's project. + * Physical block size of the persistent disk, in bytes. + * If not present in a request, a default value is used. + * The currently supported size is 4096, other sizes may be added in + * the future. + * If an unsupported value is requested, the error message will list + * the supported values for the caller's project. * * Generated from protobuf field optional int64 physical_block_size_bytes = 420007943; */ protected $physical_block_size_bytes = null; /** - * Indicates how many IOPS to provision for the disk. This sets the number of I/O operations per second that the disk can handle. Values must be between 10,000 and 120,000. For more details, see the Extreme persistent disk documentation. + * Indicates how many IOPS to provision for the disk. This sets the number + * of I/O operations per second that the disk can handle. Values must be + * between 10,000 and 120,000. For more details, see theExtreme persistent + * disk documentation. * * Generated from protobuf field optional int64 provisioned_iops = 186769108; */ protected $provisioned_iops = null; /** - * Indicates how much throughput to provision for the disk. This sets the number of throughput mb per second that the disk can handle. Values must be greater than or equal to 1. + * Indicates how much throughput to provision for the disk. This sets the + * number of throughput mb per second that the disk can handle. Values must be + * greater than or equal to 1. * * Generated from protobuf field optional int64 provisioned_throughput = 526524181; */ protected $provisioned_throughput = null; /** - * [Output Only] URL of the region where the disk resides. Only applicable for regional resources. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * [Output Only] URL of the region where the disk resides. Only applicable for + * regional resources. + * You must specify this field as part of the HTTP request URL. It is + * not settable as a field in the request body. * * Generated from protobuf field optional string region = 138946292; */ protected $region = null; /** - * URLs of the zones where the disk should be replicated to. Only applicable for regional resources. + * URLs of the zones where the disk should be replicated to. Only applicable + * for regional resources. * * Generated from protobuf field repeated string replica_zones = 48438272; */ @@ -204,116 +281,203 @@ class Disk extends \Google\Protobuf\Internal\Message */ protected $self_link = null; /** - * Size, in GB, of the persistent disk. You can specify this field when creating a persistent disk using the sourceImage, sourceSnapshot, or sourceDisk parameter, or specify it alone to create an empty persistent disk. If you specify this field along with a source, the value of sizeGb must not be less than the size of the source. Acceptable values are greater than 0. + * Size, in GB, of the persistent disk. You can specify + * this field when creating a persistent disk using thesourceImage, sourceSnapshot, orsourceDisk parameter, or specify it alone to create an empty + * persistent disk. + * If you specify this field along with a source, the value ofsizeGb must not be less than the size of the + * source. + * Acceptable values are greater than 0. * * Generated from protobuf field optional int64 size_gb = 494929369; */ protected $size_gb = null; /** - * [Output Only] URL of the DiskConsistencyGroupPolicy for a secondary disk that was created using a consistency group. + * [Output Only] URL of the DiskConsistencyGroupPolicy for a secondary disk + * that was created using a consistency group. * * Generated from protobuf field optional string source_consistency_group_policy = 19616093; */ protected $source_consistency_group_policy = null; /** - * [Output Only] ID of the DiskConsistencyGroupPolicy for a secondary disk that was created using a consistency group. + * [Output Only] ID of the DiskConsistencyGroupPolicy for a secondary disk + * that was created using a consistency group. * * Generated from protobuf field optional string source_consistency_group_policy_id = 267568957; */ protected $source_consistency_group_policy_id = null; /** - * The source disk used to create this disk. You can provide this as a partial or full URL to the resource. For example, the following are valid values: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /disks/disk - https://www.googleapis.com/compute/v1/projects/project/regions/region /disks/disk - projects/project/zones/zone/disks/disk - projects/project/regions/region/disks/disk - zones/zone/disks/disk - regions/region/disks/disk + * The source disk used to create this disk. You can provide this as a + * partial or full URL to the resource. For example, the following are valid + * values: + * - + * https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk + * - + * https://www.googleapis.com/compute/v1/projects/project/regions/region/disks/disk + * - + * projects/project/zones/zone/disks/disk + * - + * projects/project/regions/region/disks/disk + * - + * zones/zone/disks/disk + * - + * regions/region/disks/disk * * Generated from protobuf field optional string source_disk = 451753793; */ protected $source_disk = null; /** - * [Output Only] The unique ID of the disk used to create this disk. This value identifies the exact disk that was used to create this persistent disk. For example, if you created the persistent disk from a disk that was later deleted and recreated under the same name, the source disk ID would identify the exact version of the disk that was used. + * [Output Only] The unique ID of the disk used to create this disk. This + * value identifies the exact disk that was used to create this persistent + * disk. For example, if you created the persistent disk from a disk that + * was later deleted and recreated under the same name, the source disk ID + * would identify the exact version of the disk that was used. * * Generated from protobuf field optional string source_disk_id = 454190809; */ protected $source_disk_id = null; /** - * The source image used to create this disk. If the source image is deleted, this field will not be set. To create a disk with one of the public operating system images, specify the image by its family name. For example, specify family/debian-9 to use the latest Debian 9 image: projects/debian-cloud/global/images/family/debian-9 Alternatively, use a specific version of a public operating system image: projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD To create a disk with a custom image that you created, specify the image name in the following format: global/images/my-custom-image You can also specify a custom image by its image family, which returns the latest version of the image in that family. Replace the image name with family/family-name: global/images/family/my-image-family + * The source image used to create this disk. If the source image is + * deleted, this field will not be set. + * To create a disk with one of the public operating system images, specify + * the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image: + * projects/debian-cloud/global/images/family/debian-9 + * Alternatively, use a specific version of a public operating system image: + * projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD + * To create a disk with a custom image that you created, specify the + * image name in the following format: + * global/images/my-custom-image + * You can also specify a custom image by its image family, which returns + * the latest version of the image in that family. Replace the image name + * with family/family-name: + * global/images/family/my-image-family * * Generated from protobuf field optional string source_image = 50443319; */ protected $source_image = null; /** - * The customer-supplied encryption key of the source image. Required if the source image is protected by a customer-supplied encryption key. + * Thecustomer-supplied + * encryption key of the source image. Required if the source image is + * protected by a customer-supplied encryption key. * * Generated from protobuf field optional .google.cloud.compute.v1.CustomerEncryptionKey source_image_encryption_key = 381503659; */ protected $source_image_encryption_key = null; /** - * [Output Only] The ID value of the image used to create this disk. This value identifies the exact image that was used to create this persistent disk. For example, if you created the persistent disk from an image that was later deleted and recreated under the same name, the source image ID would identify the exact version of the image that was used. + * [Output Only] The ID value of the image used to create this disk. This + * value identifies the exact image that was used to create this persistent + * disk. For example, if you created the persistent disk from an image that + * was later deleted and recreated under the same name, the source image ID + * would identify the exact version of the image that was used. * * Generated from protobuf field optional string source_image_id = 55328291; */ protected $source_image_id = null; /** - * The source instant snapshot used to create this disk. You can provide this as a partial or full URL to the resource. For example, the following are valid values: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /instantSnapshots/instantSnapshot - projects/project/zones/zone/instantSnapshots/instantSnapshot - zones/zone/instantSnapshots/instantSnapshot + * The source instant snapshot used to create this disk. You can provide + * this as a partial or full URL to the resource. For example, the following + * are valid values: + * - https://www.googleapis.com/compute/v1/projects/project/zones/zone/instantSnapshots/instantSnapshot + * - projects/project/zones/zone/instantSnapshots/instantSnapshot + * - zones/zone/instantSnapshots/instantSnapshot * * Generated from protobuf field optional string source_instant_snapshot = 219202054; */ protected $source_instant_snapshot = null; /** - * [Output Only] The unique ID of the instant snapshot used to create this disk. This value identifies the exact instant snapshot that was used to create this persistent disk. For example, if you created the persistent disk from an instant snapshot that was later deleted and recreated under the same name, the source instant snapshot ID would identify the exact version of the instant snapshot that was used. + * [Output Only] The unique ID of the instant snapshot used to create this + * disk. This value identifies the exact instant snapshot that was used to + * create this persistent disk. For example, if you created the persistent + * disk from an instant snapshot that was later deleted and recreated under + * the same name, the source instant snapshot ID would identify the exact + * version of the instant snapshot that was used. * * Generated from protobuf field optional string source_instant_snapshot_id = 287582708; */ protected $source_instant_snapshot_id = null; /** - * The source snapshot used to create this disk. You can provide this as a partial or full URL to the resource. For example, the following are valid values: - https://www.googleapis.com/compute/v1/projects/project /global/snapshots/snapshot - projects/project/global/snapshots/snapshot - global/snapshots/snapshot + * The source snapshot used to create this disk. You can provide this as a + * partial or full URL to the resource. For example, the following are valid + * values: + * - https://www.googleapis.com/compute/v1/projects/project/global/snapshots/snapshot + * - projects/project/global/snapshots/snapshot + * - global/snapshots/snapshot * * Generated from protobuf field optional string source_snapshot = 126061928; */ protected $source_snapshot = null; /** - * The customer-supplied encryption key of the source snapshot. Required if the source snapshot is protected by a customer-supplied encryption key. + * Thecustomer-supplied + * encryption key of the source snapshot. Required if the source snapshot + * is protected by a customer-supplied encryption key. * * Generated from protobuf field optional .google.cloud.compute.v1.CustomerEncryptionKey source_snapshot_encryption_key = 303679322; */ protected $source_snapshot_encryption_key = null; /** - * [Output Only] The unique ID of the snapshot used to create this disk. This value identifies the exact snapshot that was used to create this persistent disk. For example, if you created the persistent disk from a snapshot that was later deleted and recreated under the same name, the source snapshot ID would identify the exact version of the snapshot that was used. + * [Output Only] The unique ID of the snapshot used to create this disk. This + * value identifies the exact snapshot that was used to create this persistent + * disk. For example, if you created the persistent disk from a snapshot that + * was later deleted and recreated under the same name, the source snapshot ID + * would identify the exact version of the snapshot that was used. * * Generated from protobuf field optional string source_snapshot_id = 98962258; */ protected $source_snapshot_id = null; /** - * The full Google Cloud Storage URI where the disk image is stored. This file must be a gzip-compressed tarball whose name ends in .tar.gz or virtual machine disk whose name ends in vmdk. Valid URIs may start with gs:// or https://storage.googleapis.com/. This flag is not optimized for creating multiple disks from a source storage object. To create many disks from a source storage object, use gcloud compute images import instead. + * The full Google Cloud Storage URI where the disk image is stored. This file + * must be a gzip-compressed tarball whose name ends in .tar.gz or virtual + * machine disk whose name ends in vmdk. Valid URIs may start with gs:// or + * https://storage.googleapis.com/. This flag is not optimized for creating + * multiple disks from a source storage object. To create many disks from a + * source storage object, use gcloud compute images + * import instead. * * Generated from protobuf field optional string source_storage_object = 233052711; */ protected $source_storage_object = null; /** - * [Output Only] The status of disk creation. - CREATING: Disk is provisioning. - RESTORING: Source data is being copied into the disk. - FAILED: Disk creation failed. - READY: Disk is ready for use. - DELETING: Disk is deleting. + * [Output Only] The status of disk creation. + * - CREATING: Disk is provisioning. + * - RESTORING: Source data is being copied into the + * disk. + * - FAILED: Disk creation failed. + * - READY: Disk is ready for use. + * - DELETING: Disk is deleting. * Check the Status enum for the list of possible values. * * Generated from protobuf field optional string status = 181260274; */ protected $status = null; /** - * The storage pool in which the new disk is created. You can provide this as a partial or full URL to the resource. For example, the following are valid values: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /storagePools/storagePool - projects/project/zones/zone/storagePools/storagePool - zones/zone/storagePools/storagePool + * The storage pool in which the new disk is created. You can provide + * this as a partial or full URL to the resource. For example, the following + * are valid values: + * - https://www.googleapis.com/compute/v1/projects/project/zones/zone/storagePools/storagePool + * - projects/project/zones/zone/storagePools/storagePool + * - zones/zone/storagePools/storagePool * * Generated from protobuf field optional string storage_pool = 360473440; */ protected $storage_pool = null; /** - * URL of the disk type resource describing which disk type to use to create the disk. Provide this when creating the disk. For example: projects/project /zones/zone/diskTypes/pd-ssd . See Persistent disk types. + * URL of the disk type resource describing which disk type to use to create + * the disk. Provide this when creating the disk. For example:projects/project/zones/zone/diskTypes/pd-ssd. See Persistent disk + * types. * * Generated from protobuf field optional string type = 3575610; */ protected $type = null; /** - * [Output Only] Links to the users of the disk (attached instances) in form: projects/project/zones/zone/instances/instance + * [Output Only] Links to the users of the disk (attached instances) + * in form:projects/project/zones/zone/instances/instance * * Generated from protobuf field repeated string users = 111578632; */ private $users; /** - * [Output Only] URL of the zone where the disk resides. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * [Output Only] URL of the zone where the disk resides. + * You must specify this field as part of the HTTP request URL. It is + * not settable as a field in the request body. * * Generated from protobuf field optional string zone = 3744684; */ @@ -326,59 +490,124 @@ class Disk extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $access_mode - * The access mode of the disk. - READ_WRITE_SINGLE: The default AccessMode, means the disk can be attached to single instance in RW mode. - READ_WRITE_MANY: The AccessMode means the disk can be attached to multiple instances in RW mode. - READ_ONLY_MANY: The AccessMode means the disk can be attached to multiple instances in RO mode. The AccessMode is only valid for Hyperdisk disk types. + * The access mode of the disk. + * - READ_WRITE_SINGLE: The default AccessMode, means the + * disk can be attached to single instance in RW mode. + * - READ_WRITE_MANY: The AccessMode means the disk can be + * attached to multiple instances in RW mode. + * - READ_ONLY_MANY: The AccessMode means the disk can be + * attached to multiple instances in RO mode. + * The AccessMode is only valid for Hyperdisk disk types. * Check the AccessMode enum for the list of possible values. * @type string $architecture - * The architecture of the disk. Valid values are ARM64 or X86_64. + * The architecture of the disk. Valid values are + * ARM64 or X86_64. * Check the Architecture enum for the list of possible values. * @type \Google\Cloud\Compute\V1\DiskAsyncReplication $async_primary_disk * Disk asynchronously replicated into this disk. * @type array|\Google\Protobuf\Internal\MapField $async_secondary_disks * [Output Only] A list of disks this disk is asynchronously replicated to. * @type string $creation_timestamp - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * @type string $description - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * @type \Google\Cloud\Compute\V1\CustomerEncryptionKey $disk_encryption_key - * Encrypts the disk using a customer-supplied encryption key or a customer-managed encryption key. Encryption keys do not protect access to metadata of the disk. After you encrypt a disk with a customer-supplied key, you must provide the same key if you use the disk later. For example, to create a disk snapshot, to create a disk image, to create a machine image, or to attach the disk to a virtual machine. After you encrypt a disk with a customer-managed key, the diskEncryptionKey.kmsKeyName is set to a key *version* name once the disk is created. The disk is encrypted with this version of the key. In the response, diskEncryptionKey.kmsKeyName appears in the following format: "diskEncryptionKey.kmsKeyName": "projects/kms_project_id/locations/region/keyRings/ key_region/cryptoKeys/key /cryptoKeysVersions/version If you do not provide an encryption key when creating the disk, then the disk is encrypted using an automatically generated key and you don't need to provide a key to use the disk later. + * Encrypts the disk using a + * customer-supplied encryption key or a + * customer-managed encryption key. + * Encryption keys do not protect access to metadata of the disk. + * After you encrypt a disk with a customer-supplied key, you must provide the + * same key if you use the disk later. For example, to create a disk snapshot, + * to create a disk image, to create a machine image, or to attach the disk to + * a virtual machine. + * After you encrypt a disk with a customer-managed key, thediskEncryptionKey.kmsKeyName is set to a key *version* + * name once the disk is created. The disk is encrypted with this version of + * the key. In the response, diskEncryptionKey.kmsKeyName appears + * in the following format: + * "diskEncryptionKey.kmsKeyName": + * "projects/kms_project_id/locations/region/keyRings/ + * key_region/cryptoKeys/key + * /cryptoKeysVersions/version + * If you do not provide an encryption key when creating the disk, then the + * disk is encrypted using an automatically generated key and you don't need + * to provide a key to use the disk later. * @type bool $enable_confidential_compute * Whether this disk is using confidential compute mode. * @type array<\Google\Cloud\Compute\V1\GuestOsFeature>|\Google\Protobuf\Internal\RepeatedField $guest_os_features - * A list of features to enable on the guest operating system. Applicable only for bootable images. Read Enabling guest operating system features to see a list of available options. + * A list of features to enable on the guest operating system. Applicable + * only for bootable images. Read + * Enabling guest operating system features to see a list of available + * options. * @type int|string $id - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * @type string $kind - * [Output Only] Type of the resource. Always compute#disk for disks. + * [Output Only] Type of the resource. Always compute#disk for + * disks. * @type string $label_fingerprint - * A fingerprint for the labels being applied to this disk, which is essentially a hash of the labels set used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a disk. + * A fingerprint for the labels being applied to this disk, which is + * essentially a hash of the labels set used for optimistic locking. The + * fingerprint is initially generated by Compute Engine and changes after + * every request to modify or update labels. You must always provide an + * up-to-date fingerprint hash in order to update or change labels, + * otherwise the request will fail with error412 conditionNotMet. + * To see the latest fingerprint, make a get() request to + * retrieve a disk. * @type array|\Google\Protobuf\Internal\MapField $labels - * Labels to apply to this disk. These can be later modified by the setLabels method. + * Labels to apply to this disk. These can be later modified by + * the setLabels method. * @type string $last_attach_timestamp - * [Output Only] Last attach timestamp in RFC3339 text format. + * [Output Only] Last attach timestamp inRFC3339 + * text format. * @type string $last_detach_timestamp - * [Output Only] Last detach timestamp in RFC3339 text format. + * [Output Only] Last detach timestamp inRFC3339 + * text format. * @type array|array|\Google\Protobuf\Internal\RepeatedField $license_codes * Integer license codes indicating which licenses are attached to this disk. * @type array|\Google\Protobuf\Internal\RepeatedField $licenses * A list of publicly visible licenses. Reserved for Google's use. * @type string $location_hint - * An opaque location hint used to place the disk close to other resources. This field is for use by internal tools that use the public API. + * An opaque location hint used to place the disk close to other resources. + * This field is for use by internal tools that use the public API. * @type string $name - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` + * which means the first character must be a lowercase letter, and all + * following characters must be a dash, lowercase letter, or digit, except + * the last character, which cannot be a dash. * @type string $options * Internal use only. * @type \Google\Cloud\Compute\V1\DiskParams $params - * Input only. [Input Only] Additional params passed with the request, but not persisted as part of resource payload. + * Input only. [Input Only] Additional params passed with the request, but not persisted + * as part of resource payload. * @type int|string $physical_block_size_bytes - * Physical block size of the persistent disk, in bytes. If not present in a request, a default value is used. The currently supported size is 4096, other sizes may be added in the future. If an unsupported value is requested, the error message will list the supported values for the caller's project. + * Physical block size of the persistent disk, in bytes. + * If not present in a request, a default value is used. + * The currently supported size is 4096, other sizes may be added in + * the future. + * If an unsupported value is requested, the error message will list + * the supported values for the caller's project. * @type int|string $provisioned_iops - * Indicates how many IOPS to provision for the disk. This sets the number of I/O operations per second that the disk can handle. Values must be between 10,000 and 120,000. For more details, see the Extreme persistent disk documentation. + * Indicates how many IOPS to provision for the disk. This sets the number + * of I/O operations per second that the disk can handle. Values must be + * between 10,000 and 120,000. For more details, see theExtreme persistent + * disk documentation. * @type int|string $provisioned_throughput - * Indicates how much throughput to provision for the disk. This sets the number of throughput mb per second that the disk can handle. Values must be greater than or equal to 1. + * Indicates how much throughput to provision for the disk. This sets the + * number of throughput mb per second that the disk can handle. Values must be + * greater than or equal to 1. * @type string $region - * [Output Only] URL of the region where the disk resides. Only applicable for regional resources. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * [Output Only] URL of the region where the disk resides. Only applicable for + * regional resources. + * You must specify this field as part of the HTTP request URL. It is + * not settable as a field in the request body. * @type array|\Google\Protobuf\Internal\RepeatedField $replica_zones - * URLs of the zones where the disk should be replicated to. Only applicable for regional resources. + * URLs of the zones where the disk should be replicated to. Only applicable + * for regional resources. * @type array|\Google\Protobuf\Internal\RepeatedField $resource_policies * Resource policies applied to this disk for automatic snapshot creations. * @type \Google\Cloud\Compute\V1\DiskResourceStatus $resource_status @@ -390,44 +619,131 @@ class Disk extends \Google\Protobuf\Internal\Message * @type string $self_link * [Output Only] Server-defined fully-qualified URL for this resource. * @type int|string $size_gb - * Size, in GB, of the persistent disk. You can specify this field when creating a persistent disk using the sourceImage, sourceSnapshot, or sourceDisk parameter, or specify it alone to create an empty persistent disk. If you specify this field along with a source, the value of sizeGb must not be less than the size of the source. Acceptable values are greater than 0. + * Size, in GB, of the persistent disk. You can specify + * this field when creating a persistent disk using thesourceImage, sourceSnapshot, orsourceDisk parameter, or specify it alone to create an empty + * persistent disk. + * If you specify this field along with a source, the value ofsizeGb must not be less than the size of the + * source. + * Acceptable values are greater than 0. * @type string $source_consistency_group_policy - * [Output Only] URL of the DiskConsistencyGroupPolicy for a secondary disk that was created using a consistency group. + * [Output Only] URL of the DiskConsistencyGroupPolicy for a secondary disk + * that was created using a consistency group. * @type string $source_consistency_group_policy_id - * [Output Only] ID of the DiskConsistencyGroupPolicy for a secondary disk that was created using a consistency group. + * [Output Only] ID of the DiskConsistencyGroupPolicy for a secondary disk + * that was created using a consistency group. * @type string $source_disk - * The source disk used to create this disk. You can provide this as a partial or full URL to the resource. For example, the following are valid values: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /disks/disk - https://www.googleapis.com/compute/v1/projects/project/regions/region /disks/disk - projects/project/zones/zone/disks/disk - projects/project/regions/region/disks/disk - zones/zone/disks/disk - regions/region/disks/disk + * The source disk used to create this disk. You can provide this as a + * partial or full URL to the resource. For example, the following are valid + * values: + * - + * https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk + * - + * https://www.googleapis.com/compute/v1/projects/project/regions/region/disks/disk + * - + * projects/project/zones/zone/disks/disk + * - + * projects/project/regions/region/disks/disk + * - + * zones/zone/disks/disk + * - + * regions/region/disks/disk * @type string $source_disk_id - * [Output Only] The unique ID of the disk used to create this disk. This value identifies the exact disk that was used to create this persistent disk. For example, if you created the persistent disk from a disk that was later deleted and recreated under the same name, the source disk ID would identify the exact version of the disk that was used. + * [Output Only] The unique ID of the disk used to create this disk. This + * value identifies the exact disk that was used to create this persistent + * disk. For example, if you created the persistent disk from a disk that + * was later deleted and recreated under the same name, the source disk ID + * would identify the exact version of the disk that was used. * @type string $source_image - * The source image used to create this disk. If the source image is deleted, this field will not be set. To create a disk with one of the public operating system images, specify the image by its family name. For example, specify family/debian-9 to use the latest Debian 9 image: projects/debian-cloud/global/images/family/debian-9 Alternatively, use a specific version of a public operating system image: projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD To create a disk with a custom image that you created, specify the image name in the following format: global/images/my-custom-image You can also specify a custom image by its image family, which returns the latest version of the image in that family. Replace the image name with family/family-name: global/images/family/my-image-family + * The source image used to create this disk. If the source image is + * deleted, this field will not be set. + * To create a disk with one of the public operating system images, specify + * the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image: + * projects/debian-cloud/global/images/family/debian-9 + * Alternatively, use a specific version of a public operating system image: + * projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD + * To create a disk with a custom image that you created, specify the + * image name in the following format: + * global/images/my-custom-image + * You can also specify a custom image by its image family, which returns + * the latest version of the image in that family. Replace the image name + * with family/family-name: + * global/images/family/my-image-family * @type \Google\Cloud\Compute\V1\CustomerEncryptionKey $source_image_encryption_key - * The customer-supplied encryption key of the source image. Required if the source image is protected by a customer-supplied encryption key. + * Thecustomer-supplied + * encryption key of the source image. Required if the source image is + * protected by a customer-supplied encryption key. * @type string $source_image_id - * [Output Only] The ID value of the image used to create this disk. This value identifies the exact image that was used to create this persistent disk. For example, if you created the persistent disk from an image that was later deleted and recreated under the same name, the source image ID would identify the exact version of the image that was used. + * [Output Only] The ID value of the image used to create this disk. This + * value identifies the exact image that was used to create this persistent + * disk. For example, if you created the persistent disk from an image that + * was later deleted and recreated under the same name, the source image ID + * would identify the exact version of the image that was used. * @type string $source_instant_snapshot - * The source instant snapshot used to create this disk. You can provide this as a partial or full URL to the resource. For example, the following are valid values: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /instantSnapshots/instantSnapshot - projects/project/zones/zone/instantSnapshots/instantSnapshot - zones/zone/instantSnapshots/instantSnapshot + * The source instant snapshot used to create this disk. You can provide + * this as a partial or full URL to the resource. For example, the following + * are valid values: + * - https://www.googleapis.com/compute/v1/projects/project/zones/zone/instantSnapshots/instantSnapshot + * - projects/project/zones/zone/instantSnapshots/instantSnapshot + * - zones/zone/instantSnapshots/instantSnapshot * @type string $source_instant_snapshot_id - * [Output Only] The unique ID of the instant snapshot used to create this disk. This value identifies the exact instant snapshot that was used to create this persistent disk. For example, if you created the persistent disk from an instant snapshot that was later deleted and recreated under the same name, the source instant snapshot ID would identify the exact version of the instant snapshot that was used. + * [Output Only] The unique ID of the instant snapshot used to create this + * disk. This value identifies the exact instant snapshot that was used to + * create this persistent disk. For example, if you created the persistent + * disk from an instant snapshot that was later deleted and recreated under + * the same name, the source instant snapshot ID would identify the exact + * version of the instant snapshot that was used. * @type string $source_snapshot - * The source snapshot used to create this disk. You can provide this as a partial or full URL to the resource. For example, the following are valid values: - https://www.googleapis.com/compute/v1/projects/project /global/snapshots/snapshot - projects/project/global/snapshots/snapshot - global/snapshots/snapshot + * The source snapshot used to create this disk. You can provide this as a + * partial or full URL to the resource. For example, the following are valid + * values: + * - https://www.googleapis.com/compute/v1/projects/project/global/snapshots/snapshot + * - projects/project/global/snapshots/snapshot + * - global/snapshots/snapshot * @type \Google\Cloud\Compute\V1\CustomerEncryptionKey $source_snapshot_encryption_key - * The customer-supplied encryption key of the source snapshot. Required if the source snapshot is protected by a customer-supplied encryption key. + * Thecustomer-supplied + * encryption key of the source snapshot. Required if the source snapshot + * is protected by a customer-supplied encryption key. * @type string $source_snapshot_id - * [Output Only] The unique ID of the snapshot used to create this disk. This value identifies the exact snapshot that was used to create this persistent disk. For example, if you created the persistent disk from a snapshot that was later deleted and recreated under the same name, the source snapshot ID would identify the exact version of the snapshot that was used. + * [Output Only] The unique ID of the snapshot used to create this disk. This + * value identifies the exact snapshot that was used to create this persistent + * disk. For example, if you created the persistent disk from a snapshot that + * was later deleted and recreated under the same name, the source snapshot ID + * would identify the exact version of the snapshot that was used. * @type string $source_storage_object - * The full Google Cloud Storage URI where the disk image is stored. This file must be a gzip-compressed tarball whose name ends in .tar.gz or virtual machine disk whose name ends in vmdk. Valid URIs may start with gs:// or https://storage.googleapis.com/. This flag is not optimized for creating multiple disks from a source storage object. To create many disks from a source storage object, use gcloud compute images import instead. + * The full Google Cloud Storage URI where the disk image is stored. This file + * must be a gzip-compressed tarball whose name ends in .tar.gz or virtual + * machine disk whose name ends in vmdk. Valid URIs may start with gs:// or + * https://storage.googleapis.com/. This flag is not optimized for creating + * multiple disks from a source storage object. To create many disks from a + * source storage object, use gcloud compute images + * import instead. * @type string $status - * [Output Only] The status of disk creation. - CREATING: Disk is provisioning. - RESTORING: Source data is being copied into the disk. - FAILED: Disk creation failed. - READY: Disk is ready for use. - DELETING: Disk is deleting. + * [Output Only] The status of disk creation. + * - CREATING: Disk is provisioning. + * - RESTORING: Source data is being copied into the + * disk. + * - FAILED: Disk creation failed. + * - READY: Disk is ready for use. + * - DELETING: Disk is deleting. * Check the Status enum for the list of possible values. * @type string $storage_pool - * The storage pool in which the new disk is created. You can provide this as a partial or full URL to the resource. For example, the following are valid values: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /storagePools/storagePool - projects/project/zones/zone/storagePools/storagePool - zones/zone/storagePools/storagePool + * The storage pool in which the new disk is created. You can provide + * this as a partial or full URL to the resource. For example, the following + * are valid values: + * - https://www.googleapis.com/compute/v1/projects/project/zones/zone/storagePools/storagePool + * - projects/project/zones/zone/storagePools/storagePool + * - zones/zone/storagePools/storagePool * @type string $type - * URL of the disk type resource describing which disk type to use to create the disk. Provide this when creating the disk. For example: projects/project /zones/zone/diskTypes/pd-ssd . See Persistent disk types. + * URL of the disk type resource describing which disk type to use to create + * the disk. Provide this when creating the disk. For example:projects/project/zones/zone/diskTypes/pd-ssd. See Persistent disk + * types. * @type array|\Google\Protobuf\Internal\RepeatedField $users - * [Output Only] Links to the users of the disk (attached instances) in form: projects/project/zones/zone/instances/instance + * [Output Only] Links to the users of the disk (attached instances) + * in form:projects/project/zones/zone/instances/instance * @type string $zone - * [Output Only] URL of the zone where the disk resides. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * [Output Only] URL of the zone where the disk resides. + * You must specify this field as part of the HTTP request URL. It is + * not settable as a field in the request body. * } */ public function __construct($data = NULL) { @@ -436,7 +752,14 @@ public function __construct($data = NULL) { } /** - * The access mode of the disk. - READ_WRITE_SINGLE: The default AccessMode, means the disk can be attached to single instance in RW mode. - READ_WRITE_MANY: The AccessMode means the disk can be attached to multiple instances in RW mode. - READ_ONLY_MANY: The AccessMode means the disk can be attached to multiple instances in RO mode. The AccessMode is only valid for Hyperdisk disk types. + * The access mode of the disk. + * - READ_WRITE_SINGLE: The default AccessMode, means the + * disk can be attached to single instance in RW mode. + * - READ_WRITE_MANY: The AccessMode means the disk can be + * attached to multiple instances in RW mode. + * - READ_ONLY_MANY: The AccessMode means the disk can be + * attached to multiple instances in RO mode. + * The AccessMode is only valid for Hyperdisk disk types. * Check the AccessMode enum for the list of possible values. * * Generated from protobuf field optional string access_mode = 41155486; @@ -458,7 +781,14 @@ public function clearAccessMode() } /** - * The access mode of the disk. - READ_WRITE_SINGLE: The default AccessMode, means the disk can be attached to single instance in RW mode. - READ_WRITE_MANY: The AccessMode means the disk can be attached to multiple instances in RW mode. - READ_ONLY_MANY: The AccessMode means the disk can be attached to multiple instances in RO mode. The AccessMode is only valid for Hyperdisk disk types. + * The access mode of the disk. + * - READ_WRITE_SINGLE: The default AccessMode, means the + * disk can be attached to single instance in RW mode. + * - READ_WRITE_MANY: The AccessMode means the disk can be + * attached to multiple instances in RW mode. + * - READ_ONLY_MANY: The AccessMode means the disk can be + * attached to multiple instances in RO mode. + * The AccessMode is only valid for Hyperdisk disk types. * Check the AccessMode enum for the list of possible values. * * Generated from protobuf field optional string access_mode = 41155486; @@ -474,7 +804,8 @@ public function setAccessMode($var) } /** - * The architecture of the disk. Valid values are ARM64 or X86_64. + * The architecture of the disk. Valid values are + * ARM64 or X86_64. * Check the Architecture enum for the list of possible values. * * Generated from protobuf field optional string architecture = 302803283; @@ -496,7 +827,8 @@ public function clearArchitecture() } /** - * The architecture of the disk. Valid values are ARM64 or X86_64. + * The architecture of the disk. Valid values are + * ARM64 or X86_64. * Check the Architecture enum for the list of possible values. * * Generated from protobuf field optional string architecture = 302803283; @@ -574,7 +906,8 @@ public function setAsyncSecondaryDisks($var) } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @return string @@ -595,7 +928,8 @@ public function clearCreationTimestamp() } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @param string $var @@ -610,7 +944,8 @@ public function setCreationTimestamp($var) } /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @return string @@ -631,7 +966,8 @@ public function clearDescription() } /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @param string $var @@ -646,7 +982,25 @@ public function setDescription($var) } /** - * Encrypts the disk using a customer-supplied encryption key or a customer-managed encryption key. Encryption keys do not protect access to metadata of the disk. After you encrypt a disk with a customer-supplied key, you must provide the same key if you use the disk later. For example, to create a disk snapshot, to create a disk image, to create a machine image, or to attach the disk to a virtual machine. After you encrypt a disk with a customer-managed key, the diskEncryptionKey.kmsKeyName is set to a key *version* name once the disk is created. The disk is encrypted with this version of the key. In the response, diskEncryptionKey.kmsKeyName appears in the following format: "diskEncryptionKey.kmsKeyName": "projects/kms_project_id/locations/region/keyRings/ key_region/cryptoKeys/key /cryptoKeysVersions/version If you do not provide an encryption key when creating the disk, then the disk is encrypted using an automatically generated key and you don't need to provide a key to use the disk later. + * Encrypts the disk using a + * customer-supplied encryption key or a + * customer-managed encryption key. + * Encryption keys do not protect access to metadata of the disk. + * After you encrypt a disk with a customer-supplied key, you must provide the + * same key if you use the disk later. For example, to create a disk snapshot, + * to create a disk image, to create a machine image, or to attach the disk to + * a virtual machine. + * After you encrypt a disk with a customer-managed key, thediskEncryptionKey.kmsKeyName is set to a key *version* + * name once the disk is created. The disk is encrypted with this version of + * the key. In the response, diskEncryptionKey.kmsKeyName appears + * in the following format: + * "diskEncryptionKey.kmsKeyName": + * "projects/kms_project_id/locations/region/keyRings/ + * key_region/cryptoKeys/key + * /cryptoKeysVersions/version + * If you do not provide an encryption key when creating the disk, then the + * disk is encrypted using an automatically generated key and you don't need + * to provide a key to use the disk later. * * Generated from protobuf field optional .google.cloud.compute.v1.CustomerEncryptionKey disk_encryption_key = 271660677; * @return \Google\Cloud\Compute\V1\CustomerEncryptionKey|null @@ -667,7 +1021,25 @@ public function clearDiskEncryptionKey() } /** - * Encrypts the disk using a customer-supplied encryption key or a customer-managed encryption key. Encryption keys do not protect access to metadata of the disk. After you encrypt a disk with a customer-supplied key, you must provide the same key if you use the disk later. For example, to create a disk snapshot, to create a disk image, to create a machine image, or to attach the disk to a virtual machine. After you encrypt a disk with a customer-managed key, the diskEncryptionKey.kmsKeyName is set to a key *version* name once the disk is created. The disk is encrypted with this version of the key. In the response, diskEncryptionKey.kmsKeyName appears in the following format: "diskEncryptionKey.kmsKeyName": "projects/kms_project_id/locations/region/keyRings/ key_region/cryptoKeys/key /cryptoKeysVersions/version If you do not provide an encryption key when creating the disk, then the disk is encrypted using an automatically generated key and you don't need to provide a key to use the disk later. + * Encrypts the disk using a + * customer-supplied encryption key or a + * customer-managed encryption key. + * Encryption keys do not protect access to metadata of the disk. + * After you encrypt a disk with a customer-supplied key, you must provide the + * same key if you use the disk later. For example, to create a disk snapshot, + * to create a disk image, to create a machine image, or to attach the disk to + * a virtual machine. + * After you encrypt a disk with a customer-managed key, thediskEncryptionKey.kmsKeyName is set to a key *version* + * name once the disk is created. The disk is encrypted with this version of + * the key. In the response, diskEncryptionKey.kmsKeyName appears + * in the following format: + * "diskEncryptionKey.kmsKeyName": + * "projects/kms_project_id/locations/region/keyRings/ + * key_region/cryptoKeys/key + * /cryptoKeysVersions/version + * If you do not provide an encryption key when creating the disk, then the + * disk is encrypted using an automatically generated key and you don't need + * to provide a key to use the disk later. * * Generated from protobuf field optional .google.cloud.compute.v1.CustomerEncryptionKey disk_encryption_key = 271660677; * @param \Google\Cloud\Compute\V1\CustomerEncryptionKey $var @@ -718,7 +1090,10 @@ public function setEnableConfidentialCompute($var) } /** - * A list of features to enable on the guest operating system. Applicable only for bootable images. Read Enabling guest operating system features to see a list of available options. + * A list of features to enable on the guest operating system. Applicable + * only for bootable images. Read + * Enabling guest operating system features to see a list of available + * options. * * Generated from protobuf field repeated .google.cloud.compute.v1.GuestOsFeature guest_os_features = 79294545; * @return \Google\Protobuf\Internal\RepeatedField @@ -729,7 +1104,10 @@ public function getGuestOsFeatures() } /** - * A list of features to enable on the guest operating system. Applicable only for bootable images. Read Enabling guest operating system features to see a list of available options. + * A list of features to enable on the guest operating system. Applicable + * only for bootable images. Read + * Enabling guest operating system features to see a list of available + * options. * * Generated from protobuf field repeated .google.cloud.compute.v1.GuestOsFeature guest_os_features = 79294545; * @param array<\Google\Cloud\Compute\V1\GuestOsFeature>|\Google\Protobuf\Internal\RepeatedField $var @@ -744,7 +1122,8 @@ public function setGuestOsFeatures($var) } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @return int|string @@ -765,7 +1144,8 @@ public function clearId() } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @param int|string $var @@ -780,7 +1160,8 @@ public function setId($var) } /** - * [Output Only] Type of the resource. Always compute#disk for disks. + * [Output Only] Type of the resource. Always compute#disk for + * disks. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -801,7 +1182,8 @@ public function clearKind() } /** - * [Output Only] Type of the resource. Always compute#disk for disks. + * [Output Only] Type of the resource. Always compute#disk for + * disks. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -816,7 +1198,14 @@ public function setKind($var) } /** - * A fingerprint for the labels being applied to this disk, which is essentially a hash of the labels set used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a disk. + * A fingerprint for the labels being applied to this disk, which is + * essentially a hash of the labels set used for optimistic locking. The + * fingerprint is initially generated by Compute Engine and changes after + * every request to modify or update labels. You must always provide an + * up-to-date fingerprint hash in order to update or change labels, + * otherwise the request will fail with error412 conditionNotMet. + * To see the latest fingerprint, make a get() request to + * retrieve a disk. * * Generated from protobuf field optional string label_fingerprint = 178124825; * @return string @@ -837,7 +1226,14 @@ public function clearLabelFingerprint() } /** - * A fingerprint for the labels being applied to this disk, which is essentially a hash of the labels set used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a disk. + * A fingerprint for the labels being applied to this disk, which is + * essentially a hash of the labels set used for optimistic locking. The + * fingerprint is initially generated by Compute Engine and changes after + * every request to modify or update labels. You must always provide an + * up-to-date fingerprint hash in order to update or change labels, + * otherwise the request will fail with error412 conditionNotMet. + * To see the latest fingerprint, make a get() request to + * retrieve a disk. * * Generated from protobuf field optional string label_fingerprint = 178124825; * @param string $var @@ -852,7 +1248,8 @@ public function setLabelFingerprint($var) } /** - * Labels to apply to this disk. These can be later modified by the setLabels method. + * Labels to apply to this disk. These can be later modified by + * the setLabels method. * * Generated from protobuf field map labels = 500195327; * @return \Google\Protobuf\Internal\MapField @@ -863,7 +1260,8 @@ public function getLabels() } /** - * Labels to apply to this disk. These can be later modified by the setLabels method. + * Labels to apply to this disk. These can be later modified by + * the setLabels method. * * Generated from protobuf field map labels = 500195327; * @param array|\Google\Protobuf\Internal\MapField $var @@ -878,7 +1276,8 @@ public function setLabels($var) } /** - * [Output Only] Last attach timestamp in RFC3339 text format. + * [Output Only] Last attach timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string last_attach_timestamp = 42159653; * @return string @@ -899,7 +1298,8 @@ public function clearLastAttachTimestamp() } /** - * [Output Only] Last attach timestamp in RFC3339 text format. + * [Output Only] Last attach timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string last_attach_timestamp = 42159653; * @param string $var @@ -914,7 +1314,8 @@ public function setLastAttachTimestamp($var) } /** - * [Output Only] Last detach timestamp in RFC3339 text format. + * [Output Only] Last detach timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string last_detach_timestamp = 56471027; * @return string @@ -935,7 +1336,8 @@ public function clearLastDetachTimestamp() } /** - * [Output Only] Last detach timestamp in RFC3339 text format. + * [Output Only] Last detach timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string last_detach_timestamp = 56471027; * @param string $var @@ -1002,7 +1404,8 @@ public function setLicenses($var) } /** - * An opaque location hint used to place the disk close to other resources. This field is for use by internal tools that use the public API. + * An opaque location hint used to place the disk close to other resources. + * This field is for use by internal tools that use the public API. * * Generated from protobuf field optional string location_hint = 350519505; * @return string @@ -1023,7 +1426,8 @@ public function clearLocationHint() } /** - * An opaque location hint used to place the disk close to other resources. This field is for use by internal tools that use the public API. + * An opaque location hint used to place the disk close to other resources. + * This field is for use by internal tools that use the public API. * * Generated from protobuf field optional string location_hint = 350519505; * @param string $var @@ -1038,7 +1442,13 @@ public function setLocationHint($var) } /** - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` + * which means the first character must be a lowercase letter, and all + * following characters must be a dash, lowercase letter, or digit, except + * the last character, which cannot be a dash. * * Generated from protobuf field optional string name = 3373707; * @return string @@ -1059,7 +1469,13 @@ public function clearName() } /** - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` + * which means the first character must be a lowercase letter, and all + * following characters must be a dash, lowercase letter, or digit, except + * the last character, which cannot be a dash. * * Generated from protobuf field optional string name = 3373707; * @param string $var @@ -1110,7 +1526,8 @@ public function setOptions($var) } /** - * Input only. [Input Only] Additional params passed with the request, but not persisted as part of resource payload. + * Input only. [Input Only] Additional params passed with the request, but not persisted + * as part of resource payload. * * Generated from protobuf field optional .google.cloud.compute.v1.DiskParams params = 78313862; * @return \Google\Cloud\Compute\V1\DiskParams|null @@ -1131,7 +1548,8 @@ public function clearParams() } /** - * Input only. [Input Only] Additional params passed with the request, but not persisted as part of resource payload. + * Input only. [Input Only] Additional params passed with the request, but not persisted + * as part of resource payload. * * Generated from protobuf field optional .google.cloud.compute.v1.DiskParams params = 78313862; * @param \Google\Cloud\Compute\V1\DiskParams $var @@ -1146,7 +1564,12 @@ public function setParams($var) } /** - * Physical block size of the persistent disk, in bytes. If not present in a request, a default value is used. The currently supported size is 4096, other sizes may be added in the future. If an unsupported value is requested, the error message will list the supported values for the caller's project. + * Physical block size of the persistent disk, in bytes. + * If not present in a request, a default value is used. + * The currently supported size is 4096, other sizes may be added in + * the future. + * If an unsupported value is requested, the error message will list + * the supported values for the caller's project. * * Generated from protobuf field optional int64 physical_block_size_bytes = 420007943; * @return int|string @@ -1167,7 +1590,12 @@ public function clearPhysicalBlockSizeBytes() } /** - * Physical block size of the persistent disk, in bytes. If not present in a request, a default value is used. The currently supported size is 4096, other sizes may be added in the future. If an unsupported value is requested, the error message will list the supported values for the caller's project. + * Physical block size of the persistent disk, in bytes. + * If not present in a request, a default value is used. + * The currently supported size is 4096, other sizes may be added in + * the future. + * If an unsupported value is requested, the error message will list + * the supported values for the caller's project. * * Generated from protobuf field optional int64 physical_block_size_bytes = 420007943; * @param int|string $var @@ -1182,7 +1610,10 @@ public function setPhysicalBlockSizeBytes($var) } /** - * Indicates how many IOPS to provision for the disk. This sets the number of I/O operations per second that the disk can handle. Values must be between 10,000 and 120,000. For more details, see the Extreme persistent disk documentation. + * Indicates how many IOPS to provision for the disk. This sets the number + * of I/O operations per second that the disk can handle. Values must be + * between 10,000 and 120,000. For more details, see theExtreme persistent + * disk documentation. * * Generated from protobuf field optional int64 provisioned_iops = 186769108; * @return int|string @@ -1203,7 +1634,10 @@ public function clearProvisionedIops() } /** - * Indicates how many IOPS to provision for the disk. This sets the number of I/O operations per second that the disk can handle. Values must be between 10,000 and 120,000. For more details, see the Extreme persistent disk documentation. + * Indicates how many IOPS to provision for the disk. This sets the number + * of I/O operations per second that the disk can handle. Values must be + * between 10,000 and 120,000. For more details, see theExtreme persistent + * disk documentation. * * Generated from protobuf field optional int64 provisioned_iops = 186769108; * @param int|string $var @@ -1218,7 +1652,9 @@ public function setProvisionedIops($var) } /** - * Indicates how much throughput to provision for the disk. This sets the number of throughput mb per second that the disk can handle. Values must be greater than or equal to 1. + * Indicates how much throughput to provision for the disk. This sets the + * number of throughput mb per second that the disk can handle. Values must be + * greater than or equal to 1. * * Generated from protobuf field optional int64 provisioned_throughput = 526524181; * @return int|string @@ -1239,7 +1675,9 @@ public function clearProvisionedThroughput() } /** - * Indicates how much throughput to provision for the disk. This sets the number of throughput mb per second that the disk can handle. Values must be greater than or equal to 1. + * Indicates how much throughput to provision for the disk. This sets the + * number of throughput mb per second that the disk can handle. Values must be + * greater than or equal to 1. * * Generated from protobuf field optional int64 provisioned_throughput = 526524181; * @param int|string $var @@ -1254,7 +1692,10 @@ public function setProvisionedThroughput($var) } /** - * [Output Only] URL of the region where the disk resides. Only applicable for regional resources. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * [Output Only] URL of the region where the disk resides. Only applicable for + * regional resources. + * You must specify this field as part of the HTTP request URL. It is + * not settable as a field in the request body. * * Generated from protobuf field optional string region = 138946292; * @return string @@ -1275,7 +1716,10 @@ public function clearRegion() } /** - * [Output Only] URL of the region where the disk resides. Only applicable for regional resources. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * [Output Only] URL of the region where the disk resides. Only applicable for + * regional resources. + * You must specify this field as part of the HTTP request URL. It is + * not settable as a field in the request body. * * Generated from protobuf field optional string region = 138946292; * @param string $var @@ -1290,7 +1734,8 @@ public function setRegion($var) } /** - * URLs of the zones where the disk should be replicated to. Only applicable for regional resources. + * URLs of the zones where the disk should be replicated to. Only applicable + * for regional resources. * * Generated from protobuf field repeated string replica_zones = 48438272; * @return \Google\Protobuf\Internal\RepeatedField @@ -1301,7 +1746,8 @@ public function getReplicaZones() } /** - * URLs of the zones where the disk should be replicated to. Only applicable for regional resources. + * URLs of the zones where the disk should be replicated to. Only applicable + * for regional resources. * * Generated from protobuf field repeated string replica_zones = 48438272; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -1486,7 +1932,12 @@ public function setSelfLink($var) } /** - * Size, in GB, of the persistent disk. You can specify this field when creating a persistent disk using the sourceImage, sourceSnapshot, or sourceDisk parameter, or specify it alone to create an empty persistent disk. If you specify this field along with a source, the value of sizeGb must not be less than the size of the source. Acceptable values are greater than 0. + * Size, in GB, of the persistent disk. You can specify + * this field when creating a persistent disk using thesourceImage, sourceSnapshot, orsourceDisk parameter, or specify it alone to create an empty + * persistent disk. + * If you specify this field along with a source, the value ofsizeGb must not be less than the size of the + * source. + * Acceptable values are greater than 0. * * Generated from protobuf field optional int64 size_gb = 494929369; * @return int|string @@ -1507,7 +1958,12 @@ public function clearSizeGb() } /** - * Size, in GB, of the persistent disk. You can specify this field when creating a persistent disk using the sourceImage, sourceSnapshot, or sourceDisk parameter, or specify it alone to create an empty persistent disk. If you specify this field along with a source, the value of sizeGb must not be less than the size of the source. Acceptable values are greater than 0. + * Size, in GB, of the persistent disk. You can specify + * this field when creating a persistent disk using thesourceImage, sourceSnapshot, orsourceDisk parameter, or specify it alone to create an empty + * persistent disk. + * If you specify this field along with a source, the value ofsizeGb must not be less than the size of the + * source. + * Acceptable values are greater than 0. * * Generated from protobuf field optional int64 size_gb = 494929369; * @param int|string $var @@ -1522,7 +1978,8 @@ public function setSizeGb($var) } /** - * [Output Only] URL of the DiskConsistencyGroupPolicy for a secondary disk that was created using a consistency group. + * [Output Only] URL of the DiskConsistencyGroupPolicy for a secondary disk + * that was created using a consistency group. * * Generated from protobuf field optional string source_consistency_group_policy = 19616093; * @return string @@ -1543,7 +2000,8 @@ public function clearSourceConsistencyGroupPolicy() } /** - * [Output Only] URL of the DiskConsistencyGroupPolicy for a secondary disk that was created using a consistency group. + * [Output Only] URL of the DiskConsistencyGroupPolicy for a secondary disk + * that was created using a consistency group. * * Generated from protobuf field optional string source_consistency_group_policy = 19616093; * @param string $var @@ -1558,7 +2016,8 @@ public function setSourceConsistencyGroupPolicy($var) } /** - * [Output Only] ID of the DiskConsistencyGroupPolicy for a secondary disk that was created using a consistency group. + * [Output Only] ID of the DiskConsistencyGroupPolicy for a secondary disk + * that was created using a consistency group. * * Generated from protobuf field optional string source_consistency_group_policy_id = 267568957; * @return string @@ -1579,7 +2038,8 @@ public function clearSourceConsistencyGroupPolicyId() } /** - * [Output Only] ID of the DiskConsistencyGroupPolicy for a secondary disk that was created using a consistency group. + * [Output Only] ID of the DiskConsistencyGroupPolicy for a secondary disk + * that was created using a consistency group. * * Generated from protobuf field optional string source_consistency_group_policy_id = 267568957; * @param string $var @@ -1594,7 +2054,21 @@ public function setSourceConsistencyGroupPolicyId($var) } /** - * The source disk used to create this disk. You can provide this as a partial or full URL to the resource. For example, the following are valid values: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /disks/disk - https://www.googleapis.com/compute/v1/projects/project/regions/region /disks/disk - projects/project/zones/zone/disks/disk - projects/project/regions/region/disks/disk - zones/zone/disks/disk - regions/region/disks/disk + * The source disk used to create this disk. You can provide this as a + * partial or full URL to the resource. For example, the following are valid + * values: + * - + * https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk + * - + * https://www.googleapis.com/compute/v1/projects/project/regions/region/disks/disk + * - + * projects/project/zones/zone/disks/disk + * - + * projects/project/regions/region/disks/disk + * - + * zones/zone/disks/disk + * - + * regions/region/disks/disk * * Generated from protobuf field optional string source_disk = 451753793; * @return string @@ -1615,7 +2089,21 @@ public function clearSourceDisk() } /** - * The source disk used to create this disk. You can provide this as a partial or full URL to the resource. For example, the following are valid values: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /disks/disk - https://www.googleapis.com/compute/v1/projects/project/regions/region /disks/disk - projects/project/zones/zone/disks/disk - projects/project/regions/region/disks/disk - zones/zone/disks/disk - regions/region/disks/disk + * The source disk used to create this disk. You can provide this as a + * partial or full URL to the resource. For example, the following are valid + * values: + * - + * https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk + * - + * https://www.googleapis.com/compute/v1/projects/project/regions/region/disks/disk + * - + * projects/project/zones/zone/disks/disk + * - + * projects/project/regions/region/disks/disk + * - + * zones/zone/disks/disk + * - + * regions/region/disks/disk * * Generated from protobuf field optional string source_disk = 451753793; * @param string $var @@ -1630,7 +2118,11 @@ public function setSourceDisk($var) } /** - * [Output Only] The unique ID of the disk used to create this disk. This value identifies the exact disk that was used to create this persistent disk. For example, if you created the persistent disk from a disk that was later deleted and recreated under the same name, the source disk ID would identify the exact version of the disk that was used. + * [Output Only] The unique ID of the disk used to create this disk. This + * value identifies the exact disk that was used to create this persistent + * disk. For example, if you created the persistent disk from a disk that + * was later deleted and recreated under the same name, the source disk ID + * would identify the exact version of the disk that was used. * * Generated from protobuf field optional string source_disk_id = 454190809; * @return string @@ -1651,7 +2143,11 @@ public function clearSourceDiskId() } /** - * [Output Only] The unique ID of the disk used to create this disk. This value identifies the exact disk that was used to create this persistent disk. For example, if you created the persistent disk from a disk that was later deleted and recreated under the same name, the source disk ID would identify the exact version of the disk that was used. + * [Output Only] The unique ID of the disk used to create this disk. This + * value identifies the exact disk that was used to create this persistent + * disk. For example, if you created the persistent disk from a disk that + * was later deleted and recreated under the same name, the source disk ID + * would identify the exact version of the disk that was used. * * Generated from protobuf field optional string source_disk_id = 454190809; * @param string $var @@ -1666,7 +2162,20 @@ public function setSourceDiskId($var) } /** - * The source image used to create this disk. If the source image is deleted, this field will not be set. To create a disk with one of the public operating system images, specify the image by its family name. For example, specify family/debian-9 to use the latest Debian 9 image: projects/debian-cloud/global/images/family/debian-9 Alternatively, use a specific version of a public operating system image: projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD To create a disk with a custom image that you created, specify the image name in the following format: global/images/my-custom-image You can also specify a custom image by its image family, which returns the latest version of the image in that family. Replace the image name with family/family-name: global/images/family/my-image-family + * The source image used to create this disk. If the source image is + * deleted, this field will not be set. + * To create a disk with one of the public operating system images, specify + * the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image: + * projects/debian-cloud/global/images/family/debian-9 + * Alternatively, use a specific version of a public operating system image: + * projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD + * To create a disk with a custom image that you created, specify the + * image name in the following format: + * global/images/my-custom-image + * You can also specify a custom image by its image family, which returns + * the latest version of the image in that family. Replace the image name + * with family/family-name: + * global/images/family/my-image-family * * Generated from protobuf field optional string source_image = 50443319; * @return string @@ -1687,7 +2196,20 @@ public function clearSourceImage() } /** - * The source image used to create this disk. If the source image is deleted, this field will not be set. To create a disk with one of the public operating system images, specify the image by its family name. For example, specify family/debian-9 to use the latest Debian 9 image: projects/debian-cloud/global/images/family/debian-9 Alternatively, use a specific version of a public operating system image: projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD To create a disk with a custom image that you created, specify the image name in the following format: global/images/my-custom-image You can also specify a custom image by its image family, which returns the latest version of the image in that family. Replace the image name with family/family-name: global/images/family/my-image-family + * The source image used to create this disk. If the source image is + * deleted, this field will not be set. + * To create a disk with one of the public operating system images, specify + * the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image: + * projects/debian-cloud/global/images/family/debian-9 + * Alternatively, use a specific version of a public operating system image: + * projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD + * To create a disk with a custom image that you created, specify the + * image name in the following format: + * global/images/my-custom-image + * You can also specify a custom image by its image family, which returns + * the latest version of the image in that family. Replace the image name + * with family/family-name: + * global/images/family/my-image-family * * Generated from protobuf field optional string source_image = 50443319; * @param string $var @@ -1702,7 +2224,9 @@ public function setSourceImage($var) } /** - * The customer-supplied encryption key of the source image. Required if the source image is protected by a customer-supplied encryption key. + * Thecustomer-supplied + * encryption key of the source image. Required if the source image is + * protected by a customer-supplied encryption key. * * Generated from protobuf field optional .google.cloud.compute.v1.CustomerEncryptionKey source_image_encryption_key = 381503659; * @return \Google\Cloud\Compute\V1\CustomerEncryptionKey|null @@ -1723,7 +2247,9 @@ public function clearSourceImageEncryptionKey() } /** - * The customer-supplied encryption key of the source image. Required if the source image is protected by a customer-supplied encryption key. + * Thecustomer-supplied + * encryption key of the source image. Required if the source image is + * protected by a customer-supplied encryption key. * * Generated from protobuf field optional .google.cloud.compute.v1.CustomerEncryptionKey source_image_encryption_key = 381503659; * @param \Google\Cloud\Compute\V1\CustomerEncryptionKey $var @@ -1738,7 +2264,11 @@ public function setSourceImageEncryptionKey($var) } /** - * [Output Only] The ID value of the image used to create this disk. This value identifies the exact image that was used to create this persistent disk. For example, if you created the persistent disk from an image that was later deleted and recreated under the same name, the source image ID would identify the exact version of the image that was used. + * [Output Only] The ID value of the image used to create this disk. This + * value identifies the exact image that was used to create this persistent + * disk. For example, if you created the persistent disk from an image that + * was later deleted and recreated under the same name, the source image ID + * would identify the exact version of the image that was used. * * Generated from protobuf field optional string source_image_id = 55328291; * @return string @@ -1759,7 +2289,11 @@ public function clearSourceImageId() } /** - * [Output Only] The ID value of the image used to create this disk. This value identifies the exact image that was used to create this persistent disk. For example, if you created the persistent disk from an image that was later deleted and recreated under the same name, the source image ID would identify the exact version of the image that was used. + * [Output Only] The ID value of the image used to create this disk. This + * value identifies the exact image that was used to create this persistent + * disk. For example, if you created the persistent disk from an image that + * was later deleted and recreated under the same name, the source image ID + * would identify the exact version of the image that was used. * * Generated from protobuf field optional string source_image_id = 55328291; * @param string $var @@ -1774,7 +2308,12 @@ public function setSourceImageId($var) } /** - * The source instant snapshot used to create this disk. You can provide this as a partial or full URL to the resource. For example, the following are valid values: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /instantSnapshots/instantSnapshot - projects/project/zones/zone/instantSnapshots/instantSnapshot - zones/zone/instantSnapshots/instantSnapshot + * The source instant snapshot used to create this disk. You can provide + * this as a partial or full URL to the resource. For example, the following + * are valid values: + * - https://www.googleapis.com/compute/v1/projects/project/zones/zone/instantSnapshots/instantSnapshot + * - projects/project/zones/zone/instantSnapshots/instantSnapshot + * - zones/zone/instantSnapshots/instantSnapshot * * Generated from protobuf field optional string source_instant_snapshot = 219202054; * @return string @@ -1795,7 +2334,12 @@ public function clearSourceInstantSnapshot() } /** - * The source instant snapshot used to create this disk. You can provide this as a partial or full URL to the resource. For example, the following are valid values: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /instantSnapshots/instantSnapshot - projects/project/zones/zone/instantSnapshots/instantSnapshot - zones/zone/instantSnapshots/instantSnapshot + * The source instant snapshot used to create this disk. You can provide + * this as a partial or full URL to the resource. For example, the following + * are valid values: + * - https://www.googleapis.com/compute/v1/projects/project/zones/zone/instantSnapshots/instantSnapshot + * - projects/project/zones/zone/instantSnapshots/instantSnapshot + * - zones/zone/instantSnapshots/instantSnapshot * * Generated from protobuf field optional string source_instant_snapshot = 219202054; * @param string $var @@ -1810,7 +2354,12 @@ public function setSourceInstantSnapshot($var) } /** - * [Output Only] The unique ID of the instant snapshot used to create this disk. This value identifies the exact instant snapshot that was used to create this persistent disk. For example, if you created the persistent disk from an instant snapshot that was later deleted and recreated under the same name, the source instant snapshot ID would identify the exact version of the instant snapshot that was used. + * [Output Only] The unique ID of the instant snapshot used to create this + * disk. This value identifies the exact instant snapshot that was used to + * create this persistent disk. For example, if you created the persistent + * disk from an instant snapshot that was later deleted and recreated under + * the same name, the source instant snapshot ID would identify the exact + * version of the instant snapshot that was used. * * Generated from protobuf field optional string source_instant_snapshot_id = 287582708; * @return string @@ -1831,7 +2380,12 @@ public function clearSourceInstantSnapshotId() } /** - * [Output Only] The unique ID of the instant snapshot used to create this disk. This value identifies the exact instant snapshot that was used to create this persistent disk. For example, if you created the persistent disk from an instant snapshot that was later deleted and recreated under the same name, the source instant snapshot ID would identify the exact version of the instant snapshot that was used. + * [Output Only] The unique ID of the instant snapshot used to create this + * disk. This value identifies the exact instant snapshot that was used to + * create this persistent disk. For example, if you created the persistent + * disk from an instant snapshot that was later deleted and recreated under + * the same name, the source instant snapshot ID would identify the exact + * version of the instant snapshot that was used. * * Generated from protobuf field optional string source_instant_snapshot_id = 287582708; * @param string $var @@ -1846,7 +2400,12 @@ public function setSourceInstantSnapshotId($var) } /** - * The source snapshot used to create this disk. You can provide this as a partial or full URL to the resource. For example, the following are valid values: - https://www.googleapis.com/compute/v1/projects/project /global/snapshots/snapshot - projects/project/global/snapshots/snapshot - global/snapshots/snapshot + * The source snapshot used to create this disk. You can provide this as a + * partial or full URL to the resource. For example, the following are valid + * values: + * - https://www.googleapis.com/compute/v1/projects/project/global/snapshots/snapshot + * - projects/project/global/snapshots/snapshot + * - global/snapshots/snapshot * * Generated from protobuf field optional string source_snapshot = 126061928; * @return string @@ -1867,7 +2426,12 @@ public function clearSourceSnapshot() } /** - * The source snapshot used to create this disk. You can provide this as a partial or full URL to the resource. For example, the following are valid values: - https://www.googleapis.com/compute/v1/projects/project /global/snapshots/snapshot - projects/project/global/snapshots/snapshot - global/snapshots/snapshot + * The source snapshot used to create this disk. You can provide this as a + * partial or full URL to the resource. For example, the following are valid + * values: + * - https://www.googleapis.com/compute/v1/projects/project/global/snapshots/snapshot + * - projects/project/global/snapshots/snapshot + * - global/snapshots/snapshot * * Generated from protobuf field optional string source_snapshot = 126061928; * @param string $var @@ -1882,7 +2446,9 @@ public function setSourceSnapshot($var) } /** - * The customer-supplied encryption key of the source snapshot. Required if the source snapshot is protected by a customer-supplied encryption key. + * Thecustomer-supplied + * encryption key of the source snapshot. Required if the source snapshot + * is protected by a customer-supplied encryption key. * * Generated from protobuf field optional .google.cloud.compute.v1.CustomerEncryptionKey source_snapshot_encryption_key = 303679322; * @return \Google\Cloud\Compute\V1\CustomerEncryptionKey|null @@ -1903,7 +2469,9 @@ public function clearSourceSnapshotEncryptionKey() } /** - * The customer-supplied encryption key of the source snapshot. Required if the source snapshot is protected by a customer-supplied encryption key. + * Thecustomer-supplied + * encryption key of the source snapshot. Required if the source snapshot + * is protected by a customer-supplied encryption key. * * Generated from protobuf field optional .google.cloud.compute.v1.CustomerEncryptionKey source_snapshot_encryption_key = 303679322; * @param \Google\Cloud\Compute\V1\CustomerEncryptionKey $var @@ -1918,7 +2486,11 @@ public function setSourceSnapshotEncryptionKey($var) } /** - * [Output Only] The unique ID of the snapshot used to create this disk. This value identifies the exact snapshot that was used to create this persistent disk. For example, if you created the persistent disk from a snapshot that was later deleted and recreated under the same name, the source snapshot ID would identify the exact version of the snapshot that was used. + * [Output Only] The unique ID of the snapshot used to create this disk. This + * value identifies the exact snapshot that was used to create this persistent + * disk. For example, if you created the persistent disk from a snapshot that + * was later deleted and recreated under the same name, the source snapshot ID + * would identify the exact version of the snapshot that was used. * * Generated from protobuf field optional string source_snapshot_id = 98962258; * @return string @@ -1939,7 +2511,11 @@ public function clearSourceSnapshotId() } /** - * [Output Only] The unique ID of the snapshot used to create this disk. This value identifies the exact snapshot that was used to create this persistent disk. For example, if you created the persistent disk from a snapshot that was later deleted and recreated under the same name, the source snapshot ID would identify the exact version of the snapshot that was used. + * [Output Only] The unique ID of the snapshot used to create this disk. This + * value identifies the exact snapshot that was used to create this persistent + * disk. For example, if you created the persistent disk from a snapshot that + * was later deleted and recreated under the same name, the source snapshot ID + * would identify the exact version of the snapshot that was used. * * Generated from protobuf field optional string source_snapshot_id = 98962258; * @param string $var @@ -1954,7 +2530,13 @@ public function setSourceSnapshotId($var) } /** - * The full Google Cloud Storage URI where the disk image is stored. This file must be a gzip-compressed tarball whose name ends in .tar.gz or virtual machine disk whose name ends in vmdk. Valid URIs may start with gs:// or https://storage.googleapis.com/. This flag is not optimized for creating multiple disks from a source storage object. To create many disks from a source storage object, use gcloud compute images import instead. + * The full Google Cloud Storage URI where the disk image is stored. This file + * must be a gzip-compressed tarball whose name ends in .tar.gz or virtual + * machine disk whose name ends in vmdk. Valid URIs may start with gs:// or + * https://storage.googleapis.com/. This flag is not optimized for creating + * multiple disks from a source storage object. To create many disks from a + * source storage object, use gcloud compute images + * import instead. * * Generated from protobuf field optional string source_storage_object = 233052711; * @return string @@ -1975,7 +2557,13 @@ public function clearSourceStorageObject() } /** - * The full Google Cloud Storage URI where the disk image is stored. This file must be a gzip-compressed tarball whose name ends in .tar.gz or virtual machine disk whose name ends in vmdk. Valid URIs may start with gs:// or https://storage.googleapis.com/. This flag is not optimized for creating multiple disks from a source storage object. To create many disks from a source storage object, use gcloud compute images import instead. + * The full Google Cloud Storage URI where the disk image is stored. This file + * must be a gzip-compressed tarball whose name ends in .tar.gz or virtual + * machine disk whose name ends in vmdk. Valid URIs may start with gs:// or + * https://storage.googleapis.com/. This flag is not optimized for creating + * multiple disks from a source storage object. To create many disks from a + * source storage object, use gcloud compute images + * import instead. * * Generated from protobuf field optional string source_storage_object = 233052711; * @param string $var @@ -1990,7 +2578,13 @@ public function setSourceStorageObject($var) } /** - * [Output Only] The status of disk creation. - CREATING: Disk is provisioning. - RESTORING: Source data is being copied into the disk. - FAILED: Disk creation failed. - READY: Disk is ready for use. - DELETING: Disk is deleting. + * [Output Only] The status of disk creation. + * - CREATING: Disk is provisioning. + * - RESTORING: Source data is being copied into the + * disk. + * - FAILED: Disk creation failed. + * - READY: Disk is ready for use. + * - DELETING: Disk is deleting. * Check the Status enum for the list of possible values. * * Generated from protobuf field optional string status = 181260274; @@ -2012,7 +2606,13 @@ public function clearStatus() } /** - * [Output Only] The status of disk creation. - CREATING: Disk is provisioning. - RESTORING: Source data is being copied into the disk. - FAILED: Disk creation failed. - READY: Disk is ready for use. - DELETING: Disk is deleting. + * [Output Only] The status of disk creation. + * - CREATING: Disk is provisioning. + * - RESTORING: Source data is being copied into the + * disk. + * - FAILED: Disk creation failed. + * - READY: Disk is ready for use. + * - DELETING: Disk is deleting. * Check the Status enum for the list of possible values. * * Generated from protobuf field optional string status = 181260274; @@ -2028,7 +2628,12 @@ public function setStatus($var) } /** - * The storage pool in which the new disk is created. You can provide this as a partial or full URL to the resource. For example, the following are valid values: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /storagePools/storagePool - projects/project/zones/zone/storagePools/storagePool - zones/zone/storagePools/storagePool + * The storage pool in which the new disk is created. You can provide + * this as a partial or full URL to the resource. For example, the following + * are valid values: + * - https://www.googleapis.com/compute/v1/projects/project/zones/zone/storagePools/storagePool + * - projects/project/zones/zone/storagePools/storagePool + * - zones/zone/storagePools/storagePool * * Generated from protobuf field optional string storage_pool = 360473440; * @return string @@ -2049,7 +2654,12 @@ public function clearStoragePool() } /** - * The storage pool in which the new disk is created. You can provide this as a partial or full URL to the resource. For example, the following are valid values: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /storagePools/storagePool - projects/project/zones/zone/storagePools/storagePool - zones/zone/storagePools/storagePool + * The storage pool in which the new disk is created. You can provide + * this as a partial or full URL to the resource. For example, the following + * are valid values: + * - https://www.googleapis.com/compute/v1/projects/project/zones/zone/storagePools/storagePool + * - projects/project/zones/zone/storagePools/storagePool + * - zones/zone/storagePools/storagePool * * Generated from protobuf field optional string storage_pool = 360473440; * @param string $var @@ -2064,7 +2674,9 @@ public function setStoragePool($var) } /** - * URL of the disk type resource describing which disk type to use to create the disk. Provide this when creating the disk. For example: projects/project /zones/zone/diskTypes/pd-ssd . See Persistent disk types. + * URL of the disk type resource describing which disk type to use to create + * the disk. Provide this when creating the disk. For example:projects/project/zones/zone/diskTypes/pd-ssd. See Persistent disk + * types. * * Generated from protobuf field optional string type = 3575610; * @return string @@ -2085,7 +2697,9 @@ public function clearType() } /** - * URL of the disk type resource describing which disk type to use to create the disk. Provide this when creating the disk. For example: projects/project /zones/zone/diskTypes/pd-ssd . See Persistent disk types. + * URL of the disk type resource describing which disk type to use to create + * the disk. Provide this when creating the disk. For example:projects/project/zones/zone/diskTypes/pd-ssd. See Persistent disk + * types. * * Generated from protobuf field optional string type = 3575610; * @param string $var @@ -2100,7 +2714,8 @@ public function setType($var) } /** - * [Output Only] Links to the users of the disk (attached instances) in form: projects/project/zones/zone/instances/instance + * [Output Only] Links to the users of the disk (attached instances) + * in form:projects/project/zones/zone/instances/instance * * Generated from protobuf field repeated string users = 111578632; * @return \Google\Protobuf\Internal\RepeatedField @@ -2111,7 +2726,8 @@ public function getUsers() } /** - * [Output Only] Links to the users of the disk (attached instances) in form: projects/project/zones/zone/instances/instance + * [Output Only] Links to the users of the disk (attached instances) + * in form:projects/project/zones/zone/instances/instance * * Generated from protobuf field repeated string users = 111578632; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -2126,7 +2742,9 @@ public function setUsers($var) } /** - * [Output Only] URL of the zone where the disk resides. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * [Output Only] URL of the zone where the disk resides. + * You must specify this field as part of the HTTP request URL. It is + * not settable as a field in the request body. * * Generated from protobuf field optional string zone = 3744684; * @return string @@ -2147,7 +2765,9 @@ public function clearZone() } /** - * [Output Only] URL of the zone where the disk resides. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * [Output Only] URL of the zone where the disk resides. + * You must specify this field as part of the HTTP request URL. It is + * not settable as a field in the request body. * * Generated from protobuf field optional string zone = 3744684; * @param string $var diff --git a/Compute/src/V1/Disk/AccessMode.php b/Compute/src/V1/Disk/AccessMode.php index 7a814f804326..a4650f9fa79b 100644 --- a/Compute/src/V1/Disk/AccessMode.php +++ b/Compute/src/V1/Disk/AccessMode.php @@ -7,7 +7,14 @@ use UnexpectedValueException; /** - * The access mode of the disk. - READ_WRITE_SINGLE: The default AccessMode, means the disk can be attached to single instance in RW mode. - READ_WRITE_MANY: The AccessMode means the disk can be attached to multiple instances in RW mode. - READ_ONLY_MANY: The AccessMode means the disk can be attached to multiple instances in RO mode. The AccessMode is only valid for Hyperdisk disk types. + * The access mode of the disk. + * - READ_WRITE_SINGLE: The default AccessMode, means the + * disk can be attached to single instance in RW mode. + * - READ_WRITE_MANY: The AccessMode means the disk can be + * attached to multiple instances in RW mode. + * - READ_ONLY_MANY: The AccessMode means the disk can be + * attached to multiple instances in RO mode. + * The AccessMode is only valid for Hyperdisk disk types. * * Protobuf type google.cloud.compute.v1.Disk.AccessMode */ @@ -20,19 +27,22 @@ class AccessMode */ const UNDEFINED_ACCESS_MODE = 0; /** - * The AccessMode means the disk can be attached to multiple instances in RO mode. + * The AccessMode means the disk can be attached to multiple instances in RO + * mode. * * Generated from protobuf enum READ_ONLY_MANY = 63460265; */ const READ_ONLY_MANY = 63460265; /** - * The AccessMode means the disk can be attached to multiple instances in RW mode. + * The AccessMode means the disk can be attached to multiple instances in RW + * mode. * * Generated from protobuf enum READ_WRITE_MANY = 488743208; */ const READ_WRITE_MANY = 488743208; /** - * The default AccessMode, means the disk can be attached to single instance in RW mode. + * The default AccessMode, means the disk can be attached to single instance + * in RW mode. * * Generated from protobuf enum READ_WRITE_SINGLE = 99323089; */ diff --git a/Compute/src/V1/Disk/Architecture.php b/Compute/src/V1/Disk/Architecture.php index 2558644120c0..bf778d28ef99 100644 --- a/Compute/src/V1/Disk/Architecture.php +++ b/Compute/src/V1/Disk/Architecture.php @@ -7,7 +7,8 @@ use UnexpectedValueException; /** - * The architecture of the disk. Valid values are ARM64 or X86_64. + * The architecture of the disk. Valid values are + * ARM64 or X86_64. * * Protobuf type google.cloud.compute.v1.Disk.Architecture */ diff --git a/Compute/src/V1/Disk/Status.php b/Compute/src/V1/Disk/Status.php index fa8cc676520d..f2f1587d158f 100644 --- a/Compute/src/V1/Disk/Status.php +++ b/Compute/src/V1/Disk/Status.php @@ -7,7 +7,13 @@ use UnexpectedValueException; /** - * [Output Only] The status of disk creation. - CREATING: Disk is provisioning. - RESTORING: Source data is being copied into the disk. - FAILED: Disk creation failed. - READY: Disk is ready for use. - DELETING: Disk is deleting. + * [Output Only] The status of disk creation. + * - CREATING: Disk is provisioning. + * - RESTORING: Source data is being copied into the + * disk. + * - FAILED: Disk creation failed. + * - READY: Disk is ready for use. + * - DELETING: Disk is deleting. * * Protobuf type google.cloud.compute.v1.Disk.Status */ @@ -50,7 +56,8 @@ class Status */ const RESTORING = 404263851; /** - * Disk is currently unavailable and cannot be accessed, attached or detached. + * Disk is currently unavailable and cannot be accessed, attached or + * detached. * * Generated from protobuf enum UNAVAILABLE = 413756464; */ diff --git a/Compute/src/V1/DiskAggregatedList.php b/Compute/src/V1/DiskAggregatedList.php index e4f632536f15..0cadd949a729 100644 --- a/Compute/src/V1/DiskAggregatedList.php +++ b/Compute/src/V1/DiskAggregatedList.php @@ -27,13 +27,18 @@ class DiskAggregatedList extends \Google\Protobuf\Internal\Message */ private $items; /** - * [Output Only] Type of resource. Always compute#diskAggregatedList for aggregated lists of persistent disks. + * [Output Only] Type of resource. Alwayscompute#diskAggregatedList for aggregated lists of persistent + * disks. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -68,9 +73,14 @@ class DiskAggregatedList extends \Google\Protobuf\Internal\Message * @type array|\Google\Protobuf\Internal\MapField $items * A list of DisksScopedList resources. * @type string $kind - * [Output Only] Type of resource. Always compute#diskAggregatedList for aggregated lists of persistent disks. + * [Output Only] Type of resource. Alwayscompute#diskAggregatedList for aggregated lists of persistent + * disks. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type array|\Google\Protobuf\Internal\RepeatedField $unreachables @@ -147,7 +157,8 @@ public function setItems($var) } /** - * [Output Only] Type of resource. Always compute#diskAggregatedList for aggregated lists of persistent disks. + * [Output Only] Type of resource. Alwayscompute#diskAggregatedList for aggregated lists of persistent + * disks. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -168,7 +179,8 @@ public function clearKind() } /** - * [Output Only] Type of resource. Always compute#diskAggregatedList for aggregated lists of persistent disks. + * [Output Only] Type of resource. Alwayscompute#diskAggregatedList for aggregated lists of persistent + * disks. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -183,7 +195,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -204,7 +220,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/DiskAsyncReplication.php b/Compute/src/V1/DiskAsyncReplication.php index 342490dc10ad..e3e68e63befa 100644 --- a/Compute/src/V1/DiskAsyncReplication.php +++ b/Compute/src/V1/DiskAsyncReplication.php @@ -15,25 +15,37 @@ class DiskAsyncReplication extends \Google\Protobuf\Internal\Message { /** - * [Output Only] URL of the DiskConsistencyGroupPolicy if replication was started on the disk as a member of a group. + * [Output Only] URL of the DiskConsistencyGroupPolicy if replication was + * started on the disk as a member of a group. * * Generated from protobuf field optional string consistency_group_policy = 1991097; */ protected $consistency_group_policy = null; /** - * [Output Only] ID of the DiskConsistencyGroupPolicy if replication was started on the disk as a member of a group. + * [Output Only] ID of the DiskConsistencyGroupPolicy if replication was + * started on the disk as a member of a group. * * Generated from protobuf field optional string consistency_group_policy_id = 261065057; */ protected $consistency_group_policy_id = null; /** - * The other disk asynchronously replicated to or from the current disk. You can provide this as a partial or full URL to the resource. For example, the following are valid values: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /disks/disk - projects/project/zones/zone/disks/disk - zones/zone/disks/disk + * The other disk asynchronously replicated to or from the current disk. + * You can provide this as a partial or full URL to the resource. + * For example, the following are valid values: + * - https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk + * - projects/project/zones/zone/disks/disk + * - zones/zone/disks/disk * * Generated from protobuf field optional string disk = 3083677; */ protected $disk = null; /** - * [Output Only] The unique ID of the other disk asynchronously replicated to or from the current disk. This value identifies the exact disk that was used to create this replication. For example, if you started replicating the persistent disk from a disk that was later deleted and recreated under the same name, the disk ID would identify the exact version of the disk that was used. + * [Output Only] The unique ID of the other disk asynchronously replicated + * to or from the current disk. This value identifies the exact disk that + * was used to create this replication. For example, if you started + * replicating the persistent disk from a disk that was later deleted and + * recreated under the same name, the disk ID would identify the exact + * version of the disk that was used. * * Generated from protobuf field optional string disk_id = 60990205; */ @@ -46,13 +58,25 @@ class DiskAsyncReplication extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $consistency_group_policy - * [Output Only] URL of the DiskConsistencyGroupPolicy if replication was started on the disk as a member of a group. + * [Output Only] URL of the DiskConsistencyGroupPolicy if replication was + * started on the disk as a member of a group. * @type string $consistency_group_policy_id - * [Output Only] ID of the DiskConsistencyGroupPolicy if replication was started on the disk as a member of a group. + * [Output Only] ID of the DiskConsistencyGroupPolicy if replication was + * started on the disk as a member of a group. * @type string $disk - * The other disk asynchronously replicated to or from the current disk. You can provide this as a partial or full URL to the resource. For example, the following are valid values: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /disks/disk - projects/project/zones/zone/disks/disk - zones/zone/disks/disk + * The other disk asynchronously replicated to or from the current disk. + * You can provide this as a partial or full URL to the resource. + * For example, the following are valid values: + * - https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk + * - projects/project/zones/zone/disks/disk + * - zones/zone/disks/disk * @type string $disk_id - * [Output Only] The unique ID of the other disk asynchronously replicated to or from the current disk. This value identifies the exact disk that was used to create this replication. For example, if you started replicating the persistent disk from a disk that was later deleted and recreated under the same name, the disk ID would identify the exact version of the disk that was used. + * [Output Only] The unique ID of the other disk asynchronously replicated + * to or from the current disk. This value identifies the exact disk that + * was used to create this replication. For example, if you started + * replicating the persistent disk from a disk that was later deleted and + * recreated under the same name, the disk ID would identify the exact + * version of the disk that was used. * } */ public function __construct($data = NULL) { @@ -61,7 +85,8 @@ public function __construct($data = NULL) { } /** - * [Output Only] URL of the DiskConsistencyGroupPolicy if replication was started on the disk as a member of a group. + * [Output Only] URL of the DiskConsistencyGroupPolicy if replication was + * started on the disk as a member of a group. * * Generated from protobuf field optional string consistency_group_policy = 1991097; * @return string @@ -82,7 +107,8 @@ public function clearConsistencyGroupPolicy() } /** - * [Output Only] URL of the DiskConsistencyGroupPolicy if replication was started on the disk as a member of a group. + * [Output Only] URL of the DiskConsistencyGroupPolicy if replication was + * started on the disk as a member of a group. * * Generated from protobuf field optional string consistency_group_policy = 1991097; * @param string $var @@ -97,7 +123,8 @@ public function setConsistencyGroupPolicy($var) } /** - * [Output Only] ID of the DiskConsistencyGroupPolicy if replication was started on the disk as a member of a group. + * [Output Only] ID of the DiskConsistencyGroupPolicy if replication was + * started on the disk as a member of a group. * * Generated from protobuf field optional string consistency_group_policy_id = 261065057; * @return string @@ -118,7 +145,8 @@ public function clearConsistencyGroupPolicyId() } /** - * [Output Only] ID of the DiskConsistencyGroupPolicy if replication was started on the disk as a member of a group. + * [Output Only] ID of the DiskConsistencyGroupPolicy if replication was + * started on the disk as a member of a group. * * Generated from protobuf field optional string consistency_group_policy_id = 261065057; * @param string $var @@ -133,7 +161,12 @@ public function setConsistencyGroupPolicyId($var) } /** - * The other disk asynchronously replicated to or from the current disk. You can provide this as a partial or full URL to the resource. For example, the following are valid values: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /disks/disk - projects/project/zones/zone/disks/disk - zones/zone/disks/disk + * The other disk asynchronously replicated to or from the current disk. + * You can provide this as a partial or full URL to the resource. + * For example, the following are valid values: + * - https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk + * - projects/project/zones/zone/disks/disk + * - zones/zone/disks/disk * * Generated from protobuf field optional string disk = 3083677; * @return string @@ -154,7 +187,12 @@ public function clearDisk() } /** - * The other disk asynchronously replicated to or from the current disk. You can provide this as a partial or full URL to the resource. For example, the following are valid values: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /disks/disk - projects/project/zones/zone/disks/disk - zones/zone/disks/disk + * The other disk asynchronously replicated to or from the current disk. + * You can provide this as a partial or full URL to the resource. + * For example, the following are valid values: + * - https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk + * - projects/project/zones/zone/disks/disk + * - zones/zone/disks/disk * * Generated from protobuf field optional string disk = 3083677; * @param string $var @@ -169,7 +207,12 @@ public function setDisk($var) } /** - * [Output Only] The unique ID of the other disk asynchronously replicated to or from the current disk. This value identifies the exact disk that was used to create this replication. For example, if you started replicating the persistent disk from a disk that was later deleted and recreated under the same name, the disk ID would identify the exact version of the disk that was used. + * [Output Only] The unique ID of the other disk asynchronously replicated + * to or from the current disk. This value identifies the exact disk that + * was used to create this replication. For example, if you started + * replicating the persistent disk from a disk that was later deleted and + * recreated under the same name, the disk ID would identify the exact + * version of the disk that was used. * * Generated from protobuf field optional string disk_id = 60990205; * @return string @@ -190,7 +233,12 @@ public function clearDiskId() } /** - * [Output Only] The unique ID of the other disk asynchronously replicated to or from the current disk. This value identifies the exact disk that was used to create this replication. For example, if you started replicating the persistent disk from a disk that was later deleted and recreated under the same name, the disk ID would identify the exact version of the disk that was used. + * [Output Only] The unique ID of the other disk asynchronously replicated + * to or from the current disk. This value identifies the exact disk that + * was used to create this replication. For example, if you started + * replicating the persistent disk from a disk that was later deleted and + * recreated under the same name, the disk ID would identify the exact + * version of the disk that was used. * * Generated from protobuf field optional string disk_id = 60990205; * @param string $var diff --git a/Compute/src/V1/DiskInstantiationConfig.php b/Compute/src/V1/DiskInstantiationConfig.php index 06de762466a7..4c7ca9cf0b28 100644 --- a/Compute/src/V1/DiskInstantiationConfig.php +++ b/Compute/src/V1/DiskInstantiationConfig.php @@ -9,20 +9,23 @@ use Google\Protobuf\Internal\GPBUtil; /** - * A specification of the desired way to instantiate a disk in the instance template when its created from a source instance. + * A specification of the desired way to instantiate a disk in the instance + * template when its created from a source instance. * * Generated from protobuf message google.cloud.compute.v1.DiskInstantiationConfig */ class DiskInstantiationConfig extends \Google\Protobuf\Internal\Message { /** - * Specifies whether the disk will be auto-deleted when the instance is deleted (but not when the disk is detached from the instance). + * Specifies whether the disk will be auto-deleted when the instance is + * deleted (but not when the disk is detached from the instance). * * Generated from protobuf field optional bool auto_delete = 464761403; */ protected $auto_delete = null; /** - * The custom source image to be used to restore this disk when instantiating this instance template. + * The custom source image to be used to restore this disk when instantiating + * this instance template. * * Generated from protobuf field optional string custom_image = 184123149; */ @@ -34,7 +37,22 @@ class DiskInstantiationConfig extends \Google\Protobuf\Internal\Message */ protected $device_name = null; /** - * Specifies whether to include the disk and what image to use. Possible values are: - source-image: to use the same image that was used to create the source instance's corresponding disk. Applicable to the boot disk and additional read-write disks. - source-image-family: to use the same image family that was used to create the source instance's corresponding disk. Applicable to the boot disk and additional read-write disks. - custom-image: to use a user-provided image url for disk creation. Applicable to the boot disk and additional read-write disks. - attach-read-only: to attach a read-only disk. Applicable to read-only disks. - do-not-include: to exclude a disk from the template. Applicable to additional read-write disks, local SSDs, and read-only disks. + * Specifies whether to include the disk and what image to use. Possible + * values are: + * - source-image: to use the same image that was used to + * create the source instance's corresponding disk. Applicable to the boot + * disk and additional read-write disks. + * - source-image-family: to use the same image family that + * was used to create the source instance's corresponding disk. Applicable + * to the boot disk and additional read-write disks. + * - custom-image: to use a user-provided image url for disk + * creation. Applicable to the boot disk and additional read-write + * disks. + * - attach-read-only: to attach a read-only + * disk. Applicable to read-only disks. + * - do-not-include: to exclude a disk from the template. + * Applicable to additional read-write disks, local SSDs, and read-only + * disks. * Check the InstantiateFrom enum for the list of possible values. * * Generated from protobuf field optional string instantiate_from = 393383903; @@ -48,13 +66,30 @@ class DiskInstantiationConfig extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type bool $auto_delete - * Specifies whether the disk will be auto-deleted when the instance is deleted (but not when the disk is detached from the instance). + * Specifies whether the disk will be auto-deleted when the instance is + * deleted (but not when the disk is detached from the instance). * @type string $custom_image - * The custom source image to be used to restore this disk when instantiating this instance template. + * The custom source image to be used to restore this disk when instantiating + * this instance template. * @type string $device_name * Specifies the device name of the disk to which the configurations apply to. * @type string $instantiate_from - * Specifies whether to include the disk and what image to use. Possible values are: - source-image: to use the same image that was used to create the source instance's corresponding disk. Applicable to the boot disk and additional read-write disks. - source-image-family: to use the same image family that was used to create the source instance's corresponding disk. Applicable to the boot disk and additional read-write disks. - custom-image: to use a user-provided image url for disk creation. Applicable to the boot disk and additional read-write disks. - attach-read-only: to attach a read-only disk. Applicable to read-only disks. - do-not-include: to exclude a disk from the template. Applicable to additional read-write disks, local SSDs, and read-only disks. + * Specifies whether to include the disk and what image to use. Possible + * values are: + * - source-image: to use the same image that was used to + * create the source instance's corresponding disk. Applicable to the boot + * disk and additional read-write disks. + * - source-image-family: to use the same image family that + * was used to create the source instance's corresponding disk. Applicable + * to the boot disk and additional read-write disks. + * - custom-image: to use a user-provided image url for disk + * creation. Applicable to the boot disk and additional read-write + * disks. + * - attach-read-only: to attach a read-only + * disk. Applicable to read-only disks. + * - do-not-include: to exclude a disk from the template. + * Applicable to additional read-write disks, local SSDs, and read-only + * disks. * Check the InstantiateFrom enum for the list of possible values. * } */ @@ -64,7 +99,8 @@ public function __construct($data = NULL) { } /** - * Specifies whether the disk will be auto-deleted when the instance is deleted (but not when the disk is detached from the instance). + * Specifies whether the disk will be auto-deleted when the instance is + * deleted (but not when the disk is detached from the instance). * * Generated from protobuf field optional bool auto_delete = 464761403; * @return bool @@ -85,7 +121,8 @@ public function clearAutoDelete() } /** - * Specifies whether the disk will be auto-deleted when the instance is deleted (but not when the disk is detached from the instance). + * Specifies whether the disk will be auto-deleted when the instance is + * deleted (but not when the disk is detached from the instance). * * Generated from protobuf field optional bool auto_delete = 464761403; * @param bool $var @@ -100,7 +137,8 @@ public function setAutoDelete($var) } /** - * The custom source image to be used to restore this disk when instantiating this instance template. + * The custom source image to be used to restore this disk when instantiating + * this instance template. * * Generated from protobuf field optional string custom_image = 184123149; * @return string @@ -121,7 +159,8 @@ public function clearCustomImage() } /** - * The custom source image to be used to restore this disk when instantiating this instance template. + * The custom source image to be used to restore this disk when instantiating + * this instance template. * * Generated from protobuf field optional string custom_image = 184123149; * @param string $var @@ -172,7 +211,22 @@ public function setDeviceName($var) } /** - * Specifies whether to include the disk and what image to use. Possible values are: - source-image: to use the same image that was used to create the source instance's corresponding disk. Applicable to the boot disk and additional read-write disks. - source-image-family: to use the same image family that was used to create the source instance's corresponding disk. Applicable to the boot disk and additional read-write disks. - custom-image: to use a user-provided image url for disk creation. Applicable to the boot disk and additional read-write disks. - attach-read-only: to attach a read-only disk. Applicable to read-only disks. - do-not-include: to exclude a disk from the template. Applicable to additional read-write disks, local SSDs, and read-only disks. + * Specifies whether to include the disk and what image to use. Possible + * values are: + * - source-image: to use the same image that was used to + * create the source instance's corresponding disk. Applicable to the boot + * disk and additional read-write disks. + * - source-image-family: to use the same image family that + * was used to create the source instance's corresponding disk. Applicable + * to the boot disk and additional read-write disks. + * - custom-image: to use a user-provided image url for disk + * creation. Applicable to the boot disk and additional read-write + * disks. + * - attach-read-only: to attach a read-only + * disk. Applicable to read-only disks. + * - do-not-include: to exclude a disk from the template. + * Applicable to additional read-write disks, local SSDs, and read-only + * disks. * Check the InstantiateFrom enum for the list of possible values. * * Generated from protobuf field optional string instantiate_from = 393383903; @@ -194,7 +248,22 @@ public function clearInstantiateFrom() } /** - * Specifies whether to include the disk and what image to use. Possible values are: - source-image: to use the same image that was used to create the source instance's corresponding disk. Applicable to the boot disk and additional read-write disks. - source-image-family: to use the same image family that was used to create the source instance's corresponding disk. Applicable to the boot disk and additional read-write disks. - custom-image: to use a user-provided image url for disk creation. Applicable to the boot disk and additional read-write disks. - attach-read-only: to attach a read-only disk. Applicable to read-only disks. - do-not-include: to exclude a disk from the template. Applicable to additional read-write disks, local SSDs, and read-only disks. + * Specifies whether to include the disk and what image to use. Possible + * values are: + * - source-image: to use the same image that was used to + * create the source instance's corresponding disk. Applicable to the boot + * disk and additional read-write disks. + * - source-image-family: to use the same image family that + * was used to create the source instance's corresponding disk. Applicable + * to the boot disk and additional read-write disks. + * - custom-image: to use a user-provided image url for disk + * creation. Applicable to the boot disk and additional read-write + * disks. + * - attach-read-only: to attach a read-only + * disk. Applicable to read-only disks. + * - do-not-include: to exclude a disk from the template. + * Applicable to additional read-write disks, local SSDs, and read-only + * disks. * Check the InstantiateFrom enum for the list of possible values. * * Generated from protobuf field optional string instantiate_from = 393383903; diff --git a/Compute/src/V1/DiskInstantiationConfig/InstantiateFrom.php b/Compute/src/V1/DiskInstantiationConfig/InstantiateFrom.php index af4a62a03587..bad9c193a802 100644 --- a/Compute/src/V1/DiskInstantiationConfig/InstantiateFrom.php +++ b/Compute/src/V1/DiskInstantiationConfig/InstantiateFrom.php @@ -7,7 +7,22 @@ use UnexpectedValueException; /** - * Specifies whether to include the disk and what image to use. Possible values are: - source-image: to use the same image that was used to create the source instance's corresponding disk. Applicable to the boot disk and additional read-write disks. - source-image-family: to use the same image family that was used to create the source instance's corresponding disk. Applicable to the boot disk and additional read-write disks. - custom-image: to use a user-provided image url for disk creation. Applicable to the boot disk and additional read-write disks. - attach-read-only: to attach a read-only disk. Applicable to read-only disks. - do-not-include: to exclude a disk from the template. Applicable to additional read-write disks, local SSDs, and read-only disks. + * Specifies whether to include the disk and what image to use. Possible + * values are: + * - source-image: to use the same image that was used to + * create the source instance's corresponding disk. Applicable to the boot + * disk and additional read-write disks. + * - source-image-family: to use the same image family that + * was used to create the source instance's corresponding disk. Applicable + * to the boot disk and additional read-write disks. + * - custom-image: to use a user-provided image url for disk + * creation. Applicable to the boot disk and additional read-write + * disks. + * - attach-read-only: to attach a read-only + * disk. Applicable to read-only disks. + * - do-not-include: to exclude a disk from the template. + * Applicable to additional read-write disks, local SSDs, and read-only + * disks. * * Protobuf type google.cloud.compute.v1.DiskInstantiationConfig.InstantiateFrom */ @@ -20,43 +35,57 @@ class InstantiateFrom */ const UNDEFINED_INSTANTIATE_FROM = 0; /** - * Attach the existing disk in read-only mode. The request will fail if the disk was attached in read-write mode on the source instance. Applicable to: read-only disks. + * Attach the existing disk in read-only mode. The request will fail if the + * disk was attached in read-write mode on the source instance. Applicable + * to: read-only disks. * * Generated from protobuf enum ATTACH_READ_ONLY = 513775419; */ const ATTACH_READ_ONLY = 513775419; /** - * Create a blank disk. The disk will be created unformatted. Applicable to: additional read-write disks, local SSDs. + * Create a blank disk. The disk will be created unformatted. Applicable to: + * additional read-write disks, local SSDs. * * Generated from protobuf enum BLANK = 63281460; */ const BLANK = 63281460; /** - * Use the custom image specified in the custom_image field. Applicable to: boot disk, additional read-write disks. + * Use the custom image specified in the custom_image field. Applicable to: + * boot disk, additional read-write disks. * * Generated from protobuf enum CUSTOM_IMAGE = 196311789; */ const CUSTOM_IMAGE = 196311789; /** - * Use the default instantiation option for the corresponding type of disk. For boot disk and any other R/W disks, new custom images will be created from each disk. For read-only disks, they will be attached in read-only mode. Local SSD disks will be created as blank volumes. + * Use the default instantiation option for the corresponding type of disk. + * For boot disk and any other R/W disks, new custom images will be created + * from each disk. For read-only disks, they will be attached in read-only + * mode. Local SSD disks will be created as blank volumes. * * Generated from protobuf enum DEFAULT = 115302945; */ const PBDEFAULT = 115302945; /** - * Do not include the disk in the instance template. Applicable to: additional read-write disks, local SSDs, read-only disks. + * Do not include the disk in the instance template. Applicable to: + * additional read-write disks, local SSDs, read-only disks. * * Generated from protobuf enum DO_NOT_INCLUDE = 104218952; */ const DO_NOT_INCLUDE = 104218952; /** - * Use the same source image used for creation of the source instance's corresponding disk. The request will fail if the source VM's disk was created from a snapshot. Applicable to: boot disk, additional read-write disks. + * Use the same source image used for creation of the source instance's + * corresponding disk. The request will fail if the source VM's disk was + * created from a snapshot. Applicable to: boot disk, additional read-write + * disks. * * Generated from protobuf enum SOURCE_IMAGE = 62631959; */ const SOURCE_IMAGE = 62631959; /** - * Use the same source image family used for creation of the source instance's corresponding disk. The request will fail if the source image of the source disk does not belong to any image family. Applicable to: boot disk, additional read-write disks. + * Use the same source image family used for creation of the source + * instance's corresponding disk. The request will fail if the source image + * of the source disk does not belong to any image family. Applicable to: + * boot disk, additional read-write disks. * * Generated from protobuf enum SOURCE_IMAGE_FAMILY = 76850316; */ diff --git a/Compute/src/V1/DiskList.php b/Compute/src/V1/DiskList.php index abfde790a352..32bda87cda1b 100644 --- a/Compute/src/V1/DiskList.php +++ b/Compute/src/V1/DiskList.php @@ -28,13 +28,18 @@ class DiskList extends \Google\Protobuf\Internal\Message */ private $items; /** - * [Output Only] Type of resource. Always compute#diskList for lists of disks. + * [Output Only] Type of resource. Always compute#diskList for + * lists of disks. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -63,9 +68,14 @@ class DiskList extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\Disk>|\Google\Protobuf\Internal\RepeatedField $items * A list of Disk resources. * @type string $kind - * [Output Only] Type of resource. Always compute#diskList for lists of disks. + * [Output Only] Type of resource. Always compute#diskList for + * lists of disks. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type \Google\Cloud\Compute\V1\Warning $warning @@ -140,7 +150,8 @@ public function setItems($var) } /** - * [Output Only] Type of resource. Always compute#diskList for lists of disks. + * [Output Only] Type of resource. Always compute#diskList for + * lists of disks. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -161,7 +172,8 @@ public function clearKind() } /** - * [Output Only] Type of resource. Always compute#diskList for lists of disks. + * [Output Only] Type of resource. Always compute#diskList for + * lists of disks. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -176,7 +188,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -197,7 +213,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/DiskMoveRequest.php b/Compute/src/V1/DiskMoveRequest.php index af83a7deeb58..c08e90714aa8 100644 --- a/Compute/src/V1/DiskMoveRequest.php +++ b/Compute/src/V1/DiskMoveRequest.php @@ -15,13 +15,21 @@ class DiskMoveRequest extends \Google\Protobuf\Internal\Message { /** - * The URL of the destination zone to move the disk. This can be a full or partial URL. For example, the following are all valid URLs to a zone: - https://www.googleapis.com/compute/v1/projects/project/zones/zone - projects/project/zones/zone - zones/zone + * The URL of the destination zone to move the disk. This can be a full or + * partial URL. For example, the following are all valid URLs to a zone: + * - https://www.googleapis.com/compute/v1/projects/project/zones/zone + * - projects/project/zones/zone + * - zones/zone * * Generated from protobuf field optional string destination_zone = 131854653; */ protected $destination_zone = null; /** - * The URL of the target disk to move. This can be a full or partial URL. For example, the following are all valid URLs to a disk: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /disks/disk - projects/project/zones/zone/disks/disk - zones/zone/disks/disk + * The URL of the target disk to move. This can be a full or partial URL. + * For example, the following are all valid URLs to a disk: + * - https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk + * - projects/project/zones/zone/disks/disk + * - zones/zone/disks/disk * * Generated from protobuf field optional string target_disk = 62433163; */ @@ -34,9 +42,17 @@ class DiskMoveRequest extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $destination_zone - * The URL of the destination zone to move the disk. This can be a full or partial URL. For example, the following are all valid URLs to a zone: - https://www.googleapis.com/compute/v1/projects/project/zones/zone - projects/project/zones/zone - zones/zone + * The URL of the destination zone to move the disk. This can be a full or + * partial URL. For example, the following are all valid URLs to a zone: + * - https://www.googleapis.com/compute/v1/projects/project/zones/zone + * - projects/project/zones/zone + * - zones/zone * @type string $target_disk - * The URL of the target disk to move. This can be a full or partial URL. For example, the following are all valid URLs to a disk: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /disks/disk - projects/project/zones/zone/disks/disk - zones/zone/disks/disk + * The URL of the target disk to move. This can be a full or partial URL. + * For example, the following are all valid URLs to a disk: + * - https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk + * - projects/project/zones/zone/disks/disk + * - zones/zone/disks/disk * } */ public function __construct($data = NULL) { @@ -45,7 +61,11 @@ public function __construct($data = NULL) { } /** - * The URL of the destination zone to move the disk. This can be a full or partial URL. For example, the following are all valid URLs to a zone: - https://www.googleapis.com/compute/v1/projects/project/zones/zone - projects/project/zones/zone - zones/zone + * The URL of the destination zone to move the disk. This can be a full or + * partial URL. For example, the following are all valid URLs to a zone: + * - https://www.googleapis.com/compute/v1/projects/project/zones/zone + * - projects/project/zones/zone + * - zones/zone * * Generated from protobuf field optional string destination_zone = 131854653; * @return string @@ -66,7 +86,11 @@ public function clearDestinationZone() } /** - * The URL of the destination zone to move the disk. This can be a full or partial URL. For example, the following are all valid URLs to a zone: - https://www.googleapis.com/compute/v1/projects/project/zones/zone - projects/project/zones/zone - zones/zone + * The URL of the destination zone to move the disk. This can be a full or + * partial URL. For example, the following are all valid URLs to a zone: + * - https://www.googleapis.com/compute/v1/projects/project/zones/zone + * - projects/project/zones/zone + * - zones/zone * * Generated from protobuf field optional string destination_zone = 131854653; * @param string $var @@ -81,7 +105,11 @@ public function setDestinationZone($var) } /** - * The URL of the target disk to move. This can be a full or partial URL. For example, the following are all valid URLs to a disk: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /disks/disk - projects/project/zones/zone/disks/disk - zones/zone/disks/disk + * The URL of the target disk to move. This can be a full or partial URL. + * For example, the following are all valid URLs to a disk: + * - https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk + * - projects/project/zones/zone/disks/disk + * - zones/zone/disks/disk * * Generated from protobuf field optional string target_disk = 62433163; * @return string @@ -102,7 +130,11 @@ public function clearTargetDisk() } /** - * The URL of the target disk to move. This can be a full or partial URL. For example, the following are all valid URLs to a disk: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /disks/disk - projects/project/zones/zone/disks/disk - zones/zone/disks/disk + * The URL of the target disk to move. This can be a full or partial URL. + * For example, the following are all valid URLs to a disk: + * - https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk + * - projects/project/zones/zone/disks/disk + * - zones/zone/disks/disk * * Generated from protobuf field optional string target_disk = 62433163; * @param string $var diff --git a/Compute/src/V1/DiskParams.php b/Compute/src/V1/DiskParams.php index 97e4b936d581..3a1c19bb2916 100644 --- a/Compute/src/V1/DiskParams.php +++ b/Compute/src/V1/DiskParams.php @@ -16,7 +16,11 @@ class DiskParams extends \Google\Protobuf\Internal\Message { /** - * Resource manager tags to be bound to the disk. Tag keys and values have the same definition as resource manager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and values are in the format `tagValues/456`. The field is ignored (both PUT & PATCH) when empty. + * Resource manager tags to be bound to the disk. Tag keys and values + * have the same definition as resource + * manager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and + * values are in the format `tagValues/456`. The field is ignored (both PUT & + * PATCH) when empty. * * Generated from protobuf field map resource_manager_tags = 377671164; */ @@ -29,7 +33,11 @@ class DiskParams extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type array|\Google\Protobuf\Internal\MapField $resource_manager_tags - * Resource manager tags to be bound to the disk. Tag keys and values have the same definition as resource manager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and values are in the format `tagValues/456`. The field is ignored (both PUT & PATCH) when empty. + * Resource manager tags to be bound to the disk. Tag keys and values + * have the same definition as resource + * manager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and + * values are in the format `tagValues/456`. The field is ignored (both PUT & + * PATCH) when empty. * } */ public function __construct($data = NULL) { @@ -38,7 +46,11 @@ public function __construct($data = NULL) { } /** - * Resource manager tags to be bound to the disk. Tag keys and values have the same definition as resource manager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and values are in the format `tagValues/456`. The field is ignored (both PUT & PATCH) when empty. + * Resource manager tags to be bound to the disk. Tag keys and values + * have the same definition as resource + * manager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and + * values are in the format `tagValues/456`. The field is ignored (both PUT & + * PATCH) when empty. * * Generated from protobuf field map resource_manager_tags = 377671164; * @return \Google\Protobuf\Internal\MapField @@ -49,7 +61,11 @@ public function getResourceManagerTags() } /** - * Resource manager tags to be bound to the disk. Tag keys and values have the same definition as resource manager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and values are in the format `tagValues/456`. The field is ignored (both PUT & PATCH) when empty. + * Resource manager tags to be bound to the disk. Tag keys and values + * have the same definition as resource + * manager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and + * values are in the format `tagValues/456`. The field is ignored (both PUT & + * PATCH) when empty. * * Generated from protobuf field map resource_manager_tags = 377671164; * @param array|\Google\Protobuf\Internal\MapField $var diff --git a/Compute/src/V1/DiskType.php b/Compute/src/V1/DiskType.php index 792708a0ed1c..eb6d9a206832 100644 --- a/Compute/src/V1/DiskType.php +++ b/Compute/src/V1/DiskType.php @@ -9,14 +9,25 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Represents a Disk Type resource. Google Compute Engine has two Disk Type resources: * [Regional](/compute/docs/reference/rest/v1/regionDiskTypes) * [Zonal](/compute/docs/reference/rest/v1/diskTypes) You can choose from a variety of disk types based on your needs. For more information, read Storage options. The diskTypes resource represents disk types for a zonal persistent disk. For more information, read Zonal persistent disks. The regionDiskTypes resource represents disk types for a regional persistent disk. For more information, read Regional persistent disks. + * Represents a Disk Type resource. + * Google Compute Engine has two Disk Type resources: + * * [Regional](/compute/docs/reference/rest/v1/regionDiskTypes) + * * [Zonal](/compute/docs/reference/rest/v1/diskTypes) + * You can choose from a variety of disk types based on your needs. + * For more information, readStorage options. + * The diskTypes resource represents disk types for a zonal + * persistent disk. + * For more information, readZonal persistent disks. + * The regionDiskTypes resource represents disk types for a + * regional persistent disk. For more information, read Regional persistent disks. * * Generated from protobuf message google.cloud.compute.v1.DiskType */ class DiskType extends \Google\Protobuf\Internal\Message { /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; */ @@ -40,13 +51,15 @@ class DiskType extends \Google\Protobuf\Internal\Message */ protected $description = null; /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; */ protected $id = null; /** - * [Output Only] Type of the resource. Always compute#diskType for disk types. + * [Output Only] Type of the resource. Always compute#diskType + * for disk types. * * Generated from protobuf field optional string kind = 3292052; */ @@ -58,7 +71,10 @@ class DiskType extends \Google\Protobuf\Internal\Message */ protected $name = null; /** - * [Output Only] URL of the region where the disk type resides. Only applicable for regional resources. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * [Output Only] URL of the region where the disk type resides. Only + * applicable for regional resources. + * You must specify this field as part of the HTTP request URL. It is + * not settable as a field in the request body. * * Generated from protobuf field optional string region = 138946292; */ @@ -70,13 +86,16 @@ class DiskType extends \Google\Protobuf\Internal\Message */ protected $self_link = null; /** - * [Output Only] An optional textual description of the valid disk size, such as "10GB-10TB". + * [Output Only] An optional textual description of the valid disk size, + * such as "10GB-10TB". * * Generated from protobuf field optional string valid_disk_size = 493962464; */ protected $valid_disk_size = null; /** - * [Output Only] URL of the zone where the disk type resides. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * [Output Only] URL of the zone where the disk type resides. + * You must specify this field as part of the HTTP request URL. It is + * not settable as a field in the request body. * * Generated from protobuf field optional string zone = 3744684; */ @@ -89,7 +108,8 @@ class DiskType extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $creation_timestamp - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * @type int|string $default_disk_size_gb * [Output Only] Server-defined default disk size in GB. * @type \Google\Cloud\Compute\V1\DeprecationStatus $deprecated @@ -97,19 +117,27 @@ class DiskType extends \Google\Protobuf\Internal\Message * @type string $description * [Output Only] An optional description of this resource. * @type int|string $id - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * @type string $kind - * [Output Only] Type of the resource. Always compute#diskType for disk types. + * [Output Only] Type of the resource. Always compute#diskType + * for disk types. * @type string $name * [Output Only] Name of the resource. * @type string $region - * [Output Only] URL of the region where the disk type resides. Only applicable for regional resources. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * [Output Only] URL of the region where the disk type resides. Only + * applicable for regional resources. + * You must specify this field as part of the HTTP request URL. It is + * not settable as a field in the request body. * @type string $self_link * [Output Only] Server-defined URL for the resource. * @type string $valid_disk_size - * [Output Only] An optional textual description of the valid disk size, such as "10GB-10TB". + * [Output Only] An optional textual description of the valid disk size, + * such as "10GB-10TB". * @type string $zone - * [Output Only] URL of the zone where the disk type resides. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * [Output Only] URL of the zone where the disk type resides. + * You must specify this field as part of the HTTP request URL. It is + * not settable as a field in the request body. * } */ public function __construct($data = NULL) { @@ -118,7 +146,8 @@ public function __construct($data = NULL) { } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @return string @@ -139,7 +168,8 @@ public function clearCreationTimestamp() } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @param string $var @@ -262,7 +292,8 @@ public function setDescription($var) } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @return int|string @@ -283,7 +314,8 @@ public function clearId() } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @param int|string $var @@ -298,7 +330,8 @@ public function setId($var) } /** - * [Output Only] Type of the resource. Always compute#diskType for disk types. + * [Output Only] Type of the resource. Always compute#diskType + * for disk types. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -319,7 +352,8 @@ public function clearKind() } /** - * [Output Only] Type of the resource. Always compute#diskType for disk types. + * [Output Only] Type of the resource. Always compute#diskType + * for disk types. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -370,7 +404,10 @@ public function setName($var) } /** - * [Output Only] URL of the region where the disk type resides. Only applicable for regional resources. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * [Output Only] URL of the region where the disk type resides. Only + * applicable for regional resources. + * You must specify this field as part of the HTTP request URL. It is + * not settable as a field in the request body. * * Generated from protobuf field optional string region = 138946292; * @return string @@ -391,7 +428,10 @@ public function clearRegion() } /** - * [Output Only] URL of the region where the disk type resides. Only applicable for regional resources. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * [Output Only] URL of the region where the disk type resides. Only + * applicable for regional resources. + * You must specify this field as part of the HTTP request URL. It is + * not settable as a field in the request body. * * Generated from protobuf field optional string region = 138946292; * @param string $var @@ -442,7 +482,8 @@ public function setSelfLink($var) } /** - * [Output Only] An optional textual description of the valid disk size, such as "10GB-10TB". + * [Output Only] An optional textual description of the valid disk size, + * such as "10GB-10TB". * * Generated from protobuf field optional string valid_disk_size = 493962464; * @return string @@ -463,7 +504,8 @@ public function clearValidDiskSize() } /** - * [Output Only] An optional textual description of the valid disk size, such as "10GB-10TB". + * [Output Only] An optional textual description of the valid disk size, + * such as "10GB-10TB". * * Generated from protobuf field optional string valid_disk_size = 493962464; * @param string $var @@ -478,7 +520,9 @@ public function setValidDiskSize($var) } /** - * [Output Only] URL of the zone where the disk type resides. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * [Output Only] URL of the zone where the disk type resides. + * You must specify this field as part of the HTTP request URL. It is + * not settable as a field in the request body. * * Generated from protobuf field optional string zone = 3744684; * @return string @@ -499,7 +543,9 @@ public function clearZone() } /** - * [Output Only] URL of the zone where the disk type resides. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * [Output Only] URL of the zone where the disk type resides. + * You must specify this field as part of the HTTP request URL. It is + * not settable as a field in the request body. * * Generated from protobuf field optional string zone = 3744684; * @param string $var diff --git a/Compute/src/V1/DiskTypeAggregatedList.php b/Compute/src/V1/DiskTypeAggregatedList.php index 2599645a3cb1..47d0769c3207 100644 --- a/Compute/src/V1/DiskTypeAggregatedList.php +++ b/Compute/src/V1/DiskTypeAggregatedList.php @@ -27,13 +27,17 @@ class DiskTypeAggregatedList extends \Google\Protobuf\Internal\Message */ private $items; /** - * [Output Only] Type of resource. Always compute#diskTypeAggregatedList. + * [Output Only] Type of resource. Alwayscompute#diskTypeAggregatedList. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -68,9 +72,13 @@ class DiskTypeAggregatedList extends \Google\Protobuf\Internal\Message * @type array|\Google\Protobuf\Internal\MapField $items * A list of DiskTypesScopedList resources. * @type string $kind - * [Output Only] Type of resource. Always compute#diskTypeAggregatedList. + * [Output Only] Type of resource. Alwayscompute#diskTypeAggregatedList. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type array|\Google\Protobuf\Internal\RepeatedField $unreachables @@ -147,7 +155,7 @@ public function setItems($var) } /** - * [Output Only] Type of resource. Always compute#diskTypeAggregatedList. + * [Output Only] Type of resource. Alwayscompute#diskTypeAggregatedList. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -168,7 +176,7 @@ public function clearKind() } /** - * [Output Only] Type of resource. Always compute#diskTypeAggregatedList. + * [Output Only] Type of resource. Alwayscompute#diskTypeAggregatedList. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -183,7 +191,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -204,7 +216,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/DiskTypeList.php b/Compute/src/V1/DiskTypeList.php index d5c6cda8a6dc..719c88d15c4f 100644 --- a/Compute/src/V1/DiskTypeList.php +++ b/Compute/src/V1/DiskTypeList.php @@ -28,13 +28,18 @@ class DiskTypeList extends \Google\Protobuf\Internal\Message */ private $items; /** - * [Output Only] Type of resource. Always compute#diskTypeList for disk types. + * [Output Only] Type of resource. Always compute#diskTypeList + * for disk types. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -63,9 +68,14 @@ class DiskTypeList extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\DiskType>|\Google\Protobuf\Internal\RepeatedField $items * A list of DiskType resources. * @type string $kind - * [Output Only] Type of resource. Always compute#diskTypeList for disk types. + * [Output Only] Type of resource. Always compute#diskTypeList + * for disk types. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type \Google\Cloud\Compute\V1\Warning $warning @@ -140,7 +150,8 @@ public function setItems($var) } /** - * [Output Only] Type of resource. Always compute#diskTypeList for disk types. + * [Output Only] Type of resource. Always compute#diskTypeList + * for disk types. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -161,7 +172,8 @@ public function clearKind() } /** - * [Output Only] Type of resource. Always compute#diskTypeList for disk types. + * [Output Only] Type of resource. Always compute#diskTypeList + * for disk types. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -176,7 +188,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -197,7 +213,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/DiskTypesScopedList.php b/Compute/src/V1/DiskTypesScopedList.php index 811b02178a60..c387f9ef78a0 100644 --- a/Compute/src/V1/DiskTypesScopedList.php +++ b/Compute/src/V1/DiskTypesScopedList.php @@ -21,7 +21,8 @@ class DiskTypesScopedList extends \Google\Protobuf\Internal\Message */ private $disk_types; /** - * [Output Only] Informational warning which replaces the list of disk types when the list is empty. + * [Output Only] Informational warning which replaces the list of disk types + * when the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; */ @@ -36,7 +37,8 @@ class DiskTypesScopedList extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\DiskType>|\Google\Protobuf\Internal\RepeatedField $disk_types * [Output Only] A list of disk types contained in this scope. * @type \Google\Cloud\Compute\V1\Warning $warning - * [Output Only] Informational warning which replaces the list of disk types when the list is empty. + * [Output Only] Informational warning which replaces the list of disk types + * when the list is empty. * } */ public function __construct($data = NULL) { @@ -71,7 +73,8 @@ public function setDiskTypes($var) } /** - * [Output Only] Informational warning which replaces the list of disk types when the list is empty. + * [Output Only] Informational warning which replaces the list of disk types + * when the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; * @return \Google\Cloud\Compute\V1\Warning|null @@ -92,7 +95,8 @@ public function clearWarning() } /** - * [Output Only] Informational warning which replaces the list of disk types when the list is empty. + * [Output Only] Informational warning which replaces the list of disk types + * when the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; * @param \Google\Cloud\Compute\V1\Warning $var diff --git a/Compute/src/V1/DisksAddResourcePoliciesRequest.php b/Compute/src/V1/DisksAddResourcePoliciesRequest.php index 4f1754df2537..96f0b8c3dc42 100644 --- a/Compute/src/V1/DisksAddResourcePoliciesRequest.php +++ b/Compute/src/V1/DisksAddResourcePoliciesRequest.php @@ -15,7 +15,8 @@ class DisksAddResourcePoliciesRequest extends \Google\Protobuf\Internal\Message { /** - * Full or relative path to the resource policy to be added to this disk. You can only specify one resource policy. + * Full or relative path to the resource policy to be added to this disk. You + * can only specify one resource policy. * * Generated from protobuf field repeated string resource_policies = 22220385; */ @@ -28,7 +29,8 @@ class DisksAddResourcePoliciesRequest extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type array|\Google\Protobuf\Internal\RepeatedField $resource_policies - * Full or relative path to the resource policy to be added to this disk. You can only specify one resource policy. + * Full or relative path to the resource policy to be added to this disk. You + * can only specify one resource policy. * } */ public function __construct($data = NULL) { @@ -37,7 +39,8 @@ public function __construct($data = NULL) { } /** - * Full or relative path to the resource policy to be added to this disk. You can only specify one resource policy. + * Full or relative path to the resource policy to be added to this disk. You + * can only specify one resource policy. * * Generated from protobuf field repeated string resource_policies = 22220385; * @return \Google\Protobuf\Internal\RepeatedField @@ -48,7 +51,8 @@ public function getResourcePolicies() } /** - * Full or relative path to the resource policy to be added to this disk. You can only specify one resource policy. + * Full or relative path to the resource policy to be added to this disk. You + * can only specify one resource policy. * * Generated from protobuf field repeated string resource_policies = 22220385; * @param array|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/DisksScopedList.php b/Compute/src/V1/DisksScopedList.php index a819d3cd5e4c..acf09ff85725 100644 --- a/Compute/src/V1/DisksScopedList.php +++ b/Compute/src/V1/DisksScopedList.php @@ -21,7 +21,8 @@ class DisksScopedList extends \Google\Protobuf\Internal\Message */ private $disks; /** - * [Output Only] Informational warning which replaces the list of disks when the list is empty. + * [Output Only] Informational warning which replaces the list of disks when + * the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; */ @@ -36,7 +37,8 @@ class DisksScopedList extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\Disk>|\Google\Protobuf\Internal\RepeatedField $disks * [Output Only] A list of disks contained in this scope. * @type \Google\Cloud\Compute\V1\Warning $warning - * [Output Only] Informational warning which replaces the list of disks when the list is empty. + * [Output Only] Informational warning which replaces the list of disks when + * the list is empty. * } */ public function __construct($data = NULL) { @@ -71,7 +73,8 @@ public function setDisks($var) } /** - * [Output Only] Informational warning which replaces the list of disks when the list is empty. + * [Output Only] Informational warning which replaces the list of disks when + * the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; * @return \Google\Cloud\Compute\V1\Warning|null @@ -92,7 +95,8 @@ public function clearWarning() } /** - * [Output Only] Informational warning which replaces the list of disks when the list is empty. + * [Output Only] Informational warning which replaces the list of disks when + * the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; * @param \Google\Cloud\Compute\V1\Warning $var diff --git a/Compute/src/V1/DisksStartAsyncReplicationRequest.php b/Compute/src/V1/DisksStartAsyncReplicationRequest.php index ad5447020182..71ec7ab13219 100644 --- a/Compute/src/V1/DisksStartAsyncReplicationRequest.php +++ b/Compute/src/V1/DisksStartAsyncReplicationRequest.php @@ -15,7 +15,21 @@ class DisksStartAsyncReplicationRequest extends \Google\Protobuf\Internal\Message { /** - * The secondary disk to start asynchronous replication to. You can provide this as a partial or full URL to the resource. For example, the following are valid values: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /disks/disk - https://www.googleapis.com/compute/v1/projects/project/regions/region /disks/disk - projects/project/zones/zone/disks/disk - projects/project/regions/region/disks/disk - zones/zone/disks/disk - regions/region/disks/disk + * The secondary disk to start asynchronous replication to. + * You can provide this as a partial or full URL to the resource. For example, + * the following are valid values: + * - + * https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk + * - + * https://www.googleapis.com/compute/v1/projects/project/regions/region/disks/disk + * - + * projects/project/zones/zone/disks/disk + * - + * projects/project/regions/region/disks/disk + * - + * zones/zone/disks/disk + * - + * regions/region/disks/disk * * Generated from protobuf field optional string async_secondary_disk = 131645867; */ @@ -28,7 +42,21 @@ class DisksStartAsyncReplicationRequest extends \Google\Protobuf\Internal\Messag * Optional. Data for populating the Message object. * * @type string $async_secondary_disk - * The secondary disk to start asynchronous replication to. You can provide this as a partial or full URL to the resource. For example, the following are valid values: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /disks/disk - https://www.googleapis.com/compute/v1/projects/project/regions/region /disks/disk - projects/project/zones/zone/disks/disk - projects/project/regions/region/disks/disk - zones/zone/disks/disk - regions/region/disks/disk + * The secondary disk to start asynchronous replication to. + * You can provide this as a partial or full URL to the resource. For example, + * the following are valid values: + * - + * https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk + * - + * https://www.googleapis.com/compute/v1/projects/project/regions/region/disks/disk + * - + * projects/project/zones/zone/disks/disk + * - + * projects/project/regions/region/disks/disk + * - + * zones/zone/disks/disk + * - + * regions/region/disks/disk * } */ public function __construct($data = NULL) { @@ -37,7 +65,21 @@ public function __construct($data = NULL) { } /** - * The secondary disk to start asynchronous replication to. You can provide this as a partial or full URL to the resource. For example, the following are valid values: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /disks/disk - https://www.googleapis.com/compute/v1/projects/project/regions/region /disks/disk - projects/project/zones/zone/disks/disk - projects/project/regions/region/disks/disk - zones/zone/disks/disk - regions/region/disks/disk + * The secondary disk to start asynchronous replication to. + * You can provide this as a partial or full URL to the resource. For example, + * the following are valid values: + * - + * https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk + * - + * https://www.googleapis.com/compute/v1/projects/project/regions/region/disks/disk + * - + * projects/project/zones/zone/disks/disk + * - + * projects/project/regions/region/disks/disk + * - + * zones/zone/disks/disk + * - + * regions/region/disks/disk * * Generated from protobuf field optional string async_secondary_disk = 131645867; * @return string @@ -58,7 +100,21 @@ public function clearAsyncSecondaryDisk() } /** - * The secondary disk to start asynchronous replication to. You can provide this as a partial or full URL to the resource. For example, the following are valid values: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /disks/disk - https://www.googleapis.com/compute/v1/projects/project/regions/region /disks/disk - projects/project/zones/zone/disks/disk - projects/project/regions/region/disks/disk - zones/zone/disks/disk - regions/region/disks/disk + * The secondary disk to start asynchronous replication to. + * You can provide this as a partial or full URL to the resource. For example, + * the following are valid values: + * - + * https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk + * - + * https://www.googleapis.com/compute/v1/projects/project/regions/region/disks/disk + * - + * projects/project/zones/zone/disks/disk + * - + * projects/project/regions/region/disks/disk + * - + * zones/zone/disks/disk + * - + * regions/region/disks/disk * * Generated from protobuf field optional string async_secondary_disk = 131645867; * @param string $var diff --git a/Compute/src/V1/DisksStopGroupAsyncReplicationResource.php b/Compute/src/V1/DisksStopGroupAsyncReplicationResource.php index d134b338a2eb..9a465753fb7a 100644 --- a/Compute/src/V1/DisksStopGroupAsyncReplicationResource.php +++ b/Compute/src/V1/DisksStopGroupAsyncReplicationResource.php @@ -9,14 +9,23 @@ use Google\Protobuf\Internal\GPBUtil; /** - * A transient resource used in compute.disks.stopGroupAsyncReplication and compute.regionDisks.stopGroupAsyncReplication. It is only used to process requests and is not persisted. + * A transient resource used in compute.disks.stopGroupAsyncReplication and + * compute.regionDisks.stopGroupAsyncReplication. It is only used to process + * requests and is not persisted. * * Generated from protobuf message google.cloud.compute.v1.DisksStopGroupAsyncReplicationResource */ class DisksStopGroupAsyncReplicationResource extends \Google\Protobuf\Internal\Message { /** - * The URL of the DiskConsistencyGroupPolicy for the group of disks to stop. This may be a full or partial URL, such as: - https://www.googleapis.com/compute/v1/projects/project/regions/region /resourcePolicies/resourcePolicy - projects/project/regions/region/resourcePolicies/resourcePolicy - regions/region/resourcePolicies/resourcePolicy + * The URL of the DiskConsistencyGroupPolicy for the group of disks to stop. + * This may be a full or partial URL, such as: + * - + * https://www.googleapis.com/compute/v1/projects/project/regions/region/resourcePolicies/resourcePolicy + * - + * projects/project/regions/region/resourcePolicies/resourcePolicy + * - + * regions/region/resourcePolicies/resourcePolicy * * Generated from protobuf field optional string resource_policy = 159240835; */ @@ -29,7 +38,14 @@ class DisksStopGroupAsyncReplicationResource extends \Google\Protobuf\Internal\M * Optional. Data for populating the Message object. * * @type string $resource_policy - * The URL of the DiskConsistencyGroupPolicy for the group of disks to stop. This may be a full or partial URL, such as: - https://www.googleapis.com/compute/v1/projects/project/regions/region /resourcePolicies/resourcePolicy - projects/project/regions/region/resourcePolicies/resourcePolicy - regions/region/resourcePolicies/resourcePolicy + * The URL of the DiskConsistencyGroupPolicy for the group of disks to stop. + * This may be a full or partial URL, such as: + * - + * https://www.googleapis.com/compute/v1/projects/project/regions/region/resourcePolicies/resourcePolicy + * - + * projects/project/regions/region/resourcePolicies/resourcePolicy + * - + * regions/region/resourcePolicies/resourcePolicy * } */ public function __construct($data = NULL) { @@ -38,7 +54,14 @@ public function __construct($data = NULL) { } /** - * The URL of the DiskConsistencyGroupPolicy for the group of disks to stop. This may be a full or partial URL, such as: - https://www.googleapis.com/compute/v1/projects/project/regions/region /resourcePolicies/resourcePolicy - projects/project/regions/region/resourcePolicies/resourcePolicy - regions/region/resourcePolicies/resourcePolicy + * The URL of the DiskConsistencyGroupPolicy for the group of disks to stop. + * This may be a full or partial URL, such as: + * - + * https://www.googleapis.com/compute/v1/projects/project/regions/region/resourcePolicies/resourcePolicy + * - + * projects/project/regions/region/resourcePolicies/resourcePolicy + * - + * regions/region/resourcePolicies/resourcePolicy * * Generated from protobuf field optional string resource_policy = 159240835; * @return string @@ -59,7 +82,14 @@ public function clearResourcePolicy() } /** - * The URL of the DiskConsistencyGroupPolicy for the group of disks to stop. This may be a full or partial URL, such as: - https://www.googleapis.com/compute/v1/projects/project/regions/region /resourcePolicies/resourcePolicy - projects/project/regions/region/resourcePolicies/resourcePolicy - regions/region/resourcePolicies/resourcePolicy + * The URL of the DiskConsistencyGroupPolicy for the group of disks to stop. + * This may be a full or partial URL, such as: + * - + * https://www.googleapis.com/compute/v1/projects/project/regions/region/resourcePolicies/resourcePolicy + * - + * projects/project/regions/region/resourcePolicies/resourcePolicy + * - + * regions/region/resourcePolicies/resourcePolicy * * Generated from protobuf field optional string resource_policy = 159240835; * @param string $var diff --git a/Compute/src/V1/DistributionPolicy.php b/Compute/src/V1/DistributionPolicy.php index cd5bdd981794..79093270b5d4 100644 --- a/Compute/src/V1/DistributionPolicy.php +++ b/Compute/src/V1/DistributionPolicy.php @@ -15,14 +15,16 @@ class DistributionPolicy extends \Google\Protobuf\Internal\Message { /** - * The distribution shape to which the group converges either proactively or on resize events (depending on the value set in updatePolicy.instanceRedistributionType). + * The distribution shape to which the group converges either proactively or + * on resize events (depending on the value set inupdatePolicy.instanceRedistributionType). * Check the TargetShape enum for the list of possible values. * * Generated from protobuf field optional string target_shape = 338621299; */ protected $target_shape = null; /** - * Zones where the regional managed instance group will create and manage its instances. + * Zones where the regional managed instance group will create and manage + * its instances. * * Generated from protobuf field repeated .google.cloud.compute.v1.DistributionPolicyZoneConfiguration zones = 116085319; */ @@ -35,10 +37,12 @@ class DistributionPolicy extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $target_shape - * The distribution shape to which the group converges either proactively or on resize events (depending on the value set in updatePolicy.instanceRedistributionType). + * The distribution shape to which the group converges either proactively or + * on resize events (depending on the value set inupdatePolicy.instanceRedistributionType). * Check the TargetShape enum for the list of possible values. * @type array<\Google\Cloud\Compute\V1\DistributionPolicyZoneConfiguration>|\Google\Protobuf\Internal\RepeatedField $zones - * Zones where the regional managed instance group will create and manage its instances. + * Zones where the regional managed instance group will create and manage + * its instances. * } */ public function __construct($data = NULL) { @@ -47,7 +51,8 @@ public function __construct($data = NULL) { } /** - * The distribution shape to which the group converges either proactively or on resize events (depending on the value set in updatePolicy.instanceRedistributionType). + * The distribution shape to which the group converges either proactively or + * on resize events (depending on the value set inupdatePolicy.instanceRedistributionType). * Check the TargetShape enum for the list of possible values. * * Generated from protobuf field optional string target_shape = 338621299; @@ -69,7 +74,8 @@ public function clearTargetShape() } /** - * The distribution shape to which the group converges either proactively or on resize events (depending on the value set in updatePolicy.instanceRedistributionType). + * The distribution shape to which the group converges either proactively or + * on resize events (depending on the value set inupdatePolicy.instanceRedistributionType). * Check the TargetShape enum for the list of possible values. * * Generated from protobuf field optional string target_shape = 338621299; @@ -85,7 +91,8 @@ public function setTargetShape($var) } /** - * Zones where the regional managed instance group will create and manage its instances. + * Zones where the regional managed instance group will create and manage + * its instances. * * Generated from protobuf field repeated .google.cloud.compute.v1.DistributionPolicyZoneConfiguration zones = 116085319; * @return \Google\Protobuf\Internal\RepeatedField @@ -96,7 +103,8 @@ public function getZones() } /** - * Zones where the regional managed instance group will create and manage its instances. + * Zones where the regional managed instance group will create and manage + * its instances. * * Generated from protobuf field repeated .google.cloud.compute.v1.DistributionPolicyZoneConfiguration zones = 116085319; * @param array<\Google\Cloud\Compute\V1\DistributionPolicyZoneConfiguration>|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/DistributionPolicy/TargetShape.php b/Compute/src/V1/DistributionPolicy/TargetShape.php index 75ea2d011a97..b06f2858b0c8 100644 --- a/Compute/src/V1/DistributionPolicy/TargetShape.php +++ b/Compute/src/V1/DistributionPolicy/TargetShape.php @@ -7,7 +7,8 @@ use UnexpectedValueException; /** - * The distribution shape to which the group converges either proactively or on resize events (depending on the value set in updatePolicy.instanceRedistributionType). + * The distribution shape to which the group converges either proactively or + * on resize events (depending on the value set inupdatePolicy.instanceRedistributionType). * * Protobuf type google.cloud.compute.v1.DistributionPolicy.TargetShape */ @@ -20,25 +21,38 @@ class TargetShape */ const UNDEFINED_TARGET_SHAPE = 0; /** - * The group picks zones for creating VM instances to fulfill the requested number of VMs within present resource constraints and to maximize utilization of unused zonal reservations. Recommended for batch workloads that do not require high availability. + * The group picks zones for creating VM instances to fulfill the requested + * number of VMs within present resource constraints and to maximize + * utilization of unused zonal reservations. Recommended for batch workloads + * that do not require high availability. * * Generated from protobuf enum ANY = 64972; */ const ANY = 64972; /** - * The group creates all VM instances within a single zone. The zone is selected based on the present resource constraints and to maximize utilization of unused zonal reservations. Recommended for batch workloads with heavy interprocess communication. + * The group creates all VM instances within a single zone. The zone is + * selected based on the present resource constraints and to maximize + * utilization of unused zonal reservations. + * Recommended for batch workloads with heavy interprocess communication. * * Generated from protobuf enum ANY_SINGLE_ZONE = 61100880; */ const ANY_SINGLE_ZONE = 61100880; /** - * The group prioritizes acquisition of resources, scheduling VMs in zones where resources are available while distributing VMs as evenly as possible across selected zones to minimize the impact of zonal failure. Recommended for highly available serving workloads. + * The group prioritizes acquisition of resources, scheduling VMs in zones + * where resources are available while distributing VMs as evenly as + * possible across selected zones to minimize the impact of zonal failure. + * Recommended for highly available serving workloads. * * Generated from protobuf enum BALANCED = 468409608; */ const BALANCED = 468409608; /** - * The group schedules VM instance creation and deletion to achieve and maintain an even number of managed instances across the selected zones. The distribution is even when the number of managed instances does not differ by more than 1 between any two zones. Recommended for highly available serving workloads. + * The group schedules VM instance creation and deletion to achieve and + * maintain an even number of managed instances across the selected zones. + * The distribution is even when the number of managed instances does not + * differ by more than 1 between any two zones. Recommended for highly + * available serving workloads. * * Generated from protobuf enum EVEN = 2140442; */ diff --git a/Compute/src/V1/DistributionPolicyZoneConfiguration.php b/Compute/src/V1/DistributionPolicyZoneConfiguration.php index 377fcfecd7fc..6299539b5b43 100644 --- a/Compute/src/V1/DistributionPolicyZoneConfiguration.php +++ b/Compute/src/V1/DistributionPolicyZoneConfiguration.php @@ -15,7 +15,9 @@ class DistributionPolicyZoneConfiguration extends \Google\Protobuf\Internal\Message { /** - * The URL of the zone. The zone must exist in the region where the managed instance group is located. + * The URL of thezone. + * The zone must exist in the region where the managed instance group is + * located. * * Generated from protobuf field optional string zone = 3744684; */ @@ -28,7 +30,9 @@ class DistributionPolicyZoneConfiguration extends \Google\Protobuf\Internal\Mess * Optional. Data for populating the Message object. * * @type string $zone - * The URL of the zone. The zone must exist in the region where the managed instance group is located. + * The URL of thezone. + * The zone must exist in the region where the managed instance group is + * located. * } */ public function __construct($data = NULL) { @@ -37,7 +41,9 @@ public function __construct($data = NULL) { } /** - * The URL of the zone. The zone must exist in the region where the managed instance group is located. + * The URL of thezone. + * The zone must exist in the region where the managed instance group is + * located. * * Generated from protobuf field optional string zone = 3744684; * @return string @@ -58,7 +64,9 @@ public function clearZone() } /** - * The URL of the zone. The zone must exist in the region where the managed instance group is located. + * The URL of thezone. + * The zone must exist in the region where the managed instance group is + * located. * * Generated from protobuf field optional string zone = 3744684; * @param string $var diff --git a/Compute/src/V1/Duration.php b/Compute/src/V1/Duration.php index fb27945fa449..94d9dce97df5 100644 --- a/Compute/src/V1/Duration.php +++ b/Compute/src/V1/Duration.php @@ -9,20 +9,28 @@ use Google\Protobuf\Internal\GPBUtil; /** - * A Duration represents a fixed-length span of time represented as a count of seconds and fractions of seconds at nanosecond resolution. It is independent of any calendar and concepts like "day" or "month". Range is approximately 10,000 years. + * A Duration represents a fixed-length span of time represented + * as a count of seconds and fractions of seconds at nanosecond + * resolution. It is independent of any calendar and concepts like "day" + * or "month". Range is approximately 10,000 years. * * Generated from protobuf message google.cloud.compute.v1.Duration */ class Duration extends \Google\Protobuf\Internal\Message { /** - * Span of time that's a fraction of a second at nanosecond resolution. Durations less than one second are represented with a 0 `seconds` field and a positive `nanos` field. Must be from 0 to 999,999,999 inclusive. + * Span of time that's a fraction of a second at nanosecond resolution. + * Durations less than one second are represented with a 0 + * `seconds` field and a positive `nanos` field. Must be from 0 + * to 999,999,999 inclusive. * * Generated from protobuf field optional int32 nanos = 104586303; */ protected $nanos = null; /** - * Span of time at a resolution of a second. Must be from 0 to 315,576,000,000 inclusive. Note: these bounds are computed from: 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years + * Span of time at a resolution of a second. Must be from 0 + * to 315,576,000,000 inclusive. Note: these bounds are computed from: + * 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years * * Generated from protobuf field optional int64 seconds = 359484031; */ @@ -35,9 +43,14 @@ class Duration extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type int $nanos - * Span of time that's a fraction of a second at nanosecond resolution. Durations less than one second are represented with a 0 `seconds` field and a positive `nanos` field. Must be from 0 to 999,999,999 inclusive. + * Span of time that's a fraction of a second at nanosecond resolution. + * Durations less than one second are represented with a 0 + * `seconds` field and a positive `nanos` field. Must be from 0 + * to 999,999,999 inclusive. * @type int|string $seconds - * Span of time at a resolution of a second. Must be from 0 to 315,576,000,000 inclusive. Note: these bounds are computed from: 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years + * Span of time at a resolution of a second. Must be from 0 + * to 315,576,000,000 inclusive. Note: these bounds are computed from: + * 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years * } */ public function __construct($data = NULL) { @@ -46,7 +59,10 @@ public function __construct($data = NULL) { } /** - * Span of time that's a fraction of a second at nanosecond resolution. Durations less than one second are represented with a 0 `seconds` field and a positive `nanos` field. Must be from 0 to 999,999,999 inclusive. + * Span of time that's a fraction of a second at nanosecond resolution. + * Durations less than one second are represented with a 0 + * `seconds` field and a positive `nanos` field. Must be from 0 + * to 999,999,999 inclusive. * * Generated from protobuf field optional int32 nanos = 104586303; * @return int @@ -67,7 +83,10 @@ public function clearNanos() } /** - * Span of time that's a fraction of a second at nanosecond resolution. Durations less than one second are represented with a 0 `seconds` field and a positive `nanos` field. Must be from 0 to 999,999,999 inclusive. + * Span of time that's a fraction of a second at nanosecond resolution. + * Durations less than one second are represented with a 0 + * `seconds` field and a positive `nanos` field. Must be from 0 + * to 999,999,999 inclusive. * * Generated from protobuf field optional int32 nanos = 104586303; * @param int $var @@ -82,7 +101,9 @@ public function setNanos($var) } /** - * Span of time at a resolution of a second. Must be from 0 to 315,576,000,000 inclusive. Note: these bounds are computed from: 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years + * Span of time at a resolution of a second. Must be from 0 + * to 315,576,000,000 inclusive. Note: these bounds are computed from: + * 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years * * Generated from protobuf field optional int64 seconds = 359484031; * @return int|string @@ -103,7 +124,9 @@ public function clearSeconds() } /** - * Span of time at a resolution of a second. Must be from 0 to 315,576,000,000 inclusive. Note: these bounds are computed from: 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years + * Span of time at a resolution of a second. Must be from 0 + * to 315,576,000,000 inclusive. Note: these bounds are computed from: + * 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years * * Generated from protobuf field optional int64 seconds = 359484031; * @param int|string $var diff --git a/Compute/src/V1/EnableXpnHostProjectRequest.php b/Compute/src/V1/EnableXpnHostProjectRequest.php index 2a3447ae1659..5d1799fefd2b 100644 --- a/Compute/src/V1/EnableXpnHostProjectRequest.php +++ b/Compute/src/V1/EnableXpnHostProjectRequest.php @@ -22,7 +22,17 @@ class EnableXpnHostProjectRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -50,7 +60,17 @@ public static function build(string $project): self * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -85,7 +105,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -106,7 +136,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/EnableXpnResourceProjectRequest.php b/Compute/src/V1/EnableXpnResourceProjectRequest.php index 79f4c2241d77..2cefb56a1270 100644 --- a/Compute/src/V1/EnableXpnResourceProjectRequest.php +++ b/Compute/src/V1/EnableXpnResourceProjectRequest.php @@ -28,7 +28,17 @@ class EnableXpnResourceProjectRequest extends \Google\Protobuf\Internal\Message */ protected $projects_enable_xpn_resource_request_resource = null; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -60,7 +70,17 @@ public static function build(string $project, \Google\Cloud\Compute\V1\ProjectsE * @type \Google\Cloud\Compute\V1\ProjectsEnableXpnResourceRequest $projects_enable_xpn_resource_request_resource * The body resource for this request * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -131,7 +151,17 @@ public function setProjectsEnableXpnResourceRequestResource($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -152,7 +182,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/Error.php b/Compute/src/V1/Error.php index 8f502ef40cbf..bc43372c5677 100644 --- a/Compute/src/V1/Error.php +++ b/Compute/src/V1/Error.php @@ -16,7 +16,8 @@ class Error extends \Google\Protobuf\Internal\Message { /** - * [Output Only] The array of errors encountered while processing this operation. + * [Output Only] The array of errors encountered while processing this + * operation. * * Generated from protobuf field repeated .google.cloud.compute.v1.Errors errors = 315977579; */ @@ -29,7 +30,8 @@ class Error extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type array<\Google\Cloud\Compute\V1\Errors>|\Google\Protobuf\Internal\RepeatedField $errors - * [Output Only] The array of errors encountered while processing this operation. + * [Output Only] The array of errors encountered while processing this + * operation. * } */ public function __construct($data = NULL) { @@ -38,7 +40,8 @@ public function __construct($data = NULL) { } /** - * [Output Only] The array of errors encountered while processing this operation. + * [Output Only] The array of errors encountered while processing this + * operation. * * Generated from protobuf field repeated .google.cloud.compute.v1.Errors errors = 315977579; * @return \Google\Protobuf\Internal\RepeatedField @@ -49,7 +52,8 @@ public function getErrors() } /** - * [Output Only] The array of errors encountered while processing this operation. + * [Output Only] The array of errors encountered while processing this + * operation. * * Generated from protobuf field repeated .google.cloud.compute.v1.Errors errors = 315977579; * @param array<\Google\Cloud\Compute\V1\Errors>|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/ErrorInfo.php b/Compute/src/V1/ErrorInfo.php index f8e5eca2a127..64253b6b4727 100644 --- a/Compute/src/V1/ErrorInfo.php +++ b/Compute/src/V1/ErrorInfo.php @@ -9,26 +9,60 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Describes the cause of the error with structured details. Example of an error when contacting the "pubsub.googleapis.com" API when it is not enabled: { "reason": "API_DISABLED" "domain": "googleapis.com" "metadata": { "resource": "projects/123", "service": "pubsub.googleapis.com" } } This response indicates that the pubsub.googleapis.com API is not enabled. Example of an error that is returned when attempting to create a Spanner instance in a region that is out of stock: { "reason": "STOCKOUT" "domain": "spanner.googleapis.com", "metadata": { "availableRegions": "us-central1,us-east2" } } + * Describes the cause of the error with structured details. + * Example of an error when contacting the "pubsub.googleapis.com" API when it + * is not enabled: + * { "reason": "API_DISABLED" + * "domain": "googleapis.com" + * "metadata": { + * "resource": "projects/123", + * "service": "pubsub.googleapis.com" + * } + * } + * This response indicates that the pubsub.googleapis.com API is not enabled. + * Example of an error that is returned when attempting to create a Spanner + * instance in a region that is out of stock: + * { "reason": "STOCKOUT" + * "domain": "spanner.googleapis.com", + * "metadata": { + * "availableRegions": "us-central1,us-east2" + * } + * } * * Generated from protobuf message google.cloud.compute.v1.ErrorInfo */ class ErrorInfo extends \Google\Protobuf\Internal\Message { /** - * The logical grouping to which the "reason" belongs. The error domain is typically the registered service name of the tool or product that generates the error. Example: "pubsub.googleapis.com". If the error is generated by some common infrastructure, the error domain must be a globally unique value that identifies the infrastructure. For Google API infrastructure, the error domain is "googleapis.com". + * The logical grouping to which the "reason" belongs. The error domain + * is typically the registered service name of the tool or product that + * generates the error. Example: "pubsub.googleapis.com". If the error is + * generated by some common infrastructure, the error domain must be a + * globally unique value that identifies the infrastructure. For Google API + * infrastructure, the error domain is "googleapis.com". * * Generated from protobuf field optional string domain = 284415172; */ protected $domain = null; /** - * Additional structured details about this error. Keys must match a regular expression of `a-z+` but should ideally be lowerCamelCase. Also, they must be limited to 64 characters in length. When identifying the current value of an exceeded limit, the units should be contained in the key, not the value. For example, rather than `{"instanceLimit": "100/request"}`, should be returned as, `{"instanceLimitPerRequest": "100"}`, if the client exceeds the number of instances that can be created in a single (batch) request. + * Additional structured details about this error. + * Keys must match a regular expression of `a-z+` but should + * ideally be lowerCamelCase. Also, they must be limited to 64 characters in + * length. When identifying the current value of an exceeded limit, the units + * should be contained in the key, not the value. For example, rather than + * `{"instanceLimit": "100/request"}`, should be returned as, + * `{"instanceLimitPerRequest": "100"}`, if the client exceeds the number of + * instances that can be created in a single (batch) request. * * Generated from protobuf field map metadatas = 8514340; */ private $metadatas; /** - * The reason of the error. This is a constant value that identifies the proximate cause of the error. Error reasons are unique within a particular domain of errors. This should be at most 63 characters and match a regular expression of `A-Z+[A-Z0-9]`, which represents UPPER_SNAKE_CASE. + * The reason of the error. This is a constant value that identifies the + * proximate cause of the error. Error reasons are unique within a particular + * domain of errors. This should be at most 63 characters and match a + * regular expression of `A-Z+[A-Z0-9]`, which represents + * UPPER_SNAKE_CASE. * * Generated from protobuf field optional string reason = 138777156; */ @@ -41,11 +75,27 @@ class ErrorInfo extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $domain - * The logical grouping to which the "reason" belongs. The error domain is typically the registered service name of the tool or product that generates the error. Example: "pubsub.googleapis.com". If the error is generated by some common infrastructure, the error domain must be a globally unique value that identifies the infrastructure. For Google API infrastructure, the error domain is "googleapis.com". + * The logical grouping to which the "reason" belongs. The error domain + * is typically the registered service name of the tool or product that + * generates the error. Example: "pubsub.googleapis.com". If the error is + * generated by some common infrastructure, the error domain must be a + * globally unique value that identifies the infrastructure. For Google API + * infrastructure, the error domain is "googleapis.com". * @type array|\Google\Protobuf\Internal\MapField $metadatas - * Additional structured details about this error. Keys must match a regular expression of `a-z+` but should ideally be lowerCamelCase. Also, they must be limited to 64 characters in length. When identifying the current value of an exceeded limit, the units should be contained in the key, not the value. For example, rather than `{"instanceLimit": "100/request"}`, should be returned as, `{"instanceLimitPerRequest": "100"}`, if the client exceeds the number of instances that can be created in a single (batch) request. + * Additional structured details about this error. + * Keys must match a regular expression of `a-z+` but should + * ideally be lowerCamelCase. Also, they must be limited to 64 characters in + * length. When identifying the current value of an exceeded limit, the units + * should be contained in the key, not the value. For example, rather than + * `{"instanceLimit": "100/request"}`, should be returned as, + * `{"instanceLimitPerRequest": "100"}`, if the client exceeds the number of + * instances that can be created in a single (batch) request. * @type string $reason - * The reason of the error. This is a constant value that identifies the proximate cause of the error. Error reasons are unique within a particular domain of errors. This should be at most 63 characters and match a regular expression of `A-Z+[A-Z0-9]`, which represents UPPER_SNAKE_CASE. + * The reason of the error. This is a constant value that identifies the + * proximate cause of the error. Error reasons are unique within a particular + * domain of errors. This should be at most 63 characters and match a + * regular expression of `A-Z+[A-Z0-9]`, which represents + * UPPER_SNAKE_CASE. * } */ public function __construct($data = NULL) { @@ -54,7 +104,12 @@ public function __construct($data = NULL) { } /** - * The logical grouping to which the "reason" belongs. The error domain is typically the registered service name of the tool or product that generates the error. Example: "pubsub.googleapis.com". If the error is generated by some common infrastructure, the error domain must be a globally unique value that identifies the infrastructure. For Google API infrastructure, the error domain is "googleapis.com". + * The logical grouping to which the "reason" belongs. The error domain + * is typically the registered service name of the tool or product that + * generates the error. Example: "pubsub.googleapis.com". If the error is + * generated by some common infrastructure, the error domain must be a + * globally unique value that identifies the infrastructure. For Google API + * infrastructure, the error domain is "googleapis.com". * * Generated from protobuf field optional string domain = 284415172; * @return string @@ -75,7 +130,12 @@ public function clearDomain() } /** - * The logical grouping to which the "reason" belongs. The error domain is typically the registered service name of the tool or product that generates the error. Example: "pubsub.googleapis.com". If the error is generated by some common infrastructure, the error domain must be a globally unique value that identifies the infrastructure. For Google API infrastructure, the error domain is "googleapis.com". + * The logical grouping to which the "reason" belongs. The error domain + * is typically the registered service name of the tool or product that + * generates the error. Example: "pubsub.googleapis.com". If the error is + * generated by some common infrastructure, the error domain must be a + * globally unique value that identifies the infrastructure. For Google API + * infrastructure, the error domain is "googleapis.com". * * Generated from protobuf field optional string domain = 284415172; * @param string $var @@ -90,7 +150,14 @@ public function setDomain($var) } /** - * Additional structured details about this error. Keys must match a regular expression of `a-z+` but should ideally be lowerCamelCase. Also, they must be limited to 64 characters in length. When identifying the current value of an exceeded limit, the units should be contained in the key, not the value. For example, rather than `{"instanceLimit": "100/request"}`, should be returned as, `{"instanceLimitPerRequest": "100"}`, if the client exceeds the number of instances that can be created in a single (batch) request. + * Additional structured details about this error. + * Keys must match a regular expression of `a-z+` but should + * ideally be lowerCamelCase. Also, they must be limited to 64 characters in + * length. When identifying the current value of an exceeded limit, the units + * should be contained in the key, not the value. For example, rather than + * `{"instanceLimit": "100/request"}`, should be returned as, + * `{"instanceLimitPerRequest": "100"}`, if the client exceeds the number of + * instances that can be created in a single (batch) request. * * Generated from protobuf field map metadatas = 8514340; * @return \Google\Protobuf\Internal\MapField @@ -101,7 +168,14 @@ public function getMetadatas() } /** - * Additional structured details about this error. Keys must match a regular expression of `a-z+` but should ideally be lowerCamelCase. Also, they must be limited to 64 characters in length. When identifying the current value of an exceeded limit, the units should be contained in the key, not the value. For example, rather than `{"instanceLimit": "100/request"}`, should be returned as, `{"instanceLimitPerRequest": "100"}`, if the client exceeds the number of instances that can be created in a single (batch) request. + * Additional structured details about this error. + * Keys must match a regular expression of `a-z+` but should + * ideally be lowerCamelCase. Also, they must be limited to 64 characters in + * length. When identifying the current value of an exceeded limit, the units + * should be contained in the key, not the value. For example, rather than + * `{"instanceLimit": "100/request"}`, should be returned as, + * `{"instanceLimitPerRequest": "100"}`, if the client exceeds the number of + * instances that can be created in a single (batch) request. * * Generated from protobuf field map metadatas = 8514340; * @param array|\Google\Protobuf\Internal\MapField $var @@ -116,7 +190,11 @@ public function setMetadatas($var) } /** - * The reason of the error. This is a constant value that identifies the proximate cause of the error. Error reasons are unique within a particular domain of errors. This should be at most 63 characters and match a regular expression of `A-Z+[A-Z0-9]`, which represents UPPER_SNAKE_CASE. + * The reason of the error. This is a constant value that identifies the + * proximate cause of the error. Error reasons are unique within a particular + * domain of errors. This should be at most 63 characters and match a + * regular expression of `A-Z+[A-Z0-9]`, which represents + * UPPER_SNAKE_CASE. * * Generated from protobuf field optional string reason = 138777156; * @return string @@ -137,7 +215,11 @@ public function clearReason() } /** - * The reason of the error. This is a constant value that identifies the proximate cause of the error. Error reasons are unique within a particular domain of errors. This should be at most 63 characters and match a regular expression of `A-Z+[A-Z0-9]`, which represents UPPER_SNAKE_CASE. + * The reason of the error. This is a constant value that identifies the + * proximate cause of the error. Error reasons are unique within a particular + * domain of errors. This should be at most 63 characters and match a + * regular expression of `A-Z+[A-Z0-9]`, which represents + * UPPER_SNAKE_CASE. * * Generated from protobuf field optional string reason = 138777156; * @param string $var diff --git a/Compute/src/V1/Errors.php b/Compute/src/V1/Errors.php index 232efc194aeb..e996a6c052a8 100644 --- a/Compute/src/V1/Errors.php +++ b/Compute/src/V1/Errors.php @@ -21,13 +21,18 @@ class Errors extends \Google\Protobuf\Internal\Message */ protected $code = null; /** - * [Output Only] An optional list of messages that contain the error details. There is a set of defined message types to use for providing details.The syntax depends on the error code. For example, QuotaExceededInfo will have details when the error code is QUOTA_EXCEEDED. + * [Output Only] An optional list of messages that contain the error + * details. There is a set of defined message types to use for providing + * details.The syntax depends on the error code. For example, + * QuotaExceededInfo will have details when the error code is + * QUOTA_EXCEEDED. * * Generated from protobuf field repeated .google.cloud.compute.v1.ErrorDetails error_details = 274653963; */ private $error_details; /** - * [Output Only] Indicates the field in the request that caused the error. This property is optional. + * [Output Only] Indicates the field in the request that caused the error. + * This property is optional. * * Generated from protobuf field optional string location = 290430901; */ @@ -48,9 +53,14 @@ class Errors extends \Google\Protobuf\Internal\Message * @type string $code * [Output Only] The error type identifier for this error. * @type array<\Google\Cloud\Compute\V1\ErrorDetails>|\Google\Protobuf\Internal\RepeatedField $error_details - * [Output Only] An optional list of messages that contain the error details. There is a set of defined message types to use for providing details.The syntax depends on the error code. For example, QuotaExceededInfo will have details when the error code is QUOTA_EXCEEDED. + * [Output Only] An optional list of messages that contain the error + * details. There is a set of defined message types to use for providing + * details.The syntax depends on the error code. For example, + * QuotaExceededInfo will have details when the error code is + * QUOTA_EXCEEDED. * @type string $location - * [Output Only] Indicates the field in the request that caused the error. This property is optional. + * [Output Only] Indicates the field in the request that caused the error. + * This property is optional. * @type string $message * [Output Only] An optional, human-readable error message. * } @@ -97,7 +107,11 @@ public function setCode($var) } /** - * [Output Only] An optional list of messages that contain the error details. There is a set of defined message types to use for providing details.The syntax depends on the error code. For example, QuotaExceededInfo will have details when the error code is QUOTA_EXCEEDED. + * [Output Only] An optional list of messages that contain the error + * details. There is a set of defined message types to use for providing + * details.The syntax depends on the error code. For example, + * QuotaExceededInfo will have details when the error code is + * QUOTA_EXCEEDED. * * Generated from protobuf field repeated .google.cloud.compute.v1.ErrorDetails error_details = 274653963; * @return \Google\Protobuf\Internal\RepeatedField @@ -108,7 +122,11 @@ public function getErrorDetails() } /** - * [Output Only] An optional list of messages that contain the error details. There is a set of defined message types to use for providing details.The syntax depends on the error code. For example, QuotaExceededInfo will have details when the error code is QUOTA_EXCEEDED. + * [Output Only] An optional list of messages that contain the error + * details. There is a set of defined message types to use for providing + * details.The syntax depends on the error code. For example, + * QuotaExceededInfo will have details when the error code is + * QUOTA_EXCEEDED. * * Generated from protobuf field repeated .google.cloud.compute.v1.ErrorDetails error_details = 274653963; * @param array<\Google\Cloud\Compute\V1\ErrorDetails>|\Google\Protobuf\Internal\RepeatedField $var @@ -123,7 +141,8 @@ public function setErrorDetails($var) } /** - * [Output Only] Indicates the field in the request that caused the error. This property is optional. + * [Output Only] Indicates the field in the request that caused the error. + * This property is optional. * * Generated from protobuf field optional string location = 290430901; * @return string @@ -144,7 +163,8 @@ public function clearLocation() } /** - * [Output Only] Indicates the field in the request that caused the error. This property is optional. + * [Output Only] Indicates the field in the request that caused the error. + * This property is optional. * * Generated from protobuf field optional string location = 290430901; * @param string $var diff --git a/Compute/src/V1/ExchangedPeeringRoute.php b/Compute/src/V1/ExchangedPeeringRoute.php index e74aeec28197..ba49d9339f5c 100644 --- a/Compute/src/V1/ExchangedPeeringRoute.php +++ b/Compute/src/V1/ExchangedPeeringRoute.php @@ -21,7 +21,11 @@ class ExchangedPeeringRoute extends \Google\Protobuf\Internal\Message */ protected $dest_range = null; /** - * True if the peering route has been imported from a peer. The actual import happens if the field networkPeering.importCustomRoutes is true for this network, and networkPeering.exportCustomRoutes is true for the peer network, and the import does not result in a route conflict. + * True if the peering route has been imported from a peer. The actual import + * happens if the field networkPeering.importCustomRoutes is true + * for this network, and networkPeering.exportCustomRoutes is + * true for the peer network, and the import does not result in a route + * conflict. * * Generated from protobuf field optional bool imported = 114502404; */ @@ -55,7 +59,11 @@ class ExchangedPeeringRoute extends \Google\Protobuf\Internal\Message * @type string $dest_range * The destination range of the route. * @type bool $imported - * True if the peering route has been imported from a peer. The actual import happens if the field networkPeering.importCustomRoutes is true for this network, and networkPeering.exportCustomRoutes is true for the peer network, and the import does not result in a route conflict. + * True if the peering route has been imported from a peer. The actual import + * happens if the field networkPeering.importCustomRoutes is true + * for this network, and networkPeering.exportCustomRoutes is + * true for the peer network, and the import does not result in a route + * conflict. * @type string $next_hop_region * The region of peering route next hop, only applies to dynamic routes. * @type int $priority @@ -107,7 +115,11 @@ public function setDestRange($var) } /** - * True if the peering route has been imported from a peer. The actual import happens if the field networkPeering.importCustomRoutes is true for this network, and networkPeering.exportCustomRoutes is true for the peer network, and the import does not result in a route conflict. + * True if the peering route has been imported from a peer. The actual import + * happens if the field networkPeering.importCustomRoutes is true + * for this network, and networkPeering.exportCustomRoutes is + * true for the peer network, and the import does not result in a route + * conflict. * * Generated from protobuf field optional bool imported = 114502404; * @return bool @@ -128,7 +140,11 @@ public function clearImported() } /** - * True if the peering route has been imported from a peer. The actual import happens if the field networkPeering.importCustomRoutes is true for this network, and networkPeering.exportCustomRoutes is true for the peer network, and the import does not result in a route conflict. + * True if the peering route has been imported from a peer. The actual import + * happens if the field networkPeering.importCustomRoutes is true + * for this network, and networkPeering.exportCustomRoutes is + * true for the peer network, and the import does not result in a route + * conflict. * * Generated from protobuf field optional bool imported = 114502404; * @param bool $var diff --git a/Compute/src/V1/ExchangedPeeringRoutesList.php b/Compute/src/V1/ExchangedPeeringRoutesList.php index c5f3f54170a3..b7b3731e8544 100644 --- a/Compute/src/V1/ExchangedPeeringRoutesList.php +++ b/Compute/src/V1/ExchangedPeeringRoutesList.php @@ -27,13 +27,18 @@ class ExchangedPeeringRoutesList extends \Google\Protobuf\Internal\Message */ private $items; /** - * [Output Only] Type of resource. Always compute#exchangedPeeringRoutesList for exchanged peering routes lists. + * [Output Only] Type of resource. Alwayscompute#exchangedPeeringRoutesList for exchanged peering + * routes lists. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -62,9 +67,14 @@ class ExchangedPeeringRoutesList extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\ExchangedPeeringRoute>|\Google\Protobuf\Internal\RepeatedField $items * A list of ExchangedPeeringRoute resources. * @type string $kind - * [Output Only] Type of resource. Always compute#exchangedPeeringRoutesList for exchanged peering routes lists. + * [Output Only] Type of resource. Alwayscompute#exchangedPeeringRoutesList for exchanged peering + * routes lists. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type \Google\Cloud\Compute\V1\Warning $warning @@ -139,7 +149,8 @@ public function setItems($var) } /** - * [Output Only] Type of resource. Always compute#exchangedPeeringRoutesList for exchanged peering routes lists. + * [Output Only] Type of resource. Alwayscompute#exchangedPeeringRoutesList for exchanged peering + * routes lists. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -160,7 +171,8 @@ public function clearKind() } /** - * [Output Only] Type of resource. Always compute#exchangedPeeringRoutesList for exchanged peering routes lists. + * [Output Only] Type of resource. Alwayscompute#exchangedPeeringRoutesList for exchanged peering + * routes lists. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -175,7 +187,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -196,7 +212,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/ExpandIpCidrRangeSubnetworkRequest.php b/Compute/src/V1/ExpandIpCidrRangeSubnetworkRequest.php index 9ffde28fe313..30f374f36f4e 100644 --- a/Compute/src/V1/ExpandIpCidrRangeSubnetworkRequest.php +++ b/Compute/src/V1/ExpandIpCidrRangeSubnetworkRequest.php @@ -28,7 +28,17 @@ class ExpandIpCidrRangeSubnetworkRequest extends \Google\Protobuf\Internal\Messa */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -76,7 +86,17 @@ public static function build(string $project, string $region, string $subnetwork * @type string $region * Name of the region scoping this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $subnetwork * Name of the Subnetwork resource to update. * @type \Google\Cloud\Compute\V1\SubnetworksExpandIpCidrRangeRequest $subnetworks_expand_ip_cidr_range_request_resource @@ -141,7 +161,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -162,7 +192,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/Expr.php b/Compute/src/V1/Expr.php index c591d666993f..b69f0f561271 100644 --- a/Compute/src/V1/Expr.php +++ b/Compute/src/V1/Expr.php @@ -9,32 +9,58 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Represents a textual expression in the Common Expression Language (CEL) syntax. CEL is a C-like expression language. The syntax and semantics of CEL are documented at https://github.com/google/cel-spec. Example (Comparison): title: "Summary size limit" description: "Determines if a summary is less than 100 chars" expression: "document.summary.size() < 100" Example (Equality): title: "Requestor is owner" description: "Determines if requestor is the document owner" expression: "document.owner == request.auth.claims.email" Example (Logic): title: "Public documents" description: "Determine whether the document should be publicly visible" expression: "document.type != 'private' && document.type != 'internal'" Example (Data Manipulation): title: "Notification string" description: "Create a notification string with a timestamp." expression: "'New message received at ' + string(document.create_time)" The exact variables and functions that may be referenced within an expression are determined by the service that evaluates it. See the service documentation for additional information. + * Represents a textual expression in the Common Expression Language (CEL) + * syntax. CEL is a C-like expression language. The syntax and semantics of CEL + * are documented at https://github.com/google/cel-spec. + * Example (Comparison): + * title: "Summary size limit" + * description: "Determines if a summary is less than 100 chars" + * expression: "document.summary.size() < 100" + * Example (Equality): + * title: "Requestor is owner" + * description: "Determines if requestor is the document owner" + * expression: "document.owner == request.auth.claims.email" + * Example (Logic): + * title: "Public documents" + * description: "Determine whether the document should be publicly visible" + * expression: "document.type != 'private' && document.type != 'internal'" + * Example (Data Manipulation): + * title: "Notification string" + * description: "Create a notification string with a timestamp." + * expression: "'New message received at ' + string(document.create_time)" + * The exact variables and functions that may be referenced within an expression + * are determined by the service that evaluates it. See the service + * documentation for additional information. * * Generated from protobuf message google.cloud.compute.v1.Expr */ class Expr extends \Google\Protobuf\Internal\Message { /** - * Optional. Description of the expression. This is a longer text which describes the expression, e.g. when hovered over it in a UI. + * Optional. Description of the expression. This is a longer text which + * describes the expression, e.g. when hovered over it in a UI. * * Generated from protobuf field optional string description = 422937596; */ protected $description = null; /** - * Textual representation of an expression in Common Expression Language syntax. + * Textual representation of an expression in Common Expression Language + * syntax. * * Generated from protobuf field optional string expression = 352031384; */ protected $expression = null; /** - * Optional. String indicating the location of the expression for error reporting, e.g. a file name and a position in the file. + * Optional. String indicating the location of the expression for error + * reporting, e.g. a file name and a position in the file. * * Generated from protobuf field optional string location = 290430901; */ protected $location = null; /** - * Optional. Title for the expression, i.e. a short string describing its purpose. This can be used e.g. in UIs which allow to enter the expression. + * Optional. Title for the expression, i.e. a short string describing + * its purpose. This can be used e.g. in UIs which allow to enter the + * expression. * * Generated from protobuf field optional string title = 110371416; */ @@ -47,13 +73,18 @@ class Expr extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $description - * Optional. Description of the expression. This is a longer text which describes the expression, e.g. when hovered over it in a UI. + * Optional. Description of the expression. This is a longer text which + * describes the expression, e.g. when hovered over it in a UI. * @type string $expression - * Textual representation of an expression in Common Expression Language syntax. + * Textual representation of an expression in Common Expression Language + * syntax. * @type string $location - * Optional. String indicating the location of the expression for error reporting, e.g. a file name and a position in the file. + * Optional. String indicating the location of the expression for error + * reporting, e.g. a file name and a position in the file. * @type string $title - * Optional. Title for the expression, i.e. a short string describing its purpose. This can be used e.g. in UIs which allow to enter the expression. + * Optional. Title for the expression, i.e. a short string describing + * its purpose. This can be used e.g. in UIs which allow to enter the + * expression. * } */ public function __construct($data = NULL) { @@ -62,7 +93,8 @@ public function __construct($data = NULL) { } /** - * Optional. Description of the expression. This is a longer text which describes the expression, e.g. when hovered over it in a UI. + * Optional. Description of the expression. This is a longer text which + * describes the expression, e.g. when hovered over it in a UI. * * Generated from protobuf field optional string description = 422937596; * @return string @@ -83,7 +115,8 @@ public function clearDescription() } /** - * Optional. Description of the expression. This is a longer text which describes the expression, e.g. when hovered over it in a UI. + * Optional. Description of the expression. This is a longer text which + * describes the expression, e.g. when hovered over it in a UI. * * Generated from protobuf field optional string description = 422937596; * @param string $var @@ -98,7 +131,8 @@ public function setDescription($var) } /** - * Textual representation of an expression in Common Expression Language syntax. + * Textual representation of an expression in Common Expression Language + * syntax. * * Generated from protobuf field optional string expression = 352031384; * @return string @@ -119,7 +153,8 @@ public function clearExpression() } /** - * Textual representation of an expression in Common Expression Language syntax. + * Textual representation of an expression in Common Expression Language + * syntax. * * Generated from protobuf field optional string expression = 352031384; * @param string $var @@ -134,7 +169,8 @@ public function setExpression($var) } /** - * Optional. String indicating the location of the expression for error reporting, e.g. a file name and a position in the file. + * Optional. String indicating the location of the expression for error + * reporting, e.g. a file name and a position in the file. * * Generated from protobuf field optional string location = 290430901; * @return string @@ -155,7 +191,8 @@ public function clearLocation() } /** - * Optional. String indicating the location of the expression for error reporting, e.g. a file name and a position in the file. + * Optional. String indicating the location of the expression for error + * reporting, e.g. a file name and a position in the file. * * Generated from protobuf field optional string location = 290430901; * @param string $var @@ -170,7 +207,9 @@ public function setLocation($var) } /** - * Optional. Title for the expression, i.e. a short string describing its purpose. This can be used e.g. in UIs which allow to enter the expression. + * Optional. Title for the expression, i.e. a short string describing + * its purpose. This can be used e.g. in UIs which allow to enter the + * expression. * * Generated from protobuf field optional string title = 110371416; * @return string @@ -191,7 +230,9 @@ public function clearTitle() } /** - * Optional. Title for the expression, i.e. a short string describing its purpose. This can be used e.g. in UIs which allow to enter the expression. + * Optional. Title for the expression, i.e. a short string describing + * its purpose. This can be used e.g. in UIs which allow to enter the + * expression. * * Generated from protobuf field optional string title = 110371416; * @param string $var diff --git a/Compute/src/V1/ExternalVpnGateway.php b/Compute/src/V1/ExternalVpnGateway.php index 5e7b0d50ee33..c5970dad6230 100644 --- a/Compute/src/V1/ExternalVpnGateway.php +++ b/Compute/src/V1/ExternalVpnGateway.php @@ -9,56 +9,84 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Represents an external VPN gateway. External VPN gateway is the on-premises VPN gateway(s) or another cloud provider's VPN gateway that connects to your Google Cloud VPN gateway. To create a highly available VPN from Google Cloud Platform to your VPN gateway or another cloud provider's VPN gateway, you must create a external VPN gateway resource with information about the other gateway. For more information about using external VPN gateways, see Creating an HA VPN gateway and tunnel pair to a peer VPN. + * Represents an external VPN gateway. + * External VPN gateway is the on-premises VPN gateway(s) or another cloud + * provider's VPN gateway that connects to your Google Cloud VPN gateway. + * To create a highly available VPN from Google Cloud Platform to your + * VPN gateway or another cloud provider's VPN gateway, you must create a + * external VPN gateway resource with information about the other gateway. + * For more information about using external VPN gateways, see + * Creating an HA VPN gateway and tunnel pair to a peer VPN. * * Generated from protobuf message google.cloud.compute.v1.ExternalVpnGateway */ class ExternalVpnGateway extends \Google\Protobuf\Internal\Message { /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; */ protected $creation_timestamp = null; /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; */ protected $description = null; /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; */ protected $id = null; /** - * A list of interfaces for this external VPN gateway. If your peer-side gateway is an on-premises gateway and non-AWS cloud providers' gateway, at most two interfaces can be provided for an external VPN gateway. If your peer side is an AWS virtual private gateway, four interfaces should be provided for an external VPN gateway. + * A list of interfaces for this external VPN gateway. + * If your peer-side gateway is an on-premises gateway and non-AWS cloud + * providers' gateway, at most two interfaces can be provided for an external + * VPN gateway. If your peer side is an AWS virtual private gateway, four + * interfaces should be provided for an external VPN gateway. * * Generated from protobuf field repeated .google.cloud.compute.v1.ExternalVpnGatewayInterface interfaces = 12073562; */ private $interfaces; /** - * [Output Only] Type of the resource. Always compute#externalVpnGateway for externalVpnGateways. + * [Output Only] Type of the resource. Alwayscompute#externalVpnGateway for externalVpnGateways. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * A fingerprint for the labels being applied to this ExternalVpnGateway, which is essentially a hash of the labels set used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve an ExternalVpnGateway. + * A fingerprint for the labels being applied to this ExternalVpnGateway, + * which is essentially a hash of the labels set used for optimistic locking. + * The fingerprint is initially generated by Compute Engine and changes after + * every request to modify or update labels. You must always provide an + * up-to-date fingerprint hash in order to update or change labels, + * otherwise the request will fail with error412 conditionNotMet. + * To see the latest fingerprint, make a get() request to + * retrieve an ExternalVpnGateway. * * Generated from protobuf field optional string label_fingerprint = 178124825; */ protected $label_fingerprint = null; /** - * Labels for this resource. These can only be added or modified by the setLabels method. Each label key/value pair must comply with RFC1035. Label values may be empty. + * Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035. + * Label values may be empty. * * Generated from protobuf field map labels = 500195327; */ private $labels; /** - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must be + * a dash, lowercase letter, or digit, except the last character, which cannot + * be a dash. * * Generated from protobuf field optional string name = 3373707; */ @@ -84,21 +112,42 @@ class ExternalVpnGateway extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $creation_timestamp - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * @type string $description - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * @type int|string $id - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * @type array<\Google\Cloud\Compute\V1\ExternalVpnGatewayInterface>|\Google\Protobuf\Internal\RepeatedField $interfaces - * A list of interfaces for this external VPN gateway. If your peer-side gateway is an on-premises gateway and non-AWS cloud providers' gateway, at most two interfaces can be provided for an external VPN gateway. If your peer side is an AWS virtual private gateway, four interfaces should be provided for an external VPN gateway. + * A list of interfaces for this external VPN gateway. + * If your peer-side gateway is an on-premises gateway and non-AWS cloud + * providers' gateway, at most two interfaces can be provided for an external + * VPN gateway. If your peer side is an AWS virtual private gateway, four + * interfaces should be provided for an external VPN gateway. * @type string $kind - * [Output Only] Type of the resource. Always compute#externalVpnGateway for externalVpnGateways. + * [Output Only] Type of the resource. Alwayscompute#externalVpnGateway for externalVpnGateways. * @type string $label_fingerprint - * A fingerprint for the labels being applied to this ExternalVpnGateway, which is essentially a hash of the labels set used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve an ExternalVpnGateway. + * A fingerprint for the labels being applied to this ExternalVpnGateway, + * which is essentially a hash of the labels set used for optimistic locking. + * The fingerprint is initially generated by Compute Engine and changes after + * every request to modify or update labels. You must always provide an + * up-to-date fingerprint hash in order to update or change labels, + * otherwise the request will fail with error412 conditionNotMet. + * To see the latest fingerprint, make a get() request to + * retrieve an ExternalVpnGateway. * @type array|\Google\Protobuf\Internal\MapField $labels - * Labels for this resource. These can only be added or modified by the setLabels method. Each label key/value pair must comply with RFC1035. Label values may be empty. + * Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035. + * Label values may be empty. * @type string $name - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must be + * a dash, lowercase letter, or digit, except the last character, which cannot + * be a dash. * @type string $redundancy_type * Indicates the user-supplied redundancy type of this external VPN gateway. * Check the RedundancyType enum for the list of possible values. @@ -112,7 +161,8 @@ public function __construct($data = NULL) { } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @return string @@ -133,7 +183,8 @@ public function clearCreationTimestamp() } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @param string $var @@ -148,7 +199,8 @@ public function setCreationTimestamp($var) } /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @return string @@ -169,7 +221,8 @@ public function clearDescription() } /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @param string $var @@ -184,7 +237,8 @@ public function setDescription($var) } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @return int|string @@ -205,7 +259,8 @@ public function clearId() } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @param int|string $var @@ -220,7 +275,11 @@ public function setId($var) } /** - * A list of interfaces for this external VPN gateway. If your peer-side gateway is an on-premises gateway and non-AWS cloud providers' gateway, at most two interfaces can be provided for an external VPN gateway. If your peer side is an AWS virtual private gateway, four interfaces should be provided for an external VPN gateway. + * A list of interfaces for this external VPN gateway. + * If your peer-side gateway is an on-premises gateway and non-AWS cloud + * providers' gateway, at most two interfaces can be provided for an external + * VPN gateway. If your peer side is an AWS virtual private gateway, four + * interfaces should be provided for an external VPN gateway. * * Generated from protobuf field repeated .google.cloud.compute.v1.ExternalVpnGatewayInterface interfaces = 12073562; * @return \Google\Protobuf\Internal\RepeatedField @@ -231,7 +290,11 @@ public function getInterfaces() } /** - * A list of interfaces for this external VPN gateway. If your peer-side gateway is an on-premises gateway and non-AWS cloud providers' gateway, at most two interfaces can be provided for an external VPN gateway. If your peer side is an AWS virtual private gateway, four interfaces should be provided for an external VPN gateway. + * A list of interfaces for this external VPN gateway. + * If your peer-side gateway is an on-premises gateway and non-AWS cloud + * providers' gateway, at most two interfaces can be provided for an external + * VPN gateway. If your peer side is an AWS virtual private gateway, four + * interfaces should be provided for an external VPN gateway. * * Generated from protobuf field repeated .google.cloud.compute.v1.ExternalVpnGatewayInterface interfaces = 12073562; * @param array<\Google\Cloud\Compute\V1\ExternalVpnGatewayInterface>|\Google\Protobuf\Internal\RepeatedField $var @@ -246,7 +309,7 @@ public function setInterfaces($var) } /** - * [Output Only] Type of the resource. Always compute#externalVpnGateway for externalVpnGateways. + * [Output Only] Type of the resource. Alwayscompute#externalVpnGateway for externalVpnGateways. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -267,7 +330,7 @@ public function clearKind() } /** - * [Output Only] Type of the resource. Always compute#externalVpnGateway for externalVpnGateways. + * [Output Only] Type of the resource. Alwayscompute#externalVpnGateway for externalVpnGateways. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -282,7 +345,14 @@ public function setKind($var) } /** - * A fingerprint for the labels being applied to this ExternalVpnGateway, which is essentially a hash of the labels set used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve an ExternalVpnGateway. + * A fingerprint for the labels being applied to this ExternalVpnGateway, + * which is essentially a hash of the labels set used for optimistic locking. + * The fingerprint is initially generated by Compute Engine and changes after + * every request to modify or update labels. You must always provide an + * up-to-date fingerprint hash in order to update or change labels, + * otherwise the request will fail with error412 conditionNotMet. + * To see the latest fingerprint, make a get() request to + * retrieve an ExternalVpnGateway. * * Generated from protobuf field optional string label_fingerprint = 178124825; * @return string @@ -303,7 +373,14 @@ public function clearLabelFingerprint() } /** - * A fingerprint for the labels being applied to this ExternalVpnGateway, which is essentially a hash of the labels set used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve an ExternalVpnGateway. + * A fingerprint for the labels being applied to this ExternalVpnGateway, + * which is essentially a hash of the labels set used for optimistic locking. + * The fingerprint is initially generated by Compute Engine and changes after + * every request to modify or update labels. You must always provide an + * up-to-date fingerprint hash in order to update or change labels, + * otherwise the request will fail with error412 conditionNotMet. + * To see the latest fingerprint, make a get() request to + * retrieve an ExternalVpnGateway. * * Generated from protobuf field optional string label_fingerprint = 178124825; * @param string $var @@ -318,7 +395,8 @@ public function setLabelFingerprint($var) } /** - * Labels for this resource. These can only be added or modified by the setLabels method. Each label key/value pair must comply with RFC1035. Label values may be empty. + * Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035. + * Label values may be empty. * * Generated from protobuf field map labels = 500195327; * @return \Google\Protobuf\Internal\MapField @@ -329,7 +407,8 @@ public function getLabels() } /** - * Labels for this resource. These can only be added or modified by the setLabels method. Each label key/value pair must comply with RFC1035. Label values may be empty. + * Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035. + * Label values may be empty. * * Generated from protobuf field map labels = 500195327; * @param array|\Google\Protobuf\Internal\MapField $var @@ -344,7 +423,13 @@ public function setLabels($var) } /** - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must be + * a dash, lowercase letter, or digit, except the last character, which cannot + * be a dash. * * Generated from protobuf field optional string name = 3373707; * @return string @@ -365,7 +450,13 @@ public function clearName() } /** - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must be + * a dash, lowercase letter, or digit, except the last character, which cannot + * be a dash. * * Generated from protobuf field optional string name = 3373707; * @param string $var diff --git a/Compute/src/V1/ExternalVpnGateway/RedundancyType.php b/Compute/src/V1/ExternalVpnGateway/RedundancyType.php index 60ff2608ba15..f23c13e43295 100644 --- a/Compute/src/V1/ExternalVpnGateway/RedundancyType.php +++ b/Compute/src/V1/ExternalVpnGateway/RedundancyType.php @@ -20,19 +20,39 @@ class RedundancyType */ const UNDEFINED_REDUNDANCY_TYPE = 0; /** - * The external VPN gateway has four public IP addresses; at the time of writing this API, the AWS virtual private gateway is an example which has four public IP addresses for high availability connections; there should be two VPN connections in the AWS virtual private gateway , each AWS VPN connection has two public IP addresses; please make sure to put two public IP addresses from one AWS VPN connection into interfaces 0 and 1 of this external VPN gateway, and put the other two public IP addresses from another AWS VPN connection into interfaces 2 and 3 of this external VPN gateway. When displaying highly available configuration status for the VPN tunnels connected to FOUR_IPS_REDUNDANCY external VPN gateway, Google will always detect whether interfaces 0 and 1 are connected on one interface of HA Cloud VPN gateway, and detect whether interfaces 2 and 3 are connected to another interface of the HA Cloud VPN gateway. + * The external VPN gateway has four public IP addresses; at the time of + * writing this API, the AWS virtual private gateway is an example which has + * four public IP addresses for high availability connections; there should + * be two VPN connections in the AWS virtual private gateway , each AWS VPN + * connection has two public IP addresses; please make sure to put two + * public IP addresses from one AWS VPN connection into interfaces 0 and 1 + * of this external VPN gateway, and put the other two public IP addresses + * from another AWS VPN connection into interfaces 2 and 3 of this external + * VPN gateway. When displaying highly available configuration status + * for the VPN tunnels connected to FOUR_IPS_REDUNDANCY external VPN + * gateway, Google will always detect whether interfaces 0 and 1 are + * connected on one interface of HA Cloud VPN gateway, and detect whether + * interfaces 2 and 3 are connected to another interface of the HA Cloud VPN + * gateway. * * Generated from protobuf enum FOUR_IPS_REDUNDANCY = 520087913; */ const FOUR_IPS_REDUNDANCY = 520087913; /** - * The external VPN gateway has only one public IP address which internally provide redundancy or failover. + * The external VPN gateway has only one public IP address which internally + * provide redundancy or failover. * * Generated from protobuf enum SINGLE_IP_INTERNALLY_REDUNDANT = 133914873; */ const SINGLE_IP_INTERNALLY_REDUNDANT = 133914873; /** - * The external VPN gateway has two public IP addresses which are redundant with each other, the following two types of setup on your on-premises side would have this type of redundancy: (1) Two separate on-premises gateways, each with one public IP address, the two on-premises gateways are redundant with each other. (2) A single on-premise gateway with two public IP addresses that are redundant with eatch other. + * The external VPN gateway has two public IP addresses which are redundant + * with each other, the following two types of setup on your on-premises + * side would have this type of redundancy: + * (1) Two separate on-premises gateways, each with one public IP address, + * the two on-premises gateways are redundant with each other. + * (2) A single on-premise gateway with two public IP addresses that are + * redundant with eatch other. * * Generated from protobuf enum TWO_IPS_REDUNDANCY = 367049635; */ diff --git a/Compute/src/V1/ExternalVpnGatewayInterface.php b/Compute/src/V1/ExternalVpnGatewayInterface.php index be6f9b269d5e..5164d8e0f5a2 100644 --- a/Compute/src/V1/ExternalVpnGatewayInterface.php +++ b/Compute/src/V1/ExternalVpnGatewayInterface.php @@ -16,19 +16,32 @@ class ExternalVpnGatewayInterface extends \Google\Protobuf\Internal\Message { /** - * The numeric ID of this interface. The allowed input values for this id for different redundancy types of external VPN gateway: - SINGLE_IP_INTERNALLY_REDUNDANT - 0 - TWO_IPS_REDUNDANCY - 0, 1 - FOUR_IPS_REDUNDANCY - 0, 1, 2, 3 + * The numeric ID of this interface. + * The allowed input values for this id for different redundancy types of + * external VPN gateway: + * - SINGLE_IP_INTERNALLY_REDUNDANT - 0 + * - TWO_IPS_REDUNDANCY - 0, 1 + * - FOUR_IPS_REDUNDANCY - 0, 1, 2, 3 * * Generated from protobuf field optional uint32 id = 3355; */ protected $id = null; /** - * IP address of the interface in the external VPN gateway. Only IPv4 is supported. This IP address can be either from your on-premise gateway or another Cloud provider's VPN gateway, it cannot be an IP address from Google Compute Engine. + * IP address of the interface in the external VPN gateway. Only IPv4 is + * supported. This IP address can be either from your on-premise gateway or + * another Cloud provider's VPN gateway, it cannot be an IP address from + * Google Compute Engine. * * Generated from protobuf field optional string ip_address = 406272220; */ protected $ip_address = null; /** - * IPv6 address of the interface in the external VPN gateway. This IPv6 address can be either from your on-premise gateway or another Cloud provider's VPN gateway, it cannot be an IP address from Google Compute Engine. Must specify an IPv6 address (not IPV4-mapped) using any format described in RFC 4291 (e.g. 2001:db8:0:0:2d9:51:0:0). The output format is RFC 5952 format (e.g. 2001:db8::2d9:51:0:0). + * IPv6 address of the interface in the external VPN gateway. This IPv6 + * address can be either from your on-premise gateway or another Cloud + * provider's VPN gateway, it cannot be an IP address from Google Compute + * Engine. Must specify an IPv6 address (not IPV4-mapped) using any format + * described in RFC 4291 (e.g. 2001:db8:0:0:2d9:51:0:0). The output format + * is RFC 5952 format (e.g. 2001:db8::2d9:51:0:0). * * Generated from protobuf field optional string ipv6_address = 341563804; */ @@ -41,11 +54,24 @@ class ExternalVpnGatewayInterface extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type int $id - * The numeric ID of this interface. The allowed input values for this id for different redundancy types of external VPN gateway: - SINGLE_IP_INTERNALLY_REDUNDANT - 0 - TWO_IPS_REDUNDANCY - 0, 1 - FOUR_IPS_REDUNDANCY - 0, 1, 2, 3 + * The numeric ID of this interface. + * The allowed input values for this id for different redundancy types of + * external VPN gateway: + * - SINGLE_IP_INTERNALLY_REDUNDANT - 0 + * - TWO_IPS_REDUNDANCY - 0, 1 + * - FOUR_IPS_REDUNDANCY - 0, 1, 2, 3 * @type string $ip_address - * IP address of the interface in the external VPN gateway. Only IPv4 is supported. This IP address can be either from your on-premise gateway or another Cloud provider's VPN gateway, it cannot be an IP address from Google Compute Engine. + * IP address of the interface in the external VPN gateway. Only IPv4 is + * supported. This IP address can be either from your on-premise gateway or + * another Cloud provider's VPN gateway, it cannot be an IP address from + * Google Compute Engine. * @type string $ipv6_address - * IPv6 address of the interface in the external VPN gateway. This IPv6 address can be either from your on-premise gateway or another Cloud provider's VPN gateway, it cannot be an IP address from Google Compute Engine. Must specify an IPv6 address (not IPV4-mapped) using any format described in RFC 4291 (e.g. 2001:db8:0:0:2d9:51:0:0). The output format is RFC 5952 format (e.g. 2001:db8::2d9:51:0:0). + * IPv6 address of the interface in the external VPN gateway. This IPv6 + * address can be either from your on-premise gateway or another Cloud + * provider's VPN gateway, it cannot be an IP address from Google Compute + * Engine. Must specify an IPv6 address (not IPV4-mapped) using any format + * described in RFC 4291 (e.g. 2001:db8:0:0:2d9:51:0:0). The output format + * is RFC 5952 format (e.g. 2001:db8::2d9:51:0:0). * } */ public function __construct($data = NULL) { @@ -54,7 +80,12 @@ public function __construct($data = NULL) { } /** - * The numeric ID of this interface. The allowed input values for this id for different redundancy types of external VPN gateway: - SINGLE_IP_INTERNALLY_REDUNDANT - 0 - TWO_IPS_REDUNDANCY - 0, 1 - FOUR_IPS_REDUNDANCY - 0, 1, 2, 3 + * The numeric ID of this interface. + * The allowed input values for this id for different redundancy types of + * external VPN gateway: + * - SINGLE_IP_INTERNALLY_REDUNDANT - 0 + * - TWO_IPS_REDUNDANCY - 0, 1 + * - FOUR_IPS_REDUNDANCY - 0, 1, 2, 3 * * Generated from protobuf field optional uint32 id = 3355; * @return int @@ -75,7 +106,12 @@ public function clearId() } /** - * The numeric ID of this interface. The allowed input values for this id for different redundancy types of external VPN gateway: - SINGLE_IP_INTERNALLY_REDUNDANT - 0 - TWO_IPS_REDUNDANCY - 0, 1 - FOUR_IPS_REDUNDANCY - 0, 1, 2, 3 + * The numeric ID of this interface. + * The allowed input values for this id for different redundancy types of + * external VPN gateway: + * - SINGLE_IP_INTERNALLY_REDUNDANT - 0 + * - TWO_IPS_REDUNDANCY - 0, 1 + * - FOUR_IPS_REDUNDANCY - 0, 1, 2, 3 * * Generated from protobuf field optional uint32 id = 3355; * @param int $var @@ -90,7 +126,10 @@ public function setId($var) } /** - * IP address of the interface in the external VPN gateway. Only IPv4 is supported. This IP address can be either from your on-premise gateway or another Cloud provider's VPN gateway, it cannot be an IP address from Google Compute Engine. + * IP address of the interface in the external VPN gateway. Only IPv4 is + * supported. This IP address can be either from your on-premise gateway or + * another Cloud provider's VPN gateway, it cannot be an IP address from + * Google Compute Engine. * * Generated from protobuf field optional string ip_address = 406272220; * @return string @@ -111,7 +150,10 @@ public function clearIpAddress() } /** - * IP address of the interface in the external VPN gateway. Only IPv4 is supported. This IP address can be either from your on-premise gateway or another Cloud provider's VPN gateway, it cannot be an IP address from Google Compute Engine. + * IP address of the interface in the external VPN gateway. Only IPv4 is + * supported. This IP address can be either from your on-premise gateway or + * another Cloud provider's VPN gateway, it cannot be an IP address from + * Google Compute Engine. * * Generated from protobuf field optional string ip_address = 406272220; * @param string $var @@ -126,7 +168,12 @@ public function setIpAddress($var) } /** - * IPv6 address of the interface in the external VPN gateway. This IPv6 address can be either from your on-premise gateway or another Cloud provider's VPN gateway, it cannot be an IP address from Google Compute Engine. Must specify an IPv6 address (not IPV4-mapped) using any format described in RFC 4291 (e.g. 2001:db8:0:0:2d9:51:0:0). The output format is RFC 5952 format (e.g. 2001:db8::2d9:51:0:0). + * IPv6 address of the interface in the external VPN gateway. This IPv6 + * address can be either from your on-premise gateway or another Cloud + * provider's VPN gateway, it cannot be an IP address from Google Compute + * Engine. Must specify an IPv6 address (not IPV4-mapped) using any format + * described in RFC 4291 (e.g. 2001:db8:0:0:2d9:51:0:0). The output format + * is RFC 5952 format (e.g. 2001:db8::2d9:51:0:0). * * Generated from protobuf field optional string ipv6_address = 341563804; * @return string @@ -147,7 +194,12 @@ public function clearIpv6Address() } /** - * IPv6 address of the interface in the external VPN gateway. This IPv6 address can be either from your on-premise gateway or another Cloud provider's VPN gateway, it cannot be an IP address from Google Compute Engine. Must specify an IPv6 address (not IPV4-mapped) using any format described in RFC 4291 (e.g. 2001:db8:0:0:2d9:51:0:0). The output format is RFC 5952 format (e.g. 2001:db8::2d9:51:0:0). + * IPv6 address of the interface in the external VPN gateway. This IPv6 + * address can be either from your on-premise gateway or another Cloud + * provider's VPN gateway, it cannot be an IP address from Google Compute + * Engine. Must specify an IPv6 address (not IPV4-mapped) using any format + * described in RFC 4291 (e.g. 2001:db8:0:0:2d9:51:0:0). The output format + * is RFC 5952 format (e.g. 2001:db8::2d9:51:0:0). * * Generated from protobuf field optional string ipv6_address = 341563804; * @param string $var diff --git a/Compute/src/V1/ExternalVpnGatewayList.php b/Compute/src/V1/ExternalVpnGatewayList.php index 04cd872b1a6b..a2fe7ecc0bfc 100644 --- a/Compute/src/V1/ExternalVpnGatewayList.php +++ b/Compute/src/V1/ExternalVpnGatewayList.php @@ -38,7 +38,11 @@ class ExternalVpnGatewayList extends \Google\Protobuf\Internal\Message */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -70,7 +74,11 @@ class ExternalVpnGatewayList extends \Google\Protobuf\Internal\Message * @type string $kind * [Output Only] Type of resource. Always compute#externalVpnGatewayList for lists of externalVpnGateways. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type \Google\Cloud\Compute\V1\Warning $warning @@ -213,7 +221,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -234,7 +246,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/Firewall.php b/Compute/src/V1/Firewall.php index e247babb20d2..7eaf423fa442 100644 --- a/Compute/src/V1/Firewall.php +++ b/Compute/src/V1/Firewall.php @@ -9,93 +9,133 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Represents a Firewall Rule resource. Firewall rules allow or deny ingress traffic to, and egress traffic from your instances. For more information, read Firewall rules. + * Represents a Firewall Rule resource. + * Firewall rules allow or deny ingress traffic to, and egress traffic from your + * instances. For more information, readFirewall rules. * * Generated from protobuf message google.cloud.compute.v1.Firewall */ class Firewall extends \Google\Protobuf\Internal\Message { /** - * The list of ALLOW rules specified by this firewall. Each rule specifies a protocol and port-range tuple that describes a permitted connection. + * The list of ALLOW rules specified by this firewall. Each rule specifies a + * protocol and port-range tuple that describes a permitted connection. * * Generated from protobuf field repeated .google.cloud.compute.v1.Allowed allowed = 162398632; */ private $allowed; /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; */ protected $creation_timestamp = null; /** - * The list of DENY rules specified by this firewall. Each rule specifies a protocol and port-range tuple that describes a denied connection. + * The list of DENY rules specified by this firewall. Each rule specifies a + * protocol and port-range tuple that describes a denied connection. * * Generated from protobuf field repeated .google.cloud.compute.v1.Denied denied = 275217307; */ private $denied; /** - * An optional description of this resource. Provide this field when you create the resource. + * An optional description of this resource. Provide this field when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; */ protected $description = null; /** - * If destination ranges are specified, the firewall rule applies only to traffic that has destination IP address in these ranges. These ranges must be expressed in CIDR format. Both IPv4 and IPv6 are supported. + * If destination ranges are specified, the firewall rule applies only to + * traffic that has destination IP address in these ranges. These ranges must + * be expressed inCIDR format. Both IPv4 and IPv6 are supported. * * Generated from protobuf field repeated string destination_ranges = 305699879; */ private $destination_ranges; /** - * Direction of traffic to which this firewall applies, either `INGRESS` or `EGRESS`. The default is `INGRESS`. For `EGRESS` traffic, you cannot specify the sourceTags fields. + * Direction of traffic to which this firewall applies, either `INGRESS` or + * `EGRESS`. The default is `INGRESS`. For `EGRESS` traffic, you cannot + * specify the sourceTags fields. * Check the Direction enum for the list of possible values. * * Generated from protobuf field optional string direction = 111150975; */ protected $direction = null; /** - * Denotes whether the firewall rule is disabled. When set to true, the firewall rule is not enforced and the network behaves as if it did not exist. If this is unspecified, the firewall rule will be enabled. + * Denotes whether the firewall rule is disabled. When set to true, the + * firewall rule is not enforced and the network behaves as if it did not + * exist. If this is unspecified, the firewall rule will be enabled. * * Generated from protobuf field optional bool disabled = 270940796; */ protected $disabled = null; /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; */ protected $id = null; /** - * [Output Only] Type of the resource. Always compute#firewall for firewall rules. + * [Output Only] Type of the resource. Always compute#firewall + * for firewall rules. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * This field denotes the logging options for a particular firewall rule. If logging is enabled, logs will be exported to Cloud Logging. + * This field denotes the logging options for a particular firewall rule. If + * logging is enabled, logs will be exported to Cloud Logging. * * Generated from protobuf field optional .google.cloud.compute.v1.FirewallLogConfig log_config = 351299741; */ protected $log_config = null; /** - * Name of the resource; provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?`. The first character must be a lowercase letter, and all following characters (except for the last character) must be a dash, lowercase letter, or digit. The last character must be a lowercase letter or digit. + * Name of the resource; provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?`. The first character + * must be a lowercase letter, and all following characters (except for the + * last character) must be a dash, lowercase letter, or digit. The last + * character must be a lowercase letter or digit. * * Generated from protobuf field optional string name = 3373707; */ protected $name = null; /** - * URL of the network resource for this firewall rule. If not specified when creating a firewall rule, the default network is used: global/networks/default If you choose to specify this field, you can specify the network as a full or partial URL. For example, the following are all valid URLs: - https://www.googleapis.com/compute/v1/projects/myproject/global/networks/my-network - projects/myproject/global/networks/my-network - global/networks/default + * URL of the network resource for this firewall rule. If not + * specified when creating a firewall rule, the default network + * is used: + * global/networks/default + * If you choose to specify this field, you can specify the network as a full + * or partial URL. For example, the following are all valid URLs: + * - + * https://www.googleapis.com/compute/v1/projects/myproject/global/networks/my-network + * - projects/myproject/global/networks/my-network + * - global/networks/default * * Generated from protobuf field optional string network = 232872494; */ protected $network = null; /** - * Input only. [Input Only] Additional params passed with the request, but not persisted as part of resource payload. + * Input only. [Input Only] Additional params passed with the request, but not persisted + * as part of resource payload. * * Generated from protobuf field optional .google.cloud.compute.v1.FirewallParams params = 78313862; */ protected $params = null; /** - * Priority for this rule. This is an integer between `0` and `65535`, both inclusive. The default value is `1000`. Relative priorities determine which rule takes effect if multiple rules apply. Lower values indicate higher priority. For example, a rule with priority `0` has higher precedence than a rule with priority `1`. DENY rules take precedence over ALLOW rules if they have equal priority. Note that VPC networks have implied rules with a priority of `65535`. To avoid conflicts with the implied rules, use a priority number less than `65535`. + * Priority for this rule. + * This is an integer between `0` and `65535`, both inclusive. + * The default value is `1000`. + * Relative priorities determine which rule takes effect if multiple rules + * apply. Lower values indicate higher priority. For example, a rule with + * priority `0` has higher precedence than a rule with priority `1`. + * DENY rules take precedence over ALLOW rules if they have equal priority. + * Note that VPC networks have implied + * rules with a priority of `65535`. To avoid conflicts with the implied + * rules, use a priority number less than `65535`. * * Generated from protobuf field optional int32 priority = 445151652; */ @@ -107,31 +147,66 @@ class Firewall extends \Google\Protobuf\Internal\Message */ protected $self_link = null; /** - * If source ranges are specified, the firewall rule applies only to traffic that has a source IP address in these ranges. These ranges must be expressed in CIDR format. One or both of sourceRanges and sourceTags may be set. If both fields are set, the rule applies to traffic that has a source IP address within sourceRanges OR a source IP from a resource with a matching tag listed in the sourceTags field. The connection does not need to match both fields for the rule to apply. Both IPv4 and IPv6 are supported. + * If source ranges are specified, the firewall rule applies only to traffic + * that has a source IP address in these ranges. These ranges must be + * expressed inCIDR format. One or both of sourceRanges + * and sourceTags may be set. + * If both fields are set, the rule applies to traffic that has a + * source IP address within sourceRanges OR a source IP + * from a resource with a matching tag listed in thesourceTags field. The connection does not need to match + * both fields for the rule to + * apply. Both IPv4 and IPv6 are supported. * * Generated from protobuf field repeated string source_ranges = 200097658; */ private $source_ranges; /** - * If source service accounts are specified, the firewall rules apply only to traffic originating from an instance with a service account in this list. Source service accounts cannot be used to control traffic to an instance's external IP address because service accounts are associated with an instance, not an IP address. sourceRanges can be set at the same time as sourceServiceAccounts. If both are set, the firewall applies to traffic that has a source IP address within the sourceRanges OR a source IP that belongs to an instance with service account listed in sourceServiceAccount. The connection does not need to match both fields for the firewall to apply. sourceServiceAccounts cannot be used at the same time as sourceTags or targetTags. + * If source service accounts are specified, the firewall rules apply only to + * traffic originating from an instance with a service account in this list. + * Source service accounts cannot be used to control traffic to an instance's + * external IP address because service accounts are associated with an + * instance, not an IP address.sourceRanges can be set at the same time assourceServiceAccounts. + * If both are set, the firewall applies to traffic that + * has a source IP address within the sourceRanges OR a source + * IP that belongs to an instance with service account listed insourceServiceAccount. The connection does not need to match + * both fields for the firewall to apply.sourceServiceAccounts cannot be used at the same time assourceTags or targetTags. * * Generated from protobuf field repeated string source_service_accounts = 105100756; */ private $source_service_accounts; /** - * If source tags are specified, the firewall rule applies only to traffic with source IPs that match the primary network interfaces of VM instances that have the tag and are in the same VPC network. Source tags cannot be used to control traffic to an instance's external IP address, it only applies to traffic between instances in the same virtual network. Because tags are associated with instances, not IP addresses. One or both of sourceRanges and sourceTags may be set. If both fields are set, the firewall applies to traffic that has a source IP address within sourceRanges OR a source IP from a resource with a matching tag listed in the sourceTags field. The connection does not need to match both fields for the firewall to apply. + * If source tags are specified, the firewall rule applies only to traffic + * with source IPs that match the primary network interfaces of VM instances + * that have the tag and are in the same VPC network. + * Source tags cannot be used to control traffic to an instance's external IP + * address, it only applies to traffic between instances in the same virtual + * network. Because tags are associated with instances, not IP addresses. + * One or both of sourceRanges and sourceTags may be + * set. If both fields are set, the firewall applies to traffic that has a + * source IP address within sourceRanges OR a source IP from a + * resource with a matching tag listed in the sourceTags + * field. The connection does not need to match both fields for the + * firewall to apply. * * Generated from protobuf field repeated string source_tags = 452222397; */ private $source_tags; /** - * A list of service accounts indicating sets of instances located in the network that may make network connections as specified in allowed[]. targetServiceAccounts cannot be used at the same time as targetTags or sourceTags. If neither targetServiceAccounts nor targetTags are specified, the firewall rule applies to all instances on the specified network. + * A list of service accounts indicating sets of instances located in the + * network that may make network connections as specified inallowed[].targetServiceAccounts cannot be used at the same time astargetTags or sourceTags. + * If neither targetServiceAccounts nor targetTags + * are specified, the firewall rule applies to all instances on the specified + * network. * * Generated from protobuf field repeated string target_service_accounts = 457639710; */ private $target_service_accounts; /** - * A list of tags that controls which instances the firewall rule applies to. If targetTags are specified, then the firewall rule applies only to instances in the VPC network that have one of those tags. If no targetTags are specified, the firewall rule applies to all instances on the specified network. + * A list of tags that controls which instances the firewall rule + * applies to. If targetTags are specified, then the firewall + * rule applies only to instances in the VPC network that have one of those + * tags. If no targetTags are specified, the firewall rule + * applies to all instances on the specified network. * * Generated from protobuf field repeated string target_tags = 62901767; */ @@ -144,46 +219,119 @@ class Firewall extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type array<\Google\Cloud\Compute\V1\Allowed>|\Google\Protobuf\Internal\RepeatedField $allowed - * The list of ALLOW rules specified by this firewall. Each rule specifies a protocol and port-range tuple that describes a permitted connection. + * The list of ALLOW rules specified by this firewall. Each rule specifies a + * protocol and port-range tuple that describes a permitted connection. * @type string $creation_timestamp - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * @type array<\Google\Cloud\Compute\V1\Denied>|\Google\Protobuf\Internal\RepeatedField $denied - * The list of DENY rules specified by this firewall. Each rule specifies a protocol and port-range tuple that describes a denied connection. + * The list of DENY rules specified by this firewall. Each rule specifies a + * protocol and port-range tuple that describes a denied connection. * @type string $description - * An optional description of this resource. Provide this field when you create the resource. + * An optional description of this resource. Provide this field when you + * create the resource. * @type array|\Google\Protobuf\Internal\RepeatedField $destination_ranges - * If destination ranges are specified, the firewall rule applies only to traffic that has destination IP address in these ranges. These ranges must be expressed in CIDR format. Both IPv4 and IPv6 are supported. + * If destination ranges are specified, the firewall rule applies only to + * traffic that has destination IP address in these ranges. These ranges must + * be expressed inCIDR format. Both IPv4 and IPv6 are supported. * @type string $direction - * Direction of traffic to which this firewall applies, either `INGRESS` or `EGRESS`. The default is `INGRESS`. For `EGRESS` traffic, you cannot specify the sourceTags fields. + * Direction of traffic to which this firewall applies, either `INGRESS` or + * `EGRESS`. The default is `INGRESS`. For `EGRESS` traffic, you cannot + * specify the sourceTags fields. * Check the Direction enum for the list of possible values. * @type bool $disabled - * Denotes whether the firewall rule is disabled. When set to true, the firewall rule is not enforced and the network behaves as if it did not exist. If this is unspecified, the firewall rule will be enabled. + * Denotes whether the firewall rule is disabled. When set to true, the + * firewall rule is not enforced and the network behaves as if it did not + * exist. If this is unspecified, the firewall rule will be enabled. * @type int|string $id - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * @type string $kind - * [Output Only] Type of the resource. Always compute#firewall for firewall rules. + * [Output Only] Type of the resource. Always compute#firewall + * for firewall rules. * @type \Google\Cloud\Compute\V1\FirewallLogConfig $log_config - * This field denotes the logging options for a particular firewall rule. If logging is enabled, logs will be exported to Cloud Logging. + * This field denotes the logging options for a particular firewall rule. If + * logging is enabled, logs will be exported to Cloud Logging. * @type string $name - * Name of the resource; provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?`. The first character must be a lowercase letter, and all following characters (except for the last character) must be a dash, lowercase letter, or digit. The last character must be a lowercase letter or digit. + * Name of the resource; provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?`. The first character + * must be a lowercase letter, and all following characters (except for the + * last character) must be a dash, lowercase letter, or digit. The last + * character must be a lowercase letter or digit. * @type string $network - * URL of the network resource for this firewall rule. If not specified when creating a firewall rule, the default network is used: global/networks/default If you choose to specify this field, you can specify the network as a full or partial URL. For example, the following are all valid URLs: - https://www.googleapis.com/compute/v1/projects/myproject/global/networks/my-network - projects/myproject/global/networks/my-network - global/networks/default + * URL of the network resource for this firewall rule. If not + * specified when creating a firewall rule, the default network + * is used: + * global/networks/default + * If you choose to specify this field, you can specify the network as a full + * or partial URL. For example, the following are all valid URLs: + * - + * https://www.googleapis.com/compute/v1/projects/myproject/global/networks/my-network + * - projects/myproject/global/networks/my-network + * - global/networks/default * @type \Google\Cloud\Compute\V1\FirewallParams $params - * Input only. [Input Only] Additional params passed with the request, but not persisted as part of resource payload. + * Input only. [Input Only] Additional params passed with the request, but not persisted + * as part of resource payload. * @type int $priority - * Priority for this rule. This is an integer between `0` and `65535`, both inclusive. The default value is `1000`. Relative priorities determine which rule takes effect if multiple rules apply. Lower values indicate higher priority. For example, a rule with priority `0` has higher precedence than a rule with priority `1`. DENY rules take precedence over ALLOW rules if they have equal priority. Note that VPC networks have implied rules with a priority of `65535`. To avoid conflicts with the implied rules, use a priority number less than `65535`. + * Priority for this rule. + * This is an integer between `0` and `65535`, both inclusive. + * The default value is `1000`. + * Relative priorities determine which rule takes effect if multiple rules + * apply. Lower values indicate higher priority. For example, a rule with + * priority `0` has higher precedence than a rule with priority `1`. + * DENY rules take precedence over ALLOW rules if they have equal priority. + * Note that VPC networks have implied + * rules with a priority of `65535`. To avoid conflicts with the implied + * rules, use a priority number less than `65535`. * @type string $self_link * [Output Only] Server-defined URL for the resource. * @type array|\Google\Protobuf\Internal\RepeatedField $source_ranges - * If source ranges are specified, the firewall rule applies only to traffic that has a source IP address in these ranges. These ranges must be expressed in CIDR format. One or both of sourceRanges and sourceTags may be set. If both fields are set, the rule applies to traffic that has a source IP address within sourceRanges OR a source IP from a resource with a matching tag listed in the sourceTags field. The connection does not need to match both fields for the rule to apply. Both IPv4 and IPv6 are supported. + * If source ranges are specified, the firewall rule applies only to traffic + * that has a source IP address in these ranges. These ranges must be + * expressed inCIDR format. One or both of sourceRanges + * and sourceTags may be set. + * If both fields are set, the rule applies to traffic that has a + * source IP address within sourceRanges OR a source IP + * from a resource with a matching tag listed in thesourceTags field. The connection does not need to match + * both fields for the rule to + * apply. Both IPv4 and IPv6 are supported. * @type array|\Google\Protobuf\Internal\RepeatedField $source_service_accounts - * If source service accounts are specified, the firewall rules apply only to traffic originating from an instance with a service account in this list. Source service accounts cannot be used to control traffic to an instance's external IP address because service accounts are associated with an instance, not an IP address. sourceRanges can be set at the same time as sourceServiceAccounts. If both are set, the firewall applies to traffic that has a source IP address within the sourceRanges OR a source IP that belongs to an instance with service account listed in sourceServiceAccount. The connection does not need to match both fields for the firewall to apply. sourceServiceAccounts cannot be used at the same time as sourceTags or targetTags. + * If source service accounts are specified, the firewall rules apply only to + * traffic originating from an instance with a service account in this list. + * Source service accounts cannot be used to control traffic to an instance's + * external IP address because service accounts are associated with an + * instance, not an IP address.sourceRanges can be set at the same time assourceServiceAccounts. + * If both are set, the firewall applies to traffic that + * has a source IP address within the sourceRanges OR a source + * IP that belongs to an instance with service account listed insourceServiceAccount. The connection does not need to match + * both fields for the firewall to apply.sourceServiceAccounts cannot be used at the same time assourceTags or targetTags. * @type array|\Google\Protobuf\Internal\RepeatedField $source_tags - * If source tags are specified, the firewall rule applies only to traffic with source IPs that match the primary network interfaces of VM instances that have the tag and are in the same VPC network. Source tags cannot be used to control traffic to an instance's external IP address, it only applies to traffic between instances in the same virtual network. Because tags are associated with instances, not IP addresses. One or both of sourceRanges and sourceTags may be set. If both fields are set, the firewall applies to traffic that has a source IP address within sourceRanges OR a source IP from a resource with a matching tag listed in the sourceTags field. The connection does not need to match both fields for the firewall to apply. + * If source tags are specified, the firewall rule applies only to traffic + * with source IPs that match the primary network interfaces of VM instances + * that have the tag and are in the same VPC network. + * Source tags cannot be used to control traffic to an instance's external IP + * address, it only applies to traffic between instances in the same virtual + * network. Because tags are associated with instances, not IP addresses. + * One or both of sourceRanges and sourceTags may be + * set. If both fields are set, the firewall applies to traffic that has a + * source IP address within sourceRanges OR a source IP from a + * resource with a matching tag listed in the sourceTags + * field. The connection does not need to match both fields for the + * firewall to apply. * @type array|\Google\Protobuf\Internal\RepeatedField $target_service_accounts - * A list of service accounts indicating sets of instances located in the network that may make network connections as specified in allowed[]. targetServiceAccounts cannot be used at the same time as targetTags or sourceTags. If neither targetServiceAccounts nor targetTags are specified, the firewall rule applies to all instances on the specified network. + * A list of service accounts indicating sets of instances located in the + * network that may make network connections as specified inallowed[].targetServiceAccounts cannot be used at the same time astargetTags or sourceTags. + * If neither targetServiceAccounts nor targetTags + * are specified, the firewall rule applies to all instances on the specified + * network. * @type array|\Google\Protobuf\Internal\RepeatedField $target_tags - * A list of tags that controls which instances the firewall rule applies to. If targetTags are specified, then the firewall rule applies only to instances in the VPC network that have one of those tags. If no targetTags are specified, the firewall rule applies to all instances on the specified network. + * A list of tags that controls which instances the firewall rule + * applies to. If targetTags are specified, then the firewall + * rule applies only to instances in the VPC network that have one of those + * tags. If no targetTags are specified, the firewall rule + * applies to all instances on the specified network. * } */ public function __construct($data = NULL) { @@ -192,7 +340,8 @@ public function __construct($data = NULL) { } /** - * The list of ALLOW rules specified by this firewall. Each rule specifies a protocol and port-range tuple that describes a permitted connection. + * The list of ALLOW rules specified by this firewall. Each rule specifies a + * protocol and port-range tuple that describes a permitted connection. * * Generated from protobuf field repeated .google.cloud.compute.v1.Allowed allowed = 162398632; * @return \Google\Protobuf\Internal\RepeatedField @@ -203,7 +352,8 @@ public function getAllowed() } /** - * The list of ALLOW rules specified by this firewall. Each rule specifies a protocol and port-range tuple that describes a permitted connection. + * The list of ALLOW rules specified by this firewall. Each rule specifies a + * protocol and port-range tuple that describes a permitted connection. * * Generated from protobuf field repeated .google.cloud.compute.v1.Allowed allowed = 162398632; * @param array<\Google\Cloud\Compute\V1\Allowed>|\Google\Protobuf\Internal\RepeatedField $var @@ -218,7 +368,8 @@ public function setAllowed($var) } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @return string @@ -239,7 +390,8 @@ public function clearCreationTimestamp() } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @param string $var @@ -254,7 +406,8 @@ public function setCreationTimestamp($var) } /** - * The list of DENY rules specified by this firewall. Each rule specifies a protocol and port-range tuple that describes a denied connection. + * The list of DENY rules specified by this firewall. Each rule specifies a + * protocol and port-range tuple that describes a denied connection. * * Generated from protobuf field repeated .google.cloud.compute.v1.Denied denied = 275217307; * @return \Google\Protobuf\Internal\RepeatedField @@ -265,7 +418,8 @@ public function getDenied() } /** - * The list of DENY rules specified by this firewall. Each rule specifies a protocol and port-range tuple that describes a denied connection. + * The list of DENY rules specified by this firewall. Each rule specifies a + * protocol and port-range tuple that describes a denied connection. * * Generated from protobuf field repeated .google.cloud.compute.v1.Denied denied = 275217307; * @param array<\Google\Cloud\Compute\V1\Denied>|\Google\Protobuf\Internal\RepeatedField $var @@ -280,7 +434,8 @@ public function setDenied($var) } /** - * An optional description of this resource. Provide this field when you create the resource. + * An optional description of this resource. Provide this field when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @return string @@ -301,7 +456,8 @@ public function clearDescription() } /** - * An optional description of this resource. Provide this field when you create the resource. + * An optional description of this resource. Provide this field when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @param string $var @@ -316,7 +472,9 @@ public function setDescription($var) } /** - * If destination ranges are specified, the firewall rule applies only to traffic that has destination IP address in these ranges. These ranges must be expressed in CIDR format. Both IPv4 and IPv6 are supported. + * If destination ranges are specified, the firewall rule applies only to + * traffic that has destination IP address in these ranges. These ranges must + * be expressed inCIDR format. Both IPv4 and IPv6 are supported. * * Generated from protobuf field repeated string destination_ranges = 305699879; * @return \Google\Protobuf\Internal\RepeatedField @@ -327,7 +485,9 @@ public function getDestinationRanges() } /** - * If destination ranges are specified, the firewall rule applies only to traffic that has destination IP address in these ranges. These ranges must be expressed in CIDR format. Both IPv4 and IPv6 are supported. + * If destination ranges are specified, the firewall rule applies only to + * traffic that has destination IP address in these ranges. These ranges must + * be expressed inCIDR format. Both IPv4 and IPv6 are supported. * * Generated from protobuf field repeated string destination_ranges = 305699879; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -342,7 +502,9 @@ public function setDestinationRanges($var) } /** - * Direction of traffic to which this firewall applies, either `INGRESS` or `EGRESS`. The default is `INGRESS`. For `EGRESS` traffic, you cannot specify the sourceTags fields. + * Direction of traffic to which this firewall applies, either `INGRESS` or + * `EGRESS`. The default is `INGRESS`. For `EGRESS` traffic, you cannot + * specify the sourceTags fields. * Check the Direction enum for the list of possible values. * * Generated from protobuf field optional string direction = 111150975; @@ -364,7 +526,9 @@ public function clearDirection() } /** - * Direction of traffic to which this firewall applies, either `INGRESS` or `EGRESS`. The default is `INGRESS`. For `EGRESS` traffic, you cannot specify the sourceTags fields. + * Direction of traffic to which this firewall applies, either `INGRESS` or + * `EGRESS`. The default is `INGRESS`. For `EGRESS` traffic, you cannot + * specify the sourceTags fields. * Check the Direction enum for the list of possible values. * * Generated from protobuf field optional string direction = 111150975; @@ -380,7 +544,9 @@ public function setDirection($var) } /** - * Denotes whether the firewall rule is disabled. When set to true, the firewall rule is not enforced and the network behaves as if it did not exist. If this is unspecified, the firewall rule will be enabled. + * Denotes whether the firewall rule is disabled. When set to true, the + * firewall rule is not enforced and the network behaves as if it did not + * exist. If this is unspecified, the firewall rule will be enabled. * * Generated from protobuf field optional bool disabled = 270940796; * @return bool @@ -401,7 +567,9 @@ public function clearDisabled() } /** - * Denotes whether the firewall rule is disabled. When set to true, the firewall rule is not enforced and the network behaves as if it did not exist. If this is unspecified, the firewall rule will be enabled. + * Denotes whether the firewall rule is disabled. When set to true, the + * firewall rule is not enforced and the network behaves as if it did not + * exist. If this is unspecified, the firewall rule will be enabled. * * Generated from protobuf field optional bool disabled = 270940796; * @param bool $var @@ -416,7 +584,8 @@ public function setDisabled($var) } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @return int|string @@ -437,7 +606,8 @@ public function clearId() } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @param int|string $var @@ -452,7 +622,8 @@ public function setId($var) } /** - * [Output Only] Type of the resource. Always compute#firewall for firewall rules. + * [Output Only] Type of the resource. Always compute#firewall + * for firewall rules. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -473,7 +644,8 @@ public function clearKind() } /** - * [Output Only] Type of the resource. Always compute#firewall for firewall rules. + * [Output Only] Type of the resource. Always compute#firewall + * for firewall rules. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -488,7 +660,8 @@ public function setKind($var) } /** - * This field denotes the logging options for a particular firewall rule. If logging is enabled, logs will be exported to Cloud Logging. + * This field denotes the logging options for a particular firewall rule. If + * logging is enabled, logs will be exported to Cloud Logging. * * Generated from protobuf field optional .google.cloud.compute.v1.FirewallLogConfig log_config = 351299741; * @return \Google\Cloud\Compute\V1\FirewallLogConfig|null @@ -509,7 +682,8 @@ public function clearLogConfig() } /** - * This field denotes the logging options for a particular firewall rule. If logging is enabled, logs will be exported to Cloud Logging. + * This field denotes the logging options for a particular firewall rule. If + * logging is enabled, logs will be exported to Cloud Logging. * * Generated from protobuf field optional .google.cloud.compute.v1.FirewallLogConfig log_config = 351299741; * @param \Google\Cloud\Compute\V1\FirewallLogConfig $var @@ -524,7 +698,13 @@ public function setLogConfig($var) } /** - * Name of the resource; provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?`. The first character must be a lowercase letter, and all following characters (except for the last character) must be a dash, lowercase letter, or digit. The last character must be a lowercase letter or digit. + * Name of the resource; provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?`. The first character + * must be a lowercase letter, and all following characters (except for the + * last character) must be a dash, lowercase letter, or digit. The last + * character must be a lowercase letter or digit. * * Generated from protobuf field optional string name = 3373707; * @return string @@ -545,7 +725,13 @@ public function clearName() } /** - * Name of the resource; provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?`. The first character must be a lowercase letter, and all following characters (except for the last character) must be a dash, lowercase letter, or digit. The last character must be a lowercase letter or digit. + * Name of the resource; provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?`. The first character + * must be a lowercase letter, and all following characters (except for the + * last character) must be a dash, lowercase letter, or digit. The last + * character must be a lowercase letter or digit. * * Generated from protobuf field optional string name = 3373707; * @param string $var @@ -560,7 +746,16 @@ public function setName($var) } /** - * URL of the network resource for this firewall rule. If not specified when creating a firewall rule, the default network is used: global/networks/default If you choose to specify this field, you can specify the network as a full or partial URL. For example, the following are all valid URLs: - https://www.googleapis.com/compute/v1/projects/myproject/global/networks/my-network - projects/myproject/global/networks/my-network - global/networks/default + * URL of the network resource for this firewall rule. If not + * specified when creating a firewall rule, the default network + * is used: + * global/networks/default + * If you choose to specify this field, you can specify the network as a full + * or partial URL. For example, the following are all valid URLs: + * - + * https://www.googleapis.com/compute/v1/projects/myproject/global/networks/my-network + * - projects/myproject/global/networks/my-network + * - global/networks/default * * Generated from protobuf field optional string network = 232872494; * @return string @@ -581,7 +776,16 @@ public function clearNetwork() } /** - * URL of the network resource for this firewall rule. If not specified when creating a firewall rule, the default network is used: global/networks/default If you choose to specify this field, you can specify the network as a full or partial URL. For example, the following are all valid URLs: - https://www.googleapis.com/compute/v1/projects/myproject/global/networks/my-network - projects/myproject/global/networks/my-network - global/networks/default + * URL of the network resource for this firewall rule. If not + * specified when creating a firewall rule, the default network + * is used: + * global/networks/default + * If you choose to specify this field, you can specify the network as a full + * or partial URL. For example, the following are all valid URLs: + * - + * https://www.googleapis.com/compute/v1/projects/myproject/global/networks/my-network + * - projects/myproject/global/networks/my-network + * - global/networks/default * * Generated from protobuf field optional string network = 232872494; * @param string $var @@ -596,7 +800,8 @@ public function setNetwork($var) } /** - * Input only. [Input Only] Additional params passed with the request, but not persisted as part of resource payload. + * Input only. [Input Only] Additional params passed with the request, but not persisted + * as part of resource payload. * * Generated from protobuf field optional .google.cloud.compute.v1.FirewallParams params = 78313862; * @return \Google\Cloud\Compute\V1\FirewallParams|null @@ -617,7 +822,8 @@ public function clearParams() } /** - * Input only. [Input Only] Additional params passed with the request, but not persisted as part of resource payload. + * Input only. [Input Only] Additional params passed with the request, but not persisted + * as part of resource payload. * * Generated from protobuf field optional .google.cloud.compute.v1.FirewallParams params = 78313862; * @param \Google\Cloud\Compute\V1\FirewallParams $var @@ -632,7 +838,16 @@ public function setParams($var) } /** - * Priority for this rule. This is an integer between `0` and `65535`, both inclusive. The default value is `1000`. Relative priorities determine which rule takes effect if multiple rules apply. Lower values indicate higher priority. For example, a rule with priority `0` has higher precedence than a rule with priority `1`. DENY rules take precedence over ALLOW rules if they have equal priority. Note that VPC networks have implied rules with a priority of `65535`. To avoid conflicts with the implied rules, use a priority number less than `65535`. + * Priority for this rule. + * This is an integer between `0` and `65535`, both inclusive. + * The default value is `1000`. + * Relative priorities determine which rule takes effect if multiple rules + * apply. Lower values indicate higher priority. For example, a rule with + * priority `0` has higher precedence than a rule with priority `1`. + * DENY rules take precedence over ALLOW rules if they have equal priority. + * Note that VPC networks have implied + * rules with a priority of `65535`. To avoid conflicts with the implied + * rules, use a priority number less than `65535`. * * Generated from protobuf field optional int32 priority = 445151652; * @return int @@ -653,7 +868,16 @@ public function clearPriority() } /** - * Priority for this rule. This is an integer between `0` and `65535`, both inclusive. The default value is `1000`. Relative priorities determine which rule takes effect if multiple rules apply. Lower values indicate higher priority. For example, a rule with priority `0` has higher precedence than a rule with priority `1`. DENY rules take precedence over ALLOW rules if they have equal priority. Note that VPC networks have implied rules with a priority of `65535`. To avoid conflicts with the implied rules, use a priority number less than `65535`. + * Priority for this rule. + * This is an integer between `0` and `65535`, both inclusive. + * The default value is `1000`. + * Relative priorities determine which rule takes effect if multiple rules + * apply. Lower values indicate higher priority. For example, a rule with + * priority `0` has higher precedence than a rule with priority `1`. + * DENY rules take precedence over ALLOW rules if they have equal priority. + * Note that VPC networks have implied + * rules with a priority of `65535`. To avoid conflicts with the implied + * rules, use a priority number less than `65535`. * * Generated from protobuf field optional int32 priority = 445151652; * @param int $var @@ -704,7 +928,15 @@ public function setSelfLink($var) } /** - * If source ranges are specified, the firewall rule applies only to traffic that has a source IP address in these ranges. These ranges must be expressed in CIDR format. One or both of sourceRanges and sourceTags may be set. If both fields are set, the rule applies to traffic that has a source IP address within sourceRanges OR a source IP from a resource with a matching tag listed in the sourceTags field. The connection does not need to match both fields for the rule to apply. Both IPv4 and IPv6 are supported. + * If source ranges are specified, the firewall rule applies only to traffic + * that has a source IP address in these ranges. These ranges must be + * expressed inCIDR format. One or both of sourceRanges + * and sourceTags may be set. + * If both fields are set, the rule applies to traffic that has a + * source IP address within sourceRanges OR a source IP + * from a resource with a matching tag listed in thesourceTags field. The connection does not need to match + * both fields for the rule to + * apply. Both IPv4 and IPv6 are supported. * * Generated from protobuf field repeated string source_ranges = 200097658; * @return \Google\Protobuf\Internal\RepeatedField @@ -715,7 +947,15 @@ public function getSourceRanges() } /** - * If source ranges are specified, the firewall rule applies only to traffic that has a source IP address in these ranges. These ranges must be expressed in CIDR format. One or both of sourceRanges and sourceTags may be set. If both fields are set, the rule applies to traffic that has a source IP address within sourceRanges OR a source IP from a resource with a matching tag listed in the sourceTags field. The connection does not need to match both fields for the rule to apply. Both IPv4 and IPv6 are supported. + * If source ranges are specified, the firewall rule applies only to traffic + * that has a source IP address in these ranges. These ranges must be + * expressed inCIDR format. One or both of sourceRanges + * and sourceTags may be set. + * If both fields are set, the rule applies to traffic that has a + * source IP address within sourceRanges OR a source IP + * from a resource with a matching tag listed in thesourceTags field. The connection does not need to match + * both fields for the rule to + * apply. Both IPv4 and IPv6 are supported. * * Generated from protobuf field repeated string source_ranges = 200097658; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -730,7 +970,15 @@ public function setSourceRanges($var) } /** - * If source service accounts are specified, the firewall rules apply only to traffic originating from an instance with a service account in this list. Source service accounts cannot be used to control traffic to an instance's external IP address because service accounts are associated with an instance, not an IP address. sourceRanges can be set at the same time as sourceServiceAccounts. If both are set, the firewall applies to traffic that has a source IP address within the sourceRanges OR a source IP that belongs to an instance with service account listed in sourceServiceAccount. The connection does not need to match both fields for the firewall to apply. sourceServiceAccounts cannot be used at the same time as sourceTags or targetTags. + * If source service accounts are specified, the firewall rules apply only to + * traffic originating from an instance with a service account in this list. + * Source service accounts cannot be used to control traffic to an instance's + * external IP address because service accounts are associated with an + * instance, not an IP address.sourceRanges can be set at the same time assourceServiceAccounts. + * If both are set, the firewall applies to traffic that + * has a source IP address within the sourceRanges OR a source + * IP that belongs to an instance with service account listed insourceServiceAccount. The connection does not need to match + * both fields for the firewall to apply.sourceServiceAccounts cannot be used at the same time assourceTags or targetTags. * * Generated from protobuf field repeated string source_service_accounts = 105100756; * @return \Google\Protobuf\Internal\RepeatedField @@ -741,7 +989,15 @@ public function getSourceServiceAccounts() } /** - * If source service accounts are specified, the firewall rules apply only to traffic originating from an instance with a service account in this list. Source service accounts cannot be used to control traffic to an instance's external IP address because service accounts are associated with an instance, not an IP address. sourceRanges can be set at the same time as sourceServiceAccounts. If both are set, the firewall applies to traffic that has a source IP address within the sourceRanges OR a source IP that belongs to an instance with service account listed in sourceServiceAccount. The connection does not need to match both fields for the firewall to apply. sourceServiceAccounts cannot be used at the same time as sourceTags or targetTags. + * If source service accounts are specified, the firewall rules apply only to + * traffic originating from an instance with a service account in this list. + * Source service accounts cannot be used to control traffic to an instance's + * external IP address because service accounts are associated with an + * instance, not an IP address.sourceRanges can be set at the same time assourceServiceAccounts. + * If both are set, the firewall applies to traffic that + * has a source IP address within the sourceRanges OR a source + * IP that belongs to an instance with service account listed insourceServiceAccount. The connection does not need to match + * both fields for the firewall to apply.sourceServiceAccounts cannot be used at the same time assourceTags or targetTags. * * Generated from protobuf field repeated string source_service_accounts = 105100756; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -756,7 +1012,18 @@ public function setSourceServiceAccounts($var) } /** - * If source tags are specified, the firewall rule applies only to traffic with source IPs that match the primary network interfaces of VM instances that have the tag and are in the same VPC network. Source tags cannot be used to control traffic to an instance's external IP address, it only applies to traffic between instances in the same virtual network. Because tags are associated with instances, not IP addresses. One or both of sourceRanges and sourceTags may be set. If both fields are set, the firewall applies to traffic that has a source IP address within sourceRanges OR a source IP from a resource with a matching tag listed in the sourceTags field. The connection does not need to match both fields for the firewall to apply. + * If source tags are specified, the firewall rule applies only to traffic + * with source IPs that match the primary network interfaces of VM instances + * that have the tag and are in the same VPC network. + * Source tags cannot be used to control traffic to an instance's external IP + * address, it only applies to traffic between instances in the same virtual + * network. Because tags are associated with instances, not IP addresses. + * One or both of sourceRanges and sourceTags may be + * set. If both fields are set, the firewall applies to traffic that has a + * source IP address within sourceRanges OR a source IP from a + * resource with a matching tag listed in the sourceTags + * field. The connection does not need to match both fields for the + * firewall to apply. * * Generated from protobuf field repeated string source_tags = 452222397; * @return \Google\Protobuf\Internal\RepeatedField @@ -767,7 +1034,18 @@ public function getSourceTags() } /** - * If source tags are specified, the firewall rule applies only to traffic with source IPs that match the primary network interfaces of VM instances that have the tag and are in the same VPC network. Source tags cannot be used to control traffic to an instance's external IP address, it only applies to traffic between instances in the same virtual network. Because tags are associated with instances, not IP addresses. One or both of sourceRanges and sourceTags may be set. If both fields are set, the firewall applies to traffic that has a source IP address within sourceRanges OR a source IP from a resource with a matching tag listed in the sourceTags field. The connection does not need to match both fields for the firewall to apply. + * If source tags are specified, the firewall rule applies only to traffic + * with source IPs that match the primary network interfaces of VM instances + * that have the tag and are in the same VPC network. + * Source tags cannot be used to control traffic to an instance's external IP + * address, it only applies to traffic between instances in the same virtual + * network. Because tags are associated with instances, not IP addresses. + * One or both of sourceRanges and sourceTags may be + * set. If both fields are set, the firewall applies to traffic that has a + * source IP address within sourceRanges OR a source IP from a + * resource with a matching tag listed in the sourceTags + * field. The connection does not need to match both fields for the + * firewall to apply. * * Generated from protobuf field repeated string source_tags = 452222397; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -782,7 +1060,11 @@ public function setSourceTags($var) } /** - * A list of service accounts indicating sets of instances located in the network that may make network connections as specified in allowed[]. targetServiceAccounts cannot be used at the same time as targetTags or sourceTags. If neither targetServiceAccounts nor targetTags are specified, the firewall rule applies to all instances on the specified network. + * A list of service accounts indicating sets of instances located in the + * network that may make network connections as specified inallowed[].targetServiceAccounts cannot be used at the same time astargetTags or sourceTags. + * If neither targetServiceAccounts nor targetTags + * are specified, the firewall rule applies to all instances on the specified + * network. * * Generated from protobuf field repeated string target_service_accounts = 457639710; * @return \Google\Protobuf\Internal\RepeatedField @@ -793,7 +1075,11 @@ public function getTargetServiceAccounts() } /** - * A list of service accounts indicating sets of instances located in the network that may make network connections as specified in allowed[]. targetServiceAccounts cannot be used at the same time as targetTags or sourceTags. If neither targetServiceAccounts nor targetTags are specified, the firewall rule applies to all instances on the specified network. + * A list of service accounts indicating sets of instances located in the + * network that may make network connections as specified inallowed[].targetServiceAccounts cannot be used at the same time astargetTags or sourceTags. + * If neither targetServiceAccounts nor targetTags + * are specified, the firewall rule applies to all instances on the specified + * network. * * Generated from protobuf field repeated string target_service_accounts = 457639710; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -808,7 +1094,11 @@ public function setTargetServiceAccounts($var) } /** - * A list of tags that controls which instances the firewall rule applies to. If targetTags are specified, then the firewall rule applies only to instances in the VPC network that have one of those tags. If no targetTags are specified, the firewall rule applies to all instances on the specified network. + * A list of tags that controls which instances the firewall rule + * applies to. If targetTags are specified, then the firewall + * rule applies only to instances in the VPC network that have one of those + * tags. If no targetTags are specified, the firewall rule + * applies to all instances on the specified network. * * Generated from protobuf field repeated string target_tags = 62901767; * @return \Google\Protobuf\Internal\RepeatedField @@ -819,7 +1109,11 @@ public function getTargetTags() } /** - * A list of tags that controls which instances the firewall rule applies to. If targetTags are specified, then the firewall rule applies only to instances in the VPC network that have one of those tags. If no targetTags are specified, the firewall rule applies to all instances on the specified network. + * A list of tags that controls which instances the firewall rule + * applies to. If targetTags are specified, then the firewall + * rule applies only to instances in the VPC network that have one of those + * tags. If no targetTags are specified, the firewall rule + * applies to all instances on the specified network. * * Generated from protobuf field repeated string target_tags = 62901767; * @param array|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/Firewall/Direction.php b/Compute/src/V1/Firewall/Direction.php index fe647b3babd5..6d6135dc37a9 100644 --- a/Compute/src/V1/Firewall/Direction.php +++ b/Compute/src/V1/Firewall/Direction.php @@ -7,7 +7,9 @@ use UnexpectedValueException; /** - * Direction of traffic to which this firewall applies, either `INGRESS` or `EGRESS`. The default is `INGRESS`. For `EGRESS` traffic, you cannot specify the sourceTags fields. + * Direction of traffic to which this firewall applies, either `INGRESS` or + * `EGRESS`. The default is `INGRESS`. For `EGRESS` traffic, you cannot + * specify the sourceTags fields. * * Protobuf type google.cloud.compute.v1.Firewall.Direction */ diff --git a/Compute/src/V1/FirewallList.php b/Compute/src/V1/FirewallList.php index 4661f6f4b551..617e343c165d 100644 --- a/Compute/src/V1/FirewallList.php +++ b/Compute/src/V1/FirewallList.php @@ -28,13 +28,18 @@ class FirewallList extends \Google\Protobuf\Internal\Message */ private $items; /** - * [Output Only] Type of resource. Always compute#firewallList for lists of firewalls. + * [Output Only] Type of resource. Always compute#firewallList + * for lists of firewalls. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -63,9 +68,14 @@ class FirewallList extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\Firewall>|\Google\Protobuf\Internal\RepeatedField $items * A list of Firewall resources. * @type string $kind - * [Output Only] Type of resource. Always compute#firewallList for lists of firewalls. + * [Output Only] Type of resource. Always compute#firewallList + * for lists of firewalls. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type \Google\Cloud\Compute\V1\Warning $warning @@ -140,7 +150,8 @@ public function setItems($var) } /** - * [Output Only] Type of resource. Always compute#firewallList for lists of firewalls. + * [Output Only] Type of resource. Always compute#firewallList + * for lists of firewalls. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -161,7 +172,8 @@ public function clearKind() } /** - * [Output Only] Type of resource. Always compute#firewallList for lists of firewalls. + * [Output Only] Type of resource. Always compute#firewallList + * for lists of firewalls. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -176,7 +188,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -197,7 +213,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/FirewallLogConfig.php b/Compute/src/V1/FirewallLogConfig.php index 585bfe18acbd..b65135c4c3d7 100644 --- a/Compute/src/V1/FirewallLogConfig.php +++ b/Compute/src/V1/FirewallLogConfig.php @@ -16,13 +16,16 @@ class FirewallLogConfig extends \Google\Protobuf\Internal\Message { /** - * This field denotes whether to enable logging for a particular firewall rule. + * This field denotes whether to enable logging for a particular firewall + * rule. * * Generated from protobuf field optional bool enable = 311764355; */ protected $enable = null; /** - * This field can only be specified for a particular firewall rule if logging is enabled for that rule. This field denotes whether to include or exclude metadata for firewall logs. + * This field can only be specified for a particular firewall rule if + * logging is enabled for that rule. This field denotes whether to include + * or exclude metadata for firewall logs. * Check the Metadata enum for the list of possible values. * * Generated from protobuf field optional string metadata = 86866735; @@ -36,9 +39,12 @@ class FirewallLogConfig extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type bool $enable - * This field denotes whether to enable logging for a particular firewall rule. + * This field denotes whether to enable logging for a particular firewall + * rule. * @type string $metadata - * This field can only be specified for a particular firewall rule if logging is enabled for that rule. This field denotes whether to include or exclude metadata for firewall logs. + * This field can only be specified for a particular firewall rule if + * logging is enabled for that rule. This field denotes whether to include + * or exclude metadata for firewall logs. * Check the Metadata enum for the list of possible values. * } */ @@ -48,7 +54,8 @@ public function __construct($data = NULL) { } /** - * This field denotes whether to enable logging for a particular firewall rule. + * This field denotes whether to enable logging for a particular firewall + * rule. * * Generated from protobuf field optional bool enable = 311764355; * @return bool @@ -69,7 +76,8 @@ public function clearEnable() } /** - * This field denotes whether to enable logging for a particular firewall rule. + * This field denotes whether to enable logging for a particular firewall + * rule. * * Generated from protobuf field optional bool enable = 311764355; * @param bool $var @@ -84,7 +92,9 @@ public function setEnable($var) } /** - * This field can only be specified for a particular firewall rule if logging is enabled for that rule. This field denotes whether to include or exclude metadata for firewall logs. + * This field can only be specified for a particular firewall rule if + * logging is enabled for that rule. This field denotes whether to include + * or exclude metadata for firewall logs. * Check the Metadata enum for the list of possible values. * * Generated from protobuf field optional string metadata = 86866735; @@ -106,7 +116,9 @@ public function clearMetadata() } /** - * This field can only be specified for a particular firewall rule if logging is enabled for that rule. This field denotes whether to include or exclude metadata for firewall logs. + * This field can only be specified for a particular firewall rule if + * logging is enabled for that rule. This field denotes whether to include + * or exclude metadata for firewall logs. * Check the Metadata enum for the list of possible values. * * Generated from protobuf field optional string metadata = 86866735; diff --git a/Compute/src/V1/FirewallLogConfig/Metadata.php b/Compute/src/V1/FirewallLogConfig/Metadata.php index 90147370a929..801fef2a22db 100644 --- a/Compute/src/V1/FirewallLogConfig/Metadata.php +++ b/Compute/src/V1/FirewallLogConfig/Metadata.php @@ -7,7 +7,9 @@ use UnexpectedValueException; /** - * This field can only be specified for a particular firewall rule if logging is enabled for that rule. This field denotes whether to include or exclude metadata for firewall logs. + * This field can only be specified for a particular firewall rule if + * logging is enabled for that rule. This field denotes whether to include + * or exclude metadata for firewall logs. * * Protobuf type google.cloud.compute.v1.FirewallLogConfig.Metadata */ diff --git a/Compute/src/V1/FirewallParams.php b/Compute/src/V1/FirewallParams.php index 5259c0fa299e..0d81f8e62455 100644 --- a/Compute/src/V1/FirewallParams.php +++ b/Compute/src/V1/FirewallParams.php @@ -16,7 +16,18 @@ class FirewallParams extends \Google\Protobuf\Internal\Message { /** - * Tag keys/values directly bound to this resource. Tag keys and values have the same definition as resource manager tags. The field is allowed for INSERT only. The keys/values to set on the resource should be specified in either ID { : } or Namespaced format { : }. For example the following are valid inputs: * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} * {"123/environment" : "production", "345/abc" : "xyz"} Note: * Invalid combinations of ID & namespaced format is not supported. For instance: {"123/environment" : "tagValues/444"} is invalid. + * Tag keys/values directly bound to this resource. + * Tag keys and values have the same definition as resource + * manager tags. The field is allowed for INSERT + * only. The keys/values to set on the resource should be specified in + * either ID { : } or Namespaced format + * { : }. + * For example the following are valid inputs: + * * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} + * * {"123/environment" : "production", "345/abc" : "xyz"} + * Note: + * * Invalid combinations of ID & namespaced format is not supported. For + * instance: {"123/environment" : "tagValues/444"} is invalid. * * Generated from protobuf field map resource_manager_tags = 377671164; */ @@ -29,7 +40,18 @@ class FirewallParams extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type array|\Google\Protobuf\Internal\MapField $resource_manager_tags - * Tag keys/values directly bound to this resource. Tag keys and values have the same definition as resource manager tags. The field is allowed for INSERT only. The keys/values to set on the resource should be specified in either ID { : } or Namespaced format { : }. For example the following are valid inputs: * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} * {"123/environment" : "production", "345/abc" : "xyz"} Note: * Invalid combinations of ID & namespaced format is not supported. For instance: {"123/environment" : "tagValues/444"} is invalid. + * Tag keys/values directly bound to this resource. + * Tag keys and values have the same definition as resource + * manager tags. The field is allowed for INSERT + * only. The keys/values to set on the resource should be specified in + * either ID { : } or Namespaced format + * { : }. + * For example the following are valid inputs: + * * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} + * * {"123/environment" : "production", "345/abc" : "xyz"} + * Note: + * * Invalid combinations of ID & namespaced format is not supported. For + * instance: {"123/environment" : "tagValues/444"} is invalid. * } */ public function __construct($data = NULL) { @@ -38,7 +60,18 @@ public function __construct($data = NULL) { } /** - * Tag keys/values directly bound to this resource. Tag keys and values have the same definition as resource manager tags. The field is allowed for INSERT only. The keys/values to set on the resource should be specified in either ID { : } or Namespaced format { : }. For example the following are valid inputs: * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} * {"123/environment" : "production", "345/abc" : "xyz"} Note: * Invalid combinations of ID & namespaced format is not supported. For instance: {"123/environment" : "tagValues/444"} is invalid. + * Tag keys/values directly bound to this resource. + * Tag keys and values have the same definition as resource + * manager tags. The field is allowed for INSERT + * only. The keys/values to set on the resource should be specified in + * either ID { : } or Namespaced format + * { : }. + * For example the following are valid inputs: + * * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} + * * {"123/environment" : "production", "345/abc" : "xyz"} + * Note: + * * Invalid combinations of ID & namespaced format is not supported. For + * instance: {"123/environment" : "tagValues/444"} is invalid. * * Generated from protobuf field map resource_manager_tags = 377671164; * @return \Google\Protobuf\Internal\MapField @@ -49,7 +82,18 @@ public function getResourceManagerTags() } /** - * Tag keys/values directly bound to this resource. Tag keys and values have the same definition as resource manager tags. The field is allowed for INSERT only. The keys/values to set on the resource should be specified in either ID { : } or Namespaced format { : }. For example the following are valid inputs: * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} * {"123/environment" : "production", "345/abc" : "xyz"} Note: * Invalid combinations of ID & namespaced format is not supported. For instance: {"123/environment" : "tagValues/444"} is invalid. + * Tag keys/values directly bound to this resource. + * Tag keys and values have the same definition as resource + * manager tags. The field is allowed for INSERT + * only. The keys/values to set on the resource should be specified in + * either ID { : } or Namespaced format + * { : }. + * For example the following are valid inputs: + * * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} + * * {"123/environment" : "production", "345/abc" : "xyz"} + * Note: + * * Invalid combinations of ID & namespaced format is not supported. For + * instance: {"123/environment" : "tagValues/444"} is invalid. * * Generated from protobuf field map resource_manager_tags = 377671164; * @param array|\Google\Protobuf\Internal\MapField $var diff --git a/Compute/src/V1/FirewallPoliciesListAssociationsResponse.php b/Compute/src/V1/FirewallPoliciesListAssociationsResponse.php index 5529d46716c6..fa162a7bc8a1 100644 --- a/Compute/src/V1/FirewallPoliciesListAssociationsResponse.php +++ b/Compute/src/V1/FirewallPoliciesListAssociationsResponse.php @@ -21,7 +21,8 @@ class FirewallPoliciesListAssociationsResponse extends \Google\Protobuf\Internal */ private $associations; /** - * [Output Only] Type of firewallPolicy associations. Always compute#FirewallPoliciesListAssociations for lists of firewallPolicy associations. + * [Output Only] Type of firewallPolicy associations. Alwayscompute#FirewallPoliciesListAssociations for lists of + * firewallPolicy associations. * * Generated from protobuf field optional string kind = 3292052; */ @@ -36,7 +37,8 @@ class FirewallPoliciesListAssociationsResponse extends \Google\Protobuf\Internal * @type array<\Google\Cloud\Compute\V1\FirewallPolicyAssociation>|\Google\Protobuf\Internal\RepeatedField $associations * A list of associations. * @type string $kind - * [Output Only] Type of firewallPolicy associations. Always compute#FirewallPoliciesListAssociations for lists of firewallPolicy associations. + * [Output Only] Type of firewallPolicy associations. Alwayscompute#FirewallPoliciesListAssociations for lists of + * firewallPolicy associations. * } */ public function __construct($data = NULL) { @@ -71,7 +73,8 @@ public function setAssociations($var) } /** - * [Output Only] Type of firewallPolicy associations. Always compute#FirewallPoliciesListAssociations for lists of firewallPolicy associations. + * [Output Only] Type of firewallPolicy associations. Alwayscompute#FirewallPoliciesListAssociations for lists of + * firewallPolicy associations. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -92,7 +95,8 @@ public function clearKind() } /** - * [Output Only] Type of firewallPolicy associations. Always compute#FirewallPoliciesListAssociations for lists of firewallPolicy associations. + * [Output Only] Type of firewallPolicy associations. Alwayscompute#FirewallPoliciesListAssociations for lists of + * firewallPolicy associations. * * Generated from protobuf field optional string kind = 3292052; * @param string $var diff --git a/Compute/src/V1/FirewallPoliciesScopedList.php b/Compute/src/V1/FirewallPoliciesScopedList.php index 2fc7fca4f846..12f5ad4991ae 100644 --- a/Compute/src/V1/FirewallPoliciesScopedList.php +++ b/Compute/src/V1/FirewallPoliciesScopedList.php @@ -21,7 +21,8 @@ class FirewallPoliciesScopedList extends \Google\Protobuf\Internal\Message */ private $firewall_policies; /** - * Informational warning which replaces the list of firewall policies when the list is empty. + * Informational warning which replaces the list of firewall policies when + * the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; */ @@ -36,7 +37,8 @@ class FirewallPoliciesScopedList extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\FirewallPolicy>|\Google\Protobuf\Internal\RepeatedField $firewall_policies * A list of firewall policies contained in this scope. * @type \Google\Cloud\Compute\V1\Warning $warning - * Informational warning which replaces the list of firewall policies when the list is empty. + * Informational warning which replaces the list of firewall policies when + * the list is empty. * } */ public function __construct($data = NULL) { @@ -71,7 +73,8 @@ public function setFirewallPolicies($var) } /** - * Informational warning which replaces the list of firewall policies when the list is empty. + * Informational warning which replaces the list of firewall policies when + * the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; * @return \Google\Cloud\Compute\V1\Warning|null @@ -92,7 +95,8 @@ public function clearWarning() } /** - * Informational warning which replaces the list of firewall policies when the list is empty. + * Informational warning which replaces the list of firewall policies when + * the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; * @param \Google\Cloud\Compute\V1\Warning $var diff --git a/Compute/src/V1/FirewallPolicy.php b/Compute/src/V1/FirewallPolicy.php index b8319f426874..9e994b7e58f6 100644 --- a/Compute/src/V1/FirewallPolicy.php +++ b/Compute/src/V1/FirewallPolicy.php @@ -22,43 +22,65 @@ class FirewallPolicy extends \Google\Protobuf\Internal\Message */ private $associations; /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; */ protected $creation_timestamp = null; /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; */ protected $description = null; /** - * Deprecated, please use short name instead. User-provided name of the Organization firewall policy. The name should be unique in the organization in which the firewall policy is created. This field is not applicable to network firewall policies. This name must be set on creation and cannot be changed. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Deprecated, please use short name instead. User-provided name of the + * Organization firewall policy. The name should be unique in the organization + * in which the firewall policy is created. + * This field is not applicable to network firewall policies. + * This name must be set on creation and cannot be changed. + * The name must be 1-63 characters long, and comply + * with RFC1035. Specifically, the name must be 1-63 characters + * long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which + * means the first character must be a lowercase letter, and all following + * characters must be a dash, lowercase letter, or digit, except the last + * character, which cannot be a dash. * * Generated from protobuf field optional string display_name = 4473832; */ protected $display_name = null; /** - * Specifies a fingerprint for this resource, which is essentially a hash of the metadata's contents and used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update metadata. You must always provide an up-to-date fingerprint hash in order to update or change metadata, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make get() request to the firewall policy. + * Specifies a fingerprint for this resource, which is essentially a hash of + * the metadata's contents and used for optimistic locking. The + * fingerprint is initially generated by Compute Engine and changes after + * every request to modify or update metadata. You must always provide an + * up-to-date fingerprint hash in order to update or change metadata, + * otherwise the request will fail with error412 conditionNotMet. + * To see the latest fingerprint, make get() request to the + * firewall policy. * * Generated from protobuf field optional string fingerprint = 234678500; */ protected $fingerprint = null; /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; */ protected $id = null; /** - * [Output only] Type of the resource. Always compute#firewallPolicyfor firewall policies + * [Output only] Type of the resource. Alwayscompute#firewallPolicyfor firewall policies * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * Name of the resource. For Organization Firewall Policies it's a [Output Only] numeric ID allocated by Google Cloud which uniquely identifies the Organization Firewall Policy. + * Name of the resource. For Organization Firewall Policies it's a + * [Output Only] numeric ID allocated by Google Cloud which uniquely + * identifies the Organization Firewall Policy. * * Generated from protobuf field optional string name = 3373707; */ @@ -70,25 +92,41 @@ class FirewallPolicy extends \Google\Protobuf\Internal\Message */ private $packet_mirroring_rules; /** - * [Output Only] The parent of the firewall policy. This field is not applicable to network firewall policies. + * [Output Only] The parent of the firewall policy. + * This field is not applicable to network firewall policies. * * Generated from protobuf field optional string parent = 78317738; */ protected $parent = null; /** - * [Output Only] URL of the region where the regional firewall policy resides. This field is not applicable to global firewall policies. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * The type of the firewall policy. This field can be eitherVPC_POLICY or RDMA_ROCE_POLICY. + * Note: if not specified then VPC_POLICY will be used. + * Check the PolicyType enum for the list of possible values. + * + * Generated from protobuf field optional string policy_type = 18158119; + */ + protected $policy_type = null; + /** + * [Output Only] URL of the region where the regional firewall policy resides. + * This field is not applicable to global firewall policies. + * You must specify this field as part of the HTTP request URL. It is + * not settable as a field in the request body. * * Generated from protobuf field optional string region = 138946292; */ protected $region = null; /** - * [Output Only] Total count of all firewall policy rule tuples. A firewall policy can not exceed a set number of tuples. + * [Output Only] Total count of all firewall policy rule tuples. A firewall + * policy can not exceed a set number of tuples. * * Generated from protobuf field optional int32 rule_tuple_count = 388342037; */ protected $rule_tuple_count = null; /** - * A list of rules that belong to this policy. There must always be a default rule (rule with priority 2147483647 and match "*"). If no rules are provided when creating a firewall policy, a default rule with action "allow" will be added. + * A list of rules that belong to this policy. + * There must always be a default rule (rule with priority 2147483647 and + * match "*"). If no rules are provided when creating a firewall policy, a + * default rule with action "allow" will be added. * * Generated from protobuf field repeated .google.cloud.compute.v1.FirewallPolicyRule rules = 108873975; */ @@ -106,7 +144,16 @@ class FirewallPolicy extends \Google\Protobuf\Internal\Message */ protected $self_link_with_id = null; /** - * User-provided name of the Organization firewall policy. The name should be unique in the organization in which the firewall policy is created. This field is not applicable to network firewall policies. This name must be set on creation and cannot be changed. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * User-provided name of the Organization firewall policy. The name should be + * unique in the organization in which the firewall policy is created. + * This field is not applicable to network firewall policies. + * This name must be set on creation and cannot be changed. The name must be + * 1-63 characters long, and comply with RFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * * Generated from protobuf field optional string short_name = 492051566; */ @@ -121,35 +168,78 @@ class FirewallPolicy extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\FirewallPolicyAssociation>|\Google\Protobuf\Internal\RepeatedField $associations * A list of associations that belong to this firewall policy. * @type string $creation_timestamp - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * @type string $description - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * @type string $display_name - * Deprecated, please use short name instead. User-provided name of the Organization firewall policy. The name should be unique in the organization in which the firewall policy is created. This field is not applicable to network firewall policies. This name must be set on creation and cannot be changed. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Deprecated, please use short name instead. User-provided name of the + * Organization firewall policy. The name should be unique in the organization + * in which the firewall policy is created. + * This field is not applicable to network firewall policies. + * This name must be set on creation and cannot be changed. + * The name must be 1-63 characters long, and comply + * with RFC1035. Specifically, the name must be 1-63 characters + * long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which + * means the first character must be a lowercase letter, and all following + * characters must be a dash, lowercase letter, or digit, except the last + * character, which cannot be a dash. * @type string $fingerprint - * Specifies a fingerprint for this resource, which is essentially a hash of the metadata's contents and used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update metadata. You must always provide an up-to-date fingerprint hash in order to update or change metadata, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make get() request to the firewall policy. + * Specifies a fingerprint for this resource, which is essentially a hash of + * the metadata's contents and used for optimistic locking. The + * fingerprint is initially generated by Compute Engine and changes after + * every request to modify or update metadata. You must always provide an + * up-to-date fingerprint hash in order to update or change metadata, + * otherwise the request will fail with error412 conditionNotMet. + * To see the latest fingerprint, make get() request to the + * firewall policy. * @type int|string $id - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * @type string $kind - * [Output only] Type of the resource. Always compute#firewallPolicyfor firewall policies + * [Output only] Type of the resource. Alwayscompute#firewallPolicyfor firewall policies * @type string $name - * Name of the resource. For Organization Firewall Policies it's a [Output Only] numeric ID allocated by Google Cloud which uniquely identifies the Organization Firewall Policy. + * Name of the resource. For Organization Firewall Policies it's a + * [Output Only] numeric ID allocated by Google Cloud which uniquely + * identifies the Organization Firewall Policy. * @type array<\Google\Cloud\Compute\V1\FirewallPolicyRule>|\Google\Protobuf\Internal\RepeatedField $packet_mirroring_rules * A list of packet mirroring rules that belong to this policy. * @type string $parent - * [Output Only] The parent of the firewall policy. This field is not applicable to network firewall policies. + * [Output Only] The parent of the firewall policy. + * This field is not applicable to network firewall policies. + * @type string $policy_type + * The type of the firewall policy. This field can be eitherVPC_POLICY or RDMA_ROCE_POLICY. + * Note: if not specified then VPC_POLICY will be used. + * Check the PolicyType enum for the list of possible values. * @type string $region - * [Output Only] URL of the region where the regional firewall policy resides. This field is not applicable to global firewall policies. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * [Output Only] URL of the region where the regional firewall policy resides. + * This field is not applicable to global firewall policies. + * You must specify this field as part of the HTTP request URL. It is + * not settable as a field in the request body. * @type int $rule_tuple_count - * [Output Only] Total count of all firewall policy rule tuples. A firewall policy can not exceed a set number of tuples. + * [Output Only] Total count of all firewall policy rule tuples. A firewall + * policy can not exceed a set number of tuples. * @type array<\Google\Cloud\Compute\V1\FirewallPolicyRule>|\Google\Protobuf\Internal\RepeatedField $rules - * A list of rules that belong to this policy. There must always be a default rule (rule with priority 2147483647 and match "*"). If no rules are provided when creating a firewall policy, a default rule with action "allow" will be added. + * A list of rules that belong to this policy. + * There must always be a default rule (rule with priority 2147483647 and + * match "*"). If no rules are provided when creating a firewall policy, a + * default rule with action "allow" will be added. * @type string $self_link * [Output Only] Server-defined URL for the resource. * @type string $self_link_with_id * [Output Only] Server-defined URL for this resource with the resource id. * @type string $short_name - * User-provided name of the Organization firewall policy. The name should be unique in the organization in which the firewall policy is created. This field is not applicable to network firewall policies. This name must be set on creation and cannot be changed. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * User-provided name of the Organization firewall policy. The name should be + * unique in the organization in which the firewall policy is created. + * This field is not applicable to network firewall policies. + * This name must be set on creation and cannot be changed. The name must be + * 1-63 characters long, and comply with RFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * } */ public function __construct($data = NULL) { @@ -184,7 +274,8 @@ public function setAssociations($var) } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @return string @@ -205,7 +296,8 @@ public function clearCreationTimestamp() } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @param string $var @@ -220,7 +312,8 @@ public function setCreationTimestamp($var) } /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @return string @@ -241,7 +334,8 @@ public function clearDescription() } /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @param string $var @@ -256,7 +350,17 @@ public function setDescription($var) } /** - * Deprecated, please use short name instead. User-provided name of the Organization firewall policy. The name should be unique in the organization in which the firewall policy is created. This field is not applicable to network firewall policies. This name must be set on creation and cannot be changed. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Deprecated, please use short name instead. User-provided name of the + * Organization firewall policy. The name should be unique in the organization + * in which the firewall policy is created. + * This field is not applicable to network firewall policies. + * This name must be set on creation and cannot be changed. + * The name must be 1-63 characters long, and comply + * with RFC1035. Specifically, the name must be 1-63 characters + * long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which + * means the first character must be a lowercase letter, and all following + * characters must be a dash, lowercase letter, or digit, except the last + * character, which cannot be a dash. * * Generated from protobuf field optional string display_name = 4473832; * @return string @@ -277,7 +381,17 @@ public function clearDisplayName() } /** - * Deprecated, please use short name instead. User-provided name of the Organization firewall policy. The name should be unique in the organization in which the firewall policy is created. This field is not applicable to network firewall policies. This name must be set on creation and cannot be changed. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Deprecated, please use short name instead. User-provided name of the + * Organization firewall policy. The name should be unique in the organization + * in which the firewall policy is created. + * This field is not applicable to network firewall policies. + * This name must be set on creation and cannot be changed. + * The name must be 1-63 characters long, and comply + * with RFC1035. Specifically, the name must be 1-63 characters + * long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which + * means the first character must be a lowercase letter, and all following + * characters must be a dash, lowercase letter, or digit, except the last + * character, which cannot be a dash. * * Generated from protobuf field optional string display_name = 4473832; * @param string $var @@ -292,7 +406,14 @@ public function setDisplayName($var) } /** - * Specifies a fingerprint for this resource, which is essentially a hash of the metadata's contents and used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update metadata. You must always provide an up-to-date fingerprint hash in order to update or change metadata, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make get() request to the firewall policy. + * Specifies a fingerprint for this resource, which is essentially a hash of + * the metadata's contents and used for optimistic locking. The + * fingerprint is initially generated by Compute Engine and changes after + * every request to modify or update metadata. You must always provide an + * up-to-date fingerprint hash in order to update or change metadata, + * otherwise the request will fail with error412 conditionNotMet. + * To see the latest fingerprint, make get() request to the + * firewall policy. * * Generated from protobuf field optional string fingerprint = 234678500; * @return string @@ -313,7 +434,14 @@ public function clearFingerprint() } /** - * Specifies a fingerprint for this resource, which is essentially a hash of the metadata's contents and used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update metadata. You must always provide an up-to-date fingerprint hash in order to update or change metadata, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make get() request to the firewall policy. + * Specifies a fingerprint for this resource, which is essentially a hash of + * the metadata's contents and used for optimistic locking. The + * fingerprint is initially generated by Compute Engine and changes after + * every request to modify or update metadata. You must always provide an + * up-to-date fingerprint hash in order to update or change metadata, + * otherwise the request will fail with error412 conditionNotMet. + * To see the latest fingerprint, make get() request to the + * firewall policy. * * Generated from protobuf field optional string fingerprint = 234678500; * @param string $var @@ -328,7 +456,8 @@ public function setFingerprint($var) } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @return int|string @@ -349,7 +478,8 @@ public function clearId() } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @param int|string $var @@ -364,7 +494,7 @@ public function setId($var) } /** - * [Output only] Type of the resource. Always compute#firewallPolicyfor firewall policies + * [Output only] Type of the resource. Alwayscompute#firewallPolicyfor firewall policies * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -385,7 +515,7 @@ public function clearKind() } /** - * [Output only] Type of the resource. Always compute#firewallPolicyfor firewall policies + * [Output only] Type of the resource. Alwayscompute#firewallPolicyfor firewall policies * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -400,7 +530,9 @@ public function setKind($var) } /** - * Name of the resource. For Organization Firewall Policies it's a [Output Only] numeric ID allocated by Google Cloud which uniquely identifies the Organization Firewall Policy. + * Name of the resource. For Organization Firewall Policies it's a + * [Output Only] numeric ID allocated by Google Cloud which uniquely + * identifies the Organization Firewall Policy. * * Generated from protobuf field optional string name = 3373707; * @return string @@ -421,7 +553,9 @@ public function clearName() } /** - * Name of the resource. For Organization Firewall Policies it's a [Output Only] numeric ID allocated by Google Cloud which uniquely identifies the Organization Firewall Policy. + * Name of the resource. For Organization Firewall Policies it's a + * [Output Only] numeric ID allocated by Google Cloud which uniquely + * identifies the Organization Firewall Policy. * * Generated from protobuf field optional string name = 3373707; * @param string $var @@ -462,7 +596,8 @@ public function setPacketMirroringRules($var) } /** - * [Output Only] The parent of the firewall policy. This field is not applicable to network firewall policies. + * [Output Only] The parent of the firewall policy. + * This field is not applicable to network firewall policies. * * Generated from protobuf field optional string parent = 78317738; * @return string @@ -483,7 +618,8 @@ public function clearParent() } /** - * [Output Only] The parent of the firewall policy. This field is not applicable to network firewall policies. + * [Output Only] The parent of the firewall policy. + * This field is not applicable to network firewall policies. * * Generated from protobuf field optional string parent = 78317738; * @param string $var @@ -498,7 +634,50 @@ public function setParent($var) } /** - * [Output Only] URL of the region where the regional firewall policy resides. This field is not applicable to global firewall policies. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * The type of the firewall policy. This field can be eitherVPC_POLICY or RDMA_ROCE_POLICY. + * Note: if not specified then VPC_POLICY will be used. + * Check the PolicyType enum for the list of possible values. + * + * Generated from protobuf field optional string policy_type = 18158119; + * @return string + */ + public function getPolicyType() + { + return isset($this->policy_type) ? $this->policy_type : ''; + } + + public function hasPolicyType() + { + return isset($this->policy_type); + } + + public function clearPolicyType() + { + unset($this->policy_type); + } + + /** + * The type of the firewall policy. This field can be eitherVPC_POLICY or RDMA_ROCE_POLICY. + * Note: if not specified then VPC_POLICY will be used. + * Check the PolicyType enum for the list of possible values. + * + * Generated from protobuf field optional string policy_type = 18158119; + * @param string $var + * @return $this + */ + public function setPolicyType($var) + { + GPBUtil::checkString($var, True); + $this->policy_type = $var; + + return $this; + } + + /** + * [Output Only] URL of the region where the regional firewall policy resides. + * This field is not applicable to global firewall policies. + * You must specify this field as part of the HTTP request URL. It is + * not settable as a field in the request body. * * Generated from protobuf field optional string region = 138946292; * @return string @@ -519,7 +698,10 @@ public function clearRegion() } /** - * [Output Only] URL of the region where the regional firewall policy resides. This field is not applicable to global firewall policies. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * [Output Only] URL of the region where the regional firewall policy resides. + * This field is not applicable to global firewall policies. + * You must specify this field as part of the HTTP request URL. It is + * not settable as a field in the request body. * * Generated from protobuf field optional string region = 138946292; * @param string $var @@ -534,7 +716,8 @@ public function setRegion($var) } /** - * [Output Only] Total count of all firewall policy rule tuples. A firewall policy can not exceed a set number of tuples. + * [Output Only] Total count of all firewall policy rule tuples. A firewall + * policy can not exceed a set number of tuples. * * Generated from protobuf field optional int32 rule_tuple_count = 388342037; * @return int @@ -555,7 +738,8 @@ public function clearRuleTupleCount() } /** - * [Output Only] Total count of all firewall policy rule tuples. A firewall policy can not exceed a set number of tuples. + * [Output Only] Total count of all firewall policy rule tuples. A firewall + * policy can not exceed a set number of tuples. * * Generated from protobuf field optional int32 rule_tuple_count = 388342037; * @param int $var @@ -570,7 +754,10 @@ public function setRuleTupleCount($var) } /** - * A list of rules that belong to this policy. There must always be a default rule (rule with priority 2147483647 and match "*"). If no rules are provided when creating a firewall policy, a default rule with action "allow" will be added. + * A list of rules that belong to this policy. + * There must always be a default rule (rule with priority 2147483647 and + * match "*"). If no rules are provided when creating a firewall policy, a + * default rule with action "allow" will be added. * * Generated from protobuf field repeated .google.cloud.compute.v1.FirewallPolicyRule rules = 108873975; * @return \Google\Protobuf\Internal\RepeatedField @@ -581,7 +768,10 @@ public function getRules() } /** - * A list of rules that belong to this policy. There must always be a default rule (rule with priority 2147483647 and match "*"). If no rules are provided when creating a firewall policy, a default rule with action "allow" will be added. + * A list of rules that belong to this policy. + * There must always be a default rule (rule with priority 2147483647 and + * match "*"). If no rules are provided when creating a firewall policy, a + * default rule with action "allow" will be added. * * Generated from protobuf field repeated .google.cloud.compute.v1.FirewallPolicyRule rules = 108873975; * @param array<\Google\Cloud\Compute\V1\FirewallPolicyRule>|\Google\Protobuf\Internal\RepeatedField $var @@ -668,7 +858,16 @@ public function setSelfLinkWithId($var) } /** - * User-provided name of the Organization firewall policy. The name should be unique in the organization in which the firewall policy is created. This field is not applicable to network firewall policies. This name must be set on creation and cannot be changed. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * User-provided name of the Organization firewall policy. The name should be + * unique in the organization in which the firewall policy is created. + * This field is not applicable to network firewall policies. + * This name must be set on creation and cannot be changed. The name must be + * 1-63 characters long, and comply with RFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * * Generated from protobuf field optional string short_name = 492051566; * @return string @@ -689,7 +888,16 @@ public function clearShortName() } /** - * User-provided name of the Organization firewall policy. The name should be unique in the organization in which the firewall policy is created. This field is not applicable to network firewall policies. This name must be set on creation and cannot be changed. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * User-provided name of the Organization firewall policy. The name should be + * unique in the organization in which the firewall policy is created. + * This field is not applicable to network firewall policies. + * This name must be set on creation and cannot be changed. The name must be + * 1-63 characters long, and comply with RFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * * Generated from protobuf field optional string short_name = 492051566; * @param string $var diff --git a/Compute/src/V1/FirewallPolicy/PolicyType.php b/Compute/src/V1/FirewallPolicy/PolicyType.php new file mode 100644 index 000000000000..7433c329d152 --- /dev/null +++ b/Compute/src/V1/FirewallPolicy/PolicyType.php @@ -0,0 +1,59 @@ +google.cloud.compute.v1.FirewallPolicy.PolicyType + */ +class PolicyType +{ + /** + * A value indicating that the enum field is not set. + * + * Generated from protobuf enum UNDEFINED_POLICY_TYPE = 0; + */ + const UNDEFINED_POLICY_TYPE = 0; + /** + * Generated from protobuf enum RDMA_ROCE_POLICY = 148757145; + */ + const RDMA_ROCE_POLICY = 148757145; + /** + * Generated from protobuf enum VPC_POLICY = 74319208; + */ + const VPC_POLICY = 74319208; + + private static $valueToName = [ + self::UNDEFINED_POLICY_TYPE => 'UNDEFINED_POLICY_TYPE', + self::RDMA_ROCE_POLICY => 'RDMA_ROCE_POLICY', + self::VPC_POLICY => 'VPC_POLICY', + ]; + + public static function name($value) + { + if (!isset(self::$valueToName[$value])) { + throw new UnexpectedValueException(sprintf( + 'Enum %s has no name defined for value %s', __CLASS__, $value)); + } + return self::$valueToName[$value]; + } + + + public static function value($name) + { + $const = __CLASS__ . '::' . strtoupper($name); + if (!defined($const)) { + throw new UnexpectedValueException(sprintf( + 'Enum %s has no value defined for name %s', __CLASS__, $name)); + } + return constant($const); + } +} + + diff --git a/Compute/src/V1/FirewallPolicyAssociation.php b/Compute/src/V1/FirewallPolicyAssociation.php index 07d36ff4f38f..db48850a8189 100644 --- a/Compute/src/V1/FirewallPolicyAssociation.php +++ b/Compute/src/V1/FirewallPolicyAssociation.php @@ -21,7 +21,8 @@ class FirewallPolicyAssociation extends \Google\Protobuf\Internal\Message */ protected $attachment_target = null; /** - * [Output Only] Deprecated, please use short name instead. The display name of the firewall policy of the association. + * [Output Only] Deprecated, please use short name instead. The display name + * of the firewall policy of the association. * * Generated from protobuf field optional string display_name = 4473832; */ @@ -54,7 +55,8 @@ class FirewallPolicyAssociation extends \Google\Protobuf\Internal\Message * @type string $attachment_target * The target that the firewall policy is attached to. * @type string $display_name - * [Output Only] Deprecated, please use short name instead. The display name of the firewall policy of the association. + * [Output Only] Deprecated, please use short name instead. The display name + * of the firewall policy of the association. * @type string $firewall_policy_id * [Output Only] The firewall policy ID of the association. * @type string $name @@ -105,7 +107,8 @@ public function setAttachmentTarget($var) } /** - * [Output Only] Deprecated, please use short name instead. The display name of the firewall policy of the association. + * [Output Only] Deprecated, please use short name instead. The display name + * of the firewall policy of the association. * * Generated from protobuf field optional string display_name = 4473832; * @return string @@ -126,7 +129,8 @@ public function clearDisplayName() } /** - * [Output Only] Deprecated, please use short name instead. The display name of the firewall policy of the association. + * [Output Only] Deprecated, please use short name instead. The display name + * of the firewall policy of the association. * * Generated from protobuf field optional string display_name = 4473832; * @param string $var diff --git a/Compute/src/V1/FirewallPolicyList.php b/Compute/src/V1/FirewallPolicyList.php index 579406261ac6..342d06106ebe 100644 --- a/Compute/src/V1/FirewallPolicyList.php +++ b/Compute/src/V1/FirewallPolicyList.php @@ -27,13 +27,17 @@ class FirewallPolicyList extends \Google\Protobuf\Internal\Message */ private $items; /** - * [Output Only] Type of resource. Always compute#firewallPolicyList for listsof FirewallPolicies + * [Output Only] Type of resource. Alwayscompute#firewallPolicyList for listsof FirewallPolicies * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -56,9 +60,13 @@ class FirewallPolicyList extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\FirewallPolicy>|\Google\Protobuf\Internal\RepeatedField $items * A list of FirewallPolicy resources. * @type string $kind - * [Output Only] Type of resource. Always compute#firewallPolicyList for listsof FirewallPolicies + * [Output Only] Type of resource. Alwayscompute#firewallPolicyList for listsof FirewallPolicies * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type \Google\Cloud\Compute\V1\Warning $warning * [Output Only] Informational warning message. * } @@ -131,7 +139,7 @@ public function setItems($var) } /** - * [Output Only] Type of resource. Always compute#firewallPolicyList for listsof FirewallPolicies + * [Output Only] Type of resource. Alwayscompute#firewallPolicyList for listsof FirewallPolicies * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -152,7 +160,7 @@ public function clearKind() } /** - * [Output Only] Type of resource. Always compute#firewallPolicyList for listsof FirewallPolicies + * [Output Only] Type of resource. Alwayscompute#firewallPolicyList for listsof FirewallPolicies * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -167,7 +175,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -188,7 +200,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/FirewallPolicyRule.php b/Compute/src/V1/FirewallPolicyRule.php index 00606248f6ca..d4109f061ed9 100644 --- a/Compute/src/V1/FirewallPolicyRule.php +++ b/Compute/src/V1/FirewallPolicyRule.php @@ -9,14 +9,19 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Represents a rule that describes one or more match conditions along with the action to be taken when traffic matches this condition (allow or deny). + * Represents a rule that describes one or more match conditions along with + * the action to be taken when traffic matches this condition (allow or deny). * * Generated from protobuf message google.cloud.compute.v1.FirewallPolicyRule */ class FirewallPolicyRule extends \Google\Protobuf\Internal\Message { /** - * The Action to perform when the client connection triggers the rule. Valid actions for firewall rules are: "allow", "deny", "apply_security_profile_group" and "goto_next". Valid actions for packet mirroring rules are: "mirror", "do_not_mirror" and "goto_next". + * The Action to perform when the client connection triggers the rule. + * Valid actions for firewall rules are: "allow", "deny", + * "apply_security_profile_group" and "goto_next". + * Valid actions for packet mirroring rules are: "mirror", "do_not_mirror" + * and "goto_next". * * Generated from protobuf field optional string action = 187661878; */ @@ -35,73 +40,101 @@ class FirewallPolicyRule extends \Google\Protobuf\Internal\Message */ protected $direction = null; /** - * Denotes whether the firewall policy rule is disabled. When set to true, the firewall policy rule is not enforced and traffic behaves as if it did not exist. If this is unspecified, the firewall policy rule will be enabled. + * Denotes whether the firewall policy rule is disabled. When set to true, + * the firewall policy rule is not enforced and traffic behaves as if it did + * not exist. If this is unspecified, the firewall policy rule will be + * enabled. * * Generated from protobuf field optional bool disabled = 270940796; */ protected $disabled = null; /** - * Denotes whether to enable logging for a particular rule. If logging is enabled, logs will be exported to the configured export destination in Stackdriver. Logs may be exported to BigQuery or Pub/Sub. Note: you cannot enable logging on "goto_next" rules. + * Denotes whether to enable logging for a particular rule. If logging is + * enabled, logs will be exported to the configured export destination in + * Stackdriver. Logs may be exported to BigQuery or Pub/Sub. Note: you + * cannot enable logging on "goto_next" rules. * * Generated from protobuf field optional bool enable_logging = 295396515; */ protected $enable_logging = null; /** - * [Output only] Type of the resource. Returns compute#firewallPolicyRule for firewall rules and compute#packetMirroringRule for packet mirroring rules. + * [Output only] Type of the resource. Returnscompute#firewallPolicyRule for firewall rules andcompute#packetMirroringRule for packet mirroring rules. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * A match condition that incoming traffic is evaluated against. If it evaluates to true, the corresponding 'action' is enforced. + * A match condition that incoming traffic is evaluated against. + * If it evaluates to true, the corresponding 'action' is enforced. * * Generated from protobuf field optional .google.cloud.compute.v1.FirewallPolicyRuleMatcher match = 103668165; */ protected $match = null; /** - * An integer indicating the priority of a rule in the list. The priority must be a positive value between 0 and 2147483647. Rules are evaluated from highest to lowest priority where 0 is the highest priority and 2147483647 is the lowest priority. + * An integer indicating the priority of a rule in the list. The priority + * must be a positive value between 0 and 2147483647. + * Rules are evaluated from highest to lowest priority where 0 is the + * highest priority and 2147483647 is the lowest priority. * * Generated from protobuf field optional int32 priority = 445151652; */ protected $priority = null; /** - * An optional name for the rule. This field is not a unique identifier and can be updated. + * An optional name for the rule. This field is not a unique identifier + * and can be updated. * * Generated from protobuf field optional string rule_name = 55286254; */ protected $rule_name = null; /** - * [Output Only] Calculation of the complexity of a single firewall policy rule. + * [Output Only] Calculation of the complexity of a single firewall policy + * rule. * * Generated from protobuf field optional int32 rule_tuple_count = 388342037; */ protected $rule_tuple_count = null; /** - * A fully-qualified URL of a SecurityProfile resource instance. Example: https://networksecurity.googleapis.com/v1/projects/{project}/locations/{location}/securityProfileGroups/my-security-profile-group Must be specified if action is one of 'apply_security_profile_group' or 'mirror'. Cannot be specified for other actions. + * A fully-qualified URL of a SecurityProfile resource instance. + * Example: + * https://networksecurity.googleapis.com/v1/projects/{project}/locations/{location}/securityProfileGroups/my-security-profile-group + * Must be specified if action is one of 'apply_security_profile_group' or + * 'mirror'. Cannot be specified for other actions. * * Generated from protobuf field optional string security_profile_group = 207411626; */ protected $security_profile_group = null; /** - * A list of network resource URLs to which this rule applies. This field allows you to control which network's VMs get this rule. If this field is left blank, all VMs within the organization will receive the rule. + * A list of network resource URLs to which this rule applies. This field + * allows you to control which network's VMs get this rule. If this field + * is left blank, all VMs within the organization will receive the rule. * * Generated from protobuf field repeated string target_resources = 528230647; */ private $target_resources; /** - * A list of secure tags that controls which instances the firewall rule applies to. If targetSecureTag are specified, then the firewall rule applies only to instances in the VPC network that have one of those EFFECTIVE secure tags, if all the target_secure_tag are in INEFFECTIVE state, then this rule will be ignored. targetSecureTag may not be set at the same time as targetServiceAccounts. If neither targetServiceAccounts nor targetSecureTag are specified, the firewall rule applies to all instances on the specified network. Maximum number of target label tags allowed is 256. + * A list of secure tags that controls which instances the firewall rule + * applies to. If targetSecureTag are specified, then the + * firewall rule applies only to instances in the VPC network that have one + * of those EFFECTIVE secure tags, if all the target_secure_tag are in + * INEFFECTIVE state, then this rule will be ignored.targetSecureTag may not be set at the same time astargetServiceAccounts. + * If neither targetServiceAccounts nortargetSecureTag are specified, the firewall rule applies + * to all instances on the specified network. + * Maximum number of target label tags allowed is 256. * * Generated from protobuf field repeated .google.cloud.compute.v1.FirewallPolicyRuleSecureTag target_secure_tags = 468132403; */ private $target_secure_tags; /** - * A list of service accounts indicating the sets of instances that are applied with this rule. + * A list of service accounts indicating the sets of instances that are + * applied with this rule. * * Generated from protobuf field repeated string target_service_accounts = 457639710; */ private $target_service_accounts; /** - * Boolean flag indicating if the traffic should be TLS decrypted. Can be set only if action = 'apply_security_profile_group' and cannot be set for other actions. + * Boolean flag indicating if the traffic should be TLS decrypted. + * Can be set only if action = 'apply_security_profile_group' and cannot + * be set for other actions. * * Generated from protobuf field optional bool tls_inspect = 43425488; */ @@ -114,36 +147,68 @@ class FirewallPolicyRule extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $action - * The Action to perform when the client connection triggers the rule. Valid actions for firewall rules are: "allow", "deny", "apply_security_profile_group" and "goto_next". Valid actions for packet mirroring rules are: "mirror", "do_not_mirror" and "goto_next". + * The Action to perform when the client connection triggers the rule. + * Valid actions for firewall rules are: "allow", "deny", + * "apply_security_profile_group" and "goto_next". + * Valid actions for packet mirroring rules are: "mirror", "do_not_mirror" + * and "goto_next". * @type string $description * An optional description for this resource. * @type string $direction * The direction in which this rule applies. * Check the Direction enum for the list of possible values. * @type bool $disabled - * Denotes whether the firewall policy rule is disabled. When set to true, the firewall policy rule is not enforced and traffic behaves as if it did not exist. If this is unspecified, the firewall policy rule will be enabled. + * Denotes whether the firewall policy rule is disabled. When set to true, + * the firewall policy rule is not enforced and traffic behaves as if it did + * not exist. If this is unspecified, the firewall policy rule will be + * enabled. * @type bool $enable_logging - * Denotes whether to enable logging for a particular rule. If logging is enabled, logs will be exported to the configured export destination in Stackdriver. Logs may be exported to BigQuery or Pub/Sub. Note: you cannot enable logging on "goto_next" rules. + * Denotes whether to enable logging for a particular rule. If logging is + * enabled, logs will be exported to the configured export destination in + * Stackdriver. Logs may be exported to BigQuery or Pub/Sub. Note: you + * cannot enable logging on "goto_next" rules. * @type string $kind - * [Output only] Type of the resource. Returns compute#firewallPolicyRule for firewall rules and compute#packetMirroringRule for packet mirroring rules. + * [Output only] Type of the resource. Returnscompute#firewallPolicyRule for firewall rules andcompute#packetMirroringRule for packet mirroring rules. * @type \Google\Cloud\Compute\V1\FirewallPolicyRuleMatcher $match - * A match condition that incoming traffic is evaluated against. If it evaluates to true, the corresponding 'action' is enforced. + * A match condition that incoming traffic is evaluated against. + * If it evaluates to true, the corresponding 'action' is enforced. * @type int $priority - * An integer indicating the priority of a rule in the list. The priority must be a positive value between 0 and 2147483647. Rules are evaluated from highest to lowest priority where 0 is the highest priority and 2147483647 is the lowest priority. + * An integer indicating the priority of a rule in the list. The priority + * must be a positive value between 0 and 2147483647. + * Rules are evaluated from highest to lowest priority where 0 is the + * highest priority and 2147483647 is the lowest priority. * @type string $rule_name - * An optional name for the rule. This field is not a unique identifier and can be updated. + * An optional name for the rule. This field is not a unique identifier + * and can be updated. * @type int $rule_tuple_count - * [Output Only] Calculation of the complexity of a single firewall policy rule. + * [Output Only] Calculation of the complexity of a single firewall policy + * rule. * @type string $security_profile_group - * A fully-qualified URL of a SecurityProfile resource instance. Example: https://networksecurity.googleapis.com/v1/projects/{project}/locations/{location}/securityProfileGroups/my-security-profile-group Must be specified if action is one of 'apply_security_profile_group' or 'mirror'. Cannot be specified for other actions. + * A fully-qualified URL of a SecurityProfile resource instance. + * Example: + * https://networksecurity.googleapis.com/v1/projects/{project}/locations/{location}/securityProfileGroups/my-security-profile-group + * Must be specified if action is one of 'apply_security_profile_group' or + * 'mirror'. Cannot be specified for other actions. * @type array|\Google\Protobuf\Internal\RepeatedField $target_resources - * A list of network resource URLs to which this rule applies. This field allows you to control which network's VMs get this rule. If this field is left blank, all VMs within the organization will receive the rule. + * A list of network resource URLs to which this rule applies. This field + * allows you to control which network's VMs get this rule. If this field + * is left blank, all VMs within the organization will receive the rule. * @type array<\Google\Cloud\Compute\V1\FirewallPolicyRuleSecureTag>|\Google\Protobuf\Internal\RepeatedField $target_secure_tags - * A list of secure tags that controls which instances the firewall rule applies to. If targetSecureTag are specified, then the firewall rule applies only to instances in the VPC network that have one of those EFFECTIVE secure tags, if all the target_secure_tag are in INEFFECTIVE state, then this rule will be ignored. targetSecureTag may not be set at the same time as targetServiceAccounts. If neither targetServiceAccounts nor targetSecureTag are specified, the firewall rule applies to all instances on the specified network. Maximum number of target label tags allowed is 256. + * A list of secure tags that controls which instances the firewall rule + * applies to. If targetSecureTag are specified, then the + * firewall rule applies only to instances in the VPC network that have one + * of those EFFECTIVE secure tags, if all the target_secure_tag are in + * INEFFECTIVE state, then this rule will be ignored.targetSecureTag may not be set at the same time astargetServiceAccounts. + * If neither targetServiceAccounts nortargetSecureTag are specified, the firewall rule applies + * to all instances on the specified network. + * Maximum number of target label tags allowed is 256. * @type array|\Google\Protobuf\Internal\RepeatedField $target_service_accounts - * A list of service accounts indicating the sets of instances that are applied with this rule. + * A list of service accounts indicating the sets of instances that are + * applied with this rule. * @type bool $tls_inspect - * Boolean flag indicating if the traffic should be TLS decrypted. Can be set only if action = 'apply_security_profile_group' and cannot be set for other actions. + * Boolean flag indicating if the traffic should be TLS decrypted. + * Can be set only if action = 'apply_security_profile_group' and cannot + * be set for other actions. * } */ public function __construct($data = NULL) { @@ -152,7 +217,11 @@ public function __construct($data = NULL) { } /** - * The Action to perform when the client connection triggers the rule. Valid actions for firewall rules are: "allow", "deny", "apply_security_profile_group" and "goto_next". Valid actions for packet mirroring rules are: "mirror", "do_not_mirror" and "goto_next". + * The Action to perform when the client connection triggers the rule. + * Valid actions for firewall rules are: "allow", "deny", + * "apply_security_profile_group" and "goto_next". + * Valid actions for packet mirroring rules are: "mirror", "do_not_mirror" + * and "goto_next". * * Generated from protobuf field optional string action = 187661878; * @return string @@ -173,7 +242,11 @@ public function clearAction() } /** - * The Action to perform when the client connection triggers the rule. Valid actions for firewall rules are: "allow", "deny", "apply_security_profile_group" and "goto_next". Valid actions for packet mirroring rules are: "mirror", "do_not_mirror" and "goto_next". + * The Action to perform when the client connection triggers the rule. + * Valid actions for firewall rules are: "allow", "deny", + * "apply_security_profile_group" and "goto_next". + * Valid actions for packet mirroring rules are: "mirror", "do_not_mirror" + * and "goto_next". * * Generated from protobuf field optional string action = 187661878; * @param string $var @@ -262,7 +335,10 @@ public function setDirection($var) } /** - * Denotes whether the firewall policy rule is disabled. When set to true, the firewall policy rule is not enforced and traffic behaves as if it did not exist. If this is unspecified, the firewall policy rule will be enabled. + * Denotes whether the firewall policy rule is disabled. When set to true, + * the firewall policy rule is not enforced and traffic behaves as if it did + * not exist. If this is unspecified, the firewall policy rule will be + * enabled. * * Generated from protobuf field optional bool disabled = 270940796; * @return bool @@ -283,7 +359,10 @@ public function clearDisabled() } /** - * Denotes whether the firewall policy rule is disabled. When set to true, the firewall policy rule is not enforced and traffic behaves as if it did not exist. If this is unspecified, the firewall policy rule will be enabled. + * Denotes whether the firewall policy rule is disabled. When set to true, + * the firewall policy rule is not enforced and traffic behaves as if it did + * not exist. If this is unspecified, the firewall policy rule will be + * enabled. * * Generated from protobuf field optional bool disabled = 270940796; * @param bool $var @@ -298,7 +377,10 @@ public function setDisabled($var) } /** - * Denotes whether to enable logging for a particular rule. If logging is enabled, logs will be exported to the configured export destination in Stackdriver. Logs may be exported to BigQuery or Pub/Sub. Note: you cannot enable logging on "goto_next" rules. + * Denotes whether to enable logging for a particular rule. If logging is + * enabled, logs will be exported to the configured export destination in + * Stackdriver. Logs may be exported to BigQuery or Pub/Sub. Note: you + * cannot enable logging on "goto_next" rules. * * Generated from protobuf field optional bool enable_logging = 295396515; * @return bool @@ -319,7 +401,10 @@ public function clearEnableLogging() } /** - * Denotes whether to enable logging for a particular rule. If logging is enabled, logs will be exported to the configured export destination in Stackdriver. Logs may be exported to BigQuery or Pub/Sub. Note: you cannot enable logging on "goto_next" rules. + * Denotes whether to enable logging for a particular rule. If logging is + * enabled, logs will be exported to the configured export destination in + * Stackdriver. Logs may be exported to BigQuery or Pub/Sub. Note: you + * cannot enable logging on "goto_next" rules. * * Generated from protobuf field optional bool enable_logging = 295396515; * @param bool $var @@ -334,7 +419,7 @@ public function setEnableLogging($var) } /** - * [Output only] Type of the resource. Returns compute#firewallPolicyRule for firewall rules and compute#packetMirroringRule for packet mirroring rules. + * [Output only] Type of the resource. Returnscompute#firewallPolicyRule for firewall rules andcompute#packetMirroringRule for packet mirroring rules. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -355,7 +440,7 @@ public function clearKind() } /** - * [Output only] Type of the resource. Returns compute#firewallPolicyRule for firewall rules and compute#packetMirroringRule for packet mirroring rules. + * [Output only] Type of the resource. Returnscompute#firewallPolicyRule for firewall rules andcompute#packetMirroringRule for packet mirroring rules. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -370,7 +455,8 @@ public function setKind($var) } /** - * A match condition that incoming traffic is evaluated against. If it evaluates to true, the corresponding 'action' is enforced. + * A match condition that incoming traffic is evaluated against. + * If it evaluates to true, the corresponding 'action' is enforced. * * Generated from protobuf field optional .google.cloud.compute.v1.FirewallPolicyRuleMatcher match = 103668165; * @return \Google\Cloud\Compute\V1\FirewallPolicyRuleMatcher|null @@ -391,7 +477,8 @@ public function clearMatch() } /** - * A match condition that incoming traffic is evaluated against. If it evaluates to true, the corresponding 'action' is enforced. + * A match condition that incoming traffic is evaluated against. + * If it evaluates to true, the corresponding 'action' is enforced. * * Generated from protobuf field optional .google.cloud.compute.v1.FirewallPolicyRuleMatcher match = 103668165; * @param \Google\Cloud\Compute\V1\FirewallPolicyRuleMatcher $var @@ -406,7 +493,10 @@ public function setMatch($var) } /** - * An integer indicating the priority of a rule in the list. The priority must be a positive value between 0 and 2147483647. Rules are evaluated from highest to lowest priority where 0 is the highest priority and 2147483647 is the lowest priority. + * An integer indicating the priority of a rule in the list. The priority + * must be a positive value between 0 and 2147483647. + * Rules are evaluated from highest to lowest priority where 0 is the + * highest priority and 2147483647 is the lowest priority. * * Generated from protobuf field optional int32 priority = 445151652; * @return int @@ -427,7 +517,10 @@ public function clearPriority() } /** - * An integer indicating the priority of a rule in the list. The priority must be a positive value between 0 and 2147483647. Rules are evaluated from highest to lowest priority where 0 is the highest priority and 2147483647 is the lowest priority. + * An integer indicating the priority of a rule in the list. The priority + * must be a positive value between 0 and 2147483647. + * Rules are evaluated from highest to lowest priority where 0 is the + * highest priority and 2147483647 is the lowest priority. * * Generated from protobuf field optional int32 priority = 445151652; * @param int $var @@ -442,7 +535,8 @@ public function setPriority($var) } /** - * An optional name for the rule. This field is not a unique identifier and can be updated. + * An optional name for the rule. This field is not a unique identifier + * and can be updated. * * Generated from protobuf field optional string rule_name = 55286254; * @return string @@ -463,7 +557,8 @@ public function clearRuleName() } /** - * An optional name for the rule. This field is not a unique identifier and can be updated. + * An optional name for the rule. This field is not a unique identifier + * and can be updated. * * Generated from protobuf field optional string rule_name = 55286254; * @param string $var @@ -478,7 +573,8 @@ public function setRuleName($var) } /** - * [Output Only] Calculation of the complexity of a single firewall policy rule. + * [Output Only] Calculation of the complexity of a single firewall policy + * rule. * * Generated from protobuf field optional int32 rule_tuple_count = 388342037; * @return int @@ -499,7 +595,8 @@ public function clearRuleTupleCount() } /** - * [Output Only] Calculation of the complexity of a single firewall policy rule. + * [Output Only] Calculation of the complexity of a single firewall policy + * rule. * * Generated from protobuf field optional int32 rule_tuple_count = 388342037; * @param int $var @@ -514,7 +611,11 @@ public function setRuleTupleCount($var) } /** - * A fully-qualified URL of a SecurityProfile resource instance. Example: https://networksecurity.googleapis.com/v1/projects/{project}/locations/{location}/securityProfileGroups/my-security-profile-group Must be specified if action is one of 'apply_security_profile_group' or 'mirror'. Cannot be specified for other actions. + * A fully-qualified URL of a SecurityProfile resource instance. + * Example: + * https://networksecurity.googleapis.com/v1/projects/{project}/locations/{location}/securityProfileGroups/my-security-profile-group + * Must be specified if action is one of 'apply_security_profile_group' or + * 'mirror'. Cannot be specified for other actions. * * Generated from protobuf field optional string security_profile_group = 207411626; * @return string @@ -535,7 +636,11 @@ public function clearSecurityProfileGroup() } /** - * A fully-qualified URL of a SecurityProfile resource instance. Example: https://networksecurity.googleapis.com/v1/projects/{project}/locations/{location}/securityProfileGroups/my-security-profile-group Must be specified if action is one of 'apply_security_profile_group' or 'mirror'. Cannot be specified for other actions. + * A fully-qualified URL of a SecurityProfile resource instance. + * Example: + * https://networksecurity.googleapis.com/v1/projects/{project}/locations/{location}/securityProfileGroups/my-security-profile-group + * Must be specified if action is one of 'apply_security_profile_group' or + * 'mirror'. Cannot be specified for other actions. * * Generated from protobuf field optional string security_profile_group = 207411626; * @param string $var @@ -550,7 +655,9 @@ public function setSecurityProfileGroup($var) } /** - * A list of network resource URLs to which this rule applies. This field allows you to control which network's VMs get this rule. If this field is left blank, all VMs within the organization will receive the rule. + * A list of network resource URLs to which this rule applies. This field + * allows you to control which network's VMs get this rule. If this field + * is left blank, all VMs within the organization will receive the rule. * * Generated from protobuf field repeated string target_resources = 528230647; * @return \Google\Protobuf\Internal\RepeatedField @@ -561,7 +668,9 @@ public function getTargetResources() } /** - * A list of network resource URLs to which this rule applies. This field allows you to control which network's VMs get this rule. If this field is left blank, all VMs within the organization will receive the rule. + * A list of network resource URLs to which this rule applies. This field + * allows you to control which network's VMs get this rule. If this field + * is left blank, all VMs within the organization will receive the rule. * * Generated from protobuf field repeated string target_resources = 528230647; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -576,7 +685,14 @@ public function setTargetResources($var) } /** - * A list of secure tags that controls which instances the firewall rule applies to. If targetSecureTag are specified, then the firewall rule applies only to instances in the VPC network that have one of those EFFECTIVE secure tags, if all the target_secure_tag are in INEFFECTIVE state, then this rule will be ignored. targetSecureTag may not be set at the same time as targetServiceAccounts. If neither targetServiceAccounts nor targetSecureTag are specified, the firewall rule applies to all instances on the specified network. Maximum number of target label tags allowed is 256. + * A list of secure tags that controls which instances the firewall rule + * applies to. If targetSecureTag are specified, then the + * firewall rule applies only to instances in the VPC network that have one + * of those EFFECTIVE secure tags, if all the target_secure_tag are in + * INEFFECTIVE state, then this rule will be ignored.targetSecureTag may not be set at the same time astargetServiceAccounts. + * If neither targetServiceAccounts nortargetSecureTag are specified, the firewall rule applies + * to all instances on the specified network. + * Maximum number of target label tags allowed is 256. * * Generated from protobuf field repeated .google.cloud.compute.v1.FirewallPolicyRuleSecureTag target_secure_tags = 468132403; * @return \Google\Protobuf\Internal\RepeatedField @@ -587,7 +703,14 @@ public function getTargetSecureTags() } /** - * A list of secure tags that controls which instances the firewall rule applies to. If targetSecureTag are specified, then the firewall rule applies only to instances in the VPC network that have one of those EFFECTIVE secure tags, if all the target_secure_tag are in INEFFECTIVE state, then this rule will be ignored. targetSecureTag may not be set at the same time as targetServiceAccounts. If neither targetServiceAccounts nor targetSecureTag are specified, the firewall rule applies to all instances on the specified network. Maximum number of target label tags allowed is 256. + * A list of secure tags that controls which instances the firewall rule + * applies to. If targetSecureTag are specified, then the + * firewall rule applies only to instances in the VPC network that have one + * of those EFFECTIVE secure tags, if all the target_secure_tag are in + * INEFFECTIVE state, then this rule will be ignored.targetSecureTag may not be set at the same time astargetServiceAccounts. + * If neither targetServiceAccounts nortargetSecureTag are specified, the firewall rule applies + * to all instances on the specified network. + * Maximum number of target label tags allowed is 256. * * Generated from protobuf field repeated .google.cloud.compute.v1.FirewallPolicyRuleSecureTag target_secure_tags = 468132403; * @param array<\Google\Cloud\Compute\V1\FirewallPolicyRuleSecureTag>|\Google\Protobuf\Internal\RepeatedField $var @@ -602,7 +725,8 @@ public function setTargetSecureTags($var) } /** - * A list of service accounts indicating the sets of instances that are applied with this rule. + * A list of service accounts indicating the sets of instances that are + * applied with this rule. * * Generated from protobuf field repeated string target_service_accounts = 457639710; * @return \Google\Protobuf\Internal\RepeatedField @@ -613,7 +737,8 @@ public function getTargetServiceAccounts() } /** - * A list of service accounts indicating the sets of instances that are applied with this rule. + * A list of service accounts indicating the sets of instances that are + * applied with this rule. * * Generated from protobuf field repeated string target_service_accounts = 457639710; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -628,7 +753,9 @@ public function setTargetServiceAccounts($var) } /** - * Boolean flag indicating if the traffic should be TLS decrypted. Can be set only if action = 'apply_security_profile_group' and cannot be set for other actions. + * Boolean flag indicating if the traffic should be TLS decrypted. + * Can be set only if action = 'apply_security_profile_group' and cannot + * be set for other actions. * * Generated from protobuf field optional bool tls_inspect = 43425488; * @return bool @@ -649,7 +776,9 @@ public function clearTlsInspect() } /** - * Boolean flag indicating if the traffic should be TLS decrypted. Can be set only if action = 'apply_security_profile_group' and cannot be set for other actions. + * Boolean flag indicating if the traffic should be TLS decrypted. + * Can be set only if action = 'apply_security_profile_group' and cannot + * be set for other actions. * * Generated from protobuf field optional bool tls_inspect = 43425488; * @param bool $var diff --git a/Compute/src/V1/FirewallPolicyRuleMatcher.php b/Compute/src/V1/FirewallPolicyRuleMatcher.php index 333fc8ae8e01..dda225489d1e 100644 --- a/Compute/src/V1/FirewallPolicyRuleMatcher.php +++ b/Compute/src/V1/FirewallPolicyRuleMatcher.php @@ -9,45 +9,57 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Represents a match condition that incoming traffic is evaluated against. Exactly one field must be specified. + * Represents a match condition that incoming traffic is evaluated against. + * Exactly one field must be specified. * * Generated from protobuf message google.cloud.compute.v1.FirewallPolicyRuleMatcher */ class FirewallPolicyRuleMatcher extends \Google\Protobuf\Internal\Message { /** - * Address groups which should be matched against the traffic destination. Maximum number of destination address groups is 10. + * Address groups which should be matched against the traffic destination. + * Maximum number of destination address groups is 10. * * Generated from protobuf field repeated string dest_address_groups = 468760508; */ private $dest_address_groups; /** - * Fully Qualified Domain Name (FQDN) which should be matched against traffic destination. Maximum number of destination fqdn allowed is 100. + * Fully Qualified Domain Name (FQDN) which should be matched against + * traffic destination. + * Maximum number of destination fqdn allowed is 100. * * Generated from protobuf field repeated string dest_fqdns = 370712737; */ private $dest_fqdns; /** - * CIDR IP address range. Maximum number of destination CIDR IP ranges allowed is 5000. + * CIDR IP address range. + * Maximum number of destination CIDR IP ranges allowed is 5000. * * Generated from protobuf field repeated string dest_ip_ranges = 337357713; */ private $dest_ip_ranges; /** - * Network type of the traffic destination. Allowed values are: - UNSPECIFIED - INTERNET - NON_INTERNET + * Network type of the traffic destination. Allowed values are: + * - UNSPECIFIED + * - INTERNET + * - NON_INTERNET * Check the DestNetworkType enum for the list of possible values. * * Generated from protobuf field optional string dest_network_type = 409853224; */ protected $dest_network_type = null; /** - * Region codes whose IP addresses will be used to match for destination of traffic. Should be specified as 2 letter country code defined as per ISO 3166 alpha-2 country codes. ex."US" Maximum number of dest region codes allowed is 5000. + * Region codes whose IP addresses will be used to match for destination + * of traffic. Should be specified as 2 letter country code defined as per + * ISO 3166 alpha-2 country codes. ex."US" + * Maximum number of dest region codes allowed is 5000. * * Generated from protobuf field repeated string dest_region_codes = 199120280; */ private $dest_region_codes; /** - * Names of Network Threat Intelligence lists. The IPs in these lists will be matched against traffic destination. + * Names of Network Threat Intelligence lists. + * The IPs in these lists will be matched against traffic destination. * * Generated from protobuf field repeated string dest_threat_intelligences = 119896492; */ @@ -59,25 +71,34 @@ class FirewallPolicyRuleMatcher extends \Google\Protobuf\Internal\Message */ private $layer4_configs; /** - * Address groups which should be matched against the traffic source. Maximum number of source address groups is 10. + * Address groups which should be matched against the traffic source. + * Maximum number of source address groups is 10. * * Generated from protobuf field repeated string src_address_groups = 436423738; */ private $src_address_groups; /** - * Fully Qualified Domain Name (FQDN) which should be matched against traffic source. Maximum number of source fqdn allowed is 100. + * Fully Qualified Domain Name (FQDN) which should be matched against + * traffic source. + * Maximum number of source fqdn allowed is 100. * * Generated from protobuf field repeated string src_fqdns = 435906147; */ private $src_fqdns; /** - * CIDR IP address range. Maximum number of source CIDR IP ranges allowed is 5000. + * CIDR IP address range. + * Maximum number of source CIDR IP ranges allowed is 5000. * * Generated from protobuf field repeated string src_ip_ranges = 432128083; */ private $src_ip_ranges; /** - * Network type of the traffic source. Allowed values are: - UNSPECIFIED - INTERNET - INTRA_VPC - NON_INTERNET - VPC_NETWORKS + * Network type of the traffic source. Allowed values are: + * - UNSPECIFIED + * - INTERNET + * - INTRA_VPC + * - NON_INTERNET + * - VPC_NETWORKS * Check the SrcNetworkType enum for the list of possible values. * * Generated from protobuf field optional string src_network_type = 309819686; @@ -90,19 +111,27 @@ class FirewallPolicyRuleMatcher extends \Google\Protobuf\Internal\Message */ private $src_networks; /** - * Region codes whose IP addresses will be used to match for source of traffic. Should be specified as 2 letter country code defined as per ISO 3166 alpha-2 country codes. ex."US" Maximum number of source region codes allowed is 5000. + * Region codes whose IP addresses will be used to match for source + * of traffic. Should be specified as 2 letter country code defined as per + * ISO 3166 alpha-2 country codes. ex."US" + * Maximum number of source region codes allowed is 5000. * * Generated from protobuf field repeated string src_region_codes = 99086742; */ private $src_region_codes; /** - * List of secure tag values, which should be matched at the source of the traffic. For INGRESS rule, if all the srcSecureTag are INEFFECTIVE, and there is no srcIpRange, this rule will be ignored. Maximum number of source tag values allowed is 256. + * List of secure tag values, which should be matched at the source + * of the traffic. + * For INGRESS rule, if all the srcSecureTag are INEFFECTIVE, + * and there is no srcIpRange, this rule will be ignored. + * Maximum number of source tag values allowed is 256. * * Generated from protobuf field repeated .google.cloud.compute.v1.FirewallPolicyRuleSecureTag src_secure_tags = 508791302; */ private $src_secure_tags; /** - * Names of Network Threat Intelligence lists. The IPs in these lists will be matched against traffic source. + * Names of Network Threat Intelligence lists. + * The IPs in these lists will be matched against traffic source. * * Generated from protobuf field repeated string src_threat_intelligences = 323631018; */ @@ -115,37 +144,65 @@ class FirewallPolicyRuleMatcher extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type array|\Google\Protobuf\Internal\RepeatedField $dest_address_groups - * Address groups which should be matched against the traffic destination. Maximum number of destination address groups is 10. + * Address groups which should be matched against the traffic destination. + * Maximum number of destination address groups is 10. * @type array|\Google\Protobuf\Internal\RepeatedField $dest_fqdns - * Fully Qualified Domain Name (FQDN) which should be matched against traffic destination. Maximum number of destination fqdn allowed is 100. + * Fully Qualified Domain Name (FQDN) which should be matched against + * traffic destination. + * Maximum number of destination fqdn allowed is 100. * @type array|\Google\Protobuf\Internal\RepeatedField $dest_ip_ranges - * CIDR IP address range. Maximum number of destination CIDR IP ranges allowed is 5000. + * CIDR IP address range. + * Maximum number of destination CIDR IP ranges allowed is 5000. * @type string $dest_network_type - * Network type of the traffic destination. Allowed values are: - UNSPECIFIED - INTERNET - NON_INTERNET + * Network type of the traffic destination. Allowed values are: + * - UNSPECIFIED + * - INTERNET + * - NON_INTERNET * Check the DestNetworkType enum for the list of possible values. * @type array|\Google\Protobuf\Internal\RepeatedField $dest_region_codes - * Region codes whose IP addresses will be used to match for destination of traffic. Should be specified as 2 letter country code defined as per ISO 3166 alpha-2 country codes. ex."US" Maximum number of dest region codes allowed is 5000. + * Region codes whose IP addresses will be used to match for destination + * of traffic. Should be specified as 2 letter country code defined as per + * ISO 3166 alpha-2 country codes. ex."US" + * Maximum number of dest region codes allowed is 5000. * @type array|\Google\Protobuf\Internal\RepeatedField $dest_threat_intelligences - * Names of Network Threat Intelligence lists. The IPs in these lists will be matched against traffic destination. + * Names of Network Threat Intelligence lists. + * The IPs in these lists will be matched against traffic destination. * @type array<\Google\Cloud\Compute\V1\FirewallPolicyRuleMatcherLayer4Config>|\Google\Protobuf\Internal\RepeatedField $layer4_configs * Pairs of IP protocols and ports that the rule should match. * @type array|\Google\Protobuf\Internal\RepeatedField $src_address_groups - * Address groups which should be matched against the traffic source. Maximum number of source address groups is 10. + * Address groups which should be matched against the traffic source. + * Maximum number of source address groups is 10. * @type array|\Google\Protobuf\Internal\RepeatedField $src_fqdns - * Fully Qualified Domain Name (FQDN) which should be matched against traffic source. Maximum number of source fqdn allowed is 100. + * Fully Qualified Domain Name (FQDN) which should be matched against + * traffic source. + * Maximum number of source fqdn allowed is 100. * @type array|\Google\Protobuf\Internal\RepeatedField $src_ip_ranges - * CIDR IP address range. Maximum number of source CIDR IP ranges allowed is 5000. + * CIDR IP address range. + * Maximum number of source CIDR IP ranges allowed is 5000. * @type string $src_network_type - * Network type of the traffic source. Allowed values are: - UNSPECIFIED - INTERNET - INTRA_VPC - NON_INTERNET - VPC_NETWORKS + * Network type of the traffic source. Allowed values are: + * - UNSPECIFIED + * - INTERNET + * - INTRA_VPC + * - NON_INTERNET + * - VPC_NETWORKS * Check the SrcNetworkType enum for the list of possible values. * @type array|\Google\Protobuf\Internal\RepeatedField $src_networks * Networks of the traffic source. It can be either a full or partial url. * @type array|\Google\Protobuf\Internal\RepeatedField $src_region_codes - * Region codes whose IP addresses will be used to match for source of traffic. Should be specified as 2 letter country code defined as per ISO 3166 alpha-2 country codes. ex."US" Maximum number of source region codes allowed is 5000. + * Region codes whose IP addresses will be used to match for source + * of traffic. Should be specified as 2 letter country code defined as per + * ISO 3166 alpha-2 country codes. ex."US" + * Maximum number of source region codes allowed is 5000. * @type array<\Google\Cloud\Compute\V1\FirewallPolicyRuleSecureTag>|\Google\Protobuf\Internal\RepeatedField $src_secure_tags - * List of secure tag values, which should be matched at the source of the traffic. For INGRESS rule, if all the srcSecureTag are INEFFECTIVE, and there is no srcIpRange, this rule will be ignored. Maximum number of source tag values allowed is 256. + * List of secure tag values, which should be matched at the source + * of the traffic. + * For INGRESS rule, if all the srcSecureTag are INEFFECTIVE, + * and there is no srcIpRange, this rule will be ignored. + * Maximum number of source tag values allowed is 256. * @type array|\Google\Protobuf\Internal\RepeatedField $src_threat_intelligences - * Names of Network Threat Intelligence lists. The IPs in these lists will be matched against traffic source. + * Names of Network Threat Intelligence lists. + * The IPs in these lists will be matched against traffic source. * } */ public function __construct($data = NULL) { @@ -154,7 +211,8 @@ public function __construct($data = NULL) { } /** - * Address groups which should be matched against the traffic destination. Maximum number of destination address groups is 10. + * Address groups which should be matched against the traffic destination. + * Maximum number of destination address groups is 10. * * Generated from protobuf field repeated string dest_address_groups = 468760508; * @return \Google\Protobuf\Internal\RepeatedField @@ -165,7 +223,8 @@ public function getDestAddressGroups() } /** - * Address groups which should be matched against the traffic destination. Maximum number of destination address groups is 10. + * Address groups which should be matched against the traffic destination. + * Maximum number of destination address groups is 10. * * Generated from protobuf field repeated string dest_address_groups = 468760508; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -180,7 +239,9 @@ public function setDestAddressGroups($var) } /** - * Fully Qualified Domain Name (FQDN) which should be matched against traffic destination. Maximum number of destination fqdn allowed is 100. + * Fully Qualified Domain Name (FQDN) which should be matched against + * traffic destination. + * Maximum number of destination fqdn allowed is 100. * * Generated from protobuf field repeated string dest_fqdns = 370712737; * @return \Google\Protobuf\Internal\RepeatedField @@ -191,7 +252,9 @@ public function getDestFqdns() } /** - * Fully Qualified Domain Name (FQDN) which should be matched against traffic destination. Maximum number of destination fqdn allowed is 100. + * Fully Qualified Domain Name (FQDN) which should be matched against + * traffic destination. + * Maximum number of destination fqdn allowed is 100. * * Generated from protobuf field repeated string dest_fqdns = 370712737; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -206,7 +269,8 @@ public function setDestFqdns($var) } /** - * CIDR IP address range. Maximum number of destination CIDR IP ranges allowed is 5000. + * CIDR IP address range. + * Maximum number of destination CIDR IP ranges allowed is 5000. * * Generated from protobuf field repeated string dest_ip_ranges = 337357713; * @return \Google\Protobuf\Internal\RepeatedField @@ -217,7 +281,8 @@ public function getDestIpRanges() } /** - * CIDR IP address range. Maximum number of destination CIDR IP ranges allowed is 5000. + * CIDR IP address range. + * Maximum number of destination CIDR IP ranges allowed is 5000. * * Generated from protobuf field repeated string dest_ip_ranges = 337357713; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -232,7 +297,10 @@ public function setDestIpRanges($var) } /** - * Network type of the traffic destination. Allowed values are: - UNSPECIFIED - INTERNET - NON_INTERNET + * Network type of the traffic destination. Allowed values are: + * - UNSPECIFIED + * - INTERNET + * - NON_INTERNET * Check the DestNetworkType enum for the list of possible values. * * Generated from protobuf field optional string dest_network_type = 409853224; @@ -254,7 +322,10 @@ public function clearDestNetworkType() } /** - * Network type of the traffic destination. Allowed values are: - UNSPECIFIED - INTERNET - NON_INTERNET + * Network type of the traffic destination. Allowed values are: + * - UNSPECIFIED + * - INTERNET + * - NON_INTERNET * Check the DestNetworkType enum for the list of possible values. * * Generated from protobuf field optional string dest_network_type = 409853224; @@ -270,7 +341,10 @@ public function setDestNetworkType($var) } /** - * Region codes whose IP addresses will be used to match for destination of traffic. Should be specified as 2 letter country code defined as per ISO 3166 alpha-2 country codes. ex."US" Maximum number of dest region codes allowed is 5000. + * Region codes whose IP addresses will be used to match for destination + * of traffic. Should be specified as 2 letter country code defined as per + * ISO 3166 alpha-2 country codes. ex."US" + * Maximum number of dest region codes allowed is 5000. * * Generated from protobuf field repeated string dest_region_codes = 199120280; * @return \Google\Protobuf\Internal\RepeatedField @@ -281,7 +355,10 @@ public function getDestRegionCodes() } /** - * Region codes whose IP addresses will be used to match for destination of traffic. Should be specified as 2 letter country code defined as per ISO 3166 alpha-2 country codes. ex."US" Maximum number of dest region codes allowed is 5000. + * Region codes whose IP addresses will be used to match for destination + * of traffic. Should be specified as 2 letter country code defined as per + * ISO 3166 alpha-2 country codes. ex."US" + * Maximum number of dest region codes allowed is 5000. * * Generated from protobuf field repeated string dest_region_codes = 199120280; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -296,7 +373,8 @@ public function setDestRegionCodes($var) } /** - * Names of Network Threat Intelligence lists. The IPs in these lists will be matched against traffic destination. + * Names of Network Threat Intelligence lists. + * The IPs in these lists will be matched against traffic destination. * * Generated from protobuf field repeated string dest_threat_intelligences = 119896492; * @return \Google\Protobuf\Internal\RepeatedField @@ -307,7 +385,8 @@ public function getDestThreatIntelligences() } /** - * Names of Network Threat Intelligence lists. The IPs in these lists will be matched against traffic destination. + * Names of Network Threat Intelligence lists. + * The IPs in these lists will be matched against traffic destination. * * Generated from protobuf field repeated string dest_threat_intelligences = 119896492; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -348,7 +427,8 @@ public function setLayer4Configs($var) } /** - * Address groups which should be matched against the traffic source. Maximum number of source address groups is 10. + * Address groups which should be matched against the traffic source. + * Maximum number of source address groups is 10. * * Generated from protobuf field repeated string src_address_groups = 436423738; * @return \Google\Protobuf\Internal\RepeatedField @@ -359,7 +439,8 @@ public function getSrcAddressGroups() } /** - * Address groups which should be matched against the traffic source. Maximum number of source address groups is 10. + * Address groups which should be matched against the traffic source. + * Maximum number of source address groups is 10. * * Generated from protobuf field repeated string src_address_groups = 436423738; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -374,7 +455,9 @@ public function setSrcAddressGroups($var) } /** - * Fully Qualified Domain Name (FQDN) which should be matched against traffic source. Maximum number of source fqdn allowed is 100. + * Fully Qualified Domain Name (FQDN) which should be matched against + * traffic source. + * Maximum number of source fqdn allowed is 100. * * Generated from protobuf field repeated string src_fqdns = 435906147; * @return \Google\Protobuf\Internal\RepeatedField @@ -385,7 +468,9 @@ public function getSrcFqdns() } /** - * Fully Qualified Domain Name (FQDN) which should be matched against traffic source. Maximum number of source fqdn allowed is 100. + * Fully Qualified Domain Name (FQDN) which should be matched against + * traffic source. + * Maximum number of source fqdn allowed is 100. * * Generated from protobuf field repeated string src_fqdns = 435906147; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -400,7 +485,8 @@ public function setSrcFqdns($var) } /** - * CIDR IP address range. Maximum number of source CIDR IP ranges allowed is 5000. + * CIDR IP address range. + * Maximum number of source CIDR IP ranges allowed is 5000. * * Generated from protobuf field repeated string src_ip_ranges = 432128083; * @return \Google\Protobuf\Internal\RepeatedField @@ -411,7 +497,8 @@ public function getSrcIpRanges() } /** - * CIDR IP address range. Maximum number of source CIDR IP ranges allowed is 5000. + * CIDR IP address range. + * Maximum number of source CIDR IP ranges allowed is 5000. * * Generated from protobuf field repeated string src_ip_ranges = 432128083; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -426,7 +513,12 @@ public function setSrcIpRanges($var) } /** - * Network type of the traffic source. Allowed values are: - UNSPECIFIED - INTERNET - INTRA_VPC - NON_INTERNET - VPC_NETWORKS + * Network type of the traffic source. Allowed values are: + * - UNSPECIFIED + * - INTERNET + * - INTRA_VPC + * - NON_INTERNET + * - VPC_NETWORKS * Check the SrcNetworkType enum for the list of possible values. * * Generated from protobuf field optional string src_network_type = 309819686; @@ -448,7 +540,12 @@ public function clearSrcNetworkType() } /** - * Network type of the traffic source. Allowed values are: - UNSPECIFIED - INTERNET - INTRA_VPC - NON_INTERNET - VPC_NETWORKS + * Network type of the traffic source. Allowed values are: + * - UNSPECIFIED + * - INTERNET + * - INTRA_VPC + * - NON_INTERNET + * - VPC_NETWORKS * Check the SrcNetworkType enum for the list of possible values. * * Generated from protobuf field optional string src_network_type = 309819686; @@ -490,7 +587,10 @@ public function setSrcNetworks($var) } /** - * Region codes whose IP addresses will be used to match for source of traffic. Should be specified as 2 letter country code defined as per ISO 3166 alpha-2 country codes. ex."US" Maximum number of source region codes allowed is 5000. + * Region codes whose IP addresses will be used to match for source + * of traffic. Should be specified as 2 letter country code defined as per + * ISO 3166 alpha-2 country codes. ex."US" + * Maximum number of source region codes allowed is 5000. * * Generated from protobuf field repeated string src_region_codes = 99086742; * @return \Google\Protobuf\Internal\RepeatedField @@ -501,7 +601,10 @@ public function getSrcRegionCodes() } /** - * Region codes whose IP addresses will be used to match for source of traffic. Should be specified as 2 letter country code defined as per ISO 3166 alpha-2 country codes. ex."US" Maximum number of source region codes allowed is 5000. + * Region codes whose IP addresses will be used to match for source + * of traffic. Should be specified as 2 letter country code defined as per + * ISO 3166 alpha-2 country codes. ex."US" + * Maximum number of source region codes allowed is 5000. * * Generated from protobuf field repeated string src_region_codes = 99086742; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -516,7 +619,11 @@ public function setSrcRegionCodes($var) } /** - * List of secure tag values, which should be matched at the source of the traffic. For INGRESS rule, if all the srcSecureTag are INEFFECTIVE, and there is no srcIpRange, this rule will be ignored. Maximum number of source tag values allowed is 256. + * List of secure tag values, which should be matched at the source + * of the traffic. + * For INGRESS rule, if all the srcSecureTag are INEFFECTIVE, + * and there is no srcIpRange, this rule will be ignored. + * Maximum number of source tag values allowed is 256. * * Generated from protobuf field repeated .google.cloud.compute.v1.FirewallPolicyRuleSecureTag src_secure_tags = 508791302; * @return \Google\Protobuf\Internal\RepeatedField @@ -527,7 +634,11 @@ public function getSrcSecureTags() } /** - * List of secure tag values, which should be matched at the source of the traffic. For INGRESS rule, if all the srcSecureTag are INEFFECTIVE, and there is no srcIpRange, this rule will be ignored. Maximum number of source tag values allowed is 256. + * List of secure tag values, which should be matched at the source + * of the traffic. + * For INGRESS rule, if all the srcSecureTag are INEFFECTIVE, + * and there is no srcIpRange, this rule will be ignored. + * Maximum number of source tag values allowed is 256. * * Generated from protobuf field repeated .google.cloud.compute.v1.FirewallPolicyRuleSecureTag src_secure_tags = 508791302; * @param array<\Google\Cloud\Compute\V1\FirewallPolicyRuleSecureTag>|\Google\Protobuf\Internal\RepeatedField $var @@ -542,7 +653,8 @@ public function setSrcSecureTags($var) } /** - * Names of Network Threat Intelligence lists. The IPs in these lists will be matched against traffic source. + * Names of Network Threat Intelligence lists. + * The IPs in these lists will be matched against traffic source. * * Generated from protobuf field repeated string src_threat_intelligences = 323631018; * @return \Google\Protobuf\Internal\RepeatedField @@ -553,7 +665,8 @@ public function getSrcThreatIntelligences() } /** - * Names of Network Threat Intelligence lists. The IPs in these lists will be matched against traffic source. + * Names of Network Threat Intelligence lists. + * The IPs in these lists will be matched against traffic source. * * Generated from protobuf field repeated string src_threat_intelligences = 323631018; * @param array|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/FirewallPolicyRuleMatcher/DestNetworkType.php b/Compute/src/V1/FirewallPolicyRuleMatcher/DestNetworkType.php index 363449a7ed58..521ae8ee8722 100644 --- a/Compute/src/V1/FirewallPolicyRuleMatcher/DestNetworkType.php +++ b/Compute/src/V1/FirewallPolicyRuleMatcher/DestNetworkType.php @@ -7,7 +7,10 @@ use UnexpectedValueException; /** - * Network type of the traffic destination. Allowed values are: - UNSPECIFIED - INTERNET - NON_INTERNET + * Network type of the traffic destination. Allowed values are: + * - UNSPECIFIED + * - INTERNET + * - NON_INTERNET * Additional supported values which may be not listed in the enum directly due to technical reasons: * INTERNET * INTRA_VPC diff --git a/Compute/src/V1/FirewallPolicyRuleMatcher/SrcNetworkType.php b/Compute/src/V1/FirewallPolicyRuleMatcher/SrcNetworkType.php index 1d6c4864670c..772180a17e38 100644 --- a/Compute/src/V1/FirewallPolicyRuleMatcher/SrcNetworkType.php +++ b/Compute/src/V1/FirewallPolicyRuleMatcher/SrcNetworkType.php @@ -7,7 +7,12 @@ use UnexpectedValueException; /** - * Network type of the traffic source. Allowed values are: - UNSPECIFIED - INTERNET - INTRA_VPC - NON_INTERNET - VPC_NETWORKS + * Network type of the traffic source. Allowed values are: + * - UNSPECIFIED + * - INTERNET + * - INTRA_VPC + * - NON_INTERNET + * - VPC_NETWORKS * Additional supported values which may be not listed in the enum directly due to technical reasons: * INTERNET * INTRA_VPC diff --git a/Compute/src/V1/FirewallPolicyRuleMatcherLayer4Config.php b/Compute/src/V1/FirewallPolicyRuleMatcherLayer4Config.php index aea21ff42098..743ce958119e 100644 --- a/Compute/src/V1/FirewallPolicyRuleMatcherLayer4Config.php +++ b/Compute/src/V1/FirewallPolicyRuleMatcherLayer4Config.php @@ -15,13 +15,20 @@ class FirewallPolicyRuleMatcherLayer4Config extends \Google\Protobuf\Internal\Message { /** - * The IP protocol to which this rule applies. The protocol type is required when creating a firewall rule. This value can either be one of the following well known protocol strings (tcp, udp, icmp, esp, ah, ipip, sctp), or the IP protocol number. + * The IP protocol to which this rule applies. The protocol type is + * required when creating a firewall rule. This value can either be + * one of the following well known protocol strings (tcp,udp, icmp, esp,ah, ipip, sctp), or the IP + * protocol number. * * Generated from protobuf field optional string ip_protocol = 475958960; */ protected $ip_protocol = null; /** - * An optional list of ports to which this rule applies. This field is only applicable for UDP or TCP protocol. Each entry must be either an integer or a range. If not specified, this rule applies to connections through any port. Example inputs include: ["22"], ["80","443"], and ["12345-12349"]. + * An optional list of ports to which this rule applies. This field is + * only applicable for UDP or TCP protocol. Each entry must be either + * an integer or a range. If not specified, this rule applies to + * connections through any port. + * Example inputs include: ["22"],["80","443"], and ["12345-12349"]. * * Generated from protobuf field repeated string ports = 106854418; */ @@ -34,9 +41,16 @@ class FirewallPolicyRuleMatcherLayer4Config extends \Google\Protobuf\Internal\Me * Optional. Data for populating the Message object. * * @type string $ip_protocol - * The IP protocol to which this rule applies. The protocol type is required when creating a firewall rule. This value can either be one of the following well known protocol strings (tcp, udp, icmp, esp, ah, ipip, sctp), or the IP protocol number. + * The IP protocol to which this rule applies. The protocol type is + * required when creating a firewall rule. This value can either be + * one of the following well known protocol strings (tcp,udp, icmp, esp,ah, ipip, sctp), or the IP + * protocol number. * @type array|\Google\Protobuf\Internal\RepeatedField $ports - * An optional list of ports to which this rule applies. This field is only applicable for UDP or TCP protocol. Each entry must be either an integer or a range. If not specified, this rule applies to connections through any port. Example inputs include: ["22"], ["80","443"], and ["12345-12349"]. + * An optional list of ports to which this rule applies. This field is + * only applicable for UDP or TCP protocol. Each entry must be either + * an integer or a range. If not specified, this rule applies to + * connections through any port. + * Example inputs include: ["22"],["80","443"], and ["12345-12349"]. * } */ public function __construct($data = NULL) { @@ -45,7 +59,10 @@ public function __construct($data = NULL) { } /** - * The IP protocol to which this rule applies. The protocol type is required when creating a firewall rule. This value can either be one of the following well known protocol strings (tcp, udp, icmp, esp, ah, ipip, sctp), or the IP protocol number. + * The IP protocol to which this rule applies. The protocol type is + * required when creating a firewall rule. This value can either be + * one of the following well known protocol strings (tcp,udp, icmp, esp,ah, ipip, sctp), or the IP + * protocol number. * * Generated from protobuf field optional string ip_protocol = 475958960; * @return string @@ -66,7 +83,10 @@ public function clearIpProtocol() } /** - * The IP protocol to which this rule applies. The protocol type is required when creating a firewall rule. This value can either be one of the following well known protocol strings (tcp, udp, icmp, esp, ah, ipip, sctp), or the IP protocol number. + * The IP protocol to which this rule applies. The protocol type is + * required when creating a firewall rule. This value can either be + * one of the following well known protocol strings (tcp,udp, icmp, esp,ah, ipip, sctp), or the IP + * protocol number. * * Generated from protobuf field optional string ip_protocol = 475958960; * @param string $var @@ -81,7 +101,11 @@ public function setIpProtocol($var) } /** - * An optional list of ports to which this rule applies. This field is only applicable for UDP or TCP protocol. Each entry must be either an integer or a range. If not specified, this rule applies to connections through any port. Example inputs include: ["22"], ["80","443"], and ["12345-12349"]. + * An optional list of ports to which this rule applies. This field is + * only applicable for UDP or TCP protocol. Each entry must be either + * an integer or a range. If not specified, this rule applies to + * connections through any port. + * Example inputs include: ["22"],["80","443"], and ["12345-12349"]. * * Generated from protobuf field repeated string ports = 106854418; * @return \Google\Protobuf\Internal\RepeatedField @@ -92,7 +116,11 @@ public function getPorts() } /** - * An optional list of ports to which this rule applies. This field is only applicable for UDP or TCP protocol. Each entry must be either an integer or a range. If not specified, this rule applies to connections through any port. Example inputs include: ["22"], ["80","443"], and ["12345-12349"]. + * An optional list of ports to which this rule applies. This field is + * only applicable for UDP or TCP protocol. Each entry must be either + * an integer or a range. If not specified, this rule applies to + * connections through any port. + * Example inputs include: ["22"],["80","443"], and ["12345-12349"]. * * Generated from protobuf field repeated string ports = 106854418; * @param array|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/FirewallPolicyRuleSecureTag.php b/Compute/src/V1/FirewallPolicyRuleSecureTag.php index 38bd61e12736..b5f8248e0205 100644 --- a/Compute/src/V1/FirewallPolicyRuleSecureTag.php +++ b/Compute/src/V1/FirewallPolicyRuleSecureTag.php @@ -21,7 +21,9 @@ class FirewallPolicyRuleSecureTag extends \Google\Protobuf\Internal\Message */ protected $name = null; /** - * [Output Only] State of the secure tag, either `EFFECTIVE` or `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted or its network is deleted. + * [Output Only] State of the secure tag, either `EFFECTIVE` or + * `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted + * or its network is deleted. * Check the State enum for the list of possible values. * * Generated from protobuf field optional string state = 109757585; @@ -37,7 +39,9 @@ class FirewallPolicyRuleSecureTag extends \Google\Protobuf\Internal\Message * @type string $name * Name of the secure tag, created with TagManager's TagValue API. * @type string $state - * [Output Only] State of the secure tag, either `EFFECTIVE` or `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted or its network is deleted. + * [Output Only] State of the secure tag, either `EFFECTIVE` or + * `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted + * or its network is deleted. * Check the State enum for the list of possible values. * } */ @@ -83,7 +87,9 @@ public function setName($var) } /** - * [Output Only] State of the secure tag, either `EFFECTIVE` or `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted or its network is deleted. + * [Output Only] State of the secure tag, either `EFFECTIVE` or + * `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted + * or its network is deleted. * Check the State enum for the list of possible values. * * Generated from protobuf field optional string state = 109757585; @@ -105,7 +111,9 @@ public function clearState() } /** - * [Output Only] State of the secure tag, either `EFFECTIVE` or `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted or its network is deleted. + * [Output Only] State of the secure tag, either `EFFECTIVE` or + * `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted + * or its network is deleted. * Check the State enum for the list of possible values. * * Generated from protobuf field optional string state = 109757585; diff --git a/Compute/src/V1/FirewallPolicyRuleSecureTag/State.php b/Compute/src/V1/FirewallPolicyRuleSecureTag/State.php index f6a5cbaf4d7d..9f0627877ed5 100644 --- a/Compute/src/V1/FirewallPolicyRuleSecureTag/State.php +++ b/Compute/src/V1/FirewallPolicyRuleSecureTag/State.php @@ -7,7 +7,9 @@ use UnexpectedValueException; /** - * [Output Only] State of the secure tag, either `EFFECTIVE` or `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted or its network is deleted. + * [Output Only] State of the secure tag, either `EFFECTIVE` or + * `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted + * or its network is deleted. * * Protobuf type google.cloud.compute.v1.FirewallPolicyRuleSecureTag.State */ diff --git a/Compute/src/V1/FixedOrPercent.php b/Compute/src/V1/FixedOrPercent.php index 94f9e7939e6e..e27c0b675c71 100644 --- a/Compute/src/V1/FixedOrPercent.php +++ b/Compute/src/V1/FixedOrPercent.php @@ -16,7 +16,16 @@ class FixedOrPercent extends \Google\Protobuf\Internal\Message { /** - * [Output Only] Absolute value of VM instances calculated based on the specific mode. - If the value is fixed, then the calculated value is equal to the fixed value. - If the value is a percent, then the calculated value is percent/100 * targetSize. For example, the calculated value of a 80% of a managed instance group with 150 instances would be (80/100 * 150) = 120 VM instances. If there is a remainder, the number is rounded. + * [Output Only] Absolute value of VM instances calculated based on the + * specific mode. + * - If the value is fixed, then the calculated + * value is equal to the fixed value. + * - If the value is a percent, then the + * calculated + * value is percent/100 * targetSize. For example, + * the calculated value of a 80% of a managed instance group + * with 150 instances would be (80/100 * 150) = 120 VM instances. If there + * is a remainder, the number is rounded. * * Generated from protobuf field optional int32 calculated = 472082878; */ @@ -28,7 +37,8 @@ class FixedOrPercent extends \Google\Protobuf\Internal\Message */ protected $fixed = null; /** - * Specifies a percentage of instances between 0 to 100%, inclusive. For example, specify 80 for 80%. + * Specifies a percentage of instances between 0 to 100%, inclusive. For + * example, specify 80 for 80%. * * Generated from protobuf field optional int32 percent = 394814533; */ @@ -41,11 +51,21 @@ class FixedOrPercent extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type int $calculated - * [Output Only] Absolute value of VM instances calculated based on the specific mode. - If the value is fixed, then the calculated value is equal to the fixed value. - If the value is a percent, then the calculated value is percent/100 * targetSize. For example, the calculated value of a 80% of a managed instance group with 150 instances would be (80/100 * 150) = 120 VM instances. If there is a remainder, the number is rounded. + * [Output Only] Absolute value of VM instances calculated based on the + * specific mode. + * - If the value is fixed, then the calculated + * value is equal to the fixed value. + * - If the value is a percent, then the + * calculated + * value is percent/100 * targetSize. For example, + * the calculated value of a 80% of a managed instance group + * with 150 instances would be (80/100 * 150) = 120 VM instances. If there + * is a remainder, the number is rounded. * @type int $fixed * Specifies a fixed number of VM instances. This must be a positive integer. * @type int $percent - * Specifies a percentage of instances between 0 to 100%, inclusive. For example, specify 80 for 80%. + * Specifies a percentage of instances between 0 to 100%, inclusive. For + * example, specify 80 for 80%. * } */ public function __construct($data = NULL) { @@ -54,7 +74,16 @@ public function __construct($data = NULL) { } /** - * [Output Only] Absolute value of VM instances calculated based on the specific mode. - If the value is fixed, then the calculated value is equal to the fixed value. - If the value is a percent, then the calculated value is percent/100 * targetSize. For example, the calculated value of a 80% of a managed instance group with 150 instances would be (80/100 * 150) = 120 VM instances. If there is a remainder, the number is rounded. + * [Output Only] Absolute value of VM instances calculated based on the + * specific mode. + * - If the value is fixed, then the calculated + * value is equal to the fixed value. + * - If the value is a percent, then the + * calculated + * value is percent/100 * targetSize. For example, + * the calculated value of a 80% of a managed instance group + * with 150 instances would be (80/100 * 150) = 120 VM instances. If there + * is a remainder, the number is rounded. * * Generated from protobuf field optional int32 calculated = 472082878; * @return int @@ -75,7 +104,16 @@ public function clearCalculated() } /** - * [Output Only] Absolute value of VM instances calculated based on the specific mode. - If the value is fixed, then the calculated value is equal to the fixed value. - If the value is a percent, then the calculated value is percent/100 * targetSize. For example, the calculated value of a 80% of a managed instance group with 150 instances would be (80/100 * 150) = 120 VM instances. If there is a remainder, the number is rounded. + * [Output Only] Absolute value of VM instances calculated based on the + * specific mode. + * - If the value is fixed, then the calculated + * value is equal to the fixed value. + * - If the value is a percent, then the + * calculated + * value is percent/100 * targetSize. For example, + * the calculated value of a 80% of a managed instance group + * with 150 instances would be (80/100 * 150) = 120 VM instances. If there + * is a remainder, the number is rounded. * * Generated from protobuf field optional int32 calculated = 472082878; * @param int $var @@ -126,7 +164,8 @@ public function setFixed($var) } /** - * Specifies a percentage of instances between 0 to 100%, inclusive. For example, specify 80 for 80%. + * Specifies a percentage of instances between 0 to 100%, inclusive. For + * example, specify 80 for 80%. * * Generated from protobuf field optional int32 percent = 394814533; * @return int @@ -147,7 +186,8 @@ public function clearPercent() } /** - * Specifies a percentage of instances between 0 to 100%, inclusive. For example, specify 80 for 80%. + * Specifies a percentage of instances between 0 to 100%, inclusive. For + * example, specify 80 for 80%. * * Generated from protobuf field optional int32 percent = 394814533; * @param int $var diff --git a/Compute/src/V1/ForwardingRule.php b/Compute/src/V1/ForwardingRule.php index 5b46dbb9550f..bccb877ae246 100644 --- a/Compute/src/V1/ForwardingRule.php +++ b/Compute/src/V1/ForwardingRule.php @@ -9,175 +9,368 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Represents a Forwarding Rule resource. Forwarding rule resources in Google Cloud can be either regional or global in scope: * [Global](https://cloud.google.com/compute/docs/reference/rest/v1/globalForwardingRules) * [Regional](https://cloud.google.com/compute/docs/reference/rest/v1/forwardingRules) A forwarding rule and its corresponding IP address represent the frontend configuration of a Google Cloud load balancer. Forwarding rules can also reference target instances and Cloud VPN Classic gateways (targetVpnGateway). For more information, read Forwarding rule concepts and Using protocol forwarding. + * Represents a Forwarding Rule resource. + * Forwarding rule resources in Google Cloud can be either regional or global in + * scope: + * * [Global](https://cloud.google.com/compute/docs/reference/rest/v1/globalForwardingRules) + * * [Regional](https://cloud.google.com/compute/docs/reference/rest/v1/forwardingRules) + * A forwarding rule and its corresponding IP address represent the frontend + * configuration of a Google Cloud load balancer. + * Forwarding rules can also reference target instances and Cloud VPN Classic + * gateways (targetVpnGateway). + * For more information, read + * Forwarding rule concepts and + * Using protocol forwarding. * * Generated from protobuf message google.cloud.compute.v1.ForwardingRule */ class ForwardingRule extends \Google\Protobuf\Internal\Message { /** - * IP address for which this forwarding rule accepts traffic. When a client sends traffic to this IP address, the forwarding rule directs the traffic to the referenced target or backendService. While creating a forwarding rule, specifying an IPAddress is required under the following circumstances: - When the target is set to targetGrpcProxy and validateForProxyless is set to true, the IPAddress should be set to 0.0.0.0. - When the target is a Private Service Connect Google APIs bundle, you must specify an IPAddress. Otherwise, you can optionally specify an IP address that references an existing static (reserved) IP address resource. When omitted, Google Cloud assigns an ephemeral IP address. Use one of the following formats to specify an IP address while creating a forwarding rule: * IP address number, as in `100.1.2.3` * IPv6 address range, as in `2600:1234::/96` * Full resource URL, as in https://www.googleapis.com/compute/v1/projects/ project_id/regions/region/addresses/address-name * Partial URL or by name, as in: - projects/project_id/regions/region/addresses/address-name - regions/region/addresses/address-name - global/addresses/address-name - address-name The forwarding rule's target or backendService, and in most cases, also the loadBalancingScheme, determine the type of IP address that you can use. For detailed information, see [IP address specifications](https://cloud.google.com/load-balancing/docs/forwarding-rule-concepts#ip_address_specifications). When reading an IPAddress, the API always returns the IP address number. + * IP address for which this forwarding rule accepts traffic. When a client + * sends traffic to this IP address, the forwarding rule directs the traffic + * to the referenced target or backendService. + * While creating a forwarding rule, specifying an IPAddress is + * required under the following circumstances: + * - When the target is set to targetGrpcProxy andvalidateForProxyless is set to true, theIPAddress should be set to 0.0.0.0. + * - When the target is a Private Service Connect Google APIs + * bundle, you must specify an IPAddress. + * Otherwise, you can optionally specify an IP address that references an + * existing static (reserved) IP address resource. When omitted, Google Cloud + * assigns an ephemeral IP address. + * Use one of the following formats to specify an IP address while creating a + * forwarding rule: + * * IP address number, as in `100.1.2.3` + * * IPv6 address range, as in `2600:1234::/96` + * * Full resource URL, as inhttps://www.googleapis.com/compute/v1/projects/project_id/regions/region/addresses/address-name + * * Partial URL or by name, as in: + * - projects/project_id/regions/region/addresses/address-name + * - regions/region/addresses/address-name + * - global/addresses/address-name + * - address-name + * The forwarding rule's target or backendService, + * and in most cases, also the loadBalancingScheme, determine the + * type of IP address that you can use. For detailed information, see + * [IP address + * specifications](https://cloud.google.com/load-balancing/docs/forwarding-rule-concepts#ip_address_specifications). + * When reading an IPAddress, the API always returns the IP + * address number. * * Generated from protobuf field optional string I_p_address = 42976943; */ protected $I_p_address = null; /** - * The IP protocol to which this rule applies. For protocol forwarding, valid options are TCP, UDP, ESP, AH, SCTP, ICMP and L3_DEFAULT. The valid IP protocols are different for different load balancing products as described in [Load balancing features](https://cloud.google.com/load-balancing/docs/features#protocols_from_the_load_balancer_to_the_backends). + * The IP protocol to which this rule applies. + * For protocol forwarding, valid + * options are TCP, UDP, ESP,AH, SCTP, ICMP andL3_DEFAULT. + * The valid IP protocols are different for different load balancing products + * as described in [Load balancing + * features](https://cloud.google.com/load-balancing/docs/features#protocols_from_the_load_balancer_to_the_backends). * Check the IPProtocolEnum enum for the list of possible values. * * Generated from protobuf field optional string I_p_protocol = 488094525; */ protected $I_p_protocol = null; /** - * The ports, portRange, and allPorts fields are mutually exclusive. Only packets addressed to ports in the specified range will be forwarded to the backends configured with this forwarding rule. The allPorts field has the following limitations: - It requires that the forwarding rule IPProtocol be TCP, UDP, SCTP, or L3_DEFAULT. - It's applicable only to the following products: internal passthrough Network Load Balancers, backend service-based external passthrough Network Load Balancers, and internal and external protocol forwarding. - Set this field to true to allow packets addressed to any port or packets lacking destination port information (for example, UDP fragments after the first fragment) to be forwarded to the backends configured with this forwarding rule. The L3_DEFAULT protocol requires allPorts be set to true. + * The ports, portRange, and allPorts + * fields are mutually exclusive. Only packets addressed to ports in the + * specified range will be forwarded to the backends configured with this + * forwarding rule. + * The allPorts field has the following limitations: + * - It requires that the forwarding rule IPProtocol be TCP, + * UDP, SCTP, or L3_DEFAULT. + * - It's applicable only to the following products: internal passthrough + * Network Load Balancers, backend service-based external passthrough Network + * Load Balancers, and internal and external protocol forwarding. + * - Set this field to true to allow packets addressed to any port or + * packets lacking destination port information (for example, UDP fragments + * after the first fragment) to be forwarded to the backends configured with + * this forwarding rule. The L3_DEFAULT protocol requiresallPorts be set to true. * * Generated from protobuf field optional bool all_ports = 445175796; */ protected $all_ports = null; /** - * If set to true, clients can access the internal passthrough Network Load Balancers, the regional internal Application Load Balancer, and the regional internal proxy Network Load Balancer from all regions. If false, only allows access from the local region the load balancer is located at. Note that for INTERNAL_MANAGED forwarding rules, this field cannot be changed after the forwarding rule is created. + * If set to true, clients can access the internal passthrough Network Load + * Balancers, the regional internal Application Load Balancer, and the + * regional internal proxy Network Load Balancer from all regions. + * If false, only allows access from the local region the load balancer is + * located at. Note that for INTERNAL_MANAGED forwarding rules, this field + * cannot be changed after the forwarding rule is created. * * Generated from protobuf field optional bool allow_global_access = 499409674; */ protected $allow_global_access = null; /** - * This is used in PSC consumer ForwardingRule to control whether the PSC endpoint can be accessed from another region. + * This is used in PSC consumer ForwardingRule to control whether the PSC + * endpoint can be accessed from another region. * * Generated from protobuf field optional bool allow_psc_global_access = 263471819; */ protected $allow_psc_global_access = null; /** - * Identifies the backend service to which the forwarding rule sends traffic. Required for internal and external passthrough Network Load Balancers; must be omitted for all other load balancer types. + * Identifies the backend service to which the forwarding rule sends traffic. + * Required for internal and external passthrough Network Load Balancers; + * must be omitted for all other load balancer types. * * Generated from protobuf field optional string backend_service = 306946058; */ protected $backend_service = null; /** - * [Output Only] The URL for the corresponding base forwarding rule. By base forwarding rule, we mean the forwarding rule that has the same IP address, protocol, and port settings with the current forwarding rule, but without sourceIPRanges specified. Always empty if the current forwarding rule does not have sourceIPRanges specified. + * [Output Only] The URL for the corresponding base forwarding rule. By base + * forwarding rule, we mean the forwarding rule that has the same IP address, + * protocol, and port settings with the current forwarding rule, but without + * sourceIPRanges specified. + * Always empty if the current forwarding rule does not have sourceIPRanges + * specified. * * Generated from protobuf field optional string base_forwarding_rule = 524873104; */ protected $base_forwarding_rule = null; /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; */ protected $creation_timestamp = null; /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; */ protected $description = null; /** - * Specifies the canary migration state for the backend buckets attached to this forwarding rule. Possible values are PREPARE, TEST_BY_PERCENTAGE, and TEST_ALL_TRAFFIC. To begin the migration from EXTERNAL to EXTERNAL_MANAGED, the state must be changed to PREPARE. The state must be changed to TEST_ALL_TRAFFIC before the loadBalancingScheme can be changed to EXTERNAL_MANAGED. Optionally, the TEST_BY_PERCENTAGE state can be used to migrate traffic to backend buckets attached to this forwarding rule by percentage using externalManagedBackendBucketMigrationTestingPercentage. Rolling back a migration requires the states to be set in reverse order. So changing the scheme from EXTERNAL_MANAGED to EXTERNAL requires the state to be set to TEST_ALL_TRAFFIC at the same time. Optionally, the TEST_BY_PERCENTAGE state can be used to migrate some traffic back to EXTERNAL or PREPARE can be used to migrate all traffic back to EXTERNAL. + * Specifies the canary migration state for the backend buckets attached to + * this forwarding rule. Possible values are PREPARE, TEST_BY_PERCENTAGE, and + * TEST_ALL_TRAFFIC. + * To begin the migration from EXTERNAL to EXTERNAL_MANAGED, the state must be + * changed to PREPARE. The state must be changed to TEST_ALL_TRAFFIC before + * the loadBalancingScheme can be changed to EXTERNAL_MANAGED. Optionally, the + * TEST_BY_PERCENTAGE state can be used to migrate traffic to backend buckets + * attached to this forwarding rule by percentage using + * externalManagedBackendBucketMigrationTestingPercentage. + * Rolling back a migration requires the states to be set in reverse order. So + * changing the scheme from EXTERNAL_MANAGED to EXTERNAL requires the state to + * be set to TEST_ALL_TRAFFIC at the same time. Optionally, the + * TEST_BY_PERCENTAGE state can be used to migrate some traffic back to + * EXTERNAL or PREPARE can be used to migrate all traffic back to EXTERNAL. * Check the ExternalManagedBackendBucketMigrationState enum for the list of possible values. * * Generated from protobuf field optional string external_managed_backend_bucket_migration_state = 107811370; */ protected $external_managed_backend_bucket_migration_state = null; /** - * Determines the fraction of requests to backend buckets that should be processed by the global external Application Load Balancer. The value of this field must be in the range [0, 100]. This value can only be set if the loadBalancingScheme in the BackendService is set to EXTERNAL (when using the classic Application Load Balancer) and the migration state is TEST_BY_PERCENTAGE. + * Determines the fraction of requests to backend buckets that should be + * processed by the global external Application Load Balancer. + * The value of this field must be in the range [0, 100]. + * This value can only be set if the loadBalancingScheme in the BackendService + * is set to EXTERNAL (when using the classic Application Load Balancer) and + * the migration state is TEST_BY_PERCENTAGE. * * Generated from protobuf field optional float external_managed_backend_bucket_migration_testing_percentage = 105676592; */ protected $external_managed_backend_bucket_migration_testing_percentage = null; /** - * Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking. This field will be ignored when inserting a ForwardingRule. Include the fingerprint in patch request to ensure that you do not overwrite changes that were applied from another concurrent request. To see the latest fingerprint, make a get() request to retrieve a ForwardingRule. + * Fingerprint of this resource. A hash of the contents stored in this object. + * This field is used in optimistic locking. This field will be ignored when + * inserting a ForwardingRule. Include the fingerprint in patch request to + * ensure that you do not overwrite changes that were applied from another + * concurrent request. + * To see the latest fingerprint, make a get() request to + * retrieve a ForwardingRule. * * Generated from protobuf field optional string fingerprint = 234678500; */ protected $fingerprint = null; /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; */ protected $id = null; /** - * Resource reference of a PublicDelegatedPrefix. The PDP must be a sub-PDP in EXTERNAL_IPV6_FORWARDING_RULE_CREATION mode. Use one of the following formats to specify a sub-PDP when creating an IPv6 NetLB forwarding rule using BYOIP: Full resource URL, as in https://www.googleapis.com/compute/v1/projects/project_id/regions/region /publicDelegatedPrefixes/sub-pdp-name Partial URL, as in: - projects/project_id/regions/region/publicDelegatedPrefixes/sub-pdp-name - regions/region/publicDelegatedPrefixes/sub-pdp-name + * Resource reference of a PublicDelegatedPrefix. The PDP must + * be a sub-PDP in EXTERNAL_IPV6_FORWARDING_RULE_CREATION mode. + * Use one of the following formats to specify a sub-PDP when creating an IPv6 + * NetLB forwarding rule using BYOIP: + * Full resource URL, as inhttps://www.googleapis.com/compute/v1/projects/project_id/regions/region/publicDelegatedPrefixes/sub-pdp-name + * Partial URL, as in: + * - projects/project_id/regions/region/publicDelegatedPrefixes/sub-pdp-name + * - regions/region/publicDelegatedPrefixes/sub-pdp-name * * Generated from protobuf field optional string ip_collection = 176818358; */ protected $ip_collection = null; /** - * The IP Version that will be used by this forwarding rule. Valid options are IPV4 or IPV6. + * The IP Version that will be used by this forwarding rule. Valid options + * are IPV4 or IPV6. * Check the IpVersion enum for the list of possible values. * * Generated from protobuf field optional string ip_version = 294959552; */ protected $ip_version = null; /** - * Indicates whether or not this load balancer can be used as a collector for packet mirroring. To prevent mirroring loops, instances behind this load balancer will not have their traffic mirrored even if a PacketMirroring rule applies to them. This can only be set to true for load balancers that have their loadBalancingScheme set to INTERNAL. + * Indicates whether or not this load balancer can be used as a collector for + * packet mirroring. To prevent mirroring loops, instances behind this + * load balancer will not have their traffic mirrored even if aPacketMirroring rule applies to them. + * This can only be set to true for load balancers that have theirloadBalancingScheme set to INTERNAL. * * Generated from protobuf field optional bool is_mirroring_collector = 119255164; */ protected $is_mirroring_collector = null; /** - * [Output Only] Type of the resource. Always compute#forwardingRule for forwarding rule resources. + * [Output Only] Type of the resource. Alwayscompute#forwardingRule for forwarding rule resources. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * A fingerprint for the labels being applied to this resource, which is essentially a hash of the labels set used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a ForwardingRule. + * A fingerprint for the labels being applied to this resource, which is + * essentially a hash of the labels set used for optimistic locking. The + * fingerprint is initially generated by Compute Engine and changes after + * every request to modify or update labels. You must always provide an + * up-to-date fingerprint hash in order to update or change labels, + * otherwise the request will fail with error412 conditionNotMet. + * To see the latest fingerprint, make a get() request to + * retrieve a ForwardingRule. * * Generated from protobuf field optional string label_fingerprint = 178124825; */ protected $label_fingerprint = null; /** - * Labels for this resource. These can only be added or modified by the setLabels method. Each label key/value pair must comply with RFC1035. Label values may be empty. + * Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035. + * Label values may be empty. * * Generated from protobuf field map labels = 500195327; */ private $labels; /** - * Specifies the forwarding rule type. For more information about forwarding rules, refer to Forwarding rule concepts. + * Specifies the forwarding rule type. + * For more information about forwarding rules, refer to + * Forwarding rule concepts. * Check the LoadBalancingScheme enum for the list of possible values. * * Generated from protobuf field optional string load_balancing_scheme = 363890244; */ protected $load_balancing_scheme = null; /** - * Opaque filter criteria used by load balancer to restrict routing configuration to a limited set of xDS compliant clients. In their xDS requests to load balancer, xDS clients present node metadata. When there is a match, the relevant configuration is made available to those proxies. Otherwise, all the resources (e.g. TargetHttpProxy, UrlMap) referenced by the ForwardingRule are not visible to those proxies. For each metadataFilter in this list, if its filterMatchCriteria is set to MATCH_ANY, at least one of the filterLabels must match the corresponding label provided in the metadata. If its filterMatchCriteria is set to MATCH_ALL, then all of its filterLabels must match with corresponding labels provided in the metadata. If multiple metadataFilters are specified, all of them need to be satisfied in order to be considered a match. metadataFilters specified here will be applifed before those specified in the UrlMap that this ForwardingRule references. metadataFilters only applies to Loadbalancers that have their loadBalancingScheme set to INTERNAL_SELF_MANAGED. + * Opaque filter criteria used by load balancer to restrict routing + * configuration to a limited set of xDS + * compliant clients. In their xDS requests to load balancer, xDS clients + * present node + * metadata. When there is a match, the relevant configuration + * is made available to those proxies. Otherwise, all the resources (e.g.TargetHttpProxy, UrlMap) + * referenced by the ForwardingRule are not visible to + * those proxies. + * For each metadataFilter in this list, if itsfilterMatchCriteria is set to MATCH_ANY, at least one of thefilterLabels must match the corresponding label provided in + * the metadata. If its filterMatchCriteria is set to + * MATCH_ALL, then all of its filterLabels must match with + * corresponding labels provided in the metadata. If multiplemetadataFilters are specified, all of them need to be satisfied + * in order to be considered a match. + * metadataFilters specified here will be applifed before + * those specified in the UrlMap that thisForwardingRule references. + * metadataFilters only applies to Loadbalancers that have + * their loadBalancingScheme set toINTERNAL_SELF_MANAGED. * * Generated from protobuf field repeated .google.cloud.compute.v1.MetadataFilter metadata_filters = 464725739; */ private $metadata_filters; /** - * Name of the resource; provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. For Private Service Connect forwarding rules that forward traffic to Google APIs, the forwarding rule name must be a 1-20 characters string with lowercase letters and numbers and must start with a letter. + * Name of the resource; provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. + * For Private Service Connect forwarding rules that forward traffic to Google + * APIs, the forwarding rule name must be a 1-20 characters string with + * lowercase letters and numbers and must start with a letter. * * Generated from protobuf field optional string name = 3373707; */ protected $name = null; /** - * This field is not used for global external load balancing. For internal passthrough Network Load Balancers, this field identifies the network that the load balanced IP should belong to for this forwarding rule. If the subnetwork is specified, the network of the subnetwork will be used. If neither subnetwork nor this field is specified, the default network will be used. For Private Service Connect forwarding rules that forward traffic to Google APIs, a network must be provided. + * This field is not used for global external load balancing. + * For internal passthrough Network Load Balancers, this field identifies the + * network that the load balanced IP should belong to for this forwarding + * rule. + * If the subnetwork is specified, the network of the subnetwork will be used. + * If neither subnetwork nor this field is specified, the default network will + * be used. + * For Private Service Connect forwarding rules that forward traffic to Google + * APIs, a network must be provided. * * Generated from protobuf field optional string network = 232872494; */ protected $network = null; /** - * This signifies the networking tier used for configuring this load balancer and can only take the following values: PREMIUM, STANDARD. For regional ForwardingRule, the valid values are PREMIUM and STANDARD. For GlobalForwardingRule, the valid value is PREMIUM. If this field is not specified, it is assumed to be PREMIUM. If IPAddress is specified, this value must be equal to the networkTier of the Address. + * This signifies the networking tier used for configuring + * this load balancer and can only take the following values:PREMIUM, STANDARD. + * For regional ForwardingRule, the valid values are PREMIUM andSTANDARD. For GlobalForwardingRule, the valid value isPREMIUM. + * If this field is not specified, it is assumed to be PREMIUM. + * If IPAddress is specified, this value must be equal to the + * networkTier of the Address. * Check the NetworkTier enum for the list of possible values. * * Generated from protobuf field optional string network_tier = 517397843; */ protected $network_tier = null; /** - * This is used in PSC consumer ForwardingRule to control whether it should try to auto-generate a DNS zone or not. Non-PSC forwarding rules do not use this field. Once set, this field is not mutable. + * This is used in PSC consumer ForwardingRule to control whether it should + * try to auto-generate a DNS zone or not. Non-PSC forwarding rules do not use + * this field. Once set, this field is not mutable. * * Generated from protobuf field optional bool no_automate_dns_zone = 64546991; */ protected $no_automate_dns_zone = null; /** - * The ports, portRange, and allPorts fields are mutually exclusive. Only packets addressed to ports in the specified range will be forwarded to the backends configured with this forwarding rule. The portRange field has the following limitations: - It requires that the forwarding rule IPProtocol be TCP, UDP, or SCTP, and - It's applicable only to the following products: external passthrough Network Load Balancers, internal and external proxy Network Load Balancers, internal and external Application Load Balancers, external protocol forwarding, and Classic VPN. - Some products have restrictions on what ports can be used. See port specifications for details. For external forwarding rules, two or more forwarding rules cannot use the same [IPAddress, IPProtocol] pair, and cannot have overlapping portRanges. For internal forwarding rules within the same VPC network, two or more forwarding rules cannot use the same [IPAddress, IPProtocol] pair, and cannot have overlapping portRanges. @pattern: \\d+(?:-\\d+)? + * The ports, portRange, and allPorts + * fields are mutually exclusive. Only packets addressed to ports in the + * specified range will be forwarded to the backends configured with this + * forwarding rule. + * The portRange field has the following limitations: + * - It requires that the forwarding rule IPProtocol be TCP, + * UDP, or SCTP, and + * - It's applicable only to the following products: external passthrough + * Network Load Balancers, internal and external proxy Network Load Balancers, + * internal and external Application Load Balancers, external protocol + * forwarding, and Classic VPN. + * - Some products have restrictions on what ports can be used. See + * port specifications for details. + * For external forwarding rules, two or more forwarding rules cannot use the + * same [IPAddress, IPProtocol] pair, and cannot have overlappingportRanges. + * For internal forwarding rules within the same VPC network, two or more + * forwarding rules cannot use the same [IPAddress, IPProtocol] + * pair, and cannot have overlapping portRanges. + * @pattern: \\d+(?:-\\d+)? * * Generated from protobuf field optional string port_range = 217518079; */ protected $port_range = null; /** - * The ports, portRange, and allPorts fields are mutually exclusive. Only packets addressed to ports in the specified range will be forwarded to the backends configured with this forwarding rule. The ports field has the following limitations: - It requires that the forwarding rule IPProtocol be TCP, UDP, or SCTP, and - It's applicable only to the following products: internal passthrough Network Load Balancers, backend service-based external passthrough Network Load Balancers, and internal protocol forwarding. - You can specify a list of up to five ports by number, separated by commas. The ports can be contiguous or discontiguous. For external forwarding rules, two or more forwarding rules cannot use the same [IPAddress, IPProtocol] pair if they share at least one port number. For internal forwarding rules within the same VPC network, two or more forwarding rules cannot use the same [IPAddress, IPProtocol] pair if they share at least one port number. @pattern: \\d+(?:-\\d+)? + * The ports, portRange, and allPorts + * fields are mutually exclusive. Only packets addressed to ports in the + * specified range will be forwarded to the backends configured with this + * forwarding rule. + * The ports field has the following limitations: + * - It requires that the forwarding rule IPProtocol be TCP, + * UDP, or SCTP, and + * - It's applicable only to the following products: internal passthrough + * Network Load Balancers, backend service-based external passthrough Network + * Load Balancers, and internal protocol forwarding. + * - You can specify a list of up to five ports by number, separated by + * commas. The ports can be contiguous or discontiguous. + * For external forwarding rules, two or more forwarding rules cannot use the + * same [IPAddress, IPProtocol] pair if they share at least one + * port number. + * For internal forwarding rules within the same VPC network, two or more + * forwarding rules cannot use the same [IPAddress, IPProtocol] + * pair if they share at least one port number. + * @pattern: \\d+(?:-\\d+)? * * Generated from protobuf field repeated string ports = 106854418; */ @@ -196,7 +389,10 @@ class ForwardingRule extends \Google\Protobuf\Internal\Message */ protected $psc_connection_status = null; /** - * [Output Only] URL of the region where the regional forwarding rule resides. This field is not applicable to global forwarding rules. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * [Output Only] URL of the region where the regional forwarding rule resides. + * This field is not applicable to global forwarding rules. + * You must specify this field as part of the HTTP request URL. It is + * not settable as a field in the request body. * * Generated from protobuf field optional string region = 138946292; */ @@ -214,37 +410,68 @@ class ForwardingRule extends \Google\Protobuf\Internal\Message */ protected $self_link_with_id = null; /** - * Service Directory resources to register this forwarding rule with. Currently, only supports a single Service Directory resource. + * Service Directory resources to register this forwarding rule with. + * Currently, only supports a single Service Directory resource. * * Generated from protobuf field repeated .google.cloud.compute.v1.ForwardingRuleServiceDirectoryRegistration service_directory_registrations = 223549694; */ private $service_directory_registrations; /** - * An optional prefix to the service name for this forwarding rule. If specified, the prefix is the first label of the fully qualified service name. The label must be 1-63 characters long, and comply with RFC1035. Specifically, the label must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. This field is only used for internal load balancing. + * An optional prefix to the service name for this forwarding rule. + * If specified, the prefix is the first label of the fully qualified service + * name. + * The label must be 1-63 characters long, and comply withRFC1035. + * Specifically, the label must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. + * This field is only used for internal load balancing. * * Generated from protobuf field optional string service_label = 417008874; */ protected $service_label = null; /** - * [Output Only] The internal fully qualified service name for this forwarding rule. This field is only used for internal load balancing. + * [Output Only] + * The internal fully qualified service name for this forwarding rule. + * This field is only used for internal load balancing. * * Generated from protobuf field optional string service_name = 359880149; */ protected $service_name = null; /** - * If not empty, this forwarding rule will only forward the traffic when the source IP address matches one of the IP addresses or CIDR ranges set here. Note that a forwarding rule can only have up to 64 source IP ranges, and this field can only be used with a regional forwarding rule whose scheme is EXTERNAL. Each source_ip_range entry should be either an IP address (for example, 1.2.3.4) or a CIDR range (for example, 1.2.3.0/24). + * If not empty, this forwarding rule will only forward the traffic when the + * source IP address matches one of the IP addresses or CIDR ranges set here. + * Note that a forwarding rule can only have up to 64 source IP ranges, and + * this field can only be used with a regional forwarding rule whose scheme isEXTERNAL. + * Each source_ip_range entry should be either an IP address (for + * example, 1.2.3.4) or a CIDR range (for example, 1.2.3.0/24). * * Generated from protobuf field repeated string source_ip_ranges = 111563210; */ private $source_ip_ranges; /** - * This field identifies the subnetwork that the load balanced IP should belong to for this forwarding rule, used with internal load balancers and external passthrough Network Load Balancers with IPv6. If the network specified is in auto subnet mode, this field is optional. However, a subnetwork must be specified if the network is in custom subnet mode or when creating external forwarding rule with IPv6. + * This field identifies the subnetwork that the load balanced IP should + * belong to for this forwarding rule, used with internal load balancers and + * external passthrough Network Load Balancers with IPv6. + * If the network specified is in auto subnet mode, this field is optional. + * However, a subnetwork must be specified if the network is in custom subnet + * mode or when creating external forwarding rule with IPv6. * * Generated from protobuf field optional string subnetwork = 307827694; */ protected $subnetwork = null; /** - * The URL of the target resource to receive the matched traffic. For regional forwarding rules, this target must be in the same region as the forwarding rule. For global forwarding rules, this target must be a global load balancing resource. The forwarded traffic must be of a type appropriate to the target object. - For load balancers, see the "Target" column in [Port specifications](https://cloud.google.com/load-balancing/docs/forwarding-rule-concepts#ip_address_specifications). - For Private Service Connect forwarding rules that forward traffic to Google APIs, provide the name of a supported Google API bundle: - vpc-sc - APIs that support VPC Service Controls. - all-apis - All supported Google APIs. - For Private Service Connect forwarding rules that forward traffic to managed services, the target must be a service attachment. The target is not mutable once set as a service attachment. + * The URL of the target resource to receive the matched traffic. For + * regional forwarding rules, this target must be in the same region as the + * forwarding rule. For global forwarding rules, this target must be a global + * load balancing resource. + * The forwarded traffic must be of a type appropriate to the target object. + * - For load balancers, see the "Target" column in [Port specifications](https://cloud.google.com/load-balancing/docs/forwarding-rule-concepts#ip_address_specifications). + * - For Private Service Connect forwarding rules that forward traffic to Google APIs, provide the name of a supported Google API bundle: + * - vpc-sc - APIs that support VPC Service Controls. + * - all-apis - All supported Google APIs. + * - For Private Service Connect forwarding rules that forward traffic to managed services, the target must be a service attachment. The target is not mutable once set as a service attachment. * * Generated from protobuf field optional string target = 192835985; */ @@ -257,87 +484,303 @@ class ForwardingRule extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $I_p_address - * IP address for which this forwarding rule accepts traffic. When a client sends traffic to this IP address, the forwarding rule directs the traffic to the referenced target or backendService. While creating a forwarding rule, specifying an IPAddress is required under the following circumstances: - When the target is set to targetGrpcProxy and validateForProxyless is set to true, the IPAddress should be set to 0.0.0.0. - When the target is a Private Service Connect Google APIs bundle, you must specify an IPAddress. Otherwise, you can optionally specify an IP address that references an existing static (reserved) IP address resource. When omitted, Google Cloud assigns an ephemeral IP address. Use one of the following formats to specify an IP address while creating a forwarding rule: * IP address number, as in `100.1.2.3` * IPv6 address range, as in `2600:1234::/96` * Full resource URL, as in https://www.googleapis.com/compute/v1/projects/ project_id/regions/region/addresses/address-name * Partial URL or by name, as in: - projects/project_id/regions/region/addresses/address-name - regions/region/addresses/address-name - global/addresses/address-name - address-name The forwarding rule's target or backendService, and in most cases, also the loadBalancingScheme, determine the type of IP address that you can use. For detailed information, see [IP address specifications](https://cloud.google.com/load-balancing/docs/forwarding-rule-concepts#ip_address_specifications). When reading an IPAddress, the API always returns the IP address number. + * IP address for which this forwarding rule accepts traffic. When a client + * sends traffic to this IP address, the forwarding rule directs the traffic + * to the referenced target or backendService. + * While creating a forwarding rule, specifying an IPAddress is + * required under the following circumstances: + * - When the target is set to targetGrpcProxy andvalidateForProxyless is set to true, theIPAddress should be set to 0.0.0.0. + * - When the target is a Private Service Connect Google APIs + * bundle, you must specify an IPAddress. + * Otherwise, you can optionally specify an IP address that references an + * existing static (reserved) IP address resource. When omitted, Google Cloud + * assigns an ephemeral IP address. + * Use one of the following formats to specify an IP address while creating a + * forwarding rule: + * * IP address number, as in `100.1.2.3` + * * IPv6 address range, as in `2600:1234::/96` + * * Full resource URL, as inhttps://www.googleapis.com/compute/v1/projects/project_id/regions/region/addresses/address-name + * * Partial URL or by name, as in: + * - projects/project_id/regions/region/addresses/address-name + * - regions/region/addresses/address-name + * - global/addresses/address-name + * - address-name + * The forwarding rule's target or backendService, + * and in most cases, also the loadBalancingScheme, determine the + * type of IP address that you can use. For detailed information, see + * [IP address + * specifications](https://cloud.google.com/load-balancing/docs/forwarding-rule-concepts#ip_address_specifications). + * When reading an IPAddress, the API always returns the IP + * address number. * @type string $I_p_protocol - * The IP protocol to which this rule applies. For protocol forwarding, valid options are TCP, UDP, ESP, AH, SCTP, ICMP and L3_DEFAULT. The valid IP protocols are different for different load balancing products as described in [Load balancing features](https://cloud.google.com/load-balancing/docs/features#protocols_from_the_load_balancer_to_the_backends). + * The IP protocol to which this rule applies. + * For protocol forwarding, valid + * options are TCP, UDP, ESP,AH, SCTP, ICMP andL3_DEFAULT. + * The valid IP protocols are different for different load balancing products + * as described in [Load balancing + * features](https://cloud.google.com/load-balancing/docs/features#protocols_from_the_load_balancer_to_the_backends). * Check the IPProtocolEnum enum for the list of possible values. * @type bool $all_ports - * The ports, portRange, and allPorts fields are mutually exclusive. Only packets addressed to ports in the specified range will be forwarded to the backends configured with this forwarding rule. The allPorts field has the following limitations: - It requires that the forwarding rule IPProtocol be TCP, UDP, SCTP, or L3_DEFAULT. - It's applicable only to the following products: internal passthrough Network Load Balancers, backend service-based external passthrough Network Load Balancers, and internal and external protocol forwarding. - Set this field to true to allow packets addressed to any port or packets lacking destination port information (for example, UDP fragments after the first fragment) to be forwarded to the backends configured with this forwarding rule. The L3_DEFAULT protocol requires allPorts be set to true. + * The ports, portRange, and allPorts + * fields are mutually exclusive. Only packets addressed to ports in the + * specified range will be forwarded to the backends configured with this + * forwarding rule. + * The allPorts field has the following limitations: + * - It requires that the forwarding rule IPProtocol be TCP, + * UDP, SCTP, or L3_DEFAULT. + * - It's applicable only to the following products: internal passthrough + * Network Load Balancers, backend service-based external passthrough Network + * Load Balancers, and internal and external protocol forwarding. + * - Set this field to true to allow packets addressed to any port or + * packets lacking destination port information (for example, UDP fragments + * after the first fragment) to be forwarded to the backends configured with + * this forwarding rule. The L3_DEFAULT protocol requiresallPorts be set to true. * @type bool $allow_global_access - * If set to true, clients can access the internal passthrough Network Load Balancers, the regional internal Application Load Balancer, and the regional internal proxy Network Load Balancer from all regions. If false, only allows access from the local region the load balancer is located at. Note that for INTERNAL_MANAGED forwarding rules, this field cannot be changed after the forwarding rule is created. + * If set to true, clients can access the internal passthrough Network Load + * Balancers, the regional internal Application Load Balancer, and the + * regional internal proxy Network Load Balancer from all regions. + * If false, only allows access from the local region the load balancer is + * located at. Note that for INTERNAL_MANAGED forwarding rules, this field + * cannot be changed after the forwarding rule is created. * @type bool $allow_psc_global_access - * This is used in PSC consumer ForwardingRule to control whether the PSC endpoint can be accessed from another region. + * This is used in PSC consumer ForwardingRule to control whether the PSC + * endpoint can be accessed from another region. * @type string $backend_service - * Identifies the backend service to which the forwarding rule sends traffic. Required for internal and external passthrough Network Load Balancers; must be omitted for all other load balancer types. + * Identifies the backend service to which the forwarding rule sends traffic. + * Required for internal and external passthrough Network Load Balancers; + * must be omitted for all other load balancer types. * @type string $base_forwarding_rule - * [Output Only] The URL for the corresponding base forwarding rule. By base forwarding rule, we mean the forwarding rule that has the same IP address, protocol, and port settings with the current forwarding rule, but without sourceIPRanges specified. Always empty if the current forwarding rule does not have sourceIPRanges specified. + * [Output Only] The URL for the corresponding base forwarding rule. By base + * forwarding rule, we mean the forwarding rule that has the same IP address, + * protocol, and port settings with the current forwarding rule, but without + * sourceIPRanges specified. + * Always empty if the current forwarding rule does not have sourceIPRanges + * specified. * @type string $creation_timestamp - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * @type string $description - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * @type string $external_managed_backend_bucket_migration_state - * Specifies the canary migration state for the backend buckets attached to this forwarding rule. Possible values are PREPARE, TEST_BY_PERCENTAGE, and TEST_ALL_TRAFFIC. To begin the migration from EXTERNAL to EXTERNAL_MANAGED, the state must be changed to PREPARE. The state must be changed to TEST_ALL_TRAFFIC before the loadBalancingScheme can be changed to EXTERNAL_MANAGED. Optionally, the TEST_BY_PERCENTAGE state can be used to migrate traffic to backend buckets attached to this forwarding rule by percentage using externalManagedBackendBucketMigrationTestingPercentage. Rolling back a migration requires the states to be set in reverse order. So changing the scheme from EXTERNAL_MANAGED to EXTERNAL requires the state to be set to TEST_ALL_TRAFFIC at the same time. Optionally, the TEST_BY_PERCENTAGE state can be used to migrate some traffic back to EXTERNAL or PREPARE can be used to migrate all traffic back to EXTERNAL. + * Specifies the canary migration state for the backend buckets attached to + * this forwarding rule. Possible values are PREPARE, TEST_BY_PERCENTAGE, and + * TEST_ALL_TRAFFIC. + * To begin the migration from EXTERNAL to EXTERNAL_MANAGED, the state must be + * changed to PREPARE. The state must be changed to TEST_ALL_TRAFFIC before + * the loadBalancingScheme can be changed to EXTERNAL_MANAGED. Optionally, the + * TEST_BY_PERCENTAGE state can be used to migrate traffic to backend buckets + * attached to this forwarding rule by percentage using + * externalManagedBackendBucketMigrationTestingPercentage. + * Rolling back a migration requires the states to be set in reverse order. So + * changing the scheme from EXTERNAL_MANAGED to EXTERNAL requires the state to + * be set to TEST_ALL_TRAFFIC at the same time. Optionally, the + * TEST_BY_PERCENTAGE state can be used to migrate some traffic back to + * EXTERNAL or PREPARE can be used to migrate all traffic back to EXTERNAL. * Check the ExternalManagedBackendBucketMigrationState enum for the list of possible values. * @type float $external_managed_backend_bucket_migration_testing_percentage - * Determines the fraction of requests to backend buckets that should be processed by the global external Application Load Balancer. The value of this field must be in the range [0, 100]. This value can only be set if the loadBalancingScheme in the BackendService is set to EXTERNAL (when using the classic Application Load Balancer) and the migration state is TEST_BY_PERCENTAGE. + * Determines the fraction of requests to backend buckets that should be + * processed by the global external Application Load Balancer. + * The value of this field must be in the range [0, 100]. + * This value can only be set if the loadBalancingScheme in the BackendService + * is set to EXTERNAL (when using the classic Application Load Balancer) and + * the migration state is TEST_BY_PERCENTAGE. * @type string $fingerprint - * Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking. This field will be ignored when inserting a ForwardingRule. Include the fingerprint in patch request to ensure that you do not overwrite changes that were applied from another concurrent request. To see the latest fingerprint, make a get() request to retrieve a ForwardingRule. + * Fingerprint of this resource. A hash of the contents stored in this object. + * This field is used in optimistic locking. This field will be ignored when + * inserting a ForwardingRule. Include the fingerprint in patch request to + * ensure that you do not overwrite changes that were applied from another + * concurrent request. + * To see the latest fingerprint, make a get() request to + * retrieve a ForwardingRule. * @type int|string $id - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * @type string $ip_collection - * Resource reference of a PublicDelegatedPrefix. The PDP must be a sub-PDP in EXTERNAL_IPV6_FORWARDING_RULE_CREATION mode. Use one of the following formats to specify a sub-PDP when creating an IPv6 NetLB forwarding rule using BYOIP: Full resource URL, as in https://www.googleapis.com/compute/v1/projects/project_id/regions/region /publicDelegatedPrefixes/sub-pdp-name Partial URL, as in: - projects/project_id/regions/region/publicDelegatedPrefixes/sub-pdp-name - regions/region/publicDelegatedPrefixes/sub-pdp-name + * Resource reference of a PublicDelegatedPrefix. The PDP must + * be a sub-PDP in EXTERNAL_IPV6_FORWARDING_RULE_CREATION mode. + * Use one of the following formats to specify a sub-PDP when creating an IPv6 + * NetLB forwarding rule using BYOIP: + * Full resource URL, as inhttps://www.googleapis.com/compute/v1/projects/project_id/regions/region/publicDelegatedPrefixes/sub-pdp-name + * Partial URL, as in: + * - projects/project_id/regions/region/publicDelegatedPrefixes/sub-pdp-name + * - regions/region/publicDelegatedPrefixes/sub-pdp-name * @type string $ip_version - * The IP Version that will be used by this forwarding rule. Valid options are IPV4 or IPV6. + * The IP Version that will be used by this forwarding rule. Valid options + * are IPV4 or IPV6. * Check the IpVersion enum for the list of possible values. * @type bool $is_mirroring_collector - * Indicates whether or not this load balancer can be used as a collector for packet mirroring. To prevent mirroring loops, instances behind this load balancer will not have their traffic mirrored even if a PacketMirroring rule applies to them. This can only be set to true for load balancers that have their loadBalancingScheme set to INTERNAL. + * Indicates whether or not this load balancer can be used as a collector for + * packet mirroring. To prevent mirroring loops, instances behind this + * load balancer will not have their traffic mirrored even if aPacketMirroring rule applies to them. + * This can only be set to true for load balancers that have theirloadBalancingScheme set to INTERNAL. * @type string $kind - * [Output Only] Type of the resource. Always compute#forwardingRule for forwarding rule resources. + * [Output Only] Type of the resource. Alwayscompute#forwardingRule for forwarding rule resources. * @type string $label_fingerprint - * A fingerprint for the labels being applied to this resource, which is essentially a hash of the labels set used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a ForwardingRule. + * A fingerprint for the labels being applied to this resource, which is + * essentially a hash of the labels set used for optimistic locking. The + * fingerprint is initially generated by Compute Engine and changes after + * every request to modify or update labels. You must always provide an + * up-to-date fingerprint hash in order to update or change labels, + * otherwise the request will fail with error412 conditionNotMet. + * To see the latest fingerprint, make a get() request to + * retrieve a ForwardingRule. * @type array|\Google\Protobuf\Internal\MapField $labels - * Labels for this resource. These can only be added or modified by the setLabels method. Each label key/value pair must comply with RFC1035. Label values may be empty. + * Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035. + * Label values may be empty. * @type string $load_balancing_scheme - * Specifies the forwarding rule type. For more information about forwarding rules, refer to Forwarding rule concepts. + * Specifies the forwarding rule type. + * For more information about forwarding rules, refer to + * Forwarding rule concepts. * Check the LoadBalancingScheme enum for the list of possible values. * @type array<\Google\Cloud\Compute\V1\MetadataFilter>|\Google\Protobuf\Internal\RepeatedField $metadata_filters - * Opaque filter criteria used by load balancer to restrict routing configuration to a limited set of xDS compliant clients. In their xDS requests to load balancer, xDS clients present node metadata. When there is a match, the relevant configuration is made available to those proxies. Otherwise, all the resources (e.g. TargetHttpProxy, UrlMap) referenced by the ForwardingRule are not visible to those proxies. For each metadataFilter in this list, if its filterMatchCriteria is set to MATCH_ANY, at least one of the filterLabels must match the corresponding label provided in the metadata. If its filterMatchCriteria is set to MATCH_ALL, then all of its filterLabels must match with corresponding labels provided in the metadata. If multiple metadataFilters are specified, all of them need to be satisfied in order to be considered a match. metadataFilters specified here will be applifed before those specified in the UrlMap that this ForwardingRule references. metadataFilters only applies to Loadbalancers that have their loadBalancingScheme set to INTERNAL_SELF_MANAGED. + * Opaque filter criteria used by load balancer to restrict routing + * configuration to a limited set of xDS + * compliant clients. In their xDS requests to load balancer, xDS clients + * present node + * metadata. When there is a match, the relevant configuration + * is made available to those proxies. Otherwise, all the resources (e.g.TargetHttpProxy, UrlMap) + * referenced by the ForwardingRule are not visible to + * those proxies. + * For each metadataFilter in this list, if itsfilterMatchCriteria is set to MATCH_ANY, at least one of thefilterLabels must match the corresponding label provided in + * the metadata. If its filterMatchCriteria is set to + * MATCH_ALL, then all of its filterLabels must match with + * corresponding labels provided in the metadata. If multiplemetadataFilters are specified, all of them need to be satisfied + * in order to be considered a match. + * metadataFilters specified here will be applifed before + * those specified in the UrlMap that thisForwardingRule references. + * metadataFilters only applies to Loadbalancers that have + * their loadBalancingScheme set toINTERNAL_SELF_MANAGED. * @type string $name - * Name of the resource; provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. For Private Service Connect forwarding rules that forward traffic to Google APIs, the forwarding rule name must be a 1-20 characters string with lowercase letters and numbers and must start with a letter. + * Name of the resource; provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. + * For Private Service Connect forwarding rules that forward traffic to Google + * APIs, the forwarding rule name must be a 1-20 characters string with + * lowercase letters and numbers and must start with a letter. * @type string $network - * This field is not used for global external load balancing. For internal passthrough Network Load Balancers, this field identifies the network that the load balanced IP should belong to for this forwarding rule. If the subnetwork is specified, the network of the subnetwork will be used. If neither subnetwork nor this field is specified, the default network will be used. For Private Service Connect forwarding rules that forward traffic to Google APIs, a network must be provided. + * This field is not used for global external load balancing. + * For internal passthrough Network Load Balancers, this field identifies the + * network that the load balanced IP should belong to for this forwarding + * rule. + * If the subnetwork is specified, the network of the subnetwork will be used. + * If neither subnetwork nor this field is specified, the default network will + * be used. + * For Private Service Connect forwarding rules that forward traffic to Google + * APIs, a network must be provided. * @type string $network_tier - * This signifies the networking tier used for configuring this load balancer and can only take the following values: PREMIUM, STANDARD. For regional ForwardingRule, the valid values are PREMIUM and STANDARD. For GlobalForwardingRule, the valid value is PREMIUM. If this field is not specified, it is assumed to be PREMIUM. If IPAddress is specified, this value must be equal to the networkTier of the Address. + * This signifies the networking tier used for configuring + * this load balancer and can only take the following values:PREMIUM, STANDARD. + * For regional ForwardingRule, the valid values are PREMIUM andSTANDARD. For GlobalForwardingRule, the valid value isPREMIUM. + * If this field is not specified, it is assumed to be PREMIUM. + * If IPAddress is specified, this value must be equal to the + * networkTier of the Address. * Check the NetworkTier enum for the list of possible values. * @type bool $no_automate_dns_zone - * This is used in PSC consumer ForwardingRule to control whether it should try to auto-generate a DNS zone or not. Non-PSC forwarding rules do not use this field. Once set, this field is not mutable. + * This is used in PSC consumer ForwardingRule to control whether it should + * try to auto-generate a DNS zone or not. Non-PSC forwarding rules do not use + * this field. Once set, this field is not mutable. * @type string $port_range - * The ports, portRange, and allPorts fields are mutually exclusive. Only packets addressed to ports in the specified range will be forwarded to the backends configured with this forwarding rule. The portRange field has the following limitations: - It requires that the forwarding rule IPProtocol be TCP, UDP, or SCTP, and - It's applicable only to the following products: external passthrough Network Load Balancers, internal and external proxy Network Load Balancers, internal and external Application Load Balancers, external protocol forwarding, and Classic VPN. - Some products have restrictions on what ports can be used. See port specifications for details. For external forwarding rules, two or more forwarding rules cannot use the same [IPAddress, IPProtocol] pair, and cannot have overlapping portRanges. For internal forwarding rules within the same VPC network, two or more forwarding rules cannot use the same [IPAddress, IPProtocol] pair, and cannot have overlapping portRanges. @pattern: \\d+(?:-\\d+)? + * The ports, portRange, and allPorts + * fields are mutually exclusive. Only packets addressed to ports in the + * specified range will be forwarded to the backends configured with this + * forwarding rule. + * The portRange field has the following limitations: + * - It requires that the forwarding rule IPProtocol be TCP, + * UDP, or SCTP, and + * - It's applicable only to the following products: external passthrough + * Network Load Balancers, internal and external proxy Network Load Balancers, + * internal and external Application Load Balancers, external protocol + * forwarding, and Classic VPN. + * - Some products have restrictions on what ports can be used. See + * port specifications for details. + * For external forwarding rules, two or more forwarding rules cannot use the + * same [IPAddress, IPProtocol] pair, and cannot have overlappingportRanges. + * For internal forwarding rules within the same VPC network, two or more + * forwarding rules cannot use the same [IPAddress, IPProtocol] + * pair, and cannot have overlapping portRanges. + * @pattern: \\d+(?:-\\d+)? * @type array|\Google\Protobuf\Internal\RepeatedField $ports - * The ports, portRange, and allPorts fields are mutually exclusive. Only packets addressed to ports in the specified range will be forwarded to the backends configured with this forwarding rule. The ports field has the following limitations: - It requires that the forwarding rule IPProtocol be TCP, UDP, or SCTP, and - It's applicable only to the following products: internal passthrough Network Load Balancers, backend service-based external passthrough Network Load Balancers, and internal protocol forwarding. - You can specify a list of up to five ports by number, separated by commas. The ports can be contiguous or discontiguous. For external forwarding rules, two or more forwarding rules cannot use the same [IPAddress, IPProtocol] pair if they share at least one port number. For internal forwarding rules within the same VPC network, two or more forwarding rules cannot use the same [IPAddress, IPProtocol] pair if they share at least one port number. @pattern: \\d+(?:-\\d+)? + * The ports, portRange, and allPorts + * fields are mutually exclusive. Only packets addressed to ports in the + * specified range will be forwarded to the backends configured with this + * forwarding rule. + * The ports field has the following limitations: + * - It requires that the forwarding rule IPProtocol be TCP, + * UDP, or SCTP, and + * - It's applicable only to the following products: internal passthrough + * Network Load Balancers, backend service-based external passthrough Network + * Load Balancers, and internal protocol forwarding. + * - You can specify a list of up to five ports by number, separated by + * commas. The ports can be contiguous or discontiguous. + * For external forwarding rules, two or more forwarding rules cannot use the + * same [IPAddress, IPProtocol] pair if they share at least one + * port number. + * For internal forwarding rules within the same VPC network, two or more + * forwarding rules cannot use the same [IPAddress, IPProtocol] + * pair if they share at least one port number. + * @pattern: \\d+(?:-\\d+)? * @type int|string $psc_connection_id * [Output Only] The PSC connection id of the PSC forwarding rule. * @type string $psc_connection_status * * Check the PscConnectionStatus enum for the list of possible values. * @type string $region - * [Output Only] URL of the region where the regional forwarding rule resides. This field is not applicable to global forwarding rules. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * [Output Only] URL of the region where the regional forwarding rule resides. + * This field is not applicable to global forwarding rules. + * You must specify this field as part of the HTTP request URL. It is + * not settable as a field in the request body. * @type string $self_link * [Output Only] Server-defined URL for the resource. * @type string $self_link_with_id * [Output Only] Server-defined URL for this resource with the resource id. * @type array<\Google\Cloud\Compute\V1\ForwardingRuleServiceDirectoryRegistration>|\Google\Protobuf\Internal\RepeatedField $service_directory_registrations - * Service Directory resources to register this forwarding rule with. Currently, only supports a single Service Directory resource. + * Service Directory resources to register this forwarding rule with. + * Currently, only supports a single Service Directory resource. * @type string $service_label - * An optional prefix to the service name for this forwarding rule. If specified, the prefix is the first label of the fully qualified service name. The label must be 1-63 characters long, and comply with RFC1035. Specifically, the label must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. This field is only used for internal load balancing. + * An optional prefix to the service name for this forwarding rule. + * If specified, the prefix is the first label of the fully qualified service + * name. + * The label must be 1-63 characters long, and comply withRFC1035. + * Specifically, the label must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. + * This field is only used for internal load balancing. * @type string $service_name - * [Output Only] The internal fully qualified service name for this forwarding rule. This field is only used for internal load balancing. + * [Output Only] + * The internal fully qualified service name for this forwarding rule. + * This field is only used for internal load balancing. * @type array|\Google\Protobuf\Internal\RepeatedField $source_ip_ranges - * If not empty, this forwarding rule will only forward the traffic when the source IP address matches one of the IP addresses or CIDR ranges set here. Note that a forwarding rule can only have up to 64 source IP ranges, and this field can only be used with a regional forwarding rule whose scheme is EXTERNAL. Each source_ip_range entry should be either an IP address (for example, 1.2.3.4) or a CIDR range (for example, 1.2.3.0/24). + * If not empty, this forwarding rule will only forward the traffic when the + * source IP address matches one of the IP addresses or CIDR ranges set here. + * Note that a forwarding rule can only have up to 64 source IP ranges, and + * this field can only be used with a regional forwarding rule whose scheme isEXTERNAL. + * Each source_ip_range entry should be either an IP address (for + * example, 1.2.3.4) or a CIDR range (for example, 1.2.3.0/24). * @type string $subnetwork - * This field identifies the subnetwork that the load balanced IP should belong to for this forwarding rule, used with internal load balancers and external passthrough Network Load Balancers with IPv6. If the network specified is in auto subnet mode, this field is optional. However, a subnetwork must be specified if the network is in custom subnet mode or when creating external forwarding rule with IPv6. + * This field identifies the subnetwork that the load balanced IP should + * belong to for this forwarding rule, used with internal load balancers and + * external passthrough Network Load Balancers with IPv6. + * If the network specified is in auto subnet mode, this field is optional. + * However, a subnetwork must be specified if the network is in custom subnet + * mode or when creating external forwarding rule with IPv6. * @type string $target - * The URL of the target resource to receive the matched traffic. For regional forwarding rules, this target must be in the same region as the forwarding rule. For global forwarding rules, this target must be a global load balancing resource. The forwarded traffic must be of a type appropriate to the target object. - For load balancers, see the "Target" column in [Port specifications](https://cloud.google.com/load-balancing/docs/forwarding-rule-concepts#ip_address_specifications). - For Private Service Connect forwarding rules that forward traffic to Google APIs, provide the name of a supported Google API bundle: - vpc-sc - APIs that support VPC Service Controls. - all-apis - All supported Google APIs. - For Private Service Connect forwarding rules that forward traffic to managed services, the target must be a service attachment. The target is not mutable once set as a service attachment. + * The URL of the target resource to receive the matched traffic. For + * regional forwarding rules, this target must be in the same region as the + * forwarding rule. For global forwarding rules, this target must be a global + * load balancing resource. + * The forwarded traffic must be of a type appropriate to the target object. + * - For load balancers, see the "Target" column in [Port specifications](https://cloud.google.com/load-balancing/docs/forwarding-rule-concepts#ip_address_specifications). + * - For Private Service Connect forwarding rules that forward traffic to Google APIs, provide the name of a supported Google API bundle: + * - vpc-sc - APIs that support VPC Service Controls. + * - all-apis - All supported Google APIs. + * - For Private Service Connect forwarding rules that forward traffic to managed services, the target must be a service attachment. The target is not mutable once set as a service attachment. * } */ public function __construct($data = NULL) { @@ -346,7 +789,34 @@ public function __construct($data = NULL) { } /** - * IP address for which this forwarding rule accepts traffic. When a client sends traffic to this IP address, the forwarding rule directs the traffic to the referenced target or backendService. While creating a forwarding rule, specifying an IPAddress is required under the following circumstances: - When the target is set to targetGrpcProxy and validateForProxyless is set to true, the IPAddress should be set to 0.0.0.0. - When the target is a Private Service Connect Google APIs bundle, you must specify an IPAddress. Otherwise, you can optionally specify an IP address that references an existing static (reserved) IP address resource. When omitted, Google Cloud assigns an ephemeral IP address. Use one of the following formats to specify an IP address while creating a forwarding rule: * IP address number, as in `100.1.2.3` * IPv6 address range, as in `2600:1234::/96` * Full resource URL, as in https://www.googleapis.com/compute/v1/projects/ project_id/regions/region/addresses/address-name * Partial URL or by name, as in: - projects/project_id/regions/region/addresses/address-name - regions/region/addresses/address-name - global/addresses/address-name - address-name The forwarding rule's target or backendService, and in most cases, also the loadBalancingScheme, determine the type of IP address that you can use. For detailed information, see [IP address specifications](https://cloud.google.com/load-balancing/docs/forwarding-rule-concepts#ip_address_specifications). When reading an IPAddress, the API always returns the IP address number. + * IP address for which this forwarding rule accepts traffic. When a client + * sends traffic to this IP address, the forwarding rule directs the traffic + * to the referenced target or backendService. + * While creating a forwarding rule, specifying an IPAddress is + * required under the following circumstances: + * - When the target is set to targetGrpcProxy andvalidateForProxyless is set to true, theIPAddress should be set to 0.0.0.0. + * - When the target is a Private Service Connect Google APIs + * bundle, you must specify an IPAddress. + * Otherwise, you can optionally specify an IP address that references an + * existing static (reserved) IP address resource. When omitted, Google Cloud + * assigns an ephemeral IP address. + * Use one of the following formats to specify an IP address while creating a + * forwarding rule: + * * IP address number, as in `100.1.2.3` + * * IPv6 address range, as in `2600:1234::/96` + * * Full resource URL, as inhttps://www.googleapis.com/compute/v1/projects/project_id/regions/region/addresses/address-name + * * Partial URL or by name, as in: + * - projects/project_id/regions/region/addresses/address-name + * - regions/region/addresses/address-name + * - global/addresses/address-name + * - address-name + * The forwarding rule's target or backendService, + * and in most cases, also the loadBalancingScheme, determine the + * type of IP address that you can use. For detailed information, see + * [IP address + * specifications](https://cloud.google.com/load-balancing/docs/forwarding-rule-concepts#ip_address_specifications). + * When reading an IPAddress, the API always returns the IP + * address number. * * Generated from protobuf field optional string I_p_address = 42976943; * @return string @@ -367,7 +837,34 @@ public function clearIPAddress() } /** - * IP address for which this forwarding rule accepts traffic. When a client sends traffic to this IP address, the forwarding rule directs the traffic to the referenced target or backendService. While creating a forwarding rule, specifying an IPAddress is required under the following circumstances: - When the target is set to targetGrpcProxy and validateForProxyless is set to true, the IPAddress should be set to 0.0.0.0. - When the target is a Private Service Connect Google APIs bundle, you must specify an IPAddress. Otherwise, you can optionally specify an IP address that references an existing static (reserved) IP address resource. When omitted, Google Cloud assigns an ephemeral IP address. Use one of the following formats to specify an IP address while creating a forwarding rule: * IP address number, as in `100.1.2.3` * IPv6 address range, as in `2600:1234::/96` * Full resource URL, as in https://www.googleapis.com/compute/v1/projects/ project_id/regions/region/addresses/address-name * Partial URL or by name, as in: - projects/project_id/regions/region/addresses/address-name - regions/region/addresses/address-name - global/addresses/address-name - address-name The forwarding rule's target or backendService, and in most cases, also the loadBalancingScheme, determine the type of IP address that you can use. For detailed information, see [IP address specifications](https://cloud.google.com/load-balancing/docs/forwarding-rule-concepts#ip_address_specifications). When reading an IPAddress, the API always returns the IP address number. + * IP address for which this forwarding rule accepts traffic. When a client + * sends traffic to this IP address, the forwarding rule directs the traffic + * to the referenced target or backendService. + * While creating a forwarding rule, specifying an IPAddress is + * required under the following circumstances: + * - When the target is set to targetGrpcProxy andvalidateForProxyless is set to true, theIPAddress should be set to 0.0.0.0. + * - When the target is a Private Service Connect Google APIs + * bundle, you must specify an IPAddress. + * Otherwise, you can optionally specify an IP address that references an + * existing static (reserved) IP address resource. When omitted, Google Cloud + * assigns an ephemeral IP address. + * Use one of the following formats to specify an IP address while creating a + * forwarding rule: + * * IP address number, as in `100.1.2.3` + * * IPv6 address range, as in `2600:1234::/96` + * * Full resource URL, as inhttps://www.googleapis.com/compute/v1/projects/project_id/regions/region/addresses/address-name + * * Partial URL or by name, as in: + * - projects/project_id/regions/region/addresses/address-name + * - regions/region/addresses/address-name + * - global/addresses/address-name + * - address-name + * The forwarding rule's target or backendService, + * and in most cases, also the loadBalancingScheme, determine the + * type of IP address that you can use. For detailed information, see + * [IP address + * specifications](https://cloud.google.com/load-balancing/docs/forwarding-rule-concepts#ip_address_specifications). + * When reading an IPAddress, the API always returns the IP + * address number. * * Generated from protobuf field optional string I_p_address = 42976943; * @param string $var @@ -382,7 +879,12 @@ public function setIPAddress($var) } /** - * The IP protocol to which this rule applies. For protocol forwarding, valid options are TCP, UDP, ESP, AH, SCTP, ICMP and L3_DEFAULT. The valid IP protocols are different for different load balancing products as described in [Load balancing features](https://cloud.google.com/load-balancing/docs/features#protocols_from_the_load_balancer_to_the_backends). + * The IP protocol to which this rule applies. + * For protocol forwarding, valid + * options are TCP, UDP, ESP,AH, SCTP, ICMP andL3_DEFAULT. + * The valid IP protocols are different for different load balancing products + * as described in [Load balancing + * features](https://cloud.google.com/load-balancing/docs/features#protocols_from_the_load_balancer_to_the_backends). * Check the IPProtocolEnum enum for the list of possible values. * * Generated from protobuf field optional string I_p_protocol = 488094525; @@ -404,7 +906,12 @@ public function clearIPProtocol() } /** - * The IP protocol to which this rule applies. For protocol forwarding, valid options are TCP, UDP, ESP, AH, SCTP, ICMP and L3_DEFAULT. The valid IP protocols are different for different load balancing products as described in [Load balancing features](https://cloud.google.com/load-balancing/docs/features#protocols_from_the_load_balancer_to_the_backends). + * The IP protocol to which this rule applies. + * For protocol forwarding, valid + * options are TCP, UDP, ESP,AH, SCTP, ICMP andL3_DEFAULT. + * The valid IP protocols are different for different load balancing products + * as described in [Load balancing + * features](https://cloud.google.com/load-balancing/docs/features#protocols_from_the_load_balancer_to_the_backends). * Check the IPProtocolEnum enum for the list of possible values. * * Generated from protobuf field optional string I_p_protocol = 488094525; @@ -420,7 +927,20 @@ public function setIPProtocol($var) } /** - * The ports, portRange, and allPorts fields are mutually exclusive. Only packets addressed to ports in the specified range will be forwarded to the backends configured with this forwarding rule. The allPorts field has the following limitations: - It requires that the forwarding rule IPProtocol be TCP, UDP, SCTP, or L3_DEFAULT. - It's applicable only to the following products: internal passthrough Network Load Balancers, backend service-based external passthrough Network Load Balancers, and internal and external protocol forwarding. - Set this field to true to allow packets addressed to any port or packets lacking destination port information (for example, UDP fragments after the first fragment) to be forwarded to the backends configured with this forwarding rule. The L3_DEFAULT protocol requires allPorts be set to true. + * The ports, portRange, and allPorts + * fields are mutually exclusive. Only packets addressed to ports in the + * specified range will be forwarded to the backends configured with this + * forwarding rule. + * The allPorts field has the following limitations: + * - It requires that the forwarding rule IPProtocol be TCP, + * UDP, SCTP, or L3_DEFAULT. + * - It's applicable only to the following products: internal passthrough + * Network Load Balancers, backend service-based external passthrough Network + * Load Balancers, and internal and external protocol forwarding. + * - Set this field to true to allow packets addressed to any port or + * packets lacking destination port information (for example, UDP fragments + * after the first fragment) to be forwarded to the backends configured with + * this forwarding rule. The L3_DEFAULT protocol requiresallPorts be set to true. * * Generated from protobuf field optional bool all_ports = 445175796; * @return bool @@ -441,7 +961,20 @@ public function clearAllPorts() } /** - * The ports, portRange, and allPorts fields are mutually exclusive. Only packets addressed to ports in the specified range will be forwarded to the backends configured with this forwarding rule. The allPorts field has the following limitations: - It requires that the forwarding rule IPProtocol be TCP, UDP, SCTP, or L3_DEFAULT. - It's applicable only to the following products: internal passthrough Network Load Balancers, backend service-based external passthrough Network Load Balancers, and internal and external protocol forwarding. - Set this field to true to allow packets addressed to any port or packets lacking destination port information (for example, UDP fragments after the first fragment) to be forwarded to the backends configured with this forwarding rule. The L3_DEFAULT protocol requires allPorts be set to true. + * The ports, portRange, and allPorts + * fields are mutually exclusive. Only packets addressed to ports in the + * specified range will be forwarded to the backends configured with this + * forwarding rule. + * The allPorts field has the following limitations: + * - It requires that the forwarding rule IPProtocol be TCP, + * UDP, SCTP, or L3_DEFAULT. + * - It's applicable only to the following products: internal passthrough + * Network Load Balancers, backend service-based external passthrough Network + * Load Balancers, and internal and external protocol forwarding. + * - Set this field to true to allow packets addressed to any port or + * packets lacking destination port information (for example, UDP fragments + * after the first fragment) to be forwarded to the backends configured with + * this forwarding rule. The L3_DEFAULT protocol requiresallPorts be set to true. * * Generated from protobuf field optional bool all_ports = 445175796; * @param bool $var @@ -456,7 +989,12 @@ public function setAllPorts($var) } /** - * If set to true, clients can access the internal passthrough Network Load Balancers, the regional internal Application Load Balancer, and the regional internal proxy Network Load Balancer from all regions. If false, only allows access from the local region the load balancer is located at. Note that for INTERNAL_MANAGED forwarding rules, this field cannot be changed after the forwarding rule is created. + * If set to true, clients can access the internal passthrough Network Load + * Balancers, the regional internal Application Load Balancer, and the + * regional internal proxy Network Load Balancer from all regions. + * If false, only allows access from the local region the load balancer is + * located at. Note that for INTERNAL_MANAGED forwarding rules, this field + * cannot be changed after the forwarding rule is created. * * Generated from protobuf field optional bool allow_global_access = 499409674; * @return bool @@ -477,7 +1015,12 @@ public function clearAllowGlobalAccess() } /** - * If set to true, clients can access the internal passthrough Network Load Balancers, the regional internal Application Load Balancer, and the regional internal proxy Network Load Balancer from all regions. If false, only allows access from the local region the load balancer is located at. Note that for INTERNAL_MANAGED forwarding rules, this field cannot be changed after the forwarding rule is created. + * If set to true, clients can access the internal passthrough Network Load + * Balancers, the regional internal Application Load Balancer, and the + * regional internal proxy Network Load Balancer from all regions. + * If false, only allows access from the local region the load balancer is + * located at. Note that for INTERNAL_MANAGED forwarding rules, this field + * cannot be changed after the forwarding rule is created. * * Generated from protobuf field optional bool allow_global_access = 499409674; * @param bool $var @@ -492,7 +1035,8 @@ public function setAllowGlobalAccess($var) } /** - * This is used in PSC consumer ForwardingRule to control whether the PSC endpoint can be accessed from another region. + * This is used in PSC consumer ForwardingRule to control whether the PSC + * endpoint can be accessed from another region. * * Generated from protobuf field optional bool allow_psc_global_access = 263471819; * @return bool @@ -513,7 +1057,8 @@ public function clearAllowPscGlobalAccess() } /** - * This is used in PSC consumer ForwardingRule to control whether the PSC endpoint can be accessed from another region. + * This is used in PSC consumer ForwardingRule to control whether the PSC + * endpoint can be accessed from another region. * * Generated from protobuf field optional bool allow_psc_global_access = 263471819; * @param bool $var @@ -528,7 +1073,9 @@ public function setAllowPscGlobalAccess($var) } /** - * Identifies the backend service to which the forwarding rule sends traffic. Required for internal and external passthrough Network Load Balancers; must be omitted for all other load balancer types. + * Identifies the backend service to which the forwarding rule sends traffic. + * Required for internal and external passthrough Network Load Balancers; + * must be omitted for all other load balancer types. * * Generated from protobuf field optional string backend_service = 306946058; * @return string @@ -549,7 +1096,9 @@ public function clearBackendService() } /** - * Identifies the backend service to which the forwarding rule sends traffic. Required for internal and external passthrough Network Load Balancers; must be omitted for all other load balancer types. + * Identifies the backend service to which the forwarding rule sends traffic. + * Required for internal and external passthrough Network Load Balancers; + * must be omitted for all other load balancer types. * * Generated from protobuf field optional string backend_service = 306946058; * @param string $var @@ -564,7 +1113,12 @@ public function setBackendService($var) } /** - * [Output Only] The URL for the corresponding base forwarding rule. By base forwarding rule, we mean the forwarding rule that has the same IP address, protocol, and port settings with the current forwarding rule, but without sourceIPRanges specified. Always empty if the current forwarding rule does not have sourceIPRanges specified. + * [Output Only] The URL for the corresponding base forwarding rule. By base + * forwarding rule, we mean the forwarding rule that has the same IP address, + * protocol, and port settings with the current forwarding rule, but without + * sourceIPRanges specified. + * Always empty if the current forwarding rule does not have sourceIPRanges + * specified. * * Generated from protobuf field optional string base_forwarding_rule = 524873104; * @return string @@ -585,7 +1139,12 @@ public function clearBaseForwardingRule() } /** - * [Output Only] The URL for the corresponding base forwarding rule. By base forwarding rule, we mean the forwarding rule that has the same IP address, protocol, and port settings with the current forwarding rule, but without sourceIPRanges specified. Always empty if the current forwarding rule does not have sourceIPRanges specified. + * [Output Only] The URL for the corresponding base forwarding rule. By base + * forwarding rule, we mean the forwarding rule that has the same IP address, + * protocol, and port settings with the current forwarding rule, but without + * sourceIPRanges specified. + * Always empty if the current forwarding rule does not have sourceIPRanges + * specified. * * Generated from protobuf field optional string base_forwarding_rule = 524873104; * @param string $var @@ -600,7 +1159,8 @@ public function setBaseForwardingRule($var) } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @return string @@ -621,7 +1181,8 @@ public function clearCreationTimestamp() } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @param string $var @@ -636,7 +1197,8 @@ public function setCreationTimestamp($var) } /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @return string @@ -657,7 +1219,8 @@ public function clearDescription() } /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @param string $var @@ -672,7 +1235,20 @@ public function setDescription($var) } /** - * Specifies the canary migration state for the backend buckets attached to this forwarding rule. Possible values are PREPARE, TEST_BY_PERCENTAGE, and TEST_ALL_TRAFFIC. To begin the migration from EXTERNAL to EXTERNAL_MANAGED, the state must be changed to PREPARE. The state must be changed to TEST_ALL_TRAFFIC before the loadBalancingScheme can be changed to EXTERNAL_MANAGED. Optionally, the TEST_BY_PERCENTAGE state can be used to migrate traffic to backend buckets attached to this forwarding rule by percentage using externalManagedBackendBucketMigrationTestingPercentage. Rolling back a migration requires the states to be set in reverse order. So changing the scheme from EXTERNAL_MANAGED to EXTERNAL requires the state to be set to TEST_ALL_TRAFFIC at the same time. Optionally, the TEST_BY_PERCENTAGE state can be used to migrate some traffic back to EXTERNAL or PREPARE can be used to migrate all traffic back to EXTERNAL. + * Specifies the canary migration state for the backend buckets attached to + * this forwarding rule. Possible values are PREPARE, TEST_BY_PERCENTAGE, and + * TEST_ALL_TRAFFIC. + * To begin the migration from EXTERNAL to EXTERNAL_MANAGED, the state must be + * changed to PREPARE. The state must be changed to TEST_ALL_TRAFFIC before + * the loadBalancingScheme can be changed to EXTERNAL_MANAGED. Optionally, the + * TEST_BY_PERCENTAGE state can be used to migrate traffic to backend buckets + * attached to this forwarding rule by percentage using + * externalManagedBackendBucketMigrationTestingPercentage. + * Rolling back a migration requires the states to be set in reverse order. So + * changing the scheme from EXTERNAL_MANAGED to EXTERNAL requires the state to + * be set to TEST_ALL_TRAFFIC at the same time. Optionally, the + * TEST_BY_PERCENTAGE state can be used to migrate some traffic back to + * EXTERNAL or PREPARE can be used to migrate all traffic back to EXTERNAL. * Check the ExternalManagedBackendBucketMigrationState enum for the list of possible values. * * Generated from protobuf field optional string external_managed_backend_bucket_migration_state = 107811370; @@ -694,7 +1270,20 @@ public function clearExternalManagedBackendBucketMigrationState() } /** - * Specifies the canary migration state for the backend buckets attached to this forwarding rule. Possible values are PREPARE, TEST_BY_PERCENTAGE, and TEST_ALL_TRAFFIC. To begin the migration from EXTERNAL to EXTERNAL_MANAGED, the state must be changed to PREPARE. The state must be changed to TEST_ALL_TRAFFIC before the loadBalancingScheme can be changed to EXTERNAL_MANAGED. Optionally, the TEST_BY_PERCENTAGE state can be used to migrate traffic to backend buckets attached to this forwarding rule by percentage using externalManagedBackendBucketMigrationTestingPercentage. Rolling back a migration requires the states to be set in reverse order. So changing the scheme from EXTERNAL_MANAGED to EXTERNAL requires the state to be set to TEST_ALL_TRAFFIC at the same time. Optionally, the TEST_BY_PERCENTAGE state can be used to migrate some traffic back to EXTERNAL or PREPARE can be used to migrate all traffic back to EXTERNAL. + * Specifies the canary migration state for the backend buckets attached to + * this forwarding rule. Possible values are PREPARE, TEST_BY_PERCENTAGE, and + * TEST_ALL_TRAFFIC. + * To begin the migration from EXTERNAL to EXTERNAL_MANAGED, the state must be + * changed to PREPARE. The state must be changed to TEST_ALL_TRAFFIC before + * the loadBalancingScheme can be changed to EXTERNAL_MANAGED. Optionally, the + * TEST_BY_PERCENTAGE state can be used to migrate traffic to backend buckets + * attached to this forwarding rule by percentage using + * externalManagedBackendBucketMigrationTestingPercentage. + * Rolling back a migration requires the states to be set in reverse order. So + * changing the scheme from EXTERNAL_MANAGED to EXTERNAL requires the state to + * be set to TEST_ALL_TRAFFIC at the same time. Optionally, the + * TEST_BY_PERCENTAGE state can be used to migrate some traffic back to + * EXTERNAL or PREPARE can be used to migrate all traffic back to EXTERNAL. * Check the ExternalManagedBackendBucketMigrationState enum for the list of possible values. * * Generated from protobuf field optional string external_managed_backend_bucket_migration_state = 107811370; @@ -710,7 +1299,12 @@ public function setExternalManagedBackendBucketMigrationState($var) } /** - * Determines the fraction of requests to backend buckets that should be processed by the global external Application Load Balancer. The value of this field must be in the range [0, 100]. This value can only be set if the loadBalancingScheme in the BackendService is set to EXTERNAL (when using the classic Application Load Balancer) and the migration state is TEST_BY_PERCENTAGE. + * Determines the fraction of requests to backend buckets that should be + * processed by the global external Application Load Balancer. + * The value of this field must be in the range [0, 100]. + * This value can only be set if the loadBalancingScheme in the BackendService + * is set to EXTERNAL (when using the classic Application Load Balancer) and + * the migration state is TEST_BY_PERCENTAGE. * * Generated from protobuf field optional float external_managed_backend_bucket_migration_testing_percentage = 105676592; * @return float @@ -731,7 +1325,12 @@ public function clearExternalManagedBackendBucketMigrationTestingPercentage() } /** - * Determines the fraction of requests to backend buckets that should be processed by the global external Application Load Balancer. The value of this field must be in the range [0, 100]. This value can only be set if the loadBalancingScheme in the BackendService is set to EXTERNAL (when using the classic Application Load Balancer) and the migration state is TEST_BY_PERCENTAGE. + * Determines the fraction of requests to backend buckets that should be + * processed by the global external Application Load Balancer. + * The value of this field must be in the range [0, 100]. + * This value can only be set if the loadBalancingScheme in the BackendService + * is set to EXTERNAL (when using the classic Application Load Balancer) and + * the migration state is TEST_BY_PERCENTAGE. * * Generated from protobuf field optional float external_managed_backend_bucket_migration_testing_percentage = 105676592; * @param float $var @@ -746,7 +1345,13 @@ public function setExternalManagedBackendBucketMigrationTestingPercentage($var) } /** - * Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking. This field will be ignored when inserting a ForwardingRule. Include the fingerprint in patch request to ensure that you do not overwrite changes that were applied from another concurrent request. To see the latest fingerprint, make a get() request to retrieve a ForwardingRule. + * Fingerprint of this resource. A hash of the contents stored in this object. + * This field is used in optimistic locking. This field will be ignored when + * inserting a ForwardingRule. Include the fingerprint in patch request to + * ensure that you do not overwrite changes that were applied from another + * concurrent request. + * To see the latest fingerprint, make a get() request to + * retrieve a ForwardingRule. * * Generated from protobuf field optional string fingerprint = 234678500; * @return string @@ -767,7 +1372,13 @@ public function clearFingerprint() } /** - * Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking. This field will be ignored when inserting a ForwardingRule. Include the fingerprint in patch request to ensure that you do not overwrite changes that were applied from another concurrent request. To see the latest fingerprint, make a get() request to retrieve a ForwardingRule. + * Fingerprint of this resource. A hash of the contents stored in this object. + * This field is used in optimistic locking. This field will be ignored when + * inserting a ForwardingRule. Include the fingerprint in patch request to + * ensure that you do not overwrite changes that were applied from another + * concurrent request. + * To see the latest fingerprint, make a get() request to + * retrieve a ForwardingRule. * * Generated from protobuf field optional string fingerprint = 234678500; * @param string $var @@ -782,7 +1393,8 @@ public function setFingerprint($var) } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @return int|string @@ -803,7 +1415,8 @@ public function clearId() } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @param int|string $var @@ -818,7 +1431,14 @@ public function setId($var) } /** - * Resource reference of a PublicDelegatedPrefix. The PDP must be a sub-PDP in EXTERNAL_IPV6_FORWARDING_RULE_CREATION mode. Use one of the following formats to specify a sub-PDP when creating an IPv6 NetLB forwarding rule using BYOIP: Full resource URL, as in https://www.googleapis.com/compute/v1/projects/project_id/regions/region /publicDelegatedPrefixes/sub-pdp-name Partial URL, as in: - projects/project_id/regions/region/publicDelegatedPrefixes/sub-pdp-name - regions/region/publicDelegatedPrefixes/sub-pdp-name + * Resource reference of a PublicDelegatedPrefix. The PDP must + * be a sub-PDP in EXTERNAL_IPV6_FORWARDING_RULE_CREATION mode. + * Use one of the following formats to specify a sub-PDP when creating an IPv6 + * NetLB forwarding rule using BYOIP: + * Full resource URL, as inhttps://www.googleapis.com/compute/v1/projects/project_id/regions/region/publicDelegatedPrefixes/sub-pdp-name + * Partial URL, as in: + * - projects/project_id/regions/region/publicDelegatedPrefixes/sub-pdp-name + * - regions/region/publicDelegatedPrefixes/sub-pdp-name * * Generated from protobuf field optional string ip_collection = 176818358; * @return string @@ -839,7 +1459,14 @@ public function clearIpCollection() } /** - * Resource reference of a PublicDelegatedPrefix. The PDP must be a sub-PDP in EXTERNAL_IPV6_FORWARDING_RULE_CREATION mode. Use one of the following formats to specify a sub-PDP when creating an IPv6 NetLB forwarding rule using BYOIP: Full resource URL, as in https://www.googleapis.com/compute/v1/projects/project_id/regions/region /publicDelegatedPrefixes/sub-pdp-name Partial URL, as in: - projects/project_id/regions/region/publicDelegatedPrefixes/sub-pdp-name - regions/region/publicDelegatedPrefixes/sub-pdp-name + * Resource reference of a PublicDelegatedPrefix. The PDP must + * be a sub-PDP in EXTERNAL_IPV6_FORWARDING_RULE_CREATION mode. + * Use one of the following formats to specify a sub-PDP when creating an IPv6 + * NetLB forwarding rule using BYOIP: + * Full resource URL, as inhttps://www.googleapis.com/compute/v1/projects/project_id/regions/region/publicDelegatedPrefixes/sub-pdp-name + * Partial URL, as in: + * - projects/project_id/regions/region/publicDelegatedPrefixes/sub-pdp-name + * - regions/region/publicDelegatedPrefixes/sub-pdp-name * * Generated from protobuf field optional string ip_collection = 176818358; * @param string $var @@ -854,7 +1481,8 @@ public function setIpCollection($var) } /** - * The IP Version that will be used by this forwarding rule. Valid options are IPV4 or IPV6. + * The IP Version that will be used by this forwarding rule. Valid options + * are IPV4 or IPV6. * Check the IpVersion enum for the list of possible values. * * Generated from protobuf field optional string ip_version = 294959552; @@ -876,7 +1504,8 @@ public function clearIpVersion() } /** - * The IP Version that will be used by this forwarding rule. Valid options are IPV4 or IPV6. + * The IP Version that will be used by this forwarding rule. Valid options + * are IPV4 or IPV6. * Check the IpVersion enum for the list of possible values. * * Generated from protobuf field optional string ip_version = 294959552; @@ -892,7 +1521,10 @@ public function setIpVersion($var) } /** - * Indicates whether or not this load balancer can be used as a collector for packet mirroring. To prevent mirroring loops, instances behind this load balancer will not have their traffic mirrored even if a PacketMirroring rule applies to them. This can only be set to true for load balancers that have their loadBalancingScheme set to INTERNAL. + * Indicates whether or not this load balancer can be used as a collector for + * packet mirroring. To prevent mirroring loops, instances behind this + * load balancer will not have their traffic mirrored even if aPacketMirroring rule applies to them. + * This can only be set to true for load balancers that have theirloadBalancingScheme set to INTERNAL. * * Generated from protobuf field optional bool is_mirroring_collector = 119255164; * @return bool @@ -913,7 +1545,10 @@ public function clearIsMirroringCollector() } /** - * Indicates whether or not this load balancer can be used as a collector for packet mirroring. To prevent mirroring loops, instances behind this load balancer will not have their traffic mirrored even if a PacketMirroring rule applies to them. This can only be set to true for load balancers that have their loadBalancingScheme set to INTERNAL. + * Indicates whether or not this load balancer can be used as a collector for + * packet mirroring. To prevent mirroring loops, instances behind this + * load balancer will not have their traffic mirrored even if aPacketMirroring rule applies to them. + * This can only be set to true for load balancers that have theirloadBalancingScheme set to INTERNAL. * * Generated from protobuf field optional bool is_mirroring_collector = 119255164; * @param bool $var @@ -928,7 +1563,7 @@ public function setIsMirroringCollector($var) } /** - * [Output Only] Type of the resource. Always compute#forwardingRule for forwarding rule resources. + * [Output Only] Type of the resource. Alwayscompute#forwardingRule for forwarding rule resources. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -949,7 +1584,7 @@ public function clearKind() } /** - * [Output Only] Type of the resource. Always compute#forwardingRule for forwarding rule resources. + * [Output Only] Type of the resource. Alwayscompute#forwardingRule for forwarding rule resources. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -964,7 +1599,14 @@ public function setKind($var) } /** - * A fingerprint for the labels being applied to this resource, which is essentially a hash of the labels set used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a ForwardingRule. + * A fingerprint for the labels being applied to this resource, which is + * essentially a hash of the labels set used for optimistic locking. The + * fingerprint is initially generated by Compute Engine and changes after + * every request to modify or update labels. You must always provide an + * up-to-date fingerprint hash in order to update or change labels, + * otherwise the request will fail with error412 conditionNotMet. + * To see the latest fingerprint, make a get() request to + * retrieve a ForwardingRule. * * Generated from protobuf field optional string label_fingerprint = 178124825; * @return string @@ -985,7 +1627,14 @@ public function clearLabelFingerprint() } /** - * A fingerprint for the labels being applied to this resource, which is essentially a hash of the labels set used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a ForwardingRule. + * A fingerprint for the labels being applied to this resource, which is + * essentially a hash of the labels set used for optimistic locking. The + * fingerprint is initially generated by Compute Engine and changes after + * every request to modify or update labels. You must always provide an + * up-to-date fingerprint hash in order to update or change labels, + * otherwise the request will fail with error412 conditionNotMet. + * To see the latest fingerprint, make a get() request to + * retrieve a ForwardingRule. * * Generated from protobuf field optional string label_fingerprint = 178124825; * @param string $var @@ -1000,7 +1649,8 @@ public function setLabelFingerprint($var) } /** - * Labels for this resource. These can only be added or modified by the setLabels method. Each label key/value pair must comply with RFC1035. Label values may be empty. + * Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035. + * Label values may be empty. * * Generated from protobuf field map labels = 500195327; * @return \Google\Protobuf\Internal\MapField @@ -1011,7 +1661,8 @@ public function getLabels() } /** - * Labels for this resource. These can only be added or modified by the setLabels method. Each label key/value pair must comply with RFC1035. Label values may be empty. + * Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035. + * Label values may be empty. * * Generated from protobuf field map labels = 500195327; * @param array|\Google\Protobuf\Internal\MapField $var @@ -1026,7 +1677,9 @@ public function setLabels($var) } /** - * Specifies the forwarding rule type. For more information about forwarding rules, refer to Forwarding rule concepts. + * Specifies the forwarding rule type. + * For more information about forwarding rules, refer to + * Forwarding rule concepts. * Check the LoadBalancingScheme enum for the list of possible values. * * Generated from protobuf field optional string load_balancing_scheme = 363890244; @@ -1048,7 +1701,9 @@ public function clearLoadBalancingScheme() } /** - * Specifies the forwarding rule type. For more information about forwarding rules, refer to Forwarding rule concepts. + * Specifies the forwarding rule type. + * For more information about forwarding rules, refer to + * Forwarding rule concepts. * Check the LoadBalancingScheme enum for the list of possible values. * * Generated from protobuf field optional string load_balancing_scheme = 363890244; @@ -1064,7 +1719,23 @@ public function setLoadBalancingScheme($var) } /** - * Opaque filter criteria used by load balancer to restrict routing configuration to a limited set of xDS compliant clients. In their xDS requests to load balancer, xDS clients present node metadata. When there is a match, the relevant configuration is made available to those proxies. Otherwise, all the resources (e.g. TargetHttpProxy, UrlMap) referenced by the ForwardingRule are not visible to those proxies. For each metadataFilter in this list, if its filterMatchCriteria is set to MATCH_ANY, at least one of the filterLabels must match the corresponding label provided in the metadata. If its filterMatchCriteria is set to MATCH_ALL, then all of its filterLabels must match with corresponding labels provided in the metadata. If multiple metadataFilters are specified, all of them need to be satisfied in order to be considered a match. metadataFilters specified here will be applifed before those specified in the UrlMap that this ForwardingRule references. metadataFilters only applies to Loadbalancers that have their loadBalancingScheme set to INTERNAL_SELF_MANAGED. + * Opaque filter criteria used by load balancer to restrict routing + * configuration to a limited set of xDS + * compliant clients. In their xDS requests to load balancer, xDS clients + * present node + * metadata. When there is a match, the relevant configuration + * is made available to those proxies. Otherwise, all the resources (e.g.TargetHttpProxy, UrlMap) + * referenced by the ForwardingRule are not visible to + * those proxies. + * For each metadataFilter in this list, if itsfilterMatchCriteria is set to MATCH_ANY, at least one of thefilterLabels must match the corresponding label provided in + * the metadata. If its filterMatchCriteria is set to + * MATCH_ALL, then all of its filterLabels must match with + * corresponding labels provided in the metadata. If multiplemetadataFilters are specified, all of them need to be satisfied + * in order to be considered a match. + * metadataFilters specified here will be applifed before + * those specified in the UrlMap that thisForwardingRule references. + * metadataFilters only applies to Loadbalancers that have + * their loadBalancingScheme set toINTERNAL_SELF_MANAGED. * * Generated from protobuf field repeated .google.cloud.compute.v1.MetadataFilter metadata_filters = 464725739; * @return \Google\Protobuf\Internal\RepeatedField @@ -1075,7 +1746,23 @@ public function getMetadataFilters() } /** - * Opaque filter criteria used by load balancer to restrict routing configuration to a limited set of xDS compliant clients. In their xDS requests to load balancer, xDS clients present node metadata. When there is a match, the relevant configuration is made available to those proxies. Otherwise, all the resources (e.g. TargetHttpProxy, UrlMap) referenced by the ForwardingRule are not visible to those proxies. For each metadataFilter in this list, if its filterMatchCriteria is set to MATCH_ANY, at least one of the filterLabels must match the corresponding label provided in the metadata. If its filterMatchCriteria is set to MATCH_ALL, then all of its filterLabels must match with corresponding labels provided in the metadata. If multiple metadataFilters are specified, all of them need to be satisfied in order to be considered a match. metadataFilters specified here will be applifed before those specified in the UrlMap that this ForwardingRule references. metadataFilters only applies to Loadbalancers that have their loadBalancingScheme set to INTERNAL_SELF_MANAGED. + * Opaque filter criteria used by load balancer to restrict routing + * configuration to a limited set of xDS + * compliant clients. In their xDS requests to load balancer, xDS clients + * present node + * metadata. When there is a match, the relevant configuration + * is made available to those proxies. Otherwise, all the resources (e.g.TargetHttpProxy, UrlMap) + * referenced by the ForwardingRule are not visible to + * those proxies. + * For each metadataFilter in this list, if itsfilterMatchCriteria is set to MATCH_ANY, at least one of thefilterLabels must match the corresponding label provided in + * the metadata. If its filterMatchCriteria is set to + * MATCH_ALL, then all of its filterLabels must match with + * corresponding labels provided in the metadata. If multiplemetadataFilters are specified, all of them need to be satisfied + * in order to be considered a match. + * metadataFilters specified here will be applifed before + * those specified in the UrlMap that thisForwardingRule references. + * metadataFilters only applies to Loadbalancers that have + * their loadBalancingScheme set toINTERNAL_SELF_MANAGED. * * Generated from protobuf field repeated .google.cloud.compute.v1.MetadataFilter metadata_filters = 464725739; * @param array<\Google\Cloud\Compute\V1\MetadataFilter>|\Google\Protobuf\Internal\RepeatedField $var @@ -1090,7 +1777,16 @@ public function setMetadataFilters($var) } /** - * Name of the resource; provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. For Private Service Connect forwarding rules that forward traffic to Google APIs, the forwarding rule name must be a 1-20 characters string with lowercase letters and numbers and must start with a letter. + * Name of the resource; provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. + * For Private Service Connect forwarding rules that forward traffic to Google + * APIs, the forwarding rule name must be a 1-20 characters string with + * lowercase letters and numbers and must start with a letter. * * Generated from protobuf field optional string name = 3373707; * @return string @@ -1111,7 +1807,16 @@ public function clearName() } /** - * Name of the resource; provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. For Private Service Connect forwarding rules that forward traffic to Google APIs, the forwarding rule name must be a 1-20 characters string with lowercase letters and numbers and must start with a letter. + * Name of the resource; provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. + * For Private Service Connect forwarding rules that forward traffic to Google + * APIs, the forwarding rule name must be a 1-20 characters string with + * lowercase letters and numbers and must start with a letter. * * Generated from protobuf field optional string name = 3373707; * @param string $var @@ -1126,7 +1831,15 @@ public function setName($var) } /** - * This field is not used for global external load balancing. For internal passthrough Network Load Balancers, this field identifies the network that the load balanced IP should belong to for this forwarding rule. If the subnetwork is specified, the network of the subnetwork will be used. If neither subnetwork nor this field is specified, the default network will be used. For Private Service Connect forwarding rules that forward traffic to Google APIs, a network must be provided. + * This field is not used for global external load balancing. + * For internal passthrough Network Load Balancers, this field identifies the + * network that the load balanced IP should belong to for this forwarding + * rule. + * If the subnetwork is specified, the network of the subnetwork will be used. + * If neither subnetwork nor this field is specified, the default network will + * be used. + * For Private Service Connect forwarding rules that forward traffic to Google + * APIs, a network must be provided. * * Generated from protobuf field optional string network = 232872494; * @return string @@ -1147,7 +1860,15 @@ public function clearNetwork() } /** - * This field is not used for global external load balancing. For internal passthrough Network Load Balancers, this field identifies the network that the load balanced IP should belong to for this forwarding rule. If the subnetwork is specified, the network of the subnetwork will be used. If neither subnetwork nor this field is specified, the default network will be used. For Private Service Connect forwarding rules that forward traffic to Google APIs, a network must be provided. + * This field is not used for global external load balancing. + * For internal passthrough Network Load Balancers, this field identifies the + * network that the load balanced IP should belong to for this forwarding + * rule. + * If the subnetwork is specified, the network of the subnetwork will be used. + * If neither subnetwork nor this field is specified, the default network will + * be used. + * For Private Service Connect forwarding rules that forward traffic to Google + * APIs, a network must be provided. * * Generated from protobuf field optional string network = 232872494; * @param string $var @@ -1162,7 +1883,12 @@ public function setNetwork($var) } /** - * This signifies the networking tier used for configuring this load balancer and can only take the following values: PREMIUM, STANDARD. For regional ForwardingRule, the valid values are PREMIUM and STANDARD. For GlobalForwardingRule, the valid value is PREMIUM. If this field is not specified, it is assumed to be PREMIUM. If IPAddress is specified, this value must be equal to the networkTier of the Address. + * This signifies the networking tier used for configuring + * this load balancer and can only take the following values:PREMIUM, STANDARD. + * For regional ForwardingRule, the valid values are PREMIUM andSTANDARD. For GlobalForwardingRule, the valid value isPREMIUM. + * If this field is not specified, it is assumed to be PREMIUM. + * If IPAddress is specified, this value must be equal to the + * networkTier of the Address. * Check the NetworkTier enum for the list of possible values. * * Generated from protobuf field optional string network_tier = 517397843; @@ -1184,7 +1910,12 @@ public function clearNetworkTier() } /** - * This signifies the networking tier used for configuring this load balancer and can only take the following values: PREMIUM, STANDARD. For regional ForwardingRule, the valid values are PREMIUM and STANDARD. For GlobalForwardingRule, the valid value is PREMIUM. If this field is not specified, it is assumed to be PREMIUM. If IPAddress is specified, this value must be equal to the networkTier of the Address. + * This signifies the networking tier used for configuring + * this load balancer and can only take the following values:PREMIUM, STANDARD. + * For regional ForwardingRule, the valid values are PREMIUM andSTANDARD. For GlobalForwardingRule, the valid value isPREMIUM. + * If this field is not specified, it is assumed to be PREMIUM. + * If IPAddress is specified, this value must be equal to the + * networkTier of the Address. * Check the NetworkTier enum for the list of possible values. * * Generated from protobuf field optional string network_tier = 517397843; @@ -1200,7 +1931,9 @@ public function setNetworkTier($var) } /** - * This is used in PSC consumer ForwardingRule to control whether it should try to auto-generate a DNS zone or not. Non-PSC forwarding rules do not use this field. Once set, this field is not mutable. + * This is used in PSC consumer ForwardingRule to control whether it should + * try to auto-generate a DNS zone or not. Non-PSC forwarding rules do not use + * this field. Once set, this field is not mutable. * * Generated from protobuf field optional bool no_automate_dns_zone = 64546991; * @return bool @@ -1221,7 +1954,9 @@ public function clearNoAutomateDnsZone() } /** - * This is used in PSC consumer ForwardingRule to control whether it should try to auto-generate a DNS zone or not. Non-PSC forwarding rules do not use this field. Once set, this field is not mutable. + * This is used in PSC consumer ForwardingRule to control whether it should + * try to auto-generate a DNS zone or not. Non-PSC forwarding rules do not use + * this field. Once set, this field is not mutable. * * Generated from protobuf field optional bool no_automate_dns_zone = 64546991; * @param bool $var @@ -1236,7 +1971,25 @@ public function setNoAutomateDnsZone($var) } /** - * The ports, portRange, and allPorts fields are mutually exclusive. Only packets addressed to ports in the specified range will be forwarded to the backends configured with this forwarding rule. The portRange field has the following limitations: - It requires that the forwarding rule IPProtocol be TCP, UDP, or SCTP, and - It's applicable only to the following products: external passthrough Network Load Balancers, internal and external proxy Network Load Balancers, internal and external Application Load Balancers, external protocol forwarding, and Classic VPN. - Some products have restrictions on what ports can be used. See port specifications for details. For external forwarding rules, two or more forwarding rules cannot use the same [IPAddress, IPProtocol] pair, and cannot have overlapping portRanges. For internal forwarding rules within the same VPC network, two or more forwarding rules cannot use the same [IPAddress, IPProtocol] pair, and cannot have overlapping portRanges. @pattern: \\d+(?:-\\d+)? + * The ports, portRange, and allPorts + * fields are mutually exclusive. Only packets addressed to ports in the + * specified range will be forwarded to the backends configured with this + * forwarding rule. + * The portRange field has the following limitations: + * - It requires that the forwarding rule IPProtocol be TCP, + * UDP, or SCTP, and + * - It's applicable only to the following products: external passthrough + * Network Load Balancers, internal and external proxy Network Load Balancers, + * internal and external Application Load Balancers, external protocol + * forwarding, and Classic VPN. + * - Some products have restrictions on what ports can be used. See + * port specifications for details. + * For external forwarding rules, two or more forwarding rules cannot use the + * same [IPAddress, IPProtocol] pair, and cannot have overlappingportRanges. + * For internal forwarding rules within the same VPC network, two or more + * forwarding rules cannot use the same [IPAddress, IPProtocol] + * pair, and cannot have overlapping portRanges. + * @pattern: \\d+(?:-\\d+)? * * Generated from protobuf field optional string port_range = 217518079; * @return string @@ -1257,7 +2010,25 @@ public function clearPortRange() } /** - * The ports, portRange, and allPorts fields are mutually exclusive. Only packets addressed to ports in the specified range will be forwarded to the backends configured with this forwarding rule. The portRange field has the following limitations: - It requires that the forwarding rule IPProtocol be TCP, UDP, or SCTP, and - It's applicable only to the following products: external passthrough Network Load Balancers, internal and external proxy Network Load Balancers, internal and external Application Load Balancers, external protocol forwarding, and Classic VPN. - Some products have restrictions on what ports can be used. See port specifications for details. For external forwarding rules, two or more forwarding rules cannot use the same [IPAddress, IPProtocol] pair, and cannot have overlapping portRanges. For internal forwarding rules within the same VPC network, two or more forwarding rules cannot use the same [IPAddress, IPProtocol] pair, and cannot have overlapping portRanges. @pattern: \\d+(?:-\\d+)? + * The ports, portRange, and allPorts + * fields are mutually exclusive. Only packets addressed to ports in the + * specified range will be forwarded to the backends configured with this + * forwarding rule. + * The portRange field has the following limitations: + * - It requires that the forwarding rule IPProtocol be TCP, + * UDP, or SCTP, and + * - It's applicable only to the following products: external passthrough + * Network Load Balancers, internal and external proxy Network Load Balancers, + * internal and external Application Load Balancers, external protocol + * forwarding, and Classic VPN. + * - Some products have restrictions on what ports can be used. See + * port specifications for details. + * For external forwarding rules, two or more forwarding rules cannot use the + * same [IPAddress, IPProtocol] pair, and cannot have overlappingportRanges. + * For internal forwarding rules within the same VPC network, two or more + * forwarding rules cannot use the same [IPAddress, IPProtocol] + * pair, and cannot have overlapping portRanges. + * @pattern: \\d+(?:-\\d+)? * * Generated from protobuf field optional string port_range = 217518079; * @param string $var @@ -1272,7 +2043,25 @@ public function setPortRange($var) } /** - * The ports, portRange, and allPorts fields are mutually exclusive. Only packets addressed to ports in the specified range will be forwarded to the backends configured with this forwarding rule. The ports field has the following limitations: - It requires that the forwarding rule IPProtocol be TCP, UDP, or SCTP, and - It's applicable only to the following products: internal passthrough Network Load Balancers, backend service-based external passthrough Network Load Balancers, and internal protocol forwarding. - You can specify a list of up to five ports by number, separated by commas. The ports can be contiguous or discontiguous. For external forwarding rules, two or more forwarding rules cannot use the same [IPAddress, IPProtocol] pair if they share at least one port number. For internal forwarding rules within the same VPC network, two or more forwarding rules cannot use the same [IPAddress, IPProtocol] pair if they share at least one port number. @pattern: \\d+(?:-\\d+)? + * The ports, portRange, and allPorts + * fields are mutually exclusive. Only packets addressed to ports in the + * specified range will be forwarded to the backends configured with this + * forwarding rule. + * The ports field has the following limitations: + * - It requires that the forwarding rule IPProtocol be TCP, + * UDP, or SCTP, and + * - It's applicable only to the following products: internal passthrough + * Network Load Balancers, backend service-based external passthrough Network + * Load Balancers, and internal protocol forwarding. + * - You can specify a list of up to five ports by number, separated by + * commas. The ports can be contiguous or discontiguous. + * For external forwarding rules, two or more forwarding rules cannot use the + * same [IPAddress, IPProtocol] pair if they share at least one + * port number. + * For internal forwarding rules within the same VPC network, two or more + * forwarding rules cannot use the same [IPAddress, IPProtocol] + * pair if they share at least one port number. + * @pattern: \\d+(?:-\\d+)? * * Generated from protobuf field repeated string ports = 106854418; * @return \Google\Protobuf\Internal\RepeatedField @@ -1283,7 +2072,25 @@ public function getPorts() } /** - * The ports, portRange, and allPorts fields are mutually exclusive. Only packets addressed to ports in the specified range will be forwarded to the backends configured with this forwarding rule. The ports field has the following limitations: - It requires that the forwarding rule IPProtocol be TCP, UDP, or SCTP, and - It's applicable only to the following products: internal passthrough Network Load Balancers, backend service-based external passthrough Network Load Balancers, and internal protocol forwarding. - You can specify a list of up to five ports by number, separated by commas. The ports can be contiguous or discontiguous. For external forwarding rules, two or more forwarding rules cannot use the same [IPAddress, IPProtocol] pair if they share at least one port number. For internal forwarding rules within the same VPC network, two or more forwarding rules cannot use the same [IPAddress, IPProtocol] pair if they share at least one port number. @pattern: \\d+(?:-\\d+)? + * The ports, portRange, and allPorts + * fields are mutually exclusive. Only packets addressed to ports in the + * specified range will be forwarded to the backends configured with this + * forwarding rule. + * The ports field has the following limitations: + * - It requires that the forwarding rule IPProtocol be TCP, + * UDP, or SCTP, and + * - It's applicable only to the following products: internal passthrough + * Network Load Balancers, backend service-based external passthrough Network + * Load Balancers, and internal protocol forwarding. + * - You can specify a list of up to five ports by number, separated by + * commas. The ports can be contiguous or discontiguous. + * For external forwarding rules, two or more forwarding rules cannot use the + * same [IPAddress, IPProtocol] pair if they share at least one + * port number. + * For internal forwarding rules within the same VPC network, two or more + * forwarding rules cannot use the same [IPAddress, IPProtocol] + * pair if they share at least one port number. + * @pattern: \\d+(?:-\\d+)? * * Generated from protobuf field repeated string ports = 106854418; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -1372,7 +2179,10 @@ public function setPscConnectionStatus($var) } /** - * [Output Only] URL of the region where the regional forwarding rule resides. This field is not applicable to global forwarding rules. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * [Output Only] URL of the region where the regional forwarding rule resides. + * This field is not applicable to global forwarding rules. + * You must specify this field as part of the HTTP request URL. It is + * not settable as a field in the request body. * * Generated from protobuf field optional string region = 138946292; * @return string @@ -1393,7 +2203,10 @@ public function clearRegion() } /** - * [Output Only] URL of the region where the regional forwarding rule resides. This field is not applicable to global forwarding rules. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * [Output Only] URL of the region where the regional forwarding rule resides. + * This field is not applicable to global forwarding rules. + * You must specify this field as part of the HTTP request URL. It is + * not settable as a field in the request body. * * Generated from protobuf field optional string region = 138946292; * @param string $var @@ -1480,7 +2293,8 @@ public function setSelfLinkWithId($var) } /** - * Service Directory resources to register this forwarding rule with. Currently, only supports a single Service Directory resource. + * Service Directory resources to register this forwarding rule with. + * Currently, only supports a single Service Directory resource. * * Generated from protobuf field repeated .google.cloud.compute.v1.ForwardingRuleServiceDirectoryRegistration service_directory_registrations = 223549694; * @return \Google\Protobuf\Internal\RepeatedField @@ -1491,7 +2305,8 @@ public function getServiceDirectoryRegistrations() } /** - * Service Directory resources to register this forwarding rule with. Currently, only supports a single Service Directory resource. + * Service Directory resources to register this forwarding rule with. + * Currently, only supports a single Service Directory resource. * * Generated from protobuf field repeated .google.cloud.compute.v1.ForwardingRuleServiceDirectoryRegistration service_directory_registrations = 223549694; * @param array<\Google\Cloud\Compute\V1\ForwardingRuleServiceDirectoryRegistration>|\Google\Protobuf\Internal\RepeatedField $var @@ -1506,7 +2321,16 @@ public function setServiceDirectoryRegistrations($var) } /** - * An optional prefix to the service name for this forwarding rule. If specified, the prefix is the first label of the fully qualified service name. The label must be 1-63 characters long, and comply with RFC1035. Specifically, the label must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. This field is only used for internal load balancing. + * An optional prefix to the service name for this forwarding rule. + * If specified, the prefix is the first label of the fully qualified service + * name. + * The label must be 1-63 characters long, and comply withRFC1035. + * Specifically, the label must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. + * This field is only used for internal load balancing. * * Generated from protobuf field optional string service_label = 417008874; * @return string @@ -1527,7 +2351,16 @@ public function clearServiceLabel() } /** - * An optional prefix to the service name for this forwarding rule. If specified, the prefix is the first label of the fully qualified service name. The label must be 1-63 characters long, and comply with RFC1035. Specifically, the label must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. This field is only used for internal load balancing. + * An optional prefix to the service name for this forwarding rule. + * If specified, the prefix is the first label of the fully qualified service + * name. + * The label must be 1-63 characters long, and comply withRFC1035. + * Specifically, the label must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. + * This field is only used for internal load balancing. * * Generated from protobuf field optional string service_label = 417008874; * @param string $var @@ -1542,7 +2375,9 @@ public function setServiceLabel($var) } /** - * [Output Only] The internal fully qualified service name for this forwarding rule. This field is only used for internal load balancing. + * [Output Only] + * The internal fully qualified service name for this forwarding rule. + * This field is only used for internal load balancing. * * Generated from protobuf field optional string service_name = 359880149; * @return string @@ -1563,7 +2398,9 @@ public function clearServiceName() } /** - * [Output Only] The internal fully qualified service name for this forwarding rule. This field is only used for internal load balancing. + * [Output Only] + * The internal fully qualified service name for this forwarding rule. + * This field is only used for internal load balancing. * * Generated from protobuf field optional string service_name = 359880149; * @param string $var @@ -1578,7 +2415,12 @@ public function setServiceName($var) } /** - * If not empty, this forwarding rule will only forward the traffic when the source IP address matches one of the IP addresses or CIDR ranges set here. Note that a forwarding rule can only have up to 64 source IP ranges, and this field can only be used with a regional forwarding rule whose scheme is EXTERNAL. Each source_ip_range entry should be either an IP address (for example, 1.2.3.4) or a CIDR range (for example, 1.2.3.0/24). + * If not empty, this forwarding rule will only forward the traffic when the + * source IP address matches one of the IP addresses or CIDR ranges set here. + * Note that a forwarding rule can only have up to 64 source IP ranges, and + * this field can only be used with a regional forwarding rule whose scheme isEXTERNAL. + * Each source_ip_range entry should be either an IP address (for + * example, 1.2.3.4) or a CIDR range (for example, 1.2.3.0/24). * * Generated from protobuf field repeated string source_ip_ranges = 111563210; * @return \Google\Protobuf\Internal\RepeatedField @@ -1589,7 +2431,12 @@ public function getSourceIpRanges() } /** - * If not empty, this forwarding rule will only forward the traffic when the source IP address matches one of the IP addresses or CIDR ranges set here. Note that a forwarding rule can only have up to 64 source IP ranges, and this field can only be used with a regional forwarding rule whose scheme is EXTERNAL. Each source_ip_range entry should be either an IP address (for example, 1.2.3.4) or a CIDR range (for example, 1.2.3.0/24). + * If not empty, this forwarding rule will only forward the traffic when the + * source IP address matches one of the IP addresses or CIDR ranges set here. + * Note that a forwarding rule can only have up to 64 source IP ranges, and + * this field can only be used with a regional forwarding rule whose scheme isEXTERNAL. + * Each source_ip_range entry should be either an IP address (for + * example, 1.2.3.4) or a CIDR range (for example, 1.2.3.0/24). * * Generated from protobuf field repeated string source_ip_ranges = 111563210; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -1604,7 +2451,12 @@ public function setSourceIpRanges($var) } /** - * This field identifies the subnetwork that the load balanced IP should belong to for this forwarding rule, used with internal load balancers and external passthrough Network Load Balancers with IPv6. If the network specified is in auto subnet mode, this field is optional. However, a subnetwork must be specified if the network is in custom subnet mode or when creating external forwarding rule with IPv6. + * This field identifies the subnetwork that the load balanced IP should + * belong to for this forwarding rule, used with internal load balancers and + * external passthrough Network Load Balancers with IPv6. + * If the network specified is in auto subnet mode, this field is optional. + * However, a subnetwork must be specified if the network is in custom subnet + * mode or when creating external forwarding rule with IPv6. * * Generated from protobuf field optional string subnetwork = 307827694; * @return string @@ -1625,7 +2477,12 @@ public function clearSubnetwork() } /** - * This field identifies the subnetwork that the load balanced IP should belong to for this forwarding rule, used with internal load balancers and external passthrough Network Load Balancers with IPv6. If the network specified is in auto subnet mode, this field is optional. However, a subnetwork must be specified if the network is in custom subnet mode or when creating external forwarding rule with IPv6. + * This field identifies the subnetwork that the load balanced IP should + * belong to for this forwarding rule, used with internal load balancers and + * external passthrough Network Load Balancers with IPv6. + * If the network specified is in auto subnet mode, this field is optional. + * However, a subnetwork must be specified if the network is in custom subnet + * mode or when creating external forwarding rule with IPv6. * * Generated from protobuf field optional string subnetwork = 307827694; * @param string $var @@ -1640,7 +2497,16 @@ public function setSubnetwork($var) } /** - * The URL of the target resource to receive the matched traffic. For regional forwarding rules, this target must be in the same region as the forwarding rule. For global forwarding rules, this target must be a global load balancing resource. The forwarded traffic must be of a type appropriate to the target object. - For load balancers, see the "Target" column in [Port specifications](https://cloud.google.com/load-balancing/docs/forwarding-rule-concepts#ip_address_specifications). - For Private Service Connect forwarding rules that forward traffic to Google APIs, provide the name of a supported Google API bundle: - vpc-sc - APIs that support VPC Service Controls. - all-apis - All supported Google APIs. - For Private Service Connect forwarding rules that forward traffic to managed services, the target must be a service attachment. The target is not mutable once set as a service attachment. + * The URL of the target resource to receive the matched traffic. For + * regional forwarding rules, this target must be in the same region as the + * forwarding rule. For global forwarding rules, this target must be a global + * load balancing resource. + * The forwarded traffic must be of a type appropriate to the target object. + * - For load balancers, see the "Target" column in [Port specifications](https://cloud.google.com/load-balancing/docs/forwarding-rule-concepts#ip_address_specifications). + * - For Private Service Connect forwarding rules that forward traffic to Google APIs, provide the name of a supported Google API bundle: + * - vpc-sc - APIs that support VPC Service Controls. + * - all-apis - All supported Google APIs. + * - For Private Service Connect forwarding rules that forward traffic to managed services, the target must be a service attachment. The target is not mutable once set as a service attachment. * * Generated from protobuf field optional string target = 192835985; * @return string @@ -1661,7 +2527,16 @@ public function clearTarget() } /** - * The URL of the target resource to receive the matched traffic. For regional forwarding rules, this target must be in the same region as the forwarding rule. For global forwarding rules, this target must be a global load balancing resource. The forwarded traffic must be of a type appropriate to the target object. - For load balancers, see the "Target" column in [Port specifications](https://cloud.google.com/load-balancing/docs/forwarding-rule-concepts#ip_address_specifications). - For Private Service Connect forwarding rules that forward traffic to Google APIs, provide the name of a supported Google API bundle: - vpc-sc - APIs that support VPC Service Controls. - all-apis - All supported Google APIs. - For Private Service Connect forwarding rules that forward traffic to managed services, the target must be a service attachment. The target is not mutable once set as a service attachment. + * The URL of the target resource to receive the matched traffic. For + * regional forwarding rules, this target must be in the same region as the + * forwarding rule. For global forwarding rules, this target must be a global + * load balancing resource. + * The forwarded traffic must be of a type appropriate to the target object. + * - For load balancers, see the "Target" column in [Port specifications](https://cloud.google.com/load-balancing/docs/forwarding-rule-concepts#ip_address_specifications). + * - For Private Service Connect forwarding rules that forward traffic to Google APIs, provide the name of a supported Google API bundle: + * - vpc-sc - APIs that support VPC Service Controls. + * - all-apis - All supported Google APIs. + * - For Private Service Connect forwarding rules that forward traffic to managed services, the target must be a service attachment. The target is not mutable once set as a service attachment. * * Generated from protobuf field optional string target = 192835985; * @param string $var diff --git a/Compute/src/V1/ForwardingRule/ExternalManagedBackendBucketMigrationState.php b/Compute/src/V1/ForwardingRule/ExternalManagedBackendBucketMigrationState.php index a790cfb8460a..63db791f15c9 100644 --- a/Compute/src/V1/ForwardingRule/ExternalManagedBackendBucketMigrationState.php +++ b/Compute/src/V1/ForwardingRule/ExternalManagedBackendBucketMigrationState.php @@ -7,7 +7,20 @@ use UnexpectedValueException; /** - * Specifies the canary migration state for the backend buckets attached to this forwarding rule. Possible values are PREPARE, TEST_BY_PERCENTAGE, and TEST_ALL_TRAFFIC. To begin the migration from EXTERNAL to EXTERNAL_MANAGED, the state must be changed to PREPARE. The state must be changed to TEST_ALL_TRAFFIC before the loadBalancingScheme can be changed to EXTERNAL_MANAGED. Optionally, the TEST_BY_PERCENTAGE state can be used to migrate traffic to backend buckets attached to this forwarding rule by percentage using externalManagedBackendBucketMigrationTestingPercentage. Rolling back a migration requires the states to be set in reverse order. So changing the scheme from EXTERNAL_MANAGED to EXTERNAL requires the state to be set to TEST_ALL_TRAFFIC at the same time. Optionally, the TEST_BY_PERCENTAGE state can be used to migrate some traffic back to EXTERNAL or PREPARE can be used to migrate all traffic back to EXTERNAL. + * Specifies the canary migration state for the backend buckets attached to + * this forwarding rule. Possible values are PREPARE, TEST_BY_PERCENTAGE, and + * TEST_ALL_TRAFFIC. + * To begin the migration from EXTERNAL to EXTERNAL_MANAGED, the state must be + * changed to PREPARE. The state must be changed to TEST_ALL_TRAFFIC before + * the loadBalancingScheme can be changed to EXTERNAL_MANAGED. Optionally, the + * TEST_BY_PERCENTAGE state can be used to migrate traffic to backend buckets + * attached to this forwarding rule by percentage using + * externalManagedBackendBucketMigrationTestingPercentage. + * Rolling back a migration requires the states to be set in reverse order. So + * changing the scheme from EXTERNAL_MANAGED to EXTERNAL requires the state to + * be set to TEST_ALL_TRAFFIC at the same time. Optionally, the + * TEST_BY_PERCENTAGE state can be used to migrate some traffic back to + * EXTERNAL or PREPARE can be used to migrate all traffic back to EXTERNAL. * * Protobuf type google.cloud.compute.v1.ForwardingRule.ExternalManagedBackendBucketMigrationState */ diff --git a/Compute/src/V1/ForwardingRule/IPProtocolEnum.php b/Compute/src/V1/ForwardingRule/IPProtocolEnum.php index 3cb07cad0e90..e311fa355fbd 100644 --- a/Compute/src/V1/ForwardingRule/IPProtocolEnum.php +++ b/Compute/src/V1/ForwardingRule/IPProtocolEnum.php @@ -7,7 +7,12 @@ use UnexpectedValueException; /** - * The IP protocol to which this rule applies. For protocol forwarding, valid options are TCP, UDP, ESP, AH, SCTP, ICMP and L3_DEFAULT. The valid IP protocols are different for different load balancing products as described in [Load balancing features](https://cloud.google.com/load-balancing/docs/features#protocols_from_the_load_balancer_to_the_backends). + * The IP protocol to which this rule applies. + * For protocol forwarding, valid + * options are TCP, UDP, ESP,AH, SCTP, ICMP andL3_DEFAULT. + * The valid IP protocols are different for different load balancing products + * as described in [Load balancing + * features](https://cloud.google.com/load-balancing/docs/features#protocols_from_the_load_balancer_to_the_backends). * * Protobuf type google.cloud.compute.v1.ForwardingRule.IPProtocolEnum */ diff --git a/Compute/src/V1/ForwardingRule/IpVersion.php b/Compute/src/V1/ForwardingRule/IpVersion.php index 83130753e2ef..731a24dfbcd0 100644 --- a/Compute/src/V1/ForwardingRule/IpVersion.php +++ b/Compute/src/V1/ForwardingRule/IpVersion.php @@ -7,7 +7,8 @@ use UnexpectedValueException; /** - * The IP Version that will be used by this forwarding rule. Valid options are IPV4 or IPV6. + * The IP Version that will be used by this forwarding rule. Valid options + * are IPV4 or IPV6. * * Protobuf type google.cloud.compute.v1.ForwardingRule.IpVersion */ diff --git a/Compute/src/V1/ForwardingRule/LoadBalancingScheme.php b/Compute/src/V1/ForwardingRule/LoadBalancingScheme.php index d0b2aebdc978..46bec736ba4c 100644 --- a/Compute/src/V1/ForwardingRule/LoadBalancingScheme.php +++ b/Compute/src/V1/ForwardingRule/LoadBalancingScheme.php @@ -7,7 +7,9 @@ use UnexpectedValueException; /** - * Specifies the forwarding rule type. For more information about forwarding rules, refer to Forwarding rule concepts. + * Specifies the forwarding rule type. + * For more information about forwarding rules, refer to + * Forwarding rule concepts. * * Protobuf type google.cloud.compute.v1.ForwardingRule.LoadBalancingScheme */ diff --git a/Compute/src/V1/ForwardingRule/NetworkTier.php b/Compute/src/V1/ForwardingRule/NetworkTier.php index ee81a84beea4..9f35b73dc0d6 100644 --- a/Compute/src/V1/ForwardingRule/NetworkTier.php +++ b/Compute/src/V1/ForwardingRule/NetworkTier.php @@ -7,7 +7,12 @@ use UnexpectedValueException; /** - * This signifies the networking tier used for configuring this load balancer and can only take the following values: PREMIUM, STANDARD. For regional ForwardingRule, the valid values are PREMIUM and STANDARD. For GlobalForwardingRule, the valid value is PREMIUM. If this field is not specified, it is assumed to be PREMIUM. If IPAddress is specified, this value must be equal to the networkTier of the Address. + * This signifies the networking tier used for configuring + * this load balancer and can only take the following values:PREMIUM, STANDARD. + * For regional ForwardingRule, the valid values are PREMIUM andSTANDARD. For GlobalForwardingRule, the valid value isPREMIUM. + * If this field is not specified, it is assumed to be PREMIUM. + * If IPAddress is specified, this value must be equal to the + * networkTier of the Address. * * Protobuf type google.cloud.compute.v1.ForwardingRule.NetworkTier */ @@ -26,19 +31,22 @@ class NetworkTier */ const FIXED_STANDARD = 310464328; /** - * High quality, Google-grade network tier, support for all networking products. + * High quality, Google-grade network tier, support for all networking + * products. * * Generated from protobuf enum PREMIUM = 399530551; */ const PREMIUM = 399530551; /** - * Public internet quality, only limited support for other networking products. + * Public internet quality, only limited support for other networking + * products. * * Generated from protobuf enum STANDARD = 484642493; */ const STANDARD = 484642493; /** - * (Output only) Temporary tier for FIXED_STANDARD when fixed standard tier is expired or not configured. + * (Output only) Temporary tier for FIXED_STANDARD when fixed standard tier + * is expired or not configured. * * Generated from protobuf enum STANDARD_OVERRIDES_FIXED_STANDARD = 465847234; */ diff --git a/Compute/src/V1/ForwardingRule/PscConnectionStatus.php b/Compute/src/V1/ForwardingRule/PscConnectionStatus.php index 6cf2e70bff2d..8bf9ff9eb94c 100644 --- a/Compute/src/V1/ForwardingRule/PscConnectionStatus.php +++ b/Compute/src/V1/ForwardingRule/PscConnectionStatus.php @@ -25,13 +25,15 @@ class PscConnectionStatus */ const ACCEPTED = 246714279; /** - * The connection has been closed by the producer and will not serve traffic going forward. + * The connection has been closed by the producer and will not serve traffic + * going forward. * * Generated from protobuf enum CLOSED = 380163436; */ const CLOSED = 380163436; /** - * The connection has been accepted by the producer, but the producer needs to take further action before the forwarding rule can serve traffic. + * The connection has been accepted by the producer, but the producer needs + * to take further action before the forwarding rule can serve traffic. * * Generated from protobuf enum NEEDS_ATTENTION = 344491452; */ diff --git a/Compute/src/V1/ForwardingRuleAggregatedList.php b/Compute/src/V1/ForwardingRuleAggregatedList.php index 1e3b38d3fc38..2067ddfd094f 100644 --- a/Compute/src/V1/ForwardingRuleAggregatedList.php +++ b/Compute/src/V1/ForwardingRuleAggregatedList.php @@ -27,13 +27,17 @@ class ForwardingRuleAggregatedList extends \Google\Protobuf\Internal\Message */ private $items; /** - * [Output Only] Type of resource. Always compute#forwardingRuleAggregatedList for lists of forwarding rules. + * [Output Only] Type of resource. Alwayscompute#forwardingRuleAggregatedList for lists of forwarding rules. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -68,9 +72,13 @@ class ForwardingRuleAggregatedList extends \Google\Protobuf\Internal\Message * @type array|\Google\Protobuf\Internal\MapField $items * A list of ForwardingRulesScopedList resources. * @type string $kind - * [Output Only] Type of resource. Always compute#forwardingRuleAggregatedList for lists of forwarding rules. + * [Output Only] Type of resource. Alwayscompute#forwardingRuleAggregatedList for lists of forwarding rules. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type array|\Google\Protobuf\Internal\RepeatedField $unreachables @@ -147,7 +155,7 @@ public function setItems($var) } /** - * [Output Only] Type of resource. Always compute#forwardingRuleAggregatedList for lists of forwarding rules. + * [Output Only] Type of resource. Alwayscompute#forwardingRuleAggregatedList for lists of forwarding rules. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -168,7 +176,7 @@ public function clearKind() } /** - * [Output Only] Type of resource. Always compute#forwardingRuleAggregatedList for lists of forwarding rules. + * [Output Only] Type of resource. Alwayscompute#forwardingRuleAggregatedList for lists of forwarding rules. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -183,7 +191,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -204,7 +216,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/ForwardingRuleList.php b/Compute/src/V1/ForwardingRuleList.php index 3ea2c35af9f1..6201bd2a4652 100644 --- a/Compute/src/V1/ForwardingRuleList.php +++ b/Compute/src/V1/ForwardingRuleList.php @@ -34,7 +34,11 @@ class ForwardingRuleList extends \Google\Protobuf\Internal\Message */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -65,7 +69,11 @@ class ForwardingRuleList extends \Google\Protobuf\Internal\Message * @type string $kind * Type of resource. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type \Google\Cloud\Compute\V1\Warning $warning @@ -176,7 +184,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -197,7 +209,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/ForwardingRuleServiceDirectoryRegistration.php b/Compute/src/V1/ForwardingRuleServiceDirectoryRegistration.php index ea22e86911a0..6b92cd7a1b54 100644 --- a/Compute/src/V1/ForwardingRuleServiceDirectoryRegistration.php +++ b/Compute/src/V1/ForwardingRuleServiceDirectoryRegistration.php @@ -9,7 +9,9 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Describes the auto-registration of the forwarding rule to Service Directory. The region and project of the Service Directory resource generated from this registration will be the same as this forwarding rule. + * Describes the auto-registration of the forwarding rule to Service Directory. + * The region and project of the Service Directory resource generated from + * this registration will be the same as this forwarding rule. * * Generated from protobuf message google.cloud.compute.v1.ForwardingRuleServiceDirectoryRegistration */ @@ -28,7 +30,10 @@ class ForwardingRuleServiceDirectoryRegistration extends \Google\Protobuf\Intern */ protected $service = null; /** - * [Optional] Service Directory region to register this global forwarding rule under. Default to "us-central1". Only used for PSC for Google APIs. All PSC for Google APIs forwarding rules on the same network should use the same Service Directory region. + * [Optional] Service Directory region to register this global forwarding + * rule under. Default to "us-central1". Only used for PSC for Google APIs. + * All PSC for Google APIs forwarding rules on the same network should use + * the same Service Directory region. * * Generated from protobuf field optional string service_directory_region = 74030416; */ @@ -45,7 +50,10 @@ class ForwardingRuleServiceDirectoryRegistration extends \Google\Protobuf\Intern * @type string $service * Service Directory service to register the forwarding rule under. * @type string $service_directory_region - * [Optional] Service Directory region to register this global forwarding rule under. Default to "us-central1". Only used for PSC for Google APIs. All PSC for Google APIs forwarding rules on the same network should use the same Service Directory region. + * [Optional] Service Directory region to register this global forwarding + * rule under. Default to "us-central1". Only used for PSC for Google APIs. + * All PSC for Google APIs forwarding rules on the same network should use + * the same Service Directory region. * } */ public function __construct($data = NULL) { @@ -126,7 +134,10 @@ public function setService($var) } /** - * [Optional] Service Directory region to register this global forwarding rule under. Default to "us-central1". Only used for PSC for Google APIs. All PSC for Google APIs forwarding rules on the same network should use the same Service Directory region. + * [Optional] Service Directory region to register this global forwarding + * rule under. Default to "us-central1". Only used for PSC for Google APIs. + * All PSC for Google APIs forwarding rules on the same network should use + * the same Service Directory region. * * Generated from protobuf field optional string service_directory_region = 74030416; * @return string @@ -147,7 +158,10 @@ public function clearServiceDirectoryRegion() } /** - * [Optional] Service Directory region to register this global forwarding rule under. Default to "us-central1". Only used for PSC for Google APIs. All PSC for Google APIs forwarding rules on the same network should use the same Service Directory region. + * [Optional] Service Directory region to register this global forwarding + * rule under. Default to "us-central1". Only used for PSC for Google APIs. + * All PSC for Google APIs forwarding rules on the same network should use + * the same Service Directory region. * * Generated from protobuf field optional string service_directory_region = 74030416; * @param string $var diff --git a/Compute/src/V1/ForwardingRulesScopedList.php b/Compute/src/V1/ForwardingRulesScopedList.php index 801c7f62f1c9..a41d78e6adca 100644 --- a/Compute/src/V1/ForwardingRulesScopedList.php +++ b/Compute/src/V1/ForwardingRulesScopedList.php @@ -21,7 +21,8 @@ class ForwardingRulesScopedList extends \Google\Protobuf\Internal\Message */ private $forwarding_rules; /** - * Informational warning which replaces the list of forwarding rules when the list is empty. + * Informational warning which replaces the list of forwarding rules when + * the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; */ @@ -36,7 +37,8 @@ class ForwardingRulesScopedList extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\ForwardingRule>|\Google\Protobuf\Internal\RepeatedField $forwarding_rules * A list of forwarding rules contained in this scope. * @type \Google\Cloud\Compute\V1\Warning $warning - * Informational warning which replaces the list of forwarding rules when the list is empty. + * Informational warning which replaces the list of forwarding rules when + * the list is empty. * } */ public function __construct($data = NULL) { @@ -71,7 +73,8 @@ public function setForwardingRules($var) } /** - * Informational warning which replaces the list of forwarding rules when the list is empty. + * Informational warning which replaces the list of forwarding rules when + * the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; * @return \Google\Cloud\Compute\V1\Warning|null @@ -92,7 +95,8 @@ public function clearWarning() } /** - * Informational warning which replaces the list of forwarding rules when the list is empty. + * Informational warning which replaces the list of forwarding rules when + * the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; * @param \Google\Cloud\Compute\V1\Warning $var diff --git a/Compute/src/V1/FutureReservation.php b/Compute/src/V1/FutureReservation.php new file mode 100644 index 000000000000..5c7ebfc263a1 --- /dev/null +++ b/Compute/src/V1/FutureReservation.php @@ -0,0 +1,1288 @@ +google.cloud.compute.v1.FutureReservation + */ +class FutureReservation extends \Google\Protobuf\Internal\Message +{ + /** + * Aggregate reservation details for the future reservation. + * + * Generated from protobuf field optional .google.cloud.compute.v1.AllocationAggregateReservation aggregate_reservation = 291567948; + */ + protected $aggregate_reservation = null; + /** + * Future timestamp when the FR auto-created reservations will be deleted by + * Compute Engine. Format of this field must be a valid + * href="https://www.ietf.org/rfc/rfc3339.txt">RFC3339 value. + * + * Generated from protobuf field optional string auto_created_reservations_delete_time = 242855120; + */ + protected $auto_created_reservations_delete_time = null; + /** + * Specifies the duration of auto-created reservations. + * It represents relative time to future reservation start_time when + * auto-created reservations will be automatically deleted by Compute + * Engine. Duration time unit is represented as a count of seconds + * and fractions of seconds at nanosecond resolution. + * + * Generated from protobuf field optional .google.cloud.compute.v1.Duration auto_created_reservations_duration = 496244741; + */ + protected $auto_created_reservations_duration = null; + /** + * Setting for enabling or disabling automatic deletion for auto-created + * reservation. If set to true, auto-created reservations will be + * deleted at Future Reservation's end time (default) or at user's defined + * timestamp if any of the + * [auto_created_reservations_delete_time, auto_created_reservations_duration] + * values is specified. + * For keeping auto-created reservation indefinitely, this value should be set + * to false. + * + * Generated from protobuf field optional bool auto_delete_auto_created_reservations = 491352490; + */ + protected $auto_delete_auto_created_reservations = null; + /** + * If not present, then FR will not deliver a new commitment or update an + * existing commitment. + * + * Generated from protobuf field optional .google.cloud.compute.v1.FutureReservationCommitmentInfo commitment_info = 164362136; + */ + protected $commitment_info = null; + /** + * [Output Only] The creation timestamp for this future reservation inRFC3339 + * text format. + * + * Generated from protobuf field optional string creation_timestamp = 30525366; + */ + protected $creation_timestamp = null; + /** + * Type of the deployment requested as part of future reservation. + * Check the DeploymentType enum for the list of possible values. + * + * Generated from protobuf field optional string deployment_type = 396722292; + */ + protected $deployment_type = null; + /** + * An optional description of this resource. Provide this property when you + * create the future reservation. + * + * Generated from protobuf field optional string description = 422937596; + */ + protected $description = null; + /** + * Indicates if this group of VMs have emergent maintenance enabled. + * + * Generated from protobuf field optional bool enable_emergent_maintenance = 353759497; + */ + protected $enable_emergent_maintenance = null; + /** + * [Output Only] A unique identifier for this future reservation. The server + * defines this identifier. + * + * Generated from protobuf field optional uint64 id = 3355; + */ + protected $id = null; + /** + * [Output Only] Type of the resource. Alwayscompute#futureReservation for future reservations. + * + * Generated from protobuf field optional string kind = 3292052; + */ + protected $kind = null; + /** + * The name of the resource, provided by the client when initially creating + * the resource. The resource name must be 1-63 characters long, and comply + * withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must be + * a dash, lowercase letter, or digit, except the last character, which cannot + * be a dash. + * + * Generated from protobuf field optional string name = 3373707; + */ + protected $name = null; + /** + * Name prefix for the reservations to be created at the time of + * delivery. The name prefix must comply with RFC1035. + * Maximum allowed length for name prefix is 20. Automatically created + * reservations name format will be -date-####. + * + * Generated from protobuf field optional string name_prefix = 236409542; + */ + protected $name_prefix = null; + /** + * Planning state before being submitted for evaluation + * Check the PlanningStatus enum for the list of possible values. + * + * Generated from protobuf field optional string planning_status = 19714836; + */ + protected $planning_status = null; + /** + * The reservation mode which determines reservation-termination behavior and + * expected pricing. + * Check the ReservationMode enum for the list of possible values. + * + * Generated from protobuf field optional string reservation_mode = 277294646; + */ + protected $reservation_mode = null; + /** + * Name of reservations where the capacity is provisioned at the time of + * delivery of future reservations. If the reservation with the given name + * does not exist already, it is created automatically at the time of Approval + * with INACTIVE state till specified start-time. Either provide the + * reservation_name or a name_prefix. + * + * Generated from protobuf field optional string reservation_name = 277311262; + */ + protected $reservation_name = null; + /** + * Maintenance information for this reservation + * Check the SchedulingType enum for the list of possible values. + * + * Generated from protobuf field optional string scheduling_type = 199835397; + */ + protected $scheduling_type = null; + /** + * [Output Only] Server-defined fully-qualified URL for this resource. + * + * Generated from protobuf field optional string self_link = 456214797; + */ + protected $self_link = null; + /** + * [Output Only] Server-defined URL for this resource with the resource id. + * + * Generated from protobuf field optional string self_link_with_id = 44520962; + */ + protected $self_link_with_id = null; + /** + * List of Projects/Folders to share with. + * + * Generated from protobuf field optional .google.cloud.compute.v1.ShareSettings share_settings = 266668163; + */ + protected $share_settings = null; + /** + * Indicates whether the auto-created reservation can be consumed by VMs with + * affinity for "any" reservation. If the field is set, then only VMs that + * target the reservation by name can consume from the delivered reservation. + * + * Generated from protobuf field optional bool specific_reservation_required = 226550687; + */ + protected $specific_reservation_required = null; + /** + * Future Reservation configuration to indicate instance properties and + * total count. + * + * Generated from protobuf field optional .google.cloud.compute.v1.FutureReservationSpecificSKUProperties specific_sku_properties = 108887106; + */ + protected $specific_sku_properties = null; + /** + * [Output only] Status of the Future Reservation + * + * Generated from protobuf field optional .google.cloud.compute.v1.FutureReservationStatus status = 181260274; + */ + protected $status = null; + /** + * Time window for this Future Reservation. + * + * Generated from protobuf field optional .google.cloud.compute.v1.FutureReservationTimeWindow time_window = 422983074; + */ + protected $time_window = null; + /** + * [Output Only] URL of the Zone where this future reservation resides. + * + * Generated from protobuf field optional string zone = 3744684; + */ + protected $zone = null; + + /** + * Constructor. + * + * @param array $data { + * Optional. Data for populating the Message object. + * + * @type \Google\Cloud\Compute\V1\AllocationAggregateReservation $aggregate_reservation + * Aggregate reservation details for the future reservation. + * @type string $auto_created_reservations_delete_time + * Future timestamp when the FR auto-created reservations will be deleted by + * Compute Engine. Format of this field must be a valid + * href="https://www.ietf.org/rfc/rfc3339.txt">RFC3339 value. + * @type \Google\Cloud\Compute\V1\Duration $auto_created_reservations_duration + * Specifies the duration of auto-created reservations. + * It represents relative time to future reservation start_time when + * auto-created reservations will be automatically deleted by Compute + * Engine. Duration time unit is represented as a count of seconds + * and fractions of seconds at nanosecond resolution. + * @type bool $auto_delete_auto_created_reservations + * Setting for enabling or disabling automatic deletion for auto-created + * reservation. If set to true, auto-created reservations will be + * deleted at Future Reservation's end time (default) or at user's defined + * timestamp if any of the + * [auto_created_reservations_delete_time, auto_created_reservations_duration] + * values is specified. + * For keeping auto-created reservation indefinitely, this value should be set + * to false. + * @type \Google\Cloud\Compute\V1\FutureReservationCommitmentInfo $commitment_info + * If not present, then FR will not deliver a new commitment or update an + * existing commitment. + * @type string $creation_timestamp + * [Output Only] The creation timestamp for this future reservation inRFC3339 + * text format. + * @type string $deployment_type + * Type of the deployment requested as part of future reservation. + * Check the DeploymentType enum for the list of possible values. + * @type string $description + * An optional description of this resource. Provide this property when you + * create the future reservation. + * @type bool $enable_emergent_maintenance + * Indicates if this group of VMs have emergent maintenance enabled. + * @type int|string $id + * [Output Only] A unique identifier for this future reservation. The server + * defines this identifier. + * @type string $kind + * [Output Only] Type of the resource. Alwayscompute#futureReservation for future reservations. + * @type string $name + * The name of the resource, provided by the client when initially creating + * the resource. The resource name must be 1-63 characters long, and comply + * withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must be + * a dash, lowercase letter, or digit, except the last character, which cannot + * be a dash. + * @type string $name_prefix + * Name prefix for the reservations to be created at the time of + * delivery. The name prefix must comply with RFC1035. + * Maximum allowed length for name prefix is 20. Automatically created + * reservations name format will be -date-####. + * @type string $planning_status + * Planning state before being submitted for evaluation + * Check the PlanningStatus enum for the list of possible values. + * @type string $reservation_mode + * The reservation mode which determines reservation-termination behavior and + * expected pricing. + * Check the ReservationMode enum for the list of possible values. + * @type string $reservation_name + * Name of reservations where the capacity is provisioned at the time of + * delivery of future reservations. If the reservation with the given name + * does not exist already, it is created automatically at the time of Approval + * with INACTIVE state till specified start-time. Either provide the + * reservation_name or a name_prefix. + * @type string $scheduling_type + * Maintenance information for this reservation + * Check the SchedulingType enum for the list of possible values. + * @type string $self_link + * [Output Only] Server-defined fully-qualified URL for this resource. + * @type string $self_link_with_id + * [Output Only] Server-defined URL for this resource with the resource id. + * @type \Google\Cloud\Compute\V1\ShareSettings $share_settings + * List of Projects/Folders to share with. + * @type bool $specific_reservation_required + * Indicates whether the auto-created reservation can be consumed by VMs with + * affinity for "any" reservation. If the field is set, then only VMs that + * target the reservation by name can consume from the delivered reservation. + * @type \Google\Cloud\Compute\V1\FutureReservationSpecificSKUProperties $specific_sku_properties + * Future Reservation configuration to indicate instance properties and + * total count. + * @type \Google\Cloud\Compute\V1\FutureReservationStatus $status + * [Output only] Status of the Future Reservation + * @type \Google\Cloud\Compute\V1\FutureReservationTimeWindow $time_window + * Time window for this Future Reservation. + * @type string $zone + * [Output Only] URL of the Zone where this future reservation resides. + * } + */ + public function __construct($data = NULL) { + \GPBMetadata\Google\Cloud\Compute\V1\Compute::initOnce(); + parent::__construct($data); + } + + /** + * Aggregate reservation details for the future reservation. + * + * Generated from protobuf field optional .google.cloud.compute.v1.AllocationAggregateReservation aggregate_reservation = 291567948; + * @return \Google\Cloud\Compute\V1\AllocationAggregateReservation|null + */ + public function getAggregateReservation() + { + return $this->aggregate_reservation; + } + + public function hasAggregateReservation() + { + return isset($this->aggregate_reservation); + } + + public function clearAggregateReservation() + { + unset($this->aggregate_reservation); + } + + /** + * Aggregate reservation details for the future reservation. + * + * Generated from protobuf field optional .google.cloud.compute.v1.AllocationAggregateReservation aggregate_reservation = 291567948; + * @param \Google\Cloud\Compute\V1\AllocationAggregateReservation $var + * @return $this + */ + public function setAggregateReservation($var) + { + GPBUtil::checkMessage($var, \Google\Cloud\Compute\V1\AllocationAggregateReservation::class); + $this->aggregate_reservation = $var; + + return $this; + } + + /** + * Future timestamp when the FR auto-created reservations will be deleted by + * Compute Engine. Format of this field must be a valid + * href="https://www.ietf.org/rfc/rfc3339.txt">RFC3339 value. + * + * Generated from protobuf field optional string auto_created_reservations_delete_time = 242855120; + * @return string + */ + public function getAutoCreatedReservationsDeleteTime() + { + return isset($this->auto_created_reservations_delete_time) ? $this->auto_created_reservations_delete_time : ''; + } + + public function hasAutoCreatedReservationsDeleteTime() + { + return isset($this->auto_created_reservations_delete_time); + } + + public function clearAutoCreatedReservationsDeleteTime() + { + unset($this->auto_created_reservations_delete_time); + } + + /** + * Future timestamp when the FR auto-created reservations will be deleted by + * Compute Engine. Format of this field must be a valid + * href="https://www.ietf.org/rfc/rfc3339.txt">RFC3339 value. + * + * Generated from protobuf field optional string auto_created_reservations_delete_time = 242855120; + * @param string $var + * @return $this + */ + public function setAutoCreatedReservationsDeleteTime($var) + { + GPBUtil::checkString($var, True); + $this->auto_created_reservations_delete_time = $var; + + return $this; + } + + /** + * Specifies the duration of auto-created reservations. + * It represents relative time to future reservation start_time when + * auto-created reservations will be automatically deleted by Compute + * Engine. Duration time unit is represented as a count of seconds + * and fractions of seconds at nanosecond resolution. + * + * Generated from protobuf field optional .google.cloud.compute.v1.Duration auto_created_reservations_duration = 496244741; + * @return \Google\Cloud\Compute\V1\Duration|null + */ + public function getAutoCreatedReservationsDuration() + { + return $this->auto_created_reservations_duration; + } + + public function hasAutoCreatedReservationsDuration() + { + return isset($this->auto_created_reservations_duration); + } + + public function clearAutoCreatedReservationsDuration() + { + unset($this->auto_created_reservations_duration); + } + + /** + * Specifies the duration of auto-created reservations. + * It represents relative time to future reservation start_time when + * auto-created reservations will be automatically deleted by Compute + * Engine. Duration time unit is represented as a count of seconds + * and fractions of seconds at nanosecond resolution. + * + * Generated from protobuf field optional .google.cloud.compute.v1.Duration auto_created_reservations_duration = 496244741; + * @param \Google\Cloud\Compute\V1\Duration $var + * @return $this + */ + public function setAutoCreatedReservationsDuration($var) + { + GPBUtil::checkMessage($var, \Google\Cloud\Compute\V1\Duration::class); + $this->auto_created_reservations_duration = $var; + + return $this; + } + + /** + * Setting for enabling or disabling automatic deletion for auto-created + * reservation. If set to true, auto-created reservations will be + * deleted at Future Reservation's end time (default) or at user's defined + * timestamp if any of the + * [auto_created_reservations_delete_time, auto_created_reservations_duration] + * values is specified. + * For keeping auto-created reservation indefinitely, this value should be set + * to false. + * + * Generated from protobuf field optional bool auto_delete_auto_created_reservations = 491352490; + * @return bool + */ + public function getAutoDeleteAutoCreatedReservations() + { + return isset($this->auto_delete_auto_created_reservations) ? $this->auto_delete_auto_created_reservations : false; + } + + public function hasAutoDeleteAutoCreatedReservations() + { + return isset($this->auto_delete_auto_created_reservations); + } + + public function clearAutoDeleteAutoCreatedReservations() + { + unset($this->auto_delete_auto_created_reservations); + } + + /** + * Setting for enabling or disabling automatic deletion for auto-created + * reservation. If set to true, auto-created reservations will be + * deleted at Future Reservation's end time (default) or at user's defined + * timestamp if any of the + * [auto_created_reservations_delete_time, auto_created_reservations_duration] + * values is specified. + * For keeping auto-created reservation indefinitely, this value should be set + * to false. + * + * Generated from protobuf field optional bool auto_delete_auto_created_reservations = 491352490; + * @param bool $var + * @return $this + */ + public function setAutoDeleteAutoCreatedReservations($var) + { + GPBUtil::checkBool($var); + $this->auto_delete_auto_created_reservations = $var; + + return $this; + } + + /** + * If not present, then FR will not deliver a new commitment or update an + * existing commitment. + * + * Generated from protobuf field optional .google.cloud.compute.v1.FutureReservationCommitmentInfo commitment_info = 164362136; + * @return \Google\Cloud\Compute\V1\FutureReservationCommitmentInfo|null + */ + public function getCommitmentInfo() + { + return $this->commitment_info; + } + + public function hasCommitmentInfo() + { + return isset($this->commitment_info); + } + + public function clearCommitmentInfo() + { + unset($this->commitment_info); + } + + /** + * If not present, then FR will not deliver a new commitment or update an + * existing commitment. + * + * Generated from protobuf field optional .google.cloud.compute.v1.FutureReservationCommitmentInfo commitment_info = 164362136; + * @param \Google\Cloud\Compute\V1\FutureReservationCommitmentInfo $var + * @return $this + */ + public function setCommitmentInfo($var) + { + GPBUtil::checkMessage($var, \Google\Cloud\Compute\V1\FutureReservationCommitmentInfo::class); + $this->commitment_info = $var; + + return $this; + } + + /** + * [Output Only] The creation timestamp for this future reservation inRFC3339 + * text format. + * + * Generated from protobuf field optional string creation_timestamp = 30525366; + * @return string + */ + public function getCreationTimestamp() + { + return isset($this->creation_timestamp) ? $this->creation_timestamp : ''; + } + + public function hasCreationTimestamp() + { + return isset($this->creation_timestamp); + } + + public function clearCreationTimestamp() + { + unset($this->creation_timestamp); + } + + /** + * [Output Only] The creation timestamp for this future reservation inRFC3339 + * text format. + * + * Generated from protobuf field optional string creation_timestamp = 30525366; + * @param string $var + * @return $this + */ + public function setCreationTimestamp($var) + { + GPBUtil::checkString($var, True); + $this->creation_timestamp = $var; + + return $this; + } + + /** + * Type of the deployment requested as part of future reservation. + * Check the DeploymentType enum for the list of possible values. + * + * Generated from protobuf field optional string deployment_type = 396722292; + * @return string + */ + public function getDeploymentType() + { + return isset($this->deployment_type) ? $this->deployment_type : ''; + } + + public function hasDeploymentType() + { + return isset($this->deployment_type); + } + + public function clearDeploymentType() + { + unset($this->deployment_type); + } + + /** + * Type of the deployment requested as part of future reservation. + * Check the DeploymentType enum for the list of possible values. + * + * Generated from protobuf field optional string deployment_type = 396722292; + * @param string $var + * @return $this + */ + public function setDeploymentType($var) + { + GPBUtil::checkString($var, True); + $this->deployment_type = $var; + + return $this; + } + + /** + * An optional description of this resource. Provide this property when you + * create the future reservation. + * + * Generated from protobuf field optional string description = 422937596; + * @return string + */ + public function getDescription() + { + return isset($this->description) ? $this->description : ''; + } + + public function hasDescription() + { + return isset($this->description); + } + + public function clearDescription() + { + unset($this->description); + } + + /** + * An optional description of this resource. Provide this property when you + * create the future reservation. + * + * Generated from protobuf field optional string description = 422937596; + * @param string $var + * @return $this + */ + public function setDescription($var) + { + GPBUtil::checkString($var, True); + $this->description = $var; + + return $this; + } + + /** + * Indicates if this group of VMs have emergent maintenance enabled. + * + * Generated from protobuf field optional bool enable_emergent_maintenance = 353759497; + * @return bool + */ + public function getEnableEmergentMaintenance() + { + return isset($this->enable_emergent_maintenance) ? $this->enable_emergent_maintenance : false; + } + + public function hasEnableEmergentMaintenance() + { + return isset($this->enable_emergent_maintenance); + } + + public function clearEnableEmergentMaintenance() + { + unset($this->enable_emergent_maintenance); + } + + /** + * Indicates if this group of VMs have emergent maintenance enabled. + * + * Generated from protobuf field optional bool enable_emergent_maintenance = 353759497; + * @param bool $var + * @return $this + */ + public function setEnableEmergentMaintenance($var) + { + GPBUtil::checkBool($var); + $this->enable_emergent_maintenance = $var; + + return $this; + } + + /** + * [Output Only] A unique identifier for this future reservation. The server + * defines this identifier. + * + * Generated from protobuf field optional uint64 id = 3355; + * @return int|string + */ + public function getId() + { + return isset($this->id) ? $this->id : 0; + } + + public function hasId() + { + return isset($this->id); + } + + public function clearId() + { + unset($this->id); + } + + /** + * [Output Only] A unique identifier for this future reservation. The server + * defines this identifier. + * + * Generated from protobuf field optional uint64 id = 3355; + * @param int|string $var + * @return $this + */ + public function setId($var) + { + GPBUtil::checkUint64($var); + $this->id = $var; + + return $this; + } + + /** + * [Output Only] Type of the resource. Alwayscompute#futureReservation for future reservations. + * + * Generated from protobuf field optional string kind = 3292052; + * @return string + */ + public function getKind() + { + return isset($this->kind) ? $this->kind : ''; + } + + public function hasKind() + { + return isset($this->kind); + } + + public function clearKind() + { + unset($this->kind); + } + + /** + * [Output Only] Type of the resource. Alwayscompute#futureReservation for future reservations. + * + * Generated from protobuf field optional string kind = 3292052; + * @param string $var + * @return $this + */ + public function setKind($var) + { + GPBUtil::checkString($var, True); + $this->kind = $var; + + return $this; + } + + /** + * The name of the resource, provided by the client when initially creating + * the resource. The resource name must be 1-63 characters long, and comply + * withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must be + * a dash, lowercase letter, or digit, except the last character, which cannot + * be a dash. + * + * Generated from protobuf field optional string name = 3373707; + * @return string + */ + public function getName() + { + return isset($this->name) ? $this->name : ''; + } + + public function hasName() + { + return isset($this->name); + } + + public function clearName() + { + unset($this->name); + } + + /** + * The name of the resource, provided by the client when initially creating + * the resource. The resource name must be 1-63 characters long, and comply + * withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must be + * a dash, lowercase letter, or digit, except the last character, which cannot + * be a dash. + * + * Generated from protobuf field optional string name = 3373707; + * @param string $var + * @return $this + */ + public function setName($var) + { + GPBUtil::checkString($var, True); + $this->name = $var; + + return $this; + } + + /** + * Name prefix for the reservations to be created at the time of + * delivery. The name prefix must comply with RFC1035. + * Maximum allowed length for name prefix is 20. Automatically created + * reservations name format will be -date-####. + * + * Generated from protobuf field optional string name_prefix = 236409542; + * @return string + */ + public function getNamePrefix() + { + return isset($this->name_prefix) ? $this->name_prefix : ''; + } + + public function hasNamePrefix() + { + return isset($this->name_prefix); + } + + public function clearNamePrefix() + { + unset($this->name_prefix); + } + + /** + * Name prefix for the reservations to be created at the time of + * delivery. The name prefix must comply with RFC1035. + * Maximum allowed length for name prefix is 20. Automatically created + * reservations name format will be -date-####. + * + * Generated from protobuf field optional string name_prefix = 236409542; + * @param string $var + * @return $this + */ + public function setNamePrefix($var) + { + GPBUtil::checkString($var, True); + $this->name_prefix = $var; + + return $this; + } + + /** + * Planning state before being submitted for evaluation + * Check the PlanningStatus enum for the list of possible values. + * + * Generated from protobuf field optional string planning_status = 19714836; + * @return string + */ + public function getPlanningStatus() + { + return isset($this->planning_status) ? $this->planning_status : ''; + } + + public function hasPlanningStatus() + { + return isset($this->planning_status); + } + + public function clearPlanningStatus() + { + unset($this->planning_status); + } + + /** + * Planning state before being submitted for evaluation + * Check the PlanningStatus enum for the list of possible values. + * + * Generated from protobuf field optional string planning_status = 19714836; + * @param string $var + * @return $this + */ + public function setPlanningStatus($var) + { + GPBUtil::checkString($var, True); + $this->planning_status = $var; + + return $this; + } + + /** + * The reservation mode which determines reservation-termination behavior and + * expected pricing. + * Check the ReservationMode enum for the list of possible values. + * + * Generated from protobuf field optional string reservation_mode = 277294646; + * @return string + */ + public function getReservationMode() + { + return isset($this->reservation_mode) ? $this->reservation_mode : ''; + } + + public function hasReservationMode() + { + return isset($this->reservation_mode); + } + + public function clearReservationMode() + { + unset($this->reservation_mode); + } + + /** + * The reservation mode which determines reservation-termination behavior and + * expected pricing. + * Check the ReservationMode enum for the list of possible values. + * + * Generated from protobuf field optional string reservation_mode = 277294646; + * @param string $var + * @return $this + */ + public function setReservationMode($var) + { + GPBUtil::checkString($var, True); + $this->reservation_mode = $var; + + return $this; + } + + /** + * Name of reservations where the capacity is provisioned at the time of + * delivery of future reservations. If the reservation with the given name + * does not exist already, it is created automatically at the time of Approval + * with INACTIVE state till specified start-time. Either provide the + * reservation_name or a name_prefix. + * + * Generated from protobuf field optional string reservation_name = 277311262; + * @return string + */ + public function getReservationName() + { + return isset($this->reservation_name) ? $this->reservation_name : ''; + } + + public function hasReservationName() + { + return isset($this->reservation_name); + } + + public function clearReservationName() + { + unset($this->reservation_name); + } + + /** + * Name of reservations where the capacity is provisioned at the time of + * delivery of future reservations. If the reservation with the given name + * does not exist already, it is created automatically at the time of Approval + * with INACTIVE state till specified start-time. Either provide the + * reservation_name or a name_prefix. + * + * Generated from protobuf field optional string reservation_name = 277311262; + * @param string $var + * @return $this + */ + public function setReservationName($var) + { + GPBUtil::checkString($var, True); + $this->reservation_name = $var; + + return $this; + } + + /** + * Maintenance information for this reservation + * Check the SchedulingType enum for the list of possible values. + * + * Generated from protobuf field optional string scheduling_type = 199835397; + * @return string + */ + public function getSchedulingType() + { + return isset($this->scheduling_type) ? $this->scheduling_type : ''; + } + + public function hasSchedulingType() + { + return isset($this->scheduling_type); + } + + public function clearSchedulingType() + { + unset($this->scheduling_type); + } + + /** + * Maintenance information for this reservation + * Check the SchedulingType enum for the list of possible values. + * + * Generated from protobuf field optional string scheduling_type = 199835397; + * @param string $var + * @return $this + */ + public function setSchedulingType($var) + { + GPBUtil::checkString($var, True); + $this->scheduling_type = $var; + + return $this; + } + + /** + * [Output Only] Server-defined fully-qualified URL for this resource. + * + * Generated from protobuf field optional string self_link = 456214797; + * @return string + */ + public function getSelfLink() + { + return isset($this->self_link) ? $this->self_link : ''; + } + + public function hasSelfLink() + { + return isset($this->self_link); + } + + public function clearSelfLink() + { + unset($this->self_link); + } + + /** + * [Output Only] Server-defined fully-qualified URL for this resource. + * + * Generated from protobuf field optional string self_link = 456214797; + * @param string $var + * @return $this + */ + public function setSelfLink($var) + { + GPBUtil::checkString($var, True); + $this->self_link = $var; + + return $this; + } + + /** + * [Output Only] Server-defined URL for this resource with the resource id. + * + * Generated from protobuf field optional string self_link_with_id = 44520962; + * @return string + */ + public function getSelfLinkWithId() + { + return isset($this->self_link_with_id) ? $this->self_link_with_id : ''; + } + + public function hasSelfLinkWithId() + { + return isset($this->self_link_with_id); + } + + public function clearSelfLinkWithId() + { + unset($this->self_link_with_id); + } + + /** + * [Output Only] Server-defined URL for this resource with the resource id. + * + * Generated from protobuf field optional string self_link_with_id = 44520962; + * @param string $var + * @return $this + */ + public function setSelfLinkWithId($var) + { + GPBUtil::checkString($var, True); + $this->self_link_with_id = $var; + + return $this; + } + + /** + * List of Projects/Folders to share with. + * + * Generated from protobuf field optional .google.cloud.compute.v1.ShareSettings share_settings = 266668163; + * @return \Google\Cloud\Compute\V1\ShareSettings|null + */ + public function getShareSettings() + { + return $this->share_settings; + } + + public function hasShareSettings() + { + return isset($this->share_settings); + } + + public function clearShareSettings() + { + unset($this->share_settings); + } + + /** + * List of Projects/Folders to share with. + * + * Generated from protobuf field optional .google.cloud.compute.v1.ShareSettings share_settings = 266668163; + * @param \Google\Cloud\Compute\V1\ShareSettings $var + * @return $this + */ + public function setShareSettings($var) + { + GPBUtil::checkMessage($var, \Google\Cloud\Compute\V1\ShareSettings::class); + $this->share_settings = $var; + + return $this; + } + + /** + * Indicates whether the auto-created reservation can be consumed by VMs with + * affinity for "any" reservation. If the field is set, then only VMs that + * target the reservation by name can consume from the delivered reservation. + * + * Generated from protobuf field optional bool specific_reservation_required = 226550687; + * @return bool + */ + public function getSpecificReservationRequired() + { + return isset($this->specific_reservation_required) ? $this->specific_reservation_required : false; + } + + public function hasSpecificReservationRequired() + { + return isset($this->specific_reservation_required); + } + + public function clearSpecificReservationRequired() + { + unset($this->specific_reservation_required); + } + + /** + * Indicates whether the auto-created reservation can be consumed by VMs with + * affinity for "any" reservation. If the field is set, then only VMs that + * target the reservation by name can consume from the delivered reservation. + * + * Generated from protobuf field optional bool specific_reservation_required = 226550687; + * @param bool $var + * @return $this + */ + public function setSpecificReservationRequired($var) + { + GPBUtil::checkBool($var); + $this->specific_reservation_required = $var; + + return $this; + } + + /** + * Future Reservation configuration to indicate instance properties and + * total count. + * + * Generated from protobuf field optional .google.cloud.compute.v1.FutureReservationSpecificSKUProperties specific_sku_properties = 108887106; + * @return \Google\Cloud\Compute\V1\FutureReservationSpecificSKUProperties|null + */ + public function getSpecificSkuProperties() + { + return $this->specific_sku_properties; + } + + public function hasSpecificSkuProperties() + { + return isset($this->specific_sku_properties); + } + + public function clearSpecificSkuProperties() + { + unset($this->specific_sku_properties); + } + + /** + * Future Reservation configuration to indicate instance properties and + * total count. + * + * Generated from protobuf field optional .google.cloud.compute.v1.FutureReservationSpecificSKUProperties specific_sku_properties = 108887106; + * @param \Google\Cloud\Compute\V1\FutureReservationSpecificSKUProperties $var + * @return $this + */ + public function setSpecificSkuProperties($var) + { + GPBUtil::checkMessage($var, \Google\Cloud\Compute\V1\FutureReservationSpecificSKUProperties::class); + $this->specific_sku_properties = $var; + + return $this; + } + + /** + * [Output only] Status of the Future Reservation + * + * Generated from protobuf field optional .google.cloud.compute.v1.FutureReservationStatus status = 181260274; + * @return \Google\Cloud\Compute\V1\FutureReservationStatus|null + */ + public function getStatus() + { + return $this->status; + } + + public function hasStatus() + { + return isset($this->status); + } + + public function clearStatus() + { + unset($this->status); + } + + /** + * [Output only] Status of the Future Reservation + * + * Generated from protobuf field optional .google.cloud.compute.v1.FutureReservationStatus status = 181260274; + * @param \Google\Cloud\Compute\V1\FutureReservationStatus $var + * @return $this + */ + public function setStatus($var) + { + GPBUtil::checkMessage($var, \Google\Cloud\Compute\V1\FutureReservationStatus::class); + $this->status = $var; + + return $this; + } + + /** + * Time window for this Future Reservation. + * + * Generated from protobuf field optional .google.cloud.compute.v1.FutureReservationTimeWindow time_window = 422983074; + * @return \Google\Cloud\Compute\V1\FutureReservationTimeWindow|null + */ + public function getTimeWindow() + { + return $this->time_window; + } + + public function hasTimeWindow() + { + return isset($this->time_window); + } + + public function clearTimeWindow() + { + unset($this->time_window); + } + + /** + * Time window for this Future Reservation. + * + * Generated from protobuf field optional .google.cloud.compute.v1.FutureReservationTimeWindow time_window = 422983074; + * @param \Google\Cloud\Compute\V1\FutureReservationTimeWindow $var + * @return $this + */ + public function setTimeWindow($var) + { + GPBUtil::checkMessage($var, \Google\Cloud\Compute\V1\FutureReservationTimeWindow::class); + $this->time_window = $var; + + return $this; + } + + /** + * [Output Only] URL of the Zone where this future reservation resides. + * + * Generated from protobuf field optional string zone = 3744684; + * @return string + */ + public function getZone() + { + return isset($this->zone) ? $this->zone : ''; + } + + public function hasZone() + { + return isset($this->zone); + } + + public function clearZone() + { + unset($this->zone); + } + + /** + * [Output Only] URL of the Zone where this future reservation resides. + * + * Generated from protobuf field optional string zone = 3744684; + * @param string $var + * @return $this + */ + public function setZone($var) + { + GPBUtil::checkString($var, True); + $this->zone = $var; + + return $this; + } + +} + diff --git a/Compute/src/V1/FutureReservation/DeploymentType.php b/Compute/src/V1/FutureReservation/DeploymentType.php new file mode 100644 index 000000000000..92034f684919 --- /dev/null +++ b/Compute/src/V1/FutureReservation/DeploymentType.php @@ -0,0 +1,60 @@ +google.cloud.compute.v1.FutureReservation.DeploymentType + */ +class DeploymentType +{ + /** + * A value indicating that the enum field is not set. + * + * Generated from protobuf enum UNDEFINED_DEPLOYMENT_TYPE = 0; + */ + const UNDEFINED_DEPLOYMENT_TYPE = 0; + /** + * The reserved capacity is made up of densely deployed reservation blocks. + * + * Generated from protobuf enum DENSE = 64932607; + */ + const DENSE = 64932607; + /** + * Generated from protobuf enum DEPLOYMENT_TYPE_UNSPECIFIED = 234847180; + */ + const DEPLOYMENT_TYPE_UNSPECIFIED = 234847180; + + private static $valueToName = [ + self::UNDEFINED_DEPLOYMENT_TYPE => 'UNDEFINED_DEPLOYMENT_TYPE', + self::DENSE => 'DENSE', + self::DEPLOYMENT_TYPE_UNSPECIFIED => 'DEPLOYMENT_TYPE_UNSPECIFIED', + ]; + + public static function name($value) + { + if (!isset(self::$valueToName[$value])) { + throw new UnexpectedValueException(sprintf( + 'Enum %s has no name defined for value %s', __CLASS__, $value)); + } + return self::$valueToName[$value]; + } + + + public static function value($name) + { + $const = __CLASS__ . '::' . strtoupper($name); + if (!defined($const)) { + throw new UnexpectedValueException(sprintf( + 'Enum %s has no value defined for name %s', __CLASS__, $name)); + } + return constant($const); + } +} + + diff --git a/Compute/src/V1/FutureReservation/PlanningStatus.php b/Compute/src/V1/FutureReservation/PlanningStatus.php new file mode 100644 index 000000000000..cdabf63f661a --- /dev/null +++ b/Compute/src/V1/FutureReservation/PlanningStatus.php @@ -0,0 +1,67 @@ +google.cloud.compute.v1.FutureReservation.PlanningStatus + */ +class PlanningStatus +{ + /** + * A value indicating that the enum field is not set. + * + * Generated from protobuf enum UNDEFINED_PLANNING_STATUS = 0; + */ + const UNDEFINED_PLANNING_STATUS = 0; + /** + * Future Reservation is being drafted. + * + * Generated from protobuf enum DRAFT = 65307009; + */ + const DRAFT = 65307009; + /** + * Generated from protobuf enum PLANNING_STATUS_UNSPECIFIED = 252728940; + */ + const PLANNING_STATUS_UNSPECIFIED = 252728940; + /** + * Future Reservation has been submitted for evaluation by GCP. + * + * Generated from protobuf enum SUBMITTED = 450918619; + */ + const SUBMITTED = 450918619; + + private static $valueToName = [ + self::UNDEFINED_PLANNING_STATUS => 'UNDEFINED_PLANNING_STATUS', + self::DRAFT => 'DRAFT', + self::PLANNING_STATUS_UNSPECIFIED => 'PLANNING_STATUS_UNSPECIFIED', + self::SUBMITTED => 'SUBMITTED', + ]; + + public static function name($value) + { + if (!isset(self::$valueToName[$value])) { + throw new UnexpectedValueException(sprintf( + 'Enum %s has no name defined for value %s', __CLASS__, $value)); + } + return self::$valueToName[$value]; + } + + + public static function value($name) + { + $const = __CLASS__ . '::' . strtoupper($name); + if (!defined($const)) { + throw new UnexpectedValueException(sprintf( + 'Enum %s has no value defined for name %s', __CLASS__, $name)); + } + return constant($const); + } +} + + diff --git a/Compute/src/V1/FutureReservation/ReservationMode.php b/Compute/src/V1/FutureReservation/ReservationMode.php new file mode 100644 index 000000000000..39dbf7245cb4 --- /dev/null +++ b/Compute/src/V1/FutureReservation/ReservationMode.php @@ -0,0 +1,75 @@ +google.cloud.compute.v1.FutureReservation.ReservationMode + */ +class ReservationMode +{ + /** + * A value indicating that the enum field is not set. + * + * Generated from protobuf enum UNDEFINED_RESERVATION_MODE = 0; + */ + const UNDEFINED_RESERVATION_MODE = 0; + /** + * The delivered reservations will delivered at specified start time and + * terminated at specified end time along with terminating the VMs running + * on it. + * + * Generated from protobuf enum CALENDAR = 67431230; + */ + const CALENDAR = 67431230; + /** + * The delivered reservations do not terminate VMs at the end of + * reservations. This is default mode. + * + * Generated from protobuf enum DEFAULT = 115302945; + */ + const PBDEFAULT = 115302945; + /** + * Generated from protobuf enum RESERVATION_MODE_UNSPECIFIED = 233810606; + */ + const RESERVATION_MODE_UNSPECIFIED = 233810606; + + private static $valueToName = [ + self::UNDEFINED_RESERVATION_MODE => 'UNDEFINED_RESERVATION_MODE', + self::CALENDAR => 'CALENDAR', + self::PBDEFAULT => 'DEFAULT', + self::RESERVATION_MODE_UNSPECIFIED => 'RESERVATION_MODE_UNSPECIFIED', + ]; + + public static function name($value) + { + if (!isset(self::$valueToName[$value])) { + throw new UnexpectedValueException(sprintf( + 'Enum %s has no name defined for value %s', __CLASS__, $value)); + } + return self::$valueToName[$value]; + } + + + public static function value($name) + { + $const = __CLASS__ . '::' . strtoupper($name); + if (!defined($const)) { + $pbconst = __CLASS__. '::PB' . strtoupper($name); + if (!defined($pbconst)) { + throw new UnexpectedValueException(sprintf( + 'Enum %s has no value defined for name %s', __CLASS__, $name)); + } + return constant($pbconst); + } + return constant($const); + } +} + + diff --git a/Compute/src/V1/FutureReservation/SchedulingType.php b/Compute/src/V1/FutureReservation/SchedulingType.php new file mode 100644 index 000000000000..ae491e892e6b --- /dev/null +++ b/Compute/src/V1/FutureReservation/SchedulingType.php @@ -0,0 +1,70 @@ +google.cloud.compute.v1.FutureReservation.SchedulingType + */ +class SchedulingType +{ + /** + * A value indicating that the enum field is not set. + * + * Generated from protobuf enum UNDEFINED_SCHEDULING_TYPE = 0; + */ + const UNDEFINED_SCHEDULING_TYPE = 0; + /** + * Maintenance on all reserved instances in the reservation is synchronized. + * + * Generated from protobuf enum GROUPED = 474540862; + */ + const GROUPED = 474540862; + /** + * Unknown maintenance type. + * + * Generated from protobuf enum GROUP_MAINTENANCE_TYPE_UNSPECIFIED = 447183678; + */ + const GROUP_MAINTENANCE_TYPE_UNSPECIFIED = 447183678; + /** + * Maintenance is not synchronized for this reservation. Instead, each + * instance has its own maintenance window. + * + * Generated from protobuf enum INDEPENDENT = 127011674; + */ + const INDEPENDENT = 127011674; + + private static $valueToName = [ + self::UNDEFINED_SCHEDULING_TYPE => 'UNDEFINED_SCHEDULING_TYPE', + self::GROUPED => 'GROUPED', + self::GROUP_MAINTENANCE_TYPE_UNSPECIFIED => 'GROUP_MAINTENANCE_TYPE_UNSPECIFIED', + self::INDEPENDENT => 'INDEPENDENT', + ]; + + public static function name($value) + { + if (!isset(self::$valueToName[$value])) { + throw new UnexpectedValueException(sprintf( + 'Enum %s has no name defined for value %s', __CLASS__, $value)); + } + return self::$valueToName[$value]; + } + + + public static function value($name) + { + $const = __CLASS__ . '::' . strtoupper($name); + if (!defined($const)) { + throw new UnexpectedValueException(sprintf( + 'Enum %s has no value defined for name %s', __CLASS__, $name)); + } + return constant($const); + } +} + + diff --git a/Compute/src/V1/FutureReservationCommitmentInfo.php b/Compute/src/V1/FutureReservationCommitmentInfo.php new file mode 100644 index 000000000000..2530947aee96 --- /dev/null +++ b/Compute/src/V1/FutureReservationCommitmentInfo.php @@ -0,0 +1,188 @@ +google.cloud.compute.v1.FutureReservationCommitmentInfo + */ +class FutureReservationCommitmentInfo extends \Google\Protobuf\Internal\Message +{ + /** + * name of the commitment where capacity is being delivered to. + * + * Generated from protobuf field optional string commitment_name = 164498805; + */ + protected $commitment_name = null; + /** + * Indicates if a Commitment needs to be created as part of FR delivery. If + * this field is not present, then no + * commitment needs to be created. + * Check the CommitmentPlan enum for the list of possible values. + * + * Generated from protobuf field optional string commitment_plan = 164568595; + */ + protected $commitment_plan = null; + /** + * Only applicable if FR is delivering to the same reservation. If set, all + * parent commitments will be extended to match the end date of the plan for + * this commitment. + * Check the PreviousCommitmentTerms enum for the list of possible values. + * + * Generated from protobuf field optional string previous_commitment_terms = 447490085; + */ + protected $previous_commitment_terms = null; + + /** + * Constructor. + * + * @param array $data { + * Optional. Data for populating the Message object. + * + * @type string $commitment_name + * name of the commitment where capacity is being delivered to. + * @type string $commitment_plan + * Indicates if a Commitment needs to be created as part of FR delivery. If + * this field is not present, then no + * commitment needs to be created. + * Check the CommitmentPlan enum for the list of possible values. + * @type string $previous_commitment_terms + * Only applicable if FR is delivering to the same reservation. If set, all + * parent commitments will be extended to match the end date of the plan for + * this commitment. + * Check the PreviousCommitmentTerms enum for the list of possible values. + * } + */ + public function __construct($data = NULL) { + \GPBMetadata\Google\Cloud\Compute\V1\Compute::initOnce(); + parent::__construct($data); + } + + /** + * name of the commitment where capacity is being delivered to. + * + * Generated from protobuf field optional string commitment_name = 164498805; + * @return string + */ + public function getCommitmentName() + { + return isset($this->commitment_name) ? $this->commitment_name : ''; + } + + public function hasCommitmentName() + { + return isset($this->commitment_name); + } + + public function clearCommitmentName() + { + unset($this->commitment_name); + } + + /** + * name of the commitment where capacity is being delivered to. + * + * Generated from protobuf field optional string commitment_name = 164498805; + * @param string $var + * @return $this + */ + public function setCommitmentName($var) + { + GPBUtil::checkString($var, True); + $this->commitment_name = $var; + + return $this; + } + + /** + * Indicates if a Commitment needs to be created as part of FR delivery. If + * this field is not present, then no + * commitment needs to be created. + * Check the CommitmentPlan enum for the list of possible values. + * + * Generated from protobuf field optional string commitment_plan = 164568595; + * @return string + */ + public function getCommitmentPlan() + { + return isset($this->commitment_plan) ? $this->commitment_plan : ''; + } + + public function hasCommitmentPlan() + { + return isset($this->commitment_plan); + } + + public function clearCommitmentPlan() + { + unset($this->commitment_plan); + } + + /** + * Indicates if a Commitment needs to be created as part of FR delivery. If + * this field is not present, then no + * commitment needs to be created. + * Check the CommitmentPlan enum for the list of possible values. + * + * Generated from protobuf field optional string commitment_plan = 164568595; + * @param string $var + * @return $this + */ + public function setCommitmentPlan($var) + { + GPBUtil::checkString($var, True); + $this->commitment_plan = $var; + + return $this; + } + + /** + * Only applicable if FR is delivering to the same reservation. If set, all + * parent commitments will be extended to match the end date of the plan for + * this commitment. + * Check the PreviousCommitmentTerms enum for the list of possible values. + * + * Generated from protobuf field optional string previous_commitment_terms = 447490085; + * @return string + */ + public function getPreviousCommitmentTerms() + { + return isset($this->previous_commitment_terms) ? $this->previous_commitment_terms : ''; + } + + public function hasPreviousCommitmentTerms() + { + return isset($this->previous_commitment_terms); + } + + public function clearPreviousCommitmentTerms() + { + unset($this->previous_commitment_terms); + } + + /** + * Only applicable if FR is delivering to the same reservation. If set, all + * parent commitments will be extended to match the end date of the plan for + * this commitment. + * Check the PreviousCommitmentTerms enum for the list of possible values. + * + * Generated from protobuf field optional string previous_commitment_terms = 447490085; + * @param string $var + * @return $this + */ + public function setPreviousCommitmentTerms($var) + { + GPBUtil::checkString($var, True); + $this->previous_commitment_terms = $var; + + return $this; + } + +} + diff --git a/Compute/src/V1/FutureReservationCommitmentInfo/CommitmentPlan.php b/Compute/src/V1/FutureReservationCommitmentInfo/CommitmentPlan.php new file mode 100644 index 000000000000..88c258f00573 --- /dev/null +++ b/Compute/src/V1/FutureReservationCommitmentInfo/CommitmentPlan.php @@ -0,0 +1,65 @@ +google.cloud.compute.v1.FutureReservationCommitmentInfo.CommitmentPlan + */ +class CommitmentPlan +{ + /** + * A value indicating that the enum field is not set. + * + * Generated from protobuf enum UNDEFINED_COMMITMENT_PLAN = 0; + */ + const UNDEFINED_COMMITMENT_PLAN = 0; + /** + * Generated from protobuf enum INVALID = 530283991; + */ + const INVALID = 530283991; + /** + * Generated from protobuf enum THIRTY_SIX_MONTH = 266295942; + */ + const THIRTY_SIX_MONTH = 266295942; + /** + * Generated from protobuf enum TWELVE_MONTH = 173083962; + */ + const TWELVE_MONTH = 173083962; + + private static $valueToName = [ + self::UNDEFINED_COMMITMENT_PLAN => 'UNDEFINED_COMMITMENT_PLAN', + self::INVALID => 'INVALID', + self::THIRTY_SIX_MONTH => 'THIRTY_SIX_MONTH', + self::TWELVE_MONTH => 'TWELVE_MONTH', + ]; + + public static function name($value) + { + if (!isset(self::$valueToName[$value])) { + throw new UnexpectedValueException(sprintf( + 'Enum %s has no name defined for value %s', __CLASS__, $value)); + } + return self::$valueToName[$value]; + } + + + public static function value($name) + { + $const = __CLASS__ . '::' . strtoupper($name); + if (!defined($const)) { + throw new UnexpectedValueException(sprintf( + 'Enum %s has no value defined for name %s', __CLASS__, $name)); + } + return constant($const); + } +} + + diff --git a/Compute/src/V1/FutureReservationCommitmentInfo/PreviousCommitmentTerms.php b/Compute/src/V1/FutureReservationCommitmentInfo/PreviousCommitmentTerms.php new file mode 100644 index 000000000000..e98acc3ca038 --- /dev/null +++ b/Compute/src/V1/FutureReservationCommitmentInfo/PreviousCommitmentTerms.php @@ -0,0 +1,66 @@ +google.cloud.compute.v1.FutureReservationCommitmentInfo.PreviousCommitmentTerms + */ +class PreviousCommitmentTerms +{ + /** + * A value indicating that the enum field is not set. + * + * Generated from protobuf enum UNDEFINED_PREVIOUS_COMMITMENT_TERMS = 0; + */ + const UNDEFINED_PREVIOUS_COMMITMENT_TERMS = 0; + /** + * All associated parent Committed Used Discount(s) end-date/term will be + * extended to the end-time of this future reservation. Default is to + * extend previous commitment(s) time to the end_time of the reservation. + * + * Generated from protobuf enum EXTEND = 448639770; + */ + const EXTEND = 448639770; + /** + * No changes to associated parents Committed Used Discount(s) terms. + * + * Generated from protobuf enum PREVIOUSCOMMITMENTTERM_UNSPECIFIED = 98482448; + */ + const PREVIOUSCOMMITMENTTERM_UNSPECIFIED = 98482448; + + private static $valueToName = [ + self::UNDEFINED_PREVIOUS_COMMITMENT_TERMS => 'UNDEFINED_PREVIOUS_COMMITMENT_TERMS', + self::EXTEND => 'EXTEND', + self::PREVIOUSCOMMITMENTTERM_UNSPECIFIED => 'PREVIOUSCOMMITMENTTERM_UNSPECIFIED', + ]; + + public static function name($value) + { + if (!isset(self::$valueToName[$value])) { + throw new UnexpectedValueException(sprintf( + 'Enum %s has no name defined for value %s', __CLASS__, $value)); + } + return self::$valueToName[$value]; + } + + + public static function value($name) + { + $const = __CLASS__ . '::' . strtoupper($name); + if (!defined($const)) { + throw new UnexpectedValueException(sprintf( + 'Enum %s has no value defined for name %s', __CLASS__, $name)); + } + return constant($const); + } +} + + diff --git a/Compute/src/V1/FutureReservationSpecificSKUProperties.php b/Compute/src/V1/FutureReservationSpecificSKUProperties.php new file mode 100644 index 000000000000..78209d77331f --- /dev/null +++ b/Compute/src/V1/FutureReservationSpecificSKUProperties.php @@ -0,0 +1,172 @@ +google.cloud.compute.v1.FutureReservationSpecificSKUProperties + */ +class FutureReservationSpecificSKUProperties extends \Google\Protobuf\Internal\Message +{ + /** + * Properties of the SKU instances being reserved. + * + * Generated from protobuf field optional .google.cloud.compute.v1.AllocationSpecificSKUAllocationReservedInstanceProperties instance_properties = 215355165; + */ + protected $instance_properties = null; + /** + * The instance template that will be used to populate the + * ReservedInstanceProperties of the future reservation + * + * Generated from protobuf field optional string source_instance_template = 332423616; + */ + protected $source_instance_template = null; + /** + * Total number of instances for which capacity assurance is requested at a + * future time period. + * + * Generated from protobuf field optional int64 total_count = 129109076; + */ + protected $total_count = null; + + /** + * Constructor. + * + * @param array $data { + * Optional. Data for populating the Message object. + * + * @type \Google\Cloud\Compute\V1\AllocationSpecificSKUAllocationReservedInstanceProperties $instance_properties + * Properties of the SKU instances being reserved. + * @type string $source_instance_template + * The instance template that will be used to populate the + * ReservedInstanceProperties of the future reservation + * @type int|string $total_count + * Total number of instances for which capacity assurance is requested at a + * future time period. + * } + */ + public function __construct($data = NULL) { + \GPBMetadata\Google\Cloud\Compute\V1\Compute::initOnce(); + parent::__construct($data); + } + + /** + * Properties of the SKU instances being reserved. + * + * Generated from protobuf field optional .google.cloud.compute.v1.AllocationSpecificSKUAllocationReservedInstanceProperties instance_properties = 215355165; + * @return \Google\Cloud\Compute\V1\AllocationSpecificSKUAllocationReservedInstanceProperties|null + */ + public function getInstanceProperties() + { + return $this->instance_properties; + } + + public function hasInstanceProperties() + { + return isset($this->instance_properties); + } + + public function clearInstanceProperties() + { + unset($this->instance_properties); + } + + /** + * Properties of the SKU instances being reserved. + * + * Generated from protobuf field optional .google.cloud.compute.v1.AllocationSpecificSKUAllocationReservedInstanceProperties instance_properties = 215355165; + * @param \Google\Cloud\Compute\V1\AllocationSpecificSKUAllocationReservedInstanceProperties $var + * @return $this + */ + public function setInstanceProperties($var) + { + GPBUtil::checkMessage($var, \Google\Cloud\Compute\V1\AllocationSpecificSKUAllocationReservedInstanceProperties::class); + $this->instance_properties = $var; + + return $this; + } + + /** + * The instance template that will be used to populate the + * ReservedInstanceProperties of the future reservation + * + * Generated from protobuf field optional string source_instance_template = 332423616; + * @return string + */ + public function getSourceInstanceTemplate() + { + return isset($this->source_instance_template) ? $this->source_instance_template : ''; + } + + public function hasSourceInstanceTemplate() + { + return isset($this->source_instance_template); + } + + public function clearSourceInstanceTemplate() + { + unset($this->source_instance_template); + } + + /** + * The instance template that will be used to populate the + * ReservedInstanceProperties of the future reservation + * + * Generated from protobuf field optional string source_instance_template = 332423616; + * @param string $var + * @return $this + */ + public function setSourceInstanceTemplate($var) + { + GPBUtil::checkString($var, True); + $this->source_instance_template = $var; + + return $this; + } + + /** + * Total number of instances for which capacity assurance is requested at a + * future time period. + * + * Generated from protobuf field optional int64 total_count = 129109076; + * @return int|string + */ + public function getTotalCount() + { + return isset($this->total_count) ? $this->total_count : 0; + } + + public function hasTotalCount() + { + return isset($this->total_count); + } + + public function clearTotalCount() + { + unset($this->total_count); + } + + /** + * Total number of instances for which capacity assurance is requested at a + * future time period. + * + * Generated from protobuf field optional int64 total_count = 129109076; + * @param int|string $var + * @return $this + */ + public function setTotalCount($var) + { + GPBUtil::checkInt64($var); + $this->total_count = $var; + + return $this; + } + +} + diff --git a/Compute/src/V1/FutureReservationStatus.php b/Compute/src/V1/FutureReservationStatus.php new file mode 100644 index 000000000000..61515ed3e0c3 --- /dev/null +++ b/Compute/src/V1/FutureReservationStatus.php @@ -0,0 +1,424 @@ +google.cloud.compute.v1.FutureReservationStatus + */ +class FutureReservationStatus extends \Google\Protobuf\Internal\Message +{ + /** + * [Output Only] The current status of the requested amendment. + * Check the AmendmentStatus enum for the list of possible values. + * + * Generated from protobuf field optional string amendment_status = 250270052; + */ + protected $amendment_status = null; + /** + * Fully qualified urls of the automatically created reservations at + * start_time. + * + * Generated from protobuf field repeated string auto_created_reservations = 140217006; + */ + private $auto_created_reservations; + /** + * [Output Only] Represents the existing matching usage for the future + * reservation. + * + * Generated from protobuf field optional .google.cloud.compute.v1.FutureReservationStatusExistingMatchingUsageInfo existing_matching_usage_info = 509920602; + */ + protected $existing_matching_usage_info = null; + /** + * This count indicates the fulfilled capacity so far. This is set during + * "PROVISIONING" state. This count also includes capacity delivered as part + * of existing matching reservations. + * + * Generated from protobuf field optional int64 fulfilled_count = 319392239; + */ + protected $fulfilled_count = null; + /** + * [Output Only] This field represents the future reservation before an + * amendment was requested. If the amendment is declined, the Future + * Reservation will be reverted to the last known good state. The last known + * good state is not set when updating a future reservation whose + * Procurement Status is DRAFTING. + * + * Generated from protobuf field optional .google.cloud.compute.v1.FutureReservationStatusLastKnownGoodState last_known_good_state = 192819092; + */ + protected $last_known_good_state = null; + /** + * Time when Future Reservation would become LOCKED, after which no + * modifications to Future Reservation will be allowed. Applicable only + * after the Future Reservation is in the APPROVED state. The lock_time is + * an RFC3339 string. The procurement_status will transition to PROCURING + * state at this time. + * + * Generated from protobuf field optional string lock_time = 143772001; + */ + protected $lock_time = null; + /** + * Current state of this Future Reservation + * Check the ProcurementStatus enum for the list of possible values. + * + * Generated from protobuf field optional string procurement_status = 224718945; + */ + protected $procurement_status = null; + /** + * Generated from protobuf field optional .google.cloud.compute.v1.FutureReservationStatusSpecificSKUProperties specific_sku_properties = 108887106; + */ + protected $specific_sku_properties = null; + + /** + * Constructor. + * + * @param array $data { + * Optional. Data for populating the Message object. + * + * @type string $amendment_status + * [Output Only] The current status of the requested amendment. + * Check the AmendmentStatus enum for the list of possible values. + * @type array|\Google\Protobuf\Internal\RepeatedField $auto_created_reservations + * Fully qualified urls of the automatically created reservations at + * start_time. + * @type \Google\Cloud\Compute\V1\FutureReservationStatusExistingMatchingUsageInfo $existing_matching_usage_info + * [Output Only] Represents the existing matching usage for the future + * reservation. + * @type int|string $fulfilled_count + * This count indicates the fulfilled capacity so far. This is set during + * "PROVISIONING" state. This count also includes capacity delivered as part + * of existing matching reservations. + * @type \Google\Cloud\Compute\V1\FutureReservationStatusLastKnownGoodState $last_known_good_state + * [Output Only] This field represents the future reservation before an + * amendment was requested. If the amendment is declined, the Future + * Reservation will be reverted to the last known good state. The last known + * good state is not set when updating a future reservation whose + * Procurement Status is DRAFTING. + * @type string $lock_time + * Time when Future Reservation would become LOCKED, after which no + * modifications to Future Reservation will be allowed. Applicable only + * after the Future Reservation is in the APPROVED state. The lock_time is + * an RFC3339 string. The procurement_status will transition to PROCURING + * state at this time. + * @type string $procurement_status + * Current state of this Future Reservation + * Check the ProcurementStatus enum for the list of possible values. + * @type \Google\Cloud\Compute\V1\FutureReservationStatusSpecificSKUProperties $specific_sku_properties + * } + */ + public function __construct($data = NULL) { + \GPBMetadata\Google\Cloud\Compute\V1\Compute::initOnce(); + parent::__construct($data); + } + + /** + * [Output Only] The current status of the requested amendment. + * Check the AmendmentStatus enum for the list of possible values. + * + * Generated from protobuf field optional string amendment_status = 250270052; + * @return string + */ + public function getAmendmentStatus() + { + return isset($this->amendment_status) ? $this->amendment_status : ''; + } + + public function hasAmendmentStatus() + { + return isset($this->amendment_status); + } + + public function clearAmendmentStatus() + { + unset($this->amendment_status); + } + + /** + * [Output Only] The current status of the requested amendment. + * Check the AmendmentStatus enum for the list of possible values. + * + * Generated from protobuf field optional string amendment_status = 250270052; + * @param string $var + * @return $this + */ + public function setAmendmentStatus($var) + { + GPBUtil::checkString($var, True); + $this->amendment_status = $var; + + return $this; + } + + /** + * Fully qualified urls of the automatically created reservations at + * start_time. + * + * Generated from protobuf field repeated string auto_created_reservations = 140217006; + * @return \Google\Protobuf\Internal\RepeatedField + */ + public function getAutoCreatedReservations() + { + return $this->auto_created_reservations; + } + + /** + * Fully qualified urls of the automatically created reservations at + * start_time. + * + * Generated from protobuf field repeated string auto_created_reservations = 140217006; + * @param array|\Google\Protobuf\Internal\RepeatedField $var + * @return $this + */ + public function setAutoCreatedReservations($var) + { + $arr = GPBUtil::checkRepeatedField($var, \Google\Protobuf\Internal\GPBType::STRING); + $this->auto_created_reservations = $arr; + + return $this; + } + + /** + * [Output Only] Represents the existing matching usage for the future + * reservation. + * + * Generated from protobuf field optional .google.cloud.compute.v1.FutureReservationStatusExistingMatchingUsageInfo existing_matching_usage_info = 509920602; + * @return \Google\Cloud\Compute\V1\FutureReservationStatusExistingMatchingUsageInfo|null + */ + public function getExistingMatchingUsageInfo() + { + return $this->existing_matching_usage_info; + } + + public function hasExistingMatchingUsageInfo() + { + return isset($this->existing_matching_usage_info); + } + + public function clearExistingMatchingUsageInfo() + { + unset($this->existing_matching_usage_info); + } + + /** + * [Output Only] Represents the existing matching usage for the future + * reservation. + * + * Generated from protobuf field optional .google.cloud.compute.v1.FutureReservationStatusExistingMatchingUsageInfo existing_matching_usage_info = 509920602; + * @param \Google\Cloud\Compute\V1\FutureReservationStatusExistingMatchingUsageInfo $var + * @return $this + */ + public function setExistingMatchingUsageInfo($var) + { + GPBUtil::checkMessage($var, \Google\Cloud\Compute\V1\FutureReservationStatusExistingMatchingUsageInfo::class); + $this->existing_matching_usage_info = $var; + + return $this; + } + + /** + * This count indicates the fulfilled capacity so far. This is set during + * "PROVISIONING" state. This count also includes capacity delivered as part + * of existing matching reservations. + * + * Generated from protobuf field optional int64 fulfilled_count = 319392239; + * @return int|string + */ + public function getFulfilledCount() + { + return isset($this->fulfilled_count) ? $this->fulfilled_count : 0; + } + + public function hasFulfilledCount() + { + return isset($this->fulfilled_count); + } + + public function clearFulfilledCount() + { + unset($this->fulfilled_count); + } + + /** + * This count indicates the fulfilled capacity so far. This is set during + * "PROVISIONING" state. This count also includes capacity delivered as part + * of existing matching reservations. + * + * Generated from protobuf field optional int64 fulfilled_count = 319392239; + * @param int|string $var + * @return $this + */ + public function setFulfilledCount($var) + { + GPBUtil::checkInt64($var); + $this->fulfilled_count = $var; + + return $this; + } + + /** + * [Output Only] This field represents the future reservation before an + * amendment was requested. If the amendment is declined, the Future + * Reservation will be reverted to the last known good state. The last known + * good state is not set when updating a future reservation whose + * Procurement Status is DRAFTING. + * + * Generated from protobuf field optional .google.cloud.compute.v1.FutureReservationStatusLastKnownGoodState last_known_good_state = 192819092; + * @return \Google\Cloud\Compute\V1\FutureReservationStatusLastKnownGoodState|null + */ + public function getLastKnownGoodState() + { + return $this->last_known_good_state; + } + + public function hasLastKnownGoodState() + { + return isset($this->last_known_good_state); + } + + public function clearLastKnownGoodState() + { + unset($this->last_known_good_state); + } + + /** + * [Output Only] This field represents the future reservation before an + * amendment was requested. If the amendment is declined, the Future + * Reservation will be reverted to the last known good state. The last known + * good state is not set when updating a future reservation whose + * Procurement Status is DRAFTING. + * + * Generated from protobuf field optional .google.cloud.compute.v1.FutureReservationStatusLastKnownGoodState last_known_good_state = 192819092; + * @param \Google\Cloud\Compute\V1\FutureReservationStatusLastKnownGoodState $var + * @return $this + */ + public function setLastKnownGoodState($var) + { + GPBUtil::checkMessage($var, \Google\Cloud\Compute\V1\FutureReservationStatusLastKnownGoodState::class); + $this->last_known_good_state = $var; + + return $this; + } + + /** + * Time when Future Reservation would become LOCKED, after which no + * modifications to Future Reservation will be allowed. Applicable only + * after the Future Reservation is in the APPROVED state. The lock_time is + * an RFC3339 string. The procurement_status will transition to PROCURING + * state at this time. + * + * Generated from protobuf field optional string lock_time = 143772001; + * @return string + */ + public function getLockTime() + { + return isset($this->lock_time) ? $this->lock_time : ''; + } + + public function hasLockTime() + { + return isset($this->lock_time); + } + + public function clearLockTime() + { + unset($this->lock_time); + } + + /** + * Time when Future Reservation would become LOCKED, after which no + * modifications to Future Reservation will be allowed. Applicable only + * after the Future Reservation is in the APPROVED state. The lock_time is + * an RFC3339 string. The procurement_status will transition to PROCURING + * state at this time. + * + * Generated from protobuf field optional string lock_time = 143772001; + * @param string $var + * @return $this + */ + public function setLockTime($var) + { + GPBUtil::checkString($var, True); + $this->lock_time = $var; + + return $this; + } + + /** + * Current state of this Future Reservation + * Check the ProcurementStatus enum for the list of possible values. + * + * Generated from protobuf field optional string procurement_status = 224718945; + * @return string + */ + public function getProcurementStatus() + { + return isset($this->procurement_status) ? $this->procurement_status : ''; + } + + public function hasProcurementStatus() + { + return isset($this->procurement_status); + } + + public function clearProcurementStatus() + { + unset($this->procurement_status); + } + + /** + * Current state of this Future Reservation + * Check the ProcurementStatus enum for the list of possible values. + * + * Generated from protobuf field optional string procurement_status = 224718945; + * @param string $var + * @return $this + */ + public function setProcurementStatus($var) + { + GPBUtil::checkString($var, True); + $this->procurement_status = $var; + + return $this; + } + + /** + * Generated from protobuf field optional .google.cloud.compute.v1.FutureReservationStatusSpecificSKUProperties specific_sku_properties = 108887106; + * @return \Google\Cloud\Compute\V1\FutureReservationStatusSpecificSKUProperties|null + */ + public function getSpecificSkuProperties() + { + return $this->specific_sku_properties; + } + + public function hasSpecificSkuProperties() + { + return isset($this->specific_sku_properties); + } + + public function clearSpecificSkuProperties() + { + unset($this->specific_sku_properties); + } + + /** + * Generated from protobuf field optional .google.cloud.compute.v1.FutureReservationStatusSpecificSKUProperties specific_sku_properties = 108887106; + * @param \Google\Cloud\Compute\V1\FutureReservationStatusSpecificSKUProperties $var + * @return $this + */ + public function setSpecificSkuProperties($var) + { + GPBUtil::checkMessage($var, \Google\Cloud\Compute\V1\FutureReservationStatusSpecificSKUProperties::class); + $this->specific_sku_properties = $var; + + return $this; + } + +} + diff --git a/Compute/src/V1/FutureReservationStatus/AmendmentStatus.php b/Compute/src/V1/FutureReservationStatus/AmendmentStatus.php new file mode 100644 index 000000000000..9934b4848e07 --- /dev/null +++ b/Compute/src/V1/FutureReservationStatus/AmendmentStatus.php @@ -0,0 +1,77 @@ +google.cloud.compute.v1.FutureReservationStatus.AmendmentStatus + */ +class AmendmentStatus +{ + /** + * A value indicating that the enum field is not set. + * + * Generated from protobuf enum UNDEFINED_AMENDMENT_STATUS = 0; + */ + const UNDEFINED_AMENDMENT_STATUS = 0; + /** + * The requested amendment to the Future Resevation has been approved and + * applied by GCP. + * + * Generated from protobuf enum AMENDMENT_APPROVED = 150573001; + */ + const AMENDMENT_APPROVED = 150573001; + /** + * The requested amendment to the Future Reservation has been declined by + * GCP and the original state was restored. + * + * Generated from protobuf enum AMENDMENT_DECLINED = 70395200; + */ + const AMENDMENT_DECLINED = 70395200; + /** + * The requested amendment to the Future Reservation is currently being + * reviewd by GCP. + * + * Generated from protobuf enum AMENDMENT_IN_REVIEW = 25830624; + */ + const AMENDMENT_IN_REVIEW = 25830624; + /** + * Generated from protobuf enum AMENDMENT_STATUS_UNSPECIFIED = 412250332; + */ + const AMENDMENT_STATUS_UNSPECIFIED = 412250332; + + private static $valueToName = [ + self::UNDEFINED_AMENDMENT_STATUS => 'UNDEFINED_AMENDMENT_STATUS', + self::AMENDMENT_APPROVED => 'AMENDMENT_APPROVED', + self::AMENDMENT_DECLINED => 'AMENDMENT_DECLINED', + self::AMENDMENT_IN_REVIEW => 'AMENDMENT_IN_REVIEW', + self::AMENDMENT_STATUS_UNSPECIFIED => 'AMENDMENT_STATUS_UNSPECIFIED', + ]; + + public static function name($value) + { + if (!isset(self::$valueToName[$value])) { + throw new UnexpectedValueException(sprintf( + 'Enum %s has no name defined for value %s', __CLASS__, $value)); + } + return self::$valueToName[$value]; + } + + + public static function value($name) + { + $const = __CLASS__ . '::' . strtoupper($name); + if (!defined($const)) { + throw new UnexpectedValueException(sprintf( + 'Enum %s has no value defined for name %s', __CLASS__, $name)); + } + return constant($const); + } +} + + diff --git a/Compute/src/V1/FutureReservationStatus/ProcurementStatus.php b/Compute/src/V1/FutureReservationStatus/ProcurementStatus.php new file mode 100644 index 000000000000..a1dd62ed02f8 --- /dev/null +++ b/Compute/src/V1/FutureReservationStatus/ProcurementStatus.php @@ -0,0 +1,145 @@ +google.cloud.compute.v1.FutureReservationStatus.ProcurementStatus + */ +class ProcurementStatus +{ + /** + * A value indicating that the enum field is not set. + * + * Generated from protobuf enum UNDEFINED_PROCUREMENT_STATUS = 0; + */ + const UNDEFINED_PROCUREMENT_STATUS = 0; + /** + * Future reservation is approved by GCP. + * + * Generated from protobuf enum APPROVED = 357258935; + */ + const APPROVED = 357258935; + /** + * Future reservation is cancelled by the customer. + * + * Generated from protobuf enum CANCELLED = 41957681; + */ + const CANCELLED = 41957681; + /** + * Future reservation is committed by the customer. + * + * Generated from protobuf enum COMMITTED = 221710172; + */ + const COMMITTED = 221710172; + /** + * Future reservation is rejected by GCP. + * + * Generated from protobuf enum DECLINED = 277081134; + */ + const DECLINED = 277081134; + /** + * Related status for PlanningStatus.Draft. Transitions to + * PENDING_APPROVAL upon user submitting FR. + * + * Generated from protobuf enum DRAFTING = 477863585; + */ + const DRAFTING = 477863585; + /** + * Future reservation failed. No additional reservations were provided. + * + * Generated from protobuf enum FAILED = 455706685; + */ + const FAILED = 455706685; + /** + * Future reservation is partially fulfilled. Additional reservations were + * provided but did not reach total_count reserved instance slots. + * + * Generated from protobuf enum FAILED_PARTIALLY_FULFILLED = 14455212; + */ + const FAILED_PARTIALLY_FULFILLED = 14455212; + /** + * Future reservation is fulfilled completely. + * + * Generated from protobuf enum FULFILLED = 409958655; + */ + const FULFILLED = 409958655; + /** + * An Amendment to the Future Reservation has been requested. If the + * Amendment is declined, the Future Reservation will be restored to the + * last known good state. + * + * Generated from protobuf enum PENDING_AMENDMENT_APPROVAL = 510150429; + */ + const PENDING_AMENDMENT_APPROVAL = 510150429; + /** + * Future reservation is pending approval by GCP. + * + * Generated from protobuf enum PENDING_APPROVAL = 209692683; + */ + const PENDING_APPROVAL = 209692683; + /** + * Generated from protobuf enum PROCUREMENT_STATUS_UNSPECIFIED = 45807705; + */ + const PROCUREMENT_STATUS_UNSPECIFIED = 45807705; + /** + * Future reservation is being procured by GCP. Beyond this point, Future + * reservation is locked and no further modifications are allowed. + * + * Generated from protobuf enum PROCURING = 95959663; + */ + const PROCURING = 95959663; + /** + * Future reservation capacity is being provisioned. This state will be + * entered after start_time, while reservations are being created to + * provide total_count reserved instance slots. This state will not + * persist past start_time + 24h. + * + * Generated from protobuf enum PROVISIONING = 290896621; + */ + const PROVISIONING = 290896621; + + private static $valueToName = [ + self::UNDEFINED_PROCUREMENT_STATUS => 'UNDEFINED_PROCUREMENT_STATUS', + self::APPROVED => 'APPROVED', + self::CANCELLED => 'CANCELLED', + self::COMMITTED => 'COMMITTED', + self::DECLINED => 'DECLINED', + self::DRAFTING => 'DRAFTING', + self::FAILED => 'FAILED', + self::FAILED_PARTIALLY_FULFILLED => 'FAILED_PARTIALLY_FULFILLED', + self::FULFILLED => 'FULFILLED', + self::PENDING_AMENDMENT_APPROVAL => 'PENDING_AMENDMENT_APPROVAL', + self::PENDING_APPROVAL => 'PENDING_APPROVAL', + self::PROCUREMENT_STATUS_UNSPECIFIED => 'PROCUREMENT_STATUS_UNSPECIFIED', + self::PROCURING => 'PROCURING', + self::PROVISIONING => 'PROVISIONING', + ]; + + public static function name($value) + { + if (!isset(self::$valueToName[$value])) { + throw new UnexpectedValueException(sprintf( + 'Enum %s has no name defined for value %s', __CLASS__, $value)); + } + return self::$valueToName[$value]; + } + + + public static function value($name) + { + $const = __CLASS__ . '::' . strtoupper($name); + if (!defined($const)) { + throw new UnexpectedValueException(sprintf( + 'Enum %s has no value defined for name %s', __CLASS__, $name)); + } + return constant($const); + } +} + + diff --git a/Compute/src/V1/FutureReservationStatusExistingMatchingUsageInfo.php b/Compute/src/V1/FutureReservationStatusExistingMatchingUsageInfo.php new file mode 100644 index 000000000000..ccc89bd49e54 --- /dev/null +++ b/Compute/src/V1/FutureReservationStatusExistingMatchingUsageInfo.php @@ -0,0 +1,126 @@ +google.cloud.compute.v1.FutureReservationStatusExistingMatchingUsageInfo + */ +class FutureReservationStatusExistingMatchingUsageInfo extends \Google\Protobuf\Internal\Message +{ + /** + * Count to represent min(FR total_count, + * matching_reserved_capacity+matching_unreserved_instances) + * + * Generated from protobuf field optional int64 count = 94851343; + */ + protected $count = null; + /** + * Timestamp when the matching usage was calculated + * + * Generated from protobuf field optional string timestamp = 55126294; + */ + protected $timestamp = null; + + /** + * Constructor. + * + * @param array $data { + * Optional. Data for populating the Message object. + * + * @type int|string $count + * Count to represent min(FR total_count, + * matching_reserved_capacity+matching_unreserved_instances) + * @type string $timestamp + * Timestamp when the matching usage was calculated + * } + */ + public function __construct($data = NULL) { + \GPBMetadata\Google\Cloud\Compute\V1\Compute::initOnce(); + parent::__construct($data); + } + + /** + * Count to represent min(FR total_count, + * matching_reserved_capacity+matching_unreserved_instances) + * + * Generated from protobuf field optional int64 count = 94851343; + * @return int|string + */ + public function getCount() + { + return isset($this->count) ? $this->count : 0; + } + + public function hasCount() + { + return isset($this->count); + } + + public function clearCount() + { + unset($this->count); + } + + /** + * Count to represent min(FR total_count, + * matching_reserved_capacity+matching_unreserved_instances) + * + * Generated from protobuf field optional int64 count = 94851343; + * @param int|string $var + * @return $this + */ + public function setCount($var) + { + GPBUtil::checkInt64($var); + $this->count = $var; + + return $this; + } + + /** + * Timestamp when the matching usage was calculated + * + * Generated from protobuf field optional string timestamp = 55126294; + * @return string + */ + public function getTimestamp() + { + return isset($this->timestamp) ? $this->timestamp : ''; + } + + public function hasTimestamp() + { + return isset($this->timestamp); + } + + public function clearTimestamp() + { + unset($this->timestamp); + } + + /** + * Timestamp when the matching usage was calculated + * + * Generated from protobuf field optional string timestamp = 55126294; + * @param string $var + * @return $this + */ + public function setTimestamp($var) + { + GPBUtil::checkString($var, True); + $this->timestamp = $var; + + return $this; + } + +} + diff --git a/Compute/src/V1/FutureReservationStatusLastKnownGoodState.php b/Compute/src/V1/FutureReservationStatusLastKnownGoodState.php new file mode 100644 index 000000000000..c3b0b67e13e6 --- /dev/null +++ b/Compute/src/V1/FutureReservationStatusLastKnownGoodState.php @@ -0,0 +1,315 @@ +google.cloud.compute.v1.FutureReservationStatusLastKnownGoodState + */ +class FutureReservationStatusLastKnownGoodState extends \Google\Protobuf\Internal\Message +{ + /** + * [Output Only] The description of the FutureReservation before an + * amendment was requested. + * + * Generated from protobuf field optional string description = 422937596; + */ + protected $description = null; + /** + * [Output Only] Represents the matching usage for the future + * reservation before an amendment was requested. + * + * Generated from protobuf field optional .google.cloud.compute.v1.FutureReservationStatusExistingMatchingUsageInfo existing_matching_usage_info = 509920602; + */ + protected $existing_matching_usage_info = null; + /** + * Generated from protobuf field optional .google.cloud.compute.v1.FutureReservationStatusLastKnownGoodStateFutureReservationSpecs future_reservation_specs = 82528873; + */ + protected $future_reservation_specs = null; + /** + * [Output Only] The lock time of the FutureReservation before an + * amendment was requested. + * + * Generated from protobuf field optional string lock_time = 143772001; + */ + protected $lock_time = null; + /** + * [Output Only] The name prefix of the Future Reservation before an + * amendment was requested. + * + * Generated from protobuf field optional string name_prefix = 236409542; + */ + protected $name_prefix = null; + /** + * [Output Only] The status of the last known good state for the Future + * Reservation. + * Check the ProcurementStatus enum for the list of possible values. + * + * Generated from protobuf field optional string procurement_status = 224718945; + */ + protected $procurement_status = null; + + /** + * Constructor. + * + * @param array $data { + * Optional. Data for populating the Message object. + * + * @type string $description + * [Output Only] The description of the FutureReservation before an + * amendment was requested. + * @type \Google\Cloud\Compute\V1\FutureReservationStatusExistingMatchingUsageInfo $existing_matching_usage_info + * [Output Only] Represents the matching usage for the future + * reservation before an amendment was requested. + * @type \Google\Cloud\Compute\V1\FutureReservationStatusLastKnownGoodStateFutureReservationSpecs $future_reservation_specs + * @type string $lock_time + * [Output Only] The lock time of the FutureReservation before an + * amendment was requested. + * @type string $name_prefix + * [Output Only] The name prefix of the Future Reservation before an + * amendment was requested. + * @type string $procurement_status + * [Output Only] The status of the last known good state for the Future + * Reservation. + * Check the ProcurementStatus enum for the list of possible values. + * } + */ + public function __construct($data = NULL) { + \GPBMetadata\Google\Cloud\Compute\V1\Compute::initOnce(); + parent::__construct($data); + } + + /** + * [Output Only] The description of the FutureReservation before an + * amendment was requested. + * + * Generated from protobuf field optional string description = 422937596; + * @return string + */ + public function getDescription() + { + return isset($this->description) ? $this->description : ''; + } + + public function hasDescription() + { + return isset($this->description); + } + + public function clearDescription() + { + unset($this->description); + } + + /** + * [Output Only] The description of the FutureReservation before an + * amendment was requested. + * + * Generated from protobuf field optional string description = 422937596; + * @param string $var + * @return $this + */ + public function setDescription($var) + { + GPBUtil::checkString($var, True); + $this->description = $var; + + return $this; + } + + /** + * [Output Only] Represents the matching usage for the future + * reservation before an amendment was requested. + * + * Generated from protobuf field optional .google.cloud.compute.v1.FutureReservationStatusExistingMatchingUsageInfo existing_matching_usage_info = 509920602; + * @return \Google\Cloud\Compute\V1\FutureReservationStatusExistingMatchingUsageInfo|null + */ + public function getExistingMatchingUsageInfo() + { + return $this->existing_matching_usage_info; + } + + public function hasExistingMatchingUsageInfo() + { + return isset($this->existing_matching_usage_info); + } + + public function clearExistingMatchingUsageInfo() + { + unset($this->existing_matching_usage_info); + } + + /** + * [Output Only] Represents the matching usage for the future + * reservation before an amendment was requested. + * + * Generated from protobuf field optional .google.cloud.compute.v1.FutureReservationStatusExistingMatchingUsageInfo existing_matching_usage_info = 509920602; + * @param \Google\Cloud\Compute\V1\FutureReservationStatusExistingMatchingUsageInfo $var + * @return $this + */ + public function setExistingMatchingUsageInfo($var) + { + GPBUtil::checkMessage($var, \Google\Cloud\Compute\V1\FutureReservationStatusExistingMatchingUsageInfo::class); + $this->existing_matching_usage_info = $var; + + return $this; + } + + /** + * Generated from protobuf field optional .google.cloud.compute.v1.FutureReservationStatusLastKnownGoodStateFutureReservationSpecs future_reservation_specs = 82528873; + * @return \Google\Cloud\Compute\V1\FutureReservationStatusLastKnownGoodStateFutureReservationSpecs|null + */ + public function getFutureReservationSpecs() + { + return $this->future_reservation_specs; + } + + public function hasFutureReservationSpecs() + { + return isset($this->future_reservation_specs); + } + + public function clearFutureReservationSpecs() + { + unset($this->future_reservation_specs); + } + + /** + * Generated from protobuf field optional .google.cloud.compute.v1.FutureReservationStatusLastKnownGoodStateFutureReservationSpecs future_reservation_specs = 82528873; + * @param \Google\Cloud\Compute\V1\FutureReservationStatusLastKnownGoodStateFutureReservationSpecs $var + * @return $this + */ + public function setFutureReservationSpecs($var) + { + GPBUtil::checkMessage($var, \Google\Cloud\Compute\V1\FutureReservationStatusLastKnownGoodStateFutureReservationSpecs::class); + $this->future_reservation_specs = $var; + + return $this; + } + + /** + * [Output Only] The lock time of the FutureReservation before an + * amendment was requested. + * + * Generated from protobuf field optional string lock_time = 143772001; + * @return string + */ + public function getLockTime() + { + return isset($this->lock_time) ? $this->lock_time : ''; + } + + public function hasLockTime() + { + return isset($this->lock_time); + } + + public function clearLockTime() + { + unset($this->lock_time); + } + + /** + * [Output Only] The lock time of the FutureReservation before an + * amendment was requested. + * + * Generated from protobuf field optional string lock_time = 143772001; + * @param string $var + * @return $this + */ + public function setLockTime($var) + { + GPBUtil::checkString($var, True); + $this->lock_time = $var; + + return $this; + } + + /** + * [Output Only] The name prefix of the Future Reservation before an + * amendment was requested. + * + * Generated from protobuf field optional string name_prefix = 236409542; + * @return string + */ + public function getNamePrefix() + { + return isset($this->name_prefix) ? $this->name_prefix : ''; + } + + public function hasNamePrefix() + { + return isset($this->name_prefix); + } + + public function clearNamePrefix() + { + unset($this->name_prefix); + } + + /** + * [Output Only] The name prefix of the Future Reservation before an + * amendment was requested. + * + * Generated from protobuf field optional string name_prefix = 236409542; + * @param string $var + * @return $this + */ + public function setNamePrefix($var) + { + GPBUtil::checkString($var, True); + $this->name_prefix = $var; + + return $this; + } + + /** + * [Output Only] The status of the last known good state for the Future + * Reservation. + * Check the ProcurementStatus enum for the list of possible values. + * + * Generated from protobuf field optional string procurement_status = 224718945; + * @return string + */ + public function getProcurementStatus() + { + return isset($this->procurement_status) ? $this->procurement_status : ''; + } + + public function hasProcurementStatus() + { + return isset($this->procurement_status); + } + + public function clearProcurementStatus() + { + unset($this->procurement_status); + } + + /** + * [Output Only] The status of the last known good state for the Future + * Reservation. + * Check the ProcurementStatus enum for the list of possible values. + * + * Generated from protobuf field optional string procurement_status = 224718945; + * @param string $var + * @return $this + */ + public function setProcurementStatus($var) + { + GPBUtil::checkString($var, True); + $this->procurement_status = $var; + + return $this; + } + +} + diff --git a/Compute/src/V1/FutureReservationStatusLastKnownGoodState/ProcurementStatus.php b/Compute/src/V1/FutureReservationStatusLastKnownGoodState/ProcurementStatus.php new file mode 100644 index 000000000000..4e9d05728b8b --- /dev/null +++ b/Compute/src/V1/FutureReservationStatusLastKnownGoodState/ProcurementStatus.php @@ -0,0 +1,146 @@ +google.cloud.compute.v1.FutureReservationStatusLastKnownGoodState.ProcurementStatus + */ +class ProcurementStatus +{ + /** + * A value indicating that the enum field is not set. + * + * Generated from protobuf enum UNDEFINED_PROCUREMENT_STATUS = 0; + */ + const UNDEFINED_PROCUREMENT_STATUS = 0; + /** + * Future reservation is approved by GCP. + * + * Generated from protobuf enum APPROVED = 357258935; + */ + const APPROVED = 357258935; + /** + * Future reservation is cancelled by the customer. + * + * Generated from protobuf enum CANCELLED = 41957681; + */ + const CANCELLED = 41957681; + /** + * Future reservation is committed by the customer. + * + * Generated from protobuf enum COMMITTED = 221710172; + */ + const COMMITTED = 221710172; + /** + * Future reservation is rejected by GCP. + * + * Generated from protobuf enum DECLINED = 277081134; + */ + const DECLINED = 277081134; + /** + * Related status for PlanningStatus.Draft. Transitions to + * PENDING_APPROVAL upon user submitting FR. + * + * Generated from protobuf enum DRAFTING = 477863585; + */ + const DRAFTING = 477863585; + /** + * Future reservation failed. No additional reservations were provided. + * + * Generated from protobuf enum FAILED = 455706685; + */ + const FAILED = 455706685; + /** + * Future reservation is partially fulfilled. Additional reservations were + * provided but did not reach total_count reserved instance slots. + * + * Generated from protobuf enum FAILED_PARTIALLY_FULFILLED = 14455212; + */ + const FAILED_PARTIALLY_FULFILLED = 14455212; + /** + * Future reservation is fulfilled completely. + * + * Generated from protobuf enum FULFILLED = 409958655; + */ + const FULFILLED = 409958655; + /** + * An Amendment to the Future Reservation has been requested. If the + * Amendment is declined, the Future Reservation will be restored to the + * last known good state. + * + * Generated from protobuf enum PENDING_AMENDMENT_APPROVAL = 510150429; + */ + const PENDING_AMENDMENT_APPROVAL = 510150429; + /** + * Future reservation is pending approval by GCP. + * + * Generated from protobuf enum PENDING_APPROVAL = 209692683; + */ + const PENDING_APPROVAL = 209692683; + /** + * Generated from protobuf enum PROCUREMENT_STATUS_UNSPECIFIED = 45807705; + */ + const PROCUREMENT_STATUS_UNSPECIFIED = 45807705; + /** + * Future reservation is being procured by GCP. Beyond this point, Future + * reservation is locked and no further modifications are allowed. + * + * Generated from protobuf enum PROCURING = 95959663; + */ + const PROCURING = 95959663; + /** + * Future reservation capacity is being provisioned. This state will be + * entered after start_time, while reservations are being created to + * provide total_count reserved instance slots. This state will not + * persist past start_time + 24h. + * + * Generated from protobuf enum PROVISIONING = 290896621; + */ + const PROVISIONING = 290896621; + + private static $valueToName = [ + self::UNDEFINED_PROCUREMENT_STATUS => 'UNDEFINED_PROCUREMENT_STATUS', + self::APPROVED => 'APPROVED', + self::CANCELLED => 'CANCELLED', + self::COMMITTED => 'COMMITTED', + self::DECLINED => 'DECLINED', + self::DRAFTING => 'DRAFTING', + self::FAILED => 'FAILED', + self::FAILED_PARTIALLY_FULFILLED => 'FAILED_PARTIALLY_FULFILLED', + self::FULFILLED => 'FULFILLED', + self::PENDING_AMENDMENT_APPROVAL => 'PENDING_AMENDMENT_APPROVAL', + self::PENDING_APPROVAL => 'PENDING_APPROVAL', + self::PROCUREMENT_STATUS_UNSPECIFIED => 'PROCUREMENT_STATUS_UNSPECIFIED', + self::PROCURING => 'PROCURING', + self::PROVISIONING => 'PROVISIONING', + ]; + + public static function name($value) + { + if (!isset(self::$valueToName[$value])) { + throw new UnexpectedValueException(sprintf( + 'Enum %s has no name defined for value %s', __CLASS__, $value)); + } + return self::$valueToName[$value]; + } + + + public static function value($name) + { + $const = __CLASS__ . '::' . strtoupper($name); + if (!defined($const)) { + throw new UnexpectedValueException(sprintf( + 'Enum %s has no value defined for name %s', __CLASS__, $name)); + } + return constant($const); + } +} + + diff --git a/Compute/src/V1/FutureReservationStatusLastKnownGoodStateFutureReservationSpecs.php b/Compute/src/V1/FutureReservationStatusLastKnownGoodStateFutureReservationSpecs.php new file mode 100644 index 000000000000..f613c0d18c9b --- /dev/null +++ b/Compute/src/V1/FutureReservationStatusLastKnownGoodStateFutureReservationSpecs.php @@ -0,0 +1,169 @@ +google.cloud.compute.v1.FutureReservationStatusLastKnownGoodStateFutureReservationSpecs + */ +class FutureReservationStatusLastKnownGoodStateFutureReservationSpecs extends \Google\Protobuf\Internal\Message +{ + /** + * [Output Only] The previous share settings of the Future Reservation. + * + * Generated from protobuf field optional .google.cloud.compute.v1.ShareSettings share_settings = 266668163; + */ + protected $share_settings = null; + /** + * [Output Only] The previous instance related properties of the + * Future Reservation. + * + * Generated from protobuf field optional .google.cloud.compute.v1.FutureReservationSpecificSKUProperties specific_sku_properties = 108887106; + */ + protected $specific_sku_properties = null; + /** + * [Output Only] The previous time window of the Future Reservation. + * + * Generated from protobuf field optional .google.cloud.compute.v1.FutureReservationTimeWindow time_window = 422983074; + */ + protected $time_window = null; + + /** + * Constructor. + * + * @param array $data { + * Optional. Data for populating the Message object. + * + * @type \Google\Cloud\Compute\V1\ShareSettings $share_settings + * [Output Only] The previous share settings of the Future Reservation. + * @type \Google\Cloud\Compute\V1\FutureReservationSpecificSKUProperties $specific_sku_properties + * [Output Only] The previous instance related properties of the + * Future Reservation. + * @type \Google\Cloud\Compute\V1\FutureReservationTimeWindow $time_window + * [Output Only] The previous time window of the Future Reservation. + * } + */ + public function __construct($data = NULL) { + \GPBMetadata\Google\Cloud\Compute\V1\Compute::initOnce(); + parent::__construct($data); + } + + /** + * [Output Only] The previous share settings of the Future Reservation. + * + * Generated from protobuf field optional .google.cloud.compute.v1.ShareSettings share_settings = 266668163; + * @return \Google\Cloud\Compute\V1\ShareSettings|null + */ + public function getShareSettings() + { + return $this->share_settings; + } + + public function hasShareSettings() + { + return isset($this->share_settings); + } + + public function clearShareSettings() + { + unset($this->share_settings); + } + + /** + * [Output Only] The previous share settings of the Future Reservation. + * + * Generated from protobuf field optional .google.cloud.compute.v1.ShareSettings share_settings = 266668163; + * @param \Google\Cloud\Compute\V1\ShareSettings $var + * @return $this + */ + public function setShareSettings($var) + { + GPBUtil::checkMessage($var, \Google\Cloud\Compute\V1\ShareSettings::class); + $this->share_settings = $var; + + return $this; + } + + /** + * [Output Only] The previous instance related properties of the + * Future Reservation. + * + * Generated from protobuf field optional .google.cloud.compute.v1.FutureReservationSpecificSKUProperties specific_sku_properties = 108887106; + * @return \Google\Cloud\Compute\V1\FutureReservationSpecificSKUProperties|null + */ + public function getSpecificSkuProperties() + { + return $this->specific_sku_properties; + } + + public function hasSpecificSkuProperties() + { + return isset($this->specific_sku_properties); + } + + public function clearSpecificSkuProperties() + { + unset($this->specific_sku_properties); + } + + /** + * [Output Only] The previous instance related properties of the + * Future Reservation. + * + * Generated from protobuf field optional .google.cloud.compute.v1.FutureReservationSpecificSKUProperties specific_sku_properties = 108887106; + * @param \Google\Cloud\Compute\V1\FutureReservationSpecificSKUProperties $var + * @return $this + */ + public function setSpecificSkuProperties($var) + { + GPBUtil::checkMessage($var, \Google\Cloud\Compute\V1\FutureReservationSpecificSKUProperties::class); + $this->specific_sku_properties = $var; + + return $this; + } + + /** + * [Output Only] The previous time window of the Future Reservation. + * + * Generated from protobuf field optional .google.cloud.compute.v1.FutureReservationTimeWindow time_window = 422983074; + * @return \Google\Cloud\Compute\V1\FutureReservationTimeWindow|null + */ + public function getTimeWindow() + { + return $this->time_window; + } + + public function hasTimeWindow() + { + return isset($this->time_window); + } + + public function clearTimeWindow() + { + unset($this->time_window); + } + + /** + * [Output Only] The previous time window of the Future Reservation. + * + * Generated from protobuf field optional .google.cloud.compute.v1.FutureReservationTimeWindow time_window = 422983074; + * @param \Google\Cloud\Compute\V1\FutureReservationTimeWindow $var + * @return $this + */ + public function setTimeWindow($var) + { + GPBUtil::checkMessage($var, \Google\Cloud\Compute\V1\FutureReservationTimeWindow::class); + $this->time_window = $var; + + return $this; + } + +} + diff --git a/Compute/src/V1/FutureReservationStatusSpecificSKUProperties.php b/Compute/src/V1/FutureReservationStatusSpecificSKUProperties.php new file mode 100644 index 000000000000..3e02901db86d --- /dev/null +++ b/Compute/src/V1/FutureReservationStatusSpecificSKUProperties.php @@ -0,0 +1,81 @@ +google.cloud.compute.v1.FutureReservationStatusSpecificSKUProperties + */ +class FutureReservationStatusSpecificSKUProperties extends \Google\Protobuf\Internal\Message +{ + /** + * ID of the instance template used to populate the Future Reservation + * properties. + * + * Generated from protobuf field optional string source_instance_template_id = 111196154; + */ + protected $source_instance_template_id = null; + + /** + * Constructor. + * + * @param array $data { + * Optional. Data for populating the Message object. + * + * @type string $source_instance_template_id + * ID of the instance template used to populate the Future Reservation + * properties. + * } + */ + public function __construct($data = NULL) { + \GPBMetadata\Google\Cloud\Compute\V1\Compute::initOnce(); + parent::__construct($data); + } + + /** + * ID of the instance template used to populate the Future Reservation + * properties. + * + * Generated from protobuf field optional string source_instance_template_id = 111196154; + * @return string + */ + public function getSourceInstanceTemplateId() + { + return isset($this->source_instance_template_id) ? $this->source_instance_template_id : ''; + } + + public function hasSourceInstanceTemplateId() + { + return isset($this->source_instance_template_id); + } + + public function clearSourceInstanceTemplateId() + { + unset($this->source_instance_template_id); + } + + /** + * ID of the instance template used to populate the Future Reservation + * properties. + * + * Generated from protobuf field optional string source_instance_template_id = 111196154; + * @param string $var + * @return $this + */ + public function setSourceInstanceTemplateId($var) + { + GPBUtil::checkString($var, True); + $this->source_instance_template_id = $var; + + return $this; + } + +} + diff --git a/Compute/src/V1/FutureReservationTimeWindow.php b/Compute/src/V1/FutureReservationTimeWindow.php new file mode 100644 index 000000000000..29045b386d09 --- /dev/null +++ b/Compute/src/V1/FutureReservationTimeWindow.php @@ -0,0 +1,154 @@ +google.cloud.compute.v1.FutureReservationTimeWindow + */ +class FutureReservationTimeWindow extends \Google\Protobuf\Internal\Message +{ + /** + * Generated from protobuf field optional .google.cloud.compute.v1.Duration duration = 155471252; + */ + protected $duration = null; + /** + * Generated from protobuf field optional string end_time = 114938801; + */ + protected $end_time = null; + /** + * Start time of the Future Reservation. The start_time is an RFC3339 + * string. + * + * Generated from protobuf field optional string start_time = 37467274; + */ + protected $start_time = null; + + /** + * Constructor. + * + * @param array $data { + * Optional. Data for populating the Message object. + * + * @type \Google\Cloud\Compute\V1\Duration $duration + * @type string $end_time + * @type string $start_time + * Start time of the Future Reservation. The start_time is an RFC3339 + * string. + * } + */ + public function __construct($data = NULL) { + \GPBMetadata\Google\Cloud\Compute\V1\Compute::initOnce(); + parent::__construct($data); + } + + /** + * Generated from protobuf field optional .google.cloud.compute.v1.Duration duration = 155471252; + * @return \Google\Cloud\Compute\V1\Duration|null + */ + public function getDuration() + { + return $this->duration; + } + + public function hasDuration() + { + return isset($this->duration); + } + + public function clearDuration() + { + unset($this->duration); + } + + /** + * Generated from protobuf field optional .google.cloud.compute.v1.Duration duration = 155471252; + * @param \Google\Cloud\Compute\V1\Duration $var + * @return $this + */ + public function setDuration($var) + { + GPBUtil::checkMessage($var, \Google\Cloud\Compute\V1\Duration::class); + $this->duration = $var; + + return $this; + } + + /** + * Generated from protobuf field optional string end_time = 114938801; + * @return string + */ + public function getEndTime() + { + return isset($this->end_time) ? $this->end_time : ''; + } + + public function hasEndTime() + { + return isset($this->end_time); + } + + public function clearEndTime() + { + unset($this->end_time); + } + + /** + * Generated from protobuf field optional string end_time = 114938801; + * @param string $var + * @return $this + */ + public function setEndTime($var) + { + GPBUtil::checkString($var, True); + $this->end_time = $var; + + return $this; + } + + /** + * Start time of the Future Reservation. The start_time is an RFC3339 + * string. + * + * Generated from protobuf field optional string start_time = 37467274; + * @return string + */ + public function getStartTime() + { + return isset($this->start_time) ? $this->start_time : ''; + } + + public function hasStartTime() + { + return isset($this->start_time); + } + + public function clearStartTime() + { + unset($this->start_time); + } + + /** + * Start time of the Future Reservation. The start_time is an RFC3339 + * string. + * + * Generated from protobuf field optional string start_time = 37467274; + * @param string $var + * @return $this + */ + public function setStartTime($var) + { + GPBUtil::checkString($var, True); + $this->start_time = $var; + + return $this; + } + +} + diff --git a/Compute/src/V1/FutureReservationsAggregatedListResponse.php b/Compute/src/V1/FutureReservationsAggregatedListResponse.php new file mode 100644 index 000000000000..808cdae683fd --- /dev/null +++ b/Compute/src/V1/FutureReservationsAggregatedListResponse.php @@ -0,0 +1,378 @@ +google.cloud.compute.v1.FutureReservationsAggregatedListResponse + */ +class FutureReservationsAggregatedListResponse extends \Google\Protobuf\Internal\Message +{ + /** + * Generated from protobuf field optional string etag = 3123477; + */ + protected $etag = null; + /** + * [Output Only] Unique identifier for the resource; defined by the server. + * + * Generated from protobuf field optional string id = 3355; + */ + protected $id = null; + /** + * A list of Future reservation resources. + * + * Generated from protobuf field map items = 100526016; + */ + private $items; + /** + * [Output Only] Type of resource. Alwayscompute#futureReservationsAggregatedListResponse for future + * resevation aggregated list response. + * + * Generated from protobuf field optional string kind = 3292052; + */ + protected $kind = null; + /** + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. + * + * Generated from protobuf field optional string next_page_token = 79797525; + */ + protected $next_page_token = null; + /** + * [Output Only] Server-defined URL for this resource. + * + * Generated from protobuf field optional string self_link = 456214797; + */ + protected $self_link = null; + /** + * [Output Only] Unreachable resources. + * + * Generated from protobuf field repeated string unreachables = 243372063; + */ + private $unreachables; + /** + * [Output Only] Informational warning message. + * + * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; + */ + protected $warning = null; + + /** + * Constructor. + * + * @param array $data { + * Optional. Data for populating the Message object. + * + * @type string $etag + * @type string $id + * [Output Only] Unique identifier for the resource; defined by the server. + * @type array|\Google\Protobuf\Internal\MapField $items + * A list of Future reservation resources. + * @type string $kind + * [Output Only] Type of resource. Alwayscompute#futureReservationsAggregatedListResponse for future + * resevation aggregated list response. + * @type string $next_page_token + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. + * @type string $self_link + * [Output Only] Server-defined URL for this resource. + * @type array|\Google\Protobuf\Internal\RepeatedField $unreachables + * [Output Only] Unreachable resources. + * @type \Google\Cloud\Compute\V1\Warning $warning + * [Output Only] Informational warning message. + * } + */ + public function __construct($data = NULL) { + \GPBMetadata\Google\Cloud\Compute\V1\Compute::initOnce(); + parent::__construct($data); + } + + /** + * Generated from protobuf field optional string etag = 3123477; + * @return string + */ + public function getEtag() + { + return isset($this->etag) ? $this->etag : ''; + } + + public function hasEtag() + { + return isset($this->etag); + } + + public function clearEtag() + { + unset($this->etag); + } + + /** + * Generated from protobuf field optional string etag = 3123477; + * @param string $var + * @return $this + */ + public function setEtag($var) + { + GPBUtil::checkString($var, True); + $this->etag = $var; + + return $this; + } + + /** + * [Output Only] Unique identifier for the resource; defined by the server. + * + * Generated from protobuf field optional string id = 3355; + * @return string + */ + public function getId() + { + return isset($this->id) ? $this->id : ''; + } + + public function hasId() + { + return isset($this->id); + } + + public function clearId() + { + unset($this->id); + } + + /** + * [Output Only] Unique identifier for the resource; defined by the server. + * + * Generated from protobuf field optional string id = 3355; + * @param string $var + * @return $this + */ + public function setId($var) + { + GPBUtil::checkString($var, True); + $this->id = $var; + + return $this; + } + + /** + * A list of Future reservation resources. + * + * Generated from protobuf field map items = 100526016; + * @return \Google\Protobuf\Internal\MapField + */ + public function getItems() + { + return $this->items; + } + + /** + * A list of Future reservation resources. + * + * Generated from protobuf field map items = 100526016; + * @param array|\Google\Protobuf\Internal\MapField $var + * @return $this + */ + public function setItems($var) + { + $arr = GPBUtil::checkMapField($var, \Google\Protobuf\Internal\GPBType::STRING, \Google\Protobuf\Internal\GPBType::MESSAGE, \Google\Cloud\Compute\V1\FutureReservationsScopedList::class); + $this->items = $arr; + + return $this; + } + + /** + * [Output Only] Type of resource. Alwayscompute#futureReservationsAggregatedListResponse for future + * resevation aggregated list response. + * + * Generated from protobuf field optional string kind = 3292052; + * @return string + */ + public function getKind() + { + return isset($this->kind) ? $this->kind : ''; + } + + public function hasKind() + { + return isset($this->kind); + } + + public function clearKind() + { + unset($this->kind); + } + + /** + * [Output Only] Type of resource. Alwayscompute#futureReservationsAggregatedListResponse for future + * resevation aggregated list response. + * + * Generated from protobuf field optional string kind = 3292052; + * @param string $var + * @return $this + */ + public function setKind($var) + { + GPBUtil::checkString($var, True); + $this->kind = $var; + + return $this; + } + + /** + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. + * + * Generated from protobuf field optional string next_page_token = 79797525; + * @return string + */ + public function getNextPageToken() + { + return isset($this->next_page_token) ? $this->next_page_token : ''; + } + + public function hasNextPageToken() + { + return isset($this->next_page_token); + } + + public function clearNextPageToken() + { + unset($this->next_page_token); + } + + /** + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. + * + * Generated from protobuf field optional string next_page_token = 79797525; + * @param string $var + * @return $this + */ + public function setNextPageToken($var) + { + GPBUtil::checkString($var, True); + $this->next_page_token = $var; + + return $this; + } + + /** + * [Output Only] Server-defined URL for this resource. + * + * Generated from protobuf field optional string self_link = 456214797; + * @return string + */ + public function getSelfLink() + { + return isset($this->self_link) ? $this->self_link : ''; + } + + public function hasSelfLink() + { + return isset($this->self_link); + } + + public function clearSelfLink() + { + unset($this->self_link); + } + + /** + * [Output Only] Server-defined URL for this resource. + * + * Generated from protobuf field optional string self_link = 456214797; + * @param string $var + * @return $this + */ + public function setSelfLink($var) + { + GPBUtil::checkString($var, True); + $this->self_link = $var; + + return $this; + } + + /** + * [Output Only] Unreachable resources. + * + * Generated from protobuf field repeated string unreachables = 243372063; + * @return \Google\Protobuf\Internal\RepeatedField + */ + public function getUnreachables() + { + return $this->unreachables; + } + + /** + * [Output Only] Unreachable resources. + * + * Generated from protobuf field repeated string unreachables = 243372063; + * @param array|\Google\Protobuf\Internal\RepeatedField $var + * @return $this + */ + public function setUnreachables($var) + { + $arr = GPBUtil::checkRepeatedField($var, \Google\Protobuf\Internal\GPBType::STRING); + $this->unreachables = $arr; + + return $this; + } + + /** + * [Output Only] Informational warning message. + * + * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; + * @return \Google\Cloud\Compute\V1\Warning|null + */ + public function getWarning() + { + return $this->warning; + } + + public function hasWarning() + { + return isset($this->warning); + } + + public function clearWarning() + { + unset($this->warning); + } + + /** + * [Output Only] Informational warning message. + * + * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; + * @param \Google\Cloud\Compute\V1\Warning $var + * @return $this + */ + public function setWarning($var) + { + GPBUtil::checkMessage($var, \Google\Cloud\Compute\V1\Warning::class); + $this->warning = $var; + + return $this; + } + +} + diff --git a/Compute/src/V1/FutureReservationsListResponse.php b/Compute/src/V1/FutureReservationsListResponse.php new file mode 100644 index 000000000000..182795a600f4 --- /dev/null +++ b/Compute/src/V1/FutureReservationsListResponse.php @@ -0,0 +1,381 @@ +google.cloud.compute.v1.FutureReservationsListResponse + */ +class FutureReservationsListResponse extends \Google\Protobuf\Internal\Message +{ + /** + * Generated from protobuf field optional string etag = 3123477; + */ + protected $etag = null; + /** + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. + * + * Generated from protobuf field optional string id = 3355; + */ + protected $id = null; + /** + * [Output Only] A list of future reservation resources. + * + * Generated from protobuf field repeated .google.cloud.compute.v1.FutureReservation items = 100526016; + */ + private $items; + /** + * [Output Only] Type of resource.Alwayscompute#FutureReservationsListResponse for lists of + * reservations + * + * Generated from protobuf field optional string kind = 3292052; + */ + protected $kind = null; + /** + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. + * + * Generated from protobuf field optional string next_page_token = 79797525; + */ + protected $next_page_token = null; + /** + * [Output Only] Server-defined URL for this resource. + * + * Generated from protobuf field optional string self_link = 456214797; + */ + protected $self_link = null; + /** + * [Output Only] Unreachable resources. + * + * Generated from protobuf field repeated string unreachables = 243372063; + */ + private $unreachables; + /** + * [Output Only] Informational warning message. + * + * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; + */ + protected $warning = null; + + /** + * Constructor. + * + * @param array $data { + * Optional. Data for populating the Message object. + * + * @type string $etag + * @type string $id + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. + * @type array<\Google\Cloud\Compute\V1\FutureReservation>|\Google\Protobuf\Internal\RepeatedField $items + * [Output Only] A list of future reservation resources. + * @type string $kind + * [Output Only] Type of resource.Alwayscompute#FutureReservationsListResponse for lists of + * reservations + * @type string $next_page_token + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. + * @type string $self_link + * [Output Only] Server-defined URL for this resource. + * @type array|\Google\Protobuf\Internal\RepeatedField $unreachables + * [Output Only] Unreachable resources. + * @type \Google\Cloud\Compute\V1\Warning $warning + * [Output Only] Informational warning message. + * } + */ + public function __construct($data = NULL) { + \GPBMetadata\Google\Cloud\Compute\V1\Compute::initOnce(); + parent::__construct($data); + } + + /** + * Generated from protobuf field optional string etag = 3123477; + * @return string + */ + public function getEtag() + { + return isset($this->etag) ? $this->etag : ''; + } + + public function hasEtag() + { + return isset($this->etag); + } + + public function clearEtag() + { + unset($this->etag); + } + + /** + * Generated from protobuf field optional string etag = 3123477; + * @param string $var + * @return $this + */ + public function setEtag($var) + { + GPBUtil::checkString($var, True); + $this->etag = $var; + + return $this; + } + + /** + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. + * + * Generated from protobuf field optional string id = 3355; + * @return string + */ + public function getId() + { + return isset($this->id) ? $this->id : ''; + } + + public function hasId() + { + return isset($this->id); + } + + public function clearId() + { + unset($this->id); + } + + /** + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. + * + * Generated from protobuf field optional string id = 3355; + * @param string $var + * @return $this + */ + public function setId($var) + { + GPBUtil::checkString($var, True); + $this->id = $var; + + return $this; + } + + /** + * [Output Only] A list of future reservation resources. + * + * Generated from protobuf field repeated .google.cloud.compute.v1.FutureReservation items = 100526016; + * @return \Google\Protobuf\Internal\RepeatedField + */ + public function getItems() + { + return $this->items; + } + + /** + * [Output Only] A list of future reservation resources. + * + * Generated from protobuf field repeated .google.cloud.compute.v1.FutureReservation items = 100526016; + * @param array<\Google\Cloud\Compute\V1\FutureReservation>|\Google\Protobuf\Internal\RepeatedField $var + * @return $this + */ + public function setItems($var) + { + $arr = GPBUtil::checkRepeatedField($var, \Google\Protobuf\Internal\GPBType::MESSAGE, \Google\Cloud\Compute\V1\FutureReservation::class); + $this->items = $arr; + + return $this; + } + + /** + * [Output Only] Type of resource.Alwayscompute#FutureReservationsListResponse for lists of + * reservations + * + * Generated from protobuf field optional string kind = 3292052; + * @return string + */ + public function getKind() + { + return isset($this->kind) ? $this->kind : ''; + } + + public function hasKind() + { + return isset($this->kind); + } + + public function clearKind() + { + unset($this->kind); + } + + /** + * [Output Only] Type of resource.Alwayscompute#FutureReservationsListResponse for lists of + * reservations + * + * Generated from protobuf field optional string kind = 3292052; + * @param string $var + * @return $this + */ + public function setKind($var) + { + GPBUtil::checkString($var, True); + $this->kind = $var; + + return $this; + } + + /** + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. + * + * Generated from protobuf field optional string next_page_token = 79797525; + * @return string + */ + public function getNextPageToken() + { + return isset($this->next_page_token) ? $this->next_page_token : ''; + } + + public function hasNextPageToken() + { + return isset($this->next_page_token); + } + + public function clearNextPageToken() + { + unset($this->next_page_token); + } + + /** + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. + * + * Generated from protobuf field optional string next_page_token = 79797525; + * @param string $var + * @return $this + */ + public function setNextPageToken($var) + { + GPBUtil::checkString($var, True); + $this->next_page_token = $var; + + return $this; + } + + /** + * [Output Only] Server-defined URL for this resource. + * + * Generated from protobuf field optional string self_link = 456214797; + * @return string + */ + public function getSelfLink() + { + return isset($this->self_link) ? $this->self_link : ''; + } + + public function hasSelfLink() + { + return isset($this->self_link); + } + + public function clearSelfLink() + { + unset($this->self_link); + } + + /** + * [Output Only] Server-defined URL for this resource. + * + * Generated from protobuf field optional string self_link = 456214797; + * @param string $var + * @return $this + */ + public function setSelfLink($var) + { + GPBUtil::checkString($var, True); + $this->self_link = $var; + + return $this; + } + + /** + * [Output Only] Unreachable resources. + * + * Generated from protobuf field repeated string unreachables = 243372063; + * @return \Google\Protobuf\Internal\RepeatedField + */ + public function getUnreachables() + { + return $this->unreachables; + } + + /** + * [Output Only] Unreachable resources. + * + * Generated from protobuf field repeated string unreachables = 243372063; + * @param array|\Google\Protobuf\Internal\RepeatedField $var + * @return $this + */ + public function setUnreachables($var) + { + $arr = GPBUtil::checkRepeatedField($var, \Google\Protobuf\Internal\GPBType::STRING); + $this->unreachables = $arr; + + return $this; + } + + /** + * [Output Only] Informational warning message. + * + * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; + * @return \Google\Cloud\Compute\V1\Warning|null + */ + public function getWarning() + { + return $this->warning; + } + + public function hasWarning() + { + return isset($this->warning); + } + + public function clearWarning() + { + unset($this->warning); + } + + /** + * [Output Only] Informational warning message. + * + * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; + * @param \Google\Cloud\Compute\V1\Warning $var + * @return $this + */ + public function setWarning($var) + { + GPBUtil::checkMessage($var, \Google\Cloud\Compute\V1\Warning::class); + $this->warning = $var; + + return $this; + } + +} + diff --git a/Compute/src/V1/FutureReservationsScopedList.php b/Compute/src/V1/FutureReservationsScopedList.php new file mode 100644 index 000000000000..96b24dfb79e3 --- /dev/null +++ b/Compute/src/V1/FutureReservationsScopedList.php @@ -0,0 +1,114 @@ +google.cloud.compute.v1.FutureReservationsScopedList + */ +class FutureReservationsScopedList extends \Google\Protobuf\Internal\Message +{ + /** + * A list of future reservations contained in this scope. + * + * Generated from protobuf field repeated .google.cloud.compute.v1.FutureReservation future_reservations = 131778339; + */ + private $future_reservations; + /** + * Informational warning which replaces the list of future reservations when + * the list is empty. + * + * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; + */ + protected $warning = null; + + /** + * Constructor. + * + * @param array $data { + * Optional. Data for populating the Message object. + * + * @type array<\Google\Cloud\Compute\V1\FutureReservation>|\Google\Protobuf\Internal\RepeatedField $future_reservations + * A list of future reservations contained in this scope. + * @type \Google\Cloud\Compute\V1\Warning $warning + * Informational warning which replaces the list of future reservations when + * the list is empty. + * } + */ + public function __construct($data = NULL) { + \GPBMetadata\Google\Cloud\Compute\V1\Compute::initOnce(); + parent::__construct($data); + } + + /** + * A list of future reservations contained in this scope. + * + * Generated from protobuf field repeated .google.cloud.compute.v1.FutureReservation future_reservations = 131778339; + * @return \Google\Protobuf\Internal\RepeatedField + */ + public function getFutureReservations() + { + return $this->future_reservations; + } + + /** + * A list of future reservations contained in this scope. + * + * Generated from protobuf field repeated .google.cloud.compute.v1.FutureReservation future_reservations = 131778339; + * @param array<\Google\Cloud\Compute\V1\FutureReservation>|\Google\Protobuf\Internal\RepeatedField $var + * @return $this + */ + public function setFutureReservations($var) + { + $arr = GPBUtil::checkRepeatedField($var, \Google\Protobuf\Internal\GPBType::MESSAGE, \Google\Cloud\Compute\V1\FutureReservation::class); + $this->future_reservations = $arr; + + return $this; + } + + /** + * Informational warning which replaces the list of future reservations when + * the list is empty. + * + * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; + * @return \Google\Cloud\Compute\V1\Warning|null + */ + public function getWarning() + { + return $this->warning; + } + + public function hasWarning() + { + return isset($this->warning); + } + + public function clearWarning() + { + unset($this->warning); + } + + /** + * Informational warning which replaces the list of future reservations when + * the list is empty. + * + * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; + * @param \Google\Cloud\Compute\V1\Warning $var + * @return $this + */ + public function setWarning($var) + { + GPBUtil::checkMessage($var, \Google\Cloud\Compute\V1\Warning::class); + $this->warning = $var; + + return $this; + } + +} + diff --git a/Compute/src/V1/GRPCHealthCheck.php b/Compute/src/V1/GRPCHealthCheck.php index 6ede0d816ac3..32972c45e7c0 100644 --- a/Compute/src/V1/GRPCHealthCheck.php +++ b/Compute/src/V1/GRPCHealthCheck.php @@ -15,13 +15,20 @@ class GRPCHealthCheck extends \Google\Protobuf\Internal\Message { /** - * The gRPC service name for the health check. This field is optional. The value of grpc_service_name has the following meanings by convention: - Empty service_name means the overall status of all services at the backend. - Non-empty service_name means the health of that gRPC service, as defined by the owner of the service. The grpc_service_name can only be ASCII. + * The gRPC service name for the health check. This field is optional. The + * value of grpc_service_name has the following meanings by convention: + * - Empty service_name means the overall status of all services at the + * backend. + * - Non-empty service_name means the health of that gRPC service, as defined + * by the owner of the service. + * The grpc_service_name can only be ASCII. * * Generated from protobuf field optional string grpc_service_name = 136533078; */ protected $grpc_service_name = null; /** - * The TCP port number to which the health check prober sends packets. Valid values are 1 through 65535. + * The TCP port number to which the health check prober sends packets. Valid + * values are 1 through 65535. * * Generated from protobuf field optional int32 port = 3446913; */ @@ -33,7 +40,27 @@ class GRPCHealthCheck extends \Google\Protobuf\Internal\Message */ protected $port_name = null; /** - * Specifies how a port is selected for health checking. Can be one of the following values: USE_FIXED_PORT: Specifies a port number explicitly using the port field in the health check. Supported by backend services for passthrough load balancers and backend services for proxy load balancers. Not supported by target pools. The health check supports all backends supported by the backend service provided the backend can be health checked. For example, GCE_VM_IP network endpoint groups, GCE_VM_IP_PORT network endpoint groups, and instance group backends. USE_NAMED_PORT: Not supported. USE_SERVING_PORT: Provides an indirect method of specifying the health check port by referring to the backend service. Only supported by backend services for proxy load balancers. Not supported by target pools. Not supported by backend services for passthrough load balancers. Supports all backends that can be health checked; for example, GCE_VM_IP_PORT network endpoint groups and instance group backends. For GCE_VM_IP_PORT network endpoint group backends, the health check uses the port number specified for each endpoint in the network endpoint group. For instance group backends, the health check uses the port number determined by looking up the backend service's named port in the instance group's list of named ports. + * Specifies how a port is selected for health checking. Can be one of the + * following values: + * USE_FIXED_PORT: Specifies a port number explicitly using theport field in the health check. Supported by backend services + * for passthrough load balancers and backend services for proxy load + * balancers. Not supported by target pools. The health check supports all + * backends supported by the backend service provided the backend can be + * health checked. For example, GCE_VM_IP network endpoint + * groups, GCE_VM_IP_PORT network endpoint groups, and instance + * group backends. + * USE_NAMED_PORT: Not supported. + * USE_SERVING_PORT: Provides an indirect method of specifying + * the health check port by referring to the backend service. Only supported + * by backend services for proxy load balancers. Not supported by target + * pools. Not supported by backend services for passthrough load balancers. + * Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group + * backends. + * For GCE_VM_IP_PORT network endpoint group backends, the health + * check uses the port number specified for each endpoint in the network + * endpoint group. For instance group backends, the health check uses the + * port number determined by looking up the backend service's named port in + * the instance group's list of named ports. * Check the PortSpecification enum for the list of possible values. * * Generated from protobuf field optional string port_specification = 51590597; @@ -47,13 +74,40 @@ class GRPCHealthCheck extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $grpc_service_name - * The gRPC service name for the health check. This field is optional. The value of grpc_service_name has the following meanings by convention: - Empty service_name means the overall status of all services at the backend. - Non-empty service_name means the health of that gRPC service, as defined by the owner of the service. The grpc_service_name can only be ASCII. + * The gRPC service name for the health check. This field is optional. The + * value of grpc_service_name has the following meanings by convention: + * - Empty service_name means the overall status of all services at the + * backend. + * - Non-empty service_name means the health of that gRPC service, as defined + * by the owner of the service. + * The grpc_service_name can only be ASCII. * @type int $port - * The TCP port number to which the health check prober sends packets. Valid values are 1 through 65535. + * The TCP port number to which the health check prober sends packets. Valid + * values are 1 through 65535. * @type string $port_name * Not supported. * @type string $port_specification - * Specifies how a port is selected for health checking. Can be one of the following values: USE_FIXED_PORT: Specifies a port number explicitly using the port field in the health check. Supported by backend services for passthrough load balancers and backend services for proxy load balancers. Not supported by target pools. The health check supports all backends supported by the backend service provided the backend can be health checked. For example, GCE_VM_IP network endpoint groups, GCE_VM_IP_PORT network endpoint groups, and instance group backends. USE_NAMED_PORT: Not supported. USE_SERVING_PORT: Provides an indirect method of specifying the health check port by referring to the backend service. Only supported by backend services for proxy load balancers. Not supported by target pools. Not supported by backend services for passthrough load balancers. Supports all backends that can be health checked; for example, GCE_VM_IP_PORT network endpoint groups and instance group backends. For GCE_VM_IP_PORT network endpoint group backends, the health check uses the port number specified for each endpoint in the network endpoint group. For instance group backends, the health check uses the port number determined by looking up the backend service's named port in the instance group's list of named ports. + * Specifies how a port is selected for health checking. Can be one of the + * following values: + * USE_FIXED_PORT: Specifies a port number explicitly using theport field in the health check. Supported by backend services + * for passthrough load balancers and backend services for proxy load + * balancers. Not supported by target pools. The health check supports all + * backends supported by the backend service provided the backend can be + * health checked. For example, GCE_VM_IP network endpoint + * groups, GCE_VM_IP_PORT network endpoint groups, and instance + * group backends. + * USE_NAMED_PORT: Not supported. + * USE_SERVING_PORT: Provides an indirect method of specifying + * the health check port by referring to the backend service. Only supported + * by backend services for proxy load balancers. Not supported by target + * pools. Not supported by backend services for passthrough load balancers. + * Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group + * backends. + * For GCE_VM_IP_PORT network endpoint group backends, the health + * check uses the port number specified for each endpoint in the network + * endpoint group. For instance group backends, the health check uses the + * port number determined by looking up the backend service's named port in + * the instance group's list of named ports. * Check the PortSpecification enum for the list of possible values. * } */ @@ -63,7 +117,13 @@ public function __construct($data = NULL) { } /** - * The gRPC service name for the health check. This field is optional. The value of grpc_service_name has the following meanings by convention: - Empty service_name means the overall status of all services at the backend. - Non-empty service_name means the health of that gRPC service, as defined by the owner of the service. The grpc_service_name can only be ASCII. + * The gRPC service name for the health check. This field is optional. The + * value of grpc_service_name has the following meanings by convention: + * - Empty service_name means the overall status of all services at the + * backend. + * - Non-empty service_name means the health of that gRPC service, as defined + * by the owner of the service. + * The grpc_service_name can only be ASCII. * * Generated from protobuf field optional string grpc_service_name = 136533078; * @return string @@ -84,7 +144,13 @@ public function clearGrpcServiceName() } /** - * The gRPC service name for the health check. This field is optional. The value of grpc_service_name has the following meanings by convention: - Empty service_name means the overall status of all services at the backend. - Non-empty service_name means the health of that gRPC service, as defined by the owner of the service. The grpc_service_name can only be ASCII. + * The gRPC service name for the health check. This field is optional. The + * value of grpc_service_name has the following meanings by convention: + * - Empty service_name means the overall status of all services at the + * backend. + * - Non-empty service_name means the health of that gRPC service, as defined + * by the owner of the service. + * The grpc_service_name can only be ASCII. * * Generated from protobuf field optional string grpc_service_name = 136533078; * @param string $var @@ -99,7 +165,8 @@ public function setGrpcServiceName($var) } /** - * The TCP port number to which the health check prober sends packets. Valid values are 1 through 65535. + * The TCP port number to which the health check prober sends packets. Valid + * values are 1 through 65535. * * Generated from protobuf field optional int32 port = 3446913; * @return int @@ -120,7 +187,8 @@ public function clearPort() } /** - * The TCP port number to which the health check prober sends packets. Valid values are 1 through 65535. + * The TCP port number to which the health check prober sends packets. Valid + * values are 1 through 65535. * * Generated from protobuf field optional int32 port = 3446913; * @param int $var @@ -171,7 +239,27 @@ public function setPortName($var) } /** - * Specifies how a port is selected for health checking. Can be one of the following values: USE_FIXED_PORT: Specifies a port number explicitly using the port field in the health check. Supported by backend services for passthrough load balancers and backend services for proxy load balancers. Not supported by target pools. The health check supports all backends supported by the backend service provided the backend can be health checked. For example, GCE_VM_IP network endpoint groups, GCE_VM_IP_PORT network endpoint groups, and instance group backends. USE_NAMED_PORT: Not supported. USE_SERVING_PORT: Provides an indirect method of specifying the health check port by referring to the backend service. Only supported by backend services for proxy load balancers. Not supported by target pools. Not supported by backend services for passthrough load balancers. Supports all backends that can be health checked; for example, GCE_VM_IP_PORT network endpoint groups and instance group backends. For GCE_VM_IP_PORT network endpoint group backends, the health check uses the port number specified for each endpoint in the network endpoint group. For instance group backends, the health check uses the port number determined by looking up the backend service's named port in the instance group's list of named ports. + * Specifies how a port is selected for health checking. Can be one of the + * following values: + * USE_FIXED_PORT: Specifies a port number explicitly using theport field in the health check. Supported by backend services + * for passthrough load balancers and backend services for proxy load + * balancers. Not supported by target pools. The health check supports all + * backends supported by the backend service provided the backend can be + * health checked. For example, GCE_VM_IP network endpoint + * groups, GCE_VM_IP_PORT network endpoint groups, and instance + * group backends. + * USE_NAMED_PORT: Not supported. + * USE_SERVING_PORT: Provides an indirect method of specifying + * the health check port by referring to the backend service. Only supported + * by backend services for proxy load balancers. Not supported by target + * pools. Not supported by backend services for passthrough load balancers. + * Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group + * backends. + * For GCE_VM_IP_PORT network endpoint group backends, the health + * check uses the port number specified for each endpoint in the network + * endpoint group. For instance group backends, the health check uses the + * port number determined by looking up the backend service's named port in + * the instance group's list of named ports. * Check the PortSpecification enum for the list of possible values. * * Generated from protobuf field optional string port_specification = 51590597; @@ -193,7 +281,27 @@ public function clearPortSpecification() } /** - * Specifies how a port is selected for health checking. Can be one of the following values: USE_FIXED_PORT: Specifies a port number explicitly using the port field in the health check. Supported by backend services for passthrough load balancers and backend services for proxy load balancers. Not supported by target pools. The health check supports all backends supported by the backend service provided the backend can be health checked. For example, GCE_VM_IP network endpoint groups, GCE_VM_IP_PORT network endpoint groups, and instance group backends. USE_NAMED_PORT: Not supported. USE_SERVING_PORT: Provides an indirect method of specifying the health check port by referring to the backend service. Only supported by backend services for proxy load balancers. Not supported by target pools. Not supported by backend services for passthrough load balancers. Supports all backends that can be health checked; for example, GCE_VM_IP_PORT network endpoint groups and instance group backends. For GCE_VM_IP_PORT network endpoint group backends, the health check uses the port number specified for each endpoint in the network endpoint group. For instance group backends, the health check uses the port number determined by looking up the backend service's named port in the instance group's list of named ports. + * Specifies how a port is selected for health checking. Can be one of the + * following values: + * USE_FIXED_PORT: Specifies a port number explicitly using theport field in the health check. Supported by backend services + * for passthrough load balancers and backend services for proxy load + * balancers. Not supported by target pools. The health check supports all + * backends supported by the backend service provided the backend can be + * health checked. For example, GCE_VM_IP network endpoint + * groups, GCE_VM_IP_PORT network endpoint groups, and instance + * group backends. + * USE_NAMED_PORT: Not supported. + * USE_SERVING_PORT: Provides an indirect method of specifying + * the health check port by referring to the backend service. Only supported + * by backend services for proxy load balancers. Not supported by target + * pools. Not supported by backend services for passthrough load balancers. + * Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group + * backends. + * For GCE_VM_IP_PORT network endpoint group backends, the health + * check uses the port number specified for each endpoint in the network + * endpoint group. For instance group backends, the health check uses the + * port number determined by looking up the backend service's named port in + * the instance group's list of named ports. * Check the PortSpecification enum for the list of possible values. * * Generated from protobuf field optional string port_specification = 51590597; diff --git a/Compute/src/V1/GRPCHealthCheck/PortSpecification.php b/Compute/src/V1/GRPCHealthCheck/PortSpecification.php index fb28b059e83a..271086011483 100644 --- a/Compute/src/V1/GRPCHealthCheck/PortSpecification.php +++ b/Compute/src/V1/GRPCHealthCheck/PortSpecification.php @@ -7,7 +7,27 @@ use UnexpectedValueException; /** - * Specifies how a port is selected for health checking. Can be one of the following values: USE_FIXED_PORT: Specifies a port number explicitly using the port field in the health check. Supported by backend services for passthrough load balancers and backend services for proxy load balancers. Not supported by target pools. The health check supports all backends supported by the backend service provided the backend can be health checked. For example, GCE_VM_IP network endpoint groups, GCE_VM_IP_PORT network endpoint groups, and instance group backends. USE_NAMED_PORT: Not supported. USE_SERVING_PORT: Provides an indirect method of specifying the health check port by referring to the backend service. Only supported by backend services for proxy load balancers. Not supported by target pools. Not supported by backend services for passthrough load balancers. Supports all backends that can be health checked; for example, GCE_VM_IP_PORT network endpoint groups and instance group backends. For GCE_VM_IP_PORT network endpoint group backends, the health check uses the port number specified for each endpoint in the network endpoint group. For instance group backends, the health check uses the port number determined by looking up the backend service's named port in the instance group's list of named ports. + * Specifies how a port is selected for health checking. Can be one of the + * following values: + * USE_FIXED_PORT: Specifies a port number explicitly using theport field in the health check. Supported by backend services + * for passthrough load balancers and backend services for proxy load + * balancers. Not supported by target pools. The health check supports all + * backends supported by the backend service provided the backend can be + * health checked. For example, GCE_VM_IP network endpoint + * groups, GCE_VM_IP_PORT network endpoint groups, and instance + * group backends. + * USE_NAMED_PORT: Not supported. + * USE_SERVING_PORT: Provides an indirect method of specifying + * the health check port by referring to the backend service. Only supported + * by backend services for proxy load balancers. Not supported by target + * pools. Not supported by backend services for passthrough load balancers. + * Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group + * backends. + * For GCE_VM_IP_PORT network endpoint group backends, the health + * check uses the port number specified for each endpoint in the network + * endpoint group. For instance group backends, the health check uses the + * port number determined by looking up the backend service's named port in + * the instance group's list of named ports. * * Protobuf type google.cloud.compute.v1.GRPCHealthCheck.PortSpecification */ @@ -20,7 +40,8 @@ class PortSpecification */ const UNDEFINED_PORT_SPECIFICATION = 0; /** - * The port number in the health check's port is used for health checking. Applies to network endpoint group and instance group backends. + * The port number in the health check's port is used for health + * checking. Applies to network endpoint group and instance group backends. * * Generated from protobuf enum USE_FIXED_PORT = 190235748; */ @@ -32,7 +53,10 @@ class PortSpecification */ const USE_NAMED_PORT = 349300671; /** - * For network endpoint group backends, the health check uses the port number specified on each endpoint in the network endpoint group. For instance group backends, the health check uses the port number specified for the backend service's named port defined in the instance group's named ports. + * For network endpoint group backends, the health check uses the port number + * specified on each endpoint in the network endpoint group. For instance + * group backends, the health check uses the port number specified for the + * backend service's named port defined in the instance group's named ports. * * Generated from protobuf enum USE_SERVING_PORT = 362637516; */ diff --git a/Compute/src/V1/GRPCTLSHealthCheck.php b/Compute/src/V1/GRPCTLSHealthCheck.php new file mode 100644 index 000000000000..fd7041026d4b --- /dev/null +++ b/Compute/src/V1/GRPCTLSHealthCheck.php @@ -0,0 +1,276 @@ +google.cloud.compute.v1.GRPCTLSHealthCheck + */ +class GRPCTLSHealthCheck extends \Google\Protobuf\Internal\Message +{ + /** + * The gRPC service name for the health check. This field is optional. The + * value of grpc_service_name has the following meanings by convention: + * - Empty service_name means the overall status of all services at the + * backend. + * - Non-empty service_name means the health of that gRPC service, as defined + * by the owner of the service. + * The grpc_service_name can only be ASCII. + * + * Generated from protobuf field optional string grpc_service_name = 136533078; + */ + protected $grpc_service_name = null; + /** + * The TCP port number to which the health check prober sends packets. Valid + * values are 1 through 65535. + * + * Generated from protobuf field optional int32 port = 3446913; + */ + protected $port = null; + /** + * Specifies how a port is selected for health checking. Can be one of the + * following values: + * USE_FIXED_PORT: Specifies a port number explicitly using theport field in the health check. Supported by backend services + * for passthrough load balancers and backend services for proxy load + * balancers. Not supported by target pools. The health check supports all + * backends supported by the backend service provided the backend can be + * health checked. For example, GCE_VM_IP network endpoint + * groups, GCE_VM_IP_PORT network endpoint groups, and instance + * group backends. + * USE_NAMED_PORT: Not supported. + * USE_SERVING_PORT: Provides an indirect method of specifying + * the health check port by referring to the backend service. Only supported + * by backend services for proxy load balancers. Not supported by target + * pools. Not supported by backend services for passthrough load balancers. + * Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group + * backends. + * For GCE_VM_IP_PORT network endpoint group backends, the health + * check uses the port number specified for each endpoint in the network + * endpoint group. For instance group backends, the health check uses the + * port number determined by looking up the backend service's named port in + * the instance group's list of named ports. + * Check the PortSpecification enum for the list of possible values. + * + * Generated from protobuf field optional string port_specification = 51590597; + */ + protected $port_specification = null; + + /** + * Constructor. + * + * @param array $data { + * Optional. Data for populating the Message object. + * + * @type string $grpc_service_name + * The gRPC service name for the health check. This field is optional. The + * value of grpc_service_name has the following meanings by convention: + * - Empty service_name means the overall status of all services at the + * backend. + * - Non-empty service_name means the health of that gRPC service, as defined + * by the owner of the service. + * The grpc_service_name can only be ASCII. + * @type int $port + * The TCP port number to which the health check prober sends packets. Valid + * values are 1 through 65535. + * @type string $port_specification + * Specifies how a port is selected for health checking. Can be one of the + * following values: + * USE_FIXED_PORT: Specifies a port number explicitly using theport field in the health check. Supported by backend services + * for passthrough load balancers and backend services for proxy load + * balancers. Not supported by target pools. The health check supports all + * backends supported by the backend service provided the backend can be + * health checked. For example, GCE_VM_IP network endpoint + * groups, GCE_VM_IP_PORT network endpoint groups, and instance + * group backends. + * USE_NAMED_PORT: Not supported. + * USE_SERVING_PORT: Provides an indirect method of specifying + * the health check port by referring to the backend service. Only supported + * by backend services for proxy load balancers. Not supported by target + * pools. Not supported by backend services for passthrough load balancers. + * Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group + * backends. + * For GCE_VM_IP_PORT network endpoint group backends, the health + * check uses the port number specified for each endpoint in the network + * endpoint group. For instance group backends, the health check uses the + * port number determined by looking up the backend service's named port in + * the instance group's list of named ports. + * Check the PortSpecification enum for the list of possible values. + * } + */ + public function __construct($data = NULL) { + \GPBMetadata\Google\Cloud\Compute\V1\Compute::initOnce(); + parent::__construct($data); + } + + /** + * The gRPC service name for the health check. This field is optional. The + * value of grpc_service_name has the following meanings by convention: + * - Empty service_name means the overall status of all services at the + * backend. + * - Non-empty service_name means the health of that gRPC service, as defined + * by the owner of the service. + * The grpc_service_name can only be ASCII. + * + * Generated from protobuf field optional string grpc_service_name = 136533078; + * @return string + */ + public function getGrpcServiceName() + { + return isset($this->grpc_service_name) ? $this->grpc_service_name : ''; + } + + public function hasGrpcServiceName() + { + return isset($this->grpc_service_name); + } + + public function clearGrpcServiceName() + { + unset($this->grpc_service_name); + } + + /** + * The gRPC service name for the health check. This field is optional. The + * value of grpc_service_name has the following meanings by convention: + * - Empty service_name means the overall status of all services at the + * backend. + * - Non-empty service_name means the health of that gRPC service, as defined + * by the owner of the service. + * The grpc_service_name can only be ASCII. + * + * Generated from protobuf field optional string grpc_service_name = 136533078; + * @param string $var + * @return $this + */ + public function setGrpcServiceName($var) + { + GPBUtil::checkString($var, True); + $this->grpc_service_name = $var; + + return $this; + } + + /** + * The TCP port number to which the health check prober sends packets. Valid + * values are 1 through 65535. + * + * Generated from protobuf field optional int32 port = 3446913; + * @return int + */ + public function getPort() + { + return isset($this->port) ? $this->port : 0; + } + + public function hasPort() + { + return isset($this->port); + } + + public function clearPort() + { + unset($this->port); + } + + /** + * The TCP port number to which the health check prober sends packets. Valid + * values are 1 through 65535. + * + * Generated from protobuf field optional int32 port = 3446913; + * @param int $var + * @return $this + */ + public function setPort($var) + { + GPBUtil::checkInt32($var); + $this->port = $var; + + return $this; + } + + /** + * Specifies how a port is selected for health checking. Can be one of the + * following values: + * USE_FIXED_PORT: Specifies a port number explicitly using theport field in the health check. Supported by backend services + * for passthrough load balancers and backend services for proxy load + * balancers. Not supported by target pools. The health check supports all + * backends supported by the backend service provided the backend can be + * health checked. For example, GCE_VM_IP network endpoint + * groups, GCE_VM_IP_PORT network endpoint groups, and instance + * group backends. + * USE_NAMED_PORT: Not supported. + * USE_SERVING_PORT: Provides an indirect method of specifying + * the health check port by referring to the backend service. Only supported + * by backend services for proxy load balancers. Not supported by target + * pools. Not supported by backend services for passthrough load balancers. + * Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group + * backends. + * For GCE_VM_IP_PORT network endpoint group backends, the health + * check uses the port number specified for each endpoint in the network + * endpoint group. For instance group backends, the health check uses the + * port number determined by looking up the backend service's named port in + * the instance group's list of named ports. + * Check the PortSpecification enum for the list of possible values. + * + * Generated from protobuf field optional string port_specification = 51590597; + * @return string + */ + public function getPortSpecification() + { + return isset($this->port_specification) ? $this->port_specification : ''; + } + + public function hasPortSpecification() + { + return isset($this->port_specification); + } + + public function clearPortSpecification() + { + unset($this->port_specification); + } + + /** + * Specifies how a port is selected for health checking. Can be one of the + * following values: + * USE_FIXED_PORT: Specifies a port number explicitly using theport field in the health check. Supported by backend services + * for passthrough load balancers and backend services for proxy load + * balancers. Not supported by target pools. The health check supports all + * backends supported by the backend service provided the backend can be + * health checked. For example, GCE_VM_IP network endpoint + * groups, GCE_VM_IP_PORT network endpoint groups, and instance + * group backends. + * USE_NAMED_PORT: Not supported. + * USE_SERVING_PORT: Provides an indirect method of specifying + * the health check port by referring to the backend service. Only supported + * by backend services for proxy load balancers. Not supported by target + * pools. Not supported by backend services for passthrough load balancers. + * Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group + * backends. + * For GCE_VM_IP_PORT network endpoint group backends, the health + * check uses the port number specified for each endpoint in the network + * endpoint group. For instance group backends, the health check uses the + * port number determined by looking up the backend service's named port in + * the instance group's list of named ports. + * Check the PortSpecification enum for the list of possible values. + * + * Generated from protobuf field optional string port_specification = 51590597; + * @param string $var + * @return $this + */ + public function setPortSpecification($var) + { + GPBUtil::checkString($var, True); + $this->port_specification = $var; + + return $this; + } + +} + diff --git a/Compute/src/V1/GRPCTLSHealthCheck/PortSpecification.php b/Compute/src/V1/GRPCTLSHealthCheck/PortSpecification.php new file mode 100644 index 000000000000..ac31ee840379 --- /dev/null +++ b/Compute/src/V1/GRPCTLSHealthCheck/PortSpecification.php @@ -0,0 +1,93 @@ +google.cloud.compute.v1.GRPCTLSHealthCheck.PortSpecification + */ +class PortSpecification +{ + /** + * A value indicating that the enum field is not set. + * + * Generated from protobuf enum UNDEFINED_PORT_SPECIFICATION = 0; + */ + const UNDEFINED_PORT_SPECIFICATION = 0; + /** + * The port number in the health check's port is used for health + * checking. Applies to network endpoint group and instance group backends. + * + * Generated from protobuf enum USE_FIXED_PORT = 190235748; + */ + const USE_FIXED_PORT = 190235748; + /** + * Not supported. + * + * Generated from protobuf enum USE_NAMED_PORT = 349300671; + */ + const USE_NAMED_PORT = 349300671; + /** + * For network endpoint group backends, the health check uses the port number + * specified on each endpoint in the network endpoint group. For instance + * group backends, the health check uses the port number specified for the + * backend service's named port defined in the instance group's named ports. + * + * Generated from protobuf enum USE_SERVING_PORT = 362637516; + */ + const USE_SERVING_PORT = 362637516; + + private static $valueToName = [ + self::UNDEFINED_PORT_SPECIFICATION => 'UNDEFINED_PORT_SPECIFICATION', + self::USE_FIXED_PORT => 'USE_FIXED_PORT', + self::USE_NAMED_PORT => 'USE_NAMED_PORT', + self::USE_SERVING_PORT => 'USE_SERVING_PORT', + ]; + + public static function name($value) + { + if (!isset(self::$valueToName[$value])) { + throw new UnexpectedValueException(sprintf( + 'Enum %s has no name defined for value %s', __CLASS__, $value)); + } + return self::$valueToName[$value]; + } + + + public static function value($name) + { + $const = __CLASS__ . '::' . strtoupper($name); + if (!defined($const)) { + throw new UnexpectedValueException(sprintf( + 'Enum %s has no value defined for name %s', __CLASS__, $name)); + } + return constant($const); + } +} + + diff --git a/Compute/src/V1/GetCrossSiteNetworkRequest.php b/Compute/src/V1/GetCrossSiteNetworkRequest.php new file mode 100644 index 000000000000..7d8a504405d4 --- /dev/null +++ b/Compute/src/V1/GetCrossSiteNetworkRequest.php @@ -0,0 +1,116 @@ +google.cloud.compute.v1.GetCrossSiteNetworkRequest + */ +class GetCrossSiteNetworkRequest extends \Google\Protobuf\Internal\Message +{ + /** + * Name of the cross-site network to return. + * + * Generated from protobuf field string cross_site_network = 108192469 [(.google.api.field_behavior) = REQUIRED]; + */ + protected $cross_site_network = ''; + /** + * Project ID for this request. + * + * Generated from protobuf field string project = 227560217 [(.google.api.field_behavior) = REQUIRED]; + */ + protected $project = ''; + + /** + * @param string $project Project ID for this request. + * @param string $crossSiteNetwork Name of the cross-site network to return. + * + * @return \Google\Cloud\Compute\V1\GetCrossSiteNetworkRequest + * + * @experimental + */ + public static function build(string $project, string $crossSiteNetwork): self + { + return (new self()) + ->setProject($project) + ->setCrossSiteNetwork($crossSiteNetwork); + } + + /** + * Constructor. + * + * @param array $data { + * Optional. Data for populating the Message object. + * + * @type string $cross_site_network + * Name of the cross-site network to return. + * @type string $project + * Project ID for this request. + * } + */ + public function __construct($data = NULL) { + \GPBMetadata\Google\Cloud\Compute\V1\Compute::initOnce(); + parent::__construct($data); + } + + /** + * Name of the cross-site network to return. + * + * Generated from protobuf field string cross_site_network = 108192469 [(.google.api.field_behavior) = REQUIRED]; + * @return string + */ + public function getCrossSiteNetwork() + { + return $this->cross_site_network; + } + + /** + * Name of the cross-site network to return. + * + * Generated from protobuf field string cross_site_network = 108192469 [(.google.api.field_behavior) = REQUIRED]; + * @param string $var + * @return $this + */ + public function setCrossSiteNetwork($var) + { + GPBUtil::checkString($var, True); + $this->cross_site_network = $var; + + return $this; + } + + /** + * Project ID for this request. + * + * Generated from protobuf field string project = 227560217 [(.google.api.field_behavior) = REQUIRED]; + * @return string + */ + public function getProject() + { + return $this->project; + } + + /** + * Project ID for this request. + * + * Generated from protobuf field string project = 227560217 [(.google.api.field_behavior) = REQUIRED]; + * @param string $var + * @return $this + */ + public function setProject($var) + { + GPBUtil::checkString($var, True); + $this->project = $var; + + return $this; + } + +} + diff --git a/Compute/src/V1/GetFromFamilyImageRequest.php b/Compute/src/V1/GetFromFamilyImageRequest.php index 8459666d0dba..47b5aeab3964 100644 --- a/Compute/src/V1/GetFromFamilyImageRequest.php +++ b/Compute/src/V1/GetFromFamilyImageRequest.php @@ -22,14 +22,16 @@ class GetFromFamilyImageRequest extends \Google\Protobuf\Internal\Message */ protected $family = ''; /** - * The image project that the image belongs to. For example, to get a CentOS image, specify centos-cloud as the image project. + * The image project that the image belongs to. For example, to get a CentOS + * image, specify centos-cloud as the image project. * * Generated from protobuf field string project = 227560217 [(.google.api.field_behavior) = REQUIRED]; */ protected $project = ''; /** - * @param string $project The image project that the image belongs to. For example, to get a CentOS image, specify centos-cloud as the image project. + * @param string $project The image project that the image belongs to. For example, to get a CentOS + * image, specify centos-cloud as the image project. * @param string $family Name of the image family to search for. * * @return \Google\Cloud\Compute\V1\GetFromFamilyImageRequest @@ -52,7 +54,8 @@ public static function build(string $project, string $family): self * @type string $family * Name of the image family to search for. * @type string $project - * The image project that the image belongs to. For example, to get a CentOS image, specify centos-cloud as the image project. + * The image project that the image belongs to. For example, to get a CentOS + * image, specify centos-cloud as the image project. * } */ public function __construct($data = NULL) { @@ -87,7 +90,8 @@ public function setFamily($var) } /** - * The image project that the image belongs to. For example, to get a CentOS image, specify centos-cloud as the image project. + * The image project that the image belongs to. For example, to get a CentOS + * image, specify centos-cloud as the image project. * * Generated from protobuf field string project = 227560217 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -98,7 +102,8 @@ public function getProject() } /** - * The image project that the image belongs to. For example, to get a CentOS image, specify centos-cloud as the image project. + * The image project that the image belongs to. For example, to get a CentOS + * image, specify centos-cloud as the image project. * * Generated from protobuf field string project = 227560217 [(.google.api.field_behavior) = REQUIRED]; * @param string $var diff --git a/Compute/src/V1/GetFutureReservationRequest.php b/Compute/src/V1/GetFutureReservationRequest.php new file mode 100644 index 000000000000..e1ee1d192348 --- /dev/null +++ b/Compute/src/V1/GetFutureReservationRequest.php @@ -0,0 +1,152 @@ +google.cloud.compute.v1.GetFutureReservationRequest + */ +class GetFutureReservationRequest extends \Google\Protobuf\Internal\Message +{ + /** + * Name of the future reservation to retrieve. Name should conform to RFC1035. + * + * Generated from protobuf field string future_reservation = 56206160 [(.google.api.field_behavior) = REQUIRED]; + */ + protected $future_reservation = ''; + /** + * Project ID for this request. + * + * Generated from protobuf field string project = 227560217 [(.google.api.field_behavior) = REQUIRED]; + */ + protected $project = ''; + /** + * Name of the zone for this request. Name should conform to RFC1035. + * + * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED]; + */ + protected $zone = ''; + + /** + * @param string $project Project ID for this request. + * @param string $zone Name of the zone for this request. Name should conform to RFC1035. + * @param string $futureReservation Name of the future reservation to retrieve. Name should conform to RFC1035. + * + * @return \Google\Cloud\Compute\V1\GetFutureReservationRequest + * + * @experimental + */ + public static function build(string $project, string $zone, string $futureReservation): self + { + return (new self()) + ->setProject($project) + ->setZone($zone) + ->setFutureReservation($futureReservation); + } + + /** + * Constructor. + * + * @param array $data { + * Optional. Data for populating the Message object. + * + * @type string $future_reservation + * Name of the future reservation to retrieve. Name should conform to RFC1035. + * @type string $project + * Project ID for this request. + * @type string $zone + * Name of the zone for this request. Name should conform to RFC1035. + * } + */ + public function __construct($data = NULL) { + \GPBMetadata\Google\Cloud\Compute\V1\Compute::initOnce(); + parent::__construct($data); + } + + /** + * Name of the future reservation to retrieve. Name should conform to RFC1035. + * + * Generated from protobuf field string future_reservation = 56206160 [(.google.api.field_behavior) = REQUIRED]; + * @return string + */ + public function getFutureReservation() + { + return $this->future_reservation; + } + + /** + * Name of the future reservation to retrieve. Name should conform to RFC1035. + * + * Generated from protobuf field string future_reservation = 56206160 [(.google.api.field_behavior) = REQUIRED]; + * @param string $var + * @return $this + */ + public function setFutureReservation($var) + { + GPBUtil::checkString($var, True); + $this->future_reservation = $var; + + return $this; + } + + /** + * Project ID for this request. + * + * Generated from protobuf field string project = 227560217 [(.google.api.field_behavior) = REQUIRED]; + * @return string + */ + public function getProject() + { + return $this->project; + } + + /** + * Project ID for this request. + * + * Generated from protobuf field string project = 227560217 [(.google.api.field_behavior) = REQUIRED]; + * @param string $var + * @return $this + */ + public function setProject($var) + { + GPBUtil::checkString($var, True); + $this->project = $var; + + return $this; + } + + /** + * Name of the zone for this request. Name should conform to RFC1035. + * + * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED]; + * @return string + */ + public function getZone() + { + return $this->zone; + } + + /** + * Name of the zone for this request. Name should conform to RFC1035. + * + * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED]; + * @param string $var + * @return $this + */ + public function setZone($var) + { + GPBUtil::checkString($var, True); + $this->zone = $var; + + return $this; + } + +} + diff --git a/Compute/src/V1/GetGlobalOperationRequest.php b/Compute/src/V1/GetGlobalOperationRequest.php index 58fdf66c8f37..5c4c4efe730a 100644 --- a/Compute/src/V1/GetGlobalOperationRequest.php +++ b/Compute/src/V1/GetGlobalOperationRequest.php @@ -16,7 +16,8 @@ class GetGlobalOperationRequest extends \Google\Protobuf\Internal\Message { /** - * Name of the Operations resource to return, or its unique numeric identifier. + * Name of the Operations resource to return, or its unique numeric + * identifier. * * Generated from protobuf field string operation = 52090215 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_response_field) = "name"]; */ @@ -30,7 +31,8 @@ class GetGlobalOperationRequest extends \Google\Protobuf\Internal\Message /** * @param string $project Project ID for this request. - * @param string $operation Name of the Operations resource to return, or its unique numeric identifier. + * @param string $operation Name of the Operations resource to return, or its unique numeric + * identifier. * * @return \Google\Cloud\Compute\V1\GetGlobalOperationRequest * @@ -50,7 +52,8 @@ public static function build(string $project, string $operation): self * Optional. Data for populating the Message object. * * @type string $operation - * Name of the Operations resource to return, or its unique numeric identifier. + * Name of the Operations resource to return, or its unique numeric + * identifier. * @type string $project * Project ID for this request. * } @@ -61,7 +64,8 @@ public function __construct($data = NULL) { } /** - * Name of the Operations resource to return, or its unique numeric identifier. + * Name of the Operations resource to return, or its unique numeric + * identifier. * * Generated from protobuf field string operation = 52090215 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_response_field) = "name"]; * @return string @@ -72,7 +76,8 @@ public function getOperation() } /** - * Name of the Operations resource to return, or its unique numeric identifier. + * Name of the Operations resource to return, or its unique numeric + * identifier. * * Generated from protobuf field string operation = 52090215 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_response_field) = "name"]; * @param string $var diff --git a/Compute/src/V1/GetGlobalOrganizationOperationRequest.php b/Compute/src/V1/GetGlobalOrganizationOperationRequest.php index d431efe1223f..ea2c77d8050b 100644 --- a/Compute/src/V1/GetGlobalOrganizationOperationRequest.php +++ b/Compute/src/V1/GetGlobalOrganizationOperationRequest.php @@ -16,7 +16,8 @@ class GetGlobalOrganizationOperationRequest extends \Google\Protobuf\Internal\Message { /** - * Name of the Operations resource to return. Parent is derived from this field. + * Name of the Operations resource to return. Parent is derived from this + * field. * * Generated from protobuf field string operation = 52090215 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_response_field) = "name"]; */ @@ -29,7 +30,8 @@ class GetGlobalOrganizationOperationRequest extends \Google\Protobuf\Internal\Me protected $parent_id = null; /** - * @param string $operation Name of the Operations resource to return. Parent is derived from this field. + * @param string $operation Name of the Operations resource to return. Parent is derived from this + * field. * * @return \Google\Cloud\Compute\V1\GetGlobalOrganizationOperationRequest * @@ -48,7 +50,8 @@ public static function build(string $operation): self * Optional. Data for populating the Message object. * * @type string $operation - * Name of the Operations resource to return. Parent is derived from this field. + * Name of the Operations resource to return. Parent is derived from this + * field. * @type string $parent_id * Parent ID for this request. Not used. Parent is derived from resource_id. * } @@ -59,7 +62,8 @@ public function __construct($data = NULL) { } /** - * Name of the Operations resource to return. Parent is derived from this field. + * Name of the Operations resource to return. Parent is derived from this + * field. * * Generated from protobuf field string operation = 52090215 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_response_field) = "name"]; * @return string @@ -70,7 +74,8 @@ public function getOperation() } /** - * Name of the Operations resource to return. Parent is derived from this field. + * Name of the Operations resource to return. Parent is derived from this + * field. * * Generated from protobuf field string operation = 52090215 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_response_field) = "name"]; * @param string $var diff --git a/Compute/src/V1/GetIamPolicyReservationBlockRequest.php b/Compute/src/V1/GetIamPolicyReservationBlockRequest.php new file mode 100644 index 000000000000..8dbb6c79e286 --- /dev/null +++ b/Compute/src/V1/GetIamPolicyReservationBlockRequest.php @@ -0,0 +1,232 @@ +google.cloud.compute.v1.GetIamPolicyReservationBlockRequest + */ +class GetIamPolicyReservationBlockRequest extends \Google\Protobuf\Internal\Message +{ + /** + * Requested IAM Policy version. + * + * Generated from protobuf field optional int32 options_requested_policy_version = 499220029; + */ + protected $options_requested_policy_version = null; + /** + * Name or id of parent resource of the resource for this request. + * + * Generated from protobuf field string parent_resource = 18091011 [(.google.api.field_behavior) = REQUIRED]; + */ + protected $parent_resource = ''; + /** + * Project ID for this request. + * + * Generated from protobuf field string project = 227560217 [(.google.api.field_behavior) = REQUIRED]; + */ + protected $project = ''; + /** + * Name or id of the resource for this request. + * + * Generated from protobuf field string resource = 195806222 [(.google.api.field_behavior) = REQUIRED]; + */ + protected $resource = ''; + /** + * The name of the zone for this request. + * + * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED]; + */ + protected $zone = ''; + + /** + * @param string $project Project ID for this request. + * @param string $zone The name of the zone for this request. + * @param string $parentResource Name or id of parent resource of the resource for this request. + * @param string $resource Name or id of the resource for this request. + * + * @return \Google\Cloud\Compute\V1\GetIamPolicyReservationBlockRequest + * + * @experimental + */ + public static function build(string $project, string $zone, string $parentResource, string $resource): self + { + return (new self()) + ->setProject($project) + ->setZone($zone) + ->setParentResource($parentResource) + ->setResource($resource); + } + + /** + * Constructor. + * + * @param array $data { + * Optional. Data for populating the Message object. + * + * @type int $options_requested_policy_version + * Requested IAM Policy version. + * @type string $parent_resource + * Name or id of parent resource of the resource for this request. + * @type string $project + * Project ID for this request. + * @type string $resource + * Name or id of the resource for this request. + * @type string $zone + * The name of the zone for this request. + * } + */ + public function __construct($data = NULL) { + \GPBMetadata\Google\Cloud\Compute\V1\Compute::initOnce(); + parent::__construct($data); + } + + /** + * Requested IAM Policy version. + * + * Generated from protobuf field optional int32 options_requested_policy_version = 499220029; + * @return int + */ + public function getOptionsRequestedPolicyVersion() + { + return isset($this->options_requested_policy_version) ? $this->options_requested_policy_version : 0; + } + + public function hasOptionsRequestedPolicyVersion() + { + return isset($this->options_requested_policy_version); + } + + public function clearOptionsRequestedPolicyVersion() + { + unset($this->options_requested_policy_version); + } + + /** + * Requested IAM Policy version. + * + * Generated from protobuf field optional int32 options_requested_policy_version = 499220029; + * @param int $var + * @return $this + */ + public function setOptionsRequestedPolicyVersion($var) + { + GPBUtil::checkInt32($var); + $this->options_requested_policy_version = $var; + + return $this; + } + + /** + * Name or id of parent resource of the resource for this request. + * + * Generated from protobuf field string parent_resource = 18091011 [(.google.api.field_behavior) = REQUIRED]; + * @return string + */ + public function getParentResource() + { + return $this->parent_resource; + } + + /** + * Name or id of parent resource of the resource for this request. + * + * Generated from protobuf field string parent_resource = 18091011 [(.google.api.field_behavior) = REQUIRED]; + * @param string $var + * @return $this + */ + public function setParentResource($var) + { + GPBUtil::checkString($var, True); + $this->parent_resource = $var; + + return $this; + } + + /** + * Project ID for this request. + * + * Generated from protobuf field string project = 227560217 [(.google.api.field_behavior) = REQUIRED]; + * @return string + */ + public function getProject() + { + return $this->project; + } + + /** + * Project ID for this request. + * + * Generated from protobuf field string project = 227560217 [(.google.api.field_behavior) = REQUIRED]; + * @param string $var + * @return $this + */ + public function setProject($var) + { + GPBUtil::checkString($var, True); + $this->project = $var; + + return $this; + } + + /** + * Name or id of the resource for this request. + * + * Generated from protobuf field string resource = 195806222 [(.google.api.field_behavior) = REQUIRED]; + * @return string + */ + public function getResource() + { + return $this->resource; + } + + /** + * Name or id of the resource for this request. + * + * Generated from protobuf field string resource = 195806222 [(.google.api.field_behavior) = REQUIRED]; + * @param string $var + * @return $this + */ + public function setResource($var) + { + GPBUtil::checkString($var, True); + $this->resource = $var; + + return $this; + } + + /** + * The name of the zone for this request. + * + * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED]; + * @return string + */ + public function getZone() + { + return $this->zone; + } + + /** + * The name of the zone for this request. + * + * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED]; + * @param string $var + * @return $this + */ + public function setZone($var) + { + GPBUtil::checkString($var, True); + $this->zone = $var; + + return $this; + } + +} + diff --git a/Compute/src/V1/GetIamPolicyReservationSubBlockRequest.php b/Compute/src/V1/GetIamPolicyReservationSubBlockRequest.php new file mode 100644 index 000000000000..0be0d48b1884 --- /dev/null +++ b/Compute/src/V1/GetIamPolicyReservationSubBlockRequest.php @@ -0,0 +1,232 @@ +google.cloud.compute.v1.GetIamPolicyReservationSubBlockRequest + */ +class GetIamPolicyReservationSubBlockRequest extends \Google\Protobuf\Internal\Message +{ + /** + * Requested IAM Policy version. + * + * Generated from protobuf field optional int32 options_requested_policy_version = 499220029; + */ + protected $options_requested_policy_version = null; + /** + * Name or id of parent resource of the resource for this request. + * + * Generated from protobuf field string parent_resource = 18091011 [(.google.api.field_behavior) = REQUIRED]; + */ + protected $parent_resource = ''; + /** + * Project ID for this request. + * + * Generated from protobuf field string project = 227560217 [(.google.api.field_behavior) = REQUIRED]; + */ + protected $project = ''; + /** + * Name or id of the resource for this request. + * + * Generated from protobuf field string resource = 195806222 [(.google.api.field_behavior) = REQUIRED]; + */ + protected $resource = ''; + /** + * The name of the zone for this request. + * + * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED]; + */ + protected $zone = ''; + + /** + * @param string $project Project ID for this request. + * @param string $zone The name of the zone for this request. + * @param string $parentResource Name or id of parent resource of the resource for this request. + * @param string $resource Name or id of the resource for this request. + * + * @return \Google\Cloud\Compute\V1\GetIamPolicyReservationSubBlockRequest + * + * @experimental + */ + public static function build(string $project, string $zone, string $parentResource, string $resource): self + { + return (new self()) + ->setProject($project) + ->setZone($zone) + ->setParentResource($parentResource) + ->setResource($resource); + } + + /** + * Constructor. + * + * @param array $data { + * Optional. Data for populating the Message object. + * + * @type int $options_requested_policy_version + * Requested IAM Policy version. + * @type string $parent_resource + * Name or id of parent resource of the resource for this request. + * @type string $project + * Project ID for this request. + * @type string $resource + * Name or id of the resource for this request. + * @type string $zone + * The name of the zone for this request. + * } + */ + public function __construct($data = NULL) { + \GPBMetadata\Google\Cloud\Compute\V1\Compute::initOnce(); + parent::__construct($data); + } + + /** + * Requested IAM Policy version. + * + * Generated from protobuf field optional int32 options_requested_policy_version = 499220029; + * @return int + */ + public function getOptionsRequestedPolicyVersion() + { + return isset($this->options_requested_policy_version) ? $this->options_requested_policy_version : 0; + } + + public function hasOptionsRequestedPolicyVersion() + { + return isset($this->options_requested_policy_version); + } + + public function clearOptionsRequestedPolicyVersion() + { + unset($this->options_requested_policy_version); + } + + /** + * Requested IAM Policy version. + * + * Generated from protobuf field optional int32 options_requested_policy_version = 499220029; + * @param int $var + * @return $this + */ + public function setOptionsRequestedPolicyVersion($var) + { + GPBUtil::checkInt32($var); + $this->options_requested_policy_version = $var; + + return $this; + } + + /** + * Name or id of parent resource of the resource for this request. + * + * Generated from protobuf field string parent_resource = 18091011 [(.google.api.field_behavior) = REQUIRED]; + * @return string + */ + public function getParentResource() + { + return $this->parent_resource; + } + + /** + * Name or id of parent resource of the resource for this request. + * + * Generated from protobuf field string parent_resource = 18091011 [(.google.api.field_behavior) = REQUIRED]; + * @param string $var + * @return $this + */ + public function setParentResource($var) + { + GPBUtil::checkString($var, True); + $this->parent_resource = $var; + + return $this; + } + + /** + * Project ID for this request. + * + * Generated from protobuf field string project = 227560217 [(.google.api.field_behavior) = REQUIRED]; + * @return string + */ + public function getProject() + { + return $this->project; + } + + /** + * Project ID for this request. + * + * Generated from protobuf field string project = 227560217 [(.google.api.field_behavior) = REQUIRED]; + * @param string $var + * @return $this + */ + public function setProject($var) + { + GPBUtil::checkString($var, True); + $this->project = $var; + + return $this; + } + + /** + * Name or id of the resource for this request. + * + * Generated from protobuf field string resource = 195806222 [(.google.api.field_behavior) = REQUIRED]; + * @return string + */ + public function getResource() + { + return $this->resource; + } + + /** + * Name or id of the resource for this request. + * + * Generated from protobuf field string resource = 195806222 [(.google.api.field_behavior) = REQUIRED]; + * @param string $var + * @return $this + */ + public function setResource($var) + { + GPBUtil::checkString($var, True); + $this->resource = $var; + + return $this; + } + + /** + * The name of the zone for this request. + * + * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED]; + * @return string + */ + public function getZone() + { + return $this->zone; + } + + /** + * The name of the zone for this request. + * + * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED]; + * @param string $var + * @return $this + */ + public function setZone($var) + { + GPBUtil::checkString($var, True); + $this->zone = $var; + + return $this; + } + +} + diff --git a/Compute/src/V1/GetInstanceGroupManagerRequest.php b/Compute/src/V1/GetInstanceGroupManagerRequest.php index c7df32c4971a..f427201f51ad 100644 --- a/Compute/src/V1/GetInstanceGroupManagerRequest.php +++ b/Compute/src/V1/GetInstanceGroupManagerRequest.php @@ -28,7 +28,8 @@ class GetInstanceGroupManagerRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * The name of the zone where the managed instance group is located. + * The name of thezone where the managed + * instance group is located. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED]; */ @@ -36,7 +37,8 @@ class GetInstanceGroupManagerRequest extends \Google\Protobuf\Internal\Message /** * @param string $project Project ID for this request. - * @param string $zone The name of the zone where the managed instance group is located. + * @param string $zone The name of thezone where the managed + * instance group is located. * @param string $instanceGroupManager The name of the managed instance group. * * @return \Google\Cloud\Compute\V1\GetInstanceGroupManagerRequest @@ -62,7 +64,8 @@ public static function build(string $project, string $zone, string $instanceGrou * @type string $project * Project ID for this request. * @type string $zone - * The name of the zone where the managed instance group is located. + * The name of thezone where the managed + * instance group is located. * } */ public function __construct($data = NULL) { @@ -123,7 +126,8 @@ public function setProject($var) } /** - * The name of the zone where the managed instance group is located. + * The name of thezone where the managed + * instance group is located. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -134,7 +138,8 @@ public function getZone() } /** - * The name of the zone where the managed instance group is located. + * The name of thezone where the managed + * instance group is located. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED]; * @param string $var diff --git a/Compute/src/V1/GetInstanceGroupManagerResizeRequestRequest.php b/Compute/src/V1/GetInstanceGroupManagerResizeRequestRequest.php index 58418bdf9cd7..ddfe36e14f0b 100644 --- a/Compute/src/V1/GetInstanceGroupManagerResizeRequestRequest.php +++ b/Compute/src/V1/GetInstanceGroupManagerResizeRequestRequest.php @@ -16,7 +16,8 @@ class GetInstanceGroupManagerResizeRequestRequest extends \Google\Protobuf\Internal\Message { /** - * The name of the managed instance group. Name should conform to RFC1035 or be a resource ID. + * The name of the managed instance group. + * Name should conform to RFC1035 or be a resource ID. * * Generated from protobuf field string instance_group_manager = 249363395 [(.google.api.field_behavior) = REQUIRED]; */ @@ -28,13 +29,15 @@ class GetInstanceGroupManagerResizeRequestRequest extends \Google\Protobuf\Inter */ protected $project = ''; /** - * The name of the resize request. Name should conform to RFC1035 or be a resource ID. + * The name of the resize request. + * Name should conform to RFC1035 or be a resource ID. * * Generated from protobuf field string resize_request = 216941060 [(.google.api.field_behavior) = REQUIRED]; */ protected $resize_request = ''; /** - * Name of the href="/compute/docs/regions-zones/#available">zone scoping this request. Name should conform to RFC1035. + * Name of the href="/compute/docs/regions-zones/#available">zone + * scoping this request. Name should conform to RFC1035. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED]; */ @@ -42,9 +45,12 @@ class GetInstanceGroupManagerResizeRequestRequest extends \Google\Protobuf\Inter /** * @param string $project Project ID for this request. - * @param string $zone Name of the href="/compute/docs/regions-zones/#available">zone scoping this request. Name should conform to RFC1035. - * @param string $instanceGroupManager The name of the managed instance group. Name should conform to RFC1035 or be a resource ID. - * @param string $resizeRequest The name of the resize request. Name should conform to RFC1035 or be a resource ID. + * @param string $zone Name of the href="/compute/docs/regions-zones/#available">zone + * scoping this request. Name should conform to RFC1035. + * @param string $instanceGroupManager The name of the managed instance group. + * Name should conform to RFC1035 or be a resource ID. + * @param string $resizeRequest The name of the resize request. + * Name should conform to RFC1035 or be a resource ID. * * @return \Google\Cloud\Compute\V1\GetInstanceGroupManagerResizeRequestRequest * @@ -66,13 +72,16 @@ public static function build(string $project, string $zone, string $instanceGrou * Optional. Data for populating the Message object. * * @type string $instance_group_manager - * The name of the managed instance group. Name should conform to RFC1035 or be a resource ID. + * The name of the managed instance group. + * Name should conform to RFC1035 or be a resource ID. * @type string $project * Project ID for this request. * @type string $resize_request - * The name of the resize request. Name should conform to RFC1035 or be a resource ID. + * The name of the resize request. + * Name should conform to RFC1035 or be a resource ID. * @type string $zone - * Name of the href="/compute/docs/regions-zones/#available">zone scoping this request. Name should conform to RFC1035. + * Name of the href="/compute/docs/regions-zones/#available">zone + * scoping this request. Name should conform to RFC1035. * } */ public function __construct($data = NULL) { @@ -81,7 +90,8 @@ public function __construct($data = NULL) { } /** - * The name of the managed instance group. Name should conform to RFC1035 or be a resource ID. + * The name of the managed instance group. + * Name should conform to RFC1035 or be a resource ID. * * Generated from protobuf field string instance_group_manager = 249363395 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -92,7 +102,8 @@ public function getInstanceGroupManager() } /** - * The name of the managed instance group. Name should conform to RFC1035 or be a resource ID. + * The name of the managed instance group. + * Name should conform to RFC1035 or be a resource ID. * * Generated from protobuf field string instance_group_manager = 249363395 [(.google.api.field_behavior) = REQUIRED]; * @param string $var @@ -133,7 +144,8 @@ public function setProject($var) } /** - * The name of the resize request. Name should conform to RFC1035 or be a resource ID. + * The name of the resize request. + * Name should conform to RFC1035 or be a resource ID. * * Generated from protobuf field string resize_request = 216941060 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -144,7 +156,8 @@ public function getResizeRequest() } /** - * The name of the resize request. Name should conform to RFC1035 or be a resource ID. + * The name of the resize request. + * Name should conform to RFC1035 or be a resource ID. * * Generated from protobuf field string resize_request = 216941060 [(.google.api.field_behavior) = REQUIRED]; * @param string $var @@ -159,7 +172,8 @@ public function setResizeRequest($var) } /** - * Name of the href="/compute/docs/regions-zones/#available">zone scoping this request. Name should conform to RFC1035. + * Name of the href="/compute/docs/regions-zones/#available">zone + * scoping this request. Name should conform to RFC1035. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -170,7 +184,8 @@ public function getZone() } /** - * Name of the href="/compute/docs/regions-zones/#available">zone scoping this request. Name should conform to RFC1035. + * Name of the href="/compute/docs/regions-zones/#available">zone + * scoping this request. Name should conform to RFC1035. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED]; * @param string $var diff --git a/Compute/src/V1/GetInstanceGroupRequest.php b/Compute/src/V1/GetInstanceGroupRequest.php index 034c9fefa6ba..43bf37dbe3ad 100644 --- a/Compute/src/V1/GetInstanceGroupRequest.php +++ b/Compute/src/V1/GetInstanceGroupRequest.php @@ -28,7 +28,8 @@ class GetInstanceGroupRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * The name of the zone where the instance group is located. + * The name of the zone + * where the instance group is located. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED]; */ @@ -36,7 +37,8 @@ class GetInstanceGroupRequest extends \Google\Protobuf\Internal\Message /** * @param string $project Project ID for this request. - * @param string $zone The name of the zone where the instance group is located. + * @param string $zone The name of the zone + * where the instance group is located. * @param string $instanceGroup The name of the instance group. * * @return \Google\Cloud\Compute\V1\GetInstanceGroupRequest @@ -62,7 +64,8 @@ public static function build(string $project, string $zone, string $instanceGrou * @type string $project * Project ID for this request. * @type string $zone - * The name of the zone where the instance group is located. + * The name of the zone + * where the instance group is located. * } */ public function __construct($data = NULL) { @@ -123,7 +126,8 @@ public function setProject($var) } /** - * The name of the zone where the instance group is located. + * The name of the zone + * where the instance group is located. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -134,7 +138,8 @@ public function getZone() } /** - * The name of the zone where the instance group is located. + * The name of the zone + * where the instance group is located. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED]; * @param string $var diff --git a/Compute/src/V1/GetNatIpInfoRouterRequest.php b/Compute/src/V1/GetNatIpInfoRouterRequest.php index abd2653c6bd0..79e9ff49cf39 100644 --- a/Compute/src/V1/GetNatIpInfoRouterRequest.php +++ b/Compute/src/V1/GetNatIpInfoRouterRequest.php @@ -16,7 +16,9 @@ class GetNatIpInfoRouterRequest extends \Google\Protobuf\Internal\Message { /** - * Name of the nat service to filter the NAT IP information. If it is omitted, all nats for this router will be returned. Name should conform to RFC1035. + * Name of the nat service to filter the NAT IP information. + * If it is omitted, all nats for this router will be returned. + * Name should conform to RFC1035. * * Generated from protobuf field optional string nat_name = 425596649; */ @@ -34,7 +36,8 @@ class GetNatIpInfoRouterRequest extends \Google\Protobuf\Internal\Message */ protected $region = ''; /** - * Name of the Router resource to query for Nat IP information. The name should conform to RFC1035. + * Name of the Router resource to query for Nat IP information. The name + * should conform to RFC1035. * * Generated from protobuf field string router = 148608841 [(.google.api.field_behavior) = REQUIRED]; */ @@ -43,7 +46,8 @@ class GetNatIpInfoRouterRequest extends \Google\Protobuf\Internal\Message /** * @param string $project Project ID for this request. * @param string $region Name of the region for this request. - * @param string $router Name of the Router resource to query for Nat IP information. The name should conform to RFC1035. + * @param string $router Name of the Router resource to query for Nat IP information. The name + * should conform to RFC1035. * * @return \Google\Cloud\Compute\V1\GetNatIpInfoRouterRequest * @@ -64,13 +68,16 @@ public static function build(string $project, string $region, string $router): s * Optional. Data for populating the Message object. * * @type string $nat_name - * Name of the nat service to filter the NAT IP information. If it is omitted, all nats for this router will be returned. Name should conform to RFC1035. + * Name of the nat service to filter the NAT IP information. + * If it is omitted, all nats for this router will be returned. + * Name should conform to RFC1035. * @type string $project * Project ID for this request. * @type string $region * Name of the region for this request. * @type string $router - * Name of the Router resource to query for Nat IP information. The name should conform to RFC1035. + * Name of the Router resource to query for Nat IP information. The name + * should conform to RFC1035. * } */ public function __construct($data = NULL) { @@ -79,7 +86,9 @@ public function __construct($data = NULL) { } /** - * Name of the nat service to filter the NAT IP information. If it is omitted, all nats for this router will be returned. Name should conform to RFC1035. + * Name of the nat service to filter the NAT IP information. + * If it is omitted, all nats for this router will be returned. + * Name should conform to RFC1035. * * Generated from protobuf field optional string nat_name = 425596649; * @return string @@ -100,7 +109,9 @@ public function clearNatName() } /** - * Name of the nat service to filter the NAT IP information. If it is omitted, all nats for this router will be returned. Name should conform to RFC1035. + * Name of the nat service to filter the NAT IP information. + * If it is omitted, all nats for this router will be returned. + * Name should conform to RFC1035. * * Generated from protobuf field optional string nat_name = 425596649; * @param string $var @@ -167,7 +178,8 @@ public function setRegion($var) } /** - * Name of the Router resource to query for Nat IP information. The name should conform to RFC1035. + * Name of the Router resource to query for Nat IP information. The name + * should conform to RFC1035. * * Generated from protobuf field string router = 148608841 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -178,7 +190,8 @@ public function getRouter() } /** - * Name of the Router resource to query for Nat IP information. The name should conform to RFC1035. + * Name of the Router resource to query for Nat IP information. The name + * should conform to RFC1035. * * Generated from protobuf field string router = 148608841 [(.google.api.field_behavior) = REQUIRED]; * @param string $var diff --git a/Compute/src/V1/GetNatMappingInfoRoutersRequest.php b/Compute/src/V1/GetNatMappingInfoRoutersRequest.php index 3418cc0a5fef..730e98a979cd 100644 --- a/Compute/src/V1/GetNatMappingInfoRoutersRequest.php +++ b/Compute/src/V1/GetNatMappingInfoRoutersRequest.php @@ -16,31 +16,94 @@ class GetNatMappingInfoRoutersRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Name of the nat service to filter the Nat Mapping information. If it is omitted, all nats for this router will be returned. Name should conform to RFC1035. + * Name of the nat service to filter the Nat Mapping information. + * If it is omitted, all nats for this router will be returned. + * Name should conform to RFC1035. * * Generated from protobuf field optional string nat_name = 425596649; */ protected $nat_name = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -58,13 +121,18 @@ class GetNatMappingInfoRoutersRequest extends \Google\Protobuf\Internal\Message */ protected $region = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ protected $return_partial_success = null; /** - * Name of the Router resource to query for Nat Mapping information of VM endpoints. + * Name of the Router resource to query for Nat Mapping information of + * VM endpoints. * * Generated from protobuf field string router = 148608841 [(.google.api.field_behavior) = REQUIRED]; */ @@ -73,7 +141,8 @@ class GetNatMappingInfoRoutersRequest extends \Google\Protobuf\Internal\Message /** * @param string $project Project ID for this request. * @param string $region Name of the region for this request. - * @param string $router Name of the Router resource to query for Nat Mapping information of VM endpoints. + * @param string $router Name of the Router resource to query for Nat Mapping information of + * VM endpoints. * * @return \Google\Cloud\Compute\V1\GetNatMappingInfoRoutersRequest * @@ -94,23 +163,91 @@ public static function build(string $project, string $region, string $router): s * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $nat_name - * Name of the nat service to filter the Nat Mapping information. If it is omitted, all nats for this router will be returned. Name should conform to RFC1035. + * Name of the nat service to filter the Nat Mapping information. + * If it is omitted, all nats for this router will be returned. + * Name should conform to RFC1035. * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type string $region * Name of the region for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * @type string $router - * Name of the Router resource to query for Nat Mapping information of VM endpoints. + * Name of the Router resource to query for Nat Mapping information of + * VM endpoints. * } */ public function __construct($data = NULL) { @@ -119,7 +256,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -140,7 +324,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -155,7 +386,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -176,7 +411,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -191,7 +430,9 @@ public function setMaxResults($var) } /** - * Name of the nat service to filter the Nat Mapping information. If it is omitted, all nats for this router will be returned. Name should conform to RFC1035. + * Name of the nat service to filter the Nat Mapping information. + * If it is omitted, all nats for this router will be returned. + * Name should conform to RFC1035. * * Generated from protobuf field optional string nat_name = 425596649; * @return string @@ -212,7 +453,9 @@ public function clearNatName() } /** - * Name of the nat service to filter the Nat Mapping information. If it is omitted, all nats for this router will be returned. Name should conform to RFC1035. + * Name of the nat service to filter the Nat Mapping information. + * If it is omitted, all nats for this router will be returned. + * Name should conform to RFC1035. * * Generated from protobuf field optional string nat_name = 425596649; * @param string $var @@ -227,7 +470,15 @@ public function setNatName($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -248,7 +499,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -263,7 +522,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -284,7 +545,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -351,7 +614,11 @@ public function setRegion($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -372,7 +639,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var @@ -387,7 +658,8 @@ public function setReturnPartialSuccess($var) } /** - * Name of the Router resource to query for Nat Mapping information of VM endpoints. + * Name of the Router resource to query for Nat Mapping information of + * VM endpoints. * * Generated from protobuf field string router = 148608841 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -398,7 +670,8 @@ public function getRouter() } /** - * Name of the Router resource to query for Nat Mapping information of VM endpoints. + * Name of the Router resource to query for Nat Mapping information of + * VM endpoints. * * Generated from protobuf field string router = 148608841 [(.google.api.field_behavior) = REQUIRED]; * @param string $var diff --git a/Compute/src/V1/GetNetworkEndpointGroupRequest.php b/Compute/src/V1/GetNetworkEndpointGroupRequest.php index 455a9b4d439e..4637ebaaf847 100644 --- a/Compute/src/V1/GetNetworkEndpointGroupRequest.php +++ b/Compute/src/V1/GetNetworkEndpointGroupRequest.php @@ -28,7 +28,8 @@ class GetNetworkEndpointGroupRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * The name of the zone where the network endpoint group is located. It should comply with RFC1035. + * The name of the zone where + * the network endpoint group is located. It should comply with RFC1035. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED]; */ @@ -36,7 +37,8 @@ class GetNetworkEndpointGroupRequest extends \Google\Protobuf\Internal\Message /** * @param string $project Project ID for this request. - * @param string $zone The name of the zone where the network endpoint group is located. It should comply with RFC1035. + * @param string $zone The name of the zone where + * the network endpoint group is located. It should comply with RFC1035. * @param string $networkEndpointGroup The name of the network endpoint group. It should comply with RFC1035. * * @return \Google\Cloud\Compute\V1\GetNetworkEndpointGroupRequest @@ -62,7 +64,8 @@ public static function build(string $project, string $zone, string $networkEndpo * @type string $project * Project ID for this request. * @type string $zone - * The name of the zone where the network endpoint group is located. It should comply with RFC1035. + * The name of the zone where + * the network endpoint group is located. It should comply with RFC1035. * } */ public function __construct($data = NULL) { @@ -123,7 +126,8 @@ public function setProject($var) } /** - * The name of the zone where the network endpoint group is located. It should comply with RFC1035. + * The name of the zone where + * the network endpoint group is located. It should comply with RFC1035. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -134,7 +138,8 @@ public function getZone() } /** - * The name of the zone where the network endpoint group is located. It should comply with RFC1035. + * The name of the zone where + * the network endpoint group is located. It should comply with RFC1035. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED]; * @param string $var diff --git a/Compute/src/V1/GetRegionHealthCheckServiceRequest.php b/Compute/src/V1/GetRegionHealthCheckServiceRequest.php index 8b609a02cb6b..ca0dbfd0ed65 100644 --- a/Compute/src/V1/GetRegionHealthCheckServiceRequest.php +++ b/Compute/src/V1/GetRegionHealthCheckServiceRequest.php @@ -16,7 +16,8 @@ class GetRegionHealthCheckServiceRequest extends \Google\Protobuf\Internal\Message { /** - * Name of the HealthCheckService to update. The name must be 1-63 characters long, and comply with RFC1035. + * Name of the HealthCheckService to update. The name + * must be 1-63 characters long, and comply with RFC1035. * * Generated from protobuf field string health_check_service = 408374747 [(.google.api.field_behavior) = REQUIRED]; */ @@ -37,7 +38,8 @@ class GetRegionHealthCheckServiceRequest extends \Google\Protobuf\Internal\Messa /** * @param string $project Project ID for this request. * @param string $region Name of the region scoping this request. - * @param string $healthCheckService Name of the HealthCheckService to update. The name must be 1-63 characters long, and comply with RFC1035. + * @param string $healthCheckService Name of the HealthCheckService to update. The name + * must be 1-63 characters long, and comply with RFC1035. * * @return \Google\Cloud\Compute\V1\GetRegionHealthCheckServiceRequest * @@ -58,7 +60,8 @@ public static function build(string $project, string $region, string $healthChec * Optional. Data for populating the Message object. * * @type string $health_check_service - * Name of the HealthCheckService to update. The name must be 1-63 characters long, and comply with RFC1035. + * Name of the HealthCheckService to update. The name + * must be 1-63 characters long, and comply with RFC1035. * @type string $project * Project ID for this request. * @type string $region @@ -71,7 +74,8 @@ public function __construct($data = NULL) { } /** - * Name of the HealthCheckService to update. The name must be 1-63 characters long, and comply with RFC1035. + * Name of the HealthCheckService to update. The name + * must be 1-63 characters long, and comply with RFC1035. * * Generated from protobuf field string health_check_service = 408374747 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -82,7 +86,8 @@ public function getHealthCheckService() } /** - * Name of the HealthCheckService to update. The name must be 1-63 characters long, and comply with RFC1035. + * Name of the HealthCheckService to update. The name + * must be 1-63 characters long, and comply with RFC1035. * * Generated from protobuf field string health_check_service = 408374747 [(.google.api.field_behavior) = REQUIRED]; * @param string $var diff --git a/Compute/src/V1/GetRegionNetworkEndpointGroupRequest.php b/Compute/src/V1/GetRegionNetworkEndpointGroupRequest.php index 3f9512e26800..dbef42d4ffd9 100644 --- a/Compute/src/V1/GetRegionNetworkEndpointGroupRequest.php +++ b/Compute/src/V1/GetRegionNetworkEndpointGroupRequest.php @@ -28,7 +28,8 @@ class GetRegionNetworkEndpointGroupRequest extends \Google\Protobuf\Internal\Mes */ protected $project = ''; /** - * The name of the region where the network endpoint group is located. It should comply with RFC1035. + * The name of the region where + * the network endpoint group is located. It should comply with RFC1035. * * Generated from protobuf field string region = 138946292 [(.google.api.field_behavior) = REQUIRED]; */ @@ -36,7 +37,8 @@ class GetRegionNetworkEndpointGroupRequest extends \Google\Protobuf\Internal\Mes /** * @param string $project Project ID for this request. - * @param string $region The name of the region where the network endpoint group is located. It should comply with RFC1035. + * @param string $region The name of the region where + * the network endpoint group is located. It should comply with RFC1035. * @param string $networkEndpointGroup The name of the network endpoint group. It should comply with RFC1035. * * @return \Google\Cloud\Compute\V1\GetRegionNetworkEndpointGroupRequest @@ -62,7 +64,8 @@ public static function build(string $project, string $region, string $networkEnd * @type string $project * Project ID for this request. * @type string $region - * The name of the region where the network endpoint group is located. It should comply with RFC1035. + * The name of the region where + * the network endpoint group is located. It should comply with RFC1035. * } */ public function __construct($data = NULL) { @@ -123,7 +126,8 @@ public function setProject($var) } /** - * The name of the region where the network endpoint group is located. It should comply with RFC1035. + * The name of the region where + * the network endpoint group is located. It should comply with RFC1035. * * Generated from protobuf field string region = 138946292 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -134,7 +138,8 @@ public function getRegion() } /** - * The name of the region where the network endpoint group is located. It should comply with RFC1035. + * The name of the region where + * the network endpoint group is located. It should comply with RFC1035. * * Generated from protobuf field string region = 138946292 [(.google.api.field_behavior) = REQUIRED]; * @param string $var diff --git a/Compute/src/V1/GetRegionOperationRequest.php b/Compute/src/V1/GetRegionOperationRequest.php index 4513d7b4b12c..f5c139a391f7 100644 --- a/Compute/src/V1/GetRegionOperationRequest.php +++ b/Compute/src/V1/GetRegionOperationRequest.php @@ -16,7 +16,8 @@ class GetRegionOperationRequest extends \Google\Protobuf\Internal\Message { /** - * Name of the Operations resource to return, or its unique numeric identifier. + * Name of the Operations resource to return, or its unique numeric + * identifier. * * Generated from protobuf field string operation = 52090215 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_response_field) = "name"]; */ @@ -37,7 +38,8 @@ class GetRegionOperationRequest extends \Google\Protobuf\Internal\Message /** * @param string $project Project ID for this request. * @param string $region Name of the region for this request. - * @param string $operation Name of the Operations resource to return, or its unique numeric identifier. + * @param string $operation Name of the Operations resource to return, or its unique numeric + * identifier. * * @return \Google\Cloud\Compute\V1\GetRegionOperationRequest * @@ -58,7 +60,8 @@ public static function build(string $project, string $region, string $operation) * Optional. Data for populating the Message object. * * @type string $operation - * Name of the Operations resource to return, or its unique numeric identifier. + * Name of the Operations resource to return, or its unique numeric + * identifier. * @type string $project * Project ID for this request. * @type string $region @@ -71,7 +74,8 @@ public function __construct($data = NULL) { } /** - * Name of the Operations resource to return, or its unique numeric identifier. + * Name of the Operations resource to return, or its unique numeric + * identifier. * * Generated from protobuf field string operation = 52090215 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_response_field) = "name"]; * @return string @@ -82,7 +86,8 @@ public function getOperation() } /** - * Name of the Operations resource to return, or its unique numeric identifier. + * Name of the Operations resource to return, or its unique numeric + * identifier. * * Generated from protobuf field string operation = 52090215 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_response_field) = "name"]; * @param string $var diff --git a/Compute/src/V1/GetRegionSslPolicyRequest.php b/Compute/src/V1/GetRegionSslPolicyRequest.php index 060ec6ef24de..dd9b30f38f54 100644 --- a/Compute/src/V1/GetRegionSslPolicyRequest.php +++ b/Compute/src/V1/GetRegionSslPolicyRequest.php @@ -28,7 +28,8 @@ class GetRegionSslPolicyRequest extends \Google\Protobuf\Internal\Message */ protected $region = ''; /** - * Name of the SSL policy to update. The name must be 1-63 characters long, and comply with RFC1035. + * Name of the SSL policy to update. The name must be 1-63 characters long, + * and comply with RFC1035. * * Generated from protobuf field string ssl_policy = 295190213 [(.google.api.field_behavior) = REQUIRED]; */ @@ -37,7 +38,8 @@ class GetRegionSslPolicyRequest extends \Google\Protobuf\Internal\Message /** * @param string $project Project ID for this request. * @param string $region Name of the region scoping this request. - * @param string $sslPolicy Name of the SSL policy to update. The name must be 1-63 characters long, and comply with RFC1035. + * @param string $sslPolicy Name of the SSL policy to update. The name must be 1-63 characters long, + * and comply with RFC1035. * * @return \Google\Cloud\Compute\V1\GetRegionSslPolicyRequest * @@ -62,7 +64,8 @@ public static function build(string $project, string $region, string $sslPolicy) * @type string $region * Name of the region scoping this request. * @type string $ssl_policy - * Name of the SSL policy to update. The name must be 1-63 characters long, and comply with RFC1035. + * Name of the SSL policy to update. The name must be 1-63 characters long, + * and comply with RFC1035. * } */ public function __construct($data = NULL) { @@ -123,7 +126,8 @@ public function setRegion($var) } /** - * Name of the SSL policy to update. The name must be 1-63 characters long, and comply with RFC1035. + * Name of the SSL policy to update. The name must be 1-63 characters long, + * and comply with RFC1035. * * Generated from protobuf field string ssl_policy = 295190213 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -134,7 +138,8 @@ public function getSslPolicy() } /** - * Name of the SSL policy to update. The name must be 1-63 characters long, and comply with RFC1035. + * Name of the SSL policy to update. The name must be 1-63 characters long, + * and comply with RFC1035. * * Generated from protobuf field string ssl_policy = 295190213 [(.google.api.field_behavior) = REQUIRED]; * @param string $var diff --git a/Compute/src/V1/GetReservationBlockRequest.php b/Compute/src/V1/GetReservationBlockRequest.php index 72d4834d5ce6..1a462933fd07 100644 --- a/Compute/src/V1/GetReservationBlockRequest.php +++ b/Compute/src/V1/GetReservationBlockRequest.php @@ -22,13 +22,15 @@ class GetReservationBlockRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * The name of the reservation. Name should conform to RFC1035 or be a resource ID. + * The name of the reservation. + * Name should conform to RFC1035 or be a resource ID. * * Generated from protobuf field string reservation = 47530956 [(.google.api.field_behavior) = REQUIRED]; */ protected $reservation = ''; /** - * The name of the reservation block. Name should conform to RFC1035 or be a resource ID. + * The name of the reservation block. + * Name should conform to RFC1035 or be a resource ID. * * Generated from protobuf field string reservation_block = 532832858 [(.google.api.field_behavior) = REQUIRED]; */ @@ -50,8 +52,10 @@ class GetReservationBlockRequest extends \Google\Protobuf\Internal\Message /** * @param string $project Project ID for this request. * @param string $zone Name of the zone for this request. Zone name should conform to RFC1035. - * @param string $reservation The name of the reservation. Name should conform to RFC1035 or be a resource ID. - * @param string $reservationBlock The name of the reservation block. Name should conform to RFC1035 or be a resource ID. + * @param string $reservation The name of the reservation. + * Name should conform to RFC1035 or be a resource ID. + * @param string $reservationBlock The name of the reservation block. + * Name should conform to RFC1035 or be a resource ID. * * @return \Google\Cloud\Compute\V1\GetReservationBlockRequest * @@ -75,9 +79,11 @@ public static function build(string $project, string $zone, string $reservation, * @type string $project * Project ID for this request. * @type string $reservation - * The name of the reservation. Name should conform to RFC1035 or be a resource ID. + * The name of the reservation. + * Name should conform to RFC1035 or be a resource ID. * @type string $reservation_block - * The name of the reservation block. Name should conform to RFC1035 or be a resource ID. + * The name of the reservation block. + * Name should conform to RFC1035 or be a resource ID. * @type string $view * View of the Block. * Check the View enum for the list of possible values. @@ -117,7 +123,8 @@ public function setProject($var) } /** - * The name of the reservation. Name should conform to RFC1035 or be a resource ID. + * The name of the reservation. + * Name should conform to RFC1035 or be a resource ID. * * Generated from protobuf field string reservation = 47530956 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -128,7 +135,8 @@ public function getReservation() } /** - * The name of the reservation. Name should conform to RFC1035 or be a resource ID. + * The name of the reservation. + * Name should conform to RFC1035 or be a resource ID. * * Generated from protobuf field string reservation = 47530956 [(.google.api.field_behavior) = REQUIRED]; * @param string $var @@ -143,7 +151,8 @@ public function setReservation($var) } /** - * The name of the reservation block. Name should conform to RFC1035 or be a resource ID. + * The name of the reservation block. + * Name should conform to RFC1035 or be a resource ID. * * Generated from protobuf field string reservation_block = 532832858 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -154,7 +163,8 @@ public function getReservationBlock() } /** - * The name of the reservation block. Name should conform to RFC1035 or be a resource ID. + * The name of the reservation block. + * Name should conform to RFC1035 or be a resource ID. * * Generated from protobuf field string reservation_block = 532832858 [(.google.api.field_behavior) = REQUIRED]; * @param string $var diff --git a/Compute/src/V1/GetReservationSubBlockRequest.php b/Compute/src/V1/GetReservationSubBlockRequest.php index 28a885e3ff31..d7b5e773971b 100644 --- a/Compute/src/V1/GetReservationSubBlockRequest.php +++ b/Compute/src/V1/GetReservationSubBlockRequest.php @@ -16,7 +16,8 @@ class GetReservationSubBlockRequest extends \Google\Protobuf\Internal\Message { /** - * The name of the parent reservation and parent block. In the format of reservations/{reservation_name}/reservationBlocks/{reservation_block_name} + * The name of the parent reservation and parent block. In the format of + * reservations/{reservation_name}/reservationBlocks/{reservation_block_name} * * Generated from protobuf field string parent_name = 478151936 [(.google.api.field_behavior) = REQUIRED]; */ @@ -28,11 +29,19 @@ class GetReservationSubBlockRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * The name of the reservation subBlock. Name should conform to RFC1035 or be a resource ID. + * The name of the reservation subBlock. + * Name should conform to RFC1035 or be a resource ID. * * Generated from protobuf field string reservation_sub_block = 22750491 [(.google.api.field_behavior) = REQUIRED]; */ protected $reservation_sub_block = ''; + /** + * View of the subBlock. + * Check the View enum for the list of possible values. + * + * Generated from protobuf field optional string view = 3619493; + */ + protected $view = null; /** * Name of the zone for this request. Zone name should conform to RFC1035. * @@ -43,8 +52,10 @@ class GetReservationSubBlockRequest extends \Google\Protobuf\Internal\Message /** * @param string $project Project ID for this request. * @param string $zone Name of the zone for this request. Zone name should conform to RFC1035. - * @param string $parentName The name of the parent reservation and parent block. In the format of reservations/{reservation_name}/reservationBlocks/{reservation_block_name} - * @param string $reservationSubBlock The name of the reservation subBlock. Name should conform to RFC1035 or be a resource ID. + * @param string $parentName The name of the parent reservation and parent block. In the format of + * reservations/{reservation_name}/reservationBlocks/{reservation_block_name} + * @param string $reservationSubBlock The name of the reservation subBlock. + * Name should conform to RFC1035 or be a resource ID. * * @return \Google\Cloud\Compute\V1\GetReservationSubBlockRequest * @@ -66,11 +77,16 @@ public static function build(string $project, string $zone, string $parentName, * Optional. Data for populating the Message object. * * @type string $parent_name - * The name of the parent reservation and parent block. In the format of reservations/{reservation_name}/reservationBlocks/{reservation_block_name} + * The name of the parent reservation and parent block. In the format of + * reservations/{reservation_name}/reservationBlocks/{reservation_block_name} * @type string $project * Project ID for this request. * @type string $reservation_sub_block - * The name of the reservation subBlock. Name should conform to RFC1035 or be a resource ID. + * The name of the reservation subBlock. + * Name should conform to RFC1035 or be a resource ID. + * @type string $view + * View of the subBlock. + * Check the View enum for the list of possible values. * @type string $zone * Name of the zone for this request. Zone name should conform to RFC1035. * } @@ -81,7 +97,8 @@ public function __construct($data = NULL) { } /** - * The name of the parent reservation and parent block. In the format of reservations/{reservation_name}/reservationBlocks/{reservation_block_name} + * The name of the parent reservation and parent block. In the format of + * reservations/{reservation_name}/reservationBlocks/{reservation_block_name} * * Generated from protobuf field string parent_name = 478151936 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -92,7 +109,8 @@ public function getParentName() } /** - * The name of the parent reservation and parent block. In the format of reservations/{reservation_name}/reservationBlocks/{reservation_block_name} + * The name of the parent reservation and parent block. In the format of + * reservations/{reservation_name}/reservationBlocks/{reservation_block_name} * * Generated from protobuf field string parent_name = 478151936 [(.google.api.field_behavior) = REQUIRED]; * @param string $var @@ -133,7 +151,8 @@ public function setProject($var) } /** - * The name of the reservation subBlock. Name should conform to RFC1035 or be a resource ID. + * The name of the reservation subBlock. + * Name should conform to RFC1035 or be a resource ID. * * Generated from protobuf field string reservation_sub_block = 22750491 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -144,7 +163,8 @@ public function getReservationSubBlock() } /** - * The name of the reservation subBlock. Name should conform to RFC1035 or be a resource ID. + * The name of the reservation subBlock. + * Name should conform to RFC1035 or be a resource ID. * * Generated from protobuf field string reservation_sub_block = 22750491 [(.google.api.field_behavior) = REQUIRED]; * @param string $var @@ -158,6 +178,44 @@ public function setReservationSubBlock($var) return $this; } + /** + * View of the subBlock. + * Check the View enum for the list of possible values. + * + * Generated from protobuf field optional string view = 3619493; + * @return string + */ + public function getView() + { + return isset($this->view) ? $this->view : ''; + } + + public function hasView() + { + return isset($this->view); + } + + public function clearView() + { + unset($this->view); + } + + /** + * View of the subBlock. + * Check the View enum for the list of possible values. + * + * Generated from protobuf field optional string view = 3619493; + * @param string $var + * @return $this + */ + public function setView($var) + { + GPBUtil::checkString($var, True); + $this->view = $var; + + return $this; + } + /** * Name of the zone for this request. Zone name should conform to RFC1035. * diff --git a/Compute/src/V1/GetReservationSubBlockRequest/View.php b/Compute/src/V1/GetReservationSubBlockRequest/View.php new file mode 100644 index 000000000000..e6b04674918c --- /dev/null +++ b/Compute/src/V1/GetReservationSubBlockRequest/View.php @@ -0,0 +1,69 @@ +google.cloud.compute.v1.GetReservationSubBlockRequest.View + */ +class View +{ + /** + * A value indicating that the enum field is not set. + * + * Generated from protobuf enum UNDEFINED_VIEW = 0; + */ + const UNDEFINED_VIEW = 0; + /** + * This view includes basic information about the reservation sub block + * + * Generated from protobuf enum SUB_BLOCK_VIEW_BASIC = 236009797; + */ + const SUB_BLOCK_VIEW_BASIC = 236009797; + /** + * Includes detailed topology view. + * + * Generated from protobuf enum SUB_BLOCK_VIEW_FULL = 440711800; + */ + const SUB_BLOCK_VIEW_FULL = 440711800; + /** + * The default / unset value. The API will default to the BASIC view. + * + * Generated from protobuf enum SUB_BLOCK_VIEW_UNSPECIFIED = 246642446; + */ + const SUB_BLOCK_VIEW_UNSPECIFIED = 246642446; + + private static $valueToName = [ + self::UNDEFINED_VIEW => 'UNDEFINED_VIEW', + self::SUB_BLOCK_VIEW_BASIC => 'SUB_BLOCK_VIEW_BASIC', + self::SUB_BLOCK_VIEW_FULL => 'SUB_BLOCK_VIEW_FULL', + self::SUB_BLOCK_VIEW_UNSPECIFIED => 'SUB_BLOCK_VIEW_UNSPECIFIED', + ]; + + public static function name($value) + { + if (!isset(self::$valueToName[$value])) { + throw new UnexpectedValueException(sprintf( + 'Enum %s has no name defined for value %s', __CLASS__, $value)); + } + return self::$valueToName[$value]; + } + + + public static function value($name) + { + $const = __CLASS__ . '::' . strtoupper($name); + if (!defined($const)) { + throw new UnexpectedValueException(sprintf( + 'Enum %s has no value defined for name %s', __CLASS__, $name)); + } + return constant($const); + } +} + + diff --git a/Compute/src/V1/GetRoutePolicyRouterRequest.php b/Compute/src/V1/GetRoutePolicyRouterRequest.php index be9bcc6380fc..e6045427bf37 100644 --- a/Compute/src/V1/GetRoutePolicyRouterRequest.php +++ b/Compute/src/V1/GetRoutePolicyRouterRequest.php @@ -34,7 +34,8 @@ class GetRoutePolicyRouterRequest extends \Google\Protobuf\Internal\Message */ protected $region = ''; /** - * Name of the Router resource to query for the route policy. The name should conform to RFC1035. + * Name of the Router resource to query for the route policy. The name should + * conform to RFC1035. * * Generated from protobuf field string router = 148608841 [(.google.api.field_behavior) = REQUIRED]; */ @@ -43,7 +44,8 @@ class GetRoutePolicyRouterRequest extends \Google\Protobuf\Internal\Message /** * @param string $project Project ID for this request. * @param string $region Name of the region for this request. - * @param string $router Name of the Router resource to query for the route policy. The name should conform to RFC1035. + * @param string $router Name of the Router resource to query for the route policy. The name should + * conform to RFC1035. * * @return \Google\Cloud\Compute\V1\GetRoutePolicyRouterRequest * @@ -70,7 +72,8 @@ public static function build(string $project, string $region, string $router): s * @type string $region * Name of the region for this request. * @type string $router - * Name of the Router resource to query for the route policy. The name should conform to RFC1035. + * Name of the Router resource to query for the route policy. The name should + * conform to RFC1035. * } */ public function __construct($data = NULL) { @@ -167,7 +170,8 @@ public function setRegion($var) } /** - * Name of the Router resource to query for the route policy. The name should conform to RFC1035. + * Name of the Router resource to query for the route policy. The name should + * conform to RFC1035. * * Generated from protobuf field string router = 148608841 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -178,7 +182,8 @@ public function getRouter() } /** - * Name of the Router resource to query for the route policy. The name should conform to RFC1035. + * Name of the Router resource to query for the route policy. The name should + * conform to RFC1035. * * Generated from protobuf field string router = 148608841 [(.google.api.field_behavior) = REQUIRED]; * @param string $var diff --git a/Compute/src/V1/GetSerialPortOutputInstanceRequest.php b/Compute/src/V1/GetSerialPortOutputInstanceRequest.php index 21d698d5ccfb..74cf926a6690 100644 --- a/Compute/src/V1/GetSerialPortOutputInstanceRequest.php +++ b/Compute/src/V1/GetSerialPortOutputInstanceRequest.php @@ -34,7 +34,21 @@ class GetSerialPortOutputInstanceRequest extends \Google\Protobuf\Internal\Messa */ protected $project = ''; /** - * Specifies the starting byte position of the output to return. To start with the first byte of output to the specified port, omit this field or set it to `0`. If the output for that byte position is available, this field matches the `start` parameter sent with the request. If the amount of serial console output exceeds the size of the buffer (1 MB), the oldest output is discarded and is no longer available. If the requested start position refers to discarded output, the start position is adjusted to the oldest output still available, and the adjusted start position is returned as the `start` property value. You can also provide a negative start position, which translates to the most recent number of bytes written to the serial port. For example, -3 is interpreted as the most recent 3 bytes written to the serial console. Note that the negative start is bounded by the retained buffer size, and the returned serial console output will not exceed the max buffer size. + * Specifies the starting byte position of the output to return. To start with + * the first byte of output to the specified port, omit this field or set it + * to `0`. + * If the output for that byte position is available, this field matches the + * `start` parameter sent with the request. If the amount of serial console + * output exceeds the size of the buffer (1 MB), the oldest output is + * discarded and is no longer available. If the requested start position + * refers to discarded output, the start position is adjusted to the oldest + * output still available, and the adjusted start position is returned as the + * `start` property value. + * You can also provide a negative start position, which translates to the + * most recent number of bytes written to the serial port. For example, -3 is + * interpreted as the most recent 3 bytes written to the serial console. Note + * that the negative start is bounded by the retained buffer size, and the + * returned serial console output will not exceed the max buffer size. * * Generated from protobuf field optional int64 start = 109757538; */ @@ -76,7 +90,21 @@ public static function build(string $project, string $zone, string $instance): s * @type string $project * Project ID for this request. * @type int|string $start - * Specifies the starting byte position of the output to return. To start with the first byte of output to the specified port, omit this field or set it to `0`. If the output for that byte position is available, this field matches the `start` parameter sent with the request. If the amount of serial console output exceeds the size of the buffer (1 MB), the oldest output is discarded and is no longer available. If the requested start position refers to discarded output, the start position is adjusted to the oldest output still available, and the adjusted start position is returned as the `start` property value. You can also provide a negative start position, which translates to the most recent number of bytes written to the serial port. For example, -3 is interpreted as the most recent 3 bytes written to the serial console. Note that the negative start is bounded by the retained buffer size, and the returned serial console output will not exceed the max buffer size. + * Specifies the starting byte position of the output to return. To start with + * the first byte of output to the specified port, omit this field or set it + * to `0`. + * If the output for that byte position is available, this field matches the + * `start` parameter sent with the request. If the amount of serial console + * output exceeds the size of the buffer (1 MB), the oldest output is + * discarded and is no longer available. If the requested start position + * refers to discarded output, the start position is adjusted to the oldest + * output still available, and the adjusted start position is returned as the + * `start` property value. + * You can also provide a negative start position, which translates to the + * most recent number of bytes written to the serial port. For example, -3 is + * interpreted as the most recent 3 bytes written to the serial console. Note + * that the negative start is bounded by the retained buffer size, and the + * returned serial console output will not exceed the max buffer size. * @type string $zone * The name of the zone for this request. * } @@ -175,7 +203,21 @@ public function setProject($var) } /** - * Specifies the starting byte position of the output to return. To start with the first byte of output to the specified port, omit this field or set it to `0`. If the output for that byte position is available, this field matches the `start` parameter sent with the request. If the amount of serial console output exceeds the size of the buffer (1 MB), the oldest output is discarded and is no longer available. If the requested start position refers to discarded output, the start position is adjusted to the oldest output still available, and the adjusted start position is returned as the `start` property value. You can also provide a negative start position, which translates to the most recent number of bytes written to the serial port. For example, -3 is interpreted as the most recent 3 bytes written to the serial console. Note that the negative start is bounded by the retained buffer size, and the returned serial console output will not exceed the max buffer size. + * Specifies the starting byte position of the output to return. To start with + * the first byte of output to the specified port, omit this field or set it + * to `0`. + * If the output for that byte position is available, this field matches the + * `start` parameter sent with the request. If the amount of serial console + * output exceeds the size of the buffer (1 MB), the oldest output is + * discarded and is no longer available. If the requested start position + * refers to discarded output, the start position is adjusted to the oldest + * output still available, and the adjusted start position is returned as the + * `start` property value. + * You can also provide a negative start position, which translates to the + * most recent number of bytes written to the serial port. For example, -3 is + * interpreted as the most recent 3 bytes written to the serial console. Note + * that the negative start is bounded by the retained buffer size, and the + * returned serial console output will not exceed the max buffer size. * * Generated from protobuf field optional int64 start = 109757538; * @return int|string @@ -196,7 +238,21 @@ public function clearStart() } /** - * Specifies the starting byte position of the output to return. To start with the first byte of output to the specified port, omit this field or set it to `0`. If the output for that byte position is available, this field matches the `start` parameter sent with the request. If the amount of serial console output exceeds the size of the buffer (1 MB), the oldest output is discarded and is no longer available. If the requested start position refers to discarded output, the start position is adjusted to the oldest output still available, and the adjusted start position is returned as the `start` property value. You can also provide a negative start position, which translates to the most recent number of bytes written to the serial port. For example, -3 is interpreted as the most recent 3 bytes written to the serial console. Note that the negative start is bounded by the retained buffer size, and the returned serial console output will not exceed the max buffer size. + * Specifies the starting byte position of the output to return. To start with + * the first byte of output to the specified port, omit this field or set it + * to `0`. + * If the output for that byte position is available, this field matches the + * `start` parameter sent with the request. If the amount of serial console + * output exceeds the size of the buffer (1 MB), the oldest output is + * discarded and is no longer available. If the requested start position + * refers to discarded output, the start position is adjusted to the oldest + * output still available, and the adjusted start position is returned as the + * `start` property value. + * You can also provide a negative start position, which translates to the + * most recent number of bytes written to the serial port. For example, -3 is + * interpreted as the most recent 3 bytes written to the serial console. Note + * that the negative start is bounded by the retained buffer size, and the + * returned serial console output will not exceed the max buffer size. * * Generated from protobuf field optional int64 start = 109757538; * @param int|string $var diff --git a/Compute/src/V1/GetSslPolicyRequest.php b/Compute/src/V1/GetSslPolicyRequest.php index 7f0899561862..13ea27e6af9c 100644 --- a/Compute/src/V1/GetSslPolicyRequest.php +++ b/Compute/src/V1/GetSslPolicyRequest.php @@ -22,7 +22,8 @@ class GetSslPolicyRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * Name of the SSL policy to update. The name must be 1-63 characters long, and comply with RFC1035. + * Name of the SSL policy to update. The name must be 1-63 characters long, + * and comply with RFC1035. * * Generated from protobuf field string ssl_policy = 295190213 [(.google.api.field_behavior) = REQUIRED]; */ @@ -30,7 +31,8 @@ class GetSslPolicyRequest extends \Google\Protobuf\Internal\Message /** * @param string $project Project ID for this request. - * @param string $sslPolicy Name of the SSL policy to update. The name must be 1-63 characters long, and comply with RFC1035. + * @param string $sslPolicy Name of the SSL policy to update. The name must be 1-63 characters long, + * and comply with RFC1035. * * @return \Google\Cloud\Compute\V1\GetSslPolicyRequest * @@ -52,7 +54,8 @@ public static function build(string $project, string $sslPolicy): self * @type string $project * Project ID for this request. * @type string $ssl_policy - * Name of the SSL policy to update. The name must be 1-63 characters long, and comply with RFC1035. + * Name of the SSL policy to update. The name must be 1-63 characters long, + * and comply with RFC1035. * } */ public function __construct($data = NULL) { @@ -87,7 +90,8 @@ public function setProject($var) } /** - * Name of the SSL policy to update. The name must be 1-63 characters long, and comply with RFC1035. + * Name of the SSL policy to update. The name must be 1-63 characters long, + * and comply with RFC1035. * * Generated from protobuf field string ssl_policy = 295190213 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -98,7 +102,8 @@ public function getSslPolicy() } /** - * Name of the SSL policy to update. The name must be 1-63 characters long, and comply with RFC1035. + * Name of the SSL policy to update. The name must be 1-63 characters long, + * and comply with RFC1035. * * Generated from protobuf field string ssl_policy = 295190213 [(.google.api.field_behavior) = REQUIRED]; * @param string $var diff --git a/Compute/src/V1/GetSubnetworkRequest.php b/Compute/src/V1/GetSubnetworkRequest.php index 4a96a4d4d289..d17859da347e 100644 --- a/Compute/src/V1/GetSubnetworkRequest.php +++ b/Compute/src/V1/GetSubnetworkRequest.php @@ -34,7 +34,10 @@ class GetSubnetworkRequest extends \Google\Protobuf\Internal\Message */ protected $subnetwork = ''; /** - * Defines the extra views returned back in the subnetwork resource. Supported values: - WITH_UTILIZATION: Utilization data is included in the response. + * Defines the extra views returned back in the subnetwork resource. + * Supported values: + * - WITH_UTILIZATION: Utilization data is included in the + * response. * Check the Views enum for the list of possible values. * * Generated from protobuf field optional string views = 112204398; @@ -71,7 +74,10 @@ public static function build(string $project, string $region, string $subnetwork * @type string $subnetwork * Name of the Subnetwork resource to return. * @type string $views - * Defines the extra views returned back in the subnetwork resource. Supported values: - WITH_UTILIZATION: Utilization data is included in the response. + * Defines the extra views returned back in the subnetwork resource. + * Supported values: + * - WITH_UTILIZATION: Utilization data is included in the + * response. * Check the Views enum for the list of possible values. * } */ @@ -159,7 +165,10 @@ public function setSubnetwork($var) } /** - * Defines the extra views returned back in the subnetwork resource. Supported values: - WITH_UTILIZATION: Utilization data is included in the response. + * Defines the extra views returned back in the subnetwork resource. + * Supported values: + * - WITH_UTILIZATION: Utilization data is included in the + * response. * Check the Views enum for the list of possible values. * * Generated from protobuf field optional string views = 112204398; @@ -181,7 +190,10 @@ public function clearViews() } /** - * Defines the extra views returned back in the subnetwork resource. Supported values: - WITH_UTILIZATION: Utilization data is included in the response. + * Defines the extra views returned back in the subnetwork resource. + * Supported values: + * - WITH_UTILIZATION: Utilization data is included in the + * response. * Check the Views enum for the list of possible values. * * Generated from protobuf field optional string views = 112204398; diff --git a/Compute/src/V1/GetSubnetworkRequest/Views.php b/Compute/src/V1/GetSubnetworkRequest/Views.php index bf260ba78aa3..62b70873342b 100644 --- a/Compute/src/V1/GetSubnetworkRequest/Views.php +++ b/Compute/src/V1/GetSubnetworkRequest/Views.php @@ -7,7 +7,10 @@ use UnexpectedValueException; /** - * Defines the extra views returned back in the subnetwork resource. Supported values: - WITH_UTILIZATION: Utilization data is included in the response. + * Defines the extra views returned back in the subnetwork resource. + * Supported values: + * - WITH_UTILIZATION: Utilization data is included in the + * response. * * Protobuf type google.cloud.compute.v1.GetSubnetworkRequest.Views */ diff --git a/Compute/src/V1/GetWireGroupRequest.php b/Compute/src/V1/GetWireGroupRequest.php new file mode 100644 index 000000000000..86ccb0db1e12 --- /dev/null +++ b/Compute/src/V1/GetWireGroupRequest.php @@ -0,0 +1,145 @@ +google.cloud.compute.v1.GetWireGroupRequest + */ +class GetWireGroupRequest extends \Google\Protobuf\Internal\Message +{ + /** + * Generated from protobuf field string cross_site_network = 108192469 [(.google.api.field_behavior) = REQUIRED]; + */ + protected $cross_site_network = ''; + /** + * Project ID for this request. + * + * Generated from protobuf field string project = 227560217 [(.google.api.field_behavior) = REQUIRED]; + */ + protected $project = ''; + /** + * Name of the wire group resource to return. + * + * Generated from protobuf field string wire_group = 122540613 [(.google.api.field_behavior) = REQUIRED]; + */ + protected $wire_group = ''; + + /** + * @param string $project Project ID for this request. + * @param string $crossSiteNetwork + * @param string $wireGroup Name of the wire group resource to return. + * + * @return \Google\Cloud\Compute\V1\GetWireGroupRequest + * + * @experimental + */ + public static function build(string $project, string $crossSiteNetwork, string $wireGroup): self + { + return (new self()) + ->setProject($project) + ->setCrossSiteNetwork($crossSiteNetwork) + ->setWireGroup($wireGroup); + } + + /** + * Constructor. + * + * @param array $data { + * Optional. Data for populating the Message object. + * + * @type string $cross_site_network + * @type string $project + * Project ID for this request. + * @type string $wire_group + * Name of the wire group resource to return. + * } + */ + public function __construct($data = NULL) { + \GPBMetadata\Google\Cloud\Compute\V1\Compute::initOnce(); + parent::__construct($data); + } + + /** + * Generated from protobuf field string cross_site_network = 108192469 [(.google.api.field_behavior) = REQUIRED]; + * @return string + */ + public function getCrossSiteNetwork() + { + return $this->cross_site_network; + } + + /** + * Generated from protobuf field string cross_site_network = 108192469 [(.google.api.field_behavior) = REQUIRED]; + * @param string $var + * @return $this + */ + public function setCrossSiteNetwork($var) + { + GPBUtil::checkString($var, True); + $this->cross_site_network = $var; + + return $this; + } + + /** + * Project ID for this request. + * + * Generated from protobuf field string project = 227560217 [(.google.api.field_behavior) = REQUIRED]; + * @return string + */ + public function getProject() + { + return $this->project; + } + + /** + * Project ID for this request. + * + * Generated from protobuf field string project = 227560217 [(.google.api.field_behavior) = REQUIRED]; + * @param string $var + * @return $this + */ + public function setProject($var) + { + GPBUtil::checkString($var, True); + $this->project = $var; + + return $this; + } + + /** + * Name of the wire group resource to return. + * + * Generated from protobuf field string wire_group = 122540613 [(.google.api.field_behavior) = REQUIRED]; + * @return string + */ + public function getWireGroup() + { + return $this->wire_group; + } + + /** + * Name of the wire group resource to return. + * + * Generated from protobuf field string wire_group = 122540613 [(.google.api.field_behavior) = REQUIRED]; + * @param string $var + * @return $this + */ + public function setWireGroup($var) + { + GPBUtil::checkString($var, True); + $this->wire_group = $var; + + return $this; + } + +} + diff --git a/Compute/src/V1/GetXpnResourcesProjectsRequest.php b/Compute/src/V1/GetXpnResourcesProjectsRequest.php index 7e6ce84fc0c2..43a2218107f4 100644 --- a/Compute/src/V1/GetXpnResourcesProjectsRequest.php +++ b/Compute/src/V1/GetXpnResourcesProjectsRequest.php @@ -16,25 +16,86 @@ class GetXpnResourcesProjectsRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -46,7 +107,11 @@ class GetXpnResourcesProjectsRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -72,17 +137,82 @@ public static function build(string $project): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * } */ public function __construct($data = NULL) { @@ -91,7 +221,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -112,7 +289,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -127,7 +351,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -148,7 +376,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -163,7 +395,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -184,7 +424,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -199,7 +447,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -220,7 +470,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -261,7 +513,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -282,7 +538,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/GetZoneOperationRequest.php b/Compute/src/V1/GetZoneOperationRequest.php index c466b176c718..c84e81bee8e1 100644 --- a/Compute/src/V1/GetZoneOperationRequest.php +++ b/Compute/src/V1/GetZoneOperationRequest.php @@ -16,7 +16,8 @@ class GetZoneOperationRequest extends \Google\Protobuf\Internal\Message { /** - * Name of the Operations resource to return, or its unique numeric identifier. + * Name of the Operations resource to return, or its unique numeric + * identifier. * * Generated from protobuf field string operation = 52090215 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_response_field) = "name"]; */ @@ -37,7 +38,8 @@ class GetZoneOperationRequest extends \Google\Protobuf\Internal\Message /** * @param string $project Project ID for this request. * @param string $zone Name of the zone for this request. - * @param string $operation Name of the Operations resource to return, or its unique numeric identifier. + * @param string $operation Name of the Operations resource to return, or its unique numeric + * identifier. * * @return \Google\Cloud\Compute\V1\GetZoneOperationRequest * @@ -58,7 +60,8 @@ public static function build(string $project, string $zone, string $operation): * Optional. Data for populating the Message object. * * @type string $operation - * Name of the Operations resource to return, or its unique numeric identifier. + * Name of the Operations resource to return, or its unique numeric + * identifier. * @type string $project * Project ID for this request. * @type string $zone @@ -71,7 +74,8 @@ public function __construct($data = NULL) { } /** - * Name of the Operations resource to return, or its unique numeric identifier. + * Name of the Operations resource to return, or its unique numeric + * identifier. * * Generated from protobuf field string operation = 52090215 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_response_field) = "name"]; * @return string @@ -82,7 +86,8 @@ public function getOperation() } /** - * Name of the Operations resource to return, or its unique numeric identifier. + * Name of the Operations resource to return, or its unique numeric + * identifier. * * Generated from protobuf field string operation = 52090215 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_response_field) = "name"]; * @param string $var diff --git a/Compute/src/V1/GlobalAddressesMoveRequest.php b/Compute/src/V1/GlobalAddressesMoveRequest.php index fef58ac5ffb1..cccd0cbc2754 100644 --- a/Compute/src/V1/GlobalAddressesMoveRequest.php +++ b/Compute/src/V1/GlobalAddressesMoveRequest.php @@ -15,13 +15,18 @@ class GlobalAddressesMoveRequest extends \Google\Protobuf\Internal\Message { /** - * An optional destination address description if intended to be different from the source. + * An optional destination address description if intended to be different + * from the source. * * Generated from protobuf field optional string description = 422937596; */ protected $description = null; /** - * The URL of the destination address to move to. This can be a full or partial URL. For example, the following are all valid URLs to a address: - https://www.googleapis.com/compute/v1/projects/project /global/addresses/address - projects/project/global/addresses/address Note that destination project must be different from the source project. So /global/addresses/address is not valid partial url. + * The URL of the destination address to move to. This can be a full or + * partial URL. For example, the following are all valid URLs to a address: + * - https://www.googleapis.com/compute/v1/projects/project/global/addresses/address + * - projects/project/global/addresses/address + * Note that destination project must be different from the source project. So/global/addresses/address is not valid partial url. * * Generated from protobuf field optional string destination_address = 371693763; */ @@ -34,9 +39,14 @@ class GlobalAddressesMoveRequest extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $description - * An optional destination address description if intended to be different from the source. + * An optional destination address description if intended to be different + * from the source. * @type string $destination_address - * The URL of the destination address to move to. This can be a full or partial URL. For example, the following are all valid URLs to a address: - https://www.googleapis.com/compute/v1/projects/project /global/addresses/address - projects/project/global/addresses/address Note that destination project must be different from the source project. So /global/addresses/address is not valid partial url. + * The URL of the destination address to move to. This can be a full or + * partial URL. For example, the following are all valid URLs to a address: + * - https://www.googleapis.com/compute/v1/projects/project/global/addresses/address + * - projects/project/global/addresses/address + * Note that destination project must be different from the source project. So/global/addresses/address is not valid partial url. * } */ public function __construct($data = NULL) { @@ -45,7 +55,8 @@ public function __construct($data = NULL) { } /** - * An optional destination address description if intended to be different from the source. + * An optional destination address description if intended to be different + * from the source. * * Generated from protobuf field optional string description = 422937596; * @return string @@ -66,7 +77,8 @@ public function clearDescription() } /** - * An optional destination address description if intended to be different from the source. + * An optional destination address description if intended to be different + * from the source. * * Generated from protobuf field optional string description = 422937596; * @param string $var @@ -81,7 +93,11 @@ public function setDescription($var) } /** - * The URL of the destination address to move to. This can be a full or partial URL. For example, the following are all valid URLs to a address: - https://www.googleapis.com/compute/v1/projects/project /global/addresses/address - projects/project/global/addresses/address Note that destination project must be different from the source project. So /global/addresses/address is not valid partial url. + * The URL of the destination address to move to. This can be a full or + * partial URL. For example, the following are all valid URLs to a address: + * - https://www.googleapis.com/compute/v1/projects/project/global/addresses/address + * - projects/project/global/addresses/address + * Note that destination project must be different from the source project. So/global/addresses/address is not valid partial url. * * Generated from protobuf field optional string destination_address = 371693763; * @return string @@ -102,7 +118,11 @@ public function clearDestinationAddress() } /** - * The URL of the destination address to move to. This can be a full or partial URL. For example, the following are all valid URLs to a address: - https://www.googleapis.com/compute/v1/projects/project /global/addresses/address - projects/project/global/addresses/address Note that destination project must be different from the source project. So /global/addresses/address is not valid partial url. + * The URL of the destination address to move to. This can be a full or + * partial URL. For example, the following are all valid URLs to a address: + * - https://www.googleapis.com/compute/v1/projects/project/global/addresses/address + * - projects/project/global/addresses/address + * Note that destination project must be different from the source project. So/global/addresses/address is not valid partial url. * * Generated from protobuf field optional string destination_address = 371693763; * @param string $var diff --git a/Compute/src/V1/GlobalOrganizationSetPolicyRequest.php b/Compute/src/V1/GlobalOrganizationSetPolicyRequest.php index 1ce725e4c9e8..b0dc916d2fd0 100644 --- a/Compute/src/V1/GlobalOrganizationSetPolicyRequest.php +++ b/Compute/src/V1/GlobalOrganizationSetPolicyRequest.php @@ -15,19 +15,23 @@ class GlobalOrganizationSetPolicyRequest extends \Google\Protobuf\Internal\Message { /** - * Flatten Policy to create a backward compatible wire-format. Deprecated. Use 'policy' to specify bindings. + * Flatten Policy to create a backward compatible wire-format. + * Deprecated. Use 'policy' to specify bindings. * * Generated from protobuf field repeated .google.cloud.compute.v1.Binding bindings = 403251854; */ private $bindings; /** - * Flatten Policy to create a backward compatible wire-format. Deprecated. Use 'policy' to specify the etag. + * Flatten Policy to create a backward compatible wire-format. + * Deprecated. Use 'policy' to specify the etag. * * Generated from protobuf field optional string etag = 3123477; */ protected $etag = null; /** - * REQUIRED: The complete policy to be applied to the 'resource'. The size of the policy is limited to a few 10s of KB. An empty policy is in general a valid policy but certain services (like Projects) might reject them. + * REQUIRED: The complete policy to be applied to the 'resource'. The size of + * the policy is limited to a few 10s of KB. An empty policy is in general a + * valid policy but certain services (like Projects) might reject them. * * Generated from protobuf field optional .google.cloud.compute.v1.Policy policy = 91071794; */ @@ -40,11 +44,15 @@ class GlobalOrganizationSetPolicyRequest extends \Google\Protobuf\Internal\Messa * Optional. Data for populating the Message object. * * @type array<\Google\Cloud\Compute\V1\Binding>|\Google\Protobuf\Internal\RepeatedField $bindings - * Flatten Policy to create a backward compatible wire-format. Deprecated. Use 'policy' to specify bindings. + * Flatten Policy to create a backward compatible wire-format. + * Deprecated. Use 'policy' to specify bindings. * @type string $etag - * Flatten Policy to create a backward compatible wire-format. Deprecated. Use 'policy' to specify the etag. + * Flatten Policy to create a backward compatible wire-format. + * Deprecated. Use 'policy' to specify the etag. * @type \Google\Cloud\Compute\V1\Policy $policy - * REQUIRED: The complete policy to be applied to the 'resource'. The size of the policy is limited to a few 10s of KB. An empty policy is in general a valid policy but certain services (like Projects) might reject them. + * REQUIRED: The complete policy to be applied to the 'resource'. The size of + * the policy is limited to a few 10s of KB. An empty policy is in general a + * valid policy but certain services (like Projects) might reject them. * } */ public function __construct($data = NULL) { @@ -53,7 +61,8 @@ public function __construct($data = NULL) { } /** - * Flatten Policy to create a backward compatible wire-format. Deprecated. Use 'policy' to specify bindings. + * Flatten Policy to create a backward compatible wire-format. + * Deprecated. Use 'policy' to specify bindings. * * Generated from protobuf field repeated .google.cloud.compute.v1.Binding bindings = 403251854; * @return \Google\Protobuf\Internal\RepeatedField @@ -64,7 +73,8 @@ public function getBindings() } /** - * Flatten Policy to create a backward compatible wire-format. Deprecated. Use 'policy' to specify bindings. + * Flatten Policy to create a backward compatible wire-format. + * Deprecated. Use 'policy' to specify bindings. * * Generated from protobuf field repeated .google.cloud.compute.v1.Binding bindings = 403251854; * @param array<\Google\Cloud\Compute\V1\Binding>|\Google\Protobuf\Internal\RepeatedField $var @@ -79,7 +89,8 @@ public function setBindings($var) } /** - * Flatten Policy to create a backward compatible wire-format. Deprecated. Use 'policy' to specify the etag. + * Flatten Policy to create a backward compatible wire-format. + * Deprecated. Use 'policy' to specify the etag. * * Generated from protobuf field optional string etag = 3123477; * @return string @@ -100,7 +111,8 @@ public function clearEtag() } /** - * Flatten Policy to create a backward compatible wire-format. Deprecated. Use 'policy' to specify the etag. + * Flatten Policy to create a backward compatible wire-format. + * Deprecated. Use 'policy' to specify the etag. * * Generated from protobuf field optional string etag = 3123477; * @param string $var @@ -115,7 +127,9 @@ public function setEtag($var) } /** - * REQUIRED: The complete policy to be applied to the 'resource'. The size of the policy is limited to a few 10s of KB. An empty policy is in general a valid policy but certain services (like Projects) might reject them. + * REQUIRED: The complete policy to be applied to the 'resource'. The size of + * the policy is limited to a few 10s of KB. An empty policy is in general a + * valid policy but certain services (like Projects) might reject them. * * Generated from protobuf field optional .google.cloud.compute.v1.Policy policy = 91071794; * @return \Google\Cloud\Compute\V1\Policy|null @@ -136,7 +150,9 @@ public function clearPolicy() } /** - * REQUIRED: The complete policy to be applied to the 'resource'. The size of the policy is limited to a few 10s of KB. An empty policy is in general a valid policy but certain services (like Projects) might reject them. + * REQUIRED: The complete policy to be applied to the 'resource'. The size of + * the policy is limited to a few 10s of KB. An empty policy is in general a + * valid policy but certain services (like Projects) might reject them. * * Generated from protobuf field optional .google.cloud.compute.v1.Policy policy = 91071794; * @param \Google\Cloud\Compute\V1\Policy $var diff --git a/Compute/src/V1/GlobalSetLabelsRequest.php b/Compute/src/V1/GlobalSetLabelsRequest.php index ee825fd62951..0db779062bf1 100644 --- a/Compute/src/V1/GlobalSetLabelsRequest.php +++ b/Compute/src/V1/GlobalSetLabelsRequest.php @@ -15,13 +15,21 @@ class GlobalSetLabelsRequest extends \Google\Protobuf\Internal\Message { /** - * The fingerprint of the previous set of labels for this resource, used to detect conflicts. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash when updating or changing labels, otherwise the request will fail with error 412 conditionNotMet. Make a get() request to the resource to get the latest fingerprint. + * The fingerprint of the previous set of labels for this resource, + * used to detect conflicts. The fingerprint is initially generated by Compute + * Engine and changes after every request to modify or update labels. You must + * always provide an up-to-date fingerprint hash when updating or changing + * labels, otherwise the request will fail with error412 conditionNotMet. Make a get() request to the + * resource to get the latest fingerprint. * * Generated from protobuf field optional string label_fingerprint = 178124825; */ protected $label_fingerprint = null; /** - * A list of labels to apply for this resource. Each label must comply with the requirements for labels. For example, "webserver-frontend": "images". A label value can also be empty (e.g. "my-label": ""). + * A list of labels to apply for this resource. Each label must comply with + * the + * requirements for labels. For example,"webserver-frontend": "images". A label value can also be + * empty (e.g. "my-label": ""). * * Generated from protobuf field map labels = 500195327; */ @@ -34,9 +42,17 @@ class GlobalSetLabelsRequest extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $label_fingerprint - * The fingerprint of the previous set of labels for this resource, used to detect conflicts. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash when updating or changing labels, otherwise the request will fail with error 412 conditionNotMet. Make a get() request to the resource to get the latest fingerprint. + * The fingerprint of the previous set of labels for this resource, + * used to detect conflicts. The fingerprint is initially generated by Compute + * Engine and changes after every request to modify or update labels. You must + * always provide an up-to-date fingerprint hash when updating or changing + * labels, otherwise the request will fail with error412 conditionNotMet. Make a get() request to the + * resource to get the latest fingerprint. * @type array|\Google\Protobuf\Internal\MapField $labels - * A list of labels to apply for this resource. Each label must comply with the requirements for labels. For example, "webserver-frontend": "images". A label value can also be empty (e.g. "my-label": ""). + * A list of labels to apply for this resource. Each label must comply with + * the + * requirements for labels. For example,"webserver-frontend": "images". A label value can also be + * empty (e.g. "my-label": ""). * } */ public function __construct($data = NULL) { @@ -45,7 +61,12 @@ public function __construct($data = NULL) { } /** - * The fingerprint of the previous set of labels for this resource, used to detect conflicts. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash when updating or changing labels, otherwise the request will fail with error 412 conditionNotMet. Make a get() request to the resource to get the latest fingerprint. + * The fingerprint of the previous set of labels for this resource, + * used to detect conflicts. The fingerprint is initially generated by Compute + * Engine and changes after every request to modify or update labels. You must + * always provide an up-to-date fingerprint hash when updating or changing + * labels, otherwise the request will fail with error412 conditionNotMet. Make a get() request to the + * resource to get the latest fingerprint. * * Generated from protobuf field optional string label_fingerprint = 178124825; * @return string @@ -66,7 +87,12 @@ public function clearLabelFingerprint() } /** - * The fingerprint of the previous set of labels for this resource, used to detect conflicts. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash when updating or changing labels, otherwise the request will fail with error 412 conditionNotMet. Make a get() request to the resource to get the latest fingerprint. + * The fingerprint of the previous set of labels for this resource, + * used to detect conflicts. The fingerprint is initially generated by Compute + * Engine and changes after every request to modify or update labels. You must + * always provide an up-to-date fingerprint hash when updating or changing + * labels, otherwise the request will fail with error412 conditionNotMet. Make a get() request to the + * resource to get the latest fingerprint. * * Generated from protobuf field optional string label_fingerprint = 178124825; * @param string $var @@ -81,7 +107,10 @@ public function setLabelFingerprint($var) } /** - * A list of labels to apply for this resource. Each label must comply with the requirements for labels. For example, "webserver-frontend": "images". A label value can also be empty (e.g. "my-label": ""). + * A list of labels to apply for this resource. Each label must comply with + * the + * requirements for labels. For example,"webserver-frontend": "images". A label value can also be + * empty (e.g. "my-label": ""). * * Generated from protobuf field map labels = 500195327; * @return \Google\Protobuf\Internal\MapField @@ -92,7 +121,10 @@ public function getLabels() } /** - * A list of labels to apply for this resource. Each label must comply with the requirements for labels. For example, "webserver-frontend": "images". A label value can also be empty (e.g. "my-label": ""). + * A list of labels to apply for this resource. Each label must comply with + * the + * requirements for labels. For example,"webserver-frontend": "images". A label value can also be + * empty (e.g. "my-label": ""). * * Generated from protobuf field map labels = 500195327; * @param array|\Google\Protobuf\Internal\MapField $var diff --git a/Compute/src/V1/GlobalSetPolicyRequest.php b/Compute/src/V1/GlobalSetPolicyRequest.php index 6d97cffa2636..0bcedf6e3200 100644 --- a/Compute/src/V1/GlobalSetPolicyRequest.php +++ b/Compute/src/V1/GlobalSetPolicyRequest.php @@ -15,19 +15,23 @@ class GlobalSetPolicyRequest extends \Google\Protobuf\Internal\Message { /** - * Flatten Policy to create a backward compatible wire-format. Deprecated. Use 'policy' to specify bindings. + * Flatten Policy to create a backward compatible wire-format. + * Deprecated. Use 'policy' to specify bindings. * * Generated from protobuf field repeated .google.cloud.compute.v1.Binding bindings = 403251854; */ private $bindings; /** - * Flatten Policy to create a backward compatible wire-format. Deprecated. Use 'policy' to specify the etag. + * Flatten Policy to create a backward compatible wire-format. + * Deprecated. Use 'policy' to specify the etag. * * Generated from protobuf field optional string etag = 3123477; */ protected $etag = null; /** - * REQUIRED: The complete policy to be applied to the 'resource'. The size of the policy is limited to a few 10s of KB. An empty policy is in general a valid policy but certain services (like Projects) might reject them. + * REQUIRED: The complete policy to be applied to the 'resource'. The size of + * the policy is limited to a few 10s of KB. An empty policy is in general a + * valid policy but certain services (like Projects) might reject them. * * Generated from protobuf field optional .google.cloud.compute.v1.Policy policy = 91071794; */ @@ -40,11 +44,15 @@ class GlobalSetPolicyRequest extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type array<\Google\Cloud\Compute\V1\Binding>|\Google\Protobuf\Internal\RepeatedField $bindings - * Flatten Policy to create a backward compatible wire-format. Deprecated. Use 'policy' to specify bindings. + * Flatten Policy to create a backward compatible wire-format. + * Deprecated. Use 'policy' to specify bindings. * @type string $etag - * Flatten Policy to create a backward compatible wire-format. Deprecated. Use 'policy' to specify the etag. + * Flatten Policy to create a backward compatible wire-format. + * Deprecated. Use 'policy' to specify the etag. * @type \Google\Cloud\Compute\V1\Policy $policy - * REQUIRED: The complete policy to be applied to the 'resource'. The size of the policy is limited to a few 10s of KB. An empty policy is in general a valid policy but certain services (like Projects) might reject them. + * REQUIRED: The complete policy to be applied to the 'resource'. The size of + * the policy is limited to a few 10s of KB. An empty policy is in general a + * valid policy but certain services (like Projects) might reject them. * } */ public function __construct($data = NULL) { @@ -53,7 +61,8 @@ public function __construct($data = NULL) { } /** - * Flatten Policy to create a backward compatible wire-format. Deprecated. Use 'policy' to specify bindings. + * Flatten Policy to create a backward compatible wire-format. + * Deprecated. Use 'policy' to specify bindings. * * Generated from protobuf field repeated .google.cloud.compute.v1.Binding bindings = 403251854; * @return \Google\Protobuf\Internal\RepeatedField @@ -64,7 +73,8 @@ public function getBindings() } /** - * Flatten Policy to create a backward compatible wire-format. Deprecated. Use 'policy' to specify bindings. + * Flatten Policy to create a backward compatible wire-format. + * Deprecated. Use 'policy' to specify bindings. * * Generated from protobuf field repeated .google.cloud.compute.v1.Binding bindings = 403251854; * @param array<\Google\Cloud\Compute\V1\Binding>|\Google\Protobuf\Internal\RepeatedField $var @@ -79,7 +89,8 @@ public function setBindings($var) } /** - * Flatten Policy to create a backward compatible wire-format. Deprecated. Use 'policy' to specify the etag. + * Flatten Policy to create a backward compatible wire-format. + * Deprecated. Use 'policy' to specify the etag. * * Generated from protobuf field optional string etag = 3123477; * @return string @@ -100,7 +111,8 @@ public function clearEtag() } /** - * Flatten Policy to create a backward compatible wire-format. Deprecated. Use 'policy' to specify the etag. + * Flatten Policy to create a backward compatible wire-format. + * Deprecated. Use 'policy' to specify the etag. * * Generated from protobuf field optional string etag = 3123477; * @param string $var @@ -115,7 +127,9 @@ public function setEtag($var) } /** - * REQUIRED: The complete policy to be applied to the 'resource'. The size of the policy is limited to a few 10s of KB. An empty policy is in general a valid policy but certain services (like Projects) might reject them. + * REQUIRED: The complete policy to be applied to the 'resource'. The size of + * the policy is limited to a few 10s of KB. An empty policy is in general a + * valid policy but certain services (like Projects) might reject them. * * Generated from protobuf field optional .google.cloud.compute.v1.Policy policy = 91071794; * @return \Google\Cloud\Compute\V1\Policy|null @@ -136,7 +150,9 @@ public function clearPolicy() } /** - * REQUIRED: The complete policy to be applied to the 'resource'. The size of the policy is limited to a few 10s of KB. An empty policy is in general a valid policy but certain services (like Projects) might reject them. + * REQUIRED: The complete policy to be applied to the 'resource'. The size of + * the policy is limited to a few 10s of KB. An empty policy is in general a + * valid policy but certain services (like Projects) might reject them. * * Generated from protobuf field optional .google.cloud.compute.v1.Policy policy = 91071794; * @param \Google\Cloud\Compute\V1\Policy $var diff --git a/Compute/src/V1/GroupMaintenanceInfo.php b/Compute/src/V1/GroupMaintenanceInfo.php index 4adc75481700..590b114e39f3 100644 --- a/Compute/src/V1/GroupMaintenanceInfo.php +++ b/Compute/src/V1/GroupMaintenanceInfo.php @@ -28,13 +28,15 @@ class GroupMaintenanceInfo extends \Google\Protobuf\Internal\Message */ protected $instance_maintenance_pending_count = null; /** - * Progress for ongoing maintenance for this group of VMs/hosts. Describes number of hosts in the block that have ongoing maintenance. + * Progress for ongoing maintenance for this group of VMs/hosts. + * Describes number of hosts in the block that have ongoing maintenance. * * Generated from protobuf field optional int32 maintenance_ongoing_count = 219781919; */ protected $maintenance_ongoing_count = null; /** - * Progress for ongoing maintenance for this group of VMs/hosts. Describes number of hosts in the block that have pending maintenance. + * Progress for ongoing maintenance for this group of VMs/hosts. + * Describes number of hosts in the block that have pending maintenance. * * Generated from protobuf field optional int32 maintenance_pending_count = 158783547; */ @@ -47,13 +49,19 @@ class GroupMaintenanceInfo extends \Google\Protobuf\Internal\Message */ protected $scheduling_type = null; /** - * Describes number of subblock Infrastructure that has ongoing maintenance. Here, Subblock Infrastructure Maintenance pertains to upstream hardware contained in the Subblock that is necessary for a VM Family(e.g. NVLink Domains). Not all VM Families will support this field. + * Describes number of subblock Infrastructure that has ongoing maintenance. + * Here, Subblock Infrastructure Maintenance pertains to upstream hardware + * contained in the Subblock that is necessary for a VM Family(e.g. NVLink + * Domains). Not all VM Families will support this field. * * Generated from protobuf field optional int32 subblock_infra_maintenance_ongoing_count = 366161790; */ protected $subblock_infra_maintenance_ongoing_count = null; /** - * Describes number of subblock Infrastructure that has pending maintenance. Here, Subblock Infrastructure Maintenance pertains to upstream hardware contained in the Subblock that is necessary for a VM Family (e.g. NVLink Domains). Not all VM Families will support this field. + * Describes number of subblock Infrastructure that has pending maintenance. + * Here, Subblock Infrastructure Maintenance pertains to upstream hardware + * contained in the Subblock that is necessary for a VM Family (e.g. NVLink + * Domains). Not all VM Families will support this field. * * Generated from protobuf field optional int32 subblock_infra_maintenance_pending_count = 305163418; */ @@ -76,16 +84,24 @@ class GroupMaintenanceInfo extends \Google\Protobuf\Internal\Message * @type int $instance_maintenance_pending_count * Describes number of instances that have pending maintenance. * @type int $maintenance_ongoing_count - * Progress for ongoing maintenance for this group of VMs/hosts. Describes number of hosts in the block that have ongoing maintenance. + * Progress for ongoing maintenance for this group of VMs/hosts. + * Describes number of hosts in the block that have ongoing maintenance. * @type int $maintenance_pending_count - * Progress for ongoing maintenance for this group of VMs/hosts. Describes number of hosts in the block that have pending maintenance. + * Progress for ongoing maintenance for this group of VMs/hosts. + * Describes number of hosts in the block that have pending maintenance. * @type string $scheduling_type * The type of maintenance for the reservation. * Check the SchedulingType enum for the list of possible values. * @type int $subblock_infra_maintenance_ongoing_count - * Describes number of subblock Infrastructure that has ongoing maintenance. Here, Subblock Infrastructure Maintenance pertains to upstream hardware contained in the Subblock that is necessary for a VM Family(e.g. NVLink Domains). Not all VM Families will support this field. + * Describes number of subblock Infrastructure that has ongoing maintenance. + * Here, Subblock Infrastructure Maintenance pertains to upstream hardware + * contained in the Subblock that is necessary for a VM Family(e.g. NVLink + * Domains). Not all VM Families will support this field. * @type int $subblock_infra_maintenance_pending_count - * Describes number of subblock Infrastructure that has pending maintenance. Here, Subblock Infrastructure Maintenance pertains to upstream hardware contained in the Subblock that is necessary for a VM Family (e.g. NVLink Domains). Not all VM Families will support this field. + * Describes number of subblock Infrastructure that has pending maintenance. + * Here, Subblock Infrastructure Maintenance pertains to upstream hardware + * contained in the Subblock that is necessary for a VM Family (e.g. NVLink + * Domains). Not all VM Families will support this field. * @type \Google\Cloud\Compute\V1\UpcomingMaintenance $upcoming_group_maintenance * Maintenance information on this group of VMs. * } @@ -168,7 +184,8 @@ public function setInstanceMaintenancePendingCount($var) } /** - * Progress for ongoing maintenance for this group of VMs/hosts. Describes number of hosts in the block that have ongoing maintenance. + * Progress for ongoing maintenance for this group of VMs/hosts. + * Describes number of hosts in the block that have ongoing maintenance. * * Generated from protobuf field optional int32 maintenance_ongoing_count = 219781919; * @return int @@ -189,7 +206,8 @@ public function clearMaintenanceOngoingCount() } /** - * Progress for ongoing maintenance for this group of VMs/hosts. Describes number of hosts in the block that have ongoing maintenance. + * Progress for ongoing maintenance for this group of VMs/hosts. + * Describes number of hosts in the block that have ongoing maintenance. * * Generated from protobuf field optional int32 maintenance_ongoing_count = 219781919; * @param int $var @@ -204,7 +222,8 @@ public function setMaintenanceOngoingCount($var) } /** - * Progress for ongoing maintenance for this group of VMs/hosts. Describes number of hosts in the block that have pending maintenance. + * Progress for ongoing maintenance for this group of VMs/hosts. + * Describes number of hosts in the block that have pending maintenance. * * Generated from protobuf field optional int32 maintenance_pending_count = 158783547; * @return int @@ -225,7 +244,8 @@ public function clearMaintenancePendingCount() } /** - * Progress for ongoing maintenance for this group of VMs/hosts. Describes number of hosts in the block that have pending maintenance. + * Progress for ongoing maintenance for this group of VMs/hosts. + * Describes number of hosts in the block that have pending maintenance. * * Generated from protobuf field optional int32 maintenance_pending_count = 158783547; * @param int $var @@ -278,7 +298,10 @@ public function setSchedulingType($var) } /** - * Describes number of subblock Infrastructure that has ongoing maintenance. Here, Subblock Infrastructure Maintenance pertains to upstream hardware contained in the Subblock that is necessary for a VM Family(e.g. NVLink Domains). Not all VM Families will support this field. + * Describes number of subblock Infrastructure that has ongoing maintenance. + * Here, Subblock Infrastructure Maintenance pertains to upstream hardware + * contained in the Subblock that is necessary for a VM Family(e.g. NVLink + * Domains). Not all VM Families will support this field. * * Generated from protobuf field optional int32 subblock_infra_maintenance_ongoing_count = 366161790; * @return int @@ -299,7 +322,10 @@ public function clearSubblockInfraMaintenanceOngoingCount() } /** - * Describes number of subblock Infrastructure that has ongoing maintenance. Here, Subblock Infrastructure Maintenance pertains to upstream hardware contained in the Subblock that is necessary for a VM Family(e.g. NVLink Domains). Not all VM Families will support this field. + * Describes number of subblock Infrastructure that has ongoing maintenance. + * Here, Subblock Infrastructure Maintenance pertains to upstream hardware + * contained in the Subblock that is necessary for a VM Family(e.g. NVLink + * Domains). Not all VM Families will support this field. * * Generated from protobuf field optional int32 subblock_infra_maintenance_ongoing_count = 366161790; * @param int $var @@ -314,7 +340,10 @@ public function setSubblockInfraMaintenanceOngoingCount($var) } /** - * Describes number of subblock Infrastructure that has pending maintenance. Here, Subblock Infrastructure Maintenance pertains to upstream hardware contained in the Subblock that is necessary for a VM Family (e.g. NVLink Domains). Not all VM Families will support this field. + * Describes number of subblock Infrastructure that has pending maintenance. + * Here, Subblock Infrastructure Maintenance pertains to upstream hardware + * contained in the Subblock that is necessary for a VM Family (e.g. NVLink + * Domains). Not all VM Families will support this field. * * Generated from protobuf field optional int32 subblock_infra_maintenance_pending_count = 305163418; * @return int @@ -335,7 +364,10 @@ public function clearSubblockInfraMaintenancePendingCount() } /** - * Describes number of subblock Infrastructure that has pending maintenance. Here, Subblock Infrastructure Maintenance pertains to upstream hardware contained in the Subblock that is necessary for a VM Family (e.g. NVLink Domains). Not all VM Families will support this field. + * Describes number of subblock Infrastructure that has pending maintenance. + * Here, Subblock Infrastructure Maintenance pertains to upstream hardware + * contained in the Subblock that is necessary for a VM Family (e.g. NVLink + * Domains). Not all VM Families will support this field. * * Generated from protobuf field optional int32 subblock_infra_maintenance_pending_count = 305163418; * @param int $var diff --git a/Compute/src/V1/GroupMaintenanceInfo/SchedulingType.php b/Compute/src/V1/GroupMaintenanceInfo/SchedulingType.php index ed3158bbc2f2..6a5f7b8db000 100644 --- a/Compute/src/V1/GroupMaintenanceInfo/SchedulingType.php +++ b/Compute/src/V1/GroupMaintenanceInfo/SchedulingType.php @@ -32,7 +32,8 @@ class SchedulingType */ const GROUP_MAINTENANCE_TYPE_UNSPECIFIED = 447183678; /** - * Maintenance is not synchronized for this reservation. Instead, each instance has its own maintenance window. + * Maintenance is not synchronized for this reservation. Instead, each + * instance has its own maintenance window. * * Generated from protobuf enum INDEPENDENT = 127011674; */ diff --git a/Compute/src/V1/GuestAttributes.php b/Compute/src/V1/GuestAttributes.php index c348e89137ba..9795391f91e2 100644 --- a/Compute/src/V1/GuestAttributes.php +++ b/Compute/src/V1/GuestAttributes.php @@ -16,13 +16,15 @@ class GuestAttributes extends \Google\Protobuf\Internal\Message { /** - * [Output Only] Type of the resource. Always compute#guestAttributes for guest attributes entry. + * [Output Only] Type of the resource. Alwayscompute#guestAttributes for guest attributes entry. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * The path to be queried. This can be the default namespace ('') or a nested namespace ('\/') or a specified key ('\/\'). + * The path to be queried. This can be the default namespace ('') or a + * nested namespace ('\/') or a specified key + * ('\/\'). * * Generated from protobuf field optional string query_path = 368591164; */ @@ -59,9 +61,11 @@ class GuestAttributes extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $kind - * [Output Only] Type of the resource. Always compute#guestAttributes for guest attributes entry. + * [Output Only] Type of the resource. Alwayscompute#guestAttributes for guest attributes entry. * @type string $query_path - * The path to be queried. This can be the default namespace ('') or a nested namespace ('\/') or a specified key ('\/\'). + * The path to be queried. This can be the default namespace ('') or a + * nested namespace ('\/') or a specified key + * ('\/\'). * @type \Google\Cloud\Compute\V1\GuestAttributesValue $query_value * [Output Only] The value of the requested queried path. * @type string $self_link @@ -78,7 +82,7 @@ public function __construct($data = NULL) { } /** - * [Output Only] Type of the resource. Always compute#guestAttributes for guest attributes entry. + * [Output Only] Type of the resource. Alwayscompute#guestAttributes for guest attributes entry. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -99,7 +103,7 @@ public function clearKind() } /** - * [Output Only] Type of the resource. Always compute#guestAttributes for guest attributes entry. + * [Output Only] Type of the resource. Alwayscompute#guestAttributes for guest attributes entry. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -114,7 +118,9 @@ public function setKind($var) } /** - * The path to be queried. This can be the default namespace ('') or a nested namespace ('\/') or a specified key ('\/\'). + * The path to be queried. This can be the default namespace ('') or a + * nested namespace ('\/') or a specified key + * ('\/\'). * * Generated from protobuf field optional string query_path = 368591164; * @return string @@ -135,7 +141,9 @@ public function clearQueryPath() } /** - * The path to be queried. This can be the default namespace ('') or a nested namespace ('\/') or a specified key ('\/\'). + * The path to be queried. This can be the default namespace ('') or a + * nested namespace ('\/') or a specified key + * ('\/\'). * * Generated from protobuf field optional string query_path = 368591164; * @param string $var diff --git a/Compute/src/V1/GuestOsFeature.php b/Compute/src/V1/GuestOsFeature.php index a15b3f97b3d6..bda7a963d47e 100644 --- a/Compute/src/V1/GuestOsFeature.php +++ b/Compute/src/V1/GuestOsFeature.php @@ -16,7 +16,22 @@ class GuestOsFeature extends \Google\Protobuf\Internal\Message { /** - * The ID of a supported feature. To add multiple values, use commas to separate values. Set to one or more of the following values: - VIRTIO_SCSI_MULTIQUEUE - WINDOWS - MULTI_IP_SUBNET - UEFI_COMPATIBLE - GVNIC - SEV_CAPABLE - SUSPEND_RESUME_COMPATIBLE - SEV_LIVE_MIGRATABLE_V2 - SEV_SNP_CAPABLE - TDX_CAPABLE - IDPF - SNP_SVSM_CAPABLE For more information, see Enabling guest operating system features. + * The ID of a supported feature. To add multiple values, use commas to + * separate values. Set to one or more of the following values: + * - VIRTIO_SCSI_MULTIQUEUE + * - WINDOWS + * - MULTI_IP_SUBNET + * - UEFI_COMPATIBLE + * - GVNIC + * - SEV_CAPABLE + * - SUSPEND_RESUME_COMPATIBLE + * - SEV_LIVE_MIGRATABLE_V2 + * - SEV_SNP_CAPABLE + * - TDX_CAPABLE + * - IDPF + * - SNP_SVSM_CAPABLE + * For more information, see + * Enabling guest operating system features. * Check the Type enum for the list of possible values. * * Generated from protobuf field optional string type = 3575610; @@ -30,7 +45,22 @@ class GuestOsFeature extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $type - * The ID of a supported feature. To add multiple values, use commas to separate values. Set to one or more of the following values: - VIRTIO_SCSI_MULTIQUEUE - WINDOWS - MULTI_IP_SUBNET - UEFI_COMPATIBLE - GVNIC - SEV_CAPABLE - SUSPEND_RESUME_COMPATIBLE - SEV_LIVE_MIGRATABLE_V2 - SEV_SNP_CAPABLE - TDX_CAPABLE - IDPF - SNP_SVSM_CAPABLE For more information, see Enabling guest operating system features. + * The ID of a supported feature. To add multiple values, use commas to + * separate values. Set to one or more of the following values: + * - VIRTIO_SCSI_MULTIQUEUE + * - WINDOWS + * - MULTI_IP_SUBNET + * - UEFI_COMPATIBLE + * - GVNIC + * - SEV_CAPABLE + * - SUSPEND_RESUME_COMPATIBLE + * - SEV_LIVE_MIGRATABLE_V2 + * - SEV_SNP_CAPABLE + * - TDX_CAPABLE + * - IDPF + * - SNP_SVSM_CAPABLE + * For more information, see + * Enabling guest operating system features. * Check the Type enum for the list of possible values. * } */ @@ -40,7 +70,22 @@ public function __construct($data = NULL) { } /** - * The ID of a supported feature. To add multiple values, use commas to separate values. Set to one or more of the following values: - VIRTIO_SCSI_MULTIQUEUE - WINDOWS - MULTI_IP_SUBNET - UEFI_COMPATIBLE - GVNIC - SEV_CAPABLE - SUSPEND_RESUME_COMPATIBLE - SEV_LIVE_MIGRATABLE_V2 - SEV_SNP_CAPABLE - TDX_CAPABLE - IDPF - SNP_SVSM_CAPABLE For more information, see Enabling guest operating system features. + * The ID of a supported feature. To add multiple values, use commas to + * separate values. Set to one or more of the following values: + * - VIRTIO_SCSI_MULTIQUEUE + * - WINDOWS + * - MULTI_IP_SUBNET + * - UEFI_COMPATIBLE + * - GVNIC + * - SEV_CAPABLE + * - SUSPEND_RESUME_COMPATIBLE + * - SEV_LIVE_MIGRATABLE_V2 + * - SEV_SNP_CAPABLE + * - TDX_CAPABLE + * - IDPF + * - SNP_SVSM_CAPABLE + * For more information, see + * Enabling guest operating system features. * Check the Type enum for the list of possible values. * * Generated from protobuf field optional string type = 3575610; @@ -62,7 +107,22 @@ public function clearType() } /** - * The ID of a supported feature. To add multiple values, use commas to separate values. Set to one or more of the following values: - VIRTIO_SCSI_MULTIQUEUE - WINDOWS - MULTI_IP_SUBNET - UEFI_COMPATIBLE - GVNIC - SEV_CAPABLE - SUSPEND_RESUME_COMPATIBLE - SEV_LIVE_MIGRATABLE_V2 - SEV_SNP_CAPABLE - TDX_CAPABLE - IDPF - SNP_SVSM_CAPABLE For more information, see Enabling guest operating system features. + * The ID of a supported feature. To add multiple values, use commas to + * separate values. Set to one or more of the following values: + * - VIRTIO_SCSI_MULTIQUEUE + * - WINDOWS + * - MULTI_IP_SUBNET + * - UEFI_COMPATIBLE + * - GVNIC + * - SEV_CAPABLE + * - SUSPEND_RESUME_COMPATIBLE + * - SEV_LIVE_MIGRATABLE_V2 + * - SEV_SNP_CAPABLE + * - TDX_CAPABLE + * - IDPF + * - SNP_SVSM_CAPABLE + * For more information, see + * Enabling guest operating system features. * Check the Type enum for the list of possible values. * * Generated from protobuf field optional string type = 3575610; diff --git a/Compute/src/V1/GuestOsFeature/Type.php b/Compute/src/V1/GuestOsFeature/Type.php index 3341d6ee581a..11b67ad09fab 100644 --- a/Compute/src/V1/GuestOsFeature/Type.php +++ b/Compute/src/V1/GuestOsFeature/Type.php @@ -7,7 +7,22 @@ use UnexpectedValueException; /** - * The ID of a supported feature. To add multiple values, use commas to separate values. Set to one or more of the following values: - VIRTIO_SCSI_MULTIQUEUE - WINDOWS - MULTI_IP_SUBNET - UEFI_COMPATIBLE - GVNIC - SEV_CAPABLE - SUSPEND_RESUME_COMPATIBLE - SEV_LIVE_MIGRATABLE_V2 - SEV_SNP_CAPABLE - TDX_CAPABLE - IDPF - SNP_SVSM_CAPABLE For more information, see Enabling guest operating system features. + * The ID of a supported feature. To add multiple values, use commas to + * separate values. Set to one or more of the following values: + * - VIRTIO_SCSI_MULTIQUEUE + * - WINDOWS + * - MULTI_IP_SUBNET + * - UEFI_COMPATIBLE + * - GVNIC + * - SEV_CAPABLE + * - SUSPEND_RESUME_COMPATIBLE + * - SEV_LIVE_MIGRATABLE_V2 + * - SEV_SNP_CAPABLE + * - TDX_CAPABLE + * - IDPF + * - SNP_SVSM_CAPABLE + * For more information, see + * Enabling guest operating system features. * * Protobuf type google.cloud.compute.v1.GuestOsFeature.Type */ diff --git a/Compute/src/V1/HTTP2HealthCheck.php b/Compute/src/V1/HTTP2HealthCheck.php index cdbe78cce766..e745d342b795 100644 --- a/Compute/src/V1/HTTP2HealthCheck.php +++ b/Compute/src/V1/HTTP2HealthCheck.php @@ -15,13 +15,18 @@ class HTTP2HealthCheck extends \Google\Protobuf\Internal\Message { /** - * The value of the host header in the HTTP/2 health check request. If left empty (default value), the host header is set to the destination IP address to which health check packets are sent. The destination IP address depends on the type of load balancer. For details, see: https://cloud.google.com/load-balancing/docs/health-check-concepts#hc-packet-dest + * The value of the host header in the HTTP/2 health check request. If left + * empty (default value), the host header is set to the destination IP address + * to which health check packets are sent. The destination IP address depends + * on the type of load balancer. For details, see: + * https://cloud.google.com/load-balancing/docs/health-check-concepts#hc-packet-dest * * Generated from protobuf field optional string host = 3208616; */ protected $host = null; /** - * The TCP port number to which the health check prober sends packets. The default value is 443. Valid values are 1 through 65535. + * The TCP port number to which the health check prober sends packets. The + * default value is 443. Valid values are 1 through65535. * * Generated from protobuf field optional int32 port = 3446913; */ @@ -33,27 +38,53 @@ class HTTP2HealthCheck extends \Google\Protobuf\Internal\Message */ protected $port_name = null; /** - * Specifies how a port is selected for health checking. Can be one of the following values: USE_FIXED_PORT: Specifies a port number explicitly using the port field in the health check. Supported by backend services for passthrough load balancers and backend services for proxy load balancers. Not supported by target pools. The health check supports all backends supported by the backend service provided the backend can be health checked. For example, GCE_VM_IP network endpoint groups, GCE_VM_IP_PORT network endpoint groups, and instance group backends. USE_NAMED_PORT: Not supported. USE_SERVING_PORT: Provides an indirect method of specifying the health check port by referring to the backend service. Only supported by backend services for proxy load balancers. Not supported by target pools. Not supported by backend services for passthrough load balancers. Supports all backends that can be health checked; for example, GCE_VM_IP_PORT network endpoint groups and instance group backends. For GCE_VM_IP_PORT network endpoint group backends, the health check uses the port number specified for each endpoint in the network endpoint group. For instance group backends, the health check uses the port number determined by looking up the backend service's named port in the instance group's list of named ports. + * Specifies how a port is selected for health checking. Can be one of the + * following values: + * USE_FIXED_PORT: Specifies a port number explicitly using theport field in the health check. Supported by backend services + * for passthrough load balancers and backend services for proxy load + * balancers. Not supported by target pools. The health check supports all + * backends supported by the backend service provided the backend can be + * health checked. For example, GCE_VM_IP network endpoint + * groups, GCE_VM_IP_PORT network endpoint groups, and instance + * group backends. + * USE_NAMED_PORT: Not supported. + * USE_SERVING_PORT: Provides an indirect method of specifying + * the health check port by referring to the backend service. Only supported + * by backend services for proxy load balancers. Not supported by target + * pools. Not supported by backend services for passthrough load balancers. + * Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group + * backends. + * For GCE_VM_IP_PORT network endpoint group backends, the health + * check uses the port number specified for each endpoint in the network + * endpoint group. For instance group backends, the health check uses the + * port number determined by looking up the backend service's named port in + * the instance group's list of named ports. * Check the PortSpecification enum for the list of possible values. * * Generated from protobuf field optional string port_specification = 51590597; */ protected $port_specification = null; /** - * Specifies the type of proxy header to append before sending data to the backend, either NONE or PROXY_V1. The default is NONE. + * Specifies the type of proxy header to append before sending data to the + * backend, either NONE or PROXY_V1. The default + * is NONE. * Check the ProxyHeader enum for the list of possible values. * * Generated from protobuf field optional string proxy_header = 160374142; */ protected $proxy_header = null; /** - * The request path of the HTTP/2 health check request. The default value is /. Must comply with RFC3986. + * The request path of the HTTP/2 health check request. The default value is/. Must comply withRFC3986. * * Generated from protobuf field optional string request_path = 229403605; */ protected $request_path = null; /** - * Creates a content-based HTTP/2 health check. In addition to the required HTTP 200 (OK) status code, you can configure the health check to pass only when the backend sends this specific ASCII response string within the first 1024 bytes of the HTTP response body. For details, see: https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-http + * Creates a content-based HTTP/2 health check. In addition to the required + * HTTP 200 (OK) status code, you can configure the health check to pass only + * when the backend sends this specific ASCII response string within the first + * 1024 bytes of the HTTP response body. For details, see: + * https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-http * * Generated from protobuf field optional string response = 196547649; */ @@ -66,21 +97,52 @@ class HTTP2HealthCheck extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $host - * The value of the host header in the HTTP/2 health check request. If left empty (default value), the host header is set to the destination IP address to which health check packets are sent. The destination IP address depends on the type of load balancer. For details, see: https://cloud.google.com/load-balancing/docs/health-check-concepts#hc-packet-dest + * The value of the host header in the HTTP/2 health check request. If left + * empty (default value), the host header is set to the destination IP address + * to which health check packets are sent. The destination IP address depends + * on the type of load balancer. For details, see: + * https://cloud.google.com/load-balancing/docs/health-check-concepts#hc-packet-dest * @type int $port - * The TCP port number to which the health check prober sends packets. The default value is 443. Valid values are 1 through 65535. + * The TCP port number to which the health check prober sends packets. The + * default value is 443. Valid values are 1 through65535. * @type string $port_name * Not supported. * @type string $port_specification - * Specifies how a port is selected for health checking. Can be one of the following values: USE_FIXED_PORT: Specifies a port number explicitly using the port field in the health check. Supported by backend services for passthrough load balancers and backend services for proxy load balancers. Not supported by target pools. The health check supports all backends supported by the backend service provided the backend can be health checked. For example, GCE_VM_IP network endpoint groups, GCE_VM_IP_PORT network endpoint groups, and instance group backends. USE_NAMED_PORT: Not supported. USE_SERVING_PORT: Provides an indirect method of specifying the health check port by referring to the backend service. Only supported by backend services for proxy load balancers. Not supported by target pools. Not supported by backend services for passthrough load balancers. Supports all backends that can be health checked; for example, GCE_VM_IP_PORT network endpoint groups and instance group backends. For GCE_VM_IP_PORT network endpoint group backends, the health check uses the port number specified for each endpoint in the network endpoint group. For instance group backends, the health check uses the port number determined by looking up the backend service's named port in the instance group's list of named ports. + * Specifies how a port is selected for health checking. Can be one of the + * following values: + * USE_FIXED_PORT: Specifies a port number explicitly using theport field in the health check. Supported by backend services + * for passthrough load balancers and backend services for proxy load + * balancers. Not supported by target pools. The health check supports all + * backends supported by the backend service provided the backend can be + * health checked. For example, GCE_VM_IP network endpoint + * groups, GCE_VM_IP_PORT network endpoint groups, and instance + * group backends. + * USE_NAMED_PORT: Not supported. + * USE_SERVING_PORT: Provides an indirect method of specifying + * the health check port by referring to the backend service. Only supported + * by backend services for proxy load balancers. Not supported by target + * pools. Not supported by backend services for passthrough load balancers. + * Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group + * backends. + * For GCE_VM_IP_PORT network endpoint group backends, the health + * check uses the port number specified for each endpoint in the network + * endpoint group. For instance group backends, the health check uses the + * port number determined by looking up the backend service's named port in + * the instance group's list of named ports. * Check the PortSpecification enum for the list of possible values. * @type string $proxy_header - * Specifies the type of proxy header to append before sending data to the backend, either NONE or PROXY_V1. The default is NONE. + * Specifies the type of proxy header to append before sending data to the + * backend, either NONE or PROXY_V1. The default + * is NONE. * Check the ProxyHeader enum for the list of possible values. * @type string $request_path - * The request path of the HTTP/2 health check request. The default value is /. Must comply with RFC3986. + * The request path of the HTTP/2 health check request. The default value is/. Must comply withRFC3986. * @type string $response - * Creates a content-based HTTP/2 health check. In addition to the required HTTP 200 (OK) status code, you can configure the health check to pass only when the backend sends this specific ASCII response string within the first 1024 bytes of the HTTP response body. For details, see: https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-http + * Creates a content-based HTTP/2 health check. In addition to the required + * HTTP 200 (OK) status code, you can configure the health check to pass only + * when the backend sends this specific ASCII response string within the first + * 1024 bytes of the HTTP response body. For details, see: + * https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-http * } */ public function __construct($data = NULL) { @@ -89,7 +151,11 @@ public function __construct($data = NULL) { } /** - * The value of the host header in the HTTP/2 health check request. If left empty (default value), the host header is set to the destination IP address to which health check packets are sent. The destination IP address depends on the type of load balancer. For details, see: https://cloud.google.com/load-balancing/docs/health-check-concepts#hc-packet-dest + * The value of the host header in the HTTP/2 health check request. If left + * empty (default value), the host header is set to the destination IP address + * to which health check packets are sent. The destination IP address depends + * on the type of load balancer. For details, see: + * https://cloud.google.com/load-balancing/docs/health-check-concepts#hc-packet-dest * * Generated from protobuf field optional string host = 3208616; * @return string @@ -110,7 +176,11 @@ public function clearHost() } /** - * The value of the host header in the HTTP/2 health check request. If left empty (default value), the host header is set to the destination IP address to which health check packets are sent. The destination IP address depends on the type of load balancer. For details, see: https://cloud.google.com/load-balancing/docs/health-check-concepts#hc-packet-dest + * The value of the host header in the HTTP/2 health check request. If left + * empty (default value), the host header is set to the destination IP address + * to which health check packets are sent. The destination IP address depends + * on the type of load balancer. For details, see: + * https://cloud.google.com/load-balancing/docs/health-check-concepts#hc-packet-dest * * Generated from protobuf field optional string host = 3208616; * @param string $var @@ -125,7 +195,8 @@ public function setHost($var) } /** - * The TCP port number to which the health check prober sends packets. The default value is 443. Valid values are 1 through 65535. + * The TCP port number to which the health check prober sends packets. The + * default value is 443. Valid values are 1 through65535. * * Generated from protobuf field optional int32 port = 3446913; * @return int @@ -146,7 +217,8 @@ public function clearPort() } /** - * The TCP port number to which the health check prober sends packets. The default value is 443. Valid values are 1 through 65535. + * The TCP port number to which the health check prober sends packets. The + * default value is 443. Valid values are 1 through65535. * * Generated from protobuf field optional int32 port = 3446913; * @param int $var @@ -197,7 +269,27 @@ public function setPortName($var) } /** - * Specifies how a port is selected for health checking. Can be one of the following values: USE_FIXED_PORT: Specifies a port number explicitly using the port field in the health check. Supported by backend services for passthrough load balancers and backend services for proxy load balancers. Not supported by target pools. The health check supports all backends supported by the backend service provided the backend can be health checked. For example, GCE_VM_IP network endpoint groups, GCE_VM_IP_PORT network endpoint groups, and instance group backends. USE_NAMED_PORT: Not supported. USE_SERVING_PORT: Provides an indirect method of specifying the health check port by referring to the backend service. Only supported by backend services for proxy load balancers. Not supported by target pools. Not supported by backend services for passthrough load balancers. Supports all backends that can be health checked; for example, GCE_VM_IP_PORT network endpoint groups and instance group backends. For GCE_VM_IP_PORT network endpoint group backends, the health check uses the port number specified for each endpoint in the network endpoint group. For instance group backends, the health check uses the port number determined by looking up the backend service's named port in the instance group's list of named ports. + * Specifies how a port is selected for health checking. Can be one of the + * following values: + * USE_FIXED_PORT: Specifies a port number explicitly using theport field in the health check. Supported by backend services + * for passthrough load balancers and backend services for proxy load + * balancers. Not supported by target pools. The health check supports all + * backends supported by the backend service provided the backend can be + * health checked. For example, GCE_VM_IP network endpoint + * groups, GCE_VM_IP_PORT network endpoint groups, and instance + * group backends. + * USE_NAMED_PORT: Not supported. + * USE_SERVING_PORT: Provides an indirect method of specifying + * the health check port by referring to the backend service. Only supported + * by backend services for proxy load balancers. Not supported by target + * pools. Not supported by backend services for passthrough load balancers. + * Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group + * backends. + * For GCE_VM_IP_PORT network endpoint group backends, the health + * check uses the port number specified for each endpoint in the network + * endpoint group. For instance group backends, the health check uses the + * port number determined by looking up the backend service's named port in + * the instance group's list of named ports. * Check the PortSpecification enum for the list of possible values. * * Generated from protobuf field optional string port_specification = 51590597; @@ -219,7 +311,27 @@ public function clearPortSpecification() } /** - * Specifies how a port is selected for health checking. Can be one of the following values: USE_FIXED_PORT: Specifies a port number explicitly using the port field in the health check. Supported by backend services for passthrough load balancers and backend services for proxy load balancers. Not supported by target pools. The health check supports all backends supported by the backend service provided the backend can be health checked. For example, GCE_VM_IP network endpoint groups, GCE_VM_IP_PORT network endpoint groups, and instance group backends. USE_NAMED_PORT: Not supported. USE_SERVING_PORT: Provides an indirect method of specifying the health check port by referring to the backend service. Only supported by backend services for proxy load balancers. Not supported by target pools. Not supported by backend services for passthrough load balancers. Supports all backends that can be health checked; for example, GCE_VM_IP_PORT network endpoint groups and instance group backends. For GCE_VM_IP_PORT network endpoint group backends, the health check uses the port number specified for each endpoint in the network endpoint group. For instance group backends, the health check uses the port number determined by looking up the backend service's named port in the instance group's list of named ports. + * Specifies how a port is selected for health checking. Can be one of the + * following values: + * USE_FIXED_PORT: Specifies a port number explicitly using theport field in the health check. Supported by backend services + * for passthrough load balancers and backend services for proxy load + * balancers. Not supported by target pools. The health check supports all + * backends supported by the backend service provided the backend can be + * health checked. For example, GCE_VM_IP network endpoint + * groups, GCE_VM_IP_PORT network endpoint groups, and instance + * group backends. + * USE_NAMED_PORT: Not supported. + * USE_SERVING_PORT: Provides an indirect method of specifying + * the health check port by referring to the backend service. Only supported + * by backend services for proxy load balancers. Not supported by target + * pools. Not supported by backend services for passthrough load balancers. + * Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group + * backends. + * For GCE_VM_IP_PORT network endpoint group backends, the health + * check uses the port number specified for each endpoint in the network + * endpoint group. For instance group backends, the health check uses the + * port number determined by looking up the backend service's named port in + * the instance group's list of named ports. * Check the PortSpecification enum for the list of possible values. * * Generated from protobuf field optional string port_specification = 51590597; @@ -235,7 +347,9 @@ public function setPortSpecification($var) } /** - * Specifies the type of proxy header to append before sending data to the backend, either NONE or PROXY_V1. The default is NONE. + * Specifies the type of proxy header to append before sending data to the + * backend, either NONE or PROXY_V1. The default + * is NONE. * Check the ProxyHeader enum for the list of possible values. * * Generated from protobuf field optional string proxy_header = 160374142; @@ -257,7 +371,9 @@ public function clearProxyHeader() } /** - * Specifies the type of proxy header to append before sending data to the backend, either NONE or PROXY_V1. The default is NONE. + * Specifies the type of proxy header to append before sending data to the + * backend, either NONE or PROXY_V1. The default + * is NONE. * Check the ProxyHeader enum for the list of possible values. * * Generated from protobuf field optional string proxy_header = 160374142; @@ -273,7 +389,7 @@ public function setProxyHeader($var) } /** - * The request path of the HTTP/2 health check request. The default value is /. Must comply with RFC3986. + * The request path of the HTTP/2 health check request. The default value is/. Must comply withRFC3986. * * Generated from protobuf field optional string request_path = 229403605; * @return string @@ -294,7 +410,7 @@ public function clearRequestPath() } /** - * The request path of the HTTP/2 health check request. The default value is /. Must comply with RFC3986. + * The request path of the HTTP/2 health check request. The default value is/. Must comply withRFC3986. * * Generated from protobuf field optional string request_path = 229403605; * @param string $var @@ -309,7 +425,11 @@ public function setRequestPath($var) } /** - * Creates a content-based HTTP/2 health check. In addition to the required HTTP 200 (OK) status code, you can configure the health check to pass only when the backend sends this specific ASCII response string within the first 1024 bytes of the HTTP response body. For details, see: https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-http + * Creates a content-based HTTP/2 health check. In addition to the required + * HTTP 200 (OK) status code, you can configure the health check to pass only + * when the backend sends this specific ASCII response string within the first + * 1024 bytes of the HTTP response body. For details, see: + * https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-http * * Generated from protobuf field optional string response = 196547649; * @return string @@ -330,7 +450,11 @@ public function clearResponse() } /** - * Creates a content-based HTTP/2 health check. In addition to the required HTTP 200 (OK) status code, you can configure the health check to pass only when the backend sends this specific ASCII response string within the first 1024 bytes of the HTTP response body. For details, see: https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-http + * Creates a content-based HTTP/2 health check. In addition to the required + * HTTP 200 (OK) status code, you can configure the health check to pass only + * when the backend sends this specific ASCII response string within the first + * 1024 bytes of the HTTP response body. For details, see: + * https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-http * * Generated from protobuf field optional string response = 196547649; * @param string $var diff --git a/Compute/src/V1/HTTP2HealthCheck/PortSpecification.php b/Compute/src/V1/HTTP2HealthCheck/PortSpecification.php index 20f7a8d5b81a..508ce300f797 100644 --- a/Compute/src/V1/HTTP2HealthCheck/PortSpecification.php +++ b/Compute/src/V1/HTTP2HealthCheck/PortSpecification.php @@ -7,7 +7,27 @@ use UnexpectedValueException; /** - * Specifies how a port is selected for health checking. Can be one of the following values: USE_FIXED_PORT: Specifies a port number explicitly using the port field in the health check. Supported by backend services for passthrough load balancers and backend services for proxy load balancers. Not supported by target pools. The health check supports all backends supported by the backend service provided the backend can be health checked. For example, GCE_VM_IP network endpoint groups, GCE_VM_IP_PORT network endpoint groups, and instance group backends. USE_NAMED_PORT: Not supported. USE_SERVING_PORT: Provides an indirect method of specifying the health check port by referring to the backend service. Only supported by backend services for proxy load balancers. Not supported by target pools. Not supported by backend services for passthrough load balancers. Supports all backends that can be health checked; for example, GCE_VM_IP_PORT network endpoint groups and instance group backends. For GCE_VM_IP_PORT network endpoint group backends, the health check uses the port number specified for each endpoint in the network endpoint group. For instance group backends, the health check uses the port number determined by looking up the backend service's named port in the instance group's list of named ports. + * Specifies how a port is selected for health checking. Can be one of the + * following values: + * USE_FIXED_PORT: Specifies a port number explicitly using theport field in the health check. Supported by backend services + * for passthrough load balancers and backend services for proxy load + * balancers. Not supported by target pools. The health check supports all + * backends supported by the backend service provided the backend can be + * health checked. For example, GCE_VM_IP network endpoint + * groups, GCE_VM_IP_PORT network endpoint groups, and instance + * group backends. + * USE_NAMED_PORT: Not supported. + * USE_SERVING_PORT: Provides an indirect method of specifying + * the health check port by referring to the backend service. Only supported + * by backend services for proxy load balancers. Not supported by target + * pools. Not supported by backend services for passthrough load balancers. + * Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group + * backends. + * For GCE_VM_IP_PORT network endpoint group backends, the health + * check uses the port number specified for each endpoint in the network + * endpoint group. For instance group backends, the health check uses the + * port number determined by looking up the backend service's named port in + * the instance group's list of named ports. * * Protobuf type google.cloud.compute.v1.HTTP2HealthCheck.PortSpecification */ @@ -20,7 +40,8 @@ class PortSpecification */ const UNDEFINED_PORT_SPECIFICATION = 0; /** - * The port number in the health check's port is used for health checking. Applies to network endpoint group and instance group backends. + * The port number in the health check's port is used for health + * checking. Applies to network endpoint group and instance group backends. * * Generated from protobuf enum USE_FIXED_PORT = 190235748; */ @@ -32,7 +53,10 @@ class PortSpecification */ const USE_NAMED_PORT = 349300671; /** - * For network endpoint group backends, the health check uses the port number specified on each endpoint in the network endpoint group. For instance group backends, the health check uses the port number specified for the backend service's named port defined in the instance group's named ports. + * For network endpoint group backends, the health check uses the port number + * specified on each endpoint in the network endpoint group. For instance + * group backends, the health check uses the port number specified for the + * backend service's named port defined in the instance group's named ports. * * Generated from protobuf enum USE_SERVING_PORT = 362637516; */ diff --git a/Compute/src/V1/HTTP2HealthCheck/ProxyHeader.php b/Compute/src/V1/HTTP2HealthCheck/ProxyHeader.php index af733c864bf5..9d8841d80ab5 100644 --- a/Compute/src/V1/HTTP2HealthCheck/ProxyHeader.php +++ b/Compute/src/V1/HTTP2HealthCheck/ProxyHeader.php @@ -7,7 +7,9 @@ use UnexpectedValueException; /** - * Specifies the type of proxy header to append before sending data to the backend, either NONE or PROXY_V1. The default is NONE. + * Specifies the type of proxy header to append before sending data to the + * backend, either NONE or PROXY_V1. The default + * is NONE. * * Protobuf type google.cloud.compute.v1.HTTP2HealthCheck.ProxyHeader */ diff --git a/Compute/src/V1/HTTPHealthCheck.php b/Compute/src/V1/HTTPHealthCheck.php index 6a41a50abd26..c66200e03844 100644 --- a/Compute/src/V1/HTTPHealthCheck.php +++ b/Compute/src/V1/HTTPHealthCheck.php @@ -15,13 +15,18 @@ class HTTPHealthCheck extends \Google\Protobuf\Internal\Message { /** - * The value of the host header in the HTTP health check request. If left empty (default value), the host header is set to the destination IP address to which health check packets are sent. The destination IP address depends on the type of load balancer. For details, see: https://cloud.google.com/load-balancing/docs/health-check-concepts#hc-packet-dest + * The value of the host header in the HTTP health check request. If left + * empty (default value), the host header is set to the destination IP address + * to which health check packets are sent. The destination IP address depends + * on the type of load balancer. For details, see: + * https://cloud.google.com/load-balancing/docs/health-check-concepts#hc-packet-dest * * Generated from protobuf field optional string host = 3208616; */ protected $host = null; /** - * The TCP port number to which the health check prober sends packets. The default value is 80. Valid values are 1 through 65535. + * The TCP port number to which the health check prober sends packets. The + * default value is 80. Valid values are 1 through65535. * * Generated from protobuf field optional int32 port = 3446913; */ @@ -33,27 +38,52 @@ class HTTPHealthCheck extends \Google\Protobuf\Internal\Message */ protected $port_name = null; /** - * Specifies how a port is selected for health checking. Can be one of the following values: USE_FIXED_PORT: Specifies a port number explicitly using the port field in the health check. Supported by backend services for passthrough load balancers and backend services for proxy load balancers. Also supported in legacy HTTP health checks for target pools. The health check supports all backends supported by the backend service provided the backend can be health checked. For example, GCE_VM_IP network endpoint groups, GCE_VM_IP_PORT network endpoint groups, and instance group backends. USE_NAMED_PORT: Not supported. USE_SERVING_PORT: Provides an indirect method of specifying the health check port by referring to the backend service. Only supported by backend services for proxy load balancers. Not supported by target pools. Not supported by backend services for pass-through load balancers. Supports all backends that can be health checked; for example, GCE_VM_IP_PORT network endpoint groups and instance group backends. For GCE_VM_IP_PORT network endpoint group backends, the health check uses the port number specified for each endpoint in the network endpoint group. For instance group backends, the health check uses the port number determined by looking up the backend service's named port in the instance group's list of named ports. + * Specifies how a port is selected for health checking. Can be one of the + * following values: + * USE_FIXED_PORT: Specifies a port number explicitly using theport field in the health check. Supported by backend services + * for passthrough load balancers and backend services for proxy load + * balancers. Also supported in legacy HTTP health checks for target pools. + * The health check supports all backends supported by the backend service + * provided the backend can be health checked. For example,GCE_VM_IP network endpoint groups, GCE_VM_IP_PORT + * network endpoint groups, and instance group backends. + * USE_NAMED_PORT: Not supported. + * USE_SERVING_PORT: Provides an indirect method of specifying + * the health check port by referring to the backend service. Only supported + * by backend services for proxy load balancers. Not supported by target + * pools. Not supported by backend services for pass-through load balancers. + * Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group + * backends. + * For GCE_VM_IP_PORT network endpoint group backends, the health + * check uses the port number specified for each endpoint in the network + * endpoint group. For instance group backends, the health check uses the + * port number determined by looking up the backend service's named port in + * the instance group's list of named ports. * Check the PortSpecification enum for the list of possible values. * * Generated from protobuf field optional string port_specification = 51590597; */ protected $port_specification = null; /** - * Specifies the type of proxy header to append before sending data to the backend, either NONE or PROXY_V1. The default is NONE. + * Specifies the type of proxy header to append before sending data to the + * backend, either NONE or PROXY_V1. The default + * is NONE. * Check the ProxyHeader enum for the list of possible values. * * Generated from protobuf field optional string proxy_header = 160374142; */ protected $proxy_header = null; /** - * The request path of the HTTP health check request. The default value is /. Must comply with RFC3986. + * The request path of the HTTP health check request. The default value is/. Must comply withRFC3986. * * Generated from protobuf field optional string request_path = 229403605; */ protected $request_path = null; /** - * Creates a content-based HTTP health check. In addition to the required HTTP 200 (OK) status code, you can configure the health check to pass only when the backend sends this specific ASCII response string within the first 1024 bytes of the HTTP response body. For details, see: https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-http + * Creates a content-based HTTP health check. In addition to the required + * HTTP 200 (OK) status code, you can configure the health check to pass only + * when the backend sends this specific ASCII response string within the first + * 1024 bytes of the HTTP response body. For details, see: + * https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-http * * Generated from protobuf field optional string response = 196547649; */ @@ -66,21 +96,51 @@ class HTTPHealthCheck extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $host - * The value of the host header in the HTTP health check request. If left empty (default value), the host header is set to the destination IP address to which health check packets are sent. The destination IP address depends on the type of load balancer. For details, see: https://cloud.google.com/load-balancing/docs/health-check-concepts#hc-packet-dest + * The value of the host header in the HTTP health check request. If left + * empty (default value), the host header is set to the destination IP address + * to which health check packets are sent. The destination IP address depends + * on the type of load balancer. For details, see: + * https://cloud.google.com/load-balancing/docs/health-check-concepts#hc-packet-dest * @type int $port - * The TCP port number to which the health check prober sends packets. The default value is 80. Valid values are 1 through 65535. + * The TCP port number to which the health check prober sends packets. The + * default value is 80. Valid values are 1 through65535. * @type string $port_name * Not supported. * @type string $port_specification - * Specifies how a port is selected for health checking. Can be one of the following values: USE_FIXED_PORT: Specifies a port number explicitly using the port field in the health check. Supported by backend services for passthrough load balancers and backend services for proxy load balancers. Also supported in legacy HTTP health checks for target pools. The health check supports all backends supported by the backend service provided the backend can be health checked. For example, GCE_VM_IP network endpoint groups, GCE_VM_IP_PORT network endpoint groups, and instance group backends. USE_NAMED_PORT: Not supported. USE_SERVING_PORT: Provides an indirect method of specifying the health check port by referring to the backend service. Only supported by backend services for proxy load balancers. Not supported by target pools. Not supported by backend services for pass-through load balancers. Supports all backends that can be health checked; for example, GCE_VM_IP_PORT network endpoint groups and instance group backends. For GCE_VM_IP_PORT network endpoint group backends, the health check uses the port number specified for each endpoint in the network endpoint group. For instance group backends, the health check uses the port number determined by looking up the backend service's named port in the instance group's list of named ports. + * Specifies how a port is selected for health checking. Can be one of the + * following values: + * USE_FIXED_PORT: Specifies a port number explicitly using theport field in the health check. Supported by backend services + * for passthrough load balancers and backend services for proxy load + * balancers. Also supported in legacy HTTP health checks for target pools. + * The health check supports all backends supported by the backend service + * provided the backend can be health checked. For example,GCE_VM_IP network endpoint groups, GCE_VM_IP_PORT + * network endpoint groups, and instance group backends. + * USE_NAMED_PORT: Not supported. + * USE_SERVING_PORT: Provides an indirect method of specifying + * the health check port by referring to the backend service. Only supported + * by backend services for proxy load balancers. Not supported by target + * pools. Not supported by backend services for pass-through load balancers. + * Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group + * backends. + * For GCE_VM_IP_PORT network endpoint group backends, the health + * check uses the port number specified for each endpoint in the network + * endpoint group. For instance group backends, the health check uses the + * port number determined by looking up the backend service's named port in + * the instance group's list of named ports. * Check the PortSpecification enum for the list of possible values. * @type string $proxy_header - * Specifies the type of proxy header to append before sending data to the backend, either NONE or PROXY_V1. The default is NONE. + * Specifies the type of proxy header to append before sending data to the + * backend, either NONE or PROXY_V1. The default + * is NONE. * Check the ProxyHeader enum for the list of possible values. * @type string $request_path - * The request path of the HTTP health check request. The default value is /. Must comply with RFC3986. + * The request path of the HTTP health check request. The default value is/. Must comply withRFC3986. * @type string $response - * Creates a content-based HTTP health check. In addition to the required HTTP 200 (OK) status code, you can configure the health check to pass only when the backend sends this specific ASCII response string within the first 1024 bytes of the HTTP response body. For details, see: https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-http + * Creates a content-based HTTP health check. In addition to the required + * HTTP 200 (OK) status code, you can configure the health check to pass only + * when the backend sends this specific ASCII response string within the first + * 1024 bytes of the HTTP response body. For details, see: + * https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-http * } */ public function __construct($data = NULL) { @@ -89,7 +149,11 @@ public function __construct($data = NULL) { } /** - * The value of the host header in the HTTP health check request. If left empty (default value), the host header is set to the destination IP address to which health check packets are sent. The destination IP address depends on the type of load balancer. For details, see: https://cloud.google.com/load-balancing/docs/health-check-concepts#hc-packet-dest + * The value of the host header in the HTTP health check request. If left + * empty (default value), the host header is set to the destination IP address + * to which health check packets are sent. The destination IP address depends + * on the type of load balancer. For details, see: + * https://cloud.google.com/load-balancing/docs/health-check-concepts#hc-packet-dest * * Generated from protobuf field optional string host = 3208616; * @return string @@ -110,7 +174,11 @@ public function clearHost() } /** - * The value of the host header in the HTTP health check request. If left empty (default value), the host header is set to the destination IP address to which health check packets are sent. The destination IP address depends on the type of load balancer. For details, see: https://cloud.google.com/load-balancing/docs/health-check-concepts#hc-packet-dest + * The value of the host header in the HTTP health check request. If left + * empty (default value), the host header is set to the destination IP address + * to which health check packets are sent. The destination IP address depends + * on the type of load balancer. For details, see: + * https://cloud.google.com/load-balancing/docs/health-check-concepts#hc-packet-dest * * Generated from protobuf field optional string host = 3208616; * @param string $var @@ -125,7 +193,8 @@ public function setHost($var) } /** - * The TCP port number to which the health check prober sends packets. The default value is 80. Valid values are 1 through 65535. + * The TCP port number to which the health check prober sends packets. The + * default value is 80. Valid values are 1 through65535. * * Generated from protobuf field optional int32 port = 3446913; * @return int @@ -146,7 +215,8 @@ public function clearPort() } /** - * The TCP port number to which the health check prober sends packets. The default value is 80. Valid values are 1 through 65535. + * The TCP port number to which the health check prober sends packets. The + * default value is 80. Valid values are 1 through65535. * * Generated from protobuf field optional int32 port = 3446913; * @param int $var @@ -197,7 +267,26 @@ public function setPortName($var) } /** - * Specifies how a port is selected for health checking. Can be one of the following values: USE_FIXED_PORT: Specifies a port number explicitly using the port field in the health check. Supported by backend services for passthrough load balancers and backend services for proxy load balancers. Also supported in legacy HTTP health checks for target pools. The health check supports all backends supported by the backend service provided the backend can be health checked. For example, GCE_VM_IP network endpoint groups, GCE_VM_IP_PORT network endpoint groups, and instance group backends. USE_NAMED_PORT: Not supported. USE_SERVING_PORT: Provides an indirect method of specifying the health check port by referring to the backend service. Only supported by backend services for proxy load balancers. Not supported by target pools. Not supported by backend services for pass-through load balancers. Supports all backends that can be health checked; for example, GCE_VM_IP_PORT network endpoint groups and instance group backends. For GCE_VM_IP_PORT network endpoint group backends, the health check uses the port number specified for each endpoint in the network endpoint group. For instance group backends, the health check uses the port number determined by looking up the backend service's named port in the instance group's list of named ports. + * Specifies how a port is selected for health checking. Can be one of the + * following values: + * USE_FIXED_PORT: Specifies a port number explicitly using theport field in the health check. Supported by backend services + * for passthrough load balancers and backend services for proxy load + * balancers. Also supported in legacy HTTP health checks for target pools. + * The health check supports all backends supported by the backend service + * provided the backend can be health checked. For example,GCE_VM_IP network endpoint groups, GCE_VM_IP_PORT + * network endpoint groups, and instance group backends. + * USE_NAMED_PORT: Not supported. + * USE_SERVING_PORT: Provides an indirect method of specifying + * the health check port by referring to the backend service. Only supported + * by backend services for proxy load balancers. Not supported by target + * pools. Not supported by backend services for pass-through load balancers. + * Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group + * backends. + * For GCE_VM_IP_PORT network endpoint group backends, the health + * check uses the port number specified for each endpoint in the network + * endpoint group. For instance group backends, the health check uses the + * port number determined by looking up the backend service's named port in + * the instance group's list of named ports. * Check the PortSpecification enum for the list of possible values. * * Generated from protobuf field optional string port_specification = 51590597; @@ -219,7 +308,26 @@ public function clearPortSpecification() } /** - * Specifies how a port is selected for health checking. Can be one of the following values: USE_FIXED_PORT: Specifies a port number explicitly using the port field in the health check. Supported by backend services for passthrough load balancers and backend services for proxy load balancers. Also supported in legacy HTTP health checks for target pools. The health check supports all backends supported by the backend service provided the backend can be health checked. For example, GCE_VM_IP network endpoint groups, GCE_VM_IP_PORT network endpoint groups, and instance group backends. USE_NAMED_PORT: Not supported. USE_SERVING_PORT: Provides an indirect method of specifying the health check port by referring to the backend service. Only supported by backend services for proxy load balancers. Not supported by target pools. Not supported by backend services for pass-through load balancers. Supports all backends that can be health checked; for example, GCE_VM_IP_PORT network endpoint groups and instance group backends. For GCE_VM_IP_PORT network endpoint group backends, the health check uses the port number specified for each endpoint in the network endpoint group. For instance group backends, the health check uses the port number determined by looking up the backend service's named port in the instance group's list of named ports. + * Specifies how a port is selected for health checking. Can be one of the + * following values: + * USE_FIXED_PORT: Specifies a port number explicitly using theport field in the health check. Supported by backend services + * for passthrough load balancers and backend services for proxy load + * balancers. Also supported in legacy HTTP health checks for target pools. + * The health check supports all backends supported by the backend service + * provided the backend can be health checked. For example,GCE_VM_IP network endpoint groups, GCE_VM_IP_PORT + * network endpoint groups, and instance group backends. + * USE_NAMED_PORT: Not supported. + * USE_SERVING_PORT: Provides an indirect method of specifying + * the health check port by referring to the backend service. Only supported + * by backend services for proxy load balancers. Not supported by target + * pools. Not supported by backend services for pass-through load balancers. + * Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group + * backends. + * For GCE_VM_IP_PORT network endpoint group backends, the health + * check uses the port number specified for each endpoint in the network + * endpoint group. For instance group backends, the health check uses the + * port number determined by looking up the backend service's named port in + * the instance group's list of named ports. * Check the PortSpecification enum for the list of possible values. * * Generated from protobuf field optional string port_specification = 51590597; @@ -235,7 +343,9 @@ public function setPortSpecification($var) } /** - * Specifies the type of proxy header to append before sending data to the backend, either NONE or PROXY_V1. The default is NONE. + * Specifies the type of proxy header to append before sending data to the + * backend, either NONE or PROXY_V1. The default + * is NONE. * Check the ProxyHeader enum for the list of possible values. * * Generated from protobuf field optional string proxy_header = 160374142; @@ -257,7 +367,9 @@ public function clearProxyHeader() } /** - * Specifies the type of proxy header to append before sending data to the backend, either NONE or PROXY_V1. The default is NONE. + * Specifies the type of proxy header to append before sending data to the + * backend, either NONE or PROXY_V1. The default + * is NONE. * Check the ProxyHeader enum for the list of possible values. * * Generated from protobuf field optional string proxy_header = 160374142; @@ -273,7 +385,7 @@ public function setProxyHeader($var) } /** - * The request path of the HTTP health check request. The default value is /. Must comply with RFC3986. + * The request path of the HTTP health check request. The default value is/. Must comply withRFC3986. * * Generated from protobuf field optional string request_path = 229403605; * @return string @@ -294,7 +406,7 @@ public function clearRequestPath() } /** - * The request path of the HTTP health check request. The default value is /. Must comply with RFC3986. + * The request path of the HTTP health check request. The default value is/. Must comply withRFC3986. * * Generated from protobuf field optional string request_path = 229403605; * @param string $var @@ -309,7 +421,11 @@ public function setRequestPath($var) } /** - * Creates a content-based HTTP health check. In addition to the required HTTP 200 (OK) status code, you can configure the health check to pass only when the backend sends this specific ASCII response string within the first 1024 bytes of the HTTP response body. For details, see: https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-http + * Creates a content-based HTTP health check. In addition to the required + * HTTP 200 (OK) status code, you can configure the health check to pass only + * when the backend sends this specific ASCII response string within the first + * 1024 bytes of the HTTP response body. For details, see: + * https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-http * * Generated from protobuf field optional string response = 196547649; * @return string @@ -330,7 +446,11 @@ public function clearResponse() } /** - * Creates a content-based HTTP health check. In addition to the required HTTP 200 (OK) status code, you can configure the health check to pass only when the backend sends this specific ASCII response string within the first 1024 bytes of the HTTP response body. For details, see: https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-http + * Creates a content-based HTTP health check. In addition to the required + * HTTP 200 (OK) status code, you can configure the health check to pass only + * when the backend sends this specific ASCII response string within the first + * 1024 bytes of the HTTP response body. For details, see: + * https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-http * * Generated from protobuf field optional string response = 196547649; * @param string $var diff --git a/Compute/src/V1/HTTPHealthCheck/PortSpecification.php b/Compute/src/V1/HTTPHealthCheck/PortSpecification.php index 524ddbe9af72..000816e64eed 100644 --- a/Compute/src/V1/HTTPHealthCheck/PortSpecification.php +++ b/Compute/src/V1/HTTPHealthCheck/PortSpecification.php @@ -7,7 +7,26 @@ use UnexpectedValueException; /** - * Specifies how a port is selected for health checking. Can be one of the following values: USE_FIXED_PORT: Specifies a port number explicitly using the port field in the health check. Supported by backend services for passthrough load balancers and backend services for proxy load balancers. Also supported in legacy HTTP health checks for target pools. The health check supports all backends supported by the backend service provided the backend can be health checked. For example, GCE_VM_IP network endpoint groups, GCE_VM_IP_PORT network endpoint groups, and instance group backends. USE_NAMED_PORT: Not supported. USE_SERVING_PORT: Provides an indirect method of specifying the health check port by referring to the backend service. Only supported by backend services for proxy load balancers. Not supported by target pools. Not supported by backend services for pass-through load balancers. Supports all backends that can be health checked; for example, GCE_VM_IP_PORT network endpoint groups and instance group backends. For GCE_VM_IP_PORT network endpoint group backends, the health check uses the port number specified for each endpoint in the network endpoint group. For instance group backends, the health check uses the port number determined by looking up the backend service's named port in the instance group's list of named ports. + * Specifies how a port is selected for health checking. Can be one of the + * following values: + * USE_FIXED_PORT: Specifies a port number explicitly using theport field in the health check. Supported by backend services + * for passthrough load balancers and backend services for proxy load + * balancers. Also supported in legacy HTTP health checks for target pools. + * The health check supports all backends supported by the backend service + * provided the backend can be health checked. For example,GCE_VM_IP network endpoint groups, GCE_VM_IP_PORT + * network endpoint groups, and instance group backends. + * USE_NAMED_PORT: Not supported. + * USE_SERVING_PORT: Provides an indirect method of specifying + * the health check port by referring to the backend service. Only supported + * by backend services for proxy load balancers. Not supported by target + * pools. Not supported by backend services for pass-through load balancers. + * Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group + * backends. + * For GCE_VM_IP_PORT network endpoint group backends, the health + * check uses the port number specified for each endpoint in the network + * endpoint group. For instance group backends, the health check uses the + * port number determined by looking up the backend service's named port in + * the instance group's list of named ports. * * Protobuf type google.cloud.compute.v1.HTTPHealthCheck.PortSpecification */ @@ -20,7 +39,8 @@ class PortSpecification */ const UNDEFINED_PORT_SPECIFICATION = 0; /** - * The port number in the health check's port is used for health checking. Applies to network endpoint group and instance group backends. + * The port number in the health check's port is used for health + * checking. Applies to network endpoint group and instance group backends. * * Generated from protobuf enum USE_FIXED_PORT = 190235748; */ @@ -32,7 +52,10 @@ class PortSpecification */ const USE_NAMED_PORT = 349300671; /** - * For network endpoint group backends, the health check uses the port number specified on each endpoint in the network endpoint group. For instance group backends, the health check uses the port number specified for the backend service's named port defined in the instance group's named ports. + * For network endpoint group backends, the health check uses the port number + * specified on each endpoint in the network endpoint group. For instance + * group backends, the health check uses the port number specified for the + * backend service's named port defined in the instance group's named ports. * * Generated from protobuf enum USE_SERVING_PORT = 362637516; */ diff --git a/Compute/src/V1/HTTPHealthCheck/ProxyHeader.php b/Compute/src/V1/HTTPHealthCheck/ProxyHeader.php index a941f3f9f08a..42784bc5cdfe 100644 --- a/Compute/src/V1/HTTPHealthCheck/ProxyHeader.php +++ b/Compute/src/V1/HTTPHealthCheck/ProxyHeader.php @@ -7,7 +7,9 @@ use UnexpectedValueException; /** - * Specifies the type of proxy header to append before sending data to the backend, either NONE or PROXY_V1. The default is NONE. + * Specifies the type of proxy header to append before sending data to the + * backend, either NONE or PROXY_V1. The default + * is NONE. * * Protobuf type google.cloud.compute.v1.HTTPHealthCheck.ProxyHeader */ diff --git a/Compute/src/V1/HTTPSHealthCheck.php b/Compute/src/V1/HTTPSHealthCheck.php index 6cc30b173595..46959fa59a88 100644 --- a/Compute/src/V1/HTTPSHealthCheck.php +++ b/Compute/src/V1/HTTPSHealthCheck.php @@ -15,13 +15,18 @@ class HTTPSHealthCheck extends \Google\Protobuf\Internal\Message { /** - * The value of the host header in the HTTPS health check request. If left empty (default value), the host header is set to the destination IP address to which health check packets are sent. The destination IP address depends on the type of load balancer. For details, see: https://cloud.google.com/load-balancing/docs/health-check-concepts#hc-packet-dest + * The value of the host header in the HTTPS health check request. If left + * empty (default value), the host header is set to the destination IP address + * to which health check packets are sent. The destination IP address depends + * on the type of load balancer. For details, see: + * https://cloud.google.com/load-balancing/docs/health-check-concepts#hc-packet-dest * * Generated from protobuf field optional string host = 3208616; */ protected $host = null; /** - * The TCP port number to which the health check prober sends packets. The default value is 443. Valid values are 1 through 65535. + * The TCP port number to which the health check prober sends packets. The + * default value is 443. Valid values are 1 through65535. * * Generated from protobuf field optional int32 port = 3446913; */ @@ -33,27 +38,53 @@ class HTTPSHealthCheck extends \Google\Protobuf\Internal\Message */ protected $port_name = null; /** - * Specifies how a port is selected for health checking. Can be one of the following values: USE_FIXED_PORT: Specifies a port number explicitly using the port field in the health check. Supported by backend services for passthrough load balancers and backend services for proxy load balancers. Not supported by target pools. The health check supports all backends supported by the backend service provided the backend can be health checked. For example, GCE_VM_IP network endpoint groups, GCE_VM_IP_PORT network endpoint groups, and instance group backends. USE_NAMED_PORT: Not supported. USE_SERVING_PORT: Provides an indirect method of specifying the health check port by referring to the backend service. Only supported by backend services for proxy load balancers. Not supported by target pools. Not supported by backend services for passthrough load balancers. Supports all backends that can be health checked; for example, GCE_VM_IP_PORT network endpoint groups and instance group backends. For GCE_VM_IP_PORT network endpoint group backends, the health check uses the port number specified for each endpoint in the network endpoint group. For instance group backends, the health check uses the port number determined by looking up the backend service's named port in the instance group's list of named ports. + * Specifies how a port is selected for health checking. Can be one of the + * following values: + * USE_FIXED_PORT: Specifies a port number explicitly using theport field in the health check. Supported by backend services + * for passthrough load balancers and backend services for proxy load + * balancers. Not supported by target pools. The health check supports all + * backends supported by the backend service provided the backend can be + * health checked. For example, GCE_VM_IP network endpoint + * groups, GCE_VM_IP_PORT network endpoint groups, and instance + * group backends. + * USE_NAMED_PORT: Not supported. + * USE_SERVING_PORT: Provides an indirect method of specifying + * the health check port by referring to the backend service. Only supported + * by backend services for proxy load balancers. Not supported by target + * pools. Not supported by backend services for passthrough load balancers. + * Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group + * backends. + * For GCE_VM_IP_PORT network endpoint group backends, the health + * check uses the port number specified for each endpoint in the network + * endpoint group. For instance group backends, the health check uses the + * port number determined by looking up the backend service's named port in + * the instance group's list of named ports. * Check the PortSpecification enum for the list of possible values. * * Generated from protobuf field optional string port_specification = 51590597; */ protected $port_specification = null; /** - * Specifies the type of proxy header to append before sending data to the backend, either NONE or PROXY_V1. The default is NONE. + * Specifies the type of proxy header to append before sending data to the + * backend, either NONE or PROXY_V1. The default + * is NONE. * Check the ProxyHeader enum for the list of possible values. * * Generated from protobuf field optional string proxy_header = 160374142; */ protected $proxy_header = null; /** - * The request path of the HTTPS health check request. The default value is /. Must comply with RFC3986. + * The request path of the HTTPS health check request. The default value is/. Must comply withRFC3986. * * Generated from protobuf field optional string request_path = 229403605; */ protected $request_path = null; /** - * Creates a content-based HTTPS health check. In addition to the required HTTP 200 (OK) status code, you can configure the health check to pass only when the backend sends this specific ASCII response string within the first 1024 bytes of the HTTP response body. For details, see: https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-http + * Creates a content-based HTTPS health check. In addition to the required + * HTTP 200 (OK) status code, you can configure the health check to pass only + * when the backend sends this specific ASCII response string within the first + * 1024 bytes of the HTTP response body. For details, see: + * https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-http * * Generated from protobuf field optional string response = 196547649; */ @@ -66,21 +97,52 @@ class HTTPSHealthCheck extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $host - * The value of the host header in the HTTPS health check request. If left empty (default value), the host header is set to the destination IP address to which health check packets are sent. The destination IP address depends on the type of load balancer. For details, see: https://cloud.google.com/load-balancing/docs/health-check-concepts#hc-packet-dest + * The value of the host header in the HTTPS health check request. If left + * empty (default value), the host header is set to the destination IP address + * to which health check packets are sent. The destination IP address depends + * on the type of load balancer. For details, see: + * https://cloud.google.com/load-balancing/docs/health-check-concepts#hc-packet-dest * @type int $port - * The TCP port number to which the health check prober sends packets. The default value is 443. Valid values are 1 through 65535. + * The TCP port number to which the health check prober sends packets. The + * default value is 443. Valid values are 1 through65535. * @type string $port_name * Not supported. * @type string $port_specification - * Specifies how a port is selected for health checking. Can be one of the following values: USE_FIXED_PORT: Specifies a port number explicitly using the port field in the health check. Supported by backend services for passthrough load balancers and backend services for proxy load balancers. Not supported by target pools. The health check supports all backends supported by the backend service provided the backend can be health checked. For example, GCE_VM_IP network endpoint groups, GCE_VM_IP_PORT network endpoint groups, and instance group backends. USE_NAMED_PORT: Not supported. USE_SERVING_PORT: Provides an indirect method of specifying the health check port by referring to the backend service. Only supported by backend services for proxy load balancers. Not supported by target pools. Not supported by backend services for passthrough load balancers. Supports all backends that can be health checked; for example, GCE_VM_IP_PORT network endpoint groups and instance group backends. For GCE_VM_IP_PORT network endpoint group backends, the health check uses the port number specified for each endpoint in the network endpoint group. For instance group backends, the health check uses the port number determined by looking up the backend service's named port in the instance group's list of named ports. + * Specifies how a port is selected for health checking. Can be one of the + * following values: + * USE_FIXED_PORT: Specifies a port number explicitly using theport field in the health check. Supported by backend services + * for passthrough load balancers and backend services for proxy load + * balancers. Not supported by target pools. The health check supports all + * backends supported by the backend service provided the backend can be + * health checked. For example, GCE_VM_IP network endpoint + * groups, GCE_VM_IP_PORT network endpoint groups, and instance + * group backends. + * USE_NAMED_PORT: Not supported. + * USE_SERVING_PORT: Provides an indirect method of specifying + * the health check port by referring to the backend service. Only supported + * by backend services for proxy load balancers. Not supported by target + * pools. Not supported by backend services for passthrough load balancers. + * Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group + * backends. + * For GCE_VM_IP_PORT network endpoint group backends, the health + * check uses the port number specified for each endpoint in the network + * endpoint group. For instance group backends, the health check uses the + * port number determined by looking up the backend service's named port in + * the instance group's list of named ports. * Check the PortSpecification enum for the list of possible values. * @type string $proxy_header - * Specifies the type of proxy header to append before sending data to the backend, either NONE or PROXY_V1. The default is NONE. + * Specifies the type of proxy header to append before sending data to the + * backend, either NONE or PROXY_V1. The default + * is NONE. * Check the ProxyHeader enum for the list of possible values. * @type string $request_path - * The request path of the HTTPS health check request. The default value is /. Must comply with RFC3986. + * The request path of the HTTPS health check request. The default value is/. Must comply withRFC3986. * @type string $response - * Creates a content-based HTTPS health check. In addition to the required HTTP 200 (OK) status code, you can configure the health check to pass only when the backend sends this specific ASCII response string within the first 1024 bytes of the HTTP response body. For details, see: https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-http + * Creates a content-based HTTPS health check. In addition to the required + * HTTP 200 (OK) status code, you can configure the health check to pass only + * when the backend sends this specific ASCII response string within the first + * 1024 bytes of the HTTP response body. For details, see: + * https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-http * } */ public function __construct($data = NULL) { @@ -89,7 +151,11 @@ public function __construct($data = NULL) { } /** - * The value of the host header in the HTTPS health check request. If left empty (default value), the host header is set to the destination IP address to which health check packets are sent. The destination IP address depends on the type of load balancer. For details, see: https://cloud.google.com/load-balancing/docs/health-check-concepts#hc-packet-dest + * The value of the host header in the HTTPS health check request. If left + * empty (default value), the host header is set to the destination IP address + * to which health check packets are sent. The destination IP address depends + * on the type of load balancer. For details, see: + * https://cloud.google.com/load-balancing/docs/health-check-concepts#hc-packet-dest * * Generated from protobuf field optional string host = 3208616; * @return string @@ -110,7 +176,11 @@ public function clearHost() } /** - * The value of the host header in the HTTPS health check request. If left empty (default value), the host header is set to the destination IP address to which health check packets are sent. The destination IP address depends on the type of load balancer. For details, see: https://cloud.google.com/load-balancing/docs/health-check-concepts#hc-packet-dest + * The value of the host header in the HTTPS health check request. If left + * empty (default value), the host header is set to the destination IP address + * to which health check packets are sent. The destination IP address depends + * on the type of load balancer. For details, see: + * https://cloud.google.com/load-balancing/docs/health-check-concepts#hc-packet-dest * * Generated from protobuf field optional string host = 3208616; * @param string $var @@ -125,7 +195,8 @@ public function setHost($var) } /** - * The TCP port number to which the health check prober sends packets. The default value is 443. Valid values are 1 through 65535. + * The TCP port number to which the health check prober sends packets. The + * default value is 443. Valid values are 1 through65535. * * Generated from protobuf field optional int32 port = 3446913; * @return int @@ -146,7 +217,8 @@ public function clearPort() } /** - * The TCP port number to which the health check prober sends packets. The default value is 443. Valid values are 1 through 65535. + * The TCP port number to which the health check prober sends packets. The + * default value is 443. Valid values are 1 through65535. * * Generated from protobuf field optional int32 port = 3446913; * @param int $var @@ -197,7 +269,27 @@ public function setPortName($var) } /** - * Specifies how a port is selected for health checking. Can be one of the following values: USE_FIXED_PORT: Specifies a port number explicitly using the port field in the health check. Supported by backend services for passthrough load balancers and backend services for proxy load balancers. Not supported by target pools. The health check supports all backends supported by the backend service provided the backend can be health checked. For example, GCE_VM_IP network endpoint groups, GCE_VM_IP_PORT network endpoint groups, and instance group backends. USE_NAMED_PORT: Not supported. USE_SERVING_PORT: Provides an indirect method of specifying the health check port by referring to the backend service. Only supported by backend services for proxy load balancers. Not supported by target pools. Not supported by backend services for passthrough load balancers. Supports all backends that can be health checked; for example, GCE_VM_IP_PORT network endpoint groups and instance group backends. For GCE_VM_IP_PORT network endpoint group backends, the health check uses the port number specified for each endpoint in the network endpoint group. For instance group backends, the health check uses the port number determined by looking up the backend service's named port in the instance group's list of named ports. + * Specifies how a port is selected for health checking. Can be one of the + * following values: + * USE_FIXED_PORT: Specifies a port number explicitly using theport field in the health check. Supported by backend services + * for passthrough load balancers and backend services for proxy load + * balancers. Not supported by target pools. The health check supports all + * backends supported by the backend service provided the backend can be + * health checked. For example, GCE_VM_IP network endpoint + * groups, GCE_VM_IP_PORT network endpoint groups, and instance + * group backends. + * USE_NAMED_PORT: Not supported. + * USE_SERVING_PORT: Provides an indirect method of specifying + * the health check port by referring to the backend service. Only supported + * by backend services for proxy load balancers. Not supported by target + * pools. Not supported by backend services for passthrough load balancers. + * Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group + * backends. + * For GCE_VM_IP_PORT network endpoint group backends, the health + * check uses the port number specified for each endpoint in the network + * endpoint group. For instance group backends, the health check uses the + * port number determined by looking up the backend service's named port in + * the instance group's list of named ports. * Check the PortSpecification enum for the list of possible values. * * Generated from protobuf field optional string port_specification = 51590597; @@ -219,7 +311,27 @@ public function clearPortSpecification() } /** - * Specifies how a port is selected for health checking. Can be one of the following values: USE_FIXED_PORT: Specifies a port number explicitly using the port field in the health check. Supported by backend services for passthrough load balancers and backend services for proxy load balancers. Not supported by target pools. The health check supports all backends supported by the backend service provided the backend can be health checked. For example, GCE_VM_IP network endpoint groups, GCE_VM_IP_PORT network endpoint groups, and instance group backends. USE_NAMED_PORT: Not supported. USE_SERVING_PORT: Provides an indirect method of specifying the health check port by referring to the backend service. Only supported by backend services for proxy load balancers. Not supported by target pools. Not supported by backend services for passthrough load balancers. Supports all backends that can be health checked; for example, GCE_VM_IP_PORT network endpoint groups and instance group backends. For GCE_VM_IP_PORT network endpoint group backends, the health check uses the port number specified for each endpoint in the network endpoint group. For instance group backends, the health check uses the port number determined by looking up the backend service's named port in the instance group's list of named ports. + * Specifies how a port is selected for health checking. Can be one of the + * following values: + * USE_FIXED_PORT: Specifies a port number explicitly using theport field in the health check. Supported by backend services + * for passthrough load balancers and backend services for proxy load + * balancers. Not supported by target pools. The health check supports all + * backends supported by the backend service provided the backend can be + * health checked. For example, GCE_VM_IP network endpoint + * groups, GCE_VM_IP_PORT network endpoint groups, and instance + * group backends. + * USE_NAMED_PORT: Not supported. + * USE_SERVING_PORT: Provides an indirect method of specifying + * the health check port by referring to the backend service. Only supported + * by backend services for proxy load balancers. Not supported by target + * pools. Not supported by backend services for passthrough load balancers. + * Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group + * backends. + * For GCE_VM_IP_PORT network endpoint group backends, the health + * check uses the port number specified for each endpoint in the network + * endpoint group. For instance group backends, the health check uses the + * port number determined by looking up the backend service's named port in + * the instance group's list of named ports. * Check the PortSpecification enum for the list of possible values. * * Generated from protobuf field optional string port_specification = 51590597; @@ -235,7 +347,9 @@ public function setPortSpecification($var) } /** - * Specifies the type of proxy header to append before sending data to the backend, either NONE or PROXY_V1. The default is NONE. + * Specifies the type of proxy header to append before sending data to the + * backend, either NONE or PROXY_V1. The default + * is NONE. * Check the ProxyHeader enum for the list of possible values. * * Generated from protobuf field optional string proxy_header = 160374142; @@ -257,7 +371,9 @@ public function clearProxyHeader() } /** - * Specifies the type of proxy header to append before sending data to the backend, either NONE or PROXY_V1. The default is NONE. + * Specifies the type of proxy header to append before sending data to the + * backend, either NONE or PROXY_V1. The default + * is NONE. * Check the ProxyHeader enum for the list of possible values. * * Generated from protobuf field optional string proxy_header = 160374142; @@ -273,7 +389,7 @@ public function setProxyHeader($var) } /** - * The request path of the HTTPS health check request. The default value is /. Must comply with RFC3986. + * The request path of the HTTPS health check request. The default value is/. Must comply withRFC3986. * * Generated from protobuf field optional string request_path = 229403605; * @return string @@ -294,7 +410,7 @@ public function clearRequestPath() } /** - * The request path of the HTTPS health check request. The default value is /. Must comply with RFC3986. + * The request path of the HTTPS health check request. The default value is/. Must comply withRFC3986. * * Generated from protobuf field optional string request_path = 229403605; * @param string $var @@ -309,7 +425,11 @@ public function setRequestPath($var) } /** - * Creates a content-based HTTPS health check. In addition to the required HTTP 200 (OK) status code, you can configure the health check to pass only when the backend sends this specific ASCII response string within the first 1024 bytes of the HTTP response body. For details, see: https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-http + * Creates a content-based HTTPS health check. In addition to the required + * HTTP 200 (OK) status code, you can configure the health check to pass only + * when the backend sends this specific ASCII response string within the first + * 1024 bytes of the HTTP response body. For details, see: + * https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-http * * Generated from protobuf field optional string response = 196547649; * @return string @@ -330,7 +450,11 @@ public function clearResponse() } /** - * Creates a content-based HTTPS health check. In addition to the required HTTP 200 (OK) status code, you can configure the health check to pass only when the backend sends this specific ASCII response string within the first 1024 bytes of the HTTP response body. For details, see: https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-http + * Creates a content-based HTTPS health check. In addition to the required + * HTTP 200 (OK) status code, you can configure the health check to pass only + * when the backend sends this specific ASCII response string within the first + * 1024 bytes of the HTTP response body. For details, see: + * https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-http * * Generated from protobuf field optional string response = 196547649; * @param string $var diff --git a/Compute/src/V1/HTTPSHealthCheck/PortSpecification.php b/Compute/src/V1/HTTPSHealthCheck/PortSpecification.php index 0bcd8c6bb609..1bda0fd4c76c 100644 --- a/Compute/src/V1/HTTPSHealthCheck/PortSpecification.php +++ b/Compute/src/V1/HTTPSHealthCheck/PortSpecification.php @@ -7,7 +7,27 @@ use UnexpectedValueException; /** - * Specifies how a port is selected for health checking. Can be one of the following values: USE_FIXED_PORT: Specifies a port number explicitly using the port field in the health check. Supported by backend services for passthrough load balancers and backend services for proxy load balancers. Not supported by target pools. The health check supports all backends supported by the backend service provided the backend can be health checked. For example, GCE_VM_IP network endpoint groups, GCE_VM_IP_PORT network endpoint groups, and instance group backends. USE_NAMED_PORT: Not supported. USE_SERVING_PORT: Provides an indirect method of specifying the health check port by referring to the backend service. Only supported by backend services for proxy load balancers. Not supported by target pools. Not supported by backend services for passthrough load balancers. Supports all backends that can be health checked; for example, GCE_VM_IP_PORT network endpoint groups and instance group backends. For GCE_VM_IP_PORT network endpoint group backends, the health check uses the port number specified for each endpoint in the network endpoint group. For instance group backends, the health check uses the port number determined by looking up the backend service's named port in the instance group's list of named ports. + * Specifies how a port is selected for health checking. Can be one of the + * following values: + * USE_FIXED_PORT: Specifies a port number explicitly using theport field in the health check. Supported by backend services + * for passthrough load balancers and backend services for proxy load + * balancers. Not supported by target pools. The health check supports all + * backends supported by the backend service provided the backend can be + * health checked. For example, GCE_VM_IP network endpoint + * groups, GCE_VM_IP_PORT network endpoint groups, and instance + * group backends. + * USE_NAMED_PORT: Not supported. + * USE_SERVING_PORT: Provides an indirect method of specifying + * the health check port by referring to the backend service. Only supported + * by backend services for proxy load balancers. Not supported by target + * pools. Not supported by backend services for passthrough load balancers. + * Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group + * backends. + * For GCE_VM_IP_PORT network endpoint group backends, the health + * check uses the port number specified for each endpoint in the network + * endpoint group. For instance group backends, the health check uses the + * port number determined by looking up the backend service's named port in + * the instance group's list of named ports. * * Protobuf type google.cloud.compute.v1.HTTPSHealthCheck.PortSpecification */ @@ -20,7 +40,8 @@ class PortSpecification */ const UNDEFINED_PORT_SPECIFICATION = 0; /** - * The port number in the health check's port is used for health checking. Applies to network endpoint group and instance group backends. + * The port number in the health check's port is used for health + * checking. Applies to network endpoint group and instance group backends. * * Generated from protobuf enum USE_FIXED_PORT = 190235748; */ @@ -32,7 +53,10 @@ class PortSpecification */ const USE_NAMED_PORT = 349300671; /** - * For network endpoint group backends, the health check uses the port number specified on each endpoint in the network endpoint group. For instance group backends, the health check uses the port number specified for the backend service's named port defined in the instance group's named ports. + * For network endpoint group backends, the health check uses the port number + * specified on each endpoint in the network endpoint group. For instance + * group backends, the health check uses the port number specified for the + * backend service's named port defined in the instance group's named ports. * * Generated from protobuf enum USE_SERVING_PORT = 362637516; */ diff --git a/Compute/src/V1/HTTPSHealthCheck/ProxyHeader.php b/Compute/src/V1/HTTPSHealthCheck/ProxyHeader.php index a56898e190d9..3a21f8d39b44 100644 --- a/Compute/src/V1/HTTPSHealthCheck/ProxyHeader.php +++ b/Compute/src/V1/HTTPSHealthCheck/ProxyHeader.php @@ -7,7 +7,9 @@ use UnexpectedValueException; /** - * Specifies the type of proxy header to append before sending data to the backend, either NONE or PROXY_V1. The default is NONE. + * Specifies the type of proxy header to append before sending data to the + * backend, either NONE or PROXY_V1. The default + * is NONE. * * Protobuf type google.cloud.compute.v1.HTTPSHealthCheck.ProxyHeader */ diff --git a/Compute/src/V1/HealthCheck.php b/Compute/src/V1/HealthCheck.php index dfb4815d27f6..3ac770093e64 100644 --- a/Compute/src/V1/HealthCheck.php +++ b/Compute/src/V1/HealthCheck.php @@ -9,26 +9,46 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Represents a health check resource. Google Compute Engine has two health check resources: * [Regional](/compute/docs/reference/rest/v1/regionHealthChecks) * [Global](/compute/docs/reference/rest/v1/healthChecks) These health check resources can be used for load balancing and for autohealing VMs in a managed instance group (MIG). **Load balancing** Health check requirements vary depending on the type of load balancer. For details about the type of health check supported for each load balancer and corresponding backend type, see Health checks overview: Load balancer guide. **Autohealing in MIGs** The health checks that you use for autohealing VMs in a MIG can be either regional or global. For more information, see Set up an application health check and autohealing. For more information, see Health checks overview. + * Represents a health check resource. + * Google Compute Engine has two health check resources: + * * [Regional](/compute/docs/reference/rest/v1/regionHealthChecks) + * * [Global](/compute/docs/reference/rest/v1/healthChecks) + * These health check resources can be used for load balancing and for + * autohealing VMs in a managed instance group (MIG). + * **Load balancing** + * Health check requirements vary depending on the type of load balancer. For + * details about the type of health check supported for + * each load balancer and corresponding backend type, + * see Health + * checks overview: Load balancer guide. + * **Autohealing in MIGs** + * The health checks that you use for autohealing VMs in a MIG can be either + * regional or global. For more information, see Set up an + * application health check and autohealing. + * For more information, seeHealth checks + * overview. * * Generated from protobuf message google.cloud.compute.v1.HealthCheck */ class HealthCheck extends \Google\Protobuf\Internal\Message { /** - * How often (in seconds) to send a health check. The default value is 5 seconds. + * How often (in seconds) to send a health check. The default value is 5 + * seconds. * * Generated from protobuf field optional int32 check_interval_sec = 345561006; */ protected $check_interval_sec = null; /** - * [Output Only] Creation timestamp in 3339 text format. + * [Output Only] Creation timestamp in3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; */ protected $creation_timestamp = null; /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; */ @@ -38,7 +58,12 @@ class HealthCheck extends \Google\Protobuf\Internal\Message */ protected $grpc_health_check = null; /** - * A so-far unhealthy instance will be marked healthy after this many consecutive successes. The default value is 2. + * Generated from protobuf field optional .google.cloud.compute.v1.GRPCTLSHealthCheck grpc_tls_health_check = 267273258; + */ + protected $grpc_tls_health_check = null; + /** + * A so-far unhealthy instance will be marked healthy after this + * many consecutive successes. The default value is 2. * * Generated from protobuf field optional int32 healthy_threshold = 403212361; */ @@ -56,7 +81,8 @@ class HealthCheck extends \Google\Protobuf\Internal\Message */ protected $https_health_check = null; /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; */ @@ -74,13 +100,20 @@ class HealthCheck extends \Google\Protobuf\Internal\Message */ protected $log_config = null; /** - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. For example, a name that is 1-63 characters long, matches the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?`, and otherwise complies with RFC1035. This regular expression describes a name where the first character is a lowercase letter, and all following characters are a dash, lowercase letter, or digit, except the last character, which isn't a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * For example, a name that is 1-63 characters long, matches the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?`, and otherwise complies with + * RFC1035. This regular expression describes a name where the first + * character is a lowercase letter, and all following characters are a dash, + * lowercase letter, or digit, except the last character, which isn't a dash. * * Generated from protobuf field optional string name = 3373707; */ protected $name = null; /** - * [Output Only] Region where the health check resides. Not applicable to global health checks. + * [Output Only] Region where the health check resides. Not applicable to + * global health checks. * * Generated from protobuf field optional string region = 138946292; */ @@ -92,7 +125,20 @@ class HealthCheck extends \Google\Protobuf\Internal\Message */ protected $self_link = null; /** - * The list of cloud regions from which health checks are performed. If any regions are specified, then exactly 3 regions should be specified. The region names must be valid names of Google Cloud regions. This can only be set for global health check. If this list is non-empty, then there are restrictions on what other health check fields are supported and what other resources can use this health check: - SSL, HTTP2, and GRPC protocols are not supported. - The TCP request field is not supported. - The proxyHeader field for HTTP, HTTPS, and TCP is not supported. - The checkIntervalSec field must be at least 30. - The health check cannot be used with BackendService nor with managed instance group auto-healing. + * The list of cloud regions from which health checks are performed. If any + * regions are specified, then exactly 3 regions should be specified. The + * region names must be valid names of Google Cloud regions. + * This can only be set for global health check. + * If this list is non-empty, then there are restrictions + * on what other health check fields are supported and what other resources + * can use this health check: + * - SSL, HTTP2, and GRPC protocols are not supported. + * - The TCP request field is not supported. + * - The proxyHeader field for HTTP, HTTPS, and TCP is not + * supported. + * - The checkIntervalSec field must be at least 30. + * - The health check cannot be used with BackendService nor with managed + * instance group auto-healing. * * Generated from protobuf field repeated string source_regions = 405568475; */ @@ -106,20 +152,24 @@ class HealthCheck extends \Google\Protobuf\Internal\Message */ protected $tcp_health_check = null; /** - * How long (in seconds) to wait before claiming failure. The default value is 5 seconds. It is invalid for timeoutSec to have greater value than checkIntervalSec. + * How long (in seconds) to wait before claiming failure. The default value is + * 5 seconds. It is invalid for timeoutSec to have greater + * value than checkIntervalSec. * * Generated from protobuf field optional int32 timeout_sec = 79994995; */ protected $timeout_sec = null; /** - * Specifies the type of the healthCheck, either TCP, SSL, HTTP, HTTPS, HTTP2 or GRPC. Exactly one of the protocol-specific health check fields must be specified, which must match type field. + * Specifies the type of the healthCheck, either TCP,SSL, HTTP, HTTPS,HTTP2 or GRPC. Exactly one of the + * protocol-specific health check fields must be specified, which must matchtype field. * Check the Type enum for the list of possible values. * * Generated from protobuf field optional string type = 3575610; */ protected $type = null; /** - * A so-far healthy instance will be marked unhealthy after this many consecutive failures. The default value is 2. + * A so-far healthy instance will be marked unhealthy after this many + * consecutive failures. The default value is 2. * * Generated from protobuf field optional int32 unhealthy_threshold = 227958480; */ @@ -132,40 +182,70 @@ class HealthCheck extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type int $check_interval_sec - * How often (in seconds) to send a health check. The default value is 5 seconds. + * How often (in seconds) to send a health check. The default value is 5 + * seconds. * @type string $creation_timestamp - * [Output Only] Creation timestamp in 3339 text format. + * [Output Only] Creation timestamp in3339 + * text format. * @type string $description - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * @type \Google\Cloud\Compute\V1\GRPCHealthCheck $grpc_health_check + * @type \Google\Cloud\Compute\V1\GRPCTLSHealthCheck $grpc_tls_health_check * @type int $healthy_threshold - * A so-far unhealthy instance will be marked healthy after this many consecutive successes. The default value is 2. + * A so-far unhealthy instance will be marked healthy after this + * many consecutive successes. The default value is 2. * @type \Google\Cloud\Compute\V1\HTTP2HealthCheck $http2_health_check * @type \Google\Cloud\Compute\V1\HTTPHealthCheck $http_health_check * @type \Google\Cloud\Compute\V1\HTTPSHealthCheck $https_health_check * @type int|string $id - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * @type string $kind * Type of the resource. * @type \Google\Cloud\Compute\V1\HealthCheckLogConfig $log_config * Configure logging on this health check. * @type string $name - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. For example, a name that is 1-63 characters long, matches the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?`, and otherwise complies with RFC1035. This regular expression describes a name where the first character is a lowercase letter, and all following characters are a dash, lowercase letter, or digit, except the last character, which isn't a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * For example, a name that is 1-63 characters long, matches the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?`, and otherwise complies with + * RFC1035. This regular expression describes a name where the first + * character is a lowercase letter, and all following characters are a dash, + * lowercase letter, or digit, except the last character, which isn't a dash. * @type string $region - * [Output Only] Region where the health check resides. Not applicable to global health checks. + * [Output Only] Region where the health check resides. Not applicable to + * global health checks. * @type string $self_link * [Output Only] Server-defined URL for the resource. * @type array|\Google\Protobuf\Internal\RepeatedField $source_regions - * The list of cloud regions from which health checks are performed. If any regions are specified, then exactly 3 regions should be specified. The region names must be valid names of Google Cloud regions. This can only be set for global health check. If this list is non-empty, then there are restrictions on what other health check fields are supported and what other resources can use this health check: - SSL, HTTP2, and GRPC protocols are not supported. - The TCP request field is not supported. - The proxyHeader field for HTTP, HTTPS, and TCP is not supported. - The checkIntervalSec field must be at least 30. - The health check cannot be used with BackendService nor with managed instance group auto-healing. + * The list of cloud regions from which health checks are performed. If any + * regions are specified, then exactly 3 regions should be specified. The + * region names must be valid names of Google Cloud regions. + * This can only be set for global health check. + * If this list is non-empty, then there are restrictions + * on what other health check fields are supported and what other resources + * can use this health check: + * - SSL, HTTP2, and GRPC protocols are not supported. + * - The TCP request field is not supported. + * - The proxyHeader field for HTTP, HTTPS, and TCP is not + * supported. + * - The checkIntervalSec field must be at least 30. + * - The health check cannot be used with BackendService nor with managed + * instance group auto-healing. * @type \Google\Cloud\Compute\V1\SSLHealthCheck $ssl_health_check * @type \Google\Cloud\Compute\V1\TCPHealthCheck $tcp_health_check * @type int $timeout_sec - * How long (in seconds) to wait before claiming failure. The default value is 5 seconds. It is invalid for timeoutSec to have greater value than checkIntervalSec. + * How long (in seconds) to wait before claiming failure. The default value is + * 5 seconds. It is invalid for timeoutSec to have greater + * value than checkIntervalSec. * @type string $type - * Specifies the type of the healthCheck, either TCP, SSL, HTTP, HTTPS, HTTP2 or GRPC. Exactly one of the protocol-specific health check fields must be specified, which must match type field. + * Specifies the type of the healthCheck, either TCP,SSL, HTTP, HTTPS,HTTP2 or GRPC. Exactly one of the + * protocol-specific health check fields must be specified, which must matchtype field. * Check the Type enum for the list of possible values. * @type int $unhealthy_threshold - * A so-far healthy instance will be marked unhealthy after this many consecutive failures. The default value is 2. + * A so-far healthy instance will be marked unhealthy after this many + * consecutive failures. The default value is 2. * } */ public function __construct($data = NULL) { @@ -174,7 +254,8 @@ public function __construct($data = NULL) { } /** - * How often (in seconds) to send a health check. The default value is 5 seconds. + * How often (in seconds) to send a health check. The default value is 5 + * seconds. * * Generated from protobuf field optional int32 check_interval_sec = 345561006; * @return int @@ -195,7 +276,8 @@ public function clearCheckIntervalSec() } /** - * How often (in seconds) to send a health check. The default value is 5 seconds. + * How often (in seconds) to send a health check. The default value is 5 + * seconds. * * Generated from protobuf field optional int32 check_interval_sec = 345561006; * @param int $var @@ -210,7 +292,8 @@ public function setCheckIntervalSec($var) } /** - * [Output Only] Creation timestamp in 3339 text format. + * [Output Only] Creation timestamp in3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @return string @@ -231,7 +314,8 @@ public function clearCreationTimestamp() } /** - * [Output Only] Creation timestamp in 3339 text format. + * [Output Only] Creation timestamp in3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @param string $var @@ -246,7 +330,8 @@ public function setCreationTimestamp($var) } /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @return string @@ -267,7 +352,8 @@ public function clearDescription() } /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @param string $var @@ -314,7 +400,40 @@ public function setGrpcHealthCheck($var) } /** - * A so-far unhealthy instance will be marked healthy after this many consecutive successes. The default value is 2. + * Generated from protobuf field optional .google.cloud.compute.v1.GRPCTLSHealthCheck grpc_tls_health_check = 267273258; + * @return \Google\Cloud\Compute\V1\GRPCTLSHealthCheck|null + */ + public function getGrpcTlsHealthCheck() + { + return $this->grpc_tls_health_check; + } + + public function hasGrpcTlsHealthCheck() + { + return isset($this->grpc_tls_health_check); + } + + public function clearGrpcTlsHealthCheck() + { + unset($this->grpc_tls_health_check); + } + + /** + * Generated from protobuf field optional .google.cloud.compute.v1.GRPCTLSHealthCheck grpc_tls_health_check = 267273258; + * @param \Google\Cloud\Compute\V1\GRPCTLSHealthCheck $var + * @return $this + */ + public function setGrpcTlsHealthCheck($var) + { + GPBUtil::checkMessage($var, \Google\Cloud\Compute\V1\GRPCTLSHealthCheck::class); + $this->grpc_tls_health_check = $var; + + return $this; + } + + /** + * A so-far unhealthy instance will be marked healthy after this + * many consecutive successes. The default value is 2. * * Generated from protobuf field optional int32 healthy_threshold = 403212361; * @return int @@ -335,7 +454,8 @@ public function clearHealthyThreshold() } /** - * A so-far unhealthy instance will be marked healthy after this many consecutive successes. The default value is 2. + * A so-far unhealthy instance will be marked healthy after this + * many consecutive successes. The default value is 2. * * Generated from protobuf field optional int32 healthy_threshold = 403212361; * @param int $var @@ -446,7 +566,8 @@ public function setHttpsHealthCheck($var) } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @return int|string @@ -467,7 +588,8 @@ public function clearId() } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @param int|string $var @@ -554,7 +676,13 @@ public function setLogConfig($var) } /** - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. For example, a name that is 1-63 characters long, matches the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?`, and otherwise complies with RFC1035. This regular expression describes a name where the first character is a lowercase letter, and all following characters are a dash, lowercase letter, or digit, except the last character, which isn't a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * For example, a name that is 1-63 characters long, matches the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?`, and otherwise complies with + * RFC1035. This regular expression describes a name where the first + * character is a lowercase letter, and all following characters are a dash, + * lowercase letter, or digit, except the last character, which isn't a dash. * * Generated from protobuf field optional string name = 3373707; * @return string @@ -575,7 +703,13 @@ public function clearName() } /** - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. For example, a name that is 1-63 characters long, matches the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?`, and otherwise complies with RFC1035. This regular expression describes a name where the first character is a lowercase letter, and all following characters are a dash, lowercase letter, or digit, except the last character, which isn't a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * For example, a name that is 1-63 characters long, matches the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?`, and otherwise complies with + * RFC1035. This regular expression describes a name where the first + * character is a lowercase letter, and all following characters are a dash, + * lowercase letter, or digit, except the last character, which isn't a dash. * * Generated from protobuf field optional string name = 3373707; * @param string $var @@ -590,7 +724,8 @@ public function setName($var) } /** - * [Output Only] Region where the health check resides. Not applicable to global health checks. + * [Output Only] Region where the health check resides. Not applicable to + * global health checks. * * Generated from protobuf field optional string region = 138946292; * @return string @@ -611,7 +746,8 @@ public function clearRegion() } /** - * [Output Only] Region where the health check resides. Not applicable to global health checks. + * [Output Only] Region where the health check resides. Not applicable to + * global health checks. * * Generated from protobuf field optional string region = 138946292; * @param string $var @@ -662,7 +798,20 @@ public function setSelfLink($var) } /** - * The list of cloud regions from which health checks are performed. If any regions are specified, then exactly 3 regions should be specified. The region names must be valid names of Google Cloud regions. This can only be set for global health check. If this list is non-empty, then there are restrictions on what other health check fields are supported and what other resources can use this health check: - SSL, HTTP2, and GRPC protocols are not supported. - The TCP request field is not supported. - The proxyHeader field for HTTP, HTTPS, and TCP is not supported. - The checkIntervalSec field must be at least 30. - The health check cannot be used with BackendService nor with managed instance group auto-healing. + * The list of cloud regions from which health checks are performed. If any + * regions are specified, then exactly 3 regions should be specified. The + * region names must be valid names of Google Cloud regions. + * This can only be set for global health check. + * If this list is non-empty, then there are restrictions + * on what other health check fields are supported and what other resources + * can use this health check: + * - SSL, HTTP2, and GRPC protocols are not supported. + * - The TCP request field is not supported. + * - The proxyHeader field for HTTP, HTTPS, and TCP is not + * supported. + * - The checkIntervalSec field must be at least 30. + * - The health check cannot be used with BackendService nor with managed + * instance group auto-healing. * * Generated from protobuf field repeated string source_regions = 405568475; * @return \Google\Protobuf\Internal\RepeatedField @@ -673,7 +822,20 @@ public function getSourceRegions() } /** - * The list of cloud regions from which health checks are performed. If any regions are specified, then exactly 3 regions should be specified. The region names must be valid names of Google Cloud regions. This can only be set for global health check. If this list is non-empty, then there are restrictions on what other health check fields are supported and what other resources can use this health check: - SSL, HTTP2, and GRPC protocols are not supported. - The TCP request field is not supported. - The proxyHeader field for HTTP, HTTPS, and TCP is not supported. - The checkIntervalSec field must be at least 30. - The health check cannot be used with BackendService nor with managed instance group auto-healing. + * The list of cloud regions from which health checks are performed. If any + * regions are specified, then exactly 3 regions should be specified. The + * region names must be valid names of Google Cloud regions. + * This can only be set for global health check. + * If this list is non-empty, then there are restrictions + * on what other health check fields are supported and what other resources + * can use this health check: + * - SSL, HTTP2, and GRPC protocols are not supported. + * - The TCP request field is not supported. + * - The proxyHeader field for HTTP, HTTPS, and TCP is not + * supported. + * - The checkIntervalSec field must be at least 30. + * - The health check cannot be used with BackendService nor with managed + * instance group auto-healing. * * Generated from protobuf field repeated string source_regions = 405568475; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -752,7 +914,9 @@ public function setTcpHealthCheck($var) } /** - * How long (in seconds) to wait before claiming failure. The default value is 5 seconds. It is invalid for timeoutSec to have greater value than checkIntervalSec. + * How long (in seconds) to wait before claiming failure. The default value is + * 5 seconds. It is invalid for timeoutSec to have greater + * value than checkIntervalSec. * * Generated from protobuf field optional int32 timeout_sec = 79994995; * @return int @@ -773,7 +937,9 @@ public function clearTimeoutSec() } /** - * How long (in seconds) to wait before claiming failure. The default value is 5 seconds. It is invalid for timeoutSec to have greater value than checkIntervalSec. + * How long (in seconds) to wait before claiming failure. The default value is + * 5 seconds. It is invalid for timeoutSec to have greater + * value than checkIntervalSec. * * Generated from protobuf field optional int32 timeout_sec = 79994995; * @param int $var @@ -788,7 +954,8 @@ public function setTimeoutSec($var) } /** - * Specifies the type of the healthCheck, either TCP, SSL, HTTP, HTTPS, HTTP2 or GRPC. Exactly one of the protocol-specific health check fields must be specified, which must match type field. + * Specifies the type of the healthCheck, either TCP,SSL, HTTP, HTTPS,HTTP2 or GRPC. Exactly one of the + * protocol-specific health check fields must be specified, which must matchtype field. * Check the Type enum for the list of possible values. * * Generated from protobuf field optional string type = 3575610; @@ -810,7 +977,8 @@ public function clearType() } /** - * Specifies the type of the healthCheck, either TCP, SSL, HTTP, HTTPS, HTTP2 or GRPC. Exactly one of the protocol-specific health check fields must be specified, which must match type field. + * Specifies the type of the healthCheck, either TCP,SSL, HTTP, HTTPS,HTTP2 or GRPC. Exactly one of the + * protocol-specific health check fields must be specified, which must matchtype field. * Check the Type enum for the list of possible values. * * Generated from protobuf field optional string type = 3575610; @@ -826,7 +994,8 @@ public function setType($var) } /** - * A so-far healthy instance will be marked unhealthy after this many consecutive failures. The default value is 2. + * A so-far healthy instance will be marked unhealthy after this many + * consecutive failures. The default value is 2. * * Generated from protobuf field optional int32 unhealthy_threshold = 227958480; * @return int @@ -847,7 +1016,8 @@ public function clearUnhealthyThreshold() } /** - * A so-far healthy instance will be marked unhealthy after this many consecutive failures. The default value is 2. + * A so-far healthy instance will be marked unhealthy after this many + * consecutive failures. The default value is 2. * * Generated from protobuf field optional int32 unhealthy_threshold = 227958480; * @param int $var diff --git a/Compute/src/V1/HealthCheck/Type.php b/Compute/src/V1/HealthCheck/Type.php index d1a36ad49103..0b9d32b2340e 100644 --- a/Compute/src/V1/HealthCheck/Type.php +++ b/Compute/src/V1/HealthCheck/Type.php @@ -7,7 +7,8 @@ use UnexpectedValueException; /** - * Specifies the type of the healthCheck, either TCP, SSL, HTTP, HTTPS, HTTP2 or GRPC. Exactly one of the protocol-specific health check fields must be specified, which must match type field. + * Specifies the type of the healthCheck, either TCP,SSL, HTTP, HTTPS,HTTP2 or GRPC. Exactly one of the + * protocol-specific health check fields must be specified, which must matchtype field. * * Protobuf type google.cloud.compute.v1.HealthCheck.Type */ @@ -23,6 +24,10 @@ class Type * Generated from protobuf enum GRPC = 2196510; */ const GRPC = 2196510; + /** + * Generated from protobuf enum GRPC_WITH_TLS = 268089571; + */ + const GRPC_WITH_TLS = 268089571; /** * Generated from protobuf enum HTTP = 2228360; */ @@ -51,6 +56,7 @@ class Type private static $valueToName = [ self::UNDEFINED_TYPE => 'UNDEFINED_TYPE', self::GRPC => 'GRPC', + self::GRPC_WITH_TLS => 'GRPC_WITH_TLS', self::HTTP => 'HTTP', self::HTTP2 => 'HTTP2', self::HTTPS => 'HTTPS', diff --git a/Compute/src/V1/HealthCheckList.php b/Compute/src/V1/HealthCheckList.php index d15ed900504b..87c83eadcdb8 100644 --- a/Compute/src/V1/HealthCheckList.php +++ b/Compute/src/V1/HealthCheckList.php @@ -34,7 +34,11 @@ class HealthCheckList extends \Google\Protobuf\Internal\Message */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -65,7 +69,11 @@ class HealthCheckList extends \Google\Protobuf\Internal\Message * @type string $kind * Type of resource. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type \Google\Cloud\Compute\V1\Warning $warning @@ -176,7 +184,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -197,7 +209,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/HealthCheckLogConfig.php b/Compute/src/V1/HealthCheckLogConfig.php index c41cac0345a3..216d24648a71 100644 --- a/Compute/src/V1/HealthCheckLogConfig.php +++ b/Compute/src/V1/HealthCheckLogConfig.php @@ -9,14 +9,16 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Configuration of logging on a health check. If logging is enabled, logs will be exported to Stackdriver. + * Configuration of logging on a health check. If logging is enabled, logs + * will be exported to Stackdriver. * * Generated from protobuf message google.cloud.compute.v1.HealthCheckLogConfig */ class HealthCheckLogConfig extends \Google\Protobuf\Internal\Message { /** - * Indicates whether or not to export logs. This is false by default, which means no health check logging will be done. + * Indicates whether or not to export logs. This is false by default, which + * means no health check logging will be done. * * Generated from protobuf field optional bool enable = 311764355; */ @@ -29,7 +31,8 @@ class HealthCheckLogConfig extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type bool $enable - * Indicates whether or not to export logs. This is false by default, which means no health check logging will be done. + * Indicates whether or not to export logs. This is false by default, which + * means no health check logging will be done. * } */ public function __construct($data = NULL) { @@ -38,7 +41,8 @@ public function __construct($data = NULL) { } /** - * Indicates whether or not to export logs. This is false by default, which means no health check logging will be done. + * Indicates whether or not to export logs. This is false by default, which + * means no health check logging will be done. * * Generated from protobuf field optional bool enable = 311764355; * @return bool @@ -59,7 +63,8 @@ public function clearEnable() } /** - * Indicates whether or not to export logs. This is false by default, which means no health check logging will be done. + * Indicates whether or not to export logs. This is false by default, which + * means no health check logging will be done. * * Generated from protobuf field optional bool enable = 311764355; * @param bool $var diff --git a/Compute/src/V1/HealthCheckReference.php b/Compute/src/V1/HealthCheckReference.php index cfe94d47fac6..38bad6462347 100644 --- a/Compute/src/V1/HealthCheckReference.php +++ b/Compute/src/V1/HealthCheckReference.php @@ -9,7 +9,11 @@ use Google\Protobuf\Internal\GPBUtil; /** - * A full or valid partial URL to a health check. For example, the following are valid URLs: - https://www.googleapis.com/compute/beta/projects/project-id/global/httpHealthChecks/health-check - projects/project-id/global/httpHealthChecks/health-check - global/httpHealthChecks/health-check + * A full or valid partial URL to a health check. For example, the following are + * valid URLs: + * - https://www.googleapis.com/compute/beta/projects/project-id/global/httpHealthChecks/health-check + * - projects/project-id/global/httpHealthChecks/health-check + * - global/httpHealthChecks/health-check * * Generated from protobuf message google.cloud.compute.v1.HealthCheckReference */ diff --git a/Compute/src/V1/HealthCheckService.php b/Compute/src/V1/HealthCheckService.php index 79749ee14ec7..c7950fb9a6e2 100644 --- a/Compute/src/V1/HealthCheckService.php +++ b/Compute/src/V1/HealthCheckService.php @@ -16,68 +16,106 @@ class HealthCheckService extends \Google\Protobuf\Internal\Message { /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; */ protected $creation_timestamp = null; /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; */ protected $description = null; /** - * Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking. This field will be ignored when inserting a HealthCheckService. An up-to-date fingerprint must be provided in order to patch/update the HealthCheckService; Otherwise, the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve the HealthCheckService. + * Fingerprint of this resource. A hash of the contents stored in this object. + * This field is used in optimistic locking. This field will be ignored when + * inserting a HealthCheckService. An up-to-date fingerprint must + * be provided in order to patch/update the HealthCheckService; Otherwise, the + * request will fail with error 412 conditionNotMet. To see the + * latest fingerprint, make a get() request to retrieve the + * HealthCheckService. * * Generated from protobuf field optional string fingerprint = 234678500; */ protected $fingerprint = null; /** - * A list of URLs to the HealthCheck resources. Must have at least one HealthCheck, and not more than 10 for regional HealthCheckService, and not more than 1 for global HealthCheckService. HealthCheck resources must have portSpecification=USE_SERVING_PORT or portSpecification=USE_FIXED_PORT. For regional HealthCheckService, the HealthCheck must be regional and in the same region. For global HealthCheckService, HealthCheck must be global. Mix of regional and global HealthChecks is not supported. Multiple regional HealthChecks must belong to the same region. Regional HealthChecks must belong to the same region as zones of NetworkEndpointGroups. For global HealthCheckService using global INTERNET_IP_PORT NetworkEndpointGroups, the global HealthChecks must specify sourceRegions, and HealthChecks that specify sourceRegions can only be used with global INTERNET_IP_PORT NetworkEndpointGroups. + * A list of URLs to the HealthCheck resources. Must have + * at least one HealthCheck, and not more than 10 for regionalHealthCheckService, and not more than 1 for globalHealthCheckService.HealthCheck resources must haveportSpecification=USE_SERVING_PORT orportSpecification=USE_FIXED_PORT. For + * regional HealthCheckService, theHealthCheck must be regional and in the same + * region. For global HealthCheckService,HealthCheck must be global. Mix of regional and globalHealthChecks is not supported. Multiple regionalHealthChecks must belong to the same region. RegionalHealthChecks must belong to the same region as zones ofNetworkEndpointGroups. For globalHealthCheckService using globalINTERNET_IP_PORT NetworkEndpointGroups, the + * global HealthChecks must specify sourceRegions, + * and HealthChecks that specify sourceRegions can + * only be used with global INTERNET_IP_PORTNetworkEndpointGroups. * * Generated from protobuf field repeated string health_checks = 448370606; */ private $health_checks; /** - * Optional. Policy for how the results from multiple health checks for the same endpoint are aggregated. Defaults to NO_AGGREGATION if unspecified. - NO_AGGREGATION. An EndpointHealth message is returned for each pair in the health check service. - AND. If any health check of an endpoint reports UNHEALTHY, then UNHEALTHY is the HealthState of the endpoint. If all health checks report HEALTHY, the HealthState of the endpoint is HEALTHY. . This is only allowed with regional HealthCheckService. + * Optional. Policy for how the results from multiple health checks + * for the same endpoint are aggregated. Defaults to NO_AGGREGATION + * if unspecified. + * - NO_AGGREGATION. An EndpointHealth message is + * returned for each pair in the health check + * service. + * - AND. If any health check of an endpoint reportsUNHEALTHY, then UNHEALTHY is theHealthState of the endpoint. If all health checks reportHEALTHY, the HealthState of the endpoint isHEALTHY. + * . + * This is only allowed with regional HealthCheckService. * Check the HealthStatusAggregationPolicy enum for the list of possible values. * * Generated from protobuf field optional string health_status_aggregation_policy = 253163129; */ protected $health_status_aggregation_policy = null; /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; */ protected $id = null; /** - * [Output only] Type of the resource. Always compute#healthCheckServicefor health check services. + * [Output only] Type of the resource. Alwayscompute#healthCheckServicefor health check services. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * Name of the resource. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. The name must be 1-63 characters long, and comply + * with RFC1035. Specifically, the name must be 1-63 characters + * long and match the regular expression + * `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character + * must be a lowercase letter, and all following characters must be a dash, + * lowercase letter, or digit, except the last character, which cannot be a + * dash. * * Generated from protobuf field optional string name = 3373707; */ protected $name = null; /** - * A list of URLs to the NetworkEndpointGroup resources. Must not have more than 100. For regional HealthCheckService, NEGs must be in zones in the region of the HealthCheckService. For global HealthCheckServices, the NetworkEndpointGroups must be global INTERNET_IP_PORT. + * A list of URLs to the NetworkEndpointGroup + * resources. Must not have more than 100. For regionalHealthCheckService, NEGs must be in + * zones in the region of the HealthCheckService. For globalHealthCheckServices, the NetworkEndpointGroups + * must be global INTERNET_IP_PORT. * * Generated from protobuf field repeated string network_endpoint_groups = 29346733; */ private $network_endpoint_groups; /** - * A list of URLs to the NotificationEndpoint resources. Must not have more than 10. A list of endpoints for receiving notifications of change in health status. For regional HealthCheckService, NotificationEndpoint must be regional and in the same region. For global HealthCheckService, NotificationEndpoint must be global. + * A list of URLs to the NotificationEndpoint + * resources. Must not have more than 10. A list of endpoints for + * receiving notifications of change in health status. For regionalHealthCheckService,NotificationEndpoint must be regional and in the + * same region. For global HealthCheckService,NotificationEndpoint must be global. * * Generated from protobuf field repeated string notification_endpoints = 406728490; */ private $notification_endpoints; /** - * [Output Only] URL of the region where the health check service resides. This field is not applicable to global health check services. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * [Output Only] URL of the region where the health check service + * resides. This field is not applicable to global health check services. + * You must specify this field as part of the HTTP request URL. It is + * not settable as a field in the request body. * * Generated from protobuf field optional string region = 138946292; */ @@ -96,28 +134,66 @@ class HealthCheckService extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $creation_timestamp - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * @type string $description - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * @type string $fingerprint - * Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking. This field will be ignored when inserting a HealthCheckService. An up-to-date fingerprint must be provided in order to patch/update the HealthCheckService; Otherwise, the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve the HealthCheckService. + * Fingerprint of this resource. A hash of the contents stored in this object. + * This field is used in optimistic locking. This field will be ignored when + * inserting a HealthCheckService. An up-to-date fingerprint must + * be provided in order to patch/update the HealthCheckService; Otherwise, the + * request will fail with error 412 conditionNotMet. To see the + * latest fingerprint, make a get() request to retrieve the + * HealthCheckService. * @type array|\Google\Protobuf\Internal\RepeatedField $health_checks - * A list of URLs to the HealthCheck resources. Must have at least one HealthCheck, and not more than 10 for regional HealthCheckService, and not more than 1 for global HealthCheckService. HealthCheck resources must have portSpecification=USE_SERVING_PORT or portSpecification=USE_FIXED_PORT. For regional HealthCheckService, the HealthCheck must be regional and in the same region. For global HealthCheckService, HealthCheck must be global. Mix of regional and global HealthChecks is not supported. Multiple regional HealthChecks must belong to the same region. Regional HealthChecks must belong to the same region as zones of NetworkEndpointGroups. For global HealthCheckService using global INTERNET_IP_PORT NetworkEndpointGroups, the global HealthChecks must specify sourceRegions, and HealthChecks that specify sourceRegions can only be used with global INTERNET_IP_PORT NetworkEndpointGroups. + * A list of URLs to the HealthCheck resources. Must have + * at least one HealthCheck, and not more than 10 for regionalHealthCheckService, and not more than 1 for globalHealthCheckService.HealthCheck resources must haveportSpecification=USE_SERVING_PORT orportSpecification=USE_FIXED_PORT. For + * regional HealthCheckService, theHealthCheck must be regional and in the same + * region. For global HealthCheckService,HealthCheck must be global. Mix of regional and globalHealthChecks is not supported. Multiple regionalHealthChecks must belong to the same region. RegionalHealthChecks must belong to the same region as zones ofNetworkEndpointGroups. For globalHealthCheckService using globalINTERNET_IP_PORT NetworkEndpointGroups, the + * global HealthChecks must specify sourceRegions, + * and HealthChecks that specify sourceRegions can + * only be used with global INTERNET_IP_PORTNetworkEndpointGroups. * @type string $health_status_aggregation_policy - * Optional. Policy for how the results from multiple health checks for the same endpoint are aggregated. Defaults to NO_AGGREGATION if unspecified. - NO_AGGREGATION. An EndpointHealth message is returned for each pair in the health check service. - AND. If any health check of an endpoint reports UNHEALTHY, then UNHEALTHY is the HealthState of the endpoint. If all health checks report HEALTHY, the HealthState of the endpoint is HEALTHY. . This is only allowed with regional HealthCheckService. + * Optional. Policy for how the results from multiple health checks + * for the same endpoint are aggregated. Defaults to NO_AGGREGATION + * if unspecified. + * - NO_AGGREGATION. An EndpointHealth message is + * returned for each pair in the health check + * service. + * - AND. If any health check of an endpoint reportsUNHEALTHY, then UNHEALTHY is theHealthState of the endpoint. If all health checks reportHEALTHY, the HealthState of the endpoint isHEALTHY. + * . + * This is only allowed with regional HealthCheckService. * Check the HealthStatusAggregationPolicy enum for the list of possible values. * @type int|string $id - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * @type string $kind - * [Output only] Type of the resource. Always compute#healthCheckServicefor health check services. + * [Output only] Type of the resource. Alwayscompute#healthCheckServicefor health check services. * @type string $name - * Name of the resource. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. The name must be 1-63 characters long, and comply + * with RFC1035. Specifically, the name must be 1-63 characters + * long and match the regular expression + * `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character + * must be a lowercase letter, and all following characters must be a dash, + * lowercase letter, or digit, except the last character, which cannot be a + * dash. * @type array|\Google\Protobuf\Internal\RepeatedField $network_endpoint_groups - * A list of URLs to the NetworkEndpointGroup resources. Must not have more than 100. For regional HealthCheckService, NEGs must be in zones in the region of the HealthCheckService. For global HealthCheckServices, the NetworkEndpointGroups must be global INTERNET_IP_PORT. + * A list of URLs to the NetworkEndpointGroup + * resources. Must not have more than 100. For regionalHealthCheckService, NEGs must be in + * zones in the region of the HealthCheckService. For globalHealthCheckServices, the NetworkEndpointGroups + * must be global INTERNET_IP_PORT. * @type array|\Google\Protobuf\Internal\RepeatedField $notification_endpoints - * A list of URLs to the NotificationEndpoint resources. Must not have more than 10. A list of endpoints for receiving notifications of change in health status. For regional HealthCheckService, NotificationEndpoint must be regional and in the same region. For global HealthCheckService, NotificationEndpoint must be global. + * A list of URLs to the NotificationEndpoint + * resources. Must not have more than 10. A list of endpoints for + * receiving notifications of change in health status. For regionalHealthCheckService,NotificationEndpoint must be regional and in the + * same region. For global HealthCheckService,NotificationEndpoint must be global. * @type string $region - * [Output Only] URL of the region where the health check service resides. This field is not applicable to global health check services. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * [Output Only] URL of the region where the health check service + * resides. This field is not applicable to global health check services. + * You must specify this field as part of the HTTP request URL. It is + * not settable as a field in the request body. * @type string $self_link * [Output Only] Server-defined URL for the resource. * } @@ -128,7 +204,8 @@ public function __construct($data = NULL) { } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @return string @@ -149,7 +226,8 @@ public function clearCreationTimestamp() } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @param string $var @@ -164,7 +242,8 @@ public function setCreationTimestamp($var) } /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @return string @@ -185,7 +264,8 @@ public function clearDescription() } /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @param string $var @@ -200,7 +280,13 @@ public function setDescription($var) } /** - * Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking. This field will be ignored when inserting a HealthCheckService. An up-to-date fingerprint must be provided in order to patch/update the HealthCheckService; Otherwise, the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve the HealthCheckService. + * Fingerprint of this resource. A hash of the contents stored in this object. + * This field is used in optimistic locking. This field will be ignored when + * inserting a HealthCheckService. An up-to-date fingerprint must + * be provided in order to patch/update the HealthCheckService; Otherwise, the + * request will fail with error 412 conditionNotMet. To see the + * latest fingerprint, make a get() request to retrieve the + * HealthCheckService. * * Generated from protobuf field optional string fingerprint = 234678500; * @return string @@ -221,7 +307,13 @@ public function clearFingerprint() } /** - * Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking. This field will be ignored when inserting a HealthCheckService. An up-to-date fingerprint must be provided in order to patch/update the HealthCheckService; Otherwise, the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve the HealthCheckService. + * Fingerprint of this resource. A hash of the contents stored in this object. + * This field is used in optimistic locking. This field will be ignored when + * inserting a HealthCheckService. An up-to-date fingerprint must + * be provided in order to patch/update the HealthCheckService; Otherwise, the + * request will fail with error 412 conditionNotMet. To see the + * latest fingerprint, make a get() request to retrieve the + * HealthCheckService. * * Generated from protobuf field optional string fingerprint = 234678500; * @param string $var @@ -236,7 +328,13 @@ public function setFingerprint($var) } /** - * A list of URLs to the HealthCheck resources. Must have at least one HealthCheck, and not more than 10 for regional HealthCheckService, and not more than 1 for global HealthCheckService. HealthCheck resources must have portSpecification=USE_SERVING_PORT or portSpecification=USE_FIXED_PORT. For regional HealthCheckService, the HealthCheck must be regional and in the same region. For global HealthCheckService, HealthCheck must be global. Mix of regional and global HealthChecks is not supported. Multiple regional HealthChecks must belong to the same region. Regional HealthChecks must belong to the same region as zones of NetworkEndpointGroups. For global HealthCheckService using global INTERNET_IP_PORT NetworkEndpointGroups, the global HealthChecks must specify sourceRegions, and HealthChecks that specify sourceRegions can only be used with global INTERNET_IP_PORT NetworkEndpointGroups. + * A list of URLs to the HealthCheck resources. Must have + * at least one HealthCheck, and not more than 10 for regionalHealthCheckService, and not more than 1 for globalHealthCheckService.HealthCheck resources must haveportSpecification=USE_SERVING_PORT orportSpecification=USE_FIXED_PORT. For + * regional HealthCheckService, theHealthCheck must be regional and in the same + * region. For global HealthCheckService,HealthCheck must be global. Mix of regional and globalHealthChecks is not supported. Multiple regionalHealthChecks must belong to the same region. RegionalHealthChecks must belong to the same region as zones ofNetworkEndpointGroups. For globalHealthCheckService using globalINTERNET_IP_PORT NetworkEndpointGroups, the + * global HealthChecks must specify sourceRegions, + * and HealthChecks that specify sourceRegions can + * only be used with global INTERNET_IP_PORTNetworkEndpointGroups. * * Generated from protobuf field repeated string health_checks = 448370606; * @return \Google\Protobuf\Internal\RepeatedField @@ -247,7 +345,13 @@ public function getHealthChecks() } /** - * A list of URLs to the HealthCheck resources. Must have at least one HealthCheck, and not more than 10 for regional HealthCheckService, and not more than 1 for global HealthCheckService. HealthCheck resources must have portSpecification=USE_SERVING_PORT or portSpecification=USE_FIXED_PORT. For regional HealthCheckService, the HealthCheck must be regional and in the same region. For global HealthCheckService, HealthCheck must be global. Mix of regional and global HealthChecks is not supported. Multiple regional HealthChecks must belong to the same region. Regional HealthChecks must belong to the same region as zones of NetworkEndpointGroups. For global HealthCheckService using global INTERNET_IP_PORT NetworkEndpointGroups, the global HealthChecks must specify sourceRegions, and HealthChecks that specify sourceRegions can only be used with global INTERNET_IP_PORT NetworkEndpointGroups. + * A list of URLs to the HealthCheck resources. Must have + * at least one HealthCheck, and not more than 10 for regionalHealthCheckService, and not more than 1 for globalHealthCheckService.HealthCheck resources must haveportSpecification=USE_SERVING_PORT orportSpecification=USE_FIXED_PORT. For + * regional HealthCheckService, theHealthCheck must be regional and in the same + * region. For global HealthCheckService,HealthCheck must be global. Mix of regional and globalHealthChecks is not supported. Multiple regionalHealthChecks must belong to the same region. RegionalHealthChecks must belong to the same region as zones ofNetworkEndpointGroups. For globalHealthCheckService using globalINTERNET_IP_PORT NetworkEndpointGroups, the + * global HealthChecks must specify sourceRegions, + * and HealthChecks that specify sourceRegions can + * only be used with global INTERNET_IP_PORTNetworkEndpointGroups. * * Generated from protobuf field repeated string health_checks = 448370606; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -262,7 +366,15 @@ public function setHealthChecks($var) } /** - * Optional. Policy for how the results from multiple health checks for the same endpoint are aggregated. Defaults to NO_AGGREGATION if unspecified. - NO_AGGREGATION. An EndpointHealth message is returned for each pair in the health check service. - AND. If any health check of an endpoint reports UNHEALTHY, then UNHEALTHY is the HealthState of the endpoint. If all health checks report HEALTHY, the HealthState of the endpoint is HEALTHY. . This is only allowed with regional HealthCheckService. + * Optional. Policy for how the results from multiple health checks + * for the same endpoint are aggregated. Defaults to NO_AGGREGATION + * if unspecified. + * - NO_AGGREGATION. An EndpointHealth message is + * returned for each pair in the health check + * service. + * - AND. If any health check of an endpoint reportsUNHEALTHY, then UNHEALTHY is theHealthState of the endpoint. If all health checks reportHEALTHY, the HealthState of the endpoint isHEALTHY. + * . + * This is only allowed with regional HealthCheckService. * Check the HealthStatusAggregationPolicy enum for the list of possible values. * * Generated from protobuf field optional string health_status_aggregation_policy = 253163129; @@ -284,7 +396,15 @@ public function clearHealthStatusAggregationPolicy() } /** - * Optional. Policy for how the results from multiple health checks for the same endpoint are aggregated. Defaults to NO_AGGREGATION if unspecified. - NO_AGGREGATION. An EndpointHealth message is returned for each pair in the health check service. - AND. If any health check of an endpoint reports UNHEALTHY, then UNHEALTHY is the HealthState of the endpoint. If all health checks report HEALTHY, the HealthState of the endpoint is HEALTHY. . This is only allowed with regional HealthCheckService. + * Optional. Policy for how the results from multiple health checks + * for the same endpoint are aggregated. Defaults to NO_AGGREGATION + * if unspecified. + * - NO_AGGREGATION. An EndpointHealth message is + * returned for each pair in the health check + * service. + * - AND. If any health check of an endpoint reportsUNHEALTHY, then UNHEALTHY is theHealthState of the endpoint. If all health checks reportHEALTHY, the HealthState of the endpoint isHEALTHY. + * . + * This is only allowed with regional HealthCheckService. * Check the HealthStatusAggregationPolicy enum for the list of possible values. * * Generated from protobuf field optional string health_status_aggregation_policy = 253163129; @@ -300,7 +420,8 @@ public function setHealthStatusAggregationPolicy($var) } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @return int|string @@ -321,7 +442,8 @@ public function clearId() } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @param int|string $var @@ -336,7 +458,7 @@ public function setId($var) } /** - * [Output only] Type of the resource. Always compute#healthCheckServicefor health check services. + * [Output only] Type of the resource. Alwayscompute#healthCheckServicefor health check services. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -357,7 +479,7 @@ public function clearKind() } /** - * [Output only] Type of the resource. Always compute#healthCheckServicefor health check services. + * [Output only] Type of the resource. Alwayscompute#healthCheckServicefor health check services. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -372,7 +494,13 @@ public function setKind($var) } /** - * Name of the resource. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. The name must be 1-63 characters long, and comply + * with RFC1035. Specifically, the name must be 1-63 characters + * long and match the regular expression + * `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character + * must be a lowercase letter, and all following characters must be a dash, + * lowercase letter, or digit, except the last character, which cannot be a + * dash. * * Generated from protobuf field optional string name = 3373707; * @return string @@ -393,7 +521,13 @@ public function clearName() } /** - * Name of the resource. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. The name must be 1-63 characters long, and comply + * with RFC1035. Specifically, the name must be 1-63 characters + * long and match the regular expression + * `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character + * must be a lowercase letter, and all following characters must be a dash, + * lowercase letter, or digit, except the last character, which cannot be a + * dash. * * Generated from protobuf field optional string name = 3373707; * @param string $var @@ -408,7 +542,10 @@ public function setName($var) } /** - * A list of URLs to the NetworkEndpointGroup resources. Must not have more than 100. For regional HealthCheckService, NEGs must be in zones in the region of the HealthCheckService. For global HealthCheckServices, the NetworkEndpointGroups must be global INTERNET_IP_PORT. + * A list of URLs to the NetworkEndpointGroup + * resources. Must not have more than 100. For regionalHealthCheckService, NEGs must be in + * zones in the region of the HealthCheckService. For globalHealthCheckServices, the NetworkEndpointGroups + * must be global INTERNET_IP_PORT. * * Generated from protobuf field repeated string network_endpoint_groups = 29346733; * @return \Google\Protobuf\Internal\RepeatedField @@ -419,7 +556,10 @@ public function getNetworkEndpointGroups() } /** - * A list of URLs to the NetworkEndpointGroup resources. Must not have more than 100. For regional HealthCheckService, NEGs must be in zones in the region of the HealthCheckService. For global HealthCheckServices, the NetworkEndpointGroups must be global INTERNET_IP_PORT. + * A list of URLs to the NetworkEndpointGroup + * resources. Must not have more than 100. For regionalHealthCheckService, NEGs must be in + * zones in the region of the HealthCheckService. For globalHealthCheckServices, the NetworkEndpointGroups + * must be global INTERNET_IP_PORT. * * Generated from protobuf field repeated string network_endpoint_groups = 29346733; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -434,7 +574,10 @@ public function setNetworkEndpointGroups($var) } /** - * A list of URLs to the NotificationEndpoint resources. Must not have more than 10. A list of endpoints for receiving notifications of change in health status. For regional HealthCheckService, NotificationEndpoint must be regional and in the same region. For global HealthCheckService, NotificationEndpoint must be global. + * A list of URLs to the NotificationEndpoint + * resources. Must not have more than 10. A list of endpoints for + * receiving notifications of change in health status. For regionalHealthCheckService,NotificationEndpoint must be regional and in the + * same region. For global HealthCheckService,NotificationEndpoint must be global. * * Generated from protobuf field repeated string notification_endpoints = 406728490; * @return \Google\Protobuf\Internal\RepeatedField @@ -445,7 +588,10 @@ public function getNotificationEndpoints() } /** - * A list of URLs to the NotificationEndpoint resources. Must not have more than 10. A list of endpoints for receiving notifications of change in health status. For regional HealthCheckService, NotificationEndpoint must be regional and in the same region. For global HealthCheckService, NotificationEndpoint must be global. + * A list of URLs to the NotificationEndpoint + * resources. Must not have more than 10. A list of endpoints for + * receiving notifications of change in health status. For regionalHealthCheckService,NotificationEndpoint must be regional and in the + * same region. For global HealthCheckService,NotificationEndpoint must be global. * * Generated from protobuf field repeated string notification_endpoints = 406728490; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -460,7 +606,10 @@ public function setNotificationEndpoints($var) } /** - * [Output Only] URL of the region where the health check service resides. This field is not applicable to global health check services. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * [Output Only] URL of the region where the health check service + * resides. This field is not applicable to global health check services. + * You must specify this field as part of the HTTP request URL. It is + * not settable as a field in the request body. * * Generated from protobuf field optional string region = 138946292; * @return string @@ -481,7 +630,10 @@ public function clearRegion() } /** - * [Output Only] URL of the region where the health check service resides. This field is not applicable to global health check services. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * [Output Only] URL of the region where the health check service + * resides. This field is not applicable to global health check services. + * You must specify this field as part of the HTTP request URL. It is + * not settable as a field in the request body. * * Generated from protobuf field optional string region = 138946292; * @param string $var diff --git a/Compute/src/V1/HealthCheckService/HealthStatusAggregationPolicy.php b/Compute/src/V1/HealthCheckService/HealthStatusAggregationPolicy.php index ee96adc4a9d2..b282a537522f 100644 --- a/Compute/src/V1/HealthCheckService/HealthStatusAggregationPolicy.php +++ b/Compute/src/V1/HealthCheckService/HealthStatusAggregationPolicy.php @@ -7,7 +7,15 @@ use UnexpectedValueException; /** - * Optional. Policy for how the results from multiple health checks for the same endpoint are aggregated. Defaults to NO_AGGREGATION if unspecified. - NO_AGGREGATION. An EndpointHealth message is returned for each pair in the health check service. - AND. If any health check of an endpoint reports UNHEALTHY, then UNHEALTHY is the HealthState of the endpoint. If all health checks report HEALTHY, the HealthState of the endpoint is HEALTHY. . This is only allowed with regional HealthCheckService. + * Optional. Policy for how the results from multiple health checks + * for the same endpoint are aggregated. Defaults to NO_AGGREGATION + * if unspecified. + * - NO_AGGREGATION. An EndpointHealth message is + * returned for each pair in the health check + * service. + * - AND. If any health check of an endpoint reportsUNHEALTHY, then UNHEALTHY is theHealthState of the endpoint. If all health checks reportHEALTHY, the HealthState of the endpoint isHEALTHY. + * . + * This is only allowed with regional HealthCheckService. * * Protobuf type google.cloud.compute.v1.HealthCheckService.HealthStatusAggregationPolicy */ @@ -20,13 +28,17 @@ class HealthStatusAggregationPolicy */ const UNDEFINED_HEALTH_STATUS_AGGREGATION_POLICY = 0; /** - * If any backend's health check reports UNHEALTHY, then UNHEALTHY is the HealthState of the entire health check service. If all backend's are healthy, the HealthState of the health check service is HEALTHY. + * If any backend's health check reports UNHEALTHY, + * then UNHEALTHY is the HealthState of + * the entire health check service. If all backend's are healthy, + * the HealthState of the health check service isHEALTHY. * * Generated from protobuf enum AND = 64951; */ const PBAND = 64951; /** - * An EndpointHealth message is returned for each backend in the health check service. + * An EndpointHealth message is returned for each + * backend in the health check service. * * Generated from protobuf enum NO_AGGREGATION = 426445124; */ diff --git a/Compute/src/V1/HealthCheckServiceReference.php b/Compute/src/V1/HealthCheckServiceReference.php index 40ddcb9d5981..f07f62839e90 100644 --- a/Compute/src/V1/HealthCheckServiceReference.php +++ b/Compute/src/V1/HealthCheckServiceReference.php @@ -9,7 +9,11 @@ use Google\Protobuf\Internal\GPBUtil; /** - * A full or valid partial URL to a health check service. For example, the following are valid URLs: - https://www.googleapis.com/compute/beta/projects/project-id/regions/us-west1/healthCheckServices/health-check-service - projects/project-id/regions/us-west1/healthCheckServices/health-check-service - regions/us-west1/healthCheckServices/health-check-service + * A full or valid partial URL to a health check service. For example, the + * following are valid URLs: + * - https://www.googleapis.com/compute/beta/projects/project-id/regions/us-west1/healthCheckServices/health-check-service + * - projects/project-id/regions/us-west1/healthCheckServices/health-check-service + * - regions/us-west1/healthCheckServices/health-check-service * * Generated from protobuf message google.cloud.compute.v1.HealthCheckServiceReference */ diff --git a/Compute/src/V1/HealthCheckServicesList.php b/Compute/src/V1/HealthCheckServicesList.php index 3efa5f339fa4..2126828f0b0f 100644 --- a/Compute/src/V1/HealthCheckServicesList.php +++ b/Compute/src/V1/HealthCheckServicesList.php @@ -27,13 +27,18 @@ class HealthCheckServicesList extends \Google\Protobuf\Internal\Message */ private $items; /** - * [Output Only] Type of the resource. Always compute#healthCheckServicesList for lists of HealthCheckServices. + * [Output Only] Type of the resource. Alwayscompute#healthCheckServicesList for lists of + * HealthCheckServices. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -62,9 +67,14 @@ class HealthCheckServicesList extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\HealthCheckService>|\Google\Protobuf\Internal\RepeatedField $items * A list of HealthCheckService resources. * @type string $kind - * [Output Only] Type of the resource. Always compute#healthCheckServicesList for lists of HealthCheckServices. + * [Output Only] Type of the resource. Alwayscompute#healthCheckServicesList for lists of + * HealthCheckServices. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type \Google\Cloud\Compute\V1\Warning $warning @@ -139,7 +149,8 @@ public function setItems($var) } /** - * [Output Only] Type of the resource. Always compute#healthCheckServicesList for lists of HealthCheckServices. + * [Output Only] Type of the resource. Alwayscompute#healthCheckServicesList for lists of + * HealthCheckServices. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -160,7 +171,8 @@ public function clearKind() } /** - * [Output Only] Type of the resource. Always compute#healthCheckServicesList for lists of HealthCheckServices. + * [Output Only] Type of the resource. Alwayscompute#healthCheckServicesList for lists of + * HealthCheckServices. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -175,7 +187,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -196,7 +212,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/HealthChecksAggregatedList.php b/Compute/src/V1/HealthChecksAggregatedList.php index c6aaa4012547..c2cd1ef14405 100644 --- a/Compute/src/V1/HealthChecksAggregatedList.php +++ b/Compute/src/V1/HealthChecksAggregatedList.php @@ -33,7 +33,11 @@ class HealthChecksAggregatedList extends \Google\Protobuf\Internal\Message */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -70,7 +74,11 @@ class HealthChecksAggregatedList extends \Google\Protobuf\Internal\Message * @type string $kind * Type of resource. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type array|\Google\Protobuf\Internal\RepeatedField $unreachables @@ -183,7 +191,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -204,7 +216,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/HealthChecksScopedList.php b/Compute/src/V1/HealthChecksScopedList.php index c3754ab49234..56a6d6b8ccbd 100644 --- a/Compute/src/V1/HealthChecksScopedList.php +++ b/Compute/src/V1/HealthChecksScopedList.php @@ -21,7 +21,8 @@ class HealthChecksScopedList extends \Google\Protobuf\Internal\Message */ private $health_checks; /** - * Informational warning which replaces the list of backend services when the list is empty. + * Informational warning which replaces the list of + * backend services when the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; */ @@ -36,7 +37,8 @@ class HealthChecksScopedList extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\HealthCheck>|\Google\Protobuf\Internal\RepeatedField $health_checks * A list of HealthChecks contained in this scope. * @type \Google\Cloud\Compute\V1\Warning $warning - * Informational warning which replaces the list of backend services when the list is empty. + * Informational warning which replaces the list of + * backend services when the list is empty. * } */ public function __construct($data = NULL) { @@ -71,7 +73,8 @@ public function setHealthChecks($var) } /** - * Informational warning which replaces the list of backend services when the list is empty. + * Informational warning which replaces the list of + * backend services when the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; * @return \Google\Cloud\Compute\V1\Warning|null @@ -92,7 +95,8 @@ public function clearWarning() } /** - * Informational warning which replaces the list of backend services when the list is empty. + * Informational warning which replaces the list of + * backend services when the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; * @param \Google\Cloud\Compute\V1\Warning $var diff --git a/Compute/src/V1/HealthStatus.php b/Compute/src/V1/HealthStatus.php index c52a3283e79e..bfaab6c83479 100644 --- a/Compute/src/V1/HealthStatus.php +++ b/Compute/src/V1/HealthStatus.php @@ -21,7 +21,8 @@ class HealthStatus extends \Google\Protobuf\Internal\Message */ private $annotations; /** - * URL of the forwarding rule associated with the health status of the instance. + * URL of the forwarding rule associated with the health status of the + * instance. * * Generated from protobuf field optional string forwarding_rule = 269964030; */ @@ -46,7 +47,9 @@ class HealthStatus extends \Google\Protobuf\Internal\Message */ protected $instance = null; /** - * For target pool based Network Load Balancing, it indicates the forwarding rule's IP address assigned to this instance. For other types of load balancing, the field indicates VM internal ip. + * For target pool based Network Load Balancing, it indicates the forwarding + * rule's IP address assigned to this instance. For other types of load + * balancing, the field indicates VM internal ip. * * Generated from protobuf field optional string ip_address = 406272220; */ @@ -63,7 +66,8 @@ class HealthStatus extends \Google\Protobuf\Internal\Message */ protected $ipv6_health_state = null; /** - * The named port of the instance group, not necessarily the port that is health-checked. + * The named port of the instance group, not necessarily the port that is + * health-checked. * * Generated from protobuf field optional int32 port = 3446913; */ @@ -89,7 +93,8 @@ class HealthStatus extends \Google\Protobuf\Internal\Message * @type array|\Google\Protobuf\Internal\MapField $annotations * Metadata defined as annotations for network endpoint. * @type string $forwarding_rule - * URL of the forwarding rule associated with the health status of the instance. + * URL of the forwarding rule associated with the health status of the + * instance. * @type string $forwarding_rule_ip * A forwarding rule IP address assigned to this instance. * @type string $health_state @@ -98,13 +103,16 @@ class HealthStatus extends \Google\Protobuf\Internal\Message * @type string $instance * URL of the instance resource. * @type string $ip_address - * For target pool based Network Load Balancing, it indicates the forwarding rule's IP address assigned to this instance. For other types of load balancing, the field indicates VM internal ip. + * For target pool based Network Load Balancing, it indicates the forwarding + * rule's IP address assigned to this instance. For other types of load + * balancing, the field indicates VM internal ip. * @type string $ipv6_address * @type string $ipv6_health_state * Health state of the IPv6 address of the instance. * Check the Ipv6HealthState enum for the list of possible values. * @type int $port - * The named port of the instance group, not necessarily the port that is health-checked. + * The named port of the instance group, not necessarily the port that is + * health-checked. * @type string $weight * @type string $weight_error * @@ -143,7 +151,8 @@ public function setAnnotations($var) } /** - * URL of the forwarding rule associated with the health status of the instance. + * URL of the forwarding rule associated with the health status of the + * instance. * * Generated from protobuf field optional string forwarding_rule = 269964030; * @return string @@ -164,7 +173,8 @@ public function clearForwardingRule() } /** - * URL of the forwarding rule associated with the health status of the instance. + * URL of the forwarding rule associated with the health status of the + * instance. * * Generated from protobuf field optional string forwarding_rule = 269964030; * @param string $var @@ -289,7 +299,9 @@ public function setInstance($var) } /** - * For target pool based Network Load Balancing, it indicates the forwarding rule's IP address assigned to this instance. For other types of load balancing, the field indicates VM internal ip. + * For target pool based Network Load Balancing, it indicates the forwarding + * rule's IP address assigned to this instance. For other types of load + * balancing, the field indicates VM internal ip. * * Generated from protobuf field optional string ip_address = 406272220; * @return string @@ -310,7 +322,9 @@ public function clearIpAddress() } /** - * For target pool based Network Load Balancing, it indicates the forwarding rule's IP address assigned to this instance. For other types of load balancing, the field indicates VM internal ip. + * For target pool based Network Load Balancing, it indicates the forwarding + * rule's IP address assigned to this instance. For other types of load + * balancing, the field indicates VM internal ip. * * Generated from protobuf field optional string ip_address = 406272220; * @param string $var @@ -395,7 +409,8 @@ public function setIpv6HealthState($var) } /** - * The named port of the instance group, not necessarily the port that is health-checked. + * The named port of the instance group, not necessarily the port that is + * health-checked. * * Generated from protobuf field optional int32 port = 3446913; * @return int @@ -416,7 +431,8 @@ public function clearPort() } /** - * The named port of the instance group, not necessarily the port that is health-checked. + * The named port of the instance group, not necessarily the port that is + * health-checked. * * Generated from protobuf field optional int32 port = 3446913; * @param int $var diff --git a/Compute/src/V1/HealthStatus/WeightError.php b/Compute/src/V1/HealthStatus/WeightError.php index 1a74de75f438..0a90225c7f50 100644 --- a/Compute/src/V1/HealthStatus/WeightError.php +++ b/Compute/src/V1/HealthStatus/WeightError.php @@ -19,25 +19,37 @@ class WeightError */ const UNDEFINED_WEIGHT_ERROR = 0; /** - * The response to a Health Check probe had the HTTP response header field X-Load-Balancing-Endpoint-Weight, but its content was invalid (i.e., not a non-negative single-precision floating-point number in decimal string representation). + * The response to a Health Check probe had the HTTP response header field + * X-Load-Balancing-Endpoint-Weight, but its content was invalid (i.e., not + * a non-negative single-precision floating-point number in decimal string + * representation). * * Generated from protobuf enum INVALID_WEIGHT = 383698400; */ const INVALID_WEIGHT = 383698400; /** - * The response to a Health Check probe did not have the HTTP response header field X-Load-Balancing-Endpoint-Weight. + * The response to a Health Check probe did not have the HTTP response + * header field X-Load-Balancing-Endpoint-Weight. * * Generated from protobuf enum MISSING_WEIGHT = 384027537; */ const MISSING_WEIGHT = 384027537; /** - * This is the value when the accompanied health status is either TIMEOUT (i.e.,the Health Check probe was not able to get a response in time) or UNKNOWN. For the latter, it should be typically because there has not been sufficient time to parse and report the weight for a new backend (which is with 0.0.0.0 ip address). However, it can be also due to an outage case for which the health status is explicitly reset to UNKNOWN. + * This is the value when the accompanied health status is either TIMEOUT + * (i.e.,the Health Check probe was not able to get a response in time) or + * UNKNOWN. For the latter, it should be typically because there has not + * been sufficient time to parse and report the weight for a new backend + * (which is with 0.0.0.0 ip address). However, it can be also due to an + * outage case for which the health status is explicitly reset to UNKNOWN. * * Generated from protobuf enum UNAVAILABLE_WEIGHT = 439464295; */ const UNAVAILABLE_WEIGHT = 439464295; /** - * This is the default value when WeightReportMode is DISABLE, and is also the initial value when WeightReportMode has just updated to ENABLE or DRY_RUN and there has not been sufficient time to parse and report the backend weight. + * This is the default value when WeightReportMode is DISABLE, + * and is also the initial value when WeightReportMode has just updated to + * ENABLE or DRY_RUN and there has not been + * sufficient time to parse and report the backend weight. * * Generated from protobuf enum WEIGHT_NONE = 502428831; */ diff --git a/Compute/src/V1/HealthStatusForNetworkEndpoint.php b/Compute/src/V1/HealthStatusForNetworkEndpoint.php index f69fc7281c02..46b138e45cd6 100644 --- a/Compute/src/V1/HealthStatusForNetworkEndpoint.php +++ b/Compute/src/V1/HealthStatusForNetworkEndpoint.php @@ -15,38 +15,44 @@ class HealthStatusForNetworkEndpoint extends \Google\Protobuf\Internal\Message { /** - * URL of the backend service associated with the health state of the network endpoint. + * URL of the backend service associated with the health state of the network + * endpoint. * * Generated from protobuf field optional .google.cloud.compute.v1.BackendServiceReference backend_service = 306946058; */ protected $backend_service = null; /** - * URL of the forwarding rule associated with the health state of the network endpoint. + * URL of the forwarding rule associated with the health state of the network + * endpoint. * * Generated from protobuf field optional .google.cloud.compute.v1.ForwardingRuleReference forwarding_rule = 269964030; */ protected $forwarding_rule = null; /** - * URL of the health check associated with the health state of the network endpoint. + * URL of the health check associated with the health state of the network + * endpoint. * * Generated from protobuf field optional .google.cloud.compute.v1.HealthCheckReference health_check = 308876645; */ protected $health_check = null; /** - * URL of the health check service associated with the health state of the network endpoint. + * URL of the health check service associated with the health state of the + * network endpoint. * * Generated from protobuf field optional .google.cloud.compute.v1.HealthCheckServiceReference health_check_service = 408374747; */ protected $health_check_service = null; /** - * Health state of the network endpoint determined based on the health checks configured. + * Health state of the network endpoint determined based on the health checks + * configured. * Check the HealthState enum for the list of possible values. * * Generated from protobuf field optional string health_state = 324007150; */ protected $health_state = null; /** - * Health state of the ipv6 network endpoint determined based on the health checks configured. + * Health state of the ipv6 network endpoint determined based on the health + * checks configured. * Check the Ipv6HealthState enum for the list of possible values. * * Generated from protobuf field optional string ipv6_health_state = 190316614; @@ -60,18 +66,24 @@ class HealthStatusForNetworkEndpoint extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type \Google\Cloud\Compute\V1\BackendServiceReference $backend_service - * URL of the backend service associated with the health state of the network endpoint. + * URL of the backend service associated with the health state of the network + * endpoint. * @type \Google\Cloud\Compute\V1\ForwardingRuleReference $forwarding_rule - * URL of the forwarding rule associated with the health state of the network endpoint. + * URL of the forwarding rule associated with the health state of the network + * endpoint. * @type \Google\Cloud\Compute\V1\HealthCheckReference $health_check - * URL of the health check associated with the health state of the network endpoint. + * URL of the health check associated with the health state of the network + * endpoint. * @type \Google\Cloud\Compute\V1\HealthCheckServiceReference $health_check_service - * URL of the health check service associated with the health state of the network endpoint. + * URL of the health check service associated with the health state of the + * network endpoint. * @type string $health_state - * Health state of the network endpoint determined based on the health checks configured. + * Health state of the network endpoint determined based on the health checks + * configured. * Check the HealthState enum for the list of possible values. * @type string $ipv6_health_state - * Health state of the ipv6 network endpoint determined based on the health checks configured. + * Health state of the ipv6 network endpoint determined based on the health + * checks configured. * Check the Ipv6HealthState enum for the list of possible values. * } */ @@ -81,7 +93,8 @@ public function __construct($data = NULL) { } /** - * URL of the backend service associated with the health state of the network endpoint. + * URL of the backend service associated with the health state of the network + * endpoint. * * Generated from protobuf field optional .google.cloud.compute.v1.BackendServiceReference backend_service = 306946058; * @return \Google\Cloud\Compute\V1\BackendServiceReference|null @@ -102,7 +115,8 @@ public function clearBackendService() } /** - * URL of the backend service associated with the health state of the network endpoint. + * URL of the backend service associated with the health state of the network + * endpoint. * * Generated from protobuf field optional .google.cloud.compute.v1.BackendServiceReference backend_service = 306946058; * @param \Google\Cloud\Compute\V1\BackendServiceReference $var @@ -117,7 +131,8 @@ public function setBackendService($var) } /** - * URL of the forwarding rule associated with the health state of the network endpoint. + * URL of the forwarding rule associated with the health state of the network + * endpoint. * * Generated from protobuf field optional .google.cloud.compute.v1.ForwardingRuleReference forwarding_rule = 269964030; * @return \Google\Cloud\Compute\V1\ForwardingRuleReference|null @@ -138,7 +153,8 @@ public function clearForwardingRule() } /** - * URL of the forwarding rule associated with the health state of the network endpoint. + * URL of the forwarding rule associated with the health state of the network + * endpoint. * * Generated from protobuf field optional .google.cloud.compute.v1.ForwardingRuleReference forwarding_rule = 269964030; * @param \Google\Cloud\Compute\V1\ForwardingRuleReference $var @@ -153,7 +169,8 @@ public function setForwardingRule($var) } /** - * URL of the health check associated with the health state of the network endpoint. + * URL of the health check associated with the health state of the network + * endpoint. * * Generated from protobuf field optional .google.cloud.compute.v1.HealthCheckReference health_check = 308876645; * @return \Google\Cloud\Compute\V1\HealthCheckReference|null @@ -174,7 +191,8 @@ public function clearHealthCheck() } /** - * URL of the health check associated with the health state of the network endpoint. + * URL of the health check associated with the health state of the network + * endpoint. * * Generated from protobuf field optional .google.cloud.compute.v1.HealthCheckReference health_check = 308876645; * @param \Google\Cloud\Compute\V1\HealthCheckReference $var @@ -189,7 +207,8 @@ public function setHealthCheck($var) } /** - * URL of the health check service associated with the health state of the network endpoint. + * URL of the health check service associated with the health state of the + * network endpoint. * * Generated from protobuf field optional .google.cloud.compute.v1.HealthCheckServiceReference health_check_service = 408374747; * @return \Google\Cloud\Compute\V1\HealthCheckServiceReference|null @@ -210,7 +229,8 @@ public function clearHealthCheckService() } /** - * URL of the health check service associated with the health state of the network endpoint. + * URL of the health check service associated with the health state of the + * network endpoint. * * Generated from protobuf field optional .google.cloud.compute.v1.HealthCheckServiceReference health_check_service = 408374747; * @param \Google\Cloud\Compute\V1\HealthCheckServiceReference $var @@ -225,7 +245,8 @@ public function setHealthCheckService($var) } /** - * Health state of the network endpoint determined based on the health checks configured. + * Health state of the network endpoint determined based on the health checks + * configured. * Check the HealthState enum for the list of possible values. * * Generated from protobuf field optional string health_state = 324007150; @@ -247,7 +268,8 @@ public function clearHealthState() } /** - * Health state of the network endpoint determined based on the health checks configured. + * Health state of the network endpoint determined based on the health checks + * configured. * Check the HealthState enum for the list of possible values. * * Generated from protobuf field optional string health_state = 324007150; @@ -263,7 +285,8 @@ public function setHealthState($var) } /** - * Health state of the ipv6 network endpoint determined based on the health checks configured. + * Health state of the ipv6 network endpoint determined based on the health + * checks configured. * Check the Ipv6HealthState enum for the list of possible values. * * Generated from protobuf field optional string ipv6_health_state = 190316614; @@ -285,7 +308,8 @@ public function clearIpv6HealthState() } /** - * Health state of the ipv6 network endpoint determined based on the health checks configured. + * Health state of the ipv6 network endpoint determined based on the health + * checks configured. * Check the Ipv6HealthState enum for the list of possible values. * * Generated from protobuf field optional string ipv6_health_state = 190316614; diff --git a/Compute/src/V1/HealthStatusForNetworkEndpoint/HealthState.php b/Compute/src/V1/HealthStatusForNetworkEndpoint/HealthState.php index d3f5ab347ba3..a16a5363c166 100644 --- a/Compute/src/V1/HealthStatusForNetworkEndpoint/HealthState.php +++ b/Compute/src/V1/HealthStatusForNetworkEndpoint/HealthState.php @@ -7,7 +7,8 @@ use UnexpectedValueException; /** - * Health state of the network endpoint determined based on the health checks configured. + * Health state of the network endpoint determined based on the health checks + * configured. * Additional supported values which may be not listed in the enum directly due to technical reasons: * DRAINING * HEALTHY diff --git a/Compute/src/V1/HealthStatusForNetworkEndpoint/Ipv6HealthState.php b/Compute/src/V1/HealthStatusForNetworkEndpoint/Ipv6HealthState.php index 311d9bb3d5dd..adfaa8cdee25 100644 --- a/Compute/src/V1/HealthStatusForNetworkEndpoint/Ipv6HealthState.php +++ b/Compute/src/V1/HealthStatusForNetworkEndpoint/Ipv6HealthState.php @@ -7,7 +7,8 @@ use UnexpectedValueException; /** - * Health state of the ipv6 network endpoint determined based on the health checks configured. + * Health state of the ipv6 network endpoint determined based on the health + * checks configured. * Additional supported values which may be not listed in the enum directly due to technical reasons: * DRAINING * HEALTHY diff --git a/Compute/src/V1/Help.php b/Compute/src/V1/Help.php index 46ccdd08decd..d0e17538607b 100644 --- a/Compute/src/V1/Help.php +++ b/Compute/src/V1/Help.php @@ -9,7 +9,10 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Provides links to documentation or for performing an out of band action. For example, if a quota check failed with an error indicating the calling project hasn't enabled the accessed service, this can contain a URL pointing directly to the right place in the developer console to flip the bit. + * Provides links to documentation or for performing an out of band action. + * For example, if a quota check failed with an error indicating the calling + * project hasn't enabled the accessed service, this can contain a URL pointing + * directly to the right place in the developer console to flip the bit. * * Generated from protobuf message google.cloud.compute.v1.Help */ diff --git a/Compute/src/V1/HostRule.php b/Compute/src/V1/HostRule.php index e0554748b364..64f5cd984713 100644 --- a/Compute/src/V1/HostRule.php +++ b/Compute/src/V1/HostRule.php @@ -9,26 +9,36 @@ use Google\Protobuf\Internal\GPBUtil; /** - * UrlMaps A host-matching rule for a URL. If matched, will use the named PathMatcher to select the BackendService. + * UrlMaps + * A host-matching rule for a URL. If matched, will use the namedPathMatcher to select the BackendService. * * Generated from protobuf message google.cloud.compute.v1.HostRule */ class HostRule extends \Google\Protobuf\Internal\Message { /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; */ protected $description = null; /** - * The list of host patterns to match. They must be valid hostnames with optional port numbers in the format host:port. * matches any string of ([a-z0-9-.]*). In that case, * must be the first character, and if followed by anything, the immediate following character must be either - or .. * based matching is not supported when the URL map is bound to a target gRPC proxy that has the validateForProxyless field set to true. + * The list of host patterns to match. They must be valid hostnames with + * optional port numbers in the format host:port.* matches any string of ([a-z0-9-.]*). In + * that case, * must be the first character, and if followed by + * anything, the immediate following character must be either - + * or .. + * * based matching is not supported when the URL map is bound + * to a target gRPC proxy that has the validateForProxyless field + * set to true. * * Generated from protobuf field repeated string hosts = 99467211; */ private $hosts; /** - * The name of the PathMatcher to use to match the path portion of the URL if the hostRule matches the URL's host portion. + * The name of the PathMatcher to use to match the path portion + * of the URL if the hostRule matches the URL's host portion. * * Generated from protobuf field optional string path_matcher = 337813272; */ @@ -41,11 +51,20 @@ class HostRule extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $description - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * @type array|\Google\Protobuf\Internal\RepeatedField $hosts - * The list of host patterns to match. They must be valid hostnames with optional port numbers in the format host:port. * matches any string of ([a-z0-9-.]*). In that case, * must be the first character, and if followed by anything, the immediate following character must be either - or .. * based matching is not supported when the URL map is bound to a target gRPC proxy that has the validateForProxyless field set to true. + * The list of host patterns to match. They must be valid hostnames with + * optional port numbers in the format host:port.* matches any string of ([a-z0-9-.]*). In + * that case, * must be the first character, and if followed by + * anything, the immediate following character must be either - + * or .. + * * based matching is not supported when the URL map is bound + * to a target gRPC proxy that has the validateForProxyless field + * set to true. * @type string $path_matcher - * The name of the PathMatcher to use to match the path portion of the URL if the hostRule matches the URL's host portion. + * The name of the PathMatcher to use to match the path portion + * of the URL if the hostRule matches the URL's host portion. * } */ public function __construct($data = NULL) { @@ -54,7 +73,8 @@ public function __construct($data = NULL) { } /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @return string @@ -75,7 +95,8 @@ public function clearDescription() } /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @param string $var @@ -90,7 +111,14 @@ public function setDescription($var) } /** - * The list of host patterns to match. They must be valid hostnames with optional port numbers in the format host:port. * matches any string of ([a-z0-9-.]*). In that case, * must be the first character, and if followed by anything, the immediate following character must be either - or .. * based matching is not supported when the URL map is bound to a target gRPC proxy that has the validateForProxyless field set to true. + * The list of host patterns to match. They must be valid hostnames with + * optional port numbers in the format host:port.* matches any string of ([a-z0-9-.]*). In + * that case, * must be the first character, and if followed by + * anything, the immediate following character must be either - + * or .. + * * based matching is not supported when the URL map is bound + * to a target gRPC proxy that has the validateForProxyless field + * set to true. * * Generated from protobuf field repeated string hosts = 99467211; * @return \Google\Protobuf\Internal\RepeatedField @@ -101,7 +129,14 @@ public function getHosts() } /** - * The list of host patterns to match. They must be valid hostnames with optional port numbers in the format host:port. * matches any string of ([a-z0-9-.]*). In that case, * must be the first character, and if followed by anything, the immediate following character must be either - or .. * based matching is not supported when the URL map is bound to a target gRPC proxy that has the validateForProxyless field set to true. + * The list of host patterns to match. They must be valid hostnames with + * optional port numbers in the format host:port.* matches any string of ([a-z0-9-.]*). In + * that case, * must be the first character, and if followed by + * anything, the immediate following character must be either - + * or .. + * * based matching is not supported when the URL map is bound + * to a target gRPC proxy that has the validateForProxyless field + * set to true. * * Generated from protobuf field repeated string hosts = 99467211; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -116,7 +151,8 @@ public function setHosts($var) } /** - * The name of the PathMatcher to use to match the path portion of the URL if the hostRule matches the URL's host portion. + * The name of the PathMatcher to use to match the path portion + * of the URL if the hostRule matches the URL's host portion. * * Generated from protobuf field optional string path_matcher = 337813272; * @return string @@ -137,7 +173,8 @@ public function clearPathMatcher() } /** - * The name of the PathMatcher to use to match the path portion of the URL if the hostRule matches the URL's host portion. + * The name of the PathMatcher to use to match the path portion + * of the URL if the hostRule matches the URL's host portion. * * Generated from protobuf field optional string path_matcher = 337813272; * @param string $var diff --git a/Compute/src/V1/HttpFaultAbort.php b/Compute/src/V1/HttpFaultAbort.php index 21e0dd19ac84..2688526537af 100644 --- a/Compute/src/V1/HttpFaultAbort.php +++ b/Compute/src/V1/HttpFaultAbort.php @@ -16,13 +16,21 @@ class HttpFaultAbort extends \Google\Protobuf\Internal\Message { /** - * The HTTP status code used to abort the request. The value must be from 200 to 599 inclusive. For gRPC protocol, the gRPC status code is mapped to HTTP status code according to this mapping table. HTTP status 200 is mapped to gRPC status UNKNOWN. Injecting an OK status is currently not supported by Traffic Director. + * The HTTP status code used to abort the request. + * The value must be from 200 to 599 inclusive. + * For gRPC protocol, the gRPC status code is mapped to HTTP status code + * according to this + * mapping table. HTTP status 200 is mapped to gRPC status + * UNKNOWN. Injecting an OK status is currently not supported by + * Traffic Director. * * Generated from protobuf field optional uint32 http_status = 468949897; */ protected $http_status = null; /** - * The percentage of traffic for connections, operations, or requests that is aborted as part of fault injection. The value must be from 0.0 to 100.0 inclusive. + * The percentage of traffic for connections, operations, or requests + * that is aborted as part of fault injection. + * The value must be from 0.0 to 100.0 inclusive. * * Generated from protobuf field optional double percentage = 151909018; */ @@ -35,9 +43,17 @@ class HttpFaultAbort extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type int $http_status - * The HTTP status code used to abort the request. The value must be from 200 to 599 inclusive. For gRPC protocol, the gRPC status code is mapped to HTTP status code according to this mapping table. HTTP status 200 is mapped to gRPC status UNKNOWN. Injecting an OK status is currently not supported by Traffic Director. + * The HTTP status code used to abort the request. + * The value must be from 200 to 599 inclusive. + * For gRPC protocol, the gRPC status code is mapped to HTTP status code + * according to this + * mapping table. HTTP status 200 is mapped to gRPC status + * UNKNOWN. Injecting an OK status is currently not supported by + * Traffic Director. * @type float $percentage - * The percentage of traffic for connections, operations, or requests that is aborted as part of fault injection. The value must be from 0.0 to 100.0 inclusive. + * The percentage of traffic for connections, operations, or requests + * that is aborted as part of fault injection. + * The value must be from 0.0 to 100.0 inclusive. * } */ public function __construct($data = NULL) { @@ -46,7 +62,13 @@ public function __construct($data = NULL) { } /** - * The HTTP status code used to abort the request. The value must be from 200 to 599 inclusive. For gRPC protocol, the gRPC status code is mapped to HTTP status code according to this mapping table. HTTP status 200 is mapped to gRPC status UNKNOWN. Injecting an OK status is currently not supported by Traffic Director. + * The HTTP status code used to abort the request. + * The value must be from 200 to 599 inclusive. + * For gRPC protocol, the gRPC status code is mapped to HTTP status code + * according to this + * mapping table. HTTP status 200 is mapped to gRPC status + * UNKNOWN. Injecting an OK status is currently not supported by + * Traffic Director. * * Generated from protobuf field optional uint32 http_status = 468949897; * @return int @@ -67,7 +89,13 @@ public function clearHttpStatus() } /** - * The HTTP status code used to abort the request. The value must be from 200 to 599 inclusive. For gRPC protocol, the gRPC status code is mapped to HTTP status code according to this mapping table. HTTP status 200 is mapped to gRPC status UNKNOWN. Injecting an OK status is currently not supported by Traffic Director. + * The HTTP status code used to abort the request. + * The value must be from 200 to 599 inclusive. + * For gRPC protocol, the gRPC status code is mapped to HTTP status code + * according to this + * mapping table. HTTP status 200 is mapped to gRPC status + * UNKNOWN. Injecting an OK status is currently not supported by + * Traffic Director. * * Generated from protobuf field optional uint32 http_status = 468949897; * @param int $var @@ -82,7 +110,9 @@ public function setHttpStatus($var) } /** - * The percentage of traffic for connections, operations, or requests that is aborted as part of fault injection. The value must be from 0.0 to 100.0 inclusive. + * The percentage of traffic for connections, operations, or requests + * that is aborted as part of fault injection. + * The value must be from 0.0 to 100.0 inclusive. * * Generated from protobuf field optional double percentage = 151909018; * @return float @@ -103,7 +133,9 @@ public function clearPercentage() } /** - * The percentage of traffic for connections, operations, or requests that is aborted as part of fault injection. The value must be from 0.0 to 100.0 inclusive. + * The percentage of traffic for connections, operations, or requests + * that is aborted as part of fault injection. + * The value must be from 0.0 to 100.0 inclusive. * * Generated from protobuf field optional double percentage = 151909018; * @param float $var diff --git a/Compute/src/V1/HttpFaultDelay.php b/Compute/src/V1/HttpFaultDelay.php index eff29236d3f8..8f240268ff60 100644 --- a/Compute/src/V1/HttpFaultDelay.php +++ b/Compute/src/V1/HttpFaultDelay.php @@ -9,7 +9,8 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Specifies the delay introduced by the load balancer before forwarding the request to the backend service as part of fault injection. + * Specifies the delay introduced by the load balancer before forwarding the + * request to the backend service as part of fault injection. * * Generated from protobuf message google.cloud.compute.v1.HttpFaultDelay */ @@ -22,7 +23,9 @@ class HttpFaultDelay extends \Google\Protobuf\Internal\Message */ protected $fixed_delay = null; /** - * The percentage of traffic for connections, operations, or requests for which a delay is introduced as part of fault injection. The value must be from 0.0 to 100.0 inclusive. + * The percentage of traffic for connections, operations, or requests for + * which a delay is introduced as part of fault injection. + * The value must be from 0.0 to 100.0 inclusive. * * Generated from protobuf field optional double percentage = 151909018; */ @@ -37,7 +40,9 @@ class HttpFaultDelay extends \Google\Protobuf\Internal\Message * @type \Google\Cloud\Compute\V1\Duration $fixed_delay * Specifies the value of the fixed delay interval. * @type float $percentage - * The percentage of traffic for connections, operations, or requests for which a delay is introduced as part of fault injection. The value must be from 0.0 to 100.0 inclusive. + * The percentage of traffic for connections, operations, or requests for + * which a delay is introduced as part of fault injection. + * The value must be from 0.0 to 100.0 inclusive. * } */ public function __construct($data = NULL) { @@ -82,7 +87,9 @@ public function setFixedDelay($var) } /** - * The percentage of traffic for connections, operations, or requests for which a delay is introduced as part of fault injection. The value must be from 0.0 to 100.0 inclusive. + * The percentage of traffic for connections, operations, or requests for + * which a delay is introduced as part of fault injection. + * The value must be from 0.0 to 100.0 inclusive. * * Generated from protobuf field optional double percentage = 151909018; * @return float @@ -103,7 +110,9 @@ public function clearPercentage() } /** - * The percentage of traffic for connections, operations, or requests for which a delay is introduced as part of fault injection. The value must be from 0.0 to 100.0 inclusive. + * The percentage of traffic for connections, operations, or requests for + * which a delay is introduced as part of fault injection. + * The value must be from 0.0 to 100.0 inclusive. * * Generated from protobuf field optional double percentage = 151909018; * @param float $var diff --git a/Compute/src/V1/HttpFaultInjection.php b/Compute/src/V1/HttpFaultInjection.php index 20f4eb1c2046..db765bf0d8da 100644 --- a/Compute/src/V1/HttpFaultInjection.php +++ b/Compute/src/V1/HttpFaultInjection.php @@ -9,20 +9,27 @@ use Google\Protobuf\Internal\GPBUtil; /** - * The specification for fault injection introduced into traffic to test the resiliency of clients to backend service failure. As part of fault injection, when clients send requests to a backend service, delays can be introduced by the load balancer on a percentage of requests before sending those request to the backend service. Similarly requests from clients can be aborted by the load balancer for a percentage of requests. + * The specification for fault injection introduced into traffic to test + * the resiliency of clients to backend service failure. As part of fault + * injection, when clients send requests to a backend service, delays can be + * introduced by the load balancer on a percentage of requests before sending + * those request to the backend service. Similarly requests from clients can be + * aborted by the load balancer for a percentage of requests. * * Generated from protobuf message google.cloud.compute.v1.HttpFaultInjection */ class HttpFaultInjection extends \Google\Protobuf\Internal\Message { /** - * The specification for how client requests are aborted as part of fault injection. + * The specification for how client requests are aborted as part of fault + * injection. * * Generated from protobuf field optional .google.cloud.compute.v1.HttpFaultAbort abort = 92611376; */ protected $abort = null; /** - * The specification for how client requests are delayed as part of fault injection, before being sent to a backend service. + * The specification for how client requests are delayed as part of fault + * injection, before being sent to a backend service. * * Generated from protobuf field optional .google.cloud.compute.v1.HttpFaultDelay delay = 95467907; */ @@ -35,9 +42,11 @@ class HttpFaultInjection extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type \Google\Cloud\Compute\V1\HttpFaultAbort $abort - * The specification for how client requests are aborted as part of fault injection. + * The specification for how client requests are aborted as part of fault + * injection. * @type \Google\Cloud\Compute\V1\HttpFaultDelay $delay - * The specification for how client requests are delayed as part of fault injection, before being sent to a backend service. + * The specification for how client requests are delayed as part of fault + * injection, before being sent to a backend service. * } */ public function __construct($data = NULL) { @@ -46,7 +55,8 @@ public function __construct($data = NULL) { } /** - * The specification for how client requests are aborted as part of fault injection. + * The specification for how client requests are aborted as part of fault + * injection. * * Generated from protobuf field optional .google.cloud.compute.v1.HttpFaultAbort abort = 92611376; * @return \Google\Cloud\Compute\V1\HttpFaultAbort|null @@ -67,7 +77,8 @@ public function clearAbort() } /** - * The specification for how client requests are aborted as part of fault injection. + * The specification for how client requests are aborted as part of fault + * injection. * * Generated from protobuf field optional .google.cloud.compute.v1.HttpFaultAbort abort = 92611376; * @param \Google\Cloud\Compute\V1\HttpFaultAbort $var @@ -82,7 +93,8 @@ public function setAbort($var) } /** - * The specification for how client requests are delayed as part of fault injection, before being sent to a backend service. + * The specification for how client requests are delayed as part of fault + * injection, before being sent to a backend service. * * Generated from protobuf field optional .google.cloud.compute.v1.HttpFaultDelay delay = 95467907; * @return \Google\Cloud\Compute\V1\HttpFaultDelay|null @@ -103,7 +115,8 @@ public function clearDelay() } /** - * The specification for how client requests are delayed as part of fault injection, before being sent to a backend service. + * The specification for how client requests are delayed as part of fault + * injection, before being sent to a backend service. * * Generated from protobuf field optional .google.cloud.compute.v1.HttpFaultDelay delay = 95467907; * @param \Google\Cloud\Compute\V1\HttpFaultDelay $var diff --git a/Compute/src/V1/HttpHeaderAction.php b/Compute/src/V1/HttpHeaderAction.php index 476f01d24097..094e6e0573e9 100644 --- a/Compute/src/V1/HttpHeaderAction.php +++ b/Compute/src/V1/HttpHeaderAction.php @@ -9,32 +9,36 @@ use Google\Protobuf\Internal\GPBUtil; /** - * The request and response header transformations that take effect before the request is passed along to the selected backendService. + * The request and response header transformations that take effect before + * the request is passed along to the selected backendService. * * Generated from protobuf message google.cloud.compute.v1.HttpHeaderAction */ class HttpHeaderAction extends \Google\Protobuf\Internal\Message { /** - * Headers to add to a matching request before forwarding the request to the backendService. + * Headers to add to a matching request before forwarding the request to thebackendService. * * Generated from protobuf field repeated .google.cloud.compute.v1.HttpHeaderOption request_headers_to_add = 72111974; */ private $request_headers_to_add; /** - * A list of header names for headers that need to be removed from the request before forwarding the request to the backendService. + * A list of header names for headers that need to be removed from the + * request before forwarding the request to the backendService. * * Generated from protobuf field repeated string request_headers_to_remove = 218425247; */ private $request_headers_to_remove; /** - * Headers to add the response before sending the response back to the client. + * Headers to add the response before sending the response back to the + * client. * * Generated from protobuf field repeated .google.cloud.compute.v1.HttpHeaderOption response_headers_to_add = 32136052; */ private $response_headers_to_add; /** - * A list of header names for headers that need to be removed from the response before sending the response back to the client. + * A list of header names for headers that need to be removed from the + * response before sending the response back to the client. * * Generated from protobuf field repeated string response_headers_to_remove = 75415761; */ @@ -47,13 +51,16 @@ class HttpHeaderAction extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type array<\Google\Cloud\Compute\V1\HttpHeaderOption>|\Google\Protobuf\Internal\RepeatedField $request_headers_to_add - * Headers to add to a matching request before forwarding the request to the backendService. + * Headers to add to a matching request before forwarding the request to thebackendService. * @type array|\Google\Protobuf\Internal\RepeatedField $request_headers_to_remove - * A list of header names for headers that need to be removed from the request before forwarding the request to the backendService. + * A list of header names for headers that need to be removed from the + * request before forwarding the request to the backendService. * @type array<\Google\Cloud\Compute\V1\HttpHeaderOption>|\Google\Protobuf\Internal\RepeatedField $response_headers_to_add - * Headers to add the response before sending the response back to the client. + * Headers to add the response before sending the response back to the + * client. * @type array|\Google\Protobuf\Internal\RepeatedField $response_headers_to_remove - * A list of header names for headers that need to be removed from the response before sending the response back to the client. + * A list of header names for headers that need to be removed from the + * response before sending the response back to the client. * } */ public function __construct($data = NULL) { @@ -62,7 +69,7 @@ public function __construct($data = NULL) { } /** - * Headers to add to a matching request before forwarding the request to the backendService. + * Headers to add to a matching request before forwarding the request to thebackendService. * * Generated from protobuf field repeated .google.cloud.compute.v1.HttpHeaderOption request_headers_to_add = 72111974; * @return \Google\Protobuf\Internal\RepeatedField @@ -73,7 +80,7 @@ public function getRequestHeadersToAdd() } /** - * Headers to add to a matching request before forwarding the request to the backendService. + * Headers to add to a matching request before forwarding the request to thebackendService. * * Generated from protobuf field repeated .google.cloud.compute.v1.HttpHeaderOption request_headers_to_add = 72111974; * @param array<\Google\Cloud\Compute\V1\HttpHeaderOption>|\Google\Protobuf\Internal\RepeatedField $var @@ -88,7 +95,8 @@ public function setRequestHeadersToAdd($var) } /** - * A list of header names for headers that need to be removed from the request before forwarding the request to the backendService. + * A list of header names for headers that need to be removed from the + * request before forwarding the request to the backendService. * * Generated from protobuf field repeated string request_headers_to_remove = 218425247; * @return \Google\Protobuf\Internal\RepeatedField @@ -99,7 +107,8 @@ public function getRequestHeadersToRemove() } /** - * A list of header names for headers that need to be removed from the request before forwarding the request to the backendService. + * A list of header names for headers that need to be removed from the + * request before forwarding the request to the backendService. * * Generated from protobuf field repeated string request_headers_to_remove = 218425247; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -114,7 +123,8 @@ public function setRequestHeadersToRemove($var) } /** - * Headers to add the response before sending the response back to the client. + * Headers to add the response before sending the response back to the + * client. * * Generated from protobuf field repeated .google.cloud.compute.v1.HttpHeaderOption response_headers_to_add = 32136052; * @return \Google\Protobuf\Internal\RepeatedField @@ -125,7 +135,8 @@ public function getResponseHeadersToAdd() } /** - * Headers to add the response before sending the response back to the client. + * Headers to add the response before sending the response back to the + * client. * * Generated from protobuf field repeated .google.cloud.compute.v1.HttpHeaderOption response_headers_to_add = 32136052; * @param array<\Google\Cloud\Compute\V1\HttpHeaderOption>|\Google\Protobuf\Internal\RepeatedField $var @@ -140,7 +151,8 @@ public function setResponseHeadersToAdd($var) } /** - * A list of header names for headers that need to be removed from the response before sending the response back to the client. + * A list of header names for headers that need to be removed from the + * response before sending the response back to the client. * * Generated from protobuf field repeated string response_headers_to_remove = 75415761; * @return \Google\Protobuf\Internal\RepeatedField @@ -151,7 +163,8 @@ public function getResponseHeadersToRemove() } /** - * A list of header names for headers that need to be removed from the response before sending the response back to the client. + * A list of header names for headers that need to be removed from the + * response before sending the response back to the client. * * Generated from protobuf field repeated string response_headers_to_remove = 75415761; * @param array|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/HttpHeaderMatch.php b/Compute/src/V1/HttpHeaderMatch.php index 76137301c6a5..db3d1e7cba91 100644 --- a/Compute/src/V1/HttpHeaderMatch.php +++ b/Compute/src/V1/HttpHeaderMatch.php @@ -16,49 +16,88 @@ class HttpHeaderMatch extends \Google\Protobuf\Internal\Message { /** - * The value should exactly match contents of exactMatch. Only one of exactMatch, prefixMatch, suffixMatch, regexMatch, presentMatch or rangeMatch must be set. + * The value should exactly match contents of exactMatch. + * Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set. * * Generated from protobuf field optional string exact_match = 457641093; */ protected $exact_match = null; /** - * The name of the HTTP header to match. For matching against the HTTP request's authority, use a headerMatch with the header name ":authority". For matching a request's method, use the headerName ":method". When the URL map is bound to a target gRPC proxy that has the validateForProxyless field set to true, only non-binary user-specified custom metadata and the `content-type` header are supported. The following transport-level headers cannot be used in header matching rules: `:authority`, `:method`, `:path`, `:scheme`, `user-agent`, `accept-encoding`, `content-encoding`, `grpc-accept-encoding`, `grpc-encoding`, `grpc-previous-rpc-attempts`, `grpc-tags-bin`, `grpc-timeout` and `grpc-trace-bin`. + * The name of the HTTP header to match. + * For matching against the HTTP request's authority, use a headerMatch + * with the header name ":authority". + * For matching a request's method, use the headerName ":method". + * When the URL map is bound to a target gRPC proxy that has + * the validateForProxyless field set to true, only + * non-binary + * user-specified custom metadata and the `content-type` header are supported. + * The following transport-level headers cannot be used in header matching + * rules: + * `:authority`, `:method`, `:path`, `:scheme`, `user-agent`, + * `accept-encoding`, `content-encoding`, `grpc-accept-encoding`, + * `grpc-encoding`, `grpc-previous-rpc-attempts`, `grpc-tags-bin`, + * `grpc-timeout` and `grpc-trace-bin`. * * Generated from protobuf field optional string header_name = 110223613; */ protected $header_name = null; /** - * If set to false, the headerMatch is considered a match if the preceding match criteria are met. If set to true, the headerMatch is considered a match if the preceding match criteria are NOT met. The default setting is false. + * If set to false, the headerMatch is considered a + * match if the preceding match criteria are met. If set to true, + * the headerMatch is considered a match if the preceding + * match criteria are NOT met. + * The default setting is false. * * Generated from protobuf field optional bool invert_match = 501130268; */ protected $invert_match = null; /** - * The value of the header must start with the contents of prefixMatch. Only one of exactMatch, prefixMatch, suffixMatch, regexMatch, presentMatch or rangeMatch must be set. + * The value of the header must start with the contents ofprefixMatch. + * Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set. * * Generated from protobuf field optional string prefix_match = 257898968; */ protected $prefix_match = null; /** - * A header with the contents of headerName must exist. The match takes place whether or not the request's header has a value. Only one of exactMatch, prefixMatch, suffixMatch, regexMatch, presentMatch or rangeMatch must be set. + * A header with the contents of headerName must exist. The + * match takes place whether or not the request's header has a value. + * Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set. * * Generated from protobuf field optional bool present_match = 67435841; */ protected $present_match = null; /** - * The header value must be an integer and its value must be in the range specified in rangeMatch. If the header does not contain an integer, number or is empty, the match fails. For example for a range [-5, 0] - -3 will match. - 0 will not match. - 0.25 will not match. - -3someString will not match. Only one of exactMatch, prefixMatch, suffixMatch, regexMatch, presentMatch or rangeMatch must be set. rangeMatch is not supported for load balancers that have loadBalancingScheme set to EXTERNAL. + * The header value must be an integer and its value must be in the range + * specified in rangeMatch. If the header does not contain an + * integer, number or is empty, the match fails. + * For example for a range [-5, 0] + * - -3 will match. + * - 0 will not match. + * - 0.25 will not match. + * - -3someString will not match. + * Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set. + * rangeMatch is not supported for load balancers + * that have loadBalancingScheme set to EXTERNAL. * * Generated from protobuf field optional .google.cloud.compute.v1.Int64RangeMatch range_match = 97244227; */ protected $range_match = null; /** - * The value of the header must match the regular expression specified in regexMatch. For more information about regular expression syntax, see Syntax. For matching against a port specified in the HTTP request, use a headerMatch with headerName set to PORT and a regular expression that satisfies the RFC2616 Host header's port specifier. Only one of exactMatch, prefixMatch, suffixMatch, regexMatch, presentMatch or rangeMatch must be set. Regular expressions can only be used when the loadBalancingScheme is set to INTERNAL_SELF_MANAGED. + * The value of the header must match the regular expression specified inregexMatch. + * For more information about regular expression syntax, see Syntax. + * For matching against a port specified in the HTTP request, use a + * headerMatch with headerName set to PORT and a regular expression that + * satisfies the RFC2616 Host header's port specifier. + * Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set. + * Regular expressions can only be used when the loadBalancingScheme is + * set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED orINTERNAL_MANAGED. * * Generated from protobuf field optional string regex_match = 107387853; */ protected $regex_match = null; /** - * The value of the header must end with the contents of suffixMatch. Only one of exactMatch, prefixMatch, suffixMatch, regexMatch, presentMatch or rangeMatch must be set. + * The value of the header must end with the contents ofsuffixMatch. + * Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set. * * Generated from protobuf field optional string suffix_match = 426488663; */ @@ -71,21 +110,60 @@ class HttpHeaderMatch extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $exact_match - * The value should exactly match contents of exactMatch. Only one of exactMatch, prefixMatch, suffixMatch, regexMatch, presentMatch or rangeMatch must be set. + * The value should exactly match contents of exactMatch. + * Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set. * @type string $header_name - * The name of the HTTP header to match. For matching against the HTTP request's authority, use a headerMatch with the header name ":authority". For matching a request's method, use the headerName ":method". When the URL map is bound to a target gRPC proxy that has the validateForProxyless field set to true, only non-binary user-specified custom metadata and the `content-type` header are supported. The following transport-level headers cannot be used in header matching rules: `:authority`, `:method`, `:path`, `:scheme`, `user-agent`, `accept-encoding`, `content-encoding`, `grpc-accept-encoding`, `grpc-encoding`, `grpc-previous-rpc-attempts`, `grpc-tags-bin`, `grpc-timeout` and `grpc-trace-bin`. + * The name of the HTTP header to match. + * For matching against the HTTP request's authority, use a headerMatch + * with the header name ":authority". + * For matching a request's method, use the headerName ":method". + * When the URL map is bound to a target gRPC proxy that has + * the validateForProxyless field set to true, only + * non-binary + * user-specified custom metadata and the `content-type` header are supported. + * The following transport-level headers cannot be used in header matching + * rules: + * `:authority`, `:method`, `:path`, `:scheme`, `user-agent`, + * `accept-encoding`, `content-encoding`, `grpc-accept-encoding`, + * `grpc-encoding`, `grpc-previous-rpc-attempts`, `grpc-tags-bin`, + * `grpc-timeout` and `grpc-trace-bin`. * @type bool $invert_match - * If set to false, the headerMatch is considered a match if the preceding match criteria are met. If set to true, the headerMatch is considered a match if the preceding match criteria are NOT met. The default setting is false. + * If set to false, the headerMatch is considered a + * match if the preceding match criteria are met. If set to true, + * the headerMatch is considered a match if the preceding + * match criteria are NOT met. + * The default setting is false. * @type string $prefix_match - * The value of the header must start with the contents of prefixMatch. Only one of exactMatch, prefixMatch, suffixMatch, regexMatch, presentMatch or rangeMatch must be set. + * The value of the header must start with the contents ofprefixMatch. + * Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set. * @type bool $present_match - * A header with the contents of headerName must exist. The match takes place whether or not the request's header has a value. Only one of exactMatch, prefixMatch, suffixMatch, regexMatch, presentMatch or rangeMatch must be set. + * A header with the contents of headerName must exist. The + * match takes place whether or not the request's header has a value. + * Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set. * @type \Google\Cloud\Compute\V1\Int64RangeMatch $range_match - * The header value must be an integer and its value must be in the range specified in rangeMatch. If the header does not contain an integer, number or is empty, the match fails. For example for a range [-5, 0] - -3 will match. - 0 will not match. - 0.25 will not match. - -3someString will not match. Only one of exactMatch, prefixMatch, suffixMatch, regexMatch, presentMatch or rangeMatch must be set. rangeMatch is not supported for load balancers that have loadBalancingScheme set to EXTERNAL. + * The header value must be an integer and its value must be in the range + * specified in rangeMatch. If the header does not contain an + * integer, number or is empty, the match fails. + * For example for a range [-5, 0] + * - -3 will match. + * - 0 will not match. + * - 0.25 will not match. + * - -3someString will not match. + * Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set. + * rangeMatch is not supported for load balancers + * that have loadBalancingScheme set to EXTERNAL. * @type string $regex_match - * The value of the header must match the regular expression specified in regexMatch. For more information about regular expression syntax, see Syntax. For matching against a port specified in the HTTP request, use a headerMatch with headerName set to PORT and a regular expression that satisfies the RFC2616 Host header's port specifier. Only one of exactMatch, prefixMatch, suffixMatch, regexMatch, presentMatch or rangeMatch must be set. Regular expressions can only be used when the loadBalancingScheme is set to INTERNAL_SELF_MANAGED. + * The value of the header must match the regular expression specified inregexMatch. + * For more information about regular expression syntax, see Syntax. + * For matching against a port specified in the HTTP request, use a + * headerMatch with headerName set to PORT and a regular expression that + * satisfies the RFC2616 Host header's port specifier. + * Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set. + * Regular expressions can only be used when the loadBalancingScheme is + * set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED orINTERNAL_MANAGED. * @type string $suffix_match - * The value of the header must end with the contents of suffixMatch. Only one of exactMatch, prefixMatch, suffixMatch, regexMatch, presentMatch or rangeMatch must be set. + * The value of the header must end with the contents ofsuffixMatch. + * Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set. * } */ public function __construct($data = NULL) { @@ -94,7 +172,8 @@ public function __construct($data = NULL) { } /** - * The value should exactly match contents of exactMatch. Only one of exactMatch, prefixMatch, suffixMatch, regexMatch, presentMatch or rangeMatch must be set. + * The value should exactly match contents of exactMatch. + * Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set. * * Generated from protobuf field optional string exact_match = 457641093; * @return string @@ -115,7 +194,8 @@ public function clearExactMatch() } /** - * The value should exactly match contents of exactMatch. Only one of exactMatch, prefixMatch, suffixMatch, regexMatch, presentMatch or rangeMatch must be set. + * The value should exactly match contents of exactMatch. + * Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set. * * Generated from protobuf field optional string exact_match = 457641093; * @param string $var @@ -130,7 +210,20 @@ public function setExactMatch($var) } /** - * The name of the HTTP header to match. For matching against the HTTP request's authority, use a headerMatch with the header name ":authority". For matching a request's method, use the headerName ":method". When the URL map is bound to a target gRPC proxy that has the validateForProxyless field set to true, only non-binary user-specified custom metadata and the `content-type` header are supported. The following transport-level headers cannot be used in header matching rules: `:authority`, `:method`, `:path`, `:scheme`, `user-agent`, `accept-encoding`, `content-encoding`, `grpc-accept-encoding`, `grpc-encoding`, `grpc-previous-rpc-attempts`, `grpc-tags-bin`, `grpc-timeout` and `grpc-trace-bin`. + * The name of the HTTP header to match. + * For matching against the HTTP request's authority, use a headerMatch + * with the header name ":authority". + * For matching a request's method, use the headerName ":method". + * When the URL map is bound to a target gRPC proxy that has + * the validateForProxyless field set to true, only + * non-binary + * user-specified custom metadata and the `content-type` header are supported. + * The following transport-level headers cannot be used in header matching + * rules: + * `:authority`, `:method`, `:path`, `:scheme`, `user-agent`, + * `accept-encoding`, `content-encoding`, `grpc-accept-encoding`, + * `grpc-encoding`, `grpc-previous-rpc-attempts`, `grpc-tags-bin`, + * `grpc-timeout` and `grpc-trace-bin`. * * Generated from protobuf field optional string header_name = 110223613; * @return string @@ -151,7 +244,20 @@ public function clearHeaderName() } /** - * The name of the HTTP header to match. For matching against the HTTP request's authority, use a headerMatch with the header name ":authority". For matching a request's method, use the headerName ":method". When the URL map is bound to a target gRPC proxy that has the validateForProxyless field set to true, only non-binary user-specified custom metadata and the `content-type` header are supported. The following transport-level headers cannot be used in header matching rules: `:authority`, `:method`, `:path`, `:scheme`, `user-agent`, `accept-encoding`, `content-encoding`, `grpc-accept-encoding`, `grpc-encoding`, `grpc-previous-rpc-attempts`, `grpc-tags-bin`, `grpc-timeout` and `grpc-trace-bin`. + * The name of the HTTP header to match. + * For matching against the HTTP request's authority, use a headerMatch + * with the header name ":authority". + * For matching a request's method, use the headerName ":method". + * When the URL map is bound to a target gRPC proxy that has + * the validateForProxyless field set to true, only + * non-binary + * user-specified custom metadata and the `content-type` header are supported. + * The following transport-level headers cannot be used in header matching + * rules: + * `:authority`, `:method`, `:path`, `:scheme`, `user-agent`, + * `accept-encoding`, `content-encoding`, `grpc-accept-encoding`, + * `grpc-encoding`, `grpc-previous-rpc-attempts`, `grpc-tags-bin`, + * `grpc-timeout` and `grpc-trace-bin`. * * Generated from protobuf field optional string header_name = 110223613; * @param string $var @@ -166,7 +272,11 @@ public function setHeaderName($var) } /** - * If set to false, the headerMatch is considered a match if the preceding match criteria are met. If set to true, the headerMatch is considered a match if the preceding match criteria are NOT met. The default setting is false. + * If set to false, the headerMatch is considered a + * match if the preceding match criteria are met. If set to true, + * the headerMatch is considered a match if the preceding + * match criteria are NOT met. + * The default setting is false. * * Generated from protobuf field optional bool invert_match = 501130268; * @return bool @@ -187,7 +297,11 @@ public function clearInvertMatch() } /** - * If set to false, the headerMatch is considered a match if the preceding match criteria are met. If set to true, the headerMatch is considered a match if the preceding match criteria are NOT met. The default setting is false. + * If set to false, the headerMatch is considered a + * match if the preceding match criteria are met. If set to true, + * the headerMatch is considered a match if the preceding + * match criteria are NOT met. + * The default setting is false. * * Generated from protobuf field optional bool invert_match = 501130268; * @param bool $var @@ -202,7 +316,8 @@ public function setInvertMatch($var) } /** - * The value of the header must start with the contents of prefixMatch. Only one of exactMatch, prefixMatch, suffixMatch, regexMatch, presentMatch or rangeMatch must be set. + * The value of the header must start with the contents ofprefixMatch. + * Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set. * * Generated from protobuf field optional string prefix_match = 257898968; * @return string @@ -223,7 +338,8 @@ public function clearPrefixMatch() } /** - * The value of the header must start with the contents of prefixMatch. Only one of exactMatch, prefixMatch, suffixMatch, regexMatch, presentMatch or rangeMatch must be set. + * The value of the header must start with the contents ofprefixMatch. + * Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set. * * Generated from protobuf field optional string prefix_match = 257898968; * @param string $var @@ -238,7 +354,9 @@ public function setPrefixMatch($var) } /** - * A header with the contents of headerName must exist. The match takes place whether or not the request's header has a value. Only one of exactMatch, prefixMatch, suffixMatch, regexMatch, presentMatch or rangeMatch must be set. + * A header with the contents of headerName must exist. The + * match takes place whether or not the request's header has a value. + * Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set. * * Generated from protobuf field optional bool present_match = 67435841; * @return bool @@ -259,7 +377,9 @@ public function clearPresentMatch() } /** - * A header with the contents of headerName must exist. The match takes place whether or not the request's header has a value. Only one of exactMatch, prefixMatch, suffixMatch, regexMatch, presentMatch or rangeMatch must be set. + * A header with the contents of headerName must exist. The + * match takes place whether or not the request's header has a value. + * Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set. * * Generated from protobuf field optional bool present_match = 67435841; * @param bool $var @@ -274,7 +394,17 @@ public function setPresentMatch($var) } /** - * The header value must be an integer and its value must be in the range specified in rangeMatch. If the header does not contain an integer, number or is empty, the match fails. For example for a range [-5, 0] - -3 will match. - 0 will not match. - 0.25 will not match. - -3someString will not match. Only one of exactMatch, prefixMatch, suffixMatch, regexMatch, presentMatch or rangeMatch must be set. rangeMatch is not supported for load balancers that have loadBalancingScheme set to EXTERNAL. + * The header value must be an integer and its value must be in the range + * specified in rangeMatch. If the header does not contain an + * integer, number or is empty, the match fails. + * For example for a range [-5, 0] + * - -3 will match. + * - 0 will not match. + * - 0.25 will not match. + * - -3someString will not match. + * Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set. + * rangeMatch is not supported for load balancers + * that have loadBalancingScheme set to EXTERNAL. * * Generated from protobuf field optional .google.cloud.compute.v1.Int64RangeMatch range_match = 97244227; * @return \Google\Cloud\Compute\V1\Int64RangeMatch|null @@ -295,7 +425,17 @@ public function clearRangeMatch() } /** - * The header value must be an integer and its value must be in the range specified in rangeMatch. If the header does not contain an integer, number or is empty, the match fails. For example for a range [-5, 0] - -3 will match. - 0 will not match. - 0.25 will not match. - -3someString will not match. Only one of exactMatch, prefixMatch, suffixMatch, regexMatch, presentMatch or rangeMatch must be set. rangeMatch is not supported for load balancers that have loadBalancingScheme set to EXTERNAL. + * The header value must be an integer and its value must be in the range + * specified in rangeMatch. If the header does not contain an + * integer, number or is empty, the match fails. + * For example for a range [-5, 0] + * - -3 will match. + * - 0 will not match. + * - 0.25 will not match. + * - -3someString will not match. + * Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set. + * rangeMatch is not supported for load balancers + * that have loadBalancingScheme set to EXTERNAL. * * Generated from protobuf field optional .google.cloud.compute.v1.Int64RangeMatch range_match = 97244227; * @param \Google\Cloud\Compute\V1\Int64RangeMatch $var @@ -310,7 +450,14 @@ public function setRangeMatch($var) } /** - * The value of the header must match the regular expression specified in regexMatch. For more information about regular expression syntax, see Syntax. For matching against a port specified in the HTTP request, use a headerMatch with headerName set to PORT and a regular expression that satisfies the RFC2616 Host header's port specifier. Only one of exactMatch, prefixMatch, suffixMatch, regexMatch, presentMatch or rangeMatch must be set. Regular expressions can only be used when the loadBalancingScheme is set to INTERNAL_SELF_MANAGED. + * The value of the header must match the regular expression specified inregexMatch. + * For more information about regular expression syntax, see Syntax. + * For matching against a port specified in the HTTP request, use a + * headerMatch with headerName set to PORT and a regular expression that + * satisfies the RFC2616 Host header's port specifier. + * Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set. + * Regular expressions can only be used when the loadBalancingScheme is + * set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED orINTERNAL_MANAGED. * * Generated from protobuf field optional string regex_match = 107387853; * @return string @@ -331,7 +478,14 @@ public function clearRegexMatch() } /** - * The value of the header must match the regular expression specified in regexMatch. For more information about regular expression syntax, see Syntax. For matching against a port specified in the HTTP request, use a headerMatch with headerName set to PORT and a regular expression that satisfies the RFC2616 Host header's port specifier. Only one of exactMatch, prefixMatch, suffixMatch, regexMatch, presentMatch or rangeMatch must be set. Regular expressions can only be used when the loadBalancingScheme is set to INTERNAL_SELF_MANAGED. + * The value of the header must match the regular expression specified inregexMatch. + * For more information about regular expression syntax, see Syntax. + * For matching against a port specified in the HTTP request, use a + * headerMatch with headerName set to PORT and a regular expression that + * satisfies the RFC2616 Host header's port specifier. + * Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set. + * Regular expressions can only be used when the loadBalancingScheme is + * set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED orINTERNAL_MANAGED. * * Generated from protobuf field optional string regex_match = 107387853; * @param string $var @@ -346,7 +500,8 @@ public function setRegexMatch($var) } /** - * The value of the header must end with the contents of suffixMatch. Only one of exactMatch, prefixMatch, suffixMatch, regexMatch, presentMatch or rangeMatch must be set. + * The value of the header must end with the contents ofsuffixMatch. + * Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set. * * Generated from protobuf field optional string suffix_match = 426488663; * @return string @@ -367,7 +522,8 @@ public function clearSuffixMatch() } /** - * The value of the header must end with the contents of suffixMatch. Only one of exactMatch, prefixMatch, suffixMatch, regexMatch, presentMatch or rangeMatch must be set. + * The value of the header must end with the contents ofsuffixMatch. + * Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set. * * Generated from protobuf field optional string suffix_match = 426488663; * @param string $var diff --git a/Compute/src/V1/HttpHeaderOption.php b/Compute/src/V1/HttpHeaderOption.php index 91db700f1f7b..d82e960fd5f0 100644 --- a/Compute/src/V1/HttpHeaderOption.php +++ b/Compute/src/V1/HttpHeaderOption.php @@ -28,7 +28,14 @@ class HttpHeaderOption extends \Google\Protobuf\Internal\Message */ protected $header_value = null; /** - * If false, headerValue is appended to any values that already exist for the header. If true, headerValue is set for the header, discarding any values that were set for that header. The default value is true, unless a variable is present in headerValue, in which case the default value is false. . + * If false, headerValue is appended to any values + * that already + * exist for the header. If true, headerValue is set for the + * header, discarding any values that were set for that header. + * The default value is true, + * unless a variable is present in headerValue, + * in which case the default value is false. + * . * * Generated from protobuf field optional bool replace = 20755124; */ @@ -45,7 +52,14 @@ class HttpHeaderOption extends \Google\Protobuf\Internal\Message * @type string $header_value * The value of the header to add. * @type bool $replace - * If false, headerValue is appended to any values that already exist for the header. If true, headerValue is set for the header, discarding any values that were set for that header. The default value is true, unless a variable is present in headerValue, in which case the default value is false. . + * If false, headerValue is appended to any values + * that already + * exist for the header. If true, headerValue is set for the + * header, discarding any values that were set for that header. + * The default value is true, + * unless a variable is present in headerValue, + * in which case the default value is false. + * . * } */ public function __construct($data = NULL) { @@ -126,7 +140,14 @@ public function setHeaderValue($var) } /** - * If false, headerValue is appended to any values that already exist for the header. If true, headerValue is set for the header, discarding any values that were set for that header. The default value is true, unless a variable is present in headerValue, in which case the default value is false. . + * If false, headerValue is appended to any values + * that already + * exist for the header. If true, headerValue is set for the + * header, discarding any values that were set for that header. + * The default value is true, + * unless a variable is present in headerValue, + * in which case the default value is false. + * . * * Generated from protobuf field optional bool replace = 20755124; * @return bool @@ -147,7 +168,14 @@ public function clearReplace() } /** - * If false, headerValue is appended to any values that already exist for the header. If true, headerValue is set for the header, discarding any values that were set for that header. The default value is true, unless a variable is present in headerValue, in which case the default value is false. . + * If false, headerValue is appended to any values + * that already + * exist for the header. If true, headerValue is set for the + * header, discarding any values that were set for that header. + * The default value is true, + * unless a variable is present in headerValue, + * in which case the default value is false. + * . * * Generated from protobuf field optional bool replace = 20755124; * @param bool $var diff --git a/Compute/src/V1/HttpQueryParameterMatch.php b/Compute/src/V1/HttpQueryParameterMatch.php index fceb57f346e3..16ee4dc245a6 100644 --- a/Compute/src/V1/HttpQueryParameterMatch.php +++ b/Compute/src/V1/HttpQueryParameterMatch.php @@ -16,25 +16,36 @@ class HttpQueryParameterMatch extends \Google\Protobuf\Internal\Message { /** - * The queryParameterMatch matches if the value of the parameter exactly matches the contents of exactMatch. Only one of presentMatch, exactMatch, or regexMatch must be set. + * The queryParameterMatch matches if the value of the + * parameter exactly matches the contents of exactMatch. + * Only one of presentMatch, exactMatch, orregexMatch must be set. * * Generated from protobuf field optional string exact_match = 457641093; */ protected $exact_match = null; /** - * The name of the query parameter to match. The query parameter must exist in the request, in the absence of which the request match fails. + * The name of the query parameter to match. The query parameter must exist in + * the request, in the absence of which the request match fails. * * Generated from protobuf field optional string name = 3373707; */ protected $name = null; /** - * Specifies that the queryParameterMatch matches if the request contains the query parameter, irrespective of whether the parameter has a value or not. Only one of presentMatch, exactMatch, or regexMatch must be set. + * Specifies that the queryParameterMatch matches if the + * request contains the query parameter, irrespective of whether the + * parameter has a value or not. + * Only one of presentMatch, exactMatch, orregexMatch must be set. * * Generated from protobuf field optional bool present_match = 67435841; */ protected $present_match = null; /** - * The queryParameterMatch matches if the value of the parameter matches the regular expression specified by regexMatch. For more information about regular expression syntax, see Syntax. Only one of presentMatch, exactMatch, or regexMatch must be set. Regular expressions can only be used when the loadBalancingScheme is set to INTERNAL_SELF_MANAGED. + * The queryParameterMatch matches if the value of the + * parameter matches the regular expression specified byregexMatch. For + * more information about regular expression syntax, see Syntax. + * Only one of presentMatch, exactMatch, orregexMatch must be set. + * Regular expressions can only be used when the loadBalancingScheme is + * set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED orINTERNAL_MANAGED. * * Generated from protobuf field optional string regex_match = 107387853; */ @@ -47,13 +58,24 @@ class HttpQueryParameterMatch extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $exact_match - * The queryParameterMatch matches if the value of the parameter exactly matches the contents of exactMatch. Only one of presentMatch, exactMatch, or regexMatch must be set. + * The queryParameterMatch matches if the value of the + * parameter exactly matches the contents of exactMatch. + * Only one of presentMatch, exactMatch, orregexMatch must be set. * @type string $name - * The name of the query parameter to match. The query parameter must exist in the request, in the absence of which the request match fails. + * The name of the query parameter to match. The query parameter must exist in + * the request, in the absence of which the request match fails. * @type bool $present_match - * Specifies that the queryParameterMatch matches if the request contains the query parameter, irrespective of whether the parameter has a value or not. Only one of presentMatch, exactMatch, or regexMatch must be set. + * Specifies that the queryParameterMatch matches if the + * request contains the query parameter, irrespective of whether the + * parameter has a value or not. + * Only one of presentMatch, exactMatch, orregexMatch must be set. * @type string $regex_match - * The queryParameterMatch matches if the value of the parameter matches the regular expression specified by regexMatch. For more information about regular expression syntax, see Syntax. Only one of presentMatch, exactMatch, or regexMatch must be set. Regular expressions can only be used when the loadBalancingScheme is set to INTERNAL_SELF_MANAGED. + * The queryParameterMatch matches if the value of the + * parameter matches the regular expression specified byregexMatch. For + * more information about regular expression syntax, see Syntax. + * Only one of presentMatch, exactMatch, orregexMatch must be set. + * Regular expressions can only be used when the loadBalancingScheme is + * set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED orINTERNAL_MANAGED. * } */ public function __construct($data = NULL) { @@ -62,7 +84,9 @@ public function __construct($data = NULL) { } /** - * The queryParameterMatch matches if the value of the parameter exactly matches the contents of exactMatch. Only one of presentMatch, exactMatch, or regexMatch must be set. + * The queryParameterMatch matches if the value of the + * parameter exactly matches the contents of exactMatch. + * Only one of presentMatch, exactMatch, orregexMatch must be set. * * Generated from protobuf field optional string exact_match = 457641093; * @return string @@ -83,7 +107,9 @@ public function clearExactMatch() } /** - * The queryParameterMatch matches if the value of the parameter exactly matches the contents of exactMatch. Only one of presentMatch, exactMatch, or regexMatch must be set. + * The queryParameterMatch matches if the value of the + * parameter exactly matches the contents of exactMatch. + * Only one of presentMatch, exactMatch, orregexMatch must be set. * * Generated from protobuf field optional string exact_match = 457641093; * @param string $var @@ -98,7 +124,8 @@ public function setExactMatch($var) } /** - * The name of the query parameter to match. The query parameter must exist in the request, in the absence of which the request match fails. + * The name of the query parameter to match. The query parameter must exist in + * the request, in the absence of which the request match fails. * * Generated from protobuf field optional string name = 3373707; * @return string @@ -119,7 +146,8 @@ public function clearName() } /** - * The name of the query parameter to match. The query parameter must exist in the request, in the absence of which the request match fails. + * The name of the query parameter to match. The query parameter must exist in + * the request, in the absence of which the request match fails. * * Generated from protobuf field optional string name = 3373707; * @param string $var @@ -134,7 +162,10 @@ public function setName($var) } /** - * Specifies that the queryParameterMatch matches if the request contains the query parameter, irrespective of whether the parameter has a value or not. Only one of presentMatch, exactMatch, or regexMatch must be set. + * Specifies that the queryParameterMatch matches if the + * request contains the query parameter, irrespective of whether the + * parameter has a value or not. + * Only one of presentMatch, exactMatch, orregexMatch must be set. * * Generated from protobuf field optional bool present_match = 67435841; * @return bool @@ -155,7 +186,10 @@ public function clearPresentMatch() } /** - * Specifies that the queryParameterMatch matches if the request contains the query parameter, irrespective of whether the parameter has a value or not. Only one of presentMatch, exactMatch, or regexMatch must be set. + * Specifies that the queryParameterMatch matches if the + * request contains the query parameter, irrespective of whether the + * parameter has a value or not. + * Only one of presentMatch, exactMatch, orregexMatch must be set. * * Generated from protobuf field optional bool present_match = 67435841; * @param bool $var @@ -170,7 +204,12 @@ public function setPresentMatch($var) } /** - * The queryParameterMatch matches if the value of the parameter matches the regular expression specified by regexMatch. For more information about regular expression syntax, see Syntax. Only one of presentMatch, exactMatch, or regexMatch must be set. Regular expressions can only be used when the loadBalancingScheme is set to INTERNAL_SELF_MANAGED. + * The queryParameterMatch matches if the value of the + * parameter matches the regular expression specified byregexMatch. For + * more information about regular expression syntax, see Syntax. + * Only one of presentMatch, exactMatch, orregexMatch must be set. + * Regular expressions can only be used when the loadBalancingScheme is + * set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED orINTERNAL_MANAGED. * * Generated from protobuf field optional string regex_match = 107387853; * @return string @@ -191,7 +230,12 @@ public function clearRegexMatch() } /** - * The queryParameterMatch matches if the value of the parameter matches the regular expression specified by regexMatch. For more information about regular expression syntax, see Syntax. Only one of presentMatch, exactMatch, or regexMatch must be set. Regular expressions can only be used when the loadBalancingScheme is set to INTERNAL_SELF_MANAGED. + * The queryParameterMatch matches if the value of the + * parameter matches the regular expression specified byregexMatch. For + * more information about regular expression syntax, see Syntax. + * Only one of presentMatch, exactMatch, orregexMatch must be set. + * Regular expressions can only be used when the loadBalancingScheme is + * set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED orINTERNAL_MANAGED. * * Generated from protobuf field optional string regex_match = 107387853; * @param string $var diff --git a/Compute/src/V1/HttpRedirectAction.php b/Compute/src/V1/HttpRedirectAction.php index 4f261e689719..3836958672bc 100644 --- a/Compute/src/V1/HttpRedirectAction.php +++ b/Compute/src/V1/HttpRedirectAction.php @@ -16,38 +16,68 @@ class HttpRedirectAction extends \Google\Protobuf\Internal\Message { /** - * The host that is used in the redirect response instead of the one that was supplied in the request. The value must be from 1 to 255 characters. + * The host that is used in the redirect response instead of the one that + * was supplied in the request. + * The value must be from 1 to 255 + * characters. * * Generated from protobuf field optional string host_redirect = 107417747; */ protected $host_redirect = null; /** - * If set to true, the URL scheme in the redirected request is set to HTTPS. If set to false, the URL scheme of the redirected request remains the same as that of the request. This must only be set for URL maps used in TargetHttpProxys. Setting this true for TargetHttpsProxy is not permitted. The default is set to false. + * If set to true, the URL scheme in the redirected request is + * set to HTTPS. + * If set to false, the URL scheme of the redirected request + * remains the same as that of the request. + * This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted. + * The default is set to false. * * Generated from protobuf field optional bool https_redirect = 170260656; */ protected $https_redirect = null; /** - * The path that is used in the redirect response instead of the one that was supplied in the request. pathRedirect cannot be supplied together with prefixRedirect. Supply one alone or neither. If neither is supplied, the path of the original request is used for the redirect. The value must be from 1 to 1024 characters. + * The path that is used in the redirect response instead of the one + * that was supplied in the request. + * pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is + * supplied, the path of the original request is used for the redirect. + * The value must be from 1 to 1024 characters. * * Generated from protobuf field optional string path_redirect = 272342710; */ protected $path_redirect = null; /** - * The prefix that replaces the prefixMatch specified in the HttpRouteRuleMatch, retaining the remaining portion of the URL before redirecting the request. prefixRedirect cannot be supplied together with pathRedirect. Supply one alone or neither. If neither is supplied, the path of the original request is used for the redirect. The value must be from 1 to 1024 characters. + * The prefix that replaces the prefixMatch specified in + * the HttpRouteRuleMatch, retaining the remaining portion + * of the URL before redirecting the request. + * prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is + * supplied, the path of the original request is used for the redirect. + * The value must be from 1 to 1024 characters. * * Generated from protobuf field optional string prefix_redirect = 446184169; */ protected $prefix_redirect = null; /** - * The HTTP Status code to use for this RedirectAction. Supported values are: - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds to 301. - FOUND, which corresponds to 302. - SEE_OTHER which corresponds to 303. - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request method is retained. - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request method is retained. + * The HTTP Status code to use for this RedirectAction. + * Supported values are: + * - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds + * to 301. + * - FOUND, which corresponds to 302. + * - SEE_OTHER which corresponds to 303. + * - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request + * method is retained. + * - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request + * method is retained. * Check the RedirectResponseCode enum for the list of possible values. * * Generated from protobuf field optional string redirect_response_code = 436710408; */ protected $redirect_response_code = null; /** - * If set to true, any accompanying query portion of the original URL is removed before redirecting the request. If set to false, the query portion of the original URL is retained. The default is set to false. + * If set to true, any accompanying query portion of the original + * URL is + * removed before redirecting the request. If set to false, the + * query portion of the original URL is retained. + * The default is set to false. * * Generated from protobuf field optional bool strip_query = 52284641; */ @@ -60,18 +90,48 @@ class HttpRedirectAction extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $host_redirect - * The host that is used in the redirect response instead of the one that was supplied in the request. The value must be from 1 to 255 characters. + * The host that is used in the redirect response instead of the one that + * was supplied in the request. + * The value must be from 1 to 255 + * characters. * @type bool $https_redirect - * If set to true, the URL scheme in the redirected request is set to HTTPS. If set to false, the URL scheme of the redirected request remains the same as that of the request. This must only be set for URL maps used in TargetHttpProxys. Setting this true for TargetHttpsProxy is not permitted. The default is set to false. + * If set to true, the URL scheme in the redirected request is + * set to HTTPS. + * If set to false, the URL scheme of the redirected request + * remains the same as that of the request. + * This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted. + * The default is set to false. * @type string $path_redirect - * The path that is used in the redirect response instead of the one that was supplied in the request. pathRedirect cannot be supplied together with prefixRedirect. Supply one alone or neither. If neither is supplied, the path of the original request is used for the redirect. The value must be from 1 to 1024 characters. + * The path that is used in the redirect response instead of the one + * that was supplied in the request. + * pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is + * supplied, the path of the original request is used for the redirect. + * The value must be from 1 to 1024 characters. * @type string $prefix_redirect - * The prefix that replaces the prefixMatch specified in the HttpRouteRuleMatch, retaining the remaining portion of the URL before redirecting the request. prefixRedirect cannot be supplied together with pathRedirect. Supply one alone or neither. If neither is supplied, the path of the original request is used for the redirect. The value must be from 1 to 1024 characters. + * The prefix that replaces the prefixMatch specified in + * the HttpRouteRuleMatch, retaining the remaining portion + * of the URL before redirecting the request. + * prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is + * supplied, the path of the original request is used for the redirect. + * The value must be from 1 to 1024 characters. * @type string $redirect_response_code - * The HTTP Status code to use for this RedirectAction. Supported values are: - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds to 301. - FOUND, which corresponds to 302. - SEE_OTHER which corresponds to 303. - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request method is retained. - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request method is retained. + * The HTTP Status code to use for this RedirectAction. + * Supported values are: + * - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds + * to 301. + * - FOUND, which corresponds to 302. + * - SEE_OTHER which corresponds to 303. + * - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request + * method is retained. + * - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request + * method is retained. * Check the RedirectResponseCode enum for the list of possible values. * @type bool $strip_query - * If set to true, any accompanying query portion of the original URL is removed before redirecting the request. If set to false, the query portion of the original URL is retained. The default is set to false. + * If set to true, any accompanying query portion of the original + * URL is + * removed before redirecting the request. If set to false, the + * query portion of the original URL is retained. + * The default is set to false. * } */ public function __construct($data = NULL) { @@ -80,7 +140,10 @@ public function __construct($data = NULL) { } /** - * The host that is used in the redirect response instead of the one that was supplied in the request. The value must be from 1 to 255 characters. + * The host that is used in the redirect response instead of the one that + * was supplied in the request. + * The value must be from 1 to 255 + * characters. * * Generated from protobuf field optional string host_redirect = 107417747; * @return string @@ -101,7 +164,10 @@ public function clearHostRedirect() } /** - * The host that is used in the redirect response instead of the one that was supplied in the request. The value must be from 1 to 255 characters. + * The host that is used in the redirect response instead of the one that + * was supplied in the request. + * The value must be from 1 to 255 + * characters. * * Generated from protobuf field optional string host_redirect = 107417747; * @param string $var @@ -116,7 +182,12 @@ public function setHostRedirect($var) } /** - * If set to true, the URL scheme in the redirected request is set to HTTPS. If set to false, the URL scheme of the redirected request remains the same as that of the request. This must only be set for URL maps used in TargetHttpProxys. Setting this true for TargetHttpsProxy is not permitted. The default is set to false. + * If set to true, the URL scheme in the redirected request is + * set to HTTPS. + * If set to false, the URL scheme of the redirected request + * remains the same as that of the request. + * This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted. + * The default is set to false. * * Generated from protobuf field optional bool https_redirect = 170260656; * @return bool @@ -137,7 +208,12 @@ public function clearHttpsRedirect() } /** - * If set to true, the URL scheme in the redirected request is set to HTTPS. If set to false, the URL scheme of the redirected request remains the same as that of the request. This must only be set for URL maps used in TargetHttpProxys. Setting this true for TargetHttpsProxy is not permitted. The default is set to false. + * If set to true, the URL scheme in the redirected request is + * set to HTTPS. + * If set to false, the URL scheme of the redirected request + * remains the same as that of the request. + * This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted. + * The default is set to false. * * Generated from protobuf field optional bool https_redirect = 170260656; * @param bool $var @@ -152,7 +228,11 @@ public function setHttpsRedirect($var) } /** - * The path that is used in the redirect response instead of the one that was supplied in the request. pathRedirect cannot be supplied together with prefixRedirect. Supply one alone or neither. If neither is supplied, the path of the original request is used for the redirect. The value must be from 1 to 1024 characters. + * The path that is used in the redirect response instead of the one + * that was supplied in the request. + * pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is + * supplied, the path of the original request is used for the redirect. + * The value must be from 1 to 1024 characters. * * Generated from protobuf field optional string path_redirect = 272342710; * @return string @@ -173,7 +253,11 @@ public function clearPathRedirect() } /** - * The path that is used in the redirect response instead of the one that was supplied in the request. pathRedirect cannot be supplied together with prefixRedirect. Supply one alone or neither. If neither is supplied, the path of the original request is used for the redirect. The value must be from 1 to 1024 characters. + * The path that is used in the redirect response instead of the one + * that was supplied in the request. + * pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is + * supplied, the path of the original request is used for the redirect. + * The value must be from 1 to 1024 characters. * * Generated from protobuf field optional string path_redirect = 272342710; * @param string $var @@ -188,7 +272,12 @@ public function setPathRedirect($var) } /** - * The prefix that replaces the prefixMatch specified in the HttpRouteRuleMatch, retaining the remaining portion of the URL before redirecting the request. prefixRedirect cannot be supplied together with pathRedirect. Supply one alone or neither. If neither is supplied, the path of the original request is used for the redirect. The value must be from 1 to 1024 characters. + * The prefix that replaces the prefixMatch specified in + * the HttpRouteRuleMatch, retaining the remaining portion + * of the URL before redirecting the request. + * prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is + * supplied, the path of the original request is used for the redirect. + * The value must be from 1 to 1024 characters. * * Generated from protobuf field optional string prefix_redirect = 446184169; * @return string @@ -209,7 +298,12 @@ public function clearPrefixRedirect() } /** - * The prefix that replaces the prefixMatch specified in the HttpRouteRuleMatch, retaining the remaining portion of the URL before redirecting the request. prefixRedirect cannot be supplied together with pathRedirect. Supply one alone or neither. If neither is supplied, the path of the original request is used for the redirect. The value must be from 1 to 1024 characters. + * The prefix that replaces the prefixMatch specified in + * the HttpRouteRuleMatch, retaining the remaining portion + * of the URL before redirecting the request. + * prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is + * supplied, the path of the original request is used for the redirect. + * The value must be from 1 to 1024 characters. * * Generated from protobuf field optional string prefix_redirect = 446184169; * @param string $var @@ -224,7 +318,16 @@ public function setPrefixRedirect($var) } /** - * The HTTP Status code to use for this RedirectAction. Supported values are: - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds to 301. - FOUND, which corresponds to 302. - SEE_OTHER which corresponds to 303. - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request method is retained. - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request method is retained. + * The HTTP Status code to use for this RedirectAction. + * Supported values are: + * - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds + * to 301. + * - FOUND, which corresponds to 302. + * - SEE_OTHER which corresponds to 303. + * - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request + * method is retained. + * - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request + * method is retained. * Check the RedirectResponseCode enum for the list of possible values. * * Generated from protobuf field optional string redirect_response_code = 436710408; @@ -246,7 +349,16 @@ public function clearRedirectResponseCode() } /** - * The HTTP Status code to use for this RedirectAction. Supported values are: - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds to 301. - FOUND, which corresponds to 302. - SEE_OTHER which corresponds to 303. - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request method is retained. - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request method is retained. + * The HTTP Status code to use for this RedirectAction. + * Supported values are: + * - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds + * to 301. + * - FOUND, which corresponds to 302. + * - SEE_OTHER which corresponds to 303. + * - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request + * method is retained. + * - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request + * method is retained. * Check the RedirectResponseCode enum for the list of possible values. * * Generated from protobuf field optional string redirect_response_code = 436710408; @@ -262,7 +374,11 @@ public function setRedirectResponseCode($var) } /** - * If set to true, any accompanying query portion of the original URL is removed before redirecting the request. If set to false, the query portion of the original URL is retained. The default is set to false. + * If set to true, any accompanying query portion of the original + * URL is + * removed before redirecting the request. If set to false, the + * query portion of the original URL is retained. + * The default is set to false. * * Generated from protobuf field optional bool strip_query = 52284641; * @return bool @@ -283,7 +399,11 @@ public function clearStripQuery() } /** - * If set to true, any accompanying query portion of the original URL is removed before redirecting the request. If set to false, the query portion of the original URL is retained. The default is set to false. + * If set to true, any accompanying query portion of the original + * URL is + * removed before redirecting the request. If set to false, the + * query portion of the original URL is retained. + * The default is set to false. * * Generated from protobuf field optional bool strip_query = 52284641; * @param bool $var diff --git a/Compute/src/V1/HttpRedirectAction/RedirectResponseCode.php b/Compute/src/V1/HttpRedirectAction/RedirectResponseCode.php index c13c33072bd1..408243608392 100644 --- a/Compute/src/V1/HttpRedirectAction/RedirectResponseCode.php +++ b/Compute/src/V1/HttpRedirectAction/RedirectResponseCode.php @@ -7,7 +7,16 @@ use UnexpectedValueException; /** - * The HTTP Status code to use for this RedirectAction. Supported values are: - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds to 301. - FOUND, which corresponds to 302. - SEE_OTHER which corresponds to 303. - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request method is retained. - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request method is retained. + * The HTTP Status code to use for this RedirectAction. + * Supported values are: + * - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds + * to 301. + * - FOUND, which corresponds to 302. + * - SEE_OTHER which corresponds to 303. + * - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request + * method is retained. + * - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request + * method is retained. * * Protobuf type google.cloud.compute.v1.HttpRedirectAction.RedirectResponseCode */ diff --git a/Compute/src/V1/HttpRetryPolicy.php b/Compute/src/V1/HttpRetryPolicy.php index 6123dfd10935..439b6d39ce78 100644 --- a/Compute/src/V1/HttpRetryPolicy.php +++ b/Compute/src/V1/HttpRetryPolicy.php @@ -16,19 +16,59 @@ class HttpRetryPolicy extends \Google\Protobuf\Internal\Message { /** - * Specifies the allowed number retries. This number must be > 0. If not specified, defaults to 1. + * Specifies the allowed number retries. This number must be > 0. + * If not specified, defaults to 1. * * Generated from protobuf field optional uint32 num_retries = 251680141; */ protected $num_retries = null; /** - * Specifies a non-zero timeout per retry attempt. If not specified, will use the timeout set in the HttpRouteAction field. If timeout in the HttpRouteAction field is not set, this field uses the largest timeout among all backend services associated with the route. Not supported when the URL map is bound to a target gRPC proxy that has the validateForProxyless field set to true. + * Specifies a non-zero timeout per retry attempt. + * If not specified, will use the timeout set in theHttpRouteAction field. + * If timeout in the HttpRouteAction field is not set, this field + * uses the largest timeout + * among all backend services associated with the route. + * Not supported when the URL map is bound to a target gRPC proxy that + * has the validateForProxyless field set to true. * * Generated from protobuf field optional .google.cloud.compute.v1.Duration per_try_timeout = 280041147; */ protected $per_try_timeout = null; /** - * Specifies one or more conditions when this retry policy applies. Valid values are: - 5xx: retry is attempted if the instance or endpoint responds with any 5xx response code, or if the instance or endpoint does not respond at all. For example, disconnects, reset, read timeout, connection failure, and refused streams. - gateway-error: Similar to 5xx, but only applies to response codes 502, 503 or 504. - connect-failure: a retry is attempted on failures connecting to the instance or endpoint. For example, connection timeouts. - retriable-4xx: a retry is attempted if the instance or endpoint responds with a 4xx response code. The only error that you can retry is error code 409. - refused-stream: a retry is attempted if the instance or endpoint resets the stream with a REFUSED_STREAM error code. This reset type indicates that it is safe to retry. - cancelled: a retry is attempted if the gRPC status code in the response header is set to cancelled. - deadline-exceeded: a retry is attempted if the gRPC status code in the response header is set to deadline-exceeded. - internal: a retry is attempted if the gRPC status code in the response header is set to internal. - resource-exhausted: a retry is attempted if the gRPC status code in the response header is set to resource-exhausted. - unavailable: a retry is attempted if the gRPC status code in the response header is set to unavailable. Only the following codes are supported when the URL map is bound to target gRPC proxy that has validateForProxyless field set to true. - cancelled - deadline-exceeded - internal - resource-exhausted - unavailable + * Specifies one or more conditions when this retry policy applies. Valid + * values are: + * - 5xx: retry is attempted if the instance or endpoint + * responds with any 5xx response code, or if the instance or + * endpoint does not respond at all. For example, disconnects, reset, read + * timeout, connection failure, and refused streams. + * - gateway-error: Similar to 5xx, but only + * applies to response codes 502, 503 or504. + * - connect-failure: a retry is attempted on failures + * connecting to the instance or endpoint. For example, connection + * timeouts. + * - retriable-4xx: a retry is attempted if the instance + * or endpoint responds with a 4xx response code. + * The only error that you can retry is error code 409. + * - refused-stream: a retry is attempted if the instance + * or endpoint resets the stream with a REFUSED_STREAM error + * code. This reset type indicates that it is safe to retry. + * - cancelled: a retry is attempted if the gRPC status + * code in the response header is set to cancelled. + * - deadline-exceeded: a retry is attempted if the gRPC + * status code in the response header is set todeadline-exceeded. + * - internal: a retry is attempted if the gRPC + * status code in the response header is set tointernal. + * - resource-exhausted: a retry is attempted if the gRPC + * status code in the response header is set toresource-exhausted. + * - unavailable: a retry is attempted if the gRPC + * status code in the response header is set tounavailable. + * Only the following codes are supported when the URL map is bound to + * target gRPC proxy that has validateForProxyless field set to true. + * - cancelled + * - deadline-exceeded + * - internal + * - resource-exhausted + * - unavailable * * Generated from protobuf field repeated string retry_conditions = 28815535; */ @@ -41,11 +81,51 @@ class HttpRetryPolicy extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type int $num_retries - * Specifies the allowed number retries. This number must be > 0. If not specified, defaults to 1. + * Specifies the allowed number retries. This number must be > 0. + * If not specified, defaults to 1. * @type \Google\Cloud\Compute\V1\Duration $per_try_timeout - * Specifies a non-zero timeout per retry attempt. If not specified, will use the timeout set in the HttpRouteAction field. If timeout in the HttpRouteAction field is not set, this field uses the largest timeout among all backend services associated with the route. Not supported when the URL map is bound to a target gRPC proxy that has the validateForProxyless field set to true. + * Specifies a non-zero timeout per retry attempt. + * If not specified, will use the timeout set in theHttpRouteAction field. + * If timeout in the HttpRouteAction field is not set, this field + * uses the largest timeout + * among all backend services associated with the route. + * Not supported when the URL map is bound to a target gRPC proxy that + * has the validateForProxyless field set to true. * @type array|\Google\Protobuf\Internal\RepeatedField $retry_conditions - * Specifies one or more conditions when this retry policy applies. Valid values are: - 5xx: retry is attempted if the instance or endpoint responds with any 5xx response code, or if the instance or endpoint does not respond at all. For example, disconnects, reset, read timeout, connection failure, and refused streams. - gateway-error: Similar to 5xx, but only applies to response codes 502, 503 or 504. - connect-failure: a retry is attempted on failures connecting to the instance or endpoint. For example, connection timeouts. - retriable-4xx: a retry is attempted if the instance or endpoint responds with a 4xx response code. The only error that you can retry is error code 409. - refused-stream: a retry is attempted if the instance or endpoint resets the stream with a REFUSED_STREAM error code. This reset type indicates that it is safe to retry. - cancelled: a retry is attempted if the gRPC status code in the response header is set to cancelled. - deadline-exceeded: a retry is attempted if the gRPC status code in the response header is set to deadline-exceeded. - internal: a retry is attempted if the gRPC status code in the response header is set to internal. - resource-exhausted: a retry is attempted if the gRPC status code in the response header is set to resource-exhausted. - unavailable: a retry is attempted if the gRPC status code in the response header is set to unavailable. Only the following codes are supported when the URL map is bound to target gRPC proxy that has validateForProxyless field set to true. - cancelled - deadline-exceeded - internal - resource-exhausted - unavailable + * Specifies one or more conditions when this retry policy applies. Valid + * values are: + * - 5xx: retry is attempted if the instance or endpoint + * responds with any 5xx response code, or if the instance or + * endpoint does not respond at all. For example, disconnects, reset, read + * timeout, connection failure, and refused streams. + * - gateway-error: Similar to 5xx, but only + * applies to response codes 502, 503 or504. + * - connect-failure: a retry is attempted on failures + * connecting to the instance or endpoint. For example, connection + * timeouts. + * - retriable-4xx: a retry is attempted if the instance + * or endpoint responds with a 4xx response code. + * The only error that you can retry is error code 409. + * - refused-stream: a retry is attempted if the instance + * or endpoint resets the stream with a REFUSED_STREAM error + * code. This reset type indicates that it is safe to retry. + * - cancelled: a retry is attempted if the gRPC status + * code in the response header is set to cancelled. + * - deadline-exceeded: a retry is attempted if the gRPC + * status code in the response header is set todeadline-exceeded. + * - internal: a retry is attempted if the gRPC + * status code in the response header is set tointernal. + * - resource-exhausted: a retry is attempted if the gRPC + * status code in the response header is set toresource-exhausted. + * - unavailable: a retry is attempted if the gRPC + * status code in the response header is set tounavailable. + * Only the following codes are supported when the URL map is bound to + * target gRPC proxy that has validateForProxyless field set to true. + * - cancelled + * - deadline-exceeded + * - internal + * - resource-exhausted + * - unavailable * } */ public function __construct($data = NULL) { @@ -54,7 +134,8 @@ public function __construct($data = NULL) { } /** - * Specifies the allowed number retries. This number must be > 0. If not specified, defaults to 1. + * Specifies the allowed number retries. This number must be > 0. + * If not specified, defaults to 1. * * Generated from protobuf field optional uint32 num_retries = 251680141; * @return int @@ -75,7 +156,8 @@ public function clearNumRetries() } /** - * Specifies the allowed number retries. This number must be > 0. If not specified, defaults to 1. + * Specifies the allowed number retries. This number must be > 0. + * If not specified, defaults to 1. * * Generated from protobuf field optional uint32 num_retries = 251680141; * @param int $var @@ -90,7 +172,13 @@ public function setNumRetries($var) } /** - * Specifies a non-zero timeout per retry attempt. If not specified, will use the timeout set in the HttpRouteAction field. If timeout in the HttpRouteAction field is not set, this field uses the largest timeout among all backend services associated with the route. Not supported when the URL map is bound to a target gRPC proxy that has the validateForProxyless field set to true. + * Specifies a non-zero timeout per retry attempt. + * If not specified, will use the timeout set in theHttpRouteAction field. + * If timeout in the HttpRouteAction field is not set, this field + * uses the largest timeout + * among all backend services associated with the route. + * Not supported when the URL map is bound to a target gRPC proxy that + * has the validateForProxyless field set to true. * * Generated from protobuf field optional .google.cloud.compute.v1.Duration per_try_timeout = 280041147; * @return \Google\Cloud\Compute\V1\Duration|null @@ -111,7 +199,13 @@ public function clearPerTryTimeout() } /** - * Specifies a non-zero timeout per retry attempt. If not specified, will use the timeout set in the HttpRouteAction field. If timeout in the HttpRouteAction field is not set, this field uses the largest timeout among all backend services associated with the route. Not supported when the URL map is bound to a target gRPC proxy that has the validateForProxyless field set to true. + * Specifies a non-zero timeout per retry attempt. + * If not specified, will use the timeout set in theHttpRouteAction field. + * If timeout in the HttpRouteAction field is not set, this field + * uses the largest timeout + * among all backend services associated with the route. + * Not supported when the URL map is bound to a target gRPC proxy that + * has the validateForProxyless field set to true. * * Generated from protobuf field optional .google.cloud.compute.v1.Duration per_try_timeout = 280041147; * @param \Google\Cloud\Compute\V1\Duration $var @@ -126,7 +220,40 @@ public function setPerTryTimeout($var) } /** - * Specifies one or more conditions when this retry policy applies. Valid values are: - 5xx: retry is attempted if the instance or endpoint responds with any 5xx response code, or if the instance or endpoint does not respond at all. For example, disconnects, reset, read timeout, connection failure, and refused streams. - gateway-error: Similar to 5xx, but only applies to response codes 502, 503 or 504. - connect-failure: a retry is attempted on failures connecting to the instance or endpoint. For example, connection timeouts. - retriable-4xx: a retry is attempted if the instance or endpoint responds with a 4xx response code. The only error that you can retry is error code 409. - refused-stream: a retry is attempted if the instance or endpoint resets the stream with a REFUSED_STREAM error code. This reset type indicates that it is safe to retry. - cancelled: a retry is attempted if the gRPC status code in the response header is set to cancelled. - deadline-exceeded: a retry is attempted if the gRPC status code in the response header is set to deadline-exceeded. - internal: a retry is attempted if the gRPC status code in the response header is set to internal. - resource-exhausted: a retry is attempted if the gRPC status code in the response header is set to resource-exhausted. - unavailable: a retry is attempted if the gRPC status code in the response header is set to unavailable. Only the following codes are supported when the URL map is bound to target gRPC proxy that has validateForProxyless field set to true. - cancelled - deadline-exceeded - internal - resource-exhausted - unavailable + * Specifies one or more conditions when this retry policy applies. Valid + * values are: + * - 5xx: retry is attempted if the instance or endpoint + * responds with any 5xx response code, or if the instance or + * endpoint does not respond at all. For example, disconnects, reset, read + * timeout, connection failure, and refused streams. + * - gateway-error: Similar to 5xx, but only + * applies to response codes 502, 503 or504. + * - connect-failure: a retry is attempted on failures + * connecting to the instance or endpoint. For example, connection + * timeouts. + * - retriable-4xx: a retry is attempted if the instance + * or endpoint responds with a 4xx response code. + * The only error that you can retry is error code 409. + * - refused-stream: a retry is attempted if the instance + * or endpoint resets the stream with a REFUSED_STREAM error + * code. This reset type indicates that it is safe to retry. + * - cancelled: a retry is attempted if the gRPC status + * code in the response header is set to cancelled. + * - deadline-exceeded: a retry is attempted if the gRPC + * status code in the response header is set todeadline-exceeded. + * - internal: a retry is attempted if the gRPC + * status code in the response header is set tointernal. + * - resource-exhausted: a retry is attempted if the gRPC + * status code in the response header is set toresource-exhausted. + * - unavailable: a retry is attempted if the gRPC + * status code in the response header is set tounavailable. + * Only the following codes are supported when the URL map is bound to + * target gRPC proxy that has validateForProxyless field set to true. + * - cancelled + * - deadline-exceeded + * - internal + * - resource-exhausted + * - unavailable * * Generated from protobuf field repeated string retry_conditions = 28815535; * @return \Google\Protobuf\Internal\RepeatedField @@ -137,7 +264,40 @@ public function getRetryConditions() } /** - * Specifies one or more conditions when this retry policy applies. Valid values are: - 5xx: retry is attempted if the instance or endpoint responds with any 5xx response code, or if the instance or endpoint does not respond at all. For example, disconnects, reset, read timeout, connection failure, and refused streams. - gateway-error: Similar to 5xx, but only applies to response codes 502, 503 or 504. - connect-failure: a retry is attempted on failures connecting to the instance or endpoint. For example, connection timeouts. - retriable-4xx: a retry is attempted if the instance or endpoint responds with a 4xx response code. The only error that you can retry is error code 409. - refused-stream: a retry is attempted if the instance or endpoint resets the stream with a REFUSED_STREAM error code. This reset type indicates that it is safe to retry. - cancelled: a retry is attempted if the gRPC status code in the response header is set to cancelled. - deadline-exceeded: a retry is attempted if the gRPC status code in the response header is set to deadline-exceeded. - internal: a retry is attempted if the gRPC status code in the response header is set to internal. - resource-exhausted: a retry is attempted if the gRPC status code in the response header is set to resource-exhausted. - unavailable: a retry is attempted if the gRPC status code in the response header is set to unavailable. Only the following codes are supported when the URL map is bound to target gRPC proxy that has validateForProxyless field set to true. - cancelled - deadline-exceeded - internal - resource-exhausted - unavailable + * Specifies one or more conditions when this retry policy applies. Valid + * values are: + * - 5xx: retry is attempted if the instance or endpoint + * responds with any 5xx response code, or if the instance or + * endpoint does not respond at all. For example, disconnects, reset, read + * timeout, connection failure, and refused streams. + * - gateway-error: Similar to 5xx, but only + * applies to response codes 502, 503 or504. + * - connect-failure: a retry is attempted on failures + * connecting to the instance or endpoint. For example, connection + * timeouts. + * - retriable-4xx: a retry is attempted if the instance + * or endpoint responds with a 4xx response code. + * The only error that you can retry is error code 409. + * - refused-stream: a retry is attempted if the instance + * or endpoint resets the stream with a REFUSED_STREAM error + * code. This reset type indicates that it is safe to retry. + * - cancelled: a retry is attempted if the gRPC status + * code in the response header is set to cancelled. + * - deadline-exceeded: a retry is attempted if the gRPC + * status code in the response header is set todeadline-exceeded. + * - internal: a retry is attempted if the gRPC + * status code in the response header is set tointernal. + * - resource-exhausted: a retry is attempted if the gRPC + * status code in the response header is set toresource-exhausted. + * - unavailable: a retry is attempted if the gRPC + * status code in the response header is set tounavailable. + * Only the following codes are supported when the URL map is bound to + * target gRPC proxy that has validateForProxyless field set to true. + * - cancelled + * - deadline-exceeded + * - internal + * - resource-exhausted + * - unavailable * * Generated from protobuf field repeated string retry_conditions = 28815535; * @param array|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/HttpRouteAction.php b/Compute/src/V1/HttpRouteAction.php index 1ba66645ae76..001602cb6830 100644 --- a/Compute/src/V1/HttpRouteAction.php +++ b/Compute/src/V1/HttpRouteAction.php @@ -15,25 +15,55 @@ class HttpRouteAction extends \Google\Protobuf\Internal\Message { /** - * The specification for allowing client-side cross-origin requests. For more information about the W3C recommendation for cross-origin resource sharing (CORS), see Fetch API Living Standard. Not supported when the URL map is bound to a target gRPC proxy. + * The specification for allowing client-side cross-origin requests. For more + * information about the W3C recommendation for cross-origin resource sharing + * (CORS), see Fetch API Living + * Standard. + * Not supported when the URL map is bound to a target gRPC proxy. * * Generated from protobuf field optional .google.cloud.compute.v1.CorsPolicy cors_policy = 398943748; */ protected $cors_policy = null; /** - * The specification for fault injection introduced into traffic to test the resiliency of clients to backend service failure. As part of fault injection, when clients send requests to a backend service, delays can be introduced by a load balancer on a percentage of requests before sending those requests to the backend service. Similarly requests from clients can be aborted by the load balancer for a percentage of requests. timeout and retry_policy is ignored by clients that are configured with a fault_injection_policy if: 1. The traffic is generated by fault injection AND 2. The fault injection is not a delay fault injection. Fault injection is not supported with the classic Application Load Balancer . To see which load balancers support fault injection, see Load balancing: Routing and traffic management features. + * The specification for fault injection introduced into traffic to test + * the resiliency of clients to backend service failure. As part of fault + * injection, when clients send requests to a backend service, delays can be + * introduced by a load balancer on a percentage of requests before sending + * those requests to the backend service. Similarly requests from clients can + * be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients + * that are configured with a fault_injection_policy if: + * 1. The traffic is generated by fault injection AND + * 2. The fault injection is not a delay fault injection. + * Fault injection is not supported with the classic Application Load Balancer + * . To see which load balancers support fault injection, + * see Load + * balancing: Routing and traffic management features. * * Generated from protobuf field optional .google.cloud.compute.v1.HttpFaultInjection fault_injection_policy = 412781079; */ protected $fault_injection_policy = null; /** - * Specifies the maximum duration (timeout) for streams on the selected route. Unlike the timeout field where the timeout duration starts from the time the request has been fully processed (known as *end-of-stream*), the duration in this field is computed from the beginning of the stream until the response has been processed, including all retries. A stream that does not complete in this duration is closed. If not specified, this field uses the maximum maxStreamDuration value among all backend services associated with the route. This field is only allowed if the Url map is used with backend services with loadBalancingScheme set to INTERNAL_SELF_MANAGED. + * Specifies the maximum duration (timeout) for streams on the selected route. + * Unlike the timeout field where the timeout duration starts + * from the time the request has been fully processed (known as*end-of-stream*), + * the duration in this field is computed from the beginning of the stream + * until the response has been processed, including all retries. A + * stream that does not complete in this duration is closed. + * If not specified, this field uses the maximummaxStreamDuration value among all backend services associated + * with the route. + * This field is only allowed if the Url map is used with backend services + * with loadBalancingScheme set toINTERNAL_SELF_MANAGED. * * Generated from protobuf field optional .google.cloud.compute.v1.Duration max_stream_duration = 61428376; */ protected $max_stream_duration = null; /** - * Specifies the policy on how requests intended for the route's backends are shadowed to a separate mirrored backend service. The load balancer does not wait for responses from the shadow service. Before sending traffic to the shadow service, the host / authority header is suffixed with -shadow. Not supported when the URL map is bound to a target gRPC proxy that has the validateForProxyless field set to true. + * Specifies the policy on how requests intended for the route's backends + * are shadowed to a separate mirrored backend service. The load balancer does + * not wait for responses from the shadow service. Before sending traffic + * to the shadow service, the host / authority header is suffixed with-shadow. + * Not supported when the URL map is bound to a target gRPC proxy that + * has the validateForProxyless field set to true. * * Generated from protobuf field optional .google.cloud.compute.v1.RequestMirrorPolicy request_mirror_policy = 220196866; */ @@ -45,19 +75,39 @@ class HttpRouteAction extends \Google\Protobuf\Internal\Message */ protected $retry_policy = null; /** - * Specifies the timeout for the selected route. Timeout is computed from the time the request has been fully processed (known as *end-of-stream*) up until the response has been processed. Timeout includes all retries. If not specified, this field uses the largest timeout among all backend services associated with the route. Not supported when the URL map is bound to a target gRPC proxy that has validateForProxyless field set to true. + * Specifies the timeout for the selected route. Timeout is computed from the + * time the request has been fully processed (known as *end-of-stream*) + * up until the response has been processed. Timeout includes + * all retries. + * If not specified, this field uses the largest timeout among all backend + * services associated with the route. + * Not supported when the URL map is bound to a target gRPC proxy that + * has validateForProxyless field set to true. * * Generated from protobuf field optional .google.cloud.compute.v1.Duration timeout = 296701281; */ protected $timeout = null; /** - * The spec to modify the URL of the request, before forwarding the request to the matched service. urlRewrite is the only action supported in UrlMaps for classic Application Load Balancers. Not supported when the URL map is bound to a target gRPC proxy that has the validateForProxyless field set to true. + * The spec to modify the URL of the request, before forwarding the request + * to the matched service. + * urlRewrite is the only action supported in UrlMaps + * for classic Application Load Balancers. + * Not supported when the URL map is bound to a target gRPC proxy that + * has the validateForProxyless field set to true. * * Generated from protobuf field optional .google.cloud.compute.v1.UrlRewrite url_rewrite = 273333948; */ protected $url_rewrite = null; /** - * A list of weighted backend services to send traffic to when a route match occurs. The weights determine the fraction of traffic that flows to their corresponding backend service. If all traffic needs to go to a single backend service, there must be one weightedBackendService with weight set to a non-zero number. After a backend service is identified and before forwarding the request to the backend service, advanced routing actions such as URL rewrites and header transformations are applied depending on additional settings specified in this HttpRouteAction. + * A list of weighted backend services to send traffic to when a route match + * occurs. The weights determine the fraction of traffic that flows to + * their corresponding backend service. If all traffic needs to + * go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number. + * After a backend service is identified and before forwarding + * the request to + * the backend service, advanced routing actions such as URL rewrites and + * header transformations are applied depending on additional settings + * specified in this HttpRouteAction. * * Generated from protobuf field repeated .google.cloud.compute.v1.WeightedBackendService weighted_backend_services = 337028049; */ @@ -70,21 +120,71 @@ class HttpRouteAction extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type \Google\Cloud\Compute\V1\CorsPolicy $cors_policy - * The specification for allowing client-side cross-origin requests. For more information about the W3C recommendation for cross-origin resource sharing (CORS), see Fetch API Living Standard. Not supported when the URL map is bound to a target gRPC proxy. + * The specification for allowing client-side cross-origin requests. For more + * information about the W3C recommendation for cross-origin resource sharing + * (CORS), see Fetch API Living + * Standard. + * Not supported when the URL map is bound to a target gRPC proxy. * @type \Google\Cloud\Compute\V1\HttpFaultInjection $fault_injection_policy - * The specification for fault injection introduced into traffic to test the resiliency of clients to backend service failure. As part of fault injection, when clients send requests to a backend service, delays can be introduced by a load balancer on a percentage of requests before sending those requests to the backend service. Similarly requests from clients can be aborted by the load balancer for a percentage of requests. timeout and retry_policy is ignored by clients that are configured with a fault_injection_policy if: 1. The traffic is generated by fault injection AND 2. The fault injection is not a delay fault injection. Fault injection is not supported with the classic Application Load Balancer . To see which load balancers support fault injection, see Load balancing: Routing and traffic management features. + * The specification for fault injection introduced into traffic to test + * the resiliency of clients to backend service failure. As part of fault + * injection, when clients send requests to a backend service, delays can be + * introduced by a load balancer on a percentage of requests before sending + * those requests to the backend service. Similarly requests from clients can + * be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients + * that are configured with a fault_injection_policy if: + * 1. The traffic is generated by fault injection AND + * 2. The fault injection is not a delay fault injection. + * Fault injection is not supported with the classic Application Load Balancer + * . To see which load balancers support fault injection, + * see Load + * balancing: Routing and traffic management features. * @type \Google\Cloud\Compute\V1\Duration $max_stream_duration - * Specifies the maximum duration (timeout) for streams on the selected route. Unlike the timeout field where the timeout duration starts from the time the request has been fully processed (known as *end-of-stream*), the duration in this field is computed from the beginning of the stream until the response has been processed, including all retries. A stream that does not complete in this duration is closed. If not specified, this field uses the maximum maxStreamDuration value among all backend services associated with the route. This field is only allowed if the Url map is used with backend services with loadBalancingScheme set to INTERNAL_SELF_MANAGED. + * Specifies the maximum duration (timeout) for streams on the selected route. + * Unlike the timeout field where the timeout duration starts + * from the time the request has been fully processed (known as*end-of-stream*), + * the duration in this field is computed from the beginning of the stream + * until the response has been processed, including all retries. A + * stream that does not complete in this duration is closed. + * If not specified, this field uses the maximummaxStreamDuration value among all backend services associated + * with the route. + * This field is only allowed if the Url map is used with backend services + * with loadBalancingScheme set toINTERNAL_SELF_MANAGED. * @type \Google\Cloud\Compute\V1\RequestMirrorPolicy $request_mirror_policy - * Specifies the policy on how requests intended for the route's backends are shadowed to a separate mirrored backend service. The load balancer does not wait for responses from the shadow service. Before sending traffic to the shadow service, the host / authority header is suffixed with -shadow. Not supported when the URL map is bound to a target gRPC proxy that has the validateForProxyless field set to true. + * Specifies the policy on how requests intended for the route's backends + * are shadowed to a separate mirrored backend service. The load balancer does + * not wait for responses from the shadow service. Before sending traffic + * to the shadow service, the host / authority header is suffixed with-shadow. + * Not supported when the URL map is bound to a target gRPC proxy that + * has the validateForProxyless field set to true. * @type \Google\Cloud\Compute\V1\HttpRetryPolicy $retry_policy * Specifies the retry policy associated with this route. * @type \Google\Cloud\Compute\V1\Duration $timeout - * Specifies the timeout for the selected route. Timeout is computed from the time the request has been fully processed (known as *end-of-stream*) up until the response has been processed. Timeout includes all retries. If not specified, this field uses the largest timeout among all backend services associated with the route. Not supported when the URL map is bound to a target gRPC proxy that has validateForProxyless field set to true. + * Specifies the timeout for the selected route. Timeout is computed from the + * time the request has been fully processed (known as *end-of-stream*) + * up until the response has been processed. Timeout includes + * all retries. + * If not specified, this field uses the largest timeout among all backend + * services associated with the route. + * Not supported when the URL map is bound to a target gRPC proxy that + * has validateForProxyless field set to true. * @type \Google\Cloud\Compute\V1\UrlRewrite $url_rewrite - * The spec to modify the URL of the request, before forwarding the request to the matched service. urlRewrite is the only action supported in UrlMaps for classic Application Load Balancers. Not supported when the URL map is bound to a target gRPC proxy that has the validateForProxyless field set to true. + * The spec to modify the URL of the request, before forwarding the request + * to the matched service. + * urlRewrite is the only action supported in UrlMaps + * for classic Application Load Balancers. + * Not supported when the URL map is bound to a target gRPC proxy that + * has the validateForProxyless field set to true. * @type array<\Google\Cloud\Compute\V1\WeightedBackendService>|\Google\Protobuf\Internal\RepeatedField $weighted_backend_services - * A list of weighted backend services to send traffic to when a route match occurs. The weights determine the fraction of traffic that flows to their corresponding backend service. If all traffic needs to go to a single backend service, there must be one weightedBackendService with weight set to a non-zero number. After a backend service is identified and before forwarding the request to the backend service, advanced routing actions such as URL rewrites and header transformations are applied depending on additional settings specified in this HttpRouteAction. + * A list of weighted backend services to send traffic to when a route match + * occurs. The weights determine the fraction of traffic that flows to + * their corresponding backend service. If all traffic needs to + * go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number. + * After a backend service is identified and before forwarding + * the request to + * the backend service, advanced routing actions such as URL rewrites and + * header transformations are applied depending on additional settings + * specified in this HttpRouteAction. * } */ public function __construct($data = NULL) { @@ -93,7 +193,11 @@ public function __construct($data = NULL) { } /** - * The specification for allowing client-side cross-origin requests. For more information about the W3C recommendation for cross-origin resource sharing (CORS), see Fetch API Living Standard. Not supported when the URL map is bound to a target gRPC proxy. + * The specification for allowing client-side cross-origin requests. For more + * information about the W3C recommendation for cross-origin resource sharing + * (CORS), see Fetch API Living + * Standard. + * Not supported when the URL map is bound to a target gRPC proxy. * * Generated from protobuf field optional .google.cloud.compute.v1.CorsPolicy cors_policy = 398943748; * @return \Google\Cloud\Compute\V1\CorsPolicy|null @@ -114,7 +218,11 @@ public function clearCorsPolicy() } /** - * The specification for allowing client-side cross-origin requests. For more information about the W3C recommendation for cross-origin resource sharing (CORS), see Fetch API Living Standard. Not supported when the URL map is bound to a target gRPC proxy. + * The specification for allowing client-side cross-origin requests. For more + * information about the W3C recommendation for cross-origin resource sharing + * (CORS), see Fetch API Living + * Standard. + * Not supported when the URL map is bound to a target gRPC proxy. * * Generated from protobuf field optional .google.cloud.compute.v1.CorsPolicy cors_policy = 398943748; * @param \Google\Cloud\Compute\V1\CorsPolicy $var @@ -129,7 +237,19 @@ public function setCorsPolicy($var) } /** - * The specification for fault injection introduced into traffic to test the resiliency of clients to backend service failure. As part of fault injection, when clients send requests to a backend service, delays can be introduced by a load balancer on a percentage of requests before sending those requests to the backend service. Similarly requests from clients can be aborted by the load balancer for a percentage of requests. timeout and retry_policy is ignored by clients that are configured with a fault_injection_policy if: 1. The traffic is generated by fault injection AND 2. The fault injection is not a delay fault injection. Fault injection is not supported with the classic Application Load Balancer . To see which load balancers support fault injection, see Load balancing: Routing and traffic management features. + * The specification for fault injection introduced into traffic to test + * the resiliency of clients to backend service failure. As part of fault + * injection, when clients send requests to a backend service, delays can be + * introduced by a load balancer on a percentage of requests before sending + * those requests to the backend service. Similarly requests from clients can + * be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients + * that are configured with a fault_injection_policy if: + * 1. The traffic is generated by fault injection AND + * 2. The fault injection is not a delay fault injection. + * Fault injection is not supported with the classic Application Load Balancer + * . To see which load balancers support fault injection, + * see Load + * balancing: Routing and traffic management features. * * Generated from protobuf field optional .google.cloud.compute.v1.HttpFaultInjection fault_injection_policy = 412781079; * @return \Google\Cloud\Compute\V1\HttpFaultInjection|null @@ -150,7 +270,19 @@ public function clearFaultInjectionPolicy() } /** - * The specification for fault injection introduced into traffic to test the resiliency of clients to backend service failure. As part of fault injection, when clients send requests to a backend service, delays can be introduced by a load balancer on a percentage of requests before sending those requests to the backend service. Similarly requests from clients can be aborted by the load balancer for a percentage of requests. timeout and retry_policy is ignored by clients that are configured with a fault_injection_policy if: 1. The traffic is generated by fault injection AND 2. The fault injection is not a delay fault injection. Fault injection is not supported with the classic Application Load Balancer . To see which load balancers support fault injection, see Load balancing: Routing and traffic management features. + * The specification for fault injection introduced into traffic to test + * the resiliency of clients to backend service failure. As part of fault + * injection, when clients send requests to a backend service, delays can be + * introduced by a load balancer on a percentage of requests before sending + * those requests to the backend service. Similarly requests from clients can + * be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients + * that are configured with a fault_injection_policy if: + * 1. The traffic is generated by fault injection AND + * 2. The fault injection is not a delay fault injection. + * Fault injection is not supported with the classic Application Load Balancer + * . To see which load balancers support fault injection, + * see Load + * balancing: Routing and traffic management features. * * Generated from protobuf field optional .google.cloud.compute.v1.HttpFaultInjection fault_injection_policy = 412781079; * @param \Google\Cloud\Compute\V1\HttpFaultInjection $var @@ -165,7 +297,16 @@ public function setFaultInjectionPolicy($var) } /** - * Specifies the maximum duration (timeout) for streams on the selected route. Unlike the timeout field where the timeout duration starts from the time the request has been fully processed (known as *end-of-stream*), the duration in this field is computed from the beginning of the stream until the response has been processed, including all retries. A stream that does not complete in this duration is closed. If not specified, this field uses the maximum maxStreamDuration value among all backend services associated with the route. This field is only allowed if the Url map is used with backend services with loadBalancingScheme set to INTERNAL_SELF_MANAGED. + * Specifies the maximum duration (timeout) for streams on the selected route. + * Unlike the timeout field where the timeout duration starts + * from the time the request has been fully processed (known as*end-of-stream*), + * the duration in this field is computed from the beginning of the stream + * until the response has been processed, including all retries. A + * stream that does not complete in this duration is closed. + * If not specified, this field uses the maximummaxStreamDuration value among all backend services associated + * with the route. + * This field is only allowed if the Url map is used with backend services + * with loadBalancingScheme set toINTERNAL_SELF_MANAGED. * * Generated from protobuf field optional .google.cloud.compute.v1.Duration max_stream_duration = 61428376; * @return \Google\Cloud\Compute\V1\Duration|null @@ -186,7 +327,16 @@ public function clearMaxStreamDuration() } /** - * Specifies the maximum duration (timeout) for streams on the selected route. Unlike the timeout field where the timeout duration starts from the time the request has been fully processed (known as *end-of-stream*), the duration in this field is computed from the beginning of the stream until the response has been processed, including all retries. A stream that does not complete in this duration is closed. If not specified, this field uses the maximum maxStreamDuration value among all backend services associated with the route. This field is only allowed if the Url map is used with backend services with loadBalancingScheme set to INTERNAL_SELF_MANAGED. + * Specifies the maximum duration (timeout) for streams on the selected route. + * Unlike the timeout field where the timeout duration starts + * from the time the request has been fully processed (known as*end-of-stream*), + * the duration in this field is computed from the beginning of the stream + * until the response has been processed, including all retries. A + * stream that does not complete in this duration is closed. + * If not specified, this field uses the maximummaxStreamDuration value among all backend services associated + * with the route. + * This field is only allowed if the Url map is used with backend services + * with loadBalancingScheme set toINTERNAL_SELF_MANAGED. * * Generated from protobuf field optional .google.cloud.compute.v1.Duration max_stream_duration = 61428376; * @param \Google\Cloud\Compute\V1\Duration $var @@ -201,7 +351,12 @@ public function setMaxStreamDuration($var) } /** - * Specifies the policy on how requests intended for the route's backends are shadowed to a separate mirrored backend service. The load balancer does not wait for responses from the shadow service. Before sending traffic to the shadow service, the host / authority header is suffixed with -shadow. Not supported when the URL map is bound to a target gRPC proxy that has the validateForProxyless field set to true. + * Specifies the policy on how requests intended for the route's backends + * are shadowed to a separate mirrored backend service. The load balancer does + * not wait for responses from the shadow service. Before sending traffic + * to the shadow service, the host / authority header is suffixed with-shadow. + * Not supported when the URL map is bound to a target gRPC proxy that + * has the validateForProxyless field set to true. * * Generated from protobuf field optional .google.cloud.compute.v1.RequestMirrorPolicy request_mirror_policy = 220196866; * @return \Google\Cloud\Compute\V1\RequestMirrorPolicy|null @@ -222,7 +377,12 @@ public function clearRequestMirrorPolicy() } /** - * Specifies the policy on how requests intended for the route's backends are shadowed to a separate mirrored backend service. The load balancer does not wait for responses from the shadow service. Before sending traffic to the shadow service, the host / authority header is suffixed with -shadow. Not supported when the URL map is bound to a target gRPC proxy that has the validateForProxyless field set to true. + * Specifies the policy on how requests intended for the route's backends + * are shadowed to a separate mirrored backend service. The load balancer does + * not wait for responses from the shadow service. Before sending traffic + * to the shadow service, the host / authority header is suffixed with-shadow. + * Not supported when the URL map is bound to a target gRPC proxy that + * has the validateForProxyless field set to true. * * Generated from protobuf field optional .google.cloud.compute.v1.RequestMirrorPolicy request_mirror_policy = 220196866; * @param \Google\Cloud\Compute\V1\RequestMirrorPolicy $var @@ -273,7 +433,14 @@ public function setRetryPolicy($var) } /** - * Specifies the timeout for the selected route. Timeout is computed from the time the request has been fully processed (known as *end-of-stream*) up until the response has been processed. Timeout includes all retries. If not specified, this field uses the largest timeout among all backend services associated with the route. Not supported when the URL map is bound to a target gRPC proxy that has validateForProxyless field set to true. + * Specifies the timeout for the selected route. Timeout is computed from the + * time the request has been fully processed (known as *end-of-stream*) + * up until the response has been processed. Timeout includes + * all retries. + * If not specified, this field uses the largest timeout among all backend + * services associated with the route. + * Not supported when the URL map is bound to a target gRPC proxy that + * has validateForProxyless field set to true. * * Generated from protobuf field optional .google.cloud.compute.v1.Duration timeout = 296701281; * @return \Google\Cloud\Compute\V1\Duration|null @@ -294,7 +461,14 @@ public function clearTimeout() } /** - * Specifies the timeout for the selected route. Timeout is computed from the time the request has been fully processed (known as *end-of-stream*) up until the response has been processed. Timeout includes all retries. If not specified, this field uses the largest timeout among all backend services associated with the route. Not supported when the URL map is bound to a target gRPC proxy that has validateForProxyless field set to true. + * Specifies the timeout for the selected route. Timeout is computed from the + * time the request has been fully processed (known as *end-of-stream*) + * up until the response has been processed. Timeout includes + * all retries. + * If not specified, this field uses the largest timeout among all backend + * services associated with the route. + * Not supported when the URL map is bound to a target gRPC proxy that + * has validateForProxyless field set to true. * * Generated from protobuf field optional .google.cloud.compute.v1.Duration timeout = 296701281; * @param \Google\Cloud\Compute\V1\Duration $var @@ -309,7 +483,12 @@ public function setTimeout($var) } /** - * The spec to modify the URL of the request, before forwarding the request to the matched service. urlRewrite is the only action supported in UrlMaps for classic Application Load Balancers. Not supported when the URL map is bound to a target gRPC proxy that has the validateForProxyless field set to true. + * The spec to modify the URL of the request, before forwarding the request + * to the matched service. + * urlRewrite is the only action supported in UrlMaps + * for classic Application Load Balancers. + * Not supported when the URL map is bound to a target gRPC proxy that + * has the validateForProxyless field set to true. * * Generated from protobuf field optional .google.cloud.compute.v1.UrlRewrite url_rewrite = 273333948; * @return \Google\Cloud\Compute\V1\UrlRewrite|null @@ -330,7 +509,12 @@ public function clearUrlRewrite() } /** - * The spec to modify the URL of the request, before forwarding the request to the matched service. urlRewrite is the only action supported in UrlMaps for classic Application Load Balancers. Not supported when the URL map is bound to a target gRPC proxy that has the validateForProxyless field set to true. + * The spec to modify the URL of the request, before forwarding the request + * to the matched service. + * urlRewrite is the only action supported in UrlMaps + * for classic Application Load Balancers. + * Not supported when the URL map is bound to a target gRPC proxy that + * has the validateForProxyless field set to true. * * Generated from protobuf field optional .google.cloud.compute.v1.UrlRewrite url_rewrite = 273333948; * @param \Google\Cloud\Compute\V1\UrlRewrite $var @@ -345,7 +529,15 @@ public function setUrlRewrite($var) } /** - * A list of weighted backend services to send traffic to when a route match occurs. The weights determine the fraction of traffic that flows to their corresponding backend service. If all traffic needs to go to a single backend service, there must be one weightedBackendService with weight set to a non-zero number. After a backend service is identified and before forwarding the request to the backend service, advanced routing actions such as URL rewrites and header transformations are applied depending on additional settings specified in this HttpRouteAction. + * A list of weighted backend services to send traffic to when a route match + * occurs. The weights determine the fraction of traffic that flows to + * their corresponding backend service. If all traffic needs to + * go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number. + * After a backend service is identified and before forwarding + * the request to + * the backend service, advanced routing actions such as URL rewrites and + * header transformations are applied depending on additional settings + * specified in this HttpRouteAction. * * Generated from protobuf field repeated .google.cloud.compute.v1.WeightedBackendService weighted_backend_services = 337028049; * @return \Google\Protobuf\Internal\RepeatedField @@ -356,7 +548,15 @@ public function getWeightedBackendServices() } /** - * A list of weighted backend services to send traffic to when a route match occurs. The weights determine the fraction of traffic that flows to their corresponding backend service. If all traffic needs to go to a single backend service, there must be one weightedBackendService with weight set to a non-zero number. After a backend service is identified and before forwarding the request to the backend service, advanced routing actions such as URL rewrites and header transformations are applied depending on additional settings specified in this HttpRouteAction. + * A list of weighted backend services to send traffic to when a route match + * occurs. The weights determine the fraction of traffic that flows to + * their corresponding backend service. If all traffic needs to + * go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number. + * After a backend service is identified and before forwarding + * the request to + * the backend service, advanced routing actions such as URL rewrites and + * header transformations are applied depending on additional settings + * specified in this HttpRouteAction. * * Generated from protobuf field repeated .google.cloud.compute.v1.WeightedBackendService weighted_backend_services = 337028049; * @param array<\Google\Cloud\Compute\V1\WeightedBackendService>|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/HttpRouteRule.php b/Compute/src/V1/HttpRouteRule.php index d8fb6b73ed0b..6e3bb35befca 100644 --- a/Compute/src/V1/HttpRouteRule.php +++ b/Compute/src/V1/HttpRouteRule.php @@ -9,56 +9,119 @@ use Google\Protobuf\Internal\GPBUtil; /** - * The HttpRouteRule setting specifies how to match an HTTP request and the corresponding routing action that load balancing proxies perform. + * The HttpRouteRule setting specifies how to match an HTTP request + * and the corresponding routing action that load balancing proxies perform. * * Generated from protobuf message google.cloud.compute.v1.HttpRouteRule */ class HttpRouteRule extends \Google\Protobuf\Internal\Message { /** - * customErrorResponsePolicy specifies how the Load Balancer returns error responses when BackendServiceor BackendBucket responds with an error. If a policy for an error code is not configured for the RouteRule, a policy for the error code configured in pathMatcher.defaultCustomErrorResponsePolicy is applied. If one is not specified in pathMatcher.defaultCustomErrorResponsePolicy, the policy configured in UrlMap.defaultCustomErrorResponsePolicy takes effect. For example, consider a UrlMap with the following configuration: - UrlMap.defaultCustomErrorResponsePolicy are configured with policies for 5xx and 4xx errors - A RouteRule for /coming_soon/ is configured for the error code 404. If the request is for www.myotherdomain.com and a 404 is encountered, the policy under UrlMap.defaultCustomErrorResponsePolicy takes effect. If a 404 response is encountered for the request www.example.com/current_events/, the pathMatcher's policy takes effect. If however, the request for www.example.com/coming_soon/ encounters a 404, the policy in RouteRule.customErrorResponsePolicy takes effect. If any of the requests in this example encounter a 500 error code, the policy at UrlMap.defaultCustomErrorResponsePolicy takes effect. When used in conjunction with routeRules.routeAction.retryPolicy, retries take precedence. Only once all retries are exhausted, the customErrorResponsePolicy is applied. While attempting a retry, if load balancer is successful in reaching the service, the customErrorResponsePolicy is ignored and the response from the service is returned to the client. customErrorResponsePolicy is supported only for global external Application Load Balancers. + * customErrorResponsePolicy specifies how the Load + * Balancer returns error responses when BackendServiceorBackendBucket responds with an error. + * If a policy for an + * error code is not configured for the RouteRule, a policy for + * the error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If + * one is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy + * configured in UrlMap.defaultCustomErrorResponsePolicy takes + * effect. + * For example, consider a UrlMap with the following configuration: + * - UrlMap.defaultCustomErrorResponsePolicy are configured + * with policies for 5xx and 4xx errors + * - A RouteRule for /coming_soon/ is configured for the + * error code 404. + * If the request is for www.myotherdomain.com and a404 is encountered, the policy underUrlMap.defaultCustomErrorResponsePolicy takes effect. If a404 response is encountered for the requestwww.example.com/current_events/, the pathMatcher's policy + * takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404, + * the policy in RouteRule.customErrorResponsePolicy takes + * effect. If any of the requests in this example encounter a 500 + * error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect. + * When + * used in conjunction withrouteRules.routeAction.retryPolicy, retries take + * precedence. Only once all retries are exhausted, thecustomErrorResponsePolicy is applied. While attempting + * a retry, if load balancer is successful in reaching the + * service, the customErrorResponsePolicy is ignored and + * the response from the service is returned to the client. + * customErrorResponsePolicy is supported only for + * global external Application Load Balancers. * * Generated from protobuf field optional .google.cloud.compute.v1.CustomErrorResponsePolicy custom_error_response_policy = 202816619; */ protected $custom_error_response_policy = null; /** - * The short description conveying the intent of this routeRule. The description can have a maximum length of 1024 characters. + * The short description conveying the intent of this routeRule. + * The description can have a maximum length of 1024 characters. * * Generated from protobuf field optional string description = 422937596; */ protected $description = null; /** - * Specifies changes to request and response headers that need to take effect for the selected backendService. The headerAction value specified here is applied before the matching pathMatchers[].headerAction and after pathMatchers[].routeRules[].routeAction.weightedBackendService.backendServiceWeightAction[].headerAction HeaderAction is not supported for load balancers that have their loadBalancingScheme set to EXTERNAL. Not supported when the URL map is bound to a target gRPC proxy that has validateForProxyless field set to true. + * Specifies changes to request and response headers that need to take effect + * for the selected backendService. + * The headerAction value specified here is applied before the + * matching pathMatchers[].headerAction and afterpathMatchers[].routeRules[].routeAction.weightedBackendService.backendServiceWeightAction[].headerAction + * HeaderAction is not supported for load balancers + * that have + * their loadBalancingScheme set to EXTERNAL. + * Not supported when the URL map is bound to a target gRPC proxy that + * has validateForProxyless field set to true. * * Generated from protobuf field optional .google.cloud.compute.v1.HttpHeaderAction header_action = 328077352; */ protected $header_action = null; /** - * The list of criteria for matching attributes of a request to this routeRule. This list has OR semantics: the request matches this routeRule when any of the matchRules are satisfied. However predicates within a given matchRule have AND semantics. All predicates within a matchRule must match for the request to match the rule. + * The list of criteria for matching attributes of a request to thisrouteRule. This list has OR semantics: the request matches + * this routeRule when any of thematchRules are satisfied. However predicates within + * a given matchRule have AND semantics. All predicates + * within a matchRule must match for the request to + * match the rule. * * Generated from protobuf field repeated .google.cloud.compute.v1.HttpRouteRuleMatch match_rules = 376200701; */ private $match_rules; /** - * For routeRules within a given pathMatcher, priority determines the order in which a load balancer interprets routeRules. RouteRules are evaluated in order of priority, from the lowest to highest number. The priority of a rule decreases as its number increases (1, 2, 3, N+1). The first rule that matches the request is applied. You cannot configure two or more routeRules with the same priority. Priority for each rule must be set to a number from 0 to 2147483647 inclusive. Priority numbers can have gaps, which enable you to add or remove rules in the future without affecting the rest of the rules. For example, 1, 2, 3, 4, 5, 9, 12, 16 is a valid series of priority numbers to which you could add rules numbered from 6 to 8, 10 to 11, and 13 to 15 in the future without any impact on existing rules. + * For routeRules within a given pathMatcher, + * priority determines the order in which a load balancer interpretsrouteRules. RouteRules are evaluated in order + * of priority, from the lowest to highest number. The priority of a + * rule decreases as its number increases (1, 2, 3, N+1). The first rule + * that matches the request is applied. + * You cannot configure two or more routeRules with the same priority. + * Priority for each rule must be set to a number from 0 to 2147483647 + * inclusive. + * Priority numbers can have gaps, which enable you to add or remove rules + * in the future without affecting the rest of the rules. For example, 1, 2, + * 3, 4, 5, 9, 12, 16 is a valid series of priority numbers to which you + * could add rules numbered from 6 to 8, 10 to 11, and 13 to 15 in the future + * without any impact on existing rules. * * Generated from protobuf field optional int32 priority = 445151652; */ protected $priority = null; /** - * In response to a matching matchRule, the load balancer performs advanced routing actions, such as URL rewrites and header transformations, before forwarding the request to the selected backend. Only one of urlRedirect, service or routeAction.weightedBackendService can be set. URL maps for classic Application Load Balancers only support the urlRewrite action within a route rule's routeAction. + * In response to a matching matchRule, the load balancer + * performs advanced routing actions, such as URL rewrites and header + * transformations, before forwarding the request to the selected backend. + * Only one of urlRedirect, service orrouteAction.weightedBackendService can be set. + * URL maps for classic Application Load Balancers only support + * the urlRewrite action within a route rule'srouteAction. * * Generated from protobuf field optional .google.cloud.compute.v1.HttpRouteAction route_action = 424563948; */ protected $route_action = null; /** - * The full or partial URL of the backend service resource to which traffic is directed if this rule is matched. If routeAction is also specified, advanced routing actions, such as URL rewrites, take effect before sending the request to the backend. Only one of urlRedirect, service or routeAction.weightedBackendService can be set. + * The full or partial URL of the backend service resource to which traffic + * is directed if this rule is matched. If routeAction is + * also specified, advanced routing actions, such as URL rewrites, + * take effect before sending the request to the backend. + * Only one of urlRedirect, service orrouteAction.weightedBackendService can be set. * * Generated from protobuf field optional string service = 373540533; */ protected $service = null; /** - * When this rule is matched, the request is redirected to a URL specified by urlRedirect. Only one of urlRedirect, service or routeAction.weightedBackendService can be set. Not supported when the URL map is bound to a target gRPC proxy. + * When this rule is matched, the request is redirected to a URL + * specified by urlRedirect. + * Only one of urlRedirect, service orrouteAction.weightedBackendService can be set. + * Not supported when the URL map is bound to a target gRPC proxy. * * Generated from protobuf field optional .google.cloud.compute.v1.HttpRedirectAction url_redirect = 405147820; */ @@ -71,21 +134,83 @@ class HttpRouteRule extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type \Google\Cloud\Compute\V1\CustomErrorResponsePolicy $custom_error_response_policy - * customErrorResponsePolicy specifies how the Load Balancer returns error responses when BackendServiceor BackendBucket responds with an error. If a policy for an error code is not configured for the RouteRule, a policy for the error code configured in pathMatcher.defaultCustomErrorResponsePolicy is applied. If one is not specified in pathMatcher.defaultCustomErrorResponsePolicy, the policy configured in UrlMap.defaultCustomErrorResponsePolicy takes effect. For example, consider a UrlMap with the following configuration: - UrlMap.defaultCustomErrorResponsePolicy are configured with policies for 5xx and 4xx errors - A RouteRule for /coming_soon/ is configured for the error code 404. If the request is for www.myotherdomain.com and a 404 is encountered, the policy under UrlMap.defaultCustomErrorResponsePolicy takes effect. If a 404 response is encountered for the request www.example.com/current_events/, the pathMatcher's policy takes effect. If however, the request for www.example.com/coming_soon/ encounters a 404, the policy in RouteRule.customErrorResponsePolicy takes effect. If any of the requests in this example encounter a 500 error code, the policy at UrlMap.defaultCustomErrorResponsePolicy takes effect. When used in conjunction with routeRules.routeAction.retryPolicy, retries take precedence. Only once all retries are exhausted, the customErrorResponsePolicy is applied. While attempting a retry, if load balancer is successful in reaching the service, the customErrorResponsePolicy is ignored and the response from the service is returned to the client. customErrorResponsePolicy is supported only for global external Application Load Balancers. + * customErrorResponsePolicy specifies how the Load + * Balancer returns error responses when BackendServiceorBackendBucket responds with an error. + * If a policy for an + * error code is not configured for the RouteRule, a policy for + * the error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If + * one is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy + * configured in UrlMap.defaultCustomErrorResponsePolicy takes + * effect. + * For example, consider a UrlMap with the following configuration: + * - UrlMap.defaultCustomErrorResponsePolicy are configured + * with policies for 5xx and 4xx errors + * - A RouteRule for /coming_soon/ is configured for the + * error code 404. + * If the request is for www.myotherdomain.com and a404 is encountered, the policy underUrlMap.defaultCustomErrorResponsePolicy takes effect. If a404 response is encountered for the requestwww.example.com/current_events/, the pathMatcher's policy + * takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404, + * the policy in RouteRule.customErrorResponsePolicy takes + * effect. If any of the requests in this example encounter a 500 + * error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect. + * When + * used in conjunction withrouteRules.routeAction.retryPolicy, retries take + * precedence. Only once all retries are exhausted, thecustomErrorResponsePolicy is applied. While attempting + * a retry, if load balancer is successful in reaching the + * service, the customErrorResponsePolicy is ignored and + * the response from the service is returned to the client. + * customErrorResponsePolicy is supported only for + * global external Application Load Balancers. * @type string $description - * The short description conveying the intent of this routeRule. The description can have a maximum length of 1024 characters. + * The short description conveying the intent of this routeRule. + * The description can have a maximum length of 1024 characters. * @type \Google\Cloud\Compute\V1\HttpHeaderAction $header_action - * Specifies changes to request and response headers that need to take effect for the selected backendService. The headerAction value specified here is applied before the matching pathMatchers[].headerAction and after pathMatchers[].routeRules[].routeAction.weightedBackendService.backendServiceWeightAction[].headerAction HeaderAction is not supported for load balancers that have their loadBalancingScheme set to EXTERNAL. Not supported when the URL map is bound to a target gRPC proxy that has validateForProxyless field set to true. + * Specifies changes to request and response headers that need to take effect + * for the selected backendService. + * The headerAction value specified here is applied before the + * matching pathMatchers[].headerAction and afterpathMatchers[].routeRules[].routeAction.weightedBackendService.backendServiceWeightAction[].headerAction + * HeaderAction is not supported for load balancers + * that have + * their loadBalancingScheme set to EXTERNAL. + * Not supported when the URL map is bound to a target gRPC proxy that + * has validateForProxyless field set to true. * @type array<\Google\Cloud\Compute\V1\HttpRouteRuleMatch>|\Google\Protobuf\Internal\RepeatedField $match_rules - * The list of criteria for matching attributes of a request to this routeRule. This list has OR semantics: the request matches this routeRule when any of the matchRules are satisfied. However predicates within a given matchRule have AND semantics. All predicates within a matchRule must match for the request to match the rule. + * The list of criteria for matching attributes of a request to thisrouteRule. This list has OR semantics: the request matches + * this routeRule when any of thematchRules are satisfied. However predicates within + * a given matchRule have AND semantics. All predicates + * within a matchRule must match for the request to + * match the rule. * @type int $priority - * For routeRules within a given pathMatcher, priority determines the order in which a load balancer interprets routeRules. RouteRules are evaluated in order of priority, from the lowest to highest number. The priority of a rule decreases as its number increases (1, 2, 3, N+1). The first rule that matches the request is applied. You cannot configure two or more routeRules with the same priority. Priority for each rule must be set to a number from 0 to 2147483647 inclusive. Priority numbers can have gaps, which enable you to add or remove rules in the future without affecting the rest of the rules. For example, 1, 2, 3, 4, 5, 9, 12, 16 is a valid series of priority numbers to which you could add rules numbered from 6 to 8, 10 to 11, and 13 to 15 in the future without any impact on existing rules. + * For routeRules within a given pathMatcher, + * priority determines the order in which a load balancer interpretsrouteRules. RouteRules are evaluated in order + * of priority, from the lowest to highest number. The priority of a + * rule decreases as its number increases (1, 2, 3, N+1). The first rule + * that matches the request is applied. + * You cannot configure two or more routeRules with the same priority. + * Priority for each rule must be set to a number from 0 to 2147483647 + * inclusive. + * Priority numbers can have gaps, which enable you to add or remove rules + * in the future without affecting the rest of the rules. For example, 1, 2, + * 3, 4, 5, 9, 12, 16 is a valid series of priority numbers to which you + * could add rules numbered from 6 to 8, 10 to 11, and 13 to 15 in the future + * without any impact on existing rules. * @type \Google\Cloud\Compute\V1\HttpRouteAction $route_action - * In response to a matching matchRule, the load balancer performs advanced routing actions, such as URL rewrites and header transformations, before forwarding the request to the selected backend. Only one of urlRedirect, service or routeAction.weightedBackendService can be set. URL maps for classic Application Load Balancers only support the urlRewrite action within a route rule's routeAction. + * In response to a matching matchRule, the load balancer + * performs advanced routing actions, such as URL rewrites and header + * transformations, before forwarding the request to the selected backend. + * Only one of urlRedirect, service orrouteAction.weightedBackendService can be set. + * URL maps for classic Application Load Balancers only support + * the urlRewrite action within a route rule'srouteAction. * @type string $service - * The full or partial URL of the backend service resource to which traffic is directed if this rule is matched. If routeAction is also specified, advanced routing actions, such as URL rewrites, take effect before sending the request to the backend. Only one of urlRedirect, service or routeAction.weightedBackendService can be set. + * The full or partial URL of the backend service resource to which traffic + * is directed if this rule is matched. If routeAction is + * also specified, advanced routing actions, such as URL rewrites, + * take effect before sending the request to the backend. + * Only one of urlRedirect, service orrouteAction.weightedBackendService can be set. * @type \Google\Cloud\Compute\V1\HttpRedirectAction $url_redirect - * When this rule is matched, the request is redirected to a URL specified by urlRedirect. Only one of urlRedirect, service or routeAction.weightedBackendService can be set. Not supported when the URL map is bound to a target gRPC proxy. + * When this rule is matched, the request is redirected to a URL + * specified by urlRedirect. + * Only one of urlRedirect, service orrouteAction.weightedBackendService can be set. + * Not supported when the URL map is bound to a target gRPC proxy. * } */ public function __construct($data = NULL) { @@ -94,7 +219,32 @@ public function __construct($data = NULL) { } /** - * customErrorResponsePolicy specifies how the Load Balancer returns error responses when BackendServiceor BackendBucket responds with an error. If a policy for an error code is not configured for the RouteRule, a policy for the error code configured in pathMatcher.defaultCustomErrorResponsePolicy is applied. If one is not specified in pathMatcher.defaultCustomErrorResponsePolicy, the policy configured in UrlMap.defaultCustomErrorResponsePolicy takes effect. For example, consider a UrlMap with the following configuration: - UrlMap.defaultCustomErrorResponsePolicy are configured with policies for 5xx and 4xx errors - A RouteRule for /coming_soon/ is configured for the error code 404. If the request is for www.myotherdomain.com and a 404 is encountered, the policy under UrlMap.defaultCustomErrorResponsePolicy takes effect. If a 404 response is encountered for the request www.example.com/current_events/, the pathMatcher's policy takes effect. If however, the request for www.example.com/coming_soon/ encounters a 404, the policy in RouteRule.customErrorResponsePolicy takes effect. If any of the requests in this example encounter a 500 error code, the policy at UrlMap.defaultCustomErrorResponsePolicy takes effect. When used in conjunction with routeRules.routeAction.retryPolicy, retries take precedence. Only once all retries are exhausted, the customErrorResponsePolicy is applied. While attempting a retry, if load balancer is successful in reaching the service, the customErrorResponsePolicy is ignored and the response from the service is returned to the client. customErrorResponsePolicy is supported only for global external Application Load Balancers. + * customErrorResponsePolicy specifies how the Load + * Balancer returns error responses when BackendServiceorBackendBucket responds with an error. + * If a policy for an + * error code is not configured for the RouteRule, a policy for + * the error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If + * one is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy + * configured in UrlMap.defaultCustomErrorResponsePolicy takes + * effect. + * For example, consider a UrlMap with the following configuration: + * - UrlMap.defaultCustomErrorResponsePolicy are configured + * with policies for 5xx and 4xx errors + * - A RouteRule for /coming_soon/ is configured for the + * error code 404. + * If the request is for www.myotherdomain.com and a404 is encountered, the policy underUrlMap.defaultCustomErrorResponsePolicy takes effect. If a404 response is encountered for the requestwww.example.com/current_events/, the pathMatcher's policy + * takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404, + * the policy in RouteRule.customErrorResponsePolicy takes + * effect. If any of the requests in this example encounter a 500 + * error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect. + * When + * used in conjunction withrouteRules.routeAction.retryPolicy, retries take + * precedence. Only once all retries are exhausted, thecustomErrorResponsePolicy is applied. While attempting + * a retry, if load balancer is successful in reaching the + * service, the customErrorResponsePolicy is ignored and + * the response from the service is returned to the client. + * customErrorResponsePolicy is supported only for + * global external Application Load Balancers. * * Generated from protobuf field optional .google.cloud.compute.v1.CustomErrorResponsePolicy custom_error_response_policy = 202816619; * @return \Google\Cloud\Compute\V1\CustomErrorResponsePolicy|null @@ -115,7 +265,32 @@ public function clearCustomErrorResponsePolicy() } /** - * customErrorResponsePolicy specifies how the Load Balancer returns error responses when BackendServiceor BackendBucket responds with an error. If a policy for an error code is not configured for the RouteRule, a policy for the error code configured in pathMatcher.defaultCustomErrorResponsePolicy is applied. If one is not specified in pathMatcher.defaultCustomErrorResponsePolicy, the policy configured in UrlMap.defaultCustomErrorResponsePolicy takes effect. For example, consider a UrlMap with the following configuration: - UrlMap.defaultCustomErrorResponsePolicy are configured with policies for 5xx and 4xx errors - A RouteRule for /coming_soon/ is configured for the error code 404. If the request is for www.myotherdomain.com and a 404 is encountered, the policy under UrlMap.defaultCustomErrorResponsePolicy takes effect. If a 404 response is encountered for the request www.example.com/current_events/, the pathMatcher's policy takes effect. If however, the request for www.example.com/coming_soon/ encounters a 404, the policy in RouteRule.customErrorResponsePolicy takes effect. If any of the requests in this example encounter a 500 error code, the policy at UrlMap.defaultCustomErrorResponsePolicy takes effect. When used in conjunction with routeRules.routeAction.retryPolicy, retries take precedence. Only once all retries are exhausted, the customErrorResponsePolicy is applied. While attempting a retry, if load balancer is successful in reaching the service, the customErrorResponsePolicy is ignored and the response from the service is returned to the client. customErrorResponsePolicy is supported only for global external Application Load Balancers. + * customErrorResponsePolicy specifies how the Load + * Balancer returns error responses when BackendServiceorBackendBucket responds with an error. + * If a policy for an + * error code is not configured for the RouteRule, a policy for + * the error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If + * one is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy + * configured in UrlMap.defaultCustomErrorResponsePolicy takes + * effect. + * For example, consider a UrlMap with the following configuration: + * - UrlMap.defaultCustomErrorResponsePolicy are configured + * with policies for 5xx and 4xx errors + * - A RouteRule for /coming_soon/ is configured for the + * error code 404. + * If the request is for www.myotherdomain.com and a404 is encountered, the policy underUrlMap.defaultCustomErrorResponsePolicy takes effect. If a404 response is encountered for the requestwww.example.com/current_events/, the pathMatcher's policy + * takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404, + * the policy in RouteRule.customErrorResponsePolicy takes + * effect. If any of the requests in this example encounter a 500 + * error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect. + * When + * used in conjunction withrouteRules.routeAction.retryPolicy, retries take + * precedence. Only once all retries are exhausted, thecustomErrorResponsePolicy is applied. While attempting + * a retry, if load balancer is successful in reaching the + * service, the customErrorResponsePolicy is ignored and + * the response from the service is returned to the client. + * customErrorResponsePolicy is supported only for + * global external Application Load Balancers. * * Generated from protobuf field optional .google.cloud.compute.v1.CustomErrorResponsePolicy custom_error_response_policy = 202816619; * @param \Google\Cloud\Compute\V1\CustomErrorResponsePolicy $var @@ -130,7 +305,8 @@ public function setCustomErrorResponsePolicy($var) } /** - * The short description conveying the intent of this routeRule. The description can have a maximum length of 1024 characters. + * The short description conveying the intent of this routeRule. + * The description can have a maximum length of 1024 characters. * * Generated from protobuf field optional string description = 422937596; * @return string @@ -151,7 +327,8 @@ public function clearDescription() } /** - * The short description conveying the intent of this routeRule. The description can have a maximum length of 1024 characters. + * The short description conveying the intent of this routeRule. + * The description can have a maximum length of 1024 characters. * * Generated from protobuf field optional string description = 422937596; * @param string $var @@ -166,7 +343,15 @@ public function setDescription($var) } /** - * Specifies changes to request and response headers that need to take effect for the selected backendService. The headerAction value specified here is applied before the matching pathMatchers[].headerAction and after pathMatchers[].routeRules[].routeAction.weightedBackendService.backendServiceWeightAction[].headerAction HeaderAction is not supported for load balancers that have their loadBalancingScheme set to EXTERNAL. Not supported when the URL map is bound to a target gRPC proxy that has validateForProxyless field set to true. + * Specifies changes to request and response headers that need to take effect + * for the selected backendService. + * The headerAction value specified here is applied before the + * matching pathMatchers[].headerAction and afterpathMatchers[].routeRules[].routeAction.weightedBackendService.backendServiceWeightAction[].headerAction + * HeaderAction is not supported for load balancers + * that have + * their loadBalancingScheme set to EXTERNAL. + * Not supported when the URL map is bound to a target gRPC proxy that + * has validateForProxyless field set to true. * * Generated from protobuf field optional .google.cloud.compute.v1.HttpHeaderAction header_action = 328077352; * @return \Google\Cloud\Compute\V1\HttpHeaderAction|null @@ -187,7 +372,15 @@ public function clearHeaderAction() } /** - * Specifies changes to request and response headers that need to take effect for the selected backendService. The headerAction value specified here is applied before the matching pathMatchers[].headerAction and after pathMatchers[].routeRules[].routeAction.weightedBackendService.backendServiceWeightAction[].headerAction HeaderAction is not supported for load balancers that have their loadBalancingScheme set to EXTERNAL. Not supported when the URL map is bound to a target gRPC proxy that has validateForProxyless field set to true. + * Specifies changes to request and response headers that need to take effect + * for the selected backendService. + * The headerAction value specified here is applied before the + * matching pathMatchers[].headerAction and afterpathMatchers[].routeRules[].routeAction.weightedBackendService.backendServiceWeightAction[].headerAction + * HeaderAction is not supported for load balancers + * that have + * their loadBalancingScheme set to EXTERNAL. + * Not supported when the URL map is bound to a target gRPC proxy that + * has validateForProxyless field set to true. * * Generated from protobuf field optional .google.cloud.compute.v1.HttpHeaderAction header_action = 328077352; * @param \Google\Cloud\Compute\V1\HttpHeaderAction $var @@ -202,7 +395,11 @@ public function setHeaderAction($var) } /** - * The list of criteria for matching attributes of a request to this routeRule. This list has OR semantics: the request matches this routeRule when any of the matchRules are satisfied. However predicates within a given matchRule have AND semantics. All predicates within a matchRule must match for the request to match the rule. + * The list of criteria for matching attributes of a request to thisrouteRule. This list has OR semantics: the request matches + * this routeRule when any of thematchRules are satisfied. However predicates within + * a given matchRule have AND semantics. All predicates + * within a matchRule must match for the request to + * match the rule. * * Generated from protobuf field repeated .google.cloud.compute.v1.HttpRouteRuleMatch match_rules = 376200701; * @return \Google\Protobuf\Internal\RepeatedField @@ -213,7 +410,11 @@ public function getMatchRules() } /** - * The list of criteria for matching attributes of a request to this routeRule. This list has OR semantics: the request matches this routeRule when any of the matchRules are satisfied. However predicates within a given matchRule have AND semantics. All predicates within a matchRule must match for the request to match the rule. + * The list of criteria for matching attributes of a request to thisrouteRule. This list has OR semantics: the request matches + * this routeRule when any of thematchRules are satisfied. However predicates within + * a given matchRule have AND semantics. All predicates + * within a matchRule must match for the request to + * match the rule. * * Generated from protobuf field repeated .google.cloud.compute.v1.HttpRouteRuleMatch match_rules = 376200701; * @param array<\Google\Cloud\Compute\V1\HttpRouteRuleMatch>|\Google\Protobuf\Internal\RepeatedField $var @@ -228,7 +429,19 @@ public function setMatchRules($var) } /** - * For routeRules within a given pathMatcher, priority determines the order in which a load balancer interprets routeRules. RouteRules are evaluated in order of priority, from the lowest to highest number. The priority of a rule decreases as its number increases (1, 2, 3, N+1). The first rule that matches the request is applied. You cannot configure two or more routeRules with the same priority. Priority for each rule must be set to a number from 0 to 2147483647 inclusive. Priority numbers can have gaps, which enable you to add or remove rules in the future without affecting the rest of the rules. For example, 1, 2, 3, 4, 5, 9, 12, 16 is a valid series of priority numbers to which you could add rules numbered from 6 to 8, 10 to 11, and 13 to 15 in the future without any impact on existing rules. + * For routeRules within a given pathMatcher, + * priority determines the order in which a load balancer interpretsrouteRules. RouteRules are evaluated in order + * of priority, from the lowest to highest number. The priority of a + * rule decreases as its number increases (1, 2, 3, N+1). The first rule + * that matches the request is applied. + * You cannot configure two or more routeRules with the same priority. + * Priority for each rule must be set to a number from 0 to 2147483647 + * inclusive. + * Priority numbers can have gaps, which enable you to add or remove rules + * in the future without affecting the rest of the rules. For example, 1, 2, + * 3, 4, 5, 9, 12, 16 is a valid series of priority numbers to which you + * could add rules numbered from 6 to 8, 10 to 11, and 13 to 15 in the future + * without any impact on existing rules. * * Generated from protobuf field optional int32 priority = 445151652; * @return int @@ -249,7 +462,19 @@ public function clearPriority() } /** - * For routeRules within a given pathMatcher, priority determines the order in which a load balancer interprets routeRules. RouteRules are evaluated in order of priority, from the lowest to highest number. The priority of a rule decreases as its number increases (1, 2, 3, N+1). The first rule that matches the request is applied. You cannot configure two or more routeRules with the same priority. Priority for each rule must be set to a number from 0 to 2147483647 inclusive. Priority numbers can have gaps, which enable you to add or remove rules in the future without affecting the rest of the rules. For example, 1, 2, 3, 4, 5, 9, 12, 16 is a valid series of priority numbers to which you could add rules numbered from 6 to 8, 10 to 11, and 13 to 15 in the future without any impact on existing rules. + * For routeRules within a given pathMatcher, + * priority determines the order in which a load balancer interpretsrouteRules. RouteRules are evaluated in order + * of priority, from the lowest to highest number. The priority of a + * rule decreases as its number increases (1, 2, 3, N+1). The first rule + * that matches the request is applied. + * You cannot configure two or more routeRules with the same priority. + * Priority for each rule must be set to a number from 0 to 2147483647 + * inclusive. + * Priority numbers can have gaps, which enable you to add or remove rules + * in the future without affecting the rest of the rules. For example, 1, 2, + * 3, 4, 5, 9, 12, 16 is a valid series of priority numbers to which you + * could add rules numbered from 6 to 8, 10 to 11, and 13 to 15 in the future + * without any impact on existing rules. * * Generated from protobuf field optional int32 priority = 445151652; * @param int $var @@ -264,7 +489,12 @@ public function setPriority($var) } /** - * In response to a matching matchRule, the load balancer performs advanced routing actions, such as URL rewrites and header transformations, before forwarding the request to the selected backend. Only one of urlRedirect, service or routeAction.weightedBackendService can be set. URL maps for classic Application Load Balancers only support the urlRewrite action within a route rule's routeAction. + * In response to a matching matchRule, the load balancer + * performs advanced routing actions, such as URL rewrites and header + * transformations, before forwarding the request to the selected backend. + * Only one of urlRedirect, service orrouteAction.weightedBackendService can be set. + * URL maps for classic Application Load Balancers only support + * the urlRewrite action within a route rule'srouteAction. * * Generated from protobuf field optional .google.cloud.compute.v1.HttpRouteAction route_action = 424563948; * @return \Google\Cloud\Compute\V1\HttpRouteAction|null @@ -285,7 +515,12 @@ public function clearRouteAction() } /** - * In response to a matching matchRule, the load balancer performs advanced routing actions, such as URL rewrites and header transformations, before forwarding the request to the selected backend. Only one of urlRedirect, service or routeAction.weightedBackendService can be set. URL maps for classic Application Load Balancers only support the urlRewrite action within a route rule's routeAction. + * In response to a matching matchRule, the load balancer + * performs advanced routing actions, such as URL rewrites and header + * transformations, before forwarding the request to the selected backend. + * Only one of urlRedirect, service orrouteAction.weightedBackendService can be set. + * URL maps for classic Application Load Balancers only support + * the urlRewrite action within a route rule'srouteAction. * * Generated from protobuf field optional .google.cloud.compute.v1.HttpRouteAction route_action = 424563948; * @param \Google\Cloud\Compute\V1\HttpRouteAction $var @@ -300,7 +535,11 @@ public function setRouteAction($var) } /** - * The full or partial URL of the backend service resource to which traffic is directed if this rule is matched. If routeAction is also specified, advanced routing actions, such as URL rewrites, take effect before sending the request to the backend. Only one of urlRedirect, service or routeAction.weightedBackendService can be set. + * The full or partial URL of the backend service resource to which traffic + * is directed if this rule is matched. If routeAction is + * also specified, advanced routing actions, such as URL rewrites, + * take effect before sending the request to the backend. + * Only one of urlRedirect, service orrouteAction.weightedBackendService can be set. * * Generated from protobuf field optional string service = 373540533; * @return string @@ -321,7 +560,11 @@ public function clearService() } /** - * The full or partial URL of the backend service resource to which traffic is directed if this rule is matched. If routeAction is also specified, advanced routing actions, such as URL rewrites, take effect before sending the request to the backend. Only one of urlRedirect, service or routeAction.weightedBackendService can be set. + * The full or partial URL of the backend service resource to which traffic + * is directed if this rule is matched. If routeAction is + * also specified, advanced routing actions, such as URL rewrites, + * take effect before sending the request to the backend. + * Only one of urlRedirect, service orrouteAction.weightedBackendService can be set. * * Generated from protobuf field optional string service = 373540533; * @param string $var @@ -336,7 +579,10 @@ public function setService($var) } /** - * When this rule is matched, the request is redirected to a URL specified by urlRedirect. Only one of urlRedirect, service or routeAction.weightedBackendService can be set. Not supported when the URL map is bound to a target gRPC proxy. + * When this rule is matched, the request is redirected to a URL + * specified by urlRedirect. + * Only one of urlRedirect, service orrouteAction.weightedBackendService can be set. + * Not supported when the URL map is bound to a target gRPC proxy. * * Generated from protobuf field optional .google.cloud.compute.v1.HttpRedirectAction url_redirect = 405147820; * @return \Google\Cloud\Compute\V1\HttpRedirectAction|null @@ -357,7 +603,10 @@ public function clearUrlRedirect() } /** - * When this rule is matched, the request is redirected to a URL specified by urlRedirect. Only one of urlRedirect, service or routeAction.weightedBackendService can be set. Not supported when the URL map is bound to a target gRPC proxy. + * When this rule is matched, the request is redirected to a URL + * specified by urlRedirect. + * Only one of urlRedirect, service orrouteAction.weightedBackendService can be set. + * Not supported when the URL map is bound to a target gRPC proxy. * * Generated from protobuf field optional .google.cloud.compute.v1.HttpRedirectAction url_redirect = 405147820; * @param \Google\Cloud\Compute\V1\HttpRedirectAction $var diff --git a/Compute/src/V1/HttpRouteRuleMatch.php b/Compute/src/V1/HttpRouteRuleMatch.php index 8d8edffb284f..5e502426edc7 100644 --- a/Compute/src/V1/HttpRouteRuleMatch.php +++ b/Compute/src/V1/HttpRouteRuleMatch.php @@ -9,56 +9,104 @@ use Google\Protobuf\Internal\GPBUtil; /** - * HttpRouteRuleMatch specifies a set of criteria for matching requests to an HttpRouteRule. All specified criteria must be satisfied for a match to occur. + * HttpRouteRuleMatch specifies a set of criteria for matching + * requests to an HttpRouteRule. All specified criteria must + * be satisfied for a match to occur. * * Generated from protobuf message google.cloud.compute.v1.HttpRouteRuleMatch */ class HttpRouteRuleMatch extends \Google\Protobuf\Internal\Message { /** - * For satisfying the matchRule condition, the path of the request must exactly match the value specified in fullPathMatch after removing any query parameters and anchor that may be part of the original URL. fullPathMatch must be from 1 to 1024 characters. Only one of prefixMatch, fullPathMatch or regexMatch must be specified. + * For satisfying the matchRule condition, the path of the + * request must exactly match the value specified infullPathMatch after removing any query parameters and anchor + * that may be part of the original URL. + * fullPathMatch must be from 1 to 1024 characters. + * Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be + * specified. * * Generated from protobuf field optional string full_path_match = 214598875; */ protected $full_path_match = null; /** - * Specifies a list of header match criteria, all of which must match corresponding headers in the request. + * Specifies a list of header match criteria, all of which must match + * corresponding headers in the request. * * Generated from protobuf field repeated .google.cloud.compute.v1.HttpHeaderMatch header_matches = 361903489; */ private $header_matches; /** - * Specifies that prefixMatch and fullPathMatch matches are case sensitive. The default value is false. ignoreCase must not be used with regexMatch. Not supported when the URL map is bound to a target gRPC proxy. + * Specifies that prefixMatch and fullPathMatch + * matches are case sensitive. + * The default value is false. + * ignoreCase must not be used with regexMatch. + * Not supported when the URL map is bound to a target gRPC proxy. * * Generated from protobuf field optional bool ignore_case = 464324989; */ protected $ignore_case = null; /** - * Opaque filter criteria used by the load balancer to restrict routing configuration to a limited set of xDS compliant clients. In their xDS requests to the load balancer, xDS clients present node metadata. When there is a match, the relevant routing configuration is made available to those proxies. For each metadataFilter in this list, if its filterMatchCriteria is set to MATCH_ANY, at least one of the filterLabels must match the corresponding label provided in the metadata. If its filterMatchCriteria is set to MATCH_ALL, then all of its filterLabels must match with corresponding labels provided in the metadata. If multiple metadata filters are specified, all of them need to be satisfied in order to be considered a match. metadataFilters specified here is applied after those specified in ForwardingRule that refers to the UrlMap this HttpRouteRuleMatch belongs to. metadataFilters only applies to load balancers that have loadBalancingScheme set to INTERNAL_SELF_MANAGED. Not supported when the URL map is bound to a target gRPC proxy that has validateForProxyless field set to true. + * Opaque filter criteria used by the load balancer to restrict routing + * configuration to a limited set of xDS + * compliant clients. In their xDS requests to the load balancer, xDS clients + * present node + * metadata. When there is a match, the relevant routing configuration + * is made available to those proxies. + * For each metadataFilter in this list, if itsfilterMatchCriteria is set to MATCH_ANY, at least one of thefilterLabels must match the corresponding label provided in + * the metadata. If its filterMatchCriteria is set to + * MATCH_ALL, then all of its filterLabels must match with + * corresponding labels provided in the metadata. If multiple + * metadata filters are specified, all of them need to be + * satisfied in order to be considered a match. + * metadataFilters specified here is applied after those + * specified in ForwardingRule that refers to theUrlMap this HttpRouteRuleMatch belongs to. + * metadataFilters only applies to load balancers that haveloadBalancingScheme set toINTERNAL_SELF_MANAGED. + * Not supported when the URL map is bound to a target gRPC proxy that + * has validateForProxyless field set to true. * * Generated from protobuf field repeated .google.cloud.compute.v1.MetadataFilter metadata_filters = 464725739; */ private $metadata_filters; /** - * If specified, the route is a pattern match expression that must match the :path header once the query string is removed. A pattern match allows you to match - The value must be between 1 and 1024 characters - The pattern must start with a leading slash ("/") - There may be no more than 5 operators in pattern Precisely one of prefix_match, full_path_match, regex_match or path_template_match must be set. + * If specified, the route is a pattern match expression that must match the + * :path header once the query string is removed. + * A pattern match allows you to match + * - The value must be between 1 and 1024 characters + * - The pattern must start with a leading slash ("/") + * - There may be no more than 5 operators in pattern + * Precisely one ofprefix_match, full_path_match,regex_match or path_template_match must be set. * * Generated from protobuf field optional string path_template_match = 292348186; */ protected $path_template_match = null; /** - * For satisfying the matchRule condition, the request's path must begin with the specified prefixMatch. prefixMatch must begin with a /. The value must be from 1 to 1024 characters. Only one of prefixMatch, fullPathMatch or regexMatch must be specified. + * For satisfying the matchRule condition, the request's + * path must begin with the specified prefixMatch.prefixMatch must begin with a /. + * The value must be from 1 to 1024 characters. + * Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be + * specified. + * specified. * * Generated from protobuf field optional string prefix_match = 257898968; */ protected $prefix_match = null; /** - * Specifies a list of query parameter match criteria, all of which must match corresponding query parameters in the request. Not supported when the URL map is bound to a target gRPC proxy. + * Specifies a list of query parameter match criteria, all of which must + * match corresponding query parameters in the request. + * Not supported when the URL map is bound to a target gRPC proxy. * * Generated from protobuf field repeated .google.cloud.compute.v1.HttpQueryParameterMatch query_parameter_matches = 286231270; */ private $query_parameter_matches; /** - * For satisfying the matchRule condition, the path of the request must satisfy the regular expression specified in regexMatch after removing any query parameters and anchor supplied with the original URL. For more information about regular expression syntax, see Syntax. Only one of prefixMatch, fullPathMatch or regexMatch must be specified. Regular expressions can only be used when the loadBalancingScheme is set to INTERNAL_SELF_MANAGED. + * For satisfying the matchRule condition, the path of the + * request must satisfy the regular expression specified inregexMatch after removing any query parameters and anchor + * supplied with the original URL. For + * more information about regular expression syntax, see Syntax. + * Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be + * specified. + * Regular expressions can only be used when the loadBalancingScheme is + * set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED orINTERNAL_MANAGED. * * Generated from protobuf field optional string regex_match = 107387853; */ @@ -71,21 +119,67 @@ class HttpRouteRuleMatch extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $full_path_match - * For satisfying the matchRule condition, the path of the request must exactly match the value specified in fullPathMatch after removing any query parameters and anchor that may be part of the original URL. fullPathMatch must be from 1 to 1024 characters. Only one of prefixMatch, fullPathMatch or regexMatch must be specified. + * For satisfying the matchRule condition, the path of the + * request must exactly match the value specified infullPathMatch after removing any query parameters and anchor + * that may be part of the original URL. + * fullPathMatch must be from 1 to 1024 characters. + * Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be + * specified. * @type array<\Google\Cloud\Compute\V1\HttpHeaderMatch>|\Google\Protobuf\Internal\RepeatedField $header_matches - * Specifies a list of header match criteria, all of which must match corresponding headers in the request. + * Specifies a list of header match criteria, all of which must match + * corresponding headers in the request. * @type bool $ignore_case - * Specifies that prefixMatch and fullPathMatch matches are case sensitive. The default value is false. ignoreCase must not be used with regexMatch. Not supported when the URL map is bound to a target gRPC proxy. + * Specifies that prefixMatch and fullPathMatch + * matches are case sensitive. + * The default value is false. + * ignoreCase must not be used with regexMatch. + * Not supported when the URL map is bound to a target gRPC proxy. * @type array<\Google\Cloud\Compute\V1\MetadataFilter>|\Google\Protobuf\Internal\RepeatedField $metadata_filters - * Opaque filter criteria used by the load balancer to restrict routing configuration to a limited set of xDS compliant clients. In their xDS requests to the load balancer, xDS clients present node metadata. When there is a match, the relevant routing configuration is made available to those proxies. For each metadataFilter in this list, if its filterMatchCriteria is set to MATCH_ANY, at least one of the filterLabels must match the corresponding label provided in the metadata. If its filterMatchCriteria is set to MATCH_ALL, then all of its filterLabels must match with corresponding labels provided in the metadata. If multiple metadata filters are specified, all of them need to be satisfied in order to be considered a match. metadataFilters specified here is applied after those specified in ForwardingRule that refers to the UrlMap this HttpRouteRuleMatch belongs to. metadataFilters only applies to load balancers that have loadBalancingScheme set to INTERNAL_SELF_MANAGED. Not supported when the URL map is bound to a target gRPC proxy that has validateForProxyless field set to true. + * Opaque filter criteria used by the load balancer to restrict routing + * configuration to a limited set of xDS + * compliant clients. In their xDS requests to the load balancer, xDS clients + * present node + * metadata. When there is a match, the relevant routing configuration + * is made available to those proxies. + * For each metadataFilter in this list, if itsfilterMatchCriteria is set to MATCH_ANY, at least one of thefilterLabels must match the corresponding label provided in + * the metadata. If its filterMatchCriteria is set to + * MATCH_ALL, then all of its filterLabels must match with + * corresponding labels provided in the metadata. If multiple + * metadata filters are specified, all of them need to be + * satisfied in order to be considered a match. + * metadataFilters specified here is applied after those + * specified in ForwardingRule that refers to theUrlMap this HttpRouteRuleMatch belongs to. + * metadataFilters only applies to load balancers that haveloadBalancingScheme set toINTERNAL_SELF_MANAGED. + * Not supported when the URL map is bound to a target gRPC proxy that + * has validateForProxyless field set to true. * @type string $path_template_match - * If specified, the route is a pattern match expression that must match the :path header once the query string is removed. A pattern match allows you to match - The value must be between 1 and 1024 characters - The pattern must start with a leading slash ("/") - There may be no more than 5 operators in pattern Precisely one of prefix_match, full_path_match, regex_match or path_template_match must be set. + * If specified, the route is a pattern match expression that must match the + * :path header once the query string is removed. + * A pattern match allows you to match + * - The value must be between 1 and 1024 characters + * - The pattern must start with a leading slash ("/") + * - There may be no more than 5 operators in pattern + * Precisely one ofprefix_match, full_path_match,regex_match or path_template_match must be set. * @type string $prefix_match - * For satisfying the matchRule condition, the request's path must begin with the specified prefixMatch. prefixMatch must begin with a /. The value must be from 1 to 1024 characters. Only one of prefixMatch, fullPathMatch or regexMatch must be specified. + * For satisfying the matchRule condition, the request's + * path must begin with the specified prefixMatch.prefixMatch must begin with a /. + * The value must be from 1 to 1024 characters. + * Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be + * specified. + * specified. * @type array<\Google\Cloud\Compute\V1\HttpQueryParameterMatch>|\Google\Protobuf\Internal\RepeatedField $query_parameter_matches - * Specifies a list of query parameter match criteria, all of which must match corresponding query parameters in the request. Not supported when the URL map is bound to a target gRPC proxy. + * Specifies a list of query parameter match criteria, all of which must + * match corresponding query parameters in the request. + * Not supported when the URL map is bound to a target gRPC proxy. * @type string $regex_match - * For satisfying the matchRule condition, the path of the request must satisfy the regular expression specified in regexMatch after removing any query parameters and anchor supplied with the original URL. For more information about regular expression syntax, see Syntax. Only one of prefixMatch, fullPathMatch or regexMatch must be specified. Regular expressions can only be used when the loadBalancingScheme is set to INTERNAL_SELF_MANAGED. + * For satisfying the matchRule condition, the path of the + * request must satisfy the regular expression specified inregexMatch after removing any query parameters and anchor + * supplied with the original URL. For + * more information about regular expression syntax, see Syntax. + * Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be + * specified. + * Regular expressions can only be used when the loadBalancingScheme is + * set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED orINTERNAL_MANAGED. * } */ public function __construct($data = NULL) { @@ -94,7 +188,12 @@ public function __construct($data = NULL) { } /** - * For satisfying the matchRule condition, the path of the request must exactly match the value specified in fullPathMatch after removing any query parameters and anchor that may be part of the original URL. fullPathMatch must be from 1 to 1024 characters. Only one of prefixMatch, fullPathMatch or regexMatch must be specified. + * For satisfying the matchRule condition, the path of the + * request must exactly match the value specified infullPathMatch after removing any query parameters and anchor + * that may be part of the original URL. + * fullPathMatch must be from 1 to 1024 characters. + * Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be + * specified. * * Generated from protobuf field optional string full_path_match = 214598875; * @return string @@ -115,7 +214,12 @@ public function clearFullPathMatch() } /** - * For satisfying the matchRule condition, the path of the request must exactly match the value specified in fullPathMatch after removing any query parameters and anchor that may be part of the original URL. fullPathMatch must be from 1 to 1024 characters. Only one of prefixMatch, fullPathMatch or regexMatch must be specified. + * For satisfying the matchRule condition, the path of the + * request must exactly match the value specified infullPathMatch after removing any query parameters and anchor + * that may be part of the original URL. + * fullPathMatch must be from 1 to 1024 characters. + * Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be + * specified. * * Generated from protobuf field optional string full_path_match = 214598875; * @param string $var @@ -130,7 +234,8 @@ public function setFullPathMatch($var) } /** - * Specifies a list of header match criteria, all of which must match corresponding headers in the request. + * Specifies a list of header match criteria, all of which must match + * corresponding headers in the request. * * Generated from protobuf field repeated .google.cloud.compute.v1.HttpHeaderMatch header_matches = 361903489; * @return \Google\Protobuf\Internal\RepeatedField @@ -141,7 +246,8 @@ public function getHeaderMatches() } /** - * Specifies a list of header match criteria, all of which must match corresponding headers in the request. + * Specifies a list of header match criteria, all of which must match + * corresponding headers in the request. * * Generated from protobuf field repeated .google.cloud.compute.v1.HttpHeaderMatch header_matches = 361903489; * @param array<\Google\Cloud\Compute\V1\HttpHeaderMatch>|\Google\Protobuf\Internal\RepeatedField $var @@ -156,7 +262,11 @@ public function setHeaderMatches($var) } /** - * Specifies that prefixMatch and fullPathMatch matches are case sensitive. The default value is false. ignoreCase must not be used with regexMatch. Not supported when the URL map is bound to a target gRPC proxy. + * Specifies that prefixMatch and fullPathMatch + * matches are case sensitive. + * The default value is false. + * ignoreCase must not be used with regexMatch. + * Not supported when the URL map is bound to a target gRPC proxy. * * Generated from protobuf field optional bool ignore_case = 464324989; * @return bool @@ -177,7 +287,11 @@ public function clearIgnoreCase() } /** - * Specifies that prefixMatch and fullPathMatch matches are case sensitive. The default value is false. ignoreCase must not be used with regexMatch. Not supported when the URL map is bound to a target gRPC proxy. + * Specifies that prefixMatch and fullPathMatch + * matches are case sensitive. + * The default value is false. + * ignoreCase must not be used with regexMatch. + * Not supported when the URL map is bound to a target gRPC proxy. * * Generated from protobuf field optional bool ignore_case = 464324989; * @param bool $var @@ -192,7 +306,23 @@ public function setIgnoreCase($var) } /** - * Opaque filter criteria used by the load balancer to restrict routing configuration to a limited set of xDS compliant clients. In their xDS requests to the load balancer, xDS clients present node metadata. When there is a match, the relevant routing configuration is made available to those proxies. For each metadataFilter in this list, if its filterMatchCriteria is set to MATCH_ANY, at least one of the filterLabels must match the corresponding label provided in the metadata. If its filterMatchCriteria is set to MATCH_ALL, then all of its filterLabels must match with corresponding labels provided in the metadata. If multiple metadata filters are specified, all of them need to be satisfied in order to be considered a match. metadataFilters specified here is applied after those specified in ForwardingRule that refers to the UrlMap this HttpRouteRuleMatch belongs to. metadataFilters only applies to load balancers that have loadBalancingScheme set to INTERNAL_SELF_MANAGED. Not supported when the URL map is bound to a target gRPC proxy that has validateForProxyless field set to true. + * Opaque filter criteria used by the load balancer to restrict routing + * configuration to a limited set of xDS + * compliant clients. In their xDS requests to the load balancer, xDS clients + * present node + * metadata. When there is a match, the relevant routing configuration + * is made available to those proxies. + * For each metadataFilter in this list, if itsfilterMatchCriteria is set to MATCH_ANY, at least one of thefilterLabels must match the corresponding label provided in + * the metadata. If its filterMatchCriteria is set to + * MATCH_ALL, then all of its filterLabels must match with + * corresponding labels provided in the metadata. If multiple + * metadata filters are specified, all of them need to be + * satisfied in order to be considered a match. + * metadataFilters specified here is applied after those + * specified in ForwardingRule that refers to theUrlMap this HttpRouteRuleMatch belongs to. + * metadataFilters only applies to load balancers that haveloadBalancingScheme set toINTERNAL_SELF_MANAGED. + * Not supported when the URL map is bound to a target gRPC proxy that + * has validateForProxyless field set to true. * * Generated from protobuf field repeated .google.cloud.compute.v1.MetadataFilter metadata_filters = 464725739; * @return \Google\Protobuf\Internal\RepeatedField @@ -203,7 +333,23 @@ public function getMetadataFilters() } /** - * Opaque filter criteria used by the load balancer to restrict routing configuration to a limited set of xDS compliant clients. In their xDS requests to the load balancer, xDS clients present node metadata. When there is a match, the relevant routing configuration is made available to those proxies. For each metadataFilter in this list, if its filterMatchCriteria is set to MATCH_ANY, at least one of the filterLabels must match the corresponding label provided in the metadata. If its filterMatchCriteria is set to MATCH_ALL, then all of its filterLabels must match with corresponding labels provided in the metadata. If multiple metadata filters are specified, all of them need to be satisfied in order to be considered a match. metadataFilters specified here is applied after those specified in ForwardingRule that refers to the UrlMap this HttpRouteRuleMatch belongs to. metadataFilters only applies to load balancers that have loadBalancingScheme set to INTERNAL_SELF_MANAGED. Not supported when the URL map is bound to a target gRPC proxy that has validateForProxyless field set to true. + * Opaque filter criteria used by the load balancer to restrict routing + * configuration to a limited set of xDS + * compliant clients. In their xDS requests to the load balancer, xDS clients + * present node + * metadata. When there is a match, the relevant routing configuration + * is made available to those proxies. + * For each metadataFilter in this list, if itsfilterMatchCriteria is set to MATCH_ANY, at least one of thefilterLabels must match the corresponding label provided in + * the metadata. If its filterMatchCriteria is set to + * MATCH_ALL, then all of its filterLabels must match with + * corresponding labels provided in the metadata. If multiple + * metadata filters are specified, all of them need to be + * satisfied in order to be considered a match. + * metadataFilters specified here is applied after those + * specified in ForwardingRule that refers to theUrlMap this HttpRouteRuleMatch belongs to. + * metadataFilters only applies to load balancers that haveloadBalancingScheme set toINTERNAL_SELF_MANAGED. + * Not supported when the URL map is bound to a target gRPC proxy that + * has validateForProxyless field set to true. * * Generated from protobuf field repeated .google.cloud.compute.v1.MetadataFilter metadata_filters = 464725739; * @param array<\Google\Cloud\Compute\V1\MetadataFilter>|\Google\Protobuf\Internal\RepeatedField $var @@ -218,7 +364,13 @@ public function setMetadataFilters($var) } /** - * If specified, the route is a pattern match expression that must match the :path header once the query string is removed. A pattern match allows you to match - The value must be between 1 and 1024 characters - The pattern must start with a leading slash ("/") - There may be no more than 5 operators in pattern Precisely one of prefix_match, full_path_match, regex_match or path_template_match must be set. + * If specified, the route is a pattern match expression that must match the + * :path header once the query string is removed. + * A pattern match allows you to match + * - The value must be between 1 and 1024 characters + * - The pattern must start with a leading slash ("/") + * - There may be no more than 5 operators in pattern + * Precisely one ofprefix_match, full_path_match,regex_match or path_template_match must be set. * * Generated from protobuf field optional string path_template_match = 292348186; * @return string @@ -239,7 +391,13 @@ public function clearPathTemplateMatch() } /** - * If specified, the route is a pattern match expression that must match the :path header once the query string is removed. A pattern match allows you to match - The value must be between 1 and 1024 characters - The pattern must start with a leading slash ("/") - There may be no more than 5 operators in pattern Precisely one of prefix_match, full_path_match, regex_match or path_template_match must be set. + * If specified, the route is a pattern match expression that must match the + * :path header once the query string is removed. + * A pattern match allows you to match + * - The value must be between 1 and 1024 characters + * - The pattern must start with a leading slash ("/") + * - There may be no more than 5 operators in pattern + * Precisely one ofprefix_match, full_path_match,regex_match or path_template_match must be set. * * Generated from protobuf field optional string path_template_match = 292348186; * @param string $var @@ -254,7 +412,12 @@ public function setPathTemplateMatch($var) } /** - * For satisfying the matchRule condition, the request's path must begin with the specified prefixMatch. prefixMatch must begin with a /. The value must be from 1 to 1024 characters. Only one of prefixMatch, fullPathMatch or regexMatch must be specified. + * For satisfying the matchRule condition, the request's + * path must begin with the specified prefixMatch.prefixMatch must begin with a /. + * The value must be from 1 to 1024 characters. + * Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be + * specified. + * specified. * * Generated from protobuf field optional string prefix_match = 257898968; * @return string @@ -275,7 +438,12 @@ public function clearPrefixMatch() } /** - * For satisfying the matchRule condition, the request's path must begin with the specified prefixMatch. prefixMatch must begin with a /. The value must be from 1 to 1024 characters. Only one of prefixMatch, fullPathMatch or regexMatch must be specified. + * For satisfying the matchRule condition, the request's + * path must begin with the specified prefixMatch.prefixMatch must begin with a /. + * The value must be from 1 to 1024 characters. + * Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be + * specified. + * specified. * * Generated from protobuf field optional string prefix_match = 257898968; * @param string $var @@ -290,7 +458,9 @@ public function setPrefixMatch($var) } /** - * Specifies a list of query parameter match criteria, all of which must match corresponding query parameters in the request. Not supported when the URL map is bound to a target gRPC proxy. + * Specifies a list of query parameter match criteria, all of which must + * match corresponding query parameters in the request. + * Not supported when the URL map is bound to a target gRPC proxy. * * Generated from protobuf field repeated .google.cloud.compute.v1.HttpQueryParameterMatch query_parameter_matches = 286231270; * @return \Google\Protobuf\Internal\RepeatedField @@ -301,7 +471,9 @@ public function getQueryParameterMatches() } /** - * Specifies a list of query parameter match criteria, all of which must match corresponding query parameters in the request. Not supported when the URL map is bound to a target gRPC proxy. + * Specifies a list of query parameter match criteria, all of which must + * match corresponding query parameters in the request. + * Not supported when the URL map is bound to a target gRPC proxy. * * Generated from protobuf field repeated .google.cloud.compute.v1.HttpQueryParameterMatch query_parameter_matches = 286231270; * @param array<\Google\Cloud\Compute\V1\HttpQueryParameterMatch>|\Google\Protobuf\Internal\RepeatedField $var @@ -316,7 +488,14 @@ public function setQueryParameterMatches($var) } /** - * For satisfying the matchRule condition, the path of the request must satisfy the regular expression specified in regexMatch after removing any query parameters and anchor supplied with the original URL. For more information about regular expression syntax, see Syntax. Only one of prefixMatch, fullPathMatch or regexMatch must be specified. Regular expressions can only be used when the loadBalancingScheme is set to INTERNAL_SELF_MANAGED. + * For satisfying the matchRule condition, the path of the + * request must satisfy the regular expression specified inregexMatch after removing any query parameters and anchor + * supplied with the original URL. For + * more information about regular expression syntax, see Syntax. + * Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be + * specified. + * Regular expressions can only be used when the loadBalancingScheme is + * set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED orINTERNAL_MANAGED. * * Generated from protobuf field optional string regex_match = 107387853; * @return string @@ -337,7 +516,14 @@ public function clearRegexMatch() } /** - * For satisfying the matchRule condition, the path of the request must satisfy the regular expression specified in regexMatch after removing any query parameters and anchor supplied with the original URL. For more information about regular expression syntax, see Syntax. Only one of prefixMatch, fullPathMatch or regexMatch must be specified. Regular expressions can only be used when the loadBalancingScheme is set to INTERNAL_SELF_MANAGED. + * For satisfying the matchRule condition, the path of the + * request must satisfy the regular expression specified inregexMatch after removing any query parameters and anchor + * supplied with the original URL. For + * more information about regular expression syntax, see Syntax. + * Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be + * specified. + * Regular expressions can only be used when the loadBalancingScheme is + * set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED orINTERNAL_MANAGED. * * Generated from protobuf field optional string regex_match = 107387853; * @param string $var diff --git a/Compute/src/V1/Image.php b/Compute/src/V1/Image.php index 8c0964832cfb..9849a6b99dbf 100644 --- a/Compute/src/V1/Image.php +++ b/Compute/src/V1/Image.php @@ -9,27 +9,32 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Represents an Image resource. You can use images to create boot disks for your VM instances. For more information, read Images. + * Represents an Image resource. + * You can use images to create boot disks for your VM instances. + * For more information, read Images. * * Generated from protobuf message google.cloud.compute.v1.Image */ class Image extends \Google\Protobuf\Internal\Message { /** - * The architecture of the image. Valid values are ARM64 or X86_64. + * The architecture of the image. Valid values are + * ARM64 or X86_64. * Check the Architecture enum for the list of possible values. * * Generated from protobuf field optional string architecture = 302803283; */ protected $architecture = null; /** - * Size of the image tar.gz archive stored in Google Cloud Storage (in bytes). + * Size of the image tar.gz archive stored in Google Cloud + * Storage (in bytes). * * Generated from protobuf field optional int64 archive_size_bytes = 381093450; */ protected $archive_size_bytes = null; /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; */ @@ -41,7 +46,8 @@ class Image extends \Google\Protobuf\Internal\Message */ protected $deprecated = null; /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; */ @@ -53,49 +59,77 @@ class Image extends \Google\Protobuf\Internal\Message */ protected $disk_size_gb = null; /** - * Whether this image is created from a confidential compute mode disk. [Output Only]: This field is not set by user, but from source disk. + * Whether this image is created from a confidential compute mode disk. + * [Output Only]: This field is not set by user, but from source disk. * * Generated from protobuf field optional bool enable_confidential_compute = 102135228; */ protected $enable_confidential_compute = null; /** - * The name of the image family to which this image belongs. The image family name can be from a publicly managed image family provided by Compute Engine, or from a custom image family you create. For example, centos-stream-9 is a publicly available image family. For more information, see Image family best practices. When creating disks, you can specify an image family instead of a specific image name. The image family always returns its latest image that is not deprecated. The name of the image family must comply with RFC1035. + * The name of the image family to which this image belongs. The image + * family name can be from a publicly managed image family provided by + * Compute Engine, or from a custom image family you create. For example,centos-stream-9 is a publicly available image family. + * For more information, see Image + * family best practices. + * When creating disks, you can specify an image family instead of a specific + * image name. The image family always returns its latest image that is not + * deprecated. The name of the image family must comply with RFC1035. * * Generated from protobuf field optional string family = 328751972; */ protected $family = null; /** - * A list of features to enable on the guest operating system. Applicable only for bootable images. To see a list of available options, see the guestOSfeatures[].type parameter. + * A list of features to enable on the guest operating system. Applicable + * only for bootable images. To see a list of available options, see theguestOSfeatures[].type parameter. * * Generated from protobuf field repeated .google.cloud.compute.v1.GuestOsFeature guest_os_features = 79294545; */ private $guest_os_features; /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; */ protected $id = null; /** - * Encrypts the image using a customer-supplied encryption key. After you encrypt an image with a customer-supplied key, you must provide the same key if you use the image later (e.g. to create a disk from the image). Customer-supplied encryption keys do not protect access to metadata of the disk. If you do not provide an encryption key when creating the image, then the disk will be encrypted using an automatically generated key and you do not need to provide a key to use the image later. + * Encrypts the image using acustomer-supplied + * encryption key. + * After you encrypt an image with a customer-supplied key, you must provide + * the same key if you use the image later (e.g. to create a disk from + * the image). + * Customer-supplied encryption keys do not protect access to metadata + * of the disk. + * If you do not provide an encryption key when creating the image, then the + * disk will be encrypted using an automatically generated key and you do not + * need to provide a key to use the image later. * * Generated from protobuf field optional .google.cloud.compute.v1.CustomerEncryptionKey image_encryption_key = 379512583; */ protected $image_encryption_key = null; /** - * [Output Only] Type of the resource. Always compute#image for images. + * [Output Only] Type of the resource. Always compute#image for + * images. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * A fingerprint for the labels being applied to this image, which is essentially a hash of the labels used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve an image. + * A fingerprint for the labels being applied to this image, which is + * essentially a hash of the labels used for optimistic locking. The + * fingerprint is initially generated by Compute Engine and changes after + * every request to modify or update labels. You must always provide an + * up-to-date fingerprint hash in order to update or change labels, + * otherwise the request will fail with error412 conditionNotMet. + * To see the latest fingerprint, make a get() request to + * retrieve an image. * * Generated from protobuf field optional string label_fingerprint = 178124825; */ protected $label_fingerprint = null; /** - * Labels to apply to this image. These can be later modified by the setLabels method. + * Labels to apply to this image. These can be later modified by + * the setLabels method. * * Generated from protobuf field map labels = 500195327; */ @@ -113,13 +147,20 @@ class Image extends \Google\Protobuf\Internal\Message */ private $licenses; /** - * Name of the resource; provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource; provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must be + * a dash, lowercase letter, or digit, except the last character, which cannot + * be a dash. * * Generated from protobuf field optional string name = 3373707; */ protected $name = null; /** - * Input only. [Input Only] Additional params passed with the request, but not persisted as part of resource payload. + * Input only. [Input Only] Additional params passed with the request, but not persisted + * as part of resource payload. * * Generated from protobuf field optional .google.cloud.compute.v1.ImageParams params = 78313862; */ @@ -155,75 +196,123 @@ class Image extends \Google\Protobuf\Internal\Message */ protected $shielded_instance_initial_state = null; /** - * URL of the source disk used to create this image. For example, the following are valid values: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /disks/disk - projects/project/zones/zone/disks/disk - zones/zone/disks/disk In order to create an image, you must provide the full or partial URL of one of the following: - The rawDisk.source URL - The sourceDisk URL - The sourceImage URL - The sourceSnapshot URL + * URL of the source disk used to create this image. + * For example, the following are valid values: + * - https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk + * - projects/project/zones/zone/disks/disk + * - zones/zone/disks/disk + * In order to create an image, you must provide the full or partial URL of + * one of the following: + * - The rawDisk.source URL + * - The sourceDisk URL + * - The sourceImage URL + * - The sourceSnapshot URL * * Generated from protobuf field optional string source_disk = 451753793; */ protected $source_disk = null; /** - * The customer-supplied encryption key of the source disk. Required if the source disk is protected by a customer-supplied encryption key. + * Thecustomer-supplied + * encryption key of the source disk. Required if the source disk is + * protected by a customer-supplied encryption key. * * Generated from protobuf field optional .google.cloud.compute.v1.CustomerEncryptionKey source_disk_encryption_key = 531501153; */ protected $source_disk_encryption_key = null; /** - * [Output Only] The ID value of the disk used to create this image. This value may be used to determine whether the image was taken from the current or a previous instance of a given disk name. + * [Output Only] + * The ID value of the disk used to create this image. This value may be used + * to determine whether the image was taken from the current or a previous + * instance of a given disk name. * * Generated from protobuf field optional string source_disk_id = 454190809; */ protected $source_disk_id = null; /** - * URL of the source image used to create this image. The following are valid formats for the URL: - https://www.googleapis.com/compute/v1/projects/project_id/global/ images/image_name - projects/project_id/global/images/image_name In order to create an image, you must provide the full or partial URL of one of the following: - The rawDisk.source URL - The sourceDisk URL - The sourceImage URL - The sourceSnapshot URL + * URL of the source image used to create this image. + * The following are valid formats for the URL: + * - https://www.googleapis.com/compute/v1/projects/project_id/global/ + * images/image_name + * - projects/project_id/global/images/image_name + * In order to create an image, you must provide the full or partial URL of + * one of the following: + * - The rawDisk.source URL + * - The sourceDisk URL + * - The sourceImage URL + * - The sourceSnapshot URL * * Generated from protobuf field optional string source_image = 50443319; */ protected $source_image = null; /** - * The customer-supplied encryption key of the source image. Required if the source image is protected by a customer-supplied encryption key. + * The customer-supplied encryption key of the source image. Required if the + * source image is protected by a customer-supplied encryption key. * * Generated from protobuf field optional .google.cloud.compute.v1.CustomerEncryptionKey source_image_encryption_key = 381503659; */ protected $source_image_encryption_key = null; /** - * [Output Only] The ID value of the image used to create this image. This value may be used to determine whether the image was taken from the current or a previous instance of a given image name. + * [Output Only] + * The ID value of the image used to create this image. This value may be used + * to determine whether the image was taken from the current or a previous + * instance of a given image name. * * Generated from protobuf field optional string source_image_id = 55328291; */ protected $source_image_id = null; /** - * URL of the source snapshot used to create this image. The following are valid formats for the URL: - https://www.googleapis.com/compute/v1/projects/project_id/global/ snapshots/snapshot_name - projects/project_id/global/snapshots/snapshot_name In order to create an image, you must provide the full or partial URL of one of the following: - The rawDisk.source URL - The sourceDisk URL - The sourceImage URL - The sourceSnapshot URL + * URL of the source snapshot used to create this image. + * The following are valid formats for the URL: + * - https://www.googleapis.com/compute/v1/projects/project_id/global/ + * snapshots/snapshot_name + * - projects/project_id/global/snapshots/snapshot_name + * In order to create an image, you must provide the full or partial URL of + * one of the following: + * - The rawDisk.source URL + * - The sourceDisk URL + * - The sourceImage URL + * - The sourceSnapshot URL * * Generated from protobuf field optional string source_snapshot = 126061928; */ protected $source_snapshot = null; /** - * The customer-supplied encryption key of the source snapshot. Required if the source snapshot is protected by a customer-supplied encryption key. + * The customer-supplied encryption key of the source snapshot. Required if + * the source snapshot is protected by a customer-supplied encryption key. * * Generated from protobuf field optional .google.cloud.compute.v1.CustomerEncryptionKey source_snapshot_encryption_key = 303679322; */ protected $source_snapshot_encryption_key = null; /** - * [Output Only] The ID value of the snapshot used to create this image. This value may be used to determine whether the snapshot was taken from the current or a previous instance of a given snapshot name. + * [Output Only] + * The ID value of the snapshot used to create this image. This value may be + * used to determine whether the snapshot was taken from the current or a + * previous instance of a given snapshot name. * * Generated from protobuf field optional string source_snapshot_id = 98962258; */ protected $source_snapshot_id = null; /** - * The type of the image used to create this disk. The default and only valid value is RAW. + * The type of the image used to create this disk. The + * default and only valid value is RAW. * Check the SourceType enum for the list of possible values. * * Generated from protobuf field optional string source_type = 452245726; */ protected $source_type = null; /** - * [Output Only] The status of the image. An image can be used to create other resources, such as instances, only after the image has been successfully created and the status is set to READY. Possible values are FAILED, PENDING, or READY. + * [Output Only] The status of the image. An image can be used to create other + * resources, such as instances, only after the image has been successfully + * created and the status is set to READY. Possible + * values are FAILED, PENDING, orREADY. * Check the Status enum for the list of possible values. * * Generated from protobuf field optional string status = 181260274; */ protected $status = null; /** - * Cloud Storage bucket storage location of the image (regional or multi-regional). + * Cloud Storage bucket storage location of the image (regional or + * multi-regional). * * Generated from protobuf field repeated string storage_locations = 328005274; */ @@ -236,42 +325,81 @@ class Image extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $architecture - * The architecture of the image. Valid values are ARM64 or X86_64. + * The architecture of the image. Valid values are + * ARM64 or X86_64. * Check the Architecture enum for the list of possible values. * @type int|string $archive_size_bytes - * Size of the image tar.gz archive stored in Google Cloud Storage (in bytes). + * Size of the image tar.gz archive stored in Google Cloud + * Storage (in bytes). * @type string $creation_timestamp - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * @type \Google\Cloud\Compute\V1\DeprecationStatus $deprecated * The deprecation status associated with this image. * @type string $description - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * @type int|string $disk_size_gb * Size of the image when restored onto a persistent disk (in GB). * @type bool $enable_confidential_compute - * Whether this image is created from a confidential compute mode disk. [Output Only]: This field is not set by user, but from source disk. + * Whether this image is created from a confidential compute mode disk. + * [Output Only]: This field is not set by user, but from source disk. * @type string $family - * The name of the image family to which this image belongs. The image family name can be from a publicly managed image family provided by Compute Engine, or from a custom image family you create. For example, centos-stream-9 is a publicly available image family. For more information, see Image family best practices. When creating disks, you can specify an image family instead of a specific image name. The image family always returns its latest image that is not deprecated. The name of the image family must comply with RFC1035. + * The name of the image family to which this image belongs. The image + * family name can be from a publicly managed image family provided by + * Compute Engine, or from a custom image family you create. For example,centos-stream-9 is a publicly available image family. + * For more information, see Image + * family best practices. + * When creating disks, you can specify an image family instead of a specific + * image name. The image family always returns its latest image that is not + * deprecated. The name of the image family must comply with RFC1035. * @type array<\Google\Cloud\Compute\V1\GuestOsFeature>|\Google\Protobuf\Internal\RepeatedField $guest_os_features - * A list of features to enable on the guest operating system. Applicable only for bootable images. To see a list of available options, see the guestOSfeatures[].type parameter. + * A list of features to enable on the guest operating system. Applicable + * only for bootable images. To see a list of available options, see theguestOSfeatures[].type parameter. * @type int|string $id - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * @type \Google\Cloud\Compute\V1\CustomerEncryptionKey $image_encryption_key - * Encrypts the image using a customer-supplied encryption key. After you encrypt an image with a customer-supplied key, you must provide the same key if you use the image later (e.g. to create a disk from the image). Customer-supplied encryption keys do not protect access to metadata of the disk. If you do not provide an encryption key when creating the image, then the disk will be encrypted using an automatically generated key and you do not need to provide a key to use the image later. + * Encrypts the image using acustomer-supplied + * encryption key. + * After you encrypt an image with a customer-supplied key, you must provide + * the same key if you use the image later (e.g. to create a disk from + * the image). + * Customer-supplied encryption keys do not protect access to metadata + * of the disk. + * If you do not provide an encryption key when creating the image, then the + * disk will be encrypted using an automatically generated key and you do not + * need to provide a key to use the image later. * @type string $kind - * [Output Only] Type of the resource. Always compute#image for images. + * [Output Only] Type of the resource. Always compute#image for + * images. * @type string $label_fingerprint - * A fingerprint for the labels being applied to this image, which is essentially a hash of the labels used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve an image. + * A fingerprint for the labels being applied to this image, which is + * essentially a hash of the labels used for optimistic locking. The + * fingerprint is initially generated by Compute Engine and changes after + * every request to modify or update labels. You must always provide an + * up-to-date fingerprint hash in order to update or change labels, + * otherwise the request will fail with error412 conditionNotMet. + * To see the latest fingerprint, make a get() request to + * retrieve an image. * @type array|\Google\Protobuf\Internal\MapField $labels - * Labels to apply to this image. These can be later modified by the setLabels method. + * Labels to apply to this image. These can be later modified by + * the setLabels method. * @type array|array|\Google\Protobuf\Internal\RepeatedField $license_codes * Integer license codes indicating which licenses are attached to this image. * @type array|\Google\Protobuf\Internal\RepeatedField $licenses * Any applicable license URI. * @type string $name - * Name of the resource; provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource; provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must be + * a dash, lowercase letter, or digit, except the last character, which cannot + * be a dash. * @type \Google\Cloud\Compute\V1\ImageParams $params - * Input only. [Input Only] Additional params passed with the request, but not persisted as part of resource payload. + * Input only. [Input Only] Additional params passed with the request, but not persisted + * as part of resource payload. * @type \Google\Cloud\Compute\V1\RawDisk $raw_disk * The parameters of the raw disk image. * @type bool $satisfies_pzi @@ -283,31 +411,79 @@ class Image extends \Google\Protobuf\Internal\Message * @type \Google\Cloud\Compute\V1\InitialStateConfig $shielded_instance_initial_state * Set the secure boot keys of shielded instance. * @type string $source_disk - * URL of the source disk used to create this image. For example, the following are valid values: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /disks/disk - projects/project/zones/zone/disks/disk - zones/zone/disks/disk In order to create an image, you must provide the full or partial URL of one of the following: - The rawDisk.source URL - The sourceDisk URL - The sourceImage URL - The sourceSnapshot URL + * URL of the source disk used to create this image. + * For example, the following are valid values: + * - https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk + * - projects/project/zones/zone/disks/disk + * - zones/zone/disks/disk + * In order to create an image, you must provide the full or partial URL of + * one of the following: + * - The rawDisk.source URL + * - The sourceDisk URL + * - The sourceImage URL + * - The sourceSnapshot URL * @type \Google\Cloud\Compute\V1\CustomerEncryptionKey $source_disk_encryption_key - * The customer-supplied encryption key of the source disk. Required if the source disk is protected by a customer-supplied encryption key. + * Thecustomer-supplied + * encryption key of the source disk. Required if the source disk is + * protected by a customer-supplied encryption key. * @type string $source_disk_id - * [Output Only] The ID value of the disk used to create this image. This value may be used to determine whether the image was taken from the current or a previous instance of a given disk name. + * [Output Only] + * The ID value of the disk used to create this image. This value may be used + * to determine whether the image was taken from the current or a previous + * instance of a given disk name. * @type string $source_image - * URL of the source image used to create this image. The following are valid formats for the URL: - https://www.googleapis.com/compute/v1/projects/project_id/global/ images/image_name - projects/project_id/global/images/image_name In order to create an image, you must provide the full or partial URL of one of the following: - The rawDisk.source URL - The sourceDisk URL - The sourceImage URL - The sourceSnapshot URL + * URL of the source image used to create this image. + * The following are valid formats for the URL: + * - https://www.googleapis.com/compute/v1/projects/project_id/global/ + * images/image_name + * - projects/project_id/global/images/image_name + * In order to create an image, you must provide the full or partial URL of + * one of the following: + * - The rawDisk.source URL + * - The sourceDisk URL + * - The sourceImage URL + * - The sourceSnapshot URL * @type \Google\Cloud\Compute\V1\CustomerEncryptionKey $source_image_encryption_key - * The customer-supplied encryption key of the source image. Required if the source image is protected by a customer-supplied encryption key. + * The customer-supplied encryption key of the source image. Required if the + * source image is protected by a customer-supplied encryption key. * @type string $source_image_id - * [Output Only] The ID value of the image used to create this image. This value may be used to determine whether the image was taken from the current or a previous instance of a given image name. + * [Output Only] + * The ID value of the image used to create this image. This value may be used + * to determine whether the image was taken from the current or a previous + * instance of a given image name. * @type string $source_snapshot - * URL of the source snapshot used to create this image. The following are valid formats for the URL: - https://www.googleapis.com/compute/v1/projects/project_id/global/ snapshots/snapshot_name - projects/project_id/global/snapshots/snapshot_name In order to create an image, you must provide the full or partial URL of one of the following: - The rawDisk.source URL - The sourceDisk URL - The sourceImage URL - The sourceSnapshot URL + * URL of the source snapshot used to create this image. + * The following are valid formats for the URL: + * - https://www.googleapis.com/compute/v1/projects/project_id/global/ + * snapshots/snapshot_name + * - projects/project_id/global/snapshots/snapshot_name + * In order to create an image, you must provide the full or partial URL of + * one of the following: + * - The rawDisk.source URL + * - The sourceDisk URL + * - The sourceImage URL + * - The sourceSnapshot URL * @type \Google\Cloud\Compute\V1\CustomerEncryptionKey $source_snapshot_encryption_key - * The customer-supplied encryption key of the source snapshot. Required if the source snapshot is protected by a customer-supplied encryption key. + * The customer-supplied encryption key of the source snapshot. Required if + * the source snapshot is protected by a customer-supplied encryption key. * @type string $source_snapshot_id - * [Output Only] The ID value of the snapshot used to create this image. This value may be used to determine whether the snapshot was taken from the current or a previous instance of a given snapshot name. + * [Output Only] + * The ID value of the snapshot used to create this image. This value may be + * used to determine whether the snapshot was taken from the current or a + * previous instance of a given snapshot name. * @type string $source_type - * The type of the image used to create this disk. The default and only valid value is RAW. + * The type of the image used to create this disk. The + * default and only valid value is RAW. * Check the SourceType enum for the list of possible values. * @type string $status - * [Output Only] The status of the image. An image can be used to create other resources, such as instances, only after the image has been successfully created and the status is set to READY. Possible values are FAILED, PENDING, or READY. + * [Output Only] The status of the image. An image can be used to create other + * resources, such as instances, only after the image has been successfully + * created and the status is set to READY. Possible + * values are FAILED, PENDING, orREADY. * Check the Status enum for the list of possible values. * @type array|\Google\Protobuf\Internal\RepeatedField $storage_locations - * Cloud Storage bucket storage location of the image (regional or multi-regional). + * Cloud Storage bucket storage location of the image (regional or + * multi-regional). * } */ public function __construct($data = NULL) { @@ -316,7 +492,8 @@ public function __construct($data = NULL) { } /** - * The architecture of the image. Valid values are ARM64 or X86_64. + * The architecture of the image. Valid values are + * ARM64 or X86_64. * Check the Architecture enum for the list of possible values. * * Generated from protobuf field optional string architecture = 302803283; @@ -338,7 +515,8 @@ public function clearArchitecture() } /** - * The architecture of the image. Valid values are ARM64 or X86_64. + * The architecture of the image. Valid values are + * ARM64 or X86_64. * Check the Architecture enum for the list of possible values. * * Generated from protobuf field optional string architecture = 302803283; @@ -354,7 +532,8 @@ public function setArchitecture($var) } /** - * Size of the image tar.gz archive stored in Google Cloud Storage (in bytes). + * Size of the image tar.gz archive stored in Google Cloud + * Storage (in bytes). * * Generated from protobuf field optional int64 archive_size_bytes = 381093450; * @return int|string @@ -375,7 +554,8 @@ public function clearArchiveSizeBytes() } /** - * Size of the image tar.gz archive stored in Google Cloud Storage (in bytes). + * Size of the image tar.gz archive stored in Google Cloud + * Storage (in bytes). * * Generated from protobuf field optional int64 archive_size_bytes = 381093450; * @param int|string $var @@ -390,7 +570,8 @@ public function setArchiveSizeBytes($var) } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @return string @@ -411,7 +592,8 @@ public function clearCreationTimestamp() } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @param string $var @@ -462,7 +644,8 @@ public function setDeprecated($var) } /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @return string @@ -483,7 +666,8 @@ public function clearDescription() } /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @param string $var @@ -534,7 +718,8 @@ public function setDiskSizeGb($var) } /** - * Whether this image is created from a confidential compute mode disk. [Output Only]: This field is not set by user, but from source disk. + * Whether this image is created from a confidential compute mode disk. + * [Output Only]: This field is not set by user, but from source disk. * * Generated from protobuf field optional bool enable_confidential_compute = 102135228; * @return bool @@ -555,7 +740,8 @@ public function clearEnableConfidentialCompute() } /** - * Whether this image is created from a confidential compute mode disk. [Output Only]: This field is not set by user, but from source disk. + * Whether this image is created from a confidential compute mode disk. + * [Output Only]: This field is not set by user, but from source disk. * * Generated from protobuf field optional bool enable_confidential_compute = 102135228; * @param bool $var @@ -570,7 +756,14 @@ public function setEnableConfidentialCompute($var) } /** - * The name of the image family to which this image belongs. The image family name can be from a publicly managed image family provided by Compute Engine, or from a custom image family you create. For example, centos-stream-9 is a publicly available image family. For more information, see Image family best practices. When creating disks, you can specify an image family instead of a specific image name. The image family always returns its latest image that is not deprecated. The name of the image family must comply with RFC1035. + * The name of the image family to which this image belongs. The image + * family name can be from a publicly managed image family provided by + * Compute Engine, or from a custom image family you create. For example,centos-stream-9 is a publicly available image family. + * For more information, see Image + * family best practices. + * When creating disks, you can specify an image family instead of a specific + * image name. The image family always returns its latest image that is not + * deprecated. The name of the image family must comply with RFC1035. * * Generated from protobuf field optional string family = 328751972; * @return string @@ -591,7 +784,14 @@ public function clearFamily() } /** - * The name of the image family to which this image belongs. The image family name can be from a publicly managed image family provided by Compute Engine, or from a custom image family you create. For example, centos-stream-9 is a publicly available image family. For more information, see Image family best practices. When creating disks, you can specify an image family instead of a specific image name. The image family always returns its latest image that is not deprecated. The name of the image family must comply with RFC1035. + * The name of the image family to which this image belongs. The image + * family name can be from a publicly managed image family provided by + * Compute Engine, or from a custom image family you create. For example,centos-stream-9 is a publicly available image family. + * For more information, see Image + * family best practices. + * When creating disks, you can specify an image family instead of a specific + * image name. The image family always returns its latest image that is not + * deprecated. The name of the image family must comply with RFC1035. * * Generated from protobuf field optional string family = 328751972; * @param string $var @@ -606,7 +806,8 @@ public function setFamily($var) } /** - * A list of features to enable on the guest operating system. Applicable only for bootable images. To see a list of available options, see the guestOSfeatures[].type parameter. + * A list of features to enable on the guest operating system. Applicable + * only for bootable images. To see a list of available options, see theguestOSfeatures[].type parameter. * * Generated from protobuf field repeated .google.cloud.compute.v1.GuestOsFeature guest_os_features = 79294545; * @return \Google\Protobuf\Internal\RepeatedField @@ -617,7 +818,8 @@ public function getGuestOsFeatures() } /** - * A list of features to enable on the guest operating system. Applicable only for bootable images. To see a list of available options, see the guestOSfeatures[].type parameter. + * A list of features to enable on the guest operating system. Applicable + * only for bootable images. To see a list of available options, see theguestOSfeatures[].type parameter. * * Generated from protobuf field repeated .google.cloud.compute.v1.GuestOsFeature guest_os_features = 79294545; * @param array<\Google\Cloud\Compute\V1\GuestOsFeature>|\Google\Protobuf\Internal\RepeatedField $var @@ -632,7 +834,8 @@ public function setGuestOsFeatures($var) } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @return int|string @@ -653,7 +856,8 @@ public function clearId() } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @param int|string $var @@ -668,7 +872,16 @@ public function setId($var) } /** - * Encrypts the image using a customer-supplied encryption key. After you encrypt an image with a customer-supplied key, you must provide the same key if you use the image later (e.g. to create a disk from the image). Customer-supplied encryption keys do not protect access to metadata of the disk. If you do not provide an encryption key when creating the image, then the disk will be encrypted using an automatically generated key and you do not need to provide a key to use the image later. + * Encrypts the image using acustomer-supplied + * encryption key. + * After you encrypt an image with a customer-supplied key, you must provide + * the same key if you use the image later (e.g. to create a disk from + * the image). + * Customer-supplied encryption keys do not protect access to metadata + * of the disk. + * If you do not provide an encryption key when creating the image, then the + * disk will be encrypted using an automatically generated key and you do not + * need to provide a key to use the image later. * * Generated from protobuf field optional .google.cloud.compute.v1.CustomerEncryptionKey image_encryption_key = 379512583; * @return \Google\Cloud\Compute\V1\CustomerEncryptionKey|null @@ -689,7 +902,16 @@ public function clearImageEncryptionKey() } /** - * Encrypts the image using a customer-supplied encryption key. After you encrypt an image with a customer-supplied key, you must provide the same key if you use the image later (e.g. to create a disk from the image). Customer-supplied encryption keys do not protect access to metadata of the disk. If you do not provide an encryption key when creating the image, then the disk will be encrypted using an automatically generated key and you do not need to provide a key to use the image later. + * Encrypts the image using acustomer-supplied + * encryption key. + * After you encrypt an image with a customer-supplied key, you must provide + * the same key if you use the image later (e.g. to create a disk from + * the image). + * Customer-supplied encryption keys do not protect access to metadata + * of the disk. + * If you do not provide an encryption key when creating the image, then the + * disk will be encrypted using an automatically generated key and you do not + * need to provide a key to use the image later. * * Generated from protobuf field optional .google.cloud.compute.v1.CustomerEncryptionKey image_encryption_key = 379512583; * @param \Google\Cloud\Compute\V1\CustomerEncryptionKey $var @@ -704,7 +926,8 @@ public function setImageEncryptionKey($var) } /** - * [Output Only] Type of the resource. Always compute#image for images. + * [Output Only] Type of the resource. Always compute#image for + * images. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -725,7 +948,8 @@ public function clearKind() } /** - * [Output Only] Type of the resource. Always compute#image for images. + * [Output Only] Type of the resource. Always compute#image for + * images. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -740,7 +964,14 @@ public function setKind($var) } /** - * A fingerprint for the labels being applied to this image, which is essentially a hash of the labels used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve an image. + * A fingerprint for the labels being applied to this image, which is + * essentially a hash of the labels used for optimistic locking. The + * fingerprint is initially generated by Compute Engine and changes after + * every request to modify or update labels. You must always provide an + * up-to-date fingerprint hash in order to update or change labels, + * otherwise the request will fail with error412 conditionNotMet. + * To see the latest fingerprint, make a get() request to + * retrieve an image. * * Generated from protobuf field optional string label_fingerprint = 178124825; * @return string @@ -761,7 +992,14 @@ public function clearLabelFingerprint() } /** - * A fingerprint for the labels being applied to this image, which is essentially a hash of the labels used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve an image. + * A fingerprint for the labels being applied to this image, which is + * essentially a hash of the labels used for optimistic locking. The + * fingerprint is initially generated by Compute Engine and changes after + * every request to modify or update labels. You must always provide an + * up-to-date fingerprint hash in order to update or change labels, + * otherwise the request will fail with error412 conditionNotMet. + * To see the latest fingerprint, make a get() request to + * retrieve an image. * * Generated from protobuf field optional string label_fingerprint = 178124825; * @param string $var @@ -776,7 +1014,8 @@ public function setLabelFingerprint($var) } /** - * Labels to apply to this image. These can be later modified by the setLabels method. + * Labels to apply to this image. These can be later modified by + * the setLabels method. * * Generated from protobuf field map labels = 500195327; * @return \Google\Protobuf\Internal\MapField @@ -787,7 +1026,8 @@ public function getLabels() } /** - * Labels to apply to this image. These can be later modified by the setLabels method. + * Labels to apply to this image. These can be later modified by + * the setLabels method. * * Generated from protobuf field map labels = 500195327; * @param array|\Google\Protobuf\Internal\MapField $var @@ -854,7 +1094,13 @@ public function setLicenses($var) } /** - * Name of the resource; provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource; provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must be + * a dash, lowercase letter, or digit, except the last character, which cannot + * be a dash. * * Generated from protobuf field optional string name = 3373707; * @return string @@ -875,7 +1121,13 @@ public function clearName() } /** - * Name of the resource; provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource; provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must be + * a dash, lowercase letter, or digit, except the last character, which cannot + * be a dash. * * Generated from protobuf field optional string name = 3373707; * @param string $var @@ -890,7 +1142,8 @@ public function setName($var) } /** - * Input only. [Input Only] Additional params passed with the request, but not persisted as part of resource payload. + * Input only. [Input Only] Additional params passed with the request, but not persisted + * as part of resource payload. * * Generated from protobuf field optional .google.cloud.compute.v1.ImageParams params = 78313862; * @return \Google\Cloud\Compute\V1\ImageParams|null @@ -911,7 +1164,8 @@ public function clearParams() } /** - * Input only. [Input Only] Additional params passed with the request, but not persisted as part of resource payload. + * Input only. [Input Only] Additional params passed with the request, but not persisted + * as part of resource payload. * * Generated from protobuf field optional .google.cloud.compute.v1.ImageParams params = 78313862; * @param \Google\Cloud\Compute\V1\ImageParams $var @@ -1106,7 +1360,17 @@ public function setShieldedInstanceInitialState($var) } /** - * URL of the source disk used to create this image. For example, the following are valid values: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /disks/disk - projects/project/zones/zone/disks/disk - zones/zone/disks/disk In order to create an image, you must provide the full or partial URL of one of the following: - The rawDisk.source URL - The sourceDisk URL - The sourceImage URL - The sourceSnapshot URL + * URL of the source disk used to create this image. + * For example, the following are valid values: + * - https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk + * - projects/project/zones/zone/disks/disk + * - zones/zone/disks/disk + * In order to create an image, you must provide the full or partial URL of + * one of the following: + * - The rawDisk.source URL + * - The sourceDisk URL + * - The sourceImage URL + * - The sourceSnapshot URL * * Generated from protobuf field optional string source_disk = 451753793; * @return string @@ -1127,7 +1391,17 @@ public function clearSourceDisk() } /** - * URL of the source disk used to create this image. For example, the following are valid values: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /disks/disk - projects/project/zones/zone/disks/disk - zones/zone/disks/disk In order to create an image, you must provide the full or partial URL of one of the following: - The rawDisk.source URL - The sourceDisk URL - The sourceImage URL - The sourceSnapshot URL + * URL of the source disk used to create this image. + * For example, the following are valid values: + * - https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk + * - projects/project/zones/zone/disks/disk + * - zones/zone/disks/disk + * In order to create an image, you must provide the full or partial URL of + * one of the following: + * - The rawDisk.source URL + * - The sourceDisk URL + * - The sourceImage URL + * - The sourceSnapshot URL * * Generated from protobuf field optional string source_disk = 451753793; * @param string $var @@ -1142,7 +1416,9 @@ public function setSourceDisk($var) } /** - * The customer-supplied encryption key of the source disk. Required if the source disk is protected by a customer-supplied encryption key. + * Thecustomer-supplied + * encryption key of the source disk. Required if the source disk is + * protected by a customer-supplied encryption key. * * Generated from protobuf field optional .google.cloud.compute.v1.CustomerEncryptionKey source_disk_encryption_key = 531501153; * @return \Google\Cloud\Compute\V1\CustomerEncryptionKey|null @@ -1163,7 +1439,9 @@ public function clearSourceDiskEncryptionKey() } /** - * The customer-supplied encryption key of the source disk. Required if the source disk is protected by a customer-supplied encryption key. + * Thecustomer-supplied + * encryption key of the source disk. Required if the source disk is + * protected by a customer-supplied encryption key. * * Generated from protobuf field optional .google.cloud.compute.v1.CustomerEncryptionKey source_disk_encryption_key = 531501153; * @param \Google\Cloud\Compute\V1\CustomerEncryptionKey $var @@ -1178,7 +1456,10 @@ public function setSourceDiskEncryptionKey($var) } /** - * [Output Only] The ID value of the disk used to create this image. This value may be used to determine whether the image was taken from the current or a previous instance of a given disk name. + * [Output Only] + * The ID value of the disk used to create this image. This value may be used + * to determine whether the image was taken from the current or a previous + * instance of a given disk name. * * Generated from protobuf field optional string source_disk_id = 454190809; * @return string @@ -1199,7 +1480,10 @@ public function clearSourceDiskId() } /** - * [Output Only] The ID value of the disk used to create this image. This value may be used to determine whether the image was taken from the current or a previous instance of a given disk name. + * [Output Only] + * The ID value of the disk used to create this image. This value may be used + * to determine whether the image was taken from the current or a previous + * instance of a given disk name. * * Generated from protobuf field optional string source_disk_id = 454190809; * @param string $var @@ -1214,7 +1498,17 @@ public function setSourceDiskId($var) } /** - * URL of the source image used to create this image. The following are valid formats for the URL: - https://www.googleapis.com/compute/v1/projects/project_id/global/ images/image_name - projects/project_id/global/images/image_name In order to create an image, you must provide the full or partial URL of one of the following: - The rawDisk.source URL - The sourceDisk URL - The sourceImage URL - The sourceSnapshot URL + * URL of the source image used to create this image. + * The following are valid formats for the URL: + * - https://www.googleapis.com/compute/v1/projects/project_id/global/ + * images/image_name + * - projects/project_id/global/images/image_name + * In order to create an image, you must provide the full or partial URL of + * one of the following: + * - The rawDisk.source URL + * - The sourceDisk URL + * - The sourceImage URL + * - The sourceSnapshot URL * * Generated from protobuf field optional string source_image = 50443319; * @return string @@ -1235,7 +1529,17 @@ public function clearSourceImage() } /** - * URL of the source image used to create this image. The following are valid formats for the URL: - https://www.googleapis.com/compute/v1/projects/project_id/global/ images/image_name - projects/project_id/global/images/image_name In order to create an image, you must provide the full or partial URL of one of the following: - The rawDisk.source URL - The sourceDisk URL - The sourceImage URL - The sourceSnapshot URL + * URL of the source image used to create this image. + * The following are valid formats for the URL: + * - https://www.googleapis.com/compute/v1/projects/project_id/global/ + * images/image_name + * - projects/project_id/global/images/image_name + * In order to create an image, you must provide the full or partial URL of + * one of the following: + * - The rawDisk.source URL + * - The sourceDisk URL + * - The sourceImage URL + * - The sourceSnapshot URL * * Generated from protobuf field optional string source_image = 50443319; * @param string $var @@ -1250,7 +1554,8 @@ public function setSourceImage($var) } /** - * The customer-supplied encryption key of the source image. Required if the source image is protected by a customer-supplied encryption key. + * The customer-supplied encryption key of the source image. Required if the + * source image is protected by a customer-supplied encryption key. * * Generated from protobuf field optional .google.cloud.compute.v1.CustomerEncryptionKey source_image_encryption_key = 381503659; * @return \Google\Cloud\Compute\V1\CustomerEncryptionKey|null @@ -1271,7 +1576,8 @@ public function clearSourceImageEncryptionKey() } /** - * The customer-supplied encryption key of the source image. Required if the source image is protected by a customer-supplied encryption key. + * The customer-supplied encryption key of the source image. Required if the + * source image is protected by a customer-supplied encryption key. * * Generated from protobuf field optional .google.cloud.compute.v1.CustomerEncryptionKey source_image_encryption_key = 381503659; * @param \Google\Cloud\Compute\V1\CustomerEncryptionKey $var @@ -1286,7 +1592,10 @@ public function setSourceImageEncryptionKey($var) } /** - * [Output Only] The ID value of the image used to create this image. This value may be used to determine whether the image was taken from the current or a previous instance of a given image name. + * [Output Only] + * The ID value of the image used to create this image. This value may be used + * to determine whether the image was taken from the current or a previous + * instance of a given image name. * * Generated from protobuf field optional string source_image_id = 55328291; * @return string @@ -1307,7 +1616,10 @@ public function clearSourceImageId() } /** - * [Output Only] The ID value of the image used to create this image. This value may be used to determine whether the image was taken from the current or a previous instance of a given image name. + * [Output Only] + * The ID value of the image used to create this image. This value may be used + * to determine whether the image was taken from the current or a previous + * instance of a given image name. * * Generated from protobuf field optional string source_image_id = 55328291; * @param string $var @@ -1322,7 +1634,17 @@ public function setSourceImageId($var) } /** - * URL of the source snapshot used to create this image. The following are valid formats for the URL: - https://www.googleapis.com/compute/v1/projects/project_id/global/ snapshots/snapshot_name - projects/project_id/global/snapshots/snapshot_name In order to create an image, you must provide the full or partial URL of one of the following: - The rawDisk.source URL - The sourceDisk URL - The sourceImage URL - The sourceSnapshot URL + * URL of the source snapshot used to create this image. + * The following are valid formats for the URL: + * - https://www.googleapis.com/compute/v1/projects/project_id/global/ + * snapshots/snapshot_name + * - projects/project_id/global/snapshots/snapshot_name + * In order to create an image, you must provide the full or partial URL of + * one of the following: + * - The rawDisk.source URL + * - The sourceDisk URL + * - The sourceImage URL + * - The sourceSnapshot URL * * Generated from protobuf field optional string source_snapshot = 126061928; * @return string @@ -1343,7 +1665,17 @@ public function clearSourceSnapshot() } /** - * URL of the source snapshot used to create this image. The following are valid formats for the URL: - https://www.googleapis.com/compute/v1/projects/project_id/global/ snapshots/snapshot_name - projects/project_id/global/snapshots/snapshot_name In order to create an image, you must provide the full or partial URL of one of the following: - The rawDisk.source URL - The sourceDisk URL - The sourceImage URL - The sourceSnapshot URL + * URL of the source snapshot used to create this image. + * The following are valid formats for the URL: + * - https://www.googleapis.com/compute/v1/projects/project_id/global/ + * snapshots/snapshot_name + * - projects/project_id/global/snapshots/snapshot_name + * In order to create an image, you must provide the full or partial URL of + * one of the following: + * - The rawDisk.source URL + * - The sourceDisk URL + * - The sourceImage URL + * - The sourceSnapshot URL * * Generated from protobuf field optional string source_snapshot = 126061928; * @param string $var @@ -1358,7 +1690,8 @@ public function setSourceSnapshot($var) } /** - * The customer-supplied encryption key of the source snapshot. Required if the source snapshot is protected by a customer-supplied encryption key. + * The customer-supplied encryption key of the source snapshot. Required if + * the source snapshot is protected by a customer-supplied encryption key. * * Generated from protobuf field optional .google.cloud.compute.v1.CustomerEncryptionKey source_snapshot_encryption_key = 303679322; * @return \Google\Cloud\Compute\V1\CustomerEncryptionKey|null @@ -1379,7 +1712,8 @@ public function clearSourceSnapshotEncryptionKey() } /** - * The customer-supplied encryption key of the source snapshot. Required if the source snapshot is protected by a customer-supplied encryption key. + * The customer-supplied encryption key of the source snapshot. Required if + * the source snapshot is protected by a customer-supplied encryption key. * * Generated from protobuf field optional .google.cloud.compute.v1.CustomerEncryptionKey source_snapshot_encryption_key = 303679322; * @param \Google\Cloud\Compute\V1\CustomerEncryptionKey $var @@ -1394,7 +1728,10 @@ public function setSourceSnapshotEncryptionKey($var) } /** - * [Output Only] The ID value of the snapshot used to create this image. This value may be used to determine whether the snapshot was taken from the current or a previous instance of a given snapshot name. + * [Output Only] + * The ID value of the snapshot used to create this image. This value may be + * used to determine whether the snapshot was taken from the current or a + * previous instance of a given snapshot name. * * Generated from protobuf field optional string source_snapshot_id = 98962258; * @return string @@ -1415,7 +1752,10 @@ public function clearSourceSnapshotId() } /** - * [Output Only] The ID value of the snapshot used to create this image. This value may be used to determine whether the snapshot was taken from the current or a previous instance of a given snapshot name. + * [Output Only] + * The ID value of the snapshot used to create this image. This value may be + * used to determine whether the snapshot was taken from the current or a + * previous instance of a given snapshot name. * * Generated from protobuf field optional string source_snapshot_id = 98962258; * @param string $var @@ -1430,7 +1770,8 @@ public function setSourceSnapshotId($var) } /** - * The type of the image used to create this disk. The default and only valid value is RAW. + * The type of the image used to create this disk. The + * default and only valid value is RAW. * Check the SourceType enum for the list of possible values. * * Generated from protobuf field optional string source_type = 452245726; @@ -1452,7 +1793,8 @@ public function clearSourceType() } /** - * The type of the image used to create this disk. The default and only valid value is RAW. + * The type of the image used to create this disk. The + * default and only valid value is RAW. * Check the SourceType enum for the list of possible values. * * Generated from protobuf field optional string source_type = 452245726; @@ -1468,7 +1810,10 @@ public function setSourceType($var) } /** - * [Output Only] The status of the image. An image can be used to create other resources, such as instances, only after the image has been successfully created and the status is set to READY. Possible values are FAILED, PENDING, or READY. + * [Output Only] The status of the image. An image can be used to create other + * resources, such as instances, only after the image has been successfully + * created and the status is set to READY. Possible + * values are FAILED, PENDING, orREADY. * Check the Status enum for the list of possible values. * * Generated from protobuf field optional string status = 181260274; @@ -1490,7 +1835,10 @@ public function clearStatus() } /** - * [Output Only] The status of the image. An image can be used to create other resources, such as instances, only after the image has been successfully created and the status is set to READY. Possible values are FAILED, PENDING, or READY. + * [Output Only] The status of the image. An image can be used to create other + * resources, such as instances, only after the image has been successfully + * created and the status is set to READY. Possible + * values are FAILED, PENDING, orREADY. * Check the Status enum for the list of possible values. * * Generated from protobuf field optional string status = 181260274; @@ -1506,7 +1854,8 @@ public function setStatus($var) } /** - * Cloud Storage bucket storage location of the image (regional or multi-regional). + * Cloud Storage bucket storage location of the image (regional or + * multi-regional). * * Generated from protobuf field repeated string storage_locations = 328005274; * @return \Google\Protobuf\Internal\RepeatedField @@ -1517,7 +1866,8 @@ public function getStorageLocations() } /** - * Cloud Storage bucket storage location of the image (regional or multi-regional). + * Cloud Storage bucket storage location of the image (regional or + * multi-regional). * * Generated from protobuf field repeated string storage_locations = 328005274; * @param array|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/Image/Architecture.php b/Compute/src/V1/Image/Architecture.php index 5ba599814021..e0d6852bc0ae 100644 --- a/Compute/src/V1/Image/Architecture.php +++ b/Compute/src/V1/Image/Architecture.php @@ -7,7 +7,8 @@ use UnexpectedValueException; /** - * The architecture of the image. Valid values are ARM64 or X86_64. + * The architecture of the image. Valid values are + * ARM64 or X86_64. * * Protobuf type google.cloud.compute.v1.Image.Architecture */ diff --git a/Compute/src/V1/Image/SourceType.php b/Compute/src/V1/Image/SourceType.php index e39b72be88e1..2e52a9b09f7c 100644 --- a/Compute/src/V1/Image/SourceType.php +++ b/Compute/src/V1/Image/SourceType.php @@ -7,7 +7,8 @@ use UnexpectedValueException; /** - * The type of the image used to create this disk. The default and only valid value is RAW. + * The type of the image used to create this disk. The + * default and only valid value is RAW. * * Protobuf type google.cloud.compute.v1.Image.SourceType */ diff --git a/Compute/src/V1/Image/Status.php b/Compute/src/V1/Image/Status.php index fa1b4b2399e4..08c0c9b6a393 100644 --- a/Compute/src/V1/Image/Status.php +++ b/Compute/src/V1/Image/Status.php @@ -7,7 +7,10 @@ use UnexpectedValueException; /** - * [Output Only] The status of the image. An image can be used to create other resources, such as instances, only after the image has been successfully created and the status is set to READY. Possible values are FAILED, PENDING, or READY. + * [Output Only] The status of the image. An image can be used to create other + * resources, such as instances, only after the image has been successfully + * created and the status is set to READY. Possible + * values are FAILED, PENDING, orREADY. * * Protobuf type google.cloud.compute.v1.Image.Status */ diff --git a/Compute/src/V1/ImageFamilyView.php b/Compute/src/V1/ImageFamilyView.php index 7f7c94e3eca3..214ea5afdc5d 100644 --- a/Compute/src/V1/ImageFamilyView.php +++ b/Compute/src/V1/ImageFamilyView.php @@ -15,7 +15,8 @@ class ImageFamilyView extends \Google\Protobuf\Internal\Message { /** - * The latest image that is part of the specified image family in the requested location, and that is not deprecated. + * The latest image that is part of the specified image family in the + * requested location, and that is not deprecated. * * Generated from protobuf field optional .google.cloud.compute.v1.Image image = 100313435; */ @@ -28,7 +29,8 @@ class ImageFamilyView extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type \Google\Cloud\Compute\V1\Image $image - * The latest image that is part of the specified image family in the requested location, and that is not deprecated. + * The latest image that is part of the specified image family in the + * requested location, and that is not deprecated. * } */ public function __construct($data = NULL) { @@ -37,7 +39,8 @@ public function __construct($data = NULL) { } /** - * The latest image that is part of the specified image family in the requested location, and that is not deprecated. + * The latest image that is part of the specified image family in the + * requested location, and that is not deprecated. * * Generated from protobuf field optional .google.cloud.compute.v1.Image image = 100313435; * @return \Google\Cloud\Compute\V1\Image|null @@ -58,7 +61,8 @@ public function clearImage() } /** - * The latest image that is part of the specified image family in the requested location, and that is not deprecated. + * The latest image that is part of the specified image family in the + * requested location, and that is not deprecated. * * Generated from protobuf field optional .google.cloud.compute.v1.Image image = 100313435; * @param \Google\Cloud\Compute\V1\Image $var diff --git a/Compute/src/V1/ImageList.php b/Compute/src/V1/ImageList.php index 7540dc6812ef..7156a74513a0 100644 --- a/Compute/src/V1/ImageList.php +++ b/Compute/src/V1/ImageList.php @@ -34,7 +34,11 @@ class ImageList extends \Google\Protobuf\Internal\Message */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -65,7 +69,11 @@ class ImageList extends \Google\Protobuf\Internal\Message * @type string $kind * Type of resource. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type \Google\Cloud\Compute\V1\Warning $warning @@ -176,7 +184,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -197,7 +209,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/ImageParams.php b/Compute/src/V1/ImageParams.php index 68ca4d9b7d19..7c5ddb77d742 100644 --- a/Compute/src/V1/ImageParams.php +++ b/Compute/src/V1/ImageParams.php @@ -16,7 +16,11 @@ class ImageParams extends \Google\Protobuf\Internal\Message { /** - * Resource manager tags to be bound to the image. Tag keys and values have the same definition as resource manager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and values are in the format `tagValues/456`. The field is ignored (both PUT & PATCH) when empty. + * Resource manager tags to be bound to the image. Tag keys and values have + * the same definition as resource + * manager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and + * values are in the format `tagValues/456`. The field is ignored (both PUT & + * PATCH) when empty. * * Generated from protobuf field map resource_manager_tags = 377671164; */ @@ -29,7 +33,11 @@ class ImageParams extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type array|\Google\Protobuf\Internal\MapField $resource_manager_tags - * Resource manager tags to be bound to the image. Tag keys and values have the same definition as resource manager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and values are in the format `tagValues/456`. The field is ignored (both PUT & PATCH) when empty. + * Resource manager tags to be bound to the image. Tag keys and values have + * the same definition as resource + * manager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and + * values are in the format `tagValues/456`. The field is ignored (both PUT & + * PATCH) when empty. * } */ public function __construct($data = NULL) { @@ -38,7 +46,11 @@ public function __construct($data = NULL) { } /** - * Resource manager tags to be bound to the image. Tag keys and values have the same definition as resource manager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and values are in the format `tagValues/456`. The field is ignored (both PUT & PATCH) when empty. + * Resource manager tags to be bound to the image. Tag keys and values have + * the same definition as resource + * manager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and + * values are in the format `tagValues/456`. The field is ignored (both PUT & + * PATCH) when empty. * * Generated from protobuf field map resource_manager_tags = 377671164; * @return \Google\Protobuf\Internal\MapField @@ -49,7 +61,11 @@ public function getResourceManagerTags() } /** - * Resource manager tags to be bound to the image. Tag keys and values have the same definition as resource manager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and values are in the format `tagValues/456`. The field is ignored (both PUT & PATCH) when empty. + * Resource manager tags to be bound to the image. Tag keys and values have + * the same definition as resource + * manager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and + * values are in the format `tagValues/456`. The field is ignored (both PUT & + * PATCH) when empty. * * Generated from protobuf field map resource_manager_tags = 377671164; * @param array|\Google\Protobuf\Internal\MapField $var diff --git a/Compute/src/V1/InitialStateConfig.php b/Compute/src/V1/InitialStateConfig.php index 96e400df7c5a..3127a7797251 100644 --- a/Compute/src/V1/InitialStateConfig.php +++ b/Compute/src/V1/InitialStateConfig.php @@ -9,7 +9,8 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Initial State for shielded instance, these are public keys which are safe to store in public + * Initial State for shielded instance, + * these are public keys which are safe to store in public * * Generated from protobuf message google.cloud.compute.v1.InitialStateConfig */ diff --git a/Compute/src/V1/InsertAddressRequest.php b/Compute/src/V1/InsertAddressRequest.php index a61d4eaae2eb..28d7b392a8bc 100644 --- a/Compute/src/V1/InsertAddressRequest.php +++ b/Compute/src/V1/InsertAddressRequest.php @@ -34,7 +34,17 @@ class InsertAddressRequest extends \Google\Protobuf\Internal\Message */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -70,7 +80,17 @@ public static function build(string $project, string $region, \Google\Cloud\Comp * @type string $region * Name of the region for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -167,7 +187,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -188,7 +218,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/InsertAutoscalerRequest.php b/Compute/src/V1/InsertAutoscalerRequest.php index 078d4794ee28..54a73156d210 100644 --- a/Compute/src/V1/InsertAutoscalerRequest.php +++ b/Compute/src/V1/InsertAutoscalerRequest.php @@ -28,7 +28,17 @@ class InsertAutoscalerRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -68,7 +78,17 @@ public static function build(string $project, string $zone, \Google\Cloud\Comput * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $zone * Name of the zone for this request. * } @@ -141,7 +161,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -162,7 +192,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/InsertBackendBucketRequest.php b/Compute/src/V1/InsertBackendBucketRequest.php index 07e743f5cd88..e8184646f04e 100644 --- a/Compute/src/V1/InsertBackendBucketRequest.php +++ b/Compute/src/V1/InsertBackendBucketRequest.php @@ -28,7 +28,17 @@ class InsertBackendBucketRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -60,7 +70,17 @@ public static function build(string $project, \Google\Cloud\Compute\V1\BackendBu * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -131,7 +151,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -152,7 +182,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/InsertBackendServiceRequest.php b/Compute/src/V1/InsertBackendServiceRequest.php index 4a420dd594b1..d6648670e6e3 100644 --- a/Compute/src/V1/InsertBackendServiceRequest.php +++ b/Compute/src/V1/InsertBackendServiceRequest.php @@ -28,7 +28,17 @@ class InsertBackendServiceRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -60,7 +70,17 @@ public static function build(string $project, \Google\Cloud\Compute\V1\BackendSe * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -131,7 +151,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -152,7 +182,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/InsertCrossSiteNetworkRequest.php b/Compute/src/V1/InsertCrossSiteNetworkRequest.php new file mode 100644 index 000000000000..c415dafa2eb3 --- /dev/null +++ b/Compute/src/V1/InsertCrossSiteNetworkRequest.php @@ -0,0 +1,258 @@ +google.cloud.compute.v1.InsertCrossSiteNetworkRequest + */ +class InsertCrossSiteNetworkRequest extends \Google\Protobuf\Internal\Message +{ + /** + * The body resource for this request + * + * Generated from protobuf field .google.cloud.compute.v1.CrossSiteNetwork cross_site_network_resource = 30896696 [(.google.api.field_behavior) = REQUIRED]; + */ + protected $cross_site_network_resource = null; + /** + * Project ID for this request. + * + * Generated from protobuf field string project = 227560217 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "project"]; + */ + protected $project = ''; + /** + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). + * end_interface: MixerMutationRequestBuilder + * + * Generated from protobuf field optional string request_id = 37109963; + */ + protected $request_id = null; + /** + * [Input Only] Validate the new configuration, but don't create it. + * + * Generated from protobuf field optional bool validate_only = 242744629; + */ + protected $validate_only = null; + + /** + * @param string $project Project ID for this request. + * @param \Google\Cloud\Compute\V1\CrossSiteNetwork $crossSiteNetworkResource The body resource for this request + * + * @return \Google\Cloud\Compute\V1\InsertCrossSiteNetworkRequest + * + * @experimental + */ + public static function build(string $project, \Google\Cloud\Compute\V1\CrossSiteNetwork $crossSiteNetworkResource): self + { + return (new self()) + ->setProject($project) + ->setCrossSiteNetworkResource($crossSiteNetworkResource); + } + + /** + * Constructor. + * + * @param array $data { + * Optional. Data for populating the Message object. + * + * @type \Google\Cloud\Compute\V1\CrossSiteNetwork $cross_site_network_resource + * The body resource for this request + * @type string $project + * Project ID for this request. + * @type string $request_id + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). + * end_interface: MixerMutationRequestBuilder + * @type bool $validate_only + * [Input Only] Validate the new configuration, but don't create it. + * } + */ + public function __construct($data = NULL) { + \GPBMetadata\Google\Cloud\Compute\V1\Compute::initOnce(); + parent::__construct($data); + } + + /** + * The body resource for this request + * + * Generated from protobuf field .google.cloud.compute.v1.CrossSiteNetwork cross_site_network_resource = 30896696 [(.google.api.field_behavior) = REQUIRED]; + * @return \Google\Cloud\Compute\V1\CrossSiteNetwork|null + */ + public function getCrossSiteNetworkResource() + { + return $this->cross_site_network_resource; + } + + public function hasCrossSiteNetworkResource() + { + return isset($this->cross_site_network_resource); + } + + public function clearCrossSiteNetworkResource() + { + unset($this->cross_site_network_resource); + } + + /** + * The body resource for this request + * + * Generated from protobuf field .google.cloud.compute.v1.CrossSiteNetwork cross_site_network_resource = 30896696 [(.google.api.field_behavior) = REQUIRED]; + * @param \Google\Cloud\Compute\V1\CrossSiteNetwork $var + * @return $this + */ + public function setCrossSiteNetworkResource($var) + { + GPBUtil::checkMessage($var, \Google\Cloud\Compute\V1\CrossSiteNetwork::class); + $this->cross_site_network_resource = $var; + + return $this; + } + + /** + * Project ID for this request. + * + * Generated from protobuf field string project = 227560217 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "project"]; + * @return string + */ + public function getProject() + { + return $this->project; + } + + /** + * Project ID for this request. + * + * Generated from protobuf field string project = 227560217 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "project"]; + * @param string $var + * @return $this + */ + public function setProject($var) + { + GPBUtil::checkString($var, True); + $this->project = $var; + + return $this; + } + + /** + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). + * end_interface: MixerMutationRequestBuilder + * + * Generated from protobuf field optional string request_id = 37109963; + * @return string + */ + public function getRequestId() + { + return isset($this->request_id) ? $this->request_id : ''; + } + + public function hasRequestId() + { + return isset($this->request_id); + } + + public function clearRequestId() + { + unset($this->request_id); + } + + /** + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). + * end_interface: MixerMutationRequestBuilder + * + * Generated from protobuf field optional string request_id = 37109963; + * @param string $var + * @return $this + */ + public function setRequestId($var) + { + GPBUtil::checkString($var, True); + $this->request_id = $var; + + return $this; + } + + /** + * [Input Only] Validate the new configuration, but don't create it. + * + * Generated from protobuf field optional bool validate_only = 242744629; + * @return bool + */ + public function getValidateOnly() + { + return isset($this->validate_only) ? $this->validate_only : false; + } + + public function hasValidateOnly() + { + return isset($this->validate_only); + } + + public function clearValidateOnly() + { + unset($this->validate_only); + } + + /** + * [Input Only] Validate the new configuration, but don't create it. + * + * Generated from protobuf field optional bool validate_only = 242744629; + * @param bool $var + * @return $this + */ + public function setValidateOnly($var) + { + GPBUtil::checkBool($var); + $this->validate_only = $var; + + return $this; + } + +} + diff --git a/Compute/src/V1/InsertDiskRequest.php b/Compute/src/V1/InsertDiskRequest.php index df0fae9c6e8b..d1ba6d1a544e 100644 --- a/Compute/src/V1/InsertDiskRequest.php +++ b/Compute/src/V1/InsertDiskRequest.php @@ -28,7 +28,17 @@ class InsertDiskRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -74,7 +84,17 @@ public static function build(string $project, string $zone, \Google\Cloud\Comput * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $source_image * Source image to restore onto a disk. This field is optional. * @type string $zone @@ -149,7 +169,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -170,7 +200,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/InsertExternalVpnGatewayRequest.php b/Compute/src/V1/InsertExternalVpnGatewayRequest.php index 35dbce8dd374..b9bcb91a54f6 100644 --- a/Compute/src/V1/InsertExternalVpnGatewayRequest.php +++ b/Compute/src/V1/InsertExternalVpnGatewayRequest.php @@ -28,7 +28,17 @@ class InsertExternalVpnGatewayRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -60,7 +70,17 @@ public static function build(string $project, \Google\Cloud\Compute\V1\ExternalV * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -131,7 +151,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -152,7 +182,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/InsertFirewallPolicyRequest.php b/Compute/src/V1/InsertFirewallPolicyRequest.php index b44520fb1d5e..f15b9c429fac 100644 --- a/Compute/src/V1/InsertFirewallPolicyRequest.php +++ b/Compute/src/V1/InsertFirewallPolicyRequest.php @@ -22,20 +22,34 @@ class InsertFirewallPolicyRequest extends \Google\Protobuf\Internal\Message */ protected $firewall_policy_resource = null; /** - * Parent ID for this request. The ID can be either be "folders/[FOLDER_ID]" if the parent is a folder or "organizations/[ORGANIZATION_ID]" if the parent is an organization. + * Parent ID for this request. The ID can be either be "folders/[FOLDER_ID]" + * if the parent is a folder or "organizations/[ORGANIZATION_ID]" if the + * parent is an organization. * * Generated from protobuf field string parent_id = 459714768 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "parent_id"]; */ protected $parent_id = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ protected $request_id = null; /** - * @param string $parentId Parent ID for this request. The ID can be either be "folders/[FOLDER_ID]" if the parent is a folder or "organizations/[ORGANIZATION_ID]" if the parent is an organization. + * @param string $parentId Parent ID for this request. The ID can be either be "folders/[FOLDER_ID]" + * if the parent is a folder or "organizations/[ORGANIZATION_ID]" if the + * parent is an organization. * @param \Google\Cloud\Compute\V1\FirewallPolicy $firewallPolicyResource The body resource for this request * * @return \Google\Cloud\Compute\V1\InsertFirewallPolicyRequest @@ -58,9 +72,21 @@ public static function build(string $parentId, \Google\Cloud\Compute\V1\Firewall * @type \Google\Cloud\Compute\V1\FirewallPolicy $firewall_policy_resource * The body resource for this request * @type string $parent_id - * Parent ID for this request. The ID can be either be "folders/[FOLDER_ID]" if the parent is a folder or "organizations/[ORGANIZATION_ID]" if the parent is an organization. + * Parent ID for this request. The ID can be either be "folders/[FOLDER_ID]" + * if the parent is a folder or "organizations/[ORGANIZATION_ID]" if the + * parent is an organization. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -105,7 +131,9 @@ public function setFirewallPolicyResource($var) } /** - * Parent ID for this request. The ID can be either be "folders/[FOLDER_ID]" if the parent is a folder or "organizations/[ORGANIZATION_ID]" if the parent is an organization. + * Parent ID for this request. The ID can be either be "folders/[FOLDER_ID]" + * if the parent is a folder or "organizations/[ORGANIZATION_ID]" if the + * parent is an organization. * * Generated from protobuf field string parent_id = 459714768 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "parent_id"]; * @return string @@ -116,7 +144,9 @@ public function getParentId() } /** - * Parent ID for this request. The ID can be either be "folders/[FOLDER_ID]" if the parent is a folder or "organizations/[ORGANIZATION_ID]" if the parent is an organization. + * Parent ID for this request. The ID can be either be "folders/[FOLDER_ID]" + * if the parent is a folder or "organizations/[ORGANIZATION_ID]" if the + * parent is an organization. * * Generated from protobuf field string parent_id = 459714768 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "parent_id"]; * @param string $var @@ -131,7 +161,17 @@ public function setParentId($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -152,7 +192,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/InsertFirewallRequest.php b/Compute/src/V1/InsertFirewallRequest.php index c5cbc7a29ecd..36e6c3be78ff 100644 --- a/Compute/src/V1/InsertFirewallRequest.php +++ b/Compute/src/V1/InsertFirewallRequest.php @@ -28,7 +28,17 @@ class InsertFirewallRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -60,7 +70,17 @@ public static function build(string $project, \Google\Cloud\Compute\V1\Firewall * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -131,7 +151,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -152,7 +182,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/InsertForwardingRuleRequest.php b/Compute/src/V1/InsertForwardingRuleRequest.php index 6b7e59b61553..f406d75e1eb6 100644 --- a/Compute/src/V1/InsertForwardingRuleRequest.php +++ b/Compute/src/V1/InsertForwardingRuleRequest.php @@ -34,7 +34,17 @@ class InsertForwardingRuleRequest extends \Google\Protobuf\Internal\Message */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -70,7 +80,17 @@ public static function build(string $project, string $region, \Google\Cloud\Comp * @type string $region * Name of the region scoping this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -167,7 +187,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -188,7 +218,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/InsertFutureReservationRequest.php b/Compute/src/V1/InsertFutureReservationRequest.php new file mode 100644 index 000000000000..905432efbaf1 --- /dev/null +++ b/Compute/src/V1/InsertFutureReservationRequest.php @@ -0,0 +1,246 @@ +google.cloud.compute.v1.InsertFutureReservationRequest + */ +class InsertFutureReservationRequest extends \Google\Protobuf\Internal\Message +{ + /** + * The body resource for this request + * + * Generated from protobuf field .google.cloud.compute.v1.FutureReservation future_reservation_resource = 466750493 [(.google.api.field_behavior) = REQUIRED]; + */ + protected $future_reservation_resource = null; + /** + * Project ID for this request. + * + * Generated from protobuf field string project = 227560217 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "project"]; + */ + protected $project = ''; + /** + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). + * + * Generated from protobuf field optional string request_id = 37109963; + */ + protected $request_id = null; + /** + * Name of the zone for this request. Name should conform to RFC1035. + * + * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; + */ + protected $zone = ''; + + /** + * @param string $project Project ID for this request. + * @param string $zone Name of the zone for this request. Name should conform to RFC1035. + * @param \Google\Cloud\Compute\V1\FutureReservation $futureReservationResource The body resource for this request + * + * @return \Google\Cloud\Compute\V1\InsertFutureReservationRequest + * + * @experimental + */ + public static function build(string $project, string $zone, \Google\Cloud\Compute\V1\FutureReservation $futureReservationResource): self + { + return (new self()) + ->setProject($project) + ->setZone($zone) + ->setFutureReservationResource($futureReservationResource); + } + + /** + * Constructor. + * + * @param array $data { + * Optional. Data for populating the Message object. + * + * @type \Google\Cloud\Compute\V1\FutureReservation $future_reservation_resource + * The body resource for this request + * @type string $project + * Project ID for this request. + * @type string $request_id + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). + * @type string $zone + * Name of the zone for this request. Name should conform to RFC1035. + * } + */ + public function __construct($data = NULL) { + \GPBMetadata\Google\Cloud\Compute\V1\Compute::initOnce(); + parent::__construct($data); + } + + /** + * The body resource for this request + * + * Generated from protobuf field .google.cloud.compute.v1.FutureReservation future_reservation_resource = 466750493 [(.google.api.field_behavior) = REQUIRED]; + * @return \Google\Cloud\Compute\V1\FutureReservation|null + */ + public function getFutureReservationResource() + { + return $this->future_reservation_resource; + } + + public function hasFutureReservationResource() + { + return isset($this->future_reservation_resource); + } + + public function clearFutureReservationResource() + { + unset($this->future_reservation_resource); + } + + /** + * The body resource for this request + * + * Generated from protobuf field .google.cloud.compute.v1.FutureReservation future_reservation_resource = 466750493 [(.google.api.field_behavior) = REQUIRED]; + * @param \Google\Cloud\Compute\V1\FutureReservation $var + * @return $this + */ + public function setFutureReservationResource($var) + { + GPBUtil::checkMessage($var, \Google\Cloud\Compute\V1\FutureReservation::class); + $this->future_reservation_resource = $var; + + return $this; + } + + /** + * Project ID for this request. + * + * Generated from protobuf field string project = 227560217 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "project"]; + * @return string + */ + public function getProject() + { + return $this->project; + } + + /** + * Project ID for this request. + * + * Generated from protobuf field string project = 227560217 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "project"]; + * @param string $var + * @return $this + */ + public function setProject($var) + { + GPBUtil::checkString($var, True); + $this->project = $var; + + return $this; + } + + /** + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). + * + * Generated from protobuf field optional string request_id = 37109963; + * @return string + */ + public function getRequestId() + { + return isset($this->request_id) ? $this->request_id : ''; + } + + public function hasRequestId() + { + return isset($this->request_id); + } + + public function clearRequestId() + { + unset($this->request_id); + } + + /** + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). + * + * Generated from protobuf field optional string request_id = 37109963; + * @param string $var + * @return $this + */ + public function setRequestId($var) + { + GPBUtil::checkString($var, True); + $this->request_id = $var; + + return $this; + } + + /** + * Name of the zone for this request. Name should conform to RFC1035. + * + * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; + * @return string + */ + public function getZone() + { + return $this->zone; + } + + /** + * Name of the zone for this request. Name should conform to RFC1035. + * + * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; + * @param string $var + * @return $this + */ + public function setZone($var) + { + GPBUtil::checkString($var, True); + $this->zone = $var; + + return $this; + } + +} + diff --git a/Compute/src/V1/InsertGlobalAddressRequest.php b/Compute/src/V1/InsertGlobalAddressRequest.php index 43e80fbd727a..73724439d810 100644 --- a/Compute/src/V1/InsertGlobalAddressRequest.php +++ b/Compute/src/V1/InsertGlobalAddressRequest.php @@ -28,7 +28,17 @@ class InsertGlobalAddressRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -60,7 +70,17 @@ public static function build(string $project, \Google\Cloud\Compute\V1\Address $ * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -131,7 +151,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -152,7 +182,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/InsertGlobalForwardingRuleRequest.php b/Compute/src/V1/InsertGlobalForwardingRuleRequest.php index 54d069c6a667..5262a2893bc5 100644 --- a/Compute/src/V1/InsertGlobalForwardingRuleRequest.php +++ b/Compute/src/V1/InsertGlobalForwardingRuleRequest.php @@ -28,7 +28,17 @@ class InsertGlobalForwardingRuleRequest extends \Google\Protobuf\Internal\Messag */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -60,7 +70,17 @@ public static function build(string $project, \Google\Cloud\Compute\V1\Forwardin * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -131,7 +151,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -152,7 +182,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/InsertGlobalNetworkEndpointGroupRequest.php b/Compute/src/V1/InsertGlobalNetworkEndpointGroupRequest.php index b11a7232b7cb..bb16199a7017 100644 --- a/Compute/src/V1/InsertGlobalNetworkEndpointGroupRequest.php +++ b/Compute/src/V1/InsertGlobalNetworkEndpointGroupRequest.php @@ -28,7 +28,17 @@ class InsertGlobalNetworkEndpointGroupRequest extends \Google\Protobuf\Internal\ */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -60,7 +70,17 @@ public static function build(string $project, \Google\Cloud\Compute\V1\NetworkEn * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -131,7 +151,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -152,7 +182,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/InsertGlobalPublicDelegatedPrefixeRequest.php b/Compute/src/V1/InsertGlobalPublicDelegatedPrefixeRequest.php index 775e80c19456..88fc875496cf 100644 --- a/Compute/src/V1/InsertGlobalPublicDelegatedPrefixeRequest.php +++ b/Compute/src/V1/InsertGlobalPublicDelegatedPrefixeRequest.php @@ -28,7 +28,17 @@ class InsertGlobalPublicDelegatedPrefixeRequest extends \Google\Protobuf\Interna */ protected $public_delegated_prefix_resource = null; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -60,7 +70,17 @@ public static function build(string $project, \Google\Cloud\Compute\V1\PublicDel * @type \Google\Cloud\Compute\V1\PublicDelegatedPrefix $public_delegated_prefix_resource * The body resource for this request * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -131,7 +151,17 @@ public function setPublicDelegatedPrefixResource($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -152,7 +182,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/InsertHealthCheckRequest.php b/Compute/src/V1/InsertHealthCheckRequest.php index 63460d8de2d9..4bced0f20045 100644 --- a/Compute/src/V1/InsertHealthCheckRequest.php +++ b/Compute/src/V1/InsertHealthCheckRequest.php @@ -28,7 +28,17 @@ class InsertHealthCheckRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -60,7 +70,17 @@ public static function build(string $project, \Google\Cloud\Compute\V1\HealthChe * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -131,7 +151,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -152,7 +182,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/InsertImageRequest.php b/Compute/src/V1/InsertImageRequest.php index 06bbf451eac3..6fe110757ab0 100644 --- a/Compute/src/V1/InsertImageRequest.php +++ b/Compute/src/V1/InsertImageRequest.php @@ -34,7 +34,17 @@ class InsertImageRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -68,7 +78,17 @@ public static function build(string $project, \Google\Cloud\Compute\V1\Image $im * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -175,7 +195,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -196,7 +226,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/InsertInstanceGroupManagerRequest.php b/Compute/src/V1/InsertInstanceGroupManagerRequest.php index 1cfd97090283..f1e5ac61fd51 100644 --- a/Compute/src/V1/InsertInstanceGroupManagerRequest.php +++ b/Compute/src/V1/InsertInstanceGroupManagerRequest.php @@ -28,13 +28,24 @@ class InsertInstanceGroupManagerRequest extends \Google\Protobuf\Internal\Messag */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ protected $request_id = null; /** - * The name of the zone where you want to create the managed instance group. + * The name of the zone + * where you want to create the managed instance group. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; */ @@ -42,7 +53,8 @@ class InsertInstanceGroupManagerRequest extends \Google\Protobuf\Internal\Messag /** * @param string $project Project ID for this request. - * @param string $zone The name of the zone where you want to create the managed instance group. + * @param string $zone The name of the zone + * where you want to create the managed instance group. * @param \Google\Cloud\Compute\V1\InstanceGroupManager $instanceGroupManagerResource The body resource for this request * * @return \Google\Cloud\Compute\V1\InsertInstanceGroupManagerRequest @@ -68,9 +80,20 @@ public static function build(string $project, string $zone, \Google\Cloud\Comput * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $zone - * The name of the zone where you want to create the managed instance group. + * The name of the zone + * where you want to create the managed instance group. * } */ public function __construct($data = NULL) { @@ -141,7 +164,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -162,7 +195,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var @@ -177,7 +220,8 @@ public function setRequestId($var) } /** - * The name of the zone where you want to create the managed instance group. + * The name of the zone + * where you want to create the managed instance group. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; * @return string @@ -188,7 +232,8 @@ public function getZone() } /** - * The name of the zone where you want to create the managed instance group. + * The name of the zone + * where you want to create the managed instance group. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; * @param string $var diff --git a/Compute/src/V1/InsertInstanceGroupManagerResizeRequestRequest.php b/Compute/src/V1/InsertInstanceGroupManagerResizeRequestRequest.php index 705d3a8aad57..df2ff341a2c5 100644 --- a/Compute/src/V1/InsertInstanceGroupManagerResizeRequestRequest.php +++ b/Compute/src/V1/InsertInstanceGroupManagerResizeRequestRequest.php @@ -16,7 +16,9 @@ class InsertInstanceGroupManagerResizeRequestRequest extends \Google\Protobuf\Internal\Message { /** - * The name of the managed instance group to which the resize request will be added. Name should conform to RFC1035 or be a resource ID. + * The name of the managed instance group to which the resize request will + * be added. + * Name should conform to RFC1035 or be a resource ID. * * Generated from protobuf field string instance_group_manager = 249363395 [(.google.api.field_behavior) = REQUIRED]; */ @@ -34,13 +36,25 @@ class InsertInstanceGroupManagerResizeRequestRequest extends \Google\Protobuf\In */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ protected $request_id = null; /** - * The name of the zone where the managed instance group is located and where the resize request will be created. Name should conform to RFC1035. + * The name of thezone where the managed + * instance group is located and where the resize request will be created. + * Name should conform to RFC1035. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; */ @@ -48,8 +62,12 @@ class InsertInstanceGroupManagerResizeRequestRequest extends \Google\Protobuf\In /** * @param string $project Project ID for this request. - * @param string $zone The name of the zone where the managed instance group is located and where the resize request will be created. Name should conform to RFC1035. - * @param string $instanceGroupManager The name of the managed instance group to which the resize request will be added. Name should conform to RFC1035 or be a resource ID. + * @param string $zone The name of thezone where the managed + * instance group is located and where the resize request will be created. + * Name should conform to RFC1035. + * @param string $instanceGroupManager The name of the managed instance group to which the resize request will + * be added. + * Name should conform to RFC1035 or be a resource ID. * @param \Google\Cloud\Compute\V1\InstanceGroupManagerResizeRequest $instanceGroupManagerResizeRequestResource The body resource for this request * * @return \Google\Cloud\Compute\V1\InsertInstanceGroupManagerResizeRequestRequest @@ -72,15 +90,29 @@ public static function build(string $project, string $zone, string $instanceGrou * Optional. Data for populating the Message object. * * @type string $instance_group_manager - * The name of the managed instance group to which the resize request will be added. Name should conform to RFC1035 or be a resource ID. + * The name of the managed instance group to which the resize request will + * be added. + * Name should conform to RFC1035 or be a resource ID. * @type \Google\Cloud\Compute\V1\InstanceGroupManagerResizeRequest $instance_group_manager_resize_request_resource * The body resource for this request * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $zone - * The name of the zone where the managed instance group is located and where the resize request will be created. Name should conform to RFC1035. + * The name of thezone where the managed + * instance group is located and where the resize request will be created. + * Name should conform to RFC1035. * } */ public function __construct($data = NULL) { @@ -89,7 +121,9 @@ public function __construct($data = NULL) { } /** - * The name of the managed instance group to which the resize request will be added. Name should conform to RFC1035 or be a resource ID. + * The name of the managed instance group to which the resize request will + * be added. + * Name should conform to RFC1035 or be a resource ID. * * Generated from protobuf field string instance_group_manager = 249363395 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -100,7 +134,9 @@ public function getInstanceGroupManager() } /** - * The name of the managed instance group to which the resize request will be added. Name should conform to RFC1035 or be a resource ID. + * The name of the managed instance group to which the resize request will + * be added. + * Name should conform to RFC1035 or be a resource ID. * * Generated from protobuf field string instance_group_manager = 249363395 [(.google.api.field_behavior) = REQUIRED]; * @param string $var @@ -177,7 +213,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -198,7 +244,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var @@ -213,7 +269,9 @@ public function setRequestId($var) } /** - * The name of the zone where the managed instance group is located and where the resize request will be created. Name should conform to RFC1035. + * The name of thezone where the managed + * instance group is located and where the resize request will be created. + * Name should conform to RFC1035. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; * @return string @@ -224,7 +282,9 @@ public function getZone() } /** - * The name of the zone where the managed instance group is located and where the resize request will be created. Name should conform to RFC1035. + * The name of thezone where the managed + * instance group is located and where the resize request will be created. + * Name should conform to RFC1035. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; * @param string $var diff --git a/Compute/src/V1/InsertInstanceGroupRequest.php b/Compute/src/V1/InsertInstanceGroupRequest.php index abec107d1cd0..15f3a5363503 100644 --- a/Compute/src/V1/InsertInstanceGroupRequest.php +++ b/Compute/src/V1/InsertInstanceGroupRequest.php @@ -28,13 +28,24 @@ class InsertInstanceGroupRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ protected $request_id = null; /** - * The name of the zone where you want to create the instance group. + * The name of the zone + * where you want to create the instance group. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; */ @@ -42,7 +53,8 @@ class InsertInstanceGroupRequest extends \Google\Protobuf\Internal\Message /** * @param string $project Project ID for this request. - * @param string $zone The name of the zone where you want to create the instance group. + * @param string $zone The name of the zone + * where you want to create the instance group. * @param \Google\Cloud\Compute\V1\InstanceGroup $instanceGroupResource The body resource for this request * * @return \Google\Cloud\Compute\V1\InsertInstanceGroupRequest @@ -68,9 +80,20 @@ public static function build(string $project, string $zone, \Google\Cloud\Comput * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $zone - * The name of the zone where you want to create the instance group. + * The name of the zone + * where you want to create the instance group. * } */ public function __construct($data = NULL) { @@ -141,7 +164,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -162,7 +195,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var @@ -177,7 +220,8 @@ public function setRequestId($var) } /** - * The name of the zone where you want to create the instance group. + * The name of the zone + * where you want to create the instance group. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; * @return string @@ -188,7 +232,8 @@ public function getZone() } /** - * The name of the zone where you want to create the instance group. + * The name of the zone + * where you want to create the instance group. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; * @param string $var diff --git a/Compute/src/V1/InsertInstanceRequest.php b/Compute/src/V1/InsertInstanceRequest.php index 267ea18e5f56..71644bc87add 100644 --- a/Compute/src/V1/InsertInstanceRequest.php +++ b/Compute/src/V1/InsertInstanceRequest.php @@ -28,19 +28,39 @@ class InsertInstanceRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ protected $request_id = null; /** - * Specifies instance template to create the instance. This field is optional. It can be a full or partial URL. For example, the following are all valid URLs to an instance template: - https://www.googleapis.com/compute/v1/projects/project /global/instanceTemplates/instanceTemplate - projects/project/global/instanceTemplates/instanceTemplate - global/instanceTemplates/instanceTemplate + * Specifies instance template to create the instance. + * This field is optional. It can be a full or partial URL. For example, the + * following are all valid URLs to an instance template: + * - https://www.googleapis.com/compute/v1/projects/project/global/instanceTemplates/instanceTemplate + * - projects/project/global/instanceTemplates/instanceTemplate + * - global/instanceTemplates/instanceTemplate * * Generated from protobuf field optional string source_instance_template = 332423616; */ protected $source_instance_template = null; /** - * Specifies the machine image to use to create the instance. This field is optional. It can be a full or partial URL. For example, the following are all valid URLs to a machine image: - https://www.googleapis.com/compute/v1/projects/project/global/global /machineImages/machineImage - projects/project/global/global/machineImages/machineImage - global/machineImages/machineImage + * Specifies the machine image to use to create the instance. + * This field is optional. It can be a full or partial URL. For example, the + * following are all valid URLs to a machine image: + * - https://www.googleapis.com/compute/v1/projects/project/global/global/machineImages/machineImage + * - projects/project/global/global/machineImages/machineImage + * - global/machineImages/machineImage * * Generated from protobuf field optional string source_machine_image = 21769791; */ @@ -80,11 +100,31 @@ public static function build(string $project, string $zone, \Google\Cloud\Comput * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $source_instance_template - * Specifies instance template to create the instance. This field is optional. It can be a full or partial URL. For example, the following are all valid URLs to an instance template: - https://www.googleapis.com/compute/v1/projects/project /global/instanceTemplates/instanceTemplate - projects/project/global/instanceTemplates/instanceTemplate - global/instanceTemplates/instanceTemplate + * Specifies instance template to create the instance. + * This field is optional. It can be a full or partial URL. For example, the + * following are all valid URLs to an instance template: + * - https://www.googleapis.com/compute/v1/projects/project/global/instanceTemplates/instanceTemplate + * - projects/project/global/instanceTemplates/instanceTemplate + * - global/instanceTemplates/instanceTemplate * @type string $source_machine_image - * Specifies the machine image to use to create the instance. This field is optional. It can be a full or partial URL. For example, the following are all valid URLs to a machine image: - https://www.googleapis.com/compute/v1/projects/project/global/global /machineImages/machineImage - projects/project/global/global/machineImages/machineImage - global/machineImages/machineImage + * Specifies the machine image to use to create the instance. + * This field is optional. It can be a full or partial URL. For example, the + * following are all valid URLs to a machine image: + * - https://www.googleapis.com/compute/v1/projects/project/global/global/machineImages/machineImage + * - projects/project/global/global/machineImages/machineImage + * - global/machineImages/machineImage * @type string $zone * The name of the zone for this request. * } @@ -157,7 +197,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -178,7 +228,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var @@ -193,7 +253,12 @@ public function setRequestId($var) } /** - * Specifies instance template to create the instance. This field is optional. It can be a full or partial URL. For example, the following are all valid URLs to an instance template: - https://www.googleapis.com/compute/v1/projects/project /global/instanceTemplates/instanceTemplate - projects/project/global/instanceTemplates/instanceTemplate - global/instanceTemplates/instanceTemplate + * Specifies instance template to create the instance. + * This field is optional. It can be a full or partial URL. For example, the + * following are all valid URLs to an instance template: + * - https://www.googleapis.com/compute/v1/projects/project/global/instanceTemplates/instanceTemplate + * - projects/project/global/instanceTemplates/instanceTemplate + * - global/instanceTemplates/instanceTemplate * * Generated from protobuf field optional string source_instance_template = 332423616; * @return string @@ -214,7 +279,12 @@ public function clearSourceInstanceTemplate() } /** - * Specifies instance template to create the instance. This field is optional. It can be a full or partial URL. For example, the following are all valid URLs to an instance template: - https://www.googleapis.com/compute/v1/projects/project /global/instanceTemplates/instanceTemplate - projects/project/global/instanceTemplates/instanceTemplate - global/instanceTemplates/instanceTemplate + * Specifies instance template to create the instance. + * This field is optional. It can be a full or partial URL. For example, the + * following are all valid URLs to an instance template: + * - https://www.googleapis.com/compute/v1/projects/project/global/instanceTemplates/instanceTemplate + * - projects/project/global/instanceTemplates/instanceTemplate + * - global/instanceTemplates/instanceTemplate * * Generated from protobuf field optional string source_instance_template = 332423616; * @param string $var @@ -229,7 +299,12 @@ public function setSourceInstanceTemplate($var) } /** - * Specifies the machine image to use to create the instance. This field is optional. It can be a full or partial URL. For example, the following are all valid URLs to a machine image: - https://www.googleapis.com/compute/v1/projects/project/global/global /machineImages/machineImage - projects/project/global/global/machineImages/machineImage - global/machineImages/machineImage + * Specifies the machine image to use to create the instance. + * This field is optional. It can be a full or partial URL. For example, the + * following are all valid URLs to a machine image: + * - https://www.googleapis.com/compute/v1/projects/project/global/global/machineImages/machineImage + * - projects/project/global/global/machineImages/machineImage + * - global/machineImages/machineImage * * Generated from protobuf field optional string source_machine_image = 21769791; * @return string @@ -250,7 +325,12 @@ public function clearSourceMachineImage() } /** - * Specifies the machine image to use to create the instance. This field is optional. It can be a full or partial URL. For example, the following are all valid URLs to a machine image: - https://www.googleapis.com/compute/v1/projects/project/global/global /machineImages/machineImage - projects/project/global/global/machineImages/machineImage - global/machineImages/machineImage + * Specifies the machine image to use to create the instance. + * This field is optional. It can be a full or partial URL. For example, the + * following are all valid URLs to a machine image: + * - https://www.googleapis.com/compute/v1/projects/project/global/global/machineImages/machineImage + * - projects/project/global/global/machineImages/machineImage + * - global/machineImages/machineImage * * Generated from protobuf field optional string source_machine_image = 21769791; * @param string $var diff --git a/Compute/src/V1/InsertInstanceTemplateRequest.php b/Compute/src/V1/InsertInstanceTemplateRequest.php index 03b8e3a305a4..626051c16371 100644 --- a/Compute/src/V1/InsertInstanceTemplateRequest.php +++ b/Compute/src/V1/InsertInstanceTemplateRequest.php @@ -28,7 +28,17 @@ class InsertInstanceTemplateRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -60,7 +70,17 @@ public static function build(string $project, \Google\Cloud\Compute\V1\InstanceT * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -131,7 +151,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -152,7 +182,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/InsertInstantSnapshotRequest.php b/Compute/src/V1/InsertInstantSnapshotRequest.php index e5a0ed6cf0c5..77e3562c0572 100644 --- a/Compute/src/V1/InsertInstantSnapshotRequest.php +++ b/Compute/src/V1/InsertInstantSnapshotRequest.php @@ -28,7 +28,17 @@ class InsertInstantSnapshotRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -68,7 +78,17 @@ public static function build(string $project, string $zone, \Google\Cloud\Comput * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $zone * Name of the zone for this request. * } @@ -141,7 +161,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -162,7 +192,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/InsertInterconnectAttachmentGroupRequest.php b/Compute/src/V1/InsertInterconnectAttachmentGroupRequest.php index b42db39ff736..2b8dda7efa2b 100644 --- a/Compute/src/V1/InsertInterconnectAttachmentGroupRequest.php +++ b/Compute/src/V1/InsertInterconnectAttachmentGroupRequest.php @@ -28,7 +28,18 @@ class InsertInterconnectAttachmentGroupRequest extends \Google\Protobuf\Internal */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). end_interface: MixerMutationRequestBuilder + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). + * end_interface: MixerMutationRequestBuilder * * Generated from protobuf field optional string request_id = 37109963; */ @@ -60,7 +71,18 @@ public static function build(string $project, \Google\Cloud\Compute\V1\Interconn * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). end_interface: MixerMutationRequestBuilder + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). + * end_interface: MixerMutationRequestBuilder * } */ public function __construct($data = NULL) { @@ -131,7 +153,18 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). end_interface: MixerMutationRequestBuilder + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). + * end_interface: MixerMutationRequestBuilder * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -152,7 +185,18 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). end_interface: MixerMutationRequestBuilder + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). + * end_interface: MixerMutationRequestBuilder * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/InsertInterconnectAttachmentRequest.php b/Compute/src/V1/InsertInterconnectAttachmentRequest.php index dcadc810c437..7c7ea0e65e4c 100644 --- a/Compute/src/V1/InsertInterconnectAttachmentRequest.php +++ b/Compute/src/V1/InsertInterconnectAttachmentRequest.php @@ -34,7 +34,17 @@ class InsertInterconnectAttachmentRequest extends \Google\Protobuf\Internal\Mess */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -76,7 +86,17 @@ public static function build(string $project, string $region, \Google\Cloud\Comp * @type string $region * Name of the region for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type bool $validate_only * If true, the request will not be committed. * } @@ -175,7 +195,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -196,7 +226,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/InsertInterconnectGroupRequest.php b/Compute/src/V1/InsertInterconnectGroupRequest.php index 03555960fbff..b1bf64131eaa 100644 --- a/Compute/src/V1/InsertInterconnectGroupRequest.php +++ b/Compute/src/V1/InsertInterconnectGroupRequest.php @@ -28,7 +28,18 @@ class InsertInterconnectGroupRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). end_interface: MixerMutationRequestBuilder + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). + * end_interface: MixerMutationRequestBuilder * * Generated from protobuf field optional string request_id = 37109963; */ @@ -60,7 +71,18 @@ public static function build(string $project, \Google\Cloud\Compute\V1\Interconn * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). end_interface: MixerMutationRequestBuilder + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). + * end_interface: MixerMutationRequestBuilder * } */ public function __construct($data = NULL) { @@ -131,7 +153,18 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). end_interface: MixerMutationRequestBuilder + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). + * end_interface: MixerMutationRequestBuilder * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -152,7 +185,18 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). end_interface: MixerMutationRequestBuilder + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). + * end_interface: MixerMutationRequestBuilder * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/InsertInterconnectRequest.php b/Compute/src/V1/InsertInterconnectRequest.php index caed82906bd3..90ea2a0ffba6 100644 --- a/Compute/src/V1/InsertInterconnectRequest.php +++ b/Compute/src/V1/InsertInterconnectRequest.php @@ -28,7 +28,17 @@ class InsertInterconnectRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -60,7 +70,17 @@ public static function build(string $project, \Google\Cloud\Compute\V1\Interconn * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -131,7 +151,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -152,7 +182,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/InsertLicenseRequest.php b/Compute/src/V1/InsertLicenseRequest.php index 06b12220af8c..d56422d150d5 100644 --- a/Compute/src/V1/InsertLicenseRequest.php +++ b/Compute/src/V1/InsertLicenseRequest.php @@ -28,7 +28,17 @@ class InsertLicenseRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -60,7 +70,17 @@ public static function build(string $project, \Google\Cloud\Compute\V1\License $ * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -131,7 +151,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -152,7 +182,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/InsertMachineImageRequest.php b/Compute/src/V1/InsertMachineImageRequest.php index 499f5a064dd6..018263e67417 100644 --- a/Compute/src/V1/InsertMachineImageRequest.php +++ b/Compute/src/V1/InsertMachineImageRequest.php @@ -28,7 +28,17 @@ class InsertMachineImageRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -66,7 +76,17 @@ public static function build(string $project, \Google\Cloud\Compute\V1\MachineIm * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $source_instance * Required. Source instance that is used to create the machine image from. * } @@ -139,7 +159,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -160,7 +190,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/InsertNetworkAttachmentRequest.php b/Compute/src/V1/InsertNetworkAttachmentRequest.php index 89c87f2b5a5d..164cee2c6a4b 100644 --- a/Compute/src/V1/InsertNetworkAttachmentRequest.php +++ b/Compute/src/V1/InsertNetworkAttachmentRequest.php @@ -34,7 +34,18 @@ class InsertNetworkAttachmentRequest extends \Google\Protobuf\Internal\Message */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). end_interface: MixerMutationRequestBuilder + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). + * end_interface: MixerMutationRequestBuilder * * Generated from protobuf field optional string request_id = 37109963; */ @@ -70,7 +81,18 @@ public static function build(string $project, string $region, \Google\Cloud\Comp * @type string $region * Name of the region of this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). end_interface: MixerMutationRequestBuilder + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). + * end_interface: MixerMutationRequestBuilder * } */ public function __construct($data = NULL) { @@ -167,7 +189,18 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). end_interface: MixerMutationRequestBuilder + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). + * end_interface: MixerMutationRequestBuilder * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -188,7 +221,18 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). end_interface: MixerMutationRequestBuilder + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). + * end_interface: MixerMutationRequestBuilder * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/InsertNetworkEdgeSecurityServiceRequest.php b/Compute/src/V1/InsertNetworkEdgeSecurityServiceRequest.php index 679f6d7699c9..c458e3a2849a 100644 --- a/Compute/src/V1/InsertNetworkEdgeSecurityServiceRequest.php +++ b/Compute/src/V1/InsertNetworkEdgeSecurityServiceRequest.php @@ -34,7 +34,17 @@ class InsertNetworkEdgeSecurityServiceRequest extends \Google\Protobuf\Internal\ */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -76,7 +86,17 @@ public static function build(string $project, string $region, \Google\Cloud\Comp * @type string $region * Name of the region scoping this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type bool $validate_only * If true, the request will not be committed. * } @@ -175,7 +195,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -196,7 +226,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/InsertNetworkEndpointGroupRequest.php b/Compute/src/V1/InsertNetworkEndpointGroupRequest.php index 77187015afcd..1ee0db1d5e3e 100644 --- a/Compute/src/V1/InsertNetworkEndpointGroupRequest.php +++ b/Compute/src/V1/InsertNetworkEndpointGroupRequest.php @@ -28,13 +28,25 @@ class InsertNetworkEndpointGroupRequest extends \Google\Protobuf\Internal\Messag */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ protected $request_id = null; /** - * The name of the zone where you want to create the network endpoint group. It should comply with RFC1035. + * The name of the zone where + * you want to create the network endpoint group. It should comply with + * RFC1035. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; */ @@ -42,7 +54,9 @@ class InsertNetworkEndpointGroupRequest extends \Google\Protobuf\Internal\Messag /** * @param string $project Project ID for this request. - * @param string $zone The name of the zone where you want to create the network endpoint group. It should comply with RFC1035. + * @param string $zone The name of the zone where + * you want to create the network endpoint group. It should comply with + * RFC1035. * @param \Google\Cloud\Compute\V1\NetworkEndpointGroup $networkEndpointGroupResource The body resource for this request * * @return \Google\Cloud\Compute\V1\InsertNetworkEndpointGroupRequest @@ -68,9 +82,21 @@ public static function build(string $project, string $zone, \Google\Cloud\Comput * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $zone - * The name of the zone where you want to create the network endpoint group. It should comply with RFC1035. + * The name of the zone where + * you want to create the network endpoint group. It should comply with + * RFC1035. * } */ public function __construct($data = NULL) { @@ -141,7 +167,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -162,7 +198,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var @@ -177,7 +223,9 @@ public function setRequestId($var) } /** - * The name of the zone where you want to create the network endpoint group. It should comply with RFC1035. + * The name of the zone where + * you want to create the network endpoint group. It should comply with + * RFC1035. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; * @return string @@ -188,7 +236,9 @@ public function getZone() } /** - * The name of the zone where you want to create the network endpoint group. It should comply with RFC1035. + * The name of the zone where + * you want to create the network endpoint group. It should comply with + * RFC1035. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; * @param string $var diff --git a/Compute/src/V1/InsertNetworkFirewallPolicyRequest.php b/Compute/src/V1/InsertNetworkFirewallPolicyRequest.php index aeeab510c301..c32a34ce4556 100644 --- a/Compute/src/V1/InsertNetworkFirewallPolicyRequest.php +++ b/Compute/src/V1/InsertNetworkFirewallPolicyRequest.php @@ -28,7 +28,17 @@ class InsertNetworkFirewallPolicyRequest extends \Google\Protobuf\Internal\Messa */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -60,7 +70,17 @@ public static function build(string $project, \Google\Cloud\Compute\V1\FirewallP * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -131,7 +151,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -152,7 +182,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/InsertNetworkRequest.php b/Compute/src/V1/InsertNetworkRequest.php index 7cbaeac71c04..7e4c092b96f5 100644 --- a/Compute/src/V1/InsertNetworkRequest.php +++ b/Compute/src/V1/InsertNetworkRequest.php @@ -28,7 +28,17 @@ class InsertNetworkRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -60,7 +70,17 @@ public static function build(string $project, \Google\Cloud\Compute\V1\Network $ * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -131,7 +151,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -152,7 +182,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/InsertNodeGroupRequest.php b/Compute/src/V1/InsertNodeGroupRequest.php index 378ed0221ae6..649e8c569dbc 100644 --- a/Compute/src/V1/InsertNodeGroupRequest.php +++ b/Compute/src/V1/InsertNodeGroupRequest.php @@ -34,7 +34,17 @@ class InsertNodeGroupRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -78,7 +88,17 @@ public static function build(string $project, string $zone, int $initialNodeCoun * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $zone * The name of the zone for this request. * } @@ -177,7 +197,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -198,7 +228,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/InsertNodeTemplateRequest.php b/Compute/src/V1/InsertNodeTemplateRequest.php index d0c3de98bd27..4e3ec4f7d01b 100644 --- a/Compute/src/V1/InsertNodeTemplateRequest.php +++ b/Compute/src/V1/InsertNodeTemplateRequest.php @@ -34,7 +34,17 @@ class InsertNodeTemplateRequest extends \Google\Protobuf\Internal\Message */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -70,7 +80,17 @@ public static function build(string $project, string $region, \Google\Cloud\Comp * @type string $region * The name of the region for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -167,7 +187,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -188,7 +218,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/InsertOrganizationSecurityPolicyRequest.php b/Compute/src/V1/InsertOrganizationSecurityPolicyRequest.php index a256186004e6..71b3adfde290 100644 --- a/Compute/src/V1/InsertOrganizationSecurityPolicyRequest.php +++ b/Compute/src/V1/InsertOrganizationSecurityPolicyRequest.php @@ -16,13 +16,25 @@ class InsertOrganizationSecurityPolicyRequest extends \Google\Protobuf\Internal\Message { /** - * Parent ID for this request. The ID can be either be "folders/[FOLDER_ID]" if the parent is a folder or "organizations/[ORGANIZATION_ID]" if the parent is an organization. + * Parent ID for this request. The ID can be either be "folders/[FOLDER_ID]" + * if the parent is a folder or "organizations/[ORGANIZATION_ID]" if the + * parent is an organization. * * Generated from protobuf field optional string parent_id = 459714768 [(.google.cloud.operation_request_field) = "parent_id"]; */ protected $parent_id = null; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -54,9 +66,21 @@ public static function build(\Google\Cloud\Compute\V1\SecurityPolicy $securityPo * Optional. Data for populating the Message object. * * @type string $parent_id - * Parent ID for this request. The ID can be either be "folders/[FOLDER_ID]" if the parent is a folder or "organizations/[ORGANIZATION_ID]" if the parent is an organization. + * Parent ID for this request. The ID can be either be "folders/[FOLDER_ID]" + * if the parent is a folder or "organizations/[ORGANIZATION_ID]" if the + * parent is an organization. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type \Google\Cloud\Compute\V1\SecurityPolicy $security_policy_resource * The body resource for this request * } @@ -67,7 +91,9 @@ public function __construct($data = NULL) { } /** - * Parent ID for this request. The ID can be either be "folders/[FOLDER_ID]" if the parent is a folder or "organizations/[ORGANIZATION_ID]" if the parent is an organization. + * Parent ID for this request. The ID can be either be "folders/[FOLDER_ID]" + * if the parent is a folder or "organizations/[ORGANIZATION_ID]" if the + * parent is an organization. * * Generated from protobuf field optional string parent_id = 459714768 [(.google.cloud.operation_request_field) = "parent_id"]; * @return string @@ -88,7 +114,9 @@ public function clearParentId() } /** - * Parent ID for this request. The ID can be either be "folders/[FOLDER_ID]" if the parent is a folder or "organizations/[ORGANIZATION_ID]" if the parent is an organization. + * Parent ID for this request. The ID can be either be "folders/[FOLDER_ID]" + * if the parent is a folder or "organizations/[ORGANIZATION_ID]" if the + * parent is an organization. * * Generated from protobuf field optional string parent_id = 459714768 [(.google.cloud.operation_request_field) = "parent_id"]; * @param string $var @@ -103,7 +131,17 @@ public function setParentId($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -124,7 +162,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/InsertPacketMirroringRequest.php b/Compute/src/V1/InsertPacketMirroringRequest.php index 5d2c24f8f5be..c5048e2edf05 100644 --- a/Compute/src/V1/InsertPacketMirroringRequest.php +++ b/Compute/src/V1/InsertPacketMirroringRequest.php @@ -34,7 +34,17 @@ class InsertPacketMirroringRequest extends \Google\Protobuf\Internal\Message */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -70,7 +80,17 @@ public static function build(string $project, string $region, \Google\Cloud\Comp * @type string $region * Name of the region for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -167,7 +187,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -188,7 +218,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/InsertPublicAdvertisedPrefixeRequest.php b/Compute/src/V1/InsertPublicAdvertisedPrefixeRequest.php index 0ecf803fd676..0776603898c2 100644 --- a/Compute/src/V1/InsertPublicAdvertisedPrefixeRequest.php +++ b/Compute/src/V1/InsertPublicAdvertisedPrefixeRequest.php @@ -28,7 +28,17 @@ class InsertPublicAdvertisedPrefixeRequest extends \Google\Protobuf\Internal\Mes */ protected $public_advertised_prefix_resource = null; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -60,7 +70,17 @@ public static function build(string $project, \Google\Cloud\Compute\V1\PublicAdv * @type \Google\Cloud\Compute\V1\PublicAdvertisedPrefix $public_advertised_prefix_resource * The body resource for this request * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -131,7 +151,17 @@ public function setPublicAdvertisedPrefixResource($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -152,7 +182,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/InsertPublicDelegatedPrefixeRequest.php b/Compute/src/V1/InsertPublicDelegatedPrefixeRequest.php index 44d3d3f81daf..2947c01f745e 100644 --- a/Compute/src/V1/InsertPublicDelegatedPrefixeRequest.php +++ b/Compute/src/V1/InsertPublicDelegatedPrefixeRequest.php @@ -34,7 +34,17 @@ class InsertPublicDelegatedPrefixeRequest extends \Google\Protobuf\Internal\Mess */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -70,7 +80,17 @@ public static function build(string $project, string $region, \Google\Cloud\Comp * @type string $region * Name of the region of this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -167,7 +187,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -188,7 +218,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/InsertRegionAutoscalerRequest.php b/Compute/src/V1/InsertRegionAutoscalerRequest.php index 92e30278880c..3cd76d51ca83 100644 --- a/Compute/src/V1/InsertRegionAutoscalerRequest.php +++ b/Compute/src/V1/InsertRegionAutoscalerRequest.php @@ -34,7 +34,17 @@ class InsertRegionAutoscalerRequest extends \Google\Protobuf\Internal\Message */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -70,7 +80,17 @@ public static function build(string $project, string $region, \Google\Cloud\Comp * @type string $region * Name of the region scoping this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -167,7 +187,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -188,7 +218,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/InsertRegionBackendServiceRequest.php b/Compute/src/V1/InsertRegionBackendServiceRequest.php index 5ca25c1aefa3..76cc12361930 100644 --- a/Compute/src/V1/InsertRegionBackendServiceRequest.php +++ b/Compute/src/V1/InsertRegionBackendServiceRequest.php @@ -34,7 +34,17 @@ class InsertRegionBackendServiceRequest extends \Google\Protobuf\Internal\Messag */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -70,7 +80,17 @@ public static function build(string $project, string $region, \Google\Cloud\Comp * @type string $region * Name of the region scoping this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -167,7 +187,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -188,7 +218,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/InsertRegionCommitmentRequest.php b/Compute/src/V1/InsertRegionCommitmentRequest.php index 6910998b31bd..7834d86b04d3 100644 --- a/Compute/src/V1/InsertRegionCommitmentRequest.php +++ b/Compute/src/V1/InsertRegionCommitmentRequest.php @@ -34,7 +34,17 @@ class InsertRegionCommitmentRequest extends \Google\Protobuf\Internal\Message */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -70,7 +80,17 @@ public static function build(string $project, string $region, \Google\Cloud\Comp * @type string $region * Name of the region for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -167,7 +187,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -188,7 +218,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/InsertRegionDiskRequest.php b/Compute/src/V1/InsertRegionDiskRequest.php index 057a42a1598c..29817de92bd1 100644 --- a/Compute/src/V1/InsertRegionDiskRequest.php +++ b/Compute/src/V1/InsertRegionDiskRequest.php @@ -34,7 +34,17 @@ class InsertRegionDiskRequest extends \Google\Protobuf\Internal\Message */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -76,7 +86,17 @@ public static function build(string $project, string $region, \Google\Cloud\Comp * @type string $region * Name of the region for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $source_image * Source image to restore onto a disk. This field is optional. * } @@ -175,7 +195,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -196,7 +226,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/InsertRegionHealthCheckRequest.php b/Compute/src/V1/InsertRegionHealthCheckRequest.php index 11667cdb33fc..ae97c5e56a40 100644 --- a/Compute/src/V1/InsertRegionHealthCheckRequest.php +++ b/Compute/src/V1/InsertRegionHealthCheckRequest.php @@ -34,7 +34,17 @@ class InsertRegionHealthCheckRequest extends \Google\Protobuf\Internal\Message */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -70,7 +80,17 @@ public static function build(string $project, string $region, \Google\Cloud\Comp * @type string $region * Name of the region scoping this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -167,7 +187,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -188,7 +218,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/InsertRegionHealthCheckServiceRequest.php b/Compute/src/V1/InsertRegionHealthCheckServiceRequest.php index bbdcd14c97e9..566e2236a2ed 100644 --- a/Compute/src/V1/InsertRegionHealthCheckServiceRequest.php +++ b/Compute/src/V1/InsertRegionHealthCheckServiceRequest.php @@ -34,7 +34,17 @@ class InsertRegionHealthCheckServiceRequest extends \Google\Protobuf\Internal\Me */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -70,7 +80,17 @@ public static function build(string $project, string $region, \Google\Cloud\Comp * @type string $region * Name of the region scoping this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -167,7 +187,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -188,7 +218,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/InsertRegionInstanceGroupManagerRequest.php b/Compute/src/V1/InsertRegionInstanceGroupManagerRequest.php index 96d755e7777b..53a30853773f 100644 --- a/Compute/src/V1/InsertRegionInstanceGroupManagerRequest.php +++ b/Compute/src/V1/InsertRegionInstanceGroupManagerRequest.php @@ -34,7 +34,17 @@ class InsertRegionInstanceGroupManagerRequest extends \Google\Protobuf\Internal\ */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -70,7 +80,17 @@ public static function build(string $project, string $region, \Google\Cloud\Comp * @type string $region * Name of the region scoping this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -167,7 +187,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -188,7 +218,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/InsertRegionInstanceTemplateRequest.php b/Compute/src/V1/InsertRegionInstanceTemplateRequest.php index 8aa962c77777..cb14db9aaf92 100644 --- a/Compute/src/V1/InsertRegionInstanceTemplateRequest.php +++ b/Compute/src/V1/InsertRegionInstanceTemplateRequest.php @@ -34,7 +34,17 @@ class InsertRegionInstanceTemplateRequest extends \Google\Protobuf\Internal\Mess */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -70,7 +80,17 @@ public static function build(string $project, string $region, \Google\Cloud\Comp * @type string $region * The name of the region for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -167,7 +187,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -188,7 +218,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/InsertRegionInstantSnapshotRequest.php b/Compute/src/V1/InsertRegionInstantSnapshotRequest.php index 69727e472e1f..875dccd07c43 100644 --- a/Compute/src/V1/InsertRegionInstantSnapshotRequest.php +++ b/Compute/src/V1/InsertRegionInstantSnapshotRequest.php @@ -34,7 +34,17 @@ class InsertRegionInstantSnapshotRequest extends \Google\Protobuf\Internal\Messa */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -70,7 +80,17 @@ public static function build(string $project, string $region, \Google\Cloud\Comp * @type string $region * Name of the region for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -167,7 +187,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -188,7 +218,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/InsertRegionNetworkEndpointGroupRequest.php b/Compute/src/V1/InsertRegionNetworkEndpointGroupRequest.php index c3fc459a8faa..ae4ca5905412 100644 --- a/Compute/src/V1/InsertRegionNetworkEndpointGroupRequest.php +++ b/Compute/src/V1/InsertRegionNetworkEndpointGroupRequest.php @@ -28,13 +28,25 @@ class InsertRegionNetworkEndpointGroupRequest extends \Google\Protobuf\Internal\ */ protected $project = ''; /** - * The name of the region where you want to create the network endpoint group. It should comply with RFC1035. + * The name of the region where + * you want to create the network endpoint group. It should comply with + * RFC1035. * * Generated from protobuf field string region = 138946292 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "region"]; */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -42,7 +54,9 @@ class InsertRegionNetworkEndpointGroupRequest extends \Google\Protobuf\Internal\ /** * @param string $project Project ID for this request. - * @param string $region The name of the region where you want to create the network endpoint group. It should comply with RFC1035. + * @param string $region The name of the region where + * you want to create the network endpoint group. It should comply with + * RFC1035. * @param \Google\Cloud\Compute\V1\NetworkEndpointGroup $networkEndpointGroupResource The body resource for this request * * @return \Google\Cloud\Compute\V1\InsertRegionNetworkEndpointGroupRequest @@ -68,9 +82,21 @@ public static function build(string $project, string $region, \Google\Cloud\Comp * @type string $project * Project ID for this request. * @type string $region - * The name of the region where you want to create the network endpoint group. It should comply with RFC1035. + * The name of the region where + * you want to create the network endpoint group. It should comply with + * RFC1035. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -141,7 +167,9 @@ public function setProject($var) } /** - * The name of the region where you want to create the network endpoint group. It should comply with RFC1035. + * The name of the region where + * you want to create the network endpoint group. It should comply with + * RFC1035. * * Generated from protobuf field string region = 138946292 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "region"]; * @return string @@ -152,7 +180,9 @@ public function getRegion() } /** - * The name of the region where you want to create the network endpoint group. It should comply with RFC1035. + * The name of the region where + * you want to create the network endpoint group. It should comply with + * RFC1035. * * Generated from protobuf field string region = 138946292 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "region"]; * @param string $var @@ -167,7 +197,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -188,7 +228,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/InsertRegionNetworkFirewallPolicyRequest.php b/Compute/src/V1/InsertRegionNetworkFirewallPolicyRequest.php index 0a8515cf48ea..6d28dba5d7d5 100644 --- a/Compute/src/V1/InsertRegionNetworkFirewallPolicyRequest.php +++ b/Compute/src/V1/InsertRegionNetworkFirewallPolicyRequest.php @@ -34,7 +34,17 @@ class InsertRegionNetworkFirewallPolicyRequest extends \Google\Protobuf\Internal */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID + * so that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -70,7 +80,17 @@ public static function build(string $project, string $region, \Google\Cloud\Comp * @type string $region * Name of the region scoping this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID + * so that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -167,7 +187,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID + * so that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -188,7 +218,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID + * so that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/InsertRegionNotificationEndpointRequest.php b/Compute/src/V1/InsertRegionNotificationEndpointRequest.php index 054b32eba597..982286ca9372 100644 --- a/Compute/src/V1/InsertRegionNotificationEndpointRequest.php +++ b/Compute/src/V1/InsertRegionNotificationEndpointRequest.php @@ -34,7 +34,17 @@ class InsertRegionNotificationEndpointRequest extends \Google\Protobuf\Internal\ */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -70,7 +80,17 @@ public static function build(string $project, string $region, \Google\Cloud\Comp * @type string $region * Name of the region scoping this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -167,7 +187,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -188,7 +218,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/InsertRegionSecurityPolicyRequest.php b/Compute/src/V1/InsertRegionSecurityPolicyRequest.php index 3e2c4a5e7bde..725466230e89 100644 --- a/Compute/src/V1/InsertRegionSecurityPolicyRequest.php +++ b/Compute/src/V1/InsertRegionSecurityPolicyRequest.php @@ -28,7 +28,17 @@ class InsertRegionSecurityPolicyRequest extends \Google\Protobuf\Internal\Messag */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -74,7 +84,17 @@ public static function build(string $project, string $region, \Google\Cloud\Comp * @type string $region * Name of the region scoping this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type \Google\Cloud\Compute\V1\SecurityPolicy $security_policy_resource * The body resource for this request * @type bool $validate_only @@ -139,7 +159,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -160,7 +190,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/InsertRegionSslCertificateRequest.php b/Compute/src/V1/InsertRegionSslCertificateRequest.php index e6669aff7ac3..506df8316a5c 100644 --- a/Compute/src/V1/InsertRegionSslCertificateRequest.php +++ b/Compute/src/V1/InsertRegionSslCertificateRequest.php @@ -28,7 +28,17 @@ class InsertRegionSslCertificateRequest extends \Google\Protobuf\Internal\Messag */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -68,7 +78,17 @@ public static function build(string $project, string $region, \Google\Cloud\Comp * @type string $region * Name of the region scoping this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type \Google\Cloud\Compute\V1\SslCertificate $ssl_certificate_resource * The body resource for this request * } @@ -131,7 +151,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -152,7 +182,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/InsertRegionSslPolicyRequest.php b/Compute/src/V1/InsertRegionSslPolicyRequest.php index 132f4e359c18..78ef4654b12a 100644 --- a/Compute/src/V1/InsertRegionSslPolicyRequest.php +++ b/Compute/src/V1/InsertRegionSslPolicyRequest.php @@ -28,7 +28,17 @@ class InsertRegionSslPolicyRequest extends \Google\Protobuf\Internal\Message */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -68,7 +78,17 @@ public static function build(string $project, string $region, \Google\Cloud\Comp * @type string $region * Name of the region scoping this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type \Google\Cloud\Compute\V1\SslPolicy $ssl_policy_resource * The body resource for this request * } @@ -131,7 +151,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -152,7 +182,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/InsertRegionTargetHttpProxyRequest.php b/Compute/src/V1/InsertRegionTargetHttpProxyRequest.php index 7d09efedc9fe..b86707508109 100644 --- a/Compute/src/V1/InsertRegionTargetHttpProxyRequest.php +++ b/Compute/src/V1/InsertRegionTargetHttpProxyRequest.php @@ -28,7 +28,17 @@ class InsertRegionTargetHttpProxyRequest extends \Google\Protobuf\Internal\Messa */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -68,7 +78,17 @@ public static function build(string $project, string $region, \Google\Cloud\Comp * @type string $region * Name of the region scoping this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type \Google\Cloud\Compute\V1\TargetHttpProxy $target_http_proxy_resource * The body resource for this request * } @@ -131,7 +151,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -152,7 +182,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/InsertRegionTargetHttpsProxyRequest.php b/Compute/src/V1/InsertRegionTargetHttpsProxyRequest.php index 85367f9a11c9..8685146c1a7a 100644 --- a/Compute/src/V1/InsertRegionTargetHttpsProxyRequest.php +++ b/Compute/src/V1/InsertRegionTargetHttpsProxyRequest.php @@ -28,7 +28,17 @@ class InsertRegionTargetHttpsProxyRequest extends \Google\Protobuf\Internal\Mess */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -68,7 +78,17 @@ public static function build(string $project, string $region, \Google\Cloud\Comp * @type string $region * Name of the region scoping this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type \Google\Cloud\Compute\V1\TargetHttpsProxy $target_https_proxy_resource * The body resource for this request * } @@ -131,7 +151,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -152,7 +182,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/InsertRegionTargetTcpProxyRequest.php b/Compute/src/V1/InsertRegionTargetTcpProxyRequest.php index c2fa58592c58..a2591aa1d2ed 100644 --- a/Compute/src/V1/InsertRegionTargetTcpProxyRequest.php +++ b/Compute/src/V1/InsertRegionTargetTcpProxyRequest.php @@ -28,7 +28,17 @@ class InsertRegionTargetTcpProxyRequest extends \Google\Protobuf\Internal\Messag */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -68,7 +78,17 @@ public static function build(string $project, string $region, \Google\Cloud\Comp * @type string $region * Name of the region scoping this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type \Google\Cloud\Compute\V1\TargetTcpProxy $target_tcp_proxy_resource * The body resource for this request * } @@ -131,7 +151,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -152,7 +182,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/InsertRegionUrlMapRequest.php b/Compute/src/V1/InsertRegionUrlMapRequest.php index c499bbc3afc6..e6aedcacb18d 100644 --- a/Compute/src/V1/InsertRegionUrlMapRequest.php +++ b/Compute/src/V1/InsertRegionUrlMapRequest.php @@ -28,7 +28,8 @@ class InsertRegionUrlMapRequest extends \Google\Protobuf\Internal\Message */ protected $region = ''; /** - * begin_interface: MixerMutationRequestBuilder Request ID to support idempotency. + * begin_interface: MixerMutationRequestBuilder + * Request ID to support idempotency. * * Generated from protobuf field optional string request_id = 37109963; */ @@ -68,7 +69,8 @@ public static function build(string $project, string $region, \Google\Cloud\Comp * @type string $region * Name of the region scoping this request. * @type string $request_id - * begin_interface: MixerMutationRequestBuilder Request ID to support idempotency. + * begin_interface: MixerMutationRequestBuilder + * Request ID to support idempotency. * @type \Google\Cloud\Compute\V1\UrlMap $url_map_resource * The body resource for this request * } @@ -131,7 +133,8 @@ public function setRegion($var) } /** - * begin_interface: MixerMutationRequestBuilder Request ID to support idempotency. + * begin_interface: MixerMutationRequestBuilder + * Request ID to support idempotency. * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -152,7 +155,8 @@ public function clearRequestId() } /** - * begin_interface: MixerMutationRequestBuilder Request ID to support idempotency. + * begin_interface: MixerMutationRequestBuilder + * Request ID to support idempotency. * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/InsertReservationRequest.php b/Compute/src/V1/InsertReservationRequest.php index c92403f12dd0..310ec59891e7 100644 --- a/Compute/src/V1/InsertReservationRequest.php +++ b/Compute/src/V1/InsertReservationRequest.php @@ -22,7 +22,17 @@ class InsertReservationRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -66,7 +76,17 @@ public static function build(string $project, string $zone, \Google\Cloud\Comput * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type \Google\Cloud\Compute\V1\Reservation $reservation_resource * The body resource for this request * @type string $zone @@ -105,7 +125,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -126,7 +156,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/InsertResourcePolicyRequest.php b/Compute/src/V1/InsertResourcePolicyRequest.php index aad8ec9ba28f..62f313158128 100644 --- a/Compute/src/V1/InsertResourcePolicyRequest.php +++ b/Compute/src/V1/InsertResourcePolicyRequest.php @@ -28,7 +28,17 @@ class InsertResourcePolicyRequest extends \Google\Protobuf\Internal\Message */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -68,7 +78,17 @@ public static function build(string $project, string $region, \Google\Cloud\Comp * @type string $region * Name of the region for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type \Google\Cloud\Compute\V1\ResourcePolicy $resource_policy_resource * The body resource for this request * } @@ -131,7 +151,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -152,7 +182,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/InsertRouteRequest.php b/Compute/src/V1/InsertRouteRequest.php index cfdc5cee8ab2..9bc4053cd5e3 100644 --- a/Compute/src/V1/InsertRouteRequest.php +++ b/Compute/src/V1/InsertRouteRequest.php @@ -22,7 +22,17 @@ class InsertRouteRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -58,7 +68,17 @@ public static function build(string $project, \Google\Cloud\Compute\V1\Route $ro * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type \Google\Cloud\Compute\V1\Route $route_resource * The body resource for this request * } @@ -95,7 +115,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -116,7 +146,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/InsertRouterRequest.php b/Compute/src/V1/InsertRouterRequest.php index 0a5b41360187..3c840f153306 100644 --- a/Compute/src/V1/InsertRouterRequest.php +++ b/Compute/src/V1/InsertRouterRequest.php @@ -28,7 +28,17 @@ class InsertRouterRequest extends \Google\Protobuf\Internal\Message */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -68,7 +78,17 @@ public static function build(string $project, string $region, \Google\Cloud\Comp * @type string $region * Name of the region for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type \Google\Cloud\Compute\V1\Router $router_resource * The body resource for this request * } @@ -131,7 +151,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -152,7 +182,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/InsertSecurityPolicyRequest.php b/Compute/src/V1/InsertSecurityPolicyRequest.php index 93e7e0e4044a..0836861165db 100644 --- a/Compute/src/V1/InsertSecurityPolicyRequest.php +++ b/Compute/src/V1/InsertSecurityPolicyRequest.php @@ -22,7 +22,17 @@ class InsertSecurityPolicyRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -64,7 +74,17 @@ public static function build(string $project, \Google\Cloud\Compute\V1\SecurityP * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type \Google\Cloud\Compute\V1\SecurityPolicy $security_policy_resource * The body resource for this request * @type bool $validate_only @@ -103,7 +123,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -124,7 +154,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/InsertServiceAttachmentRequest.php b/Compute/src/V1/InsertServiceAttachmentRequest.php index 65bbdca288ae..0e547fc74962 100644 --- a/Compute/src/V1/InsertServiceAttachmentRequest.php +++ b/Compute/src/V1/InsertServiceAttachmentRequest.php @@ -28,7 +28,17 @@ class InsertServiceAttachmentRequest extends \Google\Protobuf\Internal\Message */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -68,7 +78,17 @@ public static function build(string $project, string $region, \Google\Cloud\Comp * @type string $region * Name of the region of this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type \Google\Cloud\Compute\V1\ServiceAttachment $service_attachment_resource * The body resource for this request * } @@ -131,7 +151,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -152,7 +182,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/InsertSnapshotRequest.php b/Compute/src/V1/InsertSnapshotRequest.php index ffa22aee82ae..4ca1b54f3246 100644 --- a/Compute/src/V1/InsertSnapshotRequest.php +++ b/Compute/src/V1/InsertSnapshotRequest.php @@ -22,7 +22,17 @@ class InsertSnapshotRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -58,7 +68,17 @@ public static function build(string $project, \Google\Cloud\Compute\V1\Snapshot * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type \Google\Cloud\Compute\V1\Snapshot $snapshot_resource * The body resource for this request * } @@ -95,7 +115,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -116,7 +146,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/InsertSslCertificateRequest.php b/Compute/src/V1/InsertSslCertificateRequest.php index c17c7816724f..2681777cce81 100644 --- a/Compute/src/V1/InsertSslCertificateRequest.php +++ b/Compute/src/V1/InsertSslCertificateRequest.php @@ -22,7 +22,17 @@ class InsertSslCertificateRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -58,7 +68,17 @@ public static function build(string $project, \Google\Cloud\Compute\V1\SslCertif * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type \Google\Cloud\Compute\V1\SslCertificate $ssl_certificate_resource * The body resource for this request * } @@ -95,7 +115,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -116,7 +146,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/InsertSslPolicyRequest.php b/Compute/src/V1/InsertSslPolicyRequest.php index 05227ed7cfab..fb0e47d3992c 100644 --- a/Compute/src/V1/InsertSslPolicyRequest.php +++ b/Compute/src/V1/InsertSslPolicyRequest.php @@ -22,7 +22,17 @@ class InsertSslPolicyRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -58,7 +68,17 @@ public static function build(string $project, \Google\Cloud\Compute\V1\SslPolicy * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type \Google\Cloud\Compute\V1\SslPolicy $ssl_policy_resource * The body resource for this request * } @@ -95,7 +115,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -116,7 +146,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/InsertStoragePoolRequest.php b/Compute/src/V1/InsertStoragePoolRequest.php index 566d4512dcc7..3efc5b1233ab 100644 --- a/Compute/src/V1/InsertStoragePoolRequest.php +++ b/Compute/src/V1/InsertStoragePoolRequest.php @@ -22,7 +22,17 @@ class InsertStoragePoolRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -66,7 +76,17 @@ public static function build(string $project, string $zone, \Google\Cloud\Comput * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type \Google\Cloud\Compute\V1\StoragePool $storage_pool_resource * The body resource for this request * @type string $zone @@ -105,7 +125,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -126,7 +156,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/InsertSubnetworkRequest.php b/Compute/src/V1/InsertSubnetworkRequest.php index e5eb0d79460d..ebde8b20a749 100644 --- a/Compute/src/V1/InsertSubnetworkRequest.php +++ b/Compute/src/V1/InsertSubnetworkRequest.php @@ -28,7 +28,17 @@ class InsertSubnetworkRequest extends \Google\Protobuf\Internal\Message */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -68,7 +78,17 @@ public static function build(string $project, string $region, \Google\Cloud\Comp * @type string $region * Name of the region scoping this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type \Google\Cloud\Compute\V1\Subnetwork $subnetwork_resource * The body resource for this request * } @@ -131,7 +151,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -152,7 +182,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/InsertTargetGrpcProxyRequest.php b/Compute/src/V1/InsertTargetGrpcProxyRequest.php index cb5223d2f82e..1efc0c5b440a 100644 --- a/Compute/src/V1/InsertTargetGrpcProxyRequest.php +++ b/Compute/src/V1/InsertTargetGrpcProxyRequest.php @@ -22,7 +22,17 @@ class InsertTargetGrpcProxyRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -58,7 +68,17 @@ public static function build(string $project, \Google\Cloud\Compute\V1\TargetGrp * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type \Google\Cloud\Compute\V1\TargetGrpcProxy $target_grpc_proxy_resource * The body resource for this request * } @@ -95,7 +115,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -116,7 +146,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/InsertTargetHttpProxyRequest.php b/Compute/src/V1/InsertTargetHttpProxyRequest.php index a1ed3222aa5f..f880da25aedf 100644 --- a/Compute/src/V1/InsertTargetHttpProxyRequest.php +++ b/Compute/src/V1/InsertTargetHttpProxyRequest.php @@ -22,7 +22,17 @@ class InsertTargetHttpProxyRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -58,7 +68,17 @@ public static function build(string $project, \Google\Cloud\Compute\V1\TargetHtt * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type \Google\Cloud\Compute\V1\TargetHttpProxy $target_http_proxy_resource * The body resource for this request * } @@ -95,7 +115,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -116,7 +146,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/InsertTargetHttpsProxyRequest.php b/Compute/src/V1/InsertTargetHttpsProxyRequest.php index efc822a11f5b..9ca7cc0f1c4b 100644 --- a/Compute/src/V1/InsertTargetHttpsProxyRequest.php +++ b/Compute/src/V1/InsertTargetHttpsProxyRequest.php @@ -22,7 +22,17 @@ class InsertTargetHttpsProxyRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -58,7 +68,17 @@ public static function build(string $project, \Google\Cloud\Compute\V1\TargetHtt * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type \Google\Cloud\Compute\V1\TargetHttpsProxy $target_https_proxy_resource * The body resource for this request * } @@ -95,7 +115,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -116,7 +146,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/InsertTargetInstanceRequest.php b/Compute/src/V1/InsertTargetInstanceRequest.php index f01d136b3487..d36e52f0219e 100644 --- a/Compute/src/V1/InsertTargetInstanceRequest.php +++ b/Compute/src/V1/InsertTargetInstanceRequest.php @@ -22,7 +22,17 @@ class InsertTargetInstanceRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -66,7 +76,17 @@ public static function build(string $project, string $zone, \Google\Cloud\Comput * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type \Google\Cloud\Compute\V1\TargetInstance $target_instance_resource * The body resource for this request * @type string $zone @@ -105,7 +125,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -126,7 +156,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/InsertTargetPoolRequest.php b/Compute/src/V1/InsertTargetPoolRequest.php index f4f95bbcf8b3..adf7eaeb1cba 100644 --- a/Compute/src/V1/InsertTargetPoolRequest.php +++ b/Compute/src/V1/InsertTargetPoolRequest.php @@ -28,7 +28,17 @@ class InsertTargetPoolRequest extends \Google\Protobuf\Internal\Message */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -68,7 +78,17 @@ public static function build(string $project, string $region, \Google\Cloud\Comp * @type string $region * Name of the region scoping this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type \Google\Cloud\Compute\V1\TargetPool $target_pool_resource * The body resource for this request * } @@ -131,7 +151,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -152,7 +182,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/InsertTargetSslProxyRequest.php b/Compute/src/V1/InsertTargetSslProxyRequest.php index 4e9df21fe6ec..48726d611b7b 100644 --- a/Compute/src/V1/InsertTargetSslProxyRequest.php +++ b/Compute/src/V1/InsertTargetSslProxyRequest.php @@ -22,7 +22,17 @@ class InsertTargetSslProxyRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -58,7 +68,17 @@ public static function build(string $project, \Google\Cloud\Compute\V1\TargetSsl * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type \Google\Cloud\Compute\V1\TargetSslProxy $target_ssl_proxy_resource * The body resource for this request * } @@ -95,7 +115,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -116,7 +146,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/InsertTargetTcpProxyRequest.php b/Compute/src/V1/InsertTargetTcpProxyRequest.php index 92809a5655f6..d886c379bfbd 100644 --- a/Compute/src/V1/InsertTargetTcpProxyRequest.php +++ b/Compute/src/V1/InsertTargetTcpProxyRequest.php @@ -22,7 +22,17 @@ class InsertTargetTcpProxyRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -58,7 +68,17 @@ public static function build(string $project, \Google\Cloud\Compute\V1\TargetTcp * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type \Google\Cloud\Compute\V1\TargetTcpProxy $target_tcp_proxy_resource * The body resource for this request * } @@ -95,7 +115,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -116,7 +146,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/InsertTargetVpnGatewayRequest.php b/Compute/src/V1/InsertTargetVpnGatewayRequest.php index ab53a49457e1..f05fa96526b6 100644 --- a/Compute/src/V1/InsertTargetVpnGatewayRequest.php +++ b/Compute/src/V1/InsertTargetVpnGatewayRequest.php @@ -28,7 +28,17 @@ class InsertTargetVpnGatewayRequest extends \Google\Protobuf\Internal\Message */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -68,7 +78,17 @@ public static function build(string $project, string $region, \Google\Cloud\Comp * @type string $region * Name of the region for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type \Google\Cloud\Compute\V1\TargetVpnGateway $target_vpn_gateway_resource * The body resource for this request * } @@ -131,7 +151,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -152,7 +182,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/InsertUrlMapRequest.php b/Compute/src/V1/InsertUrlMapRequest.php index aceebe4b7233..801b800a5b8b 100644 --- a/Compute/src/V1/InsertUrlMapRequest.php +++ b/Compute/src/V1/InsertUrlMapRequest.php @@ -22,7 +22,17 @@ class InsertUrlMapRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -58,7 +68,17 @@ public static function build(string $project, \Google\Cloud\Compute\V1\UrlMap $u * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type \Google\Cloud\Compute\V1\UrlMap $url_map_resource * The body resource for this request * } @@ -95,7 +115,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -116,7 +146,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/InsertVpnGatewayRequest.php b/Compute/src/V1/InsertVpnGatewayRequest.php index 9dfd277f8f40..04ee5e75e320 100644 --- a/Compute/src/V1/InsertVpnGatewayRequest.php +++ b/Compute/src/V1/InsertVpnGatewayRequest.php @@ -28,7 +28,17 @@ class InsertVpnGatewayRequest extends \Google\Protobuf\Internal\Message */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -68,7 +78,17 @@ public static function build(string $project, string $region, \Google\Cloud\Comp * @type string $region * Name of the region for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type \Google\Cloud\Compute\V1\VpnGateway $vpn_gateway_resource * The body resource for this request * } @@ -131,7 +151,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -152,7 +182,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/InsertVpnTunnelRequest.php b/Compute/src/V1/InsertVpnTunnelRequest.php index 1c347aeee63f..d7212a3df572 100644 --- a/Compute/src/V1/InsertVpnTunnelRequest.php +++ b/Compute/src/V1/InsertVpnTunnelRequest.php @@ -28,7 +28,17 @@ class InsertVpnTunnelRequest extends \Google\Protobuf\Internal\Message */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -68,7 +78,17 @@ public static function build(string $project, string $region, \Google\Cloud\Comp * @type string $region * Name of the region for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type \Google\Cloud\Compute\V1\VpnTunnel $vpn_tunnel_resource * The body resource for this request * } @@ -131,7 +151,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -152,7 +182,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/InsertWireGroupRequest.php b/Compute/src/V1/InsertWireGroupRequest.php new file mode 100644 index 000000000000..2a5351fb0e90 --- /dev/null +++ b/Compute/src/V1/InsertWireGroupRequest.php @@ -0,0 +1,287 @@ +google.cloud.compute.v1.InsertWireGroupRequest + */ +class InsertWireGroupRequest extends \Google\Protobuf\Internal\Message +{ + /** + * Generated from protobuf field string cross_site_network = 108192469 [(.google.api.field_behavior) = REQUIRED]; + */ + protected $cross_site_network = ''; + /** + * Project ID for this request. + * + * Generated from protobuf field string project = 227560217 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "project"]; + */ + protected $project = ''; + /** + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). + * end_interface: MixerMutationRequestBuilder + * + * Generated from protobuf field optional string request_id = 37109963; + */ + protected $request_id = null; + /** + * [Input Only] Validate the new configuration, but don't create it. + * + * Generated from protobuf field optional bool validate_only = 242744629; + */ + protected $validate_only = null; + /** + * The body resource for this request + * + * Generated from protobuf field .google.cloud.compute.v1.WireGroup wire_group_resource = 117104840 [(.google.api.field_behavior) = REQUIRED]; + */ + protected $wire_group_resource = null; + + /** + * @param string $project Project ID for this request. + * @param string $crossSiteNetwork + * @param \Google\Cloud\Compute\V1\WireGroup $wireGroupResource The body resource for this request + * + * @return \Google\Cloud\Compute\V1\InsertWireGroupRequest + * + * @experimental + */ + public static function build(string $project, string $crossSiteNetwork, \Google\Cloud\Compute\V1\WireGroup $wireGroupResource): self + { + return (new self()) + ->setProject($project) + ->setCrossSiteNetwork($crossSiteNetwork) + ->setWireGroupResource($wireGroupResource); + } + + /** + * Constructor. + * + * @param array $data { + * Optional. Data for populating the Message object. + * + * @type string $cross_site_network + * @type string $project + * Project ID for this request. + * @type string $request_id + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). + * end_interface: MixerMutationRequestBuilder + * @type bool $validate_only + * [Input Only] Validate the new configuration, but don't create it. + * @type \Google\Cloud\Compute\V1\WireGroup $wire_group_resource + * The body resource for this request + * } + */ + public function __construct($data = NULL) { + \GPBMetadata\Google\Cloud\Compute\V1\Compute::initOnce(); + parent::__construct($data); + } + + /** + * Generated from protobuf field string cross_site_network = 108192469 [(.google.api.field_behavior) = REQUIRED]; + * @return string + */ + public function getCrossSiteNetwork() + { + return $this->cross_site_network; + } + + /** + * Generated from protobuf field string cross_site_network = 108192469 [(.google.api.field_behavior) = REQUIRED]; + * @param string $var + * @return $this + */ + public function setCrossSiteNetwork($var) + { + GPBUtil::checkString($var, True); + $this->cross_site_network = $var; + + return $this; + } + + /** + * Project ID for this request. + * + * Generated from protobuf field string project = 227560217 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "project"]; + * @return string + */ + public function getProject() + { + return $this->project; + } + + /** + * Project ID for this request. + * + * Generated from protobuf field string project = 227560217 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "project"]; + * @param string $var + * @return $this + */ + public function setProject($var) + { + GPBUtil::checkString($var, True); + $this->project = $var; + + return $this; + } + + /** + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). + * end_interface: MixerMutationRequestBuilder + * + * Generated from protobuf field optional string request_id = 37109963; + * @return string + */ + public function getRequestId() + { + return isset($this->request_id) ? $this->request_id : ''; + } + + public function hasRequestId() + { + return isset($this->request_id); + } + + public function clearRequestId() + { + unset($this->request_id); + } + + /** + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). + * end_interface: MixerMutationRequestBuilder + * + * Generated from protobuf field optional string request_id = 37109963; + * @param string $var + * @return $this + */ + public function setRequestId($var) + { + GPBUtil::checkString($var, True); + $this->request_id = $var; + + return $this; + } + + /** + * [Input Only] Validate the new configuration, but don't create it. + * + * Generated from protobuf field optional bool validate_only = 242744629; + * @return bool + */ + public function getValidateOnly() + { + return isset($this->validate_only) ? $this->validate_only : false; + } + + public function hasValidateOnly() + { + return isset($this->validate_only); + } + + public function clearValidateOnly() + { + unset($this->validate_only); + } + + /** + * [Input Only] Validate the new configuration, but don't create it. + * + * Generated from protobuf field optional bool validate_only = 242744629; + * @param bool $var + * @return $this + */ + public function setValidateOnly($var) + { + GPBUtil::checkBool($var); + $this->validate_only = $var; + + return $this; + } + + /** + * The body resource for this request + * + * Generated from protobuf field .google.cloud.compute.v1.WireGroup wire_group_resource = 117104840 [(.google.api.field_behavior) = REQUIRED]; + * @return \Google\Cloud\Compute\V1\WireGroup|null + */ + public function getWireGroupResource() + { + return $this->wire_group_resource; + } + + public function hasWireGroupResource() + { + return isset($this->wire_group_resource); + } + + public function clearWireGroupResource() + { + unset($this->wire_group_resource); + } + + /** + * The body resource for this request + * + * Generated from protobuf field .google.cloud.compute.v1.WireGroup wire_group_resource = 117104840 [(.google.api.field_behavior) = REQUIRED]; + * @param \Google\Cloud\Compute\V1\WireGroup $var + * @return $this + */ + public function setWireGroupResource($var) + { + GPBUtil::checkMessage($var, \Google\Cloud\Compute\V1\WireGroup::class); + $this->wire_group_resource = $var; + + return $this; + } + +} + diff --git a/Compute/src/V1/Instance.php b/Compute/src/V1/Instance.php index df0bf4484c5d..0a3d4b718237 100644 --- a/Compute/src/V1/Instance.php +++ b/Compute/src/V1/Instance.php @@ -9,7 +9,9 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Represents an Instance resource. An instance is a virtual machine that is hosted on Google Cloud Platform. For more information, read Virtual Machine Instances. + * Represents an Instance resource. + * An instance is a virtual machine that is hosted on Google Cloud Platform. + * For more information, readVirtual Machine Instances. * * Generated from protobuf message google.cloud.compute.v1.Instance */ @@ -22,7 +24,9 @@ class Instance extends \Google\Protobuf\Internal\Message */ protected $advanced_machine_features = null; /** - * Allows this instance to send and receive packets with non-matching destination or source IPs. This is required if you plan to use this instance to forward routes. For more information, see Enabling IP Forwarding . + * Allows this instance to send and receive packets with non-matching + * destination or source IPs. This is required if you plan to use this + * instance to forward routes. For more information, seeEnabling IP Forwarding. * * Generated from protobuf field optional bool can_ip_forward = 467731324; */ @@ -38,7 +42,7 @@ class Instance extends \Google\Protobuf\Internal\Message */ protected $cpu_platform = null; /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; */ @@ -50,13 +54,15 @@ class Instance extends \Google\Protobuf\Internal\Message */ protected $deletion_protection = null; /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; */ protected $description = null; /** - * Array of disks associated with this instance. Persistent disks must be created before you can assign them. + * Array of disks associated with this instance. Persistent disks must be + * created before you can assign them. * * Generated from protobuf field repeated .google.cloud.compute.v1.AttachedDisk disks = 95594102; */ @@ -68,7 +74,13 @@ class Instance extends \Google\Protobuf\Internal\Message */ protected $display_device = null; /** - * Specifies a fingerprint for this resource, which is essentially a hash of the instance's contents and used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update the instance. You must always provide an up-to-date fingerprint hash in order to update the instance. To see the latest fingerprint, make get() request to the instance. + * Specifies a fingerprint for this resource, which is essentially a hash of + * the instance's contents and used for optimistic locking. The + * fingerprint is initially generated by Compute Engine and changes after + * every request to modify or update the instance. You must always provide an + * up-to-date fingerprint hash in order to update the instance. + * To see the latest fingerprint, make get() request to the + * instance. * * Generated from protobuf field optional string fingerprint = 234678500; */ @@ -80,92 +92,142 @@ class Instance extends \Google\Protobuf\Internal\Message */ private $guest_accelerators; /** - * Specifies the hostname of the instance. The specified hostname must be RFC1035 compliant. If hostname is not specified, the default hostname is [INSTANCE_NAME].c.[PROJECT_ID].internal when using the global DNS, and [INSTANCE_NAME].[ZONE].c.[PROJECT_ID].internal when using zonal DNS. + * Specifies the hostname of the instance. The specified hostname must be + * RFC1035 compliant. If hostname is not specified, the default hostname is + * [INSTANCE_NAME].c.[PROJECT_ID].internal when using the global DNS, and + * [INSTANCE_NAME].[ZONE].c.[PROJECT_ID].internal when using zonal DNS. * * Generated from protobuf field optional string hostname = 237067315; */ protected $hostname = null; /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; */ protected $id = null; /** - * Encrypts suspended data for an instance with a customer-managed encryption key. If you are creating a new instance, this field will encrypt the local SSD and in-memory contents of the instance during the suspend operation. If you do not provide an encryption key when creating the instance, then the local SSD and in-memory contents will be encrypted using an automatically generated key during the suspend operation. + * Encrypts suspended data for an instance with acustomer-managed + * encryption key. + * If you are creating a new instance, this field will encrypt the local SSD + * and in-memory contents of the instance during the suspend operation. + * If you do not provide an encryption key when creating the instance, then + * the local SSD and in-memory contents will be encrypted using + * an automatically generated key during the suspend operation. * * Generated from protobuf field optional .google.cloud.compute.v1.CustomerEncryptionKey instance_encryption_key = 64741517; */ protected $instance_encryption_key = null; /** - * KeyRevocationActionType of the instance. Supported options are "STOP" and "NONE". The default value is "NONE" if it is not specified. + * KeyRevocationActionType of the instance. Supported options are "STOP" and + * "NONE". The default value is "NONE" if it is not specified. * Check the KeyRevocationActionType enum for the list of possible values. * * Generated from protobuf field optional string key_revocation_action_type = 235941474; */ protected $key_revocation_action_type = null; /** - * [Output Only] Type of the resource. Always compute#instance for instances. + * [Output Only] Type of the resource. Always compute#instance + * for instances. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * A fingerprint for this request, which is essentially a hash of the label's contents and used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels. To see the latest fingerprint, make get() request to the instance. + * A fingerprint for this request, which is essentially a hash of + * the label's contents and used for optimistic locking. The + * fingerprint is initially generated by Compute Engine and changes after + * every request to modify or update labels. You must always provide an + * up-to-date fingerprint hash in order to update or change labels. + * To see the latest fingerprint, make get() request to the + * instance. * * Generated from protobuf field optional string label_fingerprint = 178124825; */ protected $label_fingerprint = null; /** - * Labels to apply to this instance. These can be later modified by the setLabels method. + * Labels to apply to this instance. These can be later modified by + * the setLabels method. * * Generated from protobuf field map labels = 500195327; */ private $labels; /** - * [Output Only] Last start timestamp in RFC3339 text format. + * [Output Only] Last start timestamp inRFC3339 text format. * * Generated from protobuf field optional string last_start_timestamp = 443830736; */ protected $last_start_timestamp = null; /** - * [Output Only] Last stop timestamp in RFC3339 text format. + * [Output Only] Last stop timestamp inRFC3339 text format. * * Generated from protobuf field optional string last_stop_timestamp = 412823010; */ protected $last_stop_timestamp = null; /** - * [Output Only] Last suspended timestamp in RFC3339 text format. + * [Output Only] Last suspended timestamp inRFC3339 text format. * * Generated from protobuf field optional string last_suspended_timestamp = 356275337; */ protected $last_suspended_timestamp = null; /** - * Full or partial URL of the machine type resource to use for this instance, in the format: zones/zone/machineTypes/machine-type. This is provided by the client when the instance is created. For example, the following is a valid partial url to a predefined machine type: zones/us-central1-f/machineTypes/n1-standard-1 To create a custom machine type, provide a URL to a machine type in the following format, where CPUS is 1 or an even number up to 32 (2, 4, 6, ... 24, etc), and MEMORY is the total memory for this instance. Memory must be a multiple of 256 MB and must be supplied in MB (e.g. 5 GB of memory is 5120 MB): zones/zone/machineTypes/custom-CPUS-MEMORY For example: zones/us-central1-f/machineTypes/custom-4-5120 For a full list of restrictions, read the Specifications for custom machine types. + * Full or partial URL of the machine type resource to use for this instance, + * in the format:zones/zone/machineTypes/machine-type. This is provided by the client + * when the instance is created. For example, the following is a valid partial + * url to a predefined + * machine type: + * zones/us-central1-f/machineTypes/n1-standard-1 + * To create acustom + * machine type, provide a URL to a machine type in the following format, + * where CPUS is 1 or an even number up to 32 (2, + * 4, 6, ... 24, etc), and MEMORY is the total + * memory for this instance. Memory must be a multiple of 256 MB and must + * be supplied in MB (e.g. 5 GB of memory is 5120 MB): + * zones/zone/machineTypes/custom-CPUS-MEMORY + * For example: zones/us-central1-f/machineTypes/custom-4-5120 + * For a full list of restrictions, read theSpecifications + * for custom machine types. * * Generated from protobuf field optional string machine_type = 227711026; */ protected $machine_type = null; /** - * The metadata key/value pairs assigned to this instance. This includes metadata keys that were explicitly defined for the instance. + * The metadata key/value pairs assigned + * to this instance. This includes metadata keys that were explicitly defined + * for the instance. * * Generated from protobuf field optional .google.cloud.compute.v1.Metadata metadata = 86866735; */ protected $metadata = null; /** - * Specifies a minimum CPU platform for the VM instance. Applicable values are the friendly names of CPU platforms, such as minCpuPlatform: "Intel Haswell" or minCpuPlatform: "Intel Sandy Bridge". + * Specifies aminimum CPU + * platform for the VM instance. Applicable values are the friendly names + * of CPU platforms, such as minCpuPlatform: "Intel + * Haswell" or minCpuPlatform: "Intel Sandy + * Bridge". * * Generated from protobuf field optional string min_cpu_platform = 242912759; */ protected $min_cpu_platform = null; /** - * The name of the resource, provided by the client when initially creating the resource. The resource name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * The name of the resource, provided by the client when initially creating + * the resource. The resource name must be 1-63 characters long, and comply + * withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must be + * a dash, lowercase letter, or digit, except the last character, which cannot + * be a dash. * * Generated from protobuf field optional string name = 3373707; */ protected $name = null; /** - * An array of network configurations for this instance. These specify how interfaces are configured to interact with other network services, such as connecting to the internet. Multiple interfaces are supported per instance. + * An array of network configurations for this instance. These specify how + * interfaces are configured to interact with other network services, such as + * connecting to the internet. Multiple interfaces are supported + * per instance. * * Generated from protobuf field repeated .google.cloud.compute.v1.NetworkInterface network_interfaces = 52735243; */ @@ -175,13 +237,15 @@ class Instance extends \Google\Protobuf\Internal\Message */ protected $network_performance_config = null; /** - * Input only. [Input Only] Additional params passed with the request, but not persisted as part of resource payload. + * Input only. [Input Only] Additional params passed with the request, but not persisted + * as part of resource payload. * * Generated from protobuf field optional .google.cloud.compute.v1.InstanceParams params = 78313862; */ protected $params = null; /** - * The private IPv6 google access type for the VM. If not specified, use INHERIT_FROM_SUBNETWORK as default. + * The private IPv6 google access type for the VM. + * If not specified, use INHERIT_FROM_SUBNETWORK as default. * Check the PrivateIpv6GoogleAccess enum for the list of possible values. * * Generated from protobuf field optional string private_ipv6_google_access = 48277006; @@ -200,7 +264,9 @@ class Instance extends \Google\Protobuf\Internal\Message */ private $resource_policies; /** - * [Output Only] Specifies values set for instance attributes as compared to the values requested by user in the corresponding input only field. + * [Output Only] Specifies values set for instance attributes as + * compared to the values requested by user in the corresponding input only + * field. * * Generated from protobuf field optional .google.cloud.compute.v1.ResourceStatus resource_status = 249429315; */ @@ -230,7 +296,12 @@ class Instance extends \Google\Protobuf\Internal\Message */ protected $self_link = null; /** - * A list of service accounts, with their specified scopes, authorized for this instance. Only one service account per VM instance is supported. Service accounts generate access tokens that can be accessed through the metadata server and used to authenticate applications on the instance. See Service Accounts for more information. + * A list of service accounts, with their specified scopes, authorized for + * this instance. Only one service account per VM instance is supported. + * Service accounts generate access tokens that can be accessed + * through the metadata server and used to authenticate applications on the + * instance. SeeService Accounts + * for more information. * * Generated from protobuf field repeated .google.cloud.compute.v1.ServiceAccount service_accounts = 277537328; */ @@ -250,19 +321,24 @@ class Instance extends \Google\Protobuf\Internal\Message */ protected $source_machine_image = null; /** - * Source machine image encryption key when creating an instance from a machine image. + * Source machine image encryption key when creating an instance from a + * machine image. * * Generated from protobuf field optional .google.cloud.compute.v1.CustomerEncryptionKey source_machine_image_encryption_key = 192839075; */ protected $source_machine_image_encryption_key = null; /** - * [Output Only] Whether a VM has been restricted for start because Compute Engine has detected suspicious activity. + * [Output Only] Whether a VM has been restricted for start because Compute + * Engine has detected suspicious activity. * * Generated from protobuf field optional bool start_restricted = 123693144; */ protected $start_restricted = null; /** - * [Output Only] The status of the instance. One of the following values: PROVISIONING, STAGING, RUNNING, STOPPING, SUSPENDING, SUSPENDED, REPAIRING, and TERMINATED. For more information about the status of the instance, see Instance life cycle. + * [Output Only] The status of the instance. One of the + * following values: PROVISIONING, STAGING,RUNNING, STOPPING, SUSPENDING,SUSPENDED, REPAIRING, andTERMINATED. For more information about the status of the + * instance, see + * Instance life cycle. * Check the Status enum for the list of possible values. * * Generated from protobuf field optional string status = 181260274; @@ -275,13 +351,19 @@ class Instance extends \Google\Protobuf\Internal\Message */ protected $status_message = null; /** - * Tags to apply to this instance. Tags are used to identify valid sources or targets for network firewalls and are specified by the client during instance creation. The tags can be later modified by the setTags method. Each tag within the list must comply with RFC1035. Multiple tags can be specified via the 'tags.items' field. + * Tags to apply to this instance. Tags are used to identify valid + * sources or targets for network firewalls and are specified by the client + * during instance creation. The tags can be later modified by the setTags + * method. Each tag within the list must comply withRFC1035. + * Multiple tags can be specified via the 'tags.items' field. * * Generated from protobuf field optional .google.cloud.compute.v1.Tags tags = 3552281; */ protected $tags = null; /** - * [Output Only] URL of the zone where the instance resides. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * [Output Only] URL of the zone where the instance resides. + * You must specify this field as part of the HTTP request URL. It is + * not settable as a field in the request body. * * Generated from protobuf field optional string zone = 3744684; */ @@ -296,67 +378,131 @@ class Instance extends \Google\Protobuf\Internal\Message * @type \Google\Cloud\Compute\V1\AdvancedMachineFeatures $advanced_machine_features * Controls for advanced machine-related behavior features. * @type bool $can_ip_forward - * Allows this instance to send and receive packets with non-matching destination or source IPs. This is required if you plan to use this instance to forward routes. For more information, see Enabling IP Forwarding . + * Allows this instance to send and receive packets with non-matching + * destination or source IPs. This is required if you plan to use this + * instance to forward routes. For more information, seeEnabling IP Forwarding. * @type \Google\Cloud\Compute\V1\ConfidentialInstanceConfig $confidential_instance_config * @type string $cpu_platform * [Output Only] The CPU platform used by this instance. * @type string $creation_timestamp - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 text format. * @type bool $deletion_protection * Whether the resource should be protected against deletion. * @type string $description - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * @type array<\Google\Cloud\Compute\V1\AttachedDisk>|\Google\Protobuf\Internal\RepeatedField $disks - * Array of disks associated with this instance. Persistent disks must be created before you can assign them. + * Array of disks associated with this instance. Persistent disks must be + * created before you can assign them. * @type \Google\Cloud\Compute\V1\DisplayDevice $display_device * Enables display device for the instance. * @type string $fingerprint - * Specifies a fingerprint for this resource, which is essentially a hash of the instance's contents and used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update the instance. You must always provide an up-to-date fingerprint hash in order to update the instance. To see the latest fingerprint, make get() request to the instance. + * Specifies a fingerprint for this resource, which is essentially a hash of + * the instance's contents and used for optimistic locking. The + * fingerprint is initially generated by Compute Engine and changes after + * every request to modify or update the instance. You must always provide an + * up-to-date fingerprint hash in order to update the instance. + * To see the latest fingerprint, make get() request to the + * instance. * @type array<\Google\Cloud\Compute\V1\AcceleratorConfig>|\Google\Protobuf\Internal\RepeatedField $guest_accelerators * A list of the type and count of accelerator cards attached to the instance. * @type string $hostname - * Specifies the hostname of the instance. The specified hostname must be RFC1035 compliant. If hostname is not specified, the default hostname is [INSTANCE_NAME].c.[PROJECT_ID].internal when using the global DNS, and [INSTANCE_NAME].[ZONE].c.[PROJECT_ID].internal when using zonal DNS. + * Specifies the hostname of the instance. The specified hostname must be + * RFC1035 compliant. If hostname is not specified, the default hostname is + * [INSTANCE_NAME].c.[PROJECT_ID].internal when using the global DNS, and + * [INSTANCE_NAME].[ZONE].c.[PROJECT_ID].internal when using zonal DNS. * @type int|string $id - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * @type \Google\Cloud\Compute\V1\CustomerEncryptionKey $instance_encryption_key - * Encrypts suspended data for an instance with a customer-managed encryption key. If you are creating a new instance, this field will encrypt the local SSD and in-memory contents of the instance during the suspend operation. If you do not provide an encryption key when creating the instance, then the local SSD and in-memory contents will be encrypted using an automatically generated key during the suspend operation. + * Encrypts suspended data for an instance with acustomer-managed + * encryption key. + * If you are creating a new instance, this field will encrypt the local SSD + * and in-memory contents of the instance during the suspend operation. + * If you do not provide an encryption key when creating the instance, then + * the local SSD and in-memory contents will be encrypted using + * an automatically generated key during the suspend operation. * @type string $key_revocation_action_type - * KeyRevocationActionType of the instance. Supported options are "STOP" and "NONE". The default value is "NONE" if it is not specified. + * KeyRevocationActionType of the instance. Supported options are "STOP" and + * "NONE". The default value is "NONE" if it is not specified. * Check the KeyRevocationActionType enum for the list of possible values. * @type string $kind - * [Output Only] Type of the resource. Always compute#instance for instances. + * [Output Only] Type of the resource. Always compute#instance + * for instances. * @type string $label_fingerprint - * A fingerprint for this request, which is essentially a hash of the label's contents and used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels. To see the latest fingerprint, make get() request to the instance. + * A fingerprint for this request, which is essentially a hash of + * the label's contents and used for optimistic locking. The + * fingerprint is initially generated by Compute Engine and changes after + * every request to modify or update labels. You must always provide an + * up-to-date fingerprint hash in order to update or change labels. + * To see the latest fingerprint, make get() request to the + * instance. * @type array|\Google\Protobuf\Internal\MapField $labels - * Labels to apply to this instance. These can be later modified by the setLabels method. + * Labels to apply to this instance. These can be later modified by + * the setLabels method. * @type string $last_start_timestamp - * [Output Only] Last start timestamp in RFC3339 text format. + * [Output Only] Last start timestamp inRFC3339 text format. * @type string $last_stop_timestamp - * [Output Only] Last stop timestamp in RFC3339 text format. + * [Output Only] Last stop timestamp inRFC3339 text format. * @type string $last_suspended_timestamp - * [Output Only] Last suspended timestamp in RFC3339 text format. + * [Output Only] Last suspended timestamp inRFC3339 text format. * @type string $machine_type - * Full or partial URL of the machine type resource to use for this instance, in the format: zones/zone/machineTypes/machine-type. This is provided by the client when the instance is created. For example, the following is a valid partial url to a predefined machine type: zones/us-central1-f/machineTypes/n1-standard-1 To create a custom machine type, provide a URL to a machine type in the following format, where CPUS is 1 or an even number up to 32 (2, 4, 6, ... 24, etc), and MEMORY is the total memory for this instance. Memory must be a multiple of 256 MB and must be supplied in MB (e.g. 5 GB of memory is 5120 MB): zones/zone/machineTypes/custom-CPUS-MEMORY For example: zones/us-central1-f/machineTypes/custom-4-5120 For a full list of restrictions, read the Specifications for custom machine types. + * Full or partial URL of the machine type resource to use for this instance, + * in the format:zones/zone/machineTypes/machine-type. This is provided by the client + * when the instance is created. For example, the following is a valid partial + * url to a predefined + * machine type: + * zones/us-central1-f/machineTypes/n1-standard-1 + * To create acustom + * machine type, provide a URL to a machine type in the following format, + * where CPUS is 1 or an even number up to 32 (2, + * 4, 6, ... 24, etc), and MEMORY is the total + * memory for this instance. Memory must be a multiple of 256 MB and must + * be supplied in MB (e.g. 5 GB of memory is 5120 MB): + * zones/zone/machineTypes/custom-CPUS-MEMORY + * For example: zones/us-central1-f/machineTypes/custom-4-5120 + * For a full list of restrictions, read theSpecifications + * for custom machine types. * @type \Google\Cloud\Compute\V1\Metadata $metadata - * The metadata key/value pairs assigned to this instance. This includes metadata keys that were explicitly defined for the instance. + * The metadata key/value pairs assigned + * to this instance. This includes metadata keys that were explicitly defined + * for the instance. * @type string $min_cpu_platform - * Specifies a minimum CPU platform for the VM instance. Applicable values are the friendly names of CPU platforms, such as minCpuPlatform: "Intel Haswell" or minCpuPlatform: "Intel Sandy Bridge". + * Specifies aminimum CPU + * platform for the VM instance. Applicable values are the friendly names + * of CPU platforms, such as minCpuPlatform: "Intel + * Haswell" or minCpuPlatform: "Intel Sandy + * Bridge". * @type string $name - * The name of the resource, provided by the client when initially creating the resource. The resource name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * The name of the resource, provided by the client when initially creating + * the resource. The resource name must be 1-63 characters long, and comply + * withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must be + * a dash, lowercase letter, or digit, except the last character, which cannot + * be a dash. * @type array<\Google\Cloud\Compute\V1\NetworkInterface>|\Google\Protobuf\Internal\RepeatedField $network_interfaces - * An array of network configurations for this instance. These specify how interfaces are configured to interact with other network services, such as connecting to the internet. Multiple interfaces are supported per instance. + * An array of network configurations for this instance. These specify how + * interfaces are configured to interact with other network services, such as + * connecting to the internet. Multiple interfaces are supported + * per instance. * @type \Google\Cloud\Compute\V1\NetworkPerformanceConfig $network_performance_config * @type \Google\Cloud\Compute\V1\InstanceParams $params - * Input only. [Input Only] Additional params passed with the request, but not persisted as part of resource payload. + * Input only. [Input Only] Additional params passed with the request, but not persisted + * as part of resource payload. * @type string $private_ipv6_google_access - * The private IPv6 google access type for the VM. If not specified, use INHERIT_FROM_SUBNETWORK as default. + * The private IPv6 google access type for the VM. + * If not specified, use INHERIT_FROM_SUBNETWORK as default. * Check the PrivateIpv6GoogleAccess enum for the list of possible values. * @type \Google\Cloud\Compute\V1\ReservationAffinity $reservation_affinity * Specifies the reservations that this instance can consume from. * @type array|\Google\Protobuf\Internal\RepeatedField $resource_policies * Resource policies applied to this instance. * @type \Google\Cloud\Compute\V1\ResourceStatus $resource_status - * [Output Only] Specifies values set for instance attributes as compared to the values requested by user in the corresponding input only field. + * [Output Only] Specifies values set for instance attributes as + * compared to the values requested by user in the corresponding input only + * field. * @type bool $satisfies_pzi * [Output Only] Reserved for future use. * @type bool $satisfies_pzs @@ -366,24 +512,40 @@ class Instance extends \Google\Protobuf\Internal\Message * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type array<\Google\Cloud\Compute\V1\ServiceAccount>|\Google\Protobuf\Internal\RepeatedField $service_accounts - * A list of service accounts, with their specified scopes, authorized for this instance. Only one service account per VM instance is supported. Service accounts generate access tokens that can be accessed through the metadata server and used to authenticate applications on the instance. See Service Accounts for more information. + * A list of service accounts, with their specified scopes, authorized for + * this instance. Only one service account per VM instance is supported. + * Service accounts generate access tokens that can be accessed + * through the metadata server and used to authenticate applications on the + * instance. SeeService Accounts + * for more information. * @type \Google\Cloud\Compute\V1\ShieldedInstanceConfig $shielded_instance_config * @type \Google\Cloud\Compute\V1\ShieldedInstanceIntegrityPolicy $shielded_instance_integrity_policy * @type string $source_machine_image * Source machine image * @type \Google\Cloud\Compute\V1\CustomerEncryptionKey $source_machine_image_encryption_key - * Source machine image encryption key when creating an instance from a machine image. + * Source machine image encryption key when creating an instance from a + * machine image. * @type bool $start_restricted - * [Output Only] Whether a VM has been restricted for start because Compute Engine has detected suspicious activity. + * [Output Only] Whether a VM has been restricted for start because Compute + * Engine has detected suspicious activity. * @type string $status - * [Output Only] The status of the instance. One of the following values: PROVISIONING, STAGING, RUNNING, STOPPING, SUSPENDING, SUSPENDED, REPAIRING, and TERMINATED. For more information about the status of the instance, see Instance life cycle. + * [Output Only] The status of the instance. One of the + * following values: PROVISIONING, STAGING,RUNNING, STOPPING, SUSPENDING,SUSPENDED, REPAIRING, andTERMINATED. For more information about the status of the + * instance, see + * Instance life cycle. * Check the Status enum for the list of possible values. * @type string $status_message * [Output Only] An optional, human-readable explanation of the status. * @type \Google\Cloud\Compute\V1\Tags $tags - * Tags to apply to this instance. Tags are used to identify valid sources or targets for network firewalls and are specified by the client during instance creation. The tags can be later modified by the setTags method. Each tag within the list must comply with RFC1035. Multiple tags can be specified via the 'tags.items' field. + * Tags to apply to this instance. Tags are used to identify valid + * sources or targets for network firewalls and are specified by the client + * during instance creation. The tags can be later modified by the setTags + * method. Each tag within the list must comply withRFC1035. + * Multiple tags can be specified via the 'tags.items' field. * @type string $zone - * [Output Only] URL of the zone where the instance resides. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * [Output Only] URL of the zone where the instance resides. + * You must specify this field as part of the HTTP request URL. It is + * not settable as a field in the request body. * } */ public function __construct($data = NULL) { @@ -428,7 +590,9 @@ public function setAdvancedMachineFeatures($var) } /** - * Allows this instance to send and receive packets with non-matching destination or source IPs. This is required if you plan to use this instance to forward routes. For more information, see Enabling IP Forwarding . + * Allows this instance to send and receive packets with non-matching + * destination or source IPs. This is required if you plan to use this + * instance to forward routes. For more information, seeEnabling IP Forwarding. * * Generated from protobuf field optional bool can_ip_forward = 467731324; * @return bool @@ -449,7 +613,9 @@ public function clearCanIpForward() } /** - * Allows this instance to send and receive packets with non-matching destination or source IPs. This is required if you plan to use this instance to forward routes. For more information, see Enabling IP Forwarding . + * Allows this instance to send and receive packets with non-matching + * destination or source IPs. This is required if you plan to use this + * instance to forward routes. For more information, seeEnabling IP Forwarding. * * Generated from protobuf field optional bool can_ip_forward = 467731324; * @param bool $var @@ -532,7 +698,7 @@ public function setCpuPlatform($var) } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @return string @@ -553,7 +719,7 @@ public function clearCreationTimestamp() } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @param string $var @@ -604,7 +770,8 @@ public function setDeletionProtection($var) } /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @return string @@ -625,7 +792,8 @@ public function clearDescription() } /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @param string $var @@ -640,7 +808,8 @@ public function setDescription($var) } /** - * Array of disks associated with this instance. Persistent disks must be created before you can assign them. + * Array of disks associated with this instance. Persistent disks must be + * created before you can assign them. * * Generated from protobuf field repeated .google.cloud.compute.v1.AttachedDisk disks = 95594102; * @return \Google\Protobuf\Internal\RepeatedField @@ -651,7 +820,8 @@ public function getDisks() } /** - * Array of disks associated with this instance. Persistent disks must be created before you can assign them. + * Array of disks associated with this instance. Persistent disks must be + * created before you can assign them. * * Generated from protobuf field repeated .google.cloud.compute.v1.AttachedDisk disks = 95594102; * @param array<\Google\Cloud\Compute\V1\AttachedDisk>|\Google\Protobuf\Internal\RepeatedField $var @@ -702,7 +872,13 @@ public function setDisplayDevice($var) } /** - * Specifies a fingerprint for this resource, which is essentially a hash of the instance's contents and used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update the instance. You must always provide an up-to-date fingerprint hash in order to update the instance. To see the latest fingerprint, make get() request to the instance. + * Specifies a fingerprint for this resource, which is essentially a hash of + * the instance's contents and used for optimistic locking. The + * fingerprint is initially generated by Compute Engine and changes after + * every request to modify or update the instance. You must always provide an + * up-to-date fingerprint hash in order to update the instance. + * To see the latest fingerprint, make get() request to the + * instance. * * Generated from protobuf field optional string fingerprint = 234678500; * @return string @@ -723,7 +899,13 @@ public function clearFingerprint() } /** - * Specifies a fingerprint for this resource, which is essentially a hash of the instance's contents and used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update the instance. You must always provide an up-to-date fingerprint hash in order to update the instance. To see the latest fingerprint, make get() request to the instance. + * Specifies a fingerprint for this resource, which is essentially a hash of + * the instance's contents and used for optimistic locking. The + * fingerprint is initially generated by Compute Engine and changes after + * every request to modify or update the instance. You must always provide an + * up-to-date fingerprint hash in order to update the instance. + * To see the latest fingerprint, make get() request to the + * instance. * * Generated from protobuf field optional string fingerprint = 234678500; * @param string $var @@ -764,7 +946,10 @@ public function setGuestAccelerators($var) } /** - * Specifies the hostname of the instance. The specified hostname must be RFC1035 compliant. If hostname is not specified, the default hostname is [INSTANCE_NAME].c.[PROJECT_ID].internal when using the global DNS, and [INSTANCE_NAME].[ZONE].c.[PROJECT_ID].internal when using zonal DNS. + * Specifies the hostname of the instance. The specified hostname must be + * RFC1035 compliant. If hostname is not specified, the default hostname is + * [INSTANCE_NAME].c.[PROJECT_ID].internal when using the global DNS, and + * [INSTANCE_NAME].[ZONE].c.[PROJECT_ID].internal when using zonal DNS. * * Generated from protobuf field optional string hostname = 237067315; * @return string @@ -785,7 +970,10 @@ public function clearHostname() } /** - * Specifies the hostname of the instance. The specified hostname must be RFC1035 compliant. If hostname is not specified, the default hostname is [INSTANCE_NAME].c.[PROJECT_ID].internal when using the global DNS, and [INSTANCE_NAME].[ZONE].c.[PROJECT_ID].internal when using zonal DNS. + * Specifies the hostname of the instance. The specified hostname must be + * RFC1035 compliant. If hostname is not specified, the default hostname is + * [INSTANCE_NAME].c.[PROJECT_ID].internal when using the global DNS, and + * [INSTANCE_NAME].[ZONE].c.[PROJECT_ID].internal when using zonal DNS. * * Generated from protobuf field optional string hostname = 237067315; * @param string $var @@ -800,7 +988,8 @@ public function setHostname($var) } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @return int|string @@ -821,7 +1010,8 @@ public function clearId() } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @param int|string $var @@ -836,7 +1026,13 @@ public function setId($var) } /** - * Encrypts suspended data for an instance with a customer-managed encryption key. If you are creating a new instance, this field will encrypt the local SSD and in-memory contents of the instance during the suspend operation. If you do not provide an encryption key when creating the instance, then the local SSD and in-memory contents will be encrypted using an automatically generated key during the suspend operation. + * Encrypts suspended data for an instance with acustomer-managed + * encryption key. + * If you are creating a new instance, this field will encrypt the local SSD + * and in-memory contents of the instance during the suspend operation. + * If you do not provide an encryption key when creating the instance, then + * the local SSD and in-memory contents will be encrypted using + * an automatically generated key during the suspend operation. * * Generated from protobuf field optional .google.cloud.compute.v1.CustomerEncryptionKey instance_encryption_key = 64741517; * @return \Google\Cloud\Compute\V1\CustomerEncryptionKey|null @@ -857,7 +1053,13 @@ public function clearInstanceEncryptionKey() } /** - * Encrypts suspended data for an instance with a customer-managed encryption key. If you are creating a new instance, this field will encrypt the local SSD and in-memory contents of the instance during the suspend operation. If you do not provide an encryption key when creating the instance, then the local SSD and in-memory contents will be encrypted using an automatically generated key during the suspend operation. + * Encrypts suspended data for an instance with acustomer-managed + * encryption key. + * If you are creating a new instance, this field will encrypt the local SSD + * and in-memory contents of the instance during the suspend operation. + * If you do not provide an encryption key when creating the instance, then + * the local SSD and in-memory contents will be encrypted using + * an automatically generated key during the suspend operation. * * Generated from protobuf field optional .google.cloud.compute.v1.CustomerEncryptionKey instance_encryption_key = 64741517; * @param \Google\Cloud\Compute\V1\CustomerEncryptionKey $var @@ -872,7 +1074,8 @@ public function setInstanceEncryptionKey($var) } /** - * KeyRevocationActionType of the instance. Supported options are "STOP" and "NONE". The default value is "NONE" if it is not specified. + * KeyRevocationActionType of the instance. Supported options are "STOP" and + * "NONE". The default value is "NONE" if it is not specified. * Check the KeyRevocationActionType enum for the list of possible values. * * Generated from protobuf field optional string key_revocation_action_type = 235941474; @@ -894,7 +1097,8 @@ public function clearKeyRevocationActionType() } /** - * KeyRevocationActionType of the instance. Supported options are "STOP" and "NONE". The default value is "NONE" if it is not specified. + * KeyRevocationActionType of the instance. Supported options are "STOP" and + * "NONE". The default value is "NONE" if it is not specified. * Check the KeyRevocationActionType enum for the list of possible values. * * Generated from protobuf field optional string key_revocation_action_type = 235941474; @@ -910,7 +1114,8 @@ public function setKeyRevocationActionType($var) } /** - * [Output Only] Type of the resource. Always compute#instance for instances. + * [Output Only] Type of the resource. Always compute#instance + * for instances. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -931,7 +1136,8 @@ public function clearKind() } /** - * [Output Only] Type of the resource. Always compute#instance for instances. + * [Output Only] Type of the resource. Always compute#instance + * for instances. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -946,7 +1152,13 @@ public function setKind($var) } /** - * A fingerprint for this request, which is essentially a hash of the label's contents and used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels. To see the latest fingerprint, make get() request to the instance. + * A fingerprint for this request, which is essentially a hash of + * the label's contents and used for optimistic locking. The + * fingerprint is initially generated by Compute Engine and changes after + * every request to modify or update labels. You must always provide an + * up-to-date fingerprint hash in order to update or change labels. + * To see the latest fingerprint, make get() request to the + * instance. * * Generated from protobuf field optional string label_fingerprint = 178124825; * @return string @@ -967,7 +1179,13 @@ public function clearLabelFingerprint() } /** - * A fingerprint for this request, which is essentially a hash of the label's contents and used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels. To see the latest fingerprint, make get() request to the instance. + * A fingerprint for this request, which is essentially a hash of + * the label's contents and used for optimistic locking. The + * fingerprint is initially generated by Compute Engine and changes after + * every request to modify or update labels. You must always provide an + * up-to-date fingerprint hash in order to update or change labels. + * To see the latest fingerprint, make get() request to the + * instance. * * Generated from protobuf field optional string label_fingerprint = 178124825; * @param string $var @@ -982,7 +1200,8 @@ public function setLabelFingerprint($var) } /** - * Labels to apply to this instance. These can be later modified by the setLabels method. + * Labels to apply to this instance. These can be later modified by + * the setLabels method. * * Generated from protobuf field map labels = 500195327; * @return \Google\Protobuf\Internal\MapField @@ -993,7 +1212,8 @@ public function getLabels() } /** - * Labels to apply to this instance. These can be later modified by the setLabels method. + * Labels to apply to this instance. These can be later modified by + * the setLabels method. * * Generated from protobuf field map labels = 500195327; * @param array|\Google\Protobuf\Internal\MapField $var @@ -1008,7 +1228,7 @@ public function setLabels($var) } /** - * [Output Only] Last start timestamp in RFC3339 text format. + * [Output Only] Last start timestamp inRFC3339 text format. * * Generated from protobuf field optional string last_start_timestamp = 443830736; * @return string @@ -1029,7 +1249,7 @@ public function clearLastStartTimestamp() } /** - * [Output Only] Last start timestamp in RFC3339 text format. + * [Output Only] Last start timestamp inRFC3339 text format. * * Generated from protobuf field optional string last_start_timestamp = 443830736; * @param string $var @@ -1044,7 +1264,7 @@ public function setLastStartTimestamp($var) } /** - * [Output Only] Last stop timestamp in RFC3339 text format. + * [Output Only] Last stop timestamp inRFC3339 text format. * * Generated from protobuf field optional string last_stop_timestamp = 412823010; * @return string @@ -1065,7 +1285,7 @@ public function clearLastStopTimestamp() } /** - * [Output Only] Last stop timestamp in RFC3339 text format. + * [Output Only] Last stop timestamp inRFC3339 text format. * * Generated from protobuf field optional string last_stop_timestamp = 412823010; * @param string $var @@ -1080,7 +1300,7 @@ public function setLastStopTimestamp($var) } /** - * [Output Only] Last suspended timestamp in RFC3339 text format. + * [Output Only] Last suspended timestamp inRFC3339 text format. * * Generated from protobuf field optional string last_suspended_timestamp = 356275337; * @return string @@ -1101,7 +1321,7 @@ public function clearLastSuspendedTimestamp() } /** - * [Output Only] Last suspended timestamp in RFC3339 text format. + * [Output Only] Last suspended timestamp inRFC3339 text format. * * Generated from protobuf field optional string last_suspended_timestamp = 356275337; * @param string $var @@ -1116,7 +1336,22 @@ public function setLastSuspendedTimestamp($var) } /** - * Full or partial URL of the machine type resource to use for this instance, in the format: zones/zone/machineTypes/machine-type. This is provided by the client when the instance is created. For example, the following is a valid partial url to a predefined machine type: zones/us-central1-f/machineTypes/n1-standard-1 To create a custom machine type, provide a URL to a machine type in the following format, where CPUS is 1 or an even number up to 32 (2, 4, 6, ... 24, etc), and MEMORY is the total memory for this instance. Memory must be a multiple of 256 MB and must be supplied in MB (e.g. 5 GB of memory is 5120 MB): zones/zone/machineTypes/custom-CPUS-MEMORY For example: zones/us-central1-f/machineTypes/custom-4-5120 For a full list of restrictions, read the Specifications for custom machine types. + * Full or partial URL of the machine type resource to use for this instance, + * in the format:zones/zone/machineTypes/machine-type. This is provided by the client + * when the instance is created. For example, the following is a valid partial + * url to a predefined + * machine type: + * zones/us-central1-f/machineTypes/n1-standard-1 + * To create acustom + * machine type, provide a URL to a machine type in the following format, + * where CPUS is 1 or an even number up to 32 (2, + * 4, 6, ... 24, etc), and MEMORY is the total + * memory for this instance. Memory must be a multiple of 256 MB and must + * be supplied in MB (e.g. 5 GB of memory is 5120 MB): + * zones/zone/machineTypes/custom-CPUS-MEMORY + * For example: zones/us-central1-f/machineTypes/custom-4-5120 + * For a full list of restrictions, read theSpecifications + * for custom machine types. * * Generated from protobuf field optional string machine_type = 227711026; * @return string @@ -1137,7 +1372,22 @@ public function clearMachineType() } /** - * Full or partial URL of the machine type resource to use for this instance, in the format: zones/zone/machineTypes/machine-type. This is provided by the client when the instance is created. For example, the following is a valid partial url to a predefined machine type: zones/us-central1-f/machineTypes/n1-standard-1 To create a custom machine type, provide a URL to a machine type in the following format, where CPUS is 1 or an even number up to 32 (2, 4, 6, ... 24, etc), and MEMORY is the total memory for this instance. Memory must be a multiple of 256 MB and must be supplied in MB (e.g. 5 GB of memory is 5120 MB): zones/zone/machineTypes/custom-CPUS-MEMORY For example: zones/us-central1-f/machineTypes/custom-4-5120 For a full list of restrictions, read the Specifications for custom machine types. + * Full or partial URL of the machine type resource to use for this instance, + * in the format:zones/zone/machineTypes/machine-type. This is provided by the client + * when the instance is created. For example, the following is a valid partial + * url to a predefined + * machine type: + * zones/us-central1-f/machineTypes/n1-standard-1 + * To create acustom + * machine type, provide a URL to a machine type in the following format, + * where CPUS is 1 or an even number up to 32 (2, + * 4, 6, ... 24, etc), and MEMORY is the total + * memory for this instance. Memory must be a multiple of 256 MB and must + * be supplied in MB (e.g. 5 GB of memory is 5120 MB): + * zones/zone/machineTypes/custom-CPUS-MEMORY + * For example: zones/us-central1-f/machineTypes/custom-4-5120 + * For a full list of restrictions, read theSpecifications + * for custom machine types. * * Generated from protobuf field optional string machine_type = 227711026; * @param string $var @@ -1152,7 +1402,9 @@ public function setMachineType($var) } /** - * The metadata key/value pairs assigned to this instance. This includes metadata keys that were explicitly defined for the instance. + * The metadata key/value pairs assigned + * to this instance. This includes metadata keys that were explicitly defined + * for the instance. * * Generated from protobuf field optional .google.cloud.compute.v1.Metadata metadata = 86866735; * @return \Google\Cloud\Compute\V1\Metadata|null @@ -1173,7 +1425,9 @@ public function clearMetadata() } /** - * The metadata key/value pairs assigned to this instance. This includes metadata keys that were explicitly defined for the instance. + * The metadata key/value pairs assigned + * to this instance. This includes metadata keys that were explicitly defined + * for the instance. * * Generated from protobuf field optional .google.cloud.compute.v1.Metadata metadata = 86866735; * @param \Google\Cloud\Compute\V1\Metadata $var @@ -1188,7 +1442,11 @@ public function setMetadata($var) } /** - * Specifies a minimum CPU platform for the VM instance. Applicable values are the friendly names of CPU platforms, such as minCpuPlatform: "Intel Haswell" or minCpuPlatform: "Intel Sandy Bridge". + * Specifies aminimum CPU + * platform for the VM instance. Applicable values are the friendly names + * of CPU platforms, such as minCpuPlatform: "Intel + * Haswell" or minCpuPlatform: "Intel Sandy + * Bridge". * * Generated from protobuf field optional string min_cpu_platform = 242912759; * @return string @@ -1209,7 +1467,11 @@ public function clearMinCpuPlatform() } /** - * Specifies a minimum CPU platform for the VM instance. Applicable values are the friendly names of CPU platforms, such as minCpuPlatform: "Intel Haswell" or minCpuPlatform: "Intel Sandy Bridge". + * Specifies aminimum CPU + * platform for the VM instance. Applicable values are the friendly names + * of CPU platforms, such as minCpuPlatform: "Intel + * Haswell" or minCpuPlatform: "Intel Sandy + * Bridge". * * Generated from protobuf field optional string min_cpu_platform = 242912759; * @param string $var @@ -1224,7 +1486,14 @@ public function setMinCpuPlatform($var) } /** - * The name of the resource, provided by the client when initially creating the resource. The resource name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * The name of the resource, provided by the client when initially creating + * the resource. The resource name must be 1-63 characters long, and comply + * withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must be + * a dash, lowercase letter, or digit, except the last character, which cannot + * be a dash. * * Generated from protobuf field optional string name = 3373707; * @return string @@ -1245,7 +1514,14 @@ public function clearName() } /** - * The name of the resource, provided by the client when initially creating the resource. The resource name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * The name of the resource, provided by the client when initially creating + * the resource. The resource name must be 1-63 characters long, and comply + * withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must be + * a dash, lowercase letter, or digit, except the last character, which cannot + * be a dash. * * Generated from protobuf field optional string name = 3373707; * @param string $var @@ -1260,7 +1536,10 @@ public function setName($var) } /** - * An array of network configurations for this instance. These specify how interfaces are configured to interact with other network services, such as connecting to the internet. Multiple interfaces are supported per instance. + * An array of network configurations for this instance. These specify how + * interfaces are configured to interact with other network services, such as + * connecting to the internet. Multiple interfaces are supported + * per instance. * * Generated from protobuf field repeated .google.cloud.compute.v1.NetworkInterface network_interfaces = 52735243; * @return \Google\Protobuf\Internal\RepeatedField @@ -1271,7 +1550,10 @@ public function getNetworkInterfaces() } /** - * An array of network configurations for this instance. These specify how interfaces are configured to interact with other network services, such as connecting to the internet. Multiple interfaces are supported per instance. + * An array of network configurations for this instance. These specify how + * interfaces are configured to interact with other network services, such as + * connecting to the internet. Multiple interfaces are supported + * per instance. * * Generated from protobuf field repeated .google.cloud.compute.v1.NetworkInterface network_interfaces = 52735243; * @param array<\Google\Cloud\Compute\V1\NetworkInterface>|\Google\Protobuf\Internal\RepeatedField $var @@ -1318,7 +1600,8 @@ public function setNetworkPerformanceConfig($var) } /** - * Input only. [Input Only] Additional params passed with the request, but not persisted as part of resource payload. + * Input only. [Input Only] Additional params passed with the request, but not persisted + * as part of resource payload. * * Generated from protobuf field optional .google.cloud.compute.v1.InstanceParams params = 78313862; * @return \Google\Cloud\Compute\V1\InstanceParams|null @@ -1339,7 +1622,8 @@ public function clearParams() } /** - * Input only. [Input Only] Additional params passed with the request, but not persisted as part of resource payload. + * Input only. [Input Only] Additional params passed with the request, but not persisted + * as part of resource payload. * * Generated from protobuf field optional .google.cloud.compute.v1.InstanceParams params = 78313862; * @param \Google\Cloud\Compute\V1\InstanceParams $var @@ -1354,7 +1638,8 @@ public function setParams($var) } /** - * The private IPv6 google access type for the VM. If not specified, use INHERIT_FROM_SUBNETWORK as default. + * The private IPv6 google access type for the VM. + * If not specified, use INHERIT_FROM_SUBNETWORK as default. * Check the PrivateIpv6GoogleAccess enum for the list of possible values. * * Generated from protobuf field optional string private_ipv6_google_access = 48277006; @@ -1376,7 +1661,8 @@ public function clearPrivateIpv6GoogleAccess() } /** - * The private IPv6 google access type for the VM. If not specified, use INHERIT_FROM_SUBNETWORK as default. + * The private IPv6 google access type for the VM. + * If not specified, use INHERIT_FROM_SUBNETWORK as default. * Check the PrivateIpv6GoogleAccess enum for the list of possible values. * * Generated from protobuf field optional string private_ipv6_google_access = 48277006; @@ -1454,7 +1740,9 @@ public function setResourcePolicies($var) } /** - * [Output Only] Specifies values set for instance attributes as compared to the values requested by user in the corresponding input only field. + * [Output Only] Specifies values set for instance attributes as + * compared to the values requested by user in the corresponding input only + * field. * * Generated from protobuf field optional .google.cloud.compute.v1.ResourceStatus resource_status = 249429315; * @return \Google\Cloud\Compute\V1\ResourceStatus|null @@ -1475,7 +1763,9 @@ public function clearResourceStatus() } /** - * [Output Only] Specifies values set for instance attributes as compared to the values requested by user in the corresponding input only field. + * [Output Only] Specifies values set for instance attributes as + * compared to the values requested by user in the corresponding input only + * field. * * Generated from protobuf field optional .google.cloud.compute.v1.ResourceStatus resource_status = 249429315; * @param \Google\Cloud\Compute\V1\ResourceStatus $var @@ -1634,7 +1924,12 @@ public function setSelfLink($var) } /** - * A list of service accounts, with their specified scopes, authorized for this instance. Only one service account per VM instance is supported. Service accounts generate access tokens that can be accessed through the metadata server and used to authenticate applications on the instance. See Service Accounts for more information. + * A list of service accounts, with their specified scopes, authorized for + * this instance. Only one service account per VM instance is supported. + * Service accounts generate access tokens that can be accessed + * through the metadata server and used to authenticate applications on the + * instance. SeeService Accounts + * for more information. * * Generated from protobuf field repeated .google.cloud.compute.v1.ServiceAccount service_accounts = 277537328; * @return \Google\Protobuf\Internal\RepeatedField @@ -1645,7 +1940,12 @@ public function getServiceAccounts() } /** - * A list of service accounts, with their specified scopes, authorized for this instance. Only one service account per VM instance is supported. Service accounts generate access tokens that can be accessed through the metadata server and used to authenticate applications on the instance. See Service Accounts for more information. + * A list of service accounts, with their specified scopes, authorized for + * this instance. Only one service account per VM instance is supported. + * Service accounts generate access tokens that can be accessed + * through the metadata server and used to authenticate applications on the + * instance. SeeService Accounts + * for more information. * * Generated from protobuf field repeated .google.cloud.compute.v1.ServiceAccount service_accounts = 277537328; * @param array<\Google\Cloud\Compute\V1\ServiceAccount>|\Google\Protobuf\Internal\RepeatedField $var @@ -1760,7 +2060,8 @@ public function setSourceMachineImage($var) } /** - * Source machine image encryption key when creating an instance from a machine image. + * Source machine image encryption key when creating an instance from a + * machine image. * * Generated from protobuf field optional .google.cloud.compute.v1.CustomerEncryptionKey source_machine_image_encryption_key = 192839075; * @return \Google\Cloud\Compute\V1\CustomerEncryptionKey|null @@ -1781,7 +2082,8 @@ public function clearSourceMachineImageEncryptionKey() } /** - * Source machine image encryption key when creating an instance from a machine image. + * Source machine image encryption key when creating an instance from a + * machine image. * * Generated from protobuf field optional .google.cloud.compute.v1.CustomerEncryptionKey source_machine_image_encryption_key = 192839075; * @param \Google\Cloud\Compute\V1\CustomerEncryptionKey $var @@ -1796,7 +2098,8 @@ public function setSourceMachineImageEncryptionKey($var) } /** - * [Output Only] Whether a VM has been restricted for start because Compute Engine has detected suspicious activity. + * [Output Only] Whether a VM has been restricted for start because Compute + * Engine has detected suspicious activity. * * Generated from protobuf field optional bool start_restricted = 123693144; * @return bool @@ -1817,7 +2120,8 @@ public function clearStartRestricted() } /** - * [Output Only] Whether a VM has been restricted for start because Compute Engine has detected suspicious activity. + * [Output Only] Whether a VM has been restricted for start because Compute + * Engine has detected suspicious activity. * * Generated from protobuf field optional bool start_restricted = 123693144; * @param bool $var @@ -1832,7 +2136,10 @@ public function setStartRestricted($var) } /** - * [Output Only] The status of the instance. One of the following values: PROVISIONING, STAGING, RUNNING, STOPPING, SUSPENDING, SUSPENDED, REPAIRING, and TERMINATED. For more information about the status of the instance, see Instance life cycle. + * [Output Only] The status of the instance. One of the + * following values: PROVISIONING, STAGING,RUNNING, STOPPING, SUSPENDING,SUSPENDED, REPAIRING, andTERMINATED. For more information about the status of the + * instance, see + * Instance life cycle. * Check the Status enum for the list of possible values. * * Generated from protobuf field optional string status = 181260274; @@ -1854,7 +2161,10 @@ public function clearStatus() } /** - * [Output Only] The status of the instance. One of the following values: PROVISIONING, STAGING, RUNNING, STOPPING, SUSPENDING, SUSPENDED, REPAIRING, and TERMINATED. For more information about the status of the instance, see Instance life cycle. + * [Output Only] The status of the instance. One of the + * following values: PROVISIONING, STAGING,RUNNING, STOPPING, SUSPENDING,SUSPENDED, REPAIRING, andTERMINATED. For more information about the status of the + * instance, see + * Instance life cycle. * Check the Status enum for the list of possible values. * * Generated from protobuf field optional string status = 181260274; @@ -1906,7 +2216,11 @@ public function setStatusMessage($var) } /** - * Tags to apply to this instance. Tags are used to identify valid sources or targets for network firewalls and are specified by the client during instance creation. The tags can be later modified by the setTags method. Each tag within the list must comply with RFC1035. Multiple tags can be specified via the 'tags.items' field. + * Tags to apply to this instance. Tags are used to identify valid + * sources or targets for network firewalls and are specified by the client + * during instance creation. The tags can be later modified by the setTags + * method. Each tag within the list must comply withRFC1035. + * Multiple tags can be specified via the 'tags.items' field. * * Generated from protobuf field optional .google.cloud.compute.v1.Tags tags = 3552281; * @return \Google\Cloud\Compute\V1\Tags|null @@ -1927,7 +2241,11 @@ public function clearTags() } /** - * Tags to apply to this instance. Tags are used to identify valid sources or targets for network firewalls and are specified by the client during instance creation. The tags can be later modified by the setTags method. Each tag within the list must comply with RFC1035. Multiple tags can be specified via the 'tags.items' field. + * Tags to apply to this instance. Tags are used to identify valid + * sources or targets for network firewalls and are specified by the client + * during instance creation. The tags can be later modified by the setTags + * method. Each tag within the list must comply withRFC1035. + * Multiple tags can be specified via the 'tags.items' field. * * Generated from protobuf field optional .google.cloud.compute.v1.Tags tags = 3552281; * @param \Google\Cloud\Compute\V1\Tags $var @@ -1942,7 +2260,9 @@ public function setTags($var) } /** - * [Output Only] URL of the zone where the instance resides. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * [Output Only] URL of the zone where the instance resides. + * You must specify this field as part of the HTTP request URL. It is + * not settable as a field in the request body. * * Generated from protobuf field optional string zone = 3744684; * @return string @@ -1963,7 +2283,9 @@ public function clearZone() } /** - * [Output Only] URL of the zone where the instance resides. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * [Output Only] URL of the zone where the instance resides. + * You must specify this field as part of the HTTP request URL. It is + * not settable as a field in the request body. * * Generated from protobuf field optional string zone = 3744684; * @param string $var diff --git a/Compute/src/V1/Instance/KeyRevocationActionType.php b/Compute/src/V1/Instance/KeyRevocationActionType.php index 3572da630e69..d3519b093f03 100644 --- a/Compute/src/V1/Instance/KeyRevocationActionType.php +++ b/Compute/src/V1/Instance/KeyRevocationActionType.php @@ -7,7 +7,8 @@ use UnexpectedValueException; /** - * KeyRevocationActionType of the instance. Supported options are "STOP" and "NONE". The default value is "NONE" if it is not specified. + * KeyRevocationActionType of the instance. Supported options are "STOP" and + * "NONE". The default value is "NONE" if it is not specified. * * Protobuf type google.cloud.compute.v1.Instance.KeyRevocationActionType */ diff --git a/Compute/src/V1/Instance/PrivateIpv6GoogleAccess.php b/Compute/src/V1/Instance/PrivateIpv6GoogleAccess.php index 3116046b6b92..a1503dbb0a3a 100644 --- a/Compute/src/V1/Instance/PrivateIpv6GoogleAccess.php +++ b/Compute/src/V1/Instance/PrivateIpv6GoogleAccess.php @@ -7,7 +7,8 @@ use UnexpectedValueException; /** - * The private IPv6 google access type for the VM. If not specified, use INHERIT_FROM_SUBNETWORK as default. + * The private IPv6 google access type for the VM. + * If not specified, use INHERIT_FROM_SUBNETWORK as default. * * Protobuf type google.cloud.compute.v1.Instance.PrivateIpv6GoogleAccess */ @@ -20,19 +21,26 @@ class PrivateIpv6GoogleAccess */ const UNDEFINED_PRIVATE_IPV6_GOOGLE_ACCESS = 0; /** - * Bidirectional private IPv6 access to/from Google services. If specified, the subnetwork who is attached to the instance's default network interface will be assigned an internal IPv6 prefix if it doesn't have before. + * Bidirectional private IPv6 access to/from Google services. If + * specified, the subnetwork who is attached to the instance's default network + * interface will be assigned an internal IPv6 prefix if it doesn't have + * before. * * Generated from protobuf enum ENABLE_BIDIRECTIONAL_ACCESS_TO_GOOGLE = 427975994; */ const ENABLE_BIDIRECTIONAL_ACCESS_TO_GOOGLE = 427975994; /** - * Outbound private IPv6 access from VMs in this subnet to Google services. If specified, the subnetwork who is attached to the instance's default network interface will be assigned an internal IPv6 prefix if it doesn't have before. + * Outbound private IPv6 access from VMs in this subnet to Google services. If + * specified, the subnetwork who is attached to the instance's default network + * interface will be assigned an internal IPv6 prefix if it doesn't have + * before. * * Generated from protobuf enum ENABLE_OUTBOUND_VM_ACCESS_TO_GOOGLE = 288210263; */ const ENABLE_OUTBOUND_VM_ACCESS_TO_GOOGLE = 288210263; /** - * Each network interface inherits PrivateIpv6GoogleAccess from its subnetwork. + * Each network interface inherits PrivateIpv6GoogleAccess from its + * subnetwork. * * Generated from protobuf enum INHERIT_FROM_SUBNETWORK = 530256959; */ diff --git a/Compute/src/V1/Instance/Status.php b/Compute/src/V1/Instance/Status.php index 89611f359c12..b679b2e5516d 100644 --- a/Compute/src/V1/Instance/Status.php +++ b/Compute/src/V1/Instance/Status.php @@ -7,7 +7,10 @@ use UnexpectedValueException; /** - * [Output Only] The status of the instance. One of the following values: PROVISIONING, STAGING, RUNNING, STOPPING, SUSPENDING, SUSPENDED, REPAIRING, and TERMINATED. For more information about the status of the instance, see Instance life cycle. + * [Output Only] The status of the instance. One of the + * following values: PROVISIONING, STAGING,RUNNING, STOPPING, SUSPENDING,SUSPENDED, REPAIRING, andTERMINATED. For more information about the status of the + * instance, see + * Instance life cycle. * * Protobuf type google.cloud.compute.v1.Instance.Status */ @@ -20,13 +23,15 @@ class Status */ const UNDEFINED_STATUS = 0; /** - * The instance is halted and we are performing tear down tasks like network deprogramming, releasing quota, IP, tearing down disks etc. + * The instance is halted and we are performing tear down tasks like network + * deprogramming, releasing quota, IP, tearing down disks etc. * * Generated from protobuf enum DEPROVISIONING = 428935662; */ const DEPROVISIONING = 428935662; /** - * For Flex Start provisioning instance is waiting for available capacity from Dynamic Workload Scheduler (DWS). + * For Flex Start provisioning instance is waiting for available capacity + * from Dynamic Workload Scheduler (DWS). * * Generated from protobuf enum PENDING = 35394935; */ @@ -50,7 +55,8 @@ class Status */ const RUNNING = 121282975; /** - * All required resources have been allocated and the instance is being started. + * All required resources have been allocated and the instance + * is being started. * * Generated from protobuf enum STAGING = 431072283; */ @@ -80,7 +86,8 @@ class Status */ const SUSPENDING = 514206246; /** - * The instance has stopped (either by explicit action or underlying failure). + * The instance has stopped (either by explicit action or underlying + * failure). * * Generated from protobuf enum TERMINATED = 250018339; */ diff --git a/Compute/src/V1/InstanceAggregatedList.php b/Compute/src/V1/InstanceAggregatedList.php index 0f9edeb50bcb..ccd1576f9a2a 100644 --- a/Compute/src/V1/InstanceAggregatedList.php +++ b/Compute/src/V1/InstanceAggregatedList.php @@ -27,13 +27,18 @@ class InstanceAggregatedList extends \Google\Protobuf\Internal\Message */ private $items; /** - * [Output Only] Type of resource. Always compute#instanceAggregatedList for aggregated lists of Instance resources. + * [Output Only] Type of resource. Alwayscompute#instanceAggregatedList for aggregated lists of + * Instance resources. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -68,9 +73,14 @@ class InstanceAggregatedList extends \Google\Protobuf\Internal\Message * @type array|\Google\Protobuf\Internal\MapField $items * An object that contains a list of instances scoped by zone. * @type string $kind - * [Output Only] Type of resource. Always compute#instanceAggregatedList for aggregated lists of Instance resources. + * [Output Only] Type of resource. Alwayscompute#instanceAggregatedList for aggregated lists of + * Instance resources. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type array|\Google\Protobuf\Internal\RepeatedField $unreachables @@ -147,7 +157,8 @@ public function setItems($var) } /** - * [Output Only] Type of resource. Always compute#instanceAggregatedList for aggregated lists of Instance resources. + * [Output Only] Type of resource. Alwayscompute#instanceAggregatedList for aggregated lists of + * Instance resources. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -168,7 +179,8 @@ public function clearKind() } /** - * [Output Only] Type of resource. Always compute#instanceAggregatedList for aggregated lists of Instance resources. + * [Output Only] Type of resource. Alwayscompute#instanceAggregatedList for aggregated lists of + * Instance resources. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -183,7 +195,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -204,7 +220,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/InstanceConsumptionInfo.php b/Compute/src/V1/InstanceConsumptionInfo.php index dfa8432f165d..b60a7accf8b8 100644 --- a/Compute/src/V1/InstanceConsumptionInfo.php +++ b/Compute/src/V1/InstanceConsumptionInfo.php @@ -21,13 +21,15 @@ class InstanceConsumptionInfo extends \Google\Protobuf\Internal\Message */ protected $guest_cpus = null; /** - * The amount of local SSD storage available to the instance, defined in GiB. + * The amount of local SSD storage available to the instance, + * defined in GiB. * * Generated from protobuf field optional int32 local_ssd_gb = 329237578; */ protected $local_ssd_gb = null; /** - * The amount of physical memory available to the instance, defined in MiB. + * The amount of physical memory available to the instance, + * defined in MiB. * * Generated from protobuf field optional int32 memory_mb = 116001171; */ @@ -48,9 +50,11 @@ class InstanceConsumptionInfo extends \Google\Protobuf\Internal\Message * @type int $guest_cpus * The number of virtual CPUs that are available to the instance. * @type int $local_ssd_gb - * The amount of local SSD storage available to the instance, defined in GiB. + * The amount of local SSD storage available to the instance, + * defined in GiB. * @type int $memory_mb - * The amount of physical memory available to the instance, defined in MiB. + * The amount of physical memory available to the instance, + * defined in MiB. * @type int $min_node_cpus * The minimal guaranteed number of virtual CPUs that are reserved. * } @@ -97,7 +101,8 @@ public function setGuestCpus($var) } /** - * The amount of local SSD storage available to the instance, defined in GiB. + * The amount of local SSD storage available to the instance, + * defined in GiB. * * Generated from protobuf field optional int32 local_ssd_gb = 329237578; * @return int @@ -118,7 +123,8 @@ public function clearLocalSsdGb() } /** - * The amount of local SSD storage available to the instance, defined in GiB. + * The amount of local SSD storage available to the instance, + * defined in GiB. * * Generated from protobuf field optional int32 local_ssd_gb = 329237578; * @param int $var @@ -133,7 +139,8 @@ public function setLocalSsdGb($var) } /** - * The amount of physical memory available to the instance, defined in MiB. + * The amount of physical memory available to the instance, + * defined in MiB. * * Generated from protobuf field optional int32 memory_mb = 116001171; * @return int @@ -154,7 +161,8 @@ public function clearMemoryMb() } /** - * The amount of physical memory available to the instance, defined in MiB. + * The amount of physical memory available to the instance, + * defined in MiB. * * Generated from protobuf field optional int32 memory_mb = 116001171; * @param int $var diff --git a/Compute/src/V1/InstanceGroup.php b/Compute/src/V1/InstanceGroup.php index 98736e345ab3..0d33b53d8d6f 100644 --- a/Compute/src/V1/InstanceGroup.php +++ b/Compute/src/V1/InstanceGroup.php @@ -9,68 +9,95 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Represents an Instance Group resource. Instance Groups can be used to configure a target for load balancing. Instance groups can either be managed or unmanaged. To create managed instance groups, use the instanceGroupManager or regionInstanceGroupManager resource instead. Use zonal unmanaged instance groups if you need to apply load balancing to groups of heterogeneous instances or if you need to manage the instances yourself. You cannot create regional unmanaged instance groups. For more information, read Instance groups. + * Represents an Instance Group resource. + * Instance Groups can be used to configure a target forload + * balancing. + * Instance groups can either be managed or unmanaged. + * To create + * managed instance groups, use the instanceGroupManager orregionInstanceGroupManager resource instead. + * Use zonal unmanaged instance groups if you need to applyload + * balancing to groups of heterogeneous instances or if you need to manage + * the instances yourself. You cannot create regional unmanaged instance groups. + * For more information, readInstance + * groups. * * Generated from protobuf message google.cloud.compute.v1.InstanceGroup */ class InstanceGroup extends \Google\Protobuf\Internal\Message { /** - * [Output Only] The creation timestamp for this instance group in RFC3339 text format. + * [Output Only] The creation timestamp for this instance group inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; */ protected $creation_timestamp = null; /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; */ protected $description = null; /** - * [Output Only] The fingerprint of the named ports. The system uses this fingerprint to detect conflicts when multiple users change the named ports concurrently. + * [Output Only] The fingerprint of the named ports. The system + * uses this fingerprint to detect conflicts when multiple users change the + * named ports concurrently. * * Generated from protobuf field optional string fingerprint = 234678500; */ protected $fingerprint = null; /** - * [Output Only] A unique identifier for this instance group, generated by the server. + * [Output Only] A unique identifier for this instance group, generated + * by the server. * * Generated from protobuf field optional uint64 id = 3355; */ protected $id = null; /** - * [Output Only] The resource type, which is always compute#instanceGroup for instance groups. + * [Output Only] The resource type, which is alwayscompute#instanceGroup for instance groups. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * The name of the instance group. The name must be 1-63 characters long, and comply with RFC1035. + * The name of the instance group. The name must be 1-63 characters + * long, and comply withRFC1035. * * Generated from protobuf field optional string name = 3373707; */ protected $name = null; /** - * Optional. Assigns a name to a port number. For example: {name: "http", port: 80} This allows the system to reference ports by the assigned name instead of a port number. Named ports can also contain multiple ports. For example: [{name: "app1", port: 8080}, {name: "app1", port: 8081}, {name: "app2", port: 8082}] Named ports apply to all instances in this instance group. + * Optional. Assigns a name to a port number. For example:{name: "http", port: 80} + * This + * allows the system to reference ports by the assigned name instead of a + * port number. Named ports can also contain multiple ports. For example:[{name: "app1", port: 8080}, {name: + * "app1", port: 8081}, {name: "app2", port: + * 8082}] + * Named ports apply to all instances in this instance group. * * Generated from protobuf field repeated .google.cloud.compute.v1.NamedPort named_ports = 427598732; */ private $named_ports; /** - * [Output Only] The URL of the network to which all instances in the instance group belong. If your instance has multiple network interfaces, then the network and subnetwork fields only refer to the network and subnet used by your primary interface (nic0). + * [Output Only] The URL of the network to which all instances in the + * instance group belong. If your instance has multiple network interfaces, + * then the network and subnetwork fields only refer to the + * network and subnet used by your primary interface (nic0). * * Generated from protobuf field optional string network = 232872494; */ protected $network = null; /** - * [Output Only] The URL of the region where the instance group is located (for regional resources). + * [Output Only] The URL of theregion + * where the instance group is located (for regional resources). * * Generated from protobuf field optional string region = 138946292; */ protected $region = null; /** - * [Output Only] The URL for this instance group. The server generates this URL. + * [Output Only] The URL for this instance group. The server generates + * this URL. * * Generated from protobuf field optional string self_link = 456214797; */ @@ -82,13 +109,17 @@ class InstanceGroup extends \Google\Protobuf\Internal\Message */ protected $size = null; /** - * [Output Only] The URL of the subnetwork to which all instances in the instance group belong. If your instance has multiple network interfaces, then the network and subnetwork fields only refer to the network and subnet used by your primary interface (nic0). + * [Output Only] The URL of the subnetwork to which all instances in the + * instance group belong. If your instance has multiple network interfaces, + * then the network and subnetwork fields only refer to the + * network and subnet used by your primary interface (nic0). * * Generated from protobuf field optional string subnetwork = 307827694; */ protected $subnetwork = null; /** - * [Output Only] The URL of the zone where the instance group is located (for zonal resources). + * [Output Only] The URL of thezone + * where the instance group is located (for zonal resources). * * Generated from protobuf field optional string zone = 3744684; */ @@ -101,31 +132,52 @@ class InstanceGroup extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $creation_timestamp - * [Output Only] The creation timestamp for this instance group in RFC3339 text format. + * [Output Only] The creation timestamp for this instance group inRFC3339 + * text format. * @type string $description - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * @type string $fingerprint - * [Output Only] The fingerprint of the named ports. The system uses this fingerprint to detect conflicts when multiple users change the named ports concurrently. + * [Output Only] The fingerprint of the named ports. The system + * uses this fingerprint to detect conflicts when multiple users change the + * named ports concurrently. * @type int|string $id - * [Output Only] A unique identifier for this instance group, generated by the server. + * [Output Only] A unique identifier for this instance group, generated + * by the server. * @type string $kind - * [Output Only] The resource type, which is always compute#instanceGroup for instance groups. + * [Output Only] The resource type, which is alwayscompute#instanceGroup for instance groups. * @type string $name - * The name of the instance group. The name must be 1-63 characters long, and comply with RFC1035. + * The name of the instance group. The name must be 1-63 characters + * long, and comply withRFC1035. * @type array<\Google\Cloud\Compute\V1\NamedPort>|\Google\Protobuf\Internal\RepeatedField $named_ports - * Optional. Assigns a name to a port number. For example: {name: "http", port: 80} This allows the system to reference ports by the assigned name instead of a port number. Named ports can also contain multiple ports. For example: [{name: "app1", port: 8080}, {name: "app1", port: 8081}, {name: "app2", port: 8082}] Named ports apply to all instances in this instance group. + * Optional. Assigns a name to a port number. For example:{name: "http", port: 80} + * This + * allows the system to reference ports by the assigned name instead of a + * port number. Named ports can also contain multiple ports. For example:[{name: "app1", port: 8080}, {name: + * "app1", port: 8081}, {name: "app2", port: + * 8082}] + * Named ports apply to all instances in this instance group. * @type string $network - * [Output Only] The URL of the network to which all instances in the instance group belong. If your instance has multiple network interfaces, then the network and subnetwork fields only refer to the network and subnet used by your primary interface (nic0). + * [Output Only] The URL of the network to which all instances in the + * instance group belong. If your instance has multiple network interfaces, + * then the network and subnetwork fields only refer to the + * network and subnet used by your primary interface (nic0). * @type string $region - * [Output Only] The URL of the region where the instance group is located (for regional resources). + * [Output Only] The URL of theregion + * where the instance group is located (for regional resources). * @type string $self_link - * [Output Only] The URL for this instance group. The server generates this URL. + * [Output Only] The URL for this instance group. The server generates + * this URL. * @type int $size * [Output Only] The total number of instances in the instance group. * @type string $subnetwork - * [Output Only] The URL of the subnetwork to which all instances in the instance group belong. If your instance has multiple network interfaces, then the network and subnetwork fields only refer to the network and subnet used by your primary interface (nic0). + * [Output Only] The URL of the subnetwork to which all instances in the + * instance group belong. If your instance has multiple network interfaces, + * then the network and subnetwork fields only refer to the + * network and subnet used by your primary interface (nic0). * @type string $zone - * [Output Only] The URL of the zone where the instance group is located (for zonal resources). + * [Output Only] The URL of thezone + * where the instance group is located (for zonal resources). * } */ public function __construct($data = NULL) { @@ -134,7 +186,8 @@ public function __construct($data = NULL) { } /** - * [Output Only] The creation timestamp for this instance group in RFC3339 text format. + * [Output Only] The creation timestamp for this instance group inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @return string @@ -155,7 +208,8 @@ public function clearCreationTimestamp() } /** - * [Output Only] The creation timestamp for this instance group in RFC3339 text format. + * [Output Only] The creation timestamp for this instance group inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @param string $var @@ -170,7 +224,8 @@ public function setCreationTimestamp($var) } /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @return string @@ -191,7 +246,8 @@ public function clearDescription() } /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @param string $var @@ -206,7 +262,9 @@ public function setDescription($var) } /** - * [Output Only] The fingerprint of the named ports. The system uses this fingerprint to detect conflicts when multiple users change the named ports concurrently. + * [Output Only] The fingerprint of the named ports. The system + * uses this fingerprint to detect conflicts when multiple users change the + * named ports concurrently. * * Generated from protobuf field optional string fingerprint = 234678500; * @return string @@ -227,7 +285,9 @@ public function clearFingerprint() } /** - * [Output Only] The fingerprint of the named ports. The system uses this fingerprint to detect conflicts when multiple users change the named ports concurrently. + * [Output Only] The fingerprint of the named ports. The system + * uses this fingerprint to detect conflicts when multiple users change the + * named ports concurrently. * * Generated from protobuf field optional string fingerprint = 234678500; * @param string $var @@ -242,7 +302,8 @@ public function setFingerprint($var) } /** - * [Output Only] A unique identifier for this instance group, generated by the server. + * [Output Only] A unique identifier for this instance group, generated + * by the server. * * Generated from protobuf field optional uint64 id = 3355; * @return int|string @@ -263,7 +324,8 @@ public function clearId() } /** - * [Output Only] A unique identifier for this instance group, generated by the server. + * [Output Only] A unique identifier for this instance group, generated + * by the server. * * Generated from protobuf field optional uint64 id = 3355; * @param int|string $var @@ -278,7 +340,7 @@ public function setId($var) } /** - * [Output Only] The resource type, which is always compute#instanceGroup for instance groups. + * [Output Only] The resource type, which is alwayscompute#instanceGroup for instance groups. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -299,7 +361,7 @@ public function clearKind() } /** - * [Output Only] The resource type, which is always compute#instanceGroup for instance groups. + * [Output Only] The resource type, which is alwayscompute#instanceGroup for instance groups. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -314,7 +376,8 @@ public function setKind($var) } /** - * The name of the instance group. The name must be 1-63 characters long, and comply with RFC1035. + * The name of the instance group. The name must be 1-63 characters + * long, and comply withRFC1035. * * Generated from protobuf field optional string name = 3373707; * @return string @@ -335,7 +398,8 @@ public function clearName() } /** - * The name of the instance group. The name must be 1-63 characters long, and comply with RFC1035. + * The name of the instance group. The name must be 1-63 characters + * long, and comply withRFC1035. * * Generated from protobuf field optional string name = 3373707; * @param string $var @@ -350,7 +414,13 @@ public function setName($var) } /** - * Optional. Assigns a name to a port number. For example: {name: "http", port: 80} This allows the system to reference ports by the assigned name instead of a port number. Named ports can also contain multiple ports. For example: [{name: "app1", port: 8080}, {name: "app1", port: 8081}, {name: "app2", port: 8082}] Named ports apply to all instances in this instance group. + * Optional. Assigns a name to a port number. For example:{name: "http", port: 80} + * This + * allows the system to reference ports by the assigned name instead of a + * port number. Named ports can also contain multiple ports. For example:[{name: "app1", port: 8080}, {name: + * "app1", port: 8081}, {name: "app2", port: + * 8082}] + * Named ports apply to all instances in this instance group. * * Generated from protobuf field repeated .google.cloud.compute.v1.NamedPort named_ports = 427598732; * @return \Google\Protobuf\Internal\RepeatedField @@ -361,7 +431,13 @@ public function getNamedPorts() } /** - * Optional. Assigns a name to a port number. For example: {name: "http", port: 80} This allows the system to reference ports by the assigned name instead of a port number. Named ports can also contain multiple ports. For example: [{name: "app1", port: 8080}, {name: "app1", port: 8081}, {name: "app2", port: 8082}] Named ports apply to all instances in this instance group. + * Optional. Assigns a name to a port number. For example:{name: "http", port: 80} + * This + * allows the system to reference ports by the assigned name instead of a + * port number. Named ports can also contain multiple ports. For example:[{name: "app1", port: 8080}, {name: + * "app1", port: 8081}, {name: "app2", port: + * 8082}] + * Named ports apply to all instances in this instance group. * * Generated from protobuf field repeated .google.cloud.compute.v1.NamedPort named_ports = 427598732; * @param array<\Google\Cloud\Compute\V1\NamedPort>|\Google\Protobuf\Internal\RepeatedField $var @@ -376,7 +452,10 @@ public function setNamedPorts($var) } /** - * [Output Only] The URL of the network to which all instances in the instance group belong. If your instance has multiple network interfaces, then the network and subnetwork fields only refer to the network and subnet used by your primary interface (nic0). + * [Output Only] The URL of the network to which all instances in the + * instance group belong. If your instance has multiple network interfaces, + * then the network and subnetwork fields only refer to the + * network and subnet used by your primary interface (nic0). * * Generated from protobuf field optional string network = 232872494; * @return string @@ -397,7 +476,10 @@ public function clearNetwork() } /** - * [Output Only] The URL of the network to which all instances in the instance group belong. If your instance has multiple network interfaces, then the network and subnetwork fields only refer to the network and subnet used by your primary interface (nic0). + * [Output Only] The URL of the network to which all instances in the + * instance group belong. If your instance has multiple network interfaces, + * then the network and subnetwork fields only refer to the + * network and subnet used by your primary interface (nic0). * * Generated from protobuf field optional string network = 232872494; * @param string $var @@ -412,7 +494,8 @@ public function setNetwork($var) } /** - * [Output Only] The URL of the region where the instance group is located (for regional resources). + * [Output Only] The URL of theregion + * where the instance group is located (for regional resources). * * Generated from protobuf field optional string region = 138946292; * @return string @@ -433,7 +516,8 @@ public function clearRegion() } /** - * [Output Only] The URL of the region where the instance group is located (for regional resources). + * [Output Only] The URL of theregion + * where the instance group is located (for regional resources). * * Generated from protobuf field optional string region = 138946292; * @param string $var @@ -448,7 +532,8 @@ public function setRegion($var) } /** - * [Output Only] The URL for this instance group. The server generates this URL. + * [Output Only] The URL for this instance group. The server generates + * this URL. * * Generated from protobuf field optional string self_link = 456214797; * @return string @@ -469,7 +554,8 @@ public function clearSelfLink() } /** - * [Output Only] The URL for this instance group. The server generates this URL. + * [Output Only] The URL for this instance group. The server generates + * this URL. * * Generated from protobuf field optional string self_link = 456214797; * @param string $var @@ -520,7 +606,10 @@ public function setSize($var) } /** - * [Output Only] The URL of the subnetwork to which all instances in the instance group belong. If your instance has multiple network interfaces, then the network and subnetwork fields only refer to the network and subnet used by your primary interface (nic0). + * [Output Only] The URL of the subnetwork to which all instances in the + * instance group belong. If your instance has multiple network interfaces, + * then the network and subnetwork fields only refer to the + * network and subnet used by your primary interface (nic0). * * Generated from protobuf field optional string subnetwork = 307827694; * @return string @@ -541,7 +630,10 @@ public function clearSubnetwork() } /** - * [Output Only] The URL of the subnetwork to which all instances in the instance group belong. If your instance has multiple network interfaces, then the network and subnetwork fields only refer to the network and subnet used by your primary interface (nic0). + * [Output Only] The URL of the subnetwork to which all instances in the + * instance group belong. If your instance has multiple network interfaces, + * then the network and subnetwork fields only refer to the + * network and subnet used by your primary interface (nic0). * * Generated from protobuf field optional string subnetwork = 307827694; * @param string $var @@ -556,7 +648,8 @@ public function setSubnetwork($var) } /** - * [Output Only] The URL of the zone where the instance group is located (for zonal resources). + * [Output Only] The URL of thezone + * where the instance group is located (for zonal resources). * * Generated from protobuf field optional string zone = 3744684; * @return string @@ -577,7 +670,8 @@ public function clearZone() } /** - * [Output Only] The URL of the zone where the instance group is located (for zonal resources). + * [Output Only] The URL of thezone + * where the instance group is located (for zonal resources). * * Generated from protobuf field optional string zone = 3744684; * @param string $var diff --git a/Compute/src/V1/InstanceGroupAggregatedList.php b/Compute/src/V1/InstanceGroupAggregatedList.php index 9533de598444..217abcba390f 100644 --- a/Compute/src/V1/InstanceGroupAggregatedList.php +++ b/Compute/src/V1/InstanceGroupAggregatedList.php @@ -27,13 +27,18 @@ class InstanceGroupAggregatedList extends \Google\Protobuf\Internal\Message */ private $items; /** - * [Output Only] The resource type, which is always compute#instanceGroupAggregatedList for aggregated lists of instance groups. + * [Output Only] The resource type, which is alwayscompute#instanceGroupAggregatedList for aggregated lists of + * instance groups. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -68,9 +73,14 @@ class InstanceGroupAggregatedList extends \Google\Protobuf\Internal\Message * @type array|\Google\Protobuf\Internal\MapField $items * A list of InstanceGroupsScopedList resources. * @type string $kind - * [Output Only] The resource type, which is always compute#instanceGroupAggregatedList for aggregated lists of instance groups. + * [Output Only] The resource type, which is alwayscompute#instanceGroupAggregatedList for aggregated lists of + * instance groups. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type array|\Google\Protobuf\Internal\RepeatedField $unreachables @@ -147,7 +157,8 @@ public function setItems($var) } /** - * [Output Only] The resource type, which is always compute#instanceGroupAggregatedList for aggregated lists of instance groups. + * [Output Only] The resource type, which is alwayscompute#instanceGroupAggregatedList for aggregated lists of + * instance groups. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -168,7 +179,8 @@ public function clearKind() } /** - * [Output Only] The resource type, which is always compute#instanceGroupAggregatedList for aggregated lists of instance groups. + * [Output Only] The resource type, which is alwayscompute#instanceGroupAggregatedList for aggregated lists of + * instance groups. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -183,7 +195,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -204,7 +220,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/InstanceGroupList.php b/Compute/src/V1/InstanceGroupList.php index 79f574ffccc7..ee51e2a31542 100644 --- a/Compute/src/V1/InstanceGroupList.php +++ b/Compute/src/V1/InstanceGroupList.php @@ -28,13 +28,17 @@ class InstanceGroupList extends \Google\Protobuf\Internal\Message */ private $items; /** - * [Output Only] The resource type, which is always compute#instanceGroupList for instance group lists. + * [Output Only] The resource type, which is alwayscompute#instanceGroupList for instance group lists. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -63,9 +67,13 @@ class InstanceGroupList extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\InstanceGroup>|\Google\Protobuf\Internal\RepeatedField $items * A list of InstanceGroup resources. * @type string $kind - * [Output Only] The resource type, which is always compute#instanceGroupList for instance group lists. + * [Output Only] The resource type, which is alwayscompute#instanceGroupList for instance group lists. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type \Google\Cloud\Compute\V1\Warning $warning @@ -140,7 +148,7 @@ public function setItems($var) } /** - * [Output Only] The resource type, which is always compute#instanceGroupList for instance group lists. + * [Output Only] The resource type, which is alwayscompute#instanceGroupList for instance group lists. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -161,7 +169,7 @@ public function clearKind() } /** - * [Output Only] The resource type, which is always compute#instanceGroupList for instance group lists. + * [Output Only] The resource type, which is alwayscompute#instanceGroupList for instance group lists. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -176,7 +184,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -197,7 +209,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/InstanceGroupManager.php b/Compute/src/V1/InstanceGroupManager.php index 56bfa66c4ffa..587281c00656 100644 --- a/Compute/src/V1/InstanceGroupManager.php +++ b/Compute/src/V1/InstanceGroupManager.php @@ -9,38 +9,58 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Represents a Managed Instance Group resource. An instance group is a collection of VM instances that you can manage as a single entity. For more information, read Instance groups. For zonal Managed Instance Group, use the instanceGroupManagers resource. For regional Managed Instance Group, use the regionInstanceGroupManagers resource. + * Represents a Managed Instance Group resource. + * An instance group is a collection of VM instances that you can manage as a + * single entity. For more information, readInstance groups. + * For zonal Managed Instance Group, use the instanceGroupManagers + * resource. + * For regional Managed Instance Group, use theregionInstanceGroupManagers resource. * * Generated from protobuf message google.cloud.compute.v1.InstanceGroupManager */ class InstanceGroupManager extends \Google\Protobuf\Internal\Message { /** - * Specifies configuration that overrides the instance template configuration for the group. + * Specifies configuration that overrides the instance template configuration + * for the group. * * Generated from protobuf field optional .google.cloud.compute.v1.InstanceGroupManagerAllInstancesConfig all_instances_config = 112596737; */ protected $all_instances_config = null; /** - * The autohealing policy for this managed instance group. You can specify only one value. + * The autohealing policy for this managed instance group. You can specify + * only one value. * * Generated from protobuf field repeated .google.cloud.compute.v1.InstanceGroupManagerAutoHealingPolicy auto_healing_policies = 456799109; */ private $auto_healing_policies; /** - * The base instance name is a prefix that you want to attach to the names of all VMs in a MIG. The maximum character length is 58 and the name must comply with RFC1035 format. When a VM is created in the group, the MIG appends a hyphen and a random four-character string to the base instance name. If you want the MIG to assign sequential numbers instead of a random string, then end the base instance name with a hyphen followed by one or more hash symbols. The hash symbols indicate the number of digits. For example, a base instance name of "vm-###" results in "vm-001" as a VM name. @pattern [a-z](([-a-z0-9]{0,57})|([-a-z0-9]{0,51}-#{1,10}(\\[[0-9]{1,10}\\])?)) + * The base instance name is a prefix that you want to attach to the names of + * all VMs in a MIG. The maximum character length is 58 and the name must + * comply with RFC1035 format. + * When a VM is created in the group, the MIG appends a hyphen and a random + * four-character string to the base instance name. If you want the MIG to + * assign sequential numbers instead of a random string, then end the base + * instance name with a hyphen followed by one or more hash symbols. The hash + * symbols indicate the number of digits. For example, a base instance name of + * "vm-###" results in "vm-001" as a VM name. + * @pattern + * [a-z](([-a-z0-9]{0,57})|([-a-z0-9]{0,51}-#{1,10}(\\[[0-9]{1,10}\\])?)) * * Generated from protobuf field optional string base_instance_name = 389106439; */ protected $base_instance_name = null; /** - * [Output Only] The creation timestamp for this managed instance group in RFC3339 text format. + * [Output Only] The creation timestamp for this managed instance group inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; */ protected $creation_timestamp = null; /** - * [Output Only] The list of instance actions and the number of instances in this managed instance group that are scheduled for each of those actions. + * [Output Only] The list of instance actions and the number of instances + * in this managed instance group that are scheduled for each of those + * actions. * * Generated from protobuf field optional .google.cloud.compute.v1.InstanceGroupManagerActionsSummary current_actions = 164045879; */ @@ -52,25 +72,35 @@ class InstanceGroupManager extends \Google\Protobuf\Internal\Message */ protected $description = null; /** - * Policy specifying the intended distribution of managed instances across zones in a regional managed instance group. + * Policy specifying the intended distribution of managed instances across + * zones in a regional managed instance group. * * Generated from protobuf field optional .google.cloud.compute.v1.DistributionPolicy distribution_policy = 534558541; */ protected $distribution_policy = null; /** - * Fingerprint of this resource. This field may be used in optimistic locking. It will be ignored when inserting an InstanceGroupManager. An up-to-date fingerprint must be provided in order to update the InstanceGroupManager, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve an InstanceGroupManager. + * Fingerprint of this resource. This field may be used in optimistic locking. + * It will be ignored when inserting an InstanceGroupManager. An up-to-date + * fingerprint must be provided in order to update the InstanceGroupManager, + * otherwise the request will fail with error412 conditionNotMet. + * To see the latest fingerprint, make a get() request to + * retrieve an InstanceGroupManager. * * Generated from protobuf field optional string fingerprint = 234678500; */ protected $fingerprint = null; /** - * [Output Only] A unique identifier for this resource type. The server generates this identifier. + * [Output Only] A unique identifier for this resource type. The server + * generates this identifier. * * Generated from protobuf field optional uint64 id = 3355; */ protected $id = null; /** - * Instance flexibility allowing MIG to create VMs from multiple types of machines. Instance flexibility configuration on MIG overrides instance template configuration. + * Instance flexibility allowing MIG to create VMs from multiple + * types of machines. + * Instance flexibility configuration on MIG overrides instance + * template configuration. * * Generated from protobuf field optional .google.cloud.compute.v1.InstanceGroupManagerInstanceFlexibilityPolicy instance_flexibility_policy = 26937090; */ @@ -88,38 +118,45 @@ class InstanceGroupManager extends \Google\Protobuf\Internal\Message */ protected $instance_lifecycle_policy = null; /** - * The URL of the instance template that is specified for this managed instance group. The group uses this template to create all new instances in the managed instance group. The templates for existing instances in the group do not change unless you run recreateInstances, run applyUpdatesToInstances, or set the group's updatePolicy.type to PROACTIVE. + * The URL of the instance template that is specified for this managed + * instance group. The group uses this template to create all new instances + * in the managed instance group. The templates for existing instances in the + * group do not change unless you run recreateInstances, runapplyUpdatesToInstances, or set the group'supdatePolicy.type to PROACTIVE. * * Generated from protobuf field optional string instance_template = 309248228; */ protected $instance_template = null; /** - * [Output Only] The resource type, which is always compute#instanceGroupManager for managed instance groups. + * [Output Only] The resource type, which is alwayscompute#instanceGroupManager for managed instance groups. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * Pagination behavior of the listManagedInstances API method for this managed instance group. + * Pagination behavior of the listManagedInstances API method for + * this managed instance group. * Check the ListManagedInstancesResults enum for the list of possible values. * * Generated from protobuf field optional string list_managed_instances_results = 296047156; */ protected $list_managed_instances_results = null; /** - * The name of the managed instance group. The name must be 1-63 characters long, and comply with RFC1035. + * The name of the managed instance group. The name must be 1-63 characters + * long, and comply withRFC1035. * * Generated from protobuf field optional string name = 3373707; */ protected $name = null; /** - * [Output Only] Named ports configured on the Instance Groups complementary to this Instance Group Manager. + * [Output Only] Named ports configured on the Instance Groups complementary + * to this Instance Group Manager. * * Generated from protobuf field repeated .google.cloud.compute.v1.NamedPort named_ports = 427598732; */ private $named_ports; /** - * [Output Only] The URL of the region where the managed instance group resides (for regional resources). + * [Output Only] The URL of theregion + * where the managed instance group resides (for regional resources). * * Generated from protobuf field optional string region = 138946292; */ @@ -143,7 +180,8 @@ class InstanceGroupManager extends \Google\Protobuf\Internal\Message */ protected $satisfies_pzs = null; /** - * [Output Only] The URL for this managed instance group. The server defines this URL. + * [Output Only] The URL for this managed instance group. The server defines + * this URL. * * Generated from protobuf field optional string self_link = 456214797; */ @@ -167,25 +205,41 @@ class InstanceGroupManager extends \Google\Protobuf\Internal\Message */ protected $status = null; /** - * The URLs for all TargetPool resources to which instances in the instanceGroup field are added. The target pools automatically apply to all of the instances in the managed instance group. + * The URLs for all TargetPool resources to which instances in theinstanceGroup field are added. The target pools automatically + * apply to all of the instances in the managed instance group. * * Generated from protobuf field repeated string target_pools = 336072617; */ private $target_pools; /** - * The target number of running instances for this managed instance group. You can reduce this number by using the instanceGroupManager deleteInstances or abandonInstances methods. Resizing the group also changes this number. + * The target number of running instances for this managed instance group. + * You can reduce this number by using the instanceGroupManager + * deleteInstances or abandonInstances methods. Resizing the group also + * changes this number. * * Generated from protobuf field optional int32 target_size = 62880239; */ protected $target_size = null; /** - * The target number of stopped instances for this managed instance group. This number changes when you: - Stop instance using the stopInstances method or start instances using the startInstances method. - Manually change the targetStoppedSize using the update method. + * The target number of stopped instances for this managed instance group. + * This number changes when you: + * - Stop instance using the stopInstances + * method or start instances using the startInstances + * method. + * - Manually change the targetStoppedSize using the update + * method. * * Generated from protobuf field optional int32 target_stopped_size = 2419489; */ protected $target_stopped_size = null; /** - * The target number of suspended instances for this managed instance group. This number changes when you: - Suspend instance using the suspendInstances method or resume instances using the resumeInstances method. - Manually change the targetSuspendedSize using the update method. + * The target number of suspended instances for this managed instance group. + * This number changes when you: + * - Suspend instance using the suspendInstances + * method or resume instances using the resumeInstances + * method. + * - Manually change the targetSuspendedSize using the update + * method. * * Generated from protobuf field optional int32 target_suspended_size = 308085843; */ @@ -197,13 +251,21 @@ class InstanceGroupManager extends \Google\Protobuf\Internal\Message */ protected $update_policy = null; /** - * Specifies the instance templates used by this managed instance group to create instances. Each version is defined by an instanceTemplate and a name. Every version can appear at most once per instance group. This field overrides the top-level instanceTemplate field. Read more about the relationships between these fields. Exactly one version must leave the targetSize field unset. That version will be applied to all remaining instances. For more information, read about canary updates. + * Specifies the instance templates used by this managed instance group to + * create instances. + * Each version is defined by an instanceTemplate and aname. Every version can appear at most once per instance + * group. This field overrides the top-level instanceTemplate + * field. Read more about therelationships + * between these fields. Exactly one version must leave thetargetSize field unset. That version will be applied to all + * remaining instances. For more information, read aboutcanary + * updates. * * Generated from protobuf field repeated .google.cloud.compute.v1.InstanceGroupManagerVersion versions = 162430619; */ private $versions; /** - * [Output Only] The URL of a zone where the managed instance group is located (for zonal resources). + * [Output Only] The URL of azone + * where the managed instance group is located (for zonal resources). * * Generated from protobuf field optional string zone = 3744684; */ @@ -216,42 +278,74 @@ class InstanceGroupManager extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type \Google\Cloud\Compute\V1\InstanceGroupManagerAllInstancesConfig $all_instances_config - * Specifies configuration that overrides the instance template configuration for the group. + * Specifies configuration that overrides the instance template configuration + * for the group. * @type array<\Google\Cloud\Compute\V1\InstanceGroupManagerAutoHealingPolicy>|\Google\Protobuf\Internal\RepeatedField $auto_healing_policies - * The autohealing policy for this managed instance group. You can specify only one value. + * The autohealing policy for this managed instance group. You can specify + * only one value. * @type string $base_instance_name - * The base instance name is a prefix that you want to attach to the names of all VMs in a MIG. The maximum character length is 58 and the name must comply with RFC1035 format. When a VM is created in the group, the MIG appends a hyphen and a random four-character string to the base instance name. If you want the MIG to assign sequential numbers instead of a random string, then end the base instance name with a hyphen followed by one or more hash symbols. The hash symbols indicate the number of digits. For example, a base instance name of "vm-###" results in "vm-001" as a VM name. @pattern [a-z](([-a-z0-9]{0,57})|([-a-z0-9]{0,51}-#{1,10}(\\[[0-9]{1,10}\\])?)) + * The base instance name is a prefix that you want to attach to the names of + * all VMs in a MIG. The maximum character length is 58 and the name must + * comply with RFC1035 format. + * When a VM is created in the group, the MIG appends a hyphen and a random + * four-character string to the base instance name. If you want the MIG to + * assign sequential numbers instead of a random string, then end the base + * instance name with a hyphen followed by one or more hash symbols. The hash + * symbols indicate the number of digits. For example, a base instance name of + * "vm-###" results in "vm-001" as a VM name. + * @pattern + * [a-z](([-a-z0-9]{0,57})|([-a-z0-9]{0,51}-#{1,10}(\\[[0-9]{1,10}\\])?)) * @type string $creation_timestamp - * [Output Only] The creation timestamp for this managed instance group in RFC3339 text format. + * [Output Only] The creation timestamp for this managed instance group inRFC3339 + * text format. * @type \Google\Cloud\Compute\V1\InstanceGroupManagerActionsSummary $current_actions - * [Output Only] The list of instance actions and the number of instances in this managed instance group that are scheduled for each of those actions. + * [Output Only] The list of instance actions and the number of instances + * in this managed instance group that are scheduled for each of those + * actions. * @type string $description * An optional description of this resource. * @type \Google\Cloud\Compute\V1\DistributionPolicy $distribution_policy - * Policy specifying the intended distribution of managed instances across zones in a regional managed instance group. + * Policy specifying the intended distribution of managed instances across + * zones in a regional managed instance group. * @type string $fingerprint - * Fingerprint of this resource. This field may be used in optimistic locking. It will be ignored when inserting an InstanceGroupManager. An up-to-date fingerprint must be provided in order to update the InstanceGroupManager, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve an InstanceGroupManager. + * Fingerprint of this resource. This field may be used in optimistic locking. + * It will be ignored when inserting an InstanceGroupManager. An up-to-date + * fingerprint must be provided in order to update the InstanceGroupManager, + * otherwise the request will fail with error412 conditionNotMet. + * To see the latest fingerprint, make a get() request to + * retrieve an InstanceGroupManager. * @type int|string $id - * [Output Only] A unique identifier for this resource type. The server generates this identifier. + * [Output Only] A unique identifier for this resource type. The server + * generates this identifier. * @type \Google\Cloud\Compute\V1\InstanceGroupManagerInstanceFlexibilityPolicy $instance_flexibility_policy - * Instance flexibility allowing MIG to create VMs from multiple types of machines. Instance flexibility configuration on MIG overrides instance template configuration. + * Instance flexibility allowing MIG to create VMs from multiple + * types of machines. + * Instance flexibility configuration on MIG overrides instance + * template configuration. * @type string $instance_group * [Output Only] The URL of the Instance Group resource. * @type \Google\Cloud\Compute\V1\InstanceGroupManagerInstanceLifecyclePolicy $instance_lifecycle_policy * The repair policy for this managed instance group. * @type string $instance_template - * The URL of the instance template that is specified for this managed instance group. The group uses this template to create all new instances in the managed instance group. The templates for existing instances in the group do not change unless you run recreateInstances, run applyUpdatesToInstances, or set the group's updatePolicy.type to PROACTIVE. + * The URL of the instance template that is specified for this managed + * instance group. The group uses this template to create all new instances + * in the managed instance group. The templates for existing instances in the + * group do not change unless you run recreateInstances, runapplyUpdatesToInstances, or set the group'supdatePolicy.type to PROACTIVE. * @type string $kind - * [Output Only] The resource type, which is always compute#instanceGroupManager for managed instance groups. + * [Output Only] The resource type, which is alwayscompute#instanceGroupManager for managed instance groups. * @type string $list_managed_instances_results - * Pagination behavior of the listManagedInstances API method for this managed instance group. + * Pagination behavior of the listManagedInstances API method for + * this managed instance group. * Check the ListManagedInstancesResults enum for the list of possible values. * @type string $name - * The name of the managed instance group. The name must be 1-63 characters long, and comply with RFC1035. + * The name of the managed instance group. The name must be 1-63 characters + * long, and comply withRFC1035. * @type array<\Google\Cloud\Compute\V1\NamedPort>|\Google\Protobuf\Internal\RepeatedField $named_ports - * [Output Only] Named ports configured on the Instance Groups complementary to this Instance Group Manager. + * [Output Only] Named ports configured on the Instance Groups complementary + * to this Instance Group Manager. * @type string $region - * [Output Only] The URL of the region where the managed instance group resides (for regional resources). + * [Output Only] The URL of theregion + * where the managed instance group resides (for regional resources). * @type \Google\Cloud\Compute\V1\InstanceGroupManagerResourcePolicies $resource_policies * Resource policies for this managed instance group. * @type bool $satisfies_pzi @@ -259,7 +353,8 @@ class InstanceGroupManager extends \Google\Protobuf\Internal\Message * @type bool $satisfies_pzs * [Output Only] Reserved for future use. * @type string $self_link - * [Output Only] The URL for this managed instance group. The server defines this URL. + * [Output Only] The URL for this managed instance group. The server defines + * this URL. * @type \Google\Cloud\Compute\V1\InstanceGroupManagerStandbyPolicy $standby_policy * Standby policy for stopped and suspended instances. * @type \Google\Cloud\Compute\V1\StatefulPolicy $stateful_policy @@ -267,19 +362,43 @@ class InstanceGroupManager extends \Google\Protobuf\Internal\Message * @type \Google\Cloud\Compute\V1\InstanceGroupManagerStatus $status * [Output Only] The status of this managed instance group. * @type array|\Google\Protobuf\Internal\RepeatedField $target_pools - * The URLs for all TargetPool resources to which instances in the instanceGroup field are added. The target pools automatically apply to all of the instances in the managed instance group. + * The URLs for all TargetPool resources to which instances in theinstanceGroup field are added. The target pools automatically + * apply to all of the instances in the managed instance group. * @type int $target_size - * The target number of running instances for this managed instance group. You can reduce this number by using the instanceGroupManager deleteInstances or abandonInstances methods. Resizing the group also changes this number. + * The target number of running instances for this managed instance group. + * You can reduce this number by using the instanceGroupManager + * deleteInstances or abandonInstances methods. Resizing the group also + * changes this number. * @type int $target_stopped_size - * The target number of stopped instances for this managed instance group. This number changes when you: - Stop instance using the stopInstances method or start instances using the startInstances method. - Manually change the targetStoppedSize using the update method. + * The target number of stopped instances for this managed instance group. + * This number changes when you: + * - Stop instance using the stopInstances + * method or start instances using the startInstances + * method. + * - Manually change the targetStoppedSize using the update + * method. * @type int $target_suspended_size - * The target number of suspended instances for this managed instance group. This number changes when you: - Suspend instance using the suspendInstances method or resume instances using the resumeInstances method. - Manually change the targetSuspendedSize using the update method. + * The target number of suspended instances for this managed instance group. + * This number changes when you: + * - Suspend instance using the suspendInstances + * method or resume instances using the resumeInstances + * method. + * - Manually change the targetSuspendedSize using the update + * method. * @type \Google\Cloud\Compute\V1\InstanceGroupManagerUpdatePolicy $update_policy * The update policy for this managed instance group. * @type array<\Google\Cloud\Compute\V1\InstanceGroupManagerVersion>|\Google\Protobuf\Internal\RepeatedField $versions - * Specifies the instance templates used by this managed instance group to create instances. Each version is defined by an instanceTemplate and a name. Every version can appear at most once per instance group. This field overrides the top-level instanceTemplate field. Read more about the relationships between these fields. Exactly one version must leave the targetSize field unset. That version will be applied to all remaining instances. For more information, read about canary updates. + * Specifies the instance templates used by this managed instance group to + * create instances. + * Each version is defined by an instanceTemplate and aname. Every version can appear at most once per instance + * group. This field overrides the top-level instanceTemplate + * field. Read more about therelationships + * between these fields. Exactly one version must leave thetargetSize field unset. That version will be applied to all + * remaining instances. For more information, read aboutcanary + * updates. * @type string $zone - * [Output Only] The URL of a zone where the managed instance group is located (for zonal resources). + * [Output Only] The URL of azone + * where the managed instance group is located (for zonal resources). * } */ public function __construct($data = NULL) { @@ -288,7 +407,8 @@ public function __construct($data = NULL) { } /** - * Specifies configuration that overrides the instance template configuration for the group. + * Specifies configuration that overrides the instance template configuration + * for the group. * * Generated from protobuf field optional .google.cloud.compute.v1.InstanceGroupManagerAllInstancesConfig all_instances_config = 112596737; * @return \Google\Cloud\Compute\V1\InstanceGroupManagerAllInstancesConfig|null @@ -309,7 +429,8 @@ public function clearAllInstancesConfig() } /** - * Specifies configuration that overrides the instance template configuration for the group. + * Specifies configuration that overrides the instance template configuration + * for the group. * * Generated from protobuf field optional .google.cloud.compute.v1.InstanceGroupManagerAllInstancesConfig all_instances_config = 112596737; * @param \Google\Cloud\Compute\V1\InstanceGroupManagerAllInstancesConfig $var @@ -324,7 +445,8 @@ public function setAllInstancesConfig($var) } /** - * The autohealing policy for this managed instance group. You can specify only one value. + * The autohealing policy for this managed instance group. You can specify + * only one value. * * Generated from protobuf field repeated .google.cloud.compute.v1.InstanceGroupManagerAutoHealingPolicy auto_healing_policies = 456799109; * @return \Google\Protobuf\Internal\RepeatedField @@ -335,7 +457,8 @@ public function getAutoHealingPolicies() } /** - * The autohealing policy for this managed instance group. You can specify only one value. + * The autohealing policy for this managed instance group. You can specify + * only one value. * * Generated from protobuf field repeated .google.cloud.compute.v1.InstanceGroupManagerAutoHealingPolicy auto_healing_policies = 456799109; * @param array<\Google\Cloud\Compute\V1\InstanceGroupManagerAutoHealingPolicy>|\Google\Protobuf\Internal\RepeatedField $var @@ -350,7 +473,17 @@ public function setAutoHealingPolicies($var) } /** - * The base instance name is a prefix that you want to attach to the names of all VMs in a MIG. The maximum character length is 58 and the name must comply with RFC1035 format. When a VM is created in the group, the MIG appends a hyphen and a random four-character string to the base instance name. If you want the MIG to assign sequential numbers instead of a random string, then end the base instance name with a hyphen followed by one or more hash symbols. The hash symbols indicate the number of digits. For example, a base instance name of "vm-###" results in "vm-001" as a VM name. @pattern [a-z](([-a-z0-9]{0,57})|([-a-z0-9]{0,51}-#{1,10}(\\[[0-9]{1,10}\\])?)) + * The base instance name is a prefix that you want to attach to the names of + * all VMs in a MIG. The maximum character length is 58 and the name must + * comply with RFC1035 format. + * When a VM is created in the group, the MIG appends a hyphen and a random + * four-character string to the base instance name. If you want the MIG to + * assign sequential numbers instead of a random string, then end the base + * instance name with a hyphen followed by one or more hash symbols. The hash + * symbols indicate the number of digits. For example, a base instance name of + * "vm-###" results in "vm-001" as a VM name. + * @pattern + * [a-z](([-a-z0-9]{0,57})|([-a-z0-9]{0,51}-#{1,10}(\\[[0-9]{1,10}\\])?)) * * Generated from protobuf field optional string base_instance_name = 389106439; * @return string @@ -371,7 +504,17 @@ public function clearBaseInstanceName() } /** - * The base instance name is a prefix that you want to attach to the names of all VMs in a MIG. The maximum character length is 58 and the name must comply with RFC1035 format. When a VM is created in the group, the MIG appends a hyphen and a random four-character string to the base instance name. If you want the MIG to assign sequential numbers instead of a random string, then end the base instance name with a hyphen followed by one or more hash symbols. The hash symbols indicate the number of digits. For example, a base instance name of "vm-###" results in "vm-001" as a VM name. @pattern [a-z](([-a-z0-9]{0,57})|([-a-z0-9]{0,51}-#{1,10}(\\[[0-9]{1,10}\\])?)) + * The base instance name is a prefix that you want to attach to the names of + * all VMs in a MIG. The maximum character length is 58 and the name must + * comply with RFC1035 format. + * When a VM is created in the group, the MIG appends a hyphen and a random + * four-character string to the base instance name. If you want the MIG to + * assign sequential numbers instead of a random string, then end the base + * instance name with a hyphen followed by one or more hash symbols. The hash + * symbols indicate the number of digits. For example, a base instance name of + * "vm-###" results in "vm-001" as a VM name. + * @pattern + * [a-z](([-a-z0-9]{0,57})|([-a-z0-9]{0,51}-#{1,10}(\\[[0-9]{1,10}\\])?)) * * Generated from protobuf field optional string base_instance_name = 389106439; * @param string $var @@ -386,7 +529,8 @@ public function setBaseInstanceName($var) } /** - * [Output Only] The creation timestamp for this managed instance group in RFC3339 text format. + * [Output Only] The creation timestamp for this managed instance group inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @return string @@ -407,7 +551,8 @@ public function clearCreationTimestamp() } /** - * [Output Only] The creation timestamp for this managed instance group in RFC3339 text format. + * [Output Only] The creation timestamp for this managed instance group inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @param string $var @@ -422,7 +567,9 @@ public function setCreationTimestamp($var) } /** - * [Output Only] The list of instance actions and the number of instances in this managed instance group that are scheduled for each of those actions. + * [Output Only] The list of instance actions and the number of instances + * in this managed instance group that are scheduled for each of those + * actions. * * Generated from protobuf field optional .google.cloud.compute.v1.InstanceGroupManagerActionsSummary current_actions = 164045879; * @return \Google\Cloud\Compute\V1\InstanceGroupManagerActionsSummary|null @@ -443,7 +590,9 @@ public function clearCurrentActions() } /** - * [Output Only] The list of instance actions and the number of instances in this managed instance group that are scheduled for each of those actions. + * [Output Only] The list of instance actions and the number of instances + * in this managed instance group that are scheduled for each of those + * actions. * * Generated from protobuf field optional .google.cloud.compute.v1.InstanceGroupManagerActionsSummary current_actions = 164045879; * @param \Google\Cloud\Compute\V1\InstanceGroupManagerActionsSummary $var @@ -494,7 +643,8 @@ public function setDescription($var) } /** - * Policy specifying the intended distribution of managed instances across zones in a regional managed instance group. + * Policy specifying the intended distribution of managed instances across + * zones in a regional managed instance group. * * Generated from protobuf field optional .google.cloud.compute.v1.DistributionPolicy distribution_policy = 534558541; * @return \Google\Cloud\Compute\V1\DistributionPolicy|null @@ -515,7 +665,8 @@ public function clearDistributionPolicy() } /** - * Policy specifying the intended distribution of managed instances across zones in a regional managed instance group. + * Policy specifying the intended distribution of managed instances across + * zones in a regional managed instance group. * * Generated from protobuf field optional .google.cloud.compute.v1.DistributionPolicy distribution_policy = 534558541; * @param \Google\Cloud\Compute\V1\DistributionPolicy $var @@ -530,7 +681,12 @@ public function setDistributionPolicy($var) } /** - * Fingerprint of this resource. This field may be used in optimistic locking. It will be ignored when inserting an InstanceGroupManager. An up-to-date fingerprint must be provided in order to update the InstanceGroupManager, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve an InstanceGroupManager. + * Fingerprint of this resource. This field may be used in optimistic locking. + * It will be ignored when inserting an InstanceGroupManager. An up-to-date + * fingerprint must be provided in order to update the InstanceGroupManager, + * otherwise the request will fail with error412 conditionNotMet. + * To see the latest fingerprint, make a get() request to + * retrieve an InstanceGroupManager. * * Generated from protobuf field optional string fingerprint = 234678500; * @return string @@ -551,7 +707,12 @@ public function clearFingerprint() } /** - * Fingerprint of this resource. This field may be used in optimistic locking. It will be ignored when inserting an InstanceGroupManager. An up-to-date fingerprint must be provided in order to update the InstanceGroupManager, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve an InstanceGroupManager. + * Fingerprint of this resource. This field may be used in optimistic locking. + * It will be ignored when inserting an InstanceGroupManager. An up-to-date + * fingerprint must be provided in order to update the InstanceGroupManager, + * otherwise the request will fail with error412 conditionNotMet. + * To see the latest fingerprint, make a get() request to + * retrieve an InstanceGroupManager. * * Generated from protobuf field optional string fingerprint = 234678500; * @param string $var @@ -566,7 +727,8 @@ public function setFingerprint($var) } /** - * [Output Only] A unique identifier for this resource type. The server generates this identifier. + * [Output Only] A unique identifier for this resource type. The server + * generates this identifier. * * Generated from protobuf field optional uint64 id = 3355; * @return int|string @@ -587,7 +749,8 @@ public function clearId() } /** - * [Output Only] A unique identifier for this resource type. The server generates this identifier. + * [Output Only] A unique identifier for this resource type. The server + * generates this identifier. * * Generated from protobuf field optional uint64 id = 3355; * @param int|string $var @@ -602,7 +765,10 @@ public function setId($var) } /** - * Instance flexibility allowing MIG to create VMs from multiple types of machines. Instance flexibility configuration on MIG overrides instance template configuration. + * Instance flexibility allowing MIG to create VMs from multiple + * types of machines. + * Instance flexibility configuration on MIG overrides instance + * template configuration. * * Generated from protobuf field optional .google.cloud.compute.v1.InstanceGroupManagerInstanceFlexibilityPolicy instance_flexibility_policy = 26937090; * @return \Google\Cloud\Compute\V1\InstanceGroupManagerInstanceFlexibilityPolicy|null @@ -623,7 +789,10 @@ public function clearInstanceFlexibilityPolicy() } /** - * Instance flexibility allowing MIG to create VMs from multiple types of machines. Instance flexibility configuration on MIG overrides instance template configuration. + * Instance flexibility allowing MIG to create VMs from multiple + * types of machines. + * Instance flexibility configuration on MIG overrides instance + * template configuration. * * Generated from protobuf field optional .google.cloud.compute.v1.InstanceGroupManagerInstanceFlexibilityPolicy instance_flexibility_policy = 26937090; * @param \Google\Cloud\Compute\V1\InstanceGroupManagerInstanceFlexibilityPolicy $var @@ -710,7 +879,10 @@ public function setInstanceLifecyclePolicy($var) } /** - * The URL of the instance template that is specified for this managed instance group. The group uses this template to create all new instances in the managed instance group. The templates for existing instances in the group do not change unless you run recreateInstances, run applyUpdatesToInstances, or set the group's updatePolicy.type to PROACTIVE. + * The URL of the instance template that is specified for this managed + * instance group. The group uses this template to create all new instances + * in the managed instance group. The templates for existing instances in the + * group do not change unless you run recreateInstances, runapplyUpdatesToInstances, or set the group'supdatePolicy.type to PROACTIVE. * * Generated from protobuf field optional string instance_template = 309248228; * @return string @@ -731,7 +903,10 @@ public function clearInstanceTemplate() } /** - * The URL of the instance template that is specified for this managed instance group. The group uses this template to create all new instances in the managed instance group. The templates for existing instances in the group do not change unless you run recreateInstances, run applyUpdatesToInstances, or set the group's updatePolicy.type to PROACTIVE. + * The URL of the instance template that is specified for this managed + * instance group. The group uses this template to create all new instances + * in the managed instance group. The templates for existing instances in the + * group do not change unless you run recreateInstances, runapplyUpdatesToInstances, or set the group'supdatePolicy.type to PROACTIVE. * * Generated from protobuf field optional string instance_template = 309248228; * @param string $var @@ -746,7 +921,7 @@ public function setInstanceTemplate($var) } /** - * [Output Only] The resource type, which is always compute#instanceGroupManager for managed instance groups. + * [Output Only] The resource type, which is alwayscompute#instanceGroupManager for managed instance groups. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -767,7 +942,7 @@ public function clearKind() } /** - * [Output Only] The resource type, which is always compute#instanceGroupManager for managed instance groups. + * [Output Only] The resource type, which is alwayscompute#instanceGroupManager for managed instance groups. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -782,7 +957,8 @@ public function setKind($var) } /** - * Pagination behavior of the listManagedInstances API method for this managed instance group. + * Pagination behavior of the listManagedInstances API method for + * this managed instance group. * Check the ListManagedInstancesResults enum for the list of possible values. * * Generated from protobuf field optional string list_managed_instances_results = 296047156; @@ -804,7 +980,8 @@ public function clearListManagedInstancesResults() } /** - * Pagination behavior of the listManagedInstances API method for this managed instance group. + * Pagination behavior of the listManagedInstances API method for + * this managed instance group. * Check the ListManagedInstancesResults enum for the list of possible values. * * Generated from protobuf field optional string list_managed_instances_results = 296047156; @@ -820,7 +997,8 @@ public function setListManagedInstancesResults($var) } /** - * The name of the managed instance group. The name must be 1-63 characters long, and comply with RFC1035. + * The name of the managed instance group. The name must be 1-63 characters + * long, and comply withRFC1035. * * Generated from protobuf field optional string name = 3373707; * @return string @@ -841,7 +1019,8 @@ public function clearName() } /** - * The name of the managed instance group. The name must be 1-63 characters long, and comply with RFC1035. + * The name of the managed instance group. The name must be 1-63 characters + * long, and comply withRFC1035. * * Generated from protobuf field optional string name = 3373707; * @param string $var @@ -856,7 +1035,8 @@ public function setName($var) } /** - * [Output Only] Named ports configured on the Instance Groups complementary to this Instance Group Manager. + * [Output Only] Named ports configured on the Instance Groups complementary + * to this Instance Group Manager. * * Generated from protobuf field repeated .google.cloud.compute.v1.NamedPort named_ports = 427598732; * @return \Google\Protobuf\Internal\RepeatedField @@ -867,7 +1047,8 @@ public function getNamedPorts() } /** - * [Output Only] Named ports configured on the Instance Groups complementary to this Instance Group Manager. + * [Output Only] Named ports configured on the Instance Groups complementary + * to this Instance Group Manager. * * Generated from protobuf field repeated .google.cloud.compute.v1.NamedPort named_ports = 427598732; * @param array<\Google\Cloud\Compute\V1\NamedPort>|\Google\Protobuf\Internal\RepeatedField $var @@ -882,7 +1063,8 @@ public function setNamedPorts($var) } /** - * [Output Only] The URL of the region where the managed instance group resides (for regional resources). + * [Output Only] The URL of theregion + * where the managed instance group resides (for regional resources). * * Generated from protobuf field optional string region = 138946292; * @return string @@ -903,7 +1085,8 @@ public function clearRegion() } /** - * [Output Only] The URL of the region where the managed instance group resides (for regional resources). + * [Output Only] The URL of theregion + * where the managed instance group resides (for regional resources). * * Generated from protobuf field optional string region = 138946292; * @param string $var @@ -1026,7 +1209,8 @@ public function setSatisfiesPzs($var) } /** - * [Output Only] The URL for this managed instance group. The server defines this URL. + * [Output Only] The URL for this managed instance group. The server defines + * this URL. * * Generated from protobuf field optional string self_link = 456214797; * @return string @@ -1047,7 +1231,8 @@ public function clearSelfLink() } /** - * [Output Only] The URL for this managed instance group. The server defines this URL. + * [Output Only] The URL for this managed instance group. The server defines + * this URL. * * Generated from protobuf field optional string self_link = 456214797; * @param string $var @@ -1170,7 +1355,8 @@ public function setStatus($var) } /** - * The URLs for all TargetPool resources to which instances in the instanceGroup field are added. The target pools automatically apply to all of the instances in the managed instance group. + * The URLs for all TargetPool resources to which instances in theinstanceGroup field are added. The target pools automatically + * apply to all of the instances in the managed instance group. * * Generated from protobuf field repeated string target_pools = 336072617; * @return \Google\Protobuf\Internal\RepeatedField @@ -1181,7 +1367,8 @@ public function getTargetPools() } /** - * The URLs for all TargetPool resources to which instances in the instanceGroup field are added. The target pools automatically apply to all of the instances in the managed instance group. + * The URLs for all TargetPool resources to which instances in theinstanceGroup field are added. The target pools automatically + * apply to all of the instances in the managed instance group. * * Generated from protobuf field repeated string target_pools = 336072617; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -1196,7 +1383,10 @@ public function setTargetPools($var) } /** - * The target number of running instances for this managed instance group. You can reduce this number by using the instanceGroupManager deleteInstances or abandonInstances methods. Resizing the group also changes this number. + * The target number of running instances for this managed instance group. + * You can reduce this number by using the instanceGroupManager + * deleteInstances or abandonInstances methods. Resizing the group also + * changes this number. * * Generated from protobuf field optional int32 target_size = 62880239; * @return int @@ -1217,7 +1407,10 @@ public function clearTargetSize() } /** - * The target number of running instances for this managed instance group. You can reduce this number by using the instanceGroupManager deleteInstances or abandonInstances methods. Resizing the group also changes this number. + * The target number of running instances for this managed instance group. + * You can reduce this number by using the instanceGroupManager + * deleteInstances or abandonInstances methods. Resizing the group also + * changes this number. * * Generated from protobuf field optional int32 target_size = 62880239; * @param int $var @@ -1232,7 +1425,13 @@ public function setTargetSize($var) } /** - * The target number of stopped instances for this managed instance group. This number changes when you: - Stop instance using the stopInstances method or start instances using the startInstances method. - Manually change the targetStoppedSize using the update method. + * The target number of stopped instances for this managed instance group. + * This number changes when you: + * - Stop instance using the stopInstances + * method or start instances using the startInstances + * method. + * - Manually change the targetStoppedSize using the update + * method. * * Generated from protobuf field optional int32 target_stopped_size = 2419489; * @return int @@ -1253,7 +1452,13 @@ public function clearTargetStoppedSize() } /** - * The target number of stopped instances for this managed instance group. This number changes when you: - Stop instance using the stopInstances method or start instances using the startInstances method. - Manually change the targetStoppedSize using the update method. + * The target number of stopped instances for this managed instance group. + * This number changes when you: + * - Stop instance using the stopInstances + * method or start instances using the startInstances + * method. + * - Manually change the targetStoppedSize using the update + * method. * * Generated from protobuf field optional int32 target_stopped_size = 2419489; * @param int $var @@ -1268,7 +1473,13 @@ public function setTargetStoppedSize($var) } /** - * The target number of suspended instances for this managed instance group. This number changes when you: - Suspend instance using the suspendInstances method or resume instances using the resumeInstances method. - Manually change the targetSuspendedSize using the update method. + * The target number of suspended instances for this managed instance group. + * This number changes when you: + * - Suspend instance using the suspendInstances + * method or resume instances using the resumeInstances + * method. + * - Manually change the targetSuspendedSize using the update + * method. * * Generated from protobuf field optional int32 target_suspended_size = 308085843; * @return int @@ -1289,7 +1500,13 @@ public function clearTargetSuspendedSize() } /** - * The target number of suspended instances for this managed instance group. This number changes when you: - Suspend instance using the suspendInstances method or resume instances using the resumeInstances method. - Manually change the targetSuspendedSize using the update method. + * The target number of suspended instances for this managed instance group. + * This number changes when you: + * - Suspend instance using the suspendInstances + * method or resume instances using the resumeInstances + * method. + * - Manually change the targetSuspendedSize using the update + * method. * * Generated from protobuf field optional int32 target_suspended_size = 308085843; * @param int $var @@ -1340,7 +1557,14 @@ public function setUpdatePolicy($var) } /** - * Specifies the instance templates used by this managed instance group to create instances. Each version is defined by an instanceTemplate and a name. Every version can appear at most once per instance group. This field overrides the top-level instanceTemplate field. Read more about the relationships between these fields. Exactly one version must leave the targetSize field unset. That version will be applied to all remaining instances. For more information, read about canary updates. + * Specifies the instance templates used by this managed instance group to + * create instances. + * Each version is defined by an instanceTemplate and aname. Every version can appear at most once per instance + * group. This field overrides the top-level instanceTemplate + * field. Read more about therelationships + * between these fields. Exactly one version must leave thetargetSize field unset. That version will be applied to all + * remaining instances. For more information, read aboutcanary + * updates. * * Generated from protobuf field repeated .google.cloud.compute.v1.InstanceGroupManagerVersion versions = 162430619; * @return \Google\Protobuf\Internal\RepeatedField @@ -1351,7 +1575,14 @@ public function getVersions() } /** - * Specifies the instance templates used by this managed instance group to create instances. Each version is defined by an instanceTemplate and a name. Every version can appear at most once per instance group. This field overrides the top-level instanceTemplate field. Read more about the relationships between these fields. Exactly one version must leave the targetSize field unset. That version will be applied to all remaining instances. For more information, read about canary updates. + * Specifies the instance templates used by this managed instance group to + * create instances. + * Each version is defined by an instanceTemplate and aname. Every version can appear at most once per instance + * group. This field overrides the top-level instanceTemplate + * field. Read more about therelationships + * between these fields. Exactly one version must leave thetargetSize field unset. That version will be applied to all + * remaining instances. For more information, read aboutcanary + * updates. * * Generated from protobuf field repeated .google.cloud.compute.v1.InstanceGroupManagerVersion versions = 162430619; * @param array<\Google\Cloud\Compute\V1\InstanceGroupManagerVersion>|\Google\Protobuf\Internal\RepeatedField $var @@ -1366,7 +1597,8 @@ public function setVersions($var) } /** - * [Output Only] The URL of a zone where the managed instance group is located (for zonal resources). + * [Output Only] The URL of azone + * where the managed instance group is located (for zonal resources). * * Generated from protobuf field optional string zone = 3744684; * @return string @@ -1387,7 +1619,8 @@ public function clearZone() } /** - * [Output Only] The URL of a zone where the managed instance group is located (for zonal resources). + * [Output Only] The URL of azone + * where the managed instance group is located (for zonal resources). * * Generated from protobuf field optional string zone = 3744684; * @param string $var diff --git a/Compute/src/V1/InstanceGroupManager/ListManagedInstancesResults.php b/Compute/src/V1/InstanceGroupManager/ListManagedInstancesResults.php index e2b36ac12aa1..5b05ee6d65cd 100644 --- a/Compute/src/V1/InstanceGroupManager/ListManagedInstancesResults.php +++ b/Compute/src/V1/InstanceGroupManager/ListManagedInstancesResults.php @@ -7,7 +7,8 @@ use UnexpectedValueException; /** - * Pagination behavior of the listManagedInstances API method for this managed instance group. + * Pagination behavior of the listManagedInstances API method for + * this managed instance group. * * Protobuf type google.cloud.compute.v1.InstanceGroupManager.ListManagedInstancesResults */ @@ -20,13 +21,17 @@ class ListManagedInstancesResults */ const UNDEFINED_LIST_MANAGED_INSTANCES_RESULTS = 0; /** - * (Default) Pagination is disabled for the group's listManagedInstances API method. maxResults and pageToken query parameters are ignored and all instances are returned in a single response. + * (Default) Pagination is disabled for the group'slistManagedInstances API method. maxResults + * and pageToken query parameters are ignored and all + * instances are returned in a single response. * * Generated from protobuf enum PAGELESS = 32183464; */ const PAGELESS = 32183464; /** - * Pagination is enabled for the group's listManagedInstances API method. maxResults and pageToken query parameters are respected. + * Pagination is enabled for the group's listManagedInstances + * API method. maxResults and pageToken query + * parameters are respected. * * Generated from protobuf enum PAGINATED = 40190637; */ diff --git a/Compute/src/V1/InstanceGroupManagerActionsSummary.php b/Compute/src/V1/InstanceGroupManagerActionsSummary.php index 941dcf658fec..94918063b19d 100644 --- a/Compute/src/V1/InstanceGroupManagerActionsSummary.php +++ b/Compute/src/V1/InstanceGroupManagerActionsSummary.php @@ -15,79 +15,105 @@ class InstanceGroupManagerActionsSummary extends \Google\Protobuf\Internal\Message { /** - * [Output Only] The total number of instances in the managed instance group that are scheduled to be abandoned. Abandoning an instance removes it from the managed instance group without deleting it. + * [Output Only] The total number of instances in the managed instance group + * that are scheduled to be abandoned. Abandoning an instance removes it + * from the managed instance group without deleting it. * * Generated from protobuf field optional int32 abandoning = 440023373; */ protected $abandoning = null; /** - * [Output Only] The number of instances in the managed instance group that are scheduled to be created or are currently being created. If the group fails to create any of these instances, it tries again until it creates the instance successfully. If you have disabled creation retries, this field will not be populated; instead, the creatingWithoutRetries field will be populated. + * [Output Only] The number of instances in the managed instance group that + * are scheduled to be created or are currently being created. If the group + * fails to create any of these instances, it tries again until it creates + * the instance successfully. + * If you have disabled creation retries, this field will not be populated; + * instead, the creatingWithoutRetries field will be populated. * * Generated from protobuf field optional int32 creating = 209809081; */ protected $creating = null; /** - * [Output Only] The number of instances that the managed instance group will attempt to create. The group attempts to create each instance only once. If the group fails to create any of these instances, it decreases the group's targetSize value accordingly. + * [Output Only] The number of instances that the managed instance group + * will attempt to create. The group attempts to create each instance + * only once. If the group fails to create any of these instances, it + * decreases the group's targetSize value accordingly. * * Generated from protobuf field optional int32 creating_without_retries = 369916745; */ protected $creating_without_retries = null; /** - * [Output Only] The number of instances in the managed instance group that are scheduled to be deleted or are currently being deleted. + * [Output Only] The number of instances in the managed instance group that + * are scheduled to be deleted or are currently being deleted. * * Generated from protobuf field optional int32 deleting = 282846120; */ protected $deleting = null; /** - * [Output Only] The number of instances in the managed instance group that are running and have no scheduled actions. + * [Output Only] The number of instances in the managed instance group that + * are running and have no scheduled actions. * * Generated from protobuf field optional int32 none = 3387192; */ protected $none = null; /** - * [Output Only] The number of instances in the managed instance group that are scheduled to be recreated or are currently being being recreated. Recreating an instance deletes the existing root persistent disk and creates a new disk from the image that is defined in the instance template. + * [Output Only] The number of instances in the managed instance group that + * are scheduled to be recreated or are currently being being recreated. + * Recreating an instance deletes the existing root persistent disk + * and creates a new disk from the image that is defined in the + * instance template. * * Generated from protobuf field optional int32 recreating = 339057132; */ protected $recreating = null; /** - * [Output Only] The number of instances in the managed instance group that are being reconfigured with properties that do not require a restart or a recreate action. For example, setting or removing target pools for the instance. + * [Output Only] The number of instances in the managed instance group that + * are being reconfigured with properties that do not require a restart + * or a recreate action. For example, setting or removing target + * pools for the instance. * * Generated from protobuf field optional int32 refreshing = 215044903; */ protected $refreshing = null; /** - * [Output Only] The number of instances in the managed instance group that are scheduled to be restarted or are currently being restarted. + * [Output Only] The number of instances in the managed instance group that + * are scheduled to be restarted or are currently being restarted. * * Generated from protobuf field optional int32 restarting = 372312947; */ protected $restarting = null; /** - * [Output Only] The number of instances in the managed instance group that are scheduled to be resumed or are currently being resumed. + * [Output Only] The number of instances in the managed instance group that + * are scheduled to be resumed or are currently being resumed. * * Generated from protobuf field optional int32 resuming = 201100714; */ protected $resuming = null; /** - * [Output Only] The number of instances in the managed instance group that are scheduled to be started or are currently being started. + * [Output Only] The number of instances in the managed instance group that + * are scheduled to be started or are currently being started. * * Generated from protobuf field optional int32 starting = 243064896; */ protected $starting = null; /** - * [Output Only] The number of instances in the managed instance group that are scheduled to be stopped or are currently being stopped. + * [Output Only] The number of instances in the managed instance group that + * are scheduled to be stopped or are currently being stopped. * * Generated from protobuf field optional int32 stopping = 105035892; */ protected $stopping = null; /** - * [Output Only] The number of instances in the managed instance group that are scheduled to be suspended or are currently being suspended. + * [Output Only] The number of instances in the managed instance group that + * are scheduled to be suspended or are currently being suspended. * * Generated from protobuf field optional int32 suspending = 29113894; */ protected $suspending = null; /** - * [Output Only] The number of instances in the managed instance group that are being verified. See the managedInstances[].currentAction property in the listManagedInstances method documentation. + * [Output Only] The number of instances in the managed instance group that + * are being verified. See the managedInstances[].currentAction + * property in the listManagedInstances method documentation. * * Generated from protobuf field optional int32 verifying = 451612873; */ @@ -100,31 +126,57 @@ class InstanceGroupManagerActionsSummary extends \Google\Protobuf\Internal\Messa * Optional. Data for populating the Message object. * * @type int $abandoning - * [Output Only] The total number of instances in the managed instance group that are scheduled to be abandoned. Abandoning an instance removes it from the managed instance group without deleting it. + * [Output Only] The total number of instances in the managed instance group + * that are scheduled to be abandoned. Abandoning an instance removes it + * from the managed instance group without deleting it. * @type int $creating - * [Output Only] The number of instances in the managed instance group that are scheduled to be created or are currently being created. If the group fails to create any of these instances, it tries again until it creates the instance successfully. If you have disabled creation retries, this field will not be populated; instead, the creatingWithoutRetries field will be populated. + * [Output Only] The number of instances in the managed instance group that + * are scheduled to be created or are currently being created. If the group + * fails to create any of these instances, it tries again until it creates + * the instance successfully. + * If you have disabled creation retries, this field will not be populated; + * instead, the creatingWithoutRetries field will be populated. * @type int $creating_without_retries - * [Output Only] The number of instances that the managed instance group will attempt to create. The group attempts to create each instance only once. If the group fails to create any of these instances, it decreases the group's targetSize value accordingly. + * [Output Only] The number of instances that the managed instance group + * will attempt to create. The group attempts to create each instance + * only once. If the group fails to create any of these instances, it + * decreases the group's targetSize value accordingly. * @type int $deleting - * [Output Only] The number of instances in the managed instance group that are scheduled to be deleted or are currently being deleted. + * [Output Only] The number of instances in the managed instance group that + * are scheduled to be deleted or are currently being deleted. * @type int $none - * [Output Only] The number of instances in the managed instance group that are running and have no scheduled actions. + * [Output Only] The number of instances in the managed instance group that + * are running and have no scheduled actions. * @type int $recreating - * [Output Only] The number of instances in the managed instance group that are scheduled to be recreated or are currently being being recreated. Recreating an instance deletes the existing root persistent disk and creates a new disk from the image that is defined in the instance template. + * [Output Only] The number of instances in the managed instance group that + * are scheduled to be recreated or are currently being being recreated. + * Recreating an instance deletes the existing root persistent disk + * and creates a new disk from the image that is defined in the + * instance template. * @type int $refreshing - * [Output Only] The number of instances in the managed instance group that are being reconfigured with properties that do not require a restart or a recreate action. For example, setting or removing target pools for the instance. + * [Output Only] The number of instances in the managed instance group that + * are being reconfigured with properties that do not require a restart + * or a recreate action. For example, setting or removing target + * pools for the instance. * @type int $restarting - * [Output Only] The number of instances in the managed instance group that are scheduled to be restarted or are currently being restarted. + * [Output Only] The number of instances in the managed instance group that + * are scheduled to be restarted or are currently being restarted. * @type int $resuming - * [Output Only] The number of instances in the managed instance group that are scheduled to be resumed or are currently being resumed. + * [Output Only] The number of instances in the managed instance group that + * are scheduled to be resumed or are currently being resumed. * @type int $starting - * [Output Only] The number of instances in the managed instance group that are scheduled to be started or are currently being started. + * [Output Only] The number of instances in the managed instance group that + * are scheduled to be started or are currently being started. * @type int $stopping - * [Output Only] The number of instances in the managed instance group that are scheduled to be stopped or are currently being stopped. + * [Output Only] The number of instances in the managed instance group that + * are scheduled to be stopped or are currently being stopped. * @type int $suspending - * [Output Only] The number of instances in the managed instance group that are scheduled to be suspended or are currently being suspended. + * [Output Only] The number of instances in the managed instance group that + * are scheduled to be suspended or are currently being suspended. * @type int $verifying - * [Output Only] The number of instances in the managed instance group that are being verified. See the managedInstances[].currentAction property in the listManagedInstances method documentation. + * [Output Only] The number of instances in the managed instance group that + * are being verified. See the managedInstances[].currentAction + * property in the listManagedInstances method documentation. * } */ public function __construct($data = NULL) { @@ -133,7 +185,9 @@ public function __construct($data = NULL) { } /** - * [Output Only] The total number of instances in the managed instance group that are scheduled to be abandoned. Abandoning an instance removes it from the managed instance group without deleting it. + * [Output Only] The total number of instances in the managed instance group + * that are scheduled to be abandoned. Abandoning an instance removes it + * from the managed instance group without deleting it. * * Generated from protobuf field optional int32 abandoning = 440023373; * @return int @@ -154,7 +208,9 @@ public function clearAbandoning() } /** - * [Output Only] The total number of instances in the managed instance group that are scheduled to be abandoned. Abandoning an instance removes it from the managed instance group without deleting it. + * [Output Only] The total number of instances in the managed instance group + * that are scheduled to be abandoned. Abandoning an instance removes it + * from the managed instance group without deleting it. * * Generated from protobuf field optional int32 abandoning = 440023373; * @param int $var @@ -169,7 +225,12 @@ public function setAbandoning($var) } /** - * [Output Only] The number of instances in the managed instance group that are scheduled to be created or are currently being created. If the group fails to create any of these instances, it tries again until it creates the instance successfully. If you have disabled creation retries, this field will not be populated; instead, the creatingWithoutRetries field will be populated. + * [Output Only] The number of instances in the managed instance group that + * are scheduled to be created or are currently being created. If the group + * fails to create any of these instances, it tries again until it creates + * the instance successfully. + * If you have disabled creation retries, this field will not be populated; + * instead, the creatingWithoutRetries field will be populated. * * Generated from protobuf field optional int32 creating = 209809081; * @return int @@ -190,7 +251,12 @@ public function clearCreating() } /** - * [Output Only] The number of instances in the managed instance group that are scheduled to be created or are currently being created. If the group fails to create any of these instances, it tries again until it creates the instance successfully. If you have disabled creation retries, this field will not be populated; instead, the creatingWithoutRetries field will be populated. + * [Output Only] The number of instances in the managed instance group that + * are scheduled to be created or are currently being created. If the group + * fails to create any of these instances, it tries again until it creates + * the instance successfully. + * If you have disabled creation retries, this field will not be populated; + * instead, the creatingWithoutRetries field will be populated. * * Generated from protobuf field optional int32 creating = 209809081; * @param int $var @@ -205,7 +271,10 @@ public function setCreating($var) } /** - * [Output Only] The number of instances that the managed instance group will attempt to create. The group attempts to create each instance only once. If the group fails to create any of these instances, it decreases the group's targetSize value accordingly. + * [Output Only] The number of instances that the managed instance group + * will attempt to create. The group attempts to create each instance + * only once. If the group fails to create any of these instances, it + * decreases the group's targetSize value accordingly. * * Generated from protobuf field optional int32 creating_without_retries = 369916745; * @return int @@ -226,7 +295,10 @@ public function clearCreatingWithoutRetries() } /** - * [Output Only] The number of instances that the managed instance group will attempt to create. The group attempts to create each instance only once. If the group fails to create any of these instances, it decreases the group's targetSize value accordingly. + * [Output Only] The number of instances that the managed instance group + * will attempt to create. The group attempts to create each instance + * only once. If the group fails to create any of these instances, it + * decreases the group's targetSize value accordingly. * * Generated from protobuf field optional int32 creating_without_retries = 369916745; * @param int $var @@ -241,7 +313,8 @@ public function setCreatingWithoutRetries($var) } /** - * [Output Only] The number of instances in the managed instance group that are scheduled to be deleted or are currently being deleted. + * [Output Only] The number of instances in the managed instance group that + * are scheduled to be deleted or are currently being deleted. * * Generated from protobuf field optional int32 deleting = 282846120; * @return int @@ -262,7 +335,8 @@ public function clearDeleting() } /** - * [Output Only] The number of instances in the managed instance group that are scheduled to be deleted or are currently being deleted. + * [Output Only] The number of instances in the managed instance group that + * are scheduled to be deleted or are currently being deleted. * * Generated from protobuf field optional int32 deleting = 282846120; * @param int $var @@ -277,7 +351,8 @@ public function setDeleting($var) } /** - * [Output Only] The number of instances in the managed instance group that are running and have no scheduled actions. + * [Output Only] The number of instances in the managed instance group that + * are running and have no scheduled actions. * * Generated from protobuf field optional int32 none = 3387192; * @return int @@ -298,7 +373,8 @@ public function clearNone() } /** - * [Output Only] The number of instances in the managed instance group that are running and have no scheduled actions. + * [Output Only] The number of instances in the managed instance group that + * are running and have no scheduled actions. * * Generated from protobuf field optional int32 none = 3387192; * @param int $var @@ -313,7 +389,11 @@ public function setNone($var) } /** - * [Output Only] The number of instances in the managed instance group that are scheduled to be recreated or are currently being being recreated. Recreating an instance deletes the existing root persistent disk and creates a new disk from the image that is defined in the instance template. + * [Output Only] The number of instances in the managed instance group that + * are scheduled to be recreated or are currently being being recreated. + * Recreating an instance deletes the existing root persistent disk + * and creates a new disk from the image that is defined in the + * instance template. * * Generated from protobuf field optional int32 recreating = 339057132; * @return int @@ -334,7 +414,11 @@ public function clearRecreating() } /** - * [Output Only] The number of instances in the managed instance group that are scheduled to be recreated or are currently being being recreated. Recreating an instance deletes the existing root persistent disk and creates a new disk from the image that is defined in the instance template. + * [Output Only] The number of instances in the managed instance group that + * are scheduled to be recreated or are currently being being recreated. + * Recreating an instance deletes the existing root persistent disk + * and creates a new disk from the image that is defined in the + * instance template. * * Generated from protobuf field optional int32 recreating = 339057132; * @param int $var @@ -349,7 +433,10 @@ public function setRecreating($var) } /** - * [Output Only] The number of instances in the managed instance group that are being reconfigured with properties that do not require a restart or a recreate action. For example, setting or removing target pools for the instance. + * [Output Only] The number of instances in the managed instance group that + * are being reconfigured with properties that do not require a restart + * or a recreate action. For example, setting or removing target + * pools for the instance. * * Generated from protobuf field optional int32 refreshing = 215044903; * @return int @@ -370,7 +457,10 @@ public function clearRefreshing() } /** - * [Output Only] The number of instances in the managed instance group that are being reconfigured with properties that do not require a restart or a recreate action. For example, setting or removing target pools for the instance. + * [Output Only] The number of instances in the managed instance group that + * are being reconfigured with properties that do not require a restart + * or a recreate action. For example, setting or removing target + * pools for the instance. * * Generated from protobuf field optional int32 refreshing = 215044903; * @param int $var @@ -385,7 +475,8 @@ public function setRefreshing($var) } /** - * [Output Only] The number of instances in the managed instance group that are scheduled to be restarted or are currently being restarted. + * [Output Only] The number of instances in the managed instance group that + * are scheduled to be restarted or are currently being restarted. * * Generated from protobuf field optional int32 restarting = 372312947; * @return int @@ -406,7 +497,8 @@ public function clearRestarting() } /** - * [Output Only] The number of instances in the managed instance group that are scheduled to be restarted or are currently being restarted. + * [Output Only] The number of instances in the managed instance group that + * are scheduled to be restarted or are currently being restarted. * * Generated from protobuf field optional int32 restarting = 372312947; * @param int $var @@ -421,7 +513,8 @@ public function setRestarting($var) } /** - * [Output Only] The number of instances in the managed instance group that are scheduled to be resumed or are currently being resumed. + * [Output Only] The number of instances in the managed instance group that + * are scheduled to be resumed or are currently being resumed. * * Generated from protobuf field optional int32 resuming = 201100714; * @return int @@ -442,7 +535,8 @@ public function clearResuming() } /** - * [Output Only] The number of instances in the managed instance group that are scheduled to be resumed or are currently being resumed. + * [Output Only] The number of instances in the managed instance group that + * are scheduled to be resumed or are currently being resumed. * * Generated from protobuf field optional int32 resuming = 201100714; * @param int $var @@ -457,7 +551,8 @@ public function setResuming($var) } /** - * [Output Only] The number of instances in the managed instance group that are scheduled to be started or are currently being started. + * [Output Only] The number of instances in the managed instance group that + * are scheduled to be started or are currently being started. * * Generated from protobuf field optional int32 starting = 243064896; * @return int @@ -478,7 +573,8 @@ public function clearStarting() } /** - * [Output Only] The number of instances in the managed instance group that are scheduled to be started or are currently being started. + * [Output Only] The number of instances in the managed instance group that + * are scheduled to be started or are currently being started. * * Generated from protobuf field optional int32 starting = 243064896; * @param int $var @@ -493,7 +589,8 @@ public function setStarting($var) } /** - * [Output Only] The number of instances in the managed instance group that are scheduled to be stopped or are currently being stopped. + * [Output Only] The number of instances in the managed instance group that + * are scheduled to be stopped or are currently being stopped. * * Generated from protobuf field optional int32 stopping = 105035892; * @return int @@ -514,7 +611,8 @@ public function clearStopping() } /** - * [Output Only] The number of instances in the managed instance group that are scheduled to be stopped or are currently being stopped. + * [Output Only] The number of instances in the managed instance group that + * are scheduled to be stopped or are currently being stopped. * * Generated from protobuf field optional int32 stopping = 105035892; * @param int $var @@ -529,7 +627,8 @@ public function setStopping($var) } /** - * [Output Only] The number of instances in the managed instance group that are scheduled to be suspended or are currently being suspended. + * [Output Only] The number of instances in the managed instance group that + * are scheduled to be suspended or are currently being suspended. * * Generated from protobuf field optional int32 suspending = 29113894; * @return int @@ -550,7 +649,8 @@ public function clearSuspending() } /** - * [Output Only] The number of instances in the managed instance group that are scheduled to be suspended or are currently being suspended. + * [Output Only] The number of instances in the managed instance group that + * are scheduled to be suspended or are currently being suspended. * * Generated from protobuf field optional int32 suspending = 29113894; * @param int $var @@ -565,7 +665,9 @@ public function setSuspending($var) } /** - * [Output Only] The number of instances in the managed instance group that are being verified. See the managedInstances[].currentAction property in the listManagedInstances method documentation. + * [Output Only] The number of instances in the managed instance group that + * are being verified. See the managedInstances[].currentAction + * property in the listManagedInstances method documentation. * * Generated from protobuf field optional int32 verifying = 451612873; * @return int @@ -586,7 +688,9 @@ public function clearVerifying() } /** - * [Output Only] The number of instances in the managed instance group that are being verified. See the managedInstances[].currentAction property in the listManagedInstances method documentation. + * [Output Only] The number of instances in the managed instance group that + * are being verified. See the managedInstances[].currentAction + * property in the listManagedInstances method documentation. * * Generated from protobuf field optional int32 verifying = 451612873; * @param int $var diff --git a/Compute/src/V1/InstanceGroupManagerAggregatedList.php b/Compute/src/V1/InstanceGroupManagerAggregatedList.php index 09eacd31b050..4232f50ca66d 100644 --- a/Compute/src/V1/InstanceGroupManagerAggregatedList.php +++ b/Compute/src/V1/InstanceGroupManagerAggregatedList.php @@ -27,13 +27,18 @@ class InstanceGroupManagerAggregatedList extends \Google\Protobuf\Internal\Messa */ private $items; /** - * [Output Only] The resource type, which is always compute#instanceGroupManagerAggregatedList for an aggregated list of managed instance groups. + * [Output Only] The resource type, which is alwayscompute#instanceGroupManagerAggregatedList for an aggregated + * list of managed instance groups. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -68,9 +73,14 @@ class InstanceGroupManagerAggregatedList extends \Google\Protobuf\Internal\Messa * @type array|\Google\Protobuf\Internal\MapField $items * A list of InstanceGroupManagersScopedList resources. * @type string $kind - * [Output Only] The resource type, which is always compute#instanceGroupManagerAggregatedList for an aggregated list of managed instance groups. + * [Output Only] The resource type, which is alwayscompute#instanceGroupManagerAggregatedList for an aggregated + * list of managed instance groups. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type array|\Google\Protobuf\Internal\RepeatedField $unreachables @@ -147,7 +157,8 @@ public function setItems($var) } /** - * [Output Only] The resource type, which is always compute#instanceGroupManagerAggregatedList for an aggregated list of managed instance groups. + * [Output Only] The resource type, which is alwayscompute#instanceGroupManagerAggregatedList for an aggregated + * list of managed instance groups. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -168,7 +179,8 @@ public function clearKind() } /** - * [Output Only] The resource type, which is always compute#instanceGroupManagerAggregatedList for an aggregated list of managed instance groups. + * [Output Only] The resource type, which is alwayscompute#instanceGroupManagerAggregatedList for an aggregated + * list of managed instance groups. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -183,7 +195,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -204,7 +220,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/InstanceGroupManagerAllInstancesConfig.php b/Compute/src/V1/InstanceGroupManagerAllInstancesConfig.php index dd647de1728d..5f2293e93080 100644 --- a/Compute/src/V1/InstanceGroupManagerAllInstancesConfig.php +++ b/Compute/src/V1/InstanceGroupManagerAllInstancesConfig.php @@ -15,7 +15,11 @@ class InstanceGroupManagerAllInstancesConfig extends \Google\Protobuf\Internal\Message { /** - * Properties to set on all instances in the group. You can add or modify properties using the instanceGroupManagers.patch or regionInstanceGroupManagers.patch. After setting allInstancesConfig on the group, you must update the group's instances to apply the configuration. To apply the configuration, set the group's updatePolicy.type field to use proactive updates or use the applyUpdatesToInstances method. + * Properties to set on all instances in the group. + * You can add or modify properties using theinstanceGroupManagers.patch orregionInstanceGroupManagers.patch. After settingallInstancesConfig on the group, you must update the group's + * instances to apply the configuration. To apply the configuration, set the + * group's updatePolicy.type field to use proactive updates or + * use the applyUpdatesToInstances method. * * Generated from protobuf field optional .google.cloud.compute.v1.InstancePropertiesPatch properties = 147688755; */ @@ -28,7 +32,11 @@ class InstanceGroupManagerAllInstancesConfig extends \Google\Protobuf\Internal\M * Optional. Data for populating the Message object. * * @type \Google\Cloud\Compute\V1\InstancePropertiesPatch $properties - * Properties to set on all instances in the group. You can add or modify properties using the instanceGroupManagers.patch or regionInstanceGroupManagers.patch. After setting allInstancesConfig on the group, you must update the group's instances to apply the configuration. To apply the configuration, set the group's updatePolicy.type field to use proactive updates or use the applyUpdatesToInstances method. + * Properties to set on all instances in the group. + * You can add or modify properties using theinstanceGroupManagers.patch orregionInstanceGroupManagers.patch. After settingallInstancesConfig on the group, you must update the group's + * instances to apply the configuration. To apply the configuration, set the + * group's updatePolicy.type field to use proactive updates or + * use the applyUpdatesToInstances method. * } */ public function __construct($data = NULL) { @@ -37,7 +45,11 @@ public function __construct($data = NULL) { } /** - * Properties to set on all instances in the group. You can add or modify properties using the instanceGroupManagers.patch or regionInstanceGroupManagers.patch. After setting allInstancesConfig on the group, you must update the group's instances to apply the configuration. To apply the configuration, set the group's updatePolicy.type field to use proactive updates or use the applyUpdatesToInstances method. + * Properties to set on all instances in the group. + * You can add or modify properties using theinstanceGroupManagers.patch orregionInstanceGroupManagers.patch. After settingallInstancesConfig on the group, you must update the group's + * instances to apply the configuration. To apply the configuration, set the + * group's updatePolicy.type field to use proactive updates or + * use the applyUpdatesToInstances method. * * Generated from protobuf field optional .google.cloud.compute.v1.InstancePropertiesPatch properties = 147688755; * @return \Google\Cloud\Compute\V1\InstancePropertiesPatch|null @@ -58,7 +70,11 @@ public function clearProperties() } /** - * Properties to set on all instances in the group. You can add or modify properties using the instanceGroupManagers.patch or regionInstanceGroupManagers.patch. After setting allInstancesConfig on the group, you must update the group's instances to apply the configuration. To apply the configuration, set the group's updatePolicy.type field to use proactive updates or use the applyUpdatesToInstances method. + * Properties to set on all instances in the group. + * You can add or modify properties using theinstanceGroupManagers.patch orregionInstanceGroupManagers.patch. After settingallInstancesConfig on the group, you must update the group's + * instances to apply the configuration. To apply the configuration, set the + * group's updatePolicy.type field to use proactive updates or + * use the applyUpdatesToInstances method. * * Generated from protobuf field optional .google.cloud.compute.v1.InstancePropertiesPatch properties = 147688755; * @param \Google\Cloud\Compute\V1\InstancePropertiesPatch $var diff --git a/Compute/src/V1/InstanceGroupManagerAutoHealingPolicy.php b/Compute/src/V1/InstanceGroupManagerAutoHealingPolicy.php index d9edfdc49506..29ad7d4c105c 100644 --- a/Compute/src/V1/InstanceGroupManagerAutoHealingPolicy.php +++ b/Compute/src/V1/InstanceGroupManagerAutoHealingPolicy.php @@ -21,7 +21,14 @@ class InstanceGroupManagerAutoHealingPolicy extends \Google\Protobuf\Internal\Me */ protected $health_check = null; /** - * The initial delay is the number of seconds that a new VM takes to initialize and run its startup script. During a VM's initial delay period, the MIG ignores unsuccessful health checks because the VM might be in the startup process. This prevents the MIG from prematurely recreating a VM. If the health check receives a healthy response during the initial delay, it indicates that the startup process is complete and the VM is ready. The value of initial delay must be between 0 and 3600 seconds. The default value is 0. + * The initial delay is the number of seconds that a new VM takes to + * initialize and run its startup script. During a VM's initial delay + * period, the MIG ignores unsuccessful health checks because the VM might + * be in the startup process. This prevents the MIG from prematurely + * recreating a VM. If the health check receives a healthy response during + * the initial delay, it indicates that the startup process is complete and + * the VM is ready. The value of initial delay must be between 0 and 3600 + * seconds. The default value is 0. * * Generated from protobuf field optional int32 initial_delay_sec = 263207002; */ @@ -36,7 +43,14 @@ class InstanceGroupManagerAutoHealingPolicy extends \Google\Protobuf\Internal\Me * @type string $health_check * The URL for the health check that signals autohealing. * @type int $initial_delay_sec - * The initial delay is the number of seconds that a new VM takes to initialize and run its startup script. During a VM's initial delay period, the MIG ignores unsuccessful health checks because the VM might be in the startup process. This prevents the MIG from prematurely recreating a VM. If the health check receives a healthy response during the initial delay, it indicates that the startup process is complete and the VM is ready. The value of initial delay must be between 0 and 3600 seconds. The default value is 0. + * The initial delay is the number of seconds that a new VM takes to + * initialize and run its startup script. During a VM's initial delay + * period, the MIG ignores unsuccessful health checks because the VM might + * be in the startup process. This prevents the MIG from prematurely + * recreating a VM. If the health check receives a healthy response during + * the initial delay, it indicates that the startup process is complete and + * the VM is ready. The value of initial delay must be between 0 and 3600 + * seconds. The default value is 0. * } */ public function __construct($data = NULL) { @@ -81,7 +95,14 @@ public function setHealthCheck($var) } /** - * The initial delay is the number of seconds that a new VM takes to initialize and run its startup script. During a VM's initial delay period, the MIG ignores unsuccessful health checks because the VM might be in the startup process. This prevents the MIG from prematurely recreating a VM. If the health check receives a healthy response during the initial delay, it indicates that the startup process is complete and the VM is ready. The value of initial delay must be between 0 and 3600 seconds. The default value is 0. + * The initial delay is the number of seconds that a new VM takes to + * initialize and run its startup script. During a VM's initial delay + * period, the MIG ignores unsuccessful health checks because the VM might + * be in the startup process. This prevents the MIG from prematurely + * recreating a VM. If the health check receives a healthy response during + * the initial delay, it indicates that the startup process is complete and + * the VM is ready. The value of initial delay must be between 0 and 3600 + * seconds. The default value is 0. * * Generated from protobuf field optional int32 initial_delay_sec = 263207002; * @return int @@ -102,7 +123,14 @@ public function clearInitialDelaySec() } /** - * The initial delay is the number of seconds that a new VM takes to initialize and run its startup script. During a VM's initial delay period, the MIG ignores unsuccessful health checks because the VM might be in the startup process. This prevents the MIG from prematurely recreating a VM. If the health check receives a healthy response during the initial delay, it indicates that the startup process is complete and the VM is ready. The value of initial delay must be between 0 and 3600 seconds. The default value is 0. + * The initial delay is the number of seconds that a new VM takes to + * initialize and run its startup script. During a VM's initial delay + * period, the MIG ignores unsuccessful health checks because the VM might + * be in the startup process. This prevents the MIG from prematurely + * recreating a VM. If the health check receives a healthy response during + * the initial delay, it indicates that the startup process is complete and + * the VM is ready. The value of initial delay must be between 0 and 3600 + * seconds. The default value is 0. * * Generated from protobuf field optional int32 initial_delay_sec = 263207002; * @param int $var diff --git a/Compute/src/V1/InstanceGroupManagerInstanceFlexibilityPolicy.php b/Compute/src/V1/InstanceGroupManagerInstanceFlexibilityPolicy.php index db544835c61d..eb73a1d71685 100644 --- a/Compute/src/V1/InstanceGroupManagerInstanceFlexibilityPolicy.php +++ b/Compute/src/V1/InstanceGroupManagerInstanceFlexibilityPolicy.php @@ -15,7 +15,8 @@ class InstanceGroupManagerInstanceFlexibilityPolicy extends \Google\Protobuf\Internal\Message { /** - * Named instance selections configuring properties that the group will use when creating new VMs. + * Named instance selections configuring properties that the group will use + * when creating new VMs. * * Generated from protobuf field map instance_selections = 22954577; */ @@ -28,7 +29,8 @@ class InstanceGroupManagerInstanceFlexibilityPolicy extends \Google\Protobuf\Int * Optional. Data for populating the Message object. * * @type array|\Google\Protobuf\Internal\MapField $instance_selections - * Named instance selections configuring properties that the group will use when creating new VMs. + * Named instance selections configuring properties that the group will use + * when creating new VMs. * } */ public function __construct($data = NULL) { @@ -37,7 +39,8 @@ public function __construct($data = NULL) { } /** - * Named instance selections configuring properties that the group will use when creating new VMs. + * Named instance selections configuring properties that the group will use + * when creating new VMs. * * Generated from protobuf field map instance_selections = 22954577; * @return \Google\Protobuf\Internal\MapField @@ -48,7 +51,8 @@ public function getInstanceSelections() } /** - * Named instance selections configuring properties that the group will use when creating new VMs. + * Named instance selections configuring properties that the group will use + * when creating new VMs. * * Generated from protobuf field map instance_selections = 22954577; * @param array|\Google\Protobuf\Internal\MapField $var diff --git a/Compute/src/V1/InstanceGroupManagerInstanceFlexibilityPolicyInstanceSelection.php b/Compute/src/V1/InstanceGroupManagerInstanceFlexibilityPolicyInstanceSelection.php index baaa77e1cddf..5c9337014451 100644 --- a/Compute/src/V1/InstanceGroupManagerInstanceFlexibilityPolicyInstanceSelection.php +++ b/Compute/src/V1/InstanceGroupManagerInstanceFlexibilityPolicyInstanceSelection.php @@ -21,7 +21,11 @@ class InstanceGroupManagerInstanceFlexibilityPolicyInstanceSelection extends \Go */ private $machine_types; /** - * Preference of this instance selection. Lower number means higher preference. MIG will first try to create a VM based on the machine-type with lowest rank and fallback to next rank based on availability. Machine types and instance selections with the same rank have the same preference. + * Preference of this instance selection. Lower number means higher + * preference. MIG will first try to create a VM based on the machine-type + * with lowest rank and fallback to next rank based on availability. + * Machine types and instance selections with the same rank have the same + * preference. * * Generated from protobuf field optional int32 rank = 3492908; */ @@ -36,7 +40,11 @@ class InstanceGroupManagerInstanceFlexibilityPolicyInstanceSelection extends \Go * @type array|\Google\Protobuf\Internal\RepeatedField $machine_types * Full machine-type names, e.g. "n1-standard-16". * @type int $rank - * Preference of this instance selection. Lower number means higher preference. MIG will first try to create a VM based on the machine-type with lowest rank and fallback to next rank based on availability. Machine types and instance selections with the same rank have the same preference. + * Preference of this instance selection. Lower number means higher + * preference. MIG will first try to create a VM based on the machine-type + * with lowest rank and fallback to next rank based on availability. + * Machine types and instance selections with the same rank have the same + * preference. * } */ public function __construct($data = NULL) { @@ -71,7 +79,11 @@ public function setMachineTypes($var) } /** - * Preference of this instance selection. Lower number means higher preference. MIG will first try to create a VM based on the machine-type with lowest rank and fallback to next rank based on availability. Machine types and instance selections with the same rank have the same preference. + * Preference of this instance selection. Lower number means higher + * preference. MIG will first try to create a VM based on the machine-type + * with lowest rank and fallback to next rank based on availability. + * Machine types and instance selections with the same rank have the same + * preference. * * Generated from protobuf field optional int32 rank = 3492908; * @return int @@ -92,7 +104,11 @@ public function clearRank() } /** - * Preference of this instance selection. Lower number means higher preference. MIG will first try to create a VM based on the machine-type with lowest rank and fallback to next rank based on availability. Machine types and instance selections with the same rank have the same preference. + * Preference of this instance selection. Lower number means higher + * preference. MIG will first try to create a VM based on the machine-type + * with lowest rank and fallback to next rank based on availability. + * Machine types and instance selections with the same rank have the same + * preference. * * Generated from protobuf field optional int32 rank = 3492908; * @param int $var diff --git a/Compute/src/V1/InstanceGroupManagerInstanceLifecyclePolicy.php b/Compute/src/V1/InstanceGroupManagerInstanceLifecyclePolicy.php index 1c91044fe5fd..6d2f2e9273a1 100644 --- a/Compute/src/V1/InstanceGroupManagerInstanceLifecyclePolicy.php +++ b/Compute/src/V1/InstanceGroupManagerInstanceLifecyclePolicy.php @@ -15,14 +15,28 @@ class InstanceGroupManagerInstanceLifecyclePolicy extends \Google\Protobuf\Internal\Message { /** - * The action that a MIG performs on a failed or an unhealthy VM. A VM is marked as unhealthy when the application running on that VM fails a health check. Valid values are - REPAIR (default): MIG automatically repairs a failed or an unhealthy VM by recreating it. For more information, see About repairing VMs in a MIG. - DO_NOTHING: MIG does not repair a failed or an unhealthy VM. + * The action that a MIG performs on a failed or an unhealthy VM. + * A VM is marked as unhealthy when the application running on that + * VM fails a health check. + * Valid values are + * - REPAIR (default): MIG automatically repairs a failed or + * an unhealthy VM by recreating it. For more information, see About + * repairing VMs in a MIG. + * - DO_NOTHING: MIG does not repair a failed or an unhealthy + * VM. * Check the DefaultActionOnFailure enum for the list of possible values. * * Generated from protobuf field optional string default_action_on_failure = 61383253; */ protected $default_action_on_failure = null; /** - * A bit indicating whether to forcefully apply the group's latest configuration when repairing a VM. Valid options are: - NO (default): If configuration updates are available, they are not forcefully applied during repair. Instead, configuration updates are applied according to the group's update policy. - YES: If configuration updates are available, they are applied during repair. + * A bit indicating whether to forcefully apply the group's latest + * configuration when repairing a VM. Valid options are: + * - NO (default): If configuration updates are available, they are not + * forcefully applied during repair. Instead, configuration updates are + * applied according to the group's update policy. + * - YES: If configuration updates are available, they are applied + * during repair. * Check the ForceUpdateOnRepair enum for the list of possible values. * * Generated from protobuf field optional string force_update_on_repair = 356302027; @@ -36,10 +50,24 @@ class InstanceGroupManagerInstanceLifecyclePolicy extends \Google\Protobuf\Inter * Optional. Data for populating the Message object. * * @type string $default_action_on_failure - * The action that a MIG performs on a failed or an unhealthy VM. A VM is marked as unhealthy when the application running on that VM fails a health check. Valid values are - REPAIR (default): MIG automatically repairs a failed or an unhealthy VM by recreating it. For more information, see About repairing VMs in a MIG. - DO_NOTHING: MIG does not repair a failed or an unhealthy VM. + * The action that a MIG performs on a failed or an unhealthy VM. + * A VM is marked as unhealthy when the application running on that + * VM fails a health check. + * Valid values are + * - REPAIR (default): MIG automatically repairs a failed or + * an unhealthy VM by recreating it. For more information, see About + * repairing VMs in a MIG. + * - DO_NOTHING: MIG does not repair a failed or an unhealthy + * VM. * Check the DefaultActionOnFailure enum for the list of possible values. * @type string $force_update_on_repair - * A bit indicating whether to forcefully apply the group's latest configuration when repairing a VM. Valid options are: - NO (default): If configuration updates are available, they are not forcefully applied during repair. Instead, configuration updates are applied according to the group's update policy. - YES: If configuration updates are available, they are applied during repair. + * A bit indicating whether to forcefully apply the group's latest + * configuration when repairing a VM. Valid options are: + * - NO (default): If configuration updates are available, they are not + * forcefully applied during repair. Instead, configuration updates are + * applied according to the group's update policy. + * - YES: If configuration updates are available, they are applied + * during repair. * Check the ForceUpdateOnRepair enum for the list of possible values. * } */ @@ -49,7 +77,15 @@ public function __construct($data = NULL) { } /** - * The action that a MIG performs on a failed or an unhealthy VM. A VM is marked as unhealthy when the application running on that VM fails a health check. Valid values are - REPAIR (default): MIG automatically repairs a failed or an unhealthy VM by recreating it. For more information, see About repairing VMs in a MIG. - DO_NOTHING: MIG does not repair a failed or an unhealthy VM. + * The action that a MIG performs on a failed or an unhealthy VM. + * A VM is marked as unhealthy when the application running on that + * VM fails a health check. + * Valid values are + * - REPAIR (default): MIG automatically repairs a failed or + * an unhealthy VM by recreating it. For more information, see About + * repairing VMs in a MIG. + * - DO_NOTHING: MIG does not repair a failed or an unhealthy + * VM. * Check the DefaultActionOnFailure enum for the list of possible values. * * Generated from protobuf field optional string default_action_on_failure = 61383253; @@ -71,7 +107,15 @@ public function clearDefaultActionOnFailure() } /** - * The action that a MIG performs on a failed or an unhealthy VM. A VM is marked as unhealthy when the application running on that VM fails a health check. Valid values are - REPAIR (default): MIG automatically repairs a failed or an unhealthy VM by recreating it. For more information, see About repairing VMs in a MIG. - DO_NOTHING: MIG does not repair a failed or an unhealthy VM. + * The action that a MIG performs on a failed or an unhealthy VM. + * A VM is marked as unhealthy when the application running on that + * VM fails a health check. + * Valid values are + * - REPAIR (default): MIG automatically repairs a failed or + * an unhealthy VM by recreating it. For more information, see About + * repairing VMs in a MIG. + * - DO_NOTHING: MIG does not repair a failed or an unhealthy + * VM. * Check the DefaultActionOnFailure enum for the list of possible values. * * Generated from protobuf field optional string default_action_on_failure = 61383253; @@ -87,7 +131,13 @@ public function setDefaultActionOnFailure($var) } /** - * A bit indicating whether to forcefully apply the group's latest configuration when repairing a VM. Valid options are: - NO (default): If configuration updates are available, they are not forcefully applied during repair. Instead, configuration updates are applied according to the group's update policy. - YES: If configuration updates are available, they are applied during repair. + * A bit indicating whether to forcefully apply the group's latest + * configuration when repairing a VM. Valid options are: + * - NO (default): If configuration updates are available, they are not + * forcefully applied during repair. Instead, configuration updates are + * applied according to the group's update policy. + * - YES: If configuration updates are available, they are applied + * during repair. * Check the ForceUpdateOnRepair enum for the list of possible values. * * Generated from protobuf field optional string force_update_on_repair = 356302027; @@ -109,7 +159,13 @@ public function clearForceUpdateOnRepair() } /** - * A bit indicating whether to forcefully apply the group's latest configuration when repairing a VM. Valid options are: - NO (default): If configuration updates are available, they are not forcefully applied during repair. Instead, configuration updates are applied according to the group's update policy. - YES: If configuration updates are available, they are applied during repair. + * A bit indicating whether to forcefully apply the group's latest + * configuration when repairing a VM. Valid options are: + * - NO (default): If configuration updates are available, they are not + * forcefully applied during repair. Instead, configuration updates are + * applied according to the group's update policy. + * - YES: If configuration updates are available, they are applied + * during repair. * Check the ForceUpdateOnRepair enum for the list of possible values. * * Generated from protobuf field optional string force_update_on_repair = 356302027; diff --git a/Compute/src/V1/InstanceGroupManagerInstanceLifecyclePolicy/DefaultActionOnFailure.php b/Compute/src/V1/InstanceGroupManagerInstanceLifecyclePolicy/DefaultActionOnFailure.php index 5dfbabadc395..eb0ae02e69fd 100644 --- a/Compute/src/V1/InstanceGroupManagerInstanceLifecyclePolicy/DefaultActionOnFailure.php +++ b/Compute/src/V1/InstanceGroupManagerInstanceLifecyclePolicy/DefaultActionOnFailure.php @@ -7,7 +7,15 @@ use UnexpectedValueException; /** - * The action that a MIG performs on a failed or an unhealthy VM. A VM is marked as unhealthy when the application running on that VM fails a health check. Valid values are - REPAIR (default): MIG automatically repairs a failed or an unhealthy VM by recreating it. For more information, see About repairing VMs in a MIG. - DO_NOTHING: MIG does not repair a failed or an unhealthy VM. + * The action that a MIG performs on a failed or an unhealthy VM. + * A VM is marked as unhealthy when the application running on that + * VM fails a health check. + * Valid values are + * - REPAIR (default): MIG automatically repairs a failed or + * an unhealthy VM by recreating it. For more information, see About + * repairing VMs in a MIG. + * - DO_NOTHING: MIG does not repair a failed or an unhealthy + * VM. * * Protobuf type google.cloud.compute.v1.InstanceGroupManagerInstanceLifecyclePolicy.DefaultActionOnFailure */ @@ -26,7 +34,9 @@ class DefaultActionOnFailure */ const DO_NOTHING = 451307513; /** - * (Default) MIG automatically repairs a failed or an unhealthy VM by recreating it. For more information, see About repairing VMs in a MIG. + * (Default) MIG automatically repairs a failed or an unhealthy + * VM by recreating it. For more information, see About + * repairing VMs in a MIG. * * Generated from protobuf enum REPAIR = 266277773; */ diff --git a/Compute/src/V1/InstanceGroupManagerInstanceLifecyclePolicy/ForceUpdateOnRepair.php b/Compute/src/V1/InstanceGroupManagerInstanceLifecyclePolicy/ForceUpdateOnRepair.php index d7d1247a01c3..2a0107f0e8c6 100644 --- a/Compute/src/V1/InstanceGroupManagerInstanceLifecyclePolicy/ForceUpdateOnRepair.php +++ b/Compute/src/V1/InstanceGroupManagerInstanceLifecyclePolicy/ForceUpdateOnRepair.php @@ -7,7 +7,13 @@ use UnexpectedValueException; /** - * A bit indicating whether to forcefully apply the group's latest configuration when repairing a VM. Valid options are: - NO (default): If configuration updates are available, they are not forcefully applied during repair. Instead, configuration updates are applied according to the group's update policy. - YES: If configuration updates are available, they are applied during repair. + * A bit indicating whether to forcefully apply the group's latest + * configuration when repairing a VM. Valid options are: + * - NO (default): If configuration updates are available, they are not + * forcefully applied during repair. Instead, configuration updates are + * applied according to the group's update policy. + * - YES: If configuration updates are available, they are applied + * during repair. * * Protobuf type google.cloud.compute.v1.InstanceGroupManagerInstanceLifecyclePolicy.ForceUpdateOnRepair */ diff --git a/Compute/src/V1/InstanceGroupManagerList.php b/Compute/src/V1/InstanceGroupManagerList.php index 37e06b7a8f1b..efa432998d3a 100644 --- a/Compute/src/V1/InstanceGroupManagerList.php +++ b/Compute/src/V1/InstanceGroupManagerList.php @@ -28,13 +28,18 @@ class InstanceGroupManagerList extends \Google\Protobuf\Internal\Message */ private $items; /** - * [Output Only] The resource type, which is always compute#instanceGroupManagerList for a list of managed instance groups. + * [Output Only] The resource type, which is always + * compute#instanceGroupManagerList for a list of managed instance groups. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -63,9 +68,14 @@ class InstanceGroupManagerList extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\InstanceGroupManager>|\Google\Protobuf\Internal\RepeatedField $items * A list of InstanceGroupManager resources. * @type string $kind - * [Output Only] The resource type, which is always compute#instanceGroupManagerList for a list of managed instance groups. + * [Output Only] The resource type, which is always + * compute#instanceGroupManagerList for a list of managed instance groups. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type \Google\Cloud\Compute\V1\Warning $warning @@ -140,7 +150,8 @@ public function setItems($var) } /** - * [Output Only] The resource type, which is always compute#instanceGroupManagerList for a list of managed instance groups. + * [Output Only] The resource type, which is always + * compute#instanceGroupManagerList for a list of managed instance groups. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -161,7 +172,8 @@ public function clearKind() } /** - * [Output Only] The resource type, which is always compute#instanceGroupManagerList for a list of managed instance groups. + * [Output Only] The resource type, which is always + * compute#instanceGroupManagerList for a list of managed instance groups. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -176,7 +188,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -197,7 +213,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/InstanceGroupManagerResizeRequest.php b/Compute/src/V1/InstanceGroupManagerResizeRequest.php index bb2173ac76b9..8be058234f70 100644 --- a/Compute/src/V1/InstanceGroupManagerResizeRequest.php +++ b/Compute/src/V1/InstanceGroupManagerResizeRequest.php @@ -9,14 +9,19 @@ use Google\Protobuf\Internal\GPBUtil; /** - * InstanceGroupManagerResizeRequest represents a request to create a number of VMs: either immediately or by queuing the request for the specified time. This resize request is nested under InstanceGroupManager and the VMs created by this request are added to the owning InstanceGroupManager. + * InstanceGroupManagerResizeRequest represents a request to create + * a number of VMs: either immediately or by queuing the request for the + * specified time. This resize request is nested under InstanceGroupManager + * and the VMs created by this request are added to the owning + * InstanceGroupManager. * * Generated from protobuf message google.cloud.compute.v1.InstanceGroupManagerResizeRequest */ class InstanceGroupManagerResizeRequest extends \Google\Protobuf\Internal\Message { /** - * [Output Only] The creation timestamp for this resize request in RFC3339 text format. + * [Output Only] The creation timestamp for this resize request inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; */ @@ -28,37 +33,44 @@ class InstanceGroupManagerResizeRequest extends \Google\Protobuf\Internal\Messag */ protected $description = null; /** - * [Output Only] A unique identifier for this resource type. The server generates this identifier. + * [Output Only] A unique identifier for this resource type. The server + * generates this identifier. * * Generated from protobuf field optional uint64 id = 3355; */ protected $id = null; /** - * [Output Only] The resource type, which is always compute#instanceGroupManagerResizeRequest for resize requests. + * [Output Only] The resource type, which is alwayscompute#instanceGroupManagerResizeRequest for + * resize requests. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * The name of this resize request. The name must be 1-63 characters long, and comply with RFC1035. + * The name of this resize request. The name must be 1-63 characters + * long, and comply withRFC1035. * * Generated from protobuf field optional string name = 3373707; */ protected $name = null; /** - * Requested run duration for instances that will be created by this request. At the end of the run duration instance will be deleted. + * Requested run duration for instances that will be created by this request. + * At the end of the run duration instance will be deleted. * * Generated from protobuf field optional .google.cloud.compute.v1.Duration requested_run_duration = 232146425; */ protected $requested_run_duration = null; /** - * The number of instances to be created by this resize request. The group's target size will be increased by this number. This field cannot be used together with 'instances'. + * The number of instances to be created by this resize request. The group's + * target size will be increased by this number. This field cannot be used + * together with 'instances'. * * Generated from protobuf field optional int32 resize_by = 533735362; */ protected $resize_by = null; /** - * [Output Only] The URL for this resize request. The server defines this URL. + * [Output Only] The URL for this resize request. The server defines + * this URL. * * Generated from protobuf field optional string self_link = 456214797; */ @@ -83,7 +95,9 @@ class InstanceGroupManagerResizeRequest extends \Google\Protobuf\Internal\Messag */ protected $status = null; /** - * [Output Only] The URL of a zone where the resize request is located. Populated only for zonal resize requests. + * [Output Only] The URL of azone + * where the resize request is located. Populated only for zonal resize + * requests. * * Generated from protobuf field optional string zone = 3744684; */ @@ -96,21 +110,29 @@ class InstanceGroupManagerResizeRequest extends \Google\Protobuf\Internal\Messag * Optional. Data for populating the Message object. * * @type string $creation_timestamp - * [Output Only] The creation timestamp for this resize request in RFC3339 text format. + * [Output Only] The creation timestamp for this resize request inRFC3339 + * text format. * @type string $description * An optional description of this resource. * @type int|string $id - * [Output Only] A unique identifier for this resource type. The server generates this identifier. + * [Output Only] A unique identifier for this resource type. The server + * generates this identifier. * @type string $kind - * [Output Only] The resource type, which is always compute#instanceGroupManagerResizeRequest for resize requests. + * [Output Only] The resource type, which is alwayscompute#instanceGroupManagerResizeRequest for + * resize requests. * @type string $name - * The name of this resize request. The name must be 1-63 characters long, and comply with RFC1035. + * The name of this resize request. The name must be 1-63 characters + * long, and comply withRFC1035. * @type \Google\Cloud\Compute\V1\Duration $requested_run_duration - * Requested run duration for instances that will be created by this request. At the end of the run duration instance will be deleted. + * Requested run duration for instances that will be created by this request. + * At the end of the run duration instance will be deleted. * @type int $resize_by - * The number of instances to be created by this resize request. The group's target size will be increased by this number. This field cannot be used together with 'instances'. + * The number of instances to be created by this resize request. The group's + * target size will be increased by this number. This field cannot be used + * together with 'instances'. * @type string $self_link - * [Output Only] The URL for this resize request. The server defines this URL. + * [Output Only] The URL for this resize request. The server defines + * this URL. * @type string $self_link_with_id * [Output Only] Server-defined URL for this resource with the resource id. * @type string $state @@ -119,7 +141,9 @@ class InstanceGroupManagerResizeRequest extends \Google\Protobuf\Internal\Messag * @type \Google\Cloud\Compute\V1\InstanceGroupManagerResizeRequestStatus $status * [Output only] Status of the request. * @type string $zone - * [Output Only] The URL of a zone where the resize request is located. Populated only for zonal resize requests. + * [Output Only] The URL of azone + * where the resize request is located. Populated only for zonal resize + * requests. * } */ public function __construct($data = NULL) { @@ -128,7 +152,8 @@ public function __construct($data = NULL) { } /** - * [Output Only] The creation timestamp for this resize request in RFC3339 text format. + * [Output Only] The creation timestamp for this resize request inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @return string @@ -149,7 +174,8 @@ public function clearCreationTimestamp() } /** - * [Output Only] The creation timestamp for this resize request in RFC3339 text format. + * [Output Only] The creation timestamp for this resize request inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @param string $var @@ -200,7 +226,8 @@ public function setDescription($var) } /** - * [Output Only] A unique identifier for this resource type. The server generates this identifier. + * [Output Only] A unique identifier for this resource type. The server + * generates this identifier. * * Generated from protobuf field optional uint64 id = 3355; * @return int|string @@ -221,7 +248,8 @@ public function clearId() } /** - * [Output Only] A unique identifier for this resource type. The server generates this identifier. + * [Output Only] A unique identifier for this resource type. The server + * generates this identifier. * * Generated from protobuf field optional uint64 id = 3355; * @param int|string $var @@ -236,7 +264,8 @@ public function setId($var) } /** - * [Output Only] The resource type, which is always compute#instanceGroupManagerResizeRequest for resize requests. + * [Output Only] The resource type, which is alwayscompute#instanceGroupManagerResizeRequest for + * resize requests. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -257,7 +286,8 @@ public function clearKind() } /** - * [Output Only] The resource type, which is always compute#instanceGroupManagerResizeRequest for resize requests. + * [Output Only] The resource type, which is alwayscompute#instanceGroupManagerResizeRequest for + * resize requests. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -272,7 +302,8 @@ public function setKind($var) } /** - * The name of this resize request. The name must be 1-63 characters long, and comply with RFC1035. + * The name of this resize request. The name must be 1-63 characters + * long, and comply withRFC1035. * * Generated from protobuf field optional string name = 3373707; * @return string @@ -293,7 +324,8 @@ public function clearName() } /** - * The name of this resize request. The name must be 1-63 characters long, and comply with RFC1035. + * The name of this resize request. The name must be 1-63 characters + * long, and comply withRFC1035. * * Generated from protobuf field optional string name = 3373707; * @param string $var @@ -308,7 +340,8 @@ public function setName($var) } /** - * Requested run duration for instances that will be created by this request. At the end of the run duration instance will be deleted. + * Requested run duration for instances that will be created by this request. + * At the end of the run duration instance will be deleted. * * Generated from protobuf field optional .google.cloud.compute.v1.Duration requested_run_duration = 232146425; * @return \Google\Cloud\Compute\V1\Duration|null @@ -329,7 +362,8 @@ public function clearRequestedRunDuration() } /** - * Requested run duration for instances that will be created by this request. At the end of the run duration instance will be deleted. + * Requested run duration for instances that will be created by this request. + * At the end of the run duration instance will be deleted. * * Generated from protobuf field optional .google.cloud.compute.v1.Duration requested_run_duration = 232146425; * @param \Google\Cloud\Compute\V1\Duration $var @@ -344,7 +378,9 @@ public function setRequestedRunDuration($var) } /** - * The number of instances to be created by this resize request. The group's target size will be increased by this number. This field cannot be used together with 'instances'. + * The number of instances to be created by this resize request. The group's + * target size will be increased by this number. This field cannot be used + * together with 'instances'. * * Generated from protobuf field optional int32 resize_by = 533735362; * @return int @@ -365,7 +401,9 @@ public function clearResizeBy() } /** - * The number of instances to be created by this resize request. The group's target size will be increased by this number. This field cannot be used together with 'instances'. + * The number of instances to be created by this resize request. The group's + * target size will be increased by this number. This field cannot be used + * together with 'instances'. * * Generated from protobuf field optional int32 resize_by = 533735362; * @param int $var @@ -380,7 +418,8 @@ public function setResizeBy($var) } /** - * [Output Only] The URL for this resize request. The server defines this URL. + * [Output Only] The URL for this resize request. The server defines + * this URL. * * Generated from protobuf field optional string self_link = 456214797; * @return string @@ -401,7 +440,8 @@ public function clearSelfLink() } /** - * [Output Only] The URL for this resize request. The server defines this URL. + * [Output Only] The URL for this resize request. The server defines + * this URL. * * Generated from protobuf field optional string self_link = 456214797; * @param string $var @@ -526,7 +566,9 @@ public function setStatus($var) } /** - * [Output Only] The URL of a zone where the resize request is located. Populated only for zonal resize requests. + * [Output Only] The URL of azone + * where the resize request is located. Populated only for zonal resize + * requests. * * Generated from protobuf field optional string zone = 3744684; * @return string @@ -547,7 +589,9 @@ public function clearZone() } /** - * [Output Only] The URL of a zone where the resize request is located. Populated only for zonal resize requests. + * [Output Only] The URL of azone + * where the resize request is located. Populated only for zonal resize + * requests. * * Generated from protobuf field optional string zone = 3744684; * @param string $var diff --git a/Compute/src/V1/InstanceGroupManagerResizeRequest/State.php b/Compute/src/V1/InstanceGroupManagerResizeRequest/State.php index 8944de56de6c..8d05828555fe 100644 --- a/Compute/src/V1/InstanceGroupManagerResizeRequest/State.php +++ b/Compute/src/V1/InstanceGroupManagerResizeRequest/State.php @@ -20,7 +20,8 @@ class State */ const UNDEFINED_STATE = 0; /** - * The request was created successfully and was accepted for provisioning when the capacity becomes available. + * The request was created successfully and was accepted for provisioning + * when the capacity becomes available. * * Generated from protobuf enum ACCEPTED = 246714279; */ @@ -38,7 +39,9 @@ class State */ const CREATING = 455564985; /** - * The request failed before or during provisioning. If the request fails during provisioning, any VMs that were created during provisioning are rolled back and removed from the MIG. + * The request failed before or during provisioning. If the request fails + * during provisioning, any VMs that were created during provisioning are + * rolled back and removed from the MIG. * * Generated from protobuf enum FAILED = 455706685; */ diff --git a/Compute/src/V1/InstanceGroupManagerResizeRequestStatus.php b/Compute/src/V1/InstanceGroupManagerResizeRequestStatus.php index 85eed299cc2e..eb6f05020e77 100644 --- a/Compute/src/V1/InstanceGroupManagerResizeRequestStatus.php +++ b/Compute/src/V1/InstanceGroupManagerResizeRequestStatus.php @@ -15,13 +15,24 @@ class InstanceGroupManagerResizeRequestStatus extends \Google\Protobuf\Internal\Message { /** - * [Output only] Fatal errors encountered during the queueing or provisioning phases of the ResizeRequest that caused the transition to the FAILED state. Contrary to the last_attempt errors, this field is final and errors are never removed from here, as the ResizeRequest is not going to retry. + * [Output only] Fatal errors encountered during the queueing or + * provisioning phases of the ResizeRequest that caused the transition to + * the FAILED state. Contrary to the last_attempt errors, this field is + * final and errors are never removed from here, as the ResizeRequest is not + * going to retry. * * Generated from protobuf field optional .google.cloud.compute.v1.Error error = 96784904; */ protected $error = null; /** - * [Output only] Information about the last attempt to fulfill the request. The value is temporary since the ResizeRequest can retry, as long as it's still active and the last attempt value can either be cleared or replaced with a different error. Since ResizeRequest retries infrequently, the value may be stale and no longer show an active problem. The value is cleared when ResizeRequest transitions to the final state (becomes inactive). If the final state is FAILED the error describing it will be storred in the "error" field only. + * [Output only] Information about the last attempt to fulfill the request. + * The value is temporary since the ResizeRequest can retry, as long as it's + * still active and the last attempt value can either be cleared or replaced + * with a different error. Since ResizeRequest retries infrequently, the + * value may be stale and no longer show an active problem. The value is + * cleared when ResizeRequest transitions to the final state (becomes + * inactive). If the final state is FAILED the error describing it will be + * storred in the "error" field only. * * Generated from protobuf field optional .google.cloud.compute.v1.InstanceGroupManagerResizeRequestStatusLastAttempt last_attempt = 434771492; */ @@ -34,9 +45,20 @@ class InstanceGroupManagerResizeRequestStatus extends \Google\Protobuf\Internal\ * Optional. Data for populating the Message object. * * @type \Google\Cloud\Compute\V1\Error $error - * [Output only] Fatal errors encountered during the queueing or provisioning phases of the ResizeRequest that caused the transition to the FAILED state. Contrary to the last_attempt errors, this field is final and errors are never removed from here, as the ResizeRequest is not going to retry. + * [Output only] Fatal errors encountered during the queueing or + * provisioning phases of the ResizeRequest that caused the transition to + * the FAILED state. Contrary to the last_attempt errors, this field is + * final and errors are never removed from here, as the ResizeRequest is not + * going to retry. * @type \Google\Cloud\Compute\V1\InstanceGroupManagerResizeRequestStatusLastAttempt $last_attempt - * [Output only] Information about the last attempt to fulfill the request. The value is temporary since the ResizeRequest can retry, as long as it's still active and the last attempt value can either be cleared or replaced with a different error. Since ResizeRequest retries infrequently, the value may be stale and no longer show an active problem. The value is cleared when ResizeRequest transitions to the final state (becomes inactive). If the final state is FAILED the error describing it will be storred in the "error" field only. + * [Output only] Information about the last attempt to fulfill the request. + * The value is temporary since the ResizeRequest can retry, as long as it's + * still active and the last attempt value can either be cleared or replaced + * with a different error. Since ResizeRequest retries infrequently, the + * value may be stale and no longer show an active problem. The value is + * cleared when ResizeRequest transitions to the final state (becomes + * inactive). If the final state is FAILED the error describing it will be + * storred in the "error" field only. * } */ public function __construct($data = NULL) { @@ -45,7 +67,11 @@ public function __construct($data = NULL) { } /** - * [Output only] Fatal errors encountered during the queueing or provisioning phases of the ResizeRequest that caused the transition to the FAILED state. Contrary to the last_attempt errors, this field is final and errors are never removed from here, as the ResizeRequest is not going to retry. + * [Output only] Fatal errors encountered during the queueing or + * provisioning phases of the ResizeRequest that caused the transition to + * the FAILED state. Contrary to the last_attempt errors, this field is + * final and errors are never removed from here, as the ResizeRequest is not + * going to retry. * * Generated from protobuf field optional .google.cloud.compute.v1.Error error = 96784904; * @return \Google\Cloud\Compute\V1\Error|null @@ -66,7 +92,11 @@ public function clearError() } /** - * [Output only] Fatal errors encountered during the queueing or provisioning phases of the ResizeRequest that caused the transition to the FAILED state. Contrary to the last_attempt errors, this field is final and errors are never removed from here, as the ResizeRequest is not going to retry. + * [Output only] Fatal errors encountered during the queueing or + * provisioning phases of the ResizeRequest that caused the transition to + * the FAILED state. Contrary to the last_attempt errors, this field is + * final and errors are never removed from here, as the ResizeRequest is not + * going to retry. * * Generated from protobuf field optional .google.cloud.compute.v1.Error error = 96784904; * @param \Google\Cloud\Compute\V1\Error $var @@ -81,7 +111,14 @@ public function setError($var) } /** - * [Output only] Information about the last attempt to fulfill the request. The value is temporary since the ResizeRequest can retry, as long as it's still active and the last attempt value can either be cleared or replaced with a different error. Since ResizeRequest retries infrequently, the value may be stale and no longer show an active problem. The value is cleared when ResizeRequest transitions to the final state (becomes inactive). If the final state is FAILED the error describing it will be storred in the "error" field only. + * [Output only] Information about the last attempt to fulfill the request. + * The value is temporary since the ResizeRequest can retry, as long as it's + * still active and the last attempt value can either be cleared or replaced + * with a different error. Since ResizeRequest retries infrequently, the + * value may be stale and no longer show an active problem. The value is + * cleared when ResizeRequest transitions to the final state (becomes + * inactive). If the final state is FAILED the error describing it will be + * storred in the "error" field only. * * Generated from protobuf field optional .google.cloud.compute.v1.InstanceGroupManagerResizeRequestStatusLastAttempt last_attempt = 434771492; * @return \Google\Cloud\Compute\V1\InstanceGroupManagerResizeRequestStatusLastAttempt|null @@ -102,7 +139,14 @@ public function clearLastAttempt() } /** - * [Output only] Information about the last attempt to fulfill the request. The value is temporary since the ResizeRequest can retry, as long as it's still active and the last attempt value can either be cleared or replaced with a different error. Since ResizeRequest retries infrequently, the value may be stale and no longer show an active problem. The value is cleared when ResizeRequest transitions to the final state (becomes inactive). If the final state is FAILED the error describing it will be storred in the "error" field only. + * [Output only] Information about the last attempt to fulfill the request. + * The value is temporary since the ResizeRequest can retry, as long as it's + * still active and the last attempt value can either be cleared or replaced + * with a different error. Since ResizeRequest retries infrequently, the + * value may be stale and no longer show an active problem. The value is + * cleared when ResizeRequest transitions to the final state (becomes + * inactive). If the final state is FAILED the error describing it will be + * storred in the "error" field only. * * Generated from protobuf field optional .google.cloud.compute.v1.InstanceGroupManagerResizeRequestStatusLastAttempt last_attempt = 434771492; * @param \Google\Cloud\Compute\V1\InstanceGroupManagerResizeRequestStatusLastAttempt $var diff --git a/Compute/src/V1/InstanceGroupManagerResizeRequestsListResponse.php b/Compute/src/V1/InstanceGroupManagerResizeRequestsListResponse.php index 26fa14ab7208..f9ac658bca02 100644 --- a/Compute/src/V1/InstanceGroupManagerResizeRequestsListResponse.php +++ b/Compute/src/V1/InstanceGroupManagerResizeRequestsListResponse.php @@ -28,13 +28,18 @@ class InstanceGroupManagerResizeRequestsListResponse extends \Google\Protobuf\In */ private $items; /** - * [Output Only] Type of the resource. Always compute#instanceGroupManagerResizeRequestList for a list of resize requests. + * [Output Only] Type of the resource. Alwayscompute#instanceGroupManagerResizeRequestList for + * a list of resize requests. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -63,9 +68,14 @@ class InstanceGroupManagerResizeRequestsListResponse extends \Google\Protobuf\In * @type array<\Google\Cloud\Compute\V1\InstanceGroupManagerResizeRequest>|\Google\Protobuf\Internal\RepeatedField $items * A list of resize request resources. * @type string $kind - * [Output Only] Type of the resource. Always compute#instanceGroupManagerResizeRequestList for a list of resize requests. + * [Output Only] Type of the resource. Alwayscompute#instanceGroupManagerResizeRequestList for + * a list of resize requests. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type \Google\Cloud\Compute\V1\Warning $warning @@ -140,7 +150,8 @@ public function setItems($var) } /** - * [Output Only] Type of the resource. Always compute#instanceGroupManagerResizeRequestList for a list of resize requests. + * [Output Only] Type of the resource. Alwayscompute#instanceGroupManagerResizeRequestList for + * a list of resize requests. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -161,7 +172,8 @@ public function clearKind() } /** - * [Output Only] Type of the resource. Always compute#instanceGroupManagerResizeRequestList for a list of resize requests. + * [Output Only] Type of the resource. Alwayscompute#instanceGroupManagerResizeRequestList for + * a list of resize requests. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -176,7 +188,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -197,7 +213,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/InstanceGroupManagerResourcePolicies.php b/Compute/src/V1/InstanceGroupManagerResourcePolicies.php index cc525216d6d5..c65f5dd65d62 100644 --- a/Compute/src/V1/InstanceGroupManagerResourcePolicies.php +++ b/Compute/src/V1/InstanceGroupManagerResourcePolicies.php @@ -15,7 +15,13 @@ class InstanceGroupManagerResourcePolicies extends \Google\Protobuf\Internal\Message { /** - * The URL of the workload policy that is specified for this managed instance group. It can be a full or partial URL. For example, the following are all valid URLs to a workload policy: - https://www.googleapis.com/compute/v1/projects/project/regions/region /resourcePolicies/resourcePolicy - projects/project/regions/region/resourcePolicies/resourcePolicy - regions/region/resourcePolicies/resourcePolicy + * The URL of the workload policy that is specified for this managed + * instance group. + * It can be a full or partial URL. For example, the following are + * all valid URLs to a workload policy: + * - https://www.googleapis.com/compute/v1/projects/project/regions/region/resourcePolicies/resourcePolicy + * - projects/project/regions/region/resourcePolicies/resourcePolicy + * - regions/region/resourcePolicies/resourcePolicy * * Generated from protobuf field optional string workload_policy = 114721530; */ @@ -28,7 +34,13 @@ class InstanceGroupManagerResourcePolicies extends \Google\Protobuf\Internal\Mes * Optional. Data for populating the Message object. * * @type string $workload_policy - * The URL of the workload policy that is specified for this managed instance group. It can be a full or partial URL. For example, the following are all valid URLs to a workload policy: - https://www.googleapis.com/compute/v1/projects/project/regions/region /resourcePolicies/resourcePolicy - projects/project/regions/region/resourcePolicies/resourcePolicy - regions/region/resourcePolicies/resourcePolicy + * The URL of the workload policy that is specified for this managed + * instance group. + * It can be a full or partial URL. For example, the following are + * all valid URLs to a workload policy: + * - https://www.googleapis.com/compute/v1/projects/project/regions/region/resourcePolicies/resourcePolicy + * - projects/project/regions/region/resourcePolicies/resourcePolicy + * - regions/region/resourcePolicies/resourcePolicy * } */ public function __construct($data = NULL) { @@ -37,7 +49,13 @@ public function __construct($data = NULL) { } /** - * The URL of the workload policy that is specified for this managed instance group. It can be a full or partial URL. For example, the following are all valid URLs to a workload policy: - https://www.googleapis.com/compute/v1/projects/project/regions/region /resourcePolicies/resourcePolicy - projects/project/regions/region/resourcePolicies/resourcePolicy - regions/region/resourcePolicies/resourcePolicy + * The URL of the workload policy that is specified for this managed + * instance group. + * It can be a full or partial URL. For example, the following are + * all valid URLs to a workload policy: + * - https://www.googleapis.com/compute/v1/projects/project/regions/region/resourcePolicies/resourcePolicy + * - projects/project/regions/region/resourcePolicies/resourcePolicy + * - regions/region/resourcePolicies/resourcePolicy * * Generated from protobuf field optional string workload_policy = 114721530; * @return string @@ -58,7 +76,13 @@ public function clearWorkloadPolicy() } /** - * The URL of the workload policy that is specified for this managed instance group. It can be a full or partial URL. For example, the following are all valid URLs to a workload policy: - https://www.googleapis.com/compute/v1/projects/project/regions/region /resourcePolicies/resourcePolicy - projects/project/regions/region/resourcePolicies/resourcePolicy - regions/region/resourcePolicies/resourcePolicy + * The URL of the workload policy that is specified for this managed + * instance group. + * It can be a full or partial URL. For example, the following are + * all valid URLs to a workload policy: + * - https://www.googleapis.com/compute/v1/projects/project/regions/region/resourcePolicies/resourcePolicy + * - projects/project/regions/region/resourcePolicies/resourcePolicy + * - regions/region/resourcePolicies/resourcePolicy * * Generated from protobuf field optional string workload_policy = 114721530; * @param string $var diff --git a/Compute/src/V1/InstanceGroupManagerStandbyPolicy.php b/Compute/src/V1/InstanceGroupManagerStandbyPolicy.php index fa3377d50828..95da39dae36c 100644 --- a/Compute/src/V1/InstanceGroupManagerStandbyPolicy.php +++ b/Compute/src/V1/InstanceGroupManagerStandbyPolicy.php @@ -15,13 +15,18 @@ class InstanceGroupManagerStandbyPolicy extends \Google\Protobuf\Internal\Message { /** - * Specifies the number of seconds that the MIG should wait to suspend or stop a VM after that VM was created. The initial delay gives the initialization script the time to prepare your VM for a quick scale out. The value of initial delay must be between 0 and 3600 seconds. The default value is 0. + * Specifies the number of seconds that the MIG should wait to suspend or + * stop a VM after that VM was created. The initial delay gives the + * initialization script the time to prepare your VM for a quick scale out. + * The value of initial delay must be between 0 and 3600 seconds. The + * default value is 0. * * Generated from protobuf field optional int32 initial_delay_sec = 263207002; */ protected $initial_delay_sec = null; /** - * Defines how a MIG resumes or starts VMs from a standby pool when the group scales out. The default mode is `MANUAL`. + * Defines how a MIG resumes or starts VMs from a standby pool when the + * group scales out. The default mode is `MANUAL`. * Check the Mode enum for the list of possible values. * * Generated from protobuf field optional string mode = 3357091; @@ -35,9 +40,14 @@ class InstanceGroupManagerStandbyPolicy extends \Google\Protobuf\Internal\Messag * Optional. Data for populating the Message object. * * @type int $initial_delay_sec - * Specifies the number of seconds that the MIG should wait to suspend or stop a VM after that VM was created. The initial delay gives the initialization script the time to prepare your VM for a quick scale out. The value of initial delay must be between 0 and 3600 seconds. The default value is 0. + * Specifies the number of seconds that the MIG should wait to suspend or + * stop a VM after that VM was created. The initial delay gives the + * initialization script the time to prepare your VM for a quick scale out. + * The value of initial delay must be between 0 and 3600 seconds. The + * default value is 0. * @type string $mode - * Defines how a MIG resumes or starts VMs from a standby pool when the group scales out. The default mode is `MANUAL`. + * Defines how a MIG resumes or starts VMs from a standby pool when the + * group scales out. The default mode is `MANUAL`. * Check the Mode enum for the list of possible values. * } */ @@ -47,7 +57,11 @@ public function __construct($data = NULL) { } /** - * Specifies the number of seconds that the MIG should wait to suspend or stop a VM after that VM was created. The initial delay gives the initialization script the time to prepare your VM for a quick scale out. The value of initial delay must be between 0 and 3600 seconds. The default value is 0. + * Specifies the number of seconds that the MIG should wait to suspend or + * stop a VM after that VM was created. The initial delay gives the + * initialization script the time to prepare your VM for a quick scale out. + * The value of initial delay must be between 0 and 3600 seconds. The + * default value is 0. * * Generated from protobuf field optional int32 initial_delay_sec = 263207002; * @return int @@ -68,7 +82,11 @@ public function clearInitialDelaySec() } /** - * Specifies the number of seconds that the MIG should wait to suspend or stop a VM after that VM was created. The initial delay gives the initialization script the time to prepare your VM for a quick scale out. The value of initial delay must be between 0 and 3600 seconds. The default value is 0. + * Specifies the number of seconds that the MIG should wait to suspend or + * stop a VM after that VM was created. The initial delay gives the + * initialization script the time to prepare your VM for a quick scale out. + * The value of initial delay must be between 0 and 3600 seconds. The + * default value is 0. * * Generated from protobuf field optional int32 initial_delay_sec = 263207002; * @param int $var @@ -83,7 +101,8 @@ public function setInitialDelaySec($var) } /** - * Defines how a MIG resumes or starts VMs from a standby pool when the group scales out. The default mode is `MANUAL`. + * Defines how a MIG resumes or starts VMs from a standby pool when the + * group scales out. The default mode is `MANUAL`. * Check the Mode enum for the list of possible values. * * Generated from protobuf field optional string mode = 3357091; @@ -105,7 +124,8 @@ public function clearMode() } /** - * Defines how a MIG resumes or starts VMs from a standby pool when the group scales out. The default mode is `MANUAL`. + * Defines how a MIG resumes or starts VMs from a standby pool when the + * group scales out. The default mode is `MANUAL`. * Check the Mode enum for the list of possible values. * * Generated from protobuf field optional string mode = 3357091; diff --git a/Compute/src/V1/InstanceGroupManagerStandbyPolicy/Mode.php b/Compute/src/V1/InstanceGroupManagerStandbyPolicy/Mode.php index 2c888ccc4526..0e3762cf8f1c 100644 --- a/Compute/src/V1/InstanceGroupManagerStandbyPolicy/Mode.php +++ b/Compute/src/V1/InstanceGroupManagerStandbyPolicy/Mode.php @@ -7,7 +7,8 @@ use UnexpectedValueException; /** - * Defines how a MIG resumes or starts VMs from a standby pool when the group scales out. The default mode is `MANUAL`. + * Defines how a MIG resumes or starts VMs from a standby pool when the + * group scales out. The default mode is `MANUAL`. * * Protobuf type google.cloud.compute.v1.InstanceGroupManagerStandbyPolicy.Mode */ @@ -20,13 +21,15 @@ class Mode */ const UNDEFINED_MODE = 0; /** - * MIG does not automatically resume or start VMs in the standby pool when the group scales out. + * MIG does not automatically resume or start VMs in the standby pool when + * the group scales out. * * Generated from protobuf enum MANUAL = 119397318; */ const MANUAL = 119397318; /** - * MIG automatically resumes or starts VMs in the standby pool when the group scales out, and replenishes the standby pool afterwards. + * MIG automatically resumes or starts VMs in the standby pool when the + * group scales out, and replenishes the standby pool afterwards. * * Generated from protobuf enum SCALE_OUT_POOL = 635394; */ diff --git a/Compute/src/V1/InstanceGroupManagerStatus.php b/Compute/src/V1/InstanceGroupManagerStatus.php index feebda7817b6..49d6cdbba799 100644 --- a/Compute/src/V1/InstanceGroupManagerStatus.php +++ b/Compute/src/V1/InstanceGroupManagerStatus.php @@ -21,13 +21,19 @@ class InstanceGroupManagerStatus extends \Google\Protobuf\Internal\Message */ protected $all_instances_config = null; /** - * [Output Only] The URL of the Autoscaler that targets this instance group manager. + * [Output Only] The URL of theAutoscaler + * that targets this instance group manager. * * Generated from protobuf field optional string autoscaler = 517258967; */ protected $autoscaler = null; /** - * [Output Only] A bit indicating whether the managed instance group is in a stable state. A stable state means that: none of the instances in the managed instance group is currently undergoing any type of change (for example, creation, restart, or deletion); no future changes are scheduled for instances in the managed instance group; and the managed instance group itself is not being modified. + * [Output Only] A bit indicating whether the managed instance group is in a + * stable state. A stable state means that: none of the instances in the + * managed instance group is currently undergoing any type of change (for + * example, creation, restart, or deletion); no future changes are scheduled + * for instances in the managed instance group; and the managed instance + * group itself is not being modified. * * Generated from protobuf field optional bool is_stable = 108410864; */ @@ -39,7 +45,9 @@ class InstanceGroupManagerStatus extends \Google\Protobuf\Internal\Message */ protected $stateful = null; /** - * [Output Only] A status of consistency of Instances' versions with their target version specified by version field on Instance Group Manager. + * [Output Only] A status of consistency of Instances' versions with their + * target version specified by version field on Instance Group + * Manager. * * Generated from protobuf field optional .google.cloud.compute.v1.InstanceGroupManagerStatusVersionTarget version_target = 289386200; */ @@ -54,13 +62,21 @@ class InstanceGroupManagerStatus extends \Google\Protobuf\Internal\Message * @type \Google\Cloud\Compute\V1\InstanceGroupManagerStatusAllInstancesConfig $all_instances_config * [Output only] Status of all-instances configuration on the group. * @type string $autoscaler - * [Output Only] The URL of the Autoscaler that targets this instance group manager. + * [Output Only] The URL of theAutoscaler + * that targets this instance group manager. * @type bool $is_stable - * [Output Only] A bit indicating whether the managed instance group is in a stable state. A stable state means that: none of the instances in the managed instance group is currently undergoing any type of change (for example, creation, restart, or deletion); no future changes are scheduled for instances in the managed instance group; and the managed instance group itself is not being modified. + * [Output Only] A bit indicating whether the managed instance group is in a + * stable state. A stable state means that: none of the instances in the + * managed instance group is currently undergoing any type of change (for + * example, creation, restart, or deletion); no future changes are scheduled + * for instances in the managed instance group; and the managed instance + * group itself is not being modified. * @type \Google\Cloud\Compute\V1\InstanceGroupManagerStatusStateful $stateful * [Output Only] Stateful status of the given Instance Group Manager. * @type \Google\Cloud\Compute\V1\InstanceGroupManagerStatusVersionTarget $version_target - * [Output Only] A status of consistency of Instances' versions with their target version specified by version field on Instance Group Manager. + * [Output Only] A status of consistency of Instances' versions with their + * target version specified by version field on Instance Group + * Manager. * } */ public function __construct($data = NULL) { @@ -105,7 +121,8 @@ public function setAllInstancesConfig($var) } /** - * [Output Only] The URL of the Autoscaler that targets this instance group manager. + * [Output Only] The URL of theAutoscaler + * that targets this instance group manager. * * Generated from protobuf field optional string autoscaler = 517258967; * @return string @@ -126,7 +143,8 @@ public function clearAutoscaler() } /** - * [Output Only] The URL of the Autoscaler that targets this instance group manager. + * [Output Only] The URL of theAutoscaler + * that targets this instance group manager. * * Generated from protobuf field optional string autoscaler = 517258967; * @param string $var @@ -141,7 +159,12 @@ public function setAutoscaler($var) } /** - * [Output Only] A bit indicating whether the managed instance group is in a stable state. A stable state means that: none of the instances in the managed instance group is currently undergoing any type of change (for example, creation, restart, or deletion); no future changes are scheduled for instances in the managed instance group; and the managed instance group itself is not being modified. + * [Output Only] A bit indicating whether the managed instance group is in a + * stable state. A stable state means that: none of the instances in the + * managed instance group is currently undergoing any type of change (for + * example, creation, restart, or deletion); no future changes are scheduled + * for instances in the managed instance group; and the managed instance + * group itself is not being modified. * * Generated from protobuf field optional bool is_stable = 108410864; * @return bool @@ -162,7 +185,12 @@ public function clearIsStable() } /** - * [Output Only] A bit indicating whether the managed instance group is in a stable state. A stable state means that: none of the instances in the managed instance group is currently undergoing any type of change (for example, creation, restart, or deletion); no future changes are scheduled for instances in the managed instance group; and the managed instance group itself is not being modified. + * [Output Only] A bit indicating whether the managed instance group is in a + * stable state. A stable state means that: none of the instances in the + * managed instance group is currently undergoing any type of change (for + * example, creation, restart, or deletion); no future changes are scheduled + * for instances in the managed instance group; and the managed instance + * group itself is not being modified. * * Generated from protobuf field optional bool is_stable = 108410864; * @param bool $var @@ -213,7 +241,9 @@ public function setStateful($var) } /** - * [Output Only] A status of consistency of Instances' versions with their target version specified by version field on Instance Group Manager. + * [Output Only] A status of consistency of Instances' versions with their + * target version specified by version field on Instance Group + * Manager. * * Generated from protobuf field optional .google.cloud.compute.v1.InstanceGroupManagerStatusVersionTarget version_target = 289386200; * @return \Google\Cloud\Compute\V1\InstanceGroupManagerStatusVersionTarget|null @@ -234,7 +264,9 @@ public function clearVersionTarget() } /** - * [Output Only] A status of consistency of Instances' versions with their target version specified by version field on Instance Group Manager. + * [Output Only] A status of consistency of Instances' versions with their + * target version specified by version field on Instance Group + * Manager. * * Generated from protobuf field optional .google.cloud.compute.v1.InstanceGroupManagerStatusVersionTarget version_target = 289386200; * @param \Google\Cloud\Compute\V1\InstanceGroupManagerStatusVersionTarget $var diff --git a/Compute/src/V1/InstanceGroupManagerStatusAllInstancesConfig.php b/Compute/src/V1/InstanceGroupManagerStatusAllInstancesConfig.php index 5fe8105edfa9..79b8d5d6b6bd 100644 --- a/Compute/src/V1/InstanceGroupManagerStatusAllInstancesConfig.php +++ b/Compute/src/V1/InstanceGroupManagerStatusAllInstancesConfig.php @@ -15,13 +15,15 @@ class InstanceGroupManagerStatusAllInstancesConfig extends \Google\Protobuf\Internal\Message { /** - * [Output Only] Current all-instances configuration revision. This value is in RFC3339 text format. + * [Output Only] Current all-instances configuration revision. + * This value is in RFC3339 text format. * * Generated from protobuf field optional string current_revision = 38355937; */ protected $current_revision = null; /** - * [Output Only] A bit indicating whether this configuration has been applied to all managed instances in the group. + * [Output Only] A bit indicating whether this configuration has + * been applied to all managed instances in the group. * * Generated from protobuf field optional bool effective = 141961639; */ @@ -34,9 +36,11 @@ class InstanceGroupManagerStatusAllInstancesConfig extends \Google\Protobuf\Inte * Optional. Data for populating the Message object. * * @type string $current_revision - * [Output Only] Current all-instances configuration revision. This value is in RFC3339 text format. + * [Output Only] Current all-instances configuration revision. + * This value is in RFC3339 text format. * @type bool $effective - * [Output Only] A bit indicating whether this configuration has been applied to all managed instances in the group. + * [Output Only] A bit indicating whether this configuration has + * been applied to all managed instances in the group. * } */ public function __construct($data = NULL) { @@ -45,7 +49,8 @@ public function __construct($data = NULL) { } /** - * [Output Only] Current all-instances configuration revision. This value is in RFC3339 text format. + * [Output Only] Current all-instances configuration revision. + * This value is in RFC3339 text format. * * Generated from protobuf field optional string current_revision = 38355937; * @return string @@ -66,7 +71,8 @@ public function clearCurrentRevision() } /** - * [Output Only] Current all-instances configuration revision. This value is in RFC3339 text format. + * [Output Only] Current all-instances configuration revision. + * This value is in RFC3339 text format. * * Generated from protobuf field optional string current_revision = 38355937; * @param string $var @@ -81,7 +87,8 @@ public function setCurrentRevision($var) } /** - * [Output Only] A bit indicating whether this configuration has been applied to all managed instances in the group. + * [Output Only] A bit indicating whether this configuration has + * been applied to all managed instances in the group. * * Generated from protobuf field optional bool effective = 141961639; * @return bool @@ -102,7 +109,8 @@ public function clearEffective() } /** - * [Output Only] A bit indicating whether this configuration has been applied to all managed instances in the group. + * [Output Only] A bit indicating whether this configuration has + * been applied to all managed instances in the group. * * Generated from protobuf field optional bool effective = 141961639; * @param bool $var diff --git a/Compute/src/V1/InstanceGroupManagerStatusStateful.php b/Compute/src/V1/InstanceGroupManagerStatusStateful.php index 3b052f173d82..61be323f9545 100644 --- a/Compute/src/V1/InstanceGroupManagerStatusStateful.php +++ b/Compute/src/V1/InstanceGroupManagerStatusStateful.php @@ -15,7 +15,12 @@ class InstanceGroupManagerStatusStateful extends \Google\Protobuf\Internal\Message { /** - * [Output Only] A bit indicating whether the managed instance group has stateful configuration, that is, if you have configured any items in a stateful policy or in per-instance configs. The group might report that it has no stateful configuration even when there is still some preserved state on a managed instance, for example, if you have deleted all PICs but not yet applied those deletions. + * [Output Only] A bit indicating whether the managed instance group + * has stateful configuration, that is, if you have configured any items + * in a stateful policy or in per-instance configs. + * The group might report that it has no stateful configuration even when + * there is still some preserved state on a managed instance, for example, + * if you have deleted all PICs but not yet applied those deletions. * * Generated from protobuf field optional bool has_stateful_config = 110474224; */ @@ -34,7 +39,12 @@ class InstanceGroupManagerStatusStateful extends \Google\Protobuf\Internal\Messa * Optional. Data for populating the Message object. * * @type bool $has_stateful_config - * [Output Only] A bit indicating whether the managed instance group has stateful configuration, that is, if you have configured any items in a stateful policy or in per-instance configs. The group might report that it has no stateful configuration even when there is still some preserved state on a managed instance, for example, if you have deleted all PICs but not yet applied those deletions. + * [Output Only] A bit indicating whether the managed instance group + * has stateful configuration, that is, if you have configured any items + * in a stateful policy or in per-instance configs. + * The group might report that it has no stateful configuration even when + * there is still some preserved state on a managed instance, for example, + * if you have deleted all PICs but not yet applied those deletions. * @type \Google\Cloud\Compute\V1\InstanceGroupManagerStatusStatefulPerInstanceConfigs $per_instance_configs * [Output Only] Status of per-instance configurations on the instances. * } @@ -45,7 +55,12 @@ public function __construct($data = NULL) { } /** - * [Output Only] A bit indicating whether the managed instance group has stateful configuration, that is, if you have configured any items in a stateful policy or in per-instance configs. The group might report that it has no stateful configuration even when there is still some preserved state on a managed instance, for example, if you have deleted all PICs but not yet applied those deletions. + * [Output Only] A bit indicating whether the managed instance group + * has stateful configuration, that is, if you have configured any items + * in a stateful policy or in per-instance configs. + * The group might report that it has no stateful configuration even when + * there is still some preserved state on a managed instance, for example, + * if you have deleted all PICs but not yet applied those deletions. * * Generated from protobuf field optional bool has_stateful_config = 110474224; * @return bool @@ -66,7 +81,12 @@ public function clearHasStatefulConfig() } /** - * [Output Only] A bit indicating whether the managed instance group has stateful configuration, that is, if you have configured any items in a stateful policy or in per-instance configs. The group might report that it has no stateful configuration even when there is still some preserved state on a managed instance, for example, if you have deleted all PICs but not yet applied those deletions. + * [Output Only] A bit indicating whether the managed instance group + * has stateful configuration, that is, if you have configured any items + * in a stateful policy or in per-instance configs. + * The group might report that it has no stateful configuration even when + * there is still some preserved state on a managed instance, for example, + * if you have deleted all PICs but not yet applied those deletions. * * Generated from protobuf field optional bool has_stateful_config = 110474224; * @param bool $var diff --git a/Compute/src/V1/InstanceGroupManagerStatusStatefulPerInstanceConfigs.php b/Compute/src/V1/InstanceGroupManagerStatusStatefulPerInstanceConfigs.php index b68e4dc5655e..0523850d4600 100644 --- a/Compute/src/V1/InstanceGroupManagerStatusStatefulPerInstanceConfigs.php +++ b/Compute/src/V1/InstanceGroupManagerStatusStatefulPerInstanceConfigs.php @@ -15,7 +15,9 @@ class InstanceGroupManagerStatusStatefulPerInstanceConfigs extends \Google\Protobuf\Internal\Message { /** - * A bit indicating if all of the group's per-instance configurations (listed in the output of a listPerInstanceConfigs API call) have status EFFECTIVE or there are no per-instance-configs. + * A bit indicating if all of the group's per-instance configurations + * (listed in the output of a listPerInstanceConfigs API call) have + * status EFFECTIVE or there are no per-instance-configs. * * Generated from protobuf field optional bool all_effective = 516540553; */ @@ -28,7 +30,9 @@ class InstanceGroupManagerStatusStatefulPerInstanceConfigs extends \Google\Proto * Optional. Data for populating the Message object. * * @type bool $all_effective - * A bit indicating if all of the group's per-instance configurations (listed in the output of a listPerInstanceConfigs API call) have status EFFECTIVE or there are no per-instance-configs. + * A bit indicating if all of the group's per-instance configurations + * (listed in the output of a listPerInstanceConfigs API call) have + * status EFFECTIVE or there are no per-instance-configs. * } */ public function __construct($data = NULL) { @@ -37,7 +41,9 @@ public function __construct($data = NULL) { } /** - * A bit indicating if all of the group's per-instance configurations (listed in the output of a listPerInstanceConfigs API call) have status EFFECTIVE or there are no per-instance-configs. + * A bit indicating if all of the group's per-instance configurations + * (listed in the output of a listPerInstanceConfigs API call) have + * status EFFECTIVE or there are no per-instance-configs. * * Generated from protobuf field optional bool all_effective = 516540553; * @return bool @@ -58,7 +64,9 @@ public function clearAllEffective() } /** - * A bit indicating if all of the group's per-instance configurations (listed in the output of a listPerInstanceConfigs API call) have status EFFECTIVE or there are no per-instance-configs. + * A bit indicating if all of the group's per-instance configurations + * (listed in the output of a listPerInstanceConfigs API call) have + * status EFFECTIVE or there are no per-instance-configs. * * Generated from protobuf field optional bool all_effective = 516540553; * @param bool $var diff --git a/Compute/src/V1/InstanceGroupManagerStatusVersionTarget.php b/Compute/src/V1/InstanceGroupManagerStatusVersionTarget.php index 3cb8e8efacdb..88f9dd9d0423 100644 --- a/Compute/src/V1/InstanceGroupManagerStatusVersionTarget.php +++ b/Compute/src/V1/InstanceGroupManagerStatusVersionTarget.php @@ -15,7 +15,9 @@ class InstanceGroupManagerStatusVersionTarget extends \Google\Protobuf\Internal\Message { /** - * [Output Only] A bit indicating whether version target has been reached in this managed instance group, i.e. all instances are in their target version. Instances' target version are specified by version field on Instance Group Manager. + * [Output Only] A bit indicating whether version target has been reached + * in this managed instance group, i.e. all instances are in their target + * version. Instances' target version are specified byversion field on Instance Group Manager. * * Generated from protobuf field optional bool is_reached = 433209149; */ @@ -28,7 +30,9 @@ class InstanceGroupManagerStatusVersionTarget extends \Google\Protobuf\Internal\ * Optional. Data for populating the Message object. * * @type bool $is_reached - * [Output Only] A bit indicating whether version target has been reached in this managed instance group, i.e. all instances are in their target version. Instances' target version are specified by version field on Instance Group Manager. + * [Output Only] A bit indicating whether version target has been reached + * in this managed instance group, i.e. all instances are in their target + * version. Instances' target version are specified byversion field on Instance Group Manager. * } */ public function __construct($data = NULL) { @@ -37,7 +41,9 @@ public function __construct($data = NULL) { } /** - * [Output Only] A bit indicating whether version target has been reached in this managed instance group, i.e. all instances are in their target version. Instances' target version are specified by version field on Instance Group Manager. + * [Output Only] A bit indicating whether version target has been reached + * in this managed instance group, i.e. all instances are in their target + * version. Instances' target version are specified byversion field on Instance Group Manager. * * Generated from protobuf field optional bool is_reached = 433209149; * @return bool @@ -58,7 +64,9 @@ public function clearIsReached() } /** - * [Output Only] A bit indicating whether version target has been reached in this managed instance group, i.e. all instances are in their target version. Instances' target version are specified by version field on Instance Group Manager. + * [Output Only] A bit indicating whether version target has been reached + * in this managed instance group, i.e. all instances are in their target + * version. Instances' target version are specified byversion field on Instance Group Manager. * * Generated from protobuf field optional bool is_reached = 433209149; * @param bool $var diff --git a/Compute/src/V1/InstanceGroupManagerUpdatePolicy.php b/Compute/src/V1/InstanceGroupManagerUpdatePolicy.php index d50ab874da0c..01a4947f9a38 100644 --- a/Compute/src/V1/InstanceGroupManagerUpdatePolicy.php +++ b/Compute/src/V1/InstanceGroupManagerUpdatePolicy.php @@ -15,47 +15,93 @@ class InstanceGroupManagerUpdatePolicy extends \Google\Protobuf\Internal\Message { /** - * The instance redistribution policy for regional managed instance groups. Valid values are: - PROACTIVE (default): The group attempts to maintain an even distribution of VM instances across zones in the region. - NONE: For non-autoscaled groups, proactive redistribution is disabled. + * The + * instance redistribution policy for regional managed instance groups. + * Valid values are: + * - PROACTIVE (default): The group attempts to maintain an + * even distribution of VM instances across zones in the region. + * - NONE: For non-autoscaled groups, proactive + * redistribution is disabled. * Check the InstanceRedistributionType enum for the list of possible values. * * Generated from protobuf field optional string instance_redistribution_type = 292630424; */ protected $instance_redistribution_type = null; /** - * The maximum number of instances that can be created above the specified targetSize during the update process. This value can be either a fixed number or, if the group has 10 or more instances, a percentage. If you set a percentage, the number of instances is rounded if necessary. The default value for maxSurge is a fixed value equal to the number of zones in which the managed instance group operates. At least one of either maxSurge or maxUnavailable must be greater than 0. Learn more about maxSurge. + * The maximum number of instances that can be created above the specifiedtargetSize during the update process. This value can be + * either a fixed number or, if the group has 10 or more instances, a + * percentage. If you set a percentage, the number of instances is rounded + * if necessary. The default value for maxSurge is a fixed + * value equal to the number of zones in which the managed instance group + * operates. + * At least one of either maxSurge ormaxUnavailable must be greater than 0. Learn more about maxSurge. * * Generated from protobuf field optional .google.cloud.compute.v1.FixedOrPercent max_surge = 302572691; */ protected $max_surge = null; /** - * The maximum number of instances that can be unavailable during the update process. An instance is considered available if all of the following conditions are satisfied: - The instance's status is RUNNING. - If there is a health check on the instance group, the instance's health check status must be HEALTHY at least once. If there is no health check on the group, then the instance only needs to have a status of RUNNING to be considered available. This value can be either a fixed number or, if the group has 10 or more instances, a percentage. If you set a percentage, the number of instances is rounded if necessary. The default value for maxUnavailable is a fixed value equal to the number of zones in which the managed instance group operates. At least one of either maxSurge or maxUnavailable must be greater than 0. Learn more about maxUnavailable. + * The maximum number of instances that can be unavailable during the update + * process. An instance is considered available if all of the following + * conditions are satisfied: + * - The instance's status is + * RUNNING. + * - If there is a health + * check on the instance group, the instance's health check status + * must be HEALTHY at least once. If there is no health check + * on the group, then the instance only needs to have a status of + * RUNNING to be considered available. + * This value can be either a fixed number or, if the group has 10 or more + * instances, a percentage. If you set a percentage, the number of instances + * is rounded if necessary. The default value formaxUnavailable is a fixed value equal to the number of zones + * in which the managed instance group operates. + * At least one of either maxSurge ormaxUnavailable must be greater than 0. Learn more about maxUnavailable. * * Generated from protobuf field optional .google.cloud.compute.v1.FixedOrPercent max_unavailable = 404940277; */ protected $max_unavailable = null; /** - * Minimal action to be taken on an instance. Use this option to minimize disruption as much as possible or to apply a more disruptive action than is necessary. - To limit disruption as much as possible, set the minimal action to REFRESH. If your update requires a more disruptive action, Compute Engine performs the necessary action to execute the update. - To apply a more disruptive action than is strictly necessary, set the minimal action to RESTART or REPLACE. For example, Compute Engine does not need to restart a VM to change its metadata. But if your application reads instance metadata only when a VM is restarted, you can set the minimal action to RESTART in order to pick up metadata changes. + * Minimal action to be taken on an instance. Use this option to minimize + * disruption as much as possible or to apply a more disruptive action than + * is necessary. + * - To limit disruption as much as possible, set the minimal action toREFRESH. If your update requires a more disruptive action, + * Compute Engine performs the necessary action to execute the update. + * - To apply a more disruptive action than is strictly necessary, set the + * minimal action to RESTART or REPLACE. For + * example, Compute Engine does not need to restart a VM to change its + * metadata. But if your application reads instance metadata only when a VM + * is restarted, you can set the minimal action to RESTART in + * order to pick up metadata changes. * Check the MinimalAction enum for the list of possible values. * * Generated from protobuf field optional string minimal_action = 270567060; */ protected $minimal_action = null; /** - * Most disruptive action that is allowed to be taken on an instance. You can specify either NONE to forbid any actions, REFRESH to avoid restarting the VM and to limit disruption as much as possible. RESTART to allow actions that can be applied without instance replacing or REPLACE to allow all possible actions. If the Updater determines that the minimal update action needed is more disruptive than most disruptive allowed action you specify it will not perform the update at all. + * Most disruptive action that is allowed to be taken on an instance. + * You can specify either NONE to forbid any actions,REFRESH to avoid restarting the VM and to limit disruption + * as much as possible. RESTART to allow actions that can be + * applied without instance replacing or REPLACE to allow all + * possible actions. If the Updater determines that the minimal update + * action needed is more disruptive than most disruptive allowed action you + * specify it will not perform the update at all. * Check the MostDisruptiveAllowedAction enum for the list of possible values. * * Generated from protobuf field optional string most_disruptive_allowed_action = 66103053; */ protected $most_disruptive_allowed_action = null; /** - * What action should be used to replace instances. See minimal_action.REPLACE + * What action should be used to replace instances. + * See minimal_action.REPLACE * Check the ReplacementMethod enum for the list of possible values. * * Generated from protobuf field optional string replacement_method = 505931694; */ protected $replacement_method = null; /** - * The type of update process. You can specify either PROACTIVE so that the MIG automatically updates VMs to the latest configurations or OPPORTUNISTIC so that you can select the VMs that you want to update. + * The type + * of update process. You can specify either PROACTIVE so + * that the MIG automatically updates VMs to the latest configurations orOPPORTUNISTIC so that you can select the VMs that you want + * to update. * Check the Type enum for the list of possible values. * * Generated from protobuf field optional string type = 3575610; @@ -69,23 +115,69 @@ class InstanceGroupManagerUpdatePolicy extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $instance_redistribution_type - * The instance redistribution policy for regional managed instance groups. Valid values are: - PROACTIVE (default): The group attempts to maintain an even distribution of VM instances across zones in the region. - NONE: For non-autoscaled groups, proactive redistribution is disabled. + * The + * instance redistribution policy for regional managed instance groups. + * Valid values are: + * - PROACTIVE (default): The group attempts to maintain an + * even distribution of VM instances across zones in the region. + * - NONE: For non-autoscaled groups, proactive + * redistribution is disabled. * Check the InstanceRedistributionType enum for the list of possible values. * @type \Google\Cloud\Compute\V1\FixedOrPercent $max_surge - * The maximum number of instances that can be created above the specified targetSize during the update process. This value can be either a fixed number or, if the group has 10 or more instances, a percentage. If you set a percentage, the number of instances is rounded if necessary. The default value for maxSurge is a fixed value equal to the number of zones in which the managed instance group operates. At least one of either maxSurge or maxUnavailable must be greater than 0. Learn more about maxSurge. + * The maximum number of instances that can be created above the specifiedtargetSize during the update process. This value can be + * either a fixed number or, if the group has 10 or more instances, a + * percentage. If you set a percentage, the number of instances is rounded + * if necessary. The default value for maxSurge is a fixed + * value equal to the number of zones in which the managed instance group + * operates. + * At least one of either maxSurge ormaxUnavailable must be greater than 0. Learn more about maxSurge. * @type \Google\Cloud\Compute\V1\FixedOrPercent $max_unavailable - * The maximum number of instances that can be unavailable during the update process. An instance is considered available if all of the following conditions are satisfied: - The instance's status is RUNNING. - If there is a health check on the instance group, the instance's health check status must be HEALTHY at least once. If there is no health check on the group, then the instance only needs to have a status of RUNNING to be considered available. This value can be either a fixed number or, if the group has 10 or more instances, a percentage. If you set a percentage, the number of instances is rounded if necessary. The default value for maxUnavailable is a fixed value equal to the number of zones in which the managed instance group operates. At least one of either maxSurge or maxUnavailable must be greater than 0. Learn more about maxUnavailable. + * The maximum number of instances that can be unavailable during the update + * process. An instance is considered available if all of the following + * conditions are satisfied: + * - The instance's status is + * RUNNING. + * - If there is a health + * check on the instance group, the instance's health check status + * must be HEALTHY at least once. If there is no health check + * on the group, then the instance only needs to have a status of + * RUNNING to be considered available. + * This value can be either a fixed number or, if the group has 10 or more + * instances, a percentage. If you set a percentage, the number of instances + * is rounded if necessary. The default value formaxUnavailable is a fixed value equal to the number of zones + * in which the managed instance group operates. + * At least one of either maxSurge ormaxUnavailable must be greater than 0. Learn more about maxUnavailable. * @type string $minimal_action - * Minimal action to be taken on an instance. Use this option to minimize disruption as much as possible or to apply a more disruptive action than is necessary. - To limit disruption as much as possible, set the minimal action to REFRESH. If your update requires a more disruptive action, Compute Engine performs the necessary action to execute the update. - To apply a more disruptive action than is strictly necessary, set the minimal action to RESTART or REPLACE. For example, Compute Engine does not need to restart a VM to change its metadata. But if your application reads instance metadata only when a VM is restarted, you can set the minimal action to RESTART in order to pick up metadata changes. + * Minimal action to be taken on an instance. Use this option to minimize + * disruption as much as possible or to apply a more disruptive action than + * is necessary. + * - To limit disruption as much as possible, set the minimal action toREFRESH. If your update requires a more disruptive action, + * Compute Engine performs the necessary action to execute the update. + * - To apply a more disruptive action than is strictly necessary, set the + * minimal action to RESTART or REPLACE. For + * example, Compute Engine does not need to restart a VM to change its + * metadata. But if your application reads instance metadata only when a VM + * is restarted, you can set the minimal action to RESTART in + * order to pick up metadata changes. * Check the MinimalAction enum for the list of possible values. * @type string $most_disruptive_allowed_action - * Most disruptive action that is allowed to be taken on an instance. You can specify either NONE to forbid any actions, REFRESH to avoid restarting the VM and to limit disruption as much as possible. RESTART to allow actions that can be applied without instance replacing or REPLACE to allow all possible actions. If the Updater determines that the minimal update action needed is more disruptive than most disruptive allowed action you specify it will not perform the update at all. + * Most disruptive action that is allowed to be taken on an instance. + * You can specify either NONE to forbid any actions,REFRESH to avoid restarting the VM and to limit disruption + * as much as possible. RESTART to allow actions that can be + * applied without instance replacing or REPLACE to allow all + * possible actions. If the Updater determines that the minimal update + * action needed is more disruptive than most disruptive allowed action you + * specify it will not perform the update at all. * Check the MostDisruptiveAllowedAction enum for the list of possible values. * @type string $replacement_method - * What action should be used to replace instances. See minimal_action.REPLACE + * What action should be used to replace instances. + * See minimal_action.REPLACE * Check the ReplacementMethod enum for the list of possible values. * @type string $type - * The type of update process. You can specify either PROACTIVE so that the MIG automatically updates VMs to the latest configurations or OPPORTUNISTIC so that you can select the VMs that you want to update. + * The type + * of update process. You can specify either PROACTIVE so + * that the MIG automatically updates VMs to the latest configurations orOPPORTUNISTIC so that you can select the VMs that you want + * to update. * Check the Type enum for the list of possible values. * } */ @@ -95,7 +187,13 @@ public function __construct($data = NULL) { } /** - * The instance redistribution policy for regional managed instance groups. Valid values are: - PROACTIVE (default): The group attempts to maintain an even distribution of VM instances across zones in the region. - NONE: For non-autoscaled groups, proactive redistribution is disabled. + * The + * instance redistribution policy for regional managed instance groups. + * Valid values are: + * - PROACTIVE (default): The group attempts to maintain an + * even distribution of VM instances across zones in the region. + * - NONE: For non-autoscaled groups, proactive + * redistribution is disabled. * Check the InstanceRedistributionType enum for the list of possible values. * * Generated from protobuf field optional string instance_redistribution_type = 292630424; @@ -117,7 +215,13 @@ public function clearInstanceRedistributionType() } /** - * The instance redistribution policy for regional managed instance groups. Valid values are: - PROACTIVE (default): The group attempts to maintain an even distribution of VM instances across zones in the region. - NONE: For non-autoscaled groups, proactive redistribution is disabled. + * The + * instance redistribution policy for regional managed instance groups. + * Valid values are: + * - PROACTIVE (default): The group attempts to maintain an + * even distribution of VM instances across zones in the region. + * - NONE: For non-autoscaled groups, proactive + * redistribution is disabled. * Check the InstanceRedistributionType enum for the list of possible values. * * Generated from protobuf field optional string instance_redistribution_type = 292630424; @@ -133,7 +237,13 @@ public function setInstanceRedistributionType($var) } /** - * The maximum number of instances that can be created above the specified targetSize during the update process. This value can be either a fixed number or, if the group has 10 or more instances, a percentage. If you set a percentage, the number of instances is rounded if necessary. The default value for maxSurge is a fixed value equal to the number of zones in which the managed instance group operates. At least one of either maxSurge or maxUnavailable must be greater than 0. Learn more about maxSurge. + * The maximum number of instances that can be created above the specifiedtargetSize during the update process. This value can be + * either a fixed number or, if the group has 10 or more instances, a + * percentage. If you set a percentage, the number of instances is rounded + * if necessary. The default value for maxSurge is a fixed + * value equal to the number of zones in which the managed instance group + * operates. + * At least one of either maxSurge ormaxUnavailable must be greater than 0. Learn more about maxSurge. * * Generated from protobuf field optional .google.cloud.compute.v1.FixedOrPercent max_surge = 302572691; * @return \Google\Cloud\Compute\V1\FixedOrPercent|null @@ -154,7 +264,13 @@ public function clearMaxSurge() } /** - * The maximum number of instances that can be created above the specified targetSize during the update process. This value can be either a fixed number or, if the group has 10 or more instances, a percentage. If you set a percentage, the number of instances is rounded if necessary. The default value for maxSurge is a fixed value equal to the number of zones in which the managed instance group operates. At least one of either maxSurge or maxUnavailable must be greater than 0. Learn more about maxSurge. + * The maximum number of instances that can be created above the specifiedtargetSize during the update process. This value can be + * either a fixed number or, if the group has 10 or more instances, a + * percentage. If you set a percentage, the number of instances is rounded + * if necessary. The default value for maxSurge is a fixed + * value equal to the number of zones in which the managed instance group + * operates. + * At least one of either maxSurge ormaxUnavailable must be greater than 0. Learn more about maxSurge. * * Generated from protobuf field optional .google.cloud.compute.v1.FixedOrPercent max_surge = 302572691; * @param \Google\Cloud\Compute\V1\FixedOrPercent $var @@ -169,7 +285,21 @@ public function setMaxSurge($var) } /** - * The maximum number of instances that can be unavailable during the update process. An instance is considered available if all of the following conditions are satisfied: - The instance's status is RUNNING. - If there is a health check on the instance group, the instance's health check status must be HEALTHY at least once. If there is no health check on the group, then the instance only needs to have a status of RUNNING to be considered available. This value can be either a fixed number or, if the group has 10 or more instances, a percentage. If you set a percentage, the number of instances is rounded if necessary. The default value for maxUnavailable is a fixed value equal to the number of zones in which the managed instance group operates. At least one of either maxSurge or maxUnavailable must be greater than 0. Learn more about maxUnavailable. + * The maximum number of instances that can be unavailable during the update + * process. An instance is considered available if all of the following + * conditions are satisfied: + * - The instance's status is + * RUNNING. + * - If there is a health + * check on the instance group, the instance's health check status + * must be HEALTHY at least once. If there is no health check + * on the group, then the instance only needs to have a status of + * RUNNING to be considered available. + * This value can be either a fixed number or, if the group has 10 or more + * instances, a percentage. If you set a percentage, the number of instances + * is rounded if necessary. The default value formaxUnavailable is a fixed value equal to the number of zones + * in which the managed instance group operates. + * At least one of either maxSurge ormaxUnavailable must be greater than 0. Learn more about maxUnavailable. * * Generated from protobuf field optional .google.cloud.compute.v1.FixedOrPercent max_unavailable = 404940277; * @return \Google\Cloud\Compute\V1\FixedOrPercent|null @@ -190,7 +320,21 @@ public function clearMaxUnavailable() } /** - * The maximum number of instances that can be unavailable during the update process. An instance is considered available if all of the following conditions are satisfied: - The instance's status is RUNNING. - If there is a health check on the instance group, the instance's health check status must be HEALTHY at least once. If there is no health check on the group, then the instance only needs to have a status of RUNNING to be considered available. This value can be either a fixed number or, if the group has 10 or more instances, a percentage. If you set a percentage, the number of instances is rounded if necessary. The default value for maxUnavailable is a fixed value equal to the number of zones in which the managed instance group operates. At least one of either maxSurge or maxUnavailable must be greater than 0. Learn more about maxUnavailable. + * The maximum number of instances that can be unavailable during the update + * process. An instance is considered available if all of the following + * conditions are satisfied: + * - The instance's status is + * RUNNING. + * - If there is a health + * check on the instance group, the instance's health check status + * must be HEALTHY at least once. If there is no health check + * on the group, then the instance only needs to have a status of + * RUNNING to be considered available. + * This value can be either a fixed number or, if the group has 10 or more + * instances, a percentage. If you set a percentage, the number of instances + * is rounded if necessary. The default value formaxUnavailable is a fixed value equal to the number of zones + * in which the managed instance group operates. + * At least one of either maxSurge ormaxUnavailable must be greater than 0. Learn more about maxUnavailable. * * Generated from protobuf field optional .google.cloud.compute.v1.FixedOrPercent max_unavailable = 404940277; * @param \Google\Cloud\Compute\V1\FixedOrPercent $var @@ -205,7 +349,17 @@ public function setMaxUnavailable($var) } /** - * Minimal action to be taken on an instance. Use this option to minimize disruption as much as possible or to apply a more disruptive action than is necessary. - To limit disruption as much as possible, set the minimal action to REFRESH. If your update requires a more disruptive action, Compute Engine performs the necessary action to execute the update. - To apply a more disruptive action than is strictly necessary, set the minimal action to RESTART or REPLACE. For example, Compute Engine does not need to restart a VM to change its metadata. But if your application reads instance metadata only when a VM is restarted, you can set the minimal action to RESTART in order to pick up metadata changes. + * Minimal action to be taken on an instance. Use this option to minimize + * disruption as much as possible or to apply a more disruptive action than + * is necessary. + * - To limit disruption as much as possible, set the minimal action toREFRESH. If your update requires a more disruptive action, + * Compute Engine performs the necessary action to execute the update. + * - To apply a more disruptive action than is strictly necessary, set the + * minimal action to RESTART or REPLACE. For + * example, Compute Engine does not need to restart a VM to change its + * metadata. But if your application reads instance metadata only when a VM + * is restarted, you can set the minimal action to RESTART in + * order to pick up metadata changes. * Check the MinimalAction enum for the list of possible values. * * Generated from protobuf field optional string minimal_action = 270567060; @@ -227,7 +381,17 @@ public function clearMinimalAction() } /** - * Minimal action to be taken on an instance. Use this option to minimize disruption as much as possible or to apply a more disruptive action than is necessary. - To limit disruption as much as possible, set the minimal action to REFRESH. If your update requires a more disruptive action, Compute Engine performs the necessary action to execute the update. - To apply a more disruptive action than is strictly necessary, set the minimal action to RESTART or REPLACE. For example, Compute Engine does not need to restart a VM to change its metadata. But if your application reads instance metadata only when a VM is restarted, you can set the minimal action to RESTART in order to pick up metadata changes. + * Minimal action to be taken on an instance. Use this option to minimize + * disruption as much as possible or to apply a more disruptive action than + * is necessary. + * - To limit disruption as much as possible, set the minimal action toREFRESH. If your update requires a more disruptive action, + * Compute Engine performs the necessary action to execute the update. + * - To apply a more disruptive action than is strictly necessary, set the + * minimal action to RESTART or REPLACE. For + * example, Compute Engine does not need to restart a VM to change its + * metadata. But if your application reads instance metadata only when a VM + * is restarted, you can set the minimal action to RESTART in + * order to pick up metadata changes. * Check the MinimalAction enum for the list of possible values. * * Generated from protobuf field optional string minimal_action = 270567060; @@ -243,7 +407,13 @@ public function setMinimalAction($var) } /** - * Most disruptive action that is allowed to be taken on an instance. You can specify either NONE to forbid any actions, REFRESH to avoid restarting the VM and to limit disruption as much as possible. RESTART to allow actions that can be applied without instance replacing or REPLACE to allow all possible actions. If the Updater determines that the minimal update action needed is more disruptive than most disruptive allowed action you specify it will not perform the update at all. + * Most disruptive action that is allowed to be taken on an instance. + * You can specify either NONE to forbid any actions,REFRESH to avoid restarting the VM and to limit disruption + * as much as possible. RESTART to allow actions that can be + * applied without instance replacing or REPLACE to allow all + * possible actions. If the Updater determines that the minimal update + * action needed is more disruptive than most disruptive allowed action you + * specify it will not perform the update at all. * Check the MostDisruptiveAllowedAction enum for the list of possible values. * * Generated from protobuf field optional string most_disruptive_allowed_action = 66103053; @@ -265,7 +435,13 @@ public function clearMostDisruptiveAllowedAction() } /** - * Most disruptive action that is allowed to be taken on an instance. You can specify either NONE to forbid any actions, REFRESH to avoid restarting the VM and to limit disruption as much as possible. RESTART to allow actions that can be applied without instance replacing or REPLACE to allow all possible actions. If the Updater determines that the minimal update action needed is more disruptive than most disruptive allowed action you specify it will not perform the update at all. + * Most disruptive action that is allowed to be taken on an instance. + * You can specify either NONE to forbid any actions,REFRESH to avoid restarting the VM and to limit disruption + * as much as possible. RESTART to allow actions that can be + * applied without instance replacing or REPLACE to allow all + * possible actions. If the Updater determines that the minimal update + * action needed is more disruptive than most disruptive allowed action you + * specify it will not perform the update at all. * Check the MostDisruptiveAllowedAction enum for the list of possible values. * * Generated from protobuf field optional string most_disruptive_allowed_action = 66103053; @@ -281,7 +457,8 @@ public function setMostDisruptiveAllowedAction($var) } /** - * What action should be used to replace instances. See minimal_action.REPLACE + * What action should be used to replace instances. + * See minimal_action.REPLACE * Check the ReplacementMethod enum for the list of possible values. * * Generated from protobuf field optional string replacement_method = 505931694; @@ -303,7 +480,8 @@ public function clearReplacementMethod() } /** - * What action should be used to replace instances. See minimal_action.REPLACE + * What action should be used to replace instances. + * See minimal_action.REPLACE * Check the ReplacementMethod enum for the list of possible values. * * Generated from protobuf field optional string replacement_method = 505931694; @@ -319,7 +497,10 @@ public function setReplacementMethod($var) } /** - * The type of update process. You can specify either PROACTIVE so that the MIG automatically updates VMs to the latest configurations or OPPORTUNISTIC so that you can select the VMs that you want to update. + * The type + * of update process. You can specify either PROACTIVE so + * that the MIG automatically updates VMs to the latest configurations orOPPORTUNISTIC so that you can select the VMs that you want + * to update. * Check the Type enum for the list of possible values. * * Generated from protobuf field optional string type = 3575610; @@ -341,7 +522,10 @@ public function clearType() } /** - * The type of update process. You can specify either PROACTIVE so that the MIG automatically updates VMs to the latest configurations or OPPORTUNISTIC so that you can select the VMs that you want to update. + * The type + * of update process. You can specify either PROACTIVE so + * that the MIG automatically updates VMs to the latest configurations orOPPORTUNISTIC so that you can select the VMs that you want + * to update. * Check the Type enum for the list of possible values. * * Generated from protobuf field optional string type = 3575610; diff --git a/Compute/src/V1/InstanceGroupManagerUpdatePolicy/InstanceRedistributionType.php b/Compute/src/V1/InstanceGroupManagerUpdatePolicy/InstanceRedistributionType.php index a0aeea9c6047..097cc37dedbb 100644 --- a/Compute/src/V1/InstanceGroupManagerUpdatePolicy/InstanceRedistributionType.php +++ b/Compute/src/V1/InstanceGroupManagerUpdatePolicy/InstanceRedistributionType.php @@ -7,7 +7,13 @@ use UnexpectedValueException; /** - * The instance redistribution policy for regional managed instance groups. Valid values are: - PROACTIVE (default): The group attempts to maintain an even distribution of VM instances across zones in the region. - NONE: For non-autoscaled groups, proactive redistribution is disabled. + * The + * instance redistribution policy for regional managed instance groups. + * Valid values are: + * - PROACTIVE (default): The group attempts to maintain an + * even distribution of VM instances across zones in the region. + * - NONE: For non-autoscaled groups, proactive + * redistribution is disabled. * Additional supported values which may be not listed in the enum directly due to technical reasons: * NONE * PROACTIVE diff --git a/Compute/src/V1/InstanceGroupManagerUpdatePolicy/MinimalAction.php b/Compute/src/V1/InstanceGroupManagerUpdatePolicy/MinimalAction.php index 7404ee560a29..32ac17266bd7 100644 --- a/Compute/src/V1/InstanceGroupManagerUpdatePolicy/MinimalAction.php +++ b/Compute/src/V1/InstanceGroupManagerUpdatePolicy/MinimalAction.php @@ -7,7 +7,17 @@ use UnexpectedValueException; /** - * Minimal action to be taken on an instance. Use this option to minimize disruption as much as possible or to apply a more disruptive action than is necessary. - To limit disruption as much as possible, set the minimal action to REFRESH. If your update requires a more disruptive action, Compute Engine performs the necessary action to execute the update. - To apply a more disruptive action than is strictly necessary, set the minimal action to RESTART or REPLACE. For example, Compute Engine does not need to restart a VM to change its metadata. But if your application reads instance metadata only when a VM is restarted, you can set the minimal action to RESTART in order to pick up metadata changes. + * Minimal action to be taken on an instance. Use this option to minimize + * disruption as much as possible or to apply a more disruptive action than + * is necessary. + * - To limit disruption as much as possible, set the minimal action toREFRESH. If your update requires a more disruptive action, + * Compute Engine performs the necessary action to execute the update. + * - To apply a more disruptive action than is strictly necessary, set the + * minimal action to RESTART or REPLACE. For + * example, Compute Engine does not need to restart a VM to change its + * metadata. But if your application reads instance metadata only when a VM + * is restarted, you can set the minimal action to RESTART in + * order to pick up metadata changes. * Additional supported values which may be not listed in the enum directly due to technical reasons: * NONE * REFRESH diff --git a/Compute/src/V1/InstanceGroupManagerUpdatePolicy/MostDisruptiveAllowedAction.php b/Compute/src/V1/InstanceGroupManagerUpdatePolicy/MostDisruptiveAllowedAction.php index 1acf08ced58e..35761f622da7 100644 --- a/Compute/src/V1/InstanceGroupManagerUpdatePolicy/MostDisruptiveAllowedAction.php +++ b/Compute/src/V1/InstanceGroupManagerUpdatePolicy/MostDisruptiveAllowedAction.php @@ -7,7 +7,13 @@ use UnexpectedValueException; /** - * Most disruptive action that is allowed to be taken on an instance. You can specify either NONE to forbid any actions, REFRESH to avoid restarting the VM and to limit disruption as much as possible. RESTART to allow actions that can be applied without instance replacing or REPLACE to allow all possible actions. If the Updater determines that the minimal update action needed is more disruptive than most disruptive allowed action you specify it will not perform the update at all. + * Most disruptive action that is allowed to be taken on an instance. + * You can specify either NONE to forbid any actions,REFRESH to avoid restarting the VM and to limit disruption + * as much as possible. RESTART to allow actions that can be + * applied without instance replacing or REPLACE to allow all + * possible actions. If the Updater determines that the minimal update + * action needed is more disruptive than most disruptive allowed action you + * specify it will not perform the update at all. * Additional supported values which may be not listed in the enum directly due to technical reasons: * NONE * REFRESH diff --git a/Compute/src/V1/InstanceGroupManagerUpdatePolicy/ReplacementMethod.php b/Compute/src/V1/InstanceGroupManagerUpdatePolicy/ReplacementMethod.php index e3442f1ba043..9c2a2ba9f3db 100644 --- a/Compute/src/V1/InstanceGroupManagerUpdatePolicy/ReplacementMethod.php +++ b/Compute/src/V1/InstanceGroupManagerUpdatePolicy/ReplacementMethod.php @@ -7,7 +7,8 @@ use UnexpectedValueException; /** - * What action should be used to replace instances. See minimal_action.REPLACE + * What action should be used to replace instances. + * See minimal_action.REPLACE * * Protobuf type google.cloud.compute.v1.InstanceGroupManagerUpdatePolicy.ReplacementMethod */ diff --git a/Compute/src/V1/InstanceGroupManagerUpdatePolicy/Type.php b/Compute/src/V1/InstanceGroupManagerUpdatePolicy/Type.php index 45db0a867dc8..8749bd2cda5f 100644 --- a/Compute/src/V1/InstanceGroupManagerUpdatePolicy/Type.php +++ b/Compute/src/V1/InstanceGroupManagerUpdatePolicy/Type.php @@ -7,7 +7,10 @@ use UnexpectedValueException; /** - * The type of update process. You can specify either PROACTIVE so that the MIG automatically updates VMs to the latest configurations or OPPORTUNISTIC so that you can select the VMs that you want to update. + * The type + * of update process. You can specify either PROACTIVE so + * that the MIG automatically updates VMs to the latest configurations orOPPORTUNISTIC so that you can select the VMs that you want + * to update. * Additional supported values which may be not listed in the enum directly due to technical reasons: * PROACTIVE * @@ -22,7 +25,9 @@ class Type */ const UNDEFINED_TYPE = 0; /** - * MIG will apply new configurations to existing VMs only when you selectively target specific or all VMs to be updated. + * MIG will apply new configurations + * to existing VMs only when you selectively target specific or all VMs to + * be updated. * * Generated from protobuf enum OPPORTUNISTIC = 429530089; */ diff --git a/Compute/src/V1/InstanceGroupManagerVersion.php b/Compute/src/V1/InstanceGroupManagerVersion.php index 0493b216e222..960ada72f76f 100644 --- a/Compute/src/V1/InstanceGroupManagerVersion.php +++ b/Compute/src/V1/InstanceGroupManagerVersion.php @@ -15,19 +15,37 @@ class InstanceGroupManagerVersion extends \Google\Protobuf\Internal\Message { /** - * The URL of the instance template that is specified for this managed instance group. The group uses this template to create new instances in the managed instance group until the `targetSize` for this version is reached. The templates for existing instances in the group do not change unless you run recreateInstances, run applyUpdatesToInstances, or set the group's updatePolicy.type to PROACTIVE; in those cases, existing instances are updated until the `targetSize` for this version is reached. + * The URL of the instance template that is specified for this managed + * instance group. The group uses this template to create new instances in + * the managed instance group until the `targetSize` for this version is + * reached. The templates for existing instances in the group do not change + * unless you run recreateInstances, runapplyUpdatesToInstances, or set the group'supdatePolicy.type to PROACTIVE; in those cases, + * existing instances are updated until the `targetSize` for this version is + * reached. * * Generated from protobuf field optional string instance_template = 309248228; */ protected $instance_template = null; /** - * Name of the version. Unique among all versions in the scope of this managed instance group. + * Name of the version. Unique among all versions in the scope of this + * managed instance group. * * Generated from protobuf field optional string name = 3373707; */ protected $name = null; /** - * Specifies the intended number of instances to be created from the instanceTemplate. The final number of instances created from the template will be equal to: - If expressed as a fixed number, the minimum of either targetSize.fixed or instanceGroupManager.targetSize is used. - if expressed as a percent, the targetSize would be (targetSize.percent/100 * InstanceGroupManager.targetSize) If there is a remainder, the number is rounded. If unset, this version will update any remaining instances not updated by another version. Read Starting a canary update for more information. + * Specifies the intended number of instances to be created from theinstanceTemplate. The final number of instances created + * from the template will be equal to: + * - If expressed as a fixed number, the minimum of either + * targetSize.fixed or + * instanceGroupManager.targetSize is used. + * - if expressed as a percent, the targetSize + * would be (targetSize.percent/100 * + * InstanceGroupManager.targetSize) If there is a remainder, the + * number is rounded. + * If unset, this version will update any remaining instances not + * updated by another version. ReadStarting + * a canary update for more information. * * Generated from protobuf field optional .google.cloud.compute.v1.FixedOrPercent target_size = 62880239; */ @@ -40,11 +58,29 @@ class InstanceGroupManagerVersion extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $instance_template - * The URL of the instance template that is specified for this managed instance group. The group uses this template to create new instances in the managed instance group until the `targetSize` for this version is reached. The templates for existing instances in the group do not change unless you run recreateInstances, run applyUpdatesToInstances, or set the group's updatePolicy.type to PROACTIVE; in those cases, existing instances are updated until the `targetSize` for this version is reached. + * The URL of the instance template that is specified for this managed + * instance group. The group uses this template to create new instances in + * the managed instance group until the `targetSize` for this version is + * reached. The templates for existing instances in the group do not change + * unless you run recreateInstances, runapplyUpdatesToInstances, or set the group'supdatePolicy.type to PROACTIVE; in those cases, + * existing instances are updated until the `targetSize` for this version is + * reached. * @type string $name - * Name of the version. Unique among all versions in the scope of this managed instance group. + * Name of the version. Unique among all versions in the scope of this + * managed instance group. * @type \Google\Cloud\Compute\V1\FixedOrPercent $target_size - * Specifies the intended number of instances to be created from the instanceTemplate. The final number of instances created from the template will be equal to: - If expressed as a fixed number, the minimum of either targetSize.fixed or instanceGroupManager.targetSize is used. - if expressed as a percent, the targetSize would be (targetSize.percent/100 * InstanceGroupManager.targetSize) If there is a remainder, the number is rounded. If unset, this version will update any remaining instances not updated by another version. Read Starting a canary update for more information. + * Specifies the intended number of instances to be created from theinstanceTemplate. The final number of instances created + * from the template will be equal to: + * - If expressed as a fixed number, the minimum of either + * targetSize.fixed or + * instanceGroupManager.targetSize is used. + * - if expressed as a percent, the targetSize + * would be (targetSize.percent/100 * + * InstanceGroupManager.targetSize) If there is a remainder, the + * number is rounded. + * If unset, this version will update any remaining instances not + * updated by another version. ReadStarting + * a canary update for more information. * } */ public function __construct($data = NULL) { @@ -53,7 +89,13 @@ public function __construct($data = NULL) { } /** - * The URL of the instance template that is specified for this managed instance group. The group uses this template to create new instances in the managed instance group until the `targetSize` for this version is reached. The templates for existing instances in the group do not change unless you run recreateInstances, run applyUpdatesToInstances, or set the group's updatePolicy.type to PROACTIVE; in those cases, existing instances are updated until the `targetSize` for this version is reached. + * The URL of the instance template that is specified for this managed + * instance group. The group uses this template to create new instances in + * the managed instance group until the `targetSize` for this version is + * reached. The templates for existing instances in the group do not change + * unless you run recreateInstances, runapplyUpdatesToInstances, or set the group'supdatePolicy.type to PROACTIVE; in those cases, + * existing instances are updated until the `targetSize` for this version is + * reached. * * Generated from protobuf field optional string instance_template = 309248228; * @return string @@ -74,7 +116,13 @@ public function clearInstanceTemplate() } /** - * The URL of the instance template that is specified for this managed instance group. The group uses this template to create new instances in the managed instance group until the `targetSize` for this version is reached. The templates for existing instances in the group do not change unless you run recreateInstances, run applyUpdatesToInstances, or set the group's updatePolicy.type to PROACTIVE; in those cases, existing instances are updated until the `targetSize` for this version is reached. + * The URL of the instance template that is specified for this managed + * instance group. The group uses this template to create new instances in + * the managed instance group until the `targetSize` for this version is + * reached. The templates for existing instances in the group do not change + * unless you run recreateInstances, runapplyUpdatesToInstances, or set the group'supdatePolicy.type to PROACTIVE; in those cases, + * existing instances are updated until the `targetSize` for this version is + * reached. * * Generated from protobuf field optional string instance_template = 309248228; * @param string $var @@ -89,7 +137,8 @@ public function setInstanceTemplate($var) } /** - * Name of the version. Unique among all versions in the scope of this managed instance group. + * Name of the version. Unique among all versions in the scope of this + * managed instance group. * * Generated from protobuf field optional string name = 3373707; * @return string @@ -110,7 +159,8 @@ public function clearName() } /** - * Name of the version. Unique among all versions in the scope of this managed instance group. + * Name of the version. Unique among all versions in the scope of this + * managed instance group. * * Generated from protobuf field optional string name = 3373707; * @param string $var @@ -125,7 +175,18 @@ public function setName($var) } /** - * Specifies the intended number of instances to be created from the instanceTemplate. The final number of instances created from the template will be equal to: - If expressed as a fixed number, the minimum of either targetSize.fixed or instanceGroupManager.targetSize is used. - if expressed as a percent, the targetSize would be (targetSize.percent/100 * InstanceGroupManager.targetSize) If there is a remainder, the number is rounded. If unset, this version will update any remaining instances not updated by another version. Read Starting a canary update for more information. + * Specifies the intended number of instances to be created from theinstanceTemplate. The final number of instances created + * from the template will be equal to: + * - If expressed as a fixed number, the minimum of either + * targetSize.fixed or + * instanceGroupManager.targetSize is used. + * - if expressed as a percent, the targetSize + * would be (targetSize.percent/100 * + * InstanceGroupManager.targetSize) If there is a remainder, the + * number is rounded. + * If unset, this version will update any remaining instances not + * updated by another version. ReadStarting + * a canary update for more information. * * Generated from protobuf field optional .google.cloud.compute.v1.FixedOrPercent target_size = 62880239; * @return \Google\Cloud\Compute\V1\FixedOrPercent|null @@ -146,7 +207,18 @@ public function clearTargetSize() } /** - * Specifies the intended number of instances to be created from the instanceTemplate. The final number of instances created from the template will be equal to: - If expressed as a fixed number, the minimum of either targetSize.fixed or instanceGroupManager.targetSize is used. - if expressed as a percent, the targetSize would be (targetSize.percent/100 * InstanceGroupManager.targetSize) If there is a remainder, the number is rounded. If unset, this version will update any remaining instances not updated by another version. Read Starting a canary update for more information. + * Specifies the intended number of instances to be created from theinstanceTemplate. The final number of instances created + * from the template will be equal to: + * - If expressed as a fixed number, the minimum of either + * targetSize.fixed or + * instanceGroupManager.targetSize is used. + * - if expressed as a percent, the targetSize + * would be (targetSize.percent/100 * + * InstanceGroupManager.targetSize) If there is a remainder, the + * number is rounded. + * If unset, this version will update any remaining instances not + * updated by another version. ReadStarting + * a canary update for more information. * * Generated from protobuf field optional .google.cloud.compute.v1.FixedOrPercent target_size = 62880239; * @param \Google\Cloud\Compute\V1\FixedOrPercent $var diff --git a/Compute/src/V1/InstanceGroupManagersAbandonInstancesRequest.php b/Compute/src/V1/InstanceGroupManagersAbandonInstancesRequest.php index 8f693f3e0eb6..ca7dbb921d62 100644 --- a/Compute/src/V1/InstanceGroupManagersAbandonInstancesRequest.php +++ b/Compute/src/V1/InstanceGroupManagersAbandonInstancesRequest.php @@ -15,7 +15,8 @@ class InstanceGroupManagersAbandonInstancesRequest extends \Google\Protobuf\Internal\Message { /** - * The URLs of one or more instances to abandon. This can be a full URL or a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. + * The URLs of one or more instances to abandon. This can be a full URL or + * a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. * * Generated from protobuf field repeated string instances = 29097598; */ @@ -28,7 +29,8 @@ class InstanceGroupManagersAbandonInstancesRequest extends \Google\Protobuf\Inte * Optional. Data for populating the Message object. * * @type array|\Google\Protobuf\Internal\RepeatedField $instances - * The URLs of one or more instances to abandon. This can be a full URL or a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. + * The URLs of one or more instances to abandon. This can be a full URL or + * a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. * } */ public function __construct($data = NULL) { @@ -37,7 +39,8 @@ public function __construct($data = NULL) { } /** - * The URLs of one or more instances to abandon. This can be a full URL or a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. + * The URLs of one or more instances to abandon. This can be a full URL or + * a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. * * Generated from protobuf field repeated string instances = 29097598; * @return \Google\Protobuf\Internal\RepeatedField @@ -48,7 +51,8 @@ public function getInstances() } /** - * The URLs of one or more instances to abandon. This can be a full URL or a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. + * The URLs of one or more instances to abandon. This can be a full URL or + * a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. * * Generated from protobuf field repeated string instances = 29097598; * @param array|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/InstanceGroupManagersApplyUpdatesRequest.php b/Compute/src/V1/InstanceGroupManagersApplyUpdatesRequest.php index 008b9a78bf18..4d1b7e261bc9 100644 --- a/Compute/src/V1/InstanceGroupManagersApplyUpdatesRequest.php +++ b/Compute/src/V1/InstanceGroupManagersApplyUpdatesRequest.php @@ -16,26 +16,51 @@ class InstanceGroupManagersApplyUpdatesRequest extends \Google\Protobuf\Internal\Message { /** - * Flag to update all instances instead of specified list of “instances”. If the flag is set to true then the instances may not be specified in the request. + * Flag to update all instances instead of specified list of “instances”. + * If the flag is set to true then the instances may not be specified + * in the request. * * Generated from protobuf field optional bool all_instances = 403676512; */ protected $all_instances = null; /** - * The list of URLs of one or more instances for which you want to apply updates. Each URL can be a full URL or a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. + * The list of URLs of one or more instances for which you want to apply + * updates. Each URL can be a full URL or a partial URL, such aszones/[ZONE]/instances/[INSTANCE_NAME]. * * Generated from protobuf field repeated string instances = 29097598; */ private $instances; /** - * The minimal action that you want to perform on each instance during the update: - REPLACE: At minimum, delete the instance and create it again. - RESTART: Stop the instance and start it again. - REFRESH: Do not stop the instance and limit disruption as much as possible. - NONE: Do not disrupt the instance at all. By default, the minimum action is NONE. If your update requires a more disruptive action than you set with this flag, the necessary action is performed to execute the update. + * The minimal action that you want to perform on each instance during the + * update: + * - REPLACE: At minimum, delete the instance and create it + * again. + * - RESTART: Stop the instance and start it + * again. + * - REFRESH: Do not stop the instance and limit + * disruption as much as possible. + * - NONE: Do not + * disrupt the instance at all. + * By default, the minimum action is NONE. If your update + * requires a more disruptive action than you set with this flag, the + * necessary action is performed to execute the update. * Check the MinimalAction enum for the list of possible values. * * Generated from protobuf field optional string minimal_action = 270567060; */ protected $minimal_action = null; /** - * The most disruptive action that you want to perform on each instance during the update: - REPLACE: Delete the instance and create it again. - RESTART: Stop the instance and start it again. - REFRESH: Do not stop the instance and limit disruption as much as possible. - NONE: Do not disrupt the instance at all. By default, the most disruptive allowed action is REPLACE. If your update requires a more disruptive action than you set with this flag, the update request will fail. + * The most disruptive action that you want to perform on each instance during + * the update: + * - REPLACE: Delete the instance and create it again. + * - RESTART: Stop the instance and start it again. + * - REFRESH: Do not stop the instance and limit disruption + * as much as possible. + * - NONE: Do not disrupt the + * instance at all. + * By default, the most disruptive allowed action is REPLACE. If + * your update requires a more disruptive action than you set with this flag, + * the update request will fail. * Check the MostDisruptiveAllowedAction enum for the list of possible values. * * Generated from protobuf field optional string most_disruptive_allowed_action = 66103053; @@ -49,14 +74,39 @@ class InstanceGroupManagersApplyUpdatesRequest extends \Google\Protobuf\Internal * Optional. Data for populating the Message object. * * @type bool $all_instances - * Flag to update all instances instead of specified list of “instances”. If the flag is set to true then the instances may not be specified in the request. + * Flag to update all instances instead of specified list of “instances”. + * If the flag is set to true then the instances may not be specified + * in the request. * @type array|\Google\Protobuf\Internal\RepeatedField $instances - * The list of URLs of one or more instances for which you want to apply updates. Each URL can be a full URL or a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. + * The list of URLs of one or more instances for which you want to apply + * updates. Each URL can be a full URL or a partial URL, such aszones/[ZONE]/instances/[INSTANCE_NAME]. * @type string $minimal_action - * The minimal action that you want to perform on each instance during the update: - REPLACE: At minimum, delete the instance and create it again. - RESTART: Stop the instance and start it again. - REFRESH: Do not stop the instance and limit disruption as much as possible. - NONE: Do not disrupt the instance at all. By default, the minimum action is NONE. If your update requires a more disruptive action than you set with this flag, the necessary action is performed to execute the update. + * The minimal action that you want to perform on each instance during the + * update: + * - REPLACE: At minimum, delete the instance and create it + * again. + * - RESTART: Stop the instance and start it + * again. + * - REFRESH: Do not stop the instance and limit + * disruption as much as possible. + * - NONE: Do not + * disrupt the instance at all. + * By default, the minimum action is NONE. If your update + * requires a more disruptive action than you set with this flag, the + * necessary action is performed to execute the update. * Check the MinimalAction enum for the list of possible values. * @type string $most_disruptive_allowed_action - * The most disruptive action that you want to perform on each instance during the update: - REPLACE: Delete the instance and create it again. - RESTART: Stop the instance and start it again. - REFRESH: Do not stop the instance and limit disruption as much as possible. - NONE: Do not disrupt the instance at all. By default, the most disruptive allowed action is REPLACE. If your update requires a more disruptive action than you set with this flag, the update request will fail. + * The most disruptive action that you want to perform on each instance during + * the update: + * - REPLACE: Delete the instance and create it again. + * - RESTART: Stop the instance and start it again. + * - REFRESH: Do not stop the instance and limit disruption + * as much as possible. + * - NONE: Do not disrupt the + * instance at all. + * By default, the most disruptive allowed action is REPLACE. If + * your update requires a more disruptive action than you set with this flag, + * the update request will fail. * Check the MostDisruptiveAllowedAction enum for the list of possible values. * } */ @@ -66,7 +116,9 @@ public function __construct($data = NULL) { } /** - * Flag to update all instances instead of specified list of “instances”. If the flag is set to true then the instances may not be specified in the request. + * Flag to update all instances instead of specified list of “instances”. + * If the flag is set to true then the instances may not be specified + * in the request. * * Generated from protobuf field optional bool all_instances = 403676512; * @return bool @@ -87,7 +139,9 @@ public function clearAllInstances() } /** - * Flag to update all instances instead of specified list of “instances”. If the flag is set to true then the instances may not be specified in the request. + * Flag to update all instances instead of specified list of “instances”. + * If the flag is set to true then the instances may not be specified + * in the request. * * Generated from protobuf field optional bool all_instances = 403676512; * @param bool $var @@ -102,7 +156,8 @@ public function setAllInstances($var) } /** - * The list of URLs of one or more instances for which you want to apply updates. Each URL can be a full URL or a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. + * The list of URLs of one or more instances for which you want to apply + * updates. Each URL can be a full URL or a partial URL, such aszones/[ZONE]/instances/[INSTANCE_NAME]. * * Generated from protobuf field repeated string instances = 29097598; * @return \Google\Protobuf\Internal\RepeatedField @@ -113,7 +168,8 @@ public function getInstances() } /** - * The list of URLs of one or more instances for which you want to apply updates. Each URL can be a full URL or a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. + * The list of URLs of one or more instances for which you want to apply + * updates. Each URL can be a full URL or a partial URL, such aszones/[ZONE]/instances/[INSTANCE_NAME]. * * Generated from protobuf field repeated string instances = 29097598; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -128,7 +184,19 @@ public function setInstances($var) } /** - * The minimal action that you want to perform on each instance during the update: - REPLACE: At minimum, delete the instance and create it again. - RESTART: Stop the instance and start it again. - REFRESH: Do not stop the instance and limit disruption as much as possible. - NONE: Do not disrupt the instance at all. By default, the minimum action is NONE. If your update requires a more disruptive action than you set with this flag, the necessary action is performed to execute the update. + * The minimal action that you want to perform on each instance during the + * update: + * - REPLACE: At minimum, delete the instance and create it + * again. + * - RESTART: Stop the instance and start it + * again. + * - REFRESH: Do not stop the instance and limit + * disruption as much as possible. + * - NONE: Do not + * disrupt the instance at all. + * By default, the minimum action is NONE. If your update + * requires a more disruptive action than you set with this flag, the + * necessary action is performed to execute the update. * Check the MinimalAction enum for the list of possible values. * * Generated from protobuf field optional string minimal_action = 270567060; @@ -150,7 +218,19 @@ public function clearMinimalAction() } /** - * The minimal action that you want to perform on each instance during the update: - REPLACE: At minimum, delete the instance and create it again. - RESTART: Stop the instance and start it again. - REFRESH: Do not stop the instance and limit disruption as much as possible. - NONE: Do not disrupt the instance at all. By default, the minimum action is NONE. If your update requires a more disruptive action than you set with this flag, the necessary action is performed to execute the update. + * The minimal action that you want to perform on each instance during the + * update: + * - REPLACE: At minimum, delete the instance and create it + * again. + * - RESTART: Stop the instance and start it + * again. + * - REFRESH: Do not stop the instance and limit + * disruption as much as possible. + * - NONE: Do not + * disrupt the instance at all. + * By default, the minimum action is NONE. If your update + * requires a more disruptive action than you set with this flag, the + * necessary action is performed to execute the update. * Check the MinimalAction enum for the list of possible values. * * Generated from protobuf field optional string minimal_action = 270567060; @@ -166,7 +246,17 @@ public function setMinimalAction($var) } /** - * The most disruptive action that you want to perform on each instance during the update: - REPLACE: Delete the instance and create it again. - RESTART: Stop the instance and start it again. - REFRESH: Do not stop the instance and limit disruption as much as possible. - NONE: Do not disrupt the instance at all. By default, the most disruptive allowed action is REPLACE. If your update requires a more disruptive action than you set with this flag, the update request will fail. + * The most disruptive action that you want to perform on each instance during + * the update: + * - REPLACE: Delete the instance and create it again. + * - RESTART: Stop the instance and start it again. + * - REFRESH: Do not stop the instance and limit disruption + * as much as possible. + * - NONE: Do not disrupt the + * instance at all. + * By default, the most disruptive allowed action is REPLACE. If + * your update requires a more disruptive action than you set with this flag, + * the update request will fail. * Check the MostDisruptiveAllowedAction enum for the list of possible values. * * Generated from protobuf field optional string most_disruptive_allowed_action = 66103053; @@ -188,7 +278,17 @@ public function clearMostDisruptiveAllowedAction() } /** - * The most disruptive action that you want to perform on each instance during the update: - REPLACE: Delete the instance and create it again. - RESTART: Stop the instance and start it again. - REFRESH: Do not stop the instance and limit disruption as much as possible. - NONE: Do not disrupt the instance at all. By default, the most disruptive allowed action is REPLACE. If your update requires a more disruptive action than you set with this flag, the update request will fail. + * The most disruptive action that you want to perform on each instance during + * the update: + * - REPLACE: Delete the instance and create it again. + * - RESTART: Stop the instance and start it again. + * - REFRESH: Do not stop the instance and limit disruption + * as much as possible. + * - NONE: Do not disrupt the + * instance at all. + * By default, the most disruptive allowed action is REPLACE. If + * your update requires a more disruptive action than you set with this flag, + * the update request will fail. * Check the MostDisruptiveAllowedAction enum for the list of possible values. * * Generated from protobuf field optional string most_disruptive_allowed_action = 66103053; diff --git a/Compute/src/V1/InstanceGroupManagersApplyUpdatesRequest/MinimalAction.php b/Compute/src/V1/InstanceGroupManagersApplyUpdatesRequest/MinimalAction.php index 49549283686a..da489a4180b1 100644 --- a/Compute/src/V1/InstanceGroupManagersApplyUpdatesRequest/MinimalAction.php +++ b/Compute/src/V1/InstanceGroupManagersApplyUpdatesRequest/MinimalAction.php @@ -7,7 +7,19 @@ use UnexpectedValueException; /** - * The minimal action that you want to perform on each instance during the update: - REPLACE: At minimum, delete the instance and create it again. - RESTART: Stop the instance and start it again. - REFRESH: Do not stop the instance and limit disruption as much as possible. - NONE: Do not disrupt the instance at all. By default, the minimum action is NONE. If your update requires a more disruptive action than you set with this flag, the necessary action is performed to execute the update. + * The minimal action that you want to perform on each instance during the + * update: + * - REPLACE: At minimum, delete the instance and create it + * again. + * - RESTART: Stop the instance and start it + * again. + * - REFRESH: Do not stop the instance and limit + * disruption as much as possible. + * - NONE: Do not + * disrupt the instance at all. + * By default, the minimum action is NONE. If your update + * requires a more disruptive action than you set with this flag, the + * necessary action is performed to execute the update. * Additional supported values which may be not listed in the enum directly due to technical reasons: * NONE * REFRESH diff --git a/Compute/src/V1/InstanceGroupManagersApplyUpdatesRequest/MostDisruptiveAllowedAction.php b/Compute/src/V1/InstanceGroupManagersApplyUpdatesRequest/MostDisruptiveAllowedAction.php index c24eb7bd9c6a..0b2204cc307e 100644 --- a/Compute/src/V1/InstanceGroupManagersApplyUpdatesRequest/MostDisruptiveAllowedAction.php +++ b/Compute/src/V1/InstanceGroupManagersApplyUpdatesRequest/MostDisruptiveAllowedAction.php @@ -7,7 +7,17 @@ use UnexpectedValueException; /** - * The most disruptive action that you want to perform on each instance during the update: - REPLACE: Delete the instance and create it again. - RESTART: Stop the instance and start it again. - REFRESH: Do not stop the instance and limit disruption as much as possible. - NONE: Do not disrupt the instance at all. By default, the most disruptive allowed action is REPLACE. If your update requires a more disruptive action than you set with this flag, the update request will fail. + * The most disruptive action that you want to perform on each instance during + * the update: + * - REPLACE: Delete the instance and create it again. + * - RESTART: Stop the instance and start it again. + * - REFRESH: Do not stop the instance and limit disruption + * as much as possible. + * - NONE: Do not disrupt the + * instance at all. + * By default, the most disruptive allowed action is REPLACE. If + * your update requires a more disruptive action than you set with this flag, + * the update request will fail. * Additional supported values which may be not listed in the enum directly due to technical reasons: * NONE * REFRESH diff --git a/Compute/src/V1/InstanceGroupManagersDeleteInstancesRequest.php b/Compute/src/V1/InstanceGroupManagersDeleteInstancesRequest.php index 976084089b58..a5b0aa5e556b 100644 --- a/Compute/src/V1/InstanceGroupManagersDeleteInstancesRequest.php +++ b/Compute/src/V1/InstanceGroupManagersDeleteInstancesRequest.php @@ -15,13 +15,22 @@ class InstanceGroupManagersDeleteInstancesRequest extends \Google\Protobuf\Internal\Message { /** - * The URLs of one or more instances to delete. This can be a full URL or a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. Queued instances do not have URL and can be deleted only by name. One cannot specify both URLs and names in a single request. + * The URLs of one or more instances to delete. This can be a full URL or + * a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. + * Queued instances do not have URL and can be deleted only by name. + * One cannot specify both URLs and names in a single request. * * Generated from protobuf field repeated string instances = 29097598; */ private $instances; /** - * Specifies whether the request should proceed despite the inclusion of instances that are not members of the group or that are already in the process of being deleted or abandoned. If this field is set to `false` and such an instance is specified in the request, the operation fails. The operation always fails if the request contains a malformed instance URL or a reference to an instance that exists in a zone or region other than the group's zone or region. + * Specifies whether the request should proceed despite the inclusion of + * instances that are not members of the group or that are already in the + * process of being deleted or abandoned. If this field is set to `false` and + * such an instance is specified in the request, the operation fails. The + * operation always fails if the request contains a malformed instance URL or + * a reference to an instance that exists in a zone or region other than the + * group's zone or region. * * Generated from protobuf field optional bool skip_instances_on_validation_error = 40631073; */ @@ -34,9 +43,18 @@ class InstanceGroupManagersDeleteInstancesRequest extends \Google\Protobuf\Inter * Optional. Data for populating the Message object. * * @type array|\Google\Protobuf\Internal\RepeatedField $instances - * The URLs of one or more instances to delete. This can be a full URL or a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. Queued instances do not have URL and can be deleted only by name. One cannot specify both URLs and names in a single request. + * The URLs of one or more instances to delete. This can be a full URL or + * a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. + * Queued instances do not have URL and can be deleted only by name. + * One cannot specify both URLs and names in a single request. * @type bool $skip_instances_on_validation_error - * Specifies whether the request should proceed despite the inclusion of instances that are not members of the group or that are already in the process of being deleted or abandoned. If this field is set to `false` and such an instance is specified in the request, the operation fails. The operation always fails if the request contains a malformed instance URL or a reference to an instance that exists in a zone or region other than the group's zone or region. + * Specifies whether the request should proceed despite the inclusion of + * instances that are not members of the group or that are already in the + * process of being deleted or abandoned. If this field is set to `false` and + * such an instance is specified in the request, the operation fails. The + * operation always fails if the request contains a malformed instance URL or + * a reference to an instance that exists in a zone or region other than the + * group's zone or region. * } */ public function __construct($data = NULL) { @@ -45,7 +63,10 @@ public function __construct($data = NULL) { } /** - * The URLs of one or more instances to delete. This can be a full URL or a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. Queued instances do not have URL and can be deleted only by name. One cannot specify both URLs and names in a single request. + * The URLs of one or more instances to delete. This can be a full URL or + * a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. + * Queued instances do not have URL and can be deleted only by name. + * One cannot specify both URLs and names in a single request. * * Generated from protobuf field repeated string instances = 29097598; * @return \Google\Protobuf\Internal\RepeatedField @@ -56,7 +77,10 @@ public function getInstances() } /** - * The URLs of one or more instances to delete. This can be a full URL or a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. Queued instances do not have URL and can be deleted only by name. One cannot specify both URLs and names in a single request. + * The URLs of one or more instances to delete. This can be a full URL or + * a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. + * Queued instances do not have URL and can be deleted only by name. + * One cannot specify both URLs and names in a single request. * * Generated from protobuf field repeated string instances = 29097598; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -71,7 +95,13 @@ public function setInstances($var) } /** - * Specifies whether the request should proceed despite the inclusion of instances that are not members of the group or that are already in the process of being deleted or abandoned. If this field is set to `false` and such an instance is specified in the request, the operation fails. The operation always fails if the request contains a malformed instance URL or a reference to an instance that exists in a zone or region other than the group's zone or region. + * Specifies whether the request should proceed despite the inclusion of + * instances that are not members of the group or that are already in the + * process of being deleted or abandoned. If this field is set to `false` and + * such an instance is specified in the request, the operation fails. The + * operation always fails if the request contains a malformed instance URL or + * a reference to an instance that exists in a zone or region other than the + * group's zone or region. * * Generated from protobuf field optional bool skip_instances_on_validation_error = 40631073; * @return bool @@ -92,7 +122,13 @@ public function clearSkipInstancesOnValidationError() } /** - * Specifies whether the request should proceed despite the inclusion of instances that are not members of the group or that are already in the process of being deleted or abandoned. If this field is set to `false` and such an instance is specified in the request, the operation fails. The operation always fails if the request contains a malformed instance URL or a reference to an instance that exists in a zone or region other than the group's zone or region. + * Specifies whether the request should proceed despite the inclusion of + * instances that are not members of the group or that are already in the + * process of being deleted or abandoned. If this field is set to `false` and + * such an instance is specified in the request, the operation fails. The + * operation always fails if the request contains a malformed instance URL or + * a reference to an instance that exists in a zone or region other than the + * group's zone or region. * * Generated from protobuf field optional bool skip_instances_on_validation_error = 40631073; * @param bool $var diff --git a/Compute/src/V1/InstanceGroupManagersDeletePerInstanceConfigsReq.php b/Compute/src/V1/InstanceGroupManagersDeletePerInstanceConfigsReq.php index 6de7987fc49b..cac5249fa423 100644 --- a/Compute/src/V1/InstanceGroupManagersDeletePerInstanceConfigsReq.php +++ b/Compute/src/V1/InstanceGroupManagersDeletePerInstanceConfigsReq.php @@ -16,7 +16,8 @@ class InstanceGroupManagersDeletePerInstanceConfigsReq extends \Google\Protobuf\Internal\Message { /** - * The list of instance names for which we want to delete per-instance configs on this managed instance group. + * The list of instance names for which we want to delete per-instance configs + * on this managed instance group. * * Generated from protobuf field repeated string names = 104585032; */ @@ -29,7 +30,8 @@ class InstanceGroupManagersDeletePerInstanceConfigsReq extends \Google\Protobuf\ * Optional. Data for populating the Message object. * * @type array|\Google\Protobuf\Internal\RepeatedField $names - * The list of instance names for which we want to delete per-instance configs on this managed instance group. + * The list of instance names for which we want to delete per-instance configs + * on this managed instance group. * } */ public function __construct($data = NULL) { @@ -38,7 +40,8 @@ public function __construct($data = NULL) { } /** - * The list of instance names for which we want to delete per-instance configs on this managed instance group. + * The list of instance names for which we want to delete per-instance configs + * on this managed instance group. * * Generated from protobuf field repeated string names = 104585032; * @return \Google\Protobuf\Internal\RepeatedField @@ -49,7 +52,8 @@ public function getNames() } /** - * The list of instance names for which we want to delete per-instance configs on this managed instance group. + * The list of instance names for which we want to delete per-instance configs + * on this managed instance group. * * Generated from protobuf field repeated string names = 104585032; * @param array|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/InstanceGroupManagersListErrorsResponse.php b/Compute/src/V1/InstanceGroupManagersListErrorsResponse.php index 175c9a81944a..fe5cb1ad5106 100644 --- a/Compute/src/V1/InstanceGroupManagersListErrorsResponse.php +++ b/Compute/src/V1/InstanceGroupManagersListErrorsResponse.php @@ -21,7 +21,11 @@ class InstanceGroupManagersListErrorsResponse extends \Google\Protobuf\Internal\ */ private $items; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -36,7 +40,11 @@ class InstanceGroupManagersListErrorsResponse extends \Google\Protobuf\Internal\ * @type array<\Google\Cloud\Compute\V1\InstanceManagedByIgmError>|\Google\Protobuf\Internal\RepeatedField $items * [Output Only] The list of errors of the managed instance group. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * } */ public function __construct($data = NULL) { @@ -71,7 +79,11 @@ public function setItems($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -92,7 +104,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/InstanceGroupManagersListManagedInstancesResponse.php b/Compute/src/V1/InstanceGroupManagersListManagedInstancesResponse.php index 02dac0019a8f..a11bfe0c30ee 100644 --- a/Compute/src/V1/InstanceGroupManagersListManagedInstancesResponse.php +++ b/Compute/src/V1/InstanceGroupManagersListManagedInstancesResponse.php @@ -21,7 +21,11 @@ class InstanceGroupManagersListManagedInstancesResponse extends \Google\Protobuf */ private $managed_instances; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -36,7 +40,11 @@ class InstanceGroupManagersListManagedInstancesResponse extends \Google\Protobuf * @type array<\Google\Cloud\Compute\V1\ManagedInstance>|\Google\Protobuf\Internal\RepeatedField $managed_instances * [Output Only] The list of instances in the managed instance group. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * } */ public function __construct($data = NULL) { @@ -71,7 +79,11 @@ public function setManagedInstances($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -92,7 +104,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/InstanceGroupManagersListPerInstanceConfigsResp.php b/Compute/src/V1/InstanceGroupManagersListPerInstanceConfigsResp.php index dc960ae2c068..e2e22b03b935 100644 --- a/Compute/src/V1/InstanceGroupManagersListPerInstanceConfigsResp.php +++ b/Compute/src/V1/InstanceGroupManagersListPerInstanceConfigsResp.php @@ -21,7 +21,11 @@ class InstanceGroupManagersListPerInstanceConfigsResp extends \Google\Protobuf\I */ private $items; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -42,7 +46,11 @@ class InstanceGroupManagersListPerInstanceConfigsResp extends \Google\Protobuf\I * @type array<\Google\Cloud\Compute\V1\PerInstanceConfig>|\Google\Protobuf\Internal\RepeatedField $items * [Output Only] The list of PerInstanceConfig. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type \Google\Cloud\Compute\V1\Warning $warning * [Output Only] Informational warning message. * } @@ -79,7 +87,11 @@ public function setItems($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -100,7 +112,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/InstanceGroupManagersPatchPerInstanceConfigsReq.php b/Compute/src/V1/InstanceGroupManagersPatchPerInstanceConfigsReq.php index 9daed3fbb2de..472c79fd85b6 100644 --- a/Compute/src/V1/InstanceGroupManagersPatchPerInstanceConfigsReq.php +++ b/Compute/src/V1/InstanceGroupManagersPatchPerInstanceConfigsReq.php @@ -16,7 +16,8 @@ class InstanceGroupManagersPatchPerInstanceConfigsReq extends \Google\Protobuf\Internal\Message { /** - * The list of per-instance configurations to insert or patch on this managed instance group. + * The list of per-instance configurations to insert or patch on this managed + * instance group. * * Generated from protobuf field repeated .google.cloud.compute.v1.PerInstanceConfig per_instance_configs = 526265001; */ @@ -29,7 +30,8 @@ class InstanceGroupManagersPatchPerInstanceConfigsReq extends \Google\Protobuf\I * Optional. Data for populating the Message object. * * @type array<\Google\Cloud\Compute\V1\PerInstanceConfig>|\Google\Protobuf\Internal\RepeatedField $per_instance_configs - * The list of per-instance configurations to insert or patch on this managed instance group. + * The list of per-instance configurations to insert or patch on this managed + * instance group. * } */ public function __construct($data = NULL) { @@ -38,7 +40,8 @@ public function __construct($data = NULL) { } /** - * The list of per-instance configurations to insert or patch on this managed instance group. + * The list of per-instance configurations to insert or patch on this managed + * instance group. * * Generated from protobuf field repeated .google.cloud.compute.v1.PerInstanceConfig per_instance_configs = 526265001; * @return \Google\Protobuf\Internal\RepeatedField @@ -49,7 +52,8 @@ public function getPerInstanceConfigs() } /** - * The list of per-instance configurations to insert or patch on this managed instance group. + * The list of per-instance configurations to insert or patch on this managed + * instance group. * * Generated from protobuf field repeated .google.cloud.compute.v1.PerInstanceConfig per_instance_configs = 526265001; * @param array<\Google\Cloud\Compute\V1\PerInstanceConfig>|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/InstanceGroupManagersRecreateInstancesRequest.php b/Compute/src/V1/InstanceGroupManagersRecreateInstancesRequest.php index 4506198d1408..75fee234c0e6 100644 --- a/Compute/src/V1/InstanceGroupManagersRecreateInstancesRequest.php +++ b/Compute/src/V1/InstanceGroupManagersRecreateInstancesRequest.php @@ -15,7 +15,8 @@ class InstanceGroupManagersRecreateInstancesRequest extends \Google\Protobuf\Internal\Message { /** - * The URLs of one or more instances to recreate. This can be a full URL or a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. + * The URLs of one or more instances to recreate. This can be a full URL or + * a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. * * Generated from protobuf field repeated string instances = 29097598; */ @@ -28,7 +29,8 @@ class InstanceGroupManagersRecreateInstancesRequest extends \Google\Protobuf\Int * Optional. Data for populating the Message object. * * @type array|\Google\Protobuf\Internal\RepeatedField $instances - * The URLs of one or more instances to recreate. This can be a full URL or a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. + * The URLs of one or more instances to recreate. This can be a full URL or + * a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. * } */ public function __construct($data = NULL) { @@ -37,7 +39,8 @@ public function __construct($data = NULL) { } /** - * The URLs of one or more instances to recreate. This can be a full URL or a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. + * The URLs of one or more instances to recreate. This can be a full URL or + * a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. * * Generated from protobuf field repeated string instances = 29097598; * @return \Google\Protobuf\Internal\RepeatedField @@ -48,7 +51,8 @@ public function getInstances() } /** - * The URLs of one or more instances to recreate. This can be a full URL or a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. + * The URLs of one or more instances to recreate. This can be a full URL or + * a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. * * Generated from protobuf field repeated string instances = 29097598; * @param array|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/InstanceGroupManagersResumeInstancesRequest.php b/Compute/src/V1/InstanceGroupManagersResumeInstancesRequest.php index 470393eb1122..78248bf48f8b 100644 --- a/Compute/src/V1/InstanceGroupManagersResumeInstancesRequest.php +++ b/Compute/src/V1/InstanceGroupManagersResumeInstancesRequest.php @@ -15,7 +15,8 @@ class InstanceGroupManagersResumeInstancesRequest extends \Google\Protobuf\Internal\Message { /** - * The URLs of one or more instances to resume. This can be a full URL or a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. + * The URLs of one or more instances to resume. This can be a full URL or + * a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. * * Generated from protobuf field repeated string instances = 29097598; */ @@ -28,7 +29,8 @@ class InstanceGroupManagersResumeInstancesRequest extends \Google\Protobuf\Inter * Optional. Data for populating the Message object. * * @type array|\Google\Protobuf\Internal\RepeatedField $instances - * The URLs of one or more instances to resume. This can be a full URL or a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. + * The URLs of one or more instances to resume. This can be a full URL or + * a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. * } */ public function __construct($data = NULL) { @@ -37,7 +39,8 @@ public function __construct($data = NULL) { } /** - * The URLs of one or more instances to resume. This can be a full URL or a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. + * The URLs of one or more instances to resume. This can be a full URL or + * a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. * * Generated from protobuf field repeated string instances = 29097598; * @return \Google\Protobuf\Internal\RepeatedField @@ -48,7 +51,8 @@ public function getInstances() } /** - * The URLs of one or more instances to resume. This can be a full URL or a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. + * The URLs of one or more instances to resume. This can be a full URL or + * a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. * * Generated from protobuf field repeated string instances = 29097598; * @param array|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/InstanceGroupManagersScopedList.php b/Compute/src/V1/InstanceGroupManagersScopedList.php index 6c6428ca677d..6f3fa032e2e2 100644 --- a/Compute/src/V1/InstanceGroupManagersScopedList.php +++ b/Compute/src/V1/InstanceGroupManagersScopedList.php @@ -15,13 +15,15 @@ class InstanceGroupManagersScopedList extends \Google\Protobuf\Internal\Message { /** - * [Output Only] The list of managed instance groups that are contained in the specified project and zone. + * [Output Only] The list of managed instance groups that are contained in + * the specified project and zone. * * Generated from protobuf field repeated .google.cloud.compute.v1.InstanceGroupManager instance_group_managers = 214072592; */ private $instance_group_managers; /** - * [Output Only] The warning that replaces the list of managed instance groups when the list is empty. + * [Output Only] The warning that replaces the list of managed instance + * groups when the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; */ @@ -34,9 +36,11 @@ class InstanceGroupManagersScopedList extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type array<\Google\Cloud\Compute\V1\InstanceGroupManager>|\Google\Protobuf\Internal\RepeatedField $instance_group_managers - * [Output Only] The list of managed instance groups that are contained in the specified project and zone. + * [Output Only] The list of managed instance groups that are contained in + * the specified project and zone. * @type \Google\Cloud\Compute\V1\Warning $warning - * [Output Only] The warning that replaces the list of managed instance groups when the list is empty. + * [Output Only] The warning that replaces the list of managed instance + * groups when the list is empty. * } */ public function __construct($data = NULL) { @@ -45,7 +49,8 @@ public function __construct($data = NULL) { } /** - * [Output Only] The list of managed instance groups that are contained in the specified project and zone. + * [Output Only] The list of managed instance groups that are contained in + * the specified project and zone. * * Generated from protobuf field repeated .google.cloud.compute.v1.InstanceGroupManager instance_group_managers = 214072592; * @return \Google\Protobuf\Internal\RepeatedField @@ -56,7 +61,8 @@ public function getInstanceGroupManagers() } /** - * [Output Only] The list of managed instance groups that are contained in the specified project and zone. + * [Output Only] The list of managed instance groups that are contained in + * the specified project and zone. * * Generated from protobuf field repeated .google.cloud.compute.v1.InstanceGroupManager instance_group_managers = 214072592; * @param array<\Google\Cloud\Compute\V1\InstanceGroupManager>|\Google\Protobuf\Internal\RepeatedField $var @@ -71,7 +77,8 @@ public function setInstanceGroupManagers($var) } /** - * [Output Only] The warning that replaces the list of managed instance groups when the list is empty. + * [Output Only] The warning that replaces the list of managed instance + * groups when the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; * @return \Google\Cloud\Compute\V1\Warning|null @@ -92,7 +99,8 @@ public function clearWarning() } /** - * [Output Only] The warning that replaces the list of managed instance groups when the list is empty. + * [Output Only] The warning that replaces the list of managed instance + * groups when the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; * @param \Google\Cloud\Compute\V1\Warning $var diff --git a/Compute/src/V1/InstanceGroupManagersSetInstanceTemplateRequest.php b/Compute/src/V1/InstanceGroupManagersSetInstanceTemplateRequest.php index f68c28b853f8..d7a318f66bff 100644 --- a/Compute/src/V1/InstanceGroupManagersSetInstanceTemplateRequest.php +++ b/Compute/src/V1/InstanceGroupManagersSetInstanceTemplateRequest.php @@ -15,7 +15,10 @@ class InstanceGroupManagersSetInstanceTemplateRequest extends \Google\Protobuf\Internal\Message { /** - * The URL of the instance template that is specified for this managed instance group. The group uses this template to create all new instances in the managed instance group. The templates for existing instances in the group do not change unless you run recreateInstances, run applyUpdatesToInstances, or set the group's updatePolicy.type to PROACTIVE. + * The URL of the instance template that is specified for this managed + * instance group. The group uses this template to create all new instances + * in the managed instance group. The templates for existing instances in the + * group do not change unless you run recreateInstances, runapplyUpdatesToInstances, or set the group'supdatePolicy.type to PROACTIVE. * * Generated from protobuf field optional string instance_template = 309248228; */ @@ -28,7 +31,10 @@ class InstanceGroupManagersSetInstanceTemplateRequest extends \Google\Protobuf\I * Optional. Data for populating the Message object. * * @type string $instance_template - * The URL of the instance template that is specified for this managed instance group. The group uses this template to create all new instances in the managed instance group. The templates for existing instances in the group do not change unless you run recreateInstances, run applyUpdatesToInstances, or set the group's updatePolicy.type to PROACTIVE. + * The URL of the instance template that is specified for this managed + * instance group. The group uses this template to create all new instances + * in the managed instance group. The templates for existing instances in the + * group do not change unless you run recreateInstances, runapplyUpdatesToInstances, or set the group'supdatePolicy.type to PROACTIVE. * } */ public function __construct($data = NULL) { @@ -37,7 +43,10 @@ public function __construct($data = NULL) { } /** - * The URL of the instance template that is specified for this managed instance group. The group uses this template to create all new instances in the managed instance group. The templates for existing instances in the group do not change unless you run recreateInstances, run applyUpdatesToInstances, or set the group's updatePolicy.type to PROACTIVE. + * The URL of the instance template that is specified for this managed + * instance group. The group uses this template to create all new instances + * in the managed instance group. The templates for existing instances in the + * group do not change unless you run recreateInstances, runapplyUpdatesToInstances, or set the group'supdatePolicy.type to PROACTIVE. * * Generated from protobuf field optional string instance_template = 309248228; * @return string @@ -58,7 +67,10 @@ public function clearInstanceTemplate() } /** - * The URL of the instance template that is specified for this managed instance group. The group uses this template to create all new instances in the managed instance group. The templates for existing instances in the group do not change unless you run recreateInstances, run applyUpdatesToInstances, or set the group's updatePolicy.type to PROACTIVE. + * The URL of the instance template that is specified for this managed + * instance group. The group uses this template to create all new instances + * in the managed instance group. The templates for existing instances in the + * group do not change unless you run recreateInstances, runapplyUpdatesToInstances, or set the group'supdatePolicy.type to PROACTIVE. * * Generated from protobuf field optional string instance_template = 309248228; * @param string $var diff --git a/Compute/src/V1/InstanceGroupManagersSetTargetPoolsRequest.php b/Compute/src/V1/InstanceGroupManagersSetTargetPoolsRequest.php index a89d62c5613d..320a471d0854 100644 --- a/Compute/src/V1/InstanceGroupManagersSetTargetPoolsRequest.php +++ b/Compute/src/V1/InstanceGroupManagersSetTargetPoolsRequest.php @@ -15,13 +15,21 @@ class InstanceGroupManagersSetTargetPoolsRequest extends \Google\Protobuf\Internal\Message { /** - * The fingerprint of the target pools information. Use this optional property to prevent conflicts when multiple users change the target pools settings concurrently. Obtain the fingerprint with the instanceGroupManagers.get method. Then, include the fingerprint in your request to ensure that you do not overwrite changes that were applied from another concurrent request. + * The fingerprint of the target pools information. Use this optional + * property to prevent conflicts when multiple users change the target pools + * settings concurrently. Obtain the fingerprint with theinstanceGroupManagers.get + * method. Then, include the fingerprint in your request to ensure that you + * do not overwrite changes that were applied from another + * concurrent request. * * Generated from protobuf field optional string fingerprint = 234678500; */ protected $fingerprint = null; /** - * The list of target pool URLs that instances in this managed instance group belong to. The managed instance group applies these target pools to all of the instances in the group. Existing instances and new instances in the group all receive these target pool settings. + * The list of target pool URLs that instances in this managed instance group + * belong to. The managed instance group applies these target pools to all + * of the instances in the group. Existing instances and new instances in the + * group all receive these target pool settings. * * Generated from protobuf field repeated string target_pools = 336072617; */ @@ -34,9 +42,17 @@ class InstanceGroupManagersSetTargetPoolsRequest extends \Google\Protobuf\Intern * Optional. Data for populating the Message object. * * @type string $fingerprint - * The fingerprint of the target pools information. Use this optional property to prevent conflicts when multiple users change the target pools settings concurrently. Obtain the fingerprint with the instanceGroupManagers.get method. Then, include the fingerprint in your request to ensure that you do not overwrite changes that were applied from another concurrent request. + * The fingerprint of the target pools information. Use this optional + * property to prevent conflicts when multiple users change the target pools + * settings concurrently. Obtain the fingerprint with theinstanceGroupManagers.get + * method. Then, include the fingerprint in your request to ensure that you + * do not overwrite changes that were applied from another + * concurrent request. * @type array|\Google\Protobuf\Internal\RepeatedField $target_pools - * The list of target pool URLs that instances in this managed instance group belong to. The managed instance group applies these target pools to all of the instances in the group. Existing instances and new instances in the group all receive these target pool settings. + * The list of target pool URLs that instances in this managed instance group + * belong to. The managed instance group applies these target pools to all + * of the instances in the group. Existing instances and new instances in the + * group all receive these target pool settings. * } */ public function __construct($data = NULL) { @@ -45,7 +61,12 @@ public function __construct($data = NULL) { } /** - * The fingerprint of the target pools information. Use this optional property to prevent conflicts when multiple users change the target pools settings concurrently. Obtain the fingerprint with the instanceGroupManagers.get method. Then, include the fingerprint in your request to ensure that you do not overwrite changes that were applied from another concurrent request. + * The fingerprint of the target pools information. Use this optional + * property to prevent conflicts when multiple users change the target pools + * settings concurrently. Obtain the fingerprint with theinstanceGroupManagers.get + * method. Then, include the fingerprint in your request to ensure that you + * do not overwrite changes that were applied from another + * concurrent request. * * Generated from protobuf field optional string fingerprint = 234678500; * @return string @@ -66,7 +87,12 @@ public function clearFingerprint() } /** - * The fingerprint of the target pools information. Use this optional property to prevent conflicts when multiple users change the target pools settings concurrently. Obtain the fingerprint with the instanceGroupManagers.get method. Then, include the fingerprint in your request to ensure that you do not overwrite changes that were applied from another concurrent request. + * The fingerprint of the target pools information. Use this optional + * property to prevent conflicts when multiple users change the target pools + * settings concurrently. Obtain the fingerprint with theinstanceGroupManagers.get + * method. Then, include the fingerprint in your request to ensure that you + * do not overwrite changes that were applied from another + * concurrent request. * * Generated from protobuf field optional string fingerprint = 234678500; * @param string $var @@ -81,7 +107,10 @@ public function setFingerprint($var) } /** - * The list of target pool URLs that instances in this managed instance group belong to. The managed instance group applies these target pools to all of the instances in the group. Existing instances and new instances in the group all receive these target pool settings. + * The list of target pool URLs that instances in this managed instance group + * belong to. The managed instance group applies these target pools to all + * of the instances in the group. Existing instances and new instances in the + * group all receive these target pool settings. * * Generated from protobuf field repeated string target_pools = 336072617; * @return \Google\Protobuf\Internal\RepeatedField @@ -92,7 +121,10 @@ public function getTargetPools() } /** - * The list of target pool URLs that instances in this managed instance group belong to. The managed instance group applies these target pools to all of the instances in the group. Existing instances and new instances in the group all receive these target pool settings. + * The list of target pool URLs that instances in this managed instance group + * belong to. The managed instance group applies these target pools to all + * of the instances in the group. Existing instances and new instances in the + * group all receive these target pool settings. * * Generated from protobuf field repeated string target_pools = 336072617; * @param array|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/InstanceGroupManagersStartInstancesRequest.php b/Compute/src/V1/InstanceGroupManagersStartInstancesRequest.php index a38f91434316..c874a23f89f9 100644 --- a/Compute/src/V1/InstanceGroupManagersStartInstancesRequest.php +++ b/Compute/src/V1/InstanceGroupManagersStartInstancesRequest.php @@ -15,7 +15,8 @@ class InstanceGroupManagersStartInstancesRequest extends \Google\Protobuf\Internal\Message { /** - * The URLs of one or more instances to start. This can be a full URL or a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. + * The URLs of one or more instances to start. This can be a full URL or + * a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. * * Generated from protobuf field repeated string instances = 29097598; */ @@ -28,7 +29,8 @@ class InstanceGroupManagersStartInstancesRequest extends \Google\Protobuf\Intern * Optional. Data for populating the Message object. * * @type array|\Google\Protobuf\Internal\RepeatedField $instances - * The URLs of one or more instances to start. This can be a full URL or a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. + * The URLs of one or more instances to start. This can be a full URL or + * a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. * } */ public function __construct($data = NULL) { @@ -37,7 +39,8 @@ public function __construct($data = NULL) { } /** - * The URLs of one or more instances to start. This can be a full URL or a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. + * The URLs of one or more instances to start. This can be a full URL or + * a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. * * Generated from protobuf field repeated string instances = 29097598; * @return \Google\Protobuf\Internal\RepeatedField @@ -48,7 +51,8 @@ public function getInstances() } /** - * The URLs of one or more instances to start. This can be a full URL or a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. + * The URLs of one or more instances to start. This can be a full URL or + * a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. * * Generated from protobuf field repeated string instances = 29097598; * @param array|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/InstanceGroupManagersStopInstancesRequest.php b/Compute/src/V1/InstanceGroupManagersStopInstancesRequest.php index cf374062071d..f58e896ebbc8 100644 --- a/Compute/src/V1/InstanceGroupManagersStopInstancesRequest.php +++ b/Compute/src/V1/InstanceGroupManagersStopInstancesRequest.php @@ -15,13 +15,15 @@ class InstanceGroupManagersStopInstancesRequest extends \Google\Protobuf\Internal\Message { /** - * If this flag is set to true, the Instance Group Manager will proceed to stop the instances, skipping initialization on them. + * If this flag is set to true, the Instance Group Manager will proceed to + * stop the instances, skipping initialization on them. * * Generated from protobuf field optional bool force_stop = 134762710; */ protected $force_stop = null; /** - * The URLs of one or more instances to stop. This can be a full URL or a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. + * The URLs of one or more instances to stop. This can be a full URL or + * a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. * * Generated from protobuf field repeated string instances = 29097598; */ @@ -34,9 +36,11 @@ class InstanceGroupManagersStopInstancesRequest extends \Google\Protobuf\Interna * Optional. Data for populating the Message object. * * @type bool $force_stop - * If this flag is set to true, the Instance Group Manager will proceed to stop the instances, skipping initialization on them. + * If this flag is set to true, the Instance Group Manager will proceed to + * stop the instances, skipping initialization on them. * @type array|\Google\Protobuf\Internal\RepeatedField $instances - * The URLs of one or more instances to stop. This can be a full URL or a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. + * The URLs of one or more instances to stop. This can be a full URL or + * a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. * } */ public function __construct($data = NULL) { @@ -45,7 +49,8 @@ public function __construct($data = NULL) { } /** - * If this flag is set to true, the Instance Group Manager will proceed to stop the instances, skipping initialization on them. + * If this flag is set to true, the Instance Group Manager will proceed to + * stop the instances, skipping initialization on them. * * Generated from protobuf field optional bool force_stop = 134762710; * @return bool @@ -66,7 +71,8 @@ public function clearForceStop() } /** - * If this flag is set to true, the Instance Group Manager will proceed to stop the instances, skipping initialization on them. + * If this flag is set to true, the Instance Group Manager will proceed to + * stop the instances, skipping initialization on them. * * Generated from protobuf field optional bool force_stop = 134762710; * @param bool $var @@ -81,7 +87,8 @@ public function setForceStop($var) } /** - * The URLs of one or more instances to stop. This can be a full URL or a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. + * The URLs of one or more instances to stop. This can be a full URL or + * a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. * * Generated from protobuf field repeated string instances = 29097598; * @return \Google\Protobuf\Internal\RepeatedField @@ -92,7 +99,8 @@ public function getInstances() } /** - * The URLs of one or more instances to stop. This can be a full URL or a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. + * The URLs of one or more instances to stop. This can be a full URL or + * a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. * * Generated from protobuf field repeated string instances = 29097598; * @param array|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/InstanceGroupManagersSuspendInstancesRequest.php b/Compute/src/V1/InstanceGroupManagersSuspendInstancesRequest.php index ec96f9adbbe2..cdda2b16c532 100644 --- a/Compute/src/V1/InstanceGroupManagersSuspendInstancesRequest.php +++ b/Compute/src/V1/InstanceGroupManagersSuspendInstancesRequest.php @@ -15,13 +15,15 @@ class InstanceGroupManagersSuspendInstancesRequest extends \Google\Protobuf\Internal\Message { /** - * If this flag is set to true, the Instance Group Manager will proceed to suspend the instances, skipping initialization on them. + * If this flag is set to true, the Instance Group Manager will proceed to + * suspend the instances, skipping initialization on them. * * Generated from protobuf field optional bool force_suspend = 27637480; */ protected $force_suspend = null; /** - * The URLs of one or more instances to suspend. This can be a full URL or a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. + * The URLs of one or more instances to suspend. This can be a full URL or + * a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. * * Generated from protobuf field repeated string instances = 29097598; */ @@ -34,9 +36,11 @@ class InstanceGroupManagersSuspendInstancesRequest extends \Google\Protobuf\Inte * Optional. Data for populating the Message object. * * @type bool $force_suspend - * If this flag is set to true, the Instance Group Manager will proceed to suspend the instances, skipping initialization on them. + * If this flag is set to true, the Instance Group Manager will proceed to + * suspend the instances, skipping initialization on them. * @type array|\Google\Protobuf\Internal\RepeatedField $instances - * The URLs of one or more instances to suspend. This can be a full URL or a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. + * The URLs of one or more instances to suspend. This can be a full URL or + * a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. * } */ public function __construct($data = NULL) { @@ -45,7 +49,8 @@ public function __construct($data = NULL) { } /** - * If this flag is set to true, the Instance Group Manager will proceed to suspend the instances, skipping initialization on them. + * If this flag is set to true, the Instance Group Manager will proceed to + * suspend the instances, skipping initialization on them. * * Generated from protobuf field optional bool force_suspend = 27637480; * @return bool @@ -66,7 +71,8 @@ public function clearForceSuspend() } /** - * If this flag is set to true, the Instance Group Manager will proceed to suspend the instances, skipping initialization on them. + * If this flag is set to true, the Instance Group Manager will proceed to + * suspend the instances, skipping initialization on them. * * Generated from protobuf field optional bool force_suspend = 27637480; * @param bool $var @@ -81,7 +87,8 @@ public function setForceSuspend($var) } /** - * The URLs of one or more instances to suspend. This can be a full URL or a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. + * The URLs of one or more instances to suspend. This can be a full URL or + * a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. * * Generated from protobuf field repeated string instances = 29097598; * @return \Google\Protobuf\Internal\RepeatedField @@ -92,7 +99,8 @@ public function getInstances() } /** - * The URLs of one or more instances to suspend. This can be a full URL or a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. + * The URLs of one or more instances to suspend. This can be a full URL or + * a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. * * Generated from protobuf field repeated string instances = 29097598; * @param array|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/InstanceGroupManagersUpdatePerInstanceConfigsReq.php b/Compute/src/V1/InstanceGroupManagersUpdatePerInstanceConfigsReq.php index 62ca03bb95b0..38d3d6dfb0eb 100644 --- a/Compute/src/V1/InstanceGroupManagersUpdatePerInstanceConfigsReq.php +++ b/Compute/src/V1/InstanceGroupManagersUpdatePerInstanceConfigsReq.php @@ -16,7 +16,8 @@ class InstanceGroupManagersUpdatePerInstanceConfigsReq extends \Google\Protobuf\Internal\Message { /** - * The list of per-instance configurations to insert or patch on this managed instance group. + * The list of per-instance configurations to insert or patch on this managed + * instance group. * * Generated from protobuf field repeated .google.cloud.compute.v1.PerInstanceConfig per_instance_configs = 526265001; */ @@ -29,7 +30,8 @@ class InstanceGroupManagersUpdatePerInstanceConfigsReq extends \Google\Protobuf\ * Optional. Data for populating the Message object. * * @type array<\Google\Cloud\Compute\V1\PerInstanceConfig>|\Google\Protobuf\Internal\RepeatedField $per_instance_configs - * The list of per-instance configurations to insert or patch on this managed instance group. + * The list of per-instance configurations to insert or patch on this managed + * instance group. * } */ public function __construct($data = NULL) { @@ -38,7 +40,8 @@ public function __construct($data = NULL) { } /** - * The list of per-instance configurations to insert or patch on this managed instance group. + * The list of per-instance configurations to insert or patch on this managed + * instance group. * * Generated from protobuf field repeated .google.cloud.compute.v1.PerInstanceConfig per_instance_configs = 526265001; * @return \Google\Protobuf\Internal\RepeatedField @@ -49,7 +52,8 @@ public function getPerInstanceConfigs() } /** - * The list of per-instance configurations to insert or patch on this managed instance group. + * The list of per-instance configurations to insert or patch on this managed + * instance group. * * Generated from protobuf field repeated .google.cloud.compute.v1.PerInstanceConfig per_instance_configs = 526265001; * @param array<\Google\Cloud\Compute\V1\PerInstanceConfig>|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/InstanceGroupsListInstances.php b/Compute/src/V1/InstanceGroupsListInstances.php index 4f32ed9dd812..0c135b20e7a4 100644 --- a/Compute/src/V1/InstanceGroupsListInstances.php +++ b/Compute/src/V1/InstanceGroupsListInstances.php @@ -27,13 +27,18 @@ class InstanceGroupsListInstances extends \Google\Protobuf\Internal\Message */ private $items; /** - * [Output Only] The resource type, which is always compute#instanceGroupsListInstances for the list of instances in the specified instance group. + * [Output Only] The resource type, which is alwayscompute#instanceGroupsListInstances for the list of instances + * in the specified instance group. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -62,9 +67,14 @@ class InstanceGroupsListInstances extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\InstanceWithNamedPorts>|\Google\Protobuf\Internal\RepeatedField $items * A list of InstanceWithNamedPorts resources. * @type string $kind - * [Output Only] The resource type, which is always compute#instanceGroupsListInstances for the list of instances in the specified instance group. + * [Output Only] The resource type, which is alwayscompute#instanceGroupsListInstances for the list of instances + * in the specified instance group. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type \Google\Cloud\Compute\V1\Warning $warning @@ -139,7 +149,8 @@ public function setItems($var) } /** - * [Output Only] The resource type, which is always compute#instanceGroupsListInstances for the list of instances in the specified instance group. + * [Output Only] The resource type, which is alwayscompute#instanceGroupsListInstances for the list of instances + * in the specified instance group. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -160,7 +171,8 @@ public function clearKind() } /** - * [Output Only] The resource type, which is always compute#instanceGroupsListInstances for the list of instances in the specified instance group. + * [Output Only] The resource type, which is alwayscompute#instanceGroupsListInstances for the list of instances + * in the specified instance group. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -175,7 +187,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -196,7 +212,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/InstanceGroupsListInstancesRequest.php b/Compute/src/V1/InstanceGroupsListInstancesRequest.php index c9c5cf194e1b..77d2cbdd83e2 100644 --- a/Compute/src/V1/InstanceGroupsListInstancesRequest.php +++ b/Compute/src/V1/InstanceGroupsListInstancesRequest.php @@ -15,7 +15,9 @@ class InstanceGroupsListInstancesRequest extends \Google\Protobuf\Internal\Message { /** - * A filter for the state of the instances in the instance group. Valid options are ALL or RUNNING. If you do not specify this parameter the list includes all instances regardless of their state. + * A filter for the state of the instances in the instance group. Valid + * options are ALL or RUNNING. If you do not specify + * this parameter the list includes all instances regardless of their state. * Check the InstanceState enum for the list of possible values. * * Generated from protobuf field optional string instance_state = 92223591; @@ -29,7 +31,9 @@ class InstanceGroupsListInstancesRequest extends \Google\Protobuf\Internal\Messa * Optional. Data for populating the Message object. * * @type string $instance_state - * A filter for the state of the instances in the instance group. Valid options are ALL or RUNNING. If you do not specify this parameter the list includes all instances regardless of their state. + * A filter for the state of the instances in the instance group. Valid + * options are ALL or RUNNING. If you do not specify + * this parameter the list includes all instances regardless of their state. * Check the InstanceState enum for the list of possible values. * } */ @@ -39,7 +43,9 @@ public function __construct($data = NULL) { } /** - * A filter for the state of the instances in the instance group. Valid options are ALL or RUNNING. If you do not specify this parameter the list includes all instances regardless of their state. + * A filter for the state of the instances in the instance group. Valid + * options are ALL or RUNNING. If you do not specify + * this parameter the list includes all instances regardless of their state. * Check the InstanceState enum for the list of possible values. * * Generated from protobuf field optional string instance_state = 92223591; @@ -61,7 +67,9 @@ public function clearInstanceState() } /** - * A filter for the state of the instances in the instance group. Valid options are ALL or RUNNING. If you do not specify this parameter the list includes all instances regardless of their state. + * A filter for the state of the instances in the instance group. Valid + * options are ALL or RUNNING. If you do not specify + * this parameter the list includes all instances regardless of their state. * Check the InstanceState enum for the list of possible values. * * Generated from protobuf field optional string instance_state = 92223591; diff --git a/Compute/src/V1/InstanceGroupsListInstancesRequest/InstanceState.php b/Compute/src/V1/InstanceGroupsListInstancesRequest/InstanceState.php index bbb2b3b6954e..4f20c7179951 100644 --- a/Compute/src/V1/InstanceGroupsListInstancesRequest/InstanceState.php +++ b/Compute/src/V1/InstanceGroupsListInstancesRequest/InstanceState.php @@ -7,7 +7,9 @@ use UnexpectedValueException; /** - * A filter for the state of the instances in the instance group. Valid options are ALL or RUNNING. If you do not specify this parameter the list includes all instances regardless of their state. + * A filter for the state of the instances in the instance group. Valid + * options are ALL or RUNNING. If you do not specify + * this parameter the list includes all instances regardless of their state. * * Protobuf type google.cloud.compute.v1.InstanceGroupsListInstancesRequest.InstanceState */ @@ -26,7 +28,8 @@ class InstanceState */ const ALL = 64897; /** - * Includes instances in the generated list only if they have a RUNNING state. + * Includes instances in the generated list only if they have a RUNNING + * state. * * Generated from protobuf enum RUNNING = 121282975; */ diff --git a/Compute/src/V1/InstanceGroupsScopedList.php b/Compute/src/V1/InstanceGroupsScopedList.php index 96308c03a27e..d17627a1cf31 100644 --- a/Compute/src/V1/InstanceGroupsScopedList.php +++ b/Compute/src/V1/InstanceGroupsScopedList.php @@ -15,13 +15,15 @@ class InstanceGroupsScopedList extends \Google\Protobuf\Internal\Message { /** - * [Output Only] The list of instance groups that are contained in this scope. + * [Output Only] The list ofinstance + * groups that are contained in this scope. * * Generated from protobuf field repeated .google.cloud.compute.v1.InstanceGroup instance_groups = 366469310; */ private $instance_groups; /** - * [Output Only] An informational warning that replaces the list of instance groups when the list is empty. + * [Output Only] An informational warning that replaces the list of + * instance groups when the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; */ @@ -34,9 +36,11 @@ class InstanceGroupsScopedList extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type array<\Google\Cloud\Compute\V1\InstanceGroup>|\Google\Protobuf\Internal\RepeatedField $instance_groups - * [Output Only] The list of instance groups that are contained in this scope. + * [Output Only] The list ofinstance + * groups that are contained in this scope. * @type \Google\Cloud\Compute\V1\Warning $warning - * [Output Only] An informational warning that replaces the list of instance groups when the list is empty. + * [Output Only] An informational warning that replaces the list of + * instance groups when the list is empty. * } */ public function __construct($data = NULL) { @@ -45,7 +49,8 @@ public function __construct($data = NULL) { } /** - * [Output Only] The list of instance groups that are contained in this scope. + * [Output Only] The list ofinstance + * groups that are contained in this scope. * * Generated from protobuf field repeated .google.cloud.compute.v1.InstanceGroup instance_groups = 366469310; * @return \Google\Protobuf\Internal\RepeatedField @@ -56,7 +61,8 @@ public function getInstanceGroups() } /** - * [Output Only] The list of instance groups that are contained in this scope. + * [Output Only] The list ofinstance + * groups that are contained in this scope. * * Generated from protobuf field repeated .google.cloud.compute.v1.InstanceGroup instance_groups = 366469310; * @param array<\Google\Cloud\Compute\V1\InstanceGroup>|\Google\Protobuf\Internal\RepeatedField $var @@ -71,7 +77,8 @@ public function setInstanceGroups($var) } /** - * [Output Only] An informational warning that replaces the list of instance groups when the list is empty. + * [Output Only] An informational warning that replaces the list of + * instance groups when the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; * @return \Google\Cloud\Compute\V1\Warning|null @@ -92,7 +99,8 @@ public function clearWarning() } /** - * [Output Only] An informational warning that replaces the list of instance groups when the list is empty. + * [Output Only] An informational warning that replaces the list of + * instance groups when the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; * @param \Google\Cloud\Compute\V1\Warning $var diff --git a/Compute/src/V1/InstanceGroupsSetNamedPortsRequest.php b/Compute/src/V1/InstanceGroupsSetNamedPortsRequest.php index ca1013cbc87b..6f668132cccc 100644 --- a/Compute/src/V1/InstanceGroupsSetNamedPortsRequest.php +++ b/Compute/src/V1/InstanceGroupsSetNamedPortsRequest.php @@ -15,7 +15,12 @@ class InstanceGroupsSetNamedPortsRequest extends \Google\Protobuf\Internal\Message { /** - * The fingerprint of the named ports information for this instance group. Use this optional property to prevent conflicts when multiple users change the named ports settings concurrently. Obtain the fingerprint with the instanceGroups.get method. Then, include the fingerprint in your request to ensure that you do not overwrite changes that were applied from another concurrent request. A request with an incorrect fingerprint will fail with error 412 conditionNotMet. + * The fingerprint of the named ports information for this instance group. + * Use this optional property to prevent conflicts when multiple users change + * the named ports settings concurrently. Obtain the fingerprint with theinstanceGroups.get + * method. Then, include the fingerprint in your request to ensure that you + * do not overwrite changes that were applied from another concurrent request. + * A request with an incorrect fingerprint will fail with error412 conditionNotMet. * * Generated from protobuf field optional string fingerprint = 234678500; */ @@ -34,7 +39,12 @@ class InstanceGroupsSetNamedPortsRequest extends \Google\Protobuf\Internal\Messa * Optional. Data for populating the Message object. * * @type string $fingerprint - * The fingerprint of the named ports information for this instance group. Use this optional property to prevent conflicts when multiple users change the named ports settings concurrently. Obtain the fingerprint with the instanceGroups.get method. Then, include the fingerprint in your request to ensure that you do not overwrite changes that were applied from another concurrent request. A request with an incorrect fingerprint will fail with error 412 conditionNotMet. + * The fingerprint of the named ports information for this instance group. + * Use this optional property to prevent conflicts when multiple users change + * the named ports settings concurrently. Obtain the fingerprint with theinstanceGroups.get + * method. Then, include the fingerprint in your request to ensure that you + * do not overwrite changes that were applied from another concurrent request. + * A request with an incorrect fingerprint will fail with error412 conditionNotMet. * @type array<\Google\Cloud\Compute\V1\NamedPort>|\Google\Protobuf\Internal\RepeatedField $named_ports * The list of named ports to set for this instance group. * } @@ -45,7 +55,12 @@ public function __construct($data = NULL) { } /** - * The fingerprint of the named ports information for this instance group. Use this optional property to prevent conflicts when multiple users change the named ports settings concurrently. Obtain the fingerprint with the instanceGroups.get method. Then, include the fingerprint in your request to ensure that you do not overwrite changes that were applied from another concurrent request. A request with an incorrect fingerprint will fail with error 412 conditionNotMet. + * The fingerprint of the named ports information for this instance group. + * Use this optional property to prevent conflicts when multiple users change + * the named ports settings concurrently. Obtain the fingerprint with theinstanceGroups.get + * method. Then, include the fingerprint in your request to ensure that you + * do not overwrite changes that were applied from another concurrent request. + * A request with an incorrect fingerprint will fail with error412 conditionNotMet. * * Generated from protobuf field optional string fingerprint = 234678500; * @return string @@ -66,7 +81,12 @@ public function clearFingerprint() } /** - * The fingerprint of the named ports information for this instance group. Use this optional property to prevent conflicts when multiple users change the named ports settings concurrently. Obtain the fingerprint with the instanceGroups.get method. Then, include the fingerprint in your request to ensure that you do not overwrite changes that were applied from another concurrent request. A request with an incorrect fingerprint will fail with error 412 conditionNotMet. + * The fingerprint of the named ports information for this instance group. + * Use this optional property to prevent conflicts when multiple users change + * the named ports settings concurrently. Obtain the fingerprint with theinstanceGroups.get + * method. Then, include the fingerprint in your request to ensure that you + * do not overwrite changes that were applied from another concurrent request. + * A request with an incorrect fingerprint will fail with error412 conditionNotMet. * * Generated from protobuf field optional string fingerprint = 234678500; * @param string $var diff --git a/Compute/src/V1/InstanceList.php b/Compute/src/V1/InstanceList.php index 771276ead510..92efd85ead83 100644 --- a/Compute/src/V1/InstanceList.php +++ b/Compute/src/V1/InstanceList.php @@ -28,13 +28,18 @@ class InstanceList extends \Google\Protobuf\Internal\Message */ private $items; /** - * [Output Only] Type of resource. Always compute#instanceList for lists of Instance resources. + * [Output Only] Type of resource. Always compute#instanceList + * for lists of Instance resources. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -63,9 +68,14 @@ class InstanceList extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\Instance>|\Google\Protobuf\Internal\RepeatedField $items * A list of Instance resources. * @type string $kind - * [Output Only] Type of resource. Always compute#instanceList for lists of Instance resources. + * [Output Only] Type of resource. Always compute#instanceList + * for lists of Instance resources. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type \Google\Cloud\Compute\V1\Warning $warning @@ -140,7 +150,8 @@ public function setItems($var) } /** - * [Output Only] Type of resource. Always compute#instanceList for lists of Instance resources. + * [Output Only] Type of resource. Always compute#instanceList + * for lists of Instance resources. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -161,7 +172,8 @@ public function clearKind() } /** - * [Output Only] Type of resource. Always compute#instanceList for lists of Instance resources. + * [Output Only] Type of resource. Always compute#instanceList + * for lists of Instance resources. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -176,7 +188,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -197,7 +213,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/InstanceListReferrers.php b/Compute/src/V1/InstanceListReferrers.php index 28577dd44f37..1be8321f5232 100644 --- a/Compute/src/V1/InstanceListReferrers.php +++ b/Compute/src/V1/InstanceListReferrers.php @@ -28,13 +28,17 @@ class InstanceListReferrers extends \Google\Protobuf\Internal\Message */ private $items; /** - * [Output Only] Type of resource. Always compute#instanceListReferrers for lists of Instance referrers. + * [Output Only] Type of resource. Alwayscompute#instanceListReferrers for lists of Instance referrers. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -63,9 +67,13 @@ class InstanceListReferrers extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\Reference>|\Google\Protobuf\Internal\RepeatedField $items * A list of Reference resources. * @type string $kind - * [Output Only] Type of resource. Always compute#instanceListReferrers for lists of Instance referrers. + * [Output Only] Type of resource. Alwayscompute#instanceListReferrers for lists of Instance referrers. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type \Google\Cloud\Compute\V1\Warning $warning @@ -140,7 +148,7 @@ public function setItems($var) } /** - * [Output Only] Type of resource. Always compute#instanceListReferrers for lists of Instance referrers. + * [Output Only] Type of resource. Alwayscompute#instanceListReferrers for lists of Instance referrers. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -161,7 +169,7 @@ public function clearKind() } /** - * [Output Only] Type of resource. Always compute#instanceListReferrers for lists of Instance referrers. + * [Output Only] Type of resource. Alwayscompute#instanceListReferrers for lists of Instance referrers. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -176,7 +184,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -197,7 +209,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/InstanceManagedByIgmError.php b/Compute/src/V1/InstanceManagedByIgmError.php index 0ad355990fcd..0e23f52c1f08 100644 --- a/Compute/src/V1/InstanceManagedByIgmError.php +++ b/Compute/src/V1/InstanceManagedByIgmError.php @@ -21,13 +21,16 @@ class InstanceManagedByIgmError extends \Google\Protobuf\Internal\Message */ protected $error = null; /** - * [Output Only] Details of the instance action that triggered this error. May be null, if the error was not caused by an action on an instance. This field is optional. + * [Output Only] Details of the instance action that triggered this error. + * May be null, if the error was not caused by an action on an instance. + * This field is optional. * * Generated from protobuf field optional .google.cloud.compute.v1.InstanceManagedByIgmErrorInstanceActionDetails instance_action_details = 292224547; */ protected $instance_action_details = null; /** - * [Output Only] The time that this error occurred. This value is in RFC3339 text format. + * [Output Only] The time that this error occurred. + * This value is in RFC3339 text format. * * Generated from protobuf field optional string timestamp = 55126294; */ @@ -42,9 +45,12 @@ class InstanceManagedByIgmError extends \Google\Protobuf\Internal\Message * @type \Google\Cloud\Compute\V1\InstanceManagedByIgmErrorManagedInstanceError $error * [Output Only] Contents of the error. * @type \Google\Cloud\Compute\V1\InstanceManagedByIgmErrorInstanceActionDetails $instance_action_details - * [Output Only] Details of the instance action that triggered this error. May be null, if the error was not caused by an action on an instance. This field is optional. + * [Output Only] Details of the instance action that triggered this error. + * May be null, if the error was not caused by an action on an instance. + * This field is optional. * @type string $timestamp - * [Output Only] The time that this error occurred. This value is in RFC3339 text format. + * [Output Only] The time that this error occurred. + * This value is in RFC3339 text format. * } */ public function __construct($data = NULL) { @@ -89,7 +95,9 @@ public function setError($var) } /** - * [Output Only] Details of the instance action that triggered this error. May be null, if the error was not caused by an action on an instance. This field is optional. + * [Output Only] Details of the instance action that triggered this error. + * May be null, if the error was not caused by an action on an instance. + * This field is optional. * * Generated from protobuf field optional .google.cloud.compute.v1.InstanceManagedByIgmErrorInstanceActionDetails instance_action_details = 292224547; * @return \Google\Cloud\Compute\V1\InstanceManagedByIgmErrorInstanceActionDetails|null @@ -110,7 +118,9 @@ public function clearInstanceActionDetails() } /** - * [Output Only] Details of the instance action that triggered this error. May be null, if the error was not caused by an action on an instance. This field is optional. + * [Output Only] Details of the instance action that triggered this error. + * May be null, if the error was not caused by an action on an instance. + * This field is optional. * * Generated from protobuf field optional .google.cloud.compute.v1.InstanceManagedByIgmErrorInstanceActionDetails instance_action_details = 292224547; * @param \Google\Cloud\Compute\V1\InstanceManagedByIgmErrorInstanceActionDetails $var @@ -125,7 +135,8 @@ public function setInstanceActionDetails($var) } /** - * [Output Only] The time that this error occurred. This value is in RFC3339 text format. + * [Output Only] The time that this error occurred. + * This value is in RFC3339 text format. * * Generated from protobuf field optional string timestamp = 55126294; * @return string @@ -146,7 +157,8 @@ public function clearTimestamp() } /** - * [Output Only] The time that this error occurred. This value is in RFC3339 text format. + * [Output Only] The time that this error occurred. + * This value is in RFC3339 text format. * * Generated from protobuf field optional string timestamp = 55126294; * @param string $var diff --git a/Compute/src/V1/InstanceManagedByIgmErrorInstanceActionDetails.php b/Compute/src/V1/InstanceManagedByIgmErrorInstanceActionDetails.php index f08eb09ac5dc..25b7fa03de5c 100644 --- a/Compute/src/V1/InstanceManagedByIgmErrorInstanceActionDetails.php +++ b/Compute/src/V1/InstanceManagedByIgmErrorInstanceActionDetails.php @@ -15,20 +15,25 @@ class InstanceManagedByIgmErrorInstanceActionDetails extends \Google\Protobuf\Internal\Message { /** - * [Output Only] Action that managed instance group was executing on the instance when the error occurred. Possible values: + * [Output Only] Action that managed instance group was executing on + * the instance when the error occurred. Possible values: * Check the Action enum for the list of possible values. * * Generated from protobuf field optional string action = 187661878; */ protected $action = null; /** - * [Output Only] The URL of the instance. The URL can be set even if the instance has not yet been created. + * [Output Only] The URL of the instance. + * The URL can be set even if the instance has not yet been created. * * Generated from protobuf field optional string instance = 18257045; */ protected $instance = null; /** - * [Output Only] Version this instance was created from, or was being created from, but the creation failed. Corresponds to one of the versions that were set on the Instance Group Manager resource at the time this instance was being created. + * [Output Only] Version this instance was created from, or was being + * created from, but the creation failed. Corresponds to one of the versions + * that were set on the Instance Group Manager resource at the time this + * instance was being created. * * Generated from protobuf field optional .google.cloud.compute.v1.ManagedInstanceVersion version = 351608024; */ @@ -41,12 +46,17 @@ class InstanceManagedByIgmErrorInstanceActionDetails extends \Google\Protobuf\In * Optional. Data for populating the Message object. * * @type string $action - * [Output Only] Action that managed instance group was executing on the instance when the error occurred. Possible values: + * [Output Only] Action that managed instance group was executing on + * the instance when the error occurred. Possible values: * Check the Action enum for the list of possible values. * @type string $instance - * [Output Only] The URL of the instance. The URL can be set even if the instance has not yet been created. + * [Output Only] The URL of the instance. + * The URL can be set even if the instance has not yet been created. * @type \Google\Cloud\Compute\V1\ManagedInstanceVersion $version - * [Output Only] Version this instance was created from, or was being created from, but the creation failed. Corresponds to one of the versions that were set on the Instance Group Manager resource at the time this instance was being created. + * [Output Only] Version this instance was created from, or was being + * created from, but the creation failed. Corresponds to one of the versions + * that were set on the Instance Group Manager resource at the time this + * instance was being created. * } */ public function __construct($data = NULL) { @@ -55,7 +65,8 @@ public function __construct($data = NULL) { } /** - * [Output Only] Action that managed instance group was executing on the instance when the error occurred. Possible values: + * [Output Only] Action that managed instance group was executing on + * the instance when the error occurred. Possible values: * Check the Action enum for the list of possible values. * * Generated from protobuf field optional string action = 187661878; @@ -77,7 +88,8 @@ public function clearAction() } /** - * [Output Only] Action that managed instance group was executing on the instance when the error occurred. Possible values: + * [Output Only] Action that managed instance group was executing on + * the instance when the error occurred. Possible values: * Check the Action enum for the list of possible values. * * Generated from protobuf field optional string action = 187661878; @@ -93,7 +105,8 @@ public function setAction($var) } /** - * [Output Only] The URL of the instance. The URL can be set even if the instance has not yet been created. + * [Output Only] The URL of the instance. + * The URL can be set even if the instance has not yet been created. * * Generated from protobuf field optional string instance = 18257045; * @return string @@ -114,7 +127,8 @@ public function clearInstance() } /** - * [Output Only] The URL of the instance. The URL can be set even if the instance has not yet been created. + * [Output Only] The URL of the instance. + * The URL can be set even if the instance has not yet been created. * * Generated from protobuf field optional string instance = 18257045; * @param string $var @@ -129,7 +143,10 @@ public function setInstance($var) } /** - * [Output Only] Version this instance was created from, or was being created from, but the creation failed. Corresponds to one of the versions that were set on the Instance Group Manager resource at the time this instance was being created. + * [Output Only] Version this instance was created from, or was being + * created from, but the creation failed. Corresponds to one of the versions + * that were set on the Instance Group Manager resource at the time this + * instance was being created. * * Generated from protobuf field optional .google.cloud.compute.v1.ManagedInstanceVersion version = 351608024; * @return \Google\Cloud\Compute\V1\ManagedInstanceVersion|null @@ -150,7 +167,10 @@ public function clearVersion() } /** - * [Output Only] Version this instance was created from, or was being created from, but the creation failed. Corresponds to one of the versions that were set on the Instance Group Manager resource at the time this instance was being created. + * [Output Only] Version this instance was created from, or was being + * created from, but the creation failed. Corresponds to one of the versions + * that were set on the Instance Group Manager resource at the time this + * instance was being created. * * Generated from protobuf field optional .google.cloud.compute.v1.ManagedInstanceVersion version = 351608024; * @param \Google\Cloud\Compute\V1\ManagedInstanceVersion $var diff --git a/Compute/src/V1/InstanceManagedByIgmErrorInstanceActionDetails/Action.php b/Compute/src/V1/InstanceManagedByIgmErrorInstanceActionDetails/Action.php index f3f12427bad7..d3c4956ce90f 100644 --- a/Compute/src/V1/InstanceManagedByIgmErrorInstanceActionDetails/Action.php +++ b/Compute/src/V1/InstanceManagedByIgmErrorInstanceActionDetails/Action.php @@ -7,7 +7,8 @@ use UnexpectedValueException; /** - * [Output Only] Action that managed instance group was executing on the instance when the error occurred. Possible values: + * [Output Only] Action that managed instance group was executing on + * the instance when the error occurred. Possible values: * * Protobuf type google.cloud.compute.v1.InstanceManagedByIgmErrorInstanceActionDetails.Action */ @@ -20,19 +21,26 @@ class Action */ const UNDEFINED_ACTION = 0; /** - * The managed instance group is abandoning this instance. The instance will be removed from the instance group and from any target pools that are associated with this group. + * The managed instance group is abandoning this instance. The instance + * will be removed from the instance group and from any target pools that + * are associated with this group. * * Generated from protobuf enum ABANDONING = 388244813; */ const ABANDONING = 388244813; /** - * The managed instance group is creating this instance. If the group fails to create this instance, it will try again until it is successful. + * The managed instance group is creating this instance. If the group + * fails to create this instance, it will try again until it is + * successful. * * Generated from protobuf enum CREATING = 455564985; */ const CREATING = 455564985; /** - * The managed instance group is attempting to create this instance only once. If the group fails to create this instance, it does not try again and the group's targetSize value is decreased. + * The managed instance group is attempting to create this instance + * only once. If the group fails to create this instance, it does + * not try again and the group's targetSize value is + * decreased. * * Generated from protobuf enum CREATING_WITHOUT_RETRIES = 428843785; */ @@ -44,7 +52,8 @@ class Action */ const DELETING = 528602024; /** - * The managed instance group has not scheduled any actions for this instance. + * The managed instance group has not scheduled any actions for this + * instance. * * Generated from protobuf enum NONE = 2402104; */ @@ -56,7 +65,9 @@ class Action */ const RECREATING = 287278572; /** - * The managed instance group is applying configuration changes to the instance without stopping it. For example, the group can update the target pool list for an instance without stopping that instance. + * The managed instance group is applying configuration changes to the + * instance without stopping it. For example, the group can update the + * target pool list for an instance without stopping that instance. * * Generated from protobuf enum REFRESHING = 163266343; */ @@ -92,7 +103,14 @@ class Action */ const SUSPENDING = 514206246; /** - * The managed instance group is verifying this already created instance. Verification happens every time the instance is (re)created or restarted and consists of: 1. Waiting until health check specified as part of this managed instance group's autohealing policy reports HEALTHY. Note: Applies only if autohealing policy has a health check specified 2. Waiting for addition verification steps performed as post-instance creation (subject to future extensions). + * The managed instance group is verifying this already created instance. + * Verification happens every time the instance is (re)created or restarted + * and consists of: + * 1. Waiting until health check specified as part of this managed instance + * group's autohealing policy reports HEALTHY. + * Note: Applies only if autohealing policy has a health check specified + * 2. Waiting for addition verification steps performed as post-instance + * creation (subject to future extensions). * * Generated from protobuf enum VERIFYING = 16982185; */ diff --git a/Compute/src/V1/InstanceMoveRequest.php b/Compute/src/V1/InstanceMoveRequest.php index 38673a8d0201..5d9c12acf67e 100644 --- a/Compute/src/V1/InstanceMoveRequest.php +++ b/Compute/src/V1/InstanceMoveRequest.php @@ -15,13 +15,21 @@ class InstanceMoveRequest extends \Google\Protobuf\Internal\Message { /** - * The URL of the destination zone to move the instance. This can be a full or partial URL. For example, the following are all valid URLs to a zone: - https://www.googleapis.com/compute/v1/projects/project/zones/zone - projects/project/zones/zone - zones/zone + * The URL of the destination zone to move the instance. This can be a full or + * partial URL. For example, the following are all valid URLs to a zone: + * - https://www.googleapis.com/compute/v1/projects/project/zones/zone + * - projects/project/zones/zone + * - zones/zone * * Generated from protobuf field optional string destination_zone = 131854653; */ protected $destination_zone = null; /** - * The URL of the target instance to move. This can be a full or partial URL. For example, the following are all valid URLs to an instance: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /instances/instance - projects/project/zones/zone/instances/instance - zones/zone/instances/instance + * The URL of the target instance to move. This can be a full or partial URL. + * For example, the following are all valid URLs to an instance: + * - https://www.googleapis.com/compute/v1/projects/project/zones/zone/instances/instance + * - projects/project/zones/zone/instances/instance + * - zones/zone/instances/instance * * Generated from protobuf field optional string target_instance = 289769347; */ @@ -34,9 +42,17 @@ class InstanceMoveRequest extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $destination_zone - * The URL of the destination zone to move the instance. This can be a full or partial URL. For example, the following are all valid URLs to a zone: - https://www.googleapis.com/compute/v1/projects/project/zones/zone - projects/project/zones/zone - zones/zone + * The URL of the destination zone to move the instance. This can be a full or + * partial URL. For example, the following are all valid URLs to a zone: + * - https://www.googleapis.com/compute/v1/projects/project/zones/zone + * - projects/project/zones/zone + * - zones/zone * @type string $target_instance - * The URL of the target instance to move. This can be a full or partial URL. For example, the following are all valid URLs to an instance: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /instances/instance - projects/project/zones/zone/instances/instance - zones/zone/instances/instance + * The URL of the target instance to move. This can be a full or partial URL. + * For example, the following are all valid URLs to an instance: + * - https://www.googleapis.com/compute/v1/projects/project/zones/zone/instances/instance + * - projects/project/zones/zone/instances/instance + * - zones/zone/instances/instance * } */ public function __construct($data = NULL) { @@ -45,7 +61,11 @@ public function __construct($data = NULL) { } /** - * The URL of the destination zone to move the instance. This can be a full or partial URL. For example, the following are all valid URLs to a zone: - https://www.googleapis.com/compute/v1/projects/project/zones/zone - projects/project/zones/zone - zones/zone + * The URL of the destination zone to move the instance. This can be a full or + * partial URL. For example, the following are all valid URLs to a zone: + * - https://www.googleapis.com/compute/v1/projects/project/zones/zone + * - projects/project/zones/zone + * - zones/zone * * Generated from protobuf field optional string destination_zone = 131854653; * @return string @@ -66,7 +86,11 @@ public function clearDestinationZone() } /** - * The URL of the destination zone to move the instance. This can be a full or partial URL. For example, the following are all valid URLs to a zone: - https://www.googleapis.com/compute/v1/projects/project/zones/zone - projects/project/zones/zone - zones/zone + * The URL of the destination zone to move the instance. This can be a full or + * partial URL. For example, the following are all valid URLs to a zone: + * - https://www.googleapis.com/compute/v1/projects/project/zones/zone + * - projects/project/zones/zone + * - zones/zone * * Generated from protobuf field optional string destination_zone = 131854653; * @param string $var @@ -81,7 +105,11 @@ public function setDestinationZone($var) } /** - * The URL of the target instance to move. This can be a full or partial URL. For example, the following are all valid URLs to an instance: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /instances/instance - projects/project/zones/zone/instances/instance - zones/zone/instances/instance + * The URL of the target instance to move. This can be a full or partial URL. + * For example, the following are all valid URLs to an instance: + * - https://www.googleapis.com/compute/v1/projects/project/zones/zone/instances/instance + * - projects/project/zones/zone/instances/instance + * - zones/zone/instances/instance * * Generated from protobuf field optional string target_instance = 289769347; * @return string @@ -102,7 +130,11 @@ public function clearTargetInstance() } /** - * The URL of the target instance to move. This can be a full or partial URL. For example, the following are all valid URLs to an instance: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /instances/instance - projects/project/zones/zone/instances/instance - zones/zone/instances/instance + * The URL of the target instance to move. This can be a full or partial URL. + * For example, the following are all valid URLs to an instance: + * - https://www.googleapis.com/compute/v1/projects/project/zones/zone/instances/instance + * - projects/project/zones/zone/instances/instance + * - zones/zone/instances/instance * * Generated from protobuf field optional string target_instance = 289769347; * @param string $var diff --git a/Compute/src/V1/InstanceParams.php b/Compute/src/V1/InstanceParams.php index 69464c96792b..568012b2626c 100644 --- a/Compute/src/V1/InstanceParams.php +++ b/Compute/src/V1/InstanceParams.php @@ -16,13 +16,18 @@ class InstanceParams extends \Google\Protobuf\Internal\Message { /** - * Relative deadline for waiting for capacity. Relevant only for Instances.Insert API. + * Relative deadline for waiting for capacity. Relevant only for + * Instances.Insert API. * * Generated from protobuf field optional .google.cloud.compute.v1.Duration request_valid_for_duration = 116247389; */ protected $request_valid_for_duration = null; /** - * Resource manager tags to be bound to the instance. Tag keys and values have the same definition as resource manager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and values are in the format `tagValues/456`. The field is ignored (both PUT & PATCH) when empty. + * Resource manager tags to be bound to the instance. Tag keys and values + * have the same definition as resource + * manager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and + * values are in the format `tagValues/456`. The field is ignored (both PUT & + * PATCH) when empty. * * Generated from protobuf field map resource_manager_tags = 377671164; */ @@ -35,9 +40,14 @@ class InstanceParams extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type \Google\Cloud\Compute\V1\Duration $request_valid_for_duration - * Relative deadline for waiting for capacity. Relevant only for Instances.Insert API. + * Relative deadline for waiting for capacity. Relevant only for + * Instances.Insert API. * @type array|\Google\Protobuf\Internal\MapField $resource_manager_tags - * Resource manager tags to be bound to the instance. Tag keys and values have the same definition as resource manager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and values are in the format `tagValues/456`. The field is ignored (both PUT & PATCH) when empty. + * Resource manager tags to be bound to the instance. Tag keys and values + * have the same definition as resource + * manager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and + * values are in the format `tagValues/456`. The field is ignored (both PUT & + * PATCH) when empty. * } */ public function __construct($data = NULL) { @@ -46,7 +56,8 @@ public function __construct($data = NULL) { } /** - * Relative deadline for waiting for capacity. Relevant only for Instances.Insert API. + * Relative deadline for waiting for capacity. Relevant only for + * Instances.Insert API. * * Generated from protobuf field optional .google.cloud.compute.v1.Duration request_valid_for_duration = 116247389; * @return \Google\Cloud\Compute\V1\Duration|null @@ -67,7 +78,8 @@ public function clearRequestValidForDuration() } /** - * Relative deadline for waiting for capacity. Relevant only for Instances.Insert API. + * Relative deadline for waiting for capacity. Relevant only for + * Instances.Insert API. * * Generated from protobuf field optional .google.cloud.compute.v1.Duration request_valid_for_duration = 116247389; * @param \Google\Cloud\Compute\V1\Duration $var @@ -82,7 +94,11 @@ public function setRequestValidForDuration($var) } /** - * Resource manager tags to be bound to the instance. Tag keys and values have the same definition as resource manager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and values are in the format `tagValues/456`. The field is ignored (both PUT & PATCH) when empty. + * Resource manager tags to be bound to the instance. Tag keys and values + * have the same definition as resource + * manager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and + * values are in the format `tagValues/456`. The field is ignored (both PUT & + * PATCH) when empty. * * Generated from protobuf field map resource_manager_tags = 377671164; * @return \Google\Protobuf\Internal\MapField @@ -93,7 +109,11 @@ public function getResourceManagerTags() } /** - * Resource manager tags to be bound to the instance. Tag keys and values have the same definition as resource manager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and values are in the format `tagValues/456`. The field is ignored (both PUT & PATCH) when empty. + * Resource manager tags to be bound to the instance. Tag keys and values + * have the same definition as resource + * manager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and + * values are in the format `tagValues/456`. The field is ignored (both PUT & + * PATCH) when empty. * * Generated from protobuf field map resource_manager_tags = 377671164; * @param array|\Google\Protobuf\Internal\MapField $var diff --git a/Compute/src/V1/InstanceProperties.php b/Compute/src/V1/InstanceProperties.php index b59acc9001fb..1d4578271090 100644 --- a/Compute/src/V1/InstanceProperties.php +++ b/Compute/src/V1/InstanceProperties.php @@ -15,43 +15,54 @@ class InstanceProperties extends \Google\Protobuf\Internal\Message { /** - * Controls for advanced machine-related behavior features. Note that for MachineImage, this is not supported yet. + * Controls for advanced machine-related behavior features. + * Note that for MachineImage, this is not supported yet. * * Generated from protobuf field optional .google.cloud.compute.v1.AdvancedMachineFeatures advanced_machine_features = 409646002; */ protected $advanced_machine_features = null; /** - * Enables instances created based on these properties to send packets with source IP addresses other than their own and receive packets with destination IP addresses other than their own. If these instances will be used as an IP gateway or it will be set as the next-hop in a Route resource, specify true. If unsure, leave this set to false. See the Enable IP forwarding documentation for more information. + * Enables instances created based on these properties to send packets with + * source IP addresses other than their own and receive packets with + * destination IP addresses other than their own. If these instances will be + * used as an IP gateway or it will be set as the next-hop in a Route + * resource, specify true. If unsure, leave this set tofalse. See theEnable IP forwarding + * documentation for more information. * * Generated from protobuf field optional bool can_ip_forward = 467731324; */ protected $can_ip_forward = null; /** - * Specifies the Confidential Instance options. Note that for MachineImage, this is not supported yet. + * Specifies the Confidential Instance options. + * Note that for MachineImage, this is not supported yet. * * Generated from protobuf field optional .google.cloud.compute.v1.ConfidentialInstanceConfig confidential_instance_config = 490637685; */ protected $confidential_instance_config = null; /** - * An optional text description for the instances that are created from these properties. + * An optional text description for the instances that are created from these + * properties. * * Generated from protobuf field optional string description = 422937596; */ protected $description = null; /** - * An array of disks that are associated with the instances that are created from these properties. + * An array of disks that are associated with the instances that are created + * from these properties. * * Generated from protobuf field repeated .google.cloud.compute.v1.AttachedDisk disks = 95594102; */ private $disks; /** - * A list of guest accelerator cards' type and count to use for instances created from these properties. + * A list of guest accelerator cards' type and count to use for instances + * created from these properties. * * Generated from protobuf field repeated .google.cloud.compute.v1.AcceleratorConfig guest_accelerators = 463595119; */ private $guest_accelerators; /** - * KeyRevocationActionType of the instance. Supported options are "STOP" and "NONE". The default value is "NONE" if it is not specified. + * KeyRevocationActionType of the instance. Supported options are "STOP" and + * "NONE". The default value is "NONE" if it is not specified. * Check the KeyRevocationActionType enum for the list of possible values. * * Generated from protobuf field optional string key_revocation_action_type = 235941474; @@ -64,19 +75,31 @@ class InstanceProperties extends \Google\Protobuf\Internal\Message */ private $labels; /** - * The machine type to use for instances that are created from these properties. This field only accepts a machine type name, for example `n2-standard-4`. If you use the machine type full or partial URL, for example `projects/my-l7ilb-project/zones/us-central1-a/machineTypes/n2-standard-4`, the request will result in an `INTERNAL_ERROR`. + * The machine type to use for instances that are created from these + * properties. + * This field only accepts a machine type name, for example `n2-standard-4`. + * If you use the machine type full or partial URL, for example + * `projects/my-l7ilb-project/zones/us-central1-a/machineTypes/n2-standard-4`, + * the request will result in an `INTERNAL_ERROR`. * * Generated from protobuf field optional string machine_type = 227711026; */ protected $machine_type = null; /** - * The metadata key/value pairs to assign to instances that are created from these properties. These pairs can consist of custom metadata or predefined keys. See Project and instance metadata for more information. + * The metadata key/value pairs to assign to instances that are created from + * these properties. These pairs can consist of custom metadata or predefined + * keys. SeeProject and + * instance metadata for more information. * * Generated from protobuf field optional .google.cloud.compute.v1.Metadata metadata = 86866735; */ protected $metadata = null; /** - * Minimum cpu/platform to be used by instances. The instance may be scheduled on the specified or newer cpu/platform. Applicable values are the friendly names of CPU platforms, such as minCpuPlatform: "Intel Haswell" or minCpuPlatform: "Intel Sandy Bridge". For more information, read Specifying a Minimum CPU Platform. + * Minimum cpu/platform to be used by instances. The instance may be + * scheduled on the specified or newer cpu/platform. Applicable values are the + * friendly names of CPU platforms, such asminCpuPlatform: "Intel Haswell" orminCpuPlatform: "Intel Sandy Bridge". For more + * information, read Specifying a + * Minimum CPU Platform. * * Generated from protobuf field optional string min_cpu_platform = 242912759; */ @@ -94,38 +117,51 @@ class InstanceProperties extends \Google\Protobuf\Internal\Message */ protected $network_performance_config = null; /** - * The private IPv6 google access type for VMs. If not specified, use INHERIT_FROM_SUBNETWORK as default. Note that for MachineImage, this is not supported yet. + * The private IPv6 google access type for VMs. + * If not specified, use INHERIT_FROM_SUBNETWORK as default. + * Note that for MachineImage, this is not supported yet. * Check the PrivateIpv6GoogleAccess enum for the list of possible values. * * Generated from protobuf field optional string private_ipv6_google_access = 48277006; */ protected $private_ipv6_google_access = null; /** - * Specifies the reservations that instances can consume from. Note that for MachineImage, this is not supported yet. + * Specifies the reservations that instances can consume from. + * Note that for MachineImage, this is not supported yet. * * Generated from protobuf field optional .google.cloud.compute.v1.ReservationAffinity reservation_affinity = 157850683; */ protected $reservation_affinity = null; /** - * Resource manager tags to be bound to the instance. Tag keys and values have the same definition as resource manager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and values are in the format `tagValues/456`. The field is ignored (both PUT & PATCH) when empty. + * Resource manager tags to be bound to the instance. Tag keys and values + * have the same definition as resource + * manager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and + * values are in the format `tagValues/456`. The field is ignored (both PUT & + * PATCH) when empty. * * Generated from protobuf field map resource_manager_tags = 377671164; */ private $resource_manager_tags; /** - * Resource policies (names, not URLs) applied to instances created from these properties. Note that for MachineImage, this is not supported yet. + * Resource policies (names, not URLs) applied to instances created from + * these properties. + * Note that for MachineImage, this is not supported yet. * * Generated from protobuf field repeated string resource_policies = 22220385; */ private $resource_policies; /** - * Specifies the scheduling options for the instances that are created from these properties. + * Specifies the scheduling options for the instances that are created from + * these properties. * * Generated from protobuf field optional .google.cloud.compute.v1.Scheduling scheduling = 386688404; */ protected $scheduling = null; /** - * A list of service accounts with specified scopes. Access tokens for these service accounts are available to the instances that are created from these properties. Use metadata queries to obtain the access tokens for these instances. + * A list of service accounts with specified scopes. Access tokens for these + * service accounts are available to the instances that are created from + * these properties. Use metadata queries to obtain the access tokens for + * these instances. * * Generated from protobuf field repeated .google.cloud.compute.v1.ServiceAccount service_accounts = 277537328; */ @@ -137,7 +173,10 @@ class InstanceProperties extends \Google\Protobuf\Internal\Message */ protected $shielded_instance_config = null; /** - * A list of tags to apply to the instances that are created from these properties. The tags identify valid sources or targets for network firewalls. The setTags method can modify this list of tags. Each tag within the list must comply with RFC1035. + * A list of tags to apply to the instances that are created from these + * properties. The tags identify valid sources or targets for network + * firewalls. The setTags method can modify this list of tags. Each tag within + * the list must comply with RFC1035. * * Generated from protobuf field optional .google.cloud.compute.v1.Tags tags = 3552281; */ @@ -150,49 +189,88 @@ class InstanceProperties extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type \Google\Cloud\Compute\V1\AdvancedMachineFeatures $advanced_machine_features - * Controls for advanced machine-related behavior features. Note that for MachineImage, this is not supported yet. + * Controls for advanced machine-related behavior features. + * Note that for MachineImage, this is not supported yet. * @type bool $can_ip_forward - * Enables instances created based on these properties to send packets with source IP addresses other than their own and receive packets with destination IP addresses other than their own. If these instances will be used as an IP gateway or it will be set as the next-hop in a Route resource, specify true. If unsure, leave this set to false. See the Enable IP forwarding documentation for more information. + * Enables instances created based on these properties to send packets with + * source IP addresses other than their own and receive packets with + * destination IP addresses other than their own. If these instances will be + * used as an IP gateway or it will be set as the next-hop in a Route + * resource, specify true. If unsure, leave this set tofalse. See theEnable IP forwarding + * documentation for more information. * @type \Google\Cloud\Compute\V1\ConfidentialInstanceConfig $confidential_instance_config - * Specifies the Confidential Instance options. Note that for MachineImage, this is not supported yet. + * Specifies the Confidential Instance options. + * Note that for MachineImage, this is not supported yet. * @type string $description - * An optional text description for the instances that are created from these properties. + * An optional text description for the instances that are created from these + * properties. * @type array<\Google\Cloud\Compute\V1\AttachedDisk>|\Google\Protobuf\Internal\RepeatedField $disks - * An array of disks that are associated with the instances that are created from these properties. + * An array of disks that are associated with the instances that are created + * from these properties. * @type array<\Google\Cloud\Compute\V1\AcceleratorConfig>|\Google\Protobuf\Internal\RepeatedField $guest_accelerators - * A list of guest accelerator cards' type and count to use for instances created from these properties. + * A list of guest accelerator cards' type and count to use for instances + * created from these properties. * @type string $key_revocation_action_type - * KeyRevocationActionType of the instance. Supported options are "STOP" and "NONE". The default value is "NONE" if it is not specified. + * KeyRevocationActionType of the instance. Supported options are "STOP" and + * "NONE". The default value is "NONE" if it is not specified. * Check the KeyRevocationActionType enum for the list of possible values. * @type array|\Google\Protobuf\Internal\MapField $labels * Labels to apply to instances that are created from these properties. * @type string $machine_type - * The machine type to use for instances that are created from these properties. This field only accepts a machine type name, for example `n2-standard-4`. If you use the machine type full or partial URL, for example `projects/my-l7ilb-project/zones/us-central1-a/machineTypes/n2-standard-4`, the request will result in an `INTERNAL_ERROR`. + * The machine type to use for instances that are created from these + * properties. + * This field only accepts a machine type name, for example `n2-standard-4`. + * If you use the machine type full or partial URL, for example + * `projects/my-l7ilb-project/zones/us-central1-a/machineTypes/n2-standard-4`, + * the request will result in an `INTERNAL_ERROR`. * @type \Google\Cloud\Compute\V1\Metadata $metadata - * The metadata key/value pairs to assign to instances that are created from these properties. These pairs can consist of custom metadata or predefined keys. See Project and instance metadata for more information. + * The metadata key/value pairs to assign to instances that are created from + * these properties. These pairs can consist of custom metadata or predefined + * keys. SeeProject and + * instance metadata for more information. * @type string $min_cpu_platform - * Minimum cpu/platform to be used by instances. The instance may be scheduled on the specified or newer cpu/platform. Applicable values are the friendly names of CPU platforms, such as minCpuPlatform: "Intel Haswell" or minCpuPlatform: "Intel Sandy Bridge". For more information, read Specifying a Minimum CPU Platform. + * Minimum cpu/platform to be used by instances. The instance may be + * scheduled on the specified or newer cpu/platform. Applicable values are the + * friendly names of CPU platforms, such asminCpuPlatform: "Intel Haswell" orminCpuPlatform: "Intel Sandy Bridge". For more + * information, read Specifying a + * Minimum CPU Platform. * @type array<\Google\Cloud\Compute\V1\NetworkInterface>|\Google\Protobuf\Internal\RepeatedField $network_interfaces * An array of network access configurations for this interface. * @type \Google\Cloud\Compute\V1\NetworkPerformanceConfig $network_performance_config * Note that for MachineImage, this is not supported yet. * @type string $private_ipv6_google_access - * The private IPv6 google access type for VMs. If not specified, use INHERIT_FROM_SUBNETWORK as default. Note that for MachineImage, this is not supported yet. + * The private IPv6 google access type for VMs. + * If not specified, use INHERIT_FROM_SUBNETWORK as default. + * Note that for MachineImage, this is not supported yet. * Check the PrivateIpv6GoogleAccess enum for the list of possible values. * @type \Google\Cloud\Compute\V1\ReservationAffinity $reservation_affinity - * Specifies the reservations that instances can consume from. Note that for MachineImage, this is not supported yet. + * Specifies the reservations that instances can consume from. + * Note that for MachineImage, this is not supported yet. * @type array|\Google\Protobuf\Internal\MapField $resource_manager_tags - * Resource manager tags to be bound to the instance. Tag keys and values have the same definition as resource manager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and values are in the format `tagValues/456`. The field is ignored (both PUT & PATCH) when empty. + * Resource manager tags to be bound to the instance. Tag keys and values + * have the same definition as resource + * manager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and + * values are in the format `tagValues/456`. The field is ignored (both PUT & + * PATCH) when empty. * @type array|\Google\Protobuf\Internal\RepeatedField $resource_policies - * Resource policies (names, not URLs) applied to instances created from these properties. Note that for MachineImage, this is not supported yet. + * Resource policies (names, not URLs) applied to instances created from + * these properties. + * Note that for MachineImage, this is not supported yet. * @type \Google\Cloud\Compute\V1\Scheduling $scheduling - * Specifies the scheduling options for the instances that are created from these properties. + * Specifies the scheduling options for the instances that are created from + * these properties. * @type array<\Google\Cloud\Compute\V1\ServiceAccount>|\Google\Protobuf\Internal\RepeatedField $service_accounts - * A list of service accounts with specified scopes. Access tokens for these service accounts are available to the instances that are created from these properties. Use metadata queries to obtain the access tokens for these instances. + * A list of service accounts with specified scopes. Access tokens for these + * service accounts are available to the instances that are created from + * these properties. Use metadata queries to obtain the access tokens for + * these instances. * @type \Google\Cloud\Compute\V1\ShieldedInstanceConfig $shielded_instance_config * Note that for MachineImage, this is not supported yet. * @type \Google\Cloud\Compute\V1\Tags $tags - * A list of tags to apply to the instances that are created from these properties. The tags identify valid sources or targets for network firewalls. The setTags method can modify this list of tags. Each tag within the list must comply with RFC1035. + * A list of tags to apply to the instances that are created from these + * properties. The tags identify valid sources or targets for network + * firewalls. The setTags method can modify this list of tags. Each tag within + * the list must comply with RFC1035. * } */ public function __construct($data = NULL) { @@ -201,7 +279,8 @@ public function __construct($data = NULL) { } /** - * Controls for advanced machine-related behavior features. Note that for MachineImage, this is not supported yet. + * Controls for advanced machine-related behavior features. + * Note that for MachineImage, this is not supported yet. * * Generated from protobuf field optional .google.cloud.compute.v1.AdvancedMachineFeatures advanced_machine_features = 409646002; * @return \Google\Cloud\Compute\V1\AdvancedMachineFeatures|null @@ -222,7 +301,8 @@ public function clearAdvancedMachineFeatures() } /** - * Controls for advanced machine-related behavior features. Note that for MachineImage, this is not supported yet. + * Controls for advanced machine-related behavior features. + * Note that for MachineImage, this is not supported yet. * * Generated from protobuf field optional .google.cloud.compute.v1.AdvancedMachineFeatures advanced_machine_features = 409646002; * @param \Google\Cloud\Compute\V1\AdvancedMachineFeatures $var @@ -237,7 +317,12 @@ public function setAdvancedMachineFeatures($var) } /** - * Enables instances created based on these properties to send packets with source IP addresses other than their own and receive packets with destination IP addresses other than their own. If these instances will be used as an IP gateway or it will be set as the next-hop in a Route resource, specify true. If unsure, leave this set to false. See the Enable IP forwarding documentation for more information. + * Enables instances created based on these properties to send packets with + * source IP addresses other than their own and receive packets with + * destination IP addresses other than their own. If these instances will be + * used as an IP gateway or it will be set as the next-hop in a Route + * resource, specify true. If unsure, leave this set tofalse. See theEnable IP forwarding + * documentation for more information. * * Generated from protobuf field optional bool can_ip_forward = 467731324; * @return bool @@ -258,7 +343,12 @@ public function clearCanIpForward() } /** - * Enables instances created based on these properties to send packets with source IP addresses other than their own and receive packets with destination IP addresses other than their own. If these instances will be used as an IP gateway or it will be set as the next-hop in a Route resource, specify true. If unsure, leave this set to false. See the Enable IP forwarding documentation for more information. + * Enables instances created based on these properties to send packets with + * source IP addresses other than their own and receive packets with + * destination IP addresses other than their own. If these instances will be + * used as an IP gateway or it will be set as the next-hop in a Route + * resource, specify true. If unsure, leave this set tofalse. See theEnable IP forwarding + * documentation for more information. * * Generated from protobuf field optional bool can_ip_forward = 467731324; * @param bool $var @@ -273,7 +363,8 @@ public function setCanIpForward($var) } /** - * Specifies the Confidential Instance options. Note that for MachineImage, this is not supported yet. + * Specifies the Confidential Instance options. + * Note that for MachineImage, this is not supported yet. * * Generated from protobuf field optional .google.cloud.compute.v1.ConfidentialInstanceConfig confidential_instance_config = 490637685; * @return \Google\Cloud\Compute\V1\ConfidentialInstanceConfig|null @@ -294,7 +385,8 @@ public function clearConfidentialInstanceConfig() } /** - * Specifies the Confidential Instance options. Note that for MachineImage, this is not supported yet. + * Specifies the Confidential Instance options. + * Note that for MachineImage, this is not supported yet. * * Generated from protobuf field optional .google.cloud.compute.v1.ConfidentialInstanceConfig confidential_instance_config = 490637685; * @param \Google\Cloud\Compute\V1\ConfidentialInstanceConfig $var @@ -309,7 +401,8 @@ public function setConfidentialInstanceConfig($var) } /** - * An optional text description for the instances that are created from these properties. + * An optional text description for the instances that are created from these + * properties. * * Generated from protobuf field optional string description = 422937596; * @return string @@ -330,7 +423,8 @@ public function clearDescription() } /** - * An optional text description for the instances that are created from these properties. + * An optional text description for the instances that are created from these + * properties. * * Generated from protobuf field optional string description = 422937596; * @param string $var @@ -345,7 +439,8 @@ public function setDescription($var) } /** - * An array of disks that are associated with the instances that are created from these properties. + * An array of disks that are associated with the instances that are created + * from these properties. * * Generated from protobuf field repeated .google.cloud.compute.v1.AttachedDisk disks = 95594102; * @return \Google\Protobuf\Internal\RepeatedField @@ -356,7 +451,8 @@ public function getDisks() } /** - * An array of disks that are associated with the instances that are created from these properties. + * An array of disks that are associated with the instances that are created + * from these properties. * * Generated from protobuf field repeated .google.cloud.compute.v1.AttachedDisk disks = 95594102; * @param array<\Google\Cloud\Compute\V1\AttachedDisk>|\Google\Protobuf\Internal\RepeatedField $var @@ -371,7 +467,8 @@ public function setDisks($var) } /** - * A list of guest accelerator cards' type and count to use for instances created from these properties. + * A list of guest accelerator cards' type and count to use for instances + * created from these properties. * * Generated from protobuf field repeated .google.cloud.compute.v1.AcceleratorConfig guest_accelerators = 463595119; * @return \Google\Protobuf\Internal\RepeatedField @@ -382,7 +479,8 @@ public function getGuestAccelerators() } /** - * A list of guest accelerator cards' type and count to use for instances created from these properties. + * A list of guest accelerator cards' type and count to use for instances + * created from these properties. * * Generated from protobuf field repeated .google.cloud.compute.v1.AcceleratorConfig guest_accelerators = 463595119; * @param array<\Google\Cloud\Compute\V1\AcceleratorConfig>|\Google\Protobuf\Internal\RepeatedField $var @@ -397,7 +495,8 @@ public function setGuestAccelerators($var) } /** - * KeyRevocationActionType of the instance. Supported options are "STOP" and "NONE". The default value is "NONE" if it is not specified. + * KeyRevocationActionType of the instance. Supported options are "STOP" and + * "NONE". The default value is "NONE" if it is not specified. * Check the KeyRevocationActionType enum for the list of possible values. * * Generated from protobuf field optional string key_revocation_action_type = 235941474; @@ -419,7 +518,8 @@ public function clearKeyRevocationActionType() } /** - * KeyRevocationActionType of the instance. Supported options are "STOP" and "NONE". The default value is "NONE" if it is not specified. + * KeyRevocationActionType of the instance. Supported options are "STOP" and + * "NONE". The default value is "NONE" if it is not specified. * Check the KeyRevocationActionType enum for the list of possible values. * * Generated from protobuf field optional string key_revocation_action_type = 235941474; @@ -461,7 +561,12 @@ public function setLabels($var) } /** - * The machine type to use for instances that are created from these properties. This field only accepts a machine type name, for example `n2-standard-4`. If you use the machine type full or partial URL, for example `projects/my-l7ilb-project/zones/us-central1-a/machineTypes/n2-standard-4`, the request will result in an `INTERNAL_ERROR`. + * The machine type to use for instances that are created from these + * properties. + * This field only accepts a machine type name, for example `n2-standard-4`. + * If you use the machine type full or partial URL, for example + * `projects/my-l7ilb-project/zones/us-central1-a/machineTypes/n2-standard-4`, + * the request will result in an `INTERNAL_ERROR`. * * Generated from protobuf field optional string machine_type = 227711026; * @return string @@ -482,7 +587,12 @@ public function clearMachineType() } /** - * The machine type to use for instances that are created from these properties. This field only accepts a machine type name, for example `n2-standard-4`. If you use the machine type full or partial URL, for example `projects/my-l7ilb-project/zones/us-central1-a/machineTypes/n2-standard-4`, the request will result in an `INTERNAL_ERROR`. + * The machine type to use for instances that are created from these + * properties. + * This field only accepts a machine type name, for example `n2-standard-4`. + * If you use the machine type full or partial URL, for example + * `projects/my-l7ilb-project/zones/us-central1-a/machineTypes/n2-standard-4`, + * the request will result in an `INTERNAL_ERROR`. * * Generated from protobuf field optional string machine_type = 227711026; * @param string $var @@ -497,7 +607,10 @@ public function setMachineType($var) } /** - * The metadata key/value pairs to assign to instances that are created from these properties. These pairs can consist of custom metadata or predefined keys. See Project and instance metadata for more information. + * The metadata key/value pairs to assign to instances that are created from + * these properties. These pairs can consist of custom metadata or predefined + * keys. SeeProject and + * instance metadata for more information. * * Generated from protobuf field optional .google.cloud.compute.v1.Metadata metadata = 86866735; * @return \Google\Cloud\Compute\V1\Metadata|null @@ -518,7 +631,10 @@ public function clearMetadata() } /** - * The metadata key/value pairs to assign to instances that are created from these properties. These pairs can consist of custom metadata or predefined keys. See Project and instance metadata for more information. + * The metadata key/value pairs to assign to instances that are created from + * these properties. These pairs can consist of custom metadata or predefined + * keys. SeeProject and + * instance metadata for more information. * * Generated from protobuf field optional .google.cloud.compute.v1.Metadata metadata = 86866735; * @param \Google\Cloud\Compute\V1\Metadata $var @@ -533,7 +649,11 @@ public function setMetadata($var) } /** - * Minimum cpu/platform to be used by instances. The instance may be scheduled on the specified or newer cpu/platform. Applicable values are the friendly names of CPU platforms, such as minCpuPlatform: "Intel Haswell" or minCpuPlatform: "Intel Sandy Bridge". For more information, read Specifying a Minimum CPU Platform. + * Minimum cpu/platform to be used by instances. The instance may be + * scheduled on the specified or newer cpu/platform. Applicable values are the + * friendly names of CPU platforms, such asminCpuPlatform: "Intel Haswell" orminCpuPlatform: "Intel Sandy Bridge". For more + * information, read Specifying a + * Minimum CPU Platform. * * Generated from protobuf field optional string min_cpu_platform = 242912759; * @return string @@ -554,7 +674,11 @@ public function clearMinCpuPlatform() } /** - * Minimum cpu/platform to be used by instances. The instance may be scheduled on the specified or newer cpu/platform. Applicable values are the friendly names of CPU platforms, such as minCpuPlatform: "Intel Haswell" or minCpuPlatform: "Intel Sandy Bridge". For more information, read Specifying a Minimum CPU Platform. + * Minimum cpu/platform to be used by instances. The instance may be + * scheduled on the specified or newer cpu/platform. Applicable values are the + * friendly names of CPU platforms, such asminCpuPlatform: "Intel Haswell" orminCpuPlatform: "Intel Sandy Bridge". For more + * information, read Specifying a + * Minimum CPU Platform. * * Generated from protobuf field optional string min_cpu_platform = 242912759; * @param string $var @@ -631,7 +755,9 @@ public function setNetworkPerformanceConfig($var) } /** - * The private IPv6 google access type for VMs. If not specified, use INHERIT_FROM_SUBNETWORK as default. Note that for MachineImage, this is not supported yet. + * The private IPv6 google access type for VMs. + * If not specified, use INHERIT_FROM_SUBNETWORK as default. + * Note that for MachineImage, this is not supported yet. * Check the PrivateIpv6GoogleAccess enum for the list of possible values. * * Generated from protobuf field optional string private_ipv6_google_access = 48277006; @@ -653,7 +779,9 @@ public function clearPrivateIpv6GoogleAccess() } /** - * The private IPv6 google access type for VMs. If not specified, use INHERIT_FROM_SUBNETWORK as default. Note that for MachineImage, this is not supported yet. + * The private IPv6 google access type for VMs. + * If not specified, use INHERIT_FROM_SUBNETWORK as default. + * Note that for MachineImage, this is not supported yet. * Check the PrivateIpv6GoogleAccess enum for the list of possible values. * * Generated from protobuf field optional string private_ipv6_google_access = 48277006; @@ -669,7 +797,8 @@ public function setPrivateIpv6GoogleAccess($var) } /** - * Specifies the reservations that instances can consume from. Note that for MachineImage, this is not supported yet. + * Specifies the reservations that instances can consume from. + * Note that for MachineImage, this is not supported yet. * * Generated from protobuf field optional .google.cloud.compute.v1.ReservationAffinity reservation_affinity = 157850683; * @return \Google\Cloud\Compute\V1\ReservationAffinity|null @@ -690,7 +819,8 @@ public function clearReservationAffinity() } /** - * Specifies the reservations that instances can consume from. Note that for MachineImage, this is not supported yet. + * Specifies the reservations that instances can consume from. + * Note that for MachineImage, this is not supported yet. * * Generated from protobuf field optional .google.cloud.compute.v1.ReservationAffinity reservation_affinity = 157850683; * @param \Google\Cloud\Compute\V1\ReservationAffinity $var @@ -705,7 +835,11 @@ public function setReservationAffinity($var) } /** - * Resource manager tags to be bound to the instance. Tag keys and values have the same definition as resource manager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and values are in the format `tagValues/456`. The field is ignored (both PUT & PATCH) when empty. + * Resource manager tags to be bound to the instance. Tag keys and values + * have the same definition as resource + * manager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and + * values are in the format `tagValues/456`. The field is ignored (both PUT & + * PATCH) when empty. * * Generated from protobuf field map resource_manager_tags = 377671164; * @return \Google\Protobuf\Internal\MapField @@ -716,7 +850,11 @@ public function getResourceManagerTags() } /** - * Resource manager tags to be bound to the instance. Tag keys and values have the same definition as resource manager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and values are in the format `tagValues/456`. The field is ignored (both PUT & PATCH) when empty. + * Resource manager tags to be bound to the instance. Tag keys and values + * have the same definition as resource + * manager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and + * values are in the format `tagValues/456`. The field is ignored (both PUT & + * PATCH) when empty. * * Generated from protobuf field map resource_manager_tags = 377671164; * @param array|\Google\Protobuf\Internal\MapField $var @@ -731,7 +869,9 @@ public function setResourceManagerTags($var) } /** - * Resource policies (names, not URLs) applied to instances created from these properties. Note that for MachineImage, this is not supported yet. + * Resource policies (names, not URLs) applied to instances created from + * these properties. + * Note that for MachineImage, this is not supported yet. * * Generated from protobuf field repeated string resource_policies = 22220385; * @return \Google\Protobuf\Internal\RepeatedField @@ -742,7 +882,9 @@ public function getResourcePolicies() } /** - * Resource policies (names, not URLs) applied to instances created from these properties. Note that for MachineImage, this is not supported yet. + * Resource policies (names, not URLs) applied to instances created from + * these properties. + * Note that for MachineImage, this is not supported yet. * * Generated from protobuf field repeated string resource_policies = 22220385; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -757,7 +899,8 @@ public function setResourcePolicies($var) } /** - * Specifies the scheduling options for the instances that are created from these properties. + * Specifies the scheduling options for the instances that are created from + * these properties. * * Generated from protobuf field optional .google.cloud.compute.v1.Scheduling scheduling = 386688404; * @return \Google\Cloud\Compute\V1\Scheduling|null @@ -778,7 +921,8 @@ public function clearScheduling() } /** - * Specifies the scheduling options for the instances that are created from these properties. + * Specifies the scheduling options for the instances that are created from + * these properties. * * Generated from protobuf field optional .google.cloud.compute.v1.Scheduling scheduling = 386688404; * @param \Google\Cloud\Compute\V1\Scheduling $var @@ -793,7 +937,10 @@ public function setScheduling($var) } /** - * A list of service accounts with specified scopes. Access tokens for these service accounts are available to the instances that are created from these properties. Use metadata queries to obtain the access tokens for these instances. + * A list of service accounts with specified scopes. Access tokens for these + * service accounts are available to the instances that are created from + * these properties. Use metadata queries to obtain the access tokens for + * these instances. * * Generated from protobuf field repeated .google.cloud.compute.v1.ServiceAccount service_accounts = 277537328; * @return \Google\Protobuf\Internal\RepeatedField @@ -804,7 +951,10 @@ public function getServiceAccounts() } /** - * A list of service accounts with specified scopes. Access tokens for these service accounts are available to the instances that are created from these properties. Use metadata queries to obtain the access tokens for these instances. + * A list of service accounts with specified scopes. Access tokens for these + * service accounts are available to the instances that are created from + * these properties. Use metadata queries to obtain the access tokens for + * these instances. * * Generated from protobuf field repeated .google.cloud.compute.v1.ServiceAccount service_accounts = 277537328; * @param array<\Google\Cloud\Compute\V1\ServiceAccount>|\Google\Protobuf\Internal\RepeatedField $var @@ -855,7 +1005,10 @@ public function setShieldedInstanceConfig($var) } /** - * A list of tags to apply to the instances that are created from these properties. The tags identify valid sources or targets for network firewalls. The setTags method can modify this list of tags. Each tag within the list must comply with RFC1035. + * A list of tags to apply to the instances that are created from these + * properties. The tags identify valid sources or targets for network + * firewalls. The setTags method can modify this list of tags. Each tag within + * the list must comply with RFC1035. * * Generated from protobuf field optional .google.cloud.compute.v1.Tags tags = 3552281; * @return \Google\Cloud\Compute\V1\Tags|null @@ -876,7 +1029,10 @@ public function clearTags() } /** - * A list of tags to apply to the instances that are created from these properties. The tags identify valid sources or targets for network firewalls. The setTags method can modify this list of tags. Each tag within the list must comply with RFC1035. + * A list of tags to apply to the instances that are created from these + * properties. The tags identify valid sources or targets for network + * firewalls. The setTags method can modify this list of tags. Each tag within + * the list must comply with RFC1035. * * Generated from protobuf field optional .google.cloud.compute.v1.Tags tags = 3552281; * @param \Google\Cloud\Compute\V1\Tags $var diff --git a/Compute/src/V1/InstanceProperties/KeyRevocationActionType.php b/Compute/src/V1/InstanceProperties/KeyRevocationActionType.php index 8bad4c437828..170f136c349e 100644 --- a/Compute/src/V1/InstanceProperties/KeyRevocationActionType.php +++ b/Compute/src/V1/InstanceProperties/KeyRevocationActionType.php @@ -7,7 +7,8 @@ use UnexpectedValueException; /** - * KeyRevocationActionType of the instance. Supported options are "STOP" and "NONE". The default value is "NONE" if it is not specified. + * KeyRevocationActionType of the instance. Supported options are "STOP" and + * "NONE". The default value is "NONE" if it is not specified. * * Protobuf type google.cloud.compute.v1.InstanceProperties.KeyRevocationActionType */ diff --git a/Compute/src/V1/InstanceProperties/PrivateIpv6GoogleAccess.php b/Compute/src/V1/InstanceProperties/PrivateIpv6GoogleAccess.php index a49347fb6f74..80b4c5251851 100644 --- a/Compute/src/V1/InstanceProperties/PrivateIpv6GoogleAccess.php +++ b/Compute/src/V1/InstanceProperties/PrivateIpv6GoogleAccess.php @@ -7,7 +7,9 @@ use UnexpectedValueException; /** - * The private IPv6 google access type for VMs. If not specified, use INHERIT_FROM_SUBNETWORK as default. Note that for MachineImage, this is not supported yet. + * The private IPv6 google access type for VMs. + * If not specified, use INHERIT_FROM_SUBNETWORK as default. + * Note that for MachineImage, this is not supported yet. * * Protobuf type google.cloud.compute.v1.InstanceProperties.PrivateIpv6GoogleAccess */ @@ -20,19 +22,26 @@ class PrivateIpv6GoogleAccess */ const UNDEFINED_PRIVATE_IPV6_GOOGLE_ACCESS = 0; /** - * Bidirectional private IPv6 access to/from Google services. If specified, the subnetwork who is attached to the instance's default network interface will be assigned an internal IPv6 prefix if it doesn't have before. + * Bidirectional private IPv6 access to/from Google services. If + * specified, the subnetwork who is attached to the instance's default network + * interface will be assigned an internal IPv6 prefix if it doesn't have + * before. * * Generated from protobuf enum ENABLE_BIDIRECTIONAL_ACCESS_TO_GOOGLE = 427975994; */ const ENABLE_BIDIRECTIONAL_ACCESS_TO_GOOGLE = 427975994; /** - * Outbound private IPv6 access from VMs in this subnet to Google services. If specified, the subnetwork who is attached to the instance's default network interface will be assigned an internal IPv6 prefix if it doesn't have before. + * Outbound private IPv6 access from VMs in this subnet to Google services. If + * specified, the subnetwork who is attached to the instance's default network + * interface will be assigned an internal IPv6 prefix if it doesn't have + * before. * * Generated from protobuf enum ENABLE_OUTBOUND_VM_ACCESS_TO_GOOGLE = 288210263; */ const ENABLE_OUTBOUND_VM_ACCESS_TO_GOOGLE = 288210263; /** - * Each network interface inherits PrivateIpv6GoogleAccess from its subnetwork. + * Each network interface inherits PrivateIpv6GoogleAccess from its + * subnetwork. * * Generated from protobuf enum INHERIT_FROM_SUBNETWORK = 530256959; */ diff --git a/Compute/src/V1/InstancePropertiesPatch.php b/Compute/src/V1/InstancePropertiesPatch.php index 639f7314e112..ed70dff69aa9 100644 --- a/Compute/src/V1/InstancePropertiesPatch.php +++ b/Compute/src/V1/InstancePropertiesPatch.php @@ -22,7 +22,9 @@ class InstancePropertiesPatch extends \Google\Protobuf\Internal\Message */ private $labels; /** - * The metadata key-value pairs that you want to patch onto the instance. For more information, see Project and instance metadata. + * The metadata key-value pairs that you want to patch onto the instance. For + * more information, see Project and + * instance metadata. * * Generated from protobuf field map metadata = 86866735; */ @@ -37,7 +39,9 @@ class InstancePropertiesPatch extends \Google\Protobuf\Internal\Message * @type array|\Google\Protobuf\Internal\MapField $labels * The label key-value pairs that you want to patch onto the instance. * @type array|\Google\Protobuf\Internal\MapField $metadata - * The metadata key-value pairs that you want to patch onto the instance. For more information, see Project and instance metadata. + * The metadata key-value pairs that you want to patch onto the instance. For + * more information, see Project and + * instance metadata. * } */ public function __construct($data = NULL) { @@ -72,7 +76,9 @@ public function setLabels($var) } /** - * The metadata key-value pairs that you want to patch onto the instance. For more information, see Project and instance metadata. + * The metadata key-value pairs that you want to patch onto the instance. For + * more information, see Project and + * instance metadata. * * Generated from protobuf field map metadata = 86866735; * @return \Google\Protobuf\Internal\MapField @@ -83,7 +89,9 @@ public function getMetadata() } /** - * The metadata key-value pairs that you want to patch onto the instance. For more information, see Project and instance metadata. + * The metadata key-value pairs that you want to patch onto the instance. For + * more information, see Project and + * instance metadata. * * Generated from protobuf field map metadata = 86866735; * @param array|\Google\Protobuf\Internal\MapField $var diff --git a/Compute/src/V1/InstanceReference.php b/Compute/src/V1/InstanceReference.php index e8194ae5c5f2..c3f75d08db71 100644 --- a/Compute/src/V1/InstanceReference.php +++ b/Compute/src/V1/InstanceReference.php @@ -15,7 +15,8 @@ class InstanceReference extends \Google\Protobuf\Internal\Message { /** - * The URL for a specific instance. @required compute.instancegroups.addInstances/removeInstances + * The URL for a specific instance. + * @required compute.instancegroups.addInstances/removeInstances * * Generated from protobuf field optional string instance = 18257045; */ @@ -28,7 +29,8 @@ class InstanceReference extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $instance - * The URL for a specific instance. @required compute.instancegroups.addInstances/removeInstances + * The URL for a specific instance. + * @required compute.instancegroups.addInstances/removeInstances * } */ public function __construct($data = NULL) { @@ -37,7 +39,8 @@ public function __construct($data = NULL) { } /** - * The URL for a specific instance. @required compute.instancegroups.addInstances/removeInstances + * The URL for a specific instance. + * @required compute.instancegroups.addInstances/removeInstances * * Generated from protobuf field optional string instance = 18257045; * @return string @@ -58,7 +61,8 @@ public function clearInstance() } /** - * The URL for a specific instance. @required compute.instancegroups.addInstances/removeInstances + * The URL for a specific instance. + * @required compute.instancegroups.addInstances/removeInstances * * Generated from protobuf field optional string instance = 18257045; * @param string $var diff --git a/Compute/src/V1/InstanceSettings.php b/Compute/src/V1/InstanceSettings.php index 040ab50fe4f4..3568c4a8c112 100644 --- a/Compute/src/V1/InstanceSettings.php +++ b/Compute/src/V1/InstanceSettings.php @@ -9,32 +9,45 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Represents a Instance Settings resource. You can use instance settings to configure default settings for Compute Engine VM instances. For example, you can use it to configure default machine type of Compute Engine VM instances. + * Represents a Instance Settings resource. You can use instance settings to + * configure default settings for Compute Engine VM instances. For example, you + * can use it to configure default machine type of Compute Engine VM instances. * * Generated from protobuf message google.cloud.compute.v1.InstanceSettings */ class InstanceSettings extends \Google\Protobuf\Internal\Message { /** - * Specifies a fingerprint for instance settings, which is essentially a hash of the instance settings resource's contents and used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update the instance settings resource. You must always provide an up-to-date fingerprint hash in order to update or change the resource, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve the resource. + * Specifies a fingerprint for instance settings, which is essentially a hash + * of the instance settings resource's contents and used for optimistic + * locking. The fingerprint is initially generated by Compute Engine and + * changes after every request to modify or update the instance settings + * resource. You must always provide an up-to-date fingerprint hash in order + * to update or change the resource, otherwise the request will fail with + * error 412 conditionNotMet. + * To see the latest fingerprint, make a get() request to + * retrieve the resource. * * Generated from protobuf field optional string fingerprint = 234678500; */ protected $fingerprint = null; /** - * [Output Only] Type of the resource. Always compute#instance_settings for instance settings. + * [Output Only] Type of the resource. Alwayscompute#instance_settings for instance settings. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * The metadata key/value pairs assigned to all the instances in the corresponding scope. + * The metadata key/value pairs assigned to all the instances in the + * corresponding scope. * * Generated from protobuf field optional .google.cloud.compute.v1.InstanceSettingsMetadata metadata = 86866735; */ protected $metadata = null; /** - * [Output Only] URL of the zone where the resource resides You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * [Output Only] URL of the zone where the resource resides + * You must specify this field as part of the HTTP request URL. It is not + * settable as a field in the request body. * * Generated from protobuf field optional string zone = 3744684; */ @@ -47,13 +60,24 @@ class InstanceSettings extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $fingerprint - * Specifies a fingerprint for instance settings, which is essentially a hash of the instance settings resource's contents and used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update the instance settings resource. You must always provide an up-to-date fingerprint hash in order to update or change the resource, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve the resource. + * Specifies a fingerprint for instance settings, which is essentially a hash + * of the instance settings resource's contents and used for optimistic + * locking. The fingerprint is initially generated by Compute Engine and + * changes after every request to modify or update the instance settings + * resource. You must always provide an up-to-date fingerprint hash in order + * to update or change the resource, otherwise the request will fail with + * error 412 conditionNotMet. + * To see the latest fingerprint, make a get() request to + * retrieve the resource. * @type string $kind - * [Output Only] Type of the resource. Always compute#instance_settings for instance settings. + * [Output Only] Type of the resource. Alwayscompute#instance_settings for instance settings. * @type \Google\Cloud\Compute\V1\InstanceSettingsMetadata $metadata - * The metadata key/value pairs assigned to all the instances in the corresponding scope. + * The metadata key/value pairs assigned to all the instances in the + * corresponding scope. * @type string $zone - * [Output Only] URL of the zone where the resource resides You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * [Output Only] URL of the zone where the resource resides + * You must specify this field as part of the HTTP request URL. It is not + * settable as a field in the request body. * } */ public function __construct($data = NULL) { @@ -62,7 +86,15 @@ public function __construct($data = NULL) { } /** - * Specifies a fingerprint for instance settings, which is essentially a hash of the instance settings resource's contents and used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update the instance settings resource. You must always provide an up-to-date fingerprint hash in order to update or change the resource, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve the resource. + * Specifies a fingerprint for instance settings, which is essentially a hash + * of the instance settings resource's contents and used for optimistic + * locking. The fingerprint is initially generated by Compute Engine and + * changes after every request to modify or update the instance settings + * resource. You must always provide an up-to-date fingerprint hash in order + * to update or change the resource, otherwise the request will fail with + * error 412 conditionNotMet. + * To see the latest fingerprint, make a get() request to + * retrieve the resource. * * Generated from protobuf field optional string fingerprint = 234678500; * @return string @@ -83,7 +115,15 @@ public function clearFingerprint() } /** - * Specifies a fingerprint for instance settings, which is essentially a hash of the instance settings resource's contents and used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update the instance settings resource. You must always provide an up-to-date fingerprint hash in order to update or change the resource, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve the resource. + * Specifies a fingerprint for instance settings, which is essentially a hash + * of the instance settings resource's contents and used for optimistic + * locking. The fingerprint is initially generated by Compute Engine and + * changes after every request to modify or update the instance settings + * resource. You must always provide an up-to-date fingerprint hash in order + * to update or change the resource, otherwise the request will fail with + * error 412 conditionNotMet. + * To see the latest fingerprint, make a get() request to + * retrieve the resource. * * Generated from protobuf field optional string fingerprint = 234678500; * @param string $var @@ -98,7 +138,7 @@ public function setFingerprint($var) } /** - * [Output Only] Type of the resource. Always compute#instance_settings for instance settings. + * [Output Only] Type of the resource. Alwayscompute#instance_settings for instance settings. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -119,7 +159,7 @@ public function clearKind() } /** - * [Output Only] Type of the resource. Always compute#instance_settings for instance settings. + * [Output Only] Type of the resource. Alwayscompute#instance_settings for instance settings. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -134,7 +174,8 @@ public function setKind($var) } /** - * The metadata key/value pairs assigned to all the instances in the corresponding scope. + * The metadata key/value pairs assigned to all the instances in the + * corresponding scope. * * Generated from protobuf field optional .google.cloud.compute.v1.InstanceSettingsMetadata metadata = 86866735; * @return \Google\Cloud\Compute\V1\InstanceSettingsMetadata|null @@ -155,7 +196,8 @@ public function clearMetadata() } /** - * The metadata key/value pairs assigned to all the instances in the corresponding scope. + * The metadata key/value pairs assigned to all the instances in the + * corresponding scope. * * Generated from protobuf field optional .google.cloud.compute.v1.InstanceSettingsMetadata metadata = 86866735; * @param \Google\Cloud\Compute\V1\InstanceSettingsMetadata $var @@ -170,7 +212,9 @@ public function setMetadata($var) } /** - * [Output Only] URL of the zone where the resource resides You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * [Output Only] URL of the zone where the resource resides + * You must specify this field as part of the HTTP request URL. It is not + * settable as a field in the request body. * * Generated from protobuf field optional string zone = 3744684; * @return string @@ -191,7 +235,9 @@ public function clearZone() } /** - * [Output Only] URL of the zone where the resource resides You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * [Output Only] URL of the zone where the resource resides + * You must specify this field as part of the HTTP request URL. It is not + * settable as a field in the request body. * * Generated from protobuf field optional string zone = 3744684; * @param string $var diff --git a/Compute/src/V1/InstanceSettingsMetadata.php b/Compute/src/V1/InstanceSettingsMetadata.php index cf49587f9d4a..fa7383e8151a 100644 --- a/Compute/src/V1/InstanceSettingsMetadata.php +++ b/Compute/src/V1/InstanceSettingsMetadata.php @@ -15,13 +15,15 @@ class InstanceSettingsMetadata extends \Google\Protobuf\Internal\Message { /** - * A metadata key/value items map. The total size of all keys and values must be less than 512KB. + * A metadata key/value items map. + * The total size of all keys and values must be less than 512KB. * * Generated from protobuf field map items = 100526016; */ private $items; /** - * [Output Only] Type of the resource. Always compute#metadata for metadata. + * [Output Only] Type of the resource. Always compute#metadata + * for metadata. * * Generated from protobuf field optional string kind = 3292052; */ @@ -34,9 +36,11 @@ class InstanceSettingsMetadata extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type array|\Google\Protobuf\Internal\MapField $items - * A metadata key/value items map. The total size of all keys and values must be less than 512KB. + * A metadata key/value items map. + * The total size of all keys and values must be less than 512KB. * @type string $kind - * [Output Only] Type of the resource. Always compute#metadata for metadata. + * [Output Only] Type of the resource. Always compute#metadata + * for metadata. * } */ public function __construct($data = NULL) { @@ -45,7 +49,8 @@ public function __construct($data = NULL) { } /** - * A metadata key/value items map. The total size of all keys and values must be less than 512KB. + * A metadata key/value items map. + * The total size of all keys and values must be less than 512KB. * * Generated from protobuf field map items = 100526016; * @return \Google\Protobuf\Internal\MapField @@ -56,7 +61,8 @@ public function getItems() } /** - * A metadata key/value items map. The total size of all keys and values must be less than 512KB. + * A metadata key/value items map. + * The total size of all keys and values must be less than 512KB. * * Generated from protobuf field map items = 100526016; * @param array|\Google\Protobuf\Internal\MapField $var @@ -71,7 +77,8 @@ public function setItems($var) } /** - * [Output Only] Type of the resource. Always compute#metadata for metadata. + * [Output Only] Type of the resource. Always compute#metadata + * for metadata. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -92,7 +99,8 @@ public function clearKind() } /** - * [Output Only] Type of the resource. Always compute#metadata for metadata. + * [Output Only] Type of the resource. Always compute#metadata + * for metadata. * * Generated from protobuf field optional string kind = 3292052; * @param string $var diff --git a/Compute/src/V1/InstanceTemplate.php b/Compute/src/V1/InstanceTemplate.php index 217d68629d11..d6a7b62382e5 100644 --- a/Compute/src/V1/InstanceTemplate.php +++ b/Compute/src/V1/InstanceTemplate.php @@ -9,38 +9,57 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Represents an Instance Template resource. Google Compute Engine has two Instance Template resources: * [Global](/compute/docs/reference/rest/v1/instanceTemplates) * [Regional](/compute/docs/reference/rest/v1/regionInstanceTemplates) You can reuse a global instance template in different regions whereas you can use a regional instance template in a specified region only. If you want to reduce cross-region dependency or achieve data residency, use a regional instance template. To create VMs, managed instance groups, and reservations, you can use either global or regional instance templates. For more information, read Instance Templates. + * Represents an Instance Template resource. + * Google Compute Engine has two Instance Template resources: + * * [Global](/compute/docs/reference/rest/v1/instanceTemplates) + * * [Regional](/compute/docs/reference/rest/v1/regionInstanceTemplates) + * You can reuse a global instance template in + * different regions whereas you can use a regional instance template in a + * specified region only. If you want to reduce cross-region dependency or + * achieve data residency, use a regional instance template. + * To create VMs, managed instance groups, and reservations, you can use either + * global or regional instance templates. + * For more information, readInstance Templates. * * Generated from protobuf message google.cloud.compute.v1.InstanceTemplate */ class InstanceTemplate extends \Google\Protobuf\Internal\Message { /** - * [Output Only] The creation timestamp for this instance template in RFC3339 text format. + * [Output Only] The creation timestamp for this instance template inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; */ protected $creation_timestamp = null; /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; */ protected $description = null; /** - * [Output Only] A unique identifier for this instance template. The server defines this identifier. + * [Output Only] A unique identifier for this instance template. The server + * defines this identifier. * * Generated from protobuf field optional uint64 id = 3355; */ protected $id = null; /** - * [Output Only] The resource type, which is always compute#instanceTemplate for instance templates. + * [Output Only] The resource type, which is alwayscompute#instanceTemplate for instance templates. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * Name of the resource; provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource; provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must be + * a dash, lowercase letter, or digit, except the last character, which cannot + * be a dash. * * Generated from protobuf field optional string name = 3373707; */ @@ -52,19 +71,25 @@ class InstanceTemplate extends \Google\Protobuf\Internal\Message */ protected $properties = null; /** - * [Output Only] URL of the region where the instance template resides. Only applicable for regional resources. + * [Output Only] URL of the region where the instance template resides. Only + * applicable for regional resources. * * Generated from protobuf field optional string region = 138946292; */ protected $region = null; /** - * [Output Only] The URL for this instance template. The server defines this URL. + * [Output Only] The URL for this instance template. The server defines this + * URL. * * Generated from protobuf field optional string self_link = 456214797; */ protected $self_link = null; /** - * The source instance used to create the template. You can provide this as a partial or full URL to the resource. For example, the following are valid values: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /instances/instance - projects/project/zones/zone/instances/instance + * The source instance used to create the template. You can provide this as a + * partial or full URL to the resource. For example, the following are valid + * values: + * - https://www.googleapis.com/compute/v1/projects/project/zones/zone/instances/instance + * - projects/project/zones/zone/instances/instance * * Generated from protobuf field optional string source_instance = 396315705; */ @@ -83,23 +108,38 @@ class InstanceTemplate extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $creation_timestamp - * [Output Only] The creation timestamp for this instance template in RFC3339 text format. + * [Output Only] The creation timestamp for this instance template inRFC3339 + * text format. * @type string $description - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * @type int|string $id - * [Output Only] A unique identifier for this instance template. The server defines this identifier. + * [Output Only] A unique identifier for this instance template. The server + * defines this identifier. * @type string $kind - * [Output Only] The resource type, which is always compute#instanceTemplate for instance templates. + * [Output Only] The resource type, which is alwayscompute#instanceTemplate for instance templates. * @type string $name - * Name of the resource; provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource; provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must be + * a dash, lowercase letter, or digit, except the last character, which cannot + * be a dash. * @type \Google\Cloud\Compute\V1\InstanceProperties $properties * The instance properties for this instance template. * @type string $region - * [Output Only] URL of the region where the instance template resides. Only applicable for regional resources. + * [Output Only] URL of the region where the instance template resides. Only + * applicable for regional resources. * @type string $self_link - * [Output Only] The URL for this instance template. The server defines this URL. + * [Output Only] The URL for this instance template. The server defines this + * URL. * @type string $source_instance - * The source instance used to create the template. You can provide this as a partial or full URL to the resource. For example, the following are valid values: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /instances/instance - projects/project/zones/zone/instances/instance + * The source instance used to create the template. You can provide this as a + * partial or full URL to the resource. For example, the following are valid + * values: + * - https://www.googleapis.com/compute/v1/projects/project/zones/zone/instances/instance + * - projects/project/zones/zone/instances/instance * @type \Google\Cloud\Compute\V1\SourceInstanceParams $source_instance_params * The source instance params to use to create this instance template. * } @@ -110,7 +150,8 @@ public function __construct($data = NULL) { } /** - * [Output Only] The creation timestamp for this instance template in RFC3339 text format. + * [Output Only] The creation timestamp for this instance template inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @return string @@ -131,7 +172,8 @@ public function clearCreationTimestamp() } /** - * [Output Only] The creation timestamp for this instance template in RFC3339 text format. + * [Output Only] The creation timestamp for this instance template inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @param string $var @@ -146,7 +188,8 @@ public function setCreationTimestamp($var) } /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @return string @@ -167,7 +210,8 @@ public function clearDescription() } /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @param string $var @@ -182,7 +226,8 @@ public function setDescription($var) } /** - * [Output Only] A unique identifier for this instance template. The server defines this identifier. + * [Output Only] A unique identifier for this instance template. The server + * defines this identifier. * * Generated from protobuf field optional uint64 id = 3355; * @return int|string @@ -203,7 +248,8 @@ public function clearId() } /** - * [Output Only] A unique identifier for this instance template. The server defines this identifier. + * [Output Only] A unique identifier for this instance template. The server + * defines this identifier. * * Generated from protobuf field optional uint64 id = 3355; * @param int|string $var @@ -218,7 +264,7 @@ public function setId($var) } /** - * [Output Only] The resource type, which is always compute#instanceTemplate for instance templates. + * [Output Only] The resource type, which is alwayscompute#instanceTemplate for instance templates. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -239,7 +285,7 @@ public function clearKind() } /** - * [Output Only] The resource type, which is always compute#instanceTemplate for instance templates. + * [Output Only] The resource type, which is alwayscompute#instanceTemplate for instance templates. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -254,7 +300,13 @@ public function setKind($var) } /** - * Name of the resource; provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource; provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must be + * a dash, lowercase letter, or digit, except the last character, which cannot + * be a dash. * * Generated from protobuf field optional string name = 3373707; * @return string @@ -275,7 +327,13 @@ public function clearName() } /** - * Name of the resource; provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource; provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must be + * a dash, lowercase letter, or digit, except the last character, which cannot + * be a dash. * * Generated from protobuf field optional string name = 3373707; * @param string $var @@ -326,7 +384,8 @@ public function setProperties($var) } /** - * [Output Only] URL of the region where the instance template resides. Only applicable for regional resources. + * [Output Only] URL of the region where the instance template resides. Only + * applicable for regional resources. * * Generated from protobuf field optional string region = 138946292; * @return string @@ -347,7 +406,8 @@ public function clearRegion() } /** - * [Output Only] URL of the region where the instance template resides. Only applicable for regional resources. + * [Output Only] URL of the region where the instance template resides. Only + * applicable for regional resources. * * Generated from protobuf field optional string region = 138946292; * @param string $var @@ -362,7 +422,8 @@ public function setRegion($var) } /** - * [Output Only] The URL for this instance template. The server defines this URL. + * [Output Only] The URL for this instance template. The server defines this + * URL. * * Generated from protobuf field optional string self_link = 456214797; * @return string @@ -383,7 +444,8 @@ public function clearSelfLink() } /** - * [Output Only] The URL for this instance template. The server defines this URL. + * [Output Only] The URL for this instance template. The server defines this + * URL. * * Generated from protobuf field optional string self_link = 456214797; * @param string $var @@ -398,7 +460,11 @@ public function setSelfLink($var) } /** - * The source instance used to create the template. You can provide this as a partial or full URL to the resource. For example, the following are valid values: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /instances/instance - projects/project/zones/zone/instances/instance + * The source instance used to create the template. You can provide this as a + * partial or full URL to the resource. For example, the following are valid + * values: + * - https://www.googleapis.com/compute/v1/projects/project/zones/zone/instances/instance + * - projects/project/zones/zone/instances/instance * * Generated from protobuf field optional string source_instance = 396315705; * @return string @@ -419,7 +485,11 @@ public function clearSourceInstance() } /** - * The source instance used to create the template. You can provide this as a partial or full URL to the resource. For example, the following are valid values: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /instances/instance - projects/project/zones/zone/instances/instance + * The source instance used to create the template. You can provide this as a + * partial or full URL to the resource. For example, the following are valid + * values: + * - https://www.googleapis.com/compute/v1/projects/project/zones/zone/instances/instance + * - projects/project/zones/zone/instances/instance * * Generated from protobuf field optional string source_instance = 396315705; * @param string $var diff --git a/Compute/src/V1/InstanceTemplateAggregatedList.php b/Compute/src/V1/InstanceTemplateAggregatedList.php index bbbfb5b50cd6..83ef27a8db06 100644 --- a/Compute/src/V1/InstanceTemplateAggregatedList.php +++ b/Compute/src/V1/InstanceTemplateAggregatedList.php @@ -34,7 +34,11 @@ class InstanceTemplateAggregatedList extends \Google\Protobuf\Internal\Message */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -65,7 +69,11 @@ class InstanceTemplateAggregatedList extends \Google\Protobuf\Internal\Message * @type string $kind * Type of resource. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type \Google\Cloud\Compute\V1\Warning $warning @@ -176,7 +184,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -197,7 +209,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/InstanceTemplateList.php b/Compute/src/V1/InstanceTemplateList.php index 1a3a3290d408..2bb9c8b16773 100644 --- a/Compute/src/V1/InstanceTemplateList.php +++ b/Compute/src/V1/InstanceTemplateList.php @@ -28,13 +28,18 @@ class InstanceTemplateList extends \Google\Protobuf\Internal\Message */ private $items; /** - * [Output Only] The resource type, which is always compute#instanceTemplatesListResponse for instance template lists. + * [Output Only] The resource type, which is alwayscompute#instanceTemplatesListResponse for instance template + * lists. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -63,9 +68,14 @@ class InstanceTemplateList extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\InstanceTemplate>|\Google\Protobuf\Internal\RepeatedField $items * A list of InstanceTemplate resources. * @type string $kind - * [Output Only] The resource type, which is always compute#instanceTemplatesListResponse for instance template lists. + * [Output Only] The resource type, which is alwayscompute#instanceTemplatesListResponse for instance template + * lists. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type \Google\Cloud\Compute\V1\Warning $warning @@ -140,7 +150,8 @@ public function setItems($var) } /** - * [Output Only] The resource type, which is always compute#instanceTemplatesListResponse for instance template lists. + * [Output Only] The resource type, which is alwayscompute#instanceTemplatesListResponse for instance template + * lists. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -161,7 +172,8 @@ public function clearKind() } /** - * [Output Only] The resource type, which is always compute#instanceTemplatesListResponse for instance template lists. + * [Output Only] The resource type, which is alwayscompute#instanceTemplatesListResponse for instance template + * lists. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -176,7 +188,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -197,7 +213,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/InstanceTemplatesScopedList.php b/Compute/src/V1/InstanceTemplatesScopedList.php index 9132fac57213..6714bdfac1b7 100644 --- a/Compute/src/V1/InstanceTemplatesScopedList.php +++ b/Compute/src/V1/InstanceTemplatesScopedList.php @@ -15,13 +15,15 @@ class InstanceTemplatesScopedList extends \Google\Protobuf\Internal\Message { /** - * [Output Only] A list of instance templates that are contained within the specified project and zone. + * [Output Only] A list of instance templates that are contained within + * the specified project and zone. * * Generated from protobuf field repeated .google.cloud.compute.v1.InstanceTemplate instance_templates = 459889679; */ private $instance_templates; /** - * [Output Only] An informational warning that replaces the list of instance templates when the list is empty. + * [Output Only] An informational warning that replaces the list of instance + * templates when the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; */ @@ -34,9 +36,11 @@ class InstanceTemplatesScopedList extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type array<\Google\Cloud\Compute\V1\InstanceTemplate>|\Google\Protobuf\Internal\RepeatedField $instance_templates - * [Output Only] A list of instance templates that are contained within the specified project and zone. + * [Output Only] A list of instance templates that are contained within + * the specified project and zone. * @type \Google\Cloud\Compute\V1\Warning $warning - * [Output Only] An informational warning that replaces the list of instance templates when the list is empty. + * [Output Only] An informational warning that replaces the list of instance + * templates when the list is empty. * } */ public function __construct($data = NULL) { @@ -45,7 +49,8 @@ public function __construct($data = NULL) { } /** - * [Output Only] A list of instance templates that are contained within the specified project and zone. + * [Output Only] A list of instance templates that are contained within + * the specified project and zone. * * Generated from protobuf field repeated .google.cloud.compute.v1.InstanceTemplate instance_templates = 459889679; * @return \Google\Protobuf\Internal\RepeatedField @@ -56,7 +61,8 @@ public function getInstanceTemplates() } /** - * [Output Only] A list of instance templates that are contained within the specified project and zone. + * [Output Only] A list of instance templates that are contained within + * the specified project and zone. * * Generated from protobuf field repeated .google.cloud.compute.v1.InstanceTemplate instance_templates = 459889679; * @param array<\Google\Cloud\Compute\V1\InstanceTemplate>|\Google\Protobuf\Internal\RepeatedField $var @@ -71,7 +77,8 @@ public function setInstanceTemplates($var) } /** - * [Output Only] An informational warning that replaces the list of instance templates when the list is empty. + * [Output Only] An informational warning that replaces the list of instance + * templates when the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; * @return \Google\Cloud\Compute\V1\Warning|null @@ -92,7 +99,8 @@ public function clearWarning() } /** - * [Output Only] An informational warning that replaces the list of instance templates when the list is empty. + * [Output Only] An informational warning that replaces the list of instance + * templates when the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; * @param \Google\Cloud\Compute\V1\Warning $var diff --git a/Compute/src/V1/InstanceWithNamedPorts/Status.php b/Compute/src/V1/InstanceWithNamedPorts/Status.php index c5cf8721911e..07014c34561f 100644 --- a/Compute/src/V1/InstanceWithNamedPorts/Status.php +++ b/Compute/src/V1/InstanceWithNamedPorts/Status.php @@ -20,13 +20,15 @@ class Status */ const UNDEFINED_STATUS = 0; /** - * The instance is halted and we are performing tear down tasks like network deprogramming, releasing quota, IP, tearing down disks etc. + * The instance is halted and we are performing tear down tasks like network + * deprogramming, releasing quota, IP, tearing down disks etc. * * Generated from protobuf enum DEPROVISIONING = 428935662; */ const DEPROVISIONING = 428935662; /** - * For Flex Start provisioning instance is waiting for available capacity from Dynamic Workload Scheduler (DWS). + * For Flex Start provisioning instance is waiting for available capacity + * from Dynamic Workload Scheduler (DWS). * * Generated from protobuf enum PENDING = 35394935; */ @@ -50,7 +52,8 @@ class Status */ const RUNNING = 121282975; /** - * All required resources have been allocated and the instance is being started. + * All required resources have been allocated and the instance + * is being started. * * Generated from protobuf enum STAGING = 431072283; */ @@ -80,7 +83,8 @@ class Status */ const SUSPENDING = 514206246; /** - * The instance has stopped (either by explicit action or underlying failure). + * The instance has stopped (either by explicit action or underlying + * failure). * * Generated from protobuf enum TERMINATED = 250018339; */ diff --git a/Compute/src/V1/InstancesBulkInsertOperationMetadata.php b/Compute/src/V1/InstancesBulkInsertOperationMetadata.php index 9a6ed6446704..aae88bd25d97 100644 --- a/Compute/src/V1/InstancesBulkInsertOperationMetadata.php +++ b/Compute/src/V1/InstancesBulkInsertOperationMetadata.php @@ -15,7 +15,8 @@ class InstancesBulkInsertOperationMetadata extends \Google\Protobuf\Internal\Message { /** - * Status information per location (location name is key). Example key: zones/us-central1-a + * Status information per location (location name is key). + * Example key: zones/us-central1-a * * Generated from protobuf field map per_location_status = 167851162; */ @@ -28,7 +29,8 @@ class InstancesBulkInsertOperationMetadata extends \Google\Protobuf\Internal\Mes * Optional. Data for populating the Message object. * * @type array|\Google\Protobuf\Internal\MapField $per_location_status - * Status information per location (location name is key). Example key: zones/us-central1-a + * Status information per location (location name is key). + * Example key: zones/us-central1-a * } */ public function __construct($data = NULL) { @@ -37,7 +39,8 @@ public function __construct($data = NULL) { } /** - * Status information per location (location name is key). Example key: zones/us-central1-a + * Status information per location (location name is key). + * Example key: zones/us-central1-a * * Generated from protobuf field map per_location_status = 167851162; * @return \Google\Protobuf\Internal\MapField @@ -48,7 +51,8 @@ public function getPerLocationStatus() } /** - * Status information per location (location name is key). Example key: zones/us-central1-a + * Status information per location (location name is key). + * Example key: zones/us-central1-a * * Generated from protobuf field map per_location_status = 167851162; * @param array|\Google\Protobuf\Internal\MapField $var diff --git a/Compute/src/V1/InstancesGetEffectiveFirewallsResponseEffectiveFirewallPolicy.php b/Compute/src/V1/InstancesGetEffectiveFirewallsResponseEffectiveFirewallPolicy.php index 8c415d79bd23..bdead291996b 100644 --- a/Compute/src/V1/InstancesGetEffectiveFirewallsResponseEffectiveFirewallPolicy.php +++ b/Compute/src/V1/InstancesGetEffectiveFirewallsResponseEffectiveFirewallPolicy.php @@ -15,7 +15,8 @@ class InstancesGetEffectiveFirewallsResponseEffectiveFirewallPolicy extends \Google\Protobuf\Internal\Message { /** - * [Output Only] Deprecated, please use short name instead. The display name of the firewall policy. + * [Output Only] Deprecated, please use short name instead. The display name + * of the firewall policy. * * Generated from protobuf field optional string display_name = 4473832; */ @@ -33,13 +34,16 @@ class InstancesGetEffectiveFirewallsResponseEffectiveFirewallPolicy extends \Goo */ private $packet_mirroring_rules; /** - * [Output only] Priority of firewall policy association. Not applicable for type=HIERARCHY. + * [Output only] Priority of firewall policy association. Not applicable for + * type=HIERARCHY. * * Generated from protobuf field optional int32 priority = 445151652; */ protected $priority = null; /** - * [Output Only] The rules that apply to the instance. Only rules that target the specific VM instance are returned if target service accounts or target secure tags are specified in the rules. + * [Output Only] The rules that apply to the instance. Only rules that + * target the specific VM instance are returned if target service accounts + * or target secure tags are specified in the rules. * * Generated from protobuf field repeated .google.cloud.compute.v1.FirewallPolicyRule rules = 108873975; */ @@ -51,7 +55,8 @@ class InstancesGetEffectiveFirewallsResponseEffectiveFirewallPolicy extends \Goo */ protected $short_name = null; /** - * [Output Only] The type of the firewall policy. Can be one of HIERARCHY, NETWORK, NETWORK_REGIONAL, SYSTEM_GLOBAL, SYSTEM_REGIONAL. + * [Output Only] The type of the firewall policy. Can be one of HIERARCHY, + * NETWORK, NETWORK_REGIONAL, SYSTEM_GLOBAL, SYSTEM_REGIONAL. * Check the Type enum for the list of possible values. * * Generated from protobuf field optional string type = 3575610; @@ -65,19 +70,24 @@ class InstancesGetEffectiveFirewallsResponseEffectiveFirewallPolicy extends \Goo * Optional. Data for populating the Message object. * * @type string $display_name - * [Output Only] Deprecated, please use short name instead. The display name of the firewall policy. + * [Output Only] Deprecated, please use short name instead. The display name + * of the firewall policy. * @type string $name * [Output Only] The name of the firewall policy. * @type array<\Google\Cloud\Compute\V1\FirewallPolicyRule>|\Google\Protobuf\Internal\RepeatedField $packet_mirroring_rules * [Output Only] The packet mirroring rules that apply to the instance. * @type int $priority - * [Output only] Priority of firewall policy association. Not applicable for type=HIERARCHY. + * [Output only] Priority of firewall policy association. Not applicable for + * type=HIERARCHY. * @type array<\Google\Cloud\Compute\V1\FirewallPolicyRule>|\Google\Protobuf\Internal\RepeatedField $rules - * [Output Only] The rules that apply to the instance. Only rules that target the specific VM instance are returned if target service accounts or target secure tags are specified in the rules. + * [Output Only] The rules that apply to the instance. Only rules that + * target the specific VM instance are returned if target service accounts + * or target secure tags are specified in the rules. * @type string $short_name * [Output Only] The short name of the firewall policy. * @type string $type - * [Output Only] The type of the firewall policy. Can be one of HIERARCHY, NETWORK, NETWORK_REGIONAL, SYSTEM_GLOBAL, SYSTEM_REGIONAL. + * [Output Only] The type of the firewall policy. Can be one of HIERARCHY, + * NETWORK, NETWORK_REGIONAL, SYSTEM_GLOBAL, SYSTEM_REGIONAL. * Check the Type enum for the list of possible values. * } */ @@ -87,7 +97,8 @@ public function __construct($data = NULL) { } /** - * [Output Only] Deprecated, please use short name instead. The display name of the firewall policy. + * [Output Only] Deprecated, please use short name instead. The display name + * of the firewall policy. * * Generated from protobuf field optional string display_name = 4473832; * @return string @@ -108,7 +119,8 @@ public function clearDisplayName() } /** - * [Output Only] Deprecated, please use short name instead. The display name of the firewall policy. + * [Output Only] Deprecated, please use short name instead. The display name + * of the firewall policy. * * Generated from protobuf field optional string display_name = 4473832; * @param string $var @@ -185,7 +197,8 @@ public function setPacketMirroringRules($var) } /** - * [Output only] Priority of firewall policy association. Not applicable for type=HIERARCHY. + * [Output only] Priority of firewall policy association. Not applicable for + * type=HIERARCHY. * * Generated from protobuf field optional int32 priority = 445151652; * @return int @@ -206,7 +219,8 @@ public function clearPriority() } /** - * [Output only] Priority of firewall policy association. Not applicable for type=HIERARCHY. + * [Output only] Priority of firewall policy association. Not applicable for + * type=HIERARCHY. * * Generated from protobuf field optional int32 priority = 445151652; * @param int $var @@ -221,7 +235,9 @@ public function setPriority($var) } /** - * [Output Only] The rules that apply to the instance. Only rules that target the specific VM instance are returned if target service accounts or target secure tags are specified in the rules. + * [Output Only] The rules that apply to the instance. Only rules that + * target the specific VM instance are returned if target service accounts + * or target secure tags are specified in the rules. * * Generated from protobuf field repeated .google.cloud.compute.v1.FirewallPolicyRule rules = 108873975; * @return \Google\Protobuf\Internal\RepeatedField @@ -232,7 +248,9 @@ public function getRules() } /** - * [Output Only] The rules that apply to the instance. Only rules that target the specific VM instance are returned if target service accounts or target secure tags are specified in the rules. + * [Output Only] The rules that apply to the instance. Only rules that + * target the specific VM instance are returned if target service accounts + * or target secure tags are specified in the rules. * * Generated from protobuf field repeated .google.cloud.compute.v1.FirewallPolicyRule rules = 108873975; * @param array<\Google\Cloud\Compute\V1\FirewallPolicyRule>|\Google\Protobuf\Internal\RepeatedField $var @@ -283,7 +301,8 @@ public function setShortName($var) } /** - * [Output Only] The type of the firewall policy. Can be one of HIERARCHY, NETWORK, NETWORK_REGIONAL, SYSTEM_GLOBAL, SYSTEM_REGIONAL. + * [Output Only] The type of the firewall policy. Can be one of HIERARCHY, + * NETWORK, NETWORK_REGIONAL, SYSTEM_GLOBAL, SYSTEM_REGIONAL. * Check the Type enum for the list of possible values. * * Generated from protobuf field optional string type = 3575610; @@ -305,7 +324,8 @@ public function clearType() } /** - * [Output Only] The type of the firewall policy. Can be one of HIERARCHY, NETWORK, NETWORK_REGIONAL, SYSTEM_GLOBAL, SYSTEM_REGIONAL. + * [Output Only] The type of the firewall policy. Can be one of HIERARCHY, + * NETWORK, NETWORK_REGIONAL, SYSTEM_GLOBAL, SYSTEM_REGIONAL. * Check the Type enum for the list of possible values. * * Generated from protobuf field optional string type = 3575610; diff --git a/Compute/src/V1/InstancesGetEffectiveFirewallsResponseEffectiveFirewallPolicy/Type.php b/Compute/src/V1/InstancesGetEffectiveFirewallsResponseEffectiveFirewallPolicy/Type.php index 166ce64cb02b..fe08b17c8cb8 100644 --- a/Compute/src/V1/InstancesGetEffectiveFirewallsResponseEffectiveFirewallPolicy/Type.php +++ b/Compute/src/V1/InstancesGetEffectiveFirewallsResponseEffectiveFirewallPolicy/Type.php @@ -7,7 +7,8 @@ use UnexpectedValueException; /** - * [Output Only] The type of the firewall policy. Can be one of HIERARCHY, NETWORK, NETWORK_REGIONAL, SYSTEM_GLOBAL, SYSTEM_REGIONAL. + * [Output Only] The type of the firewall policy. Can be one of HIERARCHY, + * NETWORK, NETWORK_REGIONAL, SYSTEM_GLOBAL, SYSTEM_REGIONAL. * * Protobuf type google.cloud.compute.v1.InstancesGetEffectiveFirewallsResponseEffectiveFirewallPolicy.Type */ diff --git a/Compute/src/V1/InstancesScopedList.php b/Compute/src/V1/InstancesScopedList.php index a2f5a40b3883..86b33b2cb665 100644 --- a/Compute/src/V1/InstancesScopedList.php +++ b/Compute/src/V1/InstancesScopedList.php @@ -21,7 +21,8 @@ class InstancesScopedList extends \Google\Protobuf\Internal\Message */ private $instances; /** - * [Output Only] Informational warning which replaces the list of instances when the list is empty. + * [Output Only] Informational warning which replaces the list of instances + * when the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; */ @@ -36,7 +37,8 @@ class InstancesScopedList extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\Instance>|\Google\Protobuf\Internal\RepeatedField $instances * [Output Only] A list of instances contained in this scope. * @type \Google\Cloud\Compute\V1\Warning $warning - * [Output Only] Informational warning which replaces the list of instances when the list is empty. + * [Output Only] Informational warning which replaces the list of instances + * when the list is empty. * } */ public function __construct($data = NULL) { @@ -71,7 +73,8 @@ public function setInstances($var) } /** - * [Output Only] Informational warning which replaces the list of instances when the list is empty. + * [Output Only] Informational warning which replaces the list of instances + * when the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; * @return \Google\Cloud\Compute\V1\Warning|null @@ -92,7 +95,8 @@ public function clearWarning() } /** - * [Output Only] Informational warning which replaces the list of instances when the list is empty. + * [Output Only] Informational warning which replaces the list of instances + * when the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; * @param \Google\Cloud\Compute\V1\Warning $var diff --git a/Compute/src/V1/InstancesSetLabelsRequest.php b/Compute/src/V1/InstancesSetLabelsRequest.php index a5234e76d34c..798fe7d18b8e 100644 --- a/Compute/src/V1/InstancesSetLabelsRequest.php +++ b/Compute/src/V1/InstancesSetLabelsRequest.php @@ -15,7 +15,9 @@ class InstancesSetLabelsRequest extends \Google\Protobuf\Internal\Message { /** - * Fingerprint of the previous set of labels for this resource, used to prevent conflicts. Provide the latest fingerprint value when making a request to add or change labels. + * Fingerprint of the previous set of labels for this resource, + * used to prevent conflicts. Provide the latest fingerprint value when making + * a request to add or change labels. * * Generated from protobuf field optional string label_fingerprint = 178124825; */ @@ -32,7 +34,9 @@ class InstancesSetLabelsRequest extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $label_fingerprint - * Fingerprint of the previous set of labels for this resource, used to prevent conflicts. Provide the latest fingerprint value when making a request to add or change labels. + * Fingerprint of the previous set of labels for this resource, + * used to prevent conflicts. Provide the latest fingerprint value when making + * a request to add or change labels. * @type array|\Google\Protobuf\Internal\MapField $labels * } */ @@ -42,7 +46,9 @@ public function __construct($data = NULL) { } /** - * Fingerprint of the previous set of labels for this resource, used to prevent conflicts. Provide the latest fingerprint value when making a request to add or change labels. + * Fingerprint of the previous set of labels for this resource, + * used to prevent conflicts. Provide the latest fingerprint value when making + * a request to add or change labels. * * Generated from protobuf field optional string label_fingerprint = 178124825; * @return string @@ -63,7 +69,9 @@ public function clearLabelFingerprint() } /** - * Fingerprint of the previous set of labels for this resource, used to prevent conflicts. Provide the latest fingerprint value when making a request to add or change labels. + * Fingerprint of the previous set of labels for this resource, + * used to prevent conflicts. Provide the latest fingerprint value when making + * a request to add or change labels. * * Generated from protobuf field optional string label_fingerprint = 178124825; * @param string $var diff --git a/Compute/src/V1/InstancesSetMachineTypeRequest.php b/Compute/src/V1/InstancesSetMachineTypeRequest.php index 2822a3c93e1a..eb037d14c0b8 100644 --- a/Compute/src/V1/InstancesSetMachineTypeRequest.php +++ b/Compute/src/V1/InstancesSetMachineTypeRequest.php @@ -15,7 +15,8 @@ class InstancesSetMachineTypeRequest extends \Google\Protobuf\Internal\Message { /** - * Full or partial URL of the machine type resource. See Machine Types for a full list of machine types. For example: zones/us-central1-f/machineTypes/n1-standard-1 + * Full or partial URL of the machine type resource. See Machine Types for a full list of + * machine types. For example:zones/us-central1-f/machineTypes/n1-standard-1 * * Generated from protobuf field optional string machine_type = 227711026; */ @@ -28,7 +29,8 @@ class InstancesSetMachineTypeRequest extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $machine_type - * Full or partial URL of the machine type resource. See Machine Types for a full list of machine types. For example: zones/us-central1-f/machineTypes/n1-standard-1 + * Full or partial URL of the machine type resource. See Machine Types for a full list of + * machine types. For example:zones/us-central1-f/machineTypes/n1-standard-1 * } */ public function __construct($data = NULL) { @@ -37,7 +39,8 @@ public function __construct($data = NULL) { } /** - * Full or partial URL of the machine type resource. See Machine Types for a full list of machine types. For example: zones/us-central1-f/machineTypes/n1-standard-1 + * Full or partial URL of the machine type resource. See Machine Types for a full list of + * machine types. For example:zones/us-central1-f/machineTypes/n1-standard-1 * * Generated from protobuf field optional string machine_type = 227711026; * @return string @@ -58,7 +61,8 @@ public function clearMachineType() } /** - * Full or partial URL of the machine type resource. See Machine Types for a full list of machine types. For example: zones/us-central1-f/machineTypes/n1-standard-1 + * Full or partial URL of the machine type resource. See Machine Types for a full list of + * machine types. For example:zones/us-central1-f/machineTypes/n1-standard-1 * * Generated from protobuf field optional string machine_type = 227711026; * @param string $var diff --git a/Compute/src/V1/InstancesSetNameRequest.php b/Compute/src/V1/InstancesSetNameRequest.php index 01ab2162aac7..19d002a1c9bd 100644 --- a/Compute/src/V1/InstancesSetNameRequest.php +++ b/Compute/src/V1/InstancesSetNameRequest.php @@ -15,7 +15,8 @@ class InstancesSetNameRequest extends \Google\Protobuf\Internal\Message { /** - * The current name of this resource, used to prevent conflicts. Provide the latest name when making a request to change name. + * The current name of this resource, used to prevent conflicts. Provide the + * latest name when making a request to change name. * * Generated from protobuf field optional string current_name = 394983825; */ @@ -34,7 +35,8 @@ class InstancesSetNameRequest extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $current_name - * The current name of this resource, used to prevent conflicts. Provide the latest name when making a request to change name. + * The current name of this resource, used to prevent conflicts. Provide the + * latest name when making a request to change name. * @type string $name * The name to be applied to the instance. Needs to be RFC 1035 compliant. * } @@ -45,7 +47,8 @@ public function __construct($data = NULL) { } /** - * The current name of this resource, used to prevent conflicts. Provide the latest name when making a request to change name. + * The current name of this resource, used to prevent conflicts. Provide the + * latest name when making a request to change name. * * Generated from protobuf field optional string current_name = 394983825; * @return string @@ -66,7 +69,8 @@ public function clearCurrentName() } /** - * The current name of this resource, used to prevent conflicts. Provide the latest name when making a request to change name. + * The current name of this resource, used to prevent conflicts. Provide the + * latest name when making a request to change name. * * Generated from protobuf field optional string current_name = 394983825; * @param string $var diff --git a/Compute/src/V1/InstancesSetSecurityPolicyRequest.php b/Compute/src/V1/InstancesSetSecurityPolicyRequest.php index 0b5d5059a2cd..aa85f3267f3f 100644 --- a/Compute/src/V1/InstancesSetSecurityPolicyRequest.php +++ b/Compute/src/V1/InstancesSetSecurityPolicyRequest.php @@ -15,13 +15,17 @@ class InstancesSetSecurityPolicyRequest extends \Google\Protobuf\Internal\Message { /** - * The network interfaces that the security policy will be applied to. Network interfaces use the nicN naming format. You can only set a security policy for network interfaces with an access config. + * The network interfaces that the security policy will be applied to. Network + * interfaces use the nicN naming format. You can only set a + * security policy for network interfaces with an access config. * * Generated from protobuf field repeated string network_interfaces = 52735243; */ private $network_interfaces; /** - * A full or partial URL to a security policy to add to this instance. If this field is set to an empty string it will remove the associated security policy. + * A full or partial URL to a security policy to add to this instance. + * If this field is set to an empty string it will remove the associated + * security policy. * * Generated from protobuf field optional string security_policy = 171082513; */ @@ -34,9 +38,13 @@ class InstancesSetSecurityPolicyRequest extends \Google\Protobuf\Internal\Messag * Optional. Data for populating the Message object. * * @type array|\Google\Protobuf\Internal\RepeatedField $network_interfaces - * The network interfaces that the security policy will be applied to. Network interfaces use the nicN naming format. You can only set a security policy for network interfaces with an access config. + * The network interfaces that the security policy will be applied to. Network + * interfaces use the nicN naming format. You can only set a + * security policy for network interfaces with an access config. * @type string $security_policy - * A full or partial URL to a security policy to add to this instance. If this field is set to an empty string it will remove the associated security policy. + * A full or partial URL to a security policy to add to this instance. + * If this field is set to an empty string it will remove the associated + * security policy. * } */ public function __construct($data = NULL) { @@ -45,7 +53,9 @@ public function __construct($data = NULL) { } /** - * The network interfaces that the security policy will be applied to. Network interfaces use the nicN naming format. You can only set a security policy for network interfaces with an access config. + * The network interfaces that the security policy will be applied to. Network + * interfaces use the nicN naming format. You can only set a + * security policy for network interfaces with an access config. * * Generated from protobuf field repeated string network_interfaces = 52735243; * @return \Google\Protobuf\Internal\RepeatedField @@ -56,7 +66,9 @@ public function getNetworkInterfaces() } /** - * The network interfaces that the security policy will be applied to. Network interfaces use the nicN naming format. You can only set a security policy for network interfaces with an access config. + * The network interfaces that the security policy will be applied to. Network + * interfaces use the nicN naming format. You can only set a + * security policy for network interfaces with an access config. * * Generated from protobuf field repeated string network_interfaces = 52735243; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -71,7 +83,9 @@ public function setNetworkInterfaces($var) } /** - * A full or partial URL to a security policy to add to this instance. If this field is set to an empty string it will remove the associated security policy. + * A full or partial URL to a security policy to add to this instance. + * If this field is set to an empty string it will remove the associated + * security policy. * * Generated from protobuf field optional string security_policy = 171082513; * @return string @@ -92,7 +106,9 @@ public function clearSecurityPolicy() } /** - * A full or partial URL to a security policy to add to this instance. If this field is set to an empty string it will remove the associated security policy. + * A full or partial URL to a security policy to add to this instance. + * If this field is set to an empty string it will remove the associated + * security policy. * * Generated from protobuf field optional string security_policy = 171082513; * @param string $var diff --git a/Compute/src/V1/InstancesStartWithEncryptionKeyRequest.php b/Compute/src/V1/InstancesStartWithEncryptionKeyRequest.php index c4d11b251c8e..71f674fddde4 100644 --- a/Compute/src/V1/InstancesStartWithEncryptionKeyRequest.php +++ b/Compute/src/V1/InstancesStartWithEncryptionKeyRequest.php @@ -15,7 +15,12 @@ class InstancesStartWithEncryptionKeyRequest extends \Google\Protobuf\Internal\Message { /** - * Array of disks associated with this instance that are protected with a customer-supplied encryption key. In order to start the instance, the disk url and its corresponding key must be provided. If the disk is not protected with a customer-supplied encryption key it should not be specified. + * Array of disks associated with this instance that are protected with acustomer-supplied + * encryption key. + * In order to start the instance, the disk url and its corresponding key must + * be provided. + * If the disk is not protected with a customer-supplied encryption key it + * should not be specified. * * Generated from protobuf field repeated .google.cloud.compute.v1.CustomerEncryptionKeyProtectedDisk disks = 95594102; */ @@ -28,7 +33,12 @@ class InstancesStartWithEncryptionKeyRequest extends \Google\Protobuf\Internal\M * Optional. Data for populating the Message object. * * @type array<\Google\Cloud\Compute\V1\CustomerEncryptionKeyProtectedDisk>|\Google\Protobuf\Internal\RepeatedField $disks - * Array of disks associated with this instance that are protected with a customer-supplied encryption key. In order to start the instance, the disk url and its corresponding key must be provided. If the disk is not protected with a customer-supplied encryption key it should not be specified. + * Array of disks associated with this instance that are protected with acustomer-supplied + * encryption key. + * In order to start the instance, the disk url and its corresponding key must + * be provided. + * If the disk is not protected with a customer-supplied encryption key it + * should not be specified. * } */ public function __construct($data = NULL) { @@ -37,7 +47,12 @@ public function __construct($data = NULL) { } /** - * Array of disks associated with this instance that are protected with a customer-supplied encryption key. In order to start the instance, the disk url and its corresponding key must be provided. If the disk is not protected with a customer-supplied encryption key it should not be specified. + * Array of disks associated with this instance that are protected with acustomer-supplied + * encryption key. + * In order to start the instance, the disk url and its corresponding key must + * be provided. + * If the disk is not protected with a customer-supplied encryption key it + * should not be specified. * * Generated from protobuf field repeated .google.cloud.compute.v1.CustomerEncryptionKeyProtectedDisk disks = 95594102; * @return \Google\Protobuf\Internal\RepeatedField @@ -48,7 +63,12 @@ public function getDisks() } /** - * Array of disks associated with this instance that are protected with a customer-supplied encryption key. In order to start the instance, the disk url and its corresponding key must be provided. If the disk is not protected with a customer-supplied encryption key it should not be specified. + * Array of disks associated with this instance that are protected with acustomer-supplied + * encryption key. + * In order to start the instance, the disk url and its corresponding key must + * be provided. + * If the disk is not protected with a customer-supplied encryption key it + * should not be specified. * * Generated from protobuf field repeated .google.cloud.compute.v1.CustomerEncryptionKeyProtectedDisk disks = 95594102; * @param array<\Google\Cloud\Compute\V1\CustomerEncryptionKeyProtectedDisk>|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/InstantSnapshot.php b/Compute/src/V1/InstantSnapshot.php index 97f6d89a6024..95d81265fe1c 100644 --- a/Compute/src/V1/InstantSnapshot.php +++ b/Compute/src/V1/InstantSnapshot.php @@ -9,27 +9,31 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Represents a InstantSnapshot resource. You can use instant snapshots to create disk rollback points quickly.. + * Represents a InstantSnapshot resource. + * You can use instant snapshots to create disk rollback points quickly.. * * Generated from protobuf message google.cloud.compute.v1.InstantSnapshot */ class InstantSnapshot extends \Google\Protobuf\Internal\Message { /** - * [Output Only] The architecture of the instant snapshot. Valid values are ARM64 or X86_64. + * [Output Only] The architecture of the instant snapshot. Valid values are + * ARM64 or X86_64. * Check the Architecture enum for the list of possible values. * * Generated from protobuf field optional string architecture = 302803283; */ protected $architecture = null; /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; */ protected $creation_timestamp = null; /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; */ @@ -41,37 +45,55 @@ class InstantSnapshot extends \Google\Protobuf\Internal\Message */ protected $disk_size_gb = null; /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; */ protected $id = null; /** - * [Output Only] Type of the resource. Always compute#instantSnapshot for InstantSnapshot resources. + * [Output Only] Type of the resource. Alwayscompute#instantSnapshot for InstantSnapshot resources. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * A fingerprint for the labels being applied to this InstantSnapshot, which is essentially a hash of the labels set used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a InstantSnapshot. + * A fingerprint for the labels being applied to this InstantSnapshot, which + * is essentially a hash of the labels set used for optimistic locking. The + * fingerprint is initially generated by Compute Engine and changes after + * every request to modify or update labels. You must always provide an + * up-to-date fingerprint hash in order to update or change labels, + * otherwise the request will fail with error412 conditionNotMet. + * To see the latest fingerprint, make a get() request to + * retrieve a InstantSnapshot. * * Generated from protobuf field optional string label_fingerprint = 178124825; */ protected $label_fingerprint = null; /** - * Labels to apply to this InstantSnapshot. These can be later modified by the setLabels method. Label values may be empty. + * Labels to apply to this InstantSnapshot. These can be later modified by + * the setLabels method. + * Label values may be empty. * * Generated from protobuf field map labels = 500195327; */ private $labels; /** - * Name of the resource; provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource; provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must be + * a dash, lowercase letter, or digit, except the last character, which cannot + * be a dash. * * Generated from protobuf field optional string name = 3373707; */ protected $name = null; /** - * [Output Only] URL of the region where the instant snapshot resides. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * [Output Only] URL of the region where the instant snapshot resides. + * You must specify this field as part of the HTTP request URL. It is + * not settable as a field in the request body. * * Generated from protobuf field optional string region = 138946292; */ @@ -107,26 +129,45 @@ class InstantSnapshot extends \Google\Protobuf\Internal\Message */ protected $self_link_with_id = null; /** - * URL of the source disk used to create this instant snapshot. Note that the source disk must be in the same zone/region as the instant snapshot to be created. This can be a full or valid partial URL. For example, the following are valid values: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /disks/disk - https://www.googleapis.com/compute/v1/projects/project/regions/region /disks/disk - projects/project/zones/zone/disks/disk - projects/project/regions/region/disks/disk - zones/zone/disks/disk - regions/region/disks/disk + * URL of the source disk used to create this instant snapshot. + * Note that the source disk must be in the same zone/region as the + * instant snapshot to be created. This can be a full or valid partial URL. + * For example, the following are valid values: + * - + * https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk + * - + * https://www.googleapis.com/compute/v1/projects/project/regions/region/disks/disk + * - + * projects/project/zones/zone/disks/disk + * - + * projects/project/regions/region/disks/disk + * - + * zones/zone/disks/disk + * - + * regions/region/disks/disk * * Generated from protobuf field optional string source_disk = 451753793; */ protected $source_disk = null; /** - * [Output Only] The ID value of the disk used to create this InstantSnapshot. This value may be used to determine whether the InstantSnapshot was taken from the current or a previous instance of a given disk name. + * [Output Only] The ID value of the disk used to create this InstantSnapshot. + * This value may be used to determine whether the InstantSnapshot + * was taken from the current or a previous instance of a given disk name. * * Generated from protobuf field optional string source_disk_id = 454190809; */ protected $source_disk_id = null; /** - * [Output Only] The status of the instantSnapshot. This can be CREATING, DELETING, FAILED, or READY. + * [Output Only] The status of the instantSnapshot. This can beCREATING, DELETING, FAILED, orREADY. * Check the Status enum for the list of possible values. * * Generated from protobuf field optional string status = 181260274; */ protected $status = null; /** - * [Output Only] URL of the zone where the instant snapshot resides. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * [Output Only] URL of the zone where the instant snapshot resides. + * You must specify this field as part of the HTTP request URL. It is + * not settable as a field in the request body. * * Generated from protobuf field optional string zone = 3744684; */ @@ -139,26 +180,47 @@ class InstantSnapshot extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $architecture - * [Output Only] The architecture of the instant snapshot. Valid values are ARM64 or X86_64. + * [Output Only] The architecture of the instant snapshot. Valid values are + * ARM64 or X86_64. * Check the Architecture enum for the list of possible values. * @type string $creation_timestamp - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * @type string $description - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * @type int|string $disk_size_gb * [Output Only] Size of the source disk, specified in GB. * @type int|string $id - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * @type string $kind - * [Output Only] Type of the resource. Always compute#instantSnapshot for InstantSnapshot resources. + * [Output Only] Type of the resource. Alwayscompute#instantSnapshot for InstantSnapshot resources. * @type string $label_fingerprint - * A fingerprint for the labels being applied to this InstantSnapshot, which is essentially a hash of the labels set used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a InstantSnapshot. + * A fingerprint for the labels being applied to this InstantSnapshot, which + * is essentially a hash of the labels set used for optimistic locking. The + * fingerprint is initially generated by Compute Engine and changes after + * every request to modify or update labels. You must always provide an + * up-to-date fingerprint hash in order to update or change labels, + * otherwise the request will fail with error412 conditionNotMet. + * To see the latest fingerprint, make a get() request to + * retrieve a InstantSnapshot. * @type array|\Google\Protobuf\Internal\MapField $labels - * Labels to apply to this InstantSnapshot. These can be later modified by the setLabels method. Label values may be empty. + * Labels to apply to this InstantSnapshot. These can be later modified by + * the setLabels method. + * Label values may be empty. * @type string $name - * Name of the resource; provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource; provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must be + * a dash, lowercase letter, or digit, except the last character, which cannot + * be a dash. * @type string $region - * [Output Only] URL of the region where the instant snapshot resides. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * [Output Only] URL of the region where the instant snapshot resides. + * You must specify this field as part of the HTTP request URL. It is + * not settable as a field in the request body. * @type \Google\Cloud\Compute\V1\InstantSnapshotResourceStatus $resource_status * [Output Only] Status information for the instant snapshot resource. * @type bool $satisfies_pzi @@ -170,14 +232,33 @@ class InstantSnapshot extends \Google\Protobuf\Internal\Message * @type string $self_link_with_id * [Output Only] Server-defined URL for this resource's resource id. * @type string $source_disk - * URL of the source disk used to create this instant snapshot. Note that the source disk must be in the same zone/region as the instant snapshot to be created. This can be a full or valid partial URL. For example, the following are valid values: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /disks/disk - https://www.googleapis.com/compute/v1/projects/project/regions/region /disks/disk - projects/project/zones/zone/disks/disk - projects/project/regions/region/disks/disk - zones/zone/disks/disk - regions/region/disks/disk + * URL of the source disk used to create this instant snapshot. + * Note that the source disk must be in the same zone/region as the + * instant snapshot to be created. This can be a full or valid partial URL. + * For example, the following are valid values: + * - + * https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk + * - + * https://www.googleapis.com/compute/v1/projects/project/regions/region/disks/disk + * - + * projects/project/zones/zone/disks/disk + * - + * projects/project/regions/region/disks/disk + * - + * zones/zone/disks/disk + * - + * regions/region/disks/disk * @type string $source_disk_id - * [Output Only] The ID value of the disk used to create this InstantSnapshot. This value may be used to determine whether the InstantSnapshot was taken from the current or a previous instance of a given disk name. + * [Output Only] The ID value of the disk used to create this InstantSnapshot. + * This value may be used to determine whether the InstantSnapshot + * was taken from the current or a previous instance of a given disk name. * @type string $status - * [Output Only] The status of the instantSnapshot. This can be CREATING, DELETING, FAILED, or READY. + * [Output Only] The status of the instantSnapshot. This can beCREATING, DELETING, FAILED, orREADY. * Check the Status enum for the list of possible values. * @type string $zone - * [Output Only] URL of the zone where the instant snapshot resides. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * [Output Only] URL of the zone where the instant snapshot resides. + * You must specify this field as part of the HTTP request URL. It is + * not settable as a field in the request body. * } */ public function __construct($data = NULL) { @@ -186,7 +267,8 @@ public function __construct($data = NULL) { } /** - * [Output Only] The architecture of the instant snapshot. Valid values are ARM64 or X86_64. + * [Output Only] The architecture of the instant snapshot. Valid values are + * ARM64 or X86_64. * Check the Architecture enum for the list of possible values. * * Generated from protobuf field optional string architecture = 302803283; @@ -208,7 +290,8 @@ public function clearArchitecture() } /** - * [Output Only] The architecture of the instant snapshot. Valid values are ARM64 or X86_64. + * [Output Only] The architecture of the instant snapshot. Valid values are + * ARM64 or X86_64. * Check the Architecture enum for the list of possible values. * * Generated from protobuf field optional string architecture = 302803283; @@ -224,7 +307,8 @@ public function setArchitecture($var) } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @return string @@ -245,7 +329,8 @@ public function clearCreationTimestamp() } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @param string $var @@ -260,7 +345,8 @@ public function setCreationTimestamp($var) } /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @return string @@ -281,7 +367,8 @@ public function clearDescription() } /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @param string $var @@ -332,7 +419,8 @@ public function setDiskSizeGb($var) } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @return int|string @@ -353,7 +441,8 @@ public function clearId() } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @param int|string $var @@ -368,7 +457,7 @@ public function setId($var) } /** - * [Output Only] Type of the resource. Always compute#instantSnapshot for InstantSnapshot resources. + * [Output Only] Type of the resource. Alwayscompute#instantSnapshot for InstantSnapshot resources. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -389,7 +478,7 @@ public function clearKind() } /** - * [Output Only] Type of the resource. Always compute#instantSnapshot for InstantSnapshot resources. + * [Output Only] Type of the resource. Alwayscompute#instantSnapshot for InstantSnapshot resources. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -404,7 +493,14 @@ public function setKind($var) } /** - * A fingerprint for the labels being applied to this InstantSnapshot, which is essentially a hash of the labels set used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a InstantSnapshot. + * A fingerprint for the labels being applied to this InstantSnapshot, which + * is essentially a hash of the labels set used for optimistic locking. The + * fingerprint is initially generated by Compute Engine and changes after + * every request to modify or update labels. You must always provide an + * up-to-date fingerprint hash in order to update or change labels, + * otherwise the request will fail with error412 conditionNotMet. + * To see the latest fingerprint, make a get() request to + * retrieve a InstantSnapshot. * * Generated from protobuf field optional string label_fingerprint = 178124825; * @return string @@ -425,7 +521,14 @@ public function clearLabelFingerprint() } /** - * A fingerprint for the labels being applied to this InstantSnapshot, which is essentially a hash of the labels set used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a InstantSnapshot. + * A fingerprint for the labels being applied to this InstantSnapshot, which + * is essentially a hash of the labels set used for optimistic locking. The + * fingerprint is initially generated by Compute Engine and changes after + * every request to modify or update labels. You must always provide an + * up-to-date fingerprint hash in order to update or change labels, + * otherwise the request will fail with error412 conditionNotMet. + * To see the latest fingerprint, make a get() request to + * retrieve a InstantSnapshot. * * Generated from protobuf field optional string label_fingerprint = 178124825; * @param string $var @@ -440,7 +543,9 @@ public function setLabelFingerprint($var) } /** - * Labels to apply to this InstantSnapshot. These can be later modified by the setLabels method. Label values may be empty. + * Labels to apply to this InstantSnapshot. These can be later modified by + * the setLabels method. + * Label values may be empty. * * Generated from protobuf field map labels = 500195327; * @return \Google\Protobuf\Internal\MapField @@ -451,7 +556,9 @@ public function getLabels() } /** - * Labels to apply to this InstantSnapshot. These can be later modified by the setLabels method. Label values may be empty. + * Labels to apply to this InstantSnapshot. These can be later modified by + * the setLabels method. + * Label values may be empty. * * Generated from protobuf field map labels = 500195327; * @param array|\Google\Protobuf\Internal\MapField $var @@ -466,7 +573,13 @@ public function setLabels($var) } /** - * Name of the resource; provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource; provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must be + * a dash, lowercase letter, or digit, except the last character, which cannot + * be a dash. * * Generated from protobuf field optional string name = 3373707; * @return string @@ -487,7 +600,13 @@ public function clearName() } /** - * Name of the resource; provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource; provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must be + * a dash, lowercase letter, or digit, except the last character, which cannot + * be a dash. * * Generated from protobuf field optional string name = 3373707; * @param string $var @@ -502,7 +621,9 @@ public function setName($var) } /** - * [Output Only] URL of the region where the instant snapshot resides. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * [Output Only] URL of the region where the instant snapshot resides. + * You must specify this field as part of the HTTP request URL. It is + * not settable as a field in the request body. * * Generated from protobuf field optional string region = 138946292; * @return string @@ -523,7 +644,9 @@ public function clearRegion() } /** - * [Output Only] URL of the region where the instant snapshot resides. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * [Output Only] URL of the region where the instant snapshot resides. + * You must specify this field as part of the HTTP request URL. It is + * not settable as a field in the request body. * * Generated from protobuf field optional string region = 138946292; * @param string $var @@ -718,7 +841,22 @@ public function setSelfLinkWithId($var) } /** - * URL of the source disk used to create this instant snapshot. Note that the source disk must be in the same zone/region as the instant snapshot to be created. This can be a full or valid partial URL. For example, the following are valid values: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /disks/disk - https://www.googleapis.com/compute/v1/projects/project/regions/region /disks/disk - projects/project/zones/zone/disks/disk - projects/project/regions/region/disks/disk - zones/zone/disks/disk - regions/region/disks/disk + * URL of the source disk used to create this instant snapshot. + * Note that the source disk must be in the same zone/region as the + * instant snapshot to be created. This can be a full or valid partial URL. + * For example, the following are valid values: + * - + * https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk + * - + * https://www.googleapis.com/compute/v1/projects/project/regions/region/disks/disk + * - + * projects/project/zones/zone/disks/disk + * - + * projects/project/regions/region/disks/disk + * - + * zones/zone/disks/disk + * - + * regions/region/disks/disk * * Generated from protobuf field optional string source_disk = 451753793; * @return string @@ -739,7 +877,22 @@ public function clearSourceDisk() } /** - * URL of the source disk used to create this instant snapshot. Note that the source disk must be in the same zone/region as the instant snapshot to be created. This can be a full or valid partial URL. For example, the following are valid values: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /disks/disk - https://www.googleapis.com/compute/v1/projects/project/regions/region /disks/disk - projects/project/zones/zone/disks/disk - projects/project/regions/region/disks/disk - zones/zone/disks/disk - regions/region/disks/disk + * URL of the source disk used to create this instant snapshot. + * Note that the source disk must be in the same zone/region as the + * instant snapshot to be created. This can be a full or valid partial URL. + * For example, the following are valid values: + * - + * https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk + * - + * https://www.googleapis.com/compute/v1/projects/project/regions/region/disks/disk + * - + * projects/project/zones/zone/disks/disk + * - + * projects/project/regions/region/disks/disk + * - + * zones/zone/disks/disk + * - + * regions/region/disks/disk * * Generated from protobuf field optional string source_disk = 451753793; * @param string $var @@ -754,7 +907,9 @@ public function setSourceDisk($var) } /** - * [Output Only] The ID value of the disk used to create this InstantSnapshot. This value may be used to determine whether the InstantSnapshot was taken from the current or a previous instance of a given disk name. + * [Output Only] The ID value of the disk used to create this InstantSnapshot. + * This value may be used to determine whether the InstantSnapshot + * was taken from the current or a previous instance of a given disk name. * * Generated from protobuf field optional string source_disk_id = 454190809; * @return string @@ -775,7 +930,9 @@ public function clearSourceDiskId() } /** - * [Output Only] The ID value of the disk used to create this InstantSnapshot. This value may be used to determine whether the InstantSnapshot was taken from the current or a previous instance of a given disk name. + * [Output Only] The ID value of the disk used to create this InstantSnapshot. + * This value may be used to determine whether the InstantSnapshot + * was taken from the current or a previous instance of a given disk name. * * Generated from protobuf field optional string source_disk_id = 454190809; * @param string $var @@ -790,7 +947,7 @@ public function setSourceDiskId($var) } /** - * [Output Only] The status of the instantSnapshot. This can be CREATING, DELETING, FAILED, or READY. + * [Output Only] The status of the instantSnapshot. This can beCREATING, DELETING, FAILED, orREADY. * Check the Status enum for the list of possible values. * * Generated from protobuf field optional string status = 181260274; @@ -812,7 +969,7 @@ public function clearStatus() } /** - * [Output Only] The status of the instantSnapshot. This can be CREATING, DELETING, FAILED, or READY. + * [Output Only] The status of the instantSnapshot. This can beCREATING, DELETING, FAILED, orREADY. * Check the Status enum for the list of possible values. * * Generated from protobuf field optional string status = 181260274; @@ -828,7 +985,9 @@ public function setStatus($var) } /** - * [Output Only] URL of the zone where the instant snapshot resides. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * [Output Only] URL of the zone where the instant snapshot resides. + * You must specify this field as part of the HTTP request URL. It is + * not settable as a field in the request body. * * Generated from protobuf field optional string zone = 3744684; * @return string @@ -849,7 +1008,9 @@ public function clearZone() } /** - * [Output Only] URL of the zone where the instant snapshot resides. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * [Output Only] URL of the zone where the instant snapshot resides. + * You must specify this field as part of the HTTP request URL. It is + * not settable as a field in the request body. * * Generated from protobuf field optional string zone = 3744684; * @param string $var diff --git a/Compute/src/V1/InstantSnapshot/Architecture.php b/Compute/src/V1/InstantSnapshot/Architecture.php index 11f58e89b490..c68829b9c43d 100644 --- a/Compute/src/V1/InstantSnapshot/Architecture.php +++ b/Compute/src/V1/InstantSnapshot/Architecture.php @@ -7,7 +7,8 @@ use UnexpectedValueException; /** - * [Output Only] The architecture of the instant snapshot. Valid values are ARM64 or X86_64. + * [Output Only] The architecture of the instant snapshot. Valid values are + * ARM64 or X86_64. * * Protobuf type google.cloud.compute.v1.InstantSnapshot.Architecture */ diff --git a/Compute/src/V1/InstantSnapshot/Status.php b/Compute/src/V1/InstantSnapshot/Status.php index 5e11b86984af..de1adc5b3078 100644 --- a/Compute/src/V1/InstantSnapshot/Status.php +++ b/Compute/src/V1/InstantSnapshot/Status.php @@ -7,7 +7,7 @@ use UnexpectedValueException; /** - * [Output Only] The status of the instantSnapshot. This can be CREATING, DELETING, FAILED, or READY. + * [Output Only] The status of the instantSnapshot. This can beCREATING, DELETING, FAILED, orREADY. * * Protobuf type google.cloud.compute.v1.InstantSnapshot.Status */ @@ -44,7 +44,8 @@ class Status */ const READY = 77848963; /** - * InstantSnapshot is currently unavailable and cannot be used for Disk restoration + * InstantSnapshot is currently unavailable and cannot be used for + * Disk restoration * * Generated from protobuf enum UNAVAILABLE = 413756464; */ diff --git a/Compute/src/V1/InstantSnapshotAggregatedList.php b/Compute/src/V1/InstantSnapshotAggregatedList.php index db61a03a105f..a4f52a7f64ba 100644 --- a/Compute/src/V1/InstantSnapshotAggregatedList.php +++ b/Compute/src/V1/InstantSnapshotAggregatedList.php @@ -27,13 +27,18 @@ class InstantSnapshotAggregatedList extends \Google\Protobuf\Internal\Message */ private $items; /** - * [Output Only] Type of resource. Always compute#instantSnapshotAggregatedList for aggregated lists of instantSnapshots. + * [Output Only] Type of resource. Alwayscompute#instantSnapshotAggregatedList for aggregated lists of + * instantSnapshots. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -68,9 +73,14 @@ class InstantSnapshotAggregatedList extends \Google\Protobuf\Internal\Message * @type array|\Google\Protobuf\Internal\MapField $items * A list of InstantSnapshotsScopedList resources. * @type string $kind - * [Output Only] Type of resource. Always compute#instantSnapshotAggregatedList for aggregated lists of instantSnapshots. + * [Output Only] Type of resource. Alwayscompute#instantSnapshotAggregatedList for aggregated lists of + * instantSnapshots. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type array|\Google\Protobuf\Internal\RepeatedField $unreachables @@ -147,7 +157,8 @@ public function setItems($var) } /** - * [Output Only] Type of resource. Always compute#instantSnapshotAggregatedList for aggregated lists of instantSnapshots. + * [Output Only] Type of resource. Alwayscompute#instantSnapshotAggregatedList for aggregated lists of + * instantSnapshots. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -168,7 +179,8 @@ public function clearKind() } /** - * [Output Only] Type of resource. Always compute#instantSnapshotAggregatedList for aggregated lists of instantSnapshots. + * [Output Only] Type of resource. Alwayscompute#instantSnapshotAggregatedList for aggregated lists of + * instantSnapshots. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -183,7 +195,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -204,7 +220,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/InstantSnapshotList.php b/Compute/src/V1/InstantSnapshotList.php index ad722c584591..8508bfdf5ebf 100644 --- a/Compute/src/V1/InstantSnapshotList.php +++ b/Compute/src/V1/InstantSnapshotList.php @@ -34,7 +34,11 @@ class InstantSnapshotList extends \Google\Protobuf\Internal\Message */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -65,7 +69,11 @@ class InstantSnapshotList extends \Google\Protobuf\Internal\Message * @type string $kind * Type of resource. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type \Google\Cloud\Compute\V1\Warning $warning @@ -176,7 +184,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -197,7 +209,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/InstantSnapshotsScopedList.php b/Compute/src/V1/InstantSnapshotsScopedList.php index 439d419892aa..c89b76183712 100644 --- a/Compute/src/V1/InstantSnapshotsScopedList.php +++ b/Compute/src/V1/InstantSnapshotsScopedList.php @@ -21,7 +21,8 @@ class InstantSnapshotsScopedList extends \Google\Protobuf\Internal\Message */ private $instant_snapshots; /** - * [Output Only] Informational warning which replaces the list of instantSnapshots when the list is empty. + * [Output Only] Informational warning which replaces the list of + * instantSnapshots when the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; */ @@ -36,7 +37,8 @@ class InstantSnapshotsScopedList extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\InstantSnapshot>|\Google\Protobuf\Internal\RepeatedField $instant_snapshots * [Output Only] A list of instantSnapshots contained in this scope. * @type \Google\Cloud\Compute\V1\Warning $warning - * [Output Only] Informational warning which replaces the list of instantSnapshots when the list is empty. + * [Output Only] Informational warning which replaces the list of + * instantSnapshots when the list is empty. * } */ public function __construct($data = NULL) { @@ -71,7 +73,8 @@ public function setInstantSnapshots($var) } /** - * [Output Only] Informational warning which replaces the list of instantSnapshots when the list is empty. + * [Output Only] Informational warning which replaces the list of + * instantSnapshots when the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; * @return \Google\Cloud\Compute\V1\Warning|null @@ -92,7 +95,8 @@ public function clearWarning() } /** - * [Output Only] Informational warning which replaces the list of instantSnapshots when the list is empty. + * [Output Only] Informational warning which replaces the list of + * instantSnapshots when the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; * @param \Google\Cloud\Compute\V1\Warning $var diff --git a/Compute/src/V1/Int64RangeMatch.php b/Compute/src/V1/Int64RangeMatch.php index 49448f2700c4..8c813af1ba6f 100644 --- a/Compute/src/V1/Int64RangeMatch.php +++ b/Compute/src/V1/Int64RangeMatch.php @@ -9,7 +9,8 @@ use Google\Protobuf\Internal\GPBUtil; /** - * HttpRouteRuleMatch criteria for field values that must stay within the specified integer range. + * HttpRouteRuleMatch criteria for field values that must stay + * within the specified integer range. * * Generated from protobuf message google.cloud.compute.v1.Int64RangeMatch */ diff --git a/Compute/src/V1/Interconnect.php b/Compute/src/V1/Interconnect.php index 99c4ba47890f..902733b53c6b 100644 --- a/Compute/src/V1/Interconnect.php +++ b/Compute/src/V1/Interconnect.php @@ -9,57 +9,79 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Represents an Interconnect resource. An Interconnect resource is a dedicated connection between the Google Cloud network and your on-premises network. For more information, read the Dedicated Interconnect Overview. + * Represents an Interconnect resource. + * An Interconnect resource is a dedicated connection between the Google + * Cloud network and your on-premises network. For more information, read the + * Dedicated Interconnect Overview. * * Generated from protobuf message google.cloud.compute.v1.Interconnect */ class Interconnect extends \Google\Protobuf\Internal\Message { /** - * Enable or disable the application awareness feature on this Cloud Interconnect. + * Enable or disable the application awareness feature on this Cloud + * Interconnect. * * Generated from protobuf field optional bool aai_enabled = 388780363; */ protected $aai_enabled = null; /** - * Administrative status of the interconnect. When this is set to true, the Interconnect is functional and can carry traffic. When set to false, no packets can be carried over the interconnect and no BGP routes are exchanged over it. By default, the status is set to true. + * Administrative status of the interconnect. When this is set to true, the + * Interconnect is functional and can carry traffic. + * When set to false, no packets can be carried over the interconnect and + * no BGP routes are exchanged over it. By default, the status is set to true. * * Generated from protobuf field optional bool admin_enabled = 445675089; */ protected $admin_enabled = null; /** - * Configuration information for application awareness on this Cloud Interconnect. + * Configuration information for application awareness on this Cloud + * Interconnect. * * Generated from protobuf field optional .google.cloud.compute.v1.InterconnectApplicationAwareInterconnect application_aware_interconnect = 429095966; */ protected $application_aware_interconnect = null; /** - * [Output only] List of features available for this Interconnect connection, which can take one of the following values: - IF_MACSEC If present then the Interconnect connection is provisioned on MACsec capable hardware ports. If not present then the Interconnect connection is provisioned on non-MACsec capable ports and MACsec isn't supported and enabling MACsec fails. + * [Output only] List of features available for this Interconnect connection, + * which can take one of the following values: + * - IF_MACSEC: If present, then the Interconnect connection is + * provisioned on MACsec capable hardware ports. If not present, then the + * Interconnect connection is provisioned on non-MACsec capable ports. Any + * attempt to enable MACsec will fail. + * - IF_CROSS_SITE_NETWORK: If present, then the Interconnect connection is + * provisioned exclusively for Cross-Site Networking. Any attempt to configure + * VLAN attachments will fail. If not present, then the Interconnect + * connection is not provisioned for Cross-Site Networking. Any attempt to use + * it for Cross-Site Networking will fail. * Check the AvailableFeatures enum for the list of possible values. * * Generated from protobuf field repeated string available_features = 496344307; */ private $available_features; /** - * [Output Only] A list of CircuitInfo objects, that describe the individual circuits in this LAG. + * [Output Only] A list of CircuitInfo objects, that describe the individual + * circuits in this LAG. * * Generated from protobuf field repeated .google.cloud.compute.v1.InterconnectCircuitInfo circuit_infos = 164839855; */ private $circuit_infos; /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; */ protected $creation_timestamp = null; /** - * Customer name, to put in the Letter of Authorization as the party authorized to request a crossconnect. + * Customer name, to put in the Letter of Authorization as the party + * authorized to request a crossconnect. * * Generated from protobuf field optional string customer_name = 3665484; */ protected $customer_name = null; /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; */ @@ -71,106 +93,160 @@ class Interconnect extends \Google\Protobuf\Internal\Message */ private $expected_outages; /** - * [Output Only] IP address configured on the Google side of the Interconnect link. This can be used only for ping tests. + * [Output Only] IP address configured on the Google side of the Interconnect + * link. This can be used only for ping tests. * * Generated from protobuf field optional string google_ip_address = 443105954; */ protected $google_ip_address = null; /** - * [Output Only] Google reference ID to be used when raising support tickets with Google or otherwise to debug backend connectivity issues. + * [Output Only] Google reference ID to be used when raising support tickets + * with Google or otherwise to debug backend connectivity issues. * * Generated from protobuf field optional string google_reference_id = 534944469; */ protected $google_reference_id = null; /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; */ protected $id = null; /** - * [Output Only] A list of the URLs of all InterconnectAttachments configured to use this Interconnect. + * [Output Only] A list of the URLs of all InterconnectAttachments configured + * to use this Interconnect. * * Generated from protobuf field repeated string interconnect_attachments = 425388415; */ private $interconnect_attachments; /** - * [Output Only] URLs of InterconnectGroups that include this Interconnect. Order is arbitrary and items are unique. + * [Output Only] URLs of InterconnectGroups that include this Interconnect. + * Order is arbitrary and items are unique. * * Generated from protobuf field repeated string interconnect_groups = 237049509; */ private $interconnect_groups; /** - * Type of interconnect, which can take one of the following values: - PARTNER: A partner-managed interconnection shared between customers though a partner. - DEDICATED: A dedicated physical interconnection with the customer. Note that a value IT_PRIVATE has been deprecated in favor of DEDICATED. + * Type of interconnect, which can take one of the following values: + * - PARTNER: A partner-managed interconnection shared between customers + * though a partner. + * - DEDICATED: A dedicated physical interconnection with the + * customer. + * Note that a value IT_PRIVATE has been deprecated in favor of DEDICATED. * Check the InterconnectType enum for the list of possible values. * * Generated from protobuf field optional string interconnect_type = 515165259; */ protected $interconnect_type = null; /** - * [Output Only] Type of the resource. Always compute#interconnect for interconnects. + * [Output Only] Type of the resource. Alwayscompute#interconnect for interconnects. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * A fingerprint for the labels being applied to this Interconnect, which is essentially a hash of the labels set used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve an Interconnect. + * A fingerprint for the labels being applied to this Interconnect, which + * is essentially a hash of the labels set used for optimistic locking. The + * fingerprint is initially generated by Compute Engine and changes after + * every request to modify or update labels. You must always provide an + * up-to-date fingerprint hash in order to update or change labels, + * otherwise the request will fail with error412 conditionNotMet. + * To see the latest fingerprint, make a get() request to + * retrieve an Interconnect. * * Generated from protobuf field optional string label_fingerprint = 178124825; */ protected $label_fingerprint = null; /** - * Labels for this resource. These can only be added or modified by the setLabels method. Each label key/value pair must comply with RFC1035. Label values may be empty. + * Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035. + * Label values may be empty. * * Generated from protobuf field map labels = 500195327; */ private $labels; /** - * Type of link requested, which can take one of the following values: - LINK_TYPE_ETHERNET_10G_LR: A 10G Ethernet with LR optics - LINK_TYPE_ETHERNET_100G_LR: A 100G Ethernet with LR optics. - LINK_TYPE_ETHERNET_400G_LR4: A 400G Ethernet with LR4 optics. Note that this field indicates the speed of each of the links in the bundle, not the speed of the entire bundle. + * Type of link requested, which can take one of the following values: + * - LINK_TYPE_ETHERNET_10G_LR: A 10G Ethernet with LR optics + * - LINK_TYPE_ETHERNET_100G_LR: A 100G Ethernet with LR optics. + * - LINK_TYPE_ETHERNET_400G_LR4: A 400G Ethernet with LR4 optics. + * Note that this field indicates the speed of each of + * the links in the bundle, not the speed of the entire bundle. * Check the LinkType enum for the list of possible values. * * Generated from protobuf field optional string link_type = 523207775; */ protected $link_type = null; /** - * URL of the InterconnectLocation object that represents where this connection is to be provisioned. + * URL of the InterconnectLocation object that represents where this + * connection is to be provisioned. * * Generated from protobuf field optional string location = 290430901; */ protected $location = null; /** - * Configuration that enables Media Access Control security (MACsec) on the Cloud Interconnect connection between Google and your on-premises router. + * Configuration that enables Media Access Control security (MACsec) on the + * Cloud Interconnect connection between Google and your on-premises router. * * Generated from protobuf field optional .google.cloud.compute.v1.InterconnectMacsec macsec = 528867490; */ protected $macsec = null; /** - * Enable or disable MACsec on this Interconnect connection. MACsec enablement fails if the MACsec object is not specified. + * Enable or disable MACsec on this Interconnect connection. MACsec enablement + * fails if the MACsec object is not specified. * * Generated from protobuf field optional bool macsec_enabled = 194203812; */ protected $macsec_enabled = null; /** - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must be + * a dash, lowercase letter, or digit, except the last character, which cannot + * be a dash. * * Generated from protobuf field optional string name = 3373707; */ protected $name = null; /** - * Email address to contact the customer NOC for operations and maintenance notifications regarding this Interconnect. If specified, this will be used for notifications in addition to all other forms described, such as Cloud Monitoring logs alerting and Cloud Notifications. This field is required for users who sign up for Cloud Interconnect using workforce identity federation. + * Email address to contact the customer NOC for operations and maintenance + * notifications regarding this Interconnect. If specified, this will be used + * for notifications in addition to all other forms described, such as + * Cloud Monitoring logs alerting and Cloud Notifications. This field is + * required for users who sign up for Cloud Interconnect using + * workforce identity federation. * * Generated from protobuf field optional string noc_contact_email = 14072832; */ protected $noc_contact_email = null; /** - * [Output Only] The current status of this Interconnect's functionality, which can take one of the following values: - OS_ACTIVE: A valid Interconnect, which is turned up and is ready to use. Attachments may be provisioned on this Interconnect. - OS_UNPROVISIONED: An Interconnect that has not completed turnup. No attachments may be provisioned on this Interconnect. - OS_UNDER_MAINTENANCE: An Interconnect that is undergoing internal maintenance. No attachments may be provisioned or updated on this Interconnect. + * [Output Only] The current status of this Interconnect's functionality, + * which can take one of the following values: + * - OS_ACTIVE: A valid Interconnect, which is turned up and is ready to + * use. Attachments may be provisioned on this Interconnect. + * - OS_UNPROVISIONED: An Interconnect that has not completed turnup. No + * attachments may be provisioned on this Interconnect. + * - OS_UNDER_MAINTENANCE: An Interconnect that is undergoing internal + * maintenance. No attachments may be provisioned or updated on this + * Interconnect. * Check the OperationalStatus enum for the list of possible values. * * Generated from protobuf field optional string operational_status = 201070847; */ protected $operational_status = null; /** - * [Output Only] IP address configured on the customer side of the Interconnect link. The customer should configure this IP address during turnup when prompted by Google NOC. This can be used only for ping tests. + * Input only. [Input Only] Additional params passed with the request, but not persisted + * as part of resource payload. + * + * Generated from protobuf field optional .google.cloud.compute.v1.InterconnectParams params = 78313862; + */ + protected $params = null; + /** + * [Output Only] IP address configured on the customer side of the + * Interconnect link. The customer should configure this IP address during + * turnup when prompted by Google NOC. This can be used only for ping tests. * * Generated from protobuf field optional string peer_ip_address = 207735769; */ @@ -182,20 +258,30 @@ class Interconnect extends \Google\Protobuf\Internal\Message */ protected $provisioned_link_count = null; /** - * Indicates that this is a Cross-Cloud Interconnect. This field specifies the location outside of Google's network that the interconnect is connected to. + * Indicates that this is a Cross-Cloud Interconnect. This field specifies the + * location outside of Google's network that the interconnect is connected to. * * Generated from protobuf field optional string remote_location = 324388750; */ protected $remote_location = null; /** - * Optional. List of features requested for this Interconnect connection, which can take one of the following values: - IF_MACSEC If specified then the connection is created on MACsec capable hardware ports. If not specified, the default value is false, which allocates non-MACsec capable ports first if available. This parameter can be provided only with Interconnect INSERT. It isn't valid for Interconnect PATCH. + * Optional. This parameter can be provided only with Interconnect INSERT. It + * isn't valid for Interconnect PATCH. List of features requested for this + * Interconnect connection, which can take one of the following values: + * - IF_MACSEC: If specified, then the connection is created on MACsec + * capable hardware ports. If not specified, non-MACsec capable ports will + * also be considered. + * - IF_CROSS_SITE_NETWORK: If specified, then the connection is created + * exclusively for Cross-Site Networking. The connection can not be used for + * Cross-Site Networking unless this feature is specified. * Check the RequestedFeatures enum for the list of possible values. * * Generated from protobuf field repeated string requested_features = 461240814; */ private $requested_features; /** - * Target number of physical links in the link bundle, as requested by the customer. + * Target number of physical links in the link bundle, as requested by the + * customer. * * Generated from protobuf field optional int32 requested_link_count = 45051387; */ @@ -213,19 +299,36 @@ class Interconnect extends \Google\Protobuf\Internal\Message */ protected $self_link = null; /** - * [Output Only] The current state of Interconnect functionality, which can take one of the following values: - ACTIVE: The Interconnect is valid, turned up and ready to use. Attachments may be provisioned on this Interconnect. - UNPROVISIONED: The Interconnect has not completed turnup. No attachments may be provisioned on this Interconnect. - UNDER_MAINTENANCE: The Interconnect is undergoing internal maintenance. No attachments may be provisioned or updated on this Interconnect. + * [Output Only] The current state of Interconnect functionality, which can + * take one of the following values: + * - ACTIVE: The Interconnect is valid, turned up and ready to use. + * Attachments may be provisioned on this Interconnect. + * - UNPROVISIONED: The Interconnect has not completed turnup. No + * attachments may be provisioned on this Interconnect. + * - UNDER_MAINTENANCE: The Interconnect is undergoing internal maintenance. + * No attachments may be provisioned or updated on this + * Interconnect. * Check the State enum for the list of possible values. * * Generated from protobuf field optional string state = 109757585; */ protected $state = null; /** - * Specific subzone in the InterconnectLocation that represents where this connection is to be provisioned. + * Specific subzone in the InterconnectLocation that represents where + * this connection is to be provisioned. * Check the Subzone enum for the list of possible values. * * Generated from protobuf field optional string subzone = 280084972; */ protected $subzone = null; + /** + * [Output Only] A list of the URLs of all CrossSiteNetwork WireGroups + * configured to use this Interconnect. The Interconnect cannot be deleted if + * this list is non-empty. + * + * Generated from protobuf field repeated string wire_groups = 40662734; + */ + private $wire_groups; /** * Constructor. @@ -234,80 +337,172 @@ class Interconnect extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type bool $aai_enabled - * Enable or disable the application awareness feature on this Cloud Interconnect. + * Enable or disable the application awareness feature on this Cloud + * Interconnect. * @type bool $admin_enabled - * Administrative status of the interconnect. When this is set to true, the Interconnect is functional and can carry traffic. When set to false, no packets can be carried over the interconnect and no BGP routes are exchanged over it. By default, the status is set to true. + * Administrative status of the interconnect. When this is set to true, the + * Interconnect is functional and can carry traffic. + * When set to false, no packets can be carried over the interconnect and + * no BGP routes are exchanged over it. By default, the status is set to true. * @type \Google\Cloud\Compute\V1\InterconnectApplicationAwareInterconnect $application_aware_interconnect - * Configuration information for application awareness on this Cloud Interconnect. + * Configuration information for application awareness on this Cloud + * Interconnect. * @type array|\Google\Protobuf\Internal\RepeatedField $available_features - * [Output only] List of features available for this Interconnect connection, which can take one of the following values: - IF_MACSEC If present then the Interconnect connection is provisioned on MACsec capable hardware ports. If not present then the Interconnect connection is provisioned on non-MACsec capable ports and MACsec isn't supported and enabling MACsec fails. + * [Output only] List of features available for this Interconnect connection, + * which can take one of the following values: + * - IF_MACSEC: If present, then the Interconnect connection is + * provisioned on MACsec capable hardware ports. If not present, then the + * Interconnect connection is provisioned on non-MACsec capable ports. Any + * attempt to enable MACsec will fail. + * - IF_CROSS_SITE_NETWORK: If present, then the Interconnect connection is + * provisioned exclusively for Cross-Site Networking. Any attempt to configure + * VLAN attachments will fail. If not present, then the Interconnect + * connection is not provisioned for Cross-Site Networking. Any attempt to use + * it for Cross-Site Networking will fail. * Check the AvailableFeatures enum for the list of possible values. * @type array<\Google\Cloud\Compute\V1\InterconnectCircuitInfo>|\Google\Protobuf\Internal\RepeatedField $circuit_infos - * [Output Only] A list of CircuitInfo objects, that describe the individual circuits in this LAG. + * [Output Only] A list of CircuitInfo objects, that describe the individual + * circuits in this LAG. * @type string $creation_timestamp - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * @type string $customer_name - * Customer name, to put in the Letter of Authorization as the party authorized to request a crossconnect. + * Customer name, to put in the Letter of Authorization as the party + * authorized to request a crossconnect. * @type string $description - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * @type array<\Google\Cloud\Compute\V1\InterconnectOutageNotification>|\Google\Protobuf\Internal\RepeatedField $expected_outages * [Output Only] A list of outages expected for this Interconnect. * @type string $google_ip_address - * [Output Only] IP address configured on the Google side of the Interconnect link. This can be used only for ping tests. + * [Output Only] IP address configured on the Google side of the Interconnect + * link. This can be used only for ping tests. * @type string $google_reference_id - * [Output Only] Google reference ID to be used when raising support tickets with Google or otherwise to debug backend connectivity issues. + * [Output Only] Google reference ID to be used when raising support tickets + * with Google or otherwise to debug backend connectivity issues. * @type int|string $id - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * @type array|\Google\Protobuf\Internal\RepeatedField $interconnect_attachments - * [Output Only] A list of the URLs of all InterconnectAttachments configured to use this Interconnect. + * [Output Only] A list of the URLs of all InterconnectAttachments configured + * to use this Interconnect. * @type array|\Google\Protobuf\Internal\RepeatedField $interconnect_groups - * [Output Only] URLs of InterconnectGroups that include this Interconnect. Order is arbitrary and items are unique. + * [Output Only] URLs of InterconnectGroups that include this Interconnect. + * Order is arbitrary and items are unique. * @type string $interconnect_type - * Type of interconnect, which can take one of the following values: - PARTNER: A partner-managed interconnection shared between customers though a partner. - DEDICATED: A dedicated physical interconnection with the customer. Note that a value IT_PRIVATE has been deprecated in favor of DEDICATED. + * Type of interconnect, which can take one of the following values: + * - PARTNER: A partner-managed interconnection shared between customers + * though a partner. + * - DEDICATED: A dedicated physical interconnection with the + * customer. + * Note that a value IT_PRIVATE has been deprecated in favor of DEDICATED. * Check the InterconnectType enum for the list of possible values. * @type string $kind - * [Output Only] Type of the resource. Always compute#interconnect for interconnects. + * [Output Only] Type of the resource. Alwayscompute#interconnect for interconnects. * @type string $label_fingerprint - * A fingerprint for the labels being applied to this Interconnect, which is essentially a hash of the labels set used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve an Interconnect. + * A fingerprint for the labels being applied to this Interconnect, which + * is essentially a hash of the labels set used for optimistic locking. The + * fingerprint is initially generated by Compute Engine and changes after + * every request to modify or update labels. You must always provide an + * up-to-date fingerprint hash in order to update or change labels, + * otherwise the request will fail with error412 conditionNotMet. + * To see the latest fingerprint, make a get() request to + * retrieve an Interconnect. * @type array|\Google\Protobuf\Internal\MapField $labels - * Labels for this resource. These can only be added or modified by the setLabels method. Each label key/value pair must comply with RFC1035. Label values may be empty. + * Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035. + * Label values may be empty. * @type string $link_type - * Type of link requested, which can take one of the following values: - LINK_TYPE_ETHERNET_10G_LR: A 10G Ethernet with LR optics - LINK_TYPE_ETHERNET_100G_LR: A 100G Ethernet with LR optics. - LINK_TYPE_ETHERNET_400G_LR4: A 400G Ethernet with LR4 optics. Note that this field indicates the speed of each of the links in the bundle, not the speed of the entire bundle. + * Type of link requested, which can take one of the following values: + * - LINK_TYPE_ETHERNET_10G_LR: A 10G Ethernet with LR optics + * - LINK_TYPE_ETHERNET_100G_LR: A 100G Ethernet with LR optics. + * - LINK_TYPE_ETHERNET_400G_LR4: A 400G Ethernet with LR4 optics. + * Note that this field indicates the speed of each of + * the links in the bundle, not the speed of the entire bundle. * Check the LinkType enum for the list of possible values. * @type string $location - * URL of the InterconnectLocation object that represents where this connection is to be provisioned. + * URL of the InterconnectLocation object that represents where this + * connection is to be provisioned. * @type \Google\Cloud\Compute\V1\InterconnectMacsec $macsec - * Configuration that enables Media Access Control security (MACsec) on the Cloud Interconnect connection between Google and your on-premises router. + * Configuration that enables Media Access Control security (MACsec) on the + * Cloud Interconnect connection between Google and your on-premises router. * @type bool $macsec_enabled - * Enable or disable MACsec on this Interconnect connection. MACsec enablement fails if the MACsec object is not specified. + * Enable or disable MACsec on this Interconnect connection. MACsec enablement + * fails if the MACsec object is not specified. * @type string $name - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must be + * a dash, lowercase letter, or digit, except the last character, which cannot + * be a dash. * @type string $noc_contact_email - * Email address to contact the customer NOC for operations and maintenance notifications regarding this Interconnect. If specified, this will be used for notifications in addition to all other forms described, such as Cloud Monitoring logs alerting and Cloud Notifications. This field is required for users who sign up for Cloud Interconnect using workforce identity federation. + * Email address to contact the customer NOC for operations and maintenance + * notifications regarding this Interconnect. If specified, this will be used + * for notifications in addition to all other forms described, such as + * Cloud Monitoring logs alerting and Cloud Notifications. This field is + * required for users who sign up for Cloud Interconnect using + * workforce identity federation. * @type string $operational_status - * [Output Only] The current status of this Interconnect's functionality, which can take one of the following values: - OS_ACTIVE: A valid Interconnect, which is turned up and is ready to use. Attachments may be provisioned on this Interconnect. - OS_UNPROVISIONED: An Interconnect that has not completed turnup. No attachments may be provisioned on this Interconnect. - OS_UNDER_MAINTENANCE: An Interconnect that is undergoing internal maintenance. No attachments may be provisioned or updated on this Interconnect. + * [Output Only] The current status of this Interconnect's functionality, + * which can take one of the following values: + * - OS_ACTIVE: A valid Interconnect, which is turned up and is ready to + * use. Attachments may be provisioned on this Interconnect. + * - OS_UNPROVISIONED: An Interconnect that has not completed turnup. No + * attachments may be provisioned on this Interconnect. + * - OS_UNDER_MAINTENANCE: An Interconnect that is undergoing internal + * maintenance. No attachments may be provisioned or updated on this + * Interconnect. * Check the OperationalStatus enum for the list of possible values. + * @type \Google\Cloud\Compute\V1\InterconnectParams $params + * Input only. [Input Only] Additional params passed with the request, but not persisted + * as part of resource payload. * @type string $peer_ip_address - * [Output Only] IP address configured on the customer side of the Interconnect link. The customer should configure this IP address during turnup when prompted by Google NOC. This can be used only for ping tests. + * [Output Only] IP address configured on the customer side of the + * Interconnect link. The customer should configure this IP address during + * turnup when prompted by Google NOC. This can be used only for ping tests. * @type int $provisioned_link_count * [Output Only] Number of links actually provisioned in this interconnect. * @type string $remote_location - * Indicates that this is a Cross-Cloud Interconnect. This field specifies the location outside of Google's network that the interconnect is connected to. + * Indicates that this is a Cross-Cloud Interconnect. This field specifies the + * location outside of Google's network that the interconnect is connected to. * @type array|\Google\Protobuf\Internal\RepeatedField $requested_features - * Optional. List of features requested for this Interconnect connection, which can take one of the following values: - IF_MACSEC If specified then the connection is created on MACsec capable hardware ports. If not specified, the default value is false, which allocates non-MACsec capable ports first if available. This parameter can be provided only with Interconnect INSERT. It isn't valid for Interconnect PATCH. + * Optional. This parameter can be provided only with Interconnect INSERT. It + * isn't valid for Interconnect PATCH. List of features requested for this + * Interconnect connection, which can take one of the following values: + * - IF_MACSEC: If specified, then the connection is created on MACsec + * capable hardware ports. If not specified, non-MACsec capable ports will + * also be considered. + * - IF_CROSS_SITE_NETWORK: If specified, then the connection is created + * exclusively for Cross-Site Networking. The connection can not be used for + * Cross-Site Networking unless this feature is specified. * Check the RequestedFeatures enum for the list of possible values. * @type int $requested_link_count - * Target number of physical links in the link bundle, as requested by the customer. + * Target number of physical links in the link bundle, as requested by the + * customer. * @type bool $satisfies_pzs * [Output Only] Reserved for future use. * @type string $self_link * [Output Only] Server-defined URL for the resource. * @type string $state - * [Output Only] The current state of Interconnect functionality, which can take one of the following values: - ACTIVE: The Interconnect is valid, turned up and ready to use. Attachments may be provisioned on this Interconnect. - UNPROVISIONED: The Interconnect has not completed turnup. No attachments may be provisioned on this Interconnect. - UNDER_MAINTENANCE: The Interconnect is undergoing internal maintenance. No attachments may be provisioned or updated on this Interconnect. + * [Output Only] The current state of Interconnect functionality, which can + * take one of the following values: + * - ACTIVE: The Interconnect is valid, turned up and ready to use. + * Attachments may be provisioned on this Interconnect. + * - UNPROVISIONED: The Interconnect has not completed turnup. No + * attachments may be provisioned on this Interconnect. + * - UNDER_MAINTENANCE: The Interconnect is undergoing internal maintenance. + * No attachments may be provisioned or updated on this + * Interconnect. * Check the State enum for the list of possible values. * @type string $subzone - * Specific subzone in the InterconnectLocation that represents where this connection is to be provisioned. + * Specific subzone in the InterconnectLocation that represents where + * this connection is to be provisioned. * Check the Subzone enum for the list of possible values. + * @type array|\Google\Protobuf\Internal\RepeatedField $wire_groups + * [Output Only] A list of the URLs of all CrossSiteNetwork WireGroups + * configured to use this Interconnect. The Interconnect cannot be deleted if + * this list is non-empty. * } */ public function __construct($data = NULL) { @@ -316,7 +511,8 @@ public function __construct($data = NULL) { } /** - * Enable or disable the application awareness feature on this Cloud Interconnect. + * Enable or disable the application awareness feature on this Cloud + * Interconnect. * * Generated from protobuf field optional bool aai_enabled = 388780363; * @return bool @@ -337,7 +533,8 @@ public function clearAaiEnabled() } /** - * Enable or disable the application awareness feature on this Cloud Interconnect. + * Enable or disable the application awareness feature on this Cloud + * Interconnect. * * Generated from protobuf field optional bool aai_enabled = 388780363; * @param bool $var @@ -352,7 +549,10 @@ public function setAaiEnabled($var) } /** - * Administrative status of the interconnect. When this is set to true, the Interconnect is functional and can carry traffic. When set to false, no packets can be carried over the interconnect and no BGP routes are exchanged over it. By default, the status is set to true. + * Administrative status of the interconnect. When this is set to true, the + * Interconnect is functional and can carry traffic. + * When set to false, no packets can be carried over the interconnect and + * no BGP routes are exchanged over it. By default, the status is set to true. * * Generated from protobuf field optional bool admin_enabled = 445675089; * @return bool @@ -373,7 +573,10 @@ public function clearAdminEnabled() } /** - * Administrative status of the interconnect. When this is set to true, the Interconnect is functional and can carry traffic. When set to false, no packets can be carried over the interconnect and no BGP routes are exchanged over it. By default, the status is set to true. + * Administrative status of the interconnect. When this is set to true, the + * Interconnect is functional and can carry traffic. + * When set to false, no packets can be carried over the interconnect and + * no BGP routes are exchanged over it. By default, the status is set to true. * * Generated from protobuf field optional bool admin_enabled = 445675089; * @param bool $var @@ -388,7 +591,8 @@ public function setAdminEnabled($var) } /** - * Configuration information for application awareness on this Cloud Interconnect. + * Configuration information for application awareness on this Cloud + * Interconnect. * * Generated from protobuf field optional .google.cloud.compute.v1.InterconnectApplicationAwareInterconnect application_aware_interconnect = 429095966; * @return \Google\Cloud\Compute\V1\InterconnectApplicationAwareInterconnect|null @@ -409,7 +613,8 @@ public function clearApplicationAwareInterconnect() } /** - * Configuration information for application awareness on this Cloud Interconnect. + * Configuration information for application awareness on this Cloud + * Interconnect. * * Generated from protobuf field optional .google.cloud.compute.v1.InterconnectApplicationAwareInterconnect application_aware_interconnect = 429095966; * @param \Google\Cloud\Compute\V1\InterconnectApplicationAwareInterconnect $var @@ -424,7 +629,17 @@ public function setApplicationAwareInterconnect($var) } /** - * [Output only] List of features available for this Interconnect connection, which can take one of the following values: - IF_MACSEC If present then the Interconnect connection is provisioned on MACsec capable hardware ports. If not present then the Interconnect connection is provisioned on non-MACsec capable ports and MACsec isn't supported and enabling MACsec fails. + * [Output only] List of features available for this Interconnect connection, + * which can take one of the following values: + * - IF_MACSEC: If present, then the Interconnect connection is + * provisioned on MACsec capable hardware ports. If not present, then the + * Interconnect connection is provisioned on non-MACsec capable ports. Any + * attempt to enable MACsec will fail. + * - IF_CROSS_SITE_NETWORK: If present, then the Interconnect connection is + * provisioned exclusively for Cross-Site Networking. Any attempt to configure + * VLAN attachments will fail. If not present, then the Interconnect + * connection is not provisioned for Cross-Site Networking. Any attempt to use + * it for Cross-Site Networking will fail. * Check the AvailableFeatures enum for the list of possible values. * * Generated from protobuf field repeated string available_features = 496344307; @@ -436,7 +651,17 @@ public function getAvailableFeatures() } /** - * [Output only] List of features available for this Interconnect connection, which can take one of the following values: - IF_MACSEC If present then the Interconnect connection is provisioned on MACsec capable hardware ports. If not present then the Interconnect connection is provisioned on non-MACsec capable ports and MACsec isn't supported and enabling MACsec fails. + * [Output only] List of features available for this Interconnect connection, + * which can take one of the following values: + * - IF_MACSEC: If present, then the Interconnect connection is + * provisioned on MACsec capable hardware ports. If not present, then the + * Interconnect connection is provisioned on non-MACsec capable ports. Any + * attempt to enable MACsec will fail. + * - IF_CROSS_SITE_NETWORK: If present, then the Interconnect connection is + * provisioned exclusively for Cross-Site Networking. Any attempt to configure + * VLAN attachments will fail. If not present, then the Interconnect + * connection is not provisioned for Cross-Site Networking. Any attempt to use + * it for Cross-Site Networking will fail. * Check the AvailableFeatures enum for the list of possible values. * * Generated from protobuf field repeated string available_features = 496344307; @@ -452,7 +677,8 @@ public function setAvailableFeatures($var) } /** - * [Output Only] A list of CircuitInfo objects, that describe the individual circuits in this LAG. + * [Output Only] A list of CircuitInfo objects, that describe the individual + * circuits in this LAG. * * Generated from protobuf field repeated .google.cloud.compute.v1.InterconnectCircuitInfo circuit_infos = 164839855; * @return \Google\Protobuf\Internal\RepeatedField @@ -463,7 +689,8 @@ public function getCircuitInfos() } /** - * [Output Only] A list of CircuitInfo objects, that describe the individual circuits in this LAG. + * [Output Only] A list of CircuitInfo objects, that describe the individual + * circuits in this LAG. * * Generated from protobuf field repeated .google.cloud.compute.v1.InterconnectCircuitInfo circuit_infos = 164839855; * @param array<\Google\Cloud\Compute\V1\InterconnectCircuitInfo>|\Google\Protobuf\Internal\RepeatedField $var @@ -478,7 +705,8 @@ public function setCircuitInfos($var) } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @return string @@ -499,7 +727,8 @@ public function clearCreationTimestamp() } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @param string $var @@ -514,7 +743,8 @@ public function setCreationTimestamp($var) } /** - * Customer name, to put in the Letter of Authorization as the party authorized to request a crossconnect. + * Customer name, to put in the Letter of Authorization as the party + * authorized to request a crossconnect. * * Generated from protobuf field optional string customer_name = 3665484; * @return string @@ -535,7 +765,8 @@ public function clearCustomerName() } /** - * Customer name, to put in the Letter of Authorization as the party authorized to request a crossconnect. + * Customer name, to put in the Letter of Authorization as the party + * authorized to request a crossconnect. * * Generated from protobuf field optional string customer_name = 3665484; * @param string $var @@ -550,7 +781,8 @@ public function setCustomerName($var) } /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @return string @@ -571,7 +803,8 @@ public function clearDescription() } /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @param string $var @@ -612,7 +845,8 @@ public function setExpectedOutages($var) } /** - * [Output Only] IP address configured on the Google side of the Interconnect link. This can be used only for ping tests. + * [Output Only] IP address configured on the Google side of the Interconnect + * link. This can be used only for ping tests. * * Generated from protobuf field optional string google_ip_address = 443105954; * @return string @@ -633,7 +867,8 @@ public function clearGoogleIpAddress() } /** - * [Output Only] IP address configured on the Google side of the Interconnect link. This can be used only for ping tests. + * [Output Only] IP address configured on the Google side of the Interconnect + * link. This can be used only for ping tests. * * Generated from protobuf field optional string google_ip_address = 443105954; * @param string $var @@ -648,7 +883,8 @@ public function setGoogleIpAddress($var) } /** - * [Output Only] Google reference ID to be used when raising support tickets with Google or otherwise to debug backend connectivity issues. + * [Output Only] Google reference ID to be used when raising support tickets + * with Google or otherwise to debug backend connectivity issues. * * Generated from protobuf field optional string google_reference_id = 534944469; * @return string @@ -669,7 +905,8 @@ public function clearGoogleReferenceId() } /** - * [Output Only] Google reference ID to be used when raising support tickets with Google or otherwise to debug backend connectivity issues. + * [Output Only] Google reference ID to be used when raising support tickets + * with Google or otherwise to debug backend connectivity issues. * * Generated from protobuf field optional string google_reference_id = 534944469; * @param string $var @@ -684,7 +921,8 @@ public function setGoogleReferenceId($var) } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @return int|string @@ -705,7 +943,8 @@ public function clearId() } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @param int|string $var @@ -720,7 +959,8 @@ public function setId($var) } /** - * [Output Only] A list of the URLs of all InterconnectAttachments configured to use this Interconnect. + * [Output Only] A list of the URLs of all InterconnectAttachments configured + * to use this Interconnect. * * Generated from protobuf field repeated string interconnect_attachments = 425388415; * @return \Google\Protobuf\Internal\RepeatedField @@ -731,7 +971,8 @@ public function getInterconnectAttachments() } /** - * [Output Only] A list of the URLs of all InterconnectAttachments configured to use this Interconnect. + * [Output Only] A list of the URLs of all InterconnectAttachments configured + * to use this Interconnect. * * Generated from protobuf field repeated string interconnect_attachments = 425388415; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -746,7 +987,8 @@ public function setInterconnectAttachments($var) } /** - * [Output Only] URLs of InterconnectGroups that include this Interconnect. Order is arbitrary and items are unique. + * [Output Only] URLs of InterconnectGroups that include this Interconnect. + * Order is arbitrary and items are unique. * * Generated from protobuf field repeated string interconnect_groups = 237049509; * @return \Google\Protobuf\Internal\RepeatedField @@ -757,7 +999,8 @@ public function getInterconnectGroups() } /** - * [Output Only] URLs of InterconnectGroups that include this Interconnect. Order is arbitrary and items are unique. + * [Output Only] URLs of InterconnectGroups that include this Interconnect. + * Order is arbitrary and items are unique. * * Generated from protobuf field repeated string interconnect_groups = 237049509; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -772,7 +1015,12 @@ public function setInterconnectGroups($var) } /** - * Type of interconnect, which can take one of the following values: - PARTNER: A partner-managed interconnection shared between customers though a partner. - DEDICATED: A dedicated physical interconnection with the customer. Note that a value IT_PRIVATE has been deprecated in favor of DEDICATED. + * Type of interconnect, which can take one of the following values: + * - PARTNER: A partner-managed interconnection shared between customers + * though a partner. + * - DEDICATED: A dedicated physical interconnection with the + * customer. + * Note that a value IT_PRIVATE has been deprecated in favor of DEDICATED. * Check the InterconnectType enum for the list of possible values. * * Generated from protobuf field optional string interconnect_type = 515165259; @@ -794,7 +1042,12 @@ public function clearInterconnectType() } /** - * Type of interconnect, which can take one of the following values: - PARTNER: A partner-managed interconnection shared between customers though a partner. - DEDICATED: A dedicated physical interconnection with the customer. Note that a value IT_PRIVATE has been deprecated in favor of DEDICATED. + * Type of interconnect, which can take one of the following values: + * - PARTNER: A partner-managed interconnection shared between customers + * though a partner. + * - DEDICATED: A dedicated physical interconnection with the + * customer. + * Note that a value IT_PRIVATE has been deprecated in favor of DEDICATED. * Check the InterconnectType enum for the list of possible values. * * Generated from protobuf field optional string interconnect_type = 515165259; @@ -810,7 +1063,7 @@ public function setInterconnectType($var) } /** - * [Output Only] Type of the resource. Always compute#interconnect for interconnects. + * [Output Only] Type of the resource. Alwayscompute#interconnect for interconnects. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -831,7 +1084,7 @@ public function clearKind() } /** - * [Output Only] Type of the resource. Always compute#interconnect for interconnects. + * [Output Only] Type of the resource. Alwayscompute#interconnect for interconnects. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -846,7 +1099,14 @@ public function setKind($var) } /** - * A fingerprint for the labels being applied to this Interconnect, which is essentially a hash of the labels set used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve an Interconnect. + * A fingerprint for the labels being applied to this Interconnect, which + * is essentially a hash of the labels set used for optimistic locking. The + * fingerprint is initially generated by Compute Engine and changes after + * every request to modify or update labels. You must always provide an + * up-to-date fingerprint hash in order to update or change labels, + * otherwise the request will fail with error412 conditionNotMet. + * To see the latest fingerprint, make a get() request to + * retrieve an Interconnect. * * Generated from protobuf field optional string label_fingerprint = 178124825; * @return string @@ -867,7 +1127,14 @@ public function clearLabelFingerprint() } /** - * A fingerprint for the labels being applied to this Interconnect, which is essentially a hash of the labels set used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve an Interconnect. + * A fingerprint for the labels being applied to this Interconnect, which + * is essentially a hash of the labels set used for optimistic locking. The + * fingerprint is initially generated by Compute Engine and changes after + * every request to modify or update labels. You must always provide an + * up-to-date fingerprint hash in order to update or change labels, + * otherwise the request will fail with error412 conditionNotMet. + * To see the latest fingerprint, make a get() request to + * retrieve an Interconnect. * * Generated from protobuf field optional string label_fingerprint = 178124825; * @param string $var @@ -882,7 +1149,8 @@ public function setLabelFingerprint($var) } /** - * Labels for this resource. These can only be added or modified by the setLabels method. Each label key/value pair must comply with RFC1035. Label values may be empty. + * Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035. + * Label values may be empty. * * Generated from protobuf field map labels = 500195327; * @return \Google\Protobuf\Internal\MapField @@ -893,7 +1161,8 @@ public function getLabels() } /** - * Labels for this resource. These can only be added or modified by the setLabels method. Each label key/value pair must comply with RFC1035. Label values may be empty. + * Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035. + * Label values may be empty. * * Generated from protobuf field map labels = 500195327; * @param array|\Google\Protobuf\Internal\MapField $var @@ -908,7 +1177,12 @@ public function setLabels($var) } /** - * Type of link requested, which can take one of the following values: - LINK_TYPE_ETHERNET_10G_LR: A 10G Ethernet with LR optics - LINK_TYPE_ETHERNET_100G_LR: A 100G Ethernet with LR optics. - LINK_TYPE_ETHERNET_400G_LR4: A 400G Ethernet with LR4 optics. Note that this field indicates the speed of each of the links in the bundle, not the speed of the entire bundle. + * Type of link requested, which can take one of the following values: + * - LINK_TYPE_ETHERNET_10G_LR: A 10G Ethernet with LR optics + * - LINK_TYPE_ETHERNET_100G_LR: A 100G Ethernet with LR optics. + * - LINK_TYPE_ETHERNET_400G_LR4: A 400G Ethernet with LR4 optics. + * Note that this field indicates the speed of each of + * the links in the bundle, not the speed of the entire bundle. * Check the LinkType enum for the list of possible values. * * Generated from protobuf field optional string link_type = 523207775; @@ -930,7 +1204,12 @@ public function clearLinkType() } /** - * Type of link requested, which can take one of the following values: - LINK_TYPE_ETHERNET_10G_LR: A 10G Ethernet with LR optics - LINK_TYPE_ETHERNET_100G_LR: A 100G Ethernet with LR optics. - LINK_TYPE_ETHERNET_400G_LR4: A 400G Ethernet with LR4 optics. Note that this field indicates the speed of each of the links in the bundle, not the speed of the entire bundle. + * Type of link requested, which can take one of the following values: + * - LINK_TYPE_ETHERNET_10G_LR: A 10G Ethernet with LR optics + * - LINK_TYPE_ETHERNET_100G_LR: A 100G Ethernet with LR optics. + * - LINK_TYPE_ETHERNET_400G_LR4: A 400G Ethernet with LR4 optics. + * Note that this field indicates the speed of each of + * the links in the bundle, not the speed of the entire bundle. * Check the LinkType enum for the list of possible values. * * Generated from protobuf field optional string link_type = 523207775; @@ -946,7 +1225,8 @@ public function setLinkType($var) } /** - * URL of the InterconnectLocation object that represents where this connection is to be provisioned. + * URL of the InterconnectLocation object that represents where this + * connection is to be provisioned. * * Generated from protobuf field optional string location = 290430901; * @return string @@ -967,7 +1247,8 @@ public function clearLocation() } /** - * URL of the InterconnectLocation object that represents where this connection is to be provisioned. + * URL of the InterconnectLocation object that represents where this + * connection is to be provisioned. * * Generated from protobuf field optional string location = 290430901; * @param string $var @@ -982,7 +1263,8 @@ public function setLocation($var) } /** - * Configuration that enables Media Access Control security (MACsec) on the Cloud Interconnect connection between Google and your on-premises router. + * Configuration that enables Media Access Control security (MACsec) on the + * Cloud Interconnect connection between Google and your on-premises router. * * Generated from protobuf field optional .google.cloud.compute.v1.InterconnectMacsec macsec = 528867490; * @return \Google\Cloud\Compute\V1\InterconnectMacsec|null @@ -1003,7 +1285,8 @@ public function clearMacsec() } /** - * Configuration that enables Media Access Control security (MACsec) on the Cloud Interconnect connection between Google and your on-premises router. + * Configuration that enables Media Access Control security (MACsec) on the + * Cloud Interconnect connection between Google and your on-premises router. * * Generated from protobuf field optional .google.cloud.compute.v1.InterconnectMacsec macsec = 528867490; * @param \Google\Cloud\Compute\V1\InterconnectMacsec $var @@ -1018,7 +1301,8 @@ public function setMacsec($var) } /** - * Enable or disable MACsec on this Interconnect connection. MACsec enablement fails if the MACsec object is not specified. + * Enable or disable MACsec on this Interconnect connection. MACsec enablement + * fails if the MACsec object is not specified. * * Generated from protobuf field optional bool macsec_enabled = 194203812; * @return bool @@ -1039,7 +1323,8 @@ public function clearMacsecEnabled() } /** - * Enable or disable MACsec on this Interconnect connection. MACsec enablement fails if the MACsec object is not specified. + * Enable or disable MACsec on this Interconnect connection. MACsec enablement + * fails if the MACsec object is not specified. * * Generated from protobuf field optional bool macsec_enabled = 194203812; * @param bool $var @@ -1054,7 +1339,13 @@ public function setMacsecEnabled($var) } /** - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must be + * a dash, lowercase letter, or digit, except the last character, which cannot + * be a dash. * * Generated from protobuf field optional string name = 3373707; * @return string @@ -1075,7 +1366,13 @@ public function clearName() } /** - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must be + * a dash, lowercase letter, or digit, except the last character, which cannot + * be a dash. * * Generated from protobuf field optional string name = 3373707; * @param string $var @@ -1090,7 +1387,12 @@ public function setName($var) } /** - * Email address to contact the customer NOC for operations and maintenance notifications regarding this Interconnect. If specified, this will be used for notifications in addition to all other forms described, such as Cloud Monitoring logs alerting and Cloud Notifications. This field is required for users who sign up for Cloud Interconnect using workforce identity federation. + * Email address to contact the customer NOC for operations and maintenance + * notifications regarding this Interconnect. If specified, this will be used + * for notifications in addition to all other forms described, such as + * Cloud Monitoring logs alerting and Cloud Notifications. This field is + * required for users who sign up for Cloud Interconnect using + * workforce identity federation. * * Generated from protobuf field optional string noc_contact_email = 14072832; * @return string @@ -1111,7 +1413,12 @@ public function clearNocContactEmail() } /** - * Email address to contact the customer NOC for operations and maintenance notifications regarding this Interconnect. If specified, this will be used for notifications in addition to all other forms described, such as Cloud Monitoring logs alerting and Cloud Notifications. This field is required for users who sign up for Cloud Interconnect using workforce identity federation. + * Email address to contact the customer NOC for operations and maintenance + * notifications regarding this Interconnect. If specified, this will be used + * for notifications in addition to all other forms described, such as + * Cloud Monitoring logs alerting and Cloud Notifications. This field is + * required for users who sign up for Cloud Interconnect using + * workforce identity federation. * * Generated from protobuf field optional string noc_contact_email = 14072832; * @param string $var @@ -1126,7 +1433,15 @@ public function setNocContactEmail($var) } /** - * [Output Only] The current status of this Interconnect's functionality, which can take one of the following values: - OS_ACTIVE: A valid Interconnect, which is turned up and is ready to use. Attachments may be provisioned on this Interconnect. - OS_UNPROVISIONED: An Interconnect that has not completed turnup. No attachments may be provisioned on this Interconnect. - OS_UNDER_MAINTENANCE: An Interconnect that is undergoing internal maintenance. No attachments may be provisioned or updated on this Interconnect. + * [Output Only] The current status of this Interconnect's functionality, + * which can take one of the following values: + * - OS_ACTIVE: A valid Interconnect, which is turned up and is ready to + * use. Attachments may be provisioned on this Interconnect. + * - OS_UNPROVISIONED: An Interconnect that has not completed turnup. No + * attachments may be provisioned on this Interconnect. + * - OS_UNDER_MAINTENANCE: An Interconnect that is undergoing internal + * maintenance. No attachments may be provisioned or updated on this + * Interconnect. * Check the OperationalStatus enum for the list of possible values. * * Generated from protobuf field optional string operational_status = 201070847; @@ -1148,7 +1463,15 @@ public function clearOperationalStatus() } /** - * [Output Only] The current status of this Interconnect's functionality, which can take one of the following values: - OS_ACTIVE: A valid Interconnect, which is turned up and is ready to use. Attachments may be provisioned on this Interconnect. - OS_UNPROVISIONED: An Interconnect that has not completed turnup. No attachments may be provisioned on this Interconnect. - OS_UNDER_MAINTENANCE: An Interconnect that is undergoing internal maintenance. No attachments may be provisioned or updated on this Interconnect. + * [Output Only] The current status of this Interconnect's functionality, + * which can take one of the following values: + * - OS_ACTIVE: A valid Interconnect, which is turned up and is ready to + * use. Attachments may be provisioned on this Interconnect. + * - OS_UNPROVISIONED: An Interconnect that has not completed turnup. No + * attachments may be provisioned on this Interconnect. + * - OS_UNDER_MAINTENANCE: An Interconnect that is undergoing internal + * maintenance. No attachments may be provisioned or updated on this + * Interconnect. * Check the OperationalStatus enum for the list of possible values. * * Generated from protobuf field optional string operational_status = 201070847; @@ -1164,7 +1487,47 @@ public function setOperationalStatus($var) } /** - * [Output Only] IP address configured on the customer side of the Interconnect link. The customer should configure this IP address during turnup when prompted by Google NOC. This can be used only for ping tests. + * Input only. [Input Only] Additional params passed with the request, but not persisted + * as part of resource payload. + * + * Generated from protobuf field optional .google.cloud.compute.v1.InterconnectParams params = 78313862; + * @return \Google\Cloud\Compute\V1\InterconnectParams|null + */ + public function getParams() + { + return $this->params; + } + + public function hasParams() + { + return isset($this->params); + } + + public function clearParams() + { + unset($this->params); + } + + /** + * Input only. [Input Only] Additional params passed with the request, but not persisted + * as part of resource payload. + * + * Generated from protobuf field optional .google.cloud.compute.v1.InterconnectParams params = 78313862; + * @param \Google\Cloud\Compute\V1\InterconnectParams $var + * @return $this + */ + public function setParams($var) + { + GPBUtil::checkMessage($var, \Google\Cloud\Compute\V1\InterconnectParams::class); + $this->params = $var; + + return $this; + } + + /** + * [Output Only] IP address configured on the customer side of the + * Interconnect link. The customer should configure this IP address during + * turnup when prompted by Google NOC. This can be used only for ping tests. * * Generated from protobuf field optional string peer_ip_address = 207735769; * @return string @@ -1185,7 +1548,9 @@ public function clearPeerIpAddress() } /** - * [Output Only] IP address configured on the customer side of the Interconnect link. The customer should configure this IP address during turnup when prompted by Google NOC. This can be used only for ping tests. + * [Output Only] IP address configured on the customer side of the + * Interconnect link. The customer should configure this IP address during + * turnup when prompted by Google NOC. This can be used only for ping tests. * * Generated from protobuf field optional string peer_ip_address = 207735769; * @param string $var @@ -1236,7 +1601,8 @@ public function setProvisionedLinkCount($var) } /** - * Indicates that this is a Cross-Cloud Interconnect. This field specifies the location outside of Google's network that the interconnect is connected to. + * Indicates that this is a Cross-Cloud Interconnect. This field specifies the + * location outside of Google's network that the interconnect is connected to. * * Generated from protobuf field optional string remote_location = 324388750; * @return string @@ -1257,7 +1623,8 @@ public function clearRemoteLocation() } /** - * Indicates that this is a Cross-Cloud Interconnect. This field specifies the location outside of Google's network that the interconnect is connected to. + * Indicates that this is a Cross-Cloud Interconnect. This field specifies the + * location outside of Google's network that the interconnect is connected to. * * Generated from protobuf field optional string remote_location = 324388750; * @param string $var @@ -1272,7 +1639,15 @@ public function setRemoteLocation($var) } /** - * Optional. List of features requested for this Interconnect connection, which can take one of the following values: - IF_MACSEC If specified then the connection is created on MACsec capable hardware ports. If not specified, the default value is false, which allocates non-MACsec capable ports first if available. This parameter can be provided only with Interconnect INSERT. It isn't valid for Interconnect PATCH. + * Optional. This parameter can be provided only with Interconnect INSERT. It + * isn't valid for Interconnect PATCH. List of features requested for this + * Interconnect connection, which can take one of the following values: + * - IF_MACSEC: If specified, then the connection is created on MACsec + * capable hardware ports. If not specified, non-MACsec capable ports will + * also be considered. + * - IF_CROSS_SITE_NETWORK: If specified, then the connection is created + * exclusively for Cross-Site Networking. The connection can not be used for + * Cross-Site Networking unless this feature is specified. * Check the RequestedFeatures enum for the list of possible values. * * Generated from protobuf field repeated string requested_features = 461240814; @@ -1284,7 +1659,15 @@ public function getRequestedFeatures() } /** - * Optional. List of features requested for this Interconnect connection, which can take one of the following values: - IF_MACSEC If specified then the connection is created on MACsec capable hardware ports. If not specified, the default value is false, which allocates non-MACsec capable ports first if available. This parameter can be provided only with Interconnect INSERT. It isn't valid for Interconnect PATCH. + * Optional. This parameter can be provided only with Interconnect INSERT. It + * isn't valid for Interconnect PATCH. List of features requested for this + * Interconnect connection, which can take one of the following values: + * - IF_MACSEC: If specified, then the connection is created on MACsec + * capable hardware ports. If not specified, non-MACsec capable ports will + * also be considered. + * - IF_CROSS_SITE_NETWORK: If specified, then the connection is created + * exclusively for Cross-Site Networking. The connection can not be used for + * Cross-Site Networking unless this feature is specified. * Check the RequestedFeatures enum for the list of possible values. * * Generated from protobuf field repeated string requested_features = 461240814; @@ -1300,7 +1683,8 @@ public function setRequestedFeatures($var) } /** - * Target number of physical links in the link bundle, as requested by the customer. + * Target number of physical links in the link bundle, as requested by the + * customer. * * Generated from protobuf field optional int32 requested_link_count = 45051387; * @return int @@ -1321,7 +1705,8 @@ public function clearRequestedLinkCount() } /** - * Target number of physical links in the link bundle, as requested by the customer. + * Target number of physical links in the link bundle, as requested by the + * customer. * * Generated from protobuf field optional int32 requested_link_count = 45051387; * @param int $var @@ -1408,7 +1793,15 @@ public function setSelfLink($var) } /** - * [Output Only] The current state of Interconnect functionality, which can take one of the following values: - ACTIVE: The Interconnect is valid, turned up and ready to use. Attachments may be provisioned on this Interconnect. - UNPROVISIONED: The Interconnect has not completed turnup. No attachments may be provisioned on this Interconnect. - UNDER_MAINTENANCE: The Interconnect is undergoing internal maintenance. No attachments may be provisioned or updated on this Interconnect. + * [Output Only] The current state of Interconnect functionality, which can + * take one of the following values: + * - ACTIVE: The Interconnect is valid, turned up and ready to use. + * Attachments may be provisioned on this Interconnect. + * - UNPROVISIONED: The Interconnect has not completed turnup. No + * attachments may be provisioned on this Interconnect. + * - UNDER_MAINTENANCE: The Interconnect is undergoing internal maintenance. + * No attachments may be provisioned or updated on this + * Interconnect. * Check the State enum for the list of possible values. * * Generated from protobuf field optional string state = 109757585; @@ -1430,7 +1823,15 @@ public function clearState() } /** - * [Output Only] The current state of Interconnect functionality, which can take one of the following values: - ACTIVE: The Interconnect is valid, turned up and ready to use. Attachments may be provisioned on this Interconnect. - UNPROVISIONED: The Interconnect has not completed turnup. No attachments may be provisioned on this Interconnect. - UNDER_MAINTENANCE: The Interconnect is undergoing internal maintenance. No attachments may be provisioned or updated on this Interconnect. + * [Output Only] The current state of Interconnect functionality, which can + * take one of the following values: + * - ACTIVE: The Interconnect is valid, turned up and ready to use. + * Attachments may be provisioned on this Interconnect. + * - UNPROVISIONED: The Interconnect has not completed turnup. No + * attachments may be provisioned on this Interconnect. + * - UNDER_MAINTENANCE: The Interconnect is undergoing internal maintenance. + * No attachments may be provisioned or updated on this + * Interconnect. * Check the State enum for the list of possible values. * * Generated from protobuf field optional string state = 109757585; @@ -1446,7 +1847,8 @@ public function setState($var) } /** - * Specific subzone in the InterconnectLocation that represents where this connection is to be provisioned. + * Specific subzone in the InterconnectLocation that represents where + * this connection is to be provisioned. * Check the Subzone enum for the list of possible values. * * Generated from protobuf field optional string subzone = 280084972; @@ -1468,7 +1870,8 @@ public function clearSubzone() } /** - * Specific subzone in the InterconnectLocation that represents where this connection is to be provisioned. + * Specific subzone in the InterconnectLocation that represents where + * this connection is to be provisioned. * Check the Subzone enum for the list of possible values. * * Generated from protobuf field optional string subzone = 280084972; @@ -1483,5 +1886,35 @@ public function setSubzone($var) return $this; } + /** + * [Output Only] A list of the URLs of all CrossSiteNetwork WireGroups + * configured to use this Interconnect. The Interconnect cannot be deleted if + * this list is non-empty. + * + * Generated from protobuf field repeated string wire_groups = 40662734; + * @return \Google\Protobuf\Internal\RepeatedField + */ + public function getWireGroups() + { + return $this->wire_groups; + } + + /** + * [Output Only] A list of the URLs of all CrossSiteNetwork WireGroups + * configured to use this Interconnect. The Interconnect cannot be deleted if + * this list is non-empty. + * + * Generated from protobuf field repeated string wire_groups = 40662734; + * @param array|\Google\Protobuf\Internal\RepeatedField $var + * @return $this + */ + public function setWireGroups($var) + { + $arr = GPBUtil::checkRepeatedField($var, \Google\Protobuf\Internal\GPBType::STRING); + $this->wire_groups = $arr; + + return $this; + } + } diff --git a/Compute/src/V1/Interconnect/AvailableFeatures.php b/Compute/src/V1/Interconnect/AvailableFeatures.php index 5d72f242bec3..182963542e3f 100644 --- a/Compute/src/V1/Interconnect/AvailableFeatures.php +++ b/Compute/src/V1/Interconnect/AvailableFeatures.php @@ -9,6 +9,8 @@ /** * * Additional supported values which may be not listed in the enum directly due to technical reasons: + * IF_CROSS_SITE_NETWORK + * IF_L2_FORWARDING * IF_MACSEC * * Protobuf type google.cloud.compute.v1.Interconnect.AvailableFeatures diff --git a/Compute/src/V1/Interconnect/InterconnectType.php b/Compute/src/V1/Interconnect/InterconnectType.php index 96dc539d52c2..cf2c493e1399 100644 --- a/Compute/src/V1/Interconnect/InterconnectType.php +++ b/Compute/src/V1/Interconnect/InterconnectType.php @@ -7,7 +7,12 @@ use UnexpectedValueException; /** - * Type of interconnect, which can take one of the following values: - PARTNER: A partner-managed interconnection shared between customers though a partner. - DEDICATED: A dedicated physical interconnection with the customer. Note that a value IT_PRIVATE has been deprecated in favor of DEDICATED. + * Type of interconnect, which can take one of the following values: + * - PARTNER: A partner-managed interconnection shared between customers + * though a partner. + * - DEDICATED: A dedicated physical interconnection with the + * customer. + * Note that a value IT_PRIVATE has been deprecated in favor of DEDICATED. * * Protobuf type google.cloud.compute.v1.Interconnect.InterconnectType */ diff --git a/Compute/src/V1/Interconnect/LinkType.php b/Compute/src/V1/Interconnect/LinkType.php index 8be19463edbe..26ddada13b2b 100644 --- a/Compute/src/V1/Interconnect/LinkType.php +++ b/Compute/src/V1/Interconnect/LinkType.php @@ -7,7 +7,12 @@ use UnexpectedValueException; /** - * Type of link requested, which can take one of the following values: - LINK_TYPE_ETHERNET_10G_LR: A 10G Ethernet with LR optics - LINK_TYPE_ETHERNET_100G_LR: A 100G Ethernet with LR optics. - LINK_TYPE_ETHERNET_400G_LR4: A 400G Ethernet with LR4 optics. Note that this field indicates the speed of each of the links in the bundle, not the speed of the entire bundle. + * Type of link requested, which can take one of the following values: + * - LINK_TYPE_ETHERNET_10G_LR: A 10G Ethernet with LR optics + * - LINK_TYPE_ETHERNET_100G_LR: A 100G Ethernet with LR optics. + * - LINK_TYPE_ETHERNET_400G_LR4: A 400G Ethernet with LR4 optics. + * Note that this field indicates the speed of each of + * the links in the bundle, not the speed of the entire bundle. * * Protobuf type google.cloud.compute.v1.Interconnect.LinkType */ @@ -26,7 +31,8 @@ class LinkType */ const LINK_TYPE_ETHERNET_100G_LR = 337672551; /** - * 10G Ethernet, LR Optics. [(rate_bps) = 10000000000]; + * 10G Ethernet, LR Optics. + * [(rate_bps) = 10000000000]; * * Generated from protobuf enum LINK_TYPE_ETHERNET_10G_LR = 236739749; */ diff --git a/Compute/src/V1/Interconnect/OperationalStatus.php b/Compute/src/V1/Interconnect/OperationalStatus.php index 353b20eb0d29..43be0eada491 100644 --- a/Compute/src/V1/Interconnect/OperationalStatus.php +++ b/Compute/src/V1/Interconnect/OperationalStatus.php @@ -7,7 +7,15 @@ use UnexpectedValueException; /** - * [Output Only] The current status of this Interconnect's functionality, which can take one of the following values: - OS_ACTIVE: A valid Interconnect, which is turned up and is ready to use. Attachments may be provisioned on this Interconnect. - OS_UNPROVISIONED: An Interconnect that has not completed turnup. No attachments may be provisioned on this Interconnect. - OS_UNDER_MAINTENANCE: An Interconnect that is undergoing internal maintenance. No attachments may be provisioned or updated on this Interconnect. + * [Output Only] The current status of this Interconnect's functionality, + * which can take one of the following values: + * - OS_ACTIVE: A valid Interconnect, which is turned up and is ready to + * use. Attachments may be provisioned on this Interconnect. + * - OS_UNPROVISIONED: An Interconnect that has not completed turnup. No + * attachments may be provisioned on this Interconnect. + * - OS_UNDER_MAINTENANCE: An Interconnect that is undergoing internal + * maintenance. No attachments may be provisioned or updated on this + * Interconnect. * * Protobuf type google.cloud.compute.v1.Interconnect.OperationalStatus */ @@ -20,13 +28,15 @@ class OperationalStatus */ const UNDEFINED_OPERATIONAL_STATUS = 0; /** - * The interconnect is valid, turned up, and ready to use. Attachments may be provisioned on this interconnect. + * The interconnect is valid, turned up, and ready to use. Attachments may + * be provisioned on this interconnect. * * Generated from protobuf enum OS_ACTIVE = 55721409; */ const OS_ACTIVE = 55721409; /** - * The interconnect has not completed turnup. No attachments may be provisioned on this interconnect. + * The interconnect has not completed turnup. No attachments may be + * provisioned on this interconnect. * * Generated from protobuf enum OS_UNPROVISIONED = 239771840; */ diff --git a/Compute/src/V1/Interconnect/RequestedFeatures.php b/Compute/src/V1/Interconnect/RequestedFeatures.php index e119c5c568cb..86c8c679d521 100644 --- a/Compute/src/V1/Interconnect/RequestedFeatures.php +++ b/Compute/src/V1/Interconnect/RequestedFeatures.php @@ -9,6 +9,8 @@ /** * * Additional supported values which may be not listed in the enum directly due to technical reasons: + * IF_CROSS_SITE_NETWORK + * IF_L2_FORWARDING * IF_MACSEC * * Protobuf type google.cloud.compute.v1.Interconnect.RequestedFeatures diff --git a/Compute/src/V1/Interconnect/State.php b/Compute/src/V1/Interconnect/State.php index 6622b8309dcb..f8d69a001a3c 100644 --- a/Compute/src/V1/Interconnect/State.php +++ b/Compute/src/V1/Interconnect/State.php @@ -7,7 +7,15 @@ use UnexpectedValueException; /** - * [Output Only] The current state of Interconnect functionality, which can take one of the following values: - ACTIVE: The Interconnect is valid, turned up and ready to use. Attachments may be provisioned on this Interconnect. - UNPROVISIONED: The Interconnect has not completed turnup. No attachments may be provisioned on this Interconnect. - UNDER_MAINTENANCE: The Interconnect is undergoing internal maintenance. No attachments may be provisioned or updated on this Interconnect. + * [Output Only] The current state of Interconnect functionality, which can + * take one of the following values: + * - ACTIVE: The Interconnect is valid, turned up and ready to use. + * Attachments may be provisioned on this Interconnect. + * - UNPROVISIONED: The Interconnect has not completed turnup. No + * attachments may be provisioned on this Interconnect. + * - UNDER_MAINTENANCE: The Interconnect is undergoing internal maintenance. + * No attachments may be provisioned or updated on this + * Interconnect. * * Protobuf type google.cloud.compute.v1.Interconnect.State */ @@ -20,13 +28,15 @@ class State */ const UNDEFINED_STATE = 0; /** - * The interconnect is valid, turned up, and ready to use. Attachments may be provisioned on this interconnect. + * The interconnect is valid, turned up, and ready to use. Attachments may + * be provisioned on this interconnect. * * Generated from protobuf enum ACTIVE = 314733318; */ const ACTIVE = 314733318; /** - * The interconnect has not completed turnup. No attachments may be provisioned on this interconnect. + * The interconnect has not completed turnup. No attachments may be + * provisioned on this interconnect. * * Generated from protobuf enum UNPROVISIONED = 517333979; */ diff --git a/Compute/src/V1/Interconnect/Subzone.php b/Compute/src/V1/Interconnect/Subzone.php index 4232f2229f8f..35929445cc90 100644 --- a/Compute/src/V1/Interconnect/Subzone.php +++ b/Compute/src/V1/Interconnect/Subzone.php @@ -7,7 +7,8 @@ use UnexpectedValueException; /** - * Specific subzone in the InterconnectLocation that represents where this connection is to be provisioned. + * Specific subzone in the InterconnectLocation that represents where + * this connection is to be provisioned. * * Protobuf type google.cloud.compute.v1.Interconnect.Subzone */ diff --git a/Compute/src/V1/InterconnectApplicationAwareInterconnect.php b/Compute/src/V1/InterconnectApplicationAwareInterconnect.php index 81b7b52662c2..5a008da4d559 100644 --- a/Compute/src/V1/InterconnectApplicationAwareInterconnect.php +++ b/Compute/src/V1/InterconnectApplicationAwareInterconnect.php @@ -9,7 +9,8 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Configuration information for application awareness on this Cloud Interconnect. + * Configuration information for application awareness on this Cloud + * Interconnect. * * Generated from protobuf message google.cloud.compute.v1.InterconnectApplicationAwareInterconnect */ @@ -20,13 +21,16 @@ class InterconnectApplicationAwareInterconnect extends \Google\Protobuf\Internal */ protected $bandwidth_percentage_policy = null; /** - * Description for the application awareness profile on this Cloud Interconnect. + * Description for the application awareness profile on this Cloud + * Interconnect. * * Generated from protobuf field optional string profile_description = 262813286; */ protected $profile_description = null; /** - * Optional field to specify a list of shape average percentages to be applied in conjunction with StrictPriorityPolicy or BandwidthPercentagePolicy. + * Optional field to specify a list of shape average percentages to be + * applied in conjunction with StrictPriorityPolicy or + * BandwidthPercentagePolicy. * * Generated from protobuf field repeated .google.cloud.compute.v1.InterconnectApplicationAwareInterconnectBandwidthPercentage shape_average_percentages = 259857497; */ @@ -44,9 +48,12 @@ class InterconnectApplicationAwareInterconnect extends \Google\Protobuf\Internal * * @type \Google\Cloud\Compute\V1\InterconnectApplicationAwareInterconnectBandwidthPercentagePolicy $bandwidth_percentage_policy * @type string $profile_description - * Description for the application awareness profile on this Cloud Interconnect. + * Description for the application awareness profile on this Cloud + * Interconnect. * @type array<\Google\Cloud\Compute\V1\InterconnectApplicationAwareInterconnectBandwidthPercentage>|\Google\Protobuf\Internal\RepeatedField $shape_average_percentages - * Optional field to specify a list of shape average percentages to be applied in conjunction with StrictPriorityPolicy or BandwidthPercentagePolicy. + * Optional field to specify a list of shape average percentages to be + * applied in conjunction with StrictPriorityPolicy or + * BandwidthPercentagePolicy. * @type \Google\Cloud\Compute\V1\InterconnectApplicationAwareInterconnectStrictPriorityPolicy $strict_priority_policy * } */ @@ -88,7 +95,8 @@ public function setBandwidthPercentagePolicy($var) } /** - * Description for the application awareness profile on this Cloud Interconnect. + * Description for the application awareness profile on this Cloud + * Interconnect. * * Generated from protobuf field optional string profile_description = 262813286; * @return string @@ -109,7 +117,8 @@ public function clearProfileDescription() } /** - * Description for the application awareness profile on this Cloud Interconnect. + * Description for the application awareness profile on this Cloud + * Interconnect. * * Generated from protobuf field optional string profile_description = 262813286; * @param string $var @@ -124,7 +133,9 @@ public function setProfileDescription($var) } /** - * Optional field to specify a list of shape average percentages to be applied in conjunction with StrictPriorityPolicy or BandwidthPercentagePolicy. + * Optional field to specify a list of shape average percentages to be + * applied in conjunction with StrictPriorityPolicy or + * BandwidthPercentagePolicy. * * Generated from protobuf field repeated .google.cloud.compute.v1.InterconnectApplicationAwareInterconnectBandwidthPercentage shape_average_percentages = 259857497; * @return \Google\Protobuf\Internal\RepeatedField @@ -135,7 +146,9 @@ public function getShapeAveragePercentages() } /** - * Optional field to specify a list of shape average percentages to be applied in conjunction with StrictPriorityPolicy or BandwidthPercentagePolicy. + * Optional field to specify a list of shape average percentages to be + * applied in conjunction with StrictPriorityPolicy or + * BandwidthPercentagePolicy. * * Generated from protobuf field repeated .google.cloud.compute.v1.InterconnectApplicationAwareInterconnectBandwidthPercentage shape_average_percentages = 259857497; * @param array<\Google\Cloud\Compute\V1\InterconnectApplicationAwareInterconnectBandwidthPercentage>|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/InterconnectApplicationAwareInterconnectBandwidthPercentage.php b/Compute/src/V1/InterconnectApplicationAwareInterconnectBandwidthPercentage.php index 0f4964a41735..c0694a914134 100644 --- a/Compute/src/V1/InterconnectApplicationAwareInterconnectBandwidthPercentage.php +++ b/Compute/src/V1/InterconnectApplicationAwareInterconnectBandwidthPercentage.php @@ -9,7 +9,9 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Specify bandwidth percentages [1-100] for various traffic classes in BandwidthPercentagePolicy. The sum of all percentages must equal 100. All traffic classes must have a percentage value specified. + * Specify bandwidth percentages [1-100] for various traffic classes in + * BandwidthPercentagePolicy. The sum of all percentages must equal 100. + * All traffic classes must have a percentage value specified. * * Generated from protobuf message google.cloud.compute.v1.InterconnectApplicationAwareInterconnectBandwidthPercentage */ diff --git a/Compute/src/V1/InterconnectApplicationAwareInterconnectBandwidthPercentagePolicy.php b/Compute/src/V1/InterconnectApplicationAwareInterconnectBandwidthPercentagePolicy.php index 793c4f22b7c0..3313a024a9bc 100644 --- a/Compute/src/V1/InterconnectApplicationAwareInterconnectBandwidthPercentagePolicy.php +++ b/Compute/src/V1/InterconnectApplicationAwareInterconnectBandwidthPercentagePolicy.php @@ -15,7 +15,8 @@ class InterconnectApplicationAwareInterconnectBandwidthPercentagePolicy extends \Google\Protobuf\Internal\Message { /** - * Specify bandwidth percentages for various traffic classes for queuing type Bandwidth Percent. + * Specify bandwidth percentages for various traffic classes for queuing + * type Bandwidth Percent. * * Generated from protobuf field repeated .google.cloud.compute.v1.InterconnectApplicationAwareInterconnectBandwidthPercentage bandwidth_percentages = 233373323; */ @@ -28,7 +29,8 @@ class InterconnectApplicationAwareInterconnectBandwidthPercentagePolicy extends * Optional. Data for populating the Message object. * * @type array<\Google\Cloud\Compute\V1\InterconnectApplicationAwareInterconnectBandwidthPercentage>|\Google\Protobuf\Internal\RepeatedField $bandwidth_percentages - * Specify bandwidth percentages for various traffic classes for queuing type Bandwidth Percent. + * Specify bandwidth percentages for various traffic classes for queuing + * type Bandwidth Percent. * } */ public function __construct($data = NULL) { @@ -37,7 +39,8 @@ public function __construct($data = NULL) { } /** - * Specify bandwidth percentages for various traffic classes for queuing type Bandwidth Percent. + * Specify bandwidth percentages for various traffic classes for queuing + * type Bandwidth Percent. * * Generated from protobuf field repeated .google.cloud.compute.v1.InterconnectApplicationAwareInterconnectBandwidthPercentage bandwidth_percentages = 233373323; * @return \Google\Protobuf\Internal\RepeatedField @@ -48,7 +51,8 @@ public function getBandwidthPercentages() } /** - * Specify bandwidth percentages for various traffic classes for queuing type Bandwidth Percent. + * Specify bandwidth percentages for various traffic classes for queuing + * type Bandwidth Percent. * * Generated from protobuf field repeated .google.cloud.compute.v1.InterconnectApplicationAwareInterconnectBandwidthPercentage bandwidth_percentages = 233373323; * @param array<\Google\Cloud\Compute\V1\InterconnectApplicationAwareInterconnectBandwidthPercentage>|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/InterconnectAttachment.php b/Compute/src/V1/InterconnectAttachment.php index 285759159fcc..be47b999b3eb 100644 --- a/Compute/src/V1/InterconnectAttachment.php +++ b/Compute/src/V1/InterconnectAttachment.php @@ -9,14 +9,19 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Represents an Interconnect Attachment (VLAN) resource. You can use Interconnect attachments (VLANS) to connect your Virtual Private Cloud networks to your on-premises networks through an Interconnect. For more information, read Creating VLAN Attachments. + * Represents an Interconnect Attachment (VLAN) resource. + * You can use Interconnect attachments (VLANS) to connect your Virtual Private + * Cloud networks to your on-premises networks through an Interconnect. + * For more information, read + * Creating VLAN Attachments. * * Generated from protobuf message google.cloud.compute.v1.InterconnectAttachment */ class InterconnectAttachment extends \Google\Protobuf\Internal\Message { /** - * Determines whether this Attachment will carry packets. Not present for PARTNER_PROVIDER. + * Determines whether this Attachment will carry packets. + * Not present for PARTNER_PROVIDER. * * Generated from protobuf field optional bool admin_enabled = 445675089; */ @@ -28,7 +33,25 @@ class InterconnectAttachment extends \Google\Protobuf\Internal\Message */ protected $attachment_group = null; /** - * Provisioned bandwidth capacity for the interconnect attachment. For attachments of type DEDICATED, the user can set the bandwidth. For attachments of type PARTNER, the Google Partner that is operating the interconnect must set the bandwidth. Output only for PARTNER type, mutable for PARTNER_PROVIDER and DEDICATED, and can take one of the following values: - BPS_50M: 50 Mbit/s - BPS_100M: 100 Mbit/s - BPS_200M: 200 Mbit/s - BPS_300M: 300 Mbit/s - BPS_400M: 400 Mbit/s - BPS_500M: 500 Mbit/s - BPS_1G: 1 Gbit/s - BPS_2G: 2 Gbit/s - BPS_5G: 5 Gbit/s - BPS_10G: 10 Gbit/s - BPS_20G: 20 Gbit/s - BPS_50G: 50 Gbit/s - BPS_100G: 100 Gbit/s + * Provisioned bandwidth capacity for the interconnect attachment. For + * attachments of type DEDICATED, the user can set the bandwidth. + * For attachments of type PARTNER, the Google Partner that is operating + * the interconnect must set the bandwidth. + * Output only for PARTNER type, mutable for PARTNER_PROVIDER and DEDICATED, + * and can take one of the following values: + * - BPS_50M: 50 Mbit/s + * - BPS_100M: 100 Mbit/s + * - BPS_200M: 200 Mbit/s + * - BPS_300M: 300 Mbit/s + * - BPS_400M: 400 Mbit/s + * - BPS_500M: 500 Mbit/s + * - BPS_1G: 1 Gbit/s + * - BPS_2G: 2 Gbit/s + * - BPS_5G: 5 Gbit/s + * - BPS_10G: 10 Gbit/s + * - BPS_20G: 20 Gbit/s + * - BPS_50G: 50 Gbit/s + * - BPS_100G: 100 Gbit/s * Check the Bandwidth enum for the list of possible values. * * Generated from protobuf field optional string bandwidth = 181715121; @@ -41,19 +64,27 @@ class InterconnectAttachment extends \Google\Protobuf\Internal\Message */ private $candidate_ipv6_subnets; /** - * Input only. Up to 16 candidate prefixes that can be used to restrict the allocation of cloudRouterIpAddress and customerRouterIpAddress for this attachment. All prefixes must be within link-local address space (169.254.0.0/16) and must be /29 or shorter (/28, /27, etc). Google will attempt to select an unused /29 from the supplied candidate prefix(es). The request will fail if all possible /29s are in use on Google's edge. If not supplied, Google will randomly select an unused /29 from all of link-local space. + * Input only. Up to 16 candidate prefixes that can be used to restrict the allocation + * of cloudRouterIpAddress and customerRouterIpAddress for this attachment. + * All prefixes must be within link-local address space (169.254.0.0/16) and + * must be /29 or shorter (/28, /27, etc). Google will attempt to select an + * unused /29 from the supplied candidate prefix(es). The request will fail if + * all possible /29s are in use on Google's edge. If not supplied, Google will + * randomly select an unused /29 from all of link-local space. * * Generated from protobuf field repeated string candidate_subnets = 237842938; */ private $candidate_subnets; /** - * [Output Only] IPv4 address + prefix length to be configured on Cloud Router Interface for this interconnect attachment. + * [Output Only] IPv4 address + prefix length to be configured on Cloud Router + * Interface for this interconnect attachment. * * Generated from protobuf field optional string cloud_router_ip_address = 287392776; */ protected $cloud_router_ip_address = null; /** - * [Output Only] IPv6 address + prefix length to be configured on Cloud Router Interface for this interconnect attachment. + * [Output Only] IPv6 address + prefix length to be configured on Cloud + * Router Interface for this interconnect attachment. * * Generated from protobuf field optional string cloud_router_ipv6_address = 451922376; */ @@ -65,25 +96,29 @@ class InterconnectAttachment extends \Google\Protobuf\Internal\Message */ protected $cloud_router_ipv6_interface_id = null; /** - * [Output Only] Constraints for this attachment, if any. The attachment does not work if these constraints are not met. + * [Output Only] Constraints for this attachment, if any. The attachment does + * not work if these constraints are not met. * * Generated from protobuf field optional .google.cloud.compute.v1.InterconnectAttachmentConfigurationConstraints configuration_constraints = 179681389; */ protected $configuration_constraints = null; /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; */ protected $creation_timestamp = null; /** - * [Output Only] IPv4 address + prefix length to be configured on the customer router subinterface for this interconnect attachment. + * [Output Only] IPv4 address + prefix length to be configured on the customer + * router subinterface for this interconnect attachment. * * Generated from protobuf field optional string customer_router_ip_address = 332475761; */ protected $customer_router_ip_address = null; /** - * [Output Only] IPv6 address + prefix length to be configured on the customer router subinterface for this interconnect attachment. + * [Output Only] IPv6 address + prefix length to be configured on the + * customer router subinterface for this interconnect attachment. * * Generated from protobuf field optional string customer_router_ipv6_address = 290127089; */ @@ -95,7 +130,9 @@ class InterconnectAttachment extends \Google\Protobuf\Internal\Message */ protected $customer_router_ipv6_interface_id = null; /** - * [Output Only] Dataplane version for this InterconnectAttachment. This field is only present for Dataplane version 2 and higher. Absence of this field in the API output indicates that the Dataplane is version 1. + * [Output Only] Dataplane version for this InterconnectAttachment. This + * field is only present for Dataplane version 2 and higher. Absence of this + * field in the API output indicates that the Dataplane is version 1. * * Generated from protobuf field optional int32 dataplane_version = 34920075; */ @@ -107,118 +144,220 @@ class InterconnectAttachment extends \Google\Protobuf\Internal\Message */ protected $description = null; /** - * Input only. Desired availability domain for the attachment. Only available for type PARTNER, at creation time, and can take one of the following values: - AVAILABILITY_DOMAIN_ANY - AVAILABILITY_DOMAIN_1 - AVAILABILITY_DOMAIN_2 For improved reliability, customers should configure a pair of attachments, one per availability domain. The selected availability domain will be provided to the Partner via the pairing key, so that the provisioned circuit will lie in the specified domain. If not specified, the value will default to AVAILABILITY_DOMAIN_ANY. + * Input only. Desired availability domain for the attachment. Only available for type + * PARTNER, at creation time, and can take one of the following values: + * - AVAILABILITY_DOMAIN_ANY + * - AVAILABILITY_DOMAIN_1 + * - AVAILABILITY_DOMAIN_2 + * For improved reliability, customers should configure a pair of attachments, + * one per availability domain. The selected availability domain will be + * provided to the Partner via the pairing key, so that the provisioned + * circuit will lie in the specified domain. If not specified, the value will + * default to AVAILABILITY_DOMAIN_ANY. * Check the EdgeAvailabilityDomain enum for the list of possible values. * * Generated from protobuf field optional string edge_availability_domain = 71289510; */ protected $edge_availability_domain = null; /** - * Indicates the user-supplied encryption option of this VLAN attachment (interconnectAttachment). Can only be specified at attachment creation for PARTNER or DEDICATED attachments. Possible values are: - NONE - This is the default value, which means that the VLAN attachment carries unencrypted traffic. VMs are able to send traffic to, or receive traffic from, such a VLAN attachment. - IPSEC - The VLAN attachment carries only encrypted traffic that is encrypted by an IPsec device, such as an HA VPN gateway or third-party IPsec VPN. VMs cannot directly send traffic to, or receive traffic from, such a VLAN attachment. To use *HA VPN over Cloud Interconnect*, the VLAN attachment must be created with this option. + * Indicates the user-supplied encryption option of this VLAN attachment + * (interconnectAttachment). Can only be specified at attachment creation + * for PARTNER or DEDICATED attachments. + * Possible values are: + * - NONE - This is the default value, which means that the + * VLAN attachment carries unencrypted traffic. VMs are able to send + * traffic to, or receive traffic from, such a VLAN attachment. + * - IPSEC - The VLAN attachment carries only encrypted + * traffic that is encrypted by an IPsec device, such as an HA VPN gateway or + * third-party IPsec VPN. VMs cannot directly send traffic to, or receive + * traffic from, such a VLAN attachment. To use *HA VPN over Cloud + * Interconnect*, the VLAN attachment must be created with this + * option. * Check the Encryption enum for the list of possible values. * * Generated from protobuf field optional string encryption = 97980291; */ protected $encryption = null; /** - * [Output Only] Google reference ID, to be used when raising support tickets with Google or otherwise to debug backend connectivity issues. [Deprecated] This field is not used. + * [Output Only] Google reference ID, to be used when raising support tickets + * with Google or otherwise to debug backend connectivity issues. + * [Deprecated] This field is not used. * * Generated from protobuf field optional string google_reference_id = 534944469; */ protected $google_reference_id = null; /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; */ protected $id = null; /** - * URL of the underlying Interconnect object that this attachment's traffic will traverse through. + * URL of the underlying Interconnect object that this attachment's traffic + * will traverse through. * * Generated from protobuf field optional string interconnect = 224601230; */ protected $interconnect = null; /** - * A list of URLs of addresses that have been reserved for the VLAN attachment. Used only for the VLAN attachment that has the encryption option as IPSEC. The addresses must be regional internal IP address ranges. When creating an HA VPN gateway over the VLAN attachment, if the attachment is configured to use a regional internal IP address, then the VPN gateway's IP address is allocated from the IP address range specified here. For example, if the HA VPN gateway's interface 0 is paired to this VLAN attachment, then a regional internal IP address for the VPN gateway interface 0 will be allocated from the IP address specified for this VLAN attachment. If this field is not specified when creating the VLAN attachment, then later on when creating an HA VPN gateway on this VLAN attachment, the HA VPN gateway's IP address is allocated from the regional external IP address pool. + * A list of URLs of addresses that have been reserved for the VLAN + * attachment. Used only for the VLAN attachment that has the encryption + * option as IPSEC. The addresses must be regional internal IP address ranges. + * When creating an HA VPN gateway over the VLAN attachment, if the attachment + * is configured to use a regional internal IP address, then the VPN gateway's + * IP address is allocated from the IP address range specified here. For + * example, if the HA VPN gateway's interface 0 is paired to this VLAN + * attachment, then a regional internal IP address for the VPN gateway + * interface 0 will be allocated from the IP address specified for this + * VLAN attachment. + * If this field is not specified when creating the VLAN attachment, then + * later on when creating an HA VPN gateway on this VLAN attachment, the HA + * VPN gateway's IP address is allocated from the regional external IP address + * pool. * * Generated from protobuf field repeated string ipsec_internal_addresses = 407648565; */ private $ipsec_internal_addresses; /** - * [Output Only] Type of the resource. Always compute#interconnectAttachment for interconnect attachments. + * [Output Only] Type of the resource. Alwayscompute#interconnectAttachment for interconnect attachments. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * A fingerprint for the labels being applied to this InterconnectAttachment, which is essentially a hash of the labels set used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve an InterconnectAttachment. + * L2 Interconnect Attachment related config. This field is required if the + * type is L2_DEDICATED. + * The configuration specifies how VLAN tags (like dot1q, qinq, or dot1ad) + * within L2 packets are mapped to the destination appliances IP addresses. + * The packet is then encapsulated with the appliance IP address and sent to + * the edge appliance. + * + * Generated from protobuf field optional .google.cloud.compute.v1.InterconnectAttachmentL2Forwarding l2_forwarding = 84784022; + */ + protected $l2_forwarding = null; + /** + * A fingerprint for the labels being applied to this InterconnectAttachment, + * which is essentially a hash of the labels set used for optimistic locking. + * The fingerprint is initially generated by Compute Engine and changes after + * every request to modify or update labels. You must always provide an + * up-to-date fingerprint hash in order to update or change labels, + * otherwise the request will fail with error412 conditionNotMet. + * To see the latest fingerprint, make a get() request to + * retrieve an InterconnectAttachment. * * Generated from protobuf field optional string label_fingerprint = 178124825; */ protected $label_fingerprint = null; /** - * Labels for this resource. These can only be added or modified by the setLabels method. Each label key/value pair must comply with RFC1035. Label values may be empty. + * Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035. + * Label values may be empty. * * Generated from protobuf field map labels = 500195327; */ private $labels; /** - * Maximum Transmission Unit (MTU), in bytes, of packets passing through this interconnect attachment. Valid values are 1440, 1460, 1500, and 8896. If not specified, the value will default to 1440. + * Maximum Transmission Unit (MTU), in bytes, of packets passing through this + * interconnect attachment. + * Valid values are 1440, 1460, 1500, and 8896. If not specified, + * the value will default to 1440. * * Generated from protobuf field optional int32 mtu = 108462; */ protected $mtu = null; /** - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * * Generated from protobuf field optional string name = 3373707; */ protected $name = null; /** - * [Output Only] The current status of whether or not this interconnect attachment is functional, which can take one of the following values: - OS_ACTIVE: The attachment has been turned up and is ready to use. - OS_UNPROVISIONED: The attachment is not ready to use yet, because turnup is not complete. + * [Output Only] The current status of whether or not this interconnect + * attachment is functional, which can take one of the following values: + * - OS_ACTIVE: The attachment has been turned up and is ready to + * use. + * - OS_UNPROVISIONED: The attachment is not ready to use yet, + * because turnup is not complete. * Check the OperationalStatus enum for the list of possible values. * * Generated from protobuf field optional string operational_status = 201070847; */ protected $operational_status = null; /** - * [Output only for type PARTNER. Input only for PARTNER_PROVIDER. Not present for DEDICATED]. The opaque identifier of a PARTNER attachment used to initiate provisioning with a selected partner. Of the form "XXXXX/region/domain" + * [Output only for type PARTNER. Input only for PARTNER_PROVIDER. Not + * present for DEDICATED]. + * The opaque identifier of a PARTNER attachment used to initiate + * provisioning with a selected partner. + * Of the form "XXXXX/region/domain" * * Generated from protobuf field optional string pairing_key = 439695464; */ protected $pairing_key = null; /** - * Optional BGP ASN for the router supplied by a Layer 3 Partner if they configured BGP on behalf of the customer. Output only for PARTNER type, input only for PARTNER_PROVIDER, not available for DEDICATED. + * Input only. [Input Only] Additional params passed with the request, but not persisted + * as part of resource payload. + * + * Generated from protobuf field optional .google.cloud.compute.v1.InterconnectAttachmentParams params = 78313862; + */ + protected $params = null; + /** + * Optional BGP ASN for the router supplied by a Layer 3 Partner if they + * configured BGP on behalf of the customer. + * Output only for PARTNER type, input only for PARTNER_PROVIDER, not + * available for DEDICATED. * * Generated from protobuf field optional int64 partner_asn = 438166149; */ protected $partner_asn = null; /** - * Informational metadata about Partner attachments from Partners to display to customers. Output only for PARTNER type, mutable for PARTNER_PROVIDER, not available for DEDICATED. + * Informational metadata about Partner attachments from Partners to display + * to customers. + * Output only for PARTNER type, mutable for PARTNER_PROVIDER, not + * available for DEDICATED. * * Generated from protobuf field optional .google.cloud.compute.v1.InterconnectAttachmentPartnerMetadata partner_metadata = 65908934; */ protected $partner_metadata = null; /** - * [Output Only] Information specific to an InterconnectAttachment. This property is populated if the interconnect that this is attached to is of type DEDICATED. + * [Output Only] Information specific to an InterconnectAttachment. + * This property is populated if the interconnect that + * this is attached to is of type DEDICATED. * * Generated from protobuf field optional .google.cloud.compute.v1.InterconnectAttachmentPrivateInfo private_interconnect_info = 237270531; */ protected $private_interconnect_info = null; /** - * [Output Only] URL of the region where the regional interconnect attachment resides. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * [Output Only] URL of the region where the regional interconnect attachment + * resides. + * You must specify this field as part of the HTTP request URL. It is + * not settable as a field in the request body. * * Generated from protobuf field optional string region = 138946292; */ protected $region = null; /** - * [Output Only] If the attachment is on a Cross-Cloud Interconnect connection, this field contains the interconnect's remote location service provider. Example values: "Amazon Web Services" "Microsoft Azure". The field is set only for attachments on Cross-Cloud Interconnect connections. Its value is copied from the InterconnectRemoteLocation remoteService field. + * [Output Only] + * If the attachment is on a Cross-Cloud Interconnect connection, this field + * contains the interconnect's remote location service provider. Example + * values: "Amazon Web Services" "Microsoft Azure". + * The field is set only for attachments on Cross-Cloud Interconnect + * connections. Its value is copied from the InterconnectRemoteLocation + * remoteService field. * * Generated from protobuf field optional string remote_service = 391954364; */ protected $remote_service = null; /** - * URL of the Cloud Router to be used for dynamic routing. This router must be in the same region as this InterconnectAttachment. The InterconnectAttachment will automatically connect the Interconnect to the network & region within which the Cloud Router is configured. + * URL of the Cloud Router to be used for dynamic routing. This router must be + * in the same region as this InterconnectAttachment. The + * InterconnectAttachment will automatically connect the Interconnect to the + * network & region within which the Cloud Router is configured. * * Generated from protobuf field optional string router = 148608841; */ @@ -236,34 +375,76 @@ class InterconnectAttachment extends \Google\Protobuf\Internal\Message */ protected $self_link = null; /** - * The stack type for this interconnect attachment to identify whether the IPv6 feature is enabled or not. If not specified, IPV4_ONLY will be used. This field can be both set at interconnect attachments creation and update interconnect attachment operations. + * The stack type for this interconnect attachment to identify whether the + * IPv6 feature is enabled or not. If not specified, IPV4_ONLY + * will be used. + * This field can be both set at interconnect attachments creation and + * update interconnect attachment operations. * Check the StackType enum for the list of possible values. * * Generated from protobuf field optional string stack_type = 425908881; */ protected $stack_type = null; /** - * [Output Only] The current state of this attachment's functionality. Enum values ACTIVE and UNPROVISIONED are shared by DEDICATED/PRIVATE, PARTNER, and PARTNER_PROVIDER interconnect attachments, while enum values PENDING_PARTNER, PARTNER_REQUEST_RECEIVED, and PENDING_CUSTOMER are used for only PARTNER and PARTNER_PROVIDER interconnect attachments. This state can take one of the following values: - ACTIVE: The attachment has been turned up and is ready to use. - UNPROVISIONED: The attachment is not ready to use yet, because turnup is not complete. - PENDING_PARTNER: A newly-created PARTNER attachment that has not yet been configured on the Partner side. - PARTNER_REQUEST_RECEIVED: A PARTNER attachment is in the process of provisioning after a PARTNER_PROVIDER attachment was created that references it. - PENDING_CUSTOMER: A PARTNER or PARTNER_PROVIDER attachment that is waiting for a customer to activate it. - DEFUNCT: The attachment was deleted externally and is no longer functional. This could be because the associated Interconnect was removed, or because the other side of a Partner attachment was deleted. + * [Output Only] The current state of this attachment's functionality. + * Enum values ACTIVE and UNPROVISIONED are shared by DEDICATED/PRIVATE, + * PARTNER, and PARTNER_PROVIDER interconnect attachments, while enum values + * PENDING_PARTNER, PARTNER_REQUEST_RECEIVED, and PENDING_CUSTOMER are used + * for only PARTNER and PARTNER_PROVIDER interconnect attachments. + * This state can take one of the following values: + * - ACTIVE: The attachment has been turned up and is ready to use. + * - UNPROVISIONED: The attachment is not ready to use yet, because turnup + * is not complete. + * - PENDING_PARTNER: A newly-created PARTNER attachment that has not yet + * been configured on the Partner side. + * - PARTNER_REQUEST_RECEIVED: A PARTNER attachment is in the process of + * provisioning after a PARTNER_PROVIDER attachment was created that + * references it. + * - PENDING_CUSTOMER: A PARTNER or PARTNER_PROVIDER + * attachment that is waiting for a customer to activate it. + * - DEFUNCT: + * The attachment was deleted externally and is no longer functional. This + * could be because the associated Interconnect was removed, or because the + * other side of a Partner attachment was deleted. * Check the State enum for the list of possible values. * * Generated from protobuf field optional string state = 109757585; */ protected $state = null; /** - * Input only. Length of the IPv4 subnet mask. Allowed values: - 29 (default) - 30 The default value is 29, except for Cross-Cloud Interconnect connections that use an InterconnectRemoteLocation with a constraints.subnetLengthRange.min equal to 30. For example, connections that use an Azure remote location fall into this category. In these cases, the default value is 30, and requesting 29 returns an error. Where both 29 and 30 are allowed, 29 is preferred, because it gives Google Cloud Support more debugging visibility. + * Input only. Length of the IPv4 subnet mask. + * Allowed values: + * - 29 (default) + * - 30 + * The default value is 29, except for Cross-Cloud Interconnect + * connections that use an InterconnectRemoteLocation with a + * constraints.subnetLengthRange.min equal to 30. For example, + * connections that use an Azure remote location fall into this + * category. In these cases, the default value is 30, and requesting + * 29 returns an error. + * Where both 29 and 30 are allowed, 29 is preferred, because it gives + * Google Cloud Support more debugging visibility. * * Generated from protobuf field optional int32 subnet_length = 279831048; */ protected $subnet_length = null; /** - * The type of interconnect attachment this is, which can take one of the following values: - DEDICATED: an attachment to a Dedicated Interconnect. - PARTNER: an attachment to a Partner Interconnect, created by the customer. - PARTNER_PROVIDER: an attachment to a Partner Interconnect, created by the partner. + * The type of interconnect attachment this is, which can take one of the + * following values: + * - DEDICATED: an attachment to a Dedicated Interconnect. + * - PARTNER: an attachment to a Partner Interconnect, created by the + * customer. + * - PARTNER_PROVIDER: an attachment to a Partner Interconnect, created by + * the partner. + * - L2_DEDICATED: a L2 attachment to a Dedicated Interconnect. * Check the Type enum for the list of possible values. * * Generated from protobuf field optional string type = 3575610; */ protected $type = null; /** - * The IEEE 802.1Q VLAN tag for this attachment, in the range 2-4093. Only specified at creation time. + * The IEEE 802.1Q VLAN tag for this attachment, in the range 2-4093. + * Only specified at creation time. * * Generated from protobuf field optional int32 vlan_tag8021q = 119927836; */ @@ -276,94 +457,263 @@ class InterconnectAttachment extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type bool $admin_enabled - * Determines whether this Attachment will carry packets. Not present for PARTNER_PROVIDER. + * Determines whether this Attachment will carry packets. + * Not present for PARTNER_PROVIDER. * @type string $attachment_group * [Output Only] URL of the AttachmentGroup that includes this Attachment. * @type string $bandwidth - * Provisioned bandwidth capacity for the interconnect attachment. For attachments of type DEDICATED, the user can set the bandwidth. For attachments of type PARTNER, the Google Partner that is operating the interconnect must set the bandwidth. Output only for PARTNER type, mutable for PARTNER_PROVIDER and DEDICATED, and can take one of the following values: - BPS_50M: 50 Mbit/s - BPS_100M: 100 Mbit/s - BPS_200M: 200 Mbit/s - BPS_300M: 300 Mbit/s - BPS_400M: 400 Mbit/s - BPS_500M: 500 Mbit/s - BPS_1G: 1 Gbit/s - BPS_2G: 2 Gbit/s - BPS_5G: 5 Gbit/s - BPS_10G: 10 Gbit/s - BPS_20G: 20 Gbit/s - BPS_50G: 50 Gbit/s - BPS_100G: 100 Gbit/s + * Provisioned bandwidth capacity for the interconnect attachment. For + * attachments of type DEDICATED, the user can set the bandwidth. + * For attachments of type PARTNER, the Google Partner that is operating + * the interconnect must set the bandwidth. + * Output only for PARTNER type, mutable for PARTNER_PROVIDER and DEDICATED, + * and can take one of the following values: + * - BPS_50M: 50 Mbit/s + * - BPS_100M: 100 Mbit/s + * - BPS_200M: 200 Mbit/s + * - BPS_300M: 300 Mbit/s + * - BPS_400M: 400 Mbit/s + * - BPS_500M: 500 Mbit/s + * - BPS_1G: 1 Gbit/s + * - BPS_2G: 2 Gbit/s + * - BPS_5G: 5 Gbit/s + * - BPS_10G: 10 Gbit/s + * - BPS_20G: 20 Gbit/s + * - BPS_50G: 50 Gbit/s + * - BPS_100G: 100 Gbit/s * Check the Bandwidth enum for the list of possible values. * @type array|\Google\Protobuf\Internal\RepeatedField $candidate_ipv6_subnets * This field is not available. * @type array|\Google\Protobuf\Internal\RepeatedField $candidate_subnets - * Input only. Up to 16 candidate prefixes that can be used to restrict the allocation of cloudRouterIpAddress and customerRouterIpAddress for this attachment. All prefixes must be within link-local address space (169.254.0.0/16) and must be /29 or shorter (/28, /27, etc). Google will attempt to select an unused /29 from the supplied candidate prefix(es). The request will fail if all possible /29s are in use on Google's edge. If not supplied, Google will randomly select an unused /29 from all of link-local space. + * Input only. Up to 16 candidate prefixes that can be used to restrict the allocation + * of cloudRouterIpAddress and customerRouterIpAddress for this attachment. + * All prefixes must be within link-local address space (169.254.0.0/16) and + * must be /29 or shorter (/28, /27, etc). Google will attempt to select an + * unused /29 from the supplied candidate prefix(es). The request will fail if + * all possible /29s are in use on Google's edge. If not supplied, Google will + * randomly select an unused /29 from all of link-local space. * @type string $cloud_router_ip_address - * [Output Only] IPv4 address + prefix length to be configured on Cloud Router Interface for this interconnect attachment. + * [Output Only] IPv4 address + prefix length to be configured on Cloud Router + * Interface for this interconnect attachment. * @type string $cloud_router_ipv6_address - * [Output Only] IPv6 address + prefix length to be configured on Cloud Router Interface for this interconnect attachment. + * [Output Only] IPv6 address + prefix length to be configured on Cloud + * Router Interface for this interconnect attachment. * @type string $cloud_router_ipv6_interface_id * This field is not available. * @type \Google\Cloud\Compute\V1\InterconnectAttachmentConfigurationConstraints $configuration_constraints - * [Output Only] Constraints for this attachment, if any. The attachment does not work if these constraints are not met. + * [Output Only] Constraints for this attachment, if any. The attachment does + * not work if these constraints are not met. * @type string $creation_timestamp - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * @type string $customer_router_ip_address - * [Output Only] IPv4 address + prefix length to be configured on the customer router subinterface for this interconnect attachment. + * [Output Only] IPv4 address + prefix length to be configured on the customer + * router subinterface for this interconnect attachment. * @type string $customer_router_ipv6_address - * [Output Only] IPv6 address + prefix length to be configured on the customer router subinterface for this interconnect attachment. + * [Output Only] IPv6 address + prefix length to be configured on the + * customer router subinterface for this interconnect attachment. * @type string $customer_router_ipv6_interface_id * This field is not available. * @type int $dataplane_version - * [Output Only] Dataplane version for this InterconnectAttachment. This field is only present for Dataplane version 2 and higher. Absence of this field in the API output indicates that the Dataplane is version 1. + * [Output Only] Dataplane version for this InterconnectAttachment. This + * field is only present for Dataplane version 2 and higher. Absence of this + * field in the API output indicates that the Dataplane is version 1. * @type string $description * An optional description of this resource. * @type string $edge_availability_domain - * Input only. Desired availability domain for the attachment. Only available for type PARTNER, at creation time, and can take one of the following values: - AVAILABILITY_DOMAIN_ANY - AVAILABILITY_DOMAIN_1 - AVAILABILITY_DOMAIN_2 For improved reliability, customers should configure a pair of attachments, one per availability domain. The selected availability domain will be provided to the Partner via the pairing key, so that the provisioned circuit will lie in the specified domain. If not specified, the value will default to AVAILABILITY_DOMAIN_ANY. + * Input only. Desired availability domain for the attachment. Only available for type + * PARTNER, at creation time, and can take one of the following values: + * - AVAILABILITY_DOMAIN_ANY + * - AVAILABILITY_DOMAIN_1 + * - AVAILABILITY_DOMAIN_2 + * For improved reliability, customers should configure a pair of attachments, + * one per availability domain. The selected availability domain will be + * provided to the Partner via the pairing key, so that the provisioned + * circuit will lie in the specified domain. If not specified, the value will + * default to AVAILABILITY_DOMAIN_ANY. * Check the EdgeAvailabilityDomain enum for the list of possible values. * @type string $encryption - * Indicates the user-supplied encryption option of this VLAN attachment (interconnectAttachment). Can only be specified at attachment creation for PARTNER or DEDICATED attachments. Possible values are: - NONE - This is the default value, which means that the VLAN attachment carries unencrypted traffic. VMs are able to send traffic to, or receive traffic from, such a VLAN attachment. - IPSEC - The VLAN attachment carries only encrypted traffic that is encrypted by an IPsec device, such as an HA VPN gateway or third-party IPsec VPN. VMs cannot directly send traffic to, or receive traffic from, such a VLAN attachment. To use *HA VPN over Cloud Interconnect*, the VLAN attachment must be created with this option. + * Indicates the user-supplied encryption option of this VLAN attachment + * (interconnectAttachment). Can only be specified at attachment creation + * for PARTNER or DEDICATED attachments. + * Possible values are: + * - NONE - This is the default value, which means that the + * VLAN attachment carries unencrypted traffic. VMs are able to send + * traffic to, or receive traffic from, such a VLAN attachment. + * - IPSEC - The VLAN attachment carries only encrypted + * traffic that is encrypted by an IPsec device, such as an HA VPN gateway or + * third-party IPsec VPN. VMs cannot directly send traffic to, or receive + * traffic from, such a VLAN attachment. To use *HA VPN over Cloud + * Interconnect*, the VLAN attachment must be created with this + * option. * Check the Encryption enum for the list of possible values. * @type string $google_reference_id - * [Output Only] Google reference ID, to be used when raising support tickets with Google or otherwise to debug backend connectivity issues. [Deprecated] This field is not used. + * [Output Only] Google reference ID, to be used when raising support tickets + * with Google or otherwise to debug backend connectivity issues. + * [Deprecated] This field is not used. * @type int|string $id - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * @type string $interconnect - * URL of the underlying Interconnect object that this attachment's traffic will traverse through. + * URL of the underlying Interconnect object that this attachment's traffic + * will traverse through. * @type array|\Google\Protobuf\Internal\RepeatedField $ipsec_internal_addresses - * A list of URLs of addresses that have been reserved for the VLAN attachment. Used only for the VLAN attachment that has the encryption option as IPSEC. The addresses must be regional internal IP address ranges. When creating an HA VPN gateway over the VLAN attachment, if the attachment is configured to use a regional internal IP address, then the VPN gateway's IP address is allocated from the IP address range specified here. For example, if the HA VPN gateway's interface 0 is paired to this VLAN attachment, then a regional internal IP address for the VPN gateway interface 0 will be allocated from the IP address specified for this VLAN attachment. If this field is not specified when creating the VLAN attachment, then later on when creating an HA VPN gateway on this VLAN attachment, the HA VPN gateway's IP address is allocated from the regional external IP address pool. + * A list of URLs of addresses that have been reserved for the VLAN + * attachment. Used only for the VLAN attachment that has the encryption + * option as IPSEC. The addresses must be regional internal IP address ranges. + * When creating an HA VPN gateway over the VLAN attachment, if the attachment + * is configured to use a regional internal IP address, then the VPN gateway's + * IP address is allocated from the IP address range specified here. For + * example, if the HA VPN gateway's interface 0 is paired to this VLAN + * attachment, then a regional internal IP address for the VPN gateway + * interface 0 will be allocated from the IP address specified for this + * VLAN attachment. + * If this field is not specified when creating the VLAN attachment, then + * later on when creating an HA VPN gateway on this VLAN attachment, the HA + * VPN gateway's IP address is allocated from the regional external IP address + * pool. * @type string $kind - * [Output Only] Type of the resource. Always compute#interconnectAttachment for interconnect attachments. + * [Output Only] Type of the resource. Alwayscompute#interconnectAttachment for interconnect attachments. + * @type \Google\Cloud\Compute\V1\InterconnectAttachmentL2Forwarding $l2_forwarding + * L2 Interconnect Attachment related config. This field is required if the + * type is L2_DEDICATED. + * The configuration specifies how VLAN tags (like dot1q, qinq, or dot1ad) + * within L2 packets are mapped to the destination appliances IP addresses. + * The packet is then encapsulated with the appliance IP address and sent to + * the edge appliance. * @type string $label_fingerprint - * A fingerprint for the labels being applied to this InterconnectAttachment, which is essentially a hash of the labels set used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve an InterconnectAttachment. + * A fingerprint for the labels being applied to this InterconnectAttachment, + * which is essentially a hash of the labels set used for optimistic locking. + * The fingerprint is initially generated by Compute Engine and changes after + * every request to modify or update labels. You must always provide an + * up-to-date fingerprint hash in order to update or change labels, + * otherwise the request will fail with error412 conditionNotMet. + * To see the latest fingerprint, make a get() request to + * retrieve an InterconnectAttachment. * @type array|\Google\Protobuf\Internal\MapField $labels - * Labels for this resource. These can only be added or modified by the setLabels method. Each label key/value pair must comply with RFC1035. Label values may be empty. + * Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035. + * Label values may be empty. * @type int $mtu - * Maximum Transmission Unit (MTU), in bytes, of packets passing through this interconnect attachment. Valid values are 1440, 1460, 1500, and 8896. If not specified, the value will default to 1440. + * Maximum Transmission Unit (MTU), in bytes, of packets passing through this + * interconnect attachment. + * Valid values are 1440, 1460, 1500, and 8896. If not specified, + * the value will default to 1440. * @type string $name - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * @type string $operational_status - * [Output Only] The current status of whether or not this interconnect attachment is functional, which can take one of the following values: - OS_ACTIVE: The attachment has been turned up and is ready to use. - OS_UNPROVISIONED: The attachment is not ready to use yet, because turnup is not complete. + * [Output Only] The current status of whether or not this interconnect + * attachment is functional, which can take one of the following values: + * - OS_ACTIVE: The attachment has been turned up and is ready to + * use. + * - OS_UNPROVISIONED: The attachment is not ready to use yet, + * because turnup is not complete. * Check the OperationalStatus enum for the list of possible values. * @type string $pairing_key - * [Output only for type PARTNER. Input only for PARTNER_PROVIDER. Not present for DEDICATED]. The opaque identifier of a PARTNER attachment used to initiate provisioning with a selected partner. Of the form "XXXXX/region/domain" + * [Output only for type PARTNER. Input only for PARTNER_PROVIDER. Not + * present for DEDICATED]. + * The opaque identifier of a PARTNER attachment used to initiate + * provisioning with a selected partner. + * Of the form "XXXXX/region/domain" + * @type \Google\Cloud\Compute\V1\InterconnectAttachmentParams $params + * Input only. [Input Only] Additional params passed with the request, but not persisted + * as part of resource payload. * @type int|string $partner_asn - * Optional BGP ASN for the router supplied by a Layer 3 Partner if they configured BGP on behalf of the customer. Output only for PARTNER type, input only for PARTNER_PROVIDER, not available for DEDICATED. + * Optional BGP ASN for the router supplied by a Layer 3 Partner if they + * configured BGP on behalf of the customer. + * Output only for PARTNER type, input only for PARTNER_PROVIDER, not + * available for DEDICATED. * @type \Google\Cloud\Compute\V1\InterconnectAttachmentPartnerMetadata $partner_metadata - * Informational metadata about Partner attachments from Partners to display to customers. Output only for PARTNER type, mutable for PARTNER_PROVIDER, not available for DEDICATED. + * Informational metadata about Partner attachments from Partners to display + * to customers. + * Output only for PARTNER type, mutable for PARTNER_PROVIDER, not + * available for DEDICATED. * @type \Google\Cloud\Compute\V1\InterconnectAttachmentPrivateInfo $private_interconnect_info - * [Output Only] Information specific to an InterconnectAttachment. This property is populated if the interconnect that this is attached to is of type DEDICATED. + * [Output Only] Information specific to an InterconnectAttachment. + * This property is populated if the interconnect that + * this is attached to is of type DEDICATED. * @type string $region - * [Output Only] URL of the region where the regional interconnect attachment resides. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * [Output Only] URL of the region where the regional interconnect attachment + * resides. + * You must specify this field as part of the HTTP request URL. It is + * not settable as a field in the request body. * @type string $remote_service - * [Output Only] If the attachment is on a Cross-Cloud Interconnect connection, this field contains the interconnect's remote location service provider. Example values: "Amazon Web Services" "Microsoft Azure". The field is set only for attachments on Cross-Cloud Interconnect connections. Its value is copied from the InterconnectRemoteLocation remoteService field. + * [Output Only] + * If the attachment is on a Cross-Cloud Interconnect connection, this field + * contains the interconnect's remote location service provider. Example + * values: "Amazon Web Services" "Microsoft Azure". + * The field is set only for attachments on Cross-Cloud Interconnect + * connections. Its value is copied from the InterconnectRemoteLocation + * remoteService field. * @type string $router - * URL of the Cloud Router to be used for dynamic routing. This router must be in the same region as this InterconnectAttachment. The InterconnectAttachment will automatically connect the Interconnect to the network & region within which the Cloud Router is configured. + * URL of the Cloud Router to be used for dynamic routing. This router must be + * in the same region as this InterconnectAttachment. The + * InterconnectAttachment will automatically connect the Interconnect to the + * network & region within which the Cloud Router is configured. * @type bool $satisfies_pzs * [Output Only] Reserved for future use. * @type string $self_link * [Output Only] Server-defined URL for the resource. * @type string $stack_type - * The stack type for this interconnect attachment to identify whether the IPv6 feature is enabled or not. If not specified, IPV4_ONLY will be used. This field can be both set at interconnect attachments creation and update interconnect attachment operations. + * The stack type for this interconnect attachment to identify whether the + * IPv6 feature is enabled or not. If not specified, IPV4_ONLY + * will be used. + * This field can be both set at interconnect attachments creation and + * update interconnect attachment operations. * Check the StackType enum for the list of possible values. * @type string $state - * [Output Only] The current state of this attachment's functionality. Enum values ACTIVE and UNPROVISIONED are shared by DEDICATED/PRIVATE, PARTNER, and PARTNER_PROVIDER interconnect attachments, while enum values PENDING_PARTNER, PARTNER_REQUEST_RECEIVED, and PENDING_CUSTOMER are used for only PARTNER and PARTNER_PROVIDER interconnect attachments. This state can take one of the following values: - ACTIVE: The attachment has been turned up and is ready to use. - UNPROVISIONED: The attachment is not ready to use yet, because turnup is not complete. - PENDING_PARTNER: A newly-created PARTNER attachment that has not yet been configured on the Partner side. - PARTNER_REQUEST_RECEIVED: A PARTNER attachment is in the process of provisioning after a PARTNER_PROVIDER attachment was created that references it. - PENDING_CUSTOMER: A PARTNER or PARTNER_PROVIDER attachment that is waiting for a customer to activate it. - DEFUNCT: The attachment was deleted externally and is no longer functional. This could be because the associated Interconnect was removed, or because the other side of a Partner attachment was deleted. + * [Output Only] The current state of this attachment's functionality. + * Enum values ACTIVE and UNPROVISIONED are shared by DEDICATED/PRIVATE, + * PARTNER, and PARTNER_PROVIDER interconnect attachments, while enum values + * PENDING_PARTNER, PARTNER_REQUEST_RECEIVED, and PENDING_CUSTOMER are used + * for only PARTNER and PARTNER_PROVIDER interconnect attachments. + * This state can take one of the following values: + * - ACTIVE: The attachment has been turned up and is ready to use. + * - UNPROVISIONED: The attachment is not ready to use yet, because turnup + * is not complete. + * - PENDING_PARTNER: A newly-created PARTNER attachment that has not yet + * been configured on the Partner side. + * - PARTNER_REQUEST_RECEIVED: A PARTNER attachment is in the process of + * provisioning after a PARTNER_PROVIDER attachment was created that + * references it. + * - PENDING_CUSTOMER: A PARTNER or PARTNER_PROVIDER + * attachment that is waiting for a customer to activate it. + * - DEFUNCT: + * The attachment was deleted externally and is no longer functional. This + * could be because the associated Interconnect was removed, or because the + * other side of a Partner attachment was deleted. * Check the State enum for the list of possible values. * @type int $subnet_length - * Input only. Length of the IPv4 subnet mask. Allowed values: - 29 (default) - 30 The default value is 29, except for Cross-Cloud Interconnect connections that use an InterconnectRemoteLocation with a constraints.subnetLengthRange.min equal to 30. For example, connections that use an Azure remote location fall into this category. In these cases, the default value is 30, and requesting 29 returns an error. Where both 29 and 30 are allowed, 29 is preferred, because it gives Google Cloud Support more debugging visibility. + * Input only. Length of the IPv4 subnet mask. + * Allowed values: + * - 29 (default) + * - 30 + * The default value is 29, except for Cross-Cloud Interconnect + * connections that use an InterconnectRemoteLocation with a + * constraints.subnetLengthRange.min equal to 30. For example, + * connections that use an Azure remote location fall into this + * category. In these cases, the default value is 30, and requesting + * 29 returns an error. + * Where both 29 and 30 are allowed, 29 is preferred, because it gives + * Google Cloud Support more debugging visibility. * @type string $type - * The type of interconnect attachment this is, which can take one of the following values: - DEDICATED: an attachment to a Dedicated Interconnect. - PARTNER: an attachment to a Partner Interconnect, created by the customer. - PARTNER_PROVIDER: an attachment to a Partner Interconnect, created by the partner. + * The type of interconnect attachment this is, which can take one of the + * following values: + * - DEDICATED: an attachment to a Dedicated Interconnect. + * - PARTNER: an attachment to a Partner Interconnect, created by the + * customer. + * - PARTNER_PROVIDER: an attachment to a Partner Interconnect, created by + * the partner. + * - L2_DEDICATED: a L2 attachment to a Dedicated Interconnect. * Check the Type enum for the list of possible values. * @type int $vlan_tag8021q - * The IEEE 802.1Q VLAN tag for this attachment, in the range 2-4093. Only specified at creation time. + * The IEEE 802.1Q VLAN tag for this attachment, in the range 2-4093. + * Only specified at creation time. * } */ public function __construct($data = NULL) { @@ -372,7 +722,8 @@ public function __construct($data = NULL) { } /** - * Determines whether this Attachment will carry packets. Not present for PARTNER_PROVIDER. + * Determines whether this Attachment will carry packets. + * Not present for PARTNER_PROVIDER. * * Generated from protobuf field optional bool admin_enabled = 445675089; * @return bool @@ -393,7 +744,8 @@ public function clearAdminEnabled() } /** - * Determines whether this Attachment will carry packets. Not present for PARTNER_PROVIDER. + * Determines whether this Attachment will carry packets. + * Not present for PARTNER_PROVIDER. * * Generated from protobuf field optional bool admin_enabled = 445675089; * @param bool $var @@ -444,7 +796,25 @@ public function setAttachmentGroup($var) } /** - * Provisioned bandwidth capacity for the interconnect attachment. For attachments of type DEDICATED, the user can set the bandwidth. For attachments of type PARTNER, the Google Partner that is operating the interconnect must set the bandwidth. Output only for PARTNER type, mutable for PARTNER_PROVIDER and DEDICATED, and can take one of the following values: - BPS_50M: 50 Mbit/s - BPS_100M: 100 Mbit/s - BPS_200M: 200 Mbit/s - BPS_300M: 300 Mbit/s - BPS_400M: 400 Mbit/s - BPS_500M: 500 Mbit/s - BPS_1G: 1 Gbit/s - BPS_2G: 2 Gbit/s - BPS_5G: 5 Gbit/s - BPS_10G: 10 Gbit/s - BPS_20G: 20 Gbit/s - BPS_50G: 50 Gbit/s - BPS_100G: 100 Gbit/s + * Provisioned bandwidth capacity for the interconnect attachment. For + * attachments of type DEDICATED, the user can set the bandwidth. + * For attachments of type PARTNER, the Google Partner that is operating + * the interconnect must set the bandwidth. + * Output only for PARTNER type, mutable for PARTNER_PROVIDER and DEDICATED, + * and can take one of the following values: + * - BPS_50M: 50 Mbit/s + * - BPS_100M: 100 Mbit/s + * - BPS_200M: 200 Mbit/s + * - BPS_300M: 300 Mbit/s + * - BPS_400M: 400 Mbit/s + * - BPS_500M: 500 Mbit/s + * - BPS_1G: 1 Gbit/s + * - BPS_2G: 2 Gbit/s + * - BPS_5G: 5 Gbit/s + * - BPS_10G: 10 Gbit/s + * - BPS_20G: 20 Gbit/s + * - BPS_50G: 50 Gbit/s + * - BPS_100G: 100 Gbit/s * Check the Bandwidth enum for the list of possible values. * * Generated from protobuf field optional string bandwidth = 181715121; @@ -466,7 +836,25 @@ public function clearBandwidth() } /** - * Provisioned bandwidth capacity for the interconnect attachment. For attachments of type DEDICATED, the user can set the bandwidth. For attachments of type PARTNER, the Google Partner that is operating the interconnect must set the bandwidth. Output only for PARTNER type, mutable for PARTNER_PROVIDER and DEDICATED, and can take one of the following values: - BPS_50M: 50 Mbit/s - BPS_100M: 100 Mbit/s - BPS_200M: 200 Mbit/s - BPS_300M: 300 Mbit/s - BPS_400M: 400 Mbit/s - BPS_500M: 500 Mbit/s - BPS_1G: 1 Gbit/s - BPS_2G: 2 Gbit/s - BPS_5G: 5 Gbit/s - BPS_10G: 10 Gbit/s - BPS_20G: 20 Gbit/s - BPS_50G: 50 Gbit/s - BPS_100G: 100 Gbit/s + * Provisioned bandwidth capacity for the interconnect attachment. For + * attachments of type DEDICATED, the user can set the bandwidth. + * For attachments of type PARTNER, the Google Partner that is operating + * the interconnect must set the bandwidth. + * Output only for PARTNER type, mutable for PARTNER_PROVIDER and DEDICATED, + * and can take one of the following values: + * - BPS_50M: 50 Mbit/s + * - BPS_100M: 100 Mbit/s + * - BPS_200M: 200 Mbit/s + * - BPS_300M: 300 Mbit/s + * - BPS_400M: 400 Mbit/s + * - BPS_500M: 500 Mbit/s + * - BPS_1G: 1 Gbit/s + * - BPS_2G: 2 Gbit/s + * - BPS_5G: 5 Gbit/s + * - BPS_10G: 10 Gbit/s + * - BPS_20G: 20 Gbit/s + * - BPS_50G: 50 Gbit/s + * - BPS_100G: 100 Gbit/s * Check the Bandwidth enum for the list of possible values. * * Generated from protobuf field optional string bandwidth = 181715121; @@ -508,7 +896,13 @@ public function setCandidateIpv6Subnets($var) } /** - * Input only. Up to 16 candidate prefixes that can be used to restrict the allocation of cloudRouterIpAddress and customerRouterIpAddress for this attachment. All prefixes must be within link-local address space (169.254.0.0/16) and must be /29 or shorter (/28, /27, etc). Google will attempt to select an unused /29 from the supplied candidate prefix(es). The request will fail if all possible /29s are in use on Google's edge. If not supplied, Google will randomly select an unused /29 from all of link-local space. + * Input only. Up to 16 candidate prefixes that can be used to restrict the allocation + * of cloudRouterIpAddress and customerRouterIpAddress for this attachment. + * All prefixes must be within link-local address space (169.254.0.0/16) and + * must be /29 or shorter (/28, /27, etc). Google will attempt to select an + * unused /29 from the supplied candidate prefix(es). The request will fail if + * all possible /29s are in use on Google's edge. If not supplied, Google will + * randomly select an unused /29 from all of link-local space. * * Generated from protobuf field repeated string candidate_subnets = 237842938; * @return \Google\Protobuf\Internal\RepeatedField @@ -519,7 +913,13 @@ public function getCandidateSubnets() } /** - * Input only. Up to 16 candidate prefixes that can be used to restrict the allocation of cloudRouterIpAddress and customerRouterIpAddress for this attachment. All prefixes must be within link-local address space (169.254.0.0/16) and must be /29 or shorter (/28, /27, etc). Google will attempt to select an unused /29 from the supplied candidate prefix(es). The request will fail if all possible /29s are in use on Google's edge. If not supplied, Google will randomly select an unused /29 from all of link-local space. + * Input only. Up to 16 candidate prefixes that can be used to restrict the allocation + * of cloudRouterIpAddress and customerRouterIpAddress for this attachment. + * All prefixes must be within link-local address space (169.254.0.0/16) and + * must be /29 or shorter (/28, /27, etc). Google will attempt to select an + * unused /29 from the supplied candidate prefix(es). The request will fail if + * all possible /29s are in use on Google's edge. If not supplied, Google will + * randomly select an unused /29 from all of link-local space. * * Generated from protobuf field repeated string candidate_subnets = 237842938; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -534,7 +934,8 @@ public function setCandidateSubnets($var) } /** - * [Output Only] IPv4 address + prefix length to be configured on Cloud Router Interface for this interconnect attachment. + * [Output Only] IPv4 address + prefix length to be configured on Cloud Router + * Interface for this interconnect attachment. * * Generated from protobuf field optional string cloud_router_ip_address = 287392776; * @return string @@ -555,7 +956,8 @@ public function clearCloudRouterIpAddress() } /** - * [Output Only] IPv4 address + prefix length to be configured on Cloud Router Interface for this interconnect attachment. + * [Output Only] IPv4 address + prefix length to be configured on Cloud Router + * Interface for this interconnect attachment. * * Generated from protobuf field optional string cloud_router_ip_address = 287392776; * @param string $var @@ -570,7 +972,8 @@ public function setCloudRouterIpAddress($var) } /** - * [Output Only] IPv6 address + prefix length to be configured on Cloud Router Interface for this interconnect attachment. + * [Output Only] IPv6 address + prefix length to be configured on Cloud + * Router Interface for this interconnect attachment. * * Generated from protobuf field optional string cloud_router_ipv6_address = 451922376; * @return string @@ -591,7 +994,8 @@ public function clearCloudRouterIpv6Address() } /** - * [Output Only] IPv6 address + prefix length to be configured on Cloud Router Interface for this interconnect attachment. + * [Output Only] IPv6 address + prefix length to be configured on Cloud + * Router Interface for this interconnect attachment. * * Generated from protobuf field optional string cloud_router_ipv6_address = 451922376; * @param string $var @@ -642,7 +1046,8 @@ public function setCloudRouterIpv6InterfaceId($var) } /** - * [Output Only] Constraints for this attachment, if any. The attachment does not work if these constraints are not met. + * [Output Only] Constraints for this attachment, if any. The attachment does + * not work if these constraints are not met. * * Generated from protobuf field optional .google.cloud.compute.v1.InterconnectAttachmentConfigurationConstraints configuration_constraints = 179681389; * @return \Google\Cloud\Compute\V1\InterconnectAttachmentConfigurationConstraints|null @@ -663,7 +1068,8 @@ public function clearConfigurationConstraints() } /** - * [Output Only] Constraints for this attachment, if any. The attachment does not work if these constraints are not met. + * [Output Only] Constraints for this attachment, if any. The attachment does + * not work if these constraints are not met. * * Generated from protobuf field optional .google.cloud.compute.v1.InterconnectAttachmentConfigurationConstraints configuration_constraints = 179681389; * @param \Google\Cloud\Compute\V1\InterconnectAttachmentConfigurationConstraints $var @@ -678,7 +1084,8 @@ public function setConfigurationConstraints($var) } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @return string @@ -699,7 +1106,8 @@ public function clearCreationTimestamp() } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @param string $var @@ -714,7 +1122,8 @@ public function setCreationTimestamp($var) } /** - * [Output Only] IPv4 address + prefix length to be configured on the customer router subinterface for this interconnect attachment. + * [Output Only] IPv4 address + prefix length to be configured on the customer + * router subinterface for this interconnect attachment. * * Generated from protobuf field optional string customer_router_ip_address = 332475761; * @return string @@ -735,7 +1144,8 @@ public function clearCustomerRouterIpAddress() } /** - * [Output Only] IPv4 address + prefix length to be configured on the customer router subinterface for this interconnect attachment. + * [Output Only] IPv4 address + prefix length to be configured on the customer + * router subinterface for this interconnect attachment. * * Generated from protobuf field optional string customer_router_ip_address = 332475761; * @param string $var @@ -750,7 +1160,8 @@ public function setCustomerRouterIpAddress($var) } /** - * [Output Only] IPv6 address + prefix length to be configured on the customer router subinterface for this interconnect attachment. + * [Output Only] IPv6 address + prefix length to be configured on the + * customer router subinterface for this interconnect attachment. * * Generated from protobuf field optional string customer_router_ipv6_address = 290127089; * @return string @@ -771,7 +1182,8 @@ public function clearCustomerRouterIpv6Address() } /** - * [Output Only] IPv6 address + prefix length to be configured on the customer router subinterface for this interconnect attachment. + * [Output Only] IPv6 address + prefix length to be configured on the + * customer router subinterface for this interconnect attachment. * * Generated from protobuf field optional string customer_router_ipv6_address = 290127089; * @param string $var @@ -822,7 +1234,9 @@ public function setCustomerRouterIpv6InterfaceId($var) } /** - * [Output Only] Dataplane version for this InterconnectAttachment. This field is only present for Dataplane version 2 and higher. Absence of this field in the API output indicates that the Dataplane is version 1. + * [Output Only] Dataplane version for this InterconnectAttachment. This + * field is only present for Dataplane version 2 and higher. Absence of this + * field in the API output indicates that the Dataplane is version 1. * * Generated from protobuf field optional int32 dataplane_version = 34920075; * @return int @@ -843,7 +1257,9 @@ public function clearDataplaneVersion() } /** - * [Output Only] Dataplane version for this InterconnectAttachment. This field is only present for Dataplane version 2 and higher. Absence of this field in the API output indicates that the Dataplane is version 1. + * [Output Only] Dataplane version for this InterconnectAttachment. This + * field is only present for Dataplane version 2 and higher. Absence of this + * field in the API output indicates that the Dataplane is version 1. * * Generated from protobuf field optional int32 dataplane_version = 34920075; * @param int $var @@ -894,7 +1310,16 @@ public function setDescription($var) } /** - * Input only. Desired availability domain for the attachment. Only available for type PARTNER, at creation time, and can take one of the following values: - AVAILABILITY_DOMAIN_ANY - AVAILABILITY_DOMAIN_1 - AVAILABILITY_DOMAIN_2 For improved reliability, customers should configure a pair of attachments, one per availability domain. The selected availability domain will be provided to the Partner via the pairing key, so that the provisioned circuit will lie in the specified domain. If not specified, the value will default to AVAILABILITY_DOMAIN_ANY. + * Input only. Desired availability domain for the attachment. Only available for type + * PARTNER, at creation time, and can take one of the following values: + * - AVAILABILITY_DOMAIN_ANY + * - AVAILABILITY_DOMAIN_1 + * - AVAILABILITY_DOMAIN_2 + * For improved reliability, customers should configure a pair of attachments, + * one per availability domain. The selected availability domain will be + * provided to the Partner via the pairing key, so that the provisioned + * circuit will lie in the specified domain. If not specified, the value will + * default to AVAILABILITY_DOMAIN_ANY. * Check the EdgeAvailabilityDomain enum for the list of possible values. * * Generated from protobuf field optional string edge_availability_domain = 71289510; @@ -916,7 +1341,16 @@ public function clearEdgeAvailabilityDomain() } /** - * Input only. Desired availability domain for the attachment. Only available for type PARTNER, at creation time, and can take one of the following values: - AVAILABILITY_DOMAIN_ANY - AVAILABILITY_DOMAIN_1 - AVAILABILITY_DOMAIN_2 For improved reliability, customers should configure a pair of attachments, one per availability domain. The selected availability domain will be provided to the Partner via the pairing key, so that the provisioned circuit will lie in the specified domain. If not specified, the value will default to AVAILABILITY_DOMAIN_ANY. + * Input only. Desired availability domain for the attachment. Only available for type + * PARTNER, at creation time, and can take one of the following values: + * - AVAILABILITY_DOMAIN_ANY + * - AVAILABILITY_DOMAIN_1 + * - AVAILABILITY_DOMAIN_2 + * For improved reliability, customers should configure a pair of attachments, + * one per availability domain. The selected availability domain will be + * provided to the Partner via the pairing key, so that the provisioned + * circuit will lie in the specified domain. If not specified, the value will + * default to AVAILABILITY_DOMAIN_ANY. * Check the EdgeAvailabilityDomain enum for the list of possible values. * * Generated from protobuf field optional string edge_availability_domain = 71289510; @@ -932,7 +1366,19 @@ public function setEdgeAvailabilityDomain($var) } /** - * Indicates the user-supplied encryption option of this VLAN attachment (interconnectAttachment). Can only be specified at attachment creation for PARTNER or DEDICATED attachments. Possible values are: - NONE - This is the default value, which means that the VLAN attachment carries unencrypted traffic. VMs are able to send traffic to, or receive traffic from, such a VLAN attachment. - IPSEC - The VLAN attachment carries only encrypted traffic that is encrypted by an IPsec device, such as an HA VPN gateway or third-party IPsec VPN. VMs cannot directly send traffic to, or receive traffic from, such a VLAN attachment. To use *HA VPN over Cloud Interconnect*, the VLAN attachment must be created with this option. + * Indicates the user-supplied encryption option of this VLAN attachment + * (interconnectAttachment). Can only be specified at attachment creation + * for PARTNER or DEDICATED attachments. + * Possible values are: + * - NONE - This is the default value, which means that the + * VLAN attachment carries unencrypted traffic. VMs are able to send + * traffic to, or receive traffic from, such a VLAN attachment. + * - IPSEC - The VLAN attachment carries only encrypted + * traffic that is encrypted by an IPsec device, such as an HA VPN gateway or + * third-party IPsec VPN. VMs cannot directly send traffic to, or receive + * traffic from, such a VLAN attachment. To use *HA VPN over Cloud + * Interconnect*, the VLAN attachment must be created with this + * option. * Check the Encryption enum for the list of possible values. * * Generated from protobuf field optional string encryption = 97980291; @@ -954,7 +1400,19 @@ public function clearEncryption() } /** - * Indicates the user-supplied encryption option of this VLAN attachment (interconnectAttachment). Can only be specified at attachment creation for PARTNER or DEDICATED attachments. Possible values are: - NONE - This is the default value, which means that the VLAN attachment carries unencrypted traffic. VMs are able to send traffic to, or receive traffic from, such a VLAN attachment. - IPSEC - The VLAN attachment carries only encrypted traffic that is encrypted by an IPsec device, such as an HA VPN gateway or third-party IPsec VPN. VMs cannot directly send traffic to, or receive traffic from, such a VLAN attachment. To use *HA VPN over Cloud Interconnect*, the VLAN attachment must be created with this option. + * Indicates the user-supplied encryption option of this VLAN attachment + * (interconnectAttachment). Can only be specified at attachment creation + * for PARTNER or DEDICATED attachments. + * Possible values are: + * - NONE - This is the default value, which means that the + * VLAN attachment carries unencrypted traffic. VMs are able to send + * traffic to, or receive traffic from, such a VLAN attachment. + * - IPSEC - The VLAN attachment carries only encrypted + * traffic that is encrypted by an IPsec device, such as an HA VPN gateway or + * third-party IPsec VPN. VMs cannot directly send traffic to, or receive + * traffic from, such a VLAN attachment. To use *HA VPN over Cloud + * Interconnect*, the VLAN attachment must be created with this + * option. * Check the Encryption enum for the list of possible values. * * Generated from protobuf field optional string encryption = 97980291; @@ -970,7 +1428,9 @@ public function setEncryption($var) } /** - * [Output Only] Google reference ID, to be used when raising support tickets with Google or otherwise to debug backend connectivity issues. [Deprecated] This field is not used. + * [Output Only] Google reference ID, to be used when raising support tickets + * with Google or otherwise to debug backend connectivity issues. + * [Deprecated] This field is not used. * * Generated from protobuf field optional string google_reference_id = 534944469; * @return string @@ -991,7 +1451,9 @@ public function clearGoogleReferenceId() } /** - * [Output Only] Google reference ID, to be used when raising support tickets with Google or otherwise to debug backend connectivity issues. [Deprecated] This field is not used. + * [Output Only] Google reference ID, to be used when raising support tickets + * with Google or otherwise to debug backend connectivity issues. + * [Deprecated] This field is not used. * * Generated from protobuf field optional string google_reference_id = 534944469; * @param string $var @@ -1006,7 +1468,8 @@ public function setGoogleReferenceId($var) } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @return int|string @@ -1027,7 +1490,8 @@ public function clearId() } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @param int|string $var @@ -1042,7 +1506,8 @@ public function setId($var) } /** - * URL of the underlying Interconnect object that this attachment's traffic will traverse through. + * URL of the underlying Interconnect object that this attachment's traffic + * will traverse through. * * Generated from protobuf field optional string interconnect = 224601230; * @return string @@ -1063,7 +1528,8 @@ public function clearInterconnect() } /** - * URL of the underlying Interconnect object that this attachment's traffic will traverse through. + * URL of the underlying Interconnect object that this attachment's traffic + * will traverse through. * * Generated from protobuf field optional string interconnect = 224601230; * @param string $var @@ -1078,7 +1544,20 @@ public function setInterconnect($var) } /** - * A list of URLs of addresses that have been reserved for the VLAN attachment. Used only for the VLAN attachment that has the encryption option as IPSEC. The addresses must be regional internal IP address ranges. When creating an HA VPN gateway over the VLAN attachment, if the attachment is configured to use a regional internal IP address, then the VPN gateway's IP address is allocated from the IP address range specified here. For example, if the HA VPN gateway's interface 0 is paired to this VLAN attachment, then a regional internal IP address for the VPN gateway interface 0 will be allocated from the IP address specified for this VLAN attachment. If this field is not specified when creating the VLAN attachment, then later on when creating an HA VPN gateway on this VLAN attachment, the HA VPN gateway's IP address is allocated from the regional external IP address pool. + * A list of URLs of addresses that have been reserved for the VLAN + * attachment. Used only for the VLAN attachment that has the encryption + * option as IPSEC. The addresses must be regional internal IP address ranges. + * When creating an HA VPN gateway over the VLAN attachment, if the attachment + * is configured to use a regional internal IP address, then the VPN gateway's + * IP address is allocated from the IP address range specified here. For + * example, if the HA VPN gateway's interface 0 is paired to this VLAN + * attachment, then a regional internal IP address for the VPN gateway + * interface 0 will be allocated from the IP address specified for this + * VLAN attachment. + * If this field is not specified when creating the VLAN attachment, then + * later on when creating an HA VPN gateway on this VLAN attachment, the HA + * VPN gateway's IP address is allocated from the regional external IP address + * pool. * * Generated from protobuf field repeated string ipsec_internal_addresses = 407648565; * @return \Google\Protobuf\Internal\RepeatedField @@ -1089,7 +1568,20 @@ public function getIpsecInternalAddresses() } /** - * A list of URLs of addresses that have been reserved for the VLAN attachment. Used only for the VLAN attachment that has the encryption option as IPSEC. The addresses must be regional internal IP address ranges. When creating an HA VPN gateway over the VLAN attachment, if the attachment is configured to use a regional internal IP address, then the VPN gateway's IP address is allocated from the IP address range specified here. For example, if the HA VPN gateway's interface 0 is paired to this VLAN attachment, then a regional internal IP address for the VPN gateway interface 0 will be allocated from the IP address specified for this VLAN attachment. If this field is not specified when creating the VLAN attachment, then later on when creating an HA VPN gateway on this VLAN attachment, the HA VPN gateway's IP address is allocated from the regional external IP address pool. + * A list of URLs of addresses that have been reserved for the VLAN + * attachment. Used only for the VLAN attachment that has the encryption + * option as IPSEC. The addresses must be regional internal IP address ranges. + * When creating an HA VPN gateway over the VLAN attachment, if the attachment + * is configured to use a regional internal IP address, then the VPN gateway's + * IP address is allocated from the IP address range specified here. For + * example, if the HA VPN gateway's interface 0 is paired to this VLAN + * attachment, then a regional internal IP address for the VPN gateway + * interface 0 will be allocated from the IP address specified for this + * VLAN attachment. + * If this field is not specified when creating the VLAN attachment, then + * later on when creating an HA VPN gateway on this VLAN attachment, the HA + * VPN gateway's IP address is allocated from the regional external IP address + * pool. * * Generated from protobuf field repeated string ipsec_internal_addresses = 407648565; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -1104,7 +1596,7 @@ public function setIpsecInternalAddresses($var) } /** - * [Output Only] Type of the resource. Always compute#interconnectAttachment for interconnect attachments. + * [Output Only] Type of the resource. Alwayscompute#interconnectAttachment for interconnect attachments. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -1125,7 +1617,7 @@ public function clearKind() } /** - * [Output Only] Type of the resource. Always compute#interconnectAttachment for interconnect attachments. + * [Output Only] Type of the resource. Alwayscompute#interconnectAttachment for interconnect attachments. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -1140,7 +1632,60 @@ public function setKind($var) } /** - * A fingerprint for the labels being applied to this InterconnectAttachment, which is essentially a hash of the labels set used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve an InterconnectAttachment. + * L2 Interconnect Attachment related config. This field is required if the + * type is L2_DEDICATED. + * The configuration specifies how VLAN tags (like dot1q, qinq, or dot1ad) + * within L2 packets are mapped to the destination appliances IP addresses. + * The packet is then encapsulated with the appliance IP address and sent to + * the edge appliance. + * + * Generated from protobuf field optional .google.cloud.compute.v1.InterconnectAttachmentL2Forwarding l2_forwarding = 84784022; + * @return \Google\Cloud\Compute\V1\InterconnectAttachmentL2Forwarding|null + */ + public function getL2Forwarding() + { + return $this->l2_forwarding; + } + + public function hasL2Forwarding() + { + return isset($this->l2_forwarding); + } + + public function clearL2Forwarding() + { + unset($this->l2_forwarding); + } + + /** + * L2 Interconnect Attachment related config. This field is required if the + * type is L2_DEDICATED. + * The configuration specifies how VLAN tags (like dot1q, qinq, or dot1ad) + * within L2 packets are mapped to the destination appliances IP addresses. + * The packet is then encapsulated with the appliance IP address and sent to + * the edge appliance. + * + * Generated from protobuf field optional .google.cloud.compute.v1.InterconnectAttachmentL2Forwarding l2_forwarding = 84784022; + * @param \Google\Cloud\Compute\V1\InterconnectAttachmentL2Forwarding $var + * @return $this + */ + public function setL2Forwarding($var) + { + GPBUtil::checkMessage($var, \Google\Cloud\Compute\V1\InterconnectAttachmentL2Forwarding::class); + $this->l2_forwarding = $var; + + return $this; + } + + /** + * A fingerprint for the labels being applied to this InterconnectAttachment, + * which is essentially a hash of the labels set used for optimistic locking. + * The fingerprint is initially generated by Compute Engine and changes after + * every request to modify or update labels. You must always provide an + * up-to-date fingerprint hash in order to update or change labels, + * otherwise the request will fail with error412 conditionNotMet. + * To see the latest fingerprint, make a get() request to + * retrieve an InterconnectAttachment. * * Generated from protobuf field optional string label_fingerprint = 178124825; * @return string @@ -1161,7 +1706,14 @@ public function clearLabelFingerprint() } /** - * A fingerprint for the labels being applied to this InterconnectAttachment, which is essentially a hash of the labels set used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve an InterconnectAttachment. + * A fingerprint for the labels being applied to this InterconnectAttachment, + * which is essentially a hash of the labels set used for optimistic locking. + * The fingerprint is initially generated by Compute Engine and changes after + * every request to modify or update labels. You must always provide an + * up-to-date fingerprint hash in order to update or change labels, + * otherwise the request will fail with error412 conditionNotMet. + * To see the latest fingerprint, make a get() request to + * retrieve an InterconnectAttachment. * * Generated from protobuf field optional string label_fingerprint = 178124825; * @param string $var @@ -1176,7 +1728,8 @@ public function setLabelFingerprint($var) } /** - * Labels for this resource. These can only be added or modified by the setLabels method. Each label key/value pair must comply with RFC1035. Label values may be empty. + * Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035. + * Label values may be empty. * * Generated from protobuf field map labels = 500195327; * @return \Google\Protobuf\Internal\MapField @@ -1187,7 +1740,8 @@ public function getLabels() } /** - * Labels for this resource. These can only be added or modified by the setLabels method. Each label key/value pair must comply with RFC1035. Label values may be empty. + * Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035. + * Label values may be empty. * * Generated from protobuf field map labels = 500195327; * @param array|\Google\Protobuf\Internal\MapField $var @@ -1202,7 +1756,10 @@ public function setLabels($var) } /** - * Maximum Transmission Unit (MTU), in bytes, of packets passing through this interconnect attachment. Valid values are 1440, 1460, 1500, and 8896. If not specified, the value will default to 1440. + * Maximum Transmission Unit (MTU), in bytes, of packets passing through this + * interconnect attachment. + * Valid values are 1440, 1460, 1500, and 8896. If not specified, + * the value will default to 1440. * * Generated from protobuf field optional int32 mtu = 108462; * @return int @@ -1223,7 +1780,10 @@ public function clearMtu() } /** - * Maximum Transmission Unit (MTU), in bytes, of packets passing through this interconnect attachment. Valid values are 1440, 1460, 1500, and 8896. If not specified, the value will default to 1440. + * Maximum Transmission Unit (MTU), in bytes, of packets passing through this + * interconnect attachment. + * Valid values are 1440, 1460, 1500, and 8896. If not specified, + * the value will default to 1440. * * Generated from protobuf field optional int32 mtu = 108462; * @param int $var @@ -1238,7 +1798,13 @@ public function setMtu($var) } /** - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * * Generated from protobuf field optional string name = 3373707; * @return string @@ -1259,7 +1825,13 @@ public function clearName() } /** - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * * Generated from protobuf field optional string name = 3373707; * @param string $var @@ -1274,7 +1846,12 @@ public function setName($var) } /** - * [Output Only] The current status of whether or not this interconnect attachment is functional, which can take one of the following values: - OS_ACTIVE: The attachment has been turned up and is ready to use. - OS_UNPROVISIONED: The attachment is not ready to use yet, because turnup is not complete. + * [Output Only] The current status of whether or not this interconnect + * attachment is functional, which can take one of the following values: + * - OS_ACTIVE: The attachment has been turned up and is ready to + * use. + * - OS_UNPROVISIONED: The attachment is not ready to use yet, + * because turnup is not complete. * Check the OperationalStatus enum for the list of possible values. * * Generated from protobuf field optional string operational_status = 201070847; @@ -1296,7 +1873,12 @@ public function clearOperationalStatus() } /** - * [Output Only] The current status of whether or not this interconnect attachment is functional, which can take one of the following values: - OS_ACTIVE: The attachment has been turned up and is ready to use. - OS_UNPROVISIONED: The attachment is not ready to use yet, because turnup is not complete. + * [Output Only] The current status of whether or not this interconnect + * attachment is functional, which can take one of the following values: + * - OS_ACTIVE: The attachment has been turned up and is ready to + * use. + * - OS_UNPROVISIONED: The attachment is not ready to use yet, + * because turnup is not complete. * Check the OperationalStatus enum for the list of possible values. * * Generated from protobuf field optional string operational_status = 201070847; @@ -1312,7 +1894,11 @@ public function setOperationalStatus($var) } /** - * [Output only for type PARTNER. Input only for PARTNER_PROVIDER. Not present for DEDICATED]. The opaque identifier of a PARTNER attachment used to initiate provisioning with a selected partner. Of the form "XXXXX/region/domain" + * [Output only for type PARTNER. Input only for PARTNER_PROVIDER. Not + * present for DEDICATED]. + * The opaque identifier of a PARTNER attachment used to initiate + * provisioning with a selected partner. + * Of the form "XXXXX/region/domain" * * Generated from protobuf field optional string pairing_key = 439695464; * @return string @@ -1333,7 +1919,11 @@ public function clearPairingKey() } /** - * [Output only for type PARTNER. Input only for PARTNER_PROVIDER. Not present for DEDICATED]. The opaque identifier of a PARTNER attachment used to initiate provisioning with a selected partner. Of the form "XXXXX/region/domain" + * [Output only for type PARTNER. Input only for PARTNER_PROVIDER. Not + * present for DEDICATED]. + * The opaque identifier of a PARTNER attachment used to initiate + * provisioning with a selected partner. + * Of the form "XXXXX/region/domain" * * Generated from protobuf field optional string pairing_key = 439695464; * @param string $var @@ -1348,7 +1938,48 @@ public function setPairingKey($var) } /** - * Optional BGP ASN for the router supplied by a Layer 3 Partner if they configured BGP on behalf of the customer. Output only for PARTNER type, input only for PARTNER_PROVIDER, not available for DEDICATED. + * Input only. [Input Only] Additional params passed with the request, but not persisted + * as part of resource payload. + * + * Generated from protobuf field optional .google.cloud.compute.v1.InterconnectAttachmentParams params = 78313862; + * @return \Google\Cloud\Compute\V1\InterconnectAttachmentParams|null + */ + public function getParams() + { + return $this->params; + } + + public function hasParams() + { + return isset($this->params); + } + + public function clearParams() + { + unset($this->params); + } + + /** + * Input only. [Input Only] Additional params passed with the request, but not persisted + * as part of resource payload. + * + * Generated from protobuf field optional .google.cloud.compute.v1.InterconnectAttachmentParams params = 78313862; + * @param \Google\Cloud\Compute\V1\InterconnectAttachmentParams $var + * @return $this + */ + public function setParams($var) + { + GPBUtil::checkMessage($var, \Google\Cloud\Compute\V1\InterconnectAttachmentParams::class); + $this->params = $var; + + return $this; + } + + /** + * Optional BGP ASN for the router supplied by a Layer 3 Partner if they + * configured BGP on behalf of the customer. + * Output only for PARTNER type, input only for PARTNER_PROVIDER, not + * available for DEDICATED. * * Generated from protobuf field optional int64 partner_asn = 438166149; * @return int|string @@ -1369,7 +2000,10 @@ public function clearPartnerAsn() } /** - * Optional BGP ASN for the router supplied by a Layer 3 Partner if they configured BGP on behalf of the customer. Output only for PARTNER type, input only for PARTNER_PROVIDER, not available for DEDICATED. + * Optional BGP ASN for the router supplied by a Layer 3 Partner if they + * configured BGP on behalf of the customer. + * Output only for PARTNER type, input only for PARTNER_PROVIDER, not + * available for DEDICATED. * * Generated from protobuf field optional int64 partner_asn = 438166149; * @param int|string $var @@ -1384,7 +2018,10 @@ public function setPartnerAsn($var) } /** - * Informational metadata about Partner attachments from Partners to display to customers. Output only for PARTNER type, mutable for PARTNER_PROVIDER, not available for DEDICATED. + * Informational metadata about Partner attachments from Partners to display + * to customers. + * Output only for PARTNER type, mutable for PARTNER_PROVIDER, not + * available for DEDICATED. * * Generated from protobuf field optional .google.cloud.compute.v1.InterconnectAttachmentPartnerMetadata partner_metadata = 65908934; * @return \Google\Cloud\Compute\V1\InterconnectAttachmentPartnerMetadata|null @@ -1405,7 +2042,10 @@ public function clearPartnerMetadata() } /** - * Informational metadata about Partner attachments from Partners to display to customers. Output only for PARTNER type, mutable for PARTNER_PROVIDER, not available for DEDICATED. + * Informational metadata about Partner attachments from Partners to display + * to customers. + * Output only for PARTNER type, mutable for PARTNER_PROVIDER, not + * available for DEDICATED. * * Generated from protobuf field optional .google.cloud.compute.v1.InterconnectAttachmentPartnerMetadata partner_metadata = 65908934; * @param \Google\Cloud\Compute\V1\InterconnectAttachmentPartnerMetadata $var @@ -1420,7 +2060,9 @@ public function setPartnerMetadata($var) } /** - * [Output Only] Information specific to an InterconnectAttachment. This property is populated if the interconnect that this is attached to is of type DEDICATED. + * [Output Only] Information specific to an InterconnectAttachment. + * This property is populated if the interconnect that + * this is attached to is of type DEDICATED. * * Generated from protobuf field optional .google.cloud.compute.v1.InterconnectAttachmentPrivateInfo private_interconnect_info = 237270531; * @return \Google\Cloud\Compute\V1\InterconnectAttachmentPrivateInfo|null @@ -1441,7 +2083,9 @@ public function clearPrivateInterconnectInfo() } /** - * [Output Only] Information specific to an InterconnectAttachment. This property is populated if the interconnect that this is attached to is of type DEDICATED. + * [Output Only] Information specific to an InterconnectAttachment. + * This property is populated if the interconnect that + * this is attached to is of type DEDICATED. * * Generated from protobuf field optional .google.cloud.compute.v1.InterconnectAttachmentPrivateInfo private_interconnect_info = 237270531; * @param \Google\Cloud\Compute\V1\InterconnectAttachmentPrivateInfo $var @@ -1456,7 +2100,10 @@ public function setPrivateInterconnectInfo($var) } /** - * [Output Only] URL of the region where the regional interconnect attachment resides. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * [Output Only] URL of the region where the regional interconnect attachment + * resides. + * You must specify this field as part of the HTTP request URL. It is + * not settable as a field in the request body. * * Generated from protobuf field optional string region = 138946292; * @return string @@ -1477,7 +2124,10 @@ public function clearRegion() } /** - * [Output Only] URL of the region where the regional interconnect attachment resides. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * [Output Only] URL of the region where the regional interconnect attachment + * resides. + * You must specify this field as part of the HTTP request URL. It is + * not settable as a field in the request body. * * Generated from protobuf field optional string region = 138946292; * @param string $var @@ -1492,7 +2142,13 @@ public function setRegion($var) } /** - * [Output Only] If the attachment is on a Cross-Cloud Interconnect connection, this field contains the interconnect's remote location service provider. Example values: "Amazon Web Services" "Microsoft Azure". The field is set only for attachments on Cross-Cloud Interconnect connections. Its value is copied from the InterconnectRemoteLocation remoteService field. + * [Output Only] + * If the attachment is on a Cross-Cloud Interconnect connection, this field + * contains the interconnect's remote location service provider. Example + * values: "Amazon Web Services" "Microsoft Azure". + * The field is set only for attachments on Cross-Cloud Interconnect + * connections. Its value is copied from the InterconnectRemoteLocation + * remoteService field. * * Generated from protobuf field optional string remote_service = 391954364; * @return string @@ -1513,7 +2169,13 @@ public function clearRemoteService() } /** - * [Output Only] If the attachment is on a Cross-Cloud Interconnect connection, this field contains the interconnect's remote location service provider. Example values: "Amazon Web Services" "Microsoft Azure". The field is set only for attachments on Cross-Cloud Interconnect connections. Its value is copied from the InterconnectRemoteLocation remoteService field. + * [Output Only] + * If the attachment is on a Cross-Cloud Interconnect connection, this field + * contains the interconnect's remote location service provider. Example + * values: "Amazon Web Services" "Microsoft Azure". + * The field is set only for attachments on Cross-Cloud Interconnect + * connections. Its value is copied from the InterconnectRemoteLocation + * remoteService field. * * Generated from protobuf field optional string remote_service = 391954364; * @param string $var @@ -1528,7 +2190,10 @@ public function setRemoteService($var) } /** - * URL of the Cloud Router to be used for dynamic routing. This router must be in the same region as this InterconnectAttachment. The InterconnectAttachment will automatically connect the Interconnect to the network & region within which the Cloud Router is configured. + * URL of the Cloud Router to be used for dynamic routing. This router must be + * in the same region as this InterconnectAttachment. The + * InterconnectAttachment will automatically connect the Interconnect to the + * network & region within which the Cloud Router is configured. * * Generated from protobuf field optional string router = 148608841; * @return string @@ -1549,7 +2214,10 @@ public function clearRouter() } /** - * URL of the Cloud Router to be used for dynamic routing. This router must be in the same region as this InterconnectAttachment. The InterconnectAttachment will automatically connect the Interconnect to the network & region within which the Cloud Router is configured. + * URL of the Cloud Router to be used for dynamic routing. This router must be + * in the same region as this InterconnectAttachment. The + * InterconnectAttachment will automatically connect the Interconnect to the + * network & region within which the Cloud Router is configured. * * Generated from protobuf field optional string router = 148608841; * @param string $var @@ -1636,7 +2304,11 @@ public function setSelfLink($var) } /** - * The stack type for this interconnect attachment to identify whether the IPv6 feature is enabled or not. If not specified, IPV4_ONLY will be used. This field can be both set at interconnect attachments creation and update interconnect attachment operations. + * The stack type for this interconnect attachment to identify whether the + * IPv6 feature is enabled or not. If not specified, IPV4_ONLY + * will be used. + * This field can be both set at interconnect attachments creation and + * update interconnect attachment operations. * Check the StackType enum for the list of possible values. * * Generated from protobuf field optional string stack_type = 425908881; @@ -1658,7 +2330,11 @@ public function clearStackType() } /** - * The stack type for this interconnect attachment to identify whether the IPv6 feature is enabled or not. If not specified, IPV4_ONLY will be used. This field can be both set at interconnect attachments creation and update interconnect attachment operations. + * The stack type for this interconnect attachment to identify whether the + * IPv6 feature is enabled or not. If not specified, IPV4_ONLY + * will be used. + * This field can be both set at interconnect attachments creation and + * update interconnect attachment operations. * Check the StackType enum for the list of possible values. * * Generated from protobuf field optional string stack_type = 425908881; @@ -1674,7 +2350,26 @@ public function setStackType($var) } /** - * [Output Only] The current state of this attachment's functionality. Enum values ACTIVE and UNPROVISIONED are shared by DEDICATED/PRIVATE, PARTNER, and PARTNER_PROVIDER interconnect attachments, while enum values PENDING_PARTNER, PARTNER_REQUEST_RECEIVED, and PENDING_CUSTOMER are used for only PARTNER and PARTNER_PROVIDER interconnect attachments. This state can take one of the following values: - ACTIVE: The attachment has been turned up and is ready to use. - UNPROVISIONED: The attachment is not ready to use yet, because turnup is not complete. - PENDING_PARTNER: A newly-created PARTNER attachment that has not yet been configured on the Partner side. - PARTNER_REQUEST_RECEIVED: A PARTNER attachment is in the process of provisioning after a PARTNER_PROVIDER attachment was created that references it. - PENDING_CUSTOMER: A PARTNER or PARTNER_PROVIDER attachment that is waiting for a customer to activate it. - DEFUNCT: The attachment was deleted externally and is no longer functional. This could be because the associated Interconnect was removed, or because the other side of a Partner attachment was deleted. + * [Output Only] The current state of this attachment's functionality. + * Enum values ACTIVE and UNPROVISIONED are shared by DEDICATED/PRIVATE, + * PARTNER, and PARTNER_PROVIDER interconnect attachments, while enum values + * PENDING_PARTNER, PARTNER_REQUEST_RECEIVED, and PENDING_CUSTOMER are used + * for only PARTNER and PARTNER_PROVIDER interconnect attachments. + * This state can take one of the following values: + * - ACTIVE: The attachment has been turned up and is ready to use. + * - UNPROVISIONED: The attachment is not ready to use yet, because turnup + * is not complete. + * - PENDING_PARTNER: A newly-created PARTNER attachment that has not yet + * been configured on the Partner side. + * - PARTNER_REQUEST_RECEIVED: A PARTNER attachment is in the process of + * provisioning after a PARTNER_PROVIDER attachment was created that + * references it. + * - PENDING_CUSTOMER: A PARTNER or PARTNER_PROVIDER + * attachment that is waiting for a customer to activate it. + * - DEFUNCT: + * The attachment was deleted externally and is no longer functional. This + * could be because the associated Interconnect was removed, or because the + * other side of a Partner attachment was deleted. * Check the State enum for the list of possible values. * * Generated from protobuf field optional string state = 109757585; @@ -1696,7 +2391,26 @@ public function clearState() } /** - * [Output Only] The current state of this attachment's functionality. Enum values ACTIVE and UNPROVISIONED are shared by DEDICATED/PRIVATE, PARTNER, and PARTNER_PROVIDER interconnect attachments, while enum values PENDING_PARTNER, PARTNER_REQUEST_RECEIVED, and PENDING_CUSTOMER are used for only PARTNER and PARTNER_PROVIDER interconnect attachments. This state can take one of the following values: - ACTIVE: The attachment has been turned up and is ready to use. - UNPROVISIONED: The attachment is not ready to use yet, because turnup is not complete. - PENDING_PARTNER: A newly-created PARTNER attachment that has not yet been configured on the Partner side. - PARTNER_REQUEST_RECEIVED: A PARTNER attachment is in the process of provisioning after a PARTNER_PROVIDER attachment was created that references it. - PENDING_CUSTOMER: A PARTNER or PARTNER_PROVIDER attachment that is waiting for a customer to activate it. - DEFUNCT: The attachment was deleted externally and is no longer functional. This could be because the associated Interconnect was removed, or because the other side of a Partner attachment was deleted. + * [Output Only] The current state of this attachment's functionality. + * Enum values ACTIVE and UNPROVISIONED are shared by DEDICATED/PRIVATE, + * PARTNER, and PARTNER_PROVIDER interconnect attachments, while enum values + * PENDING_PARTNER, PARTNER_REQUEST_RECEIVED, and PENDING_CUSTOMER are used + * for only PARTNER and PARTNER_PROVIDER interconnect attachments. + * This state can take one of the following values: + * - ACTIVE: The attachment has been turned up and is ready to use. + * - UNPROVISIONED: The attachment is not ready to use yet, because turnup + * is not complete. + * - PENDING_PARTNER: A newly-created PARTNER attachment that has not yet + * been configured on the Partner side. + * - PARTNER_REQUEST_RECEIVED: A PARTNER attachment is in the process of + * provisioning after a PARTNER_PROVIDER attachment was created that + * references it. + * - PENDING_CUSTOMER: A PARTNER or PARTNER_PROVIDER + * attachment that is waiting for a customer to activate it. + * - DEFUNCT: + * The attachment was deleted externally and is no longer functional. This + * could be because the associated Interconnect was removed, or because the + * other side of a Partner attachment was deleted. * Check the State enum for the list of possible values. * * Generated from protobuf field optional string state = 109757585; @@ -1712,7 +2426,18 @@ public function setState($var) } /** - * Input only. Length of the IPv4 subnet mask. Allowed values: - 29 (default) - 30 The default value is 29, except for Cross-Cloud Interconnect connections that use an InterconnectRemoteLocation with a constraints.subnetLengthRange.min equal to 30. For example, connections that use an Azure remote location fall into this category. In these cases, the default value is 30, and requesting 29 returns an error. Where both 29 and 30 are allowed, 29 is preferred, because it gives Google Cloud Support more debugging visibility. + * Input only. Length of the IPv4 subnet mask. + * Allowed values: + * - 29 (default) + * - 30 + * The default value is 29, except for Cross-Cloud Interconnect + * connections that use an InterconnectRemoteLocation with a + * constraints.subnetLengthRange.min equal to 30. For example, + * connections that use an Azure remote location fall into this + * category. In these cases, the default value is 30, and requesting + * 29 returns an error. + * Where both 29 and 30 are allowed, 29 is preferred, because it gives + * Google Cloud Support more debugging visibility. * * Generated from protobuf field optional int32 subnet_length = 279831048; * @return int @@ -1733,7 +2458,18 @@ public function clearSubnetLength() } /** - * Input only. Length of the IPv4 subnet mask. Allowed values: - 29 (default) - 30 The default value is 29, except for Cross-Cloud Interconnect connections that use an InterconnectRemoteLocation with a constraints.subnetLengthRange.min equal to 30. For example, connections that use an Azure remote location fall into this category. In these cases, the default value is 30, and requesting 29 returns an error. Where both 29 and 30 are allowed, 29 is preferred, because it gives Google Cloud Support more debugging visibility. + * Input only. Length of the IPv4 subnet mask. + * Allowed values: + * - 29 (default) + * - 30 + * The default value is 29, except for Cross-Cloud Interconnect + * connections that use an InterconnectRemoteLocation with a + * constraints.subnetLengthRange.min equal to 30. For example, + * connections that use an Azure remote location fall into this + * category. In these cases, the default value is 30, and requesting + * 29 returns an error. + * Where both 29 and 30 are allowed, 29 is preferred, because it gives + * Google Cloud Support more debugging visibility. * * Generated from protobuf field optional int32 subnet_length = 279831048; * @param int $var @@ -1748,7 +2484,14 @@ public function setSubnetLength($var) } /** - * The type of interconnect attachment this is, which can take one of the following values: - DEDICATED: an attachment to a Dedicated Interconnect. - PARTNER: an attachment to a Partner Interconnect, created by the customer. - PARTNER_PROVIDER: an attachment to a Partner Interconnect, created by the partner. + * The type of interconnect attachment this is, which can take one of the + * following values: + * - DEDICATED: an attachment to a Dedicated Interconnect. + * - PARTNER: an attachment to a Partner Interconnect, created by the + * customer. + * - PARTNER_PROVIDER: an attachment to a Partner Interconnect, created by + * the partner. + * - L2_DEDICATED: a L2 attachment to a Dedicated Interconnect. * Check the Type enum for the list of possible values. * * Generated from protobuf field optional string type = 3575610; @@ -1770,7 +2513,14 @@ public function clearType() } /** - * The type of interconnect attachment this is, which can take one of the following values: - DEDICATED: an attachment to a Dedicated Interconnect. - PARTNER: an attachment to a Partner Interconnect, created by the customer. - PARTNER_PROVIDER: an attachment to a Partner Interconnect, created by the partner. + * The type of interconnect attachment this is, which can take one of the + * following values: + * - DEDICATED: an attachment to a Dedicated Interconnect. + * - PARTNER: an attachment to a Partner Interconnect, created by the + * customer. + * - PARTNER_PROVIDER: an attachment to a Partner Interconnect, created by + * the partner. + * - L2_DEDICATED: a L2 attachment to a Dedicated Interconnect. * Check the Type enum for the list of possible values. * * Generated from protobuf field optional string type = 3575610; @@ -1786,7 +2536,8 @@ public function setType($var) } /** - * The IEEE 802.1Q VLAN tag for this attachment, in the range 2-4093. Only specified at creation time. + * The IEEE 802.1Q VLAN tag for this attachment, in the range 2-4093. + * Only specified at creation time. * * Generated from protobuf field optional int32 vlan_tag8021q = 119927836; * @return int @@ -1807,7 +2558,8 @@ public function clearVlanTag8021Q() } /** - * The IEEE 802.1Q VLAN tag for this attachment, in the range 2-4093. Only specified at creation time. + * The IEEE 802.1Q VLAN tag for this attachment, in the range 2-4093. + * Only specified at creation time. * * Generated from protobuf field optional int32 vlan_tag8021q = 119927836; * @param int $var diff --git a/Compute/src/V1/InterconnectAttachment/Bandwidth.php b/Compute/src/V1/InterconnectAttachment/Bandwidth.php index e44a51e5a2e0..acd640684173 100644 --- a/Compute/src/V1/InterconnectAttachment/Bandwidth.php +++ b/Compute/src/V1/InterconnectAttachment/Bandwidth.php @@ -7,7 +7,25 @@ use UnexpectedValueException; /** - * Provisioned bandwidth capacity for the interconnect attachment. For attachments of type DEDICATED, the user can set the bandwidth. For attachments of type PARTNER, the Google Partner that is operating the interconnect must set the bandwidth. Output only for PARTNER type, mutable for PARTNER_PROVIDER and DEDICATED, and can take one of the following values: - BPS_50M: 50 Mbit/s - BPS_100M: 100 Mbit/s - BPS_200M: 200 Mbit/s - BPS_300M: 300 Mbit/s - BPS_400M: 400 Mbit/s - BPS_500M: 500 Mbit/s - BPS_1G: 1 Gbit/s - BPS_2G: 2 Gbit/s - BPS_5G: 5 Gbit/s - BPS_10G: 10 Gbit/s - BPS_20G: 20 Gbit/s - BPS_50G: 50 Gbit/s - BPS_100G: 100 Gbit/s + * Provisioned bandwidth capacity for the interconnect attachment. For + * attachments of type DEDICATED, the user can set the bandwidth. + * For attachments of type PARTNER, the Google Partner that is operating + * the interconnect must set the bandwidth. + * Output only for PARTNER type, mutable for PARTNER_PROVIDER and DEDICATED, + * and can take one of the following values: + * - BPS_50M: 50 Mbit/s + * - BPS_100M: 100 Mbit/s + * - BPS_200M: 200 Mbit/s + * - BPS_300M: 300 Mbit/s + * - BPS_400M: 400 Mbit/s + * - BPS_500M: 500 Mbit/s + * - BPS_1G: 1 Gbit/s + * - BPS_2G: 2 Gbit/s + * - BPS_5G: 5 Gbit/s + * - BPS_10G: 10 Gbit/s + * - BPS_20G: 20 Gbit/s + * - BPS_50G: 50 Gbit/s + * - BPS_100G: 100 Gbit/s * * Protobuf type google.cloud.compute.v1.InterconnectAttachment.Bandwidth */ diff --git a/Compute/src/V1/InterconnectAttachment/EdgeAvailabilityDomain.php b/Compute/src/V1/InterconnectAttachment/EdgeAvailabilityDomain.php index 14d909e1d18f..177b5a74ad18 100644 --- a/Compute/src/V1/InterconnectAttachment/EdgeAvailabilityDomain.php +++ b/Compute/src/V1/InterconnectAttachment/EdgeAvailabilityDomain.php @@ -7,7 +7,16 @@ use UnexpectedValueException; /** - * Input only. Desired availability domain for the attachment. Only available for type PARTNER, at creation time, and can take one of the following values: - AVAILABILITY_DOMAIN_ANY - AVAILABILITY_DOMAIN_1 - AVAILABILITY_DOMAIN_2 For improved reliability, customers should configure a pair of attachments, one per availability domain. The selected availability domain will be provided to the Partner via the pairing key, so that the provisioned circuit will lie in the specified domain. If not specified, the value will default to AVAILABILITY_DOMAIN_ANY. + * Input only. Desired availability domain for the attachment. Only available for type + * PARTNER, at creation time, and can take one of the following values: + * - AVAILABILITY_DOMAIN_ANY + * - AVAILABILITY_DOMAIN_1 + * - AVAILABILITY_DOMAIN_2 + * For improved reliability, customers should configure a pair of attachments, + * one per availability domain. The selected availability domain will be + * provided to the Partner via the pairing key, so that the provisioned + * circuit will lie in the specified domain. If not specified, the value will + * default to AVAILABILITY_DOMAIN_ANY. * * Protobuf type google.cloud.compute.v1.InterconnectAttachment.EdgeAvailabilityDomain */ diff --git a/Compute/src/V1/InterconnectAttachment/Encryption.php b/Compute/src/V1/InterconnectAttachment/Encryption.php index ed0389cf84ba..a2990f5c03ec 100644 --- a/Compute/src/V1/InterconnectAttachment/Encryption.php +++ b/Compute/src/V1/InterconnectAttachment/Encryption.php @@ -7,7 +7,19 @@ use UnexpectedValueException; /** - * Indicates the user-supplied encryption option of this VLAN attachment (interconnectAttachment). Can only be specified at attachment creation for PARTNER or DEDICATED attachments. Possible values are: - NONE - This is the default value, which means that the VLAN attachment carries unencrypted traffic. VMs are able to send traffic to, or receive traffic from, such a VLAN attachment. - IPSEC - The VLAN attachment carries only encrypted traffic that is encrypted by an IPsec device, such as an HA VPN gateway or third-party IPsec VPN. VMs cannot directly send traffic to, or receive traffic from, such a VLAN attachment. To use *HA VPN over Cloud Interconnect*, the VLAN attachment must be created with this option. + * Indicates the user-supplied encryption option of this VLAN attachment + * (interconnectAttachment). Can only be specified at attachment creation + * for PARTNER or DEDICATED attachments. + * Possible values are: + * - NONE - This is the default value, which means that the + * VLAN attachment carries unencrypted traffic. VMs are able to send + * traffic to, or receive traffic from, such a VLAN attachment. + * - IPSEC - The VLAN attachment carries only encrypted + * traffic that is encrypted by an IPsec device, such as an HA VPN gateway or + * third-party IPsec VPN. VMs cannot directly send traffic to, or receive + * traffic from, such a VLAN attachment. To use *HA VPN over Cloud + * Interconnect*, the VLAN attachment must be created with this + * option. * * Protobuf type google.cloud.compute.v1.InterconnectAttachment.Encryption */ @@ -20,13 +32,19 @@ class Encryption */ const UNDEFINED_ENCRYPTION = 0; /** - * The interconnect attachment will carry only encrypted traffic that is encrypted by an IPsec device such as HA VPN gateway; VMs cannot directly send traffic to or receive traffic from such an interconnect attachment. To use HA VPN over Cloud Interconnect, the interconnect attachment must be created with this option. + * The interconnect attachment will carry only encrypted traffic that is + * encrypted by an IPsec device such as HA VPN gateway; + * VMs cannot directly send traffic to or receive traffic from such an + * interconnect attachment. To use HA VPN over Cloud Interconnect, + * the interconnect attachment must be created with this option. * * Generated from protobuf enum IPSEC = 69882282; */ const IPSEC = 69882282; /** - * This is the default value, which means the Interconnect Attachment will carry unencrypted traffic. VMs will be able to send traffic to or receive traffic from such interconnect attachment. + * This is the default value, which means the Interconnect Attachment will + * carry unencrypted traffic. VMs will be able to send traffic to or receive + * traffic from such interconnect attachment. * * Generated from protobuf enum NONE = 2402104; */ diff --git a/Compute/src/V1/InterconnectAttachment/OperationalStatus.php b/Compute/src/V1/InterconnectAttachment/OperationalStatus.php index f6837c0147ab..8f2da34a52e7 100644 --- a/Compute/src/V1/InterconnectAttachment/OperationalStatus.php +++ b/Compute/src/V1/InterconnectAttachment/OperationalStatus.php @@ -7,7 +7,12 @@ use UnexpectedValueException; /** - * [Output Only] The current status of whether or not this interconnect attachment is functional, which can take one of the following values: - OS_ACTIVE: The attachment has been turned up and is ready to use. - OS_UNPROVISIONED: The attachment is not ready to use yet, because turnup is not complete. + * [Output Only] The current status of whether or not this interconnect + * attachment is functional, which can take one of the following values: + * - OS_ACTIVE: The attachment has been turned up and is ready to + * use. + * - OS_UNPROVISIONED: The attachment is not ready to use yet, + * because turnup is not complete. * * Protobuf type google.cloud.compute.v1.InterconnectAttachment.OperationalStatus */ @@ -20,13 +25,15 @@ class OperationalStatus */ const UNDEFINED_OPERATIONAL_STATUS = 0; /** - * Indicates that attachment has been turned up and is ready to use. + * Indicates that attachment has been turned up and is ready to + * use. * * Generated from protobuf enum OS_ACTIVE = 55721409; */ const OS_ACTIVE = 55721409; /** - * Indicates that attachment is not ready to use yet, because turnup is not complete. + * Indicates that attachment is not ready to use yet, because + * turnup is not complete. * * Generated from protobuf enum OS_UNPROVISIONED = 239771840; */ diff --git a/Compute/src/V1/InterconnectAttachment/StackType.php b/Compute/src/V1/InterconnectAttachment/StackType.php index ddfa63589e3d..c4200eb37f29 100644 --- a/Compute/src/V1/InterconnectAttachment/StackType.php +++ b/Compute/src/V1/InterconnectAttachment/StackType.php @@ -7,7 +7,11 @@ use UnexpectedValueException; /** - * The stack type for this interconnect attachment to identify whether the IPv6 feature is enabled or not. If not specified, IPV4_ONLY will be used. This field can be both set at interconnect attachments creation and update interconnect attachment operations. + * The stack type for this interconnect attachment to identify whether the + * IPv6 feature is enabled or not. If not specified, IPV4_ONLY + * will be used. + * This field can be both set at interconnect attachments creation and + * update interconnect attachment operations. * * Protobuf type google.cloud.compute.v1.InterconnectAttachment.StackType */ diff --git a/Compute/src/V1/InterconnectAttachment/State.php b/Compute/src/V1/InterconnectAttachment/State.php index 223fa8c9ce0f..4b7de27d52f5 100644 --- a/Compute/src/V1/InterconnectAttachment/State.php +++ b/Compute/src/V1/InterconnectAttachment/State.php @@ -7,7 +7,26 @@ use UnexpectedValueException; /** - * [Output Only] The current state of this attachment's functionality. Enum values ACTIVE and UNPROVISIONED are shared by DEDICATED/PRIVATE, PARTNER, and PARTNER_PROVIDER interconnect attachments, while enum values PENDING_PARTNER, PARTNER_REQUEST_RECEIVED, and PENDING_CUSTOMER are used for only PARTNER and PARTNER_PROVIDER interconnect attachments. This state can take one of the following values: - ACTIVE: The attachment has been turned up and is ready to use. - UNPROVISIONED: The attachment is not ready to use yet, because turnup is not complete. - PENDING_PARTNER: A newly-created PARTNER attachment that has not yet been configured on the Partner side. - PARTNER_REQUEST_RECEIVED: A PARTNER attachment is in the process of provisioning after a PARTNER_PROVIDER attachment was created that references it. - PENDING_CUSTOMER: A PARTNER or PARTNER_PROVIDER attachment that is waiting for a customer to activate it. - DEFUNCT: The attachment was deleted externally and is no longer functional. This could be because the associated Interconnect was removed, or because the other side of a Partner attachment was deleted. + * [Output Only] The current state of this attachment's functionality. + * Enum values ACTIVE and UNPROVISIONED are shared by DEDICATED/PRIVATE, + * PARTNER, and PARTNER_PROVIDER interconnect attachments, while enum values + * PENDING_PARTNER, PARTNER_REQUEST_RECEIVED, and PENDING_CUSTOMER are used + * for only PARTNER and PARTNER_PROVIDER interconnect attachments. + * This state can take one of the following values: + * - ACTIVE: The attachment has been turned up and is ready to use. + * - UNPROVISIONED: The attachment is not ready to use yet, because turnup + * is not complete. + * - PENDING_PARTNER: A newly-created PARTNER attachment that has not yet + * been configured on the Partner side. + * - PARTNER_REQUEST_RECEIVED: A PARTNER attachment is in the process of + * provisioning after a PARTNER_PROVIDER attachment was created that + * references it. + * - PENDING_CUSTOMER: A PARTNER or PARTNER_PROVIDER + * attachment that is waiting for a customer to activate it. + * - DEFUNCT: + * The attachment was deleted externally and is no longer functional. This + * could be because the associated Interconnect was removed, or because the + * other side of a Partner attachment was deleted. * * Protobuf type google.cloud.compute.v1.InterconnectAttachment.State */ @@ -26,25 +45,30 @@ class State */ const ACTIVE = 314733318; /** - * The attachment was deleted externally and is no longer functional. This could be because the associated Interconnect was wiped out, or because the other side of a Partner attachment was deleted. + * The attachment was deleted externally and is no longer functional. + * This could be because the associated Interconnect was wiped out, + * or because the other side of a Partner attachment was deleted. * * Generated from protobuf enum DEFUNCT = 115891759; */ const DEFUNCT = 115891759; /** - * A PARTNER attachment is in the process of provisioning after a PARTNER_PROVIDER attachment was created that references it. + * A PARTNER attachment is in the process of provisioning after a + * PARTNER_PROVIDER attachment was created that references it. * * Generated from protobuf enum PARTNER_REQUEST_RECEIVED = 513587304; */ const PARTNER_REQUEST_RECEIVED = 513587304; /** - * PARTNER or PARTNER_PROVIDER attachment that is waiting for the customer to activate. + * PARTNER or PARTNER_PROVIDER attachment that is waiting for the customer + * to activate. * * Generated from protobuf enum PENDING_CUSTOMER = 167494054; */ const PENDING_CUSTOMER = 167494054; /** - * A newly created PARTNER attachment that has not yet been configured on the Partner side. + * A newly created PARTNER attachment that has not yet been configured on + * the Partner side. * * Generated from protobuf enum PENDING_PARTNER = 387890656; */ @@ -54,7 +78,8 @@ class State */ const STATE_UNSPECIFIED = 470755401; /** - * Indicates that attachment is not ready to use yet, because turnup is not complete. + * Indicates that attachment is not ready to use yet, because turnup is not + * complete. * * Generated from protobuf enum UNPROVISIONED = 517333979; */ diff --git a/Compute/src/V1/InterconnectAttachment/Type.php b/Compute/src/V1/InterconnectAttachment/Type.php index 16a92227d8fc..187f3c961006 100644 --- a/Compute/src/V1/InterconnectAttachment/Type.php +++ b/Compute/src/V1/InterconnectAttachment/Type.php @@ -7,7 +7,14 @@ use UnexpectedValueException; /** - * The type of interconnect attachment this is, which can take one of the following values: - DEDICATED: an attachment to a Dedicated Interconnect. - PARTNER: an attachment to a Partner Interconnect, created by the customer. - PARTNER_PROVIDER: an attachment to a Partner Interconnect, created by the partner. + * The type of interconnect attachment this is, which can take one of the + * following values: + * - DEDICATED: an attachment to a Dedicated Interconnect. + * - PARTNER: an attachment to a Partner Interconnect, created by the + * customer. + * - PARTNER_PROVIDER: an attachment to a Partner Interconnect, created by + * the partner. + * - L2_DEDICATED: a L2 attachment to a Dedicated Interconnect. * * Protobuf type google.cloud.compute.v1.InterconnectAttachment.Type */ @@ -25,6 +32,12 @@ class Type * Generated from protobuf enum DEDICATED = 258411983; */ const DEDICATED = 258411983; + /** + * Attachment to a dedicated interconnect, forwarding L2 packets. + * + * Generated from protobuf enum L2_DEDICATED = 336595510; + */ + const L2_DEDICATED = 336595510; /** * Attachment to a partner interconnect, created by the customer. * @@ -41,6 +54,7 @@ class Type private static $valueToName = [ self::UNDEFINED_TYPE => 'UNDEFINED_TYPE', self::DEDICATED => 'DEDICATED', + self::L2_DEDICATED => 'L2_DEDICATED', self::PARTNER => 'PARTNER', self::PARTNER_PROVIDER => 'PARTNER_PROVIDER', ]; diff --git a/Compute/src/V1/InterconnectAttachmentAggregatedList.php b/Compute/src/V1/InterconnectAttachmentAggregatedList.php index 83f05c11b261..011b64a42ea1 100644 --- a/Compute/src/V1/InterconnectAttachmentAggregatedList.php +++ b/Compute/src/V1/InterconnectAttachmentAggregatedList.php @@ -27,13 +27,18 @@ class InterconnectAttachmentAggregatedList extends \Google\Protobuf\Internal\Mes */ private $items; /** - * [Output Only] Type of resource. Always compute#interconnectAttachmentAggregatedList for aggregated lists of interconnect attachments. + * [Output Only] Type of resource. Alwayscompute#interconnectAttachmentAggregatedList for aggregated + * lists of interconnect attachments. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -68,9 +73,14 @@ class InterconnectAttachmentAggregatedList extends \Google\Protobuf\Internal\Mes * @type array|\Google\Protobuf\Internal\MapField $items * A list of InterconnectAttachmentsScopedList resources. * @type string $kind - * [Output Only] Type of resource. Always compute#interconnectAttachmentAggregatedList for aggregated lists of interconnect attachments. + * [Output Only] Type of resource. Alwayscompute#interconnectAttachmentAggregatedList for aggregated + * lists of interconnect attachments. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type array|\Google\Protobuf\Internal\RepeatedField $unreachables @@ -147,7 +157,8 @@ public function setItems($var) } /** - * [Output Only] Type of resource. Always compute#interconnectAttachmentAggregatedList for aggregated lists of interconnect attachments. + * [Output Only] Type of resource. Alwayscompute#interconnectAttachmentAggregatedList for aggregated + * lists of interconnect attachments. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -168,7 +179,8 @@ public function clearKind() } /** - * [Output Only] Type of resource. Always compute#interconnectAttachmentAggregatedList for aggregated lists of interconnect attachments. + * [Output Only] Type of resource. Alwayscompute#interconnectAttachmentAggregatedList for aggregated + * lists of interconnect attachments. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -183,7 +195,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -204,7 +220,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/InterconnectAttachmentConfigurationConstraints.php b/Compute/src/V1/InterconnectAttachmentConfigurationConstraints.php index 86ec168818c2..d34ea6c13960 100644 --- a/Compute/src/V1/InterconnectAttachmentConfigurationConstraints.php +++ b/Compute/src/V1/InterconnectAttachmentConfigurationConstraints.php @@ -15,14 +15,27 @@ class InterconnectAttachmentConfigurationConstraints extends \Google\Protobuf\Internal\Message { /** - * [Output Only] Whether the attachment's BGP session requires/allows/disallows BGP MD5 authentication. This can take one of the following values: MD5_OPTIONAL, MD5_REQUIRED, MD5_UNSUPPORTED. For example, a Cross-Cloud Interconnect connection to a remote cloud provider that requires BGP MD5 authentication has the interconnectRemoteLocation attachment_configuration_constraints.bgp_md5 field set to MD5_REQUIRED, and that property is propagated to the attachment. Similarly, if BGP MD5 is MD5_UNSUPPORTED, an error is returned if MD5 is requested. + * [Output Only] Whether the attachment's BGP session + * requires/allows/disallows BGP MD5 authentication. This can take one of + * the following values: MD5_OPTIONAL, MD5_REQUIRED, MD5_UNSUPPORTED. + * For example, a Cross-Cloud Interconnect connection to a remote cloud + * provider that requires BGP MD5 authentication has the + * interconnectRemoteLocation attachment_configuration_constraints.bgp_md5 + * field set to MD5_REQUIRED, and that property is propagated to the + * attachment. Similarly, if BGP MD5 is MD5_UNSUPPORTED, an error is + * returned if MD5 is requested. * Check the BgpMd5 enum for the list of possible values. * * Generated from protobuf field optional string bgp_md5 = 373093386; */ protected $bgp_md5 = null; /** - * [Output Only] List of ASN ranges that the remote location is known to support. Formatted as an array of inclusive ranges {min: min-value, max: max-value}. For example, [{min: 123, max: 123}, {min: 64512, max: 65534}] allows the peer ASN to be 123 or anything in the range 64512-65534. This field is only advisory. Although the API accepts other ranges, these are the ranges that we recommend. + * [Output Only] List of ASN ranges that the remote location is known to + * support. Formatted as an array of inclusive ranges {min: min-value, max: + * max-value}. For example, [{min: 123, max: 123}, {min: 64512, max: 65534}] + * allows the peer ASN to be 123 or anything in the range 64512-65534. + * This field is only advisory. Although the API accepts other ranges, these + * are the ranges that we recommend. * * Generated from protobuf field repeated .google.cloud.compute.v1.InterconnectAttachmentConfigurationConstraintsBgpPeerASNRange bgp_peer_asn_ranges = 475946370; */ @@ -35,10 +48,23 @@ class InterconnectAttachmentConfigurationConstraints extends \Google\Protobuf\In * Optional. Data for populating the Message object. * * @type string $bgp_md5 - * [Output Only] Whether the attachment's BGP session requires/allows/disallows BGP MD5 authentication. This can take one of the following values: MD5_OPTIONAL, MD5_REQUIRED, MD5_UNSUPPORTED. For example, a Cross-Cloud Interconnect connection to a remote cloud provider that requires BGP MD5 authentication has the interconnectRemoteLocation attachment_configuration_constraints.bgp_md5 field set to MD5_REQUIRED, and that property is propagated to the attachment. Similarly, if BGP MD5 is MD5_UNSUPPORTED, an error is returned if MD5 is requested. + * [Output Only] Whether the attachment's BGP session + * requires/allows/disallows BGP MD5 authentication. This can take one of + * the following values: MD5_OPTIONAL, MD5_REQUIRED, MD5_UNSUPPORTED. + * For example, a Cross-Cloud Interconnect connection to a remote cloud + * provider that requires BGP MD5 authentication has the + * interconnectRemoteLocation attachment_configuration_constraints.bgp_md5 + * field set to MD5_REQUIRED, and that property is propagated to the + * attachment. Similarly, if BGP MD5 is MD5_UNSUPPORTED, an error is + * returned if MD5 is requested. * Check the BgpMd5 enum for the list of possible values. * @type array<\Google\Cloud\Compute\V1\InterconnectAttachmentConfigurationConstraintsBgpPeerASNRange>|\Google\Protobuf\Internal\RepeatedField $bgp_peer_asn_ranges - * [Output Only] List of ASN ranges that the remote location is known to support. Formatted as an array of inclusive ranges {min: min-value, max: max-value}. For example, [{min: 123, max: 123}, {min: 64512, max: 65534}] allows the peer ASN to be 123 or anything in the range 64512-65534. This field is only advisory. Although the API accepts other ranges, these are the ranges that we recommend. + * [Output Only] List of ASN ranges that the remote location is known to + * support. Formatted as an array of inclusive ranges {min: min-value, max: + * max-value}. For example, [{min: 123, max: 123}, {min: 64512, max: 65534}] + * allows the peer ASN to be 123 or anything in the range 64512-65534. + * This field is only advisory. Although the API accepts other ranges, these + * are the ranges that we recommend. * } */ public function __construct($data = NULL) { @@ -47,7 +73,15 @@ public function __construct($data = NULL) { } /** - * [Output Only] Whether the attachment's BGP session requires/allows/disallows BGP MD5 authentication. This can take one of the following values: MD5_OPTIONAL, MD5_REQUIRED, MD5_UNSUPPORTED. For example, a Cross-Cloud Interconnect connection to a remote cloud provider that requires BGP MD5 authentication has the interconnectRemoteLocation attachment_configuration_constraints.bgp_md5 field set to MD5_REQUIRED, and that property is propagated to the attachment. Similarly, if BGP MD5 is MD5_UNSUPPORTED, an error is returned if MD5 is requested. + * [Output Only] Whether the attachment's BGP session + * requires/allows/disallows BGP MD5 authentication. This can take one of + * the following values: MD5_OPTIONAL, MD5_REQUIRED, MD5_UNSUPPORTED. + * For example, a Cross-Cloud Interconnect connection to a remote cloud + * provider that requires BGP MD5 authentication has the + * interconnectRemoteLocation attachment_configuration_constraints.bgp_md5 + * field set to MD5_REQUIRED, and that property is propagated to the + * attachment. Similarly, if BGP MD5 is MD5_UNSUPPORTED, an error is + * returned if MD5 is requested. * Check the BgpMd5 enum for the list of possible values. * * Generated from protobuf field optional string bgp_md5 = 373093386; @@ -69,7 +103,15 @@ public function clearBgpMd5() } /** - * [Output Only] Whether the attachment's BGP session requires/allows/disallows BGP MD5 authentication. This can take one of the following values: MD5_OPTIONAL, MD5_REQUIRED, MD5_UNSUPPORTED. For example, a Cross-Cloud Interconnect connection to a remote cloud provider that requires BGP MD5 authentication has the interconnectRemoteLocation attachment_configuration_constraints.bgp_md5 field set to MD5_REQUIRED, and that property is propagated to the attachment. Similarly, if BGP MD5 is MD5_UNSUPPORTED, an error is returned if MD5 is requested. + * [Output Only] Whether the attachment's BGP session + * requires/allows/disallows BGP MD5 authentication. This can take one of + * the following values: MD5_OPTIONAL, MD5_REQUIRED, MD5_UNSUPPORTED. + * For example, a Cross-Cloud Interconnect connection to a remote cloud + * provider that requires BGP MD5 authentication has the + * interconnectRemoteLocation attachment_configuration_constraints.bgp_md5 + * field set to MD5_REQUIRED, and that property is propagated to the + * attachment. Similarly, if BGP MD5 is MD5_UNSUPPORTED, an error is + * returned if MD5 is requested. * Check the BgpMd5 enum for the list of possible values. * * Generated from protobuf field optional string bgp_md5 = 373093386; @@ -85,7 +127,12 @@ public function setBgpMd5($var) } /** - * [Output Only] List of ASN ranges that the remote location is known to support. Formatted as an array of inclusive ranges {min: min-value, max: max-value}. For example, [{min: 123, max: 123}, {min: 64512, max: 65534}] allows the peer ASN to be 123 or anything in the range 64512-65534. This field is only advisory. Although the API accepts other ranges, these are the ranges that we recommend. + * [Output Only] List of ASN ranges that the remote location is known to + * support. Formatted as an array of inclusive ranges {min: min-value, max: + * max-value}. For example, [{min: 123, max: 123}, {min: 64512, max: 65534}] + * allows the peer ASN to be 123 or anything in the range 64512-65534. + * This field is only advisory. Although the API accepts other ranges, these + * are the ranges that we recommend. * * Generated from protobuf field repeated .google.cloud.compute.v1.InterconnectAttachmentConfigurationConstraintsBgpPeerASNRange bgp_peer_asn_ranges = 475946370; * @return \Google\Protobuf\Internal\RepeatedField @@ -96,7 +143,12 @@ public function getBgpPeerAsnRanges() } /** - * [Output Only] List of ASN ranges that the remote location is known to support. Formatted as an array of inclusive ranges {min: min-value, max: max-value}. For example, [{min: 123, max: 123}, {min: 64512, max: 65534}] allows the peer ASN to be 123 or anything in the range 64512-65534. This field is only advisory. Although the API accepts other ranges, these are the ranges that we recommend. + * [Output Only] List of ASN ranges that the remote location is known to + * support. Formatted as an array of inclusive ranges {min: min-value, max: + * max-value}. For example, [{min: 123, max: 123}, {min: 64512, max: 65534}] + * allows the peer ASN to be 123 or anything in the range 64512-65534. + * This field is only advisory. Although the API accepts other ranges, these + * are the ranges that we recommend. * * Generated from protobuf field repeated .google.cloud.compute.v1.InterconnectAttachmentConfigurationConstraintsBgpPeerASNRange bgp_peer_asn_ranges = 475946370; * @param array<\Google\Cloud\Compute\V1\InterconnectAttachmentConfigurationConstraintsBgpPeerASNRange>|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/InterconnectAttachmentConfigurationConstraints/BgpMd5.php b/Compute/src/V1/InterconnectAttachmentConfigurationConstraints/BgpMd5.php index f4d9e6fcc755..1b5bae557a3f 100644 --- a/Compute/src/V1/InterconnectAttachmentConfigurationConstraints/BgpMd5.php +++ b/Compute/src/V1/InterconnectAttachmentConfigurationConstraints/BgpMd5.php @@ -7,7 +7,15 @@ use UnexpectedValueException; /** - * [Output Only] Whether the attachment's BGP session requires/allows/disallows BGP MD5 authentication. This can take one of the following values: MD5_OPTIONAL, MD5_REQUIRED, MD5_UNSUPPORTED. For example, a Cross-Cloud Interconnect connection to a remote cloud provider that requires BGP MD5 authentication has the interconnectRemoteLocation attachment_configuration_constraints.bgp_md5 field set to MD5_REQUIRED, and that property is propagated to the attachment. Similarly, if BGP MD5 is MD5_UNSUPPORTED, an error is returned if MD5 is requested. + * [Output Only] Whether the attachment's BGP session + * requires/allows/disallows BGP MD5 authentication. This can take one of + * the following values: MD5_OPTIONAL, MD5_REQUIRED, MD5_UNSUPPORTED. + * For example, a Cross-Cloud Interconnect connection to a remote cloud + * provider that requires BGP MD5 authentication has the + * interconnectRemoteLocation attachment_configuration_constraints.bgp_md5 + * field set to MD5_REQUIRED, and that property is propagated to the + * attachment. Similarly, if BGP MD5 is MD5_UNSUPPORTED, an error is + * returned if MD5 is requested. * * Protobuf type google.cloud.compute.v1.InterconnectAttachmentConfigurationConstraints.BgpMd5 */ @@ -20,7 +28,8 @@ class BgpMd5 */ const UNDEFINED_BGP_MD5 = 0; /** - * MD5_OPTIONAL: BGP MD5 authentication is supported and can optionally be configured. + * MD5_OPTIONAL: BGP MD5 authentication is supported and can optionally be + * configured. * * Generated from protobuf enum MD5_OPTIONAL = 532156673; */ diff --git a/Compute/src/V1/InterconnectAttachmentGroup.php b/Compute/src/V1/InterconnectAttachmentGroup.php index 644ae735ffaf..4895c79e656b 100644 --- a/Compute/src/V1/InterconnectAttachmentGroup.php +++ b/Compute/src/V1/InterconnectAttachmentGroup.php @@ -9,14 +9,19 @@ use Google\Protobuf\Internal\GPBUtil; /** - * An interconnect attachment group resource allows customers to create, analyze, and expand highly available deployments. + * An interconnect attachment group resource allows customers to create, + * analyze, and expand highly available deployments. * * Generated from protobuf message google.cloud.compute.v1.InterconnectAttachmentGroup */ class InterconnectAttachmentGroup extends \Google\Protobuf\Internal\Message { /** - * Attachments in the AttachmentGroup. Keys are arbitrary user-specified strings. Users are encouraged, but not required, to use their preferred format for resource links as keys. Note that there are add-members and remove-members methods in gcloud. The size of this map is limited by an "Attachments per group" quota. + * Attachments in the AttachmentGroup. Keys are arbitrary user-specified + * strings. Users are encouraged, but not required, to use their preferred + * format for resource links as keys. + * Note that there are add-members and remove-members methods in gcloud. + * The size of this map is limited by an "Attachments per group" quota. * * Generated from protobuf field map attachments = 334744496; */ @@ -26,25 +31,32 @@ class InterconnectAttachmentGroup extends \Google\Protobuf\Internal\Message */ protected $configured = null; /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; */ protected $creation_timestamp = null; /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; */ protected $description = null; /** - * Opaque system-generated token that uniquely identifies the configuration. If provided when patching a configuration in update mode, the provided token must match the current token or the update is rejected. This provides a reliable means of doing read-modify-write (optimistic locking) as described by AIP 154. + * Opaque system-generated token that uniquely identifies the configuration. + * If provided when patching a configuration in update mode, the provided + * token must match the current token or the update is rejected. This provides + * a reliable means of doing read-modify-write (optimistic locking) as + * described byAIP 154. * * Generated from protobuf field optional string etag = 3123477; */ protected $etag = null; /** - * [Output Only] The unique identifier for the resource type. The server generates this identifier. + * [Output Only] The unique identifier for the resource type. The server + * generates this identifier. * * Generated from protobuf field optional uint64 id = 3355; */ @@ -54,13 +66,16 @@ class InterconnectAttachmentGroup extends \Google\Protobuf\Internal\Message */ protected $intent = null; /** - * The URL of an InterconnectGroup that groups these Attachments' Interconnects. Customers do not need to set this unless directed by Google Support. + * The URL of an InterconnectGroup that groups these Attachments' + * Interconnects. Customers do not need to set this unless directed by + * Google Support. * * Generated from protobuf field optional string interconnect_group = 388651918; */ protected $interconnect_group = null; /** - * [Output Only] Type of the resource. Always compute#interconnectAttachmentGroup. + * [Output Only] Type of the resource. Always + * compute#interconnectAttachmentGroup. * * Generated from protobuf field optional string kind = 3292052; */ @@ -70,7 +85,13 @@ class InterconnectAttachmentGroup extends \Google\Protobuf\Internal\Message */ protected $logical_structure = null; /** - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * * Generated from protobuf field optional string name = 3373707; */ @@ -89,24 +110,44 @@ class InterconnectAttachmentGroup extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type array|\Google\Protobuf\Internal\MapField $attachments - * Attachments in the AttachmentGroup. Keys are arbitrary user-specified strings. Users are encouraged, but not required, to use their preferred format for resource links as keys. Note that there are add-members and remove-members methods in gcloud. The size of this map is limited by an "Attachments per group" quota. + * Attachments in the AttachmentGroup. Keys are arbitrary user-specified + * strings. Users are encouraged, but not required, to use their preferred + * format for resource links as keys. + * Note that there are add-members and remove-members methods in gcloud. + * The size of this map is limited by an "Attachments per group" quota. * @type \Google\Cloud\Compute\V1\InterconnectAttachmentGroupConfigured $configured * @type string $creation_timestamp - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * @type string $description - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * @type string $etag - * Opaque system-generated token that uniquely identifies the configuration. If provided when patching a configuration in update mode, the provided token must match the current token or the update is rejected. This provides a reliable means of doing read-modify-write (optimistic locking) as described by AIP 154. + * Opaque system-generated token that uniquely identifies the configuration. + * If provided when patching a configuration in update mode, the provided + * token must match the current token or the update is rejected. This provides + * a reliable means of doing read-modify-write (optimistic locking) as + * described byAIP 154. * @type int|string $id - * [Output Only] The unique identifier for the resource type. The server generates this identifier. + * [Output Only] The unique identifier for the resource type. The server + * generates this identifier. * @type \Google\Cloud\Compute\V1\InterconnectAttachmentGroupIntent $intent * @type string $interconnect_group - * The URL of an InterconnectGroup that groups these Attachments' Interconnects. Customers do not need to set this unless directed by Google Support. + * The URL of an InterconnectGroup that groups these Attachments' + * Interconnects. Customers do not need to set this unless directed by + * Google Support. * @type string $kind - * [Output Only] Type of the resource. Always compute#interconnectAttachmentGroup. + * [Output Only] Type of the resource. Always + * compute#interconnectAttachmentGroup. * @type \Google\Cloud\Compute\V1\InterconnectAttachmentGroupLogicalStructure $logical_structure * @type string $name - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * @type string $self_link * [Output Only] Server-defined URL for the resource. * } @@ -117,7 +158,11 @@ public function __construct($data = NULL) { } /** - * Attachments in the AttachmentGroup. Keys are arbitrary user-specified strings. Users are encouraged, but not required, to use their preferred format for resource links as keys. Note that there are add-members and remove-members methods in gcloud. The size of this map is limited by an "Attachments per group" quota. + * Attachments in the AttachmentGroup. Keys are arbitrary user-specified + * strings. Users are encouraged, but not required, to use their preferred + * format for resource links as keys. + * Note that there are add-members and remove-members methods in gcloud. + * The size of this map is limited by an "Attachments per group" quota. * * Generated from protobuf field map attachments = 334744496; * @return \Google\Protobuf\Internal\MapField @@ -128,7 +173,11 @@ public function getAttachments() } /** - * Attachments in the AttachmentGroup. Keys are arbitrary user-specified strings. Users are encouraged, but not required, to use their preferred format for resource links as keys. Note that there are add-members and remove-members methods in gcloud. The size of this map is limited by an "Attachments per group" quota. + * Attachments in the AttachmentGroup. Keys are arbitrary user-specified + * strings. Users are encouraged, but not required, to use their preferred + * format for resource links as keys. + * Note that there are add-members and remove-members methods in gcloud. + * The size of this map is limited by an "Attachments per group" quota. * * Generated from protobuf field map attachments = 334744496; * @param array|\Google\Protobuf\Internal\MapField $var @@ -175,7 +224,8 @@ public function setConfigured($var) } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @return string @@ -196,7 +246,8 @@ public function clearCreationTimestamp() } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @param string $var @@ -211,7 +262,8 @@ public function setCreationTimestamp($var) } /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @return string @@ -232,7 +284,8 @@ public function clearDescription() } /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @param string $var @@ -247,7 +300,11 @@ public function setDescription($var) } /** - * Opaque system-generated token that uniquely identifies the configuration. If provided when patching a configuration in update mode, the provided token must match the current token or the update is rejected. This provides a reliable means of doing read-modify-write (optimistic locking) as described by AIP 154. + * Opaque system-generated token that uniquely identifies the configuration. + * If provided when patching a configuration in update mode, the provided + * token must match the current token or the update is rejected. This provides + * a reliable means of doing read-modify-write (optimistic locking) as + * described byAIP 154. * * Generated from protobuf field optional string etag = 3123477; * @return string @@ -268,7 +325,11 @@ public function clearEtag() } /** - * Opaque system-generated token that uniquely identifies the configuration. If provided when patching a configuration in update mode, the provided token must match the current token or the update is rejected. This provides a reliable means of doing read-modify-write (optimistic locking) as described by AIP 154. + * Opaque system-generated token that uniquely identifies the configuration. + * If provided when patching a configuration in update mode, the provided + * token must match the current token or the update is rejected. This provides + * a reliable means of doing read-modify-write (optimistic locking) as + * described byAIP 154. * * Generated from protobuf field optional string etag = 3123477; * @param string $var @@ -283,7 +344,8 @@ public function setEtag($var) } /** - * [Output Only] The unique identifier for the resource type. The server generates this identifier. + * [Output Only] The unique identifier for the resource type. The server + * generates this identifier. * * Generated from protobuf field optional uint64 id = 3355; * @return int|string @@ -304,7 +366,8 @@ public function clearId() } /** - * [Output Only] The unique identifier for the resource type. The server generates this identifier. + * [Output Only] The unique identifier for the resource type. The server + * generates this identifier. * * Generated from protobuf field optional uint64 id = 3355; * @param int|string $var @@ -351,7 +414,9 @@ public function setIntent($var) } /** - * The URL of an InterconnectGroup that groups these Attachments' Interconnects. Customers do not need to set this unless directed by Google Support. + * The URL of an InterconnectGroup that groups these Attachments' + * Interconnects. Customers do not need to set this unless directed by + * Google Support. * * Generated from protobuf field optional string interconnect_group = 388651918; * @return string @@ -372,7 +437,9 @@ public function clearInterconnectGroup() } /** - * The URL of an InterconnectGroup that groups these Attachments' Interconnects. Customers do not need to set this unless directed by Google Support. + * The URL of an InterconnectGroup that groups these Attachments' + * Interconnects. Customers do not need to set this unless directed by + * Google Support. * * Generated from protobuf field optional string interconnect_group = 388651918; * @param string $var @@ -387,7 +454,8 @@ public function setInterconnectGroup($var) } /** - * [Output Only] Type of the resource. Always compute#interconnectAttachmentGroup. + * [Output Only] Type of the resource. Always + * compute#interconnectAttachmentGroup. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -408,7 +476,8 @@ public function clearKind() } /** - * [Output Only] Type of the resource. Always compute#interconnectAttachmentGroup. + * [Output Only] Type of the resource. Always + * compute#interconnectAttachmentGroup. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -455,7 +524,13 @@ public function setLogicalStructure($var) } /** - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * * Generated from protobuf field optional string name = 3373707; * @return string @@ -476,7 +551,13 @@ public function clearName() } /** - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * * Generated from protobuf field optional string name = 3373707; * @param string $var diff --git a/Compute/src/V1/InterconnectAttachmentGroupConfigured.php b/Compute/src/V1/InterconnectAttachmentGroupConfigured.php index bfe4eb1e06f8..f4b98ede01fb 100644 --- a/Compute/src/V1/InterconnectAttachmentGroupConfigured.php +++ b/Compute/src/V1/InterconnectAttachmentGroupConfigured.php @@ -9,7 +9,9 @@ use Google\Protobuf\Internal\GPBUtil; /** - * [Output Only] The redundancy this group is configured to support. The way a user queries what SLA their Attachment gets is by looking at this field of the Attachment's AttachmentGroup. + * [Output Only] The redundancy this group is configured to support. The way a + * user queries what SLA their Attachment gets is by looking at this field of + * the Attachment's AttachmentGroup. * * Generated from protobuf message google.cloud.compute.v1.InterconnectAttachmentGroupConfigured */ diff --git a/Compute/src/V1/InterconnectAttachmentGroupConfiguredAvailabilitySLA.php b/Compute/src/V1/InterconnectAttachmentGroupConfiguredAvailabilitySLA.php index 0762fb8dbac8..895be04e479b 100644 --- a/Compute/src/V1/InterconnectAttachmentGroupConfiguredAvailabilitySLA.php +++ b/Compute/src/V1/InterconnectAttachmentGroupConfiguredAvailabilitySLA.php @@ -9,7 +9,8 @@ use Google\Protobuf\Internal\GPBUtil; /** - * [Output Only] Which SLA this group is configured to support, and why this group does or does not meet that SLA's requirements. + * [Output Only] Which SLA this group is configured to support, and why this + * group does or does not meet that SLA's requirements. * * Generated from protobuf message google.cloud.compute.v1.InterconnectAttachmentGroupConfiguredAvailabilitySLA */ diff --git a/Compute/src/V1/InterconnectAttachmentGroupConfiguredAvailabilitySLAIntendedSlaBlockers.php b/Compute/src/V1/InterconnectAttachmentGroupConfiguredAvailabilitySLAIntendedSlaBlockers.php index f30d06bd2900..5d42f775371f 100644 --- a/Compute/src/V1/InterconnectAttachmentGroupConfiguredAvailabilitySLAIntendedSlaBlockers.php +++ b/Compute/src/V1/InterconnectAttachmentGroupConfiguredAvailabilitySLAIntendedSlaBlockers.php @@ -9,14 +9,17 @@ use Google\Protobuf\Internal\GPBUtil; /** - * [Output Only] Reasons why configuration.availabilitySLA.sla differs from intent.availabilitySLA. This list is empty if and only if those are the same. + * [Output Only] Reasons why configuration.availabilitySLA.sla differs from + * intent.availabilitySLA. This list is empty if and only if those are the + * same. * * Generated from protobuf message google.cloud.compute.v1.InterconnectAttachmentGroupConfiguredAvailabilitySLAIntendedSlaBlockers */ class InterconnectAttachmentGroupConfiguredAvailabilitySLAIntendedSlaBlockers extends \Google\Protobuf\Internal\Message { /** - * [Output Only] URLs of any particular Attachments to explain this blocker in more detail. + * [Output Only] URLs of any particular Attachments to explain this + * blocker in more detail. * * Generated from protobuf field repeated string attachments = 334744496; */ @@ -29,31 +32,41 @@ class InterconnectAttachmentGroupConfiguredAvailabilitySLAIntendedSlaBlockers ex */ protected $blocker_type = null; /** - * [Output Only] The url of Google Cloud public documentation explaining this requirement. This is set for every type of requirement. + * [Output Only] The url of Google Cloud public documentation explaining + * this requirement. This is set for every type of requirement. * * Generated from protobuf field optional string documentation_link = 93465183; */ protected $documentation_link = null; /** - * [Output Only] A human-readable explanation of this requirement and why it's not met. This is set for every type of requirement. + * [Output Only] A human-readable explanation of this requirement and + * why it's not met. This is set for every type of requirement. * * Generated from protobuf field optional string explanation = 504745497; */ protected $explanation = null; /** - * [Output Only] Metros used to explain this blocker in more detail. These are three-letter lowercase strings like "iad". This will be set for some blockers (like NO_ATTACHMENTS_IN_METRO_AND_ZONE) but does not apply to others. + * [Output Only] Metros used to explain this blocker in more detail. + * These are three-letter lowercase strings like "iad". This will be set + * for some blockers (like NO_ATTACHMENTS_IN_METRO_AND_ZONE) but does + * not apply to others. * * Generated from protobuf field repeated string metros = 533067386; */ private $metros; /** - * [Output Only] Regions used to explain this blocker in more detail. These are region names formatted like "us-central1". This will be set for some blockers (like INCOMPATIBLE_REGIONS) but does not apply to others. + * [Output Only] Regions used to explain this blocker in more + * detail. These are region names formatted like "us-central1". This + * will be set for some blockers (like INCOMPATIBLE_REGIONS) but does + * not apply to others. * * Generated from protobuf field repeated string regions = 12367871; */ private $regions; /** - * [Output Only] Zones used to explain this blocker in more detail. Format is "zone1" and/or "zone2". This will be set for some blockers (like MISSING_ZONE) but does not apply to others. + * [Output Only] Zones used to explain this blocker in more detail. + * Format is "zone1" and/or "zone2". This will be set for some blockers + * (like MISSING_ZONE) but does not apply to others. * * Generated from protobuf field repeated string zones = 116085319; */ @@ -66,20 +79,31 @@ class InterconnectAttachmentGroupConfiguredAvailabilitySLAIntendedSlaBlockers ex * Optional. Data for populating the Message object. * * @type array|\Google\Protobuf\Internal\RepeatedField $attachments - * [Output Only] URLs of any particular Attachments to explain this blocker in more detail. + * [Output Only] URLs of any particular Attachments to explain this + * blocker in more detail. * @type string $blocker_type * * Check the BlockerType enum for the list of possible values. * @type string $documentation_link - * [Output Only] The url of Google Cloud public documentation explaining this requirement. This is set for every type of requirement. + * [Output Only] The url of Google Cloud public documentation explaining + * this requirement. This is set for every type of requirement. * @type string $explanation - * [Output Only] A human-readable explanation of this requirement and why it's not met. This is set for every type of requirement. + * [Output Only] A human-readable explanation of this requirement and + * why it's not met. This is set for every type of requirement. * @type array|\Google\Protobuf\Internal\RepeatedField $metros - * [Output Only] Metros used to explain this blocker in more detail. These are three-letter lowercase strings like "iad". This will be set for some blockers (like NO_ATTACHMENTS_IN_METRO_AND_ZONE) but does not apply to others. + * [Output Only] Metros used to explain this blocker in more detail. + * These are three-letter lowercase strings like "iad". This will be set + * for some blockers (like NO_ATTACHMENTS_IN_METRO_AND_ZONE) but does + * not apply to others. * @type array|\Google\Protobuf\Internal\RepeatedField $regions - * [Output Only] Regions used to explain this blocker in more detail. These are region names formatted like "us-central1". This will be set for some blockers (like INCOMPATIBLE_REGIONS) but does not apply to others. + * [Output Only] Regions used to explain this blocker in more + * detail. These are region names formatted like "us-central1". This + * will be set for some blockers (like INCOMPATIBLE_REGIONS) but does + * not apply to others. * @type array|\Google\Protobuf\Internal\RepeatedField $zones - * [Output Only] Zones used to explain this blocker in more detail. Format is "zone1" and/or "zone2". This will be set for some blockers (like MISSING_ZONE) but does not apply to others. + * [Output Only] Zones used to explain this blocker in more detail. + * Format is "zone1" and/or "zone2". This will be set for some blockers + * (like MISSING_ZONE) but does not apply to others. * } */ public function __construct($data = NULL) { @@ -88,7 +112,8 @@ public function __construct($data = NULL) { } /** - * [Output Only] URLs of any particular Attachments to explain this blocker in more detail. + * [Output Only] URLs of any particular Attachments to explain this + * blocker in more detail. * * Generated from protobuf field repeated string attachments = 334744496; * @return \Google\Protobuf\Internal\RepeatedField @@ -99,7 +124,8 @@ public function getAttachments() } /** - * [Output Only] URLs of any particular Attachments to explain this blocker in more detail. + * [Output Only] URLs of any particular Attachments to explain this + * blocker in more detail. * * Generated from protobuf field repeated string attachments = 334744496; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -152,7 +178,8 @@ public function setBlockerType($var) } /** - * [Output Only] The url of Google Cloud public documentation explaining this requirement. This is set for every type of requirement. + * [Output Only] The url of Google Cloud public documentation explaining + * this requirement. This is set for every type of requirement. * * Generated from protobuf field optional string documentation_link = 93465183; * @return string @@ -173,7 +200,8 @@ public function clearDocumentationLink() } /** - * [Output Only] The url of Google Cloud public documentation explaining this requirement. This is set for every type of requirement. + * [Output Only] The url of Google Cloud public documentation explaining + * this requirement. This is set for every type of requirement. * * Generated from protobuf field optional string documentation_link = 93465183; * @param string $var @@ -188,7 +216,8 @@ public function setDocumentationLink($var) } /** - * [Output Only] A human-readable explanation of this requirement and why it's not met. This is set for every type of requirement. + * [Output Only] A human-readable explanation of this requirement and + * why it's not met. This is set for every type of requirement. * * Generated from protobuf field optional string explanation = 504745497; * @return string @@ -209,7 +238,8 @@ public function clearExplanation() } /** - * [Output Only] A human-readable explanation of this requirement and why it's not met. This is set for every type of requirement. + * [Output Only] A human-readable explanation of this requirement and + * why it's not met. This is set for every type of requirement. * * Generated from protobuf field optional string explanation = 504745497; * @param string $var @@ -224,7 +254,10 @@ public function setExplanation($var) } /** - * [Output Only] Metros used to explain this blocker in more detail. These are three-letter lowercase strings like "iad". This will be set for some blockers (like NO_ATTACHMENTS_IN_METRO_AND_ZONE) but does not apply to others. + * [Output Only] Metros used to explain this blocker in more detail. + * These are three-letter lowercase strings like "iad". This will be set + * for some blockers (like NO_ATTACHMENTS_IN_METRO_AND_ZONE) but does + * not apply to others. * * Generated from protobuf field repeated string metros = 533067386; * @return \Google\Protobuf\Internal\RepeatedField @@ -235,7 +268,10 @@ public function getMetros() } /** - * [Output Only] Metros used to explain this blocker in more detail. These are three-letter lowercase strings like "iad". This will be set for some blockers (like NO_ATTACHMENTS_IN_METRO_AND_ZONE) but does not apply to others. + * [Output Only] Metros used to explain this blocker in more detail. + * These are three-letter lowercase strings like "iad". This will be set + * for some blockers (like NO_ATTACHMENTS_IN_METRO_AND_ZONE) but does + * not apply to others. * * Generated from protobuf field repeated string metros = 533067386; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -250,7 +286,10 @@ public function setMetros($var) } /** - * [Output Only] Regions used to explain this blocker in more detail. These are region names formatted like "us-central1". This will be set for some blockers (like INCOMPATIBLE_REGIONS) but does not apply to others. + * [Output Only] Regions used to explain this blocker in more + * detail. These are region names formatted like "us-central1". This + * will be set for some blockers (like INCOMPATIBLE_REGIONS) but does + * not apply to others. * * Generated from protobuf field repeated string regions = 12367871; * @return \Google\Protobuf\Internal\RepeatedField @@ -261,7 +300,10 @@ public function getRegions() } /** - * [Output Only] Regions used to explain this blocker in more detail. These are region names formatted like "us-central1". This will be set for some blockers (like INCOMPATIBLE_REGIONS) but does not apply to others. + * [Output Only] Regions used to explain this blocker in more + * detail. These are region names formatted like "us-central1". This + * will be set for some blockers (like INCOMPATIBLE_REGIONS) but does + * not apply to others. * * Generated from protobuf field repeated string regions = 12367871; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -276,7 +318,9 @@ public function setRegions($var) } /** - * [Output Only] Zones used to explain this blocker in more detail. Format is "zone1" and/or "zone2". This will be set for some blockers (like MISSING_ZONE) but does not apply to others. + * [Output Only] Zones used to explain this blocker in more detail. + * Format is "zone1" and/or "zone2". This will be set for some blockers + * (like MISSING_ZONE) but does not apply to others. * * Generated from protobuf field repeated string zones = 116085319; * @return \Google\Protobuf\Internal\RepeatedField @@ -287,7 +331,9 @@ public function getZones() } /** - * [Output Only] Zones used to explain this blocker in more detail. Format is "zone1" and/or "zone2". This will be set for some blockers (like MISSING_ZONE) but does not apply to others. + * [Output Only] Zones used to explain this blocker in more detail. + * Format is "zone1" and/or "zone2". This will be set for some blockers + * (like MISSING_ZONE) but does not apply to others. * * Generated from protobuf field repeated string zones = 116085319; * @param array|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/InterconnectAttachmentGroupIntent.php b/Compute/src/V1/InterconnectAttachmentGroupIntent.php index 5c1e9a1f9dc1..943d47e93184 100644 --- a/Compute/src/V1/InterconnectAttachmentGroupIntent.php +++ b/Compute/src/V1/InterconnectAttachmentGroupIntent.php @@ -9,7 +9,8 @@ use Google\Protobuf\Internal\GPBUtil; /** - * The user's intent for this AttachmentGroup. This is the only required field besides the name that must be specified on group creation. + * The user's intent for this AttachmentGroup. This is the only required field + * besides the name that must be specified on group creation. * * Generated from protobuf message google.cloud.compute.v1.InterconnectAttachmentGroupIntent */ diff --git a/Compute/src/V1/InterconnectAttachmentGroupLogicalStructure.php b/Compute/src/V1/InterconnectAttachmentGroupLogicalStructure.php index 9a6782668725..518b5b308e52 100644 --- a/Compute/src/V1/InterconnectAttachmentGroupLogicalStructure.php +++ b/Compute/src/V1/InterconnectAttachmentGroupLogicalStructure.php @@ -9,7 +9,8 @@ use Google\Protobuf\Internal\GPBUtil; /** - * [Output Only] An analysis of the logical layout of Attachments in this group. Every Attachment in the group is shown once in this structure. + * [Output Only] An analysis of the logical layout of Attachments in this + * group. Every Attachment in the group is shown once in this structure. * * Generated from protobuf message google.cloud.compute.v1.InterconnectAttachmentGroupLogicalStructure */ diff --git a/Compute/src/V1/InterconnectAttachmentGroupLogicalStructureRegionMetro.php b/Compute/src/V1/InterconnectAttachmentGroupLogicalStructureRegionMetro.php index 4ecf38182f61..307c9cc957c0 100644 --- a/Compute/src/V1/InterconnectAttachmentGroupLogicalStructureRegionMetro.php +++ b/Compute/src/V1/InterconnectAttachmentGroupLogicalStructureRegionMetro.php @@ -20,7 +20,9 @@ class InterconnectAttachmentGroupLogicalStructureRegionMetro extends \Google\Pro */ private $facilities; /** - * [Output Only] The name of the metro, as a three-letter lowercase string like "iad". This is the first component of the location of an Interconnect. + * [Output Only] The name of the metro, as a three-letter lowercase + * string like "iad". This is the first component of the location of an + * Interconnect. * * Generated from protobuf field optional string metro = 103787801; */ @@ -34,7 +36,9 @@ class InterconnectAttachmentGroupLogicalStructureRegionMetro extends \Google\Pro * * @type array<\Google\Cloud\Compute\V1\InterconnectAttachmentGroupLogicalStructureRegionMetroFacility>|\Google\Protobuf\Internal\RepeatedField $facilities * @type string $metro - * [Output Only] The name of the metro, as a three-letter lowercase string like "iad". This is the first component of the location of an Interconnect. + * [Output Only] The name of the metro, as a three-letter lowercase + * string like "iad". This is the first component of the location of an + * Interconnect. * } */ public function __construct($data = NULL) { @@ -65,7 +69,9 @@ public function setFacilities($var) } /** - * [Output Only] The name of the metro, as a three-letter lowercase string like "iad". This is the first component of the location of an Interconnect. + * [Output Only] The name of the metro, as a three-letter lowercase + * string like "iad". This is the first component of the location of an + * Interconnect. * * Generated from protobuf field optional string metro = 103787801; * @return string @@ -86,7 +92,9 @@ public function clearMetro() } /** - * [Output Only] The name of the metro, as a three-letter lowercase string like "iad". This is the first component of the location of an Interconnect. + * [Output Only] The name of the metro, as a three-letter lowercase + * string like "iad". This is the first component of the location of an + * Interconnect. * * Generated from protobuf field optional string metro = 103787801; * @param string $var diff --git a/Compute/src/V1/InterconnectAttachmentGroupLogicalStructureRegionMetroFacility.php b/Compute/src/V1/InterconnectAttachmentGroupLogicalStructureRegionMetroFacility.php index a2669d6507a9..5822a3ec6d9a 100644 --- a/Compute/src/V1/InterconnectAttachmentGroupLogicalStructureRegionMetroFacility.php +++ b/Compute/src/V1/InterconnectAttachmentGroupLogicalStructureRegionMetroFacility.php @@ -9,7 +9,8 @@ use Google\Protobuf\Internal\GPBUtil; /** - * [Output Only] The facilities used for this group's Attachments' Interconnects. + * [Output Only] The facilities used for this group's Attachments' + * Interconnects. * * Generated from protobuf message google.cloud.compute.v1.InterconnectAttachmentGroupLogicalStructureRegionMetroFacility */ diff --git a/Compute/src/V1/InterconnectAttachmentGroupLogicalStructureRegionMetroFacilityZone.php b/Compute/src/V1/InterconnectAttachmentGroupLogicalStructureRegionMetroFacilityZone.php index 8474c5aef37b..2194396689ca 100644 --- a/Compute/src/V1/InterconnectAttachmentGroupLogicalStructureRegionMetroFacilityZone.php +++ b/Compute/src/V1/InterconnectAttachmentGroupLogicalStructureRegionMetroFacilityZone.php @@ -9,14 +9,18 @@ use Google\Protobuf\Internal\GPBUtil; /** - * [Output Only] The zones that Attachments in this group are present in, in the given facilities. This is inherited from their Interconnects. + * [Output Only] The zones that Attachments in this group are present + * in, in the given facilities. This is inherited from their + * Interconnects. * * Generated from protobuf message google.cloud.compute.v1.InterconnectAttachmentGroupLogicalStructureRegionMetroFacilityZone */ class InterconnectAttachmentGroupLogicalStructureRegionMetroFacilityZone extends \Google\Protobuf\Internal\Message { /** - * [Output Only] URLs of Attachments in the given zone, to the given region, on Interconnects in the given facility and metro. Every Attachment in the AG has such an entry. + * [Output Only] URLs of Attachments in the given zone, to the given + * region, on Interconnects in the given facility and metro. Every + * Attachment in the AG has such an entry. * * Generated from protobuf field repeated string attachments = 334744496; */ @@ -35,7 +39,9 @@ class InterconnectAttachmentGroupLogicalStructureRegionMetroFacilityZone extends * Optional. Data for populating the Message object. * * @type array|\Google\Protobuf\Internal\RepeatedField $attachments - * [Output Only] URLs of Attachments in the given zone, to the given region, on Interconnects in the given facility and metro. Every Attachment in the AG has such an entry. + * [Output Only] URLs of Attachments in the given zone, to the given + * region, on Interconnects in the given facility and metro. Every + * Attachment in the AG has such an entry. * @type string $zone * [Output Only] The name of a zone, either "zone1" or "zone2". * } @@ -46,7 +52,9 @@ public function __construct($data = NULL) { } /** - * [Output Only] URLs of Attachments in the given zone, to the given region, on Interconnects in the given facility and metro. Every Attachment in the AG has such an entry. + * [Output Only] URLs of Attachments in the given zone, to the given + * region, on Interconnects in the given facility and metro. Every + * Attachment in the AG has such an entry. * * Generated from protobuf field repeated string attachments = 334744496; * @return \Google\Protobuf\Internal\RepeatedField @@ -57,7 +65,9 @@ public function getAttachments() } /** - * [Output Only] URLs of Attachments in the given zone, to the given region, on Interconnects in the given facility and metro. Every Attachment in the AG has such an entry. + * [Output Only] URLs of Attachments in the given zone, to the given + * region, on Interconnects in the given facility and metro. Every + * Attachment in the AG has such an entry. * * Generated from protobuf field repeated string attachments = 334744496; * @param array|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/InterconnectAttachmentGroupsListResponse.php b/Compute/src/V1/InterconnectAttachmentGroupsListResponse.php index feb7faf9449c..39f3a3335551 100644 --- a/Compute/src/V1/InterconnectAttachmentGroupsListResponse.php +++ b/Compute/src/V1/InterconnectAttachmentGroupsListResponse.php @@ -35,7 +35,11 @@ class InterconnectAttachmentGroupsListResponse extends \Google\Protobuf\Internal */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -47,7 +51,9 @@ class InterconnectAttachmentGroupsListResponse extends \Google\Protobuf\Internal */ protected $self_link = null; /** - * [Output Only] Unreachable resources. end_interface: MixerListResponseWithEtagBuilder + * [Output Only] Unreachable resources. + * end_interface: + * MixerListResponseWithEtagBuilder * * Generated from protobuf field repeated string unreachables = 243372063; */ @@ -72,11 +78,17 @@ class InterconnectAttachmentGroupsListResponse extends \Google\Protobuf\Internal * A list of InterconnectAttachmentGroup resources. * @type string $kind * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type array|\Google\Protobuf\Internal\RepeatedField $unreachables - * [Output Only] Unreachable resources. end_interface: MixerListResponseWithEtagBuilder + * [Output Only] Unreachable resources. + * end_interface: + * MixerListResponseWithEtagBuilder * @type \Google\Cloud\Compute\V1\Warning $warning * [Output Only] Informational warning message. * } @@ -213,7 +225,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -234,7 +250,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var @@ -285,7 +305,9 @@ public function setSelfLink($var) } /** - * [Output Only] Unreachable resources. end_interface: MixerListResponseWithEtagBuilder + * [Output Only] Unreachable resources. + * end_interface: + * MixerListResponseWithEtagBuilder * * Generated from protobuf field repeated string unreachables = 243372063; * @return \Google\Protobuf\Internal\RepeatedField @@ -296,7 +318,9 @@ public function getUnreachables() } /** - * [Output Only] Unreachable resources. end_interface: MixerListResponseWithEtagBuilder + * [Output Only] Unreachable resources. + * end_interface: + * MixerListResponseWithEtagBuilder * * Generated from protobuf field repeated string unreachables = 243372063; * @param array|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/InterconnectAttachmentGroupsOperationalStatusAttachmentStatus.php b/Compute/src/V1/InterconnectAttachmentGroupsOperationalStatusAttachmentStatus.php index 4693b0969c81..da1dcf3f59b8 100644 --- a/Compute/src/V1/InterconnectAttachmentGroupsOperationalStatusAttachmentStatus.php +++ b/Compute/src/V1/InterconnectAttachmentGroupsOperationalStatusAttachmentStatus.php @@ -16,7 +16,8 @@ class InterconnectAttachmentGroupsOperationalStatusAttachmentStatus extends \Google\Protobuf\Internal\Message { /** - * Whether this Attachment is enabled. This becomes false when the customer drains their Attachment. + * Whether this Attachment is enabled. This becomes false when the customer + * drains their Attachment. * * Generated from protobuf field optional bool admin_enabled = 445675089; */ @@ -28,7 +29,10 @@ class InterconnectAttachmentGroupsOperationalStatusAttachmentStatus extends \Goo */ protected $attachment = null; /** - * Whether this Attachment is participating in the redundant configuration. This will be ACTIVE if and only if the status below is CONNECTION_UP. Any INACTIVE Attachments are excluded from the analysis that generates operational.availabilitySLA. + * Whether this Attachment is participating in the redundant configuration. + * This will be ACTIVE if and only if the status below is CONNECTION_UP. + * Any INACTIVE Attachments are excluded from the analysis that generates + * operational.availabilitySLA. * Check the IsActive enum for the list of possible values. * * Generated from protobuf field optional string is_active = 114830267; @@ -49,11 +53,15 @@ class InterconnectAttachmentGroupsOperationalStatusAttachmentStatus extends \Goo * Optional. Data for populating the Message object. * * @type bool $admin_enabled - * Whether this Attachment is enabled. This becomes false when the customer drains their Attachment. + * Whether this Attachment is enabled. This becomes false when the customer + * drains their Attachment. * @type string $attachment * The URL of the Attachment being described. * @type string $is_active - * Whether this Attachment is participating in the redundant configuration. This will be ACTIVE if and only if the status below is CONNECTION_UP. Any INACTIVE Attachments are excluded from the analysis that generates operational.availabilitySLA. + * Whether this Attachment is participating in the redundant configuration. + * This will be ACTIVE if and only if the status below is CONNECTION_UP. + * Any INACTIVE Attachments are excluded from the analysis that generates + * operational.availabilitySLA. * Check the IsActive enum for the list of possible values. * @type string $status * Whether this Attachment is active, and if so, whether BGP is up. @@ -66,7 +74,8 @@ public function __construct($data = NULL) { } /** - * Whether this Attachment is enabled. This becomes false when the customer drains their Attachment. + * Whether this Attachment is enabled. This becomes false when the customer + * drains their Attachment. * * Generated from protobuf field optional bool admin_enabled = 445675089; * @return bool @@ -87,7 +96,8 @@ public function clearAdminEnabled() } /** - * Whether this Attachment is enabled. This becomes false when the customer drains their Attachment. + * Whether this Attachment is enabled. This becomes false when the customer + * drains their Attachment. * * Generated from protobuf field optional bool admin_enabled = 445675089; * @param bool $var @@ -138,7 +148,10 @@ public function setAttachment($var) } /** - * Whether this Attachment is participating in the redundant configuration. This will be ACTIVE if and only if the status below is CONNECTION_UP. Any INACTIVE Attachments are excluded from the analysis that generates operational.availabilitySLA. + * Whether this Attachment is participating in the redundant configuration. + * This will be ACTIVE if and only if the status below is CONNECTION_UP. + * Any INACTIVE Attachments are excluded from the analysis that generates + * operational.availabilitySLA. * Check the IsActive enum for the list of possible values. * * Generated from protobuf field optional string is_active = 114830267; @@ -160,7 +173,10 @@ public function clearIsActive() } /** - * Whether this Attachment is participating in the redundant configuration. This will be ACTIVE if and only if the status below is CONNECTION_UP. Any INACTIVE Attachments are excluded from the analysis that generates operational.availabilitySLA. + * Whether this Attachment is participating in the redundant configuration. + * This will be ACTIVE if and only if the status below is CONNECTION_UP. + * Any INACTIVE Attachments are excluded from the analysis that generates + * operational.availabilitySLA. * Check the IsActive enum for the list of possible values. * * Generated from protobuf field optional string is_active = 114830267; diff --git a/Compute/src/V1/InterconnectAttachmentGroupsOperationalStatusAttachmentStatus/IsActive.php b/Compute/src/V1/InterconnectAttachmentGroupsOperationalStatusAttachmentStatus/IsActive.php index d13cfe050bb2..397ccf16cbac 100644 --- a/Compute/src/V1/InterconnectAttachmentGroupsOperationalStatusAttachmentStatus/IsActive.php +++ b/Compute/src/V1/InterconnectAttachmentGroupsOperationalStatusAttachmentStatus/IsActive.php @@ -7,7 +7,10 @@ use UnexpectedValueException; /** - * Whether this Attachment is participating in the redundant configuration. This will be ACTIVE if and only if the status below is CONNECTION_UP. Any INACTIVE Attachments are excluded from the analysis that generates operational.availabilitySLA. + * Whether this Attachment is participating in the redundant configuration. + * This will be ACTIVE if and only if the status below is CONNECTION_UP. + * Any INACTIVE Attachments are excluded from the analysis that generates + * operational.availabilitySLA. * * Protobuf type google.cloud.compute.v1.InterconnectAttachmentGroupsOperationalStatusAttachmentStatus.IsActive */ diff --git a/Compute/src/V1/InterconnectAttachmentL2Forwarding.php b/Compute/src/V1/InterconnectAttachmentL2Forwarding.php new file mode 100644 index 000000000000..393738ecd408 --- /dev/null +++ b/Compute/src/V1/InterconnectAttachmentL2Forwarding.php @@ -0,0 +1,307 @@ +google.cloud.compute.v1.InterconnectAttachmentL2Forwarding + */ +class InterconnectAttachmentL2Forwarding extends \Google\Protobuf\Internal\Message +{ + /** + * Optional. A map of VLAN tags to appliances and optional inner mapping + * rules. If VLANs are not explicitly mapped to any appliance, the + * defaultApplianceIpAddress is used. + * Each VLAN tag can be a single number or a range of numbers in the range + * of 1 to 4094, e.g., "1" or "4001-4094". Non-empty and non-overlapping + * VLAN tag ranges are enforced, and violating operations will be rejected. + * The VLAN tags in the Ethernet header must use an ethertype value of + * 0x88A8 or 0x8100. + * + * Generated from protobuf field map appliance_mappings = 374529975; + */ + private $appliance_mappings; + /** + * Optional. A single IPv4 or IPv6 address used as the default destination + * IP when there is no VLAN mapping result found. + * Unset field (null-value) indicates the unmatched packet should be + * dropped. + * + * Generated from protobuf field optional string default_appliance_ip_address = 536490476; + */ + protected $default_appliance_ip_address = null; + /** + * Optional. It represents the structure of a Geneve (Generic Network + * Virtualization Encapsulation) header, as defined in RFC8926. It encapsulates packets from various + * protocols (e.g., Ethernet, IPv4, IPv6) for use in network virtualization + * environments. + * + * Generated from protobuf field optional .google.cloud.compute.v1.InterconnectAttachmentL2ForwardingGeneveHeader geneve_header = 118688424; + */ + protected $geneve_header = null; + /** + * Required. Resource URL of the network to which this attachment belongs. + * + * Generated from protobuf field optional string network = 232872494; + */ + protected $network = null; + /** + * Required. A single IPv4 or IPv6 address. This address will be used as the + * source IP address for packets sent to the appliances, and must be used as + * the destination IP address for packets that should be sent out through + * this attachment. + * + * Generated from protobuf field optional string tunnel_endpoint_ip_address = 468740975; + */ + protected $tunnel_endpoint_ip_address = null; + + /** + * Constructor. + * + * @param array $data { + * Optional. Data for populating the Message object. + * + * @type array|\Google\Protobuf\Internal\MapField $appliance_mappings + * Optional. A map of VLAN tags to appliances and optional inner mapping + * rules. If VLANs are not explicitly mapped to any appliance, the + * defaultApplianceIpAddress is used. + * Each VLAN tag can be a single number or a range of numbers in the range + * of 1 to 4094, e.g., "1" or "4001-4094". Non-empty and non-overlapping + * VLAN tag ranges are enforced, and violating operations will be rejected. + * The VLAN tags in the Ethernet header must use an ethertype value of + * 0x88A8 or 0x8100. + * @type string $default_appliance_ip_address + * Optional. A single IPv4 or IPv6 address used as the default destination + * IP when there is no VLAN mapping result found. + * Unset field (null-value) indicates the unmatched packet should be + * dropped. + * @type \Google\Cloud\Compute\V1\InterconnectAttachmentL2ForwardingGeneveHeader $geneve_header + * Optional. It represents the structure of a Geneve (Generic Network + * Virtualization Encapsulation) header, as defined in RFC8926. It encapsulates packets from various + * protocols (e.g., Ethernet, IPv4, IPv6) for use in network virtualization + * environments. + * @type string $network + * Required. Resource URL of the network to which this attachment belongs. + * @type string $tunnel_endpoint_ip_address + * Required. A single IPv4 or IPv6 address. This address will be used as the + * source IP address for packets sent to the appliances, and must be used as + * the destination IP address for packets that should be sent out through + * this attachment. + * } + */ + public function __construct($data = NULL) { + \GPBMetadata\Google\Cloud\Compute\V1\Compute::initOnce(); + parent::__construct($data); + } + + /** + * Optional. A map of VLAN tags to appliances and optional inner mapping + * rules. If VLANs are not explicitly mapped to any appliance, the + * defaultApplianceIpAddress is used. + * Each VLAN tag can be a single number or a range of numbers in the range + * of 1 to 4094, e.g., "1" or "4001-4094". Non-empty and non-overlapping + * VLAN tag ranges are enforced, and violating operations will be rejected. + * The VLAN tags in the Ethernet header must use an ethertype value of + * 0x88A8 or 0x8100. + * + * Generated from protobuf field map appliance_mappings = 374529975; + * @return \Google\Protobuf\Internal\MapField + */ + public function getApplianceMappings() + { + return $this->appliance_mappings; + } + + /** + * Optional. A map of VLAN tags to appliances and optional inner mapping + * rules. If VLANs are not explicitly mapped to any appliance, the + * defaultApplianceIpAddress is used. + * Each VLAN tag can be a single number or a range of numbers in the range + * of 1 to 4094, e.g., "1" or "4001-4094". Non-empty and non-overlapping + * VLAN tag ranges are enforced, and violating operations will be rejected. + * The VLAN tags in the Ethernet header must use an ethertype value of + * 0x88A8 or 0x8100. + * + * Generated from protobuf field map appliance_mappings = 374529975; + * @param array|\Google\Protobuf\Internal\MapField $var + * @return $this + */ + public function setApplianceMappings($var) + { + $arr = GPBUtil::checkMapField($var, \Google\Protobuf\Internal\GPBType::STRING, \Google\Protobuf\Internal\GPBType::MESSAGE, \Google\Cloud\Compute\V1\InterconnectAttachmentL2ForwardingApplianceMapping::class); + $this->appliance_mappings = $arr; + + return $this; + } + + /** + * Optional. A single IPv4 or IPv6 address used as the default destination + * IP when there is no VLAN mapping result found. + * Unset field (null-value) indicates the unmatched packet should be + * dropped. + * + * Generated from protobuf field optional string default_appliance_ip_address = 536490476; + * @return string + */ + public function getDefaultApplianceIpAddress() + { + return isset($this->default_appliance_ip_address) ? $this->default_appliance_ip_address : ''; + } + + public function hasDefaultApplianceIpAddress() + { + return isset($this->default_appliance_ip_address); + } + + public function clearDefaultApplianceIpAddress() + { + unset($this->default_appliance_ip_address); + } + + /** + * Optional. A single IPv4 or IPv6 address used as the default destination + * IP when there is no VLAN mapping result found. + * Unset field (null-value) indicates the unmatched packet should be + * dropped. + * + * Generated from protobuf field optional string default_appliance_ip_address = 536490476; + * @param string $var + * @return $this + */ + public function setDefaultApplianceIpAddress($var) + { + GPBUtil::checkString($var, True); + $this->default_appliance_ip_address = $var; + + return $this; + } + + /** + * Optional. It represents the structure of a Geneve (Generic Network + * Virtualization Encapsulation) header, as defined in RFC8926. It encapsulates packets from various + * protocols (e.g., Ethernet, IPv4, IPv6) for use in network virtualization + * environments. + * + * Generated from protobuf field optional .google.cloud.compute.v1.InterconnectAttachmentL2ForwardingGeneveHeader geneve_header = 118688424; + * @return \Google\Cloud\Compute\V1\InterconnectAttachmentL2ForwardingGeneveHeader|null + */ + public function getGeneveHeader() + { + return $this->geneve_header; + } + + public function hasGeneveHeader() + { + return isset($this->geneve_header); + } + + public function clearGeneveHeader() + { + unset($this->geneve_header); + } + + /** + * Optional. It represents the structure of a Geneve (Generic Network + * Virtualization Encapsulation) header, as defined in RFC8926. It encapsulates packets from various + * protocols (e.g., Ethernet, IPv4, IPv6) for use in network virtualization + * environments. + * + * Generated from protobuf field optional .google.cloud.compute.v1.InterconnectAttachmentL2ForwardingGeneveHeader geneve_header = 118688424; + * @param \Google\Cloud\Compute\V1\InterconnectAttachmentL2ForwardingGeneveHeader $var + * @return $this + */ + public function setGeneveHeader($var) + { + GPBUtil::checkMessage($var, \Google\Cloud\Compute\V1\InterconnectAttachmentL2ForwardingGeneveHeader::class); + $this->geneve_header = $var; + + return $this; + } + + /** + * Required. Resource URL of the network to which this attachment belongs. + * + * Generated from protobuf field optional string network = 232872494; + * @return string + */ + public function getNetwork() + { + return isset($this->network) ? $this->network : ''; + } + + public function hasNetwork() + { + return isset($this->network); + } + + public function clearNetwork() + { + unset($this->network); + } + + /** + * Required. Resource URL of the network to which this attachment belongs. + * + * Generated from protobuf field optional string network = 232872494; + * @param string $var + * @return $this + */ + public function setNetwork($var) + { + GPBUtil::checkString($var, True); + $this->network = $var; + + return $this; + } + + /** + * Required. A single IPv4 or IPv6 address. This address will be used as the + * source IP address for packets sent to the appliances, and must be used as + * the destination IP address for packets that should be sent out through + * this attachment. + * + * Generated from protobuf field optional string tunnel_endpoint_ip_address = 468740975; + * @return string + */ + public function getTunnelEndpointIpAddress() + { + return isset($this->tunnel_endpoint_ip_address) ? $this->tunnel_endpoint_ip_address : ''; + } + + public function hasTunnelEndpointIpAddress() + { + return isset($this->tunnel_endpoint_ip_address); + } + + public function clearTunnelEndpointIpAddress() + { + unset($this->tunnel_endpoint_ip_address); + } + + /** + * Required. A single IPv4 or IPv6 address. This address will be used as the + * source IP address for packets sent to the appliances, and must be used as + * the destination IP address for packets that should be sent out through + * this attachment. + * + * Generated from protobuf field optional string tunnel_endpoint_ip_address = 468740975; + * @param string $var + * @return $this + */ + public function setTunnelEndpointIpAddress($var) + { + GPBUtil::checkString($var, True); + $this->tunnel_endpoint_ip_address = $var; + + return $this; + } + +} + diff --git a/Compute/src/V1/InterconnectAttachmentL2ForwardingApplianceMapping.php b/Compute/src/V1/InterconnectAttachmentL2ForwardingApplianceMapping.php new file mode 100644 index 000000000000..61693a92ad7c --- /dev/null +++ b/Compute/src/V1/InterconnectAttachmentL2ForwardingApplianceMapping.php @@ -0,0 +1,187 @@ +google.cloud.compute.v1.InterconnectAttachmentL2ForwardingApplianceMapping + */ +class InterconnectAttachmentL2ForwardingApplianceMapping extends \Google\Protobuf\Internal\Message +{ + /** + * Optional. A single IPv4 or IPv6 address used as the destination IP + * address for ingress packets that match on a VLAN tag, but do not match + * a more specific inner VLAN tag. + * Unset field (null-value) indicates both VLAN tags are required to be + * mapped. Otherwise, defaultApplianceIpAddress is used. + * + * Generated from protobuf field optional string appliance_ip_address = 57985710; + */ + protected $appliance_ip_address = null; + /** + * Optional. Used to match against the inner VLAN when the packet + * contains two VLAN tags. + * A list of mapping rules from inner VLAN tags to IP addresses. If the + * inner VLAN is not explicitly mapped to an IP address range, the + * applianceIpAddress is used. + * + * Generated from protobuf field repeated .google.cloud.compute.v1.InterconnectAttachmentL2ForwardingApplianceMappingInnerVlanToApplianceMapping inner_vlan_to_appliance_mappings = 97387944; + */ + private $inner_vlan_to_appliance_mappings; + /** + * Optional. The name of this appliance mapping rule. + * + * Generated from protobuf field optional string name = 3373707; + */ + protected $name = null; + + /** + * Constructor. + * + * @param array $data { + * Optional. Data for populating the Message object. + * + * @type string $appliance_ip_address + * Optional. A single IPv4 or IPv6 address used as the destination IP + * address for ingress packets that match on a VLAN tag, but do not match + * a more specific inner VLAN tag. + * Unset field (null-value) indicates both VLAN tags are required to be + * mapped. Otherwise, defaultApplianceIpAddress is used. + * @type array<\Google\Cloud\Compute\V1\InterconnectAttachmentL2ForwardingApplianceMappingInnerVlanToApplianceMapping>|\Google\Protobuf\Internal\RepeatedField $inner_vlan_to_appliance_mappings + * Optional. Used to match against the inner VLAN when the packet + * contains two VLAN tags. + * A list of mapping rules from inner VLAN tags to IP addresses. If the + * inner VLAN is not explicitly mapped to an IP address range, the + * applianceIpAddress is used. + * @type string $name + * Optional. The name of this appliance mapping rule. + * } + */ + public function __construct($data = NULL) { + \GPBMetadata\Google\Cloud\Compute\V1\Compute::initOnce(); + parent::__construct($data); + } + + /** + * Optional. A single IPv4 or IPv6 address used as the destination IP + * address for ingress packets that match on a VLAN tag, but do not match + * a more specific inner VLAN tag. + * Unset field (null-value) indicates both VLAN tags are required to be + * mapped. Otherwise, defaultApplianceIpAddress is used. + * + * Generated from protobuf field optional string appliance_ip_address = 57985710; + * @return string + */ + public function getApplianceIpAddress() + { + return isset($this->appliance_ip_address) ? $this->appliance_ip_address : ''; + } + + public function hasApplianceIpAddress() + { + return isset($this->appliance_ip_address); + } + + public function clearApplianceIpAddress() + { + unset($this->appliance_ip_address); + } + + /** + * Optional. A single IPv4 or IPv6 address used as the destination IP + * address for ingress packets that match on a VLAN tag, but do not match + * a more specific inner VLAN tag. + * Unset field (null-value) indicates both VLAN tags are required to be + * mapped. Otherwise, defaultApplianceIpAddress is used. + * + * Generated from protobuf field optional string appliance_ip_address = 57985710; + * @param string $var + * @return $this + */ + public function setApplianceIpAddress($var) + { + GPBUtil::checkString($var, True); + $this->appliance_ip_address = $var; + + return $this; + } + + /** + * Optional. Used to match against the inner VLAN when the packet + * contains two VLAN tags. + * A list of mapping rules from inner VLAN tags to IP addresses. If the + * inner VLAN is not explicitly mapped to an IP address range, the + * applianceIpAddress is used. + * + * Generated from protobuf field repeated .google.cloud.compute.v1.InterconnectAttachmentL2ForwardingApplianceMappingInnerVlanToApplianceMapping inner_vlan_to_appliance_mappings = 97387944; + * @return \Google\Protobuf\Internal\RepeatedField + */ + public function getInnerVlanToApplianceMappings() + { + return $this->inner_vlan_to_appliance_mappings; + } + + /** + * Optional. Used to match against the inner VLAN when the packet + * contains two VLAN tags. + * A list of mapping rules from inner VLAN tags to IP addresses. If the + * inner VLAN is not explicitly mapped to an IP address range, the + * applianceIpAddress is used. + * + * Generated from protobuf field repeated .google.cloud.compute.v1.InterconnectAttachmentL2ForwardingApplianceMappingInnerVlanToApplianceMapping inner_vlan_to_appliance_mappings = 97387944; + * @param array<\Google\Cloud\Compute\V1\InterconnectAttachmentL2ForwardingApplianceMappingInnerVlanToApplianceMapping>|\Google\Protobuf\Internal\RepeatedField $var + * @return $this + */ + public function setInnerVlanToApplianceMappings($var) + { + $arr = GPBUtil::checkRepeatedField($var, \Google\Protobuf\Internal\GPBType::MESSAGE, \Google\Cloud\Compute\V1\InterconnectAttachmentL2ForwardingApplianceMappingInnerVlanToApplianceMapping::class); + $this->inner_vlan_to_appliance_mappings = $arr; + + return $this; + } + + /** + * Optional. The name of this appliance mapping rule. + * + * Generated from protobuf field optional string name = 3373707; + * @return string + */ + public function getName() + { + return isset($this->name) ? $this->name : ''; + } + + public function hasName() + { + return isset($this->name); + } + + public function clearName() + { + unset($this->name); + } + + /** + * Optional. The name of this appliance mapping rule. + * + * Generated from protobuf field optional string name = 3373707; + * @param string $var + * @return $this + */ + public function setName($var) + { + GPBUtil::checkString($var, True); + $this->name = $var; + + return $this; + } + +} + diff --git a/Compute/src/V1/InterconnectAttachmentL2ForwardingApplianceMappingInnerVlanToApplianceMapping.php b/Compute/src/V1/InterconnectAttachmentL2ForwardingApplianceMappingInnerVlanToApplianceMapping.php new file mode 100644 index 000000000000..bac170790be5 --- /dev/null +++ b/Compute/src/V1/InterconnectAttachmentL2ForwardingApplianceMappingInnerVlanToApplianceMapping.php @@ -0,0 +1,139 @@ +google.cloud.compute.v1.InterconnectAttachmentL2ForwardingApplianceMappingInnerVlanToApplianceMapping + */ +class InterconnectAttachmentL2ForwardingApplianceMappingInnerVlanToApplianceMapping extends \Google\Protobuf\Internal\Message +{ + /** + * Required in this object. A single IPv4 or IPv6 address used as the + * destination IP address for ingress packets that match on both VLAN + * tags. + * + * Generated from protobuf field optional string inner_appliance_ip_address = 350619895; + */ + protected $inner_appliance_ip_address = null; + /** + * Required in this object. Used to match the inner VLAN tag on the + * packet. Each entry can be a single number or a range of numbers in + * the range of 1 to 4094, e.g., ["1", "4001-4094"] is valid. Non-empty + * and Non-overlapping VLAN tag ranges are enforced, and violating + * operations will be rejected. + * The inner VLAN tags must have an ethertype value of 0x8100. + * + * Generated from protobuf field repeated string inner_vlan_tags = 431186636; + */ + private $inner_vlan_tags; + + /** + * Constructor. + * + * @param array $data { + * Optional. Data for populating the Message object. + * + * @type string $inner_appliance_ip_address + * Required in this object. A single IPv4 or IPv6 address used as the + * destination IP address for ingress packets that match on both VLAN + * tags. + * @type array|\Google\Protobuf\Internal\RepeatedField $inner_vlan_tags + * Required in this object. Used to match the inner VLAN tag on the + * packet. Each entry can be a single number or a range of numbers in + * the range of 1 to 4094, e.g., ["1", "4001-4094"] is valid. Non-empty + * and Non-overlapping VLAN tag ranges are enforced, and violating + * operations will be rejected. + * The inner VLAN tags must have an ethertype value of 0x8100. + * } + */ + public function __construct($data = NULL) { + \GPBMetadata\Google\Cloud\Compute\V1\Compute::initOnce(); + parent::__construct($data); + } + + /** + * Required in this object. A single IPv4 or IPv6 address used as the + * destination IP address for ingress packets that match on both VLAN + * tags. + * + * Generated from protobuf field optional string inner_appliance_ip_address = 350619895; + * @return string + */ + public function getInnerApplianceIpAddress() + { + return isset($this->inner_appliance_ip_address) ? $this->inner_appliance_ip_address : ''; + } + + public function hasInnerApplianceIpAddress() + { + return isset($this->inner_appliance_ip_address); + } + + public function clearInnerApplianceIpAddress() + { + unset($this->inner_appliance_ip_address); + } + + /** + * Required in this object. A single IPv4 or IPv6 address used as the + * destination IP address for ingress packets that match on both VLAN + * tags. + * + * Generated from protobuf field optional string inner_appliance_ip_address = 350619895; + * @param string $var + * @return $this + */ + public function setInnerApplianceIpAddress($var) + { + GPBUtil::checkString($var, True); + $this->inner_appliance_ip_address = $var; + + return $this; + } + + /** + * Required in this object. Used to match the inner VLAN tag on the + * packet. Each entry can be a single number or a range of numbers in + * the range of 1 to 4094, e.g., ["1", "4001-4094"] is valid. Non-empty + * and Non-overlapping VLAN tag ranges are enforced, and violating + * operations will be rejected. + * The inner VLAN tags must have an ethertype value of 0x8100. + * + * Generated from protobuf field repeated string inner_vlan_tags = 431186636; + * @return \Google\Protobuf\Internal\RepeatedField + */ + public function getInnerVlanTags() + { + return $this->inner_vlan_tags; + } + + /** + * Required in this object. Used to match the inner VLAN tag on the + * packet. Each entry can be a single number or a range of numbers in + * the range of 1 to 4094, e.g., ["1", "4001-4094"] is valid. Non-empty + * and Non-overlapping VLAN tag ranges are enforced, and violating + * operations will be rejected. + * The inner VLAN tags must have an ethertype value of 0x8100. + * + * Generated from protobuf field repeated string inner_vlan_tags = 431186636; + * @param array|\Google\Protobuf\Internal\RepeatedField $var + * @return $this + */ + public function setInnerVlanTags($var) + { + $arr = GPBUtil::checkRepeatedField($var, \Google\Protobuf\Internal\GPBType::STRING); + $this->inner_vlan_tags = $arr; + + return $this; + } + +} + diff --git a/Compute/src/V1/InterconnectAttachmentL2ForwardingGeneveHeader.php b/Compute/src/V1/InterconnectAttachmentL2ForwardingGeneveHeader.php new file mode 100644 index 000000000000..06cd3b6a6297 --- /dev/null +++ b/Compute/src/V1/InterconnectAttachmentL2ForwardingGeneveHeader.php @@ -0,0 +1,81 @@ +google.cloud.compute.v1.InterconnectAttachmentL2ForwardingGeneveHeader + */ +class InterconnectAttachmentL2ForwardingGeneveHeader extends \Google\Protobuf\Internal\Message +{ + /** + * Optional. VNI is a 24-bit unique virtual network identifier, from 0 to + * 16,777,215. + * + * Generated from protobuf field optional uint32 vni = 116913; + */ + protected $vni = null; + + /** + * Constructor. + * + * @param array $data { + * Optional. Data for populating the Message object. + * + * @type int $vni + * Optional. VNI is a 24-bit unique virtual network identifier, from 0 to + * 16,777,215. + * } + */ + public function __construct($data = NULL) { + \GPBMetadata\Google\Cloud\Compute\V1\Compute::initOnce(); + parent::__construct($data); + } + + /** + * Optional. VNI is a 24-bit unique virtual network identifier, from 0 to + * 16,777,215. + * + * Generated from protobuf field optional uint32 vni = 116913; + * @return int + */ + public function getVni() + { + return isset($this->vni) ? $this->vni : 0; + } + + public function hasVni() + { + return isset($this->vni); + } + + public function clearVni() + { + unset($this->vni); + } + + /** + * Optional. VNI is a 24-bit unique virtual network identifier, from 0 to + * 16,777,215. + * + * Generated from protobuf field optional uint32 vni = 116913; + * @param int $var + * @return $this + */ + public function setVni($var) + { + GPBUtil::checkUint32($var); + $this->vni = $var; + + return $this; + } + +} + diff --git a/Compute/src/V1/InterconnectAttachmentList.php b/Compute/src/V1/InterconnectAttachmentList.php index 103857c637e8..989fd4335342 100644 --- a/Compute/src/V1/InterconnectAttachmentList.php +++ b/Compute/src/V1/InterconnectAttachmentList.php @@ -9,7 +9,8 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Response to the list request, and contains a list of interconnect attachments. + * Response to the list request, and contains a list of interconnect + * attachments. * * Generated from protobuf message google.cloud.compute.v1.InterconnectAttachmentList */ @@ -28,13 +29,18 @@ class InterconnectAttachmentList extends \Google\Protobuf\Internal\Message */ private $items; /** - * [Output Only] Type of resource. Always compute#interconnectAttachmentList for lists of interconnect attachments. + * [Output Only] Type of resource. Alwayscompute#interconnectAttachmentList for lists of interconnect + * attachments. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -63,9 +69,14 @@ class InterconnectAttachmentList extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\InterconnectAttachment>|\Google\Protobuf\Internal\RepeatedField $items * A list of InterconnectAttachment resources. * @type string $kind - * [Output Only] Type of resource. Always compute#interconnectAttachmentList for lists of interconnect attachments. + * [Output Only] Type of resource. Alwayscompute#interconnectAttachmentList for lists of interconnect + * attachments. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type \Google\Cloud\Compute\V1\Warning $warning @@ -140,7 +151,8 @@ public function setItems($var) } /** - * [Output Only] Type of resource. Always compute#interconnectAttachmentList for lists of interconnect attachments. + * [Output Only] Type of resource. Alwayscompute#interconnectAttachmentList for lists of interconnect + * attachments. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -161,7 +173,8 @@ public function clearKind() } /** - * [Output Only] Type of resource. Always compute#interconnectAttachmentList for lists of interconnect attachments. + * [Output Only] Type of resource. Alwayscompute#interconnectAttachmentList for lists of interconnect + * attachments. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -176,7 +189,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -197,7 +214,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/InterconnectAttachmentParams.php b/Compute/src/V1/InterconnectAttachmentParams.php new file mode 100644 index 000000000000..bdc1fc657751 --- /dev/null +++ b/Compute/src/V1/InterconnectAttachmentParams.php @@ -0,0 +1,119 @@ +google.cloud.compute.v1.InterconnectAttachmentParams + */ +class InterconnectAttachmentParams extends \Google\Protobuf\Internal\Message +{ + /** + * Tag keys/values directly bound to this resource. + * Tag keys and values have the same definition as resource + * manager tags. The field is allowed for INSERT + * only. The keys/values to set on the resource should be specified in + * either ID { : } or Namespaced format + * { : }. + * For example the following are valid inputs: + * * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} + * * {"123/environment" : "production", "345/abc" : "xyz"} + * Note: + * * Invalid combinations of ID & namespaced format is not supported. For + * instance: {"123/environment" : "tagValues/444"} is invalid. + * * Inconsistent format is not supported. For instance: + * {"tagKeys/333" : "tagValues/444", "123/env" : "prod"} is invalid. + * + * Generated from protobuf field map resource_manager_tags = 377671164; + */ + private $resource_manager_tags; + + /** + * Constructor. + * + * @param array $data { + * Optional. Data for populating the Message object. + * + * @type array|\Google\Protobuf\Internal\MapField $resource_manager_tags + * Tag keys/values directly bound to this resource. + * Tag keys and values have the same definition as resource + * manager tags. The field is allowed for INSERT + * only. The keys/values to set on the resource should be specified in + * either ID { : } or Namespaced format + * { : }. + * For example the following are valid inputs: + * * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} + * * {"123/environment" : "production", "345/abc" : "xyz"} + * Note: + * * Invalid combinations of ID & namespaced format is not supported. For + * instance: {"123/environment" : "tagValues/444"} is invalid. + * * Inconsistent format is not supported. For instance: + * {"tagKeys/333" : "tagValues/444", "123/env" : "prod"} is invalid. + * } + */ + public function __construct($data = NULL) { + \GPBMetadata\Google\Cloud\Compute\V1\Compute::initOnce(); + parent::__construct($data); + } + + /** + * Tag keys/values directly bound to this resource. + * Tag keys and values have the same definition as resource + * manager tags. The field is allowed for INSERT + * only. The keys/values to set on the resource should be specified in + * either ID { : } or Namespaced format + * { : }. + * For example the following are valid inputs: + * * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} + * * {"123/environment" : "production", "345/abc" : "xyz"} + * Note: + * * Invalid combinations of ID & namespaced format is not supported. For + * instance: {"123/environment" : "tagValues/444"} is invalid. + * * Inconsistent format is not supported. For instance: + * {"tagKeys/333" : "tagValues/444", "123/env" : "prod"} is invalid. + * + * Generated from protobuf field map resource_manager_tags = 377671164; + * @return \Google\Protobuf\Internal\MapField + */ + public function getResourceManagerTags() + { + return $this->resource_manager_tags; + } + + /** + * Tag keys/values directly bound to this resource. + * Tag keys and values have the same definition as resource + * manager tags. The field is allowed for INSERT + * only. The keys/values to set on the resource should be specified in + * either ID { : } or Namespaced format + * { : }. + * For example the following are valid inputs: + * * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} + * * {"123/environment" : "production", "345/abc" : "xyz"} + * Note: + * * Invalid combinations of ID & namespaced format is not supported. For + * instance: {"123/environment" : "tagValues/444"} is invalid. + * * Inconsistent format is not supported. For instance: + * {"tagKeys/333" : "tagValues/444", "123/env" : "prod"} is invalid. + * + * Generated from protobuf field map resource_manager_tags = 377671164; + * @param array|\Google\Protobuf\Internal\MapField $var + * @return $this + */ + public function setResourceManagerTags($var) + { + $arr = GPBUtil::checkMapField($var, \Google\Protobuf\Internal\GPBType::STRING, \Google\Protobuf\Internal\GPBType::STRING); + $this->resource_manager_tags = $arr; + + return $this; + } + +} + diff --git a/Compute/src/V1/InterconnectAttachmentPartnerMetadata.php b/Compute/src/V1/InterconnectAttachmentPartnerMetadata.php index 8c0578b49422..f1780c516500 100644 --- a/Compute/src/V1/InterconnectAttachmentPartnerMetadata.php +++ b/Compute/src/V1/InterconnectAttachmentPartnerMetadata.php @@ -9,26 +9,33 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Informational metadata about Partner attachments from Partners to display to customers. These fields are propagated from PARTNER_PROVIDER attachments to their corresponding PARTNER attachments. + * Informational metadata about Partner attachments from Partners to display + * to customers. These fields are propagated from PARTNER_PROVIDER + * attachments to their corresponding PARTNER attachments. * * Generated from protobuf message google.cloud.compute.v1.InterconnectAttachmentPartnerMetadata */ class InterconnectAttachmentPartnerMetadata extends \Google\Protobuf\Internal\Message { /** - * Plain text name of the Interconnect this attachment is connected to, as displayed in the Partner's portal. For instance "Chicago 1". This value may be validated to match approved Partner values. + * Plain text name of the Interconnect this attachment is connected to, as + * displayed in the Partner's portal. For instance "Chicago 1". + * This value may be validated to match approved Partner values. * * Generated from protobuf field optional string interconnect_name = 514963356; */ protected $interconnect_name = null; /** - * Plain text name of the Partner providing this attachment. This value may be validated to match approved Partner values. + * Plain text name of the Partner providing this attachment. + * This value may be validated to match approved Partner values. * * Generated from protobuf field optional string partner_name = 161747874; */ protected $partner_name = null; /** - * URL of the Partner's portal for this Attachment. Partners may customise this to be a deep link to the specific resource on the Partner portal. This value may be validated to match approved Partner values. + * URL of the Partner's portal for this Attachment. Partners may customise + * this to be a deep link to the specific resource on the Partner portal. + * This value may be validated to match approved Partner values. * * Generated from protobuf field optional string portal_url = 269182748; */ @@ -41,11 +48,16 @@ class InterconnectAttachmentPartnerMetadata extends \Google\Protobuf\Internal\Me * Optional. Data for populating the Message object. * * @type string $interconnect_name - * Plain text name of the Interconnect this attachment is connected to, as displayed in the Partner's portal. For instance "Chicago 1". This value may be validated to match approved Partner values. + * Plain text name of the Interconnect this attachment is connected to, as + * displayed in the Partner's portal. For instance "Chicago 1". + * This value may be validated to match approved Partner values. * @type string $partner_name - * Plain text name of the Partner providing this attachment. This value may be validated to match approved Partner values. + * Plain text name of the Partner providing this attachment. + * This value may be validated to match approved Partner values. * @type string $portal_url - * URL of the Partner's portal for this Attachment. Partners may customise this to be a deep link to the specific resource on the Partner portal. This value may be validated to match approved Partner values. + * URL of the Partner's portal for this Attachment. Partners may customise + * this to be a deep link to the specific resource on the Partner portal. + * This value may be validated to match approved Partner values. * } */ public function __construct($data = NULL) { @@ -54,7 +66,9 @@ public function __construct($data = NULL) { } /** - * Plain text name of the Interconnect this attachment is connected to, as displayed in the Partner's portal. For instance "Chicago 1". This value may be validated to match approved Partner values. + * Plain text name of the Interconnect this attachment is connected to, as + * displayed in the Partner's portal. For instance "Chicago 1". + * This value may be validated to match approved Partner values. * * Generated from protobuf field optional string interconnect_name = 514963356; * @return string @@ -75,7 +89,9 @@ public function clearInterconnectName() } /** - * Plain text name of the Interconnect this attachment is connected to, as displayed in the Partner's portal. For instance "Chicago 1". This value may be validated to match approved Partner values. + * Plain text name of the Interconnect this attachment is connected to, as + * displayed in the Partner's portal. For instance "Chicago 1". + * This value may be validated to match approved Partner values. * * Generated from protobuf field optional string interconnect_name = 514963356; * @param string $var @@ -90,7 +106,8 @@ public function setInterconnectName($var) } /** - * Plain text name of the Partner providing this attachment. This value may be validated to match approved Partner values. + * Plain text name of the Partner providing this attachment. + * This value may be validated to match approved Partner values. * * Generated from protobuf field optional string partner_name = 161747874; * @return string @@ -111,7 +128,8 @@ public function clearPartnerName() } /** - * Plain text name of the Partner providing this attachment. This value may be validated to match approved Partner values. + * Plain text name of the Partner providing this attachment. + * This value may be validated to match approved Partner values. * * Generated from protobuf field optional string partner_name = 161747874; * @param string $var @@ -126,7 +144,9 @@ public function setPartnerName($var) } /** - * URL of the Partner's portal for this Attachment. Partners may customise this to be a deep link to the specific resource on the Partner portal. This value may be validated to match approved Partner values. + * URL of the Partner's portal for this Attachment. Partners may customise + * this to be a deep link to the specific resource on the Partner portal. + * This value may be validated to match approved Partner values. * * Generated from protobuf field optional string portal_url = 269182748; * @return string @@ -147,7 +167,9 @@ public function clearPortalUrl() } /** - * URL of the Partner's portal for this Attachment. Partners may customise this to be a deep link to the specific resource on the Partner portal. This value may be validated to match approved Partner values. + * URL of the Partner's portal for this Attachment. Partners may customise + * this to be a deep link to the specific resource on the Partner portal. + * This value may be validated to match approved Partner values. * * Generated from protobuf field optional string portal_url = 269182748; * @param string $var diff --git a/Compute/src/V1/InterconnectAttachmentPrivateInfo.php b/Compute/src/V1/InterconnectAttachmentPrivateInfo.php index 0751858c9d0b..774208f75e44 100644 --- a/Compute/src/V1/InterconnectAttachmentPrivateInfo.php +++ b/Compute/src/V1/InterconnectAttachmentPrivateInfo.php @@ -9,14 +9,16 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Information for an interconnect attachment when this belongs to an interconnect of type DEDICATED. + * Information for an interconnect attachment when this belongs to an + * interconnect of type DEDICATED. * * Generated from protobuf message google.cloud.compute.v1.InterconnectAttachmentPrivateInfo */ class InterconnectAttachmentPrivateInfo extends \Google\Protobuf\Internal\Message { /** - * [Output Only] 802.1q encapsulation tag to be used for traffic between Google and the customer, going to and from this network and region. + * [Output Only] 802.1q encapsulation tag to be used for traffic between + * Google and the customer, going to and from this network and region. * * Generated from protobuf field optional uint32 tag8021q = 271820992; */ @@ -29,7 +31,8 @@ class InterconnectAttachmentPrivateInfo extends \Google\Protobuf\Internal\Messag * Optional. Data for populating the Message object. * * @type int $tag8021q - * [Output Only] 802.1q encapsulation tag to be used for traffic between Google and the customer, going to and from this network and region. + * [Output Only] 802.1q encapsulation tag to be used for traffic between + * Google and the customer, going to and from this network and region. * } */ public function __construct($data = NULL) { @@ -38,7 +41,8 @@ public function __construct($data = NULL) { } /** - * [Output Only] 802.1q encapsulation tag to be used for traffic between Google and the customer, going to and from this network and region. + * [Output Only] 802.1q encapsulation tag to be used for traffic between + * Google and the customer, going to and from this network and region. * * Generated from protobuf field optional uint32 tag8021q = 271820992; * @return int @@ -59,7 +63,8 @@ public function clearTag8021Q() } /** - * [Output Only] 802.1q encapsulation tag to be used for traffic between Google and the customer, going to and from this network and region. + * [Output Only] 802.1q encapsulation tag to be used for traffic between + * Google and the customer, going to and from this network and region. * * Generated from protobuf field optional uint32 tag8021q = 271820992; * @param int $var diff --git a/Compute/src/V1/InterconnectAttachmentsScopedList.php b/Compute/src/V1/InterconnectAttachmentsScopedList.php index f95d5ea0303a..129a9f545406 100644 --- a/Compute/src/V1/InterconnectAttachmentsScopedList.php +++ b/Compute/src/V1/InterconnectAttachmentsScopedList.php @@ -21,7 +21,8 @@ class InterconnectAttachmentsScopedList extends \Google\Protobuf\Internal\Messag */ private $interconnect_attachments; /** - * Informational warning which replaces the list of addresses when the list is empty. + * Informational warning which replaces the list of addresses when + * the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; */ @@ -36,7 +37,8 @@ class InterconnectAttachmentsScopedList extends \Google\Protobuf\Internal\Messag * @type array<\Google\Cloud\Compute\V1\InterconnectAttachment>|\Google\Protobuf\Internal\RepeatedField $interconnect_attachments * A list of interconnect attachments contained in this scope. * @type \Google\Cloud\Compute\V1\Warning $warning - * Informational warning which replaces the list of addresses when the list is empty. + * Informational warning which replaces the list of addresses when + * the list is empty. * } */ public function __construct($data = NULL) { @@ -71,7 +73,8 @@ public function setInterconnectAttachments($var) } /** - * Informational warning which replaces the list of addresses when the list is empty. + * Informational warning which replaces the list of addresses when + * the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; * @return \Google\Cloud\Compute\V1\Warning|null @@ -92,7 +95,8 @@ public function clearWarning() } /** - * Informational warning which replaces the list of addresses when the list is empty. + * Informational warning which replaces the list of addresses when + * the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; * @param \Google\Cloud\Compute\V1\Warning $var diff --git a/Compute/src/V1/InterconnectCircuitInfo.php b/Compute/src/V1/InterconnectCircuitInfo.php index ca80412d8d92..9b46cefdc3b0 100644 --- a/Compute/src/V1/InterconnectCircuitInfo.php +++ b/Compute/src/V1/InterconnectCircuitInfo.php @@ -9,7 +9,8 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Describes a single physical circuit between the Customer and Google. CircuitInfo objects are created by Google, so all fields are output only. + * Describes a single physical circuit between the Customer and Google. + * CircuitInfo objects are created by Google, so all fields are output only. * * Generated from protobuf message google.cloud.compute.v1.InterconnectCircuitInfo */ @@ -28,7 +29,8 @@ class InterconnectCircuitInfo extends \Google\Protobuf\Internal\Message */ protected $google_circuit_id = null; /** - * Google-side demarc ID for this circuit. Assigned at circuit turn-up and provided by Google to the customer in the LOA. + * Google-side demarc ID for this circuit. Assigned at circuit turn-up and + * provided by Google to the customer in the LOA. * * Generated from protobuf field optional string google_demarc_id = 448196270; */ @@ -45,7 +47,8 @@ class InterconnectCircuitInfo extends \Google\Protobuf\Internal\Message * @type string $google_circuit_id * Google-assigned unique ID for this circuit. Assigned at circuit turn-up. * @type string $google_demarc_id - * Google-side demarc ID for this circuit. Assigned at circuit turn-up and provided by Google to the customer in the LOA. + * Google-side demarc ID for this circuit. Assigned at circuit turn-up and + * provided by Google to the customer in the LOA. * } */ public function __construct($data = NULL) { @@ -126,7 +129,8 @@ public function setGoogleCircuitId($var) } /** - * Google-side demarc ID for this circuit. Assigned at circuit turn-up and provided by Google to the customer in the LOA. + * Google-side demarc ID for this circuit. Assigned at circuit turn-up and + * provided by Google to the customer in the LOA. * * Generated from protobuf field optional string google_demarc_id = 448196270; * @return string @@ -147,7 +151,8 @@ public function clearGoogleDemarcId() } /** - * Google-side demarc ID for this circuit. Assigned at circuit turn-up and provided by Google to the customer in the LOA. + * Google-side demarc ID for this circuit. Assigned at circuit turn-up and + * provided by Google to the customer in the LOA. * * Generated from protobuf field optional string google_demarc_id = 448196270; * @param string $var diff --git a/Compute/src/V1/InterconnectDiagnostics.php b/Compute/src/V1/InterconnectDiagnostics.php index 24a5462ae6d7..6d7aca79542b 100644 --- a/Compute/src/V1/InterconnectDiagnostics.php +++ b/Compute/src/V1/InterconnectDiagnostics.php @@ -9,14 +9,19 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Diagnostics information about the Interconnect connection, which contains detailed and current technical information about Google's side of the connection. + * Diagnostics information about the Interconnect connection, which contains + * detailed and current technical information about Google's side of the + * connection. * * Generated from protobuf message google.cloud.compute.v1.InterconnectDiagnostics */ class InterconnectDiagnostics extends \Google\Protobuf\Internal\Message { /** - * A list of InterconnectDiagnostics.ARPEntry objects, describing individual neighbors currently seen by the Google router in the ARP cache for the Interconnect. This will be empty when the Interconnect is not bundled. + * A list of InterconnectDiagnostics.ARPEntry objects, + * describing individual neighbors currently seen by the Google router in + * the ARP cache for the Interconnect. + * This will be empty when the Interconnect is not bundled. * * Generated from protobuf field repeated .google.cloud.compute.v1.InterconnectDiagnosticsARPEntry arp_caches = 414591761; */ @@ -36,7 +41,8 @@ class InterconnectDiagnostics extends \Google\Protobuf\Internal\Message */ protected $bundle_operational_status = null; /** - * A list of InterconnectDiagnostics.LinkStatus objects, describing the status for each link on the Interconnect. + * A list of InterconnectDiagnostics.LinkStatus objects, + * describing the status for each link on the Interconnect. * * Generated from protobuf field repeated .google.cloud.compute.v1.InterconnectDiagnosticsLinkStatus links = 102977465; */ @@ -55,7 +61,10 @@ class InterconnectDiagnostics extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type array<\Google\Cloud\Compute\V1\InterconnectDiagnosticsARPEntry>|\Google\Protobuf\Internal\RepeatedField $arp_caches - * A list of InterconnectDiagnostics.ARPEntry objects, describing individual neighbors currently seen by the Google router in the ARP cache for the Interconnect. This will be empty when the Interconnect is not bundled. + * A list of InterconnectDiagnostics.ARPEntry objects, + * describing individual neighbors currently seen by the Google router in + * the ARP cache for the Interconnect. + * This will be empty when the Interconnect is not bundled. * @type string $bundle_aggregation_type * The aggregation type of the bundle interface. * Check the BundleAggregationType enum for the list of possible values. @@ -63,7 +72,8 @@ class InterconnectDiagnostics extends \Google\Protobuf\Internal\Message * The operational status of the bundle interface. * Check the BundleOperationalStatus enum for the list of possible values. * @type array<\Google\Cloud\Compute\V1\InterconnectDiagnosticsLinkStatus>|\Google\Protobuf\Internal\RepeatedField $links - * A list of InterconnectDiagnostics.LinkStatus objects, describing the status for each link on the Interconnect. + * A list of InterconnectDiagnostics.LinkStatus objects, + * describing the status for each link on the Interconnect. * @type string $mac_address * The MAC address of the Interconnect's bundle interface. * } @@ -74,7 +84,10 @@ public function __construct($data = NULL) { } /** - * A list of InterconnectDiagnostics.ARPEntry objects, describing individual neighbors currently seen by the Google router in the ARP cache for the Interconnect. This will be empty when the Interconnect is not bundled. + * A list of InterconnectDiagnostics.ARPEntry objects, + * describing individual neighbors currently seen by the Google router in + * the ARP cache for the Interconnect. + * This will be empty when the Interconnect is not bundled. * * Generated from protobuf field repeated .google.cloud.compute.v1.InterconnectDiagnosticsARPEntry arp_caches = 414591761; * @return \Google\Protobuf\Internal\RepeatedField @@ -85,7 +98,10 @@ public function getArpCaches() } /** - * A list of InterconnectDiagnostics.ARPEntry objects, describing individual neighbors currently seen by the Google router in the ARP cache for the Interconnect. This will be empty when the Interconnect is not bundled. + * A list of InterconnectDiagnostics.ARPEntry objects, + * describing individual neighbors currently seen by the Google router in + * the ARP cache for the Interconnect. + * This will be empty when the Interconnect is not bundled. * * Generated from protobuf field repeated .google.cloud.compute.v1.InterconnectDiagnosticsARPEntry arp_caches = 414591761; * @param array<\Google\Cloud\Compute\V1\InterconnectDiagnosticsARPEntry>|\Google\Protobuf\Internal\RepeatedField $var @@ -176,7 +192,8 @@ public function setBundleOperationalStatus($var) } /** - * A list of InterconnectDiagnostics.LinkStatus objects, describing the status for each link on the Interconnect. + * A list of InterconnectDiagnostics.LinkStatus objects, + * describing the status for each link on the Interconnect. * * Generated from protobuf field repeated .google.cloud.compute.v1.InterconnectDiagnosticsLinkStatus links = 102977465; * @return \Google\Protobuf\Internal\RepeatedField @@ -187,7 +204,8 @@ public function getLinks() } /** - * A list of InterconnectDiagnostics.LinkStatus objects, describing the status for each link on the Interconnect. + * A list of InterconnectDiagnostics.LinkStatus objects, + * describing the status for each link on the Interconnect. * * Generated from protobuf field repeated .google.cloud.compute.v1.InterconnectDiagnosticsLinkStatus links = 102977465; * @param array<\Google\Cloud\Compute\V1\InterconnectDiagnosticsLinkStatus>|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/InterconnectDiagnostics/BundleOperationalStatus.php b/Compute/src/V1/InterconnectDiagnostics/BundleOperationalStatus.php index a161c67c7d61..a20dd9ccbd98 100644 --- a/Compute/src/V1/InterconnectDiagnostics/BundleOperationalStatus.php +++ b/Compute/src/V1/InterconnectDiagnostics/BundleOperationalStatus.php @@ -20,13 +20,19 @@ class BundleOperationalStatus */ const UNDEFINED_BUNDLE_OPERATIONAL_STATUS = 0; /** - * If bundleAggregationType is LACP: LACP is not established and/or all links in the bundle have DOWN operational status. If bundleAggregationType is STATIC: one or more links in the bundle has DOWN operational status. + * If bundleAggregationType is LACP: LACP is not established and/or all + * links in the bundle have DOWN operational status. If + * bundleAggregationType is STATIC: one or more links in the bundle has + * DOWN operational status. * * Generated from protobuf enum BUNDLE_OPERATIONAL_STATUS_DOWN = 453842693; */ const BUNDLE_OPERATIONAL_STATUS_DOWN = 453842693; /** - * If bundleAggregationType is LACP: LACP is established and at least one link in the bundle has UP operational status. If bundleAggregationType is STATIC: all links in the bundle (typically just one) have UP operational status. + * If bundleAggregationType is LACP: LACP is established and at least one + * link in the bundle has UP operational status. If bundleAggregationType + * is STATIC: all links in the bundle (typically just one) have UP + * operational status. * * Generated from protobuf enum BUNDLE_OPERATIONAL_STATUS_UP = 161366462; */ diff --git a/Compute/src/V1/InterconnectDiagnosticsLinkLACPStatus.php b/Compute/src/V1/InterconnectDiagnosticsLinkLACPStatus.php index 46ff0e108ffb..20cb5b4229b4 100644 --- a/Compute/src/V1/InterconnectDiagnosticsLinkLACPStatus.php +++ b/Compute/src/V1/InterconnectDiagnosticsLinkLACPStatus.php @@ -27,7 +27,10 @@ class InterconnectDiagnosticsLinkLACPStatus extends \Google\Protobuf\Internal\Me */ protected $neighbor_system_id = null; /** - * The state of a LACP link, which can take one of the following values: - ACTIVE: The link is configured and active within the bundle. - DETACHED: The link is not configured within the bundle. This means that the rest of the object should be empty. + * The state of a LACP link, which can take one of the following values: + * - ACTIVE: The link is configured and active within the bundle. + * - DETACHED: The link is not configured within the bundle. This means + * that the rest of the object should be empty. * Check the State enum for the list of possible values. * * Generated from protobuf field optional string state = 109757585; @@ -45,7 +48,10 @@ class InterconnectDiagnosticsLinkLACPStatus extends \Google\Protobuf\Internal\Me * @type string $neighbor_system_id * System ID of the port on the neighbor's side of the LACP exchange. * @type string $state - * The state of a LACP link, which can take one of the following values: - ACTIVE: The link is configured and active within the bundle. - DETACHED: The link is not configured within the bundle. This means that the rest of the object should be empty. + * The state of a LACP link, which can take one of the following values: + * - ACTIVE: The link is configured and active within the bundle. + * - DETACHED: The link is not configured within the bundle. This means + * that the rest of the object should be empty. * Check the State enum for the list of possible values. * } */ @@ -127,7 +133,10 @@ public function setNeighborSystemId($var) } /** - * The state of a LACP link, which can take one of the following values: - ACTIVE: The link is configured and active within the bundle. - DETACHED: The link is not configured within the bundle. This means that the rest of the object should be empty. + * The state of a LACP link, which can take one of the following values: + * - ACTIVE: The link is configured and active within the bundle. + * - DETACHED: The link is not configured within the bundle. This means + * that the rest of the object should be empty. * Check the State enum for the list of possible values. * * Generated from protobuf field optional string state = 109757585; @@ -149,7 +158,10 @@ public function clearState() } /** - * The state of a LACP link, which can take one of the following values: - ACTIVE: The link is configured and active within the bundle. - DETACHED: The link is not configured within the bundle. This means that the rest of the object should be empty. + * The state of a LACP link, which can take one of the following values: + * - ACTIVE: The link is configured and active within the bundle. + * - DETACHED: The link is not configured within the bundle. This means + * that the rest of the object should be empty. * Check the State enum for the list of possible values. * * Generated from protobuf field optional string state = 109757585; diff --git a/Compute/src/V1/InterconnectDiagnosticsLinkLACPStatus/State.php b/Compute/src/V1/InterconnectDiagnosticsLinkLACPStatus/State.php index 99f9e2b8d16a..277368a873b1 100644 --- a/Compute/src/V1/InterconnectDiagnosticsLinkLACPStatus/State.php +++ b/Compute/src/V1/InterconnectDiagnosticsLinkLACPStatus/State.php @@ -7,7 +7,10 @@ use UnexpectedValueException; /** - * The state of a LACP link, which can take one of the following values: - ACTIVE: The link is configured and active within the bundle. - DETACHED: The link is not configured within the bundle. This means that the rest of the object should be empty. + * The state of a LACP link, which can take one of the following values: + * - ACTIVE: The link is configured and active within the bundle. + * - DETACHED: The link is not configured within the bundle. This means + * that the rest of the object should be empty. * * Protobuf type google.cloud.compute.v1.InterconnectDiagnosticsLinkLACPStatus.State */ @@ -26,7 +29,8 @@ class State */ const ACTIVE = 314733318; /** - * The link is not configured within the bundle, this means the rest of the object should be empty. + * The link is not configured within the bundle, this means the rest of + * the object should be empty. * * Generated from protobuf enum DETACHED = 216562546; */ diff --git a/Compute/src/V1/InterconnectDiagnosticsLinkOpticalPower.php b/Compute/src/V1/InterconnectDiagnosticsLinkOpticalPower.php index 201ad6b86be7..e760901315c1 100644 --- a/Compute/src/V1/InterconnectDiagnosticsLinkOpticalPower.php +++ b/Compute/src/V1/InterconnectDiagnosticsLinkOpticalPower.php @@ -15,14 +15,28 @@ class InterconnectDiagnosticsLinkOpticalPower extends \Google\Protobuf\Internal\Message { /** - * The status of the current value when compared to the warning and alarm levels for the receiving or transmitting transceiver. Possible states include: - OK: The value has not crossed a warning threshold. - LOW_WARNING: The value has crossed below the low warning threshold. - HIGH_WARNING: The value has crossed above the high warning threshold. - LOW_ALARM: The value has crossed below the low alarm threshold. - HIGH_ALARM: The value has crossed above the high alarm threshold. + * The status of the current value when compared to the warning and alarm + * levels for the receiving or transmitting transceiver. Possible states + * include: + * - OK: The value has not crossed a warning threshold. + * - LOW_WARNING: The value has crossed below the low + * warning threshold. + * - HIGH_WARNING: The value has + * crossed above the high warning threshold. + * - LOW_ALARM: The value has crossed below the low alarm + * threshold. + * - HIGH_ALARM: The value has crossed above the high alarm + * threshold. * Check the State enum for the list of possible values. * * Generated from protobuf field optional string state = 109757585; */ protected $state = null; /** - * Value of the current receiving or transmitting optical power, read in dBm. Take a known good optical value, give it a 10% margin and trigger warnings relative to that value. In general, a -7dBm warning and a -11dBm alarm are good optical value estimates for most links. + * Value of the current receiving or transmitting optical power, read in + * dBm. Take a known good optical value, give it a 10% margin and trigger + * warnings relative to that value. In general, a -7dBm warning and a -11dBm + * alarm are good optical value estimates for most links. * * Generated from protobuf field optional float value = 111972721; */ @@ -35,10 +49,24 @@ class InterconnectDiagnosticsLinkOpticalPower extends \Google\Protobuf\Internal\ * Optional. Data for populating the Message object. * * @type string $state - * The status of the current value when compared to the warning and alarm levels for the receiving or transmitting transceiver. Possible states include: - OK: The value has not crossed a warning threshold. - LOW_WARNING: The value has crossed below the low warning threshold. - HIGH_WARNING: The value has crossed above the high warning threshold. - LOW_ALARM: The value has crossed below the low alarm threshold. - HIGH_ALARM: The value has crossed above the high alarm threshold. + * The status of the current value when compared to the warning and alarm + * levels for the receiving or transmitting transceiver. Possible states + * include: + * - OK: The value has not crossed a warning threshold. + * - LOW_WARNING: The value has crossed below the low + * warning threshold. + * - HIGH_WARNING: The value has + * crossed above the high warning threshold. + * - LOW_ALARM: The value has crossed below the low alarm + * threshold. + * - HIGH_ALARM: The value has crossed above the high alarm + * threshold. * Check the State enum for the list of possible values. * @type float $value - * Value of the current receiving or transmitting optical power, read in dBm. Take a known good optical value, give it a 10% margin and trigger warnings relative to that value. In general, a -7dBm warning and a -11dBm alarm are good optical value estimates for most links. + * Value of the current receiving or transmitting optical power, read in + * dBm. Take a known good optical value, give it a 10% margin and trigger + * warnings relative to that value. In general, a -7dBm warning and a -11dBm + * alarm are good optical value estimates for most links. * } */ public function __construct($data = NULL) { @@ -47,7 +75,18 @@ public function __construct($data = NULL) { } /** - * The status of the current value when compared to the warning and alarm levels for the receiving or transmitting transceiver. Possible states include: - OK: The value has not crossed a warning threshold. - LOW_WARNING: The value has crossed below the low warning threshold. - HIGH_WARNING: The value has crossed above the high warning threshold. - LOW_ALARM: The value has crossed below the low alarm threshold. - HIGH_ALARM: The value has crossed above the high alarm threshold. + * The status of the current value when compared to the warning and alarm + * levels for the receiving or transmitting transceiver. Possible states + * include: + * - OK: The value has not crossed a warning threshold. + * - LOW_WARNING: The value has crossed below the low + * warning threshold. + * - HIGH_WARNING: The value has + * crossed above the high warning threshold. + * - LOW_ALARM: The value has crossed below the low alarm + * threshold. + * - HIGH_ALARM: The value has crossed above the high alarm + * threshold. * Check the State enum for the list of possible values. * * Generated from protobuf field optional string state = 109757585; @@ -69,7 +108,18 @@ public function clearState() } /** - * The status of the current value when compared to the warning and alarm levels for the receiving or transmitting transceiver. Possible states include: - OK: The value has not crossed a warning threshold. - LOW_WARNING: The value has crossed below the low warning threshold. - HIGH_WARNING: The value has crossed above the high warning threshold. - LOW_ALARM: The value has crossed below the low alarm threshold. - HIGH_ALARM: The value has crossed above the high alarm threshold. + * The status of the current value when compared to the warning and alarm + * levels for the receiving or transmitting transceiver. Possible states + * include: + * - OK: The value has not crossed a warning threshold. + * - LOW_WARNING: The value has crossed below the low + * warning threshold. + * - HIGH_WARNING: The value has + * crossed above the high warning threshold. + * - LOW_ALARM: The value has crossed below the low alarm + * threshold. + * - HIGH_ALARM: The value has crossed above the high alarm + * threshold. * Check the State enum for the list of possible values. * * Generated from protobuf field optional string state = 109757585; @@ -85,7 +135,10 @@ public function setState($var) } /** - * Value of the current receiving or transmitting optical power, read in dBm. Take a known good optical value, give it a 10% margin and trigger warnings relative to that value. In general, a -7dBm warning and a -11dBm alarm are good optical value estimates for most links. + * Value of the current receiving or transmitting optical power, read in + * dBm. Take a known good optical value, give it a 10% margin and trigger + * warnings relative to that value. In general, a -7dBm warning and a -11dBm + * alarm are good optical value estimates for most links. * * Generated from protobuf field optional float value = 111972721; * @return float @@ -106,7 +159,10 @@ public function clearValue() } /** - * Value of the current receiving or transmitting optical power, read in dBm. Take a known good optical value, give it a 10% margin and trigger warnings relative to that value. In general, a -7dBm warning and a -11dBm alarm are good optical value estimates for most links. + * Value of the current receiving or transmitting optical power, read in + * dBm. Take a known good optical value, give it a 10% margin and trigger + * warnings relative to that value. In general, a -7dBm warning and a -11dBm + * alarm are good optical value estimates for most links. * * Generated from protobuf field optional float value = 111972721; * @param float $var diff --git a/Compute/src/V1/InterconnectDiagnosticsLinkOpticalPower/State.php b/Compute/src/V1/InterconnectDiagnosticsLinkOpticalPower/State.php index 7bc1f29dde93..07db1d2d01b6 100644 --- a/Compute/src/V1/InterconnectDiagnosticsLinkOpticalPower/State.php +++ b/Compute/src/V1/InterconnectDiagnosticsLinkOpticalPower/State.php @@ -7,7 +7,18 @@ use UnexpectedValueException; /** - * The status of the current value when compared to the warning and alarm levels for the receiving or transmitting transceiver. Possible states include: - OK: The value has not crossed a warning threshold. - LOW_WARNING: The value has crossed below the low warning threshold. - HIGH_WARNING: The value has crossed above the high warning threshold. - LOW_ALARM: The value has crossed below the low alarm threshold. - HIGH_ALARM: The value has crossed above the high alarm threshold. + * The status of the current value when compared to the warning and alarm + * levels for the receiving or transmitting transceiver. Possible states + * include: + * - OK: The value has not crossed a warning threshold. + * - LOW_WARNING: The value has crossed below the low + * warning threshold. + * - HIGH_WARNING: The value has + * crossed above the high warning threshold. + * - LOW_ALARM: The value has crossed below the low alarm + * threshold. + * - HIGH_ALARM: The value has crossed above the high alarm + * threshold. * * Protobuf type google.cloud.compute.v1.InterconnectDiagnosticsLinkOpticalPower.State */ @@ -26,25 +37,29 @@ class State */ const HIGH_ALARM = 305363284; /** - * The value of the current optical power has crossed above the high warning threshold. + * The value of the current optical power has crossed above the high + * warning threshold. * * Generated from protobuf enum HIGH_WARNING = 220984799; */ const HIGH_WARNING = 220984799; /** - * The value of the current optical power has crossed below the low alarm threshold. + * The value of the current optical power has crossed below the low alarm + * threshold. * * Generated from protobuf enum LOW_ALARM = 316659046; */ const LOW_ALARM = 316659046; /** - * The value of the current optical power has crossed below the low warning threshold. + * The value of the current optical power has crossed below the low + * warning threshold. * * Generated from protobuf enum LOW_WARNING = 338793841; */ const LOW_WARNING = 338793841; /** - * The value of the current optical power has not crossed a warning threshold. + * The value of the current optical power has not crossed a warning + * threshold. * * Generated from protobuf enum OK = 2524; */ diff --git a/Compute/src/V1/InterconnectDiagnosticsLinkStatus.php b/Compute/src/V1/InterconnectDiagnosticsLinkStatus.php index 7215831c8b02..1cea5305ea87 100644 --- a/Compute/src/V1/InterconnectDiagnosticsLinkStatus.php +++ b/Compute/src/V1/InterconnectDiagnosticsLinkStatus.php @@ -15,7 +15,9 @@ class InterconnectDiagnosticsLinkStatus extends \Google\Protobuf\Internal\Message { /** - * A list of InterconnectDiagnostics.ARPEntry objects, describing the ARP neighbor entries seen on this link. This will be empty if the link is bundled + * A list of InterconnectDiagnostics.ARPEntry objects, + * describing the ARP neighbor entries seen on this link. + * This will be empty if the link is bundled * * Generated from protobuf field repeated .google.cloud.compute.v1.InterconnectDiagnosticsARPEntry arp_caches = 414591761; */ @@ -50,13 +52,15 @@ class InterconnectDiagnosticsLinkStatus extends \Google\Protobuf\Internal\Messag */ protected $operational_status = null; /** - * An InterconnectDiagnostics.LinkOpticalPower object, describing the current value and status of the received light level. + * An InterconnectDiagnostics.LinkOpticalPower object, + * describing the current value and status of the received light level. * * Generated from protobuf field optional .google.cloud.compute.v1.InterconnectDiagnosticsLinkOpticalPower receiving_optical_power = 244717279; */ protected $receiving_optical_power = null; /** - * An InterconnectDiagnostics.LinkOpticalPower object, describing the current value and status of the transmitted light level. + * An InterconnectDiagnostics.LinkOpticalPower object, + * describing the current value and status of the transmitted light level. * * Generated from protobuf field optional .google.cloud.compute.v1.InterconnectDiagnosticsLinkOpticalPower transmitting_optical_power = 459431197; */ @@ -69,7 +73,9 @@ class InterconnectDiagnosticsLinkStatus extends \Google\Protobuf\Internal\Messag * Optional. Data for populating the Message object. * * @type array<\Google\Cloud\Compute\V1\InterconnectDiagnosticsARPEntry>|\Google\Protobuf\Internal\RepeatedField $arp_caches - * A list of InterconnectDiagnostics.ARPEntry objects, describing the ARP neighbor entries seen on this link. This will be empty if the link is bundled + * A list of InterconnectDiagnostics.ARPEntry objects, + * describing the ARP neighbor entries seen on this link. + * This will be empty if the link is bundled * @type string $circuit_id * The unique ID for this link assigned during turn up by Google. * @type string $google_demarc @@ -81,9 +87,11 @@ class InterconnectDiagnosticsLinkStatus extends \Google\Protobuf\Internal\Messag * The operational status of the link. * Check the OperationalStatus enum for the list of possible values. * @type \Google\Cloud\Compute\V1\InterconnectDiagnosticsLinkOpticalPower $receiving_optical_power - * An InterconnectDiagnostics.LinkOpticalPower object, describing the current value and status of the received light level. + * An InterconnectDiagnostics.LinkOpticalPower object, + * describing the current value and status of the received light level. * @type \Google\Cloud\Compute\V1\InterconnectDiagnosticsLinkOpticalPower $transmitting_optical_power - * An InterconnectDiagnostics.LinkOpticalPower object, describing the current value and status of the transmitted light level. + * An InterconnectDiagnostics.LinkOpticalPower object, + * describing the current value and status of the transmitted light level. * } */ public function __construct($data = NULL) { @@ -92,7 +100,9 @@ public function __construct($data = NULL) { } /** - * A list of InterconnectDiagnostics.ARPEntry objects, describing the ARP neighbor entries seen on this link. This will be empty if the link is bundled + * A list of InterconnectDiagnostics.ARPEntry objects, + * describing the ARP neighbor entries seen on this link. + * This will be empty if the link is bundled * * Generated from protobuf field repeated .google.cloud.compute.v1.InterconnectDiagnosticsARPEntry arp_caches = 414591761; * @return \Google\Protobuf\Internal\RepeatedField @@ -103,7 +113,9 @@ public function getArpCaches() } /** - * A list of InterconnectDiagnostics.ARPEntry objects, describing the ARP neighbor entries seen on this link. This will be empty if the link is bundled + * A list of InterconnectDiagnostics.ARPEntry objects, + * describing the ARP neighbor entries seen on this link. + * This will be empty if the link is bundled * * Generated from protobuf field repeated .google.cloud.compute.v1.InterconnectDiagnosticsARPEntry arp_caches = 414591761; * @param array<\Google\Cloud\Compute\V1\InterconnectDiagnosticsARPEntry>|\Google\Protobuf\Internal\RepeatedField $var @@ -296,7 +308,8 @@ public function setOperationalStatus($var) } /** - * An InterconnectDiagnostics.LinkOpticalPower object, describing the current value and status of the received light level. + * An InterconnectDiagnostics.LinkOpticalPower object, + * describing the current value and status of the received light level. * * Generated from protobuf field optional .google.cloud.compute.v1.InterconnectDiagnosticsLinkOpticalPower receiving_optical_power = 244717279; * @return \Google\Cloud\Compute\V1\InterconnectDiagnosticsLinkOpticalPower|null @@ -317,7 +330,8 @@ public function clearReceivingOpticalPower() } /** - * An InterconnectDiagnostics.LinkOpticalPower object, describing the current value and status of the received light level. + * An InterconnectDiagnostics.LinkOpticalPower object, + * describing the current value and status of the received light level. * * Generated from protobuf field optional .google.cloud.compute.v1.InterconnectDiagnosticsLinkOpticalPower receiving_optical_power = 244717279; * @param \Google\Cloud\Compute\V1\InterconnectDiagnosticsLinkOpticalPower $var @@ -332,7 +346,8 @@ public function setReceivingOpticalPower($var) } /** - * An InterconnectDiagnostics.LinkOpticalPower object, describing the current value and status of the transmitted light level. + * An InterconnectDiagnostics.LinkOpticalPower object, + * describing the current value and status of the transmitted light level. * * Generated from protobuf field optional .google.cloud.compute.v1.InterconnectDiagnosticsLinkOpticalPower transmitting_optical_power = 459431197; * @return \Google\Cloud\Compute\V1\InterconnectDiagnosticsLinkOpticalPower|null @@ -353,7 +368,8 @@ public function clearTransmittingOpticalPower() } /** - * An InterconnectDiagnostics.LinkOpticalPower object, describing the current value and status of the transmitted light level. + * An InterconnectDiagnostics.LinkOpticalPower object, + * describing the current value and status of the transmitted light level. * * Generated from protobuf field optional .google.cloud.compute.v1.InterconnectDiagnosticsLinkOpticalPower transmitting_optical_power = 459431197; * @param \Google\Cloud\Compute\V1\InterconnectDiagnosticsLinkOpticalPower $var diff --git a/Compute/src/V1/InterconnectDiagnosticsMacsecStatus.php b/Compute/src/V1/InterconnectDiagnosticsMacsecStatus.php index 54f204a0669f..e29cf487bd5a 100644 --- a/Compute/src/V1/InterconnectDiagnosticsMacsecStatus.php +++ b/Compute/src/V1/InterconnectDiagnosticsMacsecStatus.php @@ -16,7 +16,8 @@ class InterconnectDiagnosticsMacsecStatus extends \Google\Protobuf\Internal\Message { /** - * Indicates the Connectivity Association Key Name (CKN) currently being used if MACsec is operational. + * Indicates the Connectivity Association Key Name (CKN) + * currently being used if MACsec is operational. * * Generated from protobuf field optional string ckn = 98566; */ @@ -35,7 +36,8 @@ class InterconnectDiagnosticsMacsecStatus extends \Google\Protobuf\Internal\Mess * Optional. Data for populating the Message object. * * @type string $ckn - * Indicates the Connectivity Association Key Name (CKN) currently being used if MACsec is operational. + * Indicates the Connectivity Association Key Name (CKN) + * currently being used if MACsec is operational. * @type bool $operational * Indicates whether or not MACsec is operational on this link. * } @@ -46,7 +48,8 @@ public function __construct($data = NULL) { } /** - * Indicates the Connectivity Association Key Name (CKN) currently being used if MACsec is operational. + * Indicates the Connectivity Association Key Name (CKN) + * currently being used if MACsec is operational. * * Generated from protobuf field optional string ckn = 98566; * @return string @@ -67,7 +70,8 @@ public function clearCkn() } /** - * Indicates the Connectivity Association Key Name (CKN) currently being used if MACsec is operational. + * Indicates the Connectivity Association Key Name (CKN) + * currently being used if MACsec is operational. * * Generated from protobuf field optional string ckn = 98566; * @param string $var diff --git a/Compute/src/V1/InterconnectGroup.php b/Compute/src/V1/InterconnectGroup.php index 83592e1b7a33..1e0f2e2cf71a 100644 --- a/Compute/src/V1/InterconnectGroup.php +++ b/Compute/src/V1/InterconnectGroup.php @@ -9,7 +9,8 @@ use Google\Protobuf\Internal\GPBUtil; /** - * An interconnect group resource allows customers to create, analyze, and expand their redundant connections. + * An interconnect group resource allows customers to create, analyze, and + * expand their redundant connections. * * Generated from protobuf message google.cloud.compute.v1.InterconnectGroup */ @@ -20,25 +21,32 @@ class InterconnectGroup extends \Google\Protobuf\Internal\Message */ protected $configured = null; /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; */ protected $creation_timestamp = null; /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; */ protected $description = null; /** - * Opaque system-generated token that uniquely identifies the configuration. If provided when patching a configuration in update mode, the provided token must match the current token or the update is rejected. This provides a reliable means of doing read-modify-write (optimistic locking) as described by API 154. + * Opaque system-generated token that uniquely identifies the configuration. + * If provided when patching a configuration in update mode, the provided + * token must match the current token or the update is rejected. This provides + * a reliable means of doing read-modify-write (optimistic locking) as + * described by AIP 154. * * Generated from protobuf field optional string etag = 3123477; */ protected $etag = null; /** - * [Output Only] The unique identifier for the resource type. The server generates this identifier. + * [Output Only] The unique identifier for the resource type. The server + * generates this identifier. * * Generated from protobuf field optional uint64 id = 3355; */ @@ -48,7 +56,11 @@ class InterconnectGroup extends \Google\Protobuf\Internal\Message */ protected $intent = null; /** - * Interconnects in the InterconnectGroup. Keys are arbitrary user-specified strings. Users are encouraged, but not required, to use their preferred format for resource links as keys. Note that there are add-members and remove-members methods in gcloud. The size of this map is limited by an "Interconnects per group" quota. + * Interconnects in the InterconnectGroup. Keys are arbitrary user-specified + * strings. Users are encouraged, but not required, to use their preferred + * format for resource links as keys. + * Note that there are add-members and remove-members methods in gcloud. + * The size of this map is limited by an "Interconnects per group" quota. * * Generated from protobuf field map interconnects = 520187301; */ @@ -60,7 +72,13 @@ class InterconnectGroup extends \Google\Protobuf\Internal\Message */ protected $kind = null; /** - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * * Generated from protobuf field optional string name = 3373707; */ @@ -84,20 +102,37 @@ class InterconnectGroup extends \Google\Protobuf\Internal\Message * * @type \Google\Cloud\Compute\V1\InterconnectGroupConfigured $configured * @type string $creation_timestamp - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * @type string $description - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * @type string $etag - * Opaque system-generated token that uniquely identifies the configuration. If provided when patching a configuration in update mode, the provided token must match the current token or the update is rejected. This provides a reliable means of doing read-modify-write (optimistic locking) as described by API 154. + * Opaque system-generated token that uniquely identifies the configuration. + * If provided when patching a configuration in update mode, the provided + * token must match the current token or the update is rejected. This provides + * a reliable means of doing read-modify-write (optimistic locking) as + * described by AIP 154. * @type int|string $id - * [Output Only] The unique identifier for the resource type. The server generates this identifier. + * [Output Only] The unique identifier for the resource type. The server + * generates this identifier. * @type \Google\Cloud\Compute\V1\InterconnectGroupIntent $intent * @type array|\Google\Protobuf\Internal\MapField $interconnects - * Interconnects in the InterconnectGroup. Keys are arbitrary user-specified strings. Users are encouraged, but not required, to use their preferred format for resource links as keys. Note that there are add-members and remove-members methods in gcloud. The size of this map is limited by an "Interconnects per group" quota. + * Interconnects in the InterconnectGroup. Keys are arbitrary user-specified + * strings. Users are encouraged, but not required, to use their preferred + * format for resource links as keys. + * Note that there are add-members and remove-members methods in gcloud. + * The size of this map is limited by an "Interconnects per group" quota. * @type string $kind * [Output Only] Type of the resource. Always compute#InterconnectGroup * @type string $name - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * @type \Google\Cloud\Compute\V1\InterconnectGroupPhysicalStructure $physical_structure * @type string $self_link * [Output Only] Server-defined URL for the resource. @@ -141,7 +176,8 @@ public function setConfigured($var) } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @return string @@ -162,7 +198,8 @@ public function clearCreationTimestamp() } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @param string $var @@ -177,7 +214,8 @@ public function setCreationTimestamp($var) } /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @return string @@ -198,7 +236,8 @@ public function clearDescription() } /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @param string $var @@ -213,7 +252,11 @@ public function setDescription($var) } /** - * Opaque system-generated token that uniquely identifies the configuration. If provided when patching a configuration in update mode, the provided token must match the current token or the update is rejected. This provides a reliable means of doing read-modify-write (optimistic locking) as described by API 154. + * Opaque system-generated token that uniquely identifies the configuration. + * If provided when patching a configuration in update mode, the provided + * token must match the current token or the update is rejected. This provides + * a reliable means of doing read-modify-write (optimistic locking) as + * described by AIP 154. * * Generated from protobuf field optional string etag = 3123477; * @return string @@ -234,7 +277,11 @@ public function clearEtag() } /** - * Opaque system-generated token that uniquely identifies the configuration. If provided when patching a configuration in update mode, the provided token must match the current token or the update is rejected. This provides a reliable means of doing read-modify-write (optimistic locking) as described by API 154. + * Opaque system-generated token that uniquely identifies the configuration. + * If provided when patching a configuration in update mode, the provided + * token must match the current token or the update is rejected. This provides + * a reliable means of doing read-modify-write (optimistic locking) as + * described by AIP 154. * * Generated from protobuf field optional string etag = 3123477; * @param string $var @@ -249,7 +296,8 @@ public function setEtag($var) } /** - * [Output Only] The unique identifier for the resource type. The server generates this identifier. + * [Output Only] The unique identifier for the resource type. The server + * generates this identifier. * * Generated from protobuf field optional uint64 id = 3355; * @return int|string @@ -270,7 +318,8 @@ public function clearId() } /** - * [Output Only] The unique identifier for the resource type. The server generates this identifier. + * [Output Only] The unique identifier for the resource type. The server + * generates this identifier. * * Generated from protobuf field optional uint64 id = 3355; * @param int|string $var @@ -317,7 +366,11 @@ public function setIntent($var) } /** - * Interconnects in the InterconnectGroup. Keys are arbitrary user-specified strings. Users are encouraged, but not required, to use their preferred format for resource links as keys. Note that there are add-members and remove-members methods in gcloud. The size of this map is limited by an "Interconnects per group" quota. + * Interconnects in the InterconnectGroup. Keys are arbitrary user-specified + * strings. Users are encouraged, but not required, to use their preferred + * format for resource links as keys. + * Note that there are add-members and remove-members methods in gcloud. + * The size of this map is limited by an "Interconnects per group" quota. * * Generated from protobuf field map interconnects = 520187301; * @return \Google\Protobuf\Internal\MapField @@ -328,7 +381,11 @@ public function getInterconnects() } /** - * Interconnects in the InterconnectGroup. Keys are arbitrary user-specified strings. Users are encouraged, but not required, to use their preferred format for resource links as keys. Note that there are add-members and remove-members methods in gcloud. The size of this map is limited by an "Interconnects per group" quota. + * Interconnects in the InterconnectGroup. Keys are arbitrary user-specified + * strings. Users are encouraged, but not required, to use their preferred + * format for resource links as keys. + * Note that there are add-members and remove-members methods in gcloud. + * The size of this map is limited by an "Interconnects per group" quota. * * Generated from protobuf field map interconnects = 520187301; * @param array|\Google\Protobuf\Internal\MapField $var @@ -379,7 +436,13 @@ public function setKind($var) } /** - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * * Generated from protobuf field optional string name = 3373707; * @return string @@ -400,7 +463,13 @@ public function clearName() } /** - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * * Generated from protobuf field optional string name = 3373707; * @param string $var diff --git a/Compute/src/V1/InterconnectGroupConfigured.php b/Compute/src/V1/InterconnectGroupConfigured.php index 188372dfc13d..b68b7458419c 100644 --- a/Compute/src/V1/InterconnectGroupConfigured.php +++ b/Compute/src/V1/InterconnectGroupConfigured.php @@ -9,7 +9,10 @@ use Google\Protobuf\Internal\GPBUtil; /** - * [Output Only] The status of the group as configured. This has the same structure as the operational field reported by the OperationalStatus method, but does not take into account the operational status of each resource. + * [Output Only] The status of the group as configured. This has the same + * structure as the operational field reported by the OperationalStatus + * method, but does not take into account the operational status of each + * resource. * * Generated from protobuf message google.cloud.compute.v1.InterconnectGroupConfigured */ diff --git a/Compute/src/V1/InterconnectGroupConfiguredTopologyCapability.php b/Compute/src/V1/InterconnectGroupConfiguredTopologyCapability.php index 2f71781b9585..d33850cca145 100644 --- a/Compute/src/V1/InterconnectGroupConfiguredTopologyCapability.php +++ b/Compute/src/V1/InterconnectGroupConfiguredTopologyCapability.php @@ -9,7 +9,9 @@ use Google\Protobuf\Internal\GPBUtil; /** - * [Output Only] How reliable this topology is configured to be, and why this group does or does not meet the requirements for the intended capability. + * [Output Only] How reliable this topology is configured to be, and why + * this group does or does not meet the requirements for the intended + * capability. * * Generated from protobuf message google.cloud.compute.v1.InterconnectGroupConfiguredTopologyCapability */ diff --git a/Compute/src/V1/InterconnectGroupConfiguredTopologyCapabilityIntendedCapabilityBlockers.php b/Compute/src/V1/InterconnectGroupConfiguredTopologyCapabilityIntendedCapabilityBlockers.php index 64c52aa1e5c2..f56ff0bf3fb5 100644 --- a/Compute/src/V1/InterconnectGroupConfiguredTopologyCapabilityIntendedCapabilityBlockers.php +++ b/Compute/src/V1/InterconnectGroupConfiguredTopologyCapabilityIntendedCapabilityBlockers.php @@ -9,7 +9,9 @@ use Google\Protobuf\Internal\GPBUtil; /** - * [Output Only] Reasons why configuration.topologyCapability.sla differs from intent.topologyCapability. This list is empty if and only if those are the same. + * [Output Only] Reasons why configuration.topologyCapability.sla differs + * from intent.topologyCapability. This list is empty if and only if those + * are the same. * * Generated from protobuf message google.cloud.compute.v1.InterconnectGroupConfiguredTopologyCapabilityIntendedCapabilityBlockers */ @@ -23,37 +25,46 @@ class InterconnectGroupConfiguredTopologyCapabilityIntendedCapabilityBlockers ex */ protected $blocker_type = null; /** - * [Output Only] The url of Google Cloud public documentation explaining this requirement. This is set for every type of requirement. + * [Output Only] The url of Google Cloud public documentation explaining + * this requirement. This is set for every type of requirement. * * Generated from protobuf field optional string documentation_link = 93465183; */ protected $documentation_link = null; /** - * [Output Only] A human-readable explanation of this requirement and why it's not met. This is set for every type of requirement. + * [Output Only] A human-readable explanation of this requirement and + * why it's not met. This is set for every type of requirement. * * Generated from protobuf field optional string explanation = 504745497; */ protected $explanation = null; /** - * [Output Only] Facilities used to explain this blocker in more detail. Like physicalStructure.metros.facilities.facility, this is a numeric string like "5467". + * [Output Only] Facilities used to explain this blocker in more detail. + * Like physicalStructure.metros.facilities.facility, this is a numeric + * string like "5467". * * Generated from protobuf field repeated string facilities = 536683137; */ private $facilities; /** - * [Output Only] Interconnects used to explain this blocker in more detail. + * [Output Only] Interconnects used to explain this blocker in more + * detail. * * Generated from protobuf field repeated string interconnects = 520187301; */ private $interconnects; /** - * [Output Only] Metros used to explain this blocker in more detail. These are three-letter lowercase strings like "iad". A blocker like INCOMPATIBLE_METROS will specify the problematic metros in this field. + * [Output Only] Metros used to explain this blocker in more detail. + * These are three-letter lowercase strings like "iad". A blocker like + * INCOMPATIBLE_METROS will specify the problematic metros in this + * field. * * Generated from protobuf field repeated string metros = 533067386; */ private $metros; /** - * [Output Only] Zones used to explain this blocker in more detail. Zone names are "zone1" and/or "zone2". + * [Output Only] Zones used to explain this blocker in more detail. + * Zone names are "zone1" and/or "zone2". * * Generated from protobuf field repeated string zones = 116085319; */ @@ -69,17 +80,26 @@ class InterconnectGroupConfiguredTopologyCapabilityIntendedCapabilityBlockers ex * * Check the BlockerType enum for the list of possible values. * @type string $documentation_link - * [Output Only] The url of Google Cloud public documentation explaining this requirement. This is set for every type of requirement. + * [Output Only] The url of Google Cloud public documentation explaining + * this requirement. This is set for every type of requirement. * @type string $explanation - * [Output Only] A human-readable explanation of this requirement and why it's not met. This is set for every type of requirement. + * [Output Only] A human-readable explanation of this requirement and + * why it's not met. This is set for every type of requirement. * @type array|\Google\Protobuf\Internal\RepeatedField $facilities - * [Output Only] Facilities used to explain this blocker in more detail. Like physicalStructure.metros.facilities.facility, this is a numeric string like "5467". + * [Output Only] Facilities used to explain this blocker in more detail. + * Like physicalStructure.metros.facilities.facility, this is a numeric + * string like "5467". * @type array|\Google\Protobuf\Internal\RepeatedField $interconnects - * [Output Only] Interconnects used to explain this blocker in more detail. + * [Output Only] Interconnects used to explain this blocker in more + * detail. * @type array|\Google\Protobuf\Internal\RepeatedField $metros - * [Output Only] Metros used to explain this blocker in more detail. These are three-letter lowercase strings like "iad". A blocker like INCOMPATIBLE_METROS will specify the problematic metros in this field. + * [Output Only] Metros used to explain this blocker in more detail. + * These are three-letter lowercase strings like "iad". A blocker like + * INCOMPATIBLE_METROS will specify the problematic metros in this + * field. * @type array|\Google\Protobuf\Internal\RepeatedField $zones - * [Output Only] Zones used to explain this blocker in more detail. Zone names are "zone1" and/or "zone2". + * [Output Only] Zones used to explain this blocker in more detail. + * Zone names are "zone1" and/or "zone2". * } */ public function __construct($data = NULL) { @@ -126,7 +146,8 @@ public function setBlockerType($var) } /** - * [Output Only] The url of Google Cloud public documentation explaining this requirement. This is set for every type of requirement. + * [Output Only] The url of Google Cloud public documentation explaining + * this requirement. This is set for every type of requirement. * * Generated from protobuf field optional string documentation_link = 93465183; * @return string @@ -147,7 +168,8 @@ public function clearDocumentationLink() } /** - * [Output Only] The url of Google Cloud public documentation explaining this requirement. This is set for every type of requirement. + * [Output Only] The url of Google Cloud public documentation explaining + * this requirement. This is set for every type of requirement. * * Generated from protobuf field optional string documentation_link = 93465183; * @param string $var @@ -162,7 +184,8 @@ public function setDocumentationLink($var) } /** - * [Output Only] A human-readable explanation of this requirement and why it's not met. This is set for every type of requirement. + * [Output Only] A human-readable explanation of this requirement and + * why it's not met. This is set for every type of requirement. * * Generated from protobuf field optional string explanation = 504745497; * @return string @@ -183,7 +206,8 @@ public function clearExplanation() } /** - * [Output Only] A human-readable explanation of this requirement and why it's not met. This is set for every type of requirement. + * [Output Only] A human-readable explanation of this requirement and + * why it's not met. This is set for every type of requirement. * * Generated from protobuf field optional string explanation = 504745497; * @param string $var @@ -198,7 +222,9 @@ public function setExplanation($var) } /** - * [Output Only] Facilities used to explain this blocker in more detail. Like physicalStructure.metros.facilities.facility, this is a numeric string like "5467". + * [Output Only] Facilities used to explain this blocker in more detail. + * Like physicalStructure.metros.facilities.facility, this is a numeric + * string like "5467". * * Generated from protobuf field repeated string facilities = 536683137; * @return \Google\Protobuf\Internal\RepeatedField @@ -209,7 +235,9 @@ public function getFacilities() } /** - * [Output Only] Facilities used to explain this blocker in more detail. Like physicalStructure.metros.facilities.facility, this is a numeric string like "5467". + * [Output Only] Facilities used to explain this blocker in more detail. + * Like physicalStructure.metros.facilities.facility, this is a numeric + * string like "5467". * * Generated from protobuf field repeated string facilities = 536683137; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -224,7 +252,8 @@ public function setFacilities($var) } /** - * [Output Only] Interconnects used to explain this blocker in more detail. + * [Output Only] Interconnects used to explain this blocker in more + * detail. * * Generated from protobuf field repeated string interconnects = 520187301; * @return \Google\Protobuf\Internal\RepeatedField @@ -235,7 +264,8 @@ public function getInterconnects() } /** - * [Output Only] Interconnects used to explain this blocker in more detail. + * [Output Only] Interconnects used to explain this blocker in more + * detail. * * Generated from protobuf field repeated string interconnects = 520187301; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -250,7 +280,10 @@ public function setInterconnects($var) } /** - * [Output Only] Metros used to explain this blocker in more detail. These are three-letter lowercase strings like "iad". A blocker like INCOMPATIBLE_METROS will specify the problematic metros in this field. + * [Output Only] Metros used to explain this blocker in more detail. + * These are three-letter lowercase strings like "iad". A blocker like + * INCOMPATIBLE_METROS will specify the problematic metros in this + * field. * * Generated from protobuf field repeated string metros = 533067386; * @return \Google\Protobuf\Internal\RepeatedField @@ -261,7 +294,10 @@ public function getMetros() } /** - * [Output Only] Metros used to explain this blocker in more detail. These are three-letter lowercase strings like "iad". A blocker like INCOMPATIBLE_METROS will specify the problematic metros in this field. + * [Output Only] Metros used to explain this blocker in more detail. + * These are three-letter lowercase strings like "iad". A blocker like + * INCOMPATIBLE_METROS will specify the problematic metros in this + * field. * * Generated from protobuf field repeated string metros = 533067386; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -276,7 +312,8 @@ public function setMetros($var) } /** - * [Output Only] Zones used to explain this blocker in more detail. Zone names are "zone1" and/or "zone2". + * [Output Only] Zones used to explain this blocker in more detail. + * Zone names are "zone1" and/or "zone2". * * Generated from protobuf field repeated string zones = 116085319; * @return \Google\Protobuf\Internal\RepeatedField @@ -287,7 +324,8 @@ public function getZones() } /** - * [Output Only] Zones used to explain this blocker in more detail. Zone names are "zone1" and/or "zone2". + * [Output Only] Zones used to explain this blocker in more detail. + * Zone names are "zone1" and/or "zone2". * * Generated from protobuf field repeated string zones = 116085319; * @param array|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/InterconnectGroupIntent.php b/Compute/src/V1/InterconnectGroupIntent.php index 2450b172b837..6aabc5ce0681 100644 --- a/Compute/src/V1/InterconnectGroupIntent.php +++ b/Compute/src/V1/InterconnectGroupIntent.php @@ -9,7 +9,8 @@ use Google\Protobuf\Internal\GPBUtil; /** - * The user's intent for this group. This is the only required field besides the name that must be specified on group creation. + * The user's intent for this group. This is the only required field besides + * the name that must be specified on group creation. * * Generated from protobuf message google.cloud.compute.v1.InterconnectGroupIntent */ diff --git a/Compute/src/V1/InterconnectGroupInterconnect.php b/Compute/src/V1/InterconnectGroupInterconnect.php index 92b9c7659302..34314f452446 100644 --- a/Compute/src/V1/InterconnectGroupInterconnect.php +++ b/Compute/src/V1/InterconnectGroupInterconnect.php @@ -16,7 +16,8 @@ class InterconnectGroupInterconnect extends \Google\Protobuf\Internal\Message { /** - * The URL of an Interconnect in this group. All Interconnects in the group are unique. + * The URL of an Interconnect in this group. All Interconnects in the group + * are unique. * * Generated from protobuf field optional string interconnect = 224601230; */ @@ -29,7 +30,8 @@ class InterconnectGroupInterconnect extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $interconnect - * The URL of an Interconnect in this group. All Interconnects in the group are unique. + * The URL of an Interconnect in this group. All Interconnects in the group + * are unique. * } */ public function __construct($data = NULL) { @@ -38,7 +40,8 @@ public function __construct($data = NULL) { } /** - * The URL of an Interconnect in this group. All Interconnects in the group are unique. + * The URL of an Interconnect in this group. All Interconnects in the group + * are unique. * * Generated from protobuf field optional string interconnect = 224601230; * @return string @@ -59,7 +62,8 @@ public function clearInterconnect() } /** - * The URL of an Interconnect in this group. All Interconnects in the group are unique. + * The URL of an Interconnect in this group. All Interconnects in the group + * are unique. * * Generated from protobuf field optional string interconnect = 224601230; * @param string $var diff --git a/Compute/src/V1/InterconnectGroupPhysicalStructure.php b/Compute/src/V1/InterconnectGroupPhysicalStructure.php index aa11a4f55902..d16ee2ca5002 100644 --- a/Compute/src/V1/InterconnectGroupPhysicalStructure.php +++ b/Compute/src/V1/InterconnectGroupPhysicalStructure.php @@ -9,7 +9,8 @@ use Google\Protobuf\Internal\GPBUtil; /** - * [Output Only] An analysis of the physical layout of Interconnects in this group. Every Interconnect in the group is shown once in this structure. + * [Output Only] An analysis of the physical layout of Interconnects in this + * group. Every Interconnect in the group is shown once in this structure. * * Generated from protobuf message google.cloud.compute.v1.InterconnectGroupPhysicalStructure */ diff --git a/Compute/src/V1/InterconnectGroupPhysicalStructureMetros.php b/Compute/src/V1/InterconnectGroupPhysicalStructureMetros.php index e8a58f39ee24..5710cfd0fdcc 100644 --- a/Compute/src/V1/InterconnectGroupPhysicalStructureMetros.php +++ b/Compute/src/V1/InterconnectGroupPhysicalStructureMetros.php @@ -20,7 +20,9 @@ class InterconnectGroupPhysicalStructureMetros extends \Google\Protobuf\Internal */ private $facilities; /** - * [Output Only] The name of the metro, as a three-letter lowercase string like "iad". This is the first component of the location of Interconnects underneath this. + * [Output Only] The name of the metro, as a three-letter lowercase string + * like "iad". This is the first component of the location of + * Interconnects underneath this. * * Generated from protobuf field optional string metro = 103787801; */ @@ -34,7 +36,9 @@ class InterconnectGroupPhysicalStructureMetros extends \Google\Protobuf\Internal * * @type array<\Google\Cloud\Compute\V1\InterconnectGroupPhysicalStructureMetrosFacilities>|\Google\Protobuf\Internal\RepeatedField $facilities * @type string $metro - * [Output Only] The name of the metro, as a three-letter lowercase string like "iad". This is the first component of the location of Interconnects underneath this. + * [Output Only] The name of the metro, as a three-letter lowercase string + * like "iad". This is the first component of the location of + * Interconnects underneath this. * } */ public function __construct($data = NULL) { @@ -65,7 +69,9 @@ public function setFacilities($var) } /** - * [Output Only] The name of the metro, as a three-letter lowercase string like "iad". This is the first component of the location of Interconnects underneath this. + * [Output Only] The name of the metro, as a three-letter lowercase string + * like "iad". This is the first component of the location of + * Interconnects underneath this. * * Generated from protobuf field optional string metro = 103787801; * @return string @@ -86,7 +92,9 @@ public function clearMetro() } /** - * [Output Only] The name of the metro, as a three-letter lowercase string like "iad". This is the first component of the location of Interconnects underneath this. + * [Output Only] The name of the metro, as a three-letter lowercase string + * like "iad". This is the first component of the location of + * Interconnects underneath this. * * Generated from protobuf field optional string metro = 103787801; * @param string $var diff --git a/Compute/src/V1/InterconnectGroupPhysicalStructureMetrosFacilities.php b/Compute/src/V1/InterconnectGroupPhysicalStructureMetrosFacilities.php index cc63b82b07df..31fd7445164c 100644 --- a/Compute/src/V1/InterconnectGroupPhysicalStructureMetrosFacilities.php +++ b/Compute/src/V1/InterconnectGroupPhysicalStructureMetrosFacilities.php @@ -9,14 +9,17 @@ use Google\Protobuf\Internal\GPBUtil; /** - * [Output Only] The facilities Interconnects in this metro are present in. + * [Output Only] The facilities Interconnects in this metro are present + * in. * * Generated from protobuf message google.cloud.compute.v1.InterconnectGroupPhysicalStructureMetrosFacilities */ class InterconnectGroupPhysicalStructureMetrosFacilities extends \Google\Protobuf\Internal\Message { /** - * [Output Only] The ID of this facility, as a numeric string like "5467". This is the third component of the location of Interconnects in this facility. + * [Output Only] The ID of this facility, as a numeric string like + * "5467". This is the third component of the location of Interconnects + * in this facility. * * Generated from protobuf field optional string facility = 501116579; */ @@ -33,7 +36,9 @@ class InterconnectGroupPhysicalStructureMetrosFacilities extends \Google\Protobu * Optional. Data for populating the Message object. * * @type string $facility - * [Output Only] The ID of this facility, as a numeric string like "5467". This is the third component of the location of Interconnects in this facility. + * [Output Only] The ID of this facility, as a numeric string like + * "5467". This is the third component of the location of Interconnects + * in this facility. * @type array<\Google\Cloud\Compute\V1\InterconnectGroupPhysicalStructureMetrosFacilitiesZones>|\Google\Protobuf\Internal\RepeatedField $zones * } */ @@ -43,7 +48,9 @@ public function __construct($data = NULL) { } /** - * [Output Only] The ID of this facility, as a numeric string like "5467". This is the third component of the location of Interconnects in this facility. + * [Output Only] The ID of this facility, as a numeric string like + * "5467". This is the third component of the location of Interconnects + * in this facility. * * Generated from protobuf field optional string facility = 501116579; * @return string @@ -64,7 +71,9 @@ public function clearFacility() } /** - * [Output Only] The ID of this facility, as a numeric string like "5467". This is the third component of the location of Interconnects in this facility. + * [Output Only] The ID of this facility, as a numeric string like + * "5467". This is the third component of the location of Interconnects + * in this facility. * * Generated from protobuf field optional string facility = 501116579; * @param string $var diff --git a/Compute/src/V1/InterconnectGroupPhysicalStructureMetrosFacilitiesZones.php b/Compute/src/V1/InterconnectGroupPhysicalStructureMetrosFacilitiesZones.php index 95c3f75299b9..9e6c7fabcbe1 100644 --- a/Compute/src/V1/InterconnectGroupPhysicalStructureMetrosFacilitiesZones.php +++ b/Compute/src/V1/InterconnectGroupPhysicalStructureMetrosFacilitiesZones.php @@ -9,20 +9,24 @@ use Google\Protobuf\Internal\GPBUtil; /** - * [Output Only] The zones that Interconnects in this facility are present in. + * [Output Only] The zones that Interconnects in this facility are + * present in. * * Generated from protobuf message google.cloud.compute.v1.InterconnectGroupPhysicalStructureMetrosFacilitiesZones */ class InterconnectGroupPhysicalStructureMetrosFacilitiesZones extends \Google\Protobuf\Internal\Message { /** - * [Output Only] URLs of Interconnects in this redundancy group in the given metro, facility, and zone. + * [Output Only] URLs of Interconnects in this redundancy group in the + * given metro, facility, and zone. * * Generated from protobuf field repeated string interconnects = 520187301; */ private $interconnects; /** - * [Output Only] The name of the zone, either "zone1" or "zone2". This is the second component of the location of Interconnects in this facility. + * [Output Only] The name of the zone, either "zone1" or "zone2". + * This is the second component of the location of Interconnects in + * this facility. * * Generated from protobuf field optional string zone = 3744684; */ @@ -35,9 +39,12 @@ class InterconnectGroupPhysicalStructureMetrosFacilitiesZones extends \Google\Pr * Optional. Data for populating the Message object. * * @type array|\Google\Protobuf\Internal\RepeatedField $interconnects - * [Output Only] URLs of Interconnects in this redundancy group in the given metro, facility, and zone. + * [Output Only] URLs of Interconnects in this redundancy group in the + * given metro, facility, and zone. * @type string $zone - * [Output Only] The name of the zone, either "zone1" or "zone2". This is the second component of the location of Interconnects in this facility. + * [Output Only] The name of the zone, either "zone1" or "zone2". + * This is the second component of the location of Interconnects in + * this facility. * } */ public function __construct($data = NULL) { @@ -46,7 +53,8 @@ public function __construct($data = NULL) { } /** - * [Output Only] URLs of Interconnects in this redundancy group in the given metro, facility, and zone. + * [Output Only] URLs of Interconnects in this redundancy group in the + * given metro, facility, and zone. * * Generated from protobuf field repeated string interconnects = 520187301; * @return \Google\Protobuf\Internal\RepeatedField @@ -57,7 +65,8 @@ public function getInterconnects() } /** - * [Output Only] URLs of Interconnects in this redundancy group in the given metro, facility, and zone. + * [Output Only] URLs of Interconnects in this redundancy group in the + * given metro, facility, and zone. * * Generated from protobuf field repeated string interconnects = 520187301; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -72,7 +81,9 @@ public function setInterconnects($var) } /** - * [Output Only] The name of the zone, either "zone1" or "zone2". This is the second component of the location of Interconnects in this facility. + * [Output Only] The name of the zone, either "zone1" or "zone2". + * This is the second component of the location of Interconnects in + * this facility. * * Generated from protobuf field optional string zone = 3744684; * @return string @@ -93,7 +104,9 @@ public function clearZone() } /** - * [Output Only] The name of the zone, either "zone1" or "zone2". This is the second component of the location of Interconnects in this facility. + * [Output Only] The name of the zone, either "zone1" or "zone2". + * This is the second component of the location of Interconnects in + * this facility. * * Generated from protobuf field optional string zone = 3744684; * @param string $var diff --git a/Compute/src/V1/InterconnectGroupsCreateMembers.php b/Compute/src/V1/InterconnectGroupsCreateMembers.php index 0612ebc6aeef..d31ea1a43828 100644 --- a/Compute/src/V1/InterconnectGroupsCreateMembers.php +++ b/Compute/src/V1/InterconnectGroupsCreateMembers.php @@ -15,7 +15,8 @@ class InterconnectGroupsCreateMembers extends \Google\Protobuf\Internal\Message { /** - * How to behave when configured.topologyCapability.supportedSLA would not equal intent.topologyCapability after this call. + * How to behave when configured.topologyCapability.supportedSLA would not + * equal intent.topologyCapability after this call. * Check the IntentMismatchBehavior enum for the list of possible values. * * Generated from protobuf field optional string intent_mismatch_behavior = 164408000; @@ -39,7 +40,8 @@ class InterconnectGroupsCreateMembers extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $intent_mismatch_behavior - * How to behave when configured.topologyCapability.supportedSLA would not equal intent.topologyCapability after this call. + * How to behave when configured.topologyCapability.supportedSLA would not + * equal intent.topologyCapability after this call. * Check the IntentMismatchBehavior enum for the list of possible values. * @type array<\Google\Cloud\Compute\V1\InterconnectGroupsCreateMembersInterconnectInput>|\Google\Protobuf\Internal\RepeatedField $interconnects * @type \Google\Cloud\Compute\V1\InterconnectGroupsCreateMembersInterconnectInput $template_interconnect @@ -52,7 +54,8 @@ public function __construct($data = NULL) { } /** - * How to behave when configured.topologyCapability.supportedSLA would not equal intent.topologyCapability after this call. + * How to behave when configured.topologyCapability.supportedSLA would not + * equal intent.topologyCapability after this call. * Check the IntentMismatchBehavior enum for the list of possible values. * * Generated from protobuf field optional string intent_mismatch_behavior = 164408000; @@ -74,7 +77,8 @@ public function clearIntentMismatchBehavior() } /** - * How to behave when configured.topologyCapability.supportedSLA would not equal intent.topologyCapability after this call. + * How to behave when configured.topologyCapability.supportedSLA would not + * equal intent.topologyCapability after this call. * Check the IntentMismatchBehavior enum for the list of possible values. * * Generated from protobuf field optional string intent_mismatch_behavior = 164408000; diff --git a/Compute/src/V1/InterconnectGroupsCreateMembers/IntentMismatchBehavior.php b/Compute/src/V1/InterconnectGroupsCreateMembers/IntentMismatchBehavior.php index f71998472983..40e13e71013c 100644 --- a/Compute/src/V1/InterconnectGroupsCreateMembers/IntentMismatchBehavior.php +++ b/Compute/src/V1/InterconnectGroupsCreateMembers/IntentMismatchBehavior.php @@ -7,7 +7,8 @@ use UnexpectedValueException; /** - * How to behave when configured.topologyCapability.supportedSLA would not equal intent.topologyCapability after this call. + * How to behave when configured.topologyCapability.supportedSLA would not + * equal intent.topologyCapability after this call. * * Protobuf type google.cloud.compute.v1.InterconnectGroupsCreateMembers.IntentMismatchBehavior */ diff --git a/Compute/src/V1/InterconnectGroupsCreateMembersInterconnectInput.php b/Compute/src/V1/InterconnectGroupsCreateMembersInterconnectInput.php index de15f77ce4eb..d40ea3283eaf 100644 --- a/Compute/src/V1/InterconnectGroupsCreateMembersInterconnectInput.php +++ b/Compute/src/V1/InterconnectGroupsCreateMembersInterconnectInput.php @@ -16,70 +16,111 @@ class InterconnectGroupsCreateMembersInterconnectInput extends \Google\Protobuf\Internal\Message { /** - * Administrative status of the interconnect. When this is set to true, the Interconnect is functional and can carry traffic. When set to false, no packets can be carried over the interconnect and no BGP routes are exchanged over it. By default, the status is set to true. + * Administrative status of the interconnect. When this is set to true, the + * Interconnect is functional and can carry traffic. + * When set to false, no packets can be carried over the interconnect and + * no BGP routes are exchanged over it. By default, the status is set to + * true. * * Generated from protobuf field optional bool admin_enabled = 445675089; */ protected $admin_enabled = null; /** - * Customer name, to put in the Letter of Authorization as the party authorized to request a crossconnect. + * Customer name, to put in the Letter of Authorization as the party + * authorized to request a crossconnect. * * Generated from protobuf field optional string customer_name = 3665484; */ protected $customer_name = null; /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; */ protected $description = null; /** - * A zone-free location to use for all Interconnects created in this call, like "iad-1234". + * A zone-free location to use for all Interconnects created in this call, + * like "iad-1234". * * Generated from protobuf field optional string facility = 501116579; */ protected $facility = null; /** - * Type of interconnect, which can take one of the following values: - PARTNER: A partner-managed interconnection shared between customers though a partner. - DEDICATED: A dedicated physical interconnection with the customer. Note that a value IT_PRIVATE has been deprecated in favor of DEDICATED. + * Type of interconnect, which can take one of the following values: + * - PARTNER: A partner-managed interconnection shared between + * customers though a partner. + * - DEDICATED: A dedicated physical + * interconnection with the customer. + * Note that a value IT_PRIVATE + * has been deprecated in favor of DEDICATED. * Check the InterconnectType enum for the list of possible values. * * Generated from protobuf field optional string interconnect_type = 515165259; */ protected $interconnect_type = null; /** - * Type of link requested, which can take one of the following values: - LINK_TYPE_ETHERNET_10G_LR: A 10G Ethernet with LR optics - LINK_TYPE_ETHERNET_100G_LR: A 100G Ethernet with LR optics. - LINK_TYPE_ETHERNET_400G_LR4: A 400G Ethernet with LR4 optics. Note that this field indicates the speed of each of the links in the bundle, not the speed of the entire bundle. + * Type of link requested, which can take one of the following values: + * - LINK_TYPE_ETHERNET_10G_LR: A 10G Ethernet with LR optics + * - LINK_TYPE_ETHERNET_100G_LR: A 100G Ethernet with LR optics. + * - LINK_TYPE_ETHERNET_400G_LR4: A 400G Ethernet with LR4 + * optics. + * Note that this field indicates the speed of each of the + * links in the bundle, not the speed of the entire bundle. * Check the LinkType enum for the list of possible values. * * Generated from protobuf field optional string link_type = 523207775; */ protected $link_type = null; /** - * Name of the Interconnects to be created. This must be specified on the template and/or on each individual interconnect. The name, if not empty, must be 1-63 characters long, and comply with RFC1035. Specifically, any nonempty name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the Interconnects to be created. This must be specified on the + * template and/or on each individual interconnect. The name, if not empty, + * must be 1-63 characters long, and comply with RFC1035. + * Specifically, any nonempty name must be 1-63 characters long and match + * the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * * Generated from protobuf field optional string name = 3373707; */ protected $name = null; /** - * Email address to contact the customer NOC for operations and maintenance notifications regarding this Interconnect. If specified, this will be used for notifications in addition to all other forms described, such as Cloud Monitoring logs alerting and Cloud Notifications. This field is required for users who sign up for Cloud Interconnect using workforce identity federation. + * Email address to contact the customer NOC for operations and maintenance + * notifications regarding this Interconnect. If specified, this will be + * used for notifications in addition to all other forms described, such as + * Cloud Monitoring logs alerting and Cloud Notifications. This field is + * required for users who sign up for Cloud Interconnect using + * workforce identity federation. * * Generated from protobuf field optional string noc_contact_email = 14072832; */ protected $noc_contact_email = null; /** - * Indicates that this is a Cross-Cloud Interconnect. This field specifies the location outside of Google's network that the interconnect is connected to. + * Indicates that this is a Cross-Cloud Interconnect. This field specifies + * the location outside of Google's network that the interconnect is + * connected to. * * Generated from protobuf field optional string remote_location = 324388750; */ protected $remote_location = null; /** - * Optional. List of features requested for this Interconnect connection, which can take one of the following values: - IF_MACSEC If specified then the connection is created on MACsec capable hardware ports. If not specified, the default value is false, which allocates non-MACsec capable ports first if available. This parameter can be provided only with Interconnect INSERT. It isn't valid for Interconnect PATCH. + * Optional. List of features requested for this Interconnect connection, + * which can take one of the following values: + * - IF_MACSEC: If specified, then the connection is created on MACsec + * capable hardware ports. If not specified, non-MACsec capable ports will + * also be considered. + * - IF_CROSS_SITE_NETWORK: If specified, then the connection is created + * exclusively for Cross-Site Networking. The connection can not be used for + * Cross-Site Networking unless this feature is specified. * Check the RequestedFeatures enum for the list of possible values. * * Generated from protobuf field repeated string requested_features = 461240814; */ private $requested_features; /** - * Target number of physical links in the link bundle, as requested by the customer. + * Target number of physical links in the link bundle, as requested by the + * customer. * * Generated from protobuf field optional int32 requested_link_count = 45051387; */ @@ -92,30 +133,71 @@ class InterconnectGroupsCreateMembersInterconnectInput extends \Google\Protobuf\ * Optional. Data for populating the Message object. * * @type bool $admin_enabled - * Administrative status of the interconnect. When this is set to true, the Interconnect is functional and can carry traffic. When set to false, no packets can be carried over the interconnect and no BGP routes are exchanged over it. By default, the status is set to true. + * Administrative status of the interconnect. When this is set to true, the + * Interconnect is functional and can carry traffic. + * When set to false, no packets can be carried over the interconnect and + * no BGP routes are exchanged over it. By default, the status is set to + * true. * @type string $customer_name - * Customer name, to put in the Letter of Authorization as the party authorized to request a crossconnect. + * Customer name, to put in the Letter of Authorization as the party + * authorized to request a crossconnect. * @type string $description - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * @type string $facility - * A zone-free location to use for all Interconnects created in this call, like "iad-1234". + * A zone-free location to use for all Interconnects created in this call, + * like "iad-1234". * @type string $interconnect_type - * Type of interconnect, which can take one of the following values: - PARTNER: A partner-managed interconnection shared between customers though a partner. - DEDICATED: A dedicated physical interconnection with the customer. Note that a value IT_PRIVATE has been deprecated in favor of DEDICATED. + * Type of interconnect, which can take one of the following values: + * - PARTNER: A partner-managed interconnection shared between + * customers though a partner. + * - DEDICATED: A dedicated physical + * interconnection with the customer. + * Note that a value IT_PRIVATE + * has been deprecated in favor of DEDICATED. * Check the InterconnectType enum for the list of possible values. * @type string $link_type - * Type of link requested, which can take one of the following values: - LINK_TYPE_ETHERNET_10G_LR: A 10G Ethernet with LR optics - LINK_TYPE_ETHERNET_100G_LR: A 100G Ethernet with LR optics. - LINK_TYPE_ETHERNET_400G_LR4: A 400G Ethernet with LR4 optics. Note that this field indicates the speed of each of the links in the bundle, not the speed of the entire bundle. + * Type of link requested, which can take one of the following values: + * - LINK_TYPE_ETHERNET_10G_LR: A 10G Ethernet with LR optics + * - LINK_TYPE_ETHERNET_100G_LR: A 100G Ethernet with LR optics. + * - LINK_TYPE_ETHERNET_400G_LR4: A 400G Ethernet with LR4 + * optics. + * Note that this field indicates the speed of each of the + * links in the bundle, not the speed of the entire bundle. * Check the LinkType enum for the list of possible values. * @type string $name - * Name of the Interconnects to be created. This must be specified on the template and/or on each individual interconnect. The name, if not empty, must be 1-63 characters long, and comply with RFC1035. Specifically, any nonempty name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the Interconnects to be created. This must be specified on the + * template and/or on each individual interconnect. The name, if not empty, + * must be 1-63 characters long, and comply with RFC1035. + * Specifically, any nonempty name must be 1-63 characters long and match + * the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * @type string $noc_contact_email - * Email address to contact the customer NOC for operations and maintenance notifications regarding this Interconnect. If specified, this will be used for notifications in addition to all other forms described, such as Cloud Monitoring logs alerting and Cloud Notifications. This field is required for users who sign up for Cloud Interconnect using workforce identity federation. + * Email address to contact the customer NOC for operations and maintenance + * notifications regarding this Interconnect. If specified, this will be + * used for notifications in addition to all other forms described, such as + * Cloud Monitoring logs alerting and Cloud Notifications. This field is + * required for users who sign up for Cloud Interconnect using + * workforce identity federation. * @type string $remote_location - * Indicates that this is a Cross-Cloud Interconnect. This field specifies the location outside of Google's network that the interconnect is connected to. + * Indicates that this is a Cross-Cloud Interconnect. This field specifies + * the location outside of Google's network that the interconnect is + * connected to. * @type array|\Google\Protobuf\Internal\RepeatedField $requested_features - * Optional. List of features requested for this Interconnect connection, which can take one of the following values: - IF_MACSEC If specified then the connection is created on MACsec capable hardware ports. If not specified, the default value is false, which allocates non-MACsec capable ports first if available. This parameter can be provided only with Interconnect INSERT. It isn't valid for Interconnect PATCH. + * Optional. List of features requested for this Interconnect connection, + * which can take one of the following values: + * - IF_MACSEC: If specified, then the connection is created on MACsec + * capable hardware ports. If not specified, non-MACsec capable ports will + * also be considered. + * - IF_CROSS_SITE_NETWORK: If specified, then the connection is created + * exclusively for Cross-Site Networking. The connection can not be used for + * Cross-Site Networking unless this feature is specified. * Check the RequestedFeatures enum for the list of possible values. * @type int $requested_link_count - * Target number of physical links in the link bundle, as requested by the customer. + * Target number of physical links in the link bundle, as requested by the + * customer. * } */ public function __construct($data = NULL) { @@ -124,7 +206,11 @@ public function __construct($data = NULL) { } /** - * Administrative status of the interconnect. When this is set to true, the Interconnect is functional and can carry traffic. When set to false, no packets can be carried over the interconnect and no BGP routes are exchanged over it. By default, the status is set to true. + * Administrative status of the interconnect. When this is set to true, the + * Interconnect is functional and can carry traffic. + * When set to false, no packets can be carried over the interconnect and + * no BGP routes are exchanged over it. By default, the status is set to + * true. * * Generated from protobuf field optional bool admin_enabled = 445675089; * @return bool @@ -145,7 +231,11 @@ public function clearAdminEnabled() } /** - * Administrative status of the interconnect. When this is set to true, the Interconnect is functional and can carry traffic. When set to false, no packets can be carried over the interconnect and no BGP routes are exchanged over it. By default, the status is set to true. + * Administrative status of the interconnect. When this is set to true, the + * Interconnect is functional and can carry traffic. + * When set to false, no packets can be carried over the interconnect and + * no BGP routes are exchanged over it. By default, the status is set to + * true. * * Generated from protobuf field optional bool admin_enabled = 445675089; * @param bool $var @@ -160,7 +250,8 @@ public function setAdminEnabled($var) } /** - * Customer name, to put in the Letter of Authorization as the party authorized to request a crossconnect. + * Customer name, to put in the Letter of Authorization as the party + * authorized to request a crossconnect. * * Generated from protobuf field optional string customer_name = 3665484; * @return string @@ -181,7 +272,8 @@ public function clearCustomerName() } /** - * Customer name, to put in the Letter of Authorization as the party authorized to request a crossconnect. + * Customer name, to put in the Letter of Authorization as the party + * authorized to request a crossconnect. * * Generated from protobuf field optional string customer_name = 3665484; * @param string $var @@ -196,7 +288,8 @@ public function setCustomerName($var) } /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @return string @@ -217,7 +310,8 @@ public function clearDescription() } /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @param string $var @@ -232,7 +326,8 @@ public function setDescription($var) } /** - * A zone-free location to use for all Interconnects created in this call, like "iad-1234". + * A zone-free location to use for all Interconnects created in this call, + * like "iad-1234". * * Generated from protobuf field optional string facility = 501116579; * @return string @@ -253,7 +348,8 @@ public function clearFacility() } /** - * A zone-free location to use for all Interconnects created in this call, like "iad-1234". + * A zone-free location to use for all Interconnects created in this call, + * like "iad-1234". * * Generated from protobuf field optional string facility = 501116579; * @param string $var @@ -268,7 +364,13 @@ public function setFacility($var) } /** - * Type of interconnect, which can take one of the following values: - PARTNER: A partner-managed interconnection shared between customers though a partner. - DEDICATED: A dedicated physical interconnection with the customer. Note that a value IT_PRIVATE has been deprecated in favor of DEDICATED. + * Type of interconnect, which can take one of the following values: + * - PARTNER: A partner-managed interconnection shared between + * customers though a partner. + * - DEDICATED: A dedicated physical + * interconnection with the customer. + * Note that a value IT_PRIVATE + * has been deprecated in favor of DEDICATED. * Check the InterconnectType enum for the list of possible values. * * Generated from protobuf field optional string interconnect_type = 515165259; @@ -290,7 +392,13 @@ public function clearInterconnectType() } /** - * Type of interconnect, which can take one of the following values: - PARTNER: A partner-managed interconnection shared between customers though a partner. - DEDICATED: A dedicated physical interconnection with the customer. Note that a value IT_PRIVATE has been deprecated in favor of DEDICATED. + * Type of interconnect, which can take one of the following values: + * - PARTNER: A partner-managed interconnection shared between + * customers though a partner. + * - DEDICATED: A dedicated physical + * interconnection with the customer. + * Note that a value IT_PRIVATE + * has been deprecated in favor of DEDICATED. * Check the InterconnectType enum for the list of possible values. * * Generated from protobuf field optional string interconnect_type = 515165259; @@ -306,7 +414,13 @@ public function setInterconnectType($var) } /** - * Type of link requested, which can take one of the following values: - LINK_TYPE_ETHERNET_10G_LR: A 10G Ethernet with LR optics - LINK_TYPE_ETHERNET_100G_LR: A 100G Ethernet with LR optics. - LINK_TYPE_ETHERNET_400G_LR4: A 400G Ethernet with LR4 optics. Note that this field indicates the speed of each of the links in the bundle, not the speed of the entire bundle. + * Type of link requested, which can take one of the following values: + * - LINK_TYPE_ETHERNET_10G_LR: A 10G Ethernet with LR optics + * - LINK_TYPE_ETHERNET_100G_LR: A 100G Ethernet with LR optics. + * - LINK_TYPE_ETHERNET_400G_LR4: A 400G Ethernet with LR4 + * optics. + * Note that this field indicates the speed of each of the + * links in the bundle, not the speed of the entire bundle. * Check the LinkType enum for the list of possible values. * * Generated from protobuf field optional string link_type = 523207775; @@ -328,7 +442,13 @@ public function clearLinkType() } /** - * Type of link requested, which can take one of the following values: - LINK_TYPE_ETHERNET_10G_LR: A 10G Ethernet with LR optics - LINK_TYPE_ETHERNET_100G_LR: A 100G Ethernet with LR optics. - LINK_TYPE_ETHERNET_400G_LR4: A 400G Ethernet with LR4 optics. Note that this field indicates the speed of each of the links in the bundle, not the speed of the entire bundle. + * Type of link requested, which can take one of the following values: + * - LINK_TYPE_ETHERNET_10G_LR: A 10G Ethernet with LR optics + * - LINK_TYPE_ETHERNET_100G_LR: A 100G Ethernet with LR optics. + * - LINK_TYPE_ETHERNET_400G_LR4: A 400G Ethernet with LR4 + * optics. + * Note that this field indicates the speed of each of the + * links in the bundle, not the speed of the entire bundle. * Check the LinkType enum for the list of possible values. * * Generated from protobuf field optional string link_type = 523207775; @@ -344,7 +464,14 @@ public function setLinkType($var) } /** - * Name of the Interconnects to be created. This must be specified on the template and/or on each individual interconnect. The name, if not empty, must be 1-63 characters long, and comply with RFC1035. Specifically, any nonempty name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the Interconnects to be created. This must be specified on the + * template and/or on each individual interconnect. The name, if not empty, + * must be 1-63 characters long, and comply with RFC1035. + * Specifically, any nonempty name must be 1-63 characters long and match + * the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * * Generated from protobuf field optional string name = 3373707; * @return string @@ -365,7 +492,14 @@ public function clearName() } /** - * Name of the Interconnects to be created. This must be specified on the template and/or on each individual interconnect. The name, if not empty, must be 1-63 characters long, and comply with RFC1035. Specifically, any nonempty name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the Interconnects to be created. This must be specified on the + * template and/or on each individual interconnect. The name, if not empty, + * must be 1-63 characters long, and comply with RFC1035. + * Specifically, any nonempty name must be 1-63 characters long and match + * the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * * Generated from protobuf field optional string name = 3373707; * @param string $var @@ -380,7 +514,12 @@ public function setName($var) } /** - * Email address to contact the customer NOC for operations and maintenance notifications regarding this Interconnect. If specified, this will be used for notifications in addition to all other forms described, such as Cloud Monitoring logs alerting and Cloud Notifications. This field is required for users who sign up for Cloud Interconnect using workforce identity federation. + * Email address to contact the customer NOC for operations and maintenance + * notifications regarding this Interconnect. If specified, this will be + * used for notifications in addition to all other forms described, such as + * Cloud Monitoring logs alerting and Cloud Notifications. This field is + * required for users who sign up for Cloud Interconnect using + * workforce identity federation. * * Generated from protobuf field optional string noc_contact_email = 14072832; * @return string @@ -401,7 +540,12 @@ public function clearNocContactEmail() } /** - * Email address to contact the customer NOC for operations and maintenance notifications regarding this Interconnect. If specified, this will be used for notifications in addition to all other forms described, such as Cloud Monitoring logs alerting and Cloud Notifications. This field is required for users who sign up for Cloud Interconnect using workforce identity federation. + * Email address to contact the customer NOC for operations and maintenance + * notifications regarding this Interconnect. If specified, this will be + * used for notifications in addition to all other forms described, such as + * Cloud Monitoring logs alerting and Cloud Notifications. This field is + * required for users who sign up for Cloud Interconnect using + * workforce identity federation. * * Generated from protobuf field optional string noc_contact_email = 14072832; * @param string $var @@ -416,7 +560,9 @@ public function setNocContactEmail($var) } /** - * Indicates that this is a Cross-Cloud Interconnect. This field specifies the location outside of Google's network that the interconnect is connected to. + * Indicates that this is a Cross-Cloud Interconnect. This field specifies + * the location outside of Google's network that the interconnect is + * connected to. * * Generated from protobuf field optional string remote_location = 324388750; * @return string @@ -437,7 +583,9 @@ public function clearRemoteLocation() } /** - * Indicates that this is a Cross-Cloud Interconnect. This field specifies the location outside of Google's network that the interconnect is connected to. + * Indicates that this is a Cross-Cloud Interconnect. This field specifies + * the location outside of Google's network that the interconnect is + * connected to. * * Generated from protobuf field optional string remote_location = 324388750; * @param string $var @@ -452,7 +600,14 @@ public function setRemoteLocation($var) } /** - * Optional. List of features requested for this Interconnect connection, which can take one of the following values: - IF_MACSEC If specified then the connection is created on MACsec capable hardware ports. If not specified, the default value is false, which allocates non-MACsec capable ports first if available. This parameter can be provided only with Interconnect INSERT. It isn't valid for Interconnect PATCH. + * Optional. List of features requested for this Interconnect connection, + * which can take one of the following values: + * - IF_MACSEC: If specified, then the connection is created on MACsec + * capable hardware ports. If not specified, non-MACsec capable ports will + * also be considered. + * - IF_CROSS_SITE_NETWORK: If specified, then the connection is created + * exclusively for Cross-Site Networking. The connection can not be used for + * Cross-Site Networking unless this feature is specified. * Check the RequestedFeatures enum for the list of possible values. * * Generated from protobuf field repeated string requested_features = 461240814; @@ -464,7 +619,14 @@ public function getRequestedFeatures() } /** - * Optional. List of features requested for this Interconnect connection, which can take one of the following values: - IF_MACSEC If specified then the connection is created on MACsec capable hardware ports. If not specified, the default value is false, which allocates non-MACsec capable ports first if available. This parameter can be provided only with Interconnect INSERT. It isn't valid for Interconnect PATCH. + * Optional. List of features requested for this Interconnect connection, + * which can take one of the following values: + * - IF_MACSEC: If specified, then the connection is created on MACsec + * capable hardware ports. If not specified, non-MACsec capable ports will + * also be considered. + * - IF_CROSS_SITE_NETWORK: If specified, then the connection is created + * exclusively for Cross-Site Networking. The connection can not be used for + * Cross-Site Networking unless this feature is specified. * Check the RequestedFeatures enum for the list of possible values. * * Generated from protobuf field repeated string requested_features = 461240814; @@ -480,7 +642,8 @@ public function setRequestedFeatures($var) } /** - * Target number of physical links in the link bundle, as requested by the customer. + * Target number of physical links in the link bundle, as requested by the + * customer. * * Generated from protobuf field optional int32 requested_link_count = 45051387; * @return int @@ -501,7 +664,8 @@ public function clearRequestedLinkCount() } /** - * Target number of physical links in the link bundle, as requested by the customer. + * Target number of physical links in the link bundle, as requested by the + * customer. * * Generated from protobuf field optional int32 requested_link_count = 45051387; * @param int $var diff --git a/Compute/src/V1/InterconnectGroupsCreateMembersInterconnectInput/InterconnectType.php b/Compute/src/V1/InterconnectGroupsCreateMembersInterconnectInput/InterconnectType.php index 2ad2d550bb18..57a3f4b81432 100644 --- a/Compute/src/V1/InterconnectGroupsCreateMembersInterconnectInput/InterconnectType.php +++ b/Compute/src/V1/InterconnectGroupsCreateMembersInterconnectInput/InterconnectType.php @@ -7,7 +7,13 @@ use UnexpectedValueException; /** - * Type of interconnect, which can take one of the following values: - PARTNER: A partner-managed interconnection shared between customers though a partner. - DEDICATED: A dedicated physical interconnection with the customer. Note that a value IT_PRIVATE has been deprecated in favor of DEDICATED. + * Type of interconnect, which can take one of the following values: + * - PARTNER: A partner-managed interconnection shared between + * customers though a partner. + * - DEDICATED: A dedicated physical + * interconnection with the customer. + * Note that a value IT_PRIVATE + * has been deprecated in favor of DEDICATED. * * Protobuf type google.cloud.compute.v1.InterconnectGroupsCreateMembersInterconnectInput.InterconnectType */ diff --git a/Compute/src/V1/InterconnectGroupsCreateMembersInterconnectInput/LinkType.php b/Compute/src/V1/InterconnectGroupsCreateMembersInterconnectInput/LinkType.php index f7596bc49a43..db50cbb78ec3 100644 --- a/Compute/src/V1/InterconnectGroupsCreateMembersInterconnectInput/LinkType.php +++ b/Compute/src/V1/InterconnectGroupsCreateMembersInterconnectInput/LinkType.php @@ -7,7 +7,13 @@ use UnexpectedValueException; /** - * Type of link requested, which can take one of the following values: - LINK_TYPE_ETHERNET_10G_LR: A 10G Ethernet with LR optics - LINK_TYPE_ETHERNET_100G_LR: A 100G Ethernet with LR optics. - LINK_TYPE_ETHERNET_400G_LR4: A 400G Ethernet with LR4 optics. Note that this field indicates the speed of each of the links in the bundle, not the speed of the entire bundle. + * Type of link requested, which can take one of the following values: + * - LINK_TYPE_ETHERNET_10G_LR: A 10G Ethernet with LR optics + * - LINK_TYPE_ETHERNET_100G_LR: A 100G Ethernet with LR optics. + * - LINK_TYPE_ETHERNET_400G_LR4: A 400G Ethernet with LR4 + * optics. + * Note that this field indicates the speed of each of the + * links in the bundle, not the speed of the entire bundle. * * Protobuf type google.cloud.compute.v1.InterconnectGroupsCreateMembersInterconnectInput.LinkType */ @@ -26,7 +32,8 @@ class LinkType */ const LINK_TYPE_ETHERNET_100G_LR = 337672551; /** - * 10G Ethernet, LR Optics. [(rate_bps) = 10000000000]; + * 10G Ethernet, LR Optics. + * [(rate_bps) = 10000000000]; * * Generated from protobuf enum LINK_TYPE_ETHERNET_10G_LR = 236739749; */ diff --git a/Compute/src/V1/InterconnectGroupsCreateMembersInterconnectInput/RequestedFeatures.php b/Compute/src/V1/InterconnectGroupsCreateMembersInterconnectInput/RequestedFeatures.php index 19f3a479d9d8..8065a51a1c0c 100644 --- a/Compute/src/V1/InterconnectGroupsCreateMembersInterconnectInput/RequestedFeatures.php +++ b/Compute/src/V1/InterconnectGroupsCreateMembersInterconnectInput/RequestedFeatures.php @@ -18,6 +18,18 @@ class RequestedFeatures * Generated from protobuf enum UNDEFINED_REQUESTED_FEATURES = 0; */ const UNDEFINED_REQUESTED_FEATURES = 0; + /** + * Cross-Site Networking + * + * Generated from protobuf enum IF_CROSS_SITE_NETWORK = 469111095; + */ + const IF_CROSS_SITE_NETWORK = 469111095; + /** + * L2 Interconnect Attachment Forwarding + * + * Generated from protobuf enum IF_L2_FORWARDING = 125563860; + */ + const IF_L2_FORWARDING = 125563860; /** * Media Access Control security (MACsec) * @@ -27,6 +39,8 @@ class RequestedFeatures private static $valueToName = [ self::UNDEFINED_REQUESTED_FEATURES => 'UNDEFINED_REQUESTED_FEATURES', + self::IF_CROSS_SITE_NETWORK => 'IF_CROSS_SITE_NETWORK', + self::IF_L2_FORWARDING => 'IF_L2_FORWARDING', self::IF_MACSEC => 'IF_MACSEC', ]; diff --git a/Compute/src/V1/InterconnectGroupsListResponse.php b/Compute/src/V1/InterconnectGroupsListResponse.php index 6adc8a18e940..05f30df54be9 100644 --- a/Compute/src/V1/InterconnectGroupsListResponse.php +++ b/Compute/src/V1/InterconnectGroupsListResponse.php @@ -35,7 +35,11 @@ class InterconnectGroupsListResponse extends \Google\Protobuf\Internal\Message */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -47,7 +51,8 @@ class InterconnectGroupsListResponse extends \Google\Protobuf\Internal\Message */ protected $self_link = null; /** - * [Output Only] Unreachable resources. end_interface: MixerListResponseWithEtagBuilder + * [Output Only] Unreachable resources. + * end_interface: MixerListResponseWithEtagBuilder * * Generated from protobuf field repeated string unreachables = 243372063; */ @@ -72,11 +77,16 @@ class InterconnectGroupsListResponse extends \Google\Protobuf\Internal\Message * A list of InterconnectGroup resources. * @type string $kind * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type array|\Google\Protobuf\Internal\RepeatedField $unreachables - * [Output Only] Unreachable resources. end_interface: MixerListResponseWithEtagBuilder + * [Output Only] Unreachable resources. + * end_interface: MixerListResponseWithEtagBuilder * @type \Google\Cloud\Compute\V1\Warning $warning * [Output Only] Informational warning message. * } @@ -213,7 +223,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -234,7 +248,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var @@ -285,7 +303,8 @@ public function setSelfLink($var) } /** - * [Output Only] Unreachable resources. end_interface: MixerListResponseWithEtagBuilder + * [Output Only] Unreachable resources. + * end_interface: MixerListResponseWithEtagBuilder * * Generated from protobuf field repeated string unreachables = 243372063; * @return \Google\Protobuf\Internal\RepeatedField @@ -296,7 +315,8 @@ public function getUnreachables() } /** - * [Output Only] Unreachable resources. end_interface: MixerListResponseWithEtagBuilder + * [Output Only] Unreachable resources. + * end_interface: MixerListResponseWithEtagBuilder * * Generated from protobuf field repeated string unreachables = 243372063; * @param array|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/InterconnectGroupsOperationalStatusInterconnectStatus.php b/Compute/src/V1/InterconnectGroupsOperationalStatusInterconnectStatus.php index b97c7c4ed2a1..58fc52a7141f 100644 --- a/Compute/src/V1/InterconnectGroupsOperationalStatusInterconnectStatus.php +++ b/Compute/src/V1/InterconnectGroupsOperationalStatusInterconnectStatus.php @@ -22,7 +22,8 @@ class InterconnectGroupsOperationalStatusInterconnectStatus extends \Google\Prot */ protected $admin_enabled = null; /** - * The diagnostics of the Interconnect, as returned by the existing get-diagnostics method. + * The diagnostics of the Interconnect, as returned by the existing + * get-diagnostics method. * * Generated from protobuf field optional .google.cloud.compute.v1.InterconnectDiagnostics diagnostics = 333355436; */ @@ -34,7 +35,8 @@ class InterconnectGroupsOperationalStatusInterconnectStatus extends \Google\Prot */ protected $interconnect = null; /** - * Whether this interconnect is participating in the redundant configuration. + * Whether this interconnect is participating in the redundant + * configuration. * Check the IsActive enum for the list of possible values. * * Generated from protobuf field optional string is_active = 114830267; @@ -50,11 +52,13 @@ class InterconnectGroupsOperationalStatusInterconnectStatus extends \Google\Prot * @type bool $admin_enabled * Whether the Interconnect is enabled. * @type \Google\Cloud\Compute\V1\InterconnectDiagnostics $diagnostics - * The diagnostics of the Interconnect, as returned by the existing get-diagnostics method. + * The diagnostics of the Interconnect, as returned by the existing + * get-diagnostics method. * @type string $interconnect * The URL of the Interconnect being described. * @type string $is_active - * Whether this interconnect is participating in the redundant configuration. + * Whether this interconnect is participating in the redundant + * configuration. * Check the IsActive enum for the list of possible values. * } */ @@ -100,7 +104,8 @@ public function setAdminEnabled($var) } /** - * The diagnostics of the Interconnect, as returned by the existing get-diagnostics method. + * The diagnostics of the Interconnect, as returned by the existing + * get-diagnostics method. * * Generated from protobuf field optional .google.cloud.compute.v1.InterconnectDiagnostics diagnostics = 333355436; * @return \Google\Cloud\Compute\V1\InterconnectDiagnostics|null @@ -121,7 +126,8 @@ public function clearDiagnostics() } /** - * The diagnostics of the Interconnect, as returned by the existing get-diagnostics method. + * The diagnostics of the Interconnect, as returned by the existing + * get-diagnostics method. * * Generated from protobuf field optional .google.cloud.compute.v1.InterconnectDiagnostics diagnostics = 333355436; * @param \Google\Cloud\Compute\V1\InterconnectDiagnostics $var @@ -172,7 +178,8 @@ public function setInterconnect($var) } /** - * Whether this interconnect is participating in the redundant configuration. + * Whether this interconnect is participating in the redundant + * configuration. * Check the IsActive enum for the list of possible values. * * Generated from protobuf field optional string is_active = 114830267; @@ -194,7 +201,8 @@ public function clearIsActive() } /** - * Whether this interconnect is participating in the redundant configuration. + * Whether this interconnect is participating in the redundant + * configuration. * Check the IsActive enum for the list of possible values. * * Generated from protobuf field optional string is_active = 114830267; diff --git a/Compute/src/V1/InterconnectGroupsOperationalStatusInterconnectStatus/IsActive.php b/Compute/src/V1/InterconnectGroupsOperationalStatusInterconnectStatus/IsActive.php index 976620874872..45634f8ecf1f 100644 --- a/Compute/src/V1/InterconnectGroupsOperationalStatusInterconnectStatus/IsActive.php +++ b/Compute/src/V1/InterconnectGroupsOperationalStatusInterconnectStatus/IsActive.php @@ -7,7 +7,8 @@ use UnexpectedValueException; /** - * Whether this interconnect is participating in the redundant configuration. + * Whether this interconnect is participating in the redundant + * configuration. * * Protobuf type google.cloud.compute.v1.InterconnectGroupsOperationalStatusInterconnectStatus.IsActive */ diff --git a/Compute/src/V1/InterconnectList.php b/Compute/src/V1/InterconnectList.php index e3f1175c6e86..9d4790e18322 100644 --- a/Compute/src/V1/InterconnectList.php +++ b/Compute/src/V1/InterconnectList.php @@ -28,13 +28,17 @@ class InterconnectList extends \Google\Protobuf\Internal\Message */ private $items; /** - * [Output Only] Type of resource. Always compute#interconnectList for lists of interconnects. + * [Output Only] Type of resource. Alwayscompute#interconnectList for lists of interconnects. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -63,9 +67,13 @@ class InterconnectList extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\Interconnect>|\Google\Protobuf\Internal\RepeatedField $items * A list of Interconnect resources. * @type string $kind - * [Output Only] Type of resource. Always compute#interconnectList for lists of interconnects. + * [Output Only] Type of resource. Alwayscompute#interconnectList for lists of interconnects. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type \Google\Cloud\Compute\V1\Warning $warning @@ -140,7 +148,7 @@ public function setItems($var) } /** - * [Output Only] Type of resource. Always compute#interconnectList for lists of interconnects. + * [Output Only] Type of resource. Alwayscompute#interconnectList for lists of interconnects. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -161,7 +169,7 @@ public function clearKind() } /** - * [Output Only] Type of resource. Always compute#interconnectList for lists of interconnects. + * [Output Only] Type of resource. Alwayscompute#interconnectList for lists of interconnects. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -176,7 +184,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -197,7 +209,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/InterconnectLocation.php b/Compute/src/V1/InterconnectLocation.php index 17990c0ed856..ee85c852c2a1 100644 --- a/Compute/src/V1/InterconnectLocation.php +++ b/Compute/src/V1/InterconnectLocation.php @@ -9,57 +9,88 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Represents an Interconnect Attachment (VLAN) Location resource. You can use this resource to find location details about an Interconnect attachment (VLAN). For more information about interconnect attachments, read Creating VLAN Attachments. + * Represents an Interconnect Attachment (VLAN) Location resource. + * You can use this resource to find location details about an Interconnect + * attachment (VLAN). For more information about interconnect attachments, read + * Creating VLAN Attachments. * * Generated from protobuf message google.cloud.compute.v1.InterconnectLocation */ class InterconnectLocation extends \Google\Protobuf\Internal\Message { /** - * [Output Only] The postal address of the Point of Presence, each line in the address is separated by a newline character. + * [Output Only] The postal address of the Point of Presence, each line in + * the address is separated by a newline character. * * Generated from protobuf field optional string address = 462920692; */ protected $address = null; /** - * [Output Only] Availability zone for this InterconnectLocation. Within a metropolitan area (metro), maintenance will not be simultaneously scheduled in more than one availability zone. Example: "zone1" or "zone2". + * [Output Only] Availability zone for this InterconnectLocation. Within a + * metropolitan area (metro), maintenance will not be simultaneously scheduled + * in more than one availability zone. Example: "zone1" or "zone2". * * Generated from protobuf field optional string availability_zone = 158459920; */ protected $availability_zone = null; /** - * [Output only] List of features available at this InterconnectLocation, which can take one of the following values: - IF_MACSEC + * [Output only] List of features available at this InterconnectLocation, + * which can take one of the following values: + * - IF_MACSEC + * - IF_CROSS_SITE_NETWORK * Check the AvailableFeatures enum for the list of possible values. * * Generated from protobuf field repeated string available_features = 496344307; */ private $available_features; /** - * [Output only] List of link types available at this InterconnectLocation, which can take one of the following values: - LINK_TYPE_ETHERNET_10G_LR - LINK_TYPE_ETHERNET_100G_LR - LINK_TYPE_ETHERNET_400G_LR4 + * [Output only] List of link types available at this InterconnectLocation, + * which can take one of the following values: + * - LINK_TYPE_ETHERNET_10G_LR + * - LINK_TYPE_ETHERNET_100G_LR + * - LINK_TYPE_ETHERNET_400G_LR4 * Check the AvailableLinkTypes enum for the list of possible values. * * Generated from protobuf field repeated string available_link_types = 509504298; */ private $available_link_types; /** - * [Output Only] Metropolitan area designator that indicates which city an interconnect is located. For example: "Chicago, IL", "Amsterdam, Netherlands". + * [Output Only] Metropolitan area designator that indicates which city an + * interconnect is located. + * For example: "Chicago, IL", "Amsterdam, Netherlands". * * Generated from protobuf field optional string city = 3053931; */ protected $city = null; /** - * [Output Only] Continent for this location, which can take one of the following values: - AFRICA - ASIA_PAC - EUROPE - NORTH_AMERICA - SOUTH_AMERICA + * [Output Only] Continent for this location, which can take one of the + * following values: + * - AFRICA + * - ASIA_PAC + * - EUROPE + * - NORTH_AMERICA + * - SOUTH_AMERICA * Check the Continent enum for the list of possible values. * * Generated from protobuf field optional string continent = 133442996; */ protected $continent = null; /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; */ protected $creation_timestamp = null; + /** + * [Output Only] A list of InterconnectLocation.CrossSiteInterconnectInfo + * objects, that describe where Cross-Site Interconnect wires may connect to + * from this location and associated connection parameters. Cross-Site + * Interconnect isn't allowed to locations which are not listed. + * + * Generated from protobuf field repeated .google.cloud.compute.v1.InterconnectLocationCrossSiteInterconnectInfo cross_site_interconnect_infos = 248573837; + */ + private $cross_site_interconnect_infos; /** * [Output Only] An optional description of the resource. * @@ -73,19 +104,21 @@ class InterconnectLocation extends \Google\Protobuf\Internal\Message */ protected $facility_provider = null; /** - * [Output Only] A provider-assigned Identifier for this facility (e.g., Ashburn-DC1). + * [Output Only] A provider-assigned Identifier for this facility (e.g., + * Ashburn-DC1). * * Generated from protobuf field optional string facility_provider_facility_id = 87269125; */ protected $facility_provider_facility_id = null; /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; */ protected $id = null; /** - * [Output Only] Type of the resource. Always compute#interconnectLocation for interconnect locations. + * [Output Only] Type of the resource. Alwayscompute#interconnectLocation for interconnect locations. * * Generated from protobuf field optional string kind = 3292052; */ @@ -97,13 +130,16 @@ class InterconnectLocation extends \Google\Protobuf\Internal\Message */ protected $name = null; /** - * [Output Only] The peeringdb identifier for this facility (corresponding with a netfac type in peeringdb). + * [Output Only] The peeringdb identifier for this facility (corresponding + * with a netfac type in peeringdb). * * Generated from protobuf field optional string peeringdb_facility_id = 536567094; */ protected $peeringdb_facility_id = null; /** - * [Output Only] A list of InterconnectLocation.RegionInfo objects, that describe parameters pertaining to the relation between this InterconnectLocation and various Google Cloud regions. + * [Output Only] A list of InterconnectLocation.RegionInfo objects, that + * describe parameters pertaining to the relation between this + * InterconnectLocation and various Google Cloud regions. * * Generated from protobuf field repeated .google.cloud.compute.v1.InterconnectLocationRegionInfo region_infos = 312194170; */ @@ -115,13 +151,20 @@ class InterconnectLocation extends \Google\Protobuf\Internal\Message */ protected $self_link = null; /** - * [Output Only] URLs of the other locations that can pair up with this location to support Single-Region 99.99% SLA. E.g. iad-zone1-1 and iad-zone2-5467 are Single-Region 99.99% peer locations of each other. + * [Output Only] URLs of the other locations that can pair up with this + * location to support Single-Region 99.99% SLA. E.g. iad-zone1-1 and + * iad-zone2-5467 are Single-Region 99.99% peer locations of each other. * * Generated from protobuf field repeated string single_region_production_critical_peer_locations = 439537103; */ private $single_region_production_critical_peer_locations; /** - * [Output Only] The status of this InterconnectLocation, which can take one of the following values: - CLOSED: The InterconnectLocation is closed and is unavailable for provisioning new Interconnects. - AVAILABLE: The InterconnectLocation is available for provisioning new Interconnects. + * [Output Only] The status of this InterconnectLocation, which can take one + * of the following values: + * - CLOSED: The InterconnectLocation is closed and is unavailable for + * provisioning new Interconnects. + * - AVAILABLE: The InterconnectLocation is available for provisioning new + * Interconnects. * Check the Status enum for the list of possible values. * * Generated from protobuf field optional string status = 181260274; @@ -141,44 +184,80 @@ class InterconnectLocation extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $address - * [Output Only] The postal address of the Point of Presence, each line in the address is separated by a newline character. + * [Output Only] The postal address of the Point of Presence, each line in + * the address is separated by a newline character. * @type string $availability_zone - * [Output Only] Availability zone for this InterconnectLocation. Within a metropolitan area (metro), maintenance will not be simultaneously scheduled in more than one availability zone. Example: "zone1" or "zone2". + * [Output Only] Availability zone for this InterconnectLocation. Within a + * metropolitan area (metro), maintenance will not be simultaneously scheduled + * in more than one availability zone. Example: "zone1" or "zone2". * @type array|\Google\Protobuf\Internal\RepeatedField $available_features - * [Output only] List of features available at this InterconnectLocation, which can take one of the following values: - IF_MACSEC + * [Output only] List of features available at this InterconnectLocation, + * which can take one of the following values: + * - IF_MACSEC + * - IF_CROSS_SITE_NETWORK * Check the AvailableFeatures enum for the list of possible values. * @type array|\Google\Protobuf\Internal\RepeatedField $available_link_types - * [Output only] List of link types available at this InterconnectLocation, which can take one of the following values: - LINK_TYPE_ETHERNET_10G_LR - LINK_TYPE_ETHERNET_100G_LR - LINK_TYPE_ETHERNET_400G_LR4 + * [Output only] List of link types available at this InterconnectLocation, + * which can take one of the following values: + * - LINK_TYPE_ETHERNET_10G_LR + * - LINK_TYPE_ETHERNET_100G_LR + * - LINK_TYPE_ETHERNET_400G_LR4 * Check the AvailableLinkTypes enum for the list of possible values. * @type string $city - * [Output Only] Metropolitan area designator that indicates which city an interconnect is located. For example: "Chicago, IL", "Amsterdam, Netherlands". + * [Output Only] Metropolitan area designator that indicates which city an + * interconnect is located. + * For example: "Chicago, IL", "Amsterdam, Netherlands". * @type string $continent - * [Output Only] Continent for this location, which can take one of the following values: - AFRICA - ASIA_PAC - EUROPE - NORTH_AMERICA - SOUTH_AMERICA + * [Output Only] Continent for this location, which can take one of the + * following values: + * - AFRICA + * - ASIA_PAC + * - EUROPE + * - NORTH_AMERICA + * - SOUTH_AMERICA * Check the Continent enum for the list of possible values. * @type string $creation_timestamp - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. + * @type array<\Google\Cloud\Compute\V1\InterconnectLocationCrossSiteInterconnectInfo>|\Google\Protobuf\Internal\RepeatedField $cross_site_interconnect_infos + * [Output Only] A list of InterconnectLocation.CrossSiteInterconnectInfo + * objects, that describe where Cross-Site Interconnect wires may connect to + * from this location and associated connection parameters. Cross-Site + * Interconnect isn't allowed to locations which are not listed. * @type string $description * [Output Only] An optional description of the resource. * @type string $facility_provider * [Output Only] The name of the provider for this facility (e.g., EQUINIX). * @type string $facility_provider_facility_id - * [Output Only] A provider-assigned Identifier for this facility (e.g., Ashburn-DC1). + * [Output Only] A provider-assigned Identifier for this facility (e.g., + * Ashburn-DC1). * @type int|string $id - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * @type string $kind - * [Output Only] Type of the resource. Always compute#interconnectLocation for interconnect locations. + * [Output Only] Type of the resource. Alwayscompute#interconnectLocation for interconnect locations. * @type string $name * [Output Only] Name of the resource. * @type string $peeringdb_facility_id - * [Output Only] The peeringdb identifier for this facility (corresponding with a netfac type in peeringdb). + * [Output Only] The peeringdb identifier for this facility (corresponding + * with a netfac type in peeringdb). * @type array<\Google\Cloud\Compute\V1\InterconnectLocationRegionInfo>|\Google\Protobuf\Internal\RepeatedField $region_infos - * [Output Only] A list of InterconnectLocation.RegionInfo objects, that describe parameters pertaining to the relation between this InterconnectLocation and various Google Cloud regions. + * [Output Only] A list of InterconnectLocation.RegionInfo objects, that + * describe parameters pertaining to the relation between this + * InterconnectLocation and various Google Cloud regions. * @type string $self_link * [Output Only] Server-defined URL for the resource. * @type array|\Google\Protobuf\Internal\RepeatedField $single_region_production_critical_peer_locations - * [Output Only] URLs of the other locations that can pair up with this location to support Single-Region 99.99% SLA. E.g. iad-zone1-1 and iad-zone2-5467 are Single-Region 99.99% peer locations of each other. + * [Output Only] URLs of the other locations that can pair up with this + * location to support Single-Region 99.99% SLA. E.g. iad-zone1-1 and + * iad-zone2-5467 are Single-Region 99.99% peer locations of each other. * @type string $status - * [Output Only] The status of this InterconnectLocation, which can take one of the following values: - CLOSED: The InterconnectLocation is closed and is unavailable for provisioning new Interconnects. - AVAILABLE: The InterconnectLocation is available for provisioning new Interconnects. + * [Output Only] The status of this InterconnectLocation, which can take one + * of the following values: + * - CLOSED: The InterconnectLocation is closed and is unavailable for + * provisioning new Interconnects. + * - AVAILABLE: The InterconnectLocation is available for provisioning new + * Interconnects. * Check the Status enum for the list of possible values. * @type bool $supports_pzs * [Output Only] Reserved for future use. @@ -190,7 +269,8 @@ public function __construct($data = NULL) { } /** - * [Output Only] The postal address of the Point of Presence, each line in the address is separated by a newline character. + * [Output Only] The postal address of the Point of Presence, each line in + * the address is separated by a newline character. * * Generated from protobuf field optional string address = 462920692; * @return string @@ -211,7 +291,8 @@ public function clearAddress() } /** - * [Output Only] The postal address of the Point of Presence, each line in the address is separated by a newline character. + * [Output Only] The postal address of the Point of Presence, each line in + * the address is separated by a newline character. * * Generated from protobuf field optional string address = 462920692; * @param string $var @@ -226,7 +307,9 @@ public function setAddress($var) } /** - * [Output Only] Availability zone for this InterconnectLocation. Within a metropolitan area (metro), maintenance will not be simultaneously scheduled in more than one availability zone. Example: "zone1" or "zone2". + * [Output Only] Availability zone for this InterconnectLocation. Within a + * metropolitan area (metro), maintenance will not be simultaneously scheduled + * in more than one availability zone. Example: "zone1" or "zone2". * * Generated from protobuf field optional string availability_zone = 158459920; * @return string @@ -247,7 +330,9 @@ public function clearAvailabilityZone() } /** - * [Output Only] Availability zone for this InterconnectLocation. Within a metropolitan area (metro), maintenance will not be simultaneously scheduled in more than one availability zone. Example: "zone1" or "zone2". + * [Output Only] Availability zone for this InterconnectLocation. Within a + * metropolitan area (metro), maintenance will not be simultaneously scheduled + * in more than one availability zone. Example: "zone1" or "zone2". * * Generated from protobuf field optional string availability_zone = 158459920; * @param string $var @@ -262,7 +347,10 @@ public function setAvailabilityZone($var) } /** - * [Output only] List of features available at this InterconnectLocation, which can take one of the following values: - IF_MACSEC + * [Output only] List of features available at this InterconnectLocation, + * which can take one of the following values: + * - IF_MACSEC + * - IF_CROSS_SITE_NETWORK * Check the AvailableFeatures enum for the list of possible values. * * Generated from protobuf field repeated string available_features = 496344307; @@ -274,7 +362,10 @@ public function getAvailableFeatures() } /** - * [Output only] List of features available at this InterconnectLocation, which can take one of the following values: - IF_MACSEC + * [Output only] List of features available at this InterconnectLocation, + * which can take one of the following values: + * - IF_MACSEC + * - IF_CROSS_SITE_NETWORK * Check the AvailableFeatures enum for the list of possible values. * * Generated from protobuf field repeated string available_features = 496344307; @@ -290,7 +381,11 @@ public function setAvailableFeatures($var) } /** - * [Output only] List of link types available at this InterconnectLocation, which can take one of the following values: - LINK_TYPE_ETHERNET_10G_LR - LINK_TYPE_ETHERNET_100G_LR - LINK_TYPE_ETHERNET_400G_LR4 + * [Output only] List of link types available at this InterconnectLocation, + * which can take one of the following values: + * - LINK_TYPE_ETHERNET_10G_LR + * - LINK_TYPE_ETHERNET_100G_LR + * - LINK_TYPE_ETHERNET_400G_LR4 * Check the AvailableLinkTypes enum for the list of possible values. * * Generated from protobuf field repeated string available_link_types = 509504298; @@ -302,7 +397,11 @@ public function getAvailableLinkTypes() } /** - * [Output only] List of link types available at this InterconnectLocation, which can take one of the following values: - LINK_TYPE_ETHERNET_10G_LR - LINK_TYPE_ETHERNET_100G_LR - LINK_TYPE_ETHERNET_400G_LR4 + * [Output only] List of link types available at this InterconnectLocation, + * which can take one of the following values: + * - LINK_TYPE_ETHERNET_10G_LR + * - LINK_TYPE_ETHERNET_100G_LR + * - LINK_TYPE_ETHERNET_400G_LR4 * Check the AvailableLinkTypes enum for the list of possible values. * * Generated from protobuf field repeated string available_link_types = 509504298; @@ -318,7 +417,9 @@ public function setAvailableLinkTypes($var) } /** - * [Output Only] Metropolitan area designator that indicates which city an interconnect is located. For example: "Chicago, IL", "Amsterdam, Netherlands". + * [Output Only] Metropolitan area designator that indicates which city an + * interconnect is located. + * For example: "Chicago, IL", "Amsterdam, Netherlands". * * Generated from protobuf field optional string city = 3053931; * @return string @@ -339,7 +440,9 @@ public function clearCity() } /** - * [Output Only] Metropolitan area designator that indicates which city an interconnect is located. For example: "Chicago, IL", "Amsterdam, Netherlands". + * [Output Only] Metropolitan area designator that indicates which city an + * interconnect is located. + * For example: "Chicago, IL", "Amsterdam, Netherlands". * * Generated from protobuf field optional string city = 3053931; * @param string $var @@ -354,7 +457,13 @@ public function setCity($var) } /** - * [Output Only] Continent for this location, which can take one of the following values: - AFRICA - ASIA_PAC - EUROPE - NORTH_AMERICA - SOUTH_AMERICA + * [Output Only] Continent for this location, which can take one of the + * following values: + * - AFRICA + * - ASIA_PAC + * - EUROPE + * - NORTH_AMERICA + * - SOUTH_AMERICA * Check the Continent enum for the list of possible values. * * Generated from protobuf field optional string continent = 133442996; @@ -376,7 +485,13 @@ public function clearContinent() } /** - * [Output Only] Continent for this location, which can take one of the following values: - AFRICA - ASIA_PAC - EUROPE - NORTH_AMERICA - SOUTH_AMERICA + * [Output Only] Continent for this location, which can take one of the + * following values: + * - AFRICA + * - ASIA_PAC + * - EUROPE + * - NORTH_AMERICA + * - SOUTH_AMERICA * Check the Continent enum for the list of possible values. * * Generated from protobuf field optional string continent = 133442996; @@ -392,7 +507,8 @@ public function setContinent($var) } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @return string @@ -413,7 +529,8 @@ public function clearCreationTimestamp() } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @param string $var @@ -427,6 +544,38 @@ public function setCreationTimestamp($var) return $this; } + /** + * [Output Only] A list of InterconnectLocation.CrossSiteInterconnectInfo + * objects, that describe where Cross-Site Interconnect wires may connect to + * from this location and associated connection parameters. Cross-Site + * Interconnect isn't allowed to locations which are not listed. + * + * Generated from protobuf field repeated .google.cloud.compute.v1.InterconnectLocationCrossSiteInterconnectInfo cross_site_interconnect_infos = 248573837; + * @return \Google\Protobuf\Internal\RepeatedField + */ + public function getCrossSiteInterconnectInfos() + { + return $this->cross_site_interconnect_infos; + } + + /** + * [Output Only] A list of InterconnectLocation.CrossSiteInterconnectInfo + * objects, that describe where Cross-Site Interconnect wires may connect to + * from this location and associated connection parameters. Cross-Site + * Interconnect isn't allowed to locations which are not listed. + * + * Generated from protobuf field repeated .google.cloud.compute.v1.InterconnectLocationCrossSiteInterconnectInfo cross_site_interconnect_infos = 248573837; + * @param array<\Google\Cloud\Compute\V1\InterconnectLocationCrossSiteInterconnectInfo>|\Google\Protobuf\Internal\RepeatedField $var + * @return $this + */ + public function setCrossSiteInterconnectInfos($var) + { + $arr = GPBUtil::checkRepeatedField($var, \Google\Protobuf\Internal\GPBType::MESSAGE, \Google\Cloud\Compute\V1\InterconnectLocationCrossSiteInterconnectInfo::class); + $this->cross_site_interconnect_infos = $arr; + + return $this; + } + /** * [Output Only] An optional description of the resource. * @@ -500,7 +649,8 @@ public function setFacilityProvider($var) } /** - * [Output Only] A provider-assigned Identifier for this facility (e.g., Ashburn-DC1). + * [Output Only] A provider-assigned Identifier for this facility (e.g., + * Ashburn-DC1). * * Generated from protobuf field optional string facility_provider_facility_id = 87269125; * @return string @@ -521,7 +671,8 @@ public function clearFacilityProviderFacilityId() } /** - * [Output Only] A provider-assigned Identifier for this facility (e.g., Ashburn-DC1). + * [Output Only] A provider-assigned Identifier for this facility (e.g., + * Ashburn-DC1). * * Generated from protobuf field optional string facility_provider_facility_id = 87269125; * @param string $var @@ -536,7 +687,8 @@ public function setFacilityProviderFacilityId($var) } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @return int|string @@ -557,7 +709,8 @@ public function clearId() } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @param int|string $var @@ -572,7 +725,7 @@ public function setId($var) } /** - * [Output Only] Type of the resource. Always compute#interconnectLocation for interconnect locations. + * [Output Only] Type of the resource. Alwayscompute#interconnectLocation for interconnect locations. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -593,7 +746,7 @@ public function clearKind() } /** - * [Output Only] Type of the resource. Always compute#interconnectLocation for interconnect locations. + * [Output Only] Type of the resource. Alwayscompute#interconnectLocation for interconnect locations. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -644,7 +797,8 @@ public function setName($var) } /** - * [Output Only] The peeringdb identifier for this facility (corresponding with a netfac type in peeringdb). + * [Output Only] The peeringdb identifier for this facility (corresponding + * with a netfac type in peeringdb). * * Generated from protobuf field optional string peeringdb_facility_id = 536567094; * @return string @@ -665,7 +819,8 @@ public function clearPeeringdbFacilityId() } /** - * [Output Only] The peeringdb identifier for this facility (corresponding with a netfac type in peeringdb). + * [Output Only] The peeringdb identifier for this facility (corresponding + * with a netfac type in peeringdb). * * Generated from protobuf field optional string peeringdb_facility_id = 536567094; * @param string $var @@ -680,7 +835,9 @@ public function setPeeringdbFacilityId($var) } /** - * [Output Only] A list of InterconnectLocation.RegionInfo objects, that describe parameters pertaining to the relation between this InterconnectLocation and various Google Cloud regions. + * [Output Only] A list of InterconnectLocation.RegionInfo objects, that + * describe parameters pertaining to the relation between this + * InterconnectLocation and various Google Cloud regions. * * Generated from protobuf field repeated .google.cloud.compute.v1.InterconnectLocationRegionInfo region_infos = 312194170; * @return \Google\Protobuf\Internal\RepeatedField @@ -691,7 +848,9 @@ public function getRegionInfos() } /** - * [Output Only] A list of InterconnectLocation.RegionInfo objects, that describe parameters pertaining to the relation between this InterconnectLocation and various Google Cloud regions. + * [Output Only] A list of InterconnectLocation.RegionInfo objects, that + * describe parameters pertaining to the relation between this + * InterconnectLocation and various Google Cloud regions. * * Generated from protobuf field repeated .google.cloud.compute.v1.InterconnectLocationRegionInfo region_infos = 312194170; * @param array<\Google\Cloud\Compute\V1\InterconnectLocationRegionInfo>|\Google\Protobuf\Internal\RepeatedField $var @@ -742,7 +901,9 @@ public function setSelfLink($var) } /** - * [Output Only] URLs of the other locations that can pair up with this location to support Single-Region 99.99% SLA. E.g. iad-zone1-1 and iad-zone2-5467 are Single-Region 99.99% peer locations of each other. + * [Output Only] URLs of the other locations that can pair up with this + * location to support Single-Region 99.99% SLA. E.g. iad-zone1-1 and + * iad-zone2-5467 are Single-Region 99.99% peer locations of each other. * * Generated from protobuf field repeated string single_region_production_critical_peer_locations = 439537103; * @return \Google\Protobuf\Internal\RepeatedField @@ -753,7 +914,9 @@ public function getSingleRegionProductionCriticalPeerLocations() } /** - * [Output Only] URLs of the other locations that can pair up with this location to support Single-Region 99.99% SLA. E.g. iad-zone1-1 and iad-zone2-5467 are Single-Region 99.99% peer locations of each other. + * [Output Only] URLs of the other locations that can pair up with this + * location to support Single-Region 99.99% SLA. E.g. iad-zone1-1 and + * iad-zone2-5467 are Single-Region 99.99% peer locations of each other. * * Generated from protobuf field repeated string single_region_production_critical_peer_locations = 439537103; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -768,7 +931,12 @@ public function setSingleRegionProductionCriticalPeerLocations($var) } /** - * [Output Only] The status of this InterconnectLocation, which can take one of the following values: - CLOSED: The InterconnectLocation is closed and is unavailable for provisioning new Interconnects. - AVAILABLE: The InterconnectLocation is available for provisioning new Interconnects. + * [Output Only] The status of this InterconnectLocation, which can take one + * of the following values: + * - CLOSED: The InterconnectLocation is closed and is unavailable for + * provisioning new Interconnects. + * - AVAILABLE: The InterconnectLocation is available for provisioning new + * Interconnects. * Check the Status enum for the list of possible values. * * Generated from protobuf field optional string status = 181260274; @@ -790,7 +958,12 @@ public function clearStatus() } /** - * [Output Only] The status of this InterconnectLocation, which can take one of the following values: - CLOSED: The InterconnectLocation is closed and is unavailable for provisioning new Interconnects. - AVAILABLE: The InterconnectLocation is available for provisioning new Interconnects. + * [Output Only] The status of this InterconnectLocation, which can take one + * of the following values: + * - CLOSED: The InterconnectLocation is closed and is unavailable for + * provisioning new Interconnects. + * - AVAILABLE: The InterconnectLocation is available for provisioning new + * Interconnects. * Check the Status enum for the list of possible values. * * Generated from protobuf field optional string status = 181260274; diff --git a/Compute/src/V1/InterconnectLocation/AvailableFeatures.php b/Compute/src/V1/InterconnectLocation/AvailableFeatures.php index 4633cff19105..b2902eceef4f 100644 --- a/Compute/src/V1/InterconnectLocation/AvailableFeatures.php +++ b/Compute/src/V1/InterconnectLocation/AvailableFeatures.php @@ -18,6 +18,18 @@ class AvailableFeatures * Generated from protobuf enum UNDEFINED_AVAILABLE_FEATURES = 0; */ const UNDEFINED_AVAILABLE_FEATURES = 0; + /** + * Cross-Site Networking + * + * Generated from protobuf enum IF_CROSS_SITE_NETWORK = 469111095; + */ + const IF_CROSS_SITE_NETWORK = 469111095; + /** + * L2 Interconnect Attachment Forwarding + * + * Generated from protobuf enum IF_L2_FORWARDING = 125563860; + */ + const IF_L2_FORWARDING = 125563860; /** * Media Access Control security (MACsec) * @@ -27,6 +39,8 @@ class AvailableFeatures private static $valueToName = [ self::UNDEFINED_AVAILABLE_FEATURES => 'UNDEFINED_AVAILABLE_FEATURES', + self::IF_CROSS_SITE_NETWORK => 'IF_CROSS_SITE_NETWORK', + self::IF_L2_FORWARDING => 'IF_L2_FORWARDING', self::IF_MACSEC => 'IF_MACSEC', ]; diff --git a/Compute/src/V1/InterconnectLocation/AvailableLinkTypes.php b/Compute/src/V1/InterconnectLocation/AvailableLinkTypes.php index 2f069626525e..abaf59ea955b 100644 --- a/Compute/src/V1/InterconnectLocation/AvailableLinkTypes.php +++ b/Compute/src/V1/InterconnectLocation/AvailableLinkTypes.php @@ -25,7 +25,8 @@ class AvailableLinkTypes */ const LINK_TYPE_ETHERNET_100G_LR = 337672551; /** - * 10G Ethernet, LR Optics. [(rate_bps) = 10000000000]; + * 10G Ethernet, LR Optics. + * [(rate_bps) = 10000000000]; * * Generated from protobuf enum LINK_TYPE_ETHERNET_10G_LR = 236739749; */ diff --git a/Compute/src/V1/InterconnectLocation/Continent.php b/Compute/src/V1/InterconnectLocation/Continent.php index 707972521d7e..a1eb75bac76e 100644 --- a/Compute/src/V1/InterconnectLocation/Continent.php +++ b/Compute/src/V1/InterconnectLocation/Continent.php @@ -7,7 +7,13 @@ use UnexpectedValueException; /** - * [Output Only] Continent for this location, which can take one of the following values: - AFRICA - ASIA_PAC - EUROPE - NORTH_AMERICA - SOUTH_AMERICA + * [Output Only] Continent for this location, which can take one of the + * following values: + * - AFRICA + * - ASIA_PAC + * - EUROPE + * - NORTH_AMERICA + * - SOUTH_AMERICA * * Protobuf type google.cloud.compute.v1.InterconnectLocation.Continent */ diff --git a/Compute/src/V1/InterconnectLocation/Status.php b/Compute/src/V1/InterconnectLocation/Status.php index 3cdb6050fdc6..614cfde4324f 100644 --- a/Compute/src/V1/InterconnectLocation/Status.php +++ b/Compute/src/V1/InterconnectLocation/Status.php @@ -7,7 +7,12 @@ use UnexpectedValueException; /** - * [Output Only] The status of this InterconnectLocation, which can take one of the following values: - CLOSED: The InterconnectLocation is closed and is unavailable for provisioning new Interconnects. - AVAILABLE: The InterconnectLocation is available for provisioning new Interconnects. + * [Output Only] The status of this InterconnectLocation, which can take one + * of the following values: + * - CLOSED: The InterconnectLocation is closed and is unavailable for + * provisioning new Interconnects. + * - AVAILABLE: The InterconnectLocation is available for provisioning new + * Interconnects. * * Protobuf type google.cloud.compute.v1.InterconnectLocation.Status */ diff --git a/Compute/src/V1/InterconnectLocationCrossSiteInterconnectInfo.php b/Compute/src/V1/InterconnectLocationCrossSiteInterconnectInfo.php new file mode 100644 index 000000000000..96128bc06be9 --- /dev/null +++ b/Compute/src/V1/InterconnectLocationCrossSiteInterconnectInfo.php @@ -0,0 +1,86 @@ +google.cloud.compute.v1.InterconnectLocationCrossSiteInterconnectInfo + */ +class InterconnectLocationCrossSiteInterconnectInfo extends \Google\Protobuf\Internal\Message +{ + /** + * The remote location for Cross-Site Interconnect wires. This specifies an + * InterconnectLocation city (metropolitan area designator), which itself + * may match multiple InterconnectLocations. + * + * Generated from protobuf field optional string city = 3053931; + */ + protected $city = null; + + /** + * Constructor. + * + * @param array $data { + * Optional. Data for populating the Message object. + * + * @type string $city + * The remote location for Cross-Site Interconnect wires. This specifies an + * InterconnectLocation city (metropolitan area designator), which itself + * may match multiple InterconnectLocations. + * } + */ + public function __construct($data = NULL) { + \GPBMetadata\Google\Cloud\Compute\V1\Compute::initOnce(); + parent::__construct($data); + } + + /** + * The remote location for Cross-Site Interconnect wires. This specifies an + * InterconnectLocation city (metropolitan area designator), which itself + * may match multiple InterconnectLocations. + * + * Generated from protobuf field optional string city = 3053931; + * @return string + */ + public function getCity() + { + return isset($this->city) ? $this->city : ''; + } + + public function hasCity() + { + return isset($this->city); + } + + public function clearCity() + { + unset($this->city); + } + + /** + * The remote location for Cross-Site Interconnect wires. This specifies an + * InterconnectLocation city (metropolitan area designator), which itself + * may match multiple InterconnectLocations. + * + * Generated from protobuf field optional string city = 3053931; + * @param string $var + * @return $this + */ + public function setCity($var) + { + GPBUtil::checkString($var, True); + $this->city = $var; + + return $this; + } + +} + diff --git a/Compute/src/V1/InterconnectLocationList.php b/Compute/src/V1/InterconnectLocationList.php index d5c5543a0f81..7e064dd4a3b7 100644 --- a/Compute/src/V1/InterconnectLocationList.php +++ b/Compute/src/V1/InterconnectLocationList.php @@ -28,13 +28,18 @@ class InterconnectLocationList extends \Google\Protobuf\Internal\Message */ private $items; /** - * [Output Only] Type of resource. Always compute#interconnectLocationList for lists of interconnect locations. + * [Output Only] Type of resource. Alwayscompute#interconnectLocationList for lists of interconnect + * locations. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -63,9 +68,14 @@ class InterconnectLocationList extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\InterconnectLocation>|\Google\Protobuf\Internal\RepeatedField $items * A list of InterconnectLocation resources. * @type string $kind - * [Output Only] Type of resource. Always compute#interconnectLocationList for lists of interconnect locations. + * [Output Only] Type of resource. Alwayscompute#interconnectLocationList for lists of interconnect + * locations. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type \Google\Cloud\Compute\V1\Warning $warning @@ -140,7 +150,8 @@ public function setItems($var) } /** - * [Output Only] Type of resource. Always compute#interconnectLocationList for lists of interconnect locations. + * [Output Only] Type of resource. Alwayscompute#interconnectLocationList for lists of interconnect + * locations. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -161,7 +172,8 @@ public function clearKind() } /** - * [Output Only] Type of resource. Always compute#interconnectLocationList for lists of interconnect locations. + * [Output Only] Type of resource. Alwayscompute#interconnectLocationList for lists of interconnect + * locations. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -176,7 +188,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -197,7 +213,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/InterconnectLocationRegionInfo.php b/Compute/src/V1/InterconnectLocationRegionInfo.php index ce9bc70d6661..27539ae5e433 100644 --- a/Compute/src/V1/InterconnectLocationRegionInfo.php +++ b/Compute/src/V1/InterconnectLocationRegionInfo.php @@ -9,18 +9,28 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Information about any potential InterconnectAttachments between an Interconnect at a specific InterconnectLocation, and a specific Cloud Region. + * Information about any potential InterconnectAttachments between an + * Interconnect at a specific InterconnectLocation, and a specific Cloud + * Region. * * Generated from protobuf message google.cloud.compute.v1.InterconnectLocationRegionInfo */ class InterconnectLocationRegionInfo extends \Google\Protobuf\Internal\Message { /** - * Expected round-trip time in milliseconds, from this InterconnectLocation to a VM in this region. + * Expected round-trip time in milliseconds, from this InterconnectLocation + * to a VM in this region. * * Generated from protobuf field optional int64 expected_rtt_ms = 422543866; */ protected $expected_rtt_ms = null; + /** + * Identifies whether L2 Interconnect Attachments can be created in this + * region for interconnects that are in this location. + * + * Generated from protobuf field optional bool l2_forwarding_enabled = 241364888; + */ + protected $l2_forwarding_enabled = null; /** * Identifies the network presence of this location. * Check the LocationPresence enum for the list of possible values. @@ -42,7 +52,11 @@ class InterconnectLocationRegionInfo extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type int|string $expected_rtt_ms - * Expected round-trip time in milliseconds, from this InterconnectLocation to a VM in this region. + * Expected round-trip time in milliseconds, from this InterconnectLocation + * to a VM in this region. + * @type bool $l2_forwarding_enabled + * Identifies whether L2 Interconnect Attachments can be created in this + * region for interconnects that are in this location. * @type string $location_presence * Identifies the network presence of this location. * Check the LocationPresence enum for the list of possible values. @@ -56,7 +70,8 @@ public function __construct($data = NULL) { } /** - * Expected round-trip time in milliseconds, from this InterconnectLocation to a VM in this region. + * Expected round-trip time in milliseconds, from this InterconnectLocation + * to a VM in this region. * * Generated from protobuf field optional int64 expected_rtt_ms = 422543866; * @return int|string @@ -77,7 +92,8 @@ public function clearExpectedRttMs() } /** - * Expected round-trip time in milliseconds, from this InterconnectLocation to a VM in this region. + * Expected round-trip time in milliseconds, from this InterconnectLocation + * to a VM in this region. * * Generated from protobuf field optional int64 expected_rtt_ms = 422543866; * @param int|string $var @@ -91,6 +107,44 @@ public function setExpectedRttMs($var) return $this; } + /** + * Identifies whether L2 Interconnect Attachments can be created in this + * region for interconnects that are in this location. + * + * Generated from protobuf field optional bool l2_forwarding_enabled = 241364888; + * @return bool + */ + public function getL2ForwardingEnabled() + { + return isset($this->l2_forwarding_enabled) ? $this->l2_forwarding_enabled : false; + } + + public function hasL2ForwardingEnabled() + { + return isset($this->l2_forwarding_enabled); + } + + public function clearL2ForwardingEnabled() + { + unset($this->l2_forwarding_enabled); + } + + /** + * Identifies whether L2 Interconnect Attachments can be created in this + * region for interconnects that are in this location. + * + * Generated from protobuf field optional bool l2_forwarding_enabled = 241364888; + * @param bool $var + * @return $this + */ + public function setL2ForwardingEnabled($var) + { + GPBUtil::checkBool($var); + $this->l2_forwarding_enabled = $var; + + return $this; + } + /** * Identifies the network presence of this location. * Check the LocationPresence enum for the list of possible values. diff --git a/Compute/src/V1/InterconnectLocationRegionInfo/LocationPresence.php b/Compute/src/V1/InterconnectLocationRegionInfo/LocationPresence.php index 3f102965888b..a6a78ae0fade 100644 --- a/Compute/src/V1/InterconnectLocationRegionInfo/LocationPresence.php +++ b/Compute/src/V1/InterconnectLocationRegionInfo/LocationPresence.php @@ -20,25 +20,29 @@ class LocationPresence */ const UNDEFINED_LOCATION_PRESENCE = 0; /** - * This region is not in any common network presence with this InterconnectLocation. + * This region is not in any common network presence with this + * InterconnectLocation. * * Generated from protobuf enum GLOBAL = 494663587; */ const PBGLOBAL = 494663587; /** - * This region shares the same regional network presence as this InterconnectLocation. + * This region shares the same regional network presence as this + * InterconnectLocation. * * Generated from protobuf enum LOCAL_REGION = 403535464; */ const LOCAL_REGION = 403535464; /** - * [Deprecated] This region is not in any common network presence with this InterconnectLocation. + * [Deprecated] This region is not in any common network presence with + * this InterconnectLocation. * * Generated from protobuf enum LP_GLOBAL = 429584062; */ const LP_GLOBAL = 429584062; /** - * [Deprecated] This region shares the same regional network presence as this InterconnectLocation. + * [Deprecated] This region shares the same regional network presence as + * this InterconnectLocation. * * Generated from protobuf enum LP_LOCAL_REGION = 488598851; */ diff --git a/Compute/src/V1/InterconnectMacsec.php b/Compute/src/V1/InterconnectMacsec.php index f05a3f88df37..149702514f85 100644 --- a/Compute/src/V1/InterconnectMacsec.php +++ b/Compute/src/V1/InterconnectMacsec.php @@ -9,20 +9,29 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Configuration information for enabling Media Access Control security (MACsec) on this Cloud Interconnect connection between Google and your on-premises router. + * Configuration information for enabling Media Access Control security + * (MACsec) on this Cloud Interconnect connection between Google and your + * on-premises router. * * Generated from protobuf message google.cloud.compute.v1.InterconnectMacsec */ class InterconnectMacsec extends \Google\Protobuf\Internal\Message { /** - * If set to true, the Interconnect connection is configured with a should-secure MACsec security policy, that allows the Google router to fallback to cleartext traffic if the MKA session cannot be established. By default, the Interconnect connection is configured with a must-secure security policy that drops all traffic if the MKA session cannot be established with your router. + * If set to true, the Interconnect connection is configured with ashould-secure MACsec security policy, that allows the Google + * router to fallback to cleartext traffic if the MKA session cannot be + * established. By default, the Interconnect connection is configured with amust-secure security policy that drops all traffic if the + * MKA session cannot be established with your router. * * Generated from protobuf field optional bool fail_open = 532597451; */ protected $fail_open = null; /** - * Required. A keychain placeholder describing a set of named key objects along with their start times. A MACsec CKN/CAK is generated for each key in the key chain. Google router automatically picks the key with the most recent startTime when establishing or re-establishing a MACsec secure link. + * Required. A keychain placeholder describing a set of named key objects + * along with their start times. A MACsec CKN/CAK is generated for each + * key in the key chain. Google router automatically picks the key with + * the most recent startTime when establishing or re-establishing a MACsec + * secure link. * * Generated from protobuf field repeated .google.cloud.compute.v1.InterconnectMacsecPreSharedKey pre_shared_keys = 420308466; */ @@ -35,9 +44,16 @@ class InterconnectMacsec extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type bool $fail_open - * If set to true, the Interconnect connection is configured with a should-secure MACsec security policy, that allows the Google router to fallback to cleartext traffic if the MKA session cannot be established. By default, the Interconnect connection is configured with a must-secure security policy that drops all traffic if the MKA session cannot be established with your router. + * If set to true, the Interconnect connection is configured with ashould-secure MACsec security policy, that allows the Google + * router to fallback to cleartext traffic if the MKA session cannot be + * established. By default, the Interconnect connection is configured with amust-secure security policy that drops all traffic if the + * MKA session cannot be established with your router. * @type array<\Google\Cloud\Compute\V1\InterconnectMacsecPreSharedKey>|\Google\Protobuf\Internal\RepeatedField $pre_shared_keys - * Required. A keychain placeholder describing a set of named key objects along with their start times. A MACsec CKN/CAK is generated for each key in the key chain. Google router automatically picks the key with the most recent startTime when establishing or re-establishing a MACsec secure link. + * Required. A keychain placeholder describing a set of named key objects + * along with their start times. A MACsec CKN/CAK is generated for each + * key in the key chain. Google router automatically picks the key with + * the most recent startTime when establishing or re-establishing a MACsec + * secure link. * } */ public function __construct($data = NULL) { @@ -46,7 +62,10 @@ public function __construct($data = NULL) { } /** - * If set to true, the Interconnect connection is configured with a should-secure MACsec security policy, that allows the Google router to fallback to cleartext traffic if the MKA session cannot be established. By default, the Interconnect connection is configured with a must-secure security policy that drops all traffic if the MKA session cannot be established with your router. + * If set to true, the Interconnect connection is configured with ashould-secure MACsec security policy, that allows the Google + * router to fallback to cleartext traffic if the MKA session cannot be + * established. By default, the Interconnect connection is configured with amust-secure security policy that drops all traffic if the + * MKA session cannot be established with your router. * * Generated from protobuf field optional bool fail_open = 532597451; * @return bool @@ -67,7 +86,10 @@ public function clearFailOpen() } /** - * If set to true, the Interconnect connection is configured with a should-secure MACsec security policy, that allows the Google router to fallback to cleartext traffic if the MKA session cannot be established. By default, the Interconnect connection is configured with a must-secure security policy that drops all traffic if the MKA session cannot be established with your router. + * If set to true, the Interconnect connection is configured with ashould-secure MACsec security policy, that allows the Google + * router to fallback to cleartext traffic if the MKA session cannot be + * established. By default, the Interconnect connection is configured with amust-secure security policy that drops all traffic if the + * MKA session cannot be established with your router. * * Generated from protobuf field optional bool fail_open = 532597451; * @param bool $var @@ -82,7 +104,11 @@ public function setFailOpen($var) } /** - * Required. A keychain placeholder describing a set of named key objects along with their start times. A MACsec CKN/CAK is generated for each key in the key chain. Google router automatically picks the key with the most recent startTime when establishing or re-establishing a MACsec secure link. + * Required. A keychain placeholder describing a set of named key objects + * along with their start times. A MACsec CKN/CAK is generated for each + * key in the key chain. Google router automatically picks the key with + * the most recent startTime when establishing or re-establishing a MACsec + * secure link. * * Generated from protobuf field repeated .google.cloud.compute.v1.InterconnectMacsecPreSharedKey pre_shared_keys = 420308466; * @return \Google\Protobuf\Internal\RepeatedField @@ -93,7 +119,11 @@ public function getPreSharedKeys() } /** - * Required. A keychain placeholder describing a set of named key objects along with their start times. A MACsec CKN/CAK is generated for each key in the key chain. Google router automatically picks the key with the most recent startTime when establishing or re-establishing a MACsec secure link. + * Required. A keychain placeholder describing a set of named key objects + * along with their start times. A MACsec CKN/CAK is generated for each + * key in the key chain. Google router automatically picks the key with + * the most recent startTime when establishing or re-establishing a MACsec + * secure link. * * Generated from protobuf field repeated .google.cloud.compute.v1.InterconnectMacsecPreSharedKey pre_shared_keys = 420308466; * @param array<\Google\Cloud\Compute\V1\InterconnectMacsecPreSharedKey>|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/InterconnectMacsecConfig.php b/Compute/src/V1/InterconnectMacsecConfig.php index 082eac26086f..888bf93aef0f 100644 --- a/Compute/src/V1/InterconnectMacsecConfig.php +++ b/Compute/src/V1/InterconnectMacsecConfig.php @@ -9,14 +9,19 @@ use Google\Protobuf\Internal\GPBUtil; /** - * MACsec configuration information for the Interconnect connection. Contains the generated Connectivity Association Key Name (CKN) and the key (CAK) for this Interconnect connection. + * MACsec configuration information for the Interconnect connection. Contains + * the generated Connectivity Association Key Name (CKN) and the key (CAK) for + * this Interconnect connection. * * Generated from protobuf message google.cloud.compute.v1.InterconnectMacsecConfig */ class InterconnectMacsecConfig extends \Google\Protobuf\Internal\Message { /** - * A keychain placeholder describing a set of named key objects along with their start times. A MACsec CKN/CAK is generated for each key in the key chain. Google router automatically picks the key with the most recent startTime when establishing or re-establishing a MACsec secure link. + * A keychain placeholder describing a set of named key objects + * along with their start times. A MACsec CKN/CAK is generated for each key in + * the key chain. Google router automatically picks the key with the most + * recent startTime when establishing or re-establishing a MACsec secure link. * * Generated from protobuf field repeated .google.cloud.compute.v1.InterconnectMacsecConfigPreSharedKey pre_shared_keys = 420308466; */ @@ -29,7 +34,10 @@ class InterconnectMacsecConfig extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type array<\Google\Cloud\Compute\V1\InterconnectMacsecConfigPreSharedKey>|\Google\Protobuf\Internal\RepeatedField $pre_shared_keys - * A keychain placeholder describing a set of named key objects along with their start times. A MACsec CKN/CAK is generated for each key in the key chain. Google router automatically picks the key with the most recent startTime when establishing or re-establishing a MACsec secure link. + * A keychain placeholder describing a set of named key objects + * along with their start times. A MACsec CKN/CAK is generated for each key in + * the key chain. Google router automatically picks the key with the most + * recent startTime when establishing or re-establishing a MACsec secure link. * } */ public function __construct($data = NULL) { @@ -38,7 +46,10 @@ public function __construct($data = NULL) { } /** - * A keychain placeholder describing a set of named key objects along with their start times. A MACsec CKN/CAK is generated for each key in the key chain. Google router automatically picks the key with the most recent startTime when establishing or re-establishing a MACsec secure link. + * A keychain placeholder describing a set of named key objects + * along with their start times. A MACsec CKN/CAK is generated for each key in + * the key chain. Google router automatically picks the key with the most + * recent startTime when establishing or re-establishing a MACsec secure link. * * Generated from protobuf field repeated .google.cloud.compute.v1.InterconnectMacsecConfigPreSharedKey pre_shared_keys = 420308466; * @return \Google\Protobuf\Internal\RepeatedField @@ -49,7 +60,10 @@ public function getPreSharedKeys() } /** - * A keychain placeholder describing a set of named key objects along with their start times. A MACsec CKN/CAK is generated for each key in the key chain. Google router automatically picks the key with the most recent startTime when establishing or re-establishing a MACsec secure link. + * A keychain placeholder describing a set of named key objects + * along with their start times. A MACsec CKN/CAK is generated for each key in + * the key chain. Google router automatically picks the key with the most + * recent startTime when establishing or re-establishing a MACsec secure link. * * Generated from protobuf field repeated .google.cloud.compute.v1.InterconnectMacsecConfigPreSharedKey pre_shared_keys = 420308466; * @param array<\Google\Cloud\Compute\V1\InterconnectMacsecConfigPreSharedKey>|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/InterconnectMacsecConfigPreSharedKey.php b/Compute/src/V1/InterconnectMacsecConfigPreSharedKey.php index fe1ef37ab2b9..cf74e8f3593a 100644 --- a/Compute/src/V1/InterconnectMacsecConfigPreSharedKey.php +++ b/Compute/src/V1/InterconnectMacsecConfigPreSharedKey.php @@ -9,7 +9,8 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Describes a pre-shared key used to setup MACsec in static connectivity association key (CAK) mode. + * Describes a pre-shared key used to setup MACsec in static connectivity + * association key (CAK) mode. * * Generated from protobuf message google.cloud.compute.v1.InterconnectMacsecConfigPreSharedKey */ diff --git a/Compute/src/V1/InterconnectMacsecPreSharedKey.php b/Compute/src/V1/InterconnectMacsecPreSharedKey.php index 9f68258b29ab..faaa49cba4c7 100644 --- a/Compute/src/V1/InterconnectMacsecPreSharedKey.php +++ b/Compute/src/V1/InterconnectMacsecPreSharedKey.php @@ -9,20 +9,32 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Describes a pre-shared key used to setup MACsec in static connectivity association key (CAK) mode. + * Describes a pre-shared key used to setup MACsec in static connectivity + * association key (CAK) mode. * * Generated from protobuf message google.cloud.compute.v1.InterconnectMacsecPreSharedKey */ class InterconnectMacsecPreSharedKey extends \Google\Protobuf\Internal\Message { /** - * Required. A name for this pre-shared key. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Required. A name for this pre-shared key. + * The name must be 1-63 characters long, and comply withRFC1035. Specifically, the name must be 1-63 + * characters long and match the regular expression + * `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a + * lowercase letter, and all following characters must be a dash, + * lowercase letter, or digit, except the last character, which cannot be + * a dash. * * Generated from protobuf field optional string name = 3373707; */ protected $name = null; /** - * A RFC3339 timestamp on or after which the key is valid. startTime can be in the future. If the keychain has a single key, startTime can be omitted. If the keychain has multiple keys, startTime is mandatory for each key. The start times of keys must be in increasing order. The start times of two consecutive keys must be at least 6 hours apart. + * A RFC3339 timestamp on or after which the key is + * valid. startTime can be in the future. If the keychain has a single + * key, startTime can be omitted. If the keychain has multiple keys, + * startTime is mandatory for each key. The start times of keys must be in + * increasing order. The start times of two consecutive keys must be + * at least 6 hours apart. * * Generated from protobuf field optional string start_time = 37467274; */ @@ -35,9 +47,20 @@ class InterconnectMacsecPreSharedKey extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $name - * Required. A name for this pre-shared key. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Required. A name for this pre-shared key. + * The name must be 1-63 characters long, and comply withRFC1035. Specifically, the name must be 1-63 + * characters long and match the regular expression + * `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a + * lowercase letter, and all following characters must be a dash, + * lowercase letter, or digit, except the last character, which cannot be + * a dash. * @type string $start_time - * A RFC3339 timestamp on or after which the key is valid. startTime can be in the future. If the keychain has a single key, startTime can be omitted. If the keychain has multiple keys, startTime is mandatory for each key. The start times of keys must be in increasing order. The start times of two consecutive keys must be at least 6 hours apart. + * A RFC3339 timestamp on or after which the key is + * valid. startTime can be in the future. If the keychain has a single + * key, startTime can be omitted. If the keychain has multiple keys, + * startTime is mandatory for each key. The start times of keys must be in + * increasing order. The start times of two consecutive keys must be + * at least 6 hours apart. * } */ public function __construct($data = NULL) { @@ -46,7 +69,13 @@ public function __construct($data = NULL) { } /** - * Required. A name for this pre-shared key. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Required. A name for this pre-shared key. + * The name must be 1-63 characters long, and comply withRFC1035. Specifically, the name must be 1-63 + * characters long and match the regular expression + * `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a + * lowercase letter, and all following characters must be a dash, + * lowercase letter, or digit, except the last character, which cannot be + * a dash. * * Generated from protobuf field optional string name = 3373707; * @return string @@ -67,7 +96,13 @@ public function clearName() } /** - * Required. A name for this pre-shared key. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Required. A name for this pre-shared key. + * The name must be 1-63 characters long, and comply withRFC1035. Specifically, the name must be 1-63 + * characters long and match the regular expression + * `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a + * lowercase letter, and all following characters must be a dash, + * lowercase letter, or digit, except the last character, which cannot be + * a dash. * * Generated from protobuf field optional string name = 3373707; * @param string $var @@ -82,7 +117,12 @@ public function setName($var) } /** - * A RFC3339 timestamp on or after which the key is valid. startTime can be in the future. If the keychain has a single key, startTime can be omitted. If the keychain has multiple keys, startTime is mandatory for each key. The start times of keys must be in increasing order. The start times of two consecutive keys must be at least 6 hours apart. + * A RFC3339 timestamp on or after which the key is + * valid. startTime can be in the future. If the keychain has a single + * key, startTime can be omitted. If the keychain has multiple keys, + * startTime is mandatory for each key. The start times of keys must be in + * increasing order. The start times of two consecutive keys must be + * at least 6 hours apart. * * Generated from protobuf field optional string start_time = 37467274; * @return string @@ -103,7 +143,12 @@ public function clearStartTime() } /** - * A RFC3339 timestamp on or after which the key is valid. startTime can be in the future. If the keychain has a single key, startTime can be omitted. If the keychain has multiple keys, startTime is mandatory for each key. The start times of keys must be in increasing order. The start times of two consecutive keys must be at least 6 hours apart. + * A RFC3339 timestamp on or after which the key is + * valid. startTime can be in the future. If the keychain has a single + * key, startTime can be omitted. If the keychain has multiple keys, + * startTime is mandatory for each key. The start times of keys must be in + * increasing order. The start times of two consecutive keys must be + * at least 6 hours apart. * * Generated from protobuf field optional string start_time = 37467274; * @param string $var diff --git a/Compute/src/V1/InterconnectOutageNotification.php b/Compute/src/V1/InterconnectOutageNotification.php index 74617f327513..9685423045f2 100644 --- a/Compute/src/V1/InterconnectOutageNotification.php +++ b/Compute/src/V1/InterconnectOutageNotification.php @@ -16,7 +16,8 @@ class InterconnectOutageNotification extends \Google\Protobuf\Internal\Message { /** - * If issue_type is IT_PARTIAL_OUTAGE, a list of the Google-side circuit IDs that will be affected. + * If issue_type is IT_PARTIAL_OUTAGE, a list of the Google-side circuit + * IDs that will be affected. * * Generated from protobuf field repeated string affected_circuits = 177717013; */ @@ -28,13 +29,21 @@ class InterconnectOutageNotification extends \Google\Protobuf\Internal\Message */ protected $description = null; /** - * Scheduled end time for the outage (milliseconds since Unix epoch). + * Scheduled end time for the outage (milliseconds since Unix + * epoch). * * Generated from protobuf field optional int64 end_time = 114938801; */ protected $end_time = null; /** - * Form this outage is expected to take, which can take one of the following values: - OUTAGE: The Interconnect may be completely out of service for some or all of the specified window. - PARTIAL_OUTAGE: Some circuits comprising the Interconnect as a whole should remain up, but with reduced bandwidth. Note that the versions of this enum prefixed with "IT_" have been deprecated in favor of the unprefixed values. + * Form this outage is expected to take, which can take one of the following + * values: + * - OUTAGE: The Interconnect may be completely out of service for + * some or all of the specified window. + * - PARTIAL_OUTAGE: Some circuits comprising the Interconnect as a whole + * should remain up, but with reduced bandwidth. + * Note that the versions of this enum prefixed with "IT_" have been + * deprecated in favor of the unprefixed values. * Check the IssueType enum for the list of possible values. * * Generated from protobuf field optional string issue_type = 369639136; @@ -47,20 +56,33 @@ class InterconnectOutageNotification extends \Google\Protobuf\Internal\Message */ protected $name = null; /** - * The party that generated this notification, which can take the following value: - GOOGLE: this notification as generated by Google. Note that the value of NSRC_GOOGLE has been deprecated in favor of GOOGLE. + * The party that generated this notification, which can take the following + * value: + * - GOOGLE: this notification as generated by Google. + * Note that the value of NSRC_GOOGLE has been deprecated in favor of + * GOOGLE. * Check the Source enum for the list of possible values. * * Generated from protobuf field optional string source = 177235995; */ protected $source = null; /** - * Scheduled start time for the outage (milliseconds since Unix epoch). + * Scheduled start time for the outage (milliseconds since Unix + * epoch). * * Generated from protobuf field optional int64 start_time = 37467274; */ protected $start_time = null; /** - * State of this notification, which can take one of the following values: - ACTIVE: This outage notification is active. The event could be in the past, present, or future. See start_time and end_time for scheduling. - CANCELLED: The outage associated with this notification was cancelled before the outage was due to start. - COMPLETED: The outage associated with this notification is complete. Note that the versions of this enum prefixed with "NS_" have been deprecated in favor of the unprefixed values. + * State of this notification, which can take one of the following values: + * - ACTIVE: This outage notification is active. The event could be in + * the past, present, or future. See start_time and end_time for + * scheduling. + * - CANCELLED: The outage associated with this notification was cancelled + * before the outage was due to start. + * - COMPLETED: The outage associated with this notification is complete. + * Note that the versions of this enum prefixed with "NS_" have been + * deprecated in favor of the unprefixed values. * Check the State enum for the list of possible values. * * Generated from protobuf field optional string state = 109757585; @@ -74,23 +96,45 @@ class InterconnectOutageNotification extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type array|\Google\Protobuf\Internal\RepeatedField $affected_circuits - * If issue_type is IT_PARTIAL_OUTAGE, a list of the Google-side circuit IDs that will be affected. + * If issue_type is IT_PARTIAL_OUTAGE, a list of the Google-side circuit + * IDs that will be affected. * @type string $description * A description about the purpose of the outage. * @type int|string $end_time - * Scheduled end time for the outage (milliseconds since Unix epoch). + * Scheduled end time for the outage (milliseconds since Unix + * epoch). * @type string $issue_type - * Form this outage is expected to take, which can take one of the following values: - OUTAGE: The Interconnect may be completely out of service for some or all of the specified window. - PARTIAL_OUTAGE: Some circuits comprising the Interconnect as a whole should remain up, but with reduced bandwidth. Note that the versions of this enum prefixed with "IT_" have been deprecated in favor of the unprefixed values. + * Form this outage is expected to take, which can take one of the following + * values: + * - OUTAGE: The Interconnect may be completely out of service for + * some or all of the specified window. + * - PARTIAL_OUTAGE: Some circuits comprising the Interconnect as a whole + * should remain up, but with reduced bandwidth. + * Note that the versions of this enum prefixed with "IT_" have been + * deprecated in favor of the unprefixed values. * Check the IssueType enum for the list of possible values. * @type string $name * Unique identifier for this outage notification. * @type string $source - * The party that generated this notification, which can take the following value: - GOOGLE: this notification as generated by Google. Note that the value of NSRC_GOOGLE has been deprecated in favor of GOOGLE. + * The party that generated this notification, which can take the following + * value: + * - GOOGLE: this notification as generated by Google. + * Note that the value of NSRC_GOOGLE has been deprecated in favor of + * GOOGLE. * Check the Source enum for the list of possible values. * @type int|string $start_time - * Scheduled start time for the outage (milliseconds since Unix epoch). + * Scheduled start time for the outage (milliseconds since Unix + * epoch). * @type string $state - * State of this notification, which can take one of the following values: - ACTIVE: This outage notification is active. The event could be in the past, present, or future. See start_time and end_time for scheduling. - CANCELLED: The outage associated with this notification was cancelled before the outage was due to start. - COMPLETED: The outage associated with this notification is complete. Note that the versions of this enum prefixed with "NS_" have been deprecated in favor of the unprefixed values. + * State of this notification, which can take one of the following values: + * - ACTIVE: This outage notification is active. The event could be in + * the past, present, or future. See start_time and end_time for + * scheduling. + * - CANCELLED: The outage associated with this notification was cancelled + * before the outage was due to start. + * - COMPLETED: The outage associated with this notification is complete. + * Note that the versions of this enum prefixed with "NS_" have been + * deprecated in favor of the unprefixed values. * Check the State enum for the list of possible values. * } */ @@ -100,7 +144,8 @@ public function __construct($data = NULL) { } /** - * If issue_type is IT_PARTIAL_OUTAGE, a list of the Google-side circuit IDs that will be affected. + * If issue_type is IT_PARTIAL_OUTAGE, a list of the Google-side circuit + * IDs that will be affected. * * Generated from protobuf field repeated string affected_circuits = 177717013; * @return \Google\Protobuf\Internal\RepeatedField @@ -111,7 +156,8 @@ public function getAffectedCircuits() } /** - * If issue_type is IT_PARTIAL_OUTAGE, a list of the Google-side circuit IDs that will be affected. + * If issue_type is IT_PARTIAL_OUTAGE, a list of the Google-side circuit + * IDs that will be affected. * * Generated from protobuf field repeated string affected_circuits = 177717013; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -162,7 +208,8 @@ public function setDescription($var) } /** - * Scheduled end time for the outage (milliseconds since Unix epoch). + * Scheduled end time for the outage (milliseconds since Unix + * epoch). * * Generated from protobuf field optional int64 end_time = 114938801; * @return int|string @@ -183,7 +230,8 @@ public function clearEndTime() } /** - * Scheduled end time for the outage (milliseconds since Unix epoch). + * Scheduled end time for the outage (milliseconds since Unix + * epoch). * * Generated from protobuf field optional int64 end_time = 114938801; * @param int|string $var @@ -198,7 +246,14 @@ public function setEndTime($var) } /** - * Form this outage is expected to take, which can take one of the following values: - OUTAGE: The Interconnect may be completely out of service for some or all of the specified window. - PARTIAL_OUTAGE: Some circuits comprising the Interconnect as a whole should remain up, but with reduced bandwidth. Note that the versions of this enum prefixed with "IT_" have been deprecated in favor of the unprefixed values. + * Form this outage is expected to take, which can take one of the following + * values: + * - OUTAGE: The Interconnect may be completely out of service for + * some or all of the specified window. + * - PARTIAL_OUTAGE: Some circuits comprising the Interconnect as a whole + * should remain up, but with reduced bandwidth. + * Note that the versions of this enum prefixed with "IT_" have been + * deprecated in favor of the unprefixed values. * Check the IssueType enum for the list of possible values. * * Generated from protobuf field optional string issue_type = 369639136; @@ -220,7 +275,14 @@ public function clearIssueType() } /** - * Form this outage is expected to take, which can take one of the following values: - OUTAGE: The Interconnect may be completely out of service for some or all of the specified window. - PARTIAL_OUTAGE: Some circuits comprising the Interconnect as a whole should remain up, but with reduced bandwidth. Note that the versions of this enum prefixed with "IT_" have been deprecated in favor of the unprefixed values. + * Form this outage is expected to take, which can take one of the following + * values: + * - OUTAGE: The Interconnect may be completely out of service for + * some or all of the specified window. + * - PARTIAL_OUTAGE: Some circuits comprising the Interconnect as a whole + * should remain up, but with reduced bandwidth. + * Note that the versions of this enum prefixed with "IT_" have been + * deprecated in favor of the unprefixed values. * Check the IssueType enum for the list of possible values. * * Generated from protobuf field optional string issue_type = 369639136; @@ -272,7 +334,11 @@ public function setName($var) } /** - * The party that generated this notification, which can take the following value: - GOOGLE: this notification as generated by Google. Note that the value of NSRC_GOOGLE has been deprecated in favor of GOOGLE. + * The party that generated this notification, which can take the following + * value: + * - GOOGLE: this notification as generated by Google. + * Note that the value of NSRC_GOOGLE has been deprecated in favor of + * GOOGLE. * Check the Source enum for the list of possible values. * * Generated from protobuf field optional string source = 177235995; @@ -294,7 +360,11 @@ public function clearSource() } /** - * The party that generated this notification, which can take the following value: - GOOGLE: this notification as generated by Google. Note that the value of NSRC_GOOGLE has been deprecated in favor of GOOGLE. + * The party that generated this notification, which can take the following + * value: + * - GOOGLE: this notification as generated by Google. + * Note that the value of NSRC_GOOGLE has been deprecated in favor of + * GOOGLE. * Check the Source enum for the list of possible values. * * Generated from protobuf field optional string source = 177235995; @@ -310,7 +380,8 @@ public function setSource($var) } /** - * Scheduled start time for the outage (milliseconds since Unix epoch). + * Scheduled start time for the outage (milliseconds since Unix + * epoch). * * Generated from protobuf field optional int64 start_time = 37467274; * @return int|string @@ -331,7 +402,8 @@ public function clearStartTime() } /** - * Scheduled start time for the outage (milliseconds since Unix epoch). + * Scheduled start time for the outage (milliseconds since Unix + * epoch). * * Generated from protobuf field optional int64 start_time = 37467274; * @param int|string $var @@ -346,7 +418,15 @@ public function setStartTime($var) } /** - * State of this notification, which can take one of the following values: - ACTIVE: This outage notification is active. The event could be in the past, present, or future. See start_time and end_time for scheduling. - CANCELLED: The outage associated with this notification was cancelled before the outage was due to start. - COMPLETED: The outage associated with this notification is complete. Note that the versions of this enum prefixed with "NS_" have been deprecated in favor of the unprefixed values. + * State of this notification, which can take one of the following values: + * - ACTIVE: This outage notification is active. The event could be in + * the past, present, or future. See start_time and end_time for + * scheduling. + * - CANCELLED: The outage associated with this notification was cancelled + * before the outage was due to start. + * - COMPLETED: The outage associated with this notification is complete. + * Note that the versions of this enum prefixed with "NS_" have been + * deprecated in favor of the unprefixed values. * Check the State enum for the list of possible values. * * Generated from protobuf field optional string state = 109757585; @@ -368,7 +448,15 @@ public function clearState() } /** - * State of this notification, which can take one of the following values: - ACTIVE: This outage notification is active. The event could be in the past, present, or future. See start_time and end_time for scheduling. - CANCELLED: The outage associated with this notification was cancelled before the outage was due to start. - COMPLETED: The outage associated with this notification is complete. Note that the versions of this enum prefixed with "NS_" have been deprecated in favor of the unprefixed values. + * State of this notification, which can take one of the following values: + * - ACTIVE: This outage notification is active. The event could be in + * the past, present, or future. See start_time and end_time for + * scheduling. + * - CANCELLED: The outage associated with this notification was cancelled + * before the outage was due to start. + * - COMPLETED: The outage associated with this notification is complete. + * Note that the versions of this enum prefixed with "NS_" have been + * deprecated in favor of the unprefixed values. * Check the State enum for the list of possible values. * * Generated from protobuf field optional string state = 109757585; diff --git a/Compute/src/V1/InterconnectOutageNotification/IssueType.php b/Compute/src/V1/InterconnectOutageNotification/IssueType.php index 6d96061311d3..8cf4dc7340b8 100644 --- a/Compute/src/V1/InterconnectOutageNotification/IssueType.php +++ b/Compute/src/V1/InterconnectOutageNotification/IssueType.php @@ -7,7 +7,14 @@ use UnexpectedValueException; /** - * Form this outage is expected to take, which can take one of the following values: - OUTAGE: The Interconnect may be completely out of service for some or all of the specified window. - PARTIAL_OUTAGE: Some circuits comprising the Interconnect as a whole should remain up, but with reduced bandwidth. Note that the versions of this enum prefixed with "IT_" have been deprecated in favor of the unprefixed values. + * Form this outage is expected to take, which can take one of the following + * values: + * - OUTAGE: The Interconnect may be completely out of service for + * some or all of the specified window. + * - PARTIAL_OUTAGE: Some circuits comprising the Interconnect as a whole + * should remain up, but with reduced bandwidth. + * Note that the versions of this enum prefixed with "IT_" have been + * deprecated in favor of the unprefixed values. * * Protobuf type google.cloud.compute.v1.InterconnectOutageNotification.IssueType */ @@ -20,25 +27,31 @@ class IssueType */ const UNDEFINED_ISSUE_TYPE = 0; /** - * [Deprecated] The Interconnect may be completely out of service for some or all of the specified window. + * [Deprecated] The Interconnect may be completely out of service for some + * or all of the specified window. * * Generated from protobuf enum IT_OUTAGE = 175779973; */ const IT_OUTAGE = 175779973; /** - * [Deprecated] Some circuits comprising the Interconnect will be out of service during the expected window. The interconnect as a whole should remain up, albeit with reduced bandwidth. + * [Deprecated] Some circuits comprising the Interconnect will be out of + * service during the expected window. The interconnect as a whole should + * remain up, albeit with reduced bandwidth. * * Generated from protobuf enum IT_PARTIAL_OUTAGE = 92103971; */ const IT_PARTIAL_OUTAGE = 92103971; /** - * The Interconnect may be completely out of service for some or all of the specified window. + * The Interconnect may be completely out of service for some or all of + * the specified window. * * Generated from protobuf enum OUTAGE = 195285745; */ const OUTAGE = 195285745; /** - * Some circuits comprising the Interconnect will be out of service during the expected window. The interconnect as a whole should remain up, albeit with reduced bandwidth. + * Some circuits comprising the Interconnect will be out of service during + * the expected window. The interconnect as a whole should remain + * up, albeit with reduced bandwidth. * * Generated from protobuf enum PARTIAL_OUTAGE = 147053455; */ diff --git a/Compute/src/V1/InterconnectOutageNotification/Source.php b/Compute/src/V1/InterconnectOutageNotification/Source.php index ebe2cbf4d14b..41b04f967d96 100644 --- a/Compute/src/V1/InterconnectOutageNotification/Source.php +++ b/Compute/src/V1/InterconnectOutageNotification/Source.php @@ -7,7 +7,11 @@ use UnexpectedValueException; /** - * The party that generated this notification, which can take the following value: - GOOGLE: this notification as generated by Google. Note that the value of NSRC_GOOGLE has been deprecated in favor of GOOGLE. + * The party that generated this notification, which can take the following + * value: + * - GOOGLE: this notification as generated by Google. + * Note that the value of NSRC_GOOGLE has been deprecated in favor of + * GOOGLE. * * Protobuf type google.cloud.compute.v1.InterconnectOutageNotification.Source */ diff --git a/Compute/src/V1/InterconnectOutageNotification/State.php b/Compute/src/V1/InterconnectOutageNotification/State.php index d90b25a531cb..530e9e4442c6 100644 --- a/Compute/src/V1/InterconnectOutageNotification/State.php +++ b/Compute/src/V1/InterconnectOutageNotification/State.php @@ -7,7 +7,15 @@ use UnexpectedValueException; /** - * State of this notification, which can take one of the following values: - ACTIVE: This outage notification is active. The event could be in the past, present, or future. See start_time and end_time for scheduling. - CANCELLED: The outage associated with this notification was cancelled before the outage was due to start. - COMPLETED: The outage associated with this notification is complete. Note that the versions of this enum prefixed with "NS_" have been deprecated in favor of the unprefixed values. + * State of this notification, which can take one of the following values: + * - ACTIVE: This outage notification is active. The event could be in + * the past, present, or future. See start_time and end_time for + * scheduling. + * - CANCELLED: The outage associated with this notification was cancelled + * before the outage was due to start. + * - COMPLETED: The outage associated with this notification is complete. + * Note that the versions of this enum prefixed with "NS_" have been + * deprecated in favor of the unprefixed values. * * Protobuf type google.cloud.compute.v1.InterconnectOutageNotification.State */ @@ -20,13 +28,15 @@ class State */ const UNDEFINED_STATE = 0; /** - * This outage notification is active. The event could be in the future, present, or past. See start_time and end_time for scheduling. + * This outage notification is active. The event could be in the future, + * present, or past. See start_time and end_time for scheduling. * * Generated from protobuf enum ACTIVE = 314733318; */ const ACTIVE = 314733318; /** - * The outage associated with this notification was cancelled before the outage was due to start. + * The outage associated with this notification was cancelled before the + * outage was due to start. * * Generated from protobuf enum CANCELLED = 41957681; */ @@ -38,13 +48,16 @@ class State */ const COMPLETED = 309921323; /** - * [Deprecated] This outage notification is active. The event could be in the future, present, or past. See start_time and end_time for scheduling. + * [Deprecated] This outage notification is active. The event could be in + * the future, present, or past. See start_time and end_time for + * scheduling. * * Generated from protobuf enum NS_ACTIVE = 252563136; */ const NS_ACTIVE = 252563136; /** - * [Deprecated] The outage associated with this notification was canceled before the outage was due to start. + * [Deprecated] The outage associated with this notification was canceled + * before the outage was due to start. * * Generated from protobuf enum NS_CANCELED = 506579411; */ diff --git a/Compute/src/V1/InterconnectParams.php b/Compute/src/V1/InterconnectParams.php new file mode 100644 index 000000000000..837604ae82c2 --- /dev/null +++ b/Compute/src/V1/InterconnectParams.php @@ -0,0 +1,119 @@ +google.cloud.compute.v1.InterconnectParams + */ +class InterconnectParams extends \Google\Protobuf\Internal\Message +{ + /** + * Tag keys/values directly bound to this resource. + * Tag keys and values have the same definition as resource + * manager tags. The field is allowed for INSERT + * only. The keys/values to set on the resource should be specified in + * either ID { : } or Namespaced format + * { : }. + * For example the following are valid inputs: + * * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} + * * {"123/environment" : "production", "345/abc" : "xyz"} + * Note: + * * Invalid combinations of ID & namespaced format is not supported. For + * instance: {"123/environment" : "tagValues/444"} is invalid. + * * Inconsistent format is not supported. For instance: + * {"tagKeys/333" : "tagValues/444", "123/env" : "prod"} is invalid. + * + * Generated from protobuf field map resource_manager_tags = 377671164; + */ + private $resource_manager_tags; + + /** + * Constructor. + * + * @param array $data { + * Optional. Data for populating the Message object. + * + * @type array|\Google\Protobuf\Internal\MapField $resource_manager_tags + * Tag keys/values directly bound to this resource. + * Tag keys and values have the same definition as resource + * manager tags. The field is allowed for INSERT + * only. The keys/values to set on the resource should be specified in + * either ID { : } or Namespaced format + * { : }. + * For example the following are valid inputs: + * * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} + * * {"123/environment" : "production", "345/abc" : "xyz"} + * Note: + * * Invalid combinations of ID & namespaced format is not supported. For + * instance: {"123/environment" : "tagValues/444"} is invalid. + * * Inconsistent format is not supported. For instance: + * {"tagKeys/333" : "tagValues/444", "123/env" : "prod"} is invalid. + * } + */ + public function __construct($data = NULL) { + \GPBMetadata\Google\Cloud\Compute\V1\Compute::initOnce(); + parent::__construct($data); + } + + /** + * Tag keys/values directly bound to this resource. + * Tag keys and values have the same definition as resource + * manager tags. The field is allowed for INSERT + * only. The keys/values to set on the resource should be specified in + * either ID { : } or Namespaced format + * { : }. + * For example the following are valid inputs: + * * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} + * * {"123/environment" : "production", "345/abc" : "xyz"} + * Note: + * * Invalid combinations of ID & namespaced format is not supported. For + * instance: {"123/environment" : "tagValues/444"} is invalid. + * * Inconsistent format is not supported. For instance: + * {"tagKeys/333" : "tagValues/444", "123/env" : "prod"} is invalid. + * + * Generated from protobuf field map resource_manager_tags = 377671164; + * @return \Google\Protobuf\Internal\MapField + */ + public function getResourceManagerTags() + { + return $this->resource_manager_tags; + } + + /** + * Tag keys/values directly bound to this resource. + * Tag keys and values have the same definition as resource + * manager tags. The field is allowed for INSERT + * only. The keys/values to set on the resource should be specified in + * either ID { : } or Namespaced format + * { : }. + * For example the following are valid inputs: + * * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} + * * {"123/environment" : "production", "345/abc" : "xyz"} + * Note: + * * Invalid combinations of ID & namespaced format is not supported. For + * instance: {"123/environment" : "tagValues/444"} is invalid. + * * Inconsistent format is not supported. For instance: + * {"tagKeys/333" : "tagValues/444", "123/env" : "prod"} is invalid. + * + * Generated from protobuf field map resource_manager_tags = 377671164; + * @param array|\Google\Protobuf\Internal\MapField $var + * @return $this + */ + public function setResourceManagerTags($var) + { + $arr = GPBUtil::checkMapField($var, \Google\Protobuf\Internal\GPBType::STRING, \Google\Protobuf\Internal\GPBType::STRING); + $this->resource_manager_tags = $arr; + + return $this; + } + +} + diff --git a/Compute/src/V1/InterconnectRemoteLocation.php b/Compute/src/V1/InterconnectRemoteLocation.php index 793fc6f7e75e..4e30f6a2f326 100644 --- a/Compute/src/V1/InterconnectRemoteLocation.php +++ b/Compute/src/V1/InterconnectRemoteLocation.php @@ -9,45 +9,60 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Represents a Cross-Cloud Interconnect Remote Location resource. You can use this resource to find remote location details about an Interconnect attachment (VLAN). + * Represents a Cross-Cloud Interconnect Remote Location resource. + * You can use this resource to find remote location details about an + * Interconnect attachment (VLAN). * * Generated from protobuf message google.cloud.compute.v1.InterconnectRemoteLocation */ class InterconnectRemoteLocation extends \Google\Protobuf\Internal\Message { /** - * [Output Only] The postal address of the Point of Presence, each line in the address is separated by a newline character. + * [Output Only] The postal address of the Point of Presence, each line in + * the address is separated by a newline character. * * Generated from protobuf field optional string address = 462920692; */ protected $address = null; /** - * [Output Only] Subset of fields from InterconnectAttachment's |configurationConstraints| field that apply to all attachments for this remote location. + * [Output Only] Subset of fields from InterconnectAttachment's + * |configurationConstraints| field that apply to all attachments for this + * remote location. * * Generated from protobuf field optional .google.cloud.compute.v1.InterconnectAttachmentConfigurationConstraints attachment_configuration_constraints = 326825041; */ protected $attachment_configuration_constraints = null; /** - * [Output Only] Metropolitan area designator that indicates which city an interconnect is located. For example: "Chicago, IL", "Amsterdam, Netherlands". + * [Output Only] Metropolitan area designator that indicates which city an + * interconnect is located. + * For example: "Chicago, IL", "Amsterdam, Netherlands". * * Generated from protobuf field optional string city = 3053931; */ protected $city = null; /** - * [Output Only] Constraints on the parameters for creating Cross-Cloud Interconnect and associated InterconnectAttachments. + * [Output Only] Constraints on the parameters for creating Cross-Cloud + * Interconnect and associated InterconnectAttachments. * * Generated from protobuf field optional .google.cloud.compute.v1.InterconnectRemoteLocationConstraints constraints = 3909174; */ protected $constraints = null; /** - * [Output Only] Continent for this location, which can take one of the following values: - AFRICA - ASIA_PAC - EUROPE - NORTH_AMERICA - SOUTH_AMERICA + * [Output Only] Continent for this location, which can take one of the + * following values: + * - AFRICA + * - ASIA_PAC + * - EUROPE + * - NORTH_AMERICA + * - SOUTH_AMERICA * Check the Continent enum for the list of possible values. * * Generated from protobuf field optional string continent = 133442996; */ protected $continent = null; /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; */ @@ -65,44 +80,57 @@ class InterconnectRemoteLocation extends \Google\Protobuf\Internal\Message */ protected $facility_provider = null; /** - * [Output Only] A provider-assigned Identifier for this facility (e.g., Ashburn-DC1). + * [Output Only] A provider-assigned Identifier for this facility (e.g., + * Ashburn-DC1). * * Generated from protobuf field optional string facility_provider_facility_id = 87269125; */ protected $facility_provider_facility_id = null; /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; */ protected $id = null; /** - * [Output Only] Type of the resource. Always compute#interconnectRemoteLocation for interconnect remote locations. + * [Output Only] Type of the resource. Alwayscompute#interconnectRemoteLocation for interconnect remote + * locations. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] Link Aggregation Control Protocol (LACP) constraints, which can take one of the following values: LACP_SUPPORTED, LACP_UNSUPPORTED + * [Output Only] Link Aggregation Control Protocol (LACP) constraints, which + * can take one of the following values: LACP_SUPPORTED, LACP_UNSUPPORTED * Check the Lacp enum for the list of possible values. * * Generated from protobuf field optional string lacp = 3313826; */ protected $lacp = null; /** - * [Output Only] The maximum number of 100 Gbps ports supported in a link aggregation group (LAG). When linkType is 100 Gbps, requestedLinkCount cannot exceed max_lag_size_100_gbps. + * [Output Only] + * The maximum number of 100 Gbps ports supported in a link aggregation group + * (LAG). When linkType is 100 Gbps, requestedLinkCount cannot exceed + * max_lag_size_100_gbps. * * Generated from protobuf field optional int32 max_lag_size100_gbps = 245219253; */ protected $max_lag_size100_gbps = null; /** - * [Output Only] The maximum number of 10 Gbps ports supported in a link aggregation group (LAG). When linkType is 10 Gbps, requestedLinkCount cannot exceed max_lag_size_10_gbps. + * [Output Only] + * The maximum number of 10 Gbps ports supported in a link aggregation group + * (LAG). When linkType is 10 Gbps, requestedLinkCount cannot exceed + * max_lag_size_10_gbps. * * Generated from protobuf field optional int32 max_lag_size10_gbps = 294007573; */ protected $max_lag_size10_gbps = null; /** - * [Output Only] The maximum number of 400 Gbps ports supported in a link aggregation group (LAG). When linkType is 400 Gbps, requestedLinkCount cannot exceed max_lag_size_400_gbps. + * [Output Only] + * The maximum number of 400 Gbps ports supported in a link aggregation group + * (LAG). When linkType is 400 Gbps, requestedLinkCount cannot exceed + * max_lag_size_400_gbps. * * Generated from protobuf field optional int32 max_lag_size400_gbps = 104941138; */ @@ -114,7 +142,8 @@ class InterconnectRemoteLocation extends \Google\Protobuf\Internal\Message */ protected $name = null; /** - * [Output Only] The peeringdb identifier for this facility (corresponding with a netfac type in peeringdb). + * [Output Only] The peeringdb identifier for this facility (corresponding + * with a netfac type in peeringdb). * * Generated from protobuf field optional string peeringdb_facility_id = 536567094; */ @@ -126,7 +155,8 @@ class InterconnectRemoteLocation extends \Google\Protobuf\Internal\Message */ private $permitted_connections; /** - * [Output Only] Indicates the service provider present at the remote location. Example values: "Amazon Web Services", "Microsoft Azure". + * [Output Only] Indicates the service provider present at the remote + * location. Example values: "Amazon Web Services", "Microsoft Azure". * * Generated from protobuf field optional string remote_service = 391954364; */ @@ -138,7 +168,13 @@ class InterconnectRemoteLocation extends \Google\Protobuf\Internal\Message */ protected $self_link = null; /** - * [Output Only] The status of this InterconnectRemoteLocation, which can take one of the following values: - CLOSED: The InterconnectRemoteLocation is closed and is unavailable for provisioning new Cross-Cloud Interconnects. - AVAILABLE: The InterconnectRemoteLocation is available for provisioning new Cross-Cloud Interconnects. + * [Output Only] The status of this InterconnectRemoteLocation, which can take + * one of the following values: + * - CLOSED: The InterconnectRemoteLocation is closed and is unavailable + * for provisioning new Cross-Cloud Interconnects. + * - AVAILABLE: The + * InterconnectRemoteLocation is available for provisioning new + * Cross-Cloud Interconnects. * Check the Status enum for the list of possible values. * * Generated from protobuf field optional string status = 181260274; @@ -152,49 +188,83 @@ class InterconnectRemoteLocation extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $address - * [Output Only] The postal address of the Point of Presence, each line in the address is separated by a newline character. + * [Output Only] The postal address of the Point of Presence, each line in + * the address is separated by a newline character. * @type \Google\Cloud\Compute\V1\InterconnectAttachmentConfigurationConstraints $attachment_configuration_constraints - * [Output Only] Subset of fields from InterconnectAttachment's |configurationConstraints| field that apply to all attachments for this remote location. + * [Output Only] Subset of fields from InterconnectAttachment's + * |configurationConstraints| field that apply to all attachments for this + * remote location. * @type string $city - * [Output Only] Metropolitan area designator that indicates which city an interconnect is located. For example: "Chicago, IL", "Amsterdam, Netherlands". + * [Output Only] Metropolitan area designator that indicates which city an + * interconnect is located. + * For example: "Chicago, IL", "Amsterdam, Netherlands". * @type \Google\Cloud\Compute\V1\InterconnectRemoteLocationConstraints $constraints - * [Output Only] Constraints on the parameters for creating Cross-Cloud Interconnect and associated InterconnectAttachments. + * [Output Only] Constraints on the parameters for creating Cross-Cloud + * Interconnect and associated InterconnectAttachments. * @type string $continent - * [Output Only] Continent for this location, which can take one of the following values: - AFRICA - ASIA_PAC - EUROPE - NORTH_AMERICA - SOUTH_AMERICA + * [Output Only] Continent for this location, which can take one of the + * following values: + * - AFRICA + * - ASIA_PAC + * - EUROPE + * - NORTH_AMERICA + * - SOUTH_AMERICA * Check the Continent enum for the list of possible values. * @type string $creation_timestamp - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * @type string $description * [Output Only] An optional description of the resource. * @type string $facility_provider * [Output Only] The name of the provider for this facility (e.g., EQUINIX). * @type string $facility_provider_facility_id - * [Output Only] A provider-assigned Identifier for this facility (e.g., Ashburn-DC1). + * [Output Only] A provider-assigned Identifier for this facility (e.g., + * Ashburn-DC1). * @type int|string $id - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * @type string $kind - * [Output Only] Type of the resource. Always compute#interconnectRemoteLocation for interconnect remote locations. + * [Output Only] Type of the resource. Alwayscompute#interconnectRemoteLocation for interconnect remote + * locations. * @type string $lacp - * [Output Only] Link Aggregation Control Protocol (LACP) constraints, which can take one of the following values: LACP_SUPPORTED, LACP_UNSUPPORTED + * [Output Only] Link Aggregation Control Protocol (LACP) constraints, which + * can take one of the following values: LACP_SUPPORTED, LACP_UNSUPPORTED * Check the Lacp enum for the list of possible values. * @type int $max_lag_size100_gbps - * [Output Only] The maximum number of 100 Gbps ports supported in a link aggregation group (LAG). When linkType is 100 Gbps, requestedLinkCount cannot exceed max_lag_size_100_gbps. + * [Output Only] + * The maximum number of 100 Gbps ports supported in a link aggregation group + * (LAG). When linkType is 100 Gbps, requestedLinkCount cannot exceed + * max_lag_size_100_gbps. * @type int $max_lag_size10_gbps - * [Output Only] The maximum number of 10 Gbps ports supported in a link aggregation group (LAG). When linkType is 10 Gbps, requestedLinkCount cannot exceed max_lag_size_10_gbps. + * [Output Only] + * The maximum number of 10 Gbps ports supported in a link aggregation group + * (LAG). When linkType is 10 Gbps, requestedLinkCount cannot exceed + * max_lag_size_10_gbps. * @type int $max_lag_size400_gbps - * [Output Only] The maximum number of 400 Gbps ports supported in a link aggregation group (LAG). When linkType is 400 Gbps, requestedLinkCount cannot exceed max_lag_size_400_gbps. + * [Output Only] + * The maximum number of 400 Gbps ports supported in a link aggregation group + * (LAG). When linkType is 400 Gbps, requestedLinkCount cannot exceed + * max_lag_size_400_gbps. * @type string $name * [Output Only] Name of the resource. * @type string $peeringdb_facility_id - * [Output Only] The peeringdb identifier for this facility (corresponding with a netfac type in peeringdb). + * [Output Only] The peeringdb identifier for this facility (corresponding + * with a netfac type in peeringdb). * @type array<\Google\Cloud\Compute\V1\InterconnectRemoteLocationPermittedConnections>|\Google\Protobuf\Internal\RepeatedField $permitted_connections * [Output Only] Permitted connections. * @type string $remote_service - * [Output Only] Indicates the service provider present at the remote location. Example values: "Amazon Web Services", "Microsoft Azure". + * [Output Only] Indicates the service provider present at the remote + * location. Example values: "Amazon Web Services", "Microsoft Azure". * @type string $self_link * [Output Only] Server-defined URL for the resource. * @type string $status - * [Output Only] The status of this InterconnectRemoteLocation, which can take one of the following values: - CLOSED: The InterconnectRemoteLocation is closed and is unavailable for provisioning new Cross-Cloud Interconnects. - AVAILABLE: The InterconnectRemoteLocation is available for provisioning new Cross-Cloud Interconnects. + * [Output Only] The status of this InterconnectRemoteLocation, which can take + * one of the following values: + * - CLOSED: The InterconnectRemoteLocation is closed and is unavailable + * for provisioning new Cross-Cloud Interconnects. + * - AVAILABLE: The + * InterconnectRemoteLocation is available for provisioning new + * Cross-Cloud Interconnects. * Check the Status enum for the list of possible values. * } */ @@ -204,7 +274,8 @@ public function __construct($data = NULL) { } /** - * [Output Only] The postal address of the Point of Presence, each line in the address is separated by a newline character. + * [Output Only] The postal address of the Point of Presence, each line in + * the address is separated by a newline character. * * Generated from protobuf field optional string address = 462920692; * @return string @@ -225,7 +296,8 @@ public function clearAddress() } /** - * [Output Only] The postal address of the Point of Presence, each line in the address is separated by a newline character. + * [Output Only] The postal address of the Point of Presence, each line in + * the address is separated by a newline character. * * Generated from protobuf field optional string address = 462920692; * @param string $var @@ -240,7 +312,9 @@ public function setAddress($var) } /** - * [Output Only] Subset of fields from InterconnectAttachment's |configurationConstraints| field that apply to all attachments for this remote location. + * [Output Only] Subset of fields from InterconnectAttachment's + * |configurationConstraints| field that apply to all attachments for this + * remote location. * * Generated from protobuf field optional .google.cloud.compute.v1.InterconnectAttachmentConfigurationConstraints attachment_configuration_constraints = 326825041; * @return \Google\Cloud\Compute\V1\InterconnectAttachmentConfigurationConstraints|null @@ -261,7 +335,9 @@ public function clearAttachmentConfigurationConstraints() } /** - * [Output Only] Subset of fields from InterconnectAttachment's |configurationConstraints| field that apply to all attachments for this remote location. + * [Output Only] Subset of fields from InterconnectAttachment's + * |configurationConstraints| field that apply to all attachments for this + * remote location. * * Generated from protobuf field optional .google.cloud.compute.v1.InterconnectAttachmentConfigurationConstraints attachment_configuration_constraints = 326825041; * @param \Google\Cloud\Compute\V1\InterconnectAttachmentConfigurationConstraints $var @@ -276,7 +352,9 @@ public function setAttachmentConfigurationConstraints($var) } /** - * [Output Only] Metropolitan area designator that indicates which city an interconnect is located. For example: "Chicago, IL", "Amsterdam, Netherlands". + * [Output Only] Metropolitan area designator that indicates which city an + * interconnect is located. + * For example: "Chicago, IL", "Amsterdam, Netherlands". * * Generated from protobuf field optional string city = 3053931; * @return string @@ -297,7 +375,9 @@ public function clearCity() } /** - * [Output Only] Metropolitan area designator that indicates which city an interconnect is located. For example: "Chicago, IL", "Amsterdam, Netherlands". + * [Output Only] Metropolitan area designator that indicates which city an + * interconnect is located. + * For example: "Chicago, IL", "Amsterdam, Netherlands". * * Generated from protobuf field optional string city = 3053931; * @param string $var @@ -312,7 +392,8 @@ public function setCity($var) } /** - * [Output Only] Constraints on the parameters for creating Cross-Cloud Interconnect and associated InterconnectAttachments. + * [Output Only] Constraints on the parameters for creating Cross-Cloud + * Interconnect and associated InterconnectAttachments. * * Generated from protobuf field optional .google.cloud.compute.v1.InterconnectRemoteLocationConstraints constraints = 3909174; * @return \Google\Cloud\Compute\V1\InterconnectRemoteLocationConstraints|null @@ -333,7 +414,8 @@ public function clearConstraints() } /** - * [Output Only] Constraints on the parameters for creating Cross-Cloud Interconnect and associated InterconnectAttachments. + * [Output Only] Constraints on the parameters for creating Cross-Cloud + * Interconnect and associated InterconnectAttachments. * * Generated from protobuf field optional .google.cloud.compute.v1.InterconnectRemoteLocationConstraints constraints = 3909174; * @param \Google\Cloud\Compute\V1\InterconnectRemoteLocationConstraints $var @@ -348,7 +430,13 @@ public function setConstraints($var) } /** - * [Output Only] Continent for this location, which can take one of the following values: - AFRICA - ASIA_PAC - EUROPE - NORTH_AMERICA - SOUTH_AMERICA + * [Output Only] Continent for this location, which can take one of the + * following values: + * - AFRICA + * - ASIA_PAC + * - EUROPE + * - NORTH_AMERICA + * - SOUTH_AMERICA * Check the Continent enum for the list of possible values. * * Generated from protobuf field optional string continent = 133442996; @@ -370,7 +458,13 @@ public function clearContinent() } /** - * [Output Only] Continent for this location, which can take one of the following values: - AFRICA - ASIA_PAC - EUROPE - NORTH_AMERICA - SOUTH_AMERICA + * [Output Only] Continent for this location, which can take one of the + * following values: + * - AFRICA + * - ASIA_PAC + * - EUROPE + * - NORTH_AMERICA + * - SOUTH_AMERICA * Check the Continent enum for the list of possible values. * * Generated from protobuf field optional string continent = 133442996; @@ -386,7 +480,8 @@ public function setContinent($var) } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @return string @@ -407,7 +502,8 @@ public function clearCreationTimestamp() } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @param string $var @@ -494,7 +590,8 @@ public function setFacilityProvider($var) } /** - * [Output Only] A provider-assigned Identifier for this facility (e.g., Ashburn-DC1). + * [Output Only] A provider-assigned Identifier for this facility (e.g., + * Ashburn-DC1). * * Generated from protobuf field optional string facility_provider_facility_id = 87269125; * @return string @@ -515,7 +612,8 @@ public function clearFacilityProviderFacilityId() } /** - * [Output Only] A provider-assigned Identifier for this facility (e.g., Ashburn-DC1). + * [Output Only] A provider-assigned Identifier for this facility (e.g., + * Ashburn-DC1). * * Generated from protobuf field optional string facility_provider_facility_id = 87269125; * @param string $var @@ -530,7 +628,8 @@ public function setFacilityProviderFacilityId($var) } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @return int|string @@ -551,7 +650,8 @@ public function clearId() } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @param int|string $var @@ -566,7 +666,8 @@ public function setId($var) } /** - * [Output Only] Type of the resource. Always compute#interconnectRemoteLocation for interconnect remote locations. + * [Output Only] Type of the resource. Alwayscompute#interconnectRemoteLocation for interconnect remote + * locations. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -587,7 +688,8 @@ public function clearKind() } /** - * [Output Only] Type of the resource. Always compute#interconnectRemoteLocation for interconnect remote locations. + * [Output Only] Type of the resource. Alwayscompute#interconnectRemoteLocation for interconnect remote + * locations. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -602,7 +704,8 @@ public function setKind($var) } /** - * [Output Only] Link Aggregation Control Protocol (LACP) constraints, which can take one of the following values: LACP_SUPPORTED, LACP_UNSUPPORTED + * [Output Only] Link Aggregation Control Protocol (LACP) constraints, which + * can take one of the following values: LACP_SUPPORTED, LACP_UNSUPPORTED * Check the Lacp enum for the list of possible values. * * Generated from protobuf field optional string lacp = 3313826; @@ -624,7 +727,8 @@ public function clearLacp() } /** - * [Output Only] Link Aggregation Control Protocol (LACP) constraints, which can take one of the following values: LACP_SUPPORTED, LACP_UNSUPPORTED + * [Output Only] Link Aggregation Control Protocol (LACP) constraints, which + * can take one of the following values: LACP_SUPPORTED, LACP_UNSUPPORTED * Check the Lacp enum for the list of possible values. * * Generated from protobuf field optional string lacp = 3313826; @@ -640,7 +744,10 @@ public function setLacp($var) } /** - * [Output Only] The maximum number of 100 Gbps ports supported in a link aggregation group (LAG). When linkType is 100 Gbps, requestedLinkCount cannot exceed max_lag_size_100_gbps. + * [Output Only] + * The maximum number of 100 Gbps ports supported in a link aggregation group + * (LAG). When linkType is 100 Gbps, requestedLinkCount cannot exceed + * max_lag_size_100_gbps. * * Generated from protobuf field optional int32 max_lag_size100_gbps = 245219253; * @return int @@ -661,7 +768,10 @@ public function clearMaxLagSize100Gbps() } /** - * [Output Only] The maximum number of 100 Gbps ports supported in a link aggregation group (LAG). When linkType is 100 Gbps, requestedLinkCount cannot exceed max_lag_size_100_gbps. + * [Output Only] + * The maximum number of 100 Gbps ports supported in a link aggregation group + * (LAG). When linkType is 100 Gbps, requestedLinkCount cannot exceed + * max_lag_size_100_gbps. * * Generated from protobuf field optional int32 max_lag_size100_gbps = 245219253; * @param int $var @@ -676,7 +786,10 @@ public function setMaxLagSize100Gbps($var) } /** - * [Output Only] The maximum number of 10 Gbps ports supported in a link aggregation group (LAG). When linkType is 10 Gbps, requestedLinkCount cannot exceed max_lag_size_10_gbps. + * [Output Only] + * The maximum number of 10 Gbps ports supported in a link aggregation group + * (LAG). When linkType is 10 Gbps, requestedLinkCount cannot exceed + * max_lag_size_10_gbps. * * Generated from protobuf field optional int32 max_lag_size10_gbps = 294007573; * @return int @@ -697,7 +810,10 @@ public function clearMaxLagSize10Gbps() } /** - * [Output Only] The maximum number of 10 Gbps ports supported in a link aggregation group (LAG). When linkType is 10 Gbps, requestedLinkCount cannot exceed max_lag_size_10_gbps. + * [Output Only] + * The maximum number of 10 Gbps ports supported in a link aggregation group + * (LAG). When linkType is 10 Gbps, requestedLinkCount cannot exceed + * max_lag_size_10_gbps. * * Generated from protobuf field optional int32 max_lag_size10_gbps = 294007573; * @param int $var @@ -712,7 +828,10 @@ public function setMaxLagSize10Gbps($var) } /** - * [Output Only] The maximum number of 400 Gbps ports supported in a link aggregation group (LAG). When linkType is 400 Gbps, requestedLinkCount cannot exceed max_lag_size_400_gbps. + * [Output Only] + * The maximum number of 400 Gbps ports supported in a link aggregation group + * (LAG). When linkType is 400 Gbps, requestedLinkCount cannot exceed + * max_lag_size_400_gbps. * * Generated from protobuf field optional int32 max_lag_size400_gbps = 104941138; * @return int @@ -733,7 +852,10 @@ public function clearMaxLagSize400Gbps() } /** - * [Output Only] The maximum number of 400 Gbps ports supported in a link aggregation group (LAG). When linkType is 400 Gbps, requestedLinkCount cannot exceed max_lag_size_400_gbps. + * [Output Only] + * The maximum number of 400 Gbps ports supported in a link aggregation group + * (LAG). When linkType is 400 Gbps, requestedLinkCount cannot exceed + * max_lag_size_400_gbps. * * Generated from protobuf field optional int32 max_lag_size400_gbps = 104941138; * @param int $var @@ -784,7 +906,8 @@ public function setName($var) } /** - * [Output Only] The peeringdb identifier for this facility (corresponding with a netfac type in peeringdb). + * [Output Only] The peeringdb identifier for this facility (corresponding + * with a netfac type in peeringdb). * * Generated from protobuf field optional string peeringdb_facility_id = 536567094; * @return string @@ -805,7 +928,8 @@ public function clearPeeringdbFacilityId() } /** - * [Output Only] The peeringdb identifier for this facility (corresponding with a netfac type in peeringdb). + * [Output Only] The peeringdb identifier for this facility (corresponding + * with a netfac type in peeringdb). * * Generated from protobuf field optional string peeringdb_facility_id = 536567094; * @param string $var @@ -846,7 +970,8 @@ public function setPermittedConnections($var) } /** - * [Output Only] Indicates the service provider present at the remote location. Example values: "Amazon Web Services", "Microsoft Azure". + * [Output Only] Indicates the service provider present at the remote + * location. Example values: "Amazon Web Services", "Microsoft Azure". * * Generated from protobuf field optional string remote_service = 391954364; * @return string @@ -867,7 +992,8 @@ public function clearRemoteService() } /** - * [Output Only] Indicates the service provider present at the remote location. Example values: "Amazon Web Services", "Microsoft Azure". + * [Output Only] Indicates the service provider present at the remote + * location. Example values: "Amazon Web Services", "Microsoft Azure". * * Generated from protobuf field optional string remote_service = 391954364; * @param string $var @@ -918,7 +1044,13 @@ public function setSelfLink($var) } /** - * [Output Only] The status of this InterconnectRemoteLocation, which can take one of the following values: - CLOSED: The InterconnectRemoteLocation is closed and is unavailable for provisioning new Cross-Cloud Interconnects. - AVAILABLE: The InterconnectRemoteLocation is available for provisioning new Cross-Cloud Interconnects. + * [Output Only] The status of this InterconnectRemoteLocation, which can take + * one of the following values: + * - CLOSED: The InterconnectRemoteLocation is closed and is unavailable + * for provisioning new Cross-Cloud Interconnects. + * - AVAILABLE: The + * InterconnectRemoteLocation is available for provisioning new + * Cross-Cloud Interconnects. * Check the Status enum for the list of possible values. * * Generated from protobuf field optional string status = 181260274; @@ -940,7 +1072,13 @@ public function clearStatus() } /** - * [Output Only] The status of this InterconnectRemoteLocation, which can take one of the following values: - CLOSED: The InterconnectRemoteLocation is closed and is unavailable for provisioning new Cross-Cloud Interconnects. - AVAILABLE: The InterconnectRemoteLocation is available for provisioning new Cross-Cloud Interconnects. + * [Output Only] The status of this InterconnectRemoteLocation, which can take + * one of the following values: + * - CLOSED: The InterconnectRemoteLocation is closed and is unavailable + * for provisioning new Cross-Cloud Interconnects. + * - AVAILABLE: The + * InterconnectRemoteLocation is available for provisioning new + * Cross-Cloud Interconnects. * Check the Status enum for the list of possible values. * * Generated from protobuf field optional string status = 181260274; diff --git a/Compute/src/V1/InterconnectRemoteLocation/Continent.php b/Compute/src/V1/InterconnectRemoteLocation/Continent.php index b782d2615c46..84c352ee8c6f 100644 --- a/Compute/src/V1/InterconnectRemoteLocation/Continent.php +++ b/Compute/src/V1/InterconnectRemoteLocation/Continent.php @@ -7,7 +7,13 @@ use UnexpectedValueException; /** - * [Output Only] Continent for this location, which can take one of the following values: - AFRICA - ASIA_PAC - EUROPE - NORTH_AMERICA - SOUTH_AMERICA + * [Output Only] Continent for this location, which can take one of the + * following values: + * - AFRICA + * - ASIA_PAC + * - EUROPE + * - NORTH_AMERICA + * - SOUTH_AMERICA * * Protobuf type google.cloud.compute.v1.InterconnectRemoteLocation.Continent */ diff --git a/Compute/src/V1/InterconnectRemoteLocation/Lacp.php b/Compute/src/V1/InterconnectRemoteLocation/Lacp.php index 35245841b0de..9cf781329d05 100644 --- a/Compute/src/V1/InterconnectRemoteLocation/Lacp.php +++ b/Compute/src/V1/InterconnectRemoteLocation/Lacp.php @@ -7,7 +7,8 @@ use UnexpectedValueException; /** - * [Output Only] Link Aggregation Control Protocol (LACP) constraints, which can take one of the following values: LACP_SUPPORTED, LACP_UNSUPPORTED + * [Output Only] Link Aggregation Control Protocol (LACP) constraints, which + * can take one of the following values: LACP_SUPPORTED, LACP_UNSUPPORTED * * Protobuf type google.cloud.compute.v1.InterconnectRemoteLocation.Lacp */ @@ -20,13 +21,16 @@ class Lacp */ const UNDEFINED_LACP = 0; /** - * LACP_SUPPORTED: LACP is supported, and enabled by default on the Cross-Cloud Interconnect. + * LACP_SUPPORTED: LACP is supported, and enabled by default on + * the Cross-Cloud Interconnect. * * Generated from protobuf enum LACP_SUPPORTED = 339576113; */ const LACP_SUPPORTED = 339576113; /** - * LACP_UNSUPPORTED: LACP is not supported and is not be enabled on this port. GetDiagnostics shows bundleAggregationType as "static". GCP does not support LAGs without LACP, so requestedLinkCount must be 1. + * LACP_UNSUPPORTED: LACP is not supported and is not be enabled on this + * port. GetDiagnostics shows bundleAggregationType as "static". GCP does + * not support LAGs without LACP, so requestedLinkCount must be 1. * * Generated from protobuf enum LACP_UNSUPPORTED = 203930104; */ diff --git a/Compute/src/V1/InterconnectRemoteLocation/Status.php b/Compute/src/V1/InterconnectRemoteLocation/Status.php index 8a871d1f298d..48bf1999b348 100644 --- a/Compute/src/V1/InterconnectRemoteLocation/Status.php +++ b/Compute/src/V1/InterconnectRemoteLocation/Status.php @@ -7,7 +7,13 @@ use UnexpectedValueException; /** - * [Output Only] The status of this InterconnectRemoteLocation, which can take one of the following values: - CLOSED: The InterconnectRemoteLocation is closed and is unavailable for provisioning new Cross-Cloud Interconnects. - AVAILABLE: The InterconnectRemoteLocation is available for provisioning new Cross-Cloud Interconnects. + * [Output Only] The status of this InterconnectRemoteLocation, which can take + * one of the following values: + * - CLOSED: The InterconnectRemoteLocation is closed and is unavailable + * for provisioning new Cross-Cloud Interconnects. + * - AVAILABLE: The + * InterconnectRemoteLocation is available for provisioning new + * Cross-Cloud Interconnects. * * Protobuf type google.cloud.compute.v1.InterconnectRemoteLocation.Status */ @@ -20,13 +26,15 @@ class Status */ const UNDEFINED_STATUS = 0; /** - * The InterconnectRemoteLocation is available for provisioning new Cross-Cloud Interconnects. + * The InterconnectRemoteLocation is available for provisioning new + * Cross-Cloud Interconnects. * * Generated from protobuf enum AVAILABLE = 442079913; */ const AVAILABLE = 442079913; /** - * The InterconnectRemoteLocation is closed for provisioning new Cross-Cloud Interconnects. + * The InterconnectRemoteLocation is closed for provisioning new + * Cross-Cloud Interconnects. * * Generated from protobuf enum CLOSED = 380163436; */ diff --git a/Compute/src/V1/InterconnectRemoteLocationConstraints.php b/Compute/src/V1/InterconnectRemoteLocationConstraints.php index 11246431223d..74078ec7bfe2 100644 --- a/Compute/src/V1/InterconnectRemoteLocationConstraints.php +++ b/Compute/src/V1/InterconnectRemoteLocationConstraints.php @@ -15,21 +15,41 @@ class InterconnectRemoteLocationConstraints extends \Google\Protobuf\Internal\Message { /** - * [Output Only] Port pair remote location constraints, which can take one of the following values: PORT_PAIR_UNCONSTRAINED_REMOTE_LOCATION, PORT_PAIR_MATCHING_REMOTE_LOCATION. Google Cloud API refers only to individual ports, but the UI uses this field when ordering a pair of ports, to prevent users from accidentally ordering something that is incompatible with their cloud provider. Specifically, when ordering a redundant pair of Cross-Cloud Interconnect ports, and one of them uses a remote location with portPairMatchingRemoteLocation set to matching, the UI requires that both ports use the same remote location. + * [Output Only] Port pair remote location constraints, which can take one + * of the following values: PORT_PAIR_UNCONSTRAINED_REMOTE_LOCATION, + * PORT_PAIR_MATCHING_REMOTE_LOCATION. + * Google Cloud API refers only to individual ports, but the UI uses this + * field when ordering a pair of ports, to prevent users from accidentally + * ordering something that is incompatible with their cloud provider. + * Specifically, when ordering a redundant pair of Cross-Cloud Interconnect + * ports, and one of them uses a remote location with + * portPairMatchingRemoteLocation set to matching, the UI requires that + * both ports use the same remote location. * Check the PortPairRemoteLocation enum for the list of possible values. * * Generated from protobuf field optional string port_pair_remote_location = 495917351; */ protected $port_pair_remote_location = null; /** - * [Output Only] Port pair VLAN constraints, which can take one of the following values: PORT_PAIR_UNCONSTRAINED_VLAN, PORT_PAIR_MATCHING_VLAN + * [Output Only] Port pair VLAN constraints, which can take one of the + * following values: PORT_PAIR_UNCONSTRAINED_VLAN, PORT_PAIR_MATCHING_VLAN * Check the PortPairVlan enum for the list of possible values. * * Generated from protobuf field optional string port_pair_vlan = 478214506; */ protected $port_pair_vlan = null; /** - * [Output Only] [min-length, max-length] The minimum and maximum value (inclusive) for the IPv4 subnet length. For example, an interconnectRemoteLocation for Azure has {min: 30, max: 30} because Azure requires /30 subnets. This range specifies the values supported by both cloud providers. Interconnect currently supports /29 and /30 IPv4 subnet lengths. If a remote cloud has no constraint on IPv4 subnet length, the range would thus be {min: 29, max: 30}. + * [Output Only] + * [min-length, max-length] + * The minimum and maximum value (inclusive) for the IPv4 subnet + * length. + * For example, an interconnectRemoteLocation for Azure has {min: 30, + * max: + * 30} because Azure requires /30 subnets. + * This range specifies the values supported by both cloud providers. + * Interconnect currently supports /29 and /30 IPv4 subnet lengths. If a + * remote cloud has no constraint on IPv4 subnet length, the range would + * thus be {min: 29, max: 30}. * * Generated from protobuf field optional .google.cloud.compute.v1.InterconnectRemoteLocationConstraintsSubnetLengthRange subnet_length_range = 184473670; */ @@ -42,13 +62,33 @@ class InterconnectRemoteLocationConstraints extends \Google\Protobuf\Internal\Me * Optional. Data for populating the Message object. * * @type string $port_pair_remote_location - * [Output Only] Port pair remote location constraints, which can take one of the following values: PORT_PAIR_UNCONSTRAINED_REMOTE_LOCATION, PORT_PAIR_MATCHING_REMOTE_LOCATION. Google Cloud API refers only to individual ports, but the UI uses this field when ordering a pair of ports, to prevent users from accidentally ordering something that is incompatible with their cloud provider. Specifically, when ordering a redundant pair of Cross-Cloud Interconnect ports, and one of them uses a remote location with portPairMatchingRemoteLocation set to matching, the UI requires that both ports use the same remote location. + * [Output Only] Port pair remote location constraints, which can take one + * of the following values: PORT_PAIR_UNCONSTRAINED_REMOTE_LOCATION, + * PORT_PAIR_MATCHING_REMOTE_LOCATION. + * Google Cloud API refers only to individual ports, but the UI uses this + * field when ordering a pair of ports, to prevent users from accidentally + * ordering something that is incompatible with their cloud provider. + * Specifically, when ordering a redundant pair of Cross-Cloud Interconnect + * ports, and one of them uses a remote location with + * portPairMatchingRemoteLocation set to matching, the UI requires that + * both ports use the same remote location. * Check the PortPairRemoteLocation enum for the list of possible values. * @type string $port_pair_vlan - * [Output Only] Port pair VLAN constraints, which can take one of the following values: PORT_PAIR_UNCONSTRAINED_VLAN, PORT_PAIR_MATCHING_VLAN + * [Output Only] Port pair VLAN constraints, which can take one of the + * following values: PORT_PAIR_UNCONSTRAINED_VLAN, PORT_PAIR_MATCHING_VLAN * Check the PortPairVlan enum for the list of possible values. * @type \Google\Cloud\Compute\V1\InterconnectRemoteLocationConstraintsSubnetLengthRange $subnet_length_range - * [Output Only] [min-length, max-length] The minimum and maximum value (inclusive) for the IPv4 subnet length. For example, an interconnectRemoteLocation for Azure has {min: 30, max: 30} because Azure requires /30 subnets. This range specifies the values supported by both cloud providers. Interconnect currently supports /29 and /30 IPv4 subnet lengths. If a remote cloud has no constraint on IPv4 subnet length, the range would thus be {min: 29, max: 30}. + * [Output Only] + * [min-length, max-length] + * The minimum and maximum value (inclusive) for the IPv4 subnet + * length. + * For example, an interconnectRemoteLocation for Azure has {min: 30, + * max: + * 30} because Azure requires /30 subnets. + * This range specifies the values supported by both cloud providers. + * Interconnect currently supports /29 and /30 IPv4 subnet lengths. If a + * remote cloud has no constraint on IPv4 subnet length, the range would + * thus be {min: 29, max: 30}. * } */ public function __construct($data = NULL) { @@ -57,7 +97,16 @@ public function __construct($data = NULL) { } /** - * [Output Only] Port pair remote location constraints, which can take one of the following values: PORT_PAIR_UNCONSTRAINED_REMOTE_LOCATION, PORT_PAIR_MATCHING_REMOTE_LOCATION. Google Cloud API refers only to individual ports, but the UI uses this field when ordering a pair of ports, to prevent users from accidentally ordering something that is incompatible with their cloud provider. Specifically, when ordering a redundant pair of Cross-Cloud Interconnect ports, and one of them uses a remote location with portPairMatchingRemoteLocation set to matching, the UI requires that both ports use the same remote location. + * [Output Only] Port pair remote location constraints, which can take one + * of the following values: PORT_PAIR_UNCONSTRAINED_REMOTE_LOCATION, + * PORT_PAIR_MATCHING_REMOTE_LOCATION. + * Google Cloud API refers only to individual ports, but the UI uses this + * field when ordering a pair of ports, to prevent users from accidentally + * ordering something that is incompatible with their cloud provider. + * Specifically, when ordering a redundant pair of Cross-Cloud Interconnect + * ports, and one of them uses a remote location with + * portPairMatchingRemoteLocation set to matching, the UI requires that + * both ports use the same remote location. * Check the PortPairRemoteLocation enum for the list of possible values. * * Generated from protobuf field optional string port_pair_remote_location = 495917351; @@ -79,7 +128,16 @@ public function clearPortPairRemoteLocation() } /** - * [Output Only] Port pair remote location constraints, which can take one of the following values: PORT_PAIR_UNCONSTRAINED_REMOTE_LOCATION, PORT_PAIR_MATCHING_REMOTE_LOCATION. Google Cloud API refers only to individual ports, but the UI uses this field when ordering a pair of ports, to prevent users from accidentally ordering something that is incompatible with their cloud provider. Specifically, when ordering a redundant pair of Cross-Cloud Interconnect ports, and one of them uses a remote location with portPairMatchingRemoteLocation set to matching, the UI requires that both ports use the same remote location. + * [Output Only] Port pair remote location constraints, which can take one + * of the following values: PORT_PAIR_UNCONSTRAINED_REMOTE_LOCATION, + * PORT_PAIR_MATCHING_REMOTE_LOCATION. + * Google Cloud API refers only to individual ports, but the UI uses this + * field when ordering a pair of ports, to prevent users from accidentally + * ordering something that is incompatible with their cloud provider. + * Specifically, when ordering a redundant pair of Cross-Cloud Interconnect + * ports, and one of them uses a remote location with + * portPairMatchingRemoteLocation set to matching, the UI requires that + * both ports use the same remote location. * Check the PortPairRemoteLocation enum for the list of possible values. * * Generated from protobuf field optional string port_pair_remote_location = 495917351; @@ -95,7 +153,8 @@ public function setPortPairRemoteLocation($var) } /** - * [Output Only] Port pair VLAN constraints, which can take one of the following values: PORT_PAIR_UNCONSTRAINED_VLAN, PORT_PAIR_MATCHING_VLAN + * [Output Only] Port pair VLAN constraints, which can take one of the + * following values: PORT_PAIR_UNCONSTRAINED_VLAN, PORT_PAIR_MATCHING_VLAN * Check the PortPairVlan enum for the list of possible values. * * Generated from protobuf field optional string port_pair_vlan = 478214506; @@ -117,7 +176,8 @@ public function clearPortPairVlan() } /** - * [Output Only] Port pair VLAN constraints, which can take one of the following values: PORT_PAIR_UNCONSTRAINED_VLAN, PORT_PAIR_MATCHING_VLAN + * [Output Only] Port pair VLAN constraints, which can take one of the + * following values: PORT_PAIR_UNCONSTRAINED_VLAN, PORT_PAIR_MATCHING_VLAN * Check the PortPairVlan enum for the list of possible values. * * Generated from protobuf field optional string port_pair_vlan = 478214506; @@ -133,7 +193,17 @@ public function setPortPairVlan($var) } /** - * [Output Only] [min-length, max-length] The minimum and maximum value (inclusive) for the IPv4 subnet length. For example, an interconnectRemoteLocation for Azure has {min: 30, max: 30} because Azure requires /30 subnets. This range specifies the values supported by both cloud providers. Interconnect currently supports /29 and /30 IPv4 subnet lengths. If a remote cloud has no constraint on IPv4 subnet length, the range would thus be {min: 29, max: 30}. + * [Output Only] + * [min-length, max-length] + * The minimum and maximum value (inclusive) for the IPv4 subnet + * length. + * For example, an interconnectRemoteLocation for Azure has {min: 30, + * max: + * 30} because Azure requires /30 subnets. + * This range specifies the values supported by both cloud providers. + * Interconnect currently supports /29 and /30 IPv4 subnet lengths. If a + * remote cloud has no constraint on IPv4 subnet length, the range would + * thus be {min: 29, max: 30}. * * Generated from protobuf field optional .google.cloud.compute.v1.InterconnectRemoteLocationConstraintsSubnetLengthRange subnet_length_range = 184473670; * @return \Google\Cloud\Compute\V1\InterconnectRemoteLocationConstraintsSubnetLengthRange|null @@ -154,7 +224,17 @@ public function clearSubnetLengthRange() } /** - * [Output Only] [min-length, max-length] The minimum and maximum value (inclusive) for the IPv4 subnet length. For example, an interconnectRemoteLocation for Azure has {min: 30, max: 30} because Azure requires /30 subnets. This range specifies the values supported by both cloud providers. Interconnect currently supports /29 and /30 IPv4 subnet lengths. If a remote cloud has no constraint on IPv4 subnet length, the range would thus be {min: 29, max: 30}. + * [Output Only] + * [min-length, max-length] + * The minimum and maximum value (inclusive) for the IPv4 subnet + * length. + * For example, an interconnectRemoteLocation for Azure has {min: 30, + * max: + * 30} because Azure requires /30 subnets. + * This range specifies the values supported by both cloud providers. + * Interconnect currently supports /29 and /30 IPv4 subnet lengths. If a + * remote cloud has no constraint on IPv4 subnet length, the range would + * thus be {min: 29, max: 30}. * * Generated from protobuf field optional .google.cloud.compute.v1.InterconnectRemoteLocationConstraintsSubnetLengthRange subnet_length_range = 184473670; * @param \Google\Cloud\Compute\V1\InterconnectRemoteLocationConstraintsSubnetLengthRange $var diff --git a/Compute/src/V1/InterconnectRemoteLocationConstraints/PortPairRemoteLocation.php b/Compute/src/V1/InterconnectRemoteLocationConstraints/PortPairRemoteLocation.php index 4e1a6aa68828..2dd0564a9eb3 100644 --- a/Compute/src/V1/InterconnectRemoteLocationConstraints/PortPairRemoteLocation.php +++ b/Compute/src/V1/InterconnectRemoteLocationConstraints/PortPairRemoteLocation.php @@ -7,7 +7,16 @@ use UnexpectedValueException; /** - * [Output Only] Port pair remote location constraints, which can take one of the following values: PORT_PAIR_UNCONSTRAINED_REMOTE_LOCATION, PORT_PAIR_MATCHING_REMOTE_LOCATION. Google Cloud API refers only to individual ports, but the UI uses this field when ordering a pair of ports, to prevent users from accidentally ordering something that is incompatible with their cloud provider. Specifically, when ordering a redundant pair of Cross-Cloud Interconnect ports, and one of them uses a remote location with portPairMatchingRemoteLocation set to matching, the UI requires that both ports use the same remote location. + * [Output Only] Port pair remote location constraints, which can take one + * of the following values: PORT_PAIR_UNCONSTRAINED_REMOTE_LOCATION, + * PORT_PAIR_MATCHING_REMOTE_LOCATION. + * Google Cloud API refers only to individual ports, but the UI uses this + * field when ordering a pair of ports, to prevent users from accidentally + * ordering something that is incompatible with their cloud provider. + * Specifically, when ordering a redundant pair of Cross-Cloud Interconnect + * ports, and one of them uses a remote location with + * portPairMatchingRemoteLocation set to matching, the UI requires that + * both ports use the same remote location. * * Protobuf type google.cloud.compute.v1.InterconnectRemoteLocationConstraints.PortPairRemoteLocation */ @@ -20,13 +29,17 @@ class PortPairRemoteLocation */ const UNDEFINED_PORT_PAIR_REMOTE_LOCATION = 0; /** - * If PORT_PAIR_MATCHING_REMOTE_LOCATION, the remote cloud provider allocates ports in pairs, and the user should choose the same remote location for both ports. + * If PORT_PAIR_MATCHING_REMOTE_LOCATION, the remote cloud provider + * allocates ports in pairs, and the user should choose the same remote + * location for both ports. * * Generated from protobuf enum PORT_PAIR_MATCHING_REMOTE_LOCATION = 207291859; */ const PORT_PAIR_MATCHING_REMOTE_LOCATION = 207291859; /** - * If PORT_PAIR_UNCONSTRAINED_REMOTE_LOCATION, a user may opt to provision a redundant pair of Cross-Cloud Interconnects using two different remote locations in the same city. + * If PORT_PAIR_UNCONSTRAINED_REMOTE_LOCATION, a user may opt to provision + * a redundant pair of Cross-Cloud Interconnects using two different + * remote locations in the same city. * * Generated from protobuf enum PORT_PAIR_UNCONSTRAINED_REMOTE_LOCATION = 60609829; */ diff --git a/Compute/src/V1/InterconnectRemoteLocationConstraints/PortPairVlan.php b/Compute/src/V1/InterconnectRemoteLocationConstraints/PortPairVlan.php index d9ce5d73982c..bce7341de028 100644 --- a/Compute/src/V1/InterconnectRemoteLocationConstraints/PortPairVlan.php +++ b/Compute/src/V1/InterconnectRemoteLocationConstraints/PortPairVlan.php @@ -7,7 +7,8 @@ use UnexpectedValueException; /** - * [Output Only] Port pair VLAN constraints, which can take one of the following values: PORT_PAIR_UNCONSTRAINED_VLAN, PORT_PAIR_MATCHING_VLAN + * [Output Only] Port pair VLAN constraints, which can take one of the + * following values: PORT_PAIR_UNCONSTRAINED_VLAN, PORT_PAIR_MATCHING_VLAN * * Protobuf type google.cloud.compute.v1.InterconnectRemoteLocationConstraints.PortPairVlan */ @@ -20,7 +21,12 @@ class PortPairVlan */ const UNDEFINED_PORT_PAIR_VLAN = 0; /** - * If PORT_PAIR_MATCHING_VLAN, the Interconnect for this attachment is part of a pair of ports that should have matching VLAN allocations. This occurs with Cross-Cloud Interconnect to Azure remote locations. While GCP's API does not explicitly group pairs of ports, the UI uses this field to ensure matching VLAN ids when configuring a redundant VLAN pair. + * If PORT_PAIR_MATCHING_VLAN, the Interconnect for this attachment is + * part of a pair of ports that should have matching VLAN allocations. + * This occurs with Cross-Cloud Interconnect to Azure remote locations. + * While GCP's API does not explicitly group pairs of ports, the UI uses + * this field to ensure matching VLAN ids when configuring a redundant + * VLAN pair. * * Generated from protobuf enum PORT_PAIR_MATCHING_VLAN = 250295358; */ diff --git a/Compute/src/V1/InterconnectRemoteLocationList.php b/Compute/src/V1/InterconnectRemoteLocationList.php index 459b895aa566..300f20e660ae 100644 --- a/Compute/src/V1/InterconnectRemoteLocationList.php +++ b/Compute/src/V1/InterconnectRemoteLocationList.php @@ -9,7 +9,8 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Response to the list request, and contains a list of interconnect remote locations. + * Response to the list request, and contains a list of interconnect remote + * locations. * * Generated from protobuf message google.cloud.compute.v1.InterconnectRemoteLocationList */ @@ -28,13 +29,18 @@ class InterconnectRemoteLocationList extends \Google\Protobuf\Internal\Message */ private $items; /** - * [Output Only] Type of resource. Always compute#interconnectRemoteLocationList for lists of interconnect remote locations. + * [Output Only] Type of resource. Alwayscompute#interconnectRemoteLocationList for lists of + * interconnect remote locations. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] This token lets you get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token lets you get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -63,9 +69,14 @@ class InterconnectRemoteLocationList extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\InterconnectRemoteLocation>|\Google\Protobuf\Internal\RepeatedField $items * A list of InterconnectRemoteLocation resources. * @type string $kind - * [Output Only] Type of resource. Always compute#interconnectRemoteLocationList for lists of interconnect remote locations. + * [Output Only] Type of resource. Alwayscompute#interconnectRemoteLocationList for lists of + * interconnect remote locations. * @type string $next_page_token - * [Output Only] This token lets you get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token lets you get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type \Google\Cloud\Compute\V1\Warning $warning @@ -140,7 +151,8 @@ public function setItems($var) } /** - * [Output Only] Type of resource. Always compute#interconnectRemoteLocationList for lists of interconnect remote locations. + * [Output Only] Type of resource. Alwayscompute#interconnectRemoteLocationList for lists of + * interconnect remote locations. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -161,7 +173,8 @@ public function clearKind() } /** - * [Output Only] Type of resource. Always compute#interconnectRemoteLocationList for lists of interconnect remote locations. + * [Output Only] Type of resource. Alwayscompute#interconnectRemoteLocationList for lists of + * interconnect remote locations. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -176,7 +189,11 @@ public function setKind($var) } /** - * [Output Only] This token lets you get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token lets you get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -197,7 +214,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token lets you get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token lets you get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/InterconnectRemoteLocationPermittedConnections.php b/Compute/src/V1/InterconnectRemoteLocationPermittedConnections.php index 0e67b4f616c3..196733d8857d 100644 --- a/Compute/src/V1/InterconnectRemoteLocationPermittedConnections.php +++ b/Compute/src/V1/InterconnectRemoteLocationPermittedConnections.php @@ -15,7 +15,8 @@ class InterconnectRemoteLocationPermittedConnections extends \Google\Protobuf\Internal\Message { /** - * [Output Only] URL of an Interconnect location that is permitted to connect to this Interconnect remote location. + * [Output Only] URL of an Interconnect location that is permitted to + * connect to this Interconnect remote location. * * Generated from protobuf field optional string interconnect_location = 492235846; */ @@ -28,7 +29,8 @@ class InterconnectRemoteLocationPermittedConnections extends \Google\Protobuf\In * Optional. Data for populating the Message object. * * @type string $interconnect_location - * [Output Only] URL of an Interconnect location that is permitted to connect to this Interconnect remote location. + * [Output Only] URL of an Interconnect location that is permitted to + * connect to this Interconnect remote location. * } */ public function __construct($data = NULL) { @@ -37,7 +39,8 @@ public function __construct($data = NULL) { } /** - * [Output Only] URL of an Interconnect location that is permitted to connect to this Interconnect remote location. + * [Output Only] URL of an Interconnect location that is permitted to + * connect to this Interconnect remote location. * * Generated from protobuf field optional string interconnect_location = 492235846; * @return string @@ -58,7 +61,8 @@ public function clearInterconnectLocation() } /** - * [Output Only] URL of an Interconnect location that is permitted to connect to this Interconnect remote location. + * [Output Only] URL of an Interconnect location that is permitted to + * connect to this Interconnect remote location. * * Generated from protobuf field optional string interconnect_location = 492235846; * @param string $var diff --git a/Compute/src/V1/InvalidateCacheUrlMapRequest.php b/Compute/src/V1/InvalidateCacheUrlMapRequest.php index 16b88d157bb6..2837fd61b2f5 100644 --- a/Compute/src/V1/InvalidateCacheUrlMapRequest.php +++ b/Compute/src/V1/InvalidateCacheUrlMapRequest.php @@ -28,7 +28,17 @@ class InvalidateCacheUrlMapRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -68,7 +78,17 @@ public static function build(string $project, string $urlMap, \Google\Cloud\Comp * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $url_map * Name of the UrlMap scoping this request. * } @@ -141,7 +161,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -162,7 +192,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/Items.php b/Compute/src/V1/Items.php index 63a13da325f5..951968e30940 100644 --- a/Compute/src/V1/Items.php +++ b/Compute/src/V1/Items.php @@ -16,13 +16,20 @@ class Items extends \Google\Protobuf\Internal\Message { /** - * Key for the metadata entry. Keys must conform to the following regexp: [a-zA-Z0-9-_]+, and be less than 128 bytes in length. This is reflected as part of a URL in the metadata server. Additionally, to avoid ambiguity, keys must not conflict with any other metadata keys for the project. + * Key for the metadata entry. Keys must conform to the following + * regexp: [a-zA-Z0-9-_]+, and be less than 128 bytes in length. + * This is reflected as part of a URL in the metadata server. Additionally, to + * avoid ambiguity, keys must not conflict with any other metadata keys + * for the project. * * Generated from protobuf field optional string key = 106079; */ protected $key = null; /** - * Value for the metadata entry. These are free-form strings, and only have meaning as interpreted by the image running in the instance. The only restriction placed on values is that their size must be less than or equal to 262144 bytes (256 KiB). + * Value for the metadata entry. These are free-form strings, and only + * have meaning as interpreted by the image running in the instance. The + * only restriction placed on values is that their size must be less than + * or equal to 262144 bytes (256 KiB). * * Generated from protobuf field optional string value = 111972721; */ @@ -35,9 +42,16 @@ class Items extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $key - * Key for the metadata entry. Keys must conform to the following regexp: [a-zA-Z0-9-_]+, and be less than 128 bytes in length. This is reflected as part of a URL in the metadata server. Additionally, to avoid ambiguity, keys must not conflict with any other metadata keys for the project. + * Key for the metadata entry. Keys must conform to the following + * regexp: [a-zA-Z0-9-_]+, and be less than 128 bytes in length. + * This is reflected as part of a URL in the metadata server. Additionally, to + * avoid ambiguity, keys must not conflict with any other metadata keys + * for the project. * @type string $value - * Value for the metadata entry. These are free-form strings, and only have meaning as interpreted by the image running in the instance. The only restriction placed on values is that their size must be less than or equal to 262144 bytes (256 KiB). + * Value for the metadata entry. These are free-form strings, and only + * have meaning as interpreted by the image running in the instance. The + * only restriction placed on values is that their size must be less than + * or equal to 262144 bytes (256 KiB). * } */ public function __construct($data = NULL) { @@ -46,7 +60,11 @@ public function __construct($data = NULL) { } /** - * Key for the metadata entry. Keys must conform to the following regexp: [a-zA-Z0-9-_]+, and be less than 128 bytes in length. This is reflected as part of a URL in the metadata server. Additionally, to avoid ambiguity, keys must not conflict with any other metadata keys for the project. + * Key for the metadata entry. Keys must conform to the following + * regexp: [a-zA-Z0-9-_]+, and be less than 128 bytes in length. + * This is reflected as part of a URL in the metadata server. Additionally, to + * avoid ambiguity, keys must not conflict with any other metadata keys + * for the project. * * Generated from protobuf field optional string key = 106079; * @return string @@ -67,7 +85,11 @@ public function clearKey() } /** - * Key for the metadata entry. Keys must conform to the following regexp: [a-zA-Z0-9-_]+, and be less than 128 bytes in length. This is reflected as part of a URL in the metadata server. Additionally, to avoid ambiguity, keys must not conflict with any other metadata keys for the project. + * Key for the metadata entry. Keys must conform to the following + * regexp: [a-zA-Z0-9-_]+, and be less than 128 bytes in length. + * This is reflected as part of a URL in the metadata server. Additionally, to + * avoid ambiguity, keys must not conflict with any other metadata keys + * for the project. * * Generated from protobuf field optional string key = 106079; * @param string $var @@ -82,7 +104,10 @@ public function setKey($var) } /** - * Value for the metadata entry. These are free-form strings, and only have meaning as interpreted by the image running in the instance. The only restriction placed on values is that their size must be less than or equal to 262144 bytes (256 KiB). + * Value for the metadata entry. These are free-form strings, and only + * have meaning as interpreted by the image running in the instance. The + * only restriction placed on values is that their size must be less than + * or equal to 262144 bytes (256 KiB). * * Generated from protobuf field optional string value = 111972721; * @return string @@ -103,7 +128,10 @@ public function clearValue() } /** - * Value for the metadata entry. These are free-form strings, and only have meaning as interpreted by the image running in the instance. The only restriction placed on values is that their size must be less than or equal to 262144 bytes (256 KiB). + * Value for the metadata entry. These are free-form strings, and only + * have meaning as interpreted by the image running in the instance. The + * only restriction placed on values is that their size must be less than + * or equal to 262144 bytes (256 KiB). * * Generated from protobuf field optional string value = 111972721; * @param string $var diff --git a/Compute/src/V1/License.php b/Compute/src/V1/License.php index 9aab1796eea1..697f32ee377c 100644 --- a/Compute/src/V1/License.php +++ b/Compute/src/V1/License.php @@ -9,68 +9,83 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Represents a License resource. A License represents billing and aggregate usage data for public and marketplace images. *Caution* This resource is intended for use only by third-party partners who are creating Cloud Marketplace images. + * Represents a License resource. + * A License represents billing and aggregate usage data forpublic andmarketplace images. + * *Caution* This resource is intended for + * use only by third-party partners who are creatingCloud Marketplace + * images. * * Generated from protobuf message google.cloud.compute.v1.License */ class License extends \Google\Protobuf\Internal\Message { /** - * Specifies licenseCodes of licenses that can replace this license. Note: such replacements are allowed even if removable_from_disk is false. + * Specifies licenseCodes of licenses that can replace this license. Note: + * such replacements are allowed even if removable_from_disk is false. * * Generated from protobuf field repeated string allowed_replacement_licenses = 195677718; */ private $allowed_replacement_licenses; /** - * If true, this license can be appended to an existing disk's set of licenses. + * If true, this license can be appended to an existing disk's set of + * licenses. * * Generated from protobuf field optional bool appendable_to_disk = 16959254; */ protected $appendable_to_disk = null; /** - * [Output Only] Deprecated. This field no longer reflects whether a license charges a usage fee. + * [Output Only] Deprecated. This field no longer reflects whether a license + * charges a usage fee. * * Generated from protobuf field optional bool charges_use_fee = 372412622; */ protected $charges_use_fee = null; /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; */ protected $creation_timestamp = null; /** - * An optional textual description of the resource; provided by the client when the resource is created. + * An optional textual description of the resource; provided by the client + * when the resource is created. * * Generated from protobuf field optional string description = 422937596; */ protected $description = null; /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; */ protected $id = null; /** - * Specifies licenseCodes of licenses that are incompatible with this license. If a license is incompatible with this license, it cannot be attached to the same disk or image. + * Specifies licenseCodes of licenses that are incompatible with this license. + * If a license is incompatible with this license, it cannot be attached to + * the same disk or image. * * Generated from protobuf field repeated string incompatible_licenses = 334239768; */ private $incompatible_licenses; /** - * [Output Only] Type of resource. Always compute#license for licenses. + * [Output Only] Type of resource. Always compute#license for + * licenses. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] The unique code used to attach this license to images, snapshots, and disks. + * [Output Only] The unique code used to attach this license to images, + * snapshots, and disks. * * Generated from protobuf field optional uint64 license_code = 1467179; */ protected $license_code = null; /** - * If set, this license will be unable to be removed or replaced once attached to a disk until the minimum_retention period has passed. + * If set, this license will be unable to be removed or replaced once attached + * to a disk until the minimum_retention period has passed. * * Generated from protobuf field optional .google.cloud.compute.v1.Duration minimum_retention = 155398189; */ @@ -82,25 +97,30 @@ class License extends \Google\Protobuf\Internal\Message */ protected $multi_tenant_only = null; /** - * Name of the resource. The name must be 1-63 characters long and comply with RFC1035. + * Name of the resource. The name must be 1-63 characters long and + * comply withRFC1035. * * Generated from protobuf field optional string name = 3373707; */ protected $name = null; /** - * If true, indicates this is an OS license. Only one OS license can be attached to a disk or image at a time. + * If true, indicates this is an OS license. Only one OS license can be + * attached to a disk or image at a time. * * Generated from protobuf field optional bool os_license = 487986406; */ protected $os_license = null; /** - * If true, this license can be removed from a disk's set of licenses, with no replacement license needed. + * If true, this license can be removed from a disk's set of licenses, with no + * replacement license needed. * * Generated from protobuf field optional bool removable_from_disk = 25854638; */ protected $removable_from_disk = null; /** - * Specifies the set of permissible coattached licenseCodes of licenses that satisfy the coattachment requirement of this license. At least one license from the set must be attached to the same disk or image as this license. + * Specifies the set of permissible coattached licenseCodes of licenses that + * satisfy the coattachment requirement of this license. At least one license + * from the set must be attached to the same disk or image as this license. * * Generated from protobuf field repeated string required_coattached_licenses = 129195265; */ @@ -130,13 +150,15 @@ class License extends \Google\Protobuf\Internal\Message */ protected $sole_tenant_only = null; /** - * If false, licenses will not be copied from the source resource when creating an image from a disk, disk from snapshot, or snapshot from disk. + * If false, licenses will not be copied from the source resource when + * creating an image from a disk, disk from snapshot, or snapshot from disk. * * Generated from protobuf field optional bool transferable = 4349893; */ protected $transferable = null; /** - * [Output Only] Last update timestamp in RFC3339 text format. + * [Output Only] Last update timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string update_timestamp = 120894752; */ @@ -149,35 +171,51 @@ class License extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type array|\Google\Protobuf\Internal\RepeatedField $allowed_replacement_licenses - * Specifies licenseCodes of licenses that can replace this license. Note: such replacements are allowed even if removable_from_disk is false. + * Specifies licenseCodes of licenses that can replace this license. Note: + * such replacements are allowed even if removable_from_disk is false. * @type bool $appendable_to_disk - * If true, this license can be appended to an existing disk's set of licenses. + * If true, this license can be appended to an existing disk's set of + * licenses. * @type bool $charges_use_fee - * [Output Only] Deprecated. This field no longer reflects whether a license charges a usage fee. + * [Output Only] Deprecated. This field no longer reflects whether a license + * charges a usage fee. * @type string $creation_timestamp - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * @type string $description - * An optional textual description of the resource; provided by the client when the resource is created. + * An optional textual description of the resource; provided by the client + * when the resource is created. * @type int|string $id - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * @type array|\Google\Protobuf\Internal\RepeatedField $incompatible_licenses - * Specifies licenseCodes of licenses that are incompatible with this license. If a license is incompatible with this license, it cannot be attached to the same disk or image. + * Specifies licenseCodes of licenses that are incompatible with this license. + * If a license is incompatible with this license, it cannot be attached to + * the same disk or image. * @type string $kind - * [Output Only] Type of resource. Always compute#license for licenses. + * [Output Only] Type of resource. Always compute#license for + * licenses. * @type int|string $license_code - * [Output Only] The unique code used to attach this license to images, snapshots, and disks. + * [Output Only] The unique code used to attach this license to images, + * snapshots, and disks. * @type \Google\Cloud\Compute\V1\Duration $minimum_retention - * If set, this license will be unable to be removed or replaced once attached to a disk until the minimum_retention period has passed. + * If set, this license will be unable to be removed or replaced once attached + * to a disk until the minimum_retention period has passed. * @type bool $multi_tenant_only * If true, this license can only be used on VMs on multi tenant nodes. * @type string $name - * Name of the resource. The name must be 1-63 characters long and comply with RFC1035. + * Name of the resource. The name must be 1-63 characters long and + * comply withRFC1035. * @type bool $os_license - * If true, indicates this is an OS license. Only one OS license can be attached to a disk or image at a time. + * If true, indicates this is an OS license. Only one OS license can be + * attached to a disk or image at a time. * @type bool $removable_from_disk - * If true, this license can be removed from a disk's set of licenses, with no replacement license needed. + * If true, this license can be removed from a disk's set of licenses, with no + * replacement license needed. * @type array|\Google\Protobuf\Internal\RepeatedField $required_coattached_licenses - * Specifies the set of permissible coattached licenseCodes of licenses that satisfy the coattachment requirement of this license. At least one license from the set must be attached to the same disk or image as this license. + * Specifies the set of permissible coattached licenseCodes of licenses that + * satisfy the coattachment requirement of this license. At least one license + * from the set must be attached to the same disk or image as this license. * @type \Google\Cloud\Compute\V1\LicenseResourceRequirements $resource_requirements * [Input Only] Deprecated. * @type string $self_link @@ -187,9 +225,11 @@ class License extends \Google\Protobuf\Internal\Message * @type bool $sole_tenant_only * If true, this license can only be used on VMs on sole tenant nodes. * @type bool $transferable - * If false, licenses will not be copied from the source resource when creating an image from a disk, disk from snapshot, or snapshot from disk. + * If false, licenses will not be copied from the source resource when + * creating an image from a disk, disk from snapshot, or snapshot from disk. * @type string $update_timestamp - * [Output Only] Last update timestamp in RFC3339 text format. + * [Output Only] Last update timestamp inRFC3339 + * text format. * } */ public function __construct($data = NULL) { @@ -198,7 +238,8 @@ public function __construct($data = NULL) { } /** - * Specifies licenseCodes of licenses that can replace this license. Note: such replacements are allowed even if removable_from_disk is false. + * Specifies licenseCodes of licenses that can replace this license. Note: + * such replacements are allowed even if removable_from_disk is false. * * Generated from protobuf field repeated string allowed_replacement_licenses = 195677718; * @return \Google\Protobuf\Internal\RepeatedField @@ -209,7 +250,8 @@ public function getAllowedReplacementLicenses() } /** - * Specifies licenseCodes of licenses that can replace this license. Note: such replacements are allowed even if removable_from_disk is false. + * Specifies licenseCodes of licenses that can replace this license. Note: + * such replacements are allowed even if removable_from_disk is false. * * Generated from protobuf field repeated string allowed_replacement_licenses = 195677718; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -224,7 +266,8 @@ public function setAllowedReplacementLicenses($var) } /** - * If true, this license can be appended to an existing disk's set of licenses. + * If true, this license can be appended to an existing disk's set of + * licenses. * * Generated from protobuf field optional bool appendable_to_disk = 16959254; * @return bool @@ -245,7 +288,8 @@ public function clearAppendableToDisk() } /** - * If true, this license can be appended to an existing disk's set of licenses. + * If true, this license can be appended to an existing disk's set of + * licenses. * * Generated from protobuf field optional bool appendable_to_disk = 16959254; * @param bool $var @@ -260,7 +304,8 @@ public function setAppendableToDisk($var) } /** - * [Output Only] Deprecated. This field no longer reflects whether a license charges a usage fee. + * [Output Only] Deprecated. This field no longer reflects whether a license + * charges a usage fee. * * Generated from protobuf field optional bool charges_use_fee = 372412622; * @return bool @@ -281,7 +326,8 @@ public function clearChargesUseFee() } /** - * [Output Only] Deprecated. This field no longer reflects whether a license charges a usage fee. + * [Output Only] Deprecated. This field no longer reflects whether a license + * charges a usage fee. * * Generated from protobuf field optional bool charges_use_fee = 372412622; * @param bool $var @@ -296,7 +342,8 @@ public function setChargesUseFee($var) } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @return string @@ -317,7 +364,8 @@ public function clearCreationTimestamp() } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @param string $var @@ -332,7 +380,8 @@ public function setCreationTimestamp($var) } /** - * An optional textual description of the resource; provided by the client when the resource is created. + * An optional textual description of the resource; provided by the client + * when the resource is created. * * Generated from protobuf field optional string description = 422937596; * @return string @@ -353,7 +402,8 @@ public function clearDescription() } /** - * An optional textual description of the resource; provided by the client when the resource is created. + * An optional textual description of the resource; provided by the client + * when the resource is created. * * Generated from protobuf field optional string description = 422937596; * @param string $var @@ -368,7 +418,8 @@ public function setDescription($var) } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @return int|string @@ -389,7 +440,8 @@ public function clearId() } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @param int|string $var @@ -404,7 +456,9 @@ public function setId($var) } /** - * Specifies licenseCodes of licenses that are incompatible with this license. If a license is incompatible with this license, it cannot be attached to the same disk or image. + * Specifies licenseCodes of licenses that are incompatible with this license. + * If a license is incompatible with this license, it cannot be attached to + * the same disk or image. * * Generated from protobuf field repeated string incompatible_licenses = 334239768; * @return \Google\Protobuf\Internal\RepeatedField @@ -415,7 +469,9 @@ public function getIncompatibleLicenses() } /** - * Specifies licenseCodes of licenses that are incompatible with this license. If a license is incompatible with this license, it cannot be attached to the same disk or image. + * Specifies licenseCodes of licenses that are incompatible with this license. + * If a license is incompatible with this license, it cannot be attached to + * the same disk or image. * * Generated from protobuf field repeated string incompatible_licenses = 334239768; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -430,7 +486,8 @@ public function setIncompatibleLicenses($var) } /** - * [Output Only] Type of resource. Always compute#license for licenses. + * [Output Only] Type of resource. Always compute#license for + * licenses. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -451,7 +508,8 @@ public function clearKind() } /** - * [Output Only] Type of resource. Always compute#license for licenses. + * [Output Only] Type of resource. Always compute#license for + * licenses. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -466,7 +524,8 @@ public function setKind($var) } /** - * [Output Only] The unique code used to attach this license to images, snapshots, and disks. + * [Output Only] The unique code used to attach this license to images, + * snapshots, and disks. * * Generated from protobuf field optional uint64 license_code = 1467179; * @return int|string @@ -487,7 +546,8 @@ public function clearLicenseCode() } /** - * [Output Only] The unique code used to attach this license to images, snapshots, and disks. + * [Output Only] The unique code used to attach this license to images, + * snapshots, and disks. * * Generated from protobuf field optional uint64 license_code = 1467179; * @param int|string $var @@ -502,7 +562,8 @@ public function setLicenseCode($var) } /** - * If set, this license will be unable to be removed or replaced once attached to a disk until the minimum_retention period has passed. + * If set, this license will be unable to be removed or replaced once attached + * to a disk until the minimum_retention period has passed. * * Generated from protobuf field optional .google.cloud.compute.v1.Duration minimum_retention = 155398189; * @return \Google\Cloud\Compute\V1\Duration|null @@ -523,7 +584,8 @@ public function clearMinimumRetention() } /** - * If set, this license will be unable to be removed or replaced once attached to a disk until the minimum_retention period has passed. + * If set, this license will be unable to be removed or replaced once attached + * to a disk until the minimum_retention period has passed. * * Generated from protobuf field optional .google.cloud.compute.v1.Duration minimum_retention = 155398189; * @param \Google\Cloud\Compute\V1\Duration $var @@ -574,7 +636,8 @@ public function setMultiTenantOnly($var) } /** - * Name of the resource. The name must be 1-63 characters long and comply with RFC1035. + * Name of the resource. The name must be 1-63 characters long and + * comply withRFC1035. * * Generated from protobuf field optional string name = 3373707; * @return string @@ -595,7 +658,8 @@ public function clearName() } /** - * Name of the resource. The name must be 1-63 characters long and comply with RFC1035. + * Name of the resource. The name must be 1-63 characters long and + * comply withRFC1035. * * Generated from protobuf field optional string name = 3373707; * @param string $var @@ -610,7 +674,8 @@ public function setName($var) } /** - * If true, indicates this is an OS license. Only one OS license can be attached to a disk or image at a time. + * If true, indicates this is an OS license. Only one OS license can be + * attached to a disk or image at a time. * * Generated from protobuf field optional bool os_license = 487986406; * @return bool @@ -631,7 +696,8 @@ public function clearOsLicense() } /** - * If true, indicates this is an OS license. Only one OS license can be attached to a disk or image at a time. + * If true, indicates this is an OS license. Only one OS license can be + * attached to a disk or image at a time. * * Generated from protobuf field optional bool os_license = 487986406; * @param bool $var @@ -646,7 +712,8 @@ public function setOsLicense($var) } /** - * If true, this license can be removed from a disk's set of licenses, with no replacement license needed. + * If true, this license can be removed from a disk's set of licenses, with no + * replacement license needed. * * Generated from protobuf field optional bool removable_from_disk = 25854638; * @return bool @@ -667,7 +734,8 @@ public function clearRemovableFromDisk() } /** - * If true, this license can be removed from a disk's set of licenses, with no replacement license needed. + * If true, this license can be removed from a disk's set of licenses, with no + * replacement license needed. * * Generated from protobuf field optional bool removable_from_disk = 25854638; * @param bool $var @@ -682,7 +750,9 @@ public function setRemovableFromDisk($var) } /** - * Specifies the set of permissible coattached licenseCodes of licenses that satisfy the coattachment requirement of this license. At least one license from the set must be attached to the same disk or image as this license. + * Specifies the set of permissible coattached licenseCodes of licenses that + * satisfy the coattachment requirement of this license. At least one license + * from the set must be attached to the same disk or image as this license. * * Generated from protobuf field repeated string required_coattached_licenses = 129195265; * @return \Google\Protobuf\Internal\RepeatedField @@ -693,7 +763,9 @@ public function getRequiredCoattachedLicenses() } /** - * Specifies the set of permissible coattached licenseCodes of licenses that satisfy the coattachment requirement of this license. At least one license from the set must be attached to the same disk or image as this license. + * Specifies the set of permissible coattached licenseCodes of licenses that + * satisfy the coattachment requirement of this license. At least one license + * from the set must be attached to the same disk or image as this license. * * Generated from protobuf field repeated string required_coattached_licenses = 129195265; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -852,7 +924,8 @@ public function setSoleTenantOnly($var) } /** - * If false, licenses will not be copied from the source resource when creating an image from a disk, disk from snapshot, or snapshot from disk. + * If false, licenses will not be copied from the source resource when + * creating an image from a disk, disk from snapshot, or snapshot from disk. * * Generated from protobuf field optional bool transferable = 4349893; * @return bool @@ -873,7 +946,8 @@ public function clearTransferable() } /** - * If false, licenses will not be copied from the source resource when creating an image from a disk, disk from snapshot, or snapshot from disk. + * If false, licenses will not be copied from the source resource when + * creating an image from a disk, disk from snapshot, or snapshot from disk. * * Generated from protobuf field optional bool transferable = 4349893; * @param bool $var @@ -888,7 +962,8 @@ public function setTransferable($var) } /** - * [Output Only] Last update timestamp in RFC3339 text format. + * [Output Only] Last update timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string update_timestamp = 120894752; * @return string @@ -909,7 +984,8 @@ public function clearUpdateTimestamp() } /** - * [Output Only] Last update timestamp in RFC3339 text format. + * [Output Only] Last update timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string update_timestamp = 120894752; * @param string $var diff --git a/Compute/src/V1/LicenseCode.php b/Compute/src/V1/LicenseCode.php index bf1e88e4bc73..47580a9cceb9 100644 --- a/Compute/src/V1/LicenseCode.php +++ b/Compute/src/V1/LicenseCode.php @@ -9,14 +9,20 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Represents a License Code resource. A License Code is a unique identifier used to represent a license resource. *Caution* This resource is intended for use only by third-party partners who are creating Cloud Marketplace images. + * Represents a License Code resource. + * A License Code is a unique identifier used to represent alicense + * resource. + * *Caution* This resource is intended for + * use only by third-party partners who are creatingCloud Marketplace + * images. * * Generated from protobuf message google.cloud.compute.v1.LicenseCode */ class LicenseCode extends \Google\Protobuf\Internal\Message { /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; */ @@ -28,25 +34,29 @@ class LicenseCode extends \Google\Protobuf\Internal\Message */ protected $description = null; /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; */ protected $id = null; /** - * [Output Only] Type of resource. Always compute#licenseCode for licenses. + * [Output Only] Type of resource. Always compute#licenseCode for + * licenses. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] URL and description aliases of Licenses with the same License Code. + * [Output Only] URL and description aliases of Licenses with the same + * License Code. * * Generated from protobuf field repeated .google.cloud.compute.v1.LicenseCodeLicenseAlias license_alias = 43550930; */ private $license_alias; /** - * [Output Only] Name of the resource. The name is 1-20 characters long and must be a valid 64 bit integer. + * [Output Only] Name of the resource. The name is 1-20 characters long and + * must be a valid 64 bit integer. * * Generated from protobuf field optional string name = 3373707; */ @@ -65,7 +75,8 @@ class LicenseCode extends \Google\Protobuf\Internal\Message */ protected $state = null; /** - * [Output Only] If true, the license will remain attached when creating images or snapshots from disks. Otherwise, the license is not transferred. + * [Output Only] If true, the license will remain attached when creating + * images or snapshots from disks. Otherwise, the license is not transferred. * * Generated from protobuf field optional bool transferable = 4349893; */ @@ -78,24 +89,30 @@ class LicenseCode extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $creation_timestamp - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * @type string $description * [Output Only] Description of this License Code. * @type int|string $id - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * @type string $kind - * [Output Only] Type of resource. Always compute#licenseCode for licenses. + * [Output Only] Type of resource. Always compute#licenseCode for + * licenses. * @type array<\Google\Cloud\Compute\V1\LicenseCodeLicenseAlias>|\Google\Protobuf\Internal\RepeatedField $license_alias - * [Output Only] URL and description aliases of Licenses with the same License Code. + * [Output Only] URL and description aliases of Licenses with the same + * License Code. * @type string $name - * [Output Only] Name of the resource. The name is 1-20 characters long and must be a valid 64 bit integer. + * [Output Only] Name of the resource. The name is 1-20 characters long and + * must be a valid 64 bit integer. * @type string $self_link * [Output Only] Server-defined URL for the resource. * @type string $state * [Output Only] Current state of this License Code. * Check the State enum for the list of possible values. * @type bool $transferable - * [Output Only] If true, the license will remain attached when creating images or snapshots from disks. Otherwise, the license is not transferred. + * [Output Only] If true, the license will remain attached when creating + * images or snapshots from disks. Otherwise, the license is not transferred. * } */ public function __construct($data = NULL) { @@ -104,7 +121,8 @@ public function __construct($data = NULL) { } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @return string @@ -125,7 +143,8 @@ public function clearCreationTimestamp() } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @param string $var @@ -176,7 +195,8 @@ public function setDescription($var) } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @return int|string @@ -197,7 +217,8 @@ public function clearId() } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @param int|string $var @@ -212,7 +233,8 @@ public function setId($var) } /** - * [Output Only] Type of resource. Always compute#licenseCode for licenses. + * [Output Only] Type of resource. Always compute#licenseCode for + * licenses. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -233,7 +255,8 @@ public function clearKind() } /** - * [Output Only] Type of resource. Always compute#licenseCode for licenses. + * [Output Only] Type of resource. Always compute#licenseCode for + * licenses. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -248,7 +271,8 @@ public function setKind($var) } /** - * [Output Only] URL and description aliases of Licenses with the same License Code. + * [Output Only] URL and description aliases of Licenses with the same + * License Code. * * Generated from protobuf field repeated .google.cloud.compute.v1.LicenseCodeLicenseAlias license_alias = 43550930; * @return \Google\Protobuf\Internal\RepeatedField @@ -259,7 +283,8 @@ public function getLicenseAlias() } /** - * [Output Only] URL and description aliases of Licenses with the same License Code. + * [Output Only] URL and description aliases of Licenses with the same + * License Code. * * Generated from protobuf field repeated .google.cloud.compute.v1.LicenseCodeLicenseAlias license_alias = 43550930; * @param array<\Google\Cloud\Compute\V1\LicenseCodeLicenseAlias>|\Google\Protobuf\Internal\RepeatedField $var @@ -274,7 +299,8 @@ public function setLicenseAlias($var) } /** - * [Output Only] Name of the resource. The name is 1-20 characters long and must be a valid 64 bit integer. + * [Output Only] Name of the resource. The name is 1-20 characters long and + * must be a valid 64 bit integer. * * Generated from protobuf field optional string name = 3373707; * @return string @@ -295,7 +321,8 @@ public function clearName() } /** - * [Output Only] Name of the resource. The name is 1-20 characters long and must be a valid 64 bit integer. + * [Output Only] Name of the resource. The name is 1-20 characters long and + * must be a valid 64 bit integer. * * Generated from protobuf field optional string name = 3373707; * @param string $var @@ -384,7 +411,8 @@ public function setState($var) } /** - * [Output Only] If true, the license will remain attached when creating images or snapshots from disks. Otherwise, the license is not transferred. + * [Output Only] If true, the license will remain attached when creating + * images or snapshots from disks. Otherwise, the license is not transferred. * * Generated from protobuf field optional bool transferable = 4349893; * @return bool @@ -405,7 +433,8 @@ public function clearTransferable() } /** - * [Output Only] If true, the license will remain attached when creating images or snapshots from disks. Otherwise, the license is not transferred. + * [Output Only] If true, the license will remain attached when creating + * images or snapshots from disks. Otherwise, the license is not transferred. * * Generated from protobuf field optional bool transferable = 4349893; * @param bool $var diff --git a/Compute/src/V1/LicenseCode/State.php b/Compute/src/V1/LicenseCode/State.php index 074fedfad79b..151a73fbd37a 100644 --- a/Compute/src/V1/LicenseCode/State.php +++ b/Compute/src/V1/LicenseCode/State.php @@ -20,7 +20,8 @@ class State */ const UNDEFINED_STATE = 0; /** - * Machines are not allowed to attach boot disks with this License Code. Requests to create new resources with this license will be rejected. + * Machines are not allowed to attach boot disks with this License Code. + * Requests to create new resources with this license will be rejected. * * Generated from protobuf enum DISABLED = 516696700; */ diff --git a/Compute/src/V1/LicenseResourceRequirements.php b/Compute/src/V1/LicenseResourceRequirements.php index 7ddcf0591af2..d2b29284d484 100644 --- a/Compute/src/V1/LicenseResourceRequirements.php +++ b/Compute/src/V1/LicenseResourceRequirements.php @@ -15,13 +15,15 @@ class LicenseResourceRequirements extends \Google\Protobuf\Internal\Message { /** - * [Input Only] Deprecated. This field no longer reflects the minimum number of guest cpus required to use the Instance. + * [Input Only] Deprecated. This field no longer reflects the minimum number + * of guest cpus required to use the Instance. * * Generated from protobuf field optional int32 min_guest_cpu_count = 477964836; */ protected $min_guest_cpu_count = null; /** - * [Input Only] Deprecated. This field no longer reflects the minimum memory required to use the Instance. + * [Input Only] Deprecated. This field no longer reflects the minimum memory + * required to use the Instance. * * Generated from protobuf field optional int32 min_memory_mb = 504785894; */ @@ -34,9 +36,11 @@ class LicenseResourceRequirements extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type int $min_guest_cpu_count - * [Input Only] Deprecated. This field no longer reflects the minimum number of guest cpus required to use the Instance. + * [Input Only] Deprecated. This field no longer reflects the minimum number + * of guest cpus required to use the Instance. * @type int $min_memory_mb - * [Input Only] Deprecated. This field no longer reflects the minimum memory required to use the Instance. + * [Input Only] Deprecated. This field no longer reflects the minimum memory + * required to use the Instance. * } */ public function __construct($data = NULL) { @@ -45,7 +49,8 @@ public function __construct($data = NULL) { } /** - * [Input Only] Deprecated. This field no longer reflects the minimum number of guest cpus required to use the Instance. + * [Input Only] Deprecated. This field no longer reflects the minimum number + * of guest cpus required to use the Instance. * * Generated from protobuf field optional int32 min_guest_cpu_count = 477964836; * @return int @@ -66,7 +71,8 @@ public function clearMinGuestCpuCount() } /** - * [Input Only] Deprecated. This field no longer reflects the minimum number of guest cpus required to use the Instance. + * [Input Only] Deprecated. This field no longer reflects the minimum number + * of guest cpus required to use the Instance. * * Generated from protobuf field optional int32 min_guest_cpu_count = 477964836; * @param int $var @@ -81,7 +87,8 @@ public function setMinGuestCpuCount($var) } /** - * [Input Only] Deprecated. This field no longer reflects the minimum memory required to use the Instance. + * [Input Only] Deprecated. This field no longer reflects the minimum memory + * required to use the Instance. * * Generated from protobuf field optional int32 min_memory_mb = 504785894; * @return int @@ -102,7 +109,8 @@ public function clearMinMemoryMb() } /** - * [Input Only] Deprecated. This field no longer reflects the minimum memory required to use the Instance. + * [Input Only] Deprecated. This field no longer reflects the minimum memory + * required to use the Instance. * * Generated from protobuf field optional int32 min_memory_mb = 504785894; * @param int $var diff --git a/Compute/src/V1/LicensesListResponse.php b/Compute/src/V1/LicensesListResponse.php index 8c1c8cd3eec8..7d0bae2696e7 100644 --- a/Compute/src/V1/LicensesListResponse.php +++ b/Compute/src/V1/LicensesListResponse.php @@ -27,7 +27,11 @@ class LicensesListResponse extends \Google\Protobuf\Internal\Message */ private $items; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -56,7 +60,11 @@ class LicensesListResponse extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\License>|\Google\Protobuf\Internal\RepeatedField $items * A list of License resources. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type \Google\Cloud\Compute\V1\Warning $warning @@ -131,7 +139,11 @@ public function setItems($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -152,7 +164,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/ListAcceleratorTypesRequest.php b/Compute/src/V1/ListAcceleratorTypesRequest.php index 74a7cc24e213..e519a4506ace 100644 --- a/Compute/src/V1/ListAcceleratorTypesRequest.php +++ b/Compute/src/V1/ListAcceleratorTypesRequest.php @@ -16,25 +16,86 @@ class ListAcceleratorTypesRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -46,7 +107,11 @@ class ListAcceleratorTypesRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -80,17 +145,82 @@ public static function build(string $project, string $zone): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * @type string $zone * The name of the zone for this request. * } @@ -101,7 +231,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -122,7 +299,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -137,7 +361,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -158,7 +386,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -173,7 +405,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -194,7 +434,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -209,7 +457,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -230,7 +480,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -271,7 +523,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -292,7 +548,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListAddressesRequest.php b/Compute/src/V1/ListAddressesRequest.php index 921669735ce3..31455b37231a 100644 --- a/Compute/src/V1/ListAddressesRequest.php +++ b/Compute/src/V1/ListAddressesRequest.php @@ -16,25 +16,86 @@ class ListAddressesRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -52,7 +113,11 @@ class ListAddressesRequest extends \Google\Protobuf\Internal\Message */ protected $region = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -80,19 +145,84 @@ public static function build(string $project, string $region): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type string $region * Name of the region for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * } */ public function __construct($data = NULL) { @@ -101,7 +231,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -122,7 +299,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -137,7 +361,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -158,7 +386,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -173,7 +405,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -194,7 +434,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -209,7 +457,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -230,7 +480,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -297,7 +549,11 @@ public function setRegion($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -318,7 +574,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListAssociationsFirewallPolicyRequest.php b/Compute/src/V1/ListAssociationsFirewallPolicyRequest.php index 1288003172eb..e7eb001800c3 100644 --- a/Compute/src/V1/ListAssociationsFirewallPolicyRequest.php +++ b/Compute/src/V1/ListAssociationsFirewallPolicyRequest.php @@ -16,7 +16,8 @@ class ListAssociationsFirewallPolicyRequest extends \Google\Protobuf\Internal\Message { /** - * The target resource to list associations. It is an organization, or a folder. + * The target resource to list associations. It is an organization, or a + * folder. * * Generated from protobuf field optional string target_resource = 467318524; */ @@ -29,7 +30,8 @@ class ListAssociationsFirewallPolicyRequest extends \Google\Protobuf\Internal\Me * Optional. Data for populating the Message object. * * @type string $target_resource - * The target resource to list associations. It is an organization, or a folder. + * The target resource to list associations. It is an organization, or a + * folder. * } */ public function __construct($data = NULL) { @@ -38,7 +40,8 @@ public function __construct($data = NULL) { } /** - * The target resource to list associations. It is an organization, or a folder. + * The target resource to list associations. It is an organization, or a + * folder. * * Generated from protobuf field optional string target_resource = 467318524; * @return string @@ -59,7 +62,8 @@ public function clearTargetResource() } /** - * The target resource to list associations. It is an organization, or a folder. + * The target resource to list associations. It is an organization, or a + * folder. * * Generated from protobuf field optional string target_resource = 467318524; * @param string $var diff --git a/Compute/src/V1/ListAssociationsOrganizationSecurityPolicyRequest.php b/Compute/src/V1/ListAssociationsOrganizationSecurityPolicyRequest.php index bfbf089d63bf..9280aaf6ab27 100644 --- a/Compute/src/V1/ListAssociationsOrganizationSecurityPolicyRequest.php +++ b/Compute/src/V1/ListAssociationsOrganizationSecurityPolicyRequest.php @@ -16,7 +16,8 @@ class ListAssociationsOrganizationSecurityPolicyRequest extends \Google\Protobuf\Internal\Message { /** - * The target resource to list associations. It is an organization, or a folder. + * The target resource to list associations. It is an organization, or a + * folder. * * Generated from protobuf field optional string target_resource = 467318524; */ @@ -29,7 +30,8 @@ class ListAssociationsOrganizationSecurityPolicyRequest extends \Google\Protobuf * Optional. Data for populating the Message object. * * @type string $target_resource - * The target resource to list associations. It is an organization, or a folder. + * The target resource to list associations. It is an organization, or a + * folder. * } */ public function __construct($data = NULL) { @@ -38,7 +40,8 @@ public function __construct($data = NULL) { } /** - * The target resource to list associations. It is an organization, or a folder. + * The target resource to list associations. It is an organization, or a + * folder. * * Generated from protobuf field optional string target_resource = 467318524; * @return string @@ -59,7 +62,8 @@ public function clearTargetResource() } /** - * The target resource to list associations. It is an organization, or a folder. + * The target resource to list associations. It is an organization, or a + * folder. * * Generated from protobuf field optional string target_resource = 467318524; * @param string $var diff --git a/Compute/src/V1/ListAutoscalersRequest.php b/Compute/src/V1/ListAutoscalersRequest.php index 945a6cde7bc2..ba640c8b9784 100644 --- a/Compute/src/V1/ListAutoscalersRequest.php +++ b/Compute/src/V1/ListAutoscalersRequest.php @@ -16,25 +16,86 @@ class ListAutoscalersRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -46,7 +107,11 @@ class ListAutoscalersRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -80,17 +145,82 @@ public static function build(string $project, string $zone): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * @type string $zone * Name of the zone for this request. * } @@ -101,7 +231,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -122,7 +299,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -137,7 +361,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -158,7 +386,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -173,7 +405,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -194,7 +434,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -209,7 +457,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -230,7 +480,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -271,7 +523,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -292,7 +548,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListAvailableFeaturesRegionSslPoliciesRequest.php b/Compute/src/V1/ListAvailableFeaturesRegionSslPoliciesRequest.php index 8a5440e1194e..25fe70bf5801 100644 --- a/Compute/src/V1/ListAvailableFeaturesRegionSslPoliciesRequest.php +++ b/Compute/src/V1/ListAvailableFeaturesRegionSslPoliciesRequest.php @@ -16,25 +16,86 @@ class ListAvailableFeaturesRegionSslPoliciesRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -52,7 +113,11 @@ class ListAvailableFeaturesRegionSslPoliciesRequest extends \Google\Protobuf\Int */ protected $region = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -80,19 +145,84 @@ public static function build(string $project, string $region): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type string $region * Name of the region scoping this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * } */ public function __construct($data = NULL) { @@ -101,7 +231,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -122,7 +299,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -137,7 +361,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -158,7 +386,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -173,7 +405,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -194,7 +434,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -209,7 +457,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -230,7 +480,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -297,7 +549,11 @@ public function setRegion($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -318,7 +574,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListAvailableFeaturesSslPoliciesRequest.php b/Compute/src/V1/ListAvailableFeaturesSslPoliciesRequest.php index 0ea329e82c7d..67b751a5cd9d 100644 --- a/Compute/src/V1/ListAvailableFeaturesSslPoliciesRequest.php +++ b/Compute/src/V1/ListAvailableFeaturesSslPoliciesRequest.php @@ -16,25 +16,86 @@ class ListAvailableFeaturesSslPoliciesRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -46,7 +107,11 @@ class ListAvailableFeaturesSslPoliciesRequest extends \Google\Protobuf\Internal\ */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -72,17 +137,82 @@ public static function build(string $project): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * } */ public function __construct($data = NULL) { @@ -91,7 +221,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -112,7 +289,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -127,7 +351,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -148,7 +376,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -163,7 +395,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -184,7 +424,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -199,7 +447,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -220,7 +470,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -261,7 +513,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -282,7 +538,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListBackendBucketsRequest.php b/Compute/src/V1/ListBackendBucketsRequest.php index fa2447588155..c27e20962017 100644 --- a/Compute/src/V1/ListBackendBucketsRequest.php +++ b/Compute/src/V1/ListBackendBucketsRequest.php @@ -16,25 +16,86 @@ class ListBackendBucketsRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -46,7 +107,11 @@ class ListBackendBucketsRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -72,17 +137,82 @@ public static function build(string $project): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * } */ public function __construct($data = NULL) { @@ -91,7 +221,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -112,7 +289,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -127,7 +351,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -148,7 +376,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -163,7 +395,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -184,7 +424,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -199,7 +447,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -220,7 +470,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -261,7 +513,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -282,7 +538,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListBackendServicesRequest.php b/Compute/src/V1/ListBackendServicesRequest.php index c3ab95da319e..d3e295d18563 100644 --- a/Compute/src/V1/ListBackendServicesRequest.php +++ b/Compute/src/V1/ListBackendServicesRequest.php @@ -16,25 +16,86 @@ class ListBackendServicesRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -46,7 +107,11 @@ class ListBackendServicesRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -72,17 +137,82 @@ public static function build(string $project): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * } */ public function __construct($data = NULL) { @@ -91,7 +221,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -112,7 +289,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -127,7 +351,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -148,7 +376,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -163,7 +395,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -184,7 +424,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -199,7 +447,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -220,7 +470,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -261,7 +513,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -282,7 +538,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListBgpRoutesRoutersRequest.php b/Compute/src/V1/ListBgpRoutesRoutersRequest.php index 701a48c9edf5..cda90a381449 100644 --- a/Compute/src/V1/ListBgpRoutesRoutersRequest.php +++ b/Compute/src/V1/ListBgpRoutesRoutersRequest.php @@ -29,37 +29,100 @@ class ListBgpRoutesRoutersRequest extends \Google\Protobuf\Internal\Message */ protected $destination_prefix = null; /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ protected $page_token = null; /** - * (Required) limit results to the BGP peer with the given name. Name should conform to RFC1035. + * (Required) limit results to the BGP peer with the given name. + * Name should conform to RFC1035. * * Generated from protobuf field optional string peer = 3436898; */ protected $peer = null; /** - * When true, the method returns post-policy routes. Otherwise, it returns pre-policy routes. + * When true, the method returns post-policy routes. Otherwise, it returns + * pre-policy routes. * * Generated from protobuf field optional bool policy_applied = 379464304; */ @@ -77,20 +140,26 @@ class ListBgpRoutesRoutersRequest extends \Google\Protobuf\Internal\Message */ protected $region = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ protected $return_partial_success = null; /** - * (Required) limit results to this type of route (either LEARNED or ADVERTISED) + * (Required) limit results to this type of route (either LEARNED or + * ADVERTISED) * Check the RouteType enum for the list of possible values. * * Generated from protobuf field optional string route_type = 375888752; */ protected $route_type = null; /** - * Name or id of the resource for this request. Name should conform to RFC1035. + * Name or id of the resource for this request. + * Name should conform to RFC1035. * * Generated from protobuf field string router = 148608841 [(.google.api.field_behavior) = REQUIRED]; */ @@ -99,7 +168,8 @@ class ListBgpRoutesRoutersRequest extends \Google\Protobuf\Internal\Message /** * @param string $project Project ID for this request. * @param string $region Name of the region for this request. - * @param string $router Name or id of the resource for this request. Name should conform to RFC1035. + * @param string $router Name or id of the resource for this request. + * Name should conform to RFC1035. * * @return \Google\Cloud\Compute\V1\ListBgpRoutesRoutersRequest * @@ -125,28 +195,97 @@ public static function build(string $project, string $region, string $router): s * @type string $destination_prefix * Limit results to destinations that are subnets of this CIDR range * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $peer - * (Required) limit results to the BGP peer with the given name. Name should conform to RFC1035. + * (Required) limit results to the BGP peer with the given name. + * Name should conform to RFC1035. * @type bool $policy_applied - * When true, the method returns post-policy routes. Otherwise, it returns pre-policy routes. + * When true, the method returns post-policy routes. Otherwise, it returns + * pre-policy routes. * @type string $project * Project ID for this request. * @type string $region * Name of the region for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * @type string $route_type - * (Required) limit results to this type of route (either LEARNED or ADVERTISED) + * (Required) limit results to this type of route (either LEARNED or + * ADVERTISED) * Check the RouteType enum for the list of possible values. * @type string $router - * Name or id of the resource for this request. Name should conform to RFC1035. + * Name or id of the resource for this request. + * Name should conform to RFC1035. * } */ public function __construct($data = NULL) { @@ -229,7 +368,54 @@ public function setDestinationPrefix($var) } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -250,7 +436,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -265,7 +498,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -286,7 +523,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -301,7 +542,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -322,7 +571,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -337,7 +594,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -358,7 +617,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -373,7 +634,8 @@ public function setPageToken($var) } /** - * (Required) limit results to the BGP peer with the given name. Name should conform to RFC1035. + * (Required) limit results to the BGP peer with the given name. + * Name should conform to RFC1035. * * Generated from protobuf field optional string peer = 3436898; * @return string @@ -394,7 +656,8 @@ public function clearPeer() } /** - * (Required) limit results to the BGP peer with the given name. Name should conform to RFC1035. + * (Required) limit results to the BGP peer with the given name. + * Name should conform to RFC1035. * * Generated from protobuf field optional string peer = 3436898; * @param string $var @@ -409,7 +672,8 @@ public function setPeer($var) } /** - * When true, the method returns post-policy routes. Otherwise, it returns pre-policy routes. + * When true, the method returns post-policy routes. Otherwise, it returns + * pre-policy routes. * * Generated from protobuf field optional bool policy_applied = 379464304; * @return bool @@ -430,7 +694,8 @@ public function clearPolicyApplied() } /** - * When true, the method returns post-policy routes. Otherwise, it returns pre-policy routes. + * When true, the method returns post-policy routes. Otherwise, it returns + * pre-policy routes. * * Generated from protobuf field optional bool policy_applied = 379464304; * @param bool $var @@ -497,7 +762,11 @@ public function setRegion($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -518,7 +787,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var @@ -533,7 +806,8 @@ public function setReturnPartialSuccess($var) } /** - * (Required) limit results to this type of route (either LEARNED or ADVERTISED) + * (Required) limit results to this type of route (either LEARNED or + * ADVERTISED) * Check the RouteType enum for the list of possible values. * * Generated from protobuf field optional string route_type = 375888752; @@ -555,7 +829,8 @@ public function clearRouteType() } /** - * (Required) limit results to this type of route (either LEARNED or ADVERTISED) + * (Required) limit results to this type of route (either LEARNED or + * ADVERTISED) * Check the RouteType enum for the list of possible values. * * Generated from protobuf field optional string route_type = 375888752; @@ -571,7 +846,8 @@ public function setRouteType($var) } /** - * Name or id of the resource for this request. Name should conform to RFC1035. + * Name or id of the resource for this request. + * Name should conform to RFC1035. * * Generated from protobuf field string router = 148608841 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -582,7 +858,8 @@ public function getRouter() } /** - * Name or id of the resource for this request. Name should conform to RFC1035. + * Name or id of the resource for this request. + * Name should conform to RFC1035. * * Generated from protobuf field string router = 148608841 [(.google.api.field_behavior) = REQUIRED]; * @param string $var diff --git a/Compute/src/V1/ListBgpRoutesRoutersRequest/RouteType.php b/Compute/src/V1/ListBgpRoutesRoutersRequest/RouteType.php index 11ffd98b4b88..6f2e8d8c5f5c 100644 --- a/Compute/src/V1/ListBgpRoutesRoutersRequest/RouteType.php +++ b/Compute/src/V1/ListBgpRoutesRoutersRequest/RouteType.php @@ -7,7 +7,8 @@ use UnexpectedValueException; /** - * (Required) limit results to this type of route (either LEARNED or ADVERTISED) + * (Required) limit results to this type of route (either LEARNED or + * ADVERTISED) * * Protobuf type google.cloud.compute.v1.ListBgpRoutesRoutersRequest.RouteType */ diff --git a/Compute/src/V1/ListCrossSiteNetworksRequest.php b/Compute/src/V1/ListCrossSiteNetworksRequest.php new file mode 100644 index 000000000000..cafb9a109d1a --- /dev/null +++ b/Compute/src/V1/ListCrossSiteNetworksRequest.php @@ -0,0 +1,560 @@ +google.cloud.compute.v1.ListCrossSiteNetworksRequest + */ +class ListCrossSiteNetworksRequest extends \Google\Protobuf\Internal\Message +{ + /** + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. + * + * Generated from protobuf field optional string filter = 336120696; + */ + protected $filter = null; + /** + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) + * + * Generated from protobuf field optional uint32 max_results = 54715419; + */ + protected $max_results = null; + /** + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. + * + * Generated from protobuf field optional string order_by = 160562920; + */ + protected $order_by = null; + /** + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. + * + * Generated from protobuf field optional string page_token = 19994697; + */ + protected $page_token = null; + /** + * Project ID for this request. + * + * Generated from protobuf field string project = 227560217 [(.google.api.field_behavior) = REQUIRED]; + */ + protected $project = ''; + /** + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. + * + * Generated from protobuf field optional bool return_partial_success = 517198390; + */ + protected $return_partial_success = null; + + /** + * @param string $project Project ID for this request. + * + * @return \Google\Cloud\Compute\V1\ListCrossSiteNetworksRequest + * + * @experimental + */ + public static function build(string $project): self + { + return (new self()) + ->setProject($project); + } + + /** + * Constructor. + * + * @param array $data { + * Optional. Data for populating the Message object. + * + * @type string $filter + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. + * @type int $max_results + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) + * @type string $order_by + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. + * @type string $page_token + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. + * @type string $project + * Project ID for this request. + * @type bool $return_partial_success + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. + * } + */ + public function __construct($data = NULL) { + \GPBMetadata\Google\Cloud\Compute\V1\Compute::initOnce(); + parent::__construct($data); + } + + /** + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. + * + * Generated from protobuf field optional string filter = 336120696; + * @return string + */ + public function getFilter() + { + return isset($this->filter) ? $this->filter : ''; + } + + public function hasFilter() + { + return isset($this->filter); + } + + public function clearFilter() + { + unset($this->filter); + } + + /** + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. + * + * Generated from protobuf field optional string filter = 336120696; + * @param string $var + * @return $this + */ + public function setFilter($var) + { + GPBUtil::checkString($var, True); + $this->filter = $var; + + return $this; + } + + /** + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) + * + * Generated from protobuf field optional uint32 max_results = 54715419; + * @return int + */ + public function getMaxResults() + { + return isset($this->max_results) ? $this->max_results : 0; + } + + public function hasMaxResults() + { + return isset($this->max_results); + } + + public function clearMaxResults() + { + unset($this->max_results); + } + + /** + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) + * + * Generated from protobuf field optional uint32 max_results = 54715419; + * @param int $var + * @return $this + */ + public function setMaxResults($var) + { + GPBUtil::checkUint32($var); + $this->max_results = $var; + + return $this; + } + + /** + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. + * + * Generated from protobuf field optional string order_by = 160562920; + * @return string + */ + public function getOrderBy() + { + return isset($this->order_by) ? $this->order_by : ''; + } + + public function hasOrderBy() + { + return isset($this->order_by); + } + + public function clearOrderBy() + { + unset($this->order_by); + } + + /** + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. + * + * Generated from protobuf field optional string order_by = 160562920; + * @param string $var + * @return $this + */ + public function setOrderBy($var) + { + GPBUtil::checkString($var, True); + $this->order_by = $var; + + return $this; + } + + /** + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. + * + * Generated from protobuf field optional string page_token = 19994697; + * @return string + */ + public function getPageToken() + { + return isset($this->page_token) ? $this->page_token : ''; + } + + public function hasPageToken() + { + return isset($this->page_token); + } + + public function clearPageToken() + { + unset($this->page_token); + } + + /** + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. + * + * Generated from protobuf field optional string page_token = 19994697; + * @param string $var + * @return $this + */ + public function setPageToken($var) + { + GPBUtil::checkString($var, True); + $this->page_token = $var; + + return $this; + } + + /** + * Project ID for this request. + * + * Generated from protobuf field string project = 227560217 [(.google.api.field_behavior) = REQUIRED]; + * @return string + */ + public function getProject() + { + return $this->project; + } + + /** + * Project ID for this request. + * + * Generated from protobuf field string project = 227560217 [(.google.api.field_behavior) = REQUIRED]; + * @param string $var + * @return $this + */ + public function setProject($var) + { + GPBUtil::checkString($var, True); + $this->project = $var; + + return $this; + } + + /** + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. + * + * Generated from protobuf field optional bool return_partial_success = 517198390; + * @return bool + */ + public function getReturnPartialSuccess() + { + return isset($this->return_partial_success) ? $this->return_partial_success : false; + } + + public function hasReturnPartialSuccess() + { + return isset($this->return_partial_success); + } + + public function clearReturnPartialSuccess() + { + unset($this->return_partial_success); + } + + /** + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. + * + * Generated from protobuf field optional bool return_partial_success = 517198390; + * @param bool $var + * @return $this + */ + public function setReturnPartialSuccess($var) + { + GPBUtil::checkBool($var); + $this->return_partial_success = $var; + + return $this; + } + +} + diff --git a/Compute/src/V1/ListDiskTypesRequest.php b/Compute/src/V1/ListDiskTypesRequest.php index 1258610254eb..f946cd48c327 100644 --- a/Compute/src/V1/ListDiskTypesRequest.php +++ b/Compute/src/V1/ListDiskTypesRequest.php @@ -16,25 +16,86 @@ class ListDiskTypesRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -46,7 +107,11 @@ class ListDiskTypesRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -80,17 +145,82 @@ public static function build(string $project, string $zone): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * @type string $zone * The name of the zone for this request. * } @@ -101,7 +231,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -122,7 +299,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -137,7 +361,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -158,7 +386,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -173,7 +405,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -194,7 +434,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -209,7 +457,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -230,7 +480,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -271,7 +523,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -292,7 +548,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListDisksRequest.php b/Compute/src/V1/ListDisksRequest.php index 4014f74ec7dd..a5b3f4e67c99 100644 --- a/Compute/src/V1/ListDisksRequest.php +++ b/Compute/src/V1/ListDisksRequest.php @@ -16,25 +16,86 @@ class ListDisksRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -46,7 +107,11 @@ class ListDisksRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -80,17 +145,82 @@ public static function build(string $project, string $zone): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * @type string $zone * The name of the zone for this request. * } @@ -101,7 +231,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -122,7 +299,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -137,7 +361,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -158,7 +386,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -173,7 +405,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -194,7 +434,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -209,7 +457,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -230,7 +480,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -271,7 +523,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -292,7 +548,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListDisksStoragePoolsRequest.php b/Compute/src/V1/ListDisksStoragePoolsRequest.php index 7f906cedf636..128777609454 100644 --- a/Compute/src/V1/ListDisksStoragePoolsRequest.php +++ b/Compute/src/V1/ListDisksStoragePoolsRequest.php @@ -16,25 +16,86 @@ class ListDisksStoragePoolsRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -46,7 +107,11 @@ class ListDisksStoragePoolsRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -88,17 +153,82 @@ public static function build(string $project, string $zone, string $storagePool) * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * @type string $storage_pool * Name of the storage pool to list disks of. * @type string $zone @@ -111,7 +241,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -132,7 +309,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -147,7 +371,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -168,7 +396,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -183,7 +415,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -204,7 +444,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -219,7 +467,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -240,7 +490,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -281,7 +533,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -302,7 +558,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListErrorsInstanceGroupManagersRequest.php b/Compute/src/V1/ListErrorsInstanceGroupManagersRequest.php index 4aa568422089..60957103a22c 100644 --- a/Compute/src/V1/ListErrorsInstanceGroupManagersRequest.php +++ b/Compute/src/V1/ListErrorsInstanceGroupManagersRequest.php @@ -16,31 +16,95 @@ class ListErrorsInstanceGroupManagersRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The name of the managed instance group. It must be a string that meets the requirements in RFC1035, or an unsigned long integer: must match regexp pattern: (?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?)|1-9{0,19}. + * The name of the managed instance group. + * It must be a string that meets the requirements in RFC1035, or an + * unsigned long integer: must match regexp pattern: + * (?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?)|1-9{0,19}. * * Generated from protobuf field string instance_group_manager = 249363395 [(.google.api.field_behavior) = REQUIRED]; */ protected $instance_group_manager = ''; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -52,13 +116,19 @@ class ListErrorsInstanceGroupManagersRequest extends \Google\Protobuf\Internal\M */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ protected $return_partial_success = null; /** - * The name of the zone where the managed instance group is located. It should conform to RFC1035. + * The name of thezone where the managed + * instance group is located. + * It should conform to RFC1035. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED]; */ @@ -66,8 +136,13 @@ class ListErrorsInstanceGroupManagersRequest extends \Google\Protobuf\Internal\M /** * @param string $project Project ID for this request. - * @param string $zone The name of the zone where the managed instance group is located. It should conform to RFC1035. - * @param string $instanceGroupManager The name of the managed instance group. It must be a string that meets the requirements in RFC1035, or an unsigned long integer: must match regexp pattern: (?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?)|1-9{0,19}. + * @param string $zone The name of thezone where the managed + * instance group is located. + * It should conform to RFC1035. + * @param string $instanceGroupManager The name of the managed instance group. + * It must be a string that meets the requirements in RFC1035, or an + * unsigned long integer: must match regexp pattern: + * (?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?)|1-9{0,19}. * * @return \Google\Cloud\Compute\V1\ListErrorsInstanceGroupManagersRequest * @@ -88,21 +163,91 @@ public static function build(string $project, string $zone, string $instanceGrou * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type string $instance_group_manager - * The name of the managed instance group. It must be a string that meets the requirements in RFC1035, or an unsigned long integer: must match regexp pattern: (?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?)|1-9{0,19}. + * The name of the managed instance group. + * It must be a string that meets the requirements in RFC1035, or an + * unsigned long integer: must match regexp pattern: + * (?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?)|1-9{0,19}. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * @type string $zone - * The name of the zone where the managed instance group is located. It should conform to RFC1035. + * The name of thezone where the managed + * instance group is located. + * It should conform to RFC1035. * } */ public function __construct($data = NULL) { @@ -111,7 +256,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -132,7 +324,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -147,7 +386,10 @@ public function setFilter($var) } /** - * The name of the managed instance group. It must be a string that meets the requirements in RFC1035, or an unsigned long integer: must match regexp pattern: (?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?)|1-9{0,19}. + * The name of the managed instance group. + * It must be a string that meets the requirements in RFC1035, or an + * unsigned long integer: must match regexp pattern: + * (?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?)|1-9{0,19}. * * Generated from protobuf field string instance_group_manager = 249363395 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -158,7 +400,10 @@ public function getInstanceGroupManager() } /** - * The name of the managed instance group. It must be a string that meets the requirements in RFC1035, or an unsigned long integer: must match regexp pattern: (?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?)|1-9{0,19}. + * The name of the managed instance group. + * It must be a string that meets the requirements in RFC1035, or an + * unsigned long integer: must match regexp pattern: + * (?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?)|1-9{0,19}. * * Generated from protobuf field string instance_group_manager = 249363395 [(.google.api.field_behavior) = REQUIRED]; * @param string $var @@ -173,7 +418,11 @@ public function setInstanceGroupManager($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -194,7 +443,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -209,7 +462,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -230,7 +491,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -245,7 +514,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -266,7 +537,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -307,7 +580,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -328,7 +605,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var @@ -343,7 +624,9 @@ public function setReturnPartialSuccess($var) } /** - * The name of the zone where the managed instance group is located. It should conform to RFC1035. + * The name of thezone where the managed + * instance group is located. + * It should conform to RFC1035. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -354,7 +637,9 @@ public function getZone() } /** - * The name of the zone where the managed instance group is located. It should conform to RFC1035. + * The name of thezone where the managed + * instance group is located. + * It should conform to RFC1035. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED]; * @param string $var diff --git a/Compute/src/V1/ListErrorsRegionInstanceGroupManagersRequest.php b/Compute/src/V1/ListErrorsRegionInstanceGroupManagersRequest.php index 50f23400d350..b9d33b60de9a 100644 --- a/Compute/src/V1/ListErrorsRegionInstanceGroupManagersRequest.php +++ b/Compute/src/V1/ListErrorsRegionInstanceGroupManagersRequest.php @@ -16,31 +16,95 @@ class ListErrorsRegionInstanceGroupManagersRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The name of the managed instance group. It must be a string that meets the requirements in RFC1035, or an unsigned long integer: must match regexp pattern: (?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?)|1-9{0,19}. + * The name of the managed instance group. + * It must be a string that meets the requirements in RFC1035, or an + * unsigned long integer: must match regexp pattern: + * (?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?)|1-9{0,19}. * * Generated from protobuf field string instance_group_manager = 249363395 [(.google.api.field_behavior) = REQUIRED]; */ protected $instance_group_manager = ''; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -52,13 +116,18 @@ class ListErrorsRegionInstanceGroupManagersRequest extends \Google\Protobuf\Inte */ protected $project = ''; /** - * Name of the region scoping this request. This should conform to RFC1035. + * Name of the region scoping this request. + * This should conform to RFC1035. * * Generated from protobuf field string region = 138946292 [(.google.api.field_behavior) = REQUIRED]; */ protected $region = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -66,8 +135,12 @@ class ListErrorsRegionInstanceGroupManagersRequest extends \Google\Protobuf\Inte /** * @param string $project Project ID for this request. - * @param string $region Name of the region scoping this request. This should conform to RFC1035. - * @param string $instanceGroupManager The name of the managed instance group. It must be a string that meets the requirements in RFC1035, or an unsigned long integer: must match regexp pattern: (?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?)|1-9{0,19}. + * @param string $region Name of the region scoping this request. + * This should conform to RFC1035. + * @param string $instanceGroupManager The name of the managed instance group. + * It must be a string that meets the requirements in RFC1035, or an + * unsigned long integer: must match regexp pattern: + * (?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?)|1-9{0,19}. * * @return \Google\Cloud\Compute\V1\ListErrorsRegionInstanceGroupManagersRequest * @@ -88,21 +161,90 @@ public static function build(string $project, string $region, string $instanceGr * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type string $instance_group_manager - * The name of the managed instance group. It must be a string that meets the requirements in RFC1035, or an unsigned long integer: must match regexp pattern: (?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?)|1-9{0,19}. + * The name of the managed instance group. + * It must be a string that meets the requirements in RFC1035, or an + * unsigned long integer: must match regexp pattern: + * (?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?)|1-9{0,19}. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type string $region - * Name of the region scoping this request. This should conform to RFC1035. + * Name of the region scoping this request. + * This should conform to RFC1035. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * } */ public function __construct($data = NULL) { @@ -111,7 +253,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -132,7 +321,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -147,7 +383,10 @@ public function setFilter($var) } /** - * The name of the managed instance group. It must be a string that meets the requirements in RFC1035, or an unsigned long integer: must match regexp pattern: (?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?)|1-9{0,19}. + * The name of the managed instance group. + * It must be a string that meets the requirements in RFC1035, or an + * unsigned long integer: must match regexp pattern: + * (?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?)|1-9{0,19}. * * Generated from protobuf field string instance_group_manager = 249363395 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -158,7 +397,10 @@ public function getInstanceGroupManager() } /** - * The name of the managed instance group. It must be a string that meets the requirements in RFC1035, or an unsigned long integer: must match regexp pattern: (?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?)|1-9{0,19}. + * The name of the managed instance group. + * It must be a string that meets the requirements in RFC1035, or an + * unsigned long integer: must match regexp pattern: + * (?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?)|1-9{0,19}. * * Generated from protobuf field string instance_group_manager = 249363395 [(.google.api.field_behavior) = REQUIRED]; * @param string $var @@ -173,7 +415,11 @@ public function setInstanceGroupManager($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -194,7 +440,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -209,7 +459,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -230,7 +488,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -245,7 +511,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -266,7 +534,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -307,7 +577,8 @@ public function setProject($var) } /** - * Name of the region scoping this request. This should conform to RFC1035. + * Name of the region scoping this request. + * This should conform to RFC1035. * * Generated from protobuf field string region = 138946292 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -318,7 +589,8 @@ public function getRegion() } /** - * Name of the region scoping this request. This should conform to RFC1035. + * Name of the region scoping this request. + * This should conform to RFC1035. * * Generated from protobuf field string region = 138946292 [(.google.api.field_behavior) = REQUIRED]; * @param string $var @@ -333,7 +605,11 @@ public function setRegion($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -354,7 +630,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListExternalVpnGatewaysRequest.php b/Compute/src/V1/ListExternalVpnGatewaysRequest.php index db77ca224c1a..243eeca98ed7 100644 --- a/Compute/src/V1/ListExternalVpnGatewaysRequest.php +++ b/Compute/src/V1/ListExternalVpnGatewaysRequest.php @@ -16,25 +16,86 @@ class ListExternalVpnGatewaysRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -46,7 +107,11 @@ class ListExternalVpnGatewaysRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -72,17 +137,82 @@ public static function build(string $project): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * } */ public function __construct($data = NULL) { @@ -91,7 +221,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -112,7 +289,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -127,7 +351,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -148,7 +376,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -163,7 +395,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -184,7 +424,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -199,7 +447,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -220,7 +470,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -261,7 +513,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -282,7 +538,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListFirewallPoliciesRequest.php b/Compute/src/V1/ListFirewallPoliciesRequest.php index 760b8674d943..96d7f26e852d 100644 --- a/Compute/src/V1/ListFirewallPoliciesRequest.php +++ b/Compute/src/V1/ListFirewallPoliciesRequest.php @@ -16,37 +16,104 @@ class ListFirewallPoliciesRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ protected $page_token = null; /** - * Parent ID for this request. The ID can be either be "folders/[FOLDER_ID]" if the parent is a folder or "organizations/[ORGANIZATION_ID]" if the parent is an organization. + * Parent ID for this request. The ID can be either be "folders/[FOLDER_ID]" + * if the parent is a folder or "organizations/[ORGANIZATION_ID]" if the + * parent is an organization. * * Generated from protobuf field optional string parent_id = 459714768; */ protected $parent_id = null; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -59,17 +126,84 @@ class ListFirewallPoliciesRequest extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $parent_id - * Parent ID for this request. The ID can be either be "folders/[FOLDER_ID]" if the parent is a folder or "organizations/[ORGANIZATION_ID]" if the parent is an organization. + * Parent ID for this request. The ID can be either be "folders/[FOLDER_ID]" + * if the parent is a folder or "organizations/[ORGANIZATION_ID]" if the + * parent is an organization. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * } */ public function __construct($data = NULL) { @@ -78,7 +212,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -99,7 +280,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -114,7 +342,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -135,7 +367,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -150,7 +386,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -171,7 +415,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -186,7 +438,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -207,7 +461,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -222,7 +478,9 @@ public function setPageToken($var) } /** - * Parent ID for this request. The ID can be either be "folders/[FOLDER_ID]" if the parent is a folder or "organizations/[ORGANIZATION_ID]" if the parent is an organization. + * Parent ID for this request. The ID can be either be "folders/[FOLDER_ID]" + * if the parent is a folder or "organizations/[ORGANIZATION_ID]" if the + * parent is an organization. * * Generated from protobuf field optional string parent_id = 459714768; * @return string @@ -243,7 +501,9 @@ public function clearParentId() } /** - * Parent ID for this request. The ID can be either be "folders/[FOLDER_ID]" if the parent is a folder or "organizations/[ORGANIZATION_ID]" if the parent is an organization. + * Parent ID for this request. The ID can be either be "folders/[FOLDER_ID]" + * if the parent is a folder or "organizations/[ORGANIZATION_ID]" if the + * parent is an organization. * * Generated from protobuf field optional string parent_id = 459714768; * @param string $var @@ -258,7 +518,11 @@ public function setParentId($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -279,7 +543,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListFirewallsRequest.php b/Compute/src/V1/ListFirewallsRequest.php index 0799c237ce71..29d53f4779fa 100644 --- a/Compute/src/V1/ListFirewallsRequest.php +++ b/Compute/src/V1/ListFirewallsRequest.php @@ -16,25 +16,86 @@ class ListFirewallsRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -46,7 +107,11 @@ class ListFirewallsRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -72,17 +137,82 @@ public static function build(string $project): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * } */ public function __construct($data = NULL) { @@ -91,7 +221,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -112,7 +289,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -127,7 +351,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -148,7 +376,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -163,7 +395,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -184,7 +424,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -199,7 +447,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -220,7 +470,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -261,7 +513,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -282,7 +538,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListForwardingRulesRequest.php b/Compute/src/V1/ListForwardingRulesRequest.php index 1ba7dd7a13c7..7f8cc9646631 100644 --- a/Compute/src/V1/ListForwardingRulesRequest.php +++ b/Compute/src/V1/ListForwardingRulesRequest.php @@ -16,25 +16,86 @@ class ListForwardingRulesRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -52,7 +113,11 @@ class ListForwardingRulesRequest extends \Google\Protobuf\Internal\Message */ protected $region = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -80,19 +145,84 @@ public static function build(string $project, string $region): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type string $region * Name of the region scoping this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * } */ public function __construct($data = NULL) { @@ -101,7 +231,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -122,7 +299,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -137,7 +361,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -158,7 +386,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -173,7 +405,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -194,7 +434,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -209,7 +457,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -230,7 +480,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -297,7 +549,11 @@ public function setRegion($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -318,7 +574,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListFutureReservationsRequest.php b/Compute/src/V1/ListFutureReservationsRequest.php new file mode 100644 index 000000000000..792c3a4c154d --- /dev/null +++ b/Compute/src/V1/ListFutureReservationsRequest.php @@ -0,0 +1,596 @@ +google.cloud.compute.v1.ListFutureReservationsRequest + */ +class ListFutureReservationsRequest extends \Google\Protobuf\Internal\Message +{ + /** + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. + * + * Generated from protobuf field optional string filter = 336120696; + */ + protected $filter = null; + /** + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) + * + * Generated from protobuf field optional uint32 max_results = 54715419; + */ + protected $max_results = null; + /** + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. + * + * Generated from protobuf field optional string order_by = 160562920; + */ + protected $order_by = null; + /** + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. + * + * Generated from protobuf field optional string page_token = 19994697; + */ + protected $page_token = null; + /** + * Project ID for this request. + * + * Generated from protobuf field string project = 227560217 [(.google.api.field_behavior) = REQUIRED]; + */ + protected $project = ''; + /** + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. + * + * Generated from protobuf field optional bool return_partial_success = 517198390; + */ + protected $return_partial_success = null; + /** + * Name of the zone for this request. Name should conform to RFC1035. + * + * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED]; + */ + protected $zone = ''; + + /** + * @param string $project Project ID for this request. + * @param string $zone Name of the zone for this request. Name should conform to RFC1035. + * + * @return \Google\Cloud\Compute\V1\ListFutureReservationsRequest + * + * @experimental + */ + public static function build(string $project, string $zone): self + { + return (new self()) + ->setProject($project) + ->setZone($zone); + } + + /** + * Constructor. + * + * @param array $data { + * Optional. Data for populating the Message object. + * + * @type string $filter + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. + * @type int $max_results + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) + * @type string $order_by + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. + * @type string $page_token + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. + * @type string $project + * Project ID for this request. + * @type bool $return_partial_success + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. + * @type string $zone + * Name of the zone for this request. Name should conform to RFC1035. + * } + */ + public function __construct($data = NULL) { + \GPBMetadata\Google\Cloud\Compute\V1\Compute::initOnce(); + parent::__construct($data); + } + + /** + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. + * + * Generated from protobuf field optional string filter = 336120696; + * @return string + */ + public function getFilter() + { + return isset($this->filter) ? $this->filter : ''; + } + + public function hasFilter() + { + return isset($this->filter); + } + + public function clearFilter() + { + unset($this->filter); + } + + /** + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. + * + * Generated from protobuf field optional string filter = 336120696; + * @param string $var + * @return $this + */ + public function setFilter($var) + { + GPBUtil::checkString($var, True); + $this->filter = $var; + + return $this; + } + + /** + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) + * + * Generated from protobuf field optional uint32 max_results = 54715419; + * @return int + */ + public function getMaxResults() + { + return isset($this->max_results) ? $this->max_results : 0; + } + + public function hasMaxResults() + { + return isset($this->max_results); + } + + public function clearMaxResults() + { + unset($this->max_results); + } + + /** + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) + * + * Generated from protobuf field optional uint32 max_results = 54715419; + * @param int $var + * @return $this + */ + public function setMaxResults($var) + { + GPBUtil::checkUint32($var); + $this->max_results = $var; + + return $this; + } + + /** + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. + * + * Generated from protobuf field optional string order_by = 160562920; + * @return string + */ + public function getOrderBy() + { + return isset($this->order_by) ? $this->order_by : ''; + } + + public function hasOrderBy() + { + return isset($this->order_by); + } + + public function clearOrderBy() + { + unset($this->order_by); + } + + /** + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. + * + * Generated from protobuf field optional string order_by = 160562920; + * @param string $var + * @return $this + */ + public function setOrderBy($var) + { + GPBUtil::checkString($var, True); + $this->order_by = $var; + + return $this; + } + + /** + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. + * + * Generated from protobuf field optional string page_token = 19994697; + * @return string + */ + public function getPageToken() + { + return isset($this->page_token) ? $this->page_token : ''; + } + + public function hasPageToken() + { + return isset($this->page_token); + } + + public function clearPageToken() + { + unset($this->page_token); + } + + /** + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. + * + * Generated from protobuf field optional string page_token = 19994697; + * @param string $var + * @return $this + */ + public function setPageToken($var) + { + GPBUtil::checkString($var, True); + $this->page_token = $var; + + return $this; + } + + /** + * Project ID for this request. + * + * Generated from protobuf field string project = 227560217 [(.google.api.field_behavior) = REQUIRED]; + * @return string + */ + public function getProject() + { + return $this->project; + } + + /** + * Project ID for this request. + * + * Generated from protobuf field string project = 227560217 [(.google.api.field_behavior) = REQUIRED]; + * @param string $var + * @return $this + */ + public function setProject($var) + { + GPBUtil::checkString($var, True); + $this->project = $var; + + return $this; + } + + /** + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. + * + * Generated from protobuf field optional bool return_partial_success = 517198390; + * @return bool + */ + public function getReturnPartialSuccess() + { + return isset($this->return_partial_success) ? $this->return_partial_success : false; + } + + public function hasReturnPartialSuccess() + { + return isset($this->return_partial_success); + } + + public function clearReturnPartialSuccess() + { + unset($this->return_partial_success); + } + + /** + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. + * + * Generated from protobuf field optional bool return_partial_success = 517198390; + * @param bool $var + * @return $this + */ + public function setReturnPartialSuccess($var) + { + GPBUtil::checkBool($var); + $this->return_partial_success = $var; + + return $this; + } + + /** + * Name of the zone for this request. Name should conform to RFC1035. + * + * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED]; + * @return string + */ + public function getZone() + { + return $this->zone; + } + + /** + * Name of the zone for this request. Name should conform to RFC1035. + * + * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED]; + * @param string $var + * @return $this + */ + public function setZone($var) + { + GPBUtil::checkString($var, True); + $this->zone = $var; + + return $this; + } + +} + diff --git a/Compute/src/V1/ListGlobalAddressesRequest.php b/Compute/src/V1/ListGlobalAddressesRequest.php index cc2513d3798c..9dec8789e2d8 100644 --- a/Compute/src/V1/ListGlobalAddressesRequest.php +++ b/Compute/src/V1/ListGlobalAddressesRequest.php @@ -16,25 +16,86 @@ class ListGlobalAddressesRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -46,7 +107,11 @@ class ListGlobalAddressesRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -72,17 +137,82 @@ public static function build(string $project): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * } */ public function __construct($data = NULL) { @@ -91,7 +221,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -112,7 +289,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -127,7 +351,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -148,7 +376,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -163,7 +395,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -184,7 +424,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -199,7 +447,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -220,7 +470,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -261,7 +513,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -282,7 +538,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListGlobalForwardingRulesRequest.php b/Compute/src/V1/ListGlobalForwardingRulesRequest.php index e804e31b6ff2..caa27dae1084 100644 --- a/Compute/src/V1/ListGlobalForwardingRulesRequest.php +++ b/Compute/src/V1/ListGlobalForwardingRulesRequest.php @@ -16,25 +16,86 @@ class ListGlobalForwardingRulesRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -46,7 +107,11 @@ class ListGlobalForwardingRulesRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -72,17 +137,82 @@ public static function build(string $project): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * } */ public function __construct($data = NULL) { @@ -91,7 +221,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -112,7 +289,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -127,7 +351,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -148,7 +376,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -163,7 +395,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -184,7 +424,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -199,7 +447,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -220,7 +470,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -261,7 +513,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -282,7 +538,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListGlobalNetworkEndpointGroupsRequest.php b/Compute/src/V1/ListGlobalNetworkEndpointGroupsRequest.php index a69a715d4fa6..b74f447a779c 100644 --- a/Compute/src/V1/ListGlobalNetworkEndpointGroupsRequest.php +++ b/Compute/src/V1/ListGlobalNetworkEndpointGroupsRequest.php @@ -16,25 +16,86 @@ class ListGlobalNetworkEndpointGroupsRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -46,7 +107,11 @@ class ListGlobalNetworkEndpointGroupsRequest extends \Google\Protobuf\Internal\M */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -72,17 +137,82 @@ public static function build(string $project): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * } */ public function __construct($data = NULL) { @@ -91,7 +221,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -112,7 +289,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -127,7 +351,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -148,7 +376,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -163,7 +395,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -184,7 +424,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -199,7 +447,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -220,7 +470,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -261,7 +513,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -282,7 +538,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListGlobalOperationsRequest.php b/Compute/src/V1/ListGlobalOperationsRequest.php index e8d28ecf8298..55c3be3c3647 100644 --- a/Compute/src/V1/ListGlobalOperationsRequest.php +++ b/Compute/src/V1/ListGlobalOperationsRequest.php @@ -16,25 +16,86 @@ class ListGlobalOperationsRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -46,7 +107,11 @@ class ListGlobalOperationsRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -72,17 +137,82 @@ public static function build(string $project): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * } */ public function __construct($data = NULL) { @@ -91,7 +221,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -112,7 +289,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -127,7 +351,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -148,7 +376,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -163,7 +395,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -184,7 +424,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -199,7 +447,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -220,7 +470,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -261,7 +513,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -282,7 +538,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListGlobalOrganizationOperationsRequest.php b/Compute/src/V1/ListGlobalOrganizationOperationsRequest.php index 27eb17ea00c1..1e037228aaa4 100644 --- a/Compute/src/V1/ListGlobalOrganizationOperationsRequest.php +++ b/Compute/src/V1/ListGlobalOrganizationOperationsRequest.php @@ -16,25 +16,86 @@ class ListGlobalOrganizationOperationsRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -46,7 +107,11 @@ class ListGlobalOrganizationOperationsRequest extends \Google\Protobuf\Internal\ */ protected $parent_id = null; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -59,17 +124,82 @@ class ListGlobalOrganizationOperationsRequest extends \Google\Protobuf\Internal\ * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $parent_id * Parent ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * } */ public function __construct($data = NULL) { @@ -78,7 +208,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -99,7 +276,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -114,7 +338,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -135,7 +363,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -150,7 +382,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -171,7 +411,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -186,7 +434,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -207,7 +457,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -258,7 +510,11 @@ public function setParentId($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -279,7 +535,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListGlobalPublicDelegatedPrefixesRequest.php b/Compute/src/V1/ListGlobalPublicDelegatedPrefixesRequest.php index ffe88dd042a8..8b08d9ced005 100644 --- a/Compute/src/V1/ListGlobalPublicDelegatedPrefixesRequest.php +++ b/Compute/src/V1/ListGlobalPublicDelegatedPrefixesRequest.php @@ -16,25 +16,86 @@ class ListGlobalPublicDelegatedPrefixesRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -46,7 +107,11 @@ class ListGlobalPublicDelegatedPrefixesRequest extends \Google\Protobuf\Internal */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -72,17 +137,82 @@ public static function build(string $project): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * } */ public function __construct($data = NULL) { @@ -91,7 +221,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -112,7 +289,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -127,7 +351,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -148,7 +376,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -163,7 +395,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -184,7 +424,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -199,7 +447,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -220,7 +470,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -261,7 +513,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -282,7 +538,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListHealthChecksRequest.php b/Compute/src/V1/ListHealthChecksRequest.php index 70801cb8bbb9..d02d69b7d447 100644 --- a/Compute/src/V1/ListHealthChecksRequest.php +++ b/Compute/src/V1/ListHealthChecksRequest.php @@ -16,25 +16,86 @@ class ListHealthChecksRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -46,7 +107,11 @@ class ListHealthChecksRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -72,17 +137,82 @@ public static function build(string $project): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * } */ public function __construct($data = NULL) { @@ -91,7 +221,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -112,7 +289,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -127,7 +351,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -148,7 +376,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -163,7 +395,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -184,7 +424,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -199,7 +447,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -220,7 +470,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -261,7 +513,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -282,7 +538,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListImagesRequest.php b/Compute/src/V1/ListImagesRequest.php index 667a8affff17..57f81e3dfdda 100644 --- a/Compute/src/V1/ListImagesRequest.php +++ b/Compute/src/V1/ListImagesRequest.php @@ -16,25 +16,86 @@ class ListImagesRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -46,7 +107,11 @@ class ListImagesRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -72,17 +137,82 @@ public static function build(string $project): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * } */ public function __construct($data = NULL) { @@ -91,7 +221,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -112,7 +289,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -127,7 +351,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -148,7 +376,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -163,7 +395,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -184,7 +424,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -199,7 +447,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -220,7 +470,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -261,7 +513,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -282,7 +538,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListInstanceGroupManagerResizeRequestsRequest.php b/Compute/src/V1/ListInstanceGroupManagerResizeRequestsRequest.php index 48e48be47d2b..e79922f74d0c 100644 --- a/Compute/src/V1/ListInstanceGroupManagerResizeRequestsRequest.php +++ b/Compute/src/V1/ListInstanceGroupManagerResizeRequestsRequest.php @@ -16,7 +16,54 @@ class ListInstanceGroupManagerResizeRequestsRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ @@ -28,19 +75,33 @@ class ListInstanceGroupManagerResizeRequestsRequest extends \Google\Protobuf\Int */ protected $instance_group_manager = ''; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -52,13 +113,18 @@ class ListInstanceGroupManagerResizeRequestsRequest extends \Google\Protobuf\Int */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ protected $return_partial_success = null; /** - * The name of the zone where the managed instance group is located. The name should conform to RFC1035. + * The name of thezone where the managed + * instance group is located. The name should conform to RFC1035. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED]; */ @@ -66,7 +132,8 @@ class ListInstanceGroupManagerResizeRequestsRequest extends \Google\Protobuf\Int /** * @param string $project Project ID for this request. - * @param string $zone The name of the zone where the managed instance group is located. The name should conform to RFC1035. + * @param string $zone The name of thezone where the managed + * instance group is located. The name should conform to RFC1035. * @param string $instanceGroupManager The name of the managed instance group. The name should conform to RFC1035. * * @return \Google\Cloud\Compute\V1\ListInstanceGroupManagerResizeRequestsRequest @@ -88,21 +155,87 @@ public static function build(string $project, string $zone, string $instanceGrou * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type string $instance_group_manager * The name of the managed instance group. The name should conform to RFC1035. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * @type string $zone - * The name of the zone where the managed instance group is located. The name should conform to RFC1035. + * The name of thezone where the managed + * instance group is located. The name should conform to RFC1035. * } */ public function __construct($data = NULL) { @@ -111,7 +244,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -132,7 +312,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -173,7 +400,11 @@ public function setInstanceGroupManager($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -194,7 +425,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -209,7 +444,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -230,7 +473,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -245,7 +496,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -266,7 +519,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -307,7 +562,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -328,7 +587,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var @@ -343,7 +606,8 @@ public function setReturnPartialSuccess($var) } /** - * The name of the zone where the managed instance group is located. The name should conform to RFC1035. + * The name of thezone where the managed + * instance group is located. The name should conform to RFC1035. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -354,7 +618,8 @@ public function getZone() } /** - * The name of the zone where the managed instance group is located. The name should conform to RFC1035. + * The name of thezone where the managed + * instance group is located. The name should conform to RFC1035. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED]; * @param string $var diff --git a/Compute/src/V1/ListInstanceGroupManagersRequest.php b/Compute/src/V1/ListInstanceGroupManagersRequest.php index 737d68ab7e9f..66a974b16a03 100644 --- a/Compute/src/V1/ListInstanceGroupManagersRequest.php +++ b/Compute/src/V1/ListInstanceGroupManagersRequest.php @@ -16,25 +16,86 @@ class ListInstanceGroupManagersRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -46,13 +107,18 @@ class ListInstanceGroupManagersRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ protected $return_partial_success = null; /** - * The name of the zone where the managed instance group is located. + * The name of thezone where the managed + * instance group is located. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED]; */ @@ -60,7 +126,8 @@ class ListInstanceGroupManagersRequest extends \Google\Protobuf\Internal\Message /** * @param string $project Project ID for this request. - * @param string $zone The name of the zone where the managed instance group is located. + * @param string $zone The name of thezone where the managed + * instance group is located. * * @return \Google\Cloud\Compute\V1\ListInstanceGroupManagersRequest * @@ -80,19 +147,85 @@ public static function build(string $project, string $zone): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * @type string $zone - * The name of the zone where the managed instance group is located. + * The name of thezone where the managed + * instance group is located. * } */ public function __construct($data = NULL) { @@ -101,7 +234,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -122,7 +302,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -137,7 +364,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -158,7 +389,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -173,7 +408,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -194,7 +437,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -209,7 +460,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -230,7 +483,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -271,7 +526,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -292,7 +551,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var @@ -307,7 +570,8 @@ public function setReturnPartialSuccess($var) } /** - * The name of the zone where the managed instance group is located. + * The name of thezone where the managed + * instance group is located. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -318,7 +582,8 @@ public function getZone() } /** - * The name of the zone where the managed instance group is located. + * The name of thezone where the managed + * instance group is located. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED]; * @param string $var diff --git a/Compute/src/V1/ListInstanceGroupsRequest.php b/Compute/src/V1/ListInstanceGroupsRequest.php index 117824f3b3ba..6019b3f061d5 100644 --- a/Compute/src/V1/ListInstanceGroupsRequest.php +++ b/Compute/src/V1/ListInstanceGroupsRequest.php @@ -16,25 +16,86 @@ class ListInstanceGroupsRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -46,13 +107,18 @@ class ListInstanceGroupsRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ protected $return_partial_success = null; /** - * The name of the zone where the instance group is located. + * The name of thezone + * where the instance group is located. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED]; */ @@ -60,7 +126,8 @@ class ListInstanceGroupsRequest extends \Google\Protobuf\Internal\Message /** * @param string $project Project ID for this request. - * @param string $zone The name of the zone where the instance group is located. + * @param string $zone The name of thezone + * where the instance group is located. * * @return \Google\Cloud\Compute\V1\ListInstanceGroupsRequest * @@ -80,19 +147,85 @@ public static function build(string $project, string $zone): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * @type string $zone - * The name of the zone where the instance group is located. + * The name of thezone + * where the instance group is located. * } */ public function __construct($data = NULL) { @@ -101,7 +234,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -122,7 +302,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -137,7 +364,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -158,7 +389,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -173,7 +408,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -194,7 +437,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -209,7 +460,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -230,7 +483,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -271,7 +526,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -292,7 +551,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var @@ -307,7 +570,8 @@ public function setReturnPartialSuccess($var) } /** - * The name of the zone where the instance group is located. + * The name of thezone + * where the instance group is located. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -318,7 +582,8 @@ public function getZone() } /** - * The name of the zone where the instance group is located. + * The name of thezone + * where the instance group is located. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED]; * @param string $var diff --git a/Compute/src/V1/ListInstanceTemplatesRequest.php b/Compute/src/V1/ListInstanceTemplatesRequest.php index c78396944faf..f4f9d3352b56 100644 --- a/Compute/src/V1/ListInstanceTemplatesRequest.php +++ b/Compute/src/V1/ListInstanceTemplatesRequest.php @@ -16,25 +16,86 @@ class ListInstanceTemplatesRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -46,7 +107,11 @@ class ListInstanceTemplatesRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -72,17 +137,82 @@ public static function build(string $project): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * } */ public function __construct($data = NULL) { @@ -91,7 +221,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -112,7 +289,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -127,7 +351,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -148,7 +376,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -163,7 +395,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -184,7 +424,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -199,7 +447,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -220,7 +470,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -261,7 +513,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -282,7 +538,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListInstancesInstanceGroupsRequest.php b/Compute/src/V1/ListInstancesInstanceGroupsRequest.php index 6535930b3074..4dcc556e9fa4 100644 --- a/Compute/src/V1/ListInstancesInstanceGroupsRequest.php +++ b/Compute/src/V1/ListInstancesInstanceGroupsRequest.php @@ -16,13 +16,61 @@ class ListInstancesInstanceGroupsRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The name of the instance group from which you want to generate a list of included instances. + * The name of the instance group from which you want to generate a list + * of included instances. * * Generated from protobuf field string instance_group = 81095253 [(.google.api.field_behavior) = REQUIRED]; */ @@ -34,19 +82,33 @@ class ListInstancesInstanceGroupsRequest extends \Google\Protobuf\Internal\Messa */ protected $instance_groups_list_instances_request_resource = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -58,13 +120,18 @@ class ListInstancesInstanceGroupsRequest extends \Google\Protobuf\Internal\Messa */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ protected $return_partial_success = null; /** - * The name of the zone where the instance group is located. + * The name of the zone + * where the instance group is located. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED]; */ @@ -72,8 +139,10 @@ class ListInstancesInstanceGroupsRequest extends \Google\Protobuf\Internal\Messa /** * @param string $project Project ID for this request. - * @param string $zone The name of the zone where the instance group is located. - * @param string $instanceGroup The name of the instance group from which you want to generate a list of included instances. + * @param string $zone The name of the zone + * where the instance group is located. + * @param string $instanceGroup The name of the instance group from which you want to generate a list + * of included instances. * @param \Google\Cloud\Compute\V1\InstanceGroupsListInstancesRequest $instanceGroupsListInstancesRequestResource The body resource for this request * * @return \Google\Cloud\Compute\V1\ListInstancesInstanceGroupsRequest @@ -96,23 +165,90 @@ public static function build(string $project, string $zone, string $instanceGrou * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type string $instance_group - * The name of the instance group from which you want to generate a list of included instances. + * The name of the instance group from which you want to generate a list + * of included instances. * @type \Google\Cloud\Compute\V1\InstanceGroupsListInstancesRequest $instance_groups_list_instances_request_resource * The body resource for this request * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * @type string $zone - * The name of the zone where the instance group is located. + * The name of the zone + * where the instance group is located. * } */ public function __construct($data = NULL) { @@ -121,7 +257,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -142,7 +325,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -157,7 +387,8 @@ public function setFilter($var) } /** - * The name of the instance group from which you want to generate a list of included instances. + * The name of the instance group from which you want to generate a list + * of included instances. * * Generated from protobuf field string instance_group = 81095253 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -168,7 +399,8 @@ public function getInstanceGroup() } /** - * The name of the instance group from which you want to generate a list of included instances. + * The name of the instance group from which you want to generate a list + * of included instances. * * Generated from protobuf field string instance_group = 81095253 [(.google.api.field_behavior) = REQUIRED]; * @param string $var @@ -219,7 +451,11 @@ public function setInstanceGroupsListInstancesRequestResource($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -240,7 +476,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -255,7 +495,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -276,7 +524,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -291,7 +547,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -312,7 +570,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -353,7 +613,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -374,7 +638,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var @@ -389,7 +657,8 @@ public function setReturnPartialSuccess($var) } /** - * The name of the zone where the instance group is located. + * The name of the zone + * where the instance group is located. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -400,7 +669,8 @@ public function getZone() } /** - * The name of the zone where the instance group is located. + * The name of the zone + * where the instance group is located. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED]; * @param string $var diff --git a/Compute/src/V1/ListInstancesRegionInstanceGroupsRequest.php b/Compute/src/V1/ListInstancesRegionInstanceGroupsRequest.php index cc9291c2a0d1..53cb062df7ee 100644 --- a/Compute/src/V1/ListInstancesRegionInstanceGroupsRequest.php +++ b/Compute/src/V1/ListInstancesRegionInstanceGroupsRequest.php @@ -16,31 +16,93 @@ class ListInstancesRegionInstanceGroupsRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * Name of the regional instance group for which we want to list the instances. + * Name of the regional instance group for which we want to list the + * instances. * * Generated from protobuf field string instance_group = 81095253 [(.google.api.field_behavior) = REQUIRED]; */ protected $instance_group = ''; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -64,7 +126,11 @@ class ListInstancesRegionInstanceGroupsRequest extends \Google\Protobuf\Internal */ protected $region_instance_groups_list_instances_request_resource = null; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -73,7 +139,8 @@ class ListInstancesRegionInstanceGroupsRequest extends \Google\Protobuf\Internal /** * @param string $project Project ID for this request. * @param string $region Name of the region scoping this request. - * @param string $instanceGroup Name of the regional instance group for which we want to list the instances. + * @param string $instanceGroup Name of the regional instance group for which we want to list the + * instances. * @param \Google\Cloud\Compute\V1\RegionInstanceGroupsListInstancesRequest $regionInstanceGroupsListInstancesRequestResource The body resource for this request * * @return \Google\Cloud\Compute\V1\ListInstancesRegionInstanceGroupsRequest @@ -96,15 +163,77 @@ public static function build(string $project, string $region, string $instanceGr * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type string $instance_group - * Name of the regional instance group for which we want to list the instances. + * Name of the regional instance group for which we want to list the + * instances. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type string $region @@ -112,7 +241,11 @@ public static function build(string $project, string $region, string $instanceGr * @type \Google\Cloud\Compute\V1\RegionInstanceGroupsListInstancesRequest $region_instance_groups_list_instances_request_resource * The body resource for this request * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * } */ public function __construct($data = NULL) { @@ -121,7 +254,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -142,7 +322,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -157,7 +384,8 @@ public function setFilter($var) } /** - * Name of the regional instance group for which we want to list the instances. + * Name of the regional instance group for which we want to list the + * instances. * * Generated from protobuf field string instance_group = 81095253 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -168,7 +396,8 @@ public function getInstanceGroup() } /** - * Name of the regional instance group for which we want to list the instances. + * Name of the regional instance group for which we want to list the + * instances. * * Generated from protobuf field string instance_group = 81095253 [(.google.api.field_behavior) = REQUIRED]; * @param string $var @@ -183,7 +412,11 @@ public function setInstanceGroup($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -204,7 +437,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -219,7 +456,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -240,7 +485,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -255,7 +508,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -276,7 +531,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -379,7 +636,11 @@ public function setRegionInstanceGroupsListInstancesRequestResource($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -400,7 +661,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListInstancesRequest.php b/Compute/src/V1/ListInstancesRequest.php index 96831a1794e2..759afc091e35 100644 --- a/Compute/src/V1/ListInstancesRequest.php +++ b/Compute/src/V1/ListInstancesRequest.php @@ -16,25 +16,86 @@ class ListInstancesRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -46,7 +107,11 @@ class ListInstancesRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -80,17 +145,82 @@ public static function build(string $project, string $zone): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * @type string $zone * The name of the zone for this request. * } @@ -101,7 +231,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -122,7 +299,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -137,7 +361,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -158,7 +386,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -173,7 +405,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -194,7 +434,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -209,7 +457,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -230,7 +480,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -271,7 +523,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -292,7 +548,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListInstantSnapshotsRequest.php b/Compute/src/V1/ListInstantSnapshotsRequest.php index 4dd5e4ec023c..134e0b50cdc3 100644 --- a/Compute/src/V1/ListInstantSnapshotsRequest.php +++ b/Compute/src/V1/ListInstantSnapshotsRequest.php @@ -16,25 +16,86 @@ class ListInstantSnapshotsRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -46,7 +107,11 @@ class ListInstantSnapshotsRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -80,17 +145,82 @@ public static function build(string $project, string $zone): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * @type string $zone * The name of the zone for this request. * } @@ -101,7 +231,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -122,7 +299,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -137,7 +361,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -158,7 +386,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -173,7 +405,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -194,7 +434,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -209,7 +457,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -230,7 +480,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -271,7 +523,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -292,7 +548,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListInterconnectAttachmentGroupsRequest.php b/Compute/src/V1/ListInterconnectAttachmentGroupsRequest.php index d12772207030..94e5b38f929c 100644 --- a/Compute/src/V1/ListInterconnectAttachmentGroupsRequest.php +++ b/Compute/src/V1/ListInterconnectAttachmentGroupsRequest.php @@ -16,25 +16,86 @@ class ListInterconnectAttachmentGroupsRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -46,7 +107,11 @@ class ListInterconnectAttachmentGroupsRequest extends \Google\Protobuf\Internal\ */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -72,17 +137,82 @@ public static function build(string $project): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * } */ public function __construct($data = NULL) { @@ -91,7 +221,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -112,7 +289,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -127,7 +351,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -148,7 +376,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -163,7 +395,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -184,7 +424,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -199,7 +447,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -220,7 +470,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -261,7 +513,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -282,7 +538,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListInterconnectAttachmentsRequest.php b/Compute/src/V1/ListInterconnectAttachmentsRequest.php index d359167ce977..22252efc6bec 100644 --- a/Compute/src/V1/ListInterconnectAttachmentsRequest.php +++ b/Compute/src/V1/ListInterconnectAttachmentsRequest.php @@ -16,25 +16,86 @@ class ListInterconnectAttachmentsRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -52,7 +113,11 @@ class ListInterconnectAttachmentsRequest extends \Google\Protobuf\Internal\Messa */ protected $region = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -80,19 +145,84 @@ public static function build(string $project, string $region): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type string $region * Name of the region for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * } */ public function __construct($data = NULL) { @@ -101,7 +231,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -122,7 +299,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -137,7 +361,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -158,7 +386,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -173,7 +405,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -194,7 +434,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -209,7 +457,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -230,7 +480,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -297,7 +549,11 @@ public function setRegion($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -318,7 +574,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListInterconnectGroupsRequest.php b/Compute/src/V1/ListInterconnectGroupsRequest.php index 5d914aee6344..10feca4a1c08 100644 --- a/Compute/src/V1/ListInterconnectGroupsRequest.php +++ b/Compute/src/V1/ListInterconnectGroupsRequest.php @@ -16,25 +16,86 @@ class ListInterconnectGroupsRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -46,7 +107,11 @@ class ListInterconnectGroupsRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -72,17 +137,82 @@ public static function build(string $project): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * } */ public function __construct($data = NULL) { @@ -91,7 +221,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -112,7 +289,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -127,7 +351,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -148,7 +376,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -163,7 +395,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -184,7 +424,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -199,7 +447,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -220,7 +470,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -261,7 +513,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -282,7 +538,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListInterconnectLocationsRequest.php b/Compute/src/V1/ListInterconnectLocationsRequest.php index b6c0762f167d..bfcfdf803a5f 100644 --- a/Compute/src/V1/ListInterconnectLocationsRequest.php +++ b/Compute/src/V1/ListInterconnectLocationsRequest.php @@ -16,25 +16,86 @@ class ListInterconnectLocationsRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -46,7 +107,11 @@ class ListInterconnectLocationsRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -72,17 +137,82 @@ public static function build(string $project): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * } */ public function __construct($data = NULL) { @@ -91,7 +221,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -112,7 +289,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -127,7 +351,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -148,7 +376,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -163,7 +395,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -184,7 +424,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -199,7 +447,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -220,7 +470,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -261,7 +513,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -282,7 +538,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListInterconnectRemoteLocationsRequest.php b/Compute/src/V1/ListInterconnectRemoteLocationsRequest.php index f25d40521b88..783a2c647952 100644 --- a/Compute/src/V1/ListInterconnectRemoteLocationsRequest.php +++ b/Compute/src/V1/ListInterconnectRemoteLocationsRequest.php @@ -16,25 +16,86 @@ class ListInterconnectRemoteLocationsRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -46,7 +107,11 @@ class ListInterconnectRemoteLocationsRequest extends \Google\Protobuf\Internal\M */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -72,17 +137,82 @@ public static function build(string $project): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * } */ public function __construct($data = NULL) { @@ -91,7 +221,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -112,7 +289,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -127,7 +351,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -148,7 +376,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -163,7 +395,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -184,7 +424,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -199,7 +447,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -220,7 +470,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -261,7 +513,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -282,7 +538,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListInterconnectsRequest.php b/Compute/src/V1/ListInterconnectsRequest.php index 47c06928bc77..d0db8fc44145 100644 --- a/Compute/src/V1/ListInterconnectsRequest.php +++ b/Compute/src/V1/ListInterconnectsRequest.php @@ -16,25 +16,86 @@ class ListInterconnectsRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -46,7 +107,11 @@ class ListInterconnectsRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -72,17 +137,82 @@ public static function build(string $project): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * } */ public function __construct($data = NULL) { @@ -91,7 +221,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -112,7 +289,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -127,7 +351,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -148,7 +376,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -163,7 +395,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -184,7 +424,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -199,7 +447,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -220,7 +470,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -261,7 +513,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -282,7 +538,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListLicensesRequest.php b/Compute/src/V1/ListLicensesRequest.php index 53f2618a69ce..33eb81b1b8f5 100644 --- a/Compute/src/V1/ListLicensesRequest.php +++ b/Compute/src/V1/ListLicensesRequest.php @@ -16,25 +16,86 @@ class ListLicensesRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -46,7 +107,11 @@ class ListLicensesRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -72,17 +137,82 @@ public static function build(string $project): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * } */ public function __construct($data = NULL) { @@ -91,7 +221,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -112,7 +289,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -127,7 +351,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -148,7 +376,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -163,7 +395,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -184,7 +424,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -199,7 +447,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -220,7 +470,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -261,7 +513,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -282,7 +538,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListMachineImagesRequest.php b/Compute/src/V1/ListMachineImagesRequest.php index 466c80b452f8..a130c6c1ea9f 100644 --- a/Compute/src/V1/ListMachineImagesRequest.php +++ b/Compute/src/V1/ListMachineImagesRequest.php @@ -16,25 +16,86 @@ class ListMachineImagesRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -46,7 +107,11 @@ class ListMachineImagesRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -72,17 +137,82 @@ public static function build(string $project): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * } */ public function __construct($data = NULL) { @@ -91,7 +221,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -112,7 +289,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -127,7 +351,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -148,7 +376,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -163,7 +395,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -184,7 +424,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -199,7 +447,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -220,7 +470,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -261,7 +513,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -282,7 +538,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListMachineTypesRequest.php b/Compute/src/V1/ListMachineTypesRequest.php index 5f7c044fd729..bbb32cf1c4f5 100644 --- a/Compute/src/V1/ListMachineTypesRequest.php +++ b/Compute/src/V1/ListMachineTypesRequest.php @@ -16,25 +16,86 @@ class ListMachineTypesRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -46,7 +107,11 @@ class ListMachineTypesRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -80,17 +145,82 @@ public static function build(string $project, string $zone): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * @type string $zone * The name of the zone for this request. * } @@ -101,7 +231,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -122,7 +299,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -137,7 +361,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -158,7 +386,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -173,7 +405,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -194,7 +434,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -209,7 +457,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -230,7 +480,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -271,7 +523,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -292,7 +548,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListManagedInstancesInstanceGroupManagersRequest.php b/Compute/src/V1/ListManagedInstancesInstanceGroupManagersRequest.php index b951a55c6874..46c547b47d00 100644 --- a/Compute/src/V1/ListManagedInstancesInstanceGroupManagersRequest.php +++ b/Compute/src/V1/ListManagedInstancesInstanceGroupManagersRequest.php @@ -16,7 +16,54 @@ class ListManagedInstancesInstanceGroupManagersRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ @@ -28,19 +75,33 @@ class ListManagedInstancesInstanceGroupManagersRequest extends \Google\Protobuf\ */ protected $instance_group_manager = ''; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -52,13 +113,18 @@ class ListManagedInstancesInstanceGroupManagersRequest extends \Google\Protobuf\ */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ protected $return_partial_success = null; /** - * The name of the zone where the managed instance group is located. + * The name of thezone where the managed + * instance group is located. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED]; */ @@ -66,7 +132,8 @@ class ListManagedInstancesInstanceGroupManagersRequest extends \Google\Protobuf\ /** * @param string $project Project ID for this request. - * @param string $zone The name of the zone where the managed instance group is located. + * @param string $zone The name of thezone where the managed + * instance group is located. * @param string $instanceGroupManager The name of the managed instance group. * * @return \Google\Cloud\Compute\V1\ListManagedInstancesInstanceGroupManagersRequest @@ -88,21 +155,87 @@ public static function build(string $project, string $zone, string $instanceGrou * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type string $instance_group_manager * The name of the managed instance group. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * @type string $zone - * The name of the zone where the managed instance group is located. + * The name of thezone where the managed + * instance group is located. * } */ public function __construct($data = NULL) { @@ -111,7 +244,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -132,7 +312,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -173,7 +400,11 @@ public function setInstanceGroupManager($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -194,7 +425,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -209,7 +444,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -230,7 +473,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -245,7 +496,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -266,7 +519,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -307,7 +562,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -328,7 +587,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var @@ -343,7 +606,8 @@ public function setReturnPartialSuccess($var) } /** - * The name of the zone where the managed instance group is located. + * The name of thezone where the managed + * instance group is located. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -354,7 +618,8 @@ public function getZone() } /** - * The name of the zone where the managed instance group is located. + * The name of thezone where the managed + * instance group is located. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED]; * @param string $var diff --git a/Compute/src/V1/ListManagedInstancesRegionInstanceGroupManagersRequest.php b/Compute/src/V1/ListManagedInstancesRegionInstanceGroupManagersRequest.php index 3a1ea5c19484..924f37ab583a 100644 --- a/Compute/src/V1/ListManagedInstancesRegionInstanceGroupManagersRequest.php +++ b/Compute/src/V1/ListManagedInstancesRegionInstanceGroupManagersRequest.php @@ -16,7 +16,54 @@ class ListManagedInstancesRegionInstanceGroupManagersRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ @@ -28,19 +75,33 @@ class ListManagedInstancesRegionInstanceGroupManagersRequest extends \Google\Pro */ protected $instance_group_manager = ''; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -58,7 +119,11 @@ class ListManagedInstancesRegionInstanceGroupManagersRequest extends \Google\Pro */ protected $region = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -88,21 +153,86 @@ public static function build(string $project, string $region, string $instanceGr * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type string $instance_group_manager * The name of the managed instance group. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type string $region * Name of the region scoping this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * } */ public function __construct($data = NULL) { @@ -111,7 +241,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -132,7 +309,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -173,7 +397,11 @@ public function setInstanceGroupManager($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -194,7 +422,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -209,7 +441,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -230,7 +470,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -245,7 +493,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -266,7 +516,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -333,7 +585,11 @@ public function setRegion($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -354,7 +610,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListNetworkAttachmentsRequest.php b/Compute/src/V1/ListNetworkAttachmentsRequest.php index 10aca8092a60..d88c10e14aef 100644 --- a/Compute/src/V1/ListNetworkAttachmentsRequest.php +++ b/Compute/src/V1/ListNetworkAttachmentsRequest.php @@ -16,25 +16,86 @@ class ListNetworkAttachmentsRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -52,7 +113,11 @@ class ListNetworkAttachmentsRequest extends \Google\Protobuf\Internal\Message */ protected $region = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -80,19 +145,84 @@ public static function build(string $project, string $region): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type string $region * Name of the region of this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * } */ public function __construct($data = NULL) { @@ -101,7 +231,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -122,7 +299,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -137,7 +361,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -158,7 +386,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -173,7 +405,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -194,7 +434,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -209,7 +457,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -230,7 +480,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -297,7 +549,11 @@ public function setRegion($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -318,7 +574,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListNetworkEndpointGroupsRequest.php b/Compute/src/V1/ListNetworkEndpointGroupsRequest.php index db4b5e86cdfa..60f115ceb526 100644 --- a/Compute/src/V1/ListNetworkEndpointGroupsRequest.php +++ b/Compute/src/V1/ListNetworkEndpointGroupsRequest.php @@ -16,25 +16,86 @@ class ListNetworkEndpointGroupsRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -46,13 +107,18 @@ class ListNetworkEndpointGroupsRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ protected $return_partial_success = null; /** - * The name of the zone where the network endpoint group is located. It should comply with RFC1035. + * The name of thezone + * where the network endpoint group is located. It should comply with RFC1035. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED]; */ @@ -60,7 +126,8 @@ class ListNetworkEndpointGroupsRequest extends \Google\Protobuf\Internal\Message /** * @param string $project Project ID for this request. - * @param string $zone The name of the zone where the network endpoint group is located. It should comply with RFC1035. + * @param string $zone The name of thezone + * where the network endpoint group is located. It should comply with RFC1035. * * @return \Google\Cloud\Compute\V1\ListNetworkEndpointGroupsRequest * @@ -80,19 +147,85 @@ public static function build(string $project, string $zone): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * @type string $zone - * The name of the zone where the network endpoint group is located. It should comply with RFC1035. + * The name of thezone + * where the network endpoint group is located. It should comply with RFC1035. * } */ public function __construct($data = NULL) { @@ -101,7 +234,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -122,7 +302,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -137,7 +364,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -158,7 +389,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -173,7 +408,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -194,7 +437,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -209,7 +460,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -230,7 +483,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -271,7 +526,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -292,7 +551,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var @@ -307,7 +570,8 @@ public function setReturnPartialSuccess($var) } /** - * The name of the zone where the network endpoint group is located. It should comply with RFC1035. + * The name of thezone + * where the network endpoint group is located. It should comply with RFC1035. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -318,7 +582,8 @@ public function getZone() } /** - * The name of the zone where the network endpoint group is located. It should comply with RFC1035. + * The name of thezone + * where the network endpoint group is located. It should comply with RFC1035. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED]; * @param string $var diff --git a/Compute/src/V1/ListNetworkEndpointsGlobalNetworkEndpointGroupsRequest.php b/Compute/src/V1/ListNetworkEndpointsGlobalNetworkEndpointGroupsRequest.php index b970f278b22c..efba9274f3ca 100644 --- a/Compute/src/V1/ListNetworkEndpointsGlobalNetworkEndpointGroupsRequest.php +++ b/Compute/src/V1/ListNetworkEndpointsGlobalNetworkEndpointGroupsRequest.php @@ -16,31 +16,93 @@ class ListNetworkEndpointsGlobalNetworkEndpointGroupsRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * The name of the network endpoint group from which you want to generate a list of included network endpoints. It should comply with RFC1035. + * The name of the network endpoint group from which you want to generate a + * list of included network endpoints. It should comply with RFC1035. * * Generated from protobuf field string network_endpoint_group = 433907078 [(.google.api.field_behavior) = REQUIRED]; */ protected $network_endpoint_group = ''; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -52,7 +114,11 @@ class ListNetworkEndpointsGlobalNetworkEndpointGroupsRequest extends \Google\Pro */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -60,7 +126,8 @@ class ListNetworkEndpointsGlobalNetworkEndpointGroupsRequest extends \Google\Pro /** * @param string $project Project ID for this request. - * @param string $networkEndpointGroup The name of the network endpoint group from which you want to generate a list of included network endpoints. It should comply with RFC1035. + * @param string $networkEndpointGroup The name of the network endpoint group from which you want to generate a + * list of included network endpoints. It should comply with RFC1035. * * @return \Google\Cloud\Compute\V1\ListNetworkEndpointsGlobalNetworkEndpointGroupsRequest * @@ -80,19 +147,85 @@ public static function build(string $project, string $networkEndpointGroup): sel * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $network_endpoint_group - * The name of the network endpoint group from which you want to generate a list of included network endpoints. It should comply with RFC1035. + * The name of the network endpoint group from which you want to generate a + * list of included network endpoints. It should comply with RFC1035. * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * } */ public function __construct($data = NULL) { @@ -101,7 +234,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -122,7 +302,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -137,7 +364,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -158,7 +389,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -173,7 +408,8 @@ public function setMaxResults($var) } /** - * The name of the network endpoint group from which you want to generate a list of included network endpoints. It should comply with RFC1035. + * The name of the network endpoint group from which you want to generate a + * list of included network endpoints. It should comply with RFC1035. * * Generated from protobuf field string network_endpoint_group = 433907078 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -184,7 +420,8 @@ public function getNetworkEndpointGroup() } /** - * The name of the network endpoint group from which you want to generate a list of included network endpoints. It should comply with RFC1035. + * The name of the network endpoint group from which you want to generate a + * list of included network endpoints. It should comply with RFC1035. * * Generated from protobuf field string network_endpoint_group = 433907078 [(.google.api.field_behavior) = REQUIRED]; * @param string $var @@ -199,7 +436,15 @@ public function setNetworkEndpointGroup($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -220,7 +465,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -235,7 +488,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -256,7 +511,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -297,7 +554,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -318,7 +579,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListNetworkEndpointsNetworkEndpointGroupsRequest.php b/Compute/src/V1/ListNetworkEndpointsNetworkEndpointGroupsRequest.php index c59430ca6c58..dcf5f7b3717d 100644 --- a/Compute/src/V1/ListNetworkEndpointsNetworkEndpointGroupsRequest.php +++ b/Compute/src/V1/ListNetworkEndpointsNetworkEndpointGroupsRequest.php @@ -16,19 +16,71 @@ class ListNetworkEndpointsNetworkEndpointGroupsRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * The name of the network endpoint group from which you want to generate a list of included network endpoints. It should comply with RFC1035. + * The name of the network endpoint group from which you want to generate a + * list of included network endpoints. It should comply with RFC1035. * * Generated from protobuf field string network_endpoint_group = 433907078 [(.google.api.field_behavior) = REQUIRED]; */ @@ -40,13 +92,23 @@ class ListNetworkEndpointsNetworkEndpointGroupsRequest extends \Google\Protobuf\ */ protected $network_endpoint_groups_list_endpoints_request_resource = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -58,13 +120,18 @@ class ListNetworkEndpointsNetworkEndpointGroupsRequest extends \Google\Protobuf\ */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ protected $return_partial_success = null; /** - * The name of the zone where the network endpoint group is located. It should comply with RFC1035. + * The name of the zone where + * the network endpoint group is located. It should comply with RFC1035. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED]; */ @@ -72,8 +139,10 @@ class ListNetworkEndpointsNetworkEndpointGroupsRequest extends \Google\Protobuf\ /** * @param string $project Project ID for this request. - * @param string $zone The name of the zone where the network endpoint group is located. It should comply with RFC1035. - * @param string $networkEndpointGroup The name of the network endpoint group from which you want to generate a list of included network endpoints. It should comply with RFC1035. + * @param string $zone The name of the zone where + * the network endpoint group is located. It should comply with RFC1035. + * @param string $networkEndpointGroup The name of the network endpoint group from which you want to generate a + * list of included network endpoints. It should comply with RFC1035. * @param \Google\Cloud\Compute\V1\NetworkEndpointGroupsListEndpointsRequest $networkEndpointGroupsListEndpointsRequestResource The body resource for this request * * @return \Google\Cloud\Compute\V1\ListNetworkEndpointsNetworkEndpointGroupsRequest @@ -96,23 +165,90 @@ public static function build(string $project, string $zone, string $networkEndpo * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $network_endpoint_group - * The name of the network endpoint group from which you want to generate a list of included network endpoints. It should comply with RFC1035. + * The name of the network endpoint group from which you want to generate a + * list of included network endpoints. It should comply with RFC1035. * @type \Google\Cloud\Compute\V1\NetworkEndpointGroupsListEndpointsRequest $network_endpoint_groups_list_endpoints_request_resource * The body resource for this request * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * @type string $zone - * The name of the zone where the network endpoint group is located. It should comply with RFC1035. + * The name of the zone where + * the network endpoint group is located. It should comply with RFC1035. * } */ public function __construct($data = NULL) { @@ -121,7 +257,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -142,7 +325,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -157,7 +387,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -178,7 +412,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -193,7 +431,8 @@ public function setMaxResults($var) } /** - * The name of the network endpoint group from which you want to generate a list of included network endpoints. It should comply with RFC1035. + * The name of the network endpoint group from which you want to generate a + * list of included network endpoints. It should comply with RFC1035. * * Generated from protobuf field string network_endpoint_group = 433907078 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -204,7 +443,8 @@ public function getNetworkEndpointGroup() } /** - * The name of the network endpoint group from which you want to generate a list of included network endpoints. It should comply with RFC1035. + * The name of the network endpoint group from which you want to generate a + * list of included network endpoints. It should comply with RFC1035. * * Generated from protobuf field string network_endpoint_group = 433907078 [(.google.api.field_behavior) = REQUIRED]; * @param string $var @@ -255,7 +495,15 @@ public function setNetworkEndpointGroupsListEndpointsRequestResource($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -276,7 +524,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -291,7 +547,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -312,7 +570,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -353,7 +613,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -374,7 +638,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var @@ -389,7 +657,8 @@ public function setReturnPartialSuccess($var) } /** - * The name of the zone where the network endpoint group is located. It should comply with RFC1035. + * The name of the zone where + * the network endpoint group is located. It should comply with RFC1035. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -400,7 +669,8 @@ public function getZone() } /** - * The name of the zone where the network endpoint group is located. It should comply with RFC1035. + * The name of the zone where + * the network endpoint group is located. It should comply with RFC1035. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED]; * @param string $var diff --git a/Compute/src/V1/ListNetworkEndpointsRegionNetworkEndpointGroupsRequest.php b/Compute/src/V1/ListNetworkEndpointsRegionNetworkEndpointGroupsRequest.php index ba1f50c3a5ee..38e563cc56ae 100644 --- a/Compute/src/V1/ListNetworkEndpointsRegionNetworkEndpointGroupsRequest.php +++ b/Compute/src/V1/ListNetworkEndpointsRegionNetworkEndpointGroupsRequest.php @@ -16,31 +16,93 @@ class ListNetworkEndpointsRegionNetworkEndpointGroupsRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * The name of the network endpoint group from which you want to generate a list of included network endpoints. It should comply with RFC1035. + * The name of the network endpoint group from which you want to generate a + * list of included network endpoints. It should comply with RFC1035. * * Generated from protobuf field string network_endpoint_group = 433907078 [(.google.api.field_behavior) = REQUIRED]; */ protected $network_endpoint_group = ''; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -52,13 +114,18 @@ class ListNetworkEndpointsRegionNetworkEndpointGroupsRequest extends \Google\Pro */ protected $project = ''; /** - * The name of the region where the network endpoint group is located. It should comply with RFC1035. + * The name of theregion + * where the network endpoint group is located. It should comply with RFC1035. * * Generated from protobuf field string region = 138946292 [(.google.api.field_behavior) = REQUIRED]; */ protected $region = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -66,8 +133,10 @@ class ListNetworkEndpointsRegionNetworkEndpointGroupsRequest extends \Google\Pro /** * @param string $project Project ID for this request. - * @param string $region The name of the region where the network endpoint group is located. It should comply with RFC1035. - * @param string $networkEndpointGroup The name of the network endpoint group from which you want to generate a list of included network endpoints. It should comply with RFC1035. + * @param string $region The name of theregion + * where the network endpoint group is located. It should comply with RFC1035. + * @param string $networkEndpointGroup The name of the network endpoint group from which you want to generate a + * list of included network endpoints. It should comply with RFC1035. * * @return \Google\Cloud\Compute\V1\ListNetworkEndpointsRegionNetworkEndpointGroupsRequest * @@ -88,21 +157,88 @@ public static function build(string $project, string $region, string $networkEnd * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $network_endpoint_group - * The name of the network endpoint group from which you want to generate a list of included network endpoints. It should comply with RFC1035. + * The name of the network endpoint group from which you want to generate a + * list of included network endpoints. It should comply with RFC1035. * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type string $region - * The name of the region where the network endpoint group is located. It should comply with RFC1035. + * The name of theregion + * where the network endpoint group is located. It should comply with RFC1035. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * } */ public function __construct($data = NULL) { @@ -111,7 +247,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -132,7 +315,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -147,7 +377,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -168,7 +402,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -183,7 +421,8 @@ public function setMaxResults($var) } /** - * The name of the network endpoint group from which you want to generate a list of included network endpoints. It should comply with RFC1035. + * The name of the network endpoint group from which you want to generate a + * list of included network endpoints. It should comply with RFC1035. * * Generated from protobuf field string network_endpoint_group = 433907078 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -194,7 +433,8 @@ public function getNetworkEndpointGroup() } /** - * The name of the network endpoint group from which you want to generate a list of included network endpoints. It should comply with RFC1035. + * The name of the network endpoint group from which you want to generate a + * list of included network endpoints. It should comply with RFC1035. * * Generated from protobuf field string network_endpoint_group = 433907078 [(.google.api.field_behavior) = REQUIRED]; * @param string $var @@ -209,7 +449,15 @@ public function setNetworkEndpointGroup($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -230,7 +478,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -245,7 +501,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -266,7 +524,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -307,7 +567,8 @@ public function setProject($var) } /** - * The name of the region where the network endpoint group is located. It should comply with RFC1035. + * The name of theregion + * where the network endpoint group is located. It should comply with RFC1035. * * Generated from protobuf field string region = 138946292 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -318,7 +579,8 @@ public function getRegion() } /** - * The name of the region where the network endpoint group is located. It should comply with RFC1035. + * The name of theregion + * where the network endpoint group is located. It should comply with RFC1035. * * Generated from protobuf field string region = 138946292 [(.google.api.field_behavior) = REQUIRED]; * @param string $var @@ -333,7 +595,11 @@ public function setRegion($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -354,7 +620,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListNetworkFirewallPoliciesRequest.php b/Compute/src/V1/ListNetworkFirewallPoliciesRequest.php index 986c27084bec..ba7f455d8e65 100644 --- a/Compute/src/V1/ListNetworkFirewallPoliciesRequest.php +++ b/Compute/src/V1/ListNetworkFirewallPoliciesRequest.php @@ -16,25 +16,86 @@ class ListNetworkFirewallPoliciesRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -46,7 +107,11 @@ class ListNetworkFirewallPoliciesRequest extends \Google\Protobuf\Internal\Messa */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -72,17 +137,82 @@ public static function build(string $project): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * } */ public function __construct($data = NULL) { @@ -91,7 +221,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -112,7 +289,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -127,7 +351,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -148,7 +376,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -163,7 +395,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -184,7 +424,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -199,7 +447,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -220,7 +470,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -261,7 +513,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -282,7 +538,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListNetworkProfilesRequest.php b/Compute/src/V1/ListNetworkProfilesRequest.php index 48833fae6b18..c935d6999abf 100644 --- a/Compute/src/V1/ListNetworkProfilesRequest.php +++ b/Compute/src/V1/ListNetworkProfilesRequest.php @@ -16,25 +16,86 @@ class ListNetworkProfilesRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -46,7 +107,11 @@ class ListNetworkProfilesRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -72,17 +137,82 @@ public static function build(string $project): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * } */ public function __construct($data = NULL) { @@ -91,7 +221,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -112,7 +289,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -127,7 +351,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -148,7 +376,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -163,7 +395,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -184,7 +424,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -199,7 +447,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -220,7 +470,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -261,7 +513,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -282,7 +538,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListNetworksRequest.php b/Compute/src/V1/ListNetworksRequest.php index 39aa0e53e1d9..4ce47498040b 100644 --- a/Compute/src/V1/ListNetworksRequest.php +++ b/Compute/src/V1/ListNetworksRequest.php @@ -16,25 +16,86 @@ class ListNetworksRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -46,7 +107,11 @@ class ListNetworksRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -72,17 +137,82 @@ public static function build(string $project): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * } */ public function __construct($data = NULL) { @@ -91,7 +221,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -112,7 +289,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -127,7 +351,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -148,7 +376,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -163,7 +395,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -184,7 +424,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -199,7 +447,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -220,7 +470,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -261,7 +513,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -282,7 +538,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListNodeGroupsRequest.php b/Compute/src/V1/ListNodeGroupsRequest.php index 1ad30681e36b..2f9259d37780 100644 --- a/Compute/src/V1/ListNodeGroupsRequest.php +++ b/Compute/src/V1/ListNodeGroupsRequest.php @@ -16,25 +16,86 @@ class ListNodeGroupsRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -46,7 +107,11 @@ class ListNodeGroupsRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -80,17 +145,82 @@ public static function build(string $project, string $zone): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * @type string $zone * The name of the zone for this request. * } @@ -101,7 +231,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -122,7 +299,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -137,7 +361,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -158,7 +386,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -173,7 +405,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -194,7 +434,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -209,7 +457,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -230,7 +480,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -271,7 +523,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -292,7 +548,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListNodeTemplatesRequest.php b/Compute/src/V1/ListNodeTemplatesRequest.php index baea0e87ecd6..867061cb045f 100644 --- a/Compute/src/V1/ListNodeTemplatesRequest.php +++ b/Compute/src/V1/ListNodeTemplatesRequest.php @@ -16,25 +16,86 @@ class ListNodeTemplatesRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -52,7 +113,11 @@ class ListNodeTemplatesRequest extends \Google\Protobuf\Internal\Message */ protected $region = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -80,19 +145,84 @@ public static function build(string $project, string $region): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type string $region * The name of the region for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * } */ public function __construct($data = NULL) { @@ -101,7 +231,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -122,7 +299,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -137,7 +361,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -158,7 +386,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -173,7 +405,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -194,7 +434,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -209,7 +457,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -230,7 +480,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -297,7 +549,11 @@ public function setRegion($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -318,7 +574,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListNodeTypesRequest.php b/Compute/src/V1/ListNodeTypesRequest.php index b8142ecf3112..767ea352b269 100644 --- a/Compute/src/V1/ListNodeTypesRequest.php +++ b/Compute/src/V1/ListNodeTypesRequest.php @@ -16,25 +16,86 @@ class ListNodeTypesRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -46,7 +107,11 @@ class ListNodeTypesRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -80,17 +145,82 @@ public static function build(string $project, string $zone): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * @type string $zone * The name of the zone for this request. * } @@ -101,7 +231,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -122,7 +299,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -137,7 +361,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -158,7 +386,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -173,7 +405,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -194,7 +434,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -209,7 +457,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -230,7 +480,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -271,7 +523,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -292,7 +548,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListNodesNodeGroupsRequest.php b/Compute/src/V1/ListNodesNodeGroupsRequest.php index 1c6401b781d4..a7d3a5cec95d 100644 --- a/Compute/src/V1/ListNodesNodeGroupsRequest.php +++ b/Compute/src/V1/ListNodesNodeGroupsRequest.php @@ -16,13 +16,64 @@ class ListNodesNodeGroupsRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ @@ -34,13 +85,23 @@ class ListNodesNodeGroupsRequest extends \Google\Protobuf\Internal\Message */ protected $node_group = ''; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -52,7 +113,11 @@ class ListNodesNodeGroupsRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -88,19 +153,84 @@ public static function build(string $project, string $zone, string $nodeGroup): * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $node_group * Name of the NodeGroup resource whose nodes you want to list. * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * @type string $zone * The name of the zone for this request. * } @@ -111,7 +241,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -132,7 +309,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -147,7 +371,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -168,7 +396,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -209,7 +441,15 @@ public function setNodeGroup($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -230,7 +470,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -245,7 +493,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -266,7 +516,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -307,7 +559,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -328,7 +584,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListOrganizationSecurityPoliciesRequest.php b/Compute/src/V1/ListOrganizationSecurityPoliciesRequest.php index 8944ceb81f3e..69fd8a88da26 100644 --- a/Compute/src/V1/ListOrganizationSecurityPoliciesRequest.php +++ b/Compute/src/V1/ListOrganizationSecurityPoliciesRequest.php @@ -16,25 +16,86 @@ class ListOrganizationSecurityPoliciesRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -46,7 +107,11 @@ class ListOrganizationSecurityPoliciesRequest extends \Google\Protobuf\Internal\ */ protected $parent_id = null; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -59,17 +124,82 @@ class ListOrganizationSecurityPoliciesRequest extends \Google\Protobuf\Internal\ * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $parent_id * Parent ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * } */ public function __construct($data = NULL) { @@ -78,7 +208,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -99,7 +276,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -114,7 +338,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -135,7 +363,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -150,7 +382,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -171,7 +411,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -186,7 +434,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -207,7 +457,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -258,7 +510,11 @@ public function setParentId($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -279,7 +535,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListPacketMirroringsRequest.php b/Compute/src/V1/ListPacketMirroringsRequest.php index b30deb82c186..fcab0f46e544 100644 --- a/Compute/src/V1/ListPacketMirroringsRequest.php +++ b/Compute/src/V1/ListPacketMirroringsRequest.php @@ -16,25 +16,86 @@ class ListPacketMirroringsRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -52,7 +113,11 @@ class ListPacketMirroringsRequest extends \Google\Protobuf\Internal\Message */ protected $region = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -80,19 +145,84 @@ public static function build(string $project, string $region): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type string $region * Name of the region for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * } */ public function __construct($data = NULL) { @@ -101,7 +231,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -122,7 +299,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -137,7 +361,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -158,7 +386,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -173,7 +405,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -194,7 +434,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -209,7 +457,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -230,7 +480,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -297,7 +549,11 @@ public function setRegion($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -318,7 +574,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListPeeringRoutesNetworksRequest.php b/Compute/src/V1/ListPeeringRoutesNetworksRequest.php index ea21682f5935..5fd3021221ba 100644 --- a/Compute/src/V1/ListPeeringRoutesNetworksRequest.php +++ b/Compute/src/V1/ListPeeringRoutesNetworksRequest.php @@ -23,13 +23,64 @@ class ListPeeringRoutesNetworksRequest extends \Google\Protobuf\Internal\Message */ protected $direction = null; /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ @@ -41,13 +92,23 @@ class ListPeeringRoutesNetworksRequest extends \Google\Protobuf\Internal\Message */ protected $network = ''; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -65,13 +126,18 @@ class ListPeeringRoutesNetworksRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * The region of the request. The response will include all subnet routes, static routes and dynamic routes in the region. + * The region of the request. The response will include all subnet routes, + * static routes and dynamic routes in the region. * * Generated from protobuf field optional string region = 138946292; */ protected $region = null; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -102,23 +168,89 @@ public static function build(string $project, string $network): self * The direction of the exchanged routes. * Check the Direction enum for the list of possible values. * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $network * Name of the network for this request. * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $peering_name * The response will show routes exchanged over the given peering connection. * @type string $project * Project ID for this request. * @type string $region - * The region of the request. The response will include all subnet routes, static routes and dynamic routes in the region. + * The region of the request. The response will include all subnet routes, + * static routes and dynamic routes in the region. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * } */ public function __construct($data = NULL) { @@ -165,7 +297,54 @@ public function setDirection($var) } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -186,7 +365,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -201,7 +427,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -222,7 +452,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -263,7 +497,15 @@ public function setNetwork($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -284,7 +526,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -299,7 +549,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -320,7 +572,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -397,7 +651,8 @@ public function setProject($var) } /** - * The region of the request. The response will include all subnet routes, static routes and dynamic routes in the region. + * The region of the request. The response will include all subnet routes, + * static routes and dynamic routes in the region. * * Generated from protobuf field optional string region = 138946292; * @return string @@ -418,7 +673,8 @@ public function clearRegion() } /** - * The region of the request. The response will include all subnet routes, static routes and dynamic routes in the region. + * The region of the request. The response will include all subnet routes, + * static routes and dynamic routes in the region. * * Generated from protobuf field optional string region = 138946292; * @param string $var @@ -433,7 +689,11 @@ public function setRegion($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -454,7 +714,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListPerInstanceConfigsInstanceGroupManagersRequest.php b/Compute/src/V1/ListPerInstanceConfigsInstanceGroupManagersRequest.php index a4da68ebf6be..6638681038ab 100644 --- a/Compute/src/V1/ListPerInstanceConfigsInstanceGroupManagersRequest.php +++ b/Compute/src/V1/ListPerInstanceConfigsInstanceGroupManagersRequest.php @@ -16,7 +16,54 @@ class ListPerInstanceConfigsInstanceGroupManagersRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ @@ -28,19 +75,33 @@ class ListPerInstanceConfigsInstanceGroupManagersRequest extends \Google\Protobu */ protected $instance_group_manager = ''; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -52,13 +113,19 @@ class ListPerInstanceConfigsInstanceGroupManagersRequest extends \Google\Protobu */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ protected $return_partial_success = null; /** - * The name of the zone where the managed instance group is located. It should conform to RFC1035. + * The name of thezone + * where the managed instance group is located. + * It should conform to RFC1035. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED]; */ @@ -66,7 +133,9 @@ class ListPerInstanceConfigsInstanceGroupManagersRequest extends \Google\Protobu /** * @param string $project Project ID for this request. - * @param string $zone The name of the zone where the managed instance group is located. It should conform to RFC1035. + * @param string $zone The name of thezone + * where the managed instance group is located. + * It should conform to RFC1035. * @param string $instanceGroupManager The name of the managed instance group. It should conform to RFC1035. * * @return \Google\Cloud\Compute\V1\ListPerInstanceConfigsInstanceGroupManagersRequest @@ -88,21 +157,88 @@ public static function build(string $project, string $zone, string $instanceGrou * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type string $instance_group_manager * The name of the managed instance group. It should conform to RFC1035. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * @type string $zone - * The name of the zone where the managed instance group is located. It should conform to RFC1035. + * The name of thezone + * where the managed instance group is located. + * It should conform to RFC1035. * } */ public function __construct($data = NULL) { @@ -111,7 +247,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -132,7 +315,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -173,7 +403,11 @@ public function setInstanceGroupManager($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -194,7 +428,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -209,7 +447,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -230,7 +476,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -245,7 +499,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -266,7 +522,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -307,7 +565,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -328,7 +590,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var @@ -343,7 +609,9 @@ public function setReturnPartialSuccess($var) } /** - * The name of the zone where the managed instance group is located. It should conform to RFC1035. + * The name of thezone + * where the managed instance group is located. + * It should conform to RFC1035. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -354,7 +622,9 @@ public function getZone() } /** - * The name of the zone where the managed instance group is located. It should conform to RFC1035. + * The name of thezone + * where the managed instance group is located. + * It should conform to RFC1035. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED]; * @param string $var diff --git a/Compute/src/V1/ListPerInstanceConfigsRegionInstanceGroupManagersRequest.php b/Compute/src/V1/ListPerInstanceConfigsRegionInstanceGroupManagersRequest.php index f22324e5d69e..765901f5efaa 100644 --- a/Compute/src/V1/ListPerInstanceConfigsRegionInstanceGroupManagersRequest.php +++ b/Compute/src/V1/ListPerInstanceConfigsRegionInstanceGroupManagersRequest.php @@ -16,7 +16,54 @@ class ListPerInstanceConfigsRegionInstanceGroupManagersRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ @@ -28,19 +75,33 @@ class ListPerInstanceConfigsRegionInstanceGroupManagersRequest extends \Google\P */ protected $instance_group_manager = ''; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -58,7 +119,11 @@ class ListPerInstanceConfigsRegionInstanceGroupManagersRequest extends \Google\P */ protected $region = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -88,21 +153,86 @@ public static function build(string $project, string $region, string $instanceGr * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type string $instance_group_manager * The name of the managed instance group. It should conform to RFC1035. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type string $region * Name of the region scoping this request, should conform to RFC1035. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * } */ public function __construct($data = NULL) { @@ -111,7 +241,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -132,7 +309,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -173,7 +397,11 @@ public function setInstanceGroupManager($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -194,7 +422,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -209,7 +441,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -230,7 +470,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -245,7 +493,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -266,7 +516,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -333,7 +585,11 @@ public function setRegion($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -354,7 +610,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListPreconfiguredExpressionSetsOrganizationSecurityPoliciesRequest.php b/Compute/src/V1/ListPreconfiguredExpressionSetsOrganizationSecurityPoliciesRequest.php index df30975fbe91..026d3ea2383a 100644 --- a/Compute/src/V1/ListPreconfiguredExpressionSetsOrganizationSecurityPoliciesRequest.php +++ b/Compute/src/V1/ListPreconfiguredExpressionSetsOrganizationSecurityPoliciesRequest.php @@ -16,25 +16,86 @@ class ListPreconfiguredExpressionSetsOrganizationSecurityPoliciesRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -46,7 +107,11 @@ class ListPreconfiguredExpressionSetsOrganizationSecurityPoliciesRequest extends */ protected $parent_id = null; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -59,17 +124,82 @@ class ListPreconfiguredExpressionSetsOrganizationSecurityPoliciesRequest extends * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $parent_id * Parent ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * } */ public function __construct($data = NULL) { @@ -78,7 +208,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -99,7 +276,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -114,7 +338,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -135,7 +363,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -150,7 +382,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -171,7 +411,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -186,7 +434,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -207,7 +457,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -258,7 +510,11 @@ public function setParentId($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -279,7 +535,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListPreconfiguredExpressionSetsSecurityPoliciesRequest.php b/Compute/src/V1/ListPreconfiguredExpressionSetsSecurityPoliciesRequest.php index dc3e536f13fb..dfc0c2b096e5 100644 --- a/Compute/src/V1/ListPreconfiguredExpressionSetsSecurityPoliciesRequest.php +++ b/Compute/src/V1/ListPreconfiguredExpressionSetsSecurityPoliciesRequest.php @@ -16,25 +16,86 @@ class ListPreconfiguredExpressionSetsSecurityPoliciesRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -46,7 +107,11 @@ class ListPreconfiguredExpressionSetsSecurityPoliciesRequest extends \Google\Pro */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -72,17 +137,82 @@ public static function build(string $project): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * } */ public function __construct($data = NULL) { @@ -91,7 +221,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -112,7 +289,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -127,7 +351,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -148,7 +376,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -163,7 +395,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -184,7 +424,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -199,7 +447,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -220,7 +470,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -261,7 +513,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -282,7 +538,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListPreviewFeaturesRequest.php b/Compute/src/V1/ListPreviewFeaturesRequest.php index 0a7453715711..5c0b7cc24ee0 100644 --- a/Compute/src/V1/ListPreviewFeaturesRequest.php +++ b/Compute/src/V1/ListPreviewFeaturesRequest.php @@ -16,25 +16,86 @@ class ListPreviewFeaturesRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -46,7 +107,11 @@ class ListPreviewFeaturesRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -72,17 +137,82 @@ public static function build(string $project): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * } */ public function __construct($data = NULL) { @@ -91,7 +221,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -112,7 +289,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -127,7 +351,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -148,7 +376,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -163,7 +395,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -184,7 +424,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -199,7 +447,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -220,7 +470,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -261,7 +513,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -282,7 +538,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListPublicAdvertisedPrefixesRequest.php b/Compute/src/V1/ListPublicAdvertisedPrefixesRequest.php index 5b3464cb0194..4264623b7e61 100644 --- a/Compute/src/V1/ListPublicAdvertisedPrefixesRequest.php +++ b/Compute/src/V1/ListPublicAdvertisedPrefixesRequest.php @@ -16,25 +16,86 @@ class ListPublicAdvertisedPrefixesRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -46,7 +107,11 @@ class ListPublicAdvertisedPrefixesRequest extends \Google\Protobuf\Internal\Mess */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -72,17 +137,82 @@ public static function build(string $project): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * } */ public function __construct($data = NULL) { @@ -91,7 +221,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -112,7 +289,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -127,7 +351,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -148,7 +376,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -163,7 +395,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -184,7 +424,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -199,7 +447,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -220,7 +470,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -261,7 +513,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -282,7 +538,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListPublicDelegatedPrefixesRequest.php b/Compute/src/V1/ListPublicDelegatedPrefixesRequest.php index 3212d31313d9..da769ad80baa 100644 --- a/Compute/src/V1/ListPublicDelegatedPrefixesRequest.php +++ b/Compute/src/V1/ListPublicDelegatedPrefixesRequest.php @@ -16,25 +16,86 @@ class ListPublicDelegatedPrefixesRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -52,7 +113,11 @@ class ListPublicDelegatedPrefixesRequest extends \Google\Protobuf\Internal\Messa */ protected $region = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -80,19 +145,84 @@ public static function build(string $project, string $region): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type string $region * Name of the region of this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * } */ public function __construct($data = NULL) { @@ -101,7 +231,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -122,7 +299,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -137,7 +361,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -158,7 +386,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -173,7 +405,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -194,7 +434,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -209,7 +457,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -230,7 +480,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -297,7 +549,11 @@ public function setRegion($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -318,7 +574,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListReferrersInstancesRequest.php b/Compute/src/V1/ListReferrersInstancesRequest.php index a49bf6580a1d..463c2d89940f 100644 --- a/Compute/src/V1/ListReferrersInstancesRequest.php +++ b/Compute/src/V1/ListReferrersInstancesRequest.php @@ -16,31 +16,93 @@ class ListReferrersInstancesRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * Name of the target instance scoping this request, or '-' if the request should span over all instances in the container. + * Name of the target instance scoping this request, or '-' if the + * request should span over all instances in the container. * * Generated from protobuf field string instance = 18257045 [(.google.api.field_behavior) = REQUIRED]; */ protected $instance = ''; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -52,7 +114,11 @@ class ListReferrersInstancesRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -67,7 +133,8 @@ class ListReferrersInstancesRequest extends \Google\Protobuf\Internal\Message /** * @param string $project Project ID for this request. * @param string $zone The name of the zone for this request. - * @param string $instance Name of the target instance scoping this request, or '-' if the request should span over all instances in the container. + * @param string $instance Name of the target instance scoping this request, or '-' if the + * request should span over all instances in the container. * * @return \Google\Cloud\Compute\V1\ListReferrersInstancesRequest * @@ -88,19 +155,85 @@ public static function build(string $project, string $zone, string $instance): s * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type string $instance - * Name of the target instance scoping this request, or '-' if the request should span over all instances in the container. + * Name of the target instance scoping this request, or '-' if the + * request should span over all instances in the container. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * @type string $zone * The name of the zone for this request. * } @@ -111,7 +244,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -132,7 +312,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -147,7 +374,8 @@ public function setFilter($var) } /** - * Name of the target instance scoping this request, or '-' if the request should span over all instances in the container. + * Name of the target instance scoping this request, or '-' if the + * request should span over all instances in the container. * * Generated from protobuf field string instance = 18257045 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -158,7 +386,8 @@ public function getInstance() } /** - * Name of the target instance scoping this request, or '-' if the request should span over all instances in the container. + * Name of the target instance scoping this request, or '-' if the + * request should span over all instances in the container. * * Generated from protobuf field string instance = 18257045 [(.google.api.field_behavior) = REQUIRED]; * @param string $var @@ -173,7 +402,11 @@ public function setInstance($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -194,7 +427,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -209,7 +446,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -230,7 +475,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -245,7 +498,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -266,7 +521,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -307,7 +564,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -328,7 +589,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListRegionAutoscalersRequest.php b/Compute/src/V1/ListRegionAutoscalersRequest.php index b8f15dc5e4e4..4e818993c16d 100644 --- a/Compute/src/V1/ListRegionAutoscalersRequest.php +++ b/Compute/src/V1/ListRegionAutoscalersRequest.php @@ -16,25 +16,86 @@ class ListRegionAutoscalersRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -52,7 +113,11 @@ class ListRegionAutoscalersRequest extends \Google\Protobuf\Internal\Message */ protected $region = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -80,19 +145,84 @@ public static function build(string $project, string $region): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type string $region * Name of the region scoping this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * } */ public function __construct($data = NULL) { @@ -101,7 +231,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -122,7 +299,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -137,7 +361,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -158,7 +386,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -173,7 +405,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -194,7 +434,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -209,7 +457,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -230,7 +480,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -297,7 +549,11 @@ public function setRegion($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -318,7 +574,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListRegionBackendServicesRequest.php b/Compute/src/V1/ListRegionBackendServicesRequest.php index e5c342c400e5..b19f2b165345 100644 --- a/Compute/src/V1/ListRegionBackendServicesRequest.php +++ b/Compute/src/V1/ListRegionBackendServicesRequest.php @@ -16,25 +16,86 @@ class ListRegionBackendServicesRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -52,7 +113,11 @@ class ListRegionBackendServicesRequest extends \Google\Protobuf\Internal\Message */ protected $region = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -80,19 +145,84 @@ public static function build(string $project, string $region): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type string $region * Name of the region scoping this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * } */ public function __construct($data = NULL) { @@ -101,7 +231,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -122,7 +299,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -137,7 +361,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -158,7 +386,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -173,7 +405,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -194,7 +434,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -209,7 +457,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -230,7 +480,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -297,7 +549,11 @@ public function setRegion($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -318,7 +574,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListRegionCommitmentsRequest.php b/Compute/src/V1/ListRegionCommitmentsRequest.php index ca4362086407..742f6d24a61c 100644 --- a/Compute/src/V1/ListRegionCommitmentsRequest.php +++ b/Compute/src/V1/ListRegionCommitmentsRequest.php @@ -16,25 +16,86 @@ class ListRegionCommitmentsRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -52,7 +113,11 @@ class ListRegionCommitmentsRequest extends \Google\Protobuf\Internal\Message */ protected $region = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -80,19 +145,84 @@ public static function build(string $project, string $region): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type string $region * Name of the region for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * } */ public function __construct($data = NULL) { @@ -101,7 +231,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -122,7 +299,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -137,7 +361,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -158,7 +386,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -173,7 +405,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -194,7 +434,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -209,7 +457,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -230,7 +480,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -297,7 +549,11 @@ public function setRegion($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -318,7 +574,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListRegionDiskTypesRequest.php b/Compute/src/V1/ListRegionDiskTypesRequest.php index a73ee89c0ab3..c6f968fb159e 100644 --- a/Compute/src/V1/ListRegionDiskTypesRequest.php +++ b/Compute/src/V1/ListRegionDiskTypesRequest.php @@ -16,25 +16,86 @@ class ListRegionDiskTypesRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -52,7 +113,11 @@ class ListRegionDiskTypesRequest extends \Google\Protobuf\Internal\Message */ protected $region = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -80,19 +145,84 @@ public static function build(string $project, string $region): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type string $region * The name of the region for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * } */ public function __construct($data = NULL) { @@ -101,7 +231,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -122,7 +299,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -137,7 +361,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -158,7 +386,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -173,7 +405,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -194,7 +434,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -209,7 +457,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -230,7 +480,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -297,7 +549,11 @@ public function setRegion($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -318,7 +574,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListRegionDisksRequest.php b/Compute/src/V1/ListRegionDisksRequest.php index cfe0c8cd6023..a901f613175e 100644 --- a/Compute/src/V1/ListRegionDisksRequest.php +++ b/Compute/src/V1/ListRegionDisksRequest.php @@ -16,25 +16,86 @@ class ListRegionDisksRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -52,7 +113,11 @@ class ListRegionDisksRequest extends \Google\Protobuf\Internal\Message */ protected $region = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -80,19 +145,84 @@ public static function build(string $project, string $region): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type string $region * Name of the region for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * } */ public function __construct($data = NULL) { @@ -101,7 +231,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -122,7 +299,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -137,7 +361,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -158,7 +386,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -173,7 +405,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -194,7 +434,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -209,7 +457,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -230,7 +480,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -297,7 +549,11 @@ public function setRegion($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -318,7 +574,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListRegionHealthCheckServicesRequest.php b/Compute/src/V1/ListRegionHealthCheckServicesRequest.php index 01c06176a646..e2a074fc07cc 100644 --- a/Compute/src/V1/ListRegionHealthCheckServicesRequest.php +++ b/Compute/src/V1/ListRegionHealthCheckServicesRequest.php @@ -16,25 +16,86 @@ class ListRegionHealthCheckServicesRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -52,7 +113,11 @@ class ListRegionHealthCheckServicesRequest extends \Google\Protobuf\Internal\Mes */ protected $region = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -80,19 +145,84 @@ public static function build(string $project, string $region): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type string $region * Name of the region scoping this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * } */ public function __construct($data = NULL) { @@ -101,7 +231,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -122,7 +299,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -137,7 +361,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -158,7 +386,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -173,7 +405,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -194,7 +434,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -209,7 +457,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -230,7 +480,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -297,7 +549,11 @@ public function setRegion($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -318,7 +574,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListRegionHealthChecksRequest.php b/Compute/src/V1/ListRegionHealthChecksRequest.php index d4ba6aeebb9b..4a4c20ac1638 100644 --- a/Compute/src/V1/ListRegionHealthChecksRequest.php +++ b/Compute/src/V1/ListRegionHealthChecksRequest.php @@ -16,25 +16,86 @@ class ListRegionHealthChecksRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -52,7 +113,11 @@ class ListRegionHealthChecksRequest extends \Google\Protobuf\Internal\Message */ protected $region = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -80,19 +145,84 @@ public static function build(string $project, string $region): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type string $region * Name of the region scoping this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * } */ public function __construct($data = NULL) { @@ -101,7 +231,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -122,7 +299,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -137,7 +361,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -158,7 +386,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -173,7 +405,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -194,7 +434,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -209,7 +457,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -230,7 +480,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -297,7 +549,11 @@ public function setRegion($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -318,7 +574,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListRegionInstanceGroupManagersRequest.php b/Compute/src/V1/ListRegionInstanceGroupManagersRequest.php index 5995f2ef465b..58d91f70bc1f 100644 --- a/Compute/src/V1/ListRegionInstanceGroupManagersRequest.php +++ b/Compute/src/V1/ListRegionInstanceGroupManagersRequest.php @@ -16,25 +16,86 @@ class ListRegionInstanceGroupManagersRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -52,7 +113,11 @@ class ListRegionInstanceGroupManagersRequest extends \Google\Protobuf\Internal\M */ protected $region = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -80,19 +145,84 @@ public static function build(string $project, string $region): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type string $region * Name of the region scoping this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * } */ public function __construct($data = NULL) { @@ -101,7 +231,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -122,7 +299,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -137,7 +361,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -158,7 +386,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -173,7 +405,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -194,7 +434,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -209,7 +457,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -230,7 +480,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -297,7 +549,11 @@ public function setRegion($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -318,7 +574,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListRegionInstanceGroupsRequest.php b/Compute/src/V1/ListRegionInstanceGroupsRequest.php index e5f44af5d0f4..c44782bb5af9 100644 --- a/Compute/src/V1/ListRegionInstanceGroupsRequest.php +++ b/Compute/src/V1/ListRegionInstanceGroupsRequest.php @@ -16,25 +16,86 @@ class ListRegionInstanceGroupsRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -52,7 +113,11 @@ class ListRegionInstanceGroupsRequest extends \Google\Protobuf\Internal\Message */ protected $region = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -80,19 +145,84 @@ public static function build(string $project, string $region): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type string $region * Name of the region scoping this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * } */ public function __construct($data = NULL) { @@ -101,7 +231,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -122,7 +299,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -137,7 +361,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -158,7 +386,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -173,7 +405,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -194,7 +434,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -209,7 +457,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -230,7 +480,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -297,7 +549,11 @@ public function setRegion($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -318,7 +574,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListRegionInstanceTemplatesRequest.php b/Compute/src/V1/ListRegionInstanceTemplatesRequest.php index 81f48b3f0fe4..0e24b57af40a 100644 --- a/Compute/src/V1/ListRegionInstanceTemplatesRequest.php +++ b/Compute/src/V1/ListRegionInstanceTemplatesRequest.php @@ -16,25 +16,86 @@ class ListRegionInstanceTemplatesRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -52,7 +113,11 @@ class ListRegionInstanceTemplatesRequest extends \Google\Protobuf\Internal\Messa */ protected $region = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -80,19 +145,84 @@ public static function build(string $project, string $region): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type string $region * The name of the regions for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * } */ public function __construct($data = NULL) { @@ -101,7 +231,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -122,7 +299,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -137,7 +361,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -158,7 +386,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -173,7 +405,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -194,7 +434,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -209,7 +457,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -230,7 +480,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -297,7 +549,11 @@ public function setRegion($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -318,7 +574,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListRegionInstantSnapshotsRequest.php b/Compute/src/V1/ListRegionInstantSnapshotsRequest.php index 0938b406667d..a79ef706e555 100644 --- a/Compute/src/V1/ListRegionInstantSnapshotsRequest.php +++ b/Compute/src/V1/ListRegionInstantSnapshotsRequest.php @@ -16,25 +16,86 @@ class ListRegionInstantSnapshotsRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -52,7 +113,11 @@ class ListRegionInstantSnapshotsRequest extends \Google\Protobuf\Internal\Messag */ protected $region = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -80,19 +145,84 @@ public static function build(string $project, string $region): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type string $region * The name of the region for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * } */ public function __construct($data = NULL) { @@ -101,7 +231,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -122,7 +299,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -137,7 +361,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -158,7 +386,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -173,7 +405,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -194,7 +434,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -209,7 +457,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -230,7 +480,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -297,7 +549,11 @@ public function setRegion($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -318,7 +574,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListRegionNetworkEndpointGroupsRequest.php b/Compute/src/V1/ListRegionNetworkEndpointGroupsRequest.php index a6c6c3f78ee9..03fc89d4cedb 100644 --- a/Compute/src/V1/ListRegionNetworkEndpointGroupsRequest.php +++ b/Compute/src/V1/ListRegionNetworkEndpointGroupsRequest.php @@ -16,25 +16,86 @@ class ListRegionNetworkEndpointGroupsRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -46,13 +107,18 @@ class ListRegionNetworkEndpointGroupsRequest extends \Google\Protobuf\Internal\M */ protected $project = ''; /** - * The name of the region where the network endpoint group is located. It should comply with RFC1035. + * The name of theregion + * where the network endpoint group is located. It should comply with RFC1035. * * Generated from protobuf field string region = 138946292 [(.google.api.field_behavior) = REQUIRED]; */ protected $region = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -60,7 +126,8 @@ class ListRegionNetworkEndpointGroupsRequest extends \Google\Protobuf\Internal\M /** * @param string $project Project ID for this request. - * @param string $region The name of the region where the network endpoint group is located. It should comply with RFC1035. + * @param string $region The name of theregion + * where the network endpoint group is located. It should comply with RFC1035. * * @return \Google\Cloud\Compute\V1\ListRegionNetworkEndpointGroupsRequest * @@ -80,19 +147,85 @@ public static function build(string $project, string $region): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type string $region - * The name of the region where the network endpoint group is located. It should comply with RFC1035. + * The name of theregion + * where the network endpoint group is located. It should comply with RFC1035. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * } */ public function __construct($data = NULL) { @@ -101,7 +234,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -122,7 +302,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -137,7 +364,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -158,7 +389,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -173,7 +408,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -194,7 +437,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -209,7 +460,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -230,7 +483,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -271,7 +526,8 @@ public function setProject($var) } /** - * The name of the region where the network endpoint group is located. It should comply with RFC1035. + * The name of theregion + * where the network endpoint group is located. It should comply with RFC1035. * * Generated from protobuf field string region = 138946292 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -282,7 +538,8 @@ public function getRegion() } /** - * The name of the region where the network endpoint group is located. It should comply with RFC1035. + * The name of theregion + * where the network endpoint group is located. It should comply with RFC1035. * * Generated from protobuf field string region = 138946292 [(.google.api.field_behavior) = REQUIRED]; * @param string $var @@ -297,7 +554,11 @@ public function setRegion($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -318,7 +579,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListRegionNetworkFirewallPoliciesRequest.php b/Compute/src/V1/ListRegionNetworkFirewallPoliciesRequest.php index 5004e5a88ac5..67826f2b4291 100644 --- a/Compute/src/V1/ListRegionNetworkFirewallPoliciesRequest.php +++ b/Compute/src/V1/ListRegionNetworkFirewallPoliciesRequest.php @@ -16,25 +16,86 @@ class ListRegionNetworkFirewallPoliciesRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -52,7 +113,11 @@ class ListRegionNetworkFirewallPoliciesRequest extends \Google\Protobuf\Internal */ protected $region = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -80,19 +145,84 @@ public static function build(string $project, string $region): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type string $region * Name of the region scoping this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * } */ public function __construct($data = NULL) { @@ -101,7 +231,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -122,7 +299,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -137,7 +361,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -158,7 +386,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -173,7 +405,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -194,7 +434,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -209,7 +457,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -230,7 +480,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -297,7 +549,11 @@ public function setRegion($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -318,7 +574,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListRegionNotificationEndpointsRequest.php b/Compute/src/V1/ListRegionNotificationEndpointsRequest.php index 3c3c86333ba8..ea3a46d9f1d5 100644 --- a/Compute/src/V1/ListRegionNotificationEndpointsRequest.php +++ b/Compute/src/V1/ListRegionNotificationEndpointsRequest.php @@ -16,25 +16,86 @@ class ListRegionNotificationEndpointsRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -52,7 +113,11 @@ class ListRegionNotificationEndpointsRequest extends \Google\Protobuf\Internal\M */ protected $region = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -80,19 +145,84 @@ public static function build(string $project, string $region): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type string $region * Name of the region scoping this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * } */ public function __construct($data = NULL) { @@ -101,7 +231,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -122,7 +299,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -137,7 +361,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -158,7 +386,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -173,7 +405,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -194,7 +434,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -209,7 +457,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -230,7 +480,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -297,7 +549,11 @@ public function setRegion($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -318,7 +574,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListRegionOperationsRequest.php b/Compute/src/V1/ListRegionOperationsRequest.php index af55a58032e7..3bd9cf9d981d 100644 --- a/Compute/src/V1/ListRegionOperationsRequest.php +++ b/Compute/src/V1/ListRegionOperationsRequest.php @@ -16,25 +16,86 @@ class ListRegionOperationsRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -52,7 +113,11 @@ class ListRegionOperationsRequest extends \Google\Protobuf\Internal\Message */ protected $region = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -80,19 +145,84 @@ public static function build(string $project, string $region): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type string $region * Name of the region for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * } */ public function __construct($data = NULL) { @@ -101,7 +231,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -122,7 +299,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -137,7 +361,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -158,7 +386,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -173,7 +405,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -194,7 +434,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -209,7 +457,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -230,7 +480,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -297,7 +549,11 @@ public function setRegion($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -318,7 +574,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListRegionSecurityPoliciesRequest.php b/Compute/src/V1/ListRegionSecurityPoliciesRequest.php index 21ee41641241..456d64dd36f5 100644 --- a/Compute/src/V1/ListRegionSecurityPoliciesRequest.php +++ b/Compute/src/V1/ListRegionSecurityPoliciesRequest.php @@ -16,25 +16,86 @@ class ListRegionSecurityPoliciesRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -52,7 +113,11 @@ class ListRegionSecurityPoliciesRequest extends \Google\Protobuf\Internal\Messag */ protected $region = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -80,19 +145,84 @@ public static function build(string $project, string $region): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type string $region * Name of the region scoping this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * } */ public function __construct($data = NULL) { @@ -101,7 +231,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -122,7 +299,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -137,7 +361,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -158,7 +386,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -173,7 +405,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -194,7 +434,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -209,7 +457,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -230,7 +480,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -297,7 +549,11 @@ public function setRegion($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -318,7 +574,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListRegionSslCertificatesRequest.php b/Compute/src/V1/ListRegionSslCertificatesRequest.php index c735791ddc27..ff33aa1c00f3 100644 --- a/Compute/src/V1/ListRegionSslCertificatesRequest.php +++ b/Compute/src/V1/ListRegionSslCertificatesRequest.php @@ -16,25 +16,86 @@ class ListRegionSslCertificatesRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -52,7 +113,11 @@ class ListRegionSslCertificatesRequest extends \Google\Protobuf\Internal\Message */ protected $region = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -80,19 +145,84 @@ public static function build(string $project, string $region): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type string $region * Name of the region scoping this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * } */ public function __construct($data = NULL) { @@ -101,7 +231,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -122,7 +299,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -137,7 +361,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -158,7 +386,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -173,7 +405,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -194,7 +434,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -209,7 +457,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -230,7 +480,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -297,7 +549,11 @@ public function setRegion($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -318,7 +574,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListRegionSslPoliciesRequest.php b/Compute/src/V1/ListRegionSslPoliciesRequest.php index c015a934c39d..2d5270540828 100644 --- a/Compute/src/V1/ListRegionSslPoliciesRequest.php +++ b/Compute/src/V1/ListRegionSslPoliciesRequest.php @@ -16,25 +16,86 @@ class ListRegionSslPoliciesRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -52,7 +113,11 @@ class ListRegionSslPoliciesRequest extends \Google\Protobuf\Internal\Message */ protected $region = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -80,19 +145,84 @@ public static function build(string $project, string $region): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type string $region * Name of the region scoping this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * } */ public function __construct($data = NULL) { @@ -101,7 +231,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -122,7 +299,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -137,7 +361,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -158,7 +386,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -173,7 +405,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -194,7 +434,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -209,7 +457,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -230,7 +480,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -297,7 +549,11 @@ public function setRegion($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -318,7 +574,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListRegionTargetHttpProxiesRequest.php b/Compute/src/V1/ListRegionTargetHttpProxiesRequest.php index 27b97bbda890..953151496440 100644 --- a/Compute/src/V1/ListRegionTargetHttpProxiesRequest.php +++ b/Compute/src/V1/ListRegionTargetHttpProxiesRequest.php @@ -16,25 +16,86 @@ class ListRegionTargetHttpProxiesRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -52,7 +113,11 @@ class ListRegionTargetHttpProxiesRequest extends \Google\Protobuf\Internal\Messa */ protected $region = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -80,19 +145,84 @@ public static function build(string $project, string $region): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type string $region * Name of the region scoping this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * } */ public function __construct($data = NULL) { @@ -101,7 +231,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -122,7 +299,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -137,7 +361,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -158,7 +386,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -173,7 +405,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -194,7 +434,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -209,7 +457,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -230,7 +480,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -297,7 +549,11 @@ public function setRegion($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -318,7 +574,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListRegionTargetHttpsProxiesRequest.php b/Compute/src/V1/ListRegionTargetHttpsProxiesRequest.php index 7fb002d3983a..a6f87f561884 100644 --- a/Compute/src/V1/ListRegionTargetHttpsProxiesRequest.php +++ b/Compute/src/V1/ListRegionTargetHttpsProxiesRequest.php @@ -16,25 +16,86 @@ class ListRegionTargetHttpsProxiesRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -52,7 +113,11 @@ class ListRegionTargetHttpsProxiesRequest extends \Google\Protobuf\Internal\Mess */ protected $region = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -80,19 +145,84 @@ public static function build(string $project, string $region): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type string $region * Name of the region scoping this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * } */ public function __construct($data = NULL) { @@ -101,7 +231,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -122,7 +299,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -137,7 +361,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -158,7 +386,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -173,7 +405,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -194,7 +434,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -209,7 +457,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -230,7 +480,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -297,7 +549,11 @@ public function setRegion($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -318,7 +574,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListRegionTargetTcpProxiesRequest.php b/Compute/src/V1/ListRegionTargetTcpProxiesRequest.php index 726637e34eef..a9109e834686 100644 --- a/Compute/src/V1/ListRegionTargetTcpProxiesRequest.php +++ b/Compute/src/V1/ListRegionTargetTcpProxiesRequest.php @@ -16,25 +16,86 @@ class ListRegionTargetTcpProxiesRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -52,7 +113,11 @@ class ListRegionTargetTcpProxiesRequest extends \Google\Protobuf\Internal\Messag */ protected $region = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -80,19 +145,84 @@ public static function build(string $project, string $region): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type string $region * Name of the region scoping this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * } */ public function __construct($data = NULL) { @@ -101,7 +231,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -122,7 +299,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -137,7 +361,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -158,7 +386,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -173,7 +405,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -194,7 +434,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -209,7 +457,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -230,7 +480,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -297,7 +549,11 @@ public function setRegion($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -318,7 +574,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListRegionUrlMapsRequest.php b/Compute/src/V1/ListRegionUrlMapsRequest.php index 3bf359a0e1a4..c8b49d3300ca 100644 --- a/Compute/src/V1/ListRegionUrlMapsRequest.php +++ b/Compute/src/V1/ListRegionUrlMapsRequest.php @@ -16,25 +16,86 @@ class ListRegionUrlMapsRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -52,7 +113,11 @@ class ListRegionUrlMapsRequest extends \Google\Protobuf\Internal\Message */ protected $region = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -80,19 +145,84 @@ public static function build(string $project, string $region): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type string $region * Name of the region scoping this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * } */ public function __construct($data = NULL) { @@ -101,7 +231,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -122,7 +299,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -137,7 +361,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -158,7 +386,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -173,7 +405,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -194,7 +434,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -209,7 +457,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -230,7 +480,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -297,7 +549,11 @@ public function setRegion($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -318,7 +574,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListRegionZonesRequest.php b/Compute/src/V1/ListRegionZonesRequest.php index a3ea570d9561..d07299ed9ea8 100644 --- a/Compute/src/V1/ListRegionZonesRequest.php +++ b/Compute/src/V1/ListRegionZonesRequest.php @@ -16,25 +16,86 @@ class ListRegionZonesRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -52,7 +113,11 @@ class ListRegionZonesRequest extends \Google\Protobuf\Internal\Message */ protected $region = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -80,19 +145,84 @@ public static function build(string $project, string $region): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type string $region * Region for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * } */ public function __construct($data = NULL) { @@ -101,7 +231,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -122,7 +299,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -137,7 +361,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -158,7 +386,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -173,7 +405,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -194,7 +434,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -209,7 +457,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -230,7 +480,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -297,7 +549,11 @@ public function setRegion($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -318,7 +574,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListRegionsRequest.php b/Compute/src/V1/ListRegionsRequest.php index ed9bbf043a27..b42eec566c5b 100644 --- a/Compute/src/V1/ListRegionsRequest.php +++ b/Compute/src/V1/ListRegionsRequest.php @@ -16,25 +16,86 @@ class ListRegionsRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -46,7 +107,11 @@ class ListRegionsRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -72,17 +137,82 @@ public static function build(string $project): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * } */ public function __construct($data = NULL) { @@ -91,7 +221,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -112,7 +289,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -127,7 +351,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -148,7 +376,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -163,7 +395,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -184,7 +424,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -199,7 +447,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -220,7 +470,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -261,7 +513,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -282,7 +538,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListReservationBlocksRequest.php b/Compute/src/V1/ListReservationBlocksRequest.php index f3fbb287efbd..90c062de7e40 100644 --- a/Compute/src/V1/ListReservationBlocksRequest.php +++ b/Compute/src/V1/ListReservationBlocksRequest.php @@ -16,25 +16,86 @@ class ListReservationBlocksRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -46,13 +107,18 @@ class ListReservationBlocksRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * The name of the reservation. Name should conform to RFC1035 or be a resource ID. + * The name of the reservation. + * Name should conform to RFC1035 or be a resource ID. * * Generated from protobuf field string reservation = 47530956 [(.google.api.field_behavior) = REQUIRED]; */ protected $reservation = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -67,7 +133,8 @@ class ListReservationBlocksRequest extends \Google\Protobuf\Internal\Message /** * @param string $project Project ID for this request. * @param string $zone Name of the zone for this request. Zone name should conform to RFC1035. - * @param string $reservation The name of the reservation. Name should conform to RFC1035 or be a resource ID. + * @param string $reservation The name of the reservation. + * Name should conform to RFC1035 or be a resource ID. * * @return \Google\Cloud\Compute\V1\ListReservationBlocksRequest * @@ -88,19 +155,85 @@ public static function build(string $project, string $zone, string $reservation) * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type string $reservation - * The name of the reservation. Name should conform to RFC1035 or be a resource ID. + * The name of the reservation. + * Name should conform to RFC1035 or be a resource ID. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * @type string $zone * Name of the zone for this request. Zone name should conform to RFC1035. * } @@ -111,7 +244,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -132,7 +312,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -147,7 +374,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -168,7 +399,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -183,7 +418,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -204,7 +447,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -219,7 +470,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -240,7 +493,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -281,7 +536,8 @@ public function setProject($var) } /** - * The name of the reservation. Name should conform to RFC1035 or be a resource ID. + * The name of the reservation. + * Name should conform to RFC1035 or be a resource ID. * * Generated from protobuf field string reservation = 47530956 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -292,7 +548,8 @@ public function getReservation() } /** - * The name of the reservation. Name should conform to RFC1035 or be a resource ID. + * The name of the reservation. + * Name should conform to RFC1035 or be a resource ID. * * Generated from protobuf field string reservation = 47530956 [(.google.api.field_behavior) = REQUIRED]; * @param string $var @@ -307,7 +564,11 @@ public function setReservation($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -328,7 +589,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListReservationSubBlocksRequest.php b/Compute/src/V1/ListReservationSubBlocksRequest.php index dbaf6ff0dc51..73d99818d0f5 100644 --- a/Compute/src/V1/ListReservationSubBlocksRequest.php +++ b/Compute/src/V1/ListReservationSubBlocksRequest.php @@ -16,31 +16,93 @@ class ListReservationSubBlocksRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ protected $page_token = null; /** - * The name of the parent reservation and parent block. In the format of reservations/{reservation_name}/reservationBlocks/{reservation_block_name} + * The name of the parent reservation and parent block. In the format of + * reservations/{reservation_name}/reservationBlocks/{reservation_block_name} * * Generated from protobuf field string parent_name = 478151936 [(.google.api.field_behavior) = REQUIRED]; */ @@ -52,7 +114,11 @@ class ListReservationSubBlocksRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -67,7 +133,8 @@ class ListReservationSubBlocksRequest extends \Google\Protobuf\Internal\Message /** * @param string $project Project ID for this request. * @param string $zone Name of the zone for this request. Zone name should conform to RFC1035. - * @param string $parentName The name of the parent reservation and parent block. In the format of reservations/{reservation_name}/reservationBlocks/{reservation_block_name} + * @param string $parentName The name of the parent reservation and parent block. In the format of + * reservations/{reservation_name}/reservationBlocks/{reservation_block_name} * * @return \Google\Cloud\Compute\V1\ListReservationSubBlocksRequest * @@ -88,19 +155,85 @@ public static function build(string $project, string $zone, string $parentName): * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $parent_name - * The name of the parent reservation and parent block. In the format of reservations/{reservation_name}/reservationBlocks/{reservation_block_name} + * The name of the parent reservation and parent block. In the format of + * reservations/{reservation_name}/reservationBlocks/{reservation_block_name} * @type string $project * Project ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * @type string $zone * Name of the zone for this request. Zone name should conform to RFC1035. * } @@ -111,7 +244,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -132,7 +312,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -147,7 +374,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -168,7 +399,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -183,7 +418,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -204,7 +447,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -219,7 +470,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -240,7 +493,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -255,7 +510,8 @@ public function setPageToken($var) } /** - * The name of the parent reservation and parent block. In the format of reservations/{reservation_name}/reservationBlocks/{reservation_block_name} + * The name of the parent reservation and parent block. In the format of + * reservations/{reservation_name}/reservationBlocks/{reservation_block_name} * * Generated from protobuf field string parent_name = 478151936 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -266,7 +522,8 @@ public function getParentName() } /** - * The name of the parent reservation and parent block. In the format of reservations/{reservation_name}/reservationBlocks/{reservation_block_name} + * The name of the parent reservation and parent block. In the format of + * reservations/{reservation_name}/reservationBlocks/{reservation_block_name} * * Generated from protobuf field string parent_name = 478151936 [(.google.api.field_behavior) = REQUIRED]; * @param string $var @@ -307,7 +564,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -328,7 +589,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListReservationsRequest.php b/Compute/src/V1/ListReservationsRequest.php index 7b83d9d0bd1c..efda5b77fd18 100644 --- a/Compute/src/V1/ListReservationsRequest.php +++ b/Compute/src/V1/ListReservationsRequest.php @@ -16,25 +16,86 @@ class ListReservationsRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -46,7 +107,11 @@ class ListReservationsRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -80,17 +145,82 @@ public static function build(string $project, string $zone): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * @type string $zone * Name of the zone for this request. * } @@ -101,7 +231,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -122,7 +299,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -137,7 +361,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -158,7 +386,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -173,7 +405,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -194,7 +434,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -209,7 +457,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -230,7 +480,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -271,7 +523,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -292,7 +548,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListResourcePoliciesRequest.php b/Compute/src/V1/ListResourcePoliciesRequest.php index f88a19617577..adc1cfb6fd3a 100644 --- a/Compute/src/V1/ListResourcePoliciesRequest.php +++ b/Compute/src/V1/ListResourcePoliciesRequest.php @@ -16,25 +16,86 @@ class ListResourcePoliciesRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -52,7 +113,11 @@ class ListResourcePoliciesRequest extends \Google\Protobuf\Internal\Message */ protected $region = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -80,19 +145,84 @@ public static function build(string $project, string $region): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type string $region * Name of the region for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * } */ public function __construct($data = NULL) { @@ -101,7 +231,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -122,7 +299,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -137,7 +361,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -158,7 +386,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -173,7 +405,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -194,7 +434,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -209,7 +457,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -230,7 +480,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -297,7 +549,11 @@ public function setRegion($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -318,7 +574,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListRoutePoliciesRoutersRequest.php b/Compute/src/V1/ListRoutePoliciesRoutersRequest.php index 392297563cdd..b0e3da2f1cbf 100644 --- a/Compute/src/V1/ListRoutePoliciesRoutersRequest.php +++ b/Compute/src/V1/ListRoutePoliciesRoutersRequest.php @@ -16,25 +16,86 @@ class ListRoutePoliciesRoutersRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -52,13 +113,18 @@ class ListRoutePoliciesRoutersRequest extends \Google\Protobuf\Internal\Message */ protected $region = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ protected $return_partial_success = null; /** - * Name or id of the resource for this request. Name should conform to RFC1035. + * Name or id of the resource for this request. + * Name should conform to RFC1035. * * Generated from protobuf field string router = 148608841 [(.google.api.field_behavior) = REQUIRED]; */ @@ -67,7 +133,8 @@ class ListRoutePoliciesRoutersRequest extends \Google\Protobuf\Internal\Message /** * @param string $project Project ID for this request. * @param string $region Name of the region for this request. - * @param string $router Name or id of the resource for this request. Name should conform to RFC1035. + * @param string $router Name or id of the resource for this request. + * Name should conform to RFC1035. * * @return \Google\Cloud\Compute\V1\ListRoutePoliciesRoutersRequest * @@ -88,21 +155,87 @@ public static function build(string $project, string $region, string $router): s * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type string $region * Name of the region for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * @type string $router - * Name or id of the resource for this request. Name should conform to RFC1035. + * Name or id of the resource for this request. + * Name should conform to RFC1035. * } */ public function __construct($data = NULL) { @@ -111,7 +244,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -132,7 +312,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -147,7 +374,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -168,7 +399,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -183,7 +418,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -204,7 +447,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -219,7 +470,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -240,7 +493,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -307,7 +562,11 @@ public function setRegion($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -328,7 +587,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var @@ -343,7 +606,8 @@ public function setReturnPartialSuccess($var) } /** - * Name or id of the resource for this request. Name should conform to RFC1035. + * Name or id of the resource for this request. + * Name should conform to RFC1035. * * Generated from protobuf field string router = 148608841 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -354,7 +618,8 @@ public function getRouter() } /** - * Name or id of the resource for this request. Name should conform to RFC1035. + * Name or id of the resource for this request. + * Name should conform to RFC1035. * * Generated from protobuf field string router = 148608841 [(.google.api.field_behavior) = REQUIRED]; * @param string $var diff --git a/Compute/src/V1/ListRoutersRequest.php b/Compute/src/V1/ListRoutersRequest.php index c8ee80df82e9..f6409dad4fbe 100644 --- a/Compute/src/V1/ListRoutersRequest.php +++ b/Compute/src/V1/ListRoutersRequest.php @@ -16,25 +16,86 @@ class ListRoutersRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -52,7 +113,11 @@ class ListRoutersRequest extends \Google\Protobuf\Internal\Message */ protected $region = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -80,19 +145,84 @@ public static function build(string $project, string $region): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type string $region * Name of the region for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * } */ public function __construct($data = NULL) { @@ -101,7 +231,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -122,7 +299,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -137,7 +361,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -158,7 +386,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -173,7 +405,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -194,7 +434,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -209,7 +457,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -230,7 +480,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -297,7 +549,11 @@ public function setRegion($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -318,7 +574,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListRoutesRequest.php b/Compute/src/V1/ListRoutesRequest.php index c43a36598d23..1f8fc073a2ff 100644 --- a/Compute/src/V1/ListRoutesRequest.php +++ b/Compute/src/V1/ListRoutesRequest.php @@ -16,25 +16,86 @@ class ListRoutesRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -46,7 +107,11 @@ class ListRoutesRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -72,17 +137,82 @@ public static function build(string $project): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * } */ public function __construct($data = NULL) { @@ -91,7 +221,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -112,7 +289,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -127,7 +351,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -148,7 +376,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -163,7 +395,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -184,7 +424,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -199,7 +447,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -220,7 +470,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -261,7 +513,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -282,7 +538,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListSecurityPoliciesRequest.php b/Compute/src/V1/ListSecurityPoliciesRequest.php index 3cbc09205eb8..c0c90a493511 100644 --- a/Compute/src/V1/ListSecurityPoliciesRequest.php +++ b/Compute/src/V1/ListSecurityPoliciesRequest.php @@ -16,25 +16,86 @@ class ListSecurityPoliciesRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -46,7 +107,11 @@ class ListSecurityPoliciesRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -72,17 +137,82 @@ public static function build(string $project): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * } */ public function __construct($data = NULL) { @@ -91,7 +221,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -112,7 +289,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -127,7 +351,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -148,7 +376,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -163,7 +395,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -184,7 +424,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -199,7 +447,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -220,7 +470,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -261,7 +513,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -282,7 +538,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListServiceAttachmentsRequest.php b/Compute/src/V1/ListServiceAttachmentsRequest.php index 7c85bc6f53f1..c0814ed6e616 100644 --- a/Compute/src/V1/ListServiceAttachmentsRequest.php +++ b/Compute/src/V1/ListServiceAttachmentsRequest.php @@ -16,25 +16,86 @@ class ListServiceAttachmentsRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -52,7 +113,11 @@ class ListServiceAttachmentsRequest extends \Google\Protobuf\Internal\Message */ protected $region = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -80,19 +145,84 @@ public static function build(string $project, string $region): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type string $region * Name of the region of this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * } */ public function __construct($data = NULL) { @@ -101,7 +231,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -122,7 +299,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -137,7 +361,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -158,7 +386,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -173,7 +405,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -194,7 +434,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -209,7 +457,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -230,7 +480,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -297,7 +549,11 @@ public function setRegion($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -318,7 +574,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListSnapshotsRequest.php b/Compute/src/V1/ListSnapshotsRequest.php index ca61701d4f9c..5598101ef69e 100644 --- a/Compute/src/V1/ListSnapshotsRequest.php +++ b/Compute/src/V1/ListSnapshotsRequest.php @@ -16,25 +16,86 @@ class ListSnapshotsRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -46,7 +107,11 @@ class ListSnapshotsRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -72,17 +137,82 @@ public static function build(string $project): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * } */ public function __construct($data = NULL) { @@ -91,7 +221,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -112,7 +289,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -127,7 +351,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -148,7 +376,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -163,7 +395,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -184,7 +424,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -199,7 +447,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -220,7 +470,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -261,7 +513,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -282,7 +538,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListSslCertificatesRequest.php b/Compute/src/V1/ListSslCertificatesRequest.php index abd9b6caf7ca..c257b9fe9ec5 100644 --- a/Compute/src/V1/ListSslCertificatesRequest.php +++ b/Compute/src/V1/ListSslCertificatesRequest.php @@ -16,25 +16,86 @@ class ListSslCertificatesRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -46,7 +107,11 @@ class ListSslCertificatesRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -72,17 +137,82 @@ public static function build(string $project): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * } */ public function __construct($data = NULL) { @@ -91,7 +221,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -112,7 +289,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -127,7 +351,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -148,7 +376,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -163,7 +395,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -184,7 +424,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -199,7 +447,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -220,7 +470,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -261,7 +513,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -282,7 +538,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListSslPoliciesRequest.php b/Compute/src/V1/ListSslPoliciesRequest.php index f5cb2b4cf316..c211a4a914df 100644 --- a/Compute/src/V1/ListSslPoliciesRequest.php +++ b/Compute/src/V1/ListSslPoliciesRequest.php @@ -16,25 +16,86 @@ class ListSslPoliciesRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -46,7 +107,11 @@ class ListSslPoliciesRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -72,17 +137,82 @@ public static function build(string $project): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * } */ public function __construct($data = NULL) { @@ -91,7 +221,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -112,7 +289,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -127,7 +351,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -148,7 +376,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -163,7 +395,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -184,7 +424,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -199,7 +447,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -220,7 +470,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -261,7 +513,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -282,7 +538,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListStoragePoolTypesRequest.php b/Compute/src/V1/ListStoragePoolTypesRequest.php index 30059f2b667e..34fc0ea99db1 100644 --- a/Compute/src/V1/ListStoragePoolTypesRequest.php +++ b/Compute/src/V1/ListStoragePoolTypesRequest.php @@ -16,25 +16,86 @@ class ListStoragePoolTypesRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -46,7 +107,11 @@ class ListStoragePoolTypesRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -80,17 +145,82 @@ public static function build(string $project, string $zone): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * @type string $zone * The name of the zone for this request. * } @@ -101,7 +231,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -122,7 +299,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -137,7 +361,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -158,7 +386,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -173,7 +405,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -194,7 +434,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -209,7 +457,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -230,7 +480,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -271,7 +523,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -292,7 +548,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListStoragePoolsRequest.php b/Compute/src/V1/ListStoragePoolsRequest.php index c509861733a6..09f162b6e1f2 100644 --- a/Compute/src/V1/ListStoragePoolsRequest.php +++ b/Compute/src/V1/ListStoragePoolsRequest.php @@ -16,25 +16,86 @@ class ListStoragePoolsRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -46,7 +107,11 @@ class ListStoragePoolsRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -80,17 +145,82 @@ public static function build(string $project, string $zone): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * @type string $zone * The name of the zone for this request. * } @@ -101,7 +231,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -122,7 +299,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -137,7 +361,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -158,7 +386,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -173,7 +405,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -194,7 +434,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -209,7 +457,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -230,7 +480,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -271,7 +523,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -292,7 +548,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListSubnetworksRequest.php b/Compute/src/V1/ListSubnetworksRequest.php index 55d0586c0aa9..d6165309f62b 100644 --- a/Compute/src/V1/ListSubnetworksRequest.php +++ b/Compute/src/V1/ListSubnetworksRequest.php @@ -16,25 +16,86 @@ class ListSubnetworksRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -52,13 +113,20 @@ class ListSubnetworksRequest extends \Google\Protobuf\Internal\Message */ protected $region = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ protected $return_partial_success = null; /** - * Defines the extra views returned back in the subnetwork resource. Supported values: - WITH_UTILIZATION: Utilization data is included in the response. + * Defines the extra views returned back in the subnetwork resource. + * Supported values: + * - WITH_UTILIZATION: Utilization data is included in the + * response. * Check the Views enum for the list of possible values. * * Generated from protobuf field optional string views = 112204398; @@ -87,21 +155,89 @@ public static function build(string $project, string $region): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type string $region * Name of the region scoping this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * @type string $views - * Defines the extra views returned back in the subnetwork resource. Supported values: - WITH_UTILIZATION: Utilization data is included in the response. + * Defines the extra views returned back in the subnetwork resource. + * Supported values: + * - WITH_UTILIZATION: Utilization data is included in the + * response. * Check the Views enum for the list of possible values. * } */ @@ -111,7 +247,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -132,7 +315,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -147,7 +377,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -168,7 +402,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -183,7 +421,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -204,7 +450,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -219,7 +473,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -240,7 +496,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -307,7 +565,11 @@ public function setRegion($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -328,7 +590,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var @@ -343,7 +609,10 @@ public function setReturnPartialSuccess($var) } /** - * Defines the extra views returned back in the subnetwork resource. Supported values: - WITH_UTILIZATION: Utilization data is included in the response. + * Defines the extra views returned back in the subnetwork resource. + * Supported values: + * - WITH_UTILIZATION: Utilization data is included in the + * response. * Check the Views enum for the list of possible values. * * Generated from protobuf field optional string views = 112204398; @@ -365,7 +634,10 @@ public function clearViews() } /** - * Defines the extra views returned back in the subnetwork resource. Supported values: - WITH_UTILIZATION: Utilization data is included in the response. + * Defines the extra views returned back in the subnetwork resource. + * Supported values: + * - WITH_UTILIZATION: Utilization data is included in the + * response. * Check the Views enum for the list of possible values. * * Generated from protobuf field optional string views = 112204398; diff --git a/Compute/src/V1/ListSubnetworksRequest/Views.php b/Compute/src/V1/ListSubnetworksRequest/Views.php index a29ccbb591a8..0ed7056adbcd 100644 --- a/Compute/src/V1/ListSubnetworksRequest/Views.php +++ b/Compute/src/V1/ListSubnetworksRequest/Views.php @@ -7,7 +7,10 @@ use UnexpectedValueException; /** - * Defines the extra views returned back in the subnetwork resource. Supported values: - WITH_UTILIZATION: Utilization data is included in the response. + * Defines the extra views returned back in the subnetwork resource. + * Supported values: + * - WITH_UTILIZATION: Utilization data is included in the + * response. * * Protobuf type google.cloud.compute.v1.ListSubnetworksRequest.Views */ diff --git a/Compute/src/V1/ListTargetGrpcProxiesRequest.php b/Compute/src/V1/ListTargetGrpcProxiesRequest.php index 04fa1d142e50..fcd41fc4cbed 100644 --- a/Compute/src/V1/ListTargetGrpcProxiesRequest.php +++ b/Compute/src/V1/ListTargetGrpcProxiesRequest.php @@ -16,25 +16,86 @@ class ListTargetGrpcProxiesRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -46,7 +107,11 @@ class ListTargetGrpcProxiesRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -72,17 +137,82 @@ public static function build(string $project): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * } */ public function __construct($data = NULL) { @@ -91,7 +221,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -112,7 +289,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -127,7 +351,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -148,7 +376,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -163,7 +395,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -184,7 +424,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -199,7 +447,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -220,7 +470,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -261,7 +513,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -282,7 +538,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListTargetHttpProxiesRequest.php b/Compute/src/V1/ListTargetHttpProxiesRequest.php index b68b8e1b0920..e50702fc1541 100644 --- a/Compute/src/V1/ListTargetHttpProxiesRequest.php +++ b/Compute/src/V1/ListTargetHttpProxiesRequest.php @@ -16,25 +16,86 @@ class ListTargetHttpProxiesRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -46,7 +107,11 @@ class ListTargetHttpProxiesRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -72,17 +137,82 @@ public static function build(string $project): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * } */ public function __construct($data = NULL) { @@ -91,7 +221,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -112,7 +289,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -127,7 +351,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -148,7 +376,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -163,7 +395,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -184,7 +424,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -199,7 +447,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -220,7 +470,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -261,7 +513,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -282,7 +538,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListTargetHttpsProxiesRequest.php b/Compute/src/V1/ListTargetHttpsProxiesRequest.php index 837c13efc9bb..48cdb4568100 100644 --- a/Compute/src/V1/ListTargetHttpsProxiesRequest.php +++ b/Compute/src/V1/ListTargetHttpsProxiesRequest.php @@ -16,25 +16,86 @@ class ListTargetHttpsProxiesRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -46,7 +107,11 @@ class ListTargetHttpsProxiesRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -72,17 +137,82 @@ public static function build(string $project): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * } */ public function __construct($data = NULL) { @@ -91,7 +221,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -112,7 +289,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -127,7 +351,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -148,7 +376,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -163,7 +395,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -184,7 +424,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -199,7 +447,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -220,7 +470,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -261,7 +513,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -282,7 +538,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListTargetInstancesRequest.php b/Compute/src/V1/ListTargetInstancesRequest.php index aab9d93e9064..438e01585cfd 100644 --- a/Compute/src/V1/ListTargetInstancesRequest.php +++ b/Compute/src/V1/ListTargetInstancesRequest.php @@ -16,25 +16,86 @@ class ListTargetInstancesRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -46,7 +107,11 @@ class ListTargetInstancesRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -80,17 +145,82 @@ public static function build(string $project, string $zone): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * @type string $zone * Name of the zone scoping this request. * } @@ -101,7 +231,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -122,7 +299,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -137,7 +361,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -158,7 +386,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -173,7 +405,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -194,7 +434,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -209,7 +457,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -230,7 +480,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -271,7 +523,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -292,7 +548,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListTargetPoolsRequest.php b/Compute/src/V1/ListTargetPoolsRequest.php index 17078508d504..d861a575d3a0 100644 --- a/Compute/src/V1/ListTargetPoolsRequest.php +++ b/Compute/src/V1/ListTargetPoolsRequest.php @@ -16,25 +16,86 @@ class ListTargetPoolsRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -52,7 +113,11 @@ class ListTargetPoolsRequest extends \Google\Protobuf\Internal\Message */ protected $region = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -80,19 +145,84 @@ public static function build(string $project, string $region): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type string $region * Name of the region scoping this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * } */ public function __construct($data = NULL) { @@ -101,7 +231,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -122,7 +299,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -137,7 +361,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -158,7 +386,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -173,7 +405,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -194,7 +434,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -209,7 +457,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -230,7 +480,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -297,7 +549,11 @@ public function setRegion($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -318,7 +574,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListTargetSslProxiesRequest.php b/Compute/src/V1/ListTargetSslProxiesRequest.php index a23a676b1231..320ee6ccd245 100644 --- a/Compute/src/V1/ListTargetSslProxiesRequest.php +++ b/Compute/src/V1/ListTargetSslProxiesRequest.php @@ -16,25 +16,86 @@ class ListTargetSslProxiesRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -46,7 +107,11 @@ class ListTargetSslProxiesRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -72,17 +137,82 @@ public static function build(string $project): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * } */ public function __construct($data = NULL) { @@ -91,7 +221,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -112,7 +289,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -127,7 +351,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -148,7 +376,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -163,7 +395,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -184,7 +424,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -199,7 +447,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -220,7 +470,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -261,7 +513,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -282,7 +538,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListTargetTcpProxiesRequest.php b/Compute/src/V1/ListTargetTcpProxiesRequest.php index 03b1be115703..3f24786e4a97 100644 --- a/Compute/src/V1/ListTargetTcpProxiesRequest.php +++ b/Compute/src/V1/ListTargetTcpProxiesRequest.php @@ -16,25 +16,86 @@ class ListTargetTcpProxiesRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -46,7 +107,11 @@ class ListTargetTcpProxiesRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -72,17 +137,82 @@ public static function build(string $project): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * } */ public function __construct($data = NULL) { @@ -91,7 +221,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -112,7 +289,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -127,7 +351,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -148,7 +376,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -163,7 +395,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -184,7 +424,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -199,7 +447,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -220,7 +470,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -261,7 +513,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -282,7 +538,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListTargetVpnGatewaysRequest.php b/Compute/src/V1/ListTargetVpnGatewaysRequest.php index aeff9329739b..76c53b00c517 100644 --- a/Compute/src/V1/ListTargetVpnGatewaysRequest.php +++ b/Compute/src/V1/ListTargetVpnGatewaysRequest.php @@ -16,25 +16,86 @@ class ListTargetVpnGatewaysRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -52,7 +113,11 @@ class ListTargetVpnGatewaysRequest extends \Google\Protobuf\Internal\Message */ protected $region = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -80,19 +145,84 @@ public static function build(string $project, string $region): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type string $region * Name of the region for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * } */ public function __construct($data = NULL) { @@ -101,7 +231,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -122,7 +299,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -137,7 +361,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -158,7 +386,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -173,7 +405,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -194,7 +434,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -209,7 +457,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -230,7 +480,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -297,7 +549,11 @@ public function setRegion($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -318,7 +574,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListUrlMapsRequest.php b/Compute/src/V1/ListUrlMapsRequest.php index df34e7227dbe..94b5fdcff0ef 100644 --- a/Compute/src/V1/ListUrlMapsRequest.php +++ b/Compute/src/V1/ListUrlMapsRequest.php @@ -16,25 +16,86 @@ class ListUrlMapsRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -46,7 +107,11 @@ class ListUrlMapsRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -72,17 +137,82 @@ public static function build(string $project): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * } */ public function __construct($data = NULL) { @@ -91,7 +221,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -112,7 +289,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -127,7 +351,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -148,7 +376,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -163,7 +395,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -184,7 +424,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -199,7 +447,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -220,7 +470,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -261,7 +513,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -282,7 +538,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListUsableBackendServicesRequest.php b/Compute/src/V1/ListUsableBackendServicesRequest.php index a279e5975cf5..bc2421b6e6f9 100644 --- a/Compute/src/V1/ListUsableBackendServicesRequest.php +++ b/Compute/src/V1/ListUsableBackendServicesRequest.php @@ -16,25 +16,86 @@ class ListUsableBackendServicesRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -46,7 +107,11 @@ class ListUsableBackendServicesRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -72,17 +137,82 @@ public static function build(string $project): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * } */ public function __construct($data = NULL) { @@ -91,7 +221,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -112,7 +289,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -127,7 +351,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -148,7 +376,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -163,7 +395,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -184,7 +424,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -199,7 +447,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -220,7 +470,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -261,7 +513,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -282,7 +538,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListUsableRegionBackendServicesRequest.php b/Compute/src/V1/ListUsableRegionBackendServicesRequest.php index 53e0157a26a1..67c440f26de1 100644 --- a/Compute/src/V1/ListUsableRegionBackendServicesRequest.php +++ b/Compute/src/V1/ListUsableRegionBackendServicesRequest.php @@ -16,25 +16,86 @@ class ListUsableRegionBackendServicesRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -46,13 +107,18 @@ class ListUsableRegionBackendServicesRequest extends \Google\Protobuf\Internal\M */ protected $project = ''; /** - * Name of the region scoping this request. It must be a string that meets the requirements in RFC1035. + * Name of the region scoping this request. + * It must be a string that meets the requirements in RFC1035. * * Generated from protobuf field string region = 138946292 [(.google.api.field_behavior) = REQUIRED]; */ protected $region = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -60,7 +126,8 @@ class ListUsableRegionBackendServicesRequest extends \Google\Protobuf\Internal\M /** * @param string $project Project ID for this request. - * @param string $region Name of the region scoping this request. It must be a string that meets the requirements in RFC1035. + * @param string $region Name of the region scoping this request. + * It must be a string that meets the requirements in RFC1035. * * @return \Google\Cloud\Compute\V1\ListUsableRegionBackendServicesRequest * @@ -80,19 +147,85 @@ public static function build(string $project, string $region): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type string $region - * Name of the region scoping this request. It must be a string that meets the requirements in RFC1035. + * Name of the region scoping this request. + * It must be a string that meets the requirements in RFC1035. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * } */ public function __construct($data = NULL) { @@ -101,7 +234,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -122,7 +302,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -137,7 +364,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -158,7 +389,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -173,7 +408,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -194,7 +437,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -209,7 +460,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -230,7 +483,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -271,7 +526,8 @@ public function setProject($var) } /** - * Name of the region scoping this request. It must be a string that meets the requirements in RFC1035. + * Name of the region scoping this request. + * It must be a string that meets the requirements in RFC1035. * * Generated from protobuf field string region = 138946292 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -282,7 +538,8 @@ public function getRegion() } /** - * Name of the region scoping this request. It must be a string that meets the requirements in RFC1035. + * Name of the region scoping this request. + * It must be a string that meets the requirements in RFC1035. * * Generated from protobuf field string region = 138946292 [(.google.api.field_behavior) = REQUIRED]; * @param string $var @@ -297,7 +554,11 @@ public function setRegion($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -318,7 +579,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListUsableSubnetworksRequest.php b/Compute/src/V1/ListUsableSubnetworksRequest.php index acc930ed4713..c21c8537137d 100644 --- a/Compute/src/V1/ListUsableSubnetworksRequest.php +++ b/Compute/src/V1/ListUsableSubnetworksRequest.php @@ -16,25 +16,86 @@ class ListUsableSubnetworksRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -46,13 +107,19 @@ class ListUsableSubnetworksRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ protected $return_partial_success = null; /** - * The project id or project number in which the subnetwork is intended to be used. Only applied for Shared VPC. See [Shared VPC documentation](https://cloud.google.com/vpc/docs/shared-vpc/) + * The project id or project number in which the subnetwork is intended to be + * used. Only applied for Shared VPC. See [Shared VPC + * documentation](https://cloud.google.com/vpc/docs/shared-vpc/) * * Generated from protobuf field optional string service_project = 530592655; */ @@ -78,19 +145,86 @@ public static function build(string $project): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * @type string $service_project - * The project id or project number in which the subnetwork is intended to be used. Only applied for Shared VPC. See [Shared VPC documentation](https://cloud.google.com/vpc/docs/shared-vpc/) + * The project id or project number in which the subnetwork is intended to be + * used. Only applied for Shared VPC. See [Shared VPC + * documentation](https://cloud.google.com/vpc/docs/shared-vpc/) * } */ public function __construct($data = NULL) { @@ -99,7 +233,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -120,7 +301,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -135,7 +363,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -156,7 +388,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -171,7 +407,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -192,7 +436,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -207,7 +459,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -228,7 +482,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -269,7 +525,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -290,7 +550,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var @@ -305,7 +569,9 @@ public function setReturnPartialSuccess($var) } /** - * The project id or project number in which the subnetwork is intended to be used. Only applied for Shared VPC. See [Shared VPC documentation](https://cloud.google.com/vpc/docs/shared-vpc/) + * The project id or project number in which the subnetwork is intended to be + * used. Only applied for Shared VPC. See [Shared VPC + * documentation](https://cloud.google.com/vpc/docs/shared-vpc/) * * Generated from protobuf field optional string service_project = 530592655; * @return string @@ -326,7 +592,9 @@ public function clearServiceProject() } /** - * The project id or project number in which the subnetwork is intended to be used. Only applied for Shared VPC. See [Shared VPC documentation](https://cloud.google.com/vpc/docs/shared-vpc/) + * The project id or project number in which the subnetwork is intended to be + * used. Only applied for Shared VPC. See [Shared VPC + * documentation](https://cloud.google.com/vpc/docs/shared-vpc/) * * Generated from protobuf field optional string service_project = 530592655; * @param string $var diff --git a/Compute/src/V1/ListVpnGatewaysRequest.php b/Compute/src/V1/ListVpnGatewaysRequest.php index b1950cefe12a..fb78b0e33bb0 100644 --- a/Compute/src/V1/ListVpnGatewaysRequest.php +++ b/Compute/src/V1/ListVpnGatewaysRequest.php @@ -16,25 +16,86 @@ class ListVpnGatewaysRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -52,7 +113,11 @@ class ListVpnGatewaysRequest extends \Google\Protobuf\Internal\Message */ protected $region = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -80,19 +145,84 @@ public static function build(string $project, string $region): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type string $region * Name of the region for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * } */ public function __construct($data = NULL) { @@ -101,7 +231,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -122,7 +299,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -137,7 +361,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -158,7 +386,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -173,7 +405,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -194,7 +434,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -209,7 +457,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -230,7 +480,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -297,7 +549,11 @@ public function setRegion($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -318,7 +574,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListVpnTunnelsRequest.php b/Compute/src/V1/ListVpnTunnelsRequest.php index d8a656d4f843..0a749100f609 100644 --- a/Compute/src/V1/ListVpnTunnelsRequest.php +++ b/Compute/src/V1/ListVpnTunnelsRequest.php @@ -16,25 +16,86 @@ class ListVpnTunnelsRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -52,7 +113,11 @@ class ListVpnTunnelsRequest extends \Google\Protobuf\Internal\Message */ protected $region = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -80,19 +145,84 @@ public static function build(string $project, string $region): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type string $region * Name of the region for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * } */ public function __construct($data = NULL) { @@ -101,7 +231,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -122,7 +299,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -137,7 +361,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -158,7 +386,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -173,7 +405,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -194,7 +434,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -209,7 +457,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -230,7 +480,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -297,7 +549,11 @@ public function setRegion($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -318,7 +574,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListWireGroupsRequest.php b/Compute/src/V1/ListWireGroupsRequest.php new file mode 100644 index 000000000000..6093ea9f5915 --- /dev/null +++ b/Compute/src/V1/ListWireGroupsRequest.php @@ -0,0 +1,589 @@ +google.cloud.compute.v1.ListWireGroupsRequest + */ +class ListWireGroupsRequest extends \Google\Protobuf\Internal\Message +{ + /** + * Generated from protobuf field string cross_site_network = 108192469 [(.google.api.field_behavior) = REQUIRED]; + */ + protected $cross_site_network = ''; + /** + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. + * + * Generated from protobuf field optional string filter = 336120696; + */ + protected $filter = null; + /** + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) + * + * Generated from protobuf field optional uint32 max_results = 54715419; + */ + protected $max_results = null; + /** + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. + * + * Generated from protobuf field optional string order_by = 160562920; + */ + protected $order_by = null; + /** + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. + * + * Generated from protobuf field optional string page_token = 19994697; + */ + protected $page_token = null; + /** + * Project ID for this request. + * + * Generated from protobuf field string project = 227560217 [(.google.api.field_behavior) = REQUIRED]; + */ + protected $project = ''; + /** + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. + * + * Generated from protobuf field optional bool return_partial_success = 517198390; + */ + protected $return_partial_success = null; + + /** + * @param string $project Project ID for this request. + * @param string $crossSiteNetwork + * + * @return \Google\Cloud\Compute\V1\ListWireGroupsRequest + * + * @experimental + */ + public static function build(string $project, string $crossSiteNetwork): self + { + return (new self()) + ->setProject($project) + ->setCrossSiteNetwork($crossSiteNetwork); + } + + /** + * Constructor. + * + * @param array $data { + * Optional. Data for populating the Message object. + * + * @type string $cross_site_network + * @type string $filter + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. + * @type int $max_results + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) + * @type string $order_by + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. + * @type string $page_token + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. + * @type string $project + * Project ID for this request. + * @type bool $return_partial_success + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. + * } + */ + public function __construct($data = NULL) { + \GPBMetadata\Google\Cloud\Compute\V1\Compute::initOnce(); + parent::__construct($data); + } + + /** + * Generated from protobuf field string cross_site_network = 108192469 [(.google.api.field_behavior) = REQUIRED]; + * @return string + */ + public function getCrossSiteNetwork() + { + return $this->cross_site_network; + } + + /** + * Generated from protobuf field string cross_site_network = 108192469 [(.google.api.field_behavior) = REQUIRED]; + * @param string $var + * @return $this + */ + public function setCrossSiteNetwork($var) + { + GPBUtil::checkString($var, True); + $this->cross_site_network = $var; + + return $this; + } + + /** + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. + * + * Generated from protobuf field optional string filter = 336120696; + * @return string + */ + public function getFilter() + { + return isset($this->filter) ? $this->filter : ''; + } + + public function hasFilter() + { + return isset($this->filter); + } + + public function clearFilter() + { + unset($this->filter); + } + + /** + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. + * + * Generated from protobuf field optional string filter = 336120696; + * @param string $var + * @return $this + */ + public function setFilter($var) + { + GPBUtil::checkString($var, True); + $this->filter = $var; + + return $this; + } + + /** + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) + * + * Generated from protobuf field optional uint32 max_results = 54715419; + * @return int + */ + public function getMaxResults() + { + return isset($this->max_results) ? $this->max_results : 0; + } + + public function hasMaxResults() + { + return isset($this->max_results); + } + + public function clearMaxResults() + { + unset($this->max_results); + } + + /** + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) + * + * Generated from protobuf field optional uint32 max_results = 54715419; + * @param int $var + * @return $this + */ + public function setMaxResults($var) + { + GPBUtil::checkUint32($var); + $this->max_results = $var; + + return $this; + } + + /** + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. + * + * Generated from protobuf field optional string order_by = 160562920; + * @return string + */ + public function getOrderBy() + { + return isset($this->order_by) ? $this->order_by : ''; + } + + public function hasOrderBy() + { + return isset($this->order_by); + } + + public function clearOrderBy() + { + unset($this->order_by); + } + + /** + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. + * + * Generated from protobuf field optional string order_by = 160562920; + * @param string $var + * @return $this + */ + public function setOrderBy($var) + { + GPBUtil::checkString($var, True); + $this->order_by = $var; + + return $this; + } + + /** + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. + * + * Generated from protobuf field optional string page_token = 19994697; + * @return string + */ + public function getPageToken() + { + return isset($this->page_token) ? $this->page_token : ''; + } + + public function hasPageToken() + { + return isset($this->page_token); + } + + public function clearPageToken() + { + unset($this->page_token); + } + + /** + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. + * + * Generated from protobuf field optional string page_token = 19994697; + * @param string $var + * @return $this + */ + public function setPageToken($var) + { + GPBUtil::checkString($var, True); + $this->page_token = $var; + + return $this; + } + + /** + * Project ID for this request. + * + * Generated from protobuf field string project = 227560217 [(.google.api.field_behavior) = REQUIRED]; + * @return string + */ + public function getProject() + { + return $this->project; + } + + /** + * Project ID for this request. + * + * Generated from protobuf field string project = 227560217 [(.google.api.field_behavior) = REQUIRED]; + * @param string $var + * @return $this + */ + public function setProject($var) + { + GPBUtil::checkString($var, True); + $this->project = $var; + + return $this; + } + + /** + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. + * + * Generated from protobuf field optional bool return_partial_success = 517198390; + * @return bool + */ + public function getReturnPartialSuccess() + { + return isset($this->return_partial_success) ? $this->return_partial_success : false; + } + + public function hasReturnPartialSuccess() + { + return isset($this->return_partial_success); + } + + public function clearReturnPartialSuccess() + { + unset($this->return_partial_success); + } + + /** + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. + * + * Generated from protobuf field optional bool return_partial_success = 517198390; + * @param bool $var + * @return $this + */ + public function setReturnPartialSuccess($var) + { + GPBUtil::checkBool($var); + $this->return_partial_success = $var; + + return $this; + } + +} + diff --git a/Compute/src/V1/ListXpnHostsProjectsRequest.php b/Compute/src/V1/ListXpnHostsProjectsRequest.php index 93bdc58d7690..e9e6caeb50d6 100644 --- a/Compute/src/V1/ListXpnHostsProjectsRequest.php +++ b/Compute/src/V1/ListXpnHostsProjectsRequest.php @@ -16,25 +16,86 @@ class ListXpnHostsProjectsRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -52,7 +113,11 @@ class ListXpnHostsProjectsRequest extends \Google\Protobuf\Internal\Message */ protected $projects_list_xpn_hosts_request_resource = null; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -80,19 +145,84 @@ public static function build(string $project, \Google\Cloud\Compute\V1\ProjectsL * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type \Google\Cloud\Compute\V1\ProjectsListXpnHostsRequest $projects_list_xpn_hosts_request_resource * The body resource for this request * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * } */ public function __construct($data = NULL) { @@ -101,7 +231,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -122,7 +299,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -137,7 +361,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -158,7 +386,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -173,7 +405,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -194,7 +434,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -209,7 +457,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -230,7 +480,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -307,7 +559,11 @@ public function setProjectsListXpnHostsRequestResource($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -328,7 +584,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListZoneOperationsRequest.php b/Compute/src/V1/ListZoneOperationsRequest.php index afb448e842dd..a59725007bd8 100644 --- a/Compute/src/V1/ListZoneOperationsRequest.php +++ b/Compute/src/V1/ListZoneOperationsRequest.php @@ -16,25 +16,86 @@ class ListZoneOperationsRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -46,7 +107,11 @@ class ListZoneOperationsRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -80,17 +145,82 @@ public static function build(string $project, string $zone): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * @type string $zone * Name of the zone for request. * } @@ -101,7 +231,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -122,7 +299,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -137,7 +361,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -158,7 +386,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -173,7 +405,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -194,7 +434,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -209,7 +457,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -230,7 +480,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -271,7 +523,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -292,7 +548,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/ListZonesRequest.php b/Compute/src/V1/ListZonesRequest.php index 3e5638104504..98e8458f9f8f 100644 --- a/Compute/src/V1/ListZonesRequest.php +++ b/Compute/src/V1/ListZonesRequest.php @@ -16,25 +16,86 @@ class ListZonesRequest extends \Google\Protobuf\Internal\Message { /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; */ protected $filter = null; /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; */ protected $max_results = null; /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; */ protected $order_by = null; /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; */ @@ -46,7 +107,11 @@ class ListZonesRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; */ @@ -72,17 +137,82 @@ public static function build(string $project): self * Optional. Data for populating the Message object. * * @type string $filter - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * @type int $max_results - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * @type string $order_by - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * @type string $page_token - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * @type string $project * Project ID for this request. * @type bool $return_partial_success - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * } */ public function __construct($data = NULL) { @@ -91,7 +221,54 @@ public function __construct($data = NULL) { } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @return string @@ -112,7 +289,54 @@ public function clearFilter() } /** - * A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions. + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * You cannot combine constraints on multiple fields using regular + * expressions. * * Generated from protobuf field optional string filter = 336120696; * @param string $var @@ -127,7 +351,11 @@ public function setFilter($var) } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @return int @@ -148,7 +376,11 @@ public function clearMaxResults() } /** - * The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) * * Generated from protobuf field optional uint32 max_results = 54715419; * @param int $var @@ -163,7 +395,15 @@ public function setMaxResults($var) } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @return string @@ -184,7 +424,15 @@ public function clearOrderBy() } /** - * Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported. + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. * * Generated from protobuf field optional string order_by = 160562920; * @param string $var @@ -199,7 +447,9 @@ public function setOrderBy($var) } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @return string @@ -220,7 +470,9 @@ public function clearPageToken() } /** - * Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results. + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. * * Generated from protobuf field optional string page_token = 19994697; * @param string $var @@ -261,7 +513,11 @@ public function setProject($var) } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @return bool @@ -282,7 +538,11 @@ public function clearReturnPartialSuccess() } /** - * Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code. + * Opt-in for partial success behavior which provides partial results in case + * of failure. The default value is false. + * For example, when partial success behavior is enabled, aggregatedList for a + * single zone scope either returns all resources in the zone or no resources, + * with an error code. * * Generated from protobuf field optional bool return_partial_success = 517198390; * @param bool $var diff --git a/Compute/src/V1/LocalDisk.php b/Compute/src/V1/LocalDisk.php index a6df8080f3ff..a2ae0126fbaa 100644 --- a/Compute/src/V1/LocalDisk.php +++ b/Compute/src/V1/LocalDisk.php @@ -27,7 +27,10 @@ class LocalDisk extends \Google\Protobuf\Internal\Message */ protected $disk_size_gb = null; /** - * Specifies the desired disk type on the node. This disk type must be a local storage type (e.g.: local-ssd). Note that for nodeTemplates, this should be the name of the disk type and not its URL. + * Specifies the desired disk type on the node. This disk type must be a + * local storage type (e.g.: local-ssd). + * Note that for nodeTemplates, this should be the name of the disk type and + * not its URL. * * Generated from protobuf field optional string disk_type = 93009052; */ @@ -44,7 +47,10 @@ class LocalDisk extends \Google\Protobuf\Internal\Message * @type int $disk_size_gb * Specifies the size of the disk in base-2 GB. * @type string $disk_type - * Specifies the desired disk type on the node. This disk type must be a local storage type (e.g.: local-ssd). Note that for nodeTemplates, this should be the name of the disk type and not its URL. + * Specifies the desired disk type on the node. This disk type must be a + * local storage type (e.g.: local-ssd). + * Note that for nodeTemplates, this should be the name of the disk type and + * not its URL. * } */ public function __construct($data = NULL) { @@ -125,7 +131,10 @@ public function setDiskSizeGb($var) } /** - * Specifies the desired disk type on the node. This disk type must be a local storage type (e.g.: local-ssd). Note that for nodeTemplates, this should be the name of the disk type and not its URL. + * Specifies the desired disk type on the node. This disk type must be a + * local storage type (e.g.: local-ssd). + * Note that for nodeTemplates, this should be the name of the disk type and + * not its URL. * * Generated from protobuf field optional string disk_type = 93009052; * @return string @@ -146,7 +155,10 @@ public function clearDiskType() } /** - * Specifies the desired disk type on the node. This disk type must be a local storage type (e.g.: local-ssd). Note that for nodeTemplates, this should be the name of the disk type and not its URL. + * Specifies the desired disk type on the node. This disk type must be a + * local storage type (e.g.: local-ssd). + * Note that for nodeTemplates, this should be the name of the disk type and + * not its URL. * * Generated from protobuf field optional string disk_type = 93009052; * @param string $var diff --git a/Compute/src/V1/LocalizedMessage.php b/Compute/src/V1/LocalizedMessage.php index 135da6c93bea..12461dd3abc1 100644 --- a/Compute/src/V1/LocalizedMessage.php +++ b/Compute/src/V1/LocalizedMessage.php @@ -9,14 +9,17 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Provides a localized error message that is safe to return to the user which can be attached to an RPC error. + * Provides a localized error message that is safe to return to the user + * which can be attached to an RPC error. * * Generated from protobuf message google.cloud.compute.v1.LocalizedMessage */ class LocalizedMessage extends \Google\Protobuf\Internal\Message { /** - * The locale used following the specification defined at https://www.rfc-editor.org/rfc/bcp/bcp47.txt. Examples are: "en-US", "fr-CH", "es-MX" + * The locale used following the specification defined at + * https://www.rfc-editor.org/rfc/bcp/bcp47.txt. + * Examples are: "en-US", "fr-CH", "es-MX" * * Generated from protobuf field optional string locale = 513150554; */ @@ -35,7 +38,9 @@ class LocalizedMessage extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $locale - * The locale used following the specification defined at https://www.rfc-editor.org/rfc/bcp/bcp47.txt. Examples are: "en-US", "fr-CH", "es-MX" + * The locale used following the specification defined at + * https://www.rfc-editor.org/rfc/bcp/bcp47.txt. + * Examples are: "en-US", "fr-CH", "es-MX" * @type string $message * The localized error message in the above locale. * } @@ -46,7 +51,9 @@ public function __construct($data = NULL) { } /** - * The locale used following the specification defined at https://www.rfc-editor.org/rfc/bcp/bcp47.txt. Examples are: "en-US", "fr-CH", "es-MX" + * The locale used following the specification defined at + * https://www.rfc-editor.org/rfc/bcp/bcp47.txt. + * Examples are: "en-US", "fr-CH", "es-MX" * * Generated from protobuf field optional string locale = 513150554; * @return string @@ -67,7 +74,9 @@ public function clearLocale() } /** - * The locale used following the specification defined at https://www.rfc-editor.org/rfc/bcp/bcp47.txt. Examples are: "en-US", "fr-CH", "es-MX" + * The locale used following the specification defined at + * https://www.rfc-editor.org/rfc/bcp/bcp47.txt. + * Examples are: "en-US", "fr-CH", "es-MX" * * Generated from protobuf field optional string locale = 513150554; * @param string $var diff --git a/Compute/src/V1/LocationPolicy.php b/Compute/src/V1/LocationPolicy.php index 5f0ae6ade56d..1926249baf44 100644 --- a/Compute/src/V1/LocationPolicy.php +++ b/Compute/src/V1/LocationPolicy.php @@ -9,14 +9,17 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Configuration for location policy among multiple possible locations (e.g. preferences for zone selection among zones in a single region). + * Configuration for location policy among multiple possible locations + * (e.g. preferences for zone selection among zones in a single region). * * Generated from protobuf message google.cloud.compute.v1.LocationPolicy */ class LocationPolicy extends \Google\Protobuf\Internal\Message { /** - * Location configurations mapped by location name. Currently only zone names are supported and must be represented as valid internal URLs, such as zones/us-central1-a. + * Location configurations mapped by location name. + * Currently only zone names are supported and must be represented as valid + * internal URLs, such as zones/us-central1-a. * * Generated from protobuf field map locations = 413423454; */ @@ -36,7 +39,9 @@ class LocationPolicy extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type array|\Google\Protobuf\Internal\MapField $locations - * Location configurations mapped by location name. Currently only zone names are supported and must be represented as valid internal URLs, such as zones/us-central1-a. + * Location configurations mapped by location name. + * Currently only zone names are supported and must be represented as valid + * internal URLs, such as zones/us-central1-a. * @type string $target_shape * Strategy for distributing VMs across zones in a region. * Check the TargetShape enum for the list of possible values. @@ -48,7 +53,9 @@ public function __construct($data = NULL) { } /** - * Location configurations mapped by location name. Currently only zone names are supported and must be represented as valid internal URLs, such as zones/us-central1-a. + * Location configurations mapped by location name. + * Currently only zone names are supported and must be represented as valid + * internal URLs, such as zones/us-central1-a. * * Generated from protobuf field map locations = 413423454; * @return \Google\Protobuf\Internal\MapField @@ -59,7 +66,9 @@ public function getLocations() } /** - * Location configurations mapped by location name. Currently only zone names are supported and must be represented as valid internal URLs, such as zones/us-central1-a. + * Location configurations mapped by location name. + * Currently only zone names are supported and must be represented as valid + * internal URLs, such as zones/us-central1-a. * * Generated from protobuf field map locations = 413423454; * @param array|\Google\Protobuf\Internal\MapField $var diff --git a/Compute/src/V1/LocationPolicy/TargetShape.php b/Compute/src/V1/LocationPolicy/TargetShape.php index ce85997735b8..5380f23d2dcb 100644 --- a/Compute/src/V1/LocationPolicy/TargetShape.php +++ b/Compute/src/V1/LocationPolicy/TargetShape.php @@ -20,19 +20,28 @@ class TargetShape */ const UNDEFINED_TARGET_SHAPE = 0; /** - * GCE picks zones for creating VM instances to fulfill the requested number of VMs within present resource constraints and to maximize utilization of unused zonal reservations. Recommended for batch workloads that do not require high availability. + * GCE picks zones for creating VM instances to fulfill the requested + * number of VMs within present resource constraints and to maximize + * utilization of unused zonal reservations. Recommended for batch workloads + * that do not require high availability. * * Generated from protobuf enum ANY = 64972; */ const ANY = 64972; /** - * GCE always selects a single zone for all the VMs, optimizing for resource quotas, available reservations and general capacity. Recommended for batch workloads that cannot tollerate distribution over multiple zones. This the default shape in Bulk Insert and Capacity Advisor APIs. + * GCE always selects a single zone for all the VMs, optimizing for resource + * quotas, available reservations and general capacity. Recommended for + * batch workloads that cannot tollerate distribution over multiple zones. + * This the default shape in Bulk Insert and Capacity Advisor APIs. * * Generated from protobuf enum ANY_SINGLE_ZONE = 61100880; */ const ANY_SINGLE_ZONE = 61100880; /** - * GCE prioritizes acquisition of resources, scheduling VMs in zones where resources are available while distributing VMs as evenly as possible across allowed zones to minimize the impact of zonal failure. Recommended for highly available serving workloads. + * GCE prioritizes acquisition of resources, scheduling VMs in zones + * where resources are available while distributing VMs as evenly as + * possible across allowed zones to minimize the impact of zonal failure. + * Recommended for highly available serving workloads. * * Generated from protobuf enum BALANCED = 468409608; */ diff --git a/Compute/src/V1/LocationPolicyLocation.php b/Compute/src/V1/LocationPolicyLocation.php index 52b801d1d263..b7add241d203 100644 --- a/Compute/src/V1/LocationPolicyLocation.php +++ b/Compute/src/V1/LocationPolicyLocation.php @@ -15,13 +15,14 @@ class LocationPolicyLocation extends \Google\Protobuf\Internal\Message { /** - * Constraints that the caller requires on the result distribution in this zone. + * Constraints that the caller requires on the result distribution + * in this zone. * * Generated from protobuf field optional .google.cloud.compute.v1.LocationPolicyLocationConstraints constraints = 3909174; */ protected $constraints = null; /** - * Preference for a given location. Set to either ALLOW or DENY. + * Preference for a given location. Set to either ALLOW orDENY. * Check the Preference enum for the list of possible values. * * Generated from protobuf field optional string preference = 150781147; @@ -35,9 +36,10 @@ class LocationPolicyLocation extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type \Google\Cloud\Compute\V1\LocationPolicyLocationConstraints $constraints - * Constraints that the caller requires on the result distribution in this zone. + * Constraints that the caller requires on the result distribution + * in this zone. * @type string $preference - * Preference for a given location. Set to either ALLOW or DENY. + * Preference for a given location. Set to either ALLOW orDENY. * Check the Preference enum for the list of possible values. * } */ @@ -47,7 +49,8 @@ public function __construct($data = NULL) { } /** - * Constraints that the caller requires on the result distribution in this zone. + * Constraints that the caller requires on the result distribution + * in this zone. * * Generated from protobuf field optional .google.cloud.compute.v1.LocationPolicyLocationConstraints constraints = 3909174; * @return \Google\Cloud\Compute\V1\LocationPolicyLocationConstraints|null @@ -68,7 +71,8 @@ public function clearConstraints() } /** - * Constraints that the caller requires on the result distribution in this zone. + * Constraints that the caller requires on the result distribution + * in this zone. * * Generated from protobuf field optional .google.cloud.compute.v1.LocationPolicyLocationConstraints constraints = 3909174; * @param \Google\Cloud\Compute\V1\LocationPolicyLocationConstraints $var @@ -83,7 +87,7 @@ public function setConstraints($var) } /** - * Preference for a given location. Set to either ALLOW or DENY. + * Preference for a given location. Set to either ALLOW orDENY. * Check the Preference enum for the list of possible values. * * Generated from protobuf field optional string preference = 150781147; @@ -105,7 +109,7 @@ public function clearPreference() } /** - * Preference for a given location. Set to either ALLOW or DENY. + * Preference for a given location. Set to either ALLOW orDENY. * Check the Preference enum for the list of possible values. * * Generated from protobuf field optional string preference = 150781147; diff --git a/Compute/src/V1/LocationPolicyLocation/Preference.php b/Compute/src/V1/LocationPolicyLocation/Preference.php index f4ece3b590f7..8f1d553a43ce 100644 --- a/Compute/src/V1/LocationPolicyLocation/Preference.php +++ b/Compute/src/V1/LocationPolicyLocation/Preference.php @@ -7,7 +7,7 @@ use UnexpectedValueException; /** - * Preference for a given location. Set to either ALLOW or DENY. + * Preference for a given location. Set to either ALLOW orDENY. * * Protobuf type google.cloud.compute.v1.LocationPolicyLocation.Preference */ diff --git a/Compute/src/V1/LocationPolicyLocationConstraints.php b/Compute/src/V1/LocationPolicyLocationConstraints.php index c1d1707df15a..499e376b56e7 100644 --- a/Compute/src/V1/LocationPolicyLocationConstraints.php +++ b/Compute/src/V1/LocationPolicyLocationConstraints.php @@ -16,7 +16,8 @@ class LocationPolicyLocationConstraints extends \Google\Protobuf\Internal\Message { /** - * Maximum number of items that are allowed to be placed in this zone. The value must be non-negative. + * Maximum number of items that are allowed to be placed in this zone. + * The value must be non-negative. * * Generated from protobuf field optional int32 max_count = 287620724; */ @@ -29,7 +30,8 @@ class LocationPolicyLocationConstraints extends \Google\Protobuf\Internal\Messag * Optional. Data for populating the Message object. * * @type int $max_count - * Maximum number of items that are allowed to be placed in this zone. The value must be non-negative. + * Maximum number of items that are allowed to be placed in this zone. + * The value must be non-negative. * } */ public function __construct($data = NULL) { @@ -38,7 +40,8 @@ public function __construct($data = NULL) { } /** - * Maximum number of items that are allowed to be placed in this zone. The value must be non-negative. + * Maximum number of items that are allowed to be placed in this zone. + * The value must be non-negative. * * Generated from protobuf field optional int32 max_count = 287620724; * @return int @@ -59,7 +62,8 @@ public function clearMaxCount() } /** - * Maximum number of items that are allowed to be placed in this zone. The value must be non-negative. + * Maximum number of items that are allowed to be placed in this zone. + * The value must be non-negative. * * Generated from protobuf field optional int32 max_count = 287620724; * @param int $var diff --git a/Compute/src/V1/MachineImage.php b/Compute/src/V1/MachineImage.php index 6df73d5809d3..0e5c7b33d82c 100644 --- a/Compute/src/V1/MachineImage.php +++ b/Compute/src/V1/MachineImage.php @@ -9,32 +9,39 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Represents a machine image resource. A machine image is a Compute Engine resource that stores all the configuration, metadata, permissions, and data from one or more disks required to create a Virtual machine (VM) instance. For more information, see Machine images. + * Represents a machine image resource. + * A machine image is a Compute Engine resource that stores all the + * configuration, metadata, permissions, and data from one or more disks + * required to create a Virtual machine (VM) instance. For more information, seeMachine images. * * Generated from protobuf message google.cloud.compute.v1.MachineImage */ class MachineImage extends \Google\Protobuf\Internal\Message { /** - * [Output Only] The creation timestamp for this machine image in RFC3339 text format. + * [Output Only] The creation timestamp for this machine image inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; */ protected $creation_timestamp = null; /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; */ protected $description = null; /** - * [Input Only] Whether to attempt an application consistent machine image by informing the OS to prepare for the snapshot process. + * [Input Only] Whether to attempt an application consistent machine image by + * informing the OS to prepare for the snapshot process. * * Generated from protobuf field optional bool guest_flush = 385550813; */ protected $guest_flush = null; /** - * [Output Only] A unique identifier for this machine image. The server defines this identifier. + * [Output Only] A unique identifier for this machine image. The server + * defines this identifier. * * Generated from protobuf field optional uint64 id = 3355; */ @@ -46,31 +53,54 @@ class MachineImage extends \Google\Protobuf\Internal\Message */ protected $instance_properties = null; /** - * [Output Only] The resource type, which is always compute#machineImage for machine image. + * [Output Only] The resource type, which is alwayscompute#machineImage for machine image. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * A fingerprint for the labels being applied to this machine image, which is essentially a hash of the labels set used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels. To see the latest fingerprint, make get() request to the machine image. + * A fingerprint for the labels being applied to this machine image, which is + * essentially a hash of the labels set used for optimistic locking. The + * fingerprint is initially generated by Compute Engine and changes after + * every request to modify or update labels. You must always provide an + * up-to-date fingerprint hash in order to update or change labels. + * To see the latest fingerprint, make get() request to the + * machine image. * * Generated from protobuf field optional string label_fingerprint = 178124825; */ protected $label_fingerprint = null; /** - * Labels to apply to this machine image. These can be later modified by the setLabels method. + * Labels to apply to this machine image. These can be later modified by + * the setLabels method. * * Generated from protobuf field map labels = 500195327; */ private $labels; /** - * Encrypts the machine image using a customer-supplied encryption key. After you encrypt a machine image using a customer-supplied key, you must provide the same key if you use the machine image later. For example, you must provide the encryption key when you create an instance from the encrypted machine image in a future request. Customer-supplied encryption keys do not protect access to metadata of the machine image. If you do not provide an encryption key when creating the machine image, then the machine image will be encrypted using an automatically generated key and you do not need to provide a key to use the machine image later. + * Encrypts the machine image using acustomer-supplied + * encryption key. + * After you encrypt a machine image using a customer-supplied key, you must + * provide the same key if you use the machine image later. For example, you + * must provide the encryption key when you create an instance from the + * encrypted machine image in a future request. + * Customer-supplied encryption keys do not protect access to metadata of the + * machine image. + * If you do not provide an encryption key when creating the machine image, + * then the machine image will be encrypted using an automatically generated + * key and you do not need to provide a key to use the machine image later. * * Generated from protobuf field optional .google.cloud.compute.v1.CustomerEncryptionKey machine_image_encryption_key = 528089087; */ protected $machine_image_encryption_key = null; /** - * Name of the resource; provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource; provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must be + * a dash, lowercase letter, or digit, except the last character, which cannot + * be a dash. * * Generated from protobuf field optional string name = 3373707; */ @@ -88,7 +118,8 @@ class MachineImage extends \Google\Protobuf\Internal\Message */ protected $satisfies_pzs = null; /** - * An array of Machine Image specific properties for disks attached to the source instance + * An array of Machine Image specific properties for disks attached to the + * source instance * * Generated from protobuf field repeated .google.cloud.compute.v1.SavedDisk saved_disks = 397424318; */ @@ -100,32 +131,41 @@ class MachineImage extends \Google\Protobuf\Internal\Message */ protected $self_link = null; /** - * [Input Only] The customer-supplied encryption key of the disks attached to the source instance. Required if the source disk is protected by a customer-supplied encryption key. + * [Input Only] Thecustomer-supplied + * encryption key of the disks attached to the source instance. Required + * if the source disk is protected by a customer-supplied encryption key. * * Generated from protobuf field repeated .google.cloud.compute.v1.SourceDiskEncryptionKey source_disk_encryption_keys = 370408498; */ private $source_disk_encryption_keys; /** - * The source instance used to create the machine image. You can provide this as a partial or full URL to the resource. For example, the following are valid values: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /instances/instance - projects/project/zones/zone/instances/instance + * The source instance used to create the machine image. You can provide this + * as a partial or full URL to the resource. For example, the following are + * valid values: + * - https://www.googleapis.com/compute/v1/projects/project/zones/zone/instances/instance + * - projects/project/zones/zone/instances/instance * * Generated from protobuf field optional string source_instance = 396315705; */ protected $source_instance = null; /** - * [Output Only] DEPRECATED: Please use instance_properties instead for source instance related properties. New properties will not be added to this field. + * [Output Only] DEPRECATED: Please use instance_properties + * instead for source instance related properties. New properties will not be + * added to this field. * * Generated from protobuf field optional .google.cloud.compute.v1.SourceInstanceProperties source_instance_properties = 475195641; */ protected $source_instance_properties = null; /** - * [Output Only] The status of the machine image. One of the following values: INVALID, CREATING, READY, DELETING, and UPLOADING. + * [Output Only] The status of the machine image. One of the following values:INVALID, CREATING, READY,DELETING, and UPLOADING. * Check the Status enum for the list of possible values. * * Generated from protobuf field optional string status = 181260274; */ protected $status = null; /** - * The regional or multi-regional Cloud Storage bucket location where the machine image is stored. + * The regional or multi-regional Cloud Storage bucket location where themachine image is + * stored. * * Generated from protobuf field repeated string storage_locations = 328005274; */ @@ -144,44 +184,81 @@ class MachineImage extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $creation_timestamp - * [Output Only] The creation timestamp for this machine image in RFC3339 text format. + * [Output Only] The creation timestamp for this machine image inRFC3339 + * text format. * @type string $description - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * @type bool $guest_flush - * [Input Only] Whether to attempt an application consistent machine image by informing the OS to prepare for the snapshot process. + * [Input Only] Whether to attempt an application consistent machine image by + * informing the OS to prepare for the snapshot process. * @type int|string $id - * [Output Only] A unique identifier for this machine image. The server defines this identifier. + * [Output Only] A unique identifier for this machine image. The server + * defines this identifier. * @type \Google\Cloud\Compute\V1\InstanceProperties $instance_properties * [Output Only] Properties of source instance * @type string $kind - * [Output Only] The resource type, which is always compute#machineImage for machine image. + * [Output Only] The resource type, which is alwayscompute#machineImage for machine image. * @type string $label_fingerprint - * A fingerprint for the labels being applied to this machine image, which is essentially a hash of the labels set used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels. To see the latest fingerprint, make get() request to the machine image. + * A fingerprint for the labels being applied to this machine image, which is + * essentially a hash of the labels set used for optimistic locking. The + * fingerprint is initially generated by Compute Engine and changes after + * every request to modify or update labels. You must always provide an + * up-to-date fingerprint hash in order to update or change labels. + * To see the latest fingerprint, make get() request to the + * machine image. * @type array|\Google\Protobuf\Internal\MapField $labels - * Labels to apply to this machine image. These can be later modified by the setLabels method. + * Labels to apply to this machine image. These can be later modified by + * the setLabels method. * @type \Google\Cloud\Compute\V1\CustomerEncryptionKey $machine_image_encryption_key - * Encrypts the machine image using a customer-supplied encryption key. After you encrypt a machine image using a customer-supplied key, you must provide the same key if you use the machine image later. For example, you must provide the encryption key when you create an instance from the encrypted machine image in a future request. Customer-supplied encryption keys do not protect access to metadata of the machine image. If you do not provide an encryption key when creating the machine image, then the machine image will be encrypted using an automatically generated key and you do not need to provide a key to use the machine image later. + * Encrypts the machine image using acustomer-supplied + * encryption key. + * After you encrypt a machine image using a customer-supplied key, you must + * provide the same key if you use the machine image later. For example, you + * must provide the encryption key when you create an instance from the + * encrypted machine image in a future request. + * Customer-supplied encryption keys do not protect access to metadata of the + * machine image. + * If you do not provide an encryption key when creating the machine image, + * then the machine image will be encrypted using an automatically generated + * key and you do not need to provide a key to use the machine image later. * @type string $name - * Name of the resource; provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource; provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must be + * a dash, lowercase letter, or digit, except the last character, which cannot + * be a dash. * @type bool $satisfies_pzi * Output only. Reserved for future use. * @type bool $satisfies_pzs * [Output Only] Reserved for future use. * @type array<\Google\Cloud\Compute\V1\SavedDisk>|\Google\Protobuf\Internal\RepeatedField $saved_disks - * An array of Machine Image specific properties for disks attached to the source instance + * An array of Machine Image specific properties for disks attached to the + * source instance * @type string $self_link * [Output Only] The URL for this machine image. The server defines this URL. * @type array<\Google\Cloud\Compute\V1\SourceDiskEncryptionKey>|\Google\Protobuf\Internal\RepeatedField $source_disk_encryption_keys - * [Input Only] The customer-supplied encryption key of the disks attached to the source instance. Required if the source disk is protected by a customer-supplied encryption key. + * [Input Only] Thecustomer-supplied + * encryption key of the disks attached to the source instance. Required + * if the source disk is protected by a customer-supplied encryption key. * @type string $source_instance - * The source instance used to create the machine image. You can provide this as a partial or full URL to the resource. For example, the following are valid values: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /instances/instance - projects/project/zones/zone/instances/instance + * The source instance used to create the machine image. You can provide this + * as a partial or full URL to the resource. For example, the following are + * valid values: + * - https://www.googleapis.com/compute/v1/projects/project/zones/zone/instances/instance + * - projects/project/zones/zone/instances/instance * @type \Google\Cloud\Compute\V1\SourceInstanceProperties $source_instance_properties - * [Output Only] DEPRECATED: Please use instance_properties instead for source instance related properties. New properties will not be added to this field. + * [Output Only] DEPRECATED: Please use instance_properties + * instead for source instance related properties. New properties will not be + * added to this field. * @type string $status - * [Output Only] The status of the machine image. One of the following values: INVALID, CREATING, READY, DELETING, and UPLOADING. + * [Output Only] The status of the machine image. One of the following values:INVALID, CREATING, READY,DELETING, and UPLOADING. * Check the Status enum for the list of possible values. * @type array|\Google\Protobuf\Internal\RepeatedField $storage_locations - * The regional or multi-regional Cloud Storage bucket location where the machine image is stored. + * The regional or multi-regional Cloud Storage bucket location where themachine image is + * stored. * @type int|string $total_storage_bytes * [Output Only] Total size of the storage used by the machine image. * } @@ -192,7 +269,8 @@ public function __construct($data = NULL) { } /** - * [Output Only] The creation timestamp for this machine image in RFC3339 text format. + * [Output Only] The creation timestamp for this machine image inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @return string @@ -213,7 +291,8 @@ public function clearCreationTimestamp() } /** - * [Output Only] The creation timestamp for this machine image in RFC3339 text format. + * [Output Only] The creation timestamp for this machine image inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @param string $var @@ -228,7 +307,8 @@ public function setCreationTimestamp($var) } /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @return string @@ -249,7 +329,8 @@ public function clearDescription() } /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @param string $var @@ -264,7 +345,8 @@ public function setDescription($var) } /** - * [Input Only] Whether to attempt an application consistent machine image by informing the OS to prepare for the snapshot process. + * [Input Only] Whether to attempt an application consistent machine image by + * informing the OS to prepare for the snapshot process. * * Generated from protobuf field optional bool guest_flush = 385550813; * @return bool @@ -285,7 +367,8 @@ public function clearGuestFlush() } /** - * [Input Only] Whether to attempt an application consistent machine image by informing the OS to prepare for the snapshot process. + * [Input Only] Whether to attempt an application consistent machine image by + * informing the OS to prepare for the snapshot process. * * Generated from protobuf field optional bool guest_flush = 385550813; * @param bool $var @@ -300,7 +383,8 @@ public function setGuestFlush($var) } /** - * [Output Only] A unique identifier for this machine image. The server defines this identifier. + * [Output Only] A unique identifier for this machine image. The server + * defines this identifier. * * Generated from protobuf field optional uint64 id = 3355; * @return int|string @@ -321,7 +405,8 @@ public function clearId() } /** - * [Output Only] A unique identifier for this machine image. The server defines this identifier. + * [Output Only] A unique identifier for this machine image. The server + * defines this identifier. * * Generated from protobuf field optional uint64 id = 3355; * @param int|string $var @@ -372,7 +457,7 @@ public function setInstanceProperties($var) } /** - * [Output Only] The resource type, which is always compute#machineImage for machine image. + * [Output Only] The resource type, which is alwayscompute#machineImage for machine image. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -393,7 +478,7 @@ public function clearKind() } /** - * [Output Only] The resource type, which is always compute#machineImage for machine image. + * [Output Only] The resource type, which is alwayscompute#machineImage for machine image. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -408,7 +493,13 @@ public function setKind($var) } /** - * A fingerprint for the labels being applied to this machine image, which is essentially a hash of the labels set used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels. To see the latest fingerprint, make get() request to the machine image. + * A fingerprint for the labels being applied to this machine image, which is + * essentially a hash of the labels set used for optimistic locking. The + * fingerprint is initially generated by Compute Engine and changes after + * every request to modify or update labels. You must always provide an + * up-to-date fingerprint hash in order to update or change labels. + * To see the latest fingerprint, make get() request to the + * machine image. * * Generated from protobuf field optional string label_fingerprint = 178124825; * @return string @@ -429,7 +520,13 @@ public function clearLabelFingerprint() } /** - * A fingerprint for the labels being applied to this machine image, which is essentially a hash of the labels set used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels. To see the latest fingerprint, make get() request to the machine image. + * A fingerprint for the labels being applied to this machine image, which is + * essentially a hash of the labels set used for optimistic locking. The + * fingerprint is initially generated by Compute Engine and changes after + * every request to modify or update labels. You must always provide an + * up-to-date fingerprint hash in order to update or change labels. + * To see the latest fingerprint, make get() request to the + * machine image. * * Generated from protobuf field optional string label_fingerprint = 178124825; * @param string $var @@ -444,7 +541,8 @@ public function setLabelFingerprint($var) } /** - * Labels to apply to this machine image. These can be later modified by the setLabels method. + * Labels to apply to this machine image. These can be later modified by + * the setLabels method. * * Generated from protobuf field map labels = 500195327; * @return \Google\Protobuf\Internal\MapField @@ -455,7 +553,8 @@ public function getLabels() } /** - * Labels to apply to this machine image. These can be later modified by the setLabels method. + * Labels to apply to this machine image. These can be later modified by + * the setLabels method. * * Generated from protobuf field map labels = 500195327; * @param array|\Google\Protobuf\Internal\MapField $var @@ -470,7 +569,17 @@ public function setLabels($var) } /** - * Encrypts the machine image using a customer-supplied encryption key. After you encrypt a machine image using a customer-supplied key, you must provide the same key if you use the machine image later. For example, you must provide the encryption key when you create an instance from the encrypted machine image in a future request. Customer-supplied encryption keys do not protect access to metadata of the machine image. If you do not provide an encryption key when creating the machine image, then the machine image will be encrypted using an automatically generated key and you do not need to provide a key to use the machine image later. + * Encrypts the machine image using acustomer-supplied + * encryption key. + * After you encrypt a machine image using a customer-supplied key, you must + * provide the same key if you use the machine image later. For example, you + * must provide the encryption key when you create an instance from the + * encrypted machine image in a future request. + * Customer-supplied encryption keys do not protect access to metadata of the + * machine image. + * If you do not provide an encryption key when creating the machine image, + * then the machine image will be encrypted using an automatically generated + * key and you do not need to provide a key to use the machine image later. * * Generated from protobuf field optional .google.cloud.compute.v1.CustomerEncryptionKey machine_image_encryption_key = 528089087; * @return \Google\Cloud\Compute\V1\CustomerEncryptionKey|null @@ -491,7 +600,17 @@ public function clearMachineImageEncryptionKey() } /** - * Encrypts the machine image using a customer-supplied encryption key. After you encrypt a machine image using a customer-supplied key, you must provide the same key if you use the machine image later. For example, you must provide the encryption key when you create an instance from the encrypted machine image in a future request. Customer-supplied encryption keys do not protect access to metadata of the machine image. If you do not provide an encryption key when creating the machine image, then the machine image will be encrypted using an automatically generated key and you do not need to provide a key to use the machine image later. + * Encrypts the machine image using acustomer-supplied + * encryption key. + * After you encrypt a machine image using a customer-supplied key, you must + * provide the same key if you use the machine image later. For example, you + * must provide the encryption key when you create an instance from the + * encrypted machine image in a future request. + * Customer-supplied encryption keys do not protect access to metadata of the + * machine image. + * If you do not provide an encryption key when creating the machine image, + * then the machine image will be encrypted using an automatically generated + * key and you do not need to provide a key to use the machine image later. * * Generated from protobuf field optional .google.cloud.compute.v1.CustomerEncryptionKey machine_image_encryption_key = 528089087; * @param \Google\Cloud\Compute\V1\CustomerEncryptionKey $var @@ -506,7 +625,13 @@ public function setMachineImageEncryptionKey($var) } /** - * Name of the resource; provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource; provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must be + * a dash, lowercase letter, or digit, except the last character, which cannot + * be a dash. * * Generated from protobuf field optional string name = 3373707; * @return string @@ -527,7 +652,13 @@ public function clearName() } /** - * Name of the resource; provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource; provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must be + * a dash, lowercase letter, or digit, except the last character, which cannot + * be a dash. * * Generated from protobuf field optional string name = 3373707; * @param string $var @@ -614,7 +745,8 @@ public function setSatisfiesPzs($var) } /** - * An array of Machine Image specific properties for disks attached to the source instance + * An array of Machine Image specific properties for disks attached to the + * source instance * * Generated from protobuf field repeated .google.cloud.compute.v1.SavedDisk saved_disks = 397424318; * @return \Google\Protobuf\Internal\RepeatedField @@ -625,7 +757,8 @@ public function getSavedDisks() } /** - * An array of Machine Image specific properties for disks attached to the source instance + * An array of Machine Image specific properties for disks attached to the + * source instance * * Generated from protobuf field repeated .google.cloud.compute.v1.SavedDisk saved_disks = 397424318; * @param array<\Google\Cloud\Compute\V1\SavedDisk>|\Google\Protobuf\Internal\RepeatedField $var @@ -676,7 +809,9 @@ public function setSelfLink($var) } /** - * [Input Only] The customer-supplied encryption key of the disks attached to the source instance. Required if the source disk is protected by a customer-supplied encryption key. + * [Input Only] Thecustomer-supplied + * encryption key of the disks attached to the source instance. Required + * if the source disk is protected by a customer-supplied encryption key. * * Generated from protobuf field repeated .google.cloud.compute.v1.SourceDiskEncryptionKey source_disk_encryption_keys = 370408498; * @return \Google\Protobuf\Internal\RepeatedField @@ -687,7 +822,9 @@ public function getSourceDiskEncryptionKeys() } /** - * [Input Only] The customer-supplied encryption key of the disks attached to the source instance. Required if the source disk is protected by a customer-supplied encryption key. + * [Input Only] Thecustomer-supplied + * encryption key of the disks attached to the source instance. Required + * if the source disk is protected by a customer-supplied encryption key. * * Generated from protobuf field repeated .google.cloud.compute.v1.SourceDiskEncryptionKey source_disk_encryption_keys = 370408498; * @param array<\Google\Cloud\Compute\V1\SourceDiskEncryptionKey>|\Google\Protobuf\Internal\RepeatedField $var @@ -702,7 +839,11 @@ public function setSourceDiskEncryptionKeys($var) } /** - * The source instance used to create the machine image. You can provide this as a partial or full URL to the resource. For example, the following are valid values: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /instances/instance - projects/project/zones/zone/instances/instance + * The source instance used to create the machine image. You can provide this + * as a partial or full URL to the resource. For example, the following are + * valid values: + * - https://www.googleapis.com/compute/v1/projects/project/zones/zone/instances/instance + * - projects/project/zones/zone/instances/instance * * Generated from protobuf field optional string source_instance = 396315705; * @return string @@ -723,7 +864,11 @@ public function clearSourceInstance() } /** - * The source instance used to create the machine image. You can provide this as a partial or full URL to the resource. For example, the following are valid values: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /instances/instance - projects/project/zones/zone/instances/instance + * The source instance used to create the machine image. You can provide this + * as a partial or full URL to the resource. For example, the following are + * valid values: + * - https://www.googleapis.com/compute/v1/projects/project/zones/zone/instances/instance + * - projects/project/zones/zone/instances/instance * * Generated from protobuf field optional string source_instance = 396315705; * @param string $var @@ -738,7 +883,9 @@ public function setSourceInstance($var) } /** - * [Output Only] DEPRECATED: Please use instance_properties instead for source instance related properties. New properties will not be added to this field. + * [Output Only] DEPRECATED: Please use instance_properties + * instead for source instance related properties. New properties will not be + * added to this field. * * Generated from protobuf field optional .google.cloud.compute.v1.SourceInstanceProperties source_instance_properties = 475195641; * @return \Google\Cloud\Compute\V1\SourceInstanceProperties|null @@ -759,7 +906,9 @@ public function clearSourceInstanceProperties() } /** - * [Output Only] DEPRECATED: Please use instance_properties instead for source instance related properties. New properties will not be added to this field. + * [Output Only] DEPRECATED: Please use instance_properties + * instead for source instance related properties. New properties will not be + * added to this field. * * Generated from protobuf field optional .google.cloud.compute.v1.SourceInstanceProperties source_instance_properties = 475195641; * @param \Google\Cloud\Compute\V1\SourceInstanceProperties $var @@ -774,7 +923,7 @@ public function setSourceInstanceProperties($var) } /** - * [Output Only] The status of the machine image. One of the following values: INVALID, CREATING, READY, DELETING, and UPLOADING. + * [Output Only] The status of the machine image. One of the following values:INVALID, CREATING, READY,DELETING, and UPLOADING. * Check the Status enum for the list of possible values. * * Generated from protobuf field optional string status = 181260274; @@ -796,7 +945,7 @@ public function clearStatus() } /** - * [Output Only] The status of the machine image. One of the following values: INVALID, CREATING, READY, DELETING, and UPLOADING. + * [Output Only] The status of the machine image. One of the following values:INVALID, CREATING, READY,DELETING, and UPLOADING. * Check the Status enum for the list of possible values. * * Generated from protobuf field optional string status = 181260274; @@ -812,7 +961,8 @@ public function setStatus($var) } /** - * The regional or multi-regional Cloud Storage bucket location where the machine image is stored. + * The regional or multi-regional Cloud Storage bucket location where themachine image is + * stored. * * Generated from protobuf field repeated string storage_locations = 328005274; * @return \Google\Protobuf\Internal\RepeatedField @@ -823,7 +973,8 @@ public function getStorageLocations() } /** - * The regional or multi-regional Cloud Storage bucket location where the machine image is stored. + * The regional or multi-regional Cloud Storage bucket location where themachine image is + * stored. * * Generated from protobuf field repeated string storage_locations = 328005274; * @param array|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/MachineImage/Status.php b/Compute/src/V1/MachineImage/Status.php index 8fcf902807de..7da525646bbf 100644 --- a/Compute/src/V1/MachineImage/Status.php +++ b/Compute/src/V1/MachineImage/Status.php @@ -7,7 +7,7 @@ use UnexpectedValueException; /** - * [Output Only] The status of the machine image. One of the following values: INVALID, CREATING, READY, DELETING, and UPLOADING. + * [Output Only] The status of the machine image. One of the following values:INVALID, CREATING, READY,DELETING, and UPLOADING. * * Protobuf type google.cloud.compute.v1.MachineImage.Status */ diff --git a/Compute/src/V1/MachineImageList.php b/Compute/src/V1/MachineImageList.php index 39b235425758..a63e0791da7b 100644 --- a/Compute/src/V1/MachineImageList.php +++ b/Compute/src/V1/MachineImageList.php @@ -28,13 +28,17 @@ class MachineImageList extends \Google\Protobuf\Internal\Message */ private $items; /** - * [Output Only] The resource type, which is always compute#machineImagesListResponse for machine image lists. + * [Output Only] The resource type, which is alwayscompute#machineImagesListResponse for machine image lists. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -63,9 +67,13 @@ class MachineImageList extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\MachineImage>|\Google\Protobuf\Internal\RepeatedField $items * A list of MachineImage resources. * @type string $kind - * [Output Only] The resource type, which is always compute#machineImagesListResponse for machine image lists. + * [Output Only] The resource type, which is alwayscompute#machineImagesListResponse for machine image lists. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type \Google\Cloud\Compute\V1\Warning $warning @@ -140,7 +148,7 @@ public function setItems($var) } /** - * [Output Only] The resource type, which is always compute#machineImagesListResponse for machine image lists. + * [Output Only] The resource type, which is alwayscompute#machineImagesListResponse for machine image lists. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -161,7 +169,7 @@ public function clearKind() } /** - * [Output Only] The resource type, which is always compute#machineImagesListResponse for machine image lists. + * [Output Only] The resource type, which is alwayscompute#machineImagesListResponse for machine image lists. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -176,7 +184,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -197,7 +209,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/MachineType.php b/Compute/src/V1/MachineType.php index 1a46f6449b8a..543152653f48 100644 --- a/Compute/src/V1/MachineType.php +++ b/Compute/src/V1/MachineType.php @@ -9,14 +9,17 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Represents a Machine Type resource. You can use specific machine types for your VM instances based on performance and pricing requirements. For more information, read Machine Types. + * Represents a Machine Type resource. + * You can use specific machine types for your VM instances based on performance + * and pricing requirements. For more information, readMachine Types. * * Generated from protobuf message google.cloud.compute.v1.MachineType */ class MachineType extends \Google\Protobuf\Internal\Message { /** - * [Output Only] A list of accelerator configurations assigned to this machine type. + * [Output Only] A list of accelerator configurations assigned to this + * machine type. * * Generated from protobuf field repeated .google.cloud.compute.v1.Accelerators accelerators = 269577064; */ @@ -29,13 +32,15 @@ class MachineType extends \Google\Protobuf\Internal\Message */ protected $architecture = null; /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; */ protected $creation_timestamp = null; /** - * [Output Only] The deprecation status associated with this machine type. Only applicable if the machine type is unavailable. + * [Output Only] The deprecation status associated with this machine type. + * Only applicable if the machine type is unavailable. * * Generated from protobuf field optional .google.cloud.compute.v1.DeprecationStatus deprecated = 515138995; */ @@ -47,31 +52,35 @@ class MachineType extends \Google\Protobuf\Internal\Message */ protected $description = null; /** - * [Output Only] The number of virtual CPUs that are available to the instance. + * [Output Only] The number of virtual CPUs that are available to the + * instance. * * Generated from protobuf field optional int32 guest_cpus = 393356754; */ protected $guest_cpus = null; /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; */ protected $id = null; /** - * [Deprecated] This property is deprecated and will never be populated with any relevant values. + * [Deprecated] This property is deprecated and will never be populated with + * any relevant values. * * Generated from protobuf field optional int32 image_space_gb = 75331864; */ protected $image_space_gb = null; /** - * [Output Only] Whether this machine type has a shared CPU. See Shared-core machine types for more information. + * [Output Only] Whether this machine type has a shared CPU. SeeShared-core machine + * types for more information. * * Generated from protobuf field optional bool is_shared_cpu = 521399555; */ protected $is_shared_cpu = null; /** - * [Output Only] The type of the resource. Always compute#machineType for machine types. + * [Output Only] The type of the resource. Alwayscompute#machineType for machine types. * * Generated from protobuf field optional string kind = 3292052; */ @@ -89,7 +98,8 @@ class MachineType extends \Google\Protobuf\Internal\Message */ protected $maximum_persistent_disks_size_gb = null; /** - * [Output Only] The amount of physical memory available to the instance, defined in MB. + * [Output Only] The amount of physical memory available to the instance, + * defined in MB. * * Generated from protobuf field optional int32 memory_mb = 116001171; */ @@ -107,7 +117,8 @@ class MachineType extends \Google\Protobuf\Internal\Message */ protected $self_link = null; /** - * [Output Only] The name of the zone where the machine type resides, such as us-central1-a. + * [Output Only] The name of the zone where the machine type resides, + * such as us-central1-a. * * Generated from protobuf field optional string zone = 3744684; */ @@ -120,38 +131,47 @@ class MachineType extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type array<\Google\Cloud\Compute\V1\Accelerators>|\Google\Protobuf\Internal\RepeatedField $accelerators - * [Output Only] A list of accelerator configurations assigned to this machine type. + * [Output Only] A list of accelerator configurations assigned to this + * machine type. * @type string $architecture * [Output Only] The architecture of the machine type. * Check the Architecture enum for the list of possible values. * @type string $creation_timestamp - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * @type \Google\Cloud\Compute\V1\DeprecationStatus $deprecated - * [Output Only] The deprecation status associated with this machine type. Only applicable if the machine type is unavailable. + * [Output Only] The deprecation status associated with this machine type. + * Only applicable if the machine type is unavailable. * @type string $description * [Output Only] An optional textual description of the resource. * @type int $guest_cpus - * [Output Only] The number of virtual CPUs that are available to the instance. + * [Output Only] The number of virtual CPUs that are available to the + * instance. * @type int|string $id - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * @type int $image_space_gb - * [Deprecated] This property is deprecated and will never be populated with any relevant values. + * [Deprecated] This property is deprecated and will never be populated with + * any relevant values. * @type bool $is_shared_cpu - * [Output Only] Whether this machine type has a shared CPU. See Shared-core machine types for more information. + * [Output Only] Whether this machine type has a shared CPU. SeeShared-core machine + * types for more information. * @type string $kind - * [Output Only] The type of the resource. Always compute#machineType for machine types. + * [Output Only] The type of the resource. Alwayscompute#machineType for machine types. * @type int $maximum_persistent_disks * [Output Only] Maximum persistent disks allowed. * @type int|string $maximum_persistent_disks_size_gb * [Output Only] Maximum total persistent disks size (GB) allowed. * @type int $memory_mb - * [Output Only] The amount of physical memory available to the instance, defined in MB. + * [Output Only] The amount of physical memory available to the instance, + * defined in MB. * @type string $name * [Output Only] Name of the resource. * @type string $self_link * [Output Only] Server-defined URL for the resource. * @type string $zone - * [Output Only] The name of the zone where the machine type resides, such as us-central1-a. + * [Output Only] The name of the zone where the machine type resides, + * such as us-central1-a. * } */ public function __construct($data = NULL) { @@ -160,7 +180,8 @@ public function __construct($data = NULL) { } /** - * [Output Only] A list of accelerator configurations assigned to this machine type. + * [Output Only] A list of accelerator configurations assigned to this + * machine type. * * Generated from protobuf field repeated .google.cloud.compute.v1.Accelerators accelerators = 269577064; * @return \Google\Protobuf\Internal\RepeatedField @@ -171,7 +192,8 @@ public function getAccelerators() } /** - * [Output Only] A list of accelerator configurations assigned to this machine type. + * [Output Only] A list of accelerator configurations assigned to this + * machine type. * * Generated from protobuf field repeated .google.cloud.compute.v1.Accelerators accelerators = 269577064; * @param array<\Google\Cloud\Compute\V1\Accelerators>|\Google\Protobuf\Internal\RepeatedField $var @@ -224,7 +246,8 @@ public function setArchitecture($var) } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @return string @@ -245,7 +268,8 @@ public function clearCreationTimestamp() } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @param string $var @@ -260,7 +284,8 @@ public function setCreationTimestamp($var) } /** - * [Output Only] The deprecation status associated with this machine type. Only applicable if the machine type is unavailable. + * [Output Only] The deprecation status associated with this machine type. + * Only applicable if the machine type is unavailable. * * Generated from protobuf field optional .google.cloud.compute.v1.DeprecationStatus deprecated = 515138995; * @return \Google\Cloud\Compute\V1\DeprecationStatus|null @@ -281,7 +306,8 @@ public function clearDeprecated() } /** - * [Output Only] The deprecation status associated with this machine type. Only applicable if the machine type is unavailable. + * [Output Only] The deprecation status associated with this machine type. + * Only applicable if the machine type is unavailable. * * Generated from protobuf field optional .google.cloud.compute.v1.DeprecationStatus deprecated = 515138995; * @param \Google\Cloud\Compute\V1\DeprecationStatus $var @@ -332,7 +358,8 @@ public function setDescription($var) } /** - * [Output Only] The number of virtual CPUs that are available to the instance. + * [Output Only] The number of virtual CPUs that are available to the + * instance. * * Generated from protobuf field optional int32 guest_cpus = 393356754; * @return int @@ -353,7 +380,8 @@ public function clearGuestCpus() } /** - * [Output Only] The number of virtual CPUs that are available to the instance. + * [Output Only] The number of virtual CPUs that are available to the + * instance. * * Generated from protobuf field optional int32 guest_cpus = 393356754; * @param int $var @@ -368,7 +396,8 @@ public function setGuestCpus($var) } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @return int|string @@ -389,7 +418,8 @@ public function clearId() } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @param int|string $var @@ -404,7 +434,8 @@ public function setId($var) } /** - * [Deprecated] This property is deprecated and will never be populated with any relevant values. + * [Deprecated] This property is deprecated and will never be populated with + * any relevant values. * * Generated from protobuf field optional int32 image_space_gb = 75331864; * @return int @@ -425,7 +456,8 @@ public function clearImageSpaceGb() } /** - * [Deprecated] This property is deprecated and will never be populated with any relevant values. + * [Deprecated] This property is deprecated and will never be populated with + * any relevant values. * * Generated from protobuf field optional int32 image_space_gb = 75331864; * @param int $var @@ -440,7 +472,8 @@ public function setImageSpaceGb($var) } /** - * [Output Only] Whether this machine type has a shared CPU. See Shared-core machine types for more information. + * [Output Only] Whether this machine type has a shared CPU. SeeShared-core machine + * types for more information. * * Generated from protobuf field optional bool is_shared_cpu = 521399555; * @return bool @@ -461,7 +494,8 @@ public function clearIsSharedCpu() } /** - * [Output Only] Whether this machine type has a shared CPU. See Shared-core machine types for more information. + * [Output Only] Whether this machine type has a shared CPU. SeeShared-core machine + * types for more information. * * Generated from protobuf field optional bool is_shared_cpu = 521399555; * @param bool $var @@ -476,7 +510,7 @@ public function setIsSharedCpu($var) } /** - * [Output Only] The type of the resource. Always compute#machineType for machine types. + * [Output Only] The type of the resource. Alwayscompute#machineType for machine types. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -497,7 +531,7 @@ public function clearKind() } /** - * [Output Only] The type of the resource. Always compute#machineType for machine types. + * [Output Only] The type of the resource. Alwayscompute#machineType for machine types. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -584,7 +618,8 @@ public function setMaximumPersistentDisksSizeGb($var) } /** - * [Output Only] The amount of physical memory available to the instance, defined in MB. + * [Output Only] The amount of physical memory available to the instance, + * defined in MB. * * Generated from protobuf field optional int32 memory_mb = 116001171; * @return int @@ -605,7 +640,8 @@ public function clearMemoryMb() } /** - * [Output Only] The amount of physical memory available to the instance, defined in MB. + * [Output Only] The amount of physical memory available to the instance, + * defined in MB. * * Generated from protobuf field optional int32 memory_mb = 116001171; * @param int $var @@ -692,7 +728,8 @@ public function setSelfLink($var) } /** - * [Output Only] The name of the zone where the machine type resides, such as us-central1-a. + * [Output Only] The name of the zone where the machine type resides, + * such as us-central1-a. * * Generated from protobuf field optional string zone = 3744684; * @return string @@ -713,7 +750,8 @@ public function clearZone() } /** - * [Output Only] The name of the zone where the machine type resides, such as us-central1-a. + * [Output Only] The name of the zone where the machine type resides, + * such as us-central1-a. * * Generated from protobuf field optional string zone = 3744684; * @param string $var diff --git a/Compute/src/V1/MachineTypeAggregatedList.php b/Compute/src/V1/MachineTypeAggregatedList.php index ce6bae4eba38..cfbe4e8ba8ae 100644 --- a/Compute/src/V1/MachineTypeAggregatedList.php +++ b/Compute/src/V1/MachineTypeAggregatedList.php @@ -27,13 +27,18 @@ class MachineTypeAggregatedList extends \Google\Protobuf\Internal\Message */ private $items; /** - * [Output Only] Type of resource. Always compute#machineTypeAggregatedList for aggregated lists of machine types. + * [Output Only] Type of resource. Alwayscompute#machineTypeAggregatedList for aggregated lists of + * machine types. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -68,9 +73,14 @@ class MachineTypeAggregatedList extends \Google\Protobuf\Internal\Message * @type array|\Google\Protobuf\Internal\MapField $items * A list of MachineTypesScopedList resources. * @type string $kind - * [Output Only] Type of resource. Always compute#machineTypeAggregatedList for aggregated lists of machine types. + * [Output Only] Type of resource. Alwayscompute#machineTypeAggregatedList for aggregated lists of + * machine types. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type array|\Google\Protobuf\Internal\RepeatedField $unreachables @@ -147,7 +157,8 @@ public function setItems($var) } /** - * [Output Only] Type of resource. Always compute#machineTypeAggregatedList for aggregated lists of machine types. + * [Output Only] Type of resource. Alwayscompute#machineTypeAggregatedList for aggregated lists of + * machine types. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -168,7 +179,8 @@ public function clearKind() } /** - * [Output Only] Type of resource. Always compute#machineTypeAggregatedList for aggregated lists of machine types. + * [Output Only] Type of resource. Alwayscompute#machineTypeAggregatedList for aggregated lists of + * machine types. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -183,7 +195,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -204,7 +220,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/MachineTypeList.php b/Compute/src/V1/MachineTypeList.php index 2ea972c318b8..04a3a371f6d1 100644 --- a/Compute/src/V1/MachineTypeList.php +++ b/Compute/src/V1/MachineTypeList.php @@ -28,13 +28,18 @@ class MachineTypeList extends \Google\Protobuf\Internal\Message */ private $items; /** - * [Output Only] Type of resource. Always compute#machineTypeList for lists of machine types. + * [Output Only] Type of resource. Always compute#machineTypeList + * for lists of machine types. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -63,9 +68,14 @@ class MachineTypeList extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\MachineType>|\Google\Protobuf\Internal\RepeatedField $items * A list of MachineType resources. * @type string $kind - * [Output Only] Type of resource. Always compute#machineTypeList for lists of machine types. + * [Output Only] Type of resource. Always compute#machineTypeList + * for lists of machine types. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type \Google\Cloud\Compute\V1\Warning $warning @@ -140,7 +150,8 @@ public function setItems($var) } /** - * [Output Only] Type of resource. Always compute#machineTypeList for lists of machine types. + * [Output Only] Type of resource. Always compute#machineTypeList + * for lists of machine types. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -161,7 +172,8 @@ public function clearKind() } /** - * [Output Only] Type of resource. Always compute#machineTypeList for lists of machine types. + * [Output Only] Type of resource. Always compute#machineTypeList + * for lists of machine types. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -176,7 +188,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -197,7 +213,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/MachineTypesScopedList.php b/Compute/src/V1/MachineTypesScopedList.php index be492637f8e3..9b5dbc9d6e18 100644 --- a/Compute/src/V1/MachineTypesScopedList.php +++ b/Compute/src/V1/MachineTypesScopedList.php @@ -21,7 +21,8 @@ class MachineTypesScopedList extends \Google\Protobuf\Internal\Message */ private $machine_types; /** - * [Output Only] An informational warning that appears when the machine types list is empty. + * [Output Only] An informational warning that appears when the machine types + * list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; */ @@ -36,7 +37,8 @@ class MachineTypesScopedList extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\MachineType>|\Google\Protobuf\Internal\RepeatedField $machine_types * [Output Only] A list of machine types contained in this scope. * @type \Google\Cloud\Compute\V1\Warning $warning - * [Output Only] An informational warning that appears when the machine types list is empty. + * [Output Only] An informational warning that appears when the machine types + * list is empty. * } */ public function __construct($data = NULL) { @@ -71,7 +73,8 @@ public function setMachineTypes($var) } /** - * [Output Only] An informational warning that appears when the machine types list is empty. + * [Output Only] An informational warning that appears when the machine types + * list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; * @return \Google\Cloud\Compute\V1\Warning|null @@ -92,7 +95,8 @@ public function clearWarning() } /** - * [Output Only] An informational warning that appears when the machine types list is empty. + * [Output Only] An informational warning that appears when the machine types + * list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; * @param \Google\Cloud\Compute\V1\Warning $var diff --git a/Compute/src/V1/ManagedInstance.php b/Compute/src/V1/ManagedInstance.php index 4a8607ea43b8..7686b5b1f0c3 100644 --- a/Compute/src/V1/ManagedInstance.php +++ b/Compute/src/V1/ManagedInstance.php @@ -16,20 +16,46 @@ class ManagedInstance extends \Google\Protobuf\Internal\Message { /** - * [Output Only] The current action that the managed instance group has scheduled for the instance. Possible values: - NONE The instance is running, and the managed instance group does not have any scheduled actions for this instance. - CREATING The managed instance group is creating this instance. If the group fails to create this instance, it will try again until it is successful. - CREATING_WITHOUT_RETRIES The managed instance group is attempting to create this instance only once. If the group fails to create this instance, it does not try again and the group's targetSize value is decreased instead. - RECREATING The managed instance group is recreating this instance. - DELETING The managed instance group is permanently deleting this instance. - ABANDONING The managed instance group is abandoning this instance. The instance will be removed from the instance group and from any target pools that are associated with this group. - RESTARTING The managed instance group is restarting the instance. - REFRESHING The managed instance group is applying configuration changes to the instance without stopping it. For example, the group can update the target pool list for an instance without stopping that instance. - VERIFYING The managed instance group has created the instance and it is in the process of being verified. + * [Output Only] The current action that the managed instance group has + * scheduled for the instance. Possible values: + * - NONE The instance is running, and the managed + * instance group does not have any scheduled actions for this instance. + * - CREATING The managed instance group is creating this + * instance. If the group fails to create this instance, it will try again + * until it is successful. + * - CREATING_WITHOUT_RETRIES The managed instance group + * is attempting to create this instance only once. If the group fails + * to create this instance, it does not try again and the group'stargetSize value is decreased instead. + * - RECREATING The managed instance group is recreating + * this instance. + * - DELETING The managed instance group is permanently + * deleting this instance. + * - ABANDONING The managed instance group is abandoning + * this instance. The instance will be removed from the instance group + * and from any target pools that are associated with this group. + * - RESTARTING The managed instance group is restarting + * the instance. + * - REFRESHING The managed instance group is applying + * configuration changes to the instance without stopping it. For example, + * the group can update the target pool list for an instance without + * stopping that instance. + * - VERIFYING The managed instance group has created the + * instance and it is in the process of being verified. * Check the CurrentAction enum for the list of possible values. * * Generated from protobuf field optional string current_action = 178475964; */ protected $current_action = null; /** - * [Output only] The unique identifier for this resource. This field is empty when instance does not exist. + * [Output only] The unique identifier for this resource. This field is empty + * when instance does not exist. * * Generated from protobuf field optional uint64 id = 3355; */ protected $id = null; /** - * [Output Only] The URL of the instance. The URL can exist even if the instance has not yet been created. + * [Output Only] The URL of the instance. The URL can exist even if the + * instance has not yet been created. * * Generated from protobuf field optional string instance = 18257045; */ @@ -41,38 +67,44 @@ class ManagedInstance extends \Google\Protobuf\Internal\Message */ private $instance_health; /** - * [Output Only] The status of the instance. This field is empty when the instance does not exist. + * [Output Only] The status of the instance. This field is empty when + * the instance does not exist. * Check the InstanceStatus enum for the list of possible values. * * Generated from protobuf field optional string instance_status = 174577372; */ protected $instance_status = null; /** - * [Output Only] Information about the last attempt to create or delete the instance. + * [Output Only] Information about the last attempt to create or delete + * the instance. * * Generated from protobuf field optional .google.cloud.compute.v1.ManagedInstanceLastAttempt last_attempt = 434771492; */ protected $last_attempt = null; /** - * [Output Only] The name of the instance. The name always exists even if the instance has not yet been created. + * [Output Only] The name of the instance. The name always exists even if the + * instance has not yet been created. * * Generated from protobuf field optional string name = 3373707; */ protected $name = null; /** - * [Output Only] Preserved state applied from per-instance config for this instance. + * [Output Only] Preserved state applied from per-instance config + * for this instance. * * Generated from protobuf field optional .google.cloud.compute.v1.PreservedState preserved_state_from_config = 98661858; */ protected $preserved_state_from_config = null; /** - * [Output Only] Preserved state generated based on stateful policy for this instance. + * [Output Only] Preserved state generated based on stateful policy + * for this instance. * * Generated from protobuf field optional .google.cloud.compute.v1.PreservedState preserved_state_from_policy = 470783954; */ protected $preserved_state_from_policy = null; /** - * [Output Only] Instance properties selected for this instance resulting from InstanceFlexibilityPolicy. + * [Output Only] Instance properties selected for this instance resulting from + * InstanceFlexibilityPolicy. * * Generated from protobuf field optional .google.cloud.compute.v1.ManagedInstancePropertiesFromFlexibilityPolicy properties_from_flexibility_policy = 155525825; */ @@ -91,27 +123,59 @@ class ManagedInstance extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $current_action - * [Output Only] The current action that the managed instance group has scheduled for the instance. Possible values: - NONE The instance is running, and the managed instance group does not have any scheduled actions for this instance. - CREATING The managed instance group is creating this instance. If the group fails to create this instance, it will try again until it is successful. - CREATING_WITHOUT_RETRIES The managed instance group is attempting to create this instance only once. If the group fails to create this instance, it does not try again and the group's targetSize value is decreased instead. - RECREATING The managed instance group is recreating this instance. - DELETING The managed instance group is permanently deleting this instance. - ABANDONING The managed instance group is abandoning this instance. The instance will be removed from the instance group and from any target pools that are associated with this group. - RESTARTING The managed instance group is restarting the instance. - REFRESHING The managed instance group is applying configuration changes to the instance without stopping it. For example, the group can update the target pool list for an instance without stopping that instance. - VERIFYING The managed instance group has created the instance and it is in the process of being verified. + * [Output Only] The current action that the managed instance group has + * scheduled for the instance. Possible values: + * - NONE The instance is running, and the managed + * instance group does not have any scheduled actions for this instance. + * - CREATING The managed instance group is creating this + * instance. If the group fails to create this instance, it will try again + * until it is successful. + * - CREATING_WITHOUT_RETRIES The managed instance group + * is attempting to create this instance only once. If the group fails + * to create this instance, it does not try again and the group'stargetSize value is decreased instead. + * - RECREATING The managed instance group is recreating + * this instance. + * - DELETING The managed instance group is permanently + * deleting this instance. + * - ABANDONING The managed instance group is abandoning + * this instance. The instance will be removed from the instance group + * and from any target pools that are associated with this group. + * - RESTARTING The managed instance group is restarting + * the instance. + * - REFRESHING The managed instance group is applying + * configuration changes to the instance without stopping it. For example, + * the group can update the target pool list for an instance without + * stopping that instance. + * - VERIFYING The managed instance group has created the + * instance and it is in the process of being verified. * Check the CurrentAction enum for the list of possible values. * @type int|string $id - * [Output only] The unique identifier for this resource. This field is empty when instance does not exist. + * [Output only] The unique identifier for this resource. This field is empty + * when instance does not exist. * @type string $instance - * [Output Only] The URL of the instance. The URL can exist even if the instance has not yet been created. + * [Output Only] The URL of the instance. The URL can exist even if the + * instance has not yet been created. * @type array<\Google\Cloud\Compute\V1\ManagedInstanceInstanceHealth>|\Google\Protobuf\Internal\RepeatedField $instance_health * [Output Only] Health state of the instance per health-check. * @type string $instance_status - * [Output Only] The status of the instance. This field is empty when the instance does not exist. + * [Output Only] The status of the instance. This field is empty when + * the instance does not exist. * Check the InstanceStatus enum for the list of possible values. * @type \Google\Cloud\Compute\V1\ManagedInstanceLastAttempt $last_attempt - * [Output Only] Information about the last attempt to create or delete the instance. + * [Output Only] Information about the last attempt to create or delete + * the instance. * @type string $name - * [Output Only] The name of the instance. The name always exists even if the instance has not yet been created. + * [Output Only] The name of the instance. The name always exists even if the + * instance has not yet been created. * @type \Google\Cloud\Compute\V1\PreservedState $preserved_state_from_config - * [Output Only] Preserved state applied from per-instance config for this instance. + * [Output Only] Preserved state applied from per-instance config + * for this instance. * @type \Google\Cloud\Compute\V1\PreservedState $preserved_state_from_policy - * [Output Only] Preserved state generated based on stateful policy for this instance. + * [Output Only] Preserved state generated based on stateful policy + * for this instance. * @type \Google\Cloud\Compute\V1\ManagedInstancePropertiesFromFlexibilityPolicy $properties_from_flexibility_policy - * [Output Only] Instance properties selected for this instance resulting from InstanceFlexibilityPolicy. + * [Output Only] Instance properties selected for this instance resulting from + * InstanceFlexibilityPolicy. * @type \Google\Cloud\Compute\V1\ManagedInstanceVersion $version * [Output Only] Intended version of this instance. * } @@ -122,7 +186,31 @@ public function __construct($data = NULL) { } /** - * [Output Only] The current action that the managed instance group has scheduled for the instance. Possible values: - NONE The instance is running, and the managed instance group does not have any scheduled actions for this instance. - CREATING The managed instance group is creating this instance. If the group fails to create this instance, it will try again until it is successful. - CREATING_WITHOUT_RETRIES The managed instance group is attempting to create this instance only once. If the group fails to create this instance, it does not try again and the group's targetSize value is decreased instead. - RECREATING The managed instance group is recreating this instance. - DELETING The managed instance group is permanently deleting this instance. - ABANDONING The managed instance group is abandoning this instance. The instance will be removed from the instance group and from any target pools that are associated with this group. - RESTARTING The managed instance group is restarting the instance. - REFRESHING The managed instance group is applying configuration changes to the instance without stopping it. For example, the group can update the target pool list for an instance without stopping that instance. - VERIFYING The managed instance group has created the instance and it is in the process of being verified. + * [Output Only] The current action that the managed instance group has + * scheduled for the instance. Possible values: + * - NONE The instance is running, and the managed + * instance group does not have any scheduled actions for this instance. + * - CREATING The managed instance group is creating this + * instance. If the group fails to create this instance, it will try again + * until it is successful. + * - CREATING_WITHOUT_RETRIES The managed instance group + * is attempting to create this instance only once. If the group fails + * to create this instance, it does not try again and the group'stargetSize value is decreased instead. + * - RECREATING The managed instance group is recreating + * this instance. + * - DELETING The managed instance group is permanently + * deleting this instance. + * - ABANDONING The managed instance group is abandoning + * this instance. The instance will be removed from the instance group + * and from any target pools that are associated with this group. + * - RESTARTING The managed instance group is restarting + * the instance. + * - REFRESHING The managed instance group is applying + * configuration changes to the instance without stopping it. For example, + * the group can update the target pool list for an instance without + * stopping that instance. + * - VERIFYING The managed instance group has created the + * instance and it is in the process of being verified. * Check the CurrentAction enum for the list of possible values. * * Generated from protobuf field optional string current_action = 178475964; @@ -144,7 +232,31 @@ public function clearCurrentAction() } /** - * [Output Only] The current action that the managed instance group has scheduled for the instance. Possible values: - NONE The instance is running, and the managed instance group does not have any scheduled actions for this instance. - CREATING The managed instance group is creating this instance. If the group fails to create this instance, it will try again until it is successful. - CREATING_WITHOUT_RETRIES The managed instance group is attempting to create this instance only once. If the group fails to create this instance, it does not try again and the group's targetSize value is decreased instead. - RECREATING The managed instance group is recreating this instance. - DELETING The managed instance group is permanently deleting this instance. - ABANDONING The managed instance group is abandoning this instance. The instance will be removed from the instance group and from any target pools that are associated with this group. - RESTARTING The managed instance group is restarting the instance. - REFRESHING The managed instance group is applying configuration changes to the instance without stopping it. For example, the group can update the target pool list for an instance without stopping that instance. - VERIFYING The managed instance group has created the instance and it is in the process of being verified. + * [Output Only] The current action that the managed instance group has + * scheduled for the instance. Possible values: + * - NONE The instance is running, and the managed + * instance group does not have any scheduled actions for this instance. + * - CREATING The managed instance group is creating this + * instance. If the group fails to create this instance, it will try again + * until it is successful. + * - CREATING_WITHOUT_RETRIES The managed instance group + * is attempting to create this instance only once. If the group fails + * to create this instance, it does not try again and the group'stargetSize value is decreased instead. + * - RECREATING The managed instance group is recreating + * this instance. + * - DELETING The managed instance group is permanently + * deleting this instance. + * - ABANDONING The managed instance group is abandoning + * this instance. The instance will be removed from the instance group + * and from any target pools that are associated with this group. + * - RESTARTING The managed instance group is restarting + * the instance. + * - REFRESHING The managed instance group is applying + * configuration changes to the instance without stopping it. For example, + * the group can update the target pool list for an instance without + * stopping that instance. + * - VERIFYING The managed instance group has created the + * instance and it is in the process of being verified. * Check the CurrentAction enum for the list of possible values. * * Generated from protobuf field optional string current_action = 178475964; @@ -160,7 +272,8 @@ public function setCurrentAction($var) } /** - * [Output only] The unique identifier for this resource. This field is empty when instance does not exist. + * [Output only] The unique identifier for this resource. This field is empty + * when instance does not exist. * * Generated from protobuf field optional uint64 id = 3355; * @return int|string @@ -181,7 +294,8 @@ public function clearId() } /** - * [Output only] The unique identifier for this resource. This field is empty when instance does not exist. + * [Output only] The unique identifier for this resource. This field is empty + * when instance does not exist. * * Generated from protobuf field optional uint64 id = 3355; * @param int|string $var @@ -196,7 +310,8 @@ public function setId($var) } /** - * [Output Only] The URL of the instance. The URL can exist even if the instance has not yet been created. + * [Output Only] The URL of the instance. The URL can exist even if the + * instance has not yet been created. * * Generated from protobuf field optional string instance = 18257045; * @return string @@ -217,7 +332,8 @@ public function clearInstance() } /** - * [Output Only] The URL of the instance. The URL can exist even if the instance has not yet been created. + * [Output Only] The URL of the instance. The URL can exist even if the + * instance has not yet been created. * * Generated from protobuf field optional string instance = 18257045; * @param string $var @@ -258,7 +374,8 @@ public function setInstanceHealth($var) } /** - * [Output Only] The status of the instance. This field is empty when the instance does not exist. + * [Output Only] The status of the instance. This field is empty when + * the instance does not exist. * Check the InstanceStatus enum for the list of possible values. * * Generated from protobuf field optional string instance_status = 174577372; @@ -280,7 +397,8 @@ public function clearInstanceStatus() } /** - * [Output Only] The status of the instance. This field is empty when the instance does not exist. + * [Output Only] The status of the instance. This field is empty when + * the instance does not exist. * Check the InstanceStatus enum for the list of possible values. * * Generated from protobuf field optional string instance_status = 174577372; @@ -296,7 +414,8 @@ public function setInstanceStatus($var) } /** - * [Output Only] Information about the last attempt to create or delete the instance. + * [Output Only] Information about the last attempt to create or delete + * the instance. * * Generated from protobuf field optional .google.cloud.compute.v1.ManagedInstanceLastAttempt last_attempt = 434771492; * @return \Google\Cloud\Compute\V1\ManagedInstanceLastAttempt|null @@ -317,7 +436,8 @@ public function clearLastAttempt() } /** - * [Output Only] Information about the last attempt to create or delete the instance. + * [Output Only] Information about the last attempt to create or delete + * the instance. * * Generated from protobuf field optional .google.cloud.compute.v1.ManagedInstanceLastAttempt last_attempt = 434771492; * @param \Google\Cloud\Compute\V1\ManagedInstanceLastAttempt $var @@ -332,7 +452,8 @@ public function setLastAttempt($var) } /** - * [Output Only] The name of the instance. The name always exists even if the instance has not yet been created. + * [Output Only] The name of the instance. The name always exists even if the + * instance has not yet been created. * * Generated from protobuf field optional string name = 3373707; * @return string @@ -353,7 +474,8 @@ public function clearName() } /** - * [Output Only] The name of the instance. The name always exists even if the instance has not yet been created. + * [Output Only] The name of the instance. The name always exists even if the + * instance has not yet been created. * * Generated from protobuf field optional string name = 3373707; * @param string $var @@ -368,7 +490,8 @@ public function setName($var) } /** - * [Output Only] Preserved state applied from per-instance config for this instance. + * [Output Only] Preserved state applied from per-instance config + * for this instance. * * Generated from protobuf field optional .google.cloud.compute.v1.PreservedState preserved_state_from_config = 98661858; * @return \Google\Cloud\Compute\V1\PreservedState|null @@ -389,7 +512,8 @@ public function clearPreservedStateFromConfig() } /** - * [Output Only] Preserved state applied from per-instance config for this instance. + * [Output Only] Preserved state applied from per-instance config + * for this instance. * * Generated from protobuf field optional .google.cloud.compute.v1.PreservedState preserved_state_from_config = 98661858; * @param \Google\Cloud\Compute\V1\PreservedState $var @@ -404,7 +528,8 @@ public function setPreservedStateFromConfig($var) } /** - * [Output Only] Preserved state generated based on stateful policy for this instance. + * [Output Only] Preserved state generated based on stateful policy + * for this instance. * * Generated from protobuf field optional .google.cloud.compute.v1.PreservedState preserved_state_from_policy = 470783954; * @return \Google\Cloud\Compute\V1\PreservedState|null @@ -425,7 +550,8 @@ public function clearPreservedStateFromPolicy() } /** - * [Output Only] Preserved state generated based on stateful policy for this instance. + * [Output Only] Preserved state generated based on stateful policy + * for this instance. * * Generated from protobuf field optional .google.cloud.compute.v1.PreservedState preserved_state_from_policy = 470783954; * @param \Google\Cloud\Compute\V1\PreservedState $var @@ -440,7 +566,8 @@ public function setPreservedStateFromPolicy($var) } /** - * [Output Only] Instance properties selected for this instance resulting from InstanceFlexibilityPolicy. + * [Output Only] Instance properties selected for this instance resulting from + * InstanceFlexibilityPolicy. * * Generated from protobuf field optional .google.cloud.compute.v1.ManagedInstancePropertiesFromFlexibilityPolicy properties_from_flexibility_policy = 155525825; * @return \Google\Cloud\Compute\V1\ManagedInstancePropertiesFromFlexibilityPolicy|null @@ -461,7 +588,8 @@ public function clearPropertiesFromFlexibilityPolicy() } /** - * [Output Only] Instance properties selected for this instance resulting from InstanceFlexibilityPolicy. + * [Output Only] Instance properties selected for this instance resulting from + * InstanceFlexibilityPolicy. * * Generated from protobuf field optional .google.cloud.compute.v1.ManagedInstancePropertiesFromFlexibilityPolicy properties_from_flexibility_policy = 155525825; * @param \Google\Cloud\Compute\V1\ManagedInstancePropertiesFromFlexibilityPolicy $var diff --git a/Compute/src/V1/ManagedInstance/CurrentAction.php b/Compute/src/V1/ManagedInstance/CurrentAction.php index 91b7f7b159d2..a90f8951434f 100644 --- a/Compute/src/V1/ManagedInstance/CurrentAction.php +++ b/Compute/src/V1/ManagedInstance/CurrentAction.php @@ -7,7 +7,31 @@ use UnexpectedValueException; /** - * [Output Only] The current action that the managed instance group has scheduled for the instance. Possible values: - NONE The instance is running, and the managed instance group does not have any scheduled actions for this instance. - CREATING The managed instance group is creating this instance. If the group fails to create this instance, it will try again until it is successful. - CREATING_WITHOUT_RETRIES The managed instance group is attempting to create this instance only once. If the group fails to create this instance, it does not try again and the group's targetSize value is decreased instead. - RECREATING The managed instance group is recreating this instance. - DELETING The managed instance group is permanently deleting this instance. - ABANDONING The managed instance group is abandoning this instance. The instance will be removed from the instance group and from any target pools that are associated with this group. - RESTARTING The managed instance group is restarting the instance. - REFRESHING The managed instance group is applying configuration changes to the instance without stopping it. For example, the group can update the target pool list for an instance without stopping that instance. - VERIFYING The managed instance group has created the instance and it is in the process of being verified. + * [Output Only] The current action that the managed instance group has + * scheduled for the instance. Possible values: + * - NONE The instance is running, and the managed + * instance group does not have any scheduled actions for this instance. + * - CREATING The managed instance group is creating this + * instance. If the group fails to create this instance, it will try again + * until it is successful. + * - CREATING_WITHOUT_RETRIES The managed instance group + * is attempting to create this instance only once. If the group fails + * to create this instance, it does not try again and the group'stargetSize value is decreased instead. + * - RECREATING The managed instance group is recreating + * this instance. + * - DELETING The managed instance group is permanently + * deleting this instance. + * - ABANDONING The managed instance group is abandoning + * this instance. The instance will be removed from the instance group + * and from any target pools that are associated with this group. + * - RESTARTING The managed instance group is restarting + * the instance. + * - REFRESHING The managed instance group is applying + * configuration changes to the instance without stopping it. For example, + * the group can update the target pool list for an instance without + * stopping that instance. + * - VERIFYING The managed instance group has created the + * instance and it is in the process of being verified. * Additional supported values which may be not listed in the enum directly due to technical reasons: * STOPPING * SUSPENDING @@ -23,19 +47,26 @@ class CurrentAction */ const UNDEFINED_CURRENT_ACTION = 0; /** - * The managed instance group is abandoning this instance. The instance will be removed from the instance group and from any target pools that are associated with this group. + * The managed instance group is abandoning this instance. The instance + * will be removed from the instance group and from any target pools that + * are associated with this group. * * Generated from protobuf enum ABANDONING = 388244813; */ const ABANDONING = 388244813; /** - * The managed instance group is creating this instance. If the group fails to create this instance, it will try again until it is successful. + * The managed instance group is creating this instance. If the group + * fails to create this instance, it will try again until it is + * successful. * * Generated from protobuf enum CREATING = 455564985; */ const CREATING = 455564985; /** - * The managed instance group is attempting to create this instance only once. If the group fails to create this instance, it does not try again and the group's targetSize value is decreased. + * The managed instance group is attempting to create this instance + * only once. If the group fails to create this instance, it does + * not try again and the group's targetSize value is + * decreased. * * Generated from protobuf enum CREATING_WITHOUT_RETRIES = 428843785; */ @@ -47,7 +78,8 @@ class CurrentAction */ const DELETING = 528602024; /** - * The managed instance group has not scheduled any actions for this instance. + * The managed instance group has not scheduled any actions for this + * instance. * * Generated from protobuf enum NONE = 2402104; */ @@ -59,7 +91,9 @@ class CurrentAction */ const RECREATING = 287278572; /** - * The managed instance group is applying configuration changes to the instance without stopping it. For example, the group can update the target pool list for an instance without stopping that instance. + * The managed instance group is applying configuration changes to the + * instance without stopping it. For example, the group can update the + * target pool list for an instance without stopping that instance. * * Generated from protobuf enum REFRESHING = 163266343; */ @@ -83,7 +117,14 @@ class CurrentAction */ const STARTING = 488820800; /** - * The managed instance group is verifying this already created instance. Verification happens every time the instance is (re)created or restarted and consists of: 1. Waiting until health check specified as part of this managed instance group's autohealing policy reports HEALTHY. Note: Applies only if autohealing policy has a health check specified 2. Waiting for addition verification steps performed as post-instance creation (subject to future extensions). + * The managed instance group is verifying this already created instance. + * Verification happens every time the instance is (re)created or restarted + * and consists of: + * 1. Waiting until health check specified as part of this managed instance + * group's autohealing policy reports HEALTHY. + * Note: Applies only if autohealing policy has a health check specified + * 2. Waiting for addition verification steps performed as post-instance + * creation (subject to future extensions). * * Generated from protobuf enum VERIFYING = 16982185; */ diff --git a/Compute/src/V1/ManagedInstance/InstanceStatus.php b/Compute/src/V1/ManagedInstance/InstanceStatus.php index b10840ffdcbc..9fe609d685bc 100644 --- a/Compute/src/V1/ManagedInstance/InstanceStatus.php +++ b/Compute/src/V1/ManagedInstance/InstanceStatus.php @@ -7,7 +7,8 @@ use UnexpectedValueException; /** - * [Output Only] The status of the instance. This field is empty when the instance does not exist. + * [Output Only] The status of the instance. This field is empty when + * the instance does not exist. * Additional supported values which may be not listed in the enum directly due to technical reasons: * STOPPING * SUSPENDING @@ -23,13 +24,15 @@ class InstanceStatus */ const UNDEFINED_INSTANCE_STATUS = 0; /** - * The instance is halted and we are performing tear down tasks like network deprogramming, releasing quota, IP, tearing down disks etc. + * The instance is halted and we are performing tear down tasks like network + * deprogramming, releasing quota, IP, tearing down disks etc. * * Generated from protobuf enum DEPROVISIONING = 428935662; */ const DEPROVISIONING = 428935662; /** - * For Flex Start provisioning instance is waiting for available capacity from Dynamic Workload Scheduler (DWS). + * For Flex Start provisioning instance is waiting for available capacity + * from Dynamic Workload Scheduler (DWS). * * Generated from protobuf enum PENDING = 35394935; */ @@ -53,7 +56,8 @@ class InstanceStatus */ const RUNNING = 121282975; /** - * All required resources have been allocated and the instance is being started. + * All required resources have been allocated and the instance + * is being started. * * Generated from protobuf enum STAGING = 431072283; */ @@ -79,7 +83,8 @@ class InstanceStatus */ const SUSPENDING = 514206246; /** - * The instance has stopped (either by explicit action or underlying failure). + * The instance has stopped (either by explicit action or underlying + * failure). * * Generated from protobuf enum TERMINATED = 250018339; */ diff --git a/Compute/src/V1/ManagedInstanceInstanceHealth.php b/Compute/src/V1/ManagedInstanceInstanceHealth.php index 3ce8478f8fb5..4948fefedf31 100644 --- a/Compute/src/V1/ManagedInstanceInstanceHealth.php +++ b/Compute/src/V1/ManagedInstanceInstanceHealth.php @@ -22,7 +22,8 @@ class ManagedInstanceInstanceHealth extends \Google\Protobuf\Internal\Message */ protected $detailed_health_state = null; /** - * [Output Only] The URL for the health check that verifies whether the instance is healthy. + * [Output Only] The URL for the health check that verifies whether the + * instance is healthy. * * Generated from protobuf field optional string health_check = 308876645; */ @@ -38,7 +39,8 @@ class ManagedInstanceInstanceHealth extends \Google\Protobuf\Internal\Message * [Output Only] The current detailed instance health state. * Check the DetailedHealthState enum for the list of possible values. * @type string $health_check - * [Output Only] The URL for the health check that verifies whether the instance is healthy. + * [Output Only] The URL for the health check that verifies whether the + * instance is healthy. * } */ public function __construct($data = NULL) { @@ -85,7 +87,8 @@ public function setDetailedHealthState($var) } /** - * [Output Only] The URL for the health check that verifies whether the instance is healthy. + * [Output Only] The URL for the health check that verifies whether the + * instance is healthy. * * Generated from protobuf field optional string health_check = 308876645; * @return string @@ -106,7 +109,8 @@ public function clearHealthCheck() } /** - * [Output Only] The URL for the health check that verifies whether the instance is healthy. + * [Output Only] The URL for the health check that verifies whether the + * instance is healthy. * * Generated from protobuf field optional string health_check = 308876645; * @param string $var diff --git a/Compute/src/V1/ManagedInstanceInstanceHealth/DetailedHealthState.php b/Compute/src/V1/ManagedInstanceInstanceHealth/DetailedHealthState.php index 69f272b219c1..49412848f9c8 100644 --- a/Compute/src/V1/ManagedInstanceInstanceHealth/DetailedHealthState.php +++ b/Compute/src/V1/ManagedInstanceInstanceHealth/DetailedHealthState.php @@ -20,31 +20,38 @@ class DetailedHealthState */ const UNDEFINED_DETAILED_HEALTH_STATE = 0; /** - * The instance is being drained. The existing connections to the instance have time to complete, but the new ones are being refused. + * The instance is being drained. The existing connections to the instance + * have time to complete, but the new ones are being refused. * * Generated from protobuf enum DRAINING = 480455402; */ const DRAINING = 480455402; /** - * The instance is reachable i.e. a connection to the application health checking endpoint can be established, and conforms to the requirements defined by the health check. + * The instance is reachable i.e. a connection to the application health + * checking endpoint can be established, and conforms to the requirements + * defined by the health check. * * Generated from protobuf enum HEALTHY = 439801213; */ const HEALTHY = 439801213; /** - * The instance is unreachable i.e. a connection to the application health checking endpoint cannot be established, or the server does not respond within the specified timeout. + * The instance is unreachable i.e. a connection to the application health + * checking endpoint cannot be established, or the server does not respond + * within the specified timeout. * * Generated from protobuf enum TIMEOUT = 477813057; */ const TIMEOUT = 477813057; /** - * The instance is reachable, but does not conform to the requirements defined by the health check. + * The instance is reachable, but does not conform to the requirements + * defined by the health check. * * Generated from protobuf enum UNHEALTHY = 462118084; */ const UNHEALTHY = 462118084; /** - * The health checking system is aware of the instance but its health is not known at the moment. + * The health checking system is aware of the instance but its health is + * not known at the moment. * * Generated from protobuf enum UNKNOWN = 433141802; */ diff --git a/Compute/src/V1/ManagedInstanceLastAttempt.php b/Compute/src/V1/ManagedInstanceLastAttempt.php index 51c7d3a92539..e3181a67c1ca 100644 --- a/Compute/src/V1/ManagedInstanceLastAttempt.php +++ b/Compute/src/V1/ManagedInstanceLastAttempt.php @@ -15,7 +15,8 @@ class ManagedInstanceLastAttempt extends \Google\Protobuf\Internal\Message { /** - * [Output Only] Encountered errors during the last attempt to create or delete the instance. + * [Output Only] Encountered errors during the last attempt to create or + * delete the instance. * * Generated from protobuf field optional .google.cloud.compute.v1.ManagedInstanceLastAttemptErrors errors = 315977579; */ @@ -28,7 +29,8 @@ class ManagedInstanceLastAttempt extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type \Google\Cloud\Compute\V1\ManagedInstanceLastAttemptErrors $errors - * [Output Only] Encountered errors during the last attempt to create or delete the instance. + * [Output Only] Encountered errors during the last attempt to create or + * delete the instance. * } */ public function __construct($data = NULL) { @@ -37,7 +39,8 @@ public function __construct($data = NULL) { } /** - * [Output Only] Encountered errors during the last attempt to create or delete the instance. + * [Output Only] Encountered errors during the last attempt to create or + * delete the instance. * * Generated from protobuf field optional .google.cloud.compute.v1.ManagedInstanceLastAttemptErrors errors = 315977579; * @return \Google\Cloud\Compute\V1\ManagedInstanceLastAttemptErrors|null @@ -58,7 +61,8 @@ public function clearErrors() } /** - * [Output Only] Encountered errors during the last attempt to create or delete the instance. + * [Output Only] Encountered errors during the last attempt to create or + * delete the instance. * * Generated from protobuf field optional .google.cloud.compute.v1.ManagedInstanceLastAttemptErrors errors = 315977579; * @param \Google\Cloud\Compute\V1\ManagedInstanceLastAttemptErrors $var diff --git a/Compute/src/V1/ManagedInstanceLastAttemptErrors.php b/Compute/src/V1/ManagedInstanceLastAttemptErrors.php index 8596d81edfde..11eae7f5e562 100644 --- a/Compute/src/V1/ManagedInstanceLastAttemptErrors.php +++ b/Compute/src/V1/ManagedInstanceLastAttemptErrors.php @@ -9,14 +9,16 @@ use Google\Protobuf\Internal\GPBUtil; /** - * [Output Only] Encountered errors during the last attempt to create or delete the instance. + * [Output Only] Encountered errors during the last attempt to create or + * delete the instance. * * Generated from protobuf message google.cloud.compute.v1.ManagedInstanceLastAttemptErrors */ class ManagedInstanceLastAttemptErrors extends \Google\Protobuf\Internal\Message { /** - * [Output Only] The array of errors encountered while processing this operation. + * [Output Only] The array of errors encountered while processing this + * operation. * * Generated from protobuf field repeated .google.cloud.compute.v1.Errors errors = 315977579; */ @@ -29,7 +31,8 @@ class ManagedInstanceLastAttemptErrors extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type array<\Google\Cloud\Compute\V1\Errors>|\Google\Protobuf\Internal\RepeatedField $errors - * [Output Only] The array of errors encountered while processing this operation. + * [Output Only] The array of errors encountered while processing this + * operation. * } */ public function __construct($data = NULL) { @@ -38,7 +41,8 @@ public function __construct($data = NULL) { } /** - * [Output Only] The array of errors encountered while processing this operation. + * [Output Only] The array of errors encountered while processing this + * operation. * * Generated from protobuf field repeated .google.cloud.compute.v1.Errors errors = 315977579; * @return \Google\Protobuf\Internal\RepeatedField @@ -49,7 +53,8 @@ public function getErrors() } /** - * [Output Only] The array of errors encountered while processing this operation. + * [Output Only] The array of errors encountered while processing this + * operation. * * Generated from protobuf field repeated .google.cloud.compute.v1.Errors errors = 315977579; * @param array<\Google\Cloud\Compute\V1\Errors>|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/ManagedInstanceVersion.php b/Compute/src/V1/ManagedInstanceVersion.php index 044944d7ec5e..109d1d94263f 100644 --- a/Compute/src/V1/ManagedInstanceVersion.php +++ b/Compute/src/V1/ManagedInstanceVersion.php @@ -15,7 +15,8 @@ class ManagedInstanceVersion extends \Google\Protobuf\Internal\Message { /** - * [Output Only] The intended template of the instance. This field is empty when current_action is one of { DELETING, ABANDONING }. + * [Output Only] The intended template of the instance. This field is empty + * when current_action is one of { DELETING, ABANDONING }. * * Generated from protobuf field optional string instance_template = 309248228; */ @@ -34,7 +35,8 @@ class ManagedInstanceVersion extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $instance_template - * [Output Only] The intended template of the instance. This field is empty when current_action is one of { DELETING, ABANDONING }. + * [Output Only] The intended template of the instance. This field is empty + * when current_action is one of { DELETING, ABANDONING }. * @type string $name * [Output Only] Name of the version. * } @@ -45,7 +47,8 @@ public function __construct($data = NULL) { } /** - * [Output Only] The intended template of the instance. This field is empty when current_action is one of { DELETING, ABANDONING }. + * [Output Only] The intended template of the instance. This field is empty + * when current_action is one of { DELETING, ABANDONING }. * * Generated from protobuf field optional string instance_template = 309248228; * @return string @@ -66,7 +69,8 @@ public function clearInstanceTemplate() } /** - * [Output Only] The intended template of the instance. This field is empty when current_action is one of { DELETING, ABANDONING }. + * [Output Only] The intended template of the instance. This field is empty + * when current_action is one of { DELETING, ABANDONING }. * * Generated from protobuf field optional string instance_template = 309248228; * @param string $var diff --git a/Compute/src/V1/Metadata.php b/Compute/src/V1/Metadata.php index ac74cbd159bc..b7b61b134f02 100644 --- a/Compute/src/V1/Metadata.php +++ b/Compute/src/V1/Metadata.php @@ -16,19 +16,28 @@ class Metadata extends \Google\Protobuf\Internal\Message { /** - * Specifies a fingerprint for this request, which is essentially a hash of the metadata's contents and used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update metadata. You must always provide an up-to-date fingerprint hash in order to update or change metadata, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve the resource. + * Specifies a fingerprint for this request, which is essentially a hash of + * the metadata's contents and used for optimistic locking. The + * fingerprint is initially generated by Compute Engine and changes after + * every request to modify or update metadata. You must always provide an + * up-to-date fingerprint hash in order to update or change metadata, + * otherwise the request will fail with error412 conditionNotMet. + * To see the latest fingerprint, make a get() request to + * retrieve the resource. * * Generated from protobuf field optional string fingerprint = 234678500; */ protected $fingerprint = null; /** - * Array of key/value pairs. The total size of all keys and values must be less than 512 KB. + * Array of key/value pairs. The total size of all keys and values must be + * less than 512 KB. * * Generated from protobuf field repeated .google.cloud.compute.v1.Items items = 100526016; */ private $items; /** - * [Output Only] Type of the resource. Always compute#metadata for metadata. + * [Output Only] Type of the resource. Always compute#metadata + * for metadata. * * Generated from protobuf field optional string kind = 3292052; */ @@ -41,11 +50,20 @@ class Metadata extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $fingerprint - * Specifies a fingerprint for this request, which is essentially a hash of the metadata's contents and used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update metadata. You must always provide an up-to-date fingerprint hash in order to update or change metadata, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve the resource. + * Specifies a fingerprint for this request, which is essentially a hash of + * the metadata's contents and used for optimistic locking. The + * fingerprint is initially generated by Compute Engine and changes after + * every request to modify or update metadata. You must always provide an + * up-to-date fingerprint hash in order to update or change metadata, + * otherwise the request will fail with error412 conditionNotMet. + * To see the latest fingerprint, make a get() request to + * retrieve the resource. * @type array<\Google\Cloud\Compute\V1\Items>|\Google\Protobuf\Internal\RepeatedField $items - * Array of key/value pairs. The total size of all keys and values must be less than 512 KB. + * Array of key/value pairs. The total size of all keys and values must be + * less than 512 KB. * @type string $kind - * [Output Only] Type of the resource. Always compute#metadata for metadata. + * [Output Only] Type of the resource. Always compute#metadata + * for metadata. * } */ public function __construct($data = NULL) { @@ -54,7 +72,14 @@ public function __construct($data = NULL) { } /** - * Specifies a fingerprint for this request, which is essentially a hash of the metadata's contents and used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update metadata. You must always provide an up-to-date fingerprint hash in order to update or change metadata, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve the resource. + * Specifies a fingerprint for this request, which is essentially a hash of + * the metadata's contents and used for optimistic locking. The + * fingerprint is initially generated by Compute Engine and changes after + * every request to modify or update metadata. You must always provide an + * up-to-date fingerprint hash in order to update or change metadata, + * otherwise the request will fail with error412 conditionNotMet. + * To see the latest fingerprint, make a get() request to + * retrieve the resource. * * Generated from protobuf field optional string fingerprint = 234678500; * @return string @@ -75,7 +100,14 @@ public function clearFingerprint() } /** - * Specifies a fingerprint for this request, which is essentially a hash of the metadata's contents and used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update metadata. You must always provide an up-to-date fingerprint hash in order to update or change metadata, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve the resource. + * Specifies a fingerprint for this request, which is essentially a hash of + * the metadata's contents and used for optimistic locking. The + * fingerprint is initially generated by Compute Engine and changes after + * every request to modify or update metadata. You must always provide an + * up-to-date fingerprint hash in order to update or change metadata, + * otherwise the request will fail with error412 conditionNotMet. + * To see the latest fingerprint, make a get() request to + * retrieve the resource. * * Generated from protobuf field optional string fingerprint = 234678500; * @param string $var @@ -90,7 +122,8 @@ public function setFingerprint($var) } /** - * Array of key/value pairs. The total size of all keys and values must be less than 512 KB. + * Array of key/value pairs. The total size of all keys and values must be + * less than 512 KB. * * Generated from protobuf field repeated .google.cloud.compute.v1.Items items = 100526016; * @return \Google\Protobuf\Internal\RepeatedField @@ -101,7 +134,8 @@ public function getItems() } /** - * Array of key/value pairs. The total size of all keys and values must be less than 512 KB. + * Array of key/value pairs. The total size of all keys and values must be + * less than 512 KB. * * Generated from protobuf field repeated .google.cloud.compute.v1.Items items = 100526016; * @param array<\Google\Cloud\Compute\V1\Items>|\Google\Protobuf\Internal\RepeatedField $var @@ -116,7 +150,8 @@ public function setItems($var) } /** - * [Output Only] Type of the resource. Always compute#metadata for metadata. + * [Output Only] Type of the resource. Always compute#metadata + * for metadata. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -137,7 +172,8 @@ public function clearKind() } /** - * [Output Only] Type of the resource. Always compute#metadata for metadata. + * [Output Only] Type of the resource. Always compute#metadata + * for metadata. * * Generated from protobuf field optional string kind = 3292052; * @param string $var diff --git a/Compute/src/V1/MetadataFilter.php b/Compute/src/V1/MetadataFilter.php index 54b785c8aaee..7c4ab5f45883 100644 --- a/Compute/src/V1/MetadataFilter.php +++ b/Compute/src/V1/MetadataFilter.php @@ -9,20 +9,42 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Opaque filter criteria used by load balancers to restrict routing configuration to a limited set of load balancing proxies. Proxies and sidecars involved in load balancing would typically present metadata to the load balancers that need to match criteria specified here. If a match takes place, the relevant configuration is made available to those proxies. For each metadataFilter in this list, if its filterMatchCriteria is set to MATCH_ANY, at least one of the filterLabels must match the corresponding label provided in the metadata. If its filterMatchCriteria is set to MATCH_ALL, then all of its filterLabels must match with corresponding labels provided in the metadata. An example for using metadataFilters would be: if load balancing involves Envoys, they receive routing configuration when values in metadataFilters match values supplied in of their XDS requests to loadbalancers. + * Opaque filter criteria used by load balancers to restrict routing + * configuration to a limited set of load balancing proxies. Proxies and + * sidecars involved in load balancing would typically present metadata to the + * load balancers that need to match criteria specified here. If a match takes + * place, the relevant configuration is made available to those + * proxies. + * For each metadataFilter in this list, if itsfilterMatchCriteria is set to MATCH_ANY, at least + * one of thefilterLabels must match the corresponding label provided in + * the metadata. If its filterMatchCriteria is set to + * MATCH_ALL, then all of its filterLabels must match with + * corresponding labels provided in the metadata. + * An example for using metadataFilters would be: if + * load balancing involves + * Envoys, they receive routing configuration when values inmetadataFilters match values supplied in of their XDS requests to loadbalancers. * * Generated from protobuf message google.cloud.compute.v1.MetadataFilter */ class MetadataFilter extends \Google\Protobuf\Internal\Message { /** - * The list of label value pairs that must match labels in the provided metadata based on filterMatchCriteria This list must not be empty and can have at the most 64 entries. + * The list of label value pairs that must match labels in the provided + * metadata based on filterMatchCriteria + * This list must not be empty and can have at the most 64 entries. * * Generated from protobuf field repeated .google.cloud.compute.v1.MetadataFilterLabelMatch filter_labels = 307903142; */ private $filter_labels; /** - * Specifies how individual filter label matches within the list of filterLabels and contributes toward the overall metadataFilter match. Supported values are: - MATCH_ANY: at least one of the filterLabels must have a matching label in the provided metadata. - MATCH_ALL: all filterLabels must have matching labels in the provided metadata. + * Specifies how individual filter label matches + * within the list of filterLabels and contributes toward the + * overall metadataFilter match. + * Supported values are: + * - MATCH_ANY: at least one of the filterLabels + * must have a matching label in the provided metadata. + * - MATCH_ALL: all filterLabels must have + * matching labels in the provided metadata. * Check the FilterMatchCriteria enum for the list of possible values. * * Generated from protobuf field optional string filter_match_criteria = 239970368; @@ -36,9 +58,18 @@ class MetadataFilter extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type array<\Google\Cloud\Compute\V1\MetadataFilterLabelMatch>|\Google\Protobuf\Internal\RepeatedField $filter_labels - * The list of label value pairs that must match labels in the provided metadata based on filterMatchCriteria This list must not be empty and can have at the most 64 entries. + * The list of label value pairs that must match labels in the provided + * metadata based on filterMatchCriteria + * This list must not be empty and can have at the most 64 entries. * @type string $filter_match_criteria - * Specifies how individual filter label matches within the list of filterLabels and contributes toward the overall metadataFilter match. Supported values are: - MATCH_ANY: at least one of the filterLabels must have a matching label in the provided metadata. - MATCH_ALL: all filterLabels must have matching labels in the provided metadata. + * Specifies how individual filter label matches + * within the list of filterLabels and contributes toward the + * overall metadataFilter match. + * Supported values are: + * - MATCH_ANY: at least one of the filterLabels + * must have a matching label in the provided metadata. + * - MATCH_ALL: all filterLabels must have + * matching labels in the provided metadata. * Check the FilterMatchCriteria enum for the list of possible values. * } */ @@ -48,7 +79,9 @@ public function __construct($data = NULL) { } /** - * The list of label value pairs that must match labels in the provided metadata based on filterMatchCriteria This list must not be empty and can have at the most 64 entries. + * The list of label value pairs that must match labels in the provided + * metadata based on filterMatchCriteria + * This list must not be empty and can have at the most 64 entries. * * Generated from protobuf field repeated .google.cloud.compute.v1.MetadataFilterLabelMatch filter_labels = 307903142; * @return \Google\Protobuf\Internal\RepeatedField @@ -59,7 +92,9 @@ public function getFilterLabels() } /** - * The list of label value pairs that must match labels in the provided metadata based on filterMatchCriteria This list must not be empty and can have at the most 64 entries. + * The list of label value pairs that must match labels in the provided + * metadata based on filterMatchCriteria + * This list must not be empty and can have at the most 64 entries. * * Generated from protobuf field repeated .google.cloud.compute.v1.MetadataFilterLabelMatch filter_labels = 307903142; * @param array<\Google\Cloud\Compute\V1\MetadataFilterLabelMatch>|\Google\Protobuf\Internal\RepeatedField $var @@ -74,7 +109,14 @@ public function setFilterLabels($var) } /** - * Specifies how individual filter label matches within the list of filterLabels and contributes toward the overall metadataFilter match. Supported values are: - MATCH_ANY: at least one of the filterLabels must have a matching label in the provided metadata. - MATCH_ALL: all filterLabels must have matching labels in the provided metadata. + * Specifies how individual filter label matches + * within the list of filterLabels and contributes toward the + * overall metadataFilter match. + * Supported values are: + * - MATCH_ANY: at least one of the filterLabels + * must have a matching label in the provided metadata. + * - MATCH_ALL: all filterLabels must have + * matching labels in the provided metadata. * Check the FilterMatchCriteria enum for the list of possible values. * * Generated from protobuf field optional string filter_match_criteria = 239970368; @@ -96,7 +138,14 @@ public function clearFilterMatchCriteria() } /** - * Specifies how individual filter label matches within the list of filterLabels and contributes toward the overall metadataFilter match. Supported values are: - MATCH_ANY: at least one of the filterLabels must have a matching label in the provided metadata. - MATCH_ALL: all filterLabels must have matching labels in the provided metadata. + * Specifies how individual filter label matches + * within the list of filterLabels and contributes toward the + * overall metadataFilter match. + * Supported values are: + * - MATCH_ANY: at least one of the filterLabels + * must have a matching label in the provided metadata. + * - MATCH_ALL: all filterLabels must have + * matching labels in the provided metadata. * Check the FilterMatchCriteria enum for the list of possible values. * * Generated from protobuf field optional string filter_match_criteria = 239970368; diff --git a/Compute/src/V1/MetadataFilter/FilterMatchCriteria.php b/Compute/src/V1/MetadataFilter/FilterMatchCriteria.php index 36c6014b7078..ea13438297f2 100644 --- a/Compute/src/V1/MetadataFilter/FilterMatchCriteria.php +++ b/Compute/src/V1/MetadataFilter/FilterMatchCriteria.php @@ -7,7 +7,14 @@ use UnexpectedValueException; /** - * Specifies how individual filter label matches within the list of filterLabels and contributes toward the overall metadataFilter match. Supported values are: - MATCH_ANY: at least one of the filterLabels must have a matching label in the provided metadata. - MATCH_ALL: all filterLabels must have matching labels in the provided metadata. + * Specifies how individual filter label matches + * within the list of filterLabels and contributes toward the + * overall metadataFilter match. + * Supported values are: + * - MATCH_ANY: at least one of the filterLabels + * must have a matching label in the provided metadata. + * - MATCH_ALL: all filterLabels must have + * matching labels in the provided metadata. * * Protobuf type google.cloud.compute.v1.MetadataFilter.FilterMatchCriteria */ @@ -20,19 +27,19 @@ class FilterMatchCriteria */ const UNDEFINED_FILTER_MATCH_CRITERIA = 0; /** - * Specifies that all filterLabels must match for the metadataFilter to be considered a match. + * Specifies that all filterLabels must match for themetadataFilter to be considered a match. * * Generated from protobuf enum MATCH_ALL = 180663271; */ const MATCH_ALL = 180663271; /** - * Specifies that any filterLabel must match for the metadataFilter to be considered a match. + * Specifies that any filterLabel must match for themetadataFilter to be considered a match. * * Generated from protobuf enum MATCH_ANY = 180663346; */ const MATCH_ANY = 180663346; /** - * Indicates that the match criteria was not set. A metadataFilter must never be created with this value. + * Indicates that the match criteria was not set. AmetadataFilter must never be created with this value. * * Generated from protobuf enum NOT_SET = 163646646; */ diff --git a/Compute/src/V1/MetadataFilterLabelMatch.php b/Compute/src/V1/MetadataFilterLabelMatch.php index 2155c11297d9..455232b16eee 100644 --- a/Compute/src/V1/MetadataFilterLabelMatch.php +++ b/Compute/src/V1/MetadataFilterLabelMatch.php @@ -9,20 +9,24 @@ use Google\Protobuf\Internal\GPBUtil; /** - * MetadataFilter label name value pairs that are expected to match corresponding labels presented as metadata to the load balancer. + * MetadataFilter label name value pairs that are expected + * to match corresponding labels presented as metadata to the load balancer. * * Generated from protobuf message google.cloud.compute.v1.MetadataFilterLabelMatch */ class MetadataFilterLabelMatch extends \Google\Protobuf\Internal\Message { /** - * Name of metadata label. The name can have a maximum length of 1024 characters and must be at least 1 character long. + * Name of metadata label. + * The name can have a maximum length of 1024 characters and must be at + * least 1 character long. * * Generated from protobuf field optional string name = 3373707; */ protected $name = null; /** - * The value of the label must match the specified value. value can have a maximum length of 1024 characters. + * The value of the label must match the specified value. + * value can have a maximum length of 1024 characters. * * Generated from protobuf field optional string value = 111972721; */ @@ -35,9 +39,12 @@ class MetadataFilterLabelMatch extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $name - * Name of metadata label. The name can have a maximum length of 1024 characters and must be at least 1 character long. + * Name of metadata label. + * The name can have a maximum length of 1024 characters and must be at + * least 1 character long. * @type string $value - * The value of the label must match the specified value. value can have a maximum length of 1024 characters. + * The value of the label must match the specified value. + * value can have a maximum length of 1024 characters. * } */ public function __construct($data = NULL) { @@ -46,7 +53,9 @@ public function __construct($data = NULL) { } /** - * Name of metadata label. The name can have a maximum length of 1024 characters and must be at least 1 character long. + * Name of metadata label. + * The name can have a maximum length of 1024 characters and must be at + * least 1 character long. * * Generated from protobuf field optional string name = 3373707; * @return string @@ -67,7 +76,9 @@ public function clearName() } /** - * Name of metadata label. The name can have a maximum length of 1024 characters and must be at least 1 character long. + * Name of metadata label. + * The name can have a maximum length of 1024 characters and must be at + * least 1 character long. * * Generated from protobuf field optional string name = 3373707; * @param string $var @@ -82,7 +93,8 @@ public function setName($var) } /** - * The value of the label must match the specified value. value can have a maximum length of 1024 characters. + * The value of the label must match the specified value. + * value can have a maximum length of 1024 characters. * * Generated from protobuf field optional string value = 111972721; * @return string @@ -103,7 +115,8 @@ public function clearValue() } /** - * The value of the label must match the specified value. value can have a maximum length of 1024 characters. + * The value of the label must match the specified value. + * value can have a maximum length of 1024 characters. * * Generated from protobuf field optional string value = 111972721; * @param string $var diff --git a/Compute/src/V1/MoveAddressRequest.php b/Compute/src/V1/MoveAddressRequest.php index 16dfe627fc1a..e762115b12b2 100644 --- a/Compute/src/V1/MoveAddressRequest.php +++ b/Compute/src/V1/MoveAddressRequest.php @@ -40,7 +40,17 @@ class MoveAddressRequest extends \Google\Protobuf\Internal\Message */ protected $region_addresses_move_request_resource = null; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -80,7 +90,17 @@ public static function build(string $project, string $region, string $address, \ * @type \Google\Cloud\Compute\V1\RegionAddressesMoveRequest $region_addresses_move_request_resource * The body resource for this request * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -203,7 +223,17 @@ public function setRegionAddressesMoveRequestResource($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -224,7 +254,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/MoveDiskProjectRequest.php b/Compute/src/V1/MoveDiskProjectRequest.php index f39fe4901049..194456b9d2fe 100644 --- a/Compute/src/V1/MoveDiskProjectRequest.php +++ b/Compute/src/V1/MoveDiskProjectRequest.php @@ -28,7 +28,17 @@ class MoveDiskProjectRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -60,7 +70,17 @@ public static function build(string $project, \Google\Cloud\Compute\V1\DiskMoveR * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -131,7 +151,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -152,7 +182,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/MoveFirewallPolicyRequest.php b/Compute/src/V1/MoveFirewallPolicyRequest.php index 76912e1d69c0..6095b9c1535c 100644 --- a/Compute/src/V1/MoveFirewallPolicyRequest.php +++ b/Compute/src/V1/MoveFirewallPolicyRequest.php @@ -22,13 +22,25 @@ class MoveFirewallPolicyRequest extends \Google\Protobuf\Internal\Message */ protected $firewall_policy = ''; /** - * The new parent of the firewall policy. The ID can be either be "folders/[FOLDER_ID]" if the parent is a folder or "organizations/[ORGANIZATION_ID]" if the parent is an organization. + * The new parent of the firewall policy. The ID can be either be + * "folders/[FOLDER_ID]" if the parent is a folder or + * "organizations/[ORGANIZATION_ID]" if the parent is an organization. * * Generated from protobuf field string parent_id = 459714768 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "parent_id"]; */ protected $parent_id = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -36,7 +48,9 @@ class MoveFirewallPolicyRequest extends \Google\Protobuf\Internal\Message /** * @param string $firewallPolicy Name of the firewall policy to update. - * @param string $parentId The new parent of the firewall policy. The ID can be either be "folders/[FOLDER_ID]" if the parent is a folder or "organizations/[ORGANIZATION_ID]" if the parent is an organization. + * @param string $parentId The new parent of the firewall policy. The ID can be either be + * "folders/[FOLDER_ID]" if the parent is a folder or + * "organizations/[ORGANIZATION_ID]" if the parent is an organization. * * @return \Google\Cloud\Compute\V1\MoveFirewallPolicyRequest * @@ -58,9 +72,21 @@ public static function build(string $firewallPolicy, string $parentId): self * @type string $firewall_policy * Name of the firewall policy to update. * @type string $parent_id - * The new parent of the firewall policy. The ID can be either be "folders/[FOLDER_ID]" if the parent is a folder or "organizations/[ORGANIZATION_ID]" if the parent is an organization. + * The new parent of the firewall policy. The ID can be either be + * "folders/[FOLDER_ID]" if the parent is a folder or + * "organizations/[ORGANIZATION_ID]" if the parent is an organization. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -95,7 +121,9 @@ public function setFirewallPolicy($var) } /** - * The new parent of the firewall policy. The ID can be either be "folders/[FOLDER_ID]" if the parent is a folder or "organizations/[ORGANIZATION_ID]" if the parent is an organization. + * The new parent of the firewall policy. The ID can be either be + * "folders/[FOLDER_ID]" if the parent is a folder or + * "organizations/[ORGANIZATION_ID]" if the parent is an organization. * * Generated from protobuf field string parent_id = 459714768 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "parent_id"]; * @return string @@ -106,7 +134,9 @@ public function getParentId() } /** - * The new parent of the firewall policy. The ID can be either be "folders/[FOLDER_ID]" if the parent is a folder or "organizations/[ORGANIZATION_ID]" if the parent is an organization. + * The new parent of the firewall policy. The ID can be either be + * "folders/[FOLDER_ID]" if the parent is a folder or + * "organizations/[ORGANIZATION_ID]" if the parent is an organization. * * Generated from protobuf field string parent_id = 459714768 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "parent_id"]; * @param string $var @@ -121,7 +151,17 @@ public function setParentId($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -142,7 +182,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/MoveGlobalAddressRequest.php b/Compute/src/V1/MoveGlobalAddressRequest.php index 947e4180e9a3..84bfebf1111d 100644 --- a/Compute/src/V1/MoveGlobalAddressRequest.php +++ b/Compute/src/V1/MoveGlobalAddressRequest.php @@ -34,7 +34,17 @@ class MoveGlobalAddressRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -70,7 +80,17 @@ public static function build(string $project, string $address, \Google\Cloud\Com * @type string $project * Source project ID which the Address is moved from. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -167,7 +187,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -188,7 +218,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/MoveInstanceProjectRequest.php b/Compute/src/V1/MoveInstanceProjectRequest.php index 91d6b575be6b..7510cc2ab8d5 100644 --- a/Compute/src/V1/MoveInstanceProjectRequest.php +++ b/Compute/src/V1/MoveInstanceProjectRequest.php @@ -28,7 +28,17 @@ class MoveInstanceProjectRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -60,7 +70,17 @@ public static function build(string $project, \Google\Cloud\Compute\V1\InstanceM * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -131,7 +151,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -152,7 +182,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/MoveOrganizationSecurityPolicyRequest.php b/Compute/src/V1/MoveOrganizationSecurityPolicyRequest.php index 4cc3a335122a..b29b001889e0 100644 --- a/Compute/src/V1/MoveOrganizationSecurityPolicyRequest.php +++ b/Compute/src/V1/MoveOrganizationSecurityPolicyRequest.php @@ -22,7 +22,17 @@ class MoveOrganizationSecurityPolicyRequest extends \Google\Protobuf\Internal\Me */ protected $parent_id = null; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -56,7 +66,17 @@ public static function build(string $securityPolicy): self * @type string $parent_id * The new parent of the security policy. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $security_policy * Name of the security policy to update. * } @@ -103,7 +123,17 @@ public function setParentId($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -124,7 +154,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/NamedPort.php b/Compute/src/V1/NamedPort.php index d007030dbc21..13befdd9bdad 100644 --- a/Compute/src/V1/NamedPort.php +++ b/Compute/src/V1/NamedPort.php @@ -16,7 +16,8 @@ class NamedPort extends \Google\Protobuf\Internal\Message { /** - * The name for this named port. The name must be 1-63 characters long, and comply with RFC1035. + * The name for this named port. + * The name must be 1-63 characters long, and comply withRFC1035. * * Generated from protobuf field optional string name = 3373707; */ @@ -35,7 +36,8 @@ class NamedPort extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $name - * The name for this named port. The name must be 1-63 characters long, and comply with RFC1035. + * The name for this named port. + * The name must be 1-63 characters long, and comply withRFC1035. * @type int $port * The port number, which can be a value between 1 and 65535. * } @@ -46,7 +48,8 @@ public function __construct($data = NULL) { } /** - * The name for this named port. The name must be 1-63 characters long, and comply with RFC1035. + * The name for this named port. + * The name must be 1-63 characters long, and comply withRFC1035. * * Generated from protobuf field optional string name = 3373707; * @return string @@ -67,7 +70,8 @@ public function clearName() } /** - * The name for this named port. The name must be 1-63 characters long, and comply with RFC1035. + * The name for this named port. + * The name must be 1-63 characters long, and comply withRFC1035. * * Generated from protobuf field optional string name = 3373707; * @param string $var diff --git a/Compute/src/V1/NatIpInfoNatIpInfoMapping.php b/Compute/src/V1/NatIpInfoNatIpInfoMapping.php index e84758fc7d20..51f0be2d6d13 100644 --- a/Compute/src/V1/NatIpInfoNatIpInfoMapping.php +++ b/Compute/src/V1/NatIpInfoNatIpInfoMapping.php @@ -29,7 +29,8 @@ class NatIpInfoNatIpInfoMapping extends \Google\Protobuf\Internal\Message */ protected $nat_ip = null; /** - * Specifies whether NAT IP is currently serving at least one endpoint or not. + * Specifies whether NAT IP is currently serving at least one endpoint or + * not. * Check the Usage enum for the list of possible values. * * Generated from protobuf field optional string usage = 111574433; @@ -48,7 +49,8 @@ class NatIpInfoNatIpInfoMapping extends \Google\Protobuf\Internal\Message * @type string $nat_ip * NAT IP address. For example: 203.0.113.11. * @type string $usage - * Specifies whether NAT IP is currently serving at least one endpoint or not. + * Specifies whether NAT IP is currently serving at least one endpoint or + * not. * Check the Usage enum for the list of possible values. * } */ @@ -132,7 +134,8 @@ public function setNatIp($var) } /** - * Specifies whether NAT IP is currently serving at least one endpoint or not. + * Specifies whether NAT IP is currently serving at least one endpoint or + * not. * Check the Usage enum for the list of possible values. * * Generated from protobuf field optional string usage = 111574433; @@ -154,7 +157,8 @@ public function clearUsage() } /** - * Specifies whether NAT IP is currently serving at least one endpoint or not. + * Specifies whether NAT IP is currently serving at least one endpoint or + * not. * Check the Usage enum for the list of possible values. * * Generated from protobuf field optional string usage = 111574433; diff --git a/Compute/src/V1/NatIpInfoNatIpInfoMapping/Usage.php b/Compute/src/V1/NatIpInfoNatIpInfoMapping/Usage.php index ac97a2f10a2c..c721aa4e1ffe 100644 --- a/Compute/src/V1/NatIpInfoNatIpInfoMapping/Usage.php +++ b/Compute/src/V1/NatIpInfoNatIpInfoMapping/Usage.php @@ -7,7 +7,8 @@ use UnexpectedValueException; /** - * Specifies whether NAT IP is currently serving at least one endpoint or not. + * Specifies whether NAT IP is currently serving at least one endpoint or + * not. * * Protobuf type google.cloud.compute.v1.NatIpInfoNatIpInfoMapping.Usage */ diff --git a/Compute/src/V1/Network.php b/Compute/src/V1/Network.php index 11e739f1c5a8..bec45e1d938f 100644 --- a/Compute/src/V1/Network.php +++ b/Compute/src/V1/Network.php @@ -9,38 +9,54 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Represents a VPC Network resource. Networks connect resources to each other and to the internet. For more information, read Virtual Private Cloud (VPC) Network. + * Represents a VPC Network resource. + * Networks connect resources to each other and to the internet. For more + * information, readVirtual Private Cloud (VPC) Network. * * Generated from protobuf message google.cloud.compute.v1.Network */ class Network extends \Google\Protobuf\Internal\Message { /** - * Deprecated in favor of subnet mode networks. The range of internal addresses that are legal on this network. This range is a CIDR specification, for example: 192.168.0.0/16. Provided by the client when the network is created. + * Deprecated in favor of subnet mode networks. + * The range of internal addresses that are legal on this network. This + * range is aCIDR specification, for example:192.168.0.0/16. Provided by the client when the network is + * created. * * Generated from protobuf field optional string I_pv4_range = 59234358; */ protected $I_pv4_range = null; /** - * Must be set to create a VPC network. If not set, a legacy network is created. When set to true, the VPC network is created in auto mode. When set to false, the VPC network is created in custom mode. An auto mode VPC network starts with one subnet per region. Each subnet has a predetermined range as described in Auto mode VPC network IP ranges. For custom mode VPC networks, you can add subnets using the subnetworks insert method. + * Must be set to create a VPC network. If not set, a legacy network is + * created. + * When set to true, the VPC network is created in auto mode. + * When set to false, the VPC network is created in custom mode. + * An auto mode VPC network starts with one subnet per region. Each subnet + * has a predetermined range as described inAuto mode VPC network IP ranges. + * For custom mode VPC networks, you can add subnets using the subnetworksinsert + * method. * * Generated from protobuf field optional bool auto_create_subnetworks = 256156690; */ protected $auto_create_subnetworks = null; /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; */ protected $creation_timestamp = null; /** - * An optional description of this resource. Provide this field when you create the resource. + * An optional description of this resource. Provide this field when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; */ protected $description = null; /** - * Enable ULA internal ipv6 on this network. Enabling this feature will assign a /48 from google defined ULA prefix fd20::/20. . + * Enable ULA internal ipv6 on this network. Enabling this feature will assign + * a /48 from google defined ULA prefix fd20::/20. + * . * * Generated from protobuf field optional bool enable_ula_internal_ipv6 = 423757720; */ @@ -52,56 +68,82 @@ class Network extends \Google\Protobuf\Internal\Message */ protected $firewall_policy = null; /** - * [Output Only] The gateway address for default routing out of the network, selected by Google Cloud. + * [Output Only] The gateway address for default routing out of the network, + * selected by Google Cloud. * * Generated from protobuf field optional string gateway_i_pv4 = 178678877; */ protected $gateway_i_pv4 = null; /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; */ protected $id = null; /** - * When enabling ula internal ipv6, caller optionally can specify the /48 range they want from the google defined ULA prefix fd20::/20. The input must be a valid /48 ULA IPv6 address and must be within the fd20::/20. Operation will fail if the speficied /48 is already in used by another resource. If the field is not speficied, then a /48 range will be randomly allocated from fd20::/20 and returned via this field. . + * When enabling ula internal ipv6, caller optionally can specify the /48 + * range they want from the google defined ULA prefix fd20::/20. The input + * must be a valid /48 ULA IPv6 address and must be within the fd20::/20. + * Operation will fail if the speficied /48 is already in used by another + * resource. If the field is not speficied, then a /48 range will be randomly + * allocated from fd20::/20 and returned via this field. + * . * * Generated from protobuf field optional string internal_ipv6_range = 277456807; */ protected $internal_ipv6_range = null; /** - * [Output Only] Type of the resource. Always compute#network for networks. + * [Output Only] Type of the resource. Always compute#network for + * networks. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * Maximum Transmission Unit in bytes. The minimum value for this field is 1300 and the maximum value is 8896. The suggested value is 1500, which is the default MTU used on the Internet, or 8896 if you want to use Jumbo frames. If unspecified, the value defaults to 1460. + * Maximum Transmission Unit in bytes. + * The minimum value for this field is 1300 and the maximum value is 8896. + * The suggested value is 1500, which is the default MTU used on the + * Internet, or 8896 if you want to use Jumbo frames. If unspecified, the + * value defaults to 1460. * * Generated from protobuf field optional int32 mtu = 108462; */ protected $mtu = null; /** - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?`. The first character must be a lowercase letter, and all following characters (except for the last character) must be a dash, lowercase letter, or digit. The last character must be a lowercase letter or digit. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?`. The first character must be a + * lowercase letter, and all following characters (except for the last + * character) must be a dash, lowercase letter, or digit. The last character + * must be a lowercase letter or digit. * * Generated from protobuf field optional string name = 3373707; */ protected $name = null; /** - * The network firewall policy enforcement order. Can be either AFTER_CLASSIC_FIREWALL or BEFORE_CLASSIC_FIREWALL. Defaults to AFTER_CLASSIC_FIREWALL if the field is not specified. + * The network firewall policy enforcement order. Can be either + * AFTER_CLASSIC_FIREWALL or BEFORE_CLASSIC_FIREWALL. Defaults to + * AFTER_CLASSIC_FIREWALL if the field is not specified. * Check the NetworkFirewallPolicyEnforcementOrder enum for the list of possible values. * * Generated from protobuf field optional string network_firewall_policy_enforcement_order = 6504784; */ protected $network_firewall_policy_enforcement_order = null; /** - * A full or partial URL of the network profile to apply to this network. This field can be set only at resource creation time. For example, the following are valid URLs: - https://www.googleapis.com/compute/{api_version}/projects/{project_id}/global/networkProfiles/{network_profile_name} - projects/{project_id}/global/networkProfiles/{network_profile_name} + * A full or partial URL of the network profile to apply to this network. + * This field can be set only at resource creation time. For example, the + * following are valid URLs: + * - https://www.googleapis.com/compute/{api_version}/projects/{project_id}/global/networkProfiles/{network_profile_name} + * - projects/{project_id}/global/networkProfiles/{network_profile_name} * * Generated from protobuf field optional string network_profile = 173112472; */ protected $network_profile = null; /** - * Input only. [Input Only] Additional params passed with the request, but not persisted as part of resource payload. + * Input only. [Input Only] Additional params passed with the request, but not persisted + * as part of resource payload. * * Generated from protobuf field optional .google.cloud.compute.v1.NetworkParams params = 78313862; */ @@ -113,7 +155,8 @@ class Network extends \Google\Protobuf\Internal\Message */ private $peerings; /** - * The network-level routing configuration for this network. Used by Cloud Router to determine what type of network-wide routing behavior to enforce. + * The network-level routing configuration for this network. Used by Cloud + * Router to determine what type of network-wide routing behavior to enforce. * * Generated from protobuf field optional .google.cloud.compute.v1.NetworkRoutingConfig routing_config = 523556059; */ @@ -131,7 +174,8 @@ class Network extends \Google\Protobuf\Internal\Message */ protected $self_link_with_id = null; /** - * [Output Only] Server-defined fully-qualified URLs for all subnetworks in this VPC network. + * [Output Only] Server-defined fully-qualified URLs for all subnetworks + * in this VPC network. * * Generated from protobuf field repeated string subnetworks = 415853125; */ @@ -144,46 +188,88 @@ class Network extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $I_pv4_range - * Deprecated in favor of subnet mode networks. The range of internal addresses that are legal on this network. This range is a CIDR specification, for example: 192.168.0.0/16. Provided by the client when the network is created. + * Deprecated in favor of subnet mode networks. + * The range of internal addresses that are legal on this network. This + * range is aCIDR specification, for example:192.168.0.0/16. Provided by the client when the network is + * created. * @type bool $auto_create_subnetworks - * Must be set to create a VPC network. If not set, a legacy network is created. When set to true, the VPC network is created in auto mode. When set to false, the VPC network is created in custom mode. An auto mode VPC network starts with one subnet per region. Each subnet has a predetermined range as described in Auto mode VPC network IP ranges. For custom mode VPC networks, you can add subnets using the subnetworks insert method. + * Must be set to create a VPC network. If not set, a legacy network is + * created. + * When set to true, the VPC network is created in auto mode. + * When set to false, the VPC network is created in custom mode. + * An auto mode VPC network starts with one subnet per region. Each subnet + * has a predetermined range as described inAuto mode VPC network IP ranges. + * For custom mode VPC networks, you can add subnets using the subnetworksinsert + * method. * @type string $creation_timestamp - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * @type string $description - * An optional description of this resource. Provide this field when you create the resource. + * An optional description of this resource. Provide this field when you + * create the resource. * @type bool $enable_ula_internal_ipv6 - * Enable ULA internal ipv6 on this network. Enabling this feature will assign a /48 from google defined ULA prefix fd20::/20. . + * Enable ULA internal ipv6 on this network. Enabling this feature will assign + * a /48 from google defined ULA prefix fd20::/20. + * . * @type string $firewall_policy * [Output Only] URL of the firewall policy the network is associated with. * @type string $gateway_i_pv4 - * [Output Only] The gateway address for default routing out of the network, selected by Google Cloud. + * [Output Only] The gateway address for default routing out of the network, + * selected by Google Cloud. * @type int|string $id - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * @type string $internal_ipv6_range - * When enabling ula internal ipv6, caller optionally can specify the /48 range they want from the google defined ULA prefix fd20::/20. The input must be a valid /48 ULA IPv6 address and must be within the fd20::/20. Operation will fail if the speficied /48 is already in used by another resource. If the field is not speficied, then a /48 range will be randomly allocated from fd20::/20 and returned via this field. . + * When enabling ula internal ipv6, caller optionally can specify the /48 + * range they want from the google defined ULA prefix fd20::/20. The input + * must be a valid /48 ULA IPv6 address and must be within the fd20::/20. + * Operation will fail if the speficied /48 is already in used by another + * resource. If the field is not speficied, then a /48 range will be randomly + * allocated from fd20::/20 and returned via this field. + * . * @type string $kind - * [Output Only] Type of the resource. Always compute#network for networks. + * [Output Only] Type of the resource. Always compute#network for + * networks. * @type int $mtu - * Maximum Transmission Unit in bytes. The minimum value for this field is 1300 and the maximum value is 8896. The suggested value is 1500, which is the default MTU used on the Internet, or 8896 if you want to use Jumbo frames. If unspecified, the value defaults to 1460. + * Maximum Transmission Unit in bytes. + * The minimum value for this field is 1300 and the maximum value is 8896. + * The suggested value is 1500, which is the default MTU used on the + * Internet, or 8896 if you want to use Jumbo frames. If unspecified, the + * value defaults to 1460. * @type string $name - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?`. The first character must be a lowercase letter, and all following characters (except for the last character) must be a dash, lowercase letter, or digit. The last character must be a lowercase letter or digit. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?`. The first character must be a + * lowercase letter, and all following characters (except for the last + * character) must be a dash, lowercase letter, or digit. The last character + * must be a lowercase letter or digit. * @type string $network_firewall_policy_enforcement_order - * The network firewall policy enforcement order. Can be either AFTER_CLASSIC_FIREWALL or BEFORE_CLASSIC_FIREWALL. Defaults to AFTER_CLASSIC_FIREWALL if the field is not specified. + * The network firewall policy enforcement order. Can be either + * AFTER_CLASSIC_FIREWALL or BEFORE_CLASSIC_FIREWALL. Defaults to + * AFTER_CLASSIC_FIREWALL if the field is not specified. * Check the NetworkFirewallPolicyEnforcementOrder enum for the list of possible values. * @type string $network_profile - * A full or partial URL of the network profile to apply to this network. This field can be set only at resource creation time. For example, the following are valid URLs: - https://www.googleapis.com/compute/{api_version}/projects/{project_id}/global/networkProfiles/{network_profile_name} - projects/{project_id}/global/networkProfiles/{network_profile_name} + * A full or partial URL of the network profile to apply to this network. + * This field can be set only at resource creation time. For example, the + * following are valid URLs: + * - https://www.googleapis.com/compute/{api_version}/projects/{project_id}/global/networkProfiles/{network_profile_name} + * - projects/{project_id}/global/networkProfiles/{network_profile_name} * @type \Google\Cloud\Compute\V1\NetworkParams $params - * Input only. [Input Only] Additional params passed with the request, but not persisted as part of resource payload. + * Input only. [Input Only] Additional params passed with the request, but not persisted + * as part of resource payload. * @type array<\Google\Cloud\Compute\V1\NetworkPeering>|\Google\Protobuf\Internal\RepeatedField $peerings * [Output Only] A list of network peerings for the resource. * @type \Google\Cloud\Compute\V1\NetworkRoutingConfig $routing_config - * The network-level routing configuration for this network. Used by Cloud Router to determine what type of network-wide routing behavior to enforce. + * The network-level routing configuration for this network. Used by Cloud + * Router to determine what type of network-wide routing behavior to enforce. * @type string $self_link * [Output Only] Server-defined URL for the resource. * @type string $self_link_with_id * [Output Only] Server-defined URL for this resource with the resource id. * @type array|\Google\Protobuf\Internal\RepeatedField $subnetworks - * [Output Only] Server-defined fully-qualified URLs for all subnetworks in this VPC network. + * [Output Only] Server-defined fully-qualified URLs for all subnetworks + * in this VPC network. * } */ public function __construct($data = NULL) { @@ -192,7 +278,10 @@ public function __construct($data = NULL) { } /** - * Deprecated in favor of subnet mode networks. The range of internal addresses that are legal on this network. This range is a CIDR specification, for example: 192.168.0.0/16. Provided by the client when the network is created. + * Deprecated in favor of subnet mode networks. + * The range of internal addresses that are legal on this network. This + * range is aCIDR specification, for example:192.168.0.0/16. Provided by the client when the network is + * created. * * Generated from protobuf field optional string I_pv4_range = 59234358; * @return string @@ -213,7 +302,10 @@ public function clearIPv4Range() } /** - * Deprecated in favor of subnet mode networks. The range of internal addresses that are legal on this network. This range is a CIDR specification, for example: 192.168.0.0/16. Provided by the client when the network is created. + * Deprecated in favor of subnet mode networks. + * The range of internal addresses that are legal on this network. This + * range is aCIDR specification, for example:192.168.0.0/16. Provided by the client when the network is + * created. * * Generated from protobuf field optional string I_pv4_range = 59234358; * @param string $var @@ -228,7 +320,14 @@ public function setIPv4Range($var) } /** - * Must be set to create a VPC network. If not set, a legacy network is created. When set to true, the VPC network is created in auto mode. When set to false, the VPC network is created in custom mode. An auto mode VPC network starts with one subnet per region. Each subnet has a predetermined range as described in Auto mode VPC network IP ranges. For custom mode VPC networks, you can add subnets using the subnetworks insert method. + * Must be set to create a VPC network. If not set, a legacy network is + * created. + * When set to true, the VPC network is created in auto mode. + * When set to false, the VPC network is created in custom mode. + * An auto mode VPC network starts with one subnet per region. Each subnet + * has a predetermined range as described inAuto mode VPC network IP ranges. + * For custom mode VPC networks, you can add subnets using the subnetworksinsert + * method. * * Generated from protobuf field optional bool auto_create_subnetworks = 256156690; * @return bool @@ -249,7 +348,14 @@ public function clearAutoCreateSubnetworks() } /** - * Must be set to create a VPC network. If not set, a legacy network is created. When set to true, the VPC network is created in auto mode. When set to false, the VPC network is created in custom mode. An auto mode VPC network starts with one subnet per region. Each subnet has a predetermined range as described in Auto mode VPC network IP ranges. For custom mode VPC networks, you can add subnets using the subnetworks insert method. + * Must be set to create a VPC network. If not set, a legacy network is + * created. + * When set to true, the VPC network is created in auto mode. + * When set to false, the VPC network is created in custom mode. + * An auto mode VPC network starts with one subnet per region. Each subnet + * has a predetermined range as described inAuto mode VPC network IP ranges. + * For custom mode VPC networks, you can add subnets using the subnetworksinsert + * method. * * Generated from protobuf field optional bool auto_create_subnetworks = 256156690; * @param bool $var @@ -264,7 +370,8 @@ public function setAutoCreateSubnetworks($var) } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @return string @@ -285,7 +392,8 @@ public function clearCreationTimestamp() } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @param string $var @@ -300,7 +408,8 @@ public function setCreationTimestamp($var) } /** - * An optional description of this resource. Provide this field when you create the resource. + * An optional description of this resource. Provide this field when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @return string @@ -321,7 +430,8 @@ public function clearDescription() } /** - * An optional description of this resource. Provide this field when you create the resource. + * An optional description of this resource. Provide this field when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @param string $var @@ -336,7 +446,9 @@ public function setDescription($var) } /** - * Enable ULA internal ipv6 on this network. Enabling this feature will assign a /48 from google defined ULA prefix fd20::/20. . + * Enable ULA internal ipv6 on this network. Enabling this feature will assign + * a /48 from google defined ULA prefix fd20::/20. + * . * * Generated from protobuf field optional bool enable_ula_internal_ipv6 = 423757720; * @return bool @@ -357,7 +469,9 @@ public function clearEnableUlaInternalIpv6() } /** - * Enable ULA internal ipv6 on this network. Enabling this feature will assign a /48 from google defined ULA prefix fd20::/20. . + * Enable ULA internal ipv6 on this network. Enabling this feature will assign + * a /48 from google defined ULA prefix fd20::/20. + * . * * Generated from protobuf field optional bool enable_ula_internal_ipv6 = 423757720; * @param bool $var @@ -408,7 +522,8 @@ public function setFirewallPolicy($var) } /** - * [Output Only] The gateway address for default routing out of the network, selected by Google Cloud. + * [Output Only] The gateway address for default routing out of the network, + * selected by Google Cloud. * * Generated from protobuf field optional string gateway_i_pv4 = 178678877; * @return string @@ -429,7 +544,8 @@ public function clearGatewayIPv4() } /** - * [Output Only] The gateway address for default routing out of the network, selected by Google Cloud. + * [Output Only] The gateway address for default routing out of the network, + * selected by Google Cloud. * * Generated from protobuf field optional string gateway_i_pv4 = 178678877; * @param string $var @@ -444,7 +560,8 @@ public function setGatewayIPv4($var) } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @return int|string @@ -465,7 +582,8 @@ public function clearId() } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @param int|string $var @@ -480,7 +598,13 @@ public function setId($var) } /** - * When enabling ula internal ipv6, caller optionally can specify the /48 range they want from the google defined ULA prefix fd20::/20. The input must be a valid /48 ULA IPv6 address and must be within the fd20::/20. Operation will fail if the speficied /48 is already in used by another resource. If the field is not speficied, then a /48 range will be randomly allocated from fd20::/20 and returned via this field. . + * When enabling ula internal ipv6, caller optionally can specify the /48 + * range they want from the google defined ULA prefix fd20::/20. The input + * must be a valid /48 ULA IPv6 address and must be within the fd20::/20. + * Operation will fail if the speficied /48 is already in used by another + * resource. If the field is not speficied, then a /48 range will be randomly + * allocated from fd20::/20 and returned via this field. + * . * * Generated from protobuf field optional string internal_ipv6_range = 277456807; * @return string @@ -501,7 +625,13 @@ public function clearInternalIpv6Range() } /** - * When enabling ula internal ipv6, caller optionally can specify the /48 range they want from the google defined ULA prefix fd20::/20. The input must be a valid /48 ULA IPv6 address and must be within the fd20::/20. Operation will fail if the speficied /48 is already in used by another resource. If the field is not speficied, then a /48 range will be randomly allocated from fd20::/20 and returned via this field. . + * When enabling ula internal ipv6, caller optionally can specify the /48 + * range they want from the google defined ULA prefix fd20::/20. The input + * must be a valid /48 ULA IPv6 address and must be within the fd20::/20. + * Operation will fail if the speficied /48 is already in used by another + * resource. If the field is not speficied, then a /48 range will be randomly + * allocated from fd20::/20 and returned via this field. + * . * * Generated from protobuf field optional string internal_ipv6_range = 277456807; * @param string $var @@ -516,7 +646,8 @@ public function setInternalIpv6Range($var) } /** - * [Output Only] Type of the resource. Always compute#network for networks. + * [Output Only] Type of the resource. Always compute#network for + * networks. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -537,7 +668,8 @@ public function clearKind() } /** - * [Output Only] Type of the resource. Always compute#network for networks. + * [Output Only] Type of the resource. Always compute#network for + * networks. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -552,7 +684,11 @@ public function setKind($var) } /** - * Maximum Transmission Unit in bytes. The minimum value for this field is 1300 and the maximum value is 8896. The suggested value is 1500, which is the default MTU used on the Internet, or 8896 if you want to use Jumbo frames. If unspecified, the value defaults to 1460. + * Maximum Transmission Unit in bytes. + * The minimum value for this field is 1300 and the maximum value is 8896. + * The suggested value is 1500, which is the default MTU used on the + * Internet, or 8896 if you want to use Jumbo frames. If unspecified, the + * value defaults to 1460. * * Generated from protobuf field optional int32 mtu = 108462; * @return int @@ -573,7 +709,11 @@ public function clearMtu() } /** - * Maximum Transmission Unit in bytes. The minimum value for this field is 1300 and the maximum value is 8896. The suggested value is 1500, which is the default MTU used on the Internet, or 8896 if you want to use Jumbo frames. If unspecified, the value defaults to 1460. + * Maximum Transmission Unit in bytes. + * The minimum value for this field is 1300 and the maximum value is 8896. + * The suggested value is 1500, which is the default MTU used on the + * Internet, or 8896 if you want to use Jumbo frames. If unspecified, the + * value defaults to 1460. * * Generated from protobuf field optional int32 mtu = 108462; * @param int $var @@ -588,7 +728,13 @@ public function setMtu($var) } /** - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?`. The first character must be a lowercase letter, and all following characters (except for the last character) must be a dash, lowercase letter, or digit. The last character must be a lowercase letter or digit. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?`. The first character must be a + * lowercase letter, and all following characters (except for the last + * character) must be a dash, lowercase letter, or digit. The last character + * must be a lowercase letter or digit. * * Generated from protobuf field optional string name = 3373707; * @return string @@ -609,7 +755,13 @@ public function clearName() } /** - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?`. The first character must be a lowercase letter, and all following characters (except for the last character) must be a dash, lowercase letter, or digit. The last character must be a lowercase letter or digit. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?`. The first character must be a + * lowercase letter, and all following characters (except for the last + * character) must be a dash, lowercase letter, or digit. The last character + * must be a lowercase letter or digit. * * Generated from protobuf field optional string name = 3373707; * @param string $var @@ -624,7 +776,9 @@ public function setName($var) } /** - * The network firewall policy enforcement order. Can be either AFTER_CLASSIC_FIREWALL or BEFORE_CLASSIC_FIREWALL. Defaults to AFTER_CLASSIC_FIREWALL if the field is not specified. + * The network firewall policy enforcement order. Can be either + * AFTER_CLASSIC_FIREWALL or BEFORE_CLASSIC_FIREWALL. Defaults to + * AFTER_CLASSIC_FIREWALL if the field is not specified. * Check the NetworkFirewallPolicyEnforcementOrder enum for the list of possible values. * * Generated from protobuf field optional string network_firewall_policy_enforcement_order = 6504784; @@ -646,7 +800,9 @@ public function clearNetworkFirewallPolicyEnforcementOrder() } /** - * The network firewall policy enforcement order. Can be either AFTER_CLASSIC_FIREWALL or BEFORE_CLASSIC_FIREWALL. Defaults to AFTER_CLASSIC_FIREWALL if the field is not specified. + * The network firewall policy enforcement order. Can be either + * AFTER_CLASSIC_FIREWALL or BEFORE_CLASSIC_FIREWALL. Defaults to + * AFTER_CLASSIC_FIREWALL if the field is not specified. * Check the NetworkFirewallPolicyEnforcementOrder enum for the list of possible values. * * Generated from protobuf field optional string network_firewall_policy_enforcement_order = 6504784; @@ -662,7 +818,11 @@ public function setNetworkFirewallPolicyEnforcementOrder($var) } /** - * A full or partial URL of the network profile to apply to this network. This field can be set only at resource creation time. For example, the following are valid URLs: - https://www.googleapis.com/compute/{api_version}/projects/{project_id}/global/networkProfiles/{network_profile_name} - projects/{project_id}/global/networkProfiles/{network_profile_name} + * A full or partial URL of the network profile to apply to this network. + * This field can be set only at resource creation time. For example, the + * following are valid URLs: + * - https://www.googleapis.com/compute/{api_version}/projects/{project_id}/global/networkProfiles/{network_profile_name} + * - projects/{project_id}/global/networkProfiles/{network_profile_name} * * Generated from protobuf field optional string network_profile = 173112472; * @return string @@ -683,7 +843,11 @@ public function clearNetworkProfile() } /** - * A full or partial URL of the network profile to apply to this network. This field can be set only at resource creation time. For example, the following are valid URLs: - https://www.googleapis.com/compute/{api_version}/projects/{project_id}/global/networkProfiles/{network_profile_name} - projects/{project_id}/global/networkProfiles/{network_profile_name} + * A full or partial URL of the network profile to apply to this network. + * This field can be set only at resource creation time. For example, the + * following are valid URLs: + * - https://www.googleapis.com/compute/{api_version}/projects/{project_id}/global/networkProfiles/{network_profile_name} + * - projects/{project_id}/global/networkProfiles/{network_profile_name} * * Generated from protobuf field optional string network_profile = 173112472; * @param string $var @@ -698,7 +862,8 @@ public function setNetworkProfile($var) } /** - * Input only. [Input Only] Additional params passed with the request, but not persisted as part of resource payload. + * Input only. [Input Only] Additional params passed with the request, but not persisted + * as part of resource payload. * * Generated from protobuf field optional .google.cloud.compute.v1.NetworkParams params = 78313862; * @return \Google\Cloud\Compute\V1\NetworkParams|null @@ -719,7 +884,8 @@ public function clearParams() } /** - * Input only. [Input Only] Additional params passed with the request, but not persisted as part of resource payload. + * Input only. [Input Only] Additional params passed with the request, but not persisted + * as part of resource payload. * * Generated from protobuf field optional .google.cloud.compute.v1.NetworkParams params = 78313862; * @param \Google\Cloud\Compute\V1\NetworkParams $var @@ -760,7 +926,8 @@ public function setPeerings($var) } /** - * The network-level routing configuration for this network. Used by Cloud Router to determine what type of network-wide routing behavior to enforce. + * The network-level routing configuration for this network. Used by Cloud + * Router to determine what type of network-wide routing behavior to enforce. * * Generated from protobuf field optional .google.cloud.compute.v1.NetworkRoutingConfig routing_config = 523556059; * @return \Google\Cloud\Compute\V1\NetworkRoutingConfig|null @@ -781,7 +948,8 @@ public function clearRoutingConfig() } /** - * The network-level routing configuration for this network. Used by Cloud Router to determine what type of network-wide routing behavior to enforce. + * The network-level routing configuration for this network. Used by Cloud + * Router to determine what type of network-wide routing behavior to enforce. * * Generated from protobuf field optional .google.cloud.compute.v1.NetworkRoutingConfig routing_config = 523556059; * @param \Google\Cloud\Compute\V1\NetworkRoutingConfig $var @@ -868,7 +1036,8 @@ public function setSelfLinkWithId($var) } /** - * [Output Only] Server-defined fully-qualified URLs for all subnetworks in this VPC network. + * [Output Only] Server-defined fully-qualified URLs for all subnetworks + * in this VPC network. * * Generated from protobuf field repeated string subnetworks = 415853125; * @return \Google\Protobuf\Internal\RepeatedField @@ -879,7 +1048,8 @@ public function getSubnetworks() } /** - * [Output Only] Server-defined fully-qualified URLs for all subnetworks in this VPC network. + * [Output Only] Server-defined fully-qualified URLs for all subnetworks + * in this VPC network. * * Generated from protobuf field repeated string subnetworks = 415853125; * @param array|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/Network/NetworkFirewallPolicyEnforcementOrder.php b/Compute/src/V1/Network/NetworkFirewallPolicyEnforcementOrder.php index a897627a004b..57d5d2802bb6 100644 --- a/Compute/src/V1/Network/NetworkFirewallPolicyEnforcementOrder.php +++ b/Compute/src/V1/Network/NetworkFirewallPolicyEnforcementOrder.php @@ -7,7 +7,9 @@ use UnexpectedValueException; /** - * The network firewall policy enforcement order. Can be either AFTER_CLASSIC_FIREWALL or BEFORE_CLASSIC_FIREWALL. Defaults to AFTER_CLASSIC_FIREWALL if the field is not specified. + * The network firewall policy enforcement order. Can be either + * AFTER_CLASSIC_FIREWALL or BEFORE_CLASSIC_FIREWALL. Defaults to + * AFTER_CLASSIC_FIREWALL if the field is not specified. * * Protobuf type google.cloud.compute.v1.Network.NetworkFirewallPolicyEnforcementOrder */ diff --git a/Compute/src/V1/NetworkAttachment.php b/Compute/src/V1/NetworkAttachment.php index 67a1016c2573..796b0481302e 100644 --- a/Compute/src/V1/NetworkAttachment.php +++ b/Compute/src/V1/NetworkAttachment.php @@ -9,14 +9,16 @@ use Google\Protobuf\Internal\GPBUtil; /** - * NetworkAttachments A network attachment resource ... + * NetworkAttachments + * A network attachment resource ... * * Generated from protobuf message google.cloud.compute.v1.NetworkAttachment */ class NetworkAttachment extends \Google\Protobuf\Internal\Message { /** - * [Output Only] An array of connections for all the producers connected to this network attachment. + * [Output Only] An array of connections for all the producers connected + * to this network attachment. * * Generated from protobuf field repeated .google.cloud.compute.v1.NetworkAttachmentConnectedEndpoint connection_endpoints = 326078813; */ @@ -29,25 +31,30 @@ class NetworkAttachment extends \Google\Protobuf\Internal\Message */ protected $connection_preference = null; /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; */ protected $creation_timestamp = null; /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; */ protected $description = null; /** - * Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking. An up-to-date fingerprint must be provided in order to patch. + * Fingerprint of this resource. A hash of the contents stored + * in this object. This field is used in optimistic locking. An up-to-date + * fingerprint must be provided in order to patch. * * Generated from protobuf field optional string fingerprint = 234678500; */ protected $fingerprint = null; /** - * [Output Only] The unique identifier for the resource type. The server generates this identifier. + * [Output Only] The unique identifier for the resource type. The server + * generates this identifier. * * Generated from protobuf field optional uint64 id = 3355; */ @@ -59,31 +66,46 @@ class NetworkAttachment extends \Google\Protobuf\Internal\Message */ protected $kind = null; /** - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * * Generated from protobuf field optional string name = 3373707; */ protected $name = null; /** - * [Output Only] The URL of the network which the Network Attachment belongs to. Practically it is inferred by fetching the network of the first subnetwork associated. Because it is required that all the subnetworks must be from the same network, it is assured that the Network Attachment belongs to the same network as all the subnetworks. + * [Output Only] The URL of the network which the Network Attachment + * belongs to. Practically it is inferred by fetching the network of the first + * subnetwork associated. Because it is required that all the subnetworks must + * be from the same network, it is assured that the Network Attachment belongs + * to the same network as all the subnetworks. * * Generated from protobuf field optional string network = 232872494; */ protected $network = null; /** - * Projects that are allowed to connect to this network attachment. The project can be specified using its id or number. + * Projects that are allowed to connect to this network attachment. + * The project can be specified using its id or number. * * Generated from protobuf field repeated string producer_accept_lists = 202804523; */ private $producer_accept_lists; /** - * Projects that are not allowed to connect to this network attachment. The project can be specified using its id or number. + * Projects that are not allowed to connect to this network attachment. + * The project can be specified using its id or number. * * Generated from protobuf field repeated string producer_reject_lists = 4112002; */ private $producer_reject_lists; /** - * [Output Only] URL of the region where the network attachment resides. This field applies only to the region resource. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * [Output Only] URL of the region where the network attachment resides. + * This field applies only to the region resource. You must specify this + * field as part of the HTTP request URL. It is not settable as a field in + * the request body. * * Generated from protobuf field optional string region = 138946292; */ @@ -101,7 +123,9 @@ class NetworkAttachment extends \Google\Protobuf\Internal\Message */ protected $self_link_with_id = null; /** - * An array of URLs where each entry is the URL of a subnet provided by the service consumer to use for endpoints in the producers that connect to this network attachment. + * An array of URLs where each entry is the URL of a subnet + * provided by the service consumer to use for + * endpoints in the producers that connect to this network attachment. * * Generated from protobuf field repeated string subnetworks = 415853125; */ @@ -114,36 +138,59 @@ class NetworkAttachment extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type array<\Google\Cloud\Compute\V1\NetworkAttachmentConnectedEndpoint>|\Google\Protobuf\Internal\RepeatedField $connection_endpoints - * [Output Only] An array of connections for all the producers connected to this network attachment. + * [Output Only] An array of connections for all the producers connected + * to this network attachment. * @type string $connection_preference * * Check the ConnectionPreference enum for the list of possible values. * @type string $creation_timestamp - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * @type string $description - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * @type string $fingerprint - * Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking. An up-to-date fingerprint must be provided in order to patch. + * Fingerprint of this resource. A hash of the contents stored + * in this object. This field is used in optimistic locking. An up-to-date + * fingerprint must be provided in order to patch. * @type int|string $id - * [Output Only] The unique identifier for the resource type. The server generates this identifier. + * [Output Only] The unique identifier for the resource type. The server + * generates this identifier. * @type string $kind * [Output Only] Type of the resource. * @type string $name - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * @type string $network - * [Output Only] The URL of the network which the Network Attachment belongs to. Practically it is inferred by fetching the network of the first subnetwork associated. Because it is required that all the subnetworks must be from the same network, it is assured that the Network Attachment belongs to the same network as all the subnetworks. + * [Output Only] The URL of the network which the Network Attachment + * belongs to. Practically it is inferred by fetching the network of the first + * subnetwork associated. Because it is required that all the subnetworks must + * be from the same network, it is assured that the Network Attachment belongs + * to the same network as all the subnetworks. * @type array|\Google\Protobuf\Internal\RepeatedField $producer_accept_lists - * Projects that are allowed to connect to this network attachment. The project can be specified using its id or number. + * Projects that are allowed to connect to this network attachment. + * The project can be specified using its id or number. * @type array|\Google\Protobuf\Internal\RepeatedField $producer_reject_lists - * Projects that are not allowed to connect to this network attachment. The project can be specified using its id or number. + * Projects that are not allowed to connect to this network attachment. + * The project can be specified using its id or number. * @type string $region - * [Output Only] URL of the region where the network attachment resides. This field applies only to the region resource. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * [Output Only] URL of the region where the network attachment resides. + * This field applies only to the region resource. You must specify this + * field as part of the HTTP request URL. It is not settable as a field in + * the request body. * @type string $self_link * [Output Only] Server-defined URL for the resource. * @type string $self_link_with_id * [Output Only] Server-defined URL for this resource's resource id. * @type array|\Google\Protobuf\Internal\RepeatedField $subnetworks - * An array of URLs where each entry is the URL of a subnet provided by the service consumer to use for endpoints in the producers that connect to this network attachment. + * An array of URLs where each entry is the URL of a subnet + * provided by the service consumer to use for + * endpoints in the producers that connect to this network attachment. * } */ public function __construct($data = NULL) { @@ -152,7 +199,8 @@ public function __construct($data = NULL) { } /** - * [Output Only] An array of connections for all the producers connected to this network attachment. + * [Output Only] An array of connections for all the producers connected + * to this network attachment. * * Generated from protobuf field repeated .google.cloud.compute.v1.NetworkAttachmentConnectedEndpoint connection_endpoints = 326078813; * @return \Google\Protobuf\Internal\RepeatedField @@ -163,7 +211,8 @@ public function getConnectionEndpoints() } /** - * [Output Only] An array of connections for all the producers connected to this network attachment. + * [Output Only] An array of connections for all the producers connected + * to this network attachment. * * Generated from protobuf field repeated .google.cloud.compute.v1.NetworkAttachmentConnectedEndpoint connection_endpoints = 326078813; * @param array<\Google\Cloud\Compute\V1\NetworkAttachmentConnectedEndpoint>|\Google\Protobuf\Internal\RepeatedField $var @@ -216,7 +265,8 @@ public function setConnectionPreference($var) } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @return string @@ -237,7 +287,8 @@ public function clearCreationTimestamp() } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @param string $var @@ -252,7 +303,8 @@ public function setCreationTimestamp($var) } /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @return string @@ -273,7 +325,8 @@ public function clearDescription() } /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @param string $var @@ -288,7 +341,9 @@ public function setDescription($var) } /** - * Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking. An up-to-date fingerprint must be provided in order to patch. + * Fingerprint of this resource. A hash of the contents stored + * in this object. This field is used in optimistic locking. An up-to-date + * fingerprint must be provided in order to patch. * * Generated from protobuf field optional string fingerprint = 234678500; * @return string @@ -309,7 +364,9 @@ public function clearFingerprint() } /** - * Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking. An up-to-date fingerprint must be provided in order to patch. + * Fingerprint of this resource. A hash of the contents stored + * in this object. This field is used in optimistic locking. An up-to-date + * fingerprint must be provided in order to patch. * * Generated from protobuf field optional string fingerprint = 234678500; * @param string $var @@ -324,7 +381,8 @@ public function setFingerprint($var) } /** - * [Output Only] The unique identifier for the resource type. The server generates this identifier. + * [Output Only] The unique identifier for the resource type. The server + * generates this identifier. * * Generated from protobuf field optional uint64 id = 3355; * @return int|string @@ -345,7 +403,8 @@ public function clearId() } /** - * [Output Only] The unique identifier for the resource type. The server generates this identifier. + * [Output Only] The unique identifier for the resource type. The server + * generates this identifier. * * Generated from protobuf field optional uint64 id = 3355; * @param int|string $var @@ -396,7 +455,13 @@ public function setKind($var) } /** - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * * Generated from protobuf field optional string name = 3373707; * @return string @@ -417,7 +482,13 @@ public function clearName() } /** - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * * Generated from protobuf field optional string name = 3373707; * @param string $var @@ -432,7 +503,11 @@ public function setName($var) } /** - * [Output Only] The URL of the network which the Network Attachment belongs to. Practically it is inferred by fetching the network of the first subnetwork associated. Because it is required that all the subnetworks must be from the same network, it is assured that the Network Attachment belongs to the same network as all the subnetworks. + * [Output Only] The URL of the network which the Network Attachment + * belongs to. Practically it is inferred by fetching the network of the first + * subnetwork associated. Because it is required that all the subnetworks must + * be from the same network, it is assured that the Network Attachment belongs + * to the same network as all the subnetworks. * * Generated from protobuf field optional string network = 232872494; * @return string @@ -453,7 +528,11 @@ public function clearNetwork() } /** - * [Output Only] The URL of the network which the Network Attachment belongs to. Practically it is inferred by fetching the network of the first subnetwork associated. Because it is required that all the subnetworks must be from the same network, it is assured that the Network Attachment belongs to the same network as all the subnetworks. + * [Output Only] The URL of the network which the Network Attachment + * belongs to. Practically it is inferred by fetching the network of the first + * subnetwork associated. Because it is required that all the subnetworks must + * be from the same network, it is assured that the Network Attachment belongs + * to the same network as all the subnetworks. * * Generated from protobuf field optional string network = 232872494; * @param string $var @@ -468,7 +547,8 @@ public function setNetwork($var) } /** - * Projects that are allowed to connect to this network attachment. The project can be specified using its id or number. + * Projects that are allowed to connect to this network attachment. + * The project can be specified using its id or number. * * Generated from protobuf field repeated string producer_accept_lists = 202804523; * @return \Google\Protobuf\Internal\RepeatedField @@ -479,7 +559,8 @@ public function getProducerAcceptLists() } /** - * Projects that are allowed to connect to this network attachment. The project can be specified using its id or number. + * Projects that are allowed to connect to this network attachment. + * The project can be specified using its id or number. * * Generated from protobuf field repeated string producer_accept_lists = 202804523; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -494,7 +575,8 @@ public function setProducerAcceptLists($var) } /** - * Projects that are not allowed to connect to this network attachment. The project can be specified using its id or number. + * Projects that are not allowed to connect to this network attachment. + * The project can be specified using its id or number. * * Generated from protobuf field repeated string producer_reject_lists = 4112002; * @return \Google\Protobuf\Internal\RepeatedField @@ -505,7 +587,8 @@ public function getProducerRejectLists() } /** - * Projects that are not allowed to connect to this network attachment. The project can be specified using its id or number. + * Projects that are not allowed to connect to this network attachment. + * The project can be specified using its id or number. * * Generated from protobuf field repeated string producer_reject_lists = 4112002; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -520,7 +603,10 @@ public function setProducerRejectLists($var) } /** - * [Output Only] URL of the region where the network attachment resides. This field applies only to the region resource. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * [Output Only] URL of the region where the network attachment resides. + * This field applies only to the region resource. You must specify this + * field as part of the HTTP request URL. It is not settable as a field in + * the request body. * * Generated from protobuf field optional string region = 138946292; * @return string @@ -541,7 +627,10 @@ public function clearRegion() } /** - * [Output Only] URL of the region where the network attachment resides. This field applies only to the region resource. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * [Output Only] URL of the region where the network attachment resides. + * This field applies only to the region resource. You must specify this + * field as part of the HTTP request URL. It is not settable as a field in + * the request body. * * Generated from protobuf field optional string region = 138946292; * @param string $var @@ -628,7 +717,9 @@ public function setSelfLinkWithId($var) } /** - * An array of URLs where each entry is the URL of a subnet provided by the service consumer to use for endpoints in the producers that connect to this network attachment. + * An array of URLs where each entry is the URL of a subnet + * provided by the service consumer to use for + * endpoints in the producers that connect to this network attachment. * * Generated from protobuf field repeated string subnetworks = 415853125; * @return \Google\Protobuf\Internal\RepeatedField @@ -639,7 +730,9 @@ public function getSubnetworks() } /** - * An array of URLs where each entry is the URL of a subnet provided by the service consumer to use for endpoints in the producers that connect to this network attachment. + * An array of URLs where each entry is the URL of a subnet + * provided by the service consumer to use for + * endpoints in the producers that connect to this network attachment. * * Generated from protobuf field repeated string subnetworks = 415853125; * @param array|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/NetworkAttachmentAggregatedList.php b/Compute/src/V1/NetworkAttachmentAggregatedList.php index 8ccccad00faa..35bbf7f6f914 100644 --- a/Compute/src/V1/NetworkAttachmentAggregatedList.php +++ b/Compute/src/V1/NetworkAttachmentAggregatedList.php @@ -32,7 +32,11 @@ class NetworkAttachmentAggregatedList extends \Google\Protobuf\Internal\Message */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -62,7 +66,11 @@ class NetworkAttachmentAggregatedList extends \Google\Protobuf\Internal\Message * A list of NetworkAttachmentsScopedList resources. * @type string $kind * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type \Google\Cloud\Compute\V1\Warning $warning @@ -169,7 +177,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -190,7 +202,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/NetworkAttachmentConnectedEndpoint.php b/Compute/src/V1/NetworkAttachmentConnectedEndpoint.php index cb4a8dd6ae3b..b9f4e1916521 100644 --- a/Compute/src/V1/NetworkAttachmentConnectedEndpoint.php +++ b/Compute/src/V1/NetworkAttachmentConnectedEndpoint.php @@ -16,13 +16,16 @@ class NetworkAttachmentConnectedEndpoint extends \Google\Protobuf\Internal\Message { /** - * The IPv4 address assigned to the producer instance network interface. This value will be a range in case of Serverless. + * The IPv4 address assigned to the producer instance network interface. + * This value will be a range in case of Serverless. * * Generated from protobuf field optional string ip_address = 406272220; */ protected $ip_address = null; /** - * The IPv6 address assigned to the producer instance network interface. This is only assigned when the stack types of both the instance network interface and the consumer subnet are IPv4_IPv6. + * The IPv6 address assigned to the producer instance network interface. + * This is only assigned when the stack types of both the instance network + * interface and the consumer subnet are IPv4_IPv6. * * Generated from protobuf field optional string ipv6_address = 341563804; */ @@ -47,13 +50,15 @@ class NetworkAttachmentConnectedEndpoint extends \Google\Protobuf\Internal\Messa */ protected $status = null; /** - * The subnetwork used to assign the IP to the producer instance network interface. + * The subnetwork used to assign the IP to the producer + * instance network interface. * * Generated from protobuf field optional string subnetwork = 307827694; */ protected $subnetwork = null; /** - * [Output Only] The CIDR range of the subnet from which the IPv4 internal IP was allocated from. + * [Output Only] The CIDR range of the subnet from which the IPv4 internal + * IP was allocated from. * * Generated from protobuf field optional string subnetwork_cidr_range = 383249827; */ @@ -66,9 +71,12 @@ class NetworkAttachmentConnectedEndpoint extends \Google\Protobuf\Internal\Messa * Optional. Data for populating the Message object. * * @type string $ip_address - * The IPv4 address assigned to the producer instance network interface. This value will be a range in case of Serverless. + * The IPv4 address assigned to the producer instance network interface. + * This value will be a range in case of Serverless. * @type string $ipv6_address - * The IPv6 address assigned to the producer instance network interface. This is only assigned when the stack types of both the instance network interface and the consumer subnet are IPv4_IPv6. + * The IPv6 address assigned to the producer instance network interface. + * This is only assigned when the stack types of both the instance network + * interface and the consumer subnet are IPv4_IPv6. * @type string $project_id_or_num * The project id or number of the interface to which the IP was assigned. * @type array|\Google\Protobuf\Internal\RepeatedField $secondary_ip_cidr_ranges @@ -77,9 +85,11 @@ class NetworkAttachmentConnectedEndpoint extends \Google\Protobuf\Internal\Messa * The status of a connected endpoint to this network attachment. * Check the Status enum for the list of possible values. * @type string $subnetwork - * The subnetwork used to assign the IP to the producer instance network interface. + * The subnetwork used to assign the IP to the producer + * instance network interface. * @type string $subnetwork_cidr_range - * [Output Only] The CIDR range of the subnet from which the IPv4 internal IP was allocated from. + * [Output Only] The CIDR range of the subnet from which the IPv4 internal + * IP was allocated from. * } */ public function __construct($data = NULL) { @@ -88,7 +98,8 @@ public function __construct($data = NULL) { } /** - * The IPv4 address assigned to the producer instance network interface. This value will be a range in case of Serverless. + * The IPv4 address assigned to the producer instance network interface. + * This value will be a range in case of Serverless. * * Generated from protobuf field optional string ip_address = 406272220; * @return string @@ -109,7 +120,8 @@ public function clearIpAddress() } /** - * The IPv4 address assigned to the producer instance network interface. This value will be a range in case of Serverless. + * The IPv4 address assigned to the producer instance network interface. + * This value will be a range in case of Serverless. * * Generated from protobuf field optional string ip_address = 406272220; * @param string $var @@ -124,7 +136,9 @@ public function setIpAddress($var) } /** - * The IPv6 address assigned to the producer instance network interface. This is only assigned when the stack types of both the instance network interface and the consumer subnet are IPv4_IPv6. + * The IPv6 address assigned to the producer instance network interface. + * This is only assigned when the stack types of both the instance network + * interface and the consumer subnet are IPv4_IPv6. * * Generated from protobuf field optional string ipv6_address = 341563804; * @return string @@ -145,7 +159,9 @@ public function clearIpv6Address() } /** - * The IPv6 address assigned to the producer instance network interface. This is only assigned when the stack types of both the instance network interface and the consumer subnet are IPv4_IPv6. + * The IPv6 address assigned to the producer instance network interface. + * This is only assigned when the stack types of both the instance network + * interface and the consumer subnet are IPv4_IPv6. * * Generated from protobuf field optional string ipv6_address = 341563804; * @param string $var @@ -260,7 +276,8 @@ public function setStatus($var) } /** - * The subnetwork used to assign the IP to the producer instance network interface. + * The subnetwork used to assign the IP to the producer + * instance network interface. * * Generated from protobuf field optional string subnetwork = 307827694; * @return string @@ -281,7 +298,8 @@ public function clearSubnetwork() } /** - * The subnetwork used to assign the IP to the producer instance network interface. + * The subnetwork used to assign the IP to the producer + * instance network interface. * * Generated from protobuf field optional string subnetwork = 307827694; * @param string $var @@ -296,7 +314,8 @@ public function setSubnetwork($var) } /** - * [Output Only] The CIDR range of the subnet from which the IPv4 internal IP was allocated from. + * [Output Only] The CIDR range of the subnet from which the IPv4 internal + * IP was allocated from. * * Generated from protobuf field optional string subnetwork_cidr_range = 383249827; * @return string @@ -317,7 +336,8 @@ public function clearSubnetworkCidrRange() } /** - * [Output Only] The CIDR range of the subnet from which the IPv4 internal IP was allocated from. + * [Output Only] The CIDR range of the subnet from which the IPv4 internal + * IP was allocated from. * * Generated from protobuf field optional string subnetwork_cidr_range = 383249827; * @param string $var diff --git a/Compute/src/V1/NetworkAttachmentConnectedEndpoint/Status.php b/Compute/src/V1/NetworkAttachmentConnectedEndpoint/Status.php index c58a1d1e2a52..f8ea6fab05d9 100644 --- a/Compute/src/V1/NetworkAttachmentConnectedEndpoint/Status.php +++ b/Compute/src/V1/NetworkAttachmentConnectedEndpoint/Status.php @@ -38,7 +38,8 @@ class Status */ const NEEDS_ATTENTION = 344491452; /** - * The consumer neither allows nor prohibits traffic from the producer to reach its VPC. + * The consumer neither allows nor prohibits traffic + * from the producer to reach its VPC. * * Generated from protobuf enum PENDING = 35394935; */ diff --git a/Compute/src/V1/NetworkAttachmentList.php b/Compute/src/V1/NetworkAttachmentList.php index be0f96ce8ea1..61c71e9de067 100644 --- a/Compute/src/V1/NetworkAttachmentList.php +++ b/Compute/src/V1/NetworkAttachmentList.php @@ -31,7 +31,11 @@ class NetworkAttachmentList extends \Google\Protobuf\Internal\Message */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -61,7 +65,11 @@ class NetworkAttachmentList extends \Google\Protobuf\Internal\Message * A list of NetworkAttachment resources. * @type string $kind * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type \Google\Cloud\Compute\V1\Warning $warning @@ -168,7 +176,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -189,7 +201,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/NetworkAttachmentsScopedList.php b/Compute/src/V1/NetworkAttachmentsScopedList.php index 19e671b62eb9..285adda01817 100644 --- a/Compute/src/V1/NetworkAttachmentsScopedList.php +++ b/Compute/src/V1/NetworkAttachmentsScopedList.php @@ -21,7 +21,8 @@ class NetworkAttachmentsScopedList extends \Google\Protobuf\Internal\Message */ private $network_attachments; /** - * Informational warning which replaces the list of network attachments when the list is empty. + * Informational warning which replaces the list of + * network attachments when the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; */ @@ -36,7 +37,8 @@ class NetworkAttachmentsScopedList extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\NetworkAttachment>|\Google\Protobuf\Internal\RepeatedField $network_attachments * A list of NetworkAttachments contained in this scope. * @type \Google\Cloud\Compute\V1\Warning $warning - * Informational warning which replaces the list of network attachments when the list is empty. + * Informational warning which replaces the list of + * network attachments when the list is empty. * } */ public function __construct($data = NULL) { @@ -71,7 +73,8 @@ public function setNetworkAttachments($var) } /** - * Informational warning which replaces the list of network attachments when the list is empty. + * Informational warning which replaces the list of + * network attachments when the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; * @return \Google\Cloud\Compute\V1\Warning|null @@ -92,7 +95,8 @@ public function clearWarning() } /** - * Informational warning which replaces the list of network attachments when the list is empty. + * Informational warning which replaces the list of + * network attachments when the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; * @param \Google\Cloud\Compute\V1\Warning $var diff --git a/Compute/src/V1/NetworkEdgeSecurityService.php b/Compute/src/V1/NetworkEdgeSecurityService.php index 71198249ad4d..fb6584814f2d 100644 --- a/Compute/src/V1/NetworkEdgeSecurityService.php +++ b/Compute/src/V1/NetworkEdgeSecurityService.php @@ -16,49 +16,68 @@ class NetworkEdgeSecurityService extends \Google\Protobuf\Internal\Message { /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; */ protected $creation_timestamp = null; /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; */ protected $description = null; /** - * Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking. This field will be ignored when inserting a NetworkEdgeSecurityService. An up-to-date fingerprint must be provided in order to update the NetworkEdgeSecurityService, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a NetworkEdgeSecurityService. + * Fingerprint of this resource. A hash of the contents stored in this object. + * This field is used in optimistic locking. This field will be ignored when + * inserting a NetworkEdgeSecurityService. An up-to-date fingerprint must be + * provided in order to update the NetworkEdgeSecurityService, + * otherwise the request will fail with error412 conditionNotMet. + * To see the latest fingerprint, make a get() request to + * retrieve a NetworkEdgeSecurityService. * * Generated from protobuf field optional string fingerprint = 234678500; */ protected $fingerprint = null; /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; */ protected $id = null; /** - * [Output only] Type of the resource. Always compute#networkEdgeSecurityService for NetworkEdgeSecurityServices + * [Output only] Type of the resource. Alwayscompute#networkEdgeSecurityService for + * NetworkEdgeSecurityServices * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * * Generated from protobuf field optional string name = 3373707; */ protected $name = null; /** - * [Output Only] URL of the region where the resource resides. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * [Output Only] URL of the region where the resource resides. You must + * specify this field as part of the HTTP request URL. It is not settable as a + * field in the request body. * * Generated from protobuf field optional string region = 138946292; */ protected $region = null; /** - * The resource URL for the network edge security service associated with this network edge security service. + * The resource URL for the network edge security service associated with this + * network edge security service. * * Generated from protobuf field optional string security_policy = 171082513; */ @@ -83,21 +102,40 @@ class NetworkEdgeSecurityService extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $creation_timestamp - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * @type string $description - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * @type string $fingerprint - * Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking. This field will be ignored when inserting a NetworkEdgeSecurityService. An up-to-date fingerprint must be provided in order to update the NetworkEdgeSecurityService, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a NetworkEdgeSecurityService. + * Fingerprint of this resource. A hash of the contents stored in this object. + * This field is used in optimistic locking. This field will be ignored when + * inserting a NetworkEdgeSecurityService. An up-to-date fingerprint must be + * provided in order to update the NetworkEdgeSecurityService, + * otherwise the request will fail with error412 conditionNotMet. + * To see the latest fingerprint, make a get() request to + * retrieve a NetworkEdgeSecurityService. * @type int|string $id - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * @type string $kind - * [Output only] Type of the resource. Always compute#networkEdgeSecurityService for NetworkEdgeSecurityServices + * [Output only] Type of the resource. Alwayscompute#networkEdgeSecurityService for + * NetworkEdgeSecurityServices * @type string $name - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * @type string $region - * [Output Only] URL of the region where the resource resides. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * [Output Only] URL of the region where the resource resides. You must + * specify this field as part of the HTTP request URL. It is not settable as a + * field in the request body. * @type string $security_policy - * The resource URL for the network edge security service associated with this network edge security service. + * The resource URL for the network edge security service associated with this + * network edge security service. * @type string $self_link * [Output Only] Server-defined URL for the resource. * @type string $self_link_with_id @@ -110,7 +148,8 @@ public function __construct($data = NULL) { } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @return string @@ -131,7 +170,8 @@ public function clearCreationTimestamp() } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @param string $var @@ -146,7 +186,8 @@ public function setCreationTimestamp($var) } /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @return string @@ -167,7 +208,8 @@ public function clearDescription() } /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @param string $var @@ -182,7 +224,13 @@ public function setDescription($var) } /** - * Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking. This field will be ignored when inserting a NetworkEdgeSecurityService. An up-to-date fingerprint must be provided in order to update the NetworkEdgeSecurityService, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a NetworkEdgeSecurityService. + * Fingerprint of this resource. A hash of the contents stored in this object. + * This field is used in optimistic locking. This field will be ignored when + * inserting a NetworkEdgeSecurityService. An up-to-date fingerprint must be + * provided in order to update the NetworkEdgeSecurityService, + * otherwise the request will fail with error412 conditionNotMet. + * To see the latest fingerprint, make a get() request to + * retrieve a NetworkEdgeSecurityService. * * Generated from protobuf field optional string fingerprint = 234678500; * @return string @@ -203,7 +251,13 @@ public function clearFingerprint() } /** - * Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking. This field will be ignored when inserting a NetworkEdgeSecurityService. An up-to-date fingerprint must be provided in order to update the NetworkEdgeSecurityService, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a NetworkEdgeSecurityService. + * Fingerprint of this resource. A hash of the contents stored in this object. + * This field is used in optimistic locking. This field will be ignored when + * inserting a NetworkEdgeSecurityService. An up-to-date fingerprint must be + * provided in order to update the NetworkEdgeSecurityService, + * otherwise the request will fail with error412 conditionNotMet. + * To see the latest fingerprint, make a get() request to + * retrieve a NetworkEdgeSecurityService. * * Generated from protobuf field optional string fingerprint = 234678500; * @param string $var @@ -218,7 +272,8 @@ public function setFingerprint($var) } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @return int|string @@ -239,7 +294,8 @@ public function clearId() } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @param int|string $var @@ -254,7 +310,8 @@ public function setId($var) } /** - * [Output only] Type of the resource. Always compute#networkEdgeSecurityService for NetworkEdgeSecurityServices + * [Output only] Type of the resource. Alwayscompute#networkEdgeSecurityService for + * NetworkEdgeSecurityServices * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -275,7 +332,8 @@ public function clearKind() } /** - * [Output only] Type of the resource. Always compute#networkEdgeSecurityService for NetworkEdgeSecurityServices + * [Output only] Type of the resource. Alwayscompute#networkEdgeSecurityService for + * NetworkEdgeSecurityServices * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -290,7 +348,13 @@ public function setKind($var) } /** - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * * Generated from protobuf field optional string name = 3373707; * @return string @@ -311,7 +375,13 @@ public function clearName() } /** - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * * Generated from protobuf field optional string name = 3373707; * @param string $var @@ -326,7 +396,9 @@ public function setName($var) } /** - * [Output Only] URL of the region where the resource resides. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * [Output Only] URL of the region where the resource resides. You must + * specify this field as part of the HTTP request URL. It is not settable as a + * field in the request body. * * Generated from protobuf field optional string region = 138946292; * @return string @@ -347,7 +419,9 @@ public function clearRegion() } /** - * [Output Only] URL of the region where the resource resides. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * [Output Only] URL of the region where the resource resides. You must + * specify this field as part of the HTTP request URL. It is not settable as a + * field in the request body. * * Generated from protobuf field optional string region = 138946292; * @param string $var @@ -362,7 +436,8 @@ public function setRegion($var) } /** - * The resource URL for the network edge security service associated with this network edge security service. + * The resource URL for the network edge security service associated with this + * network edge security service. * * Generated from protobuf field optional string security_policy = 171082513; * @return string @@ -383,7 +458,8 @@ public function clearSecurityPolicy() } /** - * The resource URL for the network edge security service associated with this network edge security service. + * The resource URL for the network edge security service associated with this + * network edge security service. * * Generated from protobuf field optional string security_policy = 171082513; * @param string $var diff --git a/Compute/src/V1/NetworkEdgeSecurityServiceAggregatedList.php b/Compute/src/V1/NetworkEdgeSecurityServiceAggregatedList.php index be37a3508408..c2afe4555f78 100644 --- a/Compute/src/V1/NetworkEdgeSecurityServiceAggregatedList.php +++ b/Compute/src/V1/NetworkEdgeSecurityServiceAggregatedList.php @@ -31,13 +31,18 @@ class NetworkEdgeSecurityServiceAggregatedList extends \Google\Protobuf\Internal */ private $items; /** - * [Output Only] Type of resource. Always compute#networkEdgeSecurityServiceAggregatedList for lists of Network Edge Security Services. + * [Output Only] Type of resource. Alwayscompute#networkEdgeSecurityServiceAggregatedList for lists of + * Network Edge Security Services. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -73,9 +78,14 @@ class NetworkEdgeSecurityServiceAggregatedList extends \Google\Protobuf\Internal * @type array|\Google\Protobuf\Internal\MapField $items * A list of NetworkEdgeSecurityServicesScopedList resources. * @type string $kind - * [Output Only] Type of resource. Always compute#networkEdgeSecurityServiceAggregatedList for lists of Network Edge Security Services. + * [Output Only] Type of resource. Alwayscompute#networkEdgeSecurityServiceAggregatedList for lists of + * Network Edge Security Services. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type array|\Google\Protobuf\Internal\RepeatedField $unreachables @@ -184,7 +194,8 @@ public function setItems($var) } /** - * [Output Only] Type of resource. Always compute#networkEdgeSecurityServiceAggregatedList for lists of Network Edge Security Services. + * [Output Only] Type of resource. Alwayscompute#networkEdgeSecurityServiceAggregatedList for lists of + * Network Edge Security Services. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -205,7 +216,8 @@ public function clearKind() } /** - * [Output Only] Type of resource. Always compute#networkEdgeSecurityServiceAggregatedList for lists of Network Edge Security Services. + * [Output Only] Type of resource. Alwayscompute#networkEdgeSecurityServiceAggregatedList for lists of + * Network Edge Security Services. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -220,7 +232,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -241,7 +257,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/NetworkEdgeSecurityServicesScopedList.php b/Compute/src/V1/NetworkEdgeSecurityServicesScopedList.php index 3fa07cd73f55..d20b02eb2d9f 100644 --- a/Compute/src/V1/NetworkEdgeSecurityServicesScopedList.php +++ b/Compute/src/V1/NetworkEdgeSecurityServicesScopedList.php @@ -21,7 +21,8 @@ class NetworkEdgeSecurityServicesScopedList extends \Google\Protobuf\Internal\Me */ private $network_edge_security_services; /** - * Informational warning which replaces the list of security policies when the list is empty. + * Informational warning which replaces the list of + * security policies when the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; */ @@ -36,7 +37,8 @@ class NetworkEdgeSecurityServicesScopedList extends \Google\Protobuf\Internal\Me * @type array<\Google\Cloud\Compute\V1\NetworkEdgeSecurityService>|\Google\Protobuf\Internal\RepeatedField $network_edge_security_services * A list of NetworkEdgeSecurityServices contained in this scope. * @type \Google\Cloud\Compute\V1\Warning $warning - * Informational warning which replaces the list of security policies when the list is empty. + * Informational warning which replaces the list of + * security policies when the list is empty. * } */ public function __construct($data = NULL) { @@ -71,7 +73,8 @@ public function setNetworkEdgeSecurityServices($var) } /** - * Informational warning which replaces the list of security policies when the list is empty. + * Informational warning which replaces the list of + * security policies when the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; * @return \Google\Cloud\Compute\V1\Warning|null @@ -92,7 +95,8 @@ public function clearWarning() } /** - * Informational warning which replaces the list of security policies when the list is empty. + * Informational warning which replaces the list of + * security policies when the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; * @param \Google\Cloud\Compute\V1\Warning $var diff --git a/Compute/src/V1/NetworkEndpoint.php b/Compute/src/V1/NetworkEndpoint.php index a1892a36b73b..dfade0188170 100644 --- a/Compute/src/V1/NetworkEndpoint.php +++ b/Compute/src/V1/NetworkEndpoint.php @@ -22,25 +22,43 @@ class NetworkEndpoint extends \Google\Protobuf\Internal\Message */ private $annotations; /** - * Represents the port number to which PSC consumer sends packets. Optional. Only valid for network endpoint groups created with GCE_VM_IP_PORTMAP endpoint type. + * Represents the port number to which PSC consumer sends packets. + * Optional. Only valid for network endpoint groups created withGCE_VM_IP_PORTMAP endpoint type. * * Generated from protobuf field optional int32 client_destination_port = 123765766; */ protected $client_destination_port = null; /** - * Optional fully qualified domain name of network endpoint. This can only be specified when NetworkEndpointGroup.network_endpoint_type is NON_GCP_FQDN_PORT. + * Optional fully qualified domain name of network endpoint. This can only be + * specified when NetworkEndpointGroup.network_endpoint_type isNON_GCP_FQDN_PORT. * * Generated from protobuf field optional string fqdn = 3150485; */ protected $fqdn = null; /** - * The name or a URL of VM instance of this network endpoint. Optional, the field presence depends on the network endpoint type. The field is required for network endpoints of type GCE_VM_IP and GCE_VM_IP_PORT. The instance must be in the same zone of network endpoint group (for zonal NEGs) or in the zone within the region of the NEG (for regional NEGs). If the ipAddress is specified, it must belongs to the VM instance. The name must be 1-63 characters long, and comply with RFC1035 or be a valid URL pointing to an existing instance. + * The name or a URL of VM instance of this network endpoint. + * Optional, the field presence depends on the network endpoint type. The + * field is required for network endpoints of type GCE_VM_IP andGCE_VM_IP_PORT. + * The instance must be in the same zone of network endpoint group (for zonal + * NEGs) or in the zone within the region of the NEG (for regional NEGs). + * If the ipAddress is specified, it must belongs to the VM + * instance. + * The name must be 1-63 characters long, and comply withRFC1035 + * or be a valid URL pointing to an existing instance. * * Generated from protobuf field optional string instance = 18257045; */ protected $instance = null; /** - * Optional IPv4 address of network endpoint. The IP address must belong to a VM in Compute Engine (either the primary IP or as part of an aliased IP range). If the IP address is not specified, then the primary IP address for the VM instance in the network that the network endpoint group belongs to will be used. This field is redundant and need not be set for network endpoints of type GCE_VM_IP. If set, it must be set to the primary internal IP address of the attached VM instance that matches the subnetwork of the NEG. The primary internal IP address from any NIC of a multi-NIC VM instance can be added to a NEG as long as it matches the NEG subnetwork. + * Optional IPv4 address of network endpoint. The IP address must belong to a + * VM in Compute Engine (either the primary IP or as part of an aliased IP + * range). If the IP address is not specified, then the primary IP address for + * the VM instance in the network that the network endpoint group belongs to + * will be used. + * This field is redundant and need not be set for network endpoints of typeGCE_VM_IP. If set, it must be set to the primary internal IP + * address of the attached VM instance that matches the subnetwork of the NEG. + * The primary internal IP address from any NIC of a multi-NIC VM instance can + * be added to a NEG as long as it matches the NEG subnetwork. * * Generated from protobuf field optional string ip_address = 406272220; */ @@ -52,7 +70,9 @@ class NetworkEndpoint extends \Google\Protobuf\Internal\Message */ protected $ipv6_address = null; /** - * Optional port number of network endpoint. If not specified, the defaultPort for the network endpoint group will be used. This field can not be set for network endpoints of type GCE_VM_IP. + * Optional port number of network endpoint. If not specified, the + * defaultPort for the network endpoint group will be used. + * This field can not be set for network endpoints of typeGCE_VM_IP. * * Generated from protobuf field optional int32 port = 3446913; */ @@ -67,17 +87,37 @@ class NetworkEndpoint extends \Google\Protobuf\Internal\Message * @type array|\Google\Protobuf\Internal\MapField $annotations * Optional metadata defined as annotations on the network endpoint. * @type int $client_destination_port - * Represents the port number to which PSC consumer sends packets. Optional. Only valid for network endpoint groups created with GCE_VM_IP_PORTMAP endpoint type. + * Represents the port number to which PSC consumer sends packets. + * Optional. Only valid for network endpoint groups created withGCE_VM_IP_PORTMAP endpoint type. * @type string $fqdn - * Optional fully qualified domain name of network endpoint. This can only be specified when NetworkEndpointGroup.network_endpoint_type is NON_GCP_FQDN_PORT. + * Optional fully qualified domain name of network endpoint. This can only be + * specified when NetworkEndpointGroup.network_endpoint_type isNON_GCP_FQDN_PORT. * @type string $instance - * The name or a URL of VM instance of this network endpoint. Optional, the field presence depends on the network endpoint type. The field is required for network endpoints of type GCE_VM_IP and GCE_VM_IP_PORT. The instance must be in the same zone of network endpoint group (for zonal NEGs) or in the zone within the region of the NEG (for regional NEGs). If the ipAddress is specified, it must belongs to the VM instance. The name must be 1-63 characters long, and comply with RFC1035 or be a valid URL pointing to an existing instance. + * The name or a URL of VM instance of this network endpoint. + * Optional, the field presence depends on the network endpoint type. The + * field is required for network endpoints of type GCE_VM_IP andGCE_VM_IP_PORT. + * The instance must be in the same zone of network endpoint group (for zonal + * NEGs) or in the zone within the region of the NEG (for regional NEGs). + * If the ipAddress is specified, it must belongs to the VM + * instance. + * The name must be 1-63 characters long, and comply withRFC1035 + * or be a valid URL pointing to an existing instance. * @type string $ip_address - * Optional IPv4 address of network endpoint. The IP address must belong to a VM in Compute Engine (either the primary IP or as part of an aliased IP range). If the IP address is not specified, then the primary IP address for the VM instance in the network that the network endpoint group belongs to will be used. This field is redundant and need not be set for network endpoints of type GCE_VM_IP. If set, it must be set to the primary internal IP address of the attached VM instance that matches the subnetwork of the NEG. The primary internal IP address from any NIC of a multi-NIC VM instance can be added to a NEG as long as it matches the NEG subnetwork. + * Optional IPv4 address of network endpoint. The IP address must belong to a + * VM in Compute Engine (either the primary IP or as part of an aliased IP + * range). If the IP address is not specified, then the primary IP address for + * the VM instance in the network that the network endpoint group belongs to + * will be used. + * This field is redundant and need not be set for network endpoints of typeGCE_VM_IP. If set, it must be set to the primary internal IP + * address of the attached VM instance that matches the subnetwork of the NEG. + * The primary internal IP address from any NIC of a multi-NIC VM instance can + * be added to a NEG as long as it matches the NEG subnetwork. * @type string $ipv6_address * Optional IPv6 address of network endpoint. * @type int $port - * Optional port number of network endpoint. If not specified, the defaultPort for the network endpoint group will be used. This field can not be set for network endpoints of type GCE_VM_IP. + * Optional port number of network endpoint. If not specified, the + * defaultPort for the network endpoint group will be used. + * This field can not be set for network endpoints of typeGCE_VM_IP. * } */ public function __construct($data = NULL) { @@ -112,7 +152,8 @@ public function setAnnotations($var) } /** - * Represents the port number to which PSC consumer sends packets. Optional. Only valid for network endpoint groups created with GCE_VM_IP_PORTMAP endpoint type. + * Represents the port number to which PSC consumer sends packets. + * Optional. Only valid for network endpoint groups created withGCE_VM_IP_PORTMAP endpoint type. * * Generated from protobuf field optional int32 client_destination_port = 123765766; * @return int @@ -133,7 +174,8 @@ public function clearClientDestinationPort() } /** - * Represents the port number to which PSC consumer sends packets. Optional. Only valid for network endpoint groups created with GCE_VM_IP_PORTMAP endpoint type. + * Represents the port number to which PSC consumer sends packets. + * Optional. Only valid for network endpoint groups created withGCE_VM_IP_PORTMAP endpoint type. * * Generated from protobuf field optional int32 client_destination_port = 123765766; * @param int $var @@ -148,7 +190,8 @@ public function setClientDestinationPort($var) } /** - * Optional fully qualified domain name of network endpoint. This can only be specified when NetworkEndpointGroup.network_endpoint_type is NON_GCP_FQDN_PORT. + * Optional fully qualified domain name of network endpoint. This can only be + * specified when NetworkEndpointGroup.network_endpoint_type isNON_GCP_FQDN_PORT. * * Generated from protobuf field optional string fqdn = 3150485; * @return string @@ -169,7 +212,8 @@ public function clearFqdn() } /** - * Optional fully qualified domain name of network endpoint. This can only be specified when NetworkEndpointGroup.network_endpoint_type is NON_GCP_FQDN_PORT. + * Optional fully qualified domain name of network endpoint. This can only be + * specified when NetworkEndpointGroup.network_endpoint_type isNON_GCP_FQDN_PORT. * * Generated from protobuf field optional string fqdn = 3150485; * @param string $var @@ -184,7 +228,15 @@ public function setFqdn($var) } /** - * The name or a URL of VM instance of this network endpoint. Optional, the field presence depends on the network endpoint type. The field is required for network endpoints of type GCE_VM_IP and GCE_VM_IP_PORT. The instance must be in the same zone of network endpoint group (for zonal NEGs) or in the zone within the region of the NEG (for regional NEGs). If the ipAddress is specified, it must belongs to the VM instance. The name must be 1-63 characters long, and comply with RFC1035 or be a valid URL pointing to an existing instance. + * The name or a URL of VM instance of this network endpoint. + * Optional, the field presence depends on the network endpoint type. The + * field is required for network endpoints of type GCE_VM_IP andGCE_VM_IP_PORT. + * The instance must be in the same zone of network endpoint group (for zonal + * NEGs) or in the zone within the region of the NEG (for regional NEGs). + * If the ipAddress is specified, it must belongs to the VM + * instance. + * The name must be 1-63 characters long, and comply withRFC1035 + * or be a valid URL pointing to an existing instance. * * Generated from protobuf field optional string instance = 18257045; * @return string @@ -205,7 +257,15 @@ public function clearInstance() } /** - * The name or a URL of VM instance of this network endpoint. Optional, the field presence depends on the network endpoint type. The field is required for network endpoints of type GCE_VM_IP and GCE_VM_IP_PORT. The instance must be in the same zone of network endpoint group (for zonal NEGs) or in the zone within the region of the NEG (for regional NEGs). If the ipAddress is specified, it must belongs to the VM instance. The name must be 1-63 characters long, and comply with RFC1035 or be a valid URL pointing to an existing instance. + * The name or a URL of VM instance of this network endpoint. + * Optional, the field presence depends on the network endpoint type. The + * field is required for network endpoints of type GCE_VM_IP andGCE_VM_IP_PORT. + * The instance must be in the same zone of network endpoint group (for zonal + * NEGs) or in the zone within the region of the NEG (for regional NEGs). + * If the ipAddress is specified, it must belongs to the VM + * instance. + * The name must be 1-63 characters long, and comply withRFC1035 + * or be a valid URL pointing to an existing instance. * * Generated from protobuf field optional string instance = 18257045; * @param string $var @@ -220,7 +280,15 @@ public function setInstance($var) } /** - * Optional IPv4 address of network endpoint. The IP address must belong to a VM in Compute Engine (either the primary IP or as part of an aliased IP range). If the IP address is not specified, then the primary IP address for the VM instance in the network that the network endpoint group belongs to will be used. This field is redundant and need not be set for network endpoints of type GCE_VM_IP. If set, it must be set to the primary internal IP address of the attached VM instance that matches the subnetwork of the NEG. The primary internal IP address from any NIC of a multi-NIC VM instance can be added to a NEG as long as it matches the NEG subnetwork. + * Optional IPv4 address of network endpoint. The IP address must belong to a + * VM in Compute Engine (either the primary IP or as part of an aliased IP + * range). If the IP address is not specified, then the primary IP address for + * the VM instance in the network that the network endpoint group belongs to + * will be used. + * This field is redundant and need not be set for network endpoints of typeGCE_VM_IP. If set, it must be set to the primary internal IP + * address of the attached VM instance that matches the subnetwork of the NEG. + * The primary internal IP address from any NIC of a multi-NIC VM instance can + * be added to a NEG as long as it matches the NEG subnetwork. * * Generated from protobuf field optional string ip_address = 406272220; * @return string @@ -241,7 +309,15 @@ public function clearIpAddress() } /** - * Optional IPv4 address of network endpoint. The IP address must belong to a VM in Compute Engine (either the primary IP or as part of an aliased IP range). If the IP address is not specified, then the primary IP address for the VM instance in the network that the network endpoint group belongs to will be used. This field is redundant and need not be set for network endpoints of type GCE_VM_IP. If set, it must be set to the primary internal IP address of the attached VM instance that matches the subnetwork of the NEG. The primary internal IP address from any NIC of a multi-NIC VM instance can be added to a NEG as long as it matches the NEG subnetwork. + * Optional IPv4 address of network endpoint. The IP address must belong to a + * VM in Compute Engine (either the primary IP or as part of an aliased IP + * range). If the IP address is not specified, then the primary IP address for + * the VM instance in the network that the network endpoint group belongs to + * will be used. + * This field is redundant and need not be set for network endpoints of typeGCE_VM_IP. If set, it must be set to the primary internal IP + * address of the attached VM instance that matches the subnetwork of the NEG. + * The primary internal IP address from any NIC of a multi-NIC VM instance can + * be added to a NEG as long as it matches the NEG subnetwork. * * Generated from protobuf field optional string ip_address = 406272220; * @param string $var @@ -292,7 +368,9 @@ public function setIpv6Address($var) } /** - * Optional port number of network endpoint. If not specified, the defaultPort for the network endpoint group will be used. This field can not be set for network endpoints of type GCE_VM_IP. + * Optional port number of network endpoint. If not specified, the + * defaultPort for the network endpoint group will be used. + * This field can not be set for network endpoints of typeGCE_VM_IP. * * Generated from protobuf field optional int32 port = 3446913; * @return int @@ -313,7 +391,9 @@ public function clearPort() } /** - * Optional port number of network endpoint. If not specified, the defaultPort for the network endpoint group will be used. This field can not be set for network endpoints of type GCE_VM_IP. + * Optional port number of network endpoint. If not specified, the + * defaultPort for the network endpoint group will be used. + * This field can not be set for network endpoints of typeGCE_VM_IP. * * Generated from protobuf field optional int32 port = 3446913; * @param int $var diff --git a/Compute/src/V1/NetworkEndpointGroup.php b/Compute/src/V1/NetworkEndpointGroup.php index e5ad29eff593..072fc57f26fe 100644 --- a/Compute/src/V1/NetworkEndpointGroup.php +++ b/Compute/src/V1/NetworkEndpointGroup.php @@ -9,7 +9,10 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Represents a collection of network endpoints. A network endpoint group (NEG) defines how a set of endpoints should be reached, whether they are reachable, and where they are located. For more information about using NEGs for different use cases, see Network endpoint groups overview. + * Represents a collection of network endpoints. + * A network endpoint group (NEG) defines how a set of endpoints should be + * reached, whether they are reachable, and where they are located. + * For more information about using NEGs for different use cases, seeNetwork endpoint groups overview. * * Generated from protobuf message google.cloud.compute.v1.NetworkEndpointGroup */ @@ -22,86 +25,103 @@ class NetworkEndpointGroup extends \Google\Protobuf\Internal\Message */ private $annotations; /** - * Optional. Only valid when networkEndpointType is SERVERLESS. Only one of cloudRun, appEngine or cloudFunction may be set. + * Optional. Only valid when networkEndpointType isSERVERLESS. Only one of cloudRun,appEngine or cloudFunction may be set. * * Generated from protobuf field optional .google.cloud.compute.v1.NetworkEndpointGroupAppEngine app_engine = 340788768; */ protected $app_engine = null; /** - * Optional. Only valid when networkEndpointType is SERVERLESS. Only one of cloudRun, appEngine or cloudFunction may be set. + * Optional. Only valid when networkEndpointType isSERVERLESS. Only one of cloudRun,appEngine or cloudFunction may be set. * * Generated from protobuf field optional .google.cloud.compute.v1.NetworkEndpointGroupCloudFunction cloud_function = 519893666; */ protected $cloud_function = null; /** - * Optional. Only valid when networkEndpointType is SERVERLESS. Only one of cloudRun, appEngine or cloudFunction may be set. + * Optional. Only valid when networkEndpointType isSERVERLESS. Only one of cloudRun,appEngine or cloudFunction may be set. * * Generated from protobuf field optional .google.cloud.compute.v1.NetworkEndpointGroupCloudRun cloud_run = 111060353; */ protected $cloud_run = null; /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; */ protected $creation_timestamp = null; /** - * The default port used if the port number is not specified in the network endpoint. Optional. If the network endpoint type is either GCE_VM_IP, SERVERLESS or PRIVATE_SERVICE_CONNECT, this field must not be specified. + * The default port used if the port number is not specified in the network + * endpoint. + * Optional. If the network endpoint type is either GCE_VM_IP,SERVERLESS or PRIVATE_SERVICE_CONNECT, this + * field must not be specified. * * Generated from protobuf field optional int32 default_port = 423377855; */ protected $default_port = null; /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; */ protected $description = null; /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; */ protected $id = null; /** - * [Output Only] Type of the resource. Always compute#networkEndpointGroup for network endpoint group. + * [Output Only] Type of the resource. Alwayscompute#networkEndpointGroup for network endpoint group. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * Name of the resource; provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource; provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must be + * a dash, lowercase letter, or digit, except the last character, which cannot + * be a dash. * * Generated from protobuf field optional string name = 3373707; */ protected $name = null; /** - * The URL of the network to which all network endpoints in the NEG belong. Uses default project network if unspecified. + * The URL of the network to which all network endpoints in the NEG belong. + * Uses default project network if unspecified. * * Generated from protobuf field optional string network = 232872494; */ protected $network = null; /** - * Type of network endpoints in this network endpoint group. Can be one of GCE_VM_IP, GCE_VM_IP_PORT, NON_GCP_PRIVATE_IP_PORT, INTERNET_FQDN_PORT, INTERNET_IP_PORT, SERVERLESS, PRIVATE_SERVICE_CONNECT, GCE_VM_IP_PORTMAP. + * Type of network endpoints in this network endpoint group. Can be one ofGCE_VM_IP, GCE_VM_IP_PORT,NON_GCP_PRIVATE_IP_PORT, INTERNET_FQDN_PORT,INTERNET_IP_PORT, SERVERLESS,PRIVATE_SERVICE_CONNECT, GCE_VM_IP_PORTMAP. * Check the NetworkEndpointType enum for the list of possible values. * * Generated from protobuf field optional string network_endpoint_type = 118301523; */ protected $network_endpoint_type = null; /** - * Optional. Only valid when networkEndpointType is PRIVATE_SERVICE_CONNECT. + * Optional. Only valid when networkEndpointType isPRIVATE_SERVICE_CONNECT. * * Generated from protobuf field optional .google.cloud.compute.v1.NetworkEndpointGroupPscData psc_data = 71937481; */ protected $psc_data = null; /** - * The target service url used to set up private service connection to a Google API or a PSC Producer Service Attachment. An example value is: asia-northeast3-cloudkms.googleapis.com. Optional. Only valid when networkEndpointType is PRIVATE_SERVICE_CONNECT. + * The target service url used to set up private service connection to + * a Google API or a PSC Producer Service Attachment. + * An example value is: asia-northeast3-cloudkms.googleapis.com. + * Optional. Only valid when networkEndpointType isPRIVATE_SERVICE_CONNECT. * * Generated from protobuf field optional string psc_target_service = 269132134; */ protected $psc_target_service = null; /** - * [Output Only] The URL of the region where the network endpoint group is located. + * [Output Only] The URL of theregion + * where the network endpoint group is located. * * Generated from protobuf field optional string region = 138946292; */ @@ -119,13 +139,15 @@ class NetworkEndpointGroup extends \Google\Protobuf\Internal\Message */ protected $size = null; /** - * Optional URL of the subnetwork to which all network endpoints in the NEG belong. + * Optional URL of the subnetwork to which all network endpoints in the NEG + * belong. * * Generated from protobuf field optional string subnetwork = 307827694; */ protected $subnetwork = null; /** - * [Output Only] The URL of the zone where the network endpoint group is located. + * [Output Only] The URL of thezone + * where the network endpoint group is located. * * Generated from protobuf field optional string zone = 3744684; */ @@ -140,42 +162,61 @@ class NetworkEndpointGroup extends \Google\Protobuf\Internal\Message * @type array|\Google\Protobuf\Internal\MapField $annotations * Optional. Metadata defined as annotations on the network endpoint group. * @type \Google\Cloud\Compute\V1\NetworkEndpointGroupAppEngine $app_engine - * Optional. Only valid when networkEndpointType is SERVERLESS. Only one of cloudRun, appEngine or cloudFunction may be set. + * Optional. Only valid when networkEndpointType isSERVERLESS. Only one of cloudRun,appEngine or cloudFunction may be set. * @type \Google\Cloud\Compute\V1\NetworkEndpointGroupCloudFunction $cloud_function - * Optional. Only valid when networkEndpointType is SERVERLESS. Only one of cloudRun, appEngine or cloudFunction may be set. + * Optional. Only valid when networkEndpointType isSERVERLESS. Only one of cloudRun,appEngine or cloudFunction may be set. * @type \Google\Cloud\Compute\V1\NetworkEndpointGroupCloudRun $cloud_run - * Optional. Only valid when networkEndpointType is SERVERLESS. Only one of cloudRun, appEngine or cloudFunction may be set. + * Optional. Only valid when networkEndpointType isSERVERLESS. Only one of cloudRun,appEngine or cloudFunction may be set. * @type string $creation_timestamp - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * @type int $default_port - * The default port used if the port number is not specified in the network endpoint. Optional. If the network endpoint type is either GCE_VM_IP, SERVERLESS or PRIVATE_SERVICE_CONNECT, this field must not be specified. + * The default port used if the port number is not specified in the network + * endpoint. + * Optional. If the network endpoint type is either GCE_VM_IP,SERVERLESS or PRIVATE_SERVICE_CONNECT, this + * field must not be specified. * @type string $description - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * @type int|string $id - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * @type string $kind - * [Output Only] Type of the resource. Always compute#networkEndpointGroup for network endpoint group. + * [Output Only] Type of the resource. Alwayscompute#networkEndpointGroup for network endpoint group. * @type string $name - * Name of the resource; provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource; provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must be + * a dash, lowercase letter, or digit, except the last character, which cannot + * be a dash. * @type string $network - * The URL of the network to which all network endpoints in the NEG belong. Uses default project network if unspecified. + * The URL of the network to which all network endpoints in the NEG belong. + * Uses default project network if unspecified. * @type string $network_endpoint_type - * Type of network endpoints in this network endpoint group. Can be one of GCE_VM_IP, GCE_VM_IP_PORT, NON_GCP_PRIVATE_IP_PORT, INTERNET_FQDN_PORT, INTERNET_IP_PORT, SERVERLESS, PRIVATE_SERVICE_CONNECT, GCE_VM_IP_PORTMAP. + * Type of network endpoints in this network endpoint group. Can be one ofGCE_VM_IP, GCE_VM_IP_PORT,NON_GCP_PRIVATE_IP_PORT, INTERNET_FQDN_PORT,INTERNET_IP_PORT, SERVERLESS,PRIVATE_SERVICE_CONNECT, GCE_VM_IP_PORTMAP. * Check the NetworkEndpointType enum for the list of possible values. * @type \Google\Cloud\Compute\V1\NetworkEndpointGroupPscData $psc_data - * Optional. Only valid when networkEndpointType is PRIVATE_SERVICE_CONNECT. + * Optional. Only valid when networkEndpointType isPRIVATE_SERVICE_CONNECT. * @type string $psc_target_service - * The target service url used to set up private service connection to a Google API or a PSC Producer Service Attachment. An example value is: asia-northeast3-cloudkms.googleapis.com. Optional. Only valid when networkEndpointType is PRIVATE_SERVICE_CONNECT. + * The target service url used to set up private service connection to + * a Google API or a PSC Producer Service Attachment. + * An example value is: asia-northeast3-cloudkms.googleapis.com. + * Optional. Only valid when networkEndpointType isPRIVATE_SERVICE_CONNECT. * @type string $region - * [Output Only] The URL of the region where the network endpoint group is located. + * [Output Only] The URL of theregion + * where the network endpoint group is located. * @type string $self_link * [Output Only] Server-defined URL for the resource. * @type int $size * [Output only] Number of network endpoints in the network endpoint group. * @type string $subnetwork - * Optional URL of the subnetwork to which all network endpoints in the NEG belong. + * Optional URL of the subnetwork to which all network endpoints in the NEG + * belong. * @type string $zone - * [Output Only] The URL of the zone where the network endpoint group is located. + * [Output Only] The URL of thezone + * where the network endpoint group is located. * } */ public function __construct($data = NULL) { @@ -210,7 +251,7 @@ public function setAnnotations($var) } /** - * Optional. Only valid when networkEndpointType is SERVERLESS. Only one of cloudRun, appEngine or cloudFunction may be set. + * Optional. Only valid when networkEndpointType isSERVERLESS. Only one of cloudRun,appEngine or cloudFunction may be set. * * Generated from protobuf field optional .google.cloud.compute.v1.NetworkEndpointGroupAppEngine app_engine = 340788768; * @return \Google\Cloud\Compute\V1\NetworkEndpointGroupAppEngine|null @@ -231,7 +272,7 @@ public function clearAppEngine() } /** - * Optional. Only valid when networkEndpointType is SERVERLESS. Only one of cloudRun, appEngine or cloudFunction may be set. + * Optional. Only valid when networkEndpointType isSERVERLESS. Only one of cloudRun,appEngine or cloudFunction may be set. * * Generated from protobuf field optional .google.cloud.compute.v1.NetworkEndpointGroupAppEngine app_engine = 340788768; * @param \Google\Cloud\Compute\V1\NetworkEndpointGroupAppEngine $var @@ -246,7 +287,7 @@ public function setAppEngine($var) } /** - * Optional. Only valid when networkEndpointType is SERVERLESS. Only one of cloudRun, appEngine or cloudFunction may be set. + * Optional. Only valid when networkEndpointType isSERVERLESS. Only one of cloudRun,appEngine or cloudFunction may be set. * * Generated from protobuf field optional .google.cloud.compute.v1.NetworkEndpointGroupCloudFunction cloud_function = 519893666; * @return \Google\Cloud\Compute\V1\NetworkEndpointGroupCloudFunction|null @@ -267,7 +308,7 @@ public function clearCloudFunction() } /** - * Optional. Only valid when networkEndpointType is SERVERLESS. Only one of cloudRun, appEngine or cloudFunction may be set. + * Optional. Only valid when networkEndpointType isSERVERLESS. Only one of cloudRun,appEngine or cloudFunction may be set. * * Generated from protobuf field optional .google.cloud.compute.v1.NetworkEndpointGroupCloudFunction cloud_function = 519893666; * @param \Google\Cloud\Compute\V1\NetworkEndpointGroupCloudFunction $var @@ -282,7 +323,7 @@ public function setCloudFunction($var) } /** - * Optional. Only valid when networkEndpointType is SERVERLESS. Only one of cloudRun, appEngine or cloudFunction may be set. + * Optional. Only valid when networkEndpointType isSERVERLESS. Only one of cloudRun,appEngine or cloudFunction may be set. * * Generated from protobuf field optional .google.cloud.compute.v1.NetworkEndpointGroupCloudRun cloud_run = 111060353; * @return \Google\Cloud\Compute\V1\NetworkEndpointGroupCloudRun|null @@ -303,7 +344,7 @@ public function clearCloudRun() } /** - * Optional. Only valid when networkEndpointType is SERVERLESS. Only one of cloudRun, appEngine or cloudFunction may be set. + * Optional. Only valid when networkEndpointType isSERVERLESS. Only one of cloudRun,appEngine or cloudFunction may be set. * * Generated from protobuf field optional .google.cloud.compute.v1.NetworkEndpointGroupCloudRun cloud_run = 111060353; * @param \Google\Cloud\Compute\V1\NetworkEndpointGroupCloudRun $var @@ -318,7 +359,8 @@ public function setCloudRun($var) } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @return string @@ -339,7 +381,8 @@ public function clearCreationTimestamp() } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @param string $var @@ -354,7 +397,10 @@ public function setCreationTimestamp($var) } /** - * The default port used if the port number is not specified in the network endpoint. Optional. If the network endpoint type is either GCE_VM_IP, SERVERLESS or PRIVATE_SERVICE_CONNECT, this field must not be specified. + * The default port used if the port number is not specified in the network + * endpoint. + * Optional. If the network endpoint type is either GCE_VM_IP,SERVERLESS or PRIVATE_SERVICE_CONNECT, this + * field must not be specified. * * Generated from protobuf field optional int32 default_port = 423377855; * @return int @@ -375,7 +421,10 @@ public function clearDefaultPort() } /** - * The default port used if the port number is not specified in the network endpoint. Optional. If the network endpoint type is either GCE_VM_IP, SERVERLESS or PRIVATE_SERVICE_CONNECT, this field must not be specified. + * The default port used if the port number is not specified in the network + * endpoint. + * Optional. If the network endpoint type is either GCE_VM_IP,SERVERLESS or PRIVATE_SERVICE_CONNECT, this + * field must not be specified. * * Generated from protobuf field optional int32 default_port = 423377855; * @param int $var @@ -390,7 +439,8 @@ public function setDefaultPort($var) } /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @return string @@ -411,7 +461,8 @@ public function clearDescription() } /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @param string $var @@ -426,7 +477,8 @@ public function setDescription($var) } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @return int|string @@ -447,7 +499,8 @@ public function clearId() } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @param int|string $var @@ -462,7 +515,7 @@ public function setId($var) } /** - * [Output Only] Type of the resource. Always compute#networkEndpointGroup for network endpoint group. + * [Output Only] Type of the resource. Alwayscompute#networkEndpointGroup for network endpoint group. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -483,7 +536,7 @@ public function clearKind() } /** - * [Output Only] Type of the resource. Always compute#networkEndpointGroup for network endpoint group. + * [Output Only] Type of the resource. Alwayscompute#networkEndpointGroup for network endpoint group. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -498,7 +551,13 @@ public function setKind($var) } /** - * Name of the resource; provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource; provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must be + * a dash, lowercase letter, or digit, except the last character, which cannot + * be a dash. * * Generated from protobuf field optional string name = 3373707; * @return string @@ -519,7 +578,13 @@ public function clearName() } /** - * Name of the resource; provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource; provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must be + * a dash, lowercase letter, or digit, except the last character, which cannot + * be a dash. * * Generated from protobuf field optional string name = 3373707; * @param string $var @@ -534,7 +599,8 @@ public function setName($var) } /** - * The URL of the network to which all network endpoints in the NEG belong. Uses default project network if unspecified. + * The URL of the network to which all network endpoints in the NEG belong. + * Uses default project network if unspecified. * * Generated from protobuf field optional string network = 232872494; * @return string @@ -555,7 +621,8 @@ public function clearNetwork() } /** - * The URL of the network to which all network endpoints in the NEG belong. Uses default project network if unspecified. + * The URL of the network to which all network endpoints in the NEG belong. + * Uses default project network if unspecified. * * Generated from protobuf field optional string network = 232872494; * @param string $var @@ -570,7 +637,7 @@ public function setNetwork($var) } /** - * Type of network endpoints in this network endpoint group. Can be one of GCE_VM_IP, GCE_VM_IP_PORT, NON_GCP_PRIVATE_IP_PORT, INTERNET_FQDN_PORT, INTERNET_IP_PORT, SERVERLESS, PRIVATE_SERVICE_CONNECT, GCE_VM_IP_PORTMAP. + * Type of network endpoints in this network endpoint group. Can be one ofGCE_VM_IP, GCE_VM_IP_PORT,NON_GCP_PRIVATE_IP_PORT, INTERNET_FQDN_PORT,INTERNET_IP_PORT, SERVERLESS,PRIVATE_SERVICE_CONNECT, GCE_VM_IP_PORTMAP. * Check the NetworkEndpointType enum for the list of possible values. * * Generated from protobuf field optional string network_endpoint_type = 118301523; @@ -592,7 +659,7 @@ public function clearNetworkEndpointType() } /** - * Type of network endpoints in this network endpoint group. Can be one of GCE_VM_IP, GCE_VM_IP_PORT, NON_GCP_PRIVATE_IP_PORT, INTERNET_FQDN_PORT, INTERNET_IP_PORT, SERVERLESS, PRIVATE_SERVICE_CONNECT, GCE_VM_IP_PORTMAP. + * Type of network endpoints in this network endpoint group. Can be one ofGCE_VM_IP, GCE_VM_IP_PORT,NON_GCP_PRIVATE_IP_PORT, INTERNET_FQDN_PORT,INTERNET_IP_PORT, SERVERLESS,PRIVATE_SERVICE_CONNECT, GCE_VM_IP_PORTMAP. * Check the NetworkEndpointType enum for the list of possible values. * * Generated from protobuf field optional string network_endpoint_type = 118301523; @@ -608,7 +675,7 @@ public function setNetworkEndpointType($var) } /** - * Optional. Only valid when networkEndpointType is PRIVATE_SERVICE_CONNECT. + * Optional. Only valid when networkEndpointType isPRIVATE_SERVICE_CONNECT. * * Generated from protobuf field optional .google.cloud.compute.v1.NetworkEndpointGroupPscData psc_data = 71937481; * @return \Google\Cloud\Compute\V1\NetworkEndpointGroupPscData|null @@ -629,7 +696,7 @@ public function clearPscData() } /** - * Optional. Only valid when networkEndpointType is PRIVATE_SERVICE_CONNECT. + * Optional. Only valid when networkEndpointType isPRIVATE_SERVICE_CONNECT. * * Generated from protobuf field optional .google.cloud.compute.v1.NetworkEndpointGroupPscData psc_data = 71937481; * @param \Google\Cloud\Compute\V1\NetworkEndpointGroupPscData $var @@ -644,7 +711,10 @@ public function setPscData($var) } /** - * The target service url used to set up private service connection to a Google API or a PSC Producer Service Attachment. An example value is: asia-northeast3-cloudkms.googleapis.com. Optional. Only valid when networkEndpointType is PRIVATE_SERVICE_CONNECT. + * The target service url used to set up private service connection to + * a Google API or a PSC Producer Service Attachment. + * An example value is: asia-northeast3-cloudkms.googleapis.com. + * Optional. Only valid when networkEndpointType isPRIVATE_SERVICE_CONNECT. * * Generated from protobuf field optional string psc_target_service = 269132134; * @return string @@ -665,7 +735,10 @@ public function clearPscTargetService() } /** - * The target service url used to set up private service connection to a Google API or a PSC Producer Service Attachment. An example value is: asia-northeast3-cloudkms.googleapis.com. Optional. Only valid when networkEndpointType is PRIVATE_SERVICE_CONNECT. + * The target service url used to set up private service connection to + * a Google API or a PSC Producer Service Attachment. + * An example value is: asia-northeast3-cloudkms.googleapis.com. + * Optional. Only valid when networkEndpointType isPRIVATE_SERVICE_CONNECT. * * Generated from protobuf field optional string psc_target_service = 269132134; * @param string $var @@ -680,7 +753,8 @@ public function setPscTargetService($var) } /** - * [Output Only] The URL of the region where the network endpoint group is located. + * [Output Only] The URL of theregion + * where the network endpoint group is located. * * Generated from protobuf field optional string region = 138946292; * @return string @@ -701,7 +775,8 @@ public function clearRegion() } /** - * [Output Only] The URL of the region where the network endpoint group is located. + * [Output Only] The URL of theregion + * where the network endpoint group is located. * * Generated from protobuf field optional string region = 138946292; * @param string $var @@ -788,7 +863,8 @@ public function setSize($var) } /** - * Optional URL of the subnetwork to which all network endpoints in the NEG belong. + * Optional URL of the subnetwork to which all network endpoints in the NEG + * belong. * * Generated from protobuf field optional string subnetwork = 307827694; * @return string @@ -809,7 +885,8 @@ public function clearSubnetwork() } /** - * Optional URL of the subnetwork to which all network endpoints in the NEG belong. + * Optional URL of the subnetwork to which all network endpoints in the NEG + * belong. * * Generated from protobuf field optional string subnetwork = 307827694; * @param string $var @@ -824,7 +901,8 @@ public function setSubnetwork($var) } /** - * [Output Only] The URL of the zone where the network endpoint group is located. + * [Output Only] The URL of thezone + * where the network endpoint group is located. * * Generated from protobuf field optional string zone = 3744684; * @return string @@ -845,7 +923,8 @@ public function clearZone() } /** - * [Output Only] The URL of the zone where the network endpoint group is located. + * [Output Only] The URL of thezone + * where the network endpoint group is located. * * Generated from protobuf field optional string zone = 3744684; * @param string $var diff --git a/Compute/src/V1/NetworkEndpointGroup/NetworkEndpointType.php b/Compute/src/V1/NetworkEndpointGroup/NetworkEndpointType.php index 00265a011ce7..5449e8f7c084 100644 --- a/Compute/src/V1/NetworkEndpointGroup/NetworkEndpointType.php +++ b/Compute/src/V1/NetworkEndpointGroup/NetworkEndpointType.php @@ -7,7 +7,7 @@ use UnexpectedValueException; /** - * Type of network endpoints in this network endpoint group. Can be one of GCE_VM_IP, GCE_VM_IP_PORT, NON_GCP_PRIVATE_IP_PORT, INTERNET_FQDN_PORT, INTERNET_IP_PORT, SERVERLESS, PRIVATE_SERVICE_CONNECT, GCE_VM_IP_PORTMAP. + * Type of network endpoints in this network endpoint group. Can be one ofGCE_VM_IP, GCE_VM_IP_PORT,NON_GCP_PRIVATE_IP_PORT, INTERNET_FQDN_PORT,INTERNET_IP_PORT, SERVERLESS,PRIVATE_SERVICE_CONNECT, GCE_VM_IP_PORTMAP. * * Protobuf type google.cloud.compute.v1.NetworkEndpointGroup.NetworkEndpointType */ @@ -32,13 +32,15 @@ class NetworkEndpointType */ const GCE_VM_IP_PORT = 501838375; /** - * The network endpoint is represented by an IP, Port and Client Destination Port. + * The network endpoint is represented by an IP, Port and Client Destination + * Port. * * Generated from protobuf enum GCE_VM_IP_PORTMAP = 22819253; */ const GCE_VM_IP_PORTMAP = 22819253; /** - * The network endpoint is represented by fully qualified domain name and port. + * The network endpoint is represented by fully qualified domain name and + * port. * * Generated from protobuf enum INTERNET_FQDN_PORT = 404154477; */ @@ -50,13 +52,16 @@ class NetworkEndpointType */ const INTERNET_IP_PORT = 477719963; /** - * The network endpoint is represented by an IP address and port. The endpoint belongs to a VM or pod running in a customer's on-premises. + * The network endpoint is represented by an IP address and port. The + * endpoint belongs to a VM or pod running in a customer's on-premises. * * Generated from protobuf enum NON_GCP_PRIVATE_IP_PORT = 336447968; */ const NON_GCP_PRIVATE_IP_PORT = 336447968; /** - * The network endpoint is either public Google APIs or services exposed by other GCP Project with a Service Attachment. The connection is set up by private service connect + * The network endpoint is either public Google APIs or + * services exposed by other GCP Project with a Service Attachment. + * The connection is set up by private service connect * * Generated from protobuf enum PRIVATE_SERVICE_CONNECT = 48134724; */ diff --git a/Compute/src/V1/NetworkEndpointGroupAggregatedList.php b/Compute/src/V1/NetworkEndpointGroupAggregatedList.php index 6d7180bffd41..91efdc921efd 100644 --- a/Compute/src/V1/NetworkEndpointGroupAggregatedList.php +++ b/Compute/src/V1/NetworkEndpointGroupAggregatedList.php @@ -27,13 +27,18 @@ class NetworkEndpointGroupAggregatedList extends \Google\Protobuf\Internal\Messa */ private $items; /** - * [Output Only] The resource type, which is always compute#networkEndpointGroupAggregatedList for aggregated lists of network endpoint groups. + * [Output Only] The resource type, which is alwayscompute#networkEndpointGroupAggregatedList for aggregated + * lists of network endpoint groups. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -68,9 +73,14 @@ class NetworkEndpointGroupAggregatedList extends \Google\Protobuf\Internal\Messa * @type array|\Google\Protobuf\Internal\MapField $items * A list of NetworkEndpointGroupsScopedList resources. * @type string $kind - * [Output Only] The resource type, which is always compute#networkEndpointGroupAggregatedList for aggregated lists of network endpoint groups. + * [Output Only] The resource type, which is alwayscompute#networkEndpointGroupAggregatedList for aggregated + * lists of network endpoint groups. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type array|\Google\Protobuf\Internal\RepeatedField $unreachables @@ -147,7 +157,8 @@ public function setItems($var) } /** - * [Output Only] The resource type, which is always compute#networkEndpointGroupAggregatedList for aggregated lists of network endpoint groups. + * [Output Only] The resource type, which is alwayscompute#networkEndpointGroupAggregatedList for aggregated + * lists of network endpoint groups. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -168,7 +179,8 @@ public function clearKind() } /** - * [Output Only] The resource type, which is always compute#networkEndpointGroupAggregatedList for aggregated lists of network endpoint groups. + * [Output Only] The resource type, which is alwayscompute#networkEndpointGroupAggregatedList for aggregated + * lists of network endpoint groups. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -183,7 +195,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -204,7 +220,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/NetworkEndpointGroupAppEngine.php b/Compute/src/V1/NetworkEndpointGroupAppEngine.php index c7181f4917fe..73f22e2bb4c8 100644 --- a/Compute/src/V1/NetworkEndpointGroupAppEngine.php +++ b/Compute/src/V1/NetworkEndpointGroupAppEngine.php @@ -9,26 +9,47 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Configuration for an App Engine network endpoint group (NEG). The service is optional, may be provided explicitly or in the URL mask. The version is optional and can only be provided explicitly or in the URL mask when service is present. Note: App Engine service must be in the same project and located in the same region as the Serverless NEG. + * Configuration for an App Engine network endpoint group (NEG). + * The service is optional, may be provided explicitly or in the + * URL mask. The version is optional and can only be provided + * explicitly or in the URL mask when service is present. + * Note: App Engine service must be in the same project and located in the + * same region as the Serverless NEG. * * Generated from protobuf message google.cloud.compute.v1.NetworkEndpointGroupAppEngine */ class NetworkEndpointGroupAppEngine extends \Google\Protobuf\Internal\Message { /** - * Optional serving service. The service name is case-sensitive and must be 1-63 characters long. Example value: default, my-service. + * Optional serving service. + * The service name is case-sensitive and must be 1-63 + * characters long. + * Example value: default, my-service. * * Generated from protobuf field optional string service = 373540533; */ protected $service = null; /** - * An URL mask is one of the main components of the Cloud Function. A template to parse service and version fields from a request URL. URL mask allows for routing to multiple App Engine services without having to create multiple Network Endpoint Groups and backend services. For example, the request URLs foo1-dot-appname.appspot.com/v1 and foo1-dot-appname.appspot.com/v2 can be backed by the same Serverless NEG with URL mask -dot-appname.appspot.com/. The URL mask will parse them to { service = "foo1", version = "v1" } and { service = "foo1", version = "v2" } respectively. + * An URL + * mask is one of the main components of the Cloud Function. + * A template to parse service and version fields + * from a request URL. URL mask allows for routing to multiple App Engine + * services without having to create multiple Network Endpoint Groups and + * backend services. + * For example, the request URLsfoo1-dot-appname.appspot.com/v1 andfoo1-dot-appname.appspot.com/v2 can be backed by the same + * Serverless NEG with URL mask-dot-appname.appspot.com/. + * The URL mask will parse them to { service = "foo1", version = "v1" + * } and { service = "foo1", version = "v2" } + * respectively. * * Generated from protobuf field optional string url_mask = 103352252; */ protected $url_mask = null; /** - * Optional serving version. The version name is case-sensitive and must be 1-100 characters long. Example value: v1, v2. + * Optional serving version. + * The version name is case-sensitive and must be 1-100 + * characters long. + * Example value: v1, v2. * * Generated from protobuf field optional string version = 351608024; */ @@ -41,11 +62,27 @@ class NetworkEndpointGroupAppEngine extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $service - * Optional serving service. The service name is case-sensitive and must be 1-63 characters long. Example value: default, my-service. + * Optional serving service. + * The service name is case-sensitive and must be 1-63 + * characters long. + * Example value: default, my-service. * @type string $url_mask - * An URL mask is one of the main components of the Cloud Function. A template to parse service and version fields from a request URL. URL mask allows for routing to multiple App Engine services without having to create multiple Network Endpoint Groups and backend services. For example, the request URLs foo1-dot-appname.appspot.com/v1 and foo1-dot-appname.appspot.com/v2 can be backed by the same Serverless NEG with URL mask -dot-appname.appspot.com/. The URL mask will parse them to { service = "foo1", version = "v1" } and { service = "foo1", version = "v2" } respectively. + * An URL + * mask is one of the main components of the Cloud Function. + * A template to parse service and version fields + * from a request URL. URL mask allows for routing to multiple App Engine + * services without having to create multiple Network Endpoint Groups and + * backend services. + * For example, the request URLsfoo1-dot-appname.appspot.com/v1 andfoo1-dot-appname.appspot.com/v2 can be backed by the same + * Serverless NEG with URL mask-dot-appname.appspot.com/. + * The URL mask will parse them to { service = "foo1", version = "v1" + * } and { service = "foo1", version = "v2" } + * respectively. * @type string $version - * Optional serving version. The version name is case-sensitive and must be 1-100 characters long. Example value: v1, v2. + * Optional serving version. + * The version name is case-sensitive and must be 1-100 + * characters long. + * Example value: v1, v2. * } */ public function __construct($data = NULL) { @@ -54,7 +91,10 @@ public function __construct($data = NULL) { } /** - * Optional serving service. The service name is case-sensitive and must be 1-63 characters long. Example value: default, my-service. + * Optional serving service. + * The service name is case-sensitive and must be 1-63 + * characters long. + * Example value: default, my-service. * * Generated from protobuf field optional string service = 373540533; * @return string @@ -75,7 +115,10 @@ public function clearService() } /** - * Optional serving service. The service name is case-sensitive and must be 1-63 characters long. Example value: default, my-service. + * Optional serving service. + * The service name is case-sensitive and must be 1-63 + * characters long. + * Example value: default, my-service. * * Generated from protobuf field optional string service = 373540533; * @param string $var @@ -90,7 +133,17 @@ public function setService($var) } /** - * An URL mask is one of the main components of the Cloud Function. A template to parse service and version fields from a request URL. URL mask allows for routing to multiple App Engine services without having to create multiple Network Endpoint Groups and backend services. For example, the request URLs foo1-dot-appname.appspot.com/v1 and foo1-dot-appname.appspot.com/v2 can be backed by the same Serverless NEG with URL mask -dot-appname.appspot.com/. The URL mask will parse them to { service = "foo1", version = "v1" } and { service = "foo1", version = "v2" } respectively. + * An URL + * mask is one of the main components of the Cloud Function. + * A template to parse service and version fields + * from a request URL. URL mask allows for routing to multiple App Engine + * services without having to create multiple Network Endpoint Groups and + * backend services. + * For example, the request URLsfoo1-dot-appname.appspot.com/v1 andfoo1-dot-appname.appspot.com/v2 can be backed by the same + * Serverless NEG with URL mask-dot-appname.appspot.com/. + * The URL mask will parse them to { service = "foo1", version = "v1" + * } and { service = "foo1", version = "v2" } + * respectively. * * Generated from protobuf field optional string url_mask = 103352252; * @return string @@ -111,7 +164,17 @@ public function clearUrlMask() } /** - * An URL mask is one of the main components of the Cloud Function. A template to parse service and version fields from a request URL. URL mask allows for routing to multiple App Engine services without having to create multiple Network Endpoint Groups and backend services. For example, the request URLs foo1-dot-appname.appspot.com/v1 and foo1-dot-appname.appspot.com/v2 can be backed by the same Serverless NEG with URL mask -dot-appname.appspot.com/. The URL mask will parse them to { service = "foo1", version = "v1" } and { service = "foo1", version = "v2" } respectively. + * An URL + * mask is one of the main components of the Cloud Function. + * A template to parse service and version fields + * from a request URL. URL mask allows for routing to multiple App Engine + * services without having to create multiple Network Endpoint Groups and + * backend services. + * For example, the request URLsfoo1-dot-appname.appspot.com/v1 andfoo1-dot-appname.appspot.com/v2 can be backed by the same + * Serverless NEG with URL mask-dot-appname.appspot.com/. + * The URL mask will parse them to { service = "foo1", version = "v1" + * } and { service = "foo1", version = "v2" } + * respectively. * * Generated from protobuf field optional string url_mask = 103352252; * @param string $var @@ -126,7 +189,10 @@ public function setUrlMask($var) } /** - * Optional serving version. The version name is case-sensitive and must be 1-100 characters long. Example value: v1, v2. + * Optional serving version. + * The version name is case-sensitive and must be 1-100 + * characters long. + * Example value: v1, v2. * * Generated from protobuf field optional string version = 351608024; * @return string @@ -147,7 +213,10 @@ public function clearVersion() } /** - * Optional serving version. The version name is case-sensitive and must be 1-100 characters long. Example value: v1, v2. + * Optional serving version. + * The version name is case-sensitive and must be 1-100 + * characters long. + * Example value: v1, v2. * * Generated from protobuf field optional string version = 351608024; * @param string $var diff --git a/Compute/src/V1/NetworkEndpointGroupCloudFunction.php b/Compute/src/V1/NetworkEndpointGroupCloudFunction.php index 1114f19c43e7..74707a0f6195 100644 --- a/Compute/src/V1/NetworkEndpointGroupCloudFunction.php +++ b/Compute/src/V1/NetworkEndpointGroupCloudFunction.php @@ -9,20 +9,33 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Configuration for a Cloud Function network endpoint group (NEG). The function must be provided explicitly or in the URL mask. Note: Cloud Function must be in the same project and located in the same region as the Serverless NEG. + * Configuration for a Cloud Function network endpoint group (NEG). + * The function must be provided explicitly or in the URL mask. + * Note: Cloud Function must be in the same project and located in the same + * region as the Serverless NEG. * * Generated from protobuf message google.cloud.compute.v1.NetworkEndpointGroupCloudFunction */ class NetworkEndpointGroupCloudFunction extends \Google\Protobuf\Internal\Message { /** - * A user-defined name of the Cloud Function. The function name is case-sensitive and must be 1-63 characters long. Example value: func1. + * A user-defined name of the Cloud Function. + * The function name is case-sensitive and must be 1-63 + * characters long. + * Example value: func1. * * Generated from protobuf field optional string function = 307196888; */ protected $function = null; /** - * An URL mask is one of the main components of the Cloud Function. A template to parse function field from a request URL. URL mask allows for routing to multiple Cloud Functions without having to create multiple Network Endpoint Groups and backend services. For example, request URLs mydomain.com/function1 and mydomain.com/function2 can be backed by the same Serverless NEG with URL mask /. The URL mask will parse them to { function = "function1" } and { function = "function2" } respectively. + * An URL + * mask is one of the main components of the Cloud Function. + * A template to parse function field from a request URL. URL + * mask allows for routing to multiple Cloud Functions without having to + * create multiple Network Endpoint Groups and backend services. + * For example, request URLs mydomain.com/function1 andmydomain.com/function2 can be backed by the same + * Serverless NEG with URL mask /. The URL + * mask will parse them to { function = "function1" } and{ function = "function2" } respectively. * * Generated from protobuf field optional string url_mask = 103352252; */ @@ -35,9 +48,19 @@ class NetworkEndpointGroupCloudFunction extends \Google\Protobuf\Internal\Messag * Optional. Data for populating the Message object. * * @type string $function - * A user-defined name of the Cloud Function. The function name is case-sensitive and must be 1-63 characters long. Example value: func1. + * A user-defined name of the Cloud Function. + * The function name is case-sensitive and must be 1-63 + * characters long. + * Example value: func1. * @type string $url_mask - * An URL mask is one of the main components of the Cloud Function. A template to parse function field from a request URL. URL mask allows for routing to multiple Cloud Functions without having to create multiple Network Endpoint Groups and backend services. For example, request URLs mydomain.com/function1 and mydomain.com/function2 can be backed by the same Serverless NEG with URL mask /. The URL mask will parse them to { function = "function1" } and { function = "function2" } respectively. + * An URL + * mask is one of the main components of the Cloud Function. + * A template to parse function field from a request URL. URL + * mask allows for routing to multiple Cloud Functions without having to + * create multiple Network Endpoint Groups and backend services. + * For example, request URLs mydomain.com/function1 andmydomain.com/function2 can be backed by the same + * Serverless NEG with URL mask /. The URL + * mask will parse them to { function = "function1" } and{ function = "function2" } respectively. * } */ public function __construct($data = NULL) { @@ -46,7 +69,10 @@ public function __construct($data = NULL) { } /** - * A user-defined name of the Cloud Function. The function name is case-sensitive and must be 1-63 characters long. Example value: func1. + * A user-defined name of the Cloud Function. + * The function name is case-sensitive and must be 1-63 + * characters long. + * Example value: func1. * * Generated from protobuf field optional string function = 307196888; * @return string @@ -67,7 +93,10 @@ public function clearFunction() } /** - * A user-defined name of the Cloud Function. The function name is case-sensitive and must be 1-63 characters long. Example value: func1. + * A user-defined name of the Cloud Function. + * The function name is case-sensitive and must be 1-63 + * characters long. + * Example value: func1. * * Generated from protobuf field optional string function = 307196888; * @param string $var @@ -82,7 +111,14 @@ public function setFunction($var) } /** - * An URL mask is one of the main components of the Cloud Function. A template to parse function field from a request URL. URL mask allows for routing to multiple Cloud Functions without having to create multiple Network Endpoint Groups and backend services. For example, request URLs mydomain.com/function1 and mydomain.com/function2 can be backed by the same Serverless NEG with URL mask /. The URL mask will parse them to { function = "function1" } and { function = "function2" } respectively. + * An URL + * mask is one of the main components of the Cloud Function. + * A template to parse function field from a request URL. URL + * mask allows for routing to multiple Cloud Functions without having to + * create multiple Network Endpoint Groups and backend services. + * For example, request URLs mydomain.com/function1 andmydomain.com/function2 can be backed by the same + * Serverless NEG with URL mask /. The URL + * mask will parse them to { function = "function1" } and{ function = "function2" } respectively. * * Generated from protobuf field optional string url_mask = 103352252; * @return string @@ -103,7 +139,14 @@ public function clearUrlMask() } /** - * An URL mask is one of the main components of the Cloud Function. A template to parse function field from a request URL. URL mask allows for routing to multiple Cloud Functions without having to create multiple Network Endpoint Groups and backend services. For example, request URLs mydomain.com/function1 and mydomain.com/function2 can be backed by the same Serverless NEG with URL mask /. The URL mask will parse them to { function = "function1" } and { function = "function2" } respectively. + * An URL + * mask is one of the main components of the Cloud Function. + * A template to parse function field from a request URL. URL + * mask allows for routing to multiple Cloud Functions without having to + * create multiple Network Endpoint Groups and backend services. + * For example, request URLs mydomain.com/function1 andmydomain.com/function2 can be backed by the same + * Serverless NEG with URL mask /. The URL + * mask will parse them to { function = "function1" } and{ function = "function2" } respectively. * * Generated from protobuf field optional string url_mask = 103352252; * @param string $var diff --git a/Compute/src/V1/NetworkEndpointGroupCloudRun.php b/Compute/src/V1/NetworkEndpointGroupCloudRun.php index d6cb2ea5e6d2..a607c89c3b7d 100644 --- a/Compute/src/V1/NetworkEndpointGroupCloudRun.php +++ b/Compute/src/V1/NetworkEndpointGroupCloudRun.php @@ -9,26 +9,44 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Configuration for a Cloud Run network endpoint group (NEG). The service must be provided explicitly or in the URL mask. The tag is optional, may be provided explicitly or in the URL mask. Note: Cloud Run service must be in the same project and located in the same region as the Serverless NEG. + * Configuration for a Cloud Run network endpoint group (NEG). + * The service must be provided explicitly or in the URL mask. + * The tag is optional, may be provided explicitly or in the URL + * mask. + * Note: Cloud Run service must be in the same project and located in the same + * region as the Serverless NEG. * * Generated from protobuf message google.cloud.compute.v1.NetworkEndpointGroupCloudRun */ class NetworkEndpointGroupCloudRun extends \Google\Protobuf\Internal\Message { /** - * Cloud Run service is the main resource of Cloud Run. The service must be 1-63 characters long, and comply with RFC1035. Example value: "run-service". + * Cloud Run service is the main resource of Cloud Run. + * The service must be 1-63 characters long, and comply withRFC1035. + * Example value: "run-service". * * Generated from protobuf field optional string service = 373540533; */ protected $service = null; /** - * Optional Cloud Run tag represents the "named-revision" to provide additional fine-grained traffic routing information. The tag must be 1-63 characters long, and comply with RFC1035. Example value: "revision-0010". + * Optional Cloud Run tag represents the "named-revision" to provide additional + * fine-grained traffic routing information. + * The tag must be 1-63 characters long, and comply withRFC1035. + * Example value: "revision-0010". * * Generated from protobuf field optional string tag = 114586; */ protected $tag = null; /** - * An URL mask is one of the main components of the Cloud Function. A template to parse and fields from a request URL. URL mask allows for routing to multiple Run services without having to create multiple network endpoint groups and backend services. For example, request URLs foo1.domain.com/bar1 and foo1.domain.com/bar2 can be backed by the same Serverless Network Endpoint Group (NEG) with URL mask .domain.com/. The URL mask will parse them to { service="bar1", tag="foo1" } and { service="bar2", tag="foo2" } respectively. + * An URL + * mask is one of the main components of the Cloud Function. + * A template to parse and fields from a request URL. URL mask allows for + * routing to multiple Run services without having to create multiple + * network endpoint groups and backend services. + * For example, request URLs foo1.domain.com/bar1 andfoo1.domain.com/bar2 can be backed by the same Serverless + * Network Endpoint Group (NEG) with URL mask.domain.com/. The URL mask will + * parse them to { service="bar1", tag="foo1" } and { + * service="bar2", tag="foo2" } respectively. * * Generated from protobuf field optional string url_mask = 103352252; */ @@ -41,11 +59,24 @@ class NetworkEndpointGroupCloudRun extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $service - * Cloud Run service is the main resource of Cloud Run. The service must be 1-63 characters long, and comply with RFC1035. Example value: "run-service". + * Cloud Run service is the main resource of Cloud Run. + * The service must be 1-63 characters long, and comply withRFC1035. + * Example value: "run-service". * @type string $tag - * Optional Cloud Run tag represents the "named-revision" to provide additional fine-grained traffic routing information. The tag must be 1-63 characters long, and comply with RFC1035. Example value: "revision-0010". + * Optional Cloud Run tag represents the "named-revision" to provide additional + * fine-grained traffic routing information. + * The tag must be 1-63 characters long, and comply withRFC1035. + * Example value: "revision-0010". * @type string $url_mask - * An URL mask is one of the main components of the Cloud Function. A template to parse and fields from a request URL. URL mask allows for routing to multiple Run services without having to create multiple network endpoint groups and backend services. For example, request URLs foo1.domain.com/bar1 and foo1.domain.com/bar2 can be backed by the same Serverless Network Endpoint Group (NEG) with URL mask .domain.com/. The URL mask will parse them to { service="bar1", tag="foo1" } and { service="bar2", tag="foo2" } respectively. + * An URL + * mask is one of the main components of the Cloud Function. + * A template to parse and fields from a request URL. URL mask allows for + * routing to multiple Run services without having to create multiple + * network endpoint groups and backend services. + * For example, request URLs foo1.domain.com/bar1 andfoo1.domain.com/bar2 can be backed by the same Serverless + * Network Endpoint Group (NEG) with URL mask.domain.com/. The URL mask will + * parse them to { service="bar1", tag="foo1" } and { + * service="bar2", tag="foo2" } respectively. * } */ public function __construct($data = NULL) { @@ -54,7 +85,9 @@ public function __construct($data = NULL) { } /** - * Cloud Run service is the main resource of Cloud Run. The service must be 1-63 characters long, and comply with RFC1035. Example value: "run-service". + * Cloud Run service is the main resource of Cloud Run. + * The service must be 1-63 characters long, and comply withRFC1035. + * Example value: "run-service". * * Generated from protobuf field optional string service = 373540533; * @return string @@ -75,7 +108,9 @@ public function clearService() } /** - * Cloud Run service is the main resource of Cloud Run. The service must be 1-63 characters long, and comply with RFC1035. Example value: "run-service". + * Cloud Run service is the main resource of Cloud Run. + * The service must be 1-63 characters long, and comply withRFC1035. + * Example value: "run-service". * * Generated from protobuf field optional string service = 373540533; * @param string $var @@ -90,7 +125,10 @@ public function setService($var) } /** - * Optional Cloud Run tag represents the "named-revision" to provide additional fine-grained traffic routing information. The tag must be 1-63 characters long, and comply with RFC1035. Example value: "revision-0010". + * Optional Cloud Run tag represents the "named-revision" to provide additional + * fine-grained traffic routing information. + * The tag must be 1-63 characters long, and comply withRFC1035. + * Example value: "revision-0010". * * Generated from protobuf field optional string tag = 114586; * @return string @@ -111,7 +149,10 @@ public function clearTag() } /** - * Optional Cloud Run tag represents the "named-revision" to provide additional fine-grained traffic routing information. The tag must be 1-63 characters long, and comply with RFC1035. Example value: "revision-0010". + * Optional Cloud Run tag represents the "named-revision" to provide additional + * fine-grained traffic routing information. + * The tag must be 1-63 characters long, and comply withRFC1035. + * Example value: "revision-0010". * * Generated from protobuf field optional string tag = 114586; * @param string $var @@ -126,7 +167,15 @@ public function setTag($var) } /** - * An URL mask is one of the main components of the Cloud Function. A template to parse and fields from a request URL. URL mask allows for routing to multiple Run services without having to create multiple network endpoint groups and backend services. For example, request URLs foo1.domain.com/bar1 and foo1.domain.com/bar2 can be backed by the same Serverless Network Endpoint Group (NEG) with URL mask .domain.com/. The URL mask will parse them to { service="bar1", tag="foo1" } and { service="bar2", tag="foo2" } respectively. + * An URL + * mask is one of the main components of the Cloud Function. + * A template to parse and fields from a request URL. URL mask allows for + * routing to multiple Run services without having to create multiple + * network endpoint groups and backend services. + * For example, request URLs foo1.domain.com/bar1 andfoo1.domain.com/bar2 can be backed by the same Serverless + * Network Endpoint Group (NEG) with URL mask.domain.com/. The URL mask will + * parse them to { service="bar1", tag="foo1" } and { + * service="bar2", tag="foo2" } respectively. * * Generated from protobuf field optional string url_mask = 103352252; * @return string @@ -147,7 +196,15 @@ public function clearUrlMask() } /** - * An URL mask is one of the main components of the Cloud Function. A template to parse and fields from a request URL. URL mask allows for routing to multiple Run services without having to create multiple network endpoint groups and backend services. For example, request URLs foo1.domain.com/bar1 and foo1.domain.com/bar2 can be backed by the same Serverless Network Endpoint Group (NEG) with URL mask .domain.com/. The URL mask will parse them to { service="bar1", tag="foo1" } and { service="bar2", tag="foo2" } respectively. + * An URL + * mask is one of the main components of the Cloud Function. + * A template to parse and fields from a request URL. URL mask allows for + * routing to multiple Run services without having to create multiple + * network endpoint groups and backend services. + * For example, request URLs foo1.domain.com/bar1 andfoo1.domain.com/bar2 can be backed by the same Serverless + * Network Endpoint Group (NEG) with URL mask.domain.com/. The URL mask will + * parse them to { service="bar1", tag="foo1" } and { + * service="bar2", tag="foo2" } respectively. * * Generated from protobuf field optional string url_mask = 103352252; * @param string $var diff --git a/Compute/src/V1/NetworkEndpointGroupList.php b/Compute/src/V1/NetworkEndpointGroupList.php index b5d0a1597be7..8737b82a576f 100644 --- a/Compute/src/V1/NetworkEndpointGroupList.php +++ b/Compute/src/V1/NetworkEndpointGroupList.php @@ -27,13 +27,18 @@ class NetworkEndpointGroupList extends \Google\Protobuf\Internal\Message */ private $items; /** - * [Output Only] The resource type, which is always compute#networkEndpointGroupList for network endpoint group lists. + * [Output Only] The resource type, which is alwayscompute#networkEndpointGroupList for network endpoint group + * lists. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -62,9 +67,14 @@ class NetworkEndpointGroupList extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\NetworkEndpointGroup>|\Google\Protobuf\Internal\RepeatedField $items * A list of NetworkEndpointGroup resources. * @type string $kind - * [Output Only] The resource type, which is always compute#networkEndpointGroupList for network endpoint group lists. + * [Output Only] The resource type, which is alwayscompute#networkEndpointGroupList for network endpoint group + * lists. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type \Google\Cloud\Compute\V1\Warning $warning @@ -139,7 +149,8 @@ public function setItems($var) } /** - * [Output Only] The resource type, which is always compute#networkEndpointGroupList for network endpoint group lists. + * [Output Only] The resource type, which is alwayscompute#networkEndpointGroupList for network endpoint group + * lists. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -160,7 +171,8 @@ public function clearKind() } /** - * [Output Only] The resource type, which is always compute#networkEndpointGroupList for network endpoint group lists. + * [Output Only] The resource type, which is alwayscompute#networkEndpointGroupList for network endpoint group + * lists. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -175,7 +187,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -196,7 +212,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/NetworkEndpointGroupPscData.php b/Compute/src/V1/NetworkEndpointGroupPscData.php index ce05b8f2ab25..6df1547fc927 100644 --- a/Compute/src/V1/NetworkEndpointGroupPscData.php +++ b/Compute/src/V1/NetworkEndpointGroupPscData.php @@ -9,26 +9,32 @@ use Google\Protobuf\Internal\GPBUtil; /** - * All data that is specifically relevant to only network endpoint groups of type PRIVATE_SERVICE_CONNECT. + * All data that is specifically relevant to only network endpoint groups of + * type PRIVATE_SERVICE_CONNECT. * * Generated from protobuf message google.cloud.compute.v1.NetworkEndpointGroupPscData */ class NetworkEndpointGroupPscData extends \Google\Protobuf\Internal\Message { /** - * [Output Only] Address allocated from given subnetwork for PSC. This IP address acts as a VIP for a PSC NEG, allowing it to act as an endpoint in L7 PSC-XLB. + * [Output Only] Address allocated from given subnetwork for PSC. This IP + * address acts as a VIP for a PSC NEG, allowing it to act as an endpoint in + * L7 PSC-XLB. * * Generated from protobuf field optional string consumer_psc_address = 452646572; */ protected $consumer_psc_address = null; /** - * The psc producer port is used to connect PSC NEG with specific port on the PSC Producer side; should only be used for the PRIVATE_SERVICE_CONNECT NEG type + * The psc producer port is used to connect PSC NEG with specific port on + * the PSC Producer side; should only be used for the + * PRIVATE_SERVICE_CONNECT NEG type * * Generated from protobuf field optional int32 producer_port = 410021134; */ protected $producer_port = null; /** - * [Output Only] The PSC connection id of the PSC Network Endpoint Group Consumer. + * [Output Only] The PSC connection id of the PSC Network Endpoint Group + * Consumer. * * Generated from protobuf field optional uint64 psc_connection_id = 292082397; */ @@ -48,11 +54,16 @@ class NetworkEndpointGroupPscData extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $consumer_psc_address - * [Output Only] Address allocated from given subnetwork for PSC. This IP address acts as a VIP for a PSC NEG, allowing it to act as an endpoint in L7 PSC-XLB. + * [Output Only] Address allocated from given subnetwork for PSC. This IP + * address acts as a VIP for a PSC NEG, allowing it to act as an endpoint in + * L7 PSC-XLB. * @type int $producer_port - * The psc producer port is used to connect PSC NEG with specific port on the PSC Producer side; should only be used for the PRIVATE_SERVICE_CONNECT NEG type + * The psc producer port is used to connect PSC NEG with specific port on + * the PSC Producer side; should only be used for the + * PRIVATE_SERVICE_CONNECT NEG type * @type int|string $psc_connection_id - * [Output Only] The PSC connection id of the PSC Network Endpoint Group Consumer. + * [Output Only] The PSC connection id of the PSC Network Endpoint Group + * Consumer. * @type string $psc_connection_status * [Output Only] The connection status of the PSC Forwarding Rule. * Check the PscConnectionStatus enum for the list of possible values. @@ -64,7 +75,9 @@ public function __construct($data = NULL) { } /** - * [Output Only] Address allocated from given subnetwork for PSC. This IP address acts as a VIP for a PSC NEG, allowing it to act as an endpoint in L7 PSC-XLB. + * [Output Only] Address allocated from given subnetwork for PSC. This IP + * address acts as a VIP for a PSC NEG, allowing it to act as an endpoint in + * L7 PSC-XLB. * * Generated from protobuf field optional string consumer_psc_address = 452646572; * @return string @@ -85,7 +98,9 @@ public function clearConsumerPscAddress() } /** - * [Output Only] Address allocated from given subnetwork for PSC. This IP address acts as a VIP for a PSC NEG, allowing it to act as an endpoint in L7 PSC-XLB. + * [Output Only] Address allocated from given subnetwork for PSC. This IP + * address acts as a VIP for a PSC NEG, allowing it to act as an endpoint in + * L7 PSC-XLB. * * Generated from protobuf field optional string consumer_psc_address = 452646572; * @param string $var @@ -100,7 +115,9 @@ public function setConsumerPscAddress($var) } /** - * The psc producer port is used to connect PSC NEG with specific port on the PSC Producer side; should only be used for the PRIVATE_SERVICE_CONNECT NEG type + * The psc producer port is used to connect PSC NEG with specific port on + * the PSC Producer side; should only be used for the + * PRIVATE_SERVICE_CONNECT NEG type * * Generated from protobuf field optional int32 producer_port = 410021134; * @return int @@ -121,7 +138,9 @@ public function clearProducerPort() } /** - * The psc producer port is used to connect PSC NEG with specific port on the PSC Producer side; should only be used for the PRIVATE_SERVICE_CONNECT NEG type + * The psc producer port is used to connect PSC NEG with specific port on + * the PSC Producer side; should only be used for the + * PRIVATE_SERVICE_CONNECT NEG type * * Generated from protobuf field optional int32 producer_port = 410021134; * @param int $var @@ -136,7 +155,8 @@ public function setProducerPort($var) } /** - * [Output Only] The PSC connection id of the PSC Network Endpoint Group Consumer. + * [Output Only] The PSC connection id of the PSC Network Endpoint Group + * Consumer. * * Generated from protobuf field optional uint64 psc_connection_id = 292082397; * @return int|string @@ -157,7 +177,8 @@ public function clearPscConnectionId() } /** - * [Output Only] The PSC connection id of the PSC Network Endpoint Group Consumer. + * [Output Only] The PSC connection id of the PSC Network Endpoint Group + * Consumer. * * Generated from protobuf field optional uint64 psc_connection_id = 292082397; * @param int|string $var diff --git a/Compute/src/V1/NetworkEndpointGroupPscData/PscConnectionStatus.php b/Compute/src/V1/NetworkEndpointGroupPscData/PscConnectionStatus.php index 9cbd1eda304b..3fa76069b4c9 100644 --- a/Compute/src/V1/NetworkEndpointGroupPscData/PscConnectionStatus.php +++ b/Compute/src/V1/NetworkEndpointGroupPscData/PscConnectionStatus.php @@ -26,13 +26,16 @@ class PscConnectionStatus */ const ACCEPTED = 246714279; /** - * The connection has been closed by the producer and will not serve traffic going forward. + * The connection has been closed by the producer and will not serve + * traffic going forward. * * Generated from protobuf enum CLOSED = 380163436; */ const CLOSED = 380163436; /** - * The connection has been accepted by the producer, but the producer needs to take further action before the forwarding rule can serve traffic. + * The connection has been accepted by the producer, but the producer + * needs to take further action before the forwarding rule can serve + * traffic. * * Generated from protobuf enum NEEDS_ATTENTION = 344491452; */ diff --git a/Compute/src/V1/NetworkEndpointGroupsListEndpointsRequest.php b/Compute/src/V1/NetworkEndpointGroupsListEndpointsRequest.php index 7ed43d3bcc9d..122bf08bd97c 100644 --- a/Compute/src/V1/NetworkEndpointGroupsListEndpointsRequest.php +++ b/Compute/src/V1/NetworkEndpointGroupsListEndpointsRequest.php @@ -15,7 +15,10 @@ class NetworkEndpointGroupsListEndpointsRequest extends \Google\Protobuf\Internal\Message { /** - * Optional query parameter for showing the health status of each network endpoint. Valid options are SKIP or SHOW. If you don't specify this parameter, the health status of network endpoints will not be provided. + * Optional query parameter for showing the health status of each network + * endpoint. Valid options are SKIP or SHOW. If you + * don't specify this parameter, the health status of network endpoints will + * not be provided. * Check the HealthStatus enum for the list of possible values. * * Generated from protobuf field optional string health_status = 380545845; @@ -29,7 +32,10 @@ class NetworkEndpointGroupsListEndpointsRequest extends \Google\Protobuf\Interna * Optional. Data for populating the Message object. * * @type string $health_status - * Optional query parameter for showing the health status of each network endpoint. Valid options are SKIP or SHOW. If you don't specify this parameter, the health status of network endpoints will not be provided. + * Optional query parameter for showing the health status of each network + * endpoint. Valid options are SKIP or SHOW. If you + * don't specify this parameter, the health status of network endpoints will + * not be provided. * Check the HealthStatus enum for the list of possible values. * } */ @@ -39,7 +45,10 @@ public function __construct($data = NULL) { } /** - * Optional query parameter for showing the health status of each network endpoint. Valid options are SKIP or SHOW. If you don't specify this parameter, the health status of network endpoints will not be provided. + * Optional query parameter for showing the health status of each network + * endpoint. Valid options are SKIP or SHOW. If you + * don't specify this parameter, the health status of network endpoints will + * not be provided. * Check the HealthStatus enum for the list of possible values. * * Generated from protobuf field optional string health_status = 380545845; @@ -61,7 +70,10 @@ public function clearHealthStatus() } /** - * Optional query parameter for showing the health status of each network endpoint. Valid options are SKIP or SHOW. If you don't specify this parameter, the health status of network endpoints will not be provided. + * Optional query parameter for showing the health status of each network + * endpoint. Valid options are SKIP or SHOW. If you + * don't specify this parameter, the health status of network endpoints will + * not be provided. * Check the HealthStatus enum for the list of possible values. * * Generated from protobuf field optional string health_status = 380545845; diff --git a/Compute/src/V1/NetworkEndpointGroupsListEndpointsRequest/HealthStatus.php b/Compute/src/V1/NetworkEndpointGroupsListEndpointsRequest/HealthStatus.php index d3e6cf66238e..60bd5103f4fc 100644 --- a/Compute/src/V1/NetworkEndpointGroupsListEndpointsRequest/HealthStatus.php +++ b/Compute/src/V1/NetworkEndpointGroupsListEndpointsRequest/HealthStatus.php @@ -7,7 +7,10 @@ use UnexpectedValueException; /** - * Optional query parameter for showing the health status of each network endpoint. Valid options are SKIP or SHOW. If you don't specify this parameter, the health status of network endpoints will not be provided. + * Optional query parameter for showing the health status of each network + * endpoint. Valid options are SKIP or SHOW. If you + * don't specify this parameter, the health status of network endpoints will + * not be provided. * * Protobuf type google.cloud.compute.v1.NetworkEndpointGroupsListEndpointsRequest.HealthStatus */ @@ -20,7 +23,8 @@ class HealthStatus */ const UNDEFINED_HEALTH_STATUS = 0; /** - * Show the health status for each network endpoint. Impacts latency of the call. + * Show the health status for each network endpoint. Impacts latency of the + * call. * * Generated from protobuf enum SHOW = 2544381; */ diff --git a/Compute/src/V1/NetworkEndpointGroupsListNetworkEndpoints.php b/Compute/src/V1/NetworkEndpointGroupsListNetworkEndpoints.php index c7190acbb47f..152d0769bd4d 100644 --- a/Compute/src/V1/NetworkEndpointGroupsListNetworkEndpoints.php +++ b/Compute/src/V1/NetworkEndpointGroupsListNetworkEndpoints.php @@ -27,13 +27,18 @@ class NetworkEndpointGroupsListNetworkEndpoints extends \Google\Protobuf\Interna */ private $items; /** - * [Output Only] The resource type, which is always compute#networkEndpointGroupsListNetworkEndpoints for the list of network endpoints in the specified network endpoint group. + * [Output Only] The resource type, which is alwayscompute#networkEndpointGroupsListNetworkEndpoints for the list + * of network endpoints in the specified network endpoint group. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -56,9 +61,14 @@ class NetworkEndpointGroupsListNetworkEndpoints extends \Google\Protobuf\Interna * @type array<\Google\Cloud\Compute\V1\NetworkEndpointWithHealthStatus>|\Google\Protobuf\Internal\RepeatedField $items * A list of NetworkEndpointWithHealthStatus resources. * @type string $kind - * [Output Only] The resource type, which is always compute#networkEndpointGroupsListNetworkEndpoints for the list of network endpoints in the specified network endpoint group. + * [Output Only] The resource type, which is alwayscompute#networkEndpointGroupsListNetworkEndpoints for the list + * of network endpoints in the specified network endpoint group. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type \Google\Cloud\Compute\V1\Warning $warning * [Output Only] Informational warning message. * } @@ -131,7 +141,8 @@ public function setItems($var) } /** - * [Output Only] The resource type, which is always compute#networkEndpointGroupsListNetworkEndpoints for the list of network endpoints in the specified network endpoint group. + * [Output Only] The resource type, which is alwayscompute#networkEndpointGroupsListNetworkEndpoints for the list + * of network endpoints in the specified network endpoint group. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -152,7 +163,8 @@ public function clearKind() } /** - * [Output Only] The resource type, which is always compute#networkEndpointGroupsListNetworkEndpoints for the list of network endpoints in the specified network endpoint group. + * [Output Only] The resource type, which is alwayscompute#networkEndpointGroupsListNetworkEndpoints for the list + * of network endpoints in the specified network endpoint group. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -167,7 +179,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -188,7 +204,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/NetworkEndpointGroupsScopedList.php b/Compute/src/V1/NetworkEndpointGroupsScopedList.php index 8a2a3e7583fb..5954f4b625f0 100644 --- a/Compute/src/V1/NetworkEndpointGroupsScopedList.php +++ b/Compute/src/V1/NetworkEndpointGroupsScopedList.php @@ -15,13 +15,15 @@ class NetworkEndpointGroupsScopedList extends \Google\Protobuf\Internal\Message { /** - * [Output Only] The list of network endpoint groups that are contained in this scope. + * [Output Only] The list ofnetwork + * endpoint groups that are contained in this scope. * * Generated from protobuf field repeated .google.cloud.compute.v1.NetworkEndpointGroup network_endpoint_groups = 29346733; */ private $network_endpoint_groups; /** - * [Output Only] An informational warning that replaces the list of network endpoint groups when the list is empty. + * [Output Only] An informational warning that replaces the list of network + * endpoint groups when the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; */ @@ -34,9 +36,11 @@ class NetworkEndpointGroupsScopedList extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type array<\Google\Cloud\Compute\V1\NetworkEndpointGroup>|\Google\Protobuf\Internal\RepeatedField $network_endpoint_groups - * [Output Only] The list of network endpoint groups that are contained in this scope. + * [Output Only] The list ofnetwork + * endpoint groups that are contained in this scope. * @type \Google\Cloud\Compute\V1\Warning $warning - * [Output Only] An informational warning that replaces the list of network endpoint groups when the list is empty. + * [Output Only] An informational warning that replaces the list of network + * endpoint groups when the list is empty. * } */ public function __construct($data = NULL) { @@ -45,7 +49,8 @@ public function __construct($data = NULL) { } /** - * [Output Only] The list of network endpoint groups that are contained in this scope. + * [Output Only] The list ofnetwork + * endpoint groups that are contained in this scope. * * Generated from protobuf field repeated .google.cloud.compute.v1.NetworkEndpointGroup network_endpoint_groups = 29346733; * @return \Google\Protobuf\Internal\RepeatedField @@ -56,7 +61,8 @@ public function getNetworkEndpointGroups() } /** - * [Output Only] The list of network endpoint groups that are contained in this scope. + * [Output Only] The list ofnetwork + * endpoint groups that are contained in this scope. * * Generated from protobuf field repeated .google.cloud.compute.v1.NetworkEndpointGroup network_endpoint_groups = 29346733; * @param array<\Google\Cloud\Compute\V1\NetworkEndpointGroup>|\Google\Protobuf\Internal\RepeatedField $var @@ -71,7 +77,8 @@ public function setNetworkEndpointGroups($var) } /** - * [Output Only] An informational warning that replaces the list of network endpoint groups when the list is empty. + * [Output Only] An informational warning that replaces the list of network + * endpoint groups when the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; * @return \Google\Cloud\Compute\V1\Warning|null @@ -92,7 +99,8 @@ public function clearWarning() } /** - * [Output Only] An informational warning that replaces the list of network endpoint groups when the list is empty. + * [Output Only] An informational warning that replaces the list of network + * endpoint groups when the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; * @param \Google\Cloud\Compute\V1\Warning $var diff --git a/Compute/src/V1/NetworkEndpointWithHealthStatus.php b/Compute/src/V1/NetworkEndpointWithHealthStatus.php index da558a649bac..713281d68be8 100644 --- a/Compute/src/V1/NetworkEndpointWithHealthStatus.php +++ b/Compute/src/V1/NetworkEndpointWithHealthStatus.php @@ -15,7 +15,9 @@ class NetworkEndpointWithHealthStatus extends \Google\Protobuf\Internal\Message { /** - * [Output only] The health status of network endpoint. Optional. Displayed only if the network endpoint has centralized health checking configured. + * [Output only] The health status of network endpoint. + * Optional. Displayed only if the network endpoint has centralized health + * checking configured. * * Generated from protobuf field repeated .google.cloud.compute.v1.HealthStatusForNetworkEndpoint healths = 258689431; */ @@ -34,7 +36,9 @@ class NetworkEndpointWithHealthStatus extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type array<\Google\Cloud\Compute\V1\HealthStatusForNetworkEndpoint>|\Google\Protobuf\Internal\RepeatedField $healths - * [Output only] The health status of network endpoint. Optional. Displayed only if the network endpoint has centralized health checking configured. + * [Output only] The health status of network endpoint. + * Optional. Displayed only if the network endpoint has centralized health + * checking configured. * @type \Google\Cloud\Compute\V1\NetworkEndpoint $network_endpoint * [Output only] The network endpoint. * } @@ -45,7 +49,9 @@ public function __construct($data = NULL) { } /** - * [Output only] The health status of network endpoint. Optional. Displayed only if the network endpoint has centralized health checking configured. + * [Output only] The health status of network endpoint. + * Optional. Displayed only if the network endpoint has centralized health + * checking configured. * * Generated from protobuf field repeated .google.cloud.compute.v1.HealthStatusForNetworkEndpoint healths = 258689431; * @return \Google\Protobuf\Internal\RepeatedField @@ -56,7 +62,9 @@ public function getHealths() } /** - * [Output only] The health status of network endpoint. Optional. Displayed only if the network endpoint has centralized health checking configured. + * [Output only] The health status of network endpoint. + * Optional. Displayed only if the network endpoint has centralized health + * checking configured. * * Generated from protobuf field repeated .google.cloud.compute.v1.HealthStatusForNetworkEndpoint healths = 258689431; * @param array<\Google\Cloud\Compute\V1\HealthStatusForNetworkEndpoint>|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/NetworkFirewallPolicyAggregatedList.php b/Compute/src/V1/NetworkFirewallPolicyAggregatedList.php index 6b281fda3354..bf38bcaf56e4 100644 --- a/Compute/src/V1/NetworkFirewallPolicyAggregatedList.php +++ b/Compute/src/V1/NetworkFirewallPolicyAggregatedList.php @@ -27,13 +27,18 @@ class NetworkFirewallPolicyAggregatedList extends \Google\Protobuf\Internal\Mess */ private $items; /** - * [Output Only] Type of resource. Always compute#networkFirewallPoliciesAggregatedList for lists of network firewall policies. + * [Output Only] Type of resource. Alwayscompute#networkFirewallPoliciesAggregatedList for lists of + * network firewall policies. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -68,9 +73,14 @@ class NetworkFirewallPolicyAggregatedList extends \Google\Protobuf\Internal\Mess * @type array|\Google\Protobuf\Internal\MapField $items * A list of FirewallPoliciesScopedList resources. * @type string $kind - * [Output Only] Type of resource. Always compute#networkFirewallPoliciesAggregatedList for lists of network firewall policies. + * [Output Only] Type of resource. Alwayscompute#networkFirewallPoliciesAggregatedList for lists of + * network firewall policies. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type array|\Google\Protobuf\Internal\RepeatedField $unreachables @@ -147,7 +157,8 @@ public function setItems($var) } /** - * [Output Only] Type of resource. Always compute#networkFirewallPoliciesAggregatedList for lists of network firewall policies. + * [Output Only] Type of resource. Alwayscompute#networkFirewallPoliciesAggregatedList for lists of + * network firewall policies. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -168,7 +179,8 @@ public function clearKind() } /** - * [Output Only] Type of resource. Always compute#networkFirewallPoliciesAggregatedList for lists of network firewall policies. + * [Output Only] Type of resource. Alwayscompute#networkFirewallPoliciesAggregatedList for lists of + * network firewall policies. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -183,7 +195,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -204,7 +220,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/NetworkInterface.php b/Compute/src/V1/NetworkInterface.php index 747652706da7..776322512e2d 100644 --- a/Compute/src/V1/NetworkInterface.php +++ b/Compute/src/V1/NetworkInterface.php @@ -16,23 +16,37 @@ class NetworkInterface extends \Google\Protobuf\Internal\Message { /** - * An array of configurations for this interface. Currently, only one access config, ONE_TO_ONE_NAT, is supported. If there are no accessConfigs specified, then this instance will have no external internet access. + * An array of configurations for this interface. Currently, only one access + * config, ONE_TO_ONE_NAT, is supported. If there are noaccessConfigs specified, then this instance will have + * no external internet access. * * Generated from protobuf field repeated .google.cloud.compute.v1.AccessConfig access_configs = 111058326; */ private $access_configs; /** - * An array of alias IP ranges for this network interface. You can only specify this field for network interfaces in VPC networks. + * An array of alias IP ranges for this network interface. + * You can only specify this field for network interfaces in VPC networks. * * Generated from protobuf field repeated .google.cloud.compute.v1.AliasIpRange alias_ip_ranges = 165085631; */ private $alias_ip_ranges; /** - * Fingerprint hash of contents stored in this network interface. This field will be ignored when inserting an Instance or adding a NetworkInterface. An up-to-date fingerprint must be provided in order to update the NetworkInterface. The request will fail with error 400 Bad Request if the fingerprint is not provided, or 412 Precondition Failed if the fingerprint is out of date. + * Fingerprint hash of contents stored in this network interface. + * This field will be ignored when inserting an Instance or + * adding a NetworkInterface. An up-to-date + * fingerprint must be provided in order to update theNetworkInterface. The request will fail with error400 Bad Request if the fingerprint is not provided, or412 Precondition Failed if the fingerprint is out of date. * * Generated from protobuf field optional string fingerprint = 234678500; */ protected $fingerprint = null; + /** + * Indicate whether igmp query is enabled on the network interface + * or not. If enabled, also indicates the version of IGMP supported. + * Check the IgmpQuery enum for the list of possible values. + * + * Generated from protobuf field optional string igmp_query = 30249546; + */ + protected $igmp_query = null; /** * The prefix length of the primary internal IPv6 range. * @@ -40,56 +54,82 @@ class NetworkInterface extends \Google\Protobuf\Internal\Message */ protected $internal_ipv6_prefix_length = null; /** - * An array of IPv6 access configurations for this interface. Currently, only one IPv6 access config, DIRECT_IPV6, is supported. If there is no ipv6AccessConfig specified, then this instance will have no external IPv6 Internet access. + * An array of IPv6 access configurations for this interface. Currently, only + * one IPv6 access config, DIRECT_IPV6, is supported. If there + * is no ipv6AccessConfig specified, then this instance will + * have no external IPv6 Internet access. * * Generated from protobuf field repeated .google.cloud.compute.v1.AccessConfig ipv6_access_configs = 483472110; */ private $ipv6_access_configs; /** - * [Output Only] One of EXTERNAL, INTERNAL to indicate whether the IP can be accessed from the Internet. This field is always inherited from its subnetwork. Valid only if stackType is IPV4_IPV6. + * [Output Only] One of EXTERNAL, INTERNAL to indicate whether the IP can be + * accessed from the Internet. This field is always inherited from its + * subnetwork. + * Valid only if stackType is IPV4_IPV6. * Check the Ipv6AccessType enum for the list of possible values. * * Generated from protobuf field optional string ipv6_access_type = 504658653; */ protected $ipv6_access_type = null; /** - * An IPv6 internal network address for this network interface. To use a static internal IP address, it must be unused and in the same region as the instance's zone. If not specified, Google Cloud will automatically assign an internal IPv6 address from the instance's subnetwork. + * An IPv6 internal network address for this network interface. To + * use a static internal IP address, it must be unused and in the same region + * as the instance's zone. If not specified, Google Cloud will automatically + * assign an internal IPv6 address from the instance's subnetwork. * * Generated from protobuf field optional string ipv6_address = 341563804; */ protected $ipv6_address = null; /** - * [Output Only] Type of the resource. Always compute#networkInterface for network interfaces. + * [Output Only] Type of the resource. Alwayscompute#networkInterface for network interfaces. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] The name of the network interface, which is generated by the server. For a VM, the network interface uses the nicN naming format. Where N is a value between 0 and 7. The default interface value is nic0. + * [Output Only] The name of the network interface, which is generated by the + * server. For a VM, the network interface uses the nicN naming + * format. Where N is a value between 0 and7. The default interface value is nic0. * * Generated from protobuf field optional string name = 3373707; */ protected $name = null; /** - * URL of the VPC network resource for this instance. When creating an instance, if neither the network nor the subnetwork is specified, the default network global/networks/default is used. If the selected project doesn't have the default network, you must specify a network or subnet. If the network is not specified but the subnetwork is specified, the network is inferred. If you specify this property, you can specify the network as a full or partial URL. For example, the following are all valid URLs: - https://www.googleapis.com/compute/v1/projects/project/global/networks/ network - projects/project/global/networks/network - global/networks/default + * URL of the VPC network resource for this instance. When creating an + * instance, if neither the network nor the subnetwork is specified, the + * default network global/networks/default is used. If the + * selected project doesn't have the default network, you must specify a + * network or subnet. If the network is not specified but the subnetwork is + * specified, the network is inferred. + * If you specify this property, you can specify the network as + * a full or partial URL. For example, the following are all valid URLs: + * - https://www.googleapis.com/compute/v1/projects/project/global/networks/network + * - projects/project/global/networks/network + * - global/networks/default * * Generated from protobuf field optional string network = 232872494; */ protected $network = null; /** - * The URL of the network attachment that this interface should connect to in the following format: projects/{project_number}/regions/{region_name}/networkAttachments/{network_attachment_name}. + * The URL of the network attachment that this interface should connect + * to in the following format: + * projects/{project_number}/regions/{region_name}/networkAttachments/{network_attachment_name}. * * Generated from protobuf field optional string network_attachment = 224644052; */ protected $network_attachment = null; /** - * An IPv4 internal IP address to assign to the instance for this network interface. If not specified by the user, an unused internal IP is assigned by the system. + * An IPv4 internal IP address to assign to the instance for this network + * interface. If not specified by the user, an unused internal IP is + * assigned by the system. * * Generated from protobuf field optional string network_i_p = 207181961; */ protected $network_i_p = null; /** - * The type of vNIC to be used on this interface. This may be gVNIC or VirtioNet. + * The type of vNIC to be used on this interface. This may be gVNIC or + * VirtioNet. * Check the NicType enum for the list of possible values. * * Generated from protobuf field optional string nic_type = 59810577; @@ -102,26 +142,40 @@ class NetworkInterface extends \Google\Protobuf\Internal\Message */ protected $parent_nic_name = null; /** - * The networking queue count that's specified by users for the network interface. Both Rx and Tx queues will be set to this number. It'll be empty if not specified by the users. + * The networking queue count that's specified by users for the network + * interface. Both Rx and Tx queues will be set to this number. It'll be empty + * if not specified by the users. * * Generated from protobuf field optional int32 queue_count = 503708769; */ protected $queue_count = null; /** - * The stack type for this network interface. To assign only IPv4 addresses, use IPV4_ONLY. To assign both IPv4 and IPv6 addresses, use IPV4_IPV6. If not specified, IPV4_ONLY is used. This field can be both set at instance creation and update network interface operations. + * The stack type for this network interface. To assign only IPv4 addresses, + * use IPV4_ONLY. To assign both IPv4 and IPv6 addresses, useIPV4_IPV6. If not specified, IPV4_ONLY is used. + * This field can be both set at instance creation and update network + * interface operations. * Check the StackType enum for the list of possible values. * * Generated from protobuf field optional string stack_type = 425908881; */ protected $stack_type = null; /** - * The URL of the Subnetwork resource for this instance. If the network resource is in legacy mode, do not specify this field. If the network is in auto subnet mode, specifying the subnetwork is optional. If the network is in custom subnet mode, specifying the subnetwork is required. If you specify this field, you can specify the subnetwork as a full or partial URL. For example, the following are all valid URLs: - https://www.googleapis.com/compute/v1/projects/project/regions/region /subnetworks/subnetwork - regions/region/subnetworks/subnetwork + * The URL of the Subnetwork resource for this instance. If the network + * resource is inlegacy + * mode, do not specify this field. If the network is in auto subnet + * mode, specifying the subnetwork is optional. If the network is in custom + * subnet mode, specifying the subnetwork is required. If you specify this + * field, you can specify the subnetwork as a full or partial URL. For + * example, the following are all valid URLs: + * - https://www.googleapis.com/compute/v1/projects/project/regions/region/subnetworks/subnetwork + * - regions/region/subnetworks/subnetwork * * Generated from protobuf field optional string subnetwork = 307827694; */ protected $subnetwork = null; /** - * VLAN tag of a dynamic network interface, must be an integer in the range from 2 to 255 inclusively. + * VLAN tag of a dynamic network interface, must be an integer in the range + * from 2 to 255 inclusively. * * Generated from protobuf field optional int32 vlan = 3622243; */ @@ -134,44 +188,94 @@ class NetworkInterface extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type array<\Google\Cloud\Compute\V1\AccessConfig>|\Google\Protobuf\Internal\RepeatedField $access_configs - * An array of configurations for this interface. Currently, only one access config, ONE_TO_ONE_NAT, is supported. If there are no accessConfigs specified, then this instance will have no external internet access. + * An array of configurations for this interface. Currently, only one access + * config, ONE_TO_ONE_NAT, is supported. If there are noaccessConfigs specified, then this instance will have + * no external internet access. * @type array<\Google\Cloud\Compute\V1\AliasIpRange>|\Google\Protobuf\Internal\RepeatedField $alias_ip_ranges - * An array of alias IP ranges for this network interface. You can only specify this field for network interfaces in VPC networks. + * An array of alias IP ranges for this network interface. + * You can only specify this field for network interfaces in VPC networks. * @type string $fingerprint - * Fingerprint hash of contents stored in this network interface. This field will be ignored when inserting an Instance or adding a NetworkInterface. An up-to-date fingerprint must be provided in order to update the NetworkInterface. The request will fail with error 400 Bad Request if the fingerprint is not provided, or 412 Precondition Failed if the fingerprint is out of date. + * Fingerprint hash of contents stored in this network interface. + * This field will be ignored when inserting an Instance or + * adding a NetworkInterface. An up-to-date + * fingerprint must be provided in order to update theNetworkInterface. The request will fail with error400 Bad Request if the fingerprint is not provided, or412 Precondition Failed if the fingerprint is out of date. + * @type string $igmp_query + * Indicate whether igmp query is enabled on the network interface + * or not. If enabled, also indicates the version of IGMP supported. + * Check the IgmpQuery enum for the list of possible values. * @type int $internal_ipv6_prefix_length * The prefix length of the primary internal IPv6 range. * @type array<\Google\Cloud\Compute\V1\AccessConfig>|\Google\Protobuf\Internal\RepeatedField $ipv6_access_configs - * An array of IPv6 access configurations for this interface. Currently, only one IPv6 access config, DIRECT_IPV6, is supported. If there is no ipv6AccessConfig specified, then this instance will have no external IPv6 Internet access. + * An array of IPv6 access configurations for this interface. Currently, only + * one IPv6 access config, DIRECT_IPV6, is supported. If there + * is no ipv6AccessConfig specified, then this instance will + * have no external IPv6 Internet access. * @type string $ipv6_access_type - * [Output Only] One of EXTERNAL, INTERNAL to indicate whether the IP can be accessed from the Internet. This field is always inherited from its subnetwork. Valid only if stackType is IPV4_IPV6. + * [Output Only] One of EXTERNAL, INTERNAL to indicate whether the IP can be + * accessed from the Internet. This field is always inherited from its + * subnetwork. + * Valid only if stackType is IPV4_IPV6. * Check the Ipv6AccessType enum for the list of possible values. * @type string $ipv6_address - * An IPv6 internal network address for this network interface. To use a static internal IP address, it must be unused and in the same region as the instance's zone. If not specified, Google Cloud will automatically assign an internal IPv6 address from the instance's subnetwork. + * An IPv6 internal network address for this network interface. To + * use a static internal IP address, it must be unused and in the same region + * as the instance's zone. If not specified, Google Cloud will automatically + * assign an internal IPv6 address from the instance's subnetwork. * @type string $kind - * [Output Only] Type of the resource. Always compute#networkInterface for network interfaces. + * [Output Only] Type of the resource. Alwayscompute#networkInterface for network interfaces. * @type string $name - * [Output Only] The name of the network interface, which is generated by the server. For a VM, the network interface uses the nicN naming format. Where N is a value between 0 and 7. The default interface value is nic0. + * [Output Only] The name of the network interface, which is generated by the + * server. For a VM, the network interface uses the nicN naming + * format. Where N is a value between 0 and7. The default interface value is nic0. * @type string $network - * URL of the VPC network resource for this instance. When creating an instance, if neither the network nor the subnetwork is specified, the default network global/networks/default is used. If the selected project doesn't have the default network, you must specify a network or subnet. If the network is not specified but the subnetwork is specified, the network is inferred. If you specify this property, you can specify the network as a full or partial URL. For example, the following are all valid URLs: - https://www.googleapis.com/compute/v1/projects/project/global/networks/ network - projects/project/global/networks/network - global/networks/default + * URL of the VPC network resource for this instance. When creating an + * instance, if neither the network nor the subnetwork is specified, the + * default network global/networks/default is used. If the + * selected project doesn't have the default network, you must specify a + * network or subnet. If the network is not specified but the subnetwork is + * specified, the network is inferred. + * If you specify this property, you can specify the network as + * a full or partial URL. For example, the following are all valid URLs: + * - https://www.googleapis.com/compute/v1/projects/project/global/networks/network + * - projects/project/global/networks/network + * - global/networks/default * @type string $network_attachment - * The URL of the network attachment that this interface should connect to in the following format: projects/{project_number}/regions/{region_name}/networkAttachments/{network_attachment_name}. + * The URL of the network attachment that this interface should connect + * to in the following format: + * projects/{project_number}/regions/{region_name}/networkAttachments/{network_attachment_name}. * @type string $network_i_p - * An IPv4 internal IP address to assign to the instance for this network interface. If not specified by the user, an unused internal IP is assigned by the system. + * An IPv4 internal IP address to assign to the instance for this network + * interface. If not specified by the user, an unused internal IP is + * assigned by the system. * @type string $nic_type - * The type of vNIC to be used on this interface. This may be gVNIC or VirtioNet. + * The type of vNIC to be used on this interface. This may be gVNIC or + * VirtioNet. * Check the NicType enum for the list of possible values. * @type string $parent_nic_name * Name of the parent network interface of a dynamic network interface. * @type int $queue_count - * The networking queue count that's specified by users for the network interface. Both Rx and Tx queues will be set to this number. It'll be empty if not specified by the users. + * The networking queue count that's specified by users for the network + * interface. Both Rx and Tx queues will be set to this number. It'll be empty + * if not specified by the users. * @type string $stack_type - * The stack type for this network interface. To assign only IPv4 addresses, use IPV4_ONLY. To assign both IPv4 and IPv6 addresses, use IPV4_IPV6. If not specified, IPV4_ONLY is used. This field can be both set at instance creation and update network interface operations. + * The stack type for this network interface. To assign only IPv4 addresses, + * use IPV4_ONLY. To assign both IPv4 and IPv6 addresses, useIPV4_IPV6. If not specified, IPV4_ONLY is used. + * This field can be both set at instance creation and update network + * interface operations. * Check the StackType enum for the list of possible values. * @type string $subnetwork - * The URL of the Subnetwork resource for this instance. If the network resource is in legacy mode, do not specify this field. If the network is in auto subnet mode, specifying the subnetwork is optional. If the network is in custom subnet mode, specifying the subnetwork is required. If you specify this field, you can specify the subnetwork as a full or partial URL. For example, the following are all valid URLs: - https://www.googleapis.com/compute/v1/projects/project/regions/region /subnetworks/subnetwork - regions/region/subnetworks/subnetwork + * The URL of the Subnetwork resource for this instance. If the network + * resource is inlegacy + * mode, do not specify this field. If the network is in auto subnet + * mode, specifying the subnetwork is optional. If the network is in custom + * subnet mode, specifying the subnetwork is required. If you specify this + * field, you can specify the subnetwork as a full or partial URL. For + * example, the following are all valid URLs: + * - https://www.googleapis.com/compute/v1/projects/project/regions/region/subnetworks/subnetwork + * - regions/region/subnetworks/subnetwork * @type int $vlan - * VLAN tag of a dynamic network interface, must be an integer in the range from 2 to 255 inclusively. + * VLAN tag of a dynamic network interface, must be an integer in the range + * from 2 to 255 inclusively. * } */ public function __construct($data = NULL) { @@ -180,7 +284,9 @@ public function __construct($data = NULL) { } /** - * An array of configurations for this interface. Currently, only one access config, ONE_TO_ONE_NAT, is supported. If there are no accessConfigs specified, then this instance will have no external internet access. + * An array of configurations for this interface. Currently, only one access + * config, ONE_TO_ONE_NAT, is supported. If there are noaccessConfigs specified, then this instance will have + * no external internet access. * * Generated from protobuf field repeated .google.cloud.compute.v1.AccessConfig access_configs = 111058326; * @return \Google\Protobuf\Internal\RepeatedField @@ -191,7 +297,9 @@ public function getAccessConfigs() } /** - * An array of configurations for this interface. Currently, only one access config, ONE_TO_ONE_NAT, is supported. If there are no accessConfigs specified, then this instance will have no external internet access. + * An array of configurations for this interface. Currently, only one access + * config, ONE_TO_ONE_NAT, is supported. If there are noaccessConfigs specified, then this instance will have + * no external internet access. * * Generated from protobuf field repeated .google.cloud.compute.v1.AccessConfig access_configs = 111058326; * @param array<\Google\Cloud\Compute\V1\AccessConfig>|\Google\Protobuf\Internal\RepeatedField $var @@ -206,7 +314,8 @@ public function setAccessConfigs($var) } /** - * An array of alias IP ranges for this network interface. You can only specify this field for network interfaces in VPC networks. + * An array of alias IP ranges for this network interface. + * You can only specify this field for network interfaces in VPC networks. * * Generated from protobuf field repeated .google.cloud.compute.v1.AliasIpRange alias_ip_ranges = 165085631; * @return \Google\Protobuf\Internal\RepeatedField @@ -217,7 +326,8 @@ public function getAliasIpRanges() } /** - * An array of alias IP ranges for this network interface. You can only specify this field for network interfaces in VPC networks. + * An array of alias IP ranges for this network interface. + * You can only specify this field for network interfaces in VPC networks. * * Generated from protobuf field repeated .google.cloud.compute.v1.AliasIpRange alias_ip_ranges = 165085631; * @param array<\Google\Cloud\Compute\V1\AliasIpRange>|\Google\Protobuf\Internal\RepeatedField $var @@ -232,7 +342,10 @@ public function setAliasIpRanges($var) } /** - * Fingerprint hash of contents stored in this network interface. This field will be ignored when inserting an Instance or adding a NetworkInterface. An up-to-date fingerprint must be provided in order to update the NetworkInterface. The request will fail with error 400 Bad Request if the fingerprint is not provided, or 412 Precondition Failed if the fingerprint is out of date. + * Fingerprint hash of contents stored in this network interface. + * This field will be ignored when inserting an Instance or + * adding a NetworkInterface. An up-to-date + * fingerprint must be provided in order to update theNetworkInterface. The request will fail with error400 Bad Request if the fingerprint is not provided, or412 Precondition Failed if the fingerprint is out of date. * * Generated from protobuf field optional string fingerprint = 234678500; * @return string @@ -253,7 +366,10 @@ public function clearFingerprint() } /** - * Fingerprint hash of contents stored in this network interface. This field will be ignored when inserting an Instance or adding a NetworkInterface. An up-to-date fingerprint must be provided in order to update the NetworkInterface. The request will fail with error 400 Bad Request if the fingerprint is not provided, or 412 Precondition Failed if the fingerprint is out of date. + * Fingerprint hash of contents stored in this network interface. + * This field will be ignored when inserting an Instance or + * adding a NetworkInterface. An up-to-date + * fingerprint must be provided in order to update theNetworkInterface. The request will fail with error400 Bad Request if the fingerprint is not provided, or412 Precondition Failed if the fingerprint is out of date. * * Generated from protobuf field optional string fingerprint = 234678500; * @param string $var @@ -267,6 +383,46 @@ public function setFingerprint($var) return $this; } + /** + * Indicate whether igmp query is enabled on the network interface + * or not. If enabled, also indicates the version of IGMP supported. + * Check the IgmpQuery enum for the list of possible values. + * + * Generated from protobuf field optional string igmp_query = 30249546; + * @return string + */ + public function getIgmpQuery() + { + return isset($this->igmp_query) ? $this->igmp_query : ''; + } + + public function hasIgmpQuery() + { + return isset($this->igmp_query); + } + + public function clearIgmpQuery() + { + unset($this->igmp_query); + } + + /** + * Indicate whether igmp query is enabled on the network interface + * or not. If enabled, also indicates the version of IGMP supported. + * Check the IgmpQuery enum for the list of possible values. + * + * Generated from protobuf field optional string igmp_query = 30249546; + * @param string $var + * @return $this + */ + public function setIgmpQuery($var) + { + GPBUtil::checkString($var, True); + $this->igmp_query = $var; + + return $this; + } + /** * The prefix length of the primary internal IPv6 range. * @@ -304,7 +460,10 @@ public function setInternalIpv6PrefixLength($var) } /** - * An array of IPv6 access configurations for this interface. Currently, only one IPv6 access config, DIRECT_IPV6, is supported. If there is no ipv6AccessConfig specified, then this instance will have no external IPv6 Internet access. + * An array of IPv6 access configurations for this interface. Currently, only + * one IPv6 access config, DIRECT_IPV6, is supported. If there + * is no ipv6AccessConfig specified, then this instance will + * have no external IPv6 Internet access. * * Generated from protobuf field repeated .google.cloud.compute.v1.AccessConfig ipv6_access_configs = 483472110; * @return \Google\Protobuf\Internal\RepeatedField @@ -315,7 +474,10 @@ public function getIpv6AccessConfigs() } /** - * An array of IPv6 access configurations for this interface. Currently, only one IPv6 access config, DIRECT_IPV6, is supported. If there is no ipv6AccessConfig specified, then this instance will have no external IPv6 Internet access. + * An array of IPv6 access configurations for this interface. Currently, only + * one IPv6 access config, DIRECT_IPV6, is supported. If there + * is no ipv6AccessConfig specified, then this instance will + * have no external IPv6 Internet access. * * Generated from protobuf field repeated .google.cloud.compute.v1.AccessConfig ipv6_access_configs = 483472110; * @param array<\Google\Cloud\Compute\V1\AccessConfig>|\Google\Protobuf\Internal\RepeatedField $var @@ -330,7 +492,10 @@ public function setIpv6AccessConfigs($var) } /** - * [Output Only] One of EXTERNAL, INTERNAL to indicate whether the IP can be accessed from the Internet. This field is always inherited from its subnetwork. Valid only if stackType is IPV4_IPV6. + * [Output Only] One of EXTERNAL, INTERNAL to indicate whether the IP can be + * accessed from the Internet. This field is always inherited from its + * subnetwork. + * Valid only if stackType is IPV4_IPV6. * Check the Ipv6AccessType enum for the list of possible values. * * Generated from protobuf field optional string ipv6_access_type = 504658653; @@ -352,7 +517,10 @@ public function clearIpv6AccessType() } /** - * [Output Only] One of EXTERNAL, INTERNAL to indicate whether the IP can be accessed from the Internet. This field is always inherited from its subnetwork. Valid only if stackType is IPV4_IPV6. + * [Output Only] One of EXTERNAL, INTERNAL to indicate whether the IP can be + * accessed from the Internet. This field is always inherited from its + * subnetwork. + * Valid only if stackType is IPV4_IPV6. * Check the Ipv6AccessType enum for the list of possible values. * * Generated from protobuf field optional string ipv6_access_type = 504658653; @@ -368,7 +536,10 @@ public function setIpv6AccessType($var) } /** - * An IPv6 internal network address for this network interface. To use a static internal IP address, it must be unused and in the same region as the instance's zone. If not specified, Google Cloud will automatically assign an internal IPv6 address from the instance's subnetwork. + * An IPv6 internal network address for this network interface. To + * use a static internal IP address, it must be unused and in the same region + * as the instance's zone. If not specified, Google Cloud will automatically + * assign an internal IPv6 address from the instance's subnetwork. * * Generated from protobuf field optional string ipv6_address = 341563804; * @return string @@ -389,7 +560,10 @@ public function clearIpv6Address() } /** - * An IPv6 internal network address for this network interface. To use a static internal IP address, it must be unused and in the same region as the instance's zone. If not specified, Google Cloud will automatically assign an internal IPv6 address from the instance's subnetwork. + * An IPv6 internal network address for this network interface. To + * use a static internal IP address, it must be unused and in the same region + * as the instance's zone. If not specified, Google Cloud will automatically + * assign an internal IPv6 address from the instance's subnetwork. * * Generated from protobuf field optional string ipv6_address = 341563804; * @param string $var @@ -404,7 +578,7 @@ public function setIpv6Address($var) } /** - * [Output Only] Type of the resource. Always compute#networkInterface for network interfaces. + * [Output Only] Type of the resource. Alwayscompute#networkInterface for network interfaces. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -425,7 +599,7 @@ public function clearKind() } /** - * [Output Only] Type of the resource. Always compute#networkInterface for network interfaces. + * [Output Only] Type of the resource. Alwayscompute#networkInterface for network interfaces. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -440,7 +614,9 @@ public function setKind($var) } /** - * [Output Only] The name of the network interface, which is generated by the server. For a VM, the network interface uses the nicN naming format. Where N is a value between 0 and 7. The default interface value is nic0. + * [Output Only] The name of the network interface, which is generated by the + * server. For a VM, the network interface uses the nicN naming + * format. Where N is a value between 0 and7. The default interface value is nic0. * * Generated from protobuf field optional string name = 3373707; * @return string @@ -461,7 +637,9 @@ public function clearName() } /** - * [Output Only] The name of the network interface, which is generated by the server. For a VM, the network interface uses the nicN naming format. Where N is a value between 0 and 7. The default interface value is nic0. + * [Output Only] The name of the network interface, which is generated by the + * server. For a VM, the network interface uses the nicN naming + * format. Where N is a value between 0 and7. The default interface value is nic0. * * Generated from protobuf field optional string name = 3373707; * @param string $var @@ -476,7 +654,17 @@ public function setName($var) } /** - * URL of the VPC network resource for this instance. When creating an instance, if neither the network nor the subnetwork is specified, the default network global/networks/default is used. If the selected project doesn't have the default network, you must specify a network or subnet. If the network is not specified but the subnetwork is specified, the network is inferred. If you specify this property, you can specify the network as a full or partial URL. For example, the following are all valid URLs: - https://www.googleapis.com/compute/v1/projects/project/global/networks/ network - projects/project/global/networks/network - global/networks/default + * URL of the VPC network resource for this instance. When creating an + * instance, if neither the network nor the subnetwork is specified, the + * default network global/networks/default is used. If the + * selected project doesn't have the default network, you must specify a + * network or subnet. If the network is not specified but the subnetwork is + * specified, the network is inferred. + * If you specify this property, you can specify the network as + * a full or partial URL. For example, the following are all valid URLs: + * - https://www.googleapis.com/compute/v1/projects/project/global/networks/network + * - projects/project/global/networks/network + * - global/networks/default * * Generated from protobuf field optional string network = 232872494; * @return string @@ -497,7 +685,17 @@ public function clearNetwork() } /** - * URL of the VPC network resource for this instance. When creating an instance, if neither the network nor the subnetwork is specified, the default network global/networks/default is used. If the selected project doesn't have the default network, you must specify a network or subnet. If the network is not specified but the subnetwork is specified, the network is inferred. If you specify this property, you can specify the network as a full or partial URL. For example, the following are all valid URLs: - https://www.googleapis.com/compute/v1/projects/project/global/networks/ network - projects/project/global/networks/network - global/networks/default + * URL of the VPC network resource for this instance. When creating an + * instance, if neither the network nor the subnetwork is specified, the + * default network global/networks/default is used. If the + * selected project doesn't have the default network, you must specify a + * network or subnet. If the network is not specified but the subnetwork is + * specified, the network is inferred. + * If you specify this property, you can specify the network as + * a full or partial URL. For example, the following are all valid URLs: + * - https://www.googleapis.com/compute/v1/projects/project/global/networks/network + * - projects/project/global/networks/network + * - global/networks/default * * Generated from protobuf field optional string network = 232872494; * @param string $var @@ -512,7 +710,9 @@ public function setNetwork($var) } /** - * The URL of the network attachment that this interface should connect to in the following format: projects/{project_number}/regions/{region_name}/networkAttachments/{network_attachment_name}. + * The URL of the network attachment that this interface should connect + * to in the following format: + * projects/{project_number}/regions/{region_name}/networkAttachments/{network_attachment_name}. * * Generated from protobuf field optional string network_attachment = 224644052; * @return string @@ -533,7 +733,9 @@ public function clearNetworkAttachment() } /** - * The URL of the network attachment that this interface should connect to in the following format: projects/{project_number}/regions/{region_name}/networkAttachments/{network_attachment_name}. + * The URL of the network attachment that this interface should connect + * to in the following format: + * projects/{project_number}/regions/{region_name}/networkAttachments/{network_attachment_name}. * * Generated from protobuf field optional string network_attachment = 224644052; * @param string $var @@ -548,7 +750,9 @@ public function setNetworkAttachment($var) } /** - * An IPv4 internal IP address to assign to the instance for this network interface. If not specified by the user, an unused internal IP is assigned by the system. + * An IPv4 internal IP address to assign to the instance for this network + * interface. If not specified by the user, an unused internal IP is + * assigned by the system. * * Generated from protobuf field optional string network_i_p = 207181961; * @return string @@ -569,7 +773,9 @@ public function clearNetworkIP() } /** - * An IPv4 internal IP address to assign to the instance for this network interface. If not specified by the user, an unused internal IP is assigned by the system. + * An IPv4 internal IP address to assign to the instance for this network + * interface. If not specified by the user, an unused internal IP is + * assigned by the system. * * Generated from protobuf field optional string network_i_p = 207181961; * @param string $var @@ -584,7 +790,8 @@ public function setNetworkIP($var) } /** - * The type of vNIC to be used on this interface. This may be gVNIC or VirtioNet. + * The type of vNIC to be used on this interface. This may be gVNIC or + * VirtioNet. * Check the NicType enum for the list of possible values. * * Generated from protobuf field optional string nic_type = 59810577; @@ -606,7 +813,8 @@ public function clearNicType() } /** - * The type of vNIC to be used on this interface. This may be gVNIC or VirtioNet. + * The type of vNIC to be used on this interface. This may be gVNIC or + * VirtioNet. * Check the NicType enum for the list of possible values. * * Generated from protobuf field optional string nic_type = 59810577; @@ -658,7 +866,9 @@ public function setParentNicName($var) } /** - * The networking queue count that's specified by users for the network interface. Both Rx and Tx queues will be set to this number. It'll be empty if not specified by the users. + * The networking queue count that's specified by users for the network + * interface. Both Rx and Tx queues will be set to this number. It'll be empty + * if not specified by the users. * * Generated from protobuf field optional int32 queue_count = 503708769; * @return int @@ -679,7 +889,9 @@ public function clearQueueCount() } /** - * The networking queue count that's specified by users for the network interface. Both Rx and Tx queues will be set to this number. It'll be empty if not specified by the users. + * The networking queue count that's specified by users for the network + * interface. Both Rx and Tx queues will be set to this number. It'll be empty + * if not specified by the users. * * Generated from protobuf field optional int32 queue_count = 503708769; * @param int $var @@ -694,7 +906,10 @@ public function setQueueCount($var) } /** - * The stack type for this network interface. To assign only IPv4 addresses, use IPV4_ONLY. To assign both IPv4 and IPv6 addresses, use IPV4_IPV6. If not specified, IPV4_ONLY is used. This field can be both set at instance creation and update network interface operations. + * The stack type for this network interface. To assign only IPv4 addresses, + * use IPV4_ONLY. To assign both IPv4 and IPv6 addresses, useIPV4_IPV6. If not specified, IPV4_ONLY is used. + * This field can be both set at instance creation and update network + * interface operations. * Check the StackType enum for the list of possible values. * * Generated from protobuf field optional string stack_type = 425908881; @@ -716,7 +931,10 @@ public function clearStackType() } /** - * The stack type for this network interface. To assign only IPv4 addresses, use IPV4_ONLY. To assign both IPv4 and IPv6 addresses, use IPV4_IPV6. If not specified, IPV4_ONLY is used. This field can be both set at instance creation and update network interface operations. + * The stack type for this network interface. To assign only IPv4 addresses, + * use IPV4_ONLY. To assign both IPv4 and IPv6 addresses, useIPV4_IPV6. If not specified, IPV4_ONLY is used. + * This field can be both set at instance creation and update network + * interface operations. * Check the StackType enum for the list of possible values. * * Generated from protobuf field optional string stack_type = 425908881; @@ -732,7 +950,15 @@ public function setStackType($var) } /** - * The URL of the Subnetwork resource for this instance. If the network resource is in legacy mode, do not specify this field. If the network is in auto subnet mode, specifying the subnetwork is optional. If the network is in custom subnet mode, specifying the subnetwork is required. If you specify this field, you can specify the subnetwork as a full or partial URL. For example, the following are all valid URLs: - https://www.googleapis.com/compute/v1/projects/project/regions/region /subnetworks/subnetwork - regions/region/subnetworks/subnetwork + * The URL of the Subnetwork resource for this instance. If the network + * resource is inlegacy + * mode, do not specify this field. If the network is in auto subnet + * mode, specifying the subnetwork is optional. If the network is in custom + * subnet mode, specifying the subnetwork is required. If you specify this + * field, you can specify the subnetwork as a full or partial URL. For + * example, the following are all valid URLs: + * - https://www.googleapis.com/compute/v1/projects/project/regions/region/subnetworks/subnetwork + * - regions/region/subnetworks/subnetwork * * Generated from protobuf field optional string subnetwork = 307827694; * @return string @@ -753,7 +979,15 @@ public function clearSubnetwork() } /** - * The URL of the Subnetwork resource for this instance. If the network resource is in legacy mode, do not specify this field. If the network is in auto subnet mode, specifying the subnetwork is optional. If the network is in custom subnet mode, specifying the subnetwork is required. If you specify this field, you can specify the subnetwork as a full or partial URL. For example, the following are all valid URLs: - https://www.googleapis.com/compute/v1/projects/project/regions/region /subnetworks/subnetwork - regions/region/subnetworks/subnetwork + * The URL of the Subnetwork resource for this instance. If the network + * resource is inlegacy + * mode, do not specify this field. If the network is in auto subnet + * mode, specifying the subnetwork is optional. If the network is in custom + * subnet mode, specifying the subnetwork is required. If you specify this + * field, you can specify the subnetwork as a full or partial URL. For + * example, the following are all valid URLs: + * - https://www.googleapis.com/compute/v1/projects/project/regions/region/subnetworks/subnetwork + * - regions/region/subnetworks/subnetwork * * Generated from protobuf field optional string subnetwork = 307827694; * @param string $var @@ -768,7 +1002,8 @@ public function setSubnetwork($var) } /** - * VLAN tag of a dynamic network interface, must be an integer in the range from 2 to 255 inclusively. + * VLAN tag of a dynamic network interface, must be an integer in the range + * from 2 to 255 inclusively. * * Generated from protobuf field optional int32 vlan = 3622243; * @return int @@ -789,7 +1024,8 @@ public function clearVlan() } /** - * VLAN tag of a dynamic network interface, must be an integer in the range from 2 to 255 inclusively. + * VLAN tag of a dynamic network interface, must be an integer in the range + * from 2 to 255 inclusively. * * Generated from protobuf field optional int32 vlan = 3622243; * @param int $var diff --git a/Compute/src/V1/NetworkInterface/IgmpQuery.php b/Compute/src/V1/NetworkInterface/IgmpQuery.php new file mode 100644 index 000000000000..9a3d255bc07c --- /dev/null +++ b/Compute/src/V1/NetworkInterface/IgmpQuery.php @@ -0,0 +1,63 @@ +google.cloud.compute.v1.NetworkInterface.IgmpQuery + */ +class IgmpQuery +{ + /** + * A value indicating that the enum field is not set. + * + * Generated from protobuf enum UNDEFINED_IGMP_QUERY = 0; + */ + const UNDEFINED_IGMP_QUERY = 0; + /** + * The network interface has disabled IGMP query. + * + * Generated from protobuf enum IGMP_QUERY_DISABLED = 28285169; + */ + const IGMP_QUERY_DISABLED = 28285169; + /** + * The network interface has enabled IGMP query - v2. + * + * Generated from protobuf enum IGMP_QUERY_V2 = 333493457; + */ + const IGMP_QUERY_V2 = 333493457; + + private static $valueToName = [ + self::UNDEFINED_IGMP_QUERY => 'UNDEFINED_IGMP_QUERY', + self::IGMP_QUERY_DISABLED => 'IGMP_QUERY_DISABLED', + self::IGMP_QUERY_V2 => 'IGMP_QUERY_V2', + ]; + + public static function name($value) + { + if (!isset(self::$valueToName[$value])) { + throw new UnexpectedValueException(sprintf( + 'Enum %s has no name defined for value %s', __CLASS__, $value)); + } + return self::$valueToName[$value]; + } + + + public static function value($name) + { + $const = __CLASS__ . '::' . strtoupper($name); + if (!defined($const)) { + throw new UnexpectedValueException(sprintf( + 'Enum %s has no value defined for name %s', __CLASS__, $name)); + } + return constant($const); + } +} + + diff --git a/Compute/src/V1/NetworkInterface/Ipv6AccessType.php b/Compute/src/V1/NetworkInterface/Ipv6AccessType.php index 6e974e291a39..7c89feba38ed 100644 --- a/Compute/src/V1/NetworkInterface/Ipv6AccessType.php +++ b/Compute/src/V1/NetworkInterface/Ipv6AccessType.php @@ -7,7 +7,10 @@ use UnexpectedValueException; /** - * [Output Only] One of EXTERNAL, INTERNAL to indicate whether the IP can be accessed from the Internet. This field is always inherited from its subnetwork. Valid only if stackType is IPV4_IPV6. + * [Output Only] One of EXTERNAL, INTERNAL to indicate whether the IP can be + * accessed from the Internet. This field is always inherited from its + * subnetwork. + * Valid only if stackType is IPV4_IPV6. * * Protobuf type google.cloud.compute.v1.NetworkInterface.Ipv6AccessType */ diff --git a/Compute/src/V1/NetworkInterface/NicType.php b/Compute/src/V1/NetworkInterface/NicType.php index 79d73efc2952..4ec54a923b34 100644 --- a/Compute/src/V1/NetworkInterface/NicType.php +++ b/Compute/src/V1/NetworkInterface/NicType.php @@ -7,7 +7,8 @@ use UnexpectedValueException; /** - * The type of vNIC to be used on this interface. This may be gVNIC or VirtioNet. + * The type of vNIC to be used on this interface. This may be gVNIC or + * VirtioNet. * * Protobuf type google.cloud.compute.v1.NetworkInterface.NicType */ diff --git a/Compute/src/V1/NetworkInterface/StackType.php b/Compute/src/V1/NetworkInterface/StackType.php index 8d5b46218763..0137d890cf0a 100644 --- a/Compute/src/V1/NetworkInterface/StackType.php +++ b/Compute/src/V1/NetworkInterface/StackType.php @@ -7,7 +7,10 @@ use UnexpectedValueException; /** - * The stack type for this network interface. To assign only IPv4 addresses, use IPV4_ONLY. To assign both IPv4 and IPv6 addresses, use IPV4_IPV6. If not specified, IPV4_ONLY is used. This field can be both set at instance creation and update network interface operations. + * The stack type for this network interface. To assign only IPv4 addresses, + * use IPV4_ONLY. To assign both IPv4 and IPv6 addresses, useIPV4_IPV6. If not specified, IPV4_ONLY is used. + * This field can be both set at instance creation and update network + * interface operations. * * Protobuf type google.cloud.compute.v1.NetworkInterface.StackType */ diff --git a/Compute/src/V1/NetworkList.php b/Compute/src/V1/NetworkList.php index bdce11a10503..bca0e11c3eea 100644 --- a/Compute/src/V1/NetworkList.php +++ b/Compute/src/V1/NetworkList.php @@ -28,13 +28,18 @@ class NetworkList extends \Google\Protobuf\Internal\Message */ private $items; /** - * [Output Only] Type of resource. Always compute#networkList for lists of networks. + * [Output Only] Type of resource. Always compute#networkList for + * lists of networks. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -63,9 +68,14 @@ class NetworkList extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\Network>|\Google\Protobuf\Internal\RepeatedField $items * A list of Network resources. * @type string $kind - * [Output Only] Type of resource. Always compute#networkList for lists of networks. + * [Output Only] Type of resource. Always compute#networkList for + * lists of networks. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type \Google\Cloud\Compute\V1\Warning $warning @@ -140,7 +150,8 @@ public function setItems($var) } /** - * [Output Only] Type of resource. Always compute#networkList for lists of networks. + * [Output Only] Type of resource. Always compute#networkList for + * lists of networks. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -161,7 +172,8 @@ public function clearKind() } /** - * [Output Only] Type of resource. Always compute#networkList for lists of networks. + * [Output Only] Type of resource. Always compute#networkList for + * lists of networks. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -176,7 +188,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -197,7 +213,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/NetworkParams.php b/Compute/src/V1/NetworkParams.php index 934746db8506..2dee100d3f18 100644 --- a/Compute/src/V1/NetworkParams.php +++ b/Compute/src/V1/NetworkParams.php @@ -16,7 +16,18 @@ class NetworkParams extends \Google\Protobuf\Internal\Message { /** - * Tag keys/values directly bound to this resource. Tag keys and values have the same definition as resource manager tags. The field is allowed for INSERT only. The keys/values to set on the resource should be specified in either ID { : } or Namespaced format { : }. For example the following are valid inputs: * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} * {"123/environment" : "production", "345/abc" : "xyz"} Note: * Invalid combinations of ID & namespaced format is not supported. For instance: {"123/environment" : "tagValues/444"} is invalid. + * Tag keys/values directly bound to this resource. + * Tag keys and values have the same definition as resource + * manager tags. The field is allowed for INSERT + * only. The keys/values to set on the resource should be specified in + * either ID { : } or Namespaced format + * { : }. + * For example the following are valid inputs: + * * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} + * * {"123/environment" : "production", "345/abc" : "xyz"} + * Note: + * * Invalid combinations of ID & namespaced format is not supported. For + * instance: {"123/environment" : "tagValues/444"} is invalid. * * Generated from protobuf field map resource_manager_tags = 377671164; */ @@ -29,7 +40,18 @@ class NetworkParams extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type array|\Google\Protobuf\Internal\MapField $resource_manager_tags - * Tag keys/values directly bound to this resource. Tag keys and values have the same definition as resource manager tags. The field is allowed for INSERT only. The keys/values to set on the resource should be specified in either ID { : } or Namespaced format { : }. For example the following are valid inputs: * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} * {"123/environment" : "production", "345/abc" : "xyz"} Note: * Invalid combinations of ID & namespaced format is not supported. For instance: {"123/environment" : "tagValues/444"} is invalid. + * Tag keys/values directly bound to this resource. + * Tag keys and values have the same definition as resource + * manager tags. The field is allowed for INSERT + * only. The keys/values to set on the resource should be specified in + * either ID { : } or Namespaced format + * { : }. + * For example the following are valid inputs: + * * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} + * * {"123/environment" : "production", "345/abc" : "xyz"} + * Note: + * * Invalid combinations of ID & namespaced format is not supported. For + * instance: {"123/environment" : "tagValues/444"} is invalid. * } */ public function __construct($data = NULL) { @@ -38,7 +60,18 @@ public function __construct($data = NULL) { } /** - * Tag keys/values directly bound to this resource. Tag keys and values have the same definition as resource manager tags. The field is allowed for INSERT only. The keys/values to set on the resource should be specified in either ID { : } or Namespaced format { : }. For example the following are valid inputs: * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} * {"123/environment" : "production", "345/abc" : "xyz"} Note: * Invalid combinations of ID & namespaced format is not supported. For instance: {"123/environment" : "tagValues/444"} is invalid. + * Tag keys/values directly bound to this resource. + * Tag keys and values have the same definition as resource + * manager tags. The field is allowed for INSERT + * only. The keys/values to set on the resource should be specified in + * either ID { : } or Namespaced format + * { : }. + * For example the following are valid inputs: + * * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} + * * {"123/environment" : "production", "345/abc" : "xyz"} + * Note: + * * Invalid combinations of ID & namespaced format is not supported. For + * instance: {"123/environment" : "tagValues/444"} is invalid. * * Generated from protobuf field map resource_manager_tags = 377671164; * @return \Google\Protobuf\Internal\MapField @@ -49,7 +82,18 @@ public function getResourceManagerTags() } /** - * Tag keys/values directly bound to this resource. Tag keys and values have the same definition as resource manager tags. The field is allowed for INSERT only. The keys/values to set on the resource should be specified in either ID { : } or Namespaced format { : }. For example the following are valid inputs: * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} * {"123/environment" : "production", "345/abc" : "xyz"} Note: * Invalid combinations of ID & namespaced format is not supported. For instance: {"123/environment" : "tagValues/444"} is invalid. + * Tag keys/values directly bound to this resource. + * Tag keys and values have the same definition as resource + * manager tags. The field is allowed for INSERT + * only. The keys/values to set on the resource should be specified in + * either ID { : } or Namespaced format + * { : }. + * For example the following are valid inputs: + * * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} + * * {"123/environment" : "production", "345/abc" : "xyz"} + * Note: + * * Invalid combinations of ID & namespaced format is not supported. For + * instance: {"123/environment" : "tagValues/444"} is invalid. * * Generated from protobuf field map resource_manager_tags = 377671164; * @param array|\Google\Protobuf\Internal\MapField $var diff --git a/Compute/src/V1/NetworkPeering.php b/Compute/src/V1/NetworkPeering.php index 7b7b089d910c..366719c4a647 100644 --- a/Compute/src/V1/NetworkPeering.php +++ b/Compute/src/V1/NetworkPeering.php @@ -9,62 +9,89 @@ use Google\Protobuf\Internal\GPBUtil; /** - * A network peering attached to a network resource. The message includes the peering name, peer network, peering state, and a flag indicating whether Google Compute Engine should automatically create routes for the peering. + * A network peering attached to a network resource. The message includes the + * peering name, peer network, peering state, and a flag indicating whether + * Google Compute Engine should automatically create routes for the peering. * * Generated from protobuf message google.cloud.compute.v1.NetworkPeering */ class NetworkPeering extends \Google\Protobuf\Internal\Message { /** - * This field will be deprecated soon. Use the exchange_subnet_routes field instead. Indicates whether full mesh connectivity is created and managed automatically between peered networks. Currently this field should always be true since Google Compute Engine will automatically create and manage subnetwork routes between two networks when peering state is ACTIVE. + * This field will be deprecated soon. Use theexchange_subnet_routes field instead. + * Indicates whether full mesh connectivity is created and managed + * automatically between peered networks. Currently this field should always + * be true since Google Compute Engine will automatically create and manage + * subnetwork routes between two networks when peering state isACTIVE. * * Generated from protobuf field optional bool auto_create_routes = 57454941; */ protected $auto_create_routes = null; /** - * [Output Only] The effective state of the peering connection as a whole. + * [Output Only] The effective state of the peering connection + * as a whole. * * Generated from protobuf field optional .google.cloud.compute.v1.NetworkPeeringConnectionStatus connection_status = 525629555; */ protected $connection_status = null; /** - * Indicates whether full mesh connectivity is created and managed automatically between peered networks. Currently this field should always be true since Google Compute Engine will automatically create and manage subnetwork routes between two networks when peering state is ACTIVE. + * Indicates whether full mesh connectivity is created and managed + * automatically between peered networks. Currently this field should always + * be true since Google Compute Engine will automatically create and manage + * subnetwork routes between two networks when peering state isACTIVE. * * Generated from protobuf field optional bool exchange_subnet_routes = 26322256; */ protected $exchange_subnet_routes = null; /** - * Whether to export the custom routes to peer network. The default value is false. + * Whether to export the custom routes to peer network. The default value is + * false. * * Generated from protobuf field optional bool export_custom_routes = 60281485; */ protected $export_custom_routes = null; /** - * Whether subnet routes with public IP range are exported. The default value is true, all subnet routes are exported. IPv4 special-use ranges are always exported to peers and are not controlled by this field. + * Whether subnet routes with public IP range are exported. The default value + * is true, all subnet routes are exported.IPv4 + * special-use ranges are always + * exported to peers and are not controlled by this field. * * Generated from protobuf field optional bool export_subnet_routes_with_public_ip = 97940834; */ protected $export_subnet_routes_with_public_ip = null; /** - * Whether to import the custom routes from peer network. The default value is false. + * Whether to import the custom routes from peer network. The default value is + * false. * * Generated from protobuf field optional bool import_custom_routes = 197982398; */ protected $import_custom_routes = null; /** - * Whether subnet routes with public IP range are imported. The default value is false. IPv4 special-use ranges are always imported from peers and are not controlled by this field. + * Whether subnet routes with public IP range are imported. The default value + * is false.IPv4 + * special-use ranges are always + * imported from peers and are not controlled by this field. * * Generated from protobuf field optional bool import_subnet_routes_with_public_ip = 14419729; */ protected $import_subnet_routes_with_public_ip = null; /** - * Name of this peering. Provided by the client when the peering is created. The name must comply with RFC1035. Specifically, the name must be 1-63 characters long and match regular expression `[a-z]([-a-z0-9]*[a-z0-9])?`. The first character must be a lowercase letter, and all the following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of this peering. Provided by the client when the peering is created. + * The name must comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?`. The first character must be a + * lowercase letter, and all the following characters must be a dash, + * lowercase letter, or digit, except the last character, which cannot be a + * dash. * * Generated from protobuf field optional string name = 3373707; */ protected $name = null; /** - * The URL of the peer network. It can be either full URL or partial URL. The peer network may belong to a different project. If the partial URL does not contain project, it is assumed that the peer network is in the same project as the current network. + * The URL of the peer network. It can be either full URL or partial URL. The + * peer network may belong to a different project. If the partial URL does not + * contain project, it is assumed that the peer network is in the same project + * as the current network. * * Generated from protobuf field optional string network = 232872494; */ @@ -76,14 +103,17 @@ class NetworkPeering extends \Google\Protobuf\Internal\Message */ protected $peer_mtu = null; /** - * Which IP version(s) of traffic and routes are allowed to be imported or exported between peer networks. The default value is IPV4_ONLY. + * Which IP version(s) of traffic and routes are allowed to be imported or + * exported between peer networks. The default value is IPV4_ONLY. * Check the StackType enum for the list of possible values. * * Generated from protobuf field optional string stack_type = 425908881; */ protected $stack_type = null; /** - * [Output Only] State for the peering, either `ACTIVE` or `INACTIVE`. The peering is `ACTIVE` when there's a matching configuration in the peer network. + * [Output Only] State for the peering, either `ACTIVE` or `INACTIVE`. The + * peering is `ACTIVE` when there's a matching configuration in the peer + * network. * Check the State enum for the list of possible values. * * Generated from protobuf field optional string state = 109757585; @@ -96,7 +126,8 @@ class NetworkPeering extends \Google\Protobuf\Internal\Message */ protected $state_details = null; /** - * The update strategy determines the semantics for updates and deletes to the peering connection configuration. + * The update strategy determines the semantics for updates and deletes to the + * peering connection configuration. * Check the UpdateStrategy enum for the list of possible values. * * Generated from protobuf field optional string update_strategy = 6123049; @@ -110,35 +141,64 @@ class NetworkPeering extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type bool $auto_create_routes - * This field will be deprecated soon. Use the exchange_subnet_routes field instead. Indicates whether full mesh connectivity is created and managed automatically between peered networks. Currently this field should always be true since Google Compute Engine will automatically create and manage subnetwork routes between two networks when peering state is ACTIVE. + * This field will be deprecated soon. Use theexchange_subnet_routes field instead. + * Indicates whether full mesh connectivity is created and managed + * automatically between peered networks. Currently this field should always + * be true since Google Compute Engine will automatically create and manage + * subnetwork routes between two networks when peering state isACTIVE. * @type \Google\Cloud\Compute\V1\NetworkPeeringConnectionStatus $connection_status - * [Output Only] The effective state of the peering connection as a whole. + * [Output Only] The effective state of the peering connection + * as a whole. * @type bool $exchange_subnet_routes - * Indicates whether full mesh connectivity is created and managed automatically between peered networks. Currently this field should always be true since Google Compute Engine will automatically create and manage subnetwork routes between two networks when peering state is ACTIVE. + * Indicates whether full mesh connectivity is created and managed + * automatically between peered networks. Currently this field should always + * be true since Google Compute Engine will automatically create and manage + * subnetwork routes between two networks when peering state isACTIVE. * @type bool $export_custom_routes - * Whether to export the custom routes to peer network. The default value is false. + * Whether to export the custom routes to peer network. The default value is + * false. * @type bool $export_subnet_routes_with_public_ip - * Whether subnet routes with public IP range are exported. The default value is true, all subnet routes are exported. IPv4 special-use ranges are always exported to peers and are not controlled by this field. + * Whether subnet routes with public IP range are exported. The default value + * is true, all subnet routes are exported.IPv4 + * special-use ranges are always + * exported to peers and are not controlled by this field. * @type bool $import_custom_routes - * Whether to import the custom routes from peer network. The default value is false. + * Whether to import the custom routes from peer network. The default value is + * false. * @type bool $import_subnet_routes_with_public_ip - * Whether subnet routes with public IP range are imported. The default value is false. IPv4 special-use ranges are always imported from peers and are not controlled by this field. + * Whether subnet routes with public IP range are imported. The default value + * is false.IPv4 + * special-use ranges are always + * imported from peers and are not controlled by this field. * @type string $name - * Name of this peering. Provided by the client when the peering is created. The name must comply with RFC1035. Specifically, the name must be 1-63 characters long and match regular expression `[a-z]([-a-z0-9]*[a-z0-9])?`. The first character must be a lowercase letter, and all the following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of this peering. Provided by the client when the peering is created. + * The name must comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?`. The first character must be a + * lowercase letter, and all the following characters must be a dash, + * lowercase letter, or digit, except the last character, which cannot be a + * dash. * @type string $network - * The URL of the peer network. It can be either full URL or partial URL. The peer network may belong to a different project. If the partial URL does not contain project, it is assumed that the peer network is in the same project as the current network. + * The URL of the peer network. It can be either full URL or partial URL. The + * peer network may belong to a different project. If the partial URL does not + * contain project, it is assumed that the peer network is in the same project + * as the current network. * @type int $peer_mtu * [Output Only] Maximum Transmission Unit in bytes of the peer network. * @type string $stack_type - * Which IP version(s) of traffic and routes are allowed to be imported or exported between peer networks. The default value is IPV4_ONLY. + * Which IP version(s) of traffic and routes are allowed to be imported or + * exported between peer networks. The default value is IPV4_ONLY. * Check the StackType enum for the list of possible values. * @type string $state - * [Output Only] State for the peering, either `ACTIVE` or `INACTIVE`. The peering is `ACTIVE` when there's a matching configuration in the peer network. + * [Output Only] State for the peering, either `ACTIVE` or `INACTIVE`. The + * peering is `ACTIVE` when there's a matching configuration in the peer + * network. * Check the State enum for the list of possible values. * @type string $state_details * [Output Only] Details about the current state of the peering. * @type string $update_strategy - * The update strategy determines the semantics for updates and deletes to the peering connection configuration. + * The update strategy determines the semantics for updates and deletes to the + * peering connection configuration. * Check the UpdateStrategy enum for the list of possible values. * } */ @@ -148,7 +208,11 @@ public function __construct($data = NULL) { } /** - * This field will be deprecated soon. Use the exchange_subnet_routes field instead. Indicates whether full mesh connectivity is created and managed automatically between peered networks. Currently this field should always be true since Google Compute Engine will automatically create and manage subnetwork routes between two networks when peering state is ACTIVE. + * This field will be deprecated soon. Use theexchange_subnet_routes field instead. + * Indicates whether full mesh connectivity is created and managed + * automatically between peered networks. Currently this field should always + * be true since Google Compute Engine will automatically create and manage + * subnetwork routes between two networks when peering state isACTIVE. * * Generated from protobuf field optional bool auto_create_routes = 57454941; * @return bool @@ -169,7 +233,11 @@ public function clearAutoCreateRoutes() } /** - * This field will be deprecated soon. Use the exchange_subnet_routes field instead. Indicates whether full mesh connectivity is created and managed automatically between peered networks. Currently this field should always be true since Google Compute Engine will automatically create and manage subnetwork routes between two networks when peering state is ACTIVE. + * This field will be deprecated soon. Use theexchange_subnet_routes field instead. + * Indicates whether full mesh connectivity is created and managed + * automatically between peered networks. Currently this field should always + * be true since Google Compute Engine will automatically create and manage + * subnetwork routes between two networks when peering state isACTIVE. * * Generated from protobuf field optional bool auto_create_routes = 57454941; * @param bool $var @@ -184,7 +252,8 @@ public function setAutoCreateRoutes($var) } /** - * [Output Only] The effective state of the peering connection as a whole. + * [Output Only] The effective state of the peering connection + * as a whole. * * Generated from protobuf field optional .google.cloud.compute.v1.NetworkPeeringConnectionStatus connection_status = 525629555; * @return \Google\Cloud\Compute\V1\NetworkPeeringConnectionStatus|null @@ -205,7 +274,8 @@ public function clearConnectionStatus() } /** - * [Output Only] The effective state of the peering connection as a whole. + * [Output Only] The effective state of the peering connection + * as a whole. * * Generated from protobuf field optional .google.cloud.compute.v1.NetworkPeeringConnectionStatus connection_status = 525629555; * @param \Google\Cloud\Compute\V1\NetworkPeeringConnectionStatus $var @@ -220,7 +290,10 @@ public function setConnectionStatus($var) } /** - * Indicates whether full mesh connectivity is created and managed automatically between peered networks. Currently this field should always be true since Google Compute Engine will automatically create and manage subnetwork routes between two networks when peering state is ACTIVE. + * Indicates whether full mesh connectivity is created and managed + * automatically between peered networks. Currently this field should always + * be true since Google Compute Engine will automatically create and manage + * subnetwork routes between two networks when peering state isACTIVE. * * Generated from protobuf field optional bool exchange_subnet_routes = 26322256; * @return bool @@ -241,7 +314,10 @@ public function clearExchangeSubnetRoutes() } /** - * Indicates whether full mesh connectivity is created and managed automatically between peered networks. Currently this field should always be true since Google Compute Engine will automatically create and manage subnetwork routes between two networks when peering state is ACTIVE. + * Indicates whether full mesh connectivity is created and managed + * automatically between peered networks. Currently this field should always + * be true since Google Compute Engine will automatically create and manage + * subnetwork routes between two networks when peering state isACTIVE. * * Generated from protobuf field optional bool exchange_subnet_routes = 26322256; * @param bool $var @@ -256,7 +332,8 @@ public function setExchangeSubnetRoutes($var) } /** - * Whether to export the custom routes to peer network. The default value is false. + * Whether to export the custom routes to peer network. The default value is + * false. * * Generated from protobuf field optional bool export_custom_routes = 60281485; * @return bool @@ -277,7 +354,8 @@ public function clearExportCustomRoutes() } /** - * Whether to export the custom routes to peer network. The default value is false. + * Whether to export the custom routes to peer network. The default value is + * false. * * Generated from protobuf field optional bool export_custom_routes = 60281485; * @param bool $var @@ -292,7 +370,10 @@ public function setExportCustomRoutes($var) } /** - * Whether subnet routes with public IP range are exported. The default value is true, all subnet routes are exported. IPv4 special-use ranges are always exported to peers and are not controlled by this field. + * Whether subnet routes with public IP range are exported. The default value + * is true, all subnet routes are exported.IPv4 + * special-use ranges are always + * exported to peers and are not controlled by this field. * * Generated from protobuf field optional bool export_subnet_routes_with_public_ip = 97940834; * @return bool @@ -313,7 +394,10 @@ public function clearExportSubnetRoutesWithPublicIp() } /** - * Whether subnet routes with public IP range are exported. The default value is true, all subnet routes are exported. IPv4 special-use ranges are always exported to peers and are not controlled by this field. + * Whether subnet routes with public IP range are exported. The default value + * is true, all subnet routes are exported.IPv4 + * special-use ranges are always + * exported to peers and are not controlled by this field. * * Generated from protobuf field optional bool export_subnet_routes_with_public_ip = 97940834; * @param bool $var @@ -328,7 +412,8 @@ public function setExportSubnetRoutesWithPublicIp($var) } /** - * Whether to import the custom routes from peer network. The default value is false. + * Whether to import the custom routes from peer network. The default value is + * false. * * Generated from protobuf field optional bool import_custom_routes = 197982398; * @return bool @@ -349,7 +434,8 @@ public function clearImportCustomRoutes() } /** - * Whether to import the custom routes from peer network. The default value is false. + * Whether to import the custom routes from peer network. The default value is + * false. * * Generated from protobuf field optional bool import_custom_routes = 197982398; * @param bool $var @@ -364,7 +450,10 @@ public function setImportCustomRoutes($var) } /** - * Whether subnet routes with public IP range are imported. The default value is false. IPv4 special-use ranges are always imported from peers and are not controlled by this field. + * Whether subnet routes with public IP range are imported. The default value + * is false.IPv4 + * special-use ranges are always + * imported from peers and are not controlled by this field. * * Generated from protobuf field optional bool import_subnet_routes_with_public_ip = 14419729; * @return bool @@ -385,7 +474,10 @@ public function clearImportSubnetRoutesWithPublicIp() } /** - * Whether subnet routes with public IP range are imported. The default value is false. IPv4 special-use ranges are always imported from peers and are not controlled by this field. + * Whether subnet routes with public IP range are imported. The default value + * is false.IPv4 + * special-use ranges are always + * imported from peers and are not controlled by this field. * * Generated from protobuf field optional bool import_subnet_routes_with_public_ip = 14419729; * @param bool $var @@ -400,7 +492,13 @@ public function setImportSubnetRoutesWithPublicIp($var) } /** - * Name of this peering. Provided by the client when the peering is created. The name must comply with RFC1035. Specifically, the name must be 1-63 characters long and match regular expression `[a-z]([-a-z0-9]*[a-z0-9])?`. The first character must be a lowercase letter, and all the following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of this peering. Provided by the client when the peering is created. + * The name must comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?`. The first character must be a + * lowercase letter, and all the following characters must be a dash, + * lowercase letter, or digit, except the last character, which cannot be a + * dash. * * Generated from protobuf field optional string name = 3373707; * @return string @@ -421,7 +519,13 @@ public function clearName() } /** - * Name of this peering. Provided by the client when the peering is created. The name must comply with RFC1035. Specifically, the name must be 1-63 characters long and match regular expression `[a-z]([-a-z0-9]*[a-z0-9])?`. The first character must be a lowercase letter, and all the following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of this peering. Provided by the client when the peering is created. + * The name must comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?`. The first character must be a + * lowercase letter, and all the following characters must be a dash, + * lowercase letter, or digit, except the last character, which cannot be a + * dash. * * Generated from protobuf field optional string name = 3373707; * @param string $var @@ -436,7 +540,10 @@ public function setName($var) } /** - * The URL of the peer network. It can be either full URL or partial URL. The peer network may belong to a different project. If the partial URL does not contain project, it is assumed that the peer network is in the same project as the current network. + * The URL of the peer network. It can be either full URL or partial URL. The + * peer network may belong to a different project. If the partial URL does not + * contain project, it is assumed that the peer network is in the same project + * as the current network. * * Generated from protobuf field optional string network = 232872494; * @return string @@ -457,7 +564,10 @@ public function clearNetwork() } /** - * The URL of the peer network. It can be either full URL or partial URL. The peer network may belong to a different project. If the partial URL does not contain project, it is assumed that the peer network is in the same project as the current network. + * The URL of the peer network. It can be either full URL or partial URL. The + * peer network may belong to a different project. If the partial URL does not + * contain project, it is assumed that the peer network is in the same project + * as the current network. * * Generated from protobuf field optional string network = 232872494; * @param string $var @@ -508,7 +618,8 @@ public function setPeerMtu($var) } /** - * Which IP version(s) of traffic and routes are allowed to be imported or exported between peer networks. The default value is IPV4_ONLY. + * Which IP version(s) of traffic and routes are allowed to be imported or + * exported between peer networks. The default value is IPV4_ONLY. * Check the StackType enum for the list of possible values. * * Generated from protobuf field optional string stack_type = 425908881; @@ -530,7 +641,8 @@ public function clearStackType() } /** - * Which IP version(s) of traffic and routes are allowed to be imported or exported between peer networks. The default value is IPV4_ONLY. + * Which IP version(s) of traffic and routes are allowed to be imported or + * exported between peer networks. The default value is IPV4_ONLY. * Check the StackType enum for the list of possible values. * * Generated from protobuf field optional string stack_type = 425908881; @@ -546,7 +658,9 @@ public function setStackType($var) } /** - * [Output Only] State for the peering, either `ACTIVE` or `INACTIVE`. The peering is `ACTIVE` when there's a matching configuration in the peer network. + * [Output Only] State for the peering, either `ACTIVE` or `INACTIVE`. The + * peering is `ACTIVE` when there's a matching configuration in the peer + * network. * Check the State enum for the list of possible values. * * Generated from protobuf field optional string state = 109757585; @@ -568,7 +682,9 @@ public function clearState() } /** - * [Output Only] State for the peering, either `ACTIVE` or `INACTIVE`. The peering is `ACTIVE` when there's a matching configuration in the peer network. + * [Output Only] State for the peering, either `ACTIVE` or `INACTIVE`. The + * peering is `ACTIVE` when there's a matching configuration in the peer + * network. * Check the State enum for the list of possible values. * * Generated from protobuf field optional string state = 109757585; @@ -620,7 +736,8 @@ public function setStateDetails($var) } /** - * The update strategy determines the semantics for updates and deletes to the peering connection configuration. + * The update strategy determines the semantics for updates and deletes to the + * peering connection configuration. * Check the UpdateStrategy enum for the list of possible values. * * Generated from protobuf field optional string update_strategy = 6123049; @@ -642,7 +759,8 @@ public function clearUpdateStrategy() } /** - * The update strategy determines the semantics for updates and deletes to the peering connection configuration. + * The update strategy determines the semantics for updates and deletes to the + * peering connection configuration. * Check the UpdateStrategy enum for the list of possible values. * * Generated from protobuf field optional string update_strategy = 6123049; diff --git a/Compute/src/V1/NetworkPeering/StackType.php b/Compute/src/V1/NetworkPeering/StackType.php index bb476db81f28..0bd106d4cf38 100644 --- a/Compute/src/V1/NetworkPeering/StackType.php +++ b/Compute/src/V1/NetworkPeering/StackType.php @@ -7,7 +7,8 @@ use UnexpectedValueException; /** - * Which IP version(s) of traffic and routes are allowed to be imported or exported between peer networks. The default value is IPV4_ONLY. + * Which IP version(s) of traffic and routes are allowed to be imported or + * exported between peer networks. The default value is IPV4_ONLY. * * Protobuf type google.cloud.compute.v1.NetworkPeering.StackType */ @@ -20,13 +21,17 @@ class StackType */ const UNDEFINED_STACK_TYPE = 0; /** - * This Peering will allow IPv4 traffic and routes to be exchanged. Additionally if the matching peering is IPV4_IPV6, IPv6 traffic and routes will be exchanged as well. + * This Peering will allow IPv4 traffic and routes to be + * exchanged. Additionally if the matching peering is + * IPV4_IPV6, IPv6 traffic and routes will be exchanged as + * well. * * Generated from protobuf enum IPV4_IPV6 = 22197249; */ const IPV4_IPV6 = 22197249; /** - * This Peering will only allow IPv4 traffic and routes to be exchanged, even if the matching peering is IPV4_IPV6. + * This Peering will only allow IPv4 traffic and routes to be + * exchanged, even if the matching peering is IPV4_IPV6. * * Generated from protobuf enum IPV4_ONLY = 22373798; */ diff --git a/Compute/src/V1/NetworkPeering/State.php b/Compute/src/V1/NetworkPeering/State.php index 2b6698ae1523..13710683f047 100644 --- a/Compute/src/V1/NetworkPeering/State.php +++ b/Compute/src/V1/NetworkPeering/State.php @@ -7,7 +7,9 @@ use UnexpectedValueException; /** - * [Output Only] State for the peering, either `ACTIVE` or `INACTIVE`. The peering is `ACTIVE` when there's a matching configuration in the peer network. + * [Output Only] State for the peering, either `ACTIVE` or `INACTIVE`. The + * peering is `ACTIVE` when there's a matching configuration in the peer + * network. * * Protobuf type google.cloud.compute.v1.NetworkPeering.State */ @@ -26,7 +28,8 @@ class State */ const ACTIVE = 314733318; /** - * There is no matching configuration on the peer, including the case when peer does not exist. + * There is no matching configuration on the peer, including the case when + * peer does not exist. * * Generated from protobuf enum INACTIVE = 270421099; */ diff --git a/Compute/src/V1/NetworkPeering/UpdateStrategy.php b/Compute/src/V1/NetworkPeering/UpdateStrategy.php index 13506c7d6b45..cd83d16da770 100644 --- a/Compute/src/V1/NetworkPeering/UpdateStrategy.php +++ b/Compute/src/V1/NetworkPeering/UpdateStrategy.php @@ -7,7 +7,8 @@ use UnexpectedValueException; /** - * The update strategy determines the semantics for updates and deletes to the peering connection configuration. + * The update strategy determines the semantics for updates and deletes to the + * peering connection configuration. * * Protobuf type google.cloud.compute.v1.NetworkPeering.UpdateStrategy */ @@ -20,19 +21,27 @@ class UpdateStrategy */ const UNDEFINED_UPDATE_STRATEGY = 0; /** - * Updates are reflected in the local peering but aren't applied to the peering connection until a complementary change is made to the matching peering. To delete a peering with the consensus update strategy, both the peerings must request the deletion of the peering before the peering can be deleted. + * Updates are reflected in the local peering but aren't applied to the + * peering connection until a complementary change is made to the + * matching peering. + * To delete a peering with the consensus update strategy, both the peerings + * must request the deletion of the peering before the peering can be + * deleted. * * Generated from protobuf enum CONSENSUS = 203373655; */ const CONSENSUS = 203373655; /** - * In this mode, changes to the peering configuration can be unilaterally altered by changing either side of the peering. This is the default value if the field is unspecified. + * In this mode, changes to the peering configuration can + * be unilaterally altered by changing either side of the peering. + * This is the default value if the field is unspecified. * * Generated from protobuf enum INDEPENDENT = 127011674; */ const INDEPENDENT = 127011674; /** - * Peerings with update strategy UNSPECIFIED are created with update strategy INDEPENDENT. + * Peerings with update strategy UNSPECIFIED are created with + * update strategy INDEPENDENT. * * Generated from protobuf enum UNSPECIFIED = 526786327; */ diff --git a/Compute/src/V1/NetworkPeeringConnectionStatus.php b/Compute/src/V1/NetworkPeeringConnectionStatus.php index 5b93a66a8e8c..ac39b487d01c 100644 --- a/Compute/src/V1/NetworkPeeringConnectionStatus.php +++ b/Compute/src/V1/NetworkPeeringConnectionStatus.php @@ -9,26 +9,32 @@ use Google\Protobuf\Internal\GPBUtil; /** - * [Output Only] Describes the state of a peering connection, not just the local peering. This field provides information about the effective settings for the connection as a whole, including pending delete/update requests for CONSENSUS peerings. + * [Output Only] Describes the state of a peering connection, not just the + * local peering. This field provides information about the effective settings + * for the connection as a whole, including pending delete/update requests for + * CONSENSUS peerings. * * Generated from protobuf message google.cloud.compute.v1.NetworkPeeringConnectionStatus */ class NetworkPeeringConnectionStatus extends \Google\Protobuf\Internal\Message { /** - * The consensus state contains information about the status of update and delete for a consensus peering connection. + * The consensus state contains information about the status of update + * and delete for a consensus peering connection. * * Generated from protobuf field optional .google.cloud.compute.v1.NetworkPeeringConnectionStatusConsensusState consensus_state = 379772617; */ protected $consensus_state = null; /** - * The active connectivity settings for the peering connection based on the settings of the network peerings. + * The active connectivity settings for the peering connection based on the + * settings of the network peerings. * * Generated from protobuf field optional .google.cloud.compute.v1.NetworkPeeringConnectionStatusTrafficConfiguration traffic_configuration = 133016116; */ protected $traffic_configuration = null; /** - * The update strategy determines the update/delete semantics for this peering connection. + * The update strategy determines the update/delete semantics for this + * peering connection. * Check the UpdateStrategy enum for the list of possible values. * * Generated from protobuf field optional string update_strategy = 6123049; @@ -42,11 +48,14 @@ class NetworkPeeringConnectionStatus extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type \Google\Cloud\Compute\V1\NetworkPeeringConnectionStatusConsensusState $consensus_state - * The consensus state contains information about the status of update and delete for a consensus peering connection. + * The consensus state contains information about the status of update + * and delete for a consensus peering connection. * @type \Google\Cloud\Compute\V1\NetworkPeeringConnectionStatusTrafficConfiguration $traffic_configuration - * The active connectivity settings for the peering connection based on the settings of the network peerings. + * The active connectivity settings for the peering connection based on the + * settings of the network peerings. * @type string $update_strategy - * The update strategy determines the update/delete semantics for this peering connection. + * The update strategy determines the update/delete semantics for this + * peering connection. * Check the UpdateStrategy enum for the list of possible values. * } */ @@ -56,7 +65,8 @@ public function __construct($data = NULL) { } /** - * The consensus state contains information about the status of update and delete for a consensus peering connection. + * The consensus state contains information about the status of update + * and delete for a consensus peering connection. * * Generated from protobuf field optional .google.cloud.compute.v1.NetworkPeeringConnectionStatusConsensusState consensus_state = 379772617; * @return \Google\Cloud\Compute\V1\NetworkPeeringConnectionStatusConsensusState|null @@ -77,7 +87,8 @@ public function clearConsensusState() } /** - * The consensus state contains information about the status of update and delete for a consensus peering connection. + * The consensus state contains information about the status of update + * and delete for a consensus peering connection. * * Generated from protobuf field optional .google.cloud.compute.v1.NetworkPeeringConnectionStatusConsensusState consensus_state = 379772617; * @param \Google\Cloud\Compute\V1\NetworkPeeringConnectionStatusConsensusState $var @@ -92,7 +103,8 @@ public function setConsensusState($var) } /** - * The active connectivity settings for the peering connection based on the settings of the network peerings. + * The active connectivity settings for the peering connection based on the + * settings of the network peerings. * * Generated from protobuf field optional .google.cloud.compute.v1.NetworkPeeringConnectionStatusTrafficConfiguration traffic_configuration = 133016116; * @return \Google\Cloud\Compute\V1\NetworkPeeringConnectionStatusTrafficConfiguration|null @@ -113,7 +125,8 @@ public function clearTrafficConfiguration() } /** - * The active connectivity settings for the peering connection based on the settings of the network peerings. + * The active connectivity settings for the peering connection based on the + * settings of the network peerings. * * Generated from protobuf field optional .google.cloud.compute.v1.NetworkPeeringConnectionStatusTrafficConfiguration traffic_configuration = 133016116; * @param \Google\Cloud\Compute\V1\NetworkPeeringConnectionStatusTrafficConfiguration $var @@ -128,7 +141,8 @@ public function setTrafficConfiguration($var) } /** - * The update strategy determines the update/delete semantics for this peering connection. + * The update strategy determines the update/delete semantics for this + * peering connection. * Check the UpdateStrategy enum for the list of possible values. * * Generated from protobuf field optional string update_strategy = 6123049; @@ -150,7 +164,8 @@ public function clearUpdateStrategy() } /** - * The update strategy determines the update/delete semantics for this peering connection. + * The update strategy determines the update/delete semantics for this + * peering connection. * Check the UpdateStrategy enum for the list of possible values. * * Generated from protobuf field optional string update_strategy = 6123049; diff --git a/Compute/src/V1/NetworkPeeringConnectionStatus/UpdateStrategy.php b/Compute/src/V1/NetworkPeeringConnectionStatus/UpdateStrategy.php index 870170b3512c..3af46ebba349 100644 --- a/Compute/src/V1/NetworkPeeringConnectionStatus/UpdateStrategy.php +++ b/Compute/src/V1/NetworkPeeringConnectionStatus/UpdateStrategy.php @@ -7,7 +7,8 @@ use UnexpectedValueException; /** - * The update strategy determines the update/delete semantics for this peering connection. + * The update strategy determines the update/delete semantics for this + * peering connection. * * Protobuf type google.cloud.compute.v1.NetworkPeeringConnectionStatus.UpdateStrategy */ @@ -20,19 +21,27 @@ class UpdateStrategy */ const UNDEFINED_UPDATE_STRATEGY = 0; /** - * Updates are reflected in the local peering but aren't applied to the peering connection until a complementary change is made to the matching peering. To delete a peering with the consensus update strategy, both the peerings must request the deletion of the peering before the peering can be deleted. + * Updates are reflected in the local peering but aren't applied to the + * peering connection until a complementary change is made to the + * matching peering. + * To delete a peering with the consensus update strategy, both the peerings + * must request the deletion of the peering before the peering can be + * deleted. * * Generated from protobuf enum CONSENSUS = 203373655; */ const CONSENSUS = 203373655; /** - * In this mode, changes to the peering configuration can be unilaterally altered by changing either side of the peering. This is the default value if the field is unspecified. + * In this mode, changes to the peering configuration can + * be unilaterally altered by changing either side of the peering. + * This is the default value if the field is unspecified. * * Generated from protobuf enum INDEPENDENT = 127011674; */ const INDEPENDENT = 127011674; /** - * Peerings with update strategy UNSPECIFIED are created with update strategy INDEPENDENT. + * Peerings with update strategy UNSPECIFIED are created with + * update strategy INDEPENDENT. * * Generated from protobuf enum UNSPECIFIED = 526786327; */ diff --git a/Compute/src/V1/NetworkPeeringConnectionStatusConsensusState.php b/Compute/src/V1/NetworkPeeringConnectionStatusConsensusState.php index 488b5340266d..c7ff429ee21c 100644 --- a/Compute/src/V1/NetworkPeeringConnectionStatusConsensusState.php +++ b/Compute/src/V1/NetworkPeeringConnectionStatusConsensusState.php @@ -9,7 +9,9 @@ use Google\Protobuf\Internal\GPBUtil; /** - * The status of update/delete for a consensus peering connection. Only set when connection_status.update_strategy is CONSENSUS or a network peering is proposing to update the strategy to CONSENSUS. + * The status of update/delete for a consensus peering connection. Only set + * when connection_status.update_strategy isCONSENSUS or a network peering is proposing to update the + * strategy to CONSENSUS. * * Generated from protobuf message google.cloud.compute.v1.NetworkPeeringConnectionStatusConsensusState */ diff --git a/Compute/src/V1/NetworkPeeringConnectionStatusConsensusState/DeleteStatus.php b/Compute/src/V1/NetworkPeeringConnectionStatusConsensusState/DeleteStatus.php index 69f488158cd4..de45df111e84 100644 --- a/Compute/src/V1/NetworkPeeringConnectionStatusConsensusState/DeleteStatus.php +++ b/Compute/src/V1/NetworkPeeringConnectionStatusConsensusState/DeleteStatus.php @@ -20,7 +20,8 @@ class DeleteStatus */ const UNDEFINED_DELETE_STATUS = 0; /** - * Both network admins have agreed this consensus peering connection can be deleted. + * Both network admins have agreed this consensus peering connection can + * be deleted. * * Generated from protobuf enum DELETE_ACKNOWLEDGED = 325293916; */ @@ -36,7 +37,8 @@ class DeleteStatus */ const LOCAL_DELETE_REQUESTED = 227335214; /** - * The peer network admin has requested deletion of this peering connection. + * The peer network admin has requested deletion of this peering + * connection. * * Generated from protobuf enum PEER_DELETE_REQUESTED = 197847799; */ diff --git a/Compute/src/V1/NetworkPeeringConnectionStatusConsensusState/UpdateStatus.php b/Compute/src/V1/NetworkPeeringConnectionStatusConsensusState/UpdateStatus.php index 8a40a4fca6f9..43c5ef69a157 100644 --- a/Compute/src/V1/NetworkPeeringConnectionStatusConsensusState/UpdateStatus.php +++ b/Compute/src/V1/NetworkPeeringConnectionStatusConsensusState/UpdateStatus.php @@ -20,19 +20,21 @@ class UpdateStatus */ const UNDEFINED_UPDATE_STATUS = 0; /** - * No pending configuration update proposals to the peering connection. + * No pending configuration update proposals to the peering connection. * * Generated from protobuf enum IN_SYNC = 2273653; */ const IN_SYNC = 2273653; /** - * The peer network admin has made an updatePeering call. The change is awaiting acknowledgment from this peering's network admin. + * The peer network admin has made an updatePeering call. The change is + * awaiting acknowledgment from this peering's network admin. * * Generated from protobuf enum PENDING_LOCAL_ACKNOWLEDMENT = 229926592; */ const PENDING_LOCAL_ACKNOWLEDMENT = 229926592; /** - * The local network admin has made an updatePeering call. The change is awaiting acknowledgment from the peer network admin. + * The local network admin has made an updatePeering call. The change + * is awaiting acknowledgment from the peer network admin. * * Generated from protobuf enum PENDING_PEER_ACKNOWLEDGEMENT = 420185797; */ diff --git a/Compute/src/V1/NetworkPeeringConnectionStatusTrafficConfiguration.php b/Compute/src/V1/NetworkPeeringConnectionStatusTrafficConfiguration.php index 80bd6e4b47b6..96f9c74f2afd 100644 --- a/Compute/src/V1/NetworkPeeringConnectionStatusTrafficConfiguration.php +++ b/Compute/src/V1/NetworkPeeringConnectionStatusTrafficConfiguration.php @@ -21,7 +21,8 @@ class NetworkPeeringConnectionStatusTrafficConfiguration extends \Google\Protobu */ protected $export_custom_routes_to_peer = null; /** - * Whether subnet routes with public IP ranges are being exported to the peer network. + * Whether subnet routes with public IP ranges are being exported to the + * peer network. * * Generated from protobuf field optional bool export_subnet_routes_with_public_ip_to_peer = 8358601; */ @@ -33,13 +34,15 @@ class NetworkPeeringConnectionStatusTrafficConfiguration extends \Google\Protobu */ protected $import_custom_routes_from_peer = null; /** - * Whether subnet routes with public IP ranges are being imported from the peer network. + * Whether subnet routes with public IP ranges are being imported + * from the peer network. * * Generated from protobuf field optional bool import_subnet_routes_with_public_ip_from_peer = 234712361; */ protected $import_subnet_routes_with_public_ip_from_peer = null; /** - * Which IP version(s) of traffic and routes are being imported or exported between peer networks. + * Which IP version(s) of traffic and routes are being imported or + * exported between peer networks. * Check the StackType enum for the list of possible values. * * Generated from protobuf field optional string stack_type = 425908881; @@ -55,13 +58,16 @@ class NetworkPeeringConnectionStatusTrafficConfiguration extends \Google\Protobu * @type bool $export_custom_routes_to_peer * Whether custom routes are being exported to the peer network. * @type bool $export_subnet_routes_with_public_ip_to_peer - * Whether subnet routes with public IP ranges are being exported to the peer network. + * Whether subnet routes with public IP ranges are being exported to the + * peer network. * @type bool $import_custom_routes_from_peer * Whether custom routes are being imported from the peer network. * @type bool $import_subnet_routes_with_public_ip_from_peer - * Whether subnet routes with public IP ranges are being imported from the peer network. + * Whether subnet routes with public IP ranges are being imported + * from the peer network. * @type string $stack_type - * Which IP version(s) of traffic and routes are being imported or exported between peer networks. + * Which IP version(s) of traffic and routes are being imported or + * exported between peer networks. * Check the StackType enum for the list of possible values. * } */ @@ -107,7 +113,8 @@ public function setExportCustomRoutesToPeer($var) } /** - * Whether subnet routes with public IP ranges are being exported to the peer network. + * Whether subnet routes with public IP ranges are being exported to the + * peer network. * * Generated from protobuf field optional bool export_subnet_routes_with_public_ip_to_peer = 8358601; * @return bool @@ -128,7 +135,8 @@ public function clearExportSubnetRoutesWithPublicIpToPeer() } /** - * Whether subnet routes with public IP ranges are being exported to the peer network. + * Whether subnet routes with public IP ranges are being exported to the + * peer network. * * Generated from protobuf field optional bool export_subnet_routes_with_public_ip_to_peer = 8358601; * @param bool $var @@ -179,7 +187,8 @@ public function setImportCustomRoutesFromPeer($var) } /** - * Whether subnet routes with public IP ranges are being imported from the peer network. + * Whether subnet routes with public IP ranges are being imported + * from the peer network. * * Generated from protobuf field optional bool import_subnet_routes_with_public_ip_from_peer = 234712361; * @return bool @@ -200,7 +209,8 @@ public function clearImportSubnetRoutesWithPublicIpFromPeer() } /** - * Whether subnet routes with public IP ranges are being imported from the peer network. + * Whether subnet routes with public IP ranges are being imported + * from the peer network. * * Generated from protobuf field optional bool import_subnet_routes_with_public_ip_from_peer = 234712361; * @param bool $var @@ -215,7 +225,8 @@ public function setImportSubnetRoutesWithPublicIpFromPeer($var) } /** - * Which IP version(s) of traffic and routes are being imported or exported between peer networks. + * Which IP version(s) of traffic and routes are being imported or + * exported between peer networks. * Check the StackType enum for the list of possible values. * * Generated from protobuf field optional string stack_type = 425908881; @@ -237,7 +248,8 @@ public function clearStackType() } /** - * Which IP version(s) of traffic and routes are being imported or exported between peer networks. + * Which IP version(s) of traffic and routes are being imported or + * exported between peer networks. * Check the StackType enum for the list of possible values. * * Generated from protobuf field optional string stack_type = 425908881; diff --git a/Compute/src/V1/NetworkPeeringConnectionStatusTrafficConfiguration/StackType.php b/Compute/src/V1/NetworkPeeringConnectionStatusTrafficConfiguration/StackType.php index dc855fe2beeb..d540f7af216a 100644 --- a/Compute/src/V1/NetworkPeeringConnectionStatusTrafficConfiguration/StackType.php +++ b/Compute/src/V1/NetworkPeeringConnectionStatusTrafficConfiguration/StackType.php @@ -7,7 +7,8 @@ use UnexpectedValueException; /** - * Which IP version(s) of traffic and routes are being imported or exported between peer networks. + * Which IP version(s) of traffic and routes are being imported or + * exported between peer networks. * * Protobuf type google.cloud.compute.v1.NetworkPeeringConnectionStatusTrafficConfiguration.StackType */ @@ -20,13 +21,17 @@ class StackType */ const UNDEFINED_STACK_TYPE = 0; /** - * This Peering will allow IPv4 traffic and routes to be exchanged. Additionally if the matching peering is IPV4_IPV6, IPv6 traffic and routes will be exchanged as well. + * This Peering will allow IPv4 traffic and routes to be + * exchanged. Additionally if the matching peering is + * IPV4_IPV6, IPv6 traffic and routes will be exchanged as + * well. * * Generated from protobuf enum IPV4_IPV6 = 22197249; */ const IPV4_IPV6 = 22197249; /** - * This Peering will only allow IPv4 traffic and routes to be exchanged, even if the matching peering is IPV4_IPV6. + * This Peering will only allow IPv4 traffic and routes to be + * exchanged, even if the matching peering is IPV4_IPV6. * * Generated from protobuf enum IPV4_ONLY = 22373798; */ diff --git a/Compute/src/V1/NetworkProfile.php b/Compute/src/V1/NetworkProfile.php index 18fe8687207d..4c2a3bcd5526 100644 --- a/Compute/src/V1/NetworkProfile.php +++ b/Compute/src/V1/NetworkProfile.php @@ -16,7 +16,8 @@ class NetworkProfile extends \Google\Protobuf\Internal\Message { /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; */ @@ -34,13 +35,14 @@ class NetworkProfile extends \Google\Protobuf\Internal\Message */ protected $features = null; /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; */ protected $id = null; /** - * [Output Only] Type of the resource. Always compute#networkProfile for network profiles. + * [Output Only] Type of the resource. Alwayscompute#networkProfile for network profiles. * * Generated from protobuf field optional string kind = 3292052; */ @@ -87,15 +89,17 @@ class NetworkProfile extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $creation_timestamp - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * @type string $description * [Output Only] An optional description of this resource. * @type \Google\Cloud\Compute\V1\NetworkProfileNetworkFeatures $features * [Output Only] Features supported by the network. * @type int|string $id - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * @type string $kind - * [Output Only] Type of the resource. Always compute#networkProfile for network profiles. + * [Output Only] Type of the resource. Alwayscompute#networkProfile for network profiles. * @type \Google\Cloud\Compute\V1\NetworkProfileLocation $location * [Output Only] Location to which the network is restricted. * @type string $name @@ -115,7 +119,8 @@ public function __construct($data = NULL) { } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @return string @@ -136,7 +141,8 @@ public function clearCreationTimestamp() } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @param string $var @@ -223,7 +229,8 @@ public function setFeatures($var) } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @return int|string @@ -244,7 +251,8 @@ public function clearId() } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @param int|string $var @@ -259,7 +267,7 @@ public function setId($var) } /** - * [Output Only] Type of the resource. Always compute#networkProfile for network profiles. + * [Output Only] Type of the resource. Alwayscompute#networkProfile for network profiles. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -280,7 +288,7 @@ public function clearKind() } /** - * [Output Only] Type of the resource. Always compute#networkProfile for network profiles. + * [Output Only] Type of the resource. Alwayscompute#networkProfile for network profiles. * * Generated from protobuf field optional string kind = 3292052; * @param string $var diff --git a/Compute/src/V1/NetworkProfileNetworkFeatures.php b/Compute/src/V1/NetworkProfileNetworkFeatures.php index 9c274cb4860d..7bf8d8eb7993 100644 --- a/Compute/src/V1/NetworkProfileNetworkFeatures.php +++ b/Compute/src/V1/NetworkProfileNetworkFeatures.php @@ -15,14 +15,16 @@ class NetworkProfileNetworkFeatures extends \Google\Protobuf\Internal\Message { /** - * Specifies what address purposes are supported. If empty, all address purposes are supported. + * Specifies what address purposes are supported. If empty, all address + * purposes are supported. * Check the AddressPurposes enum for the list of possible values. * * Generated from protobuf field repeated string address_purposes = 433024768; */ private $address_purposes; /** - * Specifies whether alias IP ranges (and secondary address ranges) are allowed. + * Specifies whether alias IP ranges (and secondary address ranges) are + * allowed. * Check the AllowAliasIpRanges enum for the list of possible values. * * Generated from protobuf field optional string allow_alias_ip_ranges = 457984201; @@ -64,7 +66,8 @@ class NetworkProfileNetworkFeatures extends \Google\Protobuf\Internal\Message */ protected $allow_default_nic_attachment = null; /** - * Specifies whether VMs are allowed to have external IP access on network interfaces connected to this VPC. + * Specifies whether VMs are allowed to have external IP access on network + * interfaces connected to this VPC. * Check the AllowExternalIpAccess enum for the list of possible values. * * Generated from protobuf field optional string allow_external_ip_access = 131538110; @@ -98,6 +101,13 @@ class NetworkProfileNetworkFeatures extends \Google\Protobuf\Internal\Message * Generated from protobuf field optional string allow_multi_nic_in_same_network = 88251004; */ protected $allow_multi_nic_in_same_network = null; + /** + * Specifies whether multicast is allowed. + * Check the AllowMulticast enum for the list of possible values. + * + * Generated from protobuf field optional string allow_multicast = 11002498; + */ + protected $allow_multicast = null; /** * Specifies whether NCC is allowed. * Check the AllowNcc enum for the list of possible values. @@ -169,12 +179,20 @@ class NetworkProfileNetworkFeatures extends \Google\Protobuf\Internal\Message */ protected $allow_vpn = null; /** - * If set, limits the interface types that the network supports. If empty, all interface types are supported. + * If set, limits the interface types that the network supports. If + * empty, all interface types are supported. * Check the InterfaceTypes enum for the list of possible values. * * Generated from protobuf field repeated string interface_types = 157981171; */ private $interface_types; + /** + * Specifies which type of multicast is supported. + * Check the Multicast enum for the list of possible values. + * + * Generated from protobuf field optional string multicast = 404098040; + */ + protected $multicast = null; /** * Specifies which subnetwork purposes are supported. * Check the SubnetPurposes enum for the list of possible values. @@ -218,10 +236,12 @@ class NetworkProfileNetworkFeatures extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type array|\Google\Protobuf\Internal\RepeatedField $address_purposes - * Specifies what address purposes are supported. If empty, all address purposes are supported. + * Specifies what address purposes are supported. If empty, all address + * purposes are supported. * Check the AddressPurposes enum for the list of possible values. * @type string $allow_alias_ip_ranges - * Specifies whether alias IP ranges (and secondary address ranges) are allowed. + * Specifies whether alias IP ranges (and secondary address ranges) are + * allowed. * Check the AllowAliasIpRanges enum for the list of possible values. * @type string $allow_auto_mode_subnet * Specifies whether auto mode subnet creation is allowed. @@ -239,7 +259,8 @@ class NetworkProfileNetworkFeatures extends \Google\Protobuf\Internal\Message * Specifies whether default NIC attachment is allowed. * Check the AllowDefaultNicAttachment enum for the list of possible values. * @type string $allow_external_ip_access - * Specifies whether VMs are allowed to have external IP access on network interfaces connected to this VPC. + * Specifies whether VMs are allowed to have external IP access on network + * interfaces connected to this VPC. * Check the AllowExternalIpAccess enum for the list of possible values. * @type string $allow_interconnect * Specifies whether Cloud Interconnect creation is allowed. @@ -253,6 +274,9 @@ class NetworkProfileNetworkFeatures extends \Google\Protobuf\Internal\Message * @type string $allow_multi_nic_in_same_network * Specifies whether multi-nic in the same network is allowed. * Check the AllowMultiNicInSameNetwork enum for the list of possible values. + * @type string $allow_multicast + * Specifies whether multicast is allowed. + * Check the AllowMulticast enum for the list of possible values. * @type string $allow_ncc * Specifies whether NCC is allowed. * Check the AllowNcc enum for the list of possible values. @@ -284,8 +308,12 @@ class NetworkProfileNetworkFeatures extends \Google\Protobuf\Internal\Message * Specifies whether VPN creation is allowed. * Check the AllowVpn enum for the list of possible values. * @type array|\Google\Protobuf\Internal\RepeatedField $interface_types - * If set, limits the interface types that the network supports. If empty, all interface types are supported. + * If set, limits the interface types that the network supports. If + * empty, all interface types are supported. * Check the InterfaceTypes enum for the list of possible values. + * @type string $multicast + * Specifies which type of multicast is supported. + * Check the Multicast enum for the list of possible values. * @type array|\Google\Protobuf\Internal\RepeatedField $subnet_purposes * Specifies which subnetwork purposes are supported. * Check the SubnetPurposes enum for the list of possible values. @@ -309,7 +337,8 @@ public function __construct($data = NULL) { } /** - * Specifies what address purposes are supported. If empty, all address purposes are supported. + * Specifies what address purposes are supported. If empty, all address + * purposes are supported. * Check the AddressPurposes enum for the list of possible values. * * Generated from protobuf field repeated string address_purposes = 433024768; @@ -321,7 +350,8 @@ public function getAddressPurposes() } /** - * Specifies what address purposes are supported. If empty, all address purposes are supported. + * Specifies what address purposes are supported. If empty, all address + * purposes are supported. * Check the AddressPurposes enum for the list of possible values. * * Generated from protobuf field repeated string address_purposes = 433024768; @@ -337,7 +367,8 @@ public function setAddressPurposes($var) } /** - * Specifies whether alias IP ranges (and secondary address ranges) are allowed. + * Specifies whether alias IP ranges (and secondary address ranges) are + * allowed. * Check the AllowAliasIpRanges enum for the list of possible values. * * Generated from protobuf field optional string allow_alias_ip_ranges = 457984201; @@ -359,7 +390,8 @@ public function clearAllowAliasIpRanges() } /** - * Specifies whether alias IP ranges (and secondary address ranges) are allowed. + * Specifies whether alias IP ranges (and secondary address ranges) are + * allowed. * Check the AllowAliasIpRanges enum for the list of possible values. * * Generated from protobuf field optional string allow_alias_ip_ranges = 457984201; @@ -565,7 +597,8 @@ public function setAllowDefaultNicAttachment($var) } /** - * Specifies whether VMs are allowed to have external IP access on network interfaces connected to this VPC. + * Specifies whether VMs are allowed to have external IP access on network + * interfaces connected to this VPC. * Check the AllowExternalIpAccess enum for the list of possible values. * * Generated from protobuf field optional string allow_external_ip_access = 131538110; @@ -587,7 +620,8 @@ public function clearAllowExternalIpAccess() } /** - * Specifies whether VMs are allowed to have external IP access on network interfaces connected to this VPC. + * Specifies whether VMs are allowed to have external IP access on network + * interfaces connected to this VPC. * Check the AllowExternalIpAccess enum for the list of possible values. * * Generated from protobuf field optional string allow_external_ip_access = 131538110; @@ -754,6 +788,44 @@ public function setAllowMultiNicInSameNetwork($var) return $this; } + /** + * Specifies whether multicast is allowed. + * Check the AllowMulticast enum for the list of possible values. + * + * Generated from protobuf field optional string allow_multicast = 11002498; + * @return string + */ + public function getAllowMulticast() + { + return isset($this->allow_multicast) ? $this->allow_multicast : ''; + } + + public function hasAllowMulticast() + { + return isset($this->allow_multicast); + } + + public function clearAllowMulticast() + { + unset($this->allow_multicast); + } + + /** + * Specifies whether multicast is allowed. + * Check the AllowMulticast enum for the list of possible values. + * + * Generated from protobuf field optional string allow_multicast = 11002498; + * @param string $var + * @return $this + */ + public function setAllowMulticast($var) + { + GPBUtil::checkString($var, True); + $this->allow_multicast = $var; + + return $this; + } + /** * Specifies whether NCC is allowed. * Check the AllowNcc enum for the list of possible values. @@ -1135,7 +1207,8 @@ public function setAllowVpn($var) } /** - * If set, limits the interface types that the network supports. If empty, all interface types are supported. + * If set, limits the interface types that the network supports. If + * empty, all interface types are supported. * Check the InterfaceTypes enum for the list of possible values. * * Generated from protobuf field repeated string interface_types = 157981171; @@ -1147,7 +1220,8 @@ public function getInterfaceTypes() } /** - * If set, limits the interface types that the network supports. If empty, all interface types are supported. + * If set, limits the interface types that the network supports. If + * empty, all interface types are supported. * Check the InterfaceTypes enum for the list of possible values. * * Generated from protobuf field repeated string interface_types = 157981171; @@ -1162,6 +1236,44 @@ public function setInterfaceTypes($var) return $this; } + /** + * Specifies which type of multicast is supported. + * Check the Multicast enum for the list of possible values. + * + * Generated from protobuf field optional string multicast = 404098040; + * @return string + */ + public function getMulticast() + { + return isset($this->multicast) ? $this->multicast : ''; + } + + public function hasMulticast() + { + return isset($this->multicast); + } + + public function clearMulticast() + { + unset($this->multicast); + } + + /** + * Specifies which type of multicast is supported. + * Check the Multicast enum for the list of possible values. + * + * Generated from protobuf field optional string multicast = 404098040; + * @param string $var + * @return $this + */ + public function setMulticast($var) + { + GPBUtil::checkString($var, True); + $this->multicast = $var; + + return $this; + } + /** * Specifies which subnetwork purposes are supported. * Check the SubnetPurposes enum for the list of possible values. diff --git a/Compute/src/V1/NetworkProfileNetworkFeatures/AddressPurposes.php b/Compute/src/V1/NetworkProfileNetworkFeatures/AddressPurposes.php index a478e9ae4452..50afdf802c03 100644 --- a/Compute/src/V1/NetworkProfileNetworkFeatures/AddressPurposes.php +++ b/Compute/src/V1/NetworkProfileNetworkFeatures/AddressPurposes.php @@ -34,7 +34,13 @@ class AddressPurposes */ const GCE_ENDPOINT = 230515243; /** - * A regional internal IP address range reserved for the VLAN attachment that is used in HA VPN over Cloud Interconnect. This regional internal IP address range must not overlap with any IP address range of subnet/route in the VPC network and its peering networks. After the VLAN attachment is created with the reserved IP address range, when creating a new VPN gateway, its interface IP address is allocated from the associated VLAN attachment’s IP address range. + * A regional internal IP address range reserved for the VLAN attachment + * that is used in HA VPN over Cloud Interconnect. This regional + * internal IP address range must not overlap with any IP address range + * of subnet/route in the VPC network and its peering networks. After the + * VLAN attachment is created with the reserved IP address range, when + * creating a new VPN gateway, its interface IP address is allocated + * from the associated VLAN attachment’s IP address range. * * Generated from protobuf enum IPSEC_INTERCONNECT = 340437251; */ @@ -56,7 +62,8 @@ class AddressPurposes */ const SERVERLESS = 270492508; /** - * A private network IP address that can be shared by multiple Internal Load Balancer forwarding rules. + * A private network IP address that can be shared by multiple Internal + * Load Balancer forwarding rules. * * Generated from protobuf enum SHARED_LOADBALANCER_VIP = 294447572; */ diff --git a/Compute/src/V1/NetworkProfileNetworkFeatures/AllowAliasIpRanges.php b/Compute/src/V1/NetworkProfileNetworkFeatures/AllowAliasIpRanges.php index eccd6f1731f7..e93f75207d81 100644 --- a/Compute/src/V1/NetworkProfileNetworkFeatures/AllowAliasIpRanges.php +++ b/Compute/src/V1/NetworkProfileNetworkFeatures/AllowAliasIpRanges.php @@ -7,7 +7,8 @@ use UnexpectedValueException; /** - * Specifies whether alias IP ranges (and secondary address ranges) are allowed. + * Specifies whether alias IP ranges (and secondary address ranges) are + * allowed. * * Protobuf type google.cloud.compute.v1.NetworkProfileNetworkFeatures.AllowAliasIpRanges */ diff --git a/Compute/src/V1/NetworkProfileNetworkFeatures/AllowExternalIpAccess.php b/Compute/src/V1/NetworkProfileNetworkFeatures/AllowExternalIpAccess.php index a93a2dc28490..596ac3af8e2c 100644 --- a/Compute/src/V1/NetworkProfileNetworkFeatures/AllowExternalIpAccess.php +++ b/Compute/src/V1/NetworkProfileNetworkFeatures/AllowExternalIpAccess.php @@ -7,7 +7,8 @@ use UnexpectedValueException; /** - * Specifies whether VMs are allowed to have external IP access on network interfaces connected to this VPC. + * Specifies whether VMs are allowed to have external IP access on network + * interfaces connected to this VPC. * * Protobuf type google.cloud.compute.v1.NetworkProfileNetworkFeatures.AllowExternalIpAccess */ diff --git a/Compute/src/V1/NetworkProfileNetworkFeatures/AllowMulticast.php b/Compute/src/V1/NetworkProfileNetworkFeatures/AllowMulticast.php new file mode 100644 index 000000000000..808c821f63f0 --- /dev/null +++ b/Compute/src/V1/NetworkProfileNetworkFeatures/AllowMulticast.php @@ -0,0 +1,58 @@ +google.cloud.compute.v1.NetworkProfileNetworkFeatures.AllowMulticast + */ +class AllowMulticast +{ + /** + * A value indicating that the enum field is not set. + * + * Generated from protobuf enum UNDEFINED_ALLOW_MULTICAST = 0; + */ + const UNDEFINED_ALLOW_MULTICAST = 0; + /** + * Generated from protobuf enum MULTICAST_ALLOWED = 44693537; + */ + const MULTICAST_ALLOWED = 44693537; + /** + * Generated from protobuf enum MULTICAST_BLOCKED = 397727845; + */ + const MULTICAST_BLOCKED = 397727845; + + private static $valueToName = [ + self::UNDEFINED_ALLOW_MULTICAST => 'UNDEFINED_ALLOW_MULTICAST', + self::MULTICAST_ALLOWED => 'MULTICAST_ALLOWED', + self::MULTICAST_BLOCKED => 'MULTICAST_BLOCKED', + ]; + + public static function name($value) + { + if (!isset(self::$valueToName[$value])) { + throw new UnexpectedValueException(sprintf( + 'Enum %s has no name defined for value %s', __CLASS__, $value)); + } + return self::$valueToName[$value]; + } + + + public static function value($name) + { + $const = __CLASS__ . '::' . strtoupper($name); + if (!defined($const)) { + throw new UnexpectedValueException(sprintf( + 'Enum %s has no value defined for name %s', __CLASS__, $name)); + } + return constant($const); + } +} + + diff --git a/Compute/src/V1/NetworkProfileNetworkFeatures/Multicast.php b/Compute/src/V1/NetworkProfileNetworkFeatures/Multicast.php new file mode 100644 index 000000000000..54db8b0637cd --- /dev/null +++ b/Compute/src/V1/NetworkProfileNetworkFeatures/Multicast.php @@ -0,0 +1,58 @@ +google.cloud.compute.v1.NetworkProfileNetworkFeatures.Multicast + */ +class Multicast +{ + /** + * A value indicating that the enum field is not set. + * + * Generated from protobuf enum UNDEFINED_MULTICAST = 0; + */ + const UNDEFINED_MULTICAST = 0; + /** + * Generated from protobuf enum MULTICAST_SDN = 532209462; + */ + const MULTICAST_SDN = 532209462; + /** + * Generated from protobuf enum MULTICAST_ULL = 532211630; + */ + const MULTICAST_ULL = 532211630; + + private static $valueToName = [ + self::UNDEFINED_MULTICAST => 'UNDEFINED_MULTICAST', + self::MULTICAST_SDN => 'MULTICAST_SDN', + self::MULTICAST_ULL => 'MULTICAST_ULL', + ]; + + public static function name($value) + { + if (!isset(self::$valueToName[$value])) { + throw new UnexpectedValueException(sprintf( + 'Enum %s has no name defined for value %s', __CLASS__, $value)); + } + return self::$valueToName[$value]; + } + + + public static function value($name) + { + $const = __CLASS__ . '::' . strtoupper($name); + if (!defined($const)) { + throw new UnexpectedValueException(sprintf( + 'Enum %s has no value defined for name %s', __CLASS__, $name)); + } + return constant($const); + } +} + + diff --git a/Compute/src/V1/NetworkProfileNetworkFeatures/SubnetworkPurposes.php b/Compute/src/V1/NetworkProfileNetworkFeatures/SubnetworkPurposes.php index 7e172118ef1a..2a39ee1ea6b6 100644 --- a/Compute/src/V1/NetworkProfileNetworkFeatures/SubnetworkPurposes.php +++ b/Compute/src/V1/NetworkProfileNetworkFeatures/SubnetworkPurposes.php @@ -28,13 +28,16 @@ class SubnetworkPurposes */ const GLOBAL_MANAGED_PROXY = 236463602; /** - * Subnet reserved for Internal HTTP(S) Load Balancing. This is a legacy purpose, please use REGIONAL_MANAGED_PROXY instead. + * Subnet reserved for Internal HTTP(S) Load Balancing. This is a legacy + * purpose, please use REGIONAL_MANAGED_PROXY instead. * * Generated from protobuf enum INTERNAL_HTTPS_LOAD_BALANCER = 248748889; */ const INTERNAL_HTTPS_LOAD_BALANCER = 248748889; /** - * Subnetwork will be used for Migration from one peered VPC to another. (a transient state of subnetwork while migrating resources from one project to another). + * Subnetwork will be used for Migration from one peered VPC to another. + * (a transient state of subnetwork + * while migrating resources from one project to another). * * Generated from protobuf enum PEER_MIGRATION = 491902225; */ diff --git a/Compute/src/V1/NetworkProfileNetworkFeatures/SubnetworkStackTypes.php b/Compute/src/V1/NetworkProfileNetworkFeatures/SubnetworkStackTypes.php index f33f2b047bcf..3be562253513 100644 --- a/Compute/src/V1/NetworkProfileNetworkFeatures/SubnetworkStackTypes.php +++ b/Compute/src/V1/NetworkProfileNetworkFeatures/SubnetworkStackTypes.php @@ -31,7 +31,7 @@ class SubnetworkStackTypes */ const IPV4_ONLY = 22373798; /** - * New VMs in this subnet will only be assigned IPv6 addresses. + * New VMs in this subnet will only be assigned IPv6 addresses. * * Generated from protobuf enum IPV6_ONLY = 79632100; */ diff --git a/Compute/src/V1/NetworkProfilesListResponse.php b/Compute/src/V1/NetworkProfilesListResponse.php index aef1b6bb19ea..3bca79a80805 100644 --- a/Compute/src/V1/NetworkProfilesListResponse.php +++ b/Compute/src/V1/NetworkProfilesListResponse.php @@ -32,13 +32,19 @@ class NetworkProfilesListResponse extends \Google\Protobuf\Internal\Message */ private $items; /** - * [Output Only] Type of resource. Always compute#networkProfileList for network profiles. + * [Output Only] Type of resource. Alwayscompute#networkProfileList for network profiles. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value + * for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken + * to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -50,7 +56,8 @@ class NetworkProfilesListResponse extends \Google\Protobuf\Internal\Message */ protected $self_link = null; /** - * [Output Only] Unreachable resources. end_interface: MixerListResponseWithEtagBuilder + * [Output Only] Unreachable resources. + * end_interface: MixerListResponseWithEtagBuilder * * Generated from protobuf field repeated string unreachables = 243372063; */ @@ -74,13 +81,20 @@ class NetworkProfilesListResponse extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\NetworkProfile>|\Google\Protobuf\Internal\RepeatedField $items * A list of NetworkProfile resources. * @type string $kind - * [Output Only] Type of resource. Always compute#networkProfileList for network profiles. + * [Output Only] Type of resource. Alwayscompute#networkProfileList for network profiles. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value + * for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken + * to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type array|\Google\Protobuf\Internal\RepeatedField $unreachables - * [Output Only] Unreachable resources. end_interface: MixerListResponseWithEtagBuilder + * [Output Only] Unreachable resources. + * end_interface: MixerListResponseWithEtagBuilder * @type \Google\Cloud\Compute\V1\Warning $warning * [Output Only] Informational warning message. * } @@ -185,7 +199,7 @@ public function setItems($var) } /** - * [Output Only] Type of resource. Always compute#networkProfileList for network profiles. + * [Output Only] Type of resource. Alwayscompute#networkProfileList for network profiles. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -206,7 +220,7 @@ public function clearKind() } /** - * [Output Only] Type of resource. Always compute#networkProfileList for network profiles. + * [Output Only] Type of resource. Alwayscompute#networkProfileList for network profiles. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -221,7 +235,13 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value + * for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken + * to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -242,7 +262,13 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value + * for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken + * to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var @@ -293,7 +319,8 @@ public function setSelfLink($var) } /** - * [Output Only] Unreachable resources. end_interface: MixerListResponseWithEtagBuilder + * [Output Only] Unreachable resources. + * end_interface: MixerListResponseWithEtagBuilder * * Generated from protobuf field repeated string unreachables = 243372063; * @return \Google\Protobuf\Internal\RepeatedField @@ -304,7 +331,8 @@ public function getUnreachables() } /** - * [Output Only] Unreachable resources. end_interface: MixerListResponseWithEtagBuilder + * [Output Only] Unreachable resources. + * end_interface: MixerListResponseWithEtagBuilder * * Generated from protobuf field repeated string unreachables = 243372063; * @param array|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/NetworkRoutingConfig.php b/Compute/src/V1/NetworkRoutingConfig.php index 86832b9dd452..81891f15cadc 100644 --- a/Compute/src/V1/NetworkRoutingConfig.php +++ b/Compute/src/V1/NetworkRoutingConfig.php @@ -9,47 +9,60 @@ use Google\Protobuf\Internal\GPBUtil; /** - * A routing configuration attached to a network resource. The message includes the list of routers associated with the network, and a flag indicating the type of routing behavior to enforce network-wide. + * A routing configuration attached to a network resource. The message + * includes the list of routers associated with the network, and a flag + * indicating the type of routing behavior to enforce network-wide. * * Generated from protobuf message google.cloud.compute.v1.NetworkRoutingConfig */ class NetworkRoutingConfig extends \Google\Protobuf\Internal\Message { /** - * Enable comparison of Multi-Exit Discriminators (MED) across routes with different neighbor ASNs when using the STANDARD BGP best path selection algorithm. + * Enable comparison of Multi-Exit Discriminators (MED) across routes with + * different neighbor ASNs when using the STANDARD BGP best path selection + * algorithm. * * Generated from protobuf field optional bool bgp_always_compare_med = 213102902; */ protected $bgp_always_compare_med = null; /** - * The BGP best path selection algorithm to be employed within this network for dynamic routes learned by Cloud Routers. Can be LEGACY (default) or STANDARD. + * The BGP best path selection algorithm to be employed within this network + * for dynamic routes learned by Cloud Routers. Can be LEGACY + * (default) or STANDARD. * Check the BgpBestPathSelectionMode enum for the list of possible values. * * Generated from protobuf field optional string bgp_best_path_selection_mode = 317816297; */ protected $bgp_best_path_selection_mode = null; /** - * Allows to define a preferred approach for handling inter-region cost in the selection process when using the STANDARD BGP best path selection algorithm. Can be DEFAULT or ADD_COST_TO_MED. + * Allows to define a preferred approach for handling inter-region cost in + * the selection process when using the STANDARD BGP best path + * selection algorithm. Can be DEFAULT orADD_COST_TO_MED. * Check the BgpInterRegionCost enum for the list of possible values. * * Generated from protobuf field optional string bgp_inter_region_cost = 462142689; */ protected $bgp_inter_region_cost = null; /** - * [Output Only] Effective value of the bgp_always_compare_med field. + * [Output Only] Effective value of the bgp_always_compare_med + * field. * * Generated from protobuf field optional bool effective_bgp_always_compare_med = 214661838; */ protected $effective_bgp_always_compare_med = null; /** - * [Output Only] Effective value of the bgp_inter_region_cost field. + * [Output Only] Effective value of the bgp_inter_region_cost + * field. * Check the EffectiveBgpInterRegionCost enum for the list of possible values. * * Generated from protobuf field optional string effective_bgp_inter_region_cost = 185098313; */ protected $effective_bgp_inter_region_cost = null; /** - * The network-wide routing mode to use. If set to REGIONAL, this network's Cloud Routers will only advertise routes with subnets of this network in the same region as the router. If set to GLOBAL, this network's Cloud Routers will advertise routes with all subnets of this network, across regions. + * The network-wide routing mode to use. If set to REGIONAL, + * this network's Cloud Routers will only advertise routes with subnets + * of this network in the same region as the router. If set toGLOBAL, this network's Cloud Routers will advertise + * routes with all subnets of this network, across regions. * Check the RoutingMode enum for the list of possible values. * * Generated from protobuf field optional string routing_mode = 475143548; @@ -63,20 +76,31 @@ class NetworkRoutingConfig extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type bool $bgp_always_compare_med - * Enable comparison of Multi-Exit Discriminators (MED) across routes with different neighbor ASNs when using the STANDARD BGP best path selection algorithm. + * Enable comparison of Multi-Exit Discriminators (MED) across routes with + * different neighbor ASNs when using the STANDARD BGP best path selection + * algorithm. * @type string $bgp_best_path_selection_mode - * The BGP best path selection algorithm to be employed within this network for dynamic routes learned by Cloud Routers. Can be LEGACY (default) or STANDARD. + * The BGP best path selection algorithm to be employed within this network + * for dynamic routes learned by Cloud Routers. Can be LEGACY + * (default) or STANDARD. * Check the BgpBestPathSelectionMode enum for the list of possible values. * @type string $bgp_inter_region_cost - * Allows to define a preferred approach for handling inter-region cost in the selection process when using the STANDARD BGP best path selection algorithm. Can be DEFAULT or ADD_COST_TO_MED. + * Allows to define a preferred approach for handling inter-region cost in + * the selection process when using the STANDARD BGP best path + * selection algorithm. Can be DEFAULT orADD_COST_TO_MED. * Check the BgpInterRegionCost enum for the list of possible values. * @type bool $effective_bgp_always_compare_med - * [Output Only] Effective value of the bgp_always_compare_med field. + * [Output Only] Effective value of the bgp_always_compare_med + * field. * @type string $effective_bgp_inter_region_cost - * [Output Only] Effective value of the bgp_inter_region_cost field. + * [Output Only] Effective value of the bgp_inter_region_cost + * field. * Check the EffectiveBgpInterRegionCost enum for the list of possible values. * @type string $routing_mode - * The network-wide routing mode to use. If set to REGIONAL, this network's Cloud Routers will only advertise routes with subnets of this network in the same region as the router. If set to GLOBAL, this network's Cloud Routers will advertise routes with all subnets of this network, across regions. + * The network-wide routing mode to use. If set to REGIONAL, + * this network's Cloud Routers will only advertise routes with subnets + * of this network in the same region as the router. If set toGLOBAL, this network's Cloud Routers will advertise + * routes with all subnets of this network, across regions. * Check the RoutingMode enum for the list of possible values. * } */ @@ -86,7 +110,9 @@ public function __construct($data = NULL) { } /** - * Enable comparison of Multi-Exit Discriminators (MED) across routes with different neighbor ASNs when using the STANDARD BGP best path selection algorithm. + * Enable comparison of Multi-Exit Discriminators (MED) across routes with + * different neighbor ASNs when using the STANDARD BGP best path selection + * algorithm. * * Generated from protobuf field optional bool bgp_always_compare_med = 213102902; * @return bool @@ -107,7 +133,9 @@ public function clearBgpAlwaysCompareMed() } /** - * Enable comparison of Multi-Exit Discriminators (MED) across routes with different neighbor ASNs when using the STANDARD BGP best path selection algorithm. + * Enable comparison of Multi-Exit Discriminators (MED) across routes with + * different neighbor ASNs when using the STANDARD BGP best path selection + * algorithm. * * Generated from protobuf field optional bool bgp_always_compare_med = 213102902; * @param bool $var @@ -122,7 +150,9 @@ public function setBgpAlwaysCompareMed($var) } /** - * The BGP best path selection algorithm to be employed within this network for dynamic routes learned by Cloud Routers. Can be LEGACY (default) or STANDARD. + * The BGP best path selection algorithm to be employed within this network + * for dynamic routes learned by Cloud Routers. Can be LEGACY + * (default) or STANDARD. * Check the BgpBestPathSelectionMode enum for the list of possible values. * * Generated from protobuf field optional string bgp_best_path_selection_mode = 317816297; @@ -144,7 +174,9 @@ public function clearBgpBestPathSelectionMode() } /** - * The BGP best path selection algorithm to be employed within this network for dynamic routes learned by Cloud Routers. Can be LEGACY (default) or STANDARD. + * The BGP best path selection algorithm to be employed within this network + * for dynamic routes learned by Cloud Routers. Can be LEGACY + * (default) or STANDARD. * Check the BgpBestPathSelectionMode enum for the list of possible values. * * Generated from protobuf field optional string bgp_best_path_selection_mode = 317816297; @@ -160,7 +192,9 @@ public function setBgpBestPathSelectionMode($var) } /** - * Allows to define a preferred approach for handling inter-region cost in the selection process when using the STANDARD BGP best path selection algorithm. Can be DEFAULT or ADD_COST_TO_MED. + * Allows to define a preferred approach for handling inter-region cost in + * the selection process when using the STANDARD BGP best path + * selection algorithm. Can be DEFAULT orADD_COST_TO_MED. * Check the BgpInterRegionCost enum for the list of possible values. * * Generated from protobuf field optional string bgp_inter_region_cost = 462142689; @@ -182,7 +216,9 @@ public function clearBgpInterRegionCost() } /** - * Allows to define a preferred approach for handling inter-region cost in the selection process when using the STANDARD BGP best path selection algorithm. Can be DEFAULT or ADD_COST_TO_MED. + * Allows to define a preferred approach for handling inter-region cost in + * the selection process when using the STANDARD BGP best path + * selection algorithm. Can be DEFAULT orADD_COST_TO_MED. * Check the BgpInterRegionCost enum for the list of possible values. * * Generated from protobuf field optional string bgp_inter_region_cost = 462142689; @@ -198,7 +234,8 @@ public function setBgpInterRegionCost($var) } /** - * [Output Only] Effective value of the bgp_always_compare_med field. + * [Output Only] Effective value of the bgp_always_compare_med + * field. * * Generated from protobuf field optional bool effective_bgp_always_compare_med = 214661838; * @return bool @@ -219,7 +256,8 @@ public function clearEffectiveBgpAlwaysCompareMed() } /** - * [Output Only] Effective value of the bgp_always_compare_med field. + * [Output Only] Effective value of the bgp_always_compare_med + * field. * * Generated from protobuf field optional bool effective_bgp_always_compare_med = 214661838; * @param bool $var @@ -234,7 +272,8 @@ public function setEffectiveBgpAlwaysCompareMed($var) } /** - * [Output Only] Effective value of the bgp_inter_region_cost field. + * [Output Only] Effective value of the bgp_inter_region_cost + * field. * Check the EffectiveBgpInterRegionCost enum for the list of possible values. * * Generated from protobuf field optional string effective_bgp_inter_region_cost = 185098313; @@ -256,7 +295,8 @@ public function clearEffectiveBgpInterRegionCost() } /** - * [Output Only] Effective value of the bgp_inter_region_cost field. + * [Output Only] Effective value of the bgp_inter_region_cost + * field. * Check the EffectiveBgpInterRegionCost enum for the list of possible values. * * Generated from protobuf field optional string effective_bgp_inter_region_cost = 185098313; @@ -272,7 +312,10 @@ public function setEffectiveBgpInterRegionCost($var) } /** - * The network-wide routing mode to use. If set to REGIONAL, this network's Cloud Routers will only advertise routes with subnets of this network in the same region as the router. If set to GLOBAL, this network's Cloud Routers will advertise routes with all subnets of this network, across regions. + * The network-wide routing mode to use. If set to REGIONAL, + * this network's Cloud Routers will only advertise routes with subnets + * of this network in the same region as the router. If set toGLOBAL, this network's Cloud Routers will advertise + * routes with all subnets of this network, across regions. * Check the RoutingMode enum for the list of possible values. * * Generated from protobuf field optional string routing_mode = 475143548; @@ -294,7 +337,10 @@ public function clearRoutingMode() } /** - * The network-wide routing mode to use. If set to REGIONAL, this network's Cloud Routers will only advertise routes with subnets of this network in the same region as the router. If set to GLOBAL, this network's Cloud Routers will advertise routes with all subnets of this network, across regions. + * The network-wide routing mode to use. If set to REGIONAL, + * this network's Cloud Routers will only advertise routes with subnets + * of this network in the same region as the router. If set toGLOBAL, this network's Cloud Routers will advertise + * routes with all subnets of this network, across regions. * Check the RoutingMode enum for the list of possible values. * * Generated from protobuf field optional string routing_mode = 475143548; diff --git a/Compute/src/V1/NetworkRoutingConfig/BgpBestPathSelectionMode.php b/Compute/src/V1/NetworkRoutingConfig/BgpBestPathSelectionMode.php index d9f30fe98a20..727d53e5dbc3 100644 --- a/Compute/src/V1/NetworkRoutingConfig/BgpBestPathSelectionMode.php +++ b/Compute/src/V1/NetworkRoutingConfig/BgpBestPathSelectionMode.php @@ -7,7 +7,9 @@ use UnexpectedValueException; /** - * The BGP best path selection algorithm to be employed within this network for dynamic routes learned by Cloud Routers. Can be LEGACY (default) or STANDARD. + * The BGP best path selection algorithm to be employed within this network + * for dynamic routes learned by Cloud Routers. Can be LEGACY + * (default) or STANDARD. * * Protobuf type google.cloud.compute.v1.NetworkRoutingConfig.BgpBestPathSelectionMode */ diff --git a/Compute/src/V1/NetworkRoutingConfig/BgpInterRegionCost.php b/Compute/src/V1/NetworkRoutingConfig/BgpInterRegionCost.php index e8317b7d3aa2..c3a4bfb3e737 100644 --- a/Compute/src/V1/NetworkRoutingConfig/BgpInterRegionCost.php +++ b/Compute/src/V1/NetworkRoutingConfig/BgpInterRegionCost.php @@ -7,7 +7,9 @@ use UnexpectedValueException; /** - * Allows to define a preferred approach for handling inter-region cost in the selection process when using the STANDARD BGP best path selection algorithm. Can be DEFAULT or ADD_COST_TO_MED. + * Allows to define a preferred approach for handling inter-region cost in + * the selection process when using the STANDARD BGP best path + * selection algorithm. Can be DEFAULT orADD_COST_TO_MED. * Additional supported values which may be not listed in the enum directly due to technical reasons: * ADD_COST_TO_MED * DEFAULT diff --git a/Compute/src/V1/NetworkRoutingConfig/EffectiveBgpInterRegionCost.php b/Compute/src/V1/NetworkRoutingConfig/EffectiveBgpInterRegionCost.php index a2a7c9fcee86..b8cac967bfe0 100644 --- a/Compute/src/V1/NetworkRoutingConfig/EffectiveBgpInterRegionCost.php +++ b/Compute/src/V1/NetworkRoutingConfig/EffectiveBgpInterRegionCost.php @@ -7,7 +7,8 @@ use UnexpectedValueException; /** - * [Output Only] Effective value of the bgp_inter_region_cost field. + * [Output Only] Effective value of the bgp_inter_region_cost + * field. * Additional supported values which may be not listed in the enum directly due to technical reasons: * ADD_COST_TO_MED * DEFAULT diff --git a/Compute/src/V1/NetworkRoutingConfig/RoutingMode.php b/Compute/src/V1/NetworkRoutingConfig/RoutingMode.php index f666e351c9c4..1c05904f7969 100644 --- a/Compute/src/V1/NetworkRoutingConfig/RoutingMode.php +++ b/Compute/src/V1/NetworkRoutingConfig/RoutingMode.php @@ -7,7 +7,10 @@ use UnexpectedValueException; /** - * The network-wide routing mode to use. If set to REGIONAL, this network's Cloud Routers will only advertise routes with subnets of this network in the same region as the router. If set to GLOBAL, this network's Cloud Routers will advertise routes with all subnets of this network, across regions. + * The network-wide routing mode to use. If set to REGIONAL, + * this network's Cloud Routers will only advertise routes with subnets + * of this network in the same region as the router. If set toGLOBAL, this network's Cloud Routers will advertise + * routes with all subnets of this network, across regions. * * Protobuf type google.cloud.compute.v1.NetworkRoutingConfig.RoutingMode */ diff --git a/Compute/src/V1/NetworksAddPeeringRequest.php b/Compute/src/V1/NetworksAddPeeringRequest.php index acb5972a02e3..65b33206ff26 100644 --- a/Compute/src/V1/NetworksAddPeeringRequest.php +++ b/Compute/src/V1/NetworksAddPeeringRequest.php @@ -15,7 +15,12 @@ class NetworksAddPeeringRequest extends \Google\Protobuf\Internal\Message { /** - * This field will be deprecated soon. Use exchange_subnet_routes in network_peering instead. Indicates whether full mesh connectivity is created and managed automatically between peered networks. Currently this field should always be true since Google Compute Engine will automatically create and manage subnetwork routes between two networks when peering state is ACTIVE. + * This field will be deprecated soon. Useexchange_subnet_routes in network_peering + * instead. + * Indicates whether full mesh connectivity is created and managed + * automatically between peered networks. Currently this field should always + * be true since Google Compute Engine will automatically create and manage + * subnetwork routes between two networks when peering state isACTIVE. * * Generated from protobuf field optional bool auto_create_routes = 57454941; */ @@ -27,13 +32,22 @@ class NetworksAddPeeringRequest extends \Google\Protobuf\Internal\Message */ protected $name = null; /** - * Network peering parameters. In order to specify route policies for peering using import and export custom routes, you must specify all peering related parameters (name, peer network, exchange_subnet_routes) in the network_peering field. The corresponding fields in NetworksAddPeeringRequest will be deprecated soon. + * Network peering parameters. + * In order to specify route policies for peering using import and export + * custom routes, you must specify all peering related parameters + * (name, peer network,exchange_subnet_routes) in the network_peering + * field. + * The corresponding fields in NetworksAddPeeringRequest will be + * deprecated soon. * * Generated from protobuf field optional .google.cloud.compute.v1.NetworkPeering network_peering = 328926767; */ protected $network_peering = null; /** - * URL of the peer network. It can be either full URL or partial URL. The peer network may belong to a different project. If the partial URL does not contain project, it is assumed that the peer network is in the same project as the current network. + * URL of the peer network. It can be either full URL or partial URL. The + * peer network may belong to a different project. If the partial URL does not + * contain project, it is assumed that the peer network is in the same project + * as the current network. * * Generated from protobuf field optional string peer_network = 500625489; */ @@ -46,13 +60,27 @@ class NetworksAddPeeringRequest extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type bool $auto_create_routes - * This field will be deprecated soon. Use exchange_subnet_routes in network_peering instead. Indicates whether full mesh connectivity is created and managed automatically between peered networks. Currently this field should always be true since Google Compute Engine will automatically create and manage subnetwork routes between two networks when peering state is ACTIVE. + * This field will be deprecated soon. Useexchange_subnet_routes in network_peering + * instead. + * Indicates whether full mesh connectivity is created and managed + * automatically between peered networks. Currently this field should always + * be true since Google Compute Engine will automatically create and manage + * subnetwork routes between two networks when peering state isACTIVE. * @type string $name * Name of the peering, which should conform to RFC1035. * @type \Google\Cloud\Compute\V1\NetworkPeering $network_peering - * Network peering parameters. In order to specify route policies for peering using import and export custom routes, you must specify all peering related parameters (name, peer network, exchange_subnet_routes) in the network_peering field. The corresponding fields in NetworksAddPeeringRequest will be deprecated soon. + * Network peering parameters. + * In order to specify route policies for peering using import and export + * custom routes, you must specify all peering related parameters + * (name, peer network,exchange_subnet_routes) in the network_peering + * field. + * The corresponding fields in NetworksAddPeeringRequest will be + * deprecated soon. * @type string $peer_network - * URL of the peer network. It can be either full URL or partial URL. The peer network may belong to a different project. If the partial URL does not contain project, it is assumed that the peer network is in the same project as the current network. + * URL of the peer network. It can be either full URL or partial URL. The + * peer network may belong to a different project. If the partial URL does not + * contain project, it is assumed that the peer network is in the same project + * as the current network. * } */ public function __construct($data = NULL) { @@ -61,7 +89,12 @@ public function __construct($data = NULL) { } /** - * This field will be deprecated soon. Use exchange_subnet_routes in network_peering instead. Indicates whether full mesh connectivity is created and managed automatically between peered networks. Currently this field should always be true since Google Compute Engine will automatically create and manage subnetwork routes between two networks when peering state is ACTIVE. + * This field will be deprecated soon. Useexchange_subnet_routes in network_peering + * instead. + * Indicates whether full mesh connectivity is created and managed + * automatically between peered networks. Currently this field should always + * be true since Google Compute Engine will automatically create and manage + * subnetwork routes between two networks when peering state isACTIVE. * * Generated from protobuf field optional bool auto_create_routes = 57454941; * @return bool @@ -82,7 +115,12 @@ public function clearAutoCreateRoutes() } /** - * This field will be deprecated soon. Use exchange_subnet_routes in network_peering instead. Indicates whether full mesh connectivity is created and managed automatically between peered networks. Currently this field should always be true since Google Compute Engine will automatically create and manage subnetwork routes between two networks when peering state is ACTIVE. + * This field will be deprecated soon. Useexchange_subnet_routes in network_peering + * instead. + * Indicates whether full mesh connectivity is created and managed + * automatically between peered networks. Currently this field should always + * be true since Google Compute Engine will automatically create and manage + * subnetwork routes between two networks when peering state isACTIVE. * * Generated from protobuf field optional bool auto_create_routes = 57454941; * @param bool $var @@ -133,7 +171,13 @@ public function setName($var) } /** - * Network peering parameters. In order to specify route policies for peering using import and export custom routes, you must specify all peering related parameters (name, peer network, exchange_subnet_routes) in the network_peering field. The corresponding fields in NetworksAddPeeringRequest will be deprecated soon. + * Network peering parameters. + * In order to specify route policies for peering using import and export + * custom routes, you must specify all peering related parameters + * (name, peer network,exchange_subnet_routes) in the network_peering + * field. + * The corresponding fields in NetworksAddPeeringRequest will be + * deprecated soon. * * Generated from protobuf field optional .google.cloud.compute.v1.NetworkPeering network_peering = 328926767; * @return \Google\Cloud\Compute\V1\NetworkPeering|null @@ -154,7 +198,13 @@ public function clearNetworkPeering() } /** - * Network peering parameters. In order to specify route policies for peering using import and export custom routes, you must specify all peering related parameters (name, peer network, exchange_subnet_routes) in the network_peering field. The corresponding fields in NetworksAddPeeringRequest will be deprecated soon. + * Network peering parameters. + * In order to specify route policies for peering using import and export + * custom routes, you must specify all peering related parameters + * (name, peer network,exchange_subnet_routes) in the network_peering + * field. + * The corresponding fields in NetworksAddPeeringRequest will be + * deprecated soon. * * Generated from protobuf field optional .google.cloud.compute.v1.NetworkPeering network_peering = 328926767; * @param \Google\Cloud\Compute\V1\NetworkPeering $var @@ -169,7 +219,10 @@ public function setNetworkPeering($var) } /** - * URL of the peer network. It can be either full URL or partial URL. The peer network may belong to a different project. If the partial URL does not contain project, it is assumed that the peer network is in the same project as the current network. + * URL of the peer network. It can be either full URL or partial URL. The + * peer network may belong to a different project. If the partial URL does not + * contain project, it is assumed that the peer network is in the same project + * as the current network. * * Generated from protobuf field optional string peer_network = 500625489; * @return string @@ -190,7 +243,10 @@ public function clearPeerNetwork() } /** - * URL of the peer network. It can be either full URL or partial URL. The peer network may belong to a different project. If the partial URL does not contain project, it is assumed that the peer network is in the same project as the current network. + * URL of the peer network. It can be either full URL or partial URL. The + * peer network may belong to a different project. If the partial URL does not + * contain project, it is assumed that the peer network is in the same project + * as the current network. * * Generated from protobuf field optional string peer_network = 500625489; * @param string $var diff --git a/Compute/src/V1/NetworksGetEffectiveFirewallsResponse.php b/Compute/src/V1/NetworksGetEffectiveFirewallsResponse.php index e61eeb5d0268..1ea5dc69baa9 100644 --- a/Compute/src/V1/NetworksGetEffectiveFirewallsResponse.php +++ b/Compute/src/V1/NetworksGetEffectiveFirewallsResponse.php @@ -15,7 +15,9 @@ class NetworksGetEffectiveFirewallsResponse extends \Google\Protobuf\Internal\Message { /** - * [Output Only] Effective firewalls from firewall policy. It returns Global Network Firewall Policies and Hierarchical Firewall Policies. Use regionNetworkFirewallPolicies.getEffectiveFirewalls to get Regional Network Firewall Policies as well. + * [Output Only] Effective firewalls from firewall policy. It returns Global + * Network Firewall Policies and Hierarchical Firewall Policies. UseregionNetworkFirewallPolicies.getEffectiveFirewalls to get + * Regional Network Firewall Policies as well. * * Generated from protobuf field repeated .google.cloud.compute.v1.NetworksGetEffectiveFirewallsResponseEffectiveFirewallPolicy firewall_policys = 410985794; */ @@ -34,7 +36,9 @@ class NetworksGetEffectiveFirewallsResponse extends \Google\Protobuf\Internal\Me * Optional. Data for populating the Message object. * * @type array<\Google\Cloud\Compute\V1\NetworksGetEffectiveFirewallsResponseEffectiveFirewallPolicy>|\Google\Protobuf\Internal\RepeatedField $firewall_policys - * [Output Only] Effective firewalls from firewall policy. It returns Global Network Firewall Policies and Hierarchical Firewall Policies. Use regionNetworkFirewallPolicies.getEffectiveFirewalls to get Regional Network Firewall Policies as well. + * [Output Only] Effective firewalls from firewall policy. It returns Global + * Network Firewall Policies and Hierarchical Firewall Policies. UseregionNetworkFirewallPolicies.getEffectiveFirewalls to get + * Regional Network Firewall Policies as well. * @type array<\Google\Cloud\Compute\V1\Firewall>|\Google\Protobuf\Internal\RepeatedField $firewalls * Effective firewalls on the network. * } @@ -45,7 +49,9 @@ public function __construct($data = NULL) { } /** - * [Output Only] Effective firewalls from firewall policy. It returns Global Network Firewall Policies and Hierarchical Firewall Policies. Use regionNetworkFirewallPolicies.getEffectiveFirewalls to get Regional Network Firewall Policies as well. + * [Output Only] Effective firewalls from firewall policy. It returns Global + * Network Firewall Policies and Hierarchical Firewall Policies. UseregionNetworkFirewallPolicies.getEffectiveFirewalls to get + * Regional Network Firewall Policies as well. * * Generated from protobuf field repeated .google.cloud.compute.v1.NetworksGetEffectiveFirewallsResponseEffectiveFirewallPolicy firewall_policys = 410985794; * @return \Google\Protobuf\Internal\RepeatedField @@ -56,7 +62,9 @@ public function getFirewallPolicys() } /** - * [Output Only] Effective firewalls from firewall policy. It returns Global Network Firewall Policies and Hierarchical Firewall Policies. Use regionNetworkFirewallPolicies.getEffectiveFirewalls to get Regional Network Firewall Policies as well. + * [Output Only] Effective firewalls from firewall policy. It returns Global + * Network Firewall Policies and Hierarchical Firewall Policies. UseregionNetworkFirewallPolicies.getEffectiveFirewalls to get + * Regional Network Firewall Policies as well. * * Generated from protobuf field repeated .google.cloud.compute.v1.NetworksGetEffectiveFirewallsResponseEffectiveFirewallPolicy firewall_policys = 410985794; * @param array<\Google\Cloud\Compute\V1\NetworksGetEffectiveFirewallsResponseEffectiveFirewallPolicy>|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/NetworksGetEffectiveFirewallsResponseEffectiveFirewallPolicy.php b/Compute/src/V1/NetworksGetEffectiveFirewallsResponseEffectiveFirewallPolicy.php index fb3f401d5939..9a2b866d30ba 100644 --- a/Compute/src/V1/NetworksGetEffectiveFirewallsResponseEffectiveFirewallPolicy.php +++ b/Compute/src/V1/NetworksGetEffectiveFirewallsResponseEffectiveFirewallPolicy.php @@ -15,7 +15,8 @@ class NetworksGetEffectiveFirewallsResponseEffectiveFirewallPolicy extends \Google\Protobuf\Internal\Message { /** - * [Output Only] Deprecated, please use short name instead. The display name of the firewall policy. + * [Output Only] Deprecated, please use short name instead. The display name + * of the firewall policy. * * Generated from protobuf field optional string display_name = 4473832; */ @@ -33,7 +34,8 @@ class NetworksGetEffectiveFirewallsResponseEffectiveFirewallPolicy extends \Goog */ private $packet_mirroring_rules; /** - * [Output only] Priority of firewall policy association. Not applicable for type=HIERARCHY. + * [Output only] Priority of firewall policy association. Not applicable for + * type=HIERARCHY. * * Generated from protobuf field optional int32 priority = 445151652; */ @@ -65,13 +67,15 @@ class NetworksGetEffectiveFirewallsResponseEffectiveFirewallPolicy extends \Goog * Optional. Data for populating the Message object. * * @type string $display_name - * [Output Only] Deprecated, please use short name instead. The display name of the firewall policy. + * [Output Only] Deprecated, please use short name instead. The display name + * of the firewall policy. * @type string $name * [Output Only] The name of the firewall policy. * @type array<\Google\Cloud\Compute\V1\FirewallPolicyRule>|\Google\Protobuf\Internal\RepeatedField $packet_mirroring_rules * [Output Only] The packet mirroring rules that apply to the network. * @type int $priority - * [Output only] Priority of firewall policy association. Not applicable for type=HIERARCHY. + * [Output only] Priority of firewall policy association. Not applicable for + * type=HIERARCHY. * @type array<\Google\Cloud\Compute\V1\FirewallPolicyRule>|\Google\Protobuf\Internal\RepeatedField $rules * [Output Only] The rules that apply to the network. * @type string $short_name @@ -87,7 +91,8 @@ public function __construct($data = NULL) { } /** - * [Output Only] Deprecated, please use short name instead. The display name of the firewall policy. + * [Output Only] Deprecated, please use short name instead. The display name + * of the firewall policy. * * Generated from protobuf field optional string display_name = 4473832; * @return string @@ -108,7 +113,8 @@ public function clearDisplayName() } /** - * [Output Only] Deprecated, please use short name instead. The display name of the firewall policy. + * [Output Only] Deprecated, please use short name instead. The display name + * of the firewall policy. * * Generated from protobuf field optional string display_name = 4473832; * @param string $var @@ -185,7 +191,8 @@ public function setPacketMirroringRules($var) } /** - * [Output only] Priority of firewall policy association. Not applicable for type=HIERARCHY. + * [Output only] Priority of firewall policy association. Not applicable for + * type=HIERARCHY. * * Generated from protobuf field optional int32 priority = 445151652; * @return int @@ -206,7 +213,8 @@ public function clearPriority() } /** - * [Output only] Priority of firewall policy association. Not applicable for type=HIERARCHY. + * [Output only] Priority of firewall policy association. Not applicable for + * type=HIERARCHY. * * Generated from protobuf field optional int32 priority = 445151652; * @param int $var diff --git a/Compute/src/V1/NodeGroup.php b/Compute/src/V1/NodeGroup.php index afe1f13bd874..1dde2d9a0e08 100644 --- a/Compute/src/V1/NodeGroup.php +++ b/Compute/src/V1/NodeGroup.php @@ -9,7 +9,12 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Represents a sole-tenant Node Group resource. A sole-tenant node is a physical server that is dedicated to hosting VM instances only for your specific project. Use sole-tenant nodes to keep your instances physically separated from instances in other projects, or to group your instances together on the same host hardware. For more information, read Sole-tenant nodes. + * Represents a sole-tenant Node Group resource. + * A sole-tenant node is a physical server that is dedicated to + * hosting VM instances only for your specific project. Use sole-tenant nodes to + * keep your instances physically separated from instances in other projects, or + * to group your instances together on the same host hardware. For more + * information, readSole-tenant nodes. * * Generated from protobuf message google.cloud.compute.v1.NodeGroup */ @@ -22,13 +27,15 @@ class NodeGroup extends \Google\Protobuf\Internal\Message */ protected $autoscaling_policy = null; /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; */ protected $creation_timestamp = null; /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; */ @@ -38,32 +45,41 @@ class NodeGroup extends \Google\Protobuf\Internal\Message */ protected $fingerprint = null; /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; */ protected $id = null; /** - * [Output Only] The type of the resource. Always compute#nodeGroup for node group. + * [Output Only] The type of the resource. Alwayscompute#nodeGroup for node group. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * An opaque location hint used to place the Node close to other resources. This field is for use by internal tools that use the public API. The location hint here on the NodeGroup overrides any location_hint present in the NodeTemplate. + * An opaque location hint used to place the Node close to other + * resources. + * This field is for use by internal tools that use the public API. + * The location hint here on the NodeGroup overrides any location_hint + * present in the NodeTemplate. * * Generated from protobuf field optional string location_hint = 350519505; */ protected $location_hint = null; /** - * Specifies the frequency of planned maintenance events. The accepted values are: `AS_NEEDED` and `RECURRENT`. + * Specifies the frequency of planned maintenance events. The accepted values + * are: `AS_NEEDED` and `RECURRENT`. * Check the MaintenanceInterval enum for the list of possible values. * * Generated from protobuf field optional string maintenance_interval = 403368049; */ protected $maintenance_interval = null; /** - * Specifies how to handle instances when a node in the group undergoes maintenance. Set to one of: DEFAULT, RESTART_IN_PLACE, or MIGRATE_WITHIN_NODE_GROUP. The default value is DEFAULT. For more information, see Maintenance policies. + * Specifies how to handle instances when a node in the group undergoes + * maintenance. Set to one of: DEFAULT,RESTART_IN_PLACE, or MIGRATE_WITHIN_NODE_GROUP. + * The default value is DEFAULT. For more information, see + * Maintenance policies. * Check the MaintenancePolicy enum for the list of possible values. * * Generated from protobuf field optional string maintenance_policy = 528327646; @@ -74,7 +90,14 @@ class NodeGroup extends \Google\Protobuf\Internal\Message */ protected $maintenance_window = null; /** - * The name of the resource, provided by the client when initially creating the resource. The resource name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * The name of the resource, provided by the client when initially creating + * the resource. The resource name must be 1-63 characters long, and comply + * withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must be + * a dash, lowercase letter, or digit, except the last character, which cannot + * be a dash. * * Generated from protobuf field optional string name = 3373707; */ @@ -111,7 +134,8 @@ class NodeGroup extends \Google\Protobuf\Internal\Message */ protected $status = null; /** - * [Output Only] The name of the zone where the node group resides, such as us-central1-a. + * [Output Only] The name of the zone where the node group resides, + * such as us-central1-a. * * Generated from protobuf field optional string zone = 3744684; */ @@ -126,25 +150,43 @@ class NodeGroup extends \Google\Protobuf\Internal\Message * @type \Google\Cloud\Compute\V1\NodeGroupAutoscalingPolicy $autoscaling_policy * Specifies how autoscaling should behave. * @type string $creation_timestamp - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * @type string $description - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * @type string $fingerprint * @type int|string $id - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * @type string $kind - * [Output Only] The type of the resource. Always compute#nodeGroup for node group. + * [Output Only] The type of the resource. Alwayscompute#nodeGroup for node group. * @type string $location_hint - * An opaque location hint used to place the Node close to other resources. This field is for use by internal tools that use the public API. The location hint here on the NodeGroup overrides any location_hint present in the NodeTemplate. + * An opaque location hint used to place the Node close to other + * resources. + * This field is for use by internal tools that use the public API. + * The location hint here on the NodeGroup overrides any location_hint + * present in the NodeTemplate. * @type string $maintenance_interval - * Specifies the frequency of planned maintenance events. The accepted values are: `AS_NEEDED` and `RECURRENT`. + * Specifies the frequency of planned maintenance events. The accepted values + * are: `AS_NEEDED` and `RECURRENT`. * Check the MaintenanceInterval enum for the list of possible values. * @type string $maintenance_policy - * Specifies how to handle instances when a node in the group undergoes maintenance. Set to one of: DEFAULT, RESTART_IN_PLACE, or MIGRATE_WITHIN_NODE_GROUP. The default value is DEFAULT. For more information, see Maintenance policies. + * Specifies how to handle instances when a node in the group undergoes + * maintenance. Set to one of: DEFAULT,RESTART_IN_PLACE, or MIGRATE_WITHIN_NODE_GROUP. + * The default value is DEFAULT. For more information, see + * Maintenance policies. * Check the MaintenancePolicy enum for the list of possible values. * @type \Google\Cloud\Compute\V1\NodeGroupMaintenanceWindow $maintenance_window * @type string $name - * The name of the resource, provided by the client when initially creating the resource. The resource name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * The name of the resource, provided by the client when initially creating + * the resource. The resource name must be 1-63 characters long, and comply + * withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must be + * a dash, lowercase letter, or digit, except the last character, which cannot + * be a dash. * @type string $node_template * URL of the node template to create the node group from. * @type string $self_link @@ -157,7 +199,8 @@ class NodeGroup extends \Google\Protobuf\Internal\Message * * Check the Status enum for the list of possible values. * @type string $zone - * [Output Only] The name of the zone where the node group resides, such as us-central1-a. + * [Output Only] The name of the zone where the node group resides, + * such as us-central1-a. * } */ public function __construct($data = NULL) { @@ -202,7 +245,8 @@ public function setAutoscalingPolicy($var) } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @return string @@ -223,7 +267,8 @@ public function clearCreationTimestamp() } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @param string $var @@ -238,7 +283,8 @@ public function setCreationTimestamp($var) } /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @return string @@ -259,7 +305,8 @@ public function clearDescription() } /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @param string $var @@ -306,7 +353,8 @@ public function setFingerprint($var) } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @return int|string @@ -327,7 +375,8 @@ public function clearId() } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @param int|string $var @@ -342,7 +391,7 @@ public function setId($var) } /** - * [Output Only] The type of the resource. Always compute#nodeGroup for node group. + * [Output Only] The type of the resource. Alwayscompute#nodeGroup for node group. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -363,7 +412,7 @@ public function clearKind() } /** - * [Output Only] The type of the resource. Always compute#nodeGroup for node group. + * [Output Only] The type of the resource. Alwayscompute#nodeGroup for node group. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -378,7 +427,11 @@ public function setKind($var) } /** - * An opaque location hint used to place the Node close to other resources. This field is for use by internal tools that use the public API. The location hint here on the NodeGroup overrides any location_hint present in the NodeTemplate. + * An opaque location hint used to place the Node close to other + * resources. + * This field is for use by internal tools that use the public API. + * The location hint here on the NodeGroup overrides any location_hint + * present in the NodeTemplate. * * Generated from protobuf field optional string location_hint = 350519505; * @return string @@ -399,7 +452,11 @@ public function clearLocationHint() } /** - * An opaque location hint used to place the Node close to other resources. This field is for use by internal tools that use the public API. The location hint here on the NodeGroup overrides any location_hint present in the NodeTemplate. + * An opaque location hint used to place the Node close to other + * resources. + * This field is for use by internal tools that use the public API. + * The location hint here on the NodeGroup overrides any location_hint + * present in the NodeTemplate. * * Generated from protobuf field optional string location_hint = 350519505; * @param string $var @@ -414,7 +471,8 @@ public function setLocationHint($var) } /** - * Specifies the frequency of planned maintenance events. The accepted values are: `AS_NEEDED` and `RECURRENT`. + * Specifies the frequency of planned maintenance events. The accepted values + * are: `AS_NEEDED` and `RECURRENT`. * Check the MaintenanceInterval enum for the list of possible values. * * Generated from protobuf field optional string maintenance_interval = 403368049; @@ -436,7 +494,8 @@ public function clearMaintenanceInterval() } /** - * Specifies the frequency of planned maintenance events. The accepted values are: `AS_NEEDED` and `RECURRENT`. + * Specifies the frequency of planned maintenance events. The accepted values + * are: `AS_NEEDED` and `RECURRENT`. * Check the MaintenanceInterval enum for the list of possible values. * * Generated from protobuf field optional string maintenance_interval = 403368049; @@ -452,7 +511,10 @@ public function setMaintenanceInterval($var) } /** - * Specifies how to handle instances when a node in the group undergoes maintenance. Set to one of: DEFAULT, RESTART_IN_PLACE, or MIGRATE_WITHIN_NODE_GROUP. The default value is DEFAULT. For more information, see Maintenance policies. + * Specifies how to handle instances when a node in the group undergoes + * maintenance. Set to one of: DEFAULT,RESTART_IN_PLACE, or MIGRATE_WITHIN_NODE_GROUP. + * The default value is DEFAULT. For more information, see + * Maintenance policies. * Check the MaintenancePolicy enum for the list of possible values. * * Generated from protobuf field optional string maintenance_policy = 528327646; @@ -474,7 +536,10 @@ public function clearMaintenancePolicy() } /** - * Specifies how to handle instances when a node in the group undergoes maintenance. Set to one of: DEFAULT, RESTART_IN_PLACE, or MIGRATE_WITHIN_NODE_GROUP. The default value is DEFAULT. For more information, see Maintenance policies. + * Specifies how to handle instances when a node in the group undergoes + * maintenance. Set to one of: DEFAULT,RESTART_IN_PLACE, or MIGRATE_WITHIN_NODE_GROUP. + * The default value is DEFAULT. For more information, see + * Maintenance policies. * Check the MaintenancePolicy enum for the list of possible values. * * Generated from protobuf field optional string maintenance_policy = 528327646; @@ -522,7 +587,14 @@ public function setMaintenanceWindow($var) } /** - * The name of the resource, provided by the client when initially creating the resource. The resource name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * The name of the resource, provided by the client when initially creating + * the resource. The resource name must be 1-63 characters long, and comply + * withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must be + * a dash, lowercase letter, or digit, except the last character, which cannot + * be a dash. * * Generated from protobuf field optional string name = 3373707; * @return string @@ -543,7 +615,14 @@ public function clearName() } /** - * The name of the resource, provided by the client when initially creating the resource. The resource name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * The name of the resource, provided by the client when initially creating + * the resource. The resource name must be 1-63 characters long, and comply + * withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must be + * a dash, lowercase letter, or digit, except the last character, which cannot + * be a dash. * * Generated from protobuf field optional string name = 3373707; * @param string $var @@ -740,7 +819,8 @@ public function setStatus($var) } /** - * [Output Only] The name of the zone where the node group resides, such as us-central1-a. + * [Output Only] The name of the zone where the node group resides, + * such as us-central1-a. * * Generated from protobuf field optional string zone = 3744684; * @return string @@ -761,7 +841,8 @@ public function clearZone() } /** - * [Output Only] The name of the zone where the node group resides, such as us-central1-a. + * [Output Only] The name of the zone where the node group resides, + * such as us-central1-a. * * Generated from protobuf field optional string zone = 3744684; * @param string $var diff --git a/Compute/src/V1/NodeGroup/MaintenanceInterval.php b/Compute/src/V1/NodeGroup/MaintenanceInterval.php index e87940fcf164..6bfcebcc31dc 100644 --- a/Compute/src/V1/NodeGroup/MaintenanceInterval.php +++ b/Compute/src/V1/NodeGroup/MaintenanceInterval.php @@ -7,7 +7,8 @@ use UnexpectedValueException; /** - * Specifies the frequency of planned maintenance events. The accepted values are: `AS_NEEDED` and `RECURRENT`. + * Specifies the frequency of planned maintenance events. The accepted values + * are: `AS_NEEDED` and `RECURRENT`. * * Protobuf type google.cloud.compute.v1.NodeGroup.MaintenanceInterval */ @@ -20,13 +21,20 @@ class MaintenanceInterval */ const UNDEFINED_MAINTENANCE_INTERVAL = 0; /** - * VMs are eligible to receive infrastructure and hypervisor updates as they become available. This may result in more maintenance operations (live migrations or terminations) for the VM than the PERIODIC and RECURRENT options. + * VMs are eligible to receive infrastructure and hypervisor updates as they + * become available. This may result in more maintenance operations (live + * migrations or terminations) for the VM than the PERIODIC andRECURRENT options. * * Generated from protobuf enum AS_NEEDED = 500724834; */ const AS_NEEDED = 500724834; /** - * VMs receive infrastructure and hypervisor updates on a periodic basis, minimizing the number of maintenance operations (live migrations or terminations) on an individual VM. This may mean a VM will take longer to receive an update than if it was configured for AS_NEEDED. Security updates will still be applied as soon as they are available. RECURRENT is used for GEN3 and Slice of Hardware VMs. + * VMs receive infrastructure and hypervisor updates on a periodic basis, + * minimizing the number of maintenance operations (live migrations or + * terminations) on an individual VM. This may mean a VM will take longer + * to receive an update than if it was configured forAS_NEEDED. Security updates will still be applied as soon + * as they are available. RECURRENT is used for GEN3 and Slice + * of Hardware VMs. * * Generated from protobuf enum RECURRENT = 194244550; */ diff --git a/Compute/src/V1/NodeGroup/MaintenancePolicy.php b/Compute/src/V1/NodeGroup/MaintenancePolicy.php index 44d431630064..43af13ad2347 100644 --- a/Compute/src/V1/NodeGroup/MaintenancePolicy.php +++ b/Compute/src/V1/NodeGroup/MaintenancePolicy.php @@ -7,7 +7,10 @@ use UnexpectedValueException; /** - * Specifies how to handle instances when a node in the group undergoes maintenance. Set to one of: DEFAULT, RESTART_IN_PLACE, or MIGRATE_WITHIN_NODE_GROUP. The default value is DEFAULT. For more information, see Maintenance policies. + * Specifies how to handle instances when a node in the group undergoes + * maintenance. Set to one of: DEFAULT,RESTART_IN_PLACE, or MIGRATE_WITHIN_NODE_GROUP. + * The default value is DEFAULT. For more information, see + * Maintenance policies. * * Protobuf type google.cloud.compute.v1.NodeGroup.MaintenancePolicy */ @@ -20,7 +23,8 @@ class MaintenancePolicy */ const UNDEFINED_MAINTENANCE_POLICY = 0; /** - * Allow the node and corresponding instances to retain default maintenance behavior. + * Allow the node and corresponding instances to retain default + * maintenance behavior. * * Generated from protobuf enum DEFAULT = 115302945; */ @@ -30,13 +34,20 @@ class MaintenancePolicy */ const MAINTENANCE_POLICY_UNSPECIFIED = 72964182; /** - * When maintenance must be done on a node, the instances on that node will be moved to other nodes in the group. Instances with onHostMaintenance = MIGRATE will live migrate to their destinations while instances with onHostMaintenance = TERMINATE will terminate and then restart on their destination nodes if automaticRestart = true. + * When maintenance must be done on a node, the instances on that node will + * be moved to other nodes in the group. + * Instances with onHostMaintenance = MIGRATE will live migrate to their + * destinations while instances with onHostMaintenance = TERMINATE will + * terminate and then restart on their destination nodes if + * automaticRestart = true. * * Generated from protobuf enum MIGRATE_WITHIN_NODE_GROUP = 153483394; */ const MIGRATE_WITHIN_NODE_GROUP = 153483394; /** - * Instances in this group will restart on the same node when maintenance has completed. Instances must have onHostMaintenance = TERMINATE, and they will only restart if automaticRestart = true. + * Instances in this group will restart on the same node when maintenance + * has completed. Instances must have onHostMaintenance = TERMINATE, and + * they will only restart if automaticRestart = true. * * Generated from protobuf enum RESTART_IN_PLACE = 228647325; */ diff --git a/Compute/src/V1/NodeGroupAggregatedList.php b/Compute/src/V1/NodeGroupAggregatedList.php index 13c89c4c8e8c..9108c8966be3 100644 --- a/Compute/src/V1/NodeGroupAggregatedList.php +++ b/Compute/src/V1/NodeGroupAggregatedList.php @@ -27,13 +27,18 @@ class NodeGroupAggregatedList extends \Google\Protobuf\Internal\Message */ private $items; /** - * [Output Only] Type of resource.Always compute#nodeGroupAggregatedList for aggregated lists of node groups. + * [Output Only] Type of resource.Alwayscompute#nodeGroupAggregatedList for aggregated lists of node + * groups. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -68,9 +73,14 @@ class NodeGroupAggregatedList extends \Google\Protobuf\Internal\Message * @type array|\Google\Protobuf\Internal\MapField $items * A list of NodeGroupsScopedList resources. * @type string $kind - * [Output Only] Type of resource.Always compute#nodeGroupAggregatedList for aggregated lists of node groups. + * [Output Only] Type of resource.Alwayscompute#nodeGroupAggregatedList for aggregated lists of node + * groups. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type array|\Google\Protobuf\Internal\RepeatedField $unreachables @@ -147,7 +157,8 @@ public function setItems($var) } /** - * [Output Only] Type of resource.Always compute#nodeGroupAggregatedList for aggregated lists of node groups. + * [Output Only] Type of resource.Alwayscompute#nodeGroupAggregatedList for aggregated lists of node + * groups. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -168,7 +179,8 @@ public function clearKind() } /** - * [Output Only] Type of resource.Always compute#nodeGroupAggregatedList for aggregated lists of node groups. + * [Output Only] Type of resource.Alwayscompute#nodeGroupAggregatedList for aggregated lists of node + * groups. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -183,7 +195,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -204,7 +220,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/NodeGroupAutoscalingPolicy.php b/Compute/src/V1/NodeGroupAutoscalingPolicy.php index 6ea6106f330b..940647619591 100644 --- a/Compute/src/V1/NodeGroupAutoscalingPolicy.php +++ b/Compute/src/V1/NodeGroupAutoscalingPolicy.php @@ -15,7 +15,8 @@ class NodeGroupAutoscalingPolicy extends \Google\Protobuf\Internal\Message { /** - * The maximum number of nodes that the group should have. Must be set if autoscaling is enabled. Maximum value allowed is 100. + * The maximum number of nodes that the group should have. Must be set if + * autoscaling is enabled. Maximum value allowed is 100. * * Generated from protobuf field optional int32 max_nodes = 297762838; */ @@ -27,7 +28,9 @@ class NodeGroupAutoscalingPolicy extends \Google\Protobuf\Internal\Message */ protected $min_nodes = null; /** - * The autoscaling mode. Set to one of: ON, OFF, or ONLY_SCALE_OUT. For more information, see Autoscaler modes. + * The autoscaling mode. Set to one of: ON, OFF, + * or ONLY_SCALE_OUT. For more information, see + * Autoscaler modes. * Check the Mode enum for the list of possible values. * * Generated from protobuf field optional string mode = 3357091; @@ -41,11 +44,14 @@ class NodeGroupAutoscalingPolicy extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type int $max_nodes - * The maximum number of nodes that the group should have. Must be set if autoscaling is enabled. Maximum value allowed is 100. + * The maximum number of nodes that the group should have. Must be set if + * autoscaling is enabled. Maximum value allowed is 100. * @type int $min_nodes * The minimum number of nodes that the group should have. * @type string $mode - * The autoscaling mode. Set to one of: ON, OFF, or ONLY_SCALE_OUT. For more information, see Autoscaler modes. + * The autoscaling mode. Set to one of: ON, OFF, + * or ONLY_SCALE_OUT. For more information, see + * Autoscaler modes. * Check the Mode enum for the list of possible values. * } */ @@ -55,7 +61,8 @@ public function __construct($data = NULL) { } /** - * The maximum number of nodes that the group should have. Must be set if autoscaling is enabled. Maximum value allowed is 100. + * The maximum number of nodes that the group should have. Must be set if + * autoscaling is enabled. Maximum value allowed is 100. * * Generated from protobuf field optional int32 max_nodes = 297762838; * @return int @@ -76,7 +83,8 @@ public function clearMaxNodes() } /** - * The maximum number of nodes that the group should have. Must be set if autoscaling is enabled. Maximum value allowed is 100. + * The maximum number of nodes that the group should have. Must be set if + * autoscaling is enabled. Maximum value allowed is 100. * * Generated from protobuf field optional int32 max_nodes = 297762838; * @param int $var @@ -127,7 +135,9 @@ public function setMinNodes($var) } /** - * The autoscaling mode. Set to one of: ON, OFF, or ONLY_SCALE_OUT. For more information, see Autoscaler modes. + * The autoscaling mode. Set to one of: ON, OFF, + * or ONLY_SCALE_OUT. For more information, see + * Autoscaler modes. * Check the Mode enum for the list of possible values. * * Generated from protobuf field optional string mode = 3357091; @@ -149,7 +159,9 @@ public function clearMode() } /** - * The autoscaling mode. Set to one of: ON, OFF, or ONLY_SCALE_OUT. For more information, see Autoscaler modes. + * The autoscaling mode. Set to one of: ON, OFF, + * or ONLY_SCALE_OUT. For more information, see + * Autoscaler modes. * Check the Mode enum for the list of possible values. * * Generated from protobuf field optional string mode = 3357091; diff --git a/Compute/src/V1/NodeGroupAutoscalingPolicy/Mode.php b/Compute/src/V1/NodeGroupAutoscalingPolicy/Mode.php index 18a704cae750..e483d0aa23ad 100644 --- a/Compute/src/V1/NodeGroupAutoscalingPolicy/Mode.php +++ b/Compute/src/V1/NodeGroupAutoscalingPolicy/Mode.php @@ -7,7 +7,9 @@ use UnexpectedValueException; /** - * The autoscaling mode. Set to one of: ON, OFF, or ONLY_SCALE_OUT. For more information, see Autoscaler modes. + * The autoscaling mode. Set to one of: ON, OFF, + * or ONLY_SCALE_OUT. For more information, see + * Autoscaler modes. * * Protobuf type google.cloud.compute.v1.NodeGroupAutoscalingPolicy.Mode */ diff --git a/Compute/src/V1/NodeGroupList.php b/Compute/src/V1/NodeGroupList.php index c0856d85ddaf..d5409992f719 100644 --- a/Compute/src/V1/NodeGroupList.php +++ b/Compute/src/V1/NodeGroupList.php @@ -28,13 +28,18 @@ class NodeGroupList extends \Google\Protobuf\Internal\Message */ private $items; /** - * [Output Only] Type of resource.Always compute#nodeGroupList for lists of node groups. + * [Output Only] Type of resource.Always compute#nodeGroupList + * for lists of node groups. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -63,9 +68,14 @@ class NodeGroupList extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\NodeGroup>|\Google\Protobuf\Internal\RepeatedField $items * A list of NodeGroup resources. * @type string $kind - * [Output Only] Type of resource.Always compute#nodeGroupList for lists of node groups. + * [Output Only] Type of resource.Always compute#nodeGroupList + * for lists of node groups. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type \Google\Cloud\Compute\V1\Warning $warning @@ -140,7 +150,8 @@ public function setItems($var) } /** - * [Output Only] Type of resource.Always compute#nodeGroupList for lists of node groups. + * [Output Only] Type of resource.Always compute#nodeGroupList + * for lists of node groups. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -161,7 +172,8 @@ public function clearKind() } /** - * [Output Only] Type of resource.Always compute#nodeGroupList for lists of node groups. + * [Output Only] Type of resource.Always compute#nodeGroupList + * for lists of node groups. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -176,7 +188,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -197,7 +213,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/NodeGroupMaintenanceWindow.php b/Compute/src/V1/NodeGroupMaintenanceWindow.php index b52b69bb2502..35dec7467107 100644 --- a/Compute/src/V1/NodeGroupMaintenanceWindow.php +++ b/Compute/src/V1/NodeGroupMaintenanceWindow.php @@ -9,20 +9,24 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Time window specified for daily maintenance operations. GCE's internal maintenance will be performed within this window. + * Time window specified for daily maintenance operations. GCE's internal + * maintenance will be performed within this window. * * Generated from protobuf message google.cloud.compute.v1.NodeGroupMaintenanceWindow */ class NodeGroupMaintenanceWindow extends \Google\Protobuf\Internal\Message { /** - * [Output only] A predetermined duration for the window, automatically chosen to be the smallest possible in the given scenario. + * [Output only] A predetermined duration for the window, automatically + * chosen to be the smallest possible in the given scenario. * * Generated from protobuf field optional .google.cloud.compute.v1.Duration maintenance_duration = 525291840; */ protected $maintenance_duration = null; /** - * Start time of the window. This must be in UTC format that resolves to one of 00:00, 04:00, 08:00, 12:00, 16:00, or 20:00. For example, both 13:00-5 and 08:00 are valid. + * Start time of the window. This must be in UTC format that resolves to one + * of 00:00, 04:00, 08:00,12:00, 16:00, or 20:00. For + * example, both 13:00-5 and 08:00 are valid. * * Generated from protobuf field optional string start_time = 37467274; */ @@ -35,9 +39,12 @@ class NodeGroupMaintenanceWindow extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type \Google\Cloud\Compute\V1\Duration $maintenance_duration - * [Output only] A predetermined duration for the window, automatically chosen to be the smallest possible in the given scenario. + * [Output only] A predetermined duration for the window, automatically + * chosen to be the smallest possible in the given scenario. * @type string $start_time - * Start time of the window. This must be in UTC format that resolves to one of 00:00, 04:00, 08:00, 12:00, 16:00, or 20:00. For example, both 13:00-5 and 08:00 are valid. + * Start time of the window. This must be in UTC format that resolves to one + * of 00:00, 04:00, 08:00,12:00, 16:00, or 20:00. For + * example, both 13:00-5 and 08:00 are valid. * } */ public function __construct($data = NULL) { @@ -46,7 +53,8 @@ public function __construct($data = NULL) { } /** - * [Output only] A predetermined duration for the window, automatically chosen to be the smallest possible in the given scenario. + * [Output only] A predetermined duration for the window, automatically + * chosen to be the smallest possible in the given scenario. * * Generated from protobuf field optional .google.cloud.compute.v1.Duration maintenance_duration = 525291840; * @return \Google\Cloud\Compute\V1\Duration|null @@ -67,7 +75,8 @@ public function clearMaintenanceDuration() } /** - * [Output only] A predetermined duration for the window, automatically chosen to be the smallest possible in the given scenario. + * [Output only] A predetermined duration for the window, automatically + * chosen to be the smallest possible in the given scenario. * * Generated from protobuf field optional .google.cloud.compute.v1.Duration maintenance_duration = 525291840; * @param \Google\Cloud\Compute\V1\Duration $var @@ -82,7 +91,9 @@ public function setMaintenanceDuration($var) } /** - * Start time of the window. This must be in UTC format that resolves to one of 00:00, 04:00, 08:00, 12:00, 16:00, or 20:00. For example, both 13:00-5 and 08:00 are valid. + * Start time of the window. This must be in UTC format that resolves to one + * of 00:00, 04:00, 08:00,12:00, 16:00, or 20:00. For + * example, both 13:00-5 and 08:00 are valid. * * Generated from protobuf field optional string start_time = 37467274; * @return string @@ -103,7 +114,9 @@ public function clearStartTime() } /** - * Start time of the window. This must be in UTC format that resolves to one of 00:00, 04:00, 08:00, 12:00, 16:00, or 20:00. For example, both 13:00-5 and 08:00 are valid. + * Start time of the window. This must be in UTC format that resolves to one + * of 00:00, 04:00, 08:00,12:00, 16:00, or 20:00. For + * example, both 13:00-5 and 08:00 are valid. * * Generated from protobuf field optional string start_time = 37467274; * @param string $var diff --git a/Compute/src/V1/NodeGroupsListNodes.php b/Compute/src/V1/NodeGroupsListNodes.php index d88d789c58d4..573812705fd4 100644 --- a/Compute/src/V1/NodeGroupsListNodes.php +++ b/Compute/src/V1/NodeGroupsListNodes.php @@ -27,13 +27,18 @@ class NodeGroupsListNodes extends \Google\Protobuf\Internal\Message */ private $items; /** - * [Output Only] The resource type, which is always compute.nodeGroupsListNodes for the list of nodes in the specified node group. + * [Output Only] The resource type, which is alwayscompute.nodeGroupsListNodes for the list of nodes in the + * specified node group. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -62,9 +67,14 @@ class NodeGroupsListNodes extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\NodeGroupNode>|\Google\Protobuf\Internal\RepeatedField $items * A list of Node resources. * @type string $kind - * [Output Only] The resource type, which is always compute.nodeGroupsListNodes for the list of nodes in the specified node group. + * [Output Only] The resource type, which is alwayscompute.nodeGroupsListNodes for the list of nodes in the + * specified node group. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type \Google\Cloud\Compute\V1\Warning $warning @@ -139,7 +149,8 @@ public function setItems($var) } /** - * [Output Only] The resource type, which is always compute.nodeGroupsListNodes for the list of nodes in the specified node group. + * [Output Only] The resource type, which is alwayscompute.nodeGroupsListNodes for the list of nodes in the + * specified node group. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -160,7 +171,8 @@ public function clearKind() } /** - * [Output Only] The resource type, which is always compute.nodeGroupsListNodes for the list of nodes in the specified node group. + * [Output Only] The resource type, which is alwayscompute.nodeGroupsListNodes for the list of nodes in the + * specified node group. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -175,7 +187,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -196,7 +212,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/NodeGroupsScopedList.php b/Compute/src/V1/NodeGroupsScopedList.php index 702c8f1d16cf..be51e1a36de9 100644 --- a/Compute/src/V1/NodeGroupsScopedList.php +++ b/Compute/src/V1/NodeGroupsScopedList.php @@ -21,7 +21,8 @@ class NodeGroupsScopedList extends \Google\Protobuf\Internal\Message */ private $node_groups; /** - * [Output Only] An informational warning that appears when the nodeGroup list is empty. + * [Output Only] An informational warning that appears when the nodeGroup + * list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; */ @@ -36,7 +37,8 @@ class NodeGroupsScopedList extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\NodeGroup>|\Google\Protobuf\Internal\RepeatedField $node_groups * [Output Only] A list of node groups contained in this scope. * @type \Google\Cloud\Compute\V1\Warning $warning - * [Output Only] An informational warning that appears when the nodeGroup list is empty. + * [Output Only] An informational warning that appears when the nodeGroup + * list is empty. * } */ public function __construct($data = NULL) { @@ -71,7 +73,8 @@ public function setNodeGroups($var) } /** - * [Output Only] An informational warning that appears when the nodeGroup list is empty. + * [Output Only] An informational warning that appears when the nodeGroup + * list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; * @return \Google\Cloud\Compute\V1\Warning|null @@ -92,7 +95,8 @@ public function clearWarning() } /** - * [Output Only] An informational warning that appears when the nodeGroup list is empty. + * [Output Only] An informational warning that appears when the nodeGroup + * list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; * @param \Google\Cloud\Compute\V1\Warning $var diff --git a/Compute/src/V1/NodeGroupsSetNodeTemplateRequest.php b/Compute/src/V1/NodeGroupsSetNodeTemplateRequest.php index 48a0478774a4..75dbc528a705 100644 --- a/Compute/src/V1/NodeGroupsSetNodeTemplateRequest.php +++ b/Compute/src/V1/NodeGroupsSetNodeTemplateRequest.php @@ -15,7 +15,8 @@ class NodeGroupsSetNodeTemplateRequest extends \Google\Protobuf\Internal\Message { /** - * Full or partial URL of the node template resource to be updated for this node group. + * Full or partial URL of the node template resource to be updated for this + * node group. * * Generated from protobuf field optional string node_template = 323154455; */ @@ -28,7 +29,8 @@ class NodeGroupsSetNodeTemplateRequest extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $node_template - * Full or partial URL of the node template resource to be updated for this node group. + * Full or partial URL of the node template resource to be updated for this + * node group. * } */ public function __construct($data = NULL) { @@ -37,7 +39,8 @@ public function __construct($data = NULL) { } /** - * Full or partial URL of the node template resource to be updated for this node group. + * Full or partial URL of the node template resource to be updated for this + * node group. * * Generated from protobuf field optional string node_template = 323154455; * @return string @@ -58,7 +61,8 @@ public function clearNodeTemplate() } /** - * Full or partial URL of the node template resource to be updated for this node group. + * Full or partial URL of the node template resource to be updated for this + * node group. * * Generated from protobuf field optional string node_template = 323154455; * @param string $var diff --git a/Compute/src/V1/NodeTemplate.php b/Compute/src/V1/NodeTemplate.php index 067c1e33dc32..d17b96cf34a7 100644 --- a/Compute/src/V1/NodeTemplate.php +++ b/Compute/src/V1/NodeTemplate.php @@ -9,7 +9,10 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Represent a sole-tenant Node Template resource. You can use a template to define properties for nodes in a node group. For more information, read Creating node groups and instances. + * Represent a sole-tenant Node Template resource. + * You can use a template to define properties for nodes in a node group. For + * more information, readCreating node groups + * and instances. * * Generated from protobuf message google.cloud.compute.v1.NodeTemplate */ @@ -27,13 +30,15 @@ class NodeTemplate extends \Google\Protobuf\Internal\Message */ protected $cpu_overcommit_type = null; /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; */ protected $creation_timestamp = null; /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; */ @@ -43,19 +48,27 @@ class NodeTemplate extends \Google\Protobuf\Internal\Message */ private $disks; /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; */ protected $id = null; /** - * [Output Only] The type of the resource. Always compute#nodeTemplate for node templates. + * [Output Only] The type of the resource. Alwayscompute#nodeTemplate for node templates. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * The name of the resource, provided by the client when initially creating the resource. The resource name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * The name of the resource, provided by the client when initially creating + * the resource. The resource name must be 1-63 characters long, and comply + * withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must be + * a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * * Generated from protobuf field optional string name = 3373707; */ @@ -79,7 +92,8 @@ class NodeTemplate extends \Google\Protobuf\Internal\Message */ protected $node_type_flexibility = null; /** - * [Output Only] The name of the region where the node template resides, such as us-central1. + * [Output Only] The name of the region where the node template resides, + * such as us-central1. * * Generated from protobuf field optional string region = 138946292; */ @@ -91,13 +105,20 @@ class NodeTemplate extends \Google\Protobuf\Internal\Message */ protected $self_link = null; /** - * Sets the binding properties for the physical server. Valid values include: - *[Default]* RESTART_NODE_ON_ANY_SERVER: Restarts VMs on any available physical server - RESTART_NODE_ON_MINIMAL_SERVER: Restarts VMs on the same physical server whenever possible See Sole-tenant node options for more information. + * Sets the binding properties for the physical server. Valid values include: + * - *[Default]* RESTART_NODE_ON_ANY_SERVER: + * Restarts VMs on any available + * physical server + * - RESTART_NODE_ON_MINIMAL_SERVER: Restarts VMs on the same + * physical server whenever possible + * See Sole-tenant + * node options for more information. * * Generated from protobuf field optional .google.cloud.compute.v1.ServerBinding server_binding = 208179593; */ protected $server_binding = null; /** - * [Output Only] The status of the node template. One of the following values: CREATING, READY, and DELETING. + * [Output Only] The status of the node template. One of the following values:CREATING, READY, and DELETING. * Check the Status enum for the list of possible values. * * Generated from protobuf field optional string status = 181260274; @@ -121,16 +142,26 @@ class NodeTemplate extends \Google\Protobuf\Internal\Message * CPU overcommit. * Check the CpuOvercommitType enum for the list of possible values. * @type string $creation_timestamp - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * @type string $description - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * @type array<\Google\Cloud\Compute\V1\LocalDisk>|\Google\Protobuf\Internal\RepeatedField $disks * @type int|string $id - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * @type string $kind - * [Output Only] The type of the resource. Always compute#nodeTemplate for node templates. + * [Output Only] The type of the resource. Alwayscompute#nodeTemplate for node templates. * @type string $name - * The name of the resource, provided by the client when initially creating the resource. The resource name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * The name of the resource, provided by the client when initially creating + * the resource. The resource name must be 1-63 characters long, and comply + * withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must be + * a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * @type array|\Google\Protobuf\Internal\MapField $node_affinity_labels * Labels to use for node affinity, which will be used in instance scheduling. * @type string $node_type @@ -138,13 +169,21 @@ class NodeTemplate extends \Google\Protobuf\Internal\Message * @type \Google\Cloud\Compute\V1\NodeTemplateNodeTypeFlexibility $node_type_flexibility * Do not use. Instead, use the node_type property. * @type string $region - * [Output Only] The name of the region where the node template resides, such as us-central1. + * [Output Only] The name of the region where the node template resides, + * such as us-central1. * @type string $self_link * [Output Only] Server-defined URL for the resource. * @type \Google\Cloud\Compute\V1\ServerBinding $server_binding - * Sets the binding properties for the physical server. Valid values include: - *[Default]* RESTART_NODE_ON_ANY_SERVER: Restarts VMs on any available physical server - RESTART_NODE_ON_MINIMAL_SERVER: Restarts VMs on the same physical server whenever possible See Sole-tenant node options for more information. + * Sets the binding properties for the physical server. Valid values include: + * - *[Default]* RESTART_NODE_ON_ANY_SERVER: + * Restarts VMs on any available + * physical server + * - RESTART_NODE_ON_MINIMAL_SERVER: Restarts VMs on the same + * physical server whenever possible + * See Sole-tenant + * node options for more information. * @type string $status - * [Output Only] The status of the node template. One of the following values: CREATING, READY, and DELETING. + * [Output Only] The status of the node template. One of the following values:CREATING, READY, and DELETING. * Check the Status enum for the list of possible values. * @type string $status_message * [Output Only] An optional, human-readable explanation of the status. @@ -216,7 +255,8 @@ public function setCpuOvercommitType($var) } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @return string @@ -237,7 +277,8 @@ public function clearCreationTimestamp() } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @param string $var @@ -252,7 +293,8 @@ public function setCreationTimestamp($var) } /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @return string @@ -273,7 +315,8 @@ public function clearDescription() } /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @param string $var @@ -310,7 +353,8 @@ public function setDisks($var) } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @return int|string @@ -331,7 +375,8 @@ public function clearId() } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @param int|string $var @@ -346,7 +391,7 @@ public function setId($var) } /** - * [Output Only] The type of the resource. Always compute#nodeTemplate for node templates. + * [Output Only] The type of the resource. Alwayscompute#nodeTemplate for node templates. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -367,7 +412,7 @@ public function clearKind() } /** - * [Output Only] The type of the resource. Always compute#nodeTemplate for node templates. + * [Output Only] The type of the resource. Alwayscompute#nodeTemplate for node templates. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -382,7 +427,14 @@ public function setKind($var) } /** - * The name of the resource, provided by the client when initially creating the resource. The resource name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * The name of the resource, provided by the client when initially creating + * the resource. The resource name must be 1-63 characters long, and comply + * withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must be + * a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * * Generated from protobuf field optional string name = 3373707; * @return string @@ -403,7 +455,14 @@ public function clearName() } /** - * The name of the resource, provided by the client when initially creating the resource. The resource name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * The name of the resource, provided by the client when initially creating + * the resource. The resource name must be 1-63 characters long, and comply + * withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must be + * a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * * Generated from protobuf field optional string name = 3373707; * @param string $var @@ -516,7 +575,8 @@ public function setNodeTypeFlexibility($var) } /** - * [Output Only] The name of the region where the node template resides, such as us-central1. + * [Output Only] The name of the region where the node template resides, + * such as us-central1. * * Generated from protobuf field optional string region = 138946292; * @return string @@ -537,7 +597,8 @@ public function clearRegion() } /** - * [Output Only] The name of the region where the node template resides, such as us-central1. + * [Output Only] The name of the region where the node template resides, + * such as us-central1. * * Generated from protobuf field optional string region = 138946292; * @param string $var @@ -588,7 +649,14 @@ public function setSelfLink($var) } /** - * Sets the binding properties for the physical server. Valid values include: - *[Default]* RESTART_NODE_ON_ANY_SERVER: Restarts VMs on any available physical server - RESTART_NODE_ON_MINIMAL_SERVER: Restarts VMs on the same physical server whenever possible See Sole-tenant node options for more information. + * Sets the binding properties for the physical server. Valid values include: + * - *[Default]* RESTART_NODE_ON_ANY_SERVER: + * Restarts VMs on any available + * physical server + * - RESTART_NODE_ON_MINIMAL_SERVER: Restarts VMs on the same + * physical server whenever possible + * See Sole-tenant + * node options for more information. * * Generated from protobuf field optional .google.cloud.compute.v1.ServerBinding server_binding = 208179593; * @return \Google\Cloud\Compute\V1\ServerBinding|null @@ -609,7 +677,14 @@ public function clearServerBinding() } /** - * Sets the binding properties for the physical server. Valid values include: - *[Default]* RESTART_NODE_ON_ANY_SERVER: Restarts VMs on any available physical server - RESTART_NODE_ON_MINIMAL_SERVER: Restarts VMs on the same physical server whenever possible See Sole-tenant node options for more information. + * Sets the binding properties for the physical server. Valid values include: + * - *[Default]* RESTART_NODE_ON_ANY_SERVER: + * Restarts VMs on any available + * physical server + * - RESTART_NODE_ON_MINIMAL_SERVER: Restarts VMs on the same + * physical server whenever possible + * See Sole-tenant + * node options for more information. * * Generated from protobuf field optional .google.cloud.compute.v1.ServerBinding server_binding = 208179593; * @param \Google\Cloud\Compute\V1\ServerBinding $var @@ -624,7 +699,7 @@ public function setServerBinding($var) } /** - * [Output Only] The status of the node template. One of the following values: CREATING, READY, and DELETING. + * [Output Only] The status of the node template. One of the following values:CREATING, READY, and DELETING. * Check the Status enum for the list of possible values. * * Generated from protobuf field optional string status = 181260274; @@ -646,7 +721,7 @@ public function clearStatus() } /** - * [Output Only] The status of the node template. One of the following values: CREATING, READY, and DELETING. + * [Output Only] The status of the node template. One of the following values:CREATING, READY, and DELETING. * Check the Status enum for the list of possible values. * * Generated from protobuf field optional string status = 181260274; diff --git a/Compute/src/V1/NodeTemplate/Status.php b/Compute/src/V1/NodeTemplate/Status.php index 0830467b227c..37393cb7171c 100644 --- a/Compute/src/V1/NodeTemplate/Status.php +++ b/Compute/src/V1/NodeTemplate/Status.php @@ -7,7 +7,7 @@ use UnexpectedValueException; /** - * [Output Only] The status of the node template. One of the following values: CREATING, READY, and DELETING. + * [Output Only] The status of the node template. One of the following values:CREATING, READY, and DELETING. * * Protobuf type google.cloud.compute.v1.NodeTemplate.Status */ diff --git a/Compute/src/V1/NodeTemplateAggregatedList.php b/Compute/src/V1/NodeTemplateAggregatedList.php index 97c487e7efc7..990a9ccefa48 100644 --- a/Compute/src/V1/NodeTemplateAggregatedList.php +++ b/Compute/src/V1/NodeTemplateAggregatedList.php @@ -27,13 +27,18 @@ class NodeTemplateAggregatedList extends \Google\Protobuf\Internal\Message */ private $items; /** - * [Output Only] Type of resource.Always compute#nodeTemplateAggregatedList for aggregated lists of node templates. + * [Output Only] Type of resource.Alwayscompute#nodeTemplateAggregatedList for aggregated lists of + * node templates. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -68,9 +73,14 @@ class NodeTemplateAggregatedList extends \Google\Protobuf\Internal\Message * @type array|\Google\Protobuf\Internal\MapField $items * A list of NodeTemplatesScopedList resources. * @type string $kind - * [Output Only] Type of resource.Always compute#nodeTemplateAggregatedList for aggregated lists of node templates. + * [Output Only] Type of resource.Alwayscompute#nodeTemplateAggregatedList for aggregated lists of + * node templates. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type array|\Google\Protobuf\Internal\RepeatedField $unreachables @@ -147,7 +157,8 @@ public function setItems($var) } /** - * [Output Only] Type of resource.Always compute#nodeTemplateAggregatedList for aggregated lists of node templates. + * [Output Only] Type of resource.Alwayscompute#nodeTemplateAggregatedList for aggregated lists of + * node templates. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -168,7 +179,8 @@ public function clearKind() } /** - * [Output Only] Type of resource.Always compute#nodeTemplateAggregatedList for aggregated lists of node templates. + * [Output Only] Type of resource.Alwayscompute#nodeTemplateAggregatedList for aggregated lists of + * node templates. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -183,7 +195,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -204,7 +220,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/NodeTemplateList.php b/Compute/src/V1/NodeTemplateList.php index 4fd1eb587255..7cd8a157afc4 100644 --- a/Compute/src/V1/NodeTemplateList.php +++ b/Compute/src/V1/NodeTemplateList.php @@ -28,13 +28,18 @@ class NodeTemplateList extends \Google\Protobuf\Internal\Message */ private $items; /** - * [Output Only] Type of resource.Always compute#nodeTemplateList for lists of node templates. + * [Output Only] Type of resource.Always compute#nodeTemplateList + * for lists of node templates. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -63,9 +68,14 @@ class NodeTemplateList extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\NodeTemplate>|\Google\Protobuf\Internal\RepeatedField $items * A list of NodeTemplate resources. * @type string $kind - * [Output Only] Type of resource.Always compute#nodeTemplateList for lists of node templates. + * [Output Only] Type of resource.Always compute#nodeTemplateList + * for lists of node templates. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type \Google\Cloud\Compute\V1\Warning $warning @@ -140,7 +150,8 @@ public function setItems($var) } /** - * [Output Only] Type of resource.Always compute#nodeTemplateList for lists of node templates. + * [Output Only] Type of resource.Always compute#nodeTemplateList + * for lists of node templates. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -161,7 +172,8 @@ public function clearKind() } /** - * [Output Only] Type of resource.Always compute#nodeTemplateList for lists of node templates. + * [Output Only] Type of resource.Always compute#nodeTemplateList + * for lists of node templates. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -176,7 +188,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -197,7 +213,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/NodeTemplatesScopedList.php b/Compute/src/V1/NodeTemplatesScopedList.php index afdca08c4455..0988f8d4a0ca 100644 --- a/Compute/src/V1/NodeTemplatesScopedList.php +++ b/Compute/src/V1/NodeTemplatesScopedList.php @@ -21,7 +21,8 @@ class NodeTemplatesScopedList extends \Google\Protobuf\Internal\Message */ private $node_templates; /** - * [Output Only] An informational warning that appears when the node templates list is empty. + * [Output Only] An informational warning that appears when the node templates + * list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; */ @@ -36,7 +37,8 @@ class NodeTemplatesScopedList extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\NodeTemplate>|\Google\Protobuf\Internal\RepeatedField $node_templates * [Output Only] A list of node templates contained in this scope. * @type \Google\Cloud\Compute\V1\Warning $warning - * [Output Only] An informational warning that appears when the node templates list is empty. + * [Output Only] An informational warning that appears when the node templates + * list is empty. * } */ public function __construct($data = NULL) { @@ -71,7 +73,8 @@ public function setNodeTemplates($var) } /** - * [Output Only] An informational warning that appears when the node templates list is empty. + * [Output Only] An informational warning that appears when the node templates + * list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; * @return \Google\Cloud\Compute\V1\Warning|null @@ -92,7 +95,8 @@ public function clearWarning() } /** - * [Output Only] An informational warning that appears when the node templates list is empty. + * [Output Only] An informational warning that appears when the node templates + * list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; * @param \Google\Cloud\Compute\V1\Warning $var diff --git a/Compute/src/V1/NodeType.php b/Compute/src/V1/NodeType.php index f018c4951b2c..cf9a9cc5b268 100644 --- a/Compute/src/V1/NodeType.php +++ b/Compute/src/V1/NodeType.php @@ -9,7 +9,12 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Represent a sole-tenant Node Type resource. Each node within a node group must have a node type. A node type specifies the total amount of cores and memory for that node. Currently, the only available node type is n1-node-96-624 node type that has 96 vCPUs and 624 GB of memory, available in multiple zones. For more information read Node types. + * Represent a sole-tenant Node Type resource. + * Each node within a node group must have a node type. A node type specifies + * the total amount of cores and memory for that node. Currently, the only + * available node type is n1-node-96-624 node type that has 96 + * vCPUs and 624 GB of memory, available in multiple zones. For more information + * readNode types. * * Generated from protobuf message google.cloud.compute.v1.NodeType */ @@ -22,7 +27,8 @@ class NodeType extends \Google\Protobuf\Internal\Message */ protected $cpu_platform = null; /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; */ @@ -40,19 +46,21 @@ class NodeType extends \Google\Protobuf\Internal\Message */ protected $description = null; /** - * [Output Only] The number of virtual CPUs that are available to the node type. + * [Output Only] The number of virtual CPUs that are available to the node + * type. * * Generated from protobuf field optional int32 guest_cpus = 393356754; */ protected $guest_cpus = null; /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; */ protected $id = null; /** - * [Output Only] The type of the resource. Always compute#nodeType for node types. + * [Output Only] The type of the resource. Alwayscompute#nodeType for node types. * * Generated from protobuf field optional string kind = 3292052; */ @@ -70,7 +78,8 @@ class NodeType extends \Google\Protobuf\Internal\Message */ protected $max_vms = null; /** - * [Output Only] The amount of physical memory available to the node type, defined in MB. + * [Output Only] The amount of physical memory available to the node type, + * defined in MB. * * Generated from protobuf field optional int32 memory_mb = 116001171; */ @@ -88,7 +97,8 @@ class NodeType extends \Google\Protobuf\Internal\Message */ protected $self_link = null; /** - * [Output Only] The name of the zone where the node type resides, such as us-central1-a. + * [Output Only] The name of the zone where the node type resides, + * such as us-central1-a. * * Generated from protobuf field optional string zone = 3744684; */ @@ -103,29 +113,34 @@ class NodeType extends \Google\Protobuf\Internal\Message * @type string $cpu_platform * [Output Only] The CPU platform used by this node type. * @type string $creation_timestamp - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * @type \Google\Cloud\Compute\V1\DeprecationStatus $deprecated * [Output Only] The deprecation status associated with this node type. * @type string $description * [Output Only] An optional textual description of the resource. * @type int $guest_cpus - * [Output Only] The number of virtual CPUs that are available to the node type. + * [Output Only] The number of virtual CPUs that are available to the node + * type. * @type int|string $id - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * @type string $kind - * [Output Only] The type of the resource. Always compute#nodeType for node types. + * [Output Only] The type of the resource. Alwayscompute#nodeType for node types. * @type int $local_ssd_gb * [Output Only] Local SSD available to the node type, defined in GB. * @type int $max_vms * [Output Only] Maximum number of VMs that can be created for this node type. * @type int $memory_mb - * [Output Only] The amount of physical memory available to the node type, defined in MB. + * [Output Only] The amount of physical memory available to the node type, + * defined in MB. * @type string $name * [Output Only] Name of the resource. * @type string $self_link * [Output Only] Server-defined URL for the resource. * @type string $zone - * [Output Only] The name of the zone where the node type resides, such as us-central1-a. + * [Output Only] The name of the zone where the node type resides, + * such as us-central1-a. * } */ public function __construct($data = NULL) { @@ -170,7 +185,8 @@ public function setCpuPlatform($var) } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @return string @@ -191,7 +207,8 @@ public function clearCreationTimestamp() } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @param string $var @@ -278,7 +295,8 @@ public function setDescription($var) } /** - * [Output Only] The number of virtual CPUs that are available to the node type. + * [Output Only] The number of virtual CPUs that are available to the node + * type. * * Generated from protobuf field optional int32 guest_cpus = 393356754; * @return int @@ -299,7 +317,8 @@ public function clearGuestCpus() } /** - * [Output Only] The number of virtual CPUs that are available to the node type. + * [Output Only] The number of virtual CPUs that are available to the node + * type. * * Generated from protobuf field optional int32 guest_cpus = 393356754; * @param int $var @@ -314,7 +333,8 @@ public function setGuestCpus($var) } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @return int|string @@ -335,7 +355,8 @@ public function clearId() } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @param int|string $var @@ -350,7 +371,7 @@ public function setId($var) } /** - * [Output Only] The type of the resource. Always compute#nodeType for node types. + * [Output Only] The type of the resource. Alwayscompute#nodeType for node types. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -371,7 +392,7 @@ public function clearKind() } /** - * [Output Only] The type of the resource. Always compute#nodeType for node types. + * [Output Only] The type of the resource. Alwayscompute#nodeType for node types. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -458,7 +479,8 @@ public function setMaxVms($var) } /** - * [Output Only] The amount of physical memory available to the node type, defined in MB. + * [Output Only] The amount of physical memory available to the node type, + * defined in MB. * * Generated from protobuf field optional int32 memory_mb = 116001171; * @return int @@ -479,7 +501,8 @@ public function clearMemoryMb() } /** - * [Output Only] The amount of physical memory available to the node type, defined in MB. + * [Output Only] The amount of physical memory available to the node type, + * defined in MB. * * Generated from protobuf field optional int32 memory_mb = 116001171; * @param int $var @@ -566,7 +589,8 @@ public function setSelfLink($var) } /** - * [Output Only] The name of the zone where the node type resides, such as us-central1-a. + * [Output Only] The name of the zone where the node type resides, + * such as us-central1-a. * * Generated from protobuf field optional string zone = 3744684; * @return string @@ -587,7 +611,8 @@ public function clearZone() } /** - * [Output Only] The name of the zone where the node type resides, such as us-central1-a. + * [Output Only] The name of the zone where the node type resides, + * such as us-central1-a. * * Generated from protobuf field optional string zone = 3744684; * @param string $var diff --git a/Compute/src/V1/NodeTypeAggregatedList.php b/Compute/src/V1/NodeTypeAggregatedList.php index f4f0ac6dda36..dcd87de94095 100644 --- a/Compute/src/V1/NodeTypeAggregatedList.php +++ b/Compute/src/V1/NodeTypeAggregatedList.php @@ -27,13 +27,18 @@ class NodeTypeAggregatedList extends \Google\Protobuf\Internal\Message */ private $items; /** - * [Output Only] Type of resource.Always compute#nodeTypeAggregatedList for aggregated lists of node types. + * [Output Only] Type of resource.Alwayscompute#nodeTypeAggregatedList for aggregated lists of node + * types. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -68,9 +73,14 @@ class NodeTypeAggregatedList extends \Google\Protobuf\Internal\Message * @type array|\Google\Protobuf\Internal\MapField $items * A list of NodeTypesScopedList resources. * @type string $kind - * [Output Only] Type of resource.Always compute#nodeTypeAggregatedList for aggregated lists of node types. + * [Output Only] Type of resource.Alwayscompute#nodeTypeAggregatedList for aggregated lists of node + * types. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type array|\Google\Protobuf\Internal\RepeatedField $unreachables @@ -147,7 +157,8 @@ public function setItems($var) } /** - * [Output Only] Type of resource.Always compute#nodeTypeAggregatedList for aggregated lists of node types. + * [Output Only] Type of resource.Alwayscompute#nodeTypeAggregatedList for aggregated lists of node + * types. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -168,7 +179,8 @@ public function clearKind() } /** - * [Output Only] Type of resource.Always compute#nodeTypeAggregatedList for aggregated lists of node types. + * [Output Only] Type of resource.Alwayscompute#nodeTypeAggregatedList for aggregated lists of node + * types. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -183,7 +195,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -204,7 +220,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/NodeTypeList.php b/Compute/src/V1/NodeTypeList.php index d3ad64a3e98a..116a50ac6200 100644 --- a/Compute/src/V1/NodeTypeList.php +++ b/Compute/src/V1/NodeTypeList.php @@ -28,13 +28,18 @@ class NodeTypeList extends \Google\Protobuf\Internal\Message */ private $items; /** - * [Output Only] Type of resource.Always compute#nodeTypeList for lists of node types. + * [Output Only] Type of resource.Always compute#nodeTypeList for + * lists of node types. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -63,9 +68,14 @@ class NodeTypeList extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\NodeType>|\Google\Protobuf\Internal\RepeatedField $items * A list of NodeType resources. * @type string $kind - * [Output Only] Type of resource.Always compute#nodeTypeList for lists of node types. + * [Output Only] Type of resource.Always compute#nodeTypeList for + * lists of node types. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type \Google\Cloud\Compute\V1\Warning $warning @@ -140,7 +150,8 @@ public function setItems($var) } /** - * [Output Only] Type of resource.Always compute#nodeTypeList for lists of node types. + * [Output Only] Type of resource.Always compute#nodeTypeList for + * lists of node types. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -161,7 +172,8 @@ public function clearKind() } /** - * [Output Only] Type of resource.Always compute#nodeTypeList for lists of node types. + * [Output Only] Type of resource.Always compute#nodeTypeList for + * lists of node types. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -176,7 +188,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -197,7 +213,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/NodeTypesScopedList.php b/Compute/src/V1/NodeTypesScopedList.php index 020655aba4f6..64f656c3d0e3 100644 --- a/Compute/src/V1/NodeTypesScopedList.php +++ b/Compute/src/V1/NodeTypesScopedList.php @@ -21,7 +21,8 @@ class NodeTypesScopedList extends \Google\Protobuf\Internal\Message */ private $node_types; /** - * [Output Only] An informational warning that appears when the node types list is empty. + * [Output Only] An informational warning that appears when the node types + * list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; */ @@ -36,7 +37,8 @@ class NodeTypesScopedList extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\NodeType>|\Google\Protobuf\Internal\RepeatedField $node_types * [Output Only] A list of node types contained in this scope. * @type \Google\Cloud\Compute\V1\Warning $warning - * [Output Only] An informational warning that appears when the node types list is empty. + * [Output Only] An informational warning that appears when the node types + * list is empty. * } */ public function __construct($data = NULL) { @@ -71,7 +73,8 @@ public function setNodeTypes($var) } /** - * [Output Only] An informational warning that appears when the node types list is empty. + * [Output Only] An informational warning that appears when the node types + * list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; * @return \Google\Cloud\Compute\V1\Warning|null @@ -92,7 +95,8 @@ public function clearWarning() } /** - * [Output Only] An informational warning that appears when the node types list is empty. + * [Output Only] An informational warning that appears when the node types + * list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; * @param \Google\Cloud\Compute\V1\Warning $var diff --git a/Compute/src/V1/NotificationEndpoint.php b/Compute/src/V1/NotificationEndpoint.php index 6f2345a2c3d0..005633b1c773 100644 --- a/Compute/src/V1/NotificationEndpoint.php +++ b/Compute/src/V1/NotificationEndpoint.php @@ -9,50 +9,68 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Represents a notification endpoint. A notification endpoint resource defines an endpoint to receive notifications when there are status changes detected by the associated health check service. For more information, see Health checks overview. + * Represents a notification endpoint. + * A notification endpoint resource defines an endpoint to receive notifications + * when there are status changes detected by the associated health check + * service. + * For more information, see + * Health checks overview. * * Generated from protobuf message google.cloud.compute.v1.NotificationEndpoint */ class NotificationEndpoint extends \Google\Protobuf\Internal\Message { /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; */ protected $creation_timestamp = null; /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; */ protected $description = null; /** - * Settings of the gRPC notification endpoint including the endpoint URL and the retry duration. + * Settings of the gRPC notification endpoint including the endpoint URL and + * the retry duration. * * Generated from protobuf field optional .google.cloud.compute.v1.NotificationEndpointGrpcSettings grpc_settings = 456139556; */ protected $grpc_settings = null; /** - * [Output Only] A unique identifier for this resource type. The server generates this identifier. + * [Output Only] A unique identifier for this resource type. The server + * generates this identifier. * * Generated from protobuf field optional uint64 id = 3355; */ protected $id = null; /** - * [Output Only] Type of the resource. Always compute#notificationEndpoint for notification endpoints. + * [Output Only] Type of the resource. Alwayscompute#notificationEndpoint for notification endpoints. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * * Generated from protobuf field optional string name = 3373707; */ protected $name = null; /** - * [Output Only] URL of the region where the notification endpoint resides. This field applies only to the regional resource. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * [Output Only] URL of the region where the notification endpoint resides. + * This field applies only to the regional resource. You must specify this + * field as part of the HTTP request URL. It is not settable as a field in + * the request body. * * Generated from protobuf field optional string region = 138946292; */ @@ -71,19 +89,32 @@ class NotificationEndpoint extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $creation_timestamp - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * @type string $description - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * @type \Google\Cloud\Compute\V1\NotificationEndpointGrpcSettings $grpc_settings - * Settings of the gRPC notification endpoint including the endpoint URL and the retry duration. + * Settings of the gRPC notification endpoint including the endpoint URL and + * the retry duration. * @type int|string $id - * [Output Only] A unique identifier for this resource type. The server generates this identifier. + * [Output Only] A unique identifier for this resource type. The server + * generates this identifier. * @type string $kind - * [Output Only] Type of the resource. Always compute#notificationEndpoint for notification endpoints. + * [Output Only] Type of the resource. Alwayscompute#notificationEndpoint for notification endpoints. * @type string $name - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * @type string $region - * [Output Only] URL of the region where the notification endpoint resides. This field applies only to the regional resource. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * [Output Only] URL of the region where the notification endpoint resides. + * This field applies only to the regional resource. You must specify this + * field as part of the HTTP request URL. It is not settable as a field in + * the request body. * @type string $self_link * [Output Only] Server-defined URL for the resource. * } @@ -94,7 +125,8 @@ public function __construct($data = NULL) { } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @return string @@ -115,7 +147,8 @@ public function clearCreationTimestamp() } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @param string $var @@ -130,7 +163,8 @@ public function setCreationTimestamp($var) } /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @return string @@ -151,7 +185,8 @@ public function clearDescription() } /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @param string $var @@ -166,7 +201,8 @@ public function setDescription($var) } /** - * Settings of the gRPC notification endpoint including the endpoint URL and the retry duration. + * Settings of the gRPC notification endpoint including the endpoint URL and + * the retry duration. * * Generated from protobuf field optional .google.cloud.compute.v1.NotificationEndpointGrpcSettings grpc_settings = 456139556; * @return \Google\Cloud\Compute\V1\NotificationEndpointGrpcSettings|null @@ -187,7 +223,8 @@ public function clearGrpcSettings() } /** - * Settings of the gRPC notification endpoint including the endpoint URL and the retry duration. + * Settings of the gRPC notification endpoint including the endpoint URL and + * the retry duration. * * Generated from protobuf field optional .google.cloud.compute.v1.NotificationEndpointGrpcSettings grpc_settings = 456139556; * @param \Google\Cloud\Compute\V1\NotificationEndpointGrpcSettings $var @@ -202,7 +239,8 @@ public function setGrpcSettings($var) } /** - * [Output Only] A unique identifier for this resource type. The server generates this identifier. + * [Output Only] A unique identifier for this resource type. The server + * generates this identifier. * * Generated from protobuf field optional uint64 id = 3355; * @return int|string @@ -223,7 +261,8 @@ public function clearId() } /** - * [Output Only] A unique identifier for this resource type. The server generates this identifier. + * [Output Only] A unique identifier for this resource type. The server + * generates this identifier. * * Generated from protobuf field optional uint64 id = 3355; * @param int|string $var @@ -238,7 +277,7 @@ public function setId($var) } /** - * [Output Only] Type of the resource. Always compute#notificationEndpoint for notification endpoints. + * [Output Only] Type of the resource. Alwayscompute#notificationEndpoint for notification endpoints. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -259,7 +298,7 @@ public function clearKind() } /** - * [Output Only] Type of the resource. Always compute#notificationEndpoint for notification endpoints. + * [Output Only] Type of the resource. Alwayscompute#notificationEndpoint for notification endpoints. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -274,7 +313,13 @@ public function setKind($var) } /** - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * * Generated from protobuf field optional string name = 3373707; * @return string @@ -295,7 +340,13 @@ public function clearName() } /** - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * * Generated from protobuf field optional string name = 3373707; * @param string $var @@ -310,7 +361,10 @@ public function setName($var) } /** - * [Output Only] URL of the region where the notification endpoint resides. This field applies only to the regional resource. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * [Output Only] URL of the region where the notification endpoint resides. + * This field applies only to the regional resource. You must specify this + * field as part of the HTTP request URL. It is not settable as a field in + * the request body. * * Generated from protobuf field optional string region = 138946292; * @return string @@ -331,7 +385,10 @@ public function clearRegion() } /** - * [Output Only] URL of the region where the notification endpoint resides. This field applies only to the regional resource. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * [Output Only] URL of the region where the notification endpoint resides. + * This field applies only to the regional resource. You must specify this + * field as part of the HTTP request URL. It is not settable as a field in + * the request body. * * Generated from protobuf field optional string region = 138946292; * @param string $var diff --git a/Compute/src/V1/NotificationEndpointGrpcSettings.php b/Compute/src/V1/NotificationEndpointGrpcSettings.php index 467ea3be1637..af5e83d9bd40 100644 --- a/Compute/src/V1/NotificationEndpointGrpcSettings.php +++ b/Compute/src/V1/NotificationEndpointGrpcSettings.php @@ -9,38 +9,49 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Represents a gRPC setting that describes one gRPC notification endpoint and the retry duration attempting to send notification to this endpoint. + * Represents a gRPC setting that describes one gRPC notification endpoint and + * the retry duration attempting to send notification to this endpoint. * * Generated from protobuf message google.cloud.compute.v1.NotificationEndpointGrpcSettings */ class NotificationEndpointGrpcSettings extends \Google\Protobuf\Internal\Message { /** - * Optional. If specified, this field is used to set the authority header by the sender of notifications. See https://tools.ietf.org/html/rfc7540#section-8.1.2.3 + * Optional. If specified, this field is used to set the authority header by + * the sender of notifications. See + * https://tools.ietf.org/html/rfc7540#section-8.1.2.3 * * Generated from protobuf field optional string authority = 401868611; */ protected $authority = null; /** - * Endpoint to which gRPC notifications are sent. This must be a valid gRPCLB DNS name. + * Endpoint to which gRPC notifications are sent. This must be a valid + * gRPCLB DNS name. * * Generated from protobuf field optional string endpoint = 130489749; */ protected $endpoint = null; /** - * Optional. If specified, this field is used to populate the "name" field in gRPC requests. + * Optional. If specified, this field is used to populate the "name" field + * in gRPC requests. * * Generated from protobuf field optional string payload_name = 300358300; */ protected $payload_name = null; /** - * Optional. This field is used to configure how often to send a full update of all non-healthy backends. If unspecified, full updates are not sent. If specified, must be in the range between 600 seconds to 3600 seconds. Nanos are disallowed. Can only be set for regional notification endpoints. + * Optional. This field is used to configure how often to send a full update + * of all non-healthy backends. If unspecified, full updates are not sent. + * If specified, must be in the range between 600 seconds to 3600 seconds. + * Nanos are disallowed. Can only be set for regional notification + * endpoints. * * Generated from protobuf field optional .google.cloud.compute.v1.Duration resend_interval = 478288969; */ protected $resend_interval = null; /** - * How much time (in seconds) is spent attempting notification retries until a successful response is received. Default is 30s. Limit is 20m (1200s). Must be a positive number. + * How much time (in seconds) is spent attempting notification retries + * until a successful response is received. Default is 30s. Limit is 20m + * (1200s). Must be a positive number. * * Generated from protobuf field optional uint32 retry_duration_sec = 115681117; */ @@ -53,15 +64,25 @@ class NotificationEndpointGrpcSettings extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $authority - * Optional. If specified, this field is used to set the authority header by the sender of notifications. See https://tools.ietf.org/html/rfc7540#section-8.1.2.3 + * Optional. If specified, this field is used to set the authority header by + * the sender of notifications. See + * https://tools.ietf.org/html/rfc7540#section-8.1.2.3 * @type string $endpoint - * Endpoint to which gRPC notifications are sent. This must be a valid gRPCLB DNS name. + * Endpoint to which gRPC notifications are sent. This must be a valid + * gRPCLB DNS name. * @type string $payload_name - * Optional. If specified, this field is used to populate the "name" field in gRPC requests. + * Optional. If specified, this field is used to populate the "name" field + * in gRPC requests. * @type \Google\Cloud\Compute\V1\Duration $resend_interval - * Optional. This field is used to configure how often to send a full update of all non-healthy backends. If unspecified, full updates are not sent. If specified, must be in the range between 600 seconds to 3600 seconds. Nanos are disallowed. Can only be set for regional notification endpoints. + * Optional. This field is used to configure how often to send a full update + * of all non-healthy backends. If unspecified, full updates are not sent. + * If specified, must be in the range between 600 seconds to 3600 seconds. + * Nanos are disallowed. Can only be set for regional notification + * endpoints. * @type int $retry_duration_sec - * How much time (in seconds) is spent attempting notification retries until a successful response is received. Default is 30s. Limit is 20m (1200s). Must be a positive number. + * How much time (in seconds) is spent attempting notification retries + * until a successful response is received. Default is 30s. Limit is 20m + * (1200s). Must be a positive number. * } */ public function __construct($data = NULL) { @@ -70,7 +91,9 @@ public function __construct($data = NULL) { } /** - * Optional. If specified, this field is used to set the authority header by the sender of notifications. See https://tools.ietf.org/html/rfc7540#section-8.1.2.3 + * Optional. If specified, this field is used to set the authority header by + * the sender of notifications. See + * https://tools.ietf.org/html/rfc7540#section-8.1.2.3 * * Generated from protobuf field optional string authority = 401868611; * @return string @@ -91,7 +114,9 @@ public function clearAuthority() } /** - * Optional. If specified, this field is used to set the authority header by the sender of notifications. See https://tools.ietf.org/html/rfc7540#section-8.1.2.3 + * Optional. If specified, this field is used to set the authority header by + * the sender of notifications. See + * https://tools.ietf.org/html/rfc7540#section-8.1.2.3 * * Generated from protobuf field optional string authority = 401868611; * @param string $var @@ -106,7 +131,8 @@ public function setAuthority($var) } /** - * Endpoint to which gRPC notifications are sent. This must be a valid gRPCLB DNS name. + * Endpoint to which gRPC notifications are sent. This must be a valid + * gRPCLB DNS name. * * Generated from protobuf field optional string endpoint = 130489749; * @return string @@ -127,7 +153,8 @@ public function clearEndpoint() } /** - * Endpoint to which gRPC notifications are sent. This must be a valid gRPCLB DNS name. + * Endpoint to which gRPC notifications are sent. This must be a valid + * gRPCLB DNS name. * * Generated from protobuf field optional string endpoint = 130489749; * @param string $var @@ -142,7 +169,8 @@ public function setEndpoint($var) } /** - * Optional. If specified, this field is used to populate the "name" field in gRPC requests. + * Optional. If specified, this field is used to populate the "name" field + * in gRPC requests. * * Generated from protobuf field optional string payload_name = 300358300; * @return string @@ -163,7 +191,8 @@ public function clearPayloadName() } /** - * Optional. If specified, this field is used to populate the "name" field in gRPC requests. + * Optional. If specified, this field is used to populate the "name" field + * in gRPC requests. * * Generated from protobuf field optional string payload_name = 300358300; * @param string $var @@ -178,7 +207,11 @@ public function setPayloadName($var) } /** - * Optional. This field is used to configure how often to send a full update of all non-healthy backends. If unspecified, full updates are not sent. If specified, must be in the range between 600 seconds to 3600 seconds. Nanos are disallowed. Can only be set for regional notification endpoints. + * Optional. This field is used to configure how often to send a full update + * of all non-healthy backends. If unspecified, full updates are not sent. + * If specified, must be in the range between 600 seconds to 3600 seconds. + * Nanos are disallowed. Can only be set for regional notification + * endpoints. * * Generated from protobuf field optional .google.cloud.compute.v1.Duration resend_interval = 478288969; * @return \Google\Cloud\Compute\V1\Duration|null @@ -199,7 +232,11 @@ public function clearResendInterval() } /** - * Optional. This field is used to configure how often to send a full update of all non-healthy backends. If unspecified, full updates are not sent. If specified, must be in the range between 600 seconds to 3600 seconds. Nanos are disallowed. Can only be set for regional notification endpoints. + * Optional. This field is used to configure how often to send a full update + * of all non-healthy backends. If unspecified, full updates are not sent. + * If specified, must be in the range between 600 seconds to 3600 seconds. + * Nanos are disallowed. Can only be set for regional notification + * endpoints. * * Generated from protobuf field optional .google.cloud.compute.v1.Duration resend_interval = 478288969; * @param \Google\Cloud\Compute\V1\Duration $var @@ -214,7 +251,9 @@ public function setResendInterval($var) } /** - * How much time (in seconds) is spent attempting notification retries until a successful response is received. Default is 30s. Limit is 20m (1200s). Must be a positive number. + * How much time (in seconds) is spent attempting notification retries + * until a successful response is received. Default is 30s. Limit is 20m + * (1200s). Must be a positive number. * * Generated from protobuf field optional uint32 retry_duration_sec = 115681117; * @return int @@ -235,7 +274,9 @@ public function clearRetryDurationSec() } /** - * How much time (in seconds) is spent attempting notification retries until a successful response is received. Default is 30s. Limit is 20m (1200s). Must be a positive number. + * How much time (in seconds) is spent attempting notification retries + * until a successful response is received. Default is 30s. Limit is 20m + * (1200s). Must be a positive number. * * Generated from protobuf field optional uint32 retry_duration_sec = 115681117; * @param int $var diff --git a/Compute/src/V1/NotificationEndpointList.php b/Compute/src/V1/NotificationEndpointList.php index 64012f6c9434..166c70f4355c 100644 --- a/Compute/src/V1/NotificationEndpointList.php +++ b/Compute/src/V1/NotificationEndpointList.php @@ -27,13 +27,17 @@ class NotificationEndpointList extends \Google\Protobuf\Internal\Message */ private $items; /** - * [Output Only] Type of the resource. Always compute#notificationEndpoint for notification endpoints. + * [Output Only] Type of the resource. Alwayscompute#notificationEndpoint for notification endpoints. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -62,9 +66,13 @@ class NotificationEndpointList extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\NotificationEndpoint>|\Google\Protobuf\Internal\RepeatedField $items * A list of NotificationEndpoint resources. * @type string $kind - * [Output Only] Type of the resource. Always compute#notificationEndpoint for notification endpoints. + * [Output Only] Type of the resource. Alwayscompute#notificationEndpoint for notification endpoints. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type \Google\Cloud\Compute\V1\Warning $warning @@ -139,7 +147,7 @@ public function setItems($var) } /** - * [Output Only] Type of the resource. Always compute#notificationEndpoint for notification endpoints. + * [Output Only] Type of the resource. Alwayscompute#notificationEndpoint for notification endpoints. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -160,7 +168,7 @@ public function clearKind() } /** - * [Output Only] Type of the resource. Always compute#notificationEndpoint for notification endpoints. + * [Output Only] Type of the resource. Alwayscompute#notificationEndpoint for notification endpoints. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -175,7 +183,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -196,7 +208,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/Operation.php b/Compute/src/V1/Operation.php index aa30d650ec02..40d42308a502 100644 --- a/Compute/src/V1/Operation.php +++ b/Compute/src/V1/Operation.php @@ -9,14 +9,33 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Represents an Operation resource. Google Compute Engine has three Operation resources: * [Global](/compute/docs/reference/rest/v1/globalOperations) * [Regional](/compute/docs/reference/rest/v1/regionOperations) * [Zonal](/compute/docs/reference/rest/v1/zoneOperations) You can use an operation resource to manage asynchronous API requests. For more information, read Handling API responses. Operations can be global, regional or zonal. - For global operations, use the `globalOperations` resource. - For regional operations, use the `regionOperations` resource. - For zonal operations, use the `zoneOperations` resource. For more information, read Global, Regional, and Zonal Resources. Note that completed Operation resources have a limited retention period. + * Represents an Operation resource. + * Google Compute Engine has three Operation resources: + * * [Global](/compute/docs/reference/rest/v1/globalOperations) + * * [Regional](/compute/docs/reference/rest/v1/regionOperations) + * * [Zonal](/compute/docs/reference/rest/v1/zoneOperations) + * You can use an operation resource to manage asynchronous API requests. + * For more information, readHandling + * API responses. + * Operations can be global, regional or zonal. + * - For global operations, use the `globalOperations` + * resource. + * - For regional operations, use the + * `regionOperations` resource. + * - For zonal operations, use + * the `zoneOperations` resource. + * For more information, read + * Global, Regional, and Zonal Resources. + * Note that completed Operation resources have a limited + * retention period. * * Generated from protobuf message google.cloud.compute.v1.Operation */ class Operation extends \Google\Protobuf\Internal\Message { /** - * [Output Only] The value of `requestId` if you provided it in the request. Not present otherwise. + * [Output Only] The value of `requestId` if you provided it in the request. + * Not present otherwise. * * Generated from protobuf field optional string client_operation_id = 297240295; */ @@ -28,43 +47,52 @@ class Operation extends \Google\Protobuf\Internal\Message */ protected $creation_timestamp = null; /** - * [Output Only] A textual description of the operation, which is set when the operation is created. + * [Output Only] A textual description of the operation, which is + * set when the operation is created. * * Generated from protobuf field optional string description = 422937596; */ protected $description = null; /** - * [Output Only] The time that this operation was completed. This value is in RFC3339 text format. + * [Output Only] The time that this operation was completed. This value is inRFC3339 + * text format. * * Generated from protobuf field optional string end_time = 114938801; */ protected $end_time = null; /** - * [Output Only] If errors are generated during processing of the operation, this field will be populated. + * [Output Only] If errors are generated during processing of the operation, + * this field will be populated. * * Generated from protobuf field optional .google.cloud.compute.v1.Error error = 96784904; */ protected $error = null; /** - * [Output Only] If the operation fails, this field contains the HTTP error message that was returned, such as `NOT FOUND`. + * [Output Only] If the operation fails, this field contains the HTTP error + * message that was returned, such as `NOT FOUND`. * * Generated from protobuf field optional string http_error_message = 202521945 [(.google.cloud.operation_field) = ERROR_MESSAGE]; */ protected $http_error_message = null; /** - * [Output Only] If the operation fails, this field contains the HTTP error status code that was returned. For example, a `404` means the resource was not found. + * [Output Only] If the operation fails, this field contains the HTTP error + * status code that was returned. For example, a `404` means the + * resource was not found. * * Generated from protobuf field optional int32 http_error_status_code = 312345196 [(.google.cloud.operation_field) = ERROR_CODE]; */ protected $http_error_status_code = null; /** - * [Output Only] The unique identifier for the operation. This identifier is defined by the server. + * [Output Only] The unique identifier for the operation. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; */ protected $id = null; /** - * [Output Only] The time that this operation was requested. This value is in RFC3339 text format. + * [Output Only] The time that this operation was requested. + * This value is inRFC3339 + * text format. * * Generated from protobuf field optional string insert_time = 433722515; */ @@ -74,7 +102,8 @@ class Operation extends \Google\Protobuf\Internal\Message */ protected $instances_bulk_insert_operation_metadata = null; /** - * [Output Only] Type of the resource. Always `compute#operation` for Operation resources. + * [Output Only] Type of the resource. Always `compute#operation` for + * Operation resources. * * Generated from protobuf field optional string kind = 3292052; */ @@ -86,25 +115,32 @@ class Operation extends \Google\Protobuf\Internal\Message */ protected $name = null; /** - * [Output Only] An ID that represents a group of operations, such as when a group of operations results from a `bulkInsert` API request. + * [Output Only] An ID that represents a group of operations, such as when a + * group of operations results from a `bulkInsert` API request. * * Generated from protobuf field optional string operation_group_id = 40171187; */ protected $operation_group_id = null; /** - * [Output Only] The type of operation, such as `insert`, `update`, or `delete`, and so on. + * [Output Only] The type of operation, such as `insert`, + * `update`, or `delete`, and so on. * * Generated from protobuf field optional string operation_type = 177650450; */ protected $operation_type = null; /** - * [Output Only] An optional progress indicator that ranges from 0 to 100. There is no requirement that this be linear or support any granularity of operations. This should not be used to guess when the operation will be complete. This number should monotonically increase as the operation progresses. + * [Output Only] An optional progress indicator that ranges from 0 to 100. + * There is no requirement that this be linear or support any granularity of + * operations. This should not be used to guess when the operation will be + * complete. This number should monotonically increase as the operation + * progresses. * * Generated from protobuf field optional int32 progress = 72663597; */ protected $progress = null; /** - * [Output Only] The URL of the region where the operation resides. Only applicable when performing regional operations. + * [Output Only] The URL of the region where the operation resides. Only + * applicable when performing regional operations. * * Generated from protobuf field optional string region = 138946292; */ @@ -116,55 +152,69 @@ class Operation extends \Google\Protobuf\Internal\Message */ protected $self_link = null; /** - * [Output Only] If the operation is for projects.setCommonInstanceMetadata, this field will contain information on all underlying zonal actions and their state. + * [Output Only] If the operation is for projects.setCommonInstanceMetadata, + * this field will contain information on all underlying zonal actions and + * their state. * * Generated from protobuf field optional .google.cloud.compute.v1.SetCommonInstanceMetadataOperationMetadata set_common_instance_metadata_operation_metadata = 490378980; */ protected $set_common_instance_metadata_operation_metadata = null; /** - * [Output Only] The time that this operation was started by the server. This value is in RFC3339 text format. + * [Output Only] The time that this operation was started by the server. + * This value is inRFC3339 + * text format. * * Generated from protobuf field optional string start_time = 37467274; */ protected $start_time = null; /** - * [Output Only] The status of the operation, which can be one of the following: `PENDING`, `RUNNING`, or `DONE`. + * [Output Only] The status of the operation, which can be one of the + * following: + * `PENDING`, `RUNNING`, or `DONE`. * * Generated from protobuf field optional .google.cloud.compute.v1.Operation.Status status = 181260274 [(.google.cloud.operation_field) = STATUS]; */ protected $status = null; /** - * [Output Only] An optional textual description of the current status of the operation. + * [Output Only] An optional textual description of the current status of the + * operation. * * Generated from protobuf field optional string status_message = 297428154; */ protected $status_message = null; /** - * [Output Only] The unique target ID, which identifies a specific incarnation of the target resource. + * [Output Only] The unique target ID, which identifies a specific incarnation + * of the target resource. * * Generated from protobuf field optional uint64 target_id = 258165385; */ protected $target_id = null; /** - * [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the disk that the snapshot was created from. + * [Output Only] The URL of the resource that the operation modifies. For + * operations related to creating a snapshot, this points to the disk + * that the snapshot was created from. * * Generated from protobuf field optional string target_link = 62671336; */ protected $target_link = null; /** - * [Output Only] User who requested the operation, for example: `user@example.com` or `alice_smith_identifier (global/workforcePools/example-com-us-employees)`. + * [Output Only] User who requested the operation, for example: + * `user@example.com` or + * `alice_smith_identifier (global/workforcePools/example-com-us-employees)`. * * Generated from protobuf field optional string user = 3599307; */ protected $user = null; /** - * [Output Only] If warning messages are generated during processing of the operation, this field will be populated. + * [Output Only] If warning messages are generated during processing of the + * operation, this field will be populated. * * Generated from protobuf field repeated .google.cloud.compute.v1.Warnings warnings = 498091095; */ private $warnings; /** - * [Output Only] The URL of the zone where the operation resides. Only applicable when performing per-zone operations. + * [Output Only] The URL of the zone where the operation resides. Only + * applicable when performing per-zone operations. * * Generated from protobuf field optional string zone = 3744684; */ @@ -177,56 +227,88 @@ class Operation extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $client_operation_id - * [Output Only] The value of `requestId` if you provided it in the request. Not present otherwise. + * [Output Only] The value of `requestId` if you provided it in the request. + * Not present otherwise. * @type string $creation_timestamp * [Deprecated] This field is deprecated. * @type string $description - * [Output Only] A textual description of the operation, which is set when the operation is created. + * [Output Only] A textual description of the operation, which is + * set when the operation is created. * @type string $end_time - * [Output Only] The time that this operation was completed. This value is in RFC3339 text format. + * [Output Only] The time that this operation was completed. This value is inRFC3339 + * text format. * @type \Google\Cloud\Compute\V1\Error $error - * [Output Only] If errors are generated during processing of the operation, this field will be populated. + * [Output Only] If errors are generated during processing of the operation, + * this field will be populated. * @type string $http_error_message - * [Output Only] If the operation fails, this field contains the HTTP error message that was returned, such as `NOT FOUND`. + * [Output Only] If the operation fails, this field contains the HTTP error + * message that was returned, such as `NOT FOUND`. * @type int $http_error_status_code - * [Output Only] If the operation fails, this field contains the HTTP error status code that was returned. For example, a `404` means the resource was not found. + * [Output Only] If the operation fails, this field contains the HTTP error + * status code that was returned. For example, a `404` means the + * resource was not found. * @type int|string $id - * [Output Only] The unique identifier for the operation. This identifier is defined by the server. + * [Output Only] The unique identifier for the operation. This identifier is + * defined by the server. * @type string $insert_time - * [Output Only] The time that this operation was requested. This value is in RFC3339 text format. + * [Output Only] The time that this operation was requested. + * This value is inRFC3339 + * text format. * @type \Google\Cloud\Compute\V1\InstancesBulkInsertOperationMetadata $instances_bulk_insert_operation_metadata * @type string $kind - * [Output Only] Type of the resource. Always `compute#operation` for Operation resources. + * [Output Only] Type of the resource. Always `compute#operation` for + * Operation resources. * @type string $name * [Output Only] Name of the operation. * @type string $operation_group_id - * [Output Only] An ID that represents a group of operations, such as when a group of operations results from a `bulkInsert` API request. + * [Output Only] An ID that represents a group of operations, such as when a + * group of operations results from a `bulkInsert` API request. * @type string $operation_type - * [Output Only] The type of operation, such as `insert`, `update`, or `delete`, and so on. + * [Output Only] The type of operation, such as `insert`, + * `update`, or `delete`, and so on. * @type int $progress - * [Output Only] An optional progress indicator that ranges from 0 to 100. There is no requirement that this be linear or support any granularity of operations. This should not be used to guess when the operation will be complete. This number should monotonically increase as the operation progresses. + * [Output Only] An optional progress indicator that ranges from 0 to 100. + * There is no requirement that this be linear or support any granularity of + * operations. This should not be used to guess when the operation will be + * complete. This number should monotonically increase as the operation + * progresses. * @type string $region - * [Output Only] The URL of the region where the operation resides. Only applicable when performing regional operations. + * [Output Only] The URL of the region where the operation resides. Only + * applicable when performing regional operations. * @type string $self_link * [Output Only] Server-defined URL for the resource. * @type \Google\Cloud\Compute\V1\SetCommonInstanceMetadataOperationMetadata $set_common_instance_metadata_operation_metadata - * [Output Only] If the operation is for projects.setCommonInstanceMetadata, this field will contain information on all underlying zonal actions and their state. + * [Output Only] If the operation is for projects.setCommonInstanceMetadata, + * this field will contain information on all underlying zonal actions and + * their state. * @type string $start_time - * [Output Only] The time that this operation was started by the server. This value is in RFC3339 text format. + * [Output Only] The time that this operation was started by the server. + * This value is inRFC3339 + * text format. * @type int $status - * [Output Only] The status of the operation, which can be one of the following: `PENDING`, `RUNNING`, or `DONE`. + * [Output Only] The status of the operation, which can be one of the + * following: + * `PENDING`, `RUNNING`, or `DONE`. * @type string $status_message - * [Output Only] An optional textual description of the current status of the operation. + * [Output Only] An optional textual description of the current status of the + * operation. * @type int|string $target_id - * [Output Only] The unique target ID, which identifies a specific incarnation of the target resource. + * [Output Only] The unique target ID, which identifies a specific incarnation + * of the target resource. * @type string $target_link - * [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the disk that the snapshot was created from. + * [Output Only] The URL of the resource that the operation modifies. For + * operations related to creating a snapshot, this points to the disk + * that the snapshot was created from. * @type string $user - * [Output Only] User who requested the operation, for example: `user@example.com` or `alice_smith_identifier (global/workforcePools/example-com-us-employees)`. + * [Output Only] User who requested the operation, for example: + * `user@example.com` or + * `alice_smith_identifier (global/workforcePools/example-com-us-employees)`. * @type array<\Google\Cloud\Compute\V1\Warnings>|\Google\Protobuf\Internal\RepeatedField $warnings - * [Output Only] If warning messages are generated during processing of the operation, this field will be populated. + * [Output Only] If warning messages are generated during processing of the + * operation, this field will be populated. * @type string $zone - * [Output Only] The URL of the zone where the operation resides. Only applicable when performing per-zone operations. + * [Output Only] The URL of the zone where the operation resides. Only + * applicable when performing per-zone operations. * } */ public function __construct($data = NULL) { @@ -235,7 +317,8 @@ public function __construct($data = NULL) { } /** - * [Output Only] The value of `requestId` if you provided it in the request. Not present otherwise. + * [Output Only] The value of `requestId` if you provided it in the request. + * Not present otherwise. * * Generated from protobuf field optional string client_operation_id = 297240295; * @return string @@ -256,7 +339,8 @@ public function clearClientOperationId() } /** - * [Output Only] The value of `requestId` if you provided it in the request. Not present otherwise. + * [Output Only] The value of `requestId` if you provided it in the request. + * Not present otherwise. * * Generated from protobuf field optional string client_operation_id = 297240295; * @param string $var @@ -307,7 +391,8 @@ public function setCreationTimestamp($var) } /** - * [Output Only] A textual description of the operation, which is set when the operation is created. + * [Output Only] A textual description of the operation, which is + * set when the operation is created. * * Generated from protobuf field optional string description = 422937596; * @return string @@ -328,7 +413,8 @@ public function clearDescription() } /** - * [Output Only] A textual description of the operation, which is set when the operation is created. + * [Output Only] A textual description of the operation, which is + * set when the operation is created. * * Generated from protobuf field optional string description = 422937596; * @param string $var @@ -343,7 +429,8 @@ public function setDescription($var) } /** - * [Output Only] The time that this operation was completed. This value is in RFC3339 text format. + * [Output Only] The time that this operation was completed. This value is inRFC3339 + * text format. * * Generated from protobuf field optional string end_time = 114938801; * @return string @@ -364,7 +451,8 @@ public function clearEndTime() } /** - * [Output Only] The time that this operation was completed. This value is in RFC3339 text format. + * [Output Only] The time that this operation was completed. This value is inRFC3339 + * text format. * * Generated from protobuf field optional string end_time = 114938801; * @param string $var @@ -379,7 +467,8 @@ public function setEndTime($var) } /** - * [Output Only] If errors are generated during processing of the operation, this field will be populated. + * [Output Only] If errors are generated during processing of the operation, + * this field will be populated. * * Generated from protobuf field optional .google.cloud.compute.v1.Error error = 96784904; * @return \Google\Cloud\Compute\V1\Error|null @@ -400,7 +489,8 @@ public function clearError() } /** - * [Output Only] If errors are generated during processing of the operation, this field will be populated. + * [Output Only] If errors are generated during processing of the operation, + * this field will be populated. * * Generated from protobuf field optional .google.cloud.compute.v1.Error error = 96784904; * @param \Google\Cloud\Compute\V1\Error $var @@ -415,7 +505,8 @@ public function setError($var) } /** - * [Output Only] If the operation fails, this field contains the HTTP error message that was returned, such as `NOT FOUND`. + * [Output Only] If the operation fails, this field contains the HTTP error + * message that was returned, such as `NOT FOUND`. * * Generated from protobuf field optional string http_error_message = 202521945 [(.google.cloud.operation_field) = ERROR_MESSAGE]; * @return string @@ -436,7 +527,8 @@ public function clearHttpErrorMessage() } /** - * [Output Only] If the operation fails, this field contains the HTTP error message that was returned, such as `NOT FOUND`. + * [Output Only] If the operation fails, this field contains the HTTP error + * message that was returned, such as `NOT FOUND`. * * Generated from protobuf field optional string http_error_message = 202521945 [(.google.cloud.operation_field) = ERROR_MESSAGE]; * @param string $var @@ -451,7 +543,9 @@ public function setHttpErrorMessage($var) } /** - * [Output Only] If the operation fails, this field contains the HTTP error status code that was returned. For example, a `404` means the resource was not found. + * [Output Only] If the operation fails, this field contains the HTTP error + * status code that was returned. For example, a `404` means the + * resource was not found. * * Generated from protobuf field optional int32 http_error_status_code = 312345196 [(.google.cloud.operation_field) = ERROR_CODE]; * @return int @@ -472,7 +566,9 @@ public function clearHttpErrorStatusCode() } /** - * [Output Only] If the operation fails, this field contains the HTTP error status code that was returned. For example, a `404` means the resource was not found. + * [Output Only] If the operation fails, this field contains the HTTP error + * status code that was returned. For example, a `404` means the + * resource was not found. * * Generated from protobuf field optional int32 http_error_status_code = 312345196 [(.google.cloud.operation_field) = ERROR_CODE]; * @param int $var @@ -487,7 +583,8 @@ public function setHttpErrorStatusCode($var) } /** - * [Output Only] The unique identifier for the operation. This identifier is defined by the server. + * [Output Only] The unique identifier for the operation. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @return int|string @@ -508,7 +605,8 @@ public function clearId() } /** - * [Output Only] The unique identifier for the operation. This identifier is defined by the server. + * [Output Only] The unique identifier for the operation. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @param int|string $var @@ -523,7 +621,9 @@ public function setId($var) } /** - * [Output Only] The time that this operation was requested. This value is in RFC3339 text format. + * [Output Only] The time that this operation was requested. + * This value is inRFC3339 + * text format. * * Generated from protobuf field optional string insert_time = 433722515; * @return string @@ -544,7 +644,9 @@ public function clearInsertTime() } /** - * [Output Only] The time that this operation was requested. This value is in RFC3339 text format. + * [Output Only] The time that this operation was requested. + * This value is inRFC3339 + * text format. * * Generated from protobuf field optional string insert_time = 433722515; * @param string $var @@ -591,7 +693,8 @@ public function setInstancesBulkInsertOperationMetadata($var) } /** - * [Output Only] Type of the resource. Always `compute#operation` for Operation resources. + * [Output Only] Type of the resource. Always `compute#operation` for + * Operation resources. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -612,7 +715,8 @@ public function clearKind() } /** - * [Output Only] Type of the resource. Always `compute#operation` for Operation resources. + * [Output Only] Type of the resource. Always `compute#operation` for + * Operation resources. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -663,7 +767,8 @@ public function setName($var) } /** - * [Output Only] An ID that represents a group of operations, such as when a group of operations results from a `bulkInsert` API request. + * [Output Only] An ID that represents a group of operations, such as when a + * group of operations results from a `bulkInsert` API request. * * Generated from protobuf field optional string operation_group_id = 40171187; * @return string @@ -684,7 +789,8 @@ public function clearOperationGroupId() } /** - * [Output Only] An ID that represents a group of operations, such as when a group of operations results from a `bulkInsert` API request. + * [Output Only] An ID that represents a group of operations, such as when a + * group of operations results from a `bulkInsert` API request. * * Generated from protobuf field optional string operation_group_id = 40171187; * @param string $var @@ -699,7 +805,8 @@ public function setOperationGroupId($var) } /** - * [Output Only] The type of operation, such as `insert`, `update`, or `delete`, and so on. + * [Output Only] The type of operation, such as `insert`, + * `update`, or `delete`, and so on. * * Generated from protobuf field optional string operation_type = 177650450; * @return string @@ -720,7 +827,8 @@ public function clearOperationType() } /** - * [Output Only] The type of operation, such as `insert`, `update`, or `delete`, and so on. + * [Output Only] The type of operation, such as `insert`, + * `update`, or `delete`, and so on. * * Generated from protobuf field optional string operation_type = 177650450; * @param string $var @@ -735,7 +843,11 @@ public function setOperationType($var) } /** - * [Output Only] An optional progress indicator that ranges from 0 to 100. There is no requirement that this be linear or support any granularity of operations. This should not be used to guess when the operation will be complete. This number should monotonically increase as the operation progresses. + * [Output Only] An optional progress indicator that ranges from 0 to 100. + * There is no requirement that this be linear or support any granularity of + * operations. This should not be used to guess when the operation will be + * complete. This number should monotonically increase as the operation + * progresses. * * Generated from protobuf field optional int32 progress = 72663597; * @return int @@ -756,7 +868,11 @@ public function clearProgress() } /** - * [Output Only] An optional progress indicator that ranges from 0 to 100. There is no requirement that this be linear or support any granularity of operations. This should not be used to guess when the operation will be complete. This number should monotonically increase as the operation progresses. + * [Output Only] An optional progress indicator that ranges from 0 to 100. + * There is no requirement that this be linear or support any granularity of + * operations. This should not be used to guess when the operation will be + * complete. This number should monotonically increase as the operation + * progresses. * * Generated from protobuf field optional int32 progress = 72663597; * @param int $var @@ -771,7 +887,8 @@ public function setProgress($var) } /** - * [Output Only] The URL of the region where the operation resides. Only applicable when performing regional operations. + * [Output Only] The URL of the region where the operation resides. Only + * applicable when performing regional operations. * * Generated from protobuf field optional string region = 138946292; * @return string @@ -792,7 +909,8 @@ public function clearRegion() } /** - * [Output Only] The URL of the region where the operation resides. Only applicable when performing regional operations. + * [Output Only] The URL of the region where the operation resides. Only + * applicable when performing regional operations. * * Generated from protobuf field optional string region = 138946292; * @param string $var @@ -843,7 +961,9 @@ public function setSelfLink($var) } /** - * [Output Only] If the operation is for projects.setCommonInstanceMetadata, this field will contain information on all underlying zonal actions and their state. + * [Output Only] If the operation is for projects.setCommonInstanceMetadata, + * this field will contain information on all underlying zonal actions and + * their state. * * Generated from protobuf field optional .google.cloud.compute.v1.SetCommonInstanceMetadataOperationMetadata set_common_instance_metadata_operation_metadata = 490378980; * @return \Google\Cloud\Compute\V1\SetCommonInstanceMetadataOperationMetadata|null @@ -864,7 +984,9 @@ public function clearSetCommonInstanceMetadataOperationMetadata() } /** - * [Output Only] If the operation is for projects.setCommonInstanceMetadata, this field will contain information on all underlying zonal actions and their state. + * [Output Only] If the operation is for projects.setCommonInstanceMetadata, + * this field will contain information on all underlying zonal actions and + * their state. * * Generated from protobuf field optional .google.cloud.compute.v1.SetCommonInstanceMetadataOperationMetadata set_common_instance_metadata_operation_metadata = 490378980; * @param \Google\Cloud\Compute\V1\SetCommonInstanceMetadataOperationMetadata $var @@ -879,7 +1001,9 @@ public function setSetCommonInstanceMetadataOperationMetadata($var) } /** - * [Output Only] The time that this operation was started by the server. This value is in RFC3339 text format. + * [Output Only] The time that this operation was started by the server. + * This value is inRFC3339 + * text format. * * Generated from protobuf field optional string start_time = 37467274; * @return string @@ -900,7 +1024,9 @@ public function clearStartTime() } /** - * [Output Only] The time that this operation was started by the server. This value is in RFC3339 text format. + * [Output Only] The time that this operation was started by the server. + * This value is inRFC3339 + * text format. * * Generated from protobuf field optional string start_time = 37467274; * @param string $var @@ -915,7 +1041,9 @@ public function setStartTime($var) } /** - * [Output Only] The status of the operation, which can be one of the following: `PENDING`, `RUNNING`, or `DONE`. + * [Output Only] The status of the operation, which can be one of the + * following: + * `PENDING`, `RUNNING`, or `DONE`. * * Generated from protobuf field optional .google.cloud.compute.v1.Operation.Status status = 181260274 [(.google.cloud.operation_field) = STATUS]; * @return int @@ -936,7 +1064,9 @@ public function clearStatus() } /** - * [Output Only] The status of the operation, which can be one of the following: `PENDING`, `RUNNING`, or `DONE`. + * [Output Only] The status of the operation, which can be one of the + * following: + * `PENDING`, `RUNNING`, or `DONE`. * * Generated from protobuf field optional .google.cloud.compute.v1.Operation.Status status = 181260274 [(.google.cloud.operation_field) = STATUS]; * @param int $var @@ -951,7 +1081,8 @@ public function setStatus($var) } /** - * [Output Only] An optional textual description of the current status of the operation. + * [Output Only] An optional textual description of the current status of the + * operation. * * Generated from protobuf field optional string status_message = 297428154; * @return string @@ -972,7 +1103,8 @@ public function clearStatusMessage() } /** - * [Output Only] An optional textual description of the current status of the operation. + * [Output Only] An optional textual description of the current status of the + * operation. * * Generated from protobuf field optional string status_message = 297428154; * @param string $var @@ -987,7 +1119,8 @@ public function setStatusMessage($var) } /** - * [Output Only] The unique target ID, which identifies a specific incarnation of the target resource. + * [Output Only] The unique target ID, which identifies a specific incarnation + * of the target resource. * * Generated from protobuf field optional uint64 target_id = 258165385; * @return int|string @@ -1008,7 +1141,8 @@ public function clearTargetId() } /** - * [Output Only] The unique target ID, which identifies a specific incarnation of the target resource. + * [Output Only] The unique target ID, which identifies a specific incarnation + * of the target resource. * * Generated from protobuf field optional uint64 target_id = 258165385; * @param int|string $var @@ -1023,7 +1157,9 @@ public function setTargetId($var) } /** - * [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the disk that the snapshot was created from. + * [Output Only] The URL of the resource that the operation modifies. For + * operations related to creating a snapshot, this points to the disk + * that the snapshot was created from. * * Generated from protobuf field optional string target_link = 62671336; * @return string @@ -1044,7 +1180,9 @@ public function clearTargetLink() } /** - * [Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the disk that the snapshot was created from. + * [Output Only] The URL of the resource that the operation modifies. For + * operations related to creating a snapshot, this points to the disk + * that the snapshot was created from. * * Generated from protobuf field optional string target_link = 62671336; * @param string $var @@ -1059,7 +1197,9 @@ public function setTargetLink($var) } /** - * [Output Only] User who requested the operation, for example: `user@example.com` or `alice_smith_identifier (global/workforcePools/example-com-us-employees)`. + * [Output Only] User who requested the operation, for example: + * `user@example.com` or + * `alice_smith_identifier (global/workforcePools/example-com-us-employees)`. * * Generated from protobuf field optional string user = 3599307; * @return string @@ -1080,7 +1220,9 @@ public function clearUser() } /** - * [Output Only] User who requested the operation, for example: `user@example.com` or `alice_smith_identifier (global/workforcePools/example-com-us-employees)`. + * [Output Only] User who requested the operation, for example: + * `user@example.com` or + * `alice_smith_identifier (global/workforcePools/example-com-us-employees)`. * * Generated from protobuf field optional string user = 3599307; * @param string $var @@ -1095,7 +1237,8 @@ public function setUser($var) } /** - * [Output Only] If warning messages are generated during processing of the operation, this field will be populated. + * [Output Only] If warning messages are generated during processing of the + * operation, this field will be populated. * * Generated from protobuf field repeated .google.cloud.compute.v1.Warnings warnings = 498091095; * @return \Google\Protobuf\Internal\RepeatedField @@ -1106,7 +1249,8 @@ public function getWarnings() } /** - * [Output Only] If warning messages are generated during processing of the operation, this field will be populated. + * [Output Only] If warning messages are generated during processing of the + * operation, this field will be populated. * * Generated from protobuf field repeated .google.cloud.compute.v1.Warnings warnings = 498091095; * @param array<\Google\Cloud\Compute\V1\Warnings>|\Google\Protobuf\Internal\RepeatedField $var @@ -1121,7 +1265,8 @@ public function setWarnings($var) } /** - * [Output Only] The URL of the zone where the operation resides. Only applicable when performing per-zone operations. + * [Output Only] The URL of the zone where the operation resides. Only + * applicable when performing per-zone operations. * * Generated from protobuf field optional string zone = 3744684; * @return string @@ -1142,7 +1287,8 @@ public function clearZone() } /** - * [Output Only] The URL of the zone where the operation resides. Only applicable when performing per-zone operations. + * [Output Only] The URL of the zone where the operation resides. Only + * applicable when performing per-zone operations. * * Generated from protobuf field optional string zone = 3744684; * @param string $var diff --git a/Compute/src/V1/Operation/Status.php b/Compute/src/V1/Operation/Status.php index 6426ae4fea9d..d69df8da0477 100644 --- a/Compute/src/V1/Operation/Status.php +++ b/Compute/src/V1/Operation/Status.php @@ -7,7 +7,9 @@ use UnexpectedValueException; /** - * [Output Only] The status of the operation, which can be one of the following: `PENDING`, `RUNNING`, or `DONE`. + * [Output Only] The status of the operation, which can be one of the + * following: + * `PENDING`, `RUNNING`, or `DONE`. * * Protobuf type google.cloud.compute.v1.Operation.Status */ diff --git a/Compute/src/V1/OperationAggregatedList.php b/Compute/src/V1/OperationAggregatedList.php index b8d11d96277f..7cbeac46c9de 100644 --- a/Compute/src/V1/OperationAggregatedList.php +++ b/Compute/src/V1/OperationAggregatedList.php @@ -15,7 +15,8 @@ class OperationAggregatedList extends \Google\Protobuf\Internal\Message { /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional string id = 3355; */ @@ -27,13 +28,19 @@ class OperationAggregatedList extends \Google\Protobuf\Internal\Message */ private $items; /** - * [Output Only] Type of resource. Always `compute#operationAggregatedList` for aggregated lists of operations. + * [Output Only] Type of resource. Always `compute#operationAggregatedList` + * for aggregated lists of operations. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than `maxResults`, use the `nextPageToken` as a value for the query parameter `pageToken` in the next list request. Subsequent list requests will have their own `nextPageToken` to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger than + * `maxResults`, use the `nextPageToken` as a value for + * the query parameter `pageToken` in the next list request. + * Subsequent list requests will have their own `nextPageToken` to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -64,13 +71,20 @@ class OperationAggregatedList extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $id - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * @type array|\Google\Protobuf\Internal\MapField $items * [Output Only] A map of scoped operation lists. * @type string $kind - * [Output Only] Type of resource. Always `compute#operationAggregatedList` for aggregated lists of operations. + * [Output Only] Type of resource. Always `compute#operationAggregatedList` + * for aggregated lists of operations. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than `maxResults`, use the `nextPageToken` as a value for the query parameter `pageToken` in the next list request. Subsequent list requests will have their own `nextPageToken` to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger than + * `maxResults`, use the `nextPageToken` as a value for + * the query parameter `pageToken` in the next list request. + * Subsequent list requests will have their own `nextPageToken` to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type array|\Google\Protobuf\Internal\RepeatedField $unreachables @@ -85,7 +99,8 @@ public function __construct($data = NULL) { } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional string id = 3355; * @return string @@ -106,7 +121,8 @@ public function clearId() } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional string id = 3355; * @param string $var @@ -147,7 +163,8 @@ public function setItems($var) } /** - * [Output Only] Type of resource. Always `compute#operationAggregatedList` for aggregated lists of operations. + * [Output Only] Type of resource. Always `compute#operationAggregatedList` + * for aggregated lists of operations. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -168,7 +185,8 @@ public function clearKind() } /** - * [Output Only] Type of resource. Always `compute#operationAggregatedList` for aggregated lists of operations. + * [Output Only] Type of resource. Always `compute#operationAggregatedList` + * for aggregated lists of operations. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -183,7 +201,12 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than `maxResults`, use the `nextPageToken` as a value for the query parameter `pageToken` in the next list request. Subsequent list requests will have their own `nextPageToken` to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger than + * `maxResults`, use the `nextPageToken` as a value for + * the query parameter `pageToken` in the next list request. + * Subsequent list requests will have their own `nextPageToken` to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -204,7 +227,12 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than `maxResults`, use the `nextPageToken` as a value for the query parameter `pageToken` in the next list request. Subsequent list requests will have their own `nextPageToken` to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger than + * `maxResults`, use the `nextPageToken` as a value for + * the query parameter `pageToken` in the next list request. + * Subsequent list requests will have their own `nextPageToken` to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/OperationList.php b/Compute/src/V1/OperationList.php index 6cdbe3aaed6e..4e6b1b077f64 100644 --- a/Compute/src/V1/OperationList.php +++ b/Compute/src/V1/OperationList.php @@ -16,7 +16,8 @@ class OperationList extends \Google\Protobuf\Internal\Message { /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional string id = 3355; */ @@ -28,13 +29,19 @@ class OperationList extends \Google\Protobuf\Internal\Message */ private $items; /** - * [Output Only] Type of resource. Always `compute#operations` for Operations resource. + * [Output Only] Type of resource. Always `compute#operations` for Operations + * resource. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than `maxResults`, use the `nextPageToken` as a value for the query parameter `pageToken` in the next list request. Subsequent list requests will have their own `nextPageToken` to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger than + * `maxResults`, use the `nextPageToken` as a value for + * the query parameter `pageToken` in the next list request. + * Subsequent list requests will have their own `nextPageToken` to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -59,13 +66,20 @@ class OperationList extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $id - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * @type array<\Google\Cloud\Compute\V1\Operation>|\Google\Protobuf\Internal\RepeatedField $items * [Output Only] A list of Operation resources. * @type string $kind - * [Output Only] Type of resource. Always `compute#operations` for Operations resource. + * [Output Only] Type of resource. Always `compute#operations` for Operations + * resource. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than `maxResults`, use the `nextPageToken` as a value for the query parameter `pageToken` in the next list request. Subsequent list requests will have their own `nextPageToken` to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger than + * `maxResults`, use the `nextPageToken` as a value for + * the query parameter `pageToken` in the next list request. + * Subsequent list requests will have their own `nextPageToken` to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type \Google\Cloud\Compute\V1\Warning $warning @@ -78,7 +92,8 @@ public function __construct($data = NULL) { } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional string id = 3355; * @return string @@ -99,7 +114,8 @@ public function clearId() } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional string id = 3355; * @param string $var @@ -140,7 +156,8 @@ public function setItems($var) } /** - * [Output Only] Type of resource. Always `compute#operations` for Operations resource. + * [Output Only] Type of resource. Always `compute#operations` for Operations + * resource. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -161,7 +178,8 @@ public function clearKind() } /** - * [Output Only] Type of resource. Always `compute#operations` for Operations resource. + * [Output Only] Type of resource. Always `compute#operations` for Operations + * resource. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -176,7 +194,12 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than `maxResults`, use the `nextPageToken` as a value for the query parameter `pageToken` in the next list request. Subsequent list requests will have their own `nextPageToken` to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger than + * `maxResults`, use the `nextPageToken` as a value for + * the query parameter `pageToken` in the next list request. + * Subsequent list requests will have their own `nextPageToken` to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -197,7 +220,12 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than `maxResults`, use the `nextPageToken` as a value for the query parameter `pageToken` in the next list request. Subsequent list requests will have their own `nextPageToken` to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger than + * `maxResults`, use the `nextPageToken` as a value for + * the query parameter `pageToken` in the next list request. + * Subsequent list requests will have their own `nextPageToken` to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/OperationsScopedList.php b/Compute/src/V1/OperationsScopedList.php index 4b6756432425..0bbd9b4d4f53 100644 --- a/Compute/src/V1/OperationsScopedList.php +++ b/Compute/src/V1/OperationsScopedList.php @@ -21,7 +21,8 @@ class OperationsScopedList extends \Google\Protobuf\Internal\Message */ private $operations; /** - * [Output Only] Informational warning which replaces the list of operations when the list is empty. + * [Output Only] Informational warning which replaces the list of operations + * when the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; */ @@ -36,7 +37,8 @@ class OperationsScopedList extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\Operation>|\Google\Protobuf\Internal\RepeatedField $operations * [Output Only] A list of operations contained in this scope. * @type \Google\Cloud\Compute\V1\Warning $warning - * [Output Only] Informational warning which replaces the list of operations when the list is empty. + * [Output Only] Informational warning which replaces the list of operations + * when the list is empty. * } */ public function __construct($data = NULL) { @@ -71,7 +73,8 @@ public function setOperations($var) } /** - * [Output Only] Informational warning which replaces the list of operations when the list is empty. + * [Output Only] Informational warning which replaces the list of operations + * when the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; * @return \Google\Cloud\Compute\V1\Warning|null @@ -92,7 +95,8 @@ public function clearWarning() } /** - * [Output Only] Informational warning which replaces the list of operations when the list is empty. + * [Output Only] Informational warning which replaces the list of operations + * when the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; * @param \Google\Cloud\Compute\V1\Warning $var diff --git a/Compute/src/V1/OrganizationSecurityPoliciesListAssociationsResponse.php b/Compute/src/V1/OrganizationSecurityPoliciesListAssociationsResponse.php index 50ddd5bfaeae..b333dad87f7e 100644 --- a/Compute/src/V1/OrganizationSecurityPoliciesListAssociationsResponse.php +++ b/Compute/src/V1/OrganizationSecurityPoliciesListAssociationsResponse.php @@ -21,7 +21,8 @@ class OrganizationSecurityPoliciesListAssociationsResponse extends \Google\Proto */ private $associations; /** - * [Output Only] Type of securityPolicy associations. Always compute#organizationSecurityPoliciesListAssociations for lists of securityPolicy associations. + * [Output Only] Type of securityPolicy associations. Alwayscompute#organizationSecurityPoliciesListAssociations for lists + * of securityPolicy associations. * * Generated from protobuf field optional string kind = 3292052; */ @@ -36,7 +37,8 @@ class OrganizationSecurityPoliciesListAssociationsResponse extends \Google\Proto * @type array<\Google\Cloud\Compute\V1\SecurityPolicyAssociation>|\Google\Protobuf\Internal\RepeatedField $associations * A list of associations. * @type string $kind - * [Output Only] Type of securityPolicy associations. Always compute#organizationSecurityPoliciesListAssociations for lists of securityPolicy associations. + * [Output Only] Type of securityPolicy associations. Alwayscompute#organizationSecurityPoliciesListAssociations for lists + * of securityPolicy associations. * } */ public function __construct($data = NULL) { @@ -71,7 +73,8 @@ public function setAssociations($var) } /** - * [Output Only] Type of securityPolicy associations. Always compute#organizationSecurityPoliciesListAssociations for lists of securityPolicy associations. + * [Output Only] Type of securityPolicy associations. Alwayscompute#organizationSecurityPoliciesListAssociations for lists + * of securityPolicy associations. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -92,7 +95,8 @@ public function clearKind() } /** - * [Output Only] Type of securityPolicy associations. Always compute#organizationSecurityPoliciesListAssociations for lists of securityPolicy associations. + * [Output Only] Type of securityPolicy associations. Alwayscompute#organizationSecurityPoliciesListAssociations for lists + * of securityPolicy associations. * * Generated from protobuf field optional string kind = 3292052; * @param string $var diff --git a/Compute/src/V1/OutlierDetection.php b/Compute/src/V1/OutlierDetection.php index d91a5b4cdbf5..ea968fb32660 100644 --- a/Compute/src/V1/OutlierDetection.php +++ b/Compute/src/V1/OutlierDetection.php @@ -9,74 +9,114 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Settings controlling the eviction of unhealthy hosts from the load balancing pool for the backend service. + * Settings controlling the eviction of unhealthy hosts from the load balancing + * pool for the backend service. * * Generated from protobuf message google.cloud.compute.v1.OutlierDetection */ class OutlierDetection extends \Google\Protobuf\Internal\Message { /** - * The base time that a backend endpoint is ejected for. Defaults to 30000ms or 30s. After a backend endpoint is returned back to the load balancing pool, it can be ejected again in another ejection analysis. Thus, the total ejection time is equal to the base ejection time multiplied by the number of times the backend endpoint has been ejected. Defaults to 30000ms or 30s. + * The base time that a backend endpoint is ejected for. Defaults to 30000ms + * or 30s. + * After a backend endpoint is returned back to the load balancing pool, it + * can be ejected again in another ejection analysis. Thus, the total ejection + * time is equal to the base ejection time multiplied by the number of times + * the backend endpoint has been ejected. Defaults to 30000ms or 30s. * * Generated from protobuf field optional .google.cloud.compute.v1.Duration base_ejection_time = 80997255; */ protected $base_ejection_time = null; /** - * Number of consecutive errors before a backend endpoint is ejected from the load balancing pool. When the backend endpoint is accessed over HTTP, a 5xx return code qualifies as an error. Defaults to 5. + * Number of consecutive errors before a backend endpoint is ejected from the + * load balancing pool. When the backend endpoint is accessed over HTTP, a 5xx + * return code qualifies as an error. Defaults to 5. * * Generated from protobuf field optional int32 consecutive_errors = 387193248; */ protected $consecutive_errors = null; /** - * The number of consecutive gateway failures (502, 503, 504 status or connection errors that are mapped to one of those status codes) before a consecutive gateway failure ejection occurs. Defaults to 3. + * The number of consecutive gateway failures (502, 503, 504 status or + * connection errors that are mapped to one of those status codes) before a + * consecutive gateway failure ejection occurs. Defaults to 3. * * Generated from protobuf field optional int32 consecutive_gateway_failure = 417504250; */ protected $consecutive_gateway_failure = null; /** - * The percentage chance that a backend endpoint will be ejected when an outlier status is detected through consecutive 5xx. This setting can be used to disable ejection or to ramp it up slowly. Defaults to 0. + * The percentage chance that a backend endpoint will be ejected when an + * outlier status is detected through consecutive 5xx. This setting can be + * used to disable ejection or to ramp it up slowly. Defaults to 0. * * Generated from protobuf field optional int32 enforcing_consecutive_errors = 213133760; */ protected $enforcing_consecutive_errors = null; /** - * The percentage chance that a backend endpoint will be ejected when an outlier status is detected through consecutive gateway failures. This setting can be used to disable ejection or to ramp it up slowly. Defaults to 100. + * The percentage chance that a backend endpoint will be ejected when an + * outlier status is detected through consecutive gateway failures. This + * setting can be used to disable ejection or to ramp it up slowly. Defaults + * to 100. * * Generated from protobuf field optional int32 enforcing_consecutive_gateway_failure = 394440666; */ protected $enforcing_consecutive_gateway_failure = null; /** - * The percentage chance that a backend endpoint will be ejected when an outlier status is detected through success rate statistics. This setting can be used to disable ejection or to ramp it up slowly. Defaults to 100. Not supported when the backend service uses Serverless NEG. + * The percentage chance that a backend endpoint will be ejected when an + * outlier status is detected through success rate statistics. This setting + * can be used to disable ejection or to ramp it up slowly. Defaults to 100. + * Not supported when the backend service uses Serverless NEG. * * Generated from protobuf field optional int32 enforcing_success_rate = 194508732; */ protected $enforcing_success_rate = null; /** - * Time interval between ejection analysis sweeps. This can result in both new ejections and backend endpoints being returned to service. The interval is equal to the number of seconds as defined in outlierDetection.interval.seconds plus the number of nanoseconds as defined in outlierDetection.interval.nanos. Defaults to 1 second. + * Time interval between ejection analysis sweeps. This can result in both new + * ejections and backend endpoints being returned to service. The interval is + * equal to the number of seconds as defined in + * outlierDetection.interval.seconds plus the number of nanoseconds as defined + * in outlierDetection.interval.nanos. Defaults to 1 second. * * Generated from protobuf field optional .google.cloud.compute.v1.Duration interval = 33547461; */ protected $interval = null; /** - * Maximum percentage of backend endpoints in the load balancing pool for the backend service that can be ejected if the ejection conditions are met. Defaults to 50%. + * Maximum percentage of backend endpoints in the load balancing pool for the + * backend service that can be ejected if the ejection conditions are met. + * Defaults to 50%. * * Generated from protobuf field optional int32 max_ejection_percent = 18436888; */ protected $max_ejection_percent = null; /** - * The number of backend endpoints in the load balancing pool that must have enough request volume to detect success rate outliers. If the number of backend endpoints is fewer than this setting, outlier detection via success rate statistics is not performed for any backend endpoint in the load balancing pool. Defaults to 5. Not supported when the backend service uses Serverless NEG. + * The number of backend endpoints in the load balancing pool that must have + * enough request volume to detect success rate outliers. If the number of + * backend endpoints is fewer than this setting, outlier detection via success + * rate statistics is not performed for any backend endpoint in the load + * balancing pool. Defaults to 5. + * Not supported when the backend service uses Serverless NEG. * * Generated from protobuf field optional int32 success_rate_minimum_hosts = 525766903; */ protected $success_rate_minimum_hosts = null; /** - * The minimum number of total requests that must be collected in one interval (as defined by the interval duration above) to include this backend endpoint in success rate based outlier detection. If the volume is lower than this setting, outlier detection via success rate statistics is not performed for that backend endpoint. Defaults to 100. Not supported when the backend service uses Serverless NEG. + * The minimum number of total requests that must be collected in one interval + * (as defined by the interval duration above) to include this backend + * endpoint in success rate based outlier detection. If the volume is lower + * than this setting, outlier detection via success rate statistics is not + * performed for that backend endpoint. Defaults to 100. + * Not supported when the backend service uses Serverless NEG. * * Generated from protobuf field optional int32 success_rate_request_volume = 281425357; */ protected $success_rate_request_volume = null; /** - * This factor is used to determine the ejection threshold for success rate outlier ejection. The ejection threshold is the difference between the mean success rate, and the product of this factor and the standard deviation of the mean success rate: mean - (stdev * successRateStdevFactor). This factor is divided by a thousand to get a double. That is, if the desired factor is 1.9, the runtime value should be 1900. Defaults to 1900. Not supported when the backend service uses Serverless NEG. + * This factor is used to determine the ejection threshold for success rate + * outlier ejection. The ejection threshold is the difference between the mean + * success rate, and the product of this factor and the standard deviation of + * the mean success rate: mean - (stdev * successRateStdevFactor). This factor + * is divided by a thousand to get a double. That is, if the desired factor + * is 1.9, the runtime value should be 1900. Defaults to 1900. + * Not supported when the backend service uses Serverless NEG. * * Generated from protobuf field optional int32 success_rate_stdev_factor = 174735773; */ @@ -89,27 +129,66 @@ class OutlierDetection extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type \Google\Cloud\Compute\V1\Duration $base_ejection_time - * The base time that a backend endpoint is ejected for. Defaults to 30000ms or 30s. After a backend endpoint is returned back to the load balancing pool, it can be ejected again in another ejection analysis. Thus, the total ejection time is equal to the base ejection time multiplied by the number of times the backend endpoint has been ejected. Defaults to 30000ms or 30s. + * The base time that a backend endpoint is ejected for. Defaults to 30000ms + * or 30s. + * After a backend endpoint is returned back to the load balancing pool, it + * can be ejected again in another ejection analysis. Thus, the total ejection + * time is equal to the base ejection time multiplied by the number of times + * the backend endpoint has been ejected. Defaults to 30000ms or 30s. * @type int $consecutive_errors - * Number of consecutive errors before a backend endpoint is ejected from the load balancing pool. When the backend endpoint is accessed over HTTP, a 5xx return code qualifies as an error. Defaults to 5. + * Number of consecutive errors before a backend endpoint is ejected from the + * load balancing pool. When the backend endpoint is accessed over HTTP, a 5xx + * return code qualifies as an error. Defaults to 5. * @type int $consecutive_gateway_failure - * The number of consecutive gateway failures (502, 503, 504 status or connection errors that are mapped to one of those status codes) before a consecutive gateway failure ejection occurs. Defaults to 3. + * The number of consecutive gateway failures (502, 503, 504 status or + * connection errors that are mapped to one of those status codes) before a + * consecutive gateway failure ejection occurs. Defaults to 3. * @type int $enforcing_consecutive_errors - * The percentage chance that a backend endpoint will be ejected when an outlier status is detected through consecutive 5xx. This setting can be used to disable ejection or to ramp it up slowly. Defaults to 0. + * The percentage chance that a backend endpoint will be ejected when an + * outlier status is detected through consecutive 5xx. This setting can be + * used to disable ejection or to ramp it up slowly. Defaults to 0. * @type int $enforcing_consecutive_gateway_failure - * The percentage chance that a backend endpoint will be ejected when an outlier status is detected through consecutive gateway failures. This setting can be used to disable ejection or to ramp it up slowly. Defaults to 100. + * The percentage chance that a backend endpoint will be ejected when an + * outlier status is detected through consecutive gateway failures. This + * setting can be used to disable ejection or to ramp it up slowly. Defaults + * to 100. * @type int $enforcing_success_rate - * The percentage chance that a backend endpoint will be ejected when an outlier status is detected through success rate statistics. This setting can be used to disable ejection or to ramp it up slowly. Defaults to 100. Not supported when the backend service uses Serverless NEG. + * The percentage chance that a backend endpoint will be ejected when an + * outlier status is detected through success rate statistics. This setting + * can be used to disable ejection or to ramp it up slowly. Defaults to 100. + * Not supported when the backend service uses Serverless NEG. * @type \Google\Cloud\Compute\V1\Duration $interval - * Time interval between ejection analysis sweeps. This can result in both new ejections and backend endpoints being returned to service. The interval is equal to the number of seconds as defined in outlierDetection.interval.seconds plus the number of nanoseconds as defined in outlierDetection.interval.nanos. Defaults to 1 second. + * Time interval between ejection analysis sweeps. This can result in both new + * ejections and backend endpoints being returned to service. The interval is + * equal to the number of seconds as defined in + * outlierDetection.interval.seconds plus the number of nanoseconds as defined + * in outlierDetection.interval.nanos. Defaults to 1 second. * @type int $max_ejection_percent - * Maximum percentage of backend endpoints in the load balancing pool for the backend service that can be ejected if the ejection conditions are met. Defaults to 50%. + * Maximum percentage of backend endpoints in the load balancing pool for the + * backend service that can be ejected if the ejection conditions are met. + * Defaults to 50%. * @type int $success_rate_minimum_hosts - * The number of backend endpoints in the load balancing pool that must have enough request volume to detect success rate outliers. If the number of backend endpoints is fewer than this setting, outlier detection via success rate statistics is not performed for any backend endpoint in the load balancing pool. Defaults to 5. Not supported when the backend service uses Serverless NEG. + * The number of backend endpoints in the load balancing pool that must have + * enough request volume to detect success rate outliers. If the number of + * backend endpoints is fewer than this setting, outlier detection via success + * rate statistics is not performed for any backend endpoint in the load + * balancing pool. Defaults to 5. + * Not supported when the backend service uses Serverless NEG. * @type int $success_rate_request_volume - * The minimum number of total requests that must be collected in one interval (as defined by the interval duration above) to include this backend endpoint in success rate based outlier detection. If the volume is lower than this setting, outlier detection via success rate statistics is not performed for that backend endpoint. Defaults to 100. Not supported when the backend service uses Serverless NEG. + * The minimum number of total requests that must be collected in one interval + * (as defined by the interval duration above) to include this backend + * endpoint in success rate based outlier detection. If the volume is lower + * than this setting, outlier detection via success rate statistics is not + * performed for that backend endpoint. Defaults to 100. + * Not supported when the backend service uses Serverless NEG. * @type int $success_rate_stdev_factor - * This factor is used to determine the ejection threshold for success rate outlier ejection. The ejection threshold is the difference between the mean success rate, and the product of this factor and the standard deviation of the mean success rate: mean - (stdev * successRateStdevFactor). This factor is divided by a thousand to get a double. That is, if the desired factor is 1.9, the runtime value should be 1900. Defaults to 1900. Not supported when the backend service uses Serverless NEG. + * This factor is used to determine the ejection threshold for success rate + * outlier ejection. The ejection threshold is the difference between the mean + * success rate, and the product of this factor and the standard deviation of + * the mean success rate: mean - (stdev * successRateStdevFactor). This factor + * is divided by a thousand to get a double. That is, if the desired factor + * is 1.9, the runtime value should be 1900. Defaults to 1900. + * Not supported when the backend service uses Serverless NEG. * } */ public function __construct($data = NULL) { @@ -118,7 +197,12 @@ public function __construct($data = NULL) { } /** - * The base time that a backend endpoint is ejected for. Defaults to 30000ms or 30s. After a backend endpoint is returned back to the load balancing pool, it can be ejected again in another ejection analysis. Thus, the total ejection time is equal to the base ejection time multiplied by the number of times the backend endpoint has been ejected. Defaults to 30000ms or 30s. + * The base time that a backend endpoint is ejected for. Defaults to 30000ms + * or 30s. + * After a backend endpoint is returned back to the load balancing pool, it + * can be ejected again in another ejection analysis. Thus, the total ejection + * time is equal to the base ejection time multiplied by the number of times + * the backend endpoint has been ejected. Defaults to 30000ms or 30s. * * Generated from protobuf field optional .google.cloud.compute.v1.Duration base_ejection_time = 80997255; * @return \Google\Cloud\Compute\V1\Duration|null @@ -139,7 +223,12 @@ public function clearBaseEjectionTime() } /** - * The base time that a backend endpoint is ejected for. Defaults to 30000ms or 30s. After a backend endpoint is returned back to the load balancing pool, it can be ejected again in another ejection analysis. Thus, the total ejection time is equal to the base ejection time multiplied by the number of times the backend endpoint has been ejected. Defaults to 30000ms or 30s. + * The base time that a backend endpoint is ejected for. Defaults to 30000ms + * or 30s. + * After a backend endpoint is returned back to the load balancing pool, it + * can be ejected again in another ejection analysis. Thus, the total ejection + * time is equal to the base ejection time multiplied by the number of times + * the backend endpoint has been ejected. Defaults to 30000ms or 30s. * * Generated from protobuf field optional .google.cloud.compute.v1.Duration base_ejection_time = 80997255; * @param \Google\Cloud\Compute\V1\Duration $var @@ -154,7 +243,9 @@ public function setBaseEjectionTime($var) } /** - * Number of consecutive errors before a backend endpoint is ejected from the load balancing pool. When the backend endpoint is accessed over HTTP, a 5xx return code qualifies as an error. Defaults to 5. + * Number of consecutive errors before a backend endpoint is ejected from the + * load balancing pool. When the backend endpoint is accessed over HTTP, a 5xx + * return code qualifies as an error. Defaults to 5. * * Generated from protobuf field optional int32 consecutive_errors = 387193248; * @return int @@ -175,7 +266,9 @@ public function clearConsecutiveErrors() } /** - * Number of consecutive errors before a backend endpoint is ejected from the load balancing pool. When the backend endpoint is accessed over HTTP, a 5xx return code qualifies as an error. Defaults to 5. + * Number of consecutive errors before a backend endpoint is ejected from the + * load balancing pool. When the backend endpoint is accessed over HTTP, a 5xx + * return code qualifies as an error. Defaults to 5. * * Generated from protobuf field optional int32 consecutive_errors = 387193248; * @param int $var @@ -190,7 +283,9 @@ public function setConsecutiveErrors($var) } /** - * The number of consecutive gateway failures (502, 503, 504 status or connection errors that are mapped to one of those status codes) before a consecutive gateway failure ejection occurs. Defaults to 3. + * The number of consecutive gateway failures (502, 503, 504 status or + * connection errors that are mapped to one of those status codes) before a + * consecutive gateway failure ejection occurs. Defaults to 3. * * Generated from protobuf field optional int32 consecutive_gateway_failure = 417504250; * @return int @@ -211,7 +306,9 @@ public function clearConsecutiveGatewayFailure() } /** - * The number of consecutive gateway failures (502, 503, 504 status or connection errors that are mapped to one of those status codes) before a consecutive gateway failure ejection occurs. Defaults to 3. + * The number of consecutive gateway failures (502, 503, 504 status or + * connection errors that are mapped to one of those status codes) before a + * consecutive gateway failure ejection occurs. Defaults to 3. * * Generated from protobuf field optional int32 consecutive_gateway_failure = 417504250; * @param int $var @@ -226,7 +323,9 @@ public function setConsecutiveGatewayFailure($var) } /** - * The percentage chance that a backend endpoint will be ejected when an outlier status is detected through consecutive 5xx. This setting can be used to disable ejection or to ramp it up slowly. Defaults to 0. + * The percentage chance that a backend endpoint will be ejected when an + * outlier status is detected through consecutive 5xx. This setting can be + * used to disable ejection or to ramp it up slowly. Defaults to 0. * * Generated from protobuf field optional int32 enforcing_consecutive_errors = 213133760; * @return int @@ -247,7 +346,9 @@ public function clearEnforcingConsecutiveErrors() } /** - * The percentage chance that a backend endpoint will be ejected when an outlier status is detected through consecutive 5xx. This setting can be used to disable ejection or to ramp it up slowly. Defaults to 0. + * The percentage chance that a backend endpoint will be ejected when an + * outlier status is detected through consecutive 5xx. This setting can be + * used to disable ejection or to ramp it up slowly. Defaults to 0. * * Generated from protobuf field optional int32 enforcing_consecutive_errors = 213133760; * @param int $var @@ -262,7 +363,10 @@ public function setEnforcingConsecutiveErrors($var) } /** - * The percentage chance that a backend endpoint will be ejected when an outlier status is detected through consecutive gateway failures. This setting can be used to disable ejection or to ramp it up slowly. Defaults to 100. + * The percentage chance that a backend endpoint will be ejected when an + * outlier status is detected through consecutive gateway failures. This + * setting can be used to disable ejection or to ramp it up slowly. Defaults + * to 100. * * Generated from protobuf field optional int32 enforcing_consecutive_gateway_failure = 394440666; * @return int @@ -283,7 +387,10 @@ public function clearEnforcingConsecutiveGatewayFailure() } /** - * The percentage chance that a backend endpoint will be ejected when an outlier status is detected through consecutive gateway failures. This setting can be used to disable ejection or to ramp it up slowly. Defaults to 100. + * The percentage chance that a backend endpoint will be ejected when an + * outlier status is detected through consecutive gateway failures. This + * setting can be used to disable ejection or to ramp it up slowly. Defaults + * to 100. * * Generated from protobuf field optional int32 enforcing_consecutive_gateway_failure = 394440666; * @param int $var @@ -298,7 +405,10 @@ public function setEnforcingConsecutiveGatewayFailure($var) } /** - * The percentage chance that a backend endpoint will be ejected when an outlier status is detected through success rate statistics. This setting can be used to disable ejection or to ramp it up slowly. Defaults to 100. Not supported when the backend service uses Serverless NEG. + * The percentage chance that a backend endpoint will be ejected when an + * outlier status is detected through success rate statistics. This setting + * can be used to disable ejection or to ramp it up slowly. Defaults to 100. + * Not supported when the backend service uses Serverless NEG. * * Generated from protobuf field optional int32 enforcing_success_rate = 194508732; * @return int @@ -319,7 +429,10 @@ public function clearEnforcingSuccessRate() } /** - * The percentage chance that a backend endpoint will be ejected when an outlier status is detected through success rate statistics. This setting can be used to disable ejection or to ramp it up slowly. Defaults to 100. Not supported when the backend service uses Serverless NEG. + * The percentage chance that a backend endpoint will be ejected when an + * outlier status is detected through success rate statistics. This setting + * can be used to disable ejection or to ramp it up slowly. Defaults to 100. + * Not supported when the backend service uses Serverless NEG. * * Generated from protobuf field optional int32 enforcing_success_rate = 194508732; * @param int $var @@ -334,7 +447,11 @@ public function setEnforcingSuccessRate($var) } /** - * Time interval between ejection analysis sweeps. This can result in both new ejections and backend endpoints being returned to service. The interval is equal to the number of seconds as defined in outlierDetection.interval.seconds plus the number of nanoseconds as defined in outlierDetection.interval.nanos. Defaults to 1 second. + * Time interval between ejection analysis sweeps. This can result in both new + * ejections and backend endpoints being returned to service. The interval is + * equal to the number of seconds as defined in + * outlierDetection.interval.seconds plus the number of nanoseconds as defined + * in outlierDetection.interval.nanos. Defaults to 1 second. * * Generated from protobuf field optional .google.cloud.compute.v1.Duration interval = 33547461; * @return \Google\Cloud\Compute\V1\Duration|null @@ -355,7 +472,11 @@ public function clearInterval() } /** - * Time interval between ejection analysis sweeps. This can result in both new ejections and backend endpoints being returned to service. The interval is equal to the number of seconds as defined in outlierDetection.interval.seconds plus the number of nanoseconds as defined in outlierDetection.interval.nanos. Defaults to 1 second. + * Time interval between ejection analysis sweeps. This can result in both new + * ejections and backend endpoints being returned to service. The interval is + * equal to the number of seconds as defined in + * outlierDetection.interval.seconds plus the number of nanoseconds as defined + * in outlierDetection.interval.nanos. Defaults to 1 second. * * Generated from protobuf field optional .google.cloud.compute.v1.Duration interval = 33547461; * @param \Google\Cloud\Compute\V1\Duration $var @@ -370,7 +491,9 @@ public function setInterval($var) } /** - * Maximum percentage of backend endpoints in the load balancing pool for the backend service that can be ejected if the ejection conditions are met. Defaults to 50%. + * Maximum percentage of backend endpoints in the load balancing pool for the + * backend service that can be ejected if the ejection conditions are met. + * Defaults to 50%. * * Generated from protobuf field optional int32 max_ejection_percent = 18436888; * @return int @@ -391,7 +514,9 @@ public function clearMaxEjectionPercent() } /** - * Maximum percentage of backend endpoints in the load balancing pool for the backend service that can be ejected if the ejection conditions are met. Defaults to 50%. + * Maximum percentage of backend endpoints in the load balancing pool for the + * backend service that can be ejected if the ejection conditions are met. + * Defaults to 50%. * * Generated from protobuf field optional int32 max_ejection_percent = 18436888; * @param int $var @@ -406,7 +531,12 @@ public function setMaxEjectionPercent($var) } /** - * The number of backend endpoints in the load balancing pool that must have enough request volume to detect success rate outliers. If the number of backend endpoints is fewer than this setting, outlier detection via success rate statistics is not performed for any backend endpoint in the load balancing pool. Defaults to 5. Not supported when the backend service uses Serverless NEG. + * The number of backend endpoints in the load balancing pool that must have + * enough request volume to detect success rate outliers. If the number of + * backend endpoints is fewer than this setting, outlier detection via success + * rate statistics is not performed for any backend endpoint in the load + * balancing pool. Defaults to 5. + * Not supported when the backend service uses Serverless NEG. * * Generated from protobuf field optional int32 success_rate_minimum_hosts = 525766903; * @return int @@ -427,7 +557,12 @@ public function clearSuccessRateMinimumHosts() } /** - * The number of backend endpoints in the load balancing pool that must have enough request volume to detect success rate outliers. If the number of backend endpoints is fewer than this setting, outlier detection via success rate statistics is not performed for any backend endpoint in the load balancing pool. Defaults to 5. Not supported when the backend service uses Serverless NEG. + * The number of backend endpoints in the load balancing pool that must have + * enough request volume to detect success rate outliers. If the number of + * backend endpoints is fewer than this setting, outlier detection via success + * rate statistics is not performed for any backend endpoint in the load + * balancing pool. Defaults to 5. + * Not supported when the backend service uses Serverless NEG. * * Generated from protobuf field optional int32 success_rate_minimum_hosts = 525766903; * @param int $var @@ -442,7 +577,12 @@ public function setSuccessRateMinimumHosts($var) } /** - * The minimum number of total requests that must be collected in one interval (as defined by the interval duration above) to include this backend endpoint in success rate based outlier detection. If the volume is lower than this setting, outlier detection via success rate statistics is not performed for that backend endpoint. Defaults to 100. Not supported when the backend service uses Serverless NEG. + * The minimum number of total requests that must be collected in one interval + * (as defined by the interval duration above) to include this backend + * endpoint in success rate based outlier detection. If the volume is lower + * than this setting, outlier detection via success rate statistics is not + * performed for that backend endpoint. Defaults to 100. + * Not supported when the backend service uses Serverless NEG. * * Generated from protobuf field optional int32 success_rate_request_volume = 281425357; * @return int @@ -463,7 +603,12 @@ public function clearSuccessRateRequestVolume() } /** - * The minimum number of total requests that must be collected in one interval (as defined by the interval duration above) to include this backend endpoint in success rate based outlier detection. If the volume is lower than this setting, outlier detection via success rate statistics is not performed for that backend endpoint. Defaults to 100. Not supported when the backend service uses Serverless NEG. + * The minimum number of total requests that must be collected in one interval + * (as defined by the interval duration above) to include this backend + * endpoint in success rate based outlier detection. If the volume is lower + * than this setting, outlier detection via success rate statistics is not + * performed for that backend endpoint. Defaults to 100. + * Not supported when the backend service uses Serverless NEG. * * Generated from protobuf field optional int32 success_rate_request_volume = 281425357; * @param int $var @@ -478,7 +623,13 @@ public function setSuccessRateRequestVolume($var) } /** - * This factor is used to determine the ejection threshold for success rate outlier ejection. The ejection threshold is the difference between the mean success rate, and the product of this factor and the standard deviation of the mean success rate: mean - (stdev * successRateStdevFactor). This factor is divided by a thousand to get a double. That is, if the desired factor is 1.9, the runtime value should be 1900. Defaults to 1900. Not supported when the backend service uses Serverless NEG. + * This factor is used to determine the ejection threshold for success rate + * outlier ejection. The ejection threshold is the difference between the mean + * success rate, and the product of this factor and the standard deviation of + * the mean success rate: mean - (stdev * successRateStdevFactor). This factor + * is divided by a thousand to get a double. That is, if the desired factor + * is 1.9, the runtime value should be 1900. Defaults to 1900. + * Not supported when the backend service uses Serverless NEG. * * Generated from protobuf field optional int32 success_rate_stdev_factor = 174735773; * @return int @@ -499,7 +650,13 @@ public function clearSuccessRateStdevFactor() } /** - * This factor is used to determine the ejection threshold for success rate outlier ejection. The ejection threshold is the difference between the mean success rate, and the product of this factor and the standard deviation of the mean success rate: mean - (stdev * successRateStdevFactor). This factor is divided by a thousand to get a double. That is, if the desired factor is 1.9, the runtime value should be 1900. Defaults to 1900. Not supported when the backend service uses Serverless NEG. + * This factor is used to determine the ejection threshold for success rate + * outlier ejection. The ejection threshold is the difference between the mean + * success rate, and the product of this factor and the standard deviation of + * the mean success rate: mean - (stdev * successRateStdevFactor). This factor + * is divided by a thousand to get a double. That is, if the desired factor + * is 1.9, the runtime value should be 1900. Defaults to 1900. + * Not supported when the backend service uses Serverless NEG. * * Generated from protobuf field optional int32 success_rate_stdev_factor = 174735773; * @param int $var diff --git a/Compute/src/V1/PacketIntervals/Type.php b/Compute/src/V1/PacketIntervals/Type.php index c9e966f68d64..0dc6231306ed 100644 --- a/Compute/src/V1/PacketIntervals/Type.php +++ b/Compute/src/V1/PacketIntervals/Type.php @@ -20,7 +20,8 @@ class Type */ const UNDEFINED_TYPE = 0; /** - * Only applies to Echo packets. This shows the intervals between sending and receiving the same packet. + * Only applies to Echo packets. This shows the intervals between sending + * and receiving the same packet. * * Generated from protobuf enum LOOPBACK = 356174219; */ diff --git a/Compute/src/V1/PacketMirroring.php b/Compute/src/V1/PacketMirroring.php index c4f4cc52cbce..abe2c56714ce 100644 --- a/Compute/src/V1/PacketMirroring.php +++ b/Compute/src/V1/PacketMirroring.php @@ -9,32 +9,45 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Represents a Packet Mirroring resource. Packet Mirroring clones the traffic of specified instances in your Virtual Private Cloud (VPC) network and forwards it to a collector destination, such as an instance group of an internal TCP/UDP load balancer, for analysis or examination. For more information about setting up Packet Mirroring, see Using Packet Mirroring. + * Represents a Packet Mirroring resource. + * Packet Mirroring clones the traffic of specified instances in your Virtual + * Private Cloud (VPC) network and forwards it to a collector destination, + * such as an instance group of an internal TCP/UDP load balancer, for analysis + * or examination. + * For more information about setting up Packet Mirroring, seeUsing Packet Mirroring. * * Generated from protobuf message google.cloud.compute.v1.PacketMirroring */ class PacketMirroring extends \Google\Protobuf\Internal\Message { /** - * The Forwarding Rule resource of type loadBalancingScheme=INTERNAL that will be used as collector for mirrored traffic. The specified forwarding rule must have isMirroringCollector set to true. + * The Forwarding Rule resource of typeloadBalancingScheme=INTERNAL that will be used as collector + * for mirrored traffic. + * The specified forwarding rule must have isMirroringCollector + * set to true. * * Generated from protobuf field optional .google.cloud.compute.v1.PacketMirroringForwardingRuleInfo collector_ilb = 426607853; */ protected $collector_ilb = null; /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; */ protected $creation_timestamp = null; /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; */ protected $description = null; /** - * Indicates whether or not this packet mirroring takes effect. If set to FALSE, this packet mirroring policy will not be enforced on the network. The default is TRUE. + * Indicates whether or not this packet mirroring takes effect. + * If set to FALSE, this packet mirroring policy will not be enforced on the + * network. + * The default is TRUE. * Check the Enable enum for the list of possible values. * * Generated from protobuf field optional string enable = 311764355; @@ -47,37 +60,52 @@ class PacketMirroring extends \Google\Protobuf\Internal\Message */ protected $filter = null; /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; */ protected $id = null; /** - * [Output Only] Type of the resource. Always compute#packetMirroring for packet mirrorings. + * [Output Only] Type of the resource. Alwayscompute#packetMirroring for packet mirrorings. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * PacketMirroring mirroredResourceInfos. MirroredResourceInfo specifies a set of mirrored VM instances, subnetworks and/or tags for which traffic from/to all VM instances will be mirrored. + * PacketMirroring mirroredResourceInfos. + * MirroredResourceInfo specifies a set of mirrored VM instances, subnetworks + * and/or tags for which traffic from/to all VM instances will be mirrored. * * Generated from protobuf field optional .google.cloud.compute.v1.PacketMirroringMirroredResourceInfo mirrored_resources = 124817348; */ protected $mirrored_resources = null; /** - * Name of the resource; provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource; provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must be + * a dash, lowercase letter, or digit, except the last character, which cannot + * be a dash. * * Generated from protobuf field optional string name = 3373707; */ protected $name = null; /** - * Specifies the mirrored VPC network. Only packets in this network will be mirrored. All mirrored VMs should have a NIC in the given network. All mirrored subnetworks should belong to the given network. + * Specifies the mirrored VPC network. Only packets in this network will be + * mirrored. All mirrored VMs should have a NIC in the given network. + * All mirrored subnetworks should belong to the given network. * * Generated from protobuf field optional .google.cloud.compute.v1.PacketMirroringNetworkInfo network = 232872494; */ protected $network = null; /** - * The priority of applying this configuration. Priority is used to break ties in cases where there is more than one matching rule. In the case of two rules that apply for a given Instance, the one with the lowest-numbered priority value wins. Default value is 1000. Valid range is 0 through 65535. + * The priority of applying this configuration. Priority is used to break ties + * in cases where there is more than one matching rule. In the case of two + * rules that apply for a given Instance, the one with the lowest-numbered + * priority value wins. + * Default value is 1000. Valid range is 0 through 65535. * * Generated from protobuf field optional uint32 priority = 445151652; */ @@ -102,28 +130,51 @@ class PacketMirroring extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type \Google\Cloud\Compute\V1\PacketMirroringForwardingRuleInfo $collector_ilb - * The Forwarding Rule resource of type loadBalancingScheme=INTERNAL that will be used as collector for mirrored traffic. The specified forwarding rule must have isMirroringCollector set to true. + * The Forwarding Rule resource of typeloadBalancingScheme=INTERNAL that will be used as collector + * for mirrored traffic. + * The specified forwarding rule must have isMirroringCollector + * set to true. * @type string $creation_timestamp - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * @type string $description - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * @type string $enable - * Indicates whether or not this packet mirroring takes effect. If set to FALSE, this packet mirroring policy will not be enforced on the network. The default is TRUE. + * Indicates whether or not this packet mirroring takes effect. + * If set to FALSE, this packet mirroring policy will not be enforced on the + * network. + * The default is TRUE. * Check the Enable enum for the list of possible values. * @type \Google\Cloud\Compute\V1\PacketMirroringFilter $filter * Filter for mirrored traffic. If unspecified, all IPv4 traffic is mirrored. * @type int|string $id - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * @type string $kind - * [Output Only] Type of the resource. Always compute#packetMirroring for packet mirrorings. + * [Output Only] Type of the resource. Alwayscompute#packetMirroring for packet mirrorings. * @type \Google\Cloud\Compute\V1\PacketMirroringMirroredResourceInfo $mirrored_resources - * PacketMirroring mirroredResourceInfos. MirroredResourceInfo specifies a set of mirrored VM instances, subnetworks and/or tags for which traffic from/to all VM instances will be mirrored. + * PacketMirroring mirroredResourceInfos. + * MirroredResourceInfo specifies a set of mirrored VM instances, subnetworks + * and/or tags for which traffic from/to all VM instances will be mirrored. * @type string $name - * Name of the resource; provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource; provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must be + * a dash, lowercase letter, or digit, except the last character, which cannot + * be a dash. * @type \Google\Cloud\Compute\V1\PacketMirroringNetworkInfo $network - * Specifies the mirrored VPC network. Only packets in this network will be mirrored. All mirrored VMs should have a NIC in the given network. All mirrored subnetworks should belong to the given network. + * Specifies the mirrored VPC network. Only packets in this network will be + * mirrored. All mirrored VMs should have a NIC in the given network. + * All mirrored subnetworks should belong to the given network. * @type int $priority - * The priority of applying this configuration. Priority is used to break ties in cases where there is more than one matching rule. In the case of two rules that apply for a given Instance, the one with the lowest-numbered priority value wins. Default value is 1000. Valid range is 0 through 65535. + * The priority of applying this configuration. Priority is used to break ties + * in cases where there is more than one matching rule. In the case of two + * rules that apply for a given Instance, the one with the lowest-numbered + * priority value wins. + * Default value is 1000. Valid range is 0 through 65535. * @type string $region * [Output Only] URI of the region where the packetMirroring resides. * @type string $self_link @@ -136,7 +187,10 @@ public function __construct($data = NULL) { } /** - * The Forwarding Rule resource of type loadBalancingScheme=INTERNAL that will be used as collector for mirrored traffic. The specified forwarding rule must have isMirroringCollector set to true. + * The Forwarding Rule resource of typeloadBalancingScheme=INTERNAL that will be used as collector + * for mirrored traffic. + * The specified forwarding rule must have isMirroringCollector + * set to true. * * Generated from protobuf field optional .google.cloud.compute.v1.PacketMirroringForwardingRuleInfo collector_ilb = 426607853; * @return \Google\Cloud\Compute\V1\PacketMirroringForwardingRuleInfo|null @@ -157,7 +211,10 @@ public function clearCollectorIlb() } /** - * The Forwarding Rule resource of type loadBalancingScheme=INTERNAL that will be used as collector for mirrored traffic. The specified forwarding rule must have isMirroringCollector set to true. + * The Forwarding Rule resource of typeloadBalancingScheme=INTERNAL that will be used as collector + * for mirrored traffic. + * The specified forwarding rule must have isMirroringCollector + * set to true. * * Generated from protobuf field optional .google.cloud.compute.v1.PacketMirroringForwardingRuleInfo collector_ilb = 426607853; * @param \Google\Cloud\Compute\V1\PacketMirroringForwardingRuleInfo $var @@ -172,7 +229,8 @@ public function setCollectorIlb($var) } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @return string @@ -193,7 +251,8 @@ public function clearCreationTimestamp() } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @param string $var @@ -208,7 +267,8 @@ public function setCreationTimestamp($var) } /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @return string @@ -229,7 +289,8 @@ public function clearDescription() } /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @param string $var @@ -244,7 +305,10 @@ public function setDescription($var) } /** - * Indicates whether or not this packet mirroring takes effect. If set to FALSE, this packet mirroring policy will not be enforced on the network. The default is TRUE. + * Indicates whether or not this packet mirroring takes effect. + * If set to FALSE, this packet mirroring policy will not be enforced on the + * network. + * The default is TRUE. * Check the Enable enum for the list of possible values. * * Generated from protobuf field optional string enable = 311764355; @@ -266,7 +330,10 @@ public function clearEnable() } /** - * Indicates whether or not this packet mirroring takes effect. If set to FALSE, this packet mirroring policy will not be enforced on the network. The default is TRUE. + * Indicates whether or not this packet mirroring takes effect. + * If set to FALSE, this packet mirroring policy will not be enforced on the + * network. + * The default is TRUE. * Check the Enable enum for the list of possible values. * * Generated from protobuf field optional string enable = 311764355; @@ -318,7 +385,8 @@ public function setFilter($var) } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @return int|string @@ -339,7 +407,8 @@ public function clearId() } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @param int|string $var @@ -354,7 +423,7 @@ public function setId($var) } /** - * [Output Only] Type of the resource. Always compute#packetMirroring for packet mirrorings. + * [Output Only] Type of the resource. Alwayscompute#packetMirroring for packet mirrorings. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -375,7 +444,7 @@ public function clearKind() } /** - * [Output Only] Type of the resource. Always compute#packetMirroring for packet mirrorings. + * [Output Only] Type of the resource. Alwayscompute#packetMirroring for packet mirrorings. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -390,7 +459,9 @@ public function setKind($var) } /** - * PacketMirroring mirroredResourceInfos. MirroredResourceInfo specifies a set of mirrored VM instances, subnetworks and/or tags for which traffic from/to all VM instances will be mirrored. + * PacketMirroring mirroredResourceInfos. + * MirroredResourceInfo specifies a set of mirrored VM instances, subnetworks + * and/or tags for which traffic from/to all VM instances will be mirrored. * * Generated from protobuf field optional .google.cloud.compute.v1.PacketMirroringMirroredResourceInfo mirrored_resources = 124817348; * @return \Google\Cloud\Compute\V1\PacketMirroringMirroredResourceInfo|null @@ -411,7 +482,9 @@ public function clearMirroredResources() } /** - * PacketMirroring mirroredResourceInfos. MirroredResourceInfo specifies a set of mirrored VM instances, subnetworks and/or tags for which traffic from/to all VM instances will be mirrored. + * PacketMirroring mirroredResourceInfos. + * MirroredResourceInfo specifies a set of mirrored VM instances, subnetworks + * and/or tags for which traffic from/to all VM instances will be mirrored. * * Generated from protobuf field optional .google.cloud.compute.v1.PacketMirroringMirroredResourceInfo mirrored_resources = 124817348; * @param \Google\Cloud\Compute\V1\PacketMirroringMirroredResourceInfo $var @@ -426,7 +499,13 @@ public function setMirroredResources($var) } /** - * Name of the resource; provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource; provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must be + * a dash, lowercase letter, or digit, except the last character, which cannot + * be a dash. * * Generated from protobuf field optional string name = 3373707; * @return string @@ -447,7 +526,13 @@ public function clearName() } /** - * Name of the resource; provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource; provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must be + * a dash, lowercase letter, or digit, except the last character, which cannot + * be a dash. * * Generated from protobuf field optional string name = 3373707; * @param string $var @@ -462,7 +547,9 @@ public function setName($var) } /** - * Specifies the mirrored VPC network. Only packets in this network will be mirrored. All mirrored VMs should have a NIC in the given network. All mirrored subnetworks should belong to the given network. + * Specifies the mirrored VPC network. Only packets in this network will be + * mirrored. All mirrored VMs should have a NIC in the given network. + * All mirrored subnetworks should belong to the given network. * * Generated from protobuf field optional .google.cloud.compute.v1.PacketMirroringNetworkInfo network = 232872494; * @return \Google\Cloud\Compute\V1\PacketMirroringNetworkInfo|null @@ -483,7 +570,9 @@ public function clearNetwork() } /** - * Specifies the mirrored VPC network. Only packets in this network will be mirrored. All mirrored VMs should have a NIC in the given network. All mirrored subnetworks should belong to the given network. + * Specifies the mirrored VPC network. Only packets in this network will be + * mirrored. All mirrored VMs should have a NIC in the given network. + * All mirrored subnetworks should belong to the given network. * * Generated from protobuf field optional .google.cloud.compute.v1.PacketMirroringNetworkInfo network = 232872494; * @param \Google\Cloud\Compute\V1\PacketMirroringNetworkInfo $var @@ -498,7 +587,11 @@ public function setNetwork($var) } /** - * The priority of applying this configuration. Priority is used to break ties in cases where there is more than one matching rule. In the case of two rules that apply for a given Instance, the one with the lowest-numbered priority value wins. Default value is 1000. Valid range is 0 through 65535. + * The priority of applying this configuration. Priority is used to break ties + * in cases where there is more than one matching rule. In the case of two + * rules that apply for a given Instance, the one with the lowest-numbered + * priority value wins. + * Default value is 1000. Valid range is 0 through 65535. * * Generated from protobuf field optional uint32 priority = 445151652; * @return int @@ -519,7 +612,11 @@ public function clearPriority() } /** - * The priority of applying this configuration. Priority is used to break ties in cases where there is more than one matching rule. In the case of two rules that apply for a given Instance, the one with the lowest-numbered priority value wins. Default value is 1000. Valid range is 0 through 65535. + * The priority of applying this configuration. Priority is used to break ties + * in cases where there is more than one matching rule. In the case of two + * rules that apply for a given Instance, the one with the lowest-numbered + * priority value wins. + * Default value is 1000. Valid range is 0 through 65535. * * Generated from protobuf field optional uint32 priority = 445151652; * @param int $var diff --git a/Compute/src/V1/PacketMirroring/Enable.php b/Compute/src/V1/PacketMirroring/Enable.php index 65d6d0420c96..dd16e60cfd07 100644 --- a/Compute/src/V1/PacketMirroring/Enable.php +++ b/Compute/src/V1/PacketMirroring/Enable.php @@ -7,7 +7,10 @@ use UnexpectedValueException; /** - * Indicates whether or not this packet mirroring takes effect. If set to FALSE, this packet mirroring policy will not be enforced on the network. The default is TRUE. + * Indicates whether or not this packet mirroring takes effect. + * If set to FALSE, this packet mirroring policy will not be enforced on the + * network. + * The default is TRUE. * * Protobuf type google.cloud.compute.v1.PacketMirroring.Enable */ diff --git a/Compute/src/V1/PacketMirroringAggregatedList.php b/Compute/src/V1/PacketMirroringAggregatedList.php index ead643994c1b..704fdce6dba6 100644 --- a/Compute/src/V1/PacketMirroringAggregatedList.php +++ b/Compute/src/V1/PacketMirroringAggregatedList.php @@ -34,7 +34,11 @@ class PacketMirroringAggregatedList extends \Google\Protobuf\Internal\Message */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -71,7 +75,11 @@ class PacketMirroringAggregatedList extends \Google\Protobuf\Internal\Message * @type string $kind * Type of resource. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type array|\Google\Protobuf\Internal\RepeatedField $unreachables @@ -184,7 +192,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -205,7 +217,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/PacketMirroringFilter.php b/Compute/src/V1/PacketMirroringFilter.php index bf090dbe9469..48c2bd3ad288 100644 --- a/Compute/src/V1/PacketMirroringFilter.php +++ b/Compute/src/V1/PacketMirroringFilter.php @@ -15,19 +15,29 @@ class PacketMirroringFilter extends \Google\Protobuf\Internal\Message { /** - * Protocols that apply as filter on mirrored traffic. If no protocols are specified, all traffic that matches the specified CIDR ranges is mirrored. If neither cidrRanges nor IPProtocols is specified, all IPv4 traffic is mirrored. + * Protocols that apply as filter on mirrored traffic. + * If no protocols are specified, all traffic that matches the specified + * CIDR ranges is mirrored. + * If neither cidrRanges nor IPProtocols is specified, all IPv4 traffic is + * mirrored. * * Generated from protobuf field repeated string I_p_protocols = 98544854; */ private $I_p_protocols; /** - * One or more IPv4 or IPv6 CIDR ranges that apply as filters on the source (ingress) or destination (egress) IP in the IP header. If no ranges are specified, all IPv4 traffic that matches the specified IPProtocols is mirrored. If neither cidrRanges nor IPProtocols is specified, all IPv4 traffic is mirrored. To mirror all IPv4 and IPv6 traffic, use "0.0.0.0/0,::/0". + * One or more IPv4 or IPv6 CIDR ranges that apply as filters on the source + * (ingress) or destination (egress) IP in the IP header. If no ranges are + * specified, all IPv4 traffic that matches the specified IPProtocols is + * mirrored. If neither cidrRanges nor IPProtocols is specified, all IPv4 + * traffic is mirrored. To mirror all IPv4 and IPv6 traffic, use + * "0.0.0.0/0,::/0". * * Generated from protobuf field repeated string cidr_ranges = 487901697; */ private $cidr_ranges; /** - * Direction of traffic to mirror, either INGRESS, EGRESS, or BOTH. The default is BOTH. + * Direction of traffic to mirror, either INGRESS, EGRESS, or BOTH. + * The default is BOTH. * Check the Direction enum for the list of possible values. * * Generated from protobuf field optional string direction = 111150975; @@ -41,11 +51,21 @@ class PacketMirroringFilter extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type array|\Google\Protobuf\Internal\RepeatedField $I_p_protocols - * Protocols that apply as filter on mirrored traffic. If no protocols are specified, all traffic that matches the specified CIDR ranges is mirrored. If neither cidrRanges nor IPProtocols is specified, all IPv4 traffic is mirrored. + * Protocols that apply as filter on mirrored traffic. + * If no protocols are specified, all traffic that matches the specified + * CIDR ranges is mirrored. + * If neither cidrRanges nor IPProtocols is specified, all IPv4 traffic is + * mirrored. * @type array|\Google\Protobuf\Internal\RepeatedField $cidr_ranges - * One or more IPv4 or IPv6 CIDR ranges that apply as filters on the source (ingress) or destination (egress) IP in the IP header. If no ranges are specified, all IPv4 traffic that matches the specified IPProtocols is mirrored. If neither cidrRanges nor IPProtocols is specified, all IPv4 traffic is mirrored. To mirror all IPv4 and IPv6 traffic, use "0.0.0.0/0,::/0". + * One or more IPv4 or IPv6 CIDR ranges that apply as filters on the source + * (ingress) or destination (egress) IP in the IP header. If no ranges are + * specified, all IPv4 traffic that matches the specified IPProtocols is + * mirrored. If neither cidrRanges nor IPProtocols is specified, all IPv4 + * traffic is mirrored. To mirror all IPv4 and IPv6 traffic, use + * "0.0.0.0/0,::/0". * @type string $direction - * Direction of traffic to mirror, either INGRESS, EGRESS, or BOTH. The default is BOTH. + * Direction of traffic to mirror, either INGRESS, EGRESS, or BOTH. + * The default is BOTH. * Check the Direction enum for the list of possible values. * } */ @@ -55,7 +75,11 @@ public function __construct($data = NULL) { } /** - * Protocols that apply as filter on mirrored traffic. If no protocols are specified, all traffic that matches the specified CIDR ranges is mirrored. If neither cidrRanges nor IPProtocols is specified, all IPv4 traffic is mirrored. + * Protocols that apply as filter on mirrored traffic. + * If no protocols are specified, all traffic that matches the specified + * CIDR ranges is mirrored. + * If neither cidrRanges nor IPProtocols is specified, all IPv4 traffic is + * mirrored. * * Generated from protobuf field repeated string I_p_protocols = 98544854; * @return \Google\Protobuf\Internal\RepeatedField @@ -66,7 +90,11 @@ public function getIPProtocols() } /** - * Protocols that apply as filter on mirrored traffic. If no protocols are specified, all traffic that matches the specified CIDR ranges is mirrored. If neither cidrRanges nor IPProtocols is specified, all IPv4 traffic is mirrored. + * Protocols that apply as filter on mirrored traffic. + * If no protocols are specified, all traffic that matches the specified + * CIDR ranges is mirrored. + * If neither cidrRanges nor IPProtocols is specified, all IPv4 traffic is + * mirrored. * * Generated from protobuf field repeated string I_p_protocols = 98544854; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -81,7 +109,12 @@ public function setIPProtocols($var) } /** - * One or more IPv4 or IPv6 CIDR ranges that apply as filters on the source (ingress) or destination (egress) IP in the IP header. If no ranges are specified, all IPv4 traffic that matches the specified IPProtocols is mirrored. If neither cidrRanges nor IPProtocols is specified, all IPv4 traffic is mirrored. To mirror all IPv4 and IPv6 traffic, use "0.0.0.0/0,::/0". + * One or more IPv4 or IPv6 CIDR ranges that apply as filters on the source + * (ingress) or destination (egress) IP in the IP header. If no ranges are + * specified, all IPv4 traffic that matches the specified IPProtocols is + * mirrored. If neither cidrRanges nor IPProtocols is specified, all IPv4 + * traffic is mirrored. To mirror all IPv4 and IPv6 traffic, use + * "0.0.0.0/0,::/0". * * Generated from protobuf field repeated string cidr_ranges = 487901697; * @return \Google\Protobuf\Internal\RepeatedField @@ -92,7 +125,12 @@ public function getCidrRanges() } /** - * One or more IPv4 or IPv6 CIDR ranges that apply as filters on the source (ingress) or destination (egress) IP in the IP header. If no ranges are specified, all IPv4 traffic that matches the specified IPProtocols is mirrored. If neither cidrRanges nor IPProtocols is specified, all IPv4 traffic is mirrored. To mirror all IPv4 and IPv6 traffic, use "0.0.0.0/0,::/0". + * One or more IPv4 or IPv6 CIDR ranges that apply as filters on the source + * (ingress) or destination (egress) IP in the IP header. If no ranges are + * specified, all IPv4 traffic that matches the specified IPProtocols is + * mirrored. If neither cidrRanges nor IPProtocols is specified, all IPv4 + * traffic is mirrored. To mirror all IPv4 and IPv6 traffic, use + * "0.0.0.0/0,::/0". * * Generated from protobuf field repeated string cidr_ranges = 487901697; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -107,7 +145,8 @@ public function setCidrRanges($var) } /** - * Direction of traffic to mirror, either INGRESS, EGRESS, or BOTH. The default is BOTH. + * Direction of traffic to mirror, either INGRESS, EGRESS, or BOTH. + * The default is BOTH. * Check the Direction enum for the list of possible values. * * Generated from protobuf field optional string direction = 111150975; @@ -129,7 +168,8 @@ public function clearDirection() } /** - * Direction of traffic to mirror, either INGRESS, EGRESS, or BOTH. The default is BOTH. + * Direction of traffic to mirror, either INGRESS, EGRESS, or BOTH. + * The default is BOTH. * Check the Direction enum for the list of possible values. * * Generated from protobuf field optional string direction = 111150975; diff --git a/Compute/src/V1/PacketMirroringFilter/Direction.php b/Compute/src/V1/PacketMirroringFilter/Direction.php index 223eb0f06419..6c61c7f28bdd 100644 --- a/Compute/src/V1/PacketMirroringFilter/Direction.php +++ b/Compute/src/V1/PacketMirroringFilter/Direction.php @@ -7,7 +7,8 @@ use UnexpectedValueException; /** - * Direction of traffic to mirror, either INGRESS, EGRESS, or BOTH. The default is BOTH. + * Direction of traffic to mirror, either INGRESS, EGRESS, or BOTH. + * The default is BOTH. * * Protobuf type google.cloud.compute.v1.PacketMirroringFilter.Direction */ diff --git a/Compute/src/V1/PacketMirroringForwardingRuleInfo.php b/Compute/src/V1/PacketMirroringForwardingRuleInfo.php index 85189a4779ab..596d1c79215d 100644 --- a/Compute/src/V1/PacketMirroringForwardingRuleInfo.php +++ b/Compute/src/V1/PacketMirroringForwardingRuleInfo.php @@ -15,13 +15,15 @@ class PacketMirroringForwardingRuleInfo extends \Google\Protobuf\Internal\Message { /** - * [Output Only] Unique identifier for the forwarding rule; defined by the server. + * [Output Only] Unique identifier for the forwarding rule; defined by the + * server. * * Generated from protobuf field optional string canonical_url = 512294820; */ protected $canonical_url = null; /** - * Resource URL to the forwarding rule representing the ILB configured as destination of the mirrored traffic. + * Resource URL to the forwarding rule representing the ILB + * configured as destination of the mirrored traffic. * * Generated from protobuf field optional string url = 116079; */ @@ -34,9 +36,11 @@ class PacketMirroringForwardingRuleInfo extends \Google\Protobuf\Internal\Messag * Optional. Data for populating the Message object. * * @type string $canonical_url - * [Output Only] Unique identifier for the forwarding rule; defined by the server. + * [Output Only] Unique identifier for the forwarding rule; defined by the + * server. * @type string $url - * Resource URL to the forwarding rule representing the ILB configured as destination of the mirrored traffic. + * Resource URL to the forwarding rule representing the ILB + * configured as destination of the mirrored traffic. * } */ public function __construct($data = NULL) { @@ -45,7 +49,8 @@ public function __construct($data = NULL) { } /** - * [Output Only] Unique identifier for the forwarding rule; defined by the server. + * [Output Only] Unique identifier for the forwarding rule; defined by the + * server. * * Generated from protobuf field optional string canonical_url = 512294820; * @return string @@ -66,7 +71,8 @@ public function clearCanonicalUrl() } /** - * [Output Only] Unique identifier for the forwarding rule; defined by the server. + * [Output Only] Unique identifier for the forwarding rule; defined by the + * server. * * Generated from protobuf field optional string canonical_url = 512294820; * @param string $var @@ -81,7 +87,8 @@ public function setCanonicalUrl($var) } /** - * Resource URL to the forwarding rule representing the ILB configured as destination of the mirrored traffic. + * Resource URL to the forwarding rule representing the ILB + * configured as destination of the mirrored traffic. * * Generated from protobuf field optional string url = 116079; * @return string @@ -102,7 +109,8 @@ public function clearUrl() } /** - * Resource URL to the forwarding rule representing the ILB configured as destination of the mirrored traffic. + * Resource URL to the forwarding rule representing the ILB + * configured as destination of the mirrored traffic. * * Generated from protobuf field optional string url = 116079; * @param string $var diff --git a/Compute/src/V1/PacketMirroringList.php b/Compute/src/V1/PacketMirroringList.php index 4e86d4f62b01..9bb0c4a64f74 100644 --- a/Compute/src/V1/PacketMirroringList.php +++ b/Compute/src/V1/PacketMirroringList.php @@ -28,13 +28,18 @@ class PacketMirroringList extends \Google\Protobuf\Internal\Message */ private $items; /** - * [Output Only] Type of resource. Always compute#packetMirroring for packetMirrorings. + * [Output Only] Type of resource. Always compute#packetMirroring + * for packetMirrorings. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -63,9 +68,14 @@ class PacketMirroringList extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\PacketMirroring>|\Google\Protobuf\Internal\RepeatedField $items * A list of PacketMirroring resources. * @type string $kind - * [Output Only] Type of resource. Always compute#packetMirroring for packetMirrorings. + * [Output Only] Type of resource. Always compute#packetMirroring + * for packetMirrorings. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type \Google\Cloud\Compute\V1\Warning $warning @@ -140,7 +150,8 @@ public function setItems($var) } /** - * [Output Only] Type of resource. Always compute#packetMirroring for packetMirrorings. + * [Output Only] Type of resource. Always compute#packetMirroring + * for packetMirrorings. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -161,7 +172,8 @@ public function clearKind() } /** - * [Output Only] Type of resource. Always compute#packetMirroring for packetMirrorings. + * [Output Only] Type of resource. Always compute#packetMirroring + * for packetMirrorings. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -176,7 +188,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -197,7 +213,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/PacketMirroringMirroredResourceInfo.php b/Compute/src/V1/PacketMirroringMirroredResourceInfo.php index c94629ae85de..0881a08144d8 100644 --- a/Compute/src/V1/PacketMirroringMirroredResourceInfo.php +++ b/Compute/src/V1/PacketMirroringMirroredResourceInfo.php @@ -15,19 +15,27 @@ class PacketMirroringMirroredResourceInfo extends \Google\Protobuf\Internal\Message { /** - * A set of virtual machine instances that are being mirrored. They must live in zones contained in the same region as this packetMirroring. Note that this config will apply only to those network interfaces of the Instances that belong to the network specified in this packetMirroring. You may specify a maximum of 50 Instances. + * A set of virtual machine instances that are being mirrored. + * They must live in zones contained in the same region as this + * packetMirroring. + * Note that this config will apply only to those network interfaces of the + * Instances that belong to the network specified in this packetMirroring. + * You may specify a maximum of 50 Instances. * * Generated from protobuf field repeated .google.cloud.compute.v1.PacketMirroringMirroredResourceInfoInstanceInfo instances = 29097598; */ private $instances; /** - * A set of subnetworks for which traffic from/to all VM instances will be mirrored. They must live in the same region as this packetMirroring. You may specify a maximum of 5 subnetworks. + * A set of subnetworks for which traffic from/to all VM instances will be + * mirrored. They must live in the same region as this packetMirroring. + * You may specify a maximum of 5 subnetworks. * * Generated from protobuf field repeated .google.cloud.compute.v1.PacketMirroringMirroredResourceInfoSubnetInfo subnetworks = 415853125; */ private $subnetworks; /** - * A set of mirrored tags. Traffic from/to all VM instances that have one or more of these tags will be mirrored. + * A set of mirrored tags. Traffic from/to all VM instances that have one or + * more of these tags will be mirrored. * * Generated from protobuf field repeated string tags = 3552281; */ @@ -40,11 +48,19 @@ class PacketMirroringMirroredResourceInfo extends \Google\Protobuf\Internal\Mess * Optional. Data for populating the Message object. * * @type array<\Google\Cloud\Compute\V1\PacketMirroringMirroredResourceInfoInstanceInfo>|\Google\Protobuf\Internal\RepeatedField $instances - * A set of virtual machine instances that are being mirrored. They must live in zones contained in the same region as this packetMirroring. Note that this config will apply only to those network interfaces of the Instances that belong to the network specified in this packetMirroring. You may specify a maximum of 50 Instances. + * A set of virtual machine instances that are being mirrored. + * They must live in zones contained in the same region as this + * packetMirroring. + * Note that this config will apply only to those network interfaces of the + * Instances that belong to the network specified in this packetMirroring. + * You may specify a maximum of 50 Instances. * @type array<\Google\Cloud\Compute\V1\PacketMirroringMirroredResourceInfoSubnetInfo>|\Google\Protobuf\Internal\RepeatedField $subnetworks - * A set of subnetworks for which traffic from/to all VM instances will be mirrored. They must live in the same region as this packetMirroring. You may specify a maximum of 5 subnetworks. + * A set of subnetworks for which traffic from/to all VM instances will be + * mirrored. They must live in the same region as this packetMirroring. + * You may specify a maximum of 5 subnetworks. * @type array|\Google\Protobuf\Internal\RepeatedField $tags - * A set of mirrored tags. Traffic from/to all VM instances that have one or more of these tags will be mirrored. + * A set of mirrored tags. Traffic from/to all VM instances that have one or + * more of these tags will be mirrored. * } */ public function __construct($data = NULL) { @@ -53,7 +69,12 @@ public function __construct($data = NULL) { } /** - * A set of virtual machine instances that are being mirrored. They must live in zones contained in the same region as this packetMirroring. Note that this config will apply only to those network interfaces of the Instances that belong to the network specified in this packetMirroring. You may specify a maximum of 50 Instances. + * A set of virtual machine instances that are being mirrored. + * They must live in zones contained in the same region as this + * packetMirroring. + * Note that this config will apply only to those network interfaces of the + * Instances that belong to the network specified in this packetMirroring. + * You may specify a maximum of 50 Instances. * * Generated from protobuf field repeated .google.cloud.compute.v1.PacketMirroringMirroredResourceInfoInstanceInfo instances = 29097598; * @return \Google\Protobuf\Internal\RepeatedField @@ -64,7 +85,12 @@ public function getInstances() } /** - * A set of virtual machine instances that are being mirrored. They must live in zones contained in the same region as this packetMirroring. Note that this config will apply only to those network interfaces of the Instances that belong to the network specified in this packetMirroring. You may specify a maximum of 50 Instances. + * A set of virtual machine instances that are being mirrored. + * They must live in zones contained in the same region as this + * packetMirroring. + * Note that this config will apply only to those network interfaces of the + * Instances that belong to the network specified in this packetMirroring. + * You may specify a maximum of 50 Instances. * * Generated from protobuf field repeated .google.cloud.compute.v1.PacketMirroringMirroredResourceInfoInstanceInfo instances = 29097598; * @param array<\Google\Cloud\Compute\V1\PacketMirroringMirroredResourceInfoInstanceInfo>|\Google\Protobuf\Internal\RepeatedField $var @@ -79,7 +105,9 @@ public function setInstances($var) } /** - * A set of subnetworks for which traffic from/to all VM instances will be mirrored. They must live in the same region as this packetMirroring. You may specify a maximum of 5 subnetworks. + * A set of subnetworks for which traffic from/to all VM instances will be + * mirrored. They must live in the same region as this packetMirroring. + * You may specify a maximum of 5 subnetworks. * * Generated from protobuf field repeated .google.cloud.compute.v1.PacketMirroringMirroredResourceInfoSubnetInfo subnetworks = 415853125; * @return \Google\Protobuf\Internal\RepeatedField @@ -90,7 +118,9 @@ public function getSubnetworks() } /** - * A set of subnetworks for which traffic from/to all VM instances will be mirrored. They must live in the same region as this packetMirroring. You may specify a maximum of 5 subnetworks. + * A set of subnetworks for which traffic from/to all VM instances will be + * mirrored. They must live in the same region as this packetMirroring. + * You may specify a maximum of 5 subnetworks. * * Generated from protobuf field repeated .google.cloud.compute.v1.PacketMirroringMirroredResourceInfoSubnetInfo subnetworks = 415853125; * @param array<\Google\Cloud\Compute\V1\PacketMirroringMirroredResourceInfoSubnetInfo>|\Google\Protobuf\Internal\RepeatedField $var @@ -105,7 +135,8 @@ public function setSubnetworks($var) } /** - * A set of mirrored tags. Traffic from/to all VM instances that have one or more of these tags will be mirrored. + * A set of mirrored tags. Traffic from/to all VM instances that have one or + * more of these tags will be mirrored. * * Generated from protobuf field repeated string tags = 3552281; * @return \Google\Protobuf\Internal\RepeatedField @@ -116,7 +147,8 @@ public function getTags() } /** - * A set of mirrored tags. Traffic from/to all VM instances that have one or more of these tags will be mirrored. + * A set of mirrored tags. Traffic from/to all VM instances that have one or + * more of these tags will be mirrored. * * Generated from protobuf field repeated string tags = 3552281; * @param array|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/PacketMirroringMirroredResourceInfoInstanceInfo.php b/Compute/src/V1/PacketMirroringMirroredResourceInfoInstanceInfo.php index 04479faa4362..99d4e2ba8b5e 100644 --- a/Compute/src/V1/PacketMirroringMirroredResourceInfoInstanceInfo.php +++ b/Compute/src/V1/PacketMirroringMirroredResourceInfoInstanceInfo.php @@ -15,7 +15,8 @@ class PacketMirroringMirroredResourceInfoInstanceInfo extends \Google\Protobuf\Internal\Message { /** - * [Output Only] Unique identifier for the instance; defined by the server. + * [Output Only] Unique identifier for the instance; defined by the + * server. * * Generated from protobuf field optional string canonical_url = 512294820; */ @@ -34,7 +35,8 @@ class PacketMirroringMirroredResourceInfoInstanceInfo extends \Google\Protobuf\I * Optional. Data for populating the Message object. * * @type string $canonical_url - * [Output Only] Unique identifier for the instance; defined by the server. + * [Output Only] Unique identifier for the instance; defined by the + * server. * @type string $url * Resource URL to the virtual machine instance which is being mirrored. * } @@ -45,7 +47,8 @@ public function __construct($data = NULL) { } /** - * [Output Only] Unique identifier for the instance; defined by the server. + * [Output Only] Unique identifier for the instance; defined by the + * server. * * Generated from protobuf field optional string canonical_url = 512294820; * @return string @@ -66,7 +69,8 @@ public function clearCanonicalUrl() } /** - * [Output Only] Unique identifier for the instance; defined by the server. + * [Output Only] Unique identifier for the instance; defined by the + * server. * * Generated from protobuf field optional string canonical_url = 512294820; * @param string $var diff --git a/Compute/src/V1/PacketMirroringMirroredResourceInfoSubnetInfo.php b/Compute/src/V1/PacketMirroringMirroredResourceInfoSubnetInfo.php index 01c43b97e60c..035a715f5cf6 100644 --- a/Compute/src/V1/PacketMirroringMirroredResourceInfoSubnetInfo.php +++ b/Compute/src/V1/PacketMirroringMirroredResourceInfoSubnetInfo.php @@ -15,13 +15,15 @@ class PacketMirroringMirroredResourceInfoSubnetInfo extends \Google\Protobuf\Internal\Message { /** - * [Output Only] Unique identifier for the subnetwork; defined by the server. + * [Output Only] Unique identifier for the subnetwork; defined by the + * server. * * Generated from protobuf field optional string canonical_url = 512294820; */ protected $canonical_url = null; /** - * Resource URL to the subnetwork for which traffic from/to all VM instances will be mirrored. + * Resource URL to the subnetwork for which + * traffic from/to all VM instances will be mirrored. * * Generated from protobuf field optional string url = 116079; */ @@ -34,9 +36,11 @@ class PacketMirroringMirroredResourceInfoSubnetInfo extends \Google\Protobuf\Int * Optional. Data for populating the Message object. * * @type string $canonical_url - * [Output Only] Unique identifier for the subnetwork; defined by the server. + * [Output Only] Unique identifier for the subnetwork; defined by the + * server. * @type string $url - * Resource URL to the subnetwork for which traffic from/to all VM instances will be mirrored. + * Resource URL to the subnetwork for which + * traffic from/to all VM instances will be mirrored. * } */ public function __construct($data = NULL) { @@ -45,7 +49,8 @@ public function __construct($data = NULL) { } /** - * [Output Only] Unique identifier for the subnetwork; defined by the server. + * [Output Only] Unique identifier for the subnetwork; defined by the + * server. * * Generated from protobuf field optional string canonical_url = 512294820; * @return string @@ -66,7 +71,8 @@ public function clearCanonicalUrl() } /** - * [Output Only] Unique identifier for the subnetwork; defined by the server. + * [Output Only] Unique identifier for the subnetwork; defined by the + * server. * * Generated from protobuf field optional string canonical_url = 512294820; * @param string $var @@ -81,7 +87,8 @@ public function setCanonicalUrl($var) } /** - * Resource URL to the subnetwork for which traffic from/to all VM instances will be mirrored. + * Resource URL to the subnetwork for which + * traffic from/to all VM instances will be mirrored. * * Generated from protobuf field optional string url = 116079; * @return string @@ -102,7 +109,8 @@ public function clearUrl() } /** - * Resource URL to the subnetwork for which traffic from/to all VM instances will be mirrored. + * Resource URL to the subnetwork for which + * traffic from/to all VM instances will be mirrored. * * Generated from protobuf field optional string url = 116079; * @param string $var diff --git a/Compute/src/V1/PacketMirroringsScopedList.php b/Compute/src/V1/PacketMirroringsScopedList.php index 9c846fc0aea5..4d2450e9b343 100644 --- a/Compute/src/V1/PacketMirroringsScopedList.php +++ b/Compute/src/V1/PacketMirroringsScopedList.php @@ -21,7 +21,8 @@ class PacketMirroringsScopedList extends \Google\Protobuf\Internal\Message */ private $packet_mirrorings; /** - * Informational warning which replaces the list of packetMirrorings when the list is empty. + * Informational warning which replaces the list of packetMirrorings when the + * list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; */ @@ -36,7 +37,8 @@ class PacketMirroringsScopedList extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\PacketMirroring>|\Google\Protobuf\Internal\RepeatedField $packet_mirrorings * A list of packetMirrorings contained in this scope. * @type \Google\Cloud\Compute\V1\Warning $warning - * Informational warning which replaces the list of packetMirrorings when the list is empty. + * Informational warning which replaces the list of packetMirrorings when the + * list is empty. * } */ public function __construct($data = NULL) { @@ -71,7 +73,8 @@ public function setPacketMirrorings($var) } /** - * Informational warning which replaces the list of packetMirrorings when the list is empty. + * Informational warning which replaces the list of packetMirrorings when the + * list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; * @return \Google\Cloud\Compute\V1\Warning|null @@ -92,7 +95,8 @@ public function clearWarning() } /** - * Informational warning which replaces the list of packetMirrorings when the list is empty. + * Informational warning which replaces the list of packetMirrorings when the + * list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; * @param \Google\Cloud\Compute\V1\Warning $var diff --git a/Compute/src/V1/PatchAutoscalerRequest.php b/Compute/src/V1/PatchAutoscalerRequest.php index 1492cf44160a..f716e25d0b27 100644 --- a/Compute/src/V1/PatchAutoscalerRequest.php +++ b/Compute/src/V1/PatchAutoscalerRequest.php @@ -34,7 +34,17 @@ class PatchAutoscalerRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -76,7 +86,17 @@ public static function build(string $project, string $zone, \Google\Cloud\Comput * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $zone * Name of the zone for this request. * } @@ -185,7 +205,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -206,7 +236,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/PatchBackendBucketRequest.php b/Compute/src/V1/PatchBackendBucketRequest.php index 707a3e878675..69df06396432 100644 --- a/Compute/src/V1/PatchBackendBucketRequest.php +++ b/Compute/src/V1/PatchBackendBucketRequest.php @@ -34,7 +34,17 @@ class PatchBackendBucketRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -70,7 +80,17 @@ public static function build(string $project, string $backendBucket, \Google\Clo * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -167,7 +187,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -188,7 +218,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/PatchBackendServiceRequest.php b/Compute/src/V1/PatchBackendServiceRequest.php index 3354b0bf2612..01ab45c28b0c 100644 --- a/Compute/src/V1/PatchBackendServiceRequest.php +++ b/Compute/src/V1/PatchBackendServiceRequest.php @@ -34,7 +34,17 @@ class PatchBackendServiceRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -70,7 +80,17 @@ public static function build(string $project, string $backendService, \Google\Cl * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -167,7 +187,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -188,7 +218,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/PatchCrossSiteNetworkRequest.php b/Compute/src/V1/PatchCrossSiteNetworkRequest.php new file mode 100644 index 000000000000..90510207a0fe --- /dev/null +++ b/Compute/src/V1/PatchCrossSiteNetworkRequest.php @@ -0,0 +1,338 @@ +google.cloud.compute.v1.PatchCrossSiteNetworkRequest + */ +class PatchCrossSiteNetworkRequest extends \Google\Protobuf\Internal\Message +{ + /** + * Name of the cross-site network to update. + * + * Generated from protobuf field string cross_site_network = 108192469 [(.google.api.field_behavior) = REQUIRED]; + */ + protected $cross_site_network = ''; + /** + * The body resource for this request + * + * Generated from protobuf field .google.cloud.compute.v1.CrossSiteNetwork cross_site_network_resource = 30896696 [(.google.api.field_behavior) = REQUIRED]; + */ + protected $cross_site_network_resource = null; + /** + * Project ID for this request. + * + * Generated from protobuf field string project = 227560217 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "project"]; + */ + protected $project = ''; + /** + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). + * end_interface: MixerMutationRequestBuilder + * + * Generated from protobuf field optional string request_id = 37109963; + */ + protected $request_id = null; + /** + * update_mask indicates fields to be updated as part of this request. + * + * Generated from protobuf field optional string update_mask = 500079778; + */ + protected $update_mask = null; + /** + * [Input Only] Validate the new configuration, but don't update it. + * + * Generated from protobuf field optional bool validate_only = 242744629; + */ + protected $validate_only = null; + + /** + * @param string $project Project ID for this request. + * @param string $crossSiteNetwork Name of the cross-site network to update. + * @param \Google\Cloud\Compute\V1\CrossSiteNetwork $crossSiteNetworkResource The body resource for this request + * + * @return \Google\Cloud\Compute\V1\PatchCrossSiteNetworkRequest + * + * @experimental + */ + public static function build(string $project, string $crossSiteNetwork, \Google\Cloud\Compute\V1\CrossSiteNetwork $crossSiteNetworkResource): self + { + return (new self()) + ->setProject($project) + ->setCrossSiteNetwork($crossSiteNetwork) + ->setCrossSiteNetworkResource($crossSiteNetworkResource); + } + + /** + * Constructor. + * + * @param array $data { + * Optional. Data for populating the Message object. + * + * @type string $cross_site_network + * Name of the cross-site network to update. + * @type \Google\Cloud\Compute\V1\CrossSiteNetwork $cross_site_network_resource + * The body resource for this request + * @type string $project + * Project ID for this request. + * @type string $request_id + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). + * end_interface: MixerMutationRequestBuilder + * @type string $update_mask + * update_mask indicates fields to be updated as part of this request. + * @type bool $validate_only + * [Input Only] Validate the new configuration, but don't update it. + * } + */ + public function __construct($data = NULL) { + \GPBMetadata\Google\Cloud\Compute\V1\Compute::initOnce(); + parent::__construct($data); + } + + /** + * Name of the cross-site network to update. + * + * Generated from protobuf field string cross_site_network = 108192469 [(.google.api.field_behavior) = REQUIRED]; + * @return string + */ + public function getCrossSiteNetwork() + { + return $this->cross_site_network; + } + + /** + * Name of the cross-site network to update. + * + * Generated from protobuf field string cross_site_network = 108192469 [(.google.api.field_behavior) = REQUIRED]; + * @param string $var + * @return $this + */ + public function setCrossSiteNetwork($var) + { + GPBUtil::checkString($var, True); + $this->cross_site_network = $var; + + return $this; + } + + /** + * The body resource for this request + * + * Generated from protobuf field .google.cloud.compute.v1.CrossSiteNetwork cross_site_network_resource = 30896696 [(.google.api.field_behavior) = REQUIRED]; + * @return \Google\Cloud\Compute\V1\CrossSiteNetwork|null + */ + public function getCrossSiteNetworkResource() + { + return $this->cross_site_network_resource; + } + + public function hasCrossSiteNetworkResource() + { + return isset($this->cross_site_network_resource); + } + + public function clearCrossSiteNetworkResource() + { + unset($this->cross_site_network_resource); + } + + /** + * The body resource for this request + * + * Generated from protobuf field .google.cloud.compute.v1.CrossSiteNetwork cross_site_network_resource = 30896696 [(.google.api.field_behavior) = REQUIRED]; + * @param \Google\Cloud\Compute\V1\CrossSiteNetwork $var + * @return $this + */ + public function setCrossSiteNetworkResource($var) + { + GPBUtil::checkMessage($var, \Google\Cloud\Compute\V1\CrossSiteNetwork::class); + $this->cross_site_network_resource = $var; + + return $this; + } + + /** + * Project ID for this request. + * + * Generated from protobuf field string project = 227560217 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "project"]; + * @return string + */ + public function getProject() + { + return $this->project; + } + + /** + * Project ID for this request. + * + * Generated from protobuf field string project = 227560217 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "project"]; + * @param string $var + * @return $this + */ + public function setProject($var) + { + GPBUtil::checkString($var, True); + $this->project = $var; + + return $this; + } + + /** + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). + * end_interface: MixerMutationRequestBuilder + * + * Generated from protobuf field optional string request_id = 37109963; + * @return string + */ + public function getRequestId() + { + return isset($this->request_id) ? $this->request_id : ''; + } + + public function hasRequestId() + { + return isset($this->request_id); + } + + public function clearRequestId() + { + unset($this->request_id); + } + + /** + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). + * end_interface: MixerMutationRequestBuilder + * + * Generated from protobuf field optional string request_id = 37109963; + * @param string $var + * @return $this + */ + public function setRequestId($var) + { + GPBUtil::checkString($var, True); + $this->request_id = $var; + + return $this; + } + + /** + * update_mask indicates fields to be updated as part of this request. + * + * Generated from protobuf field optional string update_mask = 500079778; + * @return string + */ + public function getUpdateMask() + { + return isset($this->update_mask) ? $this->update_mask : ''; + } + + public function hasUpdateMask() + { + return isset($this->update_mask); + } + + public function clearUpdateMask() + { + unset($this->update_mask); + } + + /** + * update_mask indicates fields to be updated as part of this request. + * + * Generated from protobuf field optional string update_mask = 500079778; + * @param string $var + * @return $this + */ + public function setUpdateMask($var) + { + GPBUtil::checkString($var, True); + $this->update_mask = $var; + + return $this; + } + + /** + * [Input Only] Validate the new configuration, but don't update it. + * + * Generated from protobuf field optional bool validate_only = 242744629; + * @return bool + */ + public function getValidateOnly() + { + return isset($this->validate_only) ? $this->validate_only : false; + } + + public function hasValidateOnly() + { + return isset($this->validate_only); + } + + public function clearValidateOnly() + { + unset($this->validate_only); + } + + /** + * [Input Only] Validate the new configuration, but don't update it. + * + * Generated from protobuf field optional bool validate_only = 242744629; + * @param bool $var + * @return $this + */ + public function setValidateOnly($var) + { + GPBUtil::checkBool($var); + $this->validate_only = $var; + + return $this; + } + +} + diff --git a/Compute/src/V1/PatchFirewallPolicyRequest.php b/Compute/src/V1/PatchFirewallPolicyRequest.php index ce349a9b3e8c..09f8875d7458 100644 --- a/Compute/src/V1/PatchFirewallPolicyRequest.php +++ b/Compute/src/V1/PatchFirewallPolicyRequest.php @@ -28,7 +28,17 @@ class PatchFirewallPolicyRequest extends \Google\Protobuf\Internal\Message */ protected $firewall_policy_resource = null; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -60,7 +70,17 @@ public static function build(string $firewallPolicy, \Google\Cloud\Compute\V1\Fi * @type \Google\Cloud\Compute\V1\FirewallPolicy $firewall_policy_resource * The body resource for this request * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -131,7 +151,17 @@ public function setFirewallPolicyResource($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -152,7 +182,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/PatchFirewallRequest.php b/Compute/src/V1/PatchFirewallRequest.php index a7e5845c0f77..66fbf8b5a340 100644 --- a/Compute/src/V1/PatchFirewallRequest.php +++ b/Compute/src/V1/PatchFirewallRequest.php @@ -34,7 +34,17 @@ class PatchFirewallRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -70,7 +80,17 @@ public static function build(string $project, string $firewall, \Google\Cloud\Co * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -167,7 +187,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -188,7 +218,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/PatchForwardingRuleRequest.php b/Compute/src/V1/PatchForwardingRuleRequest.php index 2f7a734b7cc4..3805be5b3ddf 100644 --- a/Compute/src/V1/PatchForwardingRuleRequest.php +++ b/Compute/src/V1/PatchForwardingRuleRequest.php @@ -40,7 +40,17 @@ class PatchForwardingRuleRequest extends \Google\Protobuf\Internal\Message */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -80,7 +90,17 @@ public static function build(string $project, string $region, string $forwarding * @type string $region * Name of the region scoping this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -203,7 +223,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -224,7 +254,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/PatchGlobalForwardingRuleRequest.php b/Compute/src/V1/PatchGlobalForwardingRuleRequest.php index b1fff7eec1c5..43e2e2cfd8dd 100644 --- a/Compute/src/V1/PatchGlobalForwardingRuleRequest.php +++ b/Compute/src/V1/PatchGlobalForwardingRuleRequest.php @@ -34,7 +34,17 @@ class PatchGlobalForwardingRuleRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -70,7 +80,17 @@ public static function build(string $project, string $forwardingRule, \Google\Cl * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -167,7 +187,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -188,7 +218,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/PatchGlobalPublicDelegatedPrefixeRequest.php b/Compute/src/V1/PatchGlobalPublicDelegatedPrefixeRequest.php index 6669cf349717..7c1a1cc7824f 100644 --- a/Compute/src/V1/PatchGlobalPublicDelegatedPrefixeRequest.php +++ b/Compute/src/V1/PatchGlobalPublicDelegatedPrefixeRequest.php @@ -34,7 +34,17 @@ class PatchGlobalPublicDelegatedPrefixeRequest extends \Google\Protobuf\Internal */ protected $public_delegated_prefix_resource = null; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -70,7 +80,17 @@ public static function build(string $project, string $publicDelegatedPrefix, \Go * @type \Google\Cloud\Compute\V1\PublicDelegatedPrefix $public_delegated_prefix_resource * The body resource for this request * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -167,7 +187,17 @@ public function setPublicDelegatedPrefixResource($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -188,7 +218,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/PatchHealthCheckRequest.php b/Compute/src/V1/PatchHealthCheckRequest.php index 45880c48d005..8d00b07714d3 100644 --- a/Compute/src/V1/PatchHealthCheckRequest.php +++ b/Compute/src/V1/PatchHealthCheckRequest.php @@ -34,7 +34,17 @@ class PatchHealthCheckRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -70,7 +80,17 @@ public static function build(string $project, string $healthCheck, \Google\Cloud * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -167,7 +187,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -188,7 +218,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/PatchImageRequest.php b/Compute/src/V1/PatchImageRequest.php index 2a41a36275c7..5d8a6ae251ca 100644 --- a/Compute/src/V1/PatchImageRequest.php +++ b/Compute/src/V1/PatchImageRequest.php @@ -34,7 +34,17 @@ class PatchImageRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -70,7 +80,17 @@ public static function build(string $project, string $image, \Google\Cloud\Compu * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -167,7 +187,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -188,7 +218,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/PatchInstanceGroupManagerRequest.php b/Compute/src/V1/PatchInstanceGroupManagerRequest.php index b1381bef8f5b..5a488d26cc88 100644 --- a/Compute/src/V1/PatchInstanceGroupManagerRequest.php +++ b/Compute/src/V1/PatchInstanceGroupManagerRequest.php @@ -34,13 +34,24 @@ class PatchInstanceGroupManagerRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ protected $request_id = null; /** - * The name of the zone where you want to create the managed instance group. + * The name of the zone where + * you want to create the managed instance group. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; */ @@ -48,7 +59,8 @@ class PatchInstanceGroupManagerRequest extends \Google\Protobuf\Internal\Message /** * @param string $project Project ID for this request. - * @param string $zone The name of the zone where you want to create the managed instance group. + * @param string $zone The name of the zone where + * you want to create the managed instance group. * @param string $instanceGroupManager The name of the instance group manager. * @param \Google\Cloud\Compute\V1\InstanceGroupManager $instanceGroupManagerResource The body resource for this request * @@ -78,9 +90,20 @@ public static function build(string $project, string $zone, string $instanceGrou * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $zone - * The name of the zone where you want to create the managed instance group. + * The name of the zone where + * you want to create the managed instance group. * } */ public function __construct($data = NULL) { @@ -177,7 +200,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -198,7 +231,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var @@ -213,7 +256,8 @@ public function setRequestId($var) } /** - * The name of the zone where you want to create the managed instance group. + * The name of the zone where + * you want to create the managed instance group. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; * @return string @@ -224,7 +268,8 @@ public function getZone() } /** - * The name of the zone where you want to create the managed instance group. + * The name of the zone where + * you want to create the managed instance group. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; * @param string $var diff --git a/Compute/src/V1/PatchInstanceSettingRequest.php b/Compute/src/V1/PatchInstanceSettingRequest.php index 864daf542411..fc900feb2bb3 100644 --- a/Compute/src/V1/PatchInstanceSettingRequest.php +++ b/Compute/src/V1/PatchInstanceSettingRequest.php @@ -28,7 +28,17 @@ class PatchInstanceSettingRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -74,7 +84,17 @@ public static function build(string $project, string $zone, \Google\Cloud\Comput * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $update_mask * update_mask indicates fields to be updated as part of this request. * @type string $zone @@ -149,7 +169,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -170,7 +200,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/PatchInterconnectAttachmentGroupRequest.php b/Compute/src/V1/PatchInterconnectAttachmentGroupRequest.php index 50d6beefeb96..404c4c60d6d1 100644 --- a/Compute/src/V1/PatchInterconnectAttachmentGroupRequest.php +++ b/Compute/src/V1/PatchInterconnectAttachmentGroupRequest.php @@ -34,7 +34,18 @@ class PatchInterconnectAttachmentGroupRequest extends \Google\Protobuf\Internal\ */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). end_interface: MixerMutationRequestBuilder + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). + * end_interface: MixerMutationRequestBuilder * * Generated from protobuf field optional string request_id = 37109963; */ @@ -76,7 +87,18 @@ public static function build(string $project, string $interconnectAttachmentGrou * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). end_interface: MixerMutationRequestBuilder + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). + * end_interface: MixerMutationRequestBuilder * @type string $update_mask * The list of fields to update. * } @@ -175,7 +197,18 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). end_interface: MixerMutationRequestBuilder + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). + * end_interface: MixerMutationRequestBuilder * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -196,7 +229,18 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). end_interface: MixerMutationRequestBuilder + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). + * end_interface: MixerMutationRequestBuilder * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/PatchInterconnectAttachmentRequest.php b/Compute/src/V1/PatchInterconnectAttachmentRequest.php index c8d5c15df398..c4cc1fb56842 100644 --- a/Compute/src/V1/PatchInterconnectAttachmentRequest.php +++ b/Compute/src/V1/PatchInterconnectAttachmentRequest.php @@ -40,7 +40,17 @@ class PatchInterconnectAttachmentRequest extends \Google\Protobuf\Internal\Messa */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -80,7 +90,17 @@ public static function build(string $project, string $region, string $interconne * @type string $region * Name of the region scoping this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -203,7 +223,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -224,7 +254,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/PatchInterconnectGroupRequest.php b/Compute/src/V1/PatchInterconnectGroupRequest.php index 7312fcfa5542..cce22d5bf19f 100644 --- a/Compute/src/V1/PatchInterconnectGroupRequest.php +++ b/Compute/src/V1/PatchInterconnectGroupRequest.php @@ -34,7 +34,18 @@ class PatchInterconnectGroupRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). end_interface: MixerMutationRequestBuilder + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). + * end_interface: MixerMutationRequestBuilder * * Generated from protobuf field optional string request_id = 37109963; */ @@ -76,7 +87,18 @@ public static function build(string $project, string $interconnectGroup, \Google * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). end_interface: MixerMutationRequestBuilder + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). + * end_interface: MixerMutationRequestBuilder * @type string $update_mask * The list of fields to update. * } @@ -175,7 +197,18 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). end_interface: MixerMutationRequestBuilder + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). + * end_interface: MixerMutationRequestBuilder * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -196,7 +229,18 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). end_interface: MixerMutationRequestBuilder + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). + * end_interface: MixerMutationRequestBuilder * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/PatchInterconnectRequest.php b/Compute/src/V1/PatchInterconnectRequest.php index 38e58b0a39ca..0c0f5ae85fc6 100644 --- a/Compute/src/V1/PatchInterconnectRequest.php +++ b/Compute/src/V1/PatchInterconnectRequest.php @@ -34,7 +34,17 @@ class PatchInterconnectRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -70,7 +80,17 @@ public static function build(string $project, string $interconnect, \Google\Clou * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -167,7 +187,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -188,7 +218,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/PatchNetworkAttachmentRequest.php b/Compute/src/V1/PatchNetworkAttachmentRequest.php index 83c50305d289..7074079d3320 100644 --- a/Compute/src/V1/PatchNetworkAttachmentRequest.php +++ b/Compute/src/V1/PatchNetworkAttachmentRequest.php @@ -40,7 +40,18 @@ class PatchNetworkAttachmentRequest extends \Google\Protobuf\Internal\Message */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). end_interface: MixerMutationRequestBuilder + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). + * end_interface: MixerMutationRequestBuilder * * Generated from protobuf field optional string request_id = 37109963; */ @@ -80,7 +91,18 @@ public static function build(string $project, string $region, string $networkAtt * @type string $region * Name of the region for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). end_interface: MixerMutationRequestBuilder + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). + * end_interface: MixerMutationRequestBuilder * } */ public function __construct($data = NULL) { @@ -203,7 +225,18 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). end_interface: MixerMutationRequestBuilder + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). + * end_interface: MixerMutationRequestBuilder * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -224,7 +257,18 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). end_interface: MixerMutationRequestBuilder + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). + * end_interface: MixerMutationRequestBuilder * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/PatchNetworkEdgeSecurityServiceRequest.php b/Compute/src/V1/PatchNetworkEdgeSecurityServiceRequest.php index 6919f1f5773d..bc2f52f4f90c 100644 --- a/Compute/src/V1/PatchNetworkEdgeSecurityServiceRequest.php +++ b/Compute/src/V1/PatchNetworkEdgeSecurityServiceRequest.php @@ -44,7 +44,17 @@ class PatchNetworkEdgeSecurityServiceRequest extends \Google\Protobuf\Internal\M */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -91,7 +101,17 @@ public static function build(string $project, string $region, string $networkEdg * @type string $region * Name of the region scoping this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $update_mask * Indicates fields to be updated as part of this request. * } @@ -248,7 +268,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -269,7 +299,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/PatchNetworkFirewallPolicyRequest.php b/Compute/src/V1/PatchNetworkFirewallPolicyRequest.php index 1adc5a6116d4..60a6dfd38a31 100644 --- a/Compute/src/V1/PatchNetworkFirewallPolicyRequest.php +++ b/Compute/src/V1/PatchNetworkFirewallPolicyRequest.php @@ -34,7 +34,17 @@ class PatchNetworkFirewallPolicyRequest extends \Google\Protobuf\Internal\Messag */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -70,7 +80,17 @@ public static function build(string $project, string $firewallPolicy, \Google\Cl * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -167,7 +187,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -188,7 +218,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/PatchNetworkRequest.php b/Compute/src/V1/PatchNetworkRequest.php index 566277d28787..731734e9b02b 100644 --- a/Compute/src/V1/PatchNetworkRequest.php +++ b/Compute/src/V1/PatchNetworkRequest.php @@ -34,7 +34,17 @@ class PatchNetworkRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -70,7 +80,17 @@ public static function build(string $project, string $network, \Google\Cloud\Com * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -167,7 +187,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -188,7 +218,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/PatchNodeGroupRequest.php b/Compute/src/V1/PatchNodeGroupRequest.php index c6f5a77ede8c..accd79274f26 100644 --- a/Compute/src/V1/PatchNodeGroupRequest.php +++ b/Compute/src/V1/PatchNodeGroupRequest.php @@ -34,7 +34,17 @@ class PatchNodeGroupRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -78,7 +88,17 @@ public static function build(string $project, string $zone, string $nodeGroup, \ * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $zone * The name of the zone for this request. * } @@ -177,7 +197,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -198,7 +228,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/PatchOrganizationSecurityPolicyRequest.php b/Compute/src/V1/PatchOrganizationSecurityPolicyRequest.php index 6ed50a074231..23a51c49dadf 100644 --- a/Compute/src/V1/PatchOrganizationSecurityPolicyRequest.php +++ b/Compute/src/V1/PatchOrganizationSecurityPolicyRequest.php @@ -16,7 +16,17 @@ class PatchOrganizationSecurityPolicyRequest extends \Google\Protobuf\Internal\Message { /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -56,7 +66,17 @@ public static function build(string $securityPolicy, \Google\Cloud\Compute\V1\Se * Optional. Data for populating the Message object. * * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $security_policy * Name of the security policy to update. * @type \Google\Cloud\Compute\V1\SecurityPolicy $security_policy_resource @@ -69,7 +89,17 @@ public function __construct($data = NULL) { } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -90,7 +120,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/PatchPacketMirroringRequest.php b/Compute/src/V1/PatchPacketMirroringRequest.php index a9764a6b176e..00f0f9295711 100644 --- a/Compute/src/V1/PatchPacketMirroringRequest.php +++ b/Compute/src/V1/PatchPacketMirroringRequest.php @@ -40,7 +40,17 @@ class PatchPacketMirroringRequest extends \Google\Protobuf\Internal\Message */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -80,7 +90,17 @@ public static function build(string $project, string $region, string $packetMirr * @type string $region * Name of the region for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -203,7 +223,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -224,7 +254,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/PatchPacketMirroringRuleNetworkFirewallPolicyRequest.php b/Compute/src/V1/PatchPacketMirroringRuleNetworkFirewallPolicyRequest.php index efc4a7ea7cb3..6ee4756bb2c2 100644 --- a/Compute/src/V1/PatchPacketMirroringRuleNetworkFirewallPolicyRequest.php +++ b/Compute/src/V1/PatchPacketMirroringRuleNetworkFirewallPolicyRequest.php @@ -40,7 +40,17 @@ class PatchPacketMirroringRuleNetworkFirewallPolicyRequest extends \Google\Proto */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -78,7 +88,17 @@ public static function build(string $project, string $firewallPolicy, \Google\Cl * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -211,7 +231,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -232,7 +262,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/PatchPerInstanceConfigsInstanceGroupManagerRequest.php b/Compute/src/V1/PatchPerInstanceConfigsInstanceGroupManagerRequest.php index 15a8f7d8f243..433c566891d8 100644 --- a/Compute/src/V1/PatchPerInstanceConfigsInstanceGroupManagerRequest.php +++ b/Compute/src/V1/PatchPerInstanceConfigsInstanceGroupManagerRequest.php @@ -16,7 +16,8 @@ class PatchPerInstanceConfigsInstanceGroupManagerRequest extends \Google\Protobuf\Internal\Message { /** - * The name of the managed instance group. It should conform to RFC1035. + * The name of the managed instance group. + * It should conform to RFC1035. * * Generated from protobuf field string instance_group_manager = 249363395 [(.google.api.field_behavior) = REQUIRED]; */ @@ -34,13 +35,25 @@ class PatchPerInstanceConfigsInstanceGroupManagerRequest extends \Google\Protobu */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ protected $request_id = null; /** - * The name of the zone where the managed instance group is located. It should conform to RFC1035. + * The name of thezone + * where the managed instance group is located. + * It should conform to RFC1035. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; */ @@ -48,8 +61,11 @@ class PatchPerInstanceConfigsInstanceGroupManagerRequest extends \Google\Protobu /** * @param string $project Project ID for this request. - * @param string $zone The name of the zone where the managed instance group is located. It should conform to RFC1035. - * @param string $instanceGroupManager The name of the managed instance group. It should conform to RFC1035. + * @param string $zone The name of thezone + * where the managed instance group is located. + * It should conform to RFC1035. + * @param string $instanceGroupManager The name of the managed instance group. + * It should conform to RFC1035. * @param \Google\Cloud\Compute\V1\InstanceGroupManagersPatchPerInstanceConfigsReq $instanceGroupManagersPatchPerInstanceConfigsReqResource The body resource for this request * * @return \Google\Cloud\Compute\V1\PatchPerInstanceConfigsInstanceGroupManagerRequest @@ -72,15 +88,28 @@ public static function build(string $project, string $zone, string $instanceGrou * Optional. Data for populating the Message object. * * @type string $instance_group_manager - * The name of the managed instance group. It should conform to RFC1035. + * The name of the managed instance group. + * It should conform to RFC1035. * @type \Google\Cloud\Compute\V1\InstanceGroupManagersPatchPerInstanceConfigsReq $instance_group_managers_patch_per_instance_configs_req_resource * The body resource for this request * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $zone - * The name of the zone where the managed instance group is located. It should conform to RFC1035. + * The name of thezone + * where the managed instance group is located. + * It should conform to RFC1035. * } */ public function __construct($data = NULL) { @@ -89,7 +118,8 @@ public function __construct($data = NULL) { } /** - * The name of the managed instance group. It should conform to RFC1035. + * The name of the managed instance group. + * It should conform to RFC1035. * * Generated from protobuf field string instance_group_manager = 249363395 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -100,7 +130,8 @@ public function getInstanceGroupManager() } /** - * The name of the managed instance group. It should conform to RFC1035. + * The name of the managed instance group. + * It should conform to RFC1035. * * Generated from protobuf field string instance_group_manager = 249363395 [(.google.api.field_behavior) = REQUIRED]; * @param string $var @@ -177,7 +208,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -198,7 +239,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var @@ -213,7 +264,9 @@ public function setRequestId($var) } /** - * The name of the zone where the managed instance group is located. It should conform to RFC1035. + * The name of thezone + * where the managed instance group is located. + * It should conform to RFC1035. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; * @return string @@ -224,7 +277,9 @@ public function getZone() } /** - * The name of the zone where the managed instance group is located. It should conform to RFC1035. + * The name of thezone + * where the managed instance group is located. + * It should conform to RFC1035. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; * @param string $var diff --git a/Compute/src/V1/PatchPerInstanceConfigsRegionInstanceGroupManagerRequest.php b/Compute/src/V1/PatchPerInstanceConfigsRegionInstanceGroupManagerRequest.php index 5b4e5e3cfd81..7e1a2002579a 100644 --- a/Compute/src/V1/PatchPerInstanceConfigsRegionInstanceGroupManagerRequest.php +++ b/Compute/src/V1/PatchPerInstanceConfigsRegionInstanceGroupManagerRequest.php @@ -16,7 +16,8 @@ class PatchPerInstanceConfigsRegionInstanceGroupManagerRequest extends \Google\Protobuf\Internal\Message { /** - * The name of the managed instance group. It should conform to RFC1035. + * The name of the managed instance group. + * It should conform to RFC1035. * * Generated from protobuf field string instance_group_manager = 249363395 [(.google.api.field_behavior) = REQUIRED]; */ @@ -40,7 +41,17 @@ class PatchPerInstanceConfigsRegionInstanceGroupManagerRequest extends \Google\P */ protected $region_instance_group_manager_patch_instance_config_req_resource = null; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -49,7 +60,8 @@ class PatchPerInstanceConfigsRegionInstanceGroupManagerRequest extends \Google\P /** * @param string $project Project ID for this request. * @param string $region Name of the region scoping this request, should conform to RFC1035. - * @param string $instanceGroupManager The name of the managed instance group. It should conform to RFC1035. + * @param string $instanceGroupManager The name of the managed instance group. + * It should conform to RFC1035. * @param \Google\Cloud\Compute\V1\RegionInstanceGroupManagerPatchInstanceConfigReq $regionInstanceGroupManagerPatchInstanceConfigReqResource The body resource for this request * * @return \Google\Cloud\Compute\V1\PatchPerInstanceConfigsRegionInstanceGroupManagerRequest @@ -72,7 +84,8 @@ public static function build(string $project, string $region, string $instanceGr * Optional. Data for populating the Message object. * * @type string $instance_group_manager - * The name of the managed instance group. It should conform to RFC1035. + * The name of the managed instance group. + * It should conform to RFC1035. * @type string $project * Project ID for this request. * @type string $region @@ -80,7 +93,17 @@ public static function build(string $project, string $region, string $instanceGr * @type \Google\Cloud\Compute\V1\RegionInstanceGroupManagerPatchInstanceConfigReq $region_instance_group_manager_patch_instance_config_req_resource * The body resource for this request * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -89,7 +112,8 @@ public function __construct($data = NULL) { } /** - * The name of the managed instance group. It should conform to RFC1035. + * The name of the managed instance group. + * It should conform to RFC1035. * * Generated from protobuf field string instance_group_manager = 249363395 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -100,7 +124,8 @@ public function getInstanceGroupManager() } /** - * The name of the managed instance group. It should conform to RFC1035. + * The name of the managed instance group. + * It should conform to RFC1035. * * Generated from protobuf field string instance_group_manager = 249363395 [(.google.api.field_behavior) = REQUIRED]; * @param string $var @@ -203,7 +228,17 @@ public function setRegionInstanceGroupManagerPatchInstanceConfigReqResource($var } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -224,7 +259,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/PatchPublicAdvertisedPrefixeRequest.php b/Compute/src/V1/PatchPublicAdvertisedPrefixeRequest.php index 9d9ae5eff171..91a7ee35bd0c 100644 --- a/Compute/src/V1/PatchPublicAdvertisedPrefixeRequest.php +++ b/Compute/src/V1/PatchPublicAdvertisedPrefixeRequest.php @@ -34,7 +34,17 @@ class PatchPublicAdvertisedPrefixeRequest extends \Google\Protobuf\Internal\Mess */ protected $public_advertised_prefix_resource = null; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -70,7 +80,17 @@ public static function build(string $project, string $publicAdvertisedPrefix, \G * @type \Google\Cloud\Compute\V1\PublicAdvertisedPrefix $public_advertised_prefix_resource * The body resource for this request * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -167,7 +187,17 @@ public function setPublicAdvertisedPrefixResource($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -188,7 +218,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/PatchPublicDelegatedPrefixeRequest.php b/Compute/src/V1/PatchPublicDelegatedPrefixeRequest.php index c491ea01e575..97e88c9bbe94 100644 --- a/Compute/src/V1/PatchPublicDelegatedPrefixeRequest.php +++ b/Compute/src/V1/PatchPublicDelegatedPrefixeRequest.php @@ -40,7 +40,17 @@ class PatchPublicDelegatedPrefixeRequest extends \Google\Protobuf\Internal\Messa */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -80,7 +90,17 @@ public static function build(string $project, string $region, string $publicDele * @type string $region * Name of the region for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -203,7 +223,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -224,7 +254,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/PatchRegionAutoscalerRequest.php b/Compute/src/V1/PatchRegionAutoscalerRequest.php index 8ac1b4aaa6d0..54712d7492d8 100644 --- a/Compute/src/V1/PatchRegionAutoscalerRequest.php +++ b/Compute/src/V1/PatchRegionAutoscalerRequest.php @@ -40,7 +40,17 @@ class PatchRegionAutoscalerRequest extends \Google\Protobuf\Internal\Message */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -78,7 +88,17 @@ public static function build(string $project, string $region, \Google\Cloud\Comp * @type string $region * Name of the region scoping this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -211,7 +231,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -232,7 +262,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/PatchRegionBackendServiceRequest.php b/Compute/src/V1/PatchRegionBackendServiceRequest.php index 8f0ca79539c5..6ec7b0a89cd4 100644 --- a/Compute/src/V1/PatchRegionBackendServiceRequest.php +++ b/Compute/src/V1/PatchRegionBackendServiceRequest.php @@ -40,7 +40,17 @@ class PatchRegionBackendServiceRequest extends \Google\Protobuf\Internal\Message */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -80,7 +90,17 @@ public static function build(string $project, string $region, string $backendSer * @type string $region * Name of the region scoping this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -203,7 +223,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -224,7 +254,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/PatchRegionHealthCheckRequest.php b/Compute/src/V1/PatchRegionHealthCheckRequest.php index bfa319156d75..3d0eccffde79 100644 --- a/Compute/src/V1/PatchRegionHealthCheckRequest.php +++ b/Compute/src/V1/PatchRegionHealthCheckRequest.php @@ -40,7 +40,17 @@ class PatchRegionHealthCheckRequest extends \Google\Protobuf\Internal\Message */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -80,7 +90,17 @@ public static function build(string $project, string $region, string $healthChec * @type string $region * Name of the region scoping this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -203,7 +223,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -224,7 +254,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/PatchRegionHealthCheckServiceRequest.php b/Compute/src/V1/PatchRegionHealthCheckServiceRequest.php index 37c5400938de..10d5506c1d15 100644 --- a/Compute/src/V1/PatchRegionHealthCheckServiceRequest.php +++ b/Compute/src/V1/PatchRegionHealthCheckServiceRequest.php @@ -16,7 +16,8 @@ class PatchRegionHealthCheckServiceRequest extends \Google\Protobuf\Internal\Message { /** - * Name of the HealthCheckService to update. The name must be 1-63 characters long, and comply with RFC1035. + * Name of the HealthCheckService to update. The name + * must be 1-63 characters long, and comply with RFC1035. * * Generated from protobuf field string health_check_service = 408374747 [(.google.api.field_behavior) = REQUIRED]; */ @@ -40,7 +41,17 @@ class PatchRegionHealthCheckServiceRequest extends \Google\Protobuf\Internal\Mes */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -49,7 +60,8 @@ class PatchRegionHealthCheckServiceRequest extends \Google\Protobuf\Internal\Mes /** * @param string $project Project ID for this request. * @param string $region Name of the region scoping this request. - * @param string $healthCheckService Name of the HealthCheckService to update. The name must be 1-63 characters long, and comply with RFC1035. + * @param string $healthCheckService Name of the HealthCheckService to update. The name + * must be 1-63 characters long, and comply with RFC1035. * @param \Google\Cloud\Compute\V1\HealthCheckService $healthCheckServiceResource The body resource for this request * * @return \Google\Cloud\Compute\V1\PatchRegionHealthCheckServiceRequest @@ -72,7 +84,8 @@ public static function build(string $project, string $region, string $healthChec * Optional. Data for populating the Message object. * * @type string $health_check_service - * Name of the HealthCheckService to update. The name must be 1-63 characters long, and comply with RFC1035. + * Name of the HealthCheckService to update. The name + * must be 1-63 characters long, and comply with RFC1035. * @type \Google\Cloud\Compute\V1\HealthCheckService $health_check_service_resource * The body resource for this request * @type string $project @@ -80,7 +93,17 @@ public static function build(string $project, string $region, string $healthChec * @type string $region * Name of the region scoping this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -89,7 +112,8 @@ public function __construct($data = NULL) { } /** - * Name of the HealthCheckService to update. The name must be 1-63 characters long, and comply with RFC1035. + * Name of the HealthCheckService to update. The name + * must be 1-63 characters long, and comply with RFC1035. * * Generated from protobuf field string health_check_service = 408374747 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -100,7 +124,8 @@ public function getHealthCheckService() } /** - * Name of the HealthCheckService to update. The name must be 1-63 characters long, and comply with RFC1035. + * Name of the HealthCheckService to update. The name + * must be 1-63 characters long, and comply with RFC1035. * * Generated from protobuf field string health_check_service = 408374747 [(.google.api.field_behavior) = REQUIRED]; * @param string $var @@ -203,7 +228,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -224,7 +259,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/PatchRegionInstanceGroupManagerRequest.php b/Compute/src/V1/PatchRegionInstanceGroupManagerRequest.php index b2ea9d2f7e82..d7315fc1a0c8 100644 --- a/Compute/src/V1/PatchRegionInstanceGroupManagerRequest.php +++ b/Compute/src/V1/PatchRegionInstanceGroupManagerRequest.php @@ -40,7 +40,17 @@ class PatchRegionInstanceGroupManagerRequest extends \Google\Protobuf\Internal\M */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -80,7 +90,17 @@ public static function build(string $project, string $region, string $instanceGr * @type string $region * Name of the region scoping this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -203,7 +223,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -224,7 +254,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/PatchRegionNetworkFirewallPolicyRequest.php b/Compute/src/V1/PatchRegionNetworkFirewallPolicyRequest.php index acec419ffbdc..0dd6f63294ff 100644 --- a/Compute/src/V1/PatchRegionNetworkFirewallPolicyRequest.php +++ b/Compute/src/V1/PatchRegionNetworkFirewallPolicyRequest.php @@ -40,7 +40,17 @@ class PatchRegionNetworkFirewallPolicyRequest extends \Google\Protobuf\Internal\ */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -80,7 +90,17 @@ public static function build(string $project, string $region, string $firewallPo * @type string $region * Name of the region scoping this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -203,7 +223,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -224,7 +254,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/PatchRegionSecurityPolicyRequest.php b/Compute/src/V1/PatchRegionSecurityPolicyRequest.php index 072b5d22d11d..04f0288312ca 100644 --- a/Compute/src/V1/PatchRegionSecurityPolicyRequest.php +++ b/Compute/src/V1/PatchRegionSecurityPolicyRequest.php @@ -28,7 +28,17 @@ class PatchRegionSecurityPolicyRequest extends \Google\Protobuf\Internal\Message */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -82,7 +92,17 @@ public static function build(string $project, string $region, string $securityPo * @type string $region * Name of the region scoping this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $security_policy * Name of the security policy to update. * @type \Google\Cloud\Compute\V1\SecurityPolicy $security_policy_resource @@ -149,7 +169,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -170,7 +200,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/PatchRegionSslPolicyRequest.php b/Compute/src/V1/PatchRegionSslPolicyRequest.php index 6a29b5612717..5ead92a8b548 100644 --- a/Compute/src/V1/PatchRegionSslPolicyRequest.php +++ b/Compute/src/V1/PatchRegionSslPolicyRequest.php @@ -28,13 +28,24 @@ class PatchRegionSslPolicyRequest extends \Google\Protobuf\Internal\Message */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ protected $request_id = null; /** - * Name of the SSL policy to update. The name must be 1-63 characters long, and comply with RFC1035. + * Name of the SSL policy to update. The name must be 1-63 characters long, + * and comply with RFC1035. * * Generated from protobuf field string ssl_policy = 295190213 [(.google.api.field_behavior) = REQUIRED]; */ @@ -49,7 +60,8 @@ class PatchRegionSslPolicyRequest extends \Google\Protobuf\Internal\Message /** * @param string $project Project ID for this request. * @param string $region Name of the region scoping this request. - * @param string $sslPolicy Name of the SSL policy to update. The name must be 1-63 characters long, and comply with RFC1035. + * @param string $sslPolicy Name of the SSL policy to update. The name must be 1-63 characters long, + * and comply with RFC1035. * @param \Google\Cloud\Compute\V1\SslPolicy $sslPolicyResource The body resource for this request * * @return \Google\Cloud\Compute\V1\PatchRegionSslPolicyRequest @@ -76,9 +88,20 @@ public static function build(string $project, string $region, string $sslPolicy, * @type string $region * Name of the region scoping this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $ssl_policy - * Name of the SSL policy to update. The name must be 1-63 characters long, and comply with RFC1035. + * Name of the SSL policy to update. The name must be 1-63 characters long, + * and comply with RFC1035. * @type \Google\Cloud\Compute\V1\SslPolicy $ssl_policy_resource * The body resource for this request * } @@ -141,7 +164,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -162,7 +195,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var @@ -177,7 +220,8 @@ public function setRequestId($var) } /** - * Name of the SSL policy to update. The name must be 1-63 characters long, and comply with RFC1035. + * Name of the SSL policy to update. The name must be 1-63 characters long, + * and comply with RFC1035. * * Generated from protobuf field string ssl_policy = 295190213 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -188,7 +232,8 @@ public function getSslPolicy() } /** - * Name of the SSL policy to update. The name must be 1-63 characters long, and comply with RFC1035. + * Name of the SSL policy to update. The name must be 1-63 characters long, + * and comply with RFC1035. * * Generated from protobuf field string ssl_policy = 295190213 [(.google.api.field_behavior) = REQUIRED]; * @param string $var diff --git a/Compute/src/V1/PatchRegionTargetHttpsProxyRequest.php b/Compute/src/V1/PatchRegionTargetHttpsProxyRequest.php index acc635712e9a..316f8631d23d 100644 --- a/Compute/src/V1/PatchRegionTargetHttpsProxyRequest.php +++ b/Compute/src/V1/PatchRegionTargetHttpsProxyRequest.php @@ -28,7 +28,17 @@ class PatchRegionTargetHttpsProxyRequest extends \Google\Protobuf\Internal\Messa */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -76,7 +86,17 @@ public static function build(string $project, string $region, string $targetHttp * @type string $region * Name of the region for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $target_https_proxy * Name of the TargetHttpsProxy resource to patch. * @type \Google\Cloud\Compute\V1\TargetHttpsProxy $target_https_proxy_resource @@ -141,7 +161,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -162,7 +192,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/PatchRegionUrlMapRequest.php b/Compute/src/V1/PatchRegionUrlMapRequest.php index 88da7e5b91fe..4a1c567b05d9 100644 --- a/Compute/src/V1/PatchRegionUrlMapRequest.php +++ b/Compute/src/V1/PatchRegionUrlMapRequest.php @@ -28,7 +28,8 @@ class PatchRegionUrlMapRequest extends \Google\Protobuf\Internal\Message */ protected $region = ''; /** - * begin_interface: MixerMutationRequestBuilder Request ID to support idempotency. + * begin_interface: MixerMutationRequestBuilder + * Request ID to support idempotency. * * Generated from protobuf field optional string request_id = 37109963; */ @@ -76,7 +77,8 @@ public static function build(string $project, string $region, string $urlMap, \G * @type string $region * Name of the region scoping this request. * @type string $request_id - * begin_interface: MixerMutationRequestBuilder Request ID to support idempotency. + * begin_interface: MixerMutationRequestBuilder + * Request ID to support idempotency. * @type string $url_map * Name of the UrlMap resource to patch. * @type \Google\Cloud\Compute\V1\UrlMap $url_map_resource @@ -141,7 +143,8 @@ public function setRegion($var) } /** - * begin_interface: MixerMutationRequestBuilder Request ID to support idempotency. + * begin_interface: MixerMutationRequestBuilder + * Request ID to support idempotency. * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -162,7 +165,8 @@ public function clearRequestId() } /** - * begin_interface: MixerMutationRequestBuilder Request ID to support idempotency. + * begin_interface: MixerMutationRequestBuilder + * Request ID to support idempotency. * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/PatchResourcePolicyRequest.php b/Compute/src/V1/PatchResourcePolicyRequest.php index 78c668025f25..0d2c660d961d 100644 --- a/Compute/src/V1/PatchResourcePolicyRequest.php +++ b/Compute/src/V1/PatchResourcePolicyRequest.php @@ -28,7 +28,17 @@ class PatchResourcePolicyRequest extends \Google\Protobuf\Internal\Message */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -82,7 +92,17 @@ public static function build(string $project, string $region, string $resourcePo * @type string $region * Name of the region for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $resource_policy * Id of the resource policy to patch. * @type \Google\Cloud\Compute\V1\ResourcePolicy $resource_policy_resource @@ -149,7 +169,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -170,7 +200,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/PatchRoutePolicyRouterRequest.php b/Compute/src/V1/PatchRoutePolicyRouterRequest.php index 7efa54170e12..026c1c79531c 100644 --- a/Compute/src/V1/PatchRoutePolicyRouterRequest.php +++ b/Compute/src/V1/PatchRoutePolicyRouterRequest.php @@ -28,7 +28,17 @@ class PatchRoutePolicyRouterRequest extends \Google\Protobuf\Internal\Message */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -76,7 +86,17 @@ public static function build(string $project, string $region, string $router, \G * @type string $region * Name of the region for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type \Google\Cloud\Compute\V1\RoutePolicy $route_policy_resource * The body resource for this request * @type string $router @@ -141,7 +161,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -162,7 +192,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/PatchRouterRequest.php b/Compute/src/V1/PatchRouterRequest.php index e3bdcd3c4e89..aa4e5786303b 100644 --- a/Compute/src/V1/PatchRouterRequest.php +++ b/Compute/src/V1/PatchRouterRequest.php @@ -28,7 +28,17 @@ class PatchRouterRequest extends \Google\Protobuf\Internal\Message */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -76,7 +86,17 @@ public static function build(string $project, string $region, string $router, \G * @type string $region * Name of the region for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $router * Name of the Router resource to patch. * @type \Google\Cloud\Compute\V1\Router $router_resource @@ -141,7 +161,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -162,7 +192,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/PatchRuleFirewallPolicyRequest.php b/Compute/src/V1/PatchRuleFirewallPolicyRequest.php index 24cb334fd0ed..af8f28e2b68c 100644 --- a/Compute/src/V1/PatchRuleFirewallPolicyRequest.php +++ b/Compute/src/V1/PatchRuleFirewallPolicyRequest.php @@ -34,7 +34,17 @@ class PatchRuleFirewallPolicyRequest extends \Google\Protobuf\Internal\Message */ protected $priority = null; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -68,7 +78,17 @@ public static function build(string $firewallPolicy, \Google\Cloud\Compute\V1\Fi * @type int $priority * The priority of the rule to patch. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -175,7 +195,17 @@ public function setPriority($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -196,7 +226,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/PatchRuleNetworkFirewallPolicyRequest.php b/Compute/src/V1/PatchRuleNetworkFirewallPolicyRequest.php index 343492b71d4d..5c17f299ecc4 100644 --- a/Compute/src/V1/PatchRuleNetworkFirewallPolicyRequest.php +++ b/Compute/src/V1/PatchRuleNetworkFirewallPolicyRequest.php @@ -40,7 +40,17 @@ class PatchRuleNetworkFirewallPolicyRequest extends \Google\Protobuf\Internal\Me */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -78,7 +88,17 @@ public static function build(string $project, string $firewallPolicy, \Google\Cl * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -211,7 +231,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -232,7 +262,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/PatchRuleOrganizationSecurityPolicyRequest.php b/Compute/src/V1/PatchRuleOrganizationSecurityPolicyRequest.php index d9bd3b3019ab..5abd5821f39c 100644 --- a/Compute/src/V1/PatchRuleOrganizationSecurityPolicyRequest.php +++ b/Compute/src/V1/PatchRuleOrganizationSecurityPolicyRequest.php @@ -22,7 +22,17 @@ class PatchRuleOrganizationSecurityPolicyRequest extends \Google\Protobuf\Intern */ protected $priority = null; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -64,7 +74,17 @@ public static function build(string $securityPolicy, \Google\Cloud\Compute\V1\Se * @type int $priority * The priority of the rule to patch. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $security_policy * Name of the security policy to update. * @type \Google\Cloud\Compute\V1\SecurityPolicyRule $security_policy_rule_resource @@ -113,7 +133,17 @@ public function setPriority($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -134,7 +164,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/PatchRuleRegionNetworkFirewallPolicyRequest.php b/Compute/src/V1/PatchRuleRegionNetworkFirewallPolicyRequest.php index 0633be72eef7..28b52fb67103 100644 --- a/Compute/src/V1/PatchRuleRegionNetworkFirewallPolicyRequest.php +++ b/Compute/src/V1/PatchRuleRegionNetworkFirewallPolicyRequest.php @@ -46,7 +46,17 @@ class PatchRuleRegionNetworkFirewallPolicyRequest extends \Google\Protobuf\Inter */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -88,7 +98,17 @@ public static function build(string $project, string $region, string $firewallPo * @type string $region * Name of the region scoping this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -247,7 +267,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -268,7 +298,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/PatchSecurityPolicyRequest.php b/Compute/src/V1/PatchSecurityPolicyRequest.php index 0bc6b218bc3e..421f59c95048 100644 --- a/Compute/src/V1/PatchSecurityPolicyRequest.php +++ b/Compute/src/V1/PatchSecurityPolicyRequest.php @@ -22,7 +22,17 @@ class PatchSecurityPolicyRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -72,7 +82,17 @@ public static function build(string $project, string $securityPolicy, \Google\Cl * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $security_policy * Name of the security policy to update. * @type \Google\Cloud\Compute\V1\SecurityPolicy $security_policy_resource @@ -113,7 +133,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -134,7 +164,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/PatchServiceAttachmentRequest.php b/Compute/src/V1/PatchServiceAttachmentRequest.php index 60edd1a33114..8b71dd0f2d7b 100644 --- a/Compute/src/V1/PatchServiceAttachmentRequest.php +++ b/Compute/src/V1/PatchServiceAttachmentRequest.php @@ -28,13 +28,24 @@ class PatchServiceAttachmentRequest extends \Google\Protobuf\Internal\Message */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ protected $request_id = null; /** - * The resource id of the ServiceAttachment to patch. It should conform to RFC1035 resource name or be a string form on an unsigned long number. + * The resource id of the ServiceAttachment to patch. It should conform to + * RFC1035 resource name or be a string form on an unsigned long number. * * Generated from protobuf field string service_attachment = 338957549 [(.google.api.field_behavior) = REQUIRED]; */ @@ -49,7 +60,8 @@ class PatchServiceAttachmentRequest extends \Google\Protobuf\Internal\Message /** * @param string $project Project ID for this request. * @param string $region The region scoping this request and should conform to RFC1035. - * @param string $serviceAttachment The resource id of the ServiceAttachment to patch. It should conform to RFC1035 resource name or be a string form on an unsigned long number. + * @param string $serviceAttachment The resource id of the ServiceAttachment to patch. It should conform to + * RFC1035 resource name or be a string form on an unsigned long number. * @param \Google\Cloud\Compute\V1\ServiceAttachment $serviceAttachmentResource The body resource for this request * * @return \Google\Cloud\Compute\V1\PatchServiceAttachmentRequest @@ -76,9 +88,20 @@ public static function build(string $project, string $region, string $serviceAtt * @type string $region * The region scoping this request and should conform to RFC1035. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $service_attachment - * The resource id of the ServiceAttachment to patch. It should conform to RFC1035 resource name or be a string form on an unsigned long number. + * The resource id of the ServiceAttachment to patch. It should conform to + * RFC1035 resource name or be a string form on an unsigned long number. * @type \Google\Cloud\Compute\V1\ServiceAttachment $service_attachment_resource * The body resource for this request * } @@ -141,7 +164,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -162,7 +195,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var @@ -177,7 +220,8 @@ public function setRequestId($var) } /** - * The resource id of the ServiceAttachment to patch. It should conform to RFC1035 resource name or be a string form on an unsigned long number. + * The resource id of the ServiceAttachment to patch. It should conform to + * RFC1035 resource name or be a string form on an unsigned long number. * * Generated from protobuf field string service_attachment = 338957549 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -188,7 +232,8 @@ public function getServiceAttachment() } /** - * The resource id of the ServiceAttachment to patch. It should conform to RFC1035 resource name or be a string form on an unsigned long number. + * The resource id of the ServiceAttachment to patch. It should conform to + * RFC1035 resource name or be a string form on an unsigned long number. * * Generated from protobuf field string service_attachment = 338957549 [(.google.api.field_behavior) = REQUIRED]; * @param string $var diff --git a/Compute/src/V1/PatchSnapshotSettingRequest.php b/Compute/src/V1/PatchSnapshotSettingRequest.php index ed475c73285a..2bf53a6c9f31 100644 --- a/Compute/src/V1/PatchSnapshotSettingRequest.php +++ b/Compute/src/V1/PatchSnapshotSettingRequest.php @@ -22,7 +22,17 @@ class PatchSnapshotSettingRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -64,7 +74,17 @@ public static function build(string $project, \Google\Cloud\Compute\V1\SnapshotS * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type \Google\Cloud\Compute\V1\SnapshotSettings $snapshot_settings_resource * The body resource for this request * @type string $update_mask @@ -103,7 +123,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -124,7 +154,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/PatchSslPolicyRequest.php b/Compute/src/V1/PatchSslPolicyRequest.php index ac80a12205ac..afff2606d373 100644 --- a/Compute/src/V1/PatchSslPolicyRequest.php +++ b/Compute/src/V1/PatchSslPolicyRequest.php @@ -22,13 +22,24 @@ class PatchSslPolicyRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ protected $request_id = null; /** - * Name of the SSL policy to update. The name must be 1-63 characters long, and comply with RFC1035. + * Name of the SSL policy to update. The name must be 1-63 characters long, + * and comply with RFC1035. * * Generated from protobuf field string ssl_policy = 295190213 [(.google.api.field_behavior) = REQUIRED]; */ @@ -42,7 +53,8 @@ class PatchSslPolicyRequest extends \Google\Protobuf\Internal\Message /** * @param string $project Project ID for this request. - * @param string $sslPolicy Name of the SSL policy to update. The name must be 1-63 characters long, and comply with RFC1035. + * @param string $sslPolicy Name of the SSL policy to update. The name must be 1-63 characters long, + * and comply with RFC1035. * @param \Google\Cloud\Compute\V1\SslPolicy $sslPolicyResource The body resource for this request * * @return \Google\Cloud\Compute\V1\PatchSslPolicyRequest @@ -66,9 +78,20 @@ public static function build(string $project, string $sslPolicy, \Google\Cloud\C * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $ssl_policy - * Name of the SSL policy to update. The name must be 1-63 characters long, and comply with RFC1035. + * Name of the SSL policy to update. The name must be 1-63 characters long, + * and comply with RFC1035. * @type \Google\Cloud\Compute\V1\SslPolicy $ssl_policy_resource * The body resource for this request * } @@ -105,7 +128,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -126,7 +159,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var @@ -141,7 +184,8 @@ public function setRequestId($var) } /** - * Name of the SSL policy to update. The name must be 1-63 characters long, and comply with RFC1035. + * Name of the SSL policy to update. The name must be 1-63 characters long, + * and comply with RFC1035. * * Generated from protobuf field string ssl_policy = 295190213 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -152,7 +196,8 @@ public function getSslPolicy() } /** - * Name of the SSL policy to update. The name must be 1-63 characters long, and comply with RFC1035. + * Name of the SSL policy to update. The name must be 1-63 characters long, + * and comply with RFC1035. * * Generated from protobuf field string ssl_policy = 295190213 [(.google.api.field_behavior) = REQUIRED]; * @param string $var diff --git a/Compute/src/V1/PatchSubnetworkRequest.php b/Compute/src/V1/PatchSubnetworkRequest.php index 2a1c3e36484d..ef9502427ca4 100644 --- a/Compute/src/V1/PatchSubnetworkRequest.php +++ b/Compute/src/V1/PatchSubnetworkRequest.php @@ -16,7 +16,15 @@ class PatchSubnetworkRequest extends \Google\Protobuf\Internal\Message { /** - * The drain timeout specifies the upper bound in seconds on the amount of time allowed to drain connections from the current ACTIVE subnetwork to the current BACKUP subnetwork. The drain timeout is only applicable when the following conditions are true: - the subnetwork being patched has purpose = INTERNAL_HTTPS_LOAD_BALANCER - the subnetwork being patched has role = BACKUP - the patch request is setting the role to ACTIVE. Note that after this patch operation the roles of the ACTIVE and BACKUP subnetworks will be swapped. + * The drain timeout specifies the upper bound in seconds on the amount of + * time allowed to drain connections from the current ACTIVE subnetwork + * to the current BACKUP subnetwork. The drain timeout is only applicable + * when the following conditions are true: + * - the subnetwork being patched has purpose = INTERNAL_HTTPS_LOAD_BALANCER + * - the subnetwork being patched has role = BACKUP + * - the patch request is setting the role to ACTIVE. Note that after this + * patch operation the roles of the ACTIVE and BACKUP subnetworks will be + * swapped. * * Generated from protobuf field optional int32 drain_timeout_seconds = 357707098; */ @@ -34,7 +42,17 @@ class PatchSubnetworkRequest extends \Google\Protobuf\Internal\Message */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -78,13 +96,31 @@ public static function build(string $project, string $region, string $subnetwork * Optional. Data for populating the Message object. * * @type int $drain_timeout_seconds - * The drain timeout specifies the upper bound in seconds on the amount of time allowed to drain connections from the current ACTIVE subnetwork to the current BACKUP subnetwork. The drain timeout is only applicable when the following conditions are true: - the subnetwork being patched has purpose = INTERNAL_HTTPS_LOAD_BALANCER - the subnetwork being patched has role = BACKUP - the patch request is setting the role to ACTIVE. Note that after this patch operation the roles of the ACTIVE and BACKUP subnetworks will be swapped. + * The drain timeout specifies the upper bound in seconds on the amount of + * time allowed to drain connections from the current ACTIVE subnetwork + * to the current BACKUP subnetwork. The drain timeout is only applicable + * when the following conditions are true: + * - the subnetwork being patched has purpose = INTERNAL_HTTPS_LOAD_BALANCER + * - the subnetwork being patched has role = BACKUP + * - the patch request is setting the role to ACTIVE. Note that after this + * patch operation the roles of the ACTIVE and BACKUP subnetworks will be + * swapped. * @type string $project * Project ID for this request. * @type string $region * Name of the region scoping this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $subnetwork * Name of the Subnetwork resource to patch. * @type \Google\Cloud\Compute\V1\Subnetwork $subnetwork_resource @@ -97,7 +133,15 @@ public function __construct($data = NULL) { } /** - * The drain timeout specifies the upper bound in seconds on the amount of time allowed to drain connections from the current ACTIVE subnetwork to the current BACKUP subnetwork. The drain timeout is only applicable when the following conditions are true: - the subnetwork being patched has purpose = INTERNAL_HTTPS_LOAD_BALANCER - the subnetwork being patched has role = BACKUP - the patch request is setting the role to ACTIVE. Note that after this patch operation the roles of the ACTIVE and BACKUP subnetworks will be swapped. + * The drain timeout specifies the upper bound in seconds on the amount of + * time allowed to drain connections from the current ACTIVE subnetwork + * to the current BACKUP subnetwork. The drain timeout is only applicable + * when the following conditions are true: + * - the subnetwork being patched has purpose = INTERNAL_HTTPS_LOAD_BALANCER + * - the subnetwork being patched has role = BACKUP + * - the patch request is setting the role to ACTIVE. Note that after this + * patch operation the roles of the ACTIVE and BACKUP subnetworks will be + * swapped. * * Generated from protobuf field optional int32 drain_timeout_seconds = 357707098; * @return int @@ -118,7 +162,15 @@ public function clearDrainTimeoutSeconds() } /** - * The drain timeout specifies the upper bound in seconds on the amount of time allowed to drain connections from the current ACTIVE subnetwork to the current BACKUP subnetwork. The drain timeout is only applicable when the following conditions are true: - the subnetwork being patched has purpose = INTERNAL_HTTPS_LOAD_BALANCER - the subnetwork being patched has role = BACKUP - the patch request is setting the role to ACTIVE. Note that after this patch operation the roles of the ACTIVE and BACKUP subnetworks will be swapped. + * The drain timeout specifies the upper bound in seconds on the amount of + * time allowed to drain connections from the current ACTIVE subnetwork + * to the current BACKUP subnetwork. The drain timeout is only applicable + * when the following conditions are true: + * - the subnetwork being patched has purpose = INTERNAL_HTTPS_LOAD_BALANCER + * - the subnetwork being patched has role = BACKUP + * - the patch request is setting the role to ACTIVE. Note that after this + * patch operation the roles of the ACTIVE and BACKUP subnetworks will be + * swapped. * * Generated from protobuf field optional int32 drain_timeout_seconds = 357707098; * @param int $var @@ -185,7 +237,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -206,7 +268,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/PatchTargetGrpcProxyRequest.php b/Compute/src/V1/PatchTargetGrpcProxyRequest.php index f022fba38f8e..66b322b200ef 100644 --- a/Compute/src/V1/PatchTargetGrpcProxyRequest.php +++ b/Compute/src/V1/PatchTargetGrpcProxyRequest.php @@ -22,7 +22,17 @@ class PatchTargetGrpcProxyRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -66,7 +76,17 @@ public static function build(string $project, string $targetGrpcProxy, \Google\C * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $target_grpc_proxy * Name of the TargetGrpcProxy resource to patch. * @type \Google\Cloud\Compute\V1\TargetGrpcProxy $target_grpc_proxy_resource @@ -105,7 +125,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -126,7 +156,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/PatchTargetHttpProxyRequest.php b/Compute/src/V1/PatchTargetHttpProxyRequest.php index 23b3b49fa078..5f196d441eec 100644 --- a/Compute/src/V1/PatchTargetHttpProxyRequest.php +++ b/Compute/src/V1/PatchTargetHttpProxyRequest.php @@ -22,7 +22,17 @@ class PatchTargetHttpProxyRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -66,7 +76,17 @@ public static function build(string $project, string $targetHttpProxy, \Google\C * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $target_http_proxy * Name of the TargetHttpProxy resource to patch. * @type \Google\Cloud\Compute\V1\TargetHttpProxy $target_http_proxy_resource @@ -105,7 +125,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -126,7 +156,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/PatchTargetHttpsProxyRequest.php b/Compute/src/V1/PatchTargetHttpsProxyRequest.php index 48ffb74e8fad..32112654368a 100644 --- a/Compute/src/V1/PatchTargetHttpsProxyRequest.php +++ b/Compute/src/V1/PatchTargetHttpsProxyRequest.php @@ -22,7 +22,17 @@ class PatchTargetHttpsProxyRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -66,7 +76,17 @@ public static function build(string $project, string $targetHttpsProxy, \Google\ * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $target_https_proxy * Name of the TargetHttpsProxy resource to patch. * @type \Google\Cloud\Compute\V1\TargetHttpsProxy $target_https_proxy_resource @@ -105,7 +125,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -126,7 +156,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/PatchUrlMapRequest.php b/Compute/src/V1/PatchUrlMapRequest.php index 74477f81941c..56eab91f1311 100644 --- a/Compute/src/V1/PatchUrlMapRequest.php +++ b/Compute/src/V1/PatchUrlMapRequest.php @@ -22,7 +22,17 @@ class PatchUrlMapRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -66,7 +76,17 @@ public static function build(string $project, string $urlMap, \Google\Cloud\Comp * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $url_map * Name of the UrlMap resource to patch. * @type \Google\Cloud\Compute\V1\UrlMap $url_map_resource @@ -105,7 +125,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -126,7 +156,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/PatchWireGroupRequest.php b/Compute/src/V1/PatchWireGroupRequest.php new file mode 100644 index 000000000000..4cf915622066 --- /dev/null +++ b/Compute/src/V1/PatchWireGroupRequest.php @@ -0,0 +1,367 @@ +google.cloud.compute.v1.PatchWireGroupRequest + */ +class PatchWireGroupRequest extends \Google\Protobuf\Internal\Message +{ + /** + * Generated from protobuf field string cross_site_network = 108192469 [(.google.api.field_behavior) = REQUIRED]; + */ + protected $cross_site_network = ''; + /** + * Project ID for this request. + * + * Generated from protobuf field string project = 227560217 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "project"]; + */ + protected $project = ''; + /** + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). + * end_interface: MixerMutationRequestBuilder + * + * Generated from protobuf field optional string request_id = 37109963; + */ + protected $request_id = null; + /** + * update_mask indicates fields to be updated as part of this request. + * + * Generated from protobuf field optional string update_mask = 500079778; + */ + protected $update_mask = null; + /** + * [Input Only] Validate the new configuration, but don't update it. + * + * Generated from protobuf field optional bool validate_only = 242744629; + */ + protected $validate_only = null; + /** + * Name of the WireGroups resource to patch. + * + * Generated from protobuf field string wire_group = 122540613 [(.google.api.field_behavior) = REQUIRED]; + */ + protected $wire_group = ''; + /** + * The body resource for this request + * + * Generated from protobuf field .google.cloud.compute.v1.WireGroup wire_group_resource = 117104840 [(.google.api.field_behavior) = REQUIRED]; + */ + protected $wire_group_resource = null; + + /** + * @param string $project Project ID for this request. + * @param string $crossSiteNetwork + * @param string $wireGroup Name of the WireGroups resource to patch. + * @param \Google\Cloud\Compute\V1\WireGroup $wireGroupResource The body resource for this request + * + * @return \Google\Cloud\Compute\V1\PatchWireGroupRequest + * + * @experimental + */ + public static function build(string $project, string $crossSiteNetwork, string $wireGroup, \Google\Cloud\Compute\V1\WireGroup $wireGroupResource): self + { + return (new self()) + ->setProject($project) + ->setCrossSiteNetwork($crossSiteNetwork) + ->setWireGroup($wireGroup) + ->setWireGroupResource($wireGroupResource); + } + + /** + * Constructor. + * + * @param array $data { + * Optional. Data for populating the Message object. + * + * @type string $cross_site_network + * @type string $project + * Project ID for this request. + * @type string $request_id + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). + * end_interface: MixerMutationRequestBuilder + * @type string $update_mask + * update_mask indicates fields to be updated as part of this request. + * @type bool $validate_only + * [Input Only] Validate the new configuration, but don't update it. + * @type string $wire_group + * Name of the WireGroups resource to patch. + * @type \Google\Cloud\Compute\V1\WireGroup $wire_group_resource + * The body resource for this request + * } + */ + public function __construct($data = NULL) { + \GPBMetadata\Google\Cloud\Compute\V1\Compute::initOnce(); + parent::__construct($data); + } + + /** + * Generated from protobuf field string cross_site_network = 108192469 [(.google.api.field_behavior) = REQUIRED]; + * @return string + */ + public function getCrossSiteNetwork() + { + return $this->cross_site_network; + } + + /** + * Generated from protobuf field string cross_site_network = 108192469 [(.google.api.field_behavior) = REQUIRED]; + * @param string $var + * @return $this + */ + public function setCrossSiteNetwork($var) + { + GPBUtil::checkString($var, True); + $this->cross_site_network = $var; + + return $this; + } + + /** + * Project ID for this request. + * + * Generated from protobuf field string project = 227560217 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "project"]; + * @return string + */ + public function getProject() + { + return $this->project; + } + + /** + * Project ID for this request. + * + * Generated from protobuf field string project = 227560217 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "project"]; + * @param string $var + * @return $this + */ + public function setProject($var) + { + GPBUtil::checkString($var, True); + $this->project = $var; + + return $this; + } + + /** + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). + * end_interface: MixerMutationRequestBuilder + * + * Generated from protobuf field optional string request_id = 37109963; + * @return string + */ + public function getRequestId() + { + return isset($this->request_id) ? $this->request_id : ''; + } + + public function hasRequestId() + { + return isset($this->request_id); + } + + public function clearRequestId() + { + unset($this->request_id); + } + + /** + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). + * end_interface: MixerMutationRequestBuilder + * + * Generated from protobuf field optional string request_id = 37109963; + * @param string $var + * @return $this + */ + public function setRequestId($var) + { + GPBUtil::checkString($var, True); + $this->request_id = $var; + + return $this; + } + + /** + * update_mask indicates fields to be updated as part of this request. + * + * Generated from protobuf field optional string update_mask = 500079778; + * @return string + */ + public function getUpdateMask() + { + return isset($this->update_mask) ? $this->update_mask : ''; + } + + public function hasUpdateMask() + { + return isset($this->update_mask); + } + + public function clearUpdateMask() + { + unset($this->update_mask); + } + + /** + * update_mask indicates fields to be updated as part of this request. + * + * Generated from protobuf field optional string update_mask = 500079778; + * @param string $var + * @return $this + */ + public function setUpdateMask($var) + { + GPBUtil::checkString($var, True); + $this->update_mask = $var; + + return $this; + } + + /** + * [Input Only] Validate the new configuration, but don't update it. + * + * Generated from protobuf field optional bool validate_only = 242744629; + * @return bool + */ + public function getValidateOnly() + { + return isset($this->validate_only) ? $this->validate_only : false; + } + + public function hasValidateOnly() + { + return isset($this->validate_only); + } + + public function clearValidateOnly() + { + unset($this->validate_only); + } + + /** + * [Input Only] Validate the new configuration, but don't update it. + * + * Generated from protobuf field optional bool validate_only = 242744629; + * @param bool $var + * @return $this + */ + public function setValidateOnly($var) + { + GPBUtil::checkBool($var); + $this->validate_only = $var; + + return $this; + } + + /** + * Name of the WireGroups resource to patch. + * + * Generated from protobuf field string wire_group = 122540613 [(.google.api.field_behavior) = REQUIRED]; + * @return string + */ + public function getWireGroup() + { + return $this->wire_group; + } + + /** + * Name of the WireGroups resource to patch. + * + * Generated from protobuf field string wire_group = 122540613 [(.google.api.field_behavior) = REQUIRED]; + * @param string $var + * @return $this + */ + public function setWireGroup($var) + { + GPBUtil::checkString($var, True); + $this->wire_group = $var; + + return $this; + } + + /** + * The body resource for this request + * + * Generated from protobuf field .google.cloud.compute.v1.WireGroup wire_group_resource = 117104840 [(.google.api.field_behavior) = REQUIRED]; + * @return \Google\Cloud\Compute\V1\WireGroup|null + */ + public function getWireGroupResource() + { + return $this->wire_group_resource; + } + + public function hasWireGroupResource() + { + return isset($this->wire_group_resource); + } + + public function clearWireGroupResource() + { + unset($this->wire_group_resource); + } + + /** + * The body resource for this request + * + * Generated from protobuf field .google.cloud.compute.v1.WireGroup wire_group_resource = 117104840 [(.google.api.field_behavior) = REQUIRED]; + * @param \Google\Cloud\Compute\V1\WireGroup $var + * @return $this + */ + public function setWireGroupResource($var) + { + GPBUtil::checkMessage($var, \Google\Cloud\Compute\V1\WireGroup::class); + $this->wire_group_resource = $var; + + return $this; + } + +} + diff --git a/Compute/src/V1/PathMatcher.php b/Compute/src/V1/PathMatcher.php index 0b34421db5ce..a23297a5d3f0 100644 --- a/Compute/src/V1/PathMatcher.php +++ b/Compute/src/V1/PathMatcher.php @@ -9,62 +9,135 @@ use Google\Protobuf\Internal\GPBUtil; /** - * A matcher for the path portion of the URL. The BackendService from the longest-matched rule will serve the URL. If no rule was matched, the default service is used. + * A matcher for the path portion of the URL. The BackendService + * from the longest-matched rule will serve the URL. If no rule was matched, the + * default service is used. * * Generated from protobuf message google.cloud.compute.v1.PathMatcher */ class PathMatcher extends \Google\Protobuf\Internal\Message { /** - * defaultCustomErrorResponsePolicy specifies how the Load Balancer returns error responses when BackendServiceor BackendBucket responds with an error. This policy takes effect at the PathMatcher level and applies only when no policy has been defined for the error code at lower levels like RouteRule and PathRule within this PathMatcher. If an error code does not have a policy defined in defaultCustomErrorResponsePolicy, then a policy defined for the error code in UrlMap.defaultCustomErrorResponsePolicy takes effect. For example, consider a UrlMap with the following configuration: - UrlMap.defaultCustomErrorResponsePolicy is configured with policies for 5xx and 4xx errors - A RouteRule for /coming_soon/ is configured for the error code 404. If the request is for www.myotherdomain.com and a 404 is encountered, the policy under UrlMap.defaultCustomErrorResponsePolicy takes effect. If a 404 response is encountered for the request www.example.com/current_events/, the pathMatcher's policy takes effect. If however, the request for www.example.com/coming_soon/ encounters a 404, the policy in RouteRule.customErrorResponsePolicy takes effect. If any of the requests in this example encounter a 500 error code, the policy at UrlMap.defaultCustomErrorResponsePolicy takes effect. When used in conjunction with pathMatcher.defaultRouteAction.retryPolicy, retries take precedence. Only once all retries are exhausted, the defaultCustomErrorResponsePolicy is applied. While attempting a retry, if load balancer is successful in reaching the service, the defaultCustomErrorResponsePolicy is ignored and the response from the service is returned to the client. defaultCustomErrorResponsePolicy is supported only for global external Application Load Balancers. + * defaultCustomErrorResponsePolicy specifies how the Load + * Balancer returns error responses when BackendServiceorBackendBucket responds with an error. + * This policy takes + * effect at the PathMatcher level and applies only when no + * policy has been defined for the error code at lower levels likeRouteRule and PathRule within thisPathMatcher. If an error code does not have a policy defined + * in defaultCustomErrorResponsePolicy, then a policy defined for + * the error code in UrlMap.defaultCustomErrorResponsePolicy + * takes effect. + * For example, consider a UrlMap with the following + * configuration: + * - UrlMap.defaultCustomErrorResponsePolicy is configured + * with policies for 5xx and 4xx errors + * - A RouteRule for /coming_soon/ is configured for the + * error code 404. + * If the request is for www.myotherdomain.com and a404 is encountered, the policy underUrlMap.defaultCustomErrorResponsePolicy takes effect. If a404 response is encountered for the requestwww.example.com/current_events/, the pathMatcher's policy + * takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404, + * the policy in RouteRule.customErrorResponsePolicy takes + * effect. If any of the requests in this example encounter a 500 + * error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect. + * When + * used in conjunction withpathMatcher.defaultRouteAction.retryPolicy, retries take + * precedence. Only once all retries are exhausted, thedefaultCustomErrorResponsePolicy is applied. While attempting + * a retry, if load balancer is successful in reaching the + * service, the defaultCustomErrorResponsePolicy is ignored and + * the response from the service is returned to the client. + * defaultCustomErrorResponsePolicy is supported only for + * global external Application Load Balancers. * * Generated from protobuf field optional .google.cloud.compute.v1.CustomErrorResponsePolicy default_custom_error_response_policy = 81266089; */ protected $default_custom_error_response_policy = null; /** - * defaultRouteAction takes effect when none of the pathRules or routeRules match. The load balancer performs advanced routing actions, such as URL rewrites and header transformations, before forwarding the request to the selected backend. Only one of defaultUrlRedirect, defaultService or defaultRouteAction.weightedBackendService can be set. URL maps for classic Application Load Balancers only support the urlRewrite action within a path matcher's defaultRouteAction. + * defaultRouteAction takes effect when none of the + * pathRules or routeRules match. The load balancer + * performs advanced routing actions, such as URL rewrites and + * header transformations, before forwarding the request to the + * selected backend. + * Only one of defaultUrlRedirect, defaultService + * or defaultRouteAction.weightedBackendService can be set. + * URL maps for classic Application Load Balancers only support + * the urlRewrite action within a path matcher'sdefaultRouteAction. * * Generated from protobuf field optional .google.cloud.compute.v1.HttpRouteAction default_route_action = 378919466; */ protected $default_route_action = null; /** - * The full or partial URL to the BackendService resource. This URL is used if none of the pathRules or routeRules defined by this PathMatcher are matched. For example, the following are all valid URLs to a BackendService resource: - https://www.googleapis.com/compute/v1/projects/project /global/backendServices/backendService - compute/v1/projects/project/global/backendServices/backendService - global/backendServices/backendService If defaultRouteAction is also specified, advanced routing actions, such as URL rewrites, take effect before sending the request to the backend. Only one of defaultUrlRedirect, defaultService or defaultRouteAction.weightedBackendService can be set. Authorization requires one or more of the following Google IAM permissions on the specified resource default_service: - compute.backendBuckets.use - compute.backendServices.use + * The full or partial URL to the BackendService resource. This + * URL is used if none of the pathRules orrouteRules defined by this PathMatcher are + * matched. For example, the + * following are all valid URLs to a BackendService resource: + * - https://www.googleapis.com/compute/v1/projects/project/global/backendServices/backendService + * - compute/v1/projects/project/global/backendServices/backendService + * - global/backendServices/backendService + * If defaultRouteAction is also specified, advanced + * routing actions, such as URL rewrites, take effect before sending the + * request to the backend. + * Only one of defaultUrlRedirect, defaultService + * or defaultRouteAction.weightedBackendService can be set. + * Authorization requires one or more of the following Google IAM permissions on the + * specified resource default_service: + * - compute.backendBuckets.use + * - compute.backendServices.use * * Generated from protobuf field optional string default_service = 370242231; */ protected $default_service = null; /** - * When none of the specified pathRules or routeRules match, the request is redirected to a URL specified by defaultUrlRedirect. Only one of defaultUrlRedirect, defaultService or defaultRouteAction.weightedBackendService can be set. Not supported when the URL map is bound to a target gRPC proxy. + * When none of the specified pathRules orrouteRules match, the request is redirected to a URL specified + * by defaultUrlRedirect. + * Only one of defaultUrlRedirect, defaultService + * or defaultRouteAction.weightedBackendService can be set. + * Not supported when the URL map is bound to a target gRPC proxy. * * Generated from protobuf field optional .google.cloud.compute.v1.HttpRedirectAction default_url_redirect = 359503338; */ protected $default_url_redirect = null; /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; */ protected $description = null; /** - * Specifies changes to request and response headers that need to take effect for the selected backend service. HeaderAction specified here are applied after the matching HttpRouteRule HeaderAction and before the HeaderAction in the UrlMap HeaderAction is not supported for load balancers that have their loadBalancingScheme set to EXTERNAL. Not supported when the URL map is bound to a target gRPC proxy that has validateForProxyless field set to true. + * Specifies changes to request and response headers that need to take effect + * for the selected backend service. + * HeaderAction specified here are applied after the matchingHttpRouteRule HeaderAction and before theHeaderAction in the UrlMap + * HeaderAction is not supported for load balancers + * that have + * their loadBalancingScheme set to EXTERNAL. + * Not supported when the URL map is bound to a target gRPC proxy that + * has validateForProxyless field set to true. * * Generated from protobuf field optional .google.cloud.compute.v1.HttpHeaderAction header_action = 328077352; */ protected $header_action = null; /** - * The name to which this PathMatcher is referred by the HostRule. + * The name to which this PathMatcher is referred by theHostRule. * * Generated from protobuf field optional string name = 3373707; */ protected $name = null; /** - * The list of path rules. Use this list instead of routeRules when routing based on simple path matching is all that's required. The order by which path rules are specified does not matter. Matches are always done on the longest-path-first basis. For example: a pathRule with a path /a/b/c/* will match before /a/b/* irrespective of the order in which those paths appear in this list. Within a given pathMatcher, only one of pathRules or routeRules must be set. + * The list of path rules. Use this list instead of routeRules + * when routing based on simple path matching is all that's required. The + * order by which path rules are specified does not matter. Matches are always + * done on the longest-path-first basis. + * For example: a pathRule with a path /a/b/c/* will match + * before /a/b/* irrespective of the order in which those paths appear in this + * list. + * Within a given pathMatcher, only one ofpathRules or routeRules must be set. * * Generated from protobuf field repeated .google.cloud.compute.v1.PathRule path_rules = 104439901; */ private $path_rules; /** - * The list of HTTP route rules. Use this list instead of pathRules when advanced route matching and routing actions are desired. routeRules are evaluated in order of priority, from the lowest to highest number. Within a given pathMatcher, you can set only one of pathRules or routeRules. + * The list of HTTP route rules. Use this list instead ofpathRules when advanced route matching and routing actions are + * desired. routeRules are evaluated in order of priority, from + * the lowest to highest number. + * Within a given pathMatcher, you can set only one ofpathRules or routeRules. * * Generated from protobuf field repeated .google.cloud.compute.v1.HttpRouteRule route_rules = 376292225; */ @@ -77,23 +150,94 @@ class PathMatcher extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type \Google\Cloud\Compute\V1\CustomErrorResponsePolicy $default_custom_error_response_policy - * defaultCustomErrorResponsePolicy specifies how the Load Balancer returns error responses when BackendServiceor BackendBucket responds with an error. This policy takes effect at the PathMatcher level and applies only when no policy has been defined for the error code at lower levels like RouteRule and PathRule within this PathMatcher. If an error code does not have a policy defined in defaultCustomErrorResponsePolicy, then a policy defined for the error code in UrlMap.defaultCustomErrorResponsePolicy takes effect. For example, consider a UrlMap with the following configuration: - UrlMap.defaultCustomErrorResponsePolicy is configured with policies for 5xx and 4xx errors - A RouteRule for /coming_soon/ is configured for the error code 404. If the request is for www.myotherdomain.com and a 404 is encountered, the policy under UrlMap.defaultCustomErrorResponsePolicy takes effect. If a 404 response is encountered for the request www.example.com/current_events/, the pathMatcher's policy takes effect. If however, the request for www.example.com/coming_soon/ encounters a 404, the policy in RouteRule.customErrorResponsePolicy takes effect. If any of the requests in this example encounter a 500 error code, the policy at UrlMap.defaultCustomErrorResponsePolicy takes effect. When used in conjunction with pathMatcher.defaultRouteAction.retryPolicy, retries take precedence. Only once all retries are exhausted, the defaultCustomErrorResponsePolicy is applied. While attempting a retry, if load balancer is successful in reaching the service, the defaultCustomErrorResponsePolicy is ignored and the response from the service is returned to the client. defaultCustomErrorResponsePolicy is supported only for global external Application Load Balancers. + * defaultCustomErrorResponsePolicy specifies how the Load + * Balancer returns error responses when BackendServiceorBackendBucket responds with an error. + * This policy takes + * effect at the PathMatcher level and applies only when no + * policy has been defined for the error code at lower levels likeRouteRule and PathRule within thisPathMatcher. If an error code does not have a policy defined + * in defaultCustomErrorResponsePolicy, then a policy defined for + * the error code in UrlMap.defaultCustomErrorResponsePolicy + * takes effect. + * For example, consider a UrlMap with the following + * configuration: + * - UrlMap.defaultCustomErrorResponsePolicy is configured + * with policies for 5xx and 4xx errors + * - A RouteRule for /coming_soon/ is configured for the + * error code 404. + * If the request is for www.myotherdomain.com and a404 is encountered, the policy underUrlMap.defaultCustomErrorResponsePolicy takes effect. If a404 response is encountered for the requestwww.example.com/current_events/, the pathMatcher's policy + * takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404, + * the policy in RouteRule.customErrorResponsePolicy takes + * effect. If any of the requests in this example encounter a 500 + * error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect. + * When + * used in conjunction withpathMatcher.defaultRouteAction.retryPolicy, retries take + * precedence. Only once all retries are exhausted, thedefaultCustomErrorResponsePolicy is applied. While attempting + * a retry, if load balancer is successful in reaching the + * service, the defaultCustomErrorResponsePolicy is ignored and + * the response from the service is returned to the client. + * defaultCustomErrorResponsePolicy is supported only for + * global external Application Load Balancers. * @type \Google\Cloud\Compute\V1\HttpRouteAction $default_route_action - * defaultRouteAction takes effect when none of the pathRules or routeRules match. The load balancer performs advanced routing actions, such as URL rewrites and header transformations, before forwarding the request to the selected backend. Only one of defaultUrlRedirect, defaultService or defaultRouteAction.weightedBackendService can be set. URL maps for classic Application Load Balancers only support the urlRewrite action within a path matcher's defaultRouteAction. + * defaultRouteAction takes effect when none of the + * pathRules or routeRules match. The load balancer + * performs advanced routing actions, such as URL rewrites and + * header transformations, before forwarding the request to the + * selected backend. + * Only one of defaultUrlRedirect, defaultService + * or defaultRouteAction.weightedBackendService can be set. + * URL maps for classic Application Load Balancers only support + * the urlRewrite action within a path matcher'sdefaultRouteAction. * @type string $default_service - * The full or partial URL to the BackendService resource. This URL is used if none of the pathRules or routeRules defined by this PathMatcher are matched. For example, the following are all valid URLs to a BackendService resource: - https://www.googleapis.com/compute/v1/projects/project /global/backendServices/backendService - compute/v1/projects/project/global/backendServices/backendService - global/backendServices/backendService If defaultRouteAction is also specified, advanced routing actions, such as URL rewrites, take effect before sending the request to the backend. Only one of defaultUrlRedirect, defaultService or defaultRouteAction.weightedBackendService can be set. Authorization requires one or more of the following Google IAM permissions on the specified resource default_service: - compute.backendBuckets.use - compute.backendServices.use + * The full or partial URL to the BackendService resource. This + * URL is used if none of the pathRules orrouteRules defined by this PathMatcher are + * matched. For example, the + * following are all valid URLs to a BackendService resource: + * - https://www.googleapis.com/compute/v1/projects/project/global/backendServices/backendService + * - compute/v1/projects/project/global/backendServices/backendService + * - global/backendServices/backendService + * If defaultRouteAction is also specified, advanced + * routing actions, such as URL rewrites, take effect before sending the + * request to the backend. + * Only one of defaultUrlRedirect, defaultService + * or defaultRouteAction.weightedBackendService can be set. + * Authorization requires one or more of the following Google IAM permissions on the + * specified resource default_service: + * - compute.backendBuckets.use + * - compute.backendServices.use * @type \Google\Cloud\Compute\V1\HttpRedirectAction $default_url_redirect - * When none of the specified pathRules or routeRules match, the request is redirected to a URL specified by defaultUrlRedirect. Only one of defaultUrlRedirect, defaultService or defaultRouteAction.weightedBackendService can be set. Not supported when the URL map is bound to a target gRPC proxy. + * When none of the specified pathRules orrouteRules match, the request is redirected to a URL specified + * by defaultUrlRedirect. + * Only one of defaultUrlRedirect, defaultService + * or defaultRouteAction.weightedBackendService can be set. + * Not supported when the URL map is bound to a target gRPC proxy. * @type string $description - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * @type \Google\Cloud\Compute\V1\HttpHeaderAction $header_action - * Specifies changes to request and response headers that need to take effect for the selected backend service. HeaderAction specified here are applied after the matching HttpRouteRule HeaderAction and before the HeaderAction in the UrlMap HeaderAction is not supported for load balancers that have their loadBalancingScheme set to EXTERNAL. Not supported when the URL map is bound to a target gRPC proxy that has validateForProxyless field set to true. + * Specifies changes to request and response headers that need to take effect + * for the selected backend service. + * HeaderAction specified here are applied after the matchingHttpRouteRule HeaderAction and before theHeaderAction in the UrlMap + * HeaderAction is not supported for load balancers + * that have + * their loadBalancingScheme set to EXTERNAL. + * Not supported when the URL map is bound to a target gRPC proxy that + * has validateForProxyless field set to true. * @type string $name - * The name to which this PathMatcher is referred by the HostRule. + * The name to which this PathMatcher is referred by theHostRule. * @type array<\Google\Cloud\Compute\V1\PathRule>|\Google\Protobuf\Internal\RepeatedField $path_rules - * The list of path rules. Use this list instead of routeRules when routing based on simple path matching is all that's required. The order by which path rules are specified does not matter. Matches are always done on the longest-path-first basis. For example: a pathRule with a path /a/b/c/* will match before /a/b/* irrespective of the order in which those paths appear in this list. Within a given pathMatcher, only one of pathRules or routeRules must be set. + * The list of path rules. Use this list instead of routeRules + * when routing based on simple path matching is all that's required. The + * order by which path rules are specified does not matter. Matches are always + * done on the longest-path-first basis. + * For example: a pathRule with a path /a/b/c/* will match + * before /a/b/* irrespective of the order in which those paths appear in this + * list. + * Within a given pathMatcher, only one ofpathRules or routeRules must be set. * @type array<\Google\Cloud\Compute\V1\HttpRouteRule>|\Google\Protobuf\Internal\RepeatedField $route_rules - * The list of HTTP route rules. Use this list instead of pathRules when advanced route matching and routing actions are desired. routeRules are evaluated in order of priority, from the lowest to highest number. Within a given pathMatcher, you can set only one of pathRules or routeRules. + * The list of HTTP route rules. Use this list instead ofpathRules when advanced route matching and routing actions are + * desired. routeRules are evaluated in order of priority, from + * the lowest to highest number. + * Within a given pathMatcher, you can set only one ofpathRules or routeRules. * } */ public function __construct($data = NULL) { @@ -102,7 +246,33 @@ public function __construct($data = NULL) { } /** - * defaultCustomErrorResponsePolicy specifies how the Load Balancer returns error responses when BackendServiceor BackendBucket responds with an error. This policy takes effect at the PathMatcher level and applies only when no policy has been defined for the error code at lower levels like RouteRule and PathRule within this PathMatcher. If an error code does not have a policy defined in defaultCustomErrorResponsePolicy, then a policy defined for the error code in UrlMap.defaultCustomErrorResponsePolicy takes effect. For example, consider a UrlMap with the following configuration: - UrlMap.defaultCustomErrorResponsePolicy is configured with policies for 5xx and 4xx errors - A RouteRule for /coming_soon/ is configured for the error code 404. If the request is for www.myotherdomain.com and a 404 is encountered, the policy under UrlMap.defaultCustomErrorResponsePolicy takes effect. If a 404 response is encountered for the request www.example.com/current_events/, the pathMatcher's policy takes effect. If however, the request for www.example.com/coming_soon/ encounters a 404, the policy in RouteRule.customErrorResponsePolicy takes effect. If any of the requests in this example encounter a 500 error code, the policy at UrlMap.defaultCustomErrorResponsePolicy takes effect. When used in conjunction with pathMatcher.defaultRouteAction.retryPolicy, retries take precedence. Only once all retries are exhausted, the defaultCustomErrorResponsePolicy is applied. While attempting a retry, if load balancer is successful in reaching the service, the defaultCustomErrorResponsePolicy is ignored and the response from the service is returned to the client. defaultCustomErrorResponsePolicy is supported only for global external Application Load Balancers. + * defaultCustomErrorResponsePolicy specifies how the Load + * Balancer returns error responses when BackendServiceorBackendBucket responds with an error. + * This policy takes + * effect at the PathMatcher level and applies only when no + * policy has been defined for the error code at lower levels likeRouteRule and PathRule within thisPathMatcher. If an error code does not have a policy defined + * in defaultCustomErrorResponsePolicy, then a policy defined for + * the error code in UrlMap.defaultCustomErrorResponsePolicy + * takes effect. + * For example, consider a UrlMap with the following + * configuration: + * - UrlMap.defaultCustomErrorResponsePolicy is configured + * with policies for 5xx and 4xx errors + * - A RouteRule for /coming_soon/ is configured for the + * error code 404. + * If the request is for www.myotherdomain.com and a404 is encountered, the policy underUrlMap.defaultCustomErrorResponsePolicy takes effect. If a404 response is encountered for the requestwww.example.com/current_events/, the pathMatcher's policy + * takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404, + * the policy in RouteRule.customErrorResponsePolicy takes + * effect. If any of the requests in this example encounter a 500 + * error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect. + * When + * used in conjunction withpathMatcher.defaultRouteAction.retryPolicy, retries take + * precedence. Only once all retries are exhausted, thedefaultCustomErrorResponsePolicy is applied. While attempting + * a retry, if load balancer is successful in reaching the + * service, the defaultCustomErrorResponsePolicy is ignored and + * the response from the service is returned to the client. + * defaultCustomErrorResponsePolicy is supported only for + * global external Application Load Balancers. * * Generated from protobuf field optional .google.cloud.compute.v1.CustomErrorResponsePolicy default_custom_error_response_policy = 81266089; * @return \Google\Cloud\Compute\V1\CustomErrorResponsePolicy|null @@ -123,7 +293,33 @@ public function clearDefaultCustomErrorResponsePolicy() } /** - * defaultCustomErrorResponsePolicy specifies how the Load Balancer returns error responses when BackendServiceor BackendBucket responds with an error. This policy takes effect at the PathMatcher level and applies only when no policy has been defined for the error code at lower levels like RouteRule and PathRule within this PathMatcher. If an error code does not have a policy defined in defaultCustomErrorResponsePolicy, then a policy defined for the error code in UrlMap.defaultCustomErrorResponsePolicy takes effect. For example, consider a UrlMap with the following configuration: - UrlMap.defaultCustomErrorResponsePolicy is configured with policies for 5xx and 4xx errors - A RouteRule for /coming_soon/ is configured for the error code 404. If the request is for www.myotherdomain.com and a 404 is encountered, the policy under UrlMap.defaultCustomErrorResponsePolicy takes effect. If a 404 response is encountered for the request www.example.com/current_events/, the pathMatcher's policy takes effect. If however, the request for www.example.com/coming_soon/ encounters a 404, the policy in RouteRule.customErrorResponsePolicy takes effect. If any of the requests in this example encounter a 500 error code, the policy at UrlMap.defaultCustomErrorResponsePolicy takes effect. When used in conjunction with pathMatcher.defaultRouteAction.retryPolicy, retries take precedence. Only once all retries are exhausted, the defaultCustomErrorResponsePolicy is applied. While attempting a retry, if load balancer is successful in reaching the service, the defaultCustomErrorResponsePolicy is ignored and the response from the service is returned to the client. defaultCustomErrorResponsePolicy is supported only for global external Application Load Balancers. + * defaultCustomErrorResponsePolicy specifies how the Load + * Balancer returns error responses when BackendServiceorBackendBucket responds with an error. + * This policy takes + * effect at the PathMatcher level and applies only when no + * policy has been defined for the error code at lower levels likeRouteRule and PathRule within thisPathMatcher. If an error code does not have a policy defined + * in defaultCustomErrorResponsePolicy, then a policy defined for + * the error code in UrlMap.defaultCustomErrorResponsePolicy + * takes effect. + * For example, consider a UrlMap with the following + * configuration: + * - UrlMap.defaultCustomErrorResponsePolicy is configured + * with policies for 5xx and 4xx errors + * - A RouteRule for /coming_soon/ is configured for the + * error code 404. + * If the request is for www.myotherdomain.com and a404 is encountered, the policy underUrlMap.defaultCustomErrorResponsePolicy takes effect. If a404 response is encountered for the requestwww.example.com/current_events/, the pathMatcher's policy + * takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404, + * the policy in RouteRule.customErrorResponsePolicy takes + * effect. If any of the requests in this example encounter a 500 + * error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect. + * When + * used in conjunction withpathMatcher.defaultRouteAction.retryPolicy, retries take + * precedence. Only once all retries are exhausted, thedefaultCustomErrorResponsePolicy is applied. While attempting + * a retry, if load balancer is successful in reaching the + * service, the defaultCustomErrorResponsePolicy is ignored and + * the response from the service is returned to the client. + * defaultCustomErrorResponsePolicy is supported only for + * global external Application Load Balancers. * * Generated from protobuf field optional .google.cloud.compute.v1.CustomErrorResponsePolicy default_custom_error_response_policy = 81266089; * @param \Google\Cloud\Compute\V1\CustomErrorResponsePolicy $var @@ -138,7 +334,15 @@ public function setDefaultCustomErrorResponsePolicy($var) } /** - * defaultRouteAction takes effect when none of the pathRules or routeRules match. The load balancer performs advanced routing actions, such as URL rewrites and header transformations, before forwarding the request to the selected backend. Only one of defaultUrlRedirect, defaultService or defaultRouteAction.weightedBackendService can be set. URL maps for classic Application Load Balancers only support the urlRewrite action within a path matcher's defaultRouteAction. + * defaultRouteAction takes effect when none of the + * pathRules or routeRules match. The load balancer + * performs advanced routing actions, such as URL rewrites and + * header transformations, before forwarding the request to the + * selected backend. + * Only one of defaultUrlRedirect, defaultService + * or defaultRouteAction.weightedBackendService can be set. + * URL maps for classic Application Load Balancers only support + * the urlRewrite action within a path matcher'sdefaultRouteAction. * * Generated from protobuf field optional .google.cloud.compute.v1.HttpRouteAction default_route_action = 378919466; * @return \Google\Cloud\Compute\V1\HttpRouteAction|null @@ -159,7 +363,15 @@ public function clearDefaultRouteAction() } /** - * defaultRouteAction takes effect when none of the pathRules or routeRules match. The load balancer performs advanced routing actions, such as URL rewrites and header transformations, before forwarding the request to the selected backend. Only one of defaultUrlRedirect, defaultService or defaultRouteAction.weightedBackendService can be set. URL maps for classic Application Load Balancers only support the urlRewrite action within a path matcher's defaultRouteAction. + * defaultRouteAction takes effect when none of the + * pathRules or routeRules match. The load balancer + * performs advanced routing actions, such as URL rewrites and + * header transformations, before forwarding the request to the + * selected backend. + * Only one of defaultUrlRedirect, defaultService + * or defaultRouteAction.weightedBackendService can be set. + * URL maps for classic Application Load Balancers only support + * the urlRewrite action within a path matcher'sdefaultRouteAction. * * Generated from protobuf field optional .google.cloud.compute.v1.HttpRouteAction default_route_action = 378919466; * @param \Google\Cloud\Compute\V1\HttpRouteAction $var @@ -174,7 +386,22 @@ public function setDefaultRouteAction($var) } /** - * The full or partial URL to the BackendService resource. This URL is used if none of the pathRules or routeRules defined by this PathMatcher are matched. For example, the following are all valid URLs to a BackendService resource: - https://www.googleapis.com/compute/v1/projects/project /global/backendServices/backendService - compute/v1/projects/project/global/backendServices/backendService - global/backendServices/backendService If defaultRouteAction is also specified, advanced routing actions, such as URL rewrites, take effect before sending the request to the backend. Only one of defaultUrlRedirect, defaultService or defaultRouteAction.weightedBackendService can be set. Authorization requires one or more of the following Google IAM permissions on the specified resource default_service: - compute.backendBuckets.use - compute.backendServices.use + * The full or partial URL to the BackendService resource. This + * URL is used if none of the pathRules orrouteRules defined by this PathMatcher are + * matched. For example, the + * following are all valid URLs to a BackendService resource: + * - https://www.googleapis.com/compute/v1/projects/project/global/backendServices/backendService + * - compute/v1/projects/project/global/backendServices/backendService + * - global/backendServices/backendService + * If defaultRouteAction is also specified, advanced + * routing actions, such as URL rewrites, take effect before sending the + * request to the backend. + * Only one of defaultUrlRedirect, defaultService + * or defaultRouteAction.weightedBackendService can be set. + * Authorization requires one or more of the following Google IAM permissions on the + * specified resource default_service: + * - compute.backendBuckets.use + * - compute.backendServices.use * * Generated from protobuf field optional string default_service = 370242231; * @return string @@ -195,7 +422,22 @@ public function clearDefaultService() } /** - * The full or partial URL to the BackendService resource. This URL is used if none of the pathRules or routeRules defined by this PathMatcher are matched. For example, the following are all valid URLs to a BackendService resource: - https://www.googleapis.com/compute/v1/projects/project /global/backendServices/backendService - compute/v1/projects/project/global/backendServices/backendService - global/backendServices/backendService If defaultRouteAction is also specified, advanced routing actions, such as URL rewrites, take effect before sending the request to the backend. Only one of defaultUrlRedirect, defaultService or defaultRouteAction.weightedBackendService can be set. Authorization requires one or more of the following Google IAM permissions on the specified resource default_service: - compute.backendBuckets.use - compute.backendServices.use + * The full or partial URL to the BackendService resource. This + * URL is used if none of the pathRules orrouteRules defined by this PathMatcher are + * matched. For example, the + * following are all valid URLs to a BackendService resource: + * - https://www.googleapis.com/compute/v1/projects/project/global/backendServices/backendService + * - compute/v1/projects/project/global/backendServices/backendService + * - global/backendServices/backendService + * If defaultRouteAction is also specified, advanced + * routing actions, such as URL rewrites, take effect before sending the + * request to the backend. + * Only one of defaultUrlRedirect, defaultService + * or defaultRouteAction.weightedBackendService can be set. + * Authorization requires one or more of the following Google IAM permissions on the + * specified resource default_service: + * - compute.backendBuckets.use + * - compute.backendServices.use * * Generated from protobuf field optional string default_service = 370242231; * @param string $var @@ -210,7 +452,11 @@ public function setDefaultService($var) } /** - * When none of the specified pathRules or routeRules match, the request is redirected to a URL specified by defaultUrlRedirect. Only one of defaultUrlRedirect, defaultService or defaultRouteAction.weightedBackendService can be set. Not supported when the URL map is bound to a target gRPC proxy. + * When none of the specified pathRules orrouteRules match, the request is redirected to a URL specified + * by defaultUrlRedirect. + * Only one of defaultUrlRedirect, defaultService + * or defaultRouteAction.weightedBackendService can be set. + * Not supported when the URL map is bound to a target gRPC proxy. * * Generated from protobuf field optional .google.cloud.compute.v1.HttpRedirectAction default_url_redirect = 359503338; * @return \Google\Cloud\Compute\V1\HttpRedirectAction|null @@ -231,7 +477,11 @@ public function clearDefaultUrlRedirect() } /** - * When none of the specified pathRules or routeRules match, the request is redirected to a URL specified by defaultUrlRedirect. Only one of defaultUrlRedirect, defaultService or defaultRouteAction.weightedBackendService can be set. Not supported when the URL map is bound to a target gRPC proxy. + * When none of the specified pathRules orrouteRules match, the request is redirected to a URL specified + * by defaultUrlRedirect. + * Only one of defaultUrlRedirect, defaultService + * or defaultRouteAction.weightedBackendService can be set. + * Not supported when the URL map is bound to a target gRPC proxy. * * Generated from protobuf field optional .google.cloud.compute.v1.HttpRedirectAction default_url_redirect = 359503338; * @param \Google\Cloud\Compute\V1\HttpRedirectAction $var @@ -246,7 +496,8 @@ public function setDefaultUrlRedirect($var) } /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @return string @@ -267,7 +518,8 @@ public function clearDescription() } /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @param string $var @@ -282,7 +534,14 @@ public function setDescription($var) } /** - * Specifies changes to request and response headers that need to take effect for the selected backend service. HeaderAction specified here are applied after the matching HttpRouteRule HeaderAction and before the HeaderAction in the UrlMap HeaderAction is not supported for load balancers that have their loadBalancingScheme set to EXTERNAL. Not supported when the URL map is bound to a target gRPC proxy that has validateForProxyless field set to true. + * Specifies changes to request and response headers that need to take effect + * for the selected backend service. + * HeaderAction specified here are applied after the matchingHttpRouteRule HeaderAction and before theHeaderAction in the UrlMap + * HeaderAction is not supported for load balancers + * that have + * their loadBalancingScheme set to EXTERNAL. + * Not supported when the URL map is bound to a target gRPC proxy that + * has validateForProxyless field set to true. * * Generated from protobuf field optional .google.cloud.compute.v1.HttpHeaderAction header_action = 328077352; * @return \Google\Cloud\Compute\V1\HttpHeaderAction|null @@ -303,7 +562,14 @@ public function clearHeaderAction() } /** - * Specifies changes to request and response headers that need to take effect for the selected backend service. HeaderAction specified here are applied after the matching HttpRouteRule HeaderAction and before the HeaderAction in the UrlMap HeaderAction is not supported for load balancers that have their loadBalancingScheme set to EXTERNAL. Not supported when the URL map is bound to a target gRPC proxy that has validateForProxyless field set to true. + * Specifies changes to request and response headers that need to take effect + * for the selected backend service. + * HeaderAction specified here are applied after the matchingHttpRouteRule HeaderAction and before theHeaderAction in the UrlMap + * HeaderAction is not supported for load balancers + * that have + * their loadBalancingScheme set to EXTERNAL. + * Not supported when the URL map is bound to a target gRPC proxy that + * has validateForProxyless field set to true. * * Generated from protobuf field optional .google.cloud.compute.v1.HttpHeaderAction header_action = 328077352; * @param \Google\Cloud\Compute\V1\HttpHeaderAction $var @@ -318,7 +584,7 @@ public function setHeaderAction($var) } /** - * The name to which this PathMatcher is referred by the HostRule. + * The name to which this PathMatcher is referred by theHostRule. * * Generated from protobuf field optional string name = 3373707; * @return string @@ -339,7 +605,7 @@ public function clearName() } /** - * The name to which this PathMatcher is referred by the HostRule. + * The name to which this PathMatcher is referred by theHostRule. * * Generated from protobuf field optional string name = 3373707; * @param string $var @@ -354,7 +620,14 @@ public function setName($var) } /** - * The list of path rules. Use this list instead of routeRules when routing based on simple path matching is all that's required. The order by which path rules are specified does not matter. Matches are always done on the longest-path-first basis. For example: a pathRule with a path /a/b/c/* will match before /a/b/* irrespective of the order in which those paths appear in this list. Within a given pathMatcher, only one of pathRules or routeRules must be set. + * The list of path rules. Use this list instead of routeRules + * when routing based on simple path matching is all that's required. The + * order by which path rules are specified does not matter. Matches are always + * done on the longest-path-first basis. + * For example: a pathRule with a path /a/b/c/* will match + * before /a/b/* irrespective of the order in which those paths appear in this + * list. + * Within a given pathMatcher, only one ofpathRules or routeRules must be set. * * Generated from protobuf field repeated .google.cloud.compute.v1.PathRule path_rules = 104439901; * @return \Google\Protobuf\Internal\RepeatedField @@ -365,7 +638,14 @@ public function getPathRules() } /** - * The list of path rules. Use this list instead of routeRules when routing based on simple path matching is all that's required. The order by which path rules are specified does not matter. Matches are always done on the longest-path-first basis. For example: a pathRule with a path /a/b/c/* will match before /a/b/* irrespective of the order in which those paths appear in this list. Within a given pathMatcher, only one of pathRules or routeRules must be set. + * The list of path rules. Use this list instead of routeRules + * when routing based on simple path matching is all that's required. The + * order by which path rules are specified does not matter. Matches are always + * done on the longest-path-first basis. + * For example: a pathRule with a path /a/b/c/* will match + * before /a/b/* irrespective of the order in which those paths appear in this + * list. + * Within a given pathMatcher, only one ofpathRules or routeRules must be set. * * Generated from protobuf field repeated .google.cloud.compute.v1.PathRule path_rules = 104439901; * @param array<\Google\Cloud\Compute\V1\PathRule>|\Google\Protobuf\Internal\RepeatedField $var @@ -380,7 +660,10 @@ public function setPathRules($var) } /** - * The list of HTTP route rules. Use this list instead of pathRules when advanced route matching and routing actions are desired. routeRules are evaluated in order of priority, from the lowest to highest number. Within a given pathMatcher, you can set only one of pathRules or routeRules. + * The list of HTTP route rules. Use this list instead ofpathRules when advanced route matching and routing actions are + * desired. routeRules are evaluated in order of priority, from + * the lowest to highest number. + * Within a given pathMatcher, you can set only one ofpathRules or routeRules. * * Generated from protobuf field repeated .google.cloud.compute.v1.HttpRouteRule route_rules = 376292225; * @return \Google\Protobuf\Internal\RepeatedField @@ -391,7 +674,10 @@ public function getRouteRules() } /** - * The list of HTTP route rules. Use this list instead of pathRules when advanced route matching and routing actions are desired. routeRules are evaluated in order of priority, from the lowest to highest number. Within a given pathMatcher, you can set only one of pathRules or routeRules. + * The list of HTTP route rules. Use this list instead ofpathRules when advanced route matching and routing actions are + * desired. routeRules are evaluated in order of priority, from + * the lowest to highest number. + * Within a given pathMatcher, you can set only one ofpathRules or routeRules. * * Generated from protobuf field repeated .google.cloud.compute.v1.HttpRouteRule route_rules = 376292225; * @param array<\Google\Cloud\Compute\V1\HttpRouteRule>|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/PathRule.php b/Compute/src/V1/PathRule.php index c5015ae92f86..b831254628f6 100644 --- a/Compute/src/V1/PathRule.php +++ b/Compute/src/V1/PathRule.php @@ -9,38 +9,74 @@ use Google\Protobuf\Internal\GPBUtil; /** - * A path-matching rule for a URL. If matched, will use the specified BackendService to handle the traffic arriving at this URL. + * A path-matching rule for a URL. If matched, will use the specifiedBackendService to handle the traffic arriving at this URL. * * Generated from protobuf message google.cloud.compute.v1.PathRule */ class PathRule extends \Google\Protobuf\Internal\Message { /** - * customErrorResponsePolicy specifies how the Load Balancer returns error responses when BackendServiceor BackendBucket responds with an error. If a policy for an error code is not configured for the PathRule, a policy for the error code configured in pathMatcher.defaultCustomErrorResponsePolicy is applied. If one is not specified in pathMatcher.defaultCustomErrorResponsePolicy, the policy configured in UrlMap.defaultCustomErrorResponsePolicy takes effect. For example, consider a UrlMap with the following configuration: - UrlMap.defaultCustomErrorResponsePolicy are configured with policies for 5xx and 4xx errors - A PathRule for /coming_soon/ is configured for the error code 404. If the request is for www.myotherdomain.com and a 404 is encountered, the policy under UrlMap.defaultCustomErrorResponsePolicy takes effect. If a 404 response is encountered for the request www.example.com/current_events/, the pathMatcher's policy takes effect. If however, the request for www.example.com/coming_soon/ encounters a 404, the policy in PathRule.customErrorResponsePolicy takes effect. If any of the requests in this example encounter a 500 error code, the policy at UrlMap.defaultCustomErrorResponsePolicy takes effect. customErrorResponsePolicy is supported only for global external Application Load Balancers. + * customErrorResponsePolicy specifies how the Load + * Balancer returns error responses when BackendServiceorBackendBucket responds with an error. + * If a policy for an + * error code is not configured for the PathRule, a policy for + * the error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If + * one is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy + * configured in UrlMap.defaultCustomErrorResponsePolicy takes + * effect. + * For example, consider a UrlMap with the following configuration: + * - UrlMap.defaultCustomErrorResponsePolicy are configured + * with policies for 5xx and 4xx errors + * - A PathRule for /coming_soon/ is configured for the error + * code 404. + * If the request is for www.myotherdomain.com and a404 is encountered, the policy underUrlMap.defaultCustomErrorResponsePolicy takes effect. If a404 response is encountered for the requestwww.example.com/current_events/, the pathMatcher's policy + * takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404, + * the policy in PathRule.customErrorResponsePolicy takes + * effect. If any of the requests in this example encounter a 500 + * error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect. + * customErrorResponsePolicy is supported only for + * global external Application Load Balancers. * * Generated from protobuf field optional .google.cloud.compute.v1.CustomErrorResponsePolicy custom_error_response_policy = 202816619; */ protected $custom_error_response_policy = null; /** - * The list of path patterns to match. Each must start with / and the only place a * is allowed is at the end following a /. The string fed to the path matcher does not include any text after the first ? or #, and those chars are not allowed here. + * The list of path patterns to match. Each must start with / + * and the only place a * is allowed is at the end following + * a /. The string fed to the path matcher does not include + * any text after the first ? or #, and + * those chars are not allowed here. * * Generated from protobuf field repeated string paths = 106438894; */ private $paths; /** - * In response to a matching path, the load balancer performs advanced routing actions, such as URL rewrites and header transformations, before forwarding the request to the selected backend. Only one of urlRedirect, service or routeAction.weightedBackendService can be set. URL maps for classic Application Load Balancers only support the urlRewrite action within a path rule's routeAction. + * In response to a matching path, the load balancer + * performs advanced routing actions, such as URL rewrites and header + * transformations, before forwarding the request to the selected + * backend. + * Only one of urlRedirect, service orrouteAction.weightedBackendService can be set. + * URL maps for classic Application Load Balancers only support + * the urlRewrite action within a path rule'srouteAction. * * Generated from protobuf field optional .google.cloud.compute.v1.HttpRouteAction route_action = 424563948; */ protected $route_action = null; /** - * The full or partial URL of the backend service resource to which traffic is directed if this rule is matched. If routeAction is also specified, advanced routing actions, such as URL rewrites, take effect before sending the request to the backend. Only one of urlRedirect, service or routeAction.weightedBackendService can be set. + * The full or partial URL of the backend service resource to which traffic + * is directed if this rule is matched. If routeAction is + * also specified, advanced routing actions, such as URL rewrites, + * take effect before sending the request to the backend. + * Only one of urlRedirect, service orrouteAction.weightedBackendService can be set. * * Generated from protobuf field optional string service = 373540533; */ protected $service = null; /** - * When a path pattern is matched, the request is redirected to a URL specified by urlRedirect. Only one of urlRedirect, service or routeAction.weightedBackendService can be set. Not supported when the URL map is bound to a target gRPC proxy. + * When a path pattern is matched, the request is redirected to a URL + * specified by urlRedirect. + * Only one of urlRedirect, service orrouteAction.weightedBackendService can be set. + * Not supported when the URL map is bound to a target gRPC proxy. * * Generated from protobuf field optional .google.cloud.compute.v1.HttpRedirectAction url_redirect = 405147820; */ @@ -53,15 +89,51 @@ class PathRule extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type \Google\Cloud\Compute\V1\CustomErrorResponsePolicy $custom_error_response_policy - * customErrorResponsePolicy specifies how the Load Balancer returns error responses when BackendServiceor BackendBucket responds with an error. If a policy for an error code is not configured for the PathRule, a policy for the error code configured in pathMatcher.defaultCustomErrorResponsePolicy is applied. If one is not specified in pathMatcher.defaultCustomErrorResponsePolicy, the policy configured in UrlMap.defaultCustomErrorResponsePolicy takes effect. For example, consider a UrlMap with the following configuration: - UrlMap.defaultCustomErrorResponsePolicy are configured with policies for 5xx and 4xx errors - A PathRule for /coming_soon/ is configured for the error code 404. If the request is for www.myotherdomain.com and a 404 is encountered, the policy under UrlMap.defaultCustomErrorResponsePolicy takes effect. If a 404 response is encountered for the request www.example.com/current_events/, the pathMatcher's policy takes effect. If however, the request for www.example.com/coming_soon/ encounters a 404, the policy in PathRule.customErrorResponsePolicy takes effect. If any of the requests in this example encounter a 500 error code, the policy at UrlMap.defaultCustomErrorResponsePolicy takes effect. customErrorResponsePolicy is supported only for global external Application Load Balancers. + * customErrorResponsePolicy specifies how the Load + * Balancer returns error responses when BackendServiceorBackendBucket responds with an error. + * If a policy for an + * error code is not configured for the PathRule, a policy for + * the error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If + * one is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy + * configured in UrlMap.defaultCustomErrorResponsePolicy takes + * effect. + * For example, consider a UrlMap with the following configuration: + * - UrlMap.defaultCustomErrorResponsePolicy are configured + * with policies for 5xx and 4xx errors + * - A PathRule for /coming_soon/ is configured for the error + * code 404. + * If the request is for www.myotherdomain.com and a404 is encountered, the policy underUrlMap.defaultCustomErrorResponsePolicy takes effect. If a404 response is encountered for the requestwww.example.com/current_events/, the pathMatcher's policy + * takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404, + * the policy in PathRule.customErrorResponsePolicy takes + * effect. If any of the requests in this example encounter a 500 + * error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect. + * customErrorResponsePolicy is supported only for + * global external Application Load Balancers. * @type array|\Google\Protobuf\Internal\RepeatedField $paths - * The list of path patterns to match. Each must start with / and the only place a * is allowed is at the end following a /. The string fed to the path matcher does not include any text after the first ? or #, and those chars are not allowed here. + * The list of path patterns to match. Each must start with / + * and the only place a * is allowed is at the end following + * a /. The string fed to the path matcher does not include + * any text after the first ? or #, and + * those chars are not allowed here. * @type \Google\Cloud\Compute\V1\HttpRouteAction $route_action - * In response to a matching path, the load balancer performs advanced routing actions, such as URL rewrites and header transformations, before forwarding the request to the selected backend. Only one of urlRedirect, service or routeAction.weightedBackendService can be set. URL maps for classic Application Load Balancers only support the urlRewrite action within a path rule's routeAction. + * In response to a matching path, the load balancer + * performs advanced routing actions, such as URL rewrites and header + * transformations, before forwarding the request to the selected + * backend. + * Only one of urlRedirect, service orrouteAction.weightedBackendService can be set. + * URL maps for classic Application Load Balancers only support + * the urlRewrite action within a path rule'srouteAction. * @type string $service - * The full or partial URL of the backend service resource to which traffic is directed if this rule is matched. If routeAction is also specified, advanced routing actions, such as URL rewrites, take effect before sending the request to the backend. Only one of urlRedirect, service or routeAction.weightedBackendService can be set. + * The full or partial URL of the backend service resource to which traffic + * is directed if this rule is matched. If routeAction is + * also specified, advanced routing actions, such as URL rewrites, + * take effect before sending the request to the backend. + * Only one of urlRedirect, service orrouteAction.weightedBackendService can be set. * @type \Google\Cloud\Compute\V1\HttpRedirectAction $url_redirect - * When a path pattern is matched, the request is redirected to a URL specified by urlRedirect. Only one of urlRedirect, service or routeAction.weightedBackendService can be set. Not supported when the URL map is bound to a target gRPC proxy. + * When a path pattern is matched, the request is redirected to a URL + * specified by urlRedirect. + * Only one of urlRedirect, service orrouteAction.weightedBackendService can be set. + * Not supported when the URL map is bound to a target gRPC proxy. * } */ public function __construct($data = NULL) { @@ -70,7 +142,26 @@ public function __construct($data = NULL) { } /** - * customErrorResponsePolicy specifies how the Load Balancer returns error responses when BackendServiceor BackendBucket responds with an error. If a policy for an error code is not configured for the PathRule, a policy for the error code configured in pathMatcher.defaultCustomErrorResponsePolicy is applied. If one is not specified in pathMatcher.defaultCustomErrorResponsePolicy, the policy configured in UrlMap.defaultCustomErrorResponsePolicy takes effect. For example, consider a UrlMap with the following configuration: - UrlMap.defaultCustomErrorResponsePolicy are configured with policies for 5xx and 4xx errors - A PathRule for /coming_soon/ is configured for the error code 404. If the request is for www.myotherdomain.com and a 404 is encountered, the policy under UrlMap.defaultCustomErrorResponsePolicy takes effect. If a 404 response is encountered for the request www.example.com/current_events/, the pathMatcher's policy takes effect. If however, the request for www.example.com/coming_soon/ encounters a 404, the policy in PathRule.customErrorResponsePolicy takes effect. If any of the requests in this example encounter a 500 error code, the policy at UrlMap.defaultCustomErrorResponsePolicy takes effect. customErrorResponsePolicy is supported only for global external Application Load Balancers. + * customErrorResponsePolicy specifies how the Load + * Balancer returns error responses when BackendServiceorBackendBucket responds with an error. + * If a policy for an + * error code is not configured for the PathRule, a policy for + * the error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If + * one is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy + * configured in UrlMap.defaultCustomErrorResponsePolicy takes + * effect. + * For example, consider a UrlMap with the following configuration: + * - UrlMap.defaultCustomErrorResponsePolicy are configured + * with policies for 5xx and 4xx errors + * - A PathRule for /coming_soon/ is configured for the error + * code 404. + * If the request is for www.myotherdomain.com and a404 is encountered, the policy underUrlMap.defaultCustomErrorResponsePolicy takes effect. If a404 response is encountered for the requestwww.example.com/current_events/, the pathMatcher's policy + * takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404, + * the policy in PathRule.customErrorResponsePolicy takes + * effect. If any of the requests in this example encounter a 500 + * error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect. + * customErrorResponsePolicy is supported only for + * global external Application Load Balancers. * * Generated from protobuf field optional .google.cloud.compute.v1.CustomErrorResponsePolicy custom_error_response_policy = 202816619; * @return \Google\Cloud\Compute\V1\CustomErrorResponsePolicy|null @@ -91,7 +182,26 @@ public function clearCustomErrorResponsePolicy() } /** - * customErrorResponsePolicy specifies how the Load Balancer returns error responses when BackendServiceor BackendBucket responds with an error. If a policy for an error code is not configured for the PathRule, a policy for the error code configured in pathMatcher.defaultCustomErrorResponsePolicy is applied. If one is not specified in pathMatcher.defaultCustomErrorResponsePolicy, the policy configured in UrlMap.defaultCustomErrorResponsePolicy takes effect. For example, consider a UrlMap with the following configuration: - UrlMap.defaultCustomErrorResponsePolicy are configured with policies for 5xx and 4xx errors - A PathRule for /coming_soon/ is configured for the error code 404. If the request is for www.myotherdomain.com and a 404 is encountered, the policy under UrlMap.defaultCustomErrorResponsePolicy takes effect. If a 404 response is encountered for the request www.example.com/current_events/, the pathMatcher's policy takes effect. If however, the request for www.example.com/coming_soon/ encounters a 404, the policy in PathRule.customErrorResponsePolicy takes effect. If any of the requests in this example encounter a 500 error code, the policy at UrlMap.defaultCustomErrorResponsePolicy takes effect. customErrorResponsePolicy is supported only for global external Application Load Balancers. + * customErrorResponsePolicy specifies how the Load + * Balancer returns error responses when BackendServiceorBackendBucket responds with an error. + * If a policy for an + * error code is not configured for the PathRule, a policy for + * the error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If + * one is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy + * configured in UrlMap.defaultCustomErrorResponsePolicy takes + * effect. + * For example, consider a UrlMap with the following configuration: + * - UrlMap.defaultCustomErrorResponsePolicy are configured + * with policies for 5xx and 4xx errors + * - A PathRule for /coming_soon/ is configured for the error + * code 404. + * If the request is for www.myotherdomain.com and a404 is encountered, the policy underUrlMap.defaultCustomErrorResponsePolicy takes effect. If a404 response is encountered for the requestwww.example.com/current_events/, the pathMatcher's policy + * takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404, + * the policy in PathRule.customErrorResponsePolicy takes + * effect. If any of the requests in this example encounter a 500 + * error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect. + * customErrorResponsePolicy is supported only for + * global external Application Load Balancers. * * Generated from protobuf field optional .google.cloud.compute.v1.CustomErrorResponsePolicy custom_error_response_policy = 202816619; * @param \Google\Cloud\Compute\V1\CustomErrorResponsePolicy $var @@ -106,7 +216,11 @@ public function setCustomErrorResponsePolicy($var) } /** - * The list of path patterns to match. Each must start with / and the only place a * is allowed is at the end following a /. The string fed to the path matcher does not include any text after the first ? or #, and those chars are not allowed here. + * The list of path patterns to match. Each must start with / + * and the only place a * is allowed is at the end following + * a /. The string fed to the path matcher does not include + * any text after the first ? or #, and + * those chars are not allowed here. * * Generated from protobuf field repeated string paths = 106438894; * @return \Google\Protobuf\Internal\RepeatedField @@ -117,7 +231,11 @@ public function getPaths() } /** - * The list of path patterns to match. Each must start with / and the only place a * is allowed is at the end following a /. The string fed to the path matcher does not include any text after the first ? or #, and those chars are not allowed here. + * The list of path patterns to match. Each must start with / + * and the only place a * is allowed is at the end following + * a /. The string fed to the path matcher does not include + * any text after the first ? or #, and + * those chars are not allowed here. * * Generated from protobuf field repeated string paths = 106438894; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -132,7 +250,13 @@ public function setPaths($var) } /** - * In response to a matching path, the load balancer performs advanced routing actions, such as URL rewrites and header transformations, before forwarding the request to the selected backend. Only one of urlRedirect, service or routeAction.weightedBackendService can be set. URL maps for classic Application Load Balancers only support the urlRewrite action within a path rule's routeAction. + * In response to a matching path, the load balancer + * performs advanced routing actions, such as URL rewrites and header + * transformations, before forwarding the request to the selected + * backend. + * Only one of urlRedirect, service orrouteAction.weightedBackendService can be set. + * URL maps for classic Application Load Balancers only support + * the urlRewrite action within a path rule'srouteAction. * * Generated from protobuf field optional .google.cloud.compute.v1.HttpRouteAction route_action = 424563948; * @return \Google\Cloud\Compute\V1\HttpRouteAction|null @@ -153,7 +277,13 @@ public function clearRouteAction() } /** - * In response to a matching path, the load balancer performs advanced routing actions, such as URL rewrites and header transformations, before forwarding the request to the selected backend. Only one of urlRedirect, service or routeAction.weightedBackendService can be set. URL maps for classic Application Load Balancers only support the urlRewrite action within a path rule's routeAction. + * In response to a matching path, the load balancer + * performs advanced routing actions, such as URL rewrites and header + * transformations, before forwarding the request to the selected + * backend. + * Only one of urlRedirect, service orrouteAction.weightedBackendService can be set. + * URL maps for classic Application Load Balancers only support + * the urlRewrite action within a path rule'srouteAction. * * Generated from protobuf field optional .google.cloud.compute.v1.HttpRouteAction route_action = 424563948; * @param \Google\Cloud\Compute\V1\HttpRouteAction $var @@ -168,7 +298,11 @@ public function setRouteAction($var) } /** - * The full or partial URL of the backend service resource to which traffic is directed if this rule is matched. If routeAction is also specified, advanced routing actions, such as URL rewrites, take effect before sending the request to the backend. Only one of urlRedirect, service or routeAction.weightedBackendService can be set. + * The full or partial URL of the backend service resource to which traffic + * is directed if this rule is matched. If routeAction is + * also specified, advanced routing actions, such as URL rewrites, + * take effect before sending the request to the backend. + * Only one of urlRedirect, service orrouteAction.weightedBackendService can be set. * * Generated from protobuf field optional string service = 373540533; * @return string @@ -189,7 +323,11 @@ public function clearService() } /** - * The full or partial URL of the backend service resource to which traffic is directed if this rule is matched. If routeAction is also specified, advanced routing actions, such as URL rewrites, take effect before sending the request to the backend. Only one of urlRedirect, service or routeAction.weightedBackendService can be set. + * The full or partial URL of the backend service resource to which traffic + * is directed if this rule is matched. If routeAction is + * also specified, advanced routing actions, such as URL rewrites, + * take effect before sending the request to the backend. + * Only one of urlRedirect, service orrouteAction.weightedBackendService can be set. * * Generated from protobuf field optional string service = 373540533; * @param string $var @@ -204,7 +342,10 @@ public function setService($var) } /** - * When a path pattern is matched, the request is redirected to a URL specified by urlRedirect. Only one of urlRedirect, service or routeAction.weightedBackendService can be set. Not supported when the URL map is bound to a target gRPC proxy. + * When a path pattern is matched, the request is redirected to a URL + * specified by urlRedirect. + * Only one of urlRedirect, service orrouteAction.weightedBackendService can be set. + * Not supported when the URL map is bound to a target gRPC proxy. * * Generated from protobuf field optional .google.cloud.compute.v1.HttpRedirectAction url_redirect = 405147820; * @return \Google\Cloud\Compute\V1\HttpRedirectAction|null @@ -225,7 +366,10 @@ public function clearUrlRedirect() } /** - * When a path pattern is matched, the request is redirected to a URL specified by urlRedirect. Only one of urlRedirect, service or routeAction.weightedBackendService can be set. Not supported when the URL map is bound to a target gRPC proxy. + * When a path pattern is matched, the request is redirected to a URL + * specified by urlRedirect. + * Only one of urlRedirect, service orrouteAction.weightedBackendService can be set. + * Not supported when the URL map is bound to a target gRPC proxy. * * Generated from protobuf field optional .google.cloud.compute.v1.HttpRedirectAction url_redirect = 405147820; * @param \Google\Cloud\Compute\V1\HttpRedirectAction $var diff --git a/Compute/src/V1/PerInstanceConfig.php b/Compute/src/V1/PerInstanceConfig.php index b1ae100f728d..e505ab4d154b 100644 --- a/Compute/src/V1/PerInstanceConfig.php +++ b/Compute/src/V1/PerInstanceConfig.php @@ -15,25 +15,36 @@ class PerInstanceConfig extends \Google\Protobuf\Internal\Message { /** - * Fingerprint of this per-instance config. This field can be used in optimistic locking. It is ignored when inserting a per-instance config. An up-to-date fingerprint must be provided in order to update an existing per-instance configuration or the field needs to be unset. + * Fingerprint of this per-instance config. This field can be used in + * optimistic locking. It is ignored when inserting a per-instance + * config. An up-to-date fingerprint must be provided in order to update an + * existing per-instance configuration or the field needs to be unset. * * Generated from protobuf field optional string fingerprint = 234678500; */ protected $fingerprint = null; /** - * The name of a per-instance configuration and its corresponding instance. Serves as a merge key during UpdatePerInstanceConfigs operations, that is, if a per-instance configuration with the same name exists then it will be updated, otherwise a new one will be created for the VM instance with the same name. An attempt to create a per-instance configuration for a VM instance that either doesn't exist or is not part of the group will result in an error. + * The name of a per-instance configuration and its corresponding instance. + * Serves as a merge key during UpdatePerInstanceConfigs + * operations, that is, if a per-instance configuration with the same name + * exists then it will be updated, otherwise a new one will be created for the + * VM instance with the same name. An attempt to create a per-instance + * configuration for a VM instance that either doesn't exist or is not part + * of the group will result in an error. * * Generated from protobuf field optional string name = 3373707; */ protected $name = null; /** - * The intended preserved state for the given instance. Does not contain preserved state generated from a stateful policy. + * The intended preserved state for the given instance. Does not contain + * preserved state generated from a stateful policy. * * Generated from protobuf field optional .google.cloud.compute.v1.PreservedState preserved_state = 2634026; */ protected $preserved_state = null; /** - * The status of applying this per-instance configuration on the corresponding managed instance. + * The status of applying this per-instance configuration on the corresponding + * managed instance. * Check the Status enum for the list of possible values. * * Generated from protobuf field optional string status = 181260274; @@ -47,13 +58,24 @@ class PerInstanceConfig extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $fingerprint - * Fingerprint of this per-instance config. This field can be used in optimistic locking. It is ignored when inserting a per-instance config. An up-to-date fingerprint must be provided in order to update an existing per-instance configuration or the field needs to be unset. + * Fingerprint of this per-instance config. This field can be used in + * optimistic locking. It is ignored when inserting a per-instance + * config. An up-to-date fingerprint must be provided in order to update an + * existing per-instance configuration or the field needs to be unset. * @type string $name - * The name of a per-instance configuration and its corresponding instance. Serves as a merge key during UpdatePerInstanceConfigs operations, that is, if a per-instance configuration with the same name exists then it will be updated, otherwise a new one will be created for the VM instance with the same name. An attempt to create a per-instance configuration for a VM instance that either doesn't exist or is not part of the group will result in an error. + * The name of a per-instance configuration and its corresponding instance. + * Serves as a merge key during UpdatePerInstanceConfigs + * operations, that is, if a per-instance configuration with the same name + * exists then it will be updated, otherwise a new one will be created for the + * VM instance with the same name. An attempt to create a per-instance + * configuration for a VM instance that either doesn't exist or is not part + * of the group will result in an error. * @type \Google\Cloud\Compute\V1\PreservedState $preserved_state - * The intended preserved state for the given instance. Does not contain preserved state generated from a stateful policy. + * The intended preserved state for the given instance. Does not contain + * preserved state generated from a stateful policy. * @type string $status - * The status of applying this per-instance configuration on the corresponding managed instance. + * The status of applying this per-instance configuration on the corresponding + * managed instance. * Check the Status enum for the list of possible values. * } */ @@ -63,7 +85,10 @@ public function __construct($data = NULL) { } /** - * Fingerprint of this per-instance config. This field can be used in optimistic locking. It is ignored when inserting a per-instance config. An up-to-date fingerprint must be provided in order to update an existing per-instance configuration or the field needs to be unset. + * Fingerprint of this per-instance config. This field can be used in + * optimistic locking. It is ignored when inserting a per-instance + * config. An up-to-date fingerprint must be provided in order to update an + * existing per-instance configuration or the field needs to be unset. * * Generated from protobuf field optional string fingerprint = 234678500; * @return string @@ -84,7 +109,10 @@ public function clearFingerprint() } /** - * Fingerprint of this per-instance config. This field can be used in optimistic locking. It is ignored when inserting a per-instance config. An up-to-date fingerprint must be provided in order to update an existing per-instance configuration or the field needs to be unset. + * Fingerprint of this per-instance config. This field can be used in + * optimistic locking. It is ignored when inserting a per-instance + * config. An up-to-date fingerprint must be provided in order to update an + * existing per-instance configuration or the field needs to be unset. * * Generated from protobuf field optional string fingerprint = 234678500; * @param string $var @@ -99,7 +127,13 @@ public function setFingerprint($var) } /** - * The name of a per-instance configuration and its corresponding instance. Serves as a merge key during UpdatePerInstanceConfigs operations, that is, if a per-instance configuration with the same name exists then it will be updated, otherwise a new one will be created for the VM instance with the same name. An attempt to create a per-instance configuration for a VM instance that either doesn't exist or is not part of the group will result in an error. + * The name of a per-instance configuration and its corresponding instance. + * Serves as a merge key during UpdatePerInstanceConfigs + * operations, that is, if a per-instance configuration with the same name + * exists then it will be updated, otherwise a new one will be created for the + * VM instance with the same name. An attempt to create a per-instance + * configuration for a VM instance that either doesn't exist or is not part + * of the group will result in an error. * * Generated from protobuf field optional string name = 3373707; * @return string @@ -120,7 +154,13 @@ public function clearName() } /** - * The name of a per-instance configuration and its corresponding instance. Serves as a merge key during UpdatePerInstanceConfigs operations, that is, if a per-instance configuration with the same name exists then it will be updated, otherwise a new one will be created for the VM instance with the same name. An attempt to create a per-instance configuration for a VM instance that either doesn't exist or is not part of the group will result in an error. + * The name of a per-instance configuration and its corresponding instance. + * Serves as a merge key during UpdatePerInstanceConfigs + * operations, that is, if a per-instance configuration with the same name + * exists then it will be updated, otherwise a new one will be created for the + * VM instance with the same name. An attempt to create a per-instance + * configuration for a VM instance that either doesn't exist or is not part + * of the group will result in an error. * * Generated from protobuf field optional string name = 3373707; * @param string $var @@ -135,7 +175,8 @@ public function setName($var) } /** - * The intended preserved state for the given instance. Does not contain preserved state generated from a stateful policy. + * The intended preserved state for the given instance. Does not contain + * preserved state generated from a stateful policy. * * Generated from protobuf field optional .google.cloud.compute.v1.PreservedState preserved_state = 2634026; * @return \Google\Cloud\Compute\V1\PreservedState|null @@ -156,7 +197,8 @@ public function clearPreservedState() } /** - * The intended preserved state for the given instance. Does not contain preserved state generated from a stateful policy. + * The intended preserved state for the given instance. Does not contain + * preserved state generated from a stateful policy. * * Generated from protobuf field optional .google.cloud.compute.v1.PreservedState preserved_state = 2634026; * @param \Google\Cloud\Compute\V1\PreservedState $var @@ -171,7 +213,8 @@ public function setPreservedState($var) } /** - * The status of applying this per-instance configuration on the corresponding managed instance. + * The status of applying this per-instance configuration on the corresponding + * managed instance. * Check the Status enum for the list of possible values. * * Generated from protobuf field optional string status = 181260274; @@ -193,7 +236,8 @@ public function clearStatus() } /** - * The status of applying this per-instance configuration on the corresponding managed instance. + * The status of applying this per-instance configuration on the corresponding + * managed instance. * Check the Status enum for the list of possible values. * * Generated from protobuf field optional string status = 181260274; diff --git a/Compute/src/V1/PerInstanceConfig/Status.php b/Compute/src/V1/PerInstanceConfig/Status.php index d26e274d6e67..5efabdb90e7d 100644 --- a/Compute/src/V1/PerInstanceConfig/Status.php +++ b/Compute/src/V1/PerInstanceConfig/Status.php @@ -7,7 +7,8 @@ use UnexpectedValueException; /** - * The status of applying this per-instance configuration on the corresponding managed instance. + * The status of applying this per-instance configuration on the corresponding + * managed instance. * * Protobuf type google.cloud.compute.v1.PerInstanceConfig.Status */ @@ -20,37 +21,44 @@ class Status */ const UNDEFINED_STATUS = 0; /** - * The per-instance configuration is being applied to the instance, but is not yet effective, possibly waiting for the instance to, for example, REFRESH. + * The per-instance configuration is being applied to the instance, but is + * not yet effective, possibly waiting for the instance to, for example,REFRESH. * * Generated from protobuf enum APPLYING = 352003508; */ const APPLYING = 352003508; /** - * The per-instance configuration deletion is being applied on the instance, possibly waiting for the instance to, for example, REFRESH. + * The per-instance configuration deletion is being applied on the instance, + * possibly waiting for the instance to, for example, REFRESH. * * Generated from protobuf enum DELETING = 528602024; */ const DELETING = 528602024; /** - * The per-instance configuration is effective on the instance, meaning that all disks, ips and metadata specified in this configuration are attached or set on the instance. + * The per-instance configuration is effective on the instance, meaning that + * all disks, ips and metadata specified in this configuration are attached + * or set on the instance. * * Generated from protobuf enum EFFECTIVE = 244201863; */ const EFFECTIVE = 244201863; /** - * *[Default]* The default status, when no per-instance configuration exists. + * *[Default]* The default status, when no per-instance configuration + * exists. * * Generated from protobuf enum NONE = 2402104; */ const NONE = 2402104; /** - * The per-instance configuration is set on an instance but not been applied yet. + * The per-instance configuration is set on an instance but not been applied + * yet. * * Generated from protobuf enum UNAPPLIED = 483935140; */ const UNAPPLIED = 483935140; /** - * The per-instance configuration has been deleted, but the deletion is not yet applied. + * The per-instance configuration has been deleted, but the deletion is not + * yet applied. * * Generated from protobuf enum UNAPPLIED_DELETION = 313956873; */ diff --git a/Compute/src/V1/PerformMaintenanceInstanceRequest.php b/Compute/src/V1/PerformMaintenanceInstanceRequest.php index 5da61208f55c..ee8d158e1813 100644 --- a/Compute/src/V1/PerformMaintenanceInstanceRequest.php +++ b/Compute/src/V1/PerformMaintenanceInstanceRequest.php @@ -28,7 +28,17 @@ class PerformMaintenanceInstanceRequest extends \Google\Protobuf\Internal\Messag */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -68,7 +78,17 @@ public static function build(string $project, string $zone, string $instance): s * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $zone * The name of the zone for this request. * } @@ -131,7 +151,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -152,7 +182,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/PerformMaintenanceNodeGroupRequest.php b/Compute/src/V1/PerformMaintenanceNodeGroupRequest.php index e19e485989c9..1b3a2ab93b14 100644 --- a/Compute/src/V1/PerformMaintenanceNodeGroupRequest.php +++ b/Compute/src/V1/PerformMaintenanceNodeGroupRequest.php @@ -34,7 +34,17 @@ class PerformMaintenanceNodeGroupRequest extends \Google\Protobuf\Internal\Messa */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -78,7 +88,17 @@ public static function build(string $project, string $zone, string $nodeGroup, \ * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $zone * The name of the zone for this request. * } @@ -177,7 +197,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -198,7 +228,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/PerformMaintenanceReservationBlockRequest.php b/Compute/src/V1/PerformMaintenanceReservationBlockRequest.php index 642ba3e82977..9e7a306d9d77 100644 --- a/Compute/src/V1/PerformMaintenanceReservationBlockRequest.php +++ b/Compute/src/V1/PerformMaintenanceReservationBlockRequest.php @@ -22,19 +22,31 @@ class PerformMaintenanceReservationBlockRequest extends \Google\Protobuf\Interna */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ protected $request_id = null; /** - * The name of the reservation. Name should conform to RFC1035 or be a resource ID. + * The name of the reservation. + * Name should conform to RFC1035 or be a resource ID. * * Generated from protobuf field string reservation = 47530956 [(.google.api.field_behavior) = REQUIRED]; */ protected $reservation = ''; /** - * The name of the reservation block. Name should conform to RFC1035 or be a resource ID. + * The name of the reservation block. + * Name should conform to RFC1035 or be a resource ID. * * Generated from protobuf field string reservation_block = 532832858 [(.google.api.field_behavior) = REQUIRED]; */ @@ -55,8 +67,10 @@ class PerformMaintenanceReservationBlockRequest extends \Google\Protobuf\Interna /** * @param string $project Project ID for this request. * @param string $zone Name of the zone for this request. Zone name should conform to RFC1035. - * @param string $reservation The name of the reservation. Name should conform to RFC1035 or be a resource ID. - * @param string $reservationBlock The name of the reservation block. Name should conform to RFC1035 or be a resource ID. + * @param string $reservation The name of the reservation. + * Name should conform to RFC1035 or be a resource ID. + * @param string $reservationBlock The name of the reservation block. + * Name should conform to RFC1035 or be a resource ID. * @param \Google\Cloud\Compute\V1\ReservationsBlocksPerformMaintenanceRequest $reservationsBlocksPerformMaintenanceRequestResource The body resource for this request * * @return \Google\Cloud\Compute\V1\PerformMaintenanceReservationBlockRequest @@ -82,11 +96,23 @@ public static function build(string $project, string $zone, string $reservation, * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $reservation - * The name of the reservation. Name should conform to RFC1035 or be a resource ID. + * The name of the reservation. + * Name should conform to RFC1035 or be a resource ID. * @type string $reservation_block - * The name of the reservation block. Name should conform to RFC1035 or be a resource ID. + * The name of the reservation block. + * Name should conform to RFC1035 or be a resource ID. * @type \Google\Cloud\Compute\V1\ReservationsBlocksPerformMaintenanceRequest $reservations_blocks_perform_maintenance_request_resource * The body resource for this request * @type string $zone @@ -125,7 +151,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -146,7 +182,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var @@ -161,7 +207,8 @@ public function setRequestId($var) } /** - * The name of the reservation. Name should conform to RFC1035 or be a resource ID. + * The name of the reservation. + * Name should conform to RFC1035 or be a resource ID. * * Generated from protobuf field string reservation = 47530956 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -172,7 +219,8 @@ public function getReservation() } /** - * The name of the reservation. Name should conform to RFC1035 or be a resource ID. + * The name of the reservation. + * Name should conform to RFC1035 or be a resource ID. * * Generated from protobuf field string reservation = 47530956 [(.google.api.field_behavior) = REQUIRED]; * @param string $var @@ -187,7 +235,8 @@ public function setReservation($var) } /** - * The name of the reservation block. Name should conform to RFC1035 or be a resource ID. + * The name of the reservation block. + * Name should conform to RFC1035 or be a resource ID. * * Generated from protobuf field string reservation_block = 532832858 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -198,7 +247,8 @@ public function getReservationBlock() } /** - * The name of the reservation block. Name should conform to RFC1035 or be a resource ID. + * The name of the reservation block. + * Name should conform to RFC1035 or be a resource ID. * * Generated from protobuf field string reservation_block = 532832858 [(.google.api.field_behavior) = REQUIRED]; * @param string $var diff --git a/Compute/src/V1/PerformMaintenanceReservationRequest.php b/Compute/src/V1/PerformMaintenanceReservationRequest.php index faded37bcdaf..1add76e4ca78 100644 --- a/Compute/src/V1/PerformMaintenanceReservationRequest.php +++ b/Compute/src/V1/PerformMaintenanceReservationRequest.php @@ -22,13 +22,24 @@ class PerformMaintenanceReservationRequest extends \Google\Protobuf\Internal\Mes */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ protected $request_id = null; /** - * The name of the reservation. Name should conform to RFC1035 or be a resource ID. + * The name of the reservation. + * Name should conform to RFC1035 or be a resource ID. * * Generated from protobuf field string reservation = 47530956 [(.google.api.field_behavior) = REQUIRED]; */ @@ -49,7 +60,8 @@ class PerformMaintenanceReservationRequest extends \Google\Protobuf\Internal\Mes /** * @param string $project Project ID for this request. * @param string $zone Name of the zone for this request. Zone name should conform to RFC1035. - * @param string $reservation The name of the reservation. Name should conform to RFC1035 or be a resource ID. + * @param string $reservation The name of the reservation. + * Name should conform to RFC1035 or be a resource ID. * @param \Google\Cloud\Compute\V1\ReservationsPerformMaintenanceRequest $reservationsPerformMaintenanceRequestResource The body resource for this request * * @return \Google\Cloud\Compute\V1\PerformMaintenanceReservationRequest @@ -74,9 +86,20 @@ public static function build(string $project, string $zone, string $reservation, * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $reservation - * The name of the reservation. Name should conform to RFC1035 or be a resource ID. + * The name of the reservation. + * Name should conform to RFC1035 or be a resource ID. * @type \Google\Cloud\Compute\V1\ReservationsPerformMaintenanceRequest $reservations_perform_maintenance_request_resource * The body resource for this request * @type string $zone @@ -115,7 +138,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -136,7 +169,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var @@ -151,7 +194,8 @@ public function setRequestId($var) } /** - * The name of the reservation. Name should conform to RFC1035 or be a resource ID. + * The name of the reservation. + * Name should conform to RFC1035 or be a resource ID. * * Generated from protobuf field string reservation = 47530956 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -162,7 +206,8 @@ public function getReservation() } /** - * The name of the reservation. Name should conform to RFC1035 or be a resource ID. + * The name of the reservation. + * Name should conform to RFC1035 or be a resource ID. * * Generated from protobuf field string reservation = 47530956 [(.google.api.field_behavior) = REQUIRED]; * @param string $var diff --git a/Compute/src/V1/PerformMaintenanceReservationSubBlockRequest.php b/Compute/src/V1/PerformMaintenanceReservationSubBlockRequest.php index 954cd749cc5c..e7f7cc77a37b 100644 --- a/Compute/src/V1/PerformMaintenanceReservationSubBlockRequest.php +++ b/Compute/src/V1/PerformMaintenanceReservationSubBlockRequest.php @@ -16,7 +16,8 @@ class PerformMaintenanceReservationSubBlockRequest extends \Google\Protobuf\Internal\Message { /** - * The name of the parent reservation and parent block. In the format of reservations/{reservation_name}/reservationBlocks/{reservation_block_name} + * The name of the parent reservation and parent block. In the format of + * reservations/{reservation_name}/reservationBlocks/{reservation_block_name} * * Generated from protobuf field string parent_name = 478151936 [(.google.api.field_behavior) = REQUIRED]; */ @@ -28,13 +29,24 @@ class PerformMaintenanceReservationSubBlockRequest extends \Google\Protobuf\Inte */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ protected $request_id = null; /** - * The name of the reservation subBlock. Name should conform to RFC1035 or be a resource ID. + * The name of the reservation subBlock. + * Name should conform to RFC1035 or be a resource ID. * * Generated from protobuf field string reservation_sub_block = 22750491 [(.google.api.field_behavior) = REQUIRED]; */ @@ -49,8 +61,10 @@ class PerformMaintenanceReservationSubBlockRequest extends \Google\Protobuf\Inte /** * @param string $project Project ID for this request. * @param string $zone Name of the zone for this request. Zone name should conform to RFC1035. - * @param string $parentName The name of the parent reservation and parent block. In the format of reservations/{reservation_name}/reservationBlocks/{reservation_block_name} - * @param string $reservationSubBlock The name of the reservation subBlock. Name should conform to RFC1035 or be a resource ID. + * @param string $parentName The name of the parent reservation and parent block. In the format of + * reservations/{reservation_name}/reservationBlocks/{reservation_block_name} + * @param string $reservationSubBlock The name of the reservation subBlock. + * Name should conform to RFC1035 or be a resource ID. * * @return \Google\Cloud\Compute\V1\PerformMaintenanceReservationSubBlockRequest * @@ -72,13 +86,25 @@ public static function build(string $project, string $zone, string $parentName, * Optional. Data for populating the Message object. * * @type string $parent_name - * The name of the parent reservation and parent block. In the format of reservations/{reservation_name}/reservationBlocks/{reservation_block_name} + * The name of the parent reservation and parent block. In the format of + * reservations/{reservation_name}/reservationBlocks/{reservation_block_name} * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $reservation_sub_block - * The name of the reservation subBlock. Name should conform to RFC1035 or be a resource ID. + * The name of the reservation subBlock. + * Name should conform to RFC1035 or be a resource ID. * @type string $zone * Name of the zone for this request. Zone name should conform to RFC1035. * } @@ -89,7 +115,8 @@ public function __construct($data = NULL) { } /** - * The name of the parent reservation and parent block. In the format of reservations/{reservation_name}/reservationBlocks/{reservation_block_name} + * The name of the parent reservation and parent block. In the format of + * reservations/{reservation_name}/reservationBlocks/{reservation_block_name} * * Generated from protobuf field string parent_name = 478151936 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -100,7 +127,8 @@ public function getParentName() } /** - * The name of the parent reservation and parent block. In the format of reservations/{reservation_name}/reservationBlocks/{reservation_block_name} + * The name of the parent reservation and parent block. In the format of + * reservations/{reservation_name}/reservationBlocks/{reservation_block_name} * * Generated from protobuf field string parent_name = 478151936 [(.google.api.field_behavior) = REQUIRED]; * @param string $var @@ -141,7 +169,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -162,7 +200,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var @@ -177,7 +225,8 @@ public function setRequestId($var) } /** - * The name of the reservation subBlock. Name should conform to RFC1035 or be a resource ID. + * The name of the reservation subBlock. + * Name should conform to RFC1035 or be a resource ID. * * Generated from protobuf field string reservation_sub_block = 22750491 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -188,7 +237,8 @@ public function getReservationSubBlock() } /** - * The name of the reservation subBlock. Name should conform to RFC1035 or be a resource ID. + * The name of the reservation subBlock. + * Name should conform to RFC1035 or be a resource ID. * * Generated from protobuf field string reservation_sub_block = 22750491 [(.google.api.field_behavior) = REQUIRED]; * @param string $var diff --git a/Compute/src/V1/Policy.php b/Compute/src/V1/Policy.php index d43151e82bad..0fec69561a20 100644 --- a/Compute/src/V1/Policy.php +++ b/Compute/src/V1/Policy.php @@ -9,7 +9,69 @@ use Google\Protobuf\Internal\GPBUtil; /** - * An Identity and Access Management (IAM) policy, which specifies access controls for Google Cloud resources. A `Policy` is a collection of `bindings`. A `binding` binds one or more `members`, or principals, to a single `role`. Principals can be user accounts, service accounts, Google groups, and domains (such as G Suite). A `role` is a named list of permissions; each `role` can be an IAM predefined role or a user-created custom role. For some types of Google Cloud resources, a `binding` can also specify a `condition`, which is a logical expression that allows access to a resource only if the expression evaluates to `true`. A condition can add constraints based on attributes of the request, the resource, or both. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies). **JSON example:** ``` { "bindings": [ { "role": "roles/resourcemanager.organizationAdmin", "members": [ "user:mike@example.com", "group:admins@example.com", "domain:google.com", "serviceAccount:my-project-id@appspot.gserviceaccount.com" ] }, { "role": "roles/resourcemanager.organizationViewer", "members": [ "user:eve@example.com" ], "condition": { "title": "expirable access", "description": "Does not grant access after Sep 2020", "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')", } } ], "etag": "BwWWja0YfJA=", "version": 3 } ``` **YAML example:** ``` bindings: - members: - user:mike@example.com - group:admins@example.com - domain:google.com - serviceAccount:my-project-id@appspot.gserviceaccount.com role: roles/resourcemanager.organizationAdmin - members: - user:eve@example.com role: roles/resourcemanager.organizationViewer condition: title: expirable access description: Does not grant access after Sep 2020 expression: request.time < timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= version: 3 ``` For a description of IAM and its features, see the [IAM documentation](https://cloud.google.com/iam/docs/). + * An Identity and Access Management (IAM) policy, which specifies access + * controls for Google Cloud resources. + * A `Policy` is a collection of `bindings`. A `binding` binds one or more + * `members`, or principals, to a single `role`. Principals can be user + * accounts, service accounts, Google groups, and domains (such as G Suite). A + * `role` is a named list of permissions; each `role` can be an IAM predefined + * role or a user-created custom role. + * For some types of Google Cloud resources, a `binding` can also specify a + * `condition`, which is a logical expression that allows access to a resource + * only if the expression evaluates to `true`. A condition can add constraints + * based on attributes of the request, the resource, or both. To learn which + * resources support conditions in their IAM policies, see the + * [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies). + * **JSON example:** + * ``` + * { + * "bindings": [ + * { + * "role": "roles/resourcemanager.organizationAdmin", + * "members": [ + * "user:mike@example.com", + * "group:admins@example.com", + * "domain:google.com", + * "serviceAccount:my-project-id@appspot.gserviceaccount.com" + * ] + * }, + * { + * "role": "roles/resourcemanager.organizationViewer", + * "members": [ + * "user:eve@example.com" + * ], + * "condition": { + * "title": "expirable access", + * "description": "Does not grant access after Sep 2020", + * "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')", + * } + * } + * ], + * "etag": "BwWWja0YfJA=", + * "version": 3 + * } + * ``` + * **YAML example:** + * ``` + * bindings: + * - members: + * - user:mike@example.com + * - group:admins@example.com + * - domain:google.com + * - serviceAccount:my-project-id@appspot.gserviceaccount.com + * role: roles/resourcemanager.organizationAdmin + * - members: + * - user:eve@example.com + * role: roles/resourcemanager.organizationViewer + * condition: + * title: expirable access + * description: Does not grant access after Sep 2020 + * expression: request.time < timestamp('2020-10-01T00:00:00.000Z') + * etag: BwWWja0YfJA= + * version: 3 + * ``` + * For a description of IAM and its features, see the + * [IAM documentation](https://cloud.google.com/iam/docs/). * * Generated from protobuf message google.cloud.compute.v1.Policy */ @@ -22,13 +84,31 @@ class Policy extends \Google\Protobuf\Internal\Message */ private $audit_configs; /** - * Associates a list of `members`, or principals, with a `role`. Optionally, may specify a `condition` that determines how and when the `bindings` are applied. Each of the `bindings` must contain at least one principal. The `bindings` in a `Policy` can refer to up to 1,500 principals; up to 250 of these principals can be Google groups. Each occurrence of a principal counts towards these limits. For example, if the `bindings` grant 50 different roles to `user:alice@example.com`, and not to any other principal, then you can add another 1,450 principals to the `bindings` in the `Policy`. + * Associates a list of `members`, or principals, with a `role`. Optionally, + * may specify a `condition` that determines how and when the `bindings` are + * applied. Each of the `bindings` must contain at least one principal. + * The `bindings` in a `Policy` can refer to up to 1,500 principals; up to 250 + * of these principals can be Google groups. Each occurrence of a principal + * counts towards these limits. For example, if the `bindings` grant 50 + * different roles to `user:alice@example.com`, and not to any other + * principal, then you can add another 1,450 principals to the `bindings` in + * the `Policy`. * * Generated from protobuf field repeated .google.cloud.compute.v1.Binding bindings = 403251854; */ private $bindings; /** - * `etag` is used for optimistic concurrency control as a way to help prevent simultaneous updates of a policy from overwriting each other. It is strongly suggested that systems make use of the `etag` in the read-modify-write cycle to perform policy updates in order to avoid race conditions: An `etag` is returned in the response to `getIamPolicy`, and systems are expected to put that etag in the request to `setIamPolicy` to ensure that their change will be applied to the same version of the policy. **Important:** If you use IAM Conditions, you must include the `etag` field whenever you call `setIamPolicy`. If you omit this field, then IAM allows you to overwrite a version `3` policy with a version `1` policy, and all of the conditions in the version `3` policy are lost. + * `etag` is used for optimistic concurrency control as a way to help + * prevent simultaneous updates of a policy from overwriting each other. + * It is strongly suggested that systems make use of the `etag` in the + * read-modify-write cycle to perform policy updates in order to avoid race + * conditions: An `etag` is returned in the response to `getIamPolicy`, and + * systems are expected to put that etag in the request to `setIamPolicy` to + * ensure that their change will be applied to the same version of the policy. + * **Important:** If you use IAM Conditions, you must include the `etag` field + * whenever you call `setIamPolicy`. If you omit this field, then IAM allows + * you to overwrite a version `3` policy with a version `1` policy, and all of + * the conditions in the version `3` policy are lost. * * Generated from protobuf field optional string etag = 3123477; */ @@ -38,7 +118,24 @@ class Policy extends \Google\Protobuf\Internal\Message */ protected $iam_owned = null; /** - * Specifies the format of the policy. Valid values are `0`, `1`, and `3`. Requests that specify an invalid value are rejected. Any operation that affects conditional role bindings must specify version `3`. This requirement applies to the following operations: * Getting a policy that includes a conditional role binding * Adding a conditional role binding to a policy * Changing a conditional role binding in a policy * Removing any role binding, with or without a condition, from a policy that includes conditions **Important:** If you use IAM Conditions, you must include the `etag` field whenever you call `setIamPolicy`. If you omit this field, then IAM allows you to overwrite a version `3` policy with a version `1` policy, and all of the conditions in the version `3` policy are lost. If a policy does not include any conditions, operations on that policy may specify any valid version or leave the field unset. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies). + * Specifies the format of the policy. + * Valid values are `0`, `1`, and `3`. Requests that specify an invalid value + * are rejected. + * Any operation that affects conditional role bindings must specify version + * `3`. This requirement applies to the following operations: + * * Getting a policy that includes a conditional role binding + * * Adding a conditional role binding to a policy + * * Changing a conditional role binding in a policy + * * Removing any role binding, with or without a condition, from a policy + * that includes conditions + * **Important:** If you use IAM Conditions, you must include the `etag` field + * whenever you call `setIamPolicy`. If you omit this field, then IAM allows + * you to overwrite a version `3` policy with a version `1` policy, and all of + * the conditions in the version `3` policy are lost. + * If a policy does not include any conditions, operations on that policy may + * specify any valid version or leave the field unset. + * To learn which resources support conditions in their IAM policies, see the + * [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies). * * Generated from protobuf field optional int32 version = 351608024; */ @@ -53,12 +150,47 @@ class Policy extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\AuditConfig>|\Google\Protobuf\Internal\RepeatedField $audit_configs * Specifies cloud audit logging configuration for this policy. * @type array<\Google\Cloud\Compute\V1\Binding>|\Google\Protobuf\Internal\RepeatedField $bindings - * Associates a list of `members`, or principals, with a `role`. Optionally, may specify a `condition` that determines how and when the `bindings` are applied. Each of the `bindings` must contain at least one principal. The `bindings` in a `Policy` can refer to up to 1,500 principals; up to 250 of these principals can be Google groups. Each occurrence of a principal counts towards these limits. For example, if the `bindings` grant 50 different roles to `user:alice@example.com`, and not to any other principal, then you can add another 1,450 principals to the `bindings` in the `Policy`. + * Associates a list of `members`, or principals, with a `role`. Optionally, + * may specify a `condition` that determines how and when the `bindings` are + * applied. Each of the `bindings` must contain at least one principal. + * The `bindings` in a `Policy` can refer to up to 1,500 principals; up to 250 + * of these principals can be Google groups. Each occurrence of a principal + * counts towards these limits. For example, if the `bindings` grant 50 + * different roles to `user:alice@example.com`, and not to any other + * principal, then you can add another 1,450 principals to the `bindings` in + * the `Policy`. * @type string $etag - * `etag` is used for optimistic concurrency control as a way to help prevent simultaneous updates of a policy from overwriting each other. It is strongly suggested that systems make use of the `etag` in the read-modify-write cycle to perform policy updates in order to avoid race conditions: An `etag` is returned in the response to `getIamPolicy`, and systems are expected to put that etag in the request to `setIamPolicy` to ensure that their change will be applied to the same version of the policy. **Important:** If you use IAM Conditions, you must include the `etag` field whenever you call `setIamPolicy`. If you omit this field, then IAM allows you to overwrite a version `3` policy with a version `1` policy, and all of the conditions in the version `3` policy are lost. + * `etag` is used for optimistic concurrency control as a way to help + * prevent simultaneous updates of a policy from overwriting each other. + * It is strongly suggested that systems make use of the `etag` in the + * read-modify-write cycle to perform policy updates in order to avoid race + * conditions: An `etag` is returned in the response to `getIamPolicy`, and + * systems are expected to put that etag in the request to `setIamPolicy` to + * ensure that their change will be applied to the same version of the policy. + * **Important:** If you use IAM Conditions, you must include the `etag` field + * whenever you call `setIamPolicy`. If you omit this field, then IAM allows + * you to overwrite a version `3` policy with a version `1` policy, and all of + * the conditions in the version `3` policy are lost. * @type bool $iam_owned * @type int $version - * Specifies the format of the policy. Valid values are `0`, `1`, and `3`. Requests that specify an invalid value are rejected. Any operation that affects conditional role bindings must specify version `3`. This requirement applies to the following operations: * Getting a policy that includes a conditional role binding * Adding a conditional role binding to a policy * Changing a conditional role binding in a policy * Removing any role binding, with or without a condition, from a policy that includes conditions **Important:** If you use IAM Conditions, you must include the `etag` field whenever you call `setIamPolicy`. If you omit this field, then IAM allows you to overwrite a version `3` policy with a version `1` policy, and all of the conditions in the version `3` policy are lost. If a policy does not include any conditions, operations on that policy may specify any valid version or leave the field unset. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies). + * Specifies the format of the policy. + * Valid values are `0`, `1`, and `3`. Requests that specify an invalid value + * are rejected. + * Any operation that affects conditional role bindings must specify version + * `3`. This requirement applies to the following operations: + * * Getting a policy that includes a conditional role binding + * * Adding a conditional role binding to a policy + * * Changing a conditional role binding in a policy + * * Removing any role binding, with or without a condition, from a policy + * that includes conditions + * **Important:** If you use IAM Conditions, you must include the `etag` field + * whenever you call `setIamPolicy`. If you omit this field, then IAM allows + * you to overwrite a version `3` policy with a version `1` policy, and all of + * the conditions in the version `3` policy are lost. + * If a policy does not include any conditions, operations on that policy may + * specify any valid version or leave the field unset. + * To learn which resources support conditions in their IAM policies, see the + * [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies). * } */ public function __construct($data = NULL) { @@ -93,7 +225,15 @@ public function setAuditConfigs($var) } /** - * Associates a list of `members`, or principals, with a `role`. Optionally, may specify a `condition` that determines how and when the `bindings` are applied. Each of the `bindings` must contain at least one principal. The `bindings` in a `Policy` can refer to up to 1,500 principals; up to 250 of these principals can be Google groups. Each occurrence of a principal counts towards these limits. For example, if the `bindings` grant 50 different roles to `user:alice@example.com`, and not to any other principal, then you can add another 1,450 principals to the `bindings` in the `Policy`. + * Associates a list of `members`, or principals, with a `role`. Optionally, + * may specify a `condition` that determines how and when the `bindings` are + * applied. Each of the `bindings` must contain at least one principal. + * The `bindings` in a `Policy` can refer to up to 1,500 principals; up to 250 + * of these principals can be Google groups. Each occurrence of a principal + * counts towards these limits. For example, if the `bindings` grant 50 + * different roles to `user:alice@example.com`, and not to any other + * principal, then you can add another 1,450 principals to the `bindings` in + * the `Policy`. * * Generated from protobuf field repeated .google.cloud.compute.v1.Binding bindings = 403251854; * @return \Google\Protobuf\Internal\RepeatedField @@ -104,7 +244,15 @@ public function getBindings() } /** - * Associates a list of `members`, or principals, with a `role`. Optionally, may specify a `condition` that determines how and when the `bindings` are applied. Each of the `bindings` must contain at least one principal. The `bindings` in a `Policy` can refer to up to 1,500 principals; up to 250 of these principals can be Google groups. Each occurrence of a principal counts towards these limits. For example, if the `bindings` grant 50 different roles to `user:alice@example.com`, and not to any other principal, then you can add another 1,450 principals to the `bindings` in the `Policy`. + * Associates a list of `members`, or principals, with a `role`. Optionally, + * may specify a `condition` that determines how and when the `bindings` are + * applied. Each of the `bindings` must contain at least one principal. + * The `bindings` in a `Policy` can refer to up to 1,500 principals; up to 250 + * of these principals can be Google groups. Each occurrence of a principal + * counts towards these limits. For example, if the `bindings` grant 50 + * different roles to `user:alice@example.com`, and not to any other + * principal, then you can add another 1,450 principals to the `bindings` in + * the `Policy`. * * Generated from protobuf field repeated .google.cloud.compute.v1.Binding bindings = 403251854; * @param array<\Google\Cloud\Compute\V1\Binding>|\Google\Protobuf\Internal\RepeatedField $var @@ -119,7 +267,17 @@ public function setBindings($var) } /** - * `etag` is used for optimistic concurrency control as a way to help prevent simultaneous updates of a policy from overwriting each other. It is strongly suggested that systems make use of the `etag` in the read-modify-write cycle to perform policy updates in order to avoid race conditions: An `etag` is returned in the response to `getIamPolicy`, and systems are expected to put that etag in the request to `setIamPolicy` to ensure that their change will be applied to the same version of the policy. **Important:** If you use IAM Conditions, you must include the `etag` field whenever you call `setIamPolicy`. If you omit this field, then IAM allows you to overwrite a version `3` policy with a version `1` policy, and all of the conditions in the version `3` policy are lost. + * `etag` is used for optimistic concurrency control as a way to help + * prevent simultaneous updates of a policy from overwriting each other. + * It is strongly suggested that systems make use of the `etag` in the + * read-modify-write cycle to perform policy updates in order to avoid race + * conditions: An `etag` is returned in the response to `getIamPolicy`, and + * systems are expected to put that etag in the request to `setIamPolicy` to + * ensure that their change will be applied to the same version of the policy. + * **Important:** If you use IAM Conditions, you must include the `etag` field + * whenever you call `setIamPolicy`. If you omit this field, then IAM allows + * you to overwrite a version `3` policy with a version `1` policy, and all of + * the conditions in the version `3` policy are lost. * * Generated from protobuf field optional string etag = 3123477; * @return string @@ -140,7 +298,17 @@ public function clearEtag() } /** - * `etag` is used for optimistic concurrency control as a way to help prevent simultaneous updates of a policy from overwriting each other. It is strongly suggested that systems make use of the `etag` in the read-modify-write cycle to perform policy updates in order to avoid race conditions: An `etag` is returned in the response to `getIamPolicy`, and systems are expected to put that etag in the request to `setIamPolicy` to ensure that their change will be applied to the same version of the policy. **Important:** If you use IAM Conditions, you must include the `etag` field whenever you call `setIamPolicy`. If you omit this field, then IAM allows you to overwrite a version `3` policy with a version `1` policy, and all of the conditions in the version `3` policy are lost. + * `etag` is used for optimistic concurrency control as a way to help + * prevent simultaneous updates of a policy from overwriting each other. + * It is strongly suggested that systems make use of the `etag` in the + * read-modify-write cycle to perform policy updates in order to avoid race + * conditions: An `etag` is returned in the response to `getIamPolicy`, and + * systems are expected to put that etag in the request to `setIamPolicy` to + * ensure that their change will be applied to the same version of the policy. + * **Important:** If you use IAM Conditions, you must include the `etag` field + * whenever you call `setIamPolicy`. If you omit this field, then IAM allows + * you to overwrite a version `3` policy with a version `1` policy, and all of + * the conditions in the version `3` policy are lost. * * Generated from protobuf field optional string etag = 3123477; * @param string $var @@ -187,7 +355,24 @@ public function setIamOwned($var) } /** - * Specifies the format of the policy. Valid values are `0`, `1`, and `3`. Requests that specify an invalid value are rejected. Any operation that affects conditional role bindings must specify version `3`. This requirement applies to the following operations: * Getting a policy that includes a conditional role binding * Adding a conditional role binding to a policy * Changing a conditional role binding in a policy * Removing any role binding, with or without a condition, from a policy that includes conditions **Important:** If you use IAM Conditions, you must include the `etag` field whenever you call `setIamPolicy`. If you omit this field, then IAM allows you to overwrite a version `3` policy with a version `1` policy, and all of the conditions in the version `3` policy are lost. If a policy does not include any conditions, operations on that policy may specify any valid version or leave the field unset. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies). + * Specifies the format of the policy. + * Valid values are `0`, `1`, and `3`. Requests that specify an invalid value + * are rejected. + * Any operation that affects conditional role bindings must specify version + * `3`. This requirement applies to the following operations: + * * Getting a policy that includes a conditional role binding + * * Adding a conditional role binding to a policy + * * Changing a conditional role binding in a policy + * * Removing any role binding, with or without a condition, from a policy + * that includes conditions + * **Important:** If you use IAM Conditions, you must include the `etag` field + * whenever you call `setIamPolicy`. If you omit this field, then IAM allows + * you to overwrite a version `3` policy with a version `1` policy, and all of + * the conditions in the version `3` policy are lost. + * If a policy does not include any conditions, operations on that policy may + * specify any valid version or leave the field unset. + * To learn which resources support conditions in their IAM policies, see the + * [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies). * * Generated from protobuf field optional int32 version = 351608024; * @return int @@ -208,7 +393,24 @@ public function clearVersion() } /** - * Specifies the format of the policy. Valid values are `0`, `1`, and `3`. Requests that specify an invalid value are rejected. Any operation that affects conditional role bindings must specify version `3`. This requirement applies to the following operations: * Getting a policy that includes a conditional role binding * Adding a conditional role binding to a policy * Changing a conditional role binding in a policy * Removing any role binding, with or without a condition, from a policy that includes conditions **Important:** If you use IAM Conditions, you must include the `etag` field whenever you call `setIamPolicy`. If you omit this field, then IAM allows you to overwrite a version `3` policy with a version `1` policy, and all of the conditions in the version `3` policy are lost. If a policy does not include any conditions, operations on that policy may specify any valid version or leave the field unset. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies). + * Specifies the format of the policy. + * Valid values are `0`, `1`, and `3`. Requests that specify an invalid value + * are rejected. + * Any operation that affects conditional role bindings must specify version + * `3`. This requirement applies to the following operations: + * * Getting a policy that includes a conditional role binding + * * Adding a conditional role binding to a policy + * * Changing a conditional role binding in a policy + * * Removing any role binding, with or without a condition, from a policy + * that includes conditions + * **Important:** If you use IAM Conditions, you must include the `etag` field + * whenever you call `setIamPolicy`. If you omit this field, then IAM allows + * you to overwrite a version `3` policy with a version `1` policy, and all of + * the conditions in the version `3` policy are lost. + * If a policy does not include any conditions, operations on that policy may + * specify any valid version or leave the field unset. + * To learn which resources support conditions in their IAM policies, see the + * [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies). * * Generated from protobuf field optional int32 version = 351608024; * @param int $var diff --git a/Compute/src/V1/PreservedState.php b/Compute/src/V1/PreservedState.php index 9257496ab89a..0cde19b5d36c 100644 --- a/Compute/src/V1/PreservedState.php +++ b/Compute/src/V1/PreservedState.php @@ -16,19 +16,22 @@ class PreservedState extends \Google\Protobuf\Internal\Message { /** - * Preserved disks defined for this instance. This map is keyed with the device names of the disks. + * Preserved disks defined for this instance. + * This map is keyed with the device names of the disks. * * Generated from protobuf field map disks = 95594102; */ private $disks; /** - * Preserved external IPs defined for this instance. This map is keyed with the name of the network interface. + * Preserved external IPs defined for this instance. + * This map is keyed with the name of the network interface. * * Generated from protobuf field map external_i_ps = 532687245; */ private $external_i_ps; /** - * Preserved internal IPs defined for this instance. This map is keyed with the name of the network interface. + * Preserved internal IPs defined for this instance. + * This map is keyed with the name of the network interface. * * Generated from protobuf field map internal_i_ps = 215731675; */ @@ -47,11 +50,14 @@ class PreservedState extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type array|\Google\Protobuf\Internal\MapField $disks - * Preserved disks defined for this instance. This map is keyed with the device names of the disks. + * Preserved disks defined for this instance. + * This map is keyed with the device names of the disks. * @type array|\Google\Protobuf\Internal\MapField $external_i_ps - * Preserved external IPs defined for this instance. This map is keyed with the name of the network interface. + * Preserved external IPs defined for this instance. + * This map is keyed with the name of the network interface. * @type array|\Google\Protobuf\Internal\MapField $internal_i_ps - * Preserved internal IPs defined for this instance. This map is keyed with the name of the network interface. + * Preserved internal IPs defined for this instance. + * This map is keyed with the name of the network interface. * @type array|\Google\Protobuf\Internal\MapField $metadata * Preserved metadata defined for this instance. * } @@ -62,7 +68,8 @@ public function __construct($data = NULL) { } /** - * Preserved disks defined for this instance. This map is keyed with the device names of the disks. + * Preserved disks defined for this instance. + * This map is keyed with the device names of the disks. * * Generated from protobuf field map disks = 95594102; * @return \Google\Protobuf\Internal\MapField @@ -73,7 +80,8 @@ public function getDisks() } /** - * Preserved disks defined for this instance. This map is keyed with the device names of the disks. + * Preserved disks defined for this instance. + * This map is keyed with the device names of the disks. * * Generated from protobuf field map disks = 95594102; * @param array|\Google\Protobuf\Internal\MapField $var @@ -88,7 +96,8 @@ public function setDisks($var) } /** - * Preserved external IPs defined for this instance. This map is keyed with the name of the network interface. + * Preserved external IPs defined for this instance. + * This map is keyed with the name of the network interface. * * Generated from protobuf field map external_i_ps = 532687245; * @return \Google\Protobuf\Internal\MapField @@ -99,7 +108,8 @@ public function getExternalIPs() } /** - * Preserved external IPs defined for this instance. This map is keyed with the name of the network interface. + * Preserved external IPs defined for this instance. + * This map is keyed with the name of the network interface. * * Generated from protobuf field map external_i_ps = 532687245; * @param array|\Google\Protobuf\Internal\MapField $var @@ -114,7 +124,8 @@ public function setExternalIPs($var) } /** - * Preserved internal IPs defined for this instance. This map is keyed with the name of the network interface. + * Preserved internal IPs defined for this instance. + * This map is keyed with the name of the network interface. * * Generated from protobuf field map internal_i_ps = 215731675; * @return \Google\Protobuf\Internal\MapField @@ -125,7 +136,8 @@ public function getInternalIPs() } /** - * Preserved internal IPs defined for this instance. This map is keyed with the name of the network interface. + * Preserved internal IPs defined for this instance. + * This map is keyed with the name of the network interface. * * Generated from protobuf field map internal_i_ps = 215731675; * @param array|\Google\Protobuf\Internal\MapField $var diff --git a/Compute/src/V1/PreservedStatePreservedDisk.php b/Compute/src/V1/PreservedStatePreservedDisk.php index e3fede3c005b..e3c9f7d1fba6 100644 --- a/Compute/src/V1/PreservedStatePreservedDisk.php +++ b/Compute/src/V1/PreservedStatePreservedDisk.php @@ -15,21 +15,28 @@ class PreservedStatePreservedDisk extends \Google\Protobuf\Internal\Message { /** - * These stateful disks will never be deleted during autohealing, update, instance recreate operations. This flag is used to configure if the disk should be deleted after it is no longer used by the group, e.g. when the given instance or the whole MIG is deleted. Note: disks attached in READ_ONLY mode cannot be auto-deleted. + * These stateful disks will never be deleted during autohealing, + * update, instance recreate operations. This flag is used to configure + * if the disk should be deleted after it is no longer used by the group, + * e.g. when the given instance or the whole MIG is deleted. + * Note: disks attached in READ_ONLY mode cannot be + * auto-deleted. * Check the AutoDelete enum for the list of possible values. * * Generated from protobuf field optional string auto_delete = 464761403; */ protected $auto_delete = null; /** - * The mode in which to attach this disk, either READ_WRITE or READ_ONLY. If not specified, the default is to attach the disk in READ_WRITE mode. + * The mode in which to attach this disk, either READ_WRITE orREAD_ONLY. If not specified, the default is to attach the + * disk in READ_WRITE mode. * Check the Mode enum for the list of possible values. * * Generated from protobuf field optional string mode = 3357091; */ protected $mode = null; /** - * The URL of the disk resource that is stateful and should be attached to the VM instance. + * The URL of the disk resource that is stateful and should be attached + * to the VM instance. * * Generated from protobuf field optional string source = 177235995; */ @@ -42,13 +49,20 @@ class PreservedStatePreservedDisk extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $auto_delete - * These stateful disks will never be deleted during autohealing, update, instance recreate operations. This flag is used to configure if the disk should be deleted after it is no longer used by the group, e.g. when the given instance or the whole MIG is deleted. Note: disks attached in READ_ONLY mode cannot be auto-deleted. + * These stateful disks will never be deleted during autohealing, + * update, instance recreate operations. This flag is used to configure + * if the disk should be deleted after it is no longer used by the group, + * e.g. when the given instance or the whole MIG is deleted. + * Note: disks attached in READ_ONLY mode cannot be + * auto-deleted. * Check the AutoDelete enum for the list of possible values. * @type string $mode - * The mode in which to attach this disk, either READ_WRITE or READ_ONLY. If not specified, the default is to attach the disk in READ_WRITE mode. + * The mode in which to attach this disk, either READ_WRITE orREAD_ONLY. If not specified, the default is to attach the + * disk in READ_WRITE mode. * Check the Mode enum for the list of possible values. * @type string $source - * The URL of the disk resource that is stateful and should be attached to the VM instance. + * The URL of the disk resource that is stateful and should be attached + * to the VM instance. * } */ public function __construct($data = NULL) { @@ -57,7 +71,12 @@ public function __construct($data = NULL) { } /** - * These stateful disks will never be deleted during autohealing, update, instance recreate operations. This flag is used to configure if the disk should be deleted after it is no longer used by the group, e.g. when the given instance or the whole MIG is deleted. Note: disks attached in READ_ONLY mode cannot be auto-deleted. + * These stateful disks will never be deleted during autohealing, + * update, instance recreate operations. This flag is used to configure + * if the disk should be deleted after it is no longer used by the group, + * e.g. when the given instance or the whole MIG is deleted. + * Note: disks attached in READ_ONLY mode cannot be + * auto-deleted. * Check the AutoDelete enum for the list of possible values. * * Generated from protobuf field optional string auto_delete = 464761403; @@ -79,7 +98,12 @@ public function clearAutoDelete() } /** - * These stateful disks will never be deleted during autohealing, update, instance recreate operations. This flag is used to configure if the disk should be deleted after it is no longer used by the group, e.g. when the given instance or the whole MIG is deleted. Note: disks attached in READ_ONLY mode cannot be auto-deleted. + * These stateful disks will never be deleted during autohealing, + * update, instance recreate operations. This flag is used to configure + * if the disk should be deleted after it is no longer used by the group, + * e.g. when the given instance or the whole MIG is deleted. + * Note: disks attached in READ_ONLY mode cannot be + * auto-deleted. * Check the AutoDelete enum for the list of possible values. * * Generated from protobuf field optional string auto_delete = 464761403; @@ -95,7 +119,8 @@ public function setAutoDelete($var) } /** - * The mode in which to attach this disk, either READ_WRITE or READ_ONLY. If not specified, the default is to attach the disk in READ_WRITE mode. + * The mode in which to attach this disk, either READ_WRITE orREAD_ONLY. If not specified, the default is to attach the + * disk in READ_WRITE mode. * Check the Mode enum for the list of possible values. * * Generated from protobuf field optional string mode = 3357091; @@ -117,7 +142,8 @@ public function clearMode() } /** - * The mode in which to attach this disk, either READ_WRITE or READ_ONLY. If not specified, the default is to attach the disk in READ_WRITE mode. + * The mode in which to attach this disk, either READ_WRITE orREAD_ONLY. If not specified, the default is to attach the + * disk in READ_WRITE mode. * Check the Mode enum for the list of possible values. * * Generated from protobuf field optional string mode = 3357091; @@ -133,7 +159,8 @@ public function setMode($var) } /** - * The URL of the disk resource that is stateful and should be attached to the VM instance. + * The URL of the disk resource that is stateful and should be attached + * to the VM instance. * * Generated from protobuf field optional string source = 177235995; * @return string @@ -154,7 +181,8 @@ public function clearSource() } /** - * The URL of the disk resource that is stateful and should be attached to the VM instance. + * The URL of the disk resource that is stateful and should be attached + * to the VM instance. * * Generated from protobuf field optional string source = 177235995; * @param string $var diff --git a/Compute/src/V1/PreservedStatePreservedDisk/AutoDelete.php b/Compute/src/V1/PreservedStatePreservedDisk/AutoDelete.php index 6cfaff484504..f038add5a06f 100644 --- a/Compute/src/V1/PreservedStatePreservedDisk/AutoDelete.php +++ b/Compute/src/V1/PreservedStatePreservedDisk/AutoDelete.php @@ -7,7 +7,12 @@ use UnexpectedValueException; /** - * These stateful disks will never be deleted during autohealing, update, instance recreate operations. This flag is used to configure if the disk should be deleted after it is no longer used by the group, e.g. when the given instance or the whole MIG is deleted. Note: disks attached in READ_ONLY mode cannot be auto-deleted. + * These stateful disks will never be deleted during autohealing, + * update, instance recreate operations. This flag is used to configure + * if the disk should be deleted after it is no longer used by the group, + * e.g. when the given instance or the whole MIG is deleted. + * Note: disks attached in READ_ONLY mode cannot be + * auto-deleted. * * Protobuf type google.cloud.compute.v1.PreservedStatePreservedDisk.AutoDelete */ diff --git a/Compute/src/V1/PreservedStatePreservedDisk/Mode.php b/Compute/src/V1/PreservedStatePreservedDisk/Mode.php index 1b927a97a552..dcc874145a88 100644 --- a/Compute/src/V1/PreservedStatePreservedDisk/Mode.php +++ b/Compute/src/V1/PreservedStatePreservedDisk/Mode.php @@ -7,7 +7,8 @@ use UnexpectedValueException; /** - * The mode in which to attach this disk, either READ_WRITE or READ_ONLY. If not specified, the default is to attach the disk in READ_WRITE mode. + * The mode in which to attach this disk, either READ_WRITE orREAD_ONLY. If not specified, the default is to attach the + * disk in READ_WRITE mode. * * Protobuf type google.cloud.compute.v1.PreservedStatePreservedDisk.Mode */ @@ -20,13 +21,15 @@ class Mode */ const UNDEFINED_MODE = 0; /** - * Attaches this disk in read-only mode. Multiple VM instances can use a disk in READ_ONLY mode at a time. + * Attaches this disk in read-only mode. Multiple VM instances can use + * a disk in READ_ONLY mode at a time. * * Generated from protobuf enum READ_ONLY = 91950261; */ const READ_ONLY = 91950261; /** - * *[Default]* Attaches this disk in READ_WRITE mode. Only one VM instance at a time can be attached to a disk in READ_WRITE mode. + * *[Default]* Attaches this disk in READ_WRITE mode. Only + * one VM instance at a time can be attached to a disk inREAD_WRITE mode. * * Generated from protobuf enum READ_WRITE = 173607894; */ diff --git a/Compute/src/V1/PreservedStatePreservedNetworkIp.php b/Compute/src/V1/PreservedStatePreservedNetworkIp.php index 935223c0f9a7..093734edf2db 100644 --- a/Compute/src/V1/PreservedStatePreservedNetworkIp.php +++ b/Compute/src/V1/PreservedStatePreservedNetworkIp.php @@ -15,7 +15,11 @@ class PreservedStatePreservedNetworkIp extends \Google\Protobuf\Internal\Message { /** - * These stateful IPs will never be released during autohealing, update or VM instance recreate operations. This flag is used to configure if the IP reservation should be deleted after it is no longer used by the group, e.g. when the given instance or the whole group is deleted. + * These stateful IPs will never be released during autohealing, + * update or VM instance recreate operations. + * This flag is used to configure if the IP reservation should be deleted + * after it is no longer used by the group, e.g. when the given instance + * or the whole group is deleted. * Check the AutoDelete enum for the list of possible values. * * Generated from protobuf field optional string auto_delete = 464761403; @@ -35,7 +39,11 @@ class PreservedStatePreservedNetworkIp extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $auto_delete - * These stateful IPs will never be released during autohealing, update or VM instance recreate operations. This flag is used to configure if the IP reservation should be deleted after it is no longer used by the group, e.g. when the given instance or the whole group is deleted. + * These stateful IPs will never be released during autohealing, + * update or VM instance recreate operations. + * This flag is used to configure if the IP reservation should be deleted + * after it is no longer used by the group, e.g. when the given instance + * or the whole group is deleted. * Check the AutoDelete enum for the list of possible values. * @type \Google\Cloud\Compute\V1\PreservedStatePreservedNetworkIpIpAddress $ip_address * Ip address representation @@ -47,7 +55,11 @@ public function __construct($data = NULL) { } /** - * These stateful IPs will never be released during autohealing, update or VM instance recreate operations. This flag is used to configure if the IP reservation should be deleted after it is no longer used by the group, e.g. when the given instance or the whole group is deleted. + * These stateful IPs will never be released during autohealing, + * update or VM instance recreate operations. + * This flag is used to configure if the IP reservation should be deleted + * after it is no longer used by the group, e.g. when the given instance + * or the whole group is deleted. * Check the AutoDelete enum for the list of possible values. * * Generated from protobuf field optional string auto_delete = 464761403; @@ -69,7 +81,11 @@ public function clearAutoDelete() } /** - * These stateful IPs will never be released during autohealing, update or VM instance recreate operations. This flag is used to configure if the IP reservation should be deleted after it is no longer used by the group, e.g. when the given instance or the whole group is deleted. + * These stateful IPs will never be released during autohealing, + * update or VM instance recreate operations. + * This flag is used to configure if the IP reservation should be deleted + * after it is no longer used by the group, e.g. when the given instance + * or the whole group is deleted. * Check the AutoDelete enum for the list of possible values. * * Generated from protobuf field optional string auto_delete = 464761403; diff --git a/Compute/src/V1/PreservedStatePreservedNetworkIp/AutoDelete.php b/Compute/src/V1/PreservedStatePreservedNetworkIp/AutoDelete.php index 845041c009a4..f5f48362a66f 100644 --- a/Compute/src/V1/PreservedStatePreservedNetworkIp/AutoDelete.php +++ b/Compute/src/V1/PreservedStatePreservedNetworkIp/AutoDelete.php @@ -7,7 +7,11 @@ use UnexpectedValueException; /** - * These stateful IPs will never be released during autohealing, update or VM instance recreate operations. This flag is used to configure if the IP reservation should be deleted after it is no longer used by the group, e.g. when the given instance or the whole group is deleted. + * These stateful IPs will never be released during autohealing, + * update or VM instance recreate operations. + * This flag is used to configure if the IP reservation should be deleted + * after it is no longer used by the group, e.g. when the given instance + * or the whole group is deleted. * * Protobuf type google.cloud.compute.v1.PreservedStatePreservedNetworkIp.AutoDelete */ diff --git a/Compute/src/V1/PreservedStatePreservedNetworkIpIpAddress.php b/Compute/src/V1/PreservedStatePreservedNetworkIpIpAddress.php index 68afad8b1709..086bf5e1fe7f 100644 --- a/Compute/src/V1/PreservedStatePreservedNetworkIpIpAddress.php +++ b/Compute/src/V1/PreservedStatePreservedNetworkIpIpAddress.php @@ -21,7 +21,8 @@ class PreservedStatePreservedNetworkIpIpAddress extends \Google\Protobuf\Interna */ protected $address = null; /** - * An IPv4 internal network address to assign to the instance for this network interface. + * An IPv4 internal network address to assign to the instance for this + * network interface. * * Generated from protobuf field optional string literal = 182460591; */ @@ -36,7 +37,8 @@ class PreservedStatePreservedNetworkIpIpAddress extends \Google\Protobuf\Interna * @type string $address * The URL of the reservation for this IP address. * @type string $literal - * An IPv4 internal network address to assign to the instance for this network interface. + * An IPv4 internal network address to assign to the instance for this + * network interface. * } */ public function __construct($data = NULL) { @@ -81,7 +83,8 @@ public function setAddress($var) } /** - * An IPv4 internal network address to assign to the instance for this network interface. + * An IPv4 internal network address to assign to the instance for this + * network interface. * * Generated from protobuf field optional string literal = 182460591; * @return string @@ -102,7 +105,8 @@ public function clearLiteral() } /** - * An IPv4 internal network address to assign to the instance for this network interface. + * An IPv4 internal network address to assign to the instance for this + * network interface. * * Generated from protobuf field optional string literal = 182460591; * @param string $var diff --git a/Compute/src/V1/PreviewFeature.php b/Compute/src/V1/PreviewFeature.php index 2e7ba1b12bc8..739e4b0efd82 100644 --- a/Compute/src/V1/PreviewFeature.php +++ b/Compute/src/V1/PreviewFeature.php @@ -23,7 +23,8 @@ class PreviewFeature extends \Google\Protobuf\Internal\Message */ protected $activation_status = null; /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; */ @@ -35,13 +36,15 @@ class PreviewFeature extends \Google\Protobuf\Internal\Message */ protected $description = null; /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; */ protected $id = null; /** - * [Output only] The type of the feature. Always "compute#previewFeature" for preview features. + * [Output only] The type of the feature. Always "compute#previewFeature" for + * preview features. * * Generated from protobuf field optional string kind = 3292052; */ @@ -81,13 +84,16 @@ class PreviewFeature extends \Google\Protobuf\Internal\Message * Specifies whether the feature is enabled or disabled. * Check the ActivationStatus enum for the list of possible values. * @type string $creation_timestamp - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * @type string $description * [Output Only] Description of the feature. * @type int|string $id - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * @type string $kind - * [Output only] The type of the feature. Always "compute#previewFeature" for preview features. + * [Output only] The type of the feature. Always "compute#previewFeature" for + * preview features. * @type string $name * Name of the feature. * @type \Google\Cloud\Compute\V1\PreviewFeatureRolloutOperation $rollout_operation @@ -142,7 +148,8 @@ public function setActivationStatus($var) } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @return string @@ -163,7 +170,8 @@ public function clearCreationTimestamp() } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @param string $var @@ -214,7 +222,8 @@ public function setDescription($var) } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @return int|string @@ -235,7 +244,8 @@ public function clearId() } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @param int|string $var @@ -250,7 +260,8 @@ public function setId($var) } /** - * [Output only] The type of the feature. Always "compute#previewFeature" for preview features. + * [Output only] The type of the feature. Always "compute#previewFeature" for + * preview features. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -271,7 +282,8 @@ public function clearKind() } /** - * [Output only] The type of the feature. Always "compute#previewFeature" for preview features. + * [Output only] The type of the feature. Always "compute#previewFeature" for + * preview features. * * Generated from protobuf field optional string kind = 3292052; * @param string $var diff --git a/Compute/src/V1/PreviewFeatureList.php b/Compute/src/V1/PreviewFeatureList.php index 24d12a19de1b..69ab7a92bd89 100644 --- a/Compute/src/V1/PreviewFeatureList.php +++ b/Compute/src/V1/PreviewFeatureList.php @@ -31,7 +31,11 @@ class PreviewFeatureList extends \Google\Protobuf\Internal\Message */ private $items; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -43,7 +47,8 @@ class PreviewFeatureList extends \Google\Protobuf\Internal\Message */ protected $self_link = null; /** - * [Output Only] Unreachable resources. end_interface: MixerListResponseWithEtagBuilder + * [Output Only] Unreachable resources. + * end_interface: MixerListResponseWithEtagBuilder * * Generated from protobuf field repeated string unreachables = 243372063; */ @@ -67,11 +72,16 @@ class PreviewFeatureList extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\PreviewFeature>|\Google\Protobuf\Internal\RepeatedField $items * A list of PreviewFeature resources. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type array|\Google\Protobuf\Internal\RepeatedField $unreachables - * [Output Only] Unreachable resources. end_interface: MixerListResponseWithEtagBuilder + * [Output Only] Unreachable resources. + * end_interface: MixerListResponseWithEtagBuilder * @type \Google\Cloud\Compute\V1\Warning $warning * [Output Only] Informational warning message. * } @@ -176,7 +186,11 @@ public function setItems($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -197,7 +211,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var @@ -248,7 +266,8 @@ public function setSelfLink($var) } /** - * [Output Only] Unreachable resources. end_interface: MixerListResponseWithEtagBuilder + * [Output Only] Unreachable resources. + * end_interface: MixerListResponseWithEtagBuilder * * Generated from protobuf field repeated string unreachables = 243372063; * @return \Google\Protobuf\Internal\RepeatedField @@ -259,7 +278,8 @@ public function getUnreachables() } /** - * [Output Only] Unreachable resources. end_interface: MixerListResponseWithEtagBuilder + * [Output Only] Unreachable resources. + * end_interface: MixerListResponseWithEtagBuilder * * Generated from protobuf field repeated string unreachables = 243372063; * @param array|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/PreviewFeatureRolloutOperationRolloutInput.php b/Compute/src/V1/PreviewFeatureRolloutOperationRolloutInput.php index 1b263070400e..196bccf42a7c 100644 --- a/Compute/src/V1/PreviewFeatureRolloutOperationRolloutInput.php +++ b/Compute/src/V1/PreviewFeatureRolloutOperationRolloutInput.php @@ -16,7 +16,13 @@ class PreviewFeatureRolloutOperationRolloutInput extends \Google\Protobuf\Internal\Message { /** - * The name of the rollout plan Ex. organizations//locations/global/rolloutPlans/ Ex. folders//locations/global/rolloutPlans/ Ex. projects//locations/global/rolloutPlans/. + * The name of the rollout plan + * Ex. + * organizations//locations/global/rolloutPlans/ + * Ex. + * folders//locations/global/rolloutPlans/ + * Ex. + * projects//locations/global/rolloutPlans/. * * Generated from protobuf field optional string name = 3373707; */ @@ -36,7 +42,13 @@ class PreviewFeatureRolloutOperationRolloutInput extends \Google\Protobuf\Intern * Optional. Data for populating the Message object. * * @type string $name - * The name of the rollout plan Ex. organizations//locations/global/rolloutPlans/ Ex. folders//locations/global/rolloutPlans/ Ex. projects//locations/global/rolloutPlans/. + * The name of the rollout plan + * Ex. + * organizations//locations/global/rolloutPlans/ + * Ex. + * folders//locations/global/rolloutPlans/ + * Ex. + * projects//locations/global/rolloutPlans/. * @type string $predefined_rollout_plan * Predefined rollout plan. * Check the PredefinedRolloutPlan enum for the list of possible values. @@ -48,7 +60,13 @@ public function __construct($data = NULL) { } /** - * The name of the rollout plan Ex. organizations//locations/global/rolloutPlans/ Ex. folders//locations/global/rolloutPlans/ Ex. projects//locations/global/rolloutPlans/. + * The name of the rollout plan + * Ex. + * organizations//locations/global/rolloutPlans/ + * Ex. + * folders//locations/global/rolloutPlans/ + * Ex. + * projects//locations/global/rolloutPlans/. * * Generated from protobuf field optional string name = 3373707; * @return string @@ -69,7 +87,13 @@ public function clearName() } /** - * The name of the rollout plan Ex. organizations//locations/global/rolloutPlans/ Ex. folders//locations/global/rolloutPlans/ Ex. projects//locations/global/rolloutPlans/. + * The name of the rollout plan + * Ex. + * organizations//locations/global/rolloutPlans/ + * Ex. + * folders//locations/global/rolloutPlans/ + * Ex. + * projects//locations/global/rolloutPlans/. * * Generated from protobuf field optional string name = 3373707; * @param string $var diff --git a/Compute/src/V1/Project.php b/Compute/src/V1/Project.php index 15adc640d920..a11aa8393753 100644 --- a/Compute/src/V1/Project.php +++ b/Compute/src/V1/Project.php @@ -9,33 +9,43 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Represents a Project resource. A project is used to organize resources in a Google Cloud Platform environment. For more information, read about the Resource Hierarchy. + * Represents a Project resource. + * A project is used to organize resources in a Google Cloud Platform + * environment. For more information, read about the + * Resource Hierarchy. * * Generated from protobuf message google.cloud.compute.v1.Project */ class Project extends \Google\Protobuf\Internal\Message { /** - * [Output Only] The Cloud Armor tier for this project. It can be one of the following values: CA_STANDARD, CA_ENTERPRISE_PAYGO. If this field is not specified, it is assumed to be CA_STANDARD. + * [Output Only] The Cloud Armor tier for this project. It can be one of the + * following values: CA_STANDARD,CA_ENTERPRISE_PAYGO. + * If this field is not specified, it is assumed to beCA_STANDARD. * Check the CloudArmorTier enum for the list of possible values. * * Generated from protobuf field optional string cloud_armor_tier = 4427052; */ protected $cloud_armor_tier = null; /** - * Metadata key/value pairs available to all instances contained in this project. See Custom metadata for more information. + * Metadata key/value pairs available to all instances contained in this + * project. See Custom + * metadata for more information. * * Generated from protobuf field optional .google.cloud.compute.v1.Metadata common_instance_metadata = 185794117; */ protected $common_instance_metadata = null; /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; */ protected $creation_timestamp = null; /** - * This signifies the default network tier used for configuring resources of the project and can only take the following values: PREMIUM, STANDARD. Initially the default network tier is PREMIUM. + * This signifies the default network tier used for configuring resources of + * the project and can only take the following values:PREMIUM, STANDARD. Initially the default network + * tier is PREMIUM. * Check the DefaultNetworkTier enum for the list of possible values. * * Generated from protobuf field optional string default_network_tier = 471753361; @@ -60,19 +70,23 @@ class Project extends \Google\Protobuf\Internal\Message */ private $enabled_features; /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. This is *not* the project ID, and is just a unique ID used by Compute Engine to identify resources. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. This is *not* the project ID, and is + * just a unique ID used by Compute Engine to identify resources. * * Generated from protobuf field optional uint64 id = 3355; */ protected $id = null; /** - * [Output Only] Type of the resource. Always compute#project for projects. + * [Output Only] Type of the resource. Always compute#project for + * projects. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * The project ID. For example: my-example-project. Use the project ID to make requests to Compute Engine. + * The project ID. For example: my-example-project. Use the + * project ID to make requests to Compute Engine. * * Generated from protobuf field optional string name = 3373707; */ @@ -90,20 +104,24 @@ class Project extends \Google\Protobuf\Internal\Message */ protected $self_link = null; /** - * An optional naming prefix for daily usage reports and the Google Cloud Storage bucket where they are stored. + * An optional naming prefix for daily usage reports and the Google Cloud + * Storage bucket where they are stored. * * Generated from protobuf field optional .google.cloud.compute.v1.UsageExportLocation usage_export_location = 347543874; */ protected $usage_export_location = null; /** - * [Output Only] Default internal DNS setting used by VMs running in this project. + * [Output Only] Default internal DNS setting used by VMs running in + * this project. * Check the VmDnsSetting enum for the list of possible values. * * Generated from protobuf field optional string vm_dns_setting = 58856370; */ protected $vm_dns_setting = null; /** - * [Output Only] The role this project has in a shared VPC configuration. Currently, only projects with the host role, which is specified by the value HOST, are differentiated. + * [Output Only] The role this project has in a shared VPC configuration. + * Currently, only projects with the host role, which is specified by the + * value HOST, are differentiated. * Check the XpnProjectStatus enum for the list of possible values. * * Generated from protobuf field optional string xpn_project_status = 228419265; @@ -117,14 +135,21 @@ class Project extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $cloud_armor_tier - * [Output Only] The Cloud Armor tier for this project. It can be one of the following values: CA_STANDARD, CA_ENTERPRISE_PAYGO. If this field is not specified, it is assumed to be CA_STANDARD. + * [Output Only] The Cloud Armor tier for this project. It can be one of the + * following values: CA_STANDARD,CA_ENTERPRISE_PAYGO. + * If this field is not specified, it is assumed to beCA_STANDARD. * Check the CloudArmorTier enum for the list of possible values. * @type \Google\Cloud\Compute\V1\Metadata $common_instance_metadata - * Metadata key/value pairs available to all instances contained in this project. See Custom metadata for more information. + * Metadata key/value pairs available to all instances contained in this + * project. See Custom + * metadata for more information. * @type string $creation_timestamp - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * @type string $default_network_tier - * This signifies the default network tier used for configuring resources of the project and can only take the following values: PREMIUM, STANDARD. Initially the default network tier is PREMIUM. + * This signifies the default network tier used for configuring resources of + * the project and can only take the following values:PREMIUM, STANDARD. Initially the default network + * tier is PREMIUM. * Check the DefaultNetworkTier enum for the list of possible values. * @type string $default_service_account * [Output Only] Default service account used by VMs running in this project. @@ -133,22 +158,30 @@ class Project extends \Google\Protobuf\Internal\Message * @type array|\Google\Protobuf\Internal\RepeatedField $enabled_features * An optional list of restricted features enabled for use on this project. * @type int|string $id - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. This is *not* the project ID, and is just a unique ID used by Compute Engine to identify resources. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. This is *not* the project ID, and is + * just a unique ID used by Compute Engine to identify resources. * @type string $kind - * [Output Only] Type of the resource. Always compute#project for projects. + * [Output Only] Type of the resource. Always compute#project for + * projects. * @type string $name - * The project ID. For example: my-example-project. Use the project ID to make requests to Compute Engine. + * The project ID. For example: my-example-project. Use the + * project ID to make requests to Compute Engine. * @type array<\Google\Cloud\Compute\V1\Quota>|\Google\Protobuf\Internal\RepeatedField $quotas * [Output Only] Quotas assigned to this project. * @type string $self_link * [Output Only] Server-defined URL for the resource. * @type \Google\Cloud\Compute\V1\UsageExportLocation $usage_export_location - * An optional naming prefix for daily usage reports and the Google Cloud Storage bucket where they are stored. + * An optional naming prefix for daily usage reports and the Google Cloud + * Storage bucket where they are stored. * @type string $vm_dns_setting - * [Output Only] Default internal DNS setting used by VMs running in this project. + * [Output Only] Default internal DNS setting used by VMs running in + * this project. * Check the VmDnsSetting enum for the list of possible values. * @type string $xpn_project_status - * [Output Only] The role this project has in a shared VPC configuration. Currently, only projects with the host role, which is specified by the value HOST, are differentiated. + * [Output Only] The role this project has in a shared VPC configuration. + * Currently, only projects with the host role, which is specified by the + * value HOST, are differentiated. * Check the XpnProjectStatus enum for the list of possible values. * } */ @@ -158,7 +191,9 @@ public function __construct($data = NULL) { } /** - * [Output Only] The Cloud Armor tier for this project. It can be one of the following values: CA_STANDARD, CA_ENTERPRISE_PAYGO. If this field is not specified, it is assumed to be CA_STANDARD. + * [Output Only] The Cloud Armor tier for this project. It can be one of the + * following values: CA_STANDARD,CA_ENTERPRISE_PAYGO. + * If this field is not specified, it is assumed to beCA_STANDARD. * Check the CloudArmorTier enum for the list of possible values. * * Generated from protobuf field optional string cloud_armor_tier = 4427052; @@ -180,7 +215,9 @@ public function clearCloudArmorTier() } /** - * [Output Only] The Cloud Armor tier for this project. It can be one of the following values: CA_STANDARD, CA_ENTERPRISE_PAYGO. If this field is not specified, it is assumed to be CA_STANDARD. + * [Output Only] The Cloud Armor tier for this project. It can be one of the + * following values: CA_STANDARD,CA_ENTERPRISE_PAYGO. + * If this field is not specified, it is assumed to beCA_STANDARD. * Check the CloudArmorTier enum for the list of possible values. * * Generated from protobuf field optional string cloud_armor_tier = 4427052; @@ -196,7 +233,9 @@ public function setCloudArmorTier($var) } /** - * Metadata key/value pairs available to all instances contained in this project. See Custom metadata for more information. + * Metadata key/value pairs available to all instances contained in this + * project. See Custom + * metadata for more information. * * Generated from protobuf field optional .google.cloud.compute.v1.Metadata common_instance_metadata = 185794117; * @return \Google\Cloud\Compute\V1\Metadata|null @@ -217,7 +256,9 @@ public function clearCommonInstanceMetadata() } /** - * Metadata key/value pairs available to all instances contained in this project. See Custom metadata for more information. + * Metadata key/value pairs available to all instances contained in this + * project. See Custom + * metadata for more information. * * Generated from protobuf field optional .google.cloud.compute.v1.Metadata common_instance_metadata = 185794117; * @param \Google\Cloud\Compute\V1\Metadata $var @@ -232,7 +273,8 @@ public function setCommonInstanceMetadata($var) } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @return string @@ -253,7 +295,8 @@ public function clearCreationTimestamp() } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @param string $var @@ -268,7 +311,9 @@ public function setCreationTimestamp($var) } /** - * This signifies the default network tier used for configuring resources of the project and can only take the following values: PREMIUM, STANDARD. Initially the default network tier is PREMIUM. + * This signifies the default network tier used for configuring resources of + * the project and can only take the following values:PREMIUM, STANDARD. Initially the default network + * tier is PREMIUM. * Check the DefaultNetworkTier enum for the list of possible values. * * Generated from protobuf field optional string default_network_tier = 471753361; @@ -290,7 +335,9 @@ public function clearDefaultNetworkTier() } /** - * This signifies the default network tier used for configuring resources of the project and can only take the following values: PREMIUM, STANDARD. Initially the default network tier is PREMIUM. + * This signifies the default network tier used for configuring resources of + * the project and can only take the following values:PREMIUM, STANDARD. Initially the default network + * tier is PREMIUM. * Check the DefaultNetworkTier enum for the list of possible values. * * Generated from protobuf field optional string default_network_tier = 471753361; @@ -404,7 +451,9 @@ public function setEnabledFeatures($var) } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. This is *not* the project ID, and is just a unique ID used by Compute Engine to identify resources. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. This is *not* the project ID, and is + * just a unique ID used by Compute Engine to identify resources. * * Generated from protobuf field optional uint64 id = 3355; * @return int|string @@ -425,7 +474,9 @@ public function clearId() } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. This is *not* the project ID, and is just a unique ID used by Compute Engine to identify resources. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. This is *not* the project ID, and is + * just a unique ID used by Compute Engine to identify resources. * * Generated from protobuf field optional uint64 id = 3355; * @param int|string $var @@ -440,7 +491,8 @@ public function setId($var) } /** - * [Output Only] Type of the resource. Always compute#project for projects. + * [Output Only] Type of the resource. Always compute#project for + * projects. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -461,7 +513,8 @@ public function clearKind() } /** - * [Output Only] Type of the resource. Always compute#project for projects. + * [Output Only] Type of the resource. Always compute#project for + * projects. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -476,7 +529,8 @@ public function setKind($var) } /** - * The project ID. For example: my-example-project. Use the project ID to make requests to Compute Engine. + * The project ID. For example: my-example-project. Use the + * project ID to make requests to Compute Engine. * * Generated from protobuf field optional string name = 3373707; * @return string @@ -497,7 +551,8 @@ public function clearName() } /** - * The project ID. For example: my-example-project. Use the project ID to make requests to Compute Engine. + * The project ID. For example: my-example-project. Use the + * project ID to make requests to Compute Engine. * * Generated from protobuf field optional string name = 3373707; * @param string $var @@ -574,7 +629,8 @@ public function setSelfLink($var) } /** - * An optional naming prefix for daily usage reports and the Google Cloud Storage bucket where they are stored. + * An optional naming prefix for daily usage reports and the Google Cloud + * Storage bucket where they are stored. * * Generated from protobuf field optional .google.cloud.compute.v1.UsageExportLocation usage_export_location = 347543874; * @return \Google\Cloud\Compute\V1\UsageExportLocation|null @@ -595,7 +651,8 @@ public function clearUsageExportLocation() } /** - * An optional naming prefix for daily usage reports and the Google Cloud Storage bucket where they are stored. + * An optional naming prefix for daily usage reports and the Google Cloud + * Storage bucket where they are stored. * * Generated from protobuf field optional .google.cloud.compute.v1.UsageExportLocation usage_export_location = 347543874; * @param \Google\Cloud\Compute\V1\UsageExportLocation $var @@ -610,7 +667,8 @@ public function setUsageExportLocation($var) } /** - * [Output Only] Default internal DNS setting used by VMs running in this project. + * [Output Only] Default internal DNS setting used by VMs running in + * this project. * Check the VmDnsSetting enum for the list of possible values. * * Generated from protobuf field optional string vm_dns_setting = 58856370; @@ -632,7 +690,8 @@ public function clearVmDnsSetting() } /** - * [Output Only] Default internal DNS setting used by VMs running in this project. + * [Output Only] Default internal DNS setting used by VMs running in + * this project. * Check the VmDnsSetting enum for the list of possible values. * * Generated from protobuf field optional string vm_dns_setting = 58856370; @@ -648,7 +707,9 @@ public function setVmDnsSetting($var) } /** - * [Output Only] The role this project has in a shared VPC configuration. Currently, only projects with the host role, which is specified by the value HOST, are differentiated. + * [Output Only] The role this project has in a shared VPC configuration. + * Currently, only projects with the host role, which is specified by the + * value HOST, are differentiated. * Check the XpnProjectStatus enum for the list of possible values. * * Generated from protobuf field optional string xpn_project_status = 228419265; @@ -670,7 +731,9 @@ public function clearXpnProjectStatus() } /** - * [Output Only] The role this project has in a shared VPC configuration. Currently, only projects with the host role, which is specified by the value HOST, are differentiated. + * [Output Only] The role this project has in a shared VPC configuration. + * Currently, only projects with the host role, which is specified by the + * value HOST, are differentiated. * Check the XpnProjectStatus enum for the list of possible values. * * Generated from protobuf field optional string xpn_project_status = 228419265; diff --git a/Compute/src/V1/Project/CloudArmorTier.php b/Compute/src/V1/Project/CloudArmorTier.php index 830cc28c47a1..cf35673a037b 100644 --- a/Compute/src/V1/Project/CloudArmorTier.php +++ b/Compute/src/V1/Project/CloudArmorTier.php @@ -7,7 +7,9 @@ use UnexpectedValueException; /** - * [Output Only] The Cloud Armor tier for this project. It can be one of the following values: CA_STANDARD, CA_ENTERPRISE_PAYGO. If this field is not specified, it is assumed to be CA_STANDARD. + * [Output Only] The Cloud Armor tier for this project. It can be one of the + * following values: CA_STANDARD,CA_ENTERPRISE_PAYGO. + * If this field is not specified, it is assumed to beCA_STANDARD. * * Protobuf type google.cloud.compute.v1.Project.CloudArmorTier */ diff --git a/Compute/src/V1/Project/DefaultNetworkTier.php b/Compute/src/V1/Project/DefaultNetworkTier.php index d15d20707ead..ecc3a8260b1d 100644 --- a/Compute/src/V1/Project/DefaultNetworkTier.php +++ b/Compute/src/V1/Project/DefaultNetworkTier.php @@ -7,7 +7,9 @@ use UnexpectedValueException; /** - * This signifies the default network tier used for configuring resources of the project and can only take the following values: PREMIUM, STANDARD. Initially the default network tier is PREMIUM. + * This signifies the default network tier used for configuring resources of + * the project and can only take the following values:PREMIUM, STANDARD. Initially the default network + * tier is PREMIUM. * * Protobuf type google.cloud.compute.v1.Project.DefaultNetworkTier */ @@ -26,19 +28,22 @@ class DefaultNetworkTier */ const FIXED_STANDARD = 310464328; /** - * High quality, Google-grade network tier, support for all networking products. + * High quality, Google-grade network tier, support for all networking + * products. * * Generated from protobuf enum PREMIUM = 399530551; */ const PREMIUM = 399530551; /** - * Public internet quality, only limited support for other networking products. + * Public internet quality, only limited support for other networking + * products. * * Generated from protobuf enum STANDARD = 484642493; */ const STANDARD = 484642493; /** - * (Output only) Temporary tier for FIXED_STANDARD when fixed standard tier is expired or not configured. + * (Output only) Temporary tier for FIXED_STANDARD when fixed standard tier + * is expired or not configured. * * Generated from protobuf enum STANDARD_OVERRIDES_FIXED_STANDARD = 465847234; */ diff --git a/Compute/src/V1/Project/VmDnsSetting.php b/Compute/src/V1/Project/VmDnsSetting.php index 7247d9015444..3a554e318c6f 100644 --- a/Compute/src/V1/Project/VmDnsSetting.php +++ b/Compute/src/V1/Project/VmDnsSetting.php @@ -7,7 +7,8 @@ use UnexpectedValueException; /** - * [Output Only] Default internal DNS setting used by VMs running in this project. + * [Output Only] Default internal DNS setting used by VMs running in + * this project. * * Protobuf type google.cloud.compute.v1.Project.VmDnsSetting */ diff --git a/Compute/src/V1/Project/XpnProjectStatus.php b/Compute/src/V1/Project/XpnProjectStatus.php index 0c5c7d16e5bb..3df6de071eb1 100644 --- a/Compute/src/V1/Project/XpnProjectStatus.php +++ b/Compute/src/V1/Project/XpnProjectStatus.php @@ -7,7 +7,9 @@ use UnexpectedValueException; /** - * [Output Only] The role this project has in a shared VPC configuration. Currently, only projects with the host role, which is specified by the value HOST, are differentiated. + * [Output Only] The role this project has in a shared VPC configuration. + * Currently, only projects with the host role, which is specified by the + * value HOST, are differentiated. * * Protobuf type google.cloud.compute.v1.Project.XpnProjectStatus */ diff --git a/Compute/src/V1/ProjectsGetXpnResources.php b/Compute/src/V1/ProjectsGetXpnResources.php index 5bbc5990d129..d4af33465531 100644 --- a/Compute/src/V1/ProjectsGetXpnResources.php +++ b/Compute/src/V1/ProjectsGetXpnResources.php @@ -15,19 +15,25 @@ class ProjectsGetXpnResources extends \Google\Protobuf\Internal\Message { /** - * [Output Only] Type of resource. Always compute#projectsGetXpnResources for lists of service resources (a.k.a service projects) + * [Output Only] Type of resource. Alwayscompute#projectsGetXpnResources for lists of service resources + * (a.k.a service projects) * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ protected $next_page_token = null; /** - * Service resources (a.k.a service projects) attached to this project as their shared VPC host. + * Service resources (a.k.a service projects) attached to this project as + * their shared VPC host. * * Generated from protobuf field repeated .google.cloud.compute.v1.XpnResourceId resources = 164412965; */ @@ -40,11 +46,17 @@ class ProjectsGetXpnResources extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $kind - * [Output Only] Type of resource. Always compute#projectsGetXpnResources for lists of service resources (a.k.a service projects) + * [Output Only] Type of resource. Alwayscompute#projectsGetXpnResources for lists of service resources + * (a.k.a service projects) * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type array<\Google\Cloud\Compute\V1\XpnResourceId>|\Google\Protobuf\Internal\RepeatedField $resources - * Service resources (a.k.a service projects) attached to this project as their shared VPC host. + * Service resources (a.k.a service projects) attached to this project as + * their shared VPC host. * } */ public function __construct($data = NULL) { @@ -53,7 +65,8 @@ public function __construct($data = NULL) { } /** - * [Output Only] Type of resource. Always compute#projectsGetXpnResources for lists of service resources (a.k.a service projects) + * [Output Only] Type of resource. Alwayscompute#projectsGetXpnResources for lists of service resources + * (a.k.a service projects) * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -74,7 +87,8 @@ public function clearKind() } /** - * [Output Only] Type of resource. Always compute#projectsGetXpnResources for lists of service resources (a.k.a service projects) + * [Output Only] Type of resource. Alwayscompute#projectsGetXpnResources for lists of service resources + * (a.k.a service projects) * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -89,7 +103,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -110,7 +128,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var @@ -125,7 +147,8 @@ public function setNextPageToken($var) } /** - * Service resources (a.k.a service projects) attached to this project as their shared VPC host. + * Service resources (a.k.a service projects) attached to this project as + * their shared VPC host. * * Generated from protobuf field repeated .google.cloud.compute.v1.XpnResourceId resources = 164412965; * @return \Google\Protobuf\Internal\RepeatedField @@ -136,7 +159,8 @@ public function getResources() } /** - * Service resources (a.k.a service projects) attached to this project as their shared VPC host. + * Service resources (a.k.a service projects) attached to this project as + * their shared VPC host. * * Generated from protobuf field repeated .google.cloud.compute.v1.XpnResourceId resources = 164412965; * @param array<\Google\Cloud\Compute\V1\XpnResourceId>|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/ProjectsListXpnHostsRequest.php b/Compute/src/V1/ProjectsListXpnHostsRequest.php index 375063e9ac3d..b2defdb8d657 100644 --- a/Compute/src/V1/ProjectsListXpnHostsRequest.php +++ b/Compute/src/V1/ProjectsListXpnHostsRequest.php @@ -15,7 +15,9 @@ class ProjectsListXpnHostsRequest extends \Google\Protobuf\Internal\Message { /** - * Optional organization ID managed by Cloud Resource Manager, for which to list shared VPC host projects. If not specified, the organization will be inferred from the project. + * Optional organization ID managed by Cloud Resource Manager, for which to + * list shared VPC host projects. If not specified, the organization will be + * inferred from the project. * * Generated from protobuf field optional string organization = 105180467; */ @@ -28,7 +30,9 @@ class ProjectsListXpnHostsRequest extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $organization - * Optional organization ID managed by Cloud Resource Manager, for which to list shared VPC host projects. If not specified, the organization will be inferred from the project. + * Optional organization ID managed by Cloud Resource Manager, for which to + * list shared VPC host projects. If not specified, the organization will be + * inferred from the project. * } */ public function __construct($data = NULL) { @@ -37,7 +41,9 @@ public function __construct($data = NULL) { } /** - * Optional organization ID managed by Cloud Resource Manager, for which to list shared VPC host projects. If not specified, the organization will be inferred from the project. + * Optional organization ID managed by Cloud Resource Manager, for which to + * list shared VPC host projects. If not specified, the organization will be + * inferred from the project. * * Generated from protobuf field optional string organization = 105180467; * @return string @@ -58,7 +64,9 @@ public function clearOrganization() } /** - * Optional organization ID managed by Cloud Resource Manager, for which to list shared VPC host projects. If not specified, the organization will be inferred from the project. + * Optional organization ID managed by Cloud Resource Manager, for which to + * list shared VPC host projects. If not specified, the organization will be + * inferred from the project. * * Generated from protobuf field optional string organization = 105180467; * @param string $var diff --git a/Compute/src/V1/ProjectsSetDefaultNetworkTierRequest/NetworkTier.php b/Compute/src/V1/ProjectsSetDefaultNetworkTierRequest/NetworkTier.php index e1d7c8917ea6..3f0cf3b1b1cf 100644 --- a/Compute/src/V1/ProjectsSetDefaultNetworkTierRequest/NetworkTier.php +++ b/Compute/src/V1/ProjectsSetDefaultNetworkTierRequest/NetworkTier.php @@ -26,19 +26,22 @@ class NetworkTier */ const FIXED_STANDARD = 310464328; /** - * High quality, Google-grade network tier, support for all networking products. + * High quality, Google-grade network tier, support for all networking + * products. * * Generated from protobuf enum PREMIUM = 399530551; */ const PREMIUM = 399530551; /** - * Public internet quality, only limited support for other networking products. + * Public internet quality, only limited support for other networking + * products. * * Generated from protobuf enum STANDARD = 484642493; */ const STANDARD = 484642493; /** - * (Output only) Temporary tier for FIXED_STANDARD when fixed standard tier is expired or not configured. + * (Output only) Temporary tier for FIXED_STANDARD when fixed standard tier + * is expired or not configured. * * Generated from protobuf enum STANDARD_OVERRIDES_FIXED_STANDARD = 465847234; */ diff --git a/Compute/src/V1/PublicAdvertisedPrefix.php b/Compute/src/V1/PublicAdvertisedPrefix.php index 7a9b4f9e40db..303e5c708528 100644 --- a/Compute/src/V1/PublicAdvertisedPrefix.php +++ b/Compute/src/V1/PublicAdvertisedPrefix.php @@ -9,7 +9,9 @@ use Google\Protobuf\Internal\GPBUtil; /** - * A public advertised prefix represents an aggregated IP prefix or netblock which customers bring to cloud. The IP prefix is a single unit of route advertisement and is announced globally to the internet. + * A public advertised prefix represents an aggregated IP prefix or netblock + * which customers bring to cloud. The IP prefix is a single unit of route + * advertisement and is announced globally to the internet. * * Generated from protobuf message google.cloud.compute.v1.PublicAdvertisedPrefix */ @@ -23,13 +25,15 @@ class PublicAdvertisedPrefix extends \Google\Protobuf\Internal\Message */ protected $byoip_api_version = null; /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; */ protected $creation_timestamp = null; /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; */ @@ -41,44 +45,74 @@ class PublicAdvertisedPrefix extends \Google\Protobuf\Internal\Message */ protected $dns_verification_ip = null; /** - * Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking. This field will be ignored when inserting a new PublicAdvertisedPrefix. An up-to-date fingerprint must be provided in order to update the PublicAdvertisedPrefix, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a PublicAdvertisedPrefix. + * Fingerprint of this resource. A hash of the contents stored in this object. + * This field is used in optimistic locking. This field will be ignored when + * inserting a new PublicAdvertisedPrefix. An up-to-date + * fingerprint must be provided in order to update thePublicAdvertisedPrefix, otherwise the request will fail with + * error 412 conditionNotMet. + * To see the latest fingerprint, make a get() request to + * retrieve a PublicAdvertisedPrefix. * * Generated from protobuf field optional string fingerprint = 234678500; */ protected $fingerprint = null; /** - * [Output Only] The unique identifier for the resource type. The server generates this identifier. + * [Output Only] The unique identifier for the resource type. The server + * generates this identifier. * * Generated from protobuf field optional uint64 id = 3355; */ protected $id = null; /** - * The address range, in CIDR format, represented by this public advertised prefix. + * The address range, in CIDR format, represented by this public advertised + * prefix. * * Generated from protobuf field optional string ip_cidr_range = 98117322; */ protected $ip_cidr_range = null; /** - * [Output Only] Type of the resource. Always compute#publicAdvertisedPrefix for public advertised prefixes. + * The internet access type for IPv6 Public Advertised Prefixes. + * Check the Ipv6AccessType enum for the list of possible values. + * + * Generated from protobuf field optional string ipv6_access_type = 504658653; + */ + protected $ipv6_access_type = null; + /** + * [Output Only] Type of the resource. Alwayscompute#publicAdvertisedPrefix for public advertised prefixes. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * * Generated from protobuf field optional string name = 3373707; */ protected $name = null; /** - * Specifies how child public delegated prefix will be scoped. It could be one of following values: - `REGIONAL`: The public delegated prefix is regional only. The provisioning will take a few minutes. - `GLOBAL`: The public delegated prefix is global only. The provisioning will take ~4 weeks. - `GLOBAL_AND_REGIONAL` [output only]: The public delegated prefixes is BYOIP V1 legacy prefix. This is output only value and no longer supported in BYOIP V2. + * Specifies how child public delegated prefix will be scoped. It could + * be one of following values: + * - `REGIONAL`: The public delegated prefix is regional only. The + * provisioning will take a few minutes. + * - `GLOBAL`: The public delegated prefix is global only. The + * provisioning will take ~4 weeks. + * - `GLOBAL_AND_REGIONAL` [output only]: The public delegated prefixes is + * BYOIP V1 legacy prefix. This is output only value and no longer + * supported in BYOIP V2. * Check the PdpScope enum for the list of possible values. * * Generated from protobuf field optional string pdp_scope = 524264785; */ protected $pdp_scope = null; /** - * [Output Only] The list of public delegated prefixes that exist for this public advertised prefix. + * [Output Only] The list of public delegated prefixes that exist for this + * public advertised prefix. * * Generated from protobuf field repeated .google.cloud.compute.v1.PublicAdvertisedPrefixPublicDelegatedPrefix public_delegated_prefixs = 425811723; */ @@ -96,7 +130,15 @@ class PublicAdvertisedPrefix extends \Google\Protobuf\Internal\Message */ protected $shared_secret = null; /** - * The status of the public advertised prefix. Possible values include: - `INITIAL`: RPKI validation is complete. - `PTR_CONFIGURED`: User has configured the PTR. - `VALIDATED`: Reverse DNS lookup is successful. - `REVERSE_DNS_LOOKUP_FAILED`: Reverse DNS lookup failed. - `PREFIX_CONFIGURATION_IN_PROGRESS`: The prefix is being configured. - `PREFIX_CONFIGURATION_COMPLETE`: The prefix is fully configured. - `PREFIX_REMOVAL_IN_PROGRESS`: The prefix is being removed. + * The status of the public advertised prefix. Possible values include: + * - `INITIAL`: RPKI validation is complete. + * - `PTR_CONFIGURED`: User has configured the PTR. + * - `VALIDATED`: Reverse DNS lookup is successful. + * - `REVERSE_DNS_LOOKUP_FAILED`: Reverse DNS lookup failed. + * - `PREFIX_CONFIGURATION_IN_PROGRESS`: The prefix is being + * configured. + * - `PREFIX_CONFIGURATION_COMPLETE`: The prefix is fully configured. + * - `PREFIX_REMOVAL_IN_PROGRESS`: The prefix is being removed. * Check the Status enum for the list of possible values. * * Generated from protobuf field optional string status = 181260274; @@ -113,32 +155,68 @@ class PublicAdvertisedPrefix extends \Google\Protobuf\Internal\Message * [Output Only] The version of BYOIP API. * Check the ByoipApiVersion enum for the list of possible values. * @type string $creation_timestamp - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * @type string $description - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * @type string $dns_verification_ip * The address to be used for reverse DNS verification. * @type string $fingerprint - * Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking. This field will be ignored when inserting a new PublicAdvertisedPrefix. An up-to-date fingerprint must be provided in order to update the PublicAdvertisedPrefix, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a PublicAdvertisedPrefix. + * Fingerprint of this resource. A hash of the contents stored in this object. + * This field is used in optimistic locking. This field will be ignored when + * inserting a new PublicAdvertisedPrefix. An up-to-date + * fingerprint must be provided in order to update thePublicAdvertisedPrefix, otherwise the request will fail with + * error 412 conditionNotMet. + * To see the latest fingerprint, make a get() request to + * retrieve a PublicAdvertisedPrefix. * @type int|string $id - * [Output Only] The unique identifier for the resource type. The server generates this identifier. + * [Output Only] The unique identifier for the resource type. The server + * generates this identifier. * @type string $ip_cidr_range - * The address range, in CIDR format, represented by this public advertised prefix. + * The address range, in CIDR format, represented by this public advertised + * prefix. + * @type string $ipv6_access_type + * The internet access type for IPv6 Public Advertised Prefixes. + * Check the Ipv6AccessType enum for the list of possible values. * @type string $kind - * [Output Only] Type of the resource. Always compute#publicAdvertisedPrefix for public advertised prefixes. + * [Output Only] Type of the resource. Alwayscompute#publicAdvertisedPrefix for public advertised prefixes. * @type string $name - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * @type string $pdp_scope - * Specifies how child public delegated prefix will be scoped. It could be one of following values: - `REGIONAL`: The public delegated prefix is regional only. The provisioning will take a few minutes. - `GLOBAL`: The public delegated prefix is global only. The provisioning will take ~4 weeks. - `GLOBAL_AND_REGIONAL` [output only]: The public delegated prefixes is BYOIP V1 legacy prefix. This is output only value and no longer supported in BYOIP V2. + * Specifies how child public delegated prefix will be scoped. It could + * be one of following values: + * - `REGIONAL`: The public delegated prefix is regional only. The + * provisioning will take a few minutes. + * - `GLOBAL`: The public delegated prefix is global only. The + * provisioning will take ~4 weeks. + * - `GLOBAL_AND_REGIONAL` [output only]: The public delegated prefixes is + * BYOIP V1 legacy prefix. This is output only value and no longer + * supported in BYOIP V2. * Check the PdpScope enum for the list of possible values. * @type array<\Google\Cloud\Compute\V1\PublicAdvertisedPrefixPublicDelegatedPrefix>|\Google\Protobuf\Internal\RepeatedField $public_delegated_prefixs - * [Output Only] The list of public delegated prefixes that exist for this public advertised prefix. + * [Output Only] The list of public delegated prefixes that exist for this + * public advertised prefix. * @type string $self_link * [Output Only] Server-defined URL for the resource. * @type string $shared_secret * [Output Only] The shared secret to be used for reverse DNS verification. * @type string $status - * The status of the public advertised prefix. Possible values include: - `INITIAL`: RPKI validation is complete. - `PTR_CONFIGURED`: User has configured the PTR. - `VALIDATED`: Reverse DNS lookup is successful. - `REVERSE_DNS_LOOKUP_FAILED`: Reverse DNS lookup failed. - `PREFIX_CONFIGURATION_IN_PROGRESS`: The prefix is being configured. - `PREFIX_CONFIGURATION_COMPLETE`: The prefix is fully configured. - `PREFIX_REMOVAL_IN_PROGRESS`: The prefix is being removed. + * The status of the public advertised prefix. Possible values include: + * - `INITIAL`: RPKI validation is complete. + * - `PTR_CONFIGURED`: User has configured the PTR. + * - `VALIDATED`: Reverse DNS lookup is successful. + * - `REVERSE_DNS_LOOKUP_FAILED`: Reverse DNS lookup failed. + * - `PREFIX_CONFIGURATION_IN_PROGRESS`: The prefix is being + * configured. + * - `PREFIX_CONFIGURATION_COMPLETE`: The prefix is fully configured. + * - `PREFIX_REMOVAL_IN_PROGRESS`: The prefix is being removed. * Check the Status enum for the list of possible values. * } */ @@ -186,7 +264,8 @@ public function setByoipApiVersion($var) } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @return string @@ -207,7 +286,8 @@ public function clearCreationTimestamp() } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @param string $var @@ -222,7 +302,8 @@ public function setCreationTimestamp($var) } /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @return string @@ -243,7 +324,8 @@ public function clearDescription() } /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @param string $var @@ -294,7 +376,13 @@ public function setDnsVerificationIp($var) } /** - * Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking. This field will be ignored when inserting a new PublicAdvertisedPrefix. An up-to-date fingerprint must be provided in order to update the PublicAdvertisedPrefix, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a PublicAdvertisedPrefix. + * Fingerprint of this resource. A hash of the contents stored in this object. + * This field is used in optimistic locking. This field will be ignored when + * inserting a new PublicAdvertisedPrefix. An up-to-date + * fingerprint must be provided in order to update thePublicAdvertisedPrefix, otherwise the request will fail with + * error 412 conditionNotMet. + * To see the latest fingerprint, make a get() request to + * retrieve a PublicAdvertisedPrefix. * * Generated from protobuf field optional string fingerprint = 234678500; * @return string @@ -315,7 +403,13 @@ public function clearFingerprint() } /** - * Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking. This field will be ignored when inserting a new PublicAdvertisedPrefix. An up-to-date fingerprint must be provided in order to update the PublicAdvertisedPrefix, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a PublicAdvertisedPrefix. + * Fingerprint of this resource. A hash of the contents stored in this object. + * This field is used in optimistic locking. This field will be ignored when + * inserting a new PublicAdvertisedPrefix. An up-to-date + * fingerprint must be provided in order to update thePublicAdvertisedPrefix, otherwise the request will fail with + * error 412 conditionNotMet. + * To see the latest fingerprint, make a get() request to + * retrieve a PublicAdvertisedPrefix. * * Generated from protobuf field optional string fingerprint = 234678500; * @param string $var @@ -330,7 +424,8 @@ public function setFingerprint($var) } /** - * [Output Only] The unique identifier for the resource type. The server generates this identifier. + * [Output Only] The unique identifier for the resource type. The server + * generates this identifier. * * Generated from protobuf field optional uint64 id = 3355; * @return int|string @@ -351,7 +446,8 @@ public function clearId() } /** - * [Output Only] The unique identifier for the resource type. The server generates this identifier. + * [Output Only] The unique identifier for the resource type. The server + * generates this identifier. * * Generated from protobuf field optional uint64 id = 3355; * @param int|string $var @@ -366,7 +462,8 @@ public function setId($var) } /** - * The address range, in CIDR format, represented by this public advertised prefix. + * The address range, in CIDR format, represented by this public advertised + * prefix. * * Generated from protobuf field optional string ip_cidr_range = 98117322; * @return string @@ -387,7 +484,8 @@ public function clearIpCidrRange() } /** - * The address range, in CIDR format, represented by this public advertised prefix. + * The address range, in CIDR format, represented by this public advertised + * prefix. * * Generated from protobuf field optional string ip_cidr_range = 98117322; * @param string $var @@ -402,7 +500,45 @@ public function setIpCidrRange($var) } /** - * [Output Only] Type of the resource. Always compute#publicAdvertisedPrefix for public advertised prefixes. + * The internet access type for IPv6 Public Advertised Prefixes. + * Check the Ipv6AccessType enum for the list of possible values. + * + * Generated from protobuf field optional string ipv6_access_type = 504658653; + * @return string + */ + public function getIpv6AccessType() + { + return isset($this->ipv6_access_type) ? $this->ipv6_access_type : ''; + } + + public function hasIpv6AccessType() + { + return isset($this->ipv6_access_type); + } + + public function clearIpv6AccessType() + { + unset($this->ipv6_access_type); + } + + /** + * The internet access type for IPv6 Public Advertised Prefixes. + * Check the Ipv6AccessType enum for the list of possible values. + * + * Generated from protobuf field optional string ipv6_access_type = 504658653; + * @param string $var + * @return $this + */ + public function setIpv6AccessType($var) + { + GPBUtil::checkString($var, True); + $this->ipv6_access_type = $var; + + return $this; + } + + /** + * [Output Only] Type of the resource. Alwayscompute#publicAdvertisedPrefix for public advertised prefixes. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -423,7 +559,7 @@ public function clearKind() } /** - * [Output Only] Type of the resource. Always compute#publicAdvertisedPrefix for public advertised prefixes. + * [Output Only] Type of the resource. Alwayscompute#publicAdvertisedPrefix for public advertised prefixes. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -438,7 +574,13 @@ public function setKind($var) } /** - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * * Generated from protobuf field optional string name = 3373707; * @return string @@ -459,7 +601,13 @@ public function clearName() } /** - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * * Generated from protobuf field optional string name = 3373707; * @param string $var @@ -474,7 +622,15 @@ public function setName($var) } /** - * Specifies how child public delegated prefix will be scoped. It could be one of following values: - `REGIONAL`: The public delegated prefix is regional only. The provisioning will take a few minutes. - `GLOBAL`: The public delegated prefix is global only. The provisioning will take ~4 weeks. - `GLOBAL_AND_REGIONAL` [output only]: The public delegated prefixes is BYOIP V1 legacy prefix. This is output only value and no longer supported in BYOIP V2. + * Specifies how child public delegated prefix will be scoped. It could + * be one of following values: + * - `REGIONAL`: The public delegated prefix is regional only. The + * provisioning will take a few minutes. + * - `GLOBAL`: The public delegated prefix is global only. The + * provisioning will take ~4 weeks. + * - `GLOBAL_AND_REGIONAL` [output only]: The public delegated prefixes is + * BYOIP V1 legacy prefix. This is output only value and no longer + * supported in BYOIP V2. * Check the PdpScope enum for the list of possible values. * * Generated from protobuf field optional string pdp_scope = 524264785; @@ -496,7 +652,15 @@ public function clearPdpScope() } /** - * Specifies how child public delegated prefix will be scoped. It could be one of following values: - `REGIONAL`: The public delegated prefix is regional only. The provisioning will take a few minutes. - `GLOBAL`: The public delegated prefix is global only. The provisioning will take ~4 weeks. - `GLOBAL_AND_REGIONAL` [output only]: The public delegated prefixes is BYOIP V1 legacy prefix. This is output only value and no longer supported in BYOIP V2. + * Specifies how child public delegated prefix will be scoped. It could + * be one of following values: + * - `REGIONAL`: The public delegated prefix is regional only. The + * provisioning will take a few minutes. + * - `GLOBAL`: The public delegated prefix is global only. The + * provisioning will take ~4 weeks. + * - `GLOBAL_AND_REGIONAL` [output only]: The public delegated prefixes is + * BYOIP V1 legacy prefix. This is output only value and no longer + * supported in BYOIP V2. * Check the PdpScope enum for the list of possible values. * * Generated from protobuf field optional string pdp_scope = 524264785; @@ -512,7 +676,8 @@ public function setPdpScope($var) } /** - * [Output Only] The list of public delegated prefixes that exist for this public advertised prefix. + * [Output Only] The list of public delegated prefixes that exist for this + * public advertised prefix. * * Generated from protobuf field repeated .google.cloud.compute.v1.PublicAdvertisedPrefixPublicDelegatedPrefix public_delegated_prefixs = 425811723; * @return \Google\Protobuf\Internal\RepeatedField @@ -523,7 +688,8 @@ public function getPublicDelegatedPrefixs() } /** - * [Output Only] The list of public delegated prefixes that exist for this public advertised prefix. + * [Output Only] The list of public delegated prefixes that exist for this + * public advertised prefix. * * Generated from protobuf field repeated .google.cloud.compute.v1.PublicAdvertisedPrefixPublicDelegatedPrefix public_delegated_prefixs = 425811723; * @param array<\Google\Cloud\Compute\V1\PublicAdvertisedPrefixPublicDelegatedPrefix>|\Google\Protobuf\Internal\RepeatedField $var @@ -610,7 +776,15 @@ public function setSharedSecret($var) } /** - * The status of the public advertised prefix. Possible values include: - `INITIAL`: RPKI validation is complete. - `PTR_CONFIGURED`: User has configured the PTR. - `VALIDATED`: Reverse DNS lookup is successful. - `REVERSE_DNS_LOOKUP_FAILED`: Reverse DNS lookup failed. - `PREFIX_CONFIGURATION_IN_PROGRESS`: The prefix is being configured. - `PREFIX_CONFIGURATION_COMPLETE`: The prefix is fully configured. - `PREFIX_REMOVAL_IN_PROGRESS`: The prefix is being removed. + * The status of the public advertised prefix. Possible values include: + * - `INITIAL`: RPKI validation is complete. + * - `PTR_CONFIGURED`: User has configured the PTR. + * - `VALIDATED`: Reverse DNS lookup is successful. + * - `REVERSE_DNS_LOOKUP_FAILED`: Reverse DNS lookup failed. + * - `PREFIX_CONFIGURATION_IN_PROGRESS`: The prefix is being + * configured. + * - `PREFIX_CONFIGURATION_COMPLETE`: The prefix is fully configured. + * - `PREFIX_REMOVAL_IN_PROGRESS`: The prefix is being removed. * Check the Status enum for the list of possible values. * * Generated from protobuf field optional string status = 181260274; @@ -632,7 +806,15 @@ public function clearStatus() } /** - * The status of the public advertised prefix. Possible values include: - `INITIAL`: RPKI validation is complete. - `PTR_CONFIGURED`: User has configured the PTR. - `VALIDATED`: Reverse DNS lookup is successful. - `REVERSE_DNS_LOOKUP_FAILED`: Reverse DNS lookup failed. - `PREFIX_CONFIGURATION_IN_PROGRESS`: The prefix is being configured. - `PREFIX_CONFIGURATION_COMPLETE`: The prefix is fully configured. - `PREFIX_REMOVAL_IN_PROGRESS`: The prefix is being removed. + * The status of the public advertised prefix. Possible values include: + * - `INITIAL`: RPKI validation is complete. + * - `PTR_CONFIGURED`: User has configured the PTR. + * - `VALIDATED`: Reverse DNS lookup is successful. + * - `REVERSE_DNS_LOOKUP_FAILED`: Reverse DNS lookup failed. + * - `PREFIX_CONFIGURATION_IN_PROGRESS`: The prefix is being + * configured. + * - `PREFIX_CONFIGURATION_COMPLETE`: The prefix is fully configured. + * - `PREFIX_REMOVAL_IN_PROGRESS`: The prefix is being removed. * Check the Status enum for the list of possible values. * * Generated from protobuf field optional string status = 181260274; diff --git a/Compute/src/V1/PublicAdvertisedPrefix/ByoipApiVersion.php b/Compute/src/V1/PublicAdvertisedPrefix/ByoipApiVersion.php index 53c36d8c6247..58658781e224 100644 --- a/Compute/src/V1/PublicAdvertisedPrefix/ByoipApiVersion.php +++ b/Compute/src/V1/PublicAdvertisedPrefix/ByoipApiVersion.php @@ -20,13 +20,17 @@ class ByoipApiVersion */ const UNDEFINED_BYOIP_API_VERSION = 0; /** - * This public advertised prefix can be used to create both regional and global public delegated prefixes. It usually takes 4 weeks to create or delete a public delegated prefix. The BGP status cannot be changed. + * This public advertised prefix can be used to create both regional and + * global public delegated prefixes. It usually takes 4 weeks to create or + * delete a public delegated prefix. The BGP status cannot be changed. * * Generated from protobuf enum V1 = 2715; */ const V1 = 2715; /** - * This public advertised prefix can only be used to create regional public delegated prefixes. Public delegated prefix creation and deletion takes minutes and the BGP status can be modified. + * This public advertised prefix can only be used to create regional public + * delegated prefixes. Public delegated prefix creation and deletion takes + * minutes and the BGP status can be modified. * * Generated from protobuf enum V2 = 2716; */ diff --git a/Compute/src/V1/PublicAdvertisedPrefix/Ipv6AccessType.php b/Compute/src/V1/PublicAdvertisedPrefix/Ipv6AccessType.php new file mode 100644 index 000000000000..345a8e9e6f7b --- /dev/null +++ b/Compute/src/V1/PublicAdvertisedPrefix/Ipv6AccessType.php @@ -0,0 +1,66 @@ +google.cloud.compute.v1.PublicAdvertisedPrefix.Ipv6AccessType + */ +class Ipv6AccessType +{ + /** + * A value indicating that the enum field is not set. + * + * Generated from protobuf enum UNDEFINED_IPV6_ACCESS_TYPE = 0; + */ + const UNDEFINED_IPV6_ACCESS_TYPE = 0; + /** + * Default IPv6 access type. The prefix will be announced to the internet. + * All children Public Delegated Prefixes will have IPv6 access type as + * EXTERNAL. + * + * Generated from protobuf enum EXTERNAL = 35607499; + */ + const EXTERNAL = 35607499; + /** + * The prefix will not be announced to the internet. Prefix will be used + * privately within Cloud. All children Public Delegated Prefixes + * will have IPv6 access type as INTERNAL. + * + * Generated from protobuf enum INTERNAL = 279295677; + */ + const INTERNAL = 279295677; + + private static $valueToName = [ + self::UNDEFINED_IPV6_ACCESS_TYPE => 'UNDEFINED_IPV6_ACCESS_TYPE', + self::EXTERNAL => 'EXTERNAL', + self::INTERNAL => 'INTERNAL', + ]; + + public static function name($value) + { + if (!isset(self::$valueToName[$value])) { + throw new UnexpectedValueException(sprintf( + 'Enum %s has no name defined for value %s', __CLASS__, $value)); + } + return self::$valueToName[$value]; + } + + + public static function value($name) + { + $const = __CLASS__ . '::' . strtoupper($name); + if (!defined($const)) { + throw new UnexpectedValueException(sprintf( + 'Enum %s has no value defined for name %s', __CLASS__, $name)); + } + return constant($const); + } +} + + diff --git a/Compute/src/V1/PublicAdvertisedPrefix/PdpScope.php b/Compute/src/V1/PublicAdvertisedPrefix/PdpScope.php index 16d16c5f3c57..fe2ddf463509 100644 --- a/Compute/src/V1/PublicAdvertisedPrefix/PdpScope.php +++ b/Compute/src/V1/PublicAdvertisedPrefix/PdpScope.php @@ -7,7 +7,15 @@ use UnexpectedValueException; /** - * Specifies how child public delegated prefix will be scoped. It could be one of following values: - `REGIONAL`: The public delegated prefix is regional only. The provisioning will take a few minutes. - `GLOBAL`: The public delegated prefix is global only. The provisioning will take ~4 weeks. - `GLOBAL_AND_REGIONAL` [output only]: The public delegated prefixes is BYOIP V1 legacy prefix. This is output only value and no longer supported in BYOIP V2. + * Specifies how child public delegated prefix will be scoped. It could + * be one of following values: + * - `REGIONAL`: The public delegated prefix is regional only. The + * provisioning will take a few minutes. + * - `GLOBAL`: The public delegated prefix is global only. The + * provisioning will take ~4 weeks. + * - `GLOBAL_AND_REGIONAL` [output only]: The public delegated prefixes is + * BYOIP V1 legacy prefix. This is output only value and no longer + * supported in BYOIP V2. * * Protobuf type google.cloud.compute.v1.PublicAdvertisedPrefix.PdpScope */ @@ -20,19 +28,22 @@ class PdpScope */ const UNDEFINED_PDP_SCOPE = 0; /** - * The public delegated prefix is global only. The provisioning will take ~4 weeks. + * The public delegated prefix is global only. The provisioning will take ~4 + * weeks. * * Generated from protobuf enum GLOBAL = 494663587; */ const PBGLOBAL = 494663587; /** - * The public delegated prefixes is BYOIP V1 legacy prefix. This is output only value and no longer supported in BYOIP V2. + * The public delegated prefixes is BYOIP V1 legacy prefix. This is output + * only value and no longer supported in BYOIP V2. * * Generated from protobuf enum GLOBAL_AND_REGIONAL = 318053059; */ const GLOBAL_AND_REGIONAL = 318053059; /** - * The public delegated prefix is regional only. The provisioning will take a few minutes. + * The public delegated prefix is regional only. The provisioning will take + * a few minutes. * * Generated from protobuf enum REGIONAL = 92288543; */ diff --git a/Compute/src/V1/PublicAdvertisedPrefix/Status.php b/Compute/src/V1/PublicAdvertisedPrefix/Status.php index aff0c6f86585..5a606c67de06 100644 --- a/Compute/src/V1/PublicAdvertisedPrefix/Status.php +++ b/Compute/src/V1/PublicAdvertisedPrefix/Status.php @@ -7,7 +7,15 @@ use UnexpectedValueException; /** - * The status of the public advertised prefix. Possible values include: - `INITIAL`: RPKI validation is complete. - `PTR_CONFIGURED`: User has configured the PTR. - `VALIDATED`: Reverse DNS lookup is successful. - `REVERSE_DNS_LOOKUP_FAILED`: Reverse DNS lookup failed. - `PREFIX_CONFIGURATION_IN_PROGRESS`: The prefix is being configured. - `PREFIX_CONFIGURATION_COMPLETE`: The prefix is fully configured. - `PREFIX_REMOVAL_IN_PROGRESS`: The prefix is being removed. + * The status of the public advertised prefix. Possible values include: + * - `INITIAL`: RPKI validation is complete. + * - `PTR_CONFIGURED`: User has configured the PTR. + * - `VALIDATED`: Reverse DNS lookup is successful. + * - `REVERSE_DNS_LOOKUP_FAILED`: Reverse DNS lookup failed. + * - `PREFIX_CONFIGURATION_IN_PROGRESS`: The prefix is being + * configured. + * - `PREFIX_CONFIGURATION_COMPLETE`: The prefix is fully configured. + * - `PREFIX_REMOVAL_IN_PROGRESS`: The prefix is being removed. * * Protobuf type google.cloud.compute.v1.PublicAdvertisedPrefix.Status */ diff --git a/Compute/src/V1/PublicAdvertisedPrefixList.php b/Compute/src/V1/PublicAdvertisedPrefixList.php index 2fcad75d830c..67b881d50dfc 100644 --- a/Compute/src/V1/PublicAdvertisedPrefixList.php +++ b/Compute/src/V1/PublicAdvertisedPrefixList.php @@ -27,13 +27,17 @@ class PublicAdvertisedPrefixList extends \Google\Protobuf\Internal\Message */ private $items; /** - * [Output Only] Type of the resource. Always compute#publicAdvertisedPrefix for public advertised prefixes. + * [Output Only] Type of the resource. Alwayscompute#publicAdvertisedPrefix for public advertised prefixes. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -62,9 +66,13 @@ class PublicAdvertisedPrefixList extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\PublicAdvertisedPrefix>|\Google\Protobuf\Internal\RepeatedField $items * A list of PublicAdvertisedPrefix resources. * @type string $kind - * [Output Only] Type of the resource. Always compute#publicAdvertisedPrefix for public advertised prefixes. + * [Output Only] Type of the resource. Alwayscompute#publicAdvertisedPrefix for public advertised prefixes. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type \Google\Cloud\Compute\V1\Warning $warning @@ -139,7 +147,7 @@ public function setItems($var) } /** - * [Output Only] Type of the resource. Always compute#publicAdvertisedPrefix for public advertised prefixes. + * [Output Only] Type of the resource. Alwayscompute#publicAdvertisedPrefix for public advertised prefixes. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -160,7 +168,7 @@ public function clearKind() } /** - * [Output Only] Type of the resource. Always compute#publicAdvertisedPrefix for public advertised prefixes. + * [Output Only] Type of the resource. Alwayscompute#publicAdvertisedPrefix for public advertised prefixes. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -175,7 +183,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -196,7 +208,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/PublicAdvertisedPrefixPublicDelegatedPrefix.php b/Compute/src/V1/PublicAdvertisedPrefixPublicDelegatedPrefix.php index 9255ed5a3132..a0282dd825d0 100644 --- a/Compute/src/V1/PublicAdvertisedPrefixPublicDelegatedPrefix.php +++ b/Compute/src/V1/PublicAdvertisedPrefixPublicDelegatedPrefix.php @@ -34,13 +34,17 @@ class PublicAdvertisedPrefixPublicDelegatedPrefix extends \Google\Protobuf\Inter */ protected $project = null; /** - * The region of the public delegated prefix if it is regional. If absent, the prefix is global. + * The region of the public delegated prefix if it is regional. If absent, + * the prefix is global. * * Generated from protobuf field optional string region = 138946292; */ protected $region = null; /** - * The status of the public delegated prefix. Possible values are: INITIALIZING: The public delegated prefix is being initialized and addresses cannot be created yet. ANNOUNCED: The public delegated prefix is active. + * The status of the public delegated prefix. Possible values are: + * INITIALIZING: The public delegated prefix is being initialized and + * addresses cannot be created yet. + * ANNOUNCED: The public delegated prefix is active. * * Generated from protobuf field optional string status = 181260274; */ @@ -59,9 +63,13 @@ class PublicAdvertisedPrefixPublicDelegatedPrefix extends \Google\Protobuf\Inter * @type string $project * The project number of the public delegated prefix * @type string $region - * The region of the public delegated prefix if it is regional. If absent, the prefix is global. + * The region of the public delegated prefix if it is regional. If absent, + * the prefix is global. * @type string $status - * The status of the public delegated prefix. Possible values are: INITIALIZING: The public delegated prefix is being initialized and addresses cannot be created yet. ANNOUNCED: The public delegated prefix is active. + * The status of the public delegated prefix. Possible values are: + * INITIALIZING: The public delegated prefix is being initialized and + * addresses cannot be created yet. + * ANNOUNCED: The public delegated prefix is active. * } */ public function __construct($data = NULL) { @@ -178,7 +186,8 @@ public function setProject($var) } /** - * The region of the public delegated prefix if it is regional. If absent, the prefix is global. + * The region of the public delegated prefix if it is regional. If absent, + * the prefix is global. * * Generated from protobuf field optional string region = 138946292; * @return string @@ -199,7 +208,8 @@ public function clearRegion() } /** - * The region of the public delegated prefix if it is regional. If absent, the prefix is global. + * The region of the public delegated prefix if it is regional. If absent, + * the prefix is global. * * Generated from protobuf field optional string region = 138946292; * @param string $var @@ -214,7 +224,10 @@ public function setRegion($var) } /** - * The status of the public delegated prefix. Possible values are: INITIALIZING: The public delegated prefix is being initialized and addresses cannot be created yet. ANNOUNCED: The public delegated prefix is active. + * The status of the public delegated prefix. Possible values are: + * INITIALIZING: The public delegated prefix is being initialized and + * addresses cannot be created yet. + * ANNOUNCED: The public delegated prefix is active. * * Generated from protobuf field optional string status = 181260274; * @return string @@ -235,7 +248,10 @@ public function clearStatus() } /** - * The status of the public delegated prefix. Possible values are: INITIALIZING: The public delegated prefix is being initialized and addresses cannot be created yet. ANNOUNCED: The public delegated prefix is active. + * The status of the public delegated prefix. Possible values are: + * INITIALIZING: The public delegated prefix is being initialized and + * addresses cannot be created yet. + * ANNOUNCED: The public delegated prefix is active. * * Generated from protobuf field optional string status = 181260274; * @param string $var diff --git a/Compute/src/V1/PublicDelegatedPrefix.php b/Compute/src/V1/PublicDelegatedPrefix.php index 4a3ed42e6342..3406e735f7b7 100644 --- a/Compute/src/V1/PublicDelegatedPrefix.php +++ b/Compute/src/V1/PublicDelegatedPrefix.php @@ -9,14 +9,20 @@ use Google\Protobuf\Internal\GPBUtil; /** - * A PublicDelegatedPrefix resource represents an IP block within a PublicAdvertisedPrefix that is configured within a single cloud scope (global or region). IPs in the block can be allocated to resources within that scope. Public delegated prefixes may be further broken up into smaller IP blocks in the same scope as the parent block. + * A PublicDelegatedPrefix resource represents an IP block within a + * PublicAdvertisedPrefix that is configured within a single cloud scope + * (global or region). IPs in the block can be allocated to resources within + * that scope. Public delegated prefixes may be further broken up into + * smaller IP blocks in the same scope as the parent block. * * Generated from protobuf message google.cloud.compute.v1.PublicDelegatedPrefix */ class PublicDelegatedPrefix extends \Google\Protobuf\Internal\Message { /** - * The allocatable prefix length supported by this public delegated prefix. This field is optional and cannot be set for prefixes in DELEGATION mode. It cannot be set for IPv4 prefixes either, and it always defaults to 32. + * The allocatable prefix length supported by this public delegated prefix. + * This field is optional and cannot be set for prefixes in DELEGATION mode. + * It cannot be set for IPv4 prefixes either, and it always defaults to 32. * * Generated from protobuf field optional int32 allocatable_prefix_length = 38427446; */ @@ -29,35 +35,53 @@ class PublicDelegatedPrefix extends \Google\Protobuf\Internal\Message */ protected $byoip_api_version = null; /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; */ protected $creation_timestamp = null; /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; */ protected $description = null; /** - * Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking. This field will be ignored when inserting a new PublicDelegatedPrefix. An up-to-date fingerprint must be provided in order to update the PublicDelegatedPrefix, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a PublicDelegatedPrefix. + * Fingerprint of this resource. A hash of the contents stored in this object. + * This field is used in optimistic locking. This field will be ignored when + * inserting a new PublicDelegatedPrefix. An up-to-date + * fingerprint must be provided in order to update thePublicDelegatedPrefix, otherwise the request will fail with + * error 412 conditionNotMet. + * To see the latest fingerprint, make a get() request to + * retrieve a PublicDelegatedPrefix. * * Generated from protobuf field optional string fingerprint = 234678500; */ protected $fingerprint = null; /** - * [Output Only] The unique identifier for the resource type. The server generates this identifier. + * [Output Only] The unique identifier for the resource type. The server + * generates this identifier. * * Generated from protobuf field optional uint64 id = 3355; */ protected $id = null; /** - * The IP address range, in CIDR format, represented by this public delegated prefix. + * The IP address range, in CIDR format, represented by this public + * delegated prefix. * * Generated from protobuf field optional string ip_cidr_range = 98117322; */ protected $ip_cidr_range = null; + /** + * [Output Only] The internet access type for IPv6 Public Delegated Prefixes. + * Inherited from parent prefix. + * Check the Ipv6AccessType enum for the list of possible values. + * + * Generated from protobuf field optional string ipv6_access_type = 504658653; + */ + protected $ipv6_access_type = null; /** * If true, the prefix will be live migrated. * @@ -65,7 +89,7 @@ class PublicDelegatedPrefix extends \Google\Protobuf\Internal\Message */ protected $is_live_migration = null; /** - * [Output Only] Type of the resource. Always compute#publicDelegatedPrefix for public delegated prefixes. + * [Output Only] Type of the resource. Alwayscompute#publicDelegatedPrefix for public delegated prefixes. * * Generated from protobuf field optional string kind = 3292052; */ @@ -78,25 +102,36 @@ class PublicDelegatedPrefix extends \Google\Protobuf\Internal\Message */ protected $mode = null; /** - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * * Generated from protobuf field optional string name = 3373707; */ protected $name = null; /** - * The URL of parent prefix. Either PublicAdvertisedPrefix or PublicDelegatedPrefix. + * The URL of parent prefix. Either PublicAdvertisedPrefix or + * PublicDelegatedPrefix. * * Generated from protobuf field optional string parent_prefix = 15233991; */ protected $parent_prefix = null; /** - * The list of sub public delegated prefixes that exist for this public delegated prefix. + * The list of sub public delegated prefixes that exist for this public + * delegated prefix. * * Generated from protobuf field repeated .google.cloud.compute.v1.PublicDelegatedPrefixPublicDelegatedSubPrefix public_delegated_sub_prefixs = 188940044; */ private $public_delegated_sub_prefixs; /** - * [Output Only] URL of the region where the public delegated prefix resides. This field applies only to the region resource. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * [Output Only] URL of the region where the public delegated prefix resides. + * This field applies only to the region resource. You must specify this + * field as part of the HTTP request URL. It is not settable as a field in + * the request body. * * Generated from protobuf field optional string region = 138946292; */ @@ -108,7 +143,16 @@ class PublicDelegatedPrefix extends \Google\Protobuf\Internal\Message */ protected $self_link = null; /** - * [Output Only] The status of the public delegated prefix, which can be one of following values: - `INITIALIZING` The public delegated prefix is being initialized and addresses cannot be created yet. - `READY_TO_ANNOUNCE` The public delegated prefix is a live migration prefix and is active. - `ANNOUNCED` The public delegated prefix is announced and ready to use. - `DELETING` The public delegated prefix is being deprovsioned. + * [Output Only] The status of the public delegated prefix, which can be one + * of following values: + * - `INITIALIZING` The public delegated prefix is being initialized and + * addresses cannot be created yet. + * - `READY_TO_ANNOUNCE` The public delegated prefix is a live migration + * prefix and is active. + * - `ANNOUNCED` The public delegated prefix is announced and ready to + * use. + * - `DELETING` The public delegated prefix is being deprovsioned. + * - `ACTIVE` The public delegated prefix is ready to use. * Check the Status enum for the list of possible values. * * Generated from protobuf field optional string status = 181260274; @@ -122,39 +166,75 @@ class PublicDelegatedPrefix extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type int $allocatable_prefix_length - * The allocatable prefix length supported by this public delegated prefix. This field is optional and cannot be set for prefixes in DELEGATION mode. It cannot be set for IPv4 prefixes either, and it always defaults to 32. + * The allocatable prefix length supported by this public delegated prefix. + * This field is optional and cannot be set for prefixes in DELEGATION mode. + * It cannot be set for IPv4 prefixes either, and it always defaults to 32. * @type string $byoip_api_version * [Output Only] The version of BYOIP API. * Check the ByoipApiVersion enum for the list of possible values. * @type string $creation_timestamp - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * @type string $description - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * @type string $fingerprint - * Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking. This field will be ignored when inserting a new PublicDelegatedPrefix. An up-to-date fingerprint must be provided in order to update the PublicDelegatedPrefix, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a PublicDelegatedPrefix. + * Fingerprint of this resource. A hash of the contents stored in this object. + * This field is used in optimistic locking. This field will be ignored when + * inserting a new PublicDelegatedPrefix. An up-to-date + * fingerprint must be provided in order to update thePublicDelegatedPrefix, otherwise the request will fail with + * error 412 conditionNotMet. + * To see the latest fingerprint, make a get() request to + * retrieve a PublicDelegatedPrefix. * @type int|string $id - * [Output Only] The unique identifier for the resource type. The server generates this identifier. + * [Output Only] The unique identifier for the resource type. The server + * generates this identifier. * @type string $ip_cidr_range - * The IP address range, in CIDR format, represented by this public delegated prefix. + * The IP address range, in CIDR format, represented by this public + * delegated prefix. + * @type string $ipv6_access_type + * [Output Only] The internet access type for IPv6 Public Delegated Prefixes. + * Inherited from parent prefix. + * Check the Ipv6AccessType enum for the list of possible values. * @type bool $is_live_migration * If true, the prefix will be live migrated. * @type string $kind - * [Output Only] Type of the resource. Always compute#publicDelegatedPrefix for public delegated prefixes. + * [Output Only] Type of the resource. Alwayscompute#publicDelegatedPrefix for public delegated prefixes. * @type string $mode * The public delegated prefix mode for IPv6 only. * Check the Mode enum for the list of possible values. * @type string $name - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * @type string $parent_prefix - * The URL of parent prefix. Either PublicAdvertisedPrefix or PublicDelegatedPrefix. + * The URL of parent prefix. Either PublicAdvertisedPrefix or + * PublicDelegatedPrefix. * @type array<\Google\Cloud\Compute\V1\PublicDelegatedPrefixPublicDelegatedSubPrefix>|\Google\Protobuf\Internal\RepeatedField $public_delegated_sub_prefixs - * The list of sub public delegated prefixes that exist for this public delegated prefix. + * The list of sub public delegated prefixes that exist for this public + * delegated prefix. * @type string $region - * [Output Only] URL of the region where the public delegated prefix resides. This field applies only to the region resource. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * [Output Only] URL of the region where the public delegated prefix resides. + * This field applies only to the region resource. You must specify this + * field as part of the HTTP request URL. It is not settable as a field in + * the request body. * @type string $self_link * [Output Only] Server-defined URL for the resource. * @type string $status - * [Output Only] The status of the public delegated prefix, which can be one of following values: - `INITIALIZING` The public delegated prefix is being initialized and addresses cannot be created yet. - `READY_TO_ANNOUNCE` The public delegated prefix is a live migration prefix and is active. - `ANNOUNCED` The public delegated prefix is announced and ready to use. - `DELETING` The public delegated prefix is being deprovsioned. + * [Output Only] The status of the public delegated prefix, which can be one + * of following values: + * - `INITIALIZING` The public delegated prefix is being initialized and + * addresses cannot be created yet. + * - `READY_TO_ANNOUNCE` The public delegated prefix is a live migration + * prefix and is active. + * - `ANNOUNCED` The public delegated prefix is announced and ready to + * use. + * - `DELETING` The public delegated prefix is being deprovsioned. + * - `ACTIVE` The public delegated prefix is ready to use. * Check the Status enum for the list of possible values. * } */ @@ -164,7 +244,9 @@ public function __construct($data = NULL) { } /** - * The allocatable prefix length supported by this public delegated prefix. This field is optional and cannot be set for prefixes in DELEGATION mode. It cannot be set for IPv4 prefixes either, and it always defaults to 32. + * The allocatable prefix length supported by this public delegated prefix. + * This field is optional and cannot be set for prefixes in DELEGATION mode. + * It cannot be set for IPv4 prefixes either, and it always defaults to 32. * * Generated from protobuf field optional int32 allocatable_prefix_length = 38427446; * @return int @@ -185,7 +267,9 @@ public function clearAllocatablePrefixLength() } /** - * The allocatable prefix length supported by this public delegated prefix. This field is optional and cannot be set for prefixes in DELEGATION mode. It cannot be set for IPv4 prefixes either, and it always defaults to 32. + * The allocatable prefix length supported by this public delegated prefix. + * This field is optional and cannot be set for prefixes in DELEGATION mode. + * It cannot be set for IPv4 prefixes either, and it always defaults to 32. * * Generated from protobuf field optional int32 allocatable_prefix_length = 38427446; * @param int $var @@ -238,7 +322,8 @@ public function setByoipApiVersion($var) } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @return string @@ -259,7 +344,8 @@ public function clearCreationTimestamp() } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @param string $var @@ -274,7 +360,8 @@ public function setCreationTimestamp($var) } /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @return string @@ -295,7 +382,8 @@ public function clearDescription() } /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @param string $var @@ -310,7 +398,13 @@ public function setDescription($var) } /** - * Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking. This field will be ignored when inserting a new PublicDelegatedPrefix. An up-to-date fingerprint must be provided in order to update the PublicDelegatedPrefix, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a PublicDelegatedPrefix. + * Fingerprint of this resource. A hash of the contents stored in this object. + * This field is used in optimistic locking. This field will be ignored when + * inserting a new PublicDelegatedPrefix. An up-to-date + * fingerprint must be provided in order to update thePublicDelegatedPrefix, otherwise the request will fail with + * error 412 conditionNotMet. + * To see the latest fingerprint, make a get() request to + * retrieve a PublicDelegatedPrefix. * * Generated from protobuf field optional string fingerprint = 234678500; * @return string @@ -331,7 +425,13 @@ public function clearFingerprint() } /** - * Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking. This field will be ignored when inserting a new PublicDelegatedPrefix. An up-to-date fingerprint must be provided in order to update the PublicDelegatedPrefix, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a PublicDelegatedPrefix. + * Fingerprint of this resource. A hash of the contents stored in this object. + * This field is used in optimistic locking. This field will be ignored when + * inserting a new PublicDelegatedPrefix. An up-to-date + * fingerprint must be provided in order to update thePublicDelegatedPrefix, otherwise the request will fail with + * error 412 conditionNotMet. + * To see the latest fingerprint, make a get() request to + * retrieve a PublicDelegatedPrefix. * * Generated from protobuf field optional string fingerprint = 234678500; * @param string $var @@ -346,7 +446,8 @@ public function setFingerprint($var) } /** - * [Output Only] The unique identifier for the resource type. The server generates this identifier. + * [Output Only] The unique identifier for the resource type. The server + * generates this identifier. * * Generated from protobuf field optional uint64 id = 3355; * @return int|string @@ -367,7 +468,8 @@ public function clearId() } /** - * [Output Only] The unique identifier for the resource type. The server generates this identifier. + * [Output Only] The unique identifier for the resource type. The server + * generates this identifier. * * Generated from protobuf field optional uint64 id = 3355; * @param int|string $var @@ -382,7 +484,8 @@ public function setId($var) } /** - * The IP address range, in CIDR format, represented by this public delegated prefix. + * The IP address range, in CIDR format, represented by this public + * delegated prefix. * * Generated from protobuf field optional string ip_cidr_range = 98117322; * @return string @@ -403,7 +506,8 @@ public function clearIpCidrRange() } /** - * The IP address range, in CIDR format, represented by this public delegated prefix. + * The IP address range, in CIDR format, represented by this public + * delegated prefix. * * Generated from protobuf field optional string ip_cidr_range = 98117322; * @param string $var @@ -417,6 +521,46 @@ public function setIpCidrRange($var) return $this; } + /** + * [Output Only] The internet access type for IPv6 Public Delegated Prefixes. + * Inherited from parent prefix. + * Check the Ipv6AccessType enum for the list of possible values. + * + * Generated from protobuf field optional string ipv6_access_type = 504658653; + * @return string + */ + public function getIpv6AccessType() + { + return isset($this->ipv6_access_type) ? $this->ipv6_access_type : ''; + } + + public function hasIpv6AccessType() + { + return isset($this->ipv6_access_type); + } + + public function clearIpv6AccessType() + { + unset($this->ipv6_access_type); + } + + /** + * [Output Only] The internet access type for IPv6 Public Delegated Prefixes. + * Inherited from parent prefix. + * Check the Ipv6AccessType enum for the list of possible values. + * + * Generated from protobuf field optional string ipv6_access_type = 504658653; + * @param string $var + * @return $this + */ + public function setIpv6AccessType($var) + { + GPBUtil::checkString($var, True); + $this->ipv6_access_type = $var; + + return $this; + } + /** * If true, the prefix will be live migrated. * @@ -454,7 +598,7 @@ public function setIsLiveMigration($var) } /** - * [Output Only] Type of the resource. Always compute#publicDelegatedPrefix for public delegated prefixes. + * [Output Only] Type of the resource. Alwayscompute#publicDelegatedPrefix for public delegated prefixes. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -475,7 +619,7 @@ public function clearKind() } /** - * [Output Only] Type of the resource. Always compute#publicDelegatedPrefix for public delegated prefixes. + * [Output Only] Type of the resource. Alwayscompute#publicDelegatedPrefix for public delegated prefixes. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -528,7 +672,13 @@ public function setMode($var) } /** - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * * Generated from protobuf field optional string name = 3373707; * @return string @@ -549,7 +699,13 @@ public function clearName() } /** - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * * Generated from protobuf field optional string name = 3373707; * @param string $var @@ -564,7 +720,8 @@ public function setName($var) } /** - * The URL of parent prefix. Either PublicAdvertisedPrefix or PublicDelegatedPrefix. + * The URL of parent prefix. Either PublicAdvertisedPrefix or + * PublicDelegatedPrefix. * * Generated from protobuf field optional string parent_prefix = 15233991; * @return string @@ -585,7 +742,8 @@ public function clearParentPrefix() } /** - * The URL of parent prefix. Either PublicAdvertisedPrefix or PublicDelegatedPrefix. + * The URL of parent prefix. Either PublicAdvertisedPrefix or + * PublicDelegatedPrefix. * * Generated from protobuf field optional string parent_prefix = 15233991; * @param string $var @@ -600,7 +758,8 @@ public function setParentPrefix($var) } /** - * The list of sub public delegated prefixes that exist for this public delegated prefix. + * The list of sub public delegated prefixes that exist for this public + * delegated prefix. * * Generated from protobuf field repeated .google.cloud.compute.v1.PublicDelegatedPrefixPublicDelegatedSubPrefix public_delegated_sub_prefixs = 188940044; * @return \Google\Protobuf\Internal\RepeatedField @@ -611,7 +770,8 @@ public function getPublicDelegatedSubPrefixs() } /** - * The list of sub public delegated prefixes that exist for this public delegated prefix. + * The list of sub public delegated prefixes that exist for this public + * delegated prefix. * * Generated from protobuf field repeated .google.cloud.compute.v1.PublicDelegatedPrefixPublicDelegatedSubPrefix public_delegated_sub_prefixs = 188940044; * @param array<\Google\Cloud\Compute\V1\PublicDelegatedPrefixPublicDelegatedSubPrefix>|\Google\Protobuf\Internal\RepeatedField $var @@ -626,7 +786,10 @@ public function setPublicDelegatedSubPrefixs($var) } /** - * [Output Only] URL of the region where the public delegated prefix resides. This field applies only to the region resource. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * [Output Only] URL of the region where the public delegated prefix resides. + * This field applies only to the region resource. You must specify this + * field as part of the HTTP request URL. It is not settable as a field in + * the request body. * * Generated from protobuf field optional string region = 138946292; * @return string @@ -647,7 +810,10 @@ public function clearRegion() } /** - * [Output Only] URL of the region where the public delegated prefix resides. This field applies only to the region resource. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * [Output Only] URL of the region where the public delegated prefix resides. + * This field applies only to the region resource. You must specify this + * field as part of the HTTP request URL. It is not settable as a field in + * the request body. * * Generated from protobuf field optional string region = 138946292; * @param string $var @@ -698,7 +864,16 @@ public function setSelfLink($var) } /** - * [Output Only] The status of the public delegated prefix, which can be one of following values: - `INITIALIZING` The public delegated prefix is being initialized and addresses cannot be created yet. - `READY_TO_ANNOUNCE` The public delegated prefix is a live migration prefix and is active. - `ANNOUNCED` The public delegated prefix is announced and ready to use. - `DELETING` The public delegated prefix is being deprovsioned. + * [Output Only] The status of the public delegated prefix, which can be one + * of following values: + * - `INITIALIZING` The public delegated prefix is being initialized and + * addresses cannot be created yet. + * - `READY_TO_ANNOUNCE` The public delegated prefix is a live migration + * prefix and is active. + * - `ANNOUNCED` The public delegated prefix is announced and ready to + * use. + * - `DELETING` The public delegated prefix is being deprovsioned. + * - `ACTIVE` The public delegated prefix is ready to use. * Check the Status enum for the list of possible values. * * Generated from protobuf field optional string status = 181260274; @@ -720,7 +895,16 @@ public function clearStatus() } /** - * [Output Only] The status of the public delegated prefix, which can be one of following values: - `INITIALIZING` The public delegated prefix is being initialized and addresses cannot be created yet. - `READY_TO_ANNOUNCE` The public delegated prefix is a live migration prefix and is active. - `ANNOUNCED` The public delegated prefix is announced and ready to use. - `DELETING` The public delegated prefix is being deprovsioned. + * [Output Only] The status of the public delegated prefix, which can be one + * of following values: + * - `INITIALIZING` The public delegated prefix is being initialized and + * addresses cannot be created yet. + * - `READY_TO_ANNOUNCE` The public delegated prefix is a live migration + * prefix and is active. + * - `ANNOUNCED` The public delegated prefix is announced and ready to + * use. + * - `DELETING` The public delegated prefix is being deprovsioned. + * - `ACTIVE` The public delegated prefix is ready to use. * Check the Status enum for the list of possible values. * * Generated from protobuf field optional string status = 181260274; diff --git a/Compute/src/V1/PublicDelegatedPrefix/ByoipApiVersion.php b/Compute/src/V1/PublicDelegatedPrefix/ByoipApiVersion.php index 5f0e6f913154..9470d1b65485 100644 --- a/Compute/src/V1/PublicDelegatedPrefix/ByoipApiVersion.php +++ b/Compute/src/V1/PublicDelegatedPrefix/ByoipApiVersion.php @@ -20,13 +20,16 @@ class ByoipApiVersion */ const UNDEFINED_BYOIP_API_VERSION = 0; /** - * This public delegated prefix usually takes 4 weeks to delete, and the BGP status cannot be changed. Announce and Withdraw APIs can not be used on this prefix. + * This public delegated prefix usually takes 4 weeks to delete, and the BGP + * status cannot be changed. Announce and Withdraw APIs can not be used on + * this prefix. * * Generated from protobuf enum V1 = 2715; */ const V1 = 2715; /** - * This public delegated prefix takes minutes to delete. Announce and Withdraw APIs can be used on this prefix to change the BGP status. + * This public delegated prefix takes minutes to delete. Announce and + * Withdraw APIs can be used on this prefix to change the BGP status. * * Generated from protobuf enum V2 = 2716; */ diff --git a/Compute/src/V1/PublicDelegatedPrefix/Ipv6AccessType.php b/Compute/src/V1/PublicDelegatedPrefix/Ipv6AccessType.php new file mode 100644 index 000000000000..9a9d09c4e1a3 --- /dev/null +++ b/Compute/src/V1/PublicDelegatedPrefix/Ipv6AccessType.php @@ -0,0 +1,67 @@ +google.cloud.compute.v1.PublicDelegatedPrefix.Ipv6AccessType + */ +class Ipv6AccessType +{ + /** + * A value indicating that the enum field is not set. + * + * Generated from protobuf enum UNDEFINED_IPV6_ACCESS_TYPE = 0; + */ + const UNDEFINED_IPV6_ACCESS_TYPE = 0; + /** + * The parent public advertised prefix will be announced to the internet. + * All children public delegated prefixes will have IPv6 access type as + * EXTERNAL. + * + * Generated from protobuf enum EXTERNAL = 35607499; + */ + const EXTERNAL = 35607499; + /** + * The parent public advertised prefix will not be announced to the + * internet. Prefix will be used privately within Cloud. All children + * public delegated prefixes will have IPv6 access type as INTERNAL. + * + * Generated from protobuf enum INTERNAL = 279295677; + */ + const INTERNAL = 279295677; + + private static $valueToName = [ + self::UNDEFINED_IPV6_ACCESS_TYPE => 'UNDEFINED_IPV6_ACCESS_TYPE', + self::EXTERNAL => 'EXTERNAL', + self::INTERNAL => 'INTERNAL', + ]; + + public static function name($value) + { + if (!isset(self::$valueToName[$value])) { + throw new UnexpectedValueException(sprintf( + 'Enum %s has no name defined for value %s', __CLASS__, $value)); + } + return self::$valueToName[$value]; + } + + + public static function value($name) + { + $const = __CLASS__ . '::' . strtoupper($name); + if (!defined($const)) { + throw new UnexpectedValueException(sprintf( + 'Enum %s has no value defined for name %s', __CLASS__, $name)); + } + return constant($const); + } +} + + diff --git a/Compute/src/V1/PublicDelegatedPrefix/Mode.php b/Compute/src/V1/PublicDelegatedPrefix/Mode.php index 2dda460d884f..7ccc299f3c7d 100644 --- a/Compute/src/V1/PublicDelegatedPrefix/Mode.php +++ b/Compute/src/V1/PublicDelegatedPrefix/Mode.php @@ -20,29 +20,44 @@ class Mode */ const UNDEFINED_MODE = 0; /** - * The public delegated prefix is used for further sub-delegation only. Such prefixes cannot set allocatablePrefixLength. + * The public delegated prefix is used for further sub-delegation only. Such + * prefixes cannot set allocatablePrefixLength. * * Generated from protobuf enum DELEGATION = 264149288; */ const DELEGATION = 264149288; /** - * The public delegated prefix is used for creating forwarding rules only. Such prefixes cannot set publicDelegatedSubPrefixes. + * The public delegated prefix is used for creating forwarding rules only. + * Such prefixes cannot set publicDelegatedSubPrefixes. Parent public + * delegated prefix must have IPv6 access type as EXTERNAL. * * Generated from protobuf enum EXTERNAL_IPV6_FORWARDING_RULE_CREATION = 398684356; */ const EXTERNAL_IPV6_FORWARDING_RULE_CREATION = 398684356; /** - * The public delegated prefix is used for creating dual-mode subnetworks only. Such prefixes cannot set publicDelegatedSubPrefixes. + * The public delegated prefix is used for creating dual-mode subnetworks + * only. Such prefixes cannot set publicDelegatedSubPrefixes. Parent public + * delegated prefix must have IPv6 access type as EXTERNAL. * * Generated from protobuf enum EXTERNAL_IPV6_SUBNETWORK_CREATION = 61198284; */ const EXTERNAL_IPV6_SUBNETWORK_CREATION = 61198284; + /** + * The public delegated prefix is used for creating dual stack or IPv6-only + * subnetwork with internal access only. Such prefixes cannot set + * publicDelegatedSubPrefixes and allocatablePrefixLength. Parent public + * delegated prefix must have IPv6 access type as INTERNAL. + * + * Generated from protobuf enum INTERNAL_IPV6_SUBNETWORK_CREATION = 153239834; + */ + const INTERNAL_IPV6_SUBNETWORK_CREATION = 153239834; private static $valueToName = [ self::UNDEFINED_MODE => 'UNDEFINED_MODE', self::DELEGATION => 'DELEGATION', self::EXTERNAL_IPV6_FORWARDING_RULE_CREATION => 'EXTERNAL_IPV6_FORWARDING_RULE_CREATION', self::EXTERNAL_IPV6_SUBNETWORK_CREATION => 'EXTERNAL_IPV6_SUBNETWORK_CREATION', + self::INTERNAL_IPV6_SUBNETWORK_CREATION => 'INTERNAL_IPV6_SUBNETWORK_CREATION', ]; public static function name($value) diff --git a/Compute/src/V1/PublicDelegatedPrefix/Status.php b/Compute/src/V1/PublicDelegatedPrefix/Status.php index e4f1c7d80345..b942c8168142 100644 --- a/Compute/src/V1/PublicDelegatedPrefix/Status.php +++ b/Compute/src/V1/PublicDelegatedPrefix/Status.php @@ -7,7 +7,16 @@ use UnexpectedValueException; /** - * [Output Only] The status of the public delegated prefix, which can be one of following values: - `INITIALIZING` The public delegated prefix is being initialized and addresses cannot be created yet. - `READY_TO_ANNOUNCE` The public delegated prefix is a live migration prefix and is active. - `ANNOUNCED` The public delegated prefix is announced and ready to use. - `DELETING` The public delegated prefix is being deprovsioned. + * [Output Only] The status of the public delegated prefix, which can be one + * of following values: + * - `INITIALIZING` The public delegated prefix is being initialized and + * addresses cannot be created yet. + * - `READY_TO_ANNOUNCE` The public delegated prefix is a live migration + * prefix and is active. + * - `ANNOUNCED` The public delegated prefix is announced and ready to + * use. + * - `DELETING` The public delegated prefix is being deprovsioned. + * - `ACTIVE` The public delegated prefix is ready to use. * * Protobuf type google.cloud.compute.v1.PublicDelegatedPrefix.Status */ @@ -19,6 +28,12 @@ class Status * Generated from protobuf enum UNDEFINED_STATUS = 0; */ const UNDEFINED_STATUS = 0; + /** + * The public delegated prefix is ready to use. + * + * Generated from protobuf enum ACTIVE = 314733318; + */ + const ACTIVE = 314733318; /** * The public delegated prefix is announced and ready to use. * @@ -44,13 +59,15 @@ class Status */ const DELETING = 528602024; /** - * The public delegated prefix is being initialized and addresses cannot be created yet. + * The public delegated prefix is being initialized and addresses cannot be + * created yet. * * Generated from protobuf enum INITIALIZING = 306588749; */ const INITIALIZING = 306588749; /** - * The public delegated prefix is currently withdrawn but ready to be announced. + * The public delegated prefix is currently withdrawn but ready to be + * announced. * * Generated from protobuf enum READY_TO_ANNOUNCE = 64641265; */ @@ -58,6 +75,7 @@ class Status private static $valueToName = [ self::UNDEFINED_STATUS => 'UNDEFINED_STATUS', + self::ACTIVE => 'ACTIVE', self::ANNOUNCED => 'ANNOUNCED', self::ANNOUNCED_TO_GOOGLE => 'ANNOUNCED_TO_GOOGLE', self::ANNOUNCED_TO_INTERNET => 'ANNOUNCED_TO_INTERNET', diff --git a/Compute/src/V1/PublicDelegatedPrefixAggregatedList.php b/Compute/src/V1/PublicDelegatedPrefixAggregatedList.php index c6d5cc05bc1b..9c5b276bcd96 100644 --- a/Compute/src/V1/PublicDelegatedPrefixAggregatedList.php +++ b/Compute/src/V1/PublicDelegatedPrefixAggregatedList.php @@ -27,13 +27,18 @@ class PublicDelegatedPrefixAggregatedList extends \Google\Protobuf\Internal\Mess */ private $items; /** - * [Output Only] Type of the resource. Always compute#publicDelegatedPrefixAggregatedList for aggregated lists of public delegated prefixes. + * [Output Only] Type of the resource. Alwayscompute#publicDelegatedPrefixAggregatedList for aggregated + * lists of public delegated prefixes. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -68,9 +73,14 @@ class PublicDelegatedPrefixAggregatedList extends \Google\Protobuf\Internal\Mess * @type array|\Google\Protobuf\Internal\MapField $items * A list of PublicDelegatedPrefixesScopedList resources. * @type string $kind - * [Output Only] Type of the resource. Always compute#publicDelegatedPrefixAggregatedList for aggregated lists of public delegated prefixes. + * [Output Only] Type of the resource. Alwayscompute#publicDelegatedPrefixAggregatedList for aggregated + * lists of public delegated prefixes. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type array|\Google\Protobuf\Internal\RepeatedField $unreachables @@ -147,7 +157,8 @@ public function setItems($var) } /** - * [Output Only] Type of the resource. Always compute#publicDelegatedPrefixAggregatedList for aggregated lists of public delegated prefixes. + * [Output Only] Type of the resource. Alwayscompute#publicDelegatedPrefixAggregatedList for aggregated + * lists of public delegated prefixes. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -168,7 +179,8 @@ public function clearKind() } /** - * [Output Only] Type of the resource. Always compute#publicDelegatedPrefixAggregatedList for aggregated lists of public delegated prefixes. + * [Output Only] Type of the resource. Alwayscompute#publicDelegatedPrefixAggregatedList for aggregated + * lists of public delegated prefixes. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -183,7 +195,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -204,7 +220,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/PublicDelegatedPrefixList.php b/Compute/src/V1/PublicDelegatedPrefixList.php index 552872b69308..142dd3c548f6 100644 --- a/Compute/src/V1/PublicDelegatedPrefixList.php +++ b/Compute/src/V1/PublicDelegatedPrefixList.php @@ -27,13 +27,18 @@ class PublicDelegatedPrefixList extends \Google\Protobuf\Internal\Message */ private $items; /** - * [Output Only] Type of the resource. Always compute#publicDelegatedPrefixList for public delegated prefixes. + * [Output Only] Type of the resource. Alwayscompute#publicDelegatedPrefixList for public delegated + * prefixes. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -62,9 +67,14 @@ class PublicDelegatedPrefixList extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\PublicDelegatedPrefix>|\Google\Protobuf\Internal\RepeatedField $items * A list of PublicDelegatedPrefix resources. * @type string $kind - * [Output Only] Type of the resource. Always compute#publicDelegatedPrefixList for public delegated prefixes. + * [Output Only] Type of the resource. Alwayscompute#publicDelegatedPrefixList for public delegated + * prefixes. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type \Google\Cloud\Compute\V1\Warning $warning @@ -139,7 +149,8 @@ public function setItems($var) } /** - * [Output Only] Type of the resource. Always compute#publicDelegatedPrefixList for public delegated prefixes. + * [Output Only] Type of the resource. Alwayscompute#publicDelegatedPrefixList for public delegated + * prefixes. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -160,7 +171,8 @@ public function clearKind() } /** - * [Output Only] Type of the resource. Always compute#publicDelegatedPrefixList for public delegated prefixes. + * [Output Only] Type of the resource. Alwayscompute#publicDelegatedPrefixList for public delegated + * prefixes. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -175,7 +187,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -196,7 +212,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/PublicDelegatedPrefixPublicDelegatedSubPrefix.php b/Compute/src/V1/PublicDelegatedPrefixPublicDelegatedSubPrefix.php index 8f930c25c806..2f5cbf21bc1e 100644 --- a/Compute/src/V1/PublicDelegatedPrefixPublicDelegatedSubPrefix.php +++ b/Compute/src/V1/PublicDelegatedPrefixPublicDelegatedSubPrefix.php @@ -28,19 +28,30 @@ class PublicDelegatedPrefixPublicDelegatedSubPrefix extends \Google\Protobuf\Int */ protected $delegatee_project = null; /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; */ protected $description = null; /** - * The IP address range, in CIDR format, represented by this sub public delegated prefix. + * The IP address range, in CIDR format, represented by this sub public + * delegated prefix. * * Generated from protobuf field optional string ip_cidr_range = 98117322; */ protected $ip_cidr_range = null; /** - * Whether the sub prefix is delegated to create Address resources in the delegatee project. + * [Output Only] The internet access type for IPv6 Public Delegated Sub + * Prefixes. Inherited from parent prefix. + * Check the Ipv6AccessType enum for the list of possible values. + * + * Generated from protobuf field optional string ipv6_access_type = 504658653; + */ + protected $ipv6_access_type = null; + /** + * Whether the sub prefix is delegated to create Address resources in the + * delegatee project. * * Generated from protobuf field optional bool is_address = 352617951; */ @@ -59,7 +70,8 @@ class PublicDelegatedPrefixPublicDelegatedSubPrefix extends \Google\Protobuf\Int */ protected $name = null; /** - * [Output Only] The region of the sub public delegated prefix if it is regional. If absent, the sub prefix is global. + * [Output Only] The region of the sub public delegated prefix if it is + * regional. If absent, the sub prefix is global. * * Generated from protobuf field optional string region = 138946292; */ @@ -83,18 +95,26 @@ class PublicDelegatedPrefixPublicDelegatedSubPrefix extends \Google\Protobuf\Int * @type string $delegatee_project * Name of the project scoping this PublicDelegatedSubPrefix. * @type string $description - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * @type string $ip_cidr_range - * The IP address range, in CIDR format, represented by this sub public delegated prefix. + * The IP address range, in CIDR format, represented by this sub public + * delegated prefix. + * @type string $ipv6_access_type + * [Output Only] The internet access type for IPv6 Public Delegated Sub + * Prefixes. Inherited from parent prefix. + * Check the Ipv6AccessType enum for the list of possible values. * @type bool $is_address - * Whether the sub prefix is delegated to create Address resources in the delegatee project. + * Whether the sub prefix is delegated to create Address resources in the + * delegatee project. * @type string $mode * The PublicDelegatedSubPrefix mode for IPv6 only. * Check the Mode enum for the list of possible values. * @type string $name * The name of the sub public delegated prefix. * @type string $region - * [Output Only] The region of the sub public delegated prefix if it is regional. If absent, the sub prefix is global. + * [Output Only] The region of the sub public delegated prefix if it is + * regional. If absent, the sub prefix is global. * @type string $status * [Output Only] The status of the sub public delegated prefix. * Check the Status enum for the list of possible values. @@ -178,7 +198,8 @@ public function setDelegateeProject($var) } /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @return string @@ -199,7 +220,8 @@ public function clearDescription() } /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @param string $var @@ -214,7 +236,8 @@ public function setDescription($var) } /** - * The IP address range, in CIDR format, represented by this sub public delegated prefix. + * The IP address range, in CIDR format, represented by this sub public + * delegated prefix. * * Generated from protobuf field optional string ip_cidr_range = 98117322; * @return string @@ -235,7 +258,8 @@ public function clearIpCidrRange() } /** - * The IP address range, in CIDR format, represented by this sub public delegated prefix. + * The IP address range, in CIDR format, represented by this sub public + * delegated prefix. * * Generated from protobuf field optional string ip_cidr_range = 98117322; * @param string $var @@ -250,7 +274,48 @@ public function setIpCidrRange($var) } /** - * Whether the sub prefix is delegated to create Address resources in the delegatee project. + * [Output Only] The internet access type for IPv6 Public Delegated Sub + * Prefixes. Inherited from parent prefix. + * Check the Ipv6AccessType enum for the list of possible values. + * + * Generated from protobuf field optional string ipv6_access_type = 504658653; + * @return string + */ + public function getIpv6AccessType() + { + return isset($this->ipv6_access_type) ? $this->ipv6_access_type : ''; + } + + public function hasIpv6AccessType() + { + return isset($this->ipv6_access_type); + } + + public function clearIpv6AccessType() + { + unset($this->ipv6_access_type); + } + + /** + * [Output Only] The internet access type for IPv6 Public Delegated Sub + * Prefixes. Inherited from parent prefix. + * Check the Ipv6AccessType enum for the list of possible values. + * + * Generated from protobuf field optional string ipv6_access_type = 504658653; + * @param string $var + * @return $this + */ + public function setIpv6AccessType($var) + { + GPBUtil::checkString($var, True); + $this->ipv6_access_type = $var; + + return $this; + } + + /** + * Whether the sub prefix is delegated to create Address resources in the + * delegatee project. * * Generated from protobuf field optional bool is_address = 352617951; * @return bool @@ -271,7 +336,8 @@ public function clearIsAddress() } /** - * Whether the sub prefix is delegated to create Address resources in the delegatee project. + * Whether the sub prefix is delegated to create Address resources in the + * delegatee project. * * Generated from protobuf field optional bool is_address = 352617951; * @param bool $var @@ -360,7 +426,8 @@ public function setName($var) } /** - * [Output Only] The region of the sub public delegated prefix if it is regional. If absent, the sub prefix is global. + * [Output Only] The region of the sub public delegated prefix if it is + * regional. If absent, the sub prefix is global. * * Generated from protobuf field optional string region = 138946292; * @return string @@ -381,7 +448,8 @@ public function clearRegion() } /** - * [Output Only] The region of the sub public delegated prefix if it is regional. If absent, the sub prefix is global. + * [Output Only] The region of the sub public delegated prefix if it is + * regional. If absent, the sub prefix is global. * * Generated from protobuf field optional string region = 138946292; * @param string $var diff --git a/Compute/src/V1/PublicDelegatedPrefixPublicDelegatedSubPrefix/Ipv6AccessType.php b/Compute/src/V1/PublicDelegatedPrefixPublicDelegatedSubPrefix/Ipv6AccessType.php new file mode 100644 index 000000000000..2947e6827877 --- /dev/null +++ b/Compute/src/V1/PublicDelegatedPrefixPublicDelegatedSubPrefix/Ipv6AccessType.php @@ -0,0 +1,67 @@ +google.cloud.compute.v1.PublicDelegatedPrefixPublicDelegatedSubPrefix.Ipv6AccessType + */ +class Ipv6AccessType +{ + /** + * A value indicating that the enum field is not set. + * + * Generated from protobuf enum UNDEFINED_IPV6_ACCESS_TYPE = 0; + */ + const UNDEFINED_IPV6_ACCESS_TYPE = 0; + /** + * The parent public advertised prefix will be announced to the internet. + * All children public delegated prefixes will have IPv6 access type as + * EXTERNAL. + * + * Generated from protobuf enum EXTERNAL = 35607499; + */ + const EXTERNAL = 35607499; + /** + * The parent public advertised prefix will not be announced to the + * internet. Prefix will be used privately within Cloud. All children + * public delegated prefixes will have IPv6 access type as INTERNAL. + * + * Generated from protobuf enum INTERNAL = 279295677; + */ + const INTERNAL = 279295677; + + private static $valueToName = [ + self::UNDEFINED_IPV6_ACCESS_TYPE => 'UNDEFINED_IPV6_ACCESS_TYPE', + self::EXTERNAL => 'EXTERNAL', + self::INTERNAL => 'INTERNAL', + ]; + + public static function name($value) + { + if (!isset(self::$valueToName[$value])) { + throw new UnexpectedValueException(sprintf( + 'Enum %s has no name defined for value %s', __CLASS__, $value)); + } + return self::$valueToName[$value]; + } + + + public static function value($name) + { + $const = __CLASS__ . '::' . strtoupper($name); + if (!defined($const)) { + throw new UnexpectedValueException(sprintf( + 'Enum %s has no value defined for name %s', __CLASS__, $name)); + } + return constant($const); + } +} + + diff --git a/Compute/src/V1/PublicDelegatedPrefixPublicDelegatedSubPrefix/Mode.php b/Compute/src/V1/PublicDelegatedPrefixPublicDelegatedSubPrefix/Mode.php index a801394b6a17..23052da7a535 100644 --- a/Compute/src/V1/PublicDelegatedPrefixPublicDelegatedSubPrefix/Mode.php +++ b/Compute/src/V1/PublicDelegatedPrefixPublicDelegatedSubPrefix/Mode.php @@ -20,29 +20,44 @@ class Mode */ const UNDEFINED_MODE = 0; /** - * The public delegated prefix is used for further sub-delegation only. Such prefixes cannot set allocatablePrefixLength. + * The public delegated prefix is used for further sub-delegation only. Such + * prefixes cannot set allocatablePrefixLength. * * Generated from protobuf enum DELEGATION = 264149288; */ const DELEGATION = 264149288; /** - * The public delegated prefix is used for creating forwarding rules only. Such prefixes cannot set publicDelegatedSubPrefixes. + * The public delegated prefix is used for creating forwarding rules only. + * Such prefixes cannot set publicDelegatedSubPrefixes. Parent public + * delegated prefix must have IPv6 access type as EXTERNAL. * * Generated from protobuf enum EXTERNAL_IPV6_FORWARDING_RULE_CREATION = 398684356; */ const EXTERNAL_IPV6_FORWARDING_RULE_CREATION = 398684356; /** - * The public delegated prefix is used for creating dual-mode subnetworks only. Such prefixes cannot set publicDelegatedSubPrefixes. + * The public delegated prefix is used for creating dual-mode subnetworks + * only. Such prefixes cannot set publicDelegatedSubPrefixes. Parent public + * delegated prefix must have IPv6 access type as EXTERNAL. * * Generated from protobuf enum EXTERNAL_IPV6_SUBNETWORK_CREATION = 61198284; */ const EXTERNAL_IPV6_SUBNETWORK_CREATION = 61198284; + /** + * The public delegated prefix is used for creating dual stack or IPv6-only + * subnetwork with internal access only. Such prefixes cannot set + * publicDelegatedSubPrefixes and allocatablePrefixLength. Parent public + * delegated prefix must have IPv6 access type as INTERNAL. + * + * Generated from protobuf enum INTERNAL_IPV6_SUBNETWORK_CREATION = 153239834; + */ + const INTERNAL_IPV6_SUBNETWORK_CREATION = 153239834; private static $valueToName = [ self::UNDEFINED_MODE => 'UNDEFINED_MODE', self::DELEGATION => 'DELEGATION', self::EXTERNAL_IPV6_FORWARDING_RULE_CREATION => 'EXTERNAL_IPV6_FORWARDING_RULE_CREATION', self::EXTERNAL_IPV6_SUBNETWORK_CREATION => 'EXTERNAL_IPV6_SUBNETWORK_CREATION', + self::INTERNAL_IPV6_SUBNETWORK_CREATION => 'INTERNAL_IPV6_SUBNETWORK_CREATION', ]; public static function name($value) diff --git a/Compute/src/V1/PublicDelegatedPrefixesScopedList.php b/Compute/src/V1/PublicDelegatedPrefixesScopedList.php index afea79b56c0d..280ebeedf048 100644 --- a/Compute/src/V1/PublicDelegatedPrefixesScopedList.php +++ b/Compute/src/V1/PublicDelegatedPrefixesScopedList.php @@ -21,7 +21,8 @@ class PublicDelegatedPrefixesScopedList extends \Google\Protobuf\Internal\Messag */ private $public_delegated_prefixes; /** - * [Output Only] Informational warning which replaces the list of public delegated prefixes when the list is empty. + * [Output Only] Informational warning which replaces the list of + * public delegated prefixes when the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; */ @@ -36,7 +37,8 @@ class PublicDelegatedPrefixesScopedList extends \Google\Protobuf\Internal\Messag * @type array<\Google\Cloud\Compute\V1\PublicDelegatedPrefix>|\Google\Protobuf\Internal\RepeatedField $public_delegated_prefixes * [Output Only] A list of PublicDelegatedPrefixes contained in this scope. * @type \Google\Cloud\Compute\V1\Warning $warning - * [Output Only] Informational warning which replaces the list of public delegated prefixes when the list is empty. + * [Output Only] Informational warning which replaces the list of + * public delegated prefixes when the list is empty. * } */ public function __construct($data = NULL) { @@ -71,7 +73,8 @@ public function setPublicDelegatedPrefixes($var) } /** - * [Output Only] Informational warning which replaces the list of public delegated prefixes when the list is empty. + * [Output Only] Informational warning which replaces the list of + * public delegated prefixes when the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; * @return \Google\Cloud\Compute\V1\Warning|null @@ -92,7 +95,8 @@ public function clearWarning() } /** - * [Output Only] Informational warning which replaces the list of public delegated prefixes when the list is empty. + * [Output Only] Informational warning which replaces the list of + * public delegated prefixes when the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; * @param \Google\Cloud\Compute\V1\Warning $var diff --git a/Compute/src/V1/Quota.php b/Compute/src/V1/Quota.php index 0d72201cecde..f0e3992437b1 100644 --- a/Compute/src/V1/Quota.php +++ b/Compute/src/V1/Quota.php @@ -29,7 +29,8 @@ class Quota extends \Google\Protobuf\Internal\Message */ protected $metric = null; /** - * [Output Only] Owning resource. This is the resource on which this quota is applied. + * [Output Only] Owning resource. This is the resource on which this quota + * is applied. * * Generated from protobuf field optional string owner = 106164915; */ @@ -53,7 +54,8 @@ class Quota extends \Google\Protobuf\Internal\Message * [Output Only] Name of the quota metric. * Check the Metric enum for the list of possible values. * @type string $owner - * [Output Only] Owning resource. This is the resource on which this quota is applied. + * [Output Only] Owning resource. This is the resource on which this quota + * is applied. * @type float $usage * [Output Only] Current usage of this metric. * } @@ -138,7 +140,8 @@ public function setMetric($var) } /** - * [Output Only] Owning resource. This is the resource on which this quota is applied. + * [Output Only] Owning resource. This is the resource on which this quota + * is applied. * * Generated from protobuf field optional string owner = 106164915; * @return string @@ -159,7 +162,8 @@ public function clearOwner() } /** - * [Output Only] Owning resource. This is the resource on which this quota is applied. + * [Output Only] Owning resource. This is the resource on which this quota + * is applied. * * Generated from protobuf field optional string owner = 106164915; * @param string $var diff --git a/Compute/src/V1/QuotaExceededInfo.php b/Compute/src/V1/QuotaExceededInfo.php index 874d78e3202a..5e3bacfe6bd0 100644 --- a/Compute/src/V1/QuotaExceededInfo.php +++ b/Compute/src/V1/QuotaExceededInfo.php @@ -22,13 +22,15 @@ class QuotaExceededInfo extends \Google\Protobuf\Internal\Message */ private $dimensions; /** - * Future quota limit being rolled out. The limit's unit depends on the quota type or metric. + * Future quota limit being rolled out. The limit's unit depends on the quota + * type or metric. * * Generated from protobuf field optional double future_limit = 456564287; */ protected $future_limit = null; /** - * Current effective quota limit. The limit's unit depends on the quota type or metric. + * Current effective quota limit. The limit's unit depends on the quota type + * or metric. * * Generated from protobuf field optional double limit = 102976443; */ @@ -62,9 +64,11 @@ class QuotaExceededInfo extends \Google\Protobuf\Internal\Message * @type array|\Google\Protobuf\Internal\MapField $dimensions * The map holding related quota dimensions. * @type float $future_limit - * Future quota limit being rolled out. The limit's unit depends on the quota type or metric. + * Future quota limit being rolled out. The limit's unit depends on the quota + * type or metric. * @type float $limit - * Current effective quota limit. The limit's unit depends on the quota type or metric. + * Current effective quota limit. The limit's unit depends on the quota type + * or metric. * @type string $limit_name * The name of the quota limit. * @type string $metric_name @@ -106,7 +110,8 @@ public function setDimensions($var) } /** - * Future quota limit being rolled out. The limit's unit depends on the quota type or metric. + * Future quota limit being rolled out. The limit's unit depends on the quota + * type or metric. * * Generated from protobuf field optional double future_limit = 456564287; * @return float @@ -127,7 +132,8 @@ public function clearFutureLimit() } /** - * Future quota limit being rolled out. The limit's unit depends on the quota type or metric. + * Future quota limit being rolled out. The limit's unit depends on the quota + * type or metric. * * Generated from protobuf field optional double future_limit = 456564287; * @param float $var @@ -142,7 +148,8 @@ public function setFutureLimit($var) } /** - * Current effective quota limit. The limit's unit depends on the quota type or metric. + * Current effective quota limit. The limit's unit depends on the quota type + * or metric. * * Generated from protobuf field optional double limit = 102976443; * @return float @@ -163,7 +170,8 @@ public function clearLimit() } /** - * Current effective quota limit. The limit's unit depends on the quota type or metric. + * Current effective quota limit. The limit's unit depends on the quota type + * or metric. * * Generated from protobuf field optional double limit = 102976443; * @param float $var diff --git a/Compute/src/V1/QuotaExceededInfo/RolloutStatus.php b/Compute/src/V1/QuotaExceededInfo/RolloutStatus.php index d8f7fa01bdf8..d15dd0d1fc19 100644 --- a/Compute/src/V1/QuotaExceededInfo/RolloutStatus.php +++ b/Compute/src/V1/QuotaExceededInfo/RolloutStatus.php @@ -20,13 +20,15 @@ class RolloutStatus */ const UNDEFINED_ROLLOUT_STATUS = 0; /** - * IN_PROGRESS - A rollout is in process which will change the limit value to future limit. + * IN_PROGRESS - A rollout is in process which will change the limit value + * to future limit. * * Generated from protobuf enum IN_PROGRESS = 469193735; */ const IN_PROGRESS = 469193735; /** - * ROLLOUT_STATUS_UNSPECIFIED - Rollout status is not specified. The default value. + * ROLLOUT_STATUS_UNSPECIFIED - Rollout status is not specified. The default + * value. * * Generated from protobuf enum ROLLOUT_STATUS_UNSPECIFIED = 26864568; */ diff --git a/Compute/src/V1/QuotaStatusWarning.php b/Compute/src/V1/QuotaStatusWarning.php index b81ed5ff0f6d..0e6c3c5f2b4b 100644 --- a/Compute/src/V1/QuotaStatusWarning.php +++ b/Compute/src/V1/QuotaStatusWarning.php @@ -9,21 +9,30 @@ use Google\Protobuf\Internal\GPBUtil; /** - * [Output Only] Warning of fetching the `quotas` field for this region. This field is populated only if fetching of the `quotas` field fails. + * [Output Only] Warning of fetching the `quotas` field for this region. This + * field is populated only if fetching of the `quotas` field fails. * * Generated from protobuf message google.cloud.compute.v1.QuotaStatusWarning */ class QuotaStatusWarning extends \Google\Protobuf\Internal\Message { /** - * [Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response. + * [Output Only] A warning code, if applicable. For example, Compute + * Engine returns NO_RESULTS_ON_PAGE if there + * are no results in the response. * Check the Code enum for the list of possible values. * * Generated from protobuf field optional string code = 3059181; */ protected $code = null; /** - * [Output Only] Metadata about this warning in key: value format. For example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + * [Output Only] Metadata about this warning in key: + * value format. For example: + * "data": [ + * { + * "key": "scope", + * "value": "zones/us-east1-d" + * } * * Generated from protobuf field repeated .google.cloud.compute.v1.Data data = 3076010; */ @@ -42,10 +51,18 @@ class QuotaStatusWarning extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $code - * [Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response. + * [Output Only] A warning code, if applicable. For example, Compute + * Engine returns NO_RESULTS_ON_PAGE if there + * are no results in the response. * Check the Code enum for the list of possible values. * @type array<\Google\Cloud\Compute\V1\Data>|\Google\Protobuf\Internal\RepeatedField $data - * [Output Only] Metadata about this warning in key: value format. For example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + * [Output Only] Metadata about this warning in key: + * value format. For example: + * "data": [ + * { + * "key": "scope", + * "value": "zones/us-east1-d" + * } * @type string $message * [Output Only] A human-readable description of the warning code. * } @@ -56,7 +73,9 @@ public function __construct($data = NULL) { } /** - * [Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response. + * [Output Only] A warning code, if applicable. For example, Compute + * Engine returns NO_RESULTS_ON_PAGE if there + * are no results in the response. * Check the Code enum for the list of possible values. * * Generated from protobuf field optional string code = 3059181; @@ -78,7 +97,9 @@ public function clearCode() } /** - * [Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response. + * [Output Only] A warning code, if applicable. For example, Compute + * Engine returns NO_RESULTS_ON_PAGE if there + * are no results in the response. * Check the Code enum for the list of possible values. * * Generated from protobuf field optional string code = 3059181; @@ -94,7 +115,13 @@ public function setCode($var) } /** - * [Output Only] Metadata about this warning in key: value format. For example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + * [Output Only] Metadata about this warning in key: + * value format. For example: + * "data": [ + * { + * "key": "scope", + * "value": "zones/us-east1-d" + * } * * Generated from protobuf field repeated .google.cloud.compute.v1.Data data = 3076010; * @return \Google\Protobuf\Internal\RepeatedField @@ -105,7 +132,13 @@ public function getData() } /** - * [Output Only] Metadata about this warning in key: value format. For example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + * [Output Only] Metadata about this warning in key: + * value format. For example: + * "data": [ + * { + * "key": "scope", + * "value": "zones/us-east1-d" + * } * * Generated from protobuf field repeated .google.cloud.compute.v1.Data data = 3076010; * @param array<\Google\Cloud\Compute\V1\Data>|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/QuotaStatusWarning/Code.php b/Compute/src/V1/QuotaStatusWarning/Code.php index 97e77e56ad21..93ec7b3e6531 100644 --- a/Compute/src/V1/QuotaStatusWarning/Code.php +++ b/Compute/src/V1/QuotaStatusWarning/Code.php @@ -7,7 +7,9 @@ use UnexpectedValueException; /** - * [Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response. + * [Output Only] A warning code, if applicable. For example, Compute + * Engine returns NO_RESULTS_ON_PAGE if there + * are no results in the response. * * Protobuf type google.cloud.compute.v1.QuotaStatusWarning.Code */ @@ -20,7 +22,8 @@ class Code */ const UNDEFINED_CODE = 0; /** - * Warning about failed cleanup of transient changes made by a failed operation. + * Warning about failed cleanup of transient changes made by a failed + * operation. * * Generated from protobuf enum CLEANUP_FAILED = 150308440; */ @@ -32,7 +35,8 @@ class Code */ const DEPRECATED_RESOURCE_USED = 391835586; /** - * When deploying and at least one of the resources has a type marked as deprecated + * When deploying and at least one of the resources has a type marked as + * deprecated * * Generated from protobuf enum DEPRECATED_TYPE_USED = 346526230; */ @@ -44,7 +48,8 @@ class Code */ const DISK_SIZE_LARGER_THAN_IMAGE_SIZE = 369442967; /** - * When deploying and at least one of the resources has a type marked as experimental + * When deploying and at least one of the resources has a type marked as + * experimental * * Generated from protobuf enum EXPERIMENTAL_TYPE_USED = 451954443; */ @@ -56,7 +61,8 @@ class Code */ const EXTERNAL_API_WARNING = 175546307; /** - * Warning that value of a field has been overridden. Deprecated unused field. + * Warning that value of a field has been overridden. + * Deprecated unused field. * * Generated from protobuf enum FIELD_VALUE_OVERRIDEN = 329669423; */ @@ -68,7 +74,8 @@ class Code */ const INJECTED_KERNELS_DEPRECATED = 417377419; /** - * A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2. + * A WEIGHTED_MAGLEV backend service is associated with a health check that is + * not of type HTTP/HTTPS/HTTP2. * * Generated from protobuf enum INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB = 401542606; */ @@ -80,7 +87,9 @@ class Code */ const LARGE_DEPLOYMENT_WARNING = 481440678; /** - * Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter. + * Resource can't be retrieved due to list overhead quota exceed + * which captures the amount of resources filtered out by + * user-defined list filter. * * Generated from protobuf enum LIST_OVERHEAD_QUOTA_EXCEED = 47618117; */ @@ -92,7 +101,8 @@ class Code */ const MISSING_TYPE_DEPENDENCY = 344505463; /** - * The route's nextHopIp address is not assigned to an instance on the network. + * The route's nextHopIp address is not assigned to an instance on the + * network. * * Generated from protobuf enum NEXT_HOP_ADDRESS_NOT_ASSIGNED = 324964999; */ @@ -104,7 +114,8 @@ class Code */ const NEXT_HOP_CANNOT_IP_FORWARD = 383382887; /** - * The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route. + * The route's nextHopInstance URL refers to an instance that does not have an + * ipv6 interface on the same network as the route. * * Generated from protobuf enum NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE = 146748434; */ @@ -116,7 +127,8 @@ class Code */ const NEXT_HOP_INSTANCE_NOT_FOUND = 464250446; /** - * The route's nextHopInstance URL refers to an instance that is not on the same network as the route. + * The route's nextHopInstance URL refers to an instance that is not on the + * same network as the route. * * Generated from protobuf enum NEXT_HOP_INSTANCE_NOT_ON_NETWORK = 243758146; */ @@ -128,7 +140,8 @@ class Code */ const NEXT_HOP_NOT_RUNNING = 417081265; /** - * Error which is not critical. We decided to continue the process despite the mentioned error. + * Error which is not critical. We decided to continue the process despite + * the mentioned error. * * Generated from protobuf enum NOT_CRITICAL_ERROR = 105763924; */ @@ -146,13 +159,15 @@ class Code */ const PARTIAL_SUCCESS = 39966469; /** - * Quota information is not available to client requests (e.g: regions.list). + * Quota information is not available to client requests (e.g: + * regions.list). * * Generated from protobuf enum QUOTA_INFO_UNAVAILABLE = 304294182; */ const QUOTA_INFO_UNAVAILABLE = 304294182; /** - * The user attempted to use a resource that requires a TOS they have not accepted. + * The user attempted to use a resource that requires a TOS they have not + * accepted. * * Generated from protobuf enum REQUIRED_TOS_AGREEMENT = 3745539; */ @@ -164,7 +179,8 @@ class Code */ const RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING = 496728641; /** - * One or more of the resources set to auto-delete could not be deleted because they were in use. + * One or more of the resources set to auto-delete could not be deleted + * because they were in use. * * Generated from protobuf enum RESOURCE_NOT_DELETED = 168598460; */ @@ -176,7 +192,9 @@ class Code */ const SCHEMA_VALIDATION_IGNORED = 275245642; /** - * Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group. + * Instance template used in instance group manager is valid as such, but + * its application does not make a lot of sense, because it allows only + * single instance in instance group. * * Generated from protobuf enum SINGLE_INSTANCE_PROPERTY_TEMPLATE = 268305617; */ diff --git a/Compute/src/V1/RawDisk.php b/Compute/src/V1/RawDisk.php index c06a523602f8..717fdd368494 100644 --- a/Compute/src/V1/RawDisk.php +++ b/Compute/src/V1/RawDisk.php @@ -16,20 +16,33 @@ class RawDisk extends \Google\Protobuf\Internal\Message { /** - * The format used to encode and transmit the block device, which should be TAR. This is just a container and transmission format and not a runtime format. Provided by the client when the disk image is created. + * The format used to encode and transmit the block device, which should beTAR. This is just a container and transmission format and not + * a runtime format. Provided by the client when the disk image is created. * Check the ContainerType enum for the list of possible values. * * Generated from protobuf field optional string container_type = 318809144; */ protected $container_type = null; /** - * [Deprecated] This field is deprecated. An optional SHA1 checksum of the disk image before unpackaging provided by the client when the disk image is created. + * [Deprecated] This field is deprecated. + * An optional SHA1 checksum of the disk image before unpackaging provided + * by the client when the disk image is created. * * Generated from protobuf field optional string sha1_checksum = 314444349; */ protected $sha1_checksum = null; /** - * The full Google Cloud Storage URL where the raw disk image archive is stored. The following are valid formats for the URL: - https://storage.googleapis.com/bucket_name/image_archive_name - https://storage.googleapis.com/bucket_name/folder_name/ image_archive_name In order to create an image, you must provide the full or partial URL of one of the following: - The rawDisk.source URL - The sourceDisk URL - The sourceImage URL - The sourceSnapshot URL + * The full Google Cloud Storage URL where the raw disk image archive is + * stored. + * The following are valid formats for the URL: + * - https://storage.googleapis.com/bucket_name/image_archive_name + * - https://storage.googleapis.com/bucket_name/folder_name/image_archive_name + * In order to create an image, you must provide the full or partial URL of + * one of the following: + * - The rawDisk.source URL + * - The sourceDisk URL + * - The sourceImage URL + * - The sourceSnapshot URL * * Generated from protobuf field optional string source = 177235995; */ @@ -42,12 +55,25 @@ class RawDisk extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $container_type - * The format used to encode and transmit the block device, which should be TAR. This is just a container and transmission format and not a runtime format. Provided by the client when the disk image is created. + * The format used to encode and transmit the block device, which should beTAR. This is just a container and transmission format and not + * a runtime format. Provided by the client when the disk image is created. * Check the ContainerType enum for the list of possible values. * @type string $sha1_checksum - * [Deprecated] This field is deprecated. An optional SHA1 checksum of the disk image before unpackaging provided by the client when the disk image is created. + * [Deprecated] This field is deprecated. + * An optional SHA1 checksum of the disk image before unpackaging provided + * by the client when the disk image is created. * @type string $source - * The full Google Cloud Storage URL where the raw disk image archive is stored. The following are valid formats for the URL: - https://storage.googleapis.com/bucket_name/image_archive_name - https://storage.googleapis.com/bucket_name/folder_name/ image_archive_name In order to create an image, you must provide the full or partial URL of one of the following: - The rawDisk.source URL - The sourceDisk URL - The sourceImage URL - The sourceSnapshot URL + * The full Google Cloud Storage URL where the raw disk image archive is + * stored. + * The following are valid formats for the URL: + * - https://storage.googleapis.com/bucket_name/image_archive_name + * - https://storage.googleapis.com/bucket_name/folder_name/image_archive_name + * In order to create an image, you must provide the full or partial URL of + * one of the following: + * - The rawDisk.source URL + * - The sourceDisk URL + * - The sourceImage URL + * - The sourceSnapshot URL * } */ public function __construct($data = NULL) { @@ -56,7 +82,8 @@ public function __construct($data = NULL) { } /** - * The format used to encode and transmit the block device, which should be TAR. This is just a container and transmission format and not a runtime format. Provided by the client when the disk image is created. + * The format used to encode and transmit the block device, which should beTAR. This is just a container and transmission format and not + * a runtime format. Provided by the client when the disk image is created. * Check the ContainerType enum for the list of possible values. * * Generated from protobuf field optional string container_type = 318809144; @@ -78,7 +105,8 @@ public function clearContainerType() } /** - * The format used to encode and transmit the block device, which should be TAR. This is just a container and transmission format and not a runtime format. Provided by the client when the disk image is created. + * The format used to encode and transmit the block device, which should beTAR. This is just a container and transmission format and not + * a runtime format. Provided by the client when the disk image is created. * Check the ContainerType enum for the list of possible values. * * Generated from protobuf field optional string container_type = 318809144; @@ -94,7 +122,9 @@ public function setContainerType($var) } /** - * [Deprecated] This field is deprecated. An optional SHA1 checksum of the disk image before unpackaging provided by the client when the disk image is created. + * [Deprecated] This field is deprecated. + * An optional SHA1 checksum of the disk image before unpackaging provided + * by the client when the disk image is created. * * Generated from protobuf field optional string sha1_checksum = 314444349; * @return string @@ -115,7 +145,9 @@ public function clearSha1Checksum() } /** - * [Deprecated] This field is deprecated. An optional SHA1 checksum of the disk image before unpackaging provided by the client when the disk image is created. + * [Deprecated] This field is deprecated. + * An optional SHA1 checksum of the disk image before unpackaging provided + * by the client when the disk image is created. * * Generated from protobuf field optional string sha1_checksum = 314444349; * @param string $var @@ -130,7 +162,17 @@ public function setSha1Checksum($var) } /** - * The full Google Cloud Storage URL where the raw disk image archive is stored. The following are valid formats for the URL: - https://storage.googleapis.com/bucket_name/image_archive_name - https://storage.googleapis.com/bucket_name/folder_name/ image_archive_name In order to create an image, you must provide the full or partial URL of one of the following: - The rawDisk.source URL - The sourceDisk URL - The sourceImage URL - The sourceSnapshot URL + * The full Google Cloud Storage URL where the raw disk image archive is + * stored. + * The following are valid formats for the URL: + * - https://storage.googleapis.com/bucket_name/image_archive_name + * - https://storage.googleapis.com/bucket_name/folder_name/image_archive_name + * In order to create an image, you must provide the full or partial URL of + * one of the following: + * - The rawDisk.source URL + * - The sourceDisk URL + * - The sourceImage URL + * - The sourceSnapshot URL * * Generated from protobuf field optional string source = 177235995; * @return string @@ -151,7 +193,17 @@ public function clearSource() } /** - * The full Google Cloud Storage URL where the raw disk image archive is stored. The following are valid formats for the URL: - https://storage.googleapis.com/bucket_name/image_archive_name - https://storage.googleapis.com/bucket_name/folder_name/ image_archive_name In order to create an image, you must provide the full or partial URL of one of the following: - The rawDisk.source URL - The sourceDisk URL - The sourceImage URL - The sourceSnapshot URL + * The full Google Cloud Storage URL where the raw disk image archive is + * stored. + * The following are valid formats for the URL: + * - https://storage.googleapis.com/bucket_name/image_archive_name + * - https://storage.googleapis.com/bucket_name/folder_name/image_archive_name + * In order to create an image, you must provide the full or partial URL of + * one of the following: + * - The rawDisk.source URL + * - The sourceDisk URL + * - The sourceImage URL + * - The sourceSnapshot URL * * Generated from protobuf field optional string source = 177235995; * @param string $var diff --git a/Compute/src/V1/RawDisk/ContainerType.php b/Compute/src/V1/RawDisk/ContainerType.php index e9c51db39b04..791a1c26713e 100644 --- a/Compute/src/V1/RawDisk/ContainerType.php +++ b/Compute/src/V1/RawDisk/ContainerType.php @@ -7,7 +7,8 @@ use UnexpectedValueException; /** - * The format used to encode and transmit the block device, which should be TAR. This is just a container and transmission format and not a runtime format. Provided by the client when the disk image is created. + * The format used to encode and transmit the block device, which should beTAR. This is just a container and transmission format and not + * a runtime format. Provided by the client when the disk image is created. * * Protobuf type google.cloud.compute.v1.RawDisk.ContainerType */ diff --git a/Compute/src/V1/RecreateInstancesInstanceGroupManagerRequest.php b/Compute/src/V1/RecreateInstancesInstanceGroupManagerRequest.php index 9c0d61e74ecd..bc7d4d7ebb17 100644 --- a/Compute/src/V1/RecreateInstancesInstanceGroupManagerRequest.php +++ b/Compute/src/V1/RecreateInstancesInstanceGroupManagerRequest.php @@ -34,13 +34,24 @@ class RecreateInstancesInstanceGroupManagerRequest extends \Google\Protobuf\Inte */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ protected $request_id = null; /** - * The name of the zone where the managed instance group is located. + * The name of thezone where the managed + * instance group is located. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; */ @@ -48,7 +59,8 @@ class RecreateInstancesInstanceGroupManagerRequest extends \Google\Protobuf\Inte /** * @param string $project Project ID for this request. - * @param string $zone The name of the zone where the managed instance group is located. + * @param string $zone The name of thezone where the managed + * instance group is located. * @param string $instanceGroupManager The name of the managed instance group. * @param \Google\Cloud\Compute\V1\InstanceGroupManagersRecreateInstancesRequest $instanceGroupManagersRecreateInstancesRequestResource The body resource for this request * @@ -78,9 +90,20 @@ public static function build(string $project, string $zone, string $instanceGrou * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $zone - * The name of the zone where the managed instance group is located. + * The name of thezone where the managed + * instance group is located. * } */ public function __construct($data = NULL) { @@ -177,7 +200,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -198,7 +231,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var @@ -213,7 +256,8 @@ public function setRequestId($var) } /** - * The name of the zone where the managed instance group is located. + * The name of thezone where the managed + * instance group is located. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; * @return string @@ -224,7 +268,8 @@ public function getZone() } /** - * The name of the zone where the managed instance group is located. + * The name of thezone where the managed + * instance group is located. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; * @param string $var diff --git a/Compute/src/V1/RecreateInstancesRegionInstanceGroupManagerRequest.php b/Compute/src/V1/RecreateInstancesRegionInstanceGroupManagerRequest.php index 2e63e0860acc..397297a60c5c 100644 --- a/Compute/src/V1/RecreateInstancesRegionInstanceGroupManagerRequest.php +++ b/Compute/src/V1/RecreateInstancesRegionInstanceGroupManagerRequest.php @@ -40,7 +40,17 @@ class RecreateInstancesRegionInstanceGroupManagerRequest extends \Google\Protobu */ protected $region_instance_group_managers_recreate_request_resource = null; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -80,7 +90,17 @@ public static function build(string $project, string $region, string $instanceGr * @type \Google\Cloud\Compute\V1\RegionInstanceGroupManagersRecreateRequest $region_instance_group_managers_recreate_request_resource * The body resource for this request * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -203,7 +223,17 @@ public function setRegionInstanceGroupManagersRecreateRequestResource($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -224,7 +254,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/Reference.php b/Compute/src/V1/Reference.php index 827285c61f87..08fd35bbd4e9 100644 --- a/Compute/src/V1/Reference.php +++ b/Compute/src/V1/Reference.php @@ -16,13 +16,16 @@ class Reference extends \Google\Protobuf\Internal\Message { /** - * [Output Only] Type of the resource. Always compute#reference for references. + * [Output Only] Type of the resource. Always compute#reference + * for references. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * A description of the reference type with no implied semantics. Possible values include: 1. MEMBER_OF + * A description of the reference type with no implied semantics. Possible + * values include: + * 1. MEMBER_OF * * Generated from protobuf field optional string reference_type = 247521198; */ @@ -47,9 +50,12 @@ class Reference extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $kind - * [Output Only] Type of the resource. Always compute#reference for references. + * [Output Only] Type of the resource. Always compute#reference + * for references. * @type string $reference_type - * A description of the reference type with no implied semantics. Possible values include: 1. MEMBER_OF + * A description of the reference type with no implied semantics. Possible + * values include: + * 1. MEMBER_OF * @type string $referrer * URL of the resource which refers to the target. * @type string $target @@ -62,7 +68,8 @@ public function __construct($data = NULL) { } /** - * [Output Only] Type of the resource. Always compute#reference for references. + * [Output Only] Type of the resource. Always compute#reference + * for references. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -83,7 +90,8 @@ public function clearKind() } /** - * [Output Only] Type of the resource. Always compute#reference for references. + * [Output Only] Type of the resource. Always compute#reference + * for references. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -98,7 +106,9 @@ public function setKind($var) } /** - * A description of the reference type with no implied semantics. Possible values include: 1. MEMBER_OF + * A description of the reference type with no implied semantics. Possible + * values include: + * 1. MEMBER_OF * * Generated from protobuf field optional string reference_type = 247521198; * @return string @@ -119,7 +129,9 @@ public function clearReferenceType() } /** - * A description of the reference type with no implied semantics. Possible values include: 1. MEMBER_OF + * A description of the reference type with no implied semantics. Possible + * values include: + * 1. MEMBER_OF * * Generated from protobuf field optional string reference_type = 247521198; * @param string $var diff --git a/Compute/src/V1/Region.php b/Compute/src/V1/Region.php index 5e8f8b4bacbd..8e1ade957110 100644 --- a/Compute/src/V1/Region.php +++ b/Compute/src/V1/Region.php @@ -9,14 +9,18 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Represents a Region resource. A region is a geographical area where a resource is located. For more information, read Regions and Zones. + * Represents a Region resource. + * A region is a geographical area where a resource is located. For more + * information, readRegions + * and Zones. * * Generated from protobuf message google.cloud.compute.v1.Region */ class Region extends \Google\Protobuf\Internal\Message { /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; */ @@ -34,13 +38,15 @@ class Region extends \Google\Protobuf\Internal\Message */ protected $description = null; /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; */ protected $id = null; /** - * [Output Only] Type of the resource. Always compute#region for regions. + * [Output Only] Type of the resource. Always compute#region for + * regions. * * Generated from protobuf field optional string kind = 3292052; */ @@ -52,7 +58,8 @@ class Region extends \Google\Protobuf\Internal\Message */ protected $name = null; /** - * [Output Only] Warning of fetching the `quotas` field for this region. This field is populated only if fetching of the `quotas` field fails. + * [Output Only] Warning of fetching the `quotas` field for this region. This + * field is populated only if fetching of the `quotas` field fails. * * Generated from protobuf field optional .google.cloud.compute.v1.QuotaStatusWarning quota_status_warning = 302941430; */ @@ -70,7 +77,7 @@ class Region extends \Google\Protobuf\Internal\Message */ protected $self_link = null; /** - * [Output Only] Status of the region, either UP or DOWN. + * [Output Only] Status of the region, either UP orDOWN. * Check the Status enum for the list of possible values. * * Generated from protobuf field optional string status = 181260274; @@ -83,7 +90,8 @@ class Region extends \Google\Protobuf\Internal\Message */ protected $supports_pzs = null; /** - * [Output Only] A list of zones available in this region, in the form of resource URLs. + * [Output Only] A list of zones available in this region, in the form of + * resource URLs. * * Generated from protobuf field repeated string zones = 116085319; */ @@ -96,30 +104,35 @@ class Region extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $creation_timestamp - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * @type \Google\Cloud\Compute\V1\DeprecationStatus $deprecated * [Output Only] The deprecation status associated with this region. * @type string $description * [Output Only] Textual description of the resource. * @type int|string $id - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * @type string $kind - * [Output Only] Type of the resource. Always compute#region for regions. + * [Output Only] Type of the resource. Always compute#region for + * regions. * @type string $name * [Output Only] Name of the resource. * @type \Google\Cloud\Compute\V1\QuotaStatusWarning $quota_status_warning - * [Output Only] Warning of fetching the `quotas` field for this region. This field is populated only if fetching of the `quotas` field fails. + * [Output Only] Warning of fetching the `quotas` field for this region. This + * field is populated only if fetching of the `quotas` field fails. * @type array<\Google\Cloud\Compute\V1\Quota>|\Google\Protobuf\Internal\RepeatedField $quotas * [Output Only] Quotas assigned to this region. * @type string $self_link * [Output Only] Server-defined URL for the resource. * @type string $status - * [Output Only] Status of the region, either UP or DOWN. + * [Output Only] Status of the region, either UP orDOWN. * Check the Status enum for the list of possible values. * @type bool $supports_pzs * [Output Only] Reserved for future use. * @type array|\Google\Protobuf\Internal\RepeatedField $zones - * [Output Only] A list of zones available in this region, in the form of resource URLs. + * [Output Only] A list of zones available in this region, in the form of + * resource URLs. * } */ public function __construct($data = NULL) { @@ -128,7 +141,8 @@ public function __construct($data = NULL) { } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @return string @@ -149,7 +163,8 @@ public function clearCreationTimestamp() } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @param string $var @@ -236,7 +251,8 @@ public function setDescription($var) } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @return int|string @@ -257,7 +273,8 @@ public function clearId() } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @param int|string $var @@ -272,7 +289,8 @@ public function setId($var) } /** - * [Output Only] Type of the resource. Always compute#region for regions. + * [Output Only] Type of the resource. Always compute#region for + * regions. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -293,7 +311,8 @@ public function clearKind() } /** - * [Output Only] Type of the resource. Always compute#region for regions. + * [Output Only] Type of the resource. Always compute#region for + * regions. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -344,7 +363,8 @@ public function setName($var) } /** - * [Output Only] Warning of fetching the `quotas` field for this region. This field is populated only if fetching of the `quotas` field fails. + * [Output Only] Warning of fetching the `quotas` field for this region. This + * field is populated only if fetching of the `quotas` field fails. * * Generated from protobuf field optional .google.cloud.compute.v1.QuotaStatusWarning quota_status_warning = 302941430; * @return \Google\Cloud\Compute\V1\QuotaStatusWarning|null @@ -365,7 +385,8 @@ public function clearQuotaStatusWarning() } /** - * [Output Only] Warning of fetching the `quotas` field for this region. This field is populated only if fetching of the `quotas` field fails. + * [Output Only] Warning of fetching the `quotas` field for this region. This + * field is populated only if fetching of the `quotas` field fails. * * Generated from protobuf field optional .google.cloud.compute.v1.QuotaStatusWarning quota_status_warning = 302941430; * @param \Google\Cloud\Compute\V1\QuotaStatusWarning $var @@ -442,7 +463,7 @@ public function setSelfLink($var) } /** - * [Output Only] Status of the region, either UP or DOWN. + * [Output Only] Status of the region, either UP orDOWN. * Check the Status enum for the list of possible values. * * Generated from protobuf field optional string status = 181260274; @@ -464,7 +485,7 @@ public function clearStatus() } /** - * [Output Only] Status of the region, either UP or DOWN. + * [Output Only] Status of the region, either UP orDOWN. * Check the Status enum for the list of possible values. * * Generated from protobuf field optional string status = 181260274; @@ -516,7 +537,8 @@ public function setSupportsPzs($var) } /** - * [Output Only] A list of zones available in this region, in the form of resource URLs. + * [Output Only] A list of zones available in this region, in the form of + * resource URLs. * * Generated from protobuf field repeated string zones = 116085319; * @return \Google\Protobuf\Internal\RepeatedField @@ -527,7 +549,8 @@ public function getZones() } /** - * [Output Only] A list of zones available in this region, in the form of resource URLs. + * [Output Only] A list of zones available in this region, in the form of + * resource URLs. * * Generated from protobuf field repeated string zones = 116085319; * @param array|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/Region/Status.php b/Compute/src/V1/Region/Status.php index b818cb0e4b7a..5a4613796b63 100644 --- a/Compute/src/V1/Region/Status.php +++ b/Compute/src/V1/Region/Status.php @@ -7,7 +7,7 @@ use UnexpectedValueException; /** - * [Output Only] Status of the region, either UP or DOWN. + * [Output Only] Status of the region, either UP orDOWN. * * Protobuf type google.cloud.compute.v1.Region.Status */ diff --git a/Compute/src/V1/RegionAddressesMoveRequest.php b/Compute/src/V1/RegionAddressesMoveRequest.php index d036b2d45d6c..e21ba476e202 100644 --- a/Compute/src/V1/RegionAddressesMoveRequest.php +++ b/Compute/src/V1/RegionAddressesMoveRequest.php @@ -15,13 +15,18 @@ class RegionAddressesMoveRequest extends \Google\Protobuf\Internal\Message { /** - * An optional destination address description if intended to be different from the source. + * An optional destination address description if intended to be different + * from the source. * * Generated from protobuf field optional string description = 422937596; */ protected $description = null; /** - * The URL of the destination address to move to. This can be a full or partial URL. For example, the following are all valid URLs to a address: - https://www.googleapis.com/compute/v1/projects/project/regions/region /addresses/address - projects/project/regions/region/addresses/address Note that destination project must be different from the source project. So /regions/region/addresses/address is not valid partial url. + * The URL of the destination address to move to. This can be a full or + * partial URL. For example, the following are all valid URLs to a address: + * - https://www.googleapis.com/compute/v1/projects/project/regions/region/addresses/address + * - projects/project/regions/region/addresses/address + * Note that destination project must be different from the source project. So/regions/region/addresses/address is not valid partial url. * * Generated from protobuf field optional string destination_address = 371693763; */ @@ -34,9 +39,14 @@ class RegionAddressesMoveRequest extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $description - * An optional destination address description if intended to be different from the source. + * An optional destination address description if intended to be different + * from the source. * @type string $destination_address - * The URL of the destination address to move to. This can be a full or partial URL. For example, the following are all valid URLs to a address: - https://www.googleapis.com/compute/v1/projects/project/regions/region /addresses/address - projects/project/regions/region/addresses/address Note that destination project must be different from the source project. So /regions/region/addresses/address is not valid partial url. + * The URL of the destination address to move to. This can be a full or + * partial URL. For example, the following are all valid URLs to a address: + * - https://www.googleapis.com/compute/v1/projects/project/regions/region/addresses/address + * - projects/project/regions/region/addresses/address + * Note that destination project must be different from the source project. So/regions/region/addresses/address is not valid partial url. * } */ public function __construct($data = NULL) { @@ -45,7 +55,8 @@ public function __construct($data = NULL) { } /** - * An optional destination address description if intended to be different from the source. + * An optional destination address description if intended to be different + * from the source. * * Generated from protobuf field optional string description = 422937596; * @return string @@ -66,7 +77,8 @@ public function clearDescription() } /** - * An optional destination address description if intended to be different from the source. + * An optional destination address description if intended to be different + * from the source. * * Generated from protobuf field optional string description = 422937596; * @param string $var @@ -81,7 +93,11 @@ public function setDescription($var) } /** - * The URL of the destination address to move to. This can be a full or partial URL. For example, the following are all valid URLs to a address: - https://www.googleapis.com/compute/v1/projects/project/regions/region /addresses/address - projects/project/regions/region/addresses/address Note that destination project must be different from the source project. So /regions/region/addresses/address is not valid partial url. + * The URL of the destination address to move to. This can be a full or + * partial URL. For example, the following are all valid URLs to a address: + * - https://www.googleapis.com/compute/v1/projects/project/regions/region/addresses/address + * - projects/project/regions/region/addresses/address + * Note that destination project must be different from the source project. So/regions/region/addresses/address is not valid partial url. * * Generated from protobuf field optional string destination_address = 371693763; * @return string @@ -102,7 +118,11 @@ public function clearDestinationAddress() } /** - * The URL of the destination address to move to. This can be a full or partial URL. For example, the following are all valid URLs to a address: - https://www.googleapis.com/compute/v1/projects/project/regions/region /addresses/address - projects/project/regions/region/addresses/address Note that destination project must be different from the source project. So /regions/region/addresses/address is not valid partial url. + * The URL of the destination address to move to. This can be a full or + * partial URL. For example, the following are all valid URLs to a address: + * - https://www.googleapis.com/compute/v1/projects/project/regions/region/addresses/address + * - projects/project/regions/region/addresses/address + * Note that destination project must be different from the source project. So/regions/region/addresses/address is not valid partial url. * * Generated from protobuf field optional string destination_address = 371693763; * @param string $var diff --git a/Compute/src/V1/RegionAutoscalerList.php b/Compute/src/V1/RegionAutoscalerList.php index 205e8bab92b2..e0a8a97dd5b4 100644 --- a/Compute/src/V1/RegionAutoscalerList.php +++ b/Compute/src/V1/RegionAutoscalerList.php @@ -34,7 +34,11 @@ class RegionAutoscalerList extends \Google\Protobuf\Internal\Message */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -65,7 +69,11 @@ class RegionAutoscalerList extends \Google\Protobuf\Internal\Message * @type string $kind * Type of resource. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type \Google\Cloud\Compute\V1\Warning $warning @@ -176,7 +184,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -197,7 +209,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/RegionDiskTypeList.php b/Compute/src/V1/RegionDiskTypeList.php index a762f6f83408..be1cfa8a198f 100644 --- a/Compute/src/V1/RegionDiskTypeList.php +++ b/Compute/src/V1/RegionDiskTypeList.php @@ -27,13 +27,17 @@ class RegionDiskTypeList extends \Google\Protobuf\Internal\Message */ private $items; /** - * [Output Only] Type of resource. Always compute#regionDiskTypeList for region disk types. + * [Output Only] Type of resource. Alwayscompute#regionDiskTypeList for region disk types. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -62,9 +66,13 @@ class RegionDiskTypeList extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\DiskType>|\Google\Protobuf\Internal\RepeatedField $items * A list of DiskType resources. * @type string $kind - * [Output Only] Type of resource. Always compute#regionDiskTypeList for region disk types. + * [Output Only] Type of resource. Alwayscompute#regionDiskTypeList for region disk types. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type \Google\Cloud\Compute\V1\Warning $warning @@ -139,7 +147,7 @@ public function setItems($var) } /** - * [Output Only] Type of resource. Always compute#regionDiskTypeList for region disk types. + * [Output Only] Type of resource. Alwayscompute#regionDiskTypeList for region disk types. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -160,7 +168,7 @@ public function clearKind() } /** - * [Output Only] Type of resource. Always compute#regionDiskTypeList for region disk types. + * [Output Only] Type of resource. Alwayscompute#regionDiskTypeList for region disk types. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -175,7 +183,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -196,7 +208,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/RegionDisksStartAsyncReplicationRequest.php b/Compute/src/V1/RegionDisksStartAsyncReplicationRequest.php index 8e7f39cbbe6a..a36b4fdc2ee1 100644 --- a/Compute/src/V1/RegionDisksStartAsyncReplicationRequest.php +++ b/Compute/src/V1/RegionDisksStartAsyncReplicationRequest.php @@ -15,7 +15,21 @@ class RegionDisksStartAsyncReplicationRequest extends \Google\Protobuf\Internal\Message { /** - * The secondary disk to start asynchronous replication to. You can provide this as a partial or full URL to the resource. For example, the following are valid values: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /disks/disk - https://www.googleapis.com/compute/v1/projects/project/regions/region /disks/disk - projects/project/zones/zone/disks/disk - projects/project/regions/region/disks/disk - zones/zone/disks/disk - regions/region/disks/disk + * The secondary disk to start asynchronous replication to. + * You can provide this as a partial or full URL to the resource. For example, + * the following are valid values: + * - + * https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk + * - + * https://www.googleapis.com/compute/v1/projects/project/regions/region/disks/disk + * - + * projects/project/zones/zone/disks/disk + * - + * projects/project/regions/region/disks/disk + * - + * zones/zone/disks/disk + * - + * regions/region/disks/disk * * Generated from protobuf field optional string async_secondary_disk = 131645867; */ @@ -28,7 +42,21 @@ class RegionDisksStartAsyncReplicationRequest extends \Google\Protobuf\Internal\ * Optional. Data for populating the Message object. * * @type string $async_secondary_disk - * The secondary disk to start asynchronous replication to. You can provide this as a partial or full URL to the resource. For example, the following are valid values: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /disks/disk - https://www.googleapis.com/compute/v1/projects/project/regions/region /disks/disk - projects/project/zones/zone/disks/disk - projects/project/regions/region/disks/disk - zones/zone/disks/disk - regions/region/disks/disk + * The secondary disk to start asynchronous replication to. + * You can provide this as a partial or full URL to the resource. For example, + * the following are valid values: + * - + * https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk + * - + * https://www.googleapis.com/compute/v1/projects/project/regions/region/disks/disk + * - + * projects/project/zones/zone/disks/disk + * - + * projects/project/regions/region/disks/disk + * - + * zones/zone/disks/disk + * - + * regions/region/disks/disk * } */ public function __construct($data = NULL) { @@ -37,7 +65,21 @@ public function __construct($data = NULL) { } /** - * The secondary disk to start asynchronous replication to. You can provide this as a partial or full URL to the resource. For example, the following are valid values: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /disks/disk - https://www.googleapis.com/compute/v1/projects/project/regions/region /disks/disk - projects/project/zones/zone/disks/disk - projects/project/regions/region/disks/disk - zones/zone/disks/disk - regions/region/disks/disk + * The secondary disk to start asynchronous replication to. + * You can provide this as a partial or full URL to the resource. For example, + * the following are valid values: + * - + * https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk + * - + * https://www.googleapis.com/compute/v1/projects/project/regions/region/disks/disk + * - + * projects/project/zones/zone/disks/disk + * - + * projects/project/regions/region/disks/disk + * - + * zones/zone/disks/disk + * - + * regions/region/disks/disk * * Generated from protobuf field optional string async_secondary_disk = 131645867; * @return string @@ -58,7 +100,21 @@ public function clearAsyncSecondaryDisk() } /** - * The secondary disk to start asynchronous replication to. You can provide this as a partial or full URL to the resource. For example, the following are valid values: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /disks/disk - https://www.googleapis.com/compute/v1/projects/project/regions/region /disks/disk - projects/project/zones/zone/disks/disk - projects/project/regions/region/disks/disk - zones/zone/disks/disk - regions/region/disks/disk + * The secondary disk to start asynchronous replication to. + * You can provide this as a partial or full URL to the resource. For example, + * the following are valid values: + * - + * https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk + * - + * https://www.googleapis.com/compute/v1/projects/project/regions/region/disks/disk + * - + * projects/project/zones/zone/disks/disk + * - + * projects/project/regions/region/disks/disk + * - + * zones/zone/disks/disk + * - + * regions/region/disks/disk * * Generated from protobuf field optional string async_secondary_disk = 131645867; * @param string $var diff --git a/Compute/src/V1/RegionInstanceGroupList.php b/Compute/src/V1/RegionInstanceGroupList.php index 77556fec9040..521b68e4bd6e 100644 --- a/Compute/src/V1/RegionInstanceGroupList.php +++ b/Compute/src/V1/RegionInstanceGroupList.php @@ -34,7 +34,11 @@ class RegionInstanceGroupList extends \Google\Protobuf\Internal\Message */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -65,7 +69,11 @@ class RegionInstanceGroupList extends \Google\Protobuf\Internal\Message * @type string $kind * The resource type. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type \Google\Cloud\Compute\V1\Warning $warning @@ -176,7 +184,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -197,7 +209,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/RegionInstanceGroupManagerDeleteInstanceConfigReq.php b/Compute/src/V1/RegionInstanceGroupManagerDeleteInstanceConfigReq.php index bc3f9495aa28..5a1e4e177b5f 100644 --- a/Compute/src/V1/RegionInstanceGroupManagerDeleteInstanceConfigReq.php +++ b/Compute/src/V1/RegionInstanceGroupManagerDeleteInstanceConfigReq.php @@ -16,7 +16,8 @@ class RegionInstanceGroupManagerDeleteInstanceConfigReq extends \Google\Protobuf\Internal\Message { /** - * The list of instance names for which we want to delete per-instance configs on this managed instance group. + * The list of instance names for which we want to delete per-instance configs + * on this managed instance group. * * Generated from protobuf field repeated string names = 104585032; */ @@ -29,7 +30,8 @@ class RegionInstanceGroupManagerDeleteInstanceConfigReq extends \Google\Protobuf * Optional. Data for populating the Message object. * * @type array|\Google\Protobuf\Internal\RepeatedField $names - * The list of instance names for which we want to delete per-instance configs on this managed instance group. + * The list of instance names for which we want to delete per-instance configs + * on this managed instance group. * } */ public function __construct($data = NULL) { @@ -38,7 +40,8 @@ public function __construct($data = NULL) { } /** - * The list of instance names for which we want to delete per-instance configs on this managed instance group. + * The list of instance names for which we want to delete per-instance configs + * on this managed instance group. * * Generated from protobuf field repeated string names = 104585032; * @return \Google\Protobuf\Internal\RepeatedField @@ -49,7 +52,8 @@ public function getNames() } /** - * The list of instance names for which we want to delete per-instance configs on this managed instance group. + * The list of instance names for which we want to delete per-instance configs + * on this managed instance group. * * Generated from protobuf field repeated string names = 104585032; * @param array|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/RegionInstanceGroupManagerList.php b/Compute/src/V1/RegionInstanceGroupManagerList.php index 26f1e9443f40..19d91c99193e 100644 --- a/Compute/src/V1/RegionInstanceGroupManagerList.php +++ b/Compute/src/V1/RegionInstanceGroupManagerList.php @@ -28,13 +28,19 @@ class RegionInstanceGroupManagerList extends \Google\Protobuf\Internal\Message */ private $items; /** - * [Output Only] The resource type, which is always compute#instanceGroupManagerList for a list of managed instance groups that exist in th regional scope. + * [Output Only] The resource type, which is always + * compute#instanceGroupManagerList for a list of managed instance groups that + * exist in th regional scope. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -63,9 +69,15 @@ class RegionInstanceGroupManagerList extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\InstanceGroupManager>|\Google\Protobuf\Internal\RepeatedField $items * A list of InstanceGroupManager resources. * @type string $kind - * [Output Only] The resource type, which is always compute#instanceGroupManagerList for a list of managed instance groups that exist in th regional scope. + * [Output Only] The resource type, which is always + * compute#instanceGroupManagerList for a list of managed instance groups that + * exist in th regional scope. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type \Google\Cloud\Compute\V1\Warning $warning @@ -140,7 +152,9 @@ public function setItems($var) } /** - * [Output Only] The resource type, which is always compute#instanceGroupManagerList for a list of managed instance groups that exist in th regional scope. + * [Output Only] The resource type, which is always + * compute#instanceGroupManagerList for a list of managed instance groups that + * exist in th regional scope. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -161,7 +175,9 @@ public function clearKind() } /** - * [Output Only] The resource type, which is always compute#instanceGroupManagerList for a list of managed instance groups that exist in th regional scope. + * [Output Only] The resource type, which is always + * compute#instanceGroupManagerList for a list of managed instance groups that + * exist in th regional scope. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -176,7 +192,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -197,7 +217,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/RegionInstanceGroupManagerPatchInstanceConfigReq.php b/Compute/src/V1/RegionInstanceGroupManagerPatchInstanceConfigReq.php index 76d33d674b8f..6fdfe7f2ea91 100644 --- a/Compute/src/V1/RegionInstanceGroupManagerPatchInstanceConfigReq.php +++ b/Compute/src/V1/RegionInstanceGroupManagerPatchInstanceConfigReq.php @@ -16,7 +16,8 @@ class RegionInstanceGroupManagerPatchInstanceConfigReq extends \Google\Protobuf\Internal\Message { /** - * The list of per-instance configurations to insert or patch on this managed instance group. + * The list of per-instance configurations to insert or patch on this managed + * instance group. * * Generated from protobuf field repeated .google.cloud.compute.v1.PerInstanceConfig per_instance_configs = 526265001; */ @@ -29,7 +30,8 @@ class RegionInstanceGroupManagerPatchInstanceConfigReq extends \Google\Protobuf\ * Optional. Data for populating the Message object. * * @type array<\Google\Cloud\Compute\V1\PerInstanceConfig>|\Google\Protobuf\Internal\RepeatedField $per_instance_configs - * The list of per-instance configurations to insert or patch on this managed instance group. + * The list of per-instance configurations to insert or patch on this managed + * instance group. * } */ public function __construct($data = NULL) { @@ -38,7 +40,8 @@ public function __construct($data = NULL) { } /** - * The list of per-instance configurations to insert or patch on this managed instance group. + * The list of per-instance configurations to insert or patch on this managed + * instance group. * * Generated from protobuf field repeated .google.cloud.compute.v1.PerInstanceConfig per_instance_configs = 526265001; * @return \Google\Protobuf\Internal\RepeatedField @@ -49,7 +52,8 @@ public function getPerInstanceConfigs() } /** - * The list of per-instance configurations to insert or patch on this managed instance group. + * The list of per-instance configurations to insert or patch on this managed + * instance group. * * Generated from protobuf field repeated .google.cloud.compute.v1.PerInstanceConfig per_instance_configs = 526265001; * @param array<\Google\Cloud\Compute\V1\PerInstanceConfig>|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/RegionInstanceGroupManagerUpdateInstanceConfigReq.php b/Compute/src/V1/RegionInstanceGroupManagerUpdateInstanceConfigReq.php index c49aa6fb803d..db82c002aeed 100644 --- a/Compute/src/V1/RegionInstanceGroupManagerUpdateInstanceConfigReq.php +++ b/Compute/src/V1/RegionInstanceGroupManagerUpdateInstanceConfigReq.php @@ -16,7 +16,8 @@ class RegionInstanceGroupManagerUpdateInstanceConfigReq extends \Google\Protobuf\Internal\Message { /** - * The list of per-instance configurations to insert or patch on this managed instance group. + * The list of per-instance configurations to insert or patch on this managed + * instance group. * * Generated from protobuf field repeated .google.cloud.compute.v1.PerInstanceConfig per_instance_configs = 526265001; */ @@ -29,7 +30,8 @@ class RegionInstanceGroupManagerUpdateInstanceConfigReq extends \Google\Protobuf * Optional. Data for populating the Message object. * * @type array<\Google\Cloud\Compute\V1\PerInstanceConfig>|\Google\Protobuf\Internal\RepeatedField $per_instance_configs - * The list of per-instance configurations to insert or patch on this managed instance group. + * The list of per-instance configurations to insert or patch on this managed + * instance group. * } */ public function __construct($data = NULL) { @@ -38,7 +40,8 @@ public function __construct($data = NULL) { } /** - * The list of per-instance configurations to insert or patch on this managed instance group. + * The list of per-instance configurations to insert or patch on this managed + * instance group. * * Generated from protobuf field repeated .google.cloud.compute.v1.PerInstanceConfig per_instance_configs = 526265001; * @return \Google\Protobuf\Internal\RepeatedField @@ -49,7 +52,8 @@ public function getPerInstanceConfigs() } /** - * The list of per-instance configurations to insert or patch on this managed instance group. + * The list of per-instance configurations to insert or patch on this managed + * instance group. * * Generated from protobuf field repeated .google.cloud.compute.v1.PerInstanceConfig per_instance_configs = 526265001; * @param array<\Google\Cloud\Compute\V1\PerInstanceConfig>|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/RegionInstanceGroupManagersAbandonInstancesRequest.php b/Compute/src/V1/RegionInstanceGroupManagersAbandonInstancesRequest.php index 1b2ed19a5c8b..93735ff9d998 100644 --- a/Compute/src/V1/RegionInstanceGroupManagersAbandonInstancesRequest.php +++ b/Compute/src/V1/RegionInstanceGroupManagersAbandonInstancesRequest.php @@ -15,7 +15,8 @@ class RegionInstanceGroupManagersAbandonInstancesRequest extends \Google\Protobuf\Internal\Message { /** - * The URLs of one or more instances to abandon. This can be a full URL or a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. + * The URLs of one or more instances to abandon. This can be a full URL or + * a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. * * Generated from protobuf field repeated string instances = 29097598; */ @@ -28,7 +29,8 @@ class RegionInstanceGroupManagersAbandonInstancesRequest extends \Google\Protobu * Optional. Data for populating the Message object. * * @type array|\Google\Protobuf\Internal\RepeatedField $instances - * The URLs of one or more instances to abandon. This can be a full URL or a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. + * The URLs of one or more instances to abandon. This can be a full URL or + * a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. * } */ public function __construct($data = NULL) { @@ -37,7 +39,8 @@ public function __construct($data = NULL) { } /** - * The URLs of one or more instances to abandon. This can be a full URL or a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. + * The URLs of one or more instances to abandon. This can be a full URL or + * a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. * * Generated from protobuf field repeated string instances = 29097598; * @return \Google\Protobuf\Internal\RepeatedField @@ -48,7 +51,8 @@ public function getInstances() } /** - * The URLs of one or more instances to abandon. This can be a full URL or a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. + * The URLs of one or more instances to abandon. This can be a full URL or + * a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. * * Generated from protobuf field repeated string instances = 29097598; * @param array|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/RegionInstanceGroupManagersApplyUpdatesRequest.php b/Compute/src/V1/RegionInstanceGroupManagersApplyUpdatesRequest.php index 54e83fafea99..f6f63a4a6077 100644 --- a/Compute/src/V1/RegionInstanceGroupManagersApplyUpdatesRequest.php +++ b/Compute/src/V1/RegionInstanceGroupManagersApplyUpdatesRequest.php @@ -16,26 +16,51 @@ class RegionInstanceGroupManagersApplyUpdatesRequest extends \Google\Protobuf\Internal\Message { /** - * Flag to update all instances instead of specified list of “instances”. If the flag is set to true then the instances may not be specified in the request. + * Flag to update all instances instead of specified list of “instances”. + * If the flag is set to true then the instances may not be specified + * in the request. * * Generated from protobuf field optional bool all_instances = 403676512; */ protected $all_instances = null; /** - * The list of URLs of one or more instances for which you want to apply updates. Each URL can be a full URL or a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. + * The list of URLs of one or more instances for which you want to apply + * updates. Each URL can be a full URL or a partial URL, such aszones/[ZONE]/instances/[INSTANCE_NAME]. * * Generated from protobuf field repeated string instances = 29097598; */ private $instances; /** - * The minimal action that you want to perform on each instance during the update: - REPLACE: At minimum, delete the instance and create it again. - RESTART: Stop the instance and start it again. - REFRESH: Do not stop the instance and limit disruption as much as possible. - NONE: Do not disrupt the instance at all. By default, the minimum action is NONE. If your update requires a more disruptive action than you set with this flag, the necessary action is performed to execute the update. + * The minimal action that you want to perform on each instance during the + * update: + * - REPLACE: At minimum, delete the instance and create it + * again. + * - RESTART: Stop the instance and start it + * again. + * - REFRESH: Do not stop the instance and limit + * disruption as much as possible. + * - NONE: Do not + * disrupt the instance at all. + * By default, the minimum action is NONE. If your update + * requires a more disruptive action than you set with this flag, the + * necessary action is performed to execute the update. * Check the MinimalAction enum for the list of possible values. * * Generated from protobuf field optional string minimal_action = 270567060; */ protected $minimal_action = null; /** - * The most disruptive action that you want to perform on each instance during the update: - REPLACE: Delete the instance and create it again. - RESTART: Stop the instance and start it again. - REFRESH: Do not stop the instance and limit disruption as much as possible. - NONE: Do not disrupt the instance at all. By default, the most disruptive allowed action is REPLACE. If your update requires a more disruptive action than you set with this flag, the update request will fail. + * The most disruptive action that you want to perform on each instance during + * the update: + * - REPLACE: Delete the instance and create it again. + * - RESTART: Stop the instance and start it again. + * - REFRESH: Do not stop the instance and limit disruption + * as much as possible. + * - NONE: Do not disrupt the + * instance at all. + * By default, the most disruptive allowed action is REPLACE. If + * your update requires a more disruptive action than you set with this flag, + * the update request will fail. * Check the MostDisruptiveAllowedAction enum for the list of possible values. * * Generated from protobuf field optional string most_disruptive_allowed_action = 66103053; @@ -49,14 +74,39 @@ class RegionInstanceGroupManagersApplyUpdatesRequest extends \Google\Protobuf\In * Optional. Data for populating the Message object. * * @type bool $all_instances - * Flag to update all instances instead of specified list of “instances”. If the flag is set to true then the instances may not be specified in the request. + * Flag to update all instances instead of specified list of “instances”. + * If the flag is set to true then the instances may not be specified + * in the request. * @type array|\Google\Protobuf\Internal\RepeatedField $instances - * The list of URLs of one or more instances for which you want to apply updates. Each URL can be a full URL or a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. + * The list of URLs of one or more instances for which you want to apply + * updates. Each URL can be a full URL or a partial URL, such aszones/[ZONE]/instances/[INSTANCE_NAME]. * @type string $minimal_action - * The minimal action that you want to perform on each instance during the update: - REPLACE: At minimum, delete the instance and create it again. - RESTART: Stop the instance and start it again. - REFRESH: Do not stop the instance and limit disruption as much as possible. - NONE: Do not disrupt the instance at all. By default, the minimum action is NONE. If your update requires a more disruptive action than you set with this flag, the necessary action is performed to execute the update. + * The minimal action that you want to perform on each instance during the + * update: + * - REPLACE: At minimum, delete the instance and create it + * again. + * - RESTART: Stop the instance and start it + * again. + * - REFRESH: Do not stop the instance and limit + * disruption as much as possible. + * - NONE: Do not + * disrupt the instance at all. + * By default, the minimum action is NONE. If your update + * requires a more disruptive action than you set with this flag, the + * necessary action is performed to execute the update. * Check the MinimalAction enum for the list of possible values. * @type string $most_disruptive_allowed_action - * The most disruptive action that you want to perform on each instance during the update: - REPLACE: Delete the instance and create it again. - RESTART: Stop the instance and start it again. - REFRESH: Do not stop the instance and limit disruption as much as possible. - NONE: Do not disrupt the instance at all. By default, the most disruptive allowed action is REPLACE. If your update requires a more disruptive action than you set with this flag, the update request will fail. + * The most disruptive action that you want to perform on each instance during + * the update: + * - REPLACE: Delete the instance and create it again. + * - RESTART: Stop the instance and start it again. + * - REFRESH: Do not stop the instance and limit disruption + * as much as possible. + * - NONE: Do not disrupt the + * instance at all. + * By default, the most disruptive allowed action is REPLACE. If + * your update requires a more disruptive action than you set with this flag, + * the update request will fail. * Check the MostDisruptiveAllowedAction enum for the list of possible values. * } */ @@ -66,7 +116,9 @@ public function __construct($data = NULL) { } /** - * Flag to update all instances instead of specified list of “instances”. If the flag is set to true then the instances may not be specified in the request. + * Flag to update all instances instead of specified list of “instances”. + * If the flag is set to true then the instances may not be specified + * in the request. * * Generated from protobuf field optional bool all_instances = 403676512; * @return bool @@ -87,7 +139,9 @@ public function clearAllInstances() } /** - * Flag to update all instances instead of specified list of “instances”. If the flag is set to true then the instances may not be specified in the request. + * Flag to update all instances instead of specified list of “instances”. + * If the flag is set to true then the instances may not be specified + * in the request. * * Generated from protobuf field optional bool all_instances = 403676512; * @param bool $var @@ -102,7 +156,8 @@ public function setAllInstances($var) } /** - * The list of URLs of one or more instances for which you want to apply updates. Each URL can be a full URL or a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. + * The list of URLs of one or more instances for which you want to apply + * updates. Each URL can be a full URL or a partial URL, such aszones/[ZONE]/instances/[INSTANCE_NAME]. * * Generated from protobuf field repeated string instances = 29097598; * @return \Google\Protobuf\Internal\RepeatedField @@ -113,7 +168,8 @@ public function getInstances() } /** - * The list of URLs of one or more instances for which you want to apply updates. Each URL can be a full URL or a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. + * The list of URLs of one or more instances for which you want to apply + * updates. Each URL can be a full URL or a partial URL, such aszones/[ZONE]/instances/[INSTANCE_NAME]. * * Generated from protobuf field repeated string instances = 29097598; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -128,7 +184,19 @@ public function setInstances($var) } /** - * The minimal action that you want to perform on each instance during the update: - REPLACE: At minimum, delete the instance and create it again. - RESTART: Stop the instance and start it again. - REFRESH: Do not stop the instance and limit disruption as much as possible. - NONE: Do not disrupt the instance at all. By default, the minimum action is NONE. If your update requires a more disruptive action than you set with this flag, the necessary action is performed to execute the update. + * The minimal action that you want to perform on each instance during the + * update: + * - REPLACE: At minimum, delete the instance and create it + * again. + * - RESTART: Stop the instance and start it + * again. + * - REFRESH: Do not stop the instance and limit + * disruption as much as possible. + * - NONE: Do not + * disrupt the instance at all. + * By default, the minimum action is NONE. If your update + * requires a more disruptive action than you set with this flag, the + * necessary action is performed to execute the update. * Check the MinimalAction enum for the list of possible values. * * Generated from protobuf field optional string minimal_action = 270567060; @@ -150,7 +218,19 @@ public function clearMinimalAction() } /** - * The minimal action that you want to perform on each instance during the update: - REPLACE: At minimum, delete the instance and create it again. - RESTART: Stop the instance and start it again. - REFRESH: Do not stop the instance and limit disruption as much as possible. - NONE: Do not disrupt the instance at all. By default, the minimum action is NONE. If your update requires a more disruptive action than you set with this flag, the necessary action is performed to execute the update. + * The minimal action that you want to perform on each instance during the + * update: + * - REPLACE: At minimum, delete the instance and create it + * again. + * - RESTART: Stop the instance and start it + * again. + * - REFRESH: Do not stop the instance and limit + * disruption as much as possible. + * - NONE: Do not + * disrupt the instance at all. + * By default, the minimum action is NONE. If your update + * requires a more disruptive action than you set with this flag, the + * necessary action is performed to execute the update. * Check the MinimalAction enum for the list of possible values. * * Generated from protobuf field optional string minimal_action = 270567060; @@ -166,7 +246,17 @@ public function setMinimalAction($var) } /** - * The most disruptive action that you want to perform on each instance during the update: - REPLACE: Delete the instance and create it again. - RESTART: Stop the instance and start it again. - REFRESH: Do not stop the instance and limit disruption as much as possible. - NONE: Do not disrupt the instance at all. By default, the most disruptive allowed action is REPLACE. If your update requires a more disruptive action than you set with this flag, the update request will fail. + * The most disruptive action that you want to perform on each instance during + * the update: + * - REPLACE: Delete the instance and create it again. + * - RESTART: Stop the instance and start it again. + * - REFRESH: Do not stop the instance and limit disruption + * as much as possible. + * - NONE: Do not disrupt the + * instance at all. + * By default, the most disruptive allowed action is REPLACE. If + * your update requires a more disruptive action than you set with this flag, + * the update request will fail. * Check the MostDisruptiveAllowedAction enum for the list of possible values. * * Generated from protobuf field optional string most_disruptive_allowed_action = 66103053; @@ -188,7 +278,17 @@ public function clearMostDisruptiveAllowedAction() } /** - * The most disruptive action that you want to perform on each instance during the update: - REPLACE: Delete the instance and create it again. - RESTART: Stop the instance and start it again. - REFRESH: Do not stop the instance and limit disruption as much as possible. - NONE: Do not disrupt the instance at all. By default, the most disruptive allowed action is REPLACE. If your update requires a more disruptive action than you set with this flag, the update request will fail. + * The most disruptive action that you want to perform on each instance during + * the update: + * - REPLACE: Delete the instance and create it again. + * - RESTART: Stop the instance and start it again. + * - REFRESH: Do not stop the instance and limit disruption + * as much as possible. + * - NONE: Do not disrupt the + * instance at all. + * By default, the most disruptive allowed action is REPLACE. If + * your update requires a more disruptive action than you set with this flag, + * the update request will fail. * Check the MostDisruptiveAllowedAction enum for the list of possible values. * * Generated from protobuf field optional string most_disruptive_allowed_action = 66103053; diff --git a/Compute/src/V1/RegionInstanceGroupManagersApplyUpdatesRequest/MinimalAction.php b/Compute/src/V1/RegionInstanceGroupManagersApplyUpdatesRequest/MinimalAction.php index 373e6cae9aa6..a1e3f6c758b4 100644 --- a/Compute/src/V1/RegionInstanceGroupManagersApplyUpdatesRequest/MinimalAction.php +++ b/Compute/src/V1/RegionInstanceGroupManagersApplyUpdatesRequest/MinimalAction.php @@ -7,7 +7,19 @@ use UnexpectedValueException; /** - * The minimal action that you want to perform on each instance during the update: - REPLACE: At minimum, delete the instance and create it again. - RESTART: Stop the instance and start it again. - REFRESH: Do not stop the instance and limit disruption as much as possible. - NONE: Do not disrupt the instance at all. By default, the minimum action is NONE. If your update requires a more disruptive action than you set with this flag, the necessary action is performed to execute the update. + * The minimal action that you want to perform on each instance during the + * update: + * - REPLACE: At minimum, delete the instance and create it + * again. + * - RESTART: Stop the instance and start it + * again. + * - REFRESH: Do not stop the instance and limit + * disruption as much as possible. + * - NONE: Do not + * disrupt the instance at all. + * By default, the minimum action is NONE. If your update + * requires a more disruptive action than you set with this flag, the + * necessary action is performed to execute the update. * Additional supported values which may be not listed in the enum directly due to technical reasons: * NONE * REFRESH diff --git a/Compute/src/V1/RegionInstanceGroupManagersApplyUpdatesRequest/MostDisruptiveAllowedAction.php b/Compute/src/V1/RegionInstanceGroupManagersApplyUpdatesRequest/MostDisruptiveAllowedAction.php index 9dddcf7a4765..150345256d91 100644 --- a/Compute/src/V1/RegionInstanceGroupManagersApplyUpdatesRequest/MostDisruptiveAllowedAction.php +++ b/Compute/src/V1/RegionInstanceGroupManagersApplyUpdatesRequest/MostDisruptiveAllowedAction.php @@ -7,7 +7,17 @@ use UnexpectedValueException; /** - * The most disruptive action that you want to perform on each instance during the update: - REPLACE: Delete the instance and create it again. - RESTART: Stop the instance and start it again. - REFRESH: Do not stop the instance and limit disruption as much as possible. - NONE: Do not disrupt the instance at all. By default, the most disruptive allowed action is REPLACE. If your update requires a more disruptive action than you set with this flag, the update request will fail. + * The most disruptive action that you want to perform on each instance during + * the update: + * - REPLACE: Delete the instance and create it again. + * - RESTART: Stop the instance and start it again. + * - REFRESH: Do not stop the instance and limit disruption + * as much as possible. + * - NONE: Do not disrupt the + * instance at all. + * By default, the most disruptive allowed action is REPLACE. If + * your update requires a more disruptive action than you set with this flag, + * the update request will fail. * Additional supported values which may be not listed in the enum directly due to technical reasons: * NONE * REFRESH diff --git a/Compute/src/V1/RegionInstanceGroupManagersDeleteInstancesRequest.php b/Compute/src/V1/RegionInstanceGroupManagersDeleteInstancesRequest.php index 15137be41cd5..c064ec9ddd76 100644 --- a/Compute/src/V1/RegionInstanceGroupManagersDeleteInstancesRequest.php +++ b/Compute/src/V1/RegionInstanceGroupManagersDeleteInstancesRequest.php @@ -15,13 +15,20 @@ class RegionInstanceGroupManagersDeleteInstancesRequest extends \Google\Protobuf\Internal\Message { /** - * The URLs of one or more instances to delete. This can be a full URL or a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. + * The URLs of one or more instances to delete. This can be a full URL or + * a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. * * Generated from protobuf field repeated string instances = 29097598; */ private $instances; /** - * Specifies whether the request should proceed despite the inclusion of instances that are not members of the group or that are already in the process of being deleted or abandoned. If this field is set to `false` and such an instance is specified in the request, the operation fails. The operation always fails if the request contains a malformed instance URL or a reference to an instance that exists in a zone or region other than the group's zone or region. + * Specifies whether the request should proceed despite the inclusion of + * instances that are not members of the group or that are already in the + * process of being deleted or abandoned. If this field is set to `false` and + * such an instance is specified in the request, the operation fails. The + * operation always fails if the request contains a malformed instance URL or + * a reference to an instance that exists in a zone or region other than the + * group's zone or region. * * Generated from protobuf field optional bool skip_instances_on_validation_error = 40631073; */ @@ -34,9 +41,16 @@ class RegionInstanceGroupManagersDeleteInstancesRequest extends \Google\Protobuf * Optional. Data for populating the Message object. * * @type array|\Google\Protobuf\Internal\RepeatedField $instances - * The URLs of one or more instances to delete. This can be a full URL or a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. + * The URLs of one or more instances to delete. This can be a full URL or + * a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. * @type bool $skip_instances_on_validation_error - * Specifies whether the request should proceed despite the inclusion of instances that are not members of the group or that are already in the process of being deleted or abandoned. If this field is set to `false` and such an instance is specified in the request, the operation fails. The operation always fails if the request contains a malformed instance URL or a reference to an instance that exists in a zone or region other than the group's zone or region. + * Specifies whether the request should proceed despite the inclusion of + * instances that are not members of the group or that are already in the + * process of being deleted or abandoned. If this field is set to `false` and + * such an instance is specified in the request, the operation fails. The + * operation always fails if the request contains a malformed instance URL or + * a reference to an instance that exists in a zone or region other than the + * group's zone or region. * } */ public function __construct($data = NULL) { @@ -45,7 +59,8 @@ public function __construct($data = NULL) { } /** - * The URLs of one or more instances to delete. This can be a full URL or a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. + * The URLs of one or more instances to delete. This can be a full URL or + * a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. * * Generated from protobuf field repeated string instances = 29097598; * @return \Google\Protobuf\Internal\RepeatedField @@ -56,7 +71,8 @@ public function getInstances() } /** - * The URLs of one or more instances to delete. This can be a full URL or a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. + * The URLs of one or more instances to delete. This can be a full URL or + * a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. * * Generated from protobuf field repeated string instances = 29097598; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -71,7 +87,13 @@ public function setInstances($var) } /** - * Specifies whether the request should proceed despite the inclusion of instances that are not members of the group or that are already in the process of being deleted or abandoned. If this field is set to `false` and such an instance is specified in the request, the operation fails. The operation always fails if the request contains a malformed instance URL or a reference to an instance that exists in a zone or region other than the group's zone or region. + * Specifies whether the request should proceed despite the inclusion of + * instances that are not members of the group or that are already in the + * process of being deleted or abandoned. If this field is set to `false` and + * such an instance is specified in the request, the operation fails. The + * operation always fails if the request contains a malformed instance URL or + * a reference to an instance that exists in a zone or region other than the + * group's zone or region. * * Generated from protobuf field optional bool skip_instances_on_validation_error = 40631073; * @return bool @@ -92,7 +114,13 @@ public function clearSkipInstancesOnValidationError() } /** - * Specifies whether the request should proceed despite the inclusion of instances that are not members of the group or that are already in the process of being deleted or abandoned. If this field is set to `false` and such an instance is specified in the request, the operation fails. The operation always fails if the request contains a malformed instance URL or a reference to an instance that exists in a zone or region other than the group's zone or region. + * Specifies whether the request should proceed despite the inclusion of + * instances that are not members of the group or that are already in the + * process of being deleted or abandoned. If this field is set to `false` and + * such an instance is specified in the request, the operation fails. The + * operation always fails if the request contains a malformed instance URL or + * a reference to an instance that exists in a zone or region other than the + * group's zone or region. * * Generated from protobuf field optional bool skip_instances_on_validation_error = 40631073; * @param bool $var diff --git a/Compute/src/V1/RegionInstanceGroupManagersListErrorsResponse.php b/Compute/src/V1/RegionInstanceGroupManagersListErrorsResponse.php index 370441e2c3db..5fe681bbbd64 100644 --- a/Compute/src/V1/RegionInstanceGroupManagersListErrorsResponse.php +++ b/Compute/src/V1/RegionInstanceGroupManagersListErrorsResponse.php @@ -21,7 +21,11 @@ class RegionInstanceGroupManagersListErrorsResponse extends \Google\Protobuf\Int */ private $items; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -36,7 +40,11 @@ class RegionInstanceGroupManagersListErrorsResponse extends \Google\Protobuf\Int * @type array<\Google\Cloud\Compute\V1\InstanceManagedByIgmError>|\Google\Protobuf\Internal\RepeatedField $items * [Output Only] The list of errors of the managed instance group. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * } */ public function __construct($data = NULL) { @@ -71,7 +79,11 @@ public function setItems($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -92,7 +104,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/RegionInstanceGroupManagersListInstanceConfigsResp.php b/Compute/src/V1/RegionInstanceGroupManagersListInstanceConfigsResp.php index 38237c01f464..541be2009e0f 100644 --- a/Compute/src/V1/RegionInstanceGroupManagersListInstanceConfigsResp.php +++ b/Compute/src/V1/RegionInstanceGroupManagersListInstanceConfigsResp.php @@ -21,7 +21,11 @@ class RegionInstanceGroupManagersListInstanceConfigsResp extends \Google\Protobu */ private $items; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -42,7 +46,11 @@ class RegionInstanceGroupManagersListInstanceConfigsResp extends \Google\Protobu * @type array<\Google\Cloud\Compute\V1\PerInstanceConfig>|\Google\Protobuf\Internal\RepeatedField $items * [Output Only] The list of PerInstanceConfig. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type \Google\Cloud\Compute\V1\Warning $warning * [Output Only] Informational warning message. * } @@ -79,7 +87,11 @@ public function setItems($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -100,7 +112,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/RegionInstanceGroupManagersListInstancesResponse.php b/Compute/src/V1/RegionInstanceGroupManagersListInstancesResponse.php index 802317a23179..8017a6221cc8 100644 --- a/Compute/src/V1/RegionInstanceGroupManagersListInstancesResponse.php +++ b/Compute/src/V1/RegionInstanceGroupManagersListInstancesResponse.php @@ -21,7 +21,11 @@ class RegionInstanceGroupManagersListInstancesResponse extends \Google\Protobuf\ */ private $managed_instances; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -36,7 +40,11 @@ class RegionInstanceGroupManagersListInstancesResponse extends \Google\Protobuf\ * @type array<\Google\Cloud\Compute\V1\ManagedInstance>|\Google\Protobuf\Internal\RepeatedField $managed_instances * A list of managed instances. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * } */ public function __construct($data = NULL) { @@ -71,7 +79,11 @@ public function setManagedInstances($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -92,7 +104,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/RegionInstanceGroupManagersRecreateRequest.php b/Compute/src/V1/RegionInstanceGroupManagersRecreateRequest.php index b6aa209696d5..238901768172 100644 --- a/Compute/src/V1/RegionInstanceGroupManagersRecreateRequest.php +++ b/Compute/src/V1/RegionInstanceGroupManagersRecreateRequest.php @@ -15,7 +15,8 @@ class RegionInstanceGroupManagersRecreateRequest extends \Google\Protobuf\Internal\Message { /** - * The URLs of one or more instances to recreate. This can be a full URL or a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. + * The URLs of one or more instances to recreate. This can be a full URL or + * a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. * * Generated from protobuf field repeated string instances = 29097598; */ @@ -28,7 +29,8 @@ class RegionInstanceGroupManagersRecreateRequest extends \Google\Protobuf\Intern * Optional. Data for populating the Message object. * * @type array|\Google\Protobuf\Internal\RepeatedField $instances - * The URLs of one or more instances to recreate. This can be a full URL or a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. + * The URLs of one or more instances to recreate. This can be a full URL or + * a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. * } */ public function __construct($data = NULL) { @@ -37,7 +39,8 @@ public function __construct($data = NULL) { } /** - * The URLs of one or more instances to recreate. This can be a full URL or a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. + * The URLs of one or more instances to recreate. This can be a full URL or + * a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. * * Generated from protobuf field repeated string instances = 29097598; * @return \Google\Protobuf\Internal\RepeatedField @@ -48,7 +51,8 @@ public function getInstances() } /** - * The URLs of one or more instances to recreate. This can be a full URL or a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. + * The URLs of one or more instances to recreate. This can be a full URL or + * a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. * * Generated from protobuf field repeated string instances = 29097598; * @param array|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/RegionInstanceGroupManagersResumeInstancesRequest.php b/Compute/src/V1/RegionInstanceGroupManagersResumeInstancesRequest.php index c3cbc2f311f3..f5372bb9501b 100644 --- a/Compute/src/V1/RegionInstanceGroupManagersResumeInstancesRequest.php +++ b/Compute/src/V1/RegionInstanceGroupManagersResumeInstancesRequest.php @@ -15,7 +15,8 @@ class RegionInstanceGroupManagersResumeInstancesRequest extends \Google\Protobuf\Internal\Message { /** - * The URLs of one or more instances to resume. This can be a full URL or a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. + * The URLs of one or more instances to resume. This can be a full URL or + * a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. * * Generated from protobuf field repeated string instances = 29097598; */ @@ -28,7 +29,8 @@ class RegionInstanceGroupManagersResumeInstancesRequest extends \Google\Protobuf * Optional. Data for populating the Message object. * * @type array|\Google\Protobuf\Internal\RepeatedField $instances - * The URLs of one or more instances to resume. This can be a full URL or a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. + * The URLs of one or more instances to resume. This can be a full URL or + * a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. * } */ public function __construct($data = NULL) { @@ -37,7 +39,8 @@ public function __construct($data = NULL) { } /** - * The URLs of one or more instances to resume. This can be a full URL or a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. + * The URLs of one or more instances to resume. This can be a full URL or + * a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. * * Generated from protobuf field repeated string instances = 29097598; * @return \Google\Protobuf\Internal\RepeatedField @@ -48,7 +51,8 @@ public function getInstances() } /** - * The URLs of one or more instances to resume. This can be a full URL or a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. + * The URLs of one or more instances to resume. This can be a full URL or + * a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. * * Generated from protobuf field repeated string instances = 29097598; * @param array|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/RegionInstanceGroupManagersSetTargetPoolsRequest.php b/Compute/src/V1/RegionInstanceGroupManagersSetTargetPoolsRequest.php index ab169af46cd0..1f61a3779759 100644 --- a/Compute/src/V1/RegionInstanceGroupManagersSetTargetPoolsRequest.php +++ b/Compute/src/V1/RegionInstanceGroupManagersSetTargetPoolsRequest.php @@ -15,13 +15,16 @@ class RegionInstanceGroupManagersSetTargetPoolsRequest extends \Google\Protobuf\Internal\Message { /** - * Fingerprint of the target pools information, which is a hash of the contents. This field is used for optimistic locking when you update the target pool entries. This field is optional. + * Fingerprint of the target pools information, which is a hash of the + * contents. This field is used for optimistic locking when you update the + * target pool entries. This field is optional. * * Generated from protobuf field optional string fingerprint = 234678500; */ protected $fingerprint = null; /** - * The URL of all TargetPool resources to which instances in the instanceGroup field are added. The target pools automatically apply to all of the instances in the managed instance group. + * The URL of all TargetPool resources to which instances in theinstanceGroup field are added. The target pools automatically + * apply to all of the instances in the managed instance group. * * Generated from protobuf field repeated string target_pools = 336072617; */ @@ -34,9 +37,12 @@ class RegionInstanceGroupManagersSetTargetPoolsRequest extends \Google\Protobuf\ * Optional. Data for populating the Message object. * * @type string $fingerprint - * Fingerprint of the target pools information, which is a hash of the contents. This field is used for optimistic locking when you update the target pool entries. This field is optional. + * Fingerprint of the target pools information, which is a hash of the + * contents. This field is used for optimistic locking when you update the + * target pool entries. This field is optional. * @type array|\Google\Protobuf\Internal\RepeatedField $target_pools - * The URL of all TargetPool resources to which instances in the instanceGroup field are added. The target pools automatically apply to all of the instances in the managed instance group. + * The URL of all TargetPool resources to which instances in theinstanceGroup field are added. The target pools automatically + * apply to all of the instances in the managed instance group. * } */ public function __construct($data = NULL) { @@ -45,7 +51,9 @@ public function __construct($data = NULL) { } /** - * Fingerprint of the target pools information, which is a hash of the contents. This field is used for optimistic locking when you update the target pool entries. This field is optional. + * Fingerprint of the target pools information, which is a hash of the + * contents. This field is used for optimistic locking when you update the + * target pool entries. This field is optional. * * Generated from protobuf field optional string fingerprint = 234678500; * @return string @@ -66,7 +74,9 @@ public function clearFingerprint() } /** - * Fingerprint of the target pools information, which is a hash of the contents. This field is used for optimistic locking when you update the target pool entries. This field is optional. + * Fingerprint of the target pools information, which is a hash of the + * contents. This field is used for optimistic locking when you update the + * target pool entries. This field is optional. * * Generated from protobuf field optional string fingerprint = 234678500; * @param string $var @@ -81,7 +91,8 @@ public function setFingerprint($var) } /** - * The URL of all TargetPool resources to which instances in the instanceGroup field are added. The target pools automatically apply to all of the instances in the managed instance group. + * The URL of all TargetPool resources to which instances in theinstanceGroup field are added. The target pools automatically + * apply to all of the instances in the managed instance group. * * Generated from protobuf field repeated string target_pools = 336072617; * @return \Google\Protobuf\Internal\RepeatedField @@ -92,7 +103,8 @@ public function getTargetPools() } /** - * The URL of all TargetPool resources to which instances in the instanceGroup field are added. The target pools automatically apply to all of the instances in the managed instance group. + * The URL of all TargetPool resources to which instances in theinstanceGroup field are added. The target pools automatically + * apply to all of the instances in the managed instance group. * * Generated from protobuf field repeated string target_pools = 336072617; * @param array|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/RegionInstanceGroupManagersSetTemplateRequest.php b/Compute/src/V1/RegionInstanceGroupManagersSetTemplateRequest.php index 814b33e4649f..703ceabfa3a5 100644 --- a/Compute/src/V1/RegionInstanceGroupManagersSetTemplateRequest.php +++ b/Compute/src/V1/RegionInstanceGroupManagersSetTemplateRequest.php @@ -15,7 +15,8 @@ class RegionInstanceGroupManagersSetTemplateRequest extends \Google\Protobuf\Internal\Message { /** - * URL of the InstanceTemplate resource from which all new instances will be created. + * URL of the InstanceTemplate resource from which all new instances will be + * created. * * Generated from protobuf field optional string instance_template = 309248228; */ @@ -28,7 +29,8 @@ class RegionInstanceGroupManagersSetTemplateRequest extends \Google\Protobuf\Int * Optional. Data for populating the Message object. * * @type string $instance_template - * URL of the InstanceTemplate resource from which all new instances will be created. + * URL of the InstanceTemplate resource from which all new instances will be + * created. * } */ public function __construct($data = NULL) { @@ -37,7 +39,8 @@ public function __construct($data = NULL) { } /** - * URL of the InstanceTemplate resource from which all new instances will be created. + * URL of the InstanceTemplate resource from which all new instances will be + * created. * * Generated from protobuf field optional string instance_template = 309248228; * @return string @@ -58,7 +61,8 @@ public function clearInstanceTemplate() } /** - * URL of the InstanceTemplate resource from which all new instances will be created. + * URL of the InstanceTemplate resource from which all new instances will be + * created. * * Generated from protobuf field optional string instance_template = 309248228; * @param string $var diff --git a/Compute/src/V1/RegionInstanceGroupManagersStartInstancesRequest.php b/Compute/src/V1/RegionInstanceGroupManagersStartInstancesRequest.php index a4198df15373..308e8e28aaad 100644 --- a/Compute/src/V1/RegionInstanceGroupManagersStartInstancesRequest.php +++ b/Compute/src/V1/RegionInstanceGroupManagersStartInstancesRequest.php @@ -15,7 +15,8 @@ class RegionInstanceGroupManagersStartInstancesRequest extends \Google\Protobuf\Internal\Message { /** - * The URLs of one or more instances to start. This can be a full URL or a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. + * The URLs of one or more instances to start. This can be a full URL or + * a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. * * Generated from protobuf field repeated string instances = 29097598; */ @@ -28,7 +29,8 @@ class RegionInstanceGroupManagersStartInstancesRequest extends \Google\Protobuf\ * Optional. Data for populating the Message object. * * @type array|\Google\Protobuf\Internal\RepeatedField $instances - * The URLs of one or more instances to start. This can be a full URL or a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. + * The URLs of one or more instances to start. This can be a full URL or + * a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. * } */ public function __construct($data = NULL) { @@ -37,7 +39,8 @@ public function __construct($data = NULL) { } /** - * The URLs of one or more instances to start. This can be a full URL or a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. + * The URLs of one or more instances to start. This can be a full URL or + * a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. * * Generated from protobuf field repeated string instances = 29097598; * @return \Google\Protobuf\Internal\RepeatedField @@ -48,7 +51,8 @@ public function getInstances() } /** - * The URLs of one or more instances to start. This can be a full URL or a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. + * The URLs of one or more instances to start. This can be a full URL or + * a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. * * Generated from protobuf field repeated string instances = 29097598; * @param array|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/RegionInstanceGroupManagersStopInstancesRequest.php b/Compute/src/V1/RegionInstanceGroupManagersStopInstancesRequest.php index 080161f5260e..1bcbd8beda92 100644 --- a/Compute/src/V1/RegionInstanceGroupManagersStopInstancesRequest.php +++ b/Compute/src/V1/RegionInstanceGroupManagersStopInstancesRequest.php @@ -15,13 +15,15 @@ class RegionInstanceGroupManagersStopInstancesRequest extends \Google\Protobuf\Internal\Message { /** - * If this flag is set to true, the Instance Group Manager will proceed to stop the instances, skipping initialization on them. + * If this flag is set to true, the Instance Group Manager will proceed to + * stop the instances, skipping initialization on them. * * Generated from protobuf field optional bool force_stop = 134762710; */ protected $force_stop = null; /** - * The URLs of one or more instances to stop. This can be a full URL or a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. + * The URLs of one or more instances to stop. This can be a full URL or + * a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. * * Generated from protobuf field repeated string instances = 29097598; */ @@ -34,9 +36,11 @@ class RegionInstanceGroupManagersStopInstancesRequest extends \Google\Protobuf\I * Optional. Data for populating the Message object. * * @type bool $force_stop - * If this flag is set to true, the Instance Group Manager will proceed to stop the instances, skipping initialization on them. + * If this flag is set to true, the Instance Group Manager will proceed to + * stop the instances, skipping initialization on them. * @type array|\Google\Protobuf\Internal\RepeatedField $instances - * The URLs of one or more instances to stop. This can be a full URL or a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. + * The URLs of one or more instances to stop. This can be a full URL or + * a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. * } */ public function __construct($data = NULL) { @@ -45,7 +49,8 @@ public function __construct($data = NULL) { } /** - * If this flag is set to true, the Instance Group Manager will proceed to stop the instances, skipping initialization on them. + * If this flag is set to true, the Instance Group Manager will proceed to + * stop the instances, skipping initialization on them. * * Generated from protobuf field optional bool force_stop = 134762710; * @return bool @@ -66,7 +71,8 @@ public function clearForceStop() } /** - * If this flag is set to true, the Instance Group Manager will proceed to stop the instances, skipping initialization on them. + * If this flag is set to true, the Instance Group Manager will proceed to + * stop the instances, skipping initialization on them. * * Generated from protobuf field optional bool force_stop = 134762710; * @param bool $var @@ -81,7 +87,8 @@ public function setForceStop($var) } /** - * The URLs of one or more instances to stop. This can be a full URL or a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. + * The URLs of one or more instances to stop. This can be a full URL or + * a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. * * Generated from protobuf field repeated string instances = 29097598; * @return \Google\Protobuf\Internal\RepeatedField @@ -92,7 +99,8 @@ public function getInstances() } /** - * The URLs of one or more instances to stop. This can be a full URL or a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. + * The URLs of one or more instances to stop. This can be a full URL or + * a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. * * Generated from protobuf field repeated string instances = 29097598; * @param array|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/RegionInstanceGroupManagersSuspendInstancesRequest.php b/Compute/src/V1/RegionInstanceGroupManagersSuspendInstancesRequest.php index 0d18c2261d06..9b2d2219e73d 100644 --- a/Compute/src/V1/RegionInstanceGroupManagersSuspendInstancesRequest.php +++ b/Compute/src/V1/RegionInstanceGroupManagersSuspendInstancesRequest.php @@ -15,13 +15,15 @@ class RegionInstanceGroupManagersSuspendInstancesRequest extends \Google\Protobuf\Internal\Message { /** - * If this flag is set to true, the Instance Group Manager will proceed to suspend the instances, skipping initialization on them. + * If this flag is set to true, the Instance Group Manager will proceed to + * suspend the instances, skipping initialization on them. * * Generated from protobuf field optional bool force_suspend = 27637480; */ protected $force_suspend = null; /** - * The URLs of one or more instances to suspend. This can be a full URL or a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. + * The URLs of one or more instances to suspend. This can be a full URL or + * a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. * * Generated from protobuf field repeated string instances = 29097598; */ @@ -34,9 +36,11 @@ class RegionInstanceGroupManagersSuspendInstancesRequest extends \Google\Protobu * Optional. Data for populating the Message object. * * @type bool $force_suspend - * If this flag is set to true, the Instance Group Manager will proceed to suspend the instances, skipping initialization on them. + * If this flag is set to true, the Instance Group Manager will proceed to + * suspend the instances, skipping initialization on them. * @type array|\Google\Protobuf\Internal\RepeatedField $instances - * The URLs of one or more instances to suspend. This can be a full URL or a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. + * The URLs of one or more instances to suspend. This can be a full URL or + * a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. * } */ public function __construct($data = NULL) { @@ -45,7 +49,8 @@ public function __construct($data = NULL) { } /** - * If this flag is set to true, the Instance Group Manager will proceed to suspend the instances, skipping initialization on them. + * If this flag is set to true, the Instance Group Manager will proceed to + * suspend the instances, skipping initialization on them. * * Generated from protobuf field optional bool force_suspend = 27637480; * @return bool @@ -66,7 +71,8 @@ public function clearForceSuspend() } /** - * If this flag is set to true, the Instance Group Manager will proceed to suspend the instances, skipping initialization on them. + * If this flag is set to true, the Instance Group Manager will proceed to + * suspend the instances, skipping initialization on them. * * Generated from protobuf field optional bool force_suspend = 27637480; * @param bool $var @@ -81,7 +87,8 @@ public function setForceSuspend($var) } /** - * The URLs of one or more instances to suspend. This can be a full URL or a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. + * The URLs of one or more instances to suspend. This can be a full URL or + * a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. * * Generated from protobuf field repeated string instances = 29097598; * @return \Google\Protobuf\Internal\RepeatedField @@ -92,7 +99,8 @@ public function getInstances() } /** - * The URLs of one or more instances to suspend. This can be a full URL or a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. + * The URLs of one or more instances to suspend. This can be a full URL or + * a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. * * Generated from protobuf field repeated string instances = 29097598; * @param array|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/RegionInstanceGroupsListInstances.php b/Compute/src/V1/RegionInstanceGroupsListInstances.php index e0a1ba1117d6..7f7ebb66d98b 100644 --- a/Compute/src/V1/RegionInstanceGroupsListInstances.php +++ b/Compute/src/V1/RegionInstanceGroupsListInstances.php @@ -33,7 +33,11 @@ class RegionInstanceGroupsListInstances extends \Google\Protobuf\Internal\Messag */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -64,7 +68,11 @@ class RegionInstanceGroupsListInstances extends \Google\Protobuf\Internal\Messag * @type string $kind * The resource type. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type \Google\Cloud\Compute\V1\Warning $warning @@ -175,7 +183,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -196,7 +208,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/RegionInstanceGroupsListInstancesRequest.php b/Compute/src/V1/RegionInstanceGroupsListInstancesRequest.php index 9ccc34502461..588ee1a8f8ab 100644 --- a/Compute/src/V1/RegionInstanceGroupsListInstancesRequest.php +++ b/Compute/src/V1/RegionInstanceGroupsListInstancesRequest.php @@ -15,14 +15,18 @@ class RegionInstanceGroupsListInstancesRequest extends \Google\Protobuf\Internal\Message { /** - * Instances in which state should be returned. Valid options are: 'ALL', 'RUNNING'. By default, it lists all instances. + * Instances in which state should be returned. Valid options are: + * 'ALL', 'RUNNING'. By default, it lists all instances. * Check the InstanceState enum for the list of possible values. * * Generated from protobuf field optional string instance_state = 92223591; */ protected $instance_state = null; /** - * Name of port user is interested in. It is optional. If it is set, only information about this ports will be returned. If it is not set, all the named ports will be returned. Always lists all instances. + * Name of port user is interested in. It is optional. If it is set, only + * information about this ports will be returned. If it is not set, all the + * named ports will be returned. + * Always lists all instances. * * Generated from protobuf field optional string port_name = 41534345; */ @@ -35,10 +39,14 @@ class RegionInstanceGroupsListInstancesRequest extends \Google\Protobuf\Internal * Optional. Data for populating the Message object. * * @type string $instance_state - * Instances in which state should be returned. Valid options are: 'ALL', 'RUNNING'. By default, it lists all instances. + * Instances in which state should be returned. Valid options are: + * 'ALL', 'RUNNING'. By default, it lists all instances. * Check the InstanceState enum for the list of possible values. * @type string $port_name - * Name of port user is interested in. It is optional. If it is set, only information about this ports will be returned. If it is not set, all the named ports will be returned. Always lists all instances. + * Name of port user is interested in. It is optional. If it is set, only + * information about this ports will be returned. If it is not set, all the + * named ports will be returned. + * Always lists all instances. * } */ public function __construct($data = NULL) { @@ -47,7 +55,8 @@ public function __construct($data = NULL) { } /** - * Instances in which state should be returned. Valid options are: 'ALL', 'RUNNING'. By default, it lists all instances. + * Instances in which state should be returned. Valid options are: + * 'ALL', 'RUNNING'. By default, it lists all instances. * Check the InstanceState enum for the list of possible values. * * Generated from protobuf field optional string instance_state = 92223591; @@ -69,7 +78,8 @@ public function clearInstanceState() } /** - * Instances in which state should be returned. Valid options are: 'ALL', 'RUNNING'. By default, it lists all instances. + * Instances in which state should be returned. Valid options are: + * 'ALL', 'RUNNING'. By default, it lists all instances. * Check the InstanceState enum for the list of possible values. * * Generated from protobuf field optional string instance_state = 92223591; @@ -85,7 +95,10 @@ public function setInstanceState($var) } /** - * Name of port user is interested in. It is optional. If it is set, only information about this ports will be returned. If it is not set, all the named ports will be returned. Always lists all instances. + * Name of port user is interested in. It is optional. If it is set, only + * information about this ports will be returned. If it is not set, all the + * named ports will be returned. + * Always lists all instances. * * Generated from protobuf field optional string port_name = 41534345; * @return string @@ -106,7 +119,10 @@ public function clearPortName() } /** - * Name of port user is interested in. It is optional. If it is set, only information about this ports will be returned. If it is not set, all the named ports will be returned. Always lists all instances. + * Name of port user is interested in. It is optional. If it is set, only + * information about this ports will be returned. If it is not set, all the + * named ports will be returned. + * Always lists all instances. * * Generated from protobuf field optional string port_name = 41534345; * @param string $var diff --git a/Compute/src/V1/RegionInstanceGroupsListInstancesRequest/InstanceState.php b/Compute/src/V1/RegionInstanceGroupsListInstancesRequest/InstanceState.php index 4a96e74c6869..ec4c04fa4774 100644 --- a/Compute/src/V1/RegionInstanceGroupsListInstancesRequest/InstanceState.php +++ b/Compute/src/V1/RegionInstanceGroupsListInstancesRequest/InstanceState.php @@ -7,7 +7,8 @@ use UnexpectedValueException; /** - * Instances in which state should be returned. Valid options are: 'ALL', 'RUNNING'. By default, it lists all instances. + * Instances in which state should be returned. Valid options are: + * 'ALL', 'RUNNING'. By default, it lists all instances. * * Protobuf type google.cloud.compute.v1.RegionInstanceGroupsListInstancesRequest.InstanceState */ diff --git a/Compute/src/V1/RegionInstanceGroupsSetNamedPortsRequest.php b/Compute/src/V1/RegionInstanceGroupsSetNamedPortsRequest.php index 6bcf0fabd915..9d33049f9152 100644 --- a/Compute/src/V1/RegionInstanceGroupsSetNamedPortsRequest.php +++ b/Compute/src/V1/RegionInstanceGroupsSetNamedPortsRequest.php @@ -15,7 +15,12 @@ class RegionInstanceGroupsSetNamedPortsRequest extends \Google\Protobuf\Internal\Message { /** - * The fingerprint of the named ports information for this instance group. Use this optional property to prevent conflicts when multiple users change the named ports settings concurrently. Obtain the fingerprint with the instanceGroups.get method. Then, include the fingerprint in your request to ensure that you do not overwrite changes that were applied from another concurrent request. + * The fingerprint of the named ports information for this instance group. + * Use this optional property to prevent conflicts when multiple users change + * the named ports settings concurrently. Obtain the fingerprint with theinstanceGroups.get + * method. Then, include the fingerprint in your request to ensure that you + * do not overwrite changes that were applied from another + * concurrent request. * * Generated from protobuf field optional string fingerprint = 234678500; */ @@ -34,7 +39,12 @@ class RegionInstanceGroupsSetNamedPortsRequest extends \Google\Protobuf\Internal * Optional. Data for populating the Message object. * * @type string $fingerprint - * The fingerprint of the named ports information for this instance group. Use this optional property to prevent conflicts when multiple users change the named ports settings concurrently. Obtain the fingerprint with the instanceGroups.get method. Then, include the fingerprint in your request to ensure that you do not overwrite changes that were applied from another concurrent request. + * The fingerprint of the named ports information for this instance group. + * Use this optional property to prevent conflicts when multiple users change + * the named ports settings concurrently. Obtain the fingerprint with theinstanceGroups.get + * method. Then, include the fingerprint in your request to ensure that you + * do not overwrite changes that were applied from another + * concurrent request. * @type array<\Google\Cloud\Compute\V1\NamedPort>|\Google\Protobuf\Internal\RepeatedField $named_ports * The list of named ports to set for this instance group. * } @@ -45,7 +55,12 @@ public function __construct($data = NULL) { } /** - * The fingerprint of the named ports information for this instance group. Use this optional property to prevent conflicts when multiple users change the named ports settings concurrently. Obtain the fingerprint with the instanceGroups.get method. Then, include the fingerprint in your request to ensure that you do not overwrite changes that were applied from another concurrent request. + * The fingerprint of the named ports information for this instance group. + * Use this optional property to prevent conflicts when multiple users change + * the named ports settings concurrently. Obtain the fingerprint with theinstanceGroups.get + * method. Then, include the fingerprint in your request to ensure that you + * do not overwrite changes that were applied from another + * concurrent request. * * Generated from protobuf field optional string fingerprint = 234678500; * @return string @@ -66,7 +81,12 @@ public function clearFingerprint() } /** - * The fingerprint of the named ports information for this instance group. Use this optional property to prevent conflicts when multiple users change the named ports settings concurrently. Obtain the fingerprint with the instanceGroups.get method. Then, include the fingerprint in your request to ensure that you do not overwrite changes that were applied from another concurrent request. + * The fingerprint of the named ports information for this instance group. + * Use this optional property to prevent conflicts when multiple users change + * the named ports settings concurrently. Obtain the fingerprint with theinstanceGroups.get + * method. Then, include the fingerprint in your request to ensure that you + * do not overwrite changes that were applied from another + * concurrent request. * * Generated from protobuf field optional string fingerprint = 234678500; * @param string $var diff --git a/Compute/src/V1/RegionList.php b/Compute/src/V1/RegionList.php index 5fc04b3ec34f..911b484e539a 100644 --- a/Compute/src/V1/RegionList.php +++ b/Compute/src/V1/RegionList.php @@ -28,13 +28,18 @@ class RegionList extends \Google\Protobuf\Internal\Message */ private $items; /** - * [Output Only] Type of resource. Always compute#regionList for lists of regions. + * [Output Only] Type of resource. Always compute#regionList for + * lists of regions. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -63,9 +68,14 @@ class RegionList extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\Region>|\Google\Protobuf\Internal\RepeatedField $items * A list of Region resources. * @type string $kind - * [Output Only] Type of resource. Always compute#regionList for lists of regions. + * [Output Only] Type of resource. Always compute#regionList for + * lists of regions. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type \Google\Cloud\Compute\V1\Warning $warning @@ -140,7 +150,8 @@ public function setItems($var) } /** - * [Output Only] Type of resource. Always compute#regionList for lists of regions. + * [Output Only] Type of resource. Always compute#regionList for + * lists of regions. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -161,7 +172,8 @@ public function clearKind() } /** - * [Output Only] Type of resource. Always compute#regionList for lists of regions. + * [Output Only] Type of resource. Always compute#regionList for + * lists of regions. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -176,7 +188,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -197,7 +213,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/RegionNetworkFirewallPoliciesGetEffectiveFirewallsResponse.php b/Compute/src/V1/RegionNetworkFirewallPoliciesGetEffectiveFirewallsResponse.php index 4da35401010d..93ad7fdbc66b 100644 --- a/Compute/src/V1/RegionNetworkFirewallPoliciesGetEffectiveFirewallsResponse.php +++ b/Compute/src/V1/RegionNetworkFirewallPoliciesGetEffectiveFirewallsResponse.php @@ -15,7 +15,10 @@ class RegionNetworkFirewallPoliciesGetEffectiveFirewallsResponse extends \Google\Protobuf\Internal\Message { /** - * [Output only] Effective firewalls from firewall policy. It applies to Regional Network Firewall Policies in the specified region, Global Network Firewall Policies and Hierachial Firewall Policies which are associated with the network. + * [Output only] Effective firewalls from firewall policy. It applies to + * Regional Network Firewall Policies in the specified region, Global Network + * Firewall Policies and Hierachial Firewall Policies which are associated + * with the network. * * Generated from protobuf field repeated .google.cloud.compute.v1.RegionNetworkFirewallPoliciesGetEffectiveFirewallsResponseEffectiveFirewallPolicy firewall_policys = 410985794; */ @@ -34,7 +37,10 @@ class RegionNetworkFirewallPoliciesGetEffectiveFirewallsResponse extends \Google * Optional. Data for populating the Message object. * * @type array<\Google\Cloud\Compute\V1\RegionNetworkFirewallPoliciesGetEffectiveFirewallsResponseEffectiveFirewallPolicy>|\Google\Protobuf\Internal\RepeatedField $firewall_policys - * [Output only] Effective firewalls from firewall policy. It applies to Regional Network Firewall Policies in the specified region, Global Network Firewall Policies and Hierachial Firewall Policies which are associated with the network. + * [Output only] Effective firewalls from firewall policy. It applies to + * Regional Network Firewall Policies in the specified region, Global Network + * Firewall Policies and Hierachial Firewall Policies which are associated + * with the network. * @type array<\Google\Cloud\Compute\V1\Firewall>|\Google\Protobuf\Internal\RepeatedField $firewalls * Effective firewalls on the network. * } @@ -45,7 +51,10 @@ public function __construct($data = NULL) { } /** - * [Output only] Effective firewalls from firewall policy. It applies to Regional Network Firewall Policies in the specified region, Global Network Firewall Policies and Hierachial Firewall Policies which are associated with the network. + * [Output only] Effective firewalls from firewall policy. It applies to + * Regional Network Firewall Policies in the specified region, Global Network + * Firewall Policies and Hierachial Firewall Policies which are associated + * with the network. * * Generated from protobuf field repeated .google.cloud.compute.v1.RegionNetworkFirewallPoliciesGetEffectiveFirewallsResponseEffectiveFirewallPolicy firewall_policys = 410985794; * @return \Google\Protobuf\Internal\RepeatedField @@ -56,7 +65,10 @@ public function getFirewallPolicys() } /** - * [Output only] Effective firewalls from firewall policy. It applies to Regional Network Firewall Policies in the specified region, Global Network Firewall Policies and Hierachial Firewall Policies which are associated with the network. + * [Output only] Effective firewalls from firewall policy. It applies to + * Regional Network Firewall Policies in the specified region, Global Network + * Firewall Policies and Hierachial Firewall Policies which are associated + * with the network. * * Generated from protobuf field repeated .google.cloud.compute.v1.RegionNetworkFirewallPoliciesGetEffectiveFirewallsResponseEffectiveFirewallPolicy firewall_policys = 410985794; * @param array<\Google\Cloud\Compute\V1\RegionNetworkFirewallPoliciesGetEffectiveFirewallsResponseEffectiveFirewallPolicy>|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/RegionNetworkFirewallPoliciesGetEffectiveFirewallsResponseEffectiveFirewallPolicy.php b/Compute/src/V1/RegionNetworkFirewallPoliciesGetEffectiveFirewallsResponseEffectiveFirewallPolicy.php index 84f8652b7335..73f58c5fdbf4 100644 --- a/Compute/src/V1/RegionNetworkFirewallPoliciesGetEffectiveFirewallsResponseEffectiveFirewallPolicy.php +++ b/Compute/src/V1/RegionNetworkFirewallPoliciesGetEffectiveFirewallsResponseEffectiveFirewallPolicy.php @@ -33,7 +33,8 @@ class RegionNetworkFirewallPoliciesGetEffectiveFirewallsResponseEffectiveFirewal */ private $packet_mirroring_rules; /** - * [Output only] Priority of firewall policy association. Not applicable for type=HIERARCHY. + * [Output only] Priority of firewall policy association. Not applicable for + * type=HIERARCHY. * * Generated from protobuf field optional int32 priority = 445151652; */ @@ -45,7 +46,8 @@ class RegionNetworkFirewallPoliciesGetEffectiveFirewallsResponseEffectiveFirewal */ private $rules; /** - * [Output Only] The type of the firewall policy. Can be one of HIERARCHY, NETWORK, NETWORK_REGIONAL, SYSTEM_GLOBAL, SYSTEM_REGIONAL. + * [Output Only] The type of the firewall policy. Can be one of HIERARCHY, + * NETWORK, NETWORK_REGIONAL, SYSTEM_GLOBAL, SYSTEM_REGIONAL. * Check the Type enum for the list of possible values. * * Generated from protobuf field optional string type = 3575610; @@ -65,11 +67,13 @@ class RegionNetworkFirewallPoliciesGetEffectiveFirewallsResponseEffectiveFirewal * @type array<\Google\Cloud\Compute\V1\FirewallPolicyRule>|\Google\Protobuf\Internal\RepeatedField $packet_mirroring_rules * [Output only] The packet mirroring rules that apply to the network. * @type int $priority - * [Output only] Priority of firewall policy association. Not applicable for type=HIERARCHY. + * [Output only] Priority of firewall policy association. Not applicable for + * type=HIERARCHY. * @type array<\Google\Cloud\Compute\V1\FirewallPolicyRule>|\Google\Protobuf\Internal\RepeatedField $rules * [Output only] The rules that apply to the network. * @type string $type - * [Output Only] The type of the firewall policy. Can be one of HIERARCHY, NETWORK, NETWORK_REGIONAL, SYSTEM_GLOBAL, SYSTEM_REGIONAL. + * [Output Only] The type of the firewall policy. Can be one of HIERARCHY, + * NETWORK, NETWORK_REGIONAL, SYSTEM_GLOBAL, SYSTEM_REGIONAL. * Check the Type enum for the list of possible values. * } */ @@ -177,7 +181,8 @@ public function setPacketMirroringRules($var) } /** - * [Output only] Priority of firewall policy association. Not applicable for type=HIERARCHY. + * [Output only] Priority of firewall policy association. Not applicable for + * type=HIERARCHY. * * Generated from protobuf field optional int32 priority = 445151652; * @return int @@ -198,7 +203,8 @@ public function clearPriority() } /** - * [Output only] Priority of firewall policy association. Not applicable for type=HIERARCHY. + * [Output only] Priority of firewall policy association. Not applicable for + * type=HIERARCHY. * * Generated from protobuf field optional int32 priority = 445151652; * @param int $var @@ -239,7 +245,8 @@ public function setRules($var) } /** - * [Output Only] The type of the firewall policy. Can be one of HIERARCHY, NETWORK, NETWORK_REGIONAL, SYSTEM_GLOBAL, SYSTEM_REGIONAL. + * [Output Only] The type of the firewall policy. Can be one of HIERARCHY, + * NETWORK, NETWORK_REGIONAL, SYSTEM_GLOBAL, SYSTEM_REGIONAL. * Check the Type enum for the list of possible values. * * Generated from protobuf field optional string type = 3575610; @@ -261,7 +268,8 @@ public function clearType() } /** - * [Output Only] The type of the firewall policy. Can be one of HIERARCHY, NETWORK, NETWORK_REGIONAL, SYSTEM_GLOBAL, SYSTEM_REGIONAL. + * [Output Only] The type of the firewall policy. Can be one of HIERARCHY, + * NETWORK, NETWORK_REGIONAL, SYSTEM_GLOBAL, SYSTEM_REGIONAL. * Check the Type enum for the list of possible values. * * Generated from protobuf field optional string type = 3575610; diff --git a/Compute/src/V1/RegionNetworkFirewallPoliciesGetEffectiveFirewallsResponseEffectiveFirewallPolicy/Type.php b/Compute/src/V1/RegionNetworkFirewallPoliciesGetEffectiveFirewallsResponseEffectiveFirewallPolicy/Type.php index e2d0b09f5957..a7332164331a 100644 --- a/Compute/src/V1/RegionNetworkFirewallPoliciesGetEffectiveFirewallsResponseEffectiveFirewallPolicy/Type.php +++ b/Compute/src/V1/RegionNetworkFirewallPoliciesGetEffectiveFirewallsResponseEffectiveFirewallPolicy/Type.php @@ -7,7 +7,8 @@ use UnexpectedValueException; /** - * [Output Only] The type of the firewall policy. Can be one of HIERARCHY, NETWORK, NETWORK_REGIONAL, SYSTEM_GLOBAL, SYSTEM_REGIONAL. + * [Output Only] The type of the firewall policy. Can be one of HIERARCHY, + * NETWORK, NETWORK_REGIONAL, SYSTEM_GLOBAL, SYSTEM_REGIONAL. * * Protobuf type google.cloud.compute.v1.RegionNetworkFirewallPoliciesGetEffectiveFirewallsResponseEffectiveFirewallPolicy.Type */ diff --git a/Compute/src/V1/RegionSetLabelsRequest.php b/Compute/src/V1/RegionSetLabelsRequest.php index 70a97e1faf49..e0176599e029 100644 --- a/Compute/src/V1/RegionSetLabelsRequest.php +++ b/Compute/src/V1/RegionSetLabelsRequest.php @@ -15,7 +15,12 @@ class RegionSetLabelsRequest extends \Google\Protobuf\Internal\Message { /** - * The fingerprint of the previous set of labels for this resource, used to detect conflicts. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels. Make a get() request to the resource to get the latest fingerprint. + * The fingerprint of the previous set of labels for this resource, + * used to detect conflicts. The fingerprint is initially generated by Compute + * Engine and changes after every request to modify or update labels. You must + * always provide an up-to-date fingerprint hash in order to update or change + * labels. Make a get() request to the resource to get the latest + * fingerprint. * * Generated from protobuf field optional string label_fingerprint = 178124825; */ @@ -34,7 +39,12 @@ class RegionSetLabelsRequest extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $label_fingerprint - * The fingerprint of the previous set of labels for this resource, used to detect conflicts. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels. Make a get() request to the resource to get the latest fingerprint. + * The fingerprint of the previous set of labels for this resource, + * used to detect conflicts. The fingerprint is initially generated by Compute + * Engine and changes after every request to modify or update labels. You must + * always provide an up-to-date fingerprint hash in order to update or change + * labels. Make a get() request to the resource to get the latest + * fingerprint. * @type array|\Google\Protobuf\Internal\MapField $labels * The labels to set for this resource. * } @@ -45,7 +55,12 @@ public function __construct($data = NULL) { } /** - * The fingerprint of the previous set of labels for this resource, used to detect conflicts. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels. Make a get() request to the resource to get the latest fingerprint. + * The fingerprint of the previous set of labels for this resource, + * used to detect conflicts. The fingerprint is initially generated by Compute + * Engine and changes after every request to modify or update labels. You must + * always provide an up-to-date fingerprint hash in order to update or change + * labels. Make a get() request to the resource to get the latest + * fingerprint. * * Generated from protobuf field optional string label_fingerprint = 178124825; * @return string @@ -66,7 +81,12 @@ public function clearLabelFingerprint() } /** - * The fingerprint of the previous set of labels for this resource, used to detect conflicts. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels. Make a get() request to the resource to get the latest fingerprint. + * The fingerprint of the previous set of labels for this resource, + * used to detect conflicts. The fingerprint is initially generated by Compute + * Engine and changes after every request to modify or update labels. You must + * always provide an up-to-date fingerprint hash in order to update or change + * labels. Make a get() request to the resource to get the latest + * fingerprint. * * Generated from protobuf field optional string label_fingerprint = 178124825; * @param string $var diff --git a/Compute/src/V1/RegionSetPolicyRequest.php b/Compute/src/V1/RegionSetPolicyRequest.php index e94a987b507d..e6c6563c2e39 100644 --- a/Compute/src/V1/RegionSetPolicyRequest.php +++ b/Compute/src/V1/RegionSetPolicyRequest.php @@ -15,19 +15,23 @@ class RegionSetPolicyRequest extends \Google\Protobuf\Internal\Message { /** - * Flatten Policy to create a backwacd compatible wire-format. Deprecated. Use 'policy' to specify bindings. + * Flatten Policy to create a backwacd compatible wire-format. + * Deprecated. Use 'policy' to specify bindings. * * Generated from protobuf field repeated .google.cloud.compute.v1.Binding bindings = 403251854; */ private $bindings; /** - * Flatten Policy to create a backward compatible wire-format. Deprecated. Use 'policy' to specify the etag. + * Flatten Policy to create a backward compatible wire-format. + * Deprecated. Use 'policy' to specify the etag. * * Generated from protobuf field optional string etag = 3123477; */ protected $etag = null; /** - * REQUIRED: The complete policy to be applied to the 'resource'. The size of the policy is limited to a few 10s of KB. An empty policy is in general a valid policy but certain services (like Projects) might reject them. + * REQUIRED: The complete policy to be applied to the 'resource'. The size of + * the policy is limited to a few 10s of KB. An empty policy is in general a + * valid policy but certain services (like Projects) might reject them. * * Generated from protobuf field optional .google.cloud.compute.v1.Policy policy = 91071794; */ @@ -40,11 +44,15 @@ class RegionSetPolicyRequest extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type array<\Google\Cloud\Compute\V1\Binding>|\Google\Protobuf\Internal\RepeatedField $bindings - * Flatten Policy to create a backwacd compatible wire-format. Deprecated. Use 'policy' to specify bindings. + * Flatten Policy to create a backwacd compatible wire-format. + * Deprecated. Use 'policy' to specify bindings. * @type string $etag - * Flatten Policy to create a backward compatible wire-format. Deprecated. Use 'policy' to specify the etag. + * Flatten Policy to create a backward compatible wire-format. + * Deprecated. Use 'policy' to specify the etag. * @type \Google\Cloud\Compute\V1\Policy $policy - * REQUIRED: The complete policy to be applied to the 'resource'. The size of the policy is limited to a few 10s of KB. An empty policy is in general a valid policy but certain services (like Projects) might reject them. + * REQUIRED: The complete policy to be applied to the 'resource'. The size of + * the policy is limited to a few 10s of KB. An empty policy is in general a + * valid policy but certain services (like Projects) might reject them. * } */ public function __construct($data = NULL) { @@ -53,7 +61,8 @@ public function __construct($data = NULL) { } /** - * Flatten Policy to create a backwacd compatible wire-format. Deprecated. Use 'policy' to specify bindings. + * Flatten Policy to create a backwacd compatible wire-format. + * Deprecated. Use 'policy' to specify bindings. * * Generated from protobuf field repeated .google.cloud.compute.v1.Binding bindings = 403251854; * @return \Google\Protobuf\Internal\RepeatedField @@ -64,7 +73,8 @@ public function getBindings() } /** - * Flatten Policy to create a backwacd compatible wire-format. Deprecated. Use 'policy' to specify bindings. + * Flatten Policy to create a backwacd compatible wire-format. + * Deprecated. Use 'policy' to specify bindings. * * Generated from protobuf field repeated .google.cloud.compute.v1.Binding bindings = 403251854; * @param array<\Google\Cloud\Compute\V1\Binding>|\Google\Protobuf\Internal\RepeatedField $var @@ -79,7 +89,8 @@ public function setBindings($var) } /** - * Flatten Policy to create a backward compatible wire-format. Deprecated. Use 'policy' to specify the etag. + * Flatten Policy to create a backward compatible wire-format. + * Deprecated. Use 'policy' to specify the etag. * * Generated from protobuf field optional string etag = 3123477; * @return string @@ -100,7 +111,8 @@ public function clearEtag() } /** - * Flatten Policy to create a backward compatible wire-format. Deprecated. Use 'policy' to specify the etag. + * Flatten Policy to create a backward compatible wire-format. + * Deprecated. Use 'policy' to specify the etag. * * Generated from protobuf field optional string etag = 3123477; * @param string $var @@ -115,7 +127,9 @@ public function setEtag($var) } /** - * REQUIRED: The complete policy to be applied to the 'resource'. The size of the policy is limited to a few 10s of KB. An empty policy is in general a valid policy but certain services (like Projects) might reject them. + * REQUIRED: The complete policy to be applied to the 'resource'. The size of + * the policy is limited to a few 10s of KB. An empty policy is in general a + * valid policy but certain services (like Projects) might reject them. * * Generated from protobuf field optional .google.cloud.compute.v1.Policy policy = 91071794; * @return \Google\Cloud\Compute\V1\Policy|null @@ -136,7 +150,9 @@ public function clearPolicy() } /** - * REQUIRED: The complete policy to be applied to the 'resource'. The size of the policy is limited to a few 10s of KB. An empty policy is in general a valid policy but certain services (like Projects) might reject them. + * REQUIRED: The complete policy to be applied to the 'resource'. The size of + * the policy is limited to a few 10s of KB. An empty policy is in general a + * valid policy but certain services (like Projects) might reject them. * * Generated from protobuf field optional .google.cloud.compute.v1.Policy policy = 91071794; * @param \Google\Cloud\Compute\V1\Policy $var diff --git a/Compute/src/V1/RegionTargetHttpsProxiesSetSslCertificatesRequest.php b/Compute/src/V1/RegionTargetHttpsProxiesSetSslCertificatesRequest.php index 82f363bf881e..90dc1356beb7 100644 --- a/Compute/src/V1/RegionTargetHttpsProxiesSetSslCertificatesRequest.php +++ b/Compute/src/V1/RegionTargetHttpsProxiesSetSslCertificatesRequest.php @@ -15,7 +15,8 @@ class RegionTargetHttpsProxiesSetSslCertificatesRequest extends \Google\Protobuf\Internal\Message { /** - * New set of SslCertificate resources to associate with this TargetHttpsProxy resource. + * New set of SslCertificate resources to associate + * with this TargetHttpsProxy resource. * * Generated from protobuf field repeated string ssl_certificates = 366006543; */ @@ -28,7 +29,8 @@ class RegionTargetHttpsProxiesSetSslCertificatesRequest extends \Google\Protobuf * Optional. Data for populating the Message object. * * @type array|\Google\Protobuf\Internal\RepeatedField $ssl_certificates - * New set of SslCertificate resources to associate with this TargetHttpsProxy resource. + * New set of SslCertificate resources to associate + * with this TargetHttpsProxy resource. * } */ public function __construct($data = NULL) { @@ -37,7 +39,8 @@ public function __construct($data = NULL) { } /** - * New set of SslCertificate resources to associate with this TargetHttpsProxy resource. + * New set of SslCertificate resources to associate + * with this TargetHttpsProxy resource. * * Generated from protobuf field repeated string ssl_certificates = 366006543; * @return \Google\Protobuf\Internal\RepeatedField @@ -48,7 +51,8 @@ public function getSslCertificates() } /** - * New set of SslCertificate resources to associate with this TargetHttpsProxy resource. + * New set of SslCertificate resources to associate + * with this TargetHttpsProxy resource. * * Generated from protobuf field repeated string ssl_certificates = 366006543; * @param array|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/RemoveAssociationFirewallPolicyRequest.php b/Compute/src/V1/RemoveAssociationFirewallPolicyRequest.php index 03e2b6d5e9d0..abffa2558e3e 100644 --- a/Compute/src/V1/RemoveAssociationFirewallPolicyRequest.php +++ b/Compute/src/V1/RemoveAssociationFirewallPolicyRequest.php @@ -28,7 +28,17 @@ class RemoveAssociationFirewallPolicyRequest extends \Google\Protobuf\Internal\M */ protected $name = null; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -58,7 +68,17 @@ public static function build(string $firewallPolicy): self * @type string $name * Name for the attachment that will be removed. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -129,7 +149,17 @@ public function setName($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -150,7 +180,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/RemoveAssociationNetworkFirewallPolicyRequest.php b/Compute/src/V1/RemoveAssociationNetworkFirewallPolicyRequest.php index fdc0ca3fbaac..6066eeeb44f8 100644 --- a/Compute/src/V1/RemoveAssociationNetworkFirewallPolicyRequest.php +++ b/Compute/src/V1/RemoveAssociationNetworkFirewallPolicyRequest.php @@ -34,7 +34,17 @@ class RemoveAssociationNetworkFirewallPolicyRequest extends \Google\Protobuf\Int */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -68,7 +78,17 @@ public static function build(string $project, string $firewallPolicy): self * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -165,7 +185,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -186,7 +216,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/RemoveAssociationOrganizationSecurityPolicyRequest.php b/Compute/src/V1/RemoveAssociationOrganizationSecurityPolicyRequest.php index c7b9c0fb16e0..4eae564b2a33 100644 --- a/Compute/src/V1/RemoveAssociationOrganizationSecurityPolicyRequest.php +++ b/Compute/src/V1/RemoveAssociationOrganizationSecurityPolicyRequest.php @@ -22,7 +22,17 @@ class RemoveAssociationOrganizationSecurityPolicyRequest extends \Google\Protobu */ protected $name = null; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -56,7 +66,17 @@ public static function build(string $securityPolicy): self * @type string $name * Name for the attachment that will be removed. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $security_policy * Name of the security policy to update. * } @@ -103,7 +123,17 @@ public function setName($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -124,7 +154,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/RemoveAssociationRegionNetworkFirewallPolicyRequest.php b/Compute/src/V1/RemoveAssociationRegionNetworkFirewallPolicyRequest.php index 79c3e3d27bd1..c9b0650eb929 100644 --- a/Compute/src/V1/RemoveAssociationRegionNetworkFirewallPolicyRequest.php +++ b/Compute/src/V1/RemoveAssociationRegionNetworkFirewallPolicyRequest.php @@ -40,7 +40,17 @@ class RemoveAssociationRegionNetworkFirewallPolicyRequest extends \Google\Protob */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -78,7 +88,17 @@ public static function build(string $project, string $region, string $firewallPo * @type string $region * Name of the region scoping this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -201,7 +221,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -222,7 +252,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/RemoveHealthCheckTargetPoolRequest.php b/Compute/src/V1/RemoveHealthCheckTargetPoolRequest.php index 7a7643ddd26f..6a099905987c 100644 --- a/Compute/src/V1/RemoveHealthCheckTargetPoolRequest.php +++ b/Compute/src/V1/RemoveHealthCheckTargetPoolRequest.php @@ -28,7 +28,17 @@ class RemoveHealthCheckTargetPoolRequest extends \Google\Protobuf\Internal\Messa */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -76,7 +86,17 @@ public static function build(string $project, string $region, string $targetPool * @type string $region * Name of the region for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $target_pool * Name of the target pool to remove health checks from. * @type \Google\Cloud\Compute\V1\TargetPoolsRemoveHealthCheckRequest $target_pools_remove_health_check_request_resource @@ -141,7 +161,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -162,7 +192,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/RemoveInstanceTargetPoolRequest.php b/Compute/src/V1/RemoveInstanceTargetPoolRequest.php index 6cbe66e2cf0b..94d0f266eb47 100644 --- a/Compute/src/V1/RemoveInstanceTargetPoolRequest.php +++ b/Compute/src/V1/RemoveInstanceTargetPoolRequest.php @@ -28,7 +28,17 @@ class RemoveInstanceTargetPoolRequest extends \Google\Protobuf\Internal\Message */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -76,7 +86,17 @@ public static function build(string $project, string $region, string $targetPool * @type string $region * Name of the region scoping this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $target_pool * Name of the TargetPool resource to remove instances from. * @type \Google\Cloud\Compute\V1\TargetPoolsRemoveInstanceRequest $target_pools_remove_instance_request_resource @@ -141,7 +161,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -162,7 +192,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/RemoveInstancesInstanceGroupRequest.php b/Compute/src/V1/RemoveInstancesInstanceGroupRequest.php index 6ee2acd66154..906c6fae525e 100644 --- a/Compute/src/V1/RemoveInstancesInstanceGroupRequest.php +++ b/Compute/src/V1/RemoveInstancesInstanceGroupRequest.php @@ -16,7 +16,8 @@ class RemoveInstancesInstanceGroupRequest extends \Google\Protobuf\Internal\Message { /** - * The name of the instance group where the specified instances will be removed. + * The name of the instance group where the specified instances will be + * removed. * * Generated from protobuf field string instance_group = 81095253 [(.google.api.field_behavior) = REQUIRED]; */ @@ -34,13 +35,24 @@ class RemoveInstancesInstanceGroupRequest extends \Google\Protobuf\Internal\Mess */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ protected $request_id = null; /** - * The name of the zone where the instance group is located. + * The name of the zone + * where the instance group is located. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; */ @@ -48,8 +60,10 @@ class RemoveInstancesInstanceGroupRequest extends \Google\Protobuf\Internal\Mess /** * @param string $project Project ID for this request. - * @param string $zone The name of the zone where the instance group is located. - * @param string $instanceGroup The name of the instance group where the specified instances will be removed. + * @param string $zone The name of the zone + * where the instance group is located. + * @param string $instanceGroup The name of the instance group where the specified instances will be + * removed. * @param \Google\Cloud\Compute\V1\InstanceGroupsRemoveInstancesRequest $instanceGroupsRemoveInstancesRequestResource The body resource for this request * * @return \Google\Cloud\Compute\V1\RemoveInstancesInstanceGroupRequest @@ -72,15 +86,27 @@ public static function build(string $project, string $zone, string $instanceGrou * Optional. Data for populating the Message object. * * @type string $instance_group - * The name of the instance group where the specified instances will be removed. + * The name of the instance group where the specified instances will be + * removed. * @type \Google\Cloud\Compute\V1\InstanceGroupsRemoveInstancesRequest $instance_groups_remove_instances_request_resource * The body resource for this request * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $zone - * The name of the zone where the instance group is located. + * The name of the zone + * where the instance group is located. * } */ public function __construct($data = NULL) { @@ -89,7 +115,8 @@ public function __construct($data = NULL) { } /** - * The name of the instance group where the specified instances will be removed. + * The name of the instance group where the specified instances will be + * removed. * * Generated from protobuf field string instance_group = 81095253 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -100,7 +127,8 @@ public function getInstanceGroup() } /** - * The name of the instance group where the specified instances will be removed. + * The name of the instance group where the specified instances will be + * removed. * * Generated from protobuf field string instance_group = 81095253 [(.google.api.field_behavior) = REQUIRED]; * @param string $var @@ -177,7 +205,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -198,7 +236,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var @@ -213,7 +261,8 @@ public function setRequestId($var) } /** - * The name of the zone where the instance group is located. + * The name of the zone + * where the instance group is located. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; * @return string @@ -224,7 +273,8 @@ public function getZone() } /** - * The name of the zone where the instance group is located. + * The name of the zone + * where the instance group is located. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; * @param string $var diff --git a/Compute/src/V1/RemovePacketMirroringRuleNetworkFirewallPolicyRequest.php b/Compute/src/V1/RemovePacketMirroringRuleNetworkFirewallPolicyRequest.php index c9dc860e1f0d..c4572a5f4b80 100644 --- a/Compute/src/V1/RemovePacketMirroringRuleNetworkFirewallPolicyRequest.php +++ b/Compute/src/V1/RemovePacketMirroringRuleNetworkFirewallPolicyRequest.php @@ -34,7 +34,17 @@ class RemovePacketMirroringRuleNetworkFirewallPolicyRequest extends \Google\Prot */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -68,7 +78,17 @@ public static function build(string $project, string $firewallPolicy): self * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -165,7 +185,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -186,7 +216,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/RemovePeeringNetworkRequest.php b/Compute/src/V1/RemovePeeringNetworkRequest.php index 9006c03e0405..b7866fae0d0c 100644 --- a/Compute/src/V1/RemovePeeringNetworkRequest.php +++ b/Compute/src/V1/RemovePeeringNetworkRequest.php @@ -34,7 +34,17 @@ class RemovePeeringNetworkRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -70,7 +80,17 @@ public static function build(string $project, string $network, \Google\Cloud\Com * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -167,7 +187,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -188,7 +218,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/RemoveResourcePoliciesDiskRequest.php b/Compute/src/V1/RemoveResourcePoliciesDiskRequest.php index af2f38f54426..d4fac1c7d187 100644 --- a/Compute/src/V1/RemoveResourcePoliciesDiskRequest.php +++ b/Compute/src/V1/RemoveResourcePoliciesDiskRequest.php @@ -34,7 +34,17 @@ class RemoveResourcePoliciesDiskRequest extends \Google\Protobuf\Internal\Messag */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -78,7 +88,17 @@ public static function build(string $project, string $zone, string $disk, \Googl * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $zone * The name of the zone for this request. * } @@ -177,7 +197,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -198,7 +228,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/RemoveResourcePoliciesInstanceRequest.php b/Compute/src/V1/RemoveResourcePoliciesInstanceRequest.php index ac89343c48d5..02d12e8cc70d 100644 --- a/Compute/src/V1/RemoveResourcePoliciesInstanceRequest.php +++ b/Compute/src/V1/RemoveResourcePoliciesInstanceRequest.php @@ -34,7 +34,17 @@ class RemoveResourcePoliciesInstanceRequest extends \Google\Protobuf\Internal\Me */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -78,7 +88,17 @@ public static function build(string $project, string $zone, string $instance, \G * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $zone * The name of the zone for this request. * } @@ -177,7 +197,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -198,7 +228,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/RemoveResourcePoliciesRegionDiskRequest.php b/Compute/src/V1/RemoveResourcePoliciesRegionDiskRequest.php index 35d27067d021..167ee8ee0095 100644 --- a/Compute/src/V1/RemoveResourcePoliciesRegionDiskRequest.php +++ b/Compute/src/V1/RemoveResourcePoliciesRegionDiskRequest.php @@ -40,7 +40,17 @@ class RemoveResourcePoliciesRegionDiskRequest extends \Google\Protobuf\Internal\ */ protected $region_disks_remove_resource_policies_request_resource = null; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -80,7 +90,17 @@ public static function build(string $project, string $region, string $disk, \Goo * @type \Google\Cloud\Compute\V1\RegionDisksRemoveResourcePoliciesRequest $region_disks_remove_resource_policies_request_resource * The body resource for this request * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -203,7 +223,17 @@ public function setRegionDisksRemoveResourcePoliciesRequestResource($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -224,7 +254,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/RemoveRuleFirewallPolicyRequest.php b/Compute/src/V1/RemoveRuleFirewallPolicyRequest.php index 608dec586b82..69613e56b693 100644 --- a/Compute/src/V1/RemoveRuleFirewallPolicyRequest.php +++ b/Compute/src/V1/RemoveRuleFirewallPolicyRequest.php @@ -28,7 +28,17 @@ class RemoveRuleFirewallPolicyRequest extends \Google\Protobuf\Internal\Message */ protected $priority = null; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -58,7 +68,17 @@ public static function build(string $firewallPolicy): self * @type int $priority * The priority of the rule to remove from the firewall policy. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -129,7 +149,17 @@ public function setPriority($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -150,7 +180,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/RemoveRuleNetworkFirewallPolicyRequest.php b/Compute/src/V1/RemoveRuleNetworkFirewallPolicyRequest.php index e6e2ad879431..b0eb81c66147 100644 --- a/Compute/src/V1/RemoveRuleNetworkFirewallPolicyRequest.php +++ b/Compute/src/V1/RemoveRuleNetworkFirewallPolicyRequest.php @@ -34,7 +34,17 @@ class RemoveRuleNetworkFirewallPolicyRequest extends \Google\Protobuf\Internal\M */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -68,7 +78,17 @@ public static function build(string $project, string $firewallPolicy): self * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -165,7 +185,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -186,7 +216,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/RemoveRuleOrganizationSecurityPolicyRequest.php b/Compute/src/V1/RemoveRuleOrganizationSecurityPolicyRequest.php index 1fdd722ca869..fbf6c8a3f092 100644 --- a/Compute/src/V1/RemoveRuleOrganizationSecurityPolicyRequest.php +++ b/Compute/src/V1/RemoveRuleOrganizationSecurityPolicyRequest.php @@ -22,7 +22,17 @@ class RemoveRuleOrganizationSecurityPolicyRequest extends \Google\Protobuf\Inter */ protected $priority = null; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -56,7 +66,17 @@ public static function build(string $securityPolicy): self * @type int $priority * The priority of the rule to remove from the security policy. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $security_policy * Name of the security policy to update. * } @@ -103,7 +123,17 @@ public function setPriority($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -124,7 +154,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/RemoveRuleRegionNetworkFirewallPolicyRequest.php b/Compute/src/V1/RemoveRuleRegionNetworkFirewallPolicyRequest.php index 7a998a24ccd1..d2e4381c8b2f 100644 --- a/Compute/src/V1/RemoveRuleRegionNetworkFirewallPolicyRequest.php +++ b/Compute/src/V1/RemoveRuleRegionNetworkFirewallPolicyRequest.php @@ -40,7 +40,17 @@ class RemoveRuleRegionNetworkFirewallPolicyRequest extends \Google\Protobuf\Inte */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -78,7 +88,17 @@ public static function build(string $project, string $region, string $firewallPo * @type string $region * Name of the region scoping this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -201,7 +221,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -222,7 +252,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/ReportFaultyReservationSubBlockRequest.php b/Compute/src/V1/ReportFaultyReservationSubBlockRequest.php index 519d25606ad5..d4604057d733 100644 --- a/Compute/src/V1/ReportFaultyReservationSubBlockRequest.php +++ b/Compute/src/V1/ReportFaultyReservationSubBlockRequest.php @@ -16,7 +16,8 @@ class ReportFaultyReservationSubBlockRequest extends \Google\Protobuf\Internal\Message { /** - * The name of the parent reservation and parent block. In the format of reservations/{reservation_name}/reservationBlocks/{reservation_block_name} + * The name of the parent reservation and parent block. In the format of + * reservations/{reservation_name}/reservationBlocks/{reservation_block_name} * * Generated from protobuf field string parent_name = 478151936 [(.google.api.field_behavior) = REQUIRED]; */ @@ -28,13 +29,24 @@ class ReportFaultyReservationSubBlockRequest extends \Google\Protobuf\Internal\M */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ protected $request_id = null; /** - * The name of the reservation subBlock. Name should conform to RFC1035 or be a resource ID. + * The name of the reservation subBlock. + * Name should conform to RFC1035 or be a resource ID. * * Generated from protobuf field string reservation_sub_block = 22750491 [(.google.api.field_behavior) = REQUIRED]; */ @@ -55,8 +67,10 @@ class ReportFaultyReservationSubBlockRequest extends \Google\Protobuf\Internal\M /** * @param string $project Project ID for this request. * @param string $zone Name of the zone for this request. Zone name should conform to RFC1035. - * @param string $parentName The name of the parent reservation and parent block. In the format of reservations/{reservation_name}/reservationBlocks/{reservation_block_name} - * @param string $reservationSubBlock The name of the reservation subBlock. Name should conform to RFC1035 or be a resource ID. + * @param string $parentName The name of the parent reservation and parent block. In the format of + * reservations/{reservation_name}/reservationBlocks/{reservation_block_name} + * @param string $reservationSubBlock The name of the reservation subBlock. + * Name should conform to RFC1035 or be a resource ID. * @param \Google\Cloud\Compute\V1\ReservationSubBlocksReportFaultyRequest $reservationSubBlocksReportFaultyRequestResource The body resource for this request * * @return \Google\Cloud\Compute\V1\ReportFaultyReservationSubBlockRequest @@ -80,13 +94,25 @@ public static function build(string $project, string $zone, string $parentName, * Optional. Data for populating the Message object. * * @type string $parent_name - * The name of the parent reservation and parent block. In the format of reservations/{reservation_name}/reservationBlocks/{reservation_block_name} + * The name of the parent reservation and parent block. In the format of + * reservations/{reservation_name}/reservationBlocks/{reservation_block_name} * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $reservation_sub_block - * The name of the reservation subBlock. Name should conform to RFC1035 or be a resource ID. + * The name of the reservation subBlock. + * Name should conform to RFC1035 or be a resource ID. * @type \Google\Cloud\Compute\V1\ReservationSubBlocksReportFaultyRequest $reservation_sub_blocks_report_faulty_request_resource * The body resource for this request * @type string $zone @@ -99,7 +125,8 @@ public function __construct($data = NULL) { } /** - * The name of the parent reservation and parent block. In the format of reservations/{reservation_name}/reservationBlocks/{reservation_block_name} + * The name of the parent reservation and parent block. In the format of + * reservations/{reservation_name}/reservationBlocks/{reservation_block_name} * * Generated from protobuf field string parent_name = 478151936 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -110,7 +137,8 @@ public function getParentName() } /** - * The name of the parent reservation and parent block. In the format of reservations/{reservation_name}/reservationBlocks/{reservation_block_name} + * The name of the parent reservation and parent block. In the format of + * reservations/{reservation_name}/reservationBlocks/{reservation_block_name} * * Generated from protobuf field string parent_name = 478151936 [(.google.api.field_behavior) = REQUIRED]; * @param string $var @@ -151,7 +179,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -172,7 +210,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var @@ -187,7 +235,8 @@ public function setRequestId($var) } /** - * The name of the reservation subBlock. Name should conform to RFC1035 or be a resource ID. + * The name of the reservation subBlock. + * Name should conform to RFC1035 or be a resource ID. * * Generated from protobuf field string reservation_sub_block = 22750491 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -198,7 +247,8 @@ public function getReservationSubBlock() } /** - * The name of the reservation subBlock. Name should conform to RFC1035 or be a resource ID. + * The name of the reservation subBlock. + * Name should conform to RFC1035 or be a resource ID. * * Generated from protobuf field string reservation_sub_block = 22750491 [(.google.api.field_behavior) = REQUIRED]; * @param string $var diff --git a/Compute/src/V1/ReportHostAsFaultyInstanceRequest.php b/Compute/src/V1/ReportHostAsFaultyInstanceRequest.php index 500a9f4c33da..a5561355e790 100644 --- a/Compute/src/V1/ReportHostAsFaultyInstanceRequest.php +++ b/Compute/src/V1/ReportHostAsFaultyInstanceRequest.php @@ -34,7 +34,17 @@ class ReportHostAsFaultyInstanceRequest extends \Google\Protobuf\Internal\Messag */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -78,7 +88,17 @@ public static function build(string $project, string $zone, string $instance, \G * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $zone * The name of the zone for this request. * } @@ -177,7 +197,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -198,7 +228,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/RequestMirrorPolicy.php b/Compute/src/V1/RequestMirrorPolicy.php index 77528222f3f6..b3141acf1dd3 100644 --- a/Compute/src/V1/RequestMirrorPolicy.php +++ b/Compute/src/V1/RequestMirrorPolicy.php @@ -9,14 +9,23 @@ use Google\Protobuf\Internal\GPBUtil; /** - * A policy that specifies how requests intended for the route's backends are shadowed to a separate mirrored backend service. The load balancer doesn't wait for responses from the shadow service. Before sending traffic to the shadow service, the host or authority header is suffixed with -shadow. + * A policy that specifies how requests intended for the route's backends + * are shadowed to a separate mirrored backend service. The load balancer + * doesn't wait for responses from the shadow service. Before sending traffic + * to the shadow service, the host or authority header is suffixed with-shadow. * * Generated from protobuf message google.cloud.compute.v1.RequestMirrorPolicy */ class RequestMirrorPolicy extends \Google\Protobuf\Internal\Message { /** - * The full or partial URL to the BackendService resource being mirrored to. The backend service configured for a mirroring policy must reference backends that are of the same type as the original backend service matched in the URL map. Serverless NEG backends are not currently supported as a mirrored backend service. + * The full or partial URL to the BackendService resource being + * mirrored to. + * The backend service configured for a mirroring + * policy must reference backends that are of the same type as the original + * backend service matched in the URL map. + * Serverless NEG backends are not currently supported as a mirrored + * backend service. * * Generated from protobuf field optional string backend_service = 306946058; */ @@ -35,7 +44,13 @@ class RequestMirrorPolicy extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $backend_service - * The full or partial URL to the BackendService resource being mirrored to. The backend service configured for a mirroring policy must reference backends that are of the same type as the original backend service matched in the URL map. Serverless NEG backends are not currently supported as a mirrored backend service. + * The full or partial URL to the BackendService resource being + * mirrored to. + * The backend service configured for a mirroring + * policy must reference backends that are of the same type as the original + * backend service matched in the URL map. + * Serverless NEG backends are not currently supported as a mirrored + * backend service. * @type float $mirror_percent * The percentage of requests to be mirrored to `backend_service`. * } @@ -46,7 +61,13 @@ public function __construct($data = NULL) { } /** - * The full or partial URL to the BackendService resource being mirrored to. The backend service configured for a mirroring policy must reference backends that are of the same type as the original backend service matched in the URL map. Serverless NEG backends are not currently supported as a mirrored backend service. + * The full or partial URL to the BackendService resource being + * mirrored to. + * The backend service configured for a mirroring + * policy must reference backends that are of the same type as the original + * backend service matched in the URL map. + * Serverless NEG backends are not currently supported as a mirrored + * backend service. * * Generated from protobuf field optional string backend_service = 306946058; * @return string @@ -67,7 +88,13 @@ public function clearBackendService() } /** - * The full or partial URL to the BackendService resource being mirrored to. The backend service configured for a mirroring policy must reference backends that are of the same type as the original backend service matched in the URL map. Serverless NEG backends are not currently supported as a mirrored backend service. + * The full or partial URL to the BackendService resource being + * mirrored to. + * The backend service configured for a mirroring + * policy must reference backends that are of the same type as the original + * backend service matched in the URL map. + * Serverless NEG backends are not currently supported as a mirrored + * backend service. * * Generated from protobuf field optional string backend_service = 306946058; * @param string $var diff --git a/Compute/src/V1/RequestRemovePeeringNetworkRequest.php b/Compute/src/V1/RequestRemovePeeringNetworkRequest.php index 5bba04bc5b84..42cf9d50ea10 100644 --- a/Compute/src/V1/RequestRemovePeeringNetworkRequest.php +++ b/Compute/src/V1/RequestRemovePeeringNetworkRequest.php @@ -34,7 +34,17 @@ class RequestRemovePeeringNetworkRequest extends \Google\Protobuf\Internal\Messa */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -70,7 +80,17 @@ public static function build(string $project, string $network, \Google\Cloud\Com * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -167,7 +187,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -188,7 +218,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/Reservation.php b/Compute/src/V1/Reservation.php index 83664d8c3078..2c8d6ef2eb6a 100644 --- a/Compute/src/V1/Reservation.php +++ b/Compute/src/V1/Reservation.php @@ -9,14 +9,18 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Represents a reservation resource. A reservation ensures that capacity is held in a specific zone even if the reserved VMs are not running. For more information, read Reserving zonal resources. + * Represents a reservation resource. A reservation ensures that capacity is + * held in a specific zone even if the reserved VMs are not running. For more + * information, read Reserving zonal + * resources. * * Generated from protobuf message google.cloud.compute.v1.Reservation */ class Reservation extends \Google\Protobuf\Internal\Message { /** - * Advanced control for cluster management, applicable only to DENSE deployment type reservations. + * Advanced control for cluster management, applicable only to DENSE + * deployment type reservations. * * Generated from protobuf field optional .google.cloud.compute.v1.ReservationAdvancedDeploymentControl advanced_deployment_control = 410618144; */ @@ -28,25 +32,29 @@ class Reservation extends \Google\Protobuf\Internal\Message */ protected $aggregate_reservation = null; /** - * [Output Only] Full or partial URL to a parent commitment. This field displays for reservations that are tied to a commitment. + * [Output Only] Full or partial URL to a parent commitment. This field + * displays for reservations that are tied to a commitment. * * Generated from protobuf field optional string commitment = 482134805; */ protected $commitment = null; /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; */ protected $creation_timestamp = null; /** - * Duration time relative to reservation creation when Compute Engine will automatically delete this resource. + * Duration time relative to reservation creation when Compute Engine will + * automatically delete this resource. * * Generated from protobuf field optional .google.cloud.compute.v1.Duration delete_after_duration = 323997099; */ protected $delete_after_duration = null; /** - * Absolute time in future when the reservation will be auto-deleted by Compute Engine. Timestamp is represented in RFC3339 text format. + * Absolute time in future when the reservation will be + * auto-deleted by Compute Engine. Timestamp is represented inRFC3339 text format. * * Generated from protobuf field optional string delete_at_time = 83294405; */ @@ -59,49 +67,72 @@ class Reservation extends \Google\Protobuf\Internal\Message */ protected $deployment_type = null; /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; */ protected $description = null; /** - * Indicates whether Compute Engine allows unplanned maintenance for your VMs; for example, to fix hardware errors. + * Indicates whether Compute Engine allows unplanned maintenance for your VMs; + * for example, to fix hardware errors. * * Generated from protobuf field optional bool enable_emergent_maintenance = 353759497; */ protected $enable_emergent_maintenance = null; /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; */ protected $id = null; /** - * [Output Only] Type of the resource. Always compute#reservations for reservations. + * [Output Only] Type of the resource. Alwayscompute#reservations for reservations. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] Full or partial URL to parent commitments. This field displays for reservations that are tied to multiple commitments. + * [Output Only] Full or partial URL to parent commitments. This field + * displays for reservations that are tied to multiple commitments. * * Generated from protobuf field repeated string linked_commitments = 470957784; */ private $linked_commitments; /** - * The name of the resource, provided by the client when initially creating the resource. The resource name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * The name of the resource, provided by the client when initially creating + * the resource. The resource name must be 1-63 characters long, and comply + * withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must be + * a dash, lowercase letter, or digit, except the last character, which cannot + * be a dash. * * Generated from protobuf field optional string name = 3373707; */ protected $name = null; /** - * Specify the reservation sharing policy. If unspecified, the reservation will not be shared with Google Cloud managed services. + * Protection tier for the workload which specifies the workload expectations + * in the event of infrastructure failures at data center (e.g. power + * and/or cooling failures). + * Check the ProtectionTier enum for the list of possible values. + * + * Generated from protobuf field optional string protection_tier = 503959432; + */ + protected $protection_tier = null; + /** + * Specify the reservation sharing policy. If unspecified, the reservation + * will not be shared with Google Cloud managed services. * * Generated from protobuf field optional .google.cloud.compute.v1.AllocationReservationSharingPolicy reservation_sharing_policy = 205970120; */ protected $reservation_sharing_policy = null; /** - * Resource policies to be added to this reservation. The key is defined by user, and the value is resource policy url. This is to define placement policy with reservation. + * Resource policies to be added to this reservation. The key is defined by + * user, and the value is resource policy url. This is to define placement + * policy with reservation. * * Generated from protobuf field map resource_policies = 22220385; */ @@ -132,7 +163,10 @@ class Reservation extends \Google\Protobuf\Internal\Message */ protected $self_link = null; /** - * Specify share-settings to create a shared reservation. This property is optional. For more information about the syntax and options for this field and its subfields, see the guide for creating a shared reservation. + * Specify share-settings to create a shared reservation. This property is + * optional. For more information about the syntax and options for this + * field and its subfields, see the guide for creating + * a shared reservation. * * Generated from protobuf field optional .google.cloud.compute.v1.ShareSettings share_settings = 266668163; */ @@ -144,20 +178,29 @@ class Reservation extends \Google\Protobuf\Internal\Message */ protected $specific_reservation = null; /** - * Indicates whether the reservation can be consumed by VMs with affinity for "any" reservation. If the field is set, then only VMs that target the reservation by name can consume from this reservation. + * Indicates whether the reservation can be consumed by VMs with affinity + * for "any" reservation. If the field is set, then only VMs that target + * the reservation by name can consume from this reservation. * * Generated from protobuf field optional bool specific_reservation_required = 226550687; */ protected $specific_reservation_required = null; /** - * [Output Only] The status of the reservation. - CREATING: Reservation resources are being allocated. - READY: Reservation resources have been allocated, and the reservation is ready for use. - DELETING: Reservation deletion is in progress. - UPDATING: Reservation update is in progress. + * [Output Only] The status of the reservation. + * - CREATING: Reservation resources are being + * allocated. + * - READY: Reservation resources have been allocated, + * and the reservation is ready for use. + * - DELETING: Reservation deletion is in progress. + * - UPDATING: Reservation update is in progress. * Check the Status enum for the list of possible values. * * Generated from protobuf field optional string status = 181260274; */ protected $status = null; /** - * Zone in which the reservation resides. A zone must be provided if the reservation is created within a commitment. + * Zone in which the reservation resides. A zone must be provided if the + * reservation is created within a commitment. * * Generated from protobuf field optional string zone = 3744684; */ @@ -170,36 +213,60 @@ class Reservation extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type \Google\Cloud\Compute\V1\ReservationAdvancedDeploymentControl $advanced_deployment_control - * Advanced control for cluster management, applicable only to DENSE deployment type reservations. + * Advanced control for cluster management, applicable only to DENSE + * deployment type reservations. * @type \Google\Cloud\Compute\V1\AllocationAggregateReservation $aggregate_reservation * Reservation for aggregated resources, providing shape flexibility. * @type string $commitment - * [Output Only] Full or partial URL to a parent commitment. This field displays for reservations that are tied to a commitment. + * [Output Only] Full or partial URL to a parent commitment. This field + * displays for reservations that are tied to a commitment. * @type string $creation_timestamp - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * @type \Google\Cloud\Compute\V1\Duration $delete_after_duration - * Duration time relative to reservation creation when Compute Engine will automatically delete this resource. + * Duration time relative to reservation creation when Compute Engine will + * automatically delete this resource. * @type string $delete_at_time - * Absolute time in future when the reservation will be auto-deleted by Compute Engine. Timestamp is represented in RFC3339 text format. + * Absolute time in future when the reservation will be + * auto-deleted by Compute Engine. Timestamp is represented inRFC3339 text format. * @type string $deployment_type * Specifies the deployment strategy for this reservation. * Check the DeploymentType enum for the list of possible values. * @type string $description - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * @type bool $enable_emergent_maintenance - * Indicates whether Compute Engine allows unplanned maintenance for your VMs; for example, to fix hardware errors. + * Indicates whether Compute Engine allows unplanned maintenance for your VMs; + * for example, to fix hardware errors. * @type int|string $id - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * @type string $kind - * [Output Only] Type of the resource. Always compute#reservations for reservations. + * [Output Only] Type of the resource. Alwayscompute#reservations for reservations. * @type array|\Google\Protobuf\Internal\RepeatedField $linked_commitments - * [Output Only] Full or partial URL to parent commitments. This field displays for reservations that are tied to multiple commitments. + * [Output Only] Full or partial URL to parent commitments. This field + * displays for reservations that are tied to multiple commitments. * @type string $name - * The name of the resource, provided by the client when initially creating the resource. The resource name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * The name of the resource, provided by the client when initially creating + * the resource. The resource name must be 1-63 characters long, and comply + * withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must be + * a dash, lowercase letter, or digit, except the last character, which cannot + * be a dash. + * @type string $protection_tier + * Protection tier for the workload which specifies the workload expectations + * in the event of infrastructure failures at data center (e.g. power + * and/or cooling failures). + * Check the ProtectionTier enum for the list of possible values. * @type \Google\Cloud\Compute\V1\AllocationReservationSharingPolicy $reservation_sharing_policy - * Specify the reservation sharing policy. If unspecified, the reservation will not be shared with Google Cloud managed services. + * Specify the reservation sharing policy. If unspecified, the reservation + * will not be shared with Google Cloud managed services. * @type array|\Google\Protobuf\Internal\MapField $resource_policies - * Resource policies to be added to this reservation. The key is defined by user, and the value is resource policy url. This is to define placement policy with reservation. + * Resource policies to be added to this reservation. The key is defined by + * user, and the value is resource policy url. This is to define placement + * policy with reservation. * @type \Google\Cloud\Compute\V1\AllocationResourceStatus $resource_status * [Output Only] Status information for Reservation resource. * @type bool $satisfies_pzs @@ -210,16 +277,28 @@ class Reservation extends \Google\Protobuf\Internal\Message * @type string $self_link * [Output Only] Server-defined fully-qualified URL for this resource. * @type \Google\Cloud\Compute\V1\ShareSettings $share_settings - * Specify share-settings to create a shared reservation. This property is optional. For more information about the syntax and options for this field and its subfields, see the guide for creating a shared reservation. + * Specify share-settings to create a shared reservation. This property is + * optional. For more information about the syntax and options for this + * field and its subfields, see the guide for creating + * a shared reservation. * @type \Google\Cloud\Compute\V1\AllocationSpecificSKUReservation $specific_reservation * Reservation for instances with specific machine shapes. * @type bool $specific_reservation_required - * Indicates whether the reservation can be consumed by VMs with affinity for "any" reservation. If the field is set, then only VMs that target the reservation by name can consume from this reservation. + * Indicates whether the reservation can be consumed by VMs with affinity + * for "any" reservation. If the field is set, then only VMs that target + * the reservation by name can consume from this reservation. * @type string $status - * [Output Only] The status of the reservation. - CREATING: Reservation resources are being allocated. - READY: Reservation resources have been allocated, and the reservation is ready for use. - DELETING: Reservation deletion is in progress. - UPDATING: Reservation update is in progress. + * [Output Only] The status of the reservation. + * - CREATING: Reservation resources are being + * allocated. + * - READY: Reservation resources have been allocated, + * and the reservation is ready for use. + * - DELETING: Reservation deletion is in progress. + * - UPDATING: Reservation update is in progress. * Check the Status enum for the list of possible values. * @type string $zone - * Zone in which the reservation resides. A zone must be provided if the reservation is created within a commitment. + * Zone in which the reservation resides. A zone must be provided if the + * reservation is created within a commitment. * } */ public function __construct($data = NULL) { @@ -228,7 +307,8 @@ public function __construct($data = NULL) { } /** - * Advanced control for cluster management, applicable only to DENSE deployment type reservations. + * Advanced control for cluster management, applicable only to DENSE + * deployment type reservations. * * Generated from protobuf field optional .google.cloud.compute.v1.ReservationAdvancedDeploymentControl advanced_deployment_control = 410618144; * @return \Google\Cloud\Compute\V1\ReservationAdvancedDeploymentControl|null @@ -249,7 +329,8 @@ public function clearAdvancedDeploymentControl() } /** - * Advanced control for cluster management, applicable only to DENSE deployment type reservations. + * Advanced control for cluster management, applicable only to DENSE + * deployment type reservations. * * Generated from protobuf field optional .google.cloud.compute.v1.ReservationAdvancedDeploymentControl advanced_deployment_control = 410618144; * @param \Google\Cloud\Compute\V1\ReservationAdvancedDeploymentControl $var @@ -300,7 +381,8 @@ public function setAggregateReservation($var) } /** - * [Output Only] Full or partial URL to a parent commitment. This field displays for reservations that are tied to a commitment. + * [Output Only] Full or partial URL to a parent commitment. This field + * displays for reservations that are tied to a commitment. * * Generated from protobuf field optional string commitment = 482134805; * @return string @@ -321,7 +403,8 @@ public function clearCommitment() } /** - * [Output Only] Full or partial URL to a parent commitment. This field displays for reservations that are tied to a commitment. + * [Output Only] Full or partial URL to a parent commitment. This field + * displays for reservations that are tied to a commitment. * * Generated from protobuf field optional string commitment = 482134805; * @param string $var @@ -336,7 +419,8 @@ public function setCommitment($var) } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @return string @@ -357,7 +441,8 @@ public function clearCreationTimestamp() } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @param string $var @@ -372,7 +457,8 @@ public function setCreationTimestamp($var) } /** - * Duration time relative to reservation creation when Compute Engine will automatically delete this resource. + * Duration time relative to reservation creation when Compute Engine will + * automatically delete this resource. * * Generated from protobuf field optional .google.cloud.compute.v1.Duration delete_after_duration = 323997099; * @return \Google\Cloud\Compute\V1\Duration|null @@ -393,7 +479,8 @@ public function clearDeleteAfterDuration() } /** - * Duration time relative to reservation creation when Compute Engine will automatically delete this resource. + * Duration time relative to reservation creation when Compute Engine will + * automatically delete this resource. * * Generated from protobuf field optional .google.cloud.compute.v1.Duration delete_after_duration = 323997099; * @param \Google\Cloud\Compute\V1\Duration $var @@ -408,7 +495,8 @@ public function setDeleteAfterDuration($var) } /** - * Absolute time in future when the reservation will be auto-deleted by Compute Engine. Timestamp is represented in RFC3339 text format. + * Absolute time in future when the reservation will be + * auto-deleted by Compute Engine. Timestamp is represented inRFC3339 text format. * * Generated from protobuf field optional string delete_at_time = 83294405; * @return string @@ -429,7 +517,8 @@ public function clearDeleteAtTime() } /** - * Absolute time in future when the reservation will be auto-deleted by Compute Engine. Timestamp is represented in RFC3339 text format. + * Absolute time in future when the reservation will be + * auto-deleted by Compute Engine. Timestamp is represented inRFC3339 text format. * * Generated from protobuf field optional string delete_at_time = 83294405; * @param string $var @@ -482,7 +571,8 @@ public function setDeploymentType($var) } /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @return string @@ -503,7 +593,8 @@ public function clearDescription() } /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @param string $var @@ -518,7 +609,8 @@ public function setDescription($var) } /** - * Indicates whether Compute Engine allows unplanned maintenance for your VMs; for example, to fix hardware errors. + * Indicates whether Compute Engine allows unplanned maintenance for your VMs; + * for example, to fix hardware errors. * * Generated from protobuf field optional bool enable_emergent_maintenance = 353759497; * @return bool @@ -539,7 +631,8 @@ public function clearEnableEmergentMaintenance() } /** - * Indicates whether Compute Engine allows unplanned maintenance for your VMs; for example, to fix hardware errors. + * Indicates whether Compute Engine allows unplanned maintenance for your VMs; + * for example, to fix hardware errors. * * Generated from protobuf field optional bool enable_emergent_maintenance = 353759497; * @param bool $var @@ -554,7 +647,8 @@ public function setEnableEmergentMaintenance($var) } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @return int|string @@ -575,7 +669,8 @@ public function clearId() } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @param int|string $var @@ -590,7 +685,7 @@ public function setId($var) } /** - * [Output Only] Type of the resource. Always compute#reservations for reservations. + * [Output Only] Type of the resource. Alwayscompute#reservations for reservations. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -611,7 +706,7 @@ public function clearKind() } /** - * [Output Only] Type of the resource. Always compute#reservations for reservations. + * [Output Only] Type of the resource. Alwayscompute#reservations for reservations. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -626,7 +721,8 @@ public function setKind($var) } /** - * [Output Only] Full or partial URL to parent commitments. This field displays for reservations that are tied to multiple commitments. + * [Output Only] Full or partial URL to parent commitments. This field + * displays for reservations that are tied to multiple commitments. * * Generated from protobuf field repeated string linked_commitments = 470957784; * @return \Google\Protobuf\Internal\RepeatedField @@ -637,7 +733,8 @@ public function getLinkedCommitments() } /** - * [Output Only] Full or partial URL to parent commitments. This field displays for reservations that are tied to multiple commitments. + * [Output Only] Full or partial URL to parent commitments. This field + * displays for reservations that are tied to multiple commitments. * * Generated from protobuf field repeated string linked_commitments = 470957784; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -652,7 +749,14 @@ public function setLinkedCommitments($var) } /** - * The name of the resource, provided by the client when initially creating the resource. The resource name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * The name of the resource, provided by the client when initially creating + * the resource. The resource name must be 1-63 characters long, and comply + * withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must be + * a dash, lowercase letter, or digit, except the last character, which cannot + * be a dash. * * Generated from protobuf field optional string name = 3373707; * @return string @@ -673,7 +777,14 @@ public function clearName() } /** - * The name of the resource, provided by the client when initially creating the resource. The resource name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * The name of the resource, provided by the client when initially creating + * the resource. The resource name must be 1-63 characters long, and comply + * withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must be + * a dash, lowercase letter, or digit, except the last character, which cannot + * be a dash. * * Generated from protobuf field optional string name = 3373707; * @param string $var @@ -688,7 +799,50 @@ public function setName($var) } /** - * Specify the reservation sharing policy. If unspecified, the reservation will not be shared with Google Cloud managed services. + * Protection tier for the workload which specifies the workload expectations + * in the event of infrastructure failures at data center (e.g. power + * and/or cooling failures). + * Check the ProtectionTier enum for the list of possible values. + * + * Generated from protobuf field optional string protection_tier = 503959432; + * @return string + */ + public function getProtectionTier() + { + return isset($this->protection_tier) ? $this->protection_tier : ''; + } + + public function hasProtectionTier() + { + return isset($this->protection_tier); + } + + public function clearProtectionTier() + { + unset($this->protection_tier); + } + + /** + * Protection tier for the workload which specifies the workload expectations + * in the event of infrastructure failures at data center (e.g. power + * and/or cooling failures). + * Check the ProtectionTier enum for the list of possible values. + * + * Generated from protobuf field optional string protection_tier = 503959432; + * @param string $var + * @return $this + */ + public function setProtectionTier($var) + { + GPBUtil::checkString($var, True); + $this->protection_tier = $var; + + return $this; + } + + /** + * Specify the reservation sharing policy. If unspecified, the reservation + * will not be shared with Google Cloud managed services. * * Generated from protobuf field optional .google.cloud.compute.v1.AllocationReservationSharingPolicy reservation_sharing_policy = 205970120; * @return \Google\Cloud\Compute\V1\AllocationReservationSharingPolicy|null @@ -709,7 +863,8 @@ public function clearReservationSharingPolicy() } /** - * Specify the reservation sharing policy. If unspecified, the reservation will not be shared with Google Cloud managed services. + * Specify the reservation sharing policy. If unspecified, the reservation + * will not be shared with Google Cloud managed services. * * Generated from protobuf field optional .google.cloud.compute.v1.AllocationReservationSharingPolicy reservation_sharing_policy = 205970120; * @param \Google\Cloud\Compute\V1\AllocationReservationSharingPolicy $var @@ -724,7 +879,9 @@ public function setReservationSharingPolicy($var) } /** - * Resource policies to be added to this reservation. The key is defined by user, and the value is resource policy url. This is to define placement policy with reservation. + * Resource policies to be added to this reservation. The key is defined by + * user, and the value is resource policy url. This is to define placement + * policy with reservation. * * Generated from protobuf field map resource_policies = 22220385; * @return \Google\Protobuf\Internal\MapField @@ -735,7 +892,9 @@ public function getResourcePolicies() } /** - * Resource policies to be added to this reservation. The key is defined by user, and the value is resource policy url. This is to define placement policy with reservation. + * Resource policies to be added to this reservation. The key is defined by + * user, and the value is resource policy url. This is to define placement + * policy with reservation. * * Generated from protobuf field map resource_policies = 22220385; * @param array|\Google\Protobuf\Internal\MapField $var @@ -896,7 +1055,10 @@ public function setSelfLink($var) } /** - * Specify share-settings to create a shared reservation. This property is optional. For more information about the syntax and options for this field and its subfields, see the guide for creating a shared reservation. + * Specify share-settings to create a shared reservation. This property is + * optional. For more information about the syntax and options for this + * field and its subfields, see the guide for creating + * a shared reservation. * * Generated from protobuf field optional .google.cloud.compute.v1.ShareSettings share_settings = 266668163; * @return \Google\Cloud\Compute\V1\ShareSettings|null @@ -917,7 +1079,10 @@ public function clearShareSettings() } /** - * Specify share-settings to create a shared reservation. This property is optional. For more information about the syntax and options for this field and its subfields, see the guide for creating a shared reservation. + * Specify share-settings to create a shared reservation. This property is + * optional. For more information about the syntax and options for this + * field and its subfields, see the guide for creating + * a shared reservation. * * Generated from protobuf field optional .google.cloud.compute.v1.ShareSettings share_settings = 266668163; * @param \Google\Cloud\Compute\V1\ShareSettings $var @@ -968,7 +1133,9 @@ public function setSpecificReservation($var) } /** - * Indicates whether the reservation can be consumed by VMs with affinity for "any" reservation. If the field is set, then only VMs that target the reservation by name can consume from this reservation. + * Indicates whether the reservation can be consumed by VMs with affinity + * for "any" reservation. If the field is set, then only VMs that target + * the reservation by name can consume from this reservation. * * Generated from protobuf field optional bool specific_reservation_required = 226550687; * @return bool @@ -989,7 +1156,9 @@ public function clearSpecificReservationRequired() } /** - * Indicates whether the reservation can be consumed by VMs with affinity for "any" reservation. If the field is set, then only VMs that target the reservation by name can consume from this reservation. + * Indicates whether the reservation can be consumed by VMs with affinity + * for "any" reservation. If the field is set, then only VMs that target + * the reservation by name can consume from this reservation. * * Generated from protobuf field optional bool specific_reservation_required = 226550687; * @param bool $var @@ -1004,7 +1173,13 @@ public function setSpecificReservationRequired($var) } /** - * [Output Only] The status of the reservation. - CREATING: Reservation resources are being allocated. - READY: Reservation resources have been allocated, and the reservation is ready for use. - DELETING: Reservation deletion is in progress. - UPDATING: Reservation update is in progress. + * [Output Only] The status of the reservation. + * - CREATING: Reservation resources are being + * allocated. + * - READY: Reservation resources have been allocated, + * and the reservation is ready for use. + * - DELETING: Reservation deletion is in progress. + * - UPDATING: Reservation update is in progress. * Check the Status enum for the list of possible values. * * Generated from protobuf field optional string status = 181260274; @@ -1026,7 +1201,13 @@ public function clearStatus() } /** - * [Output Only] The status of the reservation. - CREATING: Reservation resources are being allocated. - READY: Reservation resources have been allocated, and the reservation is ready for use. - DELETING: Reservation deletion is in progress. - UPDATING: Reservation update is in progress. + * [Output Only] The status of the reservation. + * - CREATING: Reservation resources are being + * allocated. + * - READY: Reservation resources have been allocated, + * and the reservation is ready for use. + * - DELETING: Reservation deletion is in progress. + * - UPDATING: Reservation update is in progress. * Check the Status enum for the list of possible values. * * Generated from protobuf field optional string status = 181260274; @@ -1042,7 +1223,8 @@ public function setStatus($var) } /** - * Zone in which the reservation resides. A zone must be provided if the reservation is created within a commitment. + * Zone in which the reservation resides. A zone must be provided if the + * reservation is created within a commitment. * * Generated from protobuf field optional string zone = 3744684; * @return string @@ -1063,7 +1245,8 @@ public function clearZone() } /** - * Zone in which the reservation resides. A zone must be provided if the reservation is created within a commitment. + * Zone in which the reservation resides. A zone must be provided if the + * reservation is created within a commitment. * * Generated from protobuf field optional string zone = 3744684; * @param string $var diff --git a/Compute/src/V1/Reservation/ProtectionTier.php b/Compute/src/V1/Reservation/ProtectionTier.php new file mode 100644 index 000000000000..f8e43b3560f5 --- /dev/null +++ b/Compute/src/V1/Reservation/ProtectionTier.php @@ -0,0 +1,79 @@ +google.cloud.compute.v1.Reservation.ProtectionTier + */ +class ProtectionTier +{ + /** + * A value indicating that the enum field is not set. + * + * Generated from protobuf enum UNDEFINED_PROTECTION_TIER = 0; + */ + const UNDEFINED_PROTECTION_TIER = 0; + /** + * CAPACITY_OPTIMIZED capacity leverages redundancies (e.g. power, cooling) + * at the data center during normal operating conditions. In the event of + * infrastructure failures at data center (e.g. power and/or cooling + * failures), this workload may be disrupted. As a consequence, it has a + * weaker availability SLO than STANDARD. + * + * Generated from protobuf enum CAPACITY_OPTIMIZED = 17430466; + */ + const CAPACITY_OPTIMIZED = 17430466; + /** + * Unspecified protection tier. + * + * Generated from protobuf enum PROTECTION_TIER_UNSPECIFIED = 262261984; + */ + const PROTECTION_TIER_UNSPECIFIED = 262261984; + /** + * STANDARD protection for workload that should be protected by redundancies + * (e.g. power, cooling) at the data center level. In the event of + * infrastructure failures at data center (e.g. power and/or cooling + * failures), this workload is expected to continue as normal using the + * redundancies. + * + * Generated from protobuf enum STANDARD = 484642493; + */ + const STANDARD = 484642493; + + private static $valueToName = [ + self::UNDEFINED_PROTECTION_TIER => 'UNDEFINED_PROTECTION_TIER', + self::CAPACITY_OPTIMIZED => 'CAPACITY_OPTIMIZED', + self::PROTECTION_TIER_UNSPECIFIED => 'PROTECTION_TIER_UNSPECIFIED', + self::STANDARD => 'STANDARD', + ]; + + public static function name($value) + { + if (!isset(self::$valueToName[$value])) { + throw new UnexpectedValueException(sprintf( + 'Enum %s has no name defined for value %s', __CLASS__, $value)); + } + return self::$valueToName[$value]; + } + + + public static function value($name) + { + $const = __CLASS__ . '::' . strtoupper($name); + if (!defined($const)) { + throw new UnexpectedValueException(sprintf( + 'Enum %s has no value defined for name %s', __CLASS__, $name)); + } + return constant($const); + } +} + + diff --git a/Compute/src/V1/Reservation/SchedulingType.php b/Compute/src/V1/Reservation/SchedulingType.php index dc4a2379d173..16f9e48b081a 100644 --- a/Compute/src/V1/Reservation/SchedulingType.php +++ b/Compute/src/V1/Reservation/SchedulingType.php @@ -32,7 +32,8 @@ class SchedulingType */ const GROUP_MAINTENANCE_TYPE_UNSPECIFIED = 447183678; /** - * Maintenance is not synchronized for this reservation. Instead, each instance has its own maintenance window. + * Maintenance is not synchronized for this reservation. Instead, each + * instance has its own maintenance window. * * Generated from protobuf enum INDEPENDENT = 127011674; */ diff --git a/Compute/src/V1/Reservation/Status.php b/Compute/src/V1/Reservation/Status.php index eb97b36fdee0..52a396a9b9dc 100644 --- a/Compute/src/V1/Reservation/Status.php +++ b/Compute/src/V1/Reservation/Status.php @@ -7,7 +7,13 @@ use UnexpectedValueException; /** - * [Output Only] The status of the reservation. - CREATING: Reservation resources are being allocated. - READY: Reservation resources have been allocated, and the reservation is ready for use. - DELETING: Reservation deletion is in progress. - UPDATING: Reservation update is in progress. + * [Output Only] The status of the reservation. + * - CREATING: Reservation resources are being + * allocated. + * - READY: Reservation resources have been allocated, + * and the reservation is ready for use. + * - DELETING: Reservation deletion is in progress. + * - UPDATING: Reservation update is in progress. * * Protobuf type google.cloud.compute.v1.Reservation.Status */ @@ -36,7 +42,8 @@ class Status */ const INVALID = 530283991; /** - * Reservation resources have been allocated, and the reservation is ready for use. + * Reservation resources have been allocated, and the reservation is ready + * for use. * * Generated from protobuf enum READY = 77848963; */ diff --git a/Compute/src/V1/ReservationAdvancedDeploymentControl.php b/Compute/src/V1/ReservationAdvancedDeploymentControl.php index 28217efd482e..3d814e4570a1 100644 --- a/Compute/src/V1/ReservationAdvancedDeploymentControl.php +++ b/Compute/src/V1/ReservationAdvancedDeploymentControl.php @@ -9,7 +9,8 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Advance control for cluster management, applicable only to DENSE deployment type reservations. + * Advance control for cluster management, applicable only to DENSE deployment + * type reservations. * * Generated from protobuf message google.cloud.compute.v1.ReservationAdvancedDeploymentControl */ diff --git a/Compute/src/V1/ReservationAdvancedDeploymentControl/ReservationOperationalMode.php b/Compute/src/V1/ReservationAdvancedDeploymentControl/ReservationOperationalMode.php index bcb0d5707ea1..e959fc3121d4 100644 --- a/Compute/src/V1/ReservationAdvancedDeploymentControl/ReservationOperationalMode.php +++ b/Compute/src/V1/ReservationAdvancedDeploymentControl/ReservationOperationalMode.php @@ -20,13 +20,15 @@ class ReservationOperationalMode */ const UNDEFINED_RESERVATION_OPERATIONAL_MODE = 0; /** - * Google Cloud does not manage the failure of machines, but provides additional capacity, which is not guaranteed to be available. + * Google Cloud does not manage the failure of machines, but provides + * additional capacity, which is not guaranteed to be available. * * Generated from protobuf enum ALL_CAPACITY = 500029880; */ const ALL_CAPACITY = 500029880; /** - * Google Cloud manages the failure of machines to provide high availability. + * Google Cloud manages the failure of machines to provide high + * availability. * * Generated from protobuf enum HIGHLY_AVAILABLE_CAPACITY = 110861600; */ diff --git a/Compute/src/V1/ReservationAffinity.php b/Compute/src/V1/ReservationAffinity.php index 0a525929069e..0dd3ae6e2db2 100644 --- a/Compute/src/V1/ReservationAffinity.php +++ b/Compute/src/V1/ReservationAffinity.php @@ -16,20 +16,26 @@ class ReservationAffinity extends \Google\Protobuf\Internal\Message { /** - * Specifies the type of reservation from which this instance can consume resources: ANY_RESERVATION (default), SPECIFIC_RESERVATION, or NO_RESERVATION. See Consuming reserved instances for examples. + * Specifies the type of reservation from which this instance can consume + * resources: ANY_RESERVATION (default),SPECIFIC_RESERVATION, or NO_RESERVATION. See + * Consuming reserved instances for examples. * Check the ConsumeReservationType enum for the list of possible values. * * Generated from protobuf field optional string consume_reservation_type = 300736944; */ protected $consume_reservation_type = null; /** - * Corresponds to the label key of a reservation resource. To target a SPECIFIC_RESERVATION by name, specify googleapis.com/reservation-name as the key and specify the name of your reservation as its value. + * Corresponds to the label key of a reservation resource. To target aSPECIFIC_RESERVATION by name, specifygoogleapis.com/reservation-name as the key and specify + * the name of your reservation as its value. * * Generated from protobuf field optional string key = 106079; */ protected $key = null; /** - * Corresponds to the label values of a reservation resource. This can be either a name to a reservation in the same project or "projects/different-project/reservations/some-reservation-name" to target a shared reservation in the same zone but in a different project. + * Corresponds to the label values of a reservation resource. This can be + * either a name to a reservation in the same project or + * "projects/different-project/reservations/some-reservation-name" to target a + * shared reservation in the same zone but in a different project. * * Generated from protobuf field repeated string values = 249928994; */ @@ -42,12 +48,18 @@ class ReservationAffinity extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $consume_reservation_type - * Specifies the type of reservation from which this instance can consume resources: ANY_RESERVATION (default), SPECIFIC_RESERVATION, or NO_RESERVATION. See Consuming reserved instances for examples. + * Specifies the type of reservation from which this instance can consume + * resources: ANY_RESERVATION (default),SPECIFIC_RESERVATION, or NO_RESERVATION. See + * Consuming reserved instances for examples. * Check the ConsumeReservationType enum for the list of possible values. * @type string $key - * Corresponds to the label key of a reservation resource. To target a SPECIFIC_RESERVATION by name, specify googleapis.com/reservation-name as the key and specify the name of your reservation as its value. + * Corresponds to the label key of a reservation resource. To target aSPECIFIC_RESERVATION by name, specifygoogleapis.com/reservation-name as the key and specify + * the name of your reservation as its value. * @type array|\Google\Protobuf\Internal\RepeatedField $values - * Corresponds to the label values of a reservation resource. This can be either a name to a reservation in the same project or "projects/different-project/reservations/some-reservation-name" to target a shared reservation in the same zone but in a different project. + * Corresponds to the label values of a reservation resource. This can be + * either a name to a reservation in the same project or + * "projects/different-project/reservations/some-reservation-name" to target a + * shared reservation in the same zone but in a different project. * } */ public function __construct($data = NULL) { @@ -56,7 +68,9 @@ public function __construct($data = NULL) { } /** - * Specifies the type of reservation from which this instance can consume resources: ANY_RESERVATION (default), SPECIFIC_RESERVATION, or NO_RESERVATION. See Consuming reserved instances for examples. + * Specifies the type of reservation from which this instance can consume + * resources: ANY_RESERVATION (default),SPECIFIC_RESERVATION, or NO_RESERVATION. See + * Consuming reserved instances for examples. * Check the ConsumeReservationType enum for the list of possible values. * * Generated from protobuf field optional string consume_reservation_type = 300736944; @@ -78,7 +92,9 @@ public function clearConsumeReservationType() } /** - * Specifies the type of reservation from which this instance can consume resources: ANY_RESERVATION (default), SPECIFIC_RESERVATION, or NO_RESERVATION. See Consuming reserved instances for examples. + * Specifies the type of reservation from which this instance can consume + * resources: ANY_RESERVATION (default),SPECIFIC_RESERVATION, or NO_RESERVATION. See + * Consuming reserved instances for examples. * Check the ConsumeReservationType enum for the list of possible values. * * Generated from protobuf field optional string consume_reservation_type = 300736944; @@ -94,7 +110,8 @@ public function setConsumeReservationType($var) } /** - * Corresponds to the label key of a reservation resource. To target a SPECIFIC_RESERVATION by name, specify googleapis.com/reservation-name as the key and specify the name of your reservation as its value. + * Corresponds to the label key of a reservation resource. To target aSPECIFIC_RESERVATION by name, specifygoogleapis.com/reservation-name as the key and specify + * the name of your reservation as its value. * * Generated from protobuf field optional string key = 106079; * @return string @@ -115,7 +132,8 @@ public function clearKey() } /** - * Corresponds to the label key of a reservation resource. To target a SPECIFIC_RESERVATION by name, specify googleapis.com/reservation-name as the key and specify the name of your reservation as its value. + * Corresponds to the label key of a reservation resource. To target aSPECIFIC_RESERVATION by name, specifygoogleapis.com/reservation-name as the key and specify + * the name of your reservation as its value. * * Generated from protobuf field optional string key = 106079; * @param string $var @@ -130,7 +148,10 @@ public function setKey($var) } /** - * Corresponds to the label values of a reservation resource. This can be either a name to a reservation in the same project or "projects/different-project/reservations/some-reservation-name" to target a shared reservation in the same zone but in a different project. + * Corresponds to the label values of a reservation resource. This can be + * either a name to a reservation in the same project or + * "projects/different-project/reservations/some-reservation-name" to target a + * shared reservation in the same zone but in a different project. * * Generated from protobuf field repeated string values = 249928994; * @return \Google\Protobuf\Internal\RepeatedField @@ -141,7 +162,10 @@ public function getValues() } /** - * Corresponds to the label values of a reservation resource. This can be either a name to a reservation in the same project or "projects/different-project/reservations/some-reservation-name" to target a shared reservation in the same zone but in a different project. + * Corresponds to the label values of a reservation resource. This can be + * either a name to a reservation in the same project or + * "projects/different-project/reservations/some-reservation-name" to target a + * shared reservation in the same zone but in a different project. * * Generated from protobuf field repeated string values = 249928994; * @param array|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/ReservationAffinity/ConsumeReservationType.php b/Compute/src/V1/ReservationAffinity/ConsumeReservationType.php index 930e31b08600..d45e90384b7f 100644 --- a/Compute/src/V1/ReservationAffinity/ConsumeReservationType.php +++ b/Compute/src/V1/ReservationAffinity/ConsumeReservationType.php @@ -7,7 +7,9 @@ use UnexpectedValueException; /** - * Specifies the type of reservation from which this instance can consume resources: ANY_RESERVATION (default), SPECIFIC_RESERVATION, or NO_RESERVATION. See Consuming reserved instances for examples. + * Specifies the type of reservation from which this instance can consume + * resources: ANY_RESERVATION (default),SPECIFIC_RESERVATION, or NO_RESERVATION. See + * Consuming reserved instances for examples. * * Protobuf type google.cloud.compute.v1.ReservationAffinity.ConsumeReservationType */ @@ -32,7 +34,8 @@ class ConsumeReservationType */ const NO_RESERVATION = 169322030; /** - * Must consume from a specific reservation. Must specify key value fields for specifying the reservations. + * Must consume from a specific reservation. Must specify key value fields + * for specifying the reservations. * * Generated from protobuf enum SPECIFIC_RESERVATION = 229889055; */ diff --git a/Compute/src/V1/ReservationAggregatedList.php b/Compute/src/V1/ReservationAggregatedList.php index aa0b65ccb707..73b5efc50586 100644 --- a/Compute/src/V1/ReservationAggregatedList.php +++ b/Compute/src/V1/ReservationAggregatedList.php @@ -34,7 +34,11 @@ class ReservationAggregatedList extends \Google\Protobuf\Internal\Message */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -71,7 +75,11 @@ class ReservationAggregatedList extends \Google\Protobuf\Internal\Message * @type string $kind * Type of resource. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type array|\Google\Protobuf\Internal\RepeatedField $unreachables @@ -184,7 +192,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -205,7 +217,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/ReservationBlock.php b/Compute/src/V1/ReservationBlock.php index 0eff24a589a8..0a8863289278 100644 --- a/Compute/src/V1/ReservationBlock.php +++ b/Compute/src/V1/ReservationBlock.php @@ -16,13 +16,14 @@ class ReservationBlock extends \Google\Protobuf\Internal\Message { /** - * [Output Only] The number of resources that are allocated in this reservation block. + * [Output Only] The number of resources that are allocated in this + * reservation block. * * Generated from protobuf field optional int32 count = 94851343; */ protected $count = null; /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; */ @@ -34,25 +35,29 @@ class ReservationBlock extends \Google\Protobuf\Internal\Message */ protected $health_info = null; /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; */ protected $id = null; /** - * [Output Only] The number of instances that are currently in use on this reservation block. + * [Output Only] The number of instances that are currently in use on this + * reservation block. * * Generated from protobuf field optional int32 in_use_count = 493458877; */ protected $in_use_count = null; /** - * [Output Only] Type of the resource. Always compute#reservationBlock for reservation blocks. + * [Output Only] Type of the resource. Alwayscompute#reservationBlock for reservation blocks. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] The name of this reservation block generated by Google Compute Engine. The name must be 1-63 characters long, and comply with RFC1035 @pattern [a-z](?:[-a-z0-9]{0,61}[a-z0-9])? + * [Output Only] The name of this reservation block generated by Google + * Compute Engine. The name must be 1-63 characters long, and comply with + * RFC1035 @pattern [a-z](?:[-a-z0-9]{0,61}[a-z0-9])? * * Generated from protobuf field optional string name = 3373707; */ @@ -70,13 +75,16 @@ class ReservationBlock extends \Google\Protobuf\Internal\Message */ protected $reservation_maintenance = null; /** - * [Output Only] The number of reservation subBlocks associated with this reservation block. + * [Output Only] The number of reservation subBlocks associated with this + * reservation block. * * Generated from protobuf field optional int32 reservation_sub_block_count = 330782955; */ protected $reservation_sub_block_count = null; /** - * [Output Only] The number of in-use reservation subBlocks associated with this reservation block. If at least one VM is running on a subBlock, it is considered in-use. + * [Output Only] The number of in-use reservation subBlocks associated with + * this reservation block. If at least one VM is running on a subBlock, it is + * considered in-use. * * Generated from protobuf field optional int32 reservation_sub_block_in_use_count = 186007137; */ @@ -114,27 +122,35 @@ class ReservationBlock extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type int $count - * [Output Only] The number of resources that are allocated in this reservation block. + * [Output Only] The number of resources that are allocated in this + * reservation block. * @type string $creation_timestamp - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 text format. * @type \Google\Cloud\Compute\V1\ReservationBlockHealthInfo $health_info * [Output Only] Health information for the reservation block. * @type int|string $id - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * @type int $in_use_count - * [Output Only] The number of instances that are currently in use on this reservation block. + * [Output Only] The number of instances that are currently in use on this + * reservation block. * @type string $kind - * [Output Only] Type of the resource. Always compute#reservationBlock for reservation blocks. + * [Output Only] Type of the resource. Alwayscompute#reservationBlock for reservation blocks. * @type string $name - * [Output Only] The name of this reservation block generated by Google Compute Engine. The name must be 1-63 characters long, and comply with RFC1035 @pattern [a-z](?:[-a-z0-9]{0,61}[a-z0-9])? + * [Output Only] The name of this reservation block generated by Google + * Compute Engine. The name must be 1-63 characters long, and comply with + * RFC1035 @pattern [a-z](?:[-a-z0-9]{0,61}[a-z0-9])? * @type \Google\Cloud\Compute\V1\ReservationBlockPhysicalTopology $physical_topology * [Output Only] The physical topology of the reservation block. * @type \Google\Cloud\Compute\V1\GroupMaintenanceInfo $reservation_maintenance * [Output Only] Maintenance information for this reservation block. * @type int $reservation_sub_block_count - * [Output Only] The number of reservation subBlocks associated with this reservation block. + * [Output Only] The number of reservation subBlocks associated with this + * reservation block. * @type int $reservation_sub_block_in_use_count - * [Output Only] The number of in-use reservation subBlocks associated with this reservation block. If at least one VM is running on a subBlock, it is considered in-use. + * [Output Only] The number of in-use reservation subBlocks associated with + * this reservation block. If at least one VM is running on a subBlock, it is + * considered in-use. * @type string $self_link * [Output Only] Server-defined fully-qualified URL for this resource. * @type string $self_link_with_id @@ -152,7 +168,8 @@ public function __construct($data = NULL) { } /** - * [Output Only] The number of resources that are allocated in this reservation block. + * [Output Only] The number of resources that are allocated in this + * reservation block. * * Generated from protobuf field optional int32 count = 94851343; * @return int @@ -173,7 +190,8 @@ public function clearCount() } /** - * [Output Only] The number of resources that are allocated in this reservation block. + * [Output Only] The number of resources that are allocated in this + * reservation block. * * Generated from protobuf field optional int32 count = 94851343; * @param int $var @@ -188,7 +206,7 @@ public function setCount($var) } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @return string @@ -209,7 +227,7 @@ public function clearCreationTimestamp() } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @param string $var @@ -260,7 +278,8 @@ public function setHealthInfo($var) } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @return int|string @@ -281,7 +300,8 @@ public function clearId() } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @param int|string $var @@ -296,7 +316,8 @@ public function setId($var) } /** - * [Output Only] The number of instances that are currently in use on this reservation block. + * [Output Only] The number of instances that are currently in use on this + * reservation block. * * Generated from protobuf field optional int32 in_use_count = 493458877; * @return int @@ -317,7 +338,8 @@ public function clearInUseCount() } /** - * [Output Only] The number of instances that are currently in use on this reservation block. + * [Output Only] The number of instances that are currently in use on this + * reservation block. * * Generated from protobuf field optional int32 in_use_count = 493458877; * @param int $var @@ -332,7 +354,7 @@ public function setInUseCount($var) } /** - * [Output Only] Type of the resource. Always compute#reservationBlock for reservation blocks. + * [Output Only] Type of the resource. Alwayscompute#reservationBlock for reservation blocks. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -353,7 +375,7 @@ public function clearKind() } /** - * [Output Only] Type of the resource. Always compute#reservationBlock for reservation blocks. + * [Output Only] Type of the resource. Alwayscompute#reservationBlock for reservation blocks. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -368,7 +390,9 @@ public function setKind($var) } /** - * [Output Only] The name of this reservation block generated by Google Compute Engine. The name must be 1-63 characters long, and comply with RFC1035 @pattern [a-z](?:[-a-z0-9]{0,61}[a-z0-9])? + * [Output Only] The name of this reservation block generated by Google + * Compute Engine. The name must be 1-63 characters long, and comply with + * RFC1035 @pattern [a-z](?:[-a-z0-9]{0,61}[a-z0-9])? * * Generated from protobuf field optional string name = 3373707; * @return string @@ -389,7 +413,9 @@ public function clearName() } /** - * [Output Only] The name of this reservation block generated by Google Compute Engine. The name must be 1-63 characters long, and comply with RFC1035 @pattern [a-z](?:[-a-z0-9]{0,61}[a-z0-9])? + * [Output Only] The name of this reservation block generated by Google + * Compute Engine. The name must be 1-63 characters long, and comply with + * RFC1035 @pattern [a-z](?:[-a-z0-9]{0,61}[a-z0-9])? * * Generated from protobuf field optional string name = 3373707; * @param string $var @@ -476,7 +502,8 @@ public function setReservationMaintenance($var) } /** - * [Output Only] The number of reservation subBlocks associated with this reservation block. + * [Output Only] The number of reservation subBlocks associated with this + * reservation block. * * Generated from protobuf field optional int32 reservation_sub_block_count = 330782955; * @return int @@ -497,7 +524,8 @@ public function clearReservationSubBlockCount() } /** - * [Output Only] The number of reservation subBlocks associated with this reservation block. + * [Output Only] The number of reservation subBlocks associated with this + * reservation block. * * Generated from protobuf field optional int32 reservation_sub_block_count = 330782955; * @param int $var @@ -512,7 +540,9 @@ public function setReservationSubBlockCount($var) } /** - * [Output Only] The number of in-use reservation subBlocks associated with this reservation block. If at least one VM is running on a subBlock, it is considered in-use. + * [Output Only] The number of in-use reservation subBlocks associated with + * this reservation block. If at least one VM is running on a subBlock, it is + * considered in-use. * * Generated from protobuf field optional int32 reservation_sub_block_in_use_count = 186007137; * @return int @@ -533,7 +563,9 @@ public function clearReservationSubBlockInUseCount() } /** - * [Output Only] The number of in-use reservation subBlocks associated with this reservation block. If at least one VM is running on a subBlock, it is considered in-use. + * [Output Only] The number of in-use reservation subBlocks associated with + * this reservation block. If at least one VM is running on a subBlock, it is + * considered in-use. * * Generated from protobuf field optional int32 reservation_sub_block_in_use_count = 186007137; * @param int $var diff --git a/Compute/src/V1/ReservationBlocksListResponse.php b/Compute/src/V1/ReservationBlocksListResponse.php index 691764f7544c..de866d7baa23 100644 --- a/Compute/src/V1/ReservationBlocksListResponse.php +++ b/Compute/src/V1/ReservationBlocksListResponse.php @@ -28,13 +28,17 @@ class ReservationBlocksListResponse extends \Google\Protobuf\Internal\Message */ private $items; /** - * Type of the resource. Always compute#reservationBlock for a list of reservation blocks. + * Type of the resource. Alwayscompute#reservationBlock for a list of reservation blocks. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -63,9 +67,13 @@ class ReservationBlocksListResponse extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\ReservationBlock>|\Google\Protobuf\Internal\RepeatedField $items * A list of reservation block resources. * @type string $kind - * Type of the resource. Always compute#reservationBlock for a list of reservation blocks. + * Type of the resource. Alwayscompute#reservationBlock for a list of reservation blocks. * @type string $next_page_token - * This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * Server-defined URL for this resource. * @type \Google\Cloud\Compute\V1\Warning $warning @@ -140,7 +148,7 @@ public function setItems($var) } /** - * Type of the resource. Always compute#reservationBlock for a list of reservation blocks. + * Type of the resource. Alwayscompute#reservationBlock for a list of reservation blocks. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -161,7 +169,7 @@ public function clearKind() } /** - * Type of the resource. Always compute#reservationBlock for a list of reservation blocks. + * Type of the resource. Alwayscompute#reservationBlock for a list of reservation blocks. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -176,7 +184,11 @@ public function setKind($var) } /** - * This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -197,7 +209,11 @@ public function clearNextPageToken() } /** - * This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/ReservationList.php b/Compute/src/V1/ReservationList.php index e7bb76bcb3d0..455a19dbd004 100644 --- a/Compute/src/V1/ReservationList.php +++ b/Compute/src/V1/ReservationList.php @@ -15,7 +15,8 @@ class ReservationList extends \Google\Protobuf\Internal\Message { /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional string id = 3355; */ @@ -27,13 +28,18 @@ class ReservationList extends \Google\Protobuf\Internal\Message */ private $items; /** - * [Output Only] Type of resource.Always compute#reservationsList for listsof reservations + * [Output Only] Type of resource.Always compute#reservationsList + * for listsof reservations * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -58,13 +64,19 @@ class ReservationList extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $id - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * @type array<\Google\Cloud\Compute\V1\Reservation>|\Google\Protobuf\Internal\RepeatedField $items * [Output Only] A list of Allocation resources. * @type string $kind - * [Output Only] Type of resource.Always compute#reservationsList for listsof reservations + * [Output Only] Type of resource.Always compute#reservationsList + * for listsof reservations * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type \Google\Cloud\Compute\V1\Warning $warning @@ -77,7 +89,8 @@ public function __construct($data = NULL) { } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional string id = 3355; * @return string @@ -98,7 +111,8 @@ public function clearId() } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional string id = 3355; * @param string $var @@ -139,7 +153,8 @@ public function setItems($var) } /** - * [Output Only] Type of resource.Always compute#reservationsList for listsof reservations + * [Output Only] Type of resource.Always compute#reservationsList + * for listsof reservations * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -160,7 +175,8 @@ public function clearKind() } /** - * [Output Only] Type of resource.Always compute#reservationsList for listsof reservations + * [Output Only] Type of resource.Always compute#reservationsList + * for listsof reservations * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -175,7 +191,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -196,7 +216,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/ReservationSubBlock.php b/Compute/src/V1/ReservationSubBlock.php index e72d384bb0b5..0367e50f7161 100644 --- a/Compute/src/V1/ReservationSubBlock.php +++ b/Compute/src/V1/ReservationSubBlock.php @@ -16,13 +16,20 @@ class ReservationSubBlock extends \Google\Protobuf\Internal\Message { /** - * [Output Only] The number of hosts that are allocated in this reservation subBlock. + * [Output Only] Slice info for the reservation subBlock. + * + * Generated from protobuf field optional .google.cloud.compute.v1.AcceleratorTopologiesInfo accelerator_topologies_info = 84833420; + */ + protected $accelerator_topologies_info = null; + /** + * [Output Only] The number of hosts that are allocated in this + * reservation subBlock. * * Generated from protobuf field optional int32 count = 94851343; */ protected $count = null; /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; */ @@ -34,25 +41,29 @@ class ReservationSubBlock extends \Google\Protobuf\Internal\Message */ protected $health_info = null; /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; */ protected $id = null; /** - * [Output Only] The number of instances that are currently in use on this reservation subBlock. + * [Output Only] The number of instances that are currently in use on this + * reservation subBlock. * * Generated from protobuf field optional int32 in_use_count = 493458877; */ protected $in_use_count = null; /** - * [Output Only] Type of the resource. Always compute#reservationSubBlock for reservation subBlocks. + * [Output Only] Type of the resource. Alwayscompute#reservationSubBlock for reservation subBlocks. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] The name of this reservation subBlock generated by Google Compute Engine. The name must be 1-63 characters long, and comply with RFC1035 @pattern [a-z](?:[-a-z0-9]{0,61}[a-z0-9])? + * [Output Only] The name of this reservation subBlock generated by Google + * Compute Engine. The name must be 1-63 characters long, and comply with + * RFC1035 @pattern [a-z](?:[-a-z0-9]{0,61}[a-z0-9])? * * Generated from protobuf field optional string name = 3373707; */ @@ -101,20 +112,27 @@ class ReservationSubBlock extends \Google\Protobuf\Internal\Message * @param array $data { * Optional. Data for populating the Message object. * + * @type \Google\Cloud\Compute\V1\AcceleratorTopologiesInfo $accelerator_topologies_info + * [Output Only] Slice info for the reservation subBlock. * @type int $count - * [Output Only] The number of hosts that are allocated in this reservation subBlock. + * [Output Only] The number of hosts that are allocated in this + * reservation subBlock. * @type string $creation_timestamp - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 text format. * @type \Google\Cloud\Compute\V1\ReservationSubBlockHealthInfo $health_info * [Output Only] Health information for the reservation subBlock. * @type int|string $id - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * @type int $in_use_count - * [Output Only] The number of instances that are currently in use on this reservation subBlock. + * [Output Only] The number of instances that are currently in use on this + * reservation subBlock. * @type string $kind - * [Output Only] Type of the resource. Always compute#reservationSubBlock for reservation subBlocks. + * [Output Only] Type of the resource. Alwayscompute#reservationSubBlock for reservation subBlocks. * @type string $name - * [Output Only] The name of this reservation subBlock generated by Google Compute Engine. The name must be 1-63 characters long, and comply with RFC1035 @pattern [a-z](?:[-a-z0-9]{0,61}[a-z0-9])? + * [Output Only] The name of this reservation subBlock generated by Google + * Compute Engine. The name must be 1-63 characters long, and comply with + * RFC1035 @pattern [a-z](?:[-a-z0-9]{0,61}[a-z0-9])? * @type \Google\Cloud\Compute\V1\ReservationSubBlockPhysicalTopology $physical_topology * [Output Only] The physical topology of the reservation subBlock. * @type \Google\Cloud\Compute\V1\GroupMaintenanceInfo $reservation_sub_block_maintenance @@ -136,7 +154,44 @@ public function __construct($data = NULL) { } /** - * [Output Only] The number of hosts that are allocated in this reservation subBlock. + * [Output Only] Slice info for the reservation subBlock. + * + * Generated from protobuf field optional .google.cloud.compute.v1.AcceleratorTopologiesInfo accelerator_topologies_info = 84833420; + * @return \Google\Cloud\Compute\V1\AcceleratorTopologiesInfo|null + */ + public function getAcceleratorTopologiesInfo() + { + return $this->accelerator_topologies_info; + } + + public function hasAcceleratorTopologiesInfo() + { + return isset($this->accelerator_topologies_info); + } + + public function clearAcceleratorTopologiesInfo() + { + unset($this->accelerator_topologies_info); + } + + /** + * [Output Only] Slice info for the reservation subBlock. + * + * Generated from protobuf field optional .google.cloud.compute.v1.AcceleratorTopologiesInfo accelerator_topologies_info = 84833420; + * @param \Google\Cloud\Compute\V1\AcceleratorTopologiesInfo $var + * @return $this + */ + public function setAcceleratorTopologiesInfo($var) + { + GPBUtil::checkMessage($var, \Google\Cloud\Compute\V1\AcceleratorTopologiesInfo::class); + $this->accelerator_topologies_info = $var; + + return $this; + } + + /** + * [Output Only] The number of hosts that are allocated in this + * reservation subBlock. * * Generated from protobuf field optional int32 count = 94851343; * @return int @@ -157,7 +212,8 @@ public function clearCount() } /** - * [Output Only] The number of hosts that are allocated in this reservation subBlock. + * [Output Only] The number of hosts that are allocated in this + * reservation subBlock. * * Generated from protobuf field optional int32 count = 94851343; * @param int $var @@ -172,7 +228,7 @@ public function setCount($var) } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @return string @@ -193,7 +249,7 @@ public function clearCreationTimestamp() } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @param string $var @@ -244,7 +300,8 @@ public function setHealthInfo($var) } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @return int|string @@ -265,7 +322,8 @@ public function clearId() } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @param int|string $var @@ -280,7 +338,8 @@ public function setId($var) } /** - * [Output Only] The number of instances that are currently in use on this reservation subBlock. + * [Output Only] The number of instances that are currently in use on this + * reservation subBlock. * * Generated from protobuf field optional int32 in_use_count = 493458877; * @return int @@ -301,7 +360,8 @@ public function clearInUseCount() } /** - * [Output Only] The number of instances that are currently in use on this reservation subBlock. + * [Output Only] The number of instances that are currently in use on this + * reservation subBlock. * * Generated from protobuf field optional int32 in_use_count = 493458877; * @param int $var @@ -316,7 +376,7 @@ public function setInUseCount($var) } /** - * [Output Only] Type of the resource. Always compute#reservationSubBlock for reservation subBlocks. + * [Output Only] Type of the resource. Alwayscompute#reservationSubBlock for reservation subBlocks. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -337,7 +397,7 @@ public function clearKind() } /** - * [Output Only] Type of the resource. Always compute#reservationSubBlock for reservation subBlocks. + * [Output Only] Type of the resource. Alwayscompute#reservationSubBlock for reservation subBlocks. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -352,7 +412,9 @@ public function setKind($var) } /** - * [Output Only] The name of this reservation subBlock generated by Google Compute Engine. The name must be 1-63 characters long, and comply with RFC1035 @pattern [a-z](?:[-a-z0-9]{0,61}[a-z0-9])? + * [Output Only] The name of this reservation subBlock generated by Google + * Compute Engine. The name must be 1-63 characters long, and comply with + * RFC1035 @pattern [a-z](?:[-a-z0-9]{0,61}[a-z0-9])? * * Generated from protobuf field optional string name = 3373707; * @return string @@ -373,7 +435,9 @@ public function clearName() } /** - * [Output Only] The name of this reservation subBlock generated by Google Compute Engine. The name must be 1-63 characters long, and comply with RFC1035 @pattern [a-z](?:[-a-z0-9]{0,61}[a-z0-9])? + * [Output Only] The name of this reservation subBlock generated by Google + * Compute Engine. The name must be 1-63 characters long, and comply with + * RFC1035 @pattern [a-z](?:[-a-z0-9]{0,61}[a-z0-9])? * * Generated from protobuf field optional string name = 3373707; * @param string $var diff --git a/Compute/src/V1/ReservationSubBlockHealthInfo.php b/Compute/src/V1/ReservationSubBlockHealthInfo.php index 0b0930ab14a1..70f5934ef575 100644 --- a/Compute/src/V1/ReservationSubBlockHealthInfo.php +++ b/Compute/src/V1/ReservationSubBlockHealthInfo.php @@ -22,7 +22,8 @@ class ReservationSubBlockHealthInfo extends \Google\Protobuf\Internal\Message */ protected $degraded_host_count = null; /** - * The number of degraded infrastructure (e.g NV link domain) in the reservation subblock. + * The number of degraded infrastructure (e.g NV link domain) in the + * reservation subblock. * * Generated from protobuf field optional int32 degraded_infra_count = 138638927; */ @@ -41,7 +42,8 @@ class ReservationSubBlockHealthInfo extends \Google\Protobuf\Internal\Message */ protected $healthy_host_count = null; /** - * The number of healthy infrastructure (e.g NV link domain) in the reservation subblock. + * The number of healthy infrastructure (e.g NV link domain) in the + * reservation subblock. * * Generated from protobuf field optional int32 healthy_infra_count = 385052222; */ @@ -56,14 +58,16 @@ class ReservationSubBlockHealthInfo extends \Google\Protobuf\Internal\Message * @type int $degraded_host_count * The number of degraded hosts in the reservation subBlock. * @type int $degraded_infra_count - * The number of degraded infrastructure (e.g NV link domain) in the reservation subblock. + * The number of degraded infrastructure (e.g NV link domain) in the + * reservation subblock. * @type string $health_status * The health status of the reservation subBlock. * Check the HealthStatus enum for the list of possible values. * @type int $healthy_host_count * The number of healthy hosts in the reservation subBlock. * @type int $healthy_infra_count - * The number of healthy infrastructure (e.g NV link domain) in the reservation subblock. + * The number of healthy infrastructure (e.g NV link domain) in the + * reservation subblock. * } */ public function __construct($data = NULL) { @@ -108,7 +112,8 @@ public function setDegradedHostCount($var) } /** - * The number of degraded infrastructure (e.g NV link domain) in the reservation subblock. + * The number of degraded infrastructure (e.g NV link domain) in the + * reservation subblock. * * Generated from protobuf field optional int32 degraded_infra_count = 138638927; * @return int @@ -129,7 +134,8 @@ public function clearDegradedInfraCount() } /** - * The number of degraded infrastructure (e.g NV link domain) in the reservation subblock. + * The number of degraded infrastructure (e.g NV link domain) in the + * reservation subblock. * * Generated from protobuf field optional int32 degraded_infra_count = 138638927; * @param int $var @@ -218,7 +224,8 @@ public function setHealthyHostCount($var) } /** - * The number of healthy infrastructure (e.g NV link domain) in the reservation subblock. + * The number of healthy infrastructure (e.g NV link domain) in the + * reservation subblock. * * Generated from protobuf field optional int32 healthy_infra_count = 385052222; * @return int @@ -239,7 +246,8 @@ public function clearHealthyInfraCount() } /** - * The number of healthy infrastructure (e.g NV link domain) in the reservation subblock. + * The number of healthy infrastructure (e.g NV link domain) in the + * reservation subblock. * * Generated from protobuf field optional int32 healthy_infra_count = 385052222; * @param int $var diff --git a/Compute/src/V1/ReservationSubBlocksListResponse.php b/Compute/src/V1/ReservationSubBlocksListResponse.php index 3c59390aa63b..df87680df783 100644 --- a/Compute/src/V1/ReservationSubBlocksListResponse.php +++ b/Compute/src/V1/ReservationSubBlocksListResponse.php @@ -28,13 +28,18 @@ class ReservationSubBlocksListResponse extends \Google\Protobuf\Internal\Message */ private $items; /** - * Type of the resource. Always compute#reservationSubBlock for a list of reservation subBlocks. + * Type of the resource. Alwayscompute#reservationSubBlock for a list of reservation + * subBlocks. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -63,9 +68,14 @@ class ReservationSubBlocksListResponse extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\ReservationSubBlock>|\Google\Protobuf\Internal\RepeatedField $items * A list of reservation subBlock resources. * @type string $kind - * Type of the resource. Always compute#reservationSubBlock for a list of reservation subBlocks. + * Type of the resource. Alwayscompute#reservationSubBlock for a list of reservation + * subBlocks. * @type string $next_page_token - * This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * Server-defined URL for this resource. * @type \Google\Cloud\Compute\V1\Warning $warning @@ -140,7 +150,8 @@ public function setItems($var) } /** - * Type of the resource. Always compute#reservationSubBlock for a list of reservation subBlocks. + * Type of the resource. Alwayscompute#reservationSubBlock for a list of reservation + * subBlocks. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -161,7 +172,8 @@ public function clearKind() } /** - * Type of the resource. Always compute#reservationSubBlock for a list of reservation subBlocks. + * Type of the resource. Alwayscompute#reservationSubBlock for a list of reservation + * subBlocks. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -176,7 +188,11 @@ public function setKind($var) } /** - * This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -197,7 +213,11 @@ public function clearNextPageToken() } /** - * This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/ReservationSubBlocksReportFaultyRequestFaultReason/Behavior.php b/Compute/src/V1/ReservationSubBlocksReportFaultyRequestFaultReason/Behavior.php index 7947db6ed342..ae32d635a26c 100644 --- a/Compute/src/V1/ReservationSubBlocksReportFaultyRequestFaultReason/Behavior.php +++ b/Compute/src/V1/ReservationSubBlocksReportFaultyRequestFaultReason/Behavior.php @@ -35,6 +35,12 @@ class Behavior * Generated from protobuf enum PERFORMANCE = 135701520; */ const PERFORMANCE = 135701520; + /** + * The subBlock experienced silent data corruption. + * + * Generated from protobuf enum SILENT_DATA_CORRUPTION = 111360678; + */ + const SILENT_DATA_CORRUPTION = 111360678; /** * The subBlock experienced a switch failure. * @@ -47,6 +53,7 @@ class Behavior self::FAULT_BEHAVIOR_UNSPECIFIED => 'FAULT_BEHAVIOR_UNSPECIFIED', self::GPU_ERROR => 'GPU_ERROR', self::PERFORMANCE => 'PERFORMANCE', + self::SILENT_DATA_CORRUPTION => 'SILENT_DATA_CORRUPTION', self::SWITCH_FAILURE => 'SWITCH_FAILURE', ]; diff --git a/Compute/src/V1/ReservationsBlocksPerformMaintenanceRequest/MaintenanceScope.php b/Compute/src/V1/ReservationsBlocksPerformMaintenanceRequest/MaintenanceScope.php index 8841fb433269..7320bbfc7ce0 100644 --- a/Compute/src/V1/ReservationsBlocksPerformMaintenanceRequest/MaintenanceScope.php +++ b/Compute/src/V1/ReservationsBlocksPerformMaintenanceRequest/MaintenanceScope.php @@ -20,7 +20,8 @@ class MaintenanceScope */ const UNDEFINED_MAINTENANCE_SCOPE = 0; /** - * Trigger maintenance for all hosts belonging to this reservation irrespective of whether VMs are running on them or not. + * Trigger maintenance for all hosts belonging to this reservation + * irrespective of whether VMs are running on them or not. * * Generated from protobuf enum ALL = 64897; */ @@ -32,13 +33,15 @@ class MaintenanceScope */ const MAINTENANCE_SCOPE_UNSPECIFIED = 78827328; /** - * Trigger maintenance only on the hosts belonging to this reservation which have VMs running on them. + * Trigger maintenance only on the hosts belonging to this reservation which + * have VMs running on them. * * Generated from protobuf enum RUNNING_VMS = 535770588; */ const RUNNING_VMS = 535770588; /** - * Trigger maintenance only on the hosts belonging to this reservation which do not have any VMs running on them. This is not allowed for Standard ExR + * Trigger maintenance only on the hosts belonging to this reservation which + * do not have any VMs running on them. This is not allowed for Standard ExR * * Generated from protobuf enum UNUSED_CAPACITY = 212724995; */ diff --git a/Compute/src/V1/ReservationsPerformMaintenanceRequest/MaintenanceScope.php b/Compute/src/V1/ReservationsPerformMaintenanceRequest/MaintenanceScope.php index 2ca9f39a634d..e6cb15a727bc 100644 --- a/Compute/src/V1/ReservationsPerformMaintenanceRequest/MaintenanceScope.php +++ b/Compute/src/V1/ReservationsPerformMaintenanceRequest/MaintenanceScope.php @@ -20,7 +20,8 @@ class MaintenanceScope */ const UNDEFINED_MAINTENANCE_SCOPE = 0; /** - * Trigger maintenance for all hosts belonging to this reservation irrespective of whether VMs are running on them or not. + * Trigger maintenance for all hosts belonging to this reservation + * irrespective of whether VMs are running on them or not. * * Generated from protobuf enum ALL = 64897; */ @@ -32,13 +33,15 @@ class MaintenanceScope */ const MAINTENANCE_SCOPE_UNSPECIFIED = 78827328; /** - * Trigger maintenance only on the hosts belonging to this reservation which have VMs running on them. + * Trigger maintenance only on the hosts belonging to this reservation which + * have VMs running on them. * * Generated from protobuf enum RUNNING_VMS = 535770588; */ const RUNNING_VMS = 535770588; /** - * Trigger maintenance only on the hosts belonging to this reservation which do not have any VMs running on them. This is not allowed for Standard ExR + * Trigger maintenance only on the hosts belonging to this reservation which + * do not have any VMs running on them. This is not allowed for Standard ExR * * Generated from protobuf enum UNUSED_CAPACITY = 212724995; */ diff --git a/Compute/src/V1/ReservationsResizeRequest.php b/Compute/src/V1/ReservationsResizeRequest.php index f84252697816..8953d7818b98 100644 --- a/Compute/src/V1/ReservationsResizeRequest.php +++ b/Compute/src/V1/ReservationsResizeRequest.php @@ -15,7 +15,8 @@ class ReservationsResizeRequest extends \Google\Protobuf\Internal\Message { /** - * Number of allocated resources can be resized with minimum = 1 and maximum = 1000. + * Number of allocated resources can be resized with minimum = 1 and + * maximum = 1000. * * Generated from protobuf field optional int64 specific_sku_count = 13890720; */ @@ -28,7 +29,8 @@ class ReservationsResizeRequest extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type int|string $specific_sku_count - * Number of allocated resources can be resized with minimum = 1 and maximum = 1000. + * Number of allocated resources can be resized with minimum = 1 and + * maximum = 1000. * } */ public function __construct($data = NULL) { @@ -37,7 +39,8 @@ public function __construct($data = NULL) { } /** - * Number of allocated resources can be resized with minimum = 1 and maximum = 1000. + * Number of allocated resources can be resized with minimum = 1 and + * maximum = 1000. * * Generated from protobuf field optional int64 specific_sku_count = 13890720; * @return int|string @@ -58,7 +61,8 @@ public function clearSpecificSkuCount() } /** - * Number of allocated resources can be resized with minimum = 1 and maximum = 1000. + * Number of allocated resources can be resized with minimum = 1 and + * maximum = 1000. * * Generated from protobuf field optional int64 specific_sku_count = 13890720; * @param int|string $var diff --git a/Compute/src/V1/ReservationsScopedList.php b/Compute/src/V1/ReservationsScopedList.php index 3ecfc5b7366e..f1a20fe4e54c 100644 --- a/Compute/src/V1/ReservationsScopedList.php +++ b/Compute/src/V1/ReservationsScopedList.php @@ -21,7 +21,8 @@ class ReservationsScopedList extends \Google\Protobuf\Internal\Message */ private $reservations; /** - * Informational warning which replaces the list of reservations when the list is empty. + * Informational warning which replaces the list of reservations when + * the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; */ @@ -36,7 +37,8 @@ class ReservationsScopedList extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\Reservation>|\Google\Protobuf\Internal\RepeatedField $reservations * A list of reservations contained in this scope. * @type \Google\Cloud\Compute\V1\Warning $warning - * Informational warning which replaces the list of reservations when the list is empty. + * Informational warning which replaces the list of reservations when + * the list is empty. * } */ public function __construct($data = NULL) { @@ -71,7 +73,8 @@ public function setReservations($var) } /** - * Informational warning which replaces the list of reservations when the list is empty. + * Informational warning which replaces the list of reservations when + * the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; * @return \Google\Cloud\Compute\V1\Warning|null @@ -92,7 +95,8 @@ public function clearWarning() } /** - * Informational warning which replaces the list of reservations when the list is empty. + * Informational warning which replaces the list of reservations when + * the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; * @param \Google\Cloud\Compute\V1\Warning $var diff --git a/Compute/src/V1/ResetInstanceRequest.php b/Compute/src/V1/ResetInstanceRequest.php index 3f3656eea366..69d2fbd78038 100644 --- a/Compute/src/V1/ResetInstanceRequest.php +++ b/Compute/src/V1/ResetInstanceRequest.php @@ -28,7 +28,17 @@ class ResetInstanceRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -68,7 +78,17 @@ public static function build(string $project, string $zone, string $instance): s * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $zone * The name of the zone for this request. * } @@ -131,7 +151,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -152,7 +182,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/ResizeDiskRequest.php b/Compute/src/V1/ResizeDiskRequest.php index 0eec8d34cc90..63e73d73ca09 100644 --- a/Compute/src/V1/ResizeDiskRequest.php +++ b/Compute/src/V1/ResizeDiskRequest.php @@ -34,7 +34,17 @@ class ResizeDiskRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -78,7 +88,17 @@ public static function build(string $project, string $zone, string $disk, \Googl * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $zone * The name of the zone for this request. * } @@ -177,7 +197,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -198,7 +228,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/ResizeInstanceGroupManagerRequest.php b/Compute/src/V1/ResizeInstanceGroupManagerRequest.php index 8b7cf3db5873..700ef630aa9c 100644 --- a/Compute/src/V1/ResizeInstanceGroupManagerRequest.php +++ b/Compute/src/V1/ResizeInstanceGroupManagerRequest.php @@ -28,19 +28,32 @@ class ResizeInstanceGroupManagerRequest extends \Google\Protobuf\Internal\Messag */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ protected $request_id = null; /** - * The number of running instances that the managed instance group should maintain at any given time. The group automatically adds or removes instances to maintain the number of instances specified by this parameter. + * The number of running instances that the managed instance group should + * maintain at any given time. The group automatically adds or removes + * instances to maintain the number of instances specified by this parameter. * * Generated from protobuf field int32 size = 3530753 [(.google.api.field_behavior) = REQUIRED]; */ protected $size = 0; /** - * The name of the zone where the managed instance group is located. + * The name of thezone where the managed + * instance group is located. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; */ @@ -48,9 +61,12 @@ class ResizeInstanceGroupManagerRequest extends \Google\Protobuf\Internal\Messag /** * @param string $project Project ID for this request. - * @param string $zone The name of the zone where the managed instance group is located. + * @param string $zone The name of thezone where the managed + * instance group is located. * @param string $instanceGroupManager The name of the managed instance group. - * @param int $size The number of running instances that the managed instance group should maintain at any given time. The group automatically adds or removes instances to maintain the number of instances specified by this parameter. + * @param int $size The number of running instances that the managed instance group should + * maintain at any given time. The group automatically adds or removes + * instances to maintain the number of instances specified by this parameter. * * @return \Google\Cloud\Compute\V1\ResizeInstanceGroupManagerRequest * @@ -76,11 +92,24 @@ public static function build(string $project, string $zone, string $instanceGrou * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type int $size - * The number of running instances that the managed instance group should maintain at any given time. The group automatically adds or removes instances to maintain the number of instances specified by this parameter. + * The number of running instances that the managed instance group should + * maintain at any given time. The group automatically adds or removes + * instances to maintain the number of instances specified by this parameter. * @type string $zone - * The name of the zone where the managed instance group is located. + * The name of thezone where the managed + * instance group is located. * } */ public function __construct($data = NULL) { @@ -141,7 +170,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -162,7 +201,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var @@ -177,7 +226,9 @@ public function setRequestId($var) } /** - * The number of running instances that the managed instance group should maintain at any given time. The group automatically adds or removes instances to maintain the number of instances specified by this parameter. + * The number of running instances that the managed instance group should + * maintain at any given time. The group automatically adds or removes + * instances to maintain the number of instances specified by this parameter. * * Generated from protobuf field int32 size = 3530753 [(.google.api.field_behavior) = REQUIRED]; * @return int @@ -188,7 +239,9 @@ public function getSize() } /** - * The number of running instances that the managed instance group should maintain at any given time. The group automatically adds or removes instances to maintain the number of instances specified by this parameter. + * The number of running instances that the managed instance group should + * maintain at any given time. The group automatically adds or removes + * instances to maintain the number of instances specified by this parameter. * * Generated from protobuf field int32 size = 3530753 [(.google.api.field_behavior) = REQUIRED]; * @param int $var @@ -203,7 +256,8 @@ public function setSize($var) } /** - * The name of the zone where the managed instance group is located. + * The name of thezone where the managed + * instance group is located. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; * @return string @@ -214,7 +268,8 @@ public function getZone() } /** - * The name of the zone where the managed instance group is located. + * The name of thezone where the managed + * instance group is located. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; * @param string $var diff --git a/Compute/src/V1/ResizeRegionDiskRequest.php b/Compute/src/V1/ResizeRegionDiskRequest.php index e23e57614f51..04623ba99a7a 100644 --- a/Compute/src/V1/ResizeRegionDiskRequest.php +++ b/Compute/src/V1/ResizeRegionDiskRequest.php @@ -40,7 +40,17 @@ class ResizeRegionDiskRequest extends \Google\Protobuf\Internal\Message */ protected $region_disks_resize_request_resource = null; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -80,7 +90,17 @@ public static function build(string $project, string $region, string $disk, \Goo * @type \Google\Cloud\Compute\V1\RegionDisksResizeRequest $region_disks_resize_request_resource * The body resource for this request * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -203,7 +223,17 @@ public function setRegionDisksResizeRequestResource($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -224,7 +254,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/ResizeRegionInstanceGroupManagerRequest.php b/Compute/src/V1/ResizeRegionInstanceGroupManagerRequest.php index e6567906116a..9b71db05ecf7 100644 --- a/Compute/src/V1/ResizeRegionInstanceGroupManagerRequest.php +++ b/Compute/src/V1/ResizeRegionInstanceGroupManagerRequest.php @@ -34,13 +34,24 @@ class ResizeRegionInstanceGroupManagerRequest extends \Google\Protobuf\Internal\ */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ protected $request_id = null; /** - * Number of instances that should exist in this instance group manager. + * Number of instances that should exist in this instance group + * manager. * * Generated from protobuf field int32 size = 3530753 [(.google.api.field_behavior) = REQUIRED]; */ @@ -50,7 +61,8 @@ class ResizeRegionInstanceGroupManagerRequest extends \Google\Protobuf\Internal\ * @param string $project Project ID for this request. * @param string $region Name of the region scoping this request. * @param string $instanceGroupManager Name of the managed instance group. - * @param int $size Number of instances that should exist in this instance group manager. + * @param int $size Number of instances that should exist in this instance group + * manager. * * @return \Google\Cloud\Compute\V1\ResizeRegionInstanceGroupManagerRequest * @@ -78,9 +90,20 @@ public static function build(string $project, string $region, string $instanceGr * @type string $region * Name of the region scoping this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type int $size - * Number of instances that should exist in this instance group manager. + * Number of instances that should exist in this instance group + * manager. * } */ public function __construct($data = NULL) { @@ -167,7 +190,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -188,7 +221,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var @@ -203,7 +246,8 @@ public function setRequestId($var) } /** - * Number of instances that should exist in this instance group manager. + * Number of instances that should exist in this instance group + * manager. * * Generated from protobuf field int32 size = 3530753 [(.google.api.field_behavior) = REQUIRED]; * @return int @@ -214,7 +258,8 @@ public function getSize() } /** - * Number of instances that should exist in this instance group manager. + * Number of instances that should exist in this instance group + * manager. * * Generated from protobuf field int32 size = 3530753 [(.google.api.field_behavior) = REQUIRED]; * @param int $var diff --git a/Compute/src/V1/ResizeReservationRequest.php b/Compute/src/V1/ResizeReservationRequest.php index eab76acb0c59..8fbf6794641d 100644 --- a/Compute/src/V1/ResizeReservationRequest.php +++ b/Compute/src/V1/ResizeReservationRequest.php @@ -22,7 +22,17 @@ class ResizeReservationRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -74,7 +84,17 @@ public static function build(string $project, string $zone, string $reservation, * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $reservation * Name of the reservation to update. * @type \Google\Cloud\Compute\V1\ReservationsResizeRequest $reservations_resize_request_resource @@ -115,7 +135,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -136,7 +166,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/ResourceCommitment.php b/Compute/src/V1/ResourceCommitment.php index 3416a0ca45ec..2c4228edcf88 100644 --- a/Compute/src/V1/ResourceCommitment.php +++ b/Compute/src/V1/ResourceCommitment.php @@ -9,26 +9,43 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Commitment for a particular hardware resource (a commitment is composed of one or more of these). + * Commitment for a particular hardware resource (a commitment is composed of + * one or more of these). * * Generated from protobuf message google.cloud.compute.v1.ResourceCommitment */ class ResourceCommitment extends \Google\Protobuf\Internal\Message { /** - * Name of the accelerator type or GPU resource. Specify this field only when the type of hardware resource is ACCELERATOR. + * Name of the accelerator type or GPU resource. Specify this field only when + * the type of hardware resource is ACCELERATOR. * * Generated from protobuf field optional string accelerator_type = 138031246; */ protected $accelerator_type = null; /** - * The quantity of the hardware resource that you want to commit to purchasing (in a type-dependent unit). - For vCPUs, you must specify an integer value. - For memory, you specify the amount of MB that you want. The value you specify must be a multiple of 256 MB, with up to 6.5 GB of memory per every vCPU. - For GPUs, you must specify an integer value. - For Local SSD disks, you must specify the amount in GB. The size of a single Local SSD disk is 375 GB. + * The quantity of the hardware resource that you want to commit to purchasing + * (in a type-dependent unit). + * - For vCPUs, you must specify an integer value. + * - For memory, you specify the amount of MB that you want. The value you + * specify must be a multiple of 256 MB, with up to 6.5 GB of + * memory per every vCPU. + * - For GPUs, you must specify an integer value. + * - For Local SSD disks, you must specify the amount in GB. The size of a + * single Local SSD disk is 375 GB. * * Generated from protobuf field optional int64 amount = 196759640; */ protected $amount = null; /** - * The type of hardware resource that you want to specify. You can specify any of the following values: - VCPU - MEMORY - LOCAL_SSD - ACCELERATOR Specify as a separate entry in the list for each individual resource type. + * The type of hardware resource that you want to specify. + * You can specify any of the following values: + * - VCPU + * - MEMORY + * - LOCAL_SSD + * - ACCELERATOR + * Specify as a separate entry in the list for each + * individual resource type. * Check the Type enum for the list of possible values. * * Generated from protobuf field optional string type = 3575610; @@ -42,11 +59,27 @@ class ResourceCommitment extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $accelerator_type - * Name of the accelerator type or GPU resource. Specify this field only when the type of hardware resource is ACCELERATOR. + * Name of the accelerator type or GPU resource. Specify this field only when + * the type of hardware resource is ACCELERATOR. * @type int|string $amount - * The quantity of the hardware resource that you want to commit to purchasing (in a type-dependent unit). - For vCPUs, you must specify an integer value. - For memory, you specify the amount of MB that you want. The value you specify must be a multiple of 256 MB, with up to 6.5 GB of memory per every vCPU. - For GPUs, you must specify an integer value. - For Local SSD disks, you must specify the amount in GB. The size of a single Local SSD disk is 375 GB. + * The quantity of the hardware resource that you want to commit to purchasing + * (in a type-dependent unit). + * - For vCPUs, you must specify an integer value. + * - For memory, you specify the amount of MB that you want. The value you + * specify must be a multiple of 256 MB, with up to 6.5 GB of + * memory per every vCPU. + * - For GPUs, you must specify an integer value. + * - For Local SSD disks, you must specify the amount in GB. The size of a + * single Local SSD disk is 375 GB. * @type string $type - * The type of hardware resource that you want to specify. You can specify any of the following values: - VCPU - MEMORY - LOCAL_SSD - ACCELERATOR Specify as a separate entry in the list for each individual resource type. + * The type of hardware resource that you want to specify. + * You can specify any of the following values: + * - VCPU + * - MEMORY + * - LOCAL_SSD + * - ACCELERATOR + * Specify as a separate entry in the list for each + * individual resource type. * Check the Type enum for the list of possible values. * } */ @@ -56,7 +89,8 @@ public function __construct($data = NULL) { } /** - * Name of the accelerator type or GPU resource. Specify this field only when the type of hardware resource is ACCELERATOR. + * Name of the accelerator type or GPU resource. Specify this field only when + * the type of hardware resource is ACCELERATOR. * * Generated from protobuf field optional string accelerator_type = 138031246; * @return string @@ -77,7 +111,8 @@ public function clearAcceleratorType() } /** - * Name of the accelerator type or GPU resource. Specify this field only when the type of hardware resource is ACCELERATOR. + * Name of the accelerator type or GPU resource. Specify this field only when + * the type of hardware resource is ACCELERATOR. * * Generated from protobuf field optional string accelerator_type = 138031246; * @param string $var @@ -92,7 +127,15 @@ public function setAcceleratorType($var) } /** - * The quantity of the hardware resource that you want to commit to purchasing (in a type-dependent unit). - For vCPUs, you must specify an integer value. - For memory, you specify the amount of MB that you want. The value you specify must be a multiple of 256 MB, with up to 6.5 GB of memory per every vCPU. - For GPUs, you must specify an integer value. - For Local SSD disks, you must specify the amount in GB. The size of a single Local SSD disk is 375 GB. + * The quantity of the hardware resource that you want to commit to purchasing + * (in a type-dependent unit). + * - For vCPUs, you must specify an integer value. + * - For memory, you specify the amount of MB that you want. The value you + * specify must be a multiple of 256 MB, with up to 6.5 GB of + * memory per every vCPU. + * - For GPUs, you must specify an integer value. + * - For Local SSD disks, you must specify the amount in GB. The size of a + * single Local SSD disk is 375 GB. * * Generated from protobuf field optional int64 amount = 196759640; * @return int|string @@ -113,7 +156,15 @@ public function clearAmount() } /** - * The quantity of the hardware resource that you want to commit to purchasing (in a type-dependent unit). - For vCPUs, you must specify an integer value. - For memory, you specify the amount of MB that you want. The value you specify must be a multiple of 256 MB, with up to 6.5 GB of memory per every vCPU. - For GPUs, you must specify an integer value. - For Local SSD disks, you must specify the amount in GB. The size of a single Local SSD disk is 375 GB. + * The quantity of the hardware resource that you want to commit to purchasing + * (in a type-dependent unit). + * - For vCPUs, you must specify an integer value. + * - For memory, you specify the amount of MB that you want. The value you + * specify must be a multiple of 256 MB, with up to 6.5 GB of + * memory per every vCPU. + * - For GPUs, you must specify an integer value. + * - For Local SSD disks, you must specify the amount in GB. The size of a + * single Local SSD disk is 375 GB. * * Generated from protobuf field optional int64 amount = 196759640; * @param int|string $var @@ -128,7 +179,14 @@ public function setAmount($var) } /** - * The type of hardware resource that you want to specify. You can specify any of the following values: - VCPU - MEMORY - LOCAL_SSD - ACCELERATOR Specify as a separate entry in the list for each individual resource type. + * The type of hardware resource that you want to specify. + * You can specify any of the following values: + * - VCPU + * - MEMORY + * - LOCAL_SSD + * - ACCELERATOR + * Specify as a separate entry in the list for each + * individual resource type. * Check the Type enum for the list of possible values. * * Generated from protobuf field optional string type = 3575610; @@ -150,7 +208,14 @@ public function clearType() } /** - * The type of hardware resource that you want to specify. You can specify any of the following values: - VCPU - MEMORY - LOCAL_SSD - ACCELERATOR Specify as a separate entry in the list for each individual resource type. + * The type of hardware resource that you want to specify. + * You can specify any of the following values: + * - VCPU + * - MEMORY + * - LOCAL_SSD + * - ACCELERATOR + * Specify as a separate entry in the list for each + * individual resource type. * Check the Type enum for the list of possible values. * * Generated from protobuf field optional string type = 3575610; diff --git a/Compute/src/V1/ResourceCommitment/Type.php b/Compute/src/V1/ResourceCommitment/Type.php index 151346781d1e..d4184ba9abe2 100644 --- a/Compute/src/V1/ResourceCommitment/Type.php +++ b/Compute/src/V1/ResourceCommitment/Type.php @@ -7,7 +7,14 @@ use UnexpectedValueException; /** - * The type of hardware resource that you want to specify. You can specify any of the following values: - VCPU - MEMORY - LOCAL_SSD - ACCELERATOR Specify as a separate entry in the list for each individual resource type. + * The type of hardware resource that you want to specify. + * You can specify any of the following values: + * - VCPU + * - MEMORY + * - LOCAL_SSD + * - ACCELERATOR + * Specify as a separate entry in the list for each + * individual resource type. * * Protobuf type google.cloud.compute.v1.ResourceCommitment.Type */ diff --git a/Compute/src/V1/ResourceGroupReference.php b/Compute/src/V1/ResourceGroupReference.php index d325aa351c9c..027e6d7b7445 100644 --- a/Compute/src/V1/ResourceGroupReference.php +++ b/Compute/src/V1/ResourceGroupReference.php @@ -15,7 +15,8 @@ class ResourceGroupReference extends \Google\Protobuf\Internal\Message { /** - * A URI referencing one of the instance groups or network endpoint groups listed in the backend service. + * A URI referencing one of the instance groups or network endpoint groups + * listed in the backend service. * * Generated from protobuf field optional string group = 98629247; */ @@ -28,7 +29,8 @@ class ResourceGroupReference extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $group - * A URI referencing one of the instance groups or network endpoint groups listed in the backend service. + * A URI referencing one of the instance groups or network endpoint groups + * listed in the backend service. * } */ public function __construct($data = NULL) { @@ -37,7 +39,8 @@ public function __construct($data = NULL) { } /** - * A URI referencing one of the instance groups or network endpoint groups listed in the backend service. + * A URI referencing one of the instance groups or network endpoint groups + * listed in the backend service. * * Generated from protobuf field optional string group = 98629247; * @return string @@ -58,7 +61,8 @@ public function clearGroup() } /** - * A URI referencing one of the instance groups or network endpoint groups listed in the backend service. + * A URI referencing one of the instance groups or network endpoint groups + * listed in the backend service. * * Generated from protobuf field optional string group = 98629247; * @param string $var diff --git a/Compute/src/V1/ResourcePoliciesScopedList.php b/Compute/src/V1/ResourcePoliciesScopedList.php index 9e3e7d8009dc..99d50b1c254f 100644 --- a/Compute/src/V1/ResourcePoliciesScopedList.php +++ b/Compute/src/V1/ResourcePoliciesScopedList.php @@ -21,7 +21,8 @@ class ResourcePoliciesScopedList extends \Google\Protobuf\Internal\Message */ private $resource_policies; /** - * Informational warning which replaces the list of resourcePolicies when the list is empty. + * Informational warning which replaces the list of resourcePolicies when + * the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; */ @@ -36,7 +37,8 @@ class ResourcePoliciesScopedList extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\ResourcePolicy>|\Google\Protobuf\Internal\RepeatedField $resource_policies * A list of resourcePolicies contained in this scope. * @type \Google\Cloud\Compute\V1\Warning $warning - * Informational warning which replaces the list of resourcePolicies when the list is empty. + * Informational warning which replaces the list of resourcePolicies when + * the list is empty. * } */ public function __construct($data = NULL) { @@ -71,7 +73,8 @@ public function setResourcePolicies($var) } /** - * Informational warning which replaces the list of resourcePolicies when the list is empty. + * Informational warning which replaces the list of resourcePolicies when + * the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; * @return \Google\Cloud\Compute\V1\Warning|null @@ -92,7 +95,8 @@ public function clearWarning() } /** - * Informational warning which replaces the list of resourcePolicies when the list is empty. + * Informational warning which replaces the list of resourcePolicies when + * the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; * @param \Google\Cloud\Compute\V1\Warning $var diff --git a/Compute/src/V1/ResourcePolicy.php b/Compute/src/V1/ResourcePolicy.php index 185ab80efe1d..23d79e87314f 100644 --- a/Compute/src/V1/ResourcePolicy.php +++ b/Compute/src/V1/ResourcePolicy.php @@ -9,14 +9,18 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Represents a Resource Policy resource. You can use resource policies to schedule actions for some Compute Engine resources. For example, you can use them to schedule persistent disk snapshots. + * Represents a Resource Policy resource. You can use resource policies to + * schedule actions for some Compute Engine resources. For example, you can + * use them toschedule persistent disk + * snapshots. * * Generated from protobuf message google.cloud.compute.v1.ResourcePolicy */ class ResourcePolicy extends \Google\Protobuf\Internal\Message { /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; */ @@ -38,7 +42,8 @@ class ResourcePolicy extends \Google\Protobuf\Internal\Message */ protected $group_placement_policy = null; /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; */ @@ -50,13 +55,20 @@ class ResourcePolicy extends \Google\Protobuf\Internal\Message */ protected $instance_schedule_policy = null; /** - * [Output Only] Type of the resource. Always compute#resource_policies for resource policies. + * [Output Only] Type of the resource. Alwayscompute#resource_policies for resource policies. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * The name of the resource, provided by the client when initially creating the resource. The resource name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * The name of the resource, provided by the client when initially creating + * the resource. The resource name must be 1-63 characters long, and comply + * withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must be + * a dash, lowercase letter, or digit, except the last character, which cannot + * be a dash. * * Generated from protobuf field optional string name = 3373707; */ @@ -104,20 +116,29 @@ class ResourcePolicy extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $creation_timestamp - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * @type string $description * @type \Google\Cloud\Compute\V1\ResourcePolicyDiskConsistencyGroupPolicy $disk_consistency_group_policy * Resource policy for disk consistency groups. * @type \Google\Cloud\Compute\V1\ResourcePolicyGroupPlacementPolicy $group_placement_policy * Resource policy for instances for placement configuration. * @type int|string $id - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * @type \Google\Cloud\Compute\V1\ResourcePolicyInstanceSchedulePolicy $instance_schedule_policy * Resource policy for scheduling instance operations. * @type string $kind - * [Output Only] Type of the resource. Always compute#resource_policies for resource policies. + * [Output Only] Type of the resource. Alwayscompute#resource_policies for resource policies. * @type string $name - * The name of the resource, provided by the client when initially creating the resource. The resource name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * The name of the resource, provided by the client when initially creating + * the resource. The resource name must be 1-63 characters long, and comply + * withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must be + * a dash, lowercase letter, or digit, except the last character, which cannot + * be a dash. * @type string $region * @type \Google\Cloud\Compute\V1\ResourcePolicyResourceStatus $resource_status * [Output Only] The system status of the resource policy. @@ -138,7 +159,8 @@ public function __construct($data = NULL) { } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @return string @@ -159,7 +181,8 @@ public function clearCreationTimestamp() } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @param string $var @@ -278,7 +301,8 @@ public function setGroupPlacementPolicy($var) } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @return int|string @@ -299,7 +323,8 @@ public function clearId() } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @param int|string $var @@ -350,7 +375,7 @@ public function setInstanceSchedulePolicy($var) } /** - * [Output Only] Type of the resource. Always compute#resource_policies for resource policies. + * [Output Only] Type of the resource. Alwayscompute#resource_policies for resource policies. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -371,7 +396,7 @@ public function clearKind() } /** - * [Output Only] Type of the resource. Always compute#resource_policies for resource policies. + * [Output Only] Type of the resource. Alwayscompute#resource_policies for resource policies. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -386,7 +411,14 @@ public function setKind($var) } /** - * The name of the resource, provided by the client when initially creating the resource. The resource name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * The name of the resource, provided by the client when initially creating + * the resource. The resource name must be 1-63 characters long, and comply + * withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must be + * a dash, lowercase letter, or digit, except the last character, which cannot + * be a dash. * * Generated from protobuf field optional string name = 3373707; * @return string @@ -407,7 +439,14 @@ public function clearName() } /** - * The name of the resource, provided by the client when initially creating the resource. The resource name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * The name of the resource, provided by the client when initially creating + * the resource. The resource name must be 1-63 characters long, and comply + * withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must be + * a dash, lowercase letter, or digit, except the last character, which cannot + * be a dash. * * Generated from protobuf field optional string name = 3373707; * @param string $var diff --git a/Compute/src/V1/ResourcePolicyAggregatedList.php b/Compute/src/V1/ResourcePolicyAggregatedList.php index ed4b0e4da048..b93ca9df0903 100644 --- a/Compute/src/V1/ResourcePolicyAggregatedList.php +++ b/Compute/src/V1/ResourcePolicyAggregatedList.php @@ -38,7 +38,11 @@ class ResourcePolicyAggregatedList extends \Google\Protobuf\Internal\Message */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -76,7 +80,11 @@ class ResourcePolicyAggregatedList extends \Google\Protobuf\Internal\Message * @type string $kind * Type of resource. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type array|\Google\Protobuf\Internal\RepeatedField $unreachables @@ -221,7 +229,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -242,7 +254,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/ResourcePolicyDailyCycle.php b/Compute/src/V1/ResourcePolicyDailyCycle.php index 300c1a9174e5..7493c8b1f4e8 100644 --- a/Compute/src/V1/ResourcePolicyDailyCycle.php +++ b/Compute/src/V1/ResourcePolicyDailyCycle.php @@ -16,19 +16,23 @@ class ResourcePolicyDailyCycle extends \Google\Protobuf\Internal\Message { /** - * Defines a schedule with units measured in days. The value determines how many days pass between the start of each cycle. + * Defines a schedule with units measured in days. The value determines + * how many days pass between the start of each cycle. * * Generated from protobuf field optional int32 days_in_cycle = 369790004; */ protected $days_in_cycle = null; /** - * [Output only] A predetermined duration for the window, automatically chosen to be the smallest possible in the given scenario. + * [Output only] A predetermined duration for the window, automatically + * chosen to be the smallest possible in the given scenario. * * Generated from protobuf field optional string duration = 155471252; */ protected $duration = null; /** - * Start time of the window. This must be in UTC format that resolves to one of 00:00, 04:00, 08:00, 12:00, 16:00, or 20:00. For example, both 13:00-5 and 08:00 are valid. + * Start time of the window. This must be in UTC format that resolves to one + * of 00:00, 04:00, 08:00,12:00, 16:00, or 20:00. For + * example, both 13:00-5 and 08:00 are valid. * * Generated from protobuf field optional string start_time = 37467274; */ @@ -41,11 +45,15 @@ class ResourcePolicyDailyCycle extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type int $days_in_cycle - * Defines a schedule with units measured in days. The value determines how many days pass between the start of each cycle. + * Defines a schedule with units measured in days. The value determines + * how many days pass between the start of each cycle. * @type string $duration - * [Output only] A predetermined duration for the window, automatically chosen to be the smallest possible in the given scenario. + * [Output only] A predetermined duration for the window, automatically + * chosen to be the smallest possible in the given scenario. * @type string $start_time - * Start time of the window. This must be in UTC format that resolves to one of 00:00, 04:00, 08:00, 12:00, 16:00, or 20:00. For example, both 13:00-5 and 08:00 are valid. + * Start time of the window. This must be in UTC format that resolves to one + * of 00:00, 04:00, 08:00,12:00, 16:00, or 20:00. For + * example, both 13:00-5 and 08:00 are valid. * } */ public function __construct($data = NULL) { @@ -54,7 +62,8 @@ public function __construct($data = NULL) { } /** - * Defines a schedule with units measured in days. The value determines how many days pass between the start of each cycle. + * Defines a schedule with units measured in days. The value determines + * how many days pass between the start of each cycle. * * Generated from protobuf field optional int32 days_in_cycle = 369790004; * @return int @@ -75,7 +84,8 @@ public function clearDaysInCycle() } /** - * Defines a schedule with units measured in days. The value determines how many days pass between the start of each cycle. + * Defines a schedule with units measured in days. The value determines + * how many days pass between the start of each cycle. * * Generated from protobuf field optional int32 days_in_cycle = 369790004; * @param int $var @@ -90,7 +100,8 @@ public function setDaysInCycle($var) } /** - * [Output only] A predetermined duration for the window, automatically chosen to be the smallest possible in the given scenario. + * [Output only] A predetermined duration for the window, automatically + * chosen to be the smallest possible in the given scenario. * * Generated from protobuf field optional string duration = 155471252; * @return string @@ -111,7 +122,8 @@ public function clearDuration() } /** - * [Output only] A predetermined duration for the window, automatically chosen to be the smallest possible in the given scenario. + * [Output only] A predetermined duration for the window, automatically + * chosen to be the smallest possible in the given scenario. * * Generated from protobuf field optional string duration = 155471252; * @param string $var @@ -126,7 +138,9 @@ public function setDuration($var) } /** - * Start time of the window. This must be in UTC format that resolves to one of 00:00, 04:00, 08:00, 12:00, 16:00, or 20:00. For example, both 13:00-5 and 08:00 are valid. + * Start time of the window. This must be in UTC format that resolves to one + * of 00:00, 04:00, 08:00,12:00, 16:00, or 20:00. For + * example, both 13:00-5 and 08:00 are valid. * * Generated from protobuf field optional string start_time = 37467274; * @return string @@ -147,7 +161,9 @@ public function clearStartTime() } /** - * Start time of the window. This must be in UTC format that resolves to one of 00:00, 04:00, 08:00, 12:00, 16:00, or 20:00. For example, both 13:00-5 and 08:00 are valid. + * Start time of the window. This must be in UTC format that resolves to one + * of 00:00, 04:00, 08:00,12:00, 16:00, or 20:00. For + * example, both 13:00-5 and 08:00 are valid. * * Generated from protobuf field optional string start_time = 37467274; * @param string $var diff --git a/Compute/src/V1/ResourcePolicyGroupPlacementPolicy.php b/Compute/src/V1/ResourcePolicyGroupPlacementPolicy.php index cec1cf90d1c4..3c0e8a36a952 100644 --- a/Compute/src/V1/ResourcePolicyGroupPlacementPolicy.php +++ b/Compute/src/V1/ResourcePolicyGroupPlacementPolicy.php @@ -9,14 +9,17 @@ use Google\Protobuf\Internal\GPBUtil; /** - * A GroupPlacementPolicy specifies resource placement configuration. It specifies the failure bucket separation + * A GroupPlacementPolicy specifies resource placement configuration. + * It specifies the failure bucket separation * * Generated from protobuf message google.cloud.compute.v1.ResourcePolicyGroupPlacementPolicy */ class ResourcePolicyGroupPlacementPolicy extends \Google\Protobuf\Internal\Message { /** - * The number of availability domains to spread instances across. If two instances are in different availability domain, they are not in the same low latency network. + * The number of availability domains to spread instances across. If two + * instances are in different availability domain, they are not in the same + * low latency network. * * Generated from protobuf field optional int32 availability_domain_count = 12453432; */ @@ -29,13 +32,16 @@ class ResourcePolicyGroupPlacementPolicy extends \Google\Protobuf\Internal\Messa */ protected $collocation = null; /** - * Specifies the shape of the GPU slice, in slice based GPU families eg. A4X. + * Specifies the shape of the GPU slice, in slice based GPU families eg. + * A4X. * * Generated from protobuf field optional string gpu_topology = 247948450; */ protected $gpu_topology = null; /** - * Number of VMs in this placement group. Google does not recommend that you use this field unless you use a compact policy and you want your policy to work only if it contains this exact number of VMs. + * Number of VMs in this placement group. Google does not recommend that you + * use this field unless you use a compact policy and you want your policy + * to work only if it contains this exact number of VMs. * * Generated from protobuf field optional int32 vm_count = 261463431; */ @@ -48,14 +54,19 @@ class ResourcePolicyGroupPlacementPolicy extends \Google\Protobuf\Internal\Messa * Optional. Data for populating the Message object. * * @type int $availability_domain_count - * The number of availability domains to spread instances across. If two instances are in different availability domain, they are not in the same low latency network. + * The number of availability domains to spread instances across. If two + * instances are in different availability domain, they are not in the same + * low latency network. * @type string $collocation * Specifies network collocation * Check the Collocation enum for the list of possible values. * @type string $gpu_topology - * Specifies the shape of the GPU slice, in slice based GPU families eg. A4X. + * Specifies the shape of the GPU slice, in slice based GPU families eg. + * A4X. * @type int $vm_count - * Number of VMs in this placement group. Google does not recommend that you use this field unless you use a compact policy and you want your policy to work only if it contains this exact number of VMs. + * Number of VMs in this placement group. Google does not recommend that you + * use this field unless you use a compact policy and you want your policy + * to work only if it contains this exact number of VMs. * } */ public function __construct($data = NULL) { @@ -64,7 +75,9 @@ public function __construct($data = NULL) { } /** - * The number of availability domains to spread instances across. If two instances are in different availability domain, they are not in the same low latency network. + * The number of availability domains to spread instances across. If two + * instances are in different availability domain, they are not in the same + * low latency network. * * Generated from protobuf field optional int32 availability_domain_count = 12453432; * @return int @@ -85,7 +98,9 @@ public function clearAvailabilityDomainCount() } /** - * The number of availability domains to spread instances across. If two instances are in different availability domain, they are not in the same low latency network. + * The number of availability domains to spread instances across. If two + * instances are in different availability domain, they are not in the same + * low latency network. * * Generated from protobuf field optional int32 availability_domain_count = 12453432; * @param int $var @@ -138,7 +153,8 @@ public function setCollocation($var) } /** - * Specifies the shape of the GPU slice, in slice based GPU families eg. A4X. + * Specifies the shape of the GPU slice, in slice based GPU families eg. + * A4X. * * Generated from protobuf field optional string gpu_topology = 247948450; * @return string @@ -159,7 +175,8 @@ public function clearGpuTopology() } /** - * Specifies the shape of the GPU slice, in slice based GPU families eg. A4X. + * Specifies the shape of the GPU slice, in slice based GPU families eg. + * A4X. * * Generated from protobuf field optional string gpu_topology = 247948450; * @param string $var @@ -174,7 +191,9 @@ public function setGpuTopology($var) } /** - * Number of VMs in this placement group. Google does not recommend that you use this field unless you use a compact policy and you want your policy to work only if it contains this exact number of VMs. + * Number of VMs in this placement group. Google does not recommend that you + * use this field unless you use a compact policy and you want your policy + * to work only if it contains this exact number of VMs. * * Generated from protobuf field optional int32 vm_count = 261463431; * @return int @@ -195,7 +214,9 @@ public function clearVmCount() } /** - * Number of VMs in this placement group. Google does not recommend that you use this field unless you use a compact policy and you want your policy to work only if it contains this exact number of VMs. + * Number of VMs in this placement group. Google does not recommend that you + * use this field unless you use a compact policy and you want your policy + * to work only if it contains this exact number of VMs. * * Generated from protobuf field optional int32 vm_count = 261463431; * @param int $var diff --git a/Compute/src/V1/ResourcePolicyHourlyCycle.php b/Compute/src/V1/ResourcePolicyHourlyCycle.php index 41eb52b02c39..946b120163a1 100644 --- a/Compute/src/V1/ResourcePolicyHourlyCycle.php +++ b/Compute/src/V1/ResourcePolicyHourlyCycle.php @@ -16,19 +16,22 @@ class ResourcePolicyHourlyCycle extends \Google\Protobuf\Internal\Message { /** - * [Output only] Duration of the time window, automatically chosen to be smallest possible in the given scenario. + * [Output only] Duration of the time window, automatically chosen to be + * smallest possible in the given scenario. * * Generated from protobuf field optional string duration = 155471252; */ protected $duration = null; /** - * Defines a schedule with units measured in hours. The value determines how many hours pass between the start of each cycle. + * Defines a schedule with units measured in hours. The value determines + * how many hours pass between the start of each cycle. * * Generated from protobuf field optional int32 hours_in_cycle = 526763132; */ protected $hours_in_cycle = null; /** - * Time within the window to start the operations. It must be in format "HH:MM", where HH : [00-23] and MM : [00-00] GMT. + * Time within the window to start the operations. + * It must be in format "HH:MM", where HH : [00-23] and MM : [00-00] GMT. * * Generated from protobuf field optional string start_time = 37467274; */ @@ -41,11 +44,14 @@ class ResourcePolicyHourlyCycle extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $duration - * [Output only] Duration of the time window, automatically chosen to be smallest possible in the given scenario. + * [Output only] Duration of the time window, automatically chosen to be + * smallest possible in the given scenario. * @type int $hours_in_cycle - * Defines a schedule with units measured in hours. The value determines how many hours pass between the start of each cycle. + * Defines a schedule with units measured in hours. The value determines + * how many hours pass between the start of each cycle. * @type string $start_time - * Time within the window to start the operations. It must be in format "HH:MM", where HH : [00-23] and MM : [00-00] GMT. + * Time within the window to start the operations. + * It must be in format "HH:MM", where HH : [00-23] and MM : [00-00] GMT. * } */ public function __construct($data = NULL) { @@ -54,7 +60,8 @@ public function __construct($data = NULL) { } /** - * [Output only] Duration of the time window, automatically chosen to be smallest possible in the given scenario. + * [Output only] Duration of the time window, automatically chosen to be + * smallest possible in the given scenario. * * Generated from protobuf field optional string duration = 155471252; * @return string @@ -75,7 +82,8 @@ public function clearDuration() } /** - * [Output only] Duration of the time window, automatically chosen to be smallest possible in the given scenario. + * [Output only] Duration of the time window, automatically chosen to be + * smallest possible in the given scenario. * * Generated from protobuf field optional string duration = 155471252; * @param string $var @@ -90,7 +98,8 @@ public function setDuration($var) } /** - * Defines a schedule with units measured in hours. The value determines how many hours pass between the start of each cycle. + * Defines a schedule with units measured in hours. The value determines + * how many hours pass between the start of each cycle. * * Generated from protobuf field optional int32 hours_in_cycle = 526763132; * @return int @@ -111,7 +120,8 @@ public function clearHoursInCycle() } /** - * Defines a schedule with units measured in hours. The value determines how many hours pass between the start of each cycle. + * Defines a schedule with units measured in hours. The value determines + * how many hours pass between the start of each cycle. * * Generated from protobuf field optional int32 hours_in_cycle = 526763132; * @param int $var @@ -126,7 +136,8 @@ public function setHoursInCycle($var) } /** - * Time within the window to start the operations. It must be in format "HH:MM", where HH : [00-23] and MM : [00-00] GMT. + * Time within the window to start the operations. + * It must be in format "HH:MM", where HH : [00-23] and MM : [00-00] GMT. * * Generated from protobuf field optional string start_time = 37467274; * @return string @@ -147,7 +158,8 @@ public function clearStartTime() } /** - * Time within the window to start the operations. It must be in format "HH:MM", where HH : [00-23] and MM : [00-00] GMT. + * Time within the window to start the operations. + * It must be in format "HH:MM", where HH : [00-23] and MM : [00-00] GMT. * * Generated from protobuf field optional string start_time = 37467274; * @param string $var diff --git a/Compute/src/V1/ResourcePolicyInstanceSchedulePolicy.php b/Compute/src/V1/ResourcePolicyInstanceSchedulePolicy.php index 1cf826e3b7e5..15046eb50b6b 100644 --- a/Compute/src/V1/ResourcePolicyInstanceSchedulePolicy.php +++ b/Compute/src/V1/ResourcePolicyInstanceSchedulePolicy.php @@ -9,7 +9,8 @@ use Google\Protobuf\Internal\GPBUtil; /** - * An InstanceSchedulePolicy specifies when and how frequent certain operations are performed on the instance. + * An InstanceSchedulePolicy specifies when and how frequent certain + * operations are performed on the instance. * * Generated from protobuf message google.cloud.compute.v1.ResourcePolicyInstanceSchedulePolicy */ @@ -28,7 +29,9 @@ class ResourcePolicyInstanceSchedulePolicy extends \Google\Protobuf\Internal\Mes */ protected $start_time = null; /** - * Specifies the time zone to be used in interpreting Schedule.schedule. The value of this field must be a time zone name from the tz database: https://wikipedia.org/wiki/Tz_database. + * Specifies the time zone to be used in interpreting Schedule.schedule. + * The value of this field must be a time zone name from the tz database: + * https://wikipedia.org/wiki/Tz_database. * * Generated from protobuf field optional string time_zone = 36848094; */ @@ -57,7 +60,9 @@ class ResourcePolicyInstanceSchedulePolicy extends \Google\Protobuf\Internal\Mes * @type string $start_time * The start time of the schedule. The timestamp is an RFC3339 string. * @type string $time_zone - * Specifies the time zone to be used in interpreting Schedule.schedule. The value of this field must be a time zone name from the tz database: https://wikipedia.org/wiki/Tz_database. + * Specifies the time zone to be used in interpreting Schedule.schedule. + * The value of this field must be a time zone name from the tz database: + * https://wikipedia.org/wiki/Tz_database. * @type \Google\Cloud\Compute\V1\ResourcePolicyInstanceSchedulePolicySchedule $vm_start_schedule * Specifies the schedule for starting instances. * @type \Google\Cloud\Compute\V1\ResourcePolicyInstanceSchedulePolicySchedule $vm_stop_schedule @@ -142,7 +147,9 @@ public function setStartTime($var) } /** - * Specifies the time zone to be used in interpreting Schedule.schedule. The value of this field must be a time zone name from the tz database: https://wikipedia.org/wiki/Tz_database. + * Specifies the time zone to be used in interpreting Schedule.schedule. + * The value of this field must be a time zone name from the tz database: + * https://wikipedia.org/wiki/Tz_database. * * Generated from protobuf field optional string time_zone = 36848094; * @return string @@ -163,7 +170,9 @@ public function clearTimeZone() } /** - * Specifies the time zone to be used in interpreting Schedule.schedule. The value of this field must be a time zone name from the tz database: https://wikipedia.org/wiki/Tz_database. + * Specifies the time zone to be used in interpreting Schedule.schedule. + * The value of this field must be a time zone name from the tz database: + * https://wikipedia.org/wiki/Tz_database. * * Generated from protobuf field optional string time_zone = 36848094; * @param string $var diff --git a/Compute/src/V1/ResourcePolicyList.php b/Compute/src/V1/ResourcePolicyList.php index e0b77c79dbff..e118b6866c0c 100644 --- a/Compute/src/V1/ResourcePolicyList.php +++ b/Compute/src/V1/ResourcePolicyList.php @@ -19,7 +19,8 @@ class ResourcePolicyList extends \Google\Protobuf\Internal\Message */ protected $etag = null; /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional string id = 3355; */ @@ -31,13 +32,17 @@ class ResourcePolicyList extends \Google\Protobuf\Internal\Message */ private $items; /** - * [Output Only] Type of resource.Always compute#resourcePoliciesList for listsof resourcePolicies + * [Output Only] Type of resource.Alwayscompute#resourcePoliciesList for listsof resourcePolicies * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -63,13 +68,18 @@ class ResourcePolicyList extends \Google\Protobuf\Internal\Message * * @type string $etag * @type string $id - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * @type array<\Google\Cloud\Compute\V1\ResourcePolicy>|\Google\Protobuf\Internal\RepeatedField $items * [Output Only] A list of ResourcePolicy resources. * @type string $kind - * [Output Only] Type of resource.Always compute#resourcePoliciesList for listsof resourcePolicies + * [Output Only] Type of resource.Alwayscompute#resourcePoliciesList for listsof resourcePolicies * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type \Google\Cloud\Compute\V1\Warning $warning @@ -114,7 +124,8 @@ public function setEtag($var) } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional string id = 3355; * @return string @@ -135,7 +146,8 @@ public function clearId() } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional string id = 3355; * @param string $var @@ -176,7 +188,7 @@ public function setItems($var) } /** - * [Output Only] Type of resource.Always compute#resourcePoliciesList for listsof resourcePolicies + * [Output Only] Type of resource.Alwayscompute#resourcePoliciesList for listsof resourcePolicies * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -197,7 +209,7 @@ public function clearKind() } /** - * [Output Only] Type of resource.Always compute#resourcePoliciesList for listsof resourcePolicies + * [Output Only] Type of resource.Alwayscompute#resourcePoliciesList for listsof resourcePolicies * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -212,7 +224,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -233,7 +249,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/ResourcePolicyResourceStatus.php b/Compute/src/V1/ResourcePolicyResourceStatus.php index 73bf28ee62e7..94352c881d7a 100644 --- a/Compute/src/V1/ResourcePolicyResourceStatus.php +++ b/Compute/src/V1/ResourcePolicyResourceStatus.php @@ -9,14 +9,19 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Contains output only fields. Use this sub-message for all output fields set on ResourcePolicy. The internal structure of this "status" field should mimic the structure of ResourcePolicy proto specification. + * Contains output only fields. + * Use this sub-message for all output fields set on ResourcePolicy. + * The internal structure of this "status" field should mimic the structure + * of ResourcePolicy proto specification. * * Generated from protobuf message google.cloud.compute.v1.ResourcePolicyResourceStatus */ class ResourcePolicyResourceStatus extends \Google\Protobuf\Internal\Message { /** - * [Output Only] Specifies a set of output values reffering to the instance_schedule_policy system status. This field should have the same name as corresponding policy field. + * [Output Only] Specifies a set of output values reffering to + * the instance_schedule_policy system status. + * This field should have the same name as corresponding policy field. * * Generated from protobuf field optional .google.cloud.compute.v1.ResourcePolicyResourceStatusInstanceSchedulePolicyStatus instance_schedule_policy = 344877104; */ @@ -29,7 +34,9 @@ class ResourcePolicyResourceStatus extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type \Google\Cloud\Compute\V1\ResourcePolicyResourceStatusInstanceSchedulePolicyStatus $instance_schedule_policy - * [Output Only] Specifies a set of output values reffering to the instance_schedule_policy system status. This field should have the same name as corresponding policy field. + * [Output Only] Specifies a set of output values reffering to + * the instance_schedule_policy system status. + * This field should have the same name as corresponding policy field. * } */ public function __construct($data = NULL) { @@ -38,7 +45,9 @@ public function __construct($data = NULL) { } /** - * [Output Only] Specifies a set of output values reffering to the instance_schedule_policy system status. This field should have the same name as corresponding policy field. + * [Output Only] Specifies a set of output values reffering to + * the instance_schedule_policy system status. + * This field should have the same name as corresponding policy field. * * Generated from protobuf field optional .google.cloud.compute.v1.ResourcePolicyResourceStatusInstanceSchedulePolicyStatus instance_schedule_policy = 344877104; * @return \Google\Cloud\Compute\V1\ResourcePolicyResourceStatusInstanceSchedulePolicyStatus|null @@ -59,7 +68,9 @@ public function clearInstanceSchedulePolicy() } /** - * [Output Only] Specifies a set of output values reffering to the instance_schedule_policy system status. This field should have the same name as corresponding policy field. + * [Output Only] Specifies a set of output values reffering to + * the instance_schedule_policy system status. + * This field should have the same name as corresponding policy field. * * Generated from protobuf field optional .google.cloud.compute.v1.ResourcePolicyResourceStatusInstanceSchedulePolicyStatus instance_schedule_policy = 344877104; * @param \Google\Cloud\Compute\V1\ResourcePolicyResourceStatusInstanceSchedulePolicyStatus $var diff --git a/Compute/src/V1/ResourcePolicyResourceStatusInstanceSchedulePolicyStatus.php b/Compute/src/V1/ResourcePolicyResourceStatusInstanceSchedulePolicyStatus.php index be74f034b615..4947f9ffa01c 100644 --- a/Compute/src/V1/ResourcePolicyResourceStatusInstanceSchedulePolicyStatus.php +++ b/Compute/src/V1/ResourcePolicyResourceStatusInstanceSchedulePolicyStatus.php @@ -15,13 +15,16 @@ class ResourcePolicyResourceStatusInstanceSchedulePolicyStatus extends \Google\Protobuf\Internal\Message { /** - * [Output Only] The last time the schedule successfully ran. The timestamp is an RFC3339 string. + * [Output Only] The last time the schedule successfully ran. + * The timestamp is an RFC3339 string. * * Generated from protobuf field optional string last_run_start_time = 303069063; */ protected $last_run_start_time = null; /** - * [Output Only] The next time the schedule is planned to run. The actual time might be slightly different. The timestamp is an RFC3339 string. + * [Output Only] The next time the schedule is planned to run. + * The actual time might be slightly different. + * The timestamp is an RFC3339 string. * * Generated from protobuf field optional string next_run_start_time = 318642570; */ @@ -34,9 +37,12 @@ class ResourcePolicyResourceStatusInstanceSchedulePolicyStatus extends \Google\P * Optional. Data for populating the Message object. * * @type string $last_run_start_time - * [Output Only] The last time the schedule successfully ran. The timestamp is an RFC3339 string. + * [Output Only] The last time the schedule successfully ran. + * The timestamp is an RFC3339 string. * @type string $next_run_start_time - * [Output Only] The next time the schedule is planned to run. The actual time might be slightly different. The timestamp is an RFC3339 string. + * [Output Only] The next time the schedule is planned to run. + * The actual time might be slightly different. + * The timestamp is an RFC3339 string. * } */ public function __construct($data = NULL) { @@ -45,7 +51,8 @@ public function __construct($data = NULL) { } /** - * [Output Only] The last time the schedule successfully ran. The timestamp is an RFC3339 string. + * [Output Only] The last time the schedule successfully ran. + * The timestamp is an RFC3339 string. * * Generated from protobuf field optional string last_run_start_time = 303069063; * @return string @@ -66,7 +73,8 @@ public function clearLastRunStartTime() } /** - * [Output Only] The last time the schedule successfully ran. The timestamp is an RFC3339 string. + * [Output Only] The last time the schedule successfully ran. + * The timestamp is an RFC3339 string. * * Generated from protobuf field optional string last_run_start_time = 303069063; * @param string $var @@ -81,7 +89,9 @@ public function setLastRunStartTime($var) } /** - * [Output Only] The next time the schedule is planned to run. The actual time might be slightly different. The timestamp is an RFC3339 string. + * [Output Only] The next time the schedule is planned to run. + * The actual time might be slightly different. + * The timestamp is an RFC3339 string. * * Generated from protobuf field optional string next_run_start_time = 318642570; * @return string @@ -102,7 +112,9 @@ public function clearNextRunStartTime() } /** - * [Output Only] The next time the schedule is planned to run. The actual time might be slightly different. The timestamp is an RFC3339 string. + * [Output Only] The next time the schedule is planned to run. + * The actual time might be slightly different. + * The timestamp is an RFC3339 string. * * Generated from protobuf field optional string next_run_start_time = 318642570; * @param string $var diff --git a/Compute/src/V1/ResourcePolicySnapshotSchedulePolicy.php b/Compute/src/V1/ResourcePolicySnapshotSchedulePolicy.php index f858d6ad9a75..2df268001e3e 100644 --- a/Compute/src/V1/ResourcePolicySnapshotSchedulePolicy.php +++ b/Compute/src/V1/ResourcePolicySnapshotSchedulePolicy.php @@ -9,7 +9,9 @@ use Google\Protobuf\Internal\GPBUtil; /** - * A snapshot schedule policy specifies when and how frequently snapshots are to be created for the target disk. Also specifies how many and how long these scheduled snapshots should be retained. + * A snapshot schedule policy specifies when and how frequently snapshots are + * to be created for the target disk. Also specifies how many and how long + * these scheduled snapshots should be retained. * * Generated from protobuf message google.cloud.compute.v1.ResourcePolicySnapshotSchedulePolicy */ @@ -22,13 +24,16 @@ class ResourcePolicySnapshotSchedulePolicy extends \Google\Protobuf\Internal\Mes */ protected $retention_policy = null; /** - * A Vm Maintenance Policy specifies what kind of infrastructure maintenance we are allowed to perform on this VM and when. Schedule that is applied to disks covered by this policy. + * A Vm Maintenance Policy specifies what kind of infrastructure + * maintenance we are allowed to perform on this VM and when. Schedule + * that is applied to disks covered by this policy. * * Generated from protobuf field optional .google.cloud.compute.v1.ResourcePolicySnapshotSchedulePolicySchedule schedule = 375820951; */ protected $schedule = null; /** - * Properties with which snapshots are created such as labels, encryption keys. + * Properties with which snapshots are created such as labels, encryption + * keys. * * Generated from protobuf field optional .google.cloud.compute.v1.ResourcePolicySnapshotSchedulePolicySnapshotProperties snapshot_properties = 185371278; */ @@ -43,9 +48,12 @@ class ResourcePolicySnapshotSchedulePolicy extends \Google\Protobuf\Internal\Mes * @type \Google\Cloud\Compute\V1\ResourcePolicySnapshotSchedulePolicyRetentionPolicy $retention_policy * Retention policy applied to snapshots created by this resource policy. * @type \Google\Cloud\Compute\V1\ResourcePolicySnapshotSchedulePolicySchedule $schedule - * A Vm Maintenance Policy specifies what kind of infrastructure maintenance we are allowed to perform on this VM and when. Schedule that is applied to disks covered by this policy. + * A Vm Maintenance Policy specifies what kind of infrastructure + * maintenance we are allowed to perform on this VM and when. Schedule + * that is applied to disks covered by this policy. * @type \Google\Cloud\Compute\V1\ResourcePolicySnapshotSchedulePolicySnapshotProperties $snapshot_properties - * Properties with which snapshots are created such as labels, encryption keys. + * Properties with which snapshots are created such as labels, encryption + * keys. * } */ public function __construct($data = NULL) { @@ -90,7 +98,9 @@ public function setRetentionPolicy($var) } /** - * A Vm Maintenance Policy specifies what kind of infrastructure maintenance we are allowed to perform on this VM and when. Schedule that is applied to disks covered by this policy. + * A Vm Maintenance Policy specifies what kind of infrastructure + * maintenance we are allowed to perform on this VM and when. Schedule + * that is applied to disks covered by this policy. * * Generated from protobuf field optional .google.cloud.compute.v1.ResourcePolicySnapshotSchedulePolicySchedule schedule = 375820951; * @return \Google\Cloud\Compute\V1\ResourcePolicySnapshotSchedulePolicySchedule|null @@ -111,7 +121,9 @@ public function clearSchedule() } /** - * A Vm Maintenance Policy specifies what kind of infrastructure maintenance we are allowed to perform on this VM and when. Schedule that is applied to disks covered by this policy. + * A Vm Maintenance Policy specifies what kind of infrastructure + * maintenance we are allowed to perform on this VM and when. Schedule + * that is applied to disks covered by this policy. * * Generated from protobuf field optional .google.cloud.compute.v1.ResourcePolicySnapshotSchedulePolicySchedule schedule = 375820951; * @param \Google\Cloud\Compute\V1\ResourcePolicySnapshotSchedulePolicySchedule $var @@ -126,7 +138,8 @@ public function setSchedule($var) } /** - * Properties with which snapshots are created such as labels, encryption keys. + * Properties with which snapshots are created such as labels, encryption + * keys. * * Generated from protobuf field optional .google.cloud.compute.v1.ResourcePolicySnapshotSchedulePolicySnapshotProperties snapshot_properties = 185371278; * @return \Google\Cloud\Compute\V1\ResourcePolicySnapshotSchedulePolicySnapshotProperties|null @@ -147,7 +160,8 @@ public function clearSnapshotProperties() } /** - * Properties with which snapshots are created such as labels, encryption keys. + * Properties with which snapshots are created such as labels, encryption + * keys. * * Generated from protobuf field optional .google.cloud.compute.v1.ResourcePolicySnapshotSchedulePolicySnapshotProperties snapshot_properties = 185371278; * @param \Google\Cloud\Compute\V1\ResourcePolicySnapshotSchedulePolicySnapshotProperties $var diff --git a/Compute/src/V1/ResourcePolicySnapshotSchedulePolicyRetentionPolicy.php b/Compute/src/V1/ResourcePolicySnapshotSchedulePolicyRetentionPolicy.php index 4a91189d7faf..6314e2782d02 100644 --- a/Compute/src/V1/ResourcePolicySnapshotSchedulePolicyRetentionPolicy.php +++ b/Compute/src/V1/ResourcePolicySnapshotSchedulePolicyRetentionPolicy.php @@ -22,7 +22,8 @@ class ResourcePolicySnapshotSchedulePolicyRetentionPolicy extends \Google\Protob */ protected $max_retention_days = null; /** - * Specifies the behavior to apply to scheduled snapshots when the source disk is deleted. + * Specifies the behavior to apply to scheduled snapshots when + * the source disk is deleted. * Check the OnSourceDiskDelete enum for the list of possible values. * * Generated from protobuf field optional string on_source_disk_delete = 321955529; @@ -38,7 +39,8 @@ class ResourcePolicySnapshotSchedulePolicyRetentionPolicy extends \Google\Protob * @type int $max_retention_days * Maximum age of the snapshot that is allowed to be kept. * @type string $on_source_disk_delete - * Specifies the behavior to apply to scheduled snapshots when the source disk is deleted. + * Specifies the behavior to apply to scheduled snapshots when + * the source disk is deleted. * Check the OnSourceDiskDelete enum for the list of possible values. * } */ @@ -84,7 +86,8 @@ public function setMaxRetentionDays($var) } /** - * Specifies the behavior to apply to scheduled snapshots when the source disk is deleted. + * Specifies the behavior to apply to scheduled snapshots when + * the source disk is deleted. * Check the OnSourceDiskDelete enum for the list of possible values. * * Generated from protobuf field optional string on_source_disk_delete = 321955529; @@ -106,7 +109,8 @@ public function clearOnSourceDiskDelete() } /** - * Specifies the behavior to apply to scheduled snapshots when the source disk is deleted. + * Specifies the behavior to apply to scheduled snapshots when + * the source disk is deleted. * Check the OnSourceDiskDelete enum for the list of possible values. * * Generated from protobuf field optional string on_source_disk_delete = 321955529; diff --git a/Compute/src/V1/ResourcePolicySnapshotSchedulePolicyRetentionPolicy/OnSourceDiskDelete.php b/Compute/src/V1/ResourcePolicySnapshotSchedulePolicyRetentionPolicy/OnSourceDiskDelete.php index ad00e6c841cf..6a5c4e0250f3 100644 --- a/Compute/src/V1/ResourcePolicySnapshotSchedulePolicyRetentionPolicy/OnSourceDiskDelete.php +++ b/Compute/src/V1/ResourcePolicySnapshotSchedulePolicyRetentionPolicy/OnSourceDiskDelete.php @@ -7,7 +7,8 @@ use UnexpectedValueException; /** - * Specifies the behavior to apply to scheduled snapshots when the source disk is deleted. + * Specifies the behavior to apply to scheduled snapshots when + * the source disk is deleted. * * Protobuf type google.cloud.compute.v1.ResourcePolicySnapshotSchedulePolicyRetentionPolicy.OnSourceDiskDelete */ diff --git a/Compute/src/V1/ResourcePolicySnapshotSchedulePolicySnapshotProperties.php b/Compute/src/V1/ResourcePolicySnapshotSchedulePolicySnapshotProperties.php index b510adb6ba78..b7cd11b9990c 100644 --- a/Compute/src/V1/ResourcePolicySnapshotSchedulePolicySnapshotProperties.php +++ b/Compute/src/V1/ResourcePolicySnapshotSchedulePolicySnapshotProperties.php @@ -9,7 +9,8 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Specified snapshot properties for scheduled snapshots created by this policy. + * Specified snapshot properties for scheduled snapshots created by this + * policy. * * Generated from protobuf message google.cloud.compute.v1.ResourcePolicySnapshotSchedulePolicySnapshotProperties */ @@ -28,13 +29,15 @@ class ResourcePolicySnapshotSchedulePolicySnapshotProperties extends \Google\Pro */ protected $guest_flush = null; /** - * Labels to apply to scheduled snapshots. These can be later modified by the setLabels method. Label values may be empty. + * Labels to apply to scheduled snapshots. These can be later modified + * by the setLabels method. Label values may be empty. * * Generated from protobuf field map labels = 500195327; */ private $labels; /** - * Cloud Storage bucket storage location of the auto snapshot (regional or multi-regional). + * Cloud Storage bucket storage location of the auto snapshot (regional or + * multi-regional). * * Generated from protobuf field repeated string storage_locations = 328005274; */ @@ -51,9 +54,11 @@ class ResourcePolicySnapshotSchedulePolicySnapshotProperties extends \Google\Pro * @type bool $guest_flush * Indication to perform a 'guest aware' snapshot. * @type array|\Google\Protobuf\Internal\MapField $labels - * Labels to apply to scheduled snapshots. These can be later modified by the setLabels method. Label values may be empty. + * Labels to apply to scheduled snapshots. These can be later modified + * by the setLabels method. Label values may be empty. * @type array|\Google\Protobuf\Internal\RepeatedField $storage_locations - * Cloud Storage bucket storage location of the auto snapshot (regional or multi-regional). + * Cloud Storage bucket storage location of the auto snapshot (regional or + * multi-regional). * } */ public function __construct($data = NULL) { @@ -134,7 +139,8 @@ public function setGuestFlush($var) } /** - * Labels to apply to scheduled snapshots. These can be later modified by the setLabels method. Label values may be empty. + * Labels to apply to scheduled snapshots. These can be later modified + * by the setLabels method. Label values may be empty. * * Generated from protobuf field map labels = 500195327; * @return \Google\Protobuf\Internal\MapField @@ -145,7 +151,8 @@ public function getLabels() } /** - * Labels to apply to scheduled snapshots. These can be later modified by the setLabels method. Label values may be empty. + * Labels to apply to scheduled snapshots. These can be later modified + * by the setLabels method. Label values may be empty. * * Generated from protobuf field map labels = 500195327; * @param array|\Google\Protobuf\Internal\MapField $var @@ -160,7 +167,8 @@ public function setLabels($var) } /** - * Cloud Storage bucket storage location of the auto snapshot (regional or multi-regional). + * Cloud Storage bucket storage location of the auto snapshot (regional or + * multi-regional). * * Generated from protobuf field repeated string storage_locations = 328005274; * @return \Google\Protobuf\Internal\RepeatedField @@ -171,7 +179,8 @@ public function getStorageLocations() } /** - * Cloud Storage bucket storage location of the auto snapshot (regional or multi-regional). + * Cloud Storage bucket storage location of the auto snapshot (regional or + * multi-regional). * * Generated from protobuf field repeated string storage_locations = 328005274; * @param array|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/ResourcePolicyWeeklyCycleDayOfWeek.php b/Compute/src/V1/ResourcePolicyWeeklyCycleDayOfWeek.php index 7b7ab06ed0d0..6ba130de57a3 100644 --- a/Compute/src/V1/ResourcePolicyWeeklyCycleDayOfWeek.php +++ b/Compute/src/V1/ResourcePolicyWeeklyCycleDayOfWeek.php @@ -15,20 +15,24 @@ class ResourcePolicyWeeklyCycleDayOfWeek extends \Google\Protobuf\Internal\Message { /** - * Defines a schedule that runs on specific days of the week. Specify one or more days. The following options are available: MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY. + * Defines a schedule that runs on specific days of the week. Specify + * one or more days. The following options are available: + * MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY. * Check the Day enum for the list of possible values. * * Generated from protobuf field optional string day = 99228; */ protected $day = null; /** - * [Output only] Duration of the time window, automatically chosen to be smallest possible in the given scenario. + * [Output only] Duration of the time window, automatically chosen to be + * smallest possible in the given scenario. * * Generated from protobuf field optional string duration = 155471252; */ protected $duration = null; /** - * Time within the window to start the operations. It must be in format "HH:MM", where HH : [00-23] and MM : [00-00] GMT. + * Time within the window to start the operations. + * It must be in format "HH:MM", where HH : [00-23] and MM : [00-00] GMT. * * Generated from protobuf field optional string start_time = 37467274; */ @@ -41,12 +45,16 @@ class ResourcePolicyWeeklyCycleDayOfWeek extends \Google\Protobuf\Internal\Messa * Optional. Data for populating the Message object. * * @type string $day - * Defines a schedule that runs on specific days of the week. Specify one or more days. The following options are available: MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY. + * Defines a schedule that runs on specific days of the week. Specify + * one or more days. The following options are available: + * MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY. * Check the Day enum for the list of possible values. * @type string $duration - * [Output only] Duration of the time window, automatically chosen to be smallest possible in the given scenario. + * [Output only] Duration of the time window, automatically chosen to be + * smallest possible in the given scenario. * @type string $start_time - * Time within the window to start the operations. It must be in format "HH:MM", where HH : [00-23] and MM : [00-00] GMT. + * Time within the window to start the operations. + * It must be in format "HH:MM", where HH : [00-23] and MM : [00-00] GMT. * } */ public function __construct($data = NULL) { @@ -55,7 +63,9 @@ public function __construct($data = NULL) { } /** - * Defines a schedule that runs on specific days of the week. Specify one or more days. The following options are available: MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY. + * Defines a schedule that runs on specific days of the week. Specify + * one or more days. The following options are available: + * MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY. * Check the Day enum for the list of possible values. * * Generated from protobuf field optional string day = 99228; @@ -77,7 +87,9 @@ public function clearDay() } /** - * Defines a schedule that runs on specific days of the week. Specify one or more days. The following options are available: MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY. + * Defines a schedule that runs on specific days of the week. Specify + * one or more days. The following options are available: + * MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY. * Check the Day enum for the list of possible values. * * Generated from protobuf field optional string day = 99228; @@ -93,7 +105,8 @@ public function setDay($var) } /** - * [Output only] Duration of the time window, automatically chosen to be smallest possible in the given scenario. + * [Output only] Duration of the time window, automatically chosen to be + * smallest possible in the given scenario. * * Generated from protobuf field optional string duration = 155471252; * @return string @@ -114,7 +127,8 @@ public function clearDuration() } /** - * [Output only] Duration of the time window, automatically chosen to be smallest possible in the given scenario. + * [Output only] Duration of the time window, automatically chosen to be + * smallest possible in the given scenario. * * Generated from protobuf field optional string duration = 155471252; * @param string $var @@ -129,7 +143,8 @@ public function setDuration($var) } /** - * Time within the window to start the operations. It must be in format "HH:MM", where HH : [00-23] and MM : [00-00] GMT. + * Time within the window to start the operations. + * It must be in format "HH:MM", where HH : [00-23] and MM : [00-00] GMT. * * Generated from protobuf field optional string start_time = 37467274; * @return string @@ -150,7 +165,8 @@ public function clearStartTime() } /** - * Time within the window to start the operations. It must be in format "HH:MM", where HH : [00-23] and MM : [00-00] GMT. + * Time within the window to start the operations. + * It must be in format "HH:MM", where HH : [00-23] and MM : [00-00] GMT. * * Generated from protobuf field optional string start_time = 37467274; * @param string $var diff --git a/Compute/src/V1/ResourcePolicyWeeklyCycleDayOfWeek/Day.php b/Compute/src/V1/ResourcePolicyWeeklyCycleDayOfWeek/Day.php index b8216eccb328..63f179374bdc 100644 --- a/Compute/src/V1/ResourcePolicyWeeklyCycleDayOfWeek/Day.php +++ b/Compute/src/V1/ResourcePolicyWeeklyCycleDayOfWeek/Day.php @@ -7,7 +7,9 @@ use UnexpectedValueException; /** - * Defines a schedule that runs on specific days of the week. Specify one or more days. The following options are available: MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY. + * Defines a schedule that runs on specific days of the week. Specify + * one or more days. The following options are available: + * MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY. * * Protobuf type google.cloud.compute.v1.ResourcePolicyWeeklyCycleDayOfWeek.Day */ diff --git a/Compute/src/V1/ResourcePolicyWorkloadPolicy.php b/Compute/src/V1/ResourcePolicyWorkloadPolicy.php index ae3769ae904b..79b79724c632 100644 --- a/Compute/src/V1/ResourcePolicyWorkloadPolicy.php +++ b/Compute/src/V1/ResourcePolicyWorkloadPolicy.php @@ -16,7 +16,8 @@ class ResourcePolicyWorkloadPolicy extends \Google\Protobuf\Internal\Message { /** - * Specifies the topology required to create a partition for VMs that have interconnected GPUs. + * Specifies the topology required to create a partition for VMs that have + * interconnected GPUs. * * Generated from protobuf field optional string accelerator_topology = 389323203; */ @@ -43,7 +44,8 @@ class ResourcePolicyWorkloadPolicy extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $accelerator_topology - * Specifies the topology required to create a partition for VMs that have interconnected GPUs. + * Specifies the topology required to create a partition for VMs that have + * interconnected GPUs. * @type string $max_topology_distance * Specifies the maximum distance between instances. * Check the MaxTopologyDistance enum for the list of possible values. @@ -58,7 +60,8 @@ public function __construct($data = NULL) { } /** - * Specifies the topology required to create a partition for VMs that have interconnected GPUs. + * Specifies the topology required to create a partition for VMs that have + * interconnected GPUs. * * Generated from protobuf field optional string accelerator_topology = 389323203; * @return string @@ -79,7 +82,8 @@ public function clearAcceleratorTopology() } /** - * Specifies the topology required to create a partition for VMs that have interconnected GPUs. + * Specifies the topology required to create a partition for VMs that have + * interconnected GPUs. * * Generated from protobuf field optional string accelerator_topology = 389323203; * @param string $var diff --git a/Compute/src/V1/ResourcePolicyWorkloadPolicy/Type.php b/Compute/src/V1/ResourcePolicyWorkloadPolicy/Type.php index 7bb15b6e89e0..a9a5b7541b17 100644 --- a/Compute/src/V1/ResourcePolicyWorkloadPolicy/Type.php +++ b/Compute/src/V1/ResourcePolicyWorkloadPolicy/Type.php @@ -26,7 +26,8 @@ class Type */ const HIGH_AVAILABILITY = 409487576; /** - * MIG provisions instances as close to each other as possible for high throughput. + * MIG provisions instances as close to each other as possible for high + * throughput. * * Generated from protobuf enum HIGH_THROUGHPUT = 146499815; */ diff --git a/Compute/src/V1/ResourceStatus.php b/Compute/src/V1/ResourceStatus.php index effe1e367efd..182381b991c9 100644 --- a/Compute/src/V1/ResourceStatus.php +++ b/Compute/src/V1/ResourceStatus.php @@ -9,30 +9,44 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Contains output only fields. Use this sub-message for actual values set on Instance attributes as compared to the value requested by the user (intent) in their instance CRUD calls. + * Contains output only fields. + * Use this sub-message for actual values set on Instance attributes as compared + * to the value requested by the user (intent) in their instance CRUD calls. * * Generated from protobuf message google.cloud.compute.v1.ResourceStatus */ class ResourceStatus extends \Google\Protobuf\Internal\Message { /** - * [Output Only] Effective metadata is a field that consolidates project, zonal instance settings, and instance-level predefined metadata keys to provide the overridden value for those metadata keys at the instance level. + * [Output Only] Effective metadata is a field that consolidates project, + * zonal instance settings, and instance-level predefined metadata keys to + * provide the overridden value for those metadata keys at the instance level. * * Generated from protobuf field optional .google.cloud.compute.v1.ResourceStatusEffectiveInstanceMetadata effective_instance_metadata = 55052033; */ protected $effective_instance_metadata = null; /** - * [Output Only] The precise location of your instance within the zone's data center, including the block, sub-block, and host. The field is formatted as follows: blockId/subBlockId/hostId. + * [Output Only] The precise location of your instance within the zone's data + * center, including the block, sub-block, and host. The field is formatted as + * follows: blockId/subBlockId/hostId. * * Generated from protobuf field optional string physical_host = 464370704; */ protected $physical_host = null; /** - * [Output Only] A series of fields containing the global name of the Compute Engine cluster, as well as the ID of the block, sub-block, and host on which the running instance is located. + * [Output Only] A series of fields containing the global name of the Compute + * Engine cluster, as well as the ID of the block, sub-block, and host on + * which the running instance is located. * * Generated from protobuf field optional .google.cloud.compute.v1.ResourceStatusPhysicalHostTopology physical_host_topology = 390842814; */ protected $physical_host_topology = null; + /** + * [Output Only] Reservation information that the instance is consuming from. + * + * Generated from protobuf field optional .google.cloud.compute.v1.ResourceStatusReservationConsumptionInfo reservation_consumption_info = 201056997; + */ + protected $reservation_consumption_info = null; /** * Generated from protobuf field optional .google.cloud.compute.v1.ResourceStatusScheduling scheduling = 386688404; */ @@ -49,11 +63,19 @@ class ResourceStatus extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type \Google\Cloud\Compute\V1\ResourceStatusEffectiveInstanceMetadata $effective_instance_metadata - * [Output Only] Effective metadata is a field that consolidates project, zonal instance settings, and instance-level predefined metadata keys to provide the overridden value for those metadata keys at the instance level. + * [Output Only] Effective metadata is a field that consolidates project, + * zonal instance settings, and instance-level predefined metadata keys to + * provide the overridden value for those metadata keys at the instance level. * @type string $physical_host - * [Output Only] The precise location of your instance within the zone's data center, including the block, sub-block, and host. The field is formatted as follows: blockId/subBlockId/hostId. + * [Output Only] The precise location of your instance within the zone's data + * center, including the block, sub-block, and host. The field is formatted as + * follows: blockId/subBlockId/hostId. * @type \Google\Cloud\Compute\V1\ResourceStatusPhysicalHostTopology $physical_host_topology - * [Output Only] A series of fields containing the global name of the Compute Engine cluster, as well as the ID of the block, sub-block, and host on which the running instance is located. + * [Output Only] A series of fields containing the global name of the Compute + * Engine cluster, as well as the ID of the block, sub-block, and host on + * which the running instance is located. + * @type \Google\Cloud\Compute\V1\ResourceStatusReservationConsumptionInfo $reservation_consumption_info + * [Output Only] Reservation information that the instance is consuming from. * @type \Google\Cloud\Compute\V1\ResourceStatusScheduling $scheduling * @type \Google\Cloud\Compute\V1\UpcomingMaintenance $upcoming_maintenance * } @@ -64,7 +86,9 @@ public function __construct($data = NULL) { } /** - * [Output Only] Effective metadata is a field that consolidates project, zonal instance settings, and instance-level predefined metadata keys to provide the overridden value for those metadata keys at the instance level. + * [Output Only] Effective metadata is a field that consolidates project, + * zonal instance settings, and instance-level predefined metadata keys to + * provide the overridden value for those metadata keys at the instance level. * * Generated from protobuf field optional .google.cloud.compute.v1.ResourceStatusEffectiveInstanceMetadata effective_instance_metadata = 55052033; * @return \Google\Cloud\Compute\V1\ResourceStatusEffectiveInstanceMetadata|null @@ -85,7 +109,9 @@ public function clearEffectiveInstanceMetadata() } /** - * [Output Only] Effective metadata is a field that consolidates project, zonal instance settings, and instance-level predefined metadata keys to provide the overridden value for those metadata keys at the instance level. + * [Output Only] Effective metadata is a field that consolidates project, + * zonal instance settings, and instance-level predefined metadata keys to + * provide the overridden value for those metadata keys at the instance level. * * Generated from protobuf field optional .google.cloud.compute.v1.ResourceStatusEffectiveInstanceMetadata effective_instance_metadata = 55052033; * @param \Google\Cloud\Compute\V1\ResourceStatusEffectiveInstanceMetadata $var @@ -100,7 +126,9 @@ public function setEffectiveInstanceMetadata($var) } /** - * [Output Only] The precise location of your instance within the zone's data center, including the block, sub-block, and host. The field is formatted as follows: blockId/subBlockId/hostId. + * [Output Only] The precise location of your instance within the zone's data + * center, including the block, sub-block, and host. The field is formatted as + * follows: blockId/subBlockId/hostId. * * Generated from protobuf field optional string physical_host = 464370704; * @return string @@ -121,7 +149,9 @@ public function clearPhysicalHost() } /** - * [Output Only] The precise location of your instance within the zone's data center, including the block, sub-block, and host. The field is formatted as follows: blockId/subBlockId/hostId. + * [Output Only] The precise location of your instance within the zone's data + * center, including the block, sub-block, and host. The field is formatted as + * follows: blockId/subBlockId/hostId. * * Generated from protobuf field optional string physical_host = 464370704; * @param string $var @@ -136,7 +166,9 @@ public function setPhysicalHost($var) } /** - * [Output Only] A series of fields containing the global name of the Compute Engine cluster, as well as the ID of the block, sub-block, and host on which the running instance is located. + * [Output Only] A series of fields containing the global name of the Compute + * Engine cluster, as well as the ID of the block, sub-block, and host on + * which the running instance is located. * * Generated from protobuf field optional .google.cloud.compute.v1.ResourceStatusPhysicalHostTopology physical_host_topology = 390842814; * @return \Google\Cloud\Compute\V1\ResourceStatusPhysicalHostTopology|null @@ -157,7 +189,9 @@ public function clearPhysicalHostTopology() } /** - * [Output Only] A series of fields containing the global name of the Compute Engine cluster, as well as the ID of the block, sub-block, and host on which the running instance is located. + * [Output Only] A series of fields containing the global name of the Compute + * Engine cluster, as well as the ID of the block, sub-block, and host on + * which the running instance is located. * * Generated from protobuf field optional .google.cloud.compute.v1.ResourceStatusPhysicalHostTopology physical_host_topology = 390842814; * @param \Google\Cloud\Compute\V1\ResourceStatusPhysicalHostTopology $var @@ -171,6 +205,42 @@ public function setPhysicalHostTopology($var) return $this; } + /** + * [Output Only] Reservation information that the instance is consuming from. + * + * Generated from protobuf field optional .google.cloud.compute.v1.ResourceStatusReservationConsumptionInfo reservation_consumption_info = 201056997; + * @return \Google\Cloud\Compute\V1\ResourceStatusReservationConsumptionInfo|null + */ + public function getReservationConsumptionInfo() + { + return $this->reservation_consumption_info; + } + + public function hasReservationConsumptionInfo() + { + return isset($this->reservation_consumption_info); + } + + public function clearReservationConsumptionInfo() + { + unset($this->reservation_consumption_info); + } + + /** + * [Output Only] Reservation information that the instance is consuming from. + * + * Generated from protobuf field optional .google.cloud.compute.v1.ResourceStatusReservationConsumptionInfo reservation_consumption_info = 201056997; + * @param \Google\Cloud\Compute\V1\ResourceStatusReservationConsumptionInfo $var + * @return $this + */ + public function setReservationConsumptionInfo($var) + { + GPBUtil::checkMessage($var, \Google\Cloud\Compute\V1\ResourceStatusReservationConsumptionInfo::class); + $this->reservation_consumption_info = $var; + + return $this; + } + /** * Generated from protobuf field optional .google.cloud.compute.v1.ResourceStatusScheduling scheduling = 386688404; * @return \Google\Cloud\Compute\V1\ResourceStatusScheduling|null diff --git a/Compute/src/V1/ResourceStatusPhysicalHostTopology.php b/Compute/src/V1/ResourceStatusPhysicalHostTopology.php index 7d1721d76c35..265e297e685d 100644 --- a/Compute/src/V1/ResourceStatusPhysicalHostTopology.php +++ b/Compute/src/V1/ResourceStatusPhysicalHostTopology.php @@ -9,32 +9,39 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Represents the physical host topology of the host on which the VM is running. + * Represents the physical host topology of the host on which the VM is + * running. * * Generated from protobuf message google.cloud.compute.v1.ResourceStatusPhysicalHostTopology */ class ResourceStatusPhysicalHostTopology extends \Google\Protobuf\Internal\Message { /** - * [Output Only] The ID of the block in which the running instance is located. Instances within the same block experience low network latency. + * [Output Only] The ID of the block in which the running instance is + * located. Instances within the same block experience low network latency. * * Generated from protobuf field optional string block = 93832333; */ protected $block = null; /** - * [Output Only] The global name of the Compute Engine cluster where the running instance is located. + * [Output Only] The global name of the Compute Engine cluster where the + * running instance is located. * * Generated from protobuf field optional string cluster = 335221242; */ protected $cluster = null; /** - * [Output Only] The ID of the host on which the running instance is located. Instances on the same host experience the lowest possible network latency. + * [Output Only] The ID of the host on which the running instance is located. + * Instances on the same host experience the lowest possible network + * latency. * * Generated from protobuf field optional string host = 3208616; */ protected $host = null; /** - * [Output Only] The ID of the sub-block in which the running instance is located. Instances in the same sub-block experience lower network latency than instances in the same block. + * [Output Only] The ID of the sub-block in which the running instance is + * located. Instances in the same sub-block experience lower network latency + * than instances in the same block. * * Generated from protobuf field optional string subblock = 70446669; */ @@ -47,13 +54,19 @@ class ResourceStatusPhysicalHostTopology extends \Google\Protobuf\Internal\Messa * Optional. Data for populating the Message object. * * @type string $block - * [Output Only] The ID of the block in which the running instance is located. Instances within the same block experience low network latency. + * [Output Only] The ID of the block in which the running instance is + * located. Instances within the same block experience low network latency. * @type string $cluster - * [Output Only] The global name of the Compute Engine cluster where the running instance is located. + * [Output Only] The global name of the Compute Engine cluster where the + * running instance is located. * @type string $host - * [Output Only] The ID of the host on which the running instance is located. Instances on the same host experience the lowest possible network latency. + * [Output Only] The ID of the host on which the running instance is located. + * Instances on the same host experience the lowest possible network + * latency. * @type string $subblock - * [Output Only] The ID of the sub-block in which the running instance is located. Instances in the same sub-block experience lower network latency than instances in the same block. + * [Output Only] The ID of the sub-block in which the running instance is + * located. Instances in the same sub-block experience lower network latency + * than instances in the same block. * } */ public function __construct($data = NULL) { @@ -62,7 +75,8 @@ public function __construct($data = NULL) { } /** - * [Output Only] The ID of the block in which the running instance is located. Instances within the same block experience low network latency. + * [Output Only] The ID of the block in which the running instance is + * located. Instances within the same block experience low network latency. * * Generated from protobuf field optional string block = 93832333; * @return string @@ -83,7 +97,8 @@ public function clearBlock() } /** - * [Output Only] The ID of the block in which the running instance is located. Instances within the same block experience low network latency. + * [Output Only] The ID of the block in which the running instance is + * located. Instances within the same block experience low network latency. * * Generated from protobuf field optional string block = 93832333; * @param string $var @@ -98,7 +113,8 @@ public function setBlock($var) } /** - * [Output Only] The global name of the Compute Engine cluster where the running instance is located. + * [Output Only] The global name of the Compute Engine cluster where the + * running instance is located. * * Generated from protobuf field optional string cluster = 335221242; * @return string @@ -119,7 +135,8 @@ public function clearCluster() } /** - * [Output Only] The global name of the Compute Engine cluster where the running instance is located. + * [Output Only] The global name of the Compute Engine cluster where the + * running instance is located. * * Generated from protobuf field optional string cluster = 335221242; * @param string $var @@ -134,7 +151,9 @@ public function setCluster($var) } /** - * [Output Only] The ID of the host on which the running instance is located. Instances on the same host experience the lowest possible network latency. + * [Output Only] The ID of the host on which the running instance is located. + * Instances on the same host experience the lowest possible network + * latency. * * Generated from protobuf field optional string host = 3208616; * @return string @@ -155,7 +174,9 @@ public function clearHost() } /** - * [Output Only] The ID of the host on which the running instance is located. Instances on the same host experience the lowest possible network latency. + * [Output Only] The ID of the host on which the running instance is located. + * Instances on the same host experience the lowest possible network + * latency. * * Generated from protobuf field optional string host = 3208616; * @param string $var @@ -170,7 +191,9 @@ public function setHost($var) } /** - * [Output Only] The ID of the sub-block in which the running instance is located. Instances in the same sub-block experience lower network latency than instances in the same block. + * [Output Only] The ID of the sub-block in which the running instance is + * located. Instances in the same sub-block experience lower network latency + * than instances in the same block. * * Generated from protobuf field optional string subblock = 70446669; * @return string @@ -191,7 +214,9 @@ public function clearSubblock() } /** - * [Output Only] The ID of the sub-block in which the running instance is located. Instances in the same sub-block experience lower network latency than instances in the same block. + * [Output Only] The ID of the sub-block in which the running instance is + * located. Instances in the same sub-block experience lower network latency + * than instances in the same block. * * Generated from protobuf field optional string subblock = 70446669; * @param string $var diff --git a/Compute/src/V1/ResourceStatusReservationConsumptionInfo.php b/Compute/src/V1/ResourceStatusReservationConsumptionInfo.php new file mode 100644 index 000000000000..677de0f9325a --- /dev/null +++ b/Compute/src/V1/ResourceStatusReservationConsumptionInfo.php @@ -0,0 +1,81 @@ +google.cloud.compute.v1.ResourceStatusReservationConsumptionInfo + */ +class ResourceStatusReservationConsumptionInfo extends \Google\Protobuf\Internal\Message +{ + /** + * [Output Only] The full resource name of the reservation that this + * instance is consuming from. + * + * Generated from protobuf field optional string consumed_reservation = 318474741; + */ + protected $consumed_reservation = null; + + /** + * Constructor. + * + * @param array $data { + * Optional. Data for populating the Message object. + * + * @type string $consumed_reservation + * [Output Only] The full resource name of the reservation that this + * instance is consuming from. + * } + */ + public function __construct($data = NULL) { + \GPBMetadata\Google\Cloud\Compute\V1\Compute::initOnce(); + parent::__construct($data); + } + + /** + * [Output Only] The full resource name of the reservation that this + * instance is consuming from. + * + * Generated from protobuf field optional string consumed_reservation = 318474741; + * @return string + */ + public function getConsumedReservation() + { + return isset($this->consumed_reservation) ? $this->consumed_reservation : ''; + } + + public function hasConsumedReservation() + { + return isset($this->consumed_reservation); + } + + public function clearConsumedReservation() + { + unset($this->consumed_reservation); + } + + /** + * [Output Only] The full resource name of the reservation that this + * instance is consuming from. + * + * Generated from protobuf field optional string consumed_reservation = 318474741; + * @param string $var + * @return $this + */ + public function setConsumedReservation($var) + { + GPBUtil::checkString($var, True); + $this->consumed_reservation = $var; + + return $this; + } + +} + diff --git a/Compute/src/V1/ResourceStatusScheduling.php b/Compute/src/V1/ResourceStatusScheduling.php index 58e85289a9ca..455de05459a6 100644 --- a/Compute/src/V1/ResourceStatusScheduling.php +++ b/Compute/src/V1/ResourceStatusScheduling.php @@ -15,7 +15,9 @@ class ResourceStatusScheduling extends \Google\Protobuf\Internal\Message { /** - * Specifies the availability domain to place the instance in. The value must be a number between 1 and the number of availability domains specified in the spread placement policy attached to the instance. + * Specifies the availability domain to place the instance in. The value + * must be a number between 1 and the number of availability domains + * specified in the spread placement policy attached to the instance. * * Generated from protobuf field optional int32 availability_domain = 252514344; */ @@ -28,7 +30,9 @@ class ResourceStatusScheduling extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type int $availability_domain - * Specifies the availability domain to place the instance in. The value must be a number between 1 and the number of availability domains specified in the spread placement policy attached to the instance. + * Specifies the availability domain to place the instance in. The value + * must be a number between 1 and the number of availability domains + * specified in the spread placement policy attached to the instance. * } */ public function __construct($data = NULL) { @@ -37,7 +41,9 @@ public function __construct($data = NULL) { } /** - * Specifies the availability domain to place the instance in. The value must be a number between 1 and the number of availability domains specified in the spread placement policy attached to the instance. + * Specifies the availability domain to place the instance in. The value + * must be a number between 1 and the number of availability domains + * specified in the spread placement policy attached to the instance. * * Generated from protobuf field optional int32 availability_domain = 252514344; * @return int @@ -58,7 +64,9 @@ public function clearAvailabilityDomain() } /** - * Specifies the availability domain to place the instance in. The value must be a number between 1 and the number of availability domains specified in the spread placement policy attached to the instance. + * Specifies the availability domain to place the instance in. The value + * must be a number between 1 and the number of availability domains + * specified in the spread placement policy attached to the instance. * * Generated from protobuf field optional int32 availability_domain = 252514344; * @param int $var diff --git a/Compute/src/V1/ResumeInstanceRequest.php b/Compute/src/V1/ResumeInstanceRequest.php index c1d529d70f66..f276c3362284 100644 --- a/Compute/src/V1/ResumeInstanceRequest.php +++ b/Compute/src/V1/ResumeInstanceRequest.php @@ -28,7 +28,17 @@ class ResumeInstanceRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -68,7 +78,17 @@ public static function build(string $project, string $zone, string $instance): s * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $zone * The name of the zone for this request. * } @@ -131,7 +151,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -152,7 +182,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/ResumeInstancesInstanceGroupManagerRequest.php b/Compute/src/V1/ResumeInstancesInstanceGroupManagerRequest.php index 2e8920315311..0ccdb4df4fd9 100644 --- a/Compute/src/V1/ResumeInstancesInstanceGroupManagerRequest.php +++ b/Compute/src/V1/ResumeInstancesInstanceGroupManagerRequest.php @@ -34,13 +34,24 @@ class ResumeInstancesInstanceGroupManagerRequest extends \Google\Protobuf\Intern */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ protected $request_id = null; /** - * The name of the zone where the managed instance group is located. + * The name of thezone where the managed + * instance group is located. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; */ @@ -48,7 +59,8 @@ class ResumeInstancesInstanceGroupManagerRequest extends \Google\Protobuf\Intern /** * @param string $project Project ID for this request. - * @param string $zone The name of the zone where the managed instance group is located. + * @param string $zone The name of thezone where the managed + * instance group is located. * @param string $instanceGroupManager The name of the managed instance group. * @param \Google\Cloud\Compute\V1\InstanceGroupManagersResumeInstancesRequest $instanceGroupManagersResumeInstancesRequestResource The body resource for this request * @@ -78,9 +90,20 @@ public static function build(string $project, string $zone, string $instanceGrou * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $zone - * The name of the zone where the managed instance group is located. + * The name of thezone where the managed + * instance group is located. * } */ public function __construct($data = NULL) { @@ -177,7 +200,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -198,7 +231,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var @@ -213,7 +256,8 @@ public function setRequestId($var) } /** - * The name of the zone where the managed instance group is located. + * The name of thezone where the managed + * instance group is located. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; * @return string @@ -224,7 +268,8 @@ public function getZone() } /** - * The name of the zone where the managed instance group is located. + * The name of thezone where the managed + * instance group is located. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; * @param string $var diff --git a/Compute/src/V1/ResumeInstancesRegionInstanceGroupManagerRequest.php b/Compute/src/V1/ResumeInstancesRegionInstanceGroupManagerRequest.php index 948885317be3..d78e03762aa6 100644 --- a/Compute/src/V1/ResumeInstancesRegionInstanceGroupManagerRequest.php +++ b/Compute/src/V1/ResumeInstancesRegionInstanceGroupManagerRequest.php @@ -40,7 +40,17 @@ class ResumeInstancesRegionInstanceGroupManagerRequest extends \Google\Protobuf\ */ protected $region_instance_group_managers_resume_instances_request_resource = null; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -80,7 +90,17 @@ public static function build(string $project, string $region, string $instanceGr * @type \Google\Cloud\Compute\V1\RegionInstanceGroupManagersResumeInstancesRequest $region_instance_group_managers_resume_instances_request_resource * The body resource for this request * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -203,7 +223,17 @@ public function setRegionInstanceGroupManagersResumeInstancesRequestResource($va } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -224,7 +254,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/Route.php b/Compute/src/V1/Route.php index 81a1281d12f8..2086bb2c1401 100644 --- a/Compute/src/V1/Route.php +++ b/Compute/src/V1/Route.php @@ -9,7 +9,10 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Represents a Route resource. A route defines a path from VM instances in the VPC network to a specific destination. This destination can be inside or outside the VPC network. For more information, read the Routes overview. + * Represents a Route resource. + * A route defines a path from VM instances in the VPC network to a specific + * destination. This destination can be inside or outside the VPC network. + * For more information, read theRoutes overview. * * Generated from protobuf message google.cloud.compute.v1.Route */ @@ -22,37 +25,51 @@ class Route extends \Google\Protobuf\Internal\Message */ private $as_paths; /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; */ protected $creation_timestamp = null; /** - * An optional description of this resource. Provide this field when you create the resource. + * An optional description of this resource. Provide this field when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; */ protected $description = null; /** - * The destination range of outgoing packets that this route applies to. Both IPv4 and IPv6 are supported. Must specify an IPv4 range (e.g. 192.0.2.0/24) or an IPv6 range in RFC 4291 format (e.g. 2001:db8::/32). IPv6 range will be displayed using RFC 5952 compressed format. + * The destination range of outgoing packets that this route applies to. Both + * IPv4 and IPv6 are supported. + * Must specify an IPv4 range (e.g. 192.0.2.0/24) or an IPv6 range in RFC 4291 + * format (e.g. 2001:db8::/32). IPv6 range will be displayed using RFC 5952 + * compressed format. * * Generated from protobuf field optional string dest_range = 381327712; */ protected $dest_range = null; /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; */ protected $id = null; /** - * [Output Only] Type of this resource. Always compute#routes for Route resources. + * [Output Only] Type of this resource. Always compute#routes for + * Route resources. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?`. The first character must be a lowercase letter, and all following characters (except for the last character) must be a dash, lowercase letter, or digit. The last character must be a lowercase letter or digit. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?`. The first character must be a + * lowercase letter, and all following characters (except for the last + * character) must be a dash, lowercase letter, or digit. The last character + * must be a lowercase letter or digit. * * Generated from protobuf field optional string name = 3373707; */ @@ -64,43 +81,70 @@ class Route extends \Google\Protobuf\Internal\Message */ protected $network = null; /** - * The URL to a gateway that should handle matching packets. You can only specify the internet gateway using a full or partial valid URL: projects/ project/global/gateways/default-internet-gateway + * The URL to a gateway that should handle matching packets. + * You can only specify the internet gateway using a full or + * partial valid URL: projects/project/global/gateways/default-internet-gateway * * Generated from protobuf field optional string next_hop_gateway = 377175298; */ protected $next_hop_gateway = null; /** - * [Output Only] The full resource name of the Network Connectivity Center hub that will handle matching packets. + * [Output Only] The full resource name of the Network Connectivity Center hub + * that will handle matching packets. * * Generated from protobuf field optional string next_hop_hub = 198679219; */ protected $next_hop_hub = null; /** - * The URL to a forwarding rule of type loadBalancingScheme=INTERNAL that should handle matching packets or the IP address of the forwarding Rule. For example, the following are all valid URLs: - https://www.googleapis.com/compute/v1/projects/project/regions/region /forwardingRules/forwardingRule - regions/region/forwardingRules/forwardingRule If an IP address is provided, must specify an IPv4 address in dot-decimal notation or an IPv6 address in RFC 4291 format. For example, the following are all valid IP addresses: - 10.128.0.56 - 2001:db8::2d9:51:0:0 - 2001:db8:0:0:2d9:51:0:0 IPv6 addresses will be displayed using RFC 5952 compressed format (e.g. 2001:db8::2d9:51:0:0). Should never be an IPv4-mapped IPv6 address. + * The URL to a forwarding rule of typeloadBalancingScheme=INTERNAL that should handle matching + * packets or the IP address of the forwarding Rule. + * For example, the following are all valid URLs: + * - https://www.googleapis.com/compute/v1/projects/project/regions/region/forwardingRules/forwardingRule + * - regions/region/forwardingRules/forwardingRule + * If an IP address is provided, must specify an IPv4 address in dot-decimal + * notation or an IPv6 address in RFC 4291 format. For example, the following + * are all valid IP addresses: + * - 10.128.0.56 + * - 2001:db8::2d9:51:0:0 + * - 2001:db8:0:0:2d9:51:0:0 + * IPv6 addresses will be displayed using RFC 5952 compressed format (e.g. + * 2001:db8::2d9:51:0:0). Should never be an IPv4-mapped IPv6 address. * * Generated from protobuf field optional string next_hop_ilb = 198679901; */ protected $next_hop_ilb = null; /** - * The URL to an instance that should handle matching packets. You can specify this as a full or partial URL. For example: https://www.googleapis.com/compute/v1/projects/project/zones/zone/instances/ + * The URL to an instance that should handle matching packets. You can specify + * this as a full or partial URL. + * For example: + * https://www.googleapis.com/compute/v1/projects/project/zones/zone/instances/ * * Generated from protobuf field optional string next_hop_instance = 393508247; */ protected $next_hop_instance = null; /** - * [Output only] Internal fixed region-to-region cost that Google Cloud calculates based on factors such as network performance, distance, and available bandwidth between regions. + * [Output only] Internal fixed region-to-region cost that Google Cloud + * calculates based on factors such as network performance, distance, and + * available bandwidth between regions. * * Generated from protobuf field optional uint32 next_hop_inter_region_cost = 24442003; */ protected $next_hop_inter_region_cost = null; /** - * The network IP address of an instance that should handle matching packets. Both IPv6 address and IPv4 addresses are supported. Must specify an IPv4 address in dot-decimal notation (e.g. 192.0.2.99) or an IPv6 address in RFC 4291 format (e.g. 2001:db8::2d9:51:0:0 or 2001:db8:0:0:2d9:51:0:0). IPv6 addresses will be displayed using RFC 5952 compressed format (e.g. 2001:db8::2d9:51:0:0). Should never be an IPv4-mapped IPv6 address. + * The network IP address of an instance that should handle matching packets. + * Both IPv6 address and IPv4 addresses are supported. + * Must specify an IPv4 address in dot-decimal notation (e.g. 192.0.2.99) or + * an IPv6 address in RFC 4291 format (e.g. 2001:db8::2d9:51:0:0 or + * 2001:db8:0:0:2d9:51:0:0). IPv6 addresses will be displayed using RFC 5952 + * compressed format (e.g. 2001:db8::2d9:51:0:0). Should never be an + * IPv4-mapped IPv6 address. * * Generated from protobuf field optional string next_hop_ip = 110319529; */ protected $next_hop_ip = null; /** - * [Output Only] Multi-Exit Discriminator, a BGP route metric that indicates the desirability of a particular route in a network. + * [Output Only] Multi-Exit Discriminator, a BGP route metric that indicates + * the desirability of a particular route in a network. * * Generated from protobuf field optional uint32 next_hop_med = 198683530; */ @@ -112,14 +156,17 @@ class Route extends \Google\Protobuf\Internal\Message */ protected $next_hop_network = null; /** - * [Output Only] Indicates the origin of the route. Can be IGP (Interior Gateway Protocol), EGP (Exterior Gateway Protocol), or INCOMPLETE. + * [Output Only] Indicates the origin of the route. Can be IGP + * (Interior Gateway Protocol), EGP (Exterior Gateway Protocol), + * or INCOMPLETE. * Check the NextHopOrigin enum for the list of possible values. * * Generated from protobuf field optional string next_hop_origin = 48752808; */ protected $next_hop_origin = null; /** - * [Output Only] The network peering name that should handle matching packets, which should conform to RFC1035. + * [Output Only] The network peering name that should handle matching packets, + * which should conform to RFC1035. * * Generated from protobuf field optional string next_hop_peering = 412682750; */ @@ -131,26 +178,39 @@ class Route extends \Google\Protobuf\Internal\Message */ protected $next_hop_vpn_tunnel = null; /** - * Input only. [Input Only] Additional params passed with the request, but not persisted as part of resource payload. + * Input only. [Input Only] Additional params passed with the request, but not persisted + * as part of resource payload. * * Generated from protobuf field optional .google.cloud.compute.v1.RouteParams params = 78313862; */ protected $params = null; /** - * The priority of this route. Priority is used to break ties in cases where there is more than one matching route of equal prefix length. In cases where multiple routes have equal prefix length, the one with the lowest-numbered priority value wins. The default value is `1000`. The priority value must be from `0` to `65535`, inclusive. + * The priority of this route. Priority is used to break ties in cases + * where there is more than one matching route of equal prefix length. In + * cases where multiple routes have equal prefix length, the one with the + * lowest-numbered priority value wins. The default value is `1000`. The + * priority value must be from `0` to `65535`, inclusive. * * Generated from protobuf field optional uint32 priority = 445151652; */ protected $priority = null; /** - * [Output only] The status of the route. + * [Output only] The status of the route. This status only applies to + * dynamic routes learned by Cloud Routers. This status is not applicable + * to static routes. * Check the RouteStatus enum for the list of possible values. * * Generated from protobuf field optional string route_status = 418162344; */ protected $route_status = null; /** - * [Output Only] The type of this route, which can be one of the following values: - 'TRANSIT' for a transit route that this router learned from another Cloud Router and will readvertise to one of its BGP peers - 'SUBNET' for a route from a subnet of the VPC - 'BGP' for a route learned from a BGP peer of this router - 'STATIC' for a static route + * [Output Only] The type of this route, which can be one of the following + * values: + * - 'TRANSIT' for a transit route that this router learned from + * another Cloud Router and will readvertise to one of its BGP peers + * - 'SUBNET' for a route from a subnet of the VPC + * - 'BGP' for a route learned from a BGP peer of this router + * - 'STATIC' for a static route * Check the RouteType enum for the list of possible values. * * Generated from protobuf field optional string route_type = 375888752; @@ -169,7 +229,8 @@ class Route extends \Google\Protobuf\Internal\Message */ private $tags; /** - * [Output Only] If potential misconfigurations are detected for this route, this field will be populated with warning messages. + * [Output Only] If potential misconfigurations are detected for this + * route, this field will be populated with warning messages. * * Generated from protobuf field repeated .google.cloud.compute.v1.Warnings warnings = 498091095; */ @@ -184,58 +245,116 @@ class Route extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\RouteAsPath>|\Google\Protobuf\Internal\RepeatedField $as_paths * [Output Only] AS path. * @type string $creation_timestamp - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * @type string $description - * An optional description of this resource. Provide this field when you create the resource. + * An optional description of this resource. Provide this field when you + * create the resource. * @type string $dest_range - * The destination range of outgoing packets that this route applies to. Both IPv4 and IPv6 are supported. Must specify an IPv4 range (e.g. 192.0.2.0/24) or an IPv6 range in RFC 4291 format (e.g. 2001:db8::/32). IPv6 range will be displayed using RFC 5952 compressed format. + * The destination range of outgoing packets that this route applies to. Both + * IPv4 and IPv6 are supported. + * Must specify an IPv4 range (e.g. 192.0.2.0/24) or an IPv6 range in RFC 4291 + * format (e.g. 2001:db8::/32). IPv6 range will be displayed using RFC 5952 + * compressed format. * @type int|string $id - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * @type string $kind - * [Output Only] Type of this resource. Always compute#routes for Route resources. + * [Output Only] Type of this resource. Always compute#routes for + * Route resources. * @type string $name - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?`. The first character must be a lowercase letter, and all following characters (except for the last character) must be a dash, lowercase letter, or digit. The last character must be a lowercase letter or digit. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?`. The first character must be a + * lowercase letter, and all following characters (except for the last + * character) must be a dash, lowercase letter, or digit. The last character + * must be a lowercase letter or digit. * @type string $network * Fully-qualified URL of the network that this route applies to. * @type string $next_hop_gateway - * The URL to a gateway that should handle matching packets. You can only specify the internet gateway using a full or partial valid URL: projects/ project/global/gateways/default-internet-gateway + * The URL to a gateway that should handle matching packets. + * You can only specify the internet gateway using a full or + * partial valid URL: projects/project/global/gateways/default-internet-gateway * @type string $next_hop_hub - * [Output Only] The full resource name of the Network Connectivity Center hub that will handle matching packets. + * [Output Only] The full resource name of the Network Connectivity Center hub + * that will handle matching packets. * @type string $next_hop_ilb - * The URL to a forwarding rule of type loadBalancingScheme=INTERNAL that should handle matching packets or the IP address of the forwarding Rule. For example, the following are all valid URLs: - https://www.googleapis.com/compute/v1/projects/project/regions/region /forwardingRules/forwardingRule - regions/region/forwardingRules/forwardingRule If an IP address is provided, must specify an IPv4 address in dot-decimal notation or an IPv6 address in RFC 4291 format. For example, the following are all valid IP addresses: - 10.128.0.56 - 2001:db8::2d9:51:0:0 - 2001:db8:0:0:2d9:51:0:0 IPv6 addresses will be displayed using RFC 5952 compressed format (e.g. 2001:db8::2d9:51:0:0). Should never be an IPv4-mapped IPv6 address. + * The URL to a forwarding rule of typeloadBalancingScheme=INTERNAL that should handle matching + * packets or the IP address of the forwarding Rule. + * For example, the following are all valid URLs: + * - https://www.googleapis.com/compute/v1/projects/project/regions/region/forwardingRules/forwardingRule + * - regions/region/forwardingRules/forwardingRule + * If an IP address is provided, must specify an IPv4 address in dot-decimal + * notation or an IPv6 address in RFC 4291 format. For example, the following + * are all valid IP addresses: + * - 10.128.0.56 + * - 2001:db8::2d9:51:0:0 + * - 2001:db8:0:0:2d9:51:0:0 + * IPv6 addresses will be displayed using RFC 5952 compressed format (e.g. + * 2001:db8::2d9:51:0:0). Should never be an IPv4-mapped IPv6 address. * @type string $next_hop_instance - * The URL to an instance that should handle matching packets. You can specify this as a full or partial URL. For example: https://www.googleapis.com/compute/v1/projects/project/zones/zone/instances/ + * The URL to an instance that should handle matching packets. You can specify + * this as a full or partial URL. + * For example: + * https://www.googleapis.com/compute/v1/projects/project/zones/zone/instances/ * @type int $next_hop_inter_region_cost - * [Output only] Internal fixed region-to-region cost that Google Cloud calculates based on factors such as network performance, distance, and available bandwidth between regions. + * [Output only] Internal fixed region-to-region cost that Google Cloud + * calculates based on factors such as network performance, distance, and + * available bandwidth between regions. * @type string $next_hop_ip - * The network IP address of an instance that should handle matching packets. Both IPv6 address and IPv4 addresses are supported. Must specify an IPv4 address in dot-decimal notation (e.g. 192.0.2.99) or an IPv6 address in RFC 4291 format (e.g. 2001:db8::2d9:51:0:0 or 2001:db8:0:0:2d9:51:0:0). IPv6 addresses will be displayed using RFC 5952 compressed format (e.g. 2001:db8::2d9:51:0:0). Should never be an IPv4-mapped IPv6 address. + * The network IP address of an instance that should handle matching packets. + * Both IPv6 address and IPv4 addresses are supported. + * Must specify an IPv4 address in dot-decimal notation (e.g. 192.0.2.99) or + * an IPv6 address in RFC 4291 format (e.g. 2001:db8::2d9:51:0:0 or + * 2001:db8:0:0:2d9:51:0:0). IPv6 addresses will be displayed using RFC 5952 + * compressed format (e.g. 2001:db8::2d9:51:0:0). Should never be an + * IPv4-mapped IPv6 address. * @type int $next_hop_med - * [Output Only] Multi-Exit Discriminator, a BGP route metric that indicates the desirability of a particular route in a network. + * [Output Only] Multi-Exit Discriminator, a BGP route metric that indicates + * the desirability of a particular route in a network. * @type string $next_hop_network * The URL of the local network if it should handle matching packets. * @type string $next_hop_origin - * [Output Only] Indicates the origin of the route. Can be IGP (Interior Gateway Protocol), EGP (Exterior Gateway Protocol), or INCOMPLETE. + * [Output Only] Indicates the origin of the route. Can be IGP + * (Interior Gateway Protocol), EGP (Exterior Gateway Protocol), + * or INCOMPLETE. * Check the NextHopOrigin enum for the list of possible values. * @type string $next_hop_peering - * [Output Only] The network peering name that should handle matching packets, which should conform to RFC1035. + * [Output Only] The network peering name that should handle matching packets, + * which should conform to RFC1035. * @type string $next_hop_vpn_tunnel * The URL to a VpnTunnel that should handle matching packets. * @type \Google\Cloud\Compute\V1\RouteParams $params - * Input only. [Input Only] Additional params passed with the request, but not persisted as part of resource payload. + * Input only. [Input Only] Additional params passed with the request, but not persisted + * as part of resource payload. * @type int $priority - * The priority of this route. Priority is used to break ties in cases where there is more than one matching route of equal prefix length. In cases where multiple routes have equal prefix length, the one with the lowest-numbered priority value wins. The default value is `1000`. The priority value must be from `0` to `65535`, inclusive. + * The priority of this route. Priority is used to break ties in cases + * where there is more than one matching route of equal prefix length. In + * cases where multiple routes have equal prefix length, the one with the + * lowest-numbered priority value wins. The default value is `1000`. The + * priority value must be from `0` to `65535`, inclusive. * @type string $route_status - * [Output only] The status of the route. + * [Output only] The status of the route. This status only applies to + * dynamic routes learned by Cloud Routers. This status is not applicable + * to static routes. * Check the RouteStatus enum for the list of possible values. * @type string $route_type - * [Output Only] The type of this route, which can be one of the following values: - 'TRANSIT' for a transit route that this router learned from another Cloud Router and will readvertise to one of its BGP peers - 'SUBNET' for a route from a subnet of the VPC - 'BGP' for a route learned from a BGP peer of this router - 'STATIC' for a static route + * [Output Only] The type of this route, which can be one of the following + * values: + * - 'TRANSIT' for a transit route that this router learned from + * another Cloud Router and will readvertise to one of its BGP peers + * - 'SUBNET' for a route from a subnet of the VPC + * - 'BGP' for a route learned from a BGP peer of this router + * - 'STATIC' for a static route * Check the RouteType enum for the list of possible values. * @type string $self_link * [Output Only] Server-defined fully-qualified URL for this resource. * @type array|\Google\Protobuf\Internal\RepeatedField $tags * A list of instance tags to which this route applies. * @type array<\Google\Cloud\Compute\V1\Warnings>|\Google\Protobuf\Internal\RepeatedField $warnings - * [Output Only] If potential misconfigurations are detected for this route, this field will be populated with warning messages. + * [Output Only] If potential misconfigurations are detected for this + * route, this field will be populated with warning messages. * } */ public function __construct($data = NULL) { @@ -270,7 +389,8 @@ public function setAsPaths($var) } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @return string @@ -291,7 +411,8 @@ public function clearCreationTimestamp() } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @param string $var @@ -306,7 +427,8 @@ public function setCreationTimestamp($var) } /** - * An optional description of this resource. Provide this field when you create the resource. + * An optional description of this resource. Provide this field when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @return string @@ -327,7 +449,8 @@ public function clearDescription() } /** - * An optional description of this resource. Provide this field when you create the resource. + * An optional description of this resource. Provide this field when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @param string $var @@ -342,7 +465,11 @@ public function setDescription($var) } /** - * The destination range of outgoing packets that this route applies to. Both IPv4 and IPv6 are supported. Must specify an IPv4 range (e.g. 192.0.2.0/24) or an IPv6 range in RFC 4291 format (e.g. 2001:db8::/32). IPv6 range will be displayed using RFC 5952 compressed format. + * The destination range of outgoing packets that this route applies to. Both + * IPv4 and IPv6 are supported. + * Must specify an IPv4 range (e.g. 192.0.2.0/24) or an IPv6 range in RFC 4291 + * format (e.g. 2001:db8::/32). IPv6 range will be displayed using RFC 5952 + * compressed format. * * Generated from protobuf field optional string dest_range = 381327712; * @return string @@ -363,7 +490,11 @@ public function clearDestRange() } /** - * The destination range of outgoing packets that this route applies to. Both IPv4 and IPv6 are supported. Must specify an IPv4 range (e.g. 192.0.2.0/24) or an IPv6 range in RFC 4291 format (e.g. 2001:db8::/32). IPv6 range will be displayed using RFC 5952 compressed format. + * The destination range of outgoing packets that this route applies to. Both + * IPv4 and IPv6 are supported. + * Must specify an IPv4 range (e.g. 192.0.2.0/24) or an IPv6 range in RFC 4291 + * format (e.g. 2001:db8::/32). IPv6 range will be displayed using RFC 5952 + * compressed format. * * Generated from protobuf field optional string dest_range = 381327712; * @param string $var @@ -378,7 +509,8 @@ public function setDestRange($var) } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @return int|string @@ -399,7 +531,8 @@ public function clearId() } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @param int|string $var @@ -414,7 +547,8 @@ public function setId($var) } /** - * [Output Only] Type of this resource. Always compute#routes for Route resources. + * [Output Only] Type of this resource. Always compute#routes for + * Route resources. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -435,7 +569,8 @@ public function clearKind() } /** - * [Output Only] Type of this resource. Always compute#routes for Route resources. + * [Output Only] Type of this resource. Always compute#routes for + * Route resources. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -450,7 +585,13 @@ public function setKind($var) } /** - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?`. The first character must be a lowercase letter, and all following characters (except for the last character) must be a dash, lowercase letter, or digit. The last character must be a lowercase letter or digit. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?`. The first character must be a + * lowercase letter, and all following characters (except for the last + * character) must be a dash, lowercase letter, or digit. The last character + * must be a lowercase letter or digit. * * Generated from protobuf field optional string name = 3373707; * @return string @@ -471,7 +612,13 @@ public function clearName() } /** - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?`. The first character must be a lowercase letter, and all following characters (except for the last character) must be a dash, lowercase letter, or digit. The last character must be a lowercase letter or digit. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?`. The first character must be a + * lowercase letter, and all following characters (except for the last + * character) must be a dash, lowercase letter, or digit. The last character + * must be a lowercase letter or digit. * * Generated from protobuf field optional string name = 3373707; * @param string $var @@ -522,7 +669,9 @@ public function setNetwork($var) } /** - * The URL to a gateway that should handle matching packets. You can only specify the internet gateway using a full or partial valid URL: projects/ project/global/gateways/default-internet-gateway + * The URL to a gateway that should handle matching packets. + * You can only specify the internet gateway using a full or + * partial valid URL: projects/project/global/gateways/default-internet-gateway * * Generated from protobuf field optional string next_hop_gateway = 377175298; * @return string @@ -543,7 +692,9 @@ public function clearNextHopGateway() } /** - * The URL to a gateway that should handle matching packets. You can only specify the internet gateway using a full or partial valid URL: projects/ project/global/gateways/default-internet-gateway + * The URL to a gateway that should handle matching packets. + * You can only specify the internet gateway using a full or + * partial valid URL: projects/project/global/gateways/default-internet-gateway * * Generated from protobuf field optional string next_hop_gateway = 377175298; * @param string $var @@ -558,7 +709,8 @@ public function setNextHopGateway($var) } /** - * [Output Only] The full resource name of the Network Connectivity Center hub that will handle matching packets. + * [Output Only] The full resource name of the Network Connectivity Center hub + * that will handle matching packets. * * Generated from protobuf field optional string next_hop_hub = 198679219; * @return string @@ -579,7 +731,8 @@ public function clearNextHopHub() } /** - * [Output Only] The full resource name of the Network Connectivity Center hub that will handle matching packets. + * [Output Only] The full resource name of the Network Connectivity Center hub + * that will handle matching packets. * * Generated from protobuf field optional string next_hop_hub = 198679219; * @param string $var @@ -594,7 +747,19 @@ public function setNextHopHub($var) } /** - * The URL to a forwarding rule of type loadBalancingScheme=INTERNAL that should handle matching packets or the IP address of the forwarding Rule. For example, the following are all valid URLs: - https://www.googleapis.com/compute/v1/projects/project/regions/region /forwardingRules/forwardingRule - regions/region/forwardingRules/forwardingRule If an IP address is provided, must specify an IPv4 address in dot-decimal notation or an IPv6 address in RFC 4291 format. For example, the following are all valid IP addresses: - 10.128.0.56 - 2001:db8::2d9:51:0:0 - 2001:db8:0:0:2d9:51:0:0 IPv6 addresses will be displayed using RFC 5952 compressed format (e.g. 2001:db8::2d9:51:0:0). Should never be an IPv4-mapped IPv6 address. + * The URL to a forwarding rule of typeloadBalancingScheme=INTERNAL that should handle matching + * packets or the IP address of the forwarding Rule. + * For example, the following are all valid URLs: + * - https://www.googleapis.com/compute/v1/projects/project/regions/region/forwardingRules/forwardingRule + * - regions/region/forwardingRules/forwardingRule + * If an IP address is provided, must specify an IPv4 address in dot-decimal + * notation or an IPv6 address in RFC 4291 format. For example, the following + * are all valid IP addresses: + * - 10.128.0.56 + * - 2001:db8::2d9:51:0:0 + * - 2001:db8:0:0:2d9:51:0:0 + * IPv6 addresses will be displayed using RFC 5952 compressed format (e.g. + * 2001:db8::2d9:51:0:0). Should never be an IPv4-mapped IPv6 address. * * Generated from protobuf field optional string next_hop_ilb = 198679901; * @return string @@ -615,7 +780,19 @@ public function clearNextHopIlb() } /** - * The URL to a forwarding rule of type loadBalancingScheme=INTERNAL that should handle matching packets or the IP address of the forwarding Rule. For example, the following are all valid URLs: - https://www.googleapis.com/compute/v1/projects/project/regions/region /forwardingRules/forwardingRule - regions/region/forwardingRules/forwardingRule If an IP address is provided, must specify an IPv4 address in dot-decimal notation or an IPv6 address in RFC 4291 format. For example, the following are all valid IP addresses: - 10.128.0.56 - 2001:db8::2d9:51:0:0 - 2001:db8:0:0:2d9:51:0:0 IPv6 addresses will be displayed using RFC 5952 compressed format (e.g. 2001:db8::2d9:51:0:0). Should never be an IPv4-mapped IPv6 address. + * The URL to a forwarding rule of typeloadBalancingScheme=INTERNAL that should handle matching + * packets or the IP address of the forwarding Rule. + * For example, the following are all valid URLs: + * - https://www.googleapis.com/compute/v1/projects/project/regions/region/forwardingRules/forwardingRule + * - regions/region/forwardingRules/forwardingRule + * If an IP address is provided, must specify an IPv4 address in dot-decimal + * notation or an IPv6 address in RFC 4291 format. For example, the following + * are all valid IP addresses: + * - 10.128.0.56 + * - 2001:db8::2d9:51:0:0 + * - 2001:db8:0:0:2d9:51:0:0 + * IPv6 addresses will be displayed using RFC 5952 compressed format (e.g. + * 2001:db8::2d9:51:0:0). Should never be an IPv4-mapped IPv6 address. * * Generated from protobuf field optional string next_hop_ilb = 198679901; * @param string $var @@ -630,7 +807,10 @@ public function setNextHopIlb($var) } /** - * The URL to an instance that should handle matching packets. You can specify this as a full or partial URL. For example: https://www.googleapis.com/compute/v1/projects/project/zones/zone/instances/ + * The URL to an instance that should handle matching packets. You can specify + * this as a full or partial URL. + * For example: + * https://www.googleapis.com/compute/v1/projects/project/zones/zone/instances/ * * Generated from protobuf field optional string next_hop_instance = 393508247; * @return string @@ -651,7 +831,10 @@ public function clearNextHopInstance() } /** - * The URL to an instance that should handle matching packets. You can specify this as a full or partial URL. For example: https://www.googleapis.com/compute/v1/projects/project/zones/zone/instances/ + * The URL to an instance that should handle matching packets. You can specify + * this as a full or partial URL. + * For example: + * https://www.googleapis.com/compute/v1/projects/project/zones/zone/instances/ * * Generated from protobuf field optional string next_hop_instance = 393508247; * @param string $var @@ -666,7 +849,9 @@ public function setNextHopInstance($var) } /** - * [Output only] Internal fixed region-to-region cost that Google Cloud calculates based on factors such as network performance, distance, and available bandwidth between regions. + * [Output only] Internal fixed region-to-region cost that Google Cloud + * calculates based on factors such as network performance, distance, and + * available bandwidth between regions. * * Generated from protobuf field optional uint32 next_hop_inter_region_cost = 24442003; * @return int @@ -687,7 +872,9 @@ public function clearNextHopInterRegionCost() } /** - * [Output only] Internal fixed region-to-region cost that Google Cloud calculates based on factors such as network performance, distance, and available bandwidth between regions. + * [Output only] Internal fixed region-to-region cost that Google Cloud + * calculates based on factors such as network performance, distance, and + * available bandwidth between regions. * * Generated from protobuf field optional uint32 next_hop_inter_region_cost = 24442003; * @param int $var @@ -702,7 +889,13 @@ public function setNextHopInterRegionCost($var) } /** - * The network IP address of an instance that should handle matching packets. Both IPv6 address and IPv4 addresses are supported. Must specify an IPv4 address in dot-decimal notation (e.g. 192.0.2.99) or an IPv6 address in RFC 4291 format (e.g. 2001:db8::2d9:51:0:0 or 2001:db8:0:0:2d9:51:0:0). IPv6 addresses will be displayed using RFC 5952 compressed format (e.g. 2001:db8::2d9:51:0:0). Should never be an IPv4-mapped IPv6 address. + * The network IP address of an instance that should handle matching packets. + * Both IPv6 address and IPv4 addresses are supported. + * Must specify an IPv4 address in dot-decimal notation (e.g. 192.0.2.99) or + * an IPv6 address in RFC 4291 format (e.g. 2001:db8::2d9:51:0:0 or + * 2001:db8:0:0:2d9:51:0:0). IPv6 addresses will be displayed using RFC 5952 + * compressed format (e.g. 2001:db8::2d9:51:0:0). Should never be an + * IPv4-mapped IPv6 address. * * Generated from protobuf field optional string next_hop_ip = 110319529; * @return string @@ -723,7 +916,13 @@ public function clearNextHopIp() } /** - * The network IP address of an instance that should handle matching packets. Both IPv6 address and IPv4 addresses are supported. Must specify an IPv4 address in dot-decimal notation (e.g. 192.0.2.99) or an IPv6 address in RFC 4291 format (e.g. 2001:db8::2d9:51:0:0 or 2001:db8:0:0:2d9:51:0:0). IPv6 addresses will be displayed using RFC 5952 compressed format (e.g. 2001:db8::2d9:51:0:0). Should never be an IPv4-mapped IPv6 address. + * The network IP address of an instance that should handle matching packets. + * Both IPv6 address and IPv4 addresses are supported. + * Must specify an IPv4 address in dot-decimal notation (e.g. 192.0.2.99) or + * an IPv6 address in RFC 4291 format (e.g. 2001:db8::2d9:51:0:0 or + * 2001:db8:0:0:2d9:51:0:0). IPv6 addresses will be displayed using RFC 5952 + * compressed format (e.g. 2001:db8::2d9:51:0:0). Should never be an + * IPv4-mapped IPv6 address. * * Generated from protobuf field optional string next_hop_ip = 110319529; * @param string $var @@ -738,7 +937,8 @@ public function setNextHopIp($var) } /** - * [Output Only] Multi-Exit Discriminator, a BGP route metric that indicates the desirability of a particular route in a network. + * [Output Only] Multi-Exit Discriminator, a BGP route metric that indicates + * the desirability of a particular route in a network. * * Generated from protobuf field optional uint32 next_hop_med = 198683530; * @return int @@ -759,7 +959,8 @@ public function clearNextHopMed() } /** - * [Output Only] Multi-Exit Discriminator, a BGP route metric that indicates the desirability of a particular route in a network. + * [Output Only] Multi-Exit Discriminator, a BGP route metric that indicates + * the desirability of a particular route in a network. * * Generated from protobuf field optional uint32 next_hop_med = 198683530; * @param int $var @@ -810,7 +1011,9 @@ public function setNextHopNetwork($var) } /** - * [Output Only] Indicates the origin of the route. Can be IGP (Interior Gateway Protocol), EGP (Exterior Gateway Protocol), or INCOMPLETE. + * [Output Only] Indicates the origin of the route. Can be IGP + * (Interior Gateway Protocol), EGP (Exterior Gateway Protocol), + * or INCOMPLETE. * Check the NextHopOrigin enum for the list of possible values. * * Generated from protobuf field optional string next_hop_origin = 48752808; @@ -832,7 +1035,9 @@ public function clearNextHopOrigin() } /** - * [Output Only] Indicates the origin of the route. Can be IGP (Interior Gateway Protocol), EGP (Exterior Gateway Protocol), or INCOMPLETE. + * [Output Only] Indicates the origin of the route. Can be IGP + * (Interior Gateway Protocol), EGP (Exterior Gateway Protocol), + * or INCOMPLETE. * Check the NextHopOrigin enum for the list of possible values. * * Generated from protobuf field optional string next_hop_origin = 48752808; @@ -848,7 +1053,8 @@ public function setNextHopOrigin($var) } /** - * [Output Only] The network peering name that should handle matching packets, which should conform to RFC1035. + * [Output Only] The network peering name that should handle matching packets, + * which should conform to RFC1035. * * Generated from protobuf field optional string next_hop_peering = 412682750; * @return string @@ -869,7 +1075,8 @@ public function clearNextHopPeering() } /** - * [Output Only] The network peering name that should handle matching packets, which should conform to RFC1035. + * [Output Only] The network peering name that should handle matching packets, + * which should conform to RFC1035. * * Generated from protobuf field optional string next_hop_peering = 412682750; * @param string $var @@ -920,7 +1127,8 @@ public function setNextHopVpnTunnel($var) } /** - * Input only. [Input Only] Additional params passed with the request, but not persisted as part of resource payload. + * Input only. [Input Only] Additional params passed with the request, but not persisted + * as part of resource payload. * * Generated from protobuf field optional .google.cloud.compute.v1.RouteParams params = 78313862; * @return \Google\Cloud\Compute\V1\RouteParams|null @@ -941,7 +1149,8 @@ public function clearParams() } /** - * Input only. [Input Only] Additional params passed with the request, but not persisted as part of resource payload. + * Input only. [Input Only] Additional params passed with the request, but not persisted + * as part of resource payload. * * Generated from protobuf field optional .google.cloud.compute.v1.RouteParams params = 78313862; * @param \Google\Cloud\Compute\V1\RouteParams $var @@ -956,7 +1165,11 @@ public function setParams($var) } /** - * The priority of this route. Priority is used to break ties in cases where there is more than one matching route of equal prefix length. In cases where multiple routes have equal prefix length, the one with the lowest-numbered priority value wins. The default value is `1000`. The priority value must be from `0` to `65535`, inclusive. + * The priority of this route. Priority is used to break ties in cases + * where there is more than one matching route of equal prefix length. In + * cases where multiple routes have equal prefix length, the one with the + * lowest-numbered priority value wins. The default value is `1000`. The + * priority value must be from `0` to `65535`, inclusive. * * Generated from protobuf field optional uint32 priority = 445151652; * @return int @@ -977,7 +1190,11 @@ public function clearPriority() } /** - * The priority of this route. Priority is used to break ties in cases where there is more than one matching route of equal prefix length. In cases where multiple routes have equal prefix length, the one with the lowest-numbered priority value wins. The default value is `1000`. The priority value must be from `0` to `65535`, inclusive. + * The priority of this route. Priority is used to break ties in cases + * where there is more than one matching route of equal prefix length. In + * cases where multiple routes have equal prefix length, the one with the + * lowest-numbered priority value wins. The default value is `1000`. The + * priority value must be from `0` to `65535`, inclusive. * * Generated from protobuf field optional uint32 priority = 445151652; * @param int $var @@ -992,7 +1209,9 @@ public function setPriority($var) } /** - * [Output only] The status of the route. + * [Output only] The status of the route. This status only applies to + * dynamic routes learned by Cloud Routers. This status is not applicable + * to static routes. * Check the RouteStatus enum for the list of possible values. * * Generated from protobuf field optional string route_status = 418162344; @@ -1014,7 +1233,9 @@ public function clearRouteStatus() } /** - * [Output only] The status of the route. + * [Output only] The status of the route. This status only applies to + * dynamic routes learned by Cloud Routers. This status is not applicable + * to static routes. * Check the RouteStatus enum for the list of possible values. * * Generated from protobuf field optional string route_status = 418162344; @@ -1030,7 +1251,13 @@ public function setRouteStatus($var) } /** - * [Output Only] The type of this route, which can be one of the following values: - 'TRANSIT' for a transit route that this router learned from another Cloud Router and will readvertise to one of its BGP peers - 'SUBNET' for a route from a subnet of the VPC - 'BGP' for a route learned from a BGP peer of this router - 'STATIC' for a static route + * [Output Only] The type of this route, which can be one of the following + * values: + * - 'TRANSIT' for a transit route that this router learned from + * another Cloud Router and will readvertise to one of its BGP peers + * - 'SUBNET' for a route from a subnet of the VPC + * - 'BGP' for a route learned from a BGP peer of this router + * - 'STATIC' for a static route * Check the RouteType enum for the list of possible values. * * Generated from protobuf field optional string route_type = 375888752; @@ -1052,7 +1279,13 @@ public function clearRouteType() } /** - * [Output Only] The type of this route, which can be one of the following values: - 'TRANSIT' for a transit route that this router learned from another Cloud Router and will readvertise to one of its BGP peers - 'SUBNET' for a route from a subnet of the VPC - 'BGP' for a route learned from a BGP peer of this router - 'STATIC' for a static route + * [Output Only] The type of this route, which can be one of the following + * values: + * - 'TRANSIT' for a transit route that this router learned from + * another Cloud Router and will readvertise to one of its BGP peers + * - 'SUBNET' for a route from a subnet of the VPC + * - 'BGP' for a route learned from a BGP peer of this router + * - 'STATIC' for a static route * Check the RouteType enum for the list of possible values. * * Generated from protobuf field optional string route_type = 375888752; @@ -1130,7 +1363,8 @@ public function setTags($var) } /** - * [Output Only] If potential misconfigurations are detected for this route, this field will be populated with warning messages. + * [Output Only] If potential misconfigurations are detected for this + * route, this field will be populated with warning messages. * * Generated from protobuf field repeated .google.cloud.compute.v1.Warnings warnings = 498091095; * @return \Google\Protobuf\Internal\RepeatedField @@ -1141,7 +1375,8 @@ public function getWarnings() } /** - * [Output Only] If potential misconfigurations are detected for this route, this field will be populated with warning messages. + * [Output Only] If potential misconfigurations are detected for this + * route, this field will be populated with warning messages. * * Generated from protobuf field repeated .google.cloud.compute.v1.Warnings warnings = 498091095; * @param array<\Google\Cloud\Compute\V1\Warnings>|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/Route/NextHopOrigin.php b/Compute/src/V1/Route/NextHopOrigin.php index 2b744cc4d098..7b2a9d52e241 100644 --- a/Compute/src/V1/Route/NextHopOrigin.php +++ b/Compute/src/V1/Route/NextHopOrigin.php @@ -7,7 +7,9 @@ use UnexpectedValueException; /** - * [Output Only] Indicates the origin of the route. Can be IGP (Interior Gateway Protocol), EGP (Exterior Gateway Protocol), or INCOMPLETE. + * [Output Only] Indicates the origin of the route. Can be IGP + * (Interior Gateway Protocol), EGP (Exterior Gateway Protocol), + * or INCOMPLETE. * * Protobuf type google.cloud.compute.v1.Route.NextHopOrigin */ diff --git a/Compute/src/V1/Route/RouteStatus.php b/Compute/src/V1/Route/RouteStatus.php index 13bd79d0108d..ea92503d67bb 100644 --- a/Compute/src/V1/Route/RouteStatus.php +++ b/Compute/src/V1/Route/RouteStatus.php @@ -7,7 +7,9 @@ use UnexpectedValueException; /** - * [Output only] The status of the route. + * [Output only] The status of the route. This status only applies to + * dynamic routes learned by Cloud Routers. This status is not applicable + * to static routes. * * Protobuf type google.cloud.compute.v1.Route.RouteStatus */ @@ -26,19 +28,23 @@ class RouteStatus */ const ACTIVE = 314733318; /** - * The route is dropped due to the VPC exceeding the dynamic route limit. For dynamic route limit, please refer to the Learned route example + * The route is dropped due to the VPC exceeding the dynamic route limit. + * For dynamic route limit, please refer to the + * Learned route example * * Generated from protobuf enum DROPPED = 496235424; */ const DROPPED = 496235424; /** - * This route is processed but inactive due to failure from the backend. The backend may have rejected the route + * This route is processed but inactive due to failure from the backend. The + * backend may have rejected the route * * Generated from protobuf enum INACTIVE = 270421099; */ const INACTIVE = 270421099; /** - * This route is being processed internally. The status will change once processed. + * This route is being processed internally. The status will change once + * processed. * * Generated from protobuf enum PENDING = 35394935; */ diff --git a/Compute/src/V1/Route/RouteType.php b/Compute/src/V1/Route/RouteType.php index 22ec38846616..4583f770034d 100644 --- a/Compute/src/V1/Route/RouteType.php +++ b/Compute/src/V1/Route/RouteType.php @@ -7,7 +7,13 @@ use UnexpectedValueException; /** - * [Output Only] The type of this route, which can be one of the following values: - 'TRANSIT' for a transit route that this router learned from another Cloud Router and will readvertise to one of its BGP peers - 'SUBNET' for a route from a subnet of the VPC - 'BGP' for a route learned from a BGP peer of this router - 'STATIC' for a static route + * [Output Only] The type of this route, which can be one of the following + * values: + * - 'TRANSIT' for a transit route that this router learned from + * another Cloud Router and will readvertise to one of its BGP peers + * - 'SUBNET' for a route from a subnet of the VPC + * - 'BGP' for a route learned from a BGP peer of this router + * - 'STATIC' for a static route * * Protobuf type google.cloud.compute.v1.Route.RouteType */ diff --git a/Compute/src/V1/RouteAsPath.php b/Compute/src/V1/RouteAsPath.php index a015c1712546..7afa1c69e42d 100644 --- a/Compute/src/V1/RouteAsPath.php +++ b/Compute/src/V1/RouteAsPath.php @@ -21,7 +21,18 @@ class RouteAsPath extends \Google\Protobuf\Internal\Message */ private $as_lists; /** - * [Output Only] The type of the AS Path, which can be one of the following values: - 'AS_SET': unordered set of autonomous systems that the route in has traversed - 'AS_SEQUENCE': ordered set of autonomous systems that the route has traversed - 'AS_CONFED_SEQUENCE': ordered set of Member Autonomous Systems in the local confederation that the route has traversed - 'AS_CONFED_SET': unordered set of Member Autonomous Systems in the local confederation that the route has traversed + * [Output Only] The type of the AS Path, which can be one of the following + * values: + * - 'AS_SET': unordered set of autonomous systems that the route + * in has traversed + * - 'AS_SEQUENCE': ordered set of autonomous + * systems that the route has traversed + * - 'AS_CONFED_SEQUENCE': + * ordered set of Member Autonomous Systems in the local confederation that + * the route has traversed + * - 'AS_CONFED_SET': unordered set of + * Member Autonomous Systems in the local confederation that the route has + * traversed * Check the PathSegmentType enum for the list of possible values. * * Generated from protobuf field optional string path_segment_type = 513464992; @@ -37,7 +48,18 @@ class RouteAsPath extends \Google\Protobuf\Internal\Message * @type array|\Google\Protobuf\Internal\RepeatedField $as_lists * [Output Only] The AS numbers of the AS Path. * @type string $path_segment_type - * [Output Only] The type of the AS Path, which can be one of the following values: - 'AS_SET': unordered set of autonomous systems that the route in has traversed - 'AS_SEQUENCE': ordered set of autonomous systems that the route has traversed - 'AS_CONFED_SEQUENCE': ordered set of Member Autonomous Systems in the local confederation that the route has traversed - 'AS_CONFED_SET': unordered set of Member Autonomous Systems in the local confederation that the route has traversed + * [Output Only] The type of the AS Path, which can be one of the following + * values: + * - 'AS_SET': unordered set of autonomous systems that the route + * in has traversed + * - 'AS_SEQUENCE': ordered set of autonomous + * systems that the route has traversed + * - 'AS_CONFED_SEQUENCE': + * ordered set of Member Autonomous Systems in the local confederation that + * the route has traversed + * - 'AS_CONFED_SET': unordered set of + * Member Autonomous Systems in the local confederation that the route has + * traversed * Check the PathSegmentType enum for the list of possible values. * } */ @@ -73,7 +95,18 @@ public function setAsLists($var) } /** - * [Output Only] The type of the AS Path, which can be one of the following values: - 'AS_SET': unordered set of autonomous systems that the route in has traversed - 'AS_SEQUENCE': ordered set of autonomous systems that the route has traversed - 'AS_CONFED_SEQUENCE': ordered set of Member Autonomous Systems in the local confederation that the route has traversed - 'AS_CONFED_SET': unordered set of Member Autonomous Systems in the local confederation that the route has traversed + * [Output Only] The type of the AS Path, which can be one of the following + * values: + * - 'AS_SET': unordered set of autonomous systems that the route + * in has traversed + * - 'AS_SEQUENCE': ordered set of autonomous + * systems that the route has traversed + * - 'AS_CONFED_SEQUENCE': + * ordered set of Member Autonomous Systems in the local confederation that + * the route has traversed + * - 'AS_CONFED_SET': unordered set of + * Member Autonomous Systems in the local confederation that the route has + * traversed * Check the PathSegmentType enum for the list of possible values. * * Generated from protobuf field optional string path_segment_type = 513464992; @@ -95,7 +128,18 @@ public function clearPathSegmentType() } /** - * [Output Only] The type of the AS Path, which can be one of the following values: - 'AS_SET': unordered set of autonomous systems that the route in has traversed - 'AS_SEQUENCE': ordered set of autonomous systems that the route has traversed - 'AS_CONFED_SEQUENCE': ordered set of Member Autonomous Systems in the local confederation that the route has traversed - 'AS_CONFED_SET': unordered set of Member Autonomous Systems in the local confederation that the route has traversed + * [Output Only] The type of the AS Path, which can be one of the following + * values: + * - 'AS_SET': unordered set of autonomous systems that the route + * in has traversed + * - 'AS_SEQUENCE': ordered set of autonomous + * systems that the route has traversed + * - 'AS_CONFED_SEQUENCE': + * ordered set of Member Autonomous Systems in the local confederation that + * the route has traversed + * - 'AS_CONFED_SET': unordered set of + * Member Autonomous Systems in the local confederation that the route has + * traversed * Check the PathSegmentType enum for the list of possible values. * * Generated from protobuf field optional string path_segment_type = 513464992; diff --git a/Compute/src/V1/RouteAsPath/PathSegmentType.php b/Compute/src/V1/RouteAsPath/PathSegmentType.php index b395f6a997a2..64736b799e2b 100644 --- a/Compute/src/V1/RouteAsPath/PathSegmentType.php +++ b/Compute/src/V1/RouteAsPath/PathSegmentType.php @@ -7,7 +7,18 @@ use UnexpectedValueException; /** - * [Output Only] The type of the AS Path, which can be one of the following values: - 'AS_SET': unordered set of autonomous systems that the route in has traversed - 'AS_SEQUENCE': ordered set of autonomous systems that the route has traversed - 'AS_CONFED_SEQUENCE': ordered set of Member Autonomous Systems in the local confederation that the route has traversed - 'AS_CONFED_SET': unordered set of Member Autonomous Systems in the local confederation that the route has traversed + * [Output Only] The type of the AS Path, which can be one of the following + * values: + * - 'AS_SET': unordered set of autonomous systems that the route + * in has traversed + * - 'AS_SEQUENCE': ordered set of autonomous + * systems that the route has traversed + * - 'AS_CONFED_SEQUENCE': + * ordered set of Member Autonomous Systems in the local confederation that + * the route has traversed + * - 'AS_CONFED_SET': unordered set of + * Member Autonomous Systems in the local confederation that the route has + * traversed * * Protobuf type google.cloud.compute.v1.RouteAsPath.PathSegmentType */ diff --git a/Compute/src/V1/RouteList.php b/Compute/src/V1/RouteList.php index d2c7249caf4f..1d24c79652d8 100644 --- a/Compute/src/V1/RouteList.php +++ b/Compute/src/V1/RouteList.php @@ -34,7 +34,11 @@ class RouteList extends \Google\Protobuf\Internal\Message */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -65,7 +69,11 @@ class RouteList extends \Google\Protobuf\Internal\Message * @type string $kind * Type of resource. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type \Google\Cloud\Compute\V1\Warning $warning @@ -176,7 +184,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -197,7 +209,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/RouteParams.php b/Compute/src/V1/RouteParams.php index a9a608f30fb6..0a4e50707d1e 100644 --- a/Compute/src/V1/RouteParams.php +++ b/Compute/src/V1/RouteParams.php @@ -16,7 +16,18 @@ class RouteParams extends \Google\Protobuf\Internal\Message { /** - * Tag keys/values directly bound to this resource. Tag keys and values have the same definition as resource manager tags. The field is allowed for INSERT only. The keys/values to set on the resource should be specified in either ID { : } or Namespaced format { : }. For example the following are valid inputs: * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} * {"123/environment" : "production", "345/abc" : "xyz"} Note: * Invalid combinations of ID & namespaced format is not supported. For instance: {"123/environment" : "tagValues/444"} is invalid. + * Tag keys/values directly bound to this resource. + * Tag keys and values have the same definition as resource + * manager tags. The field is allowed for INSERT + * only. The keys/values to set on the resource should be specified in + * either ID { : } or Namespaced format + * { : }. + * For example the following are valid inputs: + * * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} + * * {"123/environment" : "production", "345/abc" : "xyz"} + * Note: + * * Invalid combinations of ID & namespaced format is not supported. For + * instance: {"123/environment" : "tagValues/444"} is invalid. * * Generated from protobuf field map resource_manager_tags = 377671164; */ @@ -29,7 +40,18 @@ class RouteParams extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type array|\Google\Protobuf\Internal\MapField $resource_manager_tags - * Tag keys/values directly bound to this resource. Tag keys and values have the same definition as resource manager tags. The field is allowed for INSERT only. The keys/values to set on the resource should be specified in either ID { : } or Namespaced format { : }. For example the following are valid inputs: * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} * {"123/environment" : "production", "345/abc" : "xyz"} Note: * Invalid combinations of ID & namespaced format is not supported. For instance: {"123/environment" : "tagValues/444"} is invalid. + * Tag keys/values directly bound to this resource. + * Tag keys and values have the same definition as resource + * manager tags. The field is allowed for INSERT + * only. The keys/values to set on the resource should be specified in + * either ID { : } or Namespaced format + * { : }. + * For example the following are valid inputs: + * * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} + * * {"123/environment" : "production", "345/abc" : "xyz"} + * Note: + * * Invalid combinations of ID & namespaced format is not supported. For + * instance: {"123/environment" : "tagValues/444"} is invalid. * } */ public function __construct($data = NULL) { @@ -38,7 +60,18 @@ public function __construct($data = NULL) { } /** - * Tag keys/values directly bound to this resource. Tag keys and values have the same definition as resource manager tags. The field is allowed for INSERT only. The keys/values to set on the resource should be specified in either ID { : } or Namespaced format { : }. For example the following are valid inputs: * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} * {"123/environment" : "production", "345/abc" : "xyz"} Note: * Invalid combinations of ID & namespaced format is not supported. For instance: {"123/environment" : "tagValues/444"} is invalid. + * Tag keys/values directly bound to this resource. + * Tag keys and values have the same definition as resource + * manager tags. The field is allowed for INSERT + * only. The keys/values to set on the resource should be specified in + * either ID { : } or Namespaced format + * { : }. + * For example the following are valid inputs: + * * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} + * * {"123/environment" : "production", "345/abc" : "xyz"} + * Note: + * * Invalid combinations of ID & namespaced format is not supported. For + * instance: {"123/environment" : "tagValues/444"} is invalid. * * Generated from protobuf field map resource_manager_tags = 377671164; * @return \Google\Protobuf\Internal\MapField @@ -49,7 +82,18 @@ public function getResourceManagerTags() } /** - * Tag keys/values directly bound to this resource. Tag keys and values have the same definition as resource manager tags. The field is allowed for INSERT only. The keys/values to set on the resource should be specified in either ID { : } or Namespaced format { : }. For example the following are valid inputs: * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} * {"123/environment" : "production", "345/abc" : "xyz"} Note: * Invalid combinations of ID & namespaced format is not supported. For instance: {"123/environment" : "tagValues/444"} is invalid. + * Tag keys/values directly bound to this resource. + * Tag keys and values have the same definition as resource + * manager tags. The field is allowed for INSERT + * only. The keys/values to set on the resource should be specified in + * either ID { : } or Namespaced format + * { : }. + * For example the following are valid inputs: + * * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} + * * {"123/environment" : "production", "345/abc" : "xyz"} + * Note: + * * Invalid combinations of ID & namespaced format is not supported. For + * instance: {"123/environment" : "tagValues/444"} is invalid. * * Generated from protobuf field map resource_manager_tags = 377671164; * @param array|\Google\Protobuf\Internal\MapField $var diff --git a/Compute/src/V1/RoutePolicy.php b/Compute/src/V1/RoutePolicy.php index 8dd1143482bd..97c47b6021db 100644 --- a/Compute/src/V1/RoutePolicy.php +++ b/Compute/src/V1/RoutePolicy.php @@ -21,19 +21,29 @@ class RoutePolicy extends \Google\Protobuf\Internal\Message */ protected $description = null; /** - * A fingerprint for the Route Policy being applied to this Router, which is essentially a hash of the Route Policy used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update Route Policy. You must always provide an up-to-date fingerprint hash in order to update or change labels. To see the latest fingerprint, make a getRoutePolicy() request to retrieve a Route Policy. + * A fingerprint for the Route Policy being applied to this Router, which is + * essentially a hash of the Route Policy used for optimistic locking. + * The fingerprint is initially generated by Compute Engine and changes + * after every request to modify or update Route Policy. You must always + * provide an up-to-date fingerprint hash in order to update or change + * labels. + * To see the latest fingerprint, make a getRoutePolicy() request + * to retrieve a Route Policy. * * Generated from protobuf field optional string fingerprint = 234678500; */ protected $fingerprint = null; /** - * Route Policy name, which must be a resource ID segment and unique within all the router's Route Policies. Name should conform to RFC1035. + * Route Policy name, which must be a resource ID segment and unique + * within all the router's Route Policies. Name should conform to RFC1035. * * Generated from protobuf field optional string name = 3373707; */ protected $name = null; /** - * List of terms (the order in the list is not important, they are evaluated in order of priority). Order of policies is not retained and might change when getting policy later. + * List of terms (the order in the list is not important, they are evaluated + * in order of priority). Order of policies is not retained and might change + * when getting policy later. * * Generated from protobuf field repeated .google.cloud.compute.v1.RoutePolicyPolicyTerm terms = 110250375; */ @@ -55,11 +65,21 @@ class RoutePolicy extends \Google\Protobuf\Internal\Message * @type string $description * An optional description of route policy. * @type string $fingerprint - * A fingerprint for the Route Policy being applied to this Router, which is essentially a hash of the Route Policy used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update Route Policy. You must always provide an up-to-date fingerprint hash in order to update or change labels. To see the latest fingerprint, make a getRoutePolicy() request to retrieve a Route Policy. + * A fingerprint for the Route Policy being applied to this Router, which is + * essentially a hash of the Route Policy used for optimistic locking. + * The fingerprint is initially generated by Compute Engine and changes + * after every request to modify or update Route Policy. You must always + * provide an up-to-date fingerprint hash in order to update or change + * labels. + * To see the latest fingerprint, make a getRoutePolicy() request + * to retrieve a Route Policy. * @type string $name - * Route Policy name, which must be a resource ID segment and unique within all the router's Route Policies. Name should conform to RFC1035. + * Route Policy name, which must be a resource ID segment and unique + * within all the router's Route Policies. Name should conform to RFC1035. * @type array<\Google\Cloud\Compute\V1\RoutePolicyPolicyTerm>|\Google\Protobuf\Internal\RepeatedField $terms - * List of terms (the order in the list is not important, they are evaluated in order of priority). Order of policies is not retained and might change when getting policy later. + * List of terms (the order in the list is not important, they are evaluated + * in order of priority). Order of policies is not retained and might change + * when getting policy later. * @type string $type * * Check the Type enum for the list of possible values. @@ -107,7 +127,14 @@ public function setDescription($var) } /** - * A fingerprint for the Route Policy being applied to this Router, which is essentially a hash of the Route Policy used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update Route Policy. You must always provide an up-to-date fingerprint hash in order to update or change labels. To see the latest fingerprint, make a getRoutePolicy() request to retrieve a Route Policy. + * A fingerprint for the Route Policy being applied to this Router, which is + * essentially a hash of the Route Policy used for optimistic locking. + * The fingerprint is initially generated by Compute Engine and changes + * after every request to modify or update Route Policy. You must always + * provide an up-to-date fingerprint hash in order to update or change + * labels. + * To see the latest fingerprint, make a getRoutePolicy() request + * to retrieve a Route Policy. * * Generated from protobuf field optional string fingerprint = 234678500; * @return string @@ -128,7 +155,14 @@ public function clearFingerprint() } /** - * A fingerprint for the Route Policy being applied to this Router, which is essentially a hash of the Route Policy used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update Route Policy. You must always provide an up-to-date fingerprint hash in order to update or change labels. To see the latest fingerprint, make a getRoutePolicy() request to retrieve a Route Policy. + * A fingerprint for the Route Policy being applied to this Router, which is + * essentially a hash of the Route Policy used for optimistic locking. + * The fingerprint is initially generated by Compute Engine and changes + * after every request to modify or update Route Policy. You must always + * provide an up-to-date fingerprint hash in order to update or change + * labels. + * To see the latest fingerprint, make a getRoutePolicy() request + * to retrieve a Route Policy. * * Generated from protobuf field optional string fingerprint = 234678500; * @param string $var @@ -143,7 +177,8 @@ public function setFingerprint($var) } /** - * Route Policy name, which must be a resource ID segment and unique within all the router's Route Policies. Name should conform to RFC1035. + * Route Policy name, which must be a resource ID segment and unique + * within all the router's Route Policies. Name should conform to RFC1035. * * Generated from protobuf field optional string name = 3373707; * @return string @@ -164,7 +199,8 @@ public function clearName() } /** - * Route Policy name, which must be a resource ID segment and unique within all the router's Route Policies. Name should conform to RFC1035. + * Route Policy name, which must be a resource ID segment and unique + * within all the router's Route Policies. Name should conform to RFC1035. * * Generated from protobuf field optional string name = 3373707; * @param string $var @@ -179,7 +215,9 @@ public function setName($var) } /** - * List of terms (the order in the list is not important, they are evaluated in order of priority). Order of policies is not retained and might change when getting policy later. + * List of terms (the order in the list is not important, they are evaluated + * in order of priority). Order of policies is not retained and might change + * when getting policy later. * * Generated from protobuf field repeated .google.cloud.compute.v1.RoutePolicyPolicyTerm terms = 110250375; * @return \Google\Protobuf\Internal\RepeatedField @@ -190,7 +228,9 @@ public function getTerms() } /** - * List of terms (the order in the list is not important, they are evaluated in order of priority). Order of policies is not retained and might change when getting policy later. + * List of terms (the order in the list is not important, they are evaluated + * in order of priority). Order of policies is not retained and might change + * when getting policy later. * * Generated from protobuf field repeated .google.cloud.compute.v1.RoutePolicyPolicyTerm terms = 110250375; * @param array<\Google\Cloud\Compute\V1\RoutePolicyPolicyTerm>|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/RoutePolicyPolicyTerm.php b/Compute/src/V1/RoutePolicyPolicyTerm.php index 8bc33752c184..b0ee9139e467 100644 --- a/Compute/src/V1/RoutePolicyPolicyTerm.php +++ b/Compute/src/V1/RoutePolicyPolicyTerm.php @@ -21,13 +21,16 @@ class RoutePolicyPolicyTerm extends \Google\Protobuf\Internal\Message */ private $actions; /** - * CEL expression evaluated against a route to determine if this term applies. When not set, the term applies to all routes. + * CEL expression evaluated against a route to determine if this term + * applies. When not set, the term applies to all + * routes. * * Generated from protobuf field optional .google.cloud.compute.v1.Expr match = 103668165; */ protected $match = null; /** - * The evaluation priority for this term, which must be between 0 (inclusive) and 2^31 (exclusive), and unique within the list. + * The evaluation priority for this term, which must be between 0 + * (inclusive) and 2^31 (exclusive), and unique within the list. * * Generated from protobuf field optional int32 priority = 445151652; */ @@ -42,9 +45,12 @@ class RoutePolicyPolicyTerm extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\Expr>|\Google\Protobuf\Internal\RepeatedField $actions * CEL expressions to evaluate to modify a route when this term matches. * @type \Google\Cloud\Compute\V1\Expr $match - * CEL expression evaluated against a route to determine if this term applies. When not set, the term applies to all routes. + * CEL expression evaluated against a route to determine if this term + * applies. When not set, the term applies to all + * routes. * @type int $priority - * The evaluation priority for this term, which must be between 0 (inclusive) and 2^31 (exclusive), and unique within the list. + * The evaluation priority for this term, which must be between 0 + * (inclusive) and 2^31 (exclusive), and unique within the list. * } */ public function __construct($data = NULL) { @@ -79,7 +85,9 @@ public function setActions($var) } /** - * CEL expression evaluated against a route to determine if this term applies. When not set, the term applies to all routes. + * CEL expression evaluated against a route to determine if this term + * applies. When not set, the term applies to all + * routes. * * Generated from protobuf field optional .google.cloud.compute.v1.Expr match = 103668165; * @return \Google\Cloud\Compute\V1\Expr|null @@ -100,7 +108,9 @@ public function clearMatch() } /** - * CEL expression evaluated against a route to determine if this term applies. When not set, the term applies to all routes. + * CEL expression evaluated against a route to determine if this term + * applies. When not set, the term applies to all + * routes. * * Generated from protobuf field optional .google.cloud.compute.v1.Expr match = 103668165; * @param \Google\Cloud\Compute\V1\Expr $var @@ -115,7 +125,8 @@ public function setMatch($var) } /** - * The evaluation priority for this term, which must be between 0 (inclusive) and 2^31 (exclusive), and unique within the list. + * The evaluation priority for this term, which must be between 0 + * (inclusive) and 2^31 (exclusive), and unique within the list. * * Generated from protobuf field optional int32 priority = 445151652; * @return int @@ -136,7 +147,8 @@ public function clearPriority() } /** - * The evaluation priority for this term, which must be between 0 (inclusive) and 2^31 (exclusive), and unique within the list. + * The evaluation priority for this term, which must be between 0 + * (inclusive) and 2^31 (exclusive), and unique within the list. * * Generated from protobuf field optional int32 priority = 445151652; * @param int $var diff --git a/Compute/src/V1/Router.php b/Compute/src/V1/Router.php index 08ed6e686324..655eac867be8 100644 --- a/Compute/src/V1/Router.php +++ b/Compute/src/V1/Router.php @@ -9,7 +9,9 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Represents a Cloud Router resource. For more information about Cloud Router, read the Cloud Router overview. + * Represents a Cloud Router resource. + * For more information about Cloud Router, read theCloud + * Router overview. * * Generated from protobuf message google.cloud.compute.v1.Router */ @@ -22,43 +24,57 @@ class Router extends \Google\Protobuf\Internal\Message */ protected $bgp = null; /** - * BGP information that must be configured into the routing stack to establish BGP peering. This information must specify the peer ASN and either the interface name, IP address, or peer IP address. Please refer to RFC4273. + * BGP information that must be configured into the routing stack to + * establish BGP peering. This information must specify the peer ASN and + * either the interface name, IP address, or peer IP address. Please refer toRFC4273. * * Generated from protobuf field repeated .google.cloud.compute.v1.RouterBgpPeer bgp_peers = 452695773; */ private $bgp_peers; /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; */ protected $creation_timestamp = null; /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; */ protected $description = null; /** - * Indicates if a router is dedicated for use with encrypted VLAN attachments (interconnectAttachments). + * Indicates if a router is dedicated for use with encrypted VLAN + * attachments (interconnectAttachments). * * Generated from protobuf field optional bool encrypted_interconnect_router = 297996575; */ protected $encrypted_interconnect_router = null; /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; */ protected $id = null; /** - * Router interfaces. To create a BGP peer that uses a router interface, the interface must have one of the following fields specified: - linkedVpnTunnel - linkedInterconnectAttachment - subnetwork You can create a router interface without any of these fields specified. However, you cannot create a BGP peer that uses that interface. + * Router interfaces. + * To create a BGP peer that uses a router interface, + * the interface must have one of the following fields specified: + * - linkedVpnTunnel + * - linkedInterconnectAttachment + * - subnetwork + * You can create a router interface without any of these fields specified. + * However, you cannot create a BGP peer that uses that interface. * * Generated from protobuf field repeated .google.cloud.compute.v1.RouterInterface interfaces = 12073562; */ private $interfaces; /** - * [Output Only] Type of resource. Always compute#router for routers. + * [Output Only] Type of resource. Always compute#router for + * routers. * * Generated from protobuf field optional string kind = 3292052; */ @@ -70,7 +86,13 @@ class Router extends \Google\Protobuf\Internal\Message */ private $md5_authentication_keys; /** - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * * Generated from protobuf field optional string name = 3373707; */ @@ -88,13 +110,16 @@ class Router extends \Google\Protobuf\Internal\Message */ protected $network = null; /** - * Input only. [Input Only] Additional params passed with the request, but not persisted as part of resource payload. + * Input only. [Input Only] Additional params passed with the request, but not persisted + * as part of resource payload. * * Generated from protobuf field optional .google.cloud.compute.v1.RouterParams params = 78313862; */ protected $params = null; /** - * [Output Only] URI of the region where the router resides. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * [Output Only] URI of the region where the router resides. + * You must specify this field as part of the HTTP request URL. It is + * not settable as a field in the request body. * * Generated from protobuf field optional string region = 138946292; */ @@ -115,31 +140,54 @@ class Router extends \Google\Protobuf\Internal\Message * @type \Google\Cloud\Compute\V1\RouterBgp $bgp * BGP information specific to this router. * @type array<\Google\Cloud\Compute\V1\RouterBgpPeer>|\Google\Protobuf\Internal\RepeatedField $bgp_peers - * BGP information that must be configured into the routing stack to establish BGP peering. This information must specify the peer ASN and either the interface name, IP address, or peer IP address. Please refer to RFC4273. + * BGP information that must be configured into the routing stack to + * establish BGP peering. This information must specify the peer ASN and + * either the interface name, IP address, or peer IP address. Please refer toRFC4273. * @type string $creation_timestamp - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * @type string $description - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * @type bool $encrypted_interconnect_router - * Indicates if a router is dedicated for use with encrypted VLAN attachments (interconnectAttachments). + * Indicates if a router is dedicated for use with encrypted VLAN + * attachments (interconnectAttachments). * @type int|string $id - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * @type array<\Google\Cloud\Compute\V1\RouterInterface>|\Google\Protobuf\Internal\RepeatedField $interfaces - * Router interfaces. To create a BGP peer that uses a router interface, the interface must have one of the following fields specified: - linkedVpnTunnel - linkedInterconnectAttachment - subnetwork You can create a router interface without any of these fields specified. However, you cannot create a BGP peer that uses that interface. + * Router interfaces. + * To create a BGP peer that uses a router interface, + * the interface must have one of the following fields specified: + * - linkedVpnTunnel + * - linkedInterconnectAttachment + * - subnetwork + * You can create a router interface without any of these fields specified. + * However, you cannot create a BGP peer that uses that interface. * @type string $kind - * [Output Only] Type of resource. Always compute#router for routers. + * [Output Only] Type of resource. Always compute#router for + * routers. * @type array<\Google\Cloud\Compute\V1\RouterMd5AuthenticationKey>|\Google\Protobuf\Internal\RepeatedField $md5_authentication_keys * Keys used for MD5 authentication. * @type string $name - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * @type array<\Google\Cloud\Compute\V1\RouterNat>|\Google\Protobuf\Internal\RepeatedField $nats * A list of NAT services created in this router. * @type string $network * URI of the network to which this router belongs. * @type \Google\Cloud\Compute\V1\RouterParams $params - * Input only. [Input Only] Additional params passed with the request, but not persisted as part of resource payload. + * Input only. [Input Only] Additional params passed with the request, but not persisted + * as part of resource payload. * @type string $region - * [Output Only] URI of the region where the router resides. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * [Output Only] URI of the region where the router resides. + * You must specify this field as part of the HTTP request URL. It is + * not settable as a field in the request body. * @type string $self_link * [Output Only] Server-defined URL for the resource. * } @@ -186,7 +234,9 @@ public function setBgp($var) } /** - * BGP information that must be configured into the routing stack to establish BGP peering. This information must specify the peer ASN and either the interface name, IP address, or peer IP address. Please refer to RFC4273. + * BGP information that must be configured into the routing stack to + * establish BGP peering. This information must specify the peer ASN and + * either the interface name, IP address, or peer IP address. Please refer toRFC4273. * * Generated from protobuf field repeated .google.cloud.compute.v1.RouterBgpPeer bgp_peers = 452695773; * @return \Google\Protobuf\Internal\RepeatedField @@ -197,7 +247,9 @@ public function getBgpPeers() } /** - * BGP information that must be configured into the routing stack to establish BGP peering. This information must specify the peer ASN and either the interface name, IP address, or peer IP address. Please refer to RFC4273. + * BGP information that must be configured into the routing stack to + * establish BGP peering. This information must specify the peer ASN and + * either the interface name, IP address, or peer IP address. Please refer toRFC4273. * * Generated from protobuf field repeated .google.cloud.compute.v1.RouterBgpPeer bgp_peers = 452695773; * @param array<\Google\Cloud\Compute\V1\RouterBgpPeer>|\Google\Protobuf\Internal\RepeatedField $var @@ -212,7 +264,8 @@ public function setBgpPeers($var) } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @return string @@ -233,7 +286,8 @@ public function clearCreationTimestamp() } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @param string $var @@ -248,7 +302,8 @@ public function setCreationTimestamp($var) } /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @return string @@ -269,7 +324,8 @@ public function clearDescription() } /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @param string $var @@ -284,7 +340,8 @@ public function setDescription($var) } /** - * Indicates if a router is dedicated for use with encrypted VLAN attachments (interconnectAttachments). + * Indicates if a router is dedicated for use with encrypted VLAN + * attachments (interconnectAttachments). * * Generated from protobuf field optional bool encrypted_interconnect_router = 297996575; * @return bool @@ -305,7 +362,8 @@ public function clearEncryptedInterconnectRouter() } /** - * Indicates if a router is dedicated for use with encrypted VLAN attachments (interconnectAttachments). + * Indicates if a router is dedicated for use with encrypted VLAN + * attachments (interconnectAttachments). * * Generated from protobuf field optional bool encrypted_interconnect_router = 297996575; * @param bool $var @@ -320,7 +378,8 @@ public function setEncryptedInterconnectRouter($var) } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @return int|string @@ -341,7 +400,8 @@ public function clearId() } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @param int|string $var @@ -356,7 +416,14 @@ public function setId($var) } /** - * Router interfaces. To create a BGP peer that uses a router interface, the interface must have one of the following fields specified: - linkedVpnTunnel - linkedInterconnectAttachment - subnetwork You can create a router interface without any of these fields specified. However, you cannot create a BGP peer that uses that interface. + * Router interfaces. + * To create a BGP peer that uses a router interface, + * the interface must have one of the following fields specified: + * - linkedVpnTunnel + * - linkedInterconnectAttachment + * - subnetwork + * You can create a router interface without any of these fields specified. + * However, you cannot create a BGP peer that uses that interface. * * Generated from protobuf field repeated .google.cloud.compute.v1.RouterInterface interfaces = 12073562; * @return \Google\Protobuf\Internal\RepeatedField @@ -367,7 +434,14 @@ public function getInterfaces() } /** - * Router interfaces. To create a BGP peer that uses a router interface, the interface must have one of the following fields specified: - linkedVpnTunnel - linkedInterconnectAttachment - subnetwork You can create a router interface without any of these fields specified. However, you cannot create a BGP peer that uses that interface. + * Router interfaces. + * To create a BGP peer that uses a router interface, + * the interface must have one of the following fields specified: + * - linkedVpnTunnel + * - linkedInterconnectAttachment + * - subnetwork + * You can create a router interface without any of these fields specified. + * However, you cannot create a BGP peer that uses that interface. * * Generated from protobuf field repeated .google.cloud.compute.v1.RouterInterface interfaces = 12073562; * @param array<\Google\Cloud\Compute\V1\RouterInterface>|\Google\Protobuf\Internal\RepeatedField $var @@ -382,7 +456,8 @@ public function setInterfaces($var) } /** - * [Output Only] Type of resource. Always compute#router for routers. + * [Output Only] Type of resource. Always compute#router for + * routers. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -403,7 +478,8 @@ public function clearKind() } /** - * [Output Only] Type of resource. Always compute#router for routers. + * [Output Only] Type of resource. Always compute#router for + * routers. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -444,7 +520,13 @@ public function setMd5AuthenticationKeys($var) } /** - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * * Generated from protobuf field optional string name = 3373707; * @return string @@ -465,7 +547,13 @@ public function clearName() } /** - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * * Generated from protobuf field optional string name = 3373707; * @param string $var @@ -542,7 +630,8 @@ public function setNetwork($var) } /** - * Input only. [Input Only] Additional params passed with the request, but not persisted as part of resource payload. + * Input only. [Input Only] Additional params passed with the request, but not persisted + * as part of resource payload. * * Generated from protobuf field optional .google.cloud.compute.v1.RouterParams params = 78313862; * @return \Google\Cloud\Compute\V1\RouterParams|null @@ -563,7 +652,8 @@ public function clearParams() } /** - * Input only. [Input Only] Additional params passed with the request, but not persisted as part of resource payload. + * Input only. [Input Only] Additional params passed with the request, but not persisted + * as part of resource payload. * * Generated from protobuf field optional .google.cloud.compute.v1.RouterParams params = 78313862; * @param \Google\Cloud\Compute\V1\RouterParams $var @@ -578,7 +668,9 @@ public function setParams($var) } /** - * [Output Only] URI of the region where the router resides. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * [Output Only] URI of the region where the router resides. + * You must specify this field as part of the HTTP request URL. It is + * not settable as a field in the request body. * * Generated from protobuf field optional string region = 138946292; * @return string @@ -599,7 +691,9 @@ public function clearRegion() } /** - * [Output Only] URI of the region where the router resides. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * [Output Only] URI of the region where the router resides. + * You must specify this field as part of the HTTP request URL. It is + * not settable as a field in the request body. * * Generated from protobuf field optional string region = 138946292; * @param string $var diff --git a/Compute/src/V1/RouterAggregatedList.php b/Compute/src/V1/RouterAggregatedList.php index 172d4c1f8b53..c76187ec9a6e 100644 --- a/Compute/src/V1/RouterAggregatedList.php +++ b/Compute/src/V1/RouterAggregatedList.php @@ -34,7 +34,11 @@ class RouterAggregatedList extends \Google\Protobuf\Internal\Message */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -71,7 +75,11 @@ class RouterAggregatedList extends \Google\Protobuf\Internal\Message * @type string $kind * Type of resource. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type array|\Google\Protobuf\Internal\RepeatedField $unreachables @@ -184,7 +192,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -205,7 +217,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/RouterBgp.php b/Compute/src/V1/RouterBgp.php index d1a2b0fdce2f..e97f84021ced 100644 --- a/Compute/src/V1/RouterBgp.php +++ b/Compute/src/V1/RouterBgp.php @@ -15,39 +15,64 @@ class RouterBgp extends \Google\Protobuf\Internal\Message { /** - * User-specified flag to indicate which mode to use for advertisement. The options are DEFAULT or CUSTOM. + * User-specified flag to indicate which mode to use for advertisement. + * The options are DEFAULT or CUSTOM. * Check the AdvertiseMode enum for the list of possible values. * * Generated from protobuf field optional string advertise_mode = 312134331; */ protected $advertise_mode = null; /** - * User-specified list of prefix groups to advertise in custom mode. This field can only be populated if advertise_mode is CUSTOM and is advertised to all peers of the router. These groups will be advertised in addition to any specified prefixes. Leave this field blank to advertise no custom groups. + * User-specified list of prefix groups to advertise in custom mode. + * This field can only be populated if advertise_mode is CUSTOM and + * is advertised to all peers of the router. + * These groups will be advertised in addition to any specified prefixes. + * Leave this field blank to advertise no custom groups. * Check the AdvertisedGroups enum for the list of possible values. * * Generated from protobuf field repeated string advertised_groups = 21065526; */ private $advertised_groups; /** - * User-specified list of individual IP ranges to advertise in custom mode. This field can only be populated if advertise_mode is CUSTOM and is advertised to all peers of the router. These IP ranges will be advertised in addition to any specified groups. Leave this field blank to advertise no custom IP ranges. + * User-specified list of individual IP ranges to advertise in custom mode. + * This field can only be populated if advertise_mode is CUSTOM and + * is advertised to all peers of the router. + * These IP ranges will be advertised in addition to any specified groups. + * Leave this field blank to advertise no custom IP ranges. * * Generated from protobuf field repeated .google.cloud.compute.v1.RouterAdvertisedIpRange advertised_ip_ranges = 35449932; */ private $advertised_ip_ranges; /** - * Local BGP Autonomous System Number (ASN). Must be an RFC6996 private ASN, either 16-bit or 32-bit. The value will be fixed for this router resource. All VPN tunnels that link to this router will have the same local ASN. + * Local BGP Autonomous System Number (ASN). + * Must be anRFC6996 private ASN, either 16-bit or 32-bit. The + * value will be fixed for this router resource. All VPN tunnels that link + * to this router will have the same local ASN. * * Generated from protobuf field optional uint32 asn = 96892; */ protected $asn = null; /** - * Explicitly specifies a range of valid BGP Identifiers for this Router. It is provided as a link-local IPv4 range (from 169.254.0.0/16), of size at least /30, even if the BGP sessions are over IPv6. It must not overlap with any IPv4 BGP session ranges. Other vendors commonly call this "router ID". + * Explicitly specifies a range of valid BGP Identifiers for this Router. It + * is provided as a link-local IPv4 range (from 169.254.0.0/16), of size at + * least /30, even if the BGP sessions are over IPv6. It must not overlap + * with any IPv4 BGP session ranges. + * Other vendors commonly call this "router ID". * * Generated from protobuf field optional string identifier_range = 501573159; */ protected $identifier_range = null; /** - * The interval in seconds between BGP keepalive messages that are sent to the peer. Hold time is three times the interval at which keepalive messages are sent, and the hold time is the maximum number of seconds allowed to elapse between successive keepalive messages that BGP receives from a peer. BGP will use the smaller of either the local hold time value or the peer's hold time value as the hold time for the BGP connection between the two peers. If set, this value must be between 20 and 60. The default is 20. + * The interval in seconds between BGP keepalive messages that are + * sent to the peer. + * Hold time is three times the interval at which keepalive messages are + * sent, and the hold time is the maximum number of seconds allowed to + * elapse between successive keepalive messages that BGP receives from a + * peer. + * BGP will use the smaller of either the local hold time value or the + * peer's hold time value as the hold time for the BGP connection between + * the two peers. + * If set, this value must be between 20 and 60. The default is 20. * * Generated from protobuf field optional uint32 keepalive_interval = 276771516; */ @@ -60,19 +85,44 @@ class RouterBgp extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $advertise_mode - * User-specified flag to indicate which mode to use for advertisement. The options are DEFAULT or CUSTOM. + * User-specified flag to indicate which mode to use for advertisement. + * The options are DEFAULT or CUSTOM. * Check the AdvertiseMode enum for the list of possible values. * @type array|\Google\Protobuf\Internal\RepeatedField $advertised_groups - * User-specified list of prefix groups to advertise in custom mode. This field can only be populated if advertise_mode is CUSTOM and is advertised to all peers of the router. These groups will be advertised in addition to any specified prefixes. Leave this field blank to advertise no custom groups. + * User-specified list of prefix groups to advertise in custom mode. + * This field can only be populated if advertise_mode is CUSTOM and + * is advertised to all peers of the router. + * These groups will be advertised in addition to any specified prefixes. + * Leave this field blank to advertise no custom groups. * Check the AdvertisedGroups enum for the list of possible values. * @type array<\Google\Cloud\Compute\V1\RouterAdvertisedIpRange>|\Google\Protobuf\Internal\RepeatedField $advertised_ip_ranges - * User-specified list of individual IP ranges to advertise in custom mode. This field can only be populated if advertise_mode is CUSTOM and is advertised to all peers of the router. These IP ranges will be advertised in addition to any specified groups. Leave this field blank to advertise no custom IP ranges. + * User-specified list of individual IP ranges to advertise in custom mode. + * This field can only be populated if advertise_mode is CUSTOM and + * is advertised to all peers of the router. + * These IP ranges will be advertised in addition to any specified groups. + * Leave this field blank to advertise no custom IP ranges. * @type int $asn - * Local BGP Autonomous System Number (ASN). Must be an RFC6996 private ASN, either 16-bit or 32-bit. The value will be fixed for this router resource. All VPN tunnels that link to this router will have the same local ASN. + * Local BGP Autonomous System Number (ASN). + * Must be anRFC6996 private ASN, either 16-bit or 32-bit. The + * value will be fixed for this router resource. All VPN tunnels that link + * to this router will have the same local ASN. * @type string $identifier_range - * Explicitly specifies a range of valid BGP Identifiers for this Router. It is provided as a link-local IPv4 range (from 169.254.0.0/16), of size at least /30, even if the BGP sessions are over IPv6. It must not overlap with any IPv4 BGP session ranges. Other vendors commonly call this "router ID". + * Explicitly specifies a range of valid BGP Identifiers for this Router. It + * is provided as a link-local IPv4 range (from 169.254.0.0/16), of size at + * least /30, even if the BGP sessions are over IPv6. It must not overlap + * with any IPv4 BGP session ranges. + * Other vendors commonly call this "router ID". * @type int $keepalive_interval - * The interval in seconds between BGP keepalive messages that are sent to the peer. Hold time is three times the interval at which keepalive messages are sent, and the hold time is the maximum number of seconds allowed to elapse between successive keepalive messages that BGP receives from a peer. BGP will use the smaller of either the local hold time value or the peer's hold time value as the hold time for the BGP connection between the two peers. If set, this value must be between 20 and 60. The default is 20. + * The interval in seconds between BGP keepalive messages that are + * sent to the peer. + * Hold time is three times the interval at which keepalive messages are + * sent, and the hold time is the maximum number of seconds allowed to + * elapse between successive keepalive messages that BGP receives from a + * peer. + * BGP will use the smaller of either the local hold time value or the + * peer's hold time value as the hold time for the BGP connection between + * the two peers. + * If set, this value must be between 20 and 60. The default is 20. * } */ public function __construct($data = NULL) { @@ -81,7 +131,8 @@ public function __construct($data = NULL) { } /** - * User-specified flag to indicate which mode to use for advertisement. The options are DEFAULT or CUSTOM. + * User-specified flag to indicate which mode to use for advertisement. + * The options are DEFAULT or CUSTOM. * Check the AdvertiseMode enum for the list of possible values. * * Generated from protobuf field optional string advertise_mode = 312134331; @@ -103,7 +154,8 @@ public function clearAdvertiseMode() } /** - * User-specified flag to indicate which mode to use for advertisement. The options are DEFAULT or CUSTOM. + * User-specified flag to indicate which mode to use for advertisement. + * The options are DEFAULT or CUSTOM. * Check the AdvertiseMode enum for the list of possible values. * * Generated from protobuf field optional string advertise_mode = 312134331; @@ -119,7 +171,11 @@ public function setAdvertiseMode($var) } /** - * User-specified list of prefix groups to advertise in custom mode. This field can only be populated if advertise_mode is CUSTOM and is advertised to all peers of the router. These groups will be advertised in addition to any specified prefixes. Leave this field blank to advertise no custom groups. + * User-specified list of prefix groups to advertise in custom mode. + * This field can only be populated if advertise_mode is CUSTOM and + * is advertised to all peers of the router. + * These groups will be advertised in addition to any specified prefixes. + * Leave this field blank to advertise no custom groups. * Check the AdvertisedGroups enum for the list of possible values. * * Generated from protobuf field repeated string advertised_groups = 21065526; @@ -131,7 +187,11 @@ public function getAdvertisedGroups() } /** - * User-specified list of prefix groups to advertise in custom mode. This field can only be populated if advertise_mode is CUSTOM and is advertised to all peers of the router. These groups will be advertised in addition to any specified prefixes. Leave this field blank to advertise no custom groups. + * User-specified list of prefix groups to advertise in custom mode. + * This field can only be populated if advertise_mode is CUSTOM and + * is advertised to all peers of the router. + * These groups will be advertised in addition to any specified prefixes. + * Leave this field blank to advertise no custom groups. * Check the AdvertisedGroups enum for the list of possible values. * * Generated from protobuf field repeated string advertised_groups = 21065526; @@ -147,7 +207,11 @@ public function setAdvertisedGroups($var) } /** - * User-specified list of individual IP ranges to advertise in custom mode. This field can only be populated if advertise_mode is CUSTOM and is advertised to all peers of the router. These IP ranges will be advertised in addition to any specified groups. Leave this field blank to advertise no custom IP ranges. + * User-specified list of individual IP ranges to advertise in custom mode. + * This field can only be populated if advertise_mode is CUSTOM and + * is advertised to all peers of the router. + * These IP ranges will be advertised in addition to any specified groups. + * Leave this field blank to advertise no custom IP ranges. * * Generated from protobuf field repeated .google.cloud.compute.v1.RouterAdvertisedIpRange advertised_ip_ranges = 35449932; * @return \Google\Protobuf\Internal\RepeatedField @@ -158,7 +222,11 @@ public function getAdvertisedIpRanges() } /** - * User-specified list of individual IP ranges to advertise in custom mode. This field can only be populated if advertise_mode is CUSTOM and is advertised to all peers of the router. These IP ranges will be advertised in addition to any specified groups. Leave this field blank to advertise no custom IP ranges. + * User-specified list of individual IP ranges to advertise in custom mode. + * This field can only be populated if advertise_mode is CUSTOM and + * is advertised to all peers of the router. + * These IP ranges will be advertised in addition to any specified groups. + * Leave this field blank to advertise no custom IP ranges. * * Generated from protobuf field repeated .google.cloud.compute.v1.RouterAdvertisedIpRange advertised_ip_ranges = 35449932; * @param array<\Google\Cloud\Compute\V1\RouterAdvertisedIpRange>|\Google\Protobuf\Internal\RepeatedField $var @@ -173,7 +241,10 @@ public function setAdvertisedIpRanges($var) } /** - * Local BGP Autonomous System Number (ASN). Must be an RFC6996 private ASN, either 16-bit or 32-bit. The value will be fixed for this router resource. All VPN tunnels that link to this router will have the same local ASN. + * Local BGP Autonomous System Number (ASN). + * Must be anRFC6996 private ASN, either 16-bit or 32-bit. The + * value will be fixed for this router resource. All VPN tunnels that link + * to this router will have the same local ASN. * * Generated from protobuf field optional uint32 asn = 96892; * @return int @@ -194,7 +265,10 @@ public function clearAsn() } /** - * Local BGP Autonomous System Number (ASN). Must be an RFC6996 private ASN, either 16-bit or 32-bit. The value will be fixed for this router resource. All VPN tunnels that link to this router will have the same local ASN. + * Local BGP Autonomous System Number (ASN). + * Must be anRFC6996 private ASN, either 16-bit or 32-bit. The + * value will be fixed for this router resource. All VPN tunnels that link + * to this router will have the same local ASN. * * Generated from protobuf field optional uint32 asn = 96892; * @param int $var @@ -209,7 +283,11 @@ public function setAsn($var) } /** - * Explicitly specifies a range of valid BGP Identifiers for this Router. It is provided as a link-local IPv4 range (from 169.254.0.0/16), of size at least /30, even if the BGP sessions are over IPv6. It must not overlap with any IPv4 BGP session ranges. Other vendors commonly call this "router ID". + * Explicitly specifies a range of valid BGP Identifiers for this Router. It + * is provided as a link-local IPv4 range (from 169.254.0.0/16), of size at + * least /30, even if the BGP sessions are over IPv6. It must not overlap + * with any IPv4 BGP session ranges. + * Other vendors commonly call this "router ID". * * Generated from protobuf field optional string identifier_range = 501573159; * @return string @@ -230,7 +308,11 @@ public function clearIdentifierRange() } /** - * Explicitly specifies a range of valid BGP Identifiers for this Router. It is provided as a link-local IPv4 range (from 169.254.0.0/16), of size at least /30, even if the BGP sessions are over IPv6. It must not overlap with any IPv4 BGP session ranges. Other vendors commonly call this "router ID". + * Explicitly specifies a range of valid BGP Identifiers for this Router. It + * is provided as a link-local IPv4 range (from 169.254.0.0/16), of size at + * least /30, even if the BGP sessions are over IPv6. It must not overlap + * with any IPv4 BGP session ranges. + * Other vendors commonly call this "router ID". * * Generated from protobuf field optional string identifier_range = 501573159; * @param string $var @@ -245,7 +327,16 @@ public function setIdentifierRange($var) } /** - * The interval in seconds between BGP keepalive messages that are sent to the peer. Hold time is three times the interval at which keepalive messages are sent, and the hold time is the maximum number of seconds allowed to elapse between successive keepalive messages that BGP receives from a peer. BGP will use the smaller of either the local hold time value or the peer's hold time value as the hold time for the BGP connection between the two peers. If set, this value must be between 20 and 60. The default is 20. + * The interval in seconds between BGP keepalive messages that are + * sent to the peer. + * Hold time is three times the interval at which keepalive messages are + * sent, and the hold time is the maximum number of seconds allowed to + * elapse between successive keepalive messages that BGP receives from a + * peer. + * BGP will use the smaller of either the local hold time value or the + * peer's hold time value as the hold time for the BGP connection between + * the two peers. + * If set, this value must be between 20 and 60. The default is 20. * * Generated from protobuf field optional uint32 keepalive_interval = 276771516; * @return int @@ -266,7 +357,16 @@ public function clearKeepaliveInterval() } /** - * The interval in seconds between BGP keepalive messages that are sent to the peer. Hold time is three times the interval at which keepalive messages are sent, and the hold time is the maximum number of seconds allowed to elapse between successive keepalive messages that BGP receives from a peer. BGP will use the smaller of either the local hold time value or the peer's hold time value as the hold time for the BGP connection between the two peers. If set, this value must be between 20 and 60. The default is 20. + * The interval in seconds between BGP keepalive messages that are + * sent to the peer. + * Hold time is three times the interval at which keepalive messages are + * sent, and the hold time is the maximum number of seconds allowed to + * elapse between successive keepalive messages that BGP receives from a + * peer. + * BGP will use the smaller of either the local hold time value or the + * peer's hold time value as the hold time for the BGP connection between + * the two peers. + * If set, this value must be between 20 and 60. The default is 20. * * Generated from protobuf field optional uint32 keepalive_interval = 276771516; * @param int $var diff --git a/Compute/src/V1/RouterBgp/AdvertiseMode.php b/Compute/src/V1/RouterBgp/AdvertiseMode.php index 2cd7664d77fa..b6ee8cf0260a 100644 --- a/Compute/src/V1/RouterBgp/AdvertiseMode.php +++ b/Compute/src/V1/RouterBgp/AdvertiseMode.php @@ -7,7 +7,8 @@ use UnexpectedValueException; /** - * User-specified flag to indicate which mode to use for advertisement. The options are DEFAULT or CUSTOM. + * User-specified flag to indicate which mode to use for advertisement. + * The options are DEFAULT or CUSTOM. * * Protobuf type google.cloud.compute.v1.RouterBgp.AdvertiseMode */ diff --git a/Compute/src/V1/RouterBgpPeer.php b/Compute/src/V1/RouterBgpPeer.php index 58f7412ea8b1..c35f0b0271f1 100644 --- a/Compute/src/V1/RouterBgpPeer.php +++ b/Compute/src/V1/RouterBgpPeer.php @@ -22,20 +22,34 @@ class RouterBgpPeer extends \Google\Protobuf\Internal\Message */ protected $advertise_mode = null; /** - * User-specified list of prefix groups to advertise in custom mode, which currently supports the following option: - ALL_SUBNETS: Advertises all of the router's own VPC subnets. This excludes any routes learned for subnets that use VPC Network Peering. Note that this field can only be populated if advertise_mode is CUSTOM and overrides the list defined for the router (in the "bgp" message). These groups are advertised in addition to any specified prefixes. Leave this field blank to advertise no custom groups. + * User-specified list of prefix groups to advertise in custom mode, + * which currently supports the following option: + * - ALL_SUBNETS: Advertises all of the router's own VPC subnets. This + * excludes any routes learned for subnets that use + * VPC Network Peering. + * Note that this field can only be populated if advertise_mode is CUSTOM + * and overrides the list defined for the router (in the "bgp" message). + * These groups are advertised in addition to any specified prefixes. + * Leave this field blank to advertise no custom groups. * Check the AdvertisedGroups enum for the list of possible values. * * Generated from protobuf field repeated string advertised_groups = 21065526; */ private $advertised_groups; /** - * User-specified list of individual IP ranges to advertise in custom mode. This field can only be populated if advertise_mode is CUSTOM and overrides the list defined for the router (in the "bgp" message). These IP ranges are advertised in addition to any specified groups. Leave this field blank to advertise no custom IP ranges. + * User-specified list of individual IP ranges to advertise in custom mode. + * This field can only be populated if advertise_mode is CUSTOM and + * overrides the list defined for the router (in the "bgp" message). + * These IP ranges are advertised in addition to any specified groups. + * Leave this field blank to advertise no custom IP ranges. * * Generated from protobuf field repeated .google.cloud.compute.v1.RouterAdvertisedIpRange advertised_ip_ranges = 35449932; */ private $advertised_ip_ranges; /** - * The priority of routes advertised to this BGP peer. Where there is more than one matching route of maximum length, the routes with the lowest priority value win. + * The priority of routes advertised to this BGP peer. Where there is more + * than one matching route of maximum length, the routes with the lowest + * priority value win. * * Generated from protobuf field optional uint32 advertised_route_priority = 186486332; */ @@ -47,44 +61,58 @@ class RouterBgpPeer extends \Google\Protobuf\Internal\Message */ protected $bfd = null; /** - * A list of user-defined custom learned route IP address ranges for a BGP session. + * A list of user-defined custom learned route IP address ranges for a BGP + * session. * * Generated from protobuf field repeated .google.cloud.compute.v1.RouterBgpPeerCustomLearnedIpRange custom_learned_ip_ranges = 481363012; */ private $custom_learned_ip_ranges; /** - * The user-defined custom learned route priority for a BGP session. This value is applied to all custom learned route ranges for the session. You can choose a value from `0` to `65335`. If you don't provide a value, Google Cloud assigns a priority of `100` to the ranges. + * The user-defined custom learned route priority for a BGP session. This + * value is applied to all custom learned route ranges for the session. + * You can choose a value from `0` to `65335`. If you don't provide a + * value, Google Cloud assigns a priority of `100` to the ranges. * * Generated from protobuf field optional int32 custom_learned_route_priority = 330412356; */ protected $custom_learned_route_priority = null; /** - * The status of the BGP peer connection. If set to FALSE, any active session with the peer is terminated and all associated routing information is removed. If set to TRUE, the peer connection can be established with routing information. The default is TRUE. + * The status of the BGP peer connection. + * If set to FALSE, any active session with the peer is terminated and + * all associated routing information is removed. If set to TRUE, the + * peer connection can be established with routing information. The default + * is TRUE. * Check the Enable enum for the list of possible values. * * Generated from protobuf field optional string enable = 311764355; */ protected $enable = null; /** - * Enable IPv4 traffic over BGP Peer. It is enabled by default if the peerIpAddress is version 4. + * Enable IPv4 traffic over BGP Peer. It is enabled by default if + * the peerIpAddress is version 4. * * Generated from protobuf field optional bool enable_ipv4 = 181467937; */ protected $enable_ipv4 = null; /** - * Enable IPv6 traffic over BGP Peer. It is enabled by default if the peerIpAddress is version 6. + * Enable IPv6 traffic over BGP Peer. It is enabled by default if the + * peerIpAddress is version 6. * * Generated from protobuf field optional bool enable_ipv6 = 181467939; */ protected $enable_ipv6 = null; /** - * List of export policies applied to this peer, in the order they must be evaluated. The name must correspond to an existing policy that has ROUTE_POLICY_TYPE_EXPORT type. + * List of export policies applied to this peer, in the order they must be + * evaluated. The name must correspond to an existing policy that has + * ROUTE_POLICY_TYPE_EXPORT type. * * Generated from protobuf field repeated string export_policies = 134084987; */ private $export_policies; /** - * List of import policies applied to this peer, in the order they must be evaluated. The name must correspond to an existing policy that has ROUTE_POLICY_TYPE_IMPORT type. + * List of import policies applied to this peer, in the order they must be + * evaluated. The name must correspond to an existing policy that has + * ROUTE_POLICY_TYPE_IMPORT type. * * Generated from protobuf field repeated string import_policies = 451147946; */ @@ -114,26 +142,41 @@ class RouterBgpPeer extends \Google\Protobuf\Internal\Message */ protected $ipv6_nexthop_address = null; /** - * [Output Only] The resource that configures and manages this BGP peer. - MANAGED_BY_USER is the default value and can be managed by you or other users - MANAGED_BY_ATTACHMENT is a BGP peer that is configured and managed by Cloud Interconnect, specifically by an InterconnectAttachment of type PARTNER. Google automatically creates, updates, and deletes this type of BGP peer when the PARTNER InterconnectAttachment is created, updated, or deleted. + * [Output Only] The resource that configures and manages this BGP peer. + * - MANAGED_BY_USER is the default value and can be managed by you + * or other users + * - MANAGED_BY_ATTACHMENT is a BGP peer that is configured and managed + * by Cloud Interconnect, specifically by an InterconnectAttachment of type + * PARTNER. Google automatically creates, updates, and deletes this type of + * BGP peer when the PARTNER InterconnectAttachment is created, updated, + * or deleted. * Check the ManagementType enum for the list of possible values. * * Generated from protobuf field optional string management_type = 173703606; */ protected $management_type = null; /** - * Present if MD5 authentication is enabled for the peering. Must be the name of one of the entries in the Router.md5_authentication_keys. The field must comply with RFC1035. + * Present if MD5 authentication is enabled for the peering. Must be the + * name of one of the entries in the Router.md5_authentication_keys. The + * field must comply with RFC1035. * * Generated from protobuf field optional string md5_authentication_key_name = 281075345; */ protected $md5_authentication_key_name = null; /** - * Name of this BGP peer. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of this BGP peer. + * The name must be 1-63 characters long, and comply withRFC1035. Specifically, the name must be 1-63 + * characters long and match the regular expression + * `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a + * lowercase letter, and all following characters must be a dash, lowercase + * letter, or digit, except the last character, which cannot be a dash. * * Generated from protobuf field optional string name = 3373707; */ protected $name = null; /** - * Peer BGP Autonomous System Number (ASN). Each BGP interface may use a different value. + * Peer BGP Autonomous System Number (ASN). Each BGP interface may use + * a different value. * * Generated from protobuf field optional uint32 peer_asn = 69573151; */ @@ -157,7 +200,11 @@ class RouterBgpPeer extends \Google\Protobuf\Internal\Message */ protected $peer_ipv6_nexthop_address = null; /** - * URI of the VM instance that is used as third-party router appliances such as Next Gen Firewalls, Virtual Routers, or Router Appliances. The VM instance must be located in zones contained in the same region as this Cloud Router. The VM instance is the peer side of the BGP session. + * URI of the VM instance that is used as third-party router + * appliances such as Next Gen Firewalls, Virtual Routers, or Router + * Appliances. The VM instance must be located in zones contained in the + * same region as this Cloud Router. + * The VM instance is the peer side of the BGP session. * * Generated from protobuf field optional string router_appliance_instance = 468312989; */ @@ -173,29 +220,57 @@ class RouterBgpPeer extends \Google\Protobuf\Internal\Message * User-specified flag to indicate which mode to use for advertisement. * Check the AdvertiseMode enum for the list of possible values. * @type array|\Google\Protobuf\Internal\RepeatedField $advertised_groups - * User-specified list of prefix groups to advertise in custom mode, which currently supports the following option: - ALL_SUBNETS: Advertises all of the router's own VPC subnets. This excludes any routes learned for subnets that use VPC Network Peering. Note that this field can only be populated if advertise_mode is CUSTOM and overrides the list defined for the router (in the "bgp" message). These groups are advertised in addition to any specified prefixes. Leave this field blank to advertise no custom groups. + * User-specified list of prefix groups to advertise in custom mode, + * which currently supports the following option: + * - ALL_SUBNETS: Advertises all of the router's own VPC subnets. This + * excludes any routes learned for subnets that use + * VPC Network Peering. + * Note that this field can only be populated if advertise_mode is CUSTOM + * and overrides the list defined for the router (in the "bgp" message). + * These groups are advertised in addition to any specified prefixes. + * Leave this field blank to advertise no custom groups. * Check the AdvertisedGroups enum for the list of possible values. * @type array<\Google\Cloud\Compute\V1\RouterAdvertisedIpRange>|\Google\Protobuf\Internal\RepeatedField $advertised_ip_ranges - * User-specified list of individual IP ranges to advertise in custom mode. This field can only be populated if advertise_mode is CUSTOM and overrides the list defined for the router (in the "bgp" message). These IP ranges are advertised in addition to any specified groups. Leave this field blank to advertise no custom IP ranges. + * User-specified list of individual IP ranges to advertise in custom mode. + * This field can only be populated if advertise_mode is CUSTOM and + * overrides the list defined for the router (in the "bgp" message). + * These IP ranges are advertised in addition to any specified groups. + * Leave this field blank to advertise no custom IP ranges. * @type int $advertised_route_priority - * The priority of routes advertised to this BGP peer. Where there is more than one matching route of maximum length, the routes with the lowest priority value win. + * The priority of routes advertised to this BGP peer. Where there is more + * than one matching route of maximum length, the routes with the lowest + * priority value win. * @type \Google\Cloud\Compute\V1\RouterBgpPeerBfd $bfd * BFD configuration for the BGP peering. * @type array<\Google\Cloud\Compute\V1\RouterBgpPeerCustomLearnedIpRange>|\Google\Protobuf\Internal\RepeatedField $custom_learned_ip_ranges - * A list of user-defined custom learned route IP address ranges for a BGP session. + * A list of user-defined custom learned route IP address ranges for a BGP + * session. * @type int $custom_learned_route_priority - * The user-defined custom learned route priority for a BGP session. This value is applied to all custom learned route ranges for the session. You can choose a value from `0` to `65335`. If you don't provide a value, Google Cloud assigns a priority of `100` to the ranges. + * The user-defined custom learned route priority for a BGP session. This + * value is applied to all custom learned route ranges for the session. + * You can choose a value from `0` to `65335`. If you don't provide a + * value, Google Cloud assigns a priority of `100` to the ranges. * @type string $enable - * The status of the BGP peer connection. If set to FALSE, any active session with the peer is terminated and all associated routing information is removed. If set to TRUE, the peer connection can be established with routing information. The default is TRUE. + * The status of the BGP peer connection. + * If set to FALSE, any active session with the peer is terminated and + * all associated routing information is removed. If set to TRUE, the + * peer connection can be established with routing information. The default + * is TRUE. * Check the Enable enum for the list of possible values. * @type bool $enable_ipv4 - * Enable IPv4 traffic over BGP Peer. It is enabled by default if the peerIpAddress is version 4. + * Enable IPv4 traffic over BGP Peer. It is enabled by default if + * the peerIpAddress is version 4. * @type bool $enable_ipv6 - * Enable IPv6 traffic over BGP Peer. It is enabled by default if the peerIpAddress is version 6. + * Enable IPv6 traffic over BGP Peer. It is enabled by default if the + * peerIpAddress is version 6. * @type array|\Google\Protobuf\Internal\RepeatedField $export_policies - * List of export policies applied to this peer, in the order they must be evaluated. The name must correspond to an existing policy that has ROUTE_POLICY_TYPE_EXPORT type. + * List of export policies applied to this peer, in the order they must be + * evaluated. The name must correspond to an existing policy that has + * ROUTE_POLICY_TYPE_EXPORT type. * @type array|\Google\Protobuf\Internal\RepeatedField $import_policies - * List of import policies applied to this peer, in the order they must be evaluated. The name must correspond to an existing policy that has ROUTE_POLICY_TYPE_IMPORT type. + * List of import policies applied to this peer, in the order they must be + * evaluated. The name must correspond to an existing policy that has + * ROUTE_POLICY_TYPE_IMPORT type. * @type string $interface_name * Name of the interface the BGP peer is associated with. * @type string $ip_address @@ -205,14 +280,29 @@ class RouterBgpPeer extends \Google\Protobuf\Internal\Message * @type string $ipv6_nexthop_address * IPv6 address of the interface inside Google Cloud Platform. * @type string $management_type - * [Output Only] The resource that configures and manages this BGP peer. - MANAGED_BY_USER is the default value and can be managed by you or other users - MANAGED_BY_ATTACHMENT is a BGP peer that is configured and managed by Cloud Interconnect, specifically by an InterconnectAttachment of type PARTNER. Google automatically creates, updates, and deletes this type of BGP peer when the PARTNER InterconnectAttachment is created, updated, or deleted. + * [Output Only] The resource that configures and manages this BGP peer. + * - MANAGED_BY_USER is the default value and can be managed by you + * or other users + * - MANAGED_BY_ATTACHMENT is a BGP peer that is configured and managed + * by Cloud Interconnect, specifically by an InterconnectAttachment of type + * PARTNER. Google automatically creates, updates, and deletes this type of + * BGP peer when the PARTNER InterconnectAttachment is created, updated, + * or deleted. * Check the ManagementType enum for the list of possible values. * @type string $md5_authentication_key_name - * Present if MD5 authentication is enabled for the peering. Must be the name of one of the entries in the Router.md5_authentication_keys. The field must comply with RFC1035. + * Present if MD5 authentication is enabled for the peering. Must be the + * name of one of the entries in the Router.md5_authentication_keys. The + * field must comply with RFC1035. * @type string $name - * Name of this BGP peer. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of this BGP peer. + * The name must be 1-63 characters long, and comply withRFC1035. Specifically, the name must be 1-63 + * characters long and match the regular expression + * `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a + * lowercase letter, and all following characters must be a dash, lowercase + * letter, or digit, except the last character, which cannot be a dash. * @type int $peer_asn - * Peer BGP Autonomous System Number (ASN). Each BGP interface may use a different value. + * Peer BGP Autonomous System Number (ASN). Each BGP interface may use + * a different value. * @type string $peer_ip_address * IP address of the BGP interface outside Google Cloud Platform. * @type string $peer_ipv4_nexthop_address @@ -220,7 +310,11 @@ class RouterBgpPeer extends \Google\Protobuf\Internal\Message * @type string $peer_ipv6_nexthop_address * IPv6 address of the BGP interface outside Google Cloud Platform. * @type string $router_appliance_instance - * URI of the VM instance that is used as third-party router appliances such as Next Gen Firewalls, Virtual Routers, or Router Appliances. The VM instance must be located in zones contained in the same region as this Cloud Router. The VM instance is the peer side of the BGP session. + * URI of the VM instance that is used as third-party router + * appliances such as Next Gen Firewalls, Virtual Routers, or Router + * Appliances. The VM instance must be located in zones contained in the + * same region as this Cloud Router. + * The VM instance is the peer side of the BGP session. * } */ public function __construct($data = NULL) { @@ -267,7 +361,15 @@ public function setAdvertiseMode($var) } /** - * User-specified list of prefix groups to advertise in custom mode, which currently supports the following option: - ALL_SUBNETS: Advertises all of the router's own VPC subnets. This excludes any routes learned for subnets that use VPC Network Peering. Note that this field can only be populated if advertise_mode is CUSTOM and overrides the list defined for the router (in the "bgp" message). These groups are advertised in addition to any specified prefixes. Leave this field blank to advertise no custom groups. + * User-specified list of prefix groups to advertise in custom mode, + * which currently supports the following option: + * - ALL_SUBNETS: Advertises all of the router's own VPC subnets. This + * excludes any routes learned for subnets that use + * VPC Network Peering. + * Note that this field can only be populated if advertise_mode is CUSTOM + * and overrides the list defined for the router (in the "bgp" message). + * These groups are advertised in addition to any specified prefixes. + * Leave this field blank to advertise no custom groups. * Check the AdvertisedGroups enum for the list of possible values. * * Generated from protobuf field repeated string advertised_groups = 21065526; @@ -279,7 +381,15 @@ public function getAdvertisedGroups() } /** - * User-specified list of prefix groups to advertise in custom mode, which currently supports the following option: - ALL_SUBNETS: Advertises all of the router's own VPC subnets. This excludes any routes learned for subnets that use VPC Network Peering. Note that this field can only be populated if advertise_mode is CUSTOM and overrides the list defined for the router (in the "bgp" message). These groups are advertised in addition to any specified prefixes. Leave this field blank to advertise no custom groups. + * User-specified list of prefix groups to advertise in custom mode, + * which currently supports the following option: + * - ALL_SUBNETS: Advertises all of the router's own VPC subnets. This + * excludes any routes learned for subnets that use + * VPC Network Peering. + * Note that this field can only be populated if advertise_mode is CUSTOM + * and overrides the list defined for the router (in the "bgp" message). + * These groups are advertised in addition to any specified prefixes. + * Leave this field blank to advertise no custom groups. * Check the AdvertisedGroups enum for the list of possible values. * * Generated from protobuf field repeated string advertised_groups = 21065526; @@ -295,7 +405,11 @@ public function setAdvertisedGroups($var) } /** - * User-specified list of individual IP ranges to advertise in custom mode. This field can only be populated if advertise_mode is CUSTOM and overrides the list defined for the router (in the "bgp" message). These IP ranges are advertised in addition to any specified groups. Leave this field blank to advertise no custom IP ranges. + * User-specified list of individual IP ranges to advertise in custom mode. + * This field can only be populated if advertise_mode is CUSTOM and + * overrides the list defined for the router (in the "bgp" message). + * These IP ranges are advertised in addition to any specified groups. + * Leave this field blank to advertise no custom IP ranges. * * Generated from protobuf field repeated .google.cloud.compute.v1.RouterAdvertisedIpRange advertised_ip_ranges = 35449932; * @return \Google\Protobuf\Internal\RepeatedField @@ -306,7 +420,11 @@ public function getAdvertisedIpRanges() } /** - * User-specified list of individual IP ranges to advertise in custom mode. This field can only be populated if advertise_mode is CUSTOM and overrides the list defined for the router (in the "bgp" message). These IP ranges are advertised in addition to any specified groups. Leave this field blank to advertise no custom IP ranges. + * User-specified list of individual IP ranges to advertise in custom mode. + * This field can only be populated if advertise_mode is CUSTOM and + * overrides the list defined for the router (in the "bgp" message). + * These IP ranges are advertised in addition to any specified groups. + * Leave this field blank to advertise no custom IP ranges. * * Generated from protobuf field repeated .google.cloud.compute.v1.RouterAdvertisedIpRange advertised_ip_ranges = 35449932; * @param array<\Google\Cloud\Compute\V1\RouterAdvertisedIpRange>|\Google\Protobuf\Internal\RepeatedField $var @@ -321,7 +439,9 @@ public function setAdvertisedIpRanges($var) } /** - * The priority of routes advertised to this BGP peer. Where there is more than one matching route of maximum length, the routes with the lowest priority value win. + * The priority of routes advertised to this BGP peer. Where there is more + * than one matching route of maximum length, the routes with the lowest + * priority value win. * * Generated from protobuf field optional uint32 advertised_route_priority = 186486332; * @return int @@ -342,7 +462,9 @@ public function clearAdvertisedRoutePriority() } /** - * The priority of routes advertised to this BGP peer. Where there is more than one matching route of maximum length, the routes with the lowest priority value win. + * The priority of routes advertised to this BGP peer. Where there is more + * than one matching route of maximum length, the routes with the lowest + * priority value win. * * Generated from protobuf field optional uint32 advertised_route_priority = 186486332; * @param int $var @@ -393,7 +515,8 @@ public function setBfd($var) } /** - * A list of user-defined custom learned route IP address ranges for a BGP session. + * A list of user-defined custom learned route IP address ranges for a BGP + * session. * * Generated from protobuf field repeated .google.cloud.compute.v1.RouterBgpPeerCustomLearnedIpRange custom_learned_ip_ranges = 481363012; * @return \Google\Protobuf\Internal\RepeatedField @@ -404,7 +527,8 @@ public function getCustomLearnedIpRanges() } /** - * A list of user-defined custom learned route IP address ranges for a BGP session. + * A list of user-defined custom learned route IP address ranges for a BGP + * session. * * Generated from protobuf field repeated .google.cloud.compute.v1.RouterBgpPeerCustomLearnedIpRange custom_learned_ip_ranges = 481363012; * @param array<\Google\Cloud\Compute\V1\RouterBgpPeerCustomLearnedIpRange>|\Google\Protobuf\Internal\RepeatedField $var @@ -419,7 +543,10 @@ public function setCustomLearnedIpRanges($var) } /** - * The user-defined custom learned route priority for a BGP session. This value is applied to all custom learned route ranges for the session. You can choose a value from `0` to `65335`. If you don't provide a value, Google Cloud assigns a priority of `100` to the ranges. + * The user-defined custom learned route priority for a BGP session. This + * value is applied to all custom learned route ranges for the session. + * You can choose a value from `0` to `65335`. If you don't provide a + * value, Google Cloud assigns a priority of `100` to the ranges. * * Generated from protobuf field optional int32 custom_learned_route_priority = 330412356; * @return int @@ -440,7 +567,10 @@ public function clearCustomLearnedRoutePriority() } /** - * The user-defined custom learned route priority for a BGP session. This value is applied to all custom learned route ranges for the session. You can choose a value from `0` to `65335`. If you don't provide a value, Google Cloud assigns a priority of `100` to the ranges. + * The user-defined custom learned route priority for a BGP session. This + * value is applied to all custom learned route ranges for the session. + * You can choose a value from `0` to `65335`. If you don't provide a + * value, Google Cloud assigns a priority of `100` to the ranges. * * Generated from protobuf field optional int32 custom_learned_route_priority = 330412356; * @param int $var @@ -455,7 +585,11 @@ public function setCustomLearnedRoutePriority($var) } /** - * The status of the BGP peer connection. If set to FALSE, any active session with the peer is terminated and all associated routing information is removed. If set to TRUE, the peer connection can be established with routing information. The default is TRUE. + * The status of the BGP peer connection. + * If set to FALSE, any active session with the peer is terminated and + * all associated routing information is removed. If set to TRUE, the + * peer connection can be established with routing information. The default + * is TRUE. * Check the Enable enum for the list of possible values. * * Generated from protobuf field optional string enable = 311764355; @@ -477,7 +611,11 @@ public function clearEnable() } /** - * The status of the BGP peer connection. If set to FALSE, any active session with the peer is terminated and all associated routing information is removed. If set to TRUE, the peer connection can be established with routing information. The default is TRUE. + * The status of the BGP peer connection. + * If set to FALSE, any active session with the peer is terminated and + * all associated routing information is removed. If set to TRUE, the + * peer connection can be established with routing information. The default + * is TRUE. * Check the Enable enum for the list of possible values. * * Generated from protobuf field optional string enable = 311764355; @@ -493,7 +631,8 @@ public function setEnable($var) } /** - * Enable IPv4 traffic over BGP Peer. It is enabled by default if the peerIpAddress is version 4. + * Enable IPv4 traffic over BGP Peer. It is enabled by default if + * the peerIpAddress is version 4. * * Generated from protobuf field optional bool enable_ipv4 = 181467937; * @return bool @@ -514,7 +653,8 @@ public function clearEnableIpv4() } /** - * Enable IPv4 traffic over BGP Peer. It is enabled by default if the peerIpAddress is version 4. + * Enable IPv4 traffic over BGP Peer. It is enabled by default if + * the peerIpAddress is version 4. * * Generated from protobuf field optional bool enable_ipv4 = 181467937; * @param bool $var @@ -529,7 +669,8 @@ public function setEnableIpv4($var) } /** - * Enable IPv6 traffic over BGP Peer. It is enabled by default if the peerIpAddress is version 6. + * Enable IPv6 traffic over BGP Peer. It is enabled by default if the + * peerIpAddress is version 6. * * Generated from protobuf field optional bool enable_ipv6 = 181467939; * @return bool @@ -550,7 +691,8 @@ public function clearEnableIpv6() } /** - * Enable IPv6 traffic over BGP Peer. It is enabled by default if the peerIpAddress is version 6. + * Enable IPv6 traffic over BGP Peer. It is enabled by default if the + * peerIpAddress is version 6. * * Generated from protobuf field optional bool enable_ipv6 = 181467939; * @param bool $var @@ -565,7 +707,9 @@ public function setEnableIpv6($var) } /** - * List of export policies applied to this peer, in the order they must be evaluated. The name must correspond to an existing policy that has ROUTE_POLICY_TYPE_EXPORT type. + * List of export policies applied to this peer, in the order they must be + * evaluated. The name must correspond to an existing policy that has + * ROUTE_POLICY_TYPE_EXPORT type. * * Generated from protobuf field repeated string export_policies = 134084987; * @return \Google\Protobuf\Internal\RepeatedField @@ -576,7 +720,9 @@ public function getExportPolicies() } /** - * List of export policies applied to this peer, in the order they must be evaluated. The name must correspond to an existing policy that has ROUTE_POLICY_TYPE_EXPORT type. + * List of export policies applied to this peer, in the order they must be + * evaluated. The name must correspond to an existing policy that has + * ROUTE_POLICY_TYPE_EXPORT type. * * Generated from protobuf field repeated string export_policies = 134084987; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -591,7 +737,9 @@ public function setExportPolicies($var) } /** - * List of import policies applied to this peer, in the order they must be evaluated. The name must correspond to an existing policy that has ROUTE_POLICY_TYPE_IMPORT type. + * List of import policies applied to this peer, in the order they must be + * evaluated. The name must correspond to an existing policy that has + * ROUTE_POLICY_TYPE_IMPORT type. * * Generated from protobuf field repeated string import_policies = 451147946; * @return \Google\Protobuf\Internal\RepeatedField @@ -602,7 +750,9 @@ public function getImportPolicies() } /** - * List of import policies applied to this peer, in the order they must be evaluated. The name must correspond to an existing policy that has ROUTE_POLICY_TYPE_IMPORT type. + * List of import policies applied to this peer, in the order they must be + * evaluated. The name must correspond to an existing policy that has + * ROUTE_POLICY_TYPE_IMPORT type. * * Generated from protobuf field repeated string import_policies = 451147946; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -761,7 +911,14 @@ public function setIpv6NexthopAddress($var) } /** - * [Output Only] The resource that configures and manages this BGP peer. - MANAGED_BY_USER is the default value and can be managed by you or other users - MANAGED_BY_ATTACHMENT is a BGP peer that is configured and managed by Cloud Interconnect, specifically by an InterconnectAttachment of type PARTNER. Google automatically creates, updates, and deletes this type of BGP peer when the PARTNER InterconnectAttachment is created, updated, or deleted. + * [Output Only] The resource that configures and manages this BGP peer. + * - MANAGED_BY_USER is the default value and can be managed by you + * or other users + * - MANAGED_BY_ATTACHMENT is a BGP peer that is configured and managed + * by Cloud Interconnect, specifically by an InterconnectAttachment of type + * PARTNER. Google automatically creates, updates, and deletes this type of + * BGP peer when the PARTNER InterconnectAttachment is created, updated, + * or deleted. * Check the ManagementType enum for the list of possible values. * * Generated from protobuf field optional string management_type = 173703606; @@ -783,7 +940,14 @@ public function clearManagementType() } /** - * [Output Only] The resource that configures and manages this BGP peer. - MANAGED_BY_USER is the default value and can be managed by you or other users - MANAGED_BY_ATTACHMENT is a BGP peer that is configured and managed by Cloud Interconnect, specifically by an InterconnectAttachment of type PARTNER. Google automatically creates, updates, and deletes this type of BGP peer when the PARTNER InterconnectAttachment is created, updated, or deleted. + * [Output Only] The resource that configures and manages this BGP peer. + * - MANAGED_BY_USER is the default value and can be managed by you + * or other users + * - MANAGED_BY_ATTACHMENT is a BGP peer that is configured and managed + * by Cloud Interconnect, specifically by an InterconnectAttachment of type + * PARTNER. Google automatically creates, updates, and deletes this type of + * BGP peer when the PARTNER InterconnectAttachment is created, updated, + * or deleted. * Check the ManagementType enum for the list of possible values. * * Generated from protobuf field optional string management_type = 173703606; @@ -799,7 +963,9 @@ public function setManagementType($var) } /** - * Present if MD5 authentication is enabled for the peering. Must be the name of one of the entries in the Router.md5_authentication_keys. The field must comply with RFC1035. + * Present if MD5 authentication is enabled for the peering. Must be the + * name of one of the entries in the Router.md5_authentication_keys. The + * field must comply with RFC1035. * * Generated from protobuf field optional string md5_authentication_key_name = 281075345; * @return string @@ -820,7 +986,9 @@ public function clearMd5AuthenticationKeyName() } /** - * Present if MD5 authentication is enabled for the peering. Must be the name of one of the entries in the Router.md5_authentication_keys. The field must comply with RFC1035. + * Present if MD5 authentication is enabled for the peering. Must be the + * name of one of the entries in the Router.md5_authentication_keys. The + * field must comply with RFC1035. * * Generated from protobuf field optional string md5_authentication_key_name = 281075345; * @param string $var @@ -835,7 +1003,12 @@ public function setMd5AuthenticationKeyName($var) } /** - * Name of this BGP peer. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of this BGP peer. + * The name must be 1-63 characters long, and comply withRFC1035. Specifically, the name must be 1-63 + * characters long and match the regular expression + * `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a + * lowercase letter, and all following characters must be a dash, lowercase + * letter, or digit, except the last character, which cannot be a dash. * * Generated from protobuf field optional string name = 3373707; * @return string @@ -856,7 +1029,12 @@ public function clearName() } /** - * Name of this BGP peer. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of this BGP peer. + * The name must be 1-63 characters long, and comply withRFC1035. Specifically, the name must be 1-63 + * characters long and match the regular expression + * `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a + * lowercase letter, and all following characters must be a dash, lowercase + * letter, or digit, except the last character, which cannot be a dash. * * Generated from protobuf field optional string name = 3373707; * @param string $var @@ -871,7 +1049,8 @@ public function setName($var) } /** - * Peer BGP Autonomous System Number (ASN). Each BGP interface may use a different value. + * Peer BGP Autonomous System Number (ASN). Each BGP interface may use + * a different value. * * Generated from protobuf field optional uint32 peer_asn = 69573151; * @return int @@ -892,7 +1071,8 @@ public function clearPeerAsn() } /** - * Peer BGP Autonomous System Number (ASN). Each BGP interface may use a different value. + * Peer BGP Autonomous System Number (ASN). Each BGP interface may use + * a different value. * * Generated from protobuf field optional uint32 peer_asn = 69573151; * @param int $var @@ -1015,7 +1195,11 @@ public function setPeerIpv6NexthopAddress($var) } /** - * URI of the VM instance that is used as third-party router appliances such as Next Gen Firewalls, Virtual Routers, or Router Appliances. The VM instance must be located in zones contained in the same region as this Cloud Router. The VM instance is the peer side of the BGP session. + * URI of the VM instance that is used as third-party router + * appliances such as Next Gen Firewalls, Virtual Routers, or Router + * Appliances. The VM instance must be located in zones contained in the + * same region as this Cloud Router. + * The VM instance is the peer side of the BGP session. * * Generated from protobuf field optional string router_appliance_instance = 468312989; * @return string @@ -1036,7 +1220,11 @@ public function clearRouterApplianceInstance() } /** - * URI of the VM instance that is used as third-party router appliances such as Next Gen Firewalls, Virtual Routers, or Router Appliances. The VM instance must be located in zones contained in the same region as this Cloud Router. The VM instance is the peer side of the BGP session. + * URI of the VM instance that is used as third-party router + * appliances such as Next Gen Firewalls, Virtual Routers, or Router + * Appliances. The VM instance must be located in zones contained in the + * same region as this Cloud Router. + * The VM instance is the peer side of the BGP session. * * Generated from protobuf field optional string router_appliance_instance = 468312989; * @param string $var diff --git a/Compute/src/V1/RouterBgpPeer/Enable.php b/Compute/src/V1/RouterBgpPeer/Enable.php index 75c1037cfef3..3bbf3d49f829 100644 --- a/Compute/src/V1/RouterBgpPeer/Enable.php +++ b/Compute/src/V1/RouterBgpPeer/Enable.php @@ -7,7 +7,11 @@ use UnexpectedValueException; /** - * The status of the BGP peer connection. If set to FALSE, any active session with the peer is terminated and all associated routing information is removed. If set to TRUE, the peer connection can be established with routing information. The default is TRUE. + * The status of the BGP peer connection. + * If set to FALSE, any active session with the peer is terminated and + * all associated routing information is removed. If set to TRUE, the + * peer connection can be established with routing information. The default + * is TRUE. * * Protobuf type google.cloud.compute.v1.RouterBgpPeer.Enable */ diff --git a/Compute/src/V1/RouterBgpPeer/ManagementType.php b/Compute/src/V1/RouterBgpPeer/ManagementType.php index 7d4e8f011040..03f17e3a1beb 100644 --- a/Compute/src/V1/RouterBgpPeer/ManagementType.php +++ b/Compute/src/V1/RouterBgpPeer/ManagementType.php @@ -7,7 +7,14 @@ use UnexpectedValueException; /** - * [Output Only] The resource that configures and manages this BGP peer. - MANAGED_BY_USER is the default value and can be managed by you or other users - MANAGED_BY_ATTACHMENT is a BGP peer that is configured and managed by Cloud Interconnect, specifically by an InterconnectAttachment of type PARTNER. Google automatically creates, updates, and deletes this type of BGP peer when the PARTNER InterconnectAttachment is created, updated, or deleted. + * [Output Only] The resource that configures and manages this BGP peer. + * - MANAGED_BY_USER is the default value and can be managed by you + * or other users + * - MANAGED_BY_ATTACHMENT is a BGP peer that is configured and managed + * by Cloud Interconnect, specifically by an InterconnectAttachment of type + * PARTNER. Google automatically creates, updates, and deletes this type of + * BGP peer when the PARTNER InterconnectAttachment is created, updated, + * or deleted. * * Protobuf type google.cloud.compute.v1.RouterBgpPeer.ManagementType */ @@ -20,7 +27,13 @@ class ManagementType */ const UNDEFINED_MANAGEMENT_TYPE = 0; /** - * The BGP peer is automatically created for PARTNER type InterconnectAttachment; Google will automatically create/delete this BGP peer when the PARTNER InterconnectAttachment is created/deleted, and Google will update the ipAddress and peerIpAddress when the PARTNER InterconnectAttachment is provisioned. This type of BGP peer cannot be created or deleted, but can be modified for all fields except for name, ipAddress and peerIpAddress. + * The BGP peer is automatically created for PARTNER type + * InterconnectAttachment; Google will automatically create/delete + * this BGP peer when the PARTNER InterconnectAttachment is + * created/deleted, and Google will update the ipAddress and + * peerIpAddress when the PARTNER InterconnectAttachment is provisioned. + * This type of BGP peer cannot be created or deleted, but can be + * modified for all fields except for name, ipAddress and peerIpAddress. * * Generated from protobuf enum MANAGED_BY_ATTACHMENT = 458926411; */ diff --git a/Compute/src/V1/RouterBgpPeerBfd.php b/Compute/src/V1/RouterBgpPeerBfd.php index 695d610b06d7..c45fdde80024 100644 --- a/Compute/src/V1/RouterBgpPeerBfd.php +++ b/Compute/src/V1/RouterBgpPeerBfd.php @@ -15,25 +15,42 @@ class RouterBgpPeerBfd extends \Google\Protobuf\Internal\Message { /** - * The minimum interval, in milliseconds, between BFD control packets received from the peer router. The actual value is negotiated between the two routers and is equal to the greater of this value and the transmit interval of the other router. If set, this value must be between 1000 and 30000. The default is 1000. + * The minimum interval, in milliseconds, between BFD control packets + * received from the peer router. The actual value is negotiated between + * the two routers and is equal to the greater of this value and the + * transmit interval of the other router. + * If set, this value must be between 1000 and 30000. + * The default is 1000. * * Generated from protobuf field optional uint32 min_receive_interval = 186981614; */ protected $min_receive_interval = null; /** - * The minimum interval, in milliseconds, between BFD control packets transmitted to the peer router. The actual value is negotiated between the two routers and is equal to the greater of this value and the corresponding receive interval of the other router. If set, this value must be between 1000 and 30000. The default is 1000. + * The minimum interval, in milliseconds, between BFD control packets + * transmitted to the peer router. The actual value is negotiated between + * the two routers and is equal to the greater of this value and the + * corresponding receive interval of the other router. + * If set, this value must be between 1000 and 30000. + * The default is 1000. * * Generated from protobuf field optional uint32 min_transmit_interval = 523282631; */ protected $min_transmit_interval = null; /** - * The number of consecutive BFD packets that must be missed before BFD declares that a peer is unavailable. If set, the value must be a value between 5 and 16. The default is 5. + * The number of consecutive BFD packets that must be missed + * before BFD declares that a peer is unavailable. + * If set, the value must be a value between 5 and 16. + * The default is 5. * * Generated from protobuf field optional uint32 multiplier = 191331777; */ protected $multiplier = null; /** - * The BFD session initialization mode for this BGP peer. If set to ACTIVE, the Cloud Router will initiate the BFD session for this BGP peer. If set to PASSIVE, the Cloud Router will wait for the peer router to initiate the BFD session for this BGP peer. If set to DISABLED, BFD is disabled for this BGP peer. The default is DISABLED. + * The BFD session initialization mode for this BGP peer. + * If set to ACTIVE, the Cloud Router will initiate the BFD session for + * this BGP peer. If set to PASSIVE, the Cloud Router will wait for the + * peer router to initiate the BFD session for this BGP peer. If set to + * DISABLED, BFD is disabled for this BGP peer. The default is DISABLED. * Check the SessionInitializationMode enum for the list of possible values. * * Generated from protobuf field optional string session_initialization_mode = 105957049; @@ -47,13 +64,30 @@ class RouterBgpPeerBfd extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type int $min_receive_interval - * The minimum interval, in milliseconds, between BFD control packets received from the peer router. The actual value is negotiated between the two routers and is equal to the greater of this value and the transmit interval of the other router. If set, this value must be between 1000 and 30000. The default is 1000. + * The minimum interval, in milliseconds, between BFD control packets + * received from the peer router. The actual value is negotiated between + * the two routers and is equal to the greater of this value and the + * transmit interval of the other router. + * If set, this value must be between 1000 and 30000. + * The default is 1000. * @type int $min_transmit_interval - * The minimum interval, in milliseconds, between BFD control packets transmitted to the peer router. The actual value is negotiated between the two routers and is equal to the greater of this value and the corresponding receive interval of the other router. If set, this value must be between 1000 and 30000. The default is 1000. + * The minimum interval, in milliseconds, between BFD control packets + * transmitted to the peer router. The actual value is negotiated between + * the two routers and is equal to the greater of this value and the + * corresponding receive interval of the other router. + * If set, this value must be between 1000 and 30000. + * The default is 1000. * @type int $multiplier - * The number of consecutive BFD packets that must be missed before BFD declares that a peer is unavailable. If set, the value must be a value between 5 and 16. The default is 5. + * The number of consecutive BFD packets that must be missed + * before BFD declares that a peer is unavailable. + * If set, the value must be a value between 5 and 16. + * The default is 5. * @type string $session_initialization_mode - * The BFD session initialization mode for this BGP peer. If set to ACTIVE, the Cloud Router will initiate the BFD session for this BGP peer. If set to PASSIVE, the Cloud Router will wait for the peer router to initiate the BFD session for this BGP peer. If set to DISABLED, BFD is disabled for this BGP peer. The default is DISABLED. + * The BFD session initialization mode for this BGP peer. + * If set to ACTIVE, the Cloud Router will initiate the BFD session for + * this BGP peer. If set to PASSIVE, the Cloud Router will wait for the + * peer router to initiate the BFD session for this BGP peer. If set to + * DISABLED, BFD is disabled for this BGP peer. The default is DISABLED. * Check the SessionInitializationMode enum for the list of possible values. * } */ @@ -63,7 +97,12 @@ public function __construct($data = NULL) { } /** - * The minimum interval, in milliseconds, between BFD control packets received from the peer router. The actual value is negotiated between the two routers and is equal to the greater of this value and the transmit interval of the other router. If set, this value must be between 1000 and 30000. The default is 1000. + * The minimum interval, in milliseconds, between BFD control packets + * received from the peer router. The actual value is negotiated between + * the two routers and is equal to the greater of this value and the + * transmit interval of the other router. + * If set, this value must be between 1000 and 30000. + * The default is 1000. * * Generated from protobuf field optional uint32 min_receive_interval = 186981614; * @return int @@ -84,7 +123,12 @@ public function clearMinReceiveInterval() } /** - * The minimum interval, in milliseconds, between BFD control packets received from the peer router. The actual value is negotiated between the two routers and is equal to the greater of this value and the transmit interval of the other router. If set, this value must be between 1000 and 30000. The default is 1000. + * The minimum interval, in milliseconds, between BFD control packets + * received from the peer router. The actual value is negotiated between + * the two routers and is equal to the greater of this value and the + * transmit interval of the other router. + * If set, this value must be between 1000 and 30000. + * The default is 1000. * * Generated from protobuf field optional uint32 min_receive_interval = 186981614; * @param int $var @@ -99,7 +143,12 @@ public function setMinReceiveInterval($var) } /** - * The minimum interval, in milliseconds, between BFD control packets transmitted to the peer router. The actual value is negotiated between the two routers and is equal to the greater of this value and the corresponding receive interval of the other router. If set, this value must be between 1000 and 30000. The default is 1000. + * The minimum interval, in milliseconds, between BFD control packets + * transmitted to the peer router. The actual value is negotiated between + * the two routers and is equal to the greater of this value and the + * corresponding receive interval of the other router. + * If set, this value must be between 1000 and 30000. + * The default is 1000. * * Generated from protobuf field optional uint32 min_transmit_interval = 523282631; * @return int @@ -120,7 +169,12 @@ public function clearMinTransmitInterval() } /** - * The minimum interval, in milliseconds, between BFD control packets transmitted to the peer router. The actual value is negotiated between the two routers and is equal to the greater of this value and the corresponding receive interval of the other router. If set, this value must be between 1000 and 30000. The default is 1000. + * The minimum interval, in milliseconds, between BFD control packets + * transmitted to the peer router. The actual value is negotiated between + * the two routers and is equal to the greater of this value and the + * corresponding receive interval of the other router. + * If set, this value must be between 1000 and 30000. + * The default is 1000. * * Generated from protobuf field optional uint32 min_transmit_interval = 523282631; * @param int $var @@ -135,7 +189,10 @@ public function setMinTransmitInterval($var) } /** - * The number of consecutive BFD packets that must be missed before BFD declares that a peer is unavailable. If set, the value must be a value between 5 and 16. The default is 5. + * The number of consecutive BFD packets that must be missed + * before BFD declares that a peer is unavailable. + * If set, the value must be a value between 5 and 16. + * The default is 5. * * Generated from protobuf field optional uint32 multiplier = 191331777; * @return int @@ -156,7 +213,10 @@ public function clearMultiplier() } /** - * The number of consecutive BFD packets that must be missed before BFD declares that a peer is unavailable. If set, the value must be a value between 5 and 16. The default is 5. + * The number of consecutive BFD packets that must be missed + * before BFD declares that a peer is unavailable. + * If set, the value must be a value between 5 and 16. + * The default is 5. * * Generated from protobuf field optional uint32 multiplier = 191331777; * @param int $var @@ -171,7 +231,11 @@ public function setMultiplier($var) } /** - * The BFD session initialization mode for this BGP peer. If set to ACTIVE, the Cloud Router will initiate the BFD session for this BGP peer. If set to PASSIVE, the Cloud Router will wait for the peer router to initiate the BFD session for this BGP peer. If set to DISABLED, BFD is disabled for this BGP peer. The default is DISABLED. + * The BFD session initialization mode for this BGP peer. + * If set to ACTIVE, the Cloud Router will initiate the BFD session for + * this BGP peer. If set to PASSIVE, the Cloud Router will wait for the + * peer router to initiate the BFD session for this BGP peer. If set to + * DISABLED, BFD is disabled for this BGP peer. The default is DISABLED. * Check the SessionInitializationMode enum for the list of possible values. * * Generated from protobuf field optional string session_initialization_mode = 105957049; @@ -193,7 +257,11 @@ public function clearSessionInitializationMode() } /** - * The BFD session initialization mode for this BGP peer. If set to ACTIVE, the Cloud Router will initiate the BFD session for this BGP peer. If set to PASSIVE, the Cloud Router will wait for the peer router to initiate the BFD session for this BGP peer. If set to DISABLED, BFD is disabled for this BGP peer. The default is DISABLED. + * The BFD session initialization mode for this BGP peer. + * If set to ACTIVE, the Cloud Router will initiate the BFD session for + * this BGP peer. If set to PASSIVE, the Cloud Router will wait for the + * peer router to initiate the BFD session for this BGP peer. If set to + * DISABLED, BFD is disabled for this BGP peer. The default is DISABLED. * Check the SessionInitializationMode enum for the list of possible values. * * Generated from protobuf field optional string session_initialization_mode = 105957049; diff --git a/Compute/src/V1/RouterBgpPeerBfd/SessionInitializationMode.php b/Compute/src/V1/RouterBgpPeerBfd/SessionInitializationMode.php index 19ef04d4101c..48ba1e7dedb7 100644 --- a/Compute/src/V1/RouterBgpPeerBfd/SessionInitializationMode.php +++ b/Compute/src/V1/RouterBgpPeerBfd/SessionInitializationMode.php @@ -7,7 +7,11 @@ use UnexpectedValueException; /** - * The BFD session initialization mode for this BGP peer. If set to ACTIVE, the Cloud Router will initiate the BFD session for this BGP peer. If set to PASSIVE, the Cloud Router will wait for the peer router to initiate the BFD session for this BGP peer. If set to DISABLED, BFD is disabled for this BGP peer. The default is DISABLED. + * The BFD session initialization mode for this BGP peer. + * If set to ACTIVE, the Cloud Router will initiate the BFD session for + * this BGP peer. If set to PASSIVE, the Cloud Router will wait for the + * peer router to initiate the BFD session for this BGP peer. If set to + * DISABLED, BFD is disabled for this BGP peer. The default is DISABLED. * * Protobuf type google.cloud.compute.v1.RouterBgpPeerBfd.SessionInitializationMode */ diff --git a/Compute/src/V1/RouterBgpPeerCustomLearnedIpRange.php b/Compute/src/V1/RouterBgpPeerCustomLearnedIpRange.php index 7b8974584801..5bf63bcc33f8 100644 --- a/Compute/src/V1/RouterBgpPeerCustomLearnedIpRange.php +++ b/Compute/src/V1/RouterBgpPeerCustomLearnedIpRange.php @@ -15,7 +15,10 @@ class RouterBgpPeerCustomLearnedIpRange extends \Google\Protobuf\Internal\Message { /** - * The custom learned route IP address range. Must be a valid CIDR-formatted prefix. If an IP address is provided without a subnet mask, it is interpreted as, for IPv4, a `/32` singular IP address range, and, for IPv6, `/128`. + * The custom learned route IP address range. Must be a valid + * CIDR-formatted prefix. If an IP address is provided without a subnet + * mask, it is interpreted as, for IPv4, a `/32` singular IP address + * range, and, for IPv6, `/128`. * * Generated from protobuf field optional string range = 108280125; */ @@ -28,7 +31,10 @@ class RouterBgpPeerCustomLearnedIpRange extends \Google\Protobuf\Internal\Messag * Optional. Data for populating the Message object. * * @type string $range - * The custom learned route IP address range. Must be a valid CIDR-formatted prefix. If an IP address is provided without a subnet mask, it is interpreted as, for IPv4, a `/32` singular IP address range, and, for IPv6, `/128`. + * The custom learned route IP address range. Must be a valid + * CIDR-formatted prefix. If an IP address is provided without a subnet + * mask, it is interpreted as, for IPv4, a `/32` singular IP address + * range, and, for IPv6, `/128`. * } */ public function __construct($data = NULL) { @@ -37,7 +43,10 @@ public function __construct($data = NULL) { } /** - * The custom learned route IP address range. Must be a valid CIDR-formatted prefix. If an IP address is provided without a subnet mask, it is interpreted as, for IPv4, a `/32` singular IP address range, and, for IPv6, `/128`. + * The custom learned route IP address range. Must be a valid + * CIDR-formatted prefix. If an IP address is provided without a subnet + * mask, it is interpreted as, for IPv4, a `/32` singular IP address + * range, and, for IPv6, `/128`. * * Generated from protobuf field optional string range = 108280125; * @return string @@ -58,7 +67,10 @@ public function clearRange() } /** - * The custom learned route IP address range. Must be a valid CIDR-formatted prefix. If an IP address is provided without a subnet mask, it is interpreted as, for IPv4, a `/32` singular IP address range, and, for IPv6, `/128`. + * The custom learned route IP address range. Must be a valid + * CIDR-formatted prefix. If an IP address is provided without a subnet + * mask, it is interpreted as, for IPv4, a `/32` singular IP address + * range, and, for IPv6, `/128`. * * Generated from protobuf field optional string range = 108280125; * @param string $var diff --git a/Compute/src/V1/RouterInterface.php b/Compute/src/V1/RouterInterface.php index 8d8ea26615b8..c3e67a795a86 100644 --- a/Compute/src/V1/RouterInterface.php +++ b/Compute/src/V1/RouterInterface.php @@ -15,7 +15,17 @@ class RouterInterface extends \Google\Protobuf\Internal\Message { /** - * IP address and range of the interface. - For Internet Protocol version 4 (IPv4), the IP range must be in the RFC3927 link-local IP address space. The value must be a CIDR-formatted string, for example, 169.254.0.1/30. Note: Do not truncate the IP address, as it represents the IP address of the interface. - For Internet Protocol version 6 (IPv6), the value must be a unique local address (ULA) range from fdff:1::/64 with a mask length of 126 or less. This value should be a CIDR-formatted string, for example, fdff:1::1/112. Within the router's VPC, this IPv6 prefix will be reserved exclusively for this connection and cannot be used for any other purpose. + * IP address and range of the interface. + * - For Internet Protocol version 4 (IPv4), the IP range must be in theRFC3927 link-local IP address space. The value must + * be a CIDR-formatted string, for example, 169.254.0.1/30. + * Note: Do not truncate the IP address, as it represents the IP address of + * the interface. + * - For Internet Protocol version 6 (IPv6), the value + * must be a unique local address (ULA) range from fdff:1::/64 + * with a mask length of 126 or less. This value should be a CIDR-formatted + * string, for example, fdff:1::1/112. Within the router's + * VPC, this IPv6 prefix will be reserved exclusively for this connection + * and cannot be used for any other purpose. * * Generated from protobuf field optional string ip_range = 145092645; */ @@ -28,44 +38,76 @@ class RouterInterface extends \Google\Protobuf\Internal\Message */ protected $ip_version = null; /** - * URI of the linked Interconnect attachment. It must be in the same region as the router. Each interface can have one linked resource, which can be a VPN tunnel, an Interconnect attachment, or a subnetwork. + * URI of the linked Interconnect attachment. It must be in the same region + * as the router. Each interface can have one linked resource, which can be + * a VPN tunnel, an Interconnect attachment, or a subnetwork. * * Generated from protobuf field optional string linked_interconnect_attachment = 501085518; */ protected $linked_interconnect_attachment = null; /** - * URI of the linked VPN tunnel, which must be in the same region as the router. Each interface can have one linked resource, which can be a VPN tunnel, an Interconnect attachment, or a subnetwork. + * URI of the linked VPN tunnel, which must be in the same region as the + * router. Each interface can have one linked resource, which can be + * a VPN tunnel, an Interconnect attachment, or a subnetwork. * * Generated from protobuf field optional string linked_vpn_tunnel = 352296953; */ protected $linked_vpn_tunnel = null; /** - * [Output Only] The resource that configures and manages this interface. - MANAGED_BY_USER is the default value and can be managed directly by users. - MANAGED_BY_ATTACHMENT is an interface that is configured and managed by Cloud Interconnect, specifically, by an InterconnectAttachment of type PARTNER. Google automatically creates, updates, and deletes this type of interface when the PARTNER InterconnectAttachment is created, updated, or deleted. + * [Output Only] The resource that configures and manages this interface. + * - MANAGED_BY_USER is the default value and can be managed directly + * by users. + * - MANAGED_BY_ATTACHMENT is an interface that is configured and + * managed by Cloud Interconnect, specifically, by an InterconnectAttachment + * of type PARTNER. Google automatically creates, updates, and deletes + * this type of interface when the PARTNER InterconnectAttachment is + * created, updated, or deleted. * Check the ManagementType enum for the list of possible values. * * Generated from protobuf field optional string management_type = 173703606; */ protected $management_type = null; /** - * Name of this interface entry. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of this interface entry. + * The name must be 1-63 characters long, and comply withRFC1035. Specifically, the name must be 1-63 + * characters long and match the regular expression + * `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a + * lowercase letter, and all following characters must be a dash, lowercase + * letter, or digit, except the last character, which cannot be a dash. * * Generated from protobuf field optional string name = 3373707; */ protected $name = null; /** - * The regional private internal IP address that is used to establish BGP sessions to a VM instance acting as a third-party Router Appliance, such as a Next Gen Firewall, a Virtual Router, or an SD-WAN VM. + * The regional private internal IP address that is used to establish + * BGP sessions to a VM instance acting as a third-party + * Router Appliance, such as a Next Gen Firewall, a Virtual Router, or + * an SD-WAN VM. * * Generated from protobuf field optional string private_ip_address = 100854040; */ protected $private_ip_address = null; /** - * Name of the interface that will be redundant with the current interface you are creating. The redundantInterface must belong to the same Cloud Router as the interface here. To establish the BGP session to a Router Appliance VM, you must create two BGP peers. The two BGP peers must be attached to two separate interfaces that are redundant with each other. The redundant_interface must be 1-63 characters long, and comply with RFC1035. Specifically, the redundant_interface must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the interface that will be redundant with the current interface + * you are creating. The redundantInterface must belong to the same Cloud + * Router as the interface here. To establish the BGP session to a Router + * Appliance VM, you must create two BGP peers. The two BGP peers must be + * attached to two separate interfaces that are redundant with each other. + * The redundant_interface must be 1-63 characters long, and comply withRFC1035. Specifically, the redundant_interface must + * be 1-63 characters long and match the regular expression + * `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a + * lowercase letter, and all following characters must be a dash, lowercase + * letter, or digit, except the last character, which cannot be a dash. * * Generated from protobuf field optional string redundant_interface = 523187303; */ protected $redundant_interface = null; /** - * The URI of the subnetwork resource that this interface belongs to, which must be in the same region as the Cloud Router. When you establish a BGP session to a VM instance using this interface, the VM instance must belong to the same subnetwork as the subnetwork specified here. + * The URI of the subnetwork resource that this interface belongs to, which + * must be in the same region as the Cloud Router. + * When you establish a BGP session to a VM instance using this interface, + * the VM instance must belong to the same subnetwork as the subnetwork + * specified here. * * Generated from protobuf field optional string subnetwork = 307827694; */ @@ -78,25 +120,67 @@ class RouterInterface extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $ip_range - * IP address and range of the interface. - For Internet Protocol version 4 (IPv4), the IP range must be in the RFC3927 link-local IP address space. The value must be a CIDR-formatted string, for example, 169.254.0.1/30. Note: Do not truncate the IP address, as it represents the IP address of the interface. - For Internet Protocol version 6 (IPv6), the value must be a unique local address (ULA) range from fdff:1::/64 with a mask length of 126 or less. This value should be a CIDR-formatted string, for example, fdff:1::1/112. Within the router's VPC, this IPv6 prefix will be reserved exclusively for this connection and cannot be used for any other purpose. + * IP address and range of the interface. + * - For Internet Protocol version 4 (IPv4), the IP range must be in theRFC3927 link-local IP address space. The value must + * be a CIDR-formatted string, for example, 169.254.0.1/30. + * Note: Do not truncate the IP address, as it represents the IP address of + * the interface. + * - For Internet Protocol version 6 (IPv6), the value + * must be a unique local address (ULA) range from fdff:1::/64 + * with a mask length of 126 or less. This value should be a CIDR-formatted + * string, for example, fdff:1::1/112. Within the router's + * VPC, this IPv6 prefix will be reserved exclusively for this connection + * and cannot be used for any other purpose. * @type string $ip_version * IP version of this interface. * Check the IpVersion enum for the list of possible values. * @type string $linked_interconnect_attachment - * URI of the linked Interconnect attachment. It must be in the same region as the router. Each interface can have one linked resource, which can be a VPN tunnel, an Interconnect attachment, or a subnetwork. + * URI of the linked Interconnect attachment. It must be in the same region + * as the router. Each interface can have one linked resource, which can be + * a VPN tunnel, an Interconnect attachment, or a subnetwork. * @type string $linked_vpn_tunnel - * URI of the linked VPN tunnel, which must be in the same region as the router. Each interface can have one linked resource, which can be a VPN tunnel, an Interconnect attachment, or a subnetwork. + * URI of the linked VPN tunnel, which must be in the same region as the + * router. Each interface can have one linked resource, which can be + * a VPN tunnel, an Interconnect attachment, or a subnetwork. * @type string $management_type - * [Output Only] The resource that configures and manages this interface. - MANAGED_BY_USER is the default value and can be managed directly by users. - MANAGED_BY_ATTACHMENT is an interface that is configured and managed by Cloud Interconnect, specifically, by an InterconnectAttachment of type PARTNER. Google automatically creates, updates, and deletes this type of interface when the PARTNER InterconnectAttachment is created, updated, or deleted. + * [Output Only] The resource that configures and manages this interface. + * - MANAGED_BY_USER is the default value and can be managed directly + * by users. + * - MANAGED_BY_ATTACHMENT is an interface that is configured and + * managed by Cloud Interconnect, specifically, by an InterconnectAttachment + * of type PARTNER. Google automatically creates, updates, and deletes + * this type of interface when the PARTNER InterconnectAttachment is + * created, updated, or deleted. * Check the ManagementType enum for the list of possible values. * @type string $name - * Name of this interface entry. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of this interface entry. + * The name must be 1-63 characters long, and comply withRFC1035. Specifically, the name must be 1-63 + * characters long and match the regular expression + * `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a + * lowercase letter, and all following characters must be a dash, lowercase + * letter, or digit, except the last character, which cannot be a dash. * @type string $private_ip_address - * The regional private internal IP address that is used to establish BGP sessions to a VM instance acting as a third-party Router Appliance, such as a Next Gen Firewall, a Virtual Router, or an SD-WAN VM. + * The regional private internal IP address that is used to establish + * BGP sessions to a VM instance acting as a third-party + * Router Appliance, such as a Next Gen Firewall, a Virtual Router, or + * an SD-WAN VM. * @type string $redundant_interface - * Name of the interface that will be redundant with the current interface you are creating. The redundantInterface must belong to the same Cloud Router as the interface here. To establish the BGP session to a Router Appliance VM, you must create two BGP peers. The two BGP peers must be attached to two separate interfaces that are redundant with each other. The redundant_interface must be 1-63 characters long, and comply with RFC1035. Specifically, the redundant_interface must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the interface that will be redundant with the current interface + * you are creating. The redundantInterface must belong to the same Cloud + * Router as the interface here. To establish the BGP session to a Router + * Appliance VM, you must create two BGP peers. The two BGP peers must be + * attached to two separate interfaces that are redundant with each other. + * The redundant_interface must be 1-63 characters long, and comply withRFC1035. Specifically, the redundant_interface must + * be 1-63 characters long and match the regular expression + * `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a + * lowercase letter, and all following characters must be a dash, lowercase + * letter, or digit, except the last character, which cannot be a dash. * @type string $subnetwork - * The URI of the subnetwork resource that this interface belongs to, which must be in the same region as the Cloud Router. When you establish a BGP session to a VM instance using this interface, the VM instance must belong to the same subnetwork as the subnetwork specified here. + * The URI of the subnetwork resource that this interface belongs to, which + * must be in the same region as the Cloud Router. + * When you establish a BGP session to a VM instance using this interface, + * the VM instance must belong to the same subnetwork as the subnetwork + * specified here. * } */ public function __construct($data = NULL) { @@ -105,7 +189,17 @@ public function __construct($data = NULL) { } /** - * IP address and range of the interface. - For Internet Protocol version 4 (IPv4), the IP range must be in the RFC3927 link-local IP address space. The value must be a CIDR-formatted string, for example, 169.254.0.1/30. Note: Do not truncate the IP address, as it represents the IP address of the interface. - For Internet Protocol version 6 (IPv6), the value must be a unique local address (ULA) range from fdff:1::/64 with a mask length of 126 or less. This value should be a CIDR-formatted string, for example, fdff:1::1/112. Within the router's VPC, this IPv6 prefix will be reserved exclusively for this connection and cannot be used for any other purpose. + * IP address and range of the interface. + * - For Internet Protocol version 4 (IPv4), the IP range must be in theRFC3927 link-local IP address space. The value must + * be a CIDR-formatted string, for example, 169.254.0.1/30. + * Note: Do not truncate the IP address, as it represents the IP address of + * the interface. + * - For Internet Protocol version 6 (IPv6), the value + * must be a unique local address (ULA) range from fdff:1::/64 + * with a mask length of 126 or less. This value should be a CIDR-formatted + * string, for example, fdff:1::1/112. Within the router's + * VPC, this IPv6 prefix will be reserved exclusively for this connection + * and cannot be used for any other purpose. * * Generated from protobuf field optional string ip_range = 145092645; * @return string @@ -126,7 +220,17 @@ public function clearIpRange() } /** - * IP address and range of the interface. - For Internet Protocol version 4 (IPv4), the IP range must be in the RFC3927 link-local IP address space. The value must be a CIDR-formatted string, for example, 169.254.0.1/30. Note: Do not truncate the IP address, as it represents the IP address of the interface. - For Internet Protocol version 6 (IPv6), the value must be a unique local address (ULA) range from fdff:1::/64 with a mask length of 126 or less. This value should be a CIDR-formatted string, for example, fdff:1::1/112. Within the router's VPC, this IPv6 prefix will be reserved exclusively for this connection and cannot be used for any other purpose. + * IP address and range of the interface. + * - For Internet Protocol version 4 (IPv4), the IP range must be in theRFC3927 link-local IP address space. The value must + * be a CIDR-formatted string, for example, 169.254.0.1/30. + * Note: Do not truncate the IP address, as it represents the IP address of + * the interface. + * - For Internet Protocol version 6 (IPv6), the value + * must be a unique local address (ULA) range from fdff:1::/64 + * with a mask length of 126 or less. This value should be a CIDR-formatted + * string, for example, fdff:1::1/112. Within the router's + * VPC, this IPv6 prefix will be reserved exclusively for this connection + * and cannot be used for any other purpose. * * Generated from protobuf field optional string ip_range = 145092645; * @param string $var @@ -179,7 +283,9 @@ public function setIpVersion($var) } /** - * URI of the linked Interconnect attachment. It must be in the same region as the router. Each interface can have one linked resource, which can be a VPN tunnel, an Interconnect attachment, or a subnetwork. + * URI of the linked Interconnect attachment. It must be in the same region + * as the router. Each interface can have one linked resource, which can be + * a VPN tunnel, an Interconnect attachment, or a subnetwork. * * Generated from protobuf field optional string linked_interconnect_attachment = 501085518; * @return string @@ -200,7 +306,9 @@ public function clearLinkedInterconnectAttachment() } /** - * URI of the linked Interconnect attachment. It must be in the same region as the router. Each interface can have one linked resource, which can be a VPN tunnel, an Interconnect attachment, or a subnetwork. + * URI of the linked Interconnect attachment. It must be in the same region + * as the router. Each interface can have one linked resource, which can be + * a VPN tunnel, an Interconnect attachment, or a subnetwork. * * Generated from protobuf field optional string linked_interconnect_attachment = 501085518; * @param string $var @@ -215,7 +323,9 @@ public function setLinkedInterconnectAttachment($var) } /** - * URI of the linked VPN tunnel, which must be in the same region as the router. Each interface can have one linked resource, which can be a VPN tunnel, an Interconnect attachment, or a subnetwork. + * URI of the linked VPN tunnel, which must be in the same region as the + * router. Each interface can have one linked resource, which can be + * a VPN tunnel, an Interconnect attachment, or a subnetwork. * * Generated from protobuf field optional string linked_vpn_tunnel = 352296953; * @return string @@ -236,7 +346,9 @@ public function clearLinkedVpnTunnel() } /** - * URI of the linked VPN tunnel, which must be in the same region as the router. Each interface can have one linked resource, which can be a VPN tunnel, an Interconnect attachment, or a subnetwork. + * URI of the linked VPN tunnel, which must be in the same region as the + * router. Each interface can have one linked resource, which can be + * a VPN tunnel, an Interconnect attachment, or a subnetwork. * * Generated from protobuf field optional string linked_vpn_tunnel = 352296953; * @param string $var @@ -251,7 +363,14 @@ public function setLinkedVpnTunnel($var) } /** - * [Output Only] The resource that configures and manages this interface. - MANAGED_BY_USER is the default value and can be managed directly by users. - MANAGED_BY_ATTACHMENT is an interface that is configured and managed by Cloud Interconnect, specifically, by an InterconnectAttachment of type PARTNER. Google automatically creates, updates, and deletes this type of interface when the PARTNER InterconnectAttachment is created, updated, or deleted. + * [Output Only] The resource that configures and manages this interface. + * - MANAGED_BY_USER is the default value and can be managed directly + * by users. + * - MANAGED_BY_ATTACHMENT is an interface that is configured and + * managed by Cloud Interconnect, specifically, by an InterconnectAttachment + * of type PARTNER. Google automatically creates, updates, and deletes + * this type of interface when the PARTNER InterconnectAttachment is + * created, updated, or deleted. * Check the ManagementType enum for the list of possible values. * * Generated from protobuf field optional string management_type = 173703606; @@ -273,7 +392,14 @@ public function clearManagementType() } /** - * [Output Only] The resource that configures and manages this interface. - MANAGED_BY_USER is the default value and can be managed directly by users. - MANAGED_BY_ATTACHMENT is an interface that is configured and managed by Cloud Interconnect, specifically, by an InterconnectAttachment of type PARTNER. Google automatically creates, updates, and deletes this type of interface when the PARTNER InterconnectAttachment is created, updated, or deleted. + * [Output Only] The resource that configures and manages this interface. + * - MANAGED_BY_USER is the default value and can be managed directly + * by users. + * - MANAGED_BY_ATTACHMENT is an interface that is configured and + * managed by Cloud Interconnect, specifically, by an InterconnectAttachment + * of type PARTNER. Google automatically creates, updates, and deletes + * this type of interface when the PARTNER InterconnectAttachment is + * created, updated, or deleted. * Check the ManagementType enum for the list of possible values. * * Generated from protobuf field optional string management_type = 173703606; @@ -289,7 +415,12 @@ public function setManagementType($var) } /** - * Name of this interface entry. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of this interface entry. + * The name must be 1-63 characters long, and comply withRFC1035. Specifically, the name must be 1-63 + * characters long and match the regular expression + * `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a + * lowercase letter, and all following characters must be a dash, lowercase + * letter, or digit, except the last character, which cannot be a dash. * * Generated from protobuf field optional string name = 3373707; * @return string @@ -310,7 +441,12 @@ public function clearName() } /** - * Name of this interface entry. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of this interface entry. + * The name must be 1-63 characters long, and comply withRFC1035. Specifically, the name must be 1-63 + * characters long and match the regular expression + * `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a + * lowercase letter, and all following characters must be a dash, lowercase + * letter, or digit, except the last character, which cannot be a dash. * * Generated from protobuf field optional string name = 3373707; * @param string $var @@ -325,7 +461,10 @@ public function setName($var) } /** - * The regional private internal IP address that is used to establish BGP sessions to a VM instance acting as a third-party Router Appliance, such as a Next Gen Firewall, a Virtual Router, or an SD-WAN VM. + * The regional private internal IP address that is used to establish + * BGP sessions to a VM instance acting as a third-party + * Router Appliance, such as a Next Gen Firewall, a Virtual Router, or + * an SD-WAN VM. * * Generated from protobuf field optional string private_ip_address = 100854040; * @return string @@ -346,7 +485,10 @@ public function clearPrivateIpAddress() } /** - * The regional private internal IP address that is used to establish BGP sessions to a VM instance acting as a third-party Router Appliance, such as a Next Gen Firewall, a Virtual Router, or an SD-WAN VM. + * The regional private internal IP address that is used to establish + * BGP sessions to a VM instance acting as a third-party + * Router Appliance, such as a Next Gen Firewall, a Virtual Router, or + * an SD-WAN VM. * * Generated from protobuf field optional string private_ip_address = 100854040; * @param string $var @@ -361,7 +503,16 @@ public function setPrivateIpAddress($var) } /** - * Name of the interface that will be redundant with the current interface you are creating. The redundantInterface must belong to the same Cloud Router as the interface here. To establish the BGP session to a Router Appliance VM, you must create two BGP peers. The two BGP peers must be attached to two separate interfaces that are redundant with each other. The redundant_interface must be 1-63 characters long, and comply with RFC1035. Specifically, the redundant_interface must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the interface that will be redundant with the current interface + * you are creating. The redundantInterface must belong to the same Cloud + * Router as the interface here. To establish the BGP session to a Router + * Appliance VM, you must create two BGP peers. The two BGP peers must be + * attached to two separate interfaces that are redundant with each other. + * The redundant_interface must be 1-63 characters long, and comply withRFC1035. Specifically, the redundant_interface must + * be 1-63 characters long and match the regular expression + * `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a + * lowercase letter, and all following characters must be a dash, lowercase + * letter, or digit, except the last character, which cannot be a dash. * * Generated from protobuf field optional string redundant_interface = 523187303; * @return string @@ -382,7 +533,16 @@ public function clearRedundantInterface() } /** - * Name of the interface that will be redundant with the current interface you are creating. The redundantInterface must belong to the same Cloud Router as the interface here. To establish the BGP session to a Router Appliance VM, you must create two BGP peers. The two BGP peers must be attached to two separate interfaces that are redundant with each other. The redundant_interface must be 1-63 characters long, and comply with RFC1035. Specifically, the redundant_interface must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the interface that will be redundant with the current interface + * you are creating. The redundantInterface must belong to the same Cloud + * Router as the interface here. To establish the BGP session to a Router + * Appliance VM, you must create two BGP peers. The two BGP peers must be + * attached to two separate interfaces that are redundant with each other. + * The redundant_interface must be 1-63 characters long, and comply withRFC1035. Specifically, the redundant_interface must + * be 1-63 characters long and match the regular expression + * `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a + * lowercase letter, and all following characters must be a dash, lowercase + * letter, or digit, except the last character, which cannot be a dash. * * Generated from protobuf field optional string redundant_interface = 523187303; * @param string $var @@ -397,7 +557,11 @@ public function setRedundantInterface($var) } /** - * The URI of the subnetwork resource that this interface belongs to, which must be in the same region as the Cloud Router. When you establish a BGP session to a VM instance using this interface, the VM instance must belong to the same subnetwork as the subnetwork specified here. + * The URI of the subnetwork resource that this interface belongs to, which + * must be in the same region as the Cloud Router. + * When you establish a BGP session to a VM instance using this interface, + * the VM instance must belong to the same subnetwork as the subnetwork + * specified here. * * Generated from protobuf field optional string subnetwork = 307827694; * @return string @@ -418,7 +582,11 @@ public function clearSubnetwork() } /** - * The URI of the subnetwork resource that this interface belongs to, which must be in the same region as the Cloud Router. When you establish a BGP session to a VM instance using this interface, the VM instance must belong to the same subnetwork as the subnetwork specified here. + * The URI of the subnetwork resource that this interface belongs to, which + * must be in the same region as the Cloud Router. + * When you establish a BGP session to a VM instance using this interface, + * the VM instance must belong to the same subnetwork as the subnetwork + * specified here. * * Generated from protobuf field optional string subnetwork = 307827694; * @param string $var diff --git a/Compute/src/V1/RouterInterface/ManagementType.php b/Compute/src/V1/RouterInterface/ManagementType.php index 2629f142c077..438419739d5a 100644 --- a/Compute/src/V1/RouterInterface/ManagementType.php +++ b/Compute/src/V1/RouterInterface/ManagementType.php @@ -7,7 +7,14 @@ use UnexpectedValueException; /** - * [Output Only] The resource that configures and manages this interface. - MANAGED_BY_USER is the default value and can be managed directly by users. - MANAGED_BY_ATTACHMENT is an interface that is configured and managed by Cloud Interconnect, specifically, by an InterconnectAttachment of type PARTNER. Google automatically creates, updates, and deletes this type of interface when the PARTNER InterconnectAttachment is created, updated, or deleted. + * [Output Only] The resource that configures and manages this interface. + * - MANAGED_BY_USER is the default value and can be managed directly + * by users. + * - MANAGED_BY_ATTACHMENT is an interface that is configured and + * managed by Cloud Interconnect, specifically, by an InterconnectAttachment + * of type PARTNER. Google automatically creates, updates, and deletes + * this type of interface when the PARTNER InterconnectAttachment is + * created, updated, or deleted. * * Protobuf type google.cloud.compute.v1.RouterInterface.ManagementType */ @@ -20,7 +27,11 @@ class ManagementType */ const UNDEFINED_MANAGEMENT_TYPE = 0; /** - * The interface is automatically created for PARTNER type InterconnectAttachment, Google will automatically create/update/delete this interface when the PARTNER InterconnectAttachment is created/provisioned/deleted. This type of interface cannot be manually managed by user. + * The interface is automatically created for PARTNER type + * InterconnectAttachment, Google will automatically create/update/delete + * this interface when the PARTNER InterconnectAttachment is + * created/provisioned/deleted. + * This type of interface cannot be manually managed by user. * * Generated from protobuf enum MANAGED_BY_ATTACHMENT = 458926411; */ diff --git a/Compute/src/V1/RouterList.php b/Compute/src/V1/RouterList.php index 988da5d53726..f3f541928fb3 100644 --- a/Compute/src/V1/RouterList.php +++ b/Compute/src/V1/RouterList.php @@ -28,13 +28,18 @@ class RouterList extends \Google\Protobuf\Internal\Message */ private $items; /** - * [Output Only] Type of resource. Always compute#router for routers. + * [Output Only] Type of resource. Always compute#router for + * routers. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -63,9 +68,14 @@ class RouterList extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\Router>|\Google\Protobuf\Internal\RepeatedField $items * A list of Router resources. * @type string $kind - * [Output Only] Type of resource. Always compute#router for routers. + * [Output Only] Type of resource. Always compute#router for + * routers. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type \Google\Cloud\Compute\V1\Warning $warning @@ -140,7 +150,8 @@ public function setItems($var) } /** - * [Output Only] Type of resource. Always compute#router for routers. + * [Output Only] Type of resource. Always compute#router for + * routers. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -161,7 +172,8 @@ public function clearKind() } /** - * [Output Only] Type of resource. Always compute#router for routers. + * [Output Only] Type of resource. Always compute#router for + * routers. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -176,7 +188,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -197,7 +213,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/RouterMd5AuthenticationKey.php b/Compute/src/V1/RouterMd5AuthenticationKey.php index 45d87cccc2df..f1453b2d3a1d 100644 --- a/Compute/src/V1/RouterMd5AuthenticationKey.php +++ b/Compute/src/V1/RouterMd5AuthenticationKey.php @@ -15,13 +15,19 @@ class RouterMd5AuthenticationKey extends \Google\Protobuf\Internal\Message { /** - * [Input only] Value of the key. For patch and update calls, it can be skipped to copy the value from the previous configuration. This is allowed if the key with the same name existed before the operation. Maximum length is 80 characters. Can only contain printable ASCII characters. + * [Input only] Value of the key. + * For patch and update calls, it can be skipped to + * copy the value from the previous configuration. This is allowed if the + * key with the same name existed before the operation. Maximum length is 80 + * characters. Can only contain printable ASCII characters. * * Generated from protobuf field optional string key = 106079; */ protected $key = null; /** - * Name used to identify the key. Must be unique within a router. Must be referenced by exactly one bgpPeer. Must comply with RFC1035. + * Name used to identify the key. + * Must be unique within a router. Must be referenced by exactly + * one bgpPeer. Must comply withRFC1035. * * Generated from protobuf field optional string name = 3373707; */ @@ -34,9 +40,15 @@ class RouterMd5AuthenticationKey extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $key - * [Input only] Value of the key. For patch and update calls, it can be skipped to copy the value from the previous configuration. This is allowed if the key with the same name existed before the operation. Maximum length is 80 characters. Can only contain printable ASCII characters. + * [Input only] Value of the key. + * For patch and update calls, it can be skipped to + * copy the value from the previous configuration. This is allowed if the + * key with the same name existed before the operation. Maximum length is 80 + * characters. Can only contain printable ASCII characters. * @type string $name - * Name used to identify the key. Must be unique within a router. Must be referenced by exactly one bgpPeer. Must comply with RFC1035. + * Name used to identify the key. + * Must be unique within a router. Must be referenced by exactly + * one bgpPeer. Must comply withRFC1035. * } */ public function __construct($data = NULL) { @@ -45,7 +57,11 @@ public function __construct($data = NULL) { } /** - * [Input only] Value of the key. For patch and update calls, it can be skipped to copy the value from the previous configuration. This is allowed if the key with the same name existed before the operation. Maximum length is 80 characters. Can only contain printable ASCII characters. + * [Input only] Value of the key. + * For patch and update calls, it can be skipped to + * copy the value from the previous configuration. This is allowed if the + * key with the same name existed before the operation. Maximum length is 80 + * characters. Can only contain printable ASCII characters. * * Generated from protobuf field optional string key = 106079; * @return string @@ -66,7 +82,11 @@ public function clearKey() } /** - * [Input only] Value of the key. For patch and update calls, it can be skipped to copy the value from the previous configuration. This is allowed if the key with the same name existed before the operation. Maximum length is 80 characters. Can only contain printable ASCII characters. + * [Input only] Value of the key. + * For patch and update calls, it can be skipped to + * copy the value from the previous configuration. This is allowed if the + * key with the same name existed before the operation. Maximum length is 80 + * characters. Can only contain printable ASCII characters. * * Generated from protobuf field optional string key = 106079; * @param string $var @@ -81,7 +101,9 @@ public function setKey($var) } /** - * Name used to identify the key. Must be unique within a router. Must be referenced by exactly one bgpPeer. Must comply with RFC1035. + * Name used to identify the key. + * Must be unique within a router. Must be referenced by exactly + * one bgpPeer. Must comply withRFC1035. * * Generated from protobuf field optional string name = 3373707; * @return string @@ -102,7 +124,9 @@ public function clearName() } /** - * Name used to identify the key. Must be unique within a router. Must be referenced by exactly one bgpPeer. Must comply with RFC1035. + * Name used to identify the key. + * Must be unique within a router. Must be referenced by exactly + * one bgpPeer. Must comply withRFC1035. * * Generated from protobuf field optional string name = 3373707; * @param string $var diff --git a/Compute/src/V1/RouterNat.php b/Compute/src/V1/RouterNat.php index c935d4f41970..f11ee708b614 100644 --- a/Compute/src/V1/RouterNat.php +++ b/Compute/src/V1/RouterNat.php @@ -9,27 +9,45 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Represents a Nat resource. It enables the VMs within the specified subnetworks to access Internet without external IP addresses. It specifies a list of subnetworks (and the ranges within) that want to use NAT. Customers can also provide the external IPs that would be used for NAT. GCP would auto-allocate ephemeral IPs if no external IPs are provided. + * Represents a Nat resource. It enables the VMs within the specified + * subnetworks to access Internet without external IP addresses. It specifies + * a list of subnetworks (and the ranges within) that want to use NAT. + * Customers can also provide the external IPs that would be used for NAT. GCP + * would auto-allocate ephemeral IPs if no external IPs are provided. * * Generated from protobuf message google.cloud.compute.v1.RouterNat */ class RouterNat extends \Google\Protobuf\Internal\Message { /** - * The network tier to use when automatically reserving NAT IP addresses. Must be one of: PREMIUM, STANDARD. If not specified, then the current project-level default tier is used. + * The network tier to use when automatically reserving NAT IP addresses. + * Must be one of: PREMIUM, STANDARD. + * If not specified, then the current + * project-level default tier is used. * Check the AutoNetworkTier enum for the list of possible values. * * Generated from protobuf field optional string auto_network_tier = 269770211; */ protected $auto_network_tier = null; /** - * A list of URLs of the IP resources to be drained. These IPs must be valid static external IPs that have been assigned to the NAT. These IPs should be used for updating/patching a NAT only. + * A list of URLs of the IP resources to be drained. These IPs + * must be valid static external IPs that have been assigned to the NAT. + * These IPs should be used for updating/patching a NAT only. * * Generated from protobuf field repeated string drain_nat_ips = 504078535; */ private $drain_nat_ips; /** - * Enable Dynamic Port Allocation. If not specified, it is disabled by default. If set to true, - Dynamic Port Allocation will be enabled on this NAT config. - enableEndpointIndependentMapping cannot be set to true. - If minPorts is set, minPortsPerVm must be set to a power of two greater than or equal to 32. If minPortsPerVm is not set, a minimum of 32 ports will be allocated to a VM from this NAT config. + * Enable Dynamic Port Allocation. + * If not specified, it is disabled by default. + * If set to true, + * - Dynamic Port Allocation will be enabled on this NAT + * config. + * - enableEndpointIndependentMapping cannot be set to true. + * - If minPorts is set, minPortsPerVm must be set to a + * power of two greater than or equal to 32. If minPortsPerVm is not set, a + * minimum of 32 ports will be allocated to a VM from this NAT + * config. * * Generated from protobuf field optional bool enable_dynamic_port_allocation = 532106402; */ @@ -39,7 +57,8 @@ class RouterNat extends \Google\Protobuf\Internal\Message */ protected $enable_endpoint_independent_mapping = null; /** - * List of NAT-ted endpoint types supported by the Nat Gateway. If the list is empty, then it will be equivalent to include ENDPOINT_TYPE_VM + * List of NAT-ted endpoint types supported by the Nat Gateway. If the list + * is empty, then it will be equivalent to include ENDPOINT_TYPE_VM * Check the EndpointTypes enum for the list of possible values. * * Generated from protobuf field repeated string endpoint_types = 502633807; @@ -58,38 +77,61 @@ class RouterNat extends \Google\Protobuf\Internal\Message */ protected $log_config = null; /** - * Maximum number of ports allocated to a VM from this NAT config when Dynamic Port Allocation is enabled. If Dynamic Port Allocation is not enabled, this field has no effect. If Dynamic Port Allocation is enabled, and this field is set, it must be set to a power of two greater than minPortsPerVm, or 64 if minPortsPerVm is not set. If Dynamic Port Allocation is enabled and this field is not set, a maximum of 65536 ports will be allocated to a VM from this NAT config. + * Maximum number of ports allocated to a VM from this NAT config when + * Dynamic Port Allocation is enabled. + * If Dynamic Port Allocation is not enabled, this field has no effect. + * If Dynamic Port Allocation is enabled, and this field is set, it must be + * set to a power of two greater than minPortsPerVm, or 64 if minPortsPerVm + * is not set. + * If Dynamic Port Allocation is enabled and this field is not set, + * a maximum of 65536 ports will be allocated to a VM from this NAT + * config. * * Generated from protobuf field optional int32 max_ports_per_vm = 250062049; */ protected $max_ports_per_vm = null; /** - * Minimum number of ports allocated to a VM from this NAT config. If not set, a default number of ports is allocated to a VM. This is rounded up to the nearest power of 2. For example, if the value of this field is 50, at least 64 ports are allocated to a VM. + * Minimum number of ports allocated to a VM from this NAT config. If not + * set, a default number of ports is allocated to a VM. This is rounded + * up to the nearest power of 2. For example, if the value of this field is + * 50, at least 64 ports are allocated to a VM. * * Generated from protobuf field optional int32 min_ports_per_vm = 186193587; */ protected $min_ports_per_vm = null; /** - * Unique name of this Nat service. The name must be 1-63 characters long and comply with RFC1035. + * Unique name of this Nat service. + * The name must be 1-63 characters long and comply withRFC1035. * * Generated from protobuf field optional string name = 3373707; */ protected $name = null; /** - * List of Subnetwork resources whose traffic should be translated by NAT64 Gateway. It is used only when LIST_OF_IPV6_SUBNETWORKS is selected for the SubnetworkIpRangeToNat64Option above. + * List of Subnetwork resources whose traffic should be translated by NAT64 + * Gateway. It is used only when LIST_OF_IPV6_SUBNETWORKS is + * selected for the SubnetworkIpRangeToNat64Option above. * * Generated from protobuf field repeated .google.cloud.compute.v1.RouterNatSubnetworkToNat64 nat64_subnetworks = 63585701; */ private $nat64_subnetworks; /** - * Specify the NatIpAllocateOption, which can take one of the following values: - MANUAL_ONLY: Uses only Nat IP addresses provided by customers. When there are not enough specified Nat IPs, the Nat service fails for new VMs. - AUTO_ONLY: Nat IPs are allocated by Google Cloud Platform; customers can't specify any Nat IPs. When choosing AUTO_ONLY, then nat_ip should be empty. + * Specify the NatIpAllocateOption, which can take one of the following + * values: + * - MANUAL_ONLY: Uses only Nat IP addresses provided by + * customers. When there are not enough specified Nat IPs, the Nat service + * fails for new VMs. + * - AUTO_ONLY: Nat IPs are allocated by Google Cloud Platform; customers + * can't specify any Nat IPs. When choosing AUTO_ONLY, then nat_ip should + * be empty. * Check the NatIpAllocateOption enum for the list of possible values. * * Generated from protobuf field optional string nat_ip_allocate_option = 429726845; */ protected $nat_ip_allocate_option = null; /** - * A list of URLs of the IP resources used for this Nat service. These IP addresses must be valid static external IP addresses assigned to the project. + * A list of URLs of the IP resources used for this Nat service. These IP + * addresses must be valid static external IP addresses assigned to the + * project. * * Generated from protobuf field repeated string nat_ips = 117635086; */ @@ -101,45 +143,71 @@ class RouterNat extends \Google\Protobuf\Internal\Message */ private $rules; /** - * Specify the Nat option, which can take one of the following values: - ALL_SUBNETWORKS_ALL_IP_RANGES: All of the IP ranges in every Subnetwork are allowed to Nat. - ALL_SUBNETWORKS_ALL_PRIMARY_IP_RANGES: All of the primary IP ranges in every Subnetwork are allowed to Nat. - LIST_OF_SUBNETWORKS: A list of Subnetworks are allowed to Nat (specified in the field subnetwork below) The default is SUBNETWORK_IP_RANGE_TO_NAT_OPTION_UNSPECIFIED. Note that if this field contains ALL_SUBNETWORKS_ALL_IP_RANGES then there should not be any other Router.Nat section in any Router for this network in this region. + * Specify the Nat option, which can take one of the following values: + * - ALL_SUBNETWORKS_ALL_IP_RANGES: All of the IP ranges in every + * Subnetwork are allowed to Nat. + * - ALL_SUBNETWORKS_ALL_PRIMARY_IP_RANGES: All of the primary IP ranges + * in every Subnetwork are allowed to Nat. + * - LIST_OF_SUBNETWORKS: A list of Subnetworks are allowed to Nat + * (specified in the field subnetwork below) + * The default is SUBNETWORK_IP_RANGE_TO_NAT_OPTION_UNSPECIFIED. + * Note that if this field contains ALL_SUBNETWORKS_ALL_IP_RANGES then there + * should not be any other Router.Nat section in any Router for this network + * in this region. * Check the SourceSubnetworkIpRangesToNat enum for the list of possible values. * * Generated from protobuf field optional string source_subnetwork_ip_ranges_to_nat = 252213211; */ protected $source_subnetwork_ip_ranges_to_nat = null; /** - * Specify the Nat option for NAT64, which can take one of the following values: - ALL_IPV6_SUBNETWORKS: All of the IP ranges in every Subnetwork are allowed to Nat. - LIST_OF_IPV6_SUBNETWORKS: A list of Subnetworks are allowed to Nat (specified in the field nat64_subnetwork below) The default is NAT64_OPTION_UNSPECIFIED. Note that if this field contains NAT64_ALL_V6_SUBNETWORKS no other Router.Nat section in this region can also enable NAT64 for any Subnetworks in this network. Other Router.Nat sections can still be present to enable NAT44 only. + * Specify the Nat option for NAT64, which can take one of the following + * values: + * - ALL_IPV6_SUBNETWORKS: All of the IP ranges in + * every Subnetwork are allowed to Nat. + * - LIST_OF_IPV6_SUBNETWORKS: A list of Subnetworks are allowed to Nat + * (specified in the field nat64_subnetwork below) + * The default is NAT64_OPTION_UNSPECIFIED. + * Note that if this field contains NAT64_ALL_V6_SUBNETWORKS no other + * Router.Nat section in this region can also enable NAT64 for any + * Subnetworks in this network. Other Router.Nat sections can still be + * present to enable NAT44 only. * Check the SourceSubnetworkIpRangesToNat64 enum for the list of possible values. * * Generated from protobuf field optional string source_subnetwork_ip_ranges_to_nat64 = 248116185; */ protected $source_subnetwork_ip_ranges_to_nat64 = null; /** - * A list of Subnetwork resources whose traffic should be translated by NAT Gateway. It is used only when LIST_OF_SUBNETWORKS is selected for the SubnetworkIpRangeToNatOption above. + * A list of Subnetwork resources whose traffic should be translated by NAT + * Gateway. It is used only when LIST_OF_SUBNETWORKS is selected for the + * SubnetworkIpRangeToNatOption above. * * Generated from protobuf field repeated .google.cloud.compute.v1.RouterNatSubnetworkToNat subnetworks = 415853125; */ private $subnetworks; /** - * Timeout (in seconds) for TCP established connections. Defaults to 1200s if not set. + * Timeout (in seconds) for TCP established connections. Defaults to 1200s + * if not set. * * Generated from protobuf field optional int32 tcp_established_idle_timeout_sec = 223098349; */ protected $tcp_established_idle_timeout_sec = null; /** - * Timeout (in seconds) for TCP connections that are in TIME_WAIT state. Defaults to 120s if not set. + * Timeout (in seconds) for TCP connections that are in TIME_WAIT state. + * Defaults to 120s if not set. * * Generated from protobuf field optional int32 tcp_time_wait_timeout_sec = 513596925; */ protected $tcp_time_wait_timeout_sec = null; /** - * Timeout (in seconds) for TCP transitory connections. Defaults to 30s if not set. + * Timeout (in seconds) for TCP transitory connections. Defaults to 30s if + * not set. * * Generated from protobuf field optional int32 tcp_transitory_idle_timeout_sec = 205028774; */ protected $tcp_transitory_idle_timeout_sec = null; /** - * Indicates whether this NAT is used for public or private IP translation. If unspecified, it defaults to PUBLIC. + * Indicates whether this NAT is used for public or private IP + * translation. If unspecified, it defaults to PUBLIC. * Check the Type enum for the list of possible values. * * Generated from protobuf field optional string type = 3575610; @@ -159,51 +227,115 @@ class RouterNat extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $auto_network_tier - * The network tier to use when automatically reserving NAT IP addresses. Must be one of: PREMIUM, STANDARD. If not specified, then the current project-level default tier is used. + * The network tier to use when automatically reserving NAT IP addresses. + * Must be one of: PREMIUM, STANDARD. + * If not specified, then the current + * project-level default tier is used. * Check the AutoNetworkTier enum for the list of possible values. * @type array|\Google\Protobuf\Internal\RepeatedField $drain_nat_ips - * A list of URLs of the IP resources to be drained. These IPs must be valid static external IPs that have been assigned to the NAT. These IPs should be used for updating/patching a NAT only. + * A list of URLs of the IP resources to be drained. These IPs + * must be valid static external IPs that have been assigned to the NAT. + * These IPs should be used for updating/patching a NAT only. * @type bool $enable_dynamic_port_allocation - * Enable Dynamic Port Allocation. If not specified, it is disabled by default. If set to true, - Dynamic Port Allocation will be enabled on this NAT config. - enableEndpointIndependentMapping cannot be set to true. - If minPorts is set, minPortsPerVm must be set to a power of two greater than or equal to 32. If minPortsPerVm is not set, a minimum of 32 ports will be allocated to a VM from this NAT config. + * Enable Dynamic Port Allocation. + * If not specified, it is disabled by default. + * If set to true, + * - Dynamic Port Allocation will be enabled on this NAT + * config. + * - enableEndpointIndependentMapping cannot be set to true. + * - If minPorts is set, minPortsPerVm must be set to a + * power of two greater than or equal to 32. If minPortsPerVm is not set, a + * minimum of 32 ports will be allocated to a VM from this NAT + * config. * @type bool $enable_endpoint_independent_mapping * @type array|\Google\Protobuf\Internal\RepeatedField $endpoint_types - * List of NAT-ted endpoint types supported by the Nat Gateway. If the list is empty, then it will be equivalent to include ENDPOINT_TYPE_VM + * List of NAT-ted endpoint types supported by the Nat Gateway. If the list + * is empty, then it will be equivalent to include ENDPOINT_TYPE_VM * Check the EndpointTypes enum for the list of possible values. * @type int $icmp_idle_timeout_sec * Timeout (in seconds) for ICMP connections. Defaults to 30s if not set. * @type \Google\Cloud\Compute\V1\RouterNatLogConfig $log_config * Configure logging on this NAT. * @type int $max_ports_per_vm - * Maximum number of ports allocated to a VM from this NAT config when Dynamic Port Allocation is enabled. If Dynamic Port Allocation is not enabled, this field has no effect. If Dynamic Port Allocation is enabled, and this field is set, it must be set to a power of two greater than minPortsPerVm, or 64 if minPortsPerVm is not set. If Dynamic Port Allocation is enabled and this field is not set, a maximum of 65536 ports will be allocated to a VM from this NAT config. + * Maximum number of ports allocated to a VM from this NAT config when + * Dynamic Port Allocation is enabled. + * If Dynamic Port Allocation is not enabled, this field has no effect. + * If Dynamic Port Allocation is enabled, and this field is set, it must be + * set to a power of two greater than minPortsPerVm, or 64 if minPortsPerVm + * is not set. + * If Dynamic Port Allocation is enabled and this field is not set, + * a maximum of 65536 ports will be allocated to a VM from this NAT + * config. * @type int $min_ports_per_vm - * Minimum number of ports allocated to a VM from this NAT config. If not set, a default number of ports is allocated to a VM. This is rounded up to the nearest power of 2. For example, if the value of this field is 50, at least 64 ports are allocated to a VM. + * Minimum number of ports allocated to a VM from this NAT config. If not + * set, a default number of ports is allocated to a VM. This is rounded + * up to the nearest power of 2. For example, if the value of this field is + * 50, at least 64 ports are allocated to a VM. * @type string $name - * Unique name of this Nat service. The name must be 1-63 characters long and comply with RFC1035. + * Unique name of this Nat service. + * The name must be 1-63 characters long and comply withRFC1035. * @type array<\Google\Cloud\Compute\V1\RouterNatSubnetworkToNat64>|\Google\Protobuf\Internal\RepeatedField $nat64_subnetworks - * List of Subnetwork resources whose traffic should be translated by NAT64 Gateway. It is used only when LIST_OF_IPV6_SUBNETWORKS is selected for the SubnetworkIpRangeToNat64Option above. + * List of Subnetwork resources whose traffic should be translated by NAT64 + * Gateway. It is used only when LIST_OF_IPV6_SUBNETWORKS is + * selected for the SubnetworkIpRangeToNat64Option above. * @type string $nat_ip_allocate_option - * Specify the NatIpAllocateOption, which can take one of the following values: - MANUAL_ONLY: Uses only Nat IP addresses provided by customers. When there are not enough specified Nat IPs, the Nat service fails for new VMs. - AUTO_ONLY: Nat IPs are allocated by Google Cloud Platform; customers can't specify any Nat IPs. When choosing AUTO_ONLY, then nat_ip should be empty. + * Specify the NatIpAllocateOption, which can take one of the following + * values: + * - MANUAL_ONLY: Uses only Nat IP addresses provided by + * customers. When there are not enough specified Nat IPs, the Nat service + * fails for new VMs. + * - AUTO_ONLY: Nat IPs are allocated by Google Cloud Platform; customers + * can't specify any Nat IPs. When choosing AUTO_ONLY, then nat_ip should + * be empty. * Check the NatIpAllocateOption enum for the list of possible values. * @type array|\Google\Protobuf\Internal\RepeatedField $nat_ips - * A list of URLs of the IP resources used for this Nat service. These IP addresses must be valid static external IP addresses assigned to the project. + * A list of URLs of the IP resources used for this Nat service. These IP + * addresses must be valid static external IP addresses assigned to the + * project. * @type array<\Google\Cloud\Compute\V1\RouterNatRule>|\Google\Protobuf\Internal\RepeatedField $rules * A list of rules associated with this NAT. * @type string $source_subnetwork_ip_ranges_to_nat - * Specify the Nat option, which can take one of the following values: - ALL_SUBNETWORKS_ALL_IP_RANGES: All of the IP ranges in every Subnetwork are allowed to Nat. - ALL_SUBNETWORKS_ALL_PRIMARY_IP_RANGES: All of the primary IP ranges in every Subnetwork are allowed to Nat. - LIST_OF_SUBNETWORKS: A list of Subnetworks are allowed to Nat (specified in the field subnetwork below) The default is SUBNETWORK_IP_RANGE_TO_NAT_OPTION_UNSPECIFIED. Note that if this field contains ALL_SUBNETWORKS_ALL_IP_RANGES then there should not be any other Router.Nat section in any Router for this network in this region. + * Specify the Nat option, which can take one of the following values: + * - ALL_SUBNETWORKS_ALL_IP_RANGES: All of the IP ranges in every + * Subnetwork are allowed to Nat. + * - ALL_SUBNETWORKS_ALL_PRIMARY_IP_RANGES: All of the primary IP ranges + * in every Subnetwork are allowed to Nat. + * - LIST_OF_SUBNETWORKS: A list of Subnetworks are allowed to Nat + * (specified in the field subnetwork below) + * The default is SUBNETWORK_IP_RANGE_TO_NAT_OPTION_UNSPECIFIED. + * Note that if this field contains ALL_SUBNETWORKS_ALL_IP_RANGES then there + * should not be any other Router.Nat section in any Router for this network + * in this region. * Check the SourceSubnetworkIpRangesToNat enum for the list of possible values. * @type string $source_subnetwork_ip_ranges_to_nat64 - * Specify the Nat option for NAT64, which can take one of the following values: - ALL_IPV6_SUBNETWORKS: All of the IP ranges in every Subnetwork are allowed to Nat. - LIST_OF_IPV6_SUBNETWORKS: A list of Subnetworks are allowed to Nat (specified in the field nat64_subnetwork below) The default is NAT64_OPTION_UNSPECIFIED. Note that if this field contains NAT64_ALL_V6_SUBNETWORKS no other Router.Nat section in this region can also enable NAT64 for any Subnetworks in this network. Other Router.Nat sections can still be present to enable NAT44 only. + * Specify the Nat option for NAT64, which can take one of the following + * values: + * - ALL_IPV6_SUBNETWORKS: All of the IP ranges in + * every Subnetwork are allowed to Nat. + * - LIST_OF_IPV6_SUBNETWORKS: A list of Subnetworks are allowed to Nat + * (specified in the field nat64_subnetwork below) + * The default is NAT64_OPTION_UNSPECIFIED. + * Note that if this field contains NAT64_ALL_V6_SUBNETWORKS no other + * Router.Nat section in this region can also enable NAT64 for any + * Subnetworks in this network. Other Router.Nat sections can still be + * present to enable NAT44 only. * Check the SourceSubnetworkIpRangesToNat64 enum for the list of possible values. * @type array<\Google\Cloud\Compute\V1\RouterNatSubnetworkToNat>|\Google\Protobuf\Internal\RepeatedField $subnetworks - * A list of Subnetwork resources whose traffic should be translated by NAT Gateway. It is used only when LIST_OF_SUBNETWORKS is selected for the SubnetworkIpRangeToNatOption above. + * A list of Subnetwork resources whose traffic should be translated by NAT + * Gateway. It is used only when LIST_OF_SUBNETWORKS is selected for the + * SubnetworkIpRangeToNatOption above. * @type int $tcp_established_idle_timeout_sec - * Timeout (in seconds) for TCP established connections. Defaults to 1200s if not set. + * Timeout (in seconds) for TCP established connections. Defaults to 1200s + * if not set. * @type int $tcp_time_wait_timeout_sec - * Timeout (in seconds) for TCP connections that are in TIME_WAIT state. Defaults to 120s if not set. + * Timeout (in seconds) for TCP connections that are in TIME_WAIT state. + * Defaults to 120s if not set. * @type int $tcp_transitory_idle_timeout_sec - * Timeout (in seconds) for TCP transitory connections. Defaults to 30s if not set. + * Timeout (in seconds) for TCP transitory connections. Defaults to 30s if + * not set. * @type string $type - * Indicates whether this NAT is used for public or private IP translation. If unspecified, it defaults to PUBLIC. + * Indicates whether this NAT is used for public or private IP + * translation. If unspecified, it defaults to PUBLIC. * Check the Type enum for the list of possible values. * @type int $udp_idle_timeout_sec * Timeout (in seconds) for UDP connections. Defaults to 30s if not set. @@ -215,7 +347,10 @@ public function __construct($data = NULL) { } /** - * The network tier to use when automatically reserving NAT IP addresses. Must be one of: PREMIUM, STANDARD. If not specified, then the current project-level default tier is used. + * The network tier to use when automatically reserving NAT IP addresses. + * Must be one of: PREMIUM, STANDARD. + * If not specified, then the current + * project-level default tier is used. * Check the AutoNetworkTier enum for the list of possible values. * * Generated from protobuf field optional string auto_network_tier = 269770211; @@ -237,7 +372,10 @@ public function clearAutoNetworkTier() } /** - * The network tier to use when automatically reserving NAT IP addresses. Must be one of: PREMIUM, STANDARD. If not specified, then the current project-level default tier is used. + * The network tier to use when automatically reserving NAT IP addresses. + * Must be one of: PREMIUM, STANDARD. + * If not specified, then the current + * project-level default tier is used. * Check the AutoNetworkTier enum for the list of possible values. * * Generated from protobuf field optional string auto_network_tier = 269770211; @@ -253,7 +391,9 @@ public function setAutoNetworkTier($var) } /** - * A list of URLs of the IP resources to be drained. These IPs must be valid static external IPs that have been assigned to the NAT. These IPs should be used for updating/patching a NAT only. + * A list of URLs of the IP resources to be drained. These IPs + * must be valid static external IPs that have been assigned to the NAT. + * These IPs should be used for updating/patching a NAT only. * * Generated from protobuf field repeated string drain_nat_ips = 504078535; * @return \Google\Protobuf\Internal\RepeatedField @@ -264,7 +404,9 @@ public function getDrainNatIps() } /** - * A list of URLs of the IP resources to be drained. These IPs must be valid static external IPs that have been assigned to the NAT. These IPs should be used for updating/patching a NAT only. + * A list of URLs of the IP resources to be drained. These IPs + * must be valid static external IPs that have been assigned to the NAT. + * These IPs should be used for updating/patching a NAT only. * * Generated from protobuf field repeated string drain_nat_ips = 504078535; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -279,7 +421,16 @@ public function setDrainNatIps($var) } /** - * Enable Dynamic Port Allocation. If not specified, it is disabled by default. If set to true, - Dynamic Port Allocation will be enabled on this NAT config. - enableEndpointIndependentMapping cannot be set to true. - If minPorts is set, minPortsPerVm must be set to a power of two greater than or equal to 32. If minPortsPerVm is not set, a minimum of 32 ports will be allocated to a VM from this NAT config. + * Enable Dynamic Port Allocation. + * If not specified, it is disabled by default. + * If set to true, + * - Dynamic Port Allocation will be enabled on this NAT + * config. + * - enableEndpointIndependentMapping cannot be set to true. + * - If minPorts is set, minPortsPerVm must be set to a + * power of two greater than or equal to 32. If minPortsPerVm is not set, a + * minimum of 32 ports will be allocated to a VM from this NAT + * config. * * Generated from protobuf field optional bool enable_dynamic_port_allocation = 532106402; * @return bool @@ -300,7 +451,16 @@ public function clearEnableDynamicPortAllocation() } /** - * Enable Dynamic Port Allocation. If not specified, it is disabled by default. If set to true, - Dynamic Port Allocation will be enabled on this NAT config. - enableEndpointIndependentMapping cannot be set to true. - If minPorts is set, minPortsPerVm must be set to a power of two greater than or equal to 32. If minPortsPerVm is not set, a minimum of 32 ports will be allocated to a VM from this NAT config. + * Enable Dynamic Port Allocation. + * If not specified, it is disabled by default. + * If set to true, + * - Dynamic Port Allocation will be enabled on this NAT + * config. + * - enableEndpointIndependentMapping cannot be set to true. + * - If minPorts is set, minPortsPerVm must be set to a + * power of two greater than or equal to 32. If minPortsPerVm is not set, a + * minimum of 32 ports will be allocated to a VM from this NAT + * config. * * Generated from protobuf field optional bool enable_dynamic_port_allocation = 532106402; * @param bool $var @@ -347,7 +507,8 @@ public function setEnableEndpointIndependentMapping($var) } /** - * List of NAT-ted endpoint types supported by the Nat Gateway. If the list is empty, then it will be equivalent to include ENDPOINT_TYPE_VM + * List of NAT-ted endpoint types supported by the Nat Gateway. If the list + * is empty, then it will be equivalent to include ENDPOINT_TYPE_VM * Check the EndpointTypes enum for the list of possible values. * * Generated from protobuf field repeated string endpoint_types = 502633807; @@ -359,7 +520,8 @@ public function getEndpointTypes() } /** - * List of NAT-ted endpoint types supported by the Nat Gateway. If the list is empty, then it will be equivalent to include ENDPOINT_TYPE_VM + * List of NAT-ted endpoint types supported by the Nat Gateway. If the list + * is empty, then it will be equivalent to include ENDPOINT_TYPE_VM * Check the EndpointTypes enum for the list of possible values. * * Generated from protobuf field repeated string endpoint_types = 502633807; @@ -447,7 +609,15 @@ public function setLogConfig($var) } /** - * Maximum number of ports allocated to a VM from this NAT config when Dynamic Port Allocation is enabled. If Dynamic Port Allocation is not enabled, this field has no effect. If Dynamic Port Allocation is enabled, and this field is set, it must be set to a power of two greater than minPortsPerVm, or 64 if minPortsPerVm is not set. If Dynamic Port Allocation is enabled and this field is not set, a maximum of 65536 ports will be allocated to a VM from this NAT config. + * Maximum number of ports allocated to a VM from this NAT config when + * Dynamic Port Allocation is enabled. + * If Dynamic Port Allocation is not enabled, this field has no effect. + * If Dynamic Port Allocation is enabled, and this field is set, it must be + * set to a power of two greater than minPortsPerVm, or 64 if minPortsPerVm + * is not set. + * If Dynamic Port Allocation is enabled and this field is not set, + * a maximum of 65536 ports will be allocated to a VM from this NAT + * config. * * Generated from protobuf field optional int32 max_ports_per_vm = 250062049; * @return int @@ -468,7 +638,15 @@ public function clearMaxPortsPerVm() } /** - * Maximum number of ports allocated to a VM from this NAT config when Dynamic Port Allocation is enabled. If Dynamic Port Allocation is not enabled, this field has no effect. If Dynamic Port Allocation is enabled, and this field is set, it must be set to a power of two greater than minPortsPerVm, or 64 if minPortsPerVm is not set. If Dynamic Port Allocation is enabled and this field is not set, a maximum of 65536 ports will be allocated to a VM from this NAT config. + * Maximum number of ports allocated to a VM from this NAT config when + * Dynamic Port Allocation is enabled. + * If Dynamic Port Allocation is not enabled, this field has no effect. + * If Dynamic Port Allocation is enabled, and this field is set, it must be + * set to a power of two greater than minPortsPerVm, or 64 if minPortsPerVm + * is not set. + * If Dynamic Port Allocation is enabled and this field is not set, + * a maximum of 65536 ports will be allocated to a VM from this NAT + * config. * * Generated from protobuf field optional int32 max_ports_per_vm = 250062049; * @param int $var @@ -483,7 +661,10 @@ public function setMaxPortsPerVm($var) } /** - * Minimum number of ports allocated to a VM from this NAT config. If not set, a default number of ports is allocated to a VM. This is rounded up to the nearest power of 2. For example, if the value of this field is 50, at least 64 ports are allocated to a VM. + * Minimum number of ports allocated to a VM from this NAT config. If not + * set, a default number of ports is allocated to a VM. This is rounded + * up to the nearest power of 2. For example, if the value of this field is + * 50, at least 64 ports are allocated to a VM. * * Generated from protobuf field optional int32 min_ports_per_vm = 186193587; * @return int @@ -504,7 +685,10 @@ public function clearMinPortsPerVm() } /** - * Minimum number of ports allocated to a VM from this NAT config. If not set, a default number of ports is allocated to a VM. This is rounded up to the nearest power of 2. For example, if the value of this field is 50, at least 64 ports are allocated to a VM. + * Minimum number of ports allocated to a VM from this NAT config. If not + * set, a default number of ports is allocated to a VM. This is rounded + * up to the nearest power of 2. For example, if the value of this field is + * 50, at least 64 ports are allocated to a VM. * * Generated from protobuf field optional int32 min_ports_per_vm = 186193587; * @param int $var @@ -519,7 +703,8 @@ public function setMinPortsPerVm($var) } /** - * Unique name of this Nat service. The name must be 1-63 characters long and comply with RFC1035. + * Unique name of this Nat service. + * The name must be 1-63 characters long and comply withRFC1035. * * Generated from protobuf field optional string name = 3373707; * @return string @@ -540,7 +725,8 @@ public function clearName() } /** - * Unique name of this Nat service. The name must be 1-63 characters long and comply with RFC1035. + * Unique name of this Nat service. + * The name must be 1-63 characters long and comply withRFC1035. * * Generated from protobuf field optional string name = 3373707; * @param string $var @@ -555,7 +741,9 @@ public function setName($var) } /** - * List of Subnetwork resources whose traffic should be translated by NAT64 Gateway. It is used only when LIST_OF_IPV6_SUBNETWORKS is selected for the SubnetworkIpRangeToNat64Option above. + * List of Subnetwork resources whose traffic should be translated by NAT64 + * Gateway. It is used only when LIST_OF_IPV6_SUBNETWORKS is + * selected for the SubnetworkIpRangeToNat64Option above. * * Generated from protobuf field repeated .google.cloud.compute.v1.RouterNatSubnetworkToNat64 nat64_subnetworks = 63585701; * @return \Google\Protobuf\Internal\RepeatedField @@ -566,7 +754,9 @@ public function getNat64Subnetworks() } /** - * List of Subnetwork resources whose traffic should be translated by NAT64 Gateway. It is used only when LIST_OF_IPV6_SUBNETWORKS is selected for the SubnetworkIpRangeToNat64Option above. + * List of Subnetwork resources whose traffic should be translated by NAT64 + * Gateway. It is used only when LIST_OF_IPV6_SUBNETWORKS is + * selected for the SubnetworkIpRangeToNat64Option above. * * Generated from protobuf field repeated .google.cloud.compute.v1.RouterNatSubnetworkToNat64 nat64_subnetworks = 63585701; * @param array<\Google\Cloud\Compute\V1\RouterNatSubnetworkToNat64>|\Google\Protobuf\Internal\RepeatedField $var @@ -581,7 +771,14 @@ public function setNat64Subnetworks($var) } /** - * Specify the NatIpAllocateOption, which can take one of the following values: - MANUAL_ONLY: Uses only Nat IP addresses provided by customers. When there are not enough specified Nat IPs, the Nat service fails for new VMs. - AUTO_ONLY: Nat IPs are allocated by Google Cloud Platform; customers can't specify any Nat IPs. When choosing AUTO_ONLY, then nat_ip should be empty. + * Specify the NatIpAllocateOption, which can take one of the following + * values: + * - MANUAL_ONLY: Uses only Nat IP addresses provided by + * customers. When there are not enough specified Nat IPs, the Nat service + * fails for new VMs. + * - AUTO_ONLY: Nat IPs are allocated by Google Cloud Platform; customers + * can't specify any Nat IPs. When choosing AUTO_ONLY, then nat_ip should + * be empty. * Check the NatIpAllocateOption enum for the list of possible values. * * Generated from protobuf field optional string nat_ip_allocate_option = 429726845; @@ -603,7 +800,14 @@ public function clearNatIpAllocateOption() } /** - * Specify the NatIpAllocateOption, which can take one of the following values: - MANUAL_ONLY: Uses only Nat IP addresses provided by customers. When there are not enough specified Nat IPs, the Nat service fails for new VMs. - AUTO_ONLY: Nat IPs are allocated by Google Cloud Platform; customers can't specify any Nat IPs. When choosing AUTO_ONLY, then nat_ip should be empty. + * Specify the NatIpAllocateOption, which can take one of the following + * values: + * - MANUAL_ONLY: Uses only Nat IP addresses provided by + * customers. When there are not enough specified Nat IPs, the Nat service + * fails for new VMs. + * - AUTO_ONLY: Nat IPs are allocated by Google Cloud Platform; customers + * can't specify any Nat IPs. When choosing AUTO_ONLY, then nat_ip should + * be empty. * Check the NatIpAllocateOption enum for the list of possible values. * * Generated from protobuf field optional string nat_ip_allocate_option = 429726845; @@ -619,7 +823,9 @@ public function setNatIpAllocateOption($var) } /** - * A list of URLs of the IP resources used for this Nat service. These IP addresses must be valid static external IP addresses assigned to the project. + * A list of URLs of the IP resources used for this Nat service. These IP + * addresses must be valid static external IP addresses assigned to the + * project. * * Generated from protobuf field repeated string nat_ips = 117635086; * @return \Google\Protobuf\Internal\RepeatedField @@ -630,7 +836,9 @@ public function getNatIps() } /** - * A list of URLs of the IP resources used for this Nat service. These IP addresses must be valid static external IP addresses assigned to the project. + * A list of URLs of the IP resources used for this Nat service. These IP + * addresses must be valid static external IP addresses assigned to the + * project. * * Generated from protobuf field repeated string nat_ips = 117635086; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -671,7 +879,17 @@ public function setRules($var) } /** - * Specify the Nat option, which can take one of the following values: - ALL_SUBNETWORKS_ALL_IP_RANGES: All of the IP ranges in every Subnetwork are allowed to Nat. - ALL_SUBNETWORKS_ALL_PRIMARY_IP_RANGES: All of the primary IP ranges in every Subnetwork are allowed to Nat. - LIST_OF_SUBNETWORKS: A list of Subnetworks are allowed to Nat (specified in the field subnetwork below) The default is SUBNETWORK_IP_RANGE_TO_NAT_OPTION_UNSPECIFIED. Note that if this field contains ALL_SUBNETWORKS_ALL_IP_RANGES then there should not be any other Router.Nat section in any Router for this network in this region. + * Specify the Nat option, which can take one of the following values: + * - ALL_SUBNETWORKS_ALL_IP_RANGES: All of the IP ranges in every + * Subnetwork are allowed to Nat. + * - ALL_SUBNETWORKS_ALL_PRIMARY_IP_RANGES: All of the primary IP ranges + * in every Subnetwork are allowed to Nat. + * - LIST_OF_SUBNETWORKS: A list of Subnetworks are allowed to Nat + * (specified in the field subnetwork below) + * The default is SUBNETWORK_IP_RANGE_TO_NAT_OPTION_UNSPECIFIED. + * Note that if this field contains ALL_SUBNETWORKS_ALL_IP_RANGES then there + * should not be any other Router.Nat section in any Router for this network + * in this region. * Check the SourceSubnetworkIpRangesToNat enum for the list of possible values. * * Generated from protobuf field optional string source_subnetwork_ip_ranges_to_nat = 252213211; @@ -693,7 +911,17 @@ public function clearSourceSubnetworkIpRangesToNat() } /** - * Specify the Nat option, which can take one of the following values: - ALL_SUBNETWORKS_ALL_IP_RANGES: All of the IP ranges in every Subnetwork are allowed to Nat. - ALL_SUBNETWORKS_ALL_PRIMARY_IP_RANGES: All of the primary IP ranges in every Subnetwork are allowed to Nat. - LIST_OF_SUBNETWORKS: A list of Subnetworks are allowed to Nat (specified in the field subnetwork below) The default is SUBNETWORK_IP_RANGE_TO_NAT_OPTION_UNSPECIFIED. Note that if this field contains ALL_SUBNETWORKS_ALL_IP_RANGES then there should not be any other Router.Nat section in any Router for this network in this region. + * Specify the Nat option, which can take one of the following values: + * - ALL_SUBNETWORKS_ALL_IP_RANGES: All of the IP ranges in every + * Subnetwork are allowed to Nat. + * - ALL_SUBNETWORKS_ALL_PRIMARY_IP_RANGES: All of the primary IP ranges + * in every Subnetwork are allowed to Nat. + * - LIST_OF_SUBNETWORKS: A list of Subnetworks are allowed to Nat + * (specified in the field subnetwork below) + * The default is SUBNETWORK_IP_RANGE_TO_NAT_OPTION_UNSPECIFIED. + * Note that if this field contains ALL_SUBNETWORKS_ALL_IP_RANGES then there + * should not be any other Router.Nat section in any Router for this network + * in this region. * Check the SourceSubnetworkIpRangesToNat enum for the list of possible values. * * Generated from protobuf field optional string source_subnetwork_ip_ranges_to_nat = 252213211; @@ -709,7 +937,17 @@ public function setSourceSubnetworkIpRangesToNat($var) } /** - * Specify the Nat option for NAT64, which can take one of the following values: - ALL_IPV6_SUBNETWORKS: All of the IP ranges in every Subnetwork are allowed to Nat. - LIST_OF_IPV6_SUBNETWORKS: A list of Subnetworks are allowed to Nat (specified in the field nat64_subnetwork below) The default is NAT64_OPTION_UNSPECIFIED. Note that if this field contains NAT64_ALL_V6_SUBNETWORKS no other Router.Nat section in this region can also enable NAT64 for any Subnetworks in this network. Other Router.Nat sections can still be present to enable NAT44 only. + * Specify the Nat option for NAT64, which can take one of the following + * values: + * - ALL_IPV6_SUBNETWORKS: All of the IP ranges in + * every Subnetwork are allowed to Nat. + * - LIST_OF_IPV6_SUBNETWORKS: A list of Subnetworks are allowed to Nat + * (specified in the field nat64_subnetwork below) + * The default is NAT64_OPTION_UNSPECIFIED. + * Note that if this field contains NAT64_ALL_V6_SUBNETWORKS no other + * Router.Nat section in this region can also enable NAT64 for any + * Subnetworks in this network. Other Router.Nat sections can still be + * present to enable NAT44 only. * Check the SourceSubnetworkIpRangesToNat64 enum for the list of possible values. * * Generated from protobuf field optional string source_subnetwork_ip_ranges_to_nat64 = 248116185; @@ -731,7 +969,17 @@ public function clearSourceSubnetworkIpRangesToNat64() } /** - * Specify the Nat option for NAT64, which can take one of the following values: - ALL_IPV6_SUBNETWORKS: All of the IP ranges in every Subnetwork are allowed to Nat. - LIST_OF_IPV6_SUBNETWORKS: A list of Subnetworks are allowed to Nat (specified in the field nat64_subnetwork below) The default is NAT64_OPTION_UNSPECIFIED. Note that if this field contains NAT64_ALL_V6_SUBNETWORKS no other Router.Nat section in this region can also enable NAT64 for any Subnetworks in this network. Other Router.Nat sections can still be present to enable NAT44 only. + * Specify the Nat option for NAT64, which can take one of the following + * values: + * - ALL_IPV6_SUBNETWORKS: All of the IP ranges in + * every Subnetwork are allowed to Nat. + * - LIST_OF_IPV6_SUBNETWORKS: A list of Subnetworks are allowed to Nat + * (specified in the field nat64_subnetwork below) + * The default is NAT64_OPTION_UNSPECIFIED. + * Note that if this field contains NAT64_ALL_V6_SUBNETWORKS no other + * Router.Nat section in this region can also enable NAT64 for any + * Subnetworks in this network. Other Router.Nat sections can still be + * present to enable NAT44 only. * Check the SourceSubnetworkIpRangesToNat64 enum for the list of possible values. * * Generated from protobuf field optional string source_subnetwork_ip_ranges_to_nat64 = 248116185; @@ -747,7 +995,9 @@ public function setSourceSubnetworkIpRangesToNat64($var) } /** - * A list of Subnetwork resources whose traffic should be translated by NAT Gateway. It is used only when LIST_OF_SUBNETWORKS is selected for the SubnetworkIpRangeToNatOption above. + * A list of Subnetwork resources whose traffic should be translated by NAT + * Gateway. It is used only when LIST_OF_SUBNETWORKS is selected for the + * SubnetworkIpRangeToNatOption above. * * Generated from protobuf field repeated .google.cloud.compute.v1.RouterNatSubnetworkToNat subnetworks = 415853125; * @return \Google\Protobuf\Internal\RepeatedField @@ -758,7 +1008,9 @@ public function getSubnetworks() } /** - * A list of Subnetwork resources whose traffic should be translated by NAT Gateway. It is used only when LIST_OF_SUBNETWORKS is selected for the SubnetworkIpRangeToNatOption above. + * A list of Subnetwork resources whose traffic should be translated by NAT + * Gateway. It is used only when LIST_OF_SUBNETWORKS is selected for the + * SubnetworkIpRangeToNatOption above. * * Generated from protobuf field repeated .google.cloud.compute.v1.RouterNatSubnetworkToNat subnetworks = 415853125; * @param array<\Google\Cloud\Compute\V1\RouterNatSubnetworkToNat>|\Google\Protobuf\Internal\RepeatedField $var @@ -773,7 +1025,8 @@ public function setSubnetworks($var) } /** - * Timeout (in seconds) for TCP established connections. Defaults to 1200s if not set. + * Timeout (in seconds) for TCP established connections. Defaults to 1200s + * if not set. * * Generated from protobuf field optional int32 tcp_established_idle_timeout_sec = 223098349; * @return int @@ -794,7 +1047,8 @@ public function clearTcpEstablishedIdleTimeoutSec() } /** - * Timeout (in seconds) for TCP established connections. Defaults to 1200s if not set. + * Timeout (in seconds) for TCP established connections. Defaults to 1200s + * if not set. * * Generated from protobuf field optional int32 tcp_established_idle_timeout_sec = 223098349; * @param int $var @@ -809,7 +1063,8 @@ public function setTcpEstablishedIdleTimeoutSec($var) } /** - * Timeout (in seconds) for TCP connections that are in TIME_WAIT state. Defaults to 120s if not set. + * Timeout (in seconds) for TCP connections that are in TIME_WAIT state. + * Defaults to 120s if not set. * * Generated from protobuf field optional int32 tcp_time_wait_timeout_sec = 513596925; * @return int @@ -830,7 +1085,8 @@ public function clearTcpTimeWaitTimeoutSec() } /** - * Timeout (in seconds) for TCP connections that are in TIME_WAIT state. Defaults to 120s if not set. + * Timeout (in seconds) for TCP connections that are in TIME_WAIT state. + * Defaults to 120s if not set. * * Generated from protobuf field optional int32 tcp_time_wait_timeout_sec = 513596925; * @param int $var @@ -845,7 +1101,8 @@ public function setTcpTimeWaitTimeoutSec($var) } /** - * Timeout (in seconds) for TCP transitory connections. Defaults to 30s if not set. + * Timeout (in seconds) for TCP transitory connections. Defaults to 30s if + * not set. * * Generated from protobuf field optional int32 tcp_transitory_idle_timeout_sec = 205028774; * @return int @@ -866,7 +1123,8 @@ public function clearTcpTransitoryIdleTimeoutSec() } /** - * Timeout (in seconds) for TCP transitory connections. Defaults to 30s if not set. + * Timeout (in seconds) for TCP transitory connections. Defaults to 30s if + * not set. * * Generated from protobuf field optional int32 tcp_transitory_idle_timeout_sec = 205028774; * @param int $var @@ -881,7 +1139,8 @@ public function setTcpTransitoryIdleTimeoutSec($var) } /** - * Indicates whether this NAT is used for public or private IP translation. If unspecified, it defaults to PUBLIC. + * Indicates whether this NAT is used for public or private IP + * translation. If unspecified, it defaults to PUBLIC. * Check the Type enum for the list of possible values. * * Generated from protobuf field optional string type = 3575610; @@ -903,7 +1162,8 @@ public function clearType() } /** - * Indicates whether this NAT is used for public or private IP translation. If unspecified, it defaults to PUBLIC. + * Indicates whether this NAT is used for public or private IP + * translation. If unspecified, it defaults to PUBLIC. * Check the Type enum for the list of possible values. * * Generated from protobuf field optional string type = 3575610; diff --git a/Compute/src/V1/RouterNat/AutoNetworkTier.php b/Compute/src/V1/RouterNat/AutoNetworkTier.php index 24dbbe9c103b..1ecb36708802 100644 --- a/Compute/src/V1/RouterNat/AutoNetworkTier.php +++ b/Compute/src/V1/RouterNat/AutoNetworkTier.php @@ -7,7 +7,10 @@ use UnexpectedValueException; /** - * The network tier to use when automatically reserving NAT IP addresses. Must be one of: PREMIUM, STANDARD. If not specified, then the current project-level default tier is used. + * The network tier to use when automatically reserving NAT IP addresses. + * Must be one of: PREMIUM, STANDARD. + * If not specified, then the current + * project-level default tier is used. * * Protobuf type google.cloud.compute.v1.RouterNat.AutoNetworkTier */ @@ -26,19 +29,22 @@ class AutoNetworkTier */ const FIXED_STANDARD = 310464328; /** - * High quality, Google-grade network tier, support for all networking products. + * High quality, Google-grade network tier, support for all networking + * products. * * Generated from protobuf enum PREMIUM = 399530551; */ const PREMIUM = 399530551; /** - * Public internet quality, only limited support for other networking products. + * Public internet quality, only limited support for other networking + * products. * * Generated from protobuf enum STANDARD = 484642493; */ const STANDARD = 484642493; /** - * (Output only) Temporary tier for FIXED_STANDARD when fixed standard tier is expired or not configured. + * (Output only) Temporary tier for FIXED_STANDARD when fixed standard tier + * is expired or not configured. * * Generated from protobuf enum STANDARD_OVERRIDES_FIXED_STANDARD = 465847234; */ diff --git a/Compute/src/V1/RouterNat/EndpointTypes.php b/Compute/src/V1/RouterNat/EndpointTypes.php index 286121d927c9..2607519f434d 100644 --- a/Compute/src/V1/RouterNat/EndpointTypes.php +++ b/Compute/src/V1/RouterNat/EndpointTypes.php @@ -19,7 +19,9 @@ class EndpointTypes */ const UNDEFINED_ENDPOINT_TYPES = 0; /** - * This is used for regional Application Load Balancers (internal and external) and regional proxy Network Load Balancers (internal and external) endpoints. + * This is used for regional Application Load Balancers (internal and + * external) and regional proxy Network Load Balancers (internal and + * external) endpoints. * * Generated from protobuf enum ENDPOINT_TYPE_MANAGED_PROXY_LB = 439196930; */ diff --git a/Compute/src/V1/RouterNat/NatIpAllocateOption.php b/Compute/src/V1/RouterNat/NatIpAllocateOption.php index aee203951b65..2e7a0dc4be55 100644 --- a/Compute/src/V1/RouterNat/NatIpAllocateOption.php +++ b/Compute/src/V1/RouterNat/NatIpAllocateOption.php @@ -7,7 +7,14 @@ use UnexpectedValueException; /** - * Specify the NatIpAllocateOption, which can take one of the following values: - MANUAL_ONLY: Uses only Nat IP addresses provided by customers. When there are not enough specified Nat IPs, the Nat service fails for new VMs. - AUTO_ONLY: Nat IPs are allocated by Google Cloud Platform; customers can't specify any Nat IPs. When choosing AUTO_ONLY, then nat_ip should be empty. + * Specify the NatIpAllocateOption, which can take one of the following + * values: + * - MANUAL_ONLY: Uses only Nat IP addresses provided by + * customers. When there are not enough specified Nat IPs, the Nat service + * fails for new VMs. + * - AUTO_ONLY: Nat IPs are allocated by Google Cloud Platform; customers + * can't specify any Nat IPs. When choosing AUTO_ONLY, then nat_ip should + * be empty. * * Protobuf type google.cloud.compute.v1.RouterNat.NatIpAllocateOption */ @@ -26,7 +33,8 @@ class NatIpAllocateOption */ const AUTO_ONLY = 182333500; /** - * Only use Nat IPs provided by customers. When specified Nat IPs are not enough then the Nat service fails for new VMs. + * Only use Nat IPs provided by customers. When specified Nat IPs are not + * enough then the Nat service fails for new VMs. * * Generated from protobuf enum MANUAL_ONLY = 261251205; */ diff --git a/Compute/src/V1/RouterNat/SourceSubnetworkIpRangesToNat.php b/Compute/src/V1/RouterNat/SourceSubnetworkIpRangesToNat.php index a4d25b5f41d6..235a8af81162 100644 --- a/Compute/src/V1/RouterNat/SourceSubnetworkIpRangesToNat.php +++ b/Compute/src/V1/RouterNat/SourceSubnetworkIpRangesToNat.php @@ -7,7 +7,17 @@ use UnexpectedValueException; /** - * Specify the Nat option, which can take one of the following values: - ALL_SUBNETWORKS_ALL_IP_RANGES: All of the IP ranges in every Subnetwork are allowed to Nat. - ALL_SUBNETWORKS_ALL_PRIMARY_IP_RANGES: All of the primary IP ranges in every Subnetwork are allowed to Nat. - LIST_OF_SUBNETWORKS: A list of Subnetworks are allowed to Nat (specified in the field subnetwork below) The default is SUBNETWORK_IP_RANGE_TO_NAT_OPTION_UNSPECIFIED. Note that if this field contains ALL_SUBNETWORKS_ALL_IP_RANGES then there should not be any other Router.Nat section in any Router for this network in this region. + * Specify the Nat option, which can take one of the following values: + * - ALL_SUBNETWORKS_ALL_IP_RANGES: All of the IP ranges in every + * Subnetwork are allowed to Nat. + * - ALL_SUBNETWORKS_ALL_PRIMARY_IP_RANGES: All of the primary IP ranges + * in every Subnetwork are allowed to Nat. + * - LIST_OF_SUBNETWORKS: A list of Subnetworks are allowed to Nat + * (specified in the field subnetwork below) + * The default is SUBNETWORK_IP_RANGE_TO_NAT_OPTION_UNSPECIFIED. + * Note that if this field contains ALL_SUBNETWORKS_ALL_IP_RANGES then there + * should not be any other Router.Nat section in any Router for this network + * in this region. * * Protobuf type google.cloud.compute.v1.RouterNat.SourceSubnetworkIpRangesToNat */ @@ -32,7 +42,8 @@ class SourceSubnetworkIpRangesToNat */ const ALL_SUBNETWORKS_ALL_PRIMARY_IP_RANGES = 185573819; /** - * A list of Subnetworks are allowed to Nat (specified in the field subnetwork below) + * A list of Subnetworks are allowed to Nat (specified in the field + * subnetwork below) * * Generated from protobuf enum LIST_OF_SUBNETWORKS = 517542270; */ diff --git a/Compute/src/V1/RouterNat/SourceSubnetworkIpRangesToNat64.php b/Compute/src/V1/RouterNat/SourceSubnetworkIpRangesToNat64.php index 3caa04f3f6be..2ce0164044c8 100644 --- a/Compute/src/V1/RouterNat/SourceSubnetworkIpRangesToNat64.php +++ b/Compute/src/V1/RouterNat/SourceSubnetworkIpRangesToNat64.php @@ -7,7 +7,17 @@ use UnexpectedValueException; /** - * Specify the Nat option for NAT64, which can take one of the following values: - ALL_IPV6_SUBNETWORKS: All of the IP ranges in every Subnetwork are allowed to Nat. - LIST_OF_IPV6_SUBNETWORKS: A list of Subnetworks are allowed to Nat (specified in the field nat64_subnetwork below) The default is NAT64_OPTION_UNSPECIFIED. Note that if this field contains NAT64_ALL_V6_SUBNETWORKS no other Router.Nat section in this region can also enable NAT64 for any Subnetworks in this network. Other Router.Nat sections can still be present to enable NAT44 only. + * Specify the Nat option for NAT64, which can take one of the following + * values: + * - ALL_IPV6_SUBNETWORKS: All of the IP ranges in + * every Subnetwork are allowed to Nat. + * - LIST_OF_IPV6_SUBNETWORKS: A list of Subnetworks are allowed to Nat + * (specified in the field nat64_subnetwork below) + * The default is NAT64_OPTION_UNSPECIFIED. + * Note that if this field contains NAT64_ALL_V6_SUBNETWORKS no other + * Router.Nat section in this region can also enable NAT64 for any + * Subnetworks in this network. Other Router.Nat sections can still be + * present to enable NAT44 only. * * Protobuf type google.cloud.compute.v1.RouterNat.SourceSubnetworkIpRangesToNat64 */ @@ -20,13 +30,16 @@ class SourceSubnetworkIpRangesToNat64 */ const UNDEFINED_SOURCE_SUBNETWORK_IP_RANGES_TO_NAT64 = 0; /** - * NAT64 is enabled for all the IPv6 subnet ranges. In dual stack subnets, NAT64 will only be enabled for IPv6-only VMs. + * NAT64 is enabled for all the IPv6 subnet ranges. + * In dual stack subnets, NAT64 will only be enabled for IPv6-only VMs. * * Generated from protobuf enum ALL_IPV6_SUBNETWORKS = 341632747; */ const ALL_IPV6_SUBNETWORKS = 341632747; /** - * NAT64 is enabled for a list of IPv6 subnet ranges. In dual stack subnets, NAT64 will only be enabled for IPv6-only VMs. If this option is used, the nat64_subnetworks field must be specified. + * NAT64 is enabled for a list of IPv6 subnet ranges. + * In dual stack subnets, NAT64 will only be enabled for IPv6-only VMs. + * If this option is used, the nat64_subnetworks field must be specified. * * Generated from protobuf enum LIST_OF_IPV6_SUBNETWORKS = 521079860; */ diff --git a/Compute/src/V1/RouterNat/Type.php b/Compute/src/V1/RouterNat/Type.php index 53837848ec14..24d33d60d019 100644 --- a/Compute/src/V1/RouterNat/Type.php +++ b/Compute/src/V1/RouterNat/Type.php @@ -7,7 +7,8 @@ use UnexpectedValueException; /** - * Indicates whether this NAT is used for public or private IP translation. If unspecified, it defaults to PUBLIC. + * Indicates whether this NAT is used for public or private IP + * translation. If unspecified, it defaults to PUBLIC. * * Protobuf type google.cloud.compute.v1.RouterNat.Type */ @@ -26,7 +27,8 @@ class Type */ const PBPRIVATE = 403485027; /** - * NAT used for public IP translation. This is the default. + * NAT used for public IP translation. + * This is the default. * * Generated from protobuf enum PUBLIC = 223389289; */ diff --git a/Compute/src/V1/RouterNatLogConfig.php b/Compute/src/V1/RouterNatLogConfig.php index 648fda471b86..d3b8f0fe62c3 100644 --- a/Compute/src/V1/RouterNatLogConfig.php +++ b/Compute/src/V1/RouterNatLogConfig.php @@ -22,7 +22,14 @@ class RouterNatLogConfig extends \Google\Protobuf\Internal\Message */ protected $enable = null; /** - * Specify the desired filtering of logs on this NAT. If unspecified, logs are exported for all connections handled by this NAT. This option can take one of the following values: - ERRORS_ONLY: Export logs only for connection failures. - TRANSLATIONS_ONLY: Export logs only for successful connections. - ALL: Export logs for all connections, successful and unsuccessful. + * Specify the desired filtering of logs on this NAT. If unspecified, + * logs are exported for all connections handled by this NAT. + * This option can take one of the following values: + * - ERRORS_ONLY: Export logs only for connection failures. + * - TRANSLATIONS_ONLY: Export logs only for successful + * connections. + * - ALL: Export logs for all connections, successful and + * unsuccessful. * Check the Filter enum for the list of possible values. * * Generated from protobuf field optional string filter = 336120696; @@ -38,7 +45,14 @@ class RouterNatLogConfig extends \Google\Protobuf\Internal\Message * @type bool $enable * Indicates whether or not to export logs. This is false by default. * @type string $filter - * Specify the desired filtering of logs on this NAT. If unspecified, logs are exported for all connections handled by this NAT. This option can take one of the following values: - ERRORS_ONLY: Export logs only for connection failures. - TRANSLATIONS_ONLY: Export logs only for successful connections. - ALL: Export logs for all connections, successful and unsuccessful. + * Specify the desired filtering of logs on this NAT. If unspecified, + * logs are exported for all connections handled by this NAT. + * This option can take one of the following values: + * - ERRORS_ONLY: Export logs only for connection failures. + * - TRANSLATIONS_ONLY: Export logs only for successful + * connections. + * - ALL: Export logs for all connections, successful and + * unsuccessful. * Check the Filter enum for the list of possible values. * } */ @@ -84,7 +98,14 @@ public function setEnable($var) } /** - * Specify the desired filtering of logs on this NAT. If unspecified, logs are exported for all connections handled by this NAT. This option can take one of the following values: - ERRORS_ONLY: Export logs only for connection failures. - TRANSLATIONS_ONLY: Export logs only for successful connections. - ALL: Export logs for all connections, successful and unsuccessful. + * Specify the desired filtering of logs on this NAT. If unspecified, + * logs are exported for all connections handled by this NAT. + * This option can take one of the following values: + * - ERRORS_ONLY: Export logs only for connection failures. + * - TRANSLATIONS_ONLY: Export logs only for successful + * connections. + * - ALL: Export logs for all connections, successful and + * unsuccessful. * Check the Filter enum for the list of possible values. * * Generated from protobuf field optional string filter = 336120696; @@ -106,7 +127,14 @@ public function clearFilter() } /** - * Specify the desired filtering of logs on this NAT. If unspecified, logs are exported for all connections handled by this NAT. This option can take one of the following values: - ERRORS_ONLY: Export logs only for connection failures. - TRANSLATIONS_ONLY: Export logs only for successful connections. - ALL: Export logs for all connections, successful and unsuccessful. + * Specify the desired filtering of logs on this NAT. If unspecified, + * logs are exported for all connections handled by this NAT. + * This option can take one of the following values: + * - ERRORS_ONLY: Export logs only for connection failures. + * - TRANSLATIONS_ONLY: Export logs only for successful + * connections. + * - ALL: Export logs for all connections, successful and + * unsuccessful. * Check the Filter enum for the list of possible values. * * Generated from protobuf field optional string filter = 336120696; diff --git a/Compute/src/V1/RouterNatLogConfig/Filter.php b/Compute/src/V1/RouterNatLogConfig/Filter.php index c44ddade8781..f96cae986ca8 100644 --- a/Compute/src/V1/RouterNatLogConfig/Filter.php +++ b/Compute/src/V1/RouterNatLogConfig/Filter.php @@ -7,7 +7,14 @@ use UnexpectedValueException; /** - * Specify the desired filtering of logs on this NAT. If unspecified, logs are exported for all connections handled by this NAT. This option can take one of the following values: - ERRORS_ONLY: Export logs only for connection failures. - TRANSLATIONS_ONLY: Export logs only for successful connections. - ALL: Export logs for all connections, successful and unsuccessful. + * Specify the desired filtering of logs on this NAT. If unspecified, + * logs are exported for all connections handled by this NAT. + * This option can take one of the following values: + * - ERRORS_ONLY: Export logs only for connection failures. + * - TRANSLATIONS_ONLY: Export logs only for successful + * connections. + * - ALL: Export logs for all connections, successful and + * unsuccessful. * * Protobuf type google.cloud.compute.v1.RouterNatLogConfig.Filter */ diff --git a/Compute/src/V1/RouterNatRule.php b/Compute/src/V1/RouterNatRule.php index 28a3770f927c..a3df8cc793e6 100644 --- a/Compute/src/V1/RouterNatRule.php +++ b/Compute/src/V1/RouterNatRule.php @@ -27,13 +27,24 @@ class RouterNatRule extends \Google\Protobuf\Internal\Message */ protected $description = null; /** - * CEL expression that specifies the match condition that egress traffic from a VM is evaluated against. If it evaluates to true, the corresponding `action` is enforced. The following examples are valid match expressions for public NAT: `inIpRange(destination.ip, '1.1.0.0/16') || inIpRange(destination.ip, '2.2.0.0/16')` `destination.ip == '1.1.0.1' || destination.ip == '8.8.8.8'` The following example is a valid match expression for private NAT: `nexthop.hub == '//networkconnectivity.googleapis.com/projects/my-project/locations/global/hubs/hub-1'` + * CEL expression that specifies the match condition that egress traffic + * from a VM is evaluated against. If it evaluates to true, the + * corresponding `action` is enforced. + * The following examples are valid match expressions for public NAT: + * `inIpRange(destination.ip, '1.1.0.0/16') || inIpRange(destination.ip, + * '2.2.0.0/16')` + * `destination.ip == '1.1.0.1' || destination.ip == '8.8.8.8'` + * The following example is a valid match expression for private NAT: + * `nexthop.hub == + * '//networkconnectivity.googleapis.com/projects/my-project/locations/global/hubs/hub-1'` * * Generated from protobuf field optional string match = 103668165; */ protected $match = null; /** - * An integer uniquely identifying a rule in the list. The rule number must be a positive value between 0 and 65000, and must be unique among rules within a NAT. + * An integer uniquely identifying a rule in the list. The rule number + * must be a positive value between 0 and 65000, and + * must be unique among rules within a NAT. * * Generated from protobuf field optional uint32 rule_number = 535211500; */ @@ -50,9 +61,20 @@ class RouterNatRule extends \Google\Protobuf\Internal\Message * @type string $description * An optional description of this rule. * @type string $match - * CEL expression that specifies the match condition that egress traffic from a VM is evaluated against. If it evaluates to true, the corresponding `action` is enforced. The following examples are valid match expressions for public NAT: `inIpRange(destination.ip, '1.1.0.0/16') || inIpRange(destination.ip, '2.2.0.0/16')` `destination.ip == '1.1.0.1' || destination.ip == '8.8.8.8'` The following example is a valid match expression for private NAT: `nexthop.hub == '//networkconnectivity.googleapis.com/projects/my-project/locations/global/hubs/hub-1'` + * CEL expression that specifies the match condition that egress traffic + * from a VM is evaluated against. If it evaluates to true, the + * corresponding `action` is enforced. + * The following examples are valid match expressions for public NAT: + * `inIpRange(destination.ip, '1.1.0.0/16') || inIpRange(destination.ip, + * '2.2.0.0/16')` + * `destination.ip == '1.1.0.1' || destination.ip == '8.8.8.8'` + * The following example is a valid match expression for private NAT: + * `nexthop.hub == + * '//networkconnectivity.googleapis.com/projects/my-project/locations/global/hubs/hub-1'` * @type int $rule_number - * An integer uniquely identifying a rule in the list. The rule number must be a positive value between 0 and 65000, and must be unique among rules within a NAT. + * An integer uniquely identifying a rule in the list. The rule number + * must be a positive value between 0 and 65000, and + * must be unique among rules within a NAT. * } */ public function __construct($data = NULL) { @@ -133,7 +155,16 @@ public function setDescription($var) } /** - * CEL expression that specifies the match condition that egress traffic from a VM is evaluated against. If it evaluates to true, the corresponding `action` is enforced. The following examples are valid match expressions for public NAT: `inIpRange(destination.ip, '1.1.0.0/16') || inIpRange(destination.ip, '2.2.0.0/16')` `destination.ip == '1.1.0.1' || destination.ip == '8.8.8.8'` The following example is a valid match expression for private NAT: `nexthop.hub == '//networkconnectivity.googleapis.com/projects/my-project/locations/global/hubs/hub-1'` + * CEL expression that specifies the match condition that egress traffic + * from a VM is evaluated against. If it evaluates to true, the + * corresponding `action` is enforced. + * The following examples are valid match expressions for public NAT: + * `inIpRange(destination.ip, '1.1.0.0/16') || inIpRange(destination.ip, + * '2.2.0.0/16')` + * `destination.ip == '1.1.0.1' || destination.ip == '8.8.8.8'` + * The following example is a valid match expression for private NAT: + * `nexthop.hub == + * '//networkconnectivity.googleapis.com/projects/my-project/locations/global/hubs/hub-1'` * * Generated from protobuf field optional string match = 103668165; * @return string @@ -154,7 +185,16 @@ public function clearMatch() } /** - * CEL expression that specifies the match condition that egress traffic from a VM is evaluated against. If it evaluates to true, the corresponding `action` is enforced. The following examples are valid match expressions for public NAT: `inIpRange(destination.ip, '1.1.0.0/16') || inIpRange(destination.ip, '2.2.0.0/16')` `destination.ip == '1.1.0.1' || destination.ip == '8.8.8.8'` The following example is a valid match expression for private NAT: `nexthop.hub == '//networkconnectivity.googleapis.com/projects/my-project/locations/global/hubs/hub-1'` + * CEL expression that specifies the match condition that egress traffic + * from a VM is evaluated against. If it evaluates to true, the + * corresponding `action` is enforced. + * The following examples are valid match expressions for public NAT: + * `inIpRange(destination.ip, '1.1.0.0/16') || inIpRange(destination.ip, + * '2.2.0.0/16')` + * `destination.ip == '1.1.0.1' || destination.ip == '8.8.8.8'` + * The following example is a valid match expression for private NAT: + * `nexthop.hub == + * '//networkconnectivity.googleapis.com/projects/my-project/locations/global/hubs/hub-1'` * * Generated from protobuf field optional string match = 103668165; * @param string $var @@ -169,7 +209,9 @@ public function setMatch($var) } /** - * An integer uniquely identifying a rule in the list. The rule number must be a positive value between 0 and 65000, and must be unique among rules within a NAT. + * An integer uniquely identifying a rule in the list. The rule number + * must be a positive value between 0 and 65000, and + * must be unique among rules within a NAT. * * Generated from protobuf field optional uint32 rule_number = 535211500; * @return int @@ -190,7 +232,9 @@ public function clearRuleNumber() } /** - * An integer uniquely identifying a rule in the list. The rule number must be a positive value between 0 and 65000, and must be unique among rules within a NAT. + * An integer uniquely identifying a rule in the list. The rule number + * must be a positive value between 0 and 65000, and + * must be unique among rules within a NAT. * * Generated from protobuf field optional uint32 rule_number = 535211500; * @param int $var diff --git a/Compute/src/V1/RouterNatRuleAction.php b/Compute/src/V1/RouterNatRuleAction.php index 9df7747c7cde..31c168f2a0ef 100644 --- a/Compute/src/V1/RouterNatRuleAction.php +++ b/Compute/src/V1/RouterNatRuleAction.php @@ -15,25 +15,37 @@ class RouterNatRuleAction extends \Google\Protobuf\Internal\Message { /** - * A list of URLs of the IP resources used for this NAT rule. These IP addresses must be valid static external IP addresses assigned to the project. This field is used for public NAT. + * A list of URLs of the IP resources used for this NAT rule. These IP + * addresses must be valid static external IP addresses assigned to the + * project. + * This field is used for public NAT. * * Generated from protobuf field repeated string source_nat_active_ips = 210378229; */ private $source_nat_active_ips; /** - * A list of URLs of the subnetworks used as source ranges for this NAT Rule. These subnetworks must have purpose set to PRIVATE_NAT. This field is used for private NAT. + * A list of URLs of the subnetworks used as source ranges for this + * NAT Rule. These subnetworks must have purpose set to PRIVATE_NAT. + * This field is used for private NAT. * * Generated from protobuf field repeated string source_nat_active_ranges = 190556269; */ private $source_nat_active_ranges; /** - * A list of URLs of the IP resources to be drained. These IPs must be valid static external IPs that have been assigned to the NAT. These IPs should be used for updating/patching a NAT rule only. This field is used for public NAT. + * A list of URLs of the IP resources to be drained. These IPs + * must be valid static external IPs that have been assigned to the NAT. + * These IPs should be used for updating/patching a NAT rule only. + * This field is used for public NAT. * * Generated from protobuf field repeated string source_nat_drain_ips = 340812451; */ private $source_nat_drain_ips; /** - * A list of URLs of subnetworks representing source ranges to be drained. This is only supported on patch/update, and these subnetworks must have previously been used as active ranges in this NAT Rule. This field is used for private NAT. + * A list of URLs of subnetworks representing source ranges to be + * drained. This is only supported on patch/update, and these + * subnetworks must have previously been used as active ranges in this + * NAT Rule. + * This field is used for private NAT. * * Generated from protobuf field repeated string source_nat_drain_ranges = 84802815; */ @@ -46,13 +58,25 @@ class RouterNatRuleAction extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type array|\Google\Protobuf\Internal\RepeatedField $source_nat_active_ips - * A list of URLs of the IP resources used for this NAT rule. These IP addresses must be valid static external IP addresses assigned to the project. This field is used for public NAT. + * A list of URLs of the IP resources used for this NAT rule. These IP + * addresses must be valid static external IP addresses assigned to the + * project. + * This field is used for public NAT. * @type array|\Google\Protobuf\Internal\RepeatedField $source_nat_active_ranges - * A list of URLs of the subnetworks used as source ranges for this NAT Rule. These subnetworks must have purpose set to PRIVATE_NAT. This field is used for private NAT. + * A list of URLs of the subnetworks used as source ranges for this + * NAT Rule. These subnetworks must have purpose set to PRIVATE_NAT. + * This field is used for private NAT. * @type array|\Google\Protobuf\Internal\RepeatedField $source_nat_drain_ips - * A list of URLs of the IP resources to be drained. These IPs must be valid static external IPs that have been assigned to the NAT. These IPs should be used for updating/patching a NAT rule only. This field is used for public NAT. + * A list of URLs of the IP resources to be drained. These IPs + * must be valid static external IPs that have been assigned to the NAT. + * These IPs should be used for updating/patching a NAT rule only. + * This field is used for public NAT. * @type array|\Google\Protobuf\Internal\RepeatedField $source_nat_drain_ranges - * A list of URLs of subnetworks representing source ranges to be drained. This is only supported on patch/update, and these subnetworks must have previously been used as active ranges in this NAT Rule. This field is used for private NAT. + * A list of URLs of subnetworks representing source ranges to be + * drained. This is only supported on patch/update, and these + * subnetworks must have previously been used as active ranges in this + * NAT Rule. + * This field is used for private NAT. * } */ public function __construct($data = NULL) { @@ -61,7 +85,10 @@ public function __construct($data = NULL) { } /** - * A list of URLs of the IP resources used for this NAT rule. These IP addresses must be valid static external IP addresses assigned to the project. This field is used for public NAT. + * A list of URLs of the IP resources used for this NAT rule. These IP + * addresses must be valid static external IP addresses assigned to the + * project. + * This field is used for public NAT. * * Generated from protobuf field repeated string source_nat_active_ips = 210378229; * @return \Google\Protobuf\Internal\RepeatedField @@ -72,7 +99,10 @@ public function getSourceNatActiveIps() } /** - * A list of URLs of the IP resources used for this NAT rule. These IP addresses must be valid static external IP addresses assigned to the project. This field is used for public NAT. + * A list of URLs of the IP resources used for this NAT rule. These IP + * addresses must be valid static external IP addresses assigned to the + * project. + * This field is used for public NAT. * * Generated from protobuf field repeated string source_nat_active_ips = 210378229; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -87,7 +117,9 @@ public function setSourceNatActiveIps($var) } /** - * A list of URLs of the subnetworks used as source ranges for this NAT Rule. These subnetworks must have purpose set to PRIVATE_NAT. This field is used for private NAT. + * A list of URLs of the subnetworks used as source ranges for this + * NAT Rule. These subnetworks must have purpose set to PRIVATE_NAT. + * This field is used for private NAT. * * Generated from protobuf field repeated string source_nat_active_ranges = 190556269; * @return \Google\Protobuf\Internal\RepeatedField @@ -98,7 +130,9 @@ public function getSourceNatActiveRanges() } /** - * A list of URLs of the subnetworks used as source ranges for this NAT Rule. These subnetworks must have purpose set to PRIVATE_NAT. This field is used for private NAT. + * A list of URLs of the subnetworks used as source ranges for this + * NAT Rule. These subnetworks must have purpose set to PRIVATE_NAT. + * This field is used for private NAT. * * Generated from protobuf field repeated string source_nat_active_ranges = 190556269; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -113,7 +147,10 @@ public function setSourceNatActiveRanges($var) } /** - * A list of URLs of the IP resources to be drained. These IPs must be valid static external IPs that have been assigned to the NAT. These IPs should be used for updating/patching a NAT rule only. This field is used for public NAT. + * A list of URLs of the IP resources to be drained. These IPs + * must be valid static external IPs that have been assigned to the NAT. + * These IPs should be used for updating/patching a NAT rule only. + * This field is used for public NAT. * * Generated from protobuf field repeated string source_nat_drain_ips = 340812451; * @return \Google\Protobuf\Internal\RepeatedField @@ -124,7 +161,10 @@ public function getSourceNatDrainIps() } /** - * A list of URLs of the IP resources to be drained. These IPs must be valid static external IPs that have been assigned to the NAT. These IPs should be used for updating/patching a NAT rule only. This field is used for public NAT. + * A list of URLs of the IP resources to be drained. These IPs + * must be valid static external IPs that have been assigned to the NAT. + * These IPs should be used for updating/patching a NAT rule only. + * This field is used for public NAT. * * Generated from protobuf field repeated string source_nat_drain_ips = 340812451; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -139,7 +179,11 @@ public function setSourceNatDrainIps($var) } /** - * A list of URLs of subnetworks representing source ranges to be drained. This is only supported on patch/update, and these subnetworks must have previously been used as active ranges in this NAT Rule. This field is used for private NAT. + * A list of URLs of subnetworks representing source ranges to be + * drained. This is only supported on patch/update, and these + * subnetworks must have previously been used as active ranges in this + * NAT Rule. + * This field is used for private NAT. * * Generated from protobuf field repeated string source_nat_drain_ranges = 84802815; * @return \Google\Protobuf\Internal\RepeatedField @@ -150,7 +194,11 @@ public function getSourceNatDrainRanges() } /** - * A list of URLs of subnetworks representing source ranges to be drained. This is only supported on patch/update, and these subnetworks must have previously been used as active ranges in this NAT Rule. This field is used for private NAT. + * A list of URLs of subnetworks representing source ranges to be + * drained. This is only supported on patch/update, and these + * subnetworks must have previously been used as active ranges in this + * NAT Rule. + * This field is used for private NAT. * * Generated from protobuf field repeated string source_nat_drain_ranges = 84802815; * @param array|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/RouterNatSubnetworkToNat.php b/Compute/src/V1/RouterNatSubnetworkToNat.php index 56e602a397d4..efd5f66a5350 100644 --- a/Compute/src/V1/RouterNatSubnetworkToNat.php +++ b/Compute/src/V1/RouterNatSubnetworkToNat.php @@ -22,13 +22,20 @@ class RouterNatSubnetworkToNat extends \Google\Protobuf\Internal\Message */ protected $name = null; /** - * A list of the secondary ranges of the Subnetwork that are allowed to use NAT. This can be populated only if "LIST_OF_SECONDARY_IP_RANGES" is one of the values in source_ip_ranges_to_nat. + * A list of the secondary ranges of the Subnetwork that are allowed to + * use NAT. This can be populated only if "LIST_OF_SECONDARY_IP_RANGES" + * is one of the values in source_ip_ranges_to_nat. * * Generated from protobuf field repeated string secondary_ip_range_names = 264315097; */ private $secondary_ip_range_names; /** - * Specify the options for NAT ranges in the Subnetwork. All options of a single value are valid except NAT_IP_RANGE_OPTION_UNSPECIFIED. The only valid option with multiple values is: ["PRIMARY_IP_RANGE", "LIST_OF_SECONDARY_IP_RANGES"] Default: [ALL_IP_RANGES] + * Specify the options for NAT ranges in the Subnetwork. All + * options of a single value are valid except + * NAT_IP_RANGE_OPTION_UNSPECIFIED. + * The only valid option with multiple values is: ["PRIMARY_IP_RANGE", + * "LIST_OF_SECONDARY_IP_RANGES"] + * Default: [ALL_IP_RANGES] * Check the SourceIpRangesToNat enum for the list of possible values. * * Generated from protobuf field repeated string source_ip_ranges_to_nat = 388310386; @@ -44,9 +51,16 @@ class RouterNatSubnetworkToNat extends \Google\Protobuf\Internal\Message * @type string $name * URL for the subnetwork resource that will use NAT. * @type array|\Google\Protobuf\Internal\RepeatedField $secondary_ip_range_names - * A list of the secondary ranges of the Subnetwork that are allowed to use NAT. This can be populated only if "LIST_OF_SECONDARY_IP_RANGES" is one of the values in source_ip_ranges_to_nat. + * A list of the secondary ranges of the Subnetwork that are allowed to + * use NAT. This can be populated only if "LIST_OF_SECONDARY_IP_RANGES" + * is one of the values in source_ip_ranges_to_nat. * @type array|\Google\Protobuf\Internal\RepeatedField $source_ip_ranges_to_nat - * Specify the options for NAT ranges in the Subnetwork. All options of a single value are valid except NAT_IP_RANGE_OPTION_UNSPECIFIED. The only valid option with multiple values is: ["PRIMARY_IP_RANGE", "LIST_OF_SECONDARY_IP_RANGES"] Default: [ALL_IP_RANGES] + * Specify the options for NAT ranges in the Subnetwork. All + * options of a single value are valid except + * NAT_IP_RANGE_OPTION_UNSPECIFIED. + * The only valid option with multiple values is: ["PRIMARY_IP_RANGE", + * "LIST_OF_SECONDARY_IP_RANGES"] + * Default: [ALL_IP_RANGES] * Check the SourceIpRangesToNat enum for the list of possible values. * } */ @@ -92,7 +106,9 @@ public function setName($var) } /** - * A list of the secondary ranges of the Subnetwork that are allowed to use NAT. This can be populated only if "LIST_OF_SECONDARY_IP_RANGES" is one of the values in source_ip_ranges_to_nat. + * A list of the secondary ranges of the Subnetwork that are allowed to + * use NAT. This can be populated only if "LIST_OF_SECONDARY_IP_RANGES" + * is one of the values in source_ip_ranges_to_nat. * * Generated from protobuf field repeated string secondary_ip_range_names = 264315097; * @return \Google\Protobuf\Internal\RepeatedField @@ -103,7 +119,9 @@ public function getSecondaryIpRangeNames() } /** - * A list of the secondary ranges of the Subnetwork that are allowed to use NAT. This can be populated only if "LIST_OF_SECONDARY_IP_RANGES" is one of the values in source_ip_ranges_to_nat. + * A list of the secondary ranges of the Subnetwork that are allowed to + * use NAT. This can be populated only if "LIST_OF_SECONDARY_IP_RANGES" + * is one of the values in source_ip_ranges_to_nat. * * Generated from protobuf field repeated string secondary_ip_range_names = 264315097; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -118,7 +136,12 @@ public function setSecondaryIpRangeNames($var) } /** - * Specify the options for NAT ranges in the Subnetwork. All options of a single value are valid except NAT_IP_RANGE_OPTION_UNSPECIFIED. The only valid option with multiple values is: ["PRIMARY_IP_RANGE", "LIST_OF_SECONDARY_IP_RANGES"] Default: [ALL_IP_RANGES] + * Specify the options for NAT ranges in the Subnetwork. All + * options of a single value are valid except + * NAT_IP_RANGE_OPTION_UNSPECIFIED. + * The only valid option with multiple values is: ["PRIMARY_IP_RANGE", + * "LIST_OF_SECONDARY_IP_RANGES"] + * Default: [ALL_IP_RANGES] * Check the SourceIpRangesToNat enum for the list of possible values. * * Generated from protobuf field repeated string source_ip_ranges_to_nat = 388310386; @@ -130,7 +153,12 @@ public function getSourceIpRangesToNat() } /** - * Specify the options for NAT ranges in the Subnetwork. All options of a single value are valid except NAT_IP_RANGE_OPTION_UNSPECIFIED. The only valid option with multiple values is: ["PRIMARY_IP_RANGE", "LIST_OF_SECONDARY_IP_RANGES"] Default: [ALL_IP_RANGES] + * Specify the options for NAT ranges in the Subnetwork. All + * options of a single value are valid except + * NAT_IP_RANGE_OPTION_UNSPECIFIED. + * The only valid option with multiple values is: ["PRIMARY_IP_RANGE", + * "LIST_OF_SECONDARY_IP_RANGES"] + * Default: [ALL_IP_RANGES] * Check the SourceIpRangesToNat enum for the list of possible values. * * Generated from protobuf field repeated string source_ip_ranges_to_nat = 388310386; diff --git a/Compute/src/V1/RouterParams.php b/Compute/src/V1/RouterParams.php index f65fdd51fcd6..80ce1c4a45ac 100644 --- a/Compute/src/V1/RouterParams.php +++ b/Compute/src/V1/RouterParams.php @@ -16,7 +16,19 @@ class RouterParams extends \Google\Protobuf\Internal\Message { /** - * Tag keys/values directly bound to this resource. The field is allowed for INSERT only. The keys/values to set on the resource should be specified in either ID { : } or Namespaced format { : }. For example the following are valid inputs: * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} * {"123/environment" : "production", "345/abc" : "xyz"} Note: * Invalid combinations of ID & namespaced format is not supported. For instance: {"123/environment" : "tagValues/444"} is invalid. * Inconsistent format is not supported. For instance: {"tagKeys/333" : "tagValues/444", "123/env" : "prod"} is invalid. + * Tag keys/values directly bound to this resource. + * The field is allowed for INSERT + * only. The keys/values to set on the resource should be specified in + * either ID { : } or Namespaced format + * { : }. + * For example the following are valid inputs: + * * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} + * * {"123/environment" : "production", "345/abc" : "xyz"} + * Note: + * * Invalid combinations of ID & namespaced format is not supported. For + * instance: {"123/environment" : "tagValues/444"} is invalid. + * * Inconsistent format is not supported. For instance: + * {"tagKeys/333" : "tagValues/444", "123/env" : "prod"} is invalid. * * Generated from protobuf field map resource_manager_tags = 377671164; */ @@ -29,7 +41,19 @@ class RouterParams extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type array|\Google\Protobuf\Internal\MapField $resource_manager_tags - * Tag keys/values directly bound to this resource. The field is allowed for INSERT only. The keys/values to set on the resource should be specified in either ID { : } or Namespaced format { : }. For example the following are valid inputs: * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} * {"123/environment" : "production", "345/abc" : "xyz"} Note: * Invalid combinations of ID & namespaced format is not supported. For instance: {"123/environment" : "tagValues/444"} is invalid. * Inconsistent format is not supported. For instance: {"tagKeys/333" : "tagValues/444", "123/env" : "prod"} is invalid. + * Tag keys/values directly bound to this resource. + * The field is allowed for INSERT + * only. The keys/values to set on the resource should be specified in + * either ID { : } or Namespaced format + * { : }. + * For example the following are valid inputs: + * * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} + * * {"123/environment" : "production", "345/abc" : "xyz"} + * Note: + * * Invalid combinations of ID & namespaced format is not supported. For + * instance: {"123/environment" : "tagValues/444"} is invalid. + * * Inconsistent format is not supported. For instance: + * {"tagKeys/333" : "tagValues/444", "123/env" : "prod"} is invalid. * } */ public function __construct($data = NULL) { @@ -38,7 +62,19 @@ public function __construct($data = NULL) { } /** - * Tag keys/values directly bound to this resource. The field is allowed for INSERT only. The keys/values to set on the resource should be specified in either ID { : } or Namespaced format { : }. For example the following are valid inputs: * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} * {"123/environment" : "production", "345/abc" : "xyz"} Note: * Invalid combinations of ID & namespaced format is not supported. For instance: {"123/environment" : "tagValues/444"} is invalid. * Inconsistent format is not supported. For instance: {"tagKeys/333" : "tagValues/444", "123/env" : "prod"} is invalid. + * Tag keys/values directly bound to this resource. + * The field is allowed for INSERT + * only. The keys/values to set on the resource should be specified in + * either ID { : } or Namespaced format + * { : }. + * For example the following are valid inputs: + * * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} + * * {"123/environment" : "production", "345/abc" : "xyz"} + * Note: + * * Invalid combinations of ID & namespaced format is not supported. For + * instance: {"123/environment" : "tagValues/444"} is invalid. + * * Inconsistent format is not supported. For instance: + * {"tagKeys/333" : "tagValues/444", "123/env" : "prod"} is invalid. * * Generated from protobuf field map resource_manager_tags = 377671164; * @return \Google\Protobuf\Internal\MapField @@ -49,7 +85,19 @@ public function getResourceManagerTags() } /** - * Tag keys/values directly bound to this resource. The field is allowed for INSERT only. The keys/values to set on the resource should be specified in either ID { : } or Namespaced format { : }. For example the following are valid inputs: * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} * {"123/environment" : "production", "345/abc" : "xyz"} Note: * Invalid combinations of ID & namespaced format is not supported. For instance: {"123/environment" : "tagValues/444"} is invalid. * Inconsistent format is not supported. For instance: {"tagKeys/333" : "tagValues/444", "123/env" : "prod"} is invalid. + * Tag keys/values directly bound to this resource. + * The field is allowed for INSERT + * only. The keys/values to set on the resource should be specified in + * either ID { : } or Namespaced format + * { : }. + * For example the following are valid inputs: + * * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} + * * {"123/environment" : "production", "345/abc" : "xyz"} + * Note: + * * Invalid combinations of ID & namespaced format is not supported. For + * instance: {"123/environment" : "tagValues/444"} is invalid. + * * Inconsistent format is not supported. For instance: + * {"tagKeys/333" : "tagValues/444", "123/env" : "prod"} is invalid. * * Generated from protobuf field map resource_manager_tags = 377671164; * @param array|\Google\Protobuf\Internal\MapField $var diff --git a/Compute/src/V1/RouterStatus.php b/Compute/src/V1/RouterStatus.php index 065345519255..9feb5d961f6f 100644 --- a/Compute/src/V1/RouterStatus.php +++ b/Compute/src/V1/RouterStatus.php @@ -15,13 +15,22 @@ class RouterStatus extends \Google\Protobuf\Internal\Message { /** - * A list of the best dynamic routes for this Cloud Router's Virtual Private Cloud (VPC) network in the same region as this Cloud Router. Lists all of the best routes per prefix that are programmed into this region's VPC data plane. When global dynamic routing mode is turned on in the VPC network, this list can include cross-region dynamic routes from Cloud Routers in other regions. + * A list of the best dynamic routes for this Cloud Router's Virtual Private + * Cloud (VPC) network in the same region as this Cloud Router. + * Lists all of the best routes per prefix that are programmed into this + * region's VPC data plane. + * When global dynamic routing mode is turned on in the VPC network, this list + * can include cross-region dynamic routes from Cloud Routers in other + * regions. * * Generated from protobuf field repeated .google.cloud.compute.v1.Route best_routes = 395826693; */ private $best_routes; /** - * A list of the best BGP routes learned by this Cloud Router. It is possible that routes listed might not be programmed into the data plane, if the Google Cloud control plane finds a more optimal route for a prefix than a route learned by this Cloud Router. + * A list of the best BGP routes learned by this Cloud Router. + * It is possible that routes listed might not be programmed into the data + * plane, if the Google Cloud control plane finds a more optimal route for a + * prefix than a route learned by this Cloud Router. * * Generated from protobuf field repeated .google.cloud.compute.v1.Route best_routes_for_router = 119389689; */ @@ -48,9 +57,18 @@ class RouterStatus extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type array<\Google\Cloud\Compute\V1\Route>|\Google\Protobuf\Internal\RepeatedField $best_routes - * A list of the best dynamic routes for this Cloud Router's Virtual Private Cloud (VPC) network in the same region as this Cloud Router. Lists all of the best routes per prefix that are programmed into this region's VPC data plane. When global dynamic routing mode is turned on in the VPC network, this list can include cross-region dynamic routes from Cloud Routers in other regions. + * A list of the best dynamic routes for this Cloud Router's Virtual Private + * Cloud (VPC) network in the same region as this Cloud Router. + * Lists all of the best routes per prefix that are programmed into this + * region's VPC data plane. + * When global dynamic routing mode is turned on in the VPC network, this list + * can include cross-region dynamic routes from Cloud Routers in other + * regions. * @type array<\Google\Cloud\Compute\V1\Route>|\Google\Protobuf\Internal\RepeatedField $best_routes_for_router - * A list of the best BGP routes learned by this Cloud Router. It is possible that routes listed might not be programmed into the data plane, if the Google Cloud control plane finds a more optimal route for a prefix than a route learned by this Cloud Router. + * A list of the best BGP routes learned by this Cloud Router. + * It is possible that routes listed might not be programmed into the data + * plane, if the Google Cloud control plane finds a more optimal route for a + * prefix than a route learned by this Cloud Router. * @type array<\Google\Cloud\Compute\V1\RouterStatusBgpPeerStatus>|\Google\Protobuf\Internal\RepeatedField $bgp_peer_status * @type array<\Google\Cloud\Compute\V1\RouterStatusNatStatus>|\Google\Protobuf\Internal\RepeatedField $nat_status * @type string $network @@ -63,7 +81,13 @@ public function __construct($data = NULL) { } /** - * A list of the best dynamic routes for this Cloud Router's Virtual Private Cloud (VPC) network in the same region as this Cloud Router. Lists all of the best routes per prefix that are programmed into this region's VPC data plane. When global dynamic routing mode is turned on in the VPC network, this list can include cross-region dynamic routes from Cloud Routers in other regions. + * A list of the best dynamic routes for this Cloud Router's Virtual Private + * Cloud (VPC) network in the same region as this Cloud Router. + * Lists all of the best routes per prefix that are programmed into this + * region's VPC data plane. + * When global dynamic routing mode is turned on in the VPC network, this list + * can include cross-region dynamic routes from Cloud Routers in other + * regions. * * Generated from protobuf field repeated .google.cloud.compute.v1.Route best_routes = 395826693; * @return \Google\Protobuf\Internal\RepeatedField @@ -74,7 +98,13 @@ public function getBestRoutes() } /** - * A list of the best dynamic routes for this Cloud Router's Virtual Private Cloud (VPC) network in the same region as this Cloud Router. Lists all of the best routes per prefix that are programmed into this region's VPC data plane. When global dynamic routing mode is turned on in the VPC network, this list can include cross-region dynamic routes from Cloud Routers in other regions. + * A list of the best dynamic routes for this Cloud Router's Virtual Private + * Cloud (VPC) network in the same region as this Cloud Router. + * Lists all of the best routes per prefix that are programmed into this + * region's VPC data plane. + * When global dynamic routing mode is turned on in the VPC network, this list + * can include cross-region dynamic routes from Cloud Routers in other + * regions. * * Generated from protobuf field repeated .google.cloud.compute.v1.Route best_routes = 395826693; * @param array<\Google\Cloud\Compute\V1\Route>|\Google\Protobuf\Internal\RepeatedField $var @@ -89,7 +119,10 @@ public function setBestRoutes($var) } /** - * A list of the best BGP routes learned by this Cloud Router. It is possible that routes listed might not be programmed into the data plane, if the Google Cloud control plane finds a more optimal route for a prefix than a route learned by this Cloud Router. + * A list of the best BGP routes learned by this Cloud Router. + * It is possible that routes listed might not be programmed into the data + * plane, if the Google Cloud control plane finds a more optimal route for a + * prefix than a route learned by this Cloud Router. * * Generated from protobuf field repeated .google.cloud.compute.v1.Route best_routes_for_router = 119389689; * @return \Google\Protobuf\Internal\RepeatedField @@ -100,7 +133,10 @@ public function getBestRoutesForRouter() } /** - * A list of the best BGP routes learned by this Cloud Router. It is possible that routes listed might not be programmed into the data plane, if the Google Cloud control plane finds a more optimal route for a prefix than a route learned by this Cloud Router. + * A list of the best BGP routes learned by this Cloud Router. + * It is possible that routes listed might not be programmed into the data + * plane, if the Google Cloud control plane finds a more optimal route for a + * prefix than a route learned by this Cloud Router. * * Generated from protobuf field repeated .google.cloud.compute.v1.Route best_routes_for_router = 119389689; * @param array<\Google\Cloud\Compute\V1\Route>|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/RouterStatusBgpPeerStatus.php b/Compute/src/V1/RouterStatusBgpPeerStatus.php index d1aa5973107a..3b8ac0c246b0 100644 --- a/Compute/src/V1/RouterStatusBgpPeerStatus.php +++ b/Compute/src/V1/RouterStatusBgpPeerStatus.php @@ -25,13 +25,15 @@ class RouterStatusBgpPeerStatus extends \Google\Protobuf\Internal\Message */ protected $bfd_status = null; /** - * Enable IPv4 traffic over BGP Peer. It is enabled by default if the peerIpAddress is version 4. + * Enable IPv4 traffic over BGP Peer. + * It is enabled by default if the peerIpAddress is version 4. * * Generated from protobuf field optional bool enable_ipv4 = 181467937; */ protected $enable_ipv4 = null; /** - * Enable IPv6 traffic over BGP Peer. It is enabled by default if the peerIpAddress is version 6. + * Enable IPv6 traffic over BGP Peer. + * It is enabled by default if the peerIpAddress is version 6. * * Generated from protobuf field optional bool enable_ipv6 = 181467939; */ @@ -97,13 +99,17 @@ class RouterStatusBgpPeerStatus extends \Google\Protobuf\Internal\Message */ protected $peer_ipv6_nexthop_address = null; /** - * [Output only] URI of the VM instance that is used as third-party router appliances such as Next Gen Firewalls, Virtual Routers, or Router Appliances. The VM instance is the peer side of the BGP session. + * [Output only] URI of the VM instance that is used as third-party router + * appliances such as Next Gen Firewalls, Virtual Routers, or Router + * Appliances. + * The VM instance is the peer side of the BGP session. * * Generated from protobuf field optional string router_appliance_instance = 468312989; */ protected $router_appliance_instance = null; /** - * The state of the BGP session. For a list of possible values for this field, see BGP session states. + * The state of the BGP session. For a list of possible values for this + * field, seeBGP session states. * * Generated from protobuf field optional string state = 109757585; */ @@ -123,13 +129,17 @@ class RouterStatusBgpPeerStatus extends \Google\Protobuf\Internal\Message */ protected $status_reason = null; /** - * Time this session has been up. Format: 14 years, 51 weeks, 6 days, 23 hours, 59 minutes, 59 seconds + * Time this session has been up. + * Format: + * 14 years, 51 weeks, 6 days, 23 hours, 59 minutes, 59 seconds * * Generated from protobuf field optional string uptime = 235379688; */ protected $uptime = null; /** - * Time this session has been up, in seconds. Format: 145 + * Time this session has been up, in seconds. + * Format: + * 145 * * Generated from protobuf field optional string uptime_seconds = 104736040; */ @@ -145,9 +155,11 @@ class RouterStatusBgpPeerStatus extends \Google\Protobuf\Internal\Message * Routes that were advertised to the remote BGP peer * @type \Google\Cloud\Compute\V1\BfdStatus $bfd_status * @type bool $enable_ipv4 - * Enable IPv4 traffic over BGP Peer. It is enabled by default if the peerIpAddress is version 4. + * Enable IPv4 traffic over BGP Peer. + * It is enabled by default if the peerIpAddress is version 4. * @type bool $enable_ipv6 - * Enable IPv6 traffic over BGP Peer. It is enabled by default if the peerIpAddress is version 6. + * Enable IPv6 traffic over BGP Peer. + * It is enabled by default if the peerIpAddress is version 6. * @type string $ip_address * IP address of the local BGP interface. * @type string $ipv4_nexthop_address @@ -169,9 +181,13 @@ class RouterStatusBgpPeerStatus extends \Google\Protobuf\Internal\Message * @type string $peer_ipv6_nexthop_address * IPv6 address of the remote BGP interface. * @type string $router_appliance_instance - * [Output only] URI of the VM instance that is used as third-party router appliances such as Next Gen Firewalls, Virtual Routers, or Router Appliances. The VM instance is the peer side of the BGP session. + * [Output only] URI of the VM instance that is used as third-party router + * appliances such as Next Gen Firewalls, Virtual Routers, or Router + * Appliances. + * The VM instance is the peer side of the BGP session. * @type string $state - * The state of the BGP session. For a list of possible values for this field, see BGP session states. + * The state of the BGP session. For a list of possible values for this + * field, seeBGP session states. * @type string $status * Status of the BGP peer: {UP, DOWN} * Check the Status enum for the list of possible values. @@ -179,9 +195,13 @@ class RouterStatusBgpPeerStatus extends \Google\Protobuf\Internal\Message * Indicates why particular status was returned. * Check the StatusReason enum for the list of possible values. * @type string $uptime - * Time this session has been up. Format: 14 years, 51 weeks, 6 days, 23 hours, 59 minutes, 59 seconds + * Time this session has been up. + * Format: + * 14 years, 51 weeks, 6 days, 23 hours, 59 minutes, 59 seconds * @type string $uptime_seconds - * Time this session has been up, in seconds. Format: 145 + * Time this session has been up, in seconds. + * Format: + * 145 * } */ public function __construct($data = NULL) { @@ -248,7 +268,8 @@ public function setBfdStatus($var) } /** - * Enable IPv4 traffic over BGP Peer. It is enabled by default if the peerIpAddress is version 4. + * Enable IPv4 traffic over BGP Peer. + * It is enabled by default if the peerIpAddress is version 4. * * Generated from protobuf field optional bool enable_ipv4 = 181467937; * @return bool @@ -269,7 +290,8 @@ public function clearEnableIpv4() } /** - * Enable IPv4 traffic over BGP Peer. It is enabled by default if the peerIpAddress is version 4. + * Enable IPv4 traffic over BGP Peer. + * It is enabled by default if the peerIpAddress is version 4. * * Generated from protobuf field optional bool enable_ipv4 = 181467937; * @param bool $var @@ -284,7 +306,8 @@ public function setEnableIpv4($var) } /** - * Enable IPv6 traffic over BGP Peer. It is enabled by default if the peerIpAddress is version 6. + * Enable IPv6 traffic over BGP Peer. + * It is enabled by default if the peerIpAddress is version 6. * * Generated from protobuf field optional bool enable_ipv6 = 181467939; * @return bool @@ -305,7 +328,8 @@ public function clearEnableIpv6() } /** - * Enable IPv6 traffic over BGP Peer. It is enabled by default if the peerIpAddress is version 6. + * Enable IPv6 traffic over BGP Peer. + * It is enabled by default if the peerIpAddress is version 6. * * Generated from protobuf field optional bool enable_ipv6 = 181467939; * @param bool $var @@ -680,7 +704,10 @@ public function setPeerIpv6NexthopAddress($var) } /** - * [Output only] URI of the VM instance that is used as third-party router appliances such as Next Gen Firewalls, Virtual Routers, or Router Appliances. The VM instance is the peer side of the BGP session. + * [Output only] URI of the VM instance that is used as third-party router + * appliances such as Next Gen Firewalls, Virtual Routers, or Router + * Appliances. + * The VM instance is the peer side of the BGP session. * * Generated from protobuf field optional string router_appliance_instance = 468312989; * @return string @@ -701,7 +728,10 @@ public function clearRouterApplianceInstance() } /** - * [Output only] URI of the VM instance that is used as third-party router appliances such as Next Gen Firewalls, Virtual Routers, or Router Appliances. The VM instance is the peer side of the BGP session. + * [Output only] URI of the VM instance that is used as third-party router + * appliances such as Next Gen Firewalls, Virtual Routers, or Router + * Appliances. + * The VM instance is the peer side of the BGP session. * * Generated from protobuf field optional string router_appliance_instance = 468312989; * @param string $var @@ -716,7 +746,8 @@ public function setRouterApplianceInstance($var) } /** - * The state of the BGP session. For a list of possible values for this field, see BGP session states. + * The state of the BGP session. For a list of possible values for this + * field, seeBGP session states. * * Generated from protobuf field optional string state = 109757585; * @return string @@ -737,7 +768,8 @@ public function clearState() } /** - * The state of the BGP session. For a list of possible values for this field, see BGP session states. + * The state of the BGP session. For a list of possible values for this + * field, seeBGP session states. * * Generated from protobuf field optional string state = 109757585; * @param string $var @@ -828,7 +860,9 @@ public function setStatusReason($var) } /** - * Time this session has been up. Format: 14 years, 51 weeks, 6 days, 23 hours, 59 minutes, 59 seconds + * Time this session has been up. + * Format: + * 14 years, 51 weeks, 6 days, 23 hours, 59 minutes, 59 seconds * * Generated from protobuf field optional string uptime = 235379688; * @return string @@ -849,7 +883,9 @@ public function clearUptime() } /** - * Time this session has been up. Format: 14 years, 51 weeks, 6 days, 23 hours, 59 minutes, 59 seconds + * Time this session has been up. + * Format: + * 14 years, 51 weeks, 6 days, 23 hours, 59 minutes, 59 seconds * * Generated from protobuf field optional string uptime = 235379688; * @param string $var @@ -864,7 +900,9 @@ public function setUptime($var) } /** - * Time this session has been up, in seconds. Format: 145 + * Time this session has been up, in seconds. + * Format: + * 145 * * Generated from protobuf field optional string uptime_seconds = 104736040; * @return string @@ -885,7 +923,9 @@ public function clearUptimeSeconds() } /** - * Time this session has been up, in seconds. Format: 145 + * Time this session has been up, in seconds. + * Format: + * 145 * * Generated from protobuf field optional string uptime_seconds = 104736040; * @param string $var diff --git a/Compute/src/V1/RouterStatusBgpPeerStatus/StatusReason.php b/Compute/src/V1/RouterStatusBgpPeerStatus/StatusReason.php index 8f737973a25b..6a011db79612 100644 --- a/Compute/src/V1/RouterStatusBgpPeerStatus/StatusReason.php +++ b/Compute/src/V1/RouterStatusBgpPeerStatus/StatusReason.php @@ -20,19 +20,23 @@ class StatusReason */ const UNDEFINED_STATUS_REASON = 0; /** - * BGP peer disabled because it requires IPv4 but the underlying connection is IPv6-only. + * BGP peer disabled because it requires IPv4 but the underlying + * connection is IPv6-only. * * Generated from protobuf enum IPV4_PEER_ON_IPV6_ONLY_CONNECTION = 435936662; */ const IPV4_PEER_ON_IPV6_ONLY_CONNECTION = 435936662; /** - * BGP peer disabled because it requires IPv6 but the underlying connection is IPv4-only. + * BGP peer disabled because it requires IPv6 but the underlying + * connection is IPv4-only. * * Generated from protobuf enum IPV6_PEER_ON_IPV4_ONLY_CONNECTION = 436304082; */ const IPV6_PEER_ON_IPV4_ONLY_CONNECTION = 436304082; /** - * Indicates internal problems with configuration of MD5 authentication. This particular reason can only be returned when md5AuthEnabled is true and status is DOWN. + * Indicates internal problems with configuration of MD5 authentication. + * This particular reason can only be returned when md5AuthEnabled is true + * and status is DOWN. * * Generated from protobuf enum MD5_AUTH_INTERNAL_PROBLEM = 140462259; */ diff --git a/Compute/src/V1/RouterStatusNatStatus.php b/Compute/src/V1/RouterStatusNatStatus.php index d47bcb8a9334..253f8881582d 100644 --- a/Compute/src/V1/RouterStatusNatStatus.php +++ b/Compute/src/V1/RouterStatusNatStatus.php @@ -22,19 +22,24 @@ class RouterStatusNatStatus extends \Google\Protobuf\Internal\Message */ private $auto_allocated_nat_ips; /** - * A list of IPs auto-allocated for NAT that are in drain mode. Example: ["1.1.1.1", "179.12.26.133"]. + * A list of IPs auto-allocated for NAT that are in drain mode. + * Example: ["1.1.1.1", "179.12.26.133"]. * * Generated from protobuf field repeated string drain_auto_allocated_nat_ips = 309184557; */ private $drain_auto_allocated_nat_ips; /** - * A list of IPs user-allocated for NAT that are in drain mode. Example: ["1.1.1.1", "179.12.26.133"]. + * A list of IPs user-allocated for NAT that are in drain mode. + * Example: ["1.1.1.1", "179.12.26.133"]. * * Generated from protobuf field repeated string drain_user_allocated_nat_ips = 305268553; */ private $drain_user_allocated_nat_ips; /** - * The number of extra IPs to allocate. This will be greater than 0 only if user-specified IPs are NOT enough to allow all configured VMs to use NAT. This value is meaningful only when auto-allocation of NAT IPs is *not* used. + * The number of extra IPs to allocate. This will be greater than 0 only if + * user-specified IPs are NOT enough to allow all configured VMs to use NAT. + * This value is meaningful only when auto-allocation of NAT IPs is *not* + * used. * * Generated from protobuf field optional int32 min_extra_nat_ips_needed = 365786338; */ @@ -64,7 +69,8 @@ class RouterStatusNatStatus extends \Google\Protobuf\Internal\Message */ private $user_allocated_nat_ip_resources; /** - * A list of IPs user-allocated for NAT. They will be raw IP strings like "179.12.26.133". + * A list of IPs user-allocated for NAT. + * They will be raw IP strings like "179.12.26.133". * * Generated from protobuf field repeated string user_allocated_nat_ips = 506878242; */ @@ -79,11 +85,16 @@ class RouterStatusNatStatus extends \Google\Protobuf\Internal\Message * @type array|\Google\Protobuf\Internal\RepeatedField $auto_allocated_nat_ips * A list of IPs auto-allocated for NAT. Example: ["1.1.1.1", "129.2.16.89"] * @type array|\Google\Protobuf\Internal\RepeatedField $drain_auto_allocated_nat_ips - * A list of IPs auto-allocated for NAT that are in drain mode. Example: ["1.1.1.1", "179.12.26.133"]. + * A list of IPs auto-allocated for NAT that are in drain mode. + * Example: ["1.1.1.1", "179.12.26.133"]. * @type array|\Google\Protobuf\Internal\RepeatedField $drain_user_allocated_nat_ips - * A list of IPs user-allocated for NAT that are in drain mode. Example: ["1.1.1.1", "179.12.26.133"]. + * A list of IPs user-allocated for NAT that are in drain mode. + * Example: ["1.1.1.1", "179.12.26.133"]. * @type int $min_extra_nat_ips_needed - * The number of extra IPs to allocate. This will be greater than 0 only if user-specified IPs are NOT enough to allow all configured VMs to use NAT. This value is meaningful only when auto-allocation of NAT IPs is *not* used. + * The number of extra IPs to allocate. This will be greater than 0 only if + * user-specified IPs are NOT enough to allow all configured VMs to use NAT. + * This value is meaningful only when auto-allocation of NAT IPs is *not* + * used. * @type string $name * Unique name of this NAT. * @type int $num_vm_endpoints_with_nat_mappings @@ -93,7 +104,8 @@ class RouterStatusNatStatus extends \Google\Protobuf\Internal\Message * @type array|\Google\Protobuf\Internal\RepeatedField $user_allocated_nat_ip_resources * A list of fully qualified URLs of reserved IP address resources. * @type array|\Google\Protobuf\Internal\RepeatedField $user_allocated_nat_ips - * A list of IPs user-allocated for NAT. They will be raw IP strings like "179.12.26.133". + * A list of IPs user-allocated for NAT. + * They will be raw IP strings like "179.12.26.133". * } */ public function __construct($data = NULL) { @@ -128,7 +140,8 @@ public function setAutoAllocatedNatIps($var) } /** - * A list of IPs auto-allocated for NAT that are in drain mode. Example: ["1.1.1.1", "179.12.26.133"]. + * A list of IPs auto-allocated for NAT that are in drain mode. + * Example: ["1.1.1.1", "179.12.26.133"]. * * Generated from protobuf field repeated string drain_auto_allocated_nat_ips = 309184557; * @return \Google\Protobuf\Internal\RepeatedField @@ -139,7 +152,8 @@ public function getDrainAutoAllocatedNatIps() } /** - * A list of IPs auto-allocated for NAT that are in drain mode. Example: ["1.1.1.1", "179.12.26.133"]. + * A list of IPs auto-allocated for NAT that are in drain mode. + * Example: ["1.1.1.1", "179.12.26.133"]. * * Generated from protobuf field repeated string drain_auto_allocated_nat_ips = 309184557; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -154,7 +168,8 @@ public function setDrainAutoAllocatedNatIps($var) } /** - * A list of IPs user-allocated for NAT that are in drain mode. Example: ["1.1.1.1", "179.12.26.133"]. + * A list of IPs user-allocated for NAT that are in drain mode. + * Example: ["1.1.1.1", "179.12.26.133"]. * * Generated from protobuf field repeated string drain_user_allocated_nat_ips = 305268553; * @return \Google\Protobuf\Internal\RepeatedField @@ -165,7 +180,8 @@ public function getDrainUserAllocatedNatIps() } /** - * A list of IPs user-allocated for NAT that are in drain mode. Example: ["1.1.1.1", "179.12.26.133"]. + * A list of IPs user-allocated for NAT that are in drain mode. + * Example: ["1.1.1.1", "179.12.26.133"]. * * Generated from protobuf field repeated string drain_user_allocated_nat_ips = 305268553; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -180,7 +196,10 @@ public function setDrainUserAllocatedNatIps($var) } /** - * The number of extra IPs to allocate. This will be greater than 0 only if user-specified IPs are NOT enough to allow all configured VMs to use NAT. This value is meaningful only when auto-allocation of NAT IPs is *not* used. + * The number of extra IPs to allocate. This will be greater than 0 only if + * user-specified IPs are NOT enough to allow all configured VMs to use NAT. + * This value is meaningful only when auto-allocation of NAT IPs is *not* + * used. * * Generated from protobuf field optional int32 min_extra_nat_ips_needed = 365786338; * @return int @@ -201,7 +220,10 @@ public function clearMinExtraNatIpsNeeded() } /** - * The number of extra IPs to allocate. This will be greater than 0 only if user-specified IPs are NOT enough to allow all configured VMs to use NAT. This value is meaningful only when auto-allocation of NAT IPs is *not* used. + * The number of extra IPs to allocate. This will be greater than 0 only if + * user-specified IPs are NOT enough to allow all configured VMs to use NAT. + * This value is meaningful only when auto-allocation of NAT IPs is *not* + * used. * * Generated from protobuf field optional int32 min_extra_nat_ips_needed = 365786338; * @param int $var @@ -340,7 +362,8 @@ public function setUserAllocatedNatIpResources($var) } /** - * A list of IPs user-allocated for NAT. They will be raw IP strings like "179.12.26.133". + * A list of IPs user-allocated for NAT. + * They will be raw IP strings like "179.12.26.133". * * Generated from protobuf field repeated string user_allocated_nat_ips = 506878242; * @return \Google\Protobuf\Internal\RepeatedField @@ -351,7 +374,8 @@ public function getUserAllocatedNatIps() } /** - * A list of IPs user-allocated for NAT. They will be raw IP strings like "179.12.26.133". + * A list of IPs user-allocated for NAT. + * They will be raw IP strings like "179.12.26.133". * * Generated from protobuf field repeated string user_allocated_nat_ips = 506878242; * @param array|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/RouterStatusNatStatusNatRuleStatus.php b/Compute/src/V1/RouterStatusNatStatusNatRuleStatus.php index c05fa60b5885..ea2ec91a2804 100644 --- a/Compute/src/V1/RouterStatusNatStatusNatRuleStatus.php +++ b/Compute/src/V1/RouterStatusNatStatusNatRuleStatus.php @@ -16,25 +16,30 @@ class RouterStatusNatStatusNatRuleStatus extends \Google\Protobuf\Internal\Message { /** - * A list of active IPs for NAT. Example: ["1.1.1.1", "179.12.26.133"]. + * A list of active IPs for NAT. + * Example: ["1.1.1.1", "179.12.26.133"]. * * Generated from protobuf field repeated string active_nat_ips = 208517077; */ private $active_nat_ips; /** - * A list of IPs for NAT that are in drain mode. Example: ["1.1.1.1", "179.12.26.133"]. + * A list of IPs for NAT that are in drain mode. + * Example: ["1.1.1.1", "179.12.26.133"]. * * Generated from protobuf field repeated string drain_nat_ips = 504078535; */ private $drain_nat_ips; /** - * The number of extra IPs to allocate. This will be greater than 0 only if the existing IPs in this NAT Rule are NOT enough to allow all configured VMs to use NAT. + * The number of extra IPs to allocate. This will be greater than 0 only + * if the existing IPs in this NAT Rule are NOT enough to allow all + * configured VMs to use NAT. * * Generated from protobuf field optional int32 min_extra_ips_needed = 353002756; */ protected $min_extra_ips_needed = null; /** - * Number of VM endpoints (i.e., NICs) that have NAT Mappings from this NAT Rule. + * Number of VM endpoints (i.e., NICs) that have NAT Mappings from this + * NAT Rule. * * Generated from protobuf field optional int32 num_vm_endpoints_with_nat_mappings = 512367468; */ @@ -53,13 +58,18 @@ class RouterStatusNatStatusNatRuleStatus extends \Google\Protobuf\Internal\Messa * Optional. Data for populating the Message object. * * @type array|\Google\Protobuf\Internal\RepeatedField $active_nat_ips - * A list of active IPs for NAT. Example: ["1.1.1.1", "179.12.26.133"]. + * A list of active IPs for NAT. + * Example: ["1.1.1.1", "179.12.26.133"]. * @type array|\Google\Protobuf\Internal\RepeatedField $drain_nat_ips - * A list of IPs for NAT that are in drain mode. Example: ["1.1.1.1", "179.12.26.133"]. + * A list of IPs for NAT that are in drain mode. + * Example: ["1.1.1.1", "179.12.26.133"]. * @type int $min_extra_ips_needed - * The number of extra IPs to allocate. This will be greater than 0 only if the existing IPs in this NAT Rule are NOT enough to allow all configured VMs to use NAT. + * The number of extra IPs to allocate. This will be greater than 0 only + * if the existing IPs in this NAT Rule are NOT enough to allow all + * configured VMs to use NAT. * @type int $num_vm_endpoints_with_nat_mappings - * Number of VM endpoints (i.e., NICs) that have NAT Mappings from this NAT Rule. + * Number of VM endpoints (i.e., NICs) that have NAT Mappings from this + * NAT Rule. * @type int $rule_number * Rule number of the rule. * } @@ -70,7 +80,8 @@ public function __construct($data = NULL) { } /** - * A list of active IPs for NAT. Example: ["1.1.1.1", "179.12.26.133"]. + * A list of active IPs for NAT. + * Example: ["1.1.1.1", "179.12.26.133"]. * * Generated from protobuf field repeated string active_nat_ips = 208517077; * @return \Google\Protobuf\Internal\RepeatedField @@ -81,7 +92,8 @@ public function getActiveNatIps() } /** - * A list of active IPs for NAT. Example: ["1.1.1.1", "179.12.26.133"]. + * A list of active IPs for NAT. + * Example: ["1.1.1.1", "179.12.26.133"]. * * Generated from protobuf field repeated string active_nat_ips = 208517077; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -96,7 +108,8 @@ public function setActiveNatIps($var) } /** - * A list of IPs for NAT that are in drain mode. Example: ["1.1.1.1", "179.12.26.133"]. + * A list of IPs for NAT that are in drain mode. + * Example: ["1.1.1.1", "179.12.26.133"]. * * Generated from protobuf field repeated string drain_nat_ips = 504078535; * @return \Google\Protobuf\Internal\RepeatedField @@ -107,7 +120,8 @@ public function getDrainNatIps() } /** - * A list of IPs for NAT that are in drain mode. Example: ["1.1.1.1", "179.12.26.133"]. + * A list of IPs for NAT that are in drain mode. + * Example: ["1.1.1.1", "179.12.26.133"]. * * Generated from protobuf field repeated string drain_nat_ips = 504078535; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -122,7 +136,9 @@ public function setDrainNatIps($var) } /** - * The number of extra IPs to allocate. This will be greater than 0 only if the existing IPs in this NAT Rule are NOT enough to allow all configured VMs to use NAT. + * The number of extra IPs to allocate. This will be greater than 0 only + * if the existing IPs in this NAT Rule are NOT enough to allow all + * configured VMs to use NAT. * * Generated from protobuf field optional int32 min_extra_ips_needed = 353002756; * @return int @@ -143,7 +159,9 @@ public function clearMinExtraIpsNeeded() } /** - * The number of extra IPs to allocate. This will be greater than 0 only if the existing IPs in this NAT Rule are NOT enough to allow all configured VMs to use NAT. + * The number of extra IPs to allocate. This will be greater than 0 only + * if the existing IPs in this NAT Rule are NOT enough to allow all + * configured VMs to use NAT. * * Generated from protobuf field optional int32 min_extra_ips_needed = 353002756; * @param int $var @@ -158,7 +176,8 @@ public function setMinExtraIpsNeeded($var) } /** - * Number of VM endpoints (i.e., NICs) that have NAT Mappings from this NAT Rule. + * Number of VM endpoints (i.e., NICs) that have NAT Mappings from this + * NAT Rule. * * Generated from protobuf field optional int32 num_vm_endpoints_with_nat_mappings = 512367468; * @return int @@ -179,7 +198,8 @@ public function clearNumVmEndpointsWithNatMappings() } /** - * Number of VM endpoints (i.e., NICs) that have NAT Mappings from this NAT Rule. + * Number of VM endpoints (i.e., NICs) that have NAT Mappings from this + * NAT Rule. * * Generated from protobuf field optional int32 num_vm_endpoints_with_nat_mappings = 512367468; * @param int $var diff --git a/Compute/src/V1/RoutersListBgpRoutes.php b/Compute/src/V1/RoutersListBgpRoutes.php index 47c007ea7a3d..1b87c4fc8516 100644 --- a/Compute/src/V1/RoutersListBgpRoutes.php +++ b/Compute/src/V1/RoutersListBgpRoutes.php @@ -19,19 +19,24 @@ class RoutersListBgpRoutes extends \Google\Protobuf\Internal\Message */ protected $etag = null; /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional string id = 3355; */ protected $id = null; /** - * [Output Only] Type of resource. Always compute#routersListBgpRoutes for lists of bgp routes. + * [Output Only] Type of resource. Alwayscompute#routersListBgpRoutes for lists of bgp routes. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -69,11 +74,16 @@ class RoutersListBgpRoutes extends \Google\Protobuf\Internal\Message * * @type string $etag * @type string $id - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * @type string $kind - * [Output Only] Type of resource. Always compute#routersListBgpRoutes for lists of bgp routes. + * [Output Only] Type of resource. Alwayscompute#routersListBgpRoutes for lists of bgp routes. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type array<\Google\Cloud\Compute\V1\BgpRoute>|\Google\Protobuf\Internal\RepeatedField $result * [Output Only] A list of bgp routes. * @type string $self_link @@ -122,7 +132,8 @@ public function setEtag($var) } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional string id = 3355; * @return string @@ -143,7 +154,8 @@ public function clearId() } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional string id = 3355; * @param string $var @@ -158,7 +170,7 @@ public function setId($var) } /** - * [Output Only] Type of resource. Always compute#routersListBgpRoutes for lists of bgp routes. + * [Output Only] Type of resource. Alwayscompute#routersListBgpRoutes for lists of bgp routes. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -179,7 +191,7 @@ public function clearKind() } /** - * [Output Only] Type of resource. Always compute#routersListBgpRoutes for lists of bgp routes. + * [Output Only] Type of resource. Alwayscompute#routersListBgpRoutes for lists of bgp routes. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -194,7 +206,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -215,7 +231,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/RoutersListRoutePolicies.php b/Compute/src/V1/RoutersListRoutePolicies.php index 9e03035b1751..4849b089b478 100644 --- a/Compute/src/V1/RoutersListRoutePolicies.php +++ b/Compute/src/V1/RoutersListRoutePolicies.php @@ -19,19 +19,24 @@ class RoutersListRoutePolicies extends \Google\Protobuf\Internal\Message */ protected $etag = null; /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional string id = 3355; */ protected $id = null; /** - * [Output Only] Type of resource. Always compute#routersListRoutePolicies for lists of route policies. + * [Output Only] Type of resource. Alwayscompute#routersListRoutePolicies for lists of route policies. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -69,11 +74,16 @@ class RoutersListRoutePolicies extends \Google\Protobuf\Internal\Message * * @type string $etag * @type string $id - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * @type string $kind - * [Output Only] Type of resource. Always compute#routersListRoutePolicies for lists of route policies. + * [Output Only] Type of resource. Alwayscompute#routersListRoutePolicies for lists of route policies. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type array<\Google\Cloud\Compute\V1\RoutePolicy>|\Google\Protobuf\Internal\RepeatedField $result * [Output Only] A list of route policies. * @type string $self_link @@ -122,7 +132,8 @@ public function setEtag($var) } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional string id = 3355; * @return string @@ -143,7 +154,8 @@ public function clearId() } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional string id = 3355; * @param string $var @@ -158,7 +170,7 @@ public function setId($var) } /** - * [Output Only] Type of resource. Always compute#routersListRoutePolicies for lists of route policies. + * [Output Only] Type of resource. Alwayscompute#routersListRoutePolicies for lists of route policies. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -179,7 +191,7 @@ public function clearKind() } /** - * [Output Only] Type of resource. Always compute#routersListRoutePolicies for lists of route policies. + * [Output Only] Type of resource. Alwayscompute#routersListRoutePolicies for lists of route policies. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -194,7 +206,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -215,7 +231,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/RoutersScopedList.php b/Compute/src/V1/RoutersScopedList.php index cc74b19b17aa..84cecd4630bd 100644 --- a/Compute/src/V1/RoutersScopedList.php +++ b/Compute/src/V1/RoutersScopedList.php @@ -21,7 +21,8 @@ class RoutersScopedList extends \Google\Protobuf\Internal\Message */ private $routers; /** - * Informational warning which replaces the list of routers when the list is empty. + * Informational warning which replaces the list of routers when + * the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; */ @@ -36,7 +37,8 @@ class RoutersScopedList extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\Router>|\Google\Protobuf\Internal\RepeatedField $routers * A list of routers contained in this scope. * @type \Google\Cloud\Compute\V1\Warning $warning - * Informational warning which replaces the list of routers when the list is empty. + * Informational warning which replaces the list of routers when + * the list is empty. * } */ public function __construct($data = NULL) { @@ -71,7 +73,8 @@ public function setRouters($var) } /** - * Informational warning which replaces the list of routers when the list is empty. + * Informational warning which replaces the list of routers when + * the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; * @return \Google\Cloud\Compute\V1\Warning|null @@ -92,7 +95,8 @@ public function clearWarning() } /** - * Informational warning which replaces the list of routers when the list is empty. + * Informational warning which replaces the list of routers when + * the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; * @param \Google\Cloud\Compute\V1\Warning $var diff --git a/Compute/src/V1/SSLHealthCheck.php b/Compute/src/V1/SSLHealthCheck.php index b9ffc1a0ddbb..0ce70ef0ff29 100644 --- a/Compute/src/V1/SSLHealthCheck.php +++ b/Compute/src/V1/SSLHealthCheck.php @@ -15,7 +15,8 @@ class SSLHealthCheck extends \Google\Protobuf\Internal\Message { /** - * The TCP port number to which the health check prober sends packets. The default value is 443. Valid values are 1 through 65535. + * The TCP port number to which the health check prober sends packets. The + * default value is 443. Valid values are 1 through65535. * * Generated from protobuf field optional int32 port = 3446913; */ @@ -27,27 +28,55 @@ class SSLHealthCheck extends \Google\Protobuf\Internal\Message */ protected $port_name = null; /** - * Specifies how a port is selected for health checking. Can be one of the following values: USE_FIXED_PORT: Specifies a port number explicitly using the port field in the health check. Supported by backend services for passthrough load balancers and backend services for proxy load balancers. Not supported by target pools. The health check supports all backends supported by the backend service provided the backend can be health checked. For example, GCE_VM_IP network endpoint groups, GCE_VM_IP_PORT network endpoint groups, and instance group backends. USE_NAMED_PORT: Not supported. USE_SERVING_PORT: Provides an indirect method of specifying the health check port by referring to the backend service. Only supported by backend services for proxy load balancers. Not supported by target pools. Not supported by backend services for passthrough load balancers. Supports all backends that can be health checked; for example, GCE_VM_IP_PORT network endpoint groups and instance group backends. For GCE_VM_IP_PORT network endpoint group backends, the health check uses the port number specified for each endpoint in the network endpoint group. For instance group backends, the health check uses the port number determined by looking up the backend service's named port in the instance group's list of named ports. + * Specifies how a port is selected for health checking. Can be one of the + * following values: + * USE_FIXED_PORT: Specifies a port number explicitly using theport field in the health check. Supported by backend services + * for passthrough load balancers and backend services for proxy load + * balancers. Not supported by target pools. The health check supports all + * backends supported by the backend service provided the backend can be + * health checked. For example, GCE_VM_IP network endpoint + * groups, GCE_VM_IP_PORT network endpoint groups, and instance + * group backends. + * USE_NAMED_PORT: Not supported. + * USE_SERVING_PORT: Provides an indirect method of specifying + * the health check port by referring to the backend service. Only supported + * by backend services for proxy load balancers. Not supported by target + * pools. Not supported by backend services for passthrough load balancers. + * Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group + * backends. + * For GCE_VM_IP_PORT network endpoint group backends, the health + * check uses the port number specified for each endpoint in the network + * endpoint group. For instance group backends, the health check uses the + * port number determined by looking up the backend service's named port in + * the instance group's list of named ports. * Check the PortSpecification enum for the list of possible values. * * Generated from protobuf field optional string port_specification = 51590597; */ protected $port_specification = null; /** - * Specifies the type of proxy header to append before sending data to the backend, either NONE or PROXY_V1. The default is NONE. + * Specifies the type of proxy header to append before sending data to the + * backend, either NONE or PROXY_V1. The default + * is NONE. * Check the ProxyHeader enum for the list of possible values. * * Generated from protobuf field optional string proxy_header = 160374142; */ protected $proxy_header = null; /** - * Instructs the health check prober to send this exact ASCII string, up to 1024 bytes in length, after establishing the TCP connection and SSL handshake. + * Instructs the health check prober to send this exact ASCII string, up to + * 1024 bytes in length, after establishing the TCP connection and SSL + * handshake. * * Generated from protobuf field optional string request = 21951119; */ protected $request = null; /** - * Creates a content-based SSL health check. In addition to establishing a TCP connection and the TLS handshake, you can configure the health check to pass only when the backend sends this exact response ASCII string, up to 1024 bytes in length. For details, see: https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-ssl-tcp + * Creates a content-based SSL health check. In addition to establishing a + * TCP connection and the TLS handshake, you can configure the health check to + * pass only when the backend sends this exact response ASCII string, up to + * 1024 bytes in length. For details, see: + * https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-ssl-tcp * * Generated from protobuf field optional string response = 196547649; */ @@ -60,19 +89,48 @@ class SSLHealthCheck extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type int $port - * The TCP port number to which the health check prober sends packets. The default value is 443. Valid values are 1 through 65535. + * The TCP port number to which the health check prober sends packets. The + * default value is 443. Valid values are 1 through65535. * @type string $port_name * Not supported. * @type string $port_specification - * Specifies how a port is selected for health checking. Can be one of the following values: USE_FIXED_PORT: Specifies a port number explicitly using the port field in the health check. Supported by backend services for passthrough load balancers and backend services for proxy load balancers. Not supported by target pools. The health check supports all backends supported by the backend service provided the backend can be health checked. For example, GCE_VM_IP network endpoint groups, GCE_VM_IP_PORT network endpoint groups, and instance group backends. USE_NAMED_PORT: Not supported. USE_SERVING_PORT: Provides an indirect method of specifying the health check port by referring to the backend service. Only supported by backend services for proxy load balancers. Not supported by target pools. Not supported by backend services for passthrough load balancers. Supports all backends that can be health checked; for example, GCE_VM_IP_PORT network endpoint groups and instance group backends. For GCE_VM_IP_PORT network endpoint group backends, the health check uses the port number specified for each endpoint in the network endpoint group. For instance group backends, the health check uses the port number determined by looking up the backend service's named port in the instance group's list of named ports. + * Specifies how a port is selected for health checking. Can be one of the + * following values: + * USE_FIXED_PORT: Specifies a port number explicitly using theport field in the health check. Supported by backend services + * for passthrough load balancers and backend services for proxy load + * balancers. Not supported by target pools. The health check supports all + * backends supported by the backend service provided the backend can be + * health checked. For example, GCE_VM_IP network endpoint + * groups, GCE_VM_IP_PORT network endpoint groups, and instance + * group backends. + * USE_NAMED_PORT: Not supported. + * USE_SERVING_PORT: Provides an indirect method of specifying + * the health check port by referring to the backend service. Only supported + * by backend services for proxy load balancers. Not supported by target + * pools. Not supported by backend services for passthrough load balancers. + * Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group + * backends. + * For GCE_VM_IP_PORT network endpoint group backends, the health + * check uses the port number specified for each endpoint in the network + * endpoint group. For instance group backends, the health check uses the + * port number determined by looking up the backend service's named port in + * the instance group's list of named ports. * Check the PortSpecification enum for the list of possible values. * @type string $proxy_header - * Specifies the type of proxy header to append before sending data to the backend, either NONE or PROXY_V1. The default is NONE. + * Specifies the type of proxy header to append before sending data to the + * backend, either NONE or PROXY_V1. The default + * is NONE. * Check the ProxyHeader enum for the list of possible values. * @type string $request - * Instructs the health check prober to send this exact ASCII string, up to 1024 bytes in length, after establishing the TCP connection and SSL handshake. + * Instructs the health check prober to send this exact ASCII string, up to + * 1024 bytes in length, after establishing the TCP connection and SSL + * handshake. * @type string $response - * Creates a content-based SSL health check. In addition to establishing a TCP connection and the TLS handshake, you can configure the health check to pass only when the backend sends this exact response ASCII string, up to 1024 bytes in length. For details, see: https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-ssl-tcp + * Creates a content-based SSL health check. In addition to establishing a + * TCP connection and the TLS handshake, you can configure the health check to + * pass only when the backend sends this exact response ASCII string, up to + * 1024 bytes in length. For details, see: + * https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-ssl-tcp * } */ public function __construct($data = NULL) { @@ -81,7 +139,8 @@ public function __construct($data = NULL) { } /** - * The TCP port number to which the health check prober sends packets. The default value is 443. Valid values are 1 through 65535. + * The TCP port number to which the health check prober sends packets. The + * default value is 443. Valid values are 1 through65535. * * Generated from protobuf field optional int32 port = 3446913; * @return int @@ -102,7 +161,8 @@ public function clearPort() } /** - * The TCP port number to which the health check prober sends packets. The default value is 443. Valid values are 1 through 65535. + * The TCP port number to which the health check prober sends packets. The + * default value is 443. Valid values are 1 through65535. * * Generated from protobuf field optional int32 port = 3446913; * @param int $var @@ -153,7 +213,27 @@ public function setPortName($var) } /** - * Specifies how a port is selected for health checking. Can be one of the following values: USE_FIXED_PORT: Specifies a port number explicitly using the port field in the health check. Supported by backend services for passthrough load balancers and backend services for proxy load balancers. Not supported by target pools. The health check supports all backends supported by the backend service provided the backend can be health checked. For example, GCE_VM_IP network endpoint groups, GCE_VM_IP_PORT network endpoint groups, and instance group backends. USE_NAMED_PORT: Not supported. USE_SERVING_PORT: Provides an indirect method of specifying the health check port by referring to the backend service. Only supported by backend services for proxy load balancers. Not supported by target pools. Not supported by backend services for passthrough load balancers. Supports all backends that can be health checked; for example, GCE_VM_IP_PORT network endpoint groups and instance group backends. For GCE_VM_IP_PORT network endpoint group backends, the health check uses the port number specified for each endpoint in the network endpoint group. For instance group backends, the health check uses the port number determined by looking up the backend service's named port in the instance group's list of named ports. + * Specifies how a port is selected for health checking. Can be one of the + * following values: + * USE_FIXED_PORT: Specifies a port number explicitly using theport field in the health check. Supported by backend services + * for passthrough load balancers and backend services for proxy load + * balancers. Not supported by target pools. The health check supports all + * backends supported by the backend service provided the backend can be + * health checked. For example, GCE_VM_IP network endpoint + * groups, GCE_VM_IP_PORT network endpoint groups, and instance + * group backends. + * USE_NAMED_PORT: Not supported. + * USE_SERVING_PORT: Provides an indirect method of specifying + * the health check port by referring to the backend service. Only supported + * by backend services for proxy load balancers. Not supported by target + * pools. Not supported by backend services for passthrough load balancers. + * Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group + * backends. + * For GCE_VM_IP_PORT network endpoint group backends, the health + * check uses the port number specified for each endpoint in the network + * endpoint group. For instance group backends, the health check uses the + * port number determined by looking up the backend service's named port in + * the instance group's list of named ports. * Check the PortSpecification enum for the list of possible values. * * Generated from protobuf field optional string port_specification = 51590597; @@ -175,7 +255,27 @@ public function clearPortSpecification() } /** - * Specifies how a port is selected for health checking. Can be one of the following values: USE_FIXED_PORT: Specifies a port number explicitly using the port field in the health check. Supported by backend services for passthrough load balancers and backend services for proxy load balancers. Not supported by target pools. The health check supports all backends supported by the backend service provided the backend can be health checked. For example, GCE_VM_IP network endpoint groups, GCE_VM_IP_PORT network endpoint groups, and instance group backends. USE_NAMED_PORT: Not supported. USE_SERVING_PORT: Provides an indirect method of specifying the health check port by referring to the backend service. Only supported by backend services for proxy load balancers. Not supported by target pools. Not supported by backend services for passthrough load balancers. Supports all backends that can be health checked; for example, GCE_VM_IP_PORT network endpoint groups and instance group backends. For GCE_VM_IP_PORT network endpoint group backends, the health check uses the port number specified for each endpoint in the network endpoint group. For instance group backends, the health check uses the port number determined by looking up the backend service's named port in the instance group's list of named ports. + * Specifies how a port is selected for health checking. Can be one of the + * following values: + * USE_FIXED_PORT: Specifies a port number explicitly using theport field in the health check. Supported by backend services + * for passthrough load balancers and backend services for proxy load + * balancers. Not supported by target pools. The health check supports all + * backends supported by the backend service provided the backend can be + * health checked. For example, GCE_VM_IP network endpoint + * groups, GCE_VM_IP_PORT network endpoint groups, and instance + * group backends. + * USE_NAMED_PORT: Not supported. + * USE_SERVING_PORT: Provides an indirect method of specifying + * the health check port by referring to the backend service. Only supported + * by backend services for proxy load balancers. Not supported by target + * pools. Not supported by backend services for passthrough load balancers. + * Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group + * backends. + * For GCE_VM_IP_PORT network endpoint group backends, the health + * check uses the port number specified for each endpoint in the network + * endpoint group. For instance group backends, the health check uses the + * port number determined by looking up the backend service's named port in + * the instance group's list of named ports. * Check the PortSpecification enum for the list of possible values. * * Generated from protobuf field optional string port_specification = 51590597; @@ -191,7 +291,9 @@ public function setPortSpecification($var) } /** - * Specifies the type of proxy header to append before sending data to the backend, either NONE or PROXY_V1. The default is NONE. + * Specifies the type of proxy header to append before sending data to the + * backend, either NONE or PROXY_V1. The default + * is NONE. * Check the ProxyHeader enum for the list of possible values. * * Generated from protobuf field optional string proxy_header = 160374142; @@ -213,7 +315,9 @@ public function clearProxyHeader() } /** - * Specifies the type of proxy header to append before sending data to the backend, either NONE or PROXY_V1. The default is NONE. + * Specifies the type of proxy header to append before sending data to the + * backend, either NONE or PROXY_V1. The default + * is NONE. * Check the ProxyHeader enum for the list of possible values. * * Generated from protobuf field optional string proxy_header = 160374142; @@ -229,7 +333,9 @@ public function setProxyHeader($var) } /** - * Instructs the health check prober to send this exact ASCII string, up to 1024 bytes in length, after establishing the TCP connection and SSL handshake. + * Instructs the health check prober to send this exact ASCII string, up to + * 1024 bytes in length, after establishing the TCP connection and SSL + * handshake. * * Generated from protobuf field optional string request = 21951119; * @return string @@ -250,7 +356,9 @@ public function clearRequest() } /** - * Instructs the health check prober to send this exact ASCII string, up to 1024 bytes in length, after establishing the TCP connection and SSL handshake. + * Instructs the health check prober to send this exact ASCII string, up to + * 1024 bytes in length, after establishing the TCP connection and SSL + * handshake. * * Generated from protobuf field optional string request = 21951119; * @param string $var @@ -265,7 +373,11 @@ public function setRequest($var) } /** - * Creates a content-based SSL health check. In addition to establishing a TCP connection and the TLS handshake, you can configure the health check to pass only when the backend sends this exact response ASCII string, up to 1024 bytes in length. For details, see: https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-ssl-tcp + * Creates a content-based SSL health check. In addition to establishing a + * TCP connection and the TLS handshake, you can configure the health check to + * pass only when the backend sends this exact response ASCII string, up to + * 1024 bytes in length. For details, see: + * https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-ssl-tcp * * Generated from protobuf field optional string response = 196547649; * @return string @@ -286,7 +398,11 @@ public function clearResponse() } /** - * Creates a content-based SSL health check. In addition to establishing a TCP connection and the TLS handshake, you can configure the health check to pass only when the backend sends this exact response ASCII string, up to 1024 bytes in length. For details, see: https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-ssl-tcp + * Creates a content-based SSL health check. In addition to establishing a + * TCP connection and the TLS handshake, you can configure the health check to + * pass only when the backend sends this exact response ASCII string, up to + * 1024 bytes in length. For details, see: + * https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-ssl-tcp * * Generated from protobuf field optional string response = 196547649; * @param string $var diff --git a/Compute/src/V1/SSLHealthCheck/PortSpecification.php b/Compute/src/V1/SSLHealthCheck/PortSpecification.php index 565a0db33fb2..80ea8a42c4bf 100644 --- a/Compute/src/V1/SSLHealthCheck/PortSpecification.php +++ b/Compute/src/V1/SSLHealthCheck/PortSpecification.php @@ -7,7 +7,27 @@ use UnexpectedValueException; /** - * Specifies how a port is selected for health checking. Can be one of the following values: USE_FIXED_PORT: Specifies a port number explicitly using the port field in the health check. Supported by backend services for passthrough load balancers and backend services for proxy load balancers. Not supported by target pools. The health check supports all backends supported by the backend service provided the backend can be health checked. For example, GCE_VM_IP network endpoint groups, GCE_VM_IP_PORT network endpoint groups, and instance group backends. USE_NAMED_PORT: Not supported. USE_SERVING_PORT: Provides an indirect method of specifying the health check port by referring to the backend service. Only supported by backend services for proxy load balancers. Not supported by target pools. Not supported by backend services for passthrough load balancers. Supports all backends that can be health checked; for example, GCE_VM_IP_PORT network endpoint groups and instance group backends. For GCE_VM_IP_PORT network endpoint group backends, the health check uses the port number specified for each endpoint in the network endpoint group. For instance group backends, the health check uses the port number determined by looking up the backend service's named port in the instance group's list of named ports. + * Specifies how a port is selected for health checking. Can be one of the + * following values: + * USE_FIXED_PORT: Specifies a port number explicitly using theport field in the health check. Supported by backend services + * for passthrough load balancers and backend services for proxy load + * balancers. Not supported by target pools. The health check supports all + * backends supported by the backend service provided the backend can be + * health checked. For example, GCE_VM_IP network endpoint + * groups, GCE_VM_IP_PORT network endpoint groups, and instance + * group backends. + * USE_NAMED_PORT: Not supported. + * USE_SERVING_PORT: Provides an indirect method of specifying + * the health check port by referring to the backend service. Only supported + * by backend services for proxy load balancers. Not supported by target + * pools. Not supported by backend services for passthrough load balancers. + * Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group + * backends. + * For GCE_VM_IP_PORT network endpoint group backends, the health + * check uses the port number specified for each endpoint in the network + * endpoint group. For instance group backends, the health check uses the + * port number determined by looking up the backend service's named port in + * the instance group's list of named ports. * * Protobuf type google.cloud.compute.v1.SSLHealthCheck.PortSpecification */ @@ -20,7 +40,8 @@ class PortSpecification */ const UNDEFINED_PORT_SPECIFICATION = 0; /** - * The port number in the health check's port is used for health checking. Applies to network endpoint group and instance group backends. + * The port number in the health check's port is used for health + * checking. Applies to network endpoint group and instance group backends. * * Generated from protobuf enum USE_FIXED_PORT = 190235748; */ @@ -32,7 +53,10 @@ class PortSpecification */ const USE_NAMED_PORT = 349300671; /** - * For network endpoint group backends, the health check uses the port number specified on each endpoint in the network endpoint group. For instance group backends, the health check uses the port number specified for the backend service's named port defined in the instance group's named ports. + * For network endpoint group backends, the health check uses the port number + * specified on each endpoint in the network endpoint group. For instance + * group backends, the health check uses the port number specified for the + * backend service's named port defined in the instance group's named ports. * * Generated from protobuf enum USE_SERVING_PORT = 362637516; */ diff --git a/Compute/src/V1/SSLHealthCheck/ProxyHeader.php b/Compute/src/V1/SSLHealthCheck/ProxyHeader.php index f5c32ed2662b..6ec7474a3e42 100644 --- a/Compute/src/V1/SSLHealthCheck/ProxyHeader.php +++ b/Compute/src/V1/SSLHealthCheck/ProxyHeader.php @@ -7,7 +7,9 @@ use UnexpectedValueException; /** - * Specifies the type of proxy header to append before sending data to the backend, either NONE or PROXY_V1. The default is NONE. + * Specifies the type of proxy header to append before sending data to the + * backend, either NONE or PROXY_V1. The default + * is NONE. * * Protobuf type google.cloud.compute.v1.SSLHealthCheck.ProxyHeader */ diff --git a/Compute/src/V1/SavedAttachedDisk.php b/Compute/src/V1/SavedAttachedDisk.php index da0531ba2aa3..377dac414610 100644 --- a/Compute/src/V1/SavedAttachedDisk.php +++ b/Compute/src/V1/SavedAttachedDisk.php @@ -9,20 +9,23 @@ use Google\Protobuf\Internal\GPBUtil; /** - * DEPRECATED: Please use compute#savedDisk instead. An instance-attached disk resource. + * DEPRECATED: Please use compute#savedDisk instead. + * An instance-attached disk resource. * * Generated from protobuf message google.cloud.compute.v1.SavedAttachedDisk */ class SavedAttachedDisk extends \Google\Protobuf\Internal\Message { /** - * Specifies whether the disk will be auto-deleted when the instance is deleted (but not when the disk is detached from the instance). + * Specifies whether the disk will be auto-deleted when the instance is + * deleted (but not when the disk is detached from the instance). * * Generated from protobuf field optional bool auto_delete = 464761403; */ protected $auto_delete = null; /** - * Indicates that this is a boot disk. The virtual machine will use the first partition of the disk for its root filesystem. + * Indicates that this is a boot disk. The virtual machine will use the first + * partition of the disk for its root filesystem. * * Generated from protobuf field optional bool boot = 3029746; */ @@ -46,32 +49,38 @@ class SavedAttachedDisk extends \Google\Protobuf\Internal\Message */ protected $disk_size_gb = null; /** - * [Output Only] URL of the disk type resource. For example: projects/project /zones/zone/diskTypes/pd-standard or pd-ssd + * [Output Only] URL of the disk type resource. For example:projects/project/zones/zone/diskTypes/pd-standard or + * pd-ssd * * Generated from protobuf field optional string disk_type = 93009052; */ protected $disk_type = null; /** - * A list of features to enable on the guest operating system. Applicable only for bootable images. Read Enabling guest operating system features to see a list of available options. + * A list of features to enable on the guest operating system. Applicable only + * for bootable images. Read + * Enabling guest operating system features to see a list of available + * options. * * Generated from protobuf field repeated .google.cloud.compute.v1.GuestOsFeature guest_os_features = 79294545; */ private $guest_os_features; /** - * Specifies zero-based index of the disk that is attached to the source instance. + * Specifies zero-based index of the disk that is attached to the source + * instance. * * Generated from protobuf field optional int32 index = 100346066; */ protected $index = null; /** - * Specifies the disk interface to use for attaching this disk, which is either SCSI or NVME. + * Specifies the disk interface to use for attaching this disk, which is + * either SCSI or NVME. * Check the Interface enum for the list of possible values. * * Generated from protobuf field optional string interface = 502623545; */ protected $interface = null; /** - * [Output Only] Type of the resource. Always compute#attachedDisk for attached disks. + * [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks. * * Generated from protobuf field optional string kind = 3292052; */ @@ -83,7 +92,7 @@ class SavedAttachedDisk extends \Google\Protobuf\Internal\Message */ private $licenses; /** - * The mode in which this disk is attached to the source instance, either READ_WRITE or READ_ONLY. + * The mode in which this disk is attached to the source instance, eitherREAD_WRITE or READ_ONLY. * Check the Mode enum for the list of possible values. * * Generated from protobuf field optional string mode = 3357091; @@ -96,20 +105,25 @@ class SavedAttachedDisk extends \Google\Protobuf\Internal\Message */ protected $source = null; /** - * [Output Only] A size of the storage used by the disk's snapshot by this machine image. + * [Output Only] A size of the storage used by the disk's snapshot by this + * machine image. * * Generated from protobuf field optional int64 storage_bytes = 424631719; */ protected $storage_bytes = null; /** - * [Output Only] An indicator whether storageBytes is in a stable state or it is being adjusted as a result of shared storage reallocation. This status can either be UPDATING, meaning the size of the snapshot is being updated, or UP_TO_DATE, meaning the size of the snapshot is up-to-date. + * [Output Only] An indicator whether storageBytes is in a + * stable state or it is being adjusted as a result of shared storage + * reallocation. This status can either be UPDATING, meaning + * the size of the snapshot is being updated, or UP_TO_DATE, + * meaning the size of the snapshot is up-to-date. * Check the StorageBytesStatus enum for the list of possible values. * * Generated from protobuf field optional string storage_bytes_status = 490739082; */ protected $storage_bytes_status = null; /** - * Specifies the type of the attached disk, either SCRATCH or PERSISTENT. + * Specifies the type of the attached disk, either SCRATCH orPERSISTENT. * Check the Type enum for the list of possible values. * * Generated from protobuf field optional string type = 3575610; @@ -123,9 +137,11 @@ class SavedAttachedDisk extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type bool $auto_delete - * Specifies whether the disk will be auto-deleted when the instance is deleted (but not when the disk is detached from the instance). + * Specifies whether the disk will be auto-deleted when the instance is + * deleted (but not when the disk is detached from the instance). * @type bool $boot - * Indicates that this is a boot disk. The virtual machine will use the first partition of the disk for its root filesystem. + * Indicates that this is a boot disk. The virtual machine will use the first + * partition of the disk for its root filesystem. * @type string $device_name * Specifies the name of the disk attached to the source instance. * @type \Google\Cloud\Compute\V1\CustomerEncryptionKey $disk_encryption_key @@ -133,30 +149,41 @@ class SavedAttachedDisk extends \Google\Protobuf\Internal\Message * @type int|string $disk_size_gb * The size of the disk in base-2 GB. * @type string $disk_type - * [Output Only] URL of the disk type resource. For example: projects/project /zones/zone/diskTypes/pd-standard or pd-ssd + * [Output Only] URL of the disk type resource. For example:projects/project/zones/zone/diskTypes/pd-standard or + * pd-ssd * @type array<\Google\Cloud\Compute\V1\GuestOsFeature>|\Google\Protobuf\Internal\RepeatedField $guest_os_features - * A list of features to enable on the guest operating system. Applicable only for bootable images. Read Enabling guest operating system features to see a list of available options. + * A list of features to enable on the guest operating system. Applicable only + * for bootable images. Read + * Enabling guest operating system features to see a list of available + * options. * @type int $index - * Specifies zero-based index of the disk that is attached to the source instance. + * Specifies zero-based index of the disk that is attached to the source + * instance. * @type string $interface - * Specifies the disk interface to use for attaching this disk, which is either SCSI or NVME. + * Specifies the disk interface to use for attaching this disk, which is + * either SCSI or NVME. * Check the Interface enum for the list of possible values. * @type string $kind - * [Output Only] Type of the resource. Always compute#attachedDisk for attached disks. + * [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks. * @type array|\Google\Protobuf\Internal\RepeatedField $licenses * [Output Only] Any valid publicly visible licenses. * @type string $mode - * The mode in which this disk is attached to the source instance, either READ_WRITE or READ_ONLY. + * The mode in which this disk is attached to the source instance, eitherREAD_WRITE or READ_ONLY. * Check the Mode enum for the list of possible values. * @type string $source * Specifies a URL of the disk attached to the source instance. * @type int|string $storage_bytes - * [Output Only] A size of the storage used by the disk's snapshot by this machine image. + * [Output Only] A size of the storage used by the disk's snapshot by this + * machine image. * @type string $storage_bytes_status - * [Output Only] An indicator whether storageBytes is in a stable state or it is being adjusted as a result of shared storage reallocation. This status can either be UPDATING, meaning the size of the snapshot is being updated, or UP_TO_DATE, meaning the size of the snapshot is up-to-date. + * [Output Only] An indicator whether storageBytes is in a + * stable state or it is being adjusted as a result of shared storage + * reallocation. This status can either be UPDATING, meaning + * the size of the snapshot is being updated, or UP_TO_DATE, + * meaning the size of the snapshot is up-to-date. * Check the StorageBytesStatus enum for the list of possible values. * @type string $type - * Specifies the type of the attached disk, either SCRATCH or PERSISTENT. + * Specifies the type of the attached disk, either SCRATCH orPERSISTENT. * Check the Type enum for the list of possible values. * } */ @@ -166,7 +193,8 @@ public function __construct($data = NULL) { } /** - * Specifies whether the disk will be auto-deleted when the instance is deleted (but not when the disk is detached from the instance). + * Specifies whether the disk will be auto-deleted when the instance is + * deleted (but not when the disk is detached from the instance). * * Generated from protobuf field optional bool auto_delete = 464761403; * @return bool @@ -187,7 +215,8 @@ public function clearAutoDelete() } /** - * Specifies whether the disk will be auto-deleted when the instance is deleted (but not when the disk is detached from the instance). + * Specifies whether the disk will be auto-deleted when the instance is + * deleted (but not when the disk is detached from the instance). * * Generated from protobuf field optional bool auto_delete = 464761403; * @param bool $var @@ -202,7 +231,8 @@ public function setAutoDelete($var) } /** - * Indicates that this is a boot disk. The virtual machine will use the first partition of the disk for its root filesystem. + * Indicates that this is a boot disk. The virtual machine will use the first + * partition of the disk for its root filesystem. * * Generated from protobuf field optional bool boot = 3029746; * @return bool @@ -223,7 +253,8 @@ public function clearBoot() } /** - * Indicates that this is a boot disk. The virtual machine will use the first partition of the disk for its root filesystem. + * Indicates that this is a boot disk. The virtual machine will use the first + * partition of the disk for its root filesystem. * * Generated from protobuf field optional bool boot = 3029746; * @param bool $var @@ -346,7 +377,8 @@ public function setDiskSizeGb($var) } /** - * [Output Only] URL of the disk type resource. For example: projects/project /zones/zone/diskTypes/pd-standard or pd-ssd + * [Output Only] URL of the disk type resource. For example:projects/project/zones/zone/diskTypes/pd-standard or + * pd-ssd * * Generated from protobuf field optional string disk_type = 93009052; * @return string @@ -367,7 +399,8 @@ public function clearDiskType() } /** - * [Output Only] URL of the disk type resource. For example: projects/project /zones/zone/diskTypes/pd-standard or pd-ssd + * [Output Only] URL of the disk type resource. For example:projects/project/zones/zone/diskTypes/pd-standard or + * pd-ssd * * Generated from protobuf field optional string disk_type = 93009052; * @param string $var @@ -382,7 +415,10 @@ public function setDiskType($var) } /** - * A list of features to enable on the guest operating system. Applicable only for bootable images. Read Enabling guest operating system features to see a list of available options. + * A list of features to enable on the guest operating system. Applicable only + * for bootable images. Read + * Enabling guest operating system features to see a list of available + * options. * * Generated from protobuf field repeated .google.cloud.compute.v1.GuestOsFeature guest_os_features = 79294545; * @return \Google\Protobuf\Internal\RepeatedField @@ -393,7 +429,10 @@ public function getGuestOsFeatures() } /** - * A list of features to enable on the guest operating system. Applicable only for bootable images. Read Enabling guest operating system features to see a list of available options. + * A list of features to enable on the guest operating system. Applicable only + * for bootable images. Read + * Enabling guest operating system features to see a list of available + * options. * * Generated from protobuf field repeated .google.cloud.compute.v1.GuestOsFeature guest_os_features = 79294545; * @param array<\Google\Cloud\Compute\V1\GuestOsFeature>|\Google\Protobuf\Internal\RepeatedField $var @@ -408,7 +447,8 @@ public function setGuestOsFeatures($var) } /** - * Specifies zero-based index of the disk that is attached to the source instance. + * Specifies zero-based index of the disk that is attached to the source + * instance. * * Generated from protobuf field optional int32 index = 100346066; * @return int @@ -429,7 +469,8 @@ public function clearIndex() } /** - * Specifies zero-based index of the disk that is attached to the source instance. + * Specifies zero-based index of the disk that is attached to the source + * instance. * * Generated from protobuf field optional int32 index = 100346066; * @param int $var @@ -444,7 +485,8 @@ public function setIndex($var) } /** - * Specifies the disk interface to use for attaching this disk, which is either SCSI or NVME. + * Specifies the disk interface to use for attaching this disk, which is + * either SCSI or NVME. * Check the Interface enum for the list of possible values. * * Generated from protobuf field optional string interface = 502623545; @@ -466,7 +508,8 @@ public function clearInterface() } /** - * Specifies the disk interface to use for attaching this disk, which is either SCSI or NVME. + * Specifies the disk interface to use for attaching this disk, which is + * either SCSI or NVME. * Check the Interface enum for the list of possible values. * * Generated from protobuf field optional string interface = 502623545; @@ -482,7 +525,7 @@ public function setInterface($var) } /** - * [Output Only] Type of the resource. Always compute#attachedDisk for attached disks. + * [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -503,7 +546,7 @@ public function clearKind() } /** - * [Output Only] Type of the resource. Always compute#attachedDisk for attached disks. + * [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -544,7 +587,7 @@ public function setLicenses($var) } /** - * The mode in which this disk is attached to the source instance, either READ_WRITE or READ_ONLY. + * The mode in which this disk is attached to the source instance, eitherREAD_WRITE or READ_ONLY. * Check the Mode enum for the list of possible values. * * Generated from protobuf field optional string mode = 3357091; @@ -566,7 +609,7 @@ public function clearMode() } /** - * The mode in which this disk is attached to the source instance, either READ_WRITE or READ_ONLY. + * The mode in which this disk is attached to the source instance, eitherREAD_WRITE or READ_ONLY. * Check the Mode enum for the list of possible values. * * Generated from protobuf field optional string mode = 3357091; @@ -618,7 +661,8 @@ public function setSource($var) } /** - * [Output Only] A size of the storage used by the disk's snapshot by this machine image. + * [Output Only] A size of the storage used by the disk's snapshot by this + * machine image. * * Generated from protobuf field optional int64 storage_bytes = 424631719; * @return int|string @@ -639,7 +683,8 @@ public function clearStorageBytes() } /** - * [Output Only] A size of the storage used by the disk's snapshot by this machine image. + * [Output Only] A size of the storage used by the disk's snapshot by this + * machine image. * * Generated from protobuf field optional int64 storage_bytes = 424631719; * @param int|string $var @@ -654,7 +699,11 @@ public function setStorageBytes($var) } /** - * [Output Only] An indicator whether storageBytes is in a stable state or it is being adjusted as a result of shared storage reallocation. This status can either be UPDATING, meaning the size of the snapshot is being updated, or UP_TO_DATE, meaning the size of the snapshot is up-to-date. + * [Output Only] An indicator whether storageBytes is in a + * stable state or it is being adjusted as a result of shared storage + * reallocation. This status can either be UPDATING, meaning + * the size of the snapshot is being updated, or UP_TO_DATE, + * meaning the size of the snapshot is up-to-date. * Check the StorageBytesStatus enum for the list of possible values. * * Generated from protobuf field optional string storage_bytes_status = 490739082; @@ -676,7 +725,11 @@ public function clearStorageBytesStatus() } /** - * [Output Only] An indicator whether storageBytes is in a stable state or it is being adjusted as a result of shared storage reallocation. This status can either be UPDATING, meaning the size of the snapshot is being updated, or UP_TO_DATE, meaning the size of the snapshot is up-to-date. + * [Output Only] An indicator whether storageBytes is in a + * stable state or it is being adjusted as a result of shared storage + * reallocation. This status can either be UPDATING, meaning + * the size of the snapshot is being updated, or UP_TO_DATE, + * meaning the size of the snapshot is up-to-date. * Check the StorageBytesStatus enum for the list of possible values. * * Generated from protobuf field optional string storage_bytes_status = 490739082; @@ -692,7 +745,7 @@ public function setStorageBytesStatus($var) } /** - * Specifies the type of the attached disk, either SCRATCH or PERSISTENT. + * Specifies the type of the attached disk, either SCRATCH orPERSISTENT. * Check the Type enum for the list of possible values. * * Generated from protobuf field optional string type = 3575610; @@ -714,7 +767,7 @@ public function clearType() } /** - * Specifies the type of the attached disk, either SCRATCH or PERSISTENT. + * Specifies the type of the attached disk, either SCRATCH orPERSISTENT. * Check the Type enum for the list of possible values. * * Generated from protobuf field optional string type = 3575610; diff --git a/Compute/src/V1/SavedAttachedDisk/Mode.php b/Compute/src/V1/SavedAttachedDisk/Mode.php index e149b5a6ec47..736396297658 100644 --- a/Compute/src/V1/SavedAttachedDisk/Mode.php +++ b/Compute/src/V1/SavedAttachedDisk/Mode.php @@ -7,7 +7,7 @@ use UnexpectedValueException; /** - * The mode in which this disk is attached to the source instance, either READ_WRITE or READ_ONLY. + * The mode in which this disk is attached to the source instance, eitherREAD_WRITE or READ_ONLY. * * Protobuf type google.cloud.compute.v1.SavedAttachedDisk.Mode */ @@ -20,13 +20,15 @@ class Mode */ const UNDEFINED_MODE = 0; /** - * Attaches this disk in read-only mode. Multiple virtual machines can use a disk in read-only mode at a time. + * Attaches this disk in read-only mode. Multiple virtual machines can use + * a disk in read-only mode at a time. * * Generated from protobuf enum READ_ONLY = 91950261; */ const READ_ONLY = 91950261; /** - * *[Default]* Attaches this disk in read-write mode. Only one virtual machine at a time can be attached to a disk in read-write mode. + * *[Default]* Attaches this disk in read-write mode. Only one + * virtual machine at a time can be attached to a disk in read-write mode. * * Generated from protobuf enum READ_WRITE = 173607894; */ diff --git a/Compute/src/V1/SavedAttachedDisk/PBInterface.php b/Compute/src/V1/SavedAttachedDisk/PBInterface.php index e7aafe8f46f8..17b83758f08f 100644 --- a/Compute/src/V1/SavedAttachedDisk/PBInterface.php +++ b/Compute/src/V1/SavedAttachedDisk/PBInterface.php @@ -7,7 +7,8 @@ use UnexpectedValueException; /** - * Specifies the disk interface to use for attaching this disk, which is either SCSI or NVME. + * Specifies the disk interface to use for attaching this disk, which is + * either SCSI or NVME. * * Protobuf type google.cloud.compute.v1.SavedAttachedDisk.Interface */ diff --git a/Compute/src/V1/SavedAttachedDisk/StorageBytesStatus.php b/Compute/src/V1/SavedAttachedDisk/StorageBytesStatus.php index 4b16dd886152..fe224113b3ec 100644 --- a/Compute/src/V1/SavedAttachedDisk/StorageBytesStatus.php +++ b/Compute/src/V1/SavedAttachedDisk/StorageBytesStatus.php @@ -7,7 +7,11 @@ use UnexpectedValueException; /** - * [Output Only] An indicator whether storageBytes is in a stable state or it is being adjusted as a result of shared storage reallocation. This status can either be UPDATING, meaning the size of the snapshot is being updated, or UP_TO_DATE, meaning the size of the snapshot is up-to-date. + * [Output Only] An indicator whether storageBytes is in a + * stable state or it is being adjusted as a result of shared storage + * reallocation. This status can either be UPDATING, meaning + * the size of the snapshot is being updated, or UP_TO_DATE, + * meaning the size of the snapshot is up-to-date. * * Protobuf type google.cloud.compute.v1.SavedAttachedDisk.StorageBytesStatus */ diff --git a/Compute/src/V1/SavedAttachedDisk/Type.php b/Compute/src/V1/SavedAttachedDisk/Type.php index 0c767fb75e44..1f767539e1b6 100644 --- a/Compute/src/V1/SavedAttachedDisk/Type.php +++ b/Compute/src/V1/SavedAttachedDisk/Type.php @@ -7,7 +7,7 @@ use UnexpectedValueException; /** - * Specifies the type of the attached disk, either SCRATCH or PERSISTENT. + * Specifies the type of the attached disk, either SCRATCH orPERSISTENT. * * Protobuf type google.cloud.compute.v1.SavedAttachedDisk.Type */ diff --git a/Compute/src/V1/SavedDisk.php b/Compute/src/V1/SavedDisk.php index 483ecf737ad0..05ff86df4a33 100644 --- a/Compute/src/V1/SavedDisk.php +++ b/Compute/src/V1/SavedDisk.php @@ -23,7 +23,8 @@ class SavedDisk extends \Google\Protobuf\Internal\Message */ protected $architecture = null; /** - * [Output Only] Type of the resource. Always compute#savedDisk for attached disks. + * [Output Only] Type of the resource. Always compute#savedDisk + * for attached disks. * * Generated from protobuf field optional string kind = 3292052; */ @@ -35,13 +36,18 @@ class SavedDisk extends \Google\Protobuf\Internal\Message */ protected $source_disk = null; /** - * [Output Only] Size of the individual disk snapshot used by this machine image. + * [Output Only] Size of the individual disk snapshot used by this machine + * image. * * Generated from protobuf field optional int64 storage_bytes = 424631719; */ protected $storage_bytes = null; /** - * [Output Only] An indicator whether storageBytes is in a stable state or it is being adjusted as a result of shared storage reallocation. This status can either be UPDATING, meaning the size of the snapshot is being updated, or UP_TO_DATE, meaning the size of the snapshot is up-to-date. + * [Output Only] An indicator whether storageBytes is in a + * stable state or it is being adjusted as a result of shared storage + * reallocation. This status can either be UPDATING, meaning + * the size of the snapshot is being updated, or UP_TO_DATE, + * meaning the size of the snapshot is up-to-date. * Check the StorageBytesStatus enum for the list of possible values. * * Generated from protobuf field optional string storage_bytes_status = 490739082; @@ -58,13 +64,19 @@ class SavedDisk extends \Google\Protobuf\Internal\Message * [Output Only] The architecture of the attached disk. * Check the Architecture enum for the list of possible values. * @type string $kind - * [Output Only] Type of the resource. Always compute#savedDisk for attached disks. + * [Output Only] Type of the resource. Always compute#savedDisk + * for attached disks. * @type string $source_disk * Specifies a URL of the disk attached to the source instance. * @type int|string $storage_bytes - * [Output Only] Size of the individual disk snapshot used by this machine image. + * [Output Only] Size of the individual disk snapshot used by this machine + * image. * @type string $storage_bytes_status - * [Output Only] An indicator whether storageBytes is in a stable state or it is being adjusted as a result of shared storage reallocation. This status can either be UPDATING, meaning the size of the snapshot is being updated, or UP_TO_DATE, meaning the size of the snapshot is up-to-date. + * [Output Only] An indicator whether storageBytes is in a + * stable state or it is being adjusted as a result of shared storage + * reallocation. This status can either be UPDATING, meaning + * the size of the snapshot is being updated, or UP_TO_DATE, + * meaning the size of the snapshot is up-to-date. * Check the StorageBytesStatus enum for the list of possible values. * } */ @@ -112,7 +124,8 @@ public function setArchitecture($var) } /** - * [Output Only] Type of the resource. Always compute#savedDisk for attached disks. + * [Output Only] Type of the resource. Always compute#savedDisk + * for attached disks. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -133,7 +146,8 @@ public function clearKind() } /** - * [Output Only] Type of the resource. Always compute#savedDisk for attached disks. + * [Output Only] Type of the resource. Always compute#savedDisk + * for attached disks. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -184,7 +198,8 @@ public function setSourceDisk($var) } /** - * [Output Only] Size of the individual disk snapshot used by this machine image. + * [Output Only] Size of the individual disk snapshot used by this machine + * image. * * Generated from protobuf field optional int64 storage_bytes = 424631719; * @return int|string @@ -205,7 +220,8 @@ public function clearStorageBytes() } /** - * [Output Only] Size of the individual disk snapshot used by this machine image. + * [Output Only] Size of the individual disk snapshot used by this machine + * image. * * Generated from protobuf field optional int64 storage_bytes = 424631719; * @param int|string $var @@ -220,7 +236,11 @@ public function setStorageBytes($var) } /** - * [Output Only] An indicator whether storageBytes is in a stable state or it is being adjusted as a result of shared storage reallocation. This status can either be UPDATING, meaning the size of the snapshot is being updated, or UP_TO_DATE, meaning the size of the snapshot is up-to-date. + * [Output Only] An indicator whether storageBytes is in a + * stable state or it is being adjusted as a result of shared storage + * reallocation. This status can either be UPDATING, meaning + * the size of the snapshot is being updated, or UP_TO_DATE, + * meaning the size of the snapshot is up-to-date. * Check the StorageBytesStatus enum for the list of possible values. * * Generated from protobuf field optional string storage_bytes_status = 490739082; @@ -242,7 +262,11 @@ public function clearStorageBytesStatus() } /** - * [Output Only] An indicator whether storageBytes is in a stable state or it is being adjusted as a result of shared storage reallocation. This status can either be UPDATING, meaning the size of the snapshot is being updated, or UP_TO_DATE, meaning the size of the snapshot is up-to-date. + * [Output Only] An indicator whether storageBytes is in a + * stable state or it is being adjusted as a result of shared storage + * reallocation. This status can either be UPDATING, meaning + * the size of the snapshot is being updated, or UP_TO_DATE, + * meaning the size of the snapshot is up-to-date. * Check the StorageBytesStatus enum for the list of possible values. * * Generated from protobuf field optional string storage_bytes_status = 490739082; diff --git a/Compute/src/V1/SavedDisk/StorageBytesStatus.php b/Compute/src/V1/SavedDisk/StorageBytesStatus.php index 1db8f03de34b..f643ce5cd6ac 100644 --- a/Compute/src/V1/SavedDisk/StorageBytesStatus.php +++ b/Compute/src/V1/SavedDisk/StorageBytesStatus.php @@ -7,7 +7,11 @@ use UnexpectedValueException; /** - * [Output Only] An indicator whether storageBytes is in a stable state or it is being adjusted as a result of shared storage reallocation. This status can either be UPDATING, meaning the size of the snapshot is being updated, or UP_TO_DATE, meaning the size of the snapshot is up-to-date. + * [Output Only] An indicator whether storageBytes is in a + * stable state or it is being adjusted as a result of shared storage + * reallocation. This status can either be UPDATING, meaning + * the size of the snapshot is being updated, or UP_TO_DATE, + * meaning the size of the snapshot is up-to-date. * * Protobuf type google.cloud.compute.v1.SavedDisk.StorageBytesStatus */ diff --git a/Compute/src/V1/ScalingScheduleStatus.php b/Compute/src/V1/ScalingScheduleStatus.php index eaceb3778795..b359f180d82a 100644 --- a/Compute/src/V1/ScalingScheduleStatus.php +++ b/Compute/src/V1/ScalingScheduleStatus.php @@ -15,13 +15,21 @@ class ScalingScheduleStatus extends \Google\Protobuf\Internal\Message { /** - * [Output Only] The last time the scaling schedule became active. Note: this is a timestamp when a schedule actually became active, not when it was planned to do so. The timestamp is in RFC3339 text format. + * [Output Only] The last time the scaling schedule became active. + * Note: this is a timestamp when a schedule actually became active, not when + * it was planned to do so. + * The timestamp is in RFC3339 + * text format. * * Generated from protobuf field optional string last_start_time = 34545107; */ protected $last_start_time = null; /** - * [Output Only] The next time the scaling schedule is to become active. Note: this is a timestamp when a schedule is planned to run, but the actual time might be slightly different. The timestamp is in RFC3339 text format. + * [Output Only] The next time the scaling schedule is to become active. + * Note: this is a timestamp when a schedule is planned to run, but the actual + * time might be slightly different. + * The timestamp is in RFC3339 + * text format. * * Generated from protobuf field optional string next_start_time = 97270102; */ @@ -41,9 +49,17 @@ class ScalingScheduleStatus extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $last_start_time - * [Output Only] The last time the scaling schedule became active. Note: this is a timestamp when a schedule actually became active, not when it was planned to do so. The timestamp is in RFC3339 text format. + * [Output Only] The last time the scaling schedule became active. + * Note: this is a timestamp when a schedule actually became active, not when + * it was planned to do so. + * The timestamp is in RFC3339 + * text format. * @type string $next_start_time - * [Output Only] The next time the scaling schedule is to become active. Note: this is a timestamp when a schedule is planned to run, but the actual time might be slightly different. The timestamp is in RFC3339 text format. + * [Output Only] The next time the scaling schedule is to become active. + * Note: this is a timestamp when a schedule is planned to run, but the actual + * time might be slightly different. + * The timestamp is in RFC3339 + * text format. * @type string $state * [Output Only] The current state of a scaling schedule. * Check the State enum for the list of possible values. @@ -55,7 +71,11 @@ public function __construct($data = NULL) { } /** - * [Output Only] The last time the scaling schedule became active. Note: this is a timestamp when a schedule actually became active, not when it was planned to do so. The timestamp is in RFC3339 text format. + * [Output Only] The last time the scaling schedule became active. + * Note: this is a timestamp when a schedule actually became active, not when + * it was planned to do so. + * The timestamp is in RFC3339 + * text format. * * Generated from protobuf field optional string last_start_time = 34545107; * @return string @@ -76,7 +96,11 @@ public function clearLastStartTime() } /** - * [Output Only] The last time the scaling schedule became active. Note: this is a timestamp when a schedule actually became active, not when it was planned to do so. The timestamp is in RFC3339 text format. + * [Output Only] The last time the scaling schedule became active. + * Note: this is a timestamp when a schedule actually became active, not when + * it was planned to do so. + * The timestamp is in RFC3339 + * text format. * * Generated from protobuf field optional string last_start_time = 34545107; * @param string $var @@ -91,7 +115,11 @@ public function setLastStartTime($var) } /** - * [Output Only] The next time the scaling schedule is to become active. Note: this is a timestamp when a schedule is planned to run, but the actual time might be slightly different. The timestamp is in RFC3339 text format. + * [Output Only] The next time the scaling schedule is to become active. + * Note: this is a timestamp when a schedule is planned to run, but the actual + * time might be slightly different. + * The timestamp is in RFC3339 + * text format. * * Generated from protobuf field optional string next_start_time = 97270102; * @return string @@ -112,7 +140,11 @@ public function clearNextStartTime() } /** - * [Output Only] The next time the scaling schedule is to become active. Note: this is a timestamp when a schedule is planned to run, but the actual time might be slightly different. The timestamp is in RFC3339 text format. + * [Output Only] The next time the scaling schedule is to become active. + * Note: this is a timestamp when a schedule is planned to run, but the actual + * time might be slightly different. + * The timestamp is in RFC3339 + * text format. * * Generated from protobuf field optional string next_start_time = 97270102; * @param string $var diff --git a/Compute/src/V1/ScalingScheduleStatus/State.php b/Compute/src/V1/ScalingScheduleStatus/State.php index 965217afa4a2..15fa0036abee 100644 --- a/Compute/src/V1/ScalingScheduleStatus/State.php +++ b/Compute/src/V1/ScalingScheduleStatus/State.php @@ -20,7 +20,8 @@ class State */ const UNDEFINED_STATE = 0; /** - * The current autoscaling recommendation is influenced by this scaling schedule. + * The current autoscaling recommendation is influenced by this scaling + * schedule. * * Generated from protobuf enum ACTIVE = 314733318; */ @@ -38,7 +39,8 @@ class State */ const OBSOLETE = 66532761; /** - * The current autoscaling recommendation is not influenced by this scaling schedule. + * The current autoscaling recommendation is not influenced by this scaling + * schedule. * * Generated from protobuf enum READY = 77848963; */ diff --git a/Compute/src/V1/Scheduling.php b/Compute/src/V1/Scheduling.php index 38425f445d52..9103c83f6e74 100644 --- a/Compute/src/V1/Scheduling.php +++ b/Compute/src/V1/Scheduling.php @@ -16,19 +16,28 @@ class Scheduling extends \Google\Protobuf\Internal\Message { /** - * Specifies whether the instance should be automatically restarted if it is terminated by Compute Engine (not terminated by a user). You can only set the automatic restart option for standard instances. Preemptible instances cannot be automatically restarted. By default, this is set to true so an instance is automatically restarted if it is terminated by Compute Engine. + * Specifies whether the instance should be automatically restarted if it is + * terminated by Compute Engine (not terminated by a user). You can only set + * the automatic restart option for standard instances.Preemptible instances + * cannot be automatically restarted. + * By default, this is set to true so an instance is + * automatically restarted if it is terminated by Compute Engine. * * Generated from protobuf field optional bool automatic_restart = 350821371; */ protected $automatic_restart = null; /** - * Specifies the availability domain to place the instance in. The value must be a number between 1 and the number of availability domains specified in the spread placement policy attached to the instance. + * Specifies the availability domain to place the instance in. The value + * must be a number between 1 and the number of availability domains + * specified in the spread placement policy attached to the instance. * * Generated from protobuf field optional int32 availability_domain = 252514344; */ protected $availability_domain = null; /** - * Specify the time in seconds for host error detection, the value must be within the range of [90, 330] with the increment of 30, if unset, the default behavior of host error recovery will be used. + * Specify the time in seconds for host error detection, the value must be + * within the range of [90, 330] with the increment of 30, if unset, the + * default behavior of host error recovery will be used. * * Generated from protobuf field optional int32 host_error_timeout_seconds = 408317459; */ @@ -41,37 +50,52 @@ class Scheduling extends \Google\Protobuf\Internal\Message */ protected $instance_termination_action = null; /** - * Specifies the maximum amount of time a Local Ssd Vm should wait while recovery of the Local Ssd state is attempted. Its value should be in between 0 and 168 hours with hour granularity and the default value being 1 hour. + * Specifies the maximum amount of time a Local Ssd Vm should wait while + * recovery of the Local Ssd state is attempted. Its value should be in + * between 0 and 168 hours with hour granularity and the default value being 1 + * hour. * * Generated from protobuf field optional .google.cloud.compute.v1.Duration local_ssd_recovery_timeout = 268015590; */ protected $local_ssd_recovery_timeout = null; /** - * An opaque location hint used to place the instance close to other resources. This field is for use by internal tools that use the public API. + * An opaque location hint used to place the instance close to other + * resources. + * This field is for use by internal tools that use the public API. * * Generated from protobuf field optional string location_hint = 350519505; */ protected $location_hint = null; /** - * Specifies the max run duration for the given instance. If specified, the instance termination action will be performed at the end of the run duration. + * Specifies the max run duration for the given instance. If specified, + * the instance termination action will be performed at the end of the run + * duration. * * Generated from protobuf field optional .google.cloud.compute.v1.Duration max_run_duration = 430839747; */ protected $max_run_duration = null; /** - * The minimum number of virtual CPUs this instance will consume when running on a sole-tenant node. + * The minimum number of virtual CPUs this instance will consume when running + * on a sole-tenant node. * * Generated from protobuf field optional int32 min_node_cpus = 317231675; */ protected $min_node_cpus = null; /** - * A set of node affinity and anti-affinity configurations. Refer to Configuring node affinity for more information. Overrides reservationAffinity. + * A set of node affinity and anti-affinity configurations. Refer toConfiguring node + * affinity for more information. + * Overrides reservationAffinity. * * Generated from protobuf field repeated .google.cloud.compute.v1.SchedulingNodeAffinity node_affinities = 461799971; */ private $node_affinities; /** - * Defines the maintenance behavior for this instance. For standard instances, the default behavior is MIGRATE. For preemptible instances, the default and only possible behavior is TERMINATE. For more information, see Set VM host maintenance policy. + * Defines the maintenance behavior for this instance. For standard instances, + * the default behavior is MIGRATE. Forpreemptible instances, + * the default and only possible behavior is TERMINATE. For more + * information, see + * Set + * VM host maintenance policy. * Check the OnHostMaintenance enum for the list of possible values. * * Generated from protobuf field optional string on_host_maintenance = 64616796; @@ -82,7 +106,10 @@ class Scheduling extends \Google\Protobuf\Internal\Message */ protected $on_instance_stop_action = null; /** - * Defines whether the instance is preemptible. This can only be set during instance creation or while the instance is stopped and therefore, in a `TERMINATED` state. See Instance Life Cycle for more information on the possible instance states. + * Defines whether the instance is preemptible. This can only be set during + * instance creation or while the instance isstopped and + * therefore, in a `TERMINATED` state. SeeInstance Life + * Cycle for more information on the possible instance states. * * Generated from protobuf field optional bool preemptible = 324203169; */ @@ -95,13 +122,16 @@ class Scheduling extends \Google\Protobuf\Internal\Message */ protected $provisioning_model = null; /** - * Default is false and there will be 120 seconds between GCE ACPI G2 Soft Off and ACPI G3 Mechanical Off for Standard VMs and 30 seconds for Spot VMs. + * Default is false and there will be 120 seconds between GCE ACPI G2 Soft + * Off and ACPI G3 Mechanical + * Off for Standard VMs and 30 seconds for Spot VMs. * * Generated from protobuf field optional bool skip_guest_os_shutdown = 201662378; */ protected $skip_guest_os_shutdown = null; /** - * Specifies the timestamp, when the instance will be terminated, in RFC3339 text format. If specified, the instance termination action will be performed at the termination time. + * Specifies the timestamp, when the instance will be terminated, inRFC3339 text format. If specified, the instance + * termination action will be performed at the termination time. * * Generated from protobuf field optional string termination_time = 428082984; */ @@ -114,37 +144,67 @@ class Scheduling extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type bool $automatic_restart - * Specifies whether the instance should be automatically restarted if it is terminated by Compute Engine (not terminated by a user). You can only set the automatic restart option for standard instances. Preemptible instances cannot be automatically restarted. By default, this is set to true so an instance is automatically restarted if it is terminated by Compute Engine. + * Specifies whether the instance should be automatically restarted if it is + * terminated by Compute Engine (not terminated by a user). You can only set + * the automatic restart option for standard instances.Preemptible instances + * cannot be automatically restarted. + * By default, this is set to true so an instance is + * automatically restarted if it is terminated by Compute Engine. * @type int $availability_domain - * Specifies the availability domain to place the instance in. The value must be a number between 1 and the number of availability domains specified in the spread placement policy attached to the instance. + * Specifies the availability domain to place the instance in. The value + * must be a number between 1 and the number of availability domains + * specified in the spread placement policy attached to the instance. * @type int $host_error_timeout_seconds - * Specify the time in seconds for host error detection, the value must be within the range of [90, 330] with the increment of 30, if unset, the default behavior of host error recovery will be used. + * Specify the time in seconds for host error detection, the value must be + * within the range of [90, 330] with the increment of 30, if unset, the + * default behavior of host error recovery will be used. * @type string $instance_termination_action * Specifies the termination action for the instance. * Check the InstanceTerminationAction enum for the list of possible values. * @type \Google\Cloud\Compute\V1\Duration $local_ssd_recovery_timeout - * Specifies the maximum amount of time a Local Ssd Vm should wait while recovery of the Local Ssd state is attempted. Its value should be in between 0 and 168 hours with hour granularity and the default value being 1 hour. + * Specifies the maximum amount of time a Local Ssd Vm should wait while + * recovery of the Local Ssd state is attempted. Its value should be in + * between 0 and 168 hours with hour granularity and the default value being 1 + * hour. * @type string $location_hint - * An opaque location hint used to place the instance close to other resources. This field is for use by internal tools that use the public API. + * An opaque location hint used to place the instance close to other + * resources. + * This field is for use by internal tools that use the public API. * @type \Google\Cloud\Compute\V1\Duration $max_run_duration - * Specifies the max run duration for the given instance. If specified, the instance termination action will be performed at the end of the run duration. + * Specifies the max run duration for the given instance. If specified, + * the instance termination action will be performed at the end of the run + * duration. * @type int $min_node_cpus - * The minimum number of virtual CPUs this instance will consume when running on a sole-tenant node. + * The minimum number of virtual CPUs this instance will consume when running + * on a sole-tenant node. * @type array<\Google\Cloud\Compute\V1\SchedulingNodeAffinity>|\Google\Protobuf\Internal\RepeatedField $node_affinities - * A set of node affinity and anti-affinity configurations. Refer to Configuring node affinity for more information. Overrides reservationAffinity. + * A set of node affinity and anti-affinity configurations. Refer toConfiguring node + * affinity for more information. + * Overrides reservationAffinity. * @type string $on_host_maintenance - * Defines the maintenance behavior for this instance. For standard instances, the default behavior is MIGRATE. For preemptible instances, the default and only possible behavior is TERMINATE. For more information, see Set VM host maintenance policy. + * Defines the maintenance behavior for this instance. For standard instances, + * the default behavior is MIGRATE. Forpreemptible instances, + * the default and only possible behavior is TERMINATE. For more + * information, see + * Set + * VM host maintenance policy. * Check the OnHostMaintenance enum for the list of possible values. * @type \Google\Cloud\Compute\V1\SchedulingOnInstanceStopAction $on_instance_stop_action * @type bool $preemptible - * Defines whether the instance is preemptible. This can only be set during instance creation or while the instance is stopped and therefore, in a `TERMINATED` state. See Instance Life Cycle for more information on the possible instance states. + * Defines whether the instance is preemptible. This can only be set during + * instance creation or while the instance isstopped and + * therefore, in a `TERMINATED` state. SeeInstance Life + * Cycle for more information on the possible instance states. * @type string $provisioning_model * Specifies the provisioning model of the instance. * Check the ProvisioningModel enum for the list of possible values. * @type bool $skip_guest_os_shutdown - * Default is false and there will be 120 seconds between GCE ACPI G2 Soft Off and ACPI G3 Mechanical Off for Standard VMs and 30 seconds for Spot VMs. + * Default is false and there will be 120 seconds between GCE ACPI G2 Soft + * Off and ACPI G3 Mechanical + * Off for Standard VMs and 30 seconds for Spot VMs. * @type string $termination_time - * Specifies the timestamp, when the instance will be terminated, in RFC3339 text format. If specified, the instance termination action will be performed at the termination time. + * Specifies the timestamp, when the instance will be terminated, inRFC3339 text format. If specified, the instance + * termination action will be performed at the termination time. * } */ public function __construct($data = NULL) { @@ -153,7 +213,12 @@ public function __construct($data = NULL) { } /** - * Specifies whether the instance should be automatically restarted if it is terminated by Compute Engine (not terminated by a user). You can only set the automatic restart option for standard instances. Preemptible instances cannot be automatically restarted. By default, this is set to true so an instance is automatically restarted if it is terminated by Compute Engine. + * Specifies whether the instance should be automatically restarted if it is + * terminated by Compute Engine (not terminated by a user). You can only set + * the automatic restart option for standard instances.Preemptible instances + * cannot be automatically restarted. + * By default, this is set to true so an instance is + * automatically restarted if it is terminated by Compute Engine. * * Generated from protobuf field optional bool automatic_restart = 350821371; * @return bool @@ -174,7 +239,12 @@ public function clearAutomaticRestart() } /** - * Specifies whether the instance should be automatically restarted if it is terminated by Compute Engine (not terminated by a user). You can only set the automatic restart option for standard instances. Preemptible instances cannot be automatically restarted. By default, this is set to true so an instance is automatically restarted if it is terminated by Compute Engine. + * Specifies whether the instance should be automatically restarted if it is + * terminated by Compute Engine (not terminated by a user). You can only set + * the automatic restart option for standard instances.Preemptible instances + * cannot be automatically restarted. + * By default, this is set to true so an instance is + * automatically restarted if it is terminated by Compute Engine. * * Generated from protobuf field optional bool automatic_restart = 350821371; * @param bool $var @@ -189,7 +259,9 @@ public function setAutomaticRestart($var) } /** - * Specifies the availability domain to place the instance in. The value must be a number between 1 and the number of availability domains specified in the spread placement policy attached to the instance. + * Specifies the availability domain to place the instance in. The value + * must be a number between 1 and the number of availability domains + * specified in the spread placement policy attached to the instance. * * Generated from protobuf field optional int32 availability_domain = 252514344; * @return int @@ -210,7 +282,9 @@ public function clearAvailabilityDomain() } /** - * Specifies the availability domain to place the instance in. The value must be a number between 1 and the number of availability domains specified in the spread placement policy attached to the instance. + * Specifies the availability domain to place the instance in. The value + * must be a number between 1 and the number of availability domains + * specified in the spread placement policy attached to the instance. * * Generated from protobuf field optional int32 availability_domain = 252514344; * @param int $var @@ -225,7 +299,9 @@ public function setAvailabilityDomain($var) } /** - * Specify the time in seconds for host error detection, the value must be within the range of [90, 330] with the increment of 30, if unset, the default behavior of host error recovery will be used. + * Specify the time in seconds for host error detection, the value must be + * within the range of [90, 330] with the increment of 30, if unset, the + * default behavior of host error recovery will be used. * * Generated from protobuf field optional int32 host_error_timeout_seconds = 408317459; * @return int @@ -246,7 +322,9 @@ public function clearHostErrorTimeoutSeconds() } /** - * Specify the time in seconds for host error detection, the value must be within the range of [90, 330] with the increment of 30, if unset, the default behavior of host error recovery will be used. + * Specify the time in seconds for host error detection, the value must be + * within the range of [90, 330] with the increment of 30, if unset, the + * default behavior of host error recovery will be used. * * Generated from protobuf field optional int32 host_error_timeout_seconds = 408317459; * @param int $var @@ -299,7 +377,10 @@ public function setInstanceTerminationAction($var) } /** - * Specifies the maximum amount of time a Local Ssd Vm should wait while recovery of the Local Ssd state is attempted. Its value should be in between 0 and 168 hours with hour granularity and the default value being 1 hour. + * Specifies the maximum amount of time a Local Ssd Vm should wait while + * recovery of the Local Ssd state is attempted. Its value should be in + * between 0 and 168 hours with hour granularity and the default value being 1 + * hour. * * Generated from protobuf field optional .google.cloud.compute.v1.Duration local_ssd_recovery_timeout = 268015590; * @return \Google\Cloud\Compute\V1\Duration|null @@ -320,7 +401,10 @@ public function clearLocalSsdRecoveryTimeout() } /** - * Specifies the maximum amount of time a Local Ssd Vm should wait while recovery of the Local Ssd state is attempted. Its value should be in between 0 and 168 hours with hour granularity and the default value being 1 hour. + * Specifies the maximum amount of time a Local Ssd Vm should wait while + * recovery of the Local Ssd state is attempted. Its value should be in + * between 0 and 168 hours with hour granularity and the default value being 1 + * hour. * * Generated from protobuf field optional .google.cloud.compute.v1.Duration local_ssd_recovery_timeout = 268015590; * @param \Google\Cloud\Compute\V1\Duration $var @@ -335,7 +419,9 @@ public function setLocalSsdRecoveryTimeout($var) } /** - * An opaque location hint used to place the instance close to other resources. This field is for use by internal tools that use the public API. + * An opaque location hint used to place the instance close to other + * resources. + * This field is for use by internal tools that use the public API. * * Generated from protobuf field optional string location_hint = 350519505; * @return string @@ -356,7 +442,9 @@ public function clearLocationHint() } /** - * An opaque location hint used to place the instance close to other resources. This field is for use by internal tools that use the public API. + * An opaque location hint used to place the instance close to other + * resources. + * This field is for use by internal tools that use the public API. * * Generated from protobuf field optional string location_hint = 350519505; * @param string $var @@ -371,7 +459,9 @@ public function setLocationHint($var) } /** - * Specifies the max run duration for the given instance. If specified, the instance termination action will be performed at the end of the run duration. + * Specifies the max run duration for the given instance. If specified, + * the instance termination action will be performed at the end of the run + * duration. * * Generated from protobuf field optional .google.cloud.compute.v1.Duration max_run_duration = 430839747; * @return \Google\Cloud\Compute\V1\Duration|null @@ -392,7 +482,9 @@ public function clearMaxRunDuration() } /** - * Specifies the max run duration for the given instance. If specified, the instance termination action will be performed at the end of the run duration. + * Specifies the max run duration for the given instance. If specified, + * the instance termination action will be performed at the end of the run + * duration. * * Generated from protobuf field optional .google.cloud.compute.v1.Duration max_run_duration = 430839747; * @param \Google\Cloud\Compute\V1\Duration $var @@ -407,7 +499,8 @@ public function setMaxRunDuration($var) } /** - * The minimum number of virtual CPUs this instance will consume when running on a sole-tenant node. + * The minimum number of virtual CPUs this instance will consume when running + * on a sole-tenant node. * * Generated from protobuf field optional int32 min_node_cpus = 317231675; * @return int @@ -428,7 +521,8 @@ public function clearMinNodeCpus() } /** - * The minimum number of virtual CPUs this instance will consume when running on a sole-tenant node. + * The minimum number of virtual CPUs this instance will consume when running + * on a sole-tenant node. * * Generated from protobuf field optional int32 min_node_cpus = 317231675; * @param int $var @@ -443,7 +537,9 @@ public function setMinNodeCpus($var) } /** - * A set of node affinity and anti-affinity configurations. Refer to Configuring node affinity for more information. Overrides reservationAffinity. + * A set of node affinity and anti-affinity configurations. Refer toConfiguring node + * affinity for more information. + * Overrides reservationAffinity. * * Generated from protobuf field repeated .google.cloud.compute.v1.SchedulingNodeAffinity node_affinities = 461799971; * @return \Google\Protobuf\Internal\RepeatedField @@ -454,7 +550,9 @@ public function getNodeAffinities() } /** - * A set of node affinity and anti-affinity configurations. Refer to Configuring node affinity for more information. Overrides reservationAffinity. + * A set of node affinity and anti-affinity configurations. Refer toConfiguring node + * affinity for more information. + * Overrides reservationAffinity. * * Generated from protobuf field repeated .google.cloud.compute.v1.SchedulingNodeAffinity node_affinities = 461799971; * @param array<\Google\Cloud\Compute\V1\SchedulingNodeAffinity>|\Google\Protobuf\Internal\RepeatedField $var @@ -469,7 +567,12 @@ public function setNodeAffinities($var) } /** - * Defines the maintenance behavior for this instance. For standard instances, the default behavior is MIGRATE. For preemptible instances, the default and only possible behavior is TERMINATE. For more information, see Set VM host maintenance policy. + * Defines the maintenance behavior for this instance. For standard instances, + * the default behavior is MIGRATE. Forpreemptible instances, + * the default and only possible behavior is TERMINATE. For more + * information, see + * Set + * VM host maintenance policy. * Check the OnHostMaintenance enum for the list of possible values. * * Generated from protobuf field optional string on_host_maintenance = 64616796; @@ -491,7 +594,12 @@ public function clearOnHostMaintenance() } /** - * Defines the maintenance behavior for this instance. For standard instances, the default behavior is MIGRATE. For preemptible instances, the default and only possible behavior is TERMINATE. For more information, see Set VM host maintenance policy. + * Defines the maintenance behavior for this instance. For standard instances, + * the default behavior is MIGRATE. Forpreemptible instances, + * the default and only possible behavior is TERMINATE. For more + * information, see + * Set + * VM host maintenance policy. * Check the OnHostMaintenance enum for the list of possible values. * * Generated from protobuf field optional string on_host_maintenance = 64616796; @@ -539,7 +647,10 @@ public function setOnInstanceStopAction($var) } /** - * Defines whether the instance is preemptible. This can only be set during instance creation or while the instance is stopped and therefore, in a `TERMINATED` state. See Instance Life Cycle for more information on the possible instance states. + * Defines whether the instance is preemptible. This can only be set during + * instance creation or while the instance isstopped and + * therefore, in a `TERMINATED` state. SeeInstance Life + * Cycle for more information on the possible instance states. * * Generated from protobuf field optional bool preemptible = 324203169; * @return bool @@ -560,7 +671,10 @@ public function clearPreemptible() } /** - * Defines whether the instance is preemptible. This can only be set during instance creation or while the instance is stopped and therefore, in a `TERMINATED` state. See Instance Life Cycle for more information on the possible instance states. + * Defines whether the instance is preemptible. This can only be set during + * instance creation or while the instance isstopped and + * therefore, in a `TERMINATED` state. SeeInstance Life + * Cycle for more information on the possible instance states. * * Generated from protobuf field optional bool preemptible = 324203169; * @param bool $var @@ -613,7 +727,9 @@ public function setProvisioningModel($var) } /** - * Default is false and there will be 120 seconds between GCE ACPI G2 Soft Off and ACPI G3 Mechanical Off for Standard VMs and 30 seconds for Spot VMs. + * Default is false and there will be 120 seconds between GCE ACPI G2 Soft + * Off and ACPI G3 Mechanical + * Off for Standard VMs and 30 seconds for Spot VMs. * * Generated from protobuf field optional bool skip_guest_os_shutdown = 201662378; * @return bool @@ -634,7 +750,9 @@ public function clearSkipGuestOsShutdown() } /** - * Default is false and there will be 120 seconds between GCE ACPI G2 Soft Off and ACPI G3 Mechanical Off for Standard VMs and 30 seconds for Spot VMs. + * Default is false and there will be 120 seconds between GCE ACPI G2 Soft + * Off and ACPI G3 Mechanical + * Off for Standard VMs and 30 seconds for Spot VMs. * * Generated from protobuf field optional bool skip_guest_os_shutdown = 201662378; * @param bool $var @@ -649,7 +767,8 @@ public function setSkipGuestOsShutdown($var) } /** - * Specifies the timestamp, when the instance will be terminated, in RFC3339 text format. If specified, the instance termination action will be performed at the termination time. + * Specifies the timestamp, when the instance will be terminated, inRFC3339 text format. If specified, the instance + * termination action will be performed at the termination time. * * Generated from protobuf field optional string termination_time = 428082984; * @return string @@ -670,7 +789,8 @@ public function clearTerminationTime() } /** - * Specifies the timestamp, when the instance will be terminated, in RFC3339 text format. If specified, the instance termination action will be performed at the termination time. + * Specifies the timestamp, when the instance will be terminated, inRFC3339 text format. If specified, the instance + * termination action will be performed at the termination time. * * Generated from protobuf field optional string termination_time = 428082984; * @param string $var diff --git a/Compute/src/V1/Scheduling/OnHostMaintenance.php b/Compute/src/V1/Scheduling/OnHostMaintenance.php index 337c38b883ec..1514e8571d51 100644 --- a/Compute/src/V1/Scheduling/OnHostMaintenance.php +++ b/Compute/src/V1/Scheduling/OnHostMaintenance.php @@ -7,7 +7,12 @@ use UnexpectedValueException; /** - * Defines the maintenance behavior for this instance. For standard instances, the default behavior is MIGRATE. For preemptible instances, the default and only possible behavior is TERMINATE. For more information, see Set VM host maintenance policy. + * Defines the maintenance behavior for this instance. For standard instances, + * the default behavior is MIGRATE. Forpreemptible instances, + * the default and only possible behavior is TERMINATE. For more + * information, see + * Set + * VM host maintenance policy. * * Protobuf type google.cloud.compute.v1.Scheduling.OnHostMaintenance */ @@ -20,13 +25,18 @@ class OnHostMaintenance */ const UNDEFINED_ON_HOST_MAINTENANCE = 0; /** - * *[Default]* Allows Compute Engine to automatically migrate instances out of the way of maintenance events. + * *[Default]* Allows Compute Engine to automatically migrate instances + * out of the way of maintenance events. * * Generated from protobuf enum MIGRATE = 165699979; */ const MIGRATE = 165699979; /** - * Tells Compute Engine to terminate and (optionally) restart the instance away from the maintenance activity. If you would like your instance to be restarted, set the automaticRestart flag to true. Your instance may be restarted more than once, and it may be restarted outside the window of maintenance events. + * Tells Compute Engine to terminate and (optionally) restart the instance + * away from the maintenance activity. If you would like your instance to be + * restarted, set the automaticRestart flag to true. Your + * instance may be restarted more than once, and it may be restarted outside + * the window of maintenance events. * * Generated from protobuf enum TERMINATE = 527617601; */ diff --git a/Compute/src/V1/Scheduling/ProvisioningModel.php b/Compute/src/V1/Scheduling/ProvisioningModel.php index d933d44f1f04..5123a7967db3 100644 --- a/Compute/src/V1/Scheduling/ProvisioningModel.php +++ b/Compute/src/V1/Scheduling/ProvisioningModel.php @@ -20,7 +20,8 @@ class ProvisioningModel */ const UNDEFINED_PROVISIONING_MODEL = 0; /** - * Instance is provisioned using the Flex Start provisioning model and has a limited runtime. + * Instance is provisioned using the Flex Start provisioning model and + * has a limited runtime. * * Generated from protobuf enum FLEX_START = 101746812; */ diff --git a/Compute/src/V1/SchedulingNodeAffinity.php b/Compute/src/V1/SchedulingNodeAffinity.php index c2d90f28a17f..124c6d6e50f7 100644 --- a/Compute/src/V1/SchedulingNodeAffinity.php +++ b/Compute/src/V1/SchedulingNodeAffinity.php @@ -9,7 +9,8 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Node Affinity: the configuration of desired nodes onto which this Instance could be scheduled. + * Node Affinity: the configuration of desired nodes onto which this Instance + * could be scheduled. * * Generated from protobuf message google.cloud.compute.v1.SchedulingNodeAffinity */ @@ -22,7 +23,7 @@ class SchedulingNodeAffinity extends \Google\Protobuf\Internal\Message */ protected $key = null; /** - * Defines the operation of node selection. Valid operators are IN for affinity and NOT_IN for anti-affinity. + * Defines the operation of node selection. Valid operators areIN for affinity and NOT_IN for anti-affinity. * Check the Operator enum for the list of possible values. * * Generated from protobuf field optional string operator = 36317348; @@ -44,7 +45,7 @@ class SchedulingNodeAffinity extends \Google\Protobuf\Internal\Message * @type string $key * Corresponds to the label key of Node resource. * @type string $operator - * Defines the operation of node selection. Valid operators are IN for affinity and NOT_IN for anti-affinity. + * Defines the operation of node selection. Valid operators areIN for affinity and NOT_IN for anti-affinity. * Check the Operator enum for the list of possible values. * @type array|\Google\Protobuf\Internal\RepeatedField $values * Corresponds to the label values of Node resource. @@ -92,7 +93,7 @@ public function setKey($var) } /** - * Defines the operation of node selection. Valid operators are IN for affinity and NOT_IN for anti-affinity. + * Defines the operation of node selection. Valid operators areIN for affinity and NOT_IN for anti-affinity. * Check the Operator enum for the list of possible values. * * Generated from protobuf field optional string operator = 36317348; @@ -114,7 +115,7 @@ public function clearOperator() } /** - * Defines the operation of node selection. Valid operators are IN for affinity and NOT_IN for anti-affinity. + * Defines the operation of node selection. Valid operators areIN for affinity and NOT_IN for anti-affinity. * Check the Operator enum for the list of possible values. * * Generated from protobuf field optional string operator = 36317348; diff --git a/Compute/src/V1/SchedulingNodeAffinity/Operator.php b/Compute/src/V1/SchedulingNodeAffinity/Operator.php index 64c6c68ca6c5..d2311ba03024 100644 --- a/Compute/src/V1/SchedulingNodeAffinity/Operator.php +++ b/Compute/src/V1/SchedulingNodeAffinity/Operator.php @@ -7,7 +7,7 @@ use UnexpectedValueException; /** - * Defines the operation of node selection. Valid operators are IN for affinity and NOT_IN for anti-affinity. + * Defines the operation of node selection. Valid operators areIN for affinity and NOT_IN for anti-affinity. * * Protobuf type google.cloud.compute.v1.SchedulingNodeAffinity.Operator */ diff --git a/Compute/src/V1/SchedulingOnInstanceStopAction.php b/Compute/src/V1/SchedulingOnInstanceStopAction.php index 14119bed879c..b9950ea6ddfb 100644 --- a/Compute/src/V1/SchedulingOnInstanceStopAction.php +++ b/Compute/src/V1/SchedulingOnInstanceStopAction.php @@ -9,14 +9,16 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Defines the behaviour for instances with the instance_termination_action STOP. + * Defines the behaviour for instances with the instance_termination_actionSTOP. * * Generated from protobuf message google.cloud.compute.v1.SchedulingOnInstanceStopAction */ class SchedulingOnInstanceStopAction extends \Google\Protobuf\Internal\Message { /** - * If true, the contents of any attached Local SSD disks will be discarded else, the Local SSD data will be preserved when the instance is stopped at the end of the run duration/termination time. + * If true, the contents of any attached Local SSD disks will be discarded + * else, the Local SSD data will be preserved when the instance is stopped + * at the end of the run duration/termination time. * * Generated from protobuf field optional bool discard_local_ssd = 319517903; */ @@ -29,7 +31,9 @@ class SchedulingOnInstanceStopAction extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type bool $discard_local_ssd - * If true, the contents of any attached Local SSD disks will be discarded else, the Local SSD data will be preserved when the instance is stopped at the end of the run duration/termination time. + * If true, the contents of any attached Local SSD disks will be discarded + * else, the Local SSD data will be preserved when the instance is stopped + * at the end of the run duration/termination time. * } */ public function __construct($data = NULL) { @@ -38,7 +42,9 @@ public function __construct($data = NULL) { } /** - * If true, the contents of any attached Local SSD disks will be discarded else, the Local SSD data will be preserved when the instance is stopped at the end of the run duration/termination time. + * If true, the contents of any attached Local SSD disks will be discarded + * else, the Local SSD data will be preserved when the instance is stopped + * at the end of the run duration/termination time. * * Generated from protobuf field optional bool discard_local_ssd = 319517903; * @return bool @@ -59,7 +65,9 @@ public function clearDiscardLocalSsd() } /** - * If true, the contents of any attached Local SSD disks will be discarded else, the Local SSD data will be preserved when the instance is stopped at the end of the run duration/termination time. + * If true, the contents of any attached Local SSD disks will be discarded + * else, the Local SSD data will be preserved when the instance is stopped + * at the end of the run duration/termination time. * * Generated from protobuf field optional bool discard_local_ssd = 319517903; * @param bool $var diff --git a/Compute/src/V1/Screenshot.php b/Compute/src/V1/Screenshot.php index c550d1905ed0..1a9f59d1440e 100644 --- a/Compute/src/V1/Screenshot.php +++ b/Compute/src/V1/Screenshot.php @@ -22,7 +22,8 @@ class Screenshot extends \Google\Protobuf\Internal\Message */ protected $contents = null; /** - * [Output Only] Type of the resource. Always compute#screenshot for the screenshots. + * [Output Only] Type of the resource. Always compute#screenshot + * for the screenshots. * * Generated from protobuf field optional string kind = 3292052; */ @@ -37,7 +38,8 @@ class Screenshot extends \Google\Protobuf\Internal\Message * @type string $contents * [Output Only] The Base64-encoded screenshot data. * @type string $kind - * [Output Only] Type of the resource. Always compute#screenshot for the screenshots. + * [Output Only] Type of the resource. Always compute#screenshot + * for the screenshots. * } */ public function __construct($data = NULL) { @@ -82,7 +84,8 @@ public function setContents($var) } /** - * [Output Only] Type of the resource. Always compute#screenshot for the screenshots. + * [Output Only] Type of the resource. Always compute#screenshot + * for the screenshots. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -103,7 +106,8 @@ public function clearKind() } /** - * [Output Only] Type of the resource. Always compute#screenshot for the screenshots. + * [Output Only] Type of the resource. Always compute#screenshot + * for the screenshots. * * Generated from protobuf field optional string kind = 3292052; * @param string $var diff --git a/Compute/src/V1/SecurityPoliciesAggregatedList.php b/Compute/src/V1/SecurityPoliciesAggregatedList.php index b9d2ab1d011c..db45a015abdc 100644 --- a/Compute/src/V1/SecurityPoliciesAggregatedList.php +++ b/Compute/src/V1/SecurityPoliciesAggregatedList.php @@ -31,13 +31,18 @@ class SecurityPoliciesAggregatedList extends \Google\Protobuf\Internal\Message */ private $items; /** - * [Output Only] Type of resource. Always compute#securityPolicyAggregatedList for lists of Security Policies. + * [Output Only] Type of resource. Alwayscompute#securityPolicyAggregatedList for lists of Security + * Policies. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -73,9 +78,14 @@ class SecurityPoliciesAggregatedList extends \Google\Protobuf\Internal\Message * @type array|\Google\Protobuf\Internal\MapField $items * A list of SecurityPoliciesScopedList resources. * @type string $kind - * [Output Only] Type of resource. Always compute#securityPolicyAggregatedList for lists of Security Policies. + * [Output Only] Type of resource. Alwayscompute#securityPolicyAggregatedList for lists of Security + * Policies. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type array|\Google\Protobuf\Internal\RepeatedField $unreachables @@ -184,7 +194,8 @@ public function setItems($var) } /** - * [Output Only] Type of resource. Always compute#securityPolicyAggregatedList for lists of Security Policies. + * [Output Only] Type of resource. Alwayscompute#securityPolicyAggregatedList for lists of Security + * Policies. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -205,7 +216,8 @@ public function clearKind() } /** - * [Output Only] Type of resource. Always compute#securityPolicyAggregatedList for lists of Security Policies. + * [Output Only] Type of resource. Alwayscompute#securityPolicyAggregatedList for lists of Security + * Policies. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -220,7 +232,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -241,7 +257,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/SecurityPoliciesScopedList.php b/Compute/src/V1/SecurityPoliciesScopedList.php index d691acd38118..d02441818ba7 100644 --- a/Compute/src/V1/SecurityPoliciesScopedList.php +++ b/Compute/src/V1/SecurityPoliciesScopedList.php @@ -21,7 +21,8 @@ class SecurityPoliciesScopedList extends \Google\Protobuf\Internal\Message */ private $security_policies; /** - * Informational warning which replaces the list of security policies when the list is empty. + * Informational warning which replaces the list of + * security policies when the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; */ @@ -36,7 +37,8 @@ class SecurityPoliciesScopedList extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\SecurityPolicy>|\Google\Protobuf\Internal\RepeatedField $security_policies * A list of SecurityPolicies contained in this scope. * @type \Google\Cloud\Compute\V1\Warning $warning - * Informational warning which replaces the list of security policies when the list is empty. + * Informational warning which replaces the list of + * security policies when the list is empty. * } */ public function __construct($data = NULL) { @@ -71,7 +73,8 @@ public function setSecurityPolicies($var) } /** - * Informational warning which replaces the list of security policies when the list is empty. + * Informational warning which replaces the list of + * security policies when the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; * @return \Google\Cloud\Compute\V1\Warning|null @@ -92,7 +95,8 @@ public function clearWarning() } /** - * Informational warning which replaces the list of security policies when the list is empty. + * Informational warning which replaces the list of + * security policies when the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; * @param \Google\Cloud\Compute\V1\Warning $var diff --git a/Compute/src/V1/SecurityPolicy.php b/Compute/src/V1/SecurityPolicy.php index d1667f61cb7e..fbfa6813bfe4 100644 --- a/Compute/src/V1/SecurityPolicy.php +++ b/Compute/src/V1/SecurityPolicy.php @@ -9,7 +9,10 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Represents a Google Cloud Armor security policy resource. Only external backend services that use load balancers can reference a security policy. For more information, see Google Cloud Armor security policy overview. + * Represents a Google Cloud Armor security policy resource. + * Only external backend services that use load balancers can + * reference a security policy. For more information, see + * Google Cloud Armor security policy overview. * * Generated from protobuf message google.cloud.compute.v1.SecurityPolicy */ @@ -30,7 +33,8 @@ class SecurityPolicy extends \Google\Protobuf\Internal\Message */ private $associations; /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; */ @@ -40,59 +44,94 @@ class SecurityPolicy extends \Google\Protobuf\Internal\Message */ protected $ddos_protection_config = null; /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; */ protected $description = null; /** - * Specifies a fingerprint for this resource, which is essentially a hash of the metadata's contents and used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update metadata. You must always provide an up-to-date fingerprint hash in order to update or change metadata, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make get() request to the security policy. + * Specifies a fingerprint for this resource, which is essentially a hash of + * the metadata's contents and used for optimistic locking. The + * fingerprint is initially generated by Compute Engine and changes after + * every request to modify or update metadata. You must always provide an + * up-to-date fingerprint hash in order to update or change metadata, + * otherwise the request will fail with error412 conditionNotMet. + * To see the latest fingerprint, make get() request to the + * security policy. * * Generated from protobuf field optional string fingerprint = 234678500; */ protected $fingerprint = null; /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; */ protected $id = null; /** - * [Output only] Type of the resource. Always compute#securityPolicyfor security policies + * [Output only] Type of the resource. Alwayscompute#securityPolicyfor security policies * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * A fingerprint for the labels being applied to this security policy, which is essentially a hash of the labels set used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels. To see the latest fingerprint, make get() request to the security policy. + * A fingerprint for the labels being applied to this security policy, which + * is essentially a hash of the labels set used for optimistic locking. The + * fingerprint is initially generated by Compute Engine and changes after + * every request to modify or update labels. You must always provide an + * up-to-date fingerprint hash in order to update or change labels. + * To see the latest fingerprint, make get() request to the + * security policy. * * Generated from protobuf field optional string label_fingerprint = 178124825; */ protected $label_fingerprint = null; /** - * Labels for this resource. These can only be added or modified by the setLabels method. Each label key/value pair must comply with RFC1035. Label values may be empty. + * Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035. + * Label values may be empty. * * Generated from protobuf field map labels = 500195327; */ private $labels; /** - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * * Generated from protobuf field optional string name = 3373707; */ protected $name = null; + /** + * [Output Only] The parent of the security policy. + * + * Generated from protobuf field optional string parent = 78317738; + */ + protected $parent = null; /** * Generated from protobuf field optional .google.cloud.compute.v1.SecurityPolicyRecaptchaOptionsConfig recaptcha_options_config = 519006811; */ protected $recaptcha_options_config = null; /** - * [Output Only] URL of the region where the regional security policy resides. This field is not applicable to global security policies. + * [Output Only] URL of the region where the regional security policy + * resides. This field is not applicable to global security policies. * * Generated from protobuf field optional string region = 138946292; */ protected $region = null; /** - * A list of rules that belong to this policy. There must always be a default rule which is a rule with priority 2147483647 and match all condition (for the match condition this means match "*" for srcIpRanges and for the networkMatch condition every field must be either match "*" or not set). If no rules are provided when creating a security policy, a default rule with action "allow" will be added. + * A list of rules that belong to this policy. + * There must always be a default rule which is a rule with priority + * 2147483647 and match all condition (for the match condition this means + * match "*" for srcIpRanges and for the networkMatch condition every field + * must be either match "*" or not set). If no rules are provided when + * creating a security policy, a default rule with action "allow" will be + * added. * * Generated from protobuf field repeated .google.cloud.compute.v1.SecurityPolicyRule rules = 108873975; */ @@ -104,20 +143,56 @@ class SecurityPolicy extends \Google\Protobuf\Internal\Message */ protected $self_link = null; /** - * User-provided name of the organization security policy. The name should be unique in the organization in which the security policy is created. This should only be used when SecurityPolicyType is CLOUD_ARMOR. The name must be 1-63 characters long, and comply with https://www.ietf.org/rfc/rfc1035.txt. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * User-provided name of the organization security policy. The name should be + * unique in the organization in which the security policy is created. This + * should only be used when SecurityPolicyType is CLOUD_ARMOR. + * The name must be 1-63 characters long, and comply with + * https://www.ietf.org/rfc/rfc1035.txt. Specifically, the name must be 1-63 + * characters long and match the regular expression + * `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a + * lowercase letter, and all following characters must be a dash, lowercase + * letter, or digit, except the last character, which cannot be a dash. * * Generated from protobuf field optional string short_name = 492051566; */ protected $short_name = null; /** - * The type indicates the intended use of the security policy. - CLOUD_ARMOR: Cloud Armor backend security policies can be configured to filter incoming HTTP requests targeting backend services. They filter requests before they hit the origin servers. - CLOUD_ARMOR_EDGE: Cloud Armor edge security policies can be configured to filter incoming HTTP requests targeting backend services (including Cloud CDN-enabled) as well as backend buckets (Cloud Storage). They filter requests before the request is served from Google's cache. - CLOUD_ARMOR_INTERNAL_SERVICE (preview only): Cloud Armor internal service policies can be configured to filter HTTP requests targeting services managed by Traffic Director in a service mesh. They filter requests before the request is served from the application. - CLOUD_ARMOR_NETWORK: Cloud Armor network policies can be configured to filter packets targeting network load balancing resources such as backend services, target pools, target instances, and instances with external IPs. They filter requests before the request is served from the application. This field can be set only at resource creation time. + * The type indicates the intended use of the security policy. + * - CLOUD_ARMOR: Cloud Armor backend security policies can + * be configured to filter incoming HTTP requests targeting backend services. + * They filter requests before they hit the origin servers. + * - CLOUD_ARMOR_EDGE: Cloud Armor edge security policies can + * be configured to filter incoming HTTP requests targeting backend services + * (including Cloud CDN-enabled) as well as backend buckets (Cloud Storage). + * They filter requests before the request is served from Google's cache. + * - CLOUD_ARMOR_INTERNAL_SERVICE (preview only): Cloud Armor + * internal service policies can be configured to filter HTTP requests + * targeting services managed by Traffic Director in a service mesh. They + * filter requests before the request is served from the application. + * - CLOUD_ARMOR_NETWORK: Cloud Armor network policies + * can be configured to filter packets targeting network load balancing + * resources such as backend services, target pools, target instances, and + * instances with external IPs. They filter requests before the request is + * served from the application. + * This field can be set only at resource creation time. * Check the Type enum for the list of possible values. * * Generated from protobuf field optional string type = 3575610; */ protected $type = null; /** - * Definitions of user-defined fields for CLOUD_ARMOR_NETWORK policies. A user-defined field consists of up to 4 bytes extracted from a fixed offset in the packet, relative to the IPv4, IPv6, TCP, or UDP header, with an optional mask to select certain bits. Rules may then specify matching values for these fields. Example: userDefinedFields: - name: "ipv4_fragment_offset" base: IPV4 offset: 6 size: 2 mask: "0x1fff" + * Definitions of user-defined fields for CLOUD_ARMOR_NETWORK policies. A + * user-defined field consists of up to 4 bytes extracted from a fixed offset + * in the packet, relative to the IPv4, IPv6, TCP, or UDP header, with an + * optional mask to select certain bits. Rules may then specify matching + * values for these fields. + * Example: + * userDefinedFields: + * - name: "ipv4_fragment_offset" + * base: IPV4 + * offset: 6 + * size: 2 + * mask: "0x1fff" * * Generated from protobuf field repeated .google.cloud.compute.v1.SecurityPolicyUserDefinedField user_defined_fields = 28312739; */ @@ -134,36 +209,104 @@ class SecurityPolicy extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\SecurityPolicyAssociation>|\Google\Protobuf\Internal\RepeatedField $associations * A list of associations that belong to this policy. * @type string $creation_timestamp - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * @type \Google\Cloud\Compute\V1\SecurityPolicyDdosProtectionConfig $ddos_protection_config * @type string $description - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * @type string $fingerprint - * Specifies a fingerprint for this resource, which is essentially a hash of the metadata's contents and used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update metadata. You must always provide an up-to-date fingerprint hash in order to update or change metadata, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make get() request to the security policy. + * Specifies a fingerprint for this resource, which is essentially a hash of + * the metadata's contents and used for optimistic locking. The + * fingerprint is initially generated by Compute Engine and changes after + * every request to modify or update metadata. You must always provide an + * up-to-date fingerprint hash in order to update or change metadata, + * otherwise the request will fail with error412 conditionNotMet. + * To see the latest fingerprint, make get() request to the + * security policy. * @type int|string $id - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * @type string $kind - * [Output only] Type of the resource. Always compute#securityPolicyfor security policies + * [Output only] Type of the resource. Alwayscompute#securityPolicyfor security policies * @type string $label_fingerprint - * A fingerprint for the labels being applied to this security policy, which is essentially a hash of the labels set used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels. To see the latest fingerprint, make get() request to the security policy. + * A fingerprint for the labels being applied to this security policy, which + * is essentially a hash of the labels set used for optimistic locking. The + * fingerprint is initially generated by Compute Engine and changes after + * every request to modify or update labels. You must always provide an + * up-to-date fingerprint hash in order to update or change labels. + * To see the latest fingerprint, make get() request to the + * security policy. * @type array|\Google\Protobuf\Internal\MapField $labels - * Labels for this resource. These can only be added or modified by the setLabels method. Each label key/value pair must comply with RFC1035. Label values may be empty. + * Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035. + * Label values may be empty. * @type string $name - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. + * @type string $parent + * [Output Only] The parent of the security policy. * @type \Google\Cloud\Compute\V1\SecurityPolicyRecaptchaOptionsConfig $recaptcha_options_config * @type string $region - * [Output Only] URL of the region where the regional security policy resides. This field is not applicable to global security policies. + * [Output Only] URL of the region where the regional security policy + * resides. This field is not applicable to global security policies. * @type array<\Google\Cloud\Compute\V1\SecurityPolicyRule>|\Google\Protobuf\Internal\RepeatedField $rules - * A list of rules that belong to this policy. There must always be a default rule which is a rule with priority 2147483647 and match all condition (for the match condition this means match "*" for srcIpRanges and for the networkMatch condition every field must be either match "*" or not set). If no rules are provided when creating a security policy, a default rule with action "allow" will be added. + * A list of rules that belong to this policy. + * There must always be a default rule which is a rule with priority + * 2147483647 and match all condition (for the match condition this means + * match "*" for srcIpRanges and for the networkMatch condition every field + * must be either match "*" or not set). If no rules are provided when + * creating a security policy, a default rule with action "allow" will be + * added. * @type string $self_link * [Output Only] Server-defined URL for the resource. * @type string $short_name - * User-provided name of the organization security policy. The name should be unique in the organization in which the security policy is created. This should only be used when SecurityPolicyType is CLOUD_ARMOR. The name must be 1-63 characters long, and comply with https://www.ietf.org/rfc/rfc1035.txt. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * User-provided name of the organization security policy. The name should be + * unique in the organization in which the security policy is created. This + * should only be used when SecurityPolicyType is CLOUD_ARMOR. + * The name must be 1-63 characters long, and comply with + * https://www.ietf.org/rfc/rfc1035.txt. Specifically, the name must be 1-63 + * characters long and match the regular expression + * `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a + * lowercase letter, and all following characters must be a dash, lowercase + * letter, or digit, except the last character, which cannot be a dash. * @type string $type - * The type indicates the intended use of the security policy. - CLOUD_ARMOR: Cloud Armor backend security policies can be configured to filter incoming HTTP requests targeting backend services. They filter requests before they hit the origin servers. - CLOUD_ARMOR_EDGE: Cloud Armor edge security policies can be configured to filter incoming HTTP requests targeting backend services (including Cloud CDN-enabled) as well as backend buckets (Cloud Storage). They filter requests before the request is served from Google's cache. - CLOUD_ARMOR_INTERNAL_SERVICE (preview only): Cloud Armor internal service policies can be configured to filter HTTP requests targeting services managed by Traffic Director in a service mesh. They filter requests before the request is served from the application. - CLOUD_ARMOR_NETWORK: Cloud Armor network policies can be configured to filter packets targeting network load balancing resources such as backend services, target pools, target instances, and instances with external IPs. They filter requests before the request is served from the application. This field can be set only at resource creation time. + * The type indicates the intended use of the security policy. + * - CLOUD_ARMOR: Cloud Armor backend security policies can + * be configured to filter incoming HTTP requests targeting backend services. + * They filter requests before they hit the origin servers. + * - CLOUD_ARMOR_EDGE: Cloud Armor edge security policies can + * be configured to filter incoming HTTP requests targeting backend services + * (including Cloud CDN-enabled) as well as backend buckets (Cloud Storage). + * They filter requests before the request is served from Google's cache. + * - CLOUD_ARMOR_INTERNAL_SERVICE (preview only): Cloud Armor + * internal service policies can be configured to filter HTTP requests + * targeting services managed by Traffic Director in a service mesh. They + * filter requests before the request is served from the application. + * - CLOUD_ARMOR_NETWORK: Cloud Armor network policies + * can be configured to filter packets targeting network load balancing + * resources such as backend services, target pools, target instances, and + * instances with external IPs. They filter requests before the request is + * served from the application. + * This field can be set only at resource creation time. * Check the Type enum for the list of possible values. * @type array<\Google\Cloud\Compute\V1\SecurityPolicyUserDefinedField>|\Google\Protobuf\Internal\RepeatedField $user_defined_fields - * Definitions of user-defined fields for CLOUD_ARMOR_NETWORK policies. A user-defined field consists of up to 4 bytes extracted from a fixed offset in the packet, relative to the IPv4, IPv6, TCP, or UDP header, with an optional mask to select certain bits. Rules may then specify matching values for these fields. Example: userDefinedFields: - name: "ipv4_fragment_offset" base: IPV4 offset: 6 size: 2 mask: "0x1fff" + * Definitions of user-defined fields for CLOUD_ARMOR_NETWORK policies. A + * user-defined field consists of up to 4 bytes extracted from a fixed offset + * in the packet, relative to the IPv4, IPv6, TCP, or UDP header, with an + * optional mask to select certain bits. Rules may then specify matching + * values for these fields. + * Example: + * userDefinedFields: + * - name: "ipv4_fragment_offset" + * base: IPV4 + * offset: 6 + * size: 2 + * mask: "0x1fff" * } */ public function __construct($data = NULL) { @@ -262,7 +405,8 @@ public function setAssociations($var) } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @return string @@ -283,7 +427,8 @@ public function clearCreationTimestamp() } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @param string $var @@ -330,7 +475,8 @@ public function setDdosProtectionConfig($var) } /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @return string @@ -351,7 +497,8 @@ public function clearDescription() } /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @param string $var @@ -366,7 +513,14 @@ public function setDescription($var) } /** - * Specifies a fingerprint for this resource, which is essentially a hash of the metadata's contents and used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update metadata. You must always provide an up-to-date fingerprint hash in order to update or change metadata, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make get() request to the security policy. + * Specifies a fingerprint for this resource, which is essentially a hash of + * the metadata's contents and used for optimistic locking. The + * fingerprint is initially generated by Compute Engine and changes after + * every request to modify or update metadata. You must always provide an + * up-to-date fingerprint hash in order to update or change metadata, + * otherwise the request will fail with error412 conditionNotMet. + * To see the latest fingerprint, make get() request to the + * security policy. * * Generated from protobuf field optional string fingerprint = 234678500; * @return string @@ -387,7 +541,14 @@ public function clearFingerprint() } /** - * Specifies a fingerprint for this resource, which is essentially a hash of the metadata's contents and used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update metadata. You must always provide an up-to-date fingerprint hash in order to update or change metadata, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make get() request to the security policy. + * Specifies a fingerprint for this resource, which is essentially a hash of + * the metadata's contents and used for optimistic locking. The + * fingerprint is initially generated by Compute Engine and changes after + * every request to modify or update metadata. You must always provide an + * up-to-date fingerprint hash in order to update or change metadata, + * otherwise the request will fail with error412 conditionNotMet. + * To see the latest fingerprint, make get() request to the + * security policy. * * Generated from protobuf field optional string fingerprint = 234678500; * @param string $var @@ -402,7 +563,8 @@ public function setFingerprint($var) } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @return int|string @@ -423,7 +585,8 @@ public function clearId() } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @param int|string $var @@ -438,7 +601,7 @@ public function setId($var) } /** - * [Output only] Type of the resource. Always compute#securityPolicyfor security policies + * [Output only] Type of the resource. Alwayscompute#securityPolicyfor security policies * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -459,7 +622,7 @@ public function clearKind() } /** - * [Output only] Type of the resource. Always compute#securityPolicyfor security policies + * [Output only] Type of the resource. Alwayscompute#securityPolicyfor security policies * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -474,7 +637,13 @@ public function setKind($var) } /** - * A fingerprint for the labels being applied to this security policy, which is essentially a hash of the labels set used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels. To see the latest fingerprint, make get() request to the security policy. + * A fingerprint for the labels being applied to this security policy, which + * is essentially a hash of the labels set used for optimistic locking. The + * fingerprint is initially generated by Compute Engine and changes after + * every request to modify or update labels. You must always provide an + * up-to-date fingerprint hash in order to update or change labels. + * To see the latest fingerprint, make get() request to the + * security policy. * * Generated from protobuf field optional string label_fingerprint = 178124825; * @return string @@ -495,7 +664,13 @@ public function clearLabelFingerprint() } /** - * A fingerprint for the labels being applied to this security policy, which is essentially a hash of the labels set used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels. To see the latest fingerprint, make get() request to the security policy. + * A fingerprint for the labels being applied to this security policy, which + * is essentially a hash of the labels set used for optimistic locking. The + * fingerprint is initially generated by Compute Engine and changes after + * every request to modify or update labels. You must always provide an + * up-to-date fingerprint hash in order to update or change labels. + * To see the latest fingerprint, make get() request to the + * security policy. * * Generated from protobuf field optional string label_fingerprint = 178124825; * @param string $var @@ -510,7 +685,8 @@ public function setLabelFingerprint($var) } /** - * Labels for this resource. These can only be added or modified by the setLabels method. Each label key/value pair must comply with RFC1035. Label values may be empty. + * Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035. + * Label values may be empty. * * Generated from protobuf field map labels = 500195327; * @return \Google\Protobuf\Internal\MapField @@ -521,7 +697,8 @@ public function getLabels() } /** - * Labels for this resource. These can only be added or modified by the setLabels method. Each label key/value pair must comply with RFC1035. Label values may be empty. + * Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035. + * Label values may be empty. * * Generated from protobuf field map labels = 500195327; * @param array|\Google\Protobuf\Internal\MapField $var @@ -536,7 +713,13 @@ public function setLabels($var) } /** - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * * Generated from protobuf field optional string name = 3373707; * @return string @@ -557,7 +740,13 @@ public function clearName() } /** - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * * Generated from protobuf field optional string name = 3373707; * @param string $var @@ -571,6 +760,42 @@ public function setName($var) return $this; } + /** + * [Output Only] The parent of the security policy. + * + * Generated from protobuf field optional string parent = 78317738; + * @return string + */ + public function getParent() + { + return isset($this->parent) ? $this->parent : ''; + } + + public function hasParent() + { + return isset($this->parent); + } + + public function clearParent() + { + unset($this->parent); + } + + /** + * [Output Only] The parent of the security policy. + * + * Generated from protobuf field optional string parent = 78317738; + * @param string $var + * @return $this + */ + public function setParent($var) + { + GPBUtil::checkString($var, True); + $this->parent = $var; + + return $this; + } + /** * Generated from protobuf field optional .google.cloud.compute.v1.SecurityPolicyRecaptchaOptionsConfig recaptcha_options_config = 519006811; * @return \Google\Cloud\Compute\V1\SecurityPolicyRecaptchaOptionsConfig|null @@ -604,7 +829,8 @@ public function setRecaptchaOptionsConfig($var) } /** - * [Output Only] URL of the region where the regional security policy resides. This field is not applicable to global security policies. + * [Output Only] URL of the region where the regional security policy + * resides. This field is not applicable to global security policies. * * Generated from protobuf field optional string region = 138946292; * @return string @@ -625,7 +851,8 @@ public function clearRegion() } /** - * [Output Only] URL of the region where the regional security policy resides. This field is not applicable to global security policies. + * [Output Only] URL of the region where the regional security policy + * resides. This field is not applicable to global security policies. * * Generated from protobuf field optional string region = 138946292; * @param string $var @@ -640,7 +867,13 @@ public function setRegion($var) } /** - * A list of rules that belong to this policy. There must always be a default rule which is a rule with priority 2147483647 and match all condition (for the match condition this means match "*" for srcIpRanges and for the networkMatch condition every field must be either match "*" or not set). If no rules are provided when creating a security policy, a default rule with action "allow" will be added. + * A list of rules that belong to this policy. + * There must always be a default rule which is a rule with priority + * 2147483647 and match all condition (for the match condition this means + * match "*" for srcIpRanges and for the networkMatch condition every field + * must be either match "*" or not set). If no rules are provided when + * creating a security policy, a default rule with action "allow" will be + * added. * * Generated from protobuf field repeated .google.cloud.compute.v1.SecurityPolicyRule rules = 108873975; * @return \Google\Protobuf\Internal\RepeatedField @@ -651,7 +884,13 @@ public function getRules() } /** - * A list of rules that belong to this policy. There must always be a default rule which is a rule with priority 2147483647 and match all condition (for the match condition this means match "*" for srcIpRanges and for the networkMatch condition every field must be either match "*" or not set). If no rules are provided when creating a security policy, a default rule with action "allow" will be added. + * A list of rules that belong to this policy. + * There must always be a default rule which is a rule with priority + * 2147483647 and match all condition (for the match condition this means + * match "*" for srcIpRanges and for the networkMatch condition every field + * must be either match "*" or not set). If no rules are provided when + * creating a security policy, a default rule with action "allow" will be + * added. * * Generated from protobuf field repeated .google.cloud.compute.v1.SecurityPolicyRule rules = 108873975; * @param array<\Google\Cloud\Compute\V1\SecurityPolicyRule>|\Google\Protobuf\Internal\RepeatedField $var @@ -702,7 +941,15 @@ public function setSelfLink($var) } /** - * User-provided name of the organization security policy. The name should be unique in the organization in which the security policy is created. This should only be used when SecurityPolicyType is CLOUD_ARMOR. The name must be 1-63 characters long, and comply with https://www.ietf.org/rfc/rfc1035.txt. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * User-provided name of the organization security policy. The name should be + * unique in the organization in which the security policy is created. This + * should only be used when SecurityPolicyType is CLOUD_ARMOR. + * The name must be 1-63 characters long, and comply with + * https://www.ietf.org/rfc/rfc1035.txt. Specifically, the name must be 1-63 + * characters long and match the regular expression + * `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a + * lowercase letter, and all following characters must be a dash, lowercase + * letter, or digit, except the last character, which cannot be a dash. * * Generated from protobuf field optional string short_name = 492051566; * @return string @@ -723,7 +970,15 @@ public function clearShortName() } /** - * User-provided name of the organization security policy. The name should be unique in the organization in which the security policy is created. This should only be used when SecurityPolicyType is CLOUD_ARMOR. The name must be 1-63 characters long, and comply with https://www.ietf.org/rfc/rfc1035.txt. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * User-provided name of the organization security policy. The name should be + * unique in the organization in which the security policy is created. This + * should only be used when SecurityPolicyType is CLOUD_ARMOR. + * The name must be 1-63 characters long, and comply with + * https://www.ietf.org/rfc/rfc1035.txt. Specifically, the name must be 1-63 + * characters long and match the regular expression + * `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a + * lowercase letter, and all following characters must be a dash, lowercase + * letter, or digit, except the last character, which cannot be a dash. * * Generated from protobuf field optional string short_name = 492051566; * @param string $var @@ -738,7 +993,24 @@ public function setShortName($var) } /** - * The type indicates the intended use of the security policy. - CLOUD_ARMOR: Cloud Armor backend security policies can be configured to filter incoming HTTP requests targeting backend services. They filter requests before they hit the origin servers. - CLOUD_ARMOR_EDGE: Cloud Armor edge security policies can be configured to filter incoming HTTP requests targeting backend services (including Cloud CDN-enabled) as well as backend buckets (Cloud Storage). They filter requests before the request is served from Google's cache. - CLOUD_ARMOR_INTERNAL_SERVICE (preview only): Cloud Armor internal service policies can be configured to filter HTTP requests targeting services managed by Traffic Director in a service mesh. They filter requests before the request is served from the application. - CLOUD_ARMOR_NETWORK: Cloud Armor network policies can be configured to filter packets targeting network load balancing resources such as backend services, target pools, target instances, and instances with external IPs. They filter requests before the request is served from the application. This field can be set only at resource creation time. + * The type indicates the intended use of the security policy. + * - CLOUD_ARMOR: Cloud Armor backend security policies can + * be configured to filter incoming HTTP requests targeting backend services. + * They filter requests before they hit the origin servers. + * - CLOUD_ARMOR_EDGE: Cloud Armor edge security policies can + * be configured to filter incoming HTTP requests targeting backend services + * (including Cloud CDN-enabled) as well as backend buckets (Cloud Storage). + * They filter requests before the request is served from Google's cache. + * - CLOUD_ARMOR_INTERNAL_SERVICE (preview only): Cloud Armor + * internal service policies can be configured to filter HTTP requests + * targeting services managed by Traffic Director in a service mesh. They + * filter requests before the request is served from the application. + * - CLOUD_ARMOR_NETWORK: Cloud Armor network policies + * can be configured to filter packets targeting network load balancing + * resources such as backend services, target pools, target instances, and + * instances with external IPs. They filter requests before the request is + * served from the application. + * This field can be set only at resource creation time. * Check the Type enum for the list of possible values. * * Generated from protobuf field optional string type = 3575610; @@ -760,7 +1032,24 @@ public function clearType() } /** - * The type indicates the intended use of the security policy. - CLOUD_ARMOR: Cloud Armor backend security policies can be configured to filter incoming HTTP requests targeting backend services. They filter requests before they hit the origin servers. - CLOUD_ARMOR_EDGE: Cloud Armor edge security policies can be configured to filter incoming HTTP requests targeting backend services (including Cloud CDN-enabled) as well as backend buckets (Cloud Storage). They filter requests before the request is served from Google's cache. - CLOUD_ARMOR_INTERNAL_SERVICE (preview only): Cloud Armor internal service policies can be configured to filter HTTP requests targeting services managed by Traffic Director in a service mesh. They filter requests before the request is served from the application. - CLOUD_ARMOR_NETWORK: Cloud Armor network policies can be configured to filter packets targeting network load balancing resources such as backend services, target pools, target instances, and instances with external IPs. They filter requests before the request is served from the application. This field can be set only at resource creation time. + * The type indicates the intended use of the security policy. + * - CLOUD_ARMOR: Cloud Armor backend security policies can + * be configured to filter incoming HTTP requests targeting backend services. + * They filter requests before they hit the origin servers. + * - CLOUD_ARMOR_EDGE: Cloud Armor edge security policies can + * be configured to filter incoming HTTP requests targeting backend services + * (including Cloud CDN-enabled) as well as backend buckets (Cloud Storage). + * They filter requests before the request is served from Google's cache. + * - CLOUD_ARMOR_INTERNAL_SERVICE (preview only): Cloud Armor + * internal service policies can be configured to filter HTTP requests + * targeting services managed by Traffic Director in a service mesh. They + * filter requests before the request is served from the application. + * - CLOUD_ARMOR_NETWORK: Cloud Armor network policies + * can be configured to filter packets targeting network load balancing + * resources such as backend services, target pools, target instances, and + * instances with external IPs. They filter requests before the request is + * served from the application. + * This field can be set only at resource creation time. * Check the Type enum for the list of possible values. * * Generated from protobuf field optional string type = 3575610; @@ -776,7 +1065,18 @@ public function setType($var) } /** - * Definitions of user-defined fields for CLOUD_ARMOR_NETWORK policies. A user-defined field consists of up to 4 bytes extracted from a fixed offset in the packet, relative to the IPv4, IPv6, TCP, or UDP header, with an optional mask to select certain bits. Rules may then specify matching values for these fields. Example: userDefinedFields: - name: "ipv4_fragment_offset" base: IPV4 offset: 6 size: 2 mask: "0x1fff" + * Definitions of user-defined fields for CLOUD_ARMOR_NETWORK policies. A + * user-defined field consists of up to 4 bytes extracted from a fixed offset + * in the packet, relative to the IPv4, IPv6, TCP, or UDP header, with an + * optional mask to select certain bits. Rules may then specify matching + * values for these fields. + * Example: + * userDefinedFields: + * - name: "ipv4_fragment_offset" + * base: IPV4 + * offset: 6 + * size: 2 + * mask: "0x1fff" * * Generated from protobuf field repeated .google.cloud.compute.v1.SecurityPolicyUserDefinedField user_defined_fields = 28312739; * @return \Google\Protobuf\Internal\RepeatedField @@ -787,7 +1087,18 @@ public function getUserDefinedFields() } /** - * Definitions of user-defined fields for CLOUD_ARMOR_NETWORK policies. A user-defined field consists of up to 4 bytes extracted from a fixed offset in the packet, relative to the IPv4, IPv6, TCP, or UDP header, with an optional mask to select certain bits. Rules may then specify matching values for these fields. Example: userDefinedFields: - name: "ipv4_fragment_offset" base: IPV4 offset: 6 size: 2 mask: "0x1fff" + * Definitions of user-defined fields for CLOUD_ARMOR_NETWORK policies. A + * user-defined field consists of up to 4 bytes extracted from a fixed offset + * in the packet, relative to the IPv4, IPv6, TCP, or UDP header, with an + * optional mask to select certain bits. Rules may then specify matching + * values for these fields. + * Example: + * userDefinedFields: + * - name: "ipv4_fragment_offset" + * base: IPV4 + * offset: 6 + * size: 2 + * mask: "0x1fff" * * Generated from protobuf field repeated .google.cloud.compute.v1.SecurityPolicyUserDefinedField user_defined_fields = 28312739; * @param array<\Google\Cloud\Compute\V1\SecurityPolicyUserDefinedField>|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/SecurityPolicy/Type.php b/Compute/src/V1/SecurityPolicy/Type.php index 026d0b37bcee..5b0e845c8797 100644 --- a/Compute/src/V1/SecurityPolicy/Type.php +++ b/Compute/src/V1/SecurityPolicy/Type.php @@ -7,7 +7,24 @@ use UnexpectedValueException; /** - * The type indicates the intended use of the security policy. - CLOUD_ARMOR: Cloud Armor backend security policies can be configured to filter incoming HTTP requests targeting backend services. They filter requests before they hit the origin servers. - CLOUD_ARMOR_EDGE: Cloud Armor edge security policies can be configured to filter incoming HTTP requests targeting backend services (including Cloud CDN-enabled) as well as backend buckets (Cloud Storage). They filter requests before the request is served from Google's cache. - CLOUD_ARMOR_INTERNAL_SERVICE (preview only): Cloud Armor internal service policies can be configured to filter HTTP requests targeting services managed by Traffic Director in a service mesh. They filter requests before the request is served from the application. - CLOUD_ARMOR_NETWORK: Cloud Armor network policies can be configured to filter packets targeting network load balancing resources such as backend services, target pools, target instances, and instances with external IPs. They filter requests before the request is served from the application. This field can be set only at resource creation time. + * The type indicates the intended use of the security policy. + * - CLOUD_ARMOR: Cloud Armor backend security policies can + * be configured to filter incoming HTTP requests targeting backend services. + * They filter requests before they hit the origin servers. + * - CLOUD_ARMOR_EDGE: Cloud Armor edge security policies can + * be configured to filter incoming HTTP requests targeting backend services + * (including Cloud CDN-enabled) as well as backend buckets (Cloud Storage). + * They filter requests before the request is served from Google's cache. + * - CLOUD_ARMOR_INTERNAL_SERVICE (preview only): Cloud Armor + * internal service policies can be configured to filter HTTP requests + * targeting services managed by Traffic Director in a service mesh. They + * filter requests before the request is served from the application. + * - CLOUD_ARMOR_NETWORK: Cloud Armor network policies + * can be configured to filter packets targeting network load balancing + * resources such as backend services, target pools, target instances, and + * instances with external IPs. They filter requests before the request is + * served from the application. + * This field can be set only at resource creation time. * * Protobuf type google.cloud.compute.v1.SecurityPolicy.Type */ diff --git a/Compute/src/V1/SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfig.php b/Compute/src/V1/SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfig.php index 7d9d486bbea9..adbfbe827cc8 100644 --- a/Compute/src/V1/SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfig.php +++ b/Compute/src/V1/SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfig.php @@ -9,27 +9,36 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Configuration options for L7 DDoS detection. This field is only supported in Global Security Policies of type CLOUD_ARMOR. + * Configuration options for L7 DDoS detection. + * This field is only supported in Global Security Policies of type + * CLOUD_ARMOR. * * Generated from protobuf message google.cloud.compute.v1.SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfig */ class SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfig extends \Google\Protobuf\Internal\Message { /** - * If set to true, enables CAAP for L7 DDoS detection. This field is only supported in Global Security Policies of type CLOUD_ARMOR. + * If set to true, enables CAAP for L7 DDoS detection. + * This field is only supported in Global Security Policies of type + * CLOUD_ARMOR. * * Generated from protobuf field optional bool enable = 311764355; */ protected $enable = null; /** - * Rule visibility can be one of the following: STANDARD - opaque rules. (default) PREMIUM - transparent rules. This field is only supported in Global Security Policies of type CLOUD_ARMOR. + * Rule visibility can be one of the following: + * STANDARD - opaque rules. (default) + * PREMIUM - transparent rules. + * This field is only supported in Global Security Policies of type + * CLOUD_ARMOR. * Check the RuleVisibility enum for the list of possible values. * * Generated from protobuf field optional string rule_visibility = 453258293; */ protected $rule_visibility = null; /** - * Configuration options for layer7 adaptive protection for various customizable thresholds. + * Configuration options for layer7 adaptive protection for various + * customizable thresholds. * * Generated from protobuf field repeated .google.cloud.compute.v1.SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfigThresholdConfig threshold_configs = 60347805; */ @@ -42,12 +51,19 @@ class SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfig extends \Goo * Optional. Data for populating the Message object. * * @type bool $enable - * If set to true, enables CAAP for L7 DDoS detection. This field is only supported in Global Security Policies of type CLOUD_ARMOR. + * If set to true, enables CAAP for L7 DDoS detection. + * This field is only supported in Global Security Policies of type + * CLOUD_ARMOR. * @type string $rule_visibility - * Rule visibility can be one of the following: STANDARD - opaque rules. (default) PREMIUM - transparent rules. This field is only supported in Global Security Policies of type CLOUD_ARMOR. + * Rule visibility can be one of the following: + * STANDARD - opaque rules. (default) + * PREMIUM - transparent rules. + * This field is only supported in Global Security Policies of type + * CLOUD_ARMOR. * Check the RuleVisibility enum for the list of possible values. * @type array<\Google\Cloud\Compute\V1\SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfigThresholdConfig>|\Google\Protobuf\Internal\RepeatedField $threshold_configs - * Configuration options for layer7 adaptive protection for various customizable thresholds. + * Configuration options for layer7 adaptive protection for various + * customizable thresholds. * } */ public function __construct($data = NULL) { @@ -56,7 +72,9 @@ public function __construct($data = NULL) { } /** - * If set to true, enables CAAP for L7 DDoS detection. This field is only supported in Global Security Policies of type CLOUD_ARMOR. + * If set to true, enables CAAP for L7 DDoS detection. + * This field is only supported in Global Security Policies of type + * CLOUD_ARMOR. * * Generated from protobuf field optional bool enable = 311764355; * @return bool @@ -77,7 +95,9 @@ public function clearEnable() } /** - * If set to true, enables CAAP for L7 DDoS detection. This field is only supported in Global Security Policies of type CLOUD_ARMOR. + * If set to true, enables CAAP for L7 DDoS detection. + * This field is only supported in Global Security Policies of type + * CLOUD_ARMOR. * * Generated from protobuf field optional bool enable = 311764355; * @param bool $var @@ -92,7 +112,11 @@ public function setEnable($var) } /** - * Rule visibility can be one of the following: STANDARD - opaque rules. (default) PREMIUM - transparent rules. This field is only supported in Global Security Policies of type CLOUD_ARMOR. + * Rule visibility can be one of the following: + * STANDARD - opaque rules. (default) + * PREMIUM - transparent rules. + * This field is only supported in Global Security Policies of type + * CLOUD_ARMOR. * Check the RuleVisibility enum for the list of possible values. * * Generated from protobuf field optional string rule_visibility = 453258293; @@ -114,7 +138,11 @@ public function clearRuleVisibility() } /** - * Rule visibility can be one of the following: STANDARD - opaque rules. (default) PREMIUM - transparent rules. This field is only supported in Global Security Policies of type CLOUD_ARMOR. + * Rule visibility can be one of the following: + * STANDARD - opaque rules. (default) + * PREMIUM - transparent rules. + * This field is only supported in Global Security Policies of type + * CLOUD_ARMOR. * Check the RuleVisibility enum for the list of possible values. * * Generated from protobuf field optional string rule_visibility = 453258293; @@ -130,7 +158,8 @@ public function setRuleVisibility($var) } /** - * Configuration options for layer7 adaptive protection for various customizable thresholds. + * Configuration options for layer7 adaptive protection for various + * customizable thresholds. * * Generated from protobuf field repeated .google.cloud.compute.v1.SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfigThresholdConfig threshold_configs = 60347805; * @return \Google\Protobuf\Internal\RepeatedField @@ -141,7 +170,8 @@ public function getThresholdConfigs() } /** - * Configuration options for layer7 adaptive protection for various customizable thresholds. + * Configuration options for layer7 adaptive protection for various + * customizable thresholds. * * Generated from protobuf field repeated .google.cloud.compute.v1.SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfigThresholdConfig threshold_configs = 60347805; * @param array<\Google\Cloud\Compute\V1\SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfigThresholdConfig>|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfig/RuleVisibility.php b/Compute/src/V1/SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfig/RuleVisibility.php index f0c5ca4ee397..61f91c73c949 100644 --- a/Compute/src/V1/SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfig/RuleVisibility.php +++ b/Compute/src/V1/SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfig/RuleVisibility.php @@ -7,7 +7,11 @@ use UnexpectedValueException; /** - * Rule visibility can be one of the following: STANDARD - opaque rules. (default) PREMIUM - transparent rules. This field is only supported in Global Security Policies of type CLOUD_ARMOR. + * Rule visibility can be one of the following: + * STANDARD - opaque rules. (default) + * PREMIUM - transparent rules. + * This field is only supported in Global Security Policies of type + * CLOUD_ARMOR. * * Protobuf type google.cloud.compute.v1.SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfig.RuleVisibility */ diff --git a/Compute/src/V1/SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfigThresholdConfig.php b/Compute/src/V1/SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfigThresholdConfig.php index cce05ed043c7..fc6ecaf346b1 100644 --- a/Compute/src/V1/SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfigThresholdConfig.php +++ b/Compute/src/V1/SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfigThresholdConfig.php @@ -43,13 +43,15 @@ class SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfigThresholdConf */ protected $detection_relative_to_baseline_qps = null; /** - * The name must be 1-63 characters long, and comply with RFC1035. The name must be unique within the security policy. + * The name must be 1-63 characters long, and comply withRFC1035. + * The name must be unique within the security policy. * * Generated from protobuf field optional string name = 3373707; */ protected $name = null; /** - * Configuration options for enabling Adaptive Protection to operate on specified granular traffic units. + * Configuration options for enabling Adaptive Protection to operate + * on specified granular traffic units. * * Generated from protobuf field repeated .google.cloud.compute.v1.SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfigThresholdConfigTrafficGranularityConfig traffic_granularity_configs = 85367358; */ @@ -69,9 +71,11 @@ class SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfigThresholdConf * @type float $detection_load_threshold * @type float $detection_relative_to_baseline_qps * @type string $name - * The name must be 1-63 characters long, and comply with RFC1035. The name must be unique within the security policy. + * The name must be 1-63 characters long, and comply withRFC1035. + * The name must be unique within the security policy. * @type array<\Google\Cloud\Compute\V1\SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfigThresholdConfigTrafficGranularityConfig>|\Google\Protobuf\Internal\RepeatedField $traffic_granularity_configs - * Configuration options for enabling Adaptive Protection to operate on specified granular traffic units. + * Configuration options for enabling Adaptive Protection to operate + * on specified granular traffic units. * } */ public function __construct($data = NULL) { @@ -304,7 +308,8 @@ public function setDetectionRelativeToBaselineQps($var) } /** - * The name must be 1-63 characters long, and comply with RFC1035. The name must be unique within the security policy. + * The name must be 1-63 characters long, and comply withRFC1035. + * The name must be unique within the security policy. * * Generated from protobuf field optional string name = 3373707; * @return string @@ -325,7 +330,8 @@ public function clearName() } /** - * The name must be 1-63 characters long, and comply with RFC1035. The name must be unique within the security policy. + * The name must be 1-63 characters long, and comply withRFC1035. + * The name must be unique within the security policy. * * Generated from protobuf field optional string name = 3373707; * @param string $var @@ -340,7 +346,8 @@ public function setName($var) } /** - * Configuration options for enabling Adaptive Protection to operate on specified granular traffic units. + * Configuration options for enabling Adaptive Protection to operate + * on specified granular traffic units. * * Generated from protobuf field repeated .google.cloud.compute.v1.SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfigThresholdConfigTrafficGranularityConfig traffic_granularity_configs = 85367358; * @return \Google\Protobuf\Internal\RepeatedField @@ -351,7 +358,8 @@ public function getTrafficGranularityConfigs() } /** - * Configuration options for enabling Adaptive Protection to operate on specified granular traffic units. + * Configuration options for enabling Adaptive Protection to operate + * on specified granular traffic units. * * Generated from protobuf field repeated .google.cloud.compute.v1.SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfigThresholdConfigTrafficGranularityConfig traffic_granularity_configs = 85367358; * @param array<\Google\Cloud\Compute\V1\SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfigThresholdConfigTrafficGranularityConfig>|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfigThresholdConfigTrafficGranularityConfig.php b/Compute/src/V1/SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfigThresholdConfigTrafficGranularityConfig.php index 8947196b7054..4e863d622776 100644 --- a/Compute/src/V1/SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfigThresholdConfigTrafficGranularityConfig.php +++ b/Compute/src/V1/SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfigThresholdConfigTrafficGranularityConfig.php @@ -9,14 +9,17 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Configurations to specifc granular traffic units processed by Adaptive Protection. + * Configurations to specifc granular traffic units processed by + * Adaptive Protection. * * Generated from protobuf message google.cloud.compute.v1.SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfigThresholdConfigTrafficGranularityConfig */ class SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfigThresholdConfigTrafficGranularityConfig extends \Google\Protobuf\Internal\Message { /** - * If enabled, traffic matching each unique value for the specified type constitutes a separate traffic unit. It can only be set to true if `value` is empty. + * If enabled, traffic matching each unique value for the specified + * type constitutes a separate traffic unit. + * It can only be set to true if `value` is empty. * * Generated from protobuf field optional bool enable_each_unique_value = 469206341; */ @@ -42,7 +45,9 @@ class SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfigThresholdConf * Optional. Data for populating the Message object. * * @type bool $enable_each_unique_value - * If enabled, traffic matching each unique value for the specified type constitutes a separate traffic unit. It can only be set to true if `value` is empty. + * If enabled, traffic matching each unique value for the specified + * type constitutes a separate traffic unit. + * It can only be set to true if `value` is empty. * @type string $type * Type of this configuration. * Check the Type enum for the list of possible values. @@ -56,7 +61,9 @@ public function __construct($data = NULL) { } /** - * If enabled, traffic matching each unique value for the specified type constitutes a separate traffic unit. It can only be set to true if `value` is empty. + * If enabled, traffic matching each unique value for the specified + * type constitutes a separate traffic unit. + * It can only be set to true if `value` is empty. * * Generated from protobuf field optional bool enable_each_unique_value = 469206341; * @return bool @@ -77,7 +84,9 @@ public function clearEnableEachUniqueValue() } /** - * If enabled, traffic matching each unique value for the specified type constitutes a separate traffic unit. It can only be set to true if `value` is empty. + * If enabled, traffic matching each unique value for the specified + * type constitutes a separate traffic unit. + * It can only be set to true if `value` is empty. * * Generated from protobuf field optional bool enable_each_unique_value = 469206341; * @param bool $var diff --git a/Compute/src/V1/SecurityPolicyAdvancedOptionsConfig.php b/Compute/src/V1/SecurityPolicyAdvancedOptionsConfig.php index 1bd27459e69d..29bb8ef60f4d 100644 --- a/Compute/src/V1/SecurityPolicyAdvancedOptionsConfig.php +++ b/Compute/src/V1/SecurityPolicyAdvancedOptionsConfig.php @@ -15,7 +15,8 @@ class SecurityPolicyAdvancedOptionsConfig extends \Google\Protobuf\Internal\Message { /** - * Custom configuration to apply the JSON parsing. Only applicable when json_parsing is set to STANDARD. + * Custom configuration to apply the JSON parsing. Only applicable when + * json_parsing is set to STANDARD. * * Generated from protobuf field optional .google.cloud.compute.v1.SecurityPolicyAdvancedOptionsConfigJsonCustomConfig json_custom_config = 111570105; */ @@ -35,7 +36,8 @@ class SecurityPolicyAdvancedOptionsConfig extends \Google\Protobuf\Internal\Mess */ protected $log_level = null; /** - * An optional list of case-insensitive request header names to use for resolving the callers client IP address. + * An optional list of case-insensitive request header names to use for + * resolving the callers client IP address. * * Generated from protobuf field repeated string user_ip_request_headers = 421050290; */ @@ -48,7 +50,8 @@ class SecurityPolicyAdvancedOptionsConfig extends \Google\Protobuf\Internal\Mess * Optional. Data for populating the Message object. * * @type \Google\Cloud\Compute\V1\SecurityPolicyAdvancedOptionsConfigJsonCustomConfig $json_custom_config - * Custom configuration to apply the JSON parsing. Only applicable when json_parsing is set to STANDARD. + * Custom configuration to apply the JSON parsing. Only applicable when + * json_parsing is set to STANDARD. * @type string $json_parsing * * Check the JsonParsing enum for the list of possible values. @@ -56,7 +59,8 @@ class SecurityPolicyAdvancedOptionsConfig extends \Google\Protobuf\Internal\Mess * * Check the LogLevel enum for the list of possible values. * @type array|\Google\Protobuf\Internal\RepeatedField $user_ip_request_headers - * An optional list of case-insensitive request header names to use for resolving the callers client IP address. + * An optional list of case-insensitive request header names to use for + * resolving the callers client IP address. * } */ public function __construct($data = NULL) { @@ -65,7 +69,8 @@ public function __construct($data = NULL) { } /** - * Custom configuration to apply the JSON parsing. Only applicable when json_parsing is set to STANDARD. + * Custom configuration to apply the JSON parsing. Only applicable when + * json_parsing is set to STANDARD. * * Generated from protobuf field optional .google.cloud.compute.v1.SecurityPolicyAdvancedOptionsConfigJsonCustomConfig json_custom_config = 111570105; * @return \Google\Cloud\Compute\V1\SecurityPolicyAdvancedOptionsConfigJsonCustomConfig|null @@ -86,7 +91,8 @@ public function clearJsonCustomConfig() } /** - * Custom configuration to apply the JSON parsing. Only applicable when json_parsing is set to STANDARD. + * Custom configuration to apply the JSON parsing. Only applicable when + * json_parsing is set to STANDARD. * * Generated from protobuf field optional .google.cloud.compute.v1.SecurityPolicyAdvancedOptionsConfigJsonCustomConfig json_custom_config = 111570105; * @param \Google\Cloud\Compute\V1\SecurityPolicyAdvancedOptionsConfigJsonCustomConfig $var @@ -177,7 +183,8 @@ public function setLogLevel($var) } /** - * An optional list of case-insensitive request header names to use for resolving the callers client IP address. + * An optional list of case-insensitive request header names to use for + * resolving the callers client IP address. * * Generated from protobuf field repeated string user_ip_request_headers = 421050290; * @return \Google\Protobuf\Internal\RepeatedField @@ -188,7 +195,8 @@ public function getUserIpRequestHeaders() } /** - * An optional list of case-insensitive request header names to use for resolving the callers client IP address. + * An optional list of case-insensitive request header names to use for + * resolving the callers client IP address. * * Generated from protobuf field repeated string user_ip_request_headers = 421050290; * @param array|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/SecurityPolicyAdvancedOptionsConfigJsonCustomConfig.php b/Compute/src/V1/SecurityPolicyAdvancedOptionsConfigJsonCustomConfig.php index 45ac4bb07195..765997cfd436 100644 --- a/Compute/src/V1/SecurityPolicyAdvancedOptionsConfigJsonCustomConfig.php +++ b/Compute/src/V1/SecurityPolicyAdvancedOptionsConfigJsonCustomConfig.php @@ -15,7 +15,12 @@ class SecurityPolicyAdvancedOptionsConfigJsonCustomConfig extends \Google\Protobuf\Internal\Message { /** - * A list of custom Content-Type header values to apply the JSON parsing. As per RFC 1341, a Content-Type header value has the following format: Content-Type := type "/" subtype *[";" parameter] When configuring a custom Content-Type header value, only the type/subtype needs to be specified, and the parameters should be excluded. + * A list of custom Content-Type header values to apply the JSON parsing. + * As per RFC 1341, a Content-Type header value has the following format: + * Content-Type := type "/" subtype *[";" parameter] + * When configuring a custom Content-Type header value, only the + * type/subtype needs to be specified, and the parameters should be + * excluded. * * Generated from protobuf field repeated string content_types = 17428787; */ @@ -28,7 +33,12 @@ class SecurityPolicyAdvancedOptionsConfigJsonCustomConfig extends \Google\Protob * Optional. Data for populating the Message object. * * @type array|\Google\Protobuf\Internal\RepeatedField $content_types - * A list of custom Content-Type header values to apply the JSON parsing. As per RFC 1341, a Content-Type header value has the following format: Content-Type := type "/" subtype *[";" parameter] When configuring a custom Content-Type header value, only the type/subtype needs to be specified, and the parameters should be excluded. + * A list of custom Content-Type header values to apply the JSON parsing. + * As per RFC 1341, a Content-Type header value has the following format: + * Content-Type := type "/" subtype *[";" parameter] + * When configuring a custom Content-Type header value, only the + * type/subtype needs to be specified, and the parameters should be + * excluded. * } */ public function __construct($data = NULL) { @@ -37,7 +47,12 @@ public function __construct($data = NULL) { } /** - * A list of custom Content-Type header values to apply the JSON parsing. As per RFC 1341, a Content-Type header value has the following format: Content-Type := type "/" subtype *[";" parameter] When configuring a custom Content-Type header value, only the type/subtype needs to be specified, and the parameters should be excluded. + * A list of custom Content-Type header values to apply the JSON parsing. + * As per RFC 1341, a Content-Type header value has the following format: + * Content-Type := type "/" subtype *[";" parameter] + * When configuring a custom Content-Type header value, only the + * type/subtype needs to be specified, and the parameters should be + * excluded. * * Generated from protobuf field repeated string content_types = 17428787; * @return \Google\Protobuf\Internal\RepeatedField @@ -48,7 +63,12 @@ public function getContentTypes() } /** - * A list of custom Content-Type header values to apply the JSON parsing. As per RFC 1341, a Content-Type header value has the following format: Content-Type := type "/" subtype *[";" parameter] When configuring a custom Content-Type header value, only the type/subtype needs to be specified, and the parameters should be excluded. + * A list of custom Content-Type header values to apply the JSON parsing. + * As per RFC 1341, a Content-Type header value has the following format: + * Content-Type := type "/" subtype *[";" parameter] + * When configuring a custom Content-Type header value, only the + * type/subtype needs to be specified, and the parameters should be + * excluded. * * Generated from protobuf field repeated string content_types = 17428787; * @param array|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/SecurityPolicyList.php b/Compute/src/V1/SecurityPolicyList.php index 6c222a7fedbb..94fb57845726 100644 --- a/Compute/src/V1/SecurityPolicyList.php +++ b/Compute/src/V1/SecurityPolicyList.php @@ -27,13 +27,17 @@ class SecurityPolicyList extends \Google\Protobuf\Internal\Message */ private $items; /** - * [Output Only] Type of resource. Always compute#securityPolicyList for listsof securityPolicies + * [Output Only] Type of resource. Alwayscompute#securityPolicyList for listsof securityPolicies * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -56,9 +60,13 @@ class SecurityPolicyList extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\SecurityPolicy>|\Google\Protobuf\Internal\RepeatedField $items * A list of SecurityPolicy resources. * @type string $kind - * [Output Only] Type of resource. Always compute#securityPolicyList for listsof securityPolicies + * [Output Only] Type of resource. Alwayscompute#securityPolicyList for listsof securityPolicies * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type \Google\Cloud\Compute\V1\Warning $warning * [Output Only] Informational warning message. * } @@ -131,7 +139,7 @@ public function setItems($var) } /** - * [Output Only] Type of resource. Always compute#securityPolicyList for listsof securityPolicies + * [Output Only] Type of resource. Alwayscompute#securityPolicyList for listsof securityPolicies * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -152,7 +160,7 @@ public function clearKind() } /** - * [Output Only] Type of resource. Always compute#securityPolicyList for listsof securityPolicies + * [Output Only] Type of resource. Alwayscompute#securityPolicyList for listsof securityPolicies * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -167,7 +175,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -188,7 +200,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/SecurityPolicyRecaptchaOptionsConfig.php b/Compute/src/V1/SecurityPolicyRecaptchaOptionsConfig.php index cabdf36e0dfd..38cc2b9e475c 100644 --- a/Compute/src/V1/SecurityPolicyRecaptchaOptionsConfig.php +++ b/Compute/src/V1/SecurityPolicyRecaptchaOptionsConfig.php @@ -15,7 +15,13 @@ class SecurityPolicyRecaptchaOptionsConfig extends \Google\Protobuf\Internal\Message { /** - * An optional field to supply a reCAPTCHA site key to be used for all the rules using the redirect action with the type of GOOGLE_RECAPTCHA under the security policy. The specified site key needs to be created from the reCAPTCHA API. The user is responsible for the validity of the specified site key. If not specified, a Google-managed site key is used. This field is only supported in Global Security Policies of type CLOUD_ARMOR. + * An optional field to supply a reCAPTCHA site key to be used for all the + * rules using the redirect action with the type of GOOGLE_RECAPTCHA under + * the security policy. The specified site key needs to be created from the + * reCAPTCHA API. The user is responsible for the validity of the specified + * site key. If not specified, a Google-managed site key is used. + * This field is only supported in Global Security Policies of type + * CLOUD_ARMOR. * * Generated from protobuf field optional string redirect_site_key = 447677034; */ @@ -28,7 +34,13 @@ class SecurityPolicyRecaptchaOptionsConfig extends \Google\Protobuf\Internal\Mes * Optional. Data for populating the Message object. * * @type string $redirect_site_key - * An optional field to supply a reCAPTCHA site key to be used for all the rules using the redirect action with the type of GOOGLE_RECAPTCHA under the security policy. The specified site key needs to be created from the reCAPTCHA API. The user is responsible for the validity of the specified site key. If not specified, a Google-managed site key is used. This field is only supported in Global Security Policies of type CLOUD_ARMOR. + * An optional field to supply a reCAPTCHA site key to be used for all the + * rules using the redirect action with the type of GOOGLE_RECAPTCHA under + * the security policy. The specified site key needs to be created from the + * reCAPTCHA API. The user is responsible for the validity of the specified + * site key. If not specified, a Google-managed site key is used. + * This field is only supported in Global Security Policies of type + * CLOUD_ARMOR. * } */ public function __construct($data = NULL) { @@ -37,7 +49,13 @@ public function __construct($data = NULL) { } /** - * An optional field to supply a reCAPTCHA site key to be used for all the rules using the redirect action with the type of GOOGLE_RECAPTCHA under the security policy. The specified site key needs to be created from the reCAPTCHA API. The user is responsible for the validity of the specified site key. If not specified, a Google-managed site key is used. This field is only supported in Global Security Policies of type CLOUD_ARMOR. + * An optional field to supply a reCAPTCHA site key to be used for all the + * rules using the redirect action with the type of GOOGLE_RECAPTCHA under + * the security policy. The specified site key needs to be created from the + * reCAPTCHA API. The user is responsible for the validity of the specified + * site key. If not specified, a Google-managed site key is used. + * This field is only supported in Global Security Policies of type + * CLOUD_ARMOR. * * Generated from protobuf field optional string redirect_site_key = 447677034; * @return string @@ -58,7 +76,13 @@ public function clearRedirectSiteKey() } /** - * An optional field to supply a reCAPTCHA site key to be used for all the rules using the redirect action with the type of GOOGLE_RECAPTCHA under the security policy. The specified site key needs to be created from the reCAPTCHA API. The user is responsible for the validity of the specified site key. If not specified, a Google-managed site key is used. This field is only supported in Global Security Policies of type CLOUD_ARMOR. + * An optional field to supply a reCAPTCHA site key to be used for all the + * rules using the redirect action with the type of GOOGLE_RECAPTCHA under + * the security policy. The specified site key needs to be created from the + * reCAPTCHA API. The user is responsible for the validity of the specified + * site key. If not specified, a Google-managed site key is used. + * This field is only supported in Global Security Policies of type + * CLOUD_ARMOR. * * Generated from protobuf field optional string redirect_site_key = 447677034; * @param string $var diff --git a/Compute/src/V1/SecurityPolicyRule.php b/Compute/src/V1/SecurityPolicyRule.php index c63605d7a027..25f8f0263ed1 100644 --- a/Compute/src/V1/SecurityPolicyRule.php +++ b/Compute/src/V1/SecurityPolicyRule.php @@ -9,50 +9,108 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Represents a rule that describes one or more match conditions along with the action to be taken when traffic matches this condition (allow or deny). + * Represents a rule that describes one or more match conditions along with + * the action to be taken when traffic matches this condition (allow or deny). * * Generated from protobuf message google.cloud.compute.v1.SecurityPolicyRule */ class SecurityPolicyRule extends \Google\Protobuf\Internal\Message { /** - * The Action to perform when the rule is matched. The following are the valid actions: - allow: allow access to target. - deny(STATUS): deny access to target, returns the HTTP response code specified. Valid values for `STATUS` are 403, 404, and 502. - rate_based_ban: limit client traffic to the configured threshold and ban the client if the traffic exceeds the threshold. Configure parameters for this action in RateLimitOptions. Requires rate_limit_options to be set. - redirect: redirect to a different target. This can either be an internal reCAPTCHA redirect, or an external URL-based redirect via a 302 response. Parameters for this action can be configured via redirectOptions. This action is only supported in Global Security Policies of type CLOUD_ARMOR. - throttle: limit client traffic to the configured threshold. Configure parameters for this action in rateLimitOptions. Requires rate_limit_options to be set for this. - fairshare (preview only): when traffic reaches the threshold limit, requests from the clients matching this rule begin to be rate-limited using the Fair Share algorithm. This action is only allowed in security policies of type `CLOUD_ARMOR_INTERNAL_SERVICE`. + * The Action to perform when the rule is matched. + * The following are the valid actions: + * - allow: allow access to target. + * - deny(STATUS): deny access to target, returns the + * HTTP response code specified. Valid values for `STATUS` + * are 403, 404, and 502. + * - rate_based_ban: limit client traffic to the configured + * threshold and ban the client if the traffic exceeds the threshold. + * Configure parameters for this action in RateLimitOptions. Requires + * rate_limit_options to be set. + * - redirect: redirect to a different target. This can + * either be an internal reCAPTCHA redirect, or an external URL-based + * redirect via a 302 response. Parameters for this action can be configured + * via redirectOptions. This action is only supported in Global Security + * Policies of type CLOUD_ARMOR. + * - throttle: limit + * client traffic to the configured threshold. Configure parameters for this + * action in rateLimitOptions. Requires rate_limit_options to be set for + * this. + * - fairshare (preview only): when traffic reaches the + * threshold limit, requests from the clients matching this rule begin to be + * rate-limited using the Fair Share algorithm. This action is only allowed + * in security policies of type `CLOUD_ARMOR_INTERNAL_SERVICE`. * * Generated from protobuf field optional string action = 187661878; */ protected $action = null; /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; */ protected $description = null; /** - * Optional, additional actions that are performed on headers. This field is only supported in Global Security Policies of type CLOUD_ARMOR. + * Optional, additional actions that are performed on headers. + * This field is only supported in Global Security Policies of type + * CLOUD_ARMOR. * * Generated from protobuf field optional .google.cloud.compute.v1.SecurityPolicyRuleHttpHeaderAction header_action = 328077352; */ protected $header_action = null; /** - * [Output only] Type of the resource. Always compute#securityPolicyRule for security policy rules + * [Output only] Type of the resource. Alwayscompute#securityPolicyRule for security policy rules * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * A match condition that incoming traffic is evaluated against. If it evaluates to true, the corresponding 'action' is enforced. + * A match condition that incoming traffic is evaluated against. + * If it evaluates to true, the corresponding 'action' is enforced. * * Generated from protobuf field optional .google.cloud.compute.v1.SecurityPolicyRuleMatcher match = 103668165; */ protected $match = null; /** - * A match condition that incoming packets are evaluated against for CLOUD_ARMOR_NETWORK security policies. If it matches, the corresponding 'action' is enforced. The match criteria for a rule consists of built-in match fields (like 'srcIpRanges') and potentially multiple user-defined match fields ('userDefinedFields'). Field values may be extracted directly from the packet or derived from it (e.g. 'srcRegionCodes'). Some fields may not be present in every packet (e.g. 'srcPorts'). A user-defined field is only present if the base header is found in the packet and the entire field is in bounds. Each match field may specify which values can match it, listing one or more ranges, prefixes, or exact values that are considered a match for the field. A field value must be present in order to match a specified match field. If no match values are specified for a match field, then any field value is considered to match it, and it's not required to be present. For strings specifying '*' is also equivalent to match all. For a packet to match a rule, all specified match fields must match the corresponding field values derived from the packet. Example: networkMatch: srcIpRanges: - "192.0.2.0/24" - "198.51.100.0/24" userDefinedFields: - name: "ipv4_fragment_offset" values: - "1-0x1fff" The above match condition matches packets with a source IP in 192.0.2.0/24 or 198.51.100.0/24 and a user-defined field named "ipv4_fragment_offset" with a value between 1 and 0x1fff inclusive. + * A match condition that incoming packets are evaluated against for + * CLOUD_ARMOR_NETWORK security policies. If it matches, the corresponding + * 'action' is enforced. + * The match criteria for a rule consists of built-in match fields (like + * 'srcIpRanges') and potentially multiple user-defined match fields + * ('userDefinedFields'). + * Field values may be extracted directly from the packet or derived from it + * (e.g. 'srcRegionCodes'). Some fields may not be present in every packet + * (e.g. 'srcPorts'). A user-defined field is only present if the base + * header is found in the packet and the entire field is in bounds. + * Each match field may specify which values can match it, listing one or + * more ranges, prefixes, or exact values that are considered a match for + * the field. A field value must be present in order to match a specified + * match field. If no match values are specified for a match field, then any + * field value is considered to match it, and it's not required to be + * present. For strings specifying '*' is also equivalent to match all. + * For a packet to match a rule, all specified match fields must match the + * corresponding field values derived from the packet. + * Example: + * networkMatch: + * srcIpRanges: + * - "192.0.2.0/24" + * - "198.51.100.0/24" + * userDefinedFields: + * - name: "ipv4_fragment_offset" + * values: + * - "1-0x1fff" + * The above match condition matches packets with a source IP in + * 192.0.2.0/24 or 198.51.100.0/24 and a user-defined field named + * "ipv4_fragment_offset" with a value between 1 and 0x1fff inclusive. * * Generated from protobuf field optional .google.cloud.compute.v1.SecurityPolicyRuleNetworkMatcher network_match = 463387764; */ protected $network_match = null; /** - * Preconfigured WAF configuration to be applied for the rule. If the rule does not evaluate preconfigured WAF rules, i.e., if evaluatePreconfiguredWaf() is not used, this field will have no effect. + * Preconfigured WAF configuration to be applied for the rule. If the rule + * does not evaluate preconfigured WAF rules, i.e., if + * evaluatePreconfiguredWaf() is not used, this field will have no effect. * * Generated from protobuf field optional .google.cloud.compute.v1.SecurityPolicyRulePreconfiguredWafConfig preconfigured_waf_config = 117805027; */ @@ -64,19 +122,26 @@ class SecurityPolicyRule extends \Google\Protobuf\Internal\Message */ protected $preview = null; /** - * An integer indicating the priority of a rule in the list. The priority must be a positive value between 0 and 2147483647. Rules are evaluated from highest to lowest priority where 0 is the highest priority and 2147483647 is the lowest priority. + * An integer indicating the priority of a rule in the list. The priority + * must be a positive value between 0 and 2147483647. + * Rules are evaluated from highest to lowest priority where 0 is the + * highest priority and 2147483647 is the lowest priority. * * Generated from protobuf field optional int32 priority = 445151652; */ protected $priority = null; /** - * Must be specified if the action is "rate_based_ban" or "throttle" or "fairshare". Cannot be specified for any other actions. + * Must be specified if the action is "rate_based_ban" or "throttle" or + * "fairshare". Cannot be specified for any other actions. * * Generated from protobuf field optional .google.cloud.compute.v1.SecurityPolicyRuleRateLimitOptions rate_limit_options = 67544315; */ protected $rate_limit_options = null; /** - * Parameters defining the redirect action. Cannot be specified for any other actions. This field is only supported in Global Security Policies of type CLOUD_ARMOR. + * Parameters defining the redirect action. Cannot be specified for any + * other actions. + * This field is only supported in Global Security Policies of type + * CLOUD_ARMOR. * * Generated from protobuf field optional .google.cloud.compute.v1.SecurityPolicyRuleRedirectOptions redirect_options = 163285307; */ @@ -89,27 +154,91 @@ class SecurityPolicyRule extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $action - * The Action to perform when the rule is matched. The following are the valid actions: - allow: allow access to target. - deny(STATUS): deny access to target, returns the HTTP response code specified. Valid values for `STATUS` are 403, 404, and 502. - rate_based_ban: limit client traffic to the configured threshold and ban the client if the traffic exceeds the threshold. Configure parameters for this action in RateLimitOptions. Requires rate_limit_options to be set. - redirect: redirect to a different target. This can either be an internal reCAPTCHA redirect, or an external URL-based redirect via a 302 response. Parameters for this action can be configured via redirectOptions. This action is only supported in Global Security Policies of type CLOUD_ARMOR. - throttle: limit client traffic to the configured threshold. Configure parameters for this action in rateLimitOptions. Requires rate_limit_options to be set for this. - fairshare (preview only): when traffic reaches the threshold limit, requests from the clients matching this rule begin to be rate-limited using the Fair Share algorithm. This action is only allowed in security policies of type `CLOUD_ARMOR_INTERNAL_SERVICE`. + * The Action to perform when the rule is matched. + * The following are the valid actions: + * - allow: allow access to target. + * - deny(STATUS): deny access to target, returns the + * HTTP response code specified. Valid values for `STATUS` + * are 403, 404, and 502. + * - rate_based_ban: limit client traffic to the configured + * threshold and ban the client if the traffic exceeds the threshold. + * Configure parameters for this action in RateLimitOptions. Requires + * rate_limit_options to be set. + * - redirect: redirect to a different target. This can + * either be an internal reCAPTCHA redirect, or an external URL-based + * redirect via a 302 response. Parameters for this action can be configured + * via redirectOptions. This action is only supported in Global Security + * Policies of type CLOUD_ARMOR. + * - throttle: limit + * client traffic to the configured threshold. Configure parameters for this + * action in rateLimitOptions. Requires rate_limit_options to be set for + * this. + * - fairshare (preview only): when traffic reaches the + * threshold limit, requests from the clients matching this rule begin to be + * rate-limited using the Fair Share algorithm. This action is only allowed + * in security policies of type `CLOUD_ARMOR_INTERNAL_SERVICE`. * @type string $description - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * @type \Google\Cloud\Compute\V1\SecurityPolicyRuleHttpHeaderAction $header_action - * Optional, additional actions that are performed on headers. This field is only supported in Global Security Policies of type CLOUD_ARMOR. + * Optional, additional actions that are performed on headers. + * This field is only supported in Global Security Policies of type + * CLOUD_ARMOR. * @type string $kind - * [Output only] Type of the resource. Always compute#securityPolicyRule for security policy rules + * [Output only] Type of the resource. Alwayscompute#securityPolicyRule for security policy rules * @type \Google\Cloud\Compute\V1\SecurityPolicyRuleMatcher $match - * A match condition that incoming traffic is evaluated against. If it evaluates to true, the corresponding 'action' is enforced. + * A match condition that incoming traffic is evaluated against. + * If it evaluates to true, the corresponding 'action' is enforced. * @type \Google\Cloud\Compute\V1\SecurityPolicyRuleNetworkMatcher $network_match - * A match condition that incoming packets are evaluated against for CLOUD_ARMOR_NETWORK security policies. If it matches, the corresponding 'action' is enforced. The match criteria for a rule consists of built-in match fields (like 'srcIpRanges') and potentially multiple user-defined match fields ('userDefinedFields'). Field values may be extracted directly from the packet or derived from it (e.g. 'srcRegionCodes'). Some fields may not be present in every packet (e.g. 'srcPorts'). A user-defined field is only present if the base header is found in the packet and the entire field is in bounds. Each match field may specify which values can match it, listing one or more ranges, prefixes, or exact values that are considered a match for the field. A field value must be present in order to match a specified match field. If no match values are specified for a match field, then any field value is considered to match it, and it's not required to be present. For strings specifying '*' is also equivalent to match all. For a packet to match a rule, all specified match fields must match the corresponding field values derived from the packet. Example: networkMatch: srcIpRanges: - "192.0.2.0/24" - "198.51.100.0/24" userDefinedFields: - name: "ipv4_fragment_offset" values: - "1-0x1fff" The above match condition matches packets with a source IP in 192.0.2.0/24 or 198.51.100.0/24 and a user-defined field named "ipv4_fragment_offset" with a value between 1 and 0x1fff inclusive. + * A match condition that incoming packets are evaluated against for + * CLOUD_ARMOR_NETWORK security policies. If it matches, the corresponding + * 'action' is enforced. + * The match criteria for a rule consists of built-in match fields (like + * 'srcIpRanges') and potentially multiple user-defined match fields + * ('userDefinedFields'). + * Field values may be extracted directly from the packet or derived from it + * (e.g. 'srcRegionCodes'). Some fields may not be present in every packet + * (e.g. 'srcPorts'). A user-defined field is only present if the base + * header is found in the packet and the entire field is in bounds. + * Each match field may specify which values can match it, listing one or + * more ranges, prefixes, or exact values that are considered a match for + * the field. A field value must be present in order to match a specified + * match field. If no match values are specified for a match field, then any + * field value is considered to match it, and it's not required to be + * present. For strings specifying '*' is also equivalent to match all. + * For a packet to match a rule, all specified match fields must match the + * corresponding field values derived from the packet. + * Example: + * networkMatch: + * srcIpRanges: + * - "192.0.2.0/24" + * - "198.51.100.0/24" + * userDefinedFields: + * - name: "ipv4_fragment_offset" + * values: + * - "1-0x1fff" + * The above match condition matches packets with a source IP in + * 192.0.2.0/24 or 198.51.100.0/24 and a user-defined field named + * "ipv4_fragment_offset" with a value between 1 and 0x1fff inclusive. * @type \Google\Cloud\Compute\V1\SecurityPolicyRulePreconfiguredWafConfig $preconfigured_waf_config - * Preconfigured WAF configuration to be applied for the rule. If the rule does not evaluate preconfigured WAF rules, i.e., if evaluatePreconfiguredWaf() is not used, this field will have no effect. + * Preconfigured WAF configuration to be applied for the rule. If the rule + * does not evaluate preconfigured WAF rules, i.e., if + * evaluatePreconfiguredWaf() is not used, this field will have no effect. * @type bool $preview * If set to true, the specified action is not enforced. * @type int $priority - * An integer indicating the priority of a rule in the list. The priority must be a positive value between 0 and 2147483647. Rules are evaluated from highest to lowest priority where 0 is the highest priority and 2147483647 is the lowest priority. + * An integer indicating the priority of a rule in the list. The priority + * must be a positive value between 0 and 2147483647. + * Rules are evaluated from highest to lowest priority where 0 is the + * highest priority and 2147483647 is the lowest priority. * @type \Google\Cloud\Compute\V1\SecurityPolicyRuleRateLimitOptions $rate_limit_options - * Must be specified if the action is "rate_based_ban" or "throttle" or "fairshare". Cannot be specified for any other actions. + * Must be specified if the action is "rate_based_ban" or "throttle" or + * "fairshare". Cannot be specified for any other actions. * @type \Google\Cloud\Compute\V1\SecurityPolicyRuleRedirectOptions $redirect_options - * Parameters defining the redirect action. Cannot be specified for any other actions. This field is only supported in Global Security Policies of type CLOUD_ARMOR. + * Parameters defining the redirect action. Cannot be specified for any + * other actions. + * This field is only supported in Global Security Policies of type + * CLOUD_ARMOR. * } */ public function __construct($data = NULL) { @@ -118,7 +247,29 @@ public function __construct($data = NULL) { } /** - * The Action to perform when the rule is matched. The following are the valid actions: - allow: allow access to target. - deny(STATUS): deny access to target, returns the HTTP response code specified. Valid values for `STATUS` are 403, 404, and 502. - rate_based_ban: limit client traffic to the configured threshold and ban the client if the traffic exceeds the threshold. Configure parameters for this action in RateLimitOptions. Requires rate_limit_options to be set. - redirect: redirect to a different target. This can either be an internal reCAPTCHA redirect, or an external URL-based redirect via a 302 response. Parameters for this action can be configured via redirectOptions. This action is only supported in Global Security Policies of type CLOUD_ARMOR. - throttle: limit client traffic to the configured threshold. Configure parameters for this action in rateLimitOptions. Requires rate_limit_options to be set for this. - fairshare (preview only): when traffic reaches the threshold limit, requests from the clients matching this rule begin to be rate-limited using the Fair Share algorithm. This action is only allowed in security policies of type `CLOUD_ARMOR_INTERNAL_SERVICE`. + * The Action to perform when the rule is matched. + * The following are the valid actions: + * - allow: allow access to target. + * - deny(STATUS): deny access to target, returns the + * HTTP response code specified. Valid values for `STATUS` + * are 403, 404, and 502. + * - rate_based_ban: limit client traffic to the configured + * threshold and ban the client if the traffic exceeds the threshold. + * Configure parameters for this action in RateLimitOptions. Requires + * rate_limit_options to be set. + * - redirect: redirect to a different target. This can + * either be an internal reCAPTCHA redirect, or an external URL-based + * redirect via a 302 response. Parameters for this action can be configured + * via redirectOptions. This action is only supported in Global Security + * Policies of type CLOUD_ARMOR. + * - throttle: limit + * client traffic to the configured threshold. Configure parameters for this + * action in rateLimitOptions. Requires rate_limit_options to be set for + * this. + * - fairshare (preview only): when traffic reaches the + * threshold limit, requests from the clients matching this rule begin to be + * rate-limited using the Fair Share algorithm. This action is only allowed + * in security policies of type `CLOUD_ARMOR_INTERNAL_SERVICE`. * * Generated from protobuf field optional string action = 187661878; * @return string @@ -139,7 +290,29 @@ public function clearAction() } /** - * The Action to perform when the rule is matched. The following are the valid actions: - allow: allow access to target. - deny(STATUS): deny access to target, returns the HTTP response code specified. Valid values for `STATUS` are 403, 404, and 502. - rate_based_ban: limit client traffic to the configured threshold and ban the client if the traffic exceeds the threshold. Configure parameters for this action in RateLimitOptions. Requires rate_limit_options to be set. - redirect: redirect to a different target. This can either be an internal reCAPTCHA redirect, or an external URL-based redirect via a 302 response. Parameters for this action can be configured via redirectOptions. This action is only supported in Global Security Policies of type CLOUD_ARMOR. - throttle: limit client traffic to the configured threshold. Configure parameters for this action in rateLimitOptions. Requires rate_limit_options to be set for this. - fairshare (preview only): when traffic reaches the threshold limit, requests from the clients matching this rule begin to be rate-limited using the Fair Share algorithm. This action is only allowed in security policies of type `CLOUD_ARMOR_INTERNAL_SERVICE`. + * The Action to perform when the rule is matched. + * The following are the valid actions: + * - allow: allow access to target. + * - deny(STATUS): deny access to target, returns the + * HTTP response code specified. Valid values for `STATUS` + * are 403, 404, and 502. + * - rate_based_ban: limit client traffic to the configured + * threshold and ban the client if the traffic exceeds the threshold. + * Configure parameters for this action in RateLimitOptions. Requires + * rate_limit_options to be set. + * - redirect: redirect to a different target. This can + * either be an internal reCAPTCHA redirect, or an external URL-based + * redirect via a 302 response. Parameters for this action can be configured + * via redirectOptions. This action is only supported in Global Security + * Policies of type CLOUD_ARMOR. + * - throttle: limit + * client traffic to the configured threshold. Configure parameters for this + * action in rateLimitOptions. Requires rate_limit_options to be set for + * this. + * - fairshare (preview only): when traffic reaches the + * threshold limit, requests from the clients matching this rule begin to be + * rate-limited using the Fair Share algorithm. This action is only allowed + * in security policies of type `CLOUD_ARMOR_INTERNAL_SERVICE`. * * Generated from protobuf field optional string action = 187661878; * @param string $var @@ -154,7 +327,8 @@ public function setAction($var) } /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @return string @@ -175,7 +349,8 @@ public function clearDescription() } /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @param string $var @@ -190,7 +365,9 @@ public function setDescription($var) } /** - * Optional, additional actions that are performed on headers. This field is only supported in Global Security Policies of type CLOUD_ARMOR. + * Optional, additional actions that are performed on headers. + * This field is only supported in Global Security Policies of type + * CLOUD_ARMOR. * * Generated from protobuf field optional .google.cloud.compute.v1.SecurityPolicyRuleHttpHeaderAction header_action = 328077352; * @return \Google\Cloud\Compute\V1\SecurityPolicyRuleHttpHeaderAction|null @@ -211,7 +388,9 @@ public function clearHeaderAction() } /** - * Optional, additional actions that are performed on headers. This field is only supported in Global Security Policies of type CLOUD_ARMOR. + * Optional, additional actions that are performed on headers. + * This field is only supported in Global Security Policies of type + * CLOUD_ARMOR. * * Generated from protobuf field optional .google.cloud.compute.v1.SecurityPolicyRuleHttpHeaderAction header_action = 328077352; * @param \Google\Cloud\Compute\V1\SecurityPolicyRuleHttpHeaderAction $var @@ -226,7 +405,7 @@ public function setHeaderAction($var) } /** - * [Output only] Type of the resource. Always compute#securityPolicyRule for security policy rules + * [Output only] Type of the resource. Alwayscompute#securityPolicyRule for security policy rules * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -247,7 +426,7 @@ public function clearKind() } /** - * [Output only] Type of the resource. Always compute#securityPolicyRule for security policy rules + * [Output only] Type of the resource. Alwayscompute#securityPolicyRule for security policy rules * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -262,7 +441,8 @@ public function setKind($var) } /** - * A match condition that incoming traffic is evaluated against. If it evaluates to true, the corresponding 'action' is enforced. + * A match condition that incoming traffic is evaluated against. + * If it evaluates to true, the corresponding 'action' is enforced. * * Generated from protobuf field optional .google.cloud.compute.v1.SecurityPolicyRuleMatcher match = 103668165; * @return \Google\Cloud\Compute\V1\SecurityPolicyRuleMatcher|null @@ -283,7 +463,8 @@ public function clearMatch() } /** - * A match condition that incoming traffic is evaluated against. If it evaluates to true, the corresponding 'action' is enforced. + * A match condition that incoming traffic is evaluated against. + * If it evaluates to true, the corresponding 'action' is enforced. * * Generated from protobuf field optional .google.cloud.compute.v1.SecurityPolicyRuleMatcher match = 103668165; * @param \Google\Cloud\Compute\V1\SecurityPolicyRuleMatcher $var @@ -298,7 +479,36 @@ public function setMatch($var) } /** - * A match condition that incoming packets are evaluated against for CLOUD_ARMOR_NETWORK security policies. If it matches, the corresponding 'action' is enforced. The match criteria for a rule consists of built-in match fields (like 'srcIpRanges') and potentially multiple user-defined match fields ('userDefinedFields'). Field values may be extracted directly from the packet or derived from it (e.g. 'srcRegionCodes'). Some fields may not be present in every packet (e.g. 'srcPorts'). A user-defined field is only present if the base header is found in the packet and the entire field is in bounds. Each match field may specify which values can match it, listing one or more ranges, prefixes, or exact values that are considered a match for the field. A field value must be present in order to match a specified match field. If no match values are specified for a match field, then any field value is considered to match it, and it's not required to be present. For strings specifying '*' is also equivalent to match all. For a packet to match a rule, all specified match fields must match the corresponding field values derived from the packet. Example: networkMatch: srcIpRanges: - "192.0.2.0/24" - "198.51.100.0/24" userDefinedFields: - name: "ipv4_fragment_offset" values: - "1-0x1fff" The above match condition matches packets with a source IP in 192.0.2.0/24 or 198.51.100.0/24 and a user-defined field named "ipv4_fragment_offset" with a value between 1 and 0x1fff inclusive. + * A match condition that incoming packets are evaluated against for + * CLOUD_ARMOR_NETWORK security policies. If it matches, the corresponding + * 'action' is enforced. + * The match criteria for a rule consists of built-in match fields (like + * 'srcIpRanges') and potentially multiple user-defined match fields + * ('userDefinedFields'). + * Field values may be extracted directly from the packet or derived from it + * (e.g. 'srcRegionCodes'). Some fields may not be present in every packet + * (e.g. 'srcPorts'). A user-defined field is only present if the base + * header is found in the packet and the entire field is in bounds. + * Each match field may specify which values can match it, listing one or + * more ranges, prefixes, or exact values that are considered a match for + * the field. A field value must be present in order to match a specified + * match field. If no match values are specified for a match field, then any + * field value is considered to match it, and it's not required to be + * present. For strings specifying '*' is also equivalent to match all. + * For a packet to match a rule, all specified match fields must match the + * corresponding field values derived from the packet. + * Example: + * networkMatch: + * srcIpRanges: + * - "192.0.2.0/24" + * - "198.51.100.0/24" + * userDefinedFields: + * - name: "ipv4_fragment_offset" + * values: + * - "1-0x1fff" + * The above match condition matches packets with a source IP in + * 192.0.2.0/24 or 198.51.100.0/24 and a user-defined field named + * "ipv4_fragment_offset" with a value between 1 and 0x1fff inclusive. * * Generated from protobuf field optional .google.cloud.compute.v1.SecurityPolicyRuleNetworkMatcher network_match = 463387764; * @return \Google\Cloud\Compute\V1\SecurityPolicyRuleNetworkMatcher|null @@ -319,7 +529,36 @@ public function clearNetworkMatch() } /** - * A match condition that incoming packets are evaluated against for CLOUD_ARMOR_NETWORK security policies. If it matches, the corresponding 'action' is enforced. The match criteria for a rule consists of built-in match fields (like 'srcIpRanges') and potentially multiple user-defined match fields ('userDefinedFields'). Field values may be extracted directly from the packet or derived from it (e.g. 'srcRegionCodes'). Some fields may not be present in every packet (e.g. 'srcPorts'). A user-defined field is only present if the base header is found in the packet and the entire field is in bounds. Each match field may specify which values can match it, listing one or more ranges, prefixes, or exact values that are considered a match for the field. A field value must be present in order to match a specified match field. If no match values are specified for a match field, then any field value is considered to match it, and it's not required to be present. For strings specifying '*' is also equivalent to match all. For a packet to match a rule, all specified match fields must match the corresponding field values derived from the packet. Example: networkMatch: srcIpRanges: - "192.0.2.0/24" - "198.51.100.0/24" userDefinedFields: - name: "ipv4_fragment_offset" values: - "1-0x1fff" The above match condition matches packets with a source IP in 192.0.2.0/24 or 198.51.100.0/24 and a user-defined field named "ipv4_fragment_offset" with a value between 1 and 0x1fff inclusive. + * A match condition that incoming packets are evaluated against for + * CLOUD_ARMOR_NETWORK security policies. If it matches, the corresponding + * 'action' is enforced. + * The match criteria for a rule consists of built-in match fields (like + * 'srcIpRanges') and potentially multiple user-defined match fields + * ('userDefinedFields'). + * Field values may be extracted directly from the packet or derived from it + * (e.g. 'srcRegionCodes'). Some fields may not be present in every packet + * (e.g. 'srcPorts'). A user-defined field is only present if the base + * header is found in the packet and the entire field is in bounds. + * Each match field may specify which values can match it, listing one or + * more ranges, prefixes, or exact values that are considered a match for + * the field. A field value must be present in order to match a specified + * match field. If no match values are specified for a match field, then any + * field value is considered to match it, and it's not required to be + * present. For strings specifying '*' is also equivalent to match all. + * For a packet to match a rule, all specified match fields must match the + * corresponding field values derived from the packet. + * Example: + * networkMatch: + * srcIpRanges: + * - "192.0.2.0/24" + * - "198.51.100.0/24" + * userDefinedFields: + * - name: "ipv4_fragment_offset" + * values: + * - "1-0x1fff" + * The above match condition matches packets with a source IP in + * 192.0.2.0/24 or 198.51.100.0/24 and a user-defined field named + * "ipv4_fragment_offset" with a value between 1 and 0x1fff inclusive. * * Generated from protobuf field optional .google.cloud.compute.v1.SecurityPolicyRuleNetworkMatcher network_match = 463387764; * @param \Google\Cloud\Compute\V1\SecurityPolicyRuleNetworkMatcher $var @@ -334,7 +573,9 @@ public function setNetworkMatch($var) } /** - * Preconfigured WAF configuration to be applied for the rule. If the rule does not evaluate preconfigured WAF rules, i.e., if evaluatePreconfiguredWaf() is not used, this field will have no effect. + * Preconfigured WAF configuration to be applied for the rule. If the rule + * does not evaluate preconfigured WAF rules, i.e., if + * evaluatePreconfiguredWaf() is not used, this field will have no effect. * * Generated from protobuf field optional .google.cloud.compute.v1.SecurityPolicyRulePreconfiguredWafConfig preconfigured_waf_config = 117805027; * @return \Google\Cloud\Compute\V1\SecurityPolicyRulePreconfiguredWafConfig|null @@ -355,7 +596,9 @@ public function clearPreconfiguredWafConfig() } /** - * Preconfigured WAF configuration to be applied for the rule. If the rule does not evaluate preconfigured WAF rules, i.e., if evaluatePreconfiguredWaf() is not used, this field will have no effect. + * Preconfigured WAF configuration to be applied for the rule. If the rule + * does not evaluate preconfigured WAF rules, i.e., if + * evaluatePreconfiguredWaf() is not used, this field will have no effect. * * Generated from protobuf field optional .google.cloud.compute.v1.SecurityPolicyRulePreconfiguredWafConfig preconfigured_waf_config = 117805027; * @param \Google\Cloud\Compute\V1\SecurityPolicyRulePreconfiguredWafConfig $var @@ -406,7 +649,10 @@ public function setPreview($var) } /** - * An integer indicating the priority of a rule in the list. The priority must be a positive value between 0 and 2147483647. Rules are evaluated from highest to lowest priority where 0 is the highest priority and 2147483647 is the lowest priority. + * An integer indicating the priority of a rule in the list. The priority + * must be a positive value between 0 and 2147483647. + * Rules are evaluated from highest to lowest priority where 0 is the + * highest priority and 2147483647 is the lowest priority. * * Generated from protobuf field optional int32 priority = 445151652; * @return int @@ -427,7 +673,10 @@ public function clearPriority() } /** - * An integer indicating the priority of a rule in the list. The priority must be a positive value between 0 and 2147483647. Rules are evaluated from highest to lowest priority where 0 is the highest priority and 2147483647 is the lowest priority. + * An integer indicating the priority of a rule in the list. The priority + * must be a positive value between 0 and 2147483647. + * Rules are evaluated from highest to lowest priority where 0 is the + * highest priority and 2147483647 is the lowest priority. * * Generated from protobuf field optional int32 priority = 445151652; * @param int $var @@ -442,7 +691,8 @@ public function setPriority($var) } /** - * Must be specified if the action is "rate_based_ban" or "throttle" or "fairshare". Cannot be specified for any other actions. + * Must be specified if the action is "rate_based_ban" or "throttle" or + * "fairshare". Cannot be specified for any other actions. * * Generated from protobuf field optional .google.cloud.compute.v1.SecurityPolicyRuleRateLimitOptions rate_limit_options = 67544315; * @return \Google\Cloud\Compute\V1\SecurityPolicyRuleRateLimitOptions|null @@ -463,7 +713,8 @@ public function clearRateLimitOptions() } /** - * Must be specified if the action is "rate_based_ban" or "throttle" or "fairshare". Cannot be specified for any other actions. + * Must be specified if the action is "rate_based_ban" or "throttle" or + * "fairshare". Cannot be specified for any other actions. * * Generated from protobuf field optional .google.cloud.compute.v1.SecurityPolicyRuleRateLimitOptions rate_limit_options = 67544315; * @param \Google\Cloud\Compute\V1\SecurityPolicyRuleRateLimitOptions $var @@ -478,7 +729,10 @@ public function setRateLimitOptions($var) } /** - * Parameters defining the redirect action. Cannot be specified for any other actions. This field is only supported in Global Security Policies of type CLOUD_ARMOR. + * Parameters defining the redirect action. Cannot be specified for any + * other actions. + * This field is only supported in Global Security Policies of type + * CLOUD_ARMOR. * * Generated from protobuf field optional .google.cloud.compute.v1.SecurityPolicyRuleRedirectOptions redirect_options = 163285307; * @return \Google\Cloud\Compute\V1\SecurityPolicyRuleRedirectOptions|null @@ -499,7 +753,10 @@ public function clearRedirectOptions() } /** - * Parameters defining the redirect action. Cannot be specified for any other actions. This field is only supported in Global Security Policies of type CLOUD_ARMOR. + * Parameters defining the redirect action. Cannot be specified for any + * other actions. + * This field is only supported in Global Security Policies of type + * CLOUD_ARMOR. * * Generated from protobuf field optional .google.cloud.compute.v1.SecurityPolicyRuleRedirectOptions redirect_options = 163285307; * @param \Google\Cloud\Compute\V1\SecurityPolicyRuleRedirectOptions $var diff --git a/Compute/src/V1/SecurityPolicyRuleHttpHeaderAction.php b/Compute/src/V1/SecurityPolicyRuleHttpHeaderAction.php index 20b2789d1421..84668f15e2ef 100644 --- a/Compute/src/V1/SecurityPolicyRuleHttpHeaderAction.php +++ b/Compute/src/V1/SecurityPolicyRuleHttpHeaderAction.php @@ -15,7 +15,8 @@ class SecurityPolicyRuleHttpHeaderAction extends \Google\Protobuf\Internal\Message { /** - * The list of request headers to add or overwrite if they're already present. + * The list of request headers to add or overwrite if they're already + * present. * * Generated from protobuf field repeated .google.cloud.compute.v1.SecurityPolicyRuleHttpHeaderActionHttpHeaderOption request_headers_to_adds = 87987661; */ @@ -28,7 +29,8 @@ class SecurityPolicyRuleHttpHeaderAction extends \Google\Protobuf\Internal\Messa * Optional. Data for populating the Message object. * * @type array<\Google\Cloud\Compute\V1\SecurityPolicyRuleHttpHeaderActionHttpHeaderOption>|\Google\Protobuf\Internal\RepeatedField $request_headers_to_adds - * The list of request headers to add or overwrite if they're already present. + * The list of request headers to add or overwrite if they're already + * present. * } */ public function __construct($data = NULL) { @@ -37,7 +39,8 @@ public function __construct($data = NULL) { } /** - * The list of request headers to add or overwrite if they're already present. + * The list of request headers to add or overwrite if they're already + * present. * * Generated from protobuf field repeated .google.cloud.compute.v1.SecurityPolicyRuleHttpHeaderActionHttpHeaderOption request_headers_to_adds = 87987661; * @return \Google\Protobuf\Internal\RepeatedField @@ -48,7 +51,8 @@ public function getRequestHeadersToAdds() } /** - * The list of request headers to add or overwrite if they're already present. + * The list of request headers to add or overwrite if they're already + * present. * * Generated from protobuf field repeated .google.cloud.compute.v1.SecurityPolicyRuleHttpHeaderActionHttpHeaderOption request_headers_to_adds = 87987661; * @param array<\Google\Cloud\Compute\V1\SecurityPolicyRuleHttpHeaderActionHttpHeaderOption>|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/SecurityPolicyRuleMatcher.php b/Compute/src/V1/SecurityPolicyRuleMatcher.php index 60ddec4ca4a3..626568a3c2a8 100644 --- a/Compute/src/V1/SecurityPolicyRuleMatcher.php +++ b/Compute/src/V1/SecurityPolicyRuleMatcher.php @@ -9,32 +9,48 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Represents a match condition that incoming traffic is evaluated against. Exactly one field must be specified. + * Represents a match condition that incoming traffic is evaluated against. + * Exactly one field must be specified. * * Generated from protobuf message google.cloud.compute.v1.SecurityPolicyRuleMatcher */ class SecurityPolicyRuleMatcher extends \Google\Protobuf\Internal\Message { /** - * The configuration options available when specifying versioned_expr. This field must be specified if versioned_expr is specified and cannot be specified if versioned_expr is not specified. + * The configuration options available when specifying versioned_expr. + * This field must be specified if versioned_expr is specified and cannot + * be specified if versioned_expr is not specified. * * Generated from protobuf field optional .google.cloud.compute.v1.SecurityPolicyRuleMatcherConfig config = 255820610; */ protected $config = null; /** - * User defined CEVAL expression. A CEVAL expression is used to specify match criteria such as origin.ip, source.region_code and contents in the request header. Expressions containing `evaluateThreatIntelligence` require a Cloud Armor Enterprise subscription and are not supported in Edge Policies nor in Regional Policies. Expressions containing `evaluatePreconfiguredExpr('sourceiplist-*')` require a Cloud Armor Enterprise subscription and are only supported in Global Security Policies. + * User defined CEVAL expression. + * A CEVAL expression is used to specify match criteria such as origin.ip, + * source.region_code and contents in the request header. + * Expressions containing `evaluateThreatIntelligence` require a Cloud + * Armor Enterprise subscription and are not supported in Edge Policies + * nor in Regional Policies. Expressions containing + * `evaluatePreconfiguredExpr('sourceiplist-*')` require a Cloud Armor + * Enterprise subscription and are only supported in Global Security + * Policies. * * Generated from protobuf field optional .google.cloud.compute.v1.Expr expr = 3127797; */ protected $expr = null; /** - * The configuration options available when specifying a user defined CEVAL expression (i.e., 'expr'). + * The configuration options available when specifying a user defined + * CEVAL expression (i.e., 'expr'). * * Generated from protobuf field optional .google.cloud.compute.v1.SecurityPolicyRuleMatcherExprOptions expr_options = 486220372; */ protected $expr_options = null; /** - * Preconfigured versioned expression. If this field is specified, config must also be specified. Available preconfigured expressions along with their requirements are: SRC_IPS_V1 - must specify the corresponding src_ip_range field in config. + * Preconfigured versioned expression. + * If this field is specified, config must also be specified. + * Available preconfigured expressions along with their requirements are: + * SRC_IPS_V1 - must specify the corresponding src_ip_range field in + * config. * Check the VersionedExpr enum for the list of possible values. * * Generated from protobuf field optional string versioned_expr = 322286013; @@ -48,13 +64,28 @@ class SecurityPolicyRuleMatcher extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type \Google\Cloud\Compute\V1\SecurityPolicyRuleMatcherConfig $config - * The configuration options available when specifying versioned_expr. This field must be specified if versioned_expr is specified and cannot be specified if versioned_expr is not specified. + * The configuration options available when specifying versioned_expr. + * This field must be specified if versioned_expr is specified and cannot + * be specified if versioned_expr is not specified. * @type \Google\Cloud\Compute\V1\Expr $expr - * User defined CEVAL expression. A CEVAL expression is used to specify match criteria such as origin.ip, source.region_code and contents in the request header. Expressions containing `evaluateThreatIntelligence` require a Cloud Armor Enterprise subscription and are not supported in Edge Policies nor in Regional Policies. Expressions containing `evaluatePreconfiguredExpr('sourceiplist-*')` require a Cloud Armor Enterprise subscription and are only supported in Global Security Policies. + * User defined CEVAL expression. + * A CEVAL expression is used to specify match criteria such as origin.ip, + * source.region_code and contents in the request header. + * Expressions containing `evaluateThreatIntelligence` require a Cloud + * Armor Enterprise subscription and are not supported in Edge Policies + * nor in Regional Policies. Expressions containing + * `evaluatePreconfiguredExpr('sourceiplist-*')` require a Cloud Armor + * Enterprise subscription and are only supported in Global Security + * Policies. * @type \Google\Cloud\Compute\V1\SecurityPolicyRuleMatcherExprOptions $expr_options - * The configuration options available when specifying a user defined CEVAL expression (i.e., 'expr'). + * The configuration options available when specifying a user defined + * CEVAL expression (i.e., 'expr'). * @type string $versioned_expr - * Preconfigured versioned expression. If this field is specified, config must also be specified. Available preconfigured expressions along with their requirements are: SRC_IPS_V1 - must specify the corresponding src_ip_range field in config. + * Preconfigured versioned expression. + * If this field is specified, config must also be specified. + * Available preconfigured expressions along with their requirements are: + * SRC_IPS_V1 - must specify the corresponding src_ip_range field in + * config. * Check the VersionedExpr enum for the list of possible values. * } */ @@ -64,7 +95,9 @@ public function __construct($data = NULL) { } /** - * The configuration options available when specifying versioned_expr. This field must be specified if versioned_expr is specified and cannot be specified if versioned_expr is not specified. + * The configuration options available when specifying versioned_expr. + * This field must be specified if versioned_expr is specified and cannot + * be specified if versioned_expr is not specified. * * Generated from protobuf field optional .google.cloud.compute.v1.SecurityPolicyRuleMatcherConfig config = 255820610; * @return \Google\Cloud\Compute\V1\SecurityPolicyRuleMatcherConfig|null @@ -85,7 +118,9 @@ public function clearConfig() } /** - * The configuration options available when specifying versioned_expr. This field must be specified if versioned_expr is specified and cannot be specified if versioned_expr is not specified. + * The configuration options available when specifying versioned_expr. + * This field must be specified if versioned_expr is specified and cannot + * be specified if versioned_expr is not specified. * * Generated from protobuf field optional .google.cloud.compute.v1.SecurityPolicyRuleMatcherConfig config = 255820610; * @param \Google\Cloud\Compute\V1\SecurityPolicyRuleMatcherConfig $var @@ -100,7 +135,15 @@ public function setConfig($var) } /** - * User defined CEVAL expression. A CEVAL expression is used to specify match criteria such as origin.ip, source.region_code and contents in the request header. Expressions containing `evaluateThreatIntelligence` require a Cloud Armor Enterprise subscription and are not supported in Edge Policies nor in Regional Policies. Expressions containing `evaluatePreconfiguredExpr('sourceiplist-*')` require a Cloud Armor Enterprise subscription and are only supported in Global Security Policies. + * User defined CEVAL expression. + * A CEVAL expression is used to specify match criteria such as origin.ip, + * source.region_code and contents in the request header. + * Expressions containing `evaluateThreatIntelligence` require a Cloud + * Armor Enterprise subscription and are not supported in Edge Policies + * nor in Regional Policies. Expressions containing + * `evaluatePreconfiguredExpr('sourceiplist-*')` require a Cloud Armor + * Enterprise subscription and are only supported in Global Security + * Policies. * * Generated from protobuf field optional .google.cloud.compute.v1.Expr expr = 3127797; * @return \Google\Cloud\Compute\V1\Expr|null @@ -121,7 +164,15 @@ public function clearExpr() } /** - * User defined CEVAL expression. A CEVAL expression is used to specify match criteria such as origin.ip, source.region_code and contents in the request header. Expressions containing `evaluateThreatIntelligence` require a Cloud Armor Enterprise subscription and are not supported in Edge Policies nor in Regional Policies. Expressions containing `evaluatePreconfiguredExpr('sourceiplist-*')` require a Cloud Armor Enterprise subscription and are only supported in Global Security Policies. + * User defined CEVAL expression. + * A CEVAL expression is used to specify match criteria such as origin.ip, + * source.region_code and contents in the request header. + * Expressions containing `evaluateThreatIntelligence` require a Cloud + * Armor Enterprise subscription and are not supported in Edge Policies + * nor in Regional Policies. Expressions containing + * `evaluatePreconfiguredExpr('sourceiplist-*')` require a Cloud Armor + * Enterprise subscription and are only supported in Global Security + * Policies. * * Generated from protobuf field optional .google.cloud.compute.v1.Expr expr = 3127797; * @param \Google\Cloud\Compute\V1\Expr $var @@ -136,7 +187,8 @@ public function setExpr($var) } /** - * The configuration options available when specifying a user defined CEVAL expression (i.e., 'expr'). + * The configuration options available when specifying a user defined + * CEVAL expression (i.e., 'expr'). * * Generated from protobuf field optional .google.cloud.compute.v1.SecurityPolicyRuleMatcherExprOptions expr_options = 486220372; * @return \Google\Cloud\Compute\V1\SecurityPolicyRuleMatcherExprOptions|null @@ -157,7 +209,8 @@ public function clearExprOptions() } /** - * The configuration options available when specifying a user defined CEVAL expression (i.e., 'expr'). + * The configuration options available when specifying a user defined + * CEVAL expression (i.e., 'expr'). * * Generated from protobuf field optional .google.cloud.compute.v1.SecurityPolicyRuleMatcherExprOptions expr_options = 486220372; * @param \Google\Cloud\Compute\V1\SecurityPolicyRuleMatcherExprOptions $var @@ -172,7 +225,11 @@ public function setExprOptions($var) } /** - * Preconfigured versioned expression. If this field is specified, config must also be specified. Available preconfigured expressions along with their requirements are: SRC_IPS_V1 - must specify the corresponding src_ip_range field in config. + * Preconfigured versioned expression. + * If this field is specified, config must also be specified. + * Available preconfigured expressions along with their requirements are: + * SRC_IPS_V1 - must specify the corresponding src_ip_range field in + * config. * Check the VersionedExpr enum for the list of possible values. * * Generated from protobuf field optional string versioned_expr = 322286013; @@ -194,7 +251,11 @@ public function clearVersionedExpr() } /** - * Preconfigured versioned expression. If this field is specified, config must also be specified. Available preconfigured expressions along with their requirements are: SRC_IPS_V1 - must specify the corresponding src_ip_range field in config. + * Preconfigured versioned expression. + * If this field is specified, config must also be specified. + * Available preconfigured expressions along with their requirements are: + * SRC_IPS_V1 - must specify the corresponding src_ip_range field in + * config. * Check the VersionedExpr enum for the list of possible values. * * Generated from protobuf field optional string versioned_expr = 322286013; diff --git a/Compute/src/V1/SecurityPolicyRuleMatcher/VersionedExpr.php b/Compute/src/V1/SecurityPolicyRuleMatcher/VersionedExpr.php index 7bf4207a8826..7ff4199466cc 100644 --- a/Compute/src/V1/SecurityPolicyRuleMatcher/VersionedExpr.php +++ b/Compute/src/V1/SecurityPolicyRuleMatcher/VersionedExpr.php @@ -7,7 +7,11 @@ use UnexpectedValueException; /** - * Preconfigured versioned expression. If this field is specified, config must also be specified. Available preconfigured expressions along with their requirements are: SRC_IPS_V1 - must specify the corresponding src_ip_range field in config. + * Preconfigured versioned expression. + * If this field is specified, config must also be specified. + * Available preconfigured expressions along with their requirements are: + * SRC_IPS_V1 - must specify the corresponding src_ip_range field in + * config. * * Protobuf type google.cloud.compute.v1.SecurityPolicyRuleMatcher.VersionedExpr */ @@ -20,7 +24,8 @@ class VersionedExpr */ const UNDEFINED_VERSIONED_EXPR = 0; /** - * Matches the source IP address of a request to the IP ranges supplied in config. + * Matches the source IP address of a request to the IP ranges supplied + * in config. * * Generated from protobuf enum SRC_IPS_V1 = 70925961; */ diff --git a/Compute/src/V1/SecurityPolicyRuleMatcherConfig.php b/Compute/src/V1/SecurityPolicyRuleMatcherConfig.php index fac622505928..195c560d85ef 100644 --- a/Compute/src/V1/SecurityPolicyRuleMatcherConfig.php +++ b/Compute/src/V1/SecurityPolicyRuleMatcherConfig.php @@ -15,7 +15,8 @@ class SecurityPolicyRuleMatcherConfig extends \Google\Protobuf\Internal\Message { /** - * CIDR IP address range. Maximum number of src_ip_ranges allowed is 10. + * CIDR IP address range. + * Maximum number of src_ip_ranges allowed is 10. * * Generated from protobuf field repeated string src_ip_ranges = 432128083; */ @@ -28,7 +29,8 @@ class SecurityPolicyRuleMatcherConfig extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type array|\Google\Protobuf\Internal\RepeatedField $src_ip_ranges - * CIDR IP address range. Maximum number of src_ip_ranges allowed is 10. + * CIDR IP address range. + * Maximum number of src_ip_ranges allowed is 10. * } */ public function __construct($data = NULL) { @@ -37,7 +39,8 @@ public function __construct($data = NULL) { } /** - * CIDR IP address range. Maximum number of src_ip_ranges allowed is 10. + * CIDR IP address range. + * Maximum number of src_ip_ranges allowed is 10. * * Generated from protobuf field repeated string src_ip_ranges = 432128083; * @return \Google\Protobuf\Internal\RepeatedField @@ -48,7 +51,8 @@ public function getSrcIpRanges() } /** - * CIDR IP address range. Maximum number of src_ip_ranges allowed is 10. + * CIDR IP address range. + * Maximum number of src_ip_ranges allowed is 10. * * Generated from protobuf field repeated string src_ip_ranges = 432128083; * @param array|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/SecurityPolicyRuleMatcherExprOptions.php b/Compute/src/V1/SecurityPolicyRuleMatcherExprOptions.php index 69b6f559dc29..9034a28b47bc 100644 --- a/Compute/src/V1/SecurityPolicyRuleMatcherExprOptions.php +++ b/Compute/src/V1/SecurityPolicyRuleMatcherExprOptions.php @@ -15,7 +15,8 @@ class SecurityPolicyRuleMatcherExprOptions extends \Google\Protobuf\Internal\Message { /** - * reCAPTCHA configuration options to be applied for the rule. If the rule does not evaluate reCAPTCHA tokens, this field has no effect. + * reCAPTCHA configuration options to be applied for the rule. If the + * rule does not evaluate reCAPTCHA tokens, this field has no effect. * * Generated from protobuf field optional .google.cloud.compute.v1.SecurityPolicyRuleMatcherExprOptionsRecaptchaOptions recaptcha_options = 389151558; */ @@ -28,7 +29,8 @@ class SecurityPolicyRuleMatcherExprOptions extends \Google\Protobuf\Internal\Mes * Optional. Data for populating the Message object. * * @type \Google\Cloud\Compute\V1\SecurityPolicyRuleMatcherExprOptionsRecaptchaOptions $recaptcha_options - * reCAPTCHA configuration options to be applied for the rule. If the rule does not evaluate reCAPTCHA tokens, this field has no effect. + * reCAPTCHA configuration options to be applied for the rule. If the + * rule does not evaluate reCAPTCHA tokens, this field has no effect. * } */ public function __construct($data = NULL) { @@ -37,7 +39,8 @@ public function __construct($data = NULL) { } /** - * reCAPTCHA configuration options to be applied for the rule. If the rule does not evaluate reCAPTCHA tokens, this field has no effect. + * reCAPTCHA configuration options to be applied for the rule. If the + * rule does not evaluate reCAPTCHA tokens, this field has no effect. * * Generated from protobuf field optional .google.cloud.compute.v1.SecurityPolicyRuleMatcherExprOptionsRecaptchaOptions recaptcha_options = 389151558; * @return \Google\Cloud\Compute\V1\SecurityPolicyRuleMatcherExprOptionsRecaptchaOptions|null @@ -58,7 +61,8 @@ public function clearRecaptchaOptions() } /** - * reCAPTCHA configuration options to be applied for the rule. If the rule does not evaluate reCAPTCHA tokens, this field has no effect. + * reCAPTCHA configuration options to be applied for the rule. If the + * rule does not evaluate reCAPTCHA tokens, this field has no effect. * * Generated from protobuf field optional .google.cloud.compute.v1.SecurityPolicyRuleMatcherExprOptionsRecaptchaOptions recaptcha_options = 389151558; * @param \Google\Cloud\Compute\V1\SecurityPolicyRuleMatcherExprOptionsRecaptchaOptions $var diff --git a/Compute/src/V1/SecurityPolicyRuleMatcherExprOptionsRecaptchaOptions.php b/Compute/src/V1/SecurityPolicyRuleMatcherExprOptionsRecaptchaOptions.php index 9962c90cbc28..4c0961a57672 100644 --- a/Compute/src/V1/SecurityPolicyRuleMatcherExprOptionsRecaptchaOptions.php +++ b/Compute/src/V1/SecurityPolicyRuleMatcherExprOptionsRecaptchaOptions.php @@ -15,13 +15,19 @@ class SecurityPolicyRuleMatcherExprOptionsRecaptchaOptions extends \Google\Protobuf\Internal\Message { /** - * A list of site keys to be used during the validation of reCAPTCHA action-tokens. The provided site keys need to be created from reCAPTCHA API under the same project where the security policy is created. + * A list of site keys to be used during the validation of reCAPTCHA + * action-tokens. The provided site keys need to be created from + * reCAPTCHA API under the same project where the security policy is + * created. * * Generated from protobuf field repeated string action_token_site_keys = 59929885; */ private $action_token_site_keys; /** - * A list of site keys to be used during the validation of reCAPTCHA session-tokens. The provided site keys need to be created from reCAPTCHA API under the same project where the security policy is created. + * A list of site keys to be used during the validation of reCAPTCHA + * session-tokens. The provided site keys need to be created from + * reCAPTCHA API under the same project where the security policy is + * created. * * Generated from protobuf field repeated string session_token_site_keys = 333363581; */ @@ -34,9 +40,15 @@ class SecurityPolicyRuleMatcherExprOptionsRecaptchaOptions extends \Google\Proto * Optional. Data for populating the Message object. * * @type array|\Google\Protobuf\Internal\RepeatedField $action_token_site_keys - * A list of site keys to be used during the validation of reCAPTCHA action-tokens. The provided site keys need to be created from reCAPTCHA API under the same project where the security policy is created. + * A list of site keys to be used during the validation of reCAPTCHA + * action-tokens. The provided site keys need to be created from + * reCAPTCHA API under the same project where the security policy is + * created. * @type array|\Google\Protobuf\Internal\RepeatedField $session_token_site_keys - * A list of site keys to be used during the validation of reCAPTCHA session-tokens. The provided site keys need to be created from reCAPTCHA API under the same project where the security policy is created. + * A list of site keys to be used during the validation of reCAPTCHA + * session-tokens. The provided site keys need to be created from + * reCAPTCHA API under the same project where the security policy is + * created. * } */ public function __construct($data = NULL) { @@ -45,7 +57,10 @@ public function __construct($data = NULL) { } /** - * A list of site keys to be used during the validation of reCAPTCHA action-tokens. The provided site keys need to be created from reCAPTCHA API under the same project where the security policy is created. + * A list of site keys to be used during the validation of reCAPTCHA + * action-tokens. The provided site keys need to be created from + * reCAPTCHA API under the same project where the security policy is + * created. * * Generated from protobuf field repeated string action_token_site_keys = 59929885; * @return \Google\Protobuf\Internal\RepeatedField @@ -56,7 +71,10 @@ public function getActionTokenSiteKeys() } /** - * A list of site keys to be used during the validation of reCAPTCHA action-tokens. The provided site keys need to be created from reCAPTCHA API under the same project where the security policy is created. + * A list of site keys to be used during the validation of reCAPTCHA + * action-tokens. The provided site keys need to be created from + * reCAPTCHA API under the same project where the security policy is + * created. * * Generated from protobuf field repeated string action_token_site_keys = 59929885; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -71,7 +89,10 @@ public function setActionTokenSiteKeys($var) } /** - * A list of site keys to be used during the validation of reCAPTCHA session-tokens. The provided site keys need to be created from reCAPTCHA API under the same project where the security policy is created. + * A list of site keys to be used during the validation of reCAPTCHA + * session-tokens. The provided site keys need to be created from + * reCAPTCHA API under the same project where the security policy is + * created. * * Generated from protobuf field repeated string session_token_site_keys = 333363581; * @return \Google\Protobuf\Internal\RepeatedField @@ -82,7 +103,10 @@ public function getSessionTokenSiteKeys() } /** - * A list of site keys to be used during the validation of reCAPTCHA session-tokens. The provided site keys need to be created from reCAPTCHA API under the same project where the security policy is created. + * A list of site keys to be used during the validation of reCAPTCHA + * session-tokens. The provided site keys need to be created from + * reCAPTCHA API under the same project where the security policy is + * created. * * Generated from protobuf field repeated string session_token_site_keys = 333363581; * @param array|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/SecurityPolicyRuleNetworkMatcher.php b/Compute/src/V1/SecurityPolicyRuleNetworkMatcher.php index 0d2db0bb9cd8..5959bea673f3 100644 --- a/Compute/src/V1/SecurityPolicyRuleNetworkMatcher.php +++ b/Compute/src/V1/SecurityPolicyRuleNetworkMatcher.php @@ -9,26 +9,32 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Represents a match condition that incoming network traffic is evaluated against. + * Represents a match condition that incoming network traffic is evaluated + * against. * * Generated from protobuf message google.cloud.compute.v1.SecurityPolicyRuleNetworkMatcher */ class SecurityPolicyRuleNetworkMatcher extends \Google\Protobuf\Internal\Message { /** - * Destination IPv4/IPv6 addresses or CIDR prefixes, in standard text format. + * Destination IPv4/IPv6 addresses or CIDR prefixes, in standard text + * format. * * Generated from protobuf field repeated string dest_ip_ranges = 337357713; */ private $dest_ip_ranges; /** - * Destination port numbers for TCP/UDP/SCTP. Each element can be a 16-bit unsigned decimal number (e.g. "80") or range (e.g. "0-1023"). + * Destination port numbers for TCP/UDP/SCTP. Each element can be a 16-bit + * unsigned decimal number (e.g. "80") or range (e.g. "0-1023"). * * Generated from protobuf field repeated string dest_ports = 379902005; */ private $dest_ports; /** - * IPv4 protocol / IPv6 next header (after extension headers). Each element can be an 8-bit unsigned decimal number (e.g. "6"), range (e.g. "253-254"), or one of the following protocol names: "tcp", "udp", "icmp", "esp", "ah", "ipip", or "sctp". + * IPv4 protocol / IPv6 next header (after extension headers). Each + * element can be an 8-bit unsigned decimal number (e.g. "6"), range (e.g. + * "253-254"), or one of the following protocol names: "tcp", "udp", + * "icmp", "esp", "ah", "ipip", or "sctp". * * Generated from protobuf field repeated string ip_protocols = 259213251; */ @@ -46,19 +52,22 @@ class SecurityPolicyRuleNetworkMatcher extends \Google\Protobuf\Internal\Message */ private $src_ip_ranges; /** - * Source port numbers for TCP/UDP/SCTP. Each element can be a 16-bit unsigned decimal number (e.g. "80") or range (e.g. "0-1023"). + * Source port numbers for TCP/UDP/SCTP. Each element can be a 16-bit + * unsigned decimal number (e.g. "80") or range (e.g. "0-1023"). * * Generated from protobuf field repeated string src_ports = 445095415; */ private $src_ports; /** - * Two-letter ISO 3166-1 alpha-2 country code associated with the source IP address. + * Two-letter ISO 3166-1 alpha-2 country code associated with the source + * IP address. * * Generated from protobuf field repeated string src_region_codes = 99086742; */ private $src_region_codes; /** - * User-defined fields. Each element names a defined field and lists the matching values for that field. + * User-defined fields. Each element names a defined field and lists the + * matching values for that field. * * Generated from protobuf field repeated .google.cloud.compute.v1.SecurityPolicyRuleNetworkMatcherUserDefinedFieldMatch user_defined_fields = 28312739; */ @@ -71,21 +80,29 @@ class SecurityPolicyRuleNetworkMatcher extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type array|\Google\Protobuf\Internal\RepeatedField $dest_ip_ranges - * Destination IPv4/IPv6 addresses or CIDR prefixes, in standard text format. + * Destination IPv4/IPv6 addresses or CIDR prefixes, in standard text + * format. * @type array|\Google\Protobuf\Internal\RepeatedField $dest_ports - * Destination port numbers for TCP/UDP/SCTP. Each element can be a 16-bit unsigned decimal number (e.g. "80") or range (e.g. "0-1023"). + * Destination port numbers for TCP/UDP/SCTP. Each element can be a 16-bit + * unsigned decimal number (e.g. "80") or range (e.g. "0-1023"). * @type array|\Google\Protobuf\Internal\RepeatedField $ip_protocols - * IPv4 protocol / IPv6 next header (after extension headers). Each element can be an 8-bit unsigned decimal number (e.g. "6"), range (e.g. "253-254"), or one of the following protocol names: "tcp", "udp", "icmp", "esp", "ah", "ipip", or "sctp". + * IPv4 protocol / IPv6 next header (after extension headers). Each + * element can be an 8-bit unsigned decimal number (e.g. "6"), range (e.g. + * "253-254"), or one of the following protocol names: "tcp", "udp", + * "icmp", "esp", "ah", "ipip", or "sctp". * @type array|\Google\Protobuf\Internal\RepeatedField $src_asns * BGP Autonomous System Number associated with the source IP address. * @type array|\Google\Protobuf\Internal\RepeatedField $src_ip_ranges * Source IPv4/IPv6 addresses or CIDR prefixes, in standard text format. * @type array|\Google\Protobuf\Internal\RepeatedField $src_ports - * Source port numbers for TCP/UDP/SCTP. Each element can be a 16-bit unsigned decimal number (e.g. "80") or range (e.g. "0-1023"). + * Source port numbers for TCP/UDP/SCTP. Each element can be a 16-bit + * unsigned decimal number (e.g. "80") or range (e.g. "0-1023"). * @type array|\Google\Protobuf\Internal\RepeatedField $src_region_codes - * Two-letter ISO 3166-1 alpha-2 country code associated with the source IP address. + * Two-letter ISO 3166-1 alpha-2 country code associated with the source + * IP address. * @type array<\Google\Cloud\Compute\V1\SecurityPolicyRuleNetworkMatcherUserDefinedFieldMatch>|\Google\Protobuf\Internal\RepeatedField $user_defined_fields - * User-defined fields. Each element names a defined field and lists the matching values for that field. + * User-defined fields. Each element names a defined field and lists the + * matching values for that field. * } */ public function __construct($data = NULL) { @@ -94,7 +111,8 @@ public function __construct($data = NULL) { } /** - * Destination IPv4/IPv6 addresses or CIDR prefixes, in standard text format. + * Destination IPv4/IPv6 addresses or CIDR prefixes, in standard text + * format. * * Generated from protobuf field repeated string dest_ip_ranges = 337357713; * @return \Google\Protobuf\Internal\RepeatedField @@ -105,7 +123,8 @@ public function getDestIpRanges() } /** - * Destination IPv4/IPv6 addresses or CIDR prefixes, in standard text format. + * Destination IPv4/IPv6 addresses or CIDR prefixes, in standard text + * format. * * Generated from protobuf field repeated string dest_ip_ranges = 337357713; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -120,7 +139,8 @@ public function setDestIpRanges($var) } /** - * Destination port numbers for TCP/UDP/SCTP. Each element can be a 16-bit unsigned decimal number (e.g. "80") or range (e.g. "0-1023"). + * Destination port numbers for TCP/UDP/SCTP. Each element can be a 16-bit + * unsigned decimal number (e.g. "80") or range (e.g. "0-1023"). * * Generated from protobuf field repeated string dest_ports = 379902005; * @return \Google\Protobuf\Internal\RepeatedField @@ -131,7 +151,8 @@ public function getDestPorts() } /** - * Destination port numbers for TCP/UDP/SCTP. Each element can be a 16-bit unsigned decimal number (e.g. "80") or range (e.g. "0-1023"). + * Destination port numbers for TCP/UDP/SCTP. Each element can be a 16-bit + * unsigned decimal number (e.g. "80") or range (e.g. "0-1023"). * * Generated from protobuf field repeated string dest_ports = 379902005; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -146,7 +167,10 @@ public function setDestPorts($var) } /** - * IPv4 protocol / IPv6 next header (after extension headers). Each element can be an 8-bit unsigned decimal number (e.g. "6"), range (e.g. "253-254"), or one of the following protocol names: "tcp", "udp", "icmp", "esp", "ah", "ipip", or "sctp". + * IPv4 protocol / IPv6 next header (after extension headers). Each + * element can be an 8-bit unsigned decimal number (e.g. "6"), range (e.g. + * "253-254"), or one of the following protocol names: "tcp", "udp", + * "icmp", "esp", "ah", "ipip", or "sctp". * * Generated from protobuf field repeated string ip_protocols = 259213251; * @return \Google\Protobuf\Internal\RepeatedField @@ -157,7 +181,10 @@ public function getIpProtocols() } /** - * IPv4 protocol / IPv6 next header (after extension headers). Each element can be an 8-bit unsigned decimal number (e.g. "6"), range (e.g. "253-254"), or one of the following protocol names: "tcp", "udp", "icmp", "esp", "ah", "ipip", or "sctp". + * IPv4 protocol / IPv6 next header (after extension headers). Each + * element can be an 8-bit unsigned decimal number (e.g. "6"), range (e.g. + * "253-254"), or one of the following protocol names: "tcp", "udp", + * "icmp", "esp", "ah", "ipip", or "sctp". * * Generated from protobuf field repeated string ip_protocols = 259213251; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -224,7 +251,8 @@ public function setSrcIpRanges($var) } /** - * Source port numbers for TCP/UDP/SCTP. Each element can be a 16-bit unsigned decimal number (e.g. "80") or range (e.g. "0-1023"). + * Source port numbers for TCP/UDP/SCTP. Each element can be a 16-bit + * unsigned decimal number (e.g. "80") or range (e.g. "0-1023"). * * Generated from protobuf field repeated string src_ports = 445095415; * @return \Google\Protobuf\Internal\RepeatedField @@ -235,7 +263,8 @@ public function getSrcPorts() } /** - * Source port numbers for TCP/UDP/SCTP. Each element can be a 16-bit unsigned decimal number (e.g. "80") or range (e.g. "0-1023"). + * Source port numbers for TCP/UDP/SCTP. Each element can be a 16-bit + * unsigned decimal number (e.g. "80") or range (e.g. "0-1023"). * * Generated from protobuf field repeated string src_ports = 445095415; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -250,7 +279,8 @@ public function setSrcPorts($var) } /** - * Two-letter ISO 3166-1 alpha-2 country code associated with the source IP address. + * Two-letter ISO 3166-1 alpha-2 country code associated with the source + * IP address. * * Generated from protobuf field repeated string src_region_codes = 99086742; * @return \Google\Protobuf\Internal\RepeatedField @@ -261,7 +291,8 @@ public function getSrcRegionCodes() } /** - * Two-letter ISO 3166-1 alpha-2 country code associated with the source IP address. + * Two-letter ISO 3166-1 alpha-2 country code associated with the source + * IP address. * * Generated from protobuf field repeated string src_region_codes = 99086742; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -276,7 +307,8 @@ public function setSrcRegionCodes($var) } /** - * User-defined fields. Each element names a defined field and lists the matching values for that field. + * User-defined fields. Each element names a defined field and lists the + * matching values for that field. * * Generated from protobuf field repeated .google.cloud.compute.v1.SecurityPolicyRuleNetworkMatcherUserDefinedFieldMatch user_defined_fields = 28312739; * @return \Google\Protobuf\Internal\RepeatedField @@ -287,7 +319,8 @@ public function getUserDefinedFields() } /** - * User-defined fields. Each element names a defined field and lists the matching values for that field. + * User-defined fields. Each element names a defined field and lists the + * matching values for that field. * * Generated from protobuf field repeated .google.cloud.compute.v1.SecurityPolicyRuleNetworkMatcherUserDefinedFieldMatch user_defined_fields = 28312739; * @param array<\Google\Cloud\Compute\V1\SecurityPolicyRuleNetworkMatcherUserDefinedFieldMatch>|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/SecurityPolicyRuleNetworkMatcherUserDefinedFieldMatch.php b/Compute/src/V1/SecurityPolicyRuleNetworkMatcherUserDefinedFieldMatch.php index ca6cc8bbc5e1..250b9ecd2bb5 100644 --- a/Compute/src/V1/SecurityPolicyRuleNetworkMatcherUserDefinedFieldMatch.php +++ b/Compute/src/V1/SecurityPolicyRuleNetworkMatcherUserDefinedFieldMatch.php @@ -21,7 +21,9 @@ class SecurityPolicyRuleNetworkMatcherUserDefinedFieldMatch extends \Google\Prot */ protected $name = null; /** - * Matching values of the field. Each element can be a 32-bit unsigned decimal or hexadecimal (starting with "0x") number (e.g. "64") or range (e.g. "0x400-0x7ff"). + * Matching values of the field. Each element can be a 32-bit unsigned + * decimal or hexadecimal (starting with "0x") number (e.g. "64") or + * range (e.g. "0x400-0x7ff"). * * Generated from protobuf field repeated string values = 249928994; */ @@ -36,7 +38,9 @@ class SecurityPolicyRuleNetworkMatcherUserDefinedFieldMatch extends \Google\Prot * @type string $name * Name of the user-defined field, as given in the definition. * @type array|\Google\Protobuf\Internal\RepeatedField $values - * Matching values of the field. Each element can be a 32-bit unsigned decimal or hexadecimal (starting with "0x") number (e.g. "64") or range (e.g. "0x400-0x7ff"). + * Matching values of the field. Each element can be a 32-bit unsigned + * decimal or hexadecimal (starting with "0x") number (e.g. "64") or + * range (e.g. "0x400-0x7ff"). * } */ public function __construct($data = NULL) { @@ -81,7 +85,9 @@ public function setName($var) } /** - * Matching values of the field. Each element can be a 32-bit unsigned decimal or hexadecimal (starting with "0x") number (e.g. "64") or range (e.g. "0x400-0x7ff"). + * Matching values of the field. Each element can be a 32-bit unsigned + * decimal or hexadecimal (starting with "0x") number (e.g. "64") or + * range (e.g. "0x400-0x7ff"). * * Generated from protobuf field repeated string values = 249928994; * @return \Google\Protobuf\Internal\RepeatedField @@ -92,7 +98,9 @@ public function getValues() } /** - * Matching values of the field. Each element can be a 32-bit unsigned decimal or hexadecimal (starting with "0x") number (e.g. "64") or range (e.g. "0x400-0x7ff"). + * Matching values of the field. Each element can be a 32-bit unsigned + * decimal or hexadecimal (starting with "0x") number (e.g. "64") or + * range (e.g. "0x400-0x7ff"). * * Generated from protobuf field repeated string values = 249928994; * @param array|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/SecurityPolicyRulePreconfiguredWafConfigExclusion.php b/Compute/src/V1/SecurityPolicyRulePreconfiguredWafConfigExclusion.php index 6a53832d7064..48b4caa2fcd1 100644 --- a/Compute/src/V1/SecurityPolicyRulePreconfiguredWafConfigExclusion.php +++ b/Compute/src/V1/SecurityPolicyRulePreconfiguredWafConfigExclusion.php @@ -15,31 +15,39 @@ class SecurityPolicyRulePreconfiguredWafConfigExclusion extends \Google\Protobuf\Internal\Message { /** - * A list of request cookie names whose value will be excluded from inspection during preconfigured WAF evaluation. + * A list of request cookie names whose value will be excluded from + * inspection during preconfigured WAF evaluation. * * Generated from protobuf field repeated .google.cloud.compute.v1.SecurityPolicyRulePreconfiguredWafConfigExclusionFieldParams request_cookies_to_exclude = 156757878; */ private $request_cookies_to_exclude; /** - * A list of request header names whose value will be excluded from inspection during preconfigured WAF evaluation. + * A list of request header names whose value will be excluded from + * inspection during preconfigured WAF evaluation. * * Generated from protobuf field repeated .google.cloud.compute.v1.SecurityPolicyRulePreconfiguredWafConfigExclusionFieldParams request_headers_to_exclude = 63230495; */ private $request_headers_to_exclude; /** - * A list of request query parameter names whose value will be excluded from inspection during preconfigured WAF evaluation. Note that the parameter can be in the query string or in the POST body. + * A list of request query parameter names whose value will be excluded + * from inspection during preconfigured WAF evaluation. Note that the + * parameter can be in the query string or in the POST body. * * Generated from protobuf field repeated .google.cloud.compute.v1.SecurityPolicyRulePreconfiguredWafConfigExclusionFieldParams request_query_params_to_exclude = 340692744; */ private $request_query_params_to_exclude; /** - * A list of request URIs from the request line to be excluded from inspection during preconfigured WAF evaluation. When specifying this field, the query or fragment part should be excluded. + * A list of request URIs from the request line to be excluded from + * inspection during preconfigured WAF evaluation. When specifying this + * field, the query or fragment part should be excluded. * * Generated from protobuf field repeated .google.cloud.compute.v1.SecurityPolicyRulePreconfiguredWafConfigExclusionFieldParams request_uris_to_exclude = 90690846; */ private $request_uris_to_exclude; /** - * A list of target rule IDs under the WAF rule set to apply the preconfigured WAF exclusion. If omitted, it refers to all the rule IDs under the WAF rule set. + * A list of target rule IDs under the WAF rule set to apply the + * preconfigured WAF exclusion. If omitted, it refers to all the rule + * IDs under the WAF rule set. * * Generated from protobuf field repeated string target_rule_ids = 498430435; */ @@ -58,15 +66,23 @@ class SecurityPolicyRulePreconfiguredWafConfigExclusion extends \Google\Protobuf * Optional. Data for populating the Message object. * * @type array<\Google\Cloud\Compute\V1\SecurityPolicyRulePreconfiguredWafConfigExclusionFieldParams>|\Google\Protobuf\Internal\RepeatedField $request_cookies_to_exclude - * A list of request cookie names whose value will be excluded from inspection during preconfigured WAF evaluation. + * A list of request cookie names whose value will be excluded from + * inspection during preconfigured WAF evaluation. * @type array<\Google\Cloud\Compute\V1\SecurityPolicyRulePreconfiguredWafConfigExclusionFieldParams>|\Google\Protobuf\Internal\RepeatedField $request_headers_to_exclude - * A list of request header names whose value will be excluded from inspection during preconfigured WAF evaluation. + * A list of request header names whose value will be excluded from + * inspection during preconfigured WAF evaluation. * @type array<\Google\Cloud\Compute\V1\SecurityPolicyRulePreconfiguredWafConfigExclusionFieldParams>|\Google\Protobuf\Internal\RepeatedField $request_query_params_to_exclude - * A list of request query parameter names whose value will be excluded from inspection during preconfigured WAF evaluation. Note that the parameter can be in the query string or in the POST body. + * A list of request query parameter names whose value will be excluded + * from inspection during preconfigured WAF evaluation. Note that the + * parameter can be in the query string or in the POST body. * @type array<\Google\Cloud\Compute\V1\SecurityPolicyRulePreconfiguredWafConfigExclusionFieldParams>|\Google\Protobuf\Internal\RepeatedField $request_uris_to_exclude - * A list of request URIs from the request line to be excluded from inspection during preconfigured WAF evaluation. When specifying this field, the query or fragment part should be excluded. + * A list of request URIs from the request line to be excluded from + * inspection during preconfigured WAF evaluation. When specifying this + * field, the query or fragment part should be excluded. * @type array|\Google\Protobuf\Internal\RepeatedField $target_rule_ids - * A list of target rule IDs under the WAF rule set to apply the preconfigured WAF exclusion. If omitted, it refers to all the rule IDs under the WAF rule set. + * A list of target rule IDs under the WAF rule set to apply the + * preconfigured WAF exclusion. If omitted, it refers to all the rule + * IDs under the WAF rule set. * @type string $target_rule_set * Target WAF rule set to apply the preconfigured WAF exclusion. * } @@ -77,7 +93,8 @@ public function __construct($data = NULL) { } /** - * A list of request cookie names whose value will be excluded from inspection during preconfigured WAF evaluation. + * A list of request cookie names whose value will be excluded from + * inspection during preconfigured WAF evaluation. * * Generated from protobuf field repeated .google.cloud.compute.v1.SecurityPolicyRulePreconfiguredWafConfigExclusionFieldParams request_cookies_to_exclude = 156757878; * @return \Google\Protobuf\Internal\RepeatedField @@ -88,7 +105,8 @@ public function getRequestCookiesToExclude() } /** - * A list of request cookie names whose value will be excluded from inspection during preconfigured WAF evaluation. + * A list of request cookie names whose value will be excluded from + * inspection during preconfigured WAF evaluation. * * Generated from protobuf field repeated .google.cloud.compute.v1.SecurityPolicyRulePreconfiguredWafConfigExclusionFieldParams request_cookies_to_exclude = 156757878; * @param array<\Google\Cloud\Compute\V1\SecurityPolicyRulePreconfiguredWafConfigExclusionFieldParams>|\Google\Protobuf\Internal\RepeatedField $var @@ -103,7 +121,8 @@ public function setRequestCookiesToExclude($var) } /** - * A list of request header names whose value will be excluded from inspection during preconfigured WAF evaluation. + * A list of request header names whose value will be excluded from + * inspection during preconfigured WAF evaluation. * * Generated from protobuf field repeated .google.cloud.compute.v1.SecurityPolicyRulePreconfiguredWafConfigExclusionFieldParams request_headers_to_exclude = 63230495; * @return \Google\Protobuf\Internal\RepeatedField @@ -114,7 +133,8 @@ public function getRequestHeadersToExclude() } /** - * A list of request header names whose value will be excluded from inspection during preconfigured WAF evaluation. + * A list of request header names whose value will be excluded from + * inspection during preconfigured WAF evaluation. * * Generated from protobuf field repeated .google.cloud.compute.v1.SecurityPolicyRulePreconfiguredWafConfigExclusionFieldParams request_headers_to_exclude = 63230495; * @param array<\Google\Cloud\Compute\V1\SecurityPolicyRulePreconfiguredWafConfigExclusionFieldParams>|\Google\Protobuf\Internal\RepeatedField $var @@ -129,7 +149,9 @@ public function setRequestHeadersToExclude($var) } /** - * A list of request query parameter names whose value will be excluded from inspection during preconfigured WAF evaluation. Note that the parameter can be in the query string or in the POST body. + * A list of request query parameter names whose value will be excluded + * from inspection during preconfigured WAF evaluation. Note that the + * parameter can be in the query string or in the POST body. * * Generated from protobuf field repeated .google.cloud.compute.v1.SecurityPolicyRulePreconfiguredWafConfigExclusionFieldParams request_query_params_to_exclude = 340692744; * @return \Google\Protobuf\Internal\RepeatedField @@ -140,7 +162,9 @@ public function getRequestQueryParamsToExclude() } /** - * A list of request query parameter names whose value will be excluded from inspection during preconfigured WAF evaluation. Note that the parameter can be in the query string or in the POST body. + * A list of request query parameter names whose value will be excluded + * from inspection during preconfigured WAF evaluation. Note that the + * parameter can be in the query string or in the POST body. * * Generated from protobuf field repeated .google.cloud.compute.v1.SecurityPolicyRulePreconfiguredWafConfigExclusionFieldParams request_query_params_to_exclude = 340692744; * @param array<\Google\Cloud\Compute\V1\SecurityPolicyRulePreconfiguredWafConfigExclusionFieldParams>|\Google\Protobuf\Internal\RepeatedField $var @@ -155,7 +179,9 @@ public function setRequestQueryParamsToExclude($var) } /** - * A list of request URIs from the request line to be excluded from inspection during preconfigured WAF evaluation. When specifying this field, the query or fragment part should be excluded. + * A list of request URIs from the request line to be excluded from + * inspection during preconfigured WAF evaluation. When specifying this + * field, the query or fragment part should be excluded. * * Generated from protobuf field repeated .google.cloud.compute.v1.SecurityPolicyRulePreconfiguredWafConfigExclusionFieldParams request_uris_to_exclude = 90690846; * @return \Google\Protobuf\Internal\RepeatedField @@ -166,7 +192,9 @@ public function getRequestUrisToExclude() } /** - * A list of request URIs from the request line to be excluded from inspection during preconfigured WAF evaluation. When specifying this field, the query or fragment part should be excluded. + * A list of request URIs from the request line to be excluded from + * inspection during preconfigured WAF evaluation. When specifying this + * field, the query or fragment part should be excluded. * * Generated from protobuf field repeated .google.cloud.compute.v1.SecurityPolicyRulePreconfiguredWafConfigExclusionFieldParams request_uris_to_exclude = 90690846; * @param array<\Google\Cloud\Compute\V1\SecurityPolicyRulePreconfiguredWafConfigExclusionFieldParams>|\Google\Protobuf\Internal\RepeatedField $var @@ -181,7 +209,9 @@ public function setRequestUrisToExclude($var) } /** - * A list of target rule IDs under the WAF rule set to apply the preconfigured WAF exclusion. If omitted, it refers to all the rule IDs under the WAF rule set. + * A list of target rule IDs under the WAF rule set to apply the + * preconfigured WAF exclusion. If omitted, it refers to all the rule + * IDs under the WAF rule set. * * Generated from protobuf field repeated string target_rule_ids = 498430435; * @return \Google\Protobuf\Internal\RepeatedField @@ -192,7 +222,9 @@ public function getTargetRuleIds() } /** - * A list of target rule IDs under the WAF rule set to apply the preconfigured WAF exclusion. If omitted, it refers to all the rule IDs under the WAF rule set. + * A list of target rule IDs under the WAF rule set to apply the + * preconfigured WAF exclusion. If omitted, it refers to all the rule + * IDs under the WAF rule set. * * Generated from protobuf field repeated string target_rule_ids = 498430435; * @param array|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/SecurityPolicyRulePreconfiguredWafConfigExclusionFieldParams/Op.php b/Compute/src/V1/SecurityPolicyRulePreconfiguredWafConfigExclusionFieldParams/Op.php index 0d69d6fb9fe5..cceda4d0c5d1 100644 --- a/Compute/src/V1/SecurityPolicyRulePreconfiguredWafConfigExclusionFieldParams/Op.php +++ b/Compute/src/V1/SecurityPolicyRulePreconfiguredWafConfigExclusionFieldParams/Op.php @@ -20,19 +20,22 @@ class Op */ const UNDEFINED_OP = 0; /** - * The operator matches if the field value contains the specified value. + * The operator matches if the field value contains the specified + * value. * * Generated from protobuf enum CONTAINS = 215180831; */ const CONTAINS = 215180831; /** - * The operator matches if the field value ends with the specified value. + * The operator matches if the field value ends with the specified + * value. * * Generated from protobuf enum ENDS_WITH = 490402221; */ const ENDS_WITH = 490402221; /** - * The operator matches if the field value equals the specified value. + * The operator matches if the field value equals the specified + * value. * * Generated from protobuf enum EQUALS = 442201023; */ @@ -44,7 +47,8 @@ class Op */ const EQUALS_ANY = 337226060; /** - * The operator matches if the field value starts with the specified value. + * The operator matches if the field value starts with the specified + * value. * * Generated from protobuf enum STARTS_WITH = 139505652; */ diff --git a/Compute/src/V1/SecurityPolicyRuleRateLimitOptions.php b/Compute/src/V1/SecurityPolicyRuleRateLimitOptions.php index e584fcf89ce2..5ee6384cac89 100644 --- a/Compute/src/V1/SecurityPolicyRuleRateLimitOptions.php +++ b/Compute/src/V1/SecurityPolicyRuleRateLimitOptions.php @@ -15,50 +15,115 @@ class SecurityPolicyRuleRateLimitOptions extends \Google\Protobuf\Internal\Message { /** - * Can only be specified if the action for the rule is "rate_based_ban". If specified, determines the time (in seconds) the traffic will continue to be banned by the rate limit after the rate falls below the threshold. + * Can only be specified if the action for the rule is + * "rate_based_ban". If specified, determines the time (in seconds) + * the traffic will continue to be banned by the rate limit after the + * rate falls below the threshold. * * Generated from protobuf field optional int32 ban_duration_sec = 42896726; */ protected $ban_duration_sec = null; /** - * Can only be specified if the action for the rule is "rate_based_ban". If specified, the key will be banned for the configured 'ban_duration_sec' when the number of requests that exceed the 'rate_limit_threshold' also exceed this 'ban_threshold'. + * Can only be specified if the action for the rule is + * "rate_based_ban". If specified, the key will be banned for the + * configured 'ban_duration_sec' when the number of requests that exceed + * the 'rate_limit_threshold' also exceed this 'ban_threshold'. * * Generated from protobuf field optional .google.cloud.compute.v1.SecurityPolicyRuleRateLimitOptionsThreshold ban_threshold = 501208123; */ protected $ban_threshold = null; /** - * Action to take for requests that are under the configured rate limit threshold. Valid option is "allow" only. + * Action to take for requests that are under the configured rate limit + * threshold. Valid option is "allow" only. * * Generated from protobuf field optional string conform_action = 517612367; */ protected $conform_action = null; /** - * Determines the key to enforce the rate_limit_threshold on. Possible values are: - ALL: A single rate limit threshold is applied to all the requests matching this rule. This is the default value if "enforceOnKey" is not configured. - IP: The source IP address of the request is the key. Each IP has this limit enforced separately. - HTTP_HEADER: The value of the HTTP header whose name is configured under "enforceOnKeyName". The key value is truncated to the first 128 bytes of the header value. If no such header is present in the request, the key type defaults to ALL. - XFF_IP: The first IP address (i.e. the originating client IP address) specified in the list of IPs under X-Forwarded-For HTTP header. If no such header is present or the value is not a valid IP, the key defaults to the source IP address of the request i.e. key type IP. - HTTP_COOKIE: The value of the HTTP cookie whose name is configured under "enforceOnKeyName". The key value is truncated to the first 128 bytes of the cookie value. If no such cookie is present in the request, the key type defaults to ALL. - HTTP_PATH: The URL path of the HTTP request. The key value is truncated to the first 128 bytes. - SNI: Server name indication in the TLS session of the HTTPS request. The key value is truncated to the first 128 bytes. The key type defaults to ALL on a HTTP session. - REGION_CODE: The country/region from which the request originates. - TLS_JA3_FINGERPRINT: JA3 TLS/SSL fingerprint if the client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the key type defaults to ALL. - USER_IP: The IP address of the originating client, which is resolved based on "userIpRequestHeaders" configured with the security policy. If there is no "userIpRequestHeaders" configuration or an IP address cannot be resolved from it, the key type defaults to IP. - TLS_JA4_FINGERPRINT: JA4 TLS/SSL fingerprint if the client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the key type defaults to ALL. For "fairshare" action, this value is limited to ALL i.e. a single rate limit threshold is enforced for all the requests matching the rule. + * Determines the key to enforce the rate_limit_threshold on. Possible + * values are: + * - ALL: A single rate limit threshold is applied to all + * the requests matching this rule. This is the default value if + * "enforceOnKey" is not configured. + * - IP: The source IP address of + * the request is the key. Each IP has this limit enforced + * separately. + * - HTTP_HEADER: The value of the HTTP + * header whose name is configured under "enforceOnKeyName". The key + * value is truncated to the first 128 bytes of the header value. If no + * such header is present in the request, the key type defaults toALL. + * - XFF_IP: The first IP address (i.e. the + * originating client IP address) specified in the list of IPs under + * X-Forwarded-For HTTP header. If no such header is present or the value + * is not a valid IP, the key defaults to the source IP address of + * the request i.e. key type IP. + * - HTTP_COOKIE: The value of the HTTP + * cookie whose name is configured under "enforceOnKeyName". The key + * value is truncated to the first 128 bytes of the cookie value. If no + * such cookie is present in the request, the key type defaults toALL. + * - HTTP_PATH: The URL path of the HTTP request. The key + * value is truncated to the first 128 bytes. + * - SNI: Server name indication in the TLS session of the + * HTTPS request. The key value is truncated to the first 128 bytes. The + * key type defaults to ALL on a HTTP session. + * - REGION_CODE: The country/region from which the request + * originates. + * - TLS_JA3_FINGERPRINT: JA3 TLS/SSL fingerprint if the + * client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the + * key type defaults to ALL. + * - USER_IP: The IP address of the originating client, + * which is resolved based on "userIpRequestHeaders" configured with the + * security policy. If there is no "userIpRequestHeaders" configuration or + * an IP address cannot be resolved from it, the key type defaults toIP. + * - TLS_JA4_FINGERPRINT: JA4 TLS/SSL fingerprint if the + * client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the + * key type defaults to ALL. + * For "fairshare" action, this value is limited to ALL i.e. a single rate + * limit threshold is enforced for all the requests matching the rule. * Check the EnforceOnKey enum for the list of possible values. * * Generated from protobuf field optional string enforce_on_key = 416648956; */ protected $enforce_on_key = null; /** - * If specified, any combination of values of enforce_on_key_type/enforce_on_key_name is treated as the key on which ratelimit threshold/action is enforced. You can specify up to 3 enforce_on_key_configs. If enforce_on_key_configs is specified, enforce_on_key must not be specified. + * If specified, any combination of values of + * enforce_on_key_type/enforce_on_key_name is treated as the key on which + * ratelimit threshold/action is enforced. You can specify up to 3 + * enforce_on_key_configs. If enforce_on_key_configs is specified, + * enforce_on_key must not be specified. * * Generated from protobuf field repeated .google.cloud.compute.v1.SecurityPolicyRuleRateLimitOptionsEnforceOnKeyConfig enforce_on_key_configs = 33906478; */ private $enforce_on_key_configs; /** - * Rate limit key name applicable only for the following key types: HTTP_HEADER -- Name of the HTTP header whose value is taken as the key value. HTTP_COOKIE -- Name of the HTTP cookie whose value is taken as the key value. + * Rate limit key name applicable only for the following key types: + * HTTP_HEADER -- Name of the HTTP header whose value is taken as the key + * value. + * HTTP_COOKIE -- Name of the HTTP cookie whose value is taken as the key + * value. * * Generated from protobuf field optional string enforce_on_key_name = 132555246; */ protected $enforce_on_key_name = null; /** - * Action to take for requests that are above the configured rate limit threshold, to either deny with a specified HTTP response code, or redirect to a different endpoint. Valid options are `deny(STATUS)`, where valid values for `STATUS` are 403, 404, 429, and 502, and `redirect`, where the redirect parameters come from `exceedRedirectOptions` below. The `redirect` action is only supported in Global Security Policies of type CLOUD_ARMOR. + * Action to take for requests that are above the configured rate limit + * threshold, to either deny with a specified HTTP response code, or + * redirect to a different endpoint. + * Valid options are `deny(STATUS)`, where valid values for + * `STATUS` are 403, 404, 429, and 502, and + * `redirect`, where the redirect parameters come from + * `exceedRedirectOptions` below. + * The `redirect` action is only supported in Global Security Policies of + * type CLOUD_ARMOR. * * Generated from protobuf field optional string exceed_action = 167159073; */ protected $exceed_action = null; /** - * Parameters defining the redirect action that is used as the exceed action. Cannot be specified if the exceed action is not redirect. This field is only supported in Global Security Policies of type CLOUD_ARMOR. + * Parameters defining the redirect action that is used as the exceed + * action. Cannot be specified if the exceed action is not redirect. + * This field is only supported in Global Security Policies of type + * CLOUD_ARMOR. * * Generated from protobuf field optional .google.cloud.compute.v1.SecurityPolicyRuleRedirectOptions exceed_redirect_options = 473646694; */ @@ -77,22 +142,87 @@ class SecurityPolicyRuleRateLimitOptions extends \Google\Protobuf\Internal\Messa * Optional. Data for populating the Message object. * * @type int $ban_duration_sec - * Can only be specified if the action for the rule is "rate_based_ban". If specified, determines the time (in seconds) the traffic will continue to be banned by the rate limit after the rate falls below the threshold. + * Can only be specified if the action for the rule is + * "rate_based_ban". If specified, determines the time (in seconds) + * the traffic will continue to be banned by the rate limit after the + * rate falls below the threshold. * @type \Google\Cloud\Compute\V1\SecurityPolicyRuleRateLimitOptionsThreshold $ban_threshold - * Can only be specified if the action for the rule is "rate_based_ban". If specified, the key will be banned for the configured 'ban_duration_sec' when the number of requests that exceed the 'rate_limit_threshold' also exceed this 'ban_threshold'. + * Can only be specified if the action for the rule is + * "rate_based_ban". If specified, the key will be banned for the + * configured 'ban_duration_sec' when the number of requests that exceed + * the 'rate_limit_threshold' also exceed this 'ban_threshold'. * @type string $conform_action - * Action to take for requests that are under the configured rate limit threshold. Valid option is "allow" only. + * Action to take for requests that are under the configured rate limit + * threshold. Valid option is "allow" only. * @type string $enforce_on_key - * Determines the key to enforce the rate_limit_threshold on. Possible values are: - ALL: A single rate limit threshold is applied to all the requests matching this rule. This is the default value if "enforceOnKey" is not configured. - IP: The source IP address of the request is the key. Each IP has this limit enforced separately. - HTTP_HEADER: The value of the HTTP header whose name is configured under "enforceOnKeyName". The key value is truncated to the first 128 bytes of the header value. If no such header is present in the request, the key type defaults to ALL. - XFF_IP: The first IP address (i.e. the originating client IP address) specified in the list of IPs under X-Forwarded-For HTTP header. If no such header is present or the value is not a valid IP, the key defaults to the source IP address of the request i.e. key type IP. - HTTP_COOKIE: The value of the HTTP cookie whose name is configured under "enforceOnKeyName". The key value is truncated to the first 128 bytes of the cookie value. If no such cookie is present in the request, the key type defaults to ALL. - HTTP_PATH: The URL path of the HTTP request. The key value is truncated to the first 128 bytes. - SNI: Server name indication in the TLS session of the HTTPS request. The key value is truncated to the first 128 bytes. The key type defaults to ALL on a HTTP session. - REGION_CODE: The country/region from which the request originates. - TLS_JA3_FINGERPRINT: JA3 TLS/SSL fingerprint if the client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the key type defaults to ALL. - USER_IP: The IP address of the originating client, which is resolved based on "userIpRequestHeaders" configured with the security policy. If there is no "userIpRequestHeaders" configuration or an IP address cannot be resolved from it, the key type defaults to IP. - TLS_JA4_FINGERPRINT: JA4 TLS/SSL fingerprint if the client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the key type defaults to ALL. For "fairshare" action, this value is limited to ALL i.e. a single rate limit threshold is enforced for all the requests matching the rule. + * Determines the key to enforce the rate_limit_threshold on. Possible + * values are: + * - ALL: A single rate limit threshold is applied to all + * the requests matching this rule. This is the default value if + * "enforceOnKey" is not configured. + * - IP: The source IP address of + * the request is the key. Each IP has this limit enforced + * separately. + * - HTTP_HEADER: The value of the HTTP + * header whose name is configured under "enforceOnKeyName". The key + * value is truncated to the first 128 bytes of the header value. If no + * such header is present in the request, the key type defaults toALL. + * - XFF_IP: The first IP address (i.e. the + * originating client IP address) specified in the list of IPs under + * X-Forwarded-For HTTP header. If no such header is present or the value + * is not a valid IP, the key defaults to the source IP address of + * the request i.e. key type IP. + * - HTTP_COOKIE: The value of the HTTP + * cookie whose name is configured under "enforceOnKeyName". The key + * value is truncated to the first 128 bytes of the cookie value. If no + * such cookie is present in the request, the key type defaults toALL. + * - HTTP_PATH: The URL path of the HTTP request. The key + * value is truncated to the first 128 bytes. + * - SNI: Server name indication in the TLS session of the + * HTTPS request. The key value is truncated to the first 128 bytes. The + * key type defaults to ALL on a HTTP session. + * - REGION_CODE: The country/region from which the request + * originates. + * - TLS_JA3_FINGERPRINT: JA3 TLS/SSL fingerprint if the + * client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the + * key type defaults to ALL. + * - USER_IP: The IP address of the originating client, + * which is resolved based on "userIpRequestHeaders" configured with the + * security policy. If there is no "userIpRequestHeaders" configuration or + * an IP address cannot be resolved from it, the key type defaults toIP. + * - TLS_JA4_FINGERPRINT: JA4 TLS/SSL fingerprint if the + * client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the + * key type defaults to ALL. + * For "fairshare" action, this value is limited to ALL i.e. a single rate + * limit threshold is enforced for all the requests matching the rule. * Check the EnforceOnKey enum for the list of possible values. * @type array<\Google\Cloud\Compute\V1\SecurityPolicyRuleRateLimitOptionsEnforceOnKeyConfig>|\Google\Protobuf\Internal\RepeatedField $enforce_on_key_configs - * If specified, any combination of values of enforce_on_key_type/enforce_on_key_name is treated as the key on which ratelimit threshold/action is enforced. You can specify up to 3 enforce_on_key_configs. If enforce_on_key_configs is specified, enforce_on_key must not be specified. + * If specified, any combination of values of + * enforce_on_key_type/enforce_on_key_name is treated as the key on which + * ratelimit threshold/action is enforced. You can specify up to 3 + * enforce_on_key_configs. If enforce_on_key_configs is specified, + * enforce_on_key must not be specified. * @type string $enforce_on_key_name - * Rate limit key name applicable only for the following key types: HTTP_HEADER -- Name of the HTTP header whose value is taken as the key value. HTTP_COOKIE -- Name of the HTTP cookie whose value is taken as the key value. + * Rate limit key name applicable only for the following key types: + * HTTP_HEADER -- Name of the HTTP header whose value is taken as the key + * value. + * HTTP_COOKIE -- Name of the HTTP cookie whose value is taken as the key + * value. * @type string $exceed_action - * Action to take for requests that are above the configured rate limit threshold, to either deny with a specified HTTP response code, or redirect to a different endpoint. Valid options are `deny(STATUS)`, where valid values for `STATUS` are 403, 404, 429, and 502, and `redirect`, where the redirect parameters come from `exceedRedirectOptions` below. The `redirect` action is only supported in Global Security Policies of type CLOUD_ARMOR. + * Action to take for requests that are above the configured rate limit + * threshold, to either deny with a specified HTTP response code, or + * redirect to a different endpoint. + * Valid options are `deny(STATUS)`, where valid values for + * `STATUS` are 403, 404, 429, and 502, and + * `redirect`, where the redirect parameters come from + * `exceedRedirectOptions` below. + * The `redirect` action is only supported in Global Security Policies of + * type CLOUD_ARMOR. * @type \Google\Cloud\Compute\V1\SecurityPolicyRuleRedirectOptions $exceed_redirect_options - * Parameters defining the redirect action that is used as the exceed action. Cannot be specified if the exceed action is not redirect. This field is only supported in Global Security Policies of type CLOUD_ARMOR. + * Parameters defining the redirect action that is used as the exceed + * action. Cannot be specified if the exceed action is not redirect. + * This field is only supported in Global Security Policies of type + * CLOUD_ARMOR. * @type \Google\Cloud\Compute\V1\SecurityPolicyRuleRateLimitOptionsThreshold $rate_limit_threshold * Threshold at which to begin ratelimiting. * } @@ -103,7 +233,10 @@ public function __construct($data = NULL) { } /** - * Can only be specified if the action for the rule is "rate_based_ban". If specified, determines the time (in seconds) the traffic will continue to be banned by the rate limit after the rate falls below the threshold. + * Can only be specified if the action for the rule is + * "rate_based_ban". If specified, determines the time (in seconds) + * the traffic will continue to be banned by the rate limit after the + * rate falls below the threshold. * * Generated from protobuf field optional int32 ban_duration_sec = 42896726; * @return int @@ -124,7 +257,10 @@ public function clearBanDurationSec() } /** - * Can only be specified if the action for the rule is "rate_based_ban". If specified, determines the time (in seconds) the traffic will continue to be banned by the rate limit after the rate falls below the threshold. + * Can only be specified if the action for the rule is + * "rate_based_ban". If specified, determines the time (in seconds) + * the traffic will continue to be banned by the rate limit after the + * rate falls below the threshold. * * Generated from protobuf field optional int32 ban_duration_sec = 42896726; * @param int $var @@ -139,7 +275,10 @@ public function setBanDurationSec($var) } /** - * Can only be specified if the action for the rule is "rate_based_ban". If specified, the key will be banned for the configured 'ban_duration_sec' when the number of requests that exceed the 'rate_limit_threshold' also exceed this 'ban_threshold'. + * Can only be specified if the action for the rule is + * "rate_based_ban". If specified, the key will be banned for the + * configured 'ban_duration_sec' when the number of requests that exceed + * the 'rate_limit_threshold' also exceed this 'ban_threshold'. * * Generated from protobuf field optional .google.cloud.compute.v1.SecurityPolicyRuleRateLimitOptionsThreshold ban_threshold = 501208123; * @return \Google\Cloud\Compute\V1\SecurityPolicyRuleRateLimitOptionsThreshold|null @@ -160,7 +299,10 @@ public function clearBanThreshold() } /** - * Can only be specified if the action for the rule is "rate_based_ban". If specified, the key will be banned for the configured 'ban_duration_sec' when the number of requests that exceed the 'rate_limit_threshold' also exceed this 'ban_threshold'. + * Can only be specified if the action for the rule is + * "rate_based_ban". If specified, the key will be banned for the + * configured 'ban_duration_sec' when the number of requests that exceed + * the 'rate_limit_threshold' also exceed this 'ban_threshold'. * * Generated from protobuf field optional .google.cloud.compute.v1.SecurityPolicyRuleRateLimitOptionsThreshold ban_threshold = 501208123; * @param \Google\Cloud\Compute\V1\SecurityPolicyRuleRateLimitOptionsThreshold $var @@ -175,7 +317,8 @@ public function setBanThreshold($var) } /** - * Action to take for requests that are under the configured rate limit threshold. Valid option is "allow" only. + * Action to take for requests that are under the configured rate limit + * threshold. Valid option is "allow" only. * * Generated from protobuf field optional string conform_action = 517612367; * @return string @@ -196,7 +339,8 @@ public function clearConformAction() } /** - * Action to take for requests that are under the configured rate limit threshold. Valid option is "allow" only. + * Action to take for requests that are under the configured rate limit + * threshold. Valid option is "allow" only. * * Generated from protobuf field optional string conform_action = 517612367; * @param string $var @@ -211,7 +355,46 @@ public function setConformAction($var) } /** - * Determines the key to enforce the rate_limit_threshold on. Possible values are: - ALL: A single rate limit threshold is applied to all the requests matching this rule. This is the default value if "enforceOnKey" is not configured. - IP: The source IP address of the request is the key. Each IP has this limit enforced separately. - HTTP_HEADER: The value of the HTTP header whose name is configured under "enforceOnKeyName". The key value is truncated to the first 128 bytes of the header value. If no such header is present in the request, the key type defaults to ALL. - XFF_IP: The first IP address (i.e. the originating client IP address) specified in the list of IPs under X-Forwarded-For HTTP header. If no such header is present or the value is not a valid IP, the key defaults to the source IP address of the request i.e. key type IP. - HTTP_COOKIE: The value of the HTTP cookie whose name is configured under "enforceOnKeyName". The key value is truncated to the first 128 bytes of the cookie value. If no such cookie is present in the request, the key type defaults to ALL. - HTTP_PATH: The URL path of the HTTP request. The key value is truncated to the first 128 bytes. - SNI: Server name indication in the TLS session of the HTTPS request. The key value is truncated to the first 128 bytes. The key type defaults to ALL on a HTTP session. - REGION_CODE: The country/region from which the request originates. - TLS_JA3_FINGERPRINT: JA3 TLS/SSL fingerprint if the client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the key type defaults to ALL. - USER_IP: The IP address of the originating client, which is resolved based on "userIpRequestHeaders" configured with the security policy. If there is no "userIpRequestHeaders" configuration or an IP address cannot be resolved from it, the key type defaults to IP. - TLS_JA4_FINGERPRINT: JA4 TLS/SSL fingerprint if the client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the key type defaults to ALL. For "fairshare" action, this value is limited to ALL i.e. a single rate limit threshold is enforced for all the requests matching the rule. + * Determines the key to enforce the rate_limit_threshold on. Possible + * values are: + * - ALL: A single rate limit threshold is applied to all + * the requests matching this rule. This is the default value if + * "enforceOnKey" is not configured. + * - IP: The source IP address of + * the request is the key. Each IP has this limit enforced + * separately. + * - HTTP_HEADER: The value of the HTTP + * header whose name is configured under "enforceOnKeyName". The key + * value is truncated to the first 128 bytes of the header value. If no + * such header is present in the request, the key type defaults toALL. + * - XFF_IP: The first IP address (i.e. the + * originating client IP address) specified in the list of IPs under + * X-Forwarded-For HTTP header. If no such header is present or the value + * is not a valid IP, the key defaults to the source IP address of + * the request i.e. key type IP. + * - HTTP_COOKIE: The value of the HTTP + * cookie whose name is configured under "enforceOnKeyName". The key + * value is truncated to the first 128 bytes of the cookie value. If no + * such cookie is present in the request, the key type defaults toALL. + * - HTTP_PATH: The URL path of the HTTP request. The key + * value is truncated to the first 128 bytes. + * - SNI: Server name indication in the TLS session of the + * HTTPS request. The key value is truncated to the first 128 bytes. The + * key type defaults to ALL on a HTTP session. + * - REGION_CODE: The country/region from which the request + * originates. + * - TLS_JA3_FINGERPRINT: JA3 TLS/SSL fingerprint if the + * client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the + * key type defaults to ALL. + * - USER_IP: The IP address of the originating client, + * which is resolved based on "userIpRequestHeaders" configured with the + * security policy. If there is no "userIpRequestHeaders" configuration or + * an IP address cannot be resolved from it, the key type defaults toIP. + * - TLS_JA4_FINGERPRINT: JA4 TLS/SSL fingerprint if the + * client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the + * key type defaults to ALL. + * For "fairshare" action, this value is limited to ALL i.e. a single rate + * limit threshold is enforced for all the requests matching the rule. * Check the EnforceOnKey enum for the list of possible values. * * Generated from protobuf field optional string enforce_on_key = 416648956; @@ -233,7 +416,46 @@ public function clearEnforceOnKey() } /** - * Determines the key to enforce the rate_limit_threshold on. Possible values are: - ALL: A single rate limit threshold is applied to all the requests matching this rule. This is the default value if "enforceOnKey" is not configured. - IP: The source IP address of the request is the key. Each IP has this limit enforced separately. - HTTP_HEADER: The value of the HTTP header whose name is configured under "enforceOnKeyName". The key value is truncated to the first 128 bytes of the header value. If no such header is present in the request, the key type defaults to ALL. - XFF_IP: The first IP address (i.e. the originating client IP address) specified in the list of IPs under X-Forwarded-For HTTP header. If no such header is present or the value is not a valid IP, the key defaults to the source IP address of the request i.e. key type IP. - HTTP_COOKIE: The value of the HTTP cookie whose name is configured under "enforceOnKeyName". The key value is truncated to the first 128 bytes of the cookie value. If no such cookie is present in the request, the key type defaults to ALL. - HTTP_PATH: The URL path of the HTTP request. The key value is truncated to the first 128 bytes. - SNI: Server name indication in the TLS session of the HTTPS request. The key value is truncated to the first 128 bytes. The key type defaults to ALL on a HTTP session. - REGION_CODE: The country/region from which the request originates. - TLS_JA3_FINGERPRINT: JA3 TLS/SSL fingerprint if the client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the key type defaults to ALL. - USER_IP: The IP address of the originating client, which is resolved based on "userIpRequestHeaders" configured with the security policy. If there is no "userIpRequestHeaders" configuration or an IP address cannot be resolved from it, the key type defaults to IP. - TLS_JA4_FINGERPRINT: JA4 TLS/SSL fingerprint if the client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the key type defaults to ALL. For "fairshare" action, this value is limited to ALL i.e. a single rate limit threshold is enforced for all the requests matching the rule. + * Determines the key to enforce the rate_limit_threshold on. Possible + * values are: + * - ALL: A single rate limit threshold is applied to all + * the requests matching this rule. This is the default value if + * "enforceOnKey" is not configured. + * - IP: The source IP address of + * the request is the key. Each IP has this limit enforced + * separately. + * - HTTP_HEADER: The value of the HTTP + * header whose name is configured under "enforceOnKeyName". The key + * value is truncated to the first 128 bytes of the header value. If no + * such header is present in the request, the key type defaults toALL. + * - XFF_IP: The first IP address (i.e. the + * originating client IP address) specified in the list of IPs under + * X-Forwarded-For HTTP header. If no such header is present or the value + * is not a valid IP, the key defaults to the source IP address of + * the request i.e. key type IP. + * - HTTP_COOKIE: The value of the HTTP + * cookie whose name is configured under "enforceOnKeyName". The key + * value is truncated to the first 128 bytes of the cookie value. If no + * such cookie is present in the request, the key type defaults toALL. + * - HTTP_PATH: The URL path of the HTTP request. The key + * value is truncated to the first 128 bytes. + * - SNI: Server name indication in the TLS session of the + * HTTPS request. The key value is truncated to the first 128 bytes. The + * key type defaults to ALL on a HTTP session. + * - REGION_CODE: The country/region from which the request + * originates. + * - TLS_JA3_FINGERPRINT: JA3 TLS/SSL fingerprint if the + * client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the + * key type defaults to ALL. + * - USER_IP: The IP address of the originating client, + * which is resolved based on "userIpRequestHeaders" configured with the + * security policy. If there is no "userIpRequestHeaders" configuration or + * an IP address cannot be resolved from it, the key type defaults toIP. + * - TLS_JA4_FINGERPRINT: JA4 TLS/SSL fingerprint if the + * client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the + * key type defaults to ALL. + * For "fairshare" action, this value is limited to ALL i.e. a single rate + * limit threshold is enforced for all the requests matching the rule. * Check the EnforceOnKey enum for the list of possible values. * * Generated from protobuf field optional string enforce_on_key = 416648956; @@ -249,7 +471,11 @@ public function setEnforceOnKey($var) } /** - * If specified, any combination of values of enforce_on_key_type/enforce_on_key_name is treated as the key on which ratelimit threshold/action is enforced. You can specify up to 3 enforce_on_key_configs. If enforce_on_key_configs is specified, enforce_on_key must not be specified. + * If specified, any combination of values of + * enforce_on_key_type/enforce_on_key_name is treated as the key on which + * ratelimit threshold/action is enforced. You can specify up to 3 + * enforce_on_key_configs. If enforce_on_key_configs is specified, + * enforce_on_key must not be specified. * * Generated from protobuf field repeated .google.cloud.compute.v1.SecurityPolicyRuleRateLimitOptionsEnforceOnKeyConfig enforce_on_key_configs = 33906478; * @return \Google\Protobuf\Internal\RepeatedField @@ -260,7 +486,11 @@ public function getEnforceOnKeyConfigs() } /** - * If specified, any combination of values of enforce_on_key_type/enforce_on_key_name is treated as the key on which ratelimit threshold/action is enforced. You can specify up to 3 enforce_on_key_configs. If enforce_on_key_configs is specified, enforce_on_key must not be specified. + * If specified, any combination of values of + * enforce_on_key_type/enforce_on_key_name is treated as the key on which + * ratelimit threshold/action is enforced. You can specify up to 3 + * enforce_on_key_configs. If enforce_on_key_configs is specified, + * enforce_on_key must not be specified. * * Generated from protobuf field repeated .google.cloud.compute.v1.SecurityPolicyRuleRateLimitOptionsEnforceOnKeyConfig enforce_on_key_configs = 33906478; * @param array<\Google\Cloud\Compute\V1\SecurityPolicyRuleRateLimitOptionsEnforceOnKeyConfig>|\Google\Protobuf\Internal\RepeatedField $var @@ -275,7 +505,11 @@ public function setEnforceOnKeyConfigs($var) } /** - * Rate limit key name applicable only for the following key types: HTTP_HEADER -- Name of the HTTP header whose value is taken as the key value. HTTP_COOKIE -- Name of the HTTP cookie whose value is taken as the key value. + * Rate limit key name applicable only for the following key types: + * HTTP_HEADER -- Name of the HTTP header whose value is taken as the key + * value. + * HTTP_COOKIE -- Name of the HTTP cookie whose value is taken as the key + * value. * * Generated from protobuf field optional string enforce_on_key_name = 132555246; * @return string @@ -296,7 +530,11 @@ public function clearEnforceOnKeyName() } /** - * Rate limit key name applicable only for the following key types: HTTP_HEADER -- Name of the HTTP header whose value is taken as the key value. HTTP_COOKIE -- Name of the HTTP cookie whose value is taken as the key value. + * Rate limit key name applicable only for the following key types: + * HTTP_HEADER -- Name of the HTTP header whose value is taken as the key + * value. + * HTTP_COOKIE -- Name of the HTTP cookie whose value is taken as the key + * value. * * Generated from protobuf field optional string enforce_on_key_name = 132555246; * @param string $var @@ -311,7 +549,15 @@ public function setEnforceOnKeyName($var) } /** - * Action to take for requests that are above the configured rate limit threshold, to either deny with a specified HTTP response code, or redirect to a different endpoint. Valid options are `deny(STATUS)`, where valid values for `STATUS` are 403, 404, 429, and 502, and `redirect`, where the redirect parameters come from `exceedRedirectOptions` below. The `redirect` action is only supported in Global Security Policies of type CLOUD_ARMOR. + * Action to take for requests that are above the configured rate limit + * threshold, to either deny with a specified HTTP response code, or + * redirect to a different endpoint. + * Valid options are `deny(STATUS)`, where valid values for + * `STATUS` are 403, 404, 429, and 502, and + * `redirect`, where the redirect parameters come from + * `exceedRedirectOptions` below. + * The `redirect` action is only supported in Global Security Policies of + * type CLOUD_ARMOR. * * Generated from protobuf field optional string exceed_action = 167159073; * @return string @@ -332,7 +578,15 @@ public function clearExceedAction() } /** - * Action to take for requests that are above the configured rate limit threshold, to either deny with a specified HTTP response code, or redirect to a different endpoint. Valid options are `deny(STATUS)`, where valid values for `STATUS` are 403, 404, 429, and 502, and `redirect`, where the redirect parameters come from `exceedRedirectOptions` below. The `redirect` action is only supported in Global Security Policies of type CLOUD_ARMOR. + * Action to take for requests that are above the configured rate limit + * threshold, to either deny with a specified HTTP response code, or + * redirect to a different endpoint. + * Valid options are `deny(STATUS)`, where valid values for + * `STATUS` are 403, 404, 429, and 502, and + * `redirect`, where the redirect parameters come from + * `exceedRedirectOptions` below. + * The `redirect` action is only supported in Global Security Policies of + * type CLOUD_ARMOR. * * Generated from protobuf field optional string exceed_action = 167159073; * @param string $var @@ -347,7 +601,10 @@ public function setExceedAction($var) } /** - * Parameters defining the redirect action that is used as the exceed action. Cannot be specified if the exceed action is not redirect. This field is only supported in Global Security Policies of type CLOUD_ARMOR. + * Parameters defining the redirect action that is used as the exceed + * action. Cannot be specified if the exceed action is not redirect. + * This field is only supported in Global Security Policies of type + * CLOUD_ARMOR. * * Generated from protobuf field optional .google.cloud.compute.v1.SecurityPolicyRuleRedirectOptions exceed_redirect_options = 473646694; * @return \Google\Cloud\Compute\V1\SecurityPolicyRuleRedirectOptions|null @@ -368,7 +625,10 @@ public function clearExceedRedirectOptions() } /** - * Parameters defining the redirect action that is used as the exceed action. Cannot be specified if the exceed action is not redirect. This field is only supported in Global Security Policies of type CLOUD_ARMOR. + * Parameters defining the redirect action that is used as the exceed + * action. Cannot be specified if the exceed action is not redirect. + * This field is only supported in Global Security Policies of type + * CLOUD_ARMOR. * * Generated from protobuf field optional .google.cloud.compute.v1.SecurityPolicyRuleRedirectOptions exceed_redirect_options = 473646694; * @param \Google\Cloud\Compute\V1\SecurityPolicyRuleRedirectOptions $var diff --git a/Compute/src/V1/SecurityPolicyRuleRateLimitOptions/EnforceOnKey.php b/Compute/src/V1/SecurityPolicyRuleRateLimitOptions/EnforceOnKey.php index a1e04ef82d7c..cf830d6ded0b 100644 --- a/Compute/src/V1/SecurityPolicyRuleRateLimitOptions/EnforceOnKey.php +++ b/Compute/src/V1/SecurityPolicyRuleRateLimitOptions/EnforceOnKey.php @@ -7,7 +7,46 @@ use UnexpectedValueException; /** - * Determines the key to enforce the rate_limit_threshold on. Possible values are: - ALL: A single rate limit threshold is applied to all the requests matching this rule. This is the default value if "enforceOnKey" is not configured. - IP: The source IP address of the request is the key. Each IP has this limit enforced separately. - HTTP_HEADER: The value of the HTTP header whose name is configured under "enforceOnKeyName". The key value is truncated to the first 128 bytes of the header value. If no such header is present in the request, the key type defaults to ALL. - XFF_IP: The first IP address (i.e. the originating client IP address) specified in the list of IPs under X-Forwarded-For HTTP header. If no such header is present or the value is not a valid IP, the key defaults to the source IP address of the request i.e. key type IP. - HTTP_COOKIE: The value of the HTTP cookie whose name is configured under "enforceOnKeyName". The key value is truncated to the first 128 bytes of the cookie value. If no such cookie is present in the request, the key type defaults to ALL. - HTTP_PATH: The URL path of the HTTP request. The key value is truncated to the first 128 bytes. - SNI: Server name indication in the TLS session of the HTTPS request. The key value is truncated to the first 128 bytes. The key type defaults to ALL on a HTTP session. - REGION_CODE: The country/region from which the request originates. - TLS_JA3_FINGERPRINT: JA3 TLS/SSL fingerprint if the client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the key type defaults to ALL. - USER_IP: The IP address of the originating client, which is resolved based on "userIpRequestHeaders" configured with the security policy. If there is no "userIpRequestHeaders" configuration or an IP address cannot be resolved from it, the key type defaults to IP. - TLS_JA4_FINGERPRINT: JA4 TLS/SSL fingerprint if the client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the key type defaults to ALL. For "fairshare" action, this value is limited to ALL i.e. a single rate limit threshold is enforced for all the requests matching the rule. + * Determines the key to enforce the rate_limit_threshold on. Possible + * values are: + * - ALL: A single rate limit threshold is applied to all + * the requests matching this rule. This is the default value if + * "enforceOnKey" is not configured. + * - IP: The source IP address of + * the request is the key. Each IP has this limit enforced + * separately. + * - HTTP_HEADER: The value of the HTTP + * header whose name is configured under "enforceOnKeyName". The key + * value is truncated to the first 128 bytes of the header value. If no + * such header is present in the request, the key type defaults toALL. + * - XFF_IP: The first IP address (i.e. the + * originating client IP address) specified in the list of IPs under + * X-Forwarded-For HTTP header. If no such header is present or the value + * is not a valid IP, the key defaults to the source IP address of + * the request i.e. key type IP. + * - HTTP_COOKIE: The value of the HTTP + * cookie whose name is configured under "enforceOnKeyName". The key + * value is truncated to the first 128 bytes of the cookie value. If no + * such cookie is present in the request, the key type defaults toALL. + * - HTTP_PATH: The URL path of the HTTP request. The key + * value is truncated to the first 128 bytes. + * - SNI: Server name indication in the TLS session of the + * HTTPS request. The key value is truncated to the first 128 bytes. The + * key type defaults to ALL on a HTTP session. + * - REGION_CODE: The country/region from which the request + * originates. + * - TLS_JA3_FINGERPRINT: JA3 TLS/SSL fingerprint if the + * client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the + * key type defaults to ALL. + * - USER_IP: The IP address of the originating client, + * which is resolved based on "userIpRequestHeaders" configured with the + * security policy. If there is no "userIpRequestHeaders" configuration or + * an IP address cannot be resolved from it, the key type defaults toIP. + * - TLS_JA4_FINGERPRINT: JA4 TLS/SSL fingerprint if the + * client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the + * key type defaults to ALL. + * For "fairshare" action, this value is limited to ALL i.e. a single rate + * limit threshold is enforced for all the requests matching the rule. * * Protobuf type google.cloud.compute.v1.SecurityPolicyRuleRateLimitOptions.EnforceOnKey */ diff --git a/Compute/src/V1/SecurityPolicyRuleRateLimitOptionsEnforceOnKeyConfig.php b/Compute/src/V1/SecurityPolicyRuleRateLimitOptionsEnforceOnKeyConfig.php index 72ddeebad557..5fa1eec5f758 100644 --- a/Compute/src/V1/SecurityPolicyRuleRateLimitOptionsEnforceOnKeyConfig.php +++ b/Compute/src/V1/SecurityPolicyRuleRateLimitOptionsEnforceOnKeyConfig.php @@ -15,13 +15,53 @@ class SecurityPolicyRuleRateLimitOptionsEnforceOnKeyConfig extends \Google\Protobuf\Internal\Message { /** - * Rate limit key name applicable only for the following key types: HTTP_HEADER -- Name of the HTTP header whose value is taken as the key value. HTTP_COOKIE -- Name of the HTTP cookie whose value is taken as the key value. + * Rate limit key name applicable only for the following key types: + * HTTP_HEADER -- Name of the HTTP header whose value is taken as the + * key value. HTTP_COOKIE -- Name of the HTTP cookie whose value is + * taken as the key value. * * Generated from protobuf field optional string enforce_on_key_name = 132555246; */ protected $enforce_on_key_name = null; /** - * Determines the key to enforce the rate_limit_threshold on. Possible values are: - ALL: A single rate limit threshold is applied to all the requests matching this rule. This is the default value if "enforceOnKeyConfigs" is not configured. - IP: The source IP address of the request is the key. Each IP has this limit enforced separately. - HTTP_HEADER: The value of the HTTP header whose name is configured under "enforceOnKeyName". The key value is truncated to the first 128 bytes of the header value. If no such header is present in the request, the key type defaults to ALL. - XFF_IP: The first IP address (i.e. the originating client IP address) specified in the list of IPs under X-Forwarded-For HTTP header. If no such header is present or the value is not a valid IP, the key defaults to the source IP address of the request i.e. key type IP. - HTTP_COOKIE: The value of the HTTP cookie whose name is configured under "enforceOnKeyName". The key value is truncated to the first 128 bytes of the cookie value. If no such cookie is present in the request, the key type defaults to ALL. - HTTP_PATH: The URL path of the HTTP request. The key value is truncated to the first 128 bytes. - SNI: Server name indication in the TLS session of the HTTPS request. The key value is truncated to the first 128 bytes. The key type defaults to ALL on a HTTP session. - REGION_CODE: The country/region from which the request originates. - TLS_JA3_FINGERPRINT: JA3 TLS/SSL fingerprint if the client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the key type defaults to ALL. - USER_IP: The IP address of the originating client, which is resolved based on "userIpRequestHeaders" configured with the security policy. If there is no "userIpRequestHeaders" configuration or an IP address cannot be resolved from it, the key type defaults to IP. - TLS_JA4_FINGERPRINT: JA4 TLS/SSL fingerprint if the client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the key type defaults to ALL. + * Determines the key to enforce the rate_limit_threshold on. Possible + * values are: + * - ALL: A single rate limit threshold is applied to all + * the requests matching this rule. This is the default value if + * "enforceOnKeyConfigs" is not configured. + * - IP: The source IP address of + * the request is the key. Each IP has this limit enforced + * separately. + * - HTTP_HEADER: The value of the HTTP + * header whose name is configured under "enforceOnKeyName". The key + * value is truncated to the first 128 bytes of the header value. If no + * such header is present in the request, the key type defaults toALL. + * - XFF_IP: The first IP address (i.e. the + * originating client IP address) specified in the list of IPs under + * X-Forwarded-For HTTP header. If no such header is present or the + * value is not a valid IP, the key defaults to the source IP address of + * the request i.e. key type IP. + * - HTTP_COOKIE: The value of the HTTP + * cookie whose name is configured under "enforceOnKeyName". The key + * value is truncated to the first 128 bytes of the cookie value. If no + * such cookie is present in the request, the key type defaults toALL. + * - HTTP_PATH: The URL path of the HTTP request. The key + * value is truncated to the first 128 bytes. + * - SNI: Server name indication in the TLS session of + * the HTTPS request. The key value is truncated to the first 128 bytes. + * The key type defaults to ALL on a HTTP session. + * - REGION_CODE: The country/region from which the + * request originates. + * - TLS_JA3_FINGERPRINT: JA3 TLS/SSL fingerprint if the + * client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the + * key type defaults to ALL. + * - USER_IP: The IP address of the originating client, + * which is resolved based on "userIpRequestHeaders" configured with the + * security policy. If there is no "userIpRequestHeaders" configuration + * or an IP address cannot be resolved from it, the key type defaults toIP. + * - TLS_JA4_FINGERPRINT: JA4 TLS/SSL fingerprint if the + * client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the + * key type defaults to ALL. * Check the EnforceOnKeyType enum for the list of possible values. * * Generated from protobuf field optional string enforce_on_key_type = 132757149; @@ -35,9 +75,49 @@ class SecurityPolicyRuleRateLimitOptionsEnforceOnKeyConfig extends \Google\Proto * Optional. Data for populating the Message object. * * @type string $enforce_on_key_name - * Rate limit key name applicable only for the following key types: HTTP_HEADER -- Name of the HTTP header whose value is taken as the key value. HTTP_COOKIE -- Name of the HTTP cookie whose value is taken as the key value. + * Rate limit key name applicable only for the following key types: + * HTTP_HEADER -- Name of the HTTP header whose value is taken as the + * key value. HTTP_COOKIE -- Name of the HTTP cookie whose value is + * taken as the key value. * @type string $enforce_on_key_type - * Determines the key to enforce the rate_limit_threshold on. Possible values are: - ALL: A single rate limit threshold is applied to all the requests matching this rule. This is the default value if "enforceOnKeyConfigs" is not configured. - IP: The source IP address of the request is the key. Each IP has this limit enforced separately. - HTTP_HEADER: The value of the HTTP header whose name is configured under "enforceOnKeyName". The key value is truncated to the first 128 bytes of the header value. If no such header is present in the request, the key type defaults to ALL. - XFF_IP: The first IP address (i.e. the originating client IP address) specified in the list of IPs under X-Forwarded-For HTTP header. If no such header is present or the value is not a valid IP, the key defaults to the source IP address of the request i.e. key type IP. - HTTP_COOKIE: The value of the HTTP cookie whose name is configured under "enforceOnKeyName". The key value is truncated to the first 128 bytes of the cookie value. If no such cookie is present in the request, the key type defaults to ALL. - HTTP_PATH: The URL path of the HTTP request. The key value is truncated to the first 128 bytes. - SNI: Server name indication in the TLS session of the HTTPS request. The key value is truncated to the first 128 bytes. The key type defaults to ALL on a HTTP session. - REGION_CODE: The country/region from which the request originates. - TLS_JA3_FINGERPRINT: JA3 TLS/SSL fingerprint if the client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the key type defaults to ALL. - USER_IP: The IP address of the originating client, which is resolved based on "userIpRequestHeaders" configured with the security policy. If there is no "userIpRequestHeaders" configuration or an IP address cannot be resolved from it, the key type defaults to IP. - TLS_JA4_FINGERPRINT: JA4 TLS/SSL fingerprint if the client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the key type defaults to ALL. + * Determines the key to enforce the rate_limit_threshold on. Possible + * values are: + * - ALL: A single rate limit threshold is applied to all + * the requests matching this rule. This is the default value if + * "enforceOnKeyConfigs" is not configured. + * - IP: The source IP address of + * the request is the key. Each IP has this limit enforced + * separately. + * - HTTP_HEADER: The value of the HTTP + * header whose name is configured under "enforceOnKeyName". The key + * value is truncated to the first 128 bytes of the header value. If no + * such header is present in the request, the key type defaults toALL. + * - XFF_IP: The first IP address (i.e. the + * originating client IP address) specified in the list of IPs under + * X-Forwarded-For HTTP header. If no such header is present or the + * value is not a valid IP, the key defaults to the source IP address of + * the request i.e. key type IP. + * - HTTP_COOKIE: The value of the HTTP + * cookie whose name is configured under "enforceOnKeyName". The key + * value is truncated to the first 128 bytes of the cookie value. If no + * such cookie is present in the request, the key type defaults toALL. + * - HTTP_PATH: The URL path of the HTTP request. The key + * value is truncated to the first 128 bytes. + * - SNI: Server name indication in the TLS session of + * the HTTPS request. The key value is truncated to the first 128 bytes. + * The key type defaults to ALL on a HTTP session. + * - REGION_CODE: The country/region from which the + * request originates. + * - TLS_JA3_FINGERPRINT: JA3 TLS/SSL fingerprint if the + * client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the + * key type defaults to ALL. + * - USER_IP: The IP address of the originating client, + * which is resolved based on "userIpRequestHeaders" configured with the + * security policy. If there is no "userIpRequestHeaders" configuration + * or an IP address cannot be resolved from it, the key type defaults toIP. + * - TLS_JA4_FINGERPRINT: JA4 TLS/SSL fingerprint if the + * client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the + * key type defaults to ALL. * Check the EnforceOnKeyType enum for the list of possible values. * } */ @@ -47,7 +127,10 @@ public function __construct($data = NULL) { } /** - * Rate limit key name applicable only for the following key types: HTTP_HEADER -- Name of the HTTP header whose value is taken as the key value. HTTP_COOKIE -- Name of the HTTP cookie whose value is taken as the key value. + * Rate limit key name applicable only for the following key types: + * HTTP_HEADER -- Name of the HTTP header whose value is taken as the + * key value. HTTP_COOKIE -- Name of the HTTP cookie whose value is + * taken as the key value. * * Generated from protobuf field optional string enforce_on_key_name = 132555246; * @return string @@ -68,7 +151,10 @@ public function clearEnforceOnKeyName() } /** - * Rate limit key name applicable only for the following key types: HTTP_HEADER -- Name of the HTTP header whose value is taken as the key value. HTTP_COOKIE -- Name of the HTTP cookie whose value is taken as the key value. + * Rate limit key name applicable only for the following key types: + * HTTP_HEADER -- Name of the HTTP header whose value is taken as the + * key value. HTTP_COOKIE -- Name of the HTTP cookie whose value is + * taken as the key value. * * Generated from protobuf field optional string enforce_on_key_name = 132555246; * @param string $var @@ -83,7 +169,44 @@ public function setEnforceOnKeyName($var) } /** - * Determines the key to enforce the rate_limit_threshold on. Possible values are: - ALL: A single rate limit threshold is applied to all the requests matching this rule. This is the default value if "enforceOnKeyConfigs" is not configured. - IP: The source IP address of the request is the key. Each IP has this limit enforced separately. - HTTP_HEADER: The value of the HTTP header whose name is configured under "enforceOnKeyName". The key value is truncated to the first 128 bytes of the header value. If no such header is present in the request, the key type defaults to ALL. - XFF_IP: The first IP address (i.e. the originating client IP address) specified in the list of IPs under X-Forwarded-For HTTP header. If no such header is present or the value is not a valid IP, the key defaults to the source IP address of the request i.e. key type IP. - HTTP_COOKIE: The value of the HTTP cookie whose name is configured under "enforceOnKeyName". The key value is truncated to the first 128 bytes of the cookie value. If no such cookie is present in the request, the key type defaults to ALL. - HTTP_PATH: The URL path of the HTTP request. The key value is truncated to the first 128 bytes. - SNI: Server name indication in the TLS session of the HTTPS request. The key value is truncated to the first 128 bytes. The key type defaults to ALL on a HTTP session. - REGION_CODE: The country/region from which the request originates. - TLS_JA3_FINGERPRINT: JA3 TLS/SSL fingerprint if the client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the key type defaults to ALL. - USER_IP: The IP address of the originating client, which is resolved based on "userIpRequestHeaders" configured with the security policy. If there is no "userIpRequestHeaders" configuration or an IP address cannot be resolved from it, the key type defaults to IP. - TLS_JA4_FINGERPRINT: JA4 TLS/SSL fingerprint if the client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the key type defaults to ALL. + * Determines the key to enforce the rate_limit_threshold on. Possible + * values are: + * - ALL: A single rate limit threshold is applied to all + * the requests matching this rule. This is the default value if + * "enforceOnKeyConfigs" is not configured. + * - IP: The source IP address of + * the request is the key. Each IP has this limit enforced + * separately. + * - HTTP_HEADER: The value of the HTTP + * header whose name is configured under "enforceOnKeyName". The key + * value is truncated to the first 128 bytes of the header value. If no + * such header is present in the request, the key type defaults toALL. + * - XFF_IP: The first IP address (i.e. the + * originating client IP address) specified in the list of IPs under + * X-Forwarded-For HTTP header. If no such header is present or the + * value is not a valid IP, the key defaults to the source IP address of + * the request i.e. key type IP. + * - HTTP_COOKIE: The value of the HTTP + * cookie whose name is configured under "enforceOnKeyName". The key + * value is truncated to the first 128 bytes of the cookie value. If no + * such cookie is present in the request, the key type defaults toALL. + * - HTTP_PATH: The URL path of the HTTP request. The key + * value is truncated to the first 128 bytes. + * - SNI: Server name indication in the TLS session of + * the HTTPS request. The key value is truncated to the first 128 bytes. + * The key type defaults to ALL on a HTTP session. + * - REGION_CODE: The country/region from which the + * request originates. + * - TLS_JA3_FINGERPRINT: JA3 TLS/SSL fingerprint if the + * client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the + * key type defaults to ALL. + * - USER_IP: The IP address of the originating client, + * which is resolved based on "userIpRequestHeaders" configured with the + * security policy. If there is no "userIpRequestHeaders" configuration + * or an IP address cannot be resolved from it, the key type defaults toIP. + * - TLS_JA4_FINGERPRINT: JA4 TLS/SSL fingerprint if the + * client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the + * key type defaults to ALL. * Check the EnforceOnKeyType enum for the list of possible values. * * Generated from protobuf field optional string enforce_on_key_type = 132757149; @@ -105,7 +228,44 @@ public function clearEnforceOnKeyType() } /** - * Determines the key to enforce the rate_limit_threshold on. Possible values are: - ALL: A single rate limit threshold is applied to all the requests matching this rule. This is the default value if "enforceOnKeyConfigs" is not configured. - IP: The source IP address of the request is the key. Each IP has this limit enforced separately. - HTTP_HEADER: The value of the HTTP header whose name is configured under "enforceOnKeyName". The key value is truncated to the first 128 bytes of the header value. If no such header is present in the request, the key type defaults to ALL. - XFF_IP: The first IP address (i.e. the originating client IP address) specified in the list of IPs under X-Forwarded-For HTTP header. If no such header is present or the value is not a valid IP, the key defaults to the source IP address of the request i.e. key type IP. - HTTP_COOKIE: The value of the HTTP cookie whose name is configured under "enforceOnKeyName". The key value is truncated to the first 128 bytes of the cookie value. If no such cookie is present in the request, the key type defaults to ALL. - HTTP_PATH: The URL path of the HTTP request. The key value is truncated to the first 128 bytes. - SNI: Server name indication in the TLS session of the HTTPS request. The key value is truncated to the first 128 bytes. The key type defaults to ALL on a HTTP session. - REGION_CODE: The country/region from which the request originates. - TLS_JA3_FINGERPRINT: JA3 TLS/SSL fingerprint if the client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the key type defaults to ALL. - USER_IP: The IP address of the originating client, which is resolved based on "userIpRequestHeaders" configured with the security policy. If there is no "userIpRequestHeaders" configuration or an IP address cannot be resolved from it, the key type defaults to IP. - TLS_JA4_FINGERPRINT: JA4 TLS/SSL fingerprint if the client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the key type defaults to ALL. + * Determines the key to enforce the rate_limit_threshold on. Possible + * values are: + * - ALL: A single rate limit threshold is applied to all + * the requests matching this rule. This is the default value if + * "enforceOnKeyConfigs" is not configured. + * - IP: The source IP address of + * the request is the key. Each IP has this limit enforced + * separately. + * - HTTP_HEADER: The value of the HTTP + * header whose name is configured under "enforceOnKeyName". The key + * value is truncated to the first 128 bytes of the header value. If no + * such header is present in the request, the key type defaults toALL. + * - XFF_IP: The first IP address (i.e. the + * originating client IP address) specified in the list of IPs under + * X-Forwarded-For HTTP header. If no such header is present or the + * value is not a valid IP, the key defaults to the source IP address of + * the request i.e. key type IP. + * - HTTP_COOKIE: The value of the HTTP + * cookie whose name is configured under "enforceOnKeyName". The key + * value is truncated to the first 128 bytes of the cookie value. If no + * such cookie is present in the request, the key type defaults toALL. + * - HTTP_PATH: The URL path of the HTTP request. The key + * value is truncated to the first 128 bytes. + * - SNI: Server name indication in the TLS session of + * the HTTPS request. The key value is truncated to the first 128 bytes. + * The key type defaults to ALL on a HTTP session. + * - REGION_CODE: The country/region from which the + * request originates. + * - TLS_JA3_FINGERPRINT: JA3 TLS/SSL fingerprint if the + * client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the + * key type defaults to ALL. + * - USER_IP: The IP address of the originating client, + * which is resolved based on "userIpRequestHeaders" configured with the + * security policy. If there is no "userIpRequestHeaders" configuration + * or an IP address cannot be resolved from it, the key type defaults toIP. + * - TLS_JA4_FINGERPRINT: JA4 TLS/SSL fingerprint if the + * client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the + * key type defaults to ALL. * Check the EnforceOnKeyType enum for the list of possible values. * * Generated from protobuf field optional string enforce_on_key_type = 132757149; diff --git a/Compute/src/V1/SecurityPolicyRuleRateLimitOptionsEnforceOnKeyConfig/EnforceOnKeyType.php b/Compute/src/V1/SecurityPolicyRuleRateLimitOptionsEnforceOnKeyConfig/EnforceOnKeyType.php index 77841adef6cc..8dc68ddf1b79 100644 --- a/Compute/src/V1/SecurityPolicyRuleRateLimitOptionsEnforceOnKeyConfig/EnforceOnKeyType.php +++ b/Compute/src/V1/SecurityPolicyRuleRateLimitOptionsEnforceOnKeyConfig/EnforceOnKeyType.php @@ -7,7 +7,44 @@ use UnexpectedValueException; /** - * Determines the key to enforce the rate_limit_threshold on. Possible values are: - ALL: A single rate limit threshold is applied to all the requests matching this rule. This is the default value if "enforceOnKeyConfigs" is not configured. - IP: The source IP address of the request is the key. Each IP has this limit enforced separately. - HTTP_HEADER: The value of the HTTP header whose name is configured under "enforceOnKeyName". The key value is truncated to the first 128 bytes of the header value. If no such header is present in the request, the key type defaults to ALL. - XFF_IP: The first IP address (i.e. the originating client IP address) specified in the list of IPs under X-Forwarded-For HTTP header. If no such header is present or the value is not a valid IP, the key defaults to the source IP address of the request i.e. key type IP. - HTTP_COOKIE: The value of the HTTP cookie whose name is configured under "enforceOnKeyName". The key value is truncated to the first 128 bytes of the cookie value. If no such cookie is present in the request, the key type defaults to ALL. - HTTP_PATH: The URL path of the HTTP request. The key value is truncated to the first 128 bytes. - SNI: Server name indication in the TLS session of the HTTPS request. The key value is truncated to the first 128 bytes. The key type defaults to ALL on a HTTP session. - REGION_CODE: The country/region from which the request originates. - TLS_JA3_FINGERPRINT: JA3 TLS/SSL fingerprint if the client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the key type defaults to ALL. - USER_IP: The IP address of the originating client, which is resolved based on "userIpRequestHeaders" configured with the security policy. If there is no "userIpRequestHeaders" configuration or an IP address cannot be resolved from it, the key type defaults to IP. - TLS_JA4_FINGERPRINT: JA4 TLS/SSL fingerprint if the client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the key type defaults to ALL. + * Determines the key to enforce the rate_limit_threshold on. Possible + * values are: + * - ALL: A single rate limit threshold is applied to all + * the requests matching this rule. This is the default value if + * "enforceOnKeyConfigs" is not configured. + * - IP: The source IP address of + * the request is the key. Each IP has this limit enforced + * separately. + * - HTTP_HEADER: The value of the HTTP + * header whose name is configured under "enforceOnKeyName". The key + * value is truncated to the first 128 bytes of the header value. If no + * such header is present in the request, the key type defaults toALL. + * - XFF_IP: The first IP address (i.e. the + * originating client IP address) specified in the list of IPs under + * X-Forwarded-For HTTP header. If no such header is present or the + * value is not a valid IP, the key defaults to the source IP address of + * the request i.e. key type IP. + * - HTTP_COOKIE: The value of the HTTP + * cookie whose name is configured under "enforceOnKeyName". The key + * value is truncated to the first 128 bytes of the cookie value. If no + * such cookie is present in the request, the key type defaults toALL. + * - HTTP_PATH: The URL path of the HTTP request. The key + * value is truncated to the first 128 bytes. + * - SNI: Server name indication in the TLS session of + * the HTTPS request. The key value is truncated to the first 128 bytes. + * The key type defaults to ALL on a HTTP session. + * - REGION_CODE: The country/region from which the + * request originates. + * - TLS_JA3_FINGERPRINT: JA3 TLS/SSL fingerprint if the + * client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the + * key type defaults to ALL. + * - USER_IP: The IP address of the originating client, + * which is resolved based on "userIpRequestHeaders" configured with the + * security policy. If there is no "userIpRequestHeaders" configuration + * or an IP address cannot be resolved from it, the key type defaults toIP. + * - TLS_JA4_FINGERPRINT: JA4 TLS/SSL fingerprint if the + * client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the + * key type defaults to ALL. * * Protobuf type google.cloud.compute.v1.SecurityPolicyRuleRateLimitOptionsEnforceOnKeyConfig.EnforceOnKeyType */ diff --git a/Compute/src/V1/SecurityPolicyRuleRedirectOptions.php b/Compute/src/V1/SecurityPolicyRuleRedirectOptions.php index 74796af6ad6f..9e4a38b4d674 100644 --- a/Compute/src/V1/SecurityPolicyRuleRedirectOptions.php +++ b/Compute/src/V1/SecurityPolicyRuleRedirectOptions.php @@ -15,13 +15,18 @@ class SecurityPolicyRuleRedirectOptions extends \Google\Protobuf\Internal\Message { /** - * Target for the redirect action. This is required if the type is EXTERNAL_302 and cannot be specified for GOOGLE_RECAPTCHA. + * Target for the redirect action. This is required if the type is + * EXTERNAL_302 and cannot be specified for GOOGLE_RECAPTCHA. * * Generated from protobuf field optional string target = 192835985; */ protected $target = null; /** - * Type of the redirect action. Possible values are: - GOOGLE_RECAPTCHA: redirect to reCAPTCHA for manual challenge assessment. - EXTERNAL_302: redirect to a different URL via a 302 response. + * Type of the redirect action. Possible values are: + * - GOOGLE_RECAPTCHA: redirect to reCAPTCHA for manual + * challenge assessment. + * - EXTERNAL_302: redirect to a different URL via a 302 + * response. * Check the Type enum for the list of possible values. * * Generated from protobuf field optional string type = 3575610; @@ -35,9 +40,14 @@ class SecurityPolicyRuleRedirectOptions extends \Google\Protobuf\Internal\Messag * Optional. Data for populating the Message object. * * @type string $target - * Target for the redirect action. This is required if the type is EXTERNAL_302 and cannot be specified for GOOGLE_RECAPTCHA. + * Target for the redirect action. This is required if the type is + * EXTERNAL_302 and cannot be specified for GOOGLE_RECAPTCHA. * @type string $type - * Type of the redirect action. Possible values are: - GOOGLE_RECAPTCHA: redirect to reCAPTCHA for manual challenge assessment. - EXTERNAL_302: redirect to a different URL via a 302 response. + * Type of the redirect action. Possible values are: + * - GOOGLE_RECAPTCHA: redirect to reCAPTCHA for manual + * challenge assessment. + * - EXTERNAL_302: redirect to a different URL via a 302 + * response. * Check the Type enum for the list of possible values. * } */ @@ -47,7 +57,8 @@ public function __construct($data = NULL) { } /** - * Target for the redirect action. This is required if the type is EXTERNAL_302 and cannot be specified for GOOGLE_RECAPTCHA. + * Target for the redirect action. This is required if the type is + * EXTERNAL_302 and cannot be specified for GOOGLE_RECAPTCHA. * * Generated from protobuf field optional string target = 192835985; * @return string @@ -68,7 +79,8 @@ public function clearTarget() } /** - * Target for the redirect action. This is required if the type is EXTERNAL_302 and cannot be specified for GOOGLE_RECAPTCHA. + * Target for the redirect action. This is required if the type is + * EXTERNAL_302 and cannot be specified for GOOGLE_RECAPTCHA. * * Generated from protobuf field optional string target = 192835985; * @param string $var @@ -83,7 +95,11 @@ public function setTarget($var) } /** - * Type of the redirect action. Possible values are: - GOOGLE_RECAPTCHA: redirect to reCAPTCHA for manual challenge assessment. - EXTERNAL_302: redirect to a different URL via a 302 response. + * Type of the redirect action. Possible values are: + * - GOOGLE_RECAPTCHA: redirect to reCAPTCHA for manual + * challenge assessment. + * - EXTERNAL_302: redirect to a different URL via a 302 + * response. * Check the Type enum for the list of possible values. * * Generated from protobuf field optional string type = 3575610; @@ -105,7 +121,11 @@ public function clearType() } /** - * Type of the redirect action. Possible values are: - GOOGLE_RECAPTCHA: redirect to reCAPTCHA for manual challenge assessment. - EXTERNAL_302: redirect to a different URL via a 302 response. + * Type of the redirect action. Possible values are: + * - GOOGLE_RECAPTCHA: redirect to reCAPTCHA for manual + * challenge assessment. + * - EXTERNAL_302: redirect to a different URL via a 302 + * response. * Check the Type enum for the list of possible values. * * Generated from protobuf field optional string type = 3575610; diff --git a/Compute/src/V1/SecurityPolicyRuleRedirectOptions/Type.php b/Compute/src/V1/SecurityPolicyRuleRedirectOptions/Type.php index 26263c69b6f6..b992811898d7 100644 --- a/Compute/src/V1/SecurityPolicyRuleRedirectOptions/Type.php +++ b/Compute/src/V1/SecurityPolicyRuleRedirectOptions/Type.php @@ -7,7 +7,11 @@ use UnexpectedValueException; /** - * Type of the redirect action. Possible values are: - GOOGLE_RECAPTCHA: redirect to reCAPTCHA for manual challenge assessment. - EXTERNAL_302: redirect to a different URL via a 302 response. + * Type of the redirect action. Possible values are: + * - GOOGLE_RECAPTCHA: redirect to reCAPTCHA for manual + * challenge assessment. + * - EXTERNAL_302: redirect to a different URL via a 302 + * response. * * Protobuf type google.cloud.compute.v1.SecurityPolicyRuleRedirectOptions.Type */ diff --git a/Compute/src/V1/SecurityPolicyUserDefinedField.php b/Compute/src/V1/SecurityPolicyUserDefinedField.php index bd6936b44472..0a70f53c63c2 100644 --- a/Compute/src/V1/SecurityPolicyUserDefinedField.php +++ b/Compute/src/V1/SecurityPolicyUserDefinedField.php @@ -15,14 +15,26 @@ class SecurityPolicyUserDefinedField extends \Google\Protobuf\Internal\Message { /** - * The base relative to which 'offset' is measured. Possible values are: - IPV4: Points to the beginning of the IPv4 header. - IPV6: Points to the beginning of the IPv6 header. - TCP: Points to the beginning of the TCP header, skipping over any IPv4 options or IPv6 extension headers. Not present for non-first fragments. - UDP: Points to the beginning of the UDP header, skipping over any IPv4 options or IPv6 extension headers. Not present for non-first fragments. required + * The base relative to which 'offset' is measured. Possible values are: + * - IPV4: Points to the beginning of the IPv4 header. + * - IPV6: Points to the beginning of the IPv6 header. + * - TCP: Points to the beginning of the TCP header, skipping + * over any IPv4 options or IPv6 extension headers. Not present for + * non-first fragments. + * - UDP: Points to the beginning of the UDP header, skipping + * over any IPv4 options or IPv6 extension headers. Not present for + * non-first fragments. + * required * Check the Base enum for the list of possible values. * * Generated from protobuf field optional string base = 3016401; */ protected $base = null; /** - * If specified, apply this mask (bitwise AND) to the field to ignore bits before matching. Encoded as a hexadecimal number (starting with "0x"). The last byte of the field (in network byte order) corresponds to the least significant byte of the mask. + * If specified, apply this mask (bitwise AND) to the field to ignore bits + * before matching. Encoded as a hexadecimal number (starting with "0x"). + * The last byte of the field (in network byte order) corresponds to the + * least significant byte of the mask. * * Generated from protobuf field optional string mask = 3344108; */ @@ -34,7 +46,8 @@ class SecurityPolicyUserDefinedField extends \Google\Protobuf\Internal\Message */ protected $name = null; /** - * Offset of the first byte of the field (in network byte order) relative to 'base'. + * Offset of the first byte of the field (in network byte order) relative to + * 'base'. * * Generated from protobuf field optional int32 offset = 53961875; */ @@ -53,14 +66,27 @@ class SecurityPolicyUserDefinedField extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $base - * The base relative to which 'offset' is measured. Possible values are: - IPV4: Points to the beginning of the IPv4 header. - IPV6: Points to the beginning of the IPv6 header. - TCP: Points to the beginning of the TCP header, skipping over any IPv4 options or IPv6 extension headers. Not present for non-first fragments. - UDP: Points to the beginning of the UDP header, skipping over any IPv4 options or IPv6 extension headers. Not present for non-first fragments. required + * The base relative to which 'offset' is measured. Possible values are: + * - IPV4: Points to the beginning of the IPv4 header. + * - IPV6: Points to the beginning of the IPv6 header. + * - TCP: Points to the beginning of the TCP header, skipping + * over any IPv4 options or IPv6 extension headers. Not present for + * non-first fragments. + * - UDP: Points to the beginning of the UDP header, skipping + * over any IPv4 options or IPv6 extension headers. Not present for + * non-first fragments. + * required * Check the Base enum for the list of possible values. * @type string $mask - * If specified, apply this mask (bitwise AND) to the field to ignore bits before matching. Encoded as a hexadecimal number (starting with "0x"). The last byte of the field (in network byte order) corresponds to the least significant byte of the mask. + * If specified, apply this mask (bitwise AND) to the field to ignore bits + * before matching. Encoded as a hexadecimal number (starting with "0x"). + * The last byte of the field (in network byte order) corresponds to the + * least significant byte of the mask. * @type string $name * The name of this field. Must be unique within the policy. * @type int $offset - * Offset of the first byte of the field (in network byte order) relative to 'base'. + * Offset of the first byte of the field (in network byte order) relative to + * 'base'. * @type int $size * Size of the field in bytes. Valid values: 1-4. * } @@ -71,7 +97,16 @@ public function __construct($data = NULL) { } /** - * The base relative to which 'offset' is measured. Possible values are: - IPV4: Points to the beginning of the IPv4 header. - IPV6: Points to the beginning of the IPv6 header. - TCP: Points to the beginning of the TCP header, skipping over any IPv4 options or IPv6 extension headers. Not present for non-first fragments. - UDP: Points to the beginning of the UDP header, skipping over any IPv4 options or IPv6 extension headers. Not present for non-first fragments. required + * The base relative to which 'offset' is measured. Possible values are: + * - IPV4: Points to the beginning of the IPv4 header. + * - IPV6: Points to the beginning of the IPv6 header. + * - TCP: Points to the beginning of the TCP header, skipping + * over any IPv4 options or IPv6 extension headers. Not present for + * non-first fragments. + * - UDP: Points to the beginning of the UDP header, skipping + * over any IPv4 options or IPv6 extension headers. Not present for + * non-first fragments. + * required * Check the Base enum for the list of possible values. * * Generated from protobuf field optional string base = 3016401; @@ -93,7 +128,16 @@ public function clearBase() } /** - * The base relative to which 'offset' is measured. Possible values are: - IPV4: Points to the beginning of the IPv4 header. - IPV6: Points to the beginning of the IPv6 header. - TCP: Points to the beginning of the TCP header, skipping over any IPv4 options or IPv6 extension headers. Not present for non-first fragments. - UDP: Points to the beginning of the UDP header, skipping over any IPv4 options or IPv6 extension headers. Not present for non-first fragments. required + * The base relative to which 'offset' is measured. Possible values are: + * - IPV4: Points to the beginning of the IPv4 header. + * - IPV6: Points to the beginning of the IPv6 header. + * - TCP: Points to the beginning of the TCP header, skipping + * over any IPv4 options or IPv6 extension headers. Not present for + * non-first fragments. + * - UDP: Points to the beginning of the UDP header, skipping + * over any IPv4 options or IPv6 extension headers. Not present for + * non-first fragments. + * required * Check the Base enum for the list of possible values. * * Generated from protobuf field optional string base = 3016401; @@ -109,7 +153,10 @@ public function setBase($var) } /** - * If specified, apply this mask (bitwise AND) to the field to ignore bits before matching. Encoded as a hexadecimal number (starting with "0x"). The last byte of the field (in network byte order) corresponds to the least significant byte of the mask. + * If specified, apply this mask (bitwise AND) to the field to ignore bits + * before matching. Encoded as a hexadecimal number (starting with "0x"). + * The last byte of the field (in network byte order) corresponds to the + * least significant byte of the mask. * * Generated from protobuf field optional string mask = 3344108; * @return string @@ -130,7 +177,10 @@ public function clearMask() } /** - * If specified, apply this mask (bitwise AND) to the field to ignore bits before matching. Encoded as a hexadecimal number (starting with "0x"). The last byte of the field (in network byte order) corresponds to the least significant byte of the mask. + * If specified, apply this mask (bitwise AND) to the field to ignore bits + * before matching. Encoded as a hexadecimal number (starting with "0x"). + * The last byte of the field (in network byte order) corresponds to the + * least significant byte of the mask. * * Generated from protobuf field optional string mask = 3344108; * @param string $var @@ -181,7 +231,8 @@ public function setName($var) } /** - * Offset of the first byte of the field (in network byte order) relative to 'base'. + * Offset of the first byte of the field (in network byte order) relative to + * 'base'. * * Generated from protobuf field optional int32 offset = 53961875; * @return int @@ -202,7 +253,8 @@ public function clearOffset() } /** - * Offset of the first byte of the field (in network byte order) relative to 'base'. + * Offset of the first byte of the field (in network byte order) relative to + * 'base'. * * Generated from protobuf field optional int32 offset = 53961875; * @param int $var diff --git a/Compute/src/V1/SecurityPolicyUserDefinedField/Base.php b/Compute/src/V1/SecurityPolicyUserDefinedField/Base.php index c62a28793f4b..fff9047d9c0d 100644 --- a/Compute/src/V1/SecurityPolicyUserDefinedField/Base.php +++ b/Compute/src/V1/SecurityPolicyUserDefinedField/Base.php @@ -7,7 +7,16 @@ use UnexpectedValueException; /** - * The base relative to which 'offset' is measured. Possible values are: - IPV4: Points to the beginning of the IPv4 header. - IPV6: Points to the beginning of the IPv6 header. - TCP: Points to the beginning of the TCP header, skipping over any IPv4 options or IPv6 extension headers. Not present for non-first fragments. - UDP: Points to the beginning of the UDP header, skipping over any IPv4 options or IPv6 extension headers. Not present for non-first fragments. required + * The base relative to which 'offset' is measured. Possible values are: + * - IPV4: Points to the beginning of the IPv4 header. + * - IPV6: Points to the beginning of the IPv6 header. + * - TCP: Points to the beginning of the TCP header, skipping + * over any IPv4 options or IPv6 extension headers. Not present for + * non-first fragments. + * - UDP: Points to the beginning of the UDP header, skipping + * over any IPv4 options or IPv6 extension headers. Not present for + * non-first fragments. + * required * * Protobuf type google.cloud.compute.v1.SecurityPolicyUserDefinedField.Base */ diff --git a/Compute/src/V1/SecuritySettings.php b/Compute/src/V1/SecuritySettings.php index 29cd7c3a1246..52d08620b92e 100644 --- a/Compute/src/V1/SecuritySettings.php +++ b/Compute/src/V1/SecuritySettings.php @@ -16,19 +16,37 @@ class SecuritySettings extends \Google\Protobuf\Internal\Message { /** - * The configuration needed to generate a signature for access to private storage buckets that support AWS's Signature Version 4 for authentication. Allowed only for INTERNET_IP_PORT and INTERNET_FQDN_PORT NEG backends. + * The configuration needed to generate a signature for access to private + * storage buckets that support AWS's Signature Version 4 for authentication. + * Allowed only for INTERNET_IP_PORT and INTERNET_FQDN_PORT NEG backends. * * Generated from protobuf field optional .google.cloud.compute.v1.AWSV4Signature aws_v4_authentication = 433993111; */ protected $aws_v4_authentication = null; /** - * Optional. A URL referring to a networksecurity.ClientTlsPolicy resource that describes how clients should authenticate with this service's backends. clientTlsPolicy only applies to a global BackendService with the loadBalancingScheme set to INTERNAL_SELF_MANAGED. If left blank, communications are not encrypted. + * Optional. A URL referring to a networksecurity.ClientTlsPolicy resource + * that describes how clients should authenticate with this service's + * backends. + * clientTlsPolicy only applies to a globalBackendService with the loadBalancingScheme set + * to INTERNAL_SELF_MANAGED. + * If left blank, communications are not encrypted. * * Generated from protobuf field optional string client_tls_policy = 462325226; */ protected $client_tls_policy = null; /** - * Optional. A list of Subject Alternative Names (SANs) that the client verifies during a mutual TLS handshake with an server/endpoint for this BackendService. When the server presents its X.509 certificate to the client, the client inspects the certificate's subjectAltName field. If the field contains one of the specified values, the communication continues. Otherwise, it fails. This additional check enables the client to verify that the server is authorized to run the requested service. Note that the contents of the server certificate's subjectAltName field are configured by the Public Key Infrastructure which provisions server identities. Only applies to a global BackendService with loadBalancingScheme set to INTERNAL_SELF_MANAGED. Only applies when BackendService has an attached clientTlsPolicy with clientCertificate (mTLS mode). + * Optional. A list of Subject Alternative Names (SANs) that the client + * verifies during a mutual TLS handshake with an server/endpoint for thisBackendService. When the server presents its X.509 certificate + * to the client, the client inspects the certificate'ssubjectAltName field. If the field contains one of the + * specified values, the communication continues. Otherwise, it fails. This + * additional check enables the client to verify that the server is authorized + * to run the requested service. + * Note that the contents of the server + * certificate's subjectAltName field are configured by the + * Public Key Infrastructure which provisions server identities. + * Only applies to a global BackendService withloadBalancingScheme set to INTERNAL_SELF_MANAGED. + * Only applies when BackendService has an attachedclientTlsPolicy with clientCertificate (mTLS + * mode). * * Generated from protobuf field repeated string subject_alt_names = 330029535; */ @@ -41,11 +59,29 @@ class SecuritySettings extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type \Google\Cloud\Compute\V1\AWSV4Signature $aws_v4_authentication - * The configuration needed to generate a signature for access to private storage buckets that support AWS's Signature Version 4 for authentication. Allowed only for INTERNET_IP_PORT and INTERNET_FQDN_PORT NEG backends. + * The configuration needed to generate a signature for access to private + * storage buckets that support AWS's Signature Version 4 for authentication. + * Allowed only for INTERNET_IP_PORT and INTERNET_FQDN_PORT NEG backends. * @type string $client_tls_policy - * Optional. A URL referring to a networksecurity.ClientTlsPolicy resource that describes how clients should authenticate with this service's backends. clientTlsPolicy only applies to a global BackendService with the loadBalancingScheme set to INTERNAL_SELF_MANAGED. If left blank, communications are not encrypted. + * Optional. A URL referring to a networksecurity.ClientTlsPolicy resource + * that describes how clients should authenticate with this service's + * backends. + * clientTlsPolicy only applies to a globalBackendService with the loadBalancingScheme set + * to INTERNAL_SELF_MANAGED. + * If left blank, communications are not encrypted. * @type array|\Google\Protobuf\Internal\RepeatedField $subject_alt_names - * Optional. A list of Subject Alternative Names (SANs) that the client verifies during a mutual TLS handshake with an server/endpoint for this BackendService. When the server presents its X.509 certificate to the client, the client inspects the certificate's subjectAltName field. If the field contains one of the specified values, the communication continues. Otherwise, it fails. This additional check enables the client to verify that the server is authorized to run the requested service. Note that the contents of the server certificate's subjectAltName field are configured by the Public Key Infrastructure which provisions server identities. Only applies to a global BackendService with loadBalancingScheme set to INTERNAL_SELF_MANAGED. Only applies when BackendService has an attached clientTlsPolicy with clientCertificate (mTLS mode). + * Optional. A list of Subject Alternative Names (SANs) that the client + * verifies during a mutual TLS handshake with an server/endpoint for thisBackendService. When the server presents its X.509 certificate + * to the client, the client inspects the certificate'ssubjectAltName field. If the field contains one of the + * specified values, the communication continues. Otherwise, it fails. This + * additional check enables the client to verify that the server is authorized + * to run the requested service. + * Note that the contents of the server + * certificate's subjectAltName field are configured by the + * Public Key Infrastructure which provisions server identities. + * Only applies to a global BackendService withloadBalancingScheme set to INTERNAL_SELF_MANAGED. + * Only applies when BackendService has an attachedclientTlsPolicy with clientCertificate (mTLS + * mode). * } */ public function __construct($data = NULL) { @@ -54,7 +90,9 @@ public function __construct($data = NULL) { } /** - * The configuration needed to generate a signature for access to private storage buckets that support AWS's Signature Version 4 for authentication. Allowed only for INTERNET_IP_PORT and INTERNET_FQDN_PORT NEG backends. + * The configuration needed to generate a signature for access to private + * storage buckets that support AWS's Signature Version 4 for authentication. + * Allowed only for INTERNET_IP_PORT and INTERNET_FQDN_PORT NEG backends. * * Generated from protobuf field optional .google.cloud.compute.v1.AWSV4Signature aws_v4_authentication = 433993111; * @return \Google\Cloud\Compute\V1\AWSV4Signature|null @@ -75,7 +113,9 @@ public function clearAwsV4Authentication() } /** - * The configuration needed to generate a signature for access to private storage buckets that support AWS's Signature Version 4 for authentication. Allowed only for INTERNET_IP_PORT and INTERNET_FQDN_PORT NEG backends. + * The configuration needed to generate a signature for access to private + * storage buckets that support AWS's Signature Version 4 for authentication. + * Allowed only for INTERNET_IP_PORT and INTERNET_FQDN_PORT NEG backends. * * Generated from protobuf field optional .google.cloud.compute.v1.AWSV4Signature aws_v4_authentication = 433993111; * @param \Google\Cloud\Compute\V1\AWSV4Signature $var @@ -90,7 +130,12 @@ public function setAwsV4Authentication($var) } /** - * Optional. A URL referring to a networksecurity.ClientTlsPolicy resource that describes how clients should authenticate with this service's backends. clientTlsPolicy only applies to a global BackendService with the loadBalancingScheme set to INTERNAL_SELF_MANAGED. If left blank, communications are not encrypted. + * Optional. A URL referring to a networksecurity.ClientTlsPolicy resource + * that describes how clients should authenticate with this service's + * backends. + * clientTlsPolicy only applies to a globalBackendService with the loadBalancingScheme set + * to INTERNAL_SELF_MANAGED. + * If left blank, communications are not encrypted. * * Generated from protobuf field optional string client_tls_policy = 462325226; * @return string @@ -111,7 +156,12 @@ public function clearClientTlsPolicy() } /** - * Optional. A URL referring to a networksecurity.ClientTlsPolicy resource that describes how clients should authenticate with this service's backends. clientTlsPolicy only applies to a global BackendService with the loadBalancingScheme set to INTERNAL_SELF_MANAGED. If left blank, communications are not encrypted. + * Optional. A URL referring to a networksecurity.ClientTlsPolicy resource + * that describes how clients should authenticate with this service's + * backends. + * clientTlsPolicy only applies to a globalBackendService with the loadBalancingScheme set + * to INTERNAL_SELF_MANAGED. + * If left blank, communications are not encrypted. * * Generated from protobuf field optional string client_tls_policy = 462325226; * @param string $var @@ -126,7 +176,18 @@ public function setClientTlsPolicy($var) } /** - * Optional. A list of Subject Alternative Names (SANs) that the client verifies during a mutual TLS handshake with an server/endpoint for this BackendService. When the server presents its X.509 certificate to the client, the client inspects the certificate's subjectAltName field. If the field contains one of the specified values, the communication continues. Otherwise, it fails. This additional check enables the client to verify that the server is authorized to run the requested service. Note that the contents of the server certificate's subjectAltName field are configured by the Public Key Infrastructure which provisions server identities. Only applies to a global BackendService with loadBalancingScheme set to INTERNAL_SELF_MANAGED. Only applies when BackendService has an attached clientTlsPolicy with clientCertificate (mTLS mode). + * Optional. A list of Subject Alternative Names (SANs) that the client + * verifies during a mutual TLS handshake with an server/endpoint for thisBackendService. When the server presents its X.509 certificate + * to the client, the client inspects the certificate'ssubjectAltName field. If the field contains one of the + * specified values, the communication continues. Otherwise, it fails. This + * additional check enables the client to verify that the server is authorized + * to run the requested service. + * Note that the contents of the server + * certificate's subjectAltName field are configured by the + * Public Key Infrastructure which provisions server identities. + * Only applies to a global BackendService withloadBalancingScheme set to INTERNAL_SELF_MANAGED. + * Only applies when BackendService has an attachedclientTlsPolicy with clientCertificate (mTLS + * mode). * * Generated from protobuf field repeated string subject_alt_names = 330029535; * @return \Google\Protobuf\Internal\RepeatedField @@ -137,7 +198,18 @@ public function getSubjectAltNames() } /** - * Optional. A list of Subject Alternative Names (SANs) that the client verifies during a mutual TLS handshake with an server/endpoint for this BackendService. When the server presents its X.509 certificate to the client, the client inspects the certificate's subjectAltName field. If the field contains one of the specified values, the communication continues. Otherwise, it fails. This additional check enables the client to verify that the server is authorized to run the requested service. Note that the contents of the server certificate's subjectAltName field are configured by the Public Key Infrastructure which provisions server identities. Only applies to a global BackendService with loadBalancingScheme set to INTERNAL_SELF_MANAGED. Only applies when BackendService has an attached clientTlsPolicy with clientCertificate (mTLS mode). + * Optional. A list of Subject Alternative Names (SANs) that the client + * verifies during a mutual TLS handshake with an server/endpoint for thisBackendService. When the server presents its X.509 certificate + * to the client, the client inspects the certificate'ssubjectAltName field. If the field contains one of the + * specified values, the communication continues. Otherwise, it fails. This + * additional check enables the client to verify that the server is authorized + * to run the requested service. + * Note that the contents of the server + * certificate's subjectAltName field are configured by the + * Public Key Infrastructure which provisions server identities. + * Only applies to a global BackendService withloadBalancingScheme set to INTERNAL_SELF_MANAGED. + * Only applies when BackendService has an attachedclientTlsPolicy with clientCertificate (mTLS + * mode). * * Generated from protobuf field repeated string subject_alt_names = 330029535; * @param array|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/SerialPortOutput.php b/Compute/src/V1/SerialPortOutput.php index 1a97f6aab3d5..2ef5944af1b8 100644 --- a/Compute/src/V1/SerialPortOutput.php +++ b/Compute/src/V1/SerialPortOutput.php @@ -22,13 +22,16 @@ class SerialPortOutput extends \Google\Protobuf\Internal\Message */ protected $contents = null; /** - * [Output Only] Type of the resource. Always compute#serialPortOutput for serial port output. + * [Output Only] Type of the resource. Alwayscompute#serialPortOutput for serial port output. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] The position of the next byte of content, regardless of whether the content exists, following the output returned in the `contents` property. Use this value in the next request as the start parameter. + * [Output Only] The position of the next byte of content, regardless of + * whether the content exists, following the output returned in the `contents` + * property. Use this value in the next request as the start + * parameter. * * Generated from protobuf field optional int64 next = 3377907; */ @@ -40,7 +43,12 @@ class SerialPortOutput extends \Google\Protobuf\Internal\Message */ protected $self_link = null; /** - * The starting byte position of the output that was returned. This should match the start parameter sent with the request. If the serial console output exceeds the size of the buffer (1 MB), older output is overwritten by newer content. The output start value will indicate the byte position of the output that was returned, which might be different than the `start` value that was specified in the request. + * The starting byte position of the output that was returned. + * This should match the start parameter sent with the request. + * If the serial console output exceeds the size of the buffer (1 MB), older + * output is overwritten by newer content. The output start value will + * indicate the byte position of the output that was returned, which might be + * different than the `start` value that was specified in the request. * * Generated from protobuf field optional int64 start = 109757538; */ @@ -55,13 +63,21 @@ class SerialPortOutput extends \Google\Protobuf\Internal\Message * @type string $contents * [Output Only] The contents of the console output. * @type string $kind - * [Output Only] Type of the resource. Always compute#serialPortOutput for serial port output. + * [Output Only] Type of the resource. Alwayscompute#serialPortOutput for serial port output. * @type int|string $next - * [Output Only] The position of the next byte of content, regardless of whether the content exists, following the output returned in the `contents` property. Use this value in the next request as the start parameter. + * [Output Only] The position of the next byte of content, regardless of + * whether the content exists, following the output returned in the `contents` + * property. Use this value in the next request as the start + * parameter. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type int|string $start - * The starting byte position of the output that was returned. This should match the start parameter sent with the request. If the serial console output exceeds the size of the buffer (1 MB), older output is overwritten by newer content. The output start value will indicate the byte position of the output that was returned, which might be different than the `start` value that was specified in the request. + * The starting byte position of the output that was returned. + * This should match the start parameter sent with the request. + * If the serial console output exceeds the size of the buffer (1 MB), older + * output is overwritten by newer content. The output start value will + * indicate the byte position of the output that was returned, which might be + * different than the `start` value that was specified in the request. * } */ public function __construct($data = NULL) { @@ -106,7 +122,7 @@ public function setContents($var) } /** - * [Output Only] Type of the resource. Always compute#serialPortOutput for serial port output. + * [Output Only] Type of the resource. Alwayscompute#serialPortOutput for serial port output. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -127,7 +143,7 @@ public function clearKind() } /** - * [Output Only] Type of the resource. Always compute#serialPortOutput for serial port output. + * [Output Only] Type of the resource. Alwayscompute#serialPortOutput for serial port output. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -142,7 +158,10 @@ public function setKind($var) } /** - * [Output Only] The position of the next byte of content, regardless of whether the content exists, following the output returned in the `contents` property. Use this value in the next request as the start parameter. + * [Output Only] The position of the next byte of content, regardless of + * whether the content exists, following the output returned in the `contents` + * property. Use this value in the next request as the start + * parameter. * * Generated from protobuf field optional int64 next = 3377907; * @return int|string @@ -163,7 +182,10 @@ public function clearNext() } /** - * [Output Only] The position of the next byte of content, regardless of whether the content exists, following the output returned in the `contents` property. Use this value in the next request as the start parameter. + * [Output Only] The position of the next byte of content, regardless of + * whether the content exists, following the output returned in the `contents` + * property. Use this value in the next request as the start + * parameter. * * Generated from protobuf field optional int64 next = 3377907; * @param int|string $var @@ -214,7 +236,12 @@ public function setSelfLink($var) } /** - * The starting byte position of the output that was returned. This should match the start parameter sent with the request. If the serial console output exceeds the size of the buffer (1 MB), older output is overwritten by newer content. The output start value will indicate the byte position of the output that was returned, which might be different than the `start` value that was specified in the request. + * The starting byte position of the output that was returned. + * This should match the start parameter sent with the request. + * If the serial console output exceeds the size of the buffer (1 MB), older + * output is overwritten by newer content. The output start value will + * indicate the byte position of the output that was returned, which might be + * different than the `start` value that was specified in the request. * * Generated from protobuf field optional int64 start = 109757538; * @return int|string @@ -235,7 +262,12 @@ public function clearStart() } /** - * The starting byte position of the output that was returned. This should match the start parameter sent with the request. If the serial console output exceeds the size of the buffer (1 MB), older output is overwritten by newer content. The output start value will indicate the byte position of the output that was returned, which might be different than the `start` value that was specified in the request. + * The starting byte position of the output that was returned. + * This should match the start parameter sent with the request. + * If the serial console output exceeds the size of the buffer (1 MB), older + * output is overwritten by newer content. The output start value will + * indicate the byte position of the output that was returned, which might be + * different than the `start` value that was specified in the request. * * Generated from protobuf field optional int64 start = 109757538; * @param int|string $var diff --git a/Compute/src/V1/ServiceAttachment.php b/Compute/src/V1/ServiceAttachment.php index 7caab9925f5b..706d53676fb8 100644 --- a/Compute/src/V1/ServiceAttachment.php +++ b/Compute/src/V1/ServiceAttachment.php @@ -9,75 +9,107 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Represents a ServiceAttachment resource. A service attachment represents a service that a producer has exposed. It encapsulates the load balancer which fronts the service runs and a list of NAT IP ranges that the producers uses to represent the consumers connecting to the service. + * Represents a ServiceAttachment resource. + * A service attachment represents a service that a producer has exposed. + * It encapsulates the load balancer which fronts the service runs and + * a list of NAT IP ranges that the producers uses to represent + * the consumers connecting to the service. * * Generated from protobuf message google.cloud.compute.v1.ServiceAttachment */ class ServiceAttachment extends \Google\Protobuf\Internal\Message { /** - * [Output Only] An array of connections for all the consumers connected to this service attachment. + * [Output Only] An array of connections for all the consumers connected to + * this service attachment. * * Generated from protobuf field repeated .google.cloud.compute.v1.ServiceAttachmentConnectedEndpoint connected_endpoints = 72223688; */ private $connected_endpoints; /** - * The connection preference of service attachment. The value can be set to ACCEPT_AUTOMATIC. An ACCEPT_AUTOMATIC service attachment is one that always accepts the connection from consumer forwarding rules. + * The connection preference of service attachment. The value can be set + * to ACCEPT_AUTOMATIC. An ACCEPT_AUTOMATIC + * service attachment is one that always accepts the connection from consumer + * forwarding rules. * Check the ConnectionPreference enum for the list of possible values. * * Generated from protobuf field optional string connection_preference = 285818076; */ protected $connection_preference = null; /** - * Specifies which consumer projects or networks are allowed to connect to the service attachment. Each project or network has a connection limit. A given service attachment can manage connections at either the project or network level. Therefore, both the accept and reject lists for a given service attachment must contain either only projects or only networks or only endpoints. + * Specifies which consumer projects or networks are allowed to connect to the + * service attachment. Each project or network has a connection limit. A given + * service attachment can manage connections at either the project or network + * level. Therefore, both the accept and reject lists for a given service + * attachment must contain either only projects or only networks or only + * endpoints. * * Generated from protobuf field repeated .google.cloud.compute.v1.ServiceAttachmentConsumerProjectLimit consumer_accept_lists = 402725703; */ private $consumer_accept_lists; /** - * Specifies a list of projects or networks that are not allowed to connect to this service attachment. The project can be specified using its project ID or project number and the network can be specified using its URL. A given service attachment can manage connections at either the project or network level. Therefore, both the reject and accept lists for a given service attachment must contain either only projects or only networks. + * Specifies a list of projects or networks that are not allowed to connect to + * this service attachment. The project can be specified using its project ID + * or project number and the network can be specified using its URL. A given + * service attachment can manage connections at either the project or network + * level. Therefore, both the reject and accept lists for a given service + * attachment must contain either only projects or only networks. * * Generated from protobuf field repeated string consumer_reject_lists = 204033182; */ private $consumer_reject_lists; /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; */ protected $creation_timestamp = null; /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; */ protected $description = null; /** - * If specified, the domain name will be used during the integration between the PSC connected endpoints and the Cloud DNS. For example, this is a valid domain name: "p.mycompany.com.". Current max number of domain names supported is 1. + * If specified, the domain name will be used during the integration between + * the PSC connected endpoints and the Cloud DNS. For example, this is a valid + * domain name: "p.mycompany.com.". Current max number of domain names + * supported is 1. * * Generated from protobuf field repeated string domain_names = 6450189; */ private $domain_names; /** - * If true, enable the proxy protocol which is for supplying client TCP/IP address data in TCP connections that traverse proxies on their way to destination servers. + * If true, enable the proxy protocol which is for supplying client TCP/IP + * address data in TCP connections that traverse proxies on their way to + * destination servers. * * Generated from protobuf field optional bool enable_proxy_protocol = 363791237; */ protected $enable_proxy_protocol = null; /** - * Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking. This field will be ignored when inserting a ServiceAttachment. An up-to-date fingerprint must be provided in order to patch/update the ServiceAttachment; otherwise, the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve the ServiceAttachment. + * Fingerprint of this resource. A hash of the contents stored in this object. + * This field is used in optimistic locking. This field will be ignored when + * inserting a ServiceAttachment. An up-to-date fingerprint must + * be provided in order to patch/update the ServiceAttachment; otherwise, the + * request will fail with error 412 conditionNotMet. To see the + * latest fingerprint, make a get() request to retrieve the + * ServiceAttachment. * * Generated from protobuf field optional string fingerprint = 234678500; */ protected $fingerprint = null; /** - * [Output Only] The unique identifier for the resource type. The server generates this identifier. + * [Output Only] The unique identifier for the resource type. The server + * generates this identifier. * * Generated from protobuf field optional uint64 id = 3355; */ protected $id = null; /** - * [Output Only] Type of the resource. Always compute#serviceAttachment for service attachments. + * [Output Only] Type of the resource. Alwayscompute#serviceAttachment for service attachments. * * Generated from protobuf field optional string kind = 3292052; */ @@ -89,25 +121,43 @@ class ServiceAttachment extends \Google\Protobuf\Internal\Message */ private $metadata; /** - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * * Generated from protobuf field optional string name = 3373707; */ protected $name = null; /** - * An array of URLs where each entry is the URL of a subnet provided by the service producer to use for NAT in this service attachment. + * An array of URLs where each entry is the URL of a subnet provided + * by the service producer to use for NAT in this service attachment. * * Generated from protobuf field repeated string nat_subnets = 374785944; */ private $nat_subnets; /** - * The URL of a forwarding rule with loadBalancingScheme INTERNAL* that is serving the endpoint identified by this service attachment. + * The URL of a forwarding rule with loadBalancingScheme INTERNAL* that is + * serving the endpoint identified by this service attachment. * * Generated from protobuf field optional string producer_forwarding_rule = 247927889; */ protected $producer_forwarding_rule = null; /** - * The number of consumer spokes that connected Private Service Connect endpoints can be propagated to through Network Connectivity Center. This limit lets the service producer limit how many propagated Private Service Connect connections can be established to this service attachment from a single consumer. If the connection preference of the service attachment is ACCEPT_MANUAL, the limit applies to each project or network that is listed in the consumer accept list. If the connection preference of the service attachment is ACCEPT_AUTOMATIC, the limit applies to each project that contains a connected endpoint. If unspecified, the default propagated connection limit is 250. + * The number of consumer spokes that connected Private Service Connect + * endpoints can be propagated to through Network Connectivity Center. This + * limit lets the service producer limit how many propagated Private Service + * Connect connections can be established to this service attachment from a + * single consumer. + * If the connection preference of the service attachment is ACCEPT_MANUAL, + * the limit applies to each project or network that is listed in the consumer + * accept list. If the connection preference of the service attachment is + * ACCEPT_AUTOMATIC, the limit applies to each project that contains a + * connected endpoint. + * If unspecified, the default propagated connection limit is 250. * * Generated from protobuf field optional uint32 propagated_connection_limit = 332719230; */ @@ -119,13 +169,25 @@ class ServiceAttachment extends \Google\Protobuf\Internal\Message */ protected $psc_service_attachment_id = null; /** - * This flag determines whether a consumer accept/reject list change can reconcile the statuses of existing ACCEPTED or REJECTED PSC endpoints. - If false, connection policy update will only affect existing PENDING PSC endpoints. Existing ACCEPTED/REJECTED endpoints will remain untouched regardless how the connection policy is modified . - If true, update will affect both PENDING and ACCEPTED/REJECTED PSC endpoints. For example, an ACCEPTED PSC endpoint will be moved to REJECTED if its project is added to the reject list. For newly created service attachment, this boolean defaults to false. + * This flag determines whether a consumer accept/reject list change can + * reconcile the statuses of existing ACCEPTED or REJECTED PSC endpoints. + * - If false, connection policy update will only affect existing PENDING + * PSC endpoints. Existing ACCEPTED/REJECTED endpoints will remain untouched + * regardless how the connection policy is modified . + * - If true, + * update will affect both PENDING and ACCEPTED/REJECTED PSC endpoints. For + * example, an ACCEPTED PSC endpoint will be moved to REJECTED if its project + * is added to the reject list. + * For newly created service attachment, this boolean defaults to false. * * Generated from protobuf field optional bool reconcile_connections = 125493732; */ protected $reconcile_connections = null; /** - * [Output Only] URL of the region where the service attachment resides. This field applies only to the region resource. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * [Output Only] URL of the region where the service attachment resides. + * This field applies only to the region resource. You must specify this + * field as part of the HTTP request URL. It is not settable as a field in + * the request body. * * Generated from protobuf field optional string region = 138946292; */ @@ -137,7 +199,8 @@ class ServiceAttachment extends \Google\Protobuf\Internal\Message */ protected $self_link = null; /** - * The URL of a service serving the endpoint identified by this service attachment. + * The URL of a service serving the endpoint identified by this service + * attachment. * * Generated from protobuf field optional string target_service = 1293831; */ @@ -150,48 +213,107 @@ class ServiceAttachment extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type array<\Google\Cloud\Compute\V1\ServiceAttachmentConnectedEndpoint>|\Google\Protobuf\Internal\RepeatedField $connected_endpoints - * [Output Only] An array of connections for all the consumers connected to this service attachment. + * [Output Only] An array of connections for all the consumers connected to + * this service attachment. * @type string $connection_preference - * The connection preference of service attachment. The value can be set to ACCEPT_AUTOMATIC. An ACCEPT_AUTOMATIC service attachment is one that always accepts the connection from consumer forwarding rules. + * The connection preference of service attachment. The value can be set + * to ACCEPT_AUTOMATIC. An ACCEPT_AUTOMATIC + * service attachment is one that always accepts the connection from consumer + * forwarding rules. * Check the ConnectionPreference enum for the list of possible values. * @type array<\Google\Cloud\Compute\V1\ServiceAttachmentConsumerProjectLimit>|\Google\Protobuf\Internal\RepeatedField $consumer_accept_lists - * Specifies which consumer projects or networks are allowed to connect to the service attachment. Each project or network has a connection limit. A given service attachment can manage connections at either the project or network level. Therefore, both the accept and reject lists for a given service attachment must contain either only projects or only networks or only endpoints. + * Specifies which consumer projects or networks are allowed to connect to the + * service attachment. Each project or network has a connection limit. A given + * service attachment can manage connections at either the project or network + * level. Therefore, both the accept and reject lists for a given service + * attachment must contain either only projects or only networks or only + * endpoints. * @type array|\Google\Protobuf\Internal\RepeatedField $consumer_reject_lists - * Specifies a list of projects or networks that are not allowed to connect to this service attachment. The project can be specified using its project ID or project number and the network can be specified using its URL. A given service attachment can manage connections at either the project or network level. Therefore, both the reject and accept lists for a given service attachment must contain either only projects or only networks. + * Specifies a list of projects or networks that are not allowed to connect to + * this service attachment. The project can be specified using its project ID + * or project number and the network can be specified using its URL. A given + * service attachment can manage connections at either the project or network + * level. Therefore, both the reject and accept lists for a given service + * attachment must contain either only projects or only networks. * @type string $creation_timestamp - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * @type string $description - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * @type array|\Google\Protobuf\Internal\RepeatedField $domain_names - * If specified, the domain name will be used during the integration between the PSC connected endpoints and the Cloud DNS. For example, this is a valid domain name: "p.mycompany.com.". Current max number of domain names supported is 1. + * If specified, the domain name will be used during the integration between + * the PSC connected endpoints and the Cloud DNS. For example, this is a valid + * domain name: "p.mycompany.com.". Current max number of domain names + * supported is 1. * @type bool $enable_proxy_protocol - * If true, enable the proxy protocol which is for supplying client TCP/IP address data in TCP connections that traverse proxies on their way to destination servers. + * If true, enable the proxy protocol which is for supplying client TCP/IP + * address data in TCP connections that traverse proxies on their way to + * destination servers. * @type string $fingerprint - * Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking. This field will be ignored when inserting a ServiceAttachment. An up-to-date fingerprint must be provided in order to patch/update the ServiceAttachment; otherwise, the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve the ServiceAttachment. + * Fingerprint of this resource. A hash of the contents stored in this object. + * This field is used in optimistic locking. This field will be ignored when + * inserting a ServiceAttachment. An up-to-date fingerprint must + * be provided in order to patch/update the ServiceAttachment; otherwise, the + * request will fail with error 412 conditionNotMet. To see the + * latest fingerprint, make a get() request to retrieve the + * ServiceAttachment. * @type int|string $id - * [Output Only] The unique identifier for the resource type. The server generates this identifier. + * [Output Only] The unique identifier for the resource type. The server + * generates this identifier. * @type string $kind - * [Output Only] Type of the resource. Always compute#serviceAttachment for service attachments. + * [Output Only] Type of the resource. Alwayscompute#serviceAttachment for service attachments. * @type array|\Google\Protobuf\Internal\MapField $metadata * Metadata of the service attachment. * @type string $name - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * @type array|\Google\Protobuf\Internal\RepeatedField $nat_subnets - * An array of URLs where each entry is the URL of a subnet provided by the service producer to use for NAT in this service attachment. + * An array of URLs where each entry is the URL of a subnet provided + * by the service producer to use for NAT in this service attachment. * @type string $producer_forwarding_rule - * The URL of a forwarding rule with loadBalancingScheme INTERNAL* that is serving the endpoint identified by this service attachment. + * The URL of a forwarding rule with loadBalancingScheme INTERNAL* that is + * serving the endpoint identified by this service attachment. * @type int $propagated_connection_limit - * The number of consumer spokes that connected Private Service Connect endpoints can be propagated to through Network Connectivity Center. This limit lets the service producer limit how many propagated Private Service Connect connections can be established to this service attachment from a single consumer. If the connection preference of the service attachment is ACCEPT_MANUAL, the limit applies to each project or network that is listed in the consumer accept list. If the connection preference of the service attachment is ACCEPT_AUTOMATIC, the limit applies to each project that contains a connected endpoint. If unspecified, the default propagated connection limit is 250. + * The number of consumer spokes that connected Private Service Connect + * endpoints can be propagated to through Network Connectivity Center. This + * limit lets the service producer limit how many propagated Private Service + * Connect connections can be established to this service attachment from a + * single consumer. + * If the connection preference of the service attachment is ACCEPT_MANUAL, + * the limit applies to each project or network that is listed in the consumer + * accept list. If the connection preference of the service attachment is + * ACCEPT_AUTOMATIC, the limit applies to each project that contains a + * connected endpoint. + * If unspecified, the default propagated connection limit is 250. * @type \Google\Cloud\Compute\V1\Uint128 $psc_service_attachment_id * [Output Only] An 128-bit global unique ID of the PSC service attachment. * @type bool $reconcile_connections - * This flag determines whether a consumer accept/reject list change can reconcile the statuses of existing ACCEPTED or REJECTED PSC endpoints. - If false, connection policy update will only affect existing PENDING PSC endpoints. Existing ACCEPTED/REJECTED endpoints will remain untouched regardless how the connection policy is modified . - If true, update will affect both PENDING and ACCEPTED/REJECTED PSC endpoints. For example, an ACCEPTED PSC endpoint will be moved to REJECTED if its project is added to the reject list. For newly created service attachment, this boolean defaults to false. + * This flag determines whether a consumer accept/reject list change can + * reconcile the statuses of existing ACCEPTED or REJECTED PSC endpoints. + * - If false, connection policy update will only affect existing PENDING + * PSC endpoints. Existing ACCEPTED/REJECTED endpoints will remain untouched + * regardless how the connection policy is modified . + * - If true, + * update will affect both PENDING and ACCEPTED/REJECTED PSC endpoints. For + * example, an ACCEPTED PSC endpoint will be moved to REJECTED if its project + * is added to the reject list. + * For newly created service attachment, this boolean defaults to false. * @type string $region - * [Output Only] URL of the region where the service attachment resides. This field applies only to the region resource. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * [Output Only] URL of the region where the service attachment resides. + * This field applies only to the region resource. You must specify this + * field as part of the HTTP request URL. It is not settable as a field in + * the request body. * @type string $self_link * [Output Only] Server-defined URL for the resource. * @type string $target_service - * The URL of a service serving the endpoint identified by this service attachment. + * The URL of a service serving the endpoint identified by this service + * attachment. * } */ public function __construct($data = NULL) { @@ -200,7 +322,8 @@ public function __construct($data = NULL) { } /** - * [Output Only] An array of connections for all the consumers connected to this service attachment. + * [Output Only] An array of connections for all the consumers connected to + * this service attachment. * * Generated from protobuf field repeated .google.cloud.compute.v1.ServiceAttachmentConnectedEndpoint connected_endpoints = 72223688; * @return \Google\Protobuf\Internal\RepeatedField @@ -211,7 +334,8 @@ public function getConnectedEndpoints() } /** - * [Output Only] An array of connections for all the consumers connected to this service attachment. + * [Output Only] An array of connections for all the consumers connected to + * this service attachment. * * Generated from protobuf field repeated .google.cloud.compute.v1.ServiceAttachmentConnectedEndpoint connected_endpoints = 72223688; * @param array<\Google\Cloud\Compute\V1\ServiceAttachmentConnectedEndpoint>|\Google\Protobuf\Internal\RepeatedField $var @@ -226,7 +350,10 @@ public function setConnectedEndpoints($var) } /** - * The connection preference of service attachment. The value can be set to ACCEPT_AUTOMATIC. An ACCEPT_AUTOMATIC service attachment is one that always accepts the connection from consumer forwarding rules. + * The connection preference of service attachment. The value can be set + * to ACCEPT_AUTOMATIC. An ACCEPT_AUTOMATIC + * service attachment is one that always accepts the connection from consumer + * forwarding rules. * Check the ConnectionPreference enum for the list of possible values. * * Generated from protobuf field optional string connection_preference = 285818076; @@ -248,7 +375,10 @@ public function clearConnectionPreference() } /** - * The connection preference of service attachment. The value can be set to ACCEPT_AUTOMATIC. An ACCEPT_AUTOMATIC service attachment is one that always accepts the connection from consumer forwarding rules. + * The connection preference of service attachment. The value can be set + * to ACCEPT_AUTOMATIC. An ACCEPT_AUTOMATIC + * service attachment is one that always accepts the connection from consumer + * forwarding rules. * Check the ConnectionPreference enum for the list of possible values. * * Generated from protobuf field optional string connection_preference = 285818076; @@ -264,7 +394,12 @@ public function setConnectionPreference($var) } /** - * Specifies which consumer projects or networks are allowed to connect to the service attachment. Each project or network has a connection limit. A given service attachment can manage connections at either the project or network level. Therefore, both the accept and reject lists for a given service attachment must contain either only projects or only networks or only endpoints. + * Specifies which consumer projects or networks are allowed to connect to the + * service attachment. Each project or network has a connection limit. A given + * service attachment can manage connections at either the project or network + * level. Therefore, both the accept and reject lists for a given service + * attachment must contain either only projects or only networks or only + * endpoints. * * Generated from protobuf field repeated .google.cloud.compute.v1.ServiceAttachmentConsumerProjectLimit consumer_accept_lists = 402725703; * @return \Google\Protobuf\Internal\RepeatedField @@ -275,7 +410,12 @@ public function getConsumerAcceptLists() } /** - * Specifies which consumer projects or networks are allowed to connect to the service attachment. Each project or network has a connection limit. A given service attachment can manage connections at either the project or network level. Therefore, both the accept and reject lists for a given service attachment must contain either only projects or only networks or only endpoints. + * Specifies which consumer projects or networks are allowed to connect to the + * service attachment. Each project or network has a connection limit. A given + * service attachment can manage connections at either the project or network + * level. Therefore, both the accept and reject lists for a given service + * attachment must contain either only projects or only networks or only + * endpoints. * * Generated from protobuf field repeated .google.cloud.compute.v1.ServiceAttachmentConsumerProjectLimit consumer_accept_lists = 402725703; * @param array<\Google\Cloud\Compute\V1\ServiceAttachmentConsumerProjectLimit>|\Google\Protobuf\Internal\RepeatedField $var @@ -290,7 +430,12 @@ public function setConsumerAcceptLists($var) } /** - * Specifies a list of projects or networks that are not allowed to connect to this service attachment. The project can be specified using its project ID or project number and the network can be specified using its URL. A given service attachment can manage connections at either the project or network level. Therefore, both the reject and accept lists for a given service attachment must contain either only projects or only networks. + * Specifies a list of projects or networks that are not allowed to connect to + * this service attachment. The project can be specified using its project ID + * or project number and the network can be specified using its URL. A given + * service attachment can manage connections at either the project or network + * level. Therefore, both the reject and accept lists for a given service + * attachment must contain either only projects or only networks. * * Generated from protobuf field repeated string consumer_reject_lists = 204033182; * @return \Google\Protobuf\Internal\RepeatedField @@ -301,7 +446,12 @@ public function getConsumerRejectLists() } /** - * Specifies a list of projects or networks that are not allowed to connect to this service attachment. The project can be specified using its project ID or project number and the network can be specified using its URL. A given service attachment can manage connections at either the project or network level. Therefore, both the reject and accept lists for a given service attachment must contain either only projects or only networks. + * Specifies a list of projects or networks that are not allowed to connect to + * this service attachment. The project can be specified using its project ID + * or project number and the network can be specified using its URL. A given + * service attachment can manage connections at either the project or network + * level. Therefore, both the reject and accept lists for a given service + * attachment must contain either only projects or only networks. * * Generated from protobuf field repeated string consumer_reject_lists = 204033182; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -316,7 +466,8 @@ public function setConsumerRejectLists($var) } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @return string @@ -337,7 +488,8 @@ public function clearCreationTimestamp() } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @param string $var @@ -352,7 +504,8 @@ public function setCreationTimestamp($var) } /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @return string @@ -373,7 +526,8 @@ public function clearDescription() } /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @param string $var @@ -388,7 +542,10 @@ public function setDescription($var) } /** - * If specified, the domain name will be used during the integration between the PSC connected endpoints and the Cloud DNS. For example, this is a valid domain name: "p.mycompany.com.". Current max number of domain names supported is 1. + * If specified, the domain name will be used during the integration between + * the PSC connected endpoints and the Cloud DNS. For example, this is a valid + * domain name: "p.mycompany.com.". Current max number of domain names + * supported is 1. * * Generated from protobuf field repeated string domain_names = 6450189; * @return \Google\Protobuf\Internal\RepeatedField @@ -399,7 +556,10 @@ public function getDomainNames() } /** - * If specified, the domain name will be used during the integration between the PSC connected endpoints and the Cloud DNS. For example, this is a valid domain name: "p.mycompany.com.". Current max number of domain names supported is 1. + * If specified, the domain name will be used during the integration between + * the PSC connected endpoints and the Cloud DNS. For example, this is a valid + * domain name: "p.mycompany.com.". Current max number of domain names + * supported is 1. * * Generated from protobuf field repeated string domain_names = 6450189; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -414,7 +574,9 @@ public function setDomainNames($var) } /** - * If true, enable the proxy protocol which is for supplying client TCP/IP address data in TCP connections that traverse proxies on their way to destination servers. + * If true, enable the proxy protocol which is for supplying client TCP/IP + * address data in TCP connections that traverse proxies on their way to + * destination servers. * * Generated from protobuf field optional bool enable_proxy_protocol = 363791237; * @return bool @@ -435,7 +597,9 @@ public function clearEnableProxyProtocol() } /** - * If true, enable the proxy protocol which is for supplying client TCP/IP address data in TCP connections that traverse proxies on their way to destination servers. + * If true, enable the proxy protocol which is for supplying client TCP/IP + * address data in TCP connections that traverse proxies on their way to + * destination servers. * * Generated from protobuf field optional bool enable_proxy_protocol = 363791237; * @param bool $var @@ -450,7 +614,13 @@ public function setEnableProxyProtocol($var) } /** - * Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking. This field will be ignored when inserting a ServiceAttachment. An up-to-date fingerprint must be provided in order to patch/update the ServiceAttachment; otherwise, the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve the ServiceAttachment. + * Fingerprint of this resource. A hash of the contents stored in this object. + * This field is used in optimistic locking. This field will be ignored when + * inserting a ServiceAttachment. An up-to-date fingerprint must + * be provided in order to patch/update the ServiceAttachment; otherwise, the + * request will fail with error 412 conditionNotMet. To see the + * latest fingerprint, make a get() request to retrieve the + * ServiceAttachment. * * Generated from protobuf field optional string fingerprint = 234678500; * @return string @@ -471,7 +641,13 @@ public function clearFingerprint() } /** - * Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking. This field will be ignored when inserting a ServiceAttachment. An up-to-date fingerprint must be provided in order to patch/update the ServiceAttachment; otherwise, the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve the ServiceAttachment. + * Fingerprint of this resource. A hash of the contents stored in this object. + * This field is used in optimistic locking. This field will be ignored when + * inserting a ServiceAttachment. An up-to-date fingerprint must + * be provided in order to patch/update the ServiceAttachment; otherwise, the + * request will fail with error 412 conditionNotMet. To see the + * latest fingerprint, make a get() request to retrieve the + * ServiceAttachment. * * Generated from protobuf field optional string fingerprint = 234678500; * @param string $var @@ -486,7 +662,8 @@ public function setFingerprint($var) } /** - * [Output Only] The unique identifier for the resource type. The server generates this identifier. + * [Output Only] The unique identifier for the resource type. The server + * generates this identifier. * * Generated from protobuf field optional uint64 id = 3355; * @return int|string @@ -507,7 +684,8 @@ public function clearId() } /** - * [Output Only] The unique identifier for the resource type. The server generates this identifier. + * [Output Only] The unique identifier for the resource type. The server + * generates this identifier. * * Generated from protobuf field optional uint64 id = 3355; * @param int|string $var @@ -522,7 +700,7 @@ public function setId($var) } /** - * [Output Only] Type of the resource. Always compute#serviceAttachment for service attachments. + * [Output Only] Type of the resource. Alwayscompute#serviceAttachment for service attachments. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -543,7 +721,7 @@ public function clearKind() } /** - * [Output Only] Type of the resource. Always compute#serviceAttachment for service attachments. + * [Output Only] Type of the resource. Alwayscompute#serviceAttachment for service attachments. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -584,7 +762,13 @@ public function setMetadata($var) } /** - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * * Generated from protobuf field optional string name = 3373707; * @return string @@ -605,7 +789,13 @@ public function clearName() } /** - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * * Generated from protobuf field optional string name = 3373707; * @param string $var @@ -620,7 +810,8 @@ public function setName($var) } /** - * An array of URLs where each entry is the URL of a subnet provided by the service producer to use for NAT in this service attachment. + * An array of URLs where each entry is the URL of a subnet provided + * by the service producer to use for NAT in this service attachment. * * Generated from protobuf field repeated string nat_subnets = 374785944; * @return \Google\Protobuf\Internal\RepeatedField @@ -631,7 +822,8 @@ public function getNatSubnets() } /** - * An array of URLs where each entry is the URL of a subnet provided by the service producer to use for NAT in this service attachment. + * An array of URLs where each entry is the URL of a subnet provided + * by the service producer to use for NAT in this service attachment. * * Generated from protobuf field repeated string nat_subnets = 374785944; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -646,7 +838,8 @@ public function setNatSubnets($var) } /** - * The URL of a forwarding rule with loadBalancingScheme INTERNAL* that is serving the endpoint identified by this service attachment. + * The URL of a forwarding rule with loadBalancingScheme INTERNAL* that is + * serving the endpoint identified by this service attachment. * * Generated from protobuf field optional string producer_forwarding_rule = 247927889; * @return string @@ -667,7 +860,8 @@ public function clearProducerForwardingRule() } /** - * The URL of a forwarding rule with loadBalancingScheme INTERNAL* that is serving the endpoint identified by this service attachment. + * The URL of a forwarding rule with loadBalancingScheme INTERNAL* that is + * serving the endpoint identified by this service attachment. * * Generated from protobuf field optional string producer_forwarding_rule = 247927889; * @param string $var @@ -682,7 +876,17 @@ public function setProducerForwardingRule($var) } /** - * The number of consumer spokes that connected Private Service Connect endpoints can be propagated to through Network Connectivity Center. This limit lets the service producer limit how many propagated Private Service Connect connections can be established to this service attachment from a single consumer. If the connection preference of the service attachment is ACCEPT_MANUAL, the limit applies to each project or network that is listed in the consumer accept list. If the connection preference of the service attachment is ACCEPT_AUTOMATIC, the limit applies to each project that contains a connected endpoint. If unspecified, the default propagated connection limit is 250. + * The number of consumer spokes that connected Private Service Connect + * endpoints can be propagated to through Network Connectivity Center. This + * limit lets the service producer limit how many propagated Private Service + * Connect connections can be established to this service attachment from a + * single consumer. + * If the connection preference of the service attachment is ACCEPT_MANUAL, + * the limit applies to each project or network that is listed in the consumer + * accept list. If the connection preference of the service attachment is + * ACCEPT_AUTOMATIC, the limit applies to each project that contains a + * connected endpoint. + * If unspecified, the default propagated connection limit is 250. * * Generated from protobuf field optional uint32 propagated_connection_limit = 332719230; * @return int @@ -703,7 +907,17 @@ public function clearPropagatedConnectionLimit() } /** - * The number of consumer spokes that connected Private Service Connect endpoints can be propagated to through Network Connectivity Center. This limit lets the service producer limit how many propagated Private Service Connect connections can be established to this service attachment from a single consumer. If the connection preference of the service attachment is ACCEPT_MANUAL, the limit applies to each project or network that is listed in the consumer accept list. If the connection preference of the service attachment is ACCEPT_AUTOMATIC, the limit applies to each project that contains a connected endpoint. If unspecified, the default propagated connection limit is 250. + * The number of consumer spokes that connected Private Service Connect + * endpoints can be propagated to through Network Connectivity Center. This + * limit lets the service producer limit how many propagated Private Service + * Connect connections can be established to this service attachment from a + * single consumer. + * If the connection preference of the service attachment is ACCEPT_MANUAL, + * the limit applies to each project or network that is listed in the consumer + * accept list. If the connection preference of the service attachment is + * ACCEPT_AUTOMATIC, the limit applies to each project that contains a + * connected endpoint. + * If unspecified, the default propagated connection limit is 250. * * Generated from protobuf field optional uint32 propagated_connection_limit = 332719230; * @param int $var @@ -754,7 +968,16 @@ public function setPscServiceAttachmentId($var) } /** - * This flag determines whether a consumer accept/reject list change can reconcile the statuses of existing ACCEPTED or REJECTED PSC endpoints. - If false, connection policy update will only affect existing PENDING PSC endpoints. Existing ACCEPTED/REJECTED endpoints will remain untouched regardless how the connection policy is modified . - If true, update will affect both PENDING and ACCEPTED/REJECTED PSC endpoints. For example, an ACCEPTED PSC endpoint will be moved to REJECTED if its project is added to the reject list. For newly created service attachment, this boolean defaults to false. + * This flag determines whether a consumer accept/reject list change can + * reconcile the statuses of existing ACCEPTED or REJECTED PSC endpoints. + * - If false, connection policy update will only affect existing PENDING + * PSC endpoints. Existing ACCEPTED/REJECTED endpoints will remain untouched + * regardless how the connection policy is modified . + * - If true, + * update will affect both PENDING and ACCEPTED/REJECTED PSC endpoints. For + * example, an ACCEPTED PSC endpoint will be moved to REJECTED if its project + * is added to the reject list. + * For newly created service attachment, this boolean defaults to false. * * Generated from protobuf field optional bool reconcile_connections = 125493732; * @return bool @@ -775,7 +998,16 @@ public function clearReconcileConnections() } /** - * This flag determines whether a consumer accept/reject list change can reconcile the statuses of existing ACCEPTED or REJECTED PSC endpoints. - If false, connection policy update will only affect existing PENDING PSC endpoints. Existing ACCEPTED/REJECTED endpoints will remain untouched regardless how the connection policy is modified . - If true, update will affect both PENDING and ACCEPTED/REJECTED PSC endpoints. For example, an ACCEPTED PSC endpoint will be moved to REJECTED if its project is added to the reject list. For newly created service attachment, this boolean defaults to false. + * This flag determines whether a consumer accept/reject list change can + * reconcile the statuses of existing ACCEPTED or REJECTED PSC endpoints. + * - If false, connection policy update will only affect existing PENDING + * PSC endpoints. Existing ACCEPTED/REJECTED endpoints will remain untouched + * regardless how the connection policy is modified . + * - If true, + * update will affect both PENDING and ACCEPTED/REJECTED PSC endpoints. For + * example, an ACCEPTED PSC endpoint will be moved to REJECTED if its project + * is added to the reject list. + * For newly created service attachment, this boolean defaults to false. * * Generated from protobuf field optional bool reconcile_connections = 125493732; * @param bool $var @@ -790,7 +1022,10 @@ public function setReconcileConnections($var) } /** - * [Output Only] URL of the region where the service attachment resides. This field applies only to the region resource. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * [Output Only] URL of the region where the service attachment resides. + * This field applies only to the region resource. You must specify this + * field as part of the HTTP request URL. It is not settable as a field in + * the request body. * * Generated from protobuf field optional string region = 138946292; * @return string @@ -811,7 +1046,10 @@ public function clearRegion() } /** - * [Output Only] URL of the region where the service attachment resides. This field applies only to the region resource. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * [Output Only] URL of the region where the service attachment resides. + * This field applies only to the region resource. You must specify this + * field as part of the HTTP request URL. It is not settable as a field in + * the request body. * * Generated from protobuf field optional string region = 138946292; * @param string $var @@ -862,7 +1100,8 @@ public function setSelfLink($var) } /** - * The URL of a service serving the endpoint identified by this service attachment. + * The URL of a service serving the endpoint identified by this service + * attachment. * * Generated from protobuf field optional string target_service = 1293831; * @return string @@ -883,7 +1122,8 @@ public function clearTargetService() } /** - * The URL of a service serving the endpoint identified by this service attachment. + * The URL of a service serving the endpoint identified by this service + * attachment. * * Generated from protobuf field optional string target_service = 1293831; * @param string $var diff --git a/Compute/src/V1/ServiceAttachment/ConnectionPreference.php b/Compute/src/V1/ServiceAttachment/ConnectionPreference.php index 58306a2a7224..ba0dc786a1f8 100644 --- a/Compute/src/V1/ServiceAttachment/ConnectionPreference.php +++ b/Compute/src/V1/ServiceAttachment/ConnectionPreference.php @@ -7,7 +7,10 @@ use UnexpectedValueException; /** - * The connection preference of service attachment. The value can be set to ACCEPT_AUTOMATIC. An ACCEPT_AUTOMATIC service attachment is one that always accepts the connection from consumer forwarding rules. + * The connection preference of service attachment. The value can be set + * to ACCEPT_AUTOMATIC. An ACCEPT_AUTOMATIC + * service attachment is one that always accepts the connection from consumer + * forwarding rules. * * Protobuf type google.cloud.compute.v1.ServiceAttachment.ConnectionPreference */ diff --git a/Compute/src/V1/ServiceAttachmentAggregatedList.php b/Compute/src/V1/ServiceAttachmentAggregatedList.php index 1addb09f06c9..37c73aa0ee49 100644 --- a/Compute/src/V1/ServiceAttachmentAggregatedList.php +++ b/Compute/src/V1/ServiceAttachmentAggregatedList.php @@ -34,7 +34,11 @@ class ServiceAttachmentAggregatedList extends \Google\Protobuf\Internal\Message */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -71,7 +75,11 @@ class ServiceAttachmentAggregatedList extends \Google\Protobuf\Internal\Message * @type string $kind * Type of resource. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type array|\Google\Protobuf\Internal\RepeatedField $unreachables @@ -184,7 +192,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -205,7 +217,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/ServiceAttachmentConnectedEndpoint.php b/Compute/src/V1/ServiceAttachmentConnectedEndpoint.php index dab76f157e3d..a011baa38d37 100644 --- a/Compute/src/V1/ServiceAttachmentConnectedEndpoint.php +++ b/Compute/src/V1/ServiceAttachmentConnectedEndpoint.php @@ -28,13 +28,15 @@ class ServiceAttachmentConnectedEndpoint extends \Google\Protobuf\Internal\Messa */ protected $endpoint = null; /** - * NAT IPs of the connected PSC endpoint and those of other endpoints propagated from it. + * NAT IPs of the connected PSC endpoint and those of other endpoints + * propagated from it. * * Generated from protobuf field repeated string nat_ips = 117635086; */ private $nat_ips; /** - * The number of consumer Network Connectivity Center spokes that the connected Private Service Connect endpoint has propagated to. + * The number of consumer Network Connectivity Center spokes that the + * connected Private Service Connect endpoint has propagated to. * * Generated from protobuf field optional uint32 propagated_connection_count = 324594130; */ @@ -64,9 +66,11 @@ class ServiceAttachmentConnectedEndpoint extends \Google\Protobuf\Internal\Messa * @type string $endpoint * The url of a connected endpoint. * @type array|\Google\Protobuf\Internal\RepeatedField $nat_ips - * NAT IPs of the connected PSC endpoint and those of other endpoints propagated from it. + * NAT IPs of the connected PSC endpoint and those of other endpoints + * propagated from it. * @type int $propagated_connection_count - * The number of consumer Network Connectivity Center spokes that the connected Private Service Connect endpoint has propagated to. + * The number of consumer Network Connectivity Center spokes that the + * connected Private Service Connect endpoint has propagated to. * @type int|string $psc_connection_id * The PSC connection id of the connected endpoint. * @type string $status @@ -152,7 +156,8 @@ public function setEndpoint($var) } /** - * NAT IPs of the connected PSC endpoint and those of other endpoints propagated from it. + * NAT IPs of the connected PSC endpoint and those of other endpoints + * propagated from it. * * Generated from protobuf field repeated string nat_ips = 117635086; * @return \Google\Protobuf\Internal\RepeatedField @@ -163,7 +168,8 @@ public function getNatIps() } /** - * NAT IPs of the connected PSC endpoint and those of other endpoints propagated from it. + * NAT IPs of the connected PSC endpoint and those of other endpoints + * propagated from it. * * Generated from protobuf field repeated string nat_ips = 117635086; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -178,7 +184,8 @@ public function setNatIps($var) } /** - * The number of consumer Network Connectivity Center spokes that the connected Private Service Connect endpoint has propagated to. + * The number of consumer Network Connectivity Center spokes that the + * connected Private Service Connect endpoint has propagated to. * * Generated from protobuf field optional uint32 propagated_connection_count = 324594130; * @return int @@ -199,7 +206,8 @@ public function clearPropagatedConnectionCount() } /** - * The number of consumer Network Connectivity Center spokes that the connected Private Service Connect endpoint has propagated to. + * The number of consumer Network Connectivity Center spokes that the + * connected Private Service Connect endpoint has propagated to. * * Generated from protobuf field optional uint32 propagated_connection_count = 324594130; * @param int $var diff --git a/Compute/src/V1/ServiceAttachmentConnectedEndpoint/Status.php b/Compute/src/V1/ServiceAttachmentConnectedEndpoint/Status.php index d48a2efbc6a3..7ed9570afda4 100644 --- a/Compute/src/V1/ServiceAttachmentConnectedEndpoint/Status.php +++ b/Compute/src/V1/ServiceAttachmentConnectedEndpoint/Status.php @@ -32,7 +32,9 @@ class Status */ const CLOSED = 380163436; /** - * The connection has been accepted by the producer, but the producer needs to take further action before the forwarding rule can serve traffic. + * The connection has been accepted by the producer, but the producer + * needs to take further action before the forwarding rule can serve + * traffic. * * Generated from protobuf enum NEEDS_ATTENTION = 344491452; */ diff --git a/Compute/src/V1/ServiceAttachmentConsumerProjectLimit.php b/Compute/src/V1/ServiceAttachmentConsumerProjectLimit.php index 1789bf98a763..44fef5654913 100644 --- a/Compute/src/V1/ServiceAttachmentConsumerProjectLimit.php +++ b/Compute/src/V1/ServiceAttachmentConsumerProjectLimit.php @@ -15,7 +15,8 @@ class ServiceAttachmentConsumerProjectLimit extends \Google\Protobuf\Internal\Message { /** - * The value of the limit to set. For endpoint_url, the limit should be no more than 1. + * The value of the limit to set. For endpoint_url, the limit should be no + * more than 1. * * Generated from protobuf field optional uint32 connection_limit = 131403546; */ @@ -40,7 +41,8 @@ class ServiceAttachmentConsumerProjectLimit extends \Google\Protobuf\Internal\Me * Optional. Data for populating the Message object. * * @type int $connection_limit - * The value of the limit to set. For endpoint_url, the limit should be no more than 1. + * The value of the limit to set. For endpoint_url, the limit should be no + * more than 1. * @type string $network_url * The network URL for the network to set the limit for. * @type string $project_id_or_num @@ -53,7 +55,8 @@ public function __construct($data = NULL) { } /** - * The value of the limit to set. For endpoint_url, the limit should be no more than 1. + * The value of the limit to set. For endpoint_url, the limit should be no + * more than 1. * * Generated from protobuf field optional uint32 connection_limit = 131403546; * @return int @@ -74,7 +77,8 @@ public function clearConnectionLimit() } /** - * The value of the limit to set. For endpoint_url, the limit should be no more than 1. + * The value of the limit to set. For endpoint_url, the limit should be no + * more than 1. * * Generated from protobuf field optional uint32 connection_limit = 131403546; * @param int $var diff --git a/Compute/src/V1/ServiceAttachmentList.php b/Compute/src/V1/ServiceAttachmentList.php index fb661df50087..12f9dc29d0a6 100644 --- a/Compute/src/V1/ServiceAttachmentList.php +++ b/Compute/src/V1/ServiceAttachmentList.php @@ -27,13 +27,17 @@ class ServiceAttachmentList extends \Google\Protobuf\Internal\Message */ private $items; /** - * [Output Only] Type of the resource. Always compute#serviceAttachment for service attachments. + * [Output Only] Type of the resource. Alwayscompute#serviceAttachment for service attachments. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -62,9 +66,13 @@ class ServiceAttachmentList extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\ServiceAttachment>|\Google\Protobuf\Internal\RepeatedField $items * A list of ServiceAttachment resources. * @type string $kind - * [Output Only] Type of the resource. Always compute#serviceAttachment for service attachments. + * [Output Only] Type of the resource. Alwayscompute#serviceAttachment for service attachments. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type \Google\Cloud\Compute\V1\Warning $warning @@ -139,7 +147,7 @@ public function setItems($var) } /** - * [Output Only] Type of the resource. Always compute#serviceAttachment for service attachments. + * [Output Only] Type of the resource. Alwayscompute#serviceAttachment for service attachments. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -160,7 +168,7 @@ public function clearKind() } /** - * [Output Only] Type of the resource. Always compute#serviceAttachment for service attachments. + * [Output Only] Type of the resource. Alwayscompute#serviceAttachment for service attachments. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -175,7 +183,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -196,7 +208,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/ServiceAttachmentsScopedList.php b/Compute/src/V1/ServiceAttachmentsScopedList.php index 21ea5825e3c2..2e5ad0b05a9e 100644 --- a/Compute/src/V1/ServiceAttachmentsScopedList.php +++ b/Compute/src/V1/ServiceAttachmentsScopedList.php @@ -21,7 +21,8 @@ class ServiceAttachmentsScopedList extends \Google\Protobuf\Internal\Message */ private $service_attachments; /** - * Informational warning which replaces the list of service attachments when the list is empty. + * Informational warning which replaces the list of + * service attachments when the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; */ @@ -36,7 +37,8 @@ class ServiceAttachmentsScopedList extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\ServiceAttachment>|\Google\Protobuf\Internal\RepeatedField $service_attachments * A list of ServiceAttachments contained in this scope. * @type \Google\Cloud\Compute\V1\Warning $warning - * Informational warning which replaces the list of service attachments when the list is empty. + * Informational warning which replaces the list of + * service attachments when the list is empty. * } */ public function __construct($data = NULL) { @@ -71,7 +73,8 @@ public function setServiceAttachments($var) } /** - * Informational warning which replaces the list of service attachments when the list is empty. + * Informational warning which replaces the list of + * service attachments when the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; * @return \Google\Cloud\Compute\V1\Warning|null @@ -92,7 +95,8 @@ public function clearWarning() } /** - * Informational warning which replaces the list of service attachments when the list is empty. + * Informational warning which replaces the list of + * service attachments when the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; * @param \Google\Cloud\Compute\V1\Warning $var diff --git a/Compute/src/V1/SetBackendServiceTargetSslProxyRequest.php b/Compute/src/V1/SetBackendServiceTargetSslProxyRequest.php index 2824a60f967b..03bf7ecb5639 100644 --- a/Compute/src/V1/SetBackendServiceTargetSslProxyRequest.php +++ b/Compute/src/V1/SetBackendServiceTargetSslProxyRequest.php @@ -22,7 +22,17 @@ class SetBackendServiceTargetSslProxyRequest extends \Google\Protobuf\Internal\M */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -34,7 +44,8 @@ class SetBackendServiceTargetSslProxyRequest extends \Google\Protobuf\Internal\M */ protected $target_ssl_proxies_set_backend_service_request_resource = null; /** - * Name of the TargetSslProxy resource whose BackendService resource is to be set. + * Name of the TargetSslProxy resource whose BackendService resource + * is to be set. * * Generated from protobuf field string target_ssl_proxy = 338795853 [(.google.api.field_behavior) = REQUIRED]; */ @@ -42,7 +53,8 @@ class SetBackendServiceTargetSslProxyRequest extends \Google\Protobuf\Internal\M /** * @param string $project Project ID for this request. - * @param string $targetSslProxy Name of the TargetSslProxy resource whose BackendService resource is to be set. + * @param string $targetSslProxy Name of the TargetSslProxy resource whose BackendService resource + * is to be set. * @param \Google\Cloud\Compute\V1\TargetSslProxiesSetBackendServiceRequest $targetSslProxiesSetBackendServiceRequestResource The body resource for this request * * @return \Google\Cloud\Compute\V1\SetBackendServiceTargetSslProxyRequest @@ -66,11 +78,22 @@ public static function build(string $project, string $targetSslProxy, \Google\Cl * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type \Google\Cloud\Compute\V1\TargetSslProxiesSetBackendServiceRequest $target_ssl_proxies_set_backend_service_request_resource * The body resource for this request * @type string $target_ssl_proxy - * Name of the TargetSslProxy resource whose BackendService resource is to be set. + * Name of the TargetSslProxy resource whose BackendService resource + * is to be set. * } */ public function __construct($data = NULL) { @@ -105,7 +128,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -126,7 +159,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var @@ -177,7 +220,8 @@ public function setTargetSslProxiesSetBackendServiceRequestResource($var) } /** - * Name of the TargetSslProxy resource whose BackendService resource is to be set. + * Name of the TargetSslProxy resource whose BackendService resource + * is to be set. * * Generated from protobuf field string target_ssl_proxy = 338795853 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -188,7 +232,8 @@ public function getTargetSslProxy() } /** - * Name of the TargetSslProxy resource whose BackendService resource is to be set. + * Name of the TargetSslProxy resource whose BackendService resource + * is to be set. * * Generated from protobuf field string target_ssl_proxy = 338795853 [(.google.api.field_behavior) = REQUIRED]; * @param string $var diff --git a/Compute/src/V1/SetBackendServiceTargetTcpProxyRequest.php b/Compute/src/V1/SetBackendServiceTargetTcpProxyRequest.php index 6f78dca1cfbb..f119d7139e3d 100644 --- a/Compute/src/V1/SetBackendServiceTargetTcpProxyRequest.php +++ b/Compute/src/V1/SetBackendServiceTargetTcpProxyRequest.php @@ -22,7 +22,17 @@ class SetBackendServiceTargetTcpProxyRequest extends \Google\Protobuf\Internal\M */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -34,7 +44,8 @@ class SetBackendServiceTargetTcpProxyRequest extends \Google\Protobuf\Internal\M */ protected $target_tcp_proxies_set_backend_service_request_resource = null; /** - * Name of the TargetTcpProxy resource whose BackendService resource is to be set. + * Name of the TargetTcpProxy resource whose BackendService resource + * is to be set. * * Generated from protobuf field string target_tcp_proxy = 503065442 [(.google.api.field_behavior) = REQUIRED]; */ @@ -42,7 +53,8 @@ class SetBackendServiceTargetTcpProxyRequest extends \Google\Protobuf\Internal\M /** * @param string $project Project ID for this request. - * @param string $targetTcpProxy Name of the TargetTcpProxy resource whose BackendService resource is to be set. + * @param string $targetTcpProxy Name of the TargetTcpProxy resource whose BackendService resource + * is to be set. * @param \Google\Cloud\Compute\V1\TargetTcpProxiesSetBackendServiceRequest $targetTcpProxiesSetBackendServiceRequestResource The body resource for this request * * @return \Google\Cloud\Compute\V1\SetBackendServiceTargetTcpProxyRequest @@ -66,11 +78,22 @@ public static function build(string $project, string $targetTcpProxy, \Google\Cl * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type \Google\Cloud\Compute\V1\TargetTcpProxiesSetBackendServiceRequest $target_tcp_proxies_set_backend_service_request_resource * The body resource for this request * @type string $target_tcp_proxy - * Name of the TargetTcpProxy resource whose BackendService resource is to be set. + * Name of the TargetTcpProxy resource whose BackendService resource + * is to be set. * } */ public function __construct($data = NULL) { @@ -105,7 +128,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -126,7 +159,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var @@ -177,7 +220,8 @@ public function setTargetTcpProxiesSetBackendServiceRequestResource($var) } /** - * Name of the TargetTcpProxy resource whose BackendService resource is to be set. + * Name of the TargetTcpProxy resource whose BackendService resource + * is to be set. * * Generated from protobuf field string target_tcp_proxy = 503065442 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -188,7 +232,8 @@ public function getTargetTcpProxy() } /** - * Name of the TargetTcpProxy resource whose BackendService resource is to be set. + * Name of the TargetTcpProxy resource whose BackendService resource + * is to be set. * * Generated from protobuf field string target_tcp_proxy = 503065442 [(.google.api.field_behavior) = REQUIRED]; * @param string $var diff --git a/Compute/src/V1/SetBackupTargetPoolRequest.php b/Compute/src/V1/SetBackupTargetPoolRequest.php index fcfe6267ea74..8e361594e3e8 100644 --- a/Compute/src/V1/SetBackupTargetPoolRequest.php +++ b/Compute/src/V1/SetBackupTargetPoolRequest.php @@ -34,7 +34,17 @@ class SetBackupTargetPoolRequest extends \Google\Protobuf\Internal\Message */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -84,7 +94,17 @@ public static function build(string $project, string $region, string $targetPool * @type string $region * Name of the region scoping this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $target_pool * Name of the TargetPool resource to set a backup pool for. * @type \Google\Cloud\Compute\V1\TargetReference $target_reference_resource @@ -185,7 +205,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -206,7 +236,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/SetCertificateMapTargetHttpsProxyRequest.php b/Compute/src/V1/SetCertificateMapTargetHttpsProxyRequest.php index c238dfeb4568..63651ff69982 100644 --- a/Compute/src/V1/SetCertificateMapTargetHttpsProxyRequest.php +++ b/Compute/src/V1/SetCertificateMapTargetHttpsProxyRequest.php @@ -22,7 +22,17 @@ class SetCertificateMapTargetHttpsProxyRequest extends \Google\Protobuf\Internal */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -34,7 +44,8 @@ class SetCertificateMapTargetHttpsProxyRequest extends \Google\Protobuf\Internal */ protected $target_https_proxies_set_certificate_map_request_resource = null; /** - * Name of the TargetHttpsProxy resource whose CertificateMap is to be set. The name must be 1-63 characters long, and comply with RFC1035. + * Name of the TargetHttpsProxy resource whose CertificateMap is + * to be set. The name must be 1-63 characters long, and comply with RFC1035. * * Generated from protobuf field string target_https_proxy = 52336748 [(.google.api.field_behavior) = REQUIRED]; */ @@ -42,7 +53,8 @@ class SetCertificateMapTargetHttpsProxyRequest extends \Google\Protobuf\Internal /** * @param string $project Project ID for this request. - * @param string $targetHttpsProxy Name of the TargetHttpsProxy resource whose CertificateMap is to be set. The name must be 1-63 characters long, and comply with RFC1035. + * @param string $targetHttpsProxy Name of the TargetHttpsProxy resource whose CertificateMap is + * to be set. The name must be 1-63 characters long, and comply with RFC1035. * @param \Google\Cloud\Compute\V1\TargetHttpsProxiesSetCertificateMapRequest $targetHttpsProxiesSetCertificateMapRequestResource The body resource for this request * * @return \Google\Cloud\Compute\V1\SetCertificateMapTargetHttpsProxyRequest @@ -66,11 +78,22 @@ public static function build(string $project, string $targetHttpsProxy, \Google\ * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type \Google\Cloud\Compute\V1\TargetHttpsProxiesSetCertificateMapRequest $target_https_proxies_set_certificate_map_request_resource * The body resource for this request * @type string $target_https_proxy - * Name of the TargetHttpsProxy resource whose CertificateMap is to be set. The name must be 1-63 characters long, and comply with RFC1035. + * Name of the TargetHttpsProxy resource whose CertificateMap is + * to be set. The name must be 1-63 characters long, and comply with RFC1035. * } */ public function __construct($data = NULL) { @@ -105,7 +128,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -126,7 +159,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var @@ -177,7 +220,8 @@ public function setTargetHttpsProxiesSetCertificateMapRequestResource($var) } /** - * Name of the TargetHttpsProxy resource whose CertificateMap is to be set. The name must be 1-63 characters long, and comply with RFC1035. + * Name of the TargetHttpsProxy resource whose CertificateMap is + * to be set. The name must be 1-63 characters long, and comply with RFC1035. * * Generated from protobuf field string target_https_proxy = 52336748 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -188,7 +232,8 @@ public function getTargetHttpsProxy() } /** - * Name of the TargetHttpsProxy resource whose CertificateMap is to be set. The name must be 1-63 characters long, and comply with RFC1035. + * Name of the TargetHttpsProxy resource whose CertificateMap is + * to be set. The name must be 1-63 characters long, and comply with RFC1035. * * Generated from protobuf field string target_https_proxy = 52336748 [(.google.api.field_behavior) = REQUIRED]; * @param string $var diff --git a/Compute/src/V1/SetCertificateMapTargetSslProxyRequest.php b/Compute/src/V1/SetCertificateMapTargetSslProxyRequest.php index 6701611f2e95..a6771c010e67 100644 --- a/Compute/src/V1/SetCertificateMapTargetSslProxyRequest.php +++ b/Compute/src/V1/SetCertificateMapTargetSslProxyRequest.php @@ -22,7 +22,17 @@ class SetCertificateMapTargetSslProxyRequest extends \Google\Protobuf\Internal\M */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -34,7 +44,8 @@ class SetCertificateMapTargetSslProxyRequest extends \Google\Protobuf\Internal\M */ protected $target_ssl_proxies_set_certificate_map_request_resource = null; /** - * Name of the TargetSslProxy resource whose CertificateMap is to be set. The name must be 1-63 characters long, and comply with RFC1035. + * Name of the TargetSslProxy resource whose CertificateMap is + * to be set. The name must be 1-63 characters long, and comply with RFC1035. * * Generated from protobuf field string target_ssl_proxy = 338795853 [(.google.api.field_behavior) = REQUIRED]; */ @@ -42,7 +53,8 @@ class SetCertificateMapTargetSslProxyRequest extends \Google\Protobuf\Internal\M /** * @param string $project Project ID for this request. - * @param string $targetSslProxy Name of the TargetSslProxy resource whose CertificateMap is to be set. The name must be 1-63 characters long, and comply with RFC1035. + * @param string $targetSslProxy Name of the TargetSslProxy resource whose CertificateMap is + * to be set. The name must be 1-63 characters long, and comply with RFC1035. * @param \Google\Cloud\Compute\V1\TargetSslProxiesSetCertificateMapRequest $targetSslProxiesSetCertificateMapRequestResource The body resource for this request * * @return \Google\Cloud\Compute\V1\SetCertificateMapTargetSslProxyRequest @@ -66,11 +78,22 @@ public static function build(string $project, string $targetSslProxy, \Google\Cl * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type \Google\Cloud\Compute\V1\TargetSslProxiesSetCertificateMapRequest $target_ssl_proxies_set_certificate_map_request_resource * The body resource for this request * @type string $target_ssl_proxy - * Name of the TargetSslProxy resource whose CertificateMap is to be set. The name must be 1-63 characters long, and comply with RFC1035. + * Name of the TargetSslProxy resource whose CertificateMap is + * to be set. The name must be 1-63 characters long, and comply with RFC1035. * } */ public function __construct($data = NULL) { @@ -105,7 +128,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -126,7 +159,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var @@ -177,7 +220,8 @@ public function setTargetSslProxiesSetCertificateMapRequestResource($var) } /** - * Name of the TargetSslProxy resource whose CertificateMap is to be set. The name must be 1-63 characters long, and comply with RFC1035. + * Name of the TargetSslProxy resource whose CertificateMap is + * to be set. The name must be 1-63 characters long, and comply with RFC1035. * * Generated from protobuf field string target_ssl_proxy = 338795853 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -188,7 +232,8 @@ public function getTargetSslProxy() } /** - * Name of the TargetSslProxy resource whose CertificateMap is to be set. The name must be 1-63 characters long, and comply with RFC1035. + * Name of the TargetSslProxy resource whose CertificateMap is + * to be set. The name must be 1-63 characters long, and comply with RFC1035. * * Generated from protobuf field string target_ssl_proxy = 338795853 [(.google.api.field_behavior) = REQUIRED]; * @param string $var diff --git a/Compute/src/V1/SetCloudArmorTierProjectRequest.php b/Compute/src/V1/SetCloudArmorTierProjectRequest.php index cf077f115f21..e4cb62a02931 100644 --- a/Compute/src/V1/SetCloudArmorTierProjectRequest.php +++ b/Compute/src/V1/SetCloudArmorTierProjectRequest.php @@ -28,7 +28,17 @@ class SetCloudArmorTierProjectRequest extends \Google\Protobuf\Internal\Message */ protected $projects_set_cloud_armor_tier_request_resource = null; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -60,7 +70,17 @@ public static function build(string $project, \Google\Cloud\Compute\V1\ProjectsS * @type \Google\Cloud\Compute\V1\ProjectsSetCloudArmorTierRequest $projects_set_cloud_armor_tier_request_resource * The body resource for this request * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -131,7 +151,17 @@ public function setProjectsSetCloudArmorTierRequestResource($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -152,7 +182,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/SetCommonInstanceMetadataOperationMetadata.php b/Compute/src/V1/SetCommonInstanceMetadataOperationMetadata.php index 12daa17fa638..7b3099ea6893 100644 --- a/Compute/src/V1/SetCommonInstanceMetadataOperationMetadata.php +++ b/Compute/src/V1/SetCommonInstanceMetadataOperationMetadata.php @@ -21,7 +21,8 @@ class SetCommonInstanceMetadataOperationMetadata extends \Google\Protobuf\Intern */ protected $client_operation_id = null; /** - * [Output Only] Status information per location (location name is key). Example key: zones/us-central1-a + * [Output Only] Status information per location (location name is key). + * Example key: zones/us-central1-a * * Generated from protobuf field map per_location_operations = 408987796; */ @@ -36,7 +37,8 @@ class SetCommonInstanceMetadataOperationMetadata extends \Google\Protobuf\Intern * @type string $client_operation_id * [Output Only] The client operation id. * @type array|\Google\Protobuf\Internal\MapField $per_location_operations - * [Output Only] Status information per location (location name is key). Example key: zones/us-central1-a + * [Output Only] Status information per location (location name is key). + * Example key: zones/us-central1-a * } */ public function __construct($data = NULL) { @@ -81,7 +83,8 @@ public function setClientOperationId($var) } /** - * [Output Only] Status information per location (location name is key). Example key: zones/us-central1-a + * [Output Only] Status information per location (location name is key). + * Example key: zones/us-central1-a * * Generated from protobuf field map per_location_operations = 408987796; * @return \Google\Protobuf\Internal\MapField @@ -92,7 +95,8 @@ public function getPerLocationOperations() } /** - * [Output Only] Status information per location (location name is key). Example key: zones/us-central1-a + * [Output Only] Status information per location (location name is key). + * Example key: zones/us-central1-a * * Generated from protobuf field map per_location_operations = 408987796; * @param array|\Google\Protobuf\Internal\MapField $var diff --git a/Compute/src/V1/SetCommonInstanceMetadataOperationMetadataPerLocationOperationInfo.php b/Compute/src/V1/SetCommonInstanceMetadataOperationMetadataPerLocationOperationInfo.php index c1e201b4e632..8412714fd7f2 100644 --- a/Compute/src/V1/SetCommonInstanceMetadataOperationMetadataPerLocationOperationInfo.php +++ b/Compute/src/V1/SetCommonInstanceMetadataOperationMetadataPerLocationOperationInfo.php @@ -15,13 +15,15 @@ class SetCommonInstanceMetadataOperationMetadataPerLocationOperationInfo extends \Google\Protobuf\Internal\Message { /** - * [Output Only] If state is `ABANDONED` or `FAILED`, this field is populated. + * [Output Only] If state is `ABANDONED` or `FAILED`, this field is + * populated. * * Generated from protobuf field optional .google.cloud.compute.v1.Status error = 96784904; */ protected $error = null; /** - * [Output Only] Status of the action, which can be one of the following: `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`. + * [Output Only] Status of the action, which can be one of the following: + * `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`. * Check the State enum for the list of possible values. * * Generated from protobuf field optional string state = 109757585; @@ -35,9 +37,11 @@ class SetCommonInstanceMetadataOperationMetadataPerLocationOperationInfo extends * Optional. Data for populating the Message object. * * @type \Google\Cloud\Compute\V1\Status $error - * [Output Only] If state is `ABANDONED` or `FAILED`, this field is populated. + * [Output Only] If state is `ABANDONED` or `FAILED`, this field is + * populated. * @type string $state - * [Output Only] Status of the action, which can be one of the following: `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`. + * [Output Only] Status of the action, which can be one of the following: + * `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`. * Check the State enum for the list of possible values. * } */ @@ -47,7 +51,8 @@ public function __construct($data = NULL) { } /** - * [Output Only] If state is `ABANDONED` or `FAILED`, this field is populated. + * [Output Only] If state is `ABANDONED` or `FAILED`, this field is + * populated. * * Generated from protobuf field optional .google.cloud.compute.v1.Status error = 96784904; * @return \Google\Cloud\Compute\V1\Status|null @@ -68,7 +73,8 @@ public function clearError() } /** - * [Output Only] If state is `ABANDONED` or `FAILED`, this field is populated. + * [Output Only] If state is `ABANDONED` or `FAILED`, this field is + * populated. * * Generated from protobuf field optional .google.cloud.compute.v1.Status error = 96784904; * @param \Google\Cloud\Compute\V1\Status $var @@ -83,7 +89,8 @@ public function setError($var) } /** - * [Output Only] Status of the action, which can be one of the following: `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`. + * [Output Only] Status of the action, which can be one of the following: + * `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`. * Check the State enum for the list of possible values. * * Generated from protobuf field optional string state = 109757585; @@ -105,7 +112,8 @@ public function clearState() } /** - * [Output Only] Status of the action, which can be one of the following: `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`. + * [Output Only] Status of the action, which can be one of the following: + * `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`. * Check the State enum for the list of possible values. * * Generated from protobuf field optional string state = 109757585; diff --git a/Compute/src/V1/SetCommonInstanceMetadataOperationMetadataPerLocationOperationInfo/State.php b/Compute/src/V1/SetCommonInstanceMetadataOperationMetadataPerLocationOperationInfo/State.php index 825b483f7836..81716390f28c 100644 --- a/Compute/src/V1/SetCommonInstanceMetadataOperationMetadataPerLocationOperationInfo/State.php +++ b/Compute/src/V1/SetCommonInstanceMetadataOperationMetadataPerLocationOperationInfo/State.php @@ -7,7 +7,8 @@ use UnexpectedValueException; /** - * [Output Only] Status of the action, which can be one of the following: `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`. + * [Output Only] Status of the action, which can be one of the following: + * `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`. * * Protobuf type google.cloud.compute.v1.SetCommonInstanceMetadataOperationMetadataPerLocationOperationInfo.State */ diff --git a/Compute/src/V1/SetCommonInstanceMetadataProjectRequest.php b/Compute/src/V1/SetCommonInstanceMetadataProjectRequest.php index 3be4ce6e5399..6b77cccd56f5 100644 --- a/Compute/src/V1/SetCommonInstanceMetadataProjectRequest.php +++ b/Compute/src/V1/SetCommonInstanceMetadataProjectRequest.php @@ -28,7 +28,17 @@ class SetCommonInstanceMetadataProjectRequest extends \Google\Protobuf\Internal\ */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -60,7 +70,17 @@ public static function build(string $project, \Google\Cloud\Compute\V1\Metadata * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -131,7 +151,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -152,7 +182,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/SetDefaultNetworkTierProjectRequest.php b/Compute/src/V1/SetDefaultNetworkTierProjectRequest.php index ed6f71483c4e..6c7d3dd265e5 100644 --- a/Compute/src/V1/SetDefaultNetworkTierProjectRequest.php +++ b/Compute/src/V1/SetDefaultNetworkTierProjectRequest.php @@ -28,7 +28,17 @@ class SetDefaultNetworkTierProjectRequest extends \Google\Protobuf\Internal\Mess */ protected $projects_set_default_network_tier_request_resource = null; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -60,7 +70,17 @@ public static function build(string $project, \Google\Cloud\Compute\V1\ProjectsS * @type \Google\Cloud\Compute\V1\ProjectsSetDefaultNetworkTierRequest $projects_set_default_network_tier_request_resource * The body resource for this request * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -131,7 +151,17 @@ public function setProjectsSetDefaultNetworkTierRequestResource($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -152,7 +182,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/SetDeletionProtectionInstanceRequest.php b/Compute/src/V1/SetDeletionProtectionInstanceRequest.php index 954f192e2df8..426ca8c81190 100644 --- a/Compute/src/V1/SetDeletionProtectionInstanceRequest.php +++ b/Compute/src/V1/SetDeletionProtectionInstanceRequest.php @@ -28,7 +28,17 @@ class SetDeletionProtectionInstanceRequest extends \Google\Protobuf\Internal\Mes */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -74,7 +84,17 @@ public static function build(string $project, string $zone, string $resource): s * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $resource * Name or id of the resource for this request. * @type string $zone @@ -149,7 +169,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -170,7 +200,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/SetDiskAutoDeleteInstanceRequest.php b/Compute/src/V1/SetDiskAutoDeleteInstanceRequest.php index 76ee56d6b511..cc140bdd65db 100644 --- a/Compute/src/V1/SetDiskAutoDeleteInstanceRequest.php +++ b/Compute/src/V1/SetDiskAutoDeleteInstanceRequest.php @@ -22,7 +22,8 @@ class SetDiskAutoDeleteInstanceRequest extends \Google\Protobuf\Internal\Message */ protected $auto_delete = false; /** - * The device name of the disk to modify. Make a get() request on the instance to view currently attached disks and device names. + * The device name of the disk to modify. Make a get() request + * on the instance to view currently attached disks and device names. * * Generated from protobuf field string device_name = 67541716 [(.google.api.field_behavior) = REQUIRED]; */ @@ -40,7 +41,17 @@ class SetDiskAutoDeleteInstanceRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -57,7 +68,8 @@ class SetDiskAutoDeleteInstanceRequest extends \Google\Protobuf\Internal\Message * @param string $zone The name of the zone for this request. * @param string $instance The instance name for this request. * @param bool $autoDelete Whether to auto-delete the disk when the instance is deleted. - * @param string $deviceName The device name of the disk to modify. Make a get() request on the instance to view currently attached disks and device names. + * @param string $deviceName The device name of the disk to modify. Make a get() request + * on the instance to view currently attached disks and device names. * * @return \Google\Cloud\Compute\V1\SetDiskAutoDeleteInstanceRequest * @@ -82,13 +94,24 @@ public static function build(string $project, string $zone, string $instance, bo * @type bool $auto_delete * Whether to auto-delete the disk when the instance is deleted. * @type string $device_name - * The device name of the disk to modify. Make a get() request on the instance to view currently attached disks and device names. + * The device name of the disk to modify. Make a get() request + * on the instance to view currently attached disks and device names. * @type string $instance * The instance name for this request. * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $zone * The name of the zone for this request. * } @@ -125,7 +148,8 @@ public function setAutoDelete($var) } /** - * The device name of the disk to modify. Make a get() request on the instance to view currently attached disks and device names. + * The device name of the disk to modify. Make a get() request + * on the instance to view currently attached disks and device names. * * Generated from protobuf field string device_name = 67541716 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -136,7 +160,8 @@ public function getDeviceName() } /** - * The device name of the disk to modify. Make a get() request on the instance to view currently attached disks and device names. + * The device name of the disk to modify. Make a get() request + * on the instance to view currently attached disks and device names. * * Generated from protobuf field string device_name = 67541716 [(.google.api.field_behavior) = REQUIRED]; * @param string $var @@ -203,7 +228,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -224,7 +259,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/SetEdgeSecurityPolicyBackendBucketRequest.php b/Compute/src/V1/SetEdgeSecurityPolicyBackendBucketRequest.php index 1315d8982b4e..ad2521ca06cc 100644 --- a/Compute/src/V1/SetEdgeSecurityPolicyBackendBucketRequest.php +++ b/Compute/src/V1/SetEdgeSecurityPolicyBackendBucketRequest.php @@ -16,7 +16,8 @@ class SetEdgeSecurityPolicyBackendBucketRequest extends \Google\Protobuf\Internal\Message { /** - * Name of the BackendBucket resource to which the security policy should be set. The name should conform to RFC1035. + * Name of the BackendBucket resource to which the security policy should be + * set. The name should conform to RFC1035. * * Generated from protobuf field string backend_bucket = 91714037 [(.google.api.field_behavior) = REQUIRED]; */ @@ -28,7 +29,17 @@ class SetEdgeSecurityPolicyBackendBucketRequest extends \Google\Protobuf\Interna */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -42,7 +53,8 @@ class SetEdgeSecurityPolicyBackendBucketRequest extends \Google\Protobuf\Interna /** * @param string $project Project ID for this request. - * @param string $backendBucket Name of the BackendBucket resource to which the security policy should be set. The name should conform to RFC1035. + * @param string $backendBucket Name of the BackendBucket resource to which the security policy should be + * set. The name should conform to RFC1035. * @param \Google\Cloud\Compute\V1\SecurityPolicyReference $securityPolicyReferenceResource The body resource for this request * * @return \Google\Cloud\Compute\V1\SetEdgeSecurityPolicyBackendBucketRequest @@ -64,11 +76,22 @@ public static function build(string $project, string $backendBucket, \Google\Clo * Optional. Data for populating the Message object. * * @type string $backend_bucket - * Name of the BackendBucket resource to which the security policy should be set. The name should conform to RFC1035. + * Name of the BackendBucket resource to which the security policy should be + * set. The name should conform to RFC1035. * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type \Google\Cloud\Compute\V1\SecurityPolicyReference $security_policy_reference_resource * The body resource for this request * } @@ -79,7 +102,8 @@ public function __construct($data = NULL) { } /** - * Name of the BackendBucket resource to which the security policy should be set. The name should conform to RFC1035. + * Name of the BackendBucket resource to which the security policy should be + * set. The name should conform to RFC1035. * * Generated from protobuf field string backend_bucket = 91714037 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -90,7 +114,8 @@ public function getBackendBucket() } /** - * Name of the BackendBucket resource to which the security policy should be set. The name should conform to RFC1035. + * Name of the BackendBucket resource to which the security policy should be + * set. The name should conform to RFC1035. * * Generated from protobuf field string backend_bucket = 91714037 [(.google.api.field_behavior) = REQUIRED]; * @param string $var @@ -131,7 +156,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -152,7 +187,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/SetEdgeSecurityPolicyBackendServiceRequest.php b/Compute/src/V1/SetEdgeSecurityPolicyBackendServiceRequest.php index 798af923ee68..2df04fb92e72 100644 --- a/Compute/src/V1/SetEdgeSecurityPolicyBackendServiceRequest.php +++ b/Compute/src/V1/SetEdgeSecurityPolicyBackendServiceRequest.php @@ -16,7 +16,8 @@ class SetEdgeSecurityPolicyBackendServiceRequest extends \Google\Protobuf\Internal\Message { /** - * Name of the BackendService resource to which the edge security policy should be set. The name should conform to RFC1035. + * Name of the BackendService resource to which the edge security policy + * should be set. The name should conform to RFC1035. * * Generated from protobuf field string backend_service = 306946058 [(.google.api.field_behavior) = REQUIRED]; */ @@ -28,7 +29,17 @@ class SetEdgeSecurityPolicyBackendServiceRequest extends \Google\Protobuf\Intern */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -42,7 +53,8 @@ class SetEdgeSecurityPolicyBackendServiceRequest extends \Google\Protobuf\Intern /** * @param string $project Project ID for this request. - * @param string $backendService Name of the BackendService resource to which the edge security policy should be set. The name should conform to RFC1035. + * @param string $backendService Name of the BackendService resource to which the edge security policy + * should be set. The name should conform to RFC1035. * @param \Google\Cloud\Compute\V1\SecurityPolicyReference $securityPolicyReferenceResource The body resource for this request * * @return \Google\Cloud\Compute\V1\SetEdgeSecurityPolicyBackendServiceRequest @@ -64,11 +76,22 @@ public static function build(string $project, string $backendService, \Google\Cl * Optional. Data for populating the Message object. * * @type string $backend_service - * Name of the BackendService resource to which the edge security policy should be set. The name should conform to RFC1035. + * Name of the BackendService resource to which the edge security policy + * should be set. The name should conform to RFC1035. * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type \Google\Cloud\Compute\V1\SecurityPolicyReference $security_policy_reference_resource * The body resource for this request * } @@ -79,7 +102,8 @@ public function __construct($data = NULL) { } /** - * Name of the BackendService resource to which the edge security policy should be set. The name should conform to RFC1035. + * Name of the BackendService resource to which the edge security policy + * should be set. The name should conform to RFC1035. * * Generated from protobuf field string backend_service = 306946058 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -90,7 +114,8 @@ public function getBackendService() } /** - * Name of the BackendService resource to which the edge security policy should be set. The name should conform to RFC1035. + * Name of the BackendService resource to which the edge security policy + * should be set. The name should conform to RFC1035. * * Generated from protobuf field string backend_service = 306946058 [(.google.api.field_behavior) = REQUIRED]; * @param string $var @@ -131,7 +156,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -152,7 +187,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/SetIamPolicyReservationBlockRequest.php b/Compute/src/V1/SetIamPolicyReservationBlockRequest.php new file mode 100644 index 000000000000..3bdb5549b57d --- /dev/null +++ b/Compute/src/V1/SetIamPolicyReservationBlockRequest.php @@ -0,0 +1,234 @@ +google.cloud.compute.v1.SetIamPolicyReservationBlockRequest + */ +class SetIamPolicyReservationBlockRequest extends \Google\Protobuf\Internal\Message +{ + /** + * Name or id of parent resource of the resource for this request. + * + * Generated from protobuf field string parent_resource = 18091011 [(.google.api.field_behavior) = REQUIRED]; + */ + protected $parent_resource = ''; + /** + * Project ID for this request. + * + * Generated from protobuf field string project = 227560217 [(.google.api.field_behavior) = REQUIRED]; + */ + protected $project = ''; + /** + * Name or id of the resource for this request. + * + * Generated from protobuf field string resource = 195806222 [(.google.api.field_behavior) = REQUIRED]; + */ + protected $resource = ''; + /** + * The name of the zone for this request. + * + * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED]; + */ + protected $zone = ''; + /** + * The body resource for this request + * + * Generated from protobuf field .google.cloud.compute.v1.ZoneSetNestedPolicyRequest zone_set_nested_policy_request_resource = 266352851 [(.google.api.field_behavior) = REQUIRED]; + */ + protected $zone_set_nested_policy_request_resource = null; + + /** + * @param string $project Project ID for this request. + * @param string $zone The name of the zone for this request. + * @param string $parentResource Name or id of parent resource of the resource for this request. + * @param string $resource Name or id of the resource for this request. + * @param \Google\Cloud\Compute\V1\ZoneSetNestedPolicyRequest $zoneSetNestedPolicyRequestResource The body resource for this request + * + * @return \Google\Cloud\Compute\V1\SetIamPolicyReservationBlockRequest + * + * @experimental + */ + public static function build(string $project, string $zone, string $parentResource, string $resource, \Google\Cloud\Compute\V1\ZoneSetNestedPolicyRequest $zoneSetNestedPolicyRequestResource): self + { + return (new self()) + ->setProject($project) + ->setZone($zone) + ->setParentResource($parentResource) + ->setResource($resource) + ->setZoneSetNestedPolicyRequestResource($zoneSetNestedPolicyRequestResource); + } + + /** + * Constructor. + * + * @param array $data { + * Optional. Data for populating the Message object. + * + * @type string $parent_resource + * Name or id of parent resource of the resource for this request. + * @type string $project + * Project ID for this request. + * @type string $resource + * Name or id of the resource for this request. + * @type string $zone + * The name of the zone for this request. + * @type \Google\Cloud\Compute\V1\ZoneSetNestedPolicyRequest $zone_set_nested_policy_request_resource + * The body resource for this request + * } + */ + public function __construct($data = NULL) { + \GPBMetadata\Google\Cloud\Compute\V1\Compute::initOnce(); + parent::__construct($data); + } + + /** + * Name or id of parent resource of the resource for this request. + * + * Generated from protobuf field string parent_resource = 18091011 [(.google.api.field_behavior) = REQUIRED]; + * @return string + */ + public function getParentResource() + { + return $this->parent_resource; + } + + /** + * Name or id of parent resource of the resource for this request. + * + * Generated from protobuf field string parent_resource = 18091011 [(.google.api.field_behavior) = REQUIRED]; + * @param string $var + * @return $this + */ + public function setParentResource($var) + { + GPBUtil::checkString($var, True); + $this->parent_resource = $var; + + return $this; + } + + /** + * Project ID for this request. + * + * Generated from protobuf field string project = 227560217 [(.google.api.field_behavior) = REQUIRED]; + * @return string + */ + public function getProject() + { + return $this->project; + } + + /** + * Project ID for this request. + * + * Generated from protobuf field string project = 227560217 [(.google.api.field_behavior) = REQUIRED]; + * @param string $var + * @return $this + */ + public function setProject($var) + { + GPBUtil::checkString($var, True); + $this->project = $var; + + return $this; + } + + /** + * Name or id of the resource for this request. + * + * Generated from protobuf field string resource = 195806222 [(.google.api.field_behavior) = REQUIRED]; + * @return string + */ + public function getResource() + { + return $this->resource; + } + + /** + * Name or id of the resource for this request. + * + * Generated from protobuf field string resource = 195806222 [(.google.api.field_behavior) = REQUIRED]; + * @param string $var + * @return $this + */ + public function setResource($var) + { + GPBUtil::checkString($var, True); + $this->resource = $var; + + return $this; + } + + /** + * The name of the zone for this request. + * + * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED]; + * @return string + */ + public function getZone() + { + return $this->zone; + } + + /** + * The name of the zone for this request. + * + * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED]; + * @param string $var + * @return $this + */ + public function setZone($var) + { + GPBUtil::checkString($var, True); + $this->zone = $var; + + return $this; + } + + /** + * The body resource for this request + * + * Generated from protobuf field .google.cloud.compute.v1.ZoneSetNestedPolicyRequest zone_set_nested_policy_request_resource = 266352851 [(.google.api.field_behavior) = REQUIRED]; + * @return \Google\Cloud\Compute\V1\ZoneSetNestedPolicyRequest|null + */ + public function getZoneSetNestedPolicyRequestResource() + { + return $this->zone_set_nested_policy_request_resource; + } + + public function hasZoneSetNestedPolicyRequestResource() + { + return isset($this->zone_set_nested_policy_request_resource); + } + + public function clearZoneSetNestedPolicyRequestResource() + { + unset($this->zone_set_nested_policy_request_resource); + } + + /** + * The body resource for this request + * + * Generated from protobuf field .google.cloud.compute.v1.ZoneSetNestedPolicyRequest zone_set_nested_policy_request_resource = 266352851 [(.google.api.field_behavior) = REQUIRED]; + * @param \Google\Cloud\Compute\V1\ZoneSetNestedPolicyRequest $var + * @return $this + */ + public function setZoneSetNestedPolicyRequestResource($var) + { + GPBUtil::checkMessage($var, \Google\Cloud\Compute\V1\ZoneSetNestedPolicyRequest::class); + $this->zone_set_nested_policy_request_resource = $var; + + return $this; + } + +} + diff --git a/Compute/src/V1/SetIamPolicyReservationSubBlockRequest.php b/Compute/src/V1/SetIamPolicyReservationSubBlockRequest.php new file mode 100644 index 000000000000..7f388852c16b --- /dev/null +++ b/Compute/src/V1/SetIamPolicyReservationSubBlockRequest.php @@ -0,0 +1,234 @@ +google.cloud.compute.v1.SetIamPolicyReservationSubBlockRequest + */ +class SetIamPolicyReservationSubBlockRequest extends \Google\Protobuf\Internal\Message +{ + /** + * Name or id of parent resource of the resource for this request. + * + * Generated from protobuf field string parent_resource = 18091011 [(.google.api.field_behavior) = REQUIRED]; + */ + protected $parent_resource = ''; + /** + * Project ID for this request. + * + * Generated from protobuf field string project = 227560217 [(.google.api.field_behavior) = REQUIRED]; + */ + protected $project = ''; + /** + * Name or id of the resource for this request. + * + * Generated from protobuf field string resource = 195806222 [(.google.api.field_behavior) = REQUIRED]; + */ + protected $resource = ''; + /** + * The name of the zone for this request. + * + * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED]; + */ + protected $zone = ''; + /** + * The body resource for this request + * + * Generated from protobuf field .google.cloud.compute.v1.ZoneSetNestedPolicyRequest zone_set_nested_policy_request_resource = 266352851 [(.google.api.field_behavior) = REQUIRED]; + */ + protected $zone_set_nested_policy_request_resource = null; + + /** + * @param string $project Project ID for this request. + * @param string $zone The name of the zone for this request. + * @param string $parentResource Name or id of parent resource of the resource for this request. + * @param string $resource Name or id of the resource for this request. + * @param \Google\Cloud\Compute\V1\ZoneSetNestedPolicyRequest $zoneSetNestedPolicyRequestResource The body resource for this request + * + * @return \Google\Cloud\Compute\V1\SetIamPolicyReservationSubBlockRequest + * + * @experimental + */ + public static function build(string $project, string $zone, string $parentResource, string $resource, \Google\Cloud\Compute\V1\ZoneSetNestedPolicyRequest $zoneSetNestedPolicyRequestResource): self + { + return (new self()) + ->setProject($project) + ->setZone($zone) + ->setParentResource($parentResource) + ->setResource($resource) + ->setZoneSetNestedPolicyRequestResource($zoneSetNestedPolicyRequestResource); + } + + /** + * Constructor. + * + * @param array $data { + * Optional. Data for populating the Message object. + * + * @type string $parent_resource + * Name or id of parent resource of the resource for this request. + * @type string $project + * Project ID for this request. + * @type string $resource + * Name or id of the resource for this request. + * @type string $zone + * The name of the zone for this request. + * @type \Google\Cloud\Compute\V1\ZoneSetNestedPolicyRequest $zone_set_nested_policy_request_resource + * The body resource for this request + * } + */ + public function __construct($data = NULL) { + \GPBMetadata\Google\Cloud\Compute\V1\Compute::initOnce(); + parent::__construct($data); + } + + /** + * Name or id of parent resource of the resource for this request. + * + * Generated from protobuf field string parent_resource = 18091011 [(.google.api.field_behavior) = REQUIRED]; + * @return string + */ + public function getParentResource() + { + return $this->parent_resource; + } + + /** + * Name or id of parent resource of the resource for this request. + * + * Generated from protobuf field string parent_resource = 18091011 [(.google.api.field_behavior) = REQUIRED]; + * @param string $var + * @return $this + */ + public function setParentResource($var) + { + GPBUtil::checkString($var, True); + $this->parent_resource = $var; + + return $this; + } + + /** + * Project ID for this request. + * + * Generated from protobuf field string project = 227560217 [(.google.api.field_behavior) = REQUIRED]; + * @return string + */ + public function getProject() + { + return $this->project; + } + + /** + * Project ID for this request. + * + * Generated from protobuf field string project = 227560217 [(.google.api.field_behavior) = REQUIRED]; + * @param string $var + * @return $this + */ + public function setProject($var) + { + GPBUtil::checkString($var, True); + $this->project = $var; + + return $this; + } + + /** + * Name or id of the resource for this request. + * + * Generated from protobuf field string resource = 195806222 [(.google.api.field_behavior) = REQUIRED]; + * @return string + */ + public function getResource() + { + return $this->resource; + } + + /** + * Name or id of the resource for this request. + * + * Generated from protobuf field string resource = 195806222 [(.google.api.field_behavior) = REQUIRED]; + * @param string $var + * @return $this + */ + public function setResource($var) + { + GPBUtil::checkString($var, True); + $this->resource = $var; + + return $this; + } + + /** + * The name of the zone for this request. + * + * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED]; + * @return string + */ + public function getZone() + { + return $this->zone; + } + + /** + * The name of the zone for this request. + * + * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED]; + * @param string $var + * @return $this + */ + public function setZone($var) + { + GPBUtil::checkString($var, True); + $this->zone = $var; + + return $this; + } + + /** + * The body resource for this request + * + * Generated from protobuf field .google.cloud.compute.v1.ZoneSetNestedPolicyRequest zone_set_nested_policy_request_resource = 266352851 [(.google.api.field_behavior) = REQUIRED]; + * @return \Google\Cloud\Compute\V1\ZoneSetNestedPolicyRequest|null + */ + public function getZoneSetNestedPolicyRequestResource() + { + return $this->zone_set_nested_policy_request_resource; + } + + public function hasZoneSetNestedPolicyRequestResource() + { + return isset($this->zone_set_nested_policy_request_resource); + } + + public function clearZoneSetNestedPolicyRequestResource() + { + unset($this->zone_set_nested_policy_request_resource); + } + + /** + * The body resource for this request + * + * Generated from protobuf field .google.cloud.compute.v1.ZoneSetNestedPolicyRequest zone_set_nested_policy_request_resource = 266352851 [(.google.api.field_behavior) = REQUIRED]; + * @param \Google\Cloud\Compute\V1\ZoneSetNestedPolicyRequest $var + * @return $this + */ + public function setZoneSetNestedPolicyRequestResource($var) + { + GPBUtil::checkMessage($var, \Google\Cloud\Compute\V1\ZoneSetNestedPolicyRequest::class); + $this->zone_set_nested_policy_request_resource = $var; + + return $this; + } + +} + diff --git a/Compute/src/V1/SetInstanceTemplateInstanceGroupManagerRequest.php b/Compute/src/V1/SetInstanceTemplateInstanceGroupManagerRequest.php index 6c6e43c12b3b..7d2a0b89ac4d 100644 --- a/Compute/src/V1/SetInstanceTemplateInstanceGroupManagerRequest.php +++ b/Compute/src/V1/SetInstanceTemplateInstanceGroupManagerRequest.php @@ -34,13 +34,24 @@ class SetInstanceTemplateInstanceGroupManagerRequest extends \Google\Protobuf\In */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ protected $request_id = null; /** - * The name of the zone where the managed instance group is located. + * The name of thezone where the managed + * instance group is located. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; */ @@ -48,7 +59,8 @@ class SetInstanceTemplateInstanceGroupManagerRequest extends \Google\Protobuf\In /** * @param string $project Project ID for this request. - * @param string $zone The name of the zone where the managed instance group is located. + * @param string $zone The name of thezone where the managed + * instance group is located. * @param string $instanceGroupManager The name of the managed instance group. * @param \Google\Cloud\Compute\V1\InstanceGroupManagersSetInstanceTemplateRequest $instanceGroupManagersSetInstanceTemplateRequestResource The body resource for this request * @@ -78,9 +90,20 @@ public static function build(string $project, string $zone, string $instanceGrou * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $zone - * The name of the zone where the managed instance group is located. + * The name of thezone where the managed + * instance group is located. * } */ public function __construct($data = NULL) { @@ -177,7 +200,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -198,7 +231,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var @@ -213,7 +256,8 @@ public function setRequestId($var) } /** - * The name of the zone where the managed instance group is located. + * The name of thezone where the managed + * instance group is located. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; * @return string @@ -224,7 +268,8 @@ public function getZone() } /** - * The name of the zone where the managed instance group is located. + * The name of thezone where the managed + * instance group is located. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; * @param string $var diff --git a/Compute/src/V1/SetInstanceTemplateRegionInstanceGroupManagerRequest.php b/Compute/src/V1/SetInstanceTemplateRegionInstanceGroupManagerRequest.php index 45bf17b122af..13223b999710 100644 --- a/Compute/src/V1/SetInstanceTemplateRegionInstanceGroupManagerRequest.php +++ b/Compute/src/V1/SetInstanceTemplateRegionInstanceGroupManagerRequest.php @@ -40,7 +40,17 @@ class SetInstanceTemplateRegionInstanceGroupManagerRequest extends \Google\Proto */ protected $region_instance_group_managers_set_template_request_resource = null; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -80,7 +90,17 @@ public static function build(string $project, string $region, string $instanceGr * @type \Google\Cloud\Compute\V1\RegionInstanceGroupManagersSetTemplateRequest $region_instance_group_managers_set_template_request_resource * The body resource for this request * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -203,7 +223,17 @@ public function setRegionInstanceGroupManagersSetTemplateRequestResource($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -224,7 +254,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/SetLabelsAddressRequest.php b/Compute/src/V1/SetLabelsAddressRequest.php index aea44a151789..6a4cd84c4233 100644 --- a/Compute/src/V1/SetLabelsAddressRequest.php +++ b/Compute/src/V1/SetLabelsAddressRequest.php @@ -34,7 +34,17 @@ class SetLabelsAddressRequest extends \Google\Protobuf\Internal\Message */ protected $region_set_labels_request_resource = null; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -78,7 +88,17 @@ public static function build(string $project, string $region, string $resource, * @type \Google\Cloud\Compute\V1\RegionSetLabelsRequest $region_set_labels_request_resource * The body resource for this request * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $resource * Name or id of the resource for this request. * } @@ -177,7 +197,17 @@ public function setRegionSetLabelsRequestResource($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -198,7 +228,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/SetLabelsDiskRequest.php b/Compute/src/V1/SetLabelsDiskRequest.php index 59bac7b349bc..69c0bad95bcf 100644 --- a/Compute/src/V1/SetLabelsDiskRequest.php +++ b/Compute/src/V1/SetLabelsDiskRequest.php @@ -22,7 +22,17 @@ class SetLabelsDiskRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -74,7 +84,17 @@ public static function build(string $project, string $zone, string $resource, \G * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $resource * Name or id of the resource for this request. * @type string $zone @@ -115,7 +135,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -136,7 +166,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/SetLabelsForwardingRuleRequest.php b/Compute/src/V1/SetLabelsForwardingRuleRequest.php index 9834e154d045..6763be50c9e2 100644 --- a/Compute/src/V1/SetLabelsForwardingRuleRequest.php +++ b/Compute/src/V1/SetLabelsForwardingRuleRequest.php @@ -34,7 +34,17 @@ class SetLabelsForwardingRuleRequest extends \Google\Protobuf\Internal\Message */ protected $region_set_labels_request_resource = null; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -78,7 +88,17 @@ public static function build(string $project, string $region, string $resource, * @type \Google\Cloud\Compute\V1\RegionSetLabelsRequest $region_set_labels_request_resource * The body resource for this request * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $resource * Name or id of the resource for this request. * } @@ -177,7 +197,17 @@ public function setRegionSetLabelsRequestResource($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -198,7 +228,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/SetLabelsInstanceRequest.php b/Compute/src/V1/SetLabelsInstanceRequest.php index bc70186b2caf..5c260eb24d38 100644 --- a/Compute/src/V1/SetLabelsInstanceRequest.php +++ b/Compute/src/V1/SetLabelsInstanceRequest.php @@ -34,7 +34,17 @@ class SetLabelsInstanceRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -78,7 +88,17 @@ public static function build(string $project, string $zone, string $instance, \G * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $zone * The name of the zone for this request. * } @@ -177,7 +197,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -198,7 +228,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/SetLabelsInstantSnapshotRequest.php b/Compute/src/V1/SetLabelsInstantSnapshotRequest.php index ccfe551025cf..96a2a6305b95 100644 --- a/Compute/src/V1/SetLabelsInstantSnapshotRequest.php +++ b/Compute/src/V1/SetLabelsInstantSnapshotRequest.php @@ -22,7 +22,17 @@ class SetLabelsInstantSnapshotRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -74,7 +84,17 @@ public static function build(string $project, string $zone, string $resource, \G * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $resource * Name or id of the resource for this request. * @type string $zone @@ -115,7 +135,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -136,7 +166,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/SetLabelsInterconnectAttachmentRequest.php b/Compute/src/V1/SetLabelsInterconnectAttachmentRequest.php index 0b8aa5b2f851..2e79e4fd649b 100644 --- a/Compute/src/V1/SetLabelsInterconnectAttachmentRequest.php +++ b/Compute/src/V1/SetLabelsInterconnectAttachmentRequest.php @@ -34,7 +34,17 @@ class SetLabelsInterconnectAttachmentRequest extends \Google\Protobuf\Internal\M */ protected $region_set_labels_request_resource = null; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -78,7 +88,17 @@ public static function build(string $project, string $region, string $resource, * @type \Google\Cloud\Compute\V1\RegionSetLabelsRequest $region_set_labels_request_resource * The body resource for this request * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $resource * Name or id of the resource for this request. * } @@ -177,7 +197,17 @@ public function setRegionSetLabelsRequestResource($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -198,7 +228,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/SetLabelsRegionDiskRequest.php b/Compute/src/V1/SetLabelsRegionDiskRequest.php index a9af4a5a239e..ce0feee274dc 100644 --- a/Compute/src/V1/SetLabelsRegionDiskRequest.php +++ b/Compute/src/V1/SetLabelsRegionDiskRequest.php @@ -34,7 +34,17 @@ class SetLabelsRegionDiskRequest extends \Google\Protobuf\Internal\Message */ protected $region_set_labels_request_resource = null; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -78,7 +88,17 @@ public static function build(string $project, string $region, string $resource, * @type \Google\Cloud\Compute\V1\RegionSetLabelsRequest $region_set_labels_request_resource * The body resource for this request * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $resource * Name or id of the resource for this request. * } @@ -177,7 +197,17 @@ public function setRegionSetLabelsRequestResource($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -198,7 +228,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/SetLabelsRegionInstantSnapshotRequest.php b/Compute/src/V1/SetLabelsRegionInstantSnapshotRequest.php index f3317199bfd0..d24adf54774e 100644 --- a/Compute/src/V1/SetLabelsRegionInstantSnapshotRequest.php +++ b/Compute/src/V1/SetLabelsRegionInstantSnapshotRequest.php @@ -34,7 +34,17 @@ class SetLabelsRegionInstantSnapshotRequest extends \Google\Protobuf\Internal\Me */ protected $region_set_labels_request_resource = null; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -78,7 +88,17 @@ public static function build(string $project, string $region, string $resource, * @type \Google\Cloud\Compute\V1\RegionSetLabelsRequest $region_set_labels_request_resource * The body resource for this request * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $resource * Name or id of the resource for this request. * } @@ -177,7 +197,17 @@ public function setRegionSetLabelsRequestResource($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -198,7 +228,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/SetLabelsRegionSecurityPolicyRequest.php b/Compute/src/V1/SetLabelsRegionSecurityPolicyRequest.php index 013d35adf77e..f20000e574ca 100644 --- a/Compute/src/V1/SetLabelsRegionSecurityPolicyRequest.php +++ b/Compute/src/V1/SetLabelsRegionSecurityPolicyRequest.php @@ -34,7 +34,17 @@ class SetLabelsRegionSecurityPolicyRequest extends \Google\Protobuf\Internal\Mes */ protected $region_set_labels_request_resource = null; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -78,7 +88,17 @@ public static function build(string $project, string $region, string $resource, * @type \Google\Cloud\Compute\V1\RegionSetLabelsRequest $region_set_labels_request_resource * The body resource for this request * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $resource * Name or id of the resource for this request. * } @@ -177,7 +197,17 @@ public function setRegionSetLabelsRequestResource($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -198,7 +228,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/SetLabelsTargetVpnGatewayRequest.php b/Compute/src/V1/SetLabelsTargetVpnGatewayRequest.php index ee0d4585d29a..7e421882584d 100644 --- a/Compute/src/V1/SetLabelsTargetVpnGatewayRequest.php +++ b/Compute/src/V1/SetLabelsTargetVpnGatewayRequest.php @@ -34,7 +34,17 @@ class SetLabelsTargetVpnGatewayRequest extends \Google\Protobuf\Internal\Message */ protected $region_set_labels_request_resource = null; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -78,7 +88,17 @@ public static function build(string $project, string $region, string $resource, * @type \Google\Cloud\Compute\V1\RegionSetLabelsRequest $region_set_labels_request_resource * The body resource for this request * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $resource * Name or id of the resource for this request. * } @@ -177,7 +197,17 @@ public function setRegionSetLabelsRequestResource($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -198,7 +228,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/SetLabelsVpnGatewayRequest.php b/Compute/src/V1/SetLabelsVpnGatewayRequest.php index cffb7feacc24..682cd6b932bf 100644 --- a/Compute/src/V1/SetLabelsVpnGatewayRequest.php +++ b/Compute/src/V1/SetLabelsVpnGatewayRequest.php @@ -34,7 +34,17 @@ class SetLabelsVpnGatewayRequest extends \Google\Protobuf\Internal\Message */ protected $region_set_labels_request_resource = null; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -78,7 +88,17 @@ public static function build(string $project, string $region, string $resource, * @type \Google\Cloud\Compute\V1\RegionSetLabelsRequest $region_set_labels_request_resource * The body resource for this request * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $resource * Name or id of the resource for this request. * } @@ -177,7 +197,17 @@ public function setRegionSetLabelsRequestResource($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -198,7 +228,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/SetLabelsVpnTunnelRequest.php b/Compute/src/V1/SetLabelsVpnTunnelRequest.php index 980a2df715e4..2931bd1a7512 100644 --- a/Compute/src/V1/SetLabelsVpnTunnelRequest.php +++ b/Compute/src/V1/SetLabelsVpnTunnelRequest.php @@ -34,7 +34,17 @@ class SetLabelsVpnTunnelRequest extends \Google\Protobuf\Internal\Message */ protected $region_set_labels_request_resource = null; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -78,7 +88,17 @@ public static function build(string $project, string $region, string $resource, * @type \Google\Cloud\Compute\V1\RegionSetLabelsRequest $region_set_labels_request_resource * The body resource for this request * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $resource * Name or id of the resource for this request. * } @@ -177,7 +197,17 @@ public function setRegionSetLabelsRequestResource($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -198,7 +228,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/SetMachineResourcesInstanceRequest.php b/Compute/src/V1/SetMachineResourcesInstanceRequest.php index 557ed2176874..e47fc6fb5e7b 100644 --- a/Compute/src/V1/SetMachineResourcesInstanceRequest.php +++ b/Compute/src/V1/SetMachineResourcesInstanceRequest.php @@ -34,7 +34,17 @@ class SetMachineResourcesInstanceRequest extends \Google\Protobuf\Internal\Messa */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -78,7 +88,17 @@ public static function build(string $project, string $zone, string $instance, \G * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $zone * The name of the zone for this request. * } @@ -177,7 +197,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -198,7 +228,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/SetMachineTypeInstanceRequest.php b/Compute/src/V1/SetMachineTypeInstanceRequest.php index b8cd1141e994..5ada54c00bc2 100644 --- a/Compute/src/V1/SetMachineTypeInstanceRequest.php +++ b/Compute/src/V1/SetMachineTypeInstanceRequest.php @@ -34,7 +34,17 @@ class SetMachineTypeInstanceRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -78,7 +88,17 @@ public static function build(string $project, string $zone, string $instance, \G * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $zone * The name of the zone for this request. * } @@ -177,7 +197,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -198,7 +228,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/SetMetadataInstanceRequest.php b/Compute/src/V1/SetMetadataInstanceRequest.php index 503e741d9a96..abb37f2cd73c 100644 --- a/Compute/src/V1/SetMetadataInstanceRequest.php +++ b/Compute/src/V1/SetMetadataInstanceRequest.php @@ -34,7 +34,17 @@ class SetMetadataInstanceRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -78,7 +88,17 @@ public static function build(string $project, string $zone, string $instance, \G * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $zone * The name of the zone for this request. * } @@ -177,7 +197,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -198,7 +228,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/SetMinCpuPlatformInstanceRequest.php b/Compute/src/V1/SetMinCpuPlatformInstanceRequest.php index f4c67ce76ea1..a00f2fa0ca4f 100644 --- a/Compute/src/V1/SetMinCpuPlatformInstanceRequest.php +++ b/Compute/src/V1/SetMinCpuPlatformInstanceRequest.php @@ -34,7 +34,17 @@ class SetMinCpuPlatformInstanceRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -78,7 +88,17 @@ public static function build(string $project, string $zone, string $instance, \G * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $zone * The name of the zone for this request. * } @@ -177,7 +197,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -198,7 +228,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/SetNameInstanceRequest.php b/Compute/src/V1/SetNameInstanceRequest.php index 9817ad22a65c..ff3f9da46faa 100644 --- a/Compute/src/V1/SetNameInstanceRequest.php +++ b/Compute/src/V1/SetNameInstanceRequest.php @@ -34,7 +34,17 @@ class SetNameInstanceRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -78,7 +88,17 @@ public static function build(string $project, string $zone, string $instance, \G * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $zone * The name of the zone for this request. * } @@ -177,7 +197,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -198,7 +228,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/SetNamedPortsInstanceGroupRequest.php b/Compute/src/V1/SetNamedPortsInstanceGroupRequest.php index 2871f2bd7132..37f41a17c02e 100644 --- a/Compute/src/V1/SetNamedPortsInstanceGroupRequest.php +++ b/Compute/src/V1/SetNamedPortsInstanceGroupRequest.php @@ -34,13 +34,24 @@ class SetNamedPortsInstanceGroupRequest extends \Google\Protobuf\Internal\Messag */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ protected $request_id = null; /** - * The name of the zone where the instance group is located. + * The name of the zone + * where the instance group is located. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; */ @@ -48,7 +59,8 @@ class SetNamedPortsInstanceGroupRequest extends \Google\Protobuf\Internal\Messag /** * @param string $project Project ID for this request. - * @param string $zone The name of the zone where the instance group is located. + * @param string $zone The name of the zone + * where the instance group is located. * @param string $instanceGroup The name of the instance group where the named ports are updated. * @param \Google\Cloud\Compute\V1\InstanceGroupsSetNamedPortsRequest $instanceGroupsSetNamedPortsRequestResource The body resource for this request * @@ -78,9 +90,20 @@ public static function build(string $project, string $zone, string $instanceGrou * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $zone - * The name of the zone where the instance group is located. + * The name of the zone + * where the instance group is located. * } */ public function __construct($data = NULL) { @@ -177,7 +200,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -198,7 +231,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var @@ -213,7 +256,8 @@ public function setRequestId($var) } /** - * The name of the zone where the instance group is located. + * The name of the zone + * where the instance group is located. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; * @return string @@ -224,7 +268,8 @@ public function getZone() } /** - * The name of the zone where the instance group is located. + * The name of the zone + * where the instance group is located. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; * @param string $var diff --git a/Compute/src/V1/SetNamedPortsRegionInstanceGroupRequest.php b/Compute/src/V1/SetNamedPortsRegionInstanceGroupRequest.php index b10aa0c00f96..caee49d95a39 100644 --- a/Compute/src/V1/SetNamedPortsRegionInstanceGroupRequest.php +++ b/Compute/src/V1/SetNamedPortsRegionInstanceGroupRequest.php @@ -40,7 +40,17 @@ class SetNamedPortsRegionInstanceGroupRequest extends \Google\Protobuf\Internal\ */ protected $region_instance_groups_set_named_ports_request_resource = null; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -80,7 +90,17 @@ public static function build(string $project, string $region, string $instanceGr * @type \Google\Cloud\Compute\V1\RegionInstanceGroupsSetNamedPortsRequest $region_instance_groups_set_named_ports_request_resource * The body resource for this request * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -203,7 +223,17 @@ public function setRegionInstanceGroupsSetNamedPortsRequestResource($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -224,7 +254,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/SetNodeTemplateNodeGroupRequest.php b/Compute/src/V1/SetNodeTemplateNodeGroupRequest.php index 25178cd04561..7c854ca22dde 100644 --- a/Compute/src/V1/SetNodeTemplateNodeGroupRequest.php +++ b/Compute/src/V1/SetNodeTemplateNodeGroupRequest.php @@ -34,7 +34,17 @@ class SetNodeTemplateNodeGroupRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -78,7 +88,17 @@ public static function build(string $project, string $zone, string $nodeGroup, \ * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $zone * The name of the zone for this request. * } @@ -177,7 +197,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -198,7 +228,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/SetPrivateIpGoogleAccessSubnetworkRequest.php b/Compute/src/V1/SetPrivateIpGoogleAccessSubnetworkRequest.php index ba10d41e4808..5ff0d8023a81 100644 --- a/Compute/src/V1/SetPrivateIpGoogleAccessSubnetworkRequest.php +++ b/Compute/src/V1/SetPrivateIpGoogleAccessSubnetworkRequest.php @@ -28,7 +28,17 @@ class SetPrivateIpGoogleAccessSubnetworkRequest extends \Google\Protobuf\Interna */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -76,7 +86,17 @@ public static function build(string $project, string $region, string $subnetwork * @type string $region * Name of the region scoping this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $subnetwork * Name of the Subnetwork resource. * @type \Google\Cloud\Compute\V1\SubnetworksSetPrivateIpGoogleAccessRequest $subnetworks_set_private_ip_google_access_request_resource @@ -141,7 +161,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -162,7 +192,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/SetProxyHeaderTargetSslProxyRequest.php b/Compute/src/V1/SetProxyHeaderTargetSslProxyRequest.php index 3bfab1f2bb3e..3bac017e3cb4 100644 --- a/Compute/src/V1/SetProxyHeaderTargetSslProxyRequest.php +++ b/Compute/src/V1/SetProxyHeaderTargetSslProxyRequest.php @@ -22,7 +22,17 @@ class SetProxyHeaderTargetSslProxyRequest extends \Google\Protobuf\Internal\Mess */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -66,7 +76,17 @@ public static function build(string $project, string $targetSslProxy, \Google\Cl * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type \Google\Cloud\Compute\V1\TargetSslProxiesSetProxyHeaderRequest $target_ssl_proxies_set_proxy_header_request_resource * The body resource for this request * @type string $target_ssl_proxy @@ -105,7 +125,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -126,7 +156,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/SetProxyHeaderTargetTcpProxyRequest.php b/Compute/src/V1/SetProxyHeaderTargetTcpProxyRequest.php index 6ba4edd03a63..033d1775e944 100644 --- a/Compute/src/V1/SetProxyHeaderTargetTcpProxyRequest.php +++ b/Compute/src/V1/SetProxyHeaderTargetTcpProxyRequest.php @@ -22,7 +22,17 @@ class SetProxyHeaderTargetTcpProxyRequest extends \Google\Protobuf\Internal\Mess */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -66,7 +76,17 @@ public static function build(string $project, string $targetTcpProxy, \Google\Cl * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type \Google\Cloud\Compute\V1\TargetTcpProxiesSetProxyHeaderRequest $target_tcp_proxies_set_proxy_header_request_resource * The body resource for this request * @type string $target_tcp_proxy @@ -105,7 +125,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -126,7 +156,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/SetQuicOverrideTargetHttpsProxyRequest.php b/Compute/src/V1/SetQuicOverrideTargetHttpsProxyRequest.php index 981809ab40f2..4cd20c731fa5 100644 --- a/Compute/src/V1/SetQuicOverrideTargetHttpsProxyRequest.php +++ b/Compute/src/V1/SetQuicOverrideTargetHttpsProxyRequest.php @@ -22,7 +22,17 @@ class SetQuicOverrideTargetHttpsProxyRequest extends \Google\Protobuf\Internal\M */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -34,7 +44,8 @@ class SetQuicOverrideTargetHttpsProxyRequest extends \Google\Protobuf\Internal\M */ protected $target_https_proxies_set_quic_override_request_resource = null; /** - * Name of the TargetHttpsProxy resource to set the QUIC override policy for. The name should conform to RFC1035. + * Name of the TargetHttpsProxy resource to set the QUIC override policy for. + * The name should conform to RFC1035. * * Generated from protobuf field string target_https_proxy = 52336748 [(.google.api.field_behavior) = REQUIRED]; */ @@ -42,7 +53,8 @@ class SetQuicOverrideTargetHttpsProxyRequest extends \Google\Protobuf\Internal\M /** * @param string $project Project ID for this request. - * @param string $targetHttpsProxy Name of the TargetHttpsProxy resource to set the QUIC override policy for. The name should conform to RFC1035. + * @param string $targetHttpsProxy Name of the TargetHttpsProxy resource to set the QUIC override policy for. + * The name should conform to RFC1035. * @param \Google\Cloud\Compute\V1\TargetHttpsProxiesSetQuicOverrideRequest $targetHttpsProxiesSetQuicOverrideRequestResource The body resource for this request * * @return \Google\Cloud\Compute\V1\SetQuicOverrideTargetHttpsProxyRequest @@ -66,11 +78,22 @@ public static function build(string $project, string $targetHttpsProxy, \Google\ * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type \Google\Cloud\Compute\V1\TargetHttpsProxiesSetQuicOverrideRequest $target_https_proxies_set_quic_override_request_resource * The body resource for this request * @type string $target_https_proxy - * Name of the TargetHttpsProxy resource to set the QUIC override policy for. The name should conform to RFC1035. + * Name of the TargetHttpsProxy resource to set the QUIC override policy for. + * The name should conform to RFC1035. * } */ public function __construct($data = NULL) { @@ -105,7 +128,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -126,7 +159,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var @@ -177,7 +220,8 @@ public function setTargetHttpsProxiesSetQuicOverrideRequestResource($var) } /** - * Name of the TargetHttpsProxy resource to set the QUIC override policy for. The name should conform to RFC1035. + * Name of the TargetHttpsProxy resource to set the QUIC override policy for. + * The name should conform to RFC1035. * * Generated from protobuf field string target_https_proxy = 52336748 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -188,7 +232,8 @@ public function getTargetHttpsProxy() } /** - * Name of the TargetHttpsProxy resource to set the QUIC override policy for. The name should conform to RFC1035. + * Name of the TargetHttpsProxy resource to set the QUIC override policy for. + * The name should conform to RFC1035. * * Generated from protobuf field string target_https_proxy = 52336748 [(.google.api.field_behavior) = REQUIRED]; * @param string $var diff --git a/Compute/src/V1/SetSchedulingInstanceRequest.php b/Compute/src/V1/SetSchedulingInstanceRequest.php index 1c812ffed357..241436d82f46 100644 --- a/Compute/src/V1/SetSchedulingInstanceRequest.php +++ b/Compute/src/V1/SetSchedulingInstanceRequest.php @@ -28,7 +28,17 @@ class SetSchedulingInstanceRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -76,7 +86,17 @@ public static function build(string $project, string $zone, string $instance, \G * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type \Google\Cloud\Compute\V1\Scheduling $scheduling_resource * The body resource for this request * @type string $zone @@ -141,7 +161,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -162,7 +192,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/SetSecurityPolicyBackendServiceRequest.php b/Compute/src/V1/SetSecurityPolicyBackendServiceRequest.php index 6aa0bb298999..cfaf457429cb 100644 --- a/Compute/src/V1/SetSecurityPolicyBackendServiceRequest.php +++ b/Compute/src/V1/SetSecurityPolicyBackendServiceRequest.php @@ -16,7 +16,8 @@ class SetSecurityPolicyBackendServiceRequest extends \Google\Protobuf\Internal\Message { /** - * Name of the BackendService resource to which the security policy should be set. The name should conform to RFC1035. + * Name of the BackendService resource to which the security policy should be + * set. The name should conform to RFC1035. * * Generated from protobuf field string backend_service = 306946058 [(.google.api.field_behavior) = REQUIRED]; */ @@ -28,7 +29,17 @@ class SetSecurityPolicyBackendServiceRequest extends \Google\Protobuf\Internal\M */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -42,7 +53,8 @@ class SetSecurityPolicyBackendServiceRequest extends \Google\Protobuf\Internal\M /** * @param string $project Project ID for this request. - * @param string $backendService Name of the BackendService resource to which the security policy should be set. The name should conform to RFC1035. + * @param string $backendService Name of the BackendService resource to which the security policy should be + * set. The name should conform to RFC1035. * @param \Google\Cloud\Compute\V1\SecurityPolicyReference $securityPolicyReferenceResource The body resource for this request * * @return \Google\Cloud\Compute\V1\SetSecurityPolicyBackendServiceRequest @@ -64,11 +76,22 @@ public static function build(string $project, string $backendService, \Google\Cl * Optional. Data for populating the Message object. * * @type string $backend_service - * Name of the BackendService resource to which the security policy should be set. The name should conform to RFC1035. + * Name of the BackendService resource to which the security policy should be + * set. The name should conform to RFC1035. * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type \Google\Cloud\Compute\V1\SecurityPolicyReference $security_policy_reference_resource * The body resource for this request * } @@ -79,7 +102,8 @@ public function __construct($data = NULL) { } /** - * Name of the BackendService resource to which the security policy should be set. The name should conform to RFC1035. + * Name of the BackendService resource to which the security policy should be + * set. The name should conform to RFC1035. * * Generated from protobuf field string backend_service = 306946058 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -90,7 +114,8 @@ public function getBackendService() } /** - * Name of the BackendService resource to which the security policy should be set. The name should conform to RFC1035. + * Name of the BackendService resource to which the security policy should be + * set. The name should conform to RFC1035. * * Generated from protobuf field string backend_service = 306946058 [(.google.api.field_behavior) = REQUIRED]; * @param string $var @@ -131,7 +156,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -152,7 +187,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/SetSecurityPolicyInstanceRequest.php b/Compute/src/V1/SetSecurityPolicyInstanceRequest.php index 956cf5f3ad69..177e08c5d79d 100644 --- a/Compute/src/V1/SetSecurityPolicyInstanceRequest.php +++ b/Compute/src/V1/SetSecurityPolicyInstanceRequest.php @@ -16,7 +16,8 @@ class SetSecurityPolicyInstanceRequest extends \Google\Protobuf\Internal\Message { /** - * Name of the Instance resource to which the security policy should be set. The name should conform to RFC1035. + * Name of the Instance resource to which the security policy should be + * set. The name should conform to RFC1035. * * Generated from protobuf field string instance = 18257045 [(.google.api.field_behavior) = REQUIRED]; */ @@ -34,7 +35,17 @@ class SetSecurityPolicyInstanceRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -49,7 +60,8 @@ class SetSecurityPolicyInstanceRequest extends \Google\Protobuf\Internal\Message /** * @param string $project Project ID for this request. * @param string $zone Name of the zone scoping this request. - * @param string $instance Name of the Instance resource to which the security policy should be set. The name should conform to RFC1035. + * @param string $instance Name of the Instance resource to which the security policy should be + * set. The name should conform to RFC1035. * @param \Google\Cloud\Compute\V1\InstancesSetSecurityPolicyRequest $instancesSetSecurityPolicyRequestResource The body resource for this request * * @return \Google\Cloud\Compute\V1\SetSecurityPolicyInstanceRequest @@ -72,13 +84,24 @@ public static function build(string $project, string $zone, string $instance, \G * Optional. Data for populating the Message object. * * @type string $instance - * Name of the Instance resource to which the security policy should be set. The name should conform to RFC1035. + * Name of the Instance resource to which the security policy should be + * set. The name should conform to RFC1035. * @type \Google\Cloud\Compute\V1\InstancesSetSecurityPolicyRequest $instances_set_security_policy_request_resource * The body resource for this request * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $zone * Name of the zone scoping this request. * } @@ -89,7 +112,8 @@ public function __construct($data = NULL) { } /** - * Name of the Instance resource to which the security policy should be set. The name should conform to RFC1035. + * Name of the Instance resource to which the security policy should be + * set. The name should conform to RFC1035. * * Generated from protobuf field string instance = 18257045 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -100,7 +124,8 @@ public function getInstance() } /** - * Name of the Instance resource to which the security policy should be set. The name should conform to RFC1035. + * Name of the Instance resource to which the security policy should be + * set. The name should conform to RFC1035. * * Generated from protobuf field string instance = 18257045 [(.google.api.field_behavior) = REQUIRED]; * @param string $var @@ -177,7 +202,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -198,7 +233,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/SetSecurityPolicyRegionBackendServiceRequest.php b/Compute/src/V1/SetSecurityPolicyRegionBackendServiceRequest.php index 6e632fbe046c..009cca7e49a9 100644 --- a/Compute/src/V1/SetSecurityPolicyRegionBackendServiceRequest.php +++ b/Compute/src/V1/SetSecurityPolicyRegionBackendServiceRequest.php @@ -16,7 +16,8 @@ class SetSecurityPolicyRegionBackendServiceRequest extends \Google\Protobuf\Internal\Message { /** - * Name of the BackendService resource to which the security policy should be set. The name should conform to RFC1035. + * Name of the BackendService resource to which the security policy should be + * set. The name should conform to RFC1035. * * Generated from protobuf field string backend_service = 306946058 [(.google.api.field_behavior) = REQUIRED]; */ @@ -34,7 +35,17 @@ class SetSecurityPolicyRegionBackendServiceRequest extends \Google\Protobuf\Inte */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -49,7 +60,8 @@ class SetSecurityPolicyRegionBackendServiceRequest extends \Google\Protobuf\Inte /** * @param string $project Project ID for this request. * @param string $region Name of the region scoping this request. - * @param string $backendService Name of the BackendService resource to which the security policy should be set. The name should conform to RFC1035. + * @param string $backendService Name of the BackendService resource to which the security policy should be + * set. The name should conform to RFC1035. * @param \Google\Cloud\Compute\V1\SecurityPolicyReference $securityPolicyReferenceResource The body resource for this request * * @return \Google\Cloud\Compute\V1\SetSecurityPolicyRegionBackendServiceRequest @@ -72,13 +84,24 @@ public static function build(string $project, string $region, string $backendSer * Optional. Data for populating the Message object. * * @type string $backend_service - * Name of the BackendService resource to which the security policy should be set. The name should conform to RFC1035. + * Name of the BackendService resource to which the security policy should be + * set. The name should conform to RFC1035. * @type string $project * Project ID for this request. * @type string $region * Name of the region scoping this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type \Google\Cloud\Compute\V1\SecurityPolicyReference $security_policy_reference_resource * The body resource for this request * } @@ -89,7 +112,8 @@ public function __construct($data = NULL) { } /** - * Name of the BackendService resource to which the security policy should be set. The name should conform to RFC1035. + * Name of the BackendService resource to which the security policy should be + * set. The name should conform to RFC1035. * * Generated from protobuf field string backend_service = 306946058 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -100,7 +124,8 @@ public function getBackendService() } /** - * Name of the BackendService resource to which the security policy should be set. The name should conform to RFC1035. + * Name of the BackendService resource to which the security policy should be + * set. The name should conform to RFC1035. * * Generated from protobuf field string backend_service = 306946058 [(.google.api.field_behavior) = REQUIRED]; * @param string $var @@ -167,7 +192,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -188,7 +223,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/SetSecurityPolicyTargetInstanceRequest.php b/Compute/src/V1/SetSecurityPolicyTargetInstanceRequest.php index d58be6cb7c5e..ce66fc252262 100644 --- a/Compute/src/V1/SetSecurityPolicyTargetInstanceRequest.php +++ b/Compute/src/V1/SetSecurityPolicyTargetInstanceRequest.php @@ -22,7 +22,17 @@ class SetSecurityPolicyTargetInstanceRequest extends \Google\Protobuf\Internal\M */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -34,7 +44,8 @@ class SetSecurityPolicyTargetInstanceRequest extends \Google\Protobuf\Internal\M */ protected $security_policy_reference_resource = null; /** - * Name of the TargetInstance resource to which the security policy should be set. The name should conform to RFC1035. + * Name of the TargetInstance resource to which the security policy should be + * set. The name should conform to RFC1035. * * Generated from protobuf field string target_instance = 289769347 [(.google.api.field_behavior) = REQUIRED]; */ @@ -49,7 +60,8 @@ class SetSecurityPolicyTargetInstanceRequest extends \Google\Protobuf\Internal\M /** * @param string $project Project ID for this request. * @param string $zone Name of the zone scoping this request. - * @param string $targetInstance Name of the TargetInstance resource to which the security policy should be set. The name should conform to RFC1035. + * @param string $targetInstance Name of the TargetInstance resource to which the security policy should be + * set. The name should conform to RFC1035. * @param \Google\Cloud\Compute\V1\SecurityPolicyReference $securityPolicyReferenceResource The body resource for this request * * @return \Google\Cloud\Compute\V1\SetSecurityPolicyTargetInstanceRequest @@ -74,11 +86,22 @@ public static function build(string $project, string $zone, string $targetInstan * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type \Google\Cloud\Compute\V1\SecurityPolicyReference $security_policy_reference_resource * The body resource for this request * @type string $target_instance - * Name of the TargetInstance resource to which the security policy should be set. The name should conform to RFC1035. + * Name of the TargetInstance resource to which the security policy should be + * set. The name should conform to RFC1035. * @type string $zone * Name of the zone scoping this request. * } @@ -115,7 +138,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -136,7 +169,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var @@ -187,7 +230,8 @@ public function setSecurityPolicyReferenceResource($var) } /** - * Name of the TargetInstance resource to which the security policy should be set. The name should conform to RFC1035. + * Name of the TargetInstance resource to which the security policy should be + * set. The name should conform to RFC1035. * * Generated from protobuf field string target_instance = 289769347 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -198,7 +242,8 @@ public function getTargetInstance() } /** - * Name of the TargetInstance resource to which the security policy should be set. The name should conform to RFC1035. + * Name of the TargetInstance resource to which the security policy should be + * set. The name should conform to RFC1035. * * Generated from protobuf field string target_instance = 289769347 [(.google.api.field_behavior) = REQUIRED]; * @param string $var diff --git a/Compute/src/V1/SetSecurityPolicyTargetPoolRequest.php b/Compute/src/V1/SetSecurityPolicyTargetPoolRequest.php index 7d406d53c55d..54dbbb163d39 100644 --- a/Compute/src/V1/SetSecurityPolicyTargetPoolRequest.php +++ b/Compute/src/V1/SetSecurityPolicyTargetPoolRequest.php @@ -28,7 +28,17 @@ class SetSecurityPolicyTargetPoolRequest extends \Google\Protobuf\Internal\Messa */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -40,7 +50,8 @@ class SetSecurityPolicyTargetPoolRequest extends \Google\Protobuf\Internal\Messa */ protected $security_policy_reference_resource = null; /** - * Name of the TargetPool resource to which the security policy should be set. The name should conform to RFC1035. + * Name of the TargetPool resource to which the security policy should be + * set. The name should conform to RFC1035. * * Generated from protobuf field string target_pool = 62796298 [(.google.api.field_behavior) = REQUIRED]; */ @@ -49,7 +60,8 @@ class SetSecurityPolicyTargetPoolRequest extends \Google\Protobuf\Internal\Messa /** * @param string $project Project ID for this request. * @param string $region Name of the region scoping this request. - * @param string $targetPool Name of the TargetPool resource to which the security policy should be set. The name should conform to RFC1035. + * @param string $targetPool Name of the TargetPool resource to which the security policy should be + * set. The name should conform to RFC1035. * @param \Google\Cloud\Compute\V1\SecurityPolicyReference $securityPolicyReferenceResource The body resource for this request * * @return \Google\Cloud\Compute\V1\SetSecurityPolicyTargetPoolRequest @@ -76,11 +88,22 @@ public static function build(string $project, string $region, string $targetPool * @type string $region * Name of the region scoping this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type \Google\Cloud\Compute\V1\SecurityPolicyReference $security_policy_reference_resource * The body resource for this request * @type string $target_pool - * Name of the TargetPool resource to which the security policy should be set. The name should conform to RFC1035. + * Name of the TargetPool resource to which the security policy should be + * set. The name should conform to RFC1035. * } */ public function __construct($data = NULL) { @@ -141,7 +164,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -162,7 +195,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var @@ -213,7 +256,8 @@ public function setSecurityPolicyReferenceResource($var) } /** - * Name of the TargetPool resource to which the security policy should be set. The name should conform to RFC1035. + * Name of the TargetPool resource to which the security policy should be + * set. The name should conform to RFC1035. * * Generated from protobuf field string target_pool = 62796298 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -224,7 +268,8 @@ public function getTargetPool() } /** - * Name of the TargetPool resource to which the security policy should be set. The name should conform to RFC1035. + * Name of the TargetPool resource to which the security policy should be + * set. The name should conform to RFC1035. * * Generated from protobuf field string target_pool = 62796298 [(.google.api.field_behavior) = REQUIRED]; * @param string $var diff --git a/Compute/src/V1/SetServiceAccountInstanceRequest.php b/Compute/src/V1/SetServiceAccountInstanceRequest.php index 9db33e84f705..94e375bc4d52 100644 --- a/Compute/src/V1/SetServiceAccountInstanceRequest.php +++ b/Compute/src/V1/SetServiceAccountInstanceRequest.php @@ -34,7 +34,17 @@ class SetServiceAccountInstanceRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -78,7 +88,17 @@ public static function build(string $project, string $zone, string $instance, \G * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $zone * The name of the zone for this request. * } @@ -177,7 +197,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -198,7 +228,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/SetShieldedInstanceIntegrityPolicyInstanceRequest.php b/Compute/src/V1/SetShieldedInstanceIntegrityPolicyInstanceRequest.php index 09e1d294aaee..1d4cddbc3187 100644 --- a/Compute/src/V1/SetShieldedInstanceIntegrityPolicyInstanceRequest.php +++ b/Compute/src/V1/SetShieldedInstanceIntegrityPolicyInstanceRequest.php @@ -28,7 +28,17 @@ class SetShieldedInstanceIntegrityPolicyInstanceRequest extends \Google\Protobuf */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -76,7 +86,17 @@ public static function build(string $project, string $zone, string $instance, \G * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type \Google\Cloud\Compute\V1\ShieldedInstanceIntegrityPolicy $shielded_instance_integrity_policy_resource * The body resource for this request * @type string $zone @@ -141,7 +161,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -162,7 +192,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/SetSslCertificatesRegionTargetHttpsProxyRequest.php b/Compute/src/V1/SetSslCertificatesRegionTargetHttpsProxyRequest.php index 76b7906f24c6..08afa433c899 100644 --- a/Compute/src/V1/SetSslCertificatesRegionTargetHttpsProxyRequest.php +++ b/Compute/src/V1/SetSslCertificatesRegionTargetHttpsProxyRequest.php @@ -34,13 +34,24 @@ class SetSslCertificatesRegionTargetHttpsProxyRequest extends \Google\Protobuf\I */ protected $region_target_https_proxies_set_ssl_certificates_request_resource = null; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ protected $request_id = null; /** - * Name of the TargetHttpsProxy resource to set an SslCertificates resource for. + * Name of the TargetHttpsProxy resource to set an + * SslCertificates resource for. * * Generated from protobuf field string target_https_proxy = 52336748 [(.google.api.field_behavior) = REQUIRED]; */ @@ -49,7 +60,8 @@ class SetSslCertificatesRegionTargetHttpsProxyRequest extends \Google\Protobuf\I /** * @param string $project Project ID for this request. * @param string $region Name of the region scoping this request. - * @param string $targetHttpsProxy Name of the TargetHttpsProxy resource to set an SslCertificates resource for. + * @param string $targetHttpsProxy Name of the TargetHttpsProxy resource to set an + * SslCertificates resource for. * @param \Google\Cloud\Compute\V1\RegionTargetHttpsProxiesSetSslCertificatesRequest $regionTargetHttpsProxiesSetSslCertificatesRequestResource The body resource for this request * * @return \Google\Cloud\Compute\V1\SetSslCertificatesRegionTargetHttpsProxyRequest @@ -78,9 +90,20 @@ public static function build(string $project, string $region, string $targetHttp * @type \Google\Cloud\Compute\V1\RegionTargetHttpsProxiesSetSslCertificatesRequest $region_target_https_proxies_set_ssl_certificates_request_resource * The body resource for this request * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $target_https_proxy - * Name of the TargetHttpsProxy resource to set an SslCertificates resource for. + * Name of the TargetHttpsProxy resource to set an + * SslCertificates resource for. * } */ public function __construct($data = NULL) { @@ -177,7 +200,17 @@ public function setRegionTargetHttpsProxiesSetSslCertificatesRequestResource($va } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -198,7 +231,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var @@ -213,7 +256,8 @@ public function setRequestId($var) } /** - * Name of the TargetHttpsProxy resource to set an SslCertificates resource for. + * Name of the TargetHttpsProxy resource to set an + * SslCertificates resource for. * * Generated from protobuf field string target_https_proxy = 52336748 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -224,7 +268,8 @@ public function getTargetHttpsProxy() } /** - * Name of the TargetHttpsProxy resource to set an SslCertificates resource for. + * Name of the TargetHttpsProxy resource to set an + * SslCertificates resource for. * * Generated from protobuf field string target_https_proxy = 52336748 [(.google.api.field_behavior) = REQUIRED]; * @param string $var diff --git a/Compute/src/V1/SetSslCertificatesTargetHttpsProxyRequest.php b/Compute/src/V1/SetSslCertificatesTargetHttpsProxyRequest.php index ef4ee3d645a5..8670d54fa893 100644 --- a/Compute/src/V1/SetSslCertificatesTargetHttpsProxyRequest.php +++ b/Compute/src/V1/SetSslCertificatesTargetHttpsProxyRequest.php @@ -22,7 +22,17 @@ class SetSslCertificatesTargetHttpsProxyRequest extends \Google\Protobuf\Interna */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -34,7 +44,8 @@ class SetSslCertificatesTargetHttpsProxyRequest extends \Google\Protobuf\Interna */ protected $target_https_proxies_set_ssl_certificates_request_resource = null; /** - * Name of the TargetHttpsProxy resource to set an SslCertificates resource for. + * Name of the TargetHttpsProxy resource to set an + * SslCertificates resource for. * * Generated from protobuf field string target_https_proxy = 52336748 [(.google.api.field_behavior) = REQUIRED]; */ @@ -42,7 +53,8 @@ class SetSslCertificatesTargetHttpsProxyRequest extends \Google\Protobuf\Interna /** * @param string $project Project ID for this request. - * @param string $targetHttpsProxy Name of the TargetHttpsProxy resource to set an SslCertificates resource for. + * @param string $targetHttpsProxy Name of the TargetHttpsProxy resource to set an + * SslCertificates resource for. * @param \Google\Cloud\Compute\V1\TargetHttpsProxiesSetSslCertificatesRequest $targetHttpsProxiesSetSslCertificatesRequestResource The body resource for this request * * @return \Google\Cloud\Compute\V1\SetSslCertificatesTargetHttpsProxyRequest @@ -66,11 +78,22 @@ public static function build(string $project, string $targetHttpsProxy, \Google\ * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type \Google\Cloud\Compute\V1\TargetHttpsProxiesSetSslCertificatesRequest $target_https_proxies_set_ssl_certificates_request_resource * The body resource for this request * @type string $target_https_proxy - * Name of the TargetHttpsProxy resource to set an SslCertificates resource for. + * Name of the TargetHttpsProxy resource to set an + * SslCertificates resource for. * } */ public function __construct($data = NULL) { @@ -105,7 +128,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -126,7 +159,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var @@ -177,7 +220,8 @@ public function setTargetHttpsProxiesSetSslCertificatesRequestResource($var) } /** - * Name of the TargetHttpsProxy resource to set an SslCertificates resource for. + * Name of the TargetHttpsProxy resource to set an + * SslCertificates resource for. * * Generated from protobuf field string target_https_proxy = 52336748 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -188,7 +232,8 @@ public function getTargetHttpsProxy() } /** - * Name of the TargetHttpsProxy resource to set an SslCertificates resource for. + * Name of the TargetHttpsProxy resource to set an + * SslCertificates resource for. * * Generated from protobuf field string target_https_proxy = 52336748 [(.google.api.field_behavior) = REQUIRED]; * @param string $var diff --git a/Compute/src/V1/SetSslCertificatesTargetSslProxyRequest.php b/Compute/src/V1/SetSslCertificatesTargetSslProxyRequest.php index d00ba425da87..ddbf3651dcb0 100644 --- a/Compute/src/V1/SetSslCertificatesTargetSslProxyRequest.php +++ b/Compute/src/V1/SetSslCertificatesTargetSslProxyRequest.php @@ -22,7 +22,17 @@ class SetSslCertificatesTargetSslProxyRequest extends \Google\Protobuf\Internal\ */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -34,7 +44,8 @@ class SetSslCertificatesTargetSslProxyRequest extends \Google\Protobuf\Internal\ */ protected $target_ssl_proxies_set_ssl_certificates_request_resource = null; /** - * Name of the TargetSslProxy resource whose SslCertificate resource is to be set. + * Name of the TargetSslProxy resource whose SslCertificate resource + * is to be set. * * Generated from protobuf field string target_ssl_proxy = 338795853 [(.google.api.field_behavior) = REQUIRED]; */ @@ -42,7 +53,8 @@ class SetSslCertificatesTargetSslProxyRequest extends \Google\Protobuf\Internal\ /** * @param string $project Project ID for this request. - * @param string $targetSslProxy Name of the TargetSslProxy resource whose SslCertificate resource is to be set. + * @param string $targetSslProxy Name of the TargetSslProxy resource whose SslCertificate resource + * is to be set. * @param \Google\Cloud\Compute\V1\TargetSslProxiesSetSslCertificatesRequest $targetSslProxiesSetSslCertificatesRequestResource The body resource for this request * * @return \Google\Cloud\Compute\V1\SetSslCertificatesTargetSslProxyRequest @@ -66,11 +78,22 @@ public static function build(string $project, string $targetSslProxy, \Google\Cl * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type \Google\Cloud\Compute\V1\TargetSslProxiesSetSslCertificatesRequest $target_ssl_proxies_set_ssl_certificates_request_resource * The body resource for this request * @type string $target_ssl_proxy - * Name of the TargetSslProxy resource whose SslCertificate resource is to be set. + * Name of the TargetSslProxy resource whose SslCertificate resource + * is to be set. * } */ public function __construct($data = NULL) { @@ -105,7 +128,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -126,7 +159,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var @@ -177,7 +220,8 @@ public function setTargetSslProxiesSetSslCertificatesRequestResource($var) } /** - * Name of the TargetSslProxy resource whose SslCertificate resource is to be set. + * Name of the TargetSslProxy resource whose SslCertificate resource + * is to be set. * * Generated from protobuf field string target_ssl_proxy = 338795853 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -188,7 +232,8 @@ public function getTargetSslProxy() } /** - * Name of the TargetSslProxy resource whose SslCertificate resource is to be set. + * Name of the TargetSslProxy resource whose SslCertificate resource + * is to be set. * * Generated from protobuf field string target_ssl_proxy = 338795853 [(.google.api.field_behavior) = REQUIRED]; * @param string $var diff --git a/Compute/src/V1/SetSslPolicyTargetHttpsProxyRequest.php b/Compute/src/V1/SetSslPolicyTargetHttpsProxyRequest.php index 60765ce1cc34..a0c7a0372da7 100644 --- a/Compute/src/V1/SetSslPolicyTargetHttpsProxyRequest.php +++ b/Compute/src/V1/SetSslPolicyTargetHttpsProxyRequest.php @@ -22,7 +22,17 @@ class SetSslPolicyTargetHttpsProxyRequest extends \Google\Protobuf\Internal\Mess */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -34,7 +44,8 @@ class SetSslPolicyTargetHttpsProxyRequest extends \Google\Protobuf\Internal\Mess */ protected $ssl_policy_reference_resource = null; /** - * Name of the TargetHttpsProxy resource whose SSL policy is to be set. The name must be 1-63 characters long, and comply with RFC1035. + * Name of the TargetHttpsProxy resource whose SSL policy is + * to be set. The name must be 1-63 characters long, and comply with RFC1035. * * Generated from protobuf field string target_https_proxy = 52336748 [(.google.api.field_behavior) = REQUIRED]; */ @@ -42,7 +53,8 @@ class SetSslPolicyTargetHttpsProxyRequest extends \Google\Protobuf\Internal\Mess /** * @param string $project Project ID for this request. - * @param string $targetHttpsProxy Name of the TargetHttpsProxy resource whose SSL policy is to be set. The name must be 1-63 characters long, and comply with RFC1035. + * @param string $targetHttpsProxy Name of the TargetHttpsProxy resource whose SSL policy is + * to be set. The name must be 1-63 characters long, and comply with RFC1035. * @param \Google\Cloud\Compute\V1\SslPolicyReference $sslPolicyReferenceResource The body resource for this request * * @return \Google\Cloud\Compute\V1\SetSslPolicyTargetHttpsProxyRequest @@ -66,11 +78,22 @@ public static function build(string $project, string $targetHttpsProxy, \Google\ * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type \Google\Cloud\Compute\V1\SslPolicyReference $ssl_policy_reference_resource * The body resource for this request * @type string $target_https_proxy - * Name of the TargetHttpsProxy resource whose SSL policy is to be set. The name must be 1-63 characters long, and comply with RFC1035. + * Name of the TargetHttpsProxy resource whose SSL policy is + * to be set. The name must be 1-63 characters long, and comply with RFC1035. * } */ public function __construct($data = NULL) { @@ -105,7 +128,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -126,7 +159,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var @@ -177,7 +220,8 @@ public function setSslPolicyReferenceResource($var) } /** - * Name of the TargetHttpsProxy resource whose SSL policy is to be set. The name must be 1-63 characters long, and comply with RFC1035. + * Name of the TargetHttpsProxy resource whose SSL policy is + * to be set. The name must be 1-63 characters long, and comply with RFC1035. * * Generated from protobuf field string target_https_proxy = 52336748 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -188,7 +232,8 @@ public function getTargetHttpsProxy() } /** - * Name of the TargetHttpsProxy resource whose SSL policy is to be set. The name must be 1-63 characters long, and comply with RFC1035. + * Name of the TargetHttpsProxy resource whose SSL policy is + * to be set. The name must be 1-63 characters long, and comply with RFC1035. * * Generated from protobuf field string target_https_proxy = 52336748 [(.google.api.field_behavior) = REQUIRED]; * @param string $var diff --git a/Compute/src/V1/SetSslPolicyTargetSslProxyRequest.php b/Compute/src/V1/SetSslPolicyTargetSslProxyRequest.php index 1d575555eb22..ade3e47fc85e 100644 --- a/Compute/src/V1/SetSslPolicyTargetSslProxyRequest.php +++ b/Compute/src/V1/SetSslPolicyTargetSslProxyRequest.php @@ -22,7 +22,17 @@ class SetSslPolicyTargetSslProxyRequest extends \Google\Protobuf\Internal\Messag */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -34,7 +44,8 @@ class SetSslPolicyTargetSslProxyRequest extends \Google\Protobuf\Internal\Messag */ protected $ssl_policy_reference_resource = null; /** - * Name of the TargetSslProxy resource whose SSL policy is to be set. The name must be 1-63 characters long, and comply with RFC1035. + * Name of the TargetSslProxy resource whose SSL policy is + * to be set. The name must be 1-63 characters long, and comply with RFC1035. * * Generated from protobuf field string target_ssl_proxy = 338795853 [(.google.api.field_behavior) = REQUIRED]; */ @@ -42,7 +53,8 @@ class SetSslPolicyTargetSslProxyRequest extends \Google\Protobuf\Internal\Messag /** * @param string $project Project ID for this request. - * @param string $targetSslProxy Name of the TargetSslProxy resource whose SSL policy is to be set. The name must be 1-63 characters long, and comply with RFC1035. + * @param string $targetSslProxy Name of the TargetSslProxy resource whose SSL policy is + * to be set. The name must be 1-63 characters long, and comply with RFC1035. * @param \Google\Cloud\Compute\V1\SslPolicyReference $sslPolicyReferenceResource The body resource for this request * * @return \Google\Cloud\Compute\V1\SetSslPolicyTargetSslProxyRequest @@ -66,11 +78,22 @@ public static function build(string $project, string $targetSslProxy, \Google\Cl * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type \Google\Cloud\Compute\V1\SslPolicyReference $ssl_policy_reference_resource * The body resource for this request * @type string $target_ssl_proxy - * Name of the TargetSslProxy resource whose SSL policy is to be set. The name must be 1-63 characters long, and comply with RFC1035. + * Name of the TargetSslProxy resource whose SSL policy is + * to be set. The name must be 1-63 characters long, and comply with RFC1035. * } */ public function __construct($data = NULL) { @@ -105,7 +128,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -126,7 +159,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var @@ -177,7 +220,8 @@ public function setSslPolicyReferenceResource($var) } /** - * Name of the TargetSslProxy resource whose SSL policy is to be set. The name must be 1-63 characters long, and comply with RFC1035. + * Name of the TargetSslProxy resource whose SSL policy is + * to be set. The name must be 1-63 characters long, and comply with RFC1035. * * Generated from protobuf field string target_ssl_proxy = 338795853 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -188,7 +232,8 @@ public function getTargetSslProxy() } /** - * Name of the TargetSslProxy resource whose SSL policy is to be set. The name must be 1-63 characters long, and comply with RFC1035. + * Name of the TargetSslProxy resource whose SSL policy is + * to be set. The name must be 1-63 characters long, and comply with RFC1035. * * Generated from protobuf field string target_ssl_proxy = 338795853 [(.google.api.field_behavior) = REQUIRED]; * @param string $var diff --git a/Compute/src/V1/SetTagsInstanceRequest.php b/Compute/src/V1/SetTagsInstanceRequest.php index c69d3bcf1eda..3d785206b647 100644 --- a/Compute/src/V1/SetTagsInstanceRequest.php +++ b/Compute/src/V1/SetTagsInstanceRequest.php @@ -28,7 +28,17 @@ class SetTagsInstanceRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -76,7 +86,17 @@ public static function build(string $project, string $zone, string $instance, \G * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type \Google\Cloud\Compute\V1\Tags $tags_resource * The body resource for this request * @type string $zone @@ -141,7 +161,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -162,7 +192,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/SetTargetForwardingRuleRequest.php b/Compute/src/V1/SetTargetForwardingRuleRequest.php index 71907f4cf4ba..756d1bb8489c 100644 --- a/Compute/src/V1/SetTargetForwardingRuleRequest.php +++ b/Compute/src/V1/SetTargetForwardingRuleRequest.php @@ -34,7 +34,17 @@ class SetTargetForwardingRuleRequest extends \Google\Protobuf\Internal\Message */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -78,7 +88,17 @@ public static function build(string $project, string $region, string $forwarding * @type string $region * Name of the region scoping this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type \Google\Cloud\Compute\V1\TargetReference $target_reference_resource * The body resource for this request * } @@ -167,7 +187,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -188,7 +218,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/SetTargetGlobalForwardingRuleRequest.php b/Compute/src/V1/SetTargetGlobalForwardingRuleRequest.php index a00a31b22f2e..bf5a0f54b78e 100644 --- a/Compute/src/V1/SetTargetGlobalForwardingRuleRequest.php +++ b/Compute/src/V1/SetTargetGlobalForwardingRuleRequest.php @@ -28,7 +28,17 @@ class SetTargetGlobalForwardingRuleRequest extends \Google\Protobuf\Internal\Mes */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -68,7 +78,17 @@ public static function build(string $project, string $forwardingRule, \Google\Cl * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type \Google\Cloud\Compute\V1\TargetReference $target_reference_resource * The body resource for this request * } @@ -131,7 +151,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -152,7 +182,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/SetTargetPoolsInstanceGroupManagerRequest.php b/Compute/src/V1/SetTargetPoolsInstanceGroupManagerRequest.php index adc898f8fabd..b15f2a78045a 100644 --- a/Compute/src/V1/SetTargetPoolsInstanceGroupManagerRequest.php +++ b/Compute/src/V1/SetTargetPoolsInstanceGroupManagerRequest.php @@ -34,13 +34,24 @@ class SetTargetPoolsInstanceGroupManagerRequest extends \Google\Protobuf\Interna */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ protected $request_id = null; /** - * The name of the zone where the managed instance group is located. + * The name of thezone where the managed + * instance group is located. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; */ @@ -48,7 +59,8 @@ class SetTargetPoolsInstanceGroupManagerRequest extends \Google\Protobuf\Interna /** * @param string $project Project ID for this request. - * @param string $zone The name of the zone where the managed instance group is located. + * @param string $zone The name of thezone where the managed + * instance group is located. * @param string $instanceGroupManager The name of the managed instance group. * @param \Google\Cloud\Compute\V1\InstanceGroupManagersSetTargetPoolsRequest $instanceGroupManagersSetTargetPoolsRequestResource The body resource for this request * @@ -78,9 +90,20 @@ public static function build(string $project, string $zone, string $instanceGrou * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $zone - * The name of the zone where the managed instance group is located. + * The name of thezone where the managed + * instance group is located. * } */ public function __construct($data = NULL) { @@ -177,7 +200,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -198,7 +231,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var @@ -213,7 +256,8 @@ public function setRequestId($var) } /** - * The name of the zone where the managed instance group is located. + * The name of thezone where the managed + * instance group is located. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; * @return string @@ -224,7 +268,8 @@ public function getZone() } /** - * The name of the zone where the managed instance group is located. + * The name of thezone where the managed + * instance group is located. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; * @param string $var diff --git a/Compute/src/V1/SetTargetPoolsRegionInstanceGroupManagerRequest.php b/Compute/src/V1/SetTargetPoolsRegionInstanceGroupManagerRequest.php index 45d1be5ca21b..7de53850aaa4 100644 --- a/Compute/src/V1/SetTargetPoolsRegionInstanceGroupManagerRequest.php +++ b/Compute/src/V1/SetTargetPoolsRegionInstanceGroupManagerRequest.php @@ -40,7 +40,17 @@ class SetTargetPoolsRegionInstanceGroupManagerRequest extends \Google\Protobuf\I */ protected $region_instance_group_managers_set_target_pools_request_resource = null; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -80,7 +90,17 @@ public static function build(string $project, string $region, string $instanceGr * @type \Google\Cloud\Compute\V1\RegionInstanceGroupManagersSetTargetPoolsRequest $region_instance_group_managers_set_target_pools_request_resource * The body resource for this request * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -203,7 +223,17 @@ public function setRegionInstanceGroupManagersSetTargetPoolsRequestResource($var } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -224,7 +254,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/SetUrlMapRegionTargetHttpProxyRequest.php b/Compute/src/V1/SetUrlMapRegionTargetHttpProxyRequest.php index ac999df310cd..9ba4b053cd0e 100644 --- a/Compute/src/V1/SetUrlMapRegionTargetHttpProxyRequest.php +++ b/Compute/src/V1/SetUrlMapRegionTargetHttpProxyRequest.php @@ -28,7 +28,17 @@ class SetUrlMapRegionTargetHttpProxyRequest extends \Google\Protobuf\Internal\Me */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -76,7 +86,17 @@ public static function build(string $project, string $region, string $targetHttp * @type string $region * Name of the region scoping this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $target_http_proxy * Name of the TargetHttpProxy to set a URL map for. * @type \Google\Cloud\Compute\V1\UrlMapReference $url_map_reference_resource @@ -141,7 +161,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -162,7 +192,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/SetUrlMapRegionTargetHttpsProxyRequest.php b/Compute/src/V1/SetUrlMapRegionTargetHttpsProxyRequest.php index 36383272a46a..08ef4782f294 100644 --- a/Compute/src/V1/SetUrlMapRegionTargetHttpsProxyRequest.php +++ b/Compute/src/V1/SetUrlMapRegionTargetHttpsProxyRequest.php @@ -28,7 +28,17 @@ class SetUrlMapRegionTargetHttpsProxyRequest extends \Google\Protobuf\Internal\M */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -76,7 +86,17 @@ public static function build(string $project, string $region, string $targetHttp * @type string $region * Name of the region scoping this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $target_https_proxy * Name of the TargetHttpsProxy to set a URL map for. * @type \Google\Cloud\Compute\V1\UrlMapReference $url_map_reference_resource @@ -141,7 +161,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -162,7 +192,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/SetUrlMapTargetHttpProxyRequest.php b/Compute/src/V1/SetUrlMapTargetHttpProxyRequest.php index fb7745142b55..77d47091ec22 100644 --- a/Compute/src/V1/SetUrlMapTargetHttpProxyRequest.php +++ b/Compute/src/V1/SetUrlMapTargetHttpProxyRequest.php @@ -22,7 +22,17 @@ class SetUrlMapTargetHttpProxyRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -66,7 +76,17 @@ public static function build(string $project, string $targetHttpProxy, \Google\C * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $target_http_proxy * Name of the TargetHttpProxy to set a URL map for. * @type \Google\Cloud\Compute\V1\UrlMapReference $url_map_reference_resource @@ -105,7 +125,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -126,7 +156,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/SetUrlMapTargetHttpsProxyRequest.php b/Compute/src/V1/SetUrlMapTargetHttpsProxyRequest.php index 1461f6f69eab..a89ad25c515e 100644 --- a/Compute/src/V1/SetUrlMapTargetHttpsProxyRequest.php +++ b/Compute/src/V1/SetUrlMapTargetHttpsProxyRequest.php @@ -22,13 +22,24 @@ class SetUrlMapTargetHttpsProxyRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ protected $request_id = null; /** - * Name of the TargetHttpsProxy resource whose URL map is to be set. + * Name of the TargetHttpsProxy resource whose URL map is + * to be set. * * Generated from protobuf field string target_https_proxy = 52336748 [(.google.api.field_behavior) = REQUIRED]; */ @@ -42,7 +53,8 @@ class SetUrlMapTargetHttpsProxyRequest extends \Google\Protobuf\Internal\Message /** * @param string $project Project ID for this request. - * @param string $targetHttpsProxy Name of the TargetHttpsProxy resource whose URL map is to be set. + * @param string $targetHttpsProxy Name of the TargetHttpsProxy resource whose URL map is + * to be set. * @param \Google\Cloud\Compute\V1\UrlMapReference $urlMapReferenceResource The body resource for this request * * @return \Google\Cloud\Compute\V1\SetUrlMapTargetHttpsProxyRequest @@ -66,9 +78,20 @@ public static function build(string $project, string $targetHttpsProxy, \Google\ * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $target_https_proxy - * Name of the TargetHttpsProxy resource whose URL map is to be set. + * Name of the TargetHttpsProxy resource whose URL map is + * to be set. * @type \Google\Cloud\Compute\V1\UrlMapReference $url_map_reference_resource * The body resource for this request * } @@ -105,7 +128,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -126,7 +159,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var @@ -141,7 +184,8 @@ public function setRequestId($var) } /** - * Name of the TargetHttpsProxy resource whose URL map is to be set. + * Name of the TargetHttpsProxy resource whose URL map is + * to be set. * * Generated from protobuf field string target_https_proxy = 52336748 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -152,7 +196,8 @@ public function getTargetHttpsProxy() } /** - * Name of the TargetHttpsProxy resource whose URL map is to be set. + * Name of the TargetHttpsProxy resource whose URL map is + * to be set. * * Generated from protobuf field string target_https_proxy = 52336748 [(.google.api.field_behavior) = REQUIRED]; * @param string $var diff --git a/Compute/src/V1/SetUsageExportBucketProjectRequest.php b/Compute/src/V1/SetUsageExportBucketProjectRequest.php index 8f0473ac61a9..c6778065fe06 100644 --- a/Compute/src/V1/SetUsageExportBucketProjectRequest.php +++ b/Compute/src/V1/SetUsageExportBucketProjectRequest.php @@ -22,7 +22,17 @@ class SetUsageExportBucketProjectRequest extends \Google\Protobuf\Internal\Messa */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -58,7 +68,17 @@ public static function build(string $project, \Google\Cloud\Compute\V1\UsageExpo * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type \Google\Cloud\Compute\V1\UsageExportLocation $usage_export_location_resource * The body resource for this request * } @@ -95,7 +115,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -116,7 +146,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/ShareSettings.php b/Compute/src/V1/ShareSettings.php index 15b1bc2bd3e5..d9cfa2b71a0e 100644 --- a/Compute/src/V1/ShareSettings.php +++ b/Compute/src/V1/ShareSettings.php @@ -16,7 +16,8 @@ class ShareSettings extends \Google\Protobuf\Internal\Message { /** - * A map of project id and project config. This is only valid when share_type's value is SPECIFIC_PROJECTS. + * A map of project id and project config. This is only valid when + * share_type's value is SPECIFIC_PROJECTS. * * Generated from protobuf field map project_map = 134212406; */ @@ -36,7 +37,8 @@ class ShareSettings extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type array|\Google\Protobuf\Internal\MapField $project_map - * A map of project id and project config. This is only valid when share_type's value is SPECIFIC_PROJECTS. + * A map of project id and project config. This is only valid when + * share_type's value is SPECIFIC_PROJECTS. * @type string $share_type * Type of sharing for this shared-reservation * Check the ShareType enum for the list of possible values. @@ -48,7 +50,8 @@ public function __construct($data = NULL) { } /** - * A map of project id and project config. This is only valid when share_type's value is SPECIFIC_PROJECTS. + * A map of project id and project config. This is only valid when + * share_type's value is SPECIFIC_PROJECTS. * * Generated from protobuf field map project_map = 134212406; * @return \Google\Protobuf\Internal\MapField @@ -59,7 +62,8 @@ public function getProjectMap() } /** - * A map of project id and project config. This is only valid when share_type's value is SPECIFIC_PROJECTS. + * A map of project id and project config. This is only valid when + * share_type's value is SPECIFIC_PROJECTS. * * Generated from protobuf field map project_map = 134212406; * @param array|\Google\Protobuf\Internal\MapField $var diff --git a/Compute/src/V1/ShareSettingsProjectConfig.php b/Compute/src/V1/ShareSettingsProjectConfig.php index 85bddab767cf..b4df5e72f196 100644 --- a/Compute/src/V1/ShareSettingsProjectConfig.php +++ b/Compute/src/V1/ShareSettingsProjectConfig.php @@ -16,7 +16,8 @@ class ShareSettingsProjectConfig extends \Google\Protobuf\Internal\Message { /** - * The project ID, should be same as the key of this project config in the parent map. + * The project ID, should be same as the key of this project config in the + * parent map. * * Generated from protobuf field optional string project_id = 177513473; */ @@ -29,7 +30,8 @@ class ShareSettingsProjectConfig extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $project_id - * The project ID, should be same as the key of this project config in the parent map. + * The project ID, should be same as the key of this project config in the + * parent map. * } */ public function __construct($data = NULL) { @@ -38,7 +40,8 @@ public function __construct($data = NULL) { } /** - * The project ID, should be same as the key of this project config in the parent map. + * The project ID, should be same as the key of this project config in the + * parent map. * * Generated from protobuf field optional string project_id = 177513473; * @return string @@ -59,7 +62,8 @@ public function clearProjectId() } /** - * The project ID, should be same as the key of this project config in the parent map. + * The project ID, should be same as the key of this project config in the + * parent map. * * Generated from protobuf field optional string project_id = 177513473; * @param string $var diff --git a/Compute/src/V1/ShieldedInstanceConfig.php b/Compute/src/V1/ShieldedInstanceConfig.php index 81eded53679b..ff701815818e 100644 --- a/Compute/src/V1/ShieldedInstanceConfig.php +++ b/Compute/src/V1/ShieldedInstanceConfig.php @@ -16,19 +16,22 @@ class ShieldedInstanceConfig extends \Google\Protobuf\Internal\Message { /** - * Defines whether the instance has integrity monitoring enabled. Enabled by default. + * Defines whether the instance has integrity monitoring enabled.Enabled by + * default. * * Generated from protobuf field optional bool enable_integrity_monitoring = 409071030; */ protected $enable_integrity_monitoring = null; /** - * Defines whether the instance has Secure Boot enabled. Disabled by default. + * Defines whether the instance has Secure Boot enabled.Disabled by + * default. * * Generated from protobuf field optional bool enable_secure_boot = 123568638; */ protected $enable_secure_boot = null; /** - * Defines whether the instance has the vTPM enabled. Enabled by default. + * Defines whether the instance has the vTPM enabled.Enabled by + * default. * * Generated from protobuf field optional bool enable_vtpm = 181858935; */ @@ -41,11 +44,14 @@ class ShieldedInstanceConfig extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type bool $enable_integrity_monitoring - * Defines whether the instance has integrity monitoring enabled. Enabled by default. + * Defines whether the instance has integrity monitoring enabled.Enabled by + * default. * @type bool $enable_secure_boot - * Defines whether the instance has Secure Boot enabled. Disabled by default. + * Defines whether the instance has Secure Boot enabled.Disabled by + * default. * @type bool $enable_vtpm - * Defines whether the instance has the vTPM enabled. Enabled by default. + * Defines whether the instance has the vTPM enabled.Enabled by + * default. * } */ public function __construct($data = NULL) { @@ -54,7 +60,8 @@ public function __construct($data = NULL) { } /** - * Defines whether the instance has integrity monitoring enabled. Enabled by default. + * Defines whether the instance has integrity monitoring enabled.Enabled by + * default. * * Generated from protobuf field optional bool enable_integrity_monitoring = 409071030; * @return bool @@ -75,7 +82,8 @@ public function clearEnableIntegrityMonitoring() } /** - * Defines whether the instance has integrity monitoring enabled. Enabled by default. + * Defines whether the instance has integrity monitoring enabled.Enabled by + * default. * * Generated from protobuf field optional bool enable_integrity_monitoring = 409071030; * @param bool $var @@ -90,7 +98,8 @@ public function setEnableIntegrityMonitoring($var) } /** - * Defines whether the instance has Secure Boot enabled. Disabled by default. + * Defines whether the instance has Secure Boot enabled.Disabled by + * default. * * Generated from protobuf field optional bool enable_secure_boot = 123568638; * @return bool @@ -111,7 +120,8 @@ public function clearEnableSecureBoot() } /** - * Defines whether the instance has Secure Boot enabled. Disabled by default. + * Defines whether the instance has Secure Boot enabled.Disabled by + * default. * * Generated from protobuf field optional bool enable_secure_boot = 123568638; * @param bool $var @@ -126,7 +136,8 @@ public function setEnableSecureBoot($var) } /** - * Defines whether the instance has the vTPM enabled. Enabled by default. + * Defines whether the instance has the vTPM enabled.Enabled by + * default. * * Generated from protobuf field optional bool enable_vtpm = 181858935; * @return bool @@ -147,7 +158,8 @@ public function clearEnableVtpm() } /** - * Defines whether the instance has the vTPM enabled. Enabled by default. + * Defines whether the instance has the vTPM enabled.Enabled by + * default. * * Generated from protobuf field optional bool enable_vtpm = 181858935; * @param bool $var diff --git a/Compute/src/V1/ShieldedInstanceIdentity.php b/Compute/src/V1/ShieldedInstanceIdentity.php index bfb585c42f54..e2ad6e520392 100644 --- a/Compute/src/V1/ShieldedInstanceIdentity.php +++ b/Compute/src/V1/ShieldedInstanceIdentity.php @@ -16,19 +16,36 @@ class ShieldedInstanceIdentity extends \Google\Protobuf\Internal\Message { /** - * An Endorsement Key (EK) made by the RSA 2048 algorithm issued to the Shielded Instance's vTPM. + * An Endorsement Key (EK) made by the ECC P256 algorithm + * issued to the Shielded Instance's vTPM. + * + * Generated from protobuf field optional .google.cloud.compute.v1.ShieldedInstanceIdentityEntry ecc_p256_encryption_key = 469607365; + */ + protected $ecc_p256_encryption_key = null; + /** + * An Attestation Key (AK) made by the ECC P256 algorithm + * issued to the Shielded Instance's vTPM. + * + * Generated from protobuf field optional .google.cloud.compute.v1.ShieldedInstanceIdentityEntry ecc_p256_signing_key = 477678403; + */ + protected $ecc_p256_signing_key = null; + /** + * An Endorsement Key (EK) made by the RSA 2048 algorithm + * issued to the Shielded Instance's vTPM. * * Generated from protobuf field optional .google.cloud.compute.v1.ShieldedInstanceIdentityEntry encryption_key = 488268707; */ protected $encryption_key = null; /** - * [Output Only] Type of the resource. Always compute#shieldedInstanceIdentity for shielded Instance identity entry. + * [Output Only] Type of the resource. Alwayscompute#shieldedInstanceIdentity for shielded Instance + * identity entry. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * An Attestation Key (AK) made by the RSA 2048 algorithm issued to the Shielded Instance's vTPM. + * An Attestation Key (AK) made by the RSA 2048 algorithm + * issued to the Shielded Instance's vTPM. * * Generated from protobuf field optional .google.cloud.compute.v1.ShieldedInstanceIdentityEntry signing_key = 320948261; */ @@ -40,12 +57,21 @@ class ShieldedInstanceIdentity extends \Google\Protobuf\Internal\Message * @param array $data { * Optional. Data for populating the Message object. * + * @type \Google\Cloud\Compute\V1\ShieldedInstanceIdentityEntry $ecc_p256_encryption_key + * An Endorsement Key (EK) made by the ECC P256 algorithm + * issued to the Shielded Instance's vTPM. + * @type \Google\Cloud\Compute\V1\ShieldedInstanceIdentityEntry $ecc_p256_signing_key + * An Attestation Key (AK) made by the ECC P256 algorithm + * issued to the Shielded Instance's vTPM. * @type \Google\Cloud\Compute\V1\ShieldedInstanceIdentityEntry $encryption_key - * An Endorsement Key (EK) made by the RSA 2048 algorithm issued to the Shielded Instance's vTPM. + * An Endorsement Key (EK) made by the RSA 2048 algorithm + * issued to the Shielded Instance's vTPM. * @type string $kind - * [Output Only] Type of the resource. Always compute#shieldedInstanceIdentity for shielded Instance identity entry. + * [Output Only] Type of the resource. Alwayscompute#shieldedInstanceIdentity for shielded Instance + * identity entry. * @type \Google\Cloud\Compute\V1\ShieldedInstanceIdentityEntry $signing_key - * An Attestation Key (AK) made by the RSA 2048 algorithm issued to the Shielded Instance's vTPM. + * An Attestation Key (AK) made by the RSA 2048 algorithm + * issued to the Shielded Instance's vTPM. * } */ public function __construct($data = NULL) { @@ -54,7 +80,84 @@ public function __construct($data = NULL) { } /** - * An Endorsement Key (EK) made by the RSA 2048 algorithm issued to the Shielded Instance's vTPM. + * An Endorsement Key (EK) made by the ECC P256 algorithm + * issued to the Shielded Instance's vTPM. + * + * Generated from protobuf field optional .google.cloud.compute.v1.ShieldedInstanceIdentityEntry ecc_p256_encryption_key = 469607365; + * @return \Google\Cloud\Compute\V1\ShieldedInstanceIdentityEntry|null + */ + public function getEccP256EncryptionKey() + { + return $this->ecc_p256_encryption_key; + } + + public function hasEccP256EncryptionKey() + { + return isset($this->ecc_p256_encryption_key); + } + + public function clearEccP256EncryptionKey() + { + unset($this->ecc_p256_encryption_key); + } + + /** + * An Endorsement Key (EK) made by the ECC P256 algorithm + * issued to the Shielded Instance's vTPM. + * + * Generated from protobuf field optional .google.cloud.compute.v1.ShieldedInstanceIdentityEntry ecc_p256_encryption_key = 469607365; + * @param \Google\Cloud\Compute\V1\ShieldedInstanceIdentityEntry $var + * @return $this + */ + public function setEccP256EncryptionKey($var) + { + GPBUtil::checkMessage($var, \Google\Cloud\Compute\V1\ShieldedInstanceIdentityEntry::class); + $this->ecc_p256_encryption_key = $var; + + return $this; + } + + /** + * An Attestation Key (AK) made by the ECC P256 algorithm + * issued to the Shielded Instance's vTPM. + * + * Generated from protobuf field optional .google.cloud.compute.v1.ShieldedInstanceIdentityEntry ecc_p256_signing_key = 477678403; + * @return \Google\Cloud\Compute\V1\ShieldedInstanceIdentityEntry|null + */ + public function getEccP256SigningKey() + { + return $this->ecc_p256_signing_key; + } + + public function hasEccP256SigningKey() + { + return isset($this->ecc_p256_signing_key); + } + + public function clearEccP256SigningKey() + { + unset($this->ecc_p256_signing_key); + } + + /** + * An Attestation Key (AK) made by the ECC P256 algorithm + * issued to the Shielded Instance's vTPM. + * + * Generated from protobuf field optional .google.cloud.compute.v1.ShieldedInstanceIdentityEntry ecc_p256_signing_key = 477678403; + * @param \Google\Cloud\Compute\V1\ShieldedInstanceIdentityEntry $var + * @return $this + */ + public function setEccP256SigningKey($var) + { + GPBUtil::checkMessage($var, \Google\Cloud\Compute\V1\ShieldedInstanceIdentityEntry::class); + $this->ecc_p256_signing_key = $var; + + return $this; + } + + /** + * An Endorsement Key (EK) made by the RSA 2048 algorithm + * issued to the Shielded Instance's vTPM. * * Generated from protobuf field optional .google.cloud.compute.v1.ShieldedInstanceIdentityEntry encryption_key = 488268707; * @return \Google\Cloud\Compute\V1\ShieldedInstanceIdentityEntry|null @@ -75,7 +178,8 @@ public function clearEncryptionKey() } /** - * An Endorsement Key (EK) made by the RSA 2048 algorithm issued to the Shielded Instance's vTPM. + * An Endorsement Key (EK) made by the RSA 2048 algorithm + * issued to the Shielded Instance's vTPM. * * Generated from protobuf field optional .google.cloud.compute.v1.ShieldedInstanceIdentityEntry encryption_key = 488268707; * @param \Google\Cloud\Compute\V1\ShieldedInstanceIdentityEntry $var @@ -90,7 +194,8 @@ public function setEncryptionKey($var) } /** - * [Output Only] Type of the resource. Always compute#shieldedInstanceIdentity for shielded Instance identity entry. + * [Output Only] Type of the resource. Alwayscompute#shieldedInstanceIdentity for shielded Instance + * identity entry. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -111,7 +216,8 @@ public function clearKind() } /** - * [Output Only] Type of the resource. Always compute#shieldedInstanceIdentity for shielded Instance identity entry. + * [Output Only] Type of the resource. Alwayscompute#shieldedInstanceIdentity for shielded Instance + * identity entry. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -126,7 +232,8 @@ public function setKind($var) } /** - * An Attestation Key (AK) made by the RSA 2048 algorithm issued to the Shielded Instance's vTPM. + * An Attestation Key (AK) made by the RSA 2048 algorithm + * issued to the Shielded Instance's vTPM. * * Generated from protobuf field optional .google.cloud.compute.v1.ShieldedInstanceIdentityEntry signing_key = 320948261; * @return \Google\Cloud\Compute\V1\ShieldedInstanceIdentityEntry|null @@ -147,7 +254,8 @@ public function clearSigningKey() } /** - * An Attestation Key (AK) made by the RSA 2048 algorithm issued to the Shielded Instance's vTPM. + * An Attestation Key (AK) made by the RSA 2048 algorithm + * issued to the Shielded Instance's vTPM. * * Generated from protobuf field optional .google.cloud.compute.v1.ShieldedInstanceIdentityEntry signing_key = 320948261; * @param \Google\Cloud\Compute\V1\ShieldedInstanceIdentityEntry $var diff --git a/Compute/src/V1/ShieldedInstanceIntegrityPolicy.php b/Compute/src/V1/ShieldedInstanceIntegrityPolicy.php index a8f02bfc3e65..a7ddc5416cb4 100644 --- a/Compute/src/V1/ShieldedInstanceIntegrityPolicy.php +++ b/Compute/src/V1/ShieldedInstanceIntegrityPolicy.php @@ -9,14 +9,16 @@ use Google\Protobuf\Internal\GPBUtil; /** - * The policy describes the baseline against which Instance boot integrity is measured. + * The policy describes the baseline against which + * Instance boot integrity is measured. * * Generated from protobuf message google.cloud.compute.v1.ShieldedInstanceIntegrityPolicy */ class ShieldedInstanceIntegrityPolicy extends \Google\Protobuf\Internal\Message { /** - * Updates the integrity policy baseline using the measurements from the VM instance's most recent boot. + * Updates the integrity policy baseline using the + * measurements from the VM instance's most recent boot. * * Generated from protobuf field optional bool update_auto_learn_policy = 245490215; */ @@ -29,7 +31,8 @@ class ShieldedInstanceIntegrityPolicy extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type bool $update_auto_learn_policy - * Updates the integrity policy baseline using the measurements from the VM instance's most recent boot. + * Updates the integrity policy baseline using the + * measurements from the VM instance's most recent boot. * } */ public function __construct($data = NULL) { @@ -38,7 +41,8 @@ public function __construct($data = NULL) { } /** - * Updates the integrity policy baseline using the measurements from the VM instance's most recent boot. + * Updates the integrity policy baseline using the + * measurements from the VM instance's most recent boot. * * Generated from protobuf field optional bool update_auto_learn_policy = 245490215; * @return bool @@ -59,7 +63,8 @@ public function clearUpdateAutoLearnPolicy() } /** - * Updates the integrity policy baseline using the measurements from the VM instance's most recent boot. + * Updates the integrity policy baseline using the + * measurements from the VM instance's most recent boot. * * Generated from protobuf field optional bool update_auto_learn_policy = 245490215; * @param bool $var diff --git a/Compute/src/V1/SignedUrlKey.php b/Compute/src/V1/SignedUrlKey.php index 692d45166f6b..3bf3fd03512c 100644 --- a/Compute/src/V1/SignedUrlKey.php +++ b/Compute/src/V1/SignedUrlKey.php @@ -16,13 +16,19 @@ class SignedUrlKey extends \Google\Protobuf\Internal\Message { /** - * Name of the key. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the key. The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * * Generated from protobuf field optional string key_name = 500938859; */ protected $key_name = null; /** - * 128-bit key value used for signing the URL. The key value must be a valid RFC 4648 Section 5 base64url encoded string. + * 128-bit key value used for signing the URL. The key value must be a validRFC + * 4648 Section 5 base64url encoded string. * * Generated from protobuf field optional string key_value = 504106897; */ @@ -35,9 +41,15 @@ class SignedUrlKey extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $key_name - * Name of the key. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the key. The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * @type string $key_value - * 128-bit key value used for signing the URL. The key value must be a valid RFC 4648 Section 5 base64url encoded string. + * 128-bit key value used for signing the URL. The key value must be a validRFC + * 4648 Section 5 base64url encoded string. * } */ public function __construct($data = NULL) { @@ -46,7 +58,12 @@ public function __construct($data = NULL) { } /** - * Name of the key. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the key. The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * * Generated from protobuf field optional string key_name = 500938859; * @return string @@ -67,7 +84,12 @@ public function clearKeyName() } /** - * Name of the key. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the key. The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * * Generated from protobuf field optional string key_name = 500938859; * @param string $var @@ -82,7 +104,8 @@ public function setKeyName($var) } /** - * 128-bit key value used for signing the URL. The key value must be a valid RFC 4648 Section 5 base64url encoded string. + * 128-bit key value used for signing the URL. The key value must be a validRFC + * 4648 Section 5 base64url encoded string. * * Generated from protobuf field optional string key_value = 504106897; * @return string @@ -103,7 +126,8 @@ public function clearKeyValue() } /** - * 128-bit key value used for signing the URL. The key value must be a valid RFC 4648 Section 5 base64url encoded string. + * 128-bit key value used for signing the URL. The key value must be a validRFC + * 4648 Section 5 base64url encoded string. * * Generated from protobuf field optional string key_value = 504106897; * @param string $var diff --git a/Compute/src/V1/SimulateMaintenanceEventInstanceRequest.php b/Compute/src/V1/SimulateMaintenanceEventInstanceRequest.php index 41bdb9212ba9..3ab2e3fe1baf 100644 --- a/Compute/src/V1/SimulateMaintenanceEventInstanceRequest.php +++ b/Compute/src/V1/SimulateMaintenanceEventInstanceRequest.php @@ -28,13 +28,24 @@ class SimulateMaintenanceEventInstanceRequest extends \Google\Protobuf\Internal\ */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ protected $request_id = null; /** - * Determines whether the customers receive notifications before migration. Only applicable to SF vms. + * Determines whether the customers receive notifications before migration. + * Only applicable to SF vms. * * Generated from protobuf field optional bool with_extended_notifications = 405957627; */ @@ -74,9 +85,20 @@ public static function build(string $project, string $zone, string $instance): s * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type bool $with_extended_notifications - * Determines whether the customers receive notifications before migration. Only applicable to SF vms. + * Determines whether the customers receive notifications before migration. + * Only applicable to SF vms. * @type string $zone * The name of the zone for this request. * } @@ -139,7 +161,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -160,7 +192,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var @@ -175,7 +217,8 @@ public function setRequestId($var) } /** - * Determines whether the customers receive notifications before migration. Only applicable to SF vms. + * Determines whether the customers receive notifications before migration. + * Only applicable to SF vms. * * Generated from protobuf field optional bool with_extended_notifications = 405957627; * @return bool @@ -196,7 +239,8 @@ public function clearWithExtendedNotifications() } /** - * Determines whether the customers receive notifications before migration. Only applicable to SF vms. + * Determines whether the customers receive notifications before migration. + * Only applicable to SF vms. * * Generated from protobuf field optional bool with_extended_notifications = 405957627; * @param bool $var diff --git a/Compute/src/V1/SimulateMaintenanceEventNodeGroupRequest.php b/Compute/src/V1/SimulateMaintenanceEventNodeGroupRequest.php index d6a66d782911..23ad546ee521 100644 --- a/Compute/src/V1/SimulateMaintenanceEventNodeGroupRequest.php +++ b/Compute/src/V1/SimulateMaintenanceEventNodeGroupRequest.php @@ -16,7 +16,8 @@ class SimulateMaintenanceEventNodeGroupRequest extends \Google\Protobuf\Internal\Message { /** - * Name of the NodeGroup resource whose nodes will go under maintenance simulation. + * Name of the NodeGroup resource whose nodes will go under maintenance + * simulation. * * Generated from protobuf field string node_group = 469958146 [(.google.api.field_behavior) = REQUIRED]; */ @@ -34,7 +35,17 @@ class SimulateMaintenanceEventNodeGroupRequest extends \Google\Protobuf\Internal */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -49,7 +60,8 @@ class SimulateMaintenanceEventNodeGroupRequest extends \Google\Protobuf\Internal /** * @param string $project Project ID for this request. * @param string $zone The name of the zone for this request. - * @param string $nodeGroup Name of the NodeGroup resource whose nodes will go under maintenance simulation. + * @param string $nodeGroup Name of the NodeGroup resource whose nodes will go under maintenance + * simulation. * @param \Google\Cloud\Compute\V1\NodeGroupsSimulateMaintenanceEventRequest $nodeGroupsSimulateMaintenanceEventRequestResource The body resource for this request * * @return \Google\Cloud\Compute\V1\SimulateMaintenanceEventNodeGroupRequest @@ -72,13 +84,24 @@ public static function build(string $project, string $zone, string $nodeGroup, \ * Optional. Data for populating the Message object. * * @type string $node_group - * Name of the NodeGroup resource whose nodes will go under maintenance simulation. + * Name of the NodeGroup resource whose nodes will go under maintenance + * simulation. * @type \Google\Cloud\Compute\V1\NodeGroupsSimulateMaintenanceEventRequest $node_groups_simulate_maintenance_event_request_resource * The body resource for this request * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $zone * The name of the zone for this request. * } @@ -89,7 +112,8 @@ public function __construct($data = NULL) { } /** - * Name of the NodeGroup resource whose nodes will go under maintenance simulation. + * Name of the NodeGroup resource whose nodes will go under maintenance + * simulation. * * Generated from protobuf field string node_group = 469958146 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -100,7 +124,8 @@ public function getNodeGroup() } /** - * Name of the NodeGroup resource whose nodes will go under maintenance simulation. + * Name of the NodeGroup resource whose nodes will go under maintenance + * simulation. * * Generated from protobuf field string node_group = 469958146 [(.google.api.field_behavior) = REQUIRED]; * @param string $var @@ -177,7 +202,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -198,7 +233,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/Snapshot.php b/Compute/src/V1/Snapshot.php index 28109048dd21..9b606febc615 100644 --- a/Compute/src/V1/Snapshot.php +++ b/Compute/src/V1/Snapshot.php @@ -9,27 +9,37 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Represents a Persistent Disk Snapshot resource. You can use snapshots to back up data on a regular interval. For more information, read Creating persistent disk snapshots. + * Represents a Persistent Disk Snapshot resource. + * You can use snapshots to back up data on a regular interval. For more + * information, read Creating + * persistent disk snapshots. * * Generated from protobuf message google.cloud.compute.v1.Snapshot */ class Snapshot extends \Google\Protobuf\Internal\Message { /** - * [Output Only] The architecture of the snapshot. Valid values are ARM64 or X86_64. + * [Output Only] The architecture of the snapshot. Valid values are + * ARM64 or X86_64. * Check the Architecture enum for the list of possible values. * * Generated from protobuf field optional string architecture = 302803283; */ protected $architecture = null; /** - * [Output Only] Set to true if snapshots are automatically created by applying resource policy on the target disk. + * [Output Only] Set to true if snapshots are automatically created by + * applying resource policy on the target disk. * * Generated from protobuf field optional bool auto_created = 463922264; */ protected $auto_created = null; /** - * Creates the new snapshot in the snapshot chain labeled with the specified name. The chain name must be 1-63 characters long and comply with RFC1035. This is an uncommon option only for advanced service owners who needs to create separate snapshot chains, for example, for chargeback tracking. When you describe your snapshot resource, this field is visible only if it has a non-empty value. + * Creates the new snapshot in the snapshot chain labeled with the + * specified name. The chain name must be 1-63 characters long and comply + * with RFC1035. This is an uncommon option only for advanced service + * owners who needs to create separate snapshot chains, for example, + * for chargeback tracking. When you describe your snapshot resource, this + * field is visible only if it has a non-empty value. * * Generated from protobuf field optional string chain_name = 68644169; */ @@ -41,13 +51,15 @@ class Snapshot extends \Google\Protobuf\Internal\Message */ protected $creation_size_bytes = null; /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; */ protected $creation_timestamp = null; /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; */ @@ -65,73 +77,101 @@ class Snapshot extends \Google\Protobuf\Internal\Message */ protected $download_bytes = null; /** - * Whether this snapshot is created from a confidential compute mode disk. [Output Only]: This field is not set by user, but from source disk. + * Whether this snapshot is created from a confidential compute mode disk. + * [Output Only]: This field is not set by user, but from source disk. * * Generated from protobuf field optional bool enable_confidential_compute = 102135228; */ protected $enable_confidential_compute = null; /** - * [Input Only] Whether to attempt an application consistent snapshot by informing the OS to prepare for the snapshot process. + * [Input Only] Whether to attempt an application consistent snapshot by + * informing the OS to prepare for the snapshot process. * * Generated from protobuf field optional bool guest_flush = 385550813; */ protected $guest_flush = null; /** - * [Output Only] A list of features to enable on the guest operating system. Applicable only for bootable images. Read Enabling guest operating system features to see a list of available options. + * [Output Only] A list of features to enable on the guest operating system. + * Applicable only for bootable images. Read + * Enabling guest operating system features to see a list of available + * options. * * Generated from protobuf field repeated .google.cloud.compute.v1.GuestOsFeature guest_os_features = 79294545; */ private $guest_os_features; /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; */ protected $id = null; /** - * [Output Only] Type of the resource. Always compute#snapshot for Snapshot resources. + * [Output Only] Type of the resource. Always compute#snapshot + * for Snapshot resources. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * A fingerprint for the labels being applied to this snapshot, which is essentially a hash of the labels set used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a snapshot. + * A fingerprint for the labels being applied to this snapshot, which is + * essentially a hash of the labels set used for optimistic locking. The + * fingerprint is initially generated by Compute Engine and changes after + * every request to modify or update labels. You must always provide an + * up-to-date fingerprint hash in order to update or change labels, + * otherwise the request will fail with error412 conditionNotMet. + * To see the latest fingerprint, make a get() request to + * retrieve a snapshot. * * Generated from protobuf field optional string label_fingerprint = 178124825; */ protected $label_fingerprint = null; /** - * Labels to apply to this snapshot. These can be later modified by the setLabels method. Label values may be empty. + * Labels to apply to this snapshot. These can be later modified by + * the setLabels method. + * Label values may be empty. * * Generated from protobuf field map labels = 500195327; */ private $labels; /** - * [Output Only] Integer license codes indicating which licenses are attached to this snapshot. + * [Output Only] Integer license codes indicating which licenses are attached + * to this snapshot. * * Generated from protobuf field repeated int64 license_codes = 45482664; */ private $license_codes; /** - * [Output Only] A list of public visible licenses that apply to this snapshot. This can be because the original image had licenses attached (such as a Windows image). + * [Output Only] A list of public visible licenses that apply to this + * snapshot. This can be because the original image had licenses attached + * (such as a Windows image). * * Generated from protobuf field repeated string licenses = 337642578; */ private $licenses; /** - * An opaque location hint used to place the snapshot close to other resources. This field is for use by internal tools that use the public API. + * An opaque location hint used to place the snapshot close to other + * resources. + * This field is for use by internal tools that use the public API. * * Generated from protobuf field optional string location_hint = 350519505; */ protected $location_hint = null; /** - * Name of the resource; provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource; provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must be + * a dash, lowercase letter, or digit, except the last character, which cannot + * be a dash. * * Generated from protobuf field optional string name = 3373707; */ protected $name = null; /** - * Input only. [Input Only] Additional params passed with the request, but not persisted as part of resource payload. + * Input only. [Input Only] Additional params passed with the request, but not persisted + * as part of resource payload. * * Generated from protobuf field optional .google.cloud.compute.v1.SnapshotParams params = 78313862; */ @@ -155,7 +195,17 @@ class Snapshot extends \Google\Protobuf\Internal\Message */ protected $self_link = null; /** - * Encrypts the snapshot using a customer-supplied encryption key. After you encrypt a snapshot using a customer-supplied key, you must provide the same key if you use the snapshot later. For example, you must provide the encryption key when you create a disk from the encrypted snapshot in a future request. Customer-supplied encryption keys do not protect access to metadata of the snapshot. If you do not provide an encryption key when creating the snapshot, then the snapshot will be encrypted using an automatically generated key and you do not need to provide a key to use the snapshot later. + * Encrypts the snapshot using acustomer-supplied + * encryption key. + * After you encrypt a snapshot using a customer-supplied key, you must + * provide the same key if you use the snapshot later. For example, you must + * provide the encryption key when you create a disk from the encrypted + * snapshot in a future request. + * Customer-supplied encryption keys do not protect access to metadata + * of the snapshot. + * If you do not provide an encryption key when creating the snapshot, then + * the snapshot will be encrypted using an automatically generated key and you + * do not need to provide a key to use the snapshot later. * * Generated from protobuf field optional .google.cloud.compute.v1.CustomerEncryptionKey snapshot_encryption_key = 43334526; */ @@ -174,75 +224,100 @@ class Snapshot extends \Google\Protobuf\Internal\Message */ protected $source_disk = null; /** - * The customer-supplied encryption key of the source disk. Required if the source disk is protected by a customer-supplied encryption key. + * The customer-supplied + * encryption key of the source disk. Required if the source disk is + * protected by a customer-supplied encryption key. * * Generated from protobuf field optional .google.cloud.compute.v1.CustomerEncryptionKey source_disk_encryption_key = 531501153; */ protected $source_disk_encryption_key = null; /** - * The source disk whose recovery checkpoint will be used to create this snapshot. + * The source disk whose recovery checkpoint will be used to create this + * snapshot. * * Generated from protobuf field optional string source_disk_for_recovery_checkpoint = 359837950; */ protected $source_disk_for_recovery_checkpoint = null; /** - * [Output Only] The ID value of the disk used to create this snapshot. This value may be used to determine whether the snapshot was taken from the current or a previous instance of a given disk name. + * [Output Only] The ID value of the disk used to create this snapshot. This + * value may be used to determine whether the snapshot was taken from the + * current or a previous instance of a given disk name. * * Generated from protobuf field optional string source_disk_id = 454190809; */ protected $source_disk_id = null; /** - * The source instant snapshot used to create this snapshot. You can provide this as a partial or full URL to the resource. For example, the following are valid values: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /instantSnapshots/instantSnapshot - projects/project/zones/zone/instantSnapshots/instantSnapshot - zones/zone/instantSnapshots/instantSnapshot + * The source instant snapshot used to create this snapshot. You can provide + * this as a partial or full URL to the resource. For example, the following + * are valid values: + * - https://www.googleapis.com/compute/v1/projects/project/zones/zone/instantSnapshots/instantSnapshot + * - projects/project/zones/zone/instantSnapshots/instantSnapshot + * - zones/zone/instantSnapshots/instantSnapshot * * Generated from protobuf field optional string source_instant_snapshot = 219202054; */ protected $source_instant_snapshot = null; /** - * Customer provided encryption key when creating Snapshot from Instant Snapshot. + * Customer provided encryption key when creating Snapshot from Instant + * Snapshot. * * Generated from protobuf field optional .google.cloud.compute.v1.CustomerEncryptionKey source_instant_snapshot_encryption_key = 436536060; */ protected $source_instant_snapshot_encryption_key = null; /** - * [Output Only] The unique ID of the instant snapshot used to create this snapshot. This value identifies the exact instant snapshot that was used to create this snapshot. For example, if you created the snapshot from an instant snapshot that was later deleted and recreated under the same name, the source instant snapshot ID would identify the exact instant snapshot that was used. + * [Output Only] The unique ID of the instant snapshot used to create this + * snapshot. This value identifies the exact instant snapshot that was used to + * create this snapshot. For example, if you created the snapshot from an + * instant snapshot that was later deleted and recreated under the same name, + * the source instant snapshot ID would identify the exact instant snapshot + * that was used. * * Generated from protobuf field optional string source_instant_snapshot_id = 287582708; */ protected $source_instant_snapshot_id = null; /** - * [Output Only] URL of the resource policy which created this scheduled snapshot. + * [Output Only] URL of the resource policy which created this + * scheduled snapshot. * * Generated from protobuf field optional string source_snapshot_schedule_policy = 235756291; */ protected $source_snapshot_schedule_policy = null; /** - * [Output Only] ID of the resource policy which created this scheduled snapshot. + * [Output Only] ID of the resource policy which created this + * scheduled snapshot. * * Generated from protobuf field optional string source_snapshot_schedule_policy_id = 70489047; */ protected $source_snapshot_schedule_policy_id = null; /** - * [Output Only] The status of the snapshot. This can be CREATING, DELETING, FAILED, READY, or UPLOADING. + * [Output Only] The status of the snapshot. This can beCREATING, DELETING, FAILED,READY, or UPLOADING. * Check the Status enum for the list of possible values. * * Generated from protobuf field optional string status = 181260274; */ protected $status = null; /** - * [Output Only] A size of the storage used by the snapshot. As snapshots share storage, this number is expected to change with snapshot creation/deletion. + * [Output Only] A size of the storage used by the snapshot. As snapshots + * share storage, this number is expected to change with snapshot + * creation/deletion. * * Generated from protobuf field optional int64 storage_bytes = 424631719; */ protected $storage_bytes = null; /** - * [Output Only] An indicator whether storageBytes is in a stable state or it is being adjusted as a result of shared storage reallocation. This status can either be UPDATING, meaning the size of the snapshot is being updated, or UP_TO_DATE, meaning the size of the snapshot is up-to-date. + * [Output Only] An indicator whether storageBytes is in a + * stable state or it is being adjusted as a result of shared storage + * reallocation. This status can either be UPDATING, meaning + * the size of the snapshot is being updated, or UP_TO_DATE, + * meaning the size of the snapshot is up-to-date. * Check the StorageBytesStatus enum for the list of possible values. * * Generated from protobuf field optional string storage_bytes_status = 490739082; */ protected $storage_bytes_status = null; /** - * Cloud Storage bucket storage location of the snapshot (regional or multi-regional). + * Cloud Storage bucket storage location of the snapshot (regional or + * multi-regional). * * Generated from protobuf field repeated string storage_locations = 328005274; */ @@ -255,46 +330,83 @@ class Snapshot extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $architecture - * [Output Only] The architecture of the snapshot. Valid values are ARM64 or X86_64. + * [Output Only] The architecture of the snapshot. Valid values are + * ARM64 or X86_64. * Check the Architecture enum for the list of possible values. * @type bool $auto_created - * [Output Only] Set to true if snapshots are automatically created by applying resource policy on the target disk. + * [Output Only] Set to true if snapshots are automatically created by + * applying resource policy on the target disk. * @type string $chain_name - * Creates the new snapshot in the snapshot chain labeled with the specified name. The chain name must be 1-63 characters long and comply with RFC1035. This is an uncommon option only for advanced service owners who needs to create separate snapshot chains, for example, for chargeback tracking. When you describe your snapshot resource, this field is visible only if it has a non-empty value. + * Creates the new snapshot in the snapshot chain labeled with the + * specified name. The chain name must be 1-63 characters long and comply + * with RFC1035. This is an uncommon option only for advanced service + * owners who needs to create separate snapshot chains, for example, + * for chargeback tracking. When you describe your snapshot resource, this + * field is visible only if it has a non-empty value. * @type int|string $creation_size_bytes * [Output Only] Size in bytes of the snapshot at creation time. * @type string $creation_timestamp - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * @type string $description - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * @type int|string $disk_size_gb * [Output Only] Size of the source disk, specified in GB. * @type int|string $download_bytes * [Output Only] Number of bytes downloaded to restore a snapshot to a disk. * @type bool $enable_confidential_compute - * Whether this snapshot is created from a confidential compute mode disk. [Output Only]: This field is not set by user, but from source disk. + * Whether this snapshot is created from a confidential compute mode disk. + * [Output Only]: This field is not set by user, but from source disk. * @type bool $guest_flush - * [Input Only] Whether to attempt an application consistent snapshot by informing the OS to prepare for the snapshot process. + * [Input Only] Whether to attempt an application consistent snapshot by + * informing the OS to prepare for the snapshot process. * @type array<\Google\Cloud\Compute\V1\GuestOsFeature>|\Google\Protobuf\Internal\RepeatedField $guest_os_features - * [Output Only] A list of features to enable on the guest operating system. Applicable only for bootable images. Read Enabling guest operating system features to see a list of available options. + * [Output Only] A list of features to enable on the guest operating system. + * Applicable only for bootable images. Read + * Enabling guest operating system features to see a list of available + * options. * @type int|string $id - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * @type string $kind - * [Output Only] Type of the resource. Always compute#snapshot for Snapshot resources. + * [Output Only] Type of the resource. Always compute#snapshot + * for Snapshot resources. * @type string $label_fingerprint - * A fingerprint for the labels being applied to this snapshot, which is essentially a hash of the labels set used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a snapshot. + * A fingerprint for the labels being applied to this snapshot, which is + * essentially a hash of the labels set used for optimistic locking. The + * fingerprint is initially generated by Compute Engine and changes after + * every request to modify or update labels. You must always provide an + * up-to-date fingerprint hash in order to update or change labels, + * otherwise the request will fail with error412 conditionNotMet. + * To see the latest fingerprint, make a get() request to + * retrieve a snapshot. * @type array|\Google\Protobuf\Internal\MapField $labels - * Labels to apply to this snapshot. These can be later modified by the setLabels method. Label values may be empty. + * Labels to apply to this snapshot. These can be later modified by + * the setLabels method. + * Label values may be empty. * @type array|array|\Google\Protobuf\Internal\RepeatedField $license_codes - * [Output Only] Integer license codes indicating which licenses are attached to this snapshot. + * [Output Only] Integer license codes indicating which licenses are attached + * to this snapshot. * @type array|\Google\Protobuf\Internal\RepeatedField $licenses - * [Output Only] A list of public visible licenses that apply to this snapshot. This can be because the original image had licenses attached (such as a Windows image). + * [Output Only] A list of public visible licenses that apply to this + * snapshot. This can be because the original image had licenses attached + * (such as a Windows image). * @type string $location_hint - * An opaque location hint used to place the snapshot close to other resources. This field is for use by internal tools that use the public API. + * An opaque location hint used to place the snapshot close to other + * resources. + * This field is for use by internal tools that use the public API. * @type string $name - * Name of the resource; provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource; provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must be + * a dash, lowercase letter, or digit, except the last character, which cannot + * be a dash. * @type \Google\Cloud\Compute\V1\SnapshotParams $params - * Input only. [Input Only] Additional params passed with the request, but not persisted as part of resource payload. + * Input only. [Input Only] Additional params passed with the request, but not persisted + * as part of resource payload. * @type bool $satisfies_pzi * Output only. Reserved for future use. * @type bool $satisfies_pzs @@ -302,38 +414,73 @@ class Snapshot extends \Google\Protobuf\Internal\Message * @type string $self_link * [Output Only] Server-defined URL for the resource. * @type \Google\Cloud\Compute\V1\CustomerEncryptionKey $snapshot_encryption_key - * Encrypts the snapshot using a customer-supplied encryption key. After you encrypt a snapshot using a customer-supplied key, you must provide the same key if you use the snapshot later. For example, you must provide the encryption key when you create a disk from the encrypted snapshot in a future request. Customer-supplied encryption keys do not protect access to metadata of the snapshot. If you do not provide an encryption key when creating the snapshot, then the snapshot will be encrypted using an automatically generated key and you do not need to provide a key to use the snapshot later. + * Encrypts the snapshot using acustomer-supplied + * encryption key. + * After you encrypt a snapshot using a customer-supplied key, you must + * provide the same key if you use the snapshot later. For example, you must + * provide the encryption key when you create a disk from the encrypted + * snapshot in a future request. + * Customer-supplied encryption keys do not protect access to metadata + * of the snapshot. + * If you do not provide an encryption key when creating the snapshot, then + * the snapshot will be encrypted using an automatically generated key and you + * do not need to provide a key to use the snapshot later. * @type string $snapshot_type * Indicates the type of the snapshot. * Check the SnapshotType enum for the list of possible values. * @type string $source_disk * The source disk used to create this snapshot. * @type \Google\Cloud\Compute\V1\CustomerEncryptionKey $source_disk_encryption_key - * The customer-supplied encryption key of the source disk. Required if the source disk is protected by a customer-supplied encryption key. + * The customer-supplied + * encryption key of the source disk. Required if the source disk is + * protected by a customer-supplied encryption key. * @type string $source_disk_for_recovery_checkpoint - * The source disk whose recovery checkpoint will be used to create this snapshot. + * The source disk whose recovery checkpoint will be used to create this + * snapshot. * @type string $source_disk_id - * [Output Only] The ID value of the disk used to create this snapshot. This value may be used to determine whether the snapshot was taken from the current or a previous instance of a given disk name. + * [Output Only] The ID value of the disk used to create this snapshot. This + * value may be used to determine whether the snapshot was taken from the + * current or a previous instance of a given disk name. * @type string $source_instant_snapshot - * The source instant snapshot used to create this snapshot. You can provide this as a partial or full URL to the resource. For example, the following are valid values: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /instantSnapshots/instantSnapshot - projects/project/zones/zone/instantSnapshots/instantSnapshot - zones/zone/instantSnapshots/instantSnapshot + * The source instant snapshot used to create this snapshot. You can provide + * this as a partial or full URL to the resource. For example, the following + * are valid values: + * - https://www.googleapis.com/compute/v1/projects/project/zones/zone/instantSnapshots/instantSnapshot + * - projects/project/zones/zone/instantSnapshots/instantSnapshot + * - zones/zone/instantSnapshots/instantSnapshot * @type \Google\Cloud\Compute\V1\CustomerEncryptionKey $source_instant_snapshot_encryption_key - * Customer provided encryption key when creating Snapshot from Instant Snapshot. + * Customer provided encryption key when creating Snapshot from Instant + * Snapshot. * @type string $source_instant_snapshot_id - * [Output Only] The unique ID of the instant snapshot used to create this snapshot. This value identifies the exact instant snapshot that was used to create this snapshot. For example, if you created the snapshot from an instant snapshot that was later deleted and recreated under the same name, the source instant snapshot ID would identify the exact instant snapshot that was used. + * [Output Only] The unique ID of the instant snapshot used to create this + * snapshot. This value identifies the exact instant snapshot that was used to + * create this snapshot. For example, if you created the snapshot from an + * instant snapshot that was later deleted and recreated under the same name, + * the source instant snapshot ID would identify the exact instant snapshot + * that was used. * @type string $source_snapshot_schedule_policy - * [Output Only] URL of the resource policy which created this scheduled snapshot. + * [Output Only] URL of the resource policy which created this + * scheduled snapshot. * @type string $source_snapshot_schedule_policy_id - * [Output Only] ID of the resource policy which created this scheduled snapshot. + * [Output Only] ID of the resource policy which created this + * scheduled snapshot. * @type string $status - * [Output Only] The status of the snapshot. This can be CREATING, DELETING, FAILED, READY, or UPLOADING. + * [Output Only] The status of the snapshot. This can beCREATING, DELETING, FAILED,READY, or UPLOADING. * Check the Status enum for the list of possible values. * @type int|string $storage_bytes - * [Output Only] A size of the storage used by the snapshot. As snapshots share storage, this number is expected to change with snapshot creation/deletion. + * [Output Only] A size of the storage used by the snapshot. As snapshots + * share storage, this number is expected to change with snapshot + * creation/deletion. * @type string $storage_bytes_status - * [Output Only] An indicator whether storageBytes is in a stable state or it is being adjusted as a result of shared storage reallocation. This status can either be UPDATING, meaning the size of the snapshot is being updated, or UP_TO_DATE, meaning the size of the snapshot is up-to-date. + * [Output Only] An indicator whether storageBytes is in a + * stable state or it is being adjusted as a result of shared storage + * reallocation. This status can either be UPDATING, meaning + * the size of the snapshot is being updated, or UP_TO_DATE, + * meaning the size of the snapshot is up-to-date. * Check the StorageBytesStatus enum for the list of possible values. * @type array|\Google\Protobuf\Internal\RepeatedField $storage_locations - * Cloud Storage bucket storage location of the snapshot (regional or multi-regional). + * Cloud Storage bucket storage location of the snapshot (regional or + * multi-regional). * } */ public function __construct($data = NULL) { @@ -342,7 +489,8 @@ public function __construct($data = NULL) { } /** - * [Output Only] The architecture of the snapshot. Valid values are ARM64 or X86_64. + * [Output Only] The architecture of the snapshot. Valid values are + * ARM64 or X86_64. * Check the Architecture enum for the list of possible values. * * Generated from protobuf field optional string architecture = 302803283; @@ -364,7 +512,8 @@ public function clearArchitecture() } /** - * [Output Only] The architecture of the snapshot. Valid values are ARM64 or X86_64. + * [Output Only] The architecture of the snapshot. Valid values are + * ARM64 or X86_64. * Check the Architecture enum for the list of possible values. * * Generated from protobuf field optional string architecture = 302803283; @@ -380,7 +529,8 @@ public function setArchitecture($var) } /** - * [Output Only] Set to true if snapshots are automatically created by applying resource policy on the target disk. + * [Output Only] Set to true if snapshots are automatically created by + * applying resource policy on the target disk. * * Generated from protobuf field optional bool auto_created = 463922264; * @return bool @@ -401,7 +551,8 @@ public function clearAutoCreated() } /** - * [Output Only] Set to true if snapshots are automatically created by applying resource policy on the target disk. + * [Output Only] Set to true if snapshots are automatically created by + * applying resource policy on the target disk. * * Generated from protobuf field optional bool auto_created = 463922264; * @param bool $var @@ -416,7 +567,12 @@ public function setAutoCreated($var) } /** - * Creates the new snapshot in the snapshot chain labeled with the specified name. The chain name must be 1-63 characters long and comply with RFC1035. This is an uncommon option only for advanced service owners who needs to create separate snapshot chains, for example, for chargeback tracking. When you describe your snapshot resource, this field is visible only if it has a non-empty value. + * Creates the new snapshot in the snapshot chain labeled with the + * specified name. The chain name must be 1-63 characters long and comply + * with RFC1035. This is an uncommon option only for advanced service + * owners who needs to create separate snapshot chains, for example, + * for chargeback tracking. When you describe your snapshot resource, this + * field is visible only if it has a non-empty value. * * Generated from protobuf field optional string chain_name = 68644169; * @return string @@ -437,7 +593,12 @@ public function clearChainName() } /** - * Creates the new snapshot in the snapshot chain labeled with the specified name. The chain name must be 1-63 characters long and comply with RFC1035. This is an uncommon option only for advanced service owners who needs to create separate snapshot chains, for example, for chargeback tracking. When you describe your snapshot resource, this field is visible only if it has a non-empty value. + * Creates the new snapshot in the snapshot chain labeled with the + * specified name. The chain name must be 1-63 characters long and comply + * with RFC1035. This is an uncommon option only for advanced service + * owners who needs to create separate snapshot chains, for example, + * for chargeback tracking. When you describe your snapshot resource, this + * field is visible only if it has a non-empty value. * * Generated from protobuf field optional string chain_name = 68644169; * @param string $var @@ -488,7 +649,8 @@ public function setCreationSizeBytes($var) } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @return string @@ -509,7 +671,8 @@ public function clearCreationTimestamp() } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @param string $var @@ -524,7 +687,8 @@ public function setCreationTimestamp($var) } /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @return string @@ -545,7 +709,8 @@ public function clearDescription() } /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @param string $var @@ -632,7 +797,8 @@ public function setDownloadBytes($var) } /** - * Whether this snapshot is created from a confidential compute mode disk. [Output Only]: This field is not set by user, but from source disk. + * Whether this snapshot is created from a confidential compute mode disk. + * [Output Only]: This field is not set by user, but from source disk. * * Generated from protobuf field optional bool enable_confidential_compute = 102135228; * @return bool @@ -653,7 +819,8 @@ public function clearEnableConfidentialCompute() } /** - * Whether this snapshot is created from a confidential compute mode disk. [Output Only]: This field is not set by user, but from source disk. + * Whether this snapshot is created from a confidential compute mode disk. + * [Output Only]: This field is not set by user, but from source disk. * * Generated from protobuf field optional bool enable_confidential_compute = 102135228; * @param bool $var @@ -668,7 +835,8 @@ public function setEnableConfidentialCompute($var) } /** - * [Input Only] Whether to attempt an application consistent snapshot by informing the OS to prepare for the snapshot process. + * [Input Only] Whether to attempt an application consistent snapshot by + * informing the OS to prepare for the snapshot process. * * Generated from protobuf field optional bool guest_flush = 385550813; * @return bool @@ -689,7 +857,8 @@ public function clearGuestFlush() } /** - * [Input Only] Whether to attempt an application consistent snapshot by informing the OS to prepare for the snapshot process. + * [Input Only] Whether to attempt an application consistent snapshot by + * informing the OS to prepare for the snapshot process. * * Generated from protobuf field optional bool guest_flush = 385550813; * @param bool $var @@ -704,7 +873,10 @@ public function setGuestFlush($var) } /** - * [Output Only] A list of features to enable on the guest operating system. Applicable only for bootable images. Read Enabling guest operating system features to see a list of available options. + * [Output Only] A list of features to enable on the guest operating system. + * Applicable only for bootable images. Read + * Enabling guest operating system features to see a list of available + * options. * * Generated from protobuf field repeated .google.cloud.compute.v1.GuestOsFeature guest_os_features = 79294545; * @return \Google\Protobuf\Internal\RepeatedField @@ -715,7 +887,10 @@ public function getGuestOsFeatures() } /** - * [Output Only] A list of features to enable on the guest operating system. Applicable only for bootable images. Read Enabling guest operating system features to see a list of available options. + * [Output Only] A list of features to enable on the guest operating system. + * Applicable only for bootable images. Read + * Enabling guest operating system features to see a list of available + * options. * * Generated from protobuf field repeated .google.cloud.compute.v1.GuestOsFeature guest_os_features = 79294545; * @param array<\Google\Cloud\Compute\V1\GuestOsFeature>|\Google\Protobuf\Internal\RepeatedField $var @@ -730,7 +905,8 @@ public function setGuestOsFeatures($var) } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @return int|string @@ -751,7 +927,8 @@ public function clearId() } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @param int|string $var @@ -766,7 +943,8 @@ public function setId($var) } /** - * [Output Only] Type of the resource. Always compute#snapshot for Snapshot resources. + * [Output Only] Type of the resource. Always compute#snapshot + * for Snapshot resources. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -787,7 +965,8 @@ public function clearKind() } /** - * [Output Only] Type of the resource. Always compute#snapshot for Snapshot resources. + * [Output Only] Type of the resource. Always compute#snapshot + * for Snapshot resources. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -802,7 +981,14 @@ public function setKind($var) } /** - * A fingerprint for the labels being applied to this snapshot, which is essentially a hash of the labels set used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a snapshot. + * A fingerprint for the labels being applied to this snapshot, which is + * essentially a hash of the labels set used for optimistic locking. The + * fingerprint is initially generated by Compute Engine and changes after + * every request to modify or update labels. You must always provide an + * up-to-date fingerprint hash in order to update or change labels, + * otherwise the request will fail with error412 conditionNotMet. + * To see the latest fingerprint, make a get() request to + * retrieve a snapshot. * * Generated from protobuf field optional string label_fingerprint = 178124825; * @return string @@ -823,7 +1009,14 @@ public function clearLabelFingerprint() } /** - * A fingerprint for the labels being applied to this snapshot, which is essentially a hash of the labels set used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a snapshot. + * A fingerprint for the labels being applied to this snapshot, which is + * essentially a hash of the labels set used for optimistic locking. The + * fingerprint is initially generated by Compute Engine and changes after + * every request to modify or update labels. You must always provide an + * up-to-date fingerprint hash in order to update or change labels, + * otherwise the request will fail with error412 conditionNotMet. + * To see the latest fingerprint, make a get() request to + * retrieve a snapshot. * * Generated from protobuf field optional string label_fingerprint = 178124825; * @param string $var @@ -838,7 +1031,9 @@ public function setLabelFingerprint($var) } /** - * Labels to apply to this snapshot. These can be later modified by the setLabels method. Label values may be empty. + * Labels to apply to this snapshot. These can be later modified by + * the setLabels method. + * Label values may be empty. * * Generated from protobuf field map labels = 500195327; * @return \Google\Protobuf\Internal\MapField @@ -849,7 +1044,9 @@ public function getLabels() } /** - * Labels to apply to this snapshot. These can be later modified by the setLabels method. Label values may be empty. + * Labels to apply to this snapshot. These can be later modified by + * the setLabels method. + * Label values may be empty. * * Generated from protobuf field map labels = 500195327; * @param array|\Google\Protobuf\Internal\MapField $var @@ -864,7 +1061,8 @@ public function setLabels($var) } /** - * [Output Only] Integer license codes indicating which licenses are attached to this snapshot. + * [Output Only] Integer license codes indicating which licenses are attached + * to this snapshot. * * Generated from protobuf field repeated int64 license_codes = 45482664; * @return \Google\Protobuf\Internal\RepeatedField @@ -875,7 +1073,8 @@ public function getLicenseCodes() } /** - * [Output Only] Integer license codes indicating which licenses are attached to this snapshot. + * [Output Only] Integer license codes indicating which licenses are attached + * to this snapshot. * * Generated from protobuf field repeated int64 license_codes = 45482664; * @param array|array|\Google\Protobuf\Internal\RepeatedField $var @@ -890,7 +1089,9 @@ public function setLicenseCodes($var) } /** - * [Output Only] A list of public visible licenses that apply to this snapshot. This can be because the original image had licenses attached (such as a Windows image). + * [Output Only] A list of public visible licenses that apply to this + * snapshot. This can be because the original image had licenses attached + * (such as a Windows image). * * Generated from protobuf field repeated string licenses = 337642578; * @return \Google\Protobuf\Internal\RepeatedField @@ -901,7 +1102,9 @@ public function getLicenses() } /** - * [Output Only] A list of public visible licenses that apply to this snapshot. This can be because the original image had licenses attached (such as a Windows image). + * [Output Only] A list of public visible licenses that apply to this + * snapshot. This can be because the original image had licenses attached + * (such as a Windows image). * * Generated from protobuf field repeated string licenses = 337642578; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -916,7 +1119,9 @@ public function setLicenses($var) } /** - * An opaque location hint used to place the snapshot close to other resources. This field is for use by internal tools that use the public API. + * An opaque location hint used to place the snapshot close to other + * resources. + * This field is for use by internal tools that use the public API. * * Generated from protobuf field optional string location_hint = 350519505; * @return string @@ -937,7 +1142,9 @@ public function clearLocationHint() } /** - * An opaque location hint used to place the snapshot close to other resources. This field is for use by internal tools that use the public API. + * An opaque location hint used to place the snapshot close to other + * resources. + * This field is for use by internal tools that use the public API. * * Generated from protobuf field optional string location_hint = 350519505; * @param string $var @@ -952,7 +1159,13 @@ public function setLocationHint($var) } /** - * Name of the resource; provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource; provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must be + * a dash, lowercase letter, or digit, except the last character, which cannot + * be a dash. * * Generated from protobuf field optional string name = 3373707; * @return string @@ -973,7 +1186,13 @@ public function clearName() } /** - * Name of the resource; provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource; provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must be + * a dash, lowercase letter, or digit, except the last character, which cannot + * be a dash. * * Generated from protobuf field optional string name = 3373707; * @param string $var @@ -988,7 +1207,8 @@ public function setName($var) } /** - * Input only. [Input Only] Additional params passed with the request, but not persisted as part of resource payload. + * Input only. [Input Only] Additional params passed with the request, but not persisted + * as part of resource payload. * * Generated from protobuf field optional .google.cloud.compute.v1.SnapshotParams params = 78313862; * @return \Google\Cloud\Compute\V1\SnapshotParams|null @@ -1009,7 +1229,8 @@ public function clearParams() } /** - * Input only. [Input Only] Additional params passed with the request, but not persisted as part of resource payload. + * Input only. [Input Only] Additional params passed with the request, but not persisted + * as part of resource payload. * * Generated from protobuf field optional .google.cloud.compute.v1.SnapshotParams params = 78313862; * @param \Google\Cloud\Compute\V1\SnapshotParams $var @@ -1132,7 +1353,17 @@ public function setSelfLink($var) } /** - * Encrypts the snapshot using a customer-supplied encryption key. After you encrypt a snapshot using a customer-supplied key, you must provide the same key if you use the snapshot later. For example, you must provide the encryption key when you create a disk from the encrypted snapshot in a future request. Customer-supplied encryption keys do not protect access to metadata of the snapshot. If you do not provide an encryption key when creating the snapshot, then the snapshot will be encrypted using an automatically generated key and you do not need to provide a key to use the snapshot later. + * Encrypts the snapshot using acustomer-supplied + * encryption key. + * After you encrypt a snapshot using a customer-supplied key, you must + * provide the same key if you use the snapshot later. For example, you must + * provide the encryption key when you create a disk from the encrypted + * snapshot in a future request. + * Customer-supplied encryption keys do not protect access to metadata + * of the snapshot. + * If you do not provide an encryption key when creating the snapshot, then + * the snapshot will be encrypted using an automatically generated key and you + * do not need to provide a key to use the snapshot later. * * Generated from protobuf field optional .google.cloud.compute.v1.CustomerEncryptionKey snapshot_encryption_key = 43334526; * @return \Google\Cloud\Compute\V1\CustomerEncryptionKey|null @@ -1153,7 +1384,17 @@ public function clearSnapshotEncryptionKey() } /** - * Encrypts the snapshot using a customer-supplied encryption key. After you encrypt a snapshot using a customer-supplied key, you must provide the same key if you use the snapshot later. For example, you must provide the encryption key when you create a disk from the encrypted snapshot in a future request. Customer-supplied encryption keys do not protect access to metadata of the snapshot. If you do not provide an encryption key when creating the snapshot, then the snapshot will be encrypted using an automatically generated key and you do not need to provide a key to use the snapshot later. + * Encrypts the snapshot using acustomer-supplied + * encryption key. + * After you encrypt a snapshot using a customer-supplied key, you must + * provide the same key if you use the snapshot later. For example, you must + * provide the encryption key when you create a disk from the encrypted + * snapshot in a future request. + * Customer-supplied encryption keys do not protect access to metadata + * of the snapshot. + * If you do not provide an encryption key when creating the snapshot, then + * the snapshot will be encrypted using an automatically generated key and you + * do not need to provide a key to use the snapshot later. * * Generated from protobuf field optional .google.cloud.compute.v1.CustomerEncryptionKey snapshot_encryption_key = 43334526; * @param \Google\Cloud\Compute\V1\CustomerEncryptionKey $var @@ -1242,7 +1483,9 @@ public function setSourceDisk($var) } /** - * The customer-supplied encryption key of the source disk. Required if the source disk is protected by a customer-supplied encryption key. + * The customer-supplied + * encryption key of the source disk. Required if the source disk is + * protected by a customer-supplied encryption key. * * Generated from protobuf field optional .google.cloud.compute.v1.CustomerEncryptionKey source_disk_encryption_key = 531501153; * @return \Google\Cloud\Compute\V1\CustomerEncryptionKey|null @@ -1263,7 +1506,9 @@ public function clearSourceDiskEncryptionKey() } /** - * The customer-supplied encryption key of the source disk. Required if the source disk is protected by a customer-supplied encryption key. + * The customer-supplied + * encryption key of the source disk. Required if the source disk is + * protected by a customer-supplied encryption key. * * Generated from protobuf field optional .google.cloud.compute.v1.CustomerEncryptionKey source_disk_encryption_key = 531501153; * @param \Google\Cloud\Compute\V1\CustomerEncryptionKey $var @@ -1278,7 +1523,8 @@ public function setSourceDiskEncryptionKey($var) } /** - * The source disk whose recovery checkpoint will be used to create this snapshot. + * The source disk whose recovery checkpoint will be used to create this + * snapshot. * * Generated from protobuf field optional string source_disk_for_recovery_checkpoint = 359837950; * @return string @@ -1299,7 +1545,8 @@ public function clearSourceDiskForRecoveryCheckpoint() } /** - * The source disk whose recovery checkpoint will be used to create this snapshot. + * The source disk whose recovery checkpoint will be used to create this + * snapshot. * * Generated from protobuf field optional string source_disk_for_recovery_checkpoint = 359837950; * @param string $var @@ -1314,7 +1561,9 @@ public function setSourceDiskForRecoveryCheckpoint($var) } /** - * [Output Only] The ID value of the disk used to create this snapshot. This value may be used to determine whether the snapshot was taken from the current or a previous instance of a given disk name. + * [Output Only] The ID value of the disk used to create this snapshot. This + * value may be used to determine whether the snapshot was taken from the + * current or a previous instance of a given disk name. * * Generated from protobuf field optional string source_disk_id = 454190809; * @return string @@ -1335,7 +1584,9 @@ public function clearSourceDiskId() } /** - * [Output Only] The ID value of the disk used to create this snapshot. This value may be used to determine whether the snapshot was taken from the current or a previous instance of a given disk name. + * [Output Only] The ID value of the disk used to create this snapshot. This + * value may be used to determine whether the snapshot was taken from the + * current or a previous instance of a given disk name. * * Generated from protobuf field optional string source_disk_id = 454190809; * @param string $var @@ -1350,7 +1601,12 @@ public function setSourceDiskId($var) } /** - * The source instant snapshot used to create this snapshot. You can provide this as a partial or full URL to the resource. For example, the following are valid values: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /instantSnapshots/instantSnapshot - projects/project/zones/zone/instantSnapshots/instantSnapshot - zones/zone/instantSnapshots/instantSnapshot + * The source instant snapshot used to create this snapshot. You can provide + * this as a partial or full URL to the resource. For example, the following + * are valid values: + * - https://www.googleapis.com/compute/v1/projects/project/zones/zone/instantSnapshots/instantSnapshot + * - projects/project/zones/zone/instantSnapshots/instantSnapshot + * - zones/zone/instantSnapshots/instantSnapshot * * Generated from protobuf field optional string source_instant_snapshot = 219202054; * @return string @@ -1371,7 +1627,12 @@ public function clearSourceInstantSnapshot() } /** - * The source instant snapshot used to create this snapshot. You can provide this as a partial or full URL to the resource. For example, the following are valid values: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /instantSnapshots/instantSnapshot - projects/project/zones/zone/instantSnapshots/instantSnapshot - zones/zone/instantSnapshots/instantSnapshot + * The source instant snapshot used to create this snapshot. You can provide + * this as a partial or full URL to the resource. For example, the following + * are valid values: + * - https://www.googleapis.com/compute/v1/projects/project/zones/zone/instantSnapshots/instantSnapshot + * - projects/project/zones/zone/instantSnapshots/instantSnapshot + * - zones/zone/instantSnapshots/instantSnapshot * * Generated from protobuf field optional string source_instant_snapshot = 219202054; * @param string $var @@ -1386,7 +1647,8 @@ public function setSourceInstantSnapshot($var) } /** - * Customer provided encryption key when creating Snapshot from Instant Snapshot. + * Customer provided encryption key when creating Snapshot from Instant + * Snapshot. * * Generated from protobuf field optional .google.cloud.compute.v1.CustomerEncryptionKey source_instant_snapshot_encryption_key = 436536060; * @return \Google\Cloud\Compute\V1\CustomerEncryptionKey|null @@ -1407,7 +1669,8 @@ public function clearSourceInstantSnapshotEncryptionKey() } /** - * Customer provided encryption key when creating Snapshot from Instant Snapshot. + * Customer provided encryption key when creating Snapshot from Instant + * Snapshot. * * Generated from protobuf field optional .google.cloud.compute.v1.CustomerEncryptionKey source_instant_snapshot_encryption_key = 436536060; * @param \Google\Cloud\Compute\V1\CustomerEncryptionKey $var @@ -1422,7 +1685,12 @@ public function setSourceInstantSnapshotEncryptionKey($var) } /** - * [Output Only] The unique ID of the instant snapshot used to create this snapshot. This value identifies the exact instant snapshot that was used to create this snapshot. For example, if you created the snapshot from an instant snapshot that was later deleted and recreated under the same name, the source instant snapshot ID would identify the exact instant snapshot that was used. + * [Output Only] The unique ID of the instant snapshot used to create this + * snapshot. This value identifies the exact instant snapshot that was used to + * create this snapshot. For example, if you created the snapshot from an + * instant snapshot that was later deleted and recreated under the same name, + * the source instant snapshot ID would identify the exact instant snapshot + * that was used. * * Generated from protobuf field optional string source_instant_snapshot_id = 287582708; * @return string @@ -1443,7 +1711,12 @@ public function clearSourceInstantSnapshotId() } /** - * [Output Only] The unique ID of the instant snapshot used to create this snapshot. This value identifies the exact instant snapshot that was used to create this snapshot. For example, if you created the snapshot from an instant snapshot that was later deleted and recreated under the same name, the source instant snapshot ID would identify the exact instant snapshot that was used. + * [Output Only] The unique ID of the instant snapshot used to create this + * snapshot. This value identifies the exact instant snapshot that was used to + * create this snapshot. For example, if you created the snapshot from an + * instant snapshot that was later deleted and recreated under the same name, + * the source instant snapshot ID would identify the exact instant snapshot + * that was used. * * Generated from protobuf field optional string source_instant_snapshot_id = 287582708; * @param string $var @@ -1458,7 +1731,8 @@ public function setSourceInstantSnapshotId($var) } /** - * [Output Only] URL of the resource policy which created this scheduled snapshot. + * [Output Only] URL of the resource policy which created this + * scheduled snapshot. * * Generated from protobuf field optional string source_snapshot_schedule_policy = 235756291; * @return string @@ -1479,7 +1753,8 @@ public function clearSourceSnapshotSchedulePolicy() } /** - * [Output Only] URL of the resource policy which created this scheduled snapshot. + * [Output Only] URL of the resource policy which created this + * scheduled snapshot. * * Generated from protobuf field optional string source_snapshot_schedule_policy = 235756291; * @param string $var @@ -1494,7 +1769,8 @@ public function setSourceSnapshotSchedulePolicy($var) } /** - * [Output Only] ID of the resource policy which created this scheduled snapshot. + * [Output Only] ID of the resource policy which created this + * scheduled snapshot. * * Generated from protobuf field optional string source_snapshot_schedule_policy_id = 70489047; * @return string @@ -1515,7 +1791,8 @@ public function clearSourceSnapshotSchedulePolicyId() } /** - * [Output Only] ID of the resource policy which created this scheduled snapshot. + * [Output Only] ID of the resource policy which created this + * scheduled snapshot. * * Generated from protobuf field optional string source_snapshot_schedule_policy_id = 70489047; * @param string $var @@ -1530,7 +1807,7 @@ public function setSourceSnapshotSchedulePolicyId($var) } /** - * [Output Only] The status of the snapshot. This can be CREATING, DELETING, FAILED, READY, or UPLOADING. + * [Output Only] The status of the snapshot. This can beCREATING, DELETING, FAILED,READY, or UPLOADING. * Check the Status enum for the list of possible values. * * Generated from protobuf field optional string status = 181260274; @@ -1552,7 +1829,7 @@ public function clearStatus() } /** - * [Output Only] The status of the snapshot. This can be CREATING, DELETING, FAILED, READY, or UPLOADING. + * [Output Only] The status of the snapshot. This can beCREATING, DELETING, FAILED,READY, or UPLOADING. * Check the Status enum for the list of possible values. * * Generated from protobuf field optional string status = 181260274; @@ -1568,7 +1845,9 @@ public function setStatus($var) } /** - * [Output Only] A size of the storage used by the snapshot. As snapshots share storage, this number is expected to change with snapshot creation/deletion. + * [Output Only] A size of the storage used by the snapshot. As snapshots + * share storage, this number is expected to change with snapshot + * creation/deletion. * * Generated from protobuf field optional int64 storage_bytes = 424631719; * @return int|string @@ -1589,7 +1868,9 @@ public function clearStorageBytes() } /** - * [Output Only] A size of the storage used by the snapshot. As snapshots share storage, this number is expected to change with snapshot creation/deletion. + * [Output Only] A size of the storage used by the snapshot. As snapshots + * share storage, this number is expected to change with snapshot + * creation/deletion. * * Generated from protobuf field optional int64 storage_bytes = 424631719; * @param int|string $var @@ -1604,7 +1885,11 @@ public function setStorageBytes($var) } /** - * [Output Only] An indicator whether storageBytes is in a stable state or it is being adjusted as a result of shared storage reallocation. This status can either be UPDATING, meaning the size of the snapshot is being updated, or UP_TO_DATE, meaning the size of the snapshot is up-to-date. + * [Output Only] An indicator whether storageBytes is in a + * stable state or it is being adjusted as a result of shared storage + * reallocation. This status can either be UPDATING, meaning + * the size of the snapshot is being updated, or UP_TO_DATE, + * meaning the size of the snapshot is up-to-date. * Check the StorageBytesStatus enum for the list of possible values. * * Generated from protobuf field optional string storage_bytes_status = 490739082; @@ -1626,7 +1911,11 @@ public function clearStorageBytesStatus() } /** - * [Output Only] An indicator whether storageBytes is in a stable state or it is being adjusted as a result of shared storage reallocation. This status can either be UPDATING, meaning the size of the snapshot is being updated, or UP_TO_DATE, meaning the size of the snapshot is up-to-date. + * [Output Only] An indicator whether storageBytes is in a + * stable state or it is being adjusted as a result of shared storage + * reallocation. This status can either be UPDATING, meaning + * the size of the snapshot is being updated, or UP_TO_DATE, + * meaning the size of the snapshot is up-to-date. * Check the StorageBytesStatus enum for the list of possible values. * * Generated from protobuf field optional string storage_bytes_status = 490739082; @@ -1642,7 +1931,8 @@ public function setStorageBytesStatus($var) } /** - * Cloud Storage bucket storage location of the snapshot (regional or multi-regional). + * Cloud Storage bucket storage location of the snapshot (regional or + * multi-regional). * * Generated from protobuf field repeated string storage_locations = 328005274; * @return \Google\Protobuf\Internal\RepeatedField @@ -1653,7 +1943,8 @@ public function getStorageLocations() } /** - * Cloud Storage bucket storage location of the snapshot (regional or multi-regional). + * Cloud Storage bucket storage location of the snapshot (regional or + * multi-regional). * * Generated from protobuf field repeated string storage_locations = 328005274; * @param array|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/Snapshot/Architecture.php b/Compute/src/V1/Snapshot/Architecture.php index 4199844e4f8d..299690d80043 100644 --- a/Compute/src/V1/Snapshot/Architecture.php +++ b/Compute/src/V1/Snapshot/Architecture.php @@ -7,7 +7,8 @@ use UnexpectedValueException; /** - * [Output Only] The architecture of the snapshot. Valid values are ARM64 or X86_64. + * [Output Only] The architecture of the snapshot. Valid values are + * ARM64 or X86_64. * * Protobuf type google.cloud.compute.v1.Snapshot.Architecture */ diff --git a/Compute/src/V1/Snapshot/Status.php b/Compute/src/V1/Snapshot/Status.php index 1073ed356b86..c4d51a32ac01 100644 --- a/Compute/src/V1/Snapshot/Status.php +++ b/Compute/src/V1/Snapshot/Status.php @@ -7,7 +7,7 @@ use UnexpectedValueException; /** - * [Output Only] The status of the snapshot. This can be CREATING, DELETING, FAILED, READY, or UPLOADING. + * [Output Only] The status of the snapshot. This can beCREATING, DELETING, FAILED,READY, or UPLOADING. * * Protobuf type google.cloud.compute.v1.Snapshot.Status */ diff --git a/Compute/src/V1/Snapshot/StorageBytesStatus.php b/Compute/src/V1/Snapshot/StorageBytesStatus.php index fa1e0929ec32..3c0bb8d93af3 100644 --- a/Compute/src/V1/Snapshot/StorageBytesStatus.php +++ b/Compute/src/V1/Snapshot/StorageBytesStatus.php @@ -7,7 +7,11 @@ use UnexpectedValueException; /** - * [Output Only] An indicator whether storageBytes is in a stable state or it is being adjusted as a result of shared storage reallocation. This status can either be UPDATING, meaning the size of the snapshot is being updated, or UP_TO_DATE, meaning the size of the snapshot is up-to-date. + * [Output Only] An indicator whether storageBytes is in a + * stable state or it is being adjusted as a result of shared storage + * reallocation. This status can either be UPDATING, meaning + * the size of the snapshot is being updated, or UP_TO_DATE, + * meaning the size of the snapshot is up-to-date. * * Protobuf type google.cloud.compute.v1.Snapshot.StorageBytesStatus */ diff --git a/Compute/src/V1/SnapshotList.php b/Compute/src/V1/SnapshotList.php index de072186682d..b1ddd49a7086 100644 --- a/Compute/src/V1/SnapshotList.php +++ b/Compute/src/V1/SnapshotList.php @@ -34,7 +34,11 @@ class SnapshotList extends \Google\Protobuf\Internal\Message */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -65,7 +69,11 @@ class SnapshotList extends \Google\Protobuf\Internal\Message * @type string $kind * Type of resource. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type \Google\Cloud\Compute\V1\Warning $warning @@ -176,7 +184,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -197,7 +209,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/SnapshotParams.php b/Compute/src/V1/SnapshotParams.php index 057cf89bb350..eab87e6dde2b 100644 --- a/Compute/src/V1/SnapshotParams.php +++ b/Compute/src/V1/SnapshotParams.php @@ -16,7 +16,11 @@ class SnapshotParams extends \Google\Protobuf\Internal\Message { /** - * Resource manager tags to be bound to the snapshot. Tag keys and values have the same definition as resource manager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and values are in the format `tagValues/456`. The field is ignored (both PUT & PATCH) when empty. + * Resource manager tags to be bound to the snapshot. Tag keys and values have + * the same definition as resource + * manager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and + * values are in the format `tagValues/456`. The field is ignored (both PUT & + * PATCH) when empty. * * Generated from protobuf field map resource_manager_tags = 377671164; */ @@ -29,7 +33,11 @@ class SnapshotParams extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type array|\Google\Protobuf\Internal\MapField $resource_manager_tags - * Resource manager tags to be bound to the snapshot. Tag keys and values have the same definition as resource manager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and values are in the format `tagValues/456`. The field is ignored (both PUT & PATCH) when empty. + * Resource manager tags to be bound to the snapshot. Tag keys and values have + * the same definition as resource + * manager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and + * values are in the format `tagValues/456`. The field is ignored (both PUT & + * PATCH) when empty. * } */ public function __construct($data = NULL) { @@ -38,7 +46,11 @@ public function __construct($data = NULL) { } /** - * Resource manager tags to be bound to the snapshot. Tag keys and values have the same definition as resource manager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and values are in the format `tagValues/456`. The field is ignored (both PUT & PATCH) when empty. + * Resource manager tags to be bound to the snapshot. Tag keys and values have + * the same definition as resource + * manager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and + * values are in the format `tagValues/456`. The field is ignored (both PUT & + * PATCH) when empty. * * Generated from protobuf field map resource_manager_tags = 377671164; * @return \Google\Protobuf\Internal\MapField @@ -49,7 +61,11 @@ public function getResourceManagerTags() } /** - * Resource manager tags to be bound to the snapshot. Tag keys and values have the same definition as resource manager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and values are in the format `tagValues/456`. The field is ignored (both PUT & PATCH) when empty. + * Resource manager tags to be bound to the snapshot. Tag keys and values have + * the same definition as resource + * manager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and + * values are in the format `tagValues/456`. The field is ignored (both PUT & + * PATCH) when empty. * * Generated from protobuf field map resource_manager_tags = 377671164; * @param array|\Google\Protobuf\Internal\MapField $var diff --git a/Compute/src/V1/SnapshotSettings.php b/Compute/src/V1/SnapshotSettings.php index 932deecd5385..9c70a2f2a943 100644 --- a/Compute/src/V1/SnapshotSettings.php +++ b/Compute/src/V1/SnapshotSettings.php @@ -15,7 +15,8 @@ class SnapshotSettings extends \Google\Protobuf\Internal\Message { /** - * Policy of which storage location is going to be resolved, and additional data that particularizes how the policy is going to be carried out. + * Policy of which storage location is going to be resolved, and additional + * data that particularizes how the policy is going to be carried out. * * Generated from protobuf field optional .google.cloud.compute.v1.SnapshotSettingsStorageLocationSettings storage_location = 460859641; */ @@ -28,7 +29,8 @@ class SnapshotSettings extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type \Google\Cloud\Compute\V1\SnapshotSettingsStorageLocationSettings $storage_location - * Policy of which storage location is going to be resolved, and additional data that particularizes how the policy is going to be carried out. + * Policy of which storage location is going to be resolved, and additional + * data that particularizes how the policy is going to be carried out. * } */ public function __construct($data = NULL) { @@ -37,7 +39,8 @@ public function __construct($data = NULL) { } /** - * Policy of which storage location is going to be resolved, and additional data that particularizes how the policy is going to be carried out. + * Policy of which storage location is going to be resolved, and additional + * data that particularizes how the policy is going to be carried out. * * Generated from protobuf field optional .google.cloud.compute.v1.SnapshotSettingsStorageLocationSettings storage_location = 460859641; * @return \Google\Cloud\Compute\V1\SnapshotSettingsStorageLocationSettings|null @@ -58,7 +61,8 @@ public function clearStorageLocation() } /** - * Policy of which storage location is going to be resolved, and additional data that particularizes how the policy is going to be carried out. + * Policy of which storage location is going to be resolved, and additional + * data that particularizes how the policy is going to be carried out. * * Generated from protobuf field optional .google.cloud.compute.v1.SnapshotSettingsStorageLocationSettings storage_location = 460859641; * @param \Google\Cloud\Compute\V1\SnapshotSettingsStorageLocationSettings $var diff --git a/Compute/src/V1/SnapshotSettingsStorageLocationSettings.php b/Compute/src/V1/SnapshotSettingsStorageLocationSettings.php index 92bbffc8ad3f..50f856e513dd 100644 --- a/Compute/src/V1/SnapshotSettingsStorageLocationSettings.php +++ b/Compute/src/V1/SnapshotSettingsStorageLocationSettings.php @@ -15,7 +15,9 @@ class SnapshotSettingsStorageLocationSettings extends \Google\Protobuf\Internal\Message { /** - * When the policy is SPECIFIC_LOCATIONS, snapshots will be stored in the locations listed in this field. Keys are Cloud Storage bucket locations. Only one location can be specified. + * When the policy is SPECIFIC_LOCATIONS, snapshots will be stored + * in the locations listed in this field. Keys are Cloud Storage bucket + * locations. Only one location can be specified. * * Generated from protobuf field map locations = 413423454; */ @@ -35,7 +37,9 @@ class SnapshotSettingsStorageLocationSettings extends \Google\Protobuf\Internal\ * Optional. Data for populating the Message object. * * @type array|\Google\Protobuf\Internal\MapField $locations - * When the policy is SPECIFIC_LOCATIONS, snapshots will be stored in the locations listed in this field. Keys are Cloud Storage bucket locations. Only one location can be specified. + * When the policy is SPECIFIC_LOCATIONS, snapshots will be stored + * in the locations listed in this field. Keys are Cloud Storage bucket + * locations. Only one location can be specified. * @type string $policy * The chosen location policy. * Check the Policy enum for the list of possible values. @@ -47,7 +51,9 @@ public function __construct($data = NULL) { } /** - * When the policy is SPECIFIC_LOCATIONS, snapshots will be stored in the locations listed in this field. Keys are Cloud Storage bucket locations. Only one location can be specified. + * When the policy is SPECIFIC_LOCATIONS, snapshots will be stored + * in the locations listed in this field. Keys are Cloud Storage bucket + * locations. Only one location can be specified. * * Generated from protobuf field map locations = 413423454; * @return \Google\Protobuf\Internal\MapField @@ -58,7 +64,9 @@ public function getLocations() } /** - * When the policy is SPECIFIC_LOCATIONS, snapshots will be stored in the locations listed in this field. Keys are Cloud Storage bucket locations. Only one location can be specified. + * When the policy is SPECIFIC_LOCATIONS, snapshots will be stored + * in the locations listed in this field. Keys are Cloud Storage bucket + * locations. Only one location can be specified. * * Generated from protobuf field map locations = 413423454; * @param array|\Google\Protobuf\Internal\MapField $var diff --git a/Compute/src/V1/SnapshotSettingsStorageLocationSettings/Policy.php b/Compute/src/V1/SnapshotSettingsStorageLocationSettings/Policy.php index 3235b9efc754..87dd52b80bfa 100644 --- a/Compute/src/V1/SnapshotSettingsStorageLocationSettings/Policy.php +++ b/Compute/src/V1/SnapshotSettingsStorageLocationSettings/Policy.php @@ -20,19 +20,23 @@ class Policy */ const UNDEFINED_POLICY = 0; /** - * Store snapshot in the same region as with the originating disk. No additional parameters are needed. + * Store snapshot in the same region as with the originating disk. + * No additional parameters are needed. * * Generated from protobuf enum LOCAL_REGION = 403535464; */ const LOCAL_REGION = 403535464; /** - * Store snapshot in the nearest multi region Cloud Storage bucket, relative to the originating disk. No additional parameters are needed. + * Store snapshot in the nearest multi region Cloud Storage bucket, + * relative to the originating disk. No additional parameters are needed. * * Generated from protobuf enum NEAREST_MULTI_REGION = 212467515; */ const NEAREST_MULTI_REGION = 212467515; /** - * Store snapshot in the specific locations, as specified by the user. The list of regions to store must be defined under the `locations` field. + * Store snapshot in the specific locations, as specified by the user. + * The list of regions to store must be defined under the `locations` + * field. * * Generated from protobuf enum SPECIFIC_LOCATIONS = 280093809; */ diff --git a/Compute/src/V1/SnapshotSettingsStorageLocationSettingsStorageLocationPreference.php b/Compute/src/V1/SnapshotSettingsStorageLocationSettingsStorageLocationPreference.php index d3f309218c82..7d7c01019134 100644 --- a/Compute/src/V1/SnapshotSettingsStorageLocationSettingsStorageLocationPreference.php +++ b/Compute/src/V1/SnapshotSettingsStorageLocationSettingsStorageLocationPreference.php @@ -16,7 +16,8 @@ class SnapshotSettingsStorageLocationSettingsStorageLocationPreference extends \Google\Protobuf\Internal\Message { /** - * Name of the location. It should be one of the Cloud Storage buckets. Only one location can be specified. + * Name of the location. It should be one of the Cloud Storage buckets. + * Only one location can be specified. * * Generated from protobuf field optional string name = 3373707; */ @@ -29,7 +30,8 @@ class SnapshotSettingsStorageLocationSettingsStorageLocationPreference extends \ * Optional. Data for populating the Message object. * * @type string $name - * Name of the location. It should be one of the Cloud Storage buckets. Only one location can be specified. + * Name of the location. It should be one of the Cloud Storage buckets. + * Only one location can be specified. * } */ public function __construct($data = NULL) { @@ -38,7 +40,8 @@ public function __construct($data = NULL) { } /** - * Name of the location. It should be one of the Cloud Storage buckets. Only one location can be specified. + * Name of the location. It should be one of the Cloud Storage buckets. + * Only one location can be specified. * * Generated from protobuf field optional string name = 3373707; * @return string @@ -59,7 +62,8 @@ public function clearName() } /** - * Name of the location. It should be one of the Cloud Storage buckets. Only one location can be specified. + * Name of the location. It should be one of the Cloud Storage buckets. + * Only one location can be specified. * * Generated from protobuf field optional string name = 3373707; * @param string $var diff --git a/Compute/src/V1/SourceDiskEncryptionKey.php b/Compute/src/V1/SourceDiskEncryptionKey.php index e73836d2bfbb..c8785432a3af 100644 --- a/Compute/src/V1/SourceDiskEncryptionKey.php +++ b/Compute/src/V1/SourceDiskEncryptionKey.php @@ -15,13 +15,19 @@ class SourceDiskEncryptionKey extends \Google\Protobuf\Internal\Message { /** - * The customer-supplied encryption key of the source disk. Required if the source disk is protected by a customer-supplied encryption key. + * Thecustomer-supplied + * encryption key of the source disk. Required if the source disk is + * protected by a customer-supplied encryption key. * * Generated from protobuf field optional .google.cloud.compute.v1.CustomerEncryptionKey disk_encryption_key = 271660677; */ protected $disk_encryption_key = null; /** - * URL of the disk attached to the source instance. This can be a full or valid partial URL. For example, the following are valid values: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /disks/disk - projects/project/zones/zone/disks/disk - zones/zone/disks/disk + * URL of the disk attached to the source instance. This can be a full or + * valid partial URL. For example, the following are valid values: + * - https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk + * - projects/project/zones/zone/disks/disk + * - zones/zone/disks/disk * * Generated from protobuf field optional string source_disk = 451753793; */ @@ -34,9 +40,15 @@ class SourceDiskEncryptionKey extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type \Google\Cloud\Compute\V1\CustomerEncryptionKey $disk_encryption_key - * The customer-supplied encryption key of the source disk. Required if the source disk is protected by a customer-supplied encryption key. + * Thecustomer-supplied + * encryption key of the source disk. Required if the source disk is + * protected by a customer-supplied encryption key. * @type string $source_disk - * URL of the disk attached to the source instance. This can be a full or valid partial URL. For example, the following are valid values: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /disks/disk - projects/project/zones/zone/disks/disk - zones/zone/disks/disk + * URL of the disk attached to the source instance. This can be a full or + * valid partial URL. For example, the following are valid values: + * - https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk + * - projects/project/zones/zone/disks/disk + * - zones/zone/disks/disk * } */ public function __construct($data = NULL) { @@ -45,7 +57,9 @@ public function __construct($data = NULL) { } /** - * The customer-supplied encryption key of the source disk. Required if the source disk is protected by a customer-supplied encryption key. + * Thecustomer-supplied + * encryption key of the source disk. Required if the source disk is + * protected by a customer-supplied encryption key. * * Generated from protobuf field optional .google.cloud.compute.v1.CustomerEncryptionKey disk_encryption_key = 271660677; * @return \Google\Cloud\Compute\V1\CustomerEncryptionKey|null @@ -66,7 +80,9 @@ public function clearDiskEncryptionKey() } /** - * The customer-supplied encryption key of the source disk. Required if the source disk is protected by a customer-supplied encryption key. + * Thecustomer-supplied + * encryption key of the source disk. Required if the source disk is + * protected by a customer-supplied encryption key. * * Generated from protobuf field optional .google.cloud.compute.v1.CustomerEncryptionKey disk_encryption_key = 271660677; * @param \Google\Cloud\Compute\V1\CustomerEncryptionKey $var @@ -81,7 +97,11 @@ public function setDiskEncryptionKey($var) } /** - * URL of the disk attached to the source instance. This can be a full or valid partial URL. For example, the following are valid values: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /disks/disk - projects/project/zones/zone/disks/disk - zones/zone/disks/disk + * URL of the disk attached to the source instance. This can be a full or + * valid partial URL. For example, the following are valid values: + * - https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk + * - projects/project/zones/zone/disks/disk + * - zones/zone/disks/disk * * Generated from protobuf field optional string source_disk = 451753793; * @return string @@ -102,7 +122,11 @@ public function clearSourceDisk() } /** - * URL of the disk attached to the source instance. This can be a full or valid partial URL. For example, the following are valid values: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /disks/disk - projects/project/zones/zone/disks/disk - zones/zone/disks/disk + * URL of the disk attached to the source instance. This can be a full or + * valid partial URL. For example, the following are valid values: + * - https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk + * - projects/project/zones/zone/disks/disk + * - zones/zone/disks/disk * * Generated from protobuf field optional string source_disk = 451753793; * @param string $var diff --git a/Compute/src/V1/SourceInstanceParams.php b/Compute/src/V1/SourceInstanceParams.php index 838d5a28691f..658d57d146ef 100644 --- a/Compute/src/V1/SourceInstanceParams.php +++ b/Compute/src/V1/SourceInstanceParams.php @@ -9,14 +9,18 @@ use Google\Protobuf\Internal\GPBUtil; /** - * A specification of the parameters to use when creating the instance template from a source instance. + * A specification of the parameters to use when creating the instance template + * from a source instance. * * Generated from protobuf message google.cloud.compute.v1.SourceInstanceParams */ class SourceInstanceParams extends \Google\Protobuf\Internal\Message { /** - * Attached disks configuration. If not provided, defaults are applied: For boot disk and any other R/W disks, the source images for each disk will be used. For read-only disks, they will be attached in read-only mode. Local SSD disks will be created as blank volumes. + * Attached disks configuration. If not provided, defaults are applied: + * For boot disk and any other R/W disks, the source images for each disk + * will be used. For read-only disks, they will be attached in read-only + * mode. Local SSD disks will be created as blank volumes. * * Generated from protobuf field repeated .google.cloud.compute.v1.DiskInstantiationConfig disk_configs = 235580623; */ @@ -29,7 +33,10 @@ class SourceInstanceParams extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type array<\Google\Cloud\Compute\V1\DiskInstantiationConfig>|\Google\Protobuf\Internal\RepeatedField $disk_configs - * Attached disks configuration. If not provided, defaults are applied: For boot disk and any other R/W disks, the source images for each disk will be used. For read-only disks, they will be attached in read-only mode. Local SSD disks will be created as blank volumes. + * Attached disks configuration. If not provided, defaults are applied: + * For boot disk and any other R/W disks, the source images for each disk + * will be used. For read-only disks, they will be attached in read-only + * mode. Local SSD disks will be created as blank volumes. * } */ public function __construct($data = NULL) { @@ -38,7 +45,10 @@ public function __construct($data = NULL) { } /** - * Attached disks configuration. If not provided, defaults are applied: For boot disk and any other R/W disks, the source images for each disk will be used. For read-only disks, they will be attached in read-only mode. Local SSD disks will be created as blank volumes. + * Attached disks configuration. If not provided, defaults are applied: + * For boot disk and any other R/W disks, the source images for each disk + * will be used. For read-only disks, they will be attached in read-only + * mode. Local SSD disks will be created as blank volumes. * * Generated from protobuf field repeated .google.cloud.compute.v1.DiskInstantiationConfig disk_configs = 235580623; * @return \Google\Protobuf\Internal\RepeatedField @@ -49,7 +59,10 @@ public function getDiskConfigs() } /** - * Attached disks configuration. If not provided, defaults are applied: For boot disk and any other R/W disks, the source images for each disk will be used. For read-only disks, they will be attached in read-only mode. Local SSD disks will be created as blank volumes. + * Attached disks configuration. If not provided, defaults are applied: + * For boot disk and any other R/W disks, the source images for each disk + * will be used. For read-only disks, they will be attached in read-only + * mode. Local SSD disks will be created as blank volumes. * * Generated from protobuf field repeated .google.cloud.compute.v1.DiskInstantiationConfig disk_configs = 235580623; * @param array<\Google\Cloud\Compute\V1\DiskInstantiationConfig>|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/SourceInstanceProperties.php b/Compute/src/V1/SourceInstanceProperties.php index 148701fc8ec8..e7eef21bc7c8 100644 --- a/Compute/src/V1/SourceInstanceProperties.php +++ b/Compute/src/V1/SourceInstanceProperties.php @@ -9,44 +9,55 @@ use Google\Protobuf\Internal\GPBUtil; /** - * DEPRECATED: Please use compute#instanceProperties instead. New properties will not be added to this field. + * DEPRECATED: Please use compute#instanceProperties instead. + * New properties will not be added to this field. * * Generated from protobuf message google.cloud.compute.v1.SourceInstanceProperties */ class SourceInstanceProperties extends \Google\Protobuf\Internal\Message { /** - * Enables instances created based on this machine image to send packets with source IP addresses other than their own and receive packets with destination IP addresses other than their own. If these instances will be used as an IP gateway or it will be set as the next-hop in a Route resource, specify true. If unsure, leave this set to false. See the Enable IP forwarding documentation for more information. + * Enables instances created based on this machine image to send packets with + * source IP addresses other than their own and receive packets with + * destination IP addresses other than their own. If these instances will be + * used as an IP gateway or it will be set as the next-hop in a Route + * resource, specify true. If unsure, leave this set tofalse. See theEnable IP forwarding + * documentation for more information. * * Generated from protobuf field optional bool can_ip_forward = 467731324; */ protected $can_ip_forward = null; /** - * Whether the instance created from this machine image should be protected against deletion. + * Whether the instance created from this machine image should be protected + * against deletion. * * Generated from protobuf field optional bool deletion_protection = 458014698; */ protected $deletion_protection = null; /** - * An optional text description for the instances that are created from this machine image. + * An optional text description for the instances that are created from this + * machine image. * * Generated from protobuf field optional string description = 422937596; */ protected $description = null; /** - * An array of disks that are associated with the instances that are created from this machine image. + * An array of disks that are associated with the instances that are created + * from this machine image. * * Generated from protobuf field repeated .google.cloud.compute.v1.SavedAttachedDisk disks = 95594102; */ private $disks; /** - * A list of guest accelerator cards' type and count to use for instances created from this machine image. + * A list of guest accelerator cards' type and count to use for instances + * created from this machine image. * * Generated from protobuf field repeated .google.cloud.compute.v1.AcceleratorConfig guest_accelerators = 463595119; */ private $guest_accelerators; /** - * KeyRevocationActionType of the instance. Supported options are "STOP" and "NONE". The default value is "NONE" if it is not specified. + * KeyRevocationActionType of the instance. Supported options are "STOP" and + * "NONE". The default value is "NONE" if it is not specified. * Check the KeyRevocationActionType enum for the list of possible values. * * Generated from protobuf field optional string key_revocation_action_type = 235941474; @@ -59,19 +70,28 @@ class SourceInstanceProperties extends \Google\Protobuf\Internal\Message */ private $labels; /** - * The machine type to use for instances that are created from this machine image. + * The machine type to use for instances that are created from this machine + * image. * * Generated from protobuf field optional string machine_type = 227711026; */ protected $machine_type = null; /** - * The metadata key/value pairs to assign to instances that are created from this machine image. These pairs can consist of custom metadata or predefined keys. See Project and instance metadata for more information. + * The metadata key/value pairs to assign to instances that are created from + * this machine image. These pairs can consist of custom metadata or + * predefined keys. SeeProject and + * instance metadata for more information. * * Generated from protobuf field optional .google.cloud.compute.v1.Metadata metadata = 86866735; */ protected $metadata = null; /** - * Minimum cpu/platform to be used by instances created from this machine image. The instance may be scheduled on the specified or newer cpu/platform. Applicable values are the friendly names of CPU platforms, such as minCpuPlatform: "Intel Haswell" or minCpuPlatform: "Intel Sandy Bridge". For more information, read Specifying a Minimum CPU Platform. + * Minimum cpu/platform to be used by instances created from this machine + * image. The instance may be scheduled on the specified or newer + * cpu/platform. Applicable values are the friendly names of CPU platforms, + * such as minCpuPlatform: "Intel Haswell" orminCpuPlatform: "Intel Sandy Bridge". For more + * information, read Specifying a + * Minimum CPU Platform. * * Generated from protobuf field optional string min_cpu_platform = 242912759; */ @@ -83,19 +103,26 @@ class SourceInstanceProperties extends \Google\Protobuf\Internal\Message */ private $network_interfaces; /** - * Specifies the scheduling options for the instances that are created from this machine image. + * Specifies the scheduling options for the instances that are created from + * this machine image. * * Generated from protobuf field optional .google.cloud.compute.v1.Scheduling scheduling = 386688404; */ protected $scheduling = null; /** - * A list of service accounts with specified scopes. Access tokens for these service accounts are available to the instances that are created from this machine image. Use metadata queries to obtain the access tokens for these instances. + * A list of service accounts with specified scopes. Access tokens for these + * service accounts are available to the instances that are created from this + * machine image. Use metadata queries to obtain the access tokens for these + * instances. * * Generated from protobuf field repeated .google.cloud.compute.v1.ServiceAccount service_accounts = 277537328; */ private $service_accounts; /** - * A list of tags to apply to the instances that are created from this machine image. The tags identify valid sources or targets for network firewalls. The setTags method can modify this list of tags. Each tag within the list must comply with RFC1035. + * A list of tags to apply to the instances that are created from this machine + * image. The tags identify valid sources or targets for network firewalls. + * The setTags method can modify this list of tags. Each tag within the list + * must comply withRFC1035. * * Generated from protobuf field optional .google.cloud.compute.v1.Tags tags = 3552281; */ @@ -108,34 +135,60 @@ class SourceInstanceProperties extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type bool $can_ip_forward - * Enables instances created based on this machine image to send packets with source IP addresses other than their own and receive packets with destination IP addresses other than their own. If these instances will be used as an IP gateway or it will be set as the next-hop in a Route resource, specify true. If unsure, leave this set to false. See the Enable IP forwarding documentation for more information. + * Enables instances created based on this machine image to send packets with + * source IP addresses other than their own and receive packets with + * destination IP addresses other than their own. If these instances will be + * used as an IP gateway or it will be set as the next-hop in a Route + * resource, specify true. If unsure, leave this set tofalse. See theEnable IP forwarding + * documentation for more information. * @type bool $deletion_protection - * Whether the instance created from this machine image should be protected against deletion. + * Whether the instance created from this machine image should be protected + * against deletion. * @type string $description - * An optional text description for the instances that are created from this machine image. + * An optional text description for the instances that are created from this + * machine image. * @type array<\Google\Cloud\Compute\V1\SavedAttachedDisk>|\Google\Protobuf\Internal\RepeatedField $disks - * An array of disks that are associated with the instances that are created from this machine image. + * An array of disks that are associated with the instances that are created + * from this machine image. * @type array<\Google\Cloud\Compute\V1\AcceleratorConfig>|\Google\Protobuf\Internal\RepeatedField $guest_accelerators - * A list of guest accelerator cards' type and count to use for instances created from this machine image. + * A list of guest accelerator cards' type and count to use for instances + * created from this machine image. * @type string $key_revocation_action_type - * KeyRevocationActionType of the instance. Supported options are "STOP" and "NONE". The default value is "NONE" if it is not specified. + * KeyRevocationActionType of the instance. Supported options are "STOP" and + * "NONE". The default value is "NONE" if it is not specified. * Check the KeyRevocationActionType enum for the list of possible values. * @type array|\Google\Protobuf\Internal\MapField $labels * Labels to apply to instances that are created from this machine image. * @type string $machine_type - * The machine type to use for instances that are created from this machine image. + * The machine type to use for instances that are created from this machine + * image. * @type \Google\Cloud\Compute\V1\Metadata $metadata - * The metadata key/value pairs to assign to instances that are created from this machine image. These pairs can consist of custom metadata or predefined keys. See Project and instance metadata for more information. + * The metadata key/value pairs to assign to instances that are created from + * this machine image. These pairs can consist of custom metadata or + * predefined keys. SeeProject and + * instance metadata for more information. * @type string $min_cpu_platform - * Minimum cpu/platform to be used by instances created from this machine image. The instance may be scheduled on the specified or newer cpu/platform. Applicable values are the friendly names of CPU platforms, such as minCpuPlatform: "Intel Haswell" or minCpuPlatform: "Intel Sandy Bridge". For more information, read Specifying a Minimum CPU Platform. + * Minimum cpu/platform to be used by instances created from this machine + * image. The instance may be scheduled on the specified or newer + * cpu/platform. Applicable values are the friendly names of CPU platforms, + * such as minCpuPlatform: "Intel Haswell" orminCpuPlatform: "Intel Sandy Bridge". For more + * information, read Specifying a + * Minimum CPU Platform. * @type array<\Google\Cloud\Compute\V1\NetworkInterface>|\Google\Protobuf\Internal\RepeatedField $network_interfaces * An array of network access configurations for this interface. * @type \Google\Cloud\Compute\V1\Scheduling $scheduling - * Specifies the scheduling options for the instances that are created from this machine image. + * Specifies the scheduling options for the instances that are created from + * this machine image. * @type array<\Google\Cloud\Compute\V1\ServiceAccount>|\Google\Protobuf\Internal\RepeatedField $service_accounts - * A list of service accounts with specified scopes. Access tokens for these service accounts are available to the instances that are created from this machine image. Use metadata queries to obtain the access tokens for these instances. + * A list of service accounts with specified scopes. Access tokens for these + * service accounts are available to the instances that are created from this + * machine image. Use metadata queries to obtain the access tokens for these + * instances. * @type \Google\Cloud\Compute\V1\Tags $tags - * A list of tags to apply to the instances that are created from this machine image. The tags identify valid sources or targets for network firewalls. The setTags method can modify this list of tags. Each tag within the list must comply with RFC1035. + * A list of tags to apply to the instances that are created from this machine + * image. The tags identify valid sources or targets for network firewalls. + * The setTags method can modify this list of tags. Each tag within the list + * must comply withRFC1035. * } */ public function __construct($data = NULL) { @@ -144,7 +197,12 @@ public function __construct($data = NULL) { } /** - * Enables instances created based on this machine image to send packets with source IP addresses other than their own and receive packets with destination IP addresses other than their own. If these instances will be used as an IP gateway or it will be set as the next-hop in a Route resource, specify true. If unsure, leave this set to false. See the Enable IP forwarding documentation for more information. + * Enables instances created based on this machine image to send packets with + * source IP addresses other than their own and receive packets with + * destination IP addresses other than their own. If these instances will be + * used as an IP gateway or it will be set as the next-hop in a Route + * resource, specify true. If unsure, leave this set tofalse. See theEnable IP forwarding + * documentation for more information. * * Generated from protobuf field optional bool can_ip_forward = 467731324; * @return bool @@ -165,7 +223,12 @@ public function clearCanIpForward() } /** - * Enables instances created based on this machine image to send packets with source IP addresses other than their own and receive packets with destination IP addresses other than their own. If these instances will be used as an IP gateway or it will be set as the next-hop in a Route resource, specify true. If unsure, leave this set to false. See the Enable IP forwarding documentation for more information. + * Enables instances created based on this machine image to send packets with + * source IP addresses other than their own and receive packets with + * destination IP addresses other than their own. If these instances will be + * used as an IP gateway or it will be set as the next-hop in a Route + * resource, specify true. If unsure, leave this set tofalse. See theEnable IP forwarding + * documentation for more information. * * Generated from protobuf field optional bool can_ip_forward = 467731324; * @param bool $var @@ -180,7 +243,8 @@ public function setCanIpForward($var) } /** - * Whether the instance created from this machine image should be protected against deletion. + * Whether the instance created from this machine image should be protected + * against deletion. * * Generated from protobuf field optional bool deletion_protection = 458014698; * @return bool @@ -201,7 +265,8 @@ public function clearDeletionProtection() } /** - * Whether the instance created from this machine image should be protected against deletion. + * Whether the instance created from this machine image should be protected + * against deletion. * * Generated from protobuf field optional bool deletion_protection = 458014698; * @param bool $var @@ -216,7 +281,8 @@ public function setDeletionProtection($var) } /** - * An optional text description for the instances that are created from this machine image. + * An optional text description for the instances that are created from this + * machine image. * * Generated from protobuf field optional string description = 422937596; * @return string @@ -237,7 +303,8 @@ public function clearDescription() } /** - * An optional text description for the instances that are created from this machine image. + * An optional text description for the instances that are created from this + * machine image. * * Generated from protobuf field optional string description = 422937596; * @param string $var @@ -252,7 +319,8 @@ public function setDescription($var) } /** - * An array of disks that are associated with the instances that are created from this machine image. + * An array of disks that are associated with the instances that are created + * from this machine image. * * Generated from protobuf field repeated .google.cloud.compute.v1.SavedAttachedDisk disks = 95594102; * @return \Google\Protobuf\Internal\RepeatedField @@ -263,7 +331,8 @@ public function getDisks() } /** - * An array of disks that are associated with the instances that are created from this machine image. + * An array of disks that are associated with the instances that are created + * from this machine image. * * Generated from protobuf field repeated .google.cloud.compute.v1.SavedAttachedDisk disks = 95594102; * @param array<\Google\Cloud\Compute\V1\SavedAttachedDisk>|\Google\Protobuf\Internal\RepeatedField $var @@ -278,7 +347,8 @@ public function setDisks($var) } /** - * A list of guest accelerator cards' type and count to use for instances created from this machine image. + * A list of guest accelerator cards' type and count to use for instances + * created from this machine image. * * Generated from protobuf field repeated .google.cloud.compute.v1.AcceleratorConfig guest_accelerators = 463595119; * @return \Google\Protobuf\Internal\RepeatedField @@ -289,7 +359,8 @@ public function getGuestAccelerators() } /** - * A list of guest accelerator cards' type and count to use for instances created from this machine image. + * A list of guest accelerator cards' type and count to use for instances + * created from this machine image. * * Generated from protobuf field repeated .google.cloud.compute.v1.AcceleratorConfig guest_accelerators = 463595119; * @param array<\Google\Cloud\Compute\V1\AcceleratorConfig>|\Google\Protobuf\Internal\RepeatedField $var @@ -304,7 +375,8 @@ public function setGuestAccelerators($var) } /** - * KeyRevocationActionType of the instance. Supported options are "STOP" and "NONE". The default value is "NONE" if it is not specified. + * KeyRevocationActionType of the instance. Supported options are "STOP" and + * "NONE". The default value is "NONE" if it is not specified. * Check the KeyRevocationActionType enum for the list of possible values. * * Generated from protobuf field optional string key_revocation_action_type = 235941474; @@ -326,7 +398,8 @@ public function clearKeyRevocationActionType() } /** - * KeyRevocationActionType of the instance. Supported options are "STOP" and "NONE". The default value is "NONE" if it is not specified. + * KeyRevocationActionType of the instance. Supported options are "STOP" and + * "NONE". The default value is "NONE" if it is not specified. * Check the KeyRevocationActionType enum for the list of possible values. * * Generated from protobuf field optional string key_revocation_action_type = 235941474; @@ -368,7 +441,8 @@ public function setLabels($var) } /** - * The machine type to use for instances that are created from this machine image. + * The machine type to use for instances that are created from this machine + * image. * * Generated from protobuf field optional string machine_type = 227711026; * @return string @@ -389,7 +463,8 @@ public function clearMachineType() } /** - * The machine type to use for instances that are created from this machine image. + * The machine type to use for instances that are created from this machine + * image. * * Generated from protobuf field optional string machine_type = 227711026; * @param string $var @@ -404,7 +479,10 @@ public function setMachineType($var) } /** - * The metadata key/value pairs to assign to instances that are created from this machine image. These pairs can consist of custom metadata or predefined keys. See Project and instance metadata for more information. + * The metadata key/value pairs to assign to instances that are created from + * this machine image. These pairs can consist of custom metadata or + * predefined keys. SeeProject and + * instance metadata for more information. * * Generated from protobuf field optional .google.cloud.compute.v1.Metadata metadata = 86866735; * @return \Google\Cloud\Compute\V1\Metadata|null @@ -425,7 +503,10 @@ public function clearMetadata() } /** - * The metadata key/value pairs to assign to instances that are created from this machine image. These pairs can consist of custom metadata or predefined keys. See Project and instance metadata for more information. + * The metadata key/value pairs to assign to instances that are created from + * this machine image. These pairs can consist of custom metadata or + * predefined keys. SeeProject and + * instance metadata for more information. * * Generated from protobuf field optional .google.cloud.compute.v1.Metadata metadata = 86866735; * @param \Google\Cloud\Compute\V1\Metadata $var @@ -440,7 +521,12 @@ public function setMetadata($var) } /** - * Minimum cpu/platform to be used by instances created from this machine image. The instance may be scheduled on the specified or newer cpu/platform. Applicable values are the friendly names of CPU platforms, such as minCpuPlatform: "Intel Haswell" or minCpuPlatform: "Intel Sandy Bridge". For more information, read Specifying a Minimum CPU Platform. + * Minimum cpu/platform to be used by instances created from this machine + * image. The instance may be scheduled on the specified or newer + * cpu/platform. Applicable values are the friendly names of CPU platforms, + * such as minCpuPlatform: "Intel Haswell" orminCpuPlatform: "Intel Sandy Bridge". For more + * information, read Specifying a + * Minimum CPU Platform. * * Generated from protobuf field optional string min_cpu_platform = 242912759; * @return string @@ -461,7 +547,12 @@ public function clearMinCpuPlatform() } /** - * Minimum cpu/platform to be used by instances created from this machine image. The instance may be scheduled on the specified or newer cpu/platform. Applicable values are the friendly names of CPU platforms, such as minCpuPlatform: "Intel Haswell" or minCpuPlatform: "Intel Sandy Bridge". For more information, read Specifying a Minimum CPU Platform. + * Minimum cpu/platform to be used by instances created from this machine + * image. The instance may be scheduled on the specified or newer + * cpu/platform. Applicable values are the friendly names of CPU platforms, + * such as minCpuPlatform: "Intel Haswell" orminCpuPlatform: "Intel Sandy Bridge". For more + * information, read Specifying a + * Minimum CPU Platform. * * Generated from protobuf field optional string min_cpu_platform = 242912759; * @param string $var @@ -502,7 +593,8 @@ public function setNetworkInterfaces($var) } /** - * Specifies the scheduling options for the instances that are created from this machine image. + * Specifies the scheduling options for the instances that are created from + * this machine image. * * Generated from protobuf field optional .google.cloud.compute.v1.Scheduling scheduling = 386688404; * @return \Google\Cloud\Compute\V1\Scheduling|null @@ -523,7 +615,8 @@ public function clearScheduling() } /** - * Specifies the scheduling options for the instances that are created from this machine image. + * Specifies the scheduling options for the instances that are created from + * this machine image. * * Generated from protobuf field optional .google.cloud.compute.v1.Scheduling scheduling = 386688404; * @param \Google\Cloud\Compute\V1\Scheduling $var @@ -538,7 +631,10 @@ public function setScheduling($var) } /** - * A list of service accounts with specified scopes. Access tokens for these service accounts are available to the instances that are created from this machine image. Use metadata queries to obtain the access tokens for these instances. + * A list of service accounts with specified scopes. Access tokens for these + * service accounts are available to the instances that are created from this + * machine image. Use metadata queries to obtain the access tokens for these + * instances. * * Generated from protobuf field repeated .google.cloud.compute.v1.ServiceAccount service_accounts = 277537328; * @return \Google\Protobuf\Internal\RepeatedField @@ -549,7 +645,10 @@ public function getServiceAccounts() } /** - * A list of service accounts with specified scopes. Access tokens for these service accounts are available to the instances that are created from this machine image. Use metadata queries to obtain the access tokens for these instances. + * A list of service accounts with specified scopes. Access tokens for these + * service accounts are available to the instances that are created from this + * machine image. Use metadata queries to obtain the access tokens for these + * instances. * * Generated from protobuf field repeated .google.cloud.compute.v1.ServiceAccount service_accounts = 277537328; * @param array<\Google\Cloud\Compute\V1\ServiceAccount>|\Google\Protobuf\Internal\RepeatedField $var @@ -564,7 +663,10 @@ public function setServiceAccounts($var) } /** - * A list of tags to apply to the instances that are created from this machine image. The tags identify valid sources or targets for network firewalls. The setTags method can modify this list of tags. Each tag within the list must comply with RFC1035. + * A list of tags to apply to the instances that are created from this machine + * image. The tags identify valid sources or targets for network firewalls. + * The setTags method can modify this list of tags. Each tag within the list + * must comply withRFC1035. * * Generated from protobuf field optional .google.cloud.compute.v1.Tags tags = 3552281; * @return \Google\Cloud\Compute\V1\Tags|null @@ -585,7 +687,10 @@ public function clearTags() } /** - * A list of tags to apply to the instances that are created from this machine image. The tags identify valid sources or targets for network firewalls. The setTags method can modify this list of tags. Each tag within the list must comply with RFC1035. + * A list of tags to apply to the instances that are created from this machine + * image. The tags identify valid sources or targets for network firewalls. + * The setTags method can modify this list of tags. Each tag within the list + * must comply withRFC1035. * * Generated from protobuf field optional .google.cloud.compute.v1.Tags tags = 3552281; * @param \Google\Cloud\Compute\V1\Tags $var diff --git a/Compute/src/V1/SourceInstanceProperties/KeyRevocationActionType.php b/Compute/src/V1/SourceInstanceProperties/KeyRevocationActionType.php index f084242b0425..208ee201d369 100644 --- a/Compute/src/V1/SourceInstanceProperties/KeyRevocationActionType.php +++ b/Compute/src/V1/SourceInstanceProperties/KeyRevocationActionType.php @@ -7,7 +7,8 @@ use UnexpectedValueException; /** - * KeyRevocationActionType of the instance. Supported options are "STOP" and "NONE". The default value is "NONE" if it is not specified. + * KeyRevocationActionType of the instance. Supported options are "STOP" and + * "NONE". The default value is "NONE" if it is not specified. * * Protobuf type google.cloud.compute.v1.SourceInstanceProperties.KeyRevocationActionType */ diff --git a/Compute/src/V1/SslCertificate.php b/Compute/src/V1/SslCertificate.php index cdaa642665d5..6b3a379d5f5c 100644 --- a/Compute/src/V1/SslCertificate.php +++ b/Compute/src/V1/SslCertificate.php @@ -9,26 +9,50 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Represents an SSL certificate resource. Google Compute Engine has two SSL certificate resources: * [Global](/compute/docs/reference/rest/v1/sslCertificates) * [Regional](/compute/docs/reference/rest/v1/regionSslCertificates) The global SSL certificates (sslCertificates) are used by: - Global external Application Load Balancers - Classic Application Load Balancers - Proxy Network Load Balancers (with target SSL proxies) The regional SSL certificates (regionSslCertificates) are used by: - Regional external Application Load Balancers - Regional internal Application Load Balancers Optionally, certificate file contents that you upload can contain a set of up to five PEM-encoded certificates. The API call creates an object (sslCertificate) that holds this data. You can use SSL keys and certificates to secure connections to a load balancer. For more information, read Creating and using SSL certificates, SSL certificates quotas and limits, and Troubleshooting SSL certificates. + * Represents an SSL certificate resource. + * Google Compute Engine has two SSL certificate resources: + * * [Global](/compute/docs/reference/rest/v1/sslCertificates) + * * [Regional](/compute/docs/reference/rest/v1/regionSslCertificates) + * The global SSL certificates (sslCertificates) are used by: + * - Global external Application Load Balancers + * - Classic Application Load Balancers + * - Proxy Network Load Balancers (with target SSL proxies) + * The regional SSL certificates (regionSslCertificates) are used + * by: + * - Regional external Application Load Balancers + * - Regional internal Application Load Balancers + * Optionally, certificate file contents that you upload can contain a set of up + * to five PEM-encoded certificates. + * The API call creates an object (sslCertificate) that holds this data. + * You can use SSL keys and certificates to secure connections to a load + * balancer. + * For more information, read + * Creating and using SSL certificates,SSL certificates + * quotas and limits, and + * Troubleshooting SSL certificates. * * Generated from protobuf message google.cloud.compute.v1.SslCertificate */ class SslCertificate extends \Google\Protobuf\Internal\Message { /** - * A value read into memory from a certificate file. The certificate file must be in PEM format. The certificate chain must be no greater than 5 certs long. The chain must include at least one intermediate cert. + * A value read into memory from a certificate file. The certificate file must + * be in PEM format. The certificate chain must be no greater than 5 certs + * long. The chain must include at least one intermediate cert. * * Generated from protobuf field optional string certificate = 341787031; */ protected $certificate = null; /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; */ protected $creation_timestamp = null; /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; */ @@ -40,13 +64,14 @@ class SslCertificate extends \Google\Protobuf\Internal\Message */ protected $expire_time = null; /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; */ protected $id = null; /** - * [Output Only] Type of the resource. Always compute#sslCertificate for SSL certificates. + * [Output Only] Type of the resource. Alwayscompute#sslCertificate for SSL certificates. * * Generated from protobuf field optional string kind = 3292052; */ @@ -58,19 +83,28 @@ class SslCertificate extends \Google\Protobuf\Internal\Message */ protected $managed = null; /** - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * * Generated from protobuf field optional string name = 3373707; */ protected $name = null; /** - * A value read into memory from a write-only private key file. The private key file must be in PEM format. For security, only insert requests include this field. + * A value read into memory from a write-only private key file. The private + * key file must be in PEM format. For security, only insert + * requests include this field. * * Generated from protobuf field optional string private_key = 361331107; */ protected $private_key = null; /** - * [Output Only] URL of the region where the regional SSL Certificate resides. This field is not applicable to global SSL Certificate. + * [Output Only] URL of the region where the regional SSL Certificate + * resides. This field is not applicable to global SSL Certificate. * * Generated from protobuf field optional string region = 138946292; */ @@ -88,13 +122,15 @@ class SslCertificate extends \Google\Protobuf\Internal\Message */ protected $self_managed = null; /** - * [Output Only] Domains associated with the certificate via Subject Alternative Name. + * [Output Only] Domains associated with the certificate via Subject + * Alternative Name. * * Generated from protobuf field repeated string subject_alternative_names = 528807907; */ private $subject_alternative_names; /** - * (Optional) Specifies the type of SSL certificate, either "SELF_MANAGED" or "MANAGED". If not specified, the certificate is self-managed and the fields certificate and private_key are used. + * (Optional) Specifies the type of SSL certificate, either "SELF_MANAGED" or + * "MANAGED". If not specified, the certificate is self-managed and the fieldscertificate and private_key are used. * Check the Type enum for the list of possible values. * * Generated from protobuf field optional string type = 3575610; @@ -108,33 +144,49 @@ class SslCertificate extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $certificate - * A value read into memory from a certificate file. The certificate file must be in PEM format. The certificate chain must be no greater than 5 certs long. The chain must include at least one intermediate cert. + * A value read into memory from a certificate file. The certificate file must + * be in PEM format. The certificate chain must be no greater than 5 certs + * long. The chain must include at least one intermediate cert. * @type string $creation_timestamp - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * @type string $description - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * @type string $expire_time * [Output Only] Expire time of the certificate. RFC3339 * @type int|string $id - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * @type string $kind - * [Output Only] Type of the resource. Always compute#sslCertificate for SSL certificates. + * [Output Only] Type of the resource. Alwayscompute#sslCertificate for SSL certificates. * @type \Google\Cloud\Compute\V1\SslCertificateManagedSslCertificate $managed * Configuration and status of a managed SSL certificate. * @type string $name - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * @type string $private_key - * A value read into memory from a write-only private key file. The private key file must be in PEM format. For security, only insert requests include this field. + * A value read into memory from a write-only private key file. The private + * key file must be in PEM format. For security, only insert + * requests include this field. * @type string $region - * [Output Only] URL of the region where the regional SSL Certificate resides. This field is not applicable to global SSL Certificate. + * [Output Only] URL of the region where the regional SSL Certificate + * resides. This field is not applicable to global SSL Certificate. * @type string $self_link * [Output only] Server-defined URL for the resource. * @type \Google\Cloud\Compute\V1\SslCertificateSelfManagedSslCertificate $self_managed * Configuration and status of a self-managed SSL certificate. * @type array|\Google\Protobuf\Internal\RepeatedField $subject_alternative_names - * [Output Only] Domains associated with the certificate via Subject Alternative Name. + * [Output Only] Domains associated with the certificate via Subject + * Alternative Name. * @type string $type - * (Optional) Specifies the type of SSL certificate, either "SELF_MANAGED" or "MANAGED". If not specified, the certificate is self-managed and the fields certificate and private_key are used. + * (Optional) Specifies the type of SSL certificate, either "SELF_MANAGED" or + * "MANAGED". If not specified, the certificate is self-managed and the fieldscertificate and private_key are used. * Check the Type enum for the list of possible values. * } */ @@ -144,7 +196,9 @@ public function __construct($data = NULL) { } /** - * A value read into memory from a certificate file. The certificate file must be in PEM format. The certificate chain must be no greater than 5 certs long. The chain must include at least one intermediate cert. + * A value read into memory from a certificate file. The certificate file must + * be in PEM format. The certificate chain must be no greater than 5 certs + * long. The chain must include at least one intermediate cert. * * Generated from protobuf field optional string certificate = 341787031; * @return string @@ -165,7 +219,9 @@ public function clearCertificate() } /** - * A value read into memory from a certificate file. The certificate file must be in PEM format. The certificate chain must be no greater than 5 certs long. The chain must include at least one intermediate cert. + * A value read into memory from a certificate file. The certificate file must + * be in PEM format. The certificate chain must be no greater than 5 certs + * long. The chain must include at least one intermediate cert. * * Generated from protobuf field optional string certificate = 341787031; * @param string $var @@ -180,7 +236,8 @@ public function setCertificate($var) } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @return string @@ -201,7 +258,8 @@ public function clearCreationTimestamp() } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @param string $var @@ -216,7 +274,8 @@ public function setCreationTimestamp($var) } /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @return string @@ -237,7 +296,8 @@ public function clearDescription() } /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @param string $var @@ -288,7 +348,8 @@ public function setExpireTime($var) } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @return int|string @@ -309,7 +370,8 @@ public function clearId() } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @param int|string $var @@ -324,7 +386,7 @@ public function setId($var) } /** - * [Output Only] Type of the resource. Always compute#sslCertificate for SSL certificates. + * [Output Only] Type of the resource. Alwayscompute#sslCertificate for SSL certificates. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -345,7 +407,7 @@ public function clearKind() } /** - * [Output Only] Type of the resource. Always compute#sslCertificate for SSL certificates. + * [Output Only] Type of the resource. Alwayscompute#sslCertificate for SSL certificates. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -396,7 +458,13 @@ public function setManaged($var) } /** - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * * Generated from protobuf field optional string name = 3373707; * @return string @@ -417,7 +485,13 @@ public function clearName() } /** - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * * Generated from protobuf field optional string name = 3373707; * @param string $var @@ -432,7 +506,9 @@ public function setName($var) } /** - * A value read into memory from a write-only private key file. The private key file must be in PEM format. For security, only insert requests include this field. + * A value read into memory from a write-only private key file. The private + * key file must be in PEM format. For security, only insert + * requests include this field. * * Generated from protobuf field optional string private_key = 361331107; * @return string @@ -453,7 +529,9 @@ public function clearPrivateKey() } /** - * A value read into memory from a write-only private key file. The private key file must be in PEM format. For security, only insert requests include this field. + * A value read into memory from a write-only private key file. The private + * key file must be in PEM format. For security, only insert + * requests include this field. * * Generated from protobuf field optional string private_key = 361331107; * @param string $var @@ -468,7 +546,8 @@ public function setPrivateKey($var) } /** - * [Output Only] URL of the region where the regional SSL Certificate resides. This field is not applicable to global SSL Certificate. + * [Output Only] URL of the region where the regional SSL Certificate + * resides. This field is not applicable to global SSL Certificate. * * Generated from protobuf field optional string region = 138946292; * @return string @@ -489,7 +568,8 @@ public function clearRegion() } /** - * [Output Only] URL of the region where the regional SSL Certificate resides. This field is not applicable to global SSL Certificate. + * [Output Only] URL of the region where the regional SSL Certificate + * resides. This field is not applicable to global SSL Certificate. * * Generated from protobuf field optional string region = 138946292; * @param string $var @@ -576,7 +656,8 @@ public function setSelfManaged($var) } /** - * [Output Only] Domains associated with the certificate via Subject Alternative Name. + * [Output Only] Domains associated with the certificate via Subject + * Alternative Name. * * Generated from protobuf field repeated string subject_alternative_names = 528807907; * @return \Google\Protobuf\Internal\RepeatedField @@ -587,7 +668,8 @@ public function getSubjectAlternativeNames() } /** - * [Output Only] Domains associated with the certificate via Subject Alternative Name. + * [Output Only] Domains associated with the certificate via Subject + * Alternative Name. * * Generated from protobuf field repeated string subject_alternative_names = 528807907; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -602,7 +684,8 @@ public function setSubjectAlternativeNames($var) } /** - * (Optional) Specifies the type of SSL certificate, either "SELF_MANAGED" or "MANAGED". If not specified, the certificate is self-managed and the fields certificate and private_key are used. + * (Optional) Specifies the type of SSL certificate, either "SELF_MANAGED" or + * "MANAGED". If not specified, the certificate is self-managed and the fieldscertificate and private_key are used. * Check the Type enum for the list of possible values. * * Generated from protobuf field optional string type = 3575610; @@ -624,7 +707,8 @@ public function clearType() } /** - * (Optional) Specifies the type of SSL certificate, either "SELF_MANAGED" or "MANAGED". If not specified, the certificate is self-managed and the fields certificate and private_key are used. + * (Optional) Specifies the type of SSL certificate, either "SELF_MANAGED" or + * "MANAGED". If not specified, the certificate is self-managed and the fieldscertificate and private_key are used. * Check the Type enum for the list of possible values. * * Generated from protobuf field optional string type = 3575610; diff --git a/Compute/src/V1/SslCertificate/Type.php b/Compute/src/V1/SslCertificate/Type.php index 8bd221235178..9ba99c7e9b0b 100644 --- a/Compute/src/V1/SslCertificate/Type.php +++ b/Compute/src/V1/SslCertificate/Type.php @@ -7,7 +7,8 @@ use UnexpectedValueException; /** - * (Optional) Specifies the type of SSL certificate, either "SELF_MANAGED" or "MANAGED". If not specified, the certificate is self-managed and the fields certificate and private_key are used. + * (Optional) Specifies the type of SSL certificate, either "SELF_MANAGED" or + * "MANAGED". If not specified, the certificate is self-managed and the fieldscertificate and private_key are used. * * Protobuf type google.cloud.compute.v1.SslCertificate.Type */ diff --git a/Compute/src/V1/SslCertificateAggregatedList.php b/Compute/src/V1/SslCertificateAggregatedList.php index 75f0ec6f5dfc..4bcb5837a813 100644 --- a/Compute/src/V1/SslCertificateAggregatedList.php +++ b/Compute/src/V1/SslCertificateAggregatedList.php @@ -27,13 +27,18 @@ class SslCertificateAggregatedList extends \Google\Protobuf\Internal\Message */ private $items; /** - * [Output Only] Type of resource. Always compute#sslCertificateAggregatedList for lists of SSL Certificates. + * [Output Only] Type of resource. Alwayscompute#sslCertificateAggregatedList for lists of SSL + * Certificates. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -68,9 +73,14 @@ class SslCertificateAggregatedList extends \Google\Protobuf\Internal\Message * @type array|\Google\Protobuf\Internal\MapField $items * A list of SslCertificatesScopedList resources. * @type string $kind - * [Output Only] Type of resource. Always compute#sslCertificateAggregatedList for lists of SSL Certificates. + * [Output Only] Type of resource. Alwayscompute#sslCertificateAggregatedList for lists of SSL + * Certificates. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type array|\Google\Protobuf\Internal\RepeatedField $unreachables @@ -147,7 +157,8 @@ public function setItems($var) } /** - * [Output Only] Type of resource. Always compute#sslCertificateAggregatedList for lists of SSL Certificates. + * [Output Only] Type of resource. Alwayscompute#sslCertificateAggregatedList for lists of SSL + * Certificates. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -168,7 +179,8 @@ public function clearKind() } /** - * [Output Only] Type of resource. Always compute#sslCertificateAggregatedList for lists of SSL Certificates. + * [Output Only] Type of resource. Alwayscompute#sslCertificateAggregatedList for lists of SSL + * Certificates. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -183,7 +195,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -204,7 +220,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/SslCertificateList.php b/Compute/src/V1/SslCertificateList.php index 8e4026985531..048d4478e57c 100644 --- a/Compute/src/V1/SslCertificateList.php +++ b/Compute/src/V1/SslCertificateList.php @@ -34,7 +34,11 @@ class SslCertificateList extends \Google\Protobuf\Internal\Message */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -65,7 +69,11 @@ class SslCertificateList extends \Google\Protobuf\Internal\Message * @type string $kind * Type of resource. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type \Google\Cloud\Compute\V1\Warning $warning @@ -176,7 +184,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -197,7 +209,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/SslCertificateManagedSslCertificate.php b/Compute/src/V1/SslCertificateManagedSslCertificate.php index ad4afe804104..570074b38540 100644 --- a/Compute/src/V1/SslCertificateManagedSslCertificate.php +++ b/Compute/src/V1/SslCertificateManagedSslCertificate.php @@ -16,13 +16,17 @@ class SslCertificateManagedSslCertificate extends \Google\Protobuf\Internal\Message { /** - * [Output only] Detailed statuses of the domains specified for managed certificate resource. + * [Output only] Detailed statuses of the domains specified for managed + * certificate resource. * * Generated from protobuf field map domain_status = 360305613; */ private $domain_status; /** - * The domains for which a managed SSL certificate will be generated. Each Google-managed SSL certificate supports up to the [maximum number of domains per Google-managed SSL certificate](/load-balancing/docs/quotas#ssl_certificates). + * The domains for which a managed SSL certificate will be generated. Each + * Google-managed SSL certificate supports up to the [maximum number of + * domains per Google-managed SSL + * certificate](/load-balancing/docs/quotas#ssl_certificates). * * Generated from protobuf field repeated string domains = 226935855; */ @@ -42,9 +46,13 @@ class SslCertificateManagedSslCertificate extends \Google\Protobuf\Internal\Mess * Optional. Data for populating the Message object. * * @type array|\Google\Protobuf\Internal\MapField $domain_status - * [Output only] Detailed statuses of the domains specified for managed certificate resource. + * [Output only] Detailed statuses of the domains specified for managed + * certificate resource. * @type array|\Google\Protobuf\Internal\RepeatedField $domains - * The domains for which a managed SSL certificate will be generated. Each Google-managed SSL certificate supports up to the [maximum number of domains per Google-managed SSL certificate](/load-balancing/docs/quotas#ssl_certificates). + * The domains for which a managed SSL certificate will be generated. Each + * Google-managed SSL certificate supports up to the [maximum number of + * domains per Google-managed SSL + * certificate](/load-balancing/docs/quotas#ssl_certificates). * @type string $status * [Output only] Status of the managed certificate resource. * Check the Status enum for the list of possible values. @@ -56,7 +64,8 @@ public function __construct($data = NULL) { } /** - * [Output only] Detailed statuses of the domains specified for managed certificate resource. + * [Output only] Detailed statuses of the domains specified for managed + * certificate resource. * * Generated from protobuf field map domain_status = 360305613; * @return \Google\Protobuf\Internal\MapField @@ -67,7 +76,8 @@ public function getDomainStatus() } /** - * [Output only] Detailed statuses of the domains specified for managed certificate resource. + * [Output only] Detailed statuses of the domains specified for managed + * certificate resource. * * Generated from protobuf field map domain_status = 360305613; * @param array|\Google\Protobuf\Internal\MapField $var @@ -82,7 +92,10 @@ public function setDomainStatus($var) } /** - * The domains for which a managed SSL certificate will be generated. Each Google-managed SSL certificate supports up to the [maximum number of domains per Google-managed SSL certificate](/load-balancing/docs/quotas#ssl_certificates). + * The domains for which a managed SSL certificate will be generated. Each + * Google-managed SSL certificate supports up to the [maximum number of + * domains per Google-managed SSL + * certificate](/load-balancing/docs/quotas#ssl_certificates). * * Generated from protobuf field repeated string domains = 226935855; * @return \Google\Protobuf\Internal\RepeatedField @@ -93,7 +106,10 @@ public function getDomains() } /** - * The domains for which a managed SSL certificate will be generated. Each Google-managed SSL certificate supports up to the [maximum number of domains per Google-managed SSL certificate](/load-balancing/docs/quotas#ssl_certificates). + * The domains for which a managed SSL certificate will be generated. Each + * Google-managed SSL certificate supports up to the [maximum number of + * domains per Google-managed SSL + * certificate](/load-balancing/docs/quotas#ssl_certificates). * * Generated from protobuf field repeated string domains = 226935855; * @param array|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/SslCertificateManagedSslCertificate/Status.php b/Compute/src/V1/SslCertificateManagedSslCertificate/Status.php index 70945b69ad0a..49226ee7647d 100644 --- a/Compute/src/V1/SslCertificateManagedSslCertificate/Status.php +++ b/Compute/src/V1/SslCertificateManagedSslCertificate/Status.php @@ -20,7 +20,8 @@ class Status */ const UNDEFINED_STATUS = 0; /** - * The certificate management is working, and a certificate has been provisioned. + * The certificate management is working, and a certificate has been + * provisioned. * * Generated from protobuf enum ACTIVE = 314733318; */ @@ -30,25 +31,35 @@ class Status */ const MANAGED_CERTIFICATE_STATUS_UNSPECIFIED = 474800850; /** - * The certificate management is working. GCP will attempt to provision the first certificate. + * The certificate management is working. GCP will attempt to provision + * the first certificate. * * Generated from protobuf enum PROVISIONING = 290896621; */ const PROVISIONING = 290896621; /** - * Certificate provisioning failed due to an issue with the DNS or load balancing configuration. For details of which domain failed, consult domain_status field. + * Certificate provisioning failed due to an issue with the DNS + * or load balancing configuration. + * For details of which domain failed, consult domain_status field. * * Generated from protobuf enum PROVISIONING_FAILED = 76813775; */ const PROVISIONING_FAILED = 76813775; /** - * Certificate provisioning failed due to an issue with the DNS or load balancing configuration. It won't be retried. To try again delete and create a new managed SslCertificate resource. For details of which domain failed, consult domain_status field. + * Certificate provisioning failed due to an issue with the DNS + * or load balancing configuration. It won't be retried. To try again + * delete and create a new managed SslCertificate resource. + * For details of which domain failed, consult domain_status field. * * Generated from protobuf enum PROVISIONING_FAILED_PERMANENTLY = 275036203; */ const PROVISIONING_FAILED_PERMANENTLY = 275036203; /** - * Renewal of the certificate has failed due to an issue with the DNS or load balancing configuration. The existing cert is still serving; however, it will expire shortly. To provision a renewed certificate, delete and create a new managed SslCertificate resource. For details on which domain failed, consult domain_status field. + * Renewal of the certificate has failed due to an issue with the DNS + * or load balancing configuration. The existing cert is still serving; + * however, it will expire shortly. To provision a renewed certificate, + * delete and create a new managed SslCertificate resource. + * For details on which domain failed, consult domain_status field. * * Generated from protobuf enum RENEWAL_FAILED = 434659076; */ diff --git a/Compute/src/V1/SslCertificateSelfManagedSslCertificate.php b/Compute/src/V1/SslCertificateSelfManagedSslCertificate.php index 68cbc09e74be..6102b7057d5c 100644 --- a/Compute/src/V1/SslCertificateSelfManagedSslCertificate.php +++ b/Compute/src/V1/SslCertificateSelfManagedSslCertificate.php @@ -16,13 +16,16 @@ class SslCertificateSelfManagedSslCertificate extends \Google\Protobuf\Internal\Message { /** - * A local certificate file. The certificate must be in PEM format. The certificate chain must be no greater than 5 certs long. The chain must include at least one intermediate cert. + * A local certificate file. The certificate must be in + * PEM format. The certificate chain must be no greater than 5 certs + * long. The chain must include at least one intermediate cert. * * Generated from protobuf field optional string certificate = 341787031; */ protected $certificate = null; /** - * A write-only private key in PEM format. Only insert requests will include this field. + * A write-only private key in PEM format. Only insert + * requests will include this field. * * Generated from protobuf field optional string private_key = 361331107; */ @@ -35,9 +38,12 @@ class SslCertificateSelfManagedSslCertificate extends \Google\Protobuf\Internal\ * Optional. Data for populating the Message object. * * @type string $certificate - * A local certificate file. The certificate must be in PEM format. The certificate chain must be no greater than 5 certs long. The chain must include at least one intermediate cert. + * A local certificate file. The certificate must be in + * PEM format. The certificate chain must be no greater than 5 certs + * long. The chain must include at least one intermediate cert. * @type string $private_key - * A write-only private key in PEM format. Only insert requests will include this field. + * A write-only private key in PEM format. Only insert + * requests will include this field. * } */ public function __construct($data = NULL) { @@ -46,7 +52,9 @@ public function __construct($data = NULL) { } /** - * A local certificate file. The certificate must be in PEM format. The certificate chain must be no greater than 5 certs long. The chain must include at least one intermediate cert. + * A local certificate file. The certificate must be in + * PEM format. The certificate chain must be no greater than 5 certs + * long. The chain must include at least one intermediate cert. * * Generated from protobuf field optional string certificate = 341787031; * @return string @@ -67,7 +75,9 @@ public function clearCertificate() } /** - * A local certificate file. The certificate must be in PEM format. The certificate chain must be no greater than 5 certs long. The chain must include at least one intermediate cert. + * A local certificate file. The certificate must be in + * PEM format. The certificate chain must be no greater than 5 certs + * long. The chain must include at least one intermediate cert. * * Generated from protobuf field optional string certificate = 341787031; * @param string $var @@ -82,7 +92,8 @@ public function setCertificate($var) } /** - * A write-only private key in PEM format. Only insert requests will include this field. + * A write-only private key in PEM format. Only insert + * requests will include this field. * * Generated from protobuf field optional string private_key = 361331107; * @return string @@ -103,7 +114,8 @@ public function clearPrivateKey() } /** - * A write-only private key in PEM format. Only insert requests will include this field. + * A write-only private key in PEM format. Only insert + * requests will include this field. * * Generated from protobuf field optional string private_key = 361331107; * @param string $var diff --git a/Compute/src/V1/SslCertificatesScopedList.php b/Compute/src/V1/SslCertificatesScopedList.php index 87e8dca40524..f522281699f2 100644 --- a/Compute/src/V1/SslCertificatesScopedList.php +++ b/Compute/src/V1/SslCertificatesScopedList.php @@ -21,7 +21,8 @@ class SslCertificatesScopedList extends \Google\Protobuf\Internal\Message */ private $ssl_certificates; /** - * Informational warning which replaces the list of backend services when the list is empty. + * Informational warning which replaces the list of + * backend services when the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; */ @@ -36,7 +37,8 @@ class SslCertificatesScopedList extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\SslCertificate>|\Google\Protobuf\Internal\RepeatedField $ssl_certificates * List of SslCertificates contained in this scope. * @type \Google\Cloud\Compute\V1\Warning $warning - * Informational warning which replaces the list of backend services when the list is empty. + * Informational warning which replaces the list of + * backend services when the list is empty. * } */ public function __construct($data = NULL) { @@ -71,7 +73,8 @@ public function setSslCertificates($var) } /** - * Informational warning which replaces the list of backend services when the list is empty. + * Informational warning which replaces the list of + * backend services when the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; * @return \Google\Cloud\Compute\V1\Warning|null @@ -92,7 +95,8 @@ public function clearWarning() } /** - * Informational warning which replaces the list of backend services when the list is empty. + * Informational warning which replaces the list of + * backend services when the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; * @param \Google\Cloud\Compute\V1\Warning $var diff --git a/Compute/src/V1/SslPoliciesAggregatedList.php b/Compute/src/V1/SslPoliciesAggregatedList.php index 55af644842d5..71fde56bb3af 100644 --- a/Compute/src/V1/SslPoliciesAggregatedList.php +++ b/Compute/src/V1/SslPoliciesAggregatedList.php @@ -31,13 +31,17 @@ class SslPoliciesAggregatedList extends \Google\Protobuf\Internal\Message */ private $items; /** - * [Output Only] Type of resource. Always compute#sslPolicyAggregatedList for lists of SSL Policies. + * [Output Only] Type of resource. Alwayscompute#sslPolicyAggregatedList for lists of SSL Policies. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -73,9 +77,13 @@ class SslPoliciesAggregatedList extends \Google\Protobuf\Internal\Message * @type array|\Google\Protobuf\Internal\MapField $items * A list of SslPoliciesScopedList resources. * @type string $kind - * [Output Only] Type of resource. Always compute#sslPolicyAggregatedList for lists of SSL Policies. + * [Output Only] Type of resource. Alwayscompute#sslPolicyAggregatedList for lists of SSL Policies. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type array|\Google\Protobuf\Internal\RepeatedField $unreachables @@ -184,7 +192,7 @@ public function setItems($var) } /** - * [Output Only] Type of resource. Always compute#sslPolicyAggregatedList for lists of SSL Policies. + * [Output Only] Type of resource. Alwayscompute#sslPolicyAggregatedList for lists of SSL Policies. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -205,7 +213,7 @@ public function clearKind() } /** - * [Output Only] Type of resource. Always compute#sslPolicyAggregatedList for lists of SSL Policies. + * [Output Only] Type of resource. Alwayscompute#sslPolicyAggregatedList for lists of SSL Policies. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -220,7 +228,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -241,7 +253,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/SslPoliciesList.php b/Compute/src/V1/SslPoliciesList.php index f2e465b07d42..cf21263321fc 100644 --- a/Compute/src/V1/SslPoliciesList.php +++ b/Compute/src/V1/SslPoliciesList.php @@ -27,13 +27,17 @@ class SslPoliciesList extends \Google\Protobuf\Internal\Message */ private $items; /** - * [Output Only] Type of the resource. Always compute#sslPoliciesList for lists of sslPolicies. + * [Output Only] Type of the resource. Alwayscompute#sslPoliciesList for lists of sslPolicies. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -62,9 +66,13 @@ class SslPoliciesList extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\SslPolicy>|\Google\Protobuf\Internal\RepeatedField $items * A list of SslPolicy resources. * @type string $kind - * [Output Only] Type of the resource. Always compute#sslPoliciesList for lists of sslPolicies. + * [Output Only] Type of the resource. Alwayscompute#sslPoliciesList for lists of sslPolicies. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type \Google\Cloud\Compute\V1\Warning $warning @@ -139,7 +147,7 @@ public function setItems($var) } /** - * [Output Only] Type of the resource. Always compute#sslPoliciesList for lists of sslPolicies. + * [Output Only] Type of the resource. Alwayscompute#sslPoliciesList for lists of sslPolicies. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -160,7 +168,7 @@ public function clearKind() } /** - * [Output Only] Type of the resource. Always compute#sslPoliciesList for lists of sslPolicies. + * [Output Only] Type of the resource. Alwayscompute#sslPoliciesList for lists of sslPolicies. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -175,7 +183,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -196,7 +208,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/SslPoliciesScopedList.php b/Compute/src/V1/SslPoliciesScopedList.php index 63a901c49156..b306750054ae 100644 --- a/Compute/src/V1/SslPoliciesScopedList.php +++ b/Compute/src/V1/SslPoliciesScopedList.php @@ -21,7 +21,8 @@ class SslPoliciesScopedList extends \Google\Protobuf\Internal\Message */ private $ssl_policies; /** - * Informational warning which replaces the list of SSL policies when the list is empty. + * Informational warning which replaces the list of + * SSL policies when the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; */ @@ -36,7 +37,8 @@ class SslPoliciesScopedList extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\SslPolicy>|\Google\Protobuf\Internal\RepeatedField $ssl_policies * A list of SslPolicies contained in this scope. * @type \Google\Cloud\Compute\V1\Warning $warning - * Informational warning which replaces the list of SSL policies when the list is empty. + * Informational warning which replaces the list of + * SSL policies when the list is empty. * } */ public function __construct($data = NULL) { @@ -71,7 +73,8 @@ public function setSslPolicies($var) } /** - * Informational warning which replaces the list of SSL policies when the list is empty. + * Informational warning which replaces the list of + * SSL policies when the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; * @return \Google\Cloud\Compute\V1\Warning|null @@ -92,7 +95,8 @@ public function clearWarning() } /** - * Informational warning which replaces the list of SSL policies when the list is empty. + * Informational warning which replaces the list of + * SSL policies when the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; * @param \Google\Cloud\Compute\V1\Warning $var diff --git a/Compute/src/V1/SslPolicy.php b/Compute/src/V1/SslPolicy.php index 18c709b4d9a4..39959fadbeb4 100644 --- a/Compute/src/V1/SslPolicy.php +++ b/Compute/src/V1/SslPolicy.php @@ -9,26 +9,34 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Represents an SSL Policy resource. Use SSL policies to control SSL features, such as versions and cipher suites, that are offered by Application Load Balancers and proxy Network Load Balancers. For more information, read SSL policies overview. + * Represents an SSL Policy resource. + * Use SSL policies to control SSL features, such as versions and cipher + * suites, that are offered by Application Load Balancers and proxy Network Load + * Balancers. For more information, read + * SSL policies overview. * * Generated from protobuf message google.cloud.compute.v1.SslPolicy */ class SslPolicy extends \Google\Protobuf\Internal\Message { /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; */ protected $creation_timestamp = null; /** - * A list of features enabled when the selected profile is CUSTOM. The method returns the set of features that can be specified in this list. This field must be empty if the profile is not CUSTOM. + * A list of features enabled when the selected profile is CUSTOM. The + * method returns the set of features that can be + * specified in this list. This field must be empty if the profile is notCUSTOM. * * Generated from protobuf field repeated string custom_features = 34789707; */ private $custom_features; /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; */ @@ -40,45 +48,63 @@ class SslPolicy extends \Google\Protobuf\Internal\Message */ private $enabled_features; /** - * Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking. This field will be ignored when inserting a SslPolicy. An up-to-date fingerprint must be provided in order to update the SslPolicy, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve an SslPolicy. + * Fingerprint of this resource. A hash of the contents stored in this object. + * This field is used in optimistic locking. This field will be ignored when + * inserting a SslPolicy. An up-to-date fingerprint must be + * provided in order to update the SslPolicy, otherwise the + * request will fail with error 412 conditionNotMet. + * To see the latest fingerprint, make a get() request to + * retrieve an SslPolicy. * * Generated from protobuf field optional string fingerprint = 234678500; */ protected $fingerprint = null; /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; */ protected $id = null; /** - * [Output only] Type of the resource. Always compute#sslPolicyfor SSL policies. + * [Output only] Type of the resource. Alwayscompute#sslPolicyfor SSL policies. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * The minimum version of SSL protocol that can be used by the clients to establish a connection with the load balancer. This can be one of TLS_1_0, TLS_1_1, TLS_1_2. + * The minimum version of SSL protocol that can be used by the clients to + * establish a connection with the load balancer. This can be one ofTLS_1_0, TLS_1_1, TLS_1_2,TLS_1_3. When set to TLS_1_3, the profile field + * must be set to RESTRICTED. * Check the MinTlsVersion enum for the list of possible values. * * Generated from protobuf field optional string min_tls_version = 8155943; */ protected $min_tls_version = null; /** - * Name of the resource. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. The name must be 1-63 characters long, and comply + * with RFC1035. Specifically, the name must be 1-63 characters + * long and match the regular expression + * `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character + * must be a lowercase letter, and all following characters must be a dash, + * lowercase letter, or digit, except the last character, which cannot be a + * dash. * * Generated from protobuf field optional string name = 3373707; */ protected $name = null; /** - * Profile specifies the set of SSL features that can be used by the load balancer when negotiating SSL with clients. This can be one of COMPATIBLE, MODERN, RESTRICTED, or CUSTOM. If using CUSTOM, the set of SSL features to enable must be specified in the customFeatures field. + * Profile specifies the set of SSL features that can be used by the load + * balancer when negotiating SSL with clients. This can be one ofCOMPATIBLE, MODERN, RESTRICTED, orCUSTOM. If using CUSTOM, the set of SSL features + * to enable must be specified in the customFeatures field. * Check the Profile enum for the list of possible values. * * Generated from protobuf field optional string profile = 227445161; */ protected $profile = null; /** - * [Output Only] URL of the region where the regional SSL policy resides. This field is not applicable to global SSL policies. + * [Output Only] URL of the region where the regional SSL policy + * resides. This field is not applicable to global SSL policies. * * Generated from protobuf field optional string region = 138946292; */ @@ -90,7 +116,8 @@ class SslPolicy extends \Google\Protobuf\Internal\Message */ protected $self_link = null; /** - * [Output Only] If potential misconfigurations are detected for this SSL policy, this field will be populated with warning messages. + * [Output Only] If potential misconfigurations are detected for this + * SSL policy, this field will be populated with warning messages. * * Generated from protobuf field repeated .google.cloud.compute.v1.Warnings warnings = 498091095; */ @@ -103,33 +130,56 @@ class SslPolicy extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $creation_timestamp - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * @type array|\Google\Protobuf\Internal\RepeatedField $custom_features - * A list of features enabled when the selected profile is CUSTOM. The method returns the set of features that can be specified in this list. This field must be empty if the profile is not CUSTOM. + * A list of features enabled when the selected profile is CUSTOM. The + * method returns the set of features that can be + * specified in this list. This field must be empty if the profile is notCUSTOM. * @type string $description - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * @type array|\Google\Protobuf\Internal\RepeatedField $enabled_features * [Output Only] The list of features enabled in the SSL policy. * @type string $fingerprint - * Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking. This field will be ignored when inserting a SslPolicy. An up-to-date fingerprint must be provided in order to update the SslPolicy, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve an SslPolicy. + * Fingerprint of this resource. A hash of the contents stored in this object. + * This field is used in optimistic locking. This field will be ignored when + * inserting a SslPolicy. An up-to-date fingerprint must be + * provided in order to update the SslPolicy, otherwise the + * request will fail with error 412 conditionNotMet. + * To see the latest fingerprint, make a get() request to + * retrieve an SslPolicy. * @type int|string $id - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * @type string $kind - * [Output only] Type of the resource. Always compute#sslPolicyfor SSL policies. + * [Output only] Type of the resource. Alwayscompute#sslPolicyfor SSL policies. * @type string $min_tls_version - * The minimum version of SSL protocol that can be used by the clients to establish a connection with the load balancer. This can be one of TLS_1_0, TLS_1_1, TLS_1_2. + * The minimum version of SSL protocol that can be used by the clients to + * establish a connection with the load balancer. This can be one ofTLS_1_0, TLS_1_1, TLS_1_2,TLS_1_3. When set to TLS_1_3, the profile field + * must be set to RESTRICTED. * Check the MinTlsVersion enum for the list of possible values. * @type string $name - * Name of the resource. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. The name must be 1-63 characters long, and comply + * with RFC1035. Specifically, the name must be 1-63 characters + * long and match the regular expression + * `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character + * must be a lowercase letter, and all following characters must be a dash, + * lowercase letter, or digit, except the last character, which cannot be a + * dash. * @type string $profile - * Profile specifies the set of SSL features that can be used by the load balancer when negotiating SSL with clients. This can be one of COMPATIBLE, MODERN, RESTRICTED, or CUSTOM. If using CUSTOM, the set of SSL features to enable must be specified in the customFeatures field. + * Profile specifies the set of SSL features that can be used by the load + * balancer when negotiating SSL with clients. This can be one ofCOMPATIBLE, MODERN, RESTRICTED, orCUSTOM. If using CUSTOM, the set of SSL features + * to enable must be specified in the customFeatures field. * Check the Profile enum for the list of possible values. * @type string $region - * [Output Only] URL of the region where the regional SSL policy resides. This field is not applicable to global SSL policies. + * [Output Only] URL of the region where the regional SSL policy + * resides. This field is not applicable to global SSL policies. * @type string $self_link * [Output Only] Server-defined URL for the resource. * @type array<\Google\Cloud\Compute\V1\Warnings>|\Google\Protobuf\Internal\RepeatedField $warnings - * [Output Only] If potential misconfigurations are detected for this SSL policy, this field will be populated with warning messages. + * [Output Only] If potential misconfigurations are detected for this + * SSL policy, this field will be populated with warning messages. * } */ public function __construct($data = NULL) { @@ -138,7 +188,8 @@ public function __construct($data = NULL) { } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @return string @@ -159,7 +210,8 @@ public function clearCreationTimestamp() } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @param string $var @@ -174,7 +226,9 @@ public function setCreationTimestamp($var) } /** - * A list of features enabled when the selected profile is CUSTOM. The method returns the set of features that can be specified in this list. This field must be empty if the profile is not CUSTOM. + * A list of features enabled when the selected profile is CUSTOM. The + * method returns the set of features that can be + * specified in this list. This field must be empty if the profile is notCUSTOM. * * Generated from protobuf field repeated string custom_features = 34789707; * @return \Google\Protobuf\Internal\RepeatedField @@ -185,7 +239,9 @@ public function getCustomFeatures() } /** - * A list of features enabled when the selected profile is CUSTOM. The method returns the set of features that can be specified in this list. This field must be empty if the profile is not CUSTOM. + * A list of features enabled when the selected profile is CUSTOM. The + * method returns the set of features that can be + * specified in this list. This field must be empty if the profile is notCUSTOM. * * Generated from protobuf field repeated string custom_features = 34789707; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -200,7 +256,8 @@ public function setCustomFeatures($var) } /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @return string @@ -221,7 +278,8 @@ public function clearDescription() } /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @param string $var @@ -262,7 +320,13 @@ public function setEnabledFeatures($var) } /** - * Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking. This field will be ignored when inserting a SslPolicy. An up-to-date fingerprint must be provided in order to update the SslPolicy, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve an SslPolicy. + * Fingerprint of this resource. A hash of the contents stored in this object. + * This field is used in optimistic locking. This field will be ignored when + * inserting a SslPolicy. An up-to-date fingerprint must be + * provided in order to update the SslPolicy, otherwise the + * request will fail with error 412 conditionNotMet. + * To see the latest fingerprint, make a get() request to + * retrieve an SslPolicy. * * Generated from protobuf field optional string fingerprint = 234678500; * @return string @@ -283,7 +347,13 @@ public function clearFingerprint() } /** - * Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking. This field will be ignored when inserting a SslPolicy. An up-to-date fingerprint must be provided in order to update the SslPolicy, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve an SslPolicy. + * Fingerprint of this resource. A hash of the contents stored in this object. + * This field is used in optimistic locking. This field will be ignored when + * inserting a SslPolicy. An up-to-date fingerprint must be + * provided in order to update the SslPolicy, otherwise the + * request will fail with error 412 conditionNotMet. + * To see the latest fingerprint, make a get() request to + * retrieve an SslPolicy. * * Generated from protobuf field optional string fingerprint = 234678500; * @param string $var @@ -298,7 +368,8 @@ public function setFingerprint($var) } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @return int|string @@ -319,7 +390,8 @@ public function clearId() } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @param int|string $var @@ -334,7 +406,7 @@ public function setId($var) } /** - * [Output only] Type of the resource. Always compute#sslPolicyfor SSL policies. + * [Output only] Type of the resource. Alwayscompute#sslPolicyfor SSL policies. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -355,7 +427,7 @@ public function clearKind() } /** - * [Output only] Type of the resource. Always compute#sslPolicyfor SSL policies. + * [Output only] Type of the resource. Alwayscompute#sslPolicyfor SSL policies. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -370,7 +442,9 @@ public function setKind($var) } /** - * The minimum version of SSL protocol that can be used by the clients to establish a connection with the load balancer. This can be one of TLS_1_0, TLS_1_1, TLS_1_2. + * The minimum version of SSL protocol that can be used by the clients to + * establish a connection with the load balancer. This can be one ofTLS_1_0, TLS_1_1, TLS_1_2,TLS_1_3. When set to TLS_1_3, the profile field + * must be set to RESTRICTED. * Check the MinTlsVersion enum for the list of possible values. * * Generated from protobuf field optional string min_tls_version = 8155943; @@ -392,7 +466,9 @@ public function clearMinTlsVersion() } /** - * The minimum version of SSL protocol that can be used by the clients to establish a connection with the load balancer. This can be one of TLS_1_0, TLS_1_1, TLS_1_2. + * The minimum version of SSL protocol that can be used by the clients to + * establish a connection with the load balancer. This can be one ofTLS_1_0, TLS_1_1, TLS_1_2,TLS_1_3. When set to TLS_1_3, the profile field + * must be set to RESTRICTED. * Check the MinTlsVersion enum for the list of possible values. * * Generated from protobuf field optional string min_tls_version = 8155943; @@ -408,7 +484,13 @@ public function setMinTlsVersion($var) } /** - * Name of the resource. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. The name must be 1-63 characters long, and comply + * with RFC1035. Specifically, the name must be 1-63 characters + * long and match the regular expression + * `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character + * must be a lowercase letter, and all following characters must be a dash, + * lowercase letter, or digit, except the last character, which cannot be a + * dash. * * Generated from protobuf field optional string name = 3373707; * @return string @@ -429,7 +511,13 @@ public function clearName() } /** - * Name of the resource. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. The name must be 1-63 characters long, and comply + * with RFC1035. Specifically, the name must be 1-63 characters + * long and match the regular expression + * `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character + * must be a lowercase letter, and all following characters must be a dash, + * lowercase letter, or digit, except the last character, which cannot be a + * dash. * * Generated from protobuf field optional string name = 3373707; * @param string $var @@ -444,7 +532,9 @@ public function setName($var) } /** - * Profile specifies the set of SSL features that can be used by the load balancer when negotiating SSL with clients. This can be one of COMPATIBLE, MODERN, RESTRICTED, or CUSTOM. If using CUSTOM, the set of SSL features to enable must be specified in the customFeatures field. + * Profile specifies the set of SSL features that can be used by the load + * balancer when negotiating SSL with clients. This can be one ofCOMPATIBLE, MODERN, RESTRICTED, orCUSTOM. If using CUSTOM, the set of SSL features + * to enable must be specified in the customFeatures field. * Check the Profile enum for the list of possible values. * * Generated from protobuf field optional string profile = 227445161; @@ -466,7 +556,9 @@ public function clearProfile() } /** - * Profile specifies the set of SSL features that can be used by the load balancer when negotiating SSL with clients. This can be one of COMPATIBLE, MODERN, RESTRICTED, or CUSTOM. If using CUSTOM, the set of SSL features to enable must be specified in the customFeatures field. + * Profile specifies the set of SSL features that can be used by the load + * balancer when negotiating SSL with clients. This can be one ofCOMPATIBLE, MODERN, RESTRICTED, orCUSTOM. If using CUSTOM, the set of SSL features + * to enable must be specified in the customFeatures field. * Check the Profile enum for the list of possible values. * * Generated from protobuf field optional string profile = 227445161; @@ -482,7 +574,8 @@ public function setProfile($var) } /** - * [Output Only] URL of the region where the regional SSL policy resides. This field is not applicable to global SSL policies. + * [Output Only] URL of the region where the regional SSL policy + * resides. This field is not applicable to global SSL policies. * * Generated from protobuf field optional string region = 138946292; * @return string @@ -503,7 +596,8 @@ public function clearRegion() } /** - * [Output Only] URL of the region where the regional SSL policy resides. This field is not applicable to global SSL policies. + * [Output Only] URL of the region where the regional SSL policy + * resides. This field is not applicable to global SSL policies. * * Generated from protobuf field optional string region = 138946292; * @param string $var @@ -554,7 +648,8 @@ public function setSelfLink($var) } /** - * [Output Only] If potential misconfigurations are detected for this SSL policy, this field will be populated with warning messages. + * [Output Only] If potential misconfigurations are detected for this + * SSL policy, this field will be populated with warning messages. * * Generated from protobuf field repeated .google.cloud.compute.v1.Warnings warnings = 498091095; * @return \Google\Protobuf\Internal\RepeatedField @@ -565,7 +660,8 @@ public function getWarnings() } /** - * [Output Only] If potential misconfigurations are detected for this SSL policy, this field will be populated with warning messages. + * [Output Only] If potential misconfigurations are detected for this + * SSL policy, this field will be populated with warning messages. * * Generated from protobuf field repeated .google.cloud.compute.v1.Warnings warnings = 498091095; * @param array<\Google\Cloud\Compute\V1\Warnings>|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/SslPolicy/MinTlsVersion.php b/Compute/src/V1/SslPolicy/MinTlsVersion.php index 9d58ae477040..a3b9163a2eba 100644 --- a/Compute/src/V1/SslPolicy/MinTlsVersion.php +++ b/Compute/src/V1/SslPolicy/MinTlsVersion.php @@ -7,7 +7,9 @@ use UnexpectedValueException; /** - * The minimum version of SSL protocol that can be used by the clients to establish a connection with the load balancer. This can be one of TLS_1_0, TLS_1_1, TLS_1_2. + * The minimum version of SSL protocol that can be used by the clients to + * establish a connection with the load balancer. This can be one ofTLS_1_0, TLS_1_1, TLS_1_2,TLS_1_3. When set to TLS_1_3, the profile field + * must be set to RESTRICTED. * * Protobuf type google.cloud.compute.v1.SslPolicy.MinTlsVersion */ @@ -37,12 +39,19 @@ class MinTlsVersion * Generated from protobuf enum TLS_1_2 = 33116736; */ const TLS_1_2 = 33116736; + /** + * TLS 1.3 + * + * Generated from protobuf enum TLS_1_3 = 33116737; + */ + const TLS_1_3 = 33116737; private static $valueToName = [ self::UNDEFINED_MIN_TLS_VERSION => 'UNDEFINED_MIN_TLS_VERSION', self::TLS_1_0 => 'TLS_1_0', self::TLS_1_1 => 'TLS_1_1', self::TLS_1_2 => 'TLS_1_2', + self::TLS_1_3 => 'TLS_1_3', ]; public static function name($value) diff --git a/Compute/src/V1/SslPolicy/Profile.php b/Compute/src/V1/SslPolicy/Profile.php index f08bcaeca94c..96aec67db0ff 100644 --- a/Compute/src/V1/SslPolicy/Profile.php +++ b/Compute/src/V1/SslPolicy/Profile.php @@ -7,7 +7,9 @@ use UnexpectedValueException; /** - * Profile specifies the set of SSL features that can be used by the load balancer when negotiating SSL with clients. This can be one of COMPATIBLE, MODERN, RESTRICTED, or CUSTOM. If using CUSTOM, the set of SSL features to enable must be specified in the customFeatures field. + * Profile specifies the set of SSL features that can be used by the load + * balancer when negotiating SSL with clients. This can be one ofCOMPATIBLE, MODERN, RESTRICTED, orCUSTOM. If using CUSTOM, the set of SSL features + * to enable must be specified in the customFeatures field. * * Protobuf type google.cloud.compute.v1.SslPolicy.Profile */ @@ -20,25 +22,37 @@ class Profile */ const UNDEFINED_PROFILE = 0; /** - * Compatible profile. Allows the broadset set of clients, even those which support only out-of-date SSL features to negotiate with the load balancer. + * Compatible profile. Allows the broadset set of clients, even those which + * support only out-of-date SSL features to negotiate with the load + * balancer. * * Generated from protobuf enum COMPATIBLE = 179357396; */ const COMPATIBLE = 179357396; /** - * Custom profile. Allow only the set of allowed SSL features specified in the customFeatures field. + * Custom profile. Allow only the set of allowed SSL features specified in + * the customFeatures field. * * Generated from protobuf enum CUSTOM = 388595569; */ const CUSTOM = 388595569; /** - * Modern profile. Supports a wide set of SSL features, allowing modern clients to negotiate SSL with the load balancer. + * FIPS compatible profile. Supports a reduced set of SSL features, + * intended to meet FIPS 140-3 compliance requirements. + * + * Generated from protobuf enum FIPS_202205 = 475828188; + */ + const FIPS_202205 = 475828188; + /** + * Modern profile. Supports a wide set of SSL features, allowing modern + * clients to negotiate SSL with the load balancer. * * Generated from protobuf enum MODERN = 132013855; */ const MODERN = 132013855; /** - * Restricted profile. Supports a reduced set of SSL features, intended to meet stricter compliance requirements. + * Restricted profile. Supports a reduced set of SSL features, intended to + * meet stricter compliance requirements. * * Generated from protobuf enum RESTRICTED = 261551195; */ @@ -48,6 +62,7 @@ class Profile self::UNDEFINED_PROFILE => 'UNDEFINED_PROFILE', self::COMPATIBLE => 'COMPATIBLE', self::CUSTOM => 'CUSTOM', + self::FIPS_202205 => 'FIPS_202205', self::MODERN => 'MODERN', self::RESTRICTED => 'RESTRICTED', ]; diff --git a/Compute/src/V1/SslPolicyReference.php b/Compute/src/V1/SslPolicyReference.php index 3312493c7aee..8f42c0343ccd 100644 --- a/Compute/src/V1/SslPolicyReference.php +++ b/Compute/src/V1/SslPolicyReference.php @@ -15,7 +15,8 @@ class SslPolicyReference extends \Google\Protobuf\Internal\Message { /** - * URL of the SSL policy resource. Set this to empty string to clear any existing SSL policy associated with the target proxy resource. + * URL of the SSL policy resource. Set this to empty string to clear any + * existing SSL policy associated with the target proxy resource. * * Generated from protobuf field optional string ssl_policy = 295190213; */ @@ -28,7 +29,8 @@ class SslPolicyReference extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $ssl_policy - * URL of the SSL policy resource. Set this to empty string to clear any existing SSL policy associated with the target proxy resource. + * URL of the SSL policy resource. Set this to empty string to clear any + * existing SSL policy associated with the target proxy resource. * } */ public function __construct($data = NULL) { @@ -37,7 +39,8 @@ public function __construct($data = NULL) { } /** - * URL of the SSL policy resource. Set this to empty string to clear any existing SSL policy associated with the target proxy resource. + * URL of the SSL policy resource. Set this to empty string to clear any + * existing SSL policy associated with the target proxy resource. * * Generated from protobuf field optional string ssl_policy = 295190213; * @return string @@ -58,7 +61,8 @@ public function clearSslPolicy() } /** - * URL of the SSL policy resource. Set this to empty string to clear any existing SSL policy associated with the target proxy resource. + * URL of the SSL policy resource. Set this to empty string to clear any + * existing SSL policy associated with the target proxy resource. * * Generated from protobuf field optional string ssl_policy = 295190213; * @param string $var diff --git a/Compute/src/V1/StartAsyncReplicationDiskRequest.php b/Compute/src/V1/StartAsyncReplicationDiskRequest.php index 9d5474042b77..9052d38cad9c 100644 --- a/Compute/src/V1/StartAsyncReplicationDiskRequest.php +++ b/Compute/src/V1/StartAsyncReplicationDiskRequest.php @@ -34,7 +34,17 @@ class StartAsyncReplicationDiskRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -78,7 +88,17 @@ public static function build(string $project, string $zone, string $disk, \Googl * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $zone * The name of the zone for this request. * } @@ -177,7 +197,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -198,7 +228,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/StartAsyncReplicationRegionDiskRequest.php b/Compute/src/V1/StartAsyncReplicationRegionDiskRequest.php index 9b406bf6285e..4b298695b4a0 100644 --- a/Compute/src/V1/StartAsyncReplicationRegionDiskRequest.php +++ b/Compute/src/V1/StartAsyncReplicationRegionDiskRequest.php @@ -40,7 +40,17 @@ class StartAsyncReplicationRegionDiskRequest extends \Google\Protobuf\Internal\M */ protected $region_disks_start_async_replication_request_resource = null; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -80,7 +90,17 @@ public static function build(string $project, string $region, string $disk, \Goo * @type \Google\Cloud\Compute\V1\RegionDisksStartAsyncReplicationRequest $region_disks_start_async_replication_request_resource * The body resource for this request * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -203,7 +223,17 @@ public function setRegionDisksStartAsyncReplicationRequestResource($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -224,7 +254,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/StartInstanceRequest.php b/Compute/src/V1/StartInstanceRequest.php index b22885f08fcb..d43985a98232 100644 --- a/Compute/src/V1/StartInstanceRequest.php +++ b/Compute/src/V1/StartInstanceRequest.php @@ -28,7 +28,17 @@ class StartInstanceRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -68,7 +78,17 @@ public static function build(string $project, string $zone, string $instance): s * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $zone * The name of the zone for this request. * } @@ -131,7 +151,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -152,7 +182,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/StartInstancesInstanceGroupManagerRequest.php b/Compute/src/V1/StartInstancesInstanceGroupManagerRequest.php index b0dd6dd2d23b..8669aeb53680 100644 --- a/Compute/src/V1/StartInstancesInstanceGroupManagerRequest.php +++ b/Compute/src/V1/StartInstancesInstanceGroupManagerRequest.php @@ -34,13 +34,24 @@ class StartInstancesInstanceGroupManagerRequest extends \Google\Protobuf\Interna */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ protected $request_id = null; /** - * The name of the zone where the managed instance group is located. + * The name of thezone where the managed + * instance group is located. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; */ @@ -48,7 +59,8 @@ class StartInstancesInstanceGroupManagerRequest extends \Google\Protobuf\Interna /** * @param string $project Project ID for this request. - * @param string $zone The name of the zone where the managed instance group is located. + * @param string $zone The name of thezone where the managed + * instance group is located. * @param string $instanceGroupManager The name of the managed instance group. * @param \Google\Cloud\Compute\V1\InstanceGroupManagersStartInstancesRequest $instanceGroupManagersStartInstancesRequestResource The body resource for this request * @@ -78,9 +90,20 @@ public static function build(string $project, string $zone, string $instanceGrou * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $zone - * The name of the zone where the managed instance group is located. + * The name of thezone where the managed + * instance group is located. * } */ public function __construct($data = NULL) { @@ -177,7 +200,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -198,7 +231,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var @@ -213,7 +256,8 @@ public function setRequestId($var) } /** - * The name of the zone where the managed instance group is located. + * The name of thezone where the managed + * instance group is located. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; * @return string @@ -224,7 +268,8 @@ public function getZone() } /** - * The name of the zone where the managed instance group is located. + * The name of thezone where the managed + * instance group is located. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; * @param string $var diff --git a/Compute/src/V1/StartInstancesRegionInstanceGroupManagerRequest.php b/Compute/src/V1/StartInstancesRegionInstanceGroupManagerRequest.php index f4e976c0811a..3c8d968e62c1 100644 --- a/Compute/src/V1/StartInstancesRegionInstanceGroupManagerRequest.php +++ b/Compute/src/V1/StartInstancesRegionInstanceGroupManagerRequest.php @@ -40,7 +40,17 @@ class StartInstancesRegionInstanceGroupManagerRequest extends \Google\Protobuf\I */ protected $region_instance_group_managers_start_instances_request_resource = null; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -80,7 +90,17 @@ public static function build(string $project, string $region, string $instanceGr * @type \Google\Cloud\Compute\V1\RegionInstanceGroupManagersStartInstancesRequest $region_instance_group_managers_start_instances_request_resource * The body resource for this request * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -203,7 +223,17 @@ public function setRegionInstanceGroupManagersStartInstancesRequestResource($var } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -224,7 +254,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/StartWithEncryptionKeyInstanceRequest.php b/Compute/src/V1/StartWithEncryptionKeyInstanceRequest.php index 6ae4e42d3ee2..93d79c440a15 100644 --- a/Compute/src/V1/StartWithEncryptionKeyInstanceRequest.php +++ b/Compute/src/V1/StartWithEncryptionKeyInstanceRequest.php @@ -34,7 +34,17 @@ class StartWithEncryptionKeyInstanceRequest extends \Google\Protobuf\Internal\Me */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -78,7 +88,17 @@ public static function build(string $project, string $zone, string $instance, \G * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $zone * The name of the zone for this request. * } @@ -177,7 +197,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -198,7 +228,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/StatefulPolicyPreservedState.php b/Compute/src/V1/StatefulPolicyPreservedState.php index 617903ba0a26..00f2c6527b89 100644 --- a/Compute/src/V1/StatefulPolicyPreservedState.php +++ b/Compute/src/V1/StatefulPolicyPreservedState.php @@ -16,19 +16,25 @@ class StatefulPolicyPreservedState extends \Google\Protobuf\Internal\Message { /** - * Disks created on the instances that will be preserved on instance delete, update, etc. This map is keyed with the device names of the disks. + * Disks created on the instances that will be preserved on instance + * delete, update, etc. This map is keyed with the device names of + * the disks. * * Generated from protobuf field map disks = 95594102; */ private $disks; /** - * External network IPs assigned to the instances that will be preserved on instance delete, update, etc. This map is keyed with the network interface name. + * External network IPs assigned to the instances that will be preserved on + * instance delete, update, etc. This map is keyed with the network + * interface name. * * Generated from protobuf field map external_i_ps = 532687245; */ private $external_i_ps; /** - * Internal network IPs assigned to the instances that will be preserved on instance delete, update, etc. This map is keyed with the network interface name. + * Internal network IPs assigned to the instances that will be preserved on + * instance delete, update, etc. This map is keyed with the network + * interface name. * * Generated from protobuf field map internal_i_ps = 215731675; */ @@ -41,11 +47,17 @@ class StatefulPolicyPreservedState extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type array|\Google\Protobuf\Internal\MapField $disks - * Disks created on the instances that will be preserved on instance delete, update, etc. This map is keyed with the device names of the disks. + * Disks created on the instances that will be preserved on instance + * delete, update, etc. This map is keyed with the device names of + * the disks. * @type array|\Google\Protobuf\Internal\MapField $external_i_ps - * External network IPs assigned to the instances that will be preserved on instance delete, update, etc. This map is keyed with the network interface name. + * External network IPs assigned to the instances that will be preserved on + * instance delete, update, etc. This map is keyed with the network + * interface name. * @type array|\Google\Protobuf\Internal\MapField $internal_i_ps - * Internal network IPs assigned to the instances that will be preserved on instance delete, update, etc. This map is keyed with the network interface name. + * Internal network IPs assigned to the instances that will be preserved on + * instance delete, update, etc. This map is keyed with the network + * interface name. * } */ public function __construct($data = NULL) { @@ -54,7 +66,9 @@ public function __construct($data = NULL) { } /** - * Disks created on the instances that will be preserved on instance delete, update, etc. This map is keyed with the device names of the disks. + * Disks created on the instances that will be preserved on instance + * delete, update, etc. This map is keyed with the device names of + * the disks. * * Generated from protobuf field map disks = 95594102; * @return \Google\Protobuf\Internal\MapField @@ -65,7 +79,9 @@ public function getDisks() } /** - * Disks created on the instances that will be preserved on instance delete, update, etc. This map is keyed with the device names of the disks. + * Disks created on the instances that will be preserved on instance + * delete, update, etc. This map is keyed with the device names of + * the disks. * * Generated from protobuf field map disks = 95594102; * @param array|\Google\Protobuf\Internal\MapField $var @@ -80,7 +96,9 @@ public function setDisks($var) } /** - * External network IPs assigned to the instances that will be preserved on instance delete, update, etc. This map is keyed with the network interface name. + * External network IPs assigned to the instances that will be preserved on + * instance delete, update, etc. This map is keyed with the network + * interface name. * * Generated from protobuf field map external_i_ps = 532687245; * @return \Google\Protobuf\Internal\MapField @@ -91,7 +109,9 @@ public function getExternalIPs() } /** - * External network IPs assigned to the instances that will be preserved on instance delete, update, etc. This map is keyed with the network interface name. + * External network IPs assigned to the instances that will be preserved on + * instance delete, update, etc. This map is keyed with the network + * interface name. * * Generated from protobuf field map external_i_ps = 532687245; * @param array|\Google\Protobuf\Internal\MapField $var @@ -106,7 +126,9 @@ public function setExternalIPs($var) } /** - * Internal network IPs assigned to the instances that will be preserved on instance delete, update, etc. This map is keyed with the network interface name. + * Internal network IPs assigned to the instances that will be preserved on + * instance delete, update, etc. This map is keyed with the network + * interface name. * * Generated from protobuf field map internal_i_ps = 215731675; * @return \Google\Protobuf\Internal\MapField @@ -117,7 +139,9 @@ public function getInternalIPs() } /** - * Internal network IPs assigned to the instances that will be preserved on instance delete, update, etc. This map is keyed with the network interface name. + * Internal network IPs assigned to the instances that will be preserved on + * instance delete, update, etc. This map is keyed with the network + * interface name. * * Generated from protobuf field map internal_i_ps = 215731675; * @param array|\Google\Protobuf\Internal\MapField $var diff --git a/Compute/src/V1/StatefulPolicyPreservedStateDiskDevice.php b/Compute/src/V1/StatefulPolicyPreservedStateDiskDevice.php index 7791c778e904..aa6497d5e60a 100644 --- a/Compute/src/V1/StatefulPolicyPreservedStateDiskDevice.php +++ b/Compute/src/V1/StatefulPolicyPreservedStateDiskDevice.php @@ -15,7 +15,11 @@ class StatefulPolicyPreservedStateDiskDevice extends \Google\Protobuf\Internal\Message { /** - * These stateful disks will never be deleted during autohealing, update or VM instance recreate operations. This flag is used to configure if the disk should be deleted after it is no longer used by the group, e.g. when the given instance or the whole group is deleted. Note: disks attached in READ_ONLY mode cannot be auto-deleted. + * These stateful disks will never be deleted during autohealing, + * update or VM instance recreate operations. + * This flag is used to configure if the disk should be deleted after it + * is no longer used by the group, e.g. when the given instance or + * the whole group is deleted. Note: disks attached inREAD_ONLY mode cannot be auto-deleted. * Check the AutoDelete enum for the list of possible values. * * Generated from protobuf field optional string auto_delete = 464761403; @@ -29,7 +33,11 @@ class StatefulPolicyPreservedStateDiskDevice extends \Google\Protobuf\Internal\M * Optional. Data for populating the Message object. * * @type string $auto_delete - * These stateful disks will never be deleted during autohealing, update or VM instance recreate operations. This flag is used to configure if the disk should be deleted after it is no longer used by the group, e.g. when the given instance or the whole group is deleted. Note: disks attached in READ_ONLY mode cannot be auto-deleted. + * These stateful disks will never be deleted during autohealing, + * update or VM instance recreate operations. + * This flag is used to configure if the disk should be deleted after it + * is no longer used by the group, e.g. when the given instance or + * the whole group is deleted. Note: disks attached inREAD_ONLY mode cannot be auto-deleted. * Check the AutoDelete enum for the list of possible values. * } */ @@ -39,7 +47,11 @@ public function __construct($data = NULL) { } /** - * These stateful disks will never be deleted during autohealing, update or VM instance recreate operations. This flag is used to configure if the disk should be deleted after it is no longer used by the group, e.g. when the given instance or the whole group is deleted. Note: disks attached in READ_ONLY mode cannot be auto-deleted. + * These stateful disks will never be deleted during autohealing, + * update or VM instance recreate operations. + * This flag is used to configure if the disk should be deleted after it + * is no longer used by the group, e.g. when the given instance or + * the whole group is deleted. Note: disks attached inREAD_ONLY mode cannot be auto-deleted. * Check the AutoDelete enum for the list of possible values. * * Generated from protobuf field optional string auto_delete = 464761403; @@ -61,7 +73,11 @@ public function clearAutoDelete() } /** - * These stateful disks will never be deleted during autohealing, update or VM instance recreate operations. This flag is used to configure if the disk should be deleted after it is no longer used by the group, e.g. when the given instance or the whole group is deleted. Note: disks attached in READ_ONLY mode cannot be auto-deleted. + * These stateful disks will never be deleted during autohealing, + * update or VM instance recreate operations. + * This flag is used to configure if the disk should be deleted after it + * is no longer used by the group, e.g. when the given instance or + * the whole group is deleted. Note: disks attached inREAD_ONLY mode cannot be auto-deleted. * Check the AutoDelete enum for the list of possible values. * * Generated from protobuf field optional string auto_delete = 464761403; diff --git a/Compute/src/V1/StatefulPolicyPreservedStateDiskDevice/AutoDelete.php b/Compute/src/V1/StatefulPolicyPreservedStateDiskDevice/AutoDelete.php index 86fbd71dc5ae..04d1e8f03b55 100644 --- a/Compute/src/V1/StatefulPolicyPreservedStateDiskDevice/AutoDelete.php +++ b/Compute/src/V1/StatefulPolicyPreservedStateDiskDevice/AutoDelete.php @@ -7,7 +7,11 @@ use UnexpectedValueException; /** - * These stateful disks will never be deleted during autohealing, update or VM instance recreate operations. This flag is used to configure if the disk should be deleted after it is no longer used by the group, e.g. when the given instance or the whole group is deleted. Note: disks attached in READ_ONLY mode cannot be auto-deleted. + * These stateful disks will never be deleted during autohealing, + * update or VM instance recreate operations. + * This flag is used to configure if the disk should be deleted after it + * is no longer used by the group, e.g. when the given instance or + * the whole group is deleted. Note: disks attached inREAD_ONLY mode cannot be auto-deleted. * * Protobuf type google.cloud.compute.v1.StatefulPolicyPreservedStateDiskDevice.AutoDelete */ diff --git a/Compute/src/V1/StatefulPolicyPreservedStateNetworkIp.php b/Compute/src/V1/StatefulPolicyPreservedStateNetworkIp.php index 851fa3ec6372..ad80f590e994 100644 --- a/Compute/src/V1/StatefulPolicyPreservedStateNetworkIp.php +++ b/Compute/src/V1/StatefulPolicyPreservedStateNetworkIp.php @@ -15,7 +15,11 @@ class StatefulPolicyPreservedStateNetworkIp extends \Google\Protobuf\Internal\Message { /** - * These stateful IPs will never be released during autohealing, update or VM instance recreate operations. This flag is used to configure if the IP reservation should be deleted after it is no longer used by the group, e.g. when the given instance or the whole group is deleted. + * These stateful IPs will never be released during autohealing, + * update or VM instance recreate operations. + * This flag is used to configure if the IP reservation should be deleted + * after it is no longer used by the group, e.g. when the given instance + * or the whole group is deleted. * Check the AutoDelete enum for the list of possible values. * * Generated from protobuf field optional string auto_delete = 464761403; @@ -29,7 +33,11 @@ class StatefulPolicyPreservedStateNetworkIp extends \Google\Protobuf\Internal\Me * Optional. Data for populating the Message object. * * @type string $auto_delete - * These stateful IPs will never be released during autohealing, update or VM instance recreate operations. This flag is used to configure if the IP reservation should be deleted after it is no longer used by the group, e.g. when the given instance or the whole group is deleted. + * These stateful IPs will never be released during autohealing, + * update or VM instance recreate operations. + * This flag is used to configure if the IP reservation should be deleted + * after it is no longer used by the group, e.g. when the given instance + * or the whole group is deleted. * Check the AutoDelete enum for the list of possible values. * } */ @@ -39,7 +47,11 @@ public function __construct($data = NULL) { } /** - * These stateful IPs will never be released during autohealing, update or VM instance recreate operations. This flag is used to configure if the IP reservation should be deleted after it is no longer used by the group, e.g. when the given instance or the whole group is deleted. + * These stateful IPs will never be released during autohealing, + * update or VM instance recreate operations. + * This flag is used to configure if the IP reservation should be deleted + * after it is no longer used by the group, e.g. when the given instance + * or the whole group is deleted. * Check the AutoDelete enum for the list of possible values. * * Generated from protobuf field optional string auto_delete = 464761403; @@ -61,7 +73,11 @@ public function clearAutoDelete() } /** - * These stateful IPs will never be released during autohealing, update or VM instance recreate operations. This flag is used to configure if the IP reservation should be deleted after it is no longer used by the group, e.g. when the given instance or the whole group is deleted. + * These stateful IPs will never be released during autohealing, + * update or VM instance recreate operations. + * This flag is used to configure if the IP reservation should be deleted + * after it is no longer used by the group, e.g. when the given instance + * or the whole group is deleted. * Check the AutoDelete enum for the list of possible values. * * Generated from protobuf field optional string auto_delete = 464761403; diff --git a/Compute/src/V1/StatefulPolicyPreservedStateNetworkIp/AutoDelete.php b/Compute/src/V1/StatefulPolicyPreservedStateNetworkIp/AutoDelete.php index 02fe86cdcadd..d4cd09e89f2f 100644 --- a/Compute/src/V1/StatefulPolicyPreservedStateNetworkIp/AutoDelete.php +++ b/Compute/src/V1/StatefulPolicyPreservedStateNetworkIp/AutoDelete.php @@ -7,7 +7,11 @@ use UnexpectedValueException; /** - * These stateful IPs will never be released during autohealing, update or VM instance recreate operations. This flag is used to configure if the IP reservation should be deleted after it is no longer used by the group, e.g. when the given instance or the whole group is deleted. + * These stateful IPs will never be released during autohealing, + * update or VM instance recreate operations. + * This flag is used to configure if the IP reservation should be deleted + * after it is no longer used by the group, e.g. when the given instance + * or the whole group is deleted. * * Protobuf type google.cloud.compute.v1.StatefulPolicyPreservedStateNetworkIp.AutoDelete */ diff --git a/Compute/src/V1/Status.php b/Compute/src/V1/Status.php index 4bc98f742e57..73d8eb473cf3 100644 --- a/Compute/src/V1/Status.php +++ b/Compute/src/V1/Status.php @@ -9,7 +9,12 @@ use Google\Protobuf\Internal\GPBUtil; /** - * The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). + * The `Status` type defines a logical error model that is suitable for + * different programming environments, including REST APIs and RPC APIs. It is + * used by [gRPC](https://github.com/grpc). Each `Status` message contains + * three pieces of data: error code, error message, and error details. + * You can find out more about this error model and how to work with it in the + * [API Design Guide](https://cloud.google.com/apis/design/errors). * * Generated from protobuf message google.cloud.compute.v1.Status */ @@ -22,13 +27,16 @@ class Status extends \Google\Protobuf\Internal\Message */ protected $code = null; /** - * A list of messages that carry the error details. There is a common set of message types for APIs to use. + * A list of messages that carry the error details. There is a common set of + * message types for APIs to use. * * Generated from protobuf field repeated .google.protobuf.Any details = 483979842; */ private $details; /** - * A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client. + * A developer-facing error message, which should be in English. Any + * user-facing error message should be localized and sent in the + * google.rpc.Status.details field, or localized by the client. * * Generated from protobuf field optional string message = 418054151; */ @@ -43,9 +51,12 @@ class Status extends \Google\Protobuf\Internal\Message * @type int $code * The status code, which should be an enum value of google.rpc.Code. * @type array<\Google\Protobuf\Any>|\Google\Protobuf\Internal\RepeatedField $details - * A list of messages that carry the error details. There is a common set of message types for APIs to use. + * A list of messages that carry the error details. There is a common set of + * message types for APIs to use. * @type string $message - * A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client. + * A developer-facing error message, which should be in English. Any + * user-facing error message should be localized and sent in the + * google.rpc.Status.details field, or localized by the client. * } */ public function __construct($data = NULL) { @@ -90,7 +101,8 @@ public function setCode($var) } /** - * A list of messages that carry the error details. There is a common set of message types for APIs to use. + * A list of messages that carry the error details. There is a common set of + * message types for APIs to use. * * Generated from protobuf field repeated .google.protobuf.Any details = 483979842; * @return \Google\Protobuf\Internal\RepeatedField @@ -101,7 +113,8 @@ public function getDetails() } /** - * A list of messages that carry the error details. There is a common set of message types for APIs to use. + * A list of messages that carry the error details. There is a common set of + * message types for APIs to use. * * Generated from protobuf field repeated .google.protobuf.Any details = 483979842; * @param array<\Google\Protobuf\Any>|\Google\Protobuf\Internal\RepeatedField $var @@ -116,7 +129,9 @@ public function setDetails($var) } /** - * A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client. + * A developer-facing error message, which should be in English. Any + * user-facing error message should be localized and sent in the + * google.rpc.Status.details field, or localized by the client. * * Generated from protobuf field optional string message = 418054151; * @return string @@ -137,7 +152,9 @@ public function clearMessage() } /** - * A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client. + * A developer-facing error message, which should be in English. Any + * user-facing error message should be localized and sent in the + * google.rpc.Status.details field, or localized by the client. * * Generated from protobuf field optional string message = 418054151; * @param string $var diff --git a/Compute/src/V1/StopAsyncReplicationDiskRequest.php b/Compute/src/V1/StopAsyncReplicationDiskRequest.php index 9de8dbd54780..0b9a1dc3f938 100644 --- a/Compute/src/V1/StopAsyncReplicationDiskRequest.php +++ b/Compute/src/V1/StopAsyncReplicationDiskRequest.php @@ -28,7 +28,17 @@ class StopAsyncReplicationDiskRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -68,7 +78,17 @@ public static function build(string $project, string $zone, string $disk): self * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $zone * The name of the zone for this request. * } @@ -131,7 +151,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -152,7 +182,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/StopAsyncReplicationRegionDiskRequest.php b/Compute/src/V1/StopAsyncReplicationRegionDiskRequest.php index 885be041f4ba..427ea81bac48 100644 --- a/Compute/src/V1/StopAsyncReplicationRegionDiskRequest.php +++ b/Compute/src/V1/StopAsyncReplicationRegionDiskRequest.php @@ -34,7 +34,17 @@ class StopAsyncReplicationRegionDiskRequest extends \Google\Protobuf\Internal\Me */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -70,7 +80,17 @@ public static function build(string $project, string $region, string $disk): sel * @type string $region * The name of the region for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -157,7 +177,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -178,7 +208,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/StopGroupAsyncReplicationDiskRequest.php b/Compute/src/V1/StopGroupAsyncReplicationDiskRequest.php index a599dde07380..8874d38bf699 100644 --- a/Compute/src/V1/StopGroupAsyncReplicationDiskRequest.php +++ b/Compute/src/V1/StopGroupAsyncReplicationDiskRequest.php @@ -28,13 +28,24 @@ class StopGroupAsyncReplicationDiskRequest extends \Google\Protobuf\Internal\Mes */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ protected $request_id = null; /** - * The name of the zone for this request. This must be the zone of the primary or secondary disks in the consistency group. + * The name of the zone for this request. This must be the zone of the primary + * or secondary disks in the consistency group. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; */ @@ -42,7 +53,8 @@ class StopGroupAsyncReplicationDiskRequest extends \Google\Protobuf\Internal\Mes /** * @param string $project Project ID for this request. - * @param string $zone The name of the zone for this request. This must be the zone of the primary or secondary disks in the consistency group. + * @param string $zone The name of the zone for this request. This must be the zone of the primary + * or secondary disks in the consistency group. * @param \Google\Cloud\Compute\V1\DisksStopGroupAsyncReplicationResource $disksStopGroupAsyncReplicationResourceResource The body resource for this request * * @return \Google\Cloud\Compute\V1\StopGroupAsyncReplicationDiskRequest @@ -68,9 +80,20 @@ public static function build(string $project, string $zone, \Google\Cloud\Comput * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $zone - * The name of the zone for this request. This must be the zone of the primary or secondary disks in the consistency group. + * The name of the zone for this request. This must be the zone of the primary + * or secondary disks in the consistency group. * } */ public function __construct($data = NULL) { @@ -141,7 +164,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -162,7 +195,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var @@ -177,7 +220,8 @@ public function setRequestId($var) } /** - * The name of the zone for this request. This must be the zone of the primary or secondary disks in the consistency group. + * The name of the zone for this request. This must be the zone of the primary + * or secondary disks in the consistency group. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; * @return string @@ -188,7 +232,8 @@ public function getZone() } /** - * The name of the zone for this request. This must be the zone of the primary or secondary disks in the consistency group. + * The name of the zone for this request. This must be the zone of the primary + * or secondary disks in the consistency group. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; * @param string $var diff --git a/Compute/src/V1/StopGroupAsyncReplicationRegionDiskRequest.php b/Compute/src/V1/StopGroupAsyncReplicationRegionDiskRequest.php index e6d0a8a8eedc..f6937d72dd94 100644 --- a/Compute/src/V1/StopGroupAsyncReplicationRegionDiskRequest.php +++ b/Compute/src/V1/StopGroupAsyncReplicationRegionDiskRequest.php @@ -28,13 +28,24 @@ class StopGroupAsyncReplicationRegionDiskRequest extends \Google\Protobuf\Intern */ protected $project = ''; /** - * The name of the region for this request. This must be the region of the primary or secondary disks in the consistency group. + * The name of the region for this request. This must be the region of the + * primary or secondary disks in the consistency group. * * Generated from protobuf field string region = 138946292 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "region"]; */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -42,7 +53,8 @@ class StopGroupAsyncReplicationRegionDiskRequest extends \Google\Protobuf\Intern /** * @param string $project Project ID for this request. - * @param string $region The name of the region for this request. This must be the region of the primary or secondary disks in the consistency group. + * @param string $region The name of the region for this request. This must be the region of the + * primary or secondary disks in the consistency group. * @param \Google\Cloud\Compute\V1\DisksStopGroupAsyncReplicationResource $disksStopGroupAsyncReplicationResourceResource The body resource for this request * * @return \Google\Cloud\Compute\V1\StopGroupAsyncReplicationRegionDiskRequest @@ -68,9 +80,20 @@ public static function build(string $project, string $region, \Google\Cloud\Comp * @type string $project * Project ID for this request. * @type string $region - * The name of the region for this request. This must be the region of the primary or secondary disks in the consistency group. + * The name of the region for this request. This must be the region of the + * primary or secondary disks in the consistency group. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -141,7 +164,8 @@ public function setProject($var) } /** - * The name of the region for this request. This must be the region of the primary or secondary disks in the consistency group. + * The name of the region for this request. This must be the region of the + * primary or secondary disks in the consistency group. * * Generated from protobuf field string region = 138946292 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "region"]; * @return string @@ -152,7 +176,8 @@ public function getRegion() } /** - * The name of the region for this request. This must be the region of the primary or secondary disks in the consistency group. + * The name of the region for this request. This must be the region of the + * primary or secondary disks in the consistency group. * * Generated from protobuf field string region = 138946292 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "region"]; * @param string $var @@ -167,7 +192,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -188,7 +223,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/StopInstanceRequest.php b/Compute/src/V1/StopInstanceRequest.php index 520999901762..ecd5f769b7f3 100644 --- a/Compute/src/V1/StopInstanceRequest.php +++ b/Compute/src/V1/StopInstanceRequest.php @@ -16,7 +16,9 @@ class StopInstanceRequest extends \Google\Protobuf\Internal\Message { /** - * This property is required if the instance has any attached Local SSD disks. If false, Local SSD data will be preserved when the instance is suspended. If true, the contents of any attached Local SSD disks will be discarded. + * This property is required if the instance has any attached Local SSD disks. + * If false, Local SSD data will be preserved when the instance is suspended. + * If true, the contents of any attached Local SSD disks will be discarded. * * Generated from protobuf field optional bool discard_local_ssd = 319517903; */ @@ -34,7 +36,17 @@ class StopInstanceRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -70,13 +82,25 @@ public static function build(string $project, string $zone, string $instance): s * Optional. Data for populating the Message object. * * @type bool $discard_local_ssd - * This property is required if the instance has any attached Local SSD disks. If false, Local SSD data will be preserved when the instance is suspended. If true, the contents of any attached Local SSD disks will be discarded. + * This property is required if the instance has any attached Local SSD disks. + * If false, Local SSD data will be preserved when the instance is suspended. + * If true, the contents of any attached Local SSD disks will be discarded. * @type string $instance * Name of the instance resource to stop. * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $zone * The name of the zone for this request. * } @@ -87,7 +111,9 @@ public function __construct($data = NULL) { } /** - * This property is required if the instance has any attached Local SSD disks. If false, Local SSD data will be preserved when the instance is suspended. If true, the contents of any attached Local SSD disks will be discarded. + * This property is required if the instance has any attached Local SSD disks. + * If false, Local SSD data will be preserved when the instance is suspended. + * If true, the contents of any attached Local SSD disks will be discarded. * * Generated from protobuf field optional bool discard_local_ssd = 319517903; * @return bool @@ -108,7 +134,9 @@ public function clearDiscardLocalSsd() } /** - * This property is required if the instance has any attached Local SSD disks. If false, Local SSD data will be preserved when the instance is suspended. If true, the contents of any attached Local SSD disks will be discarded. + * This property is required if the instance has any attached Local SSD disks. + * If false, Local SSD data will be preserved when the instance is suspended. + * If true, the contents of any attached Local SSD disks will be discarded. * * Generated from protobuf field optional bool discard_local_ssd = 319517903; * @param bool $var @@ -175,7 +203,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -196,7 +234,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/StopInstancesInstanceGroupManagerRequest.php b/Compute/src/V1/StopInstancesInstanceGroupManagerRequest.php index c9ab7c92dc65..a7b14e009232 100644 --- a/Compute/src/V1/StopInstancesInstanceGroupManagerRequest.php +++ b/Compute/src/V1/StopInstancesInstanceGroupManagerRequest.php @@ -34,13 +34,24 @@ class StopInstancesInstanceGroupManagerRequest extends \Google\Protobuf\Internal */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ protected $request_id = null; /** - * The name of the zone where the managed instance group is located. + * The name of thezone where the managed + * instance group is located. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; */ @@ -48,7 +59,8 @@ class StopInstancesInstanceGroupManagerRequest extends \Google\Protobuf\Internal /** * @param string $project Project ID for this request. - * @param string $zone The name of the zone where the managed instance group is located. + * @param string $zone The name of thezone where the managed + * instance group is located. * @param string $instanceGroupManager The name of the managed instance group. * @param \Google\Cloud\Compute\V1\InstanceGroupManagersStopInstancesRequest $instanceGroupManagersStopInstancesRequestResource The body resource for this request * @@ -78,9 +90,20 @@ public static function build(string $project, string $zone, string $instanceGrou * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $zone - * The name of the zone where the managed instance group is located. + * The name of thezone where the managed + * instance group is located. * } */ public function __construct($data = NULL) { @@ -177,7 +200,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -198,7 +231,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var @@ -213,7 +256,8 @@ public function setRequestId($var) } /** - * The name of the zone where the managed instance group is located. + * The name of thezone where the managed + * instance group is located. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; * @return string @@ -224,7 +268,8 @@ public function getZone() } /** - * The name of the zone where the managed instance group is located. + * The name of thezone where the managed + * instance group is located. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; * @param string $var diff --git a/Compute/src/V1/StopInstancesRegionInstanceGroupManagerRequest.php b/Compute/src/V1/StopInstancesRegionInstanceGroupManagerRequest.php index 00cfa7400886..7536e65225f3 100644 --- a/Compute/src/V1/StopInstancesRegionInstanceGroupManagerRequest.php +++ b/Compute/src/V1/StopInstancesRegionInstanceGroupManagerRequest.php @@ -40,7 +40,17 @@ class StopInstancesRegionInstanceGroupManagerRequest extends \Google\Protobuf\In */ protected $region_instance_group_managers_stop_instances_request_resource = null; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -80,7 +90,17 @@ public static function build(string $project, string $region, string $instanceGr * @type \Google\Cloud\Compute\V1\RegionInstanceGroupManagersStopInstancesRequest $region_instance_group_managers_stop_instances_request_resource * The body resource for this request * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -203,7 +223,17 @@ public function setRegionInstanceGroupManagersStopInstancesRequestResource($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -224,7 +254,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/StoragePool.php b/Compute/src/V1/StoragePool.php index 5a2160bd9d55..b97f2883a824 100644 --- a/Compute/src/V1/StoragePool.php +++ b/Compute/src/V1/StoragePool.php @@ -23,68 +23,90 @@ class StoragePool extends \Google\Protobuf\Internal\Message */ protected $capacity_provisioning_type = null; /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; */ protected $creation_timestamp = null; /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; */ protected $description = null; /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; */ protected $id = null; /** - * [Output Only] Type of the resource. Always compute#storagePool for storage pools. + * [Output Only] Type of the resource. Always compute#storagePool + * for storage pools. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * A fingerprint for the labels being applied to this storage pool, which is essentially a hash of the labels set used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a storage pool. + * A fingerprint for the labels being applied to this storage pool, which is + * essentially a hash of the labels set used for optimistic locking. The + * fingerprint is initially generated by Compute Engine and changes after + * every request to modify or update labels. You must always provide an + * up-to-date fingerprint hash in order to update or change labels, + * otherwise the request will fail with error412 conditionNotMet. + * To see the latest fingerprint, make a get() request to + * retrieve a storage pool. * * Generated from protobuf field optional string label_fingerprint = 178124825; */ protected $label_fingerprint = null; /** - * Labels to apply to this storage pool. These can be later modified by the setLabels method. + * Labels to apply to this storage pool. These can be later modified by + * the setLabels method. * * Generated from protobuf field map labels = 500195327; */ private $labels; /** - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` + * which means the first character must be a lowercase letter, and all + * following characters must be a dash, lowercase letter, or digit, except + * the last character, which cannot be a dash. * * Generated from protobuf field optional string name = 3373707; */ protected $name = null; /** - * Provisioning type of the performance-related parameters of the pool, such as throughput and IOPS. + * Provisioning type of the performance-related parameters of the pool, + * such as throughput and IOPS. * Check the PerformanceProvisioningType enum for the list of possible values. * * Generated from protobuf field optional string performance_provisioning_type = 468553469; */ protected $performance_provisioning_type = null; /** - * Size of the storage pool in GiB. For more information about the size limits, see https://cloud.google.com/compute/docs/disks/storage-pools. + * Size of the storage pool in GiB. For more information about the size + * limits, see https://cloud.google.com/compute/docs/disks/storage-pools. * * Generated from protobuf field optional int64 pool_provisioned_capacity_gb = 478537682; */ protected $pool_provisioned_capacity_gb = null; /** - * Provisioned IOPS of the storage pool. Only relevant if the storage pool type is hyperdisk-balanced. + * Provisioned IOPS of the storage pool. Only relevant if the storage pool + * type is hyperdisk-balanced. * * Generated from protobuf field optional int64 pool_provisioned_iops = 112092311; */ protected $pool_provisioned_iops = null; /** - * Provisioned throughput of the storage pool in MiB/s. Only relevant if the storage pool type is hyperdisk-balanced or hyperdisk-throughput. + * Provisioned throughput of the storage pool in MiB/s. Only relevant if the + * storage pool type is hyperdisk-balanced or hyperdisk-throughput. * * Generated from protobuf field optional int64 pool_provisioned_throughput = 169215640; */ @@ -108,7 +130,12 @@ class StoragePool extends \Google\Protobuf\Internal\Message */ protected $self_link_with_id = null; /** - * [Output Only] The status of storage pool creation. - CREATING: Storage pool is provisioning. storagePool. - FAILED: Storage pool creation failed. - READY: Storage pool is ready for use. - DELETING: Storage pool is deleting. + * [Output Only] The status of storage pool creation. + * - CREATING: Storage pool is provisioning. + * storagePool. + * - FAILED: Storage pool creation failed. + * - READY: Storage pool is ready for use. + * - DELETING: Storage pool is deleting. * Check the State enum for the list of possible values. * * Generated from protobuf field optional string state = 109757585; @@ -127,7 +154,9 @@ class StoragePool extends \Google\Protobuf\Internal\Message */ protected $storage_pool_type = null; /** - * [Output Only] URL of the zone where the storage pool resides. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * [Output Only] URL of the zone where the storage pool resides. + * You must specify this field as part of the HTTP request URL. It is + * not settable as a field in the request body. * * Generated from protobuf field optional string zone = 3744684; */ @@ -143,28 +172,50 @@ class StoragePool extends \Google\Protobuf\Internal\Message * Provisioning type of the byte capacity of the pool. * Check the CapacityProvisioningType enum for the list of possible values. * @type string $creation_timestamp - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * @type string $description - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * @type int|string $id - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * @type string $kind - * [Output Only] Type of the resource. Always compute#storagePool for storage pools. + * [Output Only] Type of the resource. Always compute#storagePool + * for storage pools. * @type string $label_fingerprint - * A fingerprint for the labels being applied to this storage pool, which is essentially a hash of the labels set used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a storage pool. + * A fingerprint for the labels being applied to this storage pool, which is + * essentially a hash of the labels set used for optimistic locking. The + * fingerprint is initially generated by Compute Engine and changes after + * every request to modify or update labels. You must always provide an + * up-to-date fingerprint hash in order to update or change labels, + * otherwise the request will fail with error412 conditionNotMet. + * To see the latest fingerprint, make a get() request to + * retrieve a storage pool. * @type array|\Google\Protobuf\Internal\MapField $labels - * Labels to apply to this storage pool. These can be later modified by the setLabels method. + * Labels to apply to this storage pool. These can be later modified by + * the setLabels method. * @type string $name - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` + * which means the first character must be a lowercase letter, and all + * following characters must be a dash, lowercase letter, or digit, except + * the last character, which cannot be a dash. * @type string $performance_provisioning_type - * Provisioning type of the performance-related parameters of the pool, such as throughput and IOPS. + * Provisioning type of the performance-related parameters of the pool, + * such as throughput and IOPS. * Check the PerformanceProvisioningType enum for the list of possible values. * @type int|string $pool_provisioned_capacity_gb - * Size of the storage pool in GiB. For more information about the size limits, see https://cloud.google.com/compute/docs/disks/storage-pools. + * Size of the storage pool in GiB. For more information about the size + * limits, see https://cloud.google.com/compute/docs/disks/storage-pools. * @type int|string $pool_provisioned_iops - * Provisioned IOPS of the storage pool. Only relevant if the storage pool type is hyperdisk-balanced. + * Provisioned IOPS of the storage pool. Only relevant if the storage pool + * type is hyperdisk-balanced. * @type int|string $pool_provisioned_throughput - * Provisioned throughput of the storage pool in MiB/s. Only relevant if the storage pool type is hyperdisk-balanced or hyperdisk-throughput. + * Provisioned throughput of the storage pool in MiB/s. Only relevant if the + * storage pool type is hyperdisk-balanced or hyperdisk-throughput. * @type \Google\Cloud\Compute\V1\StoragePoolResourceStatus $resource_status * [Output Only] Status information for the storage pool resource. * @type string $self_link @@ -172,14 +223,21 @@ class StoragePool extends \Google\Protobuf\Internal\Message * @type string $self_link_with_id * [Output Only] Server-defined URL for this resource's resource id. * @type string $state - * [Output Only] The status of storage pool creation. - CREATING: Storage pool is provisioning. storagePool. - FAILED: Storage pool creation failed. - READY: Storage pool is ready for use. - DELETING: Storage pool is deleting. + * [Output Only] The status of storage pool creation. + * - CREATING: Storage pool is provisioning. + * storagePool. + * - FAILED: Storage pool creation failed. + * - READY: Storage pool is ready for use. + * - DELETING: Storage pool is deleting. * Check the State enum for the list of possible values. * @type \Google\Cloud\Compute\V1\StoragePoolResourceStatus $status * [Output Only] Status information for the storage pool resource. * @type string $storage_pool_type * Type of the storage pool. * @type string $zone - * [Output Only] URL of the zone where the storage pool resides. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * [Output Only] URL of the zone where the storage pool resides. + * You must specify this field as part of the HTTP request URL. It is + * not settable as a field in the request body. * } */ public function __construct($data = NULL) { @@ -226,7 +284,8 @@ public function setCapacityProvisioningType($var) } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @return string @@ -247,7 +306,8 @@ public function clearCreationTimestamp() } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @param string $var @@ -262,7 +322,8 @@ public function setCreationTimestamp($var) } /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @return string @@ -283,7 +344,8 @@ public function clearDescription() } /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @param string $var @@ -298,7 +360,8 @@ public function setDescription($var) } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @return int|string @@ -319,7 +382,8 @@ public function clearId() } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @param int|string $var @@ -334,7 +398,8 @@ public function setId($var) } /** - * [Output Only] Type of the resource. Always compute#storagePool for storage pools. + * [Output Only] Type of the resource. Always compute#storagePool + * for storage pools. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -355,7 +420,8 @@ public function clearKind() } /** - * [Output Only] Type of the resource. Always compute#storagePool for storage pools. + * [Output Only] Type of the resource. Always compute#storagePool + * for storage pools. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -370,7 +436,14 @@ public function setKind($var) } /** - * A fingerprint for the labels being applied to this storage pool, which is essentially a hash of the labels set used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a storage pool. + * A fingerprint for the labels being applied to this storage pool, which is + * essentially a hash of the labels set used for optimistic locking. The + * fingerprint is initially generated by Compute Engine and changes after + * every request to modify or update labels. You must always provide an + * up-to-date fingerprint hash in order to update or change labels, + * otherwise the request will fail with error412 conditionNotMet. + * To see the latest fingerprint, make a get() request to + * retrieve a storage pool. * * Generated from protobuf field optional string label_fingerprint = 178124825; * @return string @@ -391,7 +464,14 @@ public function clearLabelFingerprint() } /** - * A fingerprint for the labels being applied to this storage pool, which is essentially a hash of the labels set used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a storage pool. + * A fingerprint for the labels being applied to this storage pool, which is + * essentially a hash of the labels set used for optimistic locking. The + * fingerprint is initially generated by Compute Engine and changes after + * every request to modify or update labels. You must always provide an + * up-to-date fingerprint hash in order to update or change labels, + * otherwise the request will fail with error412 conditionNotMet. + * To see the latest fingerprint, make a get() request to + * retrieve a storage pool. * * Generated from protobuf field optional string label_fingerprint = 178124825; * @param string $var @@ -406,7 +486,8 @@ public function setLabelFingerprint($var) } /** - * Labels to apply to this storage pool. These can be later modified by the setLabels method. + * Labels to apply to this storage pool. These can be later modified by + * the setLabels method. * * Generated from protobuf field map labels = 500195327; * @return \Google\Protobuf\Internal\MapField @@ -417,7 +498,8 @@ public function getLabels() } /** - * Labels to apply to this storage pool. These can be later modified by the setLabels method. + * Labels to apply to this storage pool. These can be later modified by + * the setLabels method. * * Generated from protobuf field map labels = 500195327; * @param array|\Google\Protobuf\Internal\MapField $var @@ -432,7 +514,13 @@ public function setLabels($var) } /** - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` + * which means the first character must be a lowercase letter, and all + * following characters must be a dash, lowercase letter, or digit, except + * the last character, which cannot be a dash. * * Generated from protobuf field optional string name = 3373707; * @return string @@ -453,7 +541,13 @@ public function clearName() } /** - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` + * which means the first character must be a lowercase letter, and all + * following characters must be a dash, lowercase letter, or digit, except + * the last character, which cannot be a dash. * * Generated from protobuf field optional string name = 3373707; * @param string $var @@ -468,7 +562,8 @@ public function setName($var) } /** - * Provisioning type of the performance-related parameters of the pool, such as throughput and IOPS. + * Provisioning type of the performance-related parameters of the pool, + * such as throughput and IOPS. * Check the PerformanceProvisioningType enum for the list of possible values. * * Generated from protobuf field optional string performance_provisioning_type = 468553469; @@ -490,7 +585,8 @@ public function clearPerformanceProvisioningType() } /** - * Provisioning type of the performance-related parameters of the pool, such as throughput and IOPS. + * Provisioning type of the performance-related parameters of the pool, + * such as throughput and IOPS. * Check the PerformanceProvisioningType enum for the list of possible values. * * Generated from protobuf field optional string performance_provisioning_type = 468553469; @@ -506,7 +602,8 @@ public function setPerformanceProvisioningType($var) } /** - * Size of the storage pool in GiB. For more information about the size limits, see https://cloud.google.com/compute/docs/disks/storage-pools. + * Size of the storage pool in GiB. For more information about the size + * limits, see https://cloud.google.com/compute/docs/disks/storage-pools. * * Generated from protobuf field optional int64 pool_provisioned_capacity_gb = 478537682; * @return int|string @@ -527,7 +624,8 @@ public function clearPoolProvisionedCapacityGb() } /** - * Size of the storage pool in GiB. For more information about the size limits, see https://cloud.google.com/compute/docs/disks/storage-pools. + * Size of the storage pool in GiB. For more information about the size + * limits, see https://cloud.google.com/compute/docs/disks/storage-pools. * * Generated from protobuf field optional int64 pool_provisioned_capacity_gb = 478537682; * @param int|string $var @@ -542,7 +640,8 @@ public function setPoolProvisionedCapacityGb($var) } /** - * Provisioned IOPS of the storage pool. Only relevant if the storage pool type is hyperdisk-balanced. + * Provisioned IOPS of the storage pool. Only relevant if the storage pool + * type is hyperdisk-balanced. * * Generated from protobuf field optional int64 pool_provisioned_iops = 112092311; * @return int|string @@ -563,7 +662,8 @@ public function clearPoolProvisionedIops() } /** - * Provisioned IOPS of the storage pool. Only relevant if the storage pool type is hyperdisk-balanced. + * Provisioned IOPS of the storage pool. Only relevant if the storage pool + * type is hyperdisk-balanced. * * Generated from protobuf field optional int64 pool_provisioned_iops = 112092311; * @param int|string $var @@ -578,7 +678,8 @@ public function setPoolProvisionedIops($var) } /** - * Provisioned throughput of the storage pool in MiB/s. Only relevant if the storage pool type is hyperdisk-balanced or hyperdisk-throughput. + * Provisioned throughput of the storage pool in MiB/s. Only relevant if the + * storage pool type is hyperdisk-balanced or hyperdisk-throughput. * * Generated from protobuf field optional int64 pool_provisioned_throughput = 169215640; * @return int|string @@ -599,7 +700,8 @@ public function clearPoolProvisionedThroughput() } /** - * Provisioned throughput of the storage pool in MiB/s. Only relevant if the storage pool type is hyperdisk-balanced or hyperdisk-throughput. + * Provisioned throughput of the storage pool in MiB/s. Only relevant if the + * storage pool type is hyperdisk-balanced or hyperdisk-throughput. * * Generated from protobuf field optional int64 pool_provisioned_throughput = 169215640; * @param int|string $var @@ -722,7 +824,12 @@ public function setSelfLinkWithId($var) } /** - * [Output Only] The status of storage pool creation. - CREATING: Storage pool is provisioning. storagePool. - FAILED: Storage pool creation failed. - READY: Storage pool is ready for use. - DELETING: Storage pool is deleting. + * [Output Only] The status of storage pool creation. + * - CREATING: Storage pool is provisioning. + * storagePool. + * - FAILED: Storage pool creation failed. + * - READY: Storage pool is ready for use. + * - DELETING: Storage pool is deleting. * Check the State enum for the list of possible values. * * Generated from protobuf field optional string state = 109757585; @@ -744,7 +851,12 @@ public function clearState() } /** - * [Output Only] The status of storage pool creation. - CREATING: Storage pool is provisioning. storagePool. - FAILED: Storage pool creation failed. - READY: Storage pool is ready for use. - DELETING: Storage pool is deleting. + * [Output Only] The status of storage pool creation. + * - CREATING: Storage pool is provisioning. + * storagePool. + * - FAILED: Storage pool creation failed. + * - READY: Storage pool is ready for use. + * - DELETING: Storage pool is deleting. * Check the State enum for the list of possible values. * * Generated from protobuf field optional string state = 109757585; @@ -832,7 +944,9 @@ public function setStoragePoolType($var) } /** - * [Output Only] URL of the zone where the storage pool resides. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * [Output Only] URL of the zone where the storage pool resides. + * You must specify this field as part of the HTTP request URL. It is + * not settable as a field in the request body. * * Generated from protobuf field optional string zone = 3744684; * @return string @@ -853,7 +967,9 @@ public function clearZone() } /** - * [Output Only] URL of the zone where the storage pool resides. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * [Output Only] URL of the zone where the storage pool resides. + * You must specify this field as part of the HTTP request URL. It is + * not settable as a field in the request body. * * Generated from protobuf field optional string zone = 3744684; * @param string $var diff --git a/Compute/src/V1/StoragePool/PerformanceProvisioningType.php b/Compute/src/V1/StoragePool/PerformanceProvisioningType.php index 25d184734752..863833d93704 100644 --- a/Compute/src/V1/StoragePool/PerformanceProvisioningType.php +++ b/Compute/src/V1/StoragePool/PerformanceProvisioningType.php @@ -7,7 +7,8 @@ use UnexpectedValueException; /** - * Provisioning type of the performance-related parameters of the pool, such as throughput and IOPS. + * Provisioning type of the performance-related parameters of the pool, + * such as throughput and IOPS. * Additional supported values which may be not listed in the enum directly due to technical reasons: * ADVANCED * STANDARD diff --git a/Compute/src/V1/StoragePool/State.php b/Compute/src/V1/StoragePool/State.php index 50971ff2163c..0a0af2016aad 100644 --- a/Compute/src/V1/StoragePool/State.php +++ b/Compute/src/V1/StoragePool/State.php @@ -7,7 +7,12 @@ use UnexpectedValueException; /** - * [Output Only] The status of storage pool creation. - CREATING: Storage pool is provisioning. storagePool. - FAILED: Storage pool creation failed. - READY: Storage pool is ready for use. - DELETING: Storage pool is deleting. + * [Output Only] The status of storage pool creation. + * - CREATING: Storage pool is provisioning. + * storagePool. + * - FAILED: Storage pool creation failed. + * - READY: Storage pool is ready for use. + * - DELETING: Storage pool is deleting. * * Protobuf type google.cloud.compute.v1.StoragePool.State */ diff --git a/Compute/src/V1/StoragePoolAggregatedList.php b/Compute/src/V1/StoragePoolAggregatedList.php index 809b1d444a26..d83183a4558a 100644 --- a/Compute/src/V1/StoragePoolAggregatedList.php +++ b/Compute/src/V1/StoragePoolAggregatedList.php @@ -31,13 +31,18 @@ class StoragePoolAggregatedList extends \Google\Protobuf\Internal\Message */ private $items; /** - * [Output Only] Type of resource. Always compute#storagePoolAggregatedList for aggregated lists of storage pools. + * [Output Only] Type of resource. Alwayscompute#storagePoolAggregatedList for aggregated lists of + * storage pools. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -73,9 +78,14 @@ class StoragePoolAggregatedList extends \Google\Protobuf\Internal\Message * @type array|\Google\Protobuf\Internal\MapField $items * A list of StoragePoolsScopedList resources. * @type string $kind - * [Output Only] Type of resource. Always compute#storagePoolAggregatedList for aggregated lists of storage pools. + * [Output Only] Type of resource. Alwayscompute#storagePoolAggregatedList for aggregated lists of + * storage pools. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type array|\Google\Protobuf\Internal\RepeatedField $unreachables @@ -184,7 +194,8 @@ public function setItems($var) } /** - * [Output Only] Type of resource. Always compute#storagePoolAggregatedList for aggregated lists of storage pools. + * [Output Only] Type of resource. Alwayscompute#storagePoolAggregatedList for aggregated lists of + * storage pools. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -205,7 +216,8 @@ public function clearKind() } /** - * [Output Only] Type of resource. Always compute#storagePoolAggregatedList for aggregated lists of storage pools. + * [Output Only] Type of resource. Alwayscompute#storagePoolAggregatedList for aggregated lists of + * storage pools. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -220,7 +232,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -241,7 +257,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/StoragePoolDisk.php b/Compute/src/V1/StoragePoolDisk.php index ec2ee31ed8d9..7f943a8a1de4 100644 --- a/Compute/src/V1/StoragePoolDisk.php +++ b/Compute/src/V1/StoragePoolDisk.php @@ -21,7 +21,8 @@ class StoragePoolDisk extends \Google\Protobuf\Internal\Message */ private $attached_instances; /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; */ @@ -51,7 +52,8 @@ class StoragePoolDisk extends \Google\Protobuf\Internal\Message */ protected $provisioned_throughput = null; /** - * [Output Only] Resource policies applied to disk for automatic snapshot creations. + * [Output Only] Resource policies applied to disk for automatic snapshot + * creations. * * Generated from protobuf field repeated string resource_policies = 22220385; */ @@ -91,7 +93,8 @@ class StoragePoolDisk extends \Google\Protobuf\Internal\Message * @type array|\Google\Protobuf\Internal\RepeatedField $attached_instances * [Output Only] Instances this disk is attached to. * @type string $creation_timestamp - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * @type string $disk * [Output Only] The URL of the disk. * @type string $name @@ -101,7 +104,8 @@ class StoragePoolDisk extends \Google\Protobuf\Internal\Message * @type int|string $provisioned_throughput * [Output Only] The throughput provisioned for the disk. * @type array|\Google\Protobuf\Internal\RepeatedField $resource_policies - * [Output Only] Resource policies applied to disk for automatic snapshot creations. + * [Output Only] Resource policies applied to disk for automatic snapshot + * creations. * @type int|string $size_gb * [Output Only] The disk size, in GB. * @type string $status @@ -145,7 +149,8 @@ public function setAttachedInstances($var) } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @return string @@ -166,7 +171,8 @@ public function clearCreationTimestamp() } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @param string $var @@ -325,7 +331,8 @@ public function setProvisionedThroughput($var) } /** - * [Output Only] Resource policies applied to disk for automatic snapshot creations. + * [Output Only] Resource policies applied to disk for automatic snapshot + * creations. * * Generated from protobuf field repeated string resource_policies = 22220385; * @return \Google\Protobuf\Internal\RepeatedField @@ -336,7 +343,8 @@ public function getResourcePolicies() } /** - * [Output Only] Resource policies applied to disk for automatic snapshot creations. + * [Output Only] Resource policies applied to disk for automatic snapshot + * creations. * * Generated from protobuf field repeated string resource_policies = 22220385; * @param array|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/StoragePoolDisk/Status.php b/Compute/src/V1/StoragePoolDisk/Status.php index 01444db41896..08ee94f60fd9 100644 --- a/Compute/src/V1/StoragePoolDisk/Status.php +++ b/Compute/src/V1/StoragePoolDisk/Status.php @@ -50,7 +50,8 @@ class Status */ const RESTORING = 404263851; /** - * Disk is currently unavailable and cannot be accessed, attached or detached. + * Disk is currently unavailable and cannot be accessed, attached or + * detached. * * Generated from protobuf enum UNAVAILABLE = 413756464; */ diff --git a/Compute/src/V1/StoragePoolList.php b/Compute/src/V1/StoragePoolList.php index 3d5a8e7d88e6..b681428f64e0 100644 --- a/Compute/src/V1/StoragePoolList.php +++ b/Compute/src/V1/StoragePoolList.php @@ -32,13 +32,18 @@ class StoragePoolList extends \Google\Protobuf\Internal\Message */ private $items; /** - * [Output Only] Type of resource. Always compute#storagePoolList for lists of storagePools. + * [Output Only] Type of resource. Always compute#storagePoolList + * for lists of storagePools. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -50,7 +55,8 @@ class StoragePoolList extends \Google\Protobuf\Internal\Message */ protected $self_link = null; /** - * [Output Only] Unreachable resources. end_interface: MixerListResponseWithEtagBuilder + * [Output Only] Unreachable resources. + * end_interface: MixerListResponseWithEtagBuilder * * Generated from protobuf field repeated string unreachables = 243372063; */ @@ -74,13 +80,19 @@ class StoragePoolList extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\StoragePool>|\Google\Protobuf\Internal\RepeatedField $items * A list of StoragePool resources. * @type string $kind - * [Output Only] Type of resource. Always compute#storagePoolList for lists of storagePools. + * [Output Only] Type of resource. Always compute#storagePoolList + * for lists of storagePools. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type array|\Google\Protobuf\Internal\RepeatedField $unreachables - * [Output Only] Unreachable resources. end_interface: MixerListResponseWithEtagBuilder + * [Output Only] Unreachable resources. + * end_interface: MixerListResponseWithEtagBuilder * @type \Google\Cloud\Compute\V1\Warning $warning * [Output Only] Informational warning message. * } @@ -185,7 +197,8 @@ public function setItems($var) } /** - * [Output Only] Type of resource. Always compute#storagePoolList for lists of storagePools. + * [Output Only] Type of resource. Always compute#storagePoolList + * for lists of storagePools. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -206,7 +219,8 @@ public function clearKind() } /** - * [Output Only] Type of resource. Always compute#storagePoolList for lists of storagePools. + * [Output Only] Type of resource. Always compute#storagePoolList + * for lists of storagePools. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -221,7 +235,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -242,7 +260,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var @@ -293,7 +315,8 @@ public function setSelfLink($var) } /** - * [Output Only] Unreachable resources. end_interface: MixerListResponseWithEtagBuilder + * [Output Only] Unreachable resources. + * end_interface: MixerListResponseWithEtagBuilder * * Generated from protobuf field repeated string unreachables = 243372063; * @return \Google\Protobuf\Internal\RepeatedField @@ -304,7 +327,8 @@ public function getUnreachables() } /** - * [Output Only] Unreachable resources. end_interface: MixerListResponseWithEtagBuilder + * [Output Only] Unreachable resources. + * end_interface: MixerListResponseWithEtagBuilder * * Generated from protobuf field repeated string unreachables = 243372063; * @param array|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/StoragePoolListDisks.php b/Compute/src/V1/StoragePoolListDisks.php index f27cea9e514e..2c74554d5c42 100644 --- a/Compute/src/V1/StoragePoolListDisks.php +++ b/Compute/src/V1/StoragePoolListDisks.php @@ -31,13 +31,18 @@ class StoragePoolListDisks extends \Google\Protobuf\Internal\Message */ private $items; /** - * [Output Only] Type of resource. Always compute#storagePoolListDisks for lists of disks in a storagePool. + * [Output Only] Type of resource. Alwayscompute#storagePoolListDisks for lists of disks in a + * storagePool. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -49,7 +54,8 @@ class StoragePoolListDisks extends \Google\Protobuf\Internal\Message */ protected $self_link = null; /** - * [Output Only] Unreachable resources. end_interface: MixerListResponseWithEtagBuilder + * [Output Only] Unreachable resources. + * end_interface: MixerListResponseWithEtagBuilder * * Generated from protobuf field repeated string unreachables = 243372063; */ @@ -73,13 +79,19 @@ class StoragePoolListDisks extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\StoragePoolDisk>|\Google\Protobuf\Internal\RepeatedField $items * A list of StoragePoolDisk resources. * @type string $kind - * [Output Only] Type of resource. Always compute#storagePoolListDisks for lists of disks in a storagePool. + * [Output Only] Type of resource. Alwayscompute#storagePoolListDisks for lists of disks in a + * storagePool. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type array|\Google\Protobuf\Internal\RepeatedField $unreachables - * [Output Only] Unreachable resources. end_interface: MixerListResponseWithEtagBuilder + * [Output Only] Unreachable resources. + * end_interface: MixerListResponseWithEtagBuilder * @type \Google\Cloud\Compute\V1\Warning $warning * [Output Only] Informational warning message. * } @@ -184,7 +196,8 @@ public function setItems($var) } /** - * [Output Only] Type of resource. Always compute#storagePoolListDisks for lists of disks in a storagePool. + * [Output Only] Type of resource. Alwayscompute#storagePoolListDisks for lists of disks in a + * storagePool. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -205,7 +218,8 @@ public function clearKind() } /** - * [Output Only] Type of resource. Always compute#storagePoolListDisks for lists of disks in a storagePool. + * [Output Only] Type of resource. Alwayscompute#storagePoolListDisks for lists of disks in a + * storagePool. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -220,7 +234,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -241,7 +259,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var @@ -292,7 +314,8 @@ public function setSelfLink($var) } /** - * [Output Only] Unreachable resources. end_interface: MixerListResponseWithEtagBuilder + * [Output Only] Unreachable resources. + * end_interface: MixerListResponseWithEtagBuilder * * Generated from protobuf field repeated string unreachables = 243372063; * @return \Google\Protobuf\Internal\RepeatedField @@ -303,7 +326,8 @@ public function getUnreachables() } /** - * [Output Only] Unreachable resources. end_interface: MixerListResponseWithEtagBuilder + * [Output Only] Unreachable resources. + * end_interface: MixerListResponseWithEtagBuilder * * Generated from protobuf field repeated string unreachables = 243372063; * @param array|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/StoragePoolResourceStatus.php b/Compute/src/V1/StoragePoolResourceStatus.php index 5b6634a05165..a6df6216ac47 100644 --- a/Compute/src/V1/StoragePoolResourceStatus.php +++ b/Compute/src/V1/StoragePoolResourceStatus.php @@ -22,7 +22,7 @@ class StoragePoolResourceStatus extends \Google\Protobuf\Internal\Message */ protected $disk_count = null; /** - * [Output Only] Timestamp of the last successful resize in RFC3339 text format. + * [Output Only] Timestamp of the last successful resize inRFC3339 text format. * * Generated from protobuf field optional string last_resize_timestamp = 500825556; */ @@ -34,13 +34,18 @@ class StoragePoolResourceStatus extends \Google\Protobuf\Internal\Message */ protected $max_total_provisioned_disk_capacity_gb = null; /** - * [Output Only] Space used by data stored in disks within the storage pool (in bytes). This will reflect the total number of bytes written to the disks in the pool, in contrast to the capacity of those disks. + * [Output Only] Space used by data stored in disks within the storage pool + * (in bytes). This will reflect the total number of bytes written to the + * disks in the pool, in contrast to the capacity of those disks. * * Generated from protobuf field optional int64 pool_used_capacity_bytes = 510407877; */ protected $pool_used_capacity_bytes = null; /** - * [Output Only] Sum of all the disks' provisioned IOPS, minus some amount that is allowed per disk that is not counted towards pool's IOPS capacity. For more information, see https://cloud.google.com/compute/docs/disks/storage-pools. + * [Output Only] Sum of all the disks' provisioned IOPS, minus some amount + * that is allowed per disk that is not counted towards pool's IOPS + * capacity. For more information, see + * https://cloud.google.com/compute/docs/disks/storage-pools. * * Generated from protobuf field optional int64 pool_used_iops = 99558536; */ @@ -52,13 +57,16 @@ class StoragePoolResourceStatus extends \Google\Protobuf\Internal\Message */ protected $pool_used_throughput = null; /** - * [Output Only] Amount of data written into the pool, before it is compacted. + * [Output Only] Amount of data written into the pool, before it is + * compacted. * * Generated from protobuf field optional int64 pool_user_written_bytes = 228964050; */ protected $pool_user_written_bytes = null; /** - * [Output Only] Sum of all the disks' provisioned capacity (in GiB) in this storage pool. A disk's provisioned capacity is the same as its total capacity. + * [Output Only] Sum of all the disks' provisioned capacity (in GiB) in + * this storage pool. A disk's provisioned capacity is the same as its total + * capacity. * * Generated from protobuf field optional int64 total_provisioned_disk_capacity_gb = 520930980; */ @@ -70,7 +78,9 @@ class StoragePoolResourceStatus extends \Google\Protobuf\Internal\Message */ protected $total_provisioned_disk_iops = null; /** - * [Output Only] Sum of all the disks' provisioned throughput in MiB/s, minus some amount that is allowed per disk that is not counted towards pool's throughput capacity. + * [Output Only] Sum of all the disks' provisioned throughput in MiB/s, + * minus some amount that is allowed per disk that is not counted towards + * pool's throughput capacity. * * Generated from protobuf field optional int64 total_provisioned_disk_throughput = 447677830; */ @@ -85,23 +95,33 @@ class StoragePoolResourceStatus extends \Google\Protobuf\Internal\Message * @type int|string $disk_count * [Output Only] Number of disks used. * @type string $last_resize_timestamp - * [Output Only] Timestamp of the last successful resize in RFC3339 text format. + * [Output Only] Timestamp of the last successful resize inRFC3339 text format. * @type int|string $max_total_provisioned_disk_capacity_gb * [Output Only] Maximum allowed aggregate disk size in GiB. * @type int|string $pool_used_capacity_bytes - * [Output Only] Space used by data stored in disks within the storage pool (in bytes). This will reflect the total number of bytes written to the disks in the pool, in contrast to the capacity of those disks. + * [Output Only] Space used by data stored in disks within the storage pool + * (in bytes). This will reflect the total number of bytes written to the + * disks in the pool, in contrast to the capacity of those disks. * @type int|string $pool_used_iops - * [Output Only] Sum of all the disks' provisioned IOPS, minus some amount that is allowed per disk that is not counted towards pool's IOPS capacity. For more information, see https://cloud.google.com/compute/docs/disks/storage-pools. + * [Output Only] Sum of all the disks' provisioned IOPS, minus some amount + * that is allowed per disk that is not counted towards pool's IOPS + * capacity. For more information, see + * https://cloud.google.com/compute/docs/disks/storage-pools. * @type int|string $pool_used_throughput * [Output Only] Sum of all the disks' provisioned throughput in MiB/s. * @type int|string $pool_user_written_bytes - * [Output Only] Amount of data written into the pool, before it is compacted. + * [Output Only] Amount of data written into the pool, before it is + * compacted. * @type int|string $total_provisioned_disk_capacity_gb - * [Output Only] Sum of all the disks' provisioned capacity (in GiB) in this storage pool. A disk's provisioned capacity is the same as its total capacity. + * [Output Only] Sum of all the disks' provisioned capacity (in GiB) in + * this storage pool. A disk's provisioned capacity is the same as its total + * capacity. * @type int|string $total_provisioned_disk_iops * [Output Only] Sum of all the disks' provisioned IOPS. * @type int|string $total_provisioned_disk_throughput - * [Output Only] Sum of all the disks' provisioned throughput in MiB/s, minus some amount that is allowed per disk that is not counted towards pool's throughput capacity. + * [Output Only] Sum of all the disks' provisioned throughput in MiB/s, + * minus some amount that is allowed per disk that is not counted towards + * pool's throughput capacity. * } */ public function __construct($data = NULL) { @@ -146,7 +166,7 @@ public function setDiskCount($var) } /** - * [Output Only] Timestamp of the last successful resize in RFC3339 text format. + * [Output Only] Timestamp of the last successful resize inRFC3339 text format. * * Generated from protobuf field optional string last_resize_timestamp = 500825556; * @return string @@ -167,7 +187,7 @@ public function clearLastResizeTimestamp() } /** - * [Output Only] Timestamp of the last successful resize in RFC3339 text format. + * [Output Only] Timestamp of the last successful resize inRFC3339 text format. * * Generated from protobuf field optional string last_resize_timestamp = 500825556; * @param string $var @@ -218,7 +238,9 @@ public function setMaxTotalProvisionedDiskCapacityGb($var) } /** - * [Output Only] Space used by data stored in disks within the storage pool (in bytes). This will reflect the total number of bytes written to the disks in the pool, in contrast to the capacity of those disks. + * [Output Only] Space used by data stored in disks within the storage pool + * (in bytes). This will reflect the total number of bytes written to the + * disks in the pool, in contrast to the capacity of those disks. * * Generated from protobuf field optional int64 pool_used_capacity_bytes = 510407877; * @return int|string @@ -239,7 +261,9 @@ public function clearPoolUsedCapacityBytes() } /** - * [Output Only] Space used by data stored in disks within the storage pool (in bytes). This will reflect the total number of bytes written to the disks in the pool, in contrast to the capacity of those disks. + * [Output Only] Space used by data stored in disks within the storage pool + * (in bytes). This will reflect the total number of bytes written to the + * disks in the pool, in contrast to the capacity of those disks. * * Generated from protobuf field optional int64 pool_used_capacity_bytes = 510407877; * @param int|string $var @@ -254,7 +278,10 @@ public function setPoolUsedCapacityBytes($var) } /** - * [Output Only] Sum of all the disks' provisioned IOPS, minus some amount that is allowed per disk that is not counted towards pool's IOPS capacity. For more information, see https://cloud.google.com/compute/docs/disks/storage-pools. + * [Output Only] Sum of all the disks' provisioned IOPS, minus some amount + * that is allowed per disk that is not counted towards pool's IOPS + * capacity. For more information, see + * https://cloud.google.com/compute/docs/disks/storage-pools. * * Generated from protobuf field optional int64 pool_used_iops = 99558536; * @return int|string @@ -275,7 +302,10 @@ public function clearPoolUsedIops() } /** - * [Output Only] Sum of all the disks' provisioned IOPS, minus some amount that is allowed per disk that is not counted towards pool's IOPS capacity. For more information, see https://cloud.google.com/compute/docs/disks/storage-pools. + * [Output Only] Sum of all the disks' provisioned IOPS, minus some amount + * that is allowed per disk that is not counted towards pool's IOPS + * capacity. For more information, see + * https://cloud.google.com/compute/docs/disks/storage-pools. * * Generated from protobuf field optional int64 pool_used_iops = 99558536; * @param int|string $var @@ -326,7 +356,8 @@ public function setPoolUsedThroughput($var) } /** - * [Output Only] Amount of data written into the pool, before it is compacted. + * [Output Only] Amount of data written into the pool, before it is + * compacted. * * Generated from protobuf field optional int64 pool_user_written_bytes = 228964050; * @return int|string @@ -347,7 +378,8 @@ public function clearPoolUserWrittenBytes() } /** - * [Output Only] Amount of data written into the pool, before it is compacted. + * [Output Only] Amount of data written into the pool, before it is + * compacted. * * Generated from protobuf field optional int64 pool_user_written_bytes = 228964050; * @param int|string $var @@ -362,7 +394,9 @@ public function setPoolUserWrittenBytes($var) } /** - * [Output Only] Sum of all the disks' provisioned capacity (in GiB) in this storage pool. A disk's provisioned capacity is the same as its total capacity. + * [Output Only] Sum of all the disks' provisioned capacity (in GiB) in + * this storage pool. A disk's provisioned capacity is the same as its total + * capacity. * * Generated from protobuf field optional int64 total_provisioned_disk_capacity_gb = 520930980; * @return int|string @@ -383,7 +417,9 @@ public function clearTotalProvisionedDiskCapacityGb() } /** - * [Output Only] Sum of all the disks' provisioned capacity (in GiB) in this storage pool. A disk's provisioned capacity is the same as its total capacity. + * [Output Only] Sum of all the disks' provisioned capacity (in GiB) in + * this storage pool. A disk's provisioned capacity is the same as its total + * capacity. * * Generated from protobuf field optional int64 total_provisioned_disk_capacity_gb = 520930980; * @param int|string $var @@ -434,7 +470,9 @@ public function setTotalProvisionedDiskIops($var) } /** - * [Output Only] Sum of all the disks' provisioned throughput in MiB/s, minus some amount that is allowed per disk that is not counted towards pool's throughput capacity. + * [Output Only] Sum of all the disks' provisioned throughput in MiB/s, + * minus some amount that is allowed per disk that is not counted towards + * pool's throughput capacity. * * Generated from protobuf field optional int64 total_provisioned_disk_throughput = 447677830; * @return int|string @@ -455,7 +493,9 @@ public function clearTotalProvisionedDiskThroughput() } /** - * [Output Only] Sum of all the disks' provisioned throughput in MiB/s, minus some amount that is allowed per disk that is not counted towards pool's throughput capacity. + * [Output Only] Sum of all the disks' provisioned throughput in MiB/s, + * minus some amount that is allowed per disk that is not counted towards + * pool's throughput capacity. * * Generated from protobuf field optional int64 total_provisioned_disk_throughput = 447677830; * @param int|string $var diff --git a/Compute/src/V1/StoragePoolType.php b/Compute/src/V1/StoragePoolType.php index c79987b4061d..0a91fff97377 100644 --- a/Compute/src/V1/StoragePoolType.php +++ b/Compute/src/V1/StoragePoolType.php @@ -15,13 +15,15 @@ class StoragePoolType extends \Google\Protobuf\Internal\Message { /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; */ protected $creation_timestamp = null; /** - * [Output Only] The deprecation status associated with this storage pool type. + * [Output Only] The deprecation status associated with this storage pool + * type. * * Generated from protobuf field optional .google.cloud.compute.v1.DeprecationStatus deprecated = 515138995; */ @@ -33,13 +35,14 @@ class StoragePoolType extends \Google\Protobuf\Internal\Message */ protected $description = null; /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; */ protected $id = null; /** - * [Output Only] Type of the resource. Always compute#storagePoolType for storage pool types. + * [Output Only] Type of the resource. Alwayscompute#storagePoolType for storage pool types. * * Generated from protobuf field optional string kind = 3292052; */ @@ -81,7 +84,8 @@ class StoragePoolType extends \Google\Protobuf\Internal\Message */ protected $min_pool_provisioned_throughput = null; /** - * [Deprecated] This field is deprecated. Use minPoolProvisionedCapacityGb instead. + * [Deprecated] This field is deprecated. Use minPoolProvisionedCapacityGb + * instead. * * Generated from protobuf field optional int64 min_size_gb = 385278188; */ @@ -111,7 +115,9 @@ class StoragePoolType extends \Google\Protobuf\Internal\Message */ private $supported_disk_types; /** - * [Output Only] URL of the zone where the storage pool type resides. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * [Output Only] URL of the zone where the storage pool type resides. + * You must specify this field as part of the HTTP request URL. It is + * not settable as a field in the request body. * * Generated from protobuf field optional string zone = 3744684; */ @@ -124,15 +130,18 @@ class StoragePoolType extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $creation_timestamp - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * @type \Google\Cloud\Compute\V1\DeprecationStatus $deprecated - * [Output Only] The deprecation status associated with this storage pool type. + * [Output Only] The deprecation status associated with this storage pool + * type. * @type string $description * [Output Only] An optional description of this resource. * @type int|string $id - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * @type string $kind - * [Output Only] Type of the resource. Always compute#storagePoolType for storage pool types. + * [Output Only] Type of the resource. Alwayscompute#storagePoolType for storage pool types. * @type int|string $max_pool_provisioned_capacity_gb * [Output Only] Maximum storage pool size in GB. * @type int|string $max_pool_provisioned_iops @@ -146,7 +155,8 @@ class StoragePoolType extends \Google\Protobuf\Internal\Message * @type int|string $min_pool_provisioned_throughput * [Output Only] Minimum provisioned throughput. * @type int|string $min_size_gb - * [Deprecated] This field is deprecated. Use minPoolProvisionedCapacityGb instead. + * [Deprecated] This field is deprecated. Use minPoolProvisionedCapacityGb + * instead. * @type string $name * [Output Only] Name of the resource. * @type string $self_link @@ -156,7 +166,9 @@ class StoragePoolType extends \Google\Protobuf\Internal\Message * @type array|\Google\Protobuf\Internal\RepeatedField $supported_disk_types * [Output Only] The list of disk types supported in this storage pool type. * @type string $zone - * [Output Only] URL of the zone where the storage pool type resides. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * [Output Only] URL of the zone where the storage pool type resides. + * You must specify this field as part of the HTTP request URL. It is + * not settable as a field in the request body. * } */ public function __construct($data = NULL) { @@ -165,7 +177,8 @@ public function __construct($data = NULL) { } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @return string @@ -186,7 +199,8 @@ public function clearCreationTimestamp() } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @param string $var @@ -201,7 +215,8 @@ public function setCreationTimestamp($var) } /** - * [Output Only] The deprecation status associated with this storage pool type. + * [Output Only] The deprecation status associated with this storage pool + * type. * * Generated from protobuf field optional .google.cloud.compute.v1.DeprecationStatus deprecated = 515138995; * @return \Google\Cloud\Compute\V1\DeprecationStatus|null @@ -222,7 +237,8 @@ public function clearDeprecated() } /** - * [Output Only] The deprecation status associated with this storage pool type. + * [Output Only] The deprecation status associated with this storage pool + * type. * * Generated from protobuf field optional .google.cloud.compute.v1.DeprecationStatus deprecated = 515138995; * @param \Google\Cloud\Compute\V1\DeprecationStatus $var @@ -273,7 +289,8 @@ public function setDescription($var) } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @return int|string @@ -294,7 +311,8 @@ public function clearId() } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @param int|string $var @@ -309,7 +327,7 @@ public function setId($var) } /** - * [Output Only] Type of the resource. Always compute#storagePoolType for storage pool types. + * [Output Only] Type of the resource. Alwayscompute#storagePoolType for storage pool types. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -330,7 +348,7 @@ public function clearKind() } /** - * [Output Only] Type of the resource. Always compute#storagePoolType for storage pool types. + * [Output Only] Type of the resource. Alwayscompute#storagePoolType for storage pool types. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -561,7 +579,8 @@ public function setMinPoolProvisionedThroughput($var) } /** - * [Deprecated] This field is deprecated. Use minPoolProvisionedCapacityGb instead. + * [Deprecated] This field is deprecated. Use minPoolProvisionedCapacityGb + * instead. * * Generated from protobuf field optional int64 min_size_gb = 385278188; * @return int|string @@ -582,7 +601,8 @@ public function clearMinSizeGb() } /** - * [Deprecated] This field is deprecated. Use minPoolProvisionedCapacityGb instead. + * [Deprecated] This field is deprecated. Use minPoolProvisionedCapacityGb + * instead. * * Generated from protobuf field optional int64 min_size_gb = 385278188; * @param int|string $var @@ -731,7 +751,9 @@ public function setSupportedDiskTypes($var) } /** - * [Output Only] URL of the zone where the storage pool type resides. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * [Output Only] URL of the zone where the storage pool type resides. + * You must specify this field as part of the HTTP request URL. It is + * not settable as a field in the request body. * * Generated from protobuf field optional string zone = 3744684; * @return string @@ -752,7 +774,9 @@ public function clearZone() } /** - * [Output Only] URL of the zone where the storage pool type resides. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * [Output Only] URL of the zone where the storage pool type resides. + * You must specify this field as part of the HTTP request URL. It is + * not settable as a field in the request body. * * Generated from protobuf field optional string zone = 3744684; * @param string $var diff --git a/Compute/src/V1/StoragePoolTypeAggregatedList.php b/Compute/src/V1/StoragePoolTypeAggregatedList.php index 9fef345fae78..73361fc76872 100644 --- a/Compute/src/V1/StoragePoolTypeAggregatedList.php +++ b/Compute/src/V1/StoragePoolTypeAggregatedList.php @@ -27,13 +27,17 @@ class StoragePoolTypeAggregatedList extends \Google\Protobuf\Internal\Message */ private $items; /** - * [Output Only] Type of resource. Always compute#storagePoolTypeAggregatedList . + * [Output Only] Type of resource. Alwayscompute#storagePoolTypeAggregatedList. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -62,9 +66,13 @@ class StoragePoolTypeAggregatedList extends \Google\Protobuf\Internal\Message * @type array|\Google\Protobuf\Internal\MapField $items * A list of StoragePoolTypesScopedList resources. * @type string $kind - * [Output Only] Type of resource. Always compute#storagePoolTypeAggregatedList . + * [Output Only] Type of resource. Alwayscompute#storagePoolTypeAggregatedList. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type \Google\Cloud\Compute\V1\Warning $warning @@ -139,7 +147,7 @@ public function setItems($var) } /** - * [Output Only] Type of resource. Always compute#storagePoolTypeAggregatedList . + * [Output Only] Type of resource. Alwayscompute#storagePoolTypeAggregatedList. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -160,7 +168,7 @@ public function clearKind() } /** - * [Output Only] Type of resource. Always compute#storagePoolTypeAggregatedList . + * [Output Only] Type of resource. Alwayscompute#storagePoolTypeAggregatedList. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -175,7 +183,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -196,7 +208,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/StoragePoolTypeList.php b/Compute/src/V1/StoragePoolTypeList.php index 1cae80c73832..274fa180de7c 100644 --- a/Compute/src/V1/StoragePoolTypeList.php +++ b/Compute/src/V1/StoragePoolTypeList.php @@ -28,13 +28,17 @@ class StoragePoolTypeList extends \Google\Protobuf\Internal\Message */ private $items; /** - * [Output Only] Type of resource. Always compute#storagePoolTypeList for storage pool types. + * [Output Only] Type of resource. Alwayscompute#storagePoolTypeList for storage pool types. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -63,9 +67,13 @@ class StoragePoolTypeList extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\StoragePoolType>|\Google\Protobuf\Internal\RepeatedField $items * A list of StoragePoolType resources. * @type string $kind - * [Output Only] Type of resource. Always compute#storagePoolTypeList for storage pool types. + * [Output Only] Type of resource. Alwayscompute#storagePoolTypeList for storage pool types. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type \Google\Cloud\Compute\V1\Warning $warning @@ -140,7 +148,7 @@ public function setItems($var) } /** - * [Output Only] Type of resource. Always compute#storagePoolTypeList for storage pool types. + * [Output Only] Type of resource. Alwayscompute#storagePoolTypeList for storage pool types. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -161,7 +169,7 @@ public function clearKind() } /** - * [Output Only] Type of resource. Always compute#storagePoolTypeList for storage pool types. + * [Output Only] Type of resource. Alwayscompute#storagePoolTypeList for storage pool types. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -176,7 +184,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -197,7 +209,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/StoragePoolTypesScopedList.php b/Compute/src/V1/StoragePoolTypesScopedList.php index a65ddf727660..ff6a344b7787 100644 --- a/Compute/src/V1/StoragePoolTypesScopedList.php +++ b/Compute/src/V1/StoragePoolTypesScopedList.php @@ -21,7 +21,8 @@ class StoragePoolTypesScopedList extends \Google\Protobuf\Internal\Message */ private $storage_pool_types; /** - * [Output Only] Informational warning which replaces the list of storage pool types when the list is empty. + * [Output Only] Informational warning which replaces the list of storage pool + * types when the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; */ @@ -36,7 +37,8 @@ class StoragePoolTypesScopedList extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\StoragePoolType>|\Google\Protobuf\Internal\RepeatedField $storage_pool_types * [Output Only] A list of storage pool types contained in this scope. * @type \Google\Cloud\Compute\V1\Warning $warning - * [Output Only] Informational warning which replaces the list of storage pool types when the list is empty. + * [Output Only] Informational warning which replaces the list of storage pool + * types when the list is empty. * } */ public function __construct($data = NULL) { @@ -71,7 +73,8 @@ public function setStoragePoolTypes($var) } /** - * [Output Only] Informational warning which replaces the list of storage pool types when the list is empty. + * [Output Only] Informational warning which replaces the list of storage pool + * types when the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; * @return \Google\Cloud\Compute\V1\Warning|null @@ -92,7 +95,8 @@ public function clearWarning() } /** - * [Output Only] Informational warning which replaces the list of storage pool types when the list is empty. + * [Output Only] Informational warning which replaces the list of storage pool + * types when the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; * @param \Google\Cloud\Compute\V1\Warning $var diff --git a/Compute/src/V1/StoragePoolsScopedList.php b/Compute/src/V1/StoragePoolsScopedList.php index bbc41603e514..e0a2b15e58aa 100644 --- a/Compute/src/V1/StoragePoolsScopedList.php +++ b/Compute/src/V1/StoragePoolsScopedList.php @@ -21,7 +21,8 @@ class StoragePoolsScopedList extends \Google\Protobuf\Internal\Message */ private $storage_pools; /** - * [Output Only] Informational warning which replaces the list of storage pool when the list is empty. + * [Output Only] Informational warning which replaces the list of storage pool + * when the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; */ @@ -36,7 +37,8 @@ class StoragePoolsScopedList extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\StoragePool>|\Google\Protobuf\Internal\RepeatedField $storage_pools * [Output Only] A list of storage pool contained in this scope. * @type \Google\Cloud\Compute\V1\Warning $warning - * [Output Only] Informational warning which replaces the list of storage pool when the list is empty. + * [Output Only] Informational warning which replaces the list of storage pool + * when the list is empty. * } */ public function __construct($data = NULL) { @@ -71,7 +73,8 @@ public function setStoragePools($var) } /** - * [Output Only] Informational warning which replaces the list of storage pool when the list is empty. + * [Output Only] Informational warning which replaces the list of storage pool + * when the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; * @return \Google\Cloud\Compute\V1\Warning|null @@ -92,7 +95,8 @@ public function clearWarning() } /** - * [Output Only] Informational warning which replaces the list of storage pool when the list is empty. + * [Output Only] Informational warning which replaces the list of storage pool + * when the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; * @param \Google\Cloud\Compute\V1\Warning $var diff --git a/Compute/src/V1/Subnetwork.php b/Compute/src/V1/Subnetwork.php index a8e7446c7f8c..f860328e6849 100644 --- a/Compute/src/V1/Subnetwork.php +++ b/Compute/src/V1/Subnetwork.php @@ -9,74 +9,112 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Represents a Subnetwork resource. A subnetwork (also known as a subnet) is a logical partition of a Virtual Private Cloud network with one primary IP range and zero or more secondary IP ranges. For more information, read Virtual Private Cloud (VPC) Network. + * Represents a Subnetwork resource. + * A subnetwork (also known as a subnet) is a logical partition of a Virtual + * Private Cloud network with one primary IP range and zero or more secondary + * IP ranges. For more information, read + * Virtual Private Cloud (VPC) Network. * * Generated from protobuf message google.cloud.compute.v1.Subnetwork */ class Subnetwork extends \Google\Protobuf\Internal\Message { /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; */ protected $creation_timestamp = null; /** - * An optional description of this resource. Provide this property when you create the resource. This field can be set only at resource creation time. + * An optional description of this resource. Provide this property when you + * create the resource. This field can be set only at resource creation time. * * Generated from protobuf field optional string description = 422937596; */ protected $description = null; /** - * Whether to enable flow logging for this subnetwork. If this field is not explicitly set, it will not appear in get listings. If not set the default behavior is determined by the org policy, if there is no org policy specified, then it will default to disabled. This field isn't supported if the subnet purpose field is set to REGIONAL_MANAGED_PROXY. + * Whether to enable flow logging for this subnetwork. If this field is not + * explicitly set, it will not appear in get listings. If not set + * the default behavior is determined by the org policy, if there is no org + * policy specified, then it will default to disabled. This field isn't + * supported if the subnet purpose field is set toREGIONAL_MANAGED_PROXY. * * Generated from protobuf field optional bool enable_flow_logs = 151544420; */ protected $enable_flow_logs = null; /** - * The external IPv6 address range that is owned by this subnetwork. + * The external IPv6 address range that is owned by this + * subnetwork. * * Generated from protobuf field optional string external_ipv6_prefix = 139299190; */ protected $external_ipv6_prefix = null; /** - * Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking. This field will be ignored when inserting a Subnetwork. An up-to-date fingerprint must be provided in order to update the Subnetwork, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a Subnetwork. + * Fingerprint of this resource. A hash of the contents stored in this object. + * This field is used in optimistic locking. This field will be ignored when + * inserting a Subnetwork. An up-to-date fingerprint must be + * provided in order to update the Subnetwork, otherwise the + * request will fail with error 412 conditionNotMet. + * To see the latest fingerprint, make a get() request to + * retrieve a Subnetwork. * * Generated from protobuf field optional string fingerprint = 234678500; */ protected $fingerprint = null; /** - * [Output Only] The gateway address for default routes to reach destination addresses outside this subnetwork. + * [Output Only] The gateway address for default routes to reach destination + * addresses outside this subnetwork. * * Generated from protobuf field optional string gateway_address = 459867385; */ protected $gateway_address = null; /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; */ protected $id = null; /** - * The internal IPv6 address range that is owned by this subnetwork. + * The internal IPv6 address range that is owned by this + * subnetwork. * * Generated from protobuf field optional string internal_ipv6_prefix = 506270056; */ protected $internal_ipv6_prefix = null; /** - * The range of internal addresses that are owned by this subnetwork. Provide this property when you create the subnetwork. For example, 10.0.0.0/8 or 100.64.0.0/10. Ranges must be unique and non-overlapping within a network. Only IPv4 is supported. This field is set at resource creation time. The range can be any range listed in the Valid ranges list. The range can be expanded after creation using expandIpCidrRange. + * The range of internal addresses that are owned by this subnetwork. + * Provide this property when you create the subnetwork. For example,10.0.0.0/8 or 100.64.0.0/10. Ranges must + * be unique and non-overlapping within a network. Only IPv4 is supported. + * This field is set at resource creation time. The range can be any range + * listed in theValid + * ranges list. The range can be expanded after creation usingexpandIpCidrRange. * * Generated from protobuf field optional string ip_cidr_range = 98117322; */ protected $ip_cidr_range = null; /** - * Reference to the source of IP, like a PublicDelegatedPrefix (PDP) for BYOIP. The PDP must be a sub-PDP in EXTERNAL_IPV6_SUBNETWORK_CREATION mode. Use one of the following formats to specify a sub-PDP when creating a dual stack subnetwork with external access using BYOIP: - Full resource URL, as in https://www.googleapis.com/compute/v1/projects/projectId/regions/region /publicDelegatedPrefixes/sub-pdp-name - Partial URL, as in - projects/projectId/regions/region/publicDelegatedPrefixes/ sub-pdp-name - regions/region/publicDelegatedPrefixes/sub-pdp-name + * Reference to the source of IP, like a PublicDelegatedPrefix + * (PDP) for BYOIP. The PDP must be a sub-PDP in + * EXTERNAL_IPV6_SUBNETWORK_CREATION or INTERNAL_IPV6_SUBNETWORK_CREATION + * mode. + * Use one of the following formats to specify a sub-PDP when creating a dual + * stack or IPv6-only subnetwork with external access using BYOIP: + * - + * Full resource URL, as inhttps://www.googleapis.com/compute/v1/projects/projectId/regions/region/publicDelegatedPrefixes/sub-pdp-name + * - + * Partial URL, as in + * - projects/projectId/regions/region/publicDelegatedPrefixes/sub-pdp-name + * - regions/region/publicDelegatedPrefixes/sub-pdp-name * * Generated from protobuf field optional string ip_collection = 176818358; */ protected $ip_collection = null; /** - * The access type of IPv6 address this subnet holds. It's immutable and can only be specified during creation or the first time the subnet is updated into IPV4_IPV6 dual stack. + * The access type of IPv6 address this subnet holds. It's immutable and can + * only be specified during creation or the first time the subnet is updated + * into IPV4_IPV6 dual stack. * Check the Ipv6AccessType enum for the list of possible values. * * Generated from protobuf field optional string ipv6_access_type = 504658653; @@ -89,50 +127,72 @@ class Subnetwork extends \Google\Protobuf\Internal\Message */ protected $ipv6_cidr_range = null; /** - * [Output Only] Possible endpoints of this subnetwork. It can be one of the following: - VM_ONLY: The subnetwork can be used for creating instances and IPv6 addresses with VM endpoint type. Such a subnetwork gets external IPv6 ranges from a public delegated prefix and cannot be used to create NetLb. - VM_AND_FR: The subnetwork can be used for creating both VM instances and Forwarding Rules. It can also be used to reserve IPv6 addresses with both VM and FR endpoint types. Such a subnetwork gets its IPv6 range from Google IP Pool directly. + * [Output Only] Possible endpoints of this subnetwork. It can be one of the + * following: + * - VM_ONLY: The subnetwork can be used for creating instances and + * IPv6 addresses with VM endpoint type. Such a subnetwork gets external IPv6 + * ranges from a public delegated prefix and cannot be used to create NetLb. + * - VM_AND_FR: The subnetwork can be used for creating both VM + * instances and Forwarding Rules. It can also be used to reserve IPv6 + * addresses with both VM and FR endpoint types. Such a subnetwork gets its + * IPv6 range from Google IP Pool directly. * Check the Ipv6GceEndpoint enum for the list of possible values. * * Generated from protobuf field optional string ipv6_gce_endpoint = 320382307; */ protected $ipv6_gce_endpoint = null; /** - * [Output Only] Type of the resource. Always compute#subnetwork for Subnetwork resources. + * [Output Only] Type of the resource. Always compute#subnetwork + * for Subnetwork resources. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * This field denotes the VPC flow logging options for this subnetwork. If logging is enabled, logs are exported to Cloud Logging. + * This field denotes the VPC flow logging options for this subnetwork. + * If logging is enabled, logs are exported to Cloud Logging. * * Generated from protobuf field optional .google.cloud.compute.v1.SubnetworkLogConfig log_config = 351299741; */ protected $log_config = null; /** - * The name of the resource, provided by the client when initially creating the resource. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * The name of the resource, provided by the client when initially creating + * the resource. The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * * Generated from protobuf field optional string name = 3373707; */ protected $name = null; /** - * The URL of the network to which this subnetwork belongs, provided by the client when initially creating the subnetwork. This field can be set only at resource creation time. + * The URL of the network to which this subnetwork belongs, provided by the + * client when initially creating the subnetwork. This field can be set only + * at resource creation time. * * Generated from protobuf field optional string network = 232872494; */ protected $network = null; /** - * Input only. [Input Only] Additional params passed with the request, but not persisted as part of resource payload. + * Input only. [Input Only] Additional params passed with the request, but not persisted + * as part of resource payload. * * Generated from protobuf field optional .google.cloud.compute.v1.SubnetworkParams params = 78313862; */ protected $params = null; /** - * Whether the VMs in this subnet can access Google services without assigned external IP addresses. This field can be both set at resource creation time and updated using setPrivateIpGoogleAccess. + * Whether the VMs in this subnet can access Google services without assigned + * external IP addresses. This field can be both set at resource creation + * time and updated using setPrivateIpGoogleAccess. * * Generated from protobuf field optional bool private_ip_google_access = 421491790; */ protected $private_ip_google_access = null; /** - * This field is for internal use. This field can be both set at resource creation time and updated using patch. + * This field is for internal use. + * This field can be both set at resource creation time and updated usingpatch. * Check the PrivateIpv6GoogleAccess enum for the list of possible values. * * Generated from protobuf field optional string private_ipv6_google_access = 48277006; @@ -146,7 +206,8 @@ class Subnetwork extends \Google\Protobuf\Internal\Message */ protected $purpose = null; /** - * URL of the region where the Subnetwork resides. This field can be set only at resource creation time. + * URL of the region where the Subnetwork resides. This + * field can be set only at resource creation time. * * Generated from protobuf field optional string region = 138946292; */ @@ -158,14 +219,22 @@ class Subnetwork extends \Google\Protobuf\Internal\Message */ protected $reserved_internal_range = null; /** - * The role of subnetwork. Currently, this field is only used when purpose is set to GLOBAL_MANAGED_PROXY or REGIONAL_MANAGED_PROXY. The value can be set to ACTIVE or BACKUP. An ACTIVE subnetwork is one that is currently being used for Envoy-based load balancers in a region. A BACKUP subnetwork is one that is ready to be promoted to ACTIVE or is currently draining. This field can be updated with a patch request. + * The role of subnetwork. Currently, this field is only used when + * purpose is set to GLOBAL_MANAGED_PROXY orREGIONAL_MANAGED_PROXY. The value can be set toACTIVE or BACKUP. An ACTIVE + * subnetwork is one that is currently being used for Envoy-based load + * balancers in a region. A BACKUP subnetwork is one that is + * ready to be promoted to ACTIVE or is currently draining. + * This field can be updated with a patch request. * Check the Role enum for the list of possible values. * * Generated from protobuf field optional string role = 3506294; */ protected $role = null; /** - * An array of configurations for secondary IP ranges for VM instances contained in this subnetwork. The primary IP of such VM must belong to the primary ipCidrRange of the subnetwork. The alias IPs may belong to either primary or secondary ranges. This field can be updated with a patch request. + * An array of configurations for secondary IP ranges for VM instances + * contained in this subnetwork. The primary IP of such VM must belong to the + * primary ipCidrRange of the subnetwork. The alias IPs may belong to either + * primary or secondary ranges. This field can be updated with apatch request. * * Generated from protobuf field repeated .google.cloud.compute.v1.SubnetworkSecondaryRange secondary_ip_ranges = 136658915; */ @@ -177,33 +246,43 @@ class Subnetwork extends \Google\Protobuf\Internal\Message */ protected $self_link = null; /** - * The stack type for the subnet. If set to IPV4_ONLY, new VMs in the subnet are assigned IPv4 addresses only. If set to IPV4_IPV6, new VMs in the subnet can be assigned both IPv4 and IPv6 addresses. If not specified, IPV4_ONLY is used. This field can be both set at resource creation time and updated using patch. + * The stack type for the subnet. If set to IPV4_ONLY, new VMs + * in the subnet are assigned IPv4 addresses only. If set toIPV4_IPV6, new VMs in the subnet can be assigned both IPv4 and + * IPv6 addresses. If not specified, IPV4_ONLY is used. + * This field can be both set at resource creation time and updated usingpatch. * Check the StackType enum for the list of possible values. * * Generated from protobuf field optional string stack_type = 425908881; */ protected $stack_type = null; /** - * [Output Only] The state of the subnetwork, which can be one of the following values: READY: Subnetwork is created and ready to use DRAINING: only applicable to subnetworks that have the purpose set to INTERNAL_HTTPS_LOAD_BALANCER and indicates that connections to the load balancer are being drained. A subnetwork that is draining cannot be used or modified until it reaches a status of READY + * [Output Only] The state of the subnetwork, which can be one of the + * following values:READY: Subnetwork is created and ready to useDRAINING: only applicable to subnetworks that have the + * purpose set to INTERNAL_HTTPS_LOAD_BALANCER and indicates that + * connections to the load balancer are being drained. A subnetwork that is + * draining cannot be used or modified until it reaches a status ofREADY * Check the State enum for the list of possible values. * * Generated from protobuf field optional string state = 109757585; */ protected $state = null; /** - * Output only. [Output Only] The array of external IPv6 network ranges reserved from the subnetwork's external IPv6 range for system use. + * Output only. [Output Only] The array of external IPv6 network ranges reserved from + * the subnetwork's external IPv6 range for system use. * * Generated from protobuf field repeated string system_reserved_external_ipv6_ranges = 65324129; */ private $system_reserved_external_ipv6_ranges; /** - * Output only. [Output Only] The array of internal IPv6 network ranges reserved from the subnetwork's internal IPv6 range for system use. + * Output only. [Output Only] The array of internal IPv6 network ranges reserved from + * the subnetwork's internal IPv6 range for system use. * * Generated from protobuf field repeated string system_reserved_internal_ipv6_ranges = 432294995; */ private $system_reserved_internal_ipv6_ranges; /** - * Output only. [Output Only] The current IP utilization of all subnetwork ranges. Contains the total number of allocated and free IPs in each range. + * Output only. [Output Only] The current IP utilization of all subnetwork ranges. Contains + * the total number of allocated and free IPs in each range. * * Generated from protobuf field optional .google.cloud.compute.v1.SubnetworkUtilizationDetails utilization_details = 125404453; */ @@ -216,74 +295,149 @@ class Subnetwork extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $creation_timestamp - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * @type string $description - * An optional description of this resource. Provide this property when you create the resource. This field can be set only at resource creation time. + * An optional description of this resource. Provide this property when you + * create the resource. This field can be set only at resource creation time. * @type bool $enable_flow_logs - * Whether to enable flow logging for this subnetwork. If this field is not explicitly set, it will not appear in get listings. If not set the default behavior is determined by the org policy, if there is no org policy specified, then it will default to disabled. This field isn't supported if the subnet purpose field is set to REGIONAL_MANAGED_PROXY. + * Whether to enable flow logging for this subnetwork. If this field is not + * explicitly set, it will not appear in get listings. If not set + * the default behavior is determined by the org policy, if there is no org + * policy specified, then it will default to disabled. This field isn't + * supported if the subnet purpose field is set toREGIONAL_MANAGED_PROXY. * @type string $external_ipv6_prefix - * The external IPv6 address range that is owned by this subnetwork. + * The external IPv6 address range that is owned by this + * subnetwork. * @type string $fingerprint - * Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking. This field will be ignored when inserting a Subnetwork. An up-to-date fingerprint must be provided in order to update the Subnetwork, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a Subnetwork. + * Fingerprint of this resource. A hash of the contents stored in this object. + * This field is used in optimistic locking. This field will be ignored when + * inserting a Subnetwork. An up-to-date fingerprint must be + * provided in order to update the Subnetwork, otherwise the + * request will fail with error 412 conditionNotMet. + * To see the latest fingerprint, make a get() request to + * retrieve a Subnetwork. * @type string $gateway_address - * [Output Only] The gateway address for default routes to reach destination addresses outside this subnetwork. + * [Output Only] The gateway address for default routes to reach destination + * addresses outside this subnetwork. * @type int|string $id - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * @type string $internal_ipv6_prefix - * The internal IPv6 address range that is owned by this subnetwork. + * The internal IPv6 address range that is owned by this + * subnetwork. * @type string $ip_cidr_range - * The range of internal addresses that are owned by this subnetwork. Provide this property when you create the subnetwork. For example, 10.0.0.0/8 or 100.64.0.0/10. Ranges must be unique and non-overlapping within a network. Only IPv4 is supported. This field is set at resource creation time. The range can be any range listed in the Valid ranges list. The range can be expanded after creation using expandIpCidrRange. + * The range of internal addresses that are owned by this subnetwork. + * Provide this property when you create the subnetwork. For example,10.0.0.0/8 or 100.64.0.0/10. Ranges must + * be unique and non-overlapping within a network. Only IPv4 is supported. + * This field is set at resource creation time. The range can be any range + * listed in theValid + * ranges list. The range can be expanded after creation usingexpandIpCidrRange. * @type string $ip_collection - * Reference to the source of IP, like a PublicDelegatedPrefix (PDP) for BYOIP. The PDP must be a sub-PDP in EXTERNAL_IPV6_SUBNETWORK_CREATION mode. Use one of the following formats to specify a sub-PDP when creating a dual stack subnetwork with external access using BYOIP: - Full resource URL, as in https://www.googleapis.com/compute/v1/projects/projectId/regions/region /publicDelegatedPrefixes/sub-pdp-name - Partial URL, as in - projects/projectId/regions/region/publicDelegatedPrefixes/ sub-pdp-name - regions/region/publicDelegatedPrefixes/sub-pdp-name + * Reference to the source of IP, like a PublicDelegatedPrefix + * (PDP) for BYOIP. The PDP must be a sub-PDP in + * EXTERNAL_IPV6_SUBNETWORK_CREATION or INTERNAL_IPV6_SUBNETWORK_CREATION + * mode. + * Use one of the following formats to specify a sub-PDP when creating a dual + * stack or IPv6-only subnetwork with external access using BYOIP: + * - + * Full resource URL, as inhttps://www.googleapis.com/compute/v1/projects/projectId/regions/region/publicDelegatedPrefixes/sub-pdp-name + * - + * Partial URL, as in + * - projects/projectId/regions/region/publicDelegatedPrefixes/sub-pdp-name + * - regions/region/publicDelegatedPrefixes/sub-pdp-name * @type string $ipv6_access_type - * The access type of IPv6 address this subnet holds. It's immutable and can only be specified during creation or the first time the subnet is updated into IPV4_IPV6 dual stack. + * The access type of IPv6 address this subnet holds. It's immutable and can + * only be specified during creation or the first time the subnet is updated + * into IPV4_IPV6 dual stack. * Check the Ipv6AccessType enum for the list of possible values. * @type string $ipv6_cidr_range * [Output Only] This field is for internal use. * @type string $ipv6_gce_endpoint - * [Output Only] Possible endpoints of this subnetwork. It can be one of the following: - VM_ONLY: The subnetwork can be used for creating instances and IPv6 addresses with VM endpoint type. Such a subnetwork gets external IPv6 ranges from a public delegated prefix and cannot be used to create NetLb. - VM_AND_FR: The subnetwork can be used for creating both VM instances and Forwarding Rules. It can also be used to reserve IPv6 addresses with both VM and FR endpoint types. Such a subnetwork gets its IPv6 range from Google IP Pool directly. + * [Output Only] Possible endpoints of this subnetwork. It can be one of the + * following: + * - VM_ONLY: The subnetwork can be used for creating instances and + * IPv6 addresses with VM endpoint type. Such a subnetwork gets external IPv6 + * ranges from a public delegated prefix and cannot be used to create NetLb. + * - VM_AND_FR: The subnetwork can be used for creating both VM + * instances and Forwarding Rules. It can also be used to reserve IPv6 + * addresses with both VM and FR endpoint types. Such a subnetwork gets its + * IPv6 range from Google IP Pool directly. * Check the Ipv6GceEndpoint enum for the list of possible values. * @type string $kind - * [Output Only] Type of the resource. Always compute#subnetwork for Subnetwork resources. + * [Output Only] Type of the resource. Always compute#subnetwork + * for Subnetwork resources. * @type \Google\Cloud\Compute\V1\SubnetworkLogConfig $log_config - * This field denotes the VPC flow logging options for this subnetwork. If logging is enabled, logs are exported to Cloud Logging. + * This field denotes the VPC flow logging options for this subnetwork. + * If logging is enabled, logs are exported to Cloud Logging. * @type string $name - * The name of the resource, provided by the client when initially creating the resource. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * The name of the resource, provided by the client when initially creating + * the resource. The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * @type string $network - * The URL of the network to which this subnetwork belongs, provided by the client when initially creating the subnetwork. This field can be set only at resource creation time. + * The URL of the network to which this subnetwork belongs, provided by the + * client when initially creating the subnetwork. This field can be set only + * at resource creation time. * @type \Google\Cloud\Compute\V1\SubnetworkParams $params - * Input only. [Input Only] Additional params passed with the request, but not persisted as part of resource payload. + * Input only. [Input Only] Additional params passed with the request, but not persisted + * as part of resource payload. * @type bool $private_ip_google_access - * Whether the VMs in this subnet can access Google services without assigned external IP addresses. This field can be both set at resource creation time and updated using setPrivateIpGoogleAccess. + * Whether the VMs in this subnet can access Google services without assigned + * external IP addresses. This field can be both set at resource creation + * time and updated using setPrivateIpGoogleAccess. * @type string $private_ipv6_google_access - * This field is for internal use. This field can be both set at resource creation time and updated using patch. + * This field is for internal use. + * This field can be both set at resource creation time and updated usingpatch. * Check the PrivateIpv6GoogleAccess enum for the list of possible values. * @type string $purpose * * Check the Purpose enum for the list of possible values. * @type string $region - * URL of the region where the Subnetwork resides. This field can be set only at resource creation time. + * URL of the region where the Subnetwork resides. This + * field can be set only at resource creation time. * @type string $reserved_internal_range * The URL of the reserved internal range. * @type string $role - * The role of subnetwork. Currently, this field is only used when purpose is set to GLOBAL_MANAGED_PROXY or REGIONAL_MANAGED_PROXY. The value can be set to ACTIVE or BACKUP. An ACTIVE subnetwork is one that is currently being used for Envoy-based load balancers in a region. A BACKUP subnetwork is one that is ready to be promoted to ACTIVE or is currently draining. This field can be updated with a patch request. + * The role of subnetwork. Currently, this field is only used when + * purpose is set to GLOBAL_MANAGED_PROXY orREGIONAL_MANAGED_PROXY. The value can be set toACTIVE or BACKUP. An ACTIVE + * subnetwork is one that is currently being used for Envoy-based load + * balancers in a region. A BACKUP subnetwork is one that is + * ready to be promoted to ACTIVE or is currently draining. + * This field can be updated with a patch request. * Check the Role enum for the list of possible values. * @type array<\Google\Cloud\Compute\V1\SubnetworkSecondaryRange>|\Google\Protobuf\Internal\RepeatedField $secondary_ip_ranges - * An array of configurations for secondary IP ranges for VM instances contained in this subnetwork. The primary IP of such VM must belong to the primary ipCidrRange of the subnetwork. The alias IPs may belong to either primary or secondary ranges. This field can be updated with a patch request. + * An array of configurations for secondary IP ranges for VM instances + * contained in this subnetwork. The primary IP of such VM must belong to the + * primary ipCidrRange of the subnetwork. The alias IPs may belong to either + * primary or secondary ranges. This field can be updated with apatch request. * @type string $self_link * [Output Only] Server-defined URL for the resource. * @type string $stack_type - * The stack type for the subnet. If set to IPV4_ONLY, new VMs in the subnet are assigned IPv4 addresses only. If set to IPV4_IPV6, new VMs in the subnet can be assigned both IPv4 and IPv6 addresses. If not specified, IPV4_ONLY is used. This field can be both set at resource creation time and updated using patch. + * The stack type for the subnet. If set to IPV4_ONLY, new VMs + * in the subnet are assigned IPv4 addresses only. If set toIPV4_IPV6, new VMs in the subnet can be assigned both IPv4 and + * IPv6 addresses. If not specified, IPV4_ONLY is used. + * This field can be both set at resource creation time and updated usingpatch. * Check the StackType enum for the list of possible values. * @type string $state - * [Output Only] The state of the subnetwork, which can be one of the following values: READY: Subnetwork is created and ready to use DRAINING: only applicable to subnetworks that have the purpose set to INTERNAL_HTTPS_LOAD_BALANCER and indicates that connections to the load balancer are being drained. A subnetwork that is draining cannot be used or modified until it reaches a status of READY + * [Output Only] The state of the subnetwork, which can be one of the + * following values:READY: Subnetwork is created and ready to useDRAINING: only applicable to subnetworks that have the + * purpose set to INTERNAL_HTTPS_LOAD_BALANCER and indicates that + * connections to the load balancer are being drained. A subnetwork that is + * draining cannot be used or modified until it reaches a status ofREADY * Check the State enum for the list of possible values. * @type array|\Google\Protobuf\Internal\RepeatedField $system_reserved_external_ipv6_ranges - * Output only. [Output Only] The array of external IPv6 network ranges reserved from the subnetwork's external IPv6 range for system use. + * Output only. [Output Only] The array of external IPv6 network ranges reserved from + * the subnetwork's external IPv6 range for system use. * @type array|\Google\Protobuf\Internal\RepeatedField $system_reserved_internal_ipv6_ranges - * Output only. [Output Only] The array of internal IPv6 network ranges reserved from the subnetwork's internal IPv6 range for system use. + * Output only. [Output Only] The array of internal IPv6 network ranges reserved from + * the subnetwork's internal IPv6 range for system use. * @type \Google\Cloud\Compute\V1\SubnetworkUtilizationDetails $utilization_details - * Output only. [Output Only] The current IP utilization of all subnetwork ranges. Contains the total number of allocated and free IPs in each range. + * Output only. [Output Only] The current IP utilization of all subnetwork ranges. Contains + * the total number of allocated and free IPs in each range. * } */ public function __construct($data = NULL) { @@ -292,7 +446,8 @@ public function __construct($data = NULL) { } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @return string @@ -313,7 +468,8 @@ public function clearCreationTimestamp() } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @param string $var @@ -328,7 +484,8 @@ public function setCreationTimestamp($var) } /** - * An optional description of this resource. Provide this property when you create the resource. This field can be set only at resource creation time. + * An optional description of this resource. Provide this property when you + * create the resource. This field can be set only at resource creation time. * * Generated from protobuf field optional string description = 422937596; * @return string @@ -349,7 +506,8 @@ public function clearDescription() } /** - * An optional description of this resource. Provide this property when you create the resource. This field can be set only at resource creation time. + * An optional description of this resource. Provide this property when you + * create the resource. This field can be set only at resource creation time. * * Generated from protobuf field optional string description = 422937596; * @param string $var @@ -364,7 +522,11 @@ public function setDescription($var) } /** - * Whether to enable flow logging for this subnetwork. If this field is not explicitly set, it will not appear in get listings. If not set the default behavior is determined by the org policy, if there is no org policy specified, then it will default to disabled. This field isn't supported if the subnet purpose field is set to REGIONAL_MANAGED_PROXY. + * Whether to enable flow logging for this subnetwork. If this field is not + * explicitly set, it will not appear in get listings. If not set + * the default behavior is determined by the org policy, if there is no org + * policy specified, then it will default to disabled. This field isn't + * supported if the subnet purpose field is set toREGIONAL_MANAGED_PROXY. * * Generated from protobuf field optional bool enable_flow_logs = 151544420; * @return bool @@ -385,7 +547,11 @@ public function clearEnableFlowLogs() } /** - * Whether to enable flow logging for this subnetwork. If this field is not explicitly set, it will not appear in get listings. If not set the default behavior is determined by the org policy, if there is no org policy specified, then it will default to disabled. This field isn't supported if the subnet purpose field is set to REGIONAL_MANAGED_PROXY. + * Whether to enable flow logging for this subnetwork. If this field is not + * explicitly set, it will not appear in get listings. If not set + * the default behavior is determined by the org policy, if there is no org + * policy specified, then it will default to disabled. This field isn't + * supported if the subnet purpose field is set toREGIONAL_MANAGED_PROXY. * * Generated from protobuf field optional bool enable_flow_logs = 151544420; * @param bool $var @@ -400,7 +566,8 @@ public function setEnableFlowLogs($var) } /** - * The external IPv6 address range that is owned by this subnetwork. + * The external IPv6 address range that is owned by this + * subnetwork. * * Generated from protobuf field optional string external_ipv6_prefix = 139299190; * @return string @@ -421,7 +588,8 @@ public function clearExternalIpv6Prefix() } /** - * The external IPv6 address range that is owned by this subnetwork. + * The external IPv6 address range that is owned by this + * subnetwork. * * Generated from protobuf field optional string external_ipv6_prefix = 139299190; * @param string $var @@ -436,7 +604,13 @@ public function setExternalIpv6Prefix($var) } /** - * Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking. This field will be ignored when inserting a Subnetwork. An up-to-date fingerprint must be provided in order to update the Subnetwork, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a Subnetwork. + * Fingerprint of this resource. A hash of the contents stored in this object. + * This field is used in optimistic locking. This field will be ignored when + * inserting a Subnetwork. An up-to-date fingerprint must be + * provided in order to update the Subnetwork, otherwise the + * request will fail with error 412 conditionNotMet. + * To see the latest fingerprint, make a get() request to + * retrieve a Subnetwork. * * Generated from protobuf field optional string fingerprint = 234678500; * @return string @@ -457,7 +631,13 @@ public function clearFingerprint() } /** - * Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking. This field will be ignored when inserting a Subnetwork. An up-to-date fingerprint must be provided in order to update the Subnetwork, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a Subnetwork. + * Fingerprint of this resource. A hash of the contents stored in this object. + * This field is used in optimistic locking. This field will be ignored when + * inserting a Subnetwork. An up-to-date fingerprint must be + * provided in order to update the Subnetwork, otherwise the + * request will fail with error 412 conditionNotMet. + * To see the latest fingerprint, make a get() request to + * retrieve a Subnetwork. * * Generated from protobuf field optional string fingerprint = 234678500; * @param string $var @@ -472,7 +652,8 @@ public function setFingerprint($var) } /** - * [Output Only] The gateway address for default routes to reach destination addresses outside this subnetwork. + * [Output Only] The gateway address for default routes to reach destination + * addresses outside this subnetwork. * * Generated from protobuf field optional string gateway_address = 459867385; * @return string @@ -493,7 +674,8 @@ public function clearGatewayAddress() } /** - * [Output Only] The gateway address for default routes to reach destination addresses outside this subnetwork. + * [Output Only] The gateway address for default routes to reach destination + * addresses outside this subnetwork. * * Generated from protobuf field optional string gateway_address = 459867385; * @param string $var @@ -508,7 +690,8 @@ public function setGatewayAddress($var) } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @return int|string @@ -529,7 +712,8 @@ public function clearId() } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @param int|string $var @@ -544,7 +728,8 @@ public function setId($var) } /** - * The internal IPv6 address range that is owned by this subnetwork. + * The internal IPv6 address range that is owned by this + * subnetwork. * * Generated from protobuf field optional string internal_ipv6_prefix = 506270056; * @return string @@ -565,7 +750,8 @@ public function clearInternalIpv6Prefix() } /** - * The internal IPv6 address range that is owned by this subnetwork. + * The internal IPv6 address range that is owned by this + * subnetwork. * * Generated from protobuf field optional string internal_ipv6_prefix = 506270056; * @param string $var @@ -580,7 +766,12 @@ public function setInternalIpv6Prefix($var) } /** - * The range of internal addresses that are owned by this subnetwork. Provide this property when you create the subnetwork. For example, 10.0.0.0/8 or 100.64.0.0/10. Ranges must be unique and non-overlapping within a network. Only IPv4 is supported. This field is set at resource creation time. The range can be any range listed in the Valid ranges list. The range can be expanded after creation using expandIpCidrRange. + * The range of internal addresses that are owned by this subnetwork. + * Provide this property when you create the subnetwork. For example,10.0.0.0/8 or 100.64.0.0/10. Ranges must + * be unique and non-overlapping within a network. Only IPv4 is supported. + * This field is set at resource creation time. The range can be any range + * listed in theValid + * ranges list. The range can be expanded after creation usingexpandIpCidrRange. * * Generated from protobuf field optional string ip_cidr_range = 98117322; * @return string @@ -601,7 +792,12 @@ public function clearIpCidrRange() } /** - * The range of internal addresses that are owned by this subnetwork. Provide this property when you create the subnetwork. For example, 10.0.0.0/8 or 100.64.0.0/10. Ranges must be unique and non-overlapping within a network. Only IPv4 is supported. This field is set at resource creation time. The range can be any range listed in the Valid ranges list. The range can be expanded after creation using expandIpCidrRange. + * The range of internal addresses that are owned by this subnetwork. + * Provide this property when you create the subnetwork. For example,10.0.0.0/8 or 100.64.0.0/10. Ranges must + * be unique and non-overlapping within a network. Only IPv4 is supported. + * This field is set at resource creation time. The range can be any range + * listed in theValid + * ranges list. The range can be expanded after creation usingexpandIpCidrRange. * * Generated from protobuf field optional string ip_cidr_range = 98117322; * @param string $var @@ -616,7 +812,18 @@ public function setIpCidrRange($var) } /** - * Reference to the source of IP, like a PublicDelegatedPrefix (PDP) for BYOIP. The PDP must be a sub-PDP in EXTERNAL_IPV6_SUBNETWORK_CREATION mode. Use one of the following formats to specify a sub-PDP when creating a dual stack subnetwork with external access using BYOIP: - Full resource URL, as in https://www.googleapis.com/compute/v1/projects/projectId/regions/region /publicDelegatedPrefixes/sub-pdp-name - Partial URL, as in - projects/projectId/regions/region/publicDelegatedPrefixes/ sub-pdp-name - regions/region/publicDelegatedPrefixes/sub-pdp-name + * Reference to the source of IP, like a PublicDelegatedPrefix + * (PDP) for BYOIP. The PDP must be a sub-PDP in + * EXTERNAL_IPV6_SUBNETWORK_CREATION or INTERNAL_IPV6_SUBNETWORK_CREATION + * mode. + * Use one of the following formats to specify a sub-PDP when creating a dual + * stack or IPv6-only subnetwork with external access using BYOIP: + * - + * Full resource URL, as inhttps://www.googleapis.com/compute/v1/projects/projectId/regions/region/publicDelegatedPrefixes/sub-pdp-name + * - + * Partial URL, as in + * - projects/projectId/regions/region/publicDelegatedPrefixes/sub-pdp-name + * - regions/region/publicDelegatedPrefixes/sub-pdp-name * * Generated from protobuf field optional string ip_collection = 176818358; * @return string @@ -637,7 +844,18 @@ public function clearIpCollection() } /** - * Reference to the source of IP, like a PublicDelegatedPrefix (PDP) for BYOIP. The PDP must be a sub-PDP in EXTERNAL_IPV6_SUBNETWORK_CREATION mode. Use one of the following formats to specify a sub-PDP when creating a dual stack subnetwork with external access using BYOIP: - Full resource URL, as in https://www.googleapis.com/compute/v1/projects/projectId/regions/region /publicDelegatedPrefixes/sub-pdp-name - Partial URL, as in - projects/projectId/regions/region/publicDelegatedPrefixes/ sub-pdp-name - regions/region/publicDelegatedPrefixes/sub-pdp-name + * Reference to the source of IP, like a PublicDelegatedPrefix + * (PDP) for BYOIP. The PDP must be a sub-PDP in + * EXTERNAL_IPV6_SUBNETWORK_CREATION or INTERNAL_IPV6_SUBNETWORK_CREATION + * mode. + * Use one of the following formats to specify a sub-PDP when creating a dual + * stack or IPv6-only subnetwork with external access using BYOIP: + * - + * Full resource URL, as inhttps://www.googleapis.com/compute/v1/projects/projectId/regions/region/publicDelegatedPrefixes/sub-pdp-name + * - + * Partial URL, as in + * - projects/projectId/regions/region/publicDelegatedPrefixes/sub-pdp-name + * - regions/region/publicDelegatedPrefixes/sub-pdp-name * * Generated from protobuf field optional string ip_collection = 176818358; * @param string $var @@ -652,7 +870,9 @@ public function setIpCollection($var) } /** - * The access type of IPv6 address this subnet holds. It's immutable and can only be specified during creation or the first time the subnet is updated into IPV4_IPV6 dual stack. + * The access type of IPv6 address this subnet holds. It's immutable and can + * only be specified during creation or the first time the subnet is updated + * into IPV4_IPV6 dual stack. * Check the Ipv6AccessType enum for the list of possible values. * * Generated from protobuf field optional string ipv6_access_type = 504658653; @@ -674,7 +894,9 @@ public function clearIpv6AccessType() } /** - * The access type of IPv6 address this subnet holds. It's immutable and can only be specified during creation or the first time the subnet is updated into IPV4_IPV6 dual stack. + * The access type of IPv6 address this subnet holds. It's immutable and can + * only be specified during creation or the first time the subnet is updated + * into IPV4_IPV6 dual stack. * Check the Ipv6AccessType enum for the list of possible values. * * Generated from protobuf field optional string ipv6_access_type = 504658653; @@ -726,7 +948,15 @@ public function setIpv6CidrRange($var) } /** - * [Output Only] Possible endpoints of this subnetwork. It can be one of the following: - VM_ONLY: The subnetwork can be used for creating instances and IPv6 addresses with VM endpoint type. Such a subnetwork gets external IPv6 ranges from a public delegated prefix and cannot be used to create NetLb. - VM_AND_FR: The subnetwork can be used for creating both VM instances and Forwarding Rules. It can also be used to reserve IPv6 addresses with both VM and FR endpoint types. Such a subnetwork gets its IPv6 range from Google IP Pool directly. + * [Output Only] Possible endpoints of this subnetwork. It can be one of the + * following: + * - VM_ONLY: The subnetwork can be used for creating instances and + * IPv6 addresses with VM endpoint type. Such a subnetwork gets external IPv6 + * ranges from a public delegated prefix and cannot be used to create NetLb. + * - VM_AND_FR: The subnetwork can be used for creating both VM + * instances and Forwarding Rules. It can also be used to reserve IPv6 + * addresses with both VM and FR endpoint types. Such a subnetwork gets its + * IPv6 range from Google IP Pool directly. * Check the Ipv6GceEndpoint enum for the list of possible values. * * Generated from protobuf field optional string ipv6_gce_endpoint = 320382307; @@ -748,7 +978,15 @@ public function clearIpv6GceEndpoint() } /** - * [Output Only] Possible endpoints of this subnetwork. It can be one of the following: - VM_ONLY: The subnetwork can be used for creating instances and IPv6 addresses with VM endpoint type. Such a subnetwork gets external IPv6 ranges from a public delegated prefix and cannot be used to create NetLb. - VM_AND_FR: The subnetwork can be used for creating both VM instances and Forwarding Rules. It can also be used to reserve IPv6 addresses with both VM and FR endpoint types. Such a subnetwork gets its IPv6 range from Google IP Pool directly. + * [Output Only] Possible endpoints of this subnetwork. It can be one of the + * following: + * - VM_ONLY: The subnetwork can be used for creating instances and + * IPv6 addresses with VM endpoint type. Such a subnetwork gets external IPv6 + * ranges from a public delegated prefix and cannot be used to create NetLb. + * - VM_AND_FR: The subnetwork can be used for creating both VM + * instances and Forwarding Rules. It can also be used to reserve IPv6 + * addresses with both VM and FR endpoint types. Such a subnetwork gets its + * IPv6 range from Google IP Pool directly. * Check the Ipv6GceEndpoint enum for the list of possible values. * * Generated from protobuf field optional string ipv6_gce_endpoint = 320382307; @@ -764,7 +1002,8 @@ public function setIpv6GceEndpoint($var) } /** - * [Output Only] Type of the resource. Always compute#subnetwork for Subnetwork resources. + * [Output Only] Type of the resource. Always compute#subnetwork + * for Subnetwork resources. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -785,7 +1024,8 @@ public function clearKind() } /** - * [Output Only] Type of the resource. Always compute#subnetwork for Subnetwork resources. + * [Output Only] Type of the resource. Always compute#subnetwork + * for Subnetwork resources. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -800,7 +1040,8 @@ public function setKind($var) } /** - * This field denotes the VPC flow logging options for this subnetwork. If logging is enabled, logs are exported to Cloud Logging. + * This field denotes the VPC flow logging options for this subnetwork. + * If logging is enabled, logs are exported to Cloud Logging. * * Generated from protobuf field optional .google.cloud.compute.v1.SubnetworkLogConfig log_config = 351299741; * @return \Google\Cloud\Compute\V1\SubnetworkLogConfig|null @@ -821,7 +1062,8 @@ public function clearLogConfig() } /** - * This field denotes the VPC flow logging options for this subnetwork. If logging is enabled, logs are exported to Cloud Logging. + * This field denotes the VPC flow logging options for this subnetwork. + * If logging is enabled, logs are exported to Cloud Logging. * * Generated from protobuf field optional .google.cloud.compute.v1.SubnetworkLogConfig log_config = 351299741; * @param \Google\Cloud\Compute\V1\SubnetworkLogConfig $var @@ -836,7 +1078,13 @@ public function setLogConfig($var) } /** - * The name of the resource, provided by the client when initially creating the resource. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * The name of the resource, provided by the client when initially creating + * the resource. The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * * Generated from protobuf field optional string name = 3373707; * @return string @@ -857,7 +1105,13 @@ public function clearName() } /** - * The name of the resource, provided by the client when initially creating the resource. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * The name of the resource, provided by the client when initially creating + * the resource. The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * * Generated from protobuf field optional string name = 3373707; * @param string $var @@ -872,7 +1126,9 @@ public function setName($var) } /** - * The URL of the network to which this subnetwork belongs, provided by the client when initially creating the subnetwork. This field can be set only at resource creation time. + * The URL of the network to which this subnetwork belongs, provided by the + * client when initially creating the subnetwork. This field can be set only + * at resource creation time. * * Generated from protobuf field optional string network = 232872494; * @return string @@ -893,7 +1149,9 @@ public function clearNetwork() } /** - * The URL of the network to which this subnetwork belongs, provided by the client when initially creating the subnetwork. This field can be set only at resource creation time. + * The URL of the network to which this subnetwork belongs, provided by the + * client when initially creating the subnetwork. This field can be set only + * at resource creation time. * * Generated from protobuf field optional string network = 232872494; * @param string $var @@ -908,7 +1166,8 @@ public function setNetwork($var) } /** - * Input only. [Input Only] Additional params passed with the request, but not persisted as part of resource payload. + * Input only. [Input Only] Additional params passed with the request, but not persisted + * as part of resource payload. * * Generated from protobuf field optional .google.cloud.compute.v1.SubnetworkParams params = 78313862; * @return \Google\Cloud\Compute\V1\SubnetworkParams|null @@ -929,7 +1188,8 @@ public function clearParams() } /** - * Input only. [Input Only] Additional params passed with the request, but not persisted as part of resource payload. + * Input only. [Input Only] Additional params passed with the request, but not persisted + * as part of resource payload. * * Generated from protobuf field optional .google.cloud.compute.v1.SubnetworkParams params = 78313862; * @param \Google\Cloud\Compute\V1\SubnetworkParams $var @@ -944,7 +1204,9 @@ public function setParams($var) } /** - * Whether the VMs in this subnet can access Google services without assigned external IP addresses. This field can be both set at resource creation time and updated using setPrivateIpGoogleAccess. + * Whether the VMs in this subnet can access Google services without assigned + * external IP addresses. This field can be both set at resource creation + * time and updated using setPrivateIpGoogleAccess. * * Generated from protobuf field optional bool private_ip_google_access = 421491790; * @return bool @@ -965,7 +1227,9 @@ public function clearPrivateIpGoogleAccess() } /** - * Whether the VMs in this subnet can access Google services without assigned external IP addresses. This field can be both set at resource creation time and updated using setPrivateIpGoogleAccess. + * Whether the VMs in this subnet can access Google services without assigned + * external IP addresses. This field can be both set at resource creation + * time and updated using setPrivateIpGoogleAccess. * * Generated from protobuf field optional bool private_ip_google_access = 421491790; * @param bool $var @@ -980,7 +1244,8 @@ public function setPrivateIpGoogleAccess($var) } /** - * This field is for internal use. This field can be both set at resource creation time and updated using patch. + * This field is for internal use. + * This field can be both set at resource creation time and updated usingpatch. * Check the PrivateIpv6GoogleAccess enum for the list of possible values. * * Generated from protobuf field optional string private_ipv6_google_access = 48277006; @@ -1002,7 +1267,8 @@ public function clearPrivateIpv6GoogleAccess() } /** - * This field is for internal use. This field can be both set at resource creation time and updated using patch. + * This field is for internal use. + * This field can be both set at resource creation time and updated usingpatch. * Check the PrivateIpv6GoogleAccess enum for the list of possible values. * * Generated from protobuf field optional string private_ipv6_google_access = 48277006; @@ -1056,7 +1322,8 @@ public function setPurpose($var) } /** - * URL of the region where the Subnetwork resides. This field can be set only at resource creation time. + * URL of the region where the Subnetwork resides. This + * field can be set only at resource creation time. * * Generated from protobuf field optional string region = 138946292; * @return string @@ -1077,7 +1344,8 @@ public function clearRegion() } /** - * URL of the region where the Subnetwork resides. This field can be set only at resource creation time. + * URL of the region where the Subnetwork resides. This + * field can be set only at resource creation time. * * Generated from protobuf field optional string region = 138946292; * @param string $var @@ -1128,7 +1396,12 @@ public function setReservedInternalRange($var) } /** - * The role of subnetwork. Currently, this field is only used when purpose is set to GLOBAL_MANAGED_PROXY or REGIONAL_MANAGED_PROXY. The value can be set to ACTIVE or BACKUP. An ACTIVE subnetwork is one that is currently being used for Envoy-based load balancers in a region. A BACKUP subnetwork is one that is ready to be promoted to ACTIVE or is currently draining. This field can be updated with a patch request. + * The role of subnetwork. Currently, this field is only used when + * purpose is set to GLOBAL_MANAGED_PROXY orREGIONAL_MANAGED_PROXY. The value can be set toACTIVE or BACKUP. An ACTIVE + * subnetwork is one that is currently being used for Envoy-based load + * balancers in a region. A BACKUP subnetwork is one that is + * ready to be promoted to ACTIVE or is currently draining. + * This field can be updated with a patch request. * Check the Role enum for the list of possible values. * * Generated from protobuf field optional string role = 3506294; @@ -1150,7 +1423,12 @@ public function clearRole() } /** - * The role of subnetwork. Currently, this field is only used when purpose is set to GLOBAL_MANAGED_PROXY or REGIONAL_MANAGED_PROXY. The value can be set to ACTIVE or BACKUP. An ACTIVE subnetwork is one that is currently being used for Envoy-based load balancers in a region. A BACKUP subnetwork is one that is ready to be promoted to ACTIVE or is currently draining. This field can be updated with a patch request. + * The role of subnetwork. Currently, this field is only used when + * purpose is set to GLOBAL_MANAGED_PROXY orREGIONAL_MANAGED_PROXY. The value can be set toACTIVE or BACKUP. An ACTIVE + * subnetwork is one that is currently being used for Envoy-based load + * balancers in a region. A BACKUP subnetwork is one that is + * ready to be promoted to ACTIVE or is currently draining. + * This field can be updated with a patch request. * Check the Role enum for the list of possible values. * * Generated from protobuf field optional string role = 3506294; @@ -1166,7 +1444,10 @@ public function setRole($var) } /** - * An array of configurations for secondary IP ranges for VM instances contained in this subnetwork. The primary IP of such VM must belong to the primary ipCidrRange of the subnetwork. The alias IPs may belong to either primary or secondary ranges. This field can be updated with a patch request. + * An array of configurations for secondary IP ranges for VM instances + * contained in this subnetwork. The primary IP of such VM must belong to the + * primary ipCidrRange of the subnetwork. The alias IPs may belong to either + * primary or secondary ranges. This field can be updated with apatch request. * * Generated from protobuf field repeated .google.cloud.compute.v1.SubnetworkSecondaryRange secondary_ip_ranges = 136658915; * @return \Google\Protobuf\Internal\RepeatedField @@ -1177,7 +1458,10 @@ public function getSecondaryIpRanges() } /** - * An array of configurations for secondary IP ranges for VM instances contained in this subnetwork. The primary IP of such VM must belong to the primary ipCidrRange of the subnetwork. The alias IPs may belong to either primary or secondary ranges. This field can be updated with a patch request. + * An array of configurations for secondary IP ranges for VM instances + * contained in this subnetwork. The primary IP of such VM must belong to the + * primary ipCidrRange of the subnetwork. The alias IPs may belong to either + * primary or secondary ranges. This field can be updated with apatch request. * * Generated from protobuf field repeated .google.cloud.compute.v1.SubnetworkSecondaryRange secondary_ip_ranges = 136658915; * @param array<\Google\Cloud\Compute\V1\SubnetworkSecondaryRange>|\Google\Protobuf\Internal\RepeatedField $var @@ -1228,7 +1512,10 @@ public function setSelfLink($var) } /** - * The stack type for the subnet. If set to IPV4_ONLY, new VMs in the subnet are assigned IPv4 addresses only. If set to IPV4_IPV6, new VMs in the subnet can be assigned both IPv4 and IPv6 addresses. If not specified, IPV4_ONLY is used. This field can be both set at resource creation time and updated using patch. + * The stack type for the subnet. If set to IPV4_ONLY, new VMs + * in the subnet are assigned IPv4 addresses only. If set toIPV4_IPV6, new VMs in the subnet can be assigned both IPv4 and + * IPv6 addresses. If not specified, IPV4_ONLY is used. + * This field can be both set at resource creation time and updated usingpatch. * Check the StackType enum for the list of possible values. * * Generated from protobuf field optional string stack_type = 425908881; @@ -1250,7 +1537,10 @@ public function clearStackType() } /** - * The stack type for the subnet. If set to IPV4_ONLY, new VMs in the subnet are assigned IPv4 addresses only. If set to IPV4_IPV6, new VMs in the subnet can be assigned both IPv4 and IPv6 addresses. If not specified, IPV4_ONLY is used. This field can be both set at resource creation time and updated using patch. + * The stack type for the subnet. If set to IPV4_ONLY, new VMs + * in the subnet are assigned IPv4 addresses only. If set toIPV4_IPV6, new VMs in the subnet can be assigned both IPv4 and + * IPv6 addresses. If not specified, IPV4_ONLY is used. + * This field can be both set at resource creation time and updated usingpatch. * Check the StackType enum for the list of possible values. * * Generated from protobuf field optional string stack_type = 425908881; @@ -1266,7 +1556,11 @@ public function setStackType($var) } /** - * [Output Only] The state of the subnetwork, which can be one of the following values: READY: Subnetwork is created and ready to use DRAINING: only applicable to subnetworks that have the purpose set to INTERNAL_HTTPS_LOAD_BALANCER and indicates that connections to the load balancer are being drained. A subnetwork that is draining cannot be used or modified until it reaches a status of READY + * [Output Only] The state of the subnetwork, which can be one of the + * following values:READY: Subnetwork is created and ready to useDRAINING: only applicable to subnetworks that have the + * purpose set to INTERNAL_HTTPS_LOAD_BALANCER and indicates that + * connections to the load balancer are being drained. A subnetwork that is + * draining cannot be used or modified until it reaches a status ofREADY * Check the State enum for the list of possible values. * * Generated from protobuf field optional string state = 109757585; @@ -1288,7 +1582,11 @@ public function clearState() } /** - * [Output Only] The state of the subnetwork, which can be one of the following values: READY: Subnetwork is created and ready to use DRAINING: only applicable to subnetworks that have the purpose set to INTERNAL_HTTPS_LOAD_BALANCER and indicates that connections to the load balancer are being drained. A subnetwork that is draining cannot be used or modified until it reaches a status of READY + * [Output Only] The state of the subnetwork, which can be one of the + * following values:READY: Subnetwork is created and ready to useDRAINING: only applicable to subnetworks that have the + * purpose set to INTERNAL_HTTPS_LOAD_BALANCER and indicates that + * connections to the load balancer are being drained. A subnetwork that is + * draining cannot be used or modified until it reaches a status ofREADY * Check the State enum for the list of possible values. * * Generated from protobuf field optional string state = 109757585; @@ -1304,7 +1602,8 @@ public function setState($var) } /** - * Output only. [Output Only] The array of external IPv6 network ranges reserved from the subnetwork's external IPv6 range for system use. + * Output only. [Output Only] The array of external IPv6 network ranges reserved from + * the subnetwork's external IPv6 range for system use. * * Generated from protobuf field repeated string system_reserved_external_ipv6_ranges = 65324129; * @return \Google\Protobuf\Internal\RepeatedField @@ -1315,7 +1614,8 @@ public function getSystemReservedExternalIpv6Ranges() } /** - * Output only. [Output Only] The array of external IPv6 network ranges reserved from the subnetwork's external IPv6 range for system use. + * Output only. [Output Only] The array of external IPv6 network ranges reserved from + * the subnetwork's external IPv6 range for system use. * * Generated from protobuf field repeated string system_reserved_external_ipv6_ranges = 65324129; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -1330,7 +1630,8 @@ public function setSystemReservedExternalIpv6Ranges($var) } /** - * Output only. [Output Only] The array of internal IPv6 network ranges reserved from the subnetwork's internal IPv6 range for system use. + * Output only. [Output Only] The array of internal IPv6 network ranges reserved from + * the subnetwork's internal IPv6 range for system use. * * Generated from protobuf field repeated string system_reserved_internal_ipv6_ranges = 432294995; * @return \Google\Protobuf\Internal\RepeatedField @@ -1341,7 +1642,8 @@ public function getSystemReservedInternalIpv6Ranges() } /** - * Output only. [Output Only] The array of internal IPv6 network ranges reserved from the subnetwork's internal IPv6 range for system use. + * Output only. [Output Only] The array of internal IPv6 network ranges reserved from + * the subnetwork's internal IPv6 range for system use. * * Generated from protobuf field repeated string system_reserved_internal_ipv6_ranges = 432294995; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -1356,7 +1658,8 @@ public function setSystemReservedInternalIpv6Ranges($var) } /** - * Output only. [Output Only] The current IP utilization of all subnetwork ranges. Contains the total number of allocated and free IPs in each range. + * Output only. [Output Only] The current IP utilization of all subnetwork ranges. Contains + * the total number of allocated and free IPs in each range. * * Generated from protobuf field optional .google.cloud.compute.v1.SubnetworkUtilizationDetails utilization_details = 125404453; * @return \Google\Cloud\Compute\V1\SubnetworkUtilizationDetails|null @@ -1377,7 +1680,8 @@ public function clearUtilizationDetails() } /** - * Output only. [Output Only] The current IP utilization of all subnetwork ranges. Contains the total number of allocated and free IPs in each range. + * Output only. [Output Only] The current IP utilization of all subnetwork ranges. Contains + * the total number of allocated and free IPs in each range. * * Generated from protobuf field optional .google.cloud.compute.v1.SubnetworkUtilizationDetails utilization_details = 125404453; * @param \Google\Cloud\Compute\V1\SubnetworkUtilizationDetails $var diff --git a/Compute/src/V1/Subnetwork/Ipv6AccessType.php b/Compute/src/V1/Subnetwork/Ipv6AccessType.php index 284548fdad08..aa438e6bd8e8 100644 --- a/Compute/src/V1/Subnetwork/Ipv6AccessType.php +++ b/Compute/src/V1/Subnetwork/Ipv6AccessType.php @@ -7,7 +7,9 @@ use UnexpectedValueException; /** - * The access type of IPv6 address this subnet holds. It's immutable and can only be specified during creation or the first time the subnet is updated into IPV4_IPV6 dual stack. + * The access type of IPv6 address this subnet holds. It's immutable and can + * only be specified during creation or the first time the subnet is updated + * into IPV4_IPV6 dual stack. * * Protobuf type google.cloud.compute.v1.Subnetwork.Ipv6AccessType */ @@ -20,13 +22,15 @@ class Ipv6AccessType */ const UNDEFINED_IPV6_ACCESS_TYPE = 0; /** - * VMs on this subnet will be assigned IPv6 addresses that are accessible via the Internet, as well as the VPC network. + * VMs on this subnet will be assigned IPv6 addresses that are accessible + * via the Internet, as well as the VPC network. * * Generated from protobuf enum EXTERNAL = 35607499; */ const EXTERNAL = 35607499; /** - * VMs on this subnet will be assigned IPv6 addresses that are only accessible over the VPC network. + * VMs on this subnet will be assigned IPv6 addresses that are only + * accessible over the VPC network. * * Generated from protobuf enum INTERNAL = 279295677; */ diff --git a/Compute/src/V1/Subnetwork/Ipv6GceEndpoint.php b/Compute/src/V1/Subnetwork/Ipv6GceEndpoint.php index 125c9485deff..3713e665f572 100644 --- a/Compute/src/V1/Subnetwork/Ipv6GceEndpoint.php +++ b/Compute/src/V1/Subnetwork/Ipv6GceEndpoint.php @@ -7,7 +7,15 @@ use UnexpectedValueException; /** - * [Output Only] Possible endpoints of this subnetwork. It can be one of the following: - VM_ONLY: The subnetwork can be used for creating instances and IPv6 addresses with VM endpoint type. Such a subnetwork gets external IPv6 ranges from a public delegated prefix and cannot be used to create NetLb. - VM_AND_FR: The subnetwork can be used for creating both VM instances and Forwarding Rules. It can also be used to reserve IPv6 addresses with both VM and FR endpoint types. Such a subnetwork gets its IPv6 range from Google IP Pool directly. + * [Output Only] Possible endpoints of this subnetwork. It can be one of the + * following: + * - VM_ONLY: The subnetwork can be used for creating instances and + * IPv6 addresses with VM endpoint type. Such a subnetwork gets external IPv6 + * ranges from a public delegated prefix and cannot be used to create NetLb. + * - VM_AND_FR: The subnetwork can be used for creating both VM + * instances and Forwarding Rules. It can also be used to reserve IPv6 + * addresses with both VM and FR endpoint types. Such a subnetwork gets its + * IPv6 range from Google IP Pool directly. * * Protobuf type google.cloud.compute.v1.Subnetwork.Ipv6GceEndpoint */ diff --git a/Compute/src/V1/Subnetwork/PrivateIpv6GoogleAccess.php b/Compute/src/V1/Subnetwork/PrivateIpv6GoogleAccess.php index 3b5aa0159319..3dc0c87a5ae7 100644 --- a/Compute/src/V1/Subnetwork/PrivateIpv6GoogleAccess.php +++ b/Compute/src/V1/Subnetwork/PrivateIpv6GoogleAccess.php @@ -7,7 +7,8 @@ use UnexpectedValueException; /** - * This field is for internal use. This field can be both set at resource creation time and updated using patch. + * This field is for internal use. + * This field can be both set at resource creation time and updated usingpatch. * * Protobuf type google.cloud.compute.v1.Subnetwork.PrivateIpv6GoogleAccess */ diff --git a/Compute/src/V1/Subnetwork/Purpose.php b/Compute/src/V1/Subnetwork/Purpose.php index 9a7df1616f77..fef7059939fd 100644 --- a/Compute/src/V1/Subnetwork/Purpose.php +++ b/Compute/src/V1/Subnetwork/Purpose.php @@ -25,13 +25,16 @@ class Purpose */ const GLOBAL_MANAGED_PROXY = 236463602; /** - * Subnet reserved for Internal HTTP(S) Load Balancing. This is a legacy purpose, please use REGIONAL_MANAGED_PROXY instead. + * Subnet reserved for Internal HTTP(S) Load Balancing. This is a legacy + * purpose, please use REGIONAL_MANAGED_PROXY instead. * * Generated from protobuf enum INTERNAL_HTTPS_LOAD_BALANCER = 248748889; */ const INTERNAL_HTTPS_LOAD_BALANCER = 248748889; /** - * Subnetwork will be used for Migration from one peered VPC to another. (a transient state of subnetwork while migrating resources from one project to another). + * Subnetwork will be used for Migration from one peered VPC to another. + * (a transient state of subnetwork + * while migrating resources from one project to another). * * Generated from protobuf enum PEER_MIGRATION = 491902225; */ diff --git a/Compute/src/V1/Subnetwork/Role.php b/Compute/src/V1/Subnetwork/Role.php index ad6d4ce0ef5e..3e1851a943df 100644 --- a/Compute/src/V1/Subnetwork/Role.php +++ b/Compute/src/V1/Subnetwork/Role.php @@ -7,7 +7,12 @@ use UnexpectedValueException; /** - * The role of subnetwork. Currently, this field is only used when purpose is set to GLOBAL_MANAGED_PROXY or REGIONAL_MANAGED_PROXY. The value can be set to ACTIVE or BACKUP. An ACTIVE subnetwork is one that is currently being used for Envoy-based load balancers in a region. A BACKUP subnetwork is one that is ready to be promoted to ACTIVE or is currently draining. This field can be updated with a patch request. + * The role of subnetwork. Currently, this field is only used when + * purpose is set to GLOBAL_MANAGED_PROXY orREGIONAL_MANAGED_PROXY. The value can be set toACTIVE or BACKUP. An ACTIVE + * subnetwork is one that is currently being used for Envoy-based load + * balancers in a region. A BACKUP subnetwork is one that is + * ready to be promoted to ACTIVE or is currently draining. + * This field can be updated with a patch request. * * Protobuf type google.cloud.compute.v1.Subnetwork.Role */ diff --git a/Compute/src/V1/Subnetwork/StackType.php b/Compute/src/V1/Subnetwork/StackType.php index 2d8a2f456cbb..b5e3fbb07575 100644 --- a/Compute/src/V1/Subnetwork/StackType.php +++ b/Compute/src/V1/Subnetwork/StackType.php @@ -7,7 +7,10 @@ use UnexpectedValueException; /** - * The stack type for the subnet. If set to IPV4_ONLY, new VMs in the subnet are assigned IPv4 addresses only. If set to IPV4_IPV6, new VMs in the subnet can be assigned both IPv4 and IPv6 addresses. If not specified, IPV4_ONLY is used. This field can be both set at resource creation time and updated using patch. + * The stack type for the subnet. If set to IPV4_ONLY, new VMs + * in the subnet are assigned IPv4 addresses only. If set toIPV4_IPV6, new VMs in the subnet can be assigned both IPv4 and + * IPv6 addresses. If not specified, IPV4_ONLY is used. + * This field can be both set at resource creation time and updated usingpatch. * * Protobuf type google.cloud.compute.v1.Subnetwork.StackType */ @@ -32,7 +35,7 @@ class StackType */ const IPV4_ONLY = 22373798; /** - * New VMs in this subnet will only be assigned IPv6 addresses. + * New VMs in this subnet will only be assigned IPv6 addresses. * * Generated from protobuf enum IPV6_ONLY = 79632100; */ diff --git a/Compute/src/V1/Subnetwork/State.php b/Compute/src/V1/Subnetwork/State.php index 7747ab51b23f..2dd8ddf0af15 100644 --- a/Compute/src/V1/Subnetwork/State.php +++ b/Compute/src/V1/Subnetwork/State.php @@ -7,7 +7,11 @@ use UnexpectedValueException; /** - * [Output Only] The state of the subnetwork, which can be one of the following values: READY: Subnetwork is created and ready to use DRAINING: only applicable to subnetworks that have the purpose set to INTERNAL_HTTPS_LOAD_BALANCER and indicates that connections to the load balancer are being drained. A subnetwork that is draining cannot be used or modified until it reaches a status of READY + * [Output Only] The state of the subnetwork, which can be one of the + * following values:READY: Subnetwork is created and ready to useDRAINING: only applicable to subnetworks that have the + * purpose set to INTERNAL_HTTPS_LOAD_BALANCER and indicates that + * connections to the load balancer are being drained. A subnetwork that is + * draining cannot be used or modified until it reaches a status ofREADY * * Protobuf type google.cloud.compute.v1.Subnetwork.State */ diff --git a/Compute/src/V1/SubnetworkAggregatedList.php b/Compute/src/V1/SubnetworkAggregatedList.php index 34013b6cd07f..2dc653a8498a 100644 --- a/Compute/src/V1/SubnetworkAggregatedList.php +++ b/Compute/src/V1/SubnetworkAggregatedList.php @@ -27,13 +27,18 @@ class SubnetworkAggregatedList extends \Google\Protobuf\Internal\Message */ private $items; /** - * [Output Only] Type of resource. Always compute#subnetworkAggregatedList for aggregated lists of subnetworks. + * [Output Only] Type of resource. Alwayscompute#subnetworkAggregatedList for aggregated lists of + * subnetworks. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -68,9 +73,14 @@ class SubnetworkAggregatedList extends \Google\Protobuf\Internal\Message * @type array|\Google\Protobuf\Internal\MapField $items * A list of SubnetworksScopedList resources. * @type string $kind - * [Output Only] Type of resource. Always compute#subnetworkAggregatedList for aggregated lists of subnetworks. + * [Output Only] Type of resource. Alwayscompute#subnetworkAggregatedList for aggregated lists of + * subnetworks. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type array|\Google\Protobuf\Internal\RepeatedField $unreachables @@ -147,7 +157,8 @@ public function setItems($var) } /** - * [Output Only] Type of resource. Always compute#subnetworkAggregatedList for aggregated lists of subnetworks. + * [Output Only] Type of resource. Alwayscompute#subnetworkAggregatedList for aggregated lists of + * subnetworks. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -168,7 +179,8 @@ public function clearKind() } /** - * [Output Only] Type of resource. Always compute#subnetworkAggregatedList for aggregated lists of subnetworks. + * [Output Only] Type of resource. Alwayscompute#subnetworkAggregatedList for aggregated lists of + * subnetworks. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -183,7 +195,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -204,7 +220,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/SubnetworkList.php b/Compute/src/V1/SubnetworkList.php index 725eb88e66ff..2fd3fe202f80 100644 --- a/Compute/src/V1/SubnetworkList.php +++ b/Compute/src/V1/SubnetworkList.php @@ -28,13 +28,18 @@ class SubnetworkList extends \Google\Protobuf\Internal\Message */ private $items; /** - * [Output Only] Type of resource. Always compute#subnetworkList for lists of subnetworks. + * [Output Only] Type of resource. Always compute#subnetworkList + * for lists of subnetworks. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -63,9 +68,14 @@ class SubnetworkList extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\Subnetwork>|\Google\Protobuf\Internal\RepeatedField $items * A list of Subnetwork resources. * @type string $kind - * [Output Only] Type of resource. Always compute#subnetworkList for lists of subnetworks. + * [Output Only] Type of resource. Always compute#subnetworkList + * for lists of subnetworks. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type \Google\Cloud\Compute\V1\Warning $warning @@ -140,7 +150,8 @@ public function setItems($var) } /** - * [Output Only] Type of resource. Always compute#subnetworkList for lists of subnetworks. + * [Output Only] Type of resource. Always compute#subnetworkList + * for lists of subnetworks. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -161,7 +172,8 @@ public function clearKind() } /** - * [Output Only] Type of resource. Always compute#subnetworkList for lists of subnetworks. + * [Output Only] Type of resource. Always compute#subnetworkList + * for lists of subnetworks. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -176,7 +188,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -197,7 +213,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/SubnetworkLogConfig.php b/Compute/src/V1/SubnetworkLogConfig.php index bcf1efaabc3b..c57899124e3d 100644 --- a/Compute/src/V1/SubnetworkLogConfig.php +++ b/Compute/src/V1/SubnetworkLogConfig.php @@ -16,39 +16,57 @@ class SubnetworkLogConfig extends \Google\Protobuf\Internal\Message { /** - * Can only be specified if VPC flow logging for this subnetwork is enabled. Toggles the aggregation interval for collecting flow logs. Increasing the interval time will reduce the amount of generated flow logs for long lasting connections. Default is an interval of 5 seconds per connection. + * Can only be specified if VPC flow logging for this subnetwork is enabled. + * Toggles the aggregation interval for collecting flow logs. Increasing the + * interval time will reduce the amount of generated flow logs for long + * lasting connections. Default is an interval of 5 seconds per connection. * Check the AggregationInterval enum for the list of possible values. * * Generated from protobuf field optional string aggregation_interval = 174919042; */ protected $aggregation_interval = null; /** - * Whether to enable flow logging for this subnetwork. If this field is not explicitly set, it will not appear in get listings. If not set the default behavior is determined by the org policy, if there is no org policy specified, then it will default to disabled. Flow logging isn't supported if the subnet purpose field is set to REGIONAL_MANAGED_PROXY. + * Whether to enable flow logging for this subnetwork. If this field is not + * explicitly set, it will not appear in get listings. If not + * set the default behavior is determined by the org policy, if there is no + * org policy specified, then it will default to disabled. + * Flow logging isn't supported if the subnet purpose field is + * set to REGIONAL_MANAGED_PROXY. * * Generated from protobuf field optional bool enable = 311764355; */ protected $enable = null; /** - * Can only be specified if VPC flow logs for this subnetwork is enabled. The filter expression is used to define which VPC flow logs should be exported to Cloud Logging. + * Can only be specified if VPC flow logs for this subnetwork is enabled. + * The filter expression is used to define which VPC flow logs should be + * exported to Cloud Logging. * * Generated from protobuf field optional string filter_expr = 183374428; */ protected $filter_expr = null; /** - * Can only be specified if VPC flow logging for this subnetwork is enabled. The value of the field must be in [0, 1]. Set the sampling rate of VPC flow logs within the subnetwork where 1.0 means all collected logs are reported and 0.0 means no logs are reported. Default is 0.5 unless otherwise specified by the org policy, which means half of all collected logs are reported. + * Can only be specified if VPC flow logging for this subnetwork is enabled. + * The value of the field must be in [0, 1]. Set the sampling rate of VPC + * flow logs within the subnetwork where 1.0 means all collected logs are + * reported and 0.0 means no logs are reported. Default is 0.5 unless + * otherwise specified by the org policy, which means half of all collected + * logs are reported. * * Generated from protobuf field optional float flow_sampling = 530150360; */ protected $flow_sampling = null; /** - * Can only be specified if VPC flow logs for this subnetwork is enabled. Configures whether all, none or a subset of metadata fields should be added to the reported VPC flow logs. Default is EXCLUDE_ALL_METADATA. + * Can only be specified if VPC flow logs for this subnetwork is enabled. + * Configures whether all, none or a subset of metadata fields should be + * added to the reported VPC flow logs. Default isEXCLUDE_ALL_METADATA. * Check the Metadata enum for the list of possible values. * * Generated from protobuf field optional string metadata = 86866735; */ protected $metadata = null; /** - * Can only be specified if VPC flow logs for this subnetwork is enabled and "metadata" was set to CUSTOM_METADATA. + * Can only be specified if VPC flow logs for this subnetwork is enabled and + * "metadata" was set to CUSTOM_METADATA. * * Generated from protobuf field repeated string metadata_fields = 378461641; */ @@ -61,19 +79,37 @@ class SubnetworkLogConfig extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $aggregation_interval - * Can only be specified if VPC flow logging for this subnetwork is enabled. Toggles the aggregation interval for collecting flow logs. Increasing the interval time will reduce the amount of generated flow logs for long lasting connections. Default is an interval of 5 seconds per connection. + * Can only be specified if VPC flow logging for this subnetwork is enabled. + * Toggles the aggregation interval for collecting flow logs. Increasing the + * interval time will reduce the amount of generated flow logs for long + * lasting connections. Default is an interval of 5 seconds per connection. * Check the AggregationInterval enum for the list of possible values. * @type bool $enable - * Whether to enable flow logging for this subnetwork. If this field is not explicitly set, it will not appear in get listings. If not set the default behavior is determined by the org policy, if there is no org policy specified, then it will default to disabled. Flow logging isn't supported if the subnet purpose field is set to REGIONAL_MANAGED_PROXY. + * Whether to enable flow logging for this subnetwork. If this field is not + * explicitly set, it will not appear in get listings. If not + * set the default behavior is determined by the org policy, if there is no + * org policy specified, then it will default to disabled. + * Flow logging isn't supported if the subnet purpose field is + * set to REGIONAL_MANAGED_PROXY. * @type string $filter_expr - * Can only be specified if VPC flow logs for this subnetwork is enabled. The filter expression is used to define which VPC flow logs should be exported to Cloud Logging. + * Can only be specified if VPC flow logs for this subnetwork is enabled. + * The filter expression is used to define which VPC flow logs should be + * exported to Cloud Logging. * @type float $flow_sampling - * Can only be specified if VPC flow logging for this subnetwork is enabled. The value of the field must be in [0, 1]. Set the sampling rate of VPC flow logs within the subnetwork where 1.0 means all collected logs are reported and 0.0 means no logs are reported. Default is 0.5 unless otherwise specified by the org policy, which means half of all collected logs are reported. + * Can only be specified if VPC flow logging for this subnetwork is enabled. + * The value of the field must be in [0, 1]. Set the sampling rate of VPC + * flow logs within the subnetwork where 1.0 means all collected logs are + * reported and 0.0 means no logs are reported. Default is 0.5 unless + * otherwise specified by the org policy, which means half of all collected + * logs are reported. * @type string $metadata - * Can only be specified if VPC flow logs for this subnetwork is enabled. Configures whether all, none or a subset of metadata fields should be added to the reported VPC flow logs. Default is EXCLUDE_ALL_METADATA. + * Can only be specified if VPC flow logs for this subnetwork is enabled. + * Configures whether all, none or a subset of metadata fields should be + * added to the reported VPC flow logs. Default isEXCLUDE_ALL_METADATA. * Check the Metadata enum for the list of possible values. * @type array|\Google\Protobuf\Internal\RepeatedField $metadata_fields - * Can only be specified if VPC flow logs for this subnetwork is enabled and "metadata" was set to CUSTOM_METADATA. + * Can only be specified if VPC flow logs for this subnetwork is enabled and + * "metadata" was set to CUSTOM_METADATA. * } */ public function __construct($data = NULL) { @@ -82,7 +118,10 @@ public function __construct($data = NULL) { } /** - * Can only be specified if VPC flow logging for this subnetwork is enabled. Toggles the aggregation interval for collecting flow logs. Increasing the interval time will reduce the amount of generated flow logs for long lasting connections. Default is an interval of 5 seconds per connection. + * Can only be specified if VPC flow logging for this subnetwork is enabled. + * Toggles the aggregation interval for collecting flow logs. Increasing the + * interval time will reduce the amount of generated flow logs for long + * lasting connections. Default is an interval of 5 seconds per connection. * Check the AggregationInterval enum for the list of possible values. * * Generated from protobuf field optional string aggregation_interval = 174919042; @@ -104,7 +143,10 @@ public function clearAggregationInterval() } /** - * Can only be specified if VPC flow logging for this subnetwork is enabled. Toggles the aggregation interval for collecting flow logs. Increasing the interval time will reduce the amount of generated flow logs for long lasting connections. Default is an interval of 5 seconds per connection. + * Can only be specified if VPC flow logging for this subnetwork is enabled. + * Toggles the aggregation interval for collecting flow logs. Increasing the + * interval time will reduce the amount of generated flow logs for long + * lasting connections. Default is an interval of 5 seconds per connection. * Check the AggregationInterval enum for the list of possible values. * * Generated from protobuf field optional string aggregation_interval = 174919042; @@ -120,7 +162,12 @@ public function setAggregationInterval($var) } /** - * Whether to enable flow logging for this subnetwork. If this field is not explicitly set, it will not appear in get listings. If not set the default behavior is determined by the org policy, if there is no org policy specified, then it will default to disabled. Flow logging isn't supported if the subnet purpose field is set to REGIONAL_MANAGED_PROXY. + * Whether to enable flow logging for this subnetwork. If this field is not + * explicitly set, it will not appear in get listings. If not + * set the default behavior is determined by the org policy, if there is no + * org policy specified, then it will default to disabled. + * Flow logging isn't supported if the subnet purpose field is + * set to REGIONAL_MANAGED_PROXY. * * Generated from protobuf field optional bool enable = 311764355; * @return bool @@ -141,7 +188,12 @@ public function clearEnable() } /** - * Whether to enable flow logging for this subnetwork. If this field is not explicitly set, it will not appear in get listings. If not set the default behavior is determined by the org policy, if there is no org policy specified, then it will default to disabled. Flow logging isn't supported if the subnet purpose field is set to REGIONAL_MANAGED_PROXY. + * Whether to enable flow logging for this subnetwork. If this field is not + * explicitly set, it will not appear in get listings. If not + * set the default behavior is determined by the org policy, if there is no + * org policy specified, then it will default to disabled. + * Flow logging isn't supported if the subnet purpose field is + * set to REGIONAL_MANAGED_PROXY. * * Generated from protobuf field optional bool enable = 311764355; * @param bool $var @@ -156,7 +208,9 @@ public function setEnable($var) } /** - * Can only be specified if VPC flow logs for this subnetwork is enabled. The filter expression is used to define which VPC flow logs should be exported to Cloud Logging. + * Can only be specified if VPC flow logs for this subnetwork is enabled. + * The filter expression is used to define which VPC flow logs should be + * exported to Cloud Logging. * * Generated from protobuf field optional string filter_expr = 183374428; * @return string @@ -177,7 +231,9 @@ public function clearFilterExpr() } /** - * Can only be specified if VPC flow logs for this subnetwork is enabled. The filter expression is used to define which VPC flow logs should be exported to Cloud Logging. + * Can only be specified if VPC flow logs for this subnetwork is enabled. + * The filter expression is used to define which VPC flow logs should be + * exported to Cloud Logging. * * Generated from protobuf field optional string filter_expr = 183374428; * @param string $var @@ -192,7 +248,12 @@ public function setFilterExpr($var) } /** - * Can only be specified if VPC flow logging for this subnetwork is enabled. The value of the field must be in [0, 1]. Set the sampling rate of VPC flow logs within the subnetwork where 1.0 means all collected logs are reported and 0.0 means no logs are reported. Default is 0.5 unless otherwise specified by the org policy, which means half of all collected logs are reported. + * Can only be specified if VPC flow logging for this subnetwork is enabled. + * The value of the field must be in [0, 1]. Set the sampling rate of VPC + * flow logs within the subnetwork where 1.0 means all collected logs are + * reported and 0.0 means no logs are reported. Default is 0.5 unless + * otherwise specified by the org policy, which means half of all collected + * logs are reported. * * Generated from protobuf field optional float flow_sampling = 530150360; * @return float @@ -213,7 +274,12 @@ public function clearFlowSampling() } /** - * Can only be specified if VPC flow logging for this subnetwork is enabled. The value of the field must be in [0, 1]. Set the sampling rate of VPC flow logs within the subnetwork where 1.0 means all collected logs are reported and 0.0 means no logs are reported. Default is 0.5 unless otherwise specified by the org policy, which means half of all collected logs are reported. + * Can only be specified if VPC flow logging for this subnetwork is enabled. + * The value of the field must be in [0, 1]. Set the sampling rate of VPC + * flow logs within the subnetwork where 1.0 means all collected logs are + * reported and 0.0 means no logs are reported. Default is 0.5 unless + * otherwise specified by the org policy, which means half of all collected + * logs are reported. * * Generated from protobuf field optional float flow_sampling = 530150360; * @param float $var @@ -228,7 +294,9 @@ public function setFlowSampling($var) } /** - * Can only be specified if VPC flow logs for this subnetwork is enabled. Configures whether all, none or a subset of metadata fields should be added to the reported VPC flow logs. Default is EXCLUDE_ALL_METADATA. + * Can only be specified if VPC flow logs for this subnetwork is enabled. + * Configures whether all, none or a subset of metadata fields should be + * added to the reported VPC flow logs. Default isEXCLUDE_ALL_METADATA. * Check the Metadata enum for the list of possible values. * * Generated from protobuf field optional string metadata = 86866735; @@ -250,7 +318,9 @@ public function clearMetadata() } /** - * Can only be specified if VPC flow logs for this subnetwork is enabled. Configures whether all, none or a subset of metadata fields should be added to the reported VPC flow logs. Default is EXCLUDE_ALL_METADATA. + * Can only be specified if VPC flow logs for this subnetwork is enabled. + * Configures whether all, none or a subset of metadata fields should be + * added to the reported VPC flow logs. Default isEXCLUDE_ALL_METADATA. * Check the Metadata enum for the list of possible values. * * Generated from protobuf field optional string metadata = 86866735; @@ -266,7 +336,8 @@ public function setMetadata($var) } /** - * Can only be specified if VPC flow logs for this subnetwork is enabled and "metadata" was set to CUSTOM_METADATA. + * Can only be specified if VPC flow logs for this subnetwork is enabled and + * "metadata" was set to CUSTOM_METADATA. * * Generated from protobuf field repeated string metadata_fields = 378461641; * @return \Google\Protobuf\Internal\RepeatedField @@ -277,7 +348,8 @@ public function getMetadataFields() } /** - * Can only be specified if VPC flow logs for this subnetwork is enabled and "metadata" was set to CUSTOM_METADATA. + * Can only be specified if VPC flow logs for this subnetwork is enabled and + * "metadata" was set to CUSTOM_METADATA. * * Generated from protobuf field repeated string metadata_fields = 378461641; * @param array|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/SubnetworkLogConfig/AggregationInterval.php b/Compute/src/V1/SubnetworkLogConfig/AggregationInterval.php index eee6c1248c4b..a55ef135eb59 100644 --- a/Compute/src/V1/SubnetworkLogConfig/AggregationInterval.php +++ b/Compute/src/V1/SubnetworkLogConfig/AggregationInterval.php @@ -7,7 +7,10 @@ use UnexpectedValueException; /** - * Can only be specified if VPC flow logging for this subnetwork is enabled. Toggles the aggregation interval for collecting flow logs. Increasing the interval time will reduce the amount of generated flow logs for long lasting connections. Default is an interval of 5 seconds per connection. + * Can only be specified if VPC flow logging for this subnetwork is enabled. + * Toggles the aggregation interval for collecting flow logs. Increasing the + * interval time will reduce the amount of generated flow logs for long + * lasting connections. Default is an interval of 5 seconds per connection. * * Protobuf type google.cloud.compute.v1.SubnetworkLogConfig.AggregationInterval */ diff --git a/Compute/src/V1/SubnetworkLogConfig/Metadata.php b/Compute/src/V1/SubnetworkLogConfig/Metadata.php index f69346a93791..2328018f5de5 100644 --- a/Compute/src/V1/SubnetworkLogConfig/Metadata.php +++ b/Compute/src/V1/SubnetworkLogConfig/Metadata.php @@ -7,7 +7,9 @@ use UnexpectedValueException; /** - * Can only be specified if VPC flow logs for this subnetwork is enabled. Configures whether all, none or a subset of metadata fields should be added to the reported VPC flow logs. Default is EXCLUDE_ALL_METADATA. + * Can only be specified if VPC flow logs for this subnetwork is enabled. + * Configures whether all, none or a subset of metadata fields should be + * added to the reported VPC flow logs. Default isEXCLUDE_ALL_METADATA. * * Protobuf type google.cloud.compute.v1.SubnetworkLogConfig.Metadata */ diff --git a/Compute/src/V1/SubnetworkParams.php b/Compute/src/V1/SubnetworkParams.php index d37e893ba27a..409aad1df9ba 100644 --- a/Compute/src/V1/SubnetworkParams.php +++ b/Compute/src/V1/SubnetworkParams.php @@ -16,7 +16,18 @@ class SubnetworkParams extends \Google\Protobuf\Internal\Message { /** - * Tag keys/values directly bound to this resource. Tag keys and values have the same definition as resource manager tags. The field is allowed for INSERT only. The keys/values to set on the resource should be specified in either ID { : } or Namespaced format { : }. For example the following are valid inputs: * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} * {"123/environment" : "production", "345/abc" : "xyz"} Note: * Invalid combinations of ID & namespaced format is not supported. For instance: {"123/environment" : "tagValues/444"} is invalid. + * Tag keys/values directly bound to this resource. + * Tag keys and values have the same definition as resource + * manager tags. The field is allowed for INSERT + * only. The keys/values to set on the resource should be specified in + * either ID { : } or Namespaced format + * { : }. + * For example the following are valid inputs: + * * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} + * * {"123/environment" : "production", "345/abc" : "xyz"} + * Note: + * * Invalid combinations of ID & namespaced format is not supported. For + * instance: {"123/environment" : "tagValues/444"} is invalid. * * Generated from protobuf field map resource_manager_tags = 377671164; */ @@ -29,7 +40,18 @@ class SubnetworkParams extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type array|\Google\Protobuf\Internal\MapField $resource_manager_tags - * Tag keys/values directly bound to this resource. Tag keys and values have the same definition as resource manager tags. The field is allowed for INSERT only. The keys/values to set on the resource should be specified in either ID { : } or Namespaced format { : }. For example the following are valid inputs: * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} * {"123/environment" : "production", "345/abc" : "xyz"} Note: * Invalid combinations of ID & namespaced format is not supported. For instance: {"123/environment" : "tagValues/444"} is invalid. + * Tag keys/values directly bound to this resource. + * Tag keys and values have the same definition as resource + * manager tags. The field is allowed for INSERT + * only. The keys/values to set on the resource should be specified in + * either ID { : } or Namespaced format + * { : }. + * For example the following are valid inputs: + * * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} + * * {"123/environment" : "production", "345/abc" : "xyz"} + * Note: + * * Invalid combinations of ID & namespaced format is not supported. For + * instance: {"123/environment" : "tagValues/444"} is invalid. * } */ public function __construct($data = NULL) { @@ -38,7 +60,18 @@ public function __construct($data = NULL) { } /** - * Tag keys/values directly bound to this resource. Tag keys and values have the same definition as resource manager tags. The field is allowed for INSERT only. The keys/values to set on the resource should be specified in either ID { : } or Namespaced format { : }. For example the following are valid inputs: * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} * {"123/environment" : "production", "345/abc" : "xyz"} Note: * Invalid combinations of ID & namespaced format is not supported. For instance: {"123/environment" : "tagValues/444"} is invalid. + * Tag keys/values directly bound to this resource. + * Tag keys and values have the same definition as resource + * manager tags. The field is allowed for INSERT + * only. The keys/values to set on the resource should be specified in + * either ID { : } or Namespaced format + * { : }. + * For example the following are valid inputs: + * * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} + * * {"123/environment" : "production", "345/abc" : "xyz"} + * Note: + * * Invalid combinations of ID & namespaced format is not supported. For + * instance: {"123/environment" : "tagValues/444"} is invalid. * * Generated from protobuf field map resource_manager_tags = 377671164; * @return \Google\Protobuf\Internal\MapField @@ -49,7 +82,18 @@ public function getResourceManagerTags() } /** - * Tag keys/values directly bound to this resource. Tag keys and values have the same definition as resource manager tags. The field is allowed for INSERT only. The keys/values to set on the resource should be specified in either ID { : } or Namespaced format { : }. For example the following are valid inputs: * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} * {"123/environment" : "production", "345/abc" : "xyz"} Note: * Invalid combinations of ID & namespaced format is not supported. For instance: {"123/environment" : "tagValues/444"} is invalid. + * Tag keys/values directly bound to this resource. + * Tag keys and values have the same definition as resource + * manager tags. The field is allowed for INSERT + * only. The keys/values to set on the resource should be specified in + * either ID { : } or Namespaced format + * { : }. + * For example the following are valid inputs: + * * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} + * * {"123/environment" : "production", "345/abc" : "xyz"} + * Note: + * * Invalid combinations of ID & namespaced format is not supported. For + * instance: {"123/environment" : "tagValues/444"} is invalid. * * Generated from protobuf field map resource_manager_tags = 377671164; * @param array|\Google\Protobuf\Internal\MapField $var diff --git a/Compute/src/V1/SubnetworkSecondaryRange.php b/Compute/src/V1/SubnetworkSecondaryRange.php index 10393c73ffbb..7be968647cc0 100644 --- a/Compute/src/V1/SubnetworkSecondaryRange.php +++ b/Compute/src/V1/SubnetworkSecondaryRange.php @@ -16,13 +16,21 @@ class SubnetworkSecondaryRange extends \Google\Protobuf\Internal\Message { /** - * The range of IP addresses belonging to this subnetwork secondary range. Provide this property when you create the subnetwork. Ranges must be unique and non-overlapping with all primary and secondary IP ranges within a network. Only IPv4 is supported. The range can be any range listed in the Valid ranges list. + * The range of IP addresses belonging to this subnetwork secondary range. + * Provide this property when you create the subnetwork. Ranges must be + * unique and non-overlapping with all primary and secondary IP ranges + * within a network. Only IPv4 is supported. The range can be any range + * listed in theValid + * ranges list. * * Generated from protobuf field optional string ip_cidr_range = 98117322; */ protected $ip_cidr_range = null; /** - * The name associated with this subnetwork secondary range, used when adding an alias IP range to a VM instance. The name must be 1-63 characters long, and comply with RFC1035. The name must be unique within the subnetwork. + * The name associated with this subnetwork secondary range, used when adding + * an alias IP range to a VM instance. + * The name must be 1-63 characters long, and comply withRFC1035. + * The name must be unique within the subnetwork. * * Generated from protobuf field optional string range_name = 332216397; */ @@ -41,9 +49,17 @@ class SubnetworkSecondaryRange extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $ip_cidr_range - * The range of IP addresses belonging to this subnetwork secondary range. Provide this property when you create the subnetwork. Ranges must be unique and non-overlapping with all primary and secondary IP ranges within a network. Only IPv4 is supported. The range can be any range listed in the Valid ranges list. + * The range of IP addresses belonging to this subnetwork secondary range. + * Provide this property when you create the subnetwork. Ranges must be + * unique and non-overlapping with all primary and secondary IP ranges + * within a network. Only IPv4 is supported. The range can be any range + * listed in theValid + * ranges list. * @type string $range_name - * The name associated with this subnetwork secondary range, used when adding an alias IP range to a VM instance. The name must be 1-63 characters long, and comply with RFC1035. The name must be unique within the subnetwork. + * The name associated with this subnetwork secondary range, used when adding + * an alias IP range to a VM instance. + * The name must be 1-63 characters long, and comply withRFC1035. + * The name must be unique within the subnetwork. * @type string $reserved_internal_range * The URL of the reserved internal range. * } @@ -54,7 +70,12 @@ public function __construct($data = NULL) { } /** - * The range of IP addresses belonging to this subnetwork secondary range. Provide this property when you create the subnetwork. Ranges must be unique and non-overlapping with all primary and secondary IP ranges within a network. Only IPv4 is supported. The range can be any range listed in the Valid ranges list. + * The range of IP addresses belonging to this subnetwork secondary range. + * Provide this property when you create the subnetwork. Ranges must be + * unique and non-overlapping with all primary and secondary IP ranges + * within a network. Only IPv4 is supported. The range can be any range + * listed in theValid + * ranges list. * * Generated from protobuf field optional string ip_cidr_range = 98117322; * @return string @@ -75,7 +96,12 @@ public function clearIpCidrRange() } /** - * The range of IP addresses belonging to this subnetwork secondary range. Provide this property when you create the subnetwork. Ranges must be unique and non-overlapping with all primary and secondary IP ranges within a network. Only IPv4 is supported. The range can be any range listed in the Valid ranges list. + * The range of IP addresses belonging to this subnetwork secondary range. + * Provide this property when you create the subnetwork. Ranges must be + * unique and non-overlapping with all primary and secondary IP ranges + * within a network. Only IPv4 is supported. The range can be any range + * listed in theValid + * ranges list. * * Generated from protobuf field optional string ip_cidr_range = 98117322; * @param string $var @@ -90,7 +116,10 @@ public function setIpCidrRange($var) } /** - * The name associated with this subnetwork secondary range, used when adding an alias IP range to a VM instance. The name must be 1-63 characters long, and comply with RFC1035. The name must be unique within the subnetwork. + * The name associated with this subnetwork secondary range, used when adding + * an alias IP range to a VM instance. + * The name must be 1-63 characters long, and comply withRFC1035. + * The name must be unique within the subnetwork. * * Generated from protobuf field optional string range_name = 332216397; * @return string @@ -111,7 +140,10 @@ public function clearRangeName() } /** - * The name associated with this subnetwork secondary range, used when adding an alias IP range to a VM instance. The name must be 1-63 characters long, and comply with RFC1035. The name must be unique within the subnetwork. + * The name associated with this subnetwork secondary range, used when adding + * an alias IP range to a VM instance. + * The name must be 1-63 characters long, and comply withRFC1035. + * The name must be unique within the subnetwork. * * Generated from protobuf field optional string range_name = 332216397; * @param string $var diff --git a/Compute/src/V1/SubnetworkUtilizationDetails.php b/Compute/src/V1/SubnetworkUtilizationDetails.php index eb175fcdb7a8..5d344759d8a9 100644 --- a/Compute/src/V1/SubnetworkUtilizationDetails.php +++ b/Compute/src/V1/SubnetworkUtilizationDetails.php @@ -9,7 +9,8 @@ use Google\Protobuf\Internal\GPBUtil; /** - * The current IP utilization of all subnetwork ranges. Contains the total number of allocated and free IPs in each range. + * The current IP utilization of all subnetwork ranges. Contains the total + * number of allocated and free IPs in each range. * * Generated from protobuf message google.cloud.compute.v1.SubnetworkUtilizationDetails */ @@ -34,7 +35,8 @@ class SubnetworkUtilizationDetails extends \Google\Protobuf\Internal\Message */ protected $internal_ipv6_utilization = null; /** - * Utilizations of all IPV4 IP ranges. For primary ranges, the range name will be empty. + * Utilizations of all IPV4 IP ranges. For primary ranges, the range name + * will be empty. * * Generated from protobuf field repeated .google.cloud.compute.v1.SubnetworkUtilizationDetailsIPV4Utilization ipv4_utilizations = 206180011; */ @@ -53,7 +55,8 @@ class SubnetworkUtilizationDetails extends \Google\Protobuf\Internal\Message * @type \Google\Cloud\Compute\V1\SubnetworkUtilizationDetailsIPV6Utilization $internal_ipv6_utilization * Utilizations of internal IPV6 IP range. * @type array<\Google\Cloud\Compute\V1\SubnetworkUtilizationDetailsIPV4Utilization>|\Google\Protobuf\Internal\RepeatedField $ipv4_utilizations - * Utilizations of all IPV4 IP ranges. For primary ranges, the range name will be empty. + * Utilizations of all IPV4 IP ranges. For primary ranges, the range name + * will be empty. * } */ public function __construct($data = NULL) { @@ -170,7 +173,8 @@ public function setInternalIpv6Utilization($var) } /** - * Utilizations of all IPV4 IP ranges. For primary ranges, the range name will be empty. + * Utilizations of all IPV4 IP ranges. For primary ranges, the range name + * will be empty. * * Generated from protobuf field repeated .google.cloud.compute.v1.SubnetworkUtilizationDetailsIPV4Utilization ipv4_utilizations = 206180011; * @return \Google\Protobuf\Internal\RepeatedField @@ -181,7 +185,8 @@ public function getIpv4Utilizations() } /** - * Utilizations of all IPV4 IP ranges. For primary ranges, the range name will be empty. + * Utilizations of all IPV4 IP ranges. For primary ranges, the range name + * will be empty. * * Generated from protobuf field repeated .google.cloud.compute.v1.SubnetworkUtilizationDetailsIPV4Utilization ipv4_utilizations = 206180011; * @param array<\Google\Cloud\Compute\V1\SubnetworkUtilizationDetailsIPV4Utilization>|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/SubnetworksExpandIpCidrRangeRequest.php b/Compute/src/V1/SubnetworksExpandIpCidrRangeRequest.php index f796448a2570..936253c949fd 100644 --- a/Compute/src/V1/SubnetworksExpandIpCidrRangeRequest.php +++ b/Compute/src/V1/SubnetworksExpandIpCidrRangeRequest.php @@ -15,7 +15,10 @@ class SubnetworksExpandIpCidrRangeRequest extends \Google\Protobuf\Internal\Message { /** - * The IP (in CIDR format or netmask) of internal addresses that are legal on this Subnetwork. This range should be disjoint from other subnetworks within this network. This range can only be larger than (i.e. a superset of) the range previously defined before the update. + * The IP (in CIDR format or netmask) of internal addresses that are legal on + * this Subnetwork. This range should be disjoint from other subnetworks + * within this network. This range can only be larger than (i.e. a superset + * of) the range previously defined before the update. * * Generated from protobuf field optional string ip_cidr_range = 98117322; */ @@ -28,7 +31,10 @@ class SubnetworksExpandIpCidrRangeRequest extends \Google\Protobuf\Internal\Mess * Optional. Data for populating the Message object. * * @type string $ip_cidr_range - * The IP (in CIDR format or netmask) of internal addresses that are legal on this Subnetwork. This range should be disjoint from other subnetworks within this network. This range can only be larger than (i.e. a superset of) the range previously defined before the update. + * The IP (in CIDR format or netmask) of internal addresses that are legal on + * this Subnetwork. This range should be disjoint from other subnetworks + * within this network. This range can only be larger than (i.e. a superset + * of) the range previously defined before the update. * } */ public function __construct($data = NULL) { @@ -37,7 +43,10 @@ public function __construct($data = NULL) { } /** - * The IP (in CIDR format or netmask) of internal addresses that are legal on this Subnetwork. This range should be disjoint from other subnetworks within this network. This range can only be larger than (i.e. a superset of) the range previously defined before the update. + * The IP (in CIDR format or netmask) of internal addresses that are legal on + * this Subnetwork. This range should be disjoint from other subnetworks + * within this network. This range can only be larger than (i.e. a superset + * of) the range previously defined before the update. * * Generated from protobuf field optional string ip_cidr_range = 98117322; * @return string @@ -58,7 +67,10 @@ public function clearIpCidrRange() } /** - * The IP (in CIDR format or netmask) of internal addresses that are legal on this Subnetwork. This range should be disjoint from other subnetworks within this network. This range can only be larger than (i.e. a superset of) the range previously defined before the update. + * The IP (in CIDR format or netmask) of internal addresses that are legal on + * this Subnetwork. This range should be disjoint from other subnetworks + * within this network. This range can only be larger than (i.e. a superset + * of) the range previously defined before the update. * * Generated from protobuf field optional string ip_cidr_range = 98117322; * @param string $var diff --git a/Compute/src/V1/SubnetworksScopedList.php b/Compute/src/V1/SubnetworksScopedList.php index 49a27c4befea..70fa8cd2d4de 100644 --- a/Compute/src/V1/SubnetworksScopedList.php +++ b/Compute/src/V1/SubnetworksScopedList.php @@ -21,7 +21,8 @@ class SubnetworksScopedList extends \Google\Protobuf\Internal\Message */ private $subnetworks; /** - * An informational warning that appears when the list of addresses is empty. + * An informational warning that appears when the list of addresses + * is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; */ @@ -36,7 +37,8 @@ class SubnetworksScopedList extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\Subnetwork>|\Google\Protobuf\Internal\RepeatedField $subnetworks * A list of subnetworks contained in this scope. * @type \Google\Cloud\Compute\V1\Warning $warning - * An informational warning that appears when the list of addresses is empty. + * An informational warning that appears when the list of addresses + * is empty. * } */ public function __construct($data = NULL) { @@ -71,7 +73,8 @@ public function setSubnetworks($var) } /** - * An informational warning that appears when the list of addresses is empty. + * An informational warning that appears when the list of addresses + * is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; * @return \Google\Cloud\Compute\V1\Warning|null @@ -92,7 +95,8 @@ public function clearWarning() } /** - * An informational warning that appears when the list of addresses is empty. + * An informational warning that appears when the list of addresses + * is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; * @param \Google\Cloud\Compute\V1\Warning $var diff --git a/Compute/src/V1/Subsetting.php b/Compute/src/V1/Subsetting.php index 17341e1e7281..e2ce730be51c 100644 --- a/Compute/src/V1/Subsetting.php +++ b/Compute/src/V1/Subsetting.php @@ -9,7 +9,9 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Subsetting configuration for this BackendService. Currently this is applicable only for Internal TCP/UDP load balancing, Internal HTTP(S) load balancing and Traffic Director. + * Subsetting configuration for this BackendService. + * Currently this is applicable only for Internal TCP/UDP load balancing, + * Internal HTTP(S) load balancing and Traffic Director. * * Generated from protobuf message google.cloud.compute.v1.Subsetting */ diff --git a/Compute/src/V1/Subsetting/Policy.php b/Compute/src/V1/Subsetting/Policy.php index 494c393ee0f8..920870097cf2 100644 --- a/Compute/src/V1/Subsetting/Policy.php +++ b/Compute/src/V1/Subsetting/Policy.php @@ -19,13 +19,25 @@ class Policy */ const UNDEFINED_POLICY = 0; /** - * Subsetting based on consistent hashing. For Traffic Director, the number of backends per backend group (the subset size) is based on the `subset_size` parameter. For Internal HTTP(S) load balancing, the number of backends per backend group (the subset size) is dynamically adjusted in two cases: - As the number of proxy instances participating in Internal HTTP(S) load balancing increases, the subset size decreases. - When the total number of backends in a network exceeds the capacity of a single proxy instance, subset sizes are reduced automatically for each service that has backend subsetting enabled. + * Subsetting based on consistent hashing. + * For Traffic Director, the number of backends per backend group + * (the subset size) is based on the `subset_size` parameter. + * For Internal HTTP(S) load balancing, the number of backends per backend + * group (the subset size) is dynamically adjusted in two cases: + * - As the number of proxy instances participating in Internal HTTP(S) load + * balancing increases, the subset size decreases. + * - When the total number of backends in a network exceeds the capacity of + * a single proxy instance, subset sizes are reduced automatically for + * each service that has backend subsetting enabled. * * Generated from protobuf enum CONSISTENT_HASH_SUBSETTING = 108989492; */ const CONSISTENT_HASH_SUBSETTING = 108989492; /** - * No Subsetting. Clients may open connections and send traffic to all backends of this backend service. This can lead to performance issues if there is substantial imbalance in the count of clients and backends. + * No Subsetting. + * Clients may open connections and send traffic to all backends of this + * backend service. This can lead to performance issues if there is + * substantial imbalance in the count of clients and backends. * * Generated from protobuf enum NONE = 2402104; */ diff --git a/Compute/src/V1/SuspendInstanceRequest.php b/Compute/src/V1/SuspendInstanceRequest.php index 6d761a393d3a..d665d00746f8 100644 --- a/Compute/src/V1/SuspendInstanceRequest.php +++ b/Compute/src/V1/SuspendInstanceRequest.php @@ -16,7 +16,9 @@ class SuspendInstanceRequest extends \Google\Protobuf\Internal\Message { /** - * This property is required if the instance has any attached Local SSD disks. If false, Local SSD data will be preserved when the instance is suspended. If true, the contents of any attached Local SSD disks will be discarded. + * This property is required if the instance has any attached Local SSD disks. + * If false, Local SSD data will be preserved when the instance is suspended. + * If true, the contents of any attached Local SSD disks will be discarded. * * Generated from protobuf field optional bool discard_local_ssd = 319517903; */ @@ -34,7 +36,17 @@ class SuspendInstanceRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -70,13 +82,25 @@ public static function build(string $project, string $zone, string $instance): s * Optional. Data for populating the Message object. * * @type bool $discard_local_ssd - * This property is required if the instance has any attached Local SSD disks. If false, Local SSD data will be preserved when the instance is suspended. If true, the contents of any attached Local SSD disks will be discarded. + * This property is required if the instance has any attached Local SSD disks. + * If false, Local SSD data will be preserved when the instance is suspended. + * If true, the contents of any attached Local SSD disks will be discarded. * @type string $instance * Name of the instance resource to suspend. * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $zone * The name of the zone for this request. * } @@ -87,7 +111,9 @@ public function __construct($data = NULL) { } /** - * This property is required if the instance has any attached Local SSD disks. If false, Local SSD data will be preserved when the instance is suspended. If true, the contents of any attached Local SSD disks will be discarded. + * This property is required if the instance has any attached Local SSD disks. + * If false, Local SSD data will be preserved when the instance is suspended. + * If true, the contents of any attached Local SSD disks will be discarded. * * Generated from protobuf field optional bool discard_local_ssd = 319517903; * @return bool @@ -108,7 +134,9 @@ public function clearDiscardLocalSsd() } /** - * This property is required if the instance has any attached Local SSD disks. If false, Local SSD data will be preserved when the instance is suspended. If true, the contents of any attached Local SSD disks will be discarded. + * This property is required if the instance has any attached Local SSD disks. + * If false, Local SSD data will be preserved when the instance is suspended. + * If true, the contents of any attached Local SSD disks will be discarded. * * Generated from protobuf field optional bool discard_local_ssd = 319517903; * @param bool $var @@ -175,7 +203,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -196,7 +234,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/SuspendInstancesInstanceGroupManagerRequest.php b/Compute/src/V1/SuspendInstancesInstanceGroupManagerRequest.php index 8a40ecc82af6..507d70313420 100644 --- a/Compute/src/V1/SuspendInstancesInstanceGroupManagerRequest.php +++ b/Compute/src/V1/SuspendInstancesInstanceGroupManagerRequest.php @@ -34,13 +34,24 @@ class SuspendInstancesInstanceGroupManagerRequest extends \Google\Protobuf\Inter */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ protected $request_id = null; /** - * The name of the zone where the managed instance group is located. + * The name of thezone where the managed + * instance group is located. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; */ @@ -48,7 +59,8 @@ class SuspendInstancesInstanceGroupManagerRequest extends \Google\Protobuf\Inter /** * @param string $project Project ID for this request. - * @param string $zone The name of the zone where the managed instance group is located. + * @param string $zone The name of thezone where the managed + * instance group is located. * @param string $instanceGroupManager The name of the managed instance group. * @param \Google\Cloud\Compute\V1\InstanceGroupManagersSuspendInstancesRequest $instanceGroupManagersSuspendInstancesRequestResource The body resource for this request * @@ -78,9 +90,20 @@ public static function build(string $project, string $zone, string $instanceGrou * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $zone - * The name of the zone where the managed instance group is located. + * The name of thezone where the managed + * instance group is located. * } */ public function __construct($data = NULL) { @@ -177,7 +200,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -198,7 +231,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var @@ -213,7 +256,8 @@ public function setRequestId($var) } /** - * The name of the zone where the managed instance group is located. + * The name of thezone where the managed + * instance group is located. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; * @return string @@ -224,7 +268,8 @@ public function getZone() } /** - * The name of the zone where the managed instance group is located. + * The name of thezone where the managed + * instance group is located. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; * @param string $var diff --git a/Compute/src/V1/SuspendInstancesRegionInstanceGroupManagerRequest.php b/Compute/src/V1/SuspendInstancesRegionInstanceGroupManagerRequest.php index aae80c4f8576..d0808435e39a 100644 --- a/Compute/src/V1/SuspendInstancesRegionInstanceGroupManagerRequest.php +++ b/Compute/src/V1/SuspendInstancesRegionInstanceGroupManagerRequest.php @@ -40,7 +40,17 @@ class SuspendInstancesRegionInstanceGroupManagerRequest extends \Google\Protobuf */ protected $region_instance_group_managers_suspend_instances_request_resource = null; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -80,7 +90,17 @@ public static function build(string $project, string $region, string $instanceGr * @type \Google\Cloud\Compute\V1\RegionInstanceGroupManagersSuspendInstancesRequest $region_instance_group_managers_suspend_instances_request_resource * The body resource for this request * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -203,7 +223,17 @@ public function setRegionInstanceGroupManagersSuspendInstancesRequestResource($v } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -224,7 +254,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/SwitchToCustomModeNetworkRequest.php b/Compute/src/V1/SwitchToCustomModeNetworkRequest.php index 4bcc09376f8c..cfea4c8b182d 100644 --- a/Compute/src/V1/SwitchToCustomModeNetworkRequest.php +++ b/Compute/src/V1/SwitchToCustomModeNetworkRequest.php @@ -28,7 +28,17 @@ class SwitchToCustomModeNetworkRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -60,7 +70,17 @@ public static function build(string $project, string $network): self * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -121,7 +141,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -142,7 +172,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/TCPHealthCheck.php b/Compute/src/V1/TCPHealthCheck.php index 3324f5329561..cac6a8f115e2 100644 --- a/Compute/src/V1/TCPHealthCheck.php +++ b/Compute/src/V1/TCPHealthCheck.php @@ -15,7 +15,8 @@ class TCPHealthCheck extends \Google\Protobuf\Internal\Message { /** - * The TCP port number to which the health check prober sends packets. The default value is 80. Valid values are 1 through 65535. + * The TCP port number to which the health check prober sends packets. The + * default value is 80. Valid values are 1 through65535. * * Generated from protobuf field optional int32 port = 3446913; */ @@ -27,27 +28,54 @@ class TCPHealthCheck extends \Google\Protobuf\Internal\Message */ protected $port_name = null; /** - * Specifies how a port is selected for health checking. Can be one of the following values: USE_FIXED_PORT: Specifies a port number explicitly using the port field in the health check. Supported by backend services for passthrough load balancers and backend services for proxy load balancers. Not supported by target pools. The health check supports all backends supported by the backend service provided the backend can be health checked. For example, GCE_VM_IP network endpoint groups, GCE_VM_IP_PORT network endpoint groups, and instance group backends. USE_NAMED_PORT: Not supported. USE_SERVING_PORT: Provides an indirect method of specifying the health check port by referring to the backend service. Only supported by backend services for proxy load balancers. Not supported by target pools. Not supported by backend services for passthrough load balancers. Supports all backends that can be health checked; for example, GCE_VM_IP_PORT network endpoint groups and instance group backends. For GCE_VM_IP_PORT network endpoint group backends, the health check uses the port number specified for each endpoint in the network endpoint group. For instance group backends, the health check uses the port number determined by looking up the backend service's named port in the instance group's list of named ports. + * Specifies how a port is selected for health checking. Can be one of the + * following values: + * USE_FIXED_PORT: Specifies a port number explicitly using theport field in the health check. Supported by backend services + * for passthrough load balancers and backend services for proxy load + * balancers. Not supported by target pools. The health check supports all + * backends supported by the backend service provided the backend can be + * health checked. For example, GCE_VM_IP network endpoint + * groups, GCE_VM_IP_PORT network endpoint groups, and instance + * group backends. + * USE_NAMED_PORT: Not supported. + * USE_SERVING_PORT: Provides an indirect method of specifying + * the health check port by referring to the backend service. Only supported + * by backend services for proxy load balancers. Not supported by target + * pools. Not supported by backend services for passthrough load balancers. + * Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group + * backends. + * For GCE_VM_IP_PORT network endpoint group backends, the health + * check uses the port number specified for each endpoint in the network + * endpoint group. For instance group backends, the health check uses the + * port number determined by looking up the backend service's named port in + * the instance group's list of named ports. * Check the PortSpecification enum for the list of possible values. * * Generated from protobuf field optional string port_specification = 51590597; */ protected $port_specification = null; /** - * Specifies the type of proxy header to append before sending data to the backend, either NONE or PROXY_V1. The default is NONE. + * Specifies the type of proxy header to append before sending data to the + * backend, either NONE or PROXY_V1. The default + * is NONE. * Check the ProxyHeader enum for the list of possible values. * * Generated from protobuf field optional string proxy_header = 160374142; */ protected $proxy_header = null; /** - * Instructs the health check prober to send this exact ASCII string, up to 1024 bytes in length, after establishing the TCP connection. + * Instructs the health check prober to send this exact ASCII string, up to + * 1024 bytes in length, after establishing the TCP connection. * * Generated from protobuf field optional string request = 21951119; */ protected $request = null; /** - * Creates a content-based TCP health check. In addition to establishing a TCP connection, you can configure the health check to pass only when the backend sends this exact response ASCII string, up to 1024 bytes in length. For details, see: https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-ssl-tcp + * Creates a content-based TCP health check. In addition to establishing a + * TCP connection, you can configure the health check to pass only when the + * backend sends this exact response ASCII string, up to 1024 bytes in length. + * For details, see: + * https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-ssl-tcp * * Generated from protobuf field optional string response = 196547649; */ @@ -60,19 +88,47 @@ class TCPHealthCheck extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type int $port - * The TCP port number to which the health check prober sends packets. The default value is 80. Valid values are 1 through 65535. + * The TCP port number to which the health check prober sends packets. The + * default value is 80. Valid values are 1 through65535. * @type string $port_name * Not supported. * @type string $port_specification - * Specifies how a port is selected for health checking. Can be one of the following values: USE_FIXED_PORT: Specifies a port number explicitly using the port field in the health check. Supported by backend services for passthrough load balancers and backend services for proxy load balancers. Not supported by target pools. The health check supports all backends supported by the backend service provided the backend can be health checked. For example, GCE_VM_IP network endpoint groups, GCE_VM_IP_PORT network endpoint groups, and instance group backends. USE_NAMED_PORT: Not supported. USE_SERVING_PORT: Provides an indirect method of specifying the health check port by referring to the backend service. Only supported by backend services for proxy load balancers. Not supported by target pools. Not supported by backend services for passthrough load balancers. Supports all backends that can be health checked; for example, GCE_VM_IP_PORT network endpoint groups and instance group backends. For GCE_VM_IP_PORT network endpoint group backends, the health check uses the port number specified for each endpoint in the network endpoint group. For instance group backends, the health check uses the port number determined by looking up the backend service's named port in the instance group's list of named ports. + * Specifies how a port is selected for health checking. Can be one of the + * following values: + * USE_FIXED_PORT: Specifies a port number explicitly using theport field in the health check. Supported by backend services + * for passthrough load balancers and backend services for proxy load + * balancers. Not supported by target pools. The health check supports all + * backends supported by the backend service provided the backend can be + * health checked. For example, GCE_VM_IP network endpoint + * groups, GCE_VM_IP_PORT network endpoint groups, and instance + * group backends. + * USE_NAMED_PORT: Not supported. + * USE_SERVING_PORT: Provides an indirect method of specifying + * the health check port by referring to the backend service. Only supported + * by backend services for proxy load balancers. Not supported by target + * pools. Not supported by backend services for passthrough load balancers. + * Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group + * backends. + * For GCE_VM_IP_PORT network endpoint group backends, the health + * check uses the port number specified for each endpoint in the network + * endpoint group. For instance group backends, the health check uses the + * port number determined by looking up the backend service's named port in + * the instance group's list of named ports. * Check the PortSpecification enum for the list of possible values. * @type string $proxy_header - * Specifies the type of proxy header to append before sending data to the backend, either NONE or PROXY_V1. The default is NONE. + * Specifies the type of proxy header to append before sending data to the + * backend, either NONE or PROXY_V1. The default + * is NONE. * Check the ProxyHeader enum for the list of possible values. * @type string $request - * Instructs the health check prober to send this exact ASCII string, up to 1024 bytes in length, after establishing the TCP connection. + * Instructs the health check prober to send this exact ASCII string, up to + * 1024 bytes in length, after establishing the TCP connection. * @type string $response - * Creates a content-based TCP health check. In addition to establishing a TCP connection, you can configure the health check to pass only when the backend sends this exact response ASCII string, up to 1024 bytes in length. For details, see: https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-ssl-tcp + * Creates a content-based TCP health check. In addition to establishing a + * TCP connection, you can configure the health check to pass only when the + * backend sends this exact response ASCII string, up to 1024 bytes in length. + * For details, see: + * https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-ssl-tcp * } */ public function __construct($data = NULL) { @@ -81,7 +137,8 @@ public function __construct($data = NULL) { } /** - * The TCP port number to which the health check prober sends packets. The default value is 80. Valid values are 1 through 65535. + * The TCP port number to which the health check prober sends packets. The + * default value is 80. Valid values are 1 through65535. * * Generated from protobuf field optional int32 port = 3446913; * @return int @@ -102,7 +159,8 @@ public function clearPort() } /** - * The TCP port number to which the health check prober sends packets. The default value is 80. Valid values are 1 through 65535. + * The TCP port number to which the health check prober sends packets. The + * default value is 80. Valid values are 1 through65535. * * Generated from protobuf field optional int32 port = 3446913; * @param int $var @@ -153,7 +211,27 @@ public function setPortName($var) } /** - * Specifies how a port is selected for health checking. Can be one of the following values: USE_FIXED_PORT: Specifies a port number explicitly using the port field in the health check. Supported by backend services for passthrough load balancers and backend services for proxy load balancers. Not supported by target pools. The health check supports all backends supported by the backend service provided the backend can be health checked. For example, GCE_VM_IP network endpoint groups, GCE_VM_IP_PORT network endpoint groups, and instance group backends. USE_NAMED_PORT: Not supported. USE_SERVING_PORT: Provides an indirect method of specifying the health check port by referring to the backend service. Only supported by backend services for proxy load balancers. Not supported by target pools. Not supported by backend services for passthrough load balancers. Supports all backends that can be health checked; for example, GCE_VM_IP_PORT network endpoint groups and instance group backends. For GCE_VM_IP_PORT network endpoint group backends, the health check uses the port number specified for each endpoint in the network endpoint group. For instance group backends, the health check uses the port number determined by looking up the backend service's named port in the instance group's list of named ports. + * Specifies how a port is selected for health checking. Can be one of the + * following values: + * USE_FIXED_PORT: Specifies a port number explicitly using theport field in the health check. Supported by backend services + * for passthrough load balancers and backend services for proxy load + * balancers. Not supported by target pools. The health check supports all + * backends supported by the backend service provided the backend can be + * health checked. For example, GCE_VM_IP network endpoint + * groups, GCE_VM_IP_PORT network endpoint groups, and instance + * group backends. + * USE_NAMED_PORT: Not supported. + * USE_SERVING_PORT: Provides an indirect method of specifying + * the health check port by referring to the backend service. Only supported + * by backend services for proxy load balancers. Not supported by target + * pools. Not supported by backend services for passthrough load balancers. + * Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group + * backends. + * For GCE_VM_IP_PORT network endpoint group backends, the health + * check uses the port number specified for each endpoint in the network + * endpoint group. For instance group backends, the health check uses the + * port number determined by looking up the backend service's named port in + * the instance group's list of named ports. * Check the PortSpecification enum for the list of possible values. * * Generated from protobuf field optional string port_specification = 51590597; @@ -175,7 +253,27 @@ public function clearPortSpecification() } /** - * Specifies how a port is selected for health checking. Can be one of the following values: USE_FIXED_PORT: Specifies a port number explicitly using the port field in the health check. Supported by backend services for passthrough load balancers and backend services for proxy load balancers. Not supported by target pools. The health check supports all backends supported by the backend service provided the backend can be health checked. For example, GCE_VM_IP network endpoint groups, GCE_VM_IP_PORT network endpoint groups, and instance group backends. USE_NAMED_PORT: Not supported. USE_SERVING_PORT: Provides an indirect method of specifying the health check port by referring to the backend service. Only supported by backend services for proxy load balancers. Not supported by target pools. Not supported by backend services for passthrough load balancers. Supports all backends that can be health checked; for example, GCE_VM_IP_PORT network endpoint groups and instance group backends. For GCE_VM_IP_PORT network endpoint group backends, the health check uses the port number specified for each endpoint in the network endpoint group. For instance group backends, the health check uses the port number determined by looking up the backend service's named port in the instance group's list of named ports. + * Specifies how a port is selected for health checking. Can be one of the + * following values: + * USE_FIXED_PORT: Specifies a port number explicitly using theport field in the health check. Supported by backend services + * for passthrough load balancers and backend services for proxy load + * balancers. Not supported by target pools. The health check supports all + * backends supported by the backend service provided the backend can be + * health checked. For example, GCE_VM_IP network endpoint + * groups, GCE_VM_IP_PORT network endpoint groups, and instance + * group backends. + * USE_NAMED_PORT: Not supported. + * USE_SERVING_PORT: Provides an indirect method of specifying + * the health check port by referring to the backend service. Only supported + * by backend services for proxy load balancers. Not supported by target + * pools. Not supported by backend services for passthrough load balancers. + * Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group + * backends. + * For GCE_VM_IP_PORT network endpoint group backends, the health + * check uses the port number specified for each endpoint in the network + * endpoint group. For instance group backends, the health check uses the + * port number determined by looking up the backend service's named port in + * the instance group's list of named ports. * Check the PortSpecification enum for the list of possible values. * * Generated from protobuf field optional string port_specification = 51590597; @@ -191,7 +289,9 @@ public function setPortSpecification($var) } /** - * Specifies the type of proxy header to append before sending data to the backend, either NONE or PROXY_V1. The default is NONE. + * Specifies the type of proxy header to append before sending data to the + * backend, either NONE or PROXY_V1. The default + * is NONE. * Check the ProxyHeader enum for the list of possible values. * * Generated from protobuf field optional string proxy_header = 160374142; @@ -213,7 +313,9 @@ public function clearProxyHeader() } /** - * Specifies the type of proxy header to append before sending data to the backend, either NONE or PROXY_V1. The default is NONE. + * Specifies the type of proxy header to append before sending data to the + * backend, either NONE or PROXY_V1. The default + * is NONE. * Check the ProxyHeader enum for the list of possible values. * * Generated from protobuf field optional string proxy_header = 160374142; @@ -229,7 +331,8 @@ public function setProxyHeader($var) } /** - * Instructs the health check prober to send this exact ASCII string, up to 1024 bytes in length, after establishing the TCP connection. + * Instructs the health check prober to send this exact ASCII string, up to + * 1024 bytes in length, after establishing the TCP connection. * * Generated from protobuf field optional string request = 21951119; * @return string @@ -250,7 +353,8 @@ public function clearRequest() } /** - * Instructs the health check prober to send this exact ASCII string, up to 1024 bytes in length, after establishing the TCP connection. + * Instructs the health check prober to send this exact ASCII string, up to + * 1024 bytes in length, after establishing the TCP connection. * * Generated from protobuf field optional string request = 21951119; * @param string $var @@ -265,7 +369,11 @@ public function setRequest($var) } /** - * Creates a content-based TCP health check. In addition to establishing a TCP connection, you can configure the health check to pass only when the backend sends this exact response ASCII string, up to 1024 bytes in length. For details, see: https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-ssl-tcp + * Creates a content-based TCP health check. In addition to establishing a + * TCP connection, you can configure the health check to pass only when the + * backend sends this exact response ASCII string, up to 1024 bytes in length. + * For details, see: + * https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-ssl-tcp * * Generated from protobuf field optional string response = 196547649; * @return string @@ -286,7 +394,11 @@ public function clearResponse() } /** - * Creates a content-based TCP health check. In addition to establishing a TCP connection, you can configure the health check to pass only when the backend sends this exact response ASCII string, up to 1024 bytes in length. For details, see: https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-ssl-tcp + * Creates a content-based TCP health check. In addition to establishing a + * TCP connection, you can configure the health check to pass only when the + * backend sends this exact response ASCII string, up to 1024 bytes in length. + * For details, see: + * https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-ssl-tcp * * Generated from protobuf field optional string response = 196547649; * @param string $var diff --git a/Compute/src/V1/TCPHealthCheck/PortSpecification.php b/Compute/src/V1/TCPHealthCheck/PortSpecification.php index 8daea6da872c..62eb9d24c74c 100644 --- a/Compute/src/V1/TCPHealthCheck/PortSpecification.php +++ b/Compute/src/V1/TCPHealthCheck/PortSpecification.php @@ -7,7 +7,27 @@ use UnexpectedValueException; /** - * Specifies how a port is selected for health checking. Can be one of the following values: USE_FIXED_PORT: Specifies a port number explicitly using the port field in the health check. Supported by backend services for passthrough load balancers and backend services for proxy load balancers. Not supported by target pools. The health check supports all backends supported by the backend service provided the backend can be health checked. For example, GCE_VM_IP network endpoint groups, GCE_VM_IP_PORT network endpoint groups, and instance group backends. USE_NAMED_PORT: Not supported. USE_SERVING_PORT: Provides an indirect method of specifying the health check port by referring to the backend service. Only supported by backend services for proxy load balancers. Not supported by target pools. Not supported by backend services for passthrough load balancers. Supports all backends that can be health checked; for example, GCE_VM_IP_PORT network endpoint groups and instance group backends. For GCE_VM_IP_PORT network endpoint group backends, the health check uses the port number specified for each endpoint in the network endpoint group. For instance group backends, the health check uses the port number determined by looking up the backend service's named port in the instance group's list of named ports. + * Specifies how a port is selected for health checking. Can be one of the + * following values: + * USE_FIXED_PORT: Specifies a port number explicitly using theport field in the health check. Supported by backend services + * for passthrough load balancers and backend services for proxy load + * balancers. Not supported by target pools. The health check supports all + * backends supported by the backend service provided the backend can be + * health checked. For example, GCE_VM_IP network endpoint + * groups, GCE_VM_IP_PORT network endpoint groups, and instance + * group backends. + * USE_NAMED_PORT: Not supported. + * USE_SERVING_PORT: Provides an indirect method of specifying + * the health check port by referring to the backend service. Only supported + * by backend services for proxy load balancers. Not supported by target + * pools. Not supported by backend services for passthrough load balancers. + * Supports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group + * backends. + * For GCE_VM_IP_PORT network endpoint group backends, the health + * check uses the port number specified for each endpoint in the network + * endpoint group. For instance group backends, the health check uses the + * port number determined by looking up the backend service's named port in + * the instance group's list of named ports. * * Protobuf type google.cloud.compute.v1.TCPHealthCheck.PortSpecification */ @@ -20,7 +40,8 @@ class PortSpecification */ const UNDEFINED_PORT_SPECIFICATION = 0; /** - * The port number in the health check's port is used for health checking. Applies to network endpoint group and instance group backends. + * The port number in the health check's port is used for health + * checking. Applies to network endpoint group and instance group backends. * * Generated from protobuf enum USE_FIXED_PORT = 190235748; */ @@ -32,7 +53,10 @@ class PortSpecification */ const USE_NAMED_PORT = 349300671; /** - * For network endpoint group backends, the health check uses the port number specified on each endpoint in the network endpoint group. For instance group backends, the health check uses the port number specified for the backend service's named port defined in the instance group's named ports. + * For network endpoint group backends, the health check uses the port number + * specified on each endpoint in the network endpoint group. For instance + * group backends, the health check uses the port number specified for the + * backend service's named port defined in the instance group's named ports. * * Generated from protobuf enum USE_SERVING_PORT = 362637516; */ diff --git a/Compute/src/V1/TCPHealthCheck/ProxyHeader.php b/Compute/src/V1/TCPHealthCheck/ProxyHeader.php index bb0a9013244f..a93f905993f2 100644 --- a/Compute/src/V1/TCPHealthCheck/ProxyHeader.php +++ b/Compute/src/V1/TCPHealthCheck/ProxyHeader.php @@ -7,7 +7,9 @@ use UnexpectedValueException; /** - * Specifies the type of proxy header to append before sending data to the backend, either NONE or PROXY_V1. The default is NONE. + * Specifies the type of proxy header to append before sending data to the + * backend, either NONE or PROXY_V1. The default + * is NONE. * * Protobuf type google.cloud.compute.v1.TCPHealthCheck.ProxyHeader */ diff --git a/Compute/src/V1/Tags.php b/Compute/src/V1/Tags.php index 533e90e3aae6..a0dcc247395b 100644 --- a/Compute/src/V1/Tags.php +++ b/Compute/src/V1/Tags.php @@ -16,13 +16,20 @@ class Tags extends \Google\Protobuf\Internal\Message { /** - * Specifies a fingerprint for this request, which is essentially a hash of the tags' contents and used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update tags. You must always provide an up-to-date fingerprint hash in order to update or change tags. To see the latest fingerprint, make get() request to the instance. + * Specifies a fingerprint for this request, which is essentially a hash of + * the tags' contents and used for optimistic locking. The + * fingerprint is initially generated by Compute Engine and changes after + * every request to modify or update tags. You must always provide an + * up-to-date fingerprint hash in order to update or change tags. + * To see the latest fingerprint, make get() request to the + * instance. * * Generated from protobuf field optional string fingerprint = 234678500; */ protected $fingerprint = null; /** - * An array of tags. Each tag must be 1-63 characters long, and comply with RFC1035. + * An array of tags. Each tag must be 1-63 characters long, and comply + * with RFC1035. * * Generated from protobuf field repeated string items = 100526016; */ @@ -35,9 +42,16 @@ class Tags extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $fingerprint - * Specifies a fingerprint for this request, which is essentially a hash of the tags' contents and used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update tags. You must always provide an up-to-date fingerprint hash in order to update or change tags. To see the latest fingerprint, make get() request to the instance. + * Specifies a fingerprint for this request, which is essentially a hash of + * the tags' contents and used for optimistic locking. The + * fingerprint is initially generated by Compute Engine and changes after + * every request to modify or update tags. You must always provide an + * up-to-date fingerprint hash in order to update or change tags. + * To see the latest fingerprint, make get() request to the + * instance. * @type array|\Google\Protobuf\Internal\RepeatedField $items - * An array of tags. Each tag must be 1-63 characters long, and comply with RFC1035. + * An array of tags. Each tag must be 1-63 characters long, and comply + * with RFC1035. * } */ public function __construct($data = NULL) { @@ -46,7 +60,13 @@ public function __construct($data = NULL) { } /** - * Specifies a fingerprint for this request, which is essentially a hash of the tags' contents and used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update tags. You must always provide an up-to-date fingerprint hash in order to update or change tags. To see the latest fingerprint, make get() request to the instance. + * Specifies a fingerprint for this request, which is essentially a hash of + * the tags' contents and used for optimistic locking. The + * fingerprint is initially generated by Compute Engine and changes after + * every request to modify or update tags. You must always provide an + * up-to-date fingerprint hash in order to update or change tags. + * To see the latest fingerprint, make get() request to the + * instance. * * Generated from protobuf field optional string fingerprint = 234678500; * @return string @@ -67,7 +87,13 @@ public function clearFingerprint() } /** - * Specifies a fingerprint for this request, which is essentially a hash of the tags' contents and used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update tags. You must always provide an up-to-date fingerprint hash in order to update or change tags. To see the latest fingerprint, make get() request to the instance. + * Specifies a fingerprint for this request, which is essentially a hash of + * the tags' contents and used for optimistic locking. The + * fingerprint is initially generated by Compute Engine and changes after + * every request to modify or update tags. You must always provide an + * up-to-date fingerprint hash in order to update or change tags. + * To see the latest fingerprint, make get() request to the + * instance. * * Generated from protobuf field optional string fingerprint = 234678500; * @param string $var @@ -82,7 +108,8 @@ public function setFingerprint($var) } /** - * An array of tags. Each tag must be 1-63 characters long, and comply with RFC1035. + * An array of tags. Each tag must be 1-63 characters long, and comply + * with RFC1035. * * Generated from protobuf field repeated string items = 100526016; * @return \Google\Protobuf\Internal\RepeatedField @@ -93,7 +120,8 @@ public function getItems() } /** - * An array of tags. Each tag must be 1-63 characters long, and comply with RFC1035. + * An array of tags. Each tag must be 1-63 characters long, and comply + * with RFC1035. * * Generated from protobuf field repeated string items = 100526016; * @param array|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/TargetGrpcProxy.php b/Compute/src/V1/TargetGrpcProxy.php index eb19a525275e..f5b043a179f4 100644 --- a/Compute/src/V1/TargetGrpcProxy.php +++ b/Compute/src/V1/TargetGrpcProxy.php @@ -9,44 +9,64 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Represents a Target gRPC Proxy resource. A target gRPC proxy is a component of load balancers intended for load balancing gRPC traffic. Only global forwarding rules with load balancing scheme INTERNAL_SELF_MANAGED can reference a target gRPC proxy. The target gRPC Proxy references a URL map that specifies how traffic is routed to gRPC backend services. + * Represents a Target gRPC Proxy resource. + * A target gRPC proxy is a component of load balancers intended for + * load balancing gRPC traffic. Only global forwarding rules with load balancing + * scheme INTERNAL_SELF_MANAGED can reference a target gRPC proxy. The target + * gRPC Proxy references a URL map that specifies how traffic is routed to + * gRPC backend services. * * Generated from protobuf message google.cloud.compute.v1.TargetGrpcProxy */ class TargetGrpcProxy extends \Google\Protobuf\Internal\Message { /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; */ protected $creation_timestamp = null; /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; */ protected $description = null; /** - * Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking. This field will be ignored when inserting a TargetGrpcProxy. An up-to-date fingerprint must be provided in order to patch/update the TargetGrpcProxy; otherwise, the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve the TargetGrpcProxy. + * Fingerprint of this resource. A hash of the contents stored in this object. + * This field is used in optimistic locking. This field will be ignored when + * inserting a TargetGrpcProxy. An up-to-date fingerprint must + * be provided in order to patch/update the TargetGrpcProxy; otherwise, the + * request will fail with error 412 conditionNotMet. To see the + * latest fingerprint, make a get() request to retrieve the + * TargetGrpcProxy. * * Generated from protobuf field optional string fingerprint = 234678500; */ protected $fingerprint = null; /** - * [Output Only] The unique identifier for the resource type. The server generates this identifier. + * [Output Only] The unique identifier for the resource type. The server + * generates this identifier. * * Generated from protobuf field optional uint64 id = 3355; */ protected $id = null; /** - * [Output Only] Type of the resource. Always compute#targetGrpcProxy for target grpc proxies. + * [Output Only] Type of the resource. Alwayscompute#targetGrpcProxy for target grpc proxies. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * * Generated from protobuf field optional string name = 3373707; */ @@ -64,13 +84,24 @@ class TargetGrpcProxy extends \Google\Protobuf\Internal\Message */ protected $self_link_with_id = null; /** - * URL to the UrlMap resource that defines the mapping from URL to the BackendService. The protocol field in the BackendService must be set to GRPC. + * URL to the UrlMap resource that defines the mapping from URL to the + * BackendService. The protocol field in the BackendService must be set to + * GRPC. * * Generated from protobuf field optional string url_map = 367020684; */ protected $url_map = null; /** - * If true, indicates that the BackendServices referenced by the urlMap may be accessed by gRPC applications without using a sidecar proxy. This will enable configuration checks on urlMap and its referenced BackendServices to not allow unsupported features. A gRPC application must use "xds:///" scheme in the target URI of the service it is connecting to. If false, indicates that the BackendServices referenced by the urlMap will be accessed by gRPC applications via a sidecar proxy. In this case, a gRPC application must not use "xds:///" scheme in the target URI of the service it is connecting to + * If true, indicates that the BackendServices referenced by the urlMap may be + * accessed by gRPC applications without using a sidecar proxy. This will + * enable configuration checks on urlMap and its referenced BackendServices to + * not allow unsupported features. A gRPC application must use + * "xds:///" scheme in the target URI of the service it is + * connecting to. + * If false, indicates that the BackendServices referenced by the urlMap will + * be accessed by gRPC applications via a sidecar proxy. In this case, a gRPC + * application must not use "xds:///" scheme in the target URI of + * the service it is connecting to * * Generated from protobuf field optional bool validate_for_proxyless = 101822888; */ @@ -83,25 +114,51 @@ class TargetGrpcProxy extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $creation_timestamp - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * @type string $description - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * @type string $fingerprint - * Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking. This field will be ignored when inserting a TargetGrpcProxy. An up-to-date fingerprint must be provided in order to patch/update the TargetGrpcProxy; otherwise, the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve the TargetGrpcProxy. + * Fingerprint of this resource. A hash of the contents stored in this object. + * This field is used in optimistic locking. This field will be ignored when + * inserting a TargetGrpcProxy. An up-to-date fingerprint must + * be provided in order to patch/update the TargetGrpcProxy; otherwise, the + * request will fail with error 412 conditionNotMet. To see the + * latest fingerprint, make a get() request to retrieve the + * TargetGrpcProxy. * @type int|string $id - * [Output Only] The unique identifier for the resource type. The server generates this identifier. + * [Output Only] The unique identifier for the resource type. The server + * generates this identifier. * @type string $kind - * [Output Only] Type of the resource. Always compute#targetGrpcProxy for target grpc proxies. + * [Output Only] Type of the resource. Alwayscompute#targetGrpcProxy for target grpc proxies. * @type string $name - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * @type string $self_link * [Output Only] Server-defined URL for the resource. * @type string $self_link_with_id * [Output Only] Server-defined URL with id for the resource. * @type string $url_map - * URL to the UrlMap resource that defines the mapping from URL to the BackendService. The protocol field in the BackendService must be set to GRPC. + * URL to the UrlMap resource that defines the mapping from URL to the + * BackendService. The protocol field in the BackendService must be set to + * GRPC. * @type bool $validate_for_proxyless - * If true, indicates that the BackendServices referenced by the urlMap may be accessed by gRPC applications without using a sidecar proxy. This will enable configuration checks on urlMap and its referenced BackendServices to not allow unsupported features. A gRPC application must use "xds:///" scheme in the target URI of the service it is connecting to. If false, indicates that the BackendServices referenced by the urlMap will be accessed by gRPC applications via a sidecar proxy. In this case, a gRPC application must not use "xds:///" scheme in the target URI of the service it is connecting to + * If true, indicates that the BackendServices referenced by the urlMap may be + * accessed by gRPC applications without using a sidecar proxy. This will + * enable configuration checks on urlMap and its referenced BackendServices to + * not allow unsupported features. A gRPC application must use + * "xds:///" scheme in the target URI of the service it is + * connecting to. + * If false, indicates that the BackendServices referenced by the urlMap will + * be accessed by gRPC applications via a sidecar proxy. In this case, a gRPC + * application must not use "xds:///" scheme in the target URI of + * the service it is connecting to * } */ public function __construct($data = NULL) { @@ -110,7 +167,8 @@ public function __construct($data = NULL) { } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @return string @@ -131,7 +189,8 @@ public function clearCreationTimestamp() } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @param string $var @@ -146,7 +205,8 @@ public function setCreationTimestamp($var) } /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @return string @@ -167,7 +227,8 @@ public function clearDescription() } /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @param string $var @@ -182,7 +243,13 @@ public function setDescription($var) } /** - * Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking. This field will be ignored when inserting a TargetGrpcProxy. An up-to-date fingerprint must be provided in order to patch/update the TargetGrpcProxy; otherwise, the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve the TargetGrpcProxy. + * Fingerprint of this resource. A hash of the contents stored in this object. + * This field is used in optimistic locking. This field will be ignored when + * inserting a TargetGrpcProxy. An up-to-date fingerprint must + * be provided in order to patch/update the TargetGrpcProxy; otherwise, the + * request will fail with error 412 conditionNotMet. To see the + * latest fingerprint, make a get() request to retrieve the + * TargetGrpcProxy. * * Generated from protobuf field optional string fingerprint = 234678500; * @return string @@ -203,7 +270,13 @@ public function clearFingerprint() } /** - * Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking. This field will be ignored when inserting a TargetGrpcProxy. An up-to-date fingerprint must be provided in order to patch/update the TargetGrpcProxy; otherwise, the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve the TargetGrpcProxy. + * Fingerprint of this resource. A hash of the contents stored in this object. + * This field is used in optimistic locking. This field will be ignored when + * inserting a TargetGrpcProxy. An up-to-date fingerprint must + * be provided in order to patch/update the TargetGrpcProxy; otherwise, the + * request will fail with error 412 conditionNotMet. To see the + * latest fingerprint, make a get() request to retrieve the + * TargetGrpcProxy. * * Generated from protobuf field optional string fingerprint = 234678500; * @param string $var @@ -218,7 +291,8 @@ public function setFingerprint($var) } /** - * [Output Only] The unique identifier for the resource type. The server generates this identifier. + * [Output Only] The unique identifier for the resource type. The server + * generates this identifier. * * Generated from protobuf field optional uint64 id = 3355; * @return int|string @@ -239,7 +313,8 @@ public function clearId() } /** - * [Output Only] The unique identifier for the resource type. The server generates this identifier. + * [Output Only] The unique identifier for the resource type. The server + * generates this identifier. * * Generated from protobuf field optional uint64 id = 3355; * @param int|string $var @@ -254,7 +329,7 @@ public function setId($var) } /** - * [Output Only] Type of the resource. Always compute#targetGrpcProxy for target grpc proxies. + * [Output Only] Type of the resource. Alwayscompute#targetGrpcProxy for target grpc proxies. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -275,7 +350,7 @@ public function clearKind() } /** - * [Output Only] Type of the resource. Always compute#targetGrpcProxy for target grpc proxies. + * [Output Only] Type of the resource. Alwayscompute#targetGrpcProxy for target grpc proxies. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -290,7 +365,13 @@ public function setKind($var) } /** - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * * Generated from protobuf field optional string name = 3373707; * @return string @@ -311,7 +392,13 @@ public function clearName() } /** - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * * Generated from protobuf field optional string name = 3373707; * @param string $var @@ -398,7 +485,9 @@ public function setSelfLinkWithId($var) } /** - * URL to the UrlMap resource that defines the mapping from URL to the BackendService. The protocol field in the BackendService must be set to GRPC. + * URL to the UrlMap resource that defines the mapping from URL to the + * BackendService. The protocol field in the BackendService must be set to + * GRPC. * * Generated from protobuf field optional string url_map = 367020684; * @return string @@ -419,7 +508,9 @@ public function clearUrlMap() } /** - * URL to the UrlMap resource that defines the mapping from URL to the BackendService. The protocol field in the BackendService must be set to GRPC. + * URL to the UrlMap resource that defines the mapping from URL to the + * BackendService. The protocol field in the BackendService must be set to + * GRPC. * * Generated from protobuf field optional string url_map = 367020684; * @param string $var @@ -434,7 +525,16 @@ public function setUrlMap($var) } /** - * If true, indicates that the BackendServices referenced by the urlMap may be accessed by gRPC applications without using a sidecar proxy. This will enable configuration checks on urlMap and its referenced BackendServices to not allow unsupported features. A gRPC application must use "xds:///" scheme in the target URI of the service it is connecting to. If false, indicates that the BackendServices referenced by the urlMap will be accessed by gRPC applications via a sidecar proxy. In this case, a gRPC application must not use "xds:///" scheme in the target URI of the service it is connecting to + * If true, indicates that the BackendServices referenced by the urlMap may be + * accessed by gRPC applications without using a sidecar proxy. This will + * enable configuration checks on urlMap and its referenced BackendServices to + * not allow unsupported features. A gRPC application must use + * "xds:///" scheme in the target URI of the service it is + * connecting to. + * If false, indicates that the BackendServices referenced by the urlMap will + * be accessed by gRPC applications via a sidecar proxy. In this case, a gRPC + * application must not use "xds:///" scheme in the target URI of + * the service it is connecting to * * Generated from protobuf field optional bool validate_for_proxyless = 101822888; * @return bool @@ -455,7 +555,16 @@ public function clearValidateForProxyless() } /** - * If true, indicates that the BackendServices referenced by the urlMap may be accessed by gRPC applications without using a sidecar proxy. This will enable configuration checks on urlMap and its referenced BackendServices to not allow unsupported features. A gRPC application must use "xds:///" scheme in the target URI of the service it is connecting to. If false, indicates that the BackendServices referenced by the urlMap will be accessed by gRPC applications via a sidecar proxy. In this case, a gRPC application must not use "xds:///" scheme in the target URI of the service it is connecting to + * If true, indicates that the BackendServices referenced by the urlMap may be + * accessed by gRPC applications without using a sidecar proxy. This will + * enable configuration checks on urlMap and its referenced BackendServices to + * not allow unsupported features. A gRPC application must use + * "xds:///" scheme in the target URI of the service it is + * connecting to. + * If false, indicates that the BackendServices referenced by the urlMap will + * be accessed by gRPC applications via a sidecar proxy. In this case, a gRPC + * application must not use "xds:///" scheme in the target URI of + * the service it is connecting to * * Generated from protobuf field optional bool validate_for_proxyless = 101822888; * @param bool $var diff --git a/Compute/src/V1/TargetGrpcProxyList.php b/Compute/src/V1/TargetGrpcProxyList.php index 72dec7accfbd..8f833bcdf23f 100644 --- a/Compute/src/V1/TargetGrpcProxyList.php +++ b/Compute/src/V1/TargetGrpcProxyList.php @@ -27,13 +27,17 @@ class TargetGrpcProxyList extends \Google\Protobuf\Internal\Message */ private $items; /** - * [Output Only] Type of the resource. Always compute#targetGrpcProxy for target grpc proxies. + * [Output Only] Type of the resource. Alwayscompute#targetGrpcProxy for target grpc proxies. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -62,9 +66,13 @@ class TargetGrpcProxyList extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\TargetGrpcProxy>|\Google\Protobuf\Internal\RepeatedField $items * A list of TargetGrpcProxy resources. * @type string $kind - * [Output Only] Type of the resource. Always compute#targetGrpcProxy for target grpc proxies. + * [Output Only] Type of the resource. Alwayscompute#targetGrpcProxy for target grpc proxies. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type \Google\Cloud\Compute\V1\Warning $warning @@ -139,7 +147,7 @@ public function setItems($var) } /** - * [Output Only] Type of the resource. Always compute#targetGrpcProxy for target grpc proxies. + * [Output Only] Type of the resource. Alwayscompute#targetGrpcProxy for target grpc proxies. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -160,7 +168,7 @@ public function clearKind() } /** - * [Output Only] Type of the resource. Always compute#targetGrpcProxy for target grpc proxies. + * [Output Only] Type of the resource. Alwayscompute#targetGrpcProxy for target grpc proxies. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -175,7 +183,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -196,7 +208,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/TargetHttpProxiesScopedList.php b/Compute/src/V1/TargetHttpProxiesScopedList.php index 2900e42d430c..9e6e1f36651f 100644 --- a/Compute/src/V1/TargetHttpProxiesScopedList.php +++ b/Compute/src/V1/TargetHttpProxiesScopedList.php @@ -21,7 +21,8 @@ class TargetHttpProxiesScopedList extends \Google\Protobuf\Internal\Message */ private $target_http_proxies; /** - * Informational warning which replaces the list of backend services when the list is empty. + * Informational warning which replaces the list of + * backend services when the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; */ @@ -36,7 +37,8 @@ class TargetHttpProxiesScopedList extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\TargetHttpProxy>|\Google\Protobuf\Internal\RepeatedField $target_http_proxies * A list of TargetHttpProxies contained in this scope. * @type \Google\Cloud\Compute\V1\Warning $warning - * Informational warning which replaces the list of backend services when the list is empty. + * Informational warning which replaces the list of + * backend services when the list is empty. * } */ public function __construct($data = NULL) { @@ -71,7 +73,8 @@ public function setTargetHttpProxies($var) } /** - * Informational warning which replaces the list of backend services when the list is empty. + * Informational warning which replaces the list of + * backend services when the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; * @return \Google\Cloud\Compute\V1\Warning|null @@ -92,7 +95,8 @@ public function clearWarning() } /** - * Informational warning which replaces the list of backend services when the list is empty. + * Informational warning which replaces the list of + * backend services when the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; * @param \Google\Cloud\Compute\V1\Warning $var diff --git a/Compute/src/V1/TargetHttpProxy.php b/Compute/src/V1/TargetHttpProxy.php index 97ce514f07c6..5188d4656bd9 100644 --- a/Compute/src/V1/TargetHttpProxy.php +++ b/Compute/src/V1/TargetHttpProxy.php @@ -9,62 +9,105 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Represents a Target HTTP Proxy resource. Google Compute Engine has two Target HTTP Proxy resources: * [Global](/compute/docs/reference/rest/v1/targetHttpProxies) * [Regional](/compute/docs/reference/rest/v1/regionTargetHttpProxies) A target HTTP proxy is a component of Google Cloud HTTP load balancers. * targetHttpProxies are used by global external Application Load Balancers, classic Application Load Balancers, cross-region internal Application Load Balancers, and Traffic Director. * regionTargetHttpProxies are used by regional internal Application Load Balancers and regional external Application Load Balancers. Forwarding rules reference a target HTTP proxy, and the target proxy then references a URL map. For more information, read Using Target Proxies and Forwarding rule concepts. + * Represents a Target HTTP Proxy resource. + * Google Compute Engine has two Target HTTP Proxy resources: + * * [Global](/compute/docs/reference/rest/v1/targetHttpProxies) + * * [Regional](/compute/docs/reference/rest/v1/regionTargetHttpProxies) + * A target HTTP proxy is a component of Google Cloud HTTP load balancers. + * * targetHttpProxies are used by global external Application Load Balancers, + * classic Application Load Balancers, cross-region internal Application Load + * Balancers, and Traffic Director. + * * regionTargetHttpProxies are used by regional internal Application Load + * Balancers and regional external Application Load Balancers. + * Forwarding rules reference a target HTTP proxy, and the target proxy + * then references a URL map. For more information, readUsing Target Proxies + * and + * Forwarding rule concepts. * * Generated from protobuf message google.cloud.compute.v1.TargetHttpProxy */ class TargetHttpProxy extends \Google\Protobuf\Internal\Message { /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; */ protected $creation_timestamp = null; /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; */ protected $description = null; /** - * Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking. This field will be ignored when inserting a TargetHttpProxy. An up-to-date fingerprint must be provided in order to patch/update the TargetHttpProxy; otherwise, the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve the TargetHttpProxy. + * Fingerprint of this resource. A hash of the contents stored in this object. + * This field is used in optimistic locking. This field will be ignored when + * inserting a TargetHttpProxy. An up-to-date fingerprint must + * be provided in order to patch/update the TargetHttpProxy; otherwise, the + * request will fail with error 412 conditionNotMet. To see the + * latest fingerprint, make a get() request to retrieve the + * TargetHttpProxy. * * Generated from protobuf field optional string fingerprint = 234678500; */ protected $fingerprint = null; /** - * Specifies how long to keep a connection open, after completing a response, while there is no matching traffic (in seconds). If an HTTP keep-alive is not specified, a default value (610 seconds) will be used. For global external Application Load Balancers, the minimum allowed value is 5 seconds and the maximum allowed value is 1200 seconds. For classic Application Load Balancers, this option is not supported. + * Specifies how long to keep a connection open, after completing a response, + * while there is no matching traffic (in seconds). If an HTTP keep-alive is + * not specified, a default value (610 seconds) will be used. + * For global external Application Load Balancers, the minimum allowed value + * is 5 seconds and the maximum allowed value is 1200 seconds. + * For classic Application Load Balancers, this option is not supported. * * Generated from protobuf field optional int32 http_keep_alive_timeout_sec = 447326046; */ protected $http_keep_alive_timeout_sec = null; /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; */ protected $id = null; /** - * [Output Only] Type of resource. Always compute#targetHttpProxy for target HTTP proxies. + * [Output Only] Type of resource. Always compute#targetHttpProxy + * for target HTTP proxies. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * * Generated from protobuf field optional string name = 3373707; */ protected $name = null; /** - * This field only applies when the forwarding rule that references this target proxy has a loadBalancingScheme set to INTERNAL_SELF_MANAGED. When this field is set to true, Envoy proxies set up inbound traffic interception and bind to the IP address and port specified in the forwarding rule. This is generally useful when using Traffic Director to configure Envoy as a gateway or middle proxy (in other words, not a sidecar proxy). The Envoy proxy listens for inbound requests and handles requests when it receives them. The default is false. + * This field only applies when the forwarding rule that references this + * target proxy has a loadBalancingScheme set toINTERNAL_SELF_MANAGED. + * When this field is set to true, Envoy proxies set up inbound + * traffic interception and bind to the IP address and port specified in the + * forwarding rule. This is generally useful when using Traffic Director to + * configure Envoy as a gateway or middle proxy (in other words, not a + * sidecar proxy). The Envoy proxy listens for inbound requests and handles + * requests when it receives them. + * The default is false. * * Generated from protobuf field optional bool proxy_bind = 286025582; */ protected $proxy_bind = null; /** - * [Output Only] URL of the region where the regional Target HTTP Proxy resides. This field is not applicable to global Target HTTP Proxies. + * [Output Only] URL of the region where the regional Target HTTP Proxy + * resides. This field is not applicable to global Target HTTP Proxies. * * Generated from protobuf field optional string region = 138946292; */ @@ -76,7 +119,8 @@ class TargetHttpProxy extends \Google\Protobuf\Internal\Message */ protected $self_link = null; /** - * URL to the UrlMap resource that defines the mapping from URL to the BackendService. + * URL to the UrlMap resource that defines the mapping from URL to + * the BackendService. * * Generated from protobuf field optional string url_map = 367020684; */ @@ -89,27 +133,58 @@ class TargetHttpProxy extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $creation_timestamp - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * @type string $description - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * @type string $fingerprint - * Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking. This field will be ignored when inserting a TargetHttpProxy. An up-to-date fingerprint must be provided in order to patch/update the TargetHttpProxy; otherwise, the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve the TargetHttpProxy. + * Fingerprint of this resource. A hash of the contents stored in this object. + * This field is used in optimistic locking. This field will be ignored when + * inserting a TargetHttpProxy. An up-to-date fingerprint must + * be provided in order to patch/update the TargetHttpProxy; otherwise, the + * request will fail with error 412 conditionNotMet. To see the + * latest fingerprint, make a get() request to retrieve the + * TargetHttpProxy. * @type int $http_keep_alive_timeout_sec - * Specifies how long to keep a connection open, after completing a response, while there is no matching traffic (in seconds). If an HTTP keep-alive is not specified, a default value (610 seconds) will be used. For global external Application Load Balancers, the minimum allowed value is 5 seconds and the maximum allowed value is 1200 seconds. For classic Application Load Balancers, this option is not supported. + * Specifies how long to keep a connection open, after completing a response, + * while there is no matching traffic (in seconds). If an HTTP keep-alive is + * not specified, a default value (610 seconds) will be used. + * For global external Application Load Balancers, the minimum allowed value + * is 5 seconds and the maximum allowed value is 1200 seconds. + * For classic Application Load Balancers, this option is not supported. * @type int|string $id - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * @type string $kind - * [Output Only] Type of resource. Always compute#targetHttpProxy for target HTTP proxies. + * [Output Only] Type of resource. Always compute#targetHttpProxy + * for target HTTP proxies. * @type string $name - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * @type bool $proxy_bind - * This field only applies when the forwarding rule that references this target proxy has a loadBalancingScheme set to INTERNAL_SELF_MANAGED. When this field is set to true, Envoy proxies set up inbound traffic interception and bind to the IP address and port specified in the forwarding rule. This is generally useful when using Traffic Director to configure Envoy as a gateway or middle proxy (in other words, not a sidecar proxy). The Envoy proxy listens for inbound requests and handles requests when it receives them. The default is false. + * This field only applies when the forwarding rule that references this + * target proxy has a loadBalancingScheme set toINTERNAL_SELF_MANAGED. + * When this field is set to true, Envoy proxies set up inbound + * traffic interception and bind to the IP address and port specified in the + * forwarding rule. This is generally useful when using Traffic Director to + * configure Envoy as a gateway or middle proxy (in other words, not a + * sidecar proxy). The Envoy proxy listens for inbound requests and handles + * requests when it receives them. + * The default is false. * @type string $region - * [Output Only] URL of the region where the regional Target HTTP Proxy resides. This field is not applicable to global Target HTTP Proxies. + * [Output Only] URL of the region where the regional Target HTTP Proxy + * resides. This field is not applicable to global Target HTTP Proxies. * @type string $self_link * [Output Only] Server-defined URL for the resource. * @type string $url_map - * URL to the UrlMap resource that defines the mapping from URL to the BackendService. + * URL to the UrlMap resource that defines the mapping from URL to + * the BackendService. * } */ public function __construct($data = NULL) { @@ -118,7 +193,8 @@ public function __construct($data = NULL) { } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @return string @@ -139,7 +215,8 @@ public function clearCreationTimestamp() } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @param string $var @@ -154,7 +231,8 @@ public function setCreationTimestamp($var) } /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @return string @@ -175,7 +253,8 @@ public function clearDescription() } /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @param string $var @@ -190,7 +269,13 @@ public function setDescription($var) } /** - * Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking. This field will be ignored when inserting a TargetHttpProxy. An up-to-date fingerprint must be provided in order to patch/update the TargetHttpProxy; otherwise, the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve the TargetHttpProxy. + * Fingerprint of this resource. A hash of the contents stored in this object. + * This field is used in optimistic locking. This field will be ignored when + * inserting a TargetHttpProxy. An up-to-date fingerprint must + * be provided in order to patch/update the TargetHttpProxy; otherwise, the + * request will fail with error 412 conditionNotMet. To see the + * latest fingerprint, make a get() request to retrieve the + * TargetHttpProxy. * * Generated from protobuf field optional string fingerprint = 234678500; * @return string @@ -211,7 +296,13 @@ public function clearFingerprint() } /** - * Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking. This field will be ignored when inserting a TargetHttpProxy. An up-to-date fingerprint must be provided in order to patch/update the TargetHttpProxy; otherwise, the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve the TargetHttpProxy. + * Fingerprint of this resource. A hash of the contents stored in this object. + * This field is used in optimistic locking. This field will be ignored when + * inserting a TargetHttpProxy. An up-to-date fingerprint must + * be provided in order to patch/update the TargetHttpProxy; otherwise, the + * request will fail with error 412 conditionNotMet. To see the + * latest fingerprint, make a get() request to retrieve the + * TargetHttpProxy. * * Generated from protobuf field optional string fingerprint = 234678500; * @param string $var @@ -226,7 +317,12 @@ public function setFingerprint($var) } /** - * Specifies how long to keep a connection open, after completing a response, while there is no matching traffic (in seconds). If an HTTP keep-alive is not specified, a default value (610 seconds) will be used. For global external Application Load Balancers, the minimum allowed value is 5 seconds and the maximum allowed value is 1200 seconds. For classic Application Load Balancers, this option is not supported. + * Specifies how long to keep a connection open, after completing a response, + * while there is no matching traffic (in seconds). If an HTTP keep-alive is + * not specified, a default value (610 seconds) will be used. + * For global external Application Load Balancers, the minimum allowed value + * is 5 seconds and the maximum allowed value is 1200 seconds. + * For classic Application Load Balancers, this option is not supported. * * Generated from protobuf field optional int32 http_keep_alive_timeout_sec = 447326046; * @return int @@ -247,7 +343,12 @@ public function clearHttpKeepAliveTimeoutSec() } /** - * Specifies how long to keep a connection open, after completing a response, while there is no matching traffic (in seconds). If an HTTP keep-alive is not specified, a default value (610 seconds) will be used. For global external Application Load Balancers, the minimum allowed value is 5 seconds and the maximum allowed value is 1200 seconds. For classic Application Load Balancers, this option is not supported. + * Specifies how long to keep a connection open, after completing a response, + * while there is no matching traffic (in seconds). If an HTTP keep-alive is + * not specified, a default value (610 seconds) will be used. + * For global external Application Load Balancers, the minimum allowed value + * is 5 seconds and the maximum allowed value is 1200 seconds. + * For classic Application Load Balancers, this option is not supported. * * Generated from protobuf field optional int32 http_keep_alive_timeout_sec = 447326046; * @param int $var @@ -262,7 +363,8 @@ public function setHttpKeepAliveTimeoutSec($var) } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @return int|string @@ -283,7 +385,8 @@ public function clearId() } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @param int|string $var @@ -298,7 +401,8 @@ public function setId($var) } /** - * [Output Only] Type of resource. Always compute#targetHttpProxy for target HTTP proxies. + * [Output Only] Type of resource. Always compute#targetHttpProxy + * for target HTTP proxies. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -319,7 +423,8 @@ public function clearKind() } /** - * [Output Only] Type of resource. Always compute#targetHttpProxy for target HTTP proxies. + * [Output Only] Type of resource. Always compute#targetHttpProxy + * for target HTTP proxies. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -334,7 +439,13 @@ public function setKind($var) } /** - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * * Generated from protobuf field optional string name = 3373707; * @return string @@ -355,7 +466,13 @@ public function clearName() } /** - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * * Generated from protobuf field optional string name = 3373707; * @param string $var @@ -370,7 +487,15 @@ public function setName($var) } /** - * This field only applies when the forwarding rule that references this target proxy has a loadBalancingScheme set to INTERNAL_SELF_MANAGED. When this field is set to true, Envoy proxies set up inbound traffic interception and bind to the IP address and port specified in the forwarding rule. This is generally useful when using Traffic Director to configure Envoy as a gateway or middle proxy (in other words, not a sidecar proxy). The Envoy proxy listens for inbound requests and handles requests when it receives them. The default is false. + * This field only applies when the forwarding rule that references this + * target proxy has a loadBalancingScheme set toINTERNAL_SELF_MANAGED. + * When this field is set to true, Envoy proxies set up inbound + * traffic interception and bind to the IP address and port specified in the + * forwarding rule. This is generally useful when using Traffic Director to + * configure Envoy as a gateway or middle proxy (in other words, not a + * sidecar proxy). The Envoy proxy listens for inbound requests and handles + * requests when it receives them. + * The default is false. * * Generated from protobuf field optional bool proxy_bind = 286025582; * @return bool @@ -391,7 +516,15 @@ public function clearProxyBind() } /** - * This field only applies when the forwarding rule that references this target proxy has a loadBalancingScheme set to INTERNAL_SELF_MANAGED. When this field is set to true, Envoy proxies set up inbound traffic interception and bind to the IP address and port specified in the forwarding rule. This is generally useful when using Traffic Director to configure Envoy as a gateway or middle proxy (in other words, not a sidecar proxy). The Envoy proxy listens for inbound requests and handles requests when it receives them. The default is false. + * This field only applies when the forwarding rule that references this + * target proxy has a loadBalancingScheme set toINTERNAL_SELF_MANAGED. + * When this field is set to true, Envoy proxies set up inbound + * traffic interception and bind to the IP address and port specified in the + * forwarding rule. This is generally useful when using Traffic Director to + * configure Envoy as a gateway or middle proxy (in other words, not a + * sidecar proxy). The Envoy proxy listens for inbound requests and handles + * requests when it receives them. + * The default is false. * * Generated from protobuf field optional bool proxy_bind = 286025582; * @param bool $var @@ -406,7 +539,8 @@ public function setProxyBind($var) } /** - * [Output Only] URL of the region where the regional Target HTTP Proxy resides. This field is not applicable to global Target HTTP Proxies. + * [Output Only] URL of the region where the regional Target HTTP Proxy + * resides. This field is not applicable to global Target HTTP Proxies. * * Generated from protobuf field optional string region = 138946292; * @return string @@ -427,7 +561,8 @@ public function clearRegion() } /** - * [Output Only] URL of the region where the regional Target HTTP Proxy resides. This field is not applicable to global Target HTTP Proxies. + * [Output Only] URL of the region where the regional Target HTTP Proxy + * resides. This field is not applicable to global Target HTTP Proxies. * * Generated from protobuf field optional string region = 138946292; * @param string $var @@ -478,7 +613,8 @@ public function setSelfLink($var) } /** - * URL to the UrlMap resource that defines the mapping from URL to the BackendService. + * URL to the UrlMap resource that defines the mapping from URL to + * the BackendService. * * Generated from protobuf field optional string url_map = 367020684; * @return string @@ -499,7 +635,8 @@ public function clearUrlMap() } /** - * URL to the UrlMap resource that defines the mapping from URL to the BackendService. + * URL to the UrlMap resource that defines the mapping from URL to + * the BackendService. * * Generated from protobuf field optional string url_map = 367020684; * @param string $var diff --git a/Compute/src/V1/TargetHttpProxyAggregatedList.php b/Compute/src/V1/TargetHttpProxyAggregatedList.php index 01a3c4ec4b62..e1a9c67b23bd 100644 --- a/Compute/src/V1/TargetHttpProxyAggregatedList.php +++ b/Compute/src/V1/TargetHttpProxyAggregatedList.php @@ -27,13 +27,18 @@ class TargetHttpProxyAggregatedList extends \Google\Protobuf\Internal\Message */ private $items; /** - * [Output Only] Type of resource. Always compute#targetHttpProxyAggregatedList for lists of Target HTTP Proxies. + * [Output Only] Type of resource. Alwayscompute#targetHttpProxyAggregatedList for lists of Target HTTP + * Proxies. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -62,9 +67,14 @@ class TargetHttpProxyAggregatedList extends \Google\Protobuf\Internal\Message * @type array|\Google\Protobuf\Internal\MapField $items * A list of TargetHttpProxiesScopedList resources. * @type string $kind - * [Output Only] Type of resource. Always compute#targetHttpProxyAggregatedList for lists of Target HTTP Proxies. + * [Output Only] Type of resource. Alwayscompute#targetHttpProxyAggregatedList for lists of Target HTTP + * Proxies. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type array|\Google\Protobuf\Internal\RepeatedField $unreachables @@ -139,7 +149,8 @@ public function setItems($var) } /** - * [Output Only] Type of resource. Always compute#targetHttpProxyAggregatedList for lists of Target HTTP Proxies. + * [Output Only] Type of resource. Alwayscompute#targetHttpProxyAggregatedList for lists of Target HTTP + * Proxies. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -160,7 +171,8 @@ public function clearKind() } /** - * [Output Only] Type of resource. Always compute#targetHttpProxyAggregatedList for lists of Target HTTP Proxies. + * [Output Only] Type of resource. Alwayscompute#targetHttpProxyAggregatedList for lists of Target HTTP + * Proxies. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -175,7 +187,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -196,7 +212,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/TargetHttpProxyList.php b/Compute/src/V1/TargetHttpProxyList.php index 03127da0125d..624a180d6cdb 100644 --- a/Compute/src/V1/TargetHttpProxyList.php +++ b/Compute/src/V1/TargetHttpProxyList.php @@ -28,13 +28,18 @@ class TargetHttpProxyList extends \Google\Protobuf\Internal\Message */ private $items; /** - * Type of resource. Always compute#targetHttpProxyList for lists of target HTTP proxies. + * Type of resource. Always compute#targetHttpProxyList for lists + * of target HTTP proxies. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -63,9 +68,14 @@ class TargetHttpProxyList extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\TargetHttpProxy>|\Google\Protobuf\Internal\RepeatedField $items * A list of TargetHttpProxy resources. * @type string $kind - * Type of resource. Always compute#targetHttpProxyList for lists of target HTTP proxies. + * Type of resource. Always compute#targetHttpProxyList for lists + * of target HTTP proxies. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type \Google\Cloud\Compute\V1\Warning $warning @@ -140,7 +150,8 @@ public function setItems($var) } /** - * Type of resource. Always compute#targetHttpProxyList for lists of target HTTP proxies. + * Type of resource. Always compute#targetHttpProxyList for lists + * of target HTTP proxies. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -161,7 +172,8 @@ public function clearKind() } /** - * Type of resource. Always compute#targetHttpProxyList for lists of target HTTP proxies. + * Type of resource. Always compute#targetHttpProxyList for lists + * of target HTTP proxies. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -176,7 +188,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -197,7 +213,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/TargetHttpsProxiesScopedList.php b/Compute/src/V1/TargetHttpsProxiesScopedList.php index f337a49a7b9f..fe3ebcd8a42e 100644 --- a/Compute/src/V1/TargetHttpsProxiesScopedList.php +++ b/Compute/src/V1/TargetHttpsProxiesScopedList.php @@ -21,7 +21,8 @@ class TargetHttpsProxiesScopedList extends \Google\Protobuf\Internal\Message */ private $target_https_proxies; /** - * Informational warning which replaces the list of backend services when the list is empty. + * Informational warning which replaces the list of + * backend services when the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; */ @@ -36,7 +37,8 @@ class TargetHttpsProxiesScopedList extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\TargetHttpsProxy>|\Google\Protobuf\Internal\RepeatedField $target_https_proxies * A list of TargetHttpsProxies contained in this scope. * @type \Google\Cloud\Compute\V1\Warning $warning - * Informational warning which replaces the list of backend services when the list is empty. + * Informational warning which replaces the list of + * backend services when the list is empty. * } */ public function __construct($data = NULL) { @@ -71,7 +73,8 @@ public function setTargetHttpsProxies($var) } /** - * Informational warning which replaces the list of backend services when the list is empty. + * Informational warning which replaces the list of + * backend services when the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; * @return \Google\Cloud\Compute\V1\Warning|null @@ -92,7 +95,8 @@ public function clearWarning() } /** - * Informational warning which replaces the list of backend services when the list is empty. + * Informational warning which replaces the list of + * backend services when the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; * @param \Google\Cloud\Compute\V1\Warning $var diff --git a/Compute/src/V1/TargetHttpsProxiesSetCertificateMapRequest.php b/Compute/src/V1/TargetHttpsProxiesSetCertificateMapRequest.php index 0eef192e5ad2..32b05d92919d 100644 --- a/Compute/src/V1/TargetHttpsProxiesSetCertificateMapRequest.php +++ b/Compute/src/V1/TargetHttpsProxiesSetCertificateMapRequest.php @@ -15,7 +15,8 @@ class TargetHttpsProxiesSetCertificateMapRequest extends \Google\Protobuf\Internal\Message { /** - * URL of the Certificate Map to associate with this TargetHttpsProxy. Accepted format is //certificatemanager.googleapis.com/projects/{project }/locations/{location}/certificateMaps/{resourceName}. + * URL of the Certificate Map to associate with this TargetHttpsProxy. + * Accepted format is//certificatemanager.googleapis.com/projects/{project}/locations/{location}/certificateMaps/{resourceName}. * * Generated from protobuf field optional string certificate_map = 156463796; */ @@ -28,7 +29,8 @@ class TargetHttpsProxiesSetCertificateMapRequest extends \Google\Protobuf\Intern * Optional. Data for populating the Message object. * * @type string $certificate_map - * URL of the Certificate Map to associate with this TargetHttpsProxy. Accepted format is //certificatemanager.googleapis.com/projects/{project }/locations/{location}/certificateMaps/{resourceName}. + * URL of the Certificate Map to associate with this TargetHttpsProxy. + * Accepted format is//certificatemanager.googleapis.com/projects/{project}/locations/{location}/certificateMaps/{resourceName}. * } */ public function __construct($data = NULL) { @@ -37,7 +39,8 @@ public function __construct($data = NULL) { } /** - * URL of the Certificate Map to associate with this TargetHttpsProxy. Accepted format is //certificatemanager.googleapis.com/projects/{project }/locations/{location}/certificateMaps/{resourceName}. + * URL of the Certificate Map to associate with this TargetHttpsProxy. + * Accepted format is//certificatemanager.googleapis.com/projects/{project}/locations/{location}/certificateMaps/{resourceName}. * * Generated from protobuf field optional string certificate_map = 156463796; * @return string @@ -58,7 +61,8 @@ public function clearCertificateMap() } /** - * URL of the Certificate Map to associate with this TargetHttpsProxy. Accepted format is //certificatemanager.googleapis.com/projects/{project }/locations/{location}/certificateMaps/{resourceName}. + * URL of the Certificate Map to associate with this TargetHttpsProxy. + * Accepted format is//certificatemanager.googleapis.com/projects/{project}/locations/{location}/certificateMaps/{resourceName}. * * Generated from protobuf field optional string certificate_map = 156463796; * @param string $var diff --git a/Compute/src/V1/TargetHttpsProxiesSetQuicOverrideRequest/QuicOverride.php b/Compute/src/V1/TargetHttpsProxiesSetQuicOverrideRequest/QuicOverride.php index 62358a3f6ffd..e72028583a42 100644 --- a/Compute/src/V1/TargetHttpsProxiesSetQuicOverrideRequest/QuicOverride.php +++ b/Compute/src/V1/TargetHttpsProxiesSetQuicOverrideRequest/QuicOverride.php @@ -32,7 +32,8 @@ class QuicOverride */ const ENABLE = 438835587; /** - * No overrides to the default QUIC policy. This option is implicit if no QUIC override has been specified in the request. + * No overrides to the default QUIC policy. This option is implicit if + * no QUIC override has been specified in the request. * * Generated from protobuf enum NONE = 2402104; */ diff --git a/Compute/src/V1/TargetHttpsProxiesSetSslCertificatesRequest.php b/Compute/src/V1/TargetHttpsProxiesSetSslCertificatesRequest.php index dde534610011..9b13b80ecc77 100644 --- a/Compute/src/V1/TargetHttpsProxiesSetSslCertificatesRequest.php +++ b/Compute/src/V1/TargetHttpsProxiesSetSslCertificatesRequest.php @@ -15,7 +15,10 @@ class TargetHttpsProxiesSetSslCertificatesRequest extends \Google\Protobuf\Internal\Message { /** - * New set of SslCertificate resources to associate with this TargetHttpsProxy resource. At least one SSL certificate must be specified. Currently, you may specify up to 15 SSL certificates. + * New set of SslCertificate resources to associate + * with this TargetHttpsProxy resource. At least one SSL + * certificate must be specified. Currently, you may specify up to 15 SSL + * certificates. * * Generated from protobuf field repeated string ssl_certificates = 366006543; */ @@ -28,7 +31,10 @@ class TargetHttpsProxiesSetSslCertificatesRequest extends \Google\Protobuf\Inter * Optional. Data for populating the Message object. * * @type array|\Google\Protobuf\Internal\RepeatedField $ssl_certificates - * New set of SslCertificate resources to associate with this TargetHttpsProxy resource. At least one SSL certificate must be specified. Currently, you may specify up to 15 SSL certificates. + * New set of SslCertificate resources to associate + * with this TargetHttpsProxy resource. At least one SSL + * certificate must be specified. Currently, you may specify up to 15 SSL + * certificates. * } */ public function __construct($data = NULL) { @@ -37,7 +43,10 @@ public function __construct($data = NULL) { } /** - * New set of SslCertificate resources to associate with this TargetHttpsProxy resource. At least one SSL certificate must be specified. Currently, you may specify up to 15 SSL certificates. + * New set of SslCertificate resources to associate + * with this TargetHttpsProxy resource. At least one SSL + * certificate must be specified. Currently, you may specify up to 15 SSL + * certificates. * * Generated from protobuf field repeated string ssl_certificates = 366006543; * @return \Google\Protobuf\Internal\RepeatedField @@ -48,7 +57,10 @@ public function getSslCertificates() } /** - * New set of SslCertificate resources to associate with this TargetHttpsProxy resource. At least one SSL certificate must be specified. Currently, you may specify up to 15 SSL certificates. + * New set of SslCertificate resources to associate + * with this TargetHttpsProxy resource. At least one SSL + * certificate must be specified. Currently, you may specify up to 15 SSL + * certificates. * * Generated from protobuf field repeated string ssl_certificates = 366006543; * @param array|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/TargetHttpsProxy.php b/Compute/src/V1/TargetHttpsProxy.php index 1a07aec41a8f..4a8e44e461e2 100644 --- a/Compute/src/V1/TargetHttpsProxy.php +++ b/Compute/src/V1/TargetHttpsProxy.php @@ -9,81 +9,145 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Represents a Target HTTPS Proxy resource. Google Compute Engine has two Target HTTPS Proxy resources: * [Global](/compute/docs/reference/rest/v1/targetHttpsProxies) * [Regional](/compute/docs/reference/rest/v1/regionTargetHttpsProxies) A target HTTPS proxy is a component of Google Cloud HTTPS load balancers. * targetHttpsProxies are used by global external Application Load Balancers, classic Application Load Balancers, cross-region internal Application Load Balancers, and Traffic Director. * regionTargetHttpsProxies are used by regional internal Application Load Balancers and regional external Application Load Balancers. Forwarding rules reference a target HTTPS proxy, and the target proxy then references a URL map. For more information, read Using Target Proxies and Forwarding rule concepts. + * Represents a Target HTTPS Proxy resource. + * Google Compute Engine has two Target HTTPS Proxy resources: + * * [Global](/compute/docs/reference/rest/v1/targetHttpsProxies) + * * [Regional](/compute/docs/reference/rest/v1/regionTargetHttpsProxies) + * A target HTTPS proxy is a component of Google Cloud HTTPS load balancers. + * * targetHttpsProxies are used by global external Application Load Balancers, + * classic Application Load Balancers, cross-region internal Application Load + * Balancers, and Traffic Director. + * * regionTargetHttpsProxies are used by regional internal Application Load + * Balancers and regional external Application Load Balancers. + * Forwarding rules reference a target HTTPS proxy, and the target proxy + * then references a URL map. For more information, readUsing Target Proxies + * and + * Forwarding rule concepts. * * Generated from protobuf message google.cloud.compute.v1.TargetHttpsProxy */ class TargetHttpsProxy extends \Google\Protobuf\Internal\Message { /** - * Optional. A URL referring to a networksecurity.AuthorizationPolicy resource that describes how the proxy should authorize inbound traffic. If left blank, access will not be restricted by an authorization policy. Refer to the AuthorizationPolicy resource for additional details. authorizationPolicy only applies to a global TargetHttpsProxy attached to globalForwardingRules with the loadBalancingScheme set to INTERNAL_SELF_MANAGED. Note: This field currently has no impact. + * Optional. A URL referring to a networksecurity.AuthorizationPolicy resource + * that describes how the proxy should authorize inbound traffic. If left + * blank, access will not be restricted by an authorization policy. + * Refer to the AuthorizationPolicy resource for additional + * details. + * authorizationPolicy only applies to a globalTargetHttpsProxy attached toglobalForwardingRules with theloadBalancingScheme set to INTERNAL_SELF_MANAGED. + * Note: This field currently has no impact. * * Generated from protobuf field optional string authorization_policy = 33945528; */ protected $authorization_policy = null; /** - * URL of a certificate map that identifies a certificate map associated with the given target proxy. This field can only be set for Global external Application Load Balancer or Classic Application Load Balancer. For other products use Certificate Manager Certificates instead. If set, sslCertificates will be ignored. Accepted format is //certificatemanager.googleapis.com/projects/{project }/locations/{location}/certificateMaps/{resourceName}. + * URL of a certificate map that identifies a certificate map associated with + * the given target proxy. + * This field can only be set for Global external Application Load Balancer or + * Classic Application Load Balancer. For other products use Certificate + * Manager Certificates instead. + * If set, sslCertificates will be ignored. + * Accepted format is//certificatemanager.googleapis.com/projects/{project}/locations/{location}/certificateMaps/{resourceName}. * * Generated from protobuf field optional string certificate_map = 156463796; */ protected $certificate_map = null; /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; */ protected $creation_timestamp = null; /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; */ protected $description = null; /** - * Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking. This field will be ignored when inserting a TargetHttpsProxy. An up-to-date fingerprint must be provided in order to patch the TargetHttpsProxy; otherwise, the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve the TargetHttpsProxy. + * Fingerprint of this resource. A hash of the contents stored in this object. + * This field is used in optimistic locking. This field will be ignored when + * inserting a TargetHttpsProxy. An up-to-date fingerprint must + * be provided in order to patch the TargetHttpsProxy; otherwise, the request + * will fail with error 412 conditionNotMet. To see the latest + * fingerprint, make a get() request to retrieve the + * TargetHttpsProxy. * * Generated from protobuf field optional string fingerprint = 234678500; */ protected $fingerprint = null; /** - * Specifies how long to keep a connection open, after completing a response, while there is no matching traffic (in seconds). If an HTTP keep-alive is not specified, a default value (610 seconds) will be used. For global external Application Load Balancers, the minimum allowed value is 5 seconds and the maximum allowed value is 1200 seconds. For classic Application Load Balancers, this option is not supported. + * Specifies how long to keep a connection open, after completing a response, + * while there is no matching traffic (in seconds). If an HTTP keep-alive is + * not specified, a default value (610 seconds) will be used. + * For global external Application Load Balancers, the minimum allowed value + * is 5 seconds and the maximum allowed value is 1200 seconds. + * For classic Application Load Balancers, this option is not supported. * * Generated from protobuf field optional int32 http_keep_alive_timeout_sec = 447326046; */ protected $http_keep_alive_timeout_sec = null; /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; */ protected $id = null; /** - * [Output Only] Type of resource. Always compute#targetHttpsProxy for target HTTPS proxies. + * [Output Only] Type of resource. Alwayscompute#targetHttpsProxy for target HTTPS proxies. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * * Generated from protobuf field optional string name = 3373707; */ protected $name = null; /** - * This field only applies when the forwarding rule that references this target proxy has a loadBalancingScheme set to INTERNAL_SELF_MANAGED. When this field is set to true, Envoy proxies set up inbound traffic interception and bind to the IP address and port specified in the forwarding rule. This is generally useful when using Traffic Director to configure Envoy as a gateway or middle proxy (in other words, not a sidecar proxy). The Envoy proxy listens for inbound requests and handles requests when it receives them. The default is false. + * This field only applies when the forwarding rule that references this + * target proxy has a loadBalancingScheme set toINTERNAL_SELF_MANAGED. + * When this field is set to true, Envoy proxies set up inbound + * traffic interception and bind to the IP address and port specified in the + * forwarding rule. This is generally useful when using Traffic Director to + * configure Envoy as a gateway or middle proxy (in other words, not a + * sidecar proxy). The Envoy proxy listens for inbound requests and handles + * requests when it receives them. + * The default is false. * * Generated from protobuf field optional bool proxy_bind = 286025582; */ protected $proxy_bind = null; /** - * Specifies the QUIC override policy for this TargetHttpsProxy resource. This setting determines whether the load balancer attempts to negotiate QUIC with clients. You can specify NONE, ENABLE, or DISABLE. - When quic-override is set to NONE, Google manages whether QUIC is used. - When quic-override is set to ENABLE, the load balancer uses QUIC when possible. - When quic-override is set to DISABLE, the load balancer doesn't use QUIC. - If the quic-override flag is not specified, NONE is implied. + * Specifies the QUIC override policy for this TargetHttpsProxy resource. This + * setting determines whether the load balancer attempts to negotiate QUIC + * with clients. + * You can specify NONE, ENABLE, orDISABLE. + * - When quic-override is set to NONE, + * Google manages whether QUIC is used. + * - When quic-override is set to ENABLE, the + * load balancer uses QUIC when possible. + * - When quic-override is set to DISABLE, the + * load balancer doesn't use QUIC. + * - If the quic-override flag is not specified,NONE is implied. * Check the QuicOverride enum for the list of possible values. * * Generated from protobuf field optional string quic_override = 456577197; */ protected $quic_override = null; /** - * [Output Only] URL of the region where the regional TargetHttpsProxy resides. This field is not applicable to global TargetHttpsProxies. + * [Output Only] URL of the region where the regional TargetHttpsProxy + * resides. This field is not applicable to global TargetHttpsProxies. * * Generated from protobuf field optional string region = 138946292; */ @@ -95,32 +159,78 @@ class TargetHttpsProxy extends \Google\Protobuf\Internal\Message */ protected $self_link = null; /** - * Optional. A URL referring to a networksecurity.ServerTlsPolicy resource that describes how the proxy should authenticate inbound traffic. serverTlsPolicy only applies to a global TargetHttpsProxy attached to globalForwardingRules with the loadBalancingScheme set to INTERNAL_SELF_MANAGED or EXTERNAL or EXTERNAL_MANAGED or INTERNAL_MANAGED. It also applies to a regional TargetHttpsProxy attached to regional forwardingRules with the loadBalancingScheme set to EXTERNAL_MANAGED or INTERNAL_MANAGED. For details which ServerTlsPolicy resources are accepted with INTERNAL_SELF_MANAGED and which with EXTERNAL, INTERNAL_MANAGED, EXTERNAL_MANAGED loadBalancingScheme consult ServerTlsPolicy documentation. If left blank, communications are not encrypted. + * Optional. A URL referring to a networksecurity.ServerTlsPolicy resource + * that describes how the proxy should authenticate inbound traffic. + * serverTlsPolicy only applies to a globalTargetHttpsProxy attached toglobalForwardingRules with theloadBalancingScheme set to INTERNAL_SELF_MANAGED + * or EXTERNAL orEXTERNAL_MANAGED or INTERNAL_MANAGED. + * It also applies to a regional TargetHttpsProxy attached to + * regional forwardingRules with theloadBalancingScheme set to EXTERNAL_MANAGED orINTERNAL_MANAGED. For details whichServerTlsPolicy resources are accepted withINTERNAL_SELF_MANAGED and which with EXTERNAL,INTERNAL_MANAGED, EXTERNAL_MANAGEDloadBalancingScheme consult ServerTlsPolicy + * documentation. + * If left blank, communications are not encrypted. * * Generated from protobuf field optional string server_tls_policy = 295825266; */ protected $server_tls_policy = null; /** - * URLs to SslCertificate resources that are used to authenticate connections between users and the load balancer. At least one SSL certificate must be specified. SslCertificates do not apply when the load balancing scheme is set to INTERNAL_SELF_MANAGED. The URLs should refer to a SSL Certificate resource or Certificate Manager Certificate resource. Mixing Classic Certificates and Certificate Manager Certificates is not allowed. Certificate Manager Certificates must include the certificatemanager API namespace. Using Certificate Manager Certificates in this field is not supported by Global external Application Load Balancer or Classic Application Load Balancer, use certificate_map instead. Currently, you may specify up to 15 Classic SSL Certificates or up to 100 Certificate Manager Certificates. Certificate Manager Certificates accepted formats are: - //certificatemanager.googleapis.com/projects/{project}/locations/{ location}/certificates/{resourceName}. - https://certificatemanager.googleapis.com/v1alpha1/projects/{project }/locations/{location}/certificates/{resourceName}. + * URLs to SslCertificate resources that are used to authenticate + * connections between users and the load balancer. At least one SSL + * certificate must be specified. SslCertificates do not apply when the load + * balancing scheme is set to INTERNAL_SELF_MANAGED. + * The URLs should refer to a SSL Certificate resource or Certificate Manager + * Certificate resource. Mixing Classic Certificates and Certificate Manager + * Certificates is not allowed. Certificate Manager Certificates must include + * the certificatemanager API namespace. Using Certificate Manager + * Certificates in this field is not supported by Global external Application + * Load Balancer or Classic Application Load Balancer, use certificate_map + * instead. + * Currently, you may specify up to 15 Classic SSL Certificates or up to 100 + * Certificate Manager Certificates. + * Certificate Manager Certificates accepted formats are: + * - //certificatemanager.googleapis.com/projects/{project}/locations/{location}/certificates/{resourceName}. + * - https://certificatemanager.googleapis.com/v1alpha1/projects/{project}/locations/{location}/certificates/{resourceName}. * * Generated from protobuf field repeated string ssl_certificates = 366006543; */ private $ssl_certificates; /** - * URL of SslPolicy resource that will be associated with the TargetHttpsProxy resource. If not set, the TargetHttpsProxy resource has no SSL policy configured. + * URL of SslPolicy resource that will be associated with the TargetHttpsProxy + * resource. If not set, the TargetHttpsProxy resource has no + * SSL policy configured. * * Generated from protobuf field optional string ssl_policy = 295190213; */ protected $ssl_policy = null; /** - * Specifies whether TLS 1.3 0-RTT Data ("Early Data") should be accepted for this service. Early Data allows a TLS resumption handshake to include the initial application payload (a HTTP request) alongside the handshake, reducing the effective round trips to "zero". This applies to TLS 1.3 connections over TCP (HTTP/2) as well as over UDP (QUIC/h3). This can improve application performance, especially on networks where interruptions may be common, such as on mobile. Requests with Early Data will have the "Early-Data" HTTP header set on the request, with a value of "1", to allow the backend to determine whether Early Data was included. Note: TLS Early Data may allow requests to be replayed, as the data is sent to the backend before the handshake has fully completed. Applications that allow idempotent HTTP methods to make non-idempotent changes, such as a GET request updating a database, should not accept Early Data on those requests, and reject requests with the "Early-Data: 1" HTTP header by returning a HTTP 425 (Too Early) status code, in order to remain RFC compliant. The default value is DISABLED. + * Specifies whether TLS 1.3 0-RTT Data ("Early Data") should be accepted + * for this service. Early Data allows a TLS resumption handshake to include + * the initial application payload (a HTTP request) alongside the handshake, + * reducing the effective round trips to "zero". This applies to TLS 1.3 + * connections over TCP (HTTP/2) as well as over UDP (QUIC/h3). + * This can improve application performance, especially on networks where + * interruptions may be common, such as on mobile. + * Requests with Early Data will have the "Early-Data" HTTP header set on + * the request, with a value of "1", to allow the backend to determine whether + * Early Data was included. + * Note: TLS Early Data may allow requests to be replayed, as the data is + * sent to the backend before the handshake has fully completed. Applications + * that allow idempotent HTTP methods to make non-idempotent changes, such as + * a GET request updating a database, should not accept Early Data on those + * requests, and reject requests with the "Early-Data: 1" HTTP header by + * returning a HTTP 425 (Too Early) status code, in order to remain RFC + * compliant. + * The default value is DISABLED. * Check the TlsEarlyData enum for the list of possible values. * * Generated from protobuf field optional string tls_early_data = 61108426; */ protected $tls_early_data = null; /** - * A fully-qualified or valid partial URL to the UrlMap resource that defines the mapping from URL to the BackendService. For example, the following are all valid URLs for specifying a URL map: - https://www.googleapis.compute/v1/projects/project/global/urlMaps/ url-map - projects/project/global/urlMaps/url-map - global/urlMaps/url-map + * A fully-qualified or valid partial URL to the UrlMap resource that defines + * the mapping from URL to the BackendService. For example, the following are + * all valid URLs for specifying a URL map: + * - https://www.googleapis.compute/v1/projects/project/global/urlMaps/url-map + * - projects/project/global/urlMaps/url-map + * - global/urlMaps/url-map * * Generated from protobuf field optional string url_map = 367020684; */ @@ -133,43 +243,140 @@ class TargetHttpsProxy extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $authorization_policy - * Optional. A URL referring to a networksecurity.AuthorizationPolicy resource that describes how the proxy should authorize inbound traffic. If left blank, access will not be restricted by an authorization policy. Refer to the AuthorizationPolicy resource for additional details. authorizationPolicy only applies to a global TargetHttpsProxy attached to globalForwardingRules with the loadBalancingScheme set to INTERNAL_SELF_MANAGED. Note: This field currently has no impact. + * Optional. A URL referring to a networksecurity.AuthorizationPolicy resource + * that describes how the proxy should authorize inbound traffic. If left + * blank, access will not be restricted by an authorization policy. + * Refer to the AuthorizationPolicy resource for additional + * details. + * authorizationPolicy only applies to a globalTargetHttpsProxy attached toglobalForwardingRules with theloadBalancingScheme set to INTERNAL_SELF_MANAGED. + * Note: This field currently has no impact. * @type string $certificate_map - * URL of a certificate map that identifies a certificate map associated with the given target proxy. This field can only be set for Global external Application Load Balancer or Classic Application Load Balancer. For other products use Certificate Manager Certificates instead. If set, sslCertificates will be ignored. Accepted format is //certificatemanager.googleapis.com/projects/{project }/locations/{location}/certificateMaps/{resourceName}. + * URL of a certificate map that identifies a certificate map associated with + * the given target proxy. + * This field can only be set for Global external Application Load Balancer or + * Classic Application Load Balancer. For other products use Certificate + * Manager Certificates instead. + * If set, sslCertificates will be ignored. + * Accepted format is//certificatemanager.googleapis.com/projects/{project}/locations/{location}/certificateMaps/{resourceName}. * @type string $creation_timestamp - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * @type string $description - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * @type string $fingerprint - * Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking. This field will be ignored when inserting a TargetHttpsProxy. An up-to-date fingerprint must be provided in order to patch the TargetHttpsProxy; otherwise, the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve the TargetHttpsProxy. + * Fingerprint of this resource. A hash of the contents stored in this object. + * This field is used in optimistic locking. This field will be ignored when + * inserting a TargetHttpsProxy. An up-to-date fingerprint must + * be provided in order to patch the TargetHttpsProxy; otherwise, the request + * will fail with error 412 conditionNotMet. To see the latest + * fingerprint, make a get() request to retrieve the + * TargetHttpsProxy. * @type int $http_keep_alive_timeout_sec - * Specifies how long to keep a connection open, after completing a response, while there is no matching traffic (in seconds). If an HTTP keep-alive is not specified, a default value (610 seconds) will be used. For global external Application Load Balancers, the minimum allowed value is 5 seconds and the maximum allowed value is 1200 seconds. For classic Application Load Balancers, this option is not supported. + * Specifies how long to keep a connection open, after completing a response, + * while there is no matching traffic (in seconds). If an HTTP keep-alive is + * not specified, a default value (610 seconds) will be used. + * For global external Application Load Balancers, the minimum allowed value + * is 5 seconds and the maximum allowed value is 1200 seconds. + * For classic Application Load Balancers, this option is not supported. * @type int|string $id - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * @type string $kind - * [Output Only] Type of resource. Always compute#targetHttpsProxy for target HTTPS proxies. + * [Output Only] Type of resource. Alwayscompute#targetHttpsProxy for target HTTPS proxies. * @type string $name - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * @type bool $proxy_bind - * This field only applies when the forwarding rule that references this target proxy has a loadBalancingScheme set to INTERNAL_SELF_MANAGED. When this field is set to true, Envoy proxies set up inbound traffic interception and bind to the IP address and port specified in the forwarding rule. This is generally useful when using Traffic Director to configure Envoy as a gateway or middle proxy (in other words, not a sidecar proxy). The Envoy proxy listens for inbound requests and handles requests when it receives them. The default is false. + * This field only applies when the forwarding rule that references this + * target proxy has a loadBalancingScheme set toINTERNAL_SELF_MANAGED. + * When this field is set to true, Envoy proxies set up inbound + * traffic interception and bind to the IP address and port specified in the + * forwarding rule. This is generally useful when using Traffic Director to + * configure Envoy as a gateway or middle proxy (in other words, not a + * sidecar proxy). The Envoy proxy listens for inbound requests and handles + * requests when it receives them. + * The default is false. * @type string $quic_override - * Specifies the QUIC override policy for this TargetHttpsProxy resource. This setting determines whether the load balancer attempts to negotiate QUIC with clients. You can specify NONE, ENABLE, or DISABLE. - When quic-override is set to NONE, Google manages whether QUIC is used. - When quic-override is set to ENABLE, the load balancer uses QUIC when possible. - When quic-override is set to DISABLE, the load balancer doesn't use QUIC. - If the quic-override flag is not specified, NONE is implied. + * Specifies the QUIC override policy for this TargetHttpsProxy resource. This + * setting determines whether the load balancer attempts to negotiate QUIC + * with clients. + * You can specify NONE, ENABLE, orDISABLE. + * - When quic-override is set to NONE, + * Google manages whether QUIC is used. + * - When quic-override is set to ENABLE, the + * load balancer uses QUIC when possible. + * - When quic-override is set to DISABLE, the + * load balancer doesn't use QUIC. + * - If the quic-override flag is not specified,NONE is implied. * Check the QuicOverride enum for the list of possible values. * @type string $region - * [Output Only] URL of the region where the regional TargetHttpsProxy resides. This field is not applicable to global TargetHttpsProxies. + * [Output Only] URL of the region where the regional TargetHttpsProxy + * resides. This field is not applicable to global TargetHttpsProxies. * @type string $self_link * [Output Only] Server-defined URL for the resource. * @type string $server_tls_policy - * Optional. A URL referring to a networksecurity.ServerTlsPolicy resource that describes how the proxy should authenticate inbound traffic. serverTlsPolicy only applies to a global TargetHttpsProxy attached to globalForwardingRules with the loadBalancingScheme set to INTERNAL_SELF_MANAGED or EXTERNAL or EXTERNAL_MANAGED or INTERNAL_MANAGED. It also applies to a regional TargetHttpsProxy attached to regional forwardingRules with the loadBalancingScheme set to EXTERNAL_MANAGED or INTERNAL_MANAGED. For details which ServerTlsPolicy resources are accepted with INTERNAL_SELF_MANAGED and which with EXTERNAL, INTERNAL_MANAGED, EXTERNAL_MANAGED loadBalancingScheme consult ServerTlsPolicy documentation. If left blank, communications are not encrypted. + * Optional. A URL referring to a networksecurity.ServerTlsPolicy resource + * that describes how the proxy should authenticate inbound traffic. + * serverTlsPolicy only applies to a globalTargetHttpsProxy attached toglobalForwardingRules with theloadBalancingScheme set to INTERNAL_SELF_MANAGED + * or EXTERNAL orEXTERNAL_MANAGED or INTERNAL_MANAGED. + * It also applies to a regional TargetHttpsProxy attached to + * regional forwardingRules with theloadBalancingScheme set to EXTERNAL_MANAGED orINTERNAL_MANAGED. For details whichServerTlsPolicy resources are accepted withINTERNAL_SELF_MANAGED and which with EXTERNAL,INTERNAL_MANAGED, EXTERNAL_MANAGEDloadBalancingScheme consult ServerTlsPolicy + * documentation. + * If left blank, communications are not encrypted. * @type array|\Google\Protobuf\Internal\RepeatedField $ssl_certificates - * URLs to SslCertificate resources that are used to authenticate connections between users and the load balancer. At least one SSL certificate must be specified. SslCertificates do not apply when the load balancing scheme is set to INTERNAL_SELF_MANAGED. The URLs should refer to a SSL Certificate resource or Certificate Manager Certificate resource. Mixing Classic Certificates and Certificate Manager Certificates is not allowed. Certificate Manager Certificates must include the certificatemanager API namespace. Using Certificate Manager Certificates in this field is not supported by Global external Application Load Balancer or Classic Application Load Balancer, use certificate_map instead. Currently, you may specify up to 15 Classic SSL Certificates or up to 100 Certificate Manager Certificates. Certificate Manager Certificates accepted formats are: - //certificatemanager.googleapis.com/projects/{project}/locations/{ location}/certificates/{resourceName}. - https://certificatemanager.googleapis.com/v1alpha1/projects/{project }/locations/{location}/certificates/{resourceName}. + * URLs to SslCertificate resources that are used to authenticate + * connections between users and the load balancer. At least one SSL + * certificate must be specified. SslCertificates do not apply when the load + * balancing scheme is set to INTERNAL_SELF_MANAGED. + * The URLs should refer to a SSL Certificate resource or Certificate Manager + * Certificate resource. Mixing Classic Certificates and Certificate Manager + * Certificates is not allowed. Certificate Manager Certificates must include + * the certificatemanager API namespace. Using Certificate Manager + * Certificates in this field is not supported by Global external Application + * Load Balancer or Classic Application Load Balancer, use certificate_map + * instead. + * Currently, you may specify up to 15 Classic SSL Certificates or up to 100 + * Certificate Manager Certificates. + * Certificate Manager Certificates accepted formats are: + * - //certificatemanager.googleapis.com/projects/{project}/locations/{location}/certificates/{resourceName}. + * - https://certificatemanager.googleapis.com/v1alpha1/projects/{project}/locations/{location}/certificates/{resourceName}. * @type string $ssl_policy - * URL of SslPolicy resource that will be associated with the TargetHttpsProxy resource. If not set, the TargetHttpsProxy resource has no SSL policy configured. + * URL of SslPolicy resource that will be associated with the TargetHttpsProxy + * resource. If not set, the TargetHttpsProxy resource has no + * SSL policy configured. * @type string $tls_early_data - * Specifies whether TLS 1.3 0-RTT Data ("Early Data") should be accepted for this service. Early Data allows a TLS resumption handshake to include the initial application payload (a HTTP request) alongside the handshake, reducing the effective round trips to "zero". This applies to TLS 1.3 connections over TCP (HTTP/2) as well as over UDP (QUIC/h3). This can improve application performance, especially on networks where interruptions may be common, such as on mobile. Requests with Early Data will have the "Early-Data" HTTP header set on the request, with a value of "1", to allow the backend to determine whether Early Data was included. Note: TLS Early Data may allow requests to be replayed, as the data is sent to the backend before the handshake has fully completed. Applications that allow idempotent HTTP methods to make non-idempotent changes, such as a GET request updating a database, should not accept Early Data on those requests, and reject requests with the "Early-Data: 1" HTTP header by returning a HTTP 425 (Too Early) status code, in order to remain RFC compliant. The default value is DISABLED. + * Specifies whether TLS 1.3 0-RTT Data ("Early Data") should be accepted + * for this service. Early Data allows a TLS resumption handshake to include + * the initial application payload (a HTTP request) alongside the handshake, + * reducing the effective round trips to "zero". This applies to TLS 1.3 + * connections over TCP (HTTP/2) as well as over UDP (QUIC/h3). + * This can improve application performance, especially on networks where + * interruptions may be common, such as on mobile. + * Requests with Early Data will have the "Early-Data" HTTP header set on + * the request, with a value of "1", to allow the backend to determine whether + * Early Data was included. + * Note: TLS Early Data may allow requests to be replayed, as the data is + * sent to the backend before the handshake has fully completed. Applications + * that allow idempotent HTTP methods to make non-idempotent changes, such as + * a GET request updating a database, should not accept Early Data on those + * requests, and reject requests with the "Early-Data: 1" HTTP header by + * returning a HTTP 425 (Too Early) status code, in order to remain RFC + * compliant. + * The default value is DISABLED. * Check the TlsEarlyData enum for the list of possible values. * @type string $url_map - * A fully-qualified or valid partial URL to the UrlMap resource that defines the mapping from URL to the BackendService. For example, the following are all valid URLs for specifying a URL map: - https://www.googleapis.compute/v1/projects/project/global/urlMaps/ url-map - projects/project/global/urlMaps/url-map - global/urlMaps/url-map + * A fully-qualified or valid partial URL to the UrlMap resource that defines + * the mapping from URL to the BackendService. For example, the following are + * all valid URLs for specifying a URL map: + * - https://www.googleapis.compute/v1/projects/project/global/urlMaps/url-map + * - projects/project/global/urlMaps/url-map + * - global/urlMaps/url-map * } */ public function __construct($data = NULL) { @@ -178,7 +385,13 @@ public function __construct($data = NULL) { } /** - * Optional. A URL referring to a networksecurity.AuthorizationPolicy resource that describes how the proxy should authorize inbound traffic. If left blank, access will not be restricted by an authorization policy. Refer to the AuthorizationPolicy resource for additional details. authorizationPolicy only applies to a global TargetHttpsProxy attached to globalForwardingRules with the loadBalancingScheme set to INTERNAL_SELF_MANAGED. Note: This field currently has no impact. + * Optional. A URL referring to a networksecurity.AuthorizationPolicy resource + * that describes how the proxy should authorize inbound traffic. If left + * blank, access will not be restricted by an authorization policy. + * Refer to the AuthorizationPolicy resource for additional + * details. + * authorizationPolicy only applies to a globalTargetHttpsProxy attached toglobalForwardingRules with theloadBalancingScheme set to INTERNAL_SELF_MANAGED. + * Note: This field currently has no impact. * * Generated from protobuf field optional string authorization_policy = 33945528; * @return string @@ -199,7 +412,13 @@ public function clearAuthorizationPolicy() } /** - * Optional. A URL referring to a networksecurity.AuthorizationPolicy resource that describes how the proxy should authorize inbound traffic. If left blank, access will not be restricted by an authorization policy. Refer to the AuthorizationPolicy resource for additional details. authorizationPolicy only applies to a global TargetHttpsProxy attached to globalForwardingRules with the loadBalancingScheme set to INTERNAL_SELF_MANAGED. Note: This field currently has no impact. + * Optional. A URL referring to a networksecurity.AuthorizationPolicy resource + * that describes how the proxy should authorize inbound traffic. If left + * blank, access will not be restricted by an authorization policy. + * Refer to the AuthorizationPolicy resource for additional + * details. + * authorizationPolicy only applies to a globalTargetHttpsProxy attached toglobalForwardingRules with theloadBalancingScheme set to INTERNAL_SELF_MANAGED. + * Note: This field currently has no impact. * * Generated from protobuf field optional string authorization_policy = 33945528; * @param string $var @@ -214,7 +433,13 @@ public function setAuthorizationPolicy($var) } /** - * URL of a certificate map that identifies a certificate map associated with the given target proxy. This field can only be set for Global external Application Load Balancer or Classic Application Load Balancer. For other products use Certificate Manager Certificates instead. If set, sslCertificates will be ignored. Accepted format is //certificatemanager.googleapis.com/projects/{project }/locations/{location}/certificateMaps/{resourceName}. + * URL of a certificate map that identifies a certificate map associated with + * the given target proxy. + * This field can only be set for Global external Application Load Balancer or + * Classic Application Load Balancer. For other products use Certificate + * Manager Certificates instead. + * If set, sslCertificates will be ignored. + * Accepted format is//certificatemanager.googleapis.com/projects/{project}/locations/{location}/certificateMaps/{resourceName}. * * Generated from protobuf field optional string certificate_map = 156463796; * @return string @@ -235,7 +460,13 @@ public function clearCertificateMap() } /** - * URL of a certificate map that identifies a certificate map associated with the given target proxy. This field can only be set for Global external Application Load Balancer or Classic Application Load Balancer. For other products use Certificate Manager Certificates instead. If set, sslCertificates will be ignored. Accepted format is //certificatemanager.googleapis.com/projects/{project }/locations/{location}/certificateMaps/{resourceName}. + * URL of a certificate map that identifies a certificate map associated with + * the given target proxy. + * This field can only be set for Global external Application Load Balancer or + * Classic Application Load Balancer. For other products use Certificate + * Manager Certificates instead. + * If set, sslCertificates will be ignored. + * Accepted format is//certificatemanager.googleapis.com/projects/{project}/locations/{location}/certificateMaps/{resourceName}. * * Generated from protobuf field optional string certificate_map = 156463796; * @param string $var @@ -250,7 +481,8 @@ public function setCertificateMap($var) } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @return string @@ -271,7 +503,8 @@ public function clearCreationTimestamp() } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @param string $var @@ -286,7 +519,8 @@ public function setCreationTimestamp($var) } /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @return string @@ -307,7 +541,8 @@ public function clearDescription() } /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @param string $var @@ -322,7 +557,13 @@ public function setDescription($var) } /** - * Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking. This field will be ignored when inserting a TargetHttpsProxy. An up-to-date fingerprint must be provided in order to patch the TargetHttpsProxy; otherwise, the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve the TargetHttpsProxy. + * Fingerprint of this resource. A hash of the contents stored in this object. + * This field is used in optimistic locking. This field will be ignored when + * inserting a TargetHttpsProxy. An up-to-date fingerprint must + * be provided in order to patch the TargetHttpsProxy; otherwise, the request + * will fail with error 412 conditionNotMet. To see the latest + * fingerprint, make a get() request to retrieve the + * TargetHttpsProxy. * * Generated from protobuf field optional string fingerprint = 234678500; * @return string @@ -343,7 +584,13 @@ public function clearFingerprint() } /** - * Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking. This field will be ignored when inserting a TargetHttpsProxy. An up-to-date fingerprint must be provided in order to patch the TargetHttpsProxy; otherwise, the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve the TargetHttpsProxy. + * Fingerprint of this resource. A hash of the contents stored in this object. + * This field is used in optimistic locking. This field will be ignored when + * inserting a TargetHttpsProxy. An up-to-date fingerprint must + * be provided in order to patch the TargetHttpsProxy; otherwise, the request + * will fail with error 412 conditionNotMet. To see the latest + * fingerprint, make a get() request to retrieve the + * TargetHttpsProxy. * * Generated from protobuf field optional string fingerprint = 234678500; * @param string $var @@ -358,7 +605,12 @@ public function setFingerprint($var) } /** - * Specifies how long to keep a connection open, after completing a response, while there is no matching traffic (in seconds). If an HTTP keep-alive is not specified, a default value (610 seconds) will be used. For global external Application Load Balancers, the minimum allowed value is 5 seconds and the maximum allowed value is 1200 seconds. For classic Application Load Balancers, this option is not supported. + * Specifies how long to keep a connection open, after completing a response, + * while there is no matching traffic (in seconds). If an HTTP keep-alive is + * not specified, a default value (610 seconds) will be used. + * For global external Application Load Balancers, the minimum allowed value + * is 5 seconds and the maximum allowed value is 1200 seconds. + * For classic Application Load Balancers, this option is not supported. * * Generated from protobuf field optional int32 http_keep_alive_timeout_sec = 447326046; * @return int @@ -379,7 +631,12 @@ public function clearHttpKeepAliveTimeoutSec() } /** - * Specifies how long to keep a connection open, after completing a response, while there is no matching traffic (in seconds). If an HTTP keep-alive is not specified, a default value (610 seconds) will be used. For global external Application Load Balancers, the minimum allowed value is 5 seconds and the maximum allowed value is 1200 seconds. For classic Application Load Balancers, this option is not supported. + * Specifies how long to keep a connection open, after completing a response, + * while there is no matching traffic (in seconds). If an HTTP keep-alive is + * not specified, a default value (610 seconds) will be used. + * For global external Application Load Balancers, the minimum allowed value + * is 5 seconds and the maximum allowed value is 1200 seconds. + * For classic Application Load Balancers, this option is not supported. * * Generated from protobuf field optional int32 http_keep_alive_timeout_sec = 447326046; * @param int $var @@ -394,7 +651,8 @@ public function setHttpKeepAliveTimeoutSec($var) } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @return int|string @@ -415,7 +673,8 @@ public function clearId() } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @param int|string $var @@ -430,7 +689,7 @@ public function setId($var) } /** - * [Output Only] Type of resource. Always compute#targetHttpsProxy for target HTTPS proxies. + * [Output Only] Type of resource. Alwayscompute#targetHttpsProxy for target HTTPS proxies. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -451,7 +710,7 @@ public function clearKind() } /** - * [Output Only] Type of resource. Always compute#targetHttpsProxy for target HTTPS proxies. + * [Output Only] Type of resource. Alwayscompute#targetHttpsProxy for target HTTPS proxies. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -466,7 +725,13 @@ public function setKind($var) } /** - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * * Generated from protobuf field optional string name = 3373707; * @return string @@ -487,7 +752,13 @@ public function clearName() } /** - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * * Generated from protobuf field optional string name = 3373707; * @param string $var @@ -502,7 +773,15 @@ public function setName($var) } /** - * This field only applies when the forwarding rule that references this target proxy has a loadBalancingScheme set to INTERNAL_SELF_MANAGED. When this field is set to true, Envoy proxies set up inbound traffic interception and bind to the IP address and port specified in the forwarding rule. This is generally useful when using Traffic Director to configure Envoy as a gateway or middle proxy (in other words, not a sidecar proxy). The Envoy proxy listens for inbound requests and handles requests when it receives them. The default is false. + * This field only applies when the forwarding rule that references this + * target proxy has a loadBalancingScheme set toINTERNAL_SELF_MANAGED. + * When this field is set to true, Envoy proxies set up inbound + * traffic interception and bind to the IP address and port specified in the + * forwarding rule. This is generally useful when using Traffic Director to + * configure Envoy as a gateway or middle proxy (in other words, not a + * sidecar proxy). The Envoy proxy listens for inbound requests and handles + * requests when it receives them. + * The default is false. * * Generated from protobuf field optional bool proxy_bind = 286025582; * @return bool @@ -523,7 +802,15 @@ public function clearProxyBind() } /** - * This field only applies when the forwarding rule that references this target proxy has a loadBalancingScheme set to INTERNAL_SELF_MANAGED. When this field is set to true, Envoy proxies set up inbound traffic interception and bind to the IP address and port specified in the forwarding rule. This is generally useful when using Traffic Director to configure Envoy as a gateway or middle proxy (in other words, not a sidecar proxy). The Envoy proxy listens for inbound requests and handles requests when it receives them. The default is false. + * This field only applies when the forwarding rule that references this + * target proxy has a loadBalancingScheme set toINTERNAL_SELF_MANAGED. + * When this field is set to true, Envoy proxies set up inbound + * traffic interception and bind to the IP address and port specified in the + * forwarding rule. This is generally useful when using Traffic Director to + * configure Envoy as a gateway or middle proxy (in other words, not a + * sidecar proxy). The Envoy proxy listens for inbound requests and handles + * requests when it receives them. + * The default is false. * * Generated from protobuf field optional bool proxy_bind = 286025582; * @param bool $var @@ -538,7 +825,17 @@ public function setProxyBind($var) } /** - * Specifies the QUIC override policy for this TargetHttpsProxy resource. This setting determines whether the load balancer attempts to negotiate QUIC with clients. You can specify NONE, ENABLE, or DISABLE. - When quic-override is set to NONE, Google manages whether QUIC is used. - When quic-override is set to ENABLE, the load balancer uses QUIC when possible. - When quic-override is set to DISABLE, the load balancer doesn't use QUIC. - If the quic-override flag is not specified, NONE is implied. + * Specifies the QUIC override policy for this TargetHttpsProxy resource. This + * setting determines whether the load balancer attempts to negotiate QUIC + * with clients. + * You can specify NONE, ENABLE, orDISABLE. + * - When quic-override is set to NONE, + * Google manages whether QUIC is used. + * - When quic-override is set to ENABLE, the + * load balancer uses QUIC when possible. + * - When quic-override is set to DISABLE, the + * load balancer doesn't use QUIC. + * - If the quic-override flag is not specified,NONE is implied. * Check the QuicOverride enum for the list of possible values. * * Generated from protobuf field optional string quic_override = 456577197; @@ -560,7 +857,17 @@ public function clearQuicOverride() } /** - * Specifies the QUIC override policy for this TargetHttpsProxy resource. This setting determines whether the load balancer attempts to negotiate QUIC with clients. You can specify NONE, ENABLE, or DISABLE. - When quic-override is set to NONE, Google manages whether QUIC is used. - When quic-override is set to ENABLE, the load balancer uses QUIC when possible. - When quic-override is set to DISABLE, the load balancer doesn't use QUIC. - If the quic-override flag is not specified, NONE is implied. + * Specifies the QUIC override policy for this TargetHttpsProxy resource. This + * setting determines whether the load balancer attempts to negotiate QUIC + * with clients. + * You can specify NONE, ENABLE, orDISABLE. + * - When quic-override is set to NONE, + * Google manages whether QUIC is used. + * - When quic-override is set to ENABLE, the + * load balancer uses QUIC when possible. + * - When quic-override is set to DISABLE, the + * load balancer doesn't use QUIC. + * - If the quic-override flag is not specified,NONE is implied. * Check the QuicOverride enum for the list of possible values. * * Generated from protobuf field optional string quic_override = 456577197; @@ -576,7 +883,8 @@ public function setQuicOverride($var) } /** - * [Output Only] URL of the region where the regional TargetHttpsProxy resides. This field is not applicable to global TargetHttpsProxies. + * [Output Only] URL of the region where the regional TargetHttpsProxy + * resides. This field is not applicable to global TargetHttpsProxies. * * Generated from protobuf field optional string region = 138946292; * @return string @@ -597,7 +905,8 @@ public function clearRegion() } /** - * [Output Only] URL of the region where the regional TargetHttpsProxy resides. This field is not applicable to global TargetHttpsProxies. + * [Output Only] URL of the region where the regional TargetHttpsProxy + * resides. This field is not applicable to global TargetHttpsProxies. * * Generated from protobuf field optional string region = 138946292; * @param string $var @@ -648,7 +957,14 @@ public function setSelfLink($var) } /** - * Optional. A URL referring to a networksecurity.ServerTlsPolicy resource that describes how the proxy should authenticate inbound traffic. serverTlsPolicy only applies to a global TargetHttpsProxy attached to globalForwardingRules with the loadBalancingScheme set to INTERNAL_SELF_MANAGED or EXTERNAL or EXTERNAL_MANAGED or INTERNAL_MANAGED. It also applies to a regional TargetHttpsProxy attached to regional forwardingRules with the loadBalancingScheme set to EXTERNAL_MANAGED or INTERNAL_MANAGED. For details which ServerTlsPolicy resources are accepted with INTERNAL_SELF_MANAGED and which with EXTERNAL, INTERNAL_MANAGED, EXTERNAL_MANAGED loadBalancingScheme consult ServerTlsPolicy documentation. If left blank, communications are not encrypted. + * Optional. A URL referring to a networksecurity.ServerTlsPolicy resource + * that describes how the proxy should authenticate inbound traffic. + * serverTlsPolicy only applies to a globalTargetHttpsProxy attached toglobalForwardingRules with theloadBalancingScheme set to INTERNAL_SELF_MANAGED + * or EXTERNAL orEXTERNAL_MANAGED or INTERNAL_MANAGED. + * It also applies to a regional TargetHttpsProxy attached to + * regional forwardingRules with theloadBalancingScheme set to EXTERNAL_MANAGED orINTERNAL_MANAGED. For details whichServerTlsPolicy resources are accepted withINTERNAL_SELF_MANAGED and which with EXTERNAL,INTERNAL_MANAGED, EXTERNAL_MANAGEDloadBalancingScheme consult ServerTlsPolicy + * documentation. + * If left blank, communications are not encrypted. * * Generated from protobuf field optional string server_tls_policy = 295825266; * @return string @@ -669,7 +985,14 @@ public function clearServerTlsPolicy() } /** - * Optional. A URL referring to a networksecurity.ServerTlsPolicy resource that describes how the proxy should authenticate inbound traffic. serverTlsPolicy only applies to a global TargetHttpsProxy attached to globalForwardingRules with the loadBalancingScheme set to INTERNAL_SELF_MANAGED or EXTERNAL or EXTERNAL_MANAGED or INTERNAL_MANAGED. It also applies to a regional TargetHttpsProxy attached to regional forwardingRules with the loadBalancingScheme set to EXTERNAL_MANAGED or INTERNAL_MANAGED. For details which ServerTlsPolicy resources are accepted with INTERNAL_SELF_MANAGED and which with EXTERNAL, INTERNAL_MANAGED, EXTERNAL_MANAGED loadBalancingScheme consult ServerTlsPolicy documentation. If left blank, communications are not encrypted. + * Optional. A URL referring to a networksecurity.ServerTlsPolicy resource + * that describes how the proxy should authenticate inbound traffic. + * serverTlsPolicy only applies to a globalTargetHttpsProxy attached toglobalForwardingRules with theloadBalancingScheme set to INTERNAL_SELF_MANAGED + * or EXTERNAL orEXTERNAL_MANAGED or INTERNAL_MANAGED. + * It also applies to a regional TargetHttpsProxy attached to + * regional forwardingRules with theloadBalancingScheme set to EXTERNAL_MANAGED orINTERNAL_MANAGED. For details whichServerTlsPolicy resources are accepted withINTERNAL_SELF_MANAGED and which with EXTERNAL,INTERNAL_MANAGED, EXTERNAL_MANAGEDloadBalancingScheme consult ServerTlsPolicy + * documentation. + * If left blank, communications are not encrypted. * * Generated from protobuf field optional string server_tls_policy = 295825266; * @param string $var @@ -684,7 +1007,22 @@ public function setServerTlsPolicy($var) } /** - * URLs to SslCertificate resources that are used to authenticate connections between users and the load balancer. At least one SSL certificate must be specified. SslCertificates do not apply when the load balancing scheme is set to INTERNAL_SELF_MANAGED. The URLs should refer to a SSL Certificate resource or Certificate Manager Certificate resource. Mixing Classic Certificates and Certificate Manager Certificates is not allowed. Certificate Manager Certificates must include the certificatemanager API namespace. Using Certificate Manager Certificates in this field is not supported by Global external Application Load Balancer or Classic Application Load Balancer, use certificate_map instead. Currently, you may specify up to 15 Classic SSL Certificates or up to 100 Certificate Manager Certificates. Certificate Manager Certificates accepted formats are: - //certificatemanager.googleapis.com/projects/{project}/locations/{ location}/certificates/{resourceName}. - https://certificatemanager.googleapis.com/v1alpha1/projects/{project }/locations/{location}/certificates/{resourceName}. + * URLs to SslCertificate resources that are used to authenticate + * connections between users and the load balancer. At least one SSL + * certificate must be specified. SslCertificates do not apply when the load + * balancing scheme is set to INTERNAL_SELF_MANAGED. + * The URLs should refer to a SSL Certificate resource or Certificate Manager + * Certificate resource. Mixing Classic Certificates and Certificate Manager + * Certificates is not allowed. Certificate Manager Certificates must include + * the certificatemanager API namespace. Using Certificate Manager + * Certificates in this field is not supported by Global external Application + * Load Balancer or Classic Application Load Balancer, use certificate_map + * instead. + * Currently, you may specify up to 15 Classic SSL Certificates or up to 100 + * Certificate Manager Certificates. + * Certificate Manager Certificates accepted formats are: + * - //certificatemanager.googleapis.com/projects/{project}/locations/{location}/certificates/{resourceName}. + * - https://certificatemanager.googleapis.com/v1alpha1/projects/{project}/locations/{location}/certificates/{resourceName}. * * Generated from protobuf field repeated string ssl_certificates = 366006543; * @return \Google\Protobuf\Internal\RepeatedField @@ -695,7 +1033,22 @@ public function getSslCertificates() } /** - * URLs to SslCertificate resources that are used to authenticate connections between users and the load balancer. At least one SSL certificate must be specified. SslCertificates do not apply when the load balancing scheme is set to INTERNAL_SELF_MANAGED. The URLs should refer to a SSL Certificate resource or Certificate Manager Certificate resource. Mixing Classic Certificates and Certificate Manager Certificates is not allowed. Certificate Manager Certificates must include the certificatemanager API namespace. Using Certificate Manager Certificates in this field is not supported by Global external Application Load Balancer or Classic Application Load Balancer, use certificate_map instead. Currently, you may specify up to 15 Classic SSL Certificates or up to 100 Certificate Manager Certificates. Certificate Manager Certificates accepted formats are: - //certificatemanager.googleapis.com/projects/{project}/locations/{ location}/certificates/{resourceName}. - https://certificatemanager.googleapis.com/v1alpha1/projects/{project }/locations/{location}/certificates/{resourceName}. + * URLs to SslCertificate resources that are used to authenticate + * connections between users and the load balancer. At least one SSL + * certificate must be specified. SslCertificates do not apply when the load + * balancing scheme is set to INTERNAL_SELF_MANAGED. + * The URLs should refer to a SSL Certificate resource or Certificate Manager + * Certificate resource. Mixing Classic Certificates and Certificate Manager + * Certificates is not allowed. Certificate Manager Certificates must include + * the certificatemanager API namespace. Using Certificate Manager + * Certificates in this field is not supported by Global external Application + * Load Balancer or Classic Application Load Balancer, use certificate_map + * instead. + * Currently, you may specify up to 15 Classic SSL Certificates or up to 100 + * Certificate Manager Certificates. + * Certificate Manager Certificates accepted formats are: + * - //certificatemanager.googleapis.com/projects/{project}/locations/{location}/certificates/{resourceName}. + * - https://certificatemanager.googleapis.com/v1alpha1/projects/{project}/locations/{location}/certificates/{resourceName}. * * Generated from protobuf field repeated string ssl_certificates = 366006543; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -710,7 +1063,9 @@ public function setSslCertificates($var) } /** - * URL of SslPolicy resource that will be associated with the TargetHttpsProxy resource. If not set, the TargetHttpsProxy resource has no SSL policy configured. + * URL of SslPolicy resource that will be associated with the TargetHttpsProxy + * resource. If not set, the TargetHttpsProxy resource has no + * SSL policy configured. * * Generated from protobuf field optional string ssl_policy = 295190213; * @return string @@ -731,7 +1086,9 @@ public function clearSslPolicy() } /** - * URL of SslPolicy resource that will be associated with the TargetHttpsProxy resource. If not set, the TargetHttpsProxy resource has no SSL policy configured. + * URL of SslPolicy resource that will be associated with the TargetHttpsProxy + * resource. If not set, the TargetHttpsProxy resource has no + * SSL policy configured. * * Generated from protobuf field optional string ssl_policy = 295190213; * @param string $var @@ -746,7 +1103,24 @@ public function setSslPolicy($var) } /** - * Specifies whether TLS 1.3 0-RTT Data ("Early Data") should be accepted for this service. Early Data allows a TLS resumption handshake to include the initial application payload (a HTTP request) alongside the handshake, reducing the effective round trips to "zero". This applies to TLS 1.3 connections over TCP (HTTP/2) as well as over UDP (QUIC/h3). This can improve application performance, especially on networks where interruptions may be common, such as on mobile. Requests with Early Data will have the "Early-Data" HTTP header set on the request, with a value of "1", to allow the backend to determine whether Early Data was included. Note: TLS Early Data may allow requests to be replayed, as the data is sent to the backend before the handshake has fully completed. Applications that allow idempotent HTTP methods to make non-idempotent changes, such as a GET request updating a database, should not accept Early Data on those requests, and reject requests with the "Early-Data: 1" HTTP header by returning a HTTP 425 (Too Early) status code, in order to remain RFC compliant. The default value is DISABLED. + * Specifies whether TLS 1.3 0-RTT Data ("Early Data") should be accepted + * for this service. Early Data allows a TLS resumption handshake to include + * the initial application payload (a HTTP request) alongside the handshake, + * reducing the effective round trips to "zero". This applies to TLS 1.3 + * connections over TCP (HTTP/2) as well as over UDP (QUIC/h3). + * This can improve application performance, especially on networks where + * interruptions may be common, such as on mobile. + * Requests with Early Data will have the "Early-Data" HTTP header set on + * the request, with a value of "1", to allow the backend to determine whether + * Early Data was included. + * Note: TLS Early Data may allow requests to be replayed, as the data is + * sent to the backend before the handshake has fully completed. Applications + * that allow idempotent HTTP methods to make non-idempotent changes, such as + * a GET request updating a database, should not accept Early Data on those + * requests, and reject requests with the "Early-Data: 1" HTTP header by + * returning a HTTP 425 (Too Early) status code, in order to remain RFC + * compliant. + * The default value is DISABLED. * Check the TlsEarlyData enum for the list of possible values. * * Generated from protobuf field optional string tls_early_data = 61108426; @@ -768,7 +1142,24 @@ public function clearTlsEarlyData() } /** - * Specifies whether TLS 1.3 0-RTT Data ("Early Data") should be accepted for this service. Early Data allows a TLS resumption handshake to include the initial application payload (a HTTP request) alongside the handshake, reducing the effective round trips to "zero". This applies to TLS 1.3 connections over TCP (HTTP/2) as well as over UDP (QUIC/h3). This can improve application performance, especially on networks where interruptions may be common, such as on mobile. Requests with Early Data will have the "Early-Data" HTTP header set on the request, with a value of "1", to allow the backend to determine whether Early Data was included. Note: TLS Early Data may allow requests to be replayed, as the data is sent to the backend before the handshake has fully completed. Applications that allow idempotent HTTP methods to make non-idempotent changes, such as a GET request updating a database, should not accept Early Data on those requests, and reject requests with the "Early-Data: 1" HTTP header by returning a HTTP 425 (Too Early) status code, in order to remain RFC compliant. The default value is DISABLED. + * Specifies whether TLS 1.3 0-RTT Data ("Early Data") should be accepted + * for this service. Early Data allows a TLS resumption handshake to include + * the initial application payload (a HTTP request) alongside the handshake, + * reducing the effective round trips to "zero". This applies to TLS 1.3 + * connections over TCP (HTTP/2) as well as over UDP (QUIC/h3). + * This can improve application performance, especially on networks where + * interruptions may be common, such as on mobile. + * Requests with Early Data will have the "Early-Data" HTTP header set on + * the request, with a value of "1", to allow the backend to determine whether + * Early Data was included. + * Note: TLS Early Data may allow requests to be replayed, as the data is + * sent to the backend before the handshake has fully completed. Applications + * that allow idempotent HTTP methods to make non-idempotent changes, such as + * a GET request updating a database, should not accept Early Data on those + * requests, and reject requests with the "Early-Data: 1" HTTP header by + * returning a HTTP 425 (Too Early) status code, in order to remain RFC + * compliant. + * The default value is DISABLED. * Check the TlsEarlyData enum for the list of possible values. * * Generated from protobuf field optional string tls_early_data = 61108426; @@ -784,7 +1175,12 @@ public function setTlsEarlyData($var) } /** - * A fully-qualified or valid partial URL to the UrlMap resource that defines the mapping from URL to the BackendService. For example, the following are all valid URLs for specifying a URL map: - https://www.googleapis.compute/v1/projects/project/global/urlMaps/ url-map - projects/project/global/urlMaps/url-map - global/urlMaps/url-map + * A fully-qualified or valid partial URL to the UrlMap resource that defines + * the mapping from URL to the BackendService. For example, the following are + * all valid URLs for specifying a URL map: + * - https://www.googleapis.compute/v1/projects/project/global/urlMaps/url-map + * - projects/project/global/urlMaps/url-map + * - global/urlMaps/url-map * * Generated from protobuf field optional string url_map = 367020684; * @return string @@ -805,7 +1201,12 @@ public function clearUrlMap() } /** - * A fully-qualified or valid partial URL to the UrlMap resource that defines the mapping from URL to the BackendService. For example, the following are all valid URLs for specifying a URL map: - https://www.googleapis.compute/v1/projects/project/global/urlMaps/ url-map - projects/project/global/urlMaps/url-map - global/urlMaps/url-map + * A fully-qualified or valid partial URL to the UrlMap resource that defines + * the mapping from URL to the BackendService. For example, the following are + * all valid URLs for specifying a URL map: + * - https://www.googleapis.compute/v1/projects/project/global/urlMaps/url-map + * - projects/project/global/urlMaps/url-map + * - global/urlMaps/url-map * * Generated from protobuf field optional string url_map = 367020684; * @param string $var diff --git a/Compute/src/V1/TargetHttpsProxy/QuicOverride.php b/Compute/src/V1/TargetHttpsProxy/QuicOverride.php index 371ea2af81de..7542731b3c77 100644 --- a/Compute/src/V1/TargetHttpsProxy/QuicOverride.php +++ b/Compute/src/V1/TargetHttpsProxy/QuicOverride.php @@ -7,7 +7,17 @@ use UnexpectedValueException; /** - * Specifies the QUIC override policy for this TargetHttpsProxy resource. This setting determines whether the load balancer attempts to negotiate QUIC with clients. You can specify NONE, ENABLE, or DISABLE. - When quic-override is set to NONE, Google manages whether QUIC is used. - When quic-override is set to ENABLE, the load balancer uses QUIC when possible. - When quic-override is set to DISABLE, the load balancer doesn't use QUIC. - If the quic-override flag is not specified, NONE is implied. + * Specifies the QUIC override policy for this TargetHttpsProxy resource. This + * setting determines whether the load balancer attempts to negotiate QUIC + * with clients. + * You can specify NONE, ENABLE, orDISABLE. + * - When quic-override is set to NONE, + * Google manages whether QUIC is used. + * - When quic-override is set to ENABLE, the + * load balancer uses QUIC when possible. + * - When quic-override is set to DISABLE, the + * load balancer doesn't use QUIC. + * - If the quic-override flag is not specified,NONE is implied. * * Protobuf type google.cloud.compute.v1.TargetHttpsProxy.QuicOverride */ @@ -32,7 +42,8 @@ class QuicOverride */ const ENABLE = 438835587; /** - * No overrides to the default QUIC policy. This option is implicit if no QUIC override has been specified in the request. + * No overrides to the default QUIC policy. This option is implicit if + * no QUIC override has been specified in the request. * * Generated from protobuf enum NONE = 2402104; */ diff --git a/Compute/src/V1/TargetHttpsProxy/TlsEarlyData.php b/Compute/src/V1/TargetHttpsProxy/TlsEarlyData.php index c54d10bcde30..debe09210788 100644 --- a/Compute/src/V1/TargetHttpsProxy/TlsEarlyData.php +++ b/Compute/src/V1/TargetHttpsProxy/TlsEarlyData.php @@ -7,7 +7,24 @@ use UnexpectedValueException; /** - * Specifies whether TLS 1.3 0-RTT Data ("Early Data") should be accepted for this service. Early Data allows a TLS resumption handshake to include the initial application payload (a HTTP request) alongside the handshake, reducing the effective round trips to "zero". This applies to TLS 1.3 connections over TCP (HTTP/2) as well as over UDP (QUIC/h3). This can improve application performance, especially on networks where interruptions may be common, such as on mobile. Requests with Early Data will have the "Early-Data" HTTP header set on the request, with a value of "1", to allow the backend to determine whether Early Data was included. Note: TLS Early Data may allow requests to be replayed, as the data is sent to the backend before the handshake has fully completed. Applications that allow idempotent HTTP methods to make non-idempotent changes, such as a GET request updating a database, should not accept Early Data on those requests, and reject requests with the "Early-Data: 1" HTTP header by returning a HTTP 425 (Too Early) status code, in order to remain RFC compliant. The default value is DISABLED. + * Specifies whether TLS 1.3 0-RTT Data ("Early Data") should be accepted + * for this service. Early Data allows a TLS resumption handshake to include + * the initial application payload (a HTTP request) alongside the handshake, + * reducing the effective round trips to "zero". This applies to TLS 1.3 + * connections over TCP (HTTP/2) as well as over UDP (QUIC/h3). + * This can improve application performance, especially on networks where + * interruptions may be common, such as on mobile. + * Requests with Early Data will have the "Early-Data" HTTP header set on + * the request, with a value of "1", to allow the backend to determine whether + * Early Data was included. + * Note: TLS Early Data may allow requests to be replayed, as the data is + * sent to the backend before the handshake has fully completed. Applications + * that allow idempotent HTTP methods to make non-idempotent changes, such as + * a GET request updating a database, should not accept Early Data on those + * requests, and reject requests with the "Early-Data: 1" HTTP header by + * returning a HTTP 425 (Too Early) status code, in order to remain RFC + * compliant. + * The default value is DISABLED. * * Protobuf type google.cloud.compute.v1.TargetHttpsProxy.TlsEarlyData */ @@ -20,25 +37,37 @@ class TlsEarlyData */ const UNDEFINED_TLS_EARLY_DATA = 0; /** - * TLS 1.3 Early Data is not advertised, and any (invalid) attempts to send Early Data will be rejected by closing the connection. + * TLS 1.3 Early Data is not advertised, and any (invalid) attempts to send + * Early Data will be rejected by closing the connection. * * Generated from protobuf enum DISABLED = 516696700; */ const DISABLED = 516696700; /** - * This enables TLS 1.3 0-RTT, and only allows Early Data to be included on requests with safe HTTP methods (GET, HEAD, OPTIONS, TRACE). This mode does not enforce any other limitations for requests with Early Data. The application owner should validate that Early Data is acceptable for a given request path. + * This enables TLS 1.3 0-RTT, and only allows Early Data to be included on + * requests with safe HTTP methods (GET, HEAD, OPTIONS, TRACE). This mode + * does not enforce any other limitations for requests with Early Data. The + * application owner should validate that Early Data is acceptable for a + * given request path. * * Generated from protobuf enum PERMISSIVE = 504345247; */ const PERMISSIVE = 504345247; /** - * This enables TLS 1.3 0-RTT, and only allows Early Data to be included on requests with safe HTTP methods (GET, HEAD, OPTIONS, TRACE) without query parameters. Requests that send Early Data with non-idempotent HTTP methods or with query parameters will be rejected with a HTTP 425. + * This enables TLS 1.3 0-RTT, and only allows Early Data to be included on + * requests with safe HTTP methods (GET, HEAD, OPTIONS, TRACE) without query + * parameters. Requests that send Early Data with non-idempotent HTTP + * methods or with query parameters will be rejected with a HTTP 425. * * Generated from protobuf enum STRICT = 308826825; */ const STRICT = 308826825; /** - * This enables TLS 1.3 Early Data for requests with any HTTP method including non-idempotent methods list POST. This mode does not enforce any other limitations. This may be valuable for gRPC use cases. However, we do not recommend this method unless you have evaluated your security stance and mitigated the risk of replay attacks using other mechanisms. + * This enables TLS 1.3 Early Data for requests with any HTTP method + * including non-idempotent methods list POST. This mode does not enforce + * any other limitations. This may be valuable for gRPC use cases. However, + * we do not recommend this method unless you have evaluated your security + * stance and mitigated the risk of replay attacks using other mechanisms. * * Generated from protobuf enum UNRESTRICTED = 457266100; */ diff --git a/Compute/src/V1/TargetHttpsProxyAggregatedList.php b/Compute/src/V1/TargetHttpsProxyAggregatedList.php index 36791d67cae1..d35b7cc97cf8 100644 --- a/Compute/src/V1/TargetHttpsProxyAggregatedList.php +++ b/Compute/src/V1/TargetHttpsProxyAggregatedList.php @@ -27,13 +27,18 @@ class TargetHttpsProxyAggregatedList extends \Google\Protobuf\Internal\Message */ private $items; /** - * [Output Only] Type of resource. Always compute#targetHttpsProxyAggregatedList for lists of Target HTTP Proxies. + * [Output Only] Type of resource. Alwayscompute#targetHttpsProxyAggregatedList for lists of Target + * HTTP Proxies. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -68,9 +73,14 @@ class TargetHttpsProxyAggregatedList extends \Google\Protobuf\Internal\Message * @type array|\Google\Protobuf\Internal\MapField $items * A list of TargetHttpsProxiesScopedList resources. * @type string $kind - * [Output Only] Type of resource. Always compute#targetHttpsProxyAggregatedList for lists of Target HTTP Proxies. + * [Output Only] Type of resource. Alwayscompute#targetHttpsProxyAggregatedList for lists of Target + * HTTP Proxies. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type array|\Google\Protobuf\Internal\RepeatedField $unreachables @@ -147,7 +157,8 @@ public function setItems($var) } /** - * [Output Only] Type of resource. Always compute#targetHttpsProxyAggregatedList for lists of Target HTTP Proxies. + * [Output Only] Type of resource. Alwayscompute#targetHttpsProxyAggregatedList for lists of Target + * HTTP Proxies. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -168,7 +179,8 @@ public function clearKind() } /** - * [Output Only] Type of resource. Always compute#targetHttpsProxyAggregatedList for lists of Target HTTP Proxies. + * [Output Only] Type of resource. Alwayscompute#targetHttpsProxyAggregatedList for lists of Target + * HTTP Proxies. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -183,7 +195,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -204,7 +220,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/TargetHttpsProxyList.php b/Compute/src/V1/TargetHttpsProxyList.php index 36719b3414bc..a0043ff1ffa7 100644 --- a/Compute/src/V1/TargetHttpsProxyList.php +++ b/Compute/src/V1/TargetHttpsProxyList.php @@ -28,13 +28,18 @@ class TargetHttpsProxyList extends \Google\Protobuf\Internal\Message */ private $items; /** - * Type of resource. Always compute#targetHttpsProxyList for lists of target HTTPS proxies. + * Type of resource. Always compute#targetHttpsProxyList for + * lists of target HTTPS proxies. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -63,9 +68,14 @@ class TargetHttpsProxyList extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\TargetHttpsProxy>|\Google\Protobuf\Internal\RepeatedField $items * A list of TargetHttpsProxy resources. * @type string $kind - * Type of resource. Always compute#targetHttpsProxyList for lists of target HTTPS proxies. + * Type of resource. Always compute#targetHttpsProxyList for + * lists of target HTTPS proxies. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type \Google\Cloud\Compute\V1\Warning $warning @@ -140,7 +150,8 @@ public function setItems($var) } /** - * Type of resource. Always compute#targetHttpsProxyList for lists of target HTTPS proxies. + * Type of resource. Always compute#targetHttpsProxyList for + * lists of target HTTPS proxies. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -161,7 +172,8 @@ public function clearKind() } /** - * Type of resource. Always compute#targetHttpsProxyList for lists of target HTTPS proxies. + * Type of resource. Always compute#targetHttpsProxyList for + * lists of target HTTPS proxies. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -176,7 +188,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -197,7 +213,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/TargetInstance.php b/Compute/src/V1/TargetInstance.php index 6aa7321eed77..e66c6031b753 100644 --- a/Compute/src/V1/TargetInstance.php +++ b/Compute/src/V1/TargetInstance.php @@ -9,63 +9,88 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Represents a Target Instance resource. You can use a target instance to handle traffic for one or more forwarding rules, which is ideal for forwarding protocol traffic that is managed by a single source. For example, ESP, AH, TCP, or UDP. For more information, read Target instances. + * Represents a Target Instance resource. + * You can use a target instance to handle traffic for one or more forwarding + * rules, which is ideal for forwarding protocol traffic that is managed by a + * single source. For example, ESP, AH, TCP, or UDP. + * For more information, readTarget + * instances. * * Generated from protobuf message google.cloud.compute.v1.TargetInstance */ class TargetInstance extends \Google\Protobuf\Internal\Message { /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; */ protected $creation_timestamp = null; /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; */ protected $description = null; /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; */ protected $id = null; /** - * A URL to the virtual machine instance that handles traffic for this target instance. When creating a target instance, you can provide the fully-qualified URL or a valid partial URL to the desired virtual machine. For example, the following are all valid URLs: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /instances/instance - projects/project/zones/zone/instances/instance - zones/zone/instances/instance + * A URL to the virtual machine instance that handles traffic for this target + * instance. When creating a target instance, you can provide the + * fully-qualified URL or a valid partial URL to the desired virtual machine. + * For example, the following are all valid URLs: + * - https://www.googleapis.com/compute/v1/projects/project/zones/zone/instances/instance + * - projects/project/zones/zone/instances/instance + * - zones/zone/instances/instance * * Generated from protobuf field optional string instance = 18257045; */ protected $instance = null; /** - * [Output Only] The type of the resource. Always compute#targetInstance for target instances. + * [Output Only] The type of the resource. Alwayscompute#targetInstance for target instances. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * * Generated from protobuf field optional string name = 3373707; */ protected $name = null; /** - * Must have a value of NO_NAT. Protocol forwarding delivers packets while preserving the destination IP address of the forwarding rule referencing the target instance. + * Must have a value of NO_NAT. + * Protocol forwarding delivers packets while preserving the destination IP + * address of the forwarding rule referencing the target instance. * Check the NatPolicy enum for the list of possible values. * * Generated from protobuf field optional string nat_policy = 509780496; */ protected $nat_policy = null; /** - * The URL of the network this target instance uses to forward traffic. If not specified, the traffic will be forwarded to the network that the default network interface belongs to. + * The URL of the network this target instance uses to forward traffic. + * If not specified, the traffic will be forwarded to the network that + * the default network interface belongs to. * * Generated from protobuf field optional string network = 232872494; */ protected $network = null; /** - * [Output Only] The resource URL for the security policy associated with this target instance. + * [Output Only] The resource URL for the security policy associated with this + * target instance. * * Generated from protobuf field optional string security_policy = 171082513; */ @@ -77,7 +102,9 @@ class TargetInstance extends \Google\Protobuf\Internal\Message */ protected $self_link = null; /** - * [Output Only] URL of the zone where the target instance resides. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * [Output Only] URL of the zone where the target instance resides. + * You must specify this field as part of the HTTP request URL. It is + * not settable as a field in the request body. * * Generated from protobuf field optional string zone = 3744684; */ @@ -90,28 +117,50 @@ class TargetInstance extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $creation_timestamp - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * @type string $description - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * @type int|string $id - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * @type string $instance - * A URL to the virtual machine instance that handles traffic for this target instance. When creating a target instance, you can provide the fully-qualified URL or a valid partial URL to the desired virtual machine. For example, the following are all valid URLs: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /instances/instance - projects/project/zones/zone/instances/instance - zones/zone/instances/instance + * A URL to the virtual machine instance that handles traffic for this target + * instance. When creating a target instance, you can provide the + * fully-qualified URL or a valid partial URL to the desired virtual machine. + * For example, the following are all valid URLs: + * - https://www.googleapis.com/compute/v1/projects/project/zones/zone/instances/instance + * - projects/project/zones/zone/instances/instance + * - zones/zone/instances/instance * @type string $kind - * [Output Only] The type of the resource. Always compute#targetInstance for target instances. + * [Output Only] The type of the resource. Alwayscompute#targetInstance for target instances. * @type string $name - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * @type string $nat_policy - * Must have a value of NO_NAT. Protocol forwarding delivers packets while preserving the destination IP address of the forwarding rule referencing the target instance. + * Must have a value of NO_NAT. + * Protocol forwarding delivers packets while preserving the destination IP + * address of the forwarding rule referencing the target instance. * Check the NatPolicy enum for the list of possible values. * @type string $network - * The URL of the network this target instance uses to forward traffic. If not specified, the traffic will be forwarded to the network that the default network interface belongs to. + * The URL of the network this target instance uses to forward traffic. + * If not specified, the traffic will be forwarded to the network that + * the default network interface belongs to. * @type string $security_policy - * [Output Only] The resource URL for the security policy associated with this target instance. + * [Output Only] The resource URL for the security policy associated with this + * target instance. * @type string $self_link * [Output Only] Server-defined URL for the resource. * @type string $zone - * [Output Only] URL of the zone where the target instance resides. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * [Output Only] URL of the zone where the target instance resides. + * You must specify this field as part of the HTTP request URL. It is + * not settable as a field in the request body. * } */ public function __construct($data = NULL) { @@ -120,7 +169,8 @@ public function __construct($data = NULL) { } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @return string @@ -141,7 +191,8 @@ public function clearCreationTimestamp() } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @param string $var @@ -156,7 +207,8 @@ public function setCreationTimestamp($var) } /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @return string @@ -177,7 +229,8 @@ public function clearDescription() } /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @param string $var @@ -192,7 +245,8 @@ public function setDescription($var) } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @return int|string @@ -213,7 +267,8 @@ public function clearId() } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @param int|string $var @@ -228,7 +283,13 @@ public function setId($var) } /** - * A URL to the virtual machine instance that handles traffic for this target instance. When creating a target instance, you can provide the fully-qualified URL or a valid partial URL to the desired virtual machine. For example, the following are all valid URLs: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /instances/instance - projects/project/zones/zone/instances/instance - zones/zone/instances/instance + * A URL to the virtual machine instance that handles traffic for this target + * instance. When creating a target instance, you can provide the + * fully-qualified URL or a valid partial URL to the desired virtual machine. + * For example, the following are all valid URLs: + * - https://www.googleapis.com/compute/v1/projects/project/zones/zone/instances/instance + * - projects/project/zones/zone/instances/instance + * - zones/zone/instances/instance * * Generated from protobuf field optional string instance = 18257045; * @return string @@ -249,7 +310,13 @@ public function clearInstance() } /** - * A URL to the virtual machine instance that handles traffic for this target instance. When creating a target instance, you can provide the fully-qualified URL or a valid partial URL to the desired virtual machine. For example, the following are all valid URLs: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /instances/instance - projects/project/zones/zone/instances/instance - zones/zone/instances/instance + * A URL to the virtual machine instance that handles traffic for this target + * instance. When creating a target instance, you can provide the + * fully-qualified URL or a valid partial URL to the desired virtual machine. + * For example, the following are all valid URLs: + * - https://www.googleapis.com/compute/v1/projects/project/zones/zone/instances/instance + * - projects/project/zones/zone/instances/instance + * - zones/zone/instances/instance * * Generated from protobuf field optional string instance = 18257045; * @param string $var @@ -264,7 +331,7 @@ public function setInstance($var) } /** - * [Output Only] The type of the resource. Always compute#targetInstance for target instances. + * [Output Only] The type of the resource. Alwayscompute#targetInstance for target instances. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -285,7 +352,7 @@ public function clearKind() } /** - * [Output Only] The type of the resource. Always compute#targetInstance for target instances. + * [Output Only] The type of the resource. Alwayscompute#targetInstance for target instances. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -300,7 +367,13 @@ public function setKind($var) } /** - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * * Generated from protobuf field optional string name = 3373707; * @return string @@ -321,7 +394,13 @@ public function clearName() } /** - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * * Generated from protobuf field optional string name = 3373707; * @param string $var @@ -336,7 +415,9 @@ public function setName($var) } /** - * Must have a value of NO_NAT. Protocol forwarding delivers packets while preserving the destination IP address of the forwarding rule referencing the target instance. + * Must have a value of NO_NAT. + * Protocol forwarding delivers packets while preserving the destination IP + * address of the forwarding rule referencing the target instance. * Check the NatPolicy enum for the list of possible values. * * Generated from protobuf field optional string nat_policy = 509780496; @@ -358,7 +439,9 @@ public function clearNatPolicy() } /** - * Must have a value of NO_NAT. Protocol forwarding delivers packets while preserving the destination IP address of the forwarding rule referencing the target instance. + * Must have a value of NO_NAT. + * Protocol forwarding delivers packets while preserving the destination IP + * address of the forwarding rule referencing the target instance. * Check the NatPolicy enum for the list of possible values. * * Generated from protobuf field optional string nat_policy = 509780496; @@ -374,7 +457,9 @@ public function setNatPolicy($var) } /** - * The URL of the network this target instance uses to forward traffic. If not specified, the traffic will be forwarded to the network that the default network interface belongs to. + * The URL of the network this target instance uses to forward traffic. + * If not specified, the traffic will be forwarded to the network that + * the default network interface belongs to. * * Generated from protobuf field optional string network = 232872494; * @return string @@ -395,7 +480,9 @@ public function clearNetwork() } /** - * The URL of the network this target instance uses to forward traffic. If not specified, the traffic will be forwarded to the network that the default network interface belongs to. + * The URL of the network this target instance uses to forward traffic. + * If not specified, the traffic will be forwarded to the network that + * the default network interface belongs to. * * Generated from protobuf field optional string network = 232872494; * @param string $var @@ -410,7 +497,8 @@ public function setNetwork($var) } /** - * [Output Only] The resource URL for the security policy associated with this target instance. + * [Output Only] The resource URL for the security policy associated with this + * target instance. * * Generated from protobuf field optional string security_policy = 171082513; * @return string @@ -431,7 +519,8 @@ public function clearSecurityPolicy() } /** - * [Output Only] The resource URL for the security policy associated with this target instance. + * [Output Only] The resource URL for the security policy associated with this + * target instance. * * Generated from protobuf field optional string security_policy = 171082513; * @param string $var @@ -482,7 +571,9 @@ public function setSelfLink($var) } /** - * [Output Only] URL of the zone where the target instance resides. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * [Output Only] URL of the zone where the target instance resides. + * You must specify this field as part of the HTTP request URL. It is + * not settable as a field in the request body. * * Generated from protobuf field optional string zone = 3744684; * @return string @@ -503,7 +594,9 @@ public function clearZone() } /** - * [Output Only] URL of the zone where the target instance resides. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * [Output Only] URL of the zone where the target instance resides. + * You must specify this field as part of the HTTP request URL. It is + * not settable as a field in the request body. * * Generated from protobuf field optional string zone = 3744684; * @param string $var diff --git a/Compute/src/V1/TargetInstance/NatPolicy.php b/Compute/src/V1/TargetInstance/NatPolicy.php index d4d843ae623d..f1abb0aac9a0 100644 --- a/Compute/src/V1/TargetInstance/NatPolicy.php +++ b/Compute/src/V1/TargetInstance/NatPolicy.php @@ -7,7 +7,9 @@ use UnexpectedValueException; /** - * Must have a value of NO_NAT. Protocol forwarding delivers packets while preserving the destination IP address of the forwarding rule referencing the target instance. + * Must have a value of NO_NAT. + * Protocol forwarding delivers packets while preserving the destination IP + * address of the forwarding rule referencing the target instance. * * Protobuf type google.cloud.compute.v1.TargetInstance.NatPolicy */ diff --git a/Compute/src/V1/TargetInstanceAggregatedList.php b/Compute/src/V1/TargetInstanceAggregatedList.php index 79aacd037cc8..feeaa2582cab 100644 --- a/Compute/src/V1/TargetInstanceAggregatedList.php +++ b/Compute/src/V1/TargetInstanceAggregatedList.php @@ -33,7 +33,11 @@ class TargetInstanceAggregatedList extends \Google\Protobuf\Internal\Message */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -70,7 +74,11 @@ class TargetInstanceAggregatedList extends \Google\Protobuf\Internal\Message * @type string $kind * Type of resource. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type array|\Google\Protobuf\Internal\RepeatedField $unreachables @@ -183,7 +191,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -204,7 +216,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/TargetInstanceList.php b/Compute/src/V1/TargetInstanceList.php index c546ea532fde..cfebd843b7d4 100644 --- a/Compute/src/V1/TargetInstanceList.php +++ b/Compute/src/V1/TargetInstanceList.php @@ -34,7 +34,11 @@ class TargetInstanceList extends \Google\Protobuf\Internal\Message */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -65,7 +69,11 @@ class TargetInstanceList extends \Google\Protobuf\Internal\Message * @type string $kind * Type of resource. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type \Google\Cloud\Compute\V1\Warning $warning @@ -176,7 +184,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -197,7 +209,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/TargetInstancesScopedList.php b/Compute/src/V1/TargetInstancesScopedList.php index ad63d2f8398a..c06bef03193e 100644 --- a/Compute/src/V1/TargetInstancesScopedList.php +++ b/Compute/src/V1/TargetInstancesScopedList.php @@ -21,7 +21,8 @@ class TargetInstancesScopedList extends \Google\Protobuf\Internal\Message */ private $target_instances; /** - * Informational warning which replaces the list of addresses when the list is empty. + * Informational warning which replaces the list of addresses when + * the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; */ @@ -36,7 +37,8 @@ class TargetInstancesScopedList extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\TargetInstance>|\Google\Protobuf\Internal\RepeatedField $target_instances * A list of target instances contained in this scope. * @type \Google\Cloud\Compute\V1\Warning $warning - * Informational warning which replaces the list of addresses when the list is empty. + * Informational warning which replaces the list of addresses when + * the list is empty. * } */ public function __construct($data = NULL) { @@ -71,7 +73,8 @@ public function setTargetInstances($var) } /** - * Informational warning which replaces the list of addresses when the list is empty. + * Informational warning which replaces the list of addresses when + * the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; * @return \Google\Cloud\Compute\V1\Warning|null @@ -92,7 +95,8 @@ public function clearWarning() } /** - * Informational warning which replaces the list of addresses when the list is empty. + * Informational warning which replaces the list of addresses when + * the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; * @param \Google\Cloud\Compute\V1\Warning $var diff --git a/Compute/src/V1/TargetPool.php b/Compute/src/V1/TargetPool.php index 0bc9b6bde623..c4bf293d600d 100644 --- a/Compute/src/V1/TargetPool.php +++ b/Compute/src/V1/TargetPool.php @@ -9,62 +9,103 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Represents a Target Pool resource. Target pools are used with external passthrough Network Load Balancers. A target pool references member instances, an associated legacy HttpHealthCheck resource, and, optionally, a backup target pool. For more information, read Using target pools. + * Represents a Target Pool resource. + * Target pools are used with external passthrough Network Load Balancers. + * A target pool references member instances, an associated legacy + * HttpHealthCheck resource, and, optionally, a backup target pool. + * For more information, readUsing target pools. * * Generated from protobuf message google.cloud.compute.v1.TargetPool */ class TargetPool extends \Google\Protobuf\Internal\Message { /** - * The server-defined URL for the resource. This field is applicable only when the containing target pool is serving a forwarding rule as the primary pool, and its failoverRatio field is properly set to a value between [0, 1]. backupPool and failoverRatio together define the fallback behavior of the primary target pool: if the ratio of the healthy instances in the primary pool is at or below failoverRatio, traffic arriving at the load-balanced IP will be directed to the backup pool. In case where failoverRatio and backupPool are not set, or all the instances in the backup pool are unhealthy, the traffic will be directed back to the primary pool in the "force" mode, where traffic will be spread to the healthy instances with the best effort, or to all instances when no instance is healthy. + * The server-defined URL for the resource. This field is applicable only when + * the containing target pool is serving a forwarding rule as the primary + * pool, and its failoverRatio field is properly set to a value + * between [0, 1].backupPool and failoverRatio together define + * the fallback behavior of the primary target pool: if the ratio of the + * healthy instances in the primary pool is at or belowfailoverRatio, traffic arriving at the load-balanced + * IP will be directed to the backup pool. + * In case where failoverRatio and backupPool + * are not set, or all the instances in the backup pool are unhealthy, + * the traffic will be directed back to the primary pool in the "force" + * mode, where traffic will be spread to the healthy instances with the + * best effort, or to all instances when no instance is healthy. * * Generated from protobuf field optional string backup_pool = 45884537; */ protected $backup_pool = null; /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; */ protected $creation_timestamp = null; /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; */ protected $description = null; /** - * This field is applicable only when the containing target pool is serving a forwarding rule as the primary pool (i.e., not as a backup pool to some other target pool). The value of the field must be in [0, 1]. If set, backupPool must also be set. They together define the fallback behavior of the primary target pool: if the ratio of the healthy instances in the primary pool is at or below this number, traffic arriving at the load-balanced IP will be directed to the backup pool. In case where failoverRatio is not set or all the instances in the backup pool are unhealthy, the traffic will be directed back to the primary pool in the "force" mode, where traffic will be spread to the healthy instances with the best effort, or to all instances when no instance is healthy. + * This field is applicable only when the containing target pool is serving a + * forwarding rule as the primary pool (i.e., not as a backup pool to some + * other target pool). The value of the field must be in [0, 1]. + * If set, backupPool must also be set. They together define + * the fallback behavior of the primary target pool: if the ratio of the + * healthy instances in the primary pool is at or below this number, + * traffic arriving at the load-balanced IP will be directed to the + * backup pool. + * In case where failoverRatio is not set or all the + * instances in the backup pool are unhealthy, the traffic will be + * directed back to the primary pool in the "force" mode, where traffic + * will be spread to the healthy instances with the + * best effort, or to all instances when no instance is healthy. * * Generated from protobuf field optional float failover_ratio = 212667006; */ protected $failover_ratio = null; /** - * The URL of the HttpHealthCheck resource. A member instance in this pool is considered healthy if and only if the health checks pass. Only legacy HttpHealthChecks are supported. Only one health check may be specified. + * The URL of the HttpHealthCheck resource. A member instance in this + * pool is considered healthy if and only if the health checks pass. + * Only legacy HttpHealthChecks are supported. Only one health check may be + * specified. * * Generated from protobuf field repeated string health_checks = 448370606; */ private $health_checks; /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; */ protected $id = null; /** - * A list of resource URLs to the virtual machine instances serving this pool. They must live in zones contained in the same region as this pool. + * A list of resource URLs to the virtual machine instances serving this pool. + * They must live in zones contained in the same region as this pool. * * Generated from protobuf field repeated string instances = 29097598; */ private $instances; /** - * [Output Only] Type of the resource. Always compute#targetPool for target pools. + * [Output Only] Type of the resource. Always compute#targetPool + * for target pools. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * * Generated from protobuf field optional string name = 3373707; */ @@ -76,7 +117,8 @@ class TargetPool extends \Google\Protobuf\Internal\Message */ protected $region = null; /** - * [Output Only] The resource URL for the security policy associated with this target pool. + * [Output Only] The resource URL for the security policy associated with this + * target pool. * * Generated from protobuf field optional string security_policy = 171082513; */ @@ -88,7 +130,15 @@ class TargetPool extends \Google\Protobuf\Internal\Message */ protected $self_link = null; /** - * Session affinity option, must be one of the following values: NONE: Connections from the same client IP may go to any instance in the pool. CLIENT_IP: Connections from the same client IP will go to the same instance in the pool while that instance remains healthy. CLIENT_IP_PROTO: Connections from the same client IP with the same IP protocol will go to the same instance in the pool while that instance remains healthy. + * Session affinity option, must be one of the following values: + * NONE: Connections from the same client IP may go to any + * instance in the pool. + * CLIENT_IP: Connections from the same client IP will go + * to the same instance in + * the pool while that instance remains healthy. + * CLIENT_IP_PROTO: Connections from the same client IP + * with the same IP protocol will go to the same instance in the + * pool while that instance remains healthy. * Check the SessionAffinity enum for the list of possible values. * * Generated from protobuf field optional string session_affinity = 463888561; @@ -102,31 +152,77 @@ class TargetPool extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $backup_pool - * The server-defined URL for the resource. This field is applicable only when the containing target pool is serving a forwarding rule as the primary pool, and its failoverRatio field is properly set to a value between [0, 1]. backupPool and failoverRatio together define the fallback behavior of the primary target pool: if the ratio of the healthy instances in the primary pool is at or below failoverRatio, traffic arriving at the load-balanced IP will be directed to the backup pool. In case where failoverRatio and backupPool are not set, or all the instances in the backup pool are unhealthy, the traffic will be directed back to the primary pool in the "force" mode, where traffic will be spread to the healthy instances with the best effort, or to all instances when no instance is healthy. + * The server-defined URL for the resource. This field is applicable only when + * the containing target pool is serving a forwarding rule as the primary + * pool, and its failoverRatio field is properly set to a value + * between [0, 1].backupPool and failoverRatio together define + * the fallback behavior of the primary target pool: if the ratio of the + * healthy instances in the primary pool is at or belowfailoverRatio, traffic arriving at the load-balanced + * IP will be directed to the backup pool. + * In case where failoverRatio and backupPool + * are not set, or all the instances in the backup pool are unhealthy, + * the traffic will be directed back to the primary pool in the "force" + * mode, where traffic will be spread to the healthy instances with the + * best effort, or to all instances when no instance is healthy. * @type string $creation_timestamp - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * @type string $description - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * @type float $failover_ratio - * This field is applicable only when the containing target pool is serving a forwarding rule as the primary pool (i.e., not as a backup pool to some other target pool). The value of the field must be in [0, 1]. If set, backupPool must also be set. They together define the fallback behavior of the primary target pool: if the ratio of the healthy instances in the primary pool is at or below this number, traffic arriving at the load-balanced IP will be directed to the backup pool. In case where failoverRatio is not set or all the instances in the backup pool are unhealthy, the traffic will be directed back to the primary pool in the "force" mode, where traffic will be spread to the healthy instances with the best effort, or to all instances when no instance is healthy. + * This field is applicable only when the containing target pool is serving a + * forwarding rule as the primary pool (i.e., not as a backup pool to some + * other target pool). The value of the field must be in [0, 1]. + * If set, backupPool must also be set. They together define + * the fallback behavior of the primary target pool: if the ratio of the + * healthy instances in the primary pool is at or below this number, + * traffic arriving at the load-balanced IP will be directed to the + * backup pool. + * In case where failoverRatio is not set or all the + * instances in the backup pool are unhealthy, the traffic will be + * directed back to the primary pool in the "force" mode, where traffic + * will be spread to the healthy instances with the + * best effort, or to all instances when no instance is healthy. * @type array|\Google\Protobuf\Internal\RepeatedField $health_checks - * The URL of the HttpHealthCheck resource. A member instance in this pool is considered healthy if and only if the health checks pass. Only legacy HttpHealthChecks are supported. Only one health check may be specified. + * The URL of the HttpHealthCheck resource. A member instance in this + * pool is considered healthy if and only if the health checks pass. + * Only legacy HttpHealthChecks are supported. Only one health check may be + * specified. * @type int|string $id - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * @type array|\Google\Protobuf\Internal\RepeatedField $instances - * A list of resource URLs to the virtual machine instances serving this pool. They must live in zones contained in the same region as this pool. + * A list of resource URLs to the virtual machine instances serving this pool. + * They must live in zones contained in the same region as this pool. * @type string $kind - * [Output Only] Type of the resource. Always compute#targetPool for target pools. + * [Output Only] Type of the resource. Always compute#targetPool + * for target pools. * @type string $name - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * @type string $region * [Output Only] URL of the region where the target pool resides. * @type string $security_policy - * [Output Only] The resource URL for the security policy associated with this target pool. + * [Output Only] The resource URL for the security policy associated with this + * target pool. * @type string $self_link * [Output Only] Server-defined URL for the resource. * @type string $session_affinity - * Session affinity option, must be one of the following values: NONE: Connections from the same client IP may go to any instance in the pool. CLIENT_IP: Connections from the same client IP will go to the same instance in the pool while that instance remains healthy. CLIENT_IP_PROTO: Connections from the same client IP with the same IP protocol will go to the same instance in the pool while that instance remains healthy. + * Session affinity option, must be one of the following values: + * NONE: Connections from the same client IP may go to any + * instance in the pool. + * CLIENT_IP: Connections from the same client IP will go + * to the same instance in + * the pool while that instance remains healthy. + * CLIENT_IP_PROTO: Connections from the same client IP + * with the same IP protocol will go to the same instance in the + * pool while that instance remains healthy. * Check the SessionAffinity enum for the list of possible values. * } */ @@ -136,7 +232,18 @@ public function __construct($data = NULL) { } /** - * The server-defined URL for the resource. This field is applicable only when the containing target pool is serving a forwarding rule as the primary pool, and its failoverRatio field is properly set to a value between [0, 1]. backupPool and failoverRatio together define the fallback behavior of the primary target pool: if the ratio of the healthy instances in the primary pool is at or below failoverRatio, traffic arriving at the load-balanced IP will be directed to the backup pool. In case where failoverRatio and backupPool are not set, or all the instances in the backup pool are unhealthy, the traffic will be directed back to the primary pool in the "force" mode, where traffic will be spread to the healthy instances with the best effort, or to all instances when no instance is healthy. + * The server-defined URL for the resource. This field is applicable only when + * the containing target pool is serving a forwarding rule as the primary + * pool, and its failoverRatio field is properly set to a value + * between [0, 1].backupPool and failoverRatio together define + * the fallback behavior of the primary target pool: if the ratio of the + * healthy instances in the primary pool is at or belowfailoverRatio, traffic arriving at the load-balanced + * IP will be directed to the backup pool. + * In case where failoverRatio and backupPool + * are not set, or all the instances in the backup pool are unhealthy, + * the traffic will be directed back to the primary pool in the "force" + * mode, where traffic will be spread to the healthy instances with the + * best effort, or to all instances when no instance is healthy. * * Generated from protobuf field optional string backup_pool = 45884537; * @return string @@ -157,7 +264,18 @@ public function clearBackupPool() } /** - * The server-defined URL for the resource. This field is applicable only when the containing target pool is serving a forwarding rule as the primary pool, and its failoverRatio field is properly set to a value between [0, 1]. backupPool and failoverRatio together define the fallback behavior of the primary target pool: if the ratio of the healthy instances in the primary pool is at or below failoverRatio, traffic arriving at the load-balanced IP will be directed to the backup pool. In case where failoverRatio and backupPool are not set, or all the instances in the backup pool are unhealthy, the traffic will be directed back to the primary pool in the "force" mode, where traffic will be spread to the healthy instances with the best effort, or to all instances when no instance is healthy. + * The server-defined URL for the resource. This field is applicable only when + * the containing target pool is serving a forwarding rule as the primary + * pool, and its failoverRatio field is properly set to a value + * between [0, 1].backupPool and failoverRatio together define + * the fallback behavior of the primary target pool: if the ratio of the + * healthy instances in the primary pool is at or belowfailoverRatio, traffic arriving at the load-balanced + * IP will be directed to the backup pool. + * In case where failoverRatio and backupPool + * are not set, or all the instances in the backup pool are unhealthy, + * the traffic will be directed back to the primary pool in the "force" + * mode, where traffic will be spread to the healthy instances with the + * best effort, or to all instances when no instance is healthy. * * Generated from protobuf field optional string backup_pool = 45884537; * @param string $var @@ -172,7 +290,8 @@ public function setBackupPool($var) } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @return string @@ -193,7 +312,8 @@ public function clearCreationTimestamp() } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @param string $var @@ -208,7 +328,8 @@ public function setCreationTimestamp($var) } /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @return string @@ -229,7 +350,8 @@ public function clearDescription() } /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @param string $var @@ -244,7 +366,19 @@ public function setDescription($var) } /** - * This field is applicable only when the containing target pool is serving a forwarding rule as the primary pool (i.e., not as a backup pool to some other target pool). The value of the field must be in [0, 1]. If set, backupPool must also be set. They together define the fallback behavior of the primary target pool: if the ratio of the healthy instances in the primary pool is at or below this number, traffic arriving at the load-balanced IP will be directed to the backup pool. In case where failoverRatio is not set or all the instances in the backup pool are unhealthy, the traffic will be directed back to the primary pool in the "force" mode, where traffic will be spread to the healthy instances with the best effort, or to all instances when no instance is healthy. + * This field is applicable only when the containing target pool is serving a + * forwarding rule as the primary pool (i.e., not as a backup pool to some + * other target pool). The value of the field must be in [0, 1]. + * If set, backupPool must also be set. They together define + * the fallback behavior of the primary target pool: if the ratio of the + * healthy instances in the primary pool is at or below this number, + * traffic arriving at the load-balanced IP will be directed to the + * backup pool. + * In case where failoverRatio is not set or all the + * instances in the backup pool are unhealthy, the traffic will be + * directed back to the primary pool in the "force" mode, where traffic + * will be spread to the healthy instances with the + * best effort, or to all instances when no instance is healthy. * * Generated from protobuf field optional float failover_ratio = 212667006; * @return float @@ -265,7 +399,19 @@ public function clearFailoverRatio() } /** - * This field is applicable only when the containing target pool is serving a forwarding rule as the primary pool (i.e., not as a backup pool to some other target pool). The value of the field must be in [0, 1]. If set, backupPool must also be set. They together define the fallback behavior of the primary target pool: if the ratio of the healthy instances in the primary pool is at or below this number, traffic arriving at the load-balanced IP will be directed to the backup pool. In case where failoverRatio is not set or all the instances in the backup pool are unhealthy, the traffic will be directed back to the primary pool in the "force" mode, where traffic will be spread to the healthy instances with the best effort, or to all instances when no instance is healthy. + * This field is applicable only when the containing target pool is serving a + * forwarding rule as the primary pool (i.e., not as a backup pool to some + * other target pool). The value of the field must be in [0, 1]. + * If set, backupPool must also be set. They together define + * the fallback behavior of the primary target pool: if the ratio of the + * healthy instances in the primary pool is at or below this number, + * traffic arriving at the load-balanced IP will be directed to the + * backup pool. + * In case where failoverRatio is not set or all the + * instances in the backup pool are unhealthy, the traffic will be + * directed back to the primary pool in the "force" mode, where traffic + * will be spread to the healthy instances with the + * best effort, or to all instances when no instance is healthy. * * Generated from protobuf field optional float failover_ratio = 212667006; * @param float $var @@ -280,7 +426,10 @@ public function setFailoverRatio($var) } /** - * The URL of the HttpHealthCheck resource. A member instance in this pool is considered healthy if and only if the health checks pass. Only legacy HttpHealthChecks are supported. Only one health check may be specified. + * The URL of the HttpHealthCheck resource. A member instance in this + * pool is considered healthy if and only if the health checks pass. + * Only legacy HttpHealthChecks are supported. Only one health check may be + * specified. * * Generated from protobuf field repeated string health_checks = 448370606; * @return \Google\Protobuf\Internal\RepeatedField @@ -291,7 +440,10 @@ public function getHealthChecks() } /** - * The URL of the HttpHealthCheck resource. A member instance in this pool is considered healthy if and only if the health checks pass. Only legacy HttpHealthChecks are supported. Only one health check may be specified. + * The URL of the HttpHealthCheck resource. A member instance in this + * pool is considered healthy if and only if the health checks pass. + * Only legacy HttpHealthChecks are supported. Only one health check may be + * specified. * * Generated from protobuf field repeated string health_checks = 448370606; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -306,7 +458,8 @@ public function setHealthChecks($var) } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @return int|string @@ -327,7 +480,8 @@ public function clearId() } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @param int|string $var @@ -342,7 +496,8 @@ public function setId($var) } /** - * A list of resource URLs to the virtual machine instances serving this pool. They must live in zones contained in the same region as this pool. + * A list of resource URLs to the virtual machine instances serving this pool. + * They must live in zones contained in the same region as this pool. * * Generated from protobuf field repeated string instances = 29097598; * @return \Google\Protobuf\Internal\RepeatedField @@ -353,7 +508,8 @@ public function getInstances() } /** - * A list of resource URLs to the virtual machine instances serving this pool. They must live in zones contained in the same region as this pool. + * A list of resource URLs to the virtual machine instances serving this pool. + * They must live in zones contained in the same region as this pool. * * Generated from protobuf field repeated string instances = 29097598; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -368,7 +524,8 @@ public function setInstances($var) } /** - * [Output Only] Type of the resource. Always compute#targetPool for target pools. + * [Output Only] Type of the resource. Always compute#targetPool + * for target pools. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -389,7 +546,8 @@ public function clearKind() } /** - * [Output Only] Type of the resource. Always compute#targetPool for target pools. + * [Output Only] Type of the resource. Always compute#targetPool + * for target pools. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -404,7 +562,13 @@ public function setKind($var) } /** - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * * Generated from protobuf field optional string name = 3373707; * @return string @@ -425,7 +589,13 @@ public function clearName() } /** - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * * Generated from protobuf field optional string name = 3373707; * @param string $var @@ -476,7 +646,8 @@ public function setRegion($var) } /** - * [Output Only] The resource URL for the security policy associated with this target pool. + * [Output Only] The resource URL for the security policy associated with this + * target pool. * * Generated from protobuf field optional string security_policy = 171082513; * @return string @@ -497,7 +668,8 @@ public function clearSecurityPolicy() } /** - * [Output Only] The resource URL for the security policy associated with this target pool. + * [Output Only] The resource URL for the security policy associated with this + * target pool. * * Generated from protobuf field optional string security_policy = 171082513; * @param string $var @@ -548,7 +720,15 @@ public function setSelfLink($var) } /** - * Session affinity option, must be one of the following values: NONE: Connections from the same client IP may go to any instance in the pool. CLIENT_IP: Connections from the same client IP will go to the same instance in the pool while that instance remains healthy. CLIENT_IP_PROTO: Connections from the same client IP with the same IP protocol will go to the same instance in the pool while that instance remains healthy. + * Session affinity option, must be one of the following values: + * NONE: Connections from the same client IP may go to any + * instance in the pool. + * CLIENT_IP: Connections from the same client IP will go + * to the same instance in + * the pool while that instance remains healthy. + * CLIENT_IP_PROTO: Connections from the same client IP + * with the same IP protocol will go to the same instance in the + * pool while that instance remains healthy. * Check the SessionAffinity enum for the list of possible values. * * Generated from protobuf field optional string session_affinity = 463888561; @@ -570,7 +750,15 @@ public function clearSessionAffinity() } /** - * Session affinity option, must be one of the following values: NONE: Connections from the same client IP may go to any instance in the pool. CLIENT_IP: Connections from the same client IP will go to the same instance in the pool while that instance remains healthy. CLIENT_IP_PROTO: Connections from the same client IP with the same IP protocol will go to the same instance in the pool while that instance remains healthy. + * Session affinity option, must be one of the following values: + * NONE: Connections from the same client IP may go to any + * instance in the pool. + * CLIENT_IP: Connections from the same client IP will go + * to the same instance in + * the pool while that instance remains healthy. + * CLIENT_IP_PROTO: Connections from the same client IP + * with the same IP protocol will go to the same instance in the + * pool while that instance remains healthy. * Check the SessionAffinity enum for the list of possible values. * * Generated from protobuf field optional string session_affinity = 463888561; diff --git a/Compute/src/V1/TargetPool/SessionAffinity.php b/Compute/src/V1/TargetPool/SessionAffinity.php index cbccd93dcce7..45e9ec47b2be 100644 --- a/Compute/src/V1/TargetPool/SessionAffinity.php +++ b/Compute/src/V1/TargetPool/SessionAffinity.php @@ -7,7 +7,15 @@ use UnexpectedValueException; /** - * Session affinity option, must be one of the following values: NONE: Connections from the same client IP may go to any instance in the pool. CLIENT_IP: Connections from the same client IP will go to the same instance in the pool while that instance remains healthy. CLIENT_IP_PROTO: Connections from the same client IP with the same IP protocol will go to the same instance in the pool while that instance remains healthy. + * Session affinity option, must be one of the following values: + * NONE: Connections from the same client IP may go to any + * instance in the pool. + * CLIENT_IP: Connections from the same client IP will go + * to the same instance in + * the pool while that instance remains healthy. + * CLIENT_IP_PROTO: Connections from the same client IP + * with the same IP protocol will go to the same instance in the + * pool while that instance remains healthy. * * Protobuf type google.cloud.compute.v1.TargetPool.SessionAffinity */ @@ -20,31 +28,45 @@ class SessionAffinity */ const UNDEFINED_SESSION_AFFINITY = 0; /** - * 2-tuple hash on packet's source and destination IP addresses. Connections from the same source IP address to the same destination IP address will be served by the same backend VM while that VM remains healthy. + * 2-tuple hash on packet's source and destination IP addresses. Connections + * from the same source IP address to the same destination IP address will be + * served by the same backend VM while that VM remains healthy. * * Generated from protobuf enum CLIENT_IP = 345665051; */ const CLIENT_IP = 345665051; /** - * 1-tuple hash only on packet's source IP address. Connections from the same source IP address will be served by the same backend VM while that VM remains healthy. This option can only be used for Internal TCP/UDP Load Balancing. + * 1-tuple hash only on packet's source IP address. Connections from the + * same source IP address will be served by the same backend VM while that VM + * remains healthy. This option can only be used for Internal TCP/UDP + * Load Balancing. * * Generated from protobuf enum CLIENT_IP_NO_DESTINATION = 106122516; */ const CLIENT_IP_NO_DESTINATION = 106122516; /** - * 5-tuple hash on packet's source and destination IP addresses, IP protocol, and source and destination ports. Connections for the same IP protocol from the same source IP address and port to the same destination IP address and port will be served by the same backend VM while that VM remains healthy. This option cannot be used for HTTP(S) load balancing. + * 5-tuple hash on packet's source and destination IP addresses, IP protocol, + * and source and destination ports. Connections for the same IP protocol + * from the same source IP address and port to the same destination IP address + * and port will be served by the same backend VM while that VM remains + * healthy. This option cannot be used for HTTP(S) load balancing. * * Generated from protobuf enum CLIENT_IP_PORT_PROTO = 221722926; */ const CLIENT_IP_PORT_PROTO = 221722926; /** - * 3-tuple hash on packet's source and destination IP addresses, and IP protocol. Connections for the same IP protocol from the same source IP address to the same destination IP address will be served by the same backend VM while that VM remains healthy. This option cannot be used for HTTP(S) load balancing. + * 3-tuple hash on packet's source and destination IP addresses, and IP + * protocol. Connections for the same IP protocol from the same source IP + * address to the same destination IP address will be served by the same + * backend VM while that VM remains healthy. This option cannot be used for + * HTTP(S) load balancing. * * Generated from protobuf enum CLIENT_IP_PROTO = 25322148; */ const CLIENT_IP_PROTO = 25322148; /** - * Hash based on a cookie generated by the L7 loadbalancer. Only valid for HTTP(S) load balancing. + * Hash based on a cookie generated by the L7 loadbalancer. + * Only valid for HTTP(S) load balancing. * * Generated from protobuf enum GENERATED_COOKIE = 370321204; */ @@ -62,13 +84,16 @@ class SessionAffinity */ const HTTP_COOKIE = 494981627; /** - * No session affinity. Connections from the same client IP may go to any instance in the pool. + * No session affinity. Connections from the same client IP may go + * to any instance in the pool. * * Generated from protobuf enum NONE = 2402104; */ const NONE = 2402104; /** - * Strong cookie-based affinity. Connections bearing the same cookie will be served by the same backend VM while that VM remains healthy, as long as the cookie has not expired. + * Strong cookie-based affinity. Connections bearing the same cookie will be + * served by the same backend VM while that VM remains healthy, as long as the + * cookie has not expired. * * Generated from protobuf enum STRONG_COOKIE_AFFINITY = 438628091; */ diff --git a/Compute/src/V1/TargetPoolAggregatedList.php b/Compute/src/V1/TargetPoolAggregatedList.php index 95c29e9e33fc..cdd0509872ef 100644 --- a/Compute/src/V1/TargetPoolAggregatedList.php +++ b/Compute/src/V1/TargetPoolAggregatedList.php @@ -27,13 +27,18 @@ class TargetPoolAggregatedList extends \Google\Protobuf\Internal\Message */ private $items; /** - * [Output Only] Type of resource. Always compute#targetPoolAggregatedList for aggregated lists of target pools. + * [Output Only] Type of resource. Alwayscompute#targetPoolAggregatedList for aggregated lists of + * target pools. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -68,9 +73,14 @@ class TargetPoolAggregatedList extends \Google\Protobuf\Internal\Message * @type array|\Google\Protobuf\Internal\MapField $items * A list of TargetPool resources. * @type string $kind - * [Output Only] Type of resource. Always compute#targetPoolAggregatedList for aggregated lists of target pools. + * [Output Only] Type of resource. Alwayscompute#targetPoolAggregatedList for aggregated lists of + * target pools. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type array|\Google\Protobuf\Internal\RepeatedField $unreachables @@ -147,7 +157,8 @@ public function setItems($var) } /** - * [Output Only] Type of resource. Always compute#targetPoolAggregatedList for aggregated lists of target pools. + * [Output Only] Type of resource. Alwayscompute#targetPoolAggregatedList for aggregated lists of + * target pools. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -168,7 +179,8 @@ public function clearKind() } /** - * [Output Only] Type of resource. Always compute#targetPoolAggregatedList for aggregated lists of target pools. + * [Output Only] Type of resource. Alwayscompute#targetPoolAggregatedList for aggregated lists of + * target pools. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -183,7 +195,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -204,7 +220,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/TargetPoolInstanceHealth.php b/Compute/src/V1/TargetPoolInstanceHealth.php index e27ad1afe6ef..ef09705ccd36 100644 --- a/Compute/src/V1/TargetPoolInstanceHealth.php +++ b/Compute/src/V1/TargetPoolInstanceHealth.php @@ -19,7 +19,8 @@ class TargetPoolInstanceHealth extends \Google\Protobuf\Internal\Message */ private $health_status; /** - * [Output Only] Type of resource. Always compute#targetPoolInstanceHealth when checking the health of an instance. + * [Output Only] Type of resource. Alwayscompute#targetPoolInstanceHealth when checking the health of + * an instance. * * Generated from protobuf field optional string kind = 3292052; */ @@ -33,7 +34,8 @@ class TargetPoolInstanceHealth extends \Google\Protobuf\Internal\Message * * @type array<\Google\Cloud\Compute\V1\HealthStatus>|\Google\Protobuf\Internal\RepeatedField $health_status * @type string $kind - * [Output Only] Type of resource. Always compute#targetPoolInstanceHealth when checking the health of an instance. + * [Output Only] Type of resource. Alwayscompute#targetPoolInstanceHealth when checking the health of + * an instance. * } */ public function __construct($data = NULL) { @@ -64,7 +66,8 @@ public function setHealthStatus($var) } /** - * [Output Only] Type of resource. Always compute#targetPoolInstanceHealth when checking the health of an instance. + * [Output Only] Type of resource. Alwayscompute#targetPoolInstanceHealth when checking the health of + * an instance. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -85,7 +88,8 @@ public function clearKind() } /** - * [Output Only] Type of resource. Always compute#targetPoolInstanceHealth when checking the health of an instance. + * [Output Only] Type of resource. Alwayscompute#targetPoolInstanceHealth when checking the health of + * an instance. * * Generated from protobuf field optional string kind = 3292052; * @param string $var diff --git a/Compute/src/V1/TargetPoolList.php b/Compute/src/V1/TargetPoolList.php index 7e64e3948482..3c46d10690cb 100644 --- a/Compute/src/V1/TargetPoolList.php +++ b/Compute/src/V1/TargetPoolList.php @@ -28,13 +28,18 @@ class TargetPoolList extends \Google\Protobuf\Internal\Message */ private $items; /** - * [Output Only] Type of resource. Always compute#targetPoolList for lists of target pools. + * [Output Only] Type of resource. Always compute#targetPoolList + * for lists of target pools. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -63,9 +68,14 @@ class TargetPoolList extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\TargetPool>|\Google\Protobuf\Internal\RepeatedField $items * A list of TargetPool resources. * @type string $kind - * [Output Only] Type of resource. Always compute#targetPoolList for lists of target pools. + * [Output Only] Type of resource. Always compute#targetPoolList + * for lists of target pools. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type \Google\Cloud\Compute\V1\Warning $warning @@ -140,7 +150,8 @@ public function setItems($var) } /** - * [Output Only] Type of resource. Always compute#targetPoolList for lists of target pools. + * [Output Only] Type of resource. Always compute#targetPoolList + * for lists of target pools. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -161,7 +172,8 @@ public function clearKind() } /** - * [Output Only] Type of resource. Always compute#targetPoolList for lists of target pools. + * [Output Only] Type of resource. Always compute#targetPoolList + * for lists of target pools. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -176,7 +188,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -197,7 +213,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/TargetPoolsAddInstanceRequest.php b/Compute/src/V1/TargetPoolsAddInstanceRequest.php index 4835aa9b40e8..fbe381c89857 100644 --- a/Compute/src/V1/TargetPoolsAddInstanceRequest.php +++ b/Compute/src/V1/TargetPoolsAddInstanceRequest.php @@ -15,7 +15,11 @@ class TargetPoolsAddInstanceRequest extends \Google\Protobuf\Internal\Message { /** - * A full or partial URL to an instance to add to this target pool. This can be a full or partial URL. For example, the following are valid URLs: - https://www.googleapis.com/compute/v1/projects/project-id/zones/zone /instances/instance-name - projects/project-id/zones/zone/instances/instance-name - zones/zone/instances/instance-name + * A full or partial URL to an instance to add to this target pool. This can + * be a full or partial URL. For example, the following are valid URLs: + * - https://www.googleapis.com/compute/v1/projects/project-id/zones/zone/instances/instance-name + * - projects/project-id/zones/zone/instances/instance-name + * - zones/zone/instances/instance-name * * Generated from protobuf field repeated .google.cloud.compute.v1.InstanceReference instances = 29097598; */ @@ -28,7 +32,11 @@ class TargetPoolsAddInstanceRequest extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type array<\Google\Cloud\Compute\V1\InstanceReference>|\Google\Protobuf\Internal\RepeatedField $instances - * A full or partial URL to an instance to add to this target pool. This can be a full or partial URL. For example, the following are valid URLs: - https://www.googleapis.com/compute/v1/projects/project-id/zones/zone /instances/instance-name - projects/project-id/zones/zone/instances/instance-name - zones/zone/instances/instance-name + * A full or partial URL to an instance to add to this target pool. This can + * be a full or partial URL. For example, the following are valid URLs: + * - https://www.googleapis.com/compute/v1/projects/project-id/zones/zone/instances/instance-name + * - projects/project-id/zones/zone/instances/instance-name + * - zones/zone/instances/instance-name * } */ public function __construct($data = NULL) { @@ -37,7 +45,11 @@ public function __construct($data = NULL) { } /** - * A full or partial URL to an instance to add to this target pool. This can be a full or partial URL. For example, the following are valid URLs: - https://www.googleapis.com/compute/v1/projects/project-id/zones/zone /instances/instance-name - projects/project-id/zones/zone/instances/instance-name - zones/zone/instances/instance-name + * A full or partial URL to an instance to add to this target pool. This can + * be a full or partial URL. For example, the following are valid URLs: + * - https://www.googleapis.com/compute/v1/projects/project-id/zones/zone/instances/instance-name + * - projects/project-id/zones/zone/instances/instance-name + * - zones/zone/instances/instance-name * * Generated from protobuf field repeated .google.cloud.compute.v1.InstanceReference instances = 29097598; * @return \Google\Protobuf\Internal\RepeatedField @@ -48,7 +60,11 @@ public function getInstances() } /** - * A full or partial URL to an instance to add to this target pool. This can be a full or partial URL. For example, the following are valid URLs: - https://www.googleapis.com/compute/v1/projects/project-id/zones/zone /instances/instance-name - projects/project-id/zones/zone/instances/instance-name - zones/zone/instances/instance-name + * A full or partial URL to an instance to add to this target pool. This can + * be a full or partial URL. For example, the following are valid URLs: + * - https://www.googleapis.com/compute/v1/projects/project-id/zones/zone/instances/instance-name + * - projects/project-id/zones/zone/instances/instance-name + * - zones/zone/instances/instance-name * * Generated from protobuf field repeated .google.cloud.compute.v1.InstanceReference instances = 29097598; * @param array<\Google\Cloud\Compute\V1\InstanceReference>|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/TargetPoolsRemoveHealthCheckRequest.php b/Compute/src/V1/TargetPoolsRemoveHealthCheckRequest.php index e6c120a5c3e3..94cbc6caa462 100644 --- a/Compute/src/V1/TargetPoolsRemoveHealthCheckRequest.php +++ b/Compute/src/V1/TargetPoolsRemoveHealthCheckRequest.php @@ -15,7 +15,11 @@ class TargetPoolsRemoveHealthCheckRequest extends \Google\Protobuf\Internal\Message { /** - * Health check URL to be removed. This can be a full or valid partial URL. For example, the following are valid URLs: - https://www.googleapis.com/compute/beta/projects/project /global/httpHealthChecks/health-check - projects/project/global/httpHealthChecks/health-check - global/httpHealthChecks/health-check + * Health check URL to be removed. This can be a full or valid partial URL. + * For example, the following are valid URLs: + * - https://www.googleapis.com/compute/beta/projects/project/global/httpHealthChecks/health-check + * - projects/project/global/httpHealthChecks/health-check + * - global/httpHealthChecks/health-check * * Generated from protobuf field repeated .google.cloud.compute.v1.HealthCheckReference health_checks = 448370606; */ @@ -28,7 +32,11 @@ class TargetPoolsRemoveHealthCheckRequest extends \Google\Protobuf\Internal\Mess * Optional. Data for populating the Message object. * * @type array<\Google\Cloud\Compute\V1\HealthCheckReference>|\Google\Protobuf\Internal\RepeatedField $health_checks - * Health check URL to be removed. This can be a full or valid partial URL. For example, the following are valid URLs: - https://www.googleapis.com/compute/beta/projects/project /global/httpHealthChecks/health-check - projects/project/global/httpHealthChecks/health-check - global/httpHealthChecks/health-check + * Health check URL to be removed. This can be a full or valid partial URL. + * For example, the following are valid URLs: + * - https://www.googleapis.com/compute/beta/projects/project/global/httpHealthChecks/health-check + * - projects/project/global/httpHealthChecks/health-check + * - global/httpHealthChecks/health-check * } */ public function __construct($data = NULL) { @@ -37,7 +45,11 @@ public function __construct($data = NULL) { } /** - * Health check URL to be removed. This can be a full or valid partial URL. For example, the following are valid URLs: - https://www.googleapis.com/compute/beta/projects/project /global/httpHealthChecks/health-check - projects/project/global/httpHealthChecks/health-check - global/httpHealthChecks/health-check + * Health check URL to be removed. This can be a full or valid partial URL. + * For example, the following are valid URLs: + * - https://www.googleapis.com/compute/beta/projects/project/global/httpHealthChecks/health-check + * - projects/project/global/httpHealthChecks/health-check + * - global/httpHealthChecks/health-check * * Generated from protobuf field repeated .google.cloud.compute.v1.HealthCheckReference health_checks = 448370606; * @return \Google\Protobuf\Internal\RepeatedField @@ -48,7 +60,11 @@ public function getHealthChecks() } /** - * Health check URL to be removed. This can be a full or valid partial URL. For example, the following are valid URLs: - https://www.googleapis.com/compute/beta/projects/project /global/httpHealthChecks/health-check - projects/project/global/httpHealthChecks/health-check - global/httpHealthChecks/health-check + * Health check URL to be removed. This can be a full or valid partial URL. + * For example, the following are valid URLs: + * - https://www.googleapis.com/compute/beta/projects/project/global/httpHealthChecks/health-check + * - projects/project/global/httpHealthChecks/health-check + * - global/httpHealthChecks/health-check * * Generated from protobuf field repeated .google.cloud.compute.v1.HealthCheckReference health_checks = 448370606; * @param array<\Google\Cloud\Compute\V1\HealthCheckReference>|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/TargetPoolsScopedList.php b/Compute/src/V1/TargetPoolsScopedList.php index 2494aac4383b..504fba1e823f 100644 --- a/Compute/src/V1/TargetPoolsScopedList.php +++ b/Compute/src/V1/TargetPoolsScopedList.php @@ -21,7 +21,8 @@ class TargetPoolsScopedList extends \Google\Protobuf\Internal\Message */ private $target_pools; /** - * Informational warning which replaces the list of addresses when the list is empty. + * Informational warning which replaces the list of addresses when + * the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; */ @@ -36,7 +37,8 @@ class TargetPoolsScopedList extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\TargetPool>|\Google\Protobuf\Internal\RepeatedField $target_pools * A list of target pools contained in this scope. * @type \Google\Cloud\Compute\V1\Warning $warning - * Informational warning which replaces the list of addresses when the list is empty. + * Informational warning which replaces the list of addresses when + * the list is empty. * } */ public function __construct($data = NULL) { @@ -71,7 +73,8 @@ public function setTargetPools($var) } /** - * Informational warning which replaces the list of addresses when the list is empty. + * Informational warning which replaces the list of addresses when + * the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; * @return \Google\Cloud\Compute\V1\Warning|null @@ -92,7 +95,8 @@ public function clearWarning() } /** - * Informational warning which replaces the list of addresses when the list is empty. + * Informational warning which replaces the list of addresses when + * the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; * @param \Google\Cloud\Compute\V1\Warning $var diff --git a/Compute/src/V1/TargetSslProxiesSetCertificateMapRequest.php b/Compute/src/V1/TargetSslProxiesSetCertificateMapRequest.php index 20c8a97e34d6..192750c8d90f 100644 --- a/Compute/src/V1/TargetSslProxiesSetCertificateMapRequest.php +++ b/Compute/src/V1/TargetSslProxiesSetCertificateMapRequest.php @@ -15,7 +15,8 @@ class TargetSslProxiesSetCertificateMapRequest extends \Google\Protobuf\Internal\Message { /** - * URL of the Certificate Map to associate with this TargetSslProxy. Accepted format is //certificatemanager.googleapis.com/projects/{project }/locations/{location}/certificateMaps/{resourceName}. + * URL of the Certificate Map to associate with this TargetSslProxy. + * Accepted format is//certificatemanager.googleapis.com/projects/{project}/locations/{location}/certificateMaps/{resourceName}. * * Generated from protobuf field optional string certificate_map = 156463796; */ @@ -28,7 +29,8 @@ class TargetSslProxiesSetCertificateMapRequest extends \Google\Protobuf\Internal * Optional. Data for populating the Message object. * * @type string $certificate_map - * URL of the Certificate Map to associate with this TargetSslProxy. Accepted format is //certificatemanager.googleapis.com/projects/{project }/locations/{location}/certificateMaps/{resourceName}. + * URL of the Certificate Map to associate with this TargetSslProxy. + * Accepted format is//certificatemanager.googleapis.com/projects/{project}/locations/{location}/certificateMaps/{resourceName}. * } */ public function __construct($data = NULL) { @@ -37,7 +39,8 @@ public function __construct($data = NULL) { } /** - * URL of the Certificate Map to associate with this TargetSslProxy. Accepted format is //certificatemanager.googleapis.com/projects/{project }/locations/{location}/certificateMaps/{resourceName}. + * URL of the Certificate Map to associate with this TargetSslProxy. + * Accepted format is//certificatemanager.googleapis.com/projects/{project}/locations/{location}/certificateMaps/{resourceName}. * * Generated from protobuf field optional string certificate_map = 156463796; * @return string @@ -58,7 +61,8 @@ public function clearCertificateMap() } /** - * URL of the Certificate Map to associate with this TargetSslProxy. Accepted format is //certificatemanager.googleapis.com/projects/{project }/locations/{location}/certificateMaps/{resourceName}. + * URL of the Certificate Map to associate with this TargetSslProxy. + * Accepted format is//certificatemanager.googleapis.com/projects/{project}/locations/{location}/certificateMaps/{resourceName}. * * Generated from protobuf field optional string certificate_map = 156463796; * @param string $var diff --git a/Compute/src/V1/TargetSslProxiesSetProxyHeaderRequest.php b/Compute/src/V1/TargetSslProxiesSetProxyHeaderRequest.php index f2bc6b788640..58744ea8a780 100644 --- a/Compute/src/V1/TargetSslProxiesSetProxyHeaderRequest.php +++ b/Compute/src/V1/TargetSslProxiesSetProxyHeaderRequest.php @@ -15,7 +15,8 @@ class TargetSslProxiesSetProxyHeaderRequest extends \Google\Protobuf\Internal\Message { /** - * The new type of proxy header to append before sending data to the backend. NONE or PROXY_V1 are allowed. + * The new type of proxy header to append before sending data to the + * backend. NONE or PROXY_V1 are allowed. * Check the ProxyHeader enum for the list of possible values. * * Generated from protobuf field optional string proxy_header = 160374142; @@ -29,7 +30,8 @@ class TargetSslProxiesSetProxyHeaderRequest extends \Google\Protobuf\Internal\Me * Optional. Data for populating the Message object. * * @type string $proxy_header - * The new type of proxy header to append before sending data to the backend. NONE or PROXY_V1 are allowed. + * The new type of proxy header to append before sending data to the + * backend. NONE or PROXY_V1 are allowed. * Check the ProxyHeader enum for the list of possible values. * } */ @@ -39,7 +41,8 @@ public function __construct($data = NULL) { } /** - * The new type of proxy header to append before sending data to the backend. NONE or PROXY_V1 are allowed. + * The new type of proxy header to append before sending data to the + * backend. NONE or PROXY_V1 are allowed. * Check the ProxyHeader enum for the list of possible values. * * Generated from protobuf field optional string proxy_header = 160374142; @@ -61,7 +64,8 @@ public function clearProxyHeader() } /** - * The new type of proxy header to append before sending data to the backend. NONE or PROXY_V1 are allowed. + * The new type of proxy header to append before sending data to the + * backend. NONE or PROXY_V1 are allowed. * Check the ProxyHeader enum for the list of possible values. * * Generated from protobuf field optional string proxy_header = 160374142; diff --git a/Compute/src/V1/TargetSslProxiesSetProxyHeaderRequest/ProxyHeader.php b/Compute/src/V1/TargetSslProxiesSetProxyHeaderRequest/ProxyHeader.php index 1501b2aae2f9..28732857809b 100644 --- a/Compute/src/V1/TargetSslProxiesSetProxyHeaderRequest/ProxyHeader.php +++ b/Compute/src/V1/TargetSslProxiesSetProxyHeaderRequest/ProxyHeader.php @@ -7,7 +7,8 @@ use UnexpectedValueException; /** - * The new type of proxy header to append before sending data to the backend. NONE or PROXY_V1 are allowed. + * The new type of proxy header to append before sending data to the + * backend. NONE or PROXY_V1 are allowed. * * Protobuf type google.cloud.compute.v1.TargetSslProxiesSetProxyHeaderRequest.ProxyHeader */ diff --git a/Compute/src/V1/TargetSslProxiesSetSslCertificatesRequest.php b/Compute/src/V1/TargetSslProxiesSetSslCertificatesRequest.php index 7586dd6479fe..30c3abc98069 100644 --- a/Compute/src/V1/TargetSslProxiesSetSslCertificatesRequest.php +++ b/Compute/src/V1/TargetSslProxiesSetSslCertificatesRequest.php @@ -15,7 +15,9 @@ class TargetSslProxiesSetSslCertificatesRequest extends \Google\Protobuf\Internal\Message { /** - * New set of URLs to SslCertificate resources to associate with this TargetSslProxy. At least one SSL certificate must be specified. Currently, you may specify up to 15 SSL certificates. + * New set of URLs to SslCertificate resources to associate with this + * TargetSslProxy. At least one SSL certificate must be specified. + * Currently, you may specify up to 15 SSL certificates. * * Generated from protobuf field repeated string ssl_certificates = 366006543; */ @@ -28,7 +30,9 @@ class TargetSslProxiesSetSslCertificatesRequest extends \Google\Protobuf\Interna * Optional. Data for populating the Message object. * * @type array|\Google\Protobuf\Internal\RepeatedField $ssl_certificates - * New set of URLs to SslCertificate resources to associate with this TargetSslProxy. At least one SSL certificate must be specified. Currently, you may specify up to 15 SSL certificates. + * New set of URLs to SslCertificate resources to associate with this + * TargetSslProxy. At least one SSL certificate must be specified. + * Currently, you may specify up to 15 SSL certificates. * } */ public function __construct($data = NULL) { @@ -37,7 +41,9 @@ public function __construct($data = NULL) { } /** - * New set of URLs to SslCertificate resources to associate with this TargetSslProxy. At least one SSL certificate must be specified. Currently, you may specify up to 15 SSL certificates. + * New set of URLs to SslCertificate resources to associate with this + * TargetSslProxy. At least one SSL certificate must be specified. + * Currently, you may specify up to 15 SSL certificates. * * Generated from protobuf field repeated string ssl_certificates = 366006543; * @return \Google\Protobuf\Internal\RepeatedField @@ -48,7 +54,9 @@ public function getSslCertificates() } /** - * New set of URLs to SslCertificate resources to associate with this TargetSslProxy. At least one SSL certificate must be specified. Currently, you may specify up to 15 SSL certificates. + * New set of URLs to SslCertificate resources to associate with this + * TargetSslProxy. At least one SSL certificate must be specified. + * Currently, you may specify up to 15 SSL certificates. * * Generated from protobuf field repeated string ssl_certificates = 366006543; * @param array|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/TargetSslProxy.php b/Compute/src/V1/TargetSslProxy.php index 9c3743b078de..8a7ef14785fc 100644 --- a/Compute/src/V1/TargetSslProxy.php +++ b/Compute/src/V1/TargetSslProxy.php @@ -9,50 +9,69 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Represents a Target SSL Proxy resource. A target SSL proxy is a component of a Proxy Network Load Balancer. The forwarding rule references the target SSL proxy, and the target proxy then references a backend service. For more information, read Proxy Network Load Balancer overview. + * Represents a Target SSL Proxy resource. + * A target SSL proxy is a component of a Proxy Network Load Balancer. + * The forwarding rule references the target SSL proxy, and the target proxy + * then references a backend service. For more information, readProxy Network + * Load Balancer overview. * * Generated from protobuf message google.cloud.compute.v1.TargetSslProxy */ class TargetSslProxy extends \Google\Protobuf\Internal\Message { /** - * URL of a certificate map that identifies a certificate map associated with the given target proxy. This field can only be set for global target proxies. If set, sslCertificates will be ignored. Accepted format is //certificatemanager.googleapis.com/projects/{project }/locations/{location}/certificateMaps/{resourceName}. + * URL of a certificate map that identifies a certificate map associated with + * the given target proxy. + * This field can only be set for global target proxies. + * If set, sslCertificates will be ignored. + * Accepted format is//certificatemanager.googleapis.com/projects/{project}/locations/{location}/certificateMaps/{resourceName}. * * Generated from protobuf field optional string certificate_map = 156463796; */ protected $certificate_map = null; /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; */ protected $creation_timestamp = null; /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; */ protected $description = null; /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; */ protected $id = null; /** - * [Output Only] Type of the resource. Always compute#targetSslProxy for target SSL proxies. + * [Output Only] Type of the resource. Alwayscompute#targetSslProxy for target SSL proxies. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * * Generated from protobuf field optional string name = 3373707; */ protected $name = null; /** - * Specifies the type of proxy header to append before sending data to the backend, either NONE or PROXY_V1. The default is NONE. + * Specifies the type of proxy header to append before sending data to the + * backend, either NONE or PROXY_V1. The default + * is NONE. * Check the ProxyHeader enum for the list of possible values. * * Generated from protobuf field optional string proxy_header = 160374142; @@ -71,13 +90,19 @@ class TargetSslProxy extends \Google\Protobuf\Internal\Message */ protected $service = null; /** - * URLs to SslCertificate resources that are used to authenticate connections to Backends. At least one SSL certificate must be specified. Currently, you may specify up to 15 SSL certificates. sslCertificates do not apply when the load balancing scheme is set to INTERNAL_SELF_MANAGED. + * URLs to SslCertificate resources that are used to + * authenticate connections to Backends. At least one SSL certificate + * must be specified. Currently, you may specify up to 15 SSL certificates. + * sslCertificates do not apply when the load balancing scheme is set to + * INTERNAL_SELF_MANAGED. * * Generated from protobuf field repeated string ssl_certificates = 366006543; */ private $ssl_certificates; /** - * URL of SslPolicy resource that will be associated with the TargetSslProxy resource. If not set, the TargetSslProxy resource will not have any SSL policy configured. + * URL of SslPolicy resource that will be associated with the TargetSslProxy + * resource. If not set, the TargetSslProxy resource will not have any + * SSL policy configured. * * Generated from protobuf field optional string ssl_policy = 295190213; */ @@ -90,28 +115,49 @@ class TargetSslProxy extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $certificate_map - * URL of a certificate map that identifies a certificate map associated with the given target proxy. This field can only be set for global target proxies. If set, sslCertificates will be ignored. Accepted format is //certificatemanager.googleapis.com/projects/{project }/locations/{location}/certificateMaps/{resourceName}. + * URL of a certificate map that identifies a certificate map associated with + * the given target proxy. + * This field can only be set for global target proxies. + * If set, sslCertificates will be ignored. + * Accepted format is//certificatemanager.googleapis.com/projects/{project}/locations/{location}/certificateMaps/{resourceName}. * @type string $creation_timestamp - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * @type string $description - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * @type int|string $id - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * @type string $kind - * [Output Only] Type of the resource. Always compute#targetSslProxy for target SSL proxies. + * [Output Only] Type of the resource. Alwayscompute#targetSslProxy for target SSL proxies. * @type string $name - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * @type string $proxy_header - * Specifies the type of proxy header to append before sending data to the backend, either NONE or PROXY_V1. The default is NONE. + * Specifies the type of proxy header to append before sending data to the + * backend, either NONE or PROXY_V1. The default + * is NONE. * Check the ProxyHeader enum for the list of possible values. * @type string $self_link * [Output Only] Server-defined URL for the resource. * @type string $service * URL to the BackendService resource. * @type array|\Google\Protobuf\Internal\RepeatedField $ssl_certificates - * URLs to SslCertificate resources that are used to authenticate connections to Backends. At least one SSL certificate must be specified. Currently, you may specify up to 15 SSL certificates. sslCertificates do not apply when the load balancing scheme is set to INTERNAL_SELF_MANAGED. + * URLs to SslCertificate resources that are used to + * authenticate connections to Backends. At least one SSL certificate + * must be specified. Currently, you may specify up to 15 SSL certificates. + * sslCertificates do not apply when the load balancing scheme is set to + * INTERNAL_SELF_MANAGED. * @type string $ssl_policy - * URL of SslPolicy resource that will be associated with the TargetSslProxy resource. If not set, the TargetSslProxy resource will not have any SSL policy configured. + * URL of SslPolicy resource that will be associated with the TargetSslProxy + * resource. If not set, the TargetSslProxy resource will not have any + * SSL policy configured. * } */ public function __construct($data = NULL) { @@ -120,7 +166,11 @@ public function __construct($data = NULL) { } /** - * URL of a certificate map that identifies a certificate map associated with the given target proxy. This field can only be set for global target proxies. If set, sslCertificates will be ignored. Accepted format is //certificatemanager.googleapis.com/projects/{project }/locations/{location}/certificateMaps/{resourceName}. + * URL of a certificate map that identifies a certificate map associated with + * the given target proxy. + * This field can only be set for global target proxies. + * If set, sslCertificates will be ignored. + * Accepted format is//certificatemanager.googleapis.com/projects/{project}/locations/{location}/certificateMaps/{resourceName}. * * Generated from protobuf field optional string certificate_map = 156463796; * @return string @@ -141,7 +191,11 @@ public function clearCertificateMap() } /** - * URL of a certificate map that identifies a certificate map associated with the given target proxy. This field can only be set for global target proxies. If set, sslCertificates will be ignored. Accepted format is //certificatemanager.googleapis.com/projects/{project }/locations/{location}/certificateMaps/{resourceName}. + * URL of a certificate map that identifies a certificate map associated with + * the given target proxy. + * This field can only be set for global target proxies. + * If set, sslCertificates will be ignored. + * Accepted format is//certificatemanager.googleapis.com/projects/{project}/locations/{location}/certificateMaps/{resourceName}. * * Generated from protobuf field optional string certificate_map = 156463796; * @param string $var @@ -156,7 +210,8 @@ public function setCertificateMap($var) } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @return string @@ -177,7 +232,8 @@ public function clearCreationTimestamp() } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @param string $var @@ -192,7 +248,8 @@ public function setCreationTimestamp($var) } /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @return string @@ -213,7 +270,8 @@ public function clearDescription() } /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @param string $var @@ -228,7 +286,8 @@ public function setDescription($var) } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @return int|string @@ -249,7 +308,8 @@ public function clearId() } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @param int|string $var @@ -264,7 +324,7 @@ public function setId($var) } /** - * [Output Only] Type of the resource. Always compute#targetSslProxy for target SSL proxies. + * [Output Only] Type of the resource. Alwayscompute#targetSslProxy for target SSL proxies. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -285,7 +345,7 @@ public function clearKind() } /** - * [Output Only] Type of the resource. Always compute#targetSslProxy for target SSL proxies. + * [Output Only] Type of the resource. Alwayscompute#targetSslProxy for target SSL proxies. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -300,7 +360,13 @@ public function setKind($var) } /** - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * * Generated from protobuf field optional string name = 3373707; * @return string @@ -321,7 +387,13 @@ public function clearName() } /** - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * * Generated from protobuf field optional string name = 3373707; * @param string $var @@ -336,7 +408,9 @@ public function setName($var) } /** - * Specifies the type of proxy header to append before sending data to the backend, either NONE or PROXY_V1. The default is NONE. + * Specifies the type of proxy header to append before sending data to the + * backend, either NONE or PROXY_V1. The default + * is NONE. * Check the ProxyHeader enum for the list of possible values. * * Generated from protobuf field optional string proxy_header = 160374142; @@ -358,7 +432,9 @@ public function clearProxyHeader() } /** - * Specifies the type of proxy header to append before sending data to the backend, either NONE or PROXY_V1. The default is NONE. + * Specifies the type of proxy header to append before sending data to the + * backend, either NONE or PROXY_V1. The default + * is NONE. * Check the ProxyHeader enum for the list of possible values. * * Generated from protobuf field optional string proxy_header = 160374142; @@ -446,7 +522,11 @@ public function setService($var) } /** - * URLs to SslCertificate resources that are used to authenticate connections to Backends. At least one SSL certificate must be specified. Currently, you may specify up to 15 SSL certificates. sslCertificates do not apply when the load balancing scheme is set to INTERNAL_SELF_MANAGED. + * URLs to SslCertificate resources that are used to + * authenticate connections to Backends. At least one SSL certificate + * must be specified. Currently, you may specify up to 15 SSL certificates. + * sslCertificates do not apply when the load balancing scheme is set to + * INTERNAL_SELF_MANAGED. * * Generated from protobuf field repeated string ssl_certificates = 366006543; * @return \Google\Protobuf\Internal\RepeatedField @@ -457,7 +537,11 @@ public function getSslCertificates() } /** - * URLs to SslCertificate resources that are used to authenticate connections to Backends. At least one SSL certificate must be specified. Currently, you may specify up to 15 SSL certificates. sslCertificates do not apply when the load balancing scheme is set to INTERNAL_SELF_MANAGED. + * URLs to SslCertificate resources that are used to + * authenticate connections to Backends. At least one SSL certificate + * must be specified. Currently, you may specify up to 15 SSL certificates. + * sslCertificates do not apply when the load balancing scheme is set to + * INTERNAL_SELF_MANAGED. * * Generated from protobuf field repeated string ssl_certificates = 366006543; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -472,7 +556,9 @@ public function setSslCertificates($var) } /** - * URL of SslPolicy resource that will be associated with the TargetSslProxy resource. If not set, the TargetSslProxy resource will not have any SSL policy configured. + * URL of SslPolicy resource that will be associated with the TargetSslProxy + * resource. If not set, the TargetSslProxy resource will not have any + * SSL policy configured. * * Generated from protobuf field optional string ssl_policy = 295190213; * @return string @@ -493,7 +579,9 @@ public function clearSslPolicy() } /** - * URL of SslPolicy resource that will be associated with the TargetSslProxy resource. If not set, the TargetSslProxy resource will not have any SSL policy configured. + * URL of SslPolicy resource that will be associated with the TargetSslProxy + * resource. If not set, the TargetSslProxy resource will not have any + * SSL policy configured. * * Generated from protobuf field optional string ssl_policy = 295190213; * @param string $var diff --git a/Compute/src/V1/TargetSslProxy/ProxyHeader.php b/Compute/src/V1/TargetSslProxy/ProxyHeader.php index 827fe5e4dfad..0ad994178d2c 100644 --- a/Compute/src/V1/TargetSslProxy/ProxyHeader.php +++ b/Compute/src/V1/TargetSslProxy/ProxyHeader.php @@ -7,7 +7,9 @@ use UnexpectedValueException; /** - * Specifies the type of proxy header to append before sending data to the backend, either NONE or PROXY_V1. The default is NONE. + * Specifies the type of proxy header to append before sending data to the + * backend, either NONE or PROXY_V1. The default + * is NONE. * * Protobuf type google.cloud.compute.v1.TargetSslProxy.ProxyHeader */ diff --git a/Compute/src/V1/TargetSslProxyList.php b/Compute/src/V1/TargetSslProxyList.php index e4b0f43fc17d..25ac8ab117d2 100644 --- a/Compute/src/V1/TargetSslProxyList.php +++ b/Compute/src/V1/TargetSslProxyList.php @@ -34,7 +34,11 @@ class TargetSslProxyList extends \Google\Protobuf\Internal\Message */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -65,7 +69,11 @@ class TargetSslProxyList extends \Google\Protobuf\Internal\Message * @type string $kind * Type of resource. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type \Google\Cloud\Compute\V1\Warning $warning @@ -176,7 +184,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -197,7 +209,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/TargetTcpProxiesScopedList.php b/Compute/src/V1/TargetTcpProxiesScopedList.php index fbaf495d5f49..35bb0feca4b2 100644 --- a/Compute/src/V1/TargetTcpProxiesScopedList.php +++ b/Compute/src/V1/TargetTcpProxiesScopedList.php @@ -21,7 +21,8 @@ class TargetTcpProxiesScopedList extends \Google\Protobuf\Internal\Message */ private $target_tcp_proxies; /** - * Informational warning which replaces the list of backend services when the list is empty. + * Informational warning which replaces the list of + * backend services when the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; */ @@ -36,7 +37,8 @@ class TargetTcpProxiesScopedList extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\TargetTcpProxy>|\Google\Protobuf\Internal\RepeatedField $target_tcp_proxies * A list of TargetTcpProxies contained in this scope. * @type \Google\Cloud\Compute\V1\Warning $warning - * Informational warning which replaces the list of backend services when the list is empty. + * Informational warning which replaces the list of + * backend services when the list is empty. * } */ public function __construct($data = NULL) { @@ -71,7 +73,8 @@ public function setTargetTcpProxies($var) } /** - * Informational warning which replaces the list of backend services when the list is empty. + * Informational warning which replaces the list of + * backend services when the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; * @return \Google\Cloud\Compute\V1\Warning|null @@ -92,7 +95,8 @@ public function clearWarning() } /** - * Informational warning which replaces the list of backend services when the list is empty. + * Informational warning which replaces the list of + * backend services when the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; * @param \Google\Cloud\Compute\V1\Warning $var diff --git a/Compute/src/V1/TargetTcpProxiesSetProxyHeaderRequest.php b/Compute/src/V1/TargetTcpProxiesSetProxyHeaderRequest.php index 93e269d8bea2..201e69f4cf84 100644 --- a/Compute/src/V1/TargetTcpProxiesSetProxyHeaderRequest.php +++ b/Compute/src/V1/TargetTcpProxiesSetProxyHeaderRequest.php @@ -15,7 +15,8 @@ class TargetTcpProxiesSetProxyHeaderRequest extends \Google\Protobuf\Internal\Message { /** - * The new type of proxy header to append before sending data to the backend. NONE or PROXY_V1 are allowed. + * The new type of proxy header to append before sending data to the + * backend. NONE or PROXY_V1 are allowed. * Check the ProxyHeader enum for the list of possible values. * * Generated from protobuf field optional string proxy_header = 160374142; @@ -29,7 +30,8 @@ class TargetTcpProxiesSetProxyHeaderRequest extends \Google\Protobuf\Internal\Me * Optional. Data for populating the Message object. * * @type string $proxy_header - * The new type of proxy header to append before sending data to the backend. NONE or PROXY_V1 are allowed. + * The new type of proxy header to append before sending data to the + * backend. NONE or PROXY_V1 are allowed. * Check the ProxyHeader enum for the list of possible values. * } */ @@ -39,7 +41,8 @@ public function __construct($data = NULL) { } /** - * The new type of proxy header to append before sending data to the backend. NONE or PROXY_V1 are allowed. + * The new type of proxy header to append before sending data to the + * backend. NONE or PROXY_V1 are allowed. * Check the ProxyHeader enum for the list of possible values. * * Generated from protobuf field optional string proxy_header = 160374142; @@ -61,7 +64,8 @@ public function clearProxyHeader() } /** - * The new type of proxy header to append before sending data to the backend. NONE or PROXY_V1 are allowed. + * The new type of proxy header to append before sending data to the + * backend. NONE or PROXY_V1 are allowed. * Check the ProxyHeader enum for the list of possible values. * * Generated from protobuf field optional string proxy_header = 160374142; diff --git a/Compute/src/V1/TargetTcpProxiesSetProxyHeaderRequest/ProxyHeader.php b/Compute/src/V1/TargetTcpProxiesSetProxyHeaderRequest/ProxyHeader.php index c856438a1ac0..b9df54231d77 100644 --- a/Compute/src/V1/TargetTcpProxiesSetProxyHeaderRequest/ProxyHeader.php +++ b/Compute/src/V1/TargetTcpProxiesSetProxyHeaderRequest/ProxyHeader.php @@ -7,7 +7,8 @@ use UnexpectedValueException; /** - * The new type of proxy header to append before sending data to the backend. NONE or PROXY_V1 are allowed. + * The new type of proxy header to append before sending data to the + * backend. NONE or PROXY_V1 are allowed. * * Protobuf type google.cloud.compute.v1.TargetTcpProxiesSetProxyHeaderRequest.ProxyHeader */ diff --git a/Compute/src/V1/TargetTcpProxy.php b/Compute/src/V1/TargetTcpProxy.php index 67fdc2f449c5..80e8fe5ac3e8 100644 --- a/Compute/src/V1/TargetTcpProxy.php +++ b/Compute/src/V1/TargetTcpProxy.php @@ -9,57 +9,81 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Represents a Target TCP Proxy resource. A target TCP proxy is a component of a Proxy Network Load Balancer. The forwarding rule references the target TCP proxy, and the target proxy then references a backend service. For more information, read Proxy Network Load Balancer overview. + * Represents a Target TCP Proxy resource. + * A target TCP proxy is a component of a Proxy Network Load Balancer. + * The forwarding rule references the target TCP proxy, and the target proxy + * then references a backend service. For more information, readProxy Network + * Load Balancer overview. * * Generated from protobuf message google.cloud.compute.v1.TargetTcpProxy */ class TargetTcpProxy extends \Google\Protobuf\Internal\Message { /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; */ protected $creation_timestamp = null; /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; */ protected $description = null; /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; */ protected $id = null; /** - * [Output Only] Type of the resource. Always compute#targetTcpProxy for target TCP proxies. + * [Output Only] Type of the resource. Alwayscompute#targetTcpProxy for target TCP proxies. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * * Generated from protobuf field optional string name = 3373707; */ protected $name = null; /** - * This field only applies when the forwarding rule that references this target proxy has a loadBalancingScheme set to INTERNAL_SELF_MANAGED. When this field is set to true, Envoy proxies set up inbound traffic interception and bind to the IP address and port specified in the forwarding rule. This is generally useful when using Traffic Director to configure Envoy as a gateway or middle proxy (in other words, not a sidecar proxy). The Envoy proxy listens for inbound requests and handles requests when it receives them. The default is false. + * This field only applies when the forwarding rule that references this + * target proxy has a loadBalancingScheme set toINTERNAL_SELF_MANAGED. + * When this field is set to true, Envoy proxies set up inbound + * traffic interception and bind to the IP address and port specified in the + * forwarding rule. This is generally useful when using Traffic Director to + * configure Envoy as a gateway or middle proxy (in other words, not a + * sidecar proxy). The Envoy proxy listens for inbound requests and handles + * requests when it receives them. + * The default is false. * * Generated from protobuf field optional bool proxy_bind = 286025582; */ protected $proxy_bind = null; /** - * Specifies the type of proxy header to append before sending data to the backend, either NONE or PROXY_V1. The default is NONE. + * Specifies the type of proxy header to append before sending data to the + * backend, either NONE or PROXY_V1. The default + * is NONE. * Check the ProxyHeader enum for the list of possible values. * * Generated from protobuf field optional string proxy_header = 160374142; */ protected $proxy_header = null; /** - * [Output Only] URL of the region where the regional TCP proxy resides. This field is not applicable to global TCP proxy. + * [Output Only] URL of the region where the regional TCP proxy resides. + * This field is not applicable to global TCP proxy. * * Generated from protobuf field optional string region = 138946292; */ @@ -84,22 +108,42 @@ class TargetTcpProxy extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $creation_timestamp - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * @type string $description - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * @type int|string $id - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * @type string $kind - * [Output Only] Type of the resource. Always compute#targetTcpProxy for target TCP proxies. + * [Output Only] Type of the resource. Alwayscompute#targetTcpProxy for target TCP proxies. * @type string $name - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * @type bool $proxy_bind - * This field only applies when the forwarding rule that references this target proxy has a loadBalancingScheme set to INTERNAL_SELF_MANAGED. When this field is set to true, Envoy proxies set up inbound traffic interception and bind to the IP address and port specified in the forwarding rule. This is generally useful when using Traffic Director to configure Envoy as a gateway or middle proxy (in other words, not a sidecar proxy). The Envoy proxy listens for inbound requests and handles requests when it receives them. The default is false. + * This field only applies when the forwarding rule that references this + * target proxy has a loadBalancingScheme set toINTERNAL_SELF_MANAGED. + * When this field is set to true, Envoy proxies set up inbound + * traffic interception and bind to the IP address and port specified in the + * forwarding rule. This is generally useful when using Traffic Director to + * configure Envoy as a gateway or middle proxy (in other words, not a + * sidecar proxy). The Envoy proxy listens for inbound requests and handles + * requests when it receives them. + * The default is false. * @type string $proxy_header - * Specifies the type of proxy header to append before sending data to the backend, either NONE or PROXY_V1. The default is NONE. + * Specifies the type of proxy header to append before sending data to the + * backend, either NONE or PROXY_V1. The default + * is NONE. * Check the ProxyHeader enum for the list of possible values. * @type string $region - * [Output Only] URL of the region where the regional TCP proxy resides. This field is not applicable to global TCP proxy. + * [Output Only] URL of the region where the regional TCP proxy resides. + * This field is not applicable to global TCP proxy. * @type string $self_link * [Output Only] Server-defined URL for the resource. * @type string $service @@ -112,7 +156,8 @@ public function __construct($data = NULL) { } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @return string @@ -133,7 +178,8 @@ public function clearCreationTimestamp() } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @param string $var @@ -148,7 +194,8 @@ public function setCreationTimestamp($var) } /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @return string @@ -169,7 +216,8 @@ public function clearDescription() } /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @param string $var @@ -184,7 +232,8 @@ public function setDescription($var) } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @return int|string @@ -205,7 +254,8 @@ public function clearId() } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @param int|string $var @@ -220,7 +270,7 @@ public function setId($var) } /** - * [Output Only] Type of the resource. Always compute#targetTcpProxy for target TCP proxies. + * [Output Only] Type of the resource. Alwayscompute#targetTcpProxy for target TCP proxies. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -241,7 +291,7 @@ public function clearKind() } /** - * [Output Only] Type of the resource. Always compute#targetTcpProxy for target TCP proxies. + * [Output Only] Type of the resource. Alwayscompute#targetTcpProxy for target TCP proxies. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -256,7 +306,13 @@ public function setKind($var) } /** - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * * Generated from protobuf field optional string name = 3373707; * @return string @@ -277,7 +333,13 @@ public function clearName() } /** - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * * Generated from protobuf field optional string name = 3373707; * @param string $var @@ -292,7 +354,15 @@ public function setName($var) } /** - * This field only applies when the forwarding rule that references this target proxy has a loadBalancingScheme set to INTERNAL_SELF_MANAGED. When this field is set to true, Envoy proxies set up inbound traffic interception and bind to the IP address and port specified in the forwarding rule. This is generally useful when using Traffic Director to configure Envoy as a gateway or middle proxy (in other words, not a sidecar proxy). The Envoy proxy listens for inbound requests and handles requests when it receives them. The default is false. + * This field only applies when the forwarding rule that references this + * target proxy has a loadBalancingScheme set toINTERNAL_SELF_MANAGED. + * When this field is set to true, Envoy proxies set up inbound + * traffic interception and bind to the IP address and port specified in the + * forwarding rule. This is generally useful when using Traffic Director to + * configure Envoy as a gateway or middle proxy (in other words, not a + * sidecar proxy). The Envoy proxy listens for inbound requests and handles + * requests when it receives them. + * The default is false. * * Generated from protobuf field optional bool proxy_bind = 286025582; * @return bool @@ -313,7 +383,15 @@ public function clearProxyBind() } /** - * This field only applies when the forwarding rule that references this target proxy has a loadBalancingScheme set to INTERNAL_SELF_MANAGED. When this field is set to true, Envoy proxies set up inbound traffic interception and bind to the IP address and port specified in the forwarding rule. This is generally useful when using Traffic Director to configure Envoy as a gateway or middle proxy (in other words, not a sidecar proxy). The Envoy proxy listens for inbound requests and handles requests when it receives them. The default is false. + * This field only applies when the forwarding rule that references this + * target proxy has a loadBalancingScheme set toINTERNAL_SELF_MANAGED. + * When this field is set to true, Envoy proxies set up inbound + * traffic interception and bind to the IP address and port specified in the + * forwarding rule. This is generally useful when using Traffic Director to + * configure Envoy as a gateway or middle proxy (in other words, not a + * sidecar proxy). The Envoy proxy listens for inbound requests and handles + * requests when it receives them. + * The default is false. * * Generated from protobuf field optional bool proxy_bind = 286025582; * @param bool $var @@ -328,7 +406,9 @@ public function setProxyBind($var) } /** - * Specifies the type of proxy header to append before sending data to the backend, either NONE or PROXY_V1. The default is NONE. + * Specifies the type of proxy header to append before sending data to the + * backend, either NONE or PROXY_V1. The default + * is NONE. * Check the ProxyHeader enum for the list of possible values. * * Generated from protobuf field optional string proxy_header = 160374142; @@ -350,7 +430,9 @@ public function clearProxyHeader() } /** - * Specifies the type of proxy header to append before sending data to the backend, either NONE or PROXY_V1. The default is NONE. + * Specifies the type of proxy header to append before sending data to the + * backend, either NONE or PROXY_V1. The default + * is NONE. * Check the ProxyHeader enum for the list of possible values. * * Generated from protobuf field optional string proxy_header = 160374142; @@ -366,7 +448,8 @@ public function setProxyHeader($var) } /** - * [Output Only] URL of the region where the regional TCP proxy resides. This field is not applicable to global TCP proxy. + * [Output Only] URL of the region where the regional TCP proxy resides. + * This field is not applicable to global TCP proxy. * * Generated from protobuf field optional string region = 138946292; * @return string @@ -387,7 +470,8 @@ public function clearRegion() } /** - * [Output Only] URL of the region where the regional TCP proxy resides. This field is not applicable to global TCP proxy. + * [Output Only] URL of the region where the regional TCP proxy resides. + * This field is not applicable to global TCP proxy. * * Generated from protobuf field optional string region = 138946292; * @param string $var diff --git a/Compute/src/V1/TargetTcpProxy/ProxyHeader.php b/Compute/src/V1/TargetTcpProxy/ProxyHeader.php index 150b9643404d..dc532af01bd2 100644 --- a/Compute/src/V1/TargetTcpProxy/ProxyHeader.php +++ b/Compute/src/V1/TargetTcpProxy/ProxyHeader.php @@ -7,7 +7,9 @@ use UnexpectedValueException; /** - * Specifies the type of proxy header to append before sending data to the backend, either NONE or PROXY_V1. The default is NONE. + * Specifies the type of proxy header to append before sending data to the + * backend, either NONE or PROXY_V1. The default + * is NONE. * * Protobuf type google.cloud.compute.v1.TargetTcpProxy.ProxyHeader */ diff --git a/Compute/src/V1/TargetTcpProxyAggregatedList.php b/Compute/src/V1/TargetTcpProxyAggregatedList.php index 15caba7e64eb..b971efd1cd6a 100644 --- a/Compute/src/V1/TargetTcpProxyAggregatedList.php +++ b/Compute/src/V1/TargetTcpProxyAggregatedList.php @@ -27,13 +27,18 @@ class TargetTcpProxyAggregatedList extends \Google\Protobuf\Internal\Message */ private $items; /** - * [Output Only] Type of resource. Always compute#targetTcpProxyAggregatedList for lists of Target TCP Proxies. + * [Output Only] Type of resource. Alwayscompute#targetTcpProxyAggregatedList for lists of Target + * TCP Proxies. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -68,9 +73,14 @@ class TargetTcpProxyAggregatedList extends \Google\Protobuf\Internal\Message * @type array|\Google\Protobuf\Internal\MapField $items * A list of TargetTcpProxiesScopedList resources. * @type string $kind - * [Output Only] Type of resource. Always compute#targetTcpProxyAggregatedList for lists of Target TCP Proxies. + * [Output Only] Type of resource. Alwayscompute#targetTcpProxyAggregatedList for lists of Target + * TCP Proxies. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type array|\Google\Protobuf\Internal\RepeatedField $unreachables @@ -147,7 +157,8 @@ public function setItems($var) } /** - * [Output Only] Type of resource. Always compute#targetTcpProxyAggregatedList for lists of Target TCP Proxies. + * [Output Only] Type of resource. Alwayscompute#targetTcpProxyAggregatedList for lists of Target + * TCP Proxies. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -168,7 +179,8 @@ public function clearKind() } /** - * [Output Only] Type of resource. Always compute#targetTcpProxyAggregatedList for lists of Target TCP Proxies. + * [Output Only] Type of resource. Alwayscompute#targetTcpProxyAggregatedList for lists of Target + * TCP Proxies. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -183,7 +195,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -204,7 +220,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/TargetTcpProxyList.php b/Compute/src/V1/TargetTcpProxyList.php index 111265221f1f..083bf748ba04 100644 --- a/Compute/src/V1/TargetTcpProxyList.php +++ b/Compute/src/V1/TargetTcpProxyList.php @@ -34,7 +34,11 @@ class TargetTcpProxyList extends \Google\Protobuf\Internal\Message */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -65,7 +69,11 @@ class TargetTcpProxyList extends \Google\Protobuf\Internal\Message * @type string $kind * Type of resource. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type \Google\Cloud\Compute\V1\Warning $warning @@ -176,7 +184,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -197,7 +209,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/TargetVpnGateway.php b/Compute/src/V1/TargetVpnGateway.php index 2bfbd2cf71a0..6e208e8a556e 100644 --- a/Compute/src/V1/TargetVpnGateway.php +++ b/Compute/src/V1/TargetVpnGateway.php @@ -9,68 +9,93 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Represents a Target VPN Gateway resource. The target VPN gateway resource represents a Classic Cloud VPN gateway. For more information, read the the Cloud VPN Overview. + * Represents a Target VPN Gateway resource. + * The target VPN gateway resource represents a Classic Cloud VPN gateway. + * For more information, read thethe + * Cloud VPN Overview. * * Generated from protobuf message google.cloud.compute.v1.TargetVpnGateway */ class TargetVpnGateway extends \Google\Protobuf\Internal\Message { /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; */ protected $creation_timestamp = null; /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; */ protected $description = null; /** - * [Output Only] A list of URLs to the ForwardingRule resources. ForwardingRules are created using compute.forwardingRules.insert and associated with a VPN gateway. + * [Output Only] A list of URLs to the ForwardingRule resources. + * ForwardingRules are created usingcompute.forwardingRules.insert and associated with a VPN + * gateway. * * Generated from protobuf field repeated string forwarding_rules = 315821365; */ private $forwarding_rules; /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; */ protected $id = null; /** - * [Output Only] Type of resource. Always compute#targetVpnGateway for target VPN gateways. + * [Output Only] Type of resource. Alwayscompute#targetVpnGateway for target VPN gateways. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * A fingerprint for the labels being applied to this TargetVpnGateway, which is essentially a hash of the labels set used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a TargetVpnGateway. + * A fingerprint for the labels being applied to this TargetVpnGateway, which + * is essentially a hash of the labels set used for optimistic locking. The + * fingerprint is initially generated by Compute Engine and changes after + * every request to modify or update labels. You must always provide an + * up-to-date fingerprint hash in order to update or change labels, + * otherwise the request will fail with error412 conditionNotMet. + * To see the latest fingerprint, make a get() request to + * retrieve a TargetVpnGateway. * * Generated from protobuf field optional string label_fingerprint = 178124825; */ protected $label_fingerprint = null; /** - * Labels for this resource. These can only be added or modified by the setLabels method. Each label key/value pair must comply with RFC1035. Label values may be empty. + * Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035. + * Label values may be empty. * * Generated from protobuf field map labels = 500195327; */ private $labels; /** - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * * Generated from protobuf field optional string name = 3373707; */ protected $name = null; /** - * URL of the network to which this VPN gateway is attached. Provided by the client when the VPN gateway is created. + * URL of the network to which this VPN gateway is attached. Provided by the + * client when the VPN gateway is created. * * Generated from protobuf field optional string network = 232872494; */ protected $network = null; /** - * [Output Only] URL of the region where the target VPN gateway resides. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * [Output Only] URL of the region where the target VPN gateway resides. + * You must specify this field as part of the HTTP request URL. It is + * not settable as a field in the request body. * * Generated from protobuf field optional string region = 138946292; */ @@ -82,14 +107,17 @@ class TargetVpnGateway extends \Google\Protobuf\Internal\Message */ protected $self_link = null; /** - * [Output Only] The status of the VPN gateway, which can be one of the following: CREATING, READY, FAILED, or DELETING. + * [Output Only] The status of the VPN gateway, + * which can be one of the following: CREATING, READY, FAILED, or DELETING. * Check the Status enum for the list of possible values. * * Generated from protobuf field optional string status = 181260274; */ protected $status = null; /** - * [Output Only] A list of URLs to VpnTunnel resources. VpnTunnels are created using the compute.vpntunnels.insert method and associated with a VPN gateway. + * [Output Only] A list of URLs to VpnTunnel resources. VpnTunnels are + * created using the compute.vpntunnels.insert method and + * associated with a VPN gateway. * * Generated from protobuf field repeated string tunnels = 104561931; */ @@ -102,32 +130,57 @@ class TargetVpnGateway extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $creation_timestamp - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * @type string $description - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * @type array|\Google\Protobuf\Internal\RepeatedField $forwarding_rules - * [Output Only] A list of URLs to the ForwardingRule resources. ForwardingRules are created using compute.forwardingRules.insert and associated with a VPN gateway. + * [Output Only] A list of URLs to the ForwardingRule resources. + * ForwardingRules are created usingcompute.forwardingRules.insert and associated with a VPN + * gateway. * @type int|string $id - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * @type string $kind - * [Output Only] Type of resource. Always compute#targetVpnGateway for target VPN gateways. + * [Output Only] Type of resource. Alwayscompute#targetVpnGateway for target VPN gateways. * @type string $label_fingerprint - * A fingerprint for the labels being applied to this TargetVpnGateway, which is essentially a hash of the labels set used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a TargetVpnGateway. + * A fingerprint for the labels being applied to this TargetVpnGateway, which + * is essentially a hash of the labels set used for optimistic locking. The + * fingerprint is initially generated by Compute Engine and changes after + * every request to modify or update labels. You must always provide an + * up-to-date fingerprint hash in order to update or change labels, + * otherwise the request will fail with error412 conditionNotMet. + * To see the latest fingerprint, make a get() request to + * retrieve a TargetVpnGateway. * @type array|\Google\Protobuf\Internal\MapField $labels - * Labels for this resource. These can only be added or modified by the setLabels method. Each label key/value pair must comply with RFC1035. Label values may be empty. + * Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035. + * Label values may be empty. * @type string $name - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * @type string $network - * URL of the network to which this VPN gateway is attached. Provided by the client when the VPN gateway is created. + * URL of the network to which this VPN gateway is attached. Provided by the + * client when the VPN gateway is created. * @type string $region - * [Output Only] URL of the region where the target VPN gateway resides. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * [Output Only] URL of the region where the target VPN gateway resides. + * You must specify this field as part of the HTTP request URL. It is + * not settable as a field in the request body. * @type string $self_link * [Output Only] Server-defined URL for the resource. * @type string $status - * [Output Only] The status of the VPN gateway, which can be one of the following: CREATING, READY, FAILED, or DELETING. + * [Output Only] The status of the VPN gateway, + * which can be one of the following: CREATING, READY, FAILED, or DELETING. * Check the Status enum for the list of possible values. * @type array|\Google\Protobuf\Internal\RepeatedField $tunnels - * [Output Only] A list of URLs to VpnTunnel resources. VpnTunnels are created using the compute.vpntunnels.insert method and associated with a VPN gateway. + * [Output Only] A list of URLs to VpnTunnel resources. VpnTunnels are + * created using the compute.vpntunnels.insert method and + * associated with a VPN gateway. * } */ public function __construct($data = NULL) { @@ -136,7 +189,8 @@ public function __construct($data = NULL) { } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @return string @@ -157,7 +211,8 @@ public function clearCreationTimestamp() } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @param string $var @@ -172,7 +227,8 @@ public function setCreationTimestamp($var) } /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @return string @@ -193,7 +249,8 @@ public function clearDescription() } /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @param string $var @@ -208,7 +265,9 @@ public function setDescription($var) } /** - * [Output Only] A list of URLs to the ForwardingRule resources. ForwardingRules are created using compute.forwardingRules.insert and associated with a VPN gateway. + * [Output Only] A list of URLs to the ForwardingRule resources. + * ForwardingRules are created usingcompute.forwardingRules.insert and associated with a VPN + * gateway. * * Generated from protobuf field repeated string forwarding_rules = 315821365; * @return \Google\Protobuf\Internal\RepeatedField @@ -219,7 +278,9 @@ public function getForwardingRules() } /** - * [Output Only] A list of URLs to the ForwardingRule resources. ForwardingRules are created using compute.forwardingRules.insert and associated with a VPN gateway. + * [Output Only] A list of URLs to the ForwardingRule resources. + * ForwardingRules are created usingcompute.forwardingRules.insert and associated with a VPN + * gateway. * * Generated from protobuf field repeated string forwarding_rules = 315821365; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -234,7 +295,8 @@ public function setForwardingRules($var) } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @return int|string @@ -255,7 +317,8 @@ public function clearId() } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @param int|string $var @@ -270,7 +333,7 @@ public function setId($var) } /** - * [Output Only] Type of resource. Always compute#targetVpnGateway for target VPN gateways. + * [Output Only] Type of resource. Alwayscompute#targetVpnGateway for target VPN gateways. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -291,7 +354,7 @@ public function clearKind() } /** - * [Output Only] Type of resource. Always compute#targetVpnGateway for target VPN gateways. + * [Output Only] Type of resource. Alwayscompute#targetVpnGateway for target VPN gateways. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -306,7 +369,14 @@ public function setKind($var) } /** - * A fingerprint for the labels being applied to this TargetVpnGateway, which is essentially a hash of the labels set used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a TargetVpnGateway. + * A fingerprint for the labels being applied to this TargetVpnGateway, which + * is essentially a hash of the labels set used for optimistic locking. The + * fingerprint is initially generated by Compute Engine and changes after + * every request to modify or update labels. You must always provide an + * up-to-date fingerprint hash in order to update or change labels, + * otherwise the request will fail with error412 conditionNotMet. + * To see the latest fingerprint, make a get() request to + * retrieve a TargetVpnGateway. * * Generated from protobuf field optional string label_fingerprint = 178124825; * @return string @@ -327,7 +397,14 @@ public function clearLabelFingerprint() } /** - * A fingerprint for the labels being applied to this TargetVpnGateway, which is essentially a hash of the labels set used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a TargetVpnGateway. + * A fingerprint for the labels being applied to this TargetVpnGateway, which + * is essentially a hash of the labels set used for optimistic locking. The + * fingerprint is initially generated by Compute Engine and changes after + * every request to modify or update labels. You must always provide an + * up-to-date fingerprint hash in order to update or change labels, + * otherwise the request will fail with error412 conditionNotMet. + * To see the latest fingerprint, make a get() request to + * retrieve a TargetVpnGateway. * * Generated from protobuf field optional string label_fingerprint = 178124825; * @param string $var @@ -342,7 +419,8 @@ public function setLabelFingerprint($var) } /** - * Labels for this resource. These can only be added or modified by the setLabels method. Each label key/value pair must comply with RFC1035. Label values may be empty. + * Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035. + * Label values may be empty. * * Generated from protobuf field map labels = 500195327; * @return \Google\Protobuf\Internal\MapField @@ -353,7 +431,8 @@ public function getLabels() } /** - * Labels for this resource. These can only be added or modified by the setLabels method. Each label key/value pair must comply with RFC1035. Label values may be empty. + * Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035. + * Label values may be empty. * * Generated from protobuf field map labels = 500195327; * @param array|\Google\Protobuf\Internal\MapField $var @@ -368,7 +447,13 @@ public function setLabels($var) } /** - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * * Generated from protobuf field optional string name = 3373707; * @return string @@ -389,7 +474,13 @@ public function clearName() } /** - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * * Generated from protobuf field optional string name = 3373707; * @param string $var @@ -404,7 +495,8 @@ public function setName($var) } /** - * URL of the network to which this VPN gateway is attached. Provided by the client when the VPN gateway is created. + * URL of the network to which this VPN gateway is attached. Provided by the + * client when the VPN gateway is created. * * Generated from protobuf field optional string network = 232872494; * @return string @@ -425,7 +517,8 @@ public function clearNetwork() } /** - * URL of the network to which this VPN gateway is attached. Provided by the client when the VPN gateway is created. + * URL of the network to which this VPN gateway is attached. Provided by the + * client when the VPN gateway is created. * * Generated from protobuf field optional string network = 232872494; * @param string $var @@ -440,7 +533,9 @@ public function setNetwork($var) } /** - * [Output Only] URL of the region where the target VPN gateway resides. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * [Output Only] URL of the region where the target VPN gateway resides. + * You must specify this field as part of the HTTP request URL. It is + * not settable as a field in the request body. * * Generated from protobuf field optional string region = 138946292; * @return string @@ -461,7 +556,9 @@ public function clearRegion() } /** - * [Output Only] URL of the region where the target VPN gateway resides. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * [Output Only] URL of the region where the target VPN gateway resides. + * You must specify this field as part of the HTTP request URL. It is + * not settable as a field in the request body. * * Generated from protobuf field optional string region = 138946292; * @param string $var @@ -512,7 +609,8 @@ public function setSelfLink($var) } /** - * [Output Only] The status of the VPN gateway, which can be one of the following: CREATING, READY, FAILED, or DELETING. + * [Output Only] The status of the VPN gateway, + * which can be one of the following: CREATING, READY, FAILED, or DELETING. * Check the Status enum for the list of possible values. * * Generated from protobuf field optional string status = 181260274; @@ -534,7 +632,8 @@ public function clearStatus() } /** - * [Output Only] The status of the VPN gateway, which can be one of the following: CREATING, READY, FAILED, or DELETING. + * [Output Only] The status of the VPN gateway, + * which can be one of the following: CREATING, READY, FAILED, or DELETING. * Check the Status enum for the list of possible values. * * Generated from protobuf field optional string status = 181260274; @@ -550,7 +649,9 @@ public function setStatus($var) } /** - * [Output Only] A list of URLs to VpnTunnel resources. VpnTunnels are created using the compute.vpntunnels.insert method and associated with a VPN gateway. + * [Output Only] A list of URLs to VpnTunnel resources. VpnTunnels are + * created using the compute.vpntunnels.insert method and + * associated with a VPN gateway. * * Generated from protobuf field repeated string tunnels = 104561931; * @return \Google\Protobuf\Internal\RepeatedField @@ -561,7 +662,9 @@ public function getTunnels() } /** - * [Output Only] A list of URLs to VpnTunnel resources. VpnTunnels are created using the compute.vpntunnels.insert method and associated with a VPN gateway. + * [Output Only] A list of URLs to VpnTunnel resources. VpnTunnels are + * created using the compute.vpntunnels.insert method and + * associated with a VPN gateway. * * Generated from protobuf field repeated string tunnels = 104561931; * @param array|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/TargetVpnGateway/Status.php b/Compute/src/V1/TargetVpnGateway/Status.php index c5b8a100dfa9..4848e5080bea 100644 --- a/Compute/src/V1/TargetVpnGateway/Status.php +++ b/Compute/src/V1/TargetVpnGateway/Status.php @@ -7,7 +7,8 @@ use UnexpectedValueException; /** - * [Output Only] The status of the VPN gateway, which can be one of the following: CREATING, READY, FAILED, or DELETING. + * [Output Only] The status of the VPN gateway, + * which can be one of the following: CREATING, READY, FAILED, or DELETING. * * Protobuf type google.cloud.compute.v1.TargetVpnGateway.Status */ diff --git a/Compute/src/V1/TargetVpnGatewayAggregatedList.php b/Compute/src/V1/TargetVpnGatewayAggregatedList.php index 6a734fe10070..78cfe9052b93 100644 --- a/Compute/src/V1/TargetVpnGatewayAggregatedList.php +++ b/Compute/src/V1/TargetVpnGatewayAggregatedList.php @@ -27,13 +27,17 @@ class TargetVpnGatewayAggregatedList extends \Google\Protobuf\Internal\Message */ private $items; /** - * [Output Only] Type of resource. Always compute#targetVpnGateway for target VPN gateways. + * [Output Only] Type of resource. Alwayscompute#targetVpnGateway for target VPN gateways. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -68,9 +72,13 @@ class TargetVpnGatewayAggregatedList extends \Google\Protobuf\Internal\Message * @type array|\Google\Protobuf\Internal\MapField $items * A list of TargetVpnGateway resources. * @type string $kind - * [Output Only] Type of resource. Always compute#targetVpnGateway for target VPN gateways. + * [Output Only] Type of resource. Alwayscompute#targetVpnGateway for target VPN gateways. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type array|\Google\Protobuf\Internal\RepeatedField $unreachables @@ -147,7 +155,7 @@ public function setItems($var) } /** - * [Output Only] Type of resource. Always compute#targetVpnGateway for target VPN gateways. + * [Output Only] Type of resource. Alwayscompute#targetVpnGateway for target VPN gateways. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -168,7 +176,7 @@ public function clearKind() } /** - * [Output Only] Type of resource. Always compute#targetVpnGateway for target VPN gateways. + * [Output Only] Type of resource. Alwayscompute#targetVpnGateway for target VPN gateways. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -183,7 +191,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -204,7 +216,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/TargetVpnGatewayList.php b/Compute/src/V1/TargetVpnGatewayList.php index dc4920849ca9..5fe797cb6eb0 100644 --- a/Compute/src/V1/TargetVpnGatewayList.php +++ b/Compute/src/V1/TargetVpnGatewayList.php @@ -28,13 +28,17 @@ class TargetVpnGatewayList extends \Google\Protobuf\Internal\Message */ private $items; /** - * [Output Only] Type of resource. Always compute#targetVpnGateway for target VPN gateways. + * [Output Only] Type of resource. Alwayscompute#targetVpnGateway for target VPN gateways. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -63,9 +67,13 @@ class TargetVpnGatewayList extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\TargetVpnGateway>|\Google\Protobuf\Internal\RepeatedField $items * A list of TargetVpnGateway resources. * @type string $kind - * [Output Only] Type of resource. Always compute#targetVpnGateway for target VPN gateways. + * [Output Only] Type of resource. Alwayscompute#targetVpnGateway for target VPN gateways. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type \Google\Cloud\Compute\V1\Warning $warning @@ -140,7 +148,7 @@ public function setItems($var) } /** - * [Output Only] Type of resource. Always compute#targetVpnGateway for target VPN gateways. + * [Output Only] Type of resource. Alwayscompute#targetVpnGateway for target VPN gateways. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -161,7 +169,7 @@ public function clearKind() } /** - * [Output Only] Type of resource. Always compute#targetVpnGateway for target VPN gateways. + * [Output Only] Type of resource. Alwayscompute#targetVpnGateway for target VPN gateways. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -176,7 +184,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -197,7 +209,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/TargetVpnGatewaysScopedList.php b/Compute/src/V1/TargetVpnGatewaysScopedList.php index 71fc403d96a1..4d893fc5984f 100644 --- a/Compute/src/V1/TargetVpnGatewaysScopedList.php +++ b/Compute/src/V1/TargetVpnGatewaysScopedList.php @@ -21,7 +21,8 @@ class TargetVpnGatewaysScopedList extends \Google\Protobuf\Internal\Message */ private $target_vpn_gateways; /** - * [Output Only] Informational warning which replaces the list of addresses when the list is empty. + * [Output Only] Informational warning which replaces the list of addresses + * when the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; */ @@ -36,7 +37,8 @@ class TargetVpnGatewaysScopedList extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\TargetVpnGateway>|\Google\Protobuf\Internal\RepeatedField $target_vpn_gateways * [Output Only] A list of target VPN gateways contained in this scope. * @type \Google\Cloud\Compute\V1\Warning $warning - * [Output Only] Informational warning which replaces the list of addresses when the list is empty. + * [Output Only] Informational warning which replaces the list of addresses + * when the list is empty. * } */ public function __construct($data = NULL) { @@ -71,7 +73,8 @@ public function setTargetVpnGateways($var) } /** - * [Output Only] Informational warning which replaces the list of addresses when the list is empty. + * [Output Only] Informational warning which replaces the list of addresses + * when the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; * @return \Google\Cloud\Compute\V1\Warning|null @@ -92,7 +95,8 @@ public function clearWarning() } /** - * [Output Only] Informational warning which replaces the list of addresses when the list is empty. + * [Output Only] Informational warning which replaces the list of addresses + * when the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; * @param \Google\Cloud\Compute\V1\Warning $var diff --git a/Compute/src/V1/TestFailure.php b/Compute/src/V1/TestFailure.php index dd4da3f41f93..4bcd2afd55f7 100644 --- a/Compute/src/V1/TestFailure.php +++ b/Compute/src/V1/TestFailure.php @@ -15,37 +15,43 @@ class TestFailure extends \Google\Protobuf\Internal\Message { /** - * The actual output URL evaluated by a load balancer containing the scheme, host, path and query parameters. + * The actual output URL evaluated by a load balancer containing the scheme, + * host, path and query parameters. * * Generated from protobuf field optional string actual_output_url = 287075458; */ protected $actual_output_url = null; /** - * Actual HTTP status code for rule with `urlRedirect` calculated by load balancer + * Actual HTTP status code for rule with `urlRedirect` + * calculated by load balancer * * Generated from protobuf field optional int32 actual_redirect_response_code = 42926553; */ protected $actual_redirect_response_code = null; /** - * BackendService or BackendBucket returned by load balancer. + * BackendService or BackendBucket returned by load + * balancer. * * Generated from protobuf field optional string actual_service = 440379652; */ protected $actual_service = null; /** - * The expected output URL evaluated by a load balancer containing the scheme, host, path and query parameters. + * The expected output URL evaluated by a load balancer containing the scheme, + * host, path and query parameters. * * Generated from protobuf field optional string expected_output_url = 433967384; */ protected $expected_output_url = null; /** - * Expected HTTP status code for rule with `urlRedirect` calculated by load balancer + * Expected HTTP status code for rule with `urlRedirect` + * calculated by load balancer * * Generated from protobuf field optional int32 expected_redirect_response_code = 18888047; */ protected $expected_redirect_response_code = null; /** - * Expected BackendService or BackendBucket resource the given URL should be mapped to. + * Expected BackendService or BackendBucket resource + * the given URL should be mapped to. * * Generated from protobuf field optional string expected_service = 133987374; */ @@ -76,17 +82,23 @@ class TestFailure extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $actual_output_url - * The actual output URL evaluated by a load balancer containing the scheme, host, path and query parameters. + * The actual output URL evaluated by a load balancer containing the scheme, + * host, path and query parameters. * @type int $actual_redirect_response_code - * Actual HTTP status code for rule with `urlRedirect` calculated by load balancer + * Actual HTTP status code for rule with `urlRedirect` + * calculated by load balancer * @type string $actual_service - * BackendService or BackendBucket returned by load balancer. + * BackendService or BackendBucket returned by load + * balancer. * @type string $expected_output_url - * The expected output URL evaluated by a load balancer containing the scheme, host, path and query parameters. + * The expected output URL evaluated by a load balancer containing the scheme, + * host, path and query parameters. * @type int $expected_redirect_response_code - * Expected HTTP status code for rule with `urlRedirect` calculated by load balancer + * Expected HTTP status code for rule with `urlRedirect` + * calculated by load balancer * @type string $expected_service - * Expected BackendService or BackendBucket resource the given URL should be mapped to. + * Expected BackendService or BackendBucket resource + * the given URL should be mapped to. * @type array<\Google\Cloud\Compute\V1\UrlMapTestHeader>|\Google\Protobuf\Internal\RepeatedField $headers * HTTP headers of the request. * @type string $host @@ -101,7 +113,8 @@ public function __construct($data = NULL) { } /** - * The actual output URL evaluated by a load balancer containing the scheme, host, path and query parameters. + * The actual output URL evaluated by a load balancer containing the scheme, + * host, path and query parameters. * * Generated from protobuf field optional string actual_output_url = 287075458; * @return string @@ -122,7 +135,8 @@ public function clearActualOutputUrl() } /** - * The actual output URL evaluated by a load balancer containing the scheme, host, path and query parameters. + * The actual output URL evaluated by a load balancer containing the scheme, + * host, path and query parameters. * * Generated from protobuf field optional string actual_output_url = 287075458; * @param string $var @@ -137,7 +151,8 @@ public function setActualOutputUrl($var) } /** - * Actual HTTP status code for rule with `urlRedirect` calculated by load balancer + * Actual HTTP status code for rule with `urlRedirect` + * calculated by load balancer * * Generated from protobuf field optional int32 actual_redirect_response_code = 42926553; * @return int @@ -158,7 +173,8 @@ public function clearActualRedirectResponseCode() } /** - * Actual HTTP status code for rule with `urlRedirect` calculated by load balancer + * Actual HTTP status code for rule with `urlRedirect` + * calculated by load balancer * * Generated from protobuf field optional int32 actual_redirect_response_code = 42926553; * @param int $var @@ -173,7 +189,8 @@ public function setActualRedirectResponseCode($var) } /** - * BackendService or BackendBucket returned by load balancer. + * BackendService or BackendBucket returned by load + * balancer. * * Generated from protobuf field optional string actual_service = 440379652; * @return string @@ -194,7 +211,8 @@ public function clearActualService() } /** - * BackendService or BackendBucket returned by load balancer. + * BackendService or BackendBucket returned by load + * balancer. * * Generated from protobuf field optional string actual_service = 440379652; * @param string $var @@ -209,7 +227,8 @@ public function setActualService($var) } /** - * The expected output URL evaluated by a load balancer containing the scheme, host, path and query parameters. + * The expected output URL evaluated by a load balancer containing the scheme, + * host, path and query parameters. * * Generated from protobuf field optional string expected_output_url = 433967384; * @return string @@ -230,7 +249,8 @@ public function clearExpectedOutputUrl() } /** - * The expected output URL evaluated by a load balancer containing the scheme, host, path and query parameters. + * The expected output URL evaluated by a load balancer containing the scheme, + * host, path and query parameters. * * Generated from protobuf field optional string expected_output_url = 433967384; * @param string $var @@ -245,7 +265,8 @@ public function setExpectedOutputUrl($var) } /** - * Expected HTTP status code for rule with `urlRedirect` calculated by load balancer + * Expected HTTP status code for rule with `urlRedirect` + * calculated by load balancer * * Generated from protobuf field optional int32 expected_redirect_response_code = 18888047; * @return int @@ -266,7 +287,8 @@ public function clearExpectedRedirectResponseCode() } /** - * Expected HTTP status code for rule with `urlRedirect` calculated by load balancer + * Expected HTTP status code for rule with `urlRedirect` + * calculated by load balancer * * Generated from protobuf field optional int32 expected_redirect_response_code = 18888047; * @param int $var @@ -281,7 +303,8 @@ public function setExpectedRedirectResponseCode($var) } /** - * Expected BackendService or BackendBucket resource the given URL should be mapped to. + * Expected BackendService or BackendBucket resource + * the given URL should be mapped to. * * Generated from protobuf field optional string expected_service = 133987374; * @return string @@ -302,7 +325,8 @@ public function clearExpectedService() } /** - * Expected BackendService or BackendBucket resource the given URL should be mapped to. + * Expected BackendService or BackendBucket resource + * the given URL should be mapped to. * * Generated from protobuf field optional string expected_service = 133987374; * @param string $var diff --git a/Compute/src/V1/TestIamPermissionsFirewallRequest.php b/Compute/src/V1/TestIamPermissionsFirewallRequest.php new file mode 100644 index 000000000000..845e41c68af8 --- /dev/null +++ b/Compute/src/V1/TestIamPermissionsFirewallRequest.php @@ -0,0 +1,162 @@ +google.cloud.compute.v1.TestIamPermissionsFirewallRequest + */ +class TestIamPermissionsFirewallRequest extends \Google\Protobuf\Internal\Message +{ + /** + * Project ID for this request. + * + * Generated from protobuf field string project = 227560217 [(.google.api.field_behavior) = REQUIRED]; + */ + protected $project = ''; + /** + * Name or id of the resource for this request. + * + * Generated from protobuf field string resource = 195806222 [(.google.api.field_behavior) = REQUIRED]; + */ + protected $resource = ''; + /** + * The body resource for this request + * + * Generated from protobuf field .google.cloud.compute.v1.TestPermissionsRequest test_permissions_request_resource = 439214758 [(.google.api.field_behavior) = REQUIRED]; + */ + protected $test_permissions_request_resource = null; + + /** + * @param string $project Project ID for this request. + * @param string $resource Name or id of the resource for this request. + * @param \Google\Cloud\Compute\V1\TestPermissionsRequest $testPermissionsRequestResource The body resource for this request + * + * @return \Google\Cloud\Compute\V1\TestIamPermissionsFirewallRequest + * + * @experimental + */ + public static function build(string $project, string $resource, \Google\Cloud\Compute\V1\TestPermissionsRequest $testPermissionsRequestResource): self + { + return (new self()) + ->setProject($project) + ->setResource($resource) + ->setTestPermissionsRequestResource($testPermissionsRequestResource); + } + + /** + * Constructor. + * + * @param array $data { + * Optional. Data for populating the Message object. + * + * @type string $project + * Project ID for this request. + * @type string $resource + * Name or id of the resource for this request. + * @type \Google\Cloud\Compute\V1\TestPermissionsRequest $test_permissions_request_resource + * The body resource for this request + * } + */ + public function __construct($data = NULL) { + \GPBMetadata\Google\Cloud\Compute\V1\Compute::initOnce(); + parent::__construct($data); + } + + /** + * Project ID for this request. + * + * Generated from protobuf field string project = 227560217 [(.google.api.field_behavior) = REQUIRED]; + * @return string + */ + public function getProject() + { + return $this->project; + } + + /** + * Project ID for this request. + * + * Generated from protobuf field string project = 227560217 [(.google.api.field_behavior) = REQUIRED]; + * @param string $var + * @return $this + */ + public function setProject($var) + { + GPBUtil::checkString($var, True); + $this->project = $var; + + return $this; + } + + /** + * Name or id of the resource for this request. + * + * Generated from protobuf field string resource = 195806222 [(.google.api.field_behavior) = REQUIRED]; + * @return string + */ + public function getResource() + { + return $this->resource; + } + + /** + * Name or id of the resource for this request. + * + * Generated from protobuf field string resource = 195806222 [(.google.api.field_behavior) = REQUIRED]; + * @param string $var + * @return $this + */ + public function setResource($var) + { + GPBUtil::checkString($var, True); + $this->resource = $var; + + return $this; + } + + /** + * The body resource for this request + * + * Generated from protobuf field .google.cloud.compute.v1.TestPermissionsRequest test_permissions_request_resource = 439214758 [(.google.api.field_behavior) = REQUIRED]; + * @return \Google\Cloud\Compute\V1\TestPermissionsRequest|null + */ + public function getTestPermissionsRequestResource() + { + return $this->test_permissions_request_resource; + } + + public function hasTestPermissionsRequestResource() + { + return isset($this->test_permissions_request_resource); + } + + public function clearTestPermissionsRequestResource() + { + unset($this->test_permissions_request_resource); + } + + /** + * The body resource for this request + * + * Generated from protobuf field .google.cloud.compute.v1.TestPermissionsRequest test_permissions_request_resource = 439214758 [(.google.api.field_behavior) = REQUIRED]; + * @param \Google\Cloud\Compute\V1\TestPermissionsRequest $var + * @return $this + */ + public function setTestPermissionsRequestResource($var) + { + GPBUtil::checkMessage($var, \Google\Cloud\Compute\V1\TestPermissionsRequest::class); + $this->test_permissions_request_resource = $var; + + return $this; + } + +} + diff --git a/Compute/src/V1/TestIamPermissionsReservationBlockRequest.php b/Compute/src/V1/TestIamPermissionsReservationBlockRequest.php new file mode 100644 index 000000000000..f97a64bb564d --- /dev/null +++ b/Compute/src/V1/TestIamPermissionsReservationBlockRequest.php @@ -0,0 +1,234 @@ +google.cloud.compute.v1.TestIamPermissionsReservationBlockRequest + */ +class TestIamPermissionsReservationBlockRequest extends \Google\Protobuf\Internal\Message +{ + /** + * Name or id of parent resource of the resource for this request. + * + * Generated from protobuf field string parent_resource = 18091011 [(.google.api.field_behavior) = REQUIRED]; + */ + protected $parent_resource = ''; + /** + * Project ID for this request. + * + * Generated from protobuf field string project = 227560217 [(.google.api.field_behavior) = REQUIRED]; + */ + protected $project = ''; + /** + * Name or id of the resource for this request. + * + * Generated from protobuf field string resource = 195806222 [(.google.api.field_behavior) = REQUIRED]; + */ + protected $resource = ''; + /** + * The body resource for this request + * + * Generated from protobuf field .google.cloud.compute.v1.TestPermissionsRequest test_permissions_request_resource = 439214758 [(.google.api.field_behavior) = REQUIRED]; + */ + protected $test_permissions_request_resource = null; + /** + * The name of the zone for this request. + * + * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED]; + */ + protected $zone = ''; + + /** + * @param string $project Project ID for this request. + * @param string $zone The name of the zone for this request. + * @param string $parentResource Name or id of parent resource of the resource for this request. + * @param string $resource Name or id of the resource for this request. + * @param \Google\Cloud\Compute\V1\TestPermissionsRequest $testPermissionsRequestResource The body resource for this request + * + * @return \Google\Cloud\Compute\V1\TestIamPermissionsReservationBlockRequest + * + * @experimental + */ + public static function build(string $project, string $zone, string $parentResource, string $resource, \Google\Cloud\Compute\V1\TestPermissionsRequest $testPermissionsRequestResource): self + { + return (new self()) + ->setProject($project) + ->setZone($zone) + ->setParentResource($parentResource) + ->setResource($resource) + ->setTestPermissionsRequestResource($testPermissionsRequestResource); + } + + /** + * Constructor. + * + * @param array $data { + * Optional. Data for populating the Message object. + * + * @type string $parent_resource + * Name or id of parent resource of the resource for this request. + * @type string $project + * Project ID for this request. + * @type string $resource + * Name or id of the resource for this request. + * @type \Google\Cloud\Compute\V1\TestPermissionsRequest $test_permissions_request_resource + * The body resource for this request + * @type string $zone + * The name of the zone for this request. + * } + */ + public function __construct($data = NULL) { + \GPBMetadata\Google\Cloud\Compute\V1\Compute::initOnce(); + parent::__construct($data); + } + + /** + * Name or id of parent resource of the resource for this request. + * + * Generated from protobuf field string parent_resource = 18091011 [(.google.api.field_behavior) = REQUIRED]; + * @return string + */ + public function getParentResource() + { + return $this->parent_resource; + } + + /** + * Name or id of parent resource of the resource for this request. + * + * Generated from protobuf field string parent_resource = 18091011 [(.google.api.field_behavior) = REQUIRED]; + * @param string $var + * @return $this + */ + public function setParentResource($var) + { + GPBUtil::checkString($var, True); + $this->parent_resource = $var; + + return $this; + } + + /** + * Project ID for this request. + * + * Generated from protobuf field string project = 227560217 [(.google.api.field_behavior) = REQUIRED]; + * @return string + */ + public function getProject() + { + return $this->project; + } + + /** + * Project ID for this request. + * + * Generated from protobuf field string project = 227560217 [(.google.api.field_behavior) = REQUIRED]; + * @param string $var + * @return $this + */ + public function setProject($var) + { + GPBUtil::checkString($var, True); + $this->project = $var; + + return $this; + } + + /** + * Name or id of the resource for this request. + * + * Generated from protobuf field string resource = 195806222 [(.google.api.field_behavior) = REQUIRED]; + * @return string + */ + public function getResource() + { + return $this->resource; + } + + /** + * Name or id of the resource for this request. + * + * Generated from protobuf field string resource = 195806222 [(.google.api.field_behavior) = REQUIRED]; + * @param string $var + * @return $this + */ + public function setResource($var) + { + GPBUtil::checkString($var, True); + $this->resource = $var; + + return $this; + } + + /** + * The body resource for this request + * + * Generated from protobuf field .google.cloud.compute.v1.TestPermissionsRequest test_permissions_request_resource = 439214758 [(.google.api.field_behavior) = REQUIRED]; + * @return \Google\Cloud\Compute\V1\TestPermissionsRequest|null + */ + public function getTestPermissionsRequestResource() + { + return $this->test_permissions_request_resource; + } + + public function hasTestPermissionsRequestResource() + { + return isset($this->test_permissions_request_resource); + } + + public function clearTestPermissionsRequestResource() + { + unset($this->test_permissions_request_resource); + } + + /** + * The body resource for this request + * + * Generated from protobuf field .google.cloud.compute.v1.TestPermissionsRequest test_permissions_request_resource = 439214758 [(.google.api.field_behavior) = REQUIRED]; + * @param \Google\Cloud\Compute\V1\TestPermissionsRequest $var + * @return $this + */ + public function setTestPermissionsRequestResource($var) + { + GPBUtil::checkMessage($var, \Google\Cloud\Compute\V1\TestPermissionsRequest::class); + $this->test_permissions_request_resource = $var; + + return $this; + } + + /** + * The name of the zone for this request. + * + * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED]; + * @return string + */ + public function getZone() + { + return $this->zone; + } + + /** + * The name of the zone for this request. + * + * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED]; + * @param string $var + * @return $this + */ + public function setZone($var) + { + GPBUtil::checkString($var, True); + $this->zone = $var; + + return $this; + } + +} + diff --git a/Compute/src/V1/TestIamPermissionsReservationSubBlockRequest.php b/Compute/src/V1/TestIamPermissionsReservationSubBlockRequest.php new file mode 100644 index 000000000000..357530680f0d --- /dev/null +++ b/Compute/src/V1/TestIamPermissionsReservationSubBlockRequest.php @@ -0,0 +1,234 @@ +google.cloud.compute.v1.TestIamPermissionsReservationSubBlockRequest + */ +class TestIamPermissionsReservationSubBlockRequest extends \Google\Protobuf\Internal\Message +{ + /** + * Name or id of parent resource of the resource for this request. + * + * Generated from protobuf field string parent_resource = 18091011 [(.google.api.field_behavior) = REQUIRED]; + */ + protected $parent_resource = ''; + /** + * Project ID for this request. + * + * Generated from protobuf field string project = 227560217 [(.google.api.field_behavior) = REQUIRED]; + */ + protected $project = ''; + /** + * Name or id of the resource for this request. + * + * Generated from protobuf field string resource = 195806222 [(.google.api.field_behavior) = REQUIRED]; + */ + protected $resource = ''; + /** + * The body resource for this request + * + * Generated from protobuf field .google.cloud.compute.v1.TestPermissionsRequest test_permissions_request_resource = 439214758 [(.google.api.field_behavior) = REQUIRED]; + */ + protected $test_permissions_request_resource = null; + /** + * The name of the zone for this request. + * + * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED]; + */ + protected $zone = ''; + + /** + * @param string $project Project ID for this request. + * @param string $zone The name of the zone for this request. + * @param string $parentResource Name or id of parent resource of the resource for this request. + * @param string $resource Name or id of the resource for this request. + * @param \Google\Cloud\Compute\V1\TestPermissionsRequest $testPermissionsRequestResource The body resource for this request + * + * @return \Google\Cloud\Compute\V1\TestIamPermissionsReservationSubBlockRequest + * + * @experimental + */ + public static function build(string $project, string $zone, string $parentResource, string $resource, \Google\Cloud\Compute\V1\TestPermissionsRequest $testPermissionsRequestResource): self + { + return (new self()) + ->setProject($project) + ->setZone($zone) + ->setParentResource($parentResource) + ->setResource($resource) + ->setTestPermissionsRequestResource($testPermissionsRequestResource); + } + + /** + * Constructor. + * + * @param array $data { + * Optional. Data for populating the Message object. + * + * @type string $parent_resource + * Name or id of parent resource of the resource for this request. + * @type string $project + * Project ID for this request. + * @type string $resource + * Name or id of the resource for this request. + * @type \Google\Cloud\Compute\V1\TestPermissionsRequest $test_permissions_request_resource + * The body resource for this request + * @type string $zone + * The name of the zone for this request. + * } + */ + public function __construct($data = NULL) { + \GPBMetadata\Google\Cloud\Compute\V1\Compute::initOnce(); + parent::__construct($data); + } + + /** + * Name or id of parent resource of the resource for this request. + * + * Generated from protobuf field string parent_resource = 18091011 [(.google.api.field_behavior) = REQUIRED]; + * @return string + */ + public function getParentResource() + { + return $this->parent_resource; + } + + /** + * Name or id of parent resource of the resource for this request. + * + * Generated from protobuf field string parent_resource = 18091011 [(.google.api.field_behavior) = REQUIRED]; + * @param string $var + * @return $this + */ + public function setParentResource($var) + { + GPBUtil::checkString($var, True); + $this->parent_resource = $var; + + return $this; + } + + /** + * Project ID for this request. + * + * Generated from protobuf field string project = 227560217 [(.google.api.field_behavior) = REQUIRED]; + * @return string + */ + public function getProject() + { + return $this->project; + } + + /** + * Project ID for this request. + * + * Generated from protobuf field string project = 227560217 [(.google.api.field_behavior) = REQUIRED]; + * @param string $var + * @return $this + */ + public function setProject($var) + { + GPBUtil::checkString($var, True); + $this->project = $var; + + return $this; + } + + /** + * Name or id of the resource for this request. + * + * Generated from protobuf field string resource = 195806222 [(.google.api.field_behavior) = REQUIRED]; + * @return string + */ + public function getResource() + { + return $this->resource; + } + + /** + * Name or id of the resource for this request. + * + * Generated from protobuf field string resource = 195806222 [(.google.api.field_behavior) = REQUIRED]; + * @param string $var + * @return $this + */ + public function setResource($var) + { + GPBUtil::checkString($var, True); + $this->resource = $var; + + return $this; + } + + /** + * The body resource for this request + * + * Generated from protobuf field .google.cloud.compute.v1.TestPermissionsRequest test_permissions_request_resource = 439214758 [(.google.api.field_behavior) = REQUIRED]; + * @return \Google\Cloud\Compute\V1\TestPermissionsRequest|null + */ + public function getTestPermissionsRequestResource() + { + return $this->test_permissions_request_resource; + } + + public function hasTestPermissionsRequestResource() + { + return isset($this->test_permissions_request_resource); + } + + public function clearTestPermissionsRequestResource() + { + unset($this->test_permissions_request_resource); + } + + /** + * The body resource for this request + * + * Generated from protobuf field .google.cloud.compute.v1.TestPermissionsRequest test_permissions_request_resource = 439214758 [(.google.api.field_behavior) = REQUIRED]; + * @param \Google\Cloud\Compute\V1\TestPermissionsRequest $var + * @return $this + */ + public function setTestPermissionsRequestResource($var) + { + GPBUtil::checkMessage($var, \Google\Cloud\Compute\V1\TestPermissionsRequest::class); + $this->test_permissions_request_resource = $var; + + return $this; + } + + /** + * The name of the zone for this request. + * + * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED]; + * @return string + */ + public function getZone() + { + return $this->zone; + } + + /** + * The name of the zone for this request. + * + * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED]; + * @param string $var + * @return $this + */ + public function setZone($var) + { + GPBUtil::checkString($var, True); + $this->zone = $var; + + return $this; + } + +} + diff --git a/Compute/src/V1/TestPermissionsRequest.php b/Compute/src/V1/TestPermissionsRequest.php index 34b53d9f6d43..b9039e712d80 100644 --- a/Compute/src/V1/TestPermissionsRequest.php +++ b/Compute/src/V1/TestPermissionsRequest.php @@ -15,7 +15,8 @@ class TestPermissionsRequest extends \Google\Protobuf\Internal\Message { /** - * The set of permissions to check for the 'resource'. Permissions with wildcards (such as '*' or 'storage.*') are not allowed. + * The set of permissions to check for the 'resource'. Permissions with + * wildcards (such as '*' or 'storage.*') are not allowed. * * Generated from protobuf field repeated string permissions = 59962500; */ @@ -28,7 +29,8 @@ class TestPermissionsRequest extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type array|\Google\Protobuf\Internal\RepeatedField $permissions - * The set of permissions to check for the 'resource'. Permissions with wildcards (such as '*' or 'storage.*') are not allowed. + * The set of permissions to check for the 'resource'. Permissions with + * wildcards (such as '*' or 'storage.*') are not allowed. * } */ public function __construct($data = NULL) { @@ -37,7 +39,8 @@ public function __construct($data = NULL) { } /** - * The set of permissions to check for the 'resource'. Permissions with wildcards (such as '*' or 'storage.*') are not allowed. + * The set of permissions to check for the 'resource'. Permissions with + * wildcards (such as '*' or 'storage.*') are not allowed. * * Generated from protobuf field repeated string permissions = 59962500; * @return \Google\Protobuf\Internal\RepeatedField @@ -48,7 +51,8 @@ public function getPermissions() } /** - * The set of permissions to check for the 'resource'. Permissions with wildcards (such as '*' or 'storage.*') are not allowed. + * The set of permissions to check for the 'resource'. Permissions with + * wildcards (such as '*' or 'storage.*') are not allowed. * * Generated from protobuf field repeated string permissions = 59962500; * @param array|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/TestPermissionsResponse.php b/Compute/src/V1/TestPermissionsResponse.php index 0a2f4a8947a5..b205de51b6b3 100644 --- a/Compute/src/V1/TestPermissionsResponse.php +++ b/Compute/src/V1/TestPermissionsResponse.php @@ -15,7 +15,8 @@ class TestPermissionsResponse extends \Google\Protobuf\Internal\Message { /** - * A subset of `TestPermissionsRequest.permissions` that the caller is allowed. + * A subset of `TestPermissionsRequest.permissions` that the caller is + * allowed. * * Generated from protobuf field repeated string permissions = 59962500; */ @@ -28,7 +29,8 @@ class TestPermissionsResponse extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type array|\Google\Protobuf\Internal\RepeatedField $permissions - * A subset of `TestPermissionsRequest.permissions` that the caller is allowed. + * A subset of `TestPermissionsRequest.permissions` that the caller is + * allowed. * } */ public function __construct($data = NULL) { @@ -37,7 +39,8 @@ public function __construct($data = NULL) { } /** - * A subset of `TestPermissionsRequest.permissions` that the caller is allowed. + * A subset of `TestPermissionsRequest.permissions` that the caller is + * allowed. * * Generated from protobuf field repeated string permissions = 59962500; * @return \Google\Protobuf\Internal\RepeatedField @@ -48,7 +51,8 @@ public function getPermissions() } /** - * A subset of `TestPermissionsRequest.permissions` that the caller is allowed. + * A subset of `TestPermissionsRequest.permissions` that the caller is + * allowed. * * Generated from protobuf field repeated string permissions = 59962500; * @param array|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/UpcomingMaintenance.php b/Compute/src/V1/UpcomingMaintenance.php index e36e9899bf34..60048a9b787d 100644 --- a/Compute/src/V1/UpcomingMaintenance.php +++ b/Compute/src/V1/UpcomingMaintenance.php @@ -22,7 +22,8 @@ class UpcomingMaintenance extends \Google\Protobuf\Internal\Message */ protected $can_reschedule = null; /** - * The latest time for the planned maintenance window to start. This timestamp value is in RFC3339 text format. + * The latest time for the planned maintenance window to start. + * This timestamp value is in RFC3339 text format. * * Generated from protobuf field optional string latest_window_start_time = 128032129; */ @@ -55,13 +56,15 @@ class UpcomingMaintenance extends \Google\Protobuf\Internal\Message */ protected $type = null; /** - * The time by which the maintenance disruption will be completed. This timestamp value is in RFC3339 text format. + * The time by which the maintenance disruption will be completed. + * This timestamp value is in RFC3339 text format. * * Generated from protobuf field optional string window_end_time = 271816480; */ protected $window_end_time = null; /** - * The current start time of the maintenance window. This timestamp value is in RFC3339 text format. + * The current start time of the maintenance window. + * This timestamp value is in RFC3339 text format. * * Generated from protobuf field optional string window_start_time = 473061433; */ @@ -76,7 +79,8 @@ class UpcomingMaintenance extends \Google\Protobuf\Internal\Message * @type bool $can_reschedule * Indicates if the maintenance can be customer triggered. * @type string $latest_window_start_time - * The latest time for the planned maintenance window to start. This timestamp value is in RFC3339 text format. + * The latest time for the planned maintenance window to start. + * This timestamp value is in RFC3339 text format. * @type bool $maintenance_on_shutdown * Indicates whether the UpcomingMaintenance will be triggered on VM shutdown. * @type array|\Google\Protobuf\Internal\RepeatedField $maintenance_reasons @@ -89,9 +93,11 @@ class UpcomingMaintenance extends \Google\Protobuf\Internal\Message * Defines the type of maintenance. * Check the Type enum for the list of possible values. * @type string $window_end_time - * The time by which the maintenance disruption will be completed. This timestamp value is in RFC3339 text format. + * The time by which the maintenance disruption will be completed. + * This timestamp value is in RFC3339 text format. * @type string $window_start_time - * The current start time of the maintenance window. This timestamp value is in RFC3339 text format. + * The current start time of the maintenance window. + * This timestamp value is in RFC3339 text format. * } */ public function __construct($data = NULL) { @@ -136,7 +142,8 @@ public function setCanReschedule($var) } /** - * The latest time for the planned maintenance window to start. This timestamp value is in RFC3339 text format. + * The latest time for the planned maintenance window to start. + * This timestamp value is in RFC3339 text format. * * Generated from protobuf field optional string latest_window_start_time = 128032129; * @return string @@ -157,7 +164,8 @@ public function clearLatestWindowStartTime() } /** - * The latest time for the planned maintenance window to start. This timestamp value is in RFC3339 text format. + * The latest time for the planned maintenance window to start. + * This timestamp value is in RFC3339 text format. * * Generated from protobuf field optional string latest_window_start_time = 128032129; * @param string $var @@ -312,7 +320,8 @@ public function setType($var) } /** - * The time by which the maintenance disruption will be completed. This timestamp value is in RFC3339 text format. + * The time by which the maintenance disruption will be completed. + * This timestamp value is in RFC3339 text format. * * Generated from protobuf field optional string window_end_time = 271816480; * @return string @@ -333,7 +342,8 @@ public function clearWindowEndTime() } /** - * The time by which the maintenance disruption will be completed. This timestamp value is in RFC3339 text format. + * The time by which the maintenance disruption will be completed. + * This timestamp value is in RFC3339 text format. * * Generated from protobuf field optional string window_end_time = 271816480; * @param string $var @@ -348,7 +358,8 @@ public function setWindowEndTime($var) } /** - * The current start time of the maintenance window. This timestamp value is in RFC3339 text format. + * The current start time of the maintenance window. + * This timestamp value is in RFC3339 text format. * * Generated from protobuf field optional string window_start_time = 473061433; * @return string @@ -369,7 +380,8 @@ public function clearWindowStartTime() } /** - * The current start time of the maintenance window. This timestamp value is in RFC3339 text format. + * The current start time of the maintenance window. + * This timestamp value is in RFC3339 text format. * * Generated from protobuf field optional string window_start_time = 473061433; * @param string $var diff --git a/Compute/src/V1/UpcomingMaintenance/MaintenanceReasons.php b/Compute/src/V1/UpcomingMaintenance/MaintenanceReasons.php index 88b98f24ab4e..3b2c2e50f1c0 100644 --- a/Compute/src/V1/UpcomingMaintenance/MaintenanceReasons.php +++ b/Compute/src/V1/UpcomingMaintenance/MaintenanceReasons.php @@ -31,13 +31,15 @@ class MaintenanceReasons */ const FAILURE_GPU = 467876919; /** - * Maintenance due to customer reported multiple faulty hosts via R&R Subblock API. + * Maintenance due to customer reported multiple faulty hosts via R&R + * Subblock API. * * Generated from protobuf enum FAILURE_GPU_MULTIPLE_FAULTY_HOSTS_CUSTOMER_REPORTED = 223284959; */ const FAILURE_GPU_MULTIPLE_FAULTY_HOSTS_CUSTOMER_REPORTED = 223284959; /** - * Maintenance due to customer reported NVLink switch failure via R&R Subblock API. + * Maintenance due to customer reported NVLink switch failure via R&R + * Subblock API. * * Generated from protobuf enum FAILURE_GPU_NVLINK_SWITCH_CUSTOMER_REPORTED = 88487838; */ @@ -90,6 +92,12 @@ class MaintenanceReasons * Generated from protobuf enum FAILURE_REDUNDANT_HARDWARE_FAULT = 31000530; */ const FAILURE_REDUNDANT_HARDWARE_FAULT = 31000530; + /** + * Maintenance due to TPU errors. + * + * Generated from protobuf enum FAILURE_TPU = 467889412; + */ + const FAILURE_TPU = 467889412; /** * Maintenance due to infrastructure relocation. * @@ -129,6 +137,7 @@ class MaintenanceReasons self::FAILURE_NETWORK => 'FAILURE_NETWORK', self::FAILURE_NVLINK => 'FAILURE_NVLINK', self::FAILURE_REDUNDANT_HARDWARE_FAULT => 'FAILURE_REDUNDANT_HARDWARE_FAULT', + self::FAILURE_TPU => 'FAILURE_TPU', self::INFRASTRUCTURE_RELOCATION => 'INFRASTRUCTURE_RELOCATION', self::MAINTENANCE_REASON_UNKNOWN => 'MAINTENANCE_REASON_UNKNOWN', self::PLANNED_NETWORK_UPDATE => 'PLANNED_NETWORK_UPDATE', diff --git a/Compute/src/V1/UpcomingMaintenance/Type.php b/Compute/src/V1/UpcomingMaintenance/Type.php index 49ed12326da6..2891d087b08c 100644 --- a/Compute/src/V1/UpcomingMaintenance/Type.php +++ b/Compute/src/V1/UpcomingMaintenance/Type.php @@ -20,13 +20,15 @@ class Type */ const UNDEFINED_TYPE = 0; /** - * Multiple maintenance types in one window. This is only intended to be used for groups. + * Multiple maintenance types in one window. + * This is only intended to be used for groups. * * Generated from protobuf enum MULTIPLE = 362714640; */ const MULTIPLE = 362714640; /** - * Scheduled maintenance (e.g. maintenance after uptime guarantee is complete). + * Scheduled maintenance (e.g. maintenance after uptime guarantee is + * complete). * * Generated from protobuf enum SCHEDULED = 478400653; */ @@ -38,7 +40,8 @@ class Type */ const UNKNOWN_TYPE = 490705455; /** - * Unscheduled maintenance (e.g. emergency maintenance during uptime guarantee). + * Unscheduled maintenance (e.g. emergency maintenance during + * uptime guarantee). * * Generated from protobuf enum UNSCHEDULED = 450077204; */ diff --git a/Compute/src/V1/UpdateAccessConfigInstanceRequest.php b/Compute/src/V1/UpdateAccessConfigInstanceRequest.php index bd939c973d6d..bf3c75bfaa33 100644 --- a/Compute/src/V1/UpdateAccessConfigInstanceRequest.php +++ b/Compute/src/V1/UpdateAccessConfigInstanceRequest.php @@ -40,7 +40,17 @@ class UpdateAccessConfigInstanceRequest extends \Google\Protobuf\Internal\Messag */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -88,7 +98,17 @@ public static function build(string $project, string $zone, string $instance, st * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $zone * The name of the zone for this request. * } @@ -213,7 +233,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -234,7 +264,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/UpdateAutoscalerRequest.php b/Compute/src/V1/UpdateAutoscalerRequest.php index 210313c03dee..91a226541fca 100644 --- a/Compute/src/V1/UpdateAutoscalerRequest.php +++ b/Compute/src/V1/UpdateAutoscalerRequest.php @@ -34,7 +34,17 @@ class UpdateAutoscalerRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -76,7 +86,17 @@ public static function build(string $project, string $zone, \Google\Cloud\Comput * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $zone * Name of the zone for this request. * } @@ -185,7 +205,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -206,7 +236,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/UpdateBackendBucketRequest.php b/Compute/src/V1/UpdateBackendBucketRequest.php index 43b3854f2055..a1ab41915686 100644 --- a/Compute/src/V1/UpdateBackendBucketRequest.php +++ b/Compute/src/V1/UpdateBackendBucketRequest.php @@ -34,7 +34,17 @@ class UpdateBackendBucketRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -70,7 +80,17 @@ public static function build(string $project, string $backendBucket, \Google\Clo * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -167,7 +187,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -188,7 +218,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/UpdateBackendServiceRequest.php b/Compute/src/V1/UpdateBackendServiceRequest.php index 9da260ec5e39..9057166282a2 100644 --- a/Compute/src/V1/UpdateBackendServiceRequest.php +++ b/Compute/src/V1/UpdateBackendServiceRequest.php @@ -34,7 +34,17 @@ class UpdateBackendServiceRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -70,7 +80,17 @@ public static function build(string $project, string $backendService, \Google\Cl * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -167,7 +187,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -188,7 +218,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/UpdateDiskRequest.php b/Compute/src/V1/UpdateDiskRequest.php index 559b1a1d9744..bb31dd3a61e2 100644 --- a/Compute/src/V1/UpdateDiskRequest.php +++ b/Compute/src/V1/UpdateDiskRequest.php @@ -38,7 +38,17 @@ class UpdateDiskRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -89,7 +99,17 @@ public static function build(string $project, string $zone, string $disk, \Googl * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $update_mask * update_mask indicates fields to be updated as part of this request. * @type string $zone @@ -222,7 +242,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -243,7 +273,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/UpdateDisplayDeviceInstanceRequest.php b/Compute/src/V1/UpdateDisplayDeviceInstanceRequest.php index bdd447d9d017..a2da0b966805 100644 --- a/Compute/src/V1/UpdateDisplayDeviceInstanceRequest.php +++ b/Compute/src/V1/UpdateDisplayDeviceInstanceRequest.php @@ -34,7 +34,17 @@ class UpdateDisplayDeviceInstanceRequest extends \Google\Protobuf\Internal\Messa */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -78,7 +88,17 @@ public static function build(string $project, string $zone, string $instance, \G * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $zone * The name of the zone for this request. * } @@ -177,7 +197,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -198,7 +228,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/UpdateFirewallRequest.php b/Compute/src/V1/UpdateFirewallRequest.php index 56ec1a01c119..0aa31fcfdc6e 100644 --- a/Compute/src/V1/UpdateFirewallRequest.php +++ b/Compute/src/V1/UpdateFirewallRequest.php @@ -34,7 +34,17 @@ class UpdateFirewallRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -70,7 +80,17 @@ public static function build(string $project, string $firewall, \Google\Cloud\Co * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -167,7 +187,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -188,7 +218,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/UpdateFutureReservationRequest.php b/Compute/src/V1/UpdateFutureReservationRequest.php new file mode 100644 index 000000000000..989dd795b695 --- /dev/null +++ b/Compute/src/V1/UpdateFutureReservationRequest.php @@ -0,0 +1,326 @@ +google.cloud.compute.v1.UpdateFutureReservationRequest + */ +class UpdateFutureReservationRequest extends \Google\Protobuf\Internal\Message +{ + /** + * Name of the reservation to update. Name should conform to RFC1035. + * + * Generated from protobuf field string future_reservation = 56206160 [(.google.api.field_behavior) = REQUIRED]; + */ + protected $future_reservation = ''; + /** + * The body resource for this request + * + * Generated from protobuf field .google.cloud.compute.v1.FutureReservation future_reservation_resource = 466750493 [(.google.api.field_behavior) = REQUIRED]; + */ + protected $future_reservation_resource = null; + /** + * Project ID for this request. + * + * Generated from protobuf field string project = 227560217 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "project"]; + */ + protected $project = ''; + /** + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). + * + * Generated from protobuf field optional string request_id = 37109963; + */ + protected $request_id = null; + /** + * update_mask indicates fields to be updated as part of this request. + * + * Generated from protobuf field optional string update_mask = 500079778; + */ + protected $update_mask = null; + /** + * Name of the zone for this request. Name should conform to RFC1035. + * + * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; + */ + protected $zone = ''; + + /** + * @param string $project Project ID for this request. + * @param string $zone Name of the zone for this request. Name should conform to RFC1035. + * @param string $futureReservation Name of the reservation to update. Name should conform to RFC1035. + * @param \Google\Cloud\Compute\V1\FutureReservation $futureReservationResource The body resource for this request + * + * @return \Google\Cloud\Compute\V1\UpdateFutureReservationRequest + * + * @experimental + */ + public static function build(string $project, string $zone, string $futureReservation, \Google\Cloud\Compute\V1\FutureReservation $futureReservationResource): self + { + return (new self()) + ->setProject($project) + ->setZone($zone) + ->setFutureReservation($futureReservation) + ->setFutureReservationResource($futureReservationResource); + } + + /** + * Constructor. + * + * @param array $data { + * Optional. Data for populating the Message object. + * + * @type string $future_reservation + * Name of the reservation to update. Name should conform to RFC1035. + * @type \Google\Cloud\Compute\V1\FutureReservation $future_reservation_resource + * The body resource for this request + * @type string $project + * Project ID for this request. + * @type string $request_id + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). + * @type string $update_mask + * update_mask indicates fields to be updated as part of this request. + * @type string $zone + * Name of the zone for this request. Name should conform to RFC1035. + * } + */ + public function __construct($data = NULL) { + \GPBMetadata\Google\Cloud\Compute\V1\Compute::initOnce(); + parent::__construct($data); + } + + /** + * Name of the reservation to update. Name should conform to RFC1035. + * + * Generated from protobuf field string future_reservation = 56206160 [(.google.api.field_behavior) = REQUIRED]; + * @return string + */ + public function getFutureReservation() + { + return $this->future_reservation; + } + + /** + * Name of the reservation to update. Name should conform to RFC1035. + * + * Generated from protobuf field string future_reservation = 56206160 [(.google.api.field_behavior) = REQUIRED]; + * @param string $var + * @return $this + */ + public function setFutureReservation($var) + { + GPBUtil::checkString($var, True); + $this->future_reservation = $var; + + return $this; + } + + /** + * The body resource for this request + * + * Generated from protobuf field .google.cloud.compute.v1.FutureReservation future_reservation_resource = 466750493 [(.google.api.field_behavior) = REQUIRED]; + * @return \Google\Cloud\Compute\V1\FutureReservation|null + */ + public function getFutureReservationResource() + { + return $this->future_reservation_resource; + } + + public function hasFutureReservationResource() + { + return isset($this->future_reservation_resource); + } + + public function clearFutureReservationResource() + { + unset($this->future_reservation_resource); + } + + /** + * The body resource for this request + * + * Generated from protobuf field .google.cloud.compute.v1.FutureReservation future_reservation_resource = 466750493 [(.google.api.field_behavior) = REQUIRED]; + * @param \Google\Cloud\Compute\V1\FutureReservation $var + * @return $this + */ + public function setFutureReservationResource($var) + { + GPBUtil::checkMessage($var, \Google\Cloud\Compute\V1\FutureReservation::class); + $this->future_reservation_resource = $var; + + return $this; + } + + /** + * Project ID for this request. + * + * Generated from protobuf field string project = 227560217 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "project"]; + * @return string + */ + public function getProject() + { + return $this->project; + } + + /** + * Project ID for this request. + * + * Generated from protobuf field string project = 227560217 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "project"]; + * @param string $var + * @return $this + */ + public function setProject($var) + { + GPBUtil::checkString($var, True); + $this->project = $var; + + return $this; + } + + /** + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). + * + * Generated from protobuf field optional string request_id = 37109963; + * @return string + */ + public function getRequestId() + { + return isset($this->request_id) ? $this->request_id : ''; + } + + public function hasRequestId() + { + return isset($this->request_id); + } + + public function clearRequestId() + { + unset($this->request_id); + } + + /** + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). + * + * Generated from protobuf field optional string request_id = 37109963; + * @param string $var + * @return $this + */ + public function setRequestId($var) + { + GPBUtil::checkString($var, True); + $this->request_id = $var; + + return $this; + } + + /** + * update_mask indicates fields to be updated as part of this request. + * + * Generated from protobuf field optional string update_mask = 500079778; + * @return string + */ + public function getUpdateMask() + { + return isset($this->update_mask) ? $this->update_mask : ''; + } + + public function hasUpdateMask() + { + return isset($this->update_mask); + } + + public function clearUpdateMask() + { + unset($this->update_mask); + } + + /** + * update_mask indicates fields to be updated as part of this request. + * + * Generated from protobuf field optional string update_mask = 500079778; + * @param string $var + * @return $this + */ + public function setUpdateMask($var) + { + GPBUtil::checkString($var, True); + $this->update_mask = $var; + + return $this; + } + + /** + * Name of the zone for this request. Name should conform to RFC1035. + * + * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; + * @return string + */ + public function getZone() + { + return $this->zone; + } + + /** + * Name of the zone for this request. Name should conform to RFC1035. + * + * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; + * @param string $var + * @return $this + */ + public function setZone($var) + { + GPBUtil::checkString($var, True); + $this->zone = $var; + + return $this; + } + +} + diff --git a/Compute/src/V1/UpdateHealthCheckRequest.php b/Compute/src/V1/UpdateHealthCheckRequest.php index 0df7d03caeaa..6e9a8418508d 100644 --- a/Compute/src/V1/UpdateHealthCheckRequest.php +++ b/Compute/src/V1/UpdateHealthCheckRequest.php @@ -34,7 +34,17 @@ class UpdateHealthCheckRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -70,7 +80,17 @@ public static function build(string $project, string $healthCheck, \Google\Cloud * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -167,7 +187,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -188,7 +218,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/UpdateInstanceRequest.php b/Compute/src/V1/UpdateInstanceRequest.php index 221abb38998e..2f574308717b 100644 --- a/Compute/src/V1/UpdateInstanceRequest.php +++ b/Compute/src/V1/UpdateInstanceRequest.php @@ -28,14 +28,21 @@ class UpdateInstanceRequest extends \Google\Protobuf\Internal\Message */ protected $instance_resource = null; /** - * Specifies the action to take when updating an instance even if the updated properties do not require it. If not specified, then Compute Engine acts based on the minimum action that the updated properties require. + * Specifies the action to take when updating an instance even if the + * updated properties do not require it. If not specified, then + * Compute Engine acts based on the minimum action that the updated + * properties require. * Check the MinimalAction enum for the list of possible values. * * Generated from protobuf field optional string minimal_action = 270567060; */ protected $minimal_action = null; /** - * Specifies the most disruptive action that can be taken on the instance as part of the update. Compute Engine returns an error if the instance properties require a more disruptive action as part of the instance update. Valid options from lowest to highest are NO_EFFECT, REFRESH, and RESTART. + * Specifies the most disruptive action that can be taken on the instance + * as part of the update. Compute Engine returns an error if the + * instance properties require a more disruptive action as part of the + * instance update. Valid options from lowest to highest are + * NO_EFFECT, REFRESH, and RESTART. * Check the MostDisruptiveAllowedAction enum for the list of possible values. * * Generated from protobuf field optional string most_disruptive_allowed_action = 66103053; @@ -48,7 +55,17 @@ class UpdateInstanceRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -90,15 +107,32 @@ public static function build(string $project, string $zone, string $instance, \G * @type \Google\Cloud\Compute\V1\Instance $instance_resource * The body resource for this request * @type string $minimal_action - * Specifies the action to take when updating an instance even if the updated properties do not require it. If not specified, then Compute Engine acts based on the minimum action that the updated properties require. + * Specifies the action to take when updating an instance even if the + * updated properties do not require it. If not specified, then + * Compute Engine acts based on the minimum action that the updated + * properties require. * Check the MinimalAction enum for the list of possible values. * @type string $most_disruptive_allowed_action - * Specifies the most disruptive action that can be taken on the instance as part of the update. Compute Engine returns an error if the instance properties require a more disruptive action as part of the instance update. Valid options from lowest to highest are NO_EFFECT, REFRESH, and RESTART. + * Specifies the most disruptive action that can be taken on the instance + * as part of the update. Compute Engine returns an error if the + * instance properties require a more disruptive action as part of the + * instance update. Valid options from lowest to highest are + * NO_EFFECT, REFRESH, and RESTART. * Check the MostDisruptiveAllowedAction enum for the list of possible values. * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $zone * The name of the zone for this request. * } @@ -171,7 +205,10 @@ public function setInstanceResource($var) } /** - * Specifies the action to take when updating an instance even if the updated properties do not require it. If not specified, then Compute Engine acts based on the minimum action that the updated properties require. + * Specifies the action to take when updating an instance even if the + * updated properties do not require it. If not specified, then + * Compute Engine acts based on the minimum action that the updated + * properties require. * Check the MinimalAction enum for the list of possible values. * * Generated from protobuf field optional string minimal_action = 270567060; @@ -193,7 +230,10 @@ public function clearMinimalAction() } /** - * Specifies the action to take when updating an instance even if the updated properties do not require it. If not specified, then Compute Engine acts based on the minimum action that the updated properties require. + * Specifies the action to take when updating an instance even if the + * updated properties do not require it. If not specified, then + * Compute Engine acts based on the minimum action that the updated + * properties require. * Check the MinimalAction enum for the list of possible values. * * Generated from protobuf field optional string minimal_action = 270567060; @@ -209,7 +249,11 @@ public function setMinimalAction($var) } /** - * Specifies the most disruptive action that can be taken on the instance as part of the update. Compute Engine returns an error if the instance properties require a more disruptive action as part of the instance update. Valid options from lowest to highest are NO_EFFECT, REFRESH, and RESTART. + * Specifies the most disruptive action that can be taken on the instance + * as part of the update. Compute Engine returns an error if the + * instance properties require a more disruptive action as part of the + * instance update. Valid options from lowest to highest are + * NO_EFFECT, REFRESH, and RESTART. * Check the MostDisruptiveAllowedAction enum for the list of possible values. * * Generated from protobuf field optional string most_disruptive_allowed_action = 66103053; @@ -231,7 +275,11 @@ public function clearMostDisruptiveAllowedAction() } /** - * Specifies the most disruptive action that can be taken on the instance as part of the update. Compute Engine returns an error if the instance properties require a more disruptive action as part of the instance update. Valid options from lowest to highest are NO_EFFECT, REFRESH, and RESTART. + * Specifies the most disruptive action that can be taken on the instance + * as part of the update. Compute Engine returns an error if the + * instance properties require a more disruptive action as part of the + * instance update. Valid options from lowest to highest are + * NO_EFFECT, REFRESH, and RESTART. * Check the MostDisruptiveAllowedAction enum for the list of possible values. * * Generated from protobuf field optional string most_disruptive_allowed_action = 66103053; @@ -273,7 +321,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -294,7 +352,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/UpdateInstanceRequest/MinimalAction.php b/Compute/src/V1/UpdateInstanceRequest/MinimalAction.php index fbed75affdae..3e77411aadea 100644 --- a/Compute/src/V1/UpdateInstanceRequest/MinimalAction.php +++ b/Compute/src/V1/UpdateInstanceRequest/MinimalAction.php @@ -7,7 +7,10 @@ use UnexpectedValueException; /** - * Specifies the action to take when updating an instance even if the updated properties do not require it. If not specified, then Compute Engine acts based on the minimum action that the updated properties require. + * Specifies the action to take when updating an instance even if the + * updated properties do not require it. If not specified, then + * Compute Engine acts based on the minimum action that the updated + * properties require. * Additional supported values which may be not listed in the enum directly due to technical reasons: * INVALID * NO_EFFECT diff --git a/Compute/src/V1/UpdateInstanceRequest/MostDisruptiveAllowedAction.php b/Compute/src/V1/UpdateInstanceRequest/MostDisruptiveAllowedAction.php index 96ccd30a2572..62915047dacf 100644 --- a/Compute/src/V1/UpdateInstanceRequest/MostDisruptiveAllowedAction.php +++ b/Compute/src/V1/UpdateInstanceRequest/MostDisruptiveAllowedAction.php @@ -7,7 +7,11 @@ use UnexpectedValueException; /** - * Specifies the most disruptive action that can be taken on the instance as part of the update. Compute Engine returns an error if the instance properties require a more disruptive action as part of the instance update. Valid options from lowest to highest are NO_EFFECT, REFRESH, and RESTART. + * Specifies the most disruptive action that can be taken on the instance + * as part of the update. Compute Engine returns an error if the + * instance properties require a more disruptive action as part of the + * instance update. Valid options from lowest to highest are + * NO_EFFECT, REFRESH, and RESTART. * Additional supported values which may be not listed in the enum directly due to technical reasons: * INVALID * NO_EFFECT diff --git a/Compute/src/V1/UpdateLicenseRequest.php b/Compute/src/V1/UpdateLicenseRequest.php index 5b3a82b8dcba..9c1ba5be4059 100644 --- a/Compute/src/V1/UpdateLicenseRequest.php +++ b/Compute/src/V1/UpdateLicenseRequest.php @@ -34,7 +34,17 @@ class UpdateLicenseRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -76,7 +86,17 @@ public static function build(string $project, string $license, \Google\Cloud\Com * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $update_mask * update_mask indicates fields to be updated as part of this request. * } @@ -175,7 +195,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -196,7 +226,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/UpdateNetworkInterfaceInstanceRequest.php b/Compute/src/V1/UpdateNetworkInterfaceInstanceRequest.php index 8273eb8168e7..166af6a28e40 100644 --- a/Compute/src/V1/UpdateNetworkInterfaceInstanceRequest.php +++ b/Compute/src/V1/UpdateNetworkInterfaceInstanceRequest.php @@ -40,7 +40,17 @@ class UpdateNetworkInterfaceInstanceRequest extends \Google\Protobuf\Internal\Me */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -88,7 +98,17 @@ public static function build(string $project, string $zone, string $instance, st * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $zone * The name of the zone for this request. * } @@ -213,7 +233,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -234,7 +264,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/UpdatePeeringNetworkRequest.php b/Compute/src/V1/UpdatePeeringNetworkRequest.php index 9e620c392d0d..8d0d1d7d1cc0 100644 --- a/Compute/src/V1/UpdatePeeringNetworkRequest.php +++ b/Compute/src/V1/UpdatePeeringNetworkRequest.php @@ -34,7 +34,17 @@ class UpdatePeeringNetworkRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -70,7 +80,17 @@ public static function build(string $project, string $network, \Google\Cloud\Com * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -167,7 +187,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -188,7 +218,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/UpdatePerInstanceConfigsInstanceGroupManagerRequest.php b/Compute/src/V1/UpdatePerInstanceConfigsInstanceGroupManagerRequest.php index 4f7848426f2f..a7cd96fe7222 100644 --- a/Compute/src/V1/UpdatePerInstanceConfigsInstanceGroupManagerRequest.php +++ b/Compute/src/V1/UpdatePerInstanceConfigsInstanceGroupManagerRequest.php @@ -16,7 +16,8 @@ class UpdatePerInstanceConfigsInstanceGroupManagerRequest extends \Google\Protobuf\Internal\Message { /** - * The name of the managed instance group. It should conform to RFC1035. + * The name of the managed instance group. + * It should conform to RFC1035. * * Generated from protobuf field string instance_group_manager = 249363395 [(.google.api.field_behavior) = REQUIRED]; */ @@ -34,13 +35,25 @@ class UpdatePerInstanceConfigsInstanceGroupManagerRequest extends \Google\Protob */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ protected $request_id = null; /** - * The name of the zone where the managed instance group is located. It should conform to RFC1035. + * The name of thezone + * where the managed instance group is located. + * It should conform to RFC1035. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; */ @@ -48,8 +61,11 @@ class UpdatePerInstanceConfigsInstanceGroupManagerRequest extends \Google\Protob /** * @param string $project Project ID for this request. - * @param string $zone The name of the zone where the managed instance group is located. It should conform to RFC1035. - * @param string $instanceGroupManager The name of the managed instance group. It should conform to RFC1035. + * @param string $zone The name of thezone + * where the managed instance group is located. + * It should conform to RFC1035. + * @param string $instanceGroupManager The name of the managed instance group. + * It should conform to RFC1035. * @param \Google\Cloud\Compute\V1\InstanceGroupManagersUpdatePerInstanceConfigsReq $instanceGroupManagersUpdatePerInstanceConfigsReqResource The body resource for this request * * @return \Google\Cloud\Compute\V1\UpdatePerInstanceConfigsInstanceGroupManagerRequest @@ -72,15 +88,28 @@ public static function build(string $project, string $zone, string $instanceGrou * Optional. Data for populating the Message object. * * @type string $instance_group_manager - * The name of the managed instance group. It should conform to RFC1035. + * The name of the managed instance group. + * It should conform to RFC1035. * @type \Google\Cloud\Compute\V1\InstanceGroupManagersUpdatePerInstanceConfigsReq $instance_group_managers_update_per_instance_configs_req_resource * The body resource for this request * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $zone - * The name of the zone where the managed instance group is located. It should conform to RFC1035. + * The name of thezone + * where the managed instance group is located. + * It should conform to RFC1035. * } */ public function __construct($data = NULL) { @@ -89,7 +118,8 @@ public function __construct($data = NULL) { } /** - * The name of the managed instance group. It should conform to RFC1035. + * The name of the managed instance group. + * It should conform to RFC1035. * * Generated from protobuf field string instance_group_manager = 249363395 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -100,7 +130,8 @@ public function getInstanceGroupManager() } /** - * The name of the managed instance group. It should conform to RFC1035. + * The name of the managed instance group. + * It should conform to RFC1035. * * Generated from protobuf field string instance_group_manager = 249363395 [(.google.api.field_behavior) = REQUIRED]; * @param string $var @@ -177,7 +208,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -198,7 +239,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var @@ -213,7 +264,9 @@ public function setRequestId($var) } /** - * The name of the zone where the managed instance group is located. It should conform to RFC1035. + * The name of thezone + * where the managed instance group is located. + * It should conform to RFC1035. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; * @return string @@ -224,7 +277,9 @@ public function getZone() } /** - * The name of the zone where the managed instance group is located. It should conform to RFC1035. + * The name of thezone + * where the managed instance group is located. + * It should conform to RFC1035. * * Generated from protobuf field string zone = 3744684 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "zone"]; * @param string $var diff --git a/Compute/src/V1/UpdatePerInstanceConfigsRegionInstanceGroupManagerRequest.php b/Compute/src/V1/UpdatePerInstanceConfigsRegionInstanceGroupManagerRequest.php index eaf2d9607f06..1d24e57314cb 100644 --- a/Compute/src/V1/UpdatePerInstanceConfigsRegionInstanceGroupManagerRequest.php +++ b/Compute/src/V1/UpdatePerInstanceConfigsRegionInstanceGroupManagerRequest.php @@ -16,7 +16,8 @@ class UpdatePerInstanceConfigsRegionInstanceGroupManagerRequest extends \Google\Protobuf\Internal\Message { /** - * The name of the managed instance group. It should conform to RFC1035. + * The name of the managed instance group. + * It should conform to RFC1035. * * Generated from protobuf field string instance_group_manager = 249363395 [(.google.api.field_behavior) = REQUIRED]; */ @@ -40,7 +41,17 @@ class UpdatePerInstanceConfigsRegionInstanceGroupManagerRequest extends \Google\ */ protected $region_instance_group_manager_update_instance_config_req_resource = null; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -49,7 +60,8 @@ class UpdatePerInstanceConfigsRegionInstanceGroupManagerRequest extends \Google\ /** * @param string $project Project ID for this request. * @param string $region Name of the region scoping this request, should conform to RFC1035. - * @param string $instanceGroupManager The name of the managed instance group. It should conform to RFC1035. + * @param string $instanceGroupManager The name of the managed instance group. + * It should conform to RFC1035. * @param \Google\Cloud\Compute\V1\RegionInstanceGroupManagerUpdateInstanceConfigReq $regionInstanceGroupManagerUpdateInstanceConfigReqResource The body resource for this request * * @return \Google\Cloud\Compute\V1\UpdatePerInstanceConfigsRegionInstanceGroupManagerRequest @@ -72,7 +84,8 @@ public static function build(string $project, string $region, string $instanceGr * Optional. Data for populating the Message object. * * @type string $instance_group_manager - * The name of the managed instance group. It should conform to RFC1035. + * The name of the managed instance group. + * It should conform to RFC1035. * @type string $project * Project ID for this request. * @type string $region @@ -80,7 +93,17 @@ public static function build(string $project, string $region, string $instanceGr * @type \Google\Cloud\Compute\V1\RegionInstanceGroupManagerUpdateInstanceConfigReq $region_instance_group_manager_update_instance_config_req_resource * The body resource for this request * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -89,7 +112,8 @@ public function __construct($data = NULL) { } /** - * The name of the managed instance group. It should conform to RFC1035. + * The name of the managed instance group. + * It should conform to RFC1035. * * Generated from protobuf field string instance_group_manager = 249363395 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -100,7 +124,8 @@ public function getInstanceGroupManager() } /** - * The name of the managed instance group. It should conform to RFC1035. + * The name of the managed instance group. + * It should conform to RFC1035. * * Generated from protobuf field string instance_group_manager = 249363395 [(.google.api.field_behavior) = REQUIRED]; * @param string $var @@ -203,7 +228,17 @@ public function setRegionInstanceGroupManagerUpdateInstanceConfigReqResource($va } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -224,7 +259,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/UpdatePreviewFeatureRequest.php b/Compute/src/V1/UpdatePreviewFeatureRequest.php index da2996d6e3aa..4deacc9ba716 100644 --- a/Compute/src/V1/UpdatePreviewFeatureRequest.php +++ b/Compute/src/V1/UpdatePreviewFeatureRequest.php @@ -34,7 +34,17 @@ class UpdatePreviewFeatureRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -70,7 +80,17 @@ public static function build(string $project, string $previewFeature, \Google\Cl * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -167,7 +187,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -188,7 +218,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/UpdateRegionAutoscalerRequest.php b/Compute/src/V1/UpdateRegionAutoscalerRequest.php index a63ada6268f7..d19fb264f5b5 100644 --- a/Compute/src/V1/UpdateRegionAutoscalerRequest.php +++ b/Compute/src/V1/UpdateRegionAutoscalerRequest.php @@ -40,7 +40,17 @@ class UpdateRegionAutoscalerRequest extends \Google\Protobuf\Internal\Message */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -78,7 +88,17 @@ public static function build(string $project, string $region, \Google\Cloud\Comp * @type string $region * Name of the region scoping this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -211,7 +231,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -232,7 +262,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/UpdateRegionBackendServiceRequest.php b/Compute/src/V1/UpdateRegionBackendServiceRequest.php index e413b486a975..7afb27d2b1f2 100644 --- a/Compute/src/V1/UpdateRegionBackendServiceRequest.php +++ b/Compute/src/V1/UpdateRegionBackendServiceRequest.php @@ -40,7 +40,17 @@ class UpdateRegionBackendServiceRequest extends \Google\Protobuf\Internal\Messag */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -80,7 +90,17 @@ public static function build(string $project, string $region, string $backendSer * @type string $region * Name of the region scoping this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -203,7 +223,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -224,7 +254,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/UpdateRegionCommitmentRequest.php b/Compute/src/V1/UpdateRegionCommitmentRequest.php index 9c7e6de62603..37d574664d87 100644 --- a/Compute/src/V1/UpdateRegionCommitmentRequest.php +++ b/Compute/src/V1/UpdateRegionCommitmentRequest.php @@ -44,7 +44,17 @@ class UpdateRegionCommitmentRequest extends \Google\Protobuf\Internal\Message */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -91,7 +101,17 @@ public static function build(string $project, string $region, string $commitment * @type string $region * Name of the region for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $update_mask * update_mask indicates fields to be updated as part of this request. * } @@ -248,7 +268,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -269,7 +299,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/UpdateRegionDiskRequest.php b/Compute/src/V1/UpdateRegionDiskRequest.php index 4a4267737b3e..929e823ad085 100644 --- a/Compute/src/V1/UpdateRegionDiskRequest.php +++ b/Compute/src/V1/UpdateRegionDiskRequest.php @@ -44,7 +44,17 @@ class UpdateRegionDiskRequest extends \Google\Protobuf\Internal\Message */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -91,7 +101,17 @@ public static function build(string $project, string $region, string $disk, \Goo * @type string $region * The name of the region for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $update_mask * update_mask indicates fields to be updated as part of this request. * } @@ -248,7 +268,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -269,7 +299,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/UpdateRegionHealthCheckRequest.php b/Compute/src/V1/UpdateRegionHealthCheckRequest.php index 50ff5ffec812..960837308d1b 100644 --- a/Compute/src/V1/UpdateRegionHealthCheckRequest.php +++ b/Compute/src/V1/UpdateRegionHealthCheckRequest.php @@ -40,7 +40,17 @@ class UpdateRegionHealthCheckRequest extends \Google\Protobuf\Internal\Message */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -80,7 +90,17 @@ public static function build(string $project, string $region, string $healthChec * @type string $region * Name of the region scoping this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -203,7 +223,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -224,7 +254,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/UpdateRegionUrlMapRequest.php b/Compute/src/V1/UpdateRegionUrlMapRequest.php index e367a4ce5d48..1fd9394649ff 100644 --- a/Compute/src/V1/UpdateRegionUrlMapRequest.php +++ b/Compute/src/V1/UpdateRegionUrlMapRequest.php @@ -28,7 +28,8 @@ class UpdateRegionUrlMapRequest extends \Google\Protobuf\Internal\Message */ protected $region = ''; /** - * begin_interface: MixerMutationRequestBuilder Request ID to support idempotency. + * begin_interface: MixerMutationRequestBuilder + * Request ID to support idempotency. * * Generated from protobuf field optional string request_id = 37109963; */ @@ -76,7 +77,8 @@ public static function build(string $project, string $region, string $urlMap, \G * @type string $region * Name of the region scoping this request. * @type string $request_id - * begin_interface: MixerMutationRequestBuilder Request ID to support idempotency. + * begin_interface: MixerMutationRequestBuilder + * Request ID to support idempotency. * @type string $url_map * Name of the UrlMap resource to update. * @type \Google\Cloud\Compute\V1\UrlMap $url_map_resource @@ -141,7 +143,8 @@ public function setRegion($var) } /** - * begin_interface: MixerMutationRequestBuilder Request ID to support idempotency. + * begin_interface: MixerMutationRequestBuilder + * Request ID to support idempotency. * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -162,7 +165,8 @@ public function clearRequestId() } /** - * begin_interface: MixerMutationRequestBuilder Request ID to support idempotency. + * begin_interface: MixerMutationRequestBuilder + * Request ID to support idempotency. * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/UpdateReservationRequest.php b/Compute/src/V1/UpdateReservationRequest.php index 0d606047795f..92db472411eb 100644 --- a/Compute/src/V1/UpdateReservationRequest.php +++ b/Compute/src/V1/UpdateReservationRequest.php @@ -26,7 +26,17 @@ class UpdateReservationRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -85,7 +95,17 @@ public static function build(string $project, string $zone, string $reservation, * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $reservation * Name of the reservation to update. * @type \Google\Cloud\Compute\V1\Reservation $reservation_resource @@ -160,7 +180,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -181,7 +211,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/UpdateRoutePolicyRouterRequest.php b/Compute/src/V1/UpdateRoutePolicyRouterRequest.php index e880d85d35f9..934f96ab6395 100644 --- a/Compute/src/V1/UpdateRoutePolicyRouterRequest.php +++ b/Compute/src/V1/UpdateRoutePolicyRouterRequest.php @@ -28,7 +28,17 @@ class UpdateRoutePolicyRouterRequest extends \Google\Protobuf\Internal\Message */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -76,7 +86,17 @@ public static function build(string $project, string $region, string $router, \G * @type string $region * Name of the region for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type \Google\Cloud\Compute\V1\RoutePolicy $route_policy_resource * The body resource for this request * @type string $router @@ -141,7 +161,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -162,7 +192,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/UpdateRouterRequest.php b/Compute/src/V1/UpdateRouterRequest.php index 2675e01fc44a..41e3b71dd3df 100644 --- a/Compute/src/V1/UpdateRouterRequest.php +++ b/Compute/src/V1/UpdateRouterRequest.php @@ -28,7 +28,17 @@ class UpdateRouterRequest extends \Google\Protobuf\Internal\Message */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -76,7 +86,17 @@ public static function build(string $project, string $region, string $router, \G * @type string $region * Name of the region for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $router * Name of the Router resource to update. * @type \Google\Cloud\Compute\V1\Router $router_resource @@ -141,7 +161,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -162,7 +192,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/UpdateShieldedInstanceConfigInstanceRequest.php b/Compute/src/V1/UpdateShieldedInstanceConfigInstanceRequest.php index 40b38a738d44..80312cbbf25d 100644 --- a/Compute/src/V1/UpdateShieldedInstanceConfigInstanceRequest.php +++ b/Compute/src/V1/UpdateShieldedInstanceConfigInstanceRequest.php @@ -28,7 +28,17 @@ class UpdateShieldedInstanceConfigInstanceRequest extends \Google\Protobuf\Inter */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -76,7 +86,17 @@ public static function build(string $project, string $zone, string $instance, \G * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type \Google\Cloud\Compute\V1\ShieldedInstanceConfig $shielded_instance_config_resource * The body resource for this request * @type string $zone @@ -141,7 +161,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -162,7 +192,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/UpdateStoragePoolRequest.php b/Compute/src/V1/UpdateStoragePoolRequest.php index 344bfb7966f7..69d7c4256e41 100644 --- a/Compute/src/V1/UpdateStoragePoolRequest.php +++ b/Compute/src/V1/UpdateStoragePoolRequest.php @@ -22,7 +22,17 @@ class UpdateStoragePoolRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -80,7 +90,17 @@ public static function build(string $project, string $zone, string $storagePool, * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $storage_pool * The storagePool name for this request. * @type \Google\Cloud\Compute\V1\StoragePool $storage_pool_resource @@ -123,7 +143,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -144,7 +174,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/UpdateUrlMapRequest.php b/Compute/src/V1/UpdateUrlMapRequest.php index 3ad6e740758f..0014f9c1a60b 100644 --- a/Compute/src/V1/UpdateUrlMapRequest.php +++ b/Compute/src/V1/UpdateUrlMapRequest.php @@ -22,7 +22,17 @@ class UpdateUrlMapRequest extends \Google\Protobuf\Internal\Message */ protected $project = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -66,7 +76,17 @@ public static function build(string $project, string $urlMap, \Google\Cloud\Comp * @type string $project * Project ID for this request. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * @type string $url_map * Name of the UrlMap resource to update. * @type \Google\Cloud\Compute\V1\UrlMap $url_map_resource @@ -105,7 +125,17 @@ public function setProject($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -126,7 +156,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/UrlMap.php b/Compute/src/V1/UrlMap.php index b2e808b07a12..fe1a49b33d64 100644 --- a/Compute/src/V1/UrlMap.php +++ b/Compute/src/V1/UrlMap.php @@ -9,56 +9,139 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Represents a URL Map resource. Compute Engine has two URL Map resources: * [Global](/compute/docs/reference/rest/v1/urlMaps) * [Regional](/compute/docs/reference/rest/v1/regionUrlMaps) A URL map resource is a component of certain types of cloud load balancers and Traffic Director: * urlMaps are used by global external Application Load Balancers, classic Application Load Balancers, and cross-region internal Application Load Balancers. * regionUrlMaps are used by internal Application Load Balancers, regional external Application Load Balancers and regional internal Application Load Balancers. For a list of supported URL map features by the load balancer type, see the Load balancing features: Routing and traffic management table. For a list of supported URL map features for Traffic Director, see the Traffic Director features: Routing and traffic management table. This resource defines mappings from hostnames and URL paths to either a backend service or a backend bucket. To use the global urlMaps resource, the backend service must have a loadBalancingScheme of either EXTERNAL, EXTERNAL_MANAGED, or INTERNAL_SELF_MANAGED. To use the regionUrlMaps resource, the backend service must have a loadBalancingScheme of INTERNAL_MANAGED. For more information, read URL Map Concepts. + * Represents a URL Map resource. + * Compute Engine has two URL Map resources: + * * [Global](/compute/docs/reference/rest/v1/urlMaps) + * * [Regional](/compute/docs/reference/rest/v1/regionUrlMaps) + * A URL map resource is a component of certain types of cloud load balancers + * and Traffic Director: + * * urlMaps are used by global external Application Load + * Balancers, classic Application Load Balancers, and cross-region internal + * Application Load Balancers. + * * regionUrlMaps are used by internal Application Load Balancers, + * regional external Application Load Balancers and regional internal + * Application Load Balancers. + * For a list of supported URL map features by the load balancer type, see the + * Load balancing features: Routing and traffic management table. + * For a list of supported URL map features for Traffic Director, see the + * Traffic Director features: Routing and traffic management table. + * This resource defines mappings from hostnames and URL paths to either a + * backend service or a backend bucket. + * To use the global urlMaps resource, the backend service must + * have a loadBalancingScheme of either EXTERNAL,EXTERNAL_MANAGED, or INTERNAL_SELF_MANAGED. To use + * the regionUrlMaps resource, the backend service must have aloadBalancingScheme of INTERNAL_MANAGED. For more + * information, read URL + * Map Concepts. * * Generated from protobuf message google.cloud.compute.v1.UrlMap */ class UrlMap extends \Google\Protobuf\Internal\Message { /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; */ protected $creation_timestamp = null; /** - * defaultCustomErrorResponsePolicy specifies how the Load Balancer returns error responses when BackendServiceor BackendBucket responds with an error. This policy takes effect at the load balancer level and applies only when no policy has been defined for the error code at lower levels like PathMatcher, RouteRule and PathRule within this UrlMap. For example, consider a UrlMap with the following configuration: - defaultCustomErrorResponsePolicy containing policies for responding to 5xx and 4xx errors - A PathMatcher configured for *.example.com has defaultCustomErrorResponsePolicy for 4xx. If a request for http://www.example.com/ encounters a 404, the policy in pathMatcher.defaultCustomErrorResponsePolicy will be enforced. When the request for http://www.example.com/ encounters a 502, the policy in UrlMap.defaultCustomErrorResponsePolicy will be enforced. When a request that does not match any host in *.example.com such as http://www.myotherexample.com/, encounters a 404, UrlMap.defaultCustomErrorResponsePolicy takes effect. When used in conjunction with defaultRouteAction.retryPolicy, retries take precedence. Only once all retries are exhausted, the defaultCustomErrorResponsePolicy is applied. While attempting a retry, if load balancer is successful in reaching the service, the defaultCustomErrorResponsePolicy is ignored and the response from the service is returned to the client. defaultCustomErrorResponsePolicy is supported only for global external Application Load Balancers. + * defaultCustomErrorResponsePolicy specifies how the Load + * Balancer returns error responses when BackendServiceorBackendBucket responds with an error. + * This policy takes + * effect at the load balancer level and applies only when no policy has been + * defined for the error code at lower levels like PathMatcher, RouteRule and + * PathRule within this UrlMap. + * For example, consider a UrlMap with the + * following configuration: + * - defaultCustomErrorResponsePolicy containing policies for + * responding to 5xx and 4xx errors + * - A PathMatcher configured for *.example.com has + * defaultCustomErrorResponsePolicy for 4xx. + * If a request for http://www.example.com/ encounters a404, the policy inpathMatcher.defaultCustomErrorResponsePolicy will be enforced. + * When the request for http://www.example.com/ encounters a502, the policy inUrlMap.defaultCustomErrorResponsePolicy will be enforced. When + * a request that does not match any host in *.example.com such + * as http://www.myotherexample.com/, encounters a404, UrlMap.defaultCustomErrorResponsePolicy + * takes effect. + * When used in conjunction withdefaultRouteAction.retryPolicy, retries take precedence. Only + * once all retries are exhausted, thedefaultCustomErrorResponsePolicy is applied. While attempting + * a retry, if load balancer is successful in reaching the + * service, the defaultCustomErrorResponsePolicy is ignored and + * the response from the service is returned to the client. + * defaultCustomErrorResponsePolicy is supported only for + * global external Application Load Balancers. * * Generated from protobuf field optional .google.cloud.compute.v1.CustomErrorResponsePolicy default_custom_error_response_policy = 81266089; */ protected $default_custom_error_response_policy = null; /** - * defaultRouteAction takes effect when none of the hostRules match. The load balancer performs advanced routing actions, such as URL rewrites and header transformations, before forwarding the request to the selected backend. Only one of defaultUrlRedirect, defaultService or defaultRouteAction.weightedBackendService can be set. URL maps for classic Application Load Balancers only support the urlRewrite action within defaultRouteAction. defaultRouteAction has no effect when the URL map is bound to a target gRPC proxy that has the validateForProxyless field set to true. + * defaultRouteAction takes effect when none of the + * hostRules match. The load balancer performs advanced routing + * actions, such as URL rewrites and header transformations, before forwarding + * the request to the selected backend. + * Only one of defaultUrlRedirect, defaultService + * or defaultRouteAction.weightedBackendService can be set. + * URL maps for classic Application Load Balancers only support + * the urlRewrite action within defaultRouteAction. + * defaultRouteAction has no effect when the URL map is bound + * to a target gRPC proxy that has the validateForProxyless field + * set to true. * * Generated from protobuf field optional .google.cloud.compute.v1.HttpRouteAction default_route_action = 378919466; */ protected $default_route_action = null; /** - * The full or partial URL of the defaultService resource to which traffic is directed if none of the hostRules match. If defaultRouteAction is also specified, advanced routing actions, such as URL rewrites, take effect before sending the request to the backend. Only one of defaultUrlRedirect, defaultService or defaultRouteAction.weightedBackendService can be set. defaultService has no effect when the URL map is bound to a target gRPC proxy that has the validateForProxyless field set to true. + * The full or partial URL of the defaultService resource to + * which traffic is directed if none of the hostRules match. + * If defaultRouteAction is also specified, advanced + * routing actions, such as URL rewrites, take effect before sending the + * request to the backend. + * Only one of defaultUrlRedirect, defaultService + * or defaultRouteAction.weightedBackendService can be set. + * defaultService has no effect when the URL map is bound + * to a target gRPC proxy that has the validateForProxyless field + * set to true. * * Generated from protobuf field optional string default_service = 370242231; */ protected $default_service = null; /** - * When none of the specified hostRules match, the request is redirected to a URL specified by defaultUrlRedirect. Only one of defaultUrlRedirect, defaultService or defaultRouteAction.weightedBackendService can be set. Not supported when the URL map is bound to a target gRPC proxy. + * When none of the specified hostRules match, the request + * is redirected to a URL specified by defaultUrlRedirect. + * Only one of defaultUrlRedirect, defaultService + * or defaultRouteAction.weightedBackendService can be set. + * Not supported when the URL map is bound to a target gRPC proxy. * * Generated from protobuf field optional .google.cloud.compute.v1.HttpRedirectAction default_url_redirect = 359503338; */ protected $default_url_redirect = null; /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; */ protected $description = null; /** - * Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking. This field is ignored when inserting a UrlMap. An up-to-date fingerprint must be provided in order to update the UrlMap, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a UrlMap. + * Fingerprint of this resource. A hash of the contents stored in this object. + * This field is used in optimistic locking. This field is ignored when + * inserting a UrlMap. An up-to-date fingerprint must be provided + * in order to update the UrlMap, otherwise the request will + * fail with error 412 conditionNotMet. + * To see the latest fingerprint, make a get() request to + * retrieve a UrlMap. * * Generated from protobuf field optional string fingerprint = 234678500; */ protected $fingerprint = null; /** - * Specifies changes to request and response headers that need to take effect for the selected backendService. The headerAction specified here take effect after headerAction specified under pathMatcher. headerAction is not supported for load balancers that have their loadBalancingScheme set to EXTERNAL. Not supported when the URL map is bound to a target gRPC proxy that has validateForProxyless field set to true. + * Specifies changes to request and response headers that need to take effect + * for the selected backendService. + * The headerAction specified here take effect afterheaderAction specified under pathMatcher. + * headerAction is not supported for load balancers + * that have + * their loadBalancingScheme set to EXTERNAL. + * Not supported when the URL map is bound to a target gRPC proxy that + * has validateForProxyless field set to true. * * Generated from protobuf field optional .google.cloud.compute.v1.HttpHeaderAction header_action = 328077352; */ @@ -70,19 +153,27 @@ class UrlMap extends \Google\Protobuf\Internal\Message */ private $host_rules; /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; */ protected $id = null; /** - * [Output Only] Type of the resource. Always compute#urlMaps for url maps. + * [Output Only] Type of the resource. Always compute#urlMaps for + * url maps. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * * Generated from protobuf field optional string name = 3373707; */ @@ -94,7 +185,10 @@ class UrlMap extends \Google\Protobuf\Internal\Message */ private $path_matchers; /** - * [Output Only] URL of the region where the regional URL map resides. This field is not applicable to global URL maps. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * [Output Only] URL of the region where the regional URL map resides. + * This field is not applicable to global URL maps. + * You must specify this field as part of the HTTP request URL. It is + * not settable as a field in the request body. * * Generated from protobuf field optional string region = 138946292; */ @@ -106,7 +200,10 @@ class UrlMap extends \Google\Protobuf\Internal\Message */ protected $self_link = null; /** - * The list of expected URL mapping tests. Request to update the UrlMap succeeds only if all test cases pass. You can specify a maximum of 100 tests per UrlMap. Not supported when the URL map is bound to a target gRPC proxy that has validateForProxyless field set to true. + * The list of expected URL mapping tests. Request to update theUrlMap succeeds only if all test cases pass. You can specify a + * maximum of 100 tests per UrlMap. + * Not supported when the URL map is bound to a target gRPC proxy that + * has validateForProxyless field set to true. * * Generated from protobuf field repeated .google.cloud.compute.v1.UrlMapTest tests = 110251553; */ @@ -119,37 +216,112 @@ class UrlMap extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $creation_timestamp - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * @type \Google\Cloud\Compute\V1\CustomErrorResponsePolicy $default_custom_error_response_policy - * defaultCustomErrorResponsePolicy specifies how the Load Balancer returns error responses when BackendServiceor BackendBucket responds with an error. This policy takes effect at the load balancer level and applies only when no policy has been defined for the error code at lower levels like PathMatcher, RouteRule and PathRule within this UrlMap. For example, consider a UrlMap with the following configuration: - defaultCustomErrorResponsePolicy containing policies for responding to 5xx and 4xx errors - A PathMatcher configured for *.example.com has defaultCustomErrorResponsePolicy for 4xx. If a request for http://www.example.com/ encounters a 404, the policy in pathMatcher.defaultCustomErrorResponsePolicy will be enforced. When the request for http://www.example.com/ encounters a 502, the policy in UrlMap.defaultCustomErrorResponsePolicy will be enforced. When a request that does not match any host in *.example.com such as http://www.myotherexample.com/, encounters a 404, UrlMap.defaultCustomErrorResponsePolicy takes effect. When used in conjunction with defaultRouteAction.retryPolicy, retries take precedence. Only once all retries are exhausted, the defaultCustomErrorResponsePolicy is applied. While attempting a retry, if load balancer is successful in reaching the service, the defaultCustomErrorResponsePolicy is ignored and the response from the service is returned to the client. defaultCustomErrorResponsePolicy is supported only for global external Application Load Balancers. + * defaultCustomErrorResponsePolicy specifies how the Load + * Balancer returns error responses when BackendServiceorBackendBucket responds with an error. + * This policy takes + * effect at the load balancer level and applies only when no policy has been + * defined for the error code at lower levels like PathMatcher, RouteRule and + * PathRule within this UrlMap. + * For example, consider a UrlMap with the + * following configuration: + * - defaultCustomErrorResponsePolicy containing policies for + * responding to 5xx and 4xx errors + * - A PathMatcher configured for *.example.com has + * defaultCustomErrorResponsePolicy for 4xx. + * If a request for http://www.example.com/ encounters a404, the policy inpathMatcher.defaultCustomErrorResponsePolicy will be enforced. + * When the request for http://www.example.com/ encounters a502, the policy inUrlMap.defaultCustomErrorResponsePolicy will be enforced. When + * a request that does not match any host in *.example.com such + * as http://www.myotherexample.com/, encounters a404, UrlMap.defaultCustomErrorResponsePolicy + * takes effect. + * When used in conjunction withdefaultRouteAction.retryPolicy, retries take precedence. Only + * once all retries are exhausted, thedefaultCustomErrorResponsePolicy is applied. While attempting + * a retry, if load balancer is successful in reaching the + * service, the defaultCustomErrorResponsePolicy is ignored and + * the response from the service is returned to the client. + * defaultCustomErrorResponsePolicy is supported only for + * global external Application Load Balancers. * @type \Google\Cloud\Compute\V1\HttpRouteAction $default_route_action - * defaultRouteAction takes effect when none of the hostRules match. The load balancer performs advanced routing actions, such as URL rewrites and header transformations, before forwarding the request to the selected backend. Only one of defaultUrlRedirect, defaultService or defaultRouteAction.weightedBackendService can be set. URL maps for classic Application Load Balancers only support the urlRewrite action within defaultRouteAction. defaultRouteAction has no effect when the URL map is bound to a target gRPC proxy that has the validateForProxyless field set to true. + * defaultRouteAction takes effect when none of the + * hostRules match. The load balancer performs advanced routing + * actions, such as URL rewrites and header transformations, before forwarding + * the request to the selected backend. + * Only one of defaultUrlRedirect, defaultService + * or defaultRouteAction.weightedBackendService can be set. + * URL maps for classic Application Load Balancers only support + * the urlRewrite action within defaultRouteAction. + * defaultRouteAction has no effect when the URL map is bound + * to a target gRPC proxy that has the validateForProxyless field + * set to true. * @type string $default_service - * The full or partial URL of the defaultService resource to which traffic is directed if none of the hostRules match. If defaultRouteAction is also specified, advanced routing actions, such as URL rewrites, take effect before sending the request to the backend. Only one of defaultUrlRedirect, defaultService or defaultRouteAction.weightedBackendService can be set. defaultService has no effect when the URL map is bound to a target gRPC proxy that has the validateForProxyless field set to true. + * The full or partial URL of the defaultService resource to + * which traffic is directed if none of the hostRules match. + * If defaultRouteAction is also specified, advanced + * routing actions, such as URL rewrites, take effect before sending the + * request to the backend. + * Only one of defaultUrlRedirect, defaultService + * or defaultRouteAction.weightedBackendService can be set. + * defaultService has no effect when the URL map is bound + * to a target gRPC proxy that has the validateForProxyless field + * set to true. * @type \Google\Cloud\Compute\V1\HttpRedirectAction $default_url_redirect - * When none of the specified hostRules match, the request is redirected to a URL specified by defaultUrlRedirect. Only one of defaultUrlRedirect, defaultService or defaultRouteAction.weightedBackendService can be set. Not supported when the URL map is bound to a target gRPC proxy. + * When none of the specified hostRules match, the request + * is redirected to a URL specified by defaultUrlRedirect. + * Only one of defaultUrlRedirect, defaultService + * or defaultRouteAction.weightedBackendService can be set. + * Not supported when the URL map is bound to a target gRPC proxy. * @type string $description - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * @type string $fingerprint - * Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking. This field is ignored when inserting a UrlMap. An up-to-date fingerprint must be provided in order to update the UrlMap, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a UrlMap. + * Fingerprint of this resource. A hash of the contents stored in this object. + * This field is used in optimistic locking. This field is ignored when + * inserting a UrlMap. An up-to-date fingerprint must be provided + * in order to update the UrlMap, otherwise the request will + * fail with error 412 conditionNotMet. + * To see the latest fingerprint, make a get() request to + * retrieve a UrlMap. * @type \Google\Cloud\Compute\V1\HttpHeaderAction $header_action - * Specifies changes to request and response headers that need to take effect for the selected backendService. The headerAction specified here take effect after headerAction specified under pathMatcher. headerAction is not supported for load balancers that have their loadBalancingScheme set to EXTERNAL. Not supported when the URL map is bound to a target gRPC proxy that has validateForProxyless field set to true. + * Specifies changes to request and response headers that need to take effect + * for the selected backendService. + * The headerAction specified here take effect afterheaderAction specified under pathMatcher. + * headerAction is not supported for load balancers + * that have + * their loadBalancingScheme set to EXTERNAL. + * Not supported when the URL map is bound to a target gRPC proxy that + * has validateForProxyless field set to true. * @type array<\Google\Cloud\Compute\V1\HostRule>|\Google\Protobuf\Internal\RepeatedField $host_rules * The list of host rules to use against the URL. * @type int|string $id - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * @type string $kind - * [Output Only] Type of the resource. Always compute#urlMaps for url maps. + * [Output Only] Type of the resource. Always compute#urlMaps for + * url maps. * @type string $name - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * @type array<\Google\Cloud\Compute\V1\PathMatcher>|\Google\Protobuf\Internal\RepeatedField $path_matchers * The list of named PathMatchers to use against the URL. * @type string $region - * [Output Only] URL of the region where the regional URL map resides. This field is not applicable to global URL maps. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * [Output Only] URL of the region where the regional URL map resides. + * This field is not applicable to global URL maps. + * You must specify this field as part of the HTTP request URL. It is + * not settable as a field in the request body. * @type string $self_link * [Output Only] Server-defined URL for the resource. * @type array<\Google\Cloud\Compute\V1\UrlMapTest>|\Google\Protobuf\Internal\RepeatedField $tests - * The list of expected URL mapping tests. Request to update the UrlMap succeeds only if all test cases pass. You can specify a maximum of 100 tests per UrlMap. Not supported when the URL map is bound to a target gRPC proxy that has validateForProxyless field set to true. + * The list of expected URL mapping tests. Request to update theUrlMap succeeds only if all test cases pass. You can specify a + * maximum of 100 tests per UrlMap. + * Not supported when the URL map is bound to a target gRPC proxy that + * has validateForProxyless field set to true. * } */ public function __construct($data = NULL) { @@ -158,7 +330,8 @@ public function __construct($data = NULL) { } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @return string @@ -179,7 +352,8 @@ public function clearCreationTimestamp() } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @param string $var @@ -194,7 +368,30 @@ public function setCreationTimestamp($var) } /** - * defaultCustomErrorResponsePolicy specifies how the Load Balancer returns error responses when BackendServiceor BackendBucket responds with an error. This policy takes effect at the load balancer level and applies only when no policy has been defined for the error code at lower levels like PathMatcher, RouteRule and PathRule within this UrlMap. For example, consider a UrlMap with the following configuration: - defaultCustomErrorResponsePolicy containing policies for responding to 5xx and 4xx errors - A PathMatcher configured for *.example.com has defaultCustomErrorResponsePolicy for 4xx. If a request for http://www.example.com/ encounters a 404, the policy in pathMatcher.defaultCustomErrorResponsePolicy will be enforced. When the request for http://www.example.com/ encounters a 502, the policy in UrlMap.defaultCustomErrorResponsePolicy will be enforced. When a request that does not match any host in *.example.com such as http://www.myotherexample.com/, encounters a 404, UrlMap.defaultCustomErrorResponsePolicy takes effect. When used in conjunction with defaultRouteAction.retryPolicy, retries take precedence. Only once all retries are exhausted, the defaultCustomErrorResponsePolicy is applied. While attempting a retry, if load balancer is successful in reaching the service, the defaultCustomErrorResponsePolicy is ignored and the response from the service is returned to the client. defaultCustomErrorResponsePolicy is supported only for global external Application Load Balancers. + * defaultCustomErrorResponsePolicy specifies how the Load + * Balancer returns error responses when BackendServiceorBackendBucket responds with an error. + * This policy takes + * effect at the load balancer level and applies only when no policy has been + * defined for the error code at lower levels like PathMatcher, RouteRule and + * PathRule within this UrlMap. + * For example, consider a UrlMap with the + * following configuration: + * - defaultCustomErrorResponsePolicy containing policies for + * responding to 5xx and 4xx errors + * - A PathMatcher configured for *.example.com has + * defaultCustomErrorResponsePolicy for 4xx. + * If a request for http://www.example.com/ encounters a404, the policy inpathMatcher.defaultCustomErrorResponsePolicy will be enforced. + * When the request for http://www.example.com/ encounters a502, the policy inUrlMap.defaultCustomErrorResponsePolicy will be enforced. When + * a request that does not match any host in *.example.com such + * as http://www.myotherexample.com/, encounters a404, UrlMap.defaultCustomErrorResponsePolicy + * takes effect. + * When used in conjunction withdefaultRouteAction.retryPolicy, retries take precedence. Only + * once all retries are exhausted, thedefaultCustomErrorResponsePolicy is applied. While attempting + * a retry, if load balancer is successful in reaching the + * service, the defaultCustomErrorResponsePolicy is ignored and + * the response from the service is returned to the client. + * defaultCustomErrorResponsePolicy is supported only for + * global external Application Load Balancers. * * Generated from protobuf field optional .google.cloud.compute.v1.CustomErrorResponsePolicy default_custom_error_response_policy = 81266089; * @return \Google\Cloud\Compute\V1\CustomErrorResponsePolicy|null @@ -215,7 +412,30 @@ public function clearDefaultCustomErrorResponsePolicy() } /** - * defaultCustomErrorResponsePolicy specifies how the Load Balancer returns error responses when BackendServiceor BackendBucket responds with an error. This policy takes effect at the load balancer level and applies only when no policy has been defined for the error code at lower levels like PathMatcher, RouteRule and PathRule within this UrlMap. For example, consider a UrlMap with the following configuration: - defaultCustomErrorResponsePolicy containing policies for responding to 5xx and 4xx errors - A PathMatcher configured for *.example.com has defaultCustomErrorResponsePolicy for 4xx. If a request for http://www.example.com/ encounters a 404, the policy in pathMatcher.defaultCustomErrorResponsePolicy will be enforced. When the request for http://www.example.com/ encounters a 502, the policy in UrlMap.defaultCustomErrorResponsePolicy will be enforced. When a request that does not match any host in *.example.com such as http://www.myotherexample.com/, encounters a 404, UrlMap.defaultCustomErrorResponsePolicy takes effect. When used in conjunction with defaultRouteAction.retryPolicy, retries take precedence. Only once all retries are exhausted, the defaultCustomErrorResponsePolicy is applied. While attempting a retry, if load balancer is successful in reaching the service, the defaultCustomErrorResponsePolicy is ignored and the response from the service is returned to the client. defaultCustomErrorResponsePolicy is supported only for global external Application Load Balancers. + * defaultCustomErrorResponsePolicy specifies how the Load + * Balancer returns error responses when BackendServiceorBackendBucket responds with an error. + * This policy takes + * effect at the load balancer level and applies only when no policy has been + * defined for the error code at lower levels like PathMatcher, RouteRule and + * PathRule within this UrlMap. + * For example, consider a UrlMap with the + * following configuration: + * - defaultCustomErrorResponsePolicy containing policies for + * responding to 5xx and 4xx errors + * - A PathMatcher configured for *.example.com has + * defaultCustomErrorResponsePolicy for 4xx. + * If a request for http://www.example.com/ encounters a404, the policy inpathMatcher.defaultCustomErrorResponsePolicy will be enforced. + * When the request for http://www.example.com/ encounters a502, the policy inUrlMap.defaultCustomErrorResponsePolicy will be enforced. When + * a request that does not match any host in *.example.com such + * as http://www.myotherexample.com/, encounters a404, UrlMap.defaultCustomErrorResponsePolicy + * takes effect. + * When used in conjunction withdefaultRouteAction.retryPolicy, retries take precedence. Only + * once all retries are exhausted, thedefaultCustomErrorResponsePolicy is applied. While attempting + * a retry, if load balancer is successful in reaching the + * service, the defaultCustomErrorResponsePolicy is ignored and + * the response from the service is returned to the client. + * defaultCustomErrorResponsePolicy is supported only for + * global external Application Load Balancers. * * Generated from protobuf field optional .google.cloud.compute.v1.CustomErrorResponsePolicy default_custom_error_response_policy = 81266089; * @param \Google\Cloud\Compute\V1\CustomErrorResponsePolicy $var @@ -230,7 +450,17 @@ public function setDefaultCustomErrorResponsePolicy($var) } /** - * defaultRouteAction takes effect when none of the hostRules match. The load balancer performs advanced routing actions, such as URL rewrites and header transformations, before forwarding the request to the selected backend. Only one of defaultUrlRedirect, defaultService or defaultRouteAction.weightedBackendService can be set. URL maps for classic Application Load Balancers only support the urlRewrite action within defaultRouteAction. defaultRouteAction has no effect when the URL map is bound to a target gRPC proxy that has the validateForProxyless field set to true. + * defaultRouteAction takes effect when none of the + * hostRules match. The load balancer performs advanced routing + * actions, such as URL rewrites and header transformations, before forwarding + * the request to the selected backend. + * Only one of defaultUrlRedirect, defaultService + * or defaultRouteAction.weightedBackendService can be set. + * URL maps for classic Application Load Balancers only support + * the urlRewrite action within defaultRouteAction. + * defaultRouteAction has no effect when the URL map is bound + * to a target gRPC proxy that has the validateForProxyless field + * set to true. * * Generated from protobuf field optional .google.cloud.compute.v1.HttpRouteAction default_route_action = 378919466; * @return \Google\Cloud\Compute\V1\HttpRouteAction|null @@ -251,7 +481,17 @@ public function clearDefaultRouteAction() } /** - * defaultRouteAction takes effect when none of the hostRules match. The load balancer performs advanced routing actions, such as URL rewrites and header transformations, before forwarding the request to the selected backend. Only one of defaultUrlRedirect, defaultService or defaultRouteAction.weightedBackendService can be set. URL maps for classic Application Load Balancers only support the urlRewrite action within defaultRouteAction. defaultRouteAction has no effect when the URL map is bound to a target gRPC proxy that has the validateForProxyless field set to true. + * defaultRouteAction takes effect when none of the + * hostRules match. The load balancer performs advanced routing + * actions, such as URL rewrites and header transformations, before forwarding + * the request to the selected backend. + * Only one of defaultUrlRedirect, defaultService + * or defaultRouteAction.weightedBackendService can be set. + * URL maps for classic Application Load Balancers only support + * the urlRewrite action within defaultRouteAction. + * defaultRouteAction has no effect when the URL map is bound + * to a target gRPC proxy that has the validateForProxyless field + * set to true. * * Generated from protobuf field optional .google.cloud.compute.v1.HttpRouteAction default_route_action = 378919466; * @param \Google\Cloud\Compute\V1\HttpRouteAction $var @@ -266,7 +506,16 @@ public function setDefaultRouteAction($var) } /** - * The full or partial URL of the defaultService resource to which traffic is directed if none of the hostRules match. If defaultRouteAction is also specified, advanced routing actions, such as URL rewrites, take effect before sending the request to the backend. Only one of defaultUrlRedirect, defaultService or defaultRouteAction.weightedBackendService can be set. defaultService has no effect when the URL map is bound to a target gRPC proxy that has the validateForProxyless field set to true. + * The full or partial URL of the defaultService resource to + * which traffic is directed if none of the hostRules match. + * If defaultRouteAction is also specified, advanced + * routing actions, such as URL rewrites, take effect before sending the + * request to the backend. + * Only one of defaultUrlRedirect, defaultService + * or defaultRouteAction.weightedBackendService can be set. + * defaultService has no effect when the URL map is bound + * to a target gRPC proxy that has the validateForProxyless field + * set to true. * * Generated from protobuf field optional string default_service = 370242231; * @return string @@ -287,7 +536,16 @@ public function clearDefaultService() } /** - * The full or partial URL of the defaultService resource to which traffic is directed if none of the hostRules match. If defaultRouteAction is also specified, advanced routing actions, such as URL rewrites, take effect before sending the request to the backend. Only one of defaultUrlRedirect, defaultService or defaultRouteAction.weightedBackendService can be set. defaultService has no effect when the URL map is bound to a target gRPC proxy that has the validateForProxyless field set to true. + * The full or partial URL of the defaultService resource to + * which traffic is directed if none of the hostRules match. + * If defaultRouteAction is also specified, advanced + * routing actions, such as URL rewrites, take effect before sending the + * request to the backend. + * Only one of defaultUrlRedirect, defaultService + * or defaultRouteAction.weightedBackendService can be set. + * defaultService has no effect when the URL map is bound + * to a target gRPC proxy that has the validateForProxyless field + * set to true. * * Generated from protobuf field optional string default_service = 370242231; * @param string $var @@ -302,7 +560,11 @@ public function setDefaultService($var) } /** - * When none of the specified hostRules match, the request is redirected to a URL specified by defaultUrlRedirect. Only one of defaultUrlRedirect, defaultService or defaultRouteAction.weightedBackendService can be set. Not supported when the URL map is bound to a target gRPC proxy. + * When none of the specified hostRules match, the request + * is redirected to a URL specified by defaultUrlRedirect. + * Only one of defaultUrlRedirect, defaultService + * or defaultRouteAction.weightedBackendService can be set. + * Not supported when the URL map is bound to a target gRPC proxy. * * Generated from protobuf field optional .google.cloud.compute.v1.HttpRedirectAction default_url_redirect = 359503338; * @return \Google\Cloud\Compute\V1\HttpRedirectAction|null @@ -323,7 +585,11 @@ public function clearDefaultUrlRedirect() } /** - * When none of the specified hostRules match, the request is redirected to a URL specified by defaultUrlRedirect. Only one of defaultUrlRedirect, defaultService or defaultRouteAction.weightedBackendService can be set. Not supported when the URL map is bound to a target gRPC proxy. + * When none of the specified hostRules match, the request + * is redirected to a URL specified by defaultUrlRedirect. + * Only one of defaultUrlRedirect, defaultService + * or defaultRouteAction.weightedBackendService can be set. + * Not supported when the URL map is bound to a target gRPC proxy. * * Generated from protobuf field optional .google.cloud.compute.v1.HttpRedirectAction default_url_redirect = 359503338; * @param \Google\Cloud\Compute\V1\HttpRedirectAction $var @@ -338,7 +604,8 @@ public function setDefaultUrlRedirect($var) } /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @return string @@ -359,7 +626,8 @@ public function clearDescription() } /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @param string $var @@ -374,7 +642,13 @@ public function setDescription($var) } /** - * Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking. This field is ignored when inserting a UrlMap. An up-to-date fingerprint must be provided in order to update the UrlMap, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a UrlMap. + * Fingerprint of this resource. A hash of the contents stored in this object. + * This field is used in optimistic locking. This field is ignored when + * inserting a UrlMap. An up-to-date fingerprint must be provided + * in order to update the UrlMap, otherwise the request will + * fail with error 412 conditionNotMet. + * To see the latest fingerprint, make a get() request to + * retrieve a UrlMap. * * Generated from protobuf field optional string fingerprint = 234678500; * @return string @@ -395,7 +669,13 @@ public function clearFingerprint() } /** - * Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking. This field is ignored when inserting a UrlMap. An up-to-date fingerprint must be provided in order to update the UrlMap, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a UrlMap. + * Fingerprint of this resource. A hash of the contents stored in this object. + * This field is used in optimistic locking. This field is ignored when + * inserting a UrlMap. An up-to-date fingerprint must be provided + * in order to update the UrlMap, otherwise the request will + * fail with error 412 conditionNotMet. + * To see the latest fingerprint, make a get() request to + * retrieve a UrlMap. * * Generated from protobuf field optional string fingerprint = 234678500; * @param string $var @@ -410,7 +690,14 @@ public function setFingerprint($var) } /** - * Specifies changes to request and response headers that need to take effect for the selected backendService. The headerAction specified here take effect after headerAction specified under pathMatcher. headerAction is not supported for load balancers that have their loadBalancingScheme set to EXTERNAL. Not supported when the URL map is bound to a target gRPC proxy that has validateForProxyless field set to true. + * Specifies changes to request and response headers that need to take effect + * for the selected backendService. + * The headerAction specified here take effect afterheaderAction specified under pathMatcher. + * headerAction is not supported for load balancers + * that have + * their loadBalancingScheme set to EXTERNAL. + * Not supported when the URL map is bound to a target gRPC proxy that + * has validateForProxyless field set to true. * * Generated from protobuf field optional .google.cloud.compute.v1.HttpHeaderAction header_action = 328077352; * @return \Google\Cloud\Compute\V1\HttpHeaderAction|null @@ -431,7 +718,14 @@ public function clearHeaderAction() } /** - * Specifies changes to request and response headers that need to take effect for the selected backendService. The headerAction specified here take effect after headerAction specified under pathMatcher. headerAction is not supported for load balancers that have their loadBalancingScheme set to EXTERNAL. Not supported when the URL map is bound to a target gRPC proxy that has validateForProxyless field set to true. + * Specifies changes to request and response headers that need to take effect + * for the selected backendService. + * The headerAction specified here take effect afterheaderAction specified under pathMatcher. + * headerAction is not supported for load balancers + * that have + * their loadBalancingScheme set to EXTERNAL. + * Not supported when the URL map is bound to a target gRPC proxy that + * has validateForProxyless field set to true. * * Generated from protobuf field optional .google.cloud.compute.v1.HttpHeaderAction header_action = 328077352; * @param \Google\Cloud\Compute\V1\HttpHeaderAction $var @@ -472,7 +766,8 @@ public function setHostRules($var) } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @return int|string @@ -493,7 +788,8 @@ public function clearId() } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @param int|string $var @@ -508,7 +804,8 @@ public function setId($var) } /** - * [Output Only] Type of the resource. Always compute#urlMaps for url maps. + * [Output Only] Type of the resource. Always compute#urlMaps for + * url maps. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -529,7 +826,8 @@ public function clearKind() } /** - * [Output Only] Type of the resource. Always compute#urlMaps for url maps. + * [Output Only] Type of the resource. Always compute#urlMaps for + * url maps. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -544,7 +842,13 @@ public function setKind($var) } /** - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * * Generated from protobuf field optional string name = 3373707; * @return string @@ -565,7 +869,13 @@ public function clearName() } /** - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * * Generated from protobuf field optional string name = 3373707; * @param string $var @@ -606,7 +916,10 @@ public function setPathMatchers($var) } /** - * [Output Only] URL of the region where the regional URL map resides. This field is not applicable to global URL maps. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * [Output Only] URL of the region where the regional URL map resides. + * This field is not applicable to global URL maps. + * You must specify this field as part of the HTTP request URL. It is + * not settable as a field in the request body. * * Generated from protobuf field optional string region = 138946292; * @return string @@ -627,7 +940,10 @@ public function clearRegion() } /** - * [Output Only] URL of the region where the regional URL map resides. This field is not applicable to global URL maps. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * [Output Only] URL of the region where the regional URL map resides. + * This field is not applicable to global URL maps. + * You must specify this field as part of the HTTP request URL. It is + * not settable as a field in the request body. * * Generated from protobuf field optional string region = 138946292; * @param string $var @@ -678,7 +994,10 @@ public function setSelfLink($var) } /** - * The list of expected URL mapping tests. Request to update the UrlMap succeeds only if all test cases pass. You can specify a maximum of 100 tests per UrlMap. Not supported when the URL map is bound to a target gRPC proxy that has validateForProxyless field set to true. + * The list of expected URL mapping tests. Request to update theUrlMap succeeds only if all test cases pass. You can specify a + * maximum of 100 tests per UrlMap. + * Not supported when the URL map is bound to a target gRPC proxy that + * has validateForProxyless field set to true. * * Generated from protobuf field repeated .google.cloud.compute.v1.UrlMapTest tests = 110251553; * @return \Google\Protobuf\Internal\RepeatedField @@ -689,7 +1008,10 @@ public function getTests() } /** - * The list of expected URL mapping tests. Request to update the UrlMap succeeds only if all test cases pass. You can specify a maximum of 100 tests per UrlMap. Not supported when the URL map is bound to a target gRPC proxy that has validateForProxyless field set to true. + * The list of expected URL mapping tests. Request to update theUrlMap succeeds only if all test cases pass. You can specify a + * maximum of 100 tests per UrlMap. + * Not supported when the URL map is bound to a target gRPC proxy that + * has validateForProxyless field set to true. * * Generated from protobuf field repeated .google.cloud.compute.v1.UrlMapTest tests = 110251553; * @param array<\Google\Cloud\Compute\V1\UrlMapTest>|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/UrlMapList.php b/Compute/src/V1/UrlMapList.php index d764594c42b1..4d759a19094c 100644 --- a/Compute/src/V1/UrlMapList.php +++ b/Compute/src/V1/UrlMapList.php @@ -34,7 +34,11 @@ class UrlMapList extends \Google\Protobuf\Internal\Message */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -65,7 +69,11 @@ class UrlMapList extends \Google\Protobuf\Internal\Message * @type string $kind * Type of resource. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type \Google\Cloud\Compute\V1\Warning $warning @@ -176,7 +184,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -197,7 +209,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/UrlMapTest.php b/Compute/src/V1/UrlMapTest.php index 32ea3d397393..340816173104 100644 --- a/Compute/src/V1/UrlMapTest.php +++ b/Compute/src/V1/UrlMapTest.php @@ -22,25 +22,39 @@ class UrlMapTest extends \Google\Protobuf\Internal\Message */ protected $description = null; /** - * The expected output URL evaluated by the load balancer containing the scheme, host, path and query parameters. For rules that forward requests to backends, the test passes only when expectedOutputUrl matches the request forwarded by the load balancer to backends. For rules with urlRewrite, the test verifies that the forwarded request matches hostRewrite and pathPrefixRewrite in the urlRewrite action. When service is specified, expectedOutputUrl`s scheme is ignored. For rules with urlRedirect, the test passes only if expectedOutputUrl matches the URL in the load balancer's redirect response. If urlRedirect specifies https_redirect, the test passes only if the scheme in expectedOutputUrl is also set to HTTPS. If urlRedirect specifies strip_query, the test passes only if expectedOutputUrl does not contain any query parameters. expectedOutputUrl is optional when service is specified. + * The expected output URL evaluated by the load balancer + * containing the scheme, host, path and query parameters. + * For rules that forward requests to backends, the test passes only whenexpectedOutputUrl matches the request forwarded by + * the load balancer to backends. For rules with urlRewrite, + * the test verifies that the forwarded request matcheshostRewrite and pathPrefixRewrite in theurlRewrite action. When service is specified,expectedOutputUrl`s scheme is ignored. + * For rules with urlRedirect, the test passes only ifexpectedOutputUrl matches the URL in the load balancer's + * redirect response. If urlRedirect specifieshttps_redirect, the test passes only if the scheme inexpectedOutputUrl is also set to HTTPS. + * If urlRedirect specifies strip_query, the test + * passes only if expectedOutputUrl does not contain any query + * parameters. + * expectedOutputUrl is optional whenservice is specified. * * Generated from protobuf field optional string expected_output_url = 433967384; */ protected $expected_output_url = null; /** - * For rules with urlRedirect, the test passes only if expectedRedirectResponseCode matches the HTTP status code in load balancer's redirect response. expectedRedirectResponseCode cannot be set when service is set. + * For rules with urlRedirect, the test passes only ifexpectedRedirectResponseCode matches the HTTP status code in + * load balancer's redirect response. + * expectedRedirectResponseCode cannot be set whenservice is set. * * Generated from protobuf field optional int32 expected_redirect_response_code = 18888047; */ protected $expected_redirect_response_code = null; /** - * HTTP headers for this request. If headers contains a host header, then host must also match the header value. + * HTTP headers for this request. If headers contains + * a host header, then host must also match the header value. * * Generated from protobuf field repeated .google.cloud.compute.v1.UrlMapTestHeader headers = 258436998; */ private $headers; /** - * Host portion of the URL. If headers contains a host header, then host must also match the header value. + * Host portion of the URL. If headers contains a host header, + * then host must also match the header value. * * Generated from protobuf field optional string host = 3208616; */ @@ -52,7 +66,10 @@ class UrlMapTest extends \Google\Protobuf\Internal\Message */ protected $path = null; /** - * Expected BackendService or BackendBucket resource the given URL should be mapped to. The service field cannot be set if expectedRedirectResponseCode is set. + * Expected BackendService or BackendBucket resource + * the given URL should be mapped to. + * The service field cannot + * be set if expectedRedirectResponseCode is set. * * Generated from protobuf field optional string service = 373540533; */ @@ -67,17 +84,34 @@ class UrlMapTest extends \Google\Protobuf\Internal\Message * @type string $description * Description of this test case. * @type string $expected_output_url - * The expected output URL evaluated by the load balancer containing the scheme, host, path and query parameters. For rules that forward requests to backends, the test passes only when expectedOutputUrl matches the request forwarded by the load balancer to backends. For rules with urlRewrite, the test verifies that the forwarded request matches hostRewrite and pathPrefixRewrite in the urlRewrite action. When service is specified, expectedOutputUrl`s scheme is ignored. For rules with urlRedirect, the test passes only if expectedOutputUrl matches the URL in the load balancer's redirect response. If urlRedirect specifies https_redirect, the test passes only if the scheme in expectedOutputUrl is also set to HTTPS. If urlRedirect specifies strip_query, the test passes only if expectedOutputUrl does not contain any query parameters. expectedOutputUrl is optional when service is specified. + * The expected output URL evaluated by the load balancer + * containing the scheme, host, path and query parameters. + * For rules that forward requests to backends, the test passes only whenexpectedOutputUrl matches the request forwarded by + * the load balancer to backends. For rules with urlRewrite, + * the test verifies that the forwarded request matcheshostRewrite and pathPrefixRewrite in theurlRewrite action. When service is specified,expectedOutputUrl`s scheme is ignored. + * For rules with urlRedirect, the test passes only ifexpectedOutputUrl matches the URL in the load balancer's + * redirect response. If urlRedirect specifieshttps_redirect, the test passes only if the scheme inexpectedOutputUrl is also set to HTTPS. + * If urlRedirect specifies strip_query, the test + * passes only if expectedOutputUrl does not contain any query + * parameters. + * expectedOutputUrl is optional whenservice is specified. * @type int $expected_redirect_response_code - * For rules with urlRedirect, the test passes only if expectedRedirectResponseCode matches the HTTP status code in load balancer's redirect response. expectedRedirectResponseCode cannot be set when service is set. + * For rules with urlRedirect, the test passes only ifexpectedRedirectResponseCode matches the HTTP status code in + * load balancer's redirect response. + * expectedRedirectResponseCode cannot be set whenservice is set. * @type array<\Google\Cloud\Compute\V1\UrlMapTestHeader>|\Google\Protobuf\Internal\RepeatedField $headers - * HTTP headers for this request. If headers contains a host header, then host must also match the header value. + * HTTP headers for this request. If headers contains + * a host header, then host must also match the header value. * @type string $host - * Host portion of the URL. If headers contains a host header, then host must also match the header value. + * Host portion of the URL. If headers contains a host header, + * then host must also match the header value. * @type string $path * Path portion of the URL. * @type string $service - * Expected BackendService or BackendBucket resource the given URL should be mapped to. The service field cannot be set if expectedRedirectResponseCode is set. + * Expected BackendService or BackendBucket resource + * the given URL should be mapped to. + * The service field cannot + * be set if expectedRedirectResponseCode is set. * } */ public function __construct($data = NULL) { @@ -122,7 +156,17 @@ public function setDescription($var) } /** - * The expected output URL evaluated by the load balancer containing the scheme, host, path and query parameters. For rules that forward requests to backends, the test passes only when expectedOutputUrl matches the request forwarded by the load balancer to backends. For rules with urlRewrite, the test verifies that the forwarded request matches hostRewrite and pathPrefixRewrite in the urlRewrite action. When service is specified, expectedOutputUrl`s scheme is ignored. For rules with urlRedirect, the test passes only if expectedOutputUrl matches the URL in the load balancer's redirect response. If urlRedirect specifies https_redirect, the test passes only if the scheme in expectedOutputUrl is also set to HTTPS. If urlRedirect specifies strip_query, the test passes only if expectedOutputUrl does not contain any query parameters. expectedOutputUrl is optional when service is specified. + * The expected output URL evaluated by the load balancer + * containing the scheme, host, path and query parameters. + * For rules that forward requests to backends, the test passes only whenexpectedOutputUrl matches the request forwarded by + * the load balancer to backends. For rules with urlRewrite, + * the test verifies that the forwarded request matcheshostRewrite and pathPrefixRewrite in theurlRewrite action. When service is specified,expectedOutputUrl`s scheme is ignored. + * For rules with urlRedirect, the test passes only ifexpectedOutputUrl matches the URL in the load balancer's + * redirect response. If urlRedirect specifieshttps_redirect, the test passes only if the scheme inexpectedOutputUrl is also set to HTTPS. + * If urlRedirect specifies strip_query, the test + * passes only if expectedOutputUrl does not contain any query + * parameters. + * expectedOutputUrl is optional whenservice is specified. * * Generated from protobuf field optional string expected_output_url = 433967384; * @return string @@ -143,7 +187,17 @@ public function clearExpectedOutputUrl() } /** - * The expected output URL evaluated by the load balancer containing the scheme, host, path and query parameters. For rules that forward requests to backends, the test passes only when expectedOutputUrl matches the request forwarded by the load balancer to backends. For rules with urlRewrite, the test verifies that the forwarded request matches hostRewrite and pathPrefixRewrite in the urlRewrite action. When service is specified, expectedOutputUrl`s scheme is ignored. For rules with urlRedirect, the test passes only if expectedOutputUrl matches the URL in the load balancer's redirect response. If urlRedirect specifies https_redirect, the test passes only if the scheme in expectedOutputUrl is also set to HTTPS. If urlRedirect specifies strip_query, the test passes only if expectedOutputUrl does not contain any query parameters. expectedOutputUrl is optional when service is specified. + * The expected output URL evaluated by the load balancer + * containing the scheme, host, path and query parameters. + * For rules that forward requests to backends, the test passes only whenexpectedOutputUrl matches the request forwarded by + * the load balancer to backends. For rules with urlRewrite, + * the test verifies that the forwarded request matcheshostRewrite and pathPrefixRewrite in theurlRewrite action. When service is specified,expectedOutputUrl`s scheme is ignored. + * For rules with urlRedirect, the test passes only ifexpectedOutputUrl matches the URL in the load balancer's + * redirect response. If urlRedirect specifieshttps_redirect, the test passes only if the scheme inexpectedOutputUrl is also set to HTTPS. + * If urlRedirect specifies strip_query, the test + * passes only if expectedOutputUrl does not contain any query + * parameters. + * expectedOutputUrl is optional whenservice is specified. * * Generated from protobuf field optional string expected_output_url = 433967384; * @param string $var @@ -158,7 +212,9 @@ public function setExpectedOutputUrl($var) } /** - * For rules with urlRedirect, the test passes only if expectedRedirectResponseCode matches the HTTP status code in load balancer's redirect response. expectedRedirectResponseCode cannot be set when service is set. + * For rules with urlRedirect, the test passes only ifexpectedRedirectResponseCode matches the HTTP status code in + * load balancer's redirect response. + * expectedRedirectResponseCode cannot be set whenservice is set. * * Generated from protobuf field optional int32 expected_redirect_response_code = 18888047; * @return int @@ -179,7 +235,9 @@ public function clearExpectedRedirectResponseCode() } /** - * For rules with urlRedirect, the test passes only if expectedRedirectResponseCode matches the HTTP status code in load balancer's redirect response. expectedRedirectResponseCode cannot be set when service is set. + * For rules with urlRedirect, the test passes only ifexpectedRedirectResponseCode matches the HTTP status code in + * load balancer's redirect response. + * expectedRedirectResponseCode cannot be set whenservice is set. * * Generated from protobuf field optional int32 expected_redirect_response_code = 18888047; * @param int $var @@ -194,7 +252,8 @@ public function setExpectedRedirectResponseCode($var) } /** - * HTTP headers for this request. If headers contains a host header, then host must also match the header value. + * HTTP headers for this request. If headers contains + * a host header, then host must also match the header value. * * Generated from protobuf field repeated .google.cloud.compute.v1.UrlMapTestHeader headers = 258436998; * @return \Google\Protobuf\Internal\RepeatedField @@ -205,7 +264,8 @@ public function getHeaders() } /** - * HTTP headers for this request. If headers contains a host header, then host must also match the header value. + * HTTP headers for this request. If headers contains + * a host header, then host must also match the header value. * * Generated from protobuf field repeated .google.cloud.compute.v1.UrlMapTestHeader headers = 258436998; * @param array<\Google\Cloud\Compute\V1\UrlMapTestHeader>|\Google\Protobuf\Internal\RepeatedField $var @@ -220,7 +280,8 @@ public function setHeaders($var) } /** - * Host portion of the URL. If headers contains a host header, then host must also match the header value. + * Host portion of the URL. If headers contains a host header, + * then host must also match the header value. * * Generated from protobuf field optional string host = 3208616; * @return string @@ -241,7 +302,8 @@ public function clearHost() } /** - * Host portion of the URL. If headers contains a host header, then host must also match the header value. + * Host portion of the URL. If headers contains a host header, + * then host must also match the header value. * * Generated from protobuf field optional string host = 3208616; * @param string $var @@ -292,7 +354,10 @@ public function setPath($var) } /** - * Expected BackendService or BackendBucket resource the given URL should be mapped to. The service field cannot be set if expectedRedirectResponseCode is set. + * Expected BackendService or BackendBucket resource + * the given URL should be mapped to. + * The service field cannot + * be set if expectedRedirectResponseCode is set. * * Generated from protobuf field optional string service = 373540533; * @return string @@ -313,7 +378,10 @@ public function clearService() } /** - * Expected BackendService or BackendBucket resource the given URL should be mapped to. The service field cannot be set if expectedRedirectResponseCode is set. + * Expected BackendService or BackendBucket resource + * the given URL should be mapped to. + * The service field cannot + * be set if expectedRedirectResponseCode is set. * * Generated from protobuf field optional string service = 373540533; * @param string $var diff --git a/Compute/src/V1/UrlMapValidationResult.php b/Compute/src/V1/UrlMapValidationResult.php index 4fda4934aaff..7862a05a5a80 100644 --- a/Compute/src/V1/UrlMapValidationResult.php +++ b/Compute/src/V1/UrlMapValidationResult.php @@ -20,7 +20,8 @@ class UrlMapValidationResult extends \Google\Protobuf\Internal\Message */ private $load_errors; /** - * Whether the given UrlMap can be successfully loaded. If false, 'loadErrors' indicates the reasons. + * Whether the given UrlMap can be successfully loaded. + * If false, 'loadErrors' indicates the reasons. * * Generated from protobuf field optional bool load_succeeded = 128326216; */ @@ -30,7 +31,8 @@ class UrlMapValidationResult extends \Google\Protobuf\Internal\Message */ private $test_failures; /** - * If successfully loaded, this field indicates whether the test passed. If false, 'testFailures's indicate the reason of failure. + * If successfully loaded, this field indicates whether the test passed. + * If false, 'testFailures's indicate the reason of failure. * * Generated from protobuf field optional bool test_passed = 192708797; */ @@ -44,10 +46,12 @@ class UrlMapValidationResult extends \Google\Protobuf\Internal\Message * * @type array|\Google\Protobuf\Internal\RepeatedField $load_errors * @type bool $load_succeeded - * Whether the given UrlMap can be successfully loaded. If false, 'loadErrors' indicates the reasons. + * Whether the given UrlMap can be successfully loaded. + * If false, 'loadErrors' indicates the reasons. * @type array<\Google\Cloud\Compute\V1\TestFailure>|\Google\Protobuf\Internal\RepeatedField $test_failures * @type bool $test_passed - * If successfully loaded, this field indicates whether the test passed. If false, 'testFailures's indicate the reason of failure. + * If successfully loaded, this field indicates whether the test passed. + * If false, 'testFailures's indicate the reason of failure. * } */ public function __construct($data = NULL) { @@ -78,7 +82,8 @@ public function setLoadErrors($var) } /** - * Whether the given UrlMap can be successfully loaded. If false, 'loadErrors' indicates the reasons. + * Whether the given UrlMap can be successfully loaded. + * If false, 'loadErrors' indicates the reasons. * * Generated from protobuf field optional bool load_succeeded = 128326216; * @return bool @@ -99,7 +104,8 @@ public function clearLoadSucceeded() } /** - * Whether the given UrlMap can be successfully loaded. If false, 'loadErrors' indicates the reasons. + * Whether the given UrlMap can be successfully loaded. + * If false, 'loadErrors' indicates the reasons. * * Generated from protobuf field optional bool load_succeeded = 128326216; * @param bool $var @@ -136,7 +142,8 @@ public function setTestFailures($var) } /** - * If successfully loaded, this field indicates whether the test passed. If false, 'testFailures's indicate the reason of failure. + * If successfully loaded, this field indicates whether the test passed. + * If false, 'testFailures's indicate the reason of failure. * * Generated from protobuf field optional bool test_passed = 192708797; * @return bool @@ -157,7 +164,8 @@ public function clearTestPassed() } /** - * If successfully loaded, this field indicates whether the test passed. If false, 'testFailures's indicate the reason of failure. + * If successfully loaded, this field indicates whether the test passed. + * If false, 'testFailures's indicate the reason of failure. * * Generated from protobuf field optional bool test_passed = 192708797; * @param bool $var diff --git a/Compute/src/V1/UrlMapsAggregatedList.php b/Compute/src/V1/UrlMapsAggregatedList.php index f0e4a1880b16..5ce5c818759e 100644 --- a/Compute/src/V1/UrlMapsAggregatedList.php +++ b/Compute/src/V1/UrlMapsAggregatedList.php @@ -33,7 +33,11 @@ class UrlMapsAggregatedList extends \Google\Protobuf\Internal\Message */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -70,7 +74,11 @@ class UrlMapsAggregatedList extends \Google\Protobuf\Internal\Message * @type string $kind * Type of resource. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type array|\Google\Protobuf\Internal\RepeatedField $unreachables @@ -183,7 +191,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -204,7 +216,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/UrlMapsScopedList.php b/Compute/src/V1/UrlMapsScopedList.php index 42ce675ab9e5..41953b158563 100644 --- a/Compute/src/V1/UrlMapsScopedList.php +++ b/Compute/src/V1/UrlMapsScopedList.php @@ -21,7 +21,8 @@ class UrlMapsScopedList extends \Google\Protobuf\Internal\Message */ private $url_maps; /** - * Informational warning which replaces the list of backend services when the list is empty. + * Informational warning which replaces the list of + * backend services when the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; */ @@ -36,7 +37,8 @@ class UrlMapsScopedList extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\UrlMap>|\Google\Protobuf\Internal\RepeatedField $url_maps * A list of UrlMaps contained in this scope. * @type \Google\Cloud\Compute\V1\Warning $warning - * Informational warning which replaces the list of backend services when the list is empty. + * Informational warning which replaces the list of + * backend services when the list is empty. * } */ public function __construct($data = NULL) { @@ -71,7 +73,8 @@ public function setUrlMaps($var) } /** - * Informational warning which replaces the list of backend services when the list is empty. + * Informational warning which replaces the list of + * backend services when the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; * @return \Google\Cloud\Compute\V1\Warning|null @@ -92,7 +95,8 @@ public function clearWarning() } /** - * Informational warning which replaces the list of backend services when the list is empty. + * Informational warning which replaces the list of + * backend services when the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; * @param \Google\Cloud\Compute\V1\Warning $var diff --git a/Compute/src/V1/UrlMapsValidateRequest.php b/Compute/src/V1/UrlMapsValidateRequest.php index 14a78719a69a..9e396b258571 100644 --- a/Compute/src/V1/UrlMapsValidateRequest.php +++ b/Compute/src/V1/UrlMapsValidateRequest.php @@ -15,7 +15,18 @@ class UrlMapsValidateRequest extends \Google\Protobuf\Internal\Message { /** - * Specifies the load balancer type(s) this validation request is for. Use EXTERNAL_MANAGED for global external Application Load Balancers and regional external Application Load Balancers. Use EXTERNAL for classic Application Load Balancers. Use INTERNAL_MANAGED for internal Application Load Balancers. For more information, refer to Choosing a load balancer. If unspecified, the load balancing scheme will be inferred from the backend service resources this URL map references. If that can not be inferred (for example, this URL map only references backend buckets, or this Url map is for rewrites and redirects only and doesn't reference any backends), EXTERNAL will be used as the default type. If specified, the scheme(s) must not conflict with the load balancing scheme of the backend service resources this Url map references. + * Specifies the load balancer type(s) this validation request is for. UseEXTERNAL_MANAGED for global external Application Load + * Balancers and regional external Application Load Balancers. + * Use EXTERNAL for classic Application Load Balancers. + * Use INTERNAL_MANAGED for internal Application Load Balancers. For more + * information, refer to Choosing + * a load balancer. + * If unspecified, the load balancing scheme will be inferred from the backend + * service resources this URL map references. If that can not be inferred (for + * example, this URL map only references backend buckets, or this Url map is + * for rewrites and redirects only and doesn't reference any backends),EXTERNAL will be used as the default type. + * If specified, the scheme(s) must not conflict with the load balancing + * scheme of the backend service resources this Url map references. * Check the LoadBalancingSchemes enum for the list of possible values. * * Generated from protobuf field repeated string load_balancing_schemes = 6308527; @@ -35,7 +46,18 @@ class UrlMapsValidateRequest extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type array|\Google\Protobuf\Internal\RepeatedField $load_balancing_schemes - * Specifies the load balancer type(s) this validation request is for. Use EXTERNAL_MANAGED for global external Application Load Balancers and regional external Application Load Balancers. Use EXTERNAL for classic Application Load Balancers. Use INTERNAL_MANAGED for internal Application Load Balancers. For more information, refer to Choosing a load balancer. If unspecified, the load balancing scheme will be inferred from the backend service resources this URL map references. If that can not be inferred (for example, this URL map only references backend buckets, or this Url map is for rewrites and redirects only and doesn't reference any backends), EXTERNAL will be used as the default type. If specified, the scheme(s) must not conflict with the load balancing scheme of the backend service resources this Url map references. + * Specifies the load balancer type(s) this validation request is for. UseEXTERNAL_MANAGED for global external Application Load + * Balancers and regional external Application Load Balancers. + * Use EXTERNAL for classic Application Load Balancers. + * Use INTERNAL_MANAGED for internal Application Load Balancers. For more + * information, refer to Choosing + * a load balancer. + * If unspecified, the load balancing scheme will be inferred from the backend + * service resources this URL map references. If that can not be inferred (for + * example, this URL map only references backend buckets, or this Url map is + * for rewrites and redirects only and doesn't reference any backends),EXTERNAL will be used as the default type. + * If specified, the scheme(s) must not conflict with the load balancing + * scheme of the backend service resources this Url map references. * Check the LoadBalancingSchemes enum for the list of possible values. * @type \Google\Cloud\Compute\V1\UrlMap $resource * Content of the UrlMap to be validated. @@ -47,7 +69,18 @@ public function __construct($data = NULL) { } /** - * Specifies the load balancer type(s) this validation request is for. Use EXTERNAL_MANAGED for global external Application Load Balancers and regional external Application Load Balancers. Use EXTERNAL for classic Application Load Balancers. Use INTERNAL_MANAGED for internal Application Load Balancers. For more information, refer to Choosing a load balancer. If unspecified, the load balancing scheme will be inferred from the backend service resources this URL map references. If that can not be inferred (for example, this URL map only references backend buckets, or this Url map is for rewrites and redirects only and doesn't reference any backends), EXTERNAL will be used as the default type. If specified, the scheme(s) must not conflict with the load balancing scheme of the backend service resources this Url map references. + * Specifies the load balancer type(s) this validation request is for. UseEXTERNAL_MANAGED for global external Application Load + * Balancers and regional external Application Load Balancers. + * Use EXTERNAL for classic Application Load Balancers. + * Use INTERNAL_MANAGED for internal Application Load Balancers. For more + * information, refer to Choosing + * a load balancer. + * If unspecified, the load balancing scheme will be inferred from the backend + * service resources this URL map references. If that can not be inferred (for + * example, this URL map only references backend buckets, or this Url map is + * for rewrites and redirects only and doesn't reference any backends),EXTERNAL will be used as the default type. + * If specified, the scheme(s) must not conflict with the load balancing + * scheme of the backend service resources this Url map references. * Check the LoadBalancingSchemes enum for the list of possible values. * * Generated from protobuf field repeated string load_balancing_schemes = 6308527; @@ -59,7 +92,18 @@ public function getLoadBalancingSchemes() } /** - * Specifies the load balancer type(s) this validation request is for. Use EXTERNAL_MANAGED for global external Application Load Balancers and regional external Application Load Balancers. Use EXTERNAL for classic Application Load Balancers. Use INTERNAL_MANAGED for internal Application Load Balancers. For more information, refer to Choosing a load balancer. If unspecified, the load balancing scheme will be inferred from the backend service resources this URL map references. If that can not be inferred (for example, this URL map only references backend buckets, or this Url map is for rewrites and redirects only and doesn't reference any backends), EXTERNAL will be used as the default type. If specified, the scheme(s) must not conflict with the load balancing scheme of the backend service resources this Url map references. + * Specifies the load balancer type(s) this validation request is for. UseEXTERNAL_MANAGED for global external Application Load + * Balancers and regional external Application Load Balancers. + * Use EXTERNAL for classic Application Load Balancers. + * Use INTERNAL_MANAGED for internal Application Load Balancers. For more + * information, refer to Choosing + * a load balancer. + * If unspecified, the load balancing scheme will be inferred from the backend + * service resources this URL map references. If that can not be inferred (for + * example, this URL map only references backend buckets, or this Url map is + * for rewrites and redirects only and doesn't reference any backends),EXTERNAL will be used as the default type. + * If specified, the scheme(s) must not conflict with the load balancing + * scheme of the backend service resources this Url map references. * Check the LoadBalancingSchemes enum for the list of possible values. * * Generated from protobuf field repeated string load_balancing_schemes = 6308527; diff --git a/Compute/src/V1/UrlMapsValidateRequest/LoadBalancingSchemes.php b/Compute/src/V1/UrlMapsValidateRequest/LoadBalancingSchemes.php index 37ae2b39c15f..b5fab4b67c35 100644 --- a/Compute/src/V1/UrlMapsValidateRequest/LoadBalancingSchemes.php +++ b/Compute/src/V1/UrlMapsValidateRequest/LoadBalancingSchemes.php @@ -25,13 +25,16 @@ class LoadBalancingSchemes */ const EXTERNAL = 35607499; /** - * Signifies that this will be used for Envoy-based global external Application Load Balancers. + * Signifies that this will be used for Envoy-based global external + * Application Load Balancers. * * Generated from protobuf enum EXTERNAL_MANAGED = 512006923; */ const EXTERNAL_MANAGED = 512006923; /** - * If unspecified, the validation will try to infer the scheme from the backend service resources this Url map references. If the inference is not possible, EXTERNAL will be used as the default type. + * If unspecified, the validation will try to infer the scheme from the + * backend service resources this Url map references. If the inference is not + * possible, EXTERNAL will be used as the default type. * * Generated from protobuf enum LOAD_BALANCING_SCHEME_UNSPECIFIED = 526507452; */ diff --git a/Compute/src/V1/UrlRewrite.php b/Compute/src/V1/UrlRewrite.php index cc6e0ee5f4c0..0b20488e7521 100644 --- a/Compute/src/V1/UrlRewrite.php +++ b/Compute/src/V1/UrlRewrite.php @@ -9,26 +9,49 @@ use Google\Protobuf\Internal\GPBUtil; /** - * The spec for modifying the path before sending the request to the matched backend service. + * The spec for modifying the path before sending the request to the matched + * backend service. * * Generated from protobuf message google.cloud.compute.v1.UrlRewrite */ class UrlRewrite extends \Google\Protobuf\Internal\Message { /** - * Before forwarding the request to the selected service, the request's host header is replaced with contents of hostRewrite. The value must be from 1 to 255 characters. + * Before forwarding the request to the selected service, the request's + * host header is replaced with contents of hostRewrite. + * The value must be from 1 to 255 characters. * * Generated from protobuf field optional string host_rewrite = 159819253; */ protected $host_rewrite = null; /** - * Before forwarding the request to the selected backend service, the matching portion of the request's path is replaced by pathPrefixRewrite. The value must be from 1 to 1024 characters. + * Before forwarding the request to the selected backend service, the + * matching portion of the request's path is replaced bypathPrefixRewrite. + * The value must be from 1 to 1024 characters. * * Generated from protobuf field optional string path_prefix_rewrite = 41186361; */ protected $path_prefix_rewrite = null; /** - * If specified, the pattern rewrites the URL path (based on the :path header) using the HTTP template syntax. A corresponding path_template_match must be specified. Any template variables must exist in the path_template_match field. - -At least one variable must be specified in the path_template_match field - You can omit variables from the rewritten URL - The * and ** operators cannot be matched unless they have a corresponding variable name - e.g. {format=*} or {var=**}. For example, a path_template_match of /static/{format=**} could be rewritten as /static/content/{format} to prefix /content to the URL. Variables can also be re-ordered in a rewrite, so that /{country}/{format}/{suffix=**} can be rewritten as /content/{format}/{country}/{suffix}. At least one non-empty routeRules[].matchRules[].path_template_match is required. Only one of path_prefix_rewrite or path_template_rewrite may be specified. + * If specified, the pattern rewrites the URL path (based on the :path + * header) using the HTTP template syntax. + * A corresponding + * path_template_match must be specified. Any template variables must exist in + * the path_template_match field. + * - -At least one variable must be specified in the path_template_match + * field + * - You can omit variables from the rewritten URL + * - The * and ** operators cannot be matched + * unless they have a corresponding variable name - e.g. + * {format=*} or {var=**}. + * For example, a path_template_match of /static/{format=**} + * could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a + * rewrite, so that /{country}/{format}/{suffix=**} can be + * rewritten as /content/{format}/{country}/{suffix}. + * At least + * one non-empty routeRules[].matchRules[].path_template_match is + * required. + * Only one of path_prefix_rewrite orpath_template_rewrite may be specified. * * Generated from protobuf field optional string path_template_rewrite = 423409569; */ @@ -41,11 +64,33 @@ class UrlRewrite extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $host_rewrite - * Before forwarding the request to the selected service, the request's host header is replaced with contents of hostRewrite. The value must be from 1 to 255 characters. + * Before forwarding the request to the selected service, the request's + * host header is replaced with contents of hostRewrite. + * The value must be from 1 to 255 characters. * @type string $path_prefix_rewrite - * Before forwarding the request to the selected backend service, the matching portion of the request's path is replaced by pathPrefixRewrite. The value must be from 1 to 1024 characters. + * Before forwarding the request to the selected backend service, the + * matching portion of the request's path is replaced bypathPrefixRewrite. + * The value must be from 1 to 1024 characters. * @type string $path_template_rewrite - * If specified, the pattern rewrites the URL path (based on the :path header) using the HTTP template syntax. A corresponding path_template_match must be specified. Any template variables must exist in the path_template_match field. - -At least one variable must be specified in the path_template_match field - You can omit variables from the rewritten URL - The * and ** operators cannot be matched unless they have a corresponding variable name - e.g. {format=*} or {var=**}. For example, a path_template_match of /static/{format=**} could be rewritten as /static/content/{format} to prefix /content to the URL. Variables can also be re-ordered in a rewrite, so that /{country}/{format}/{suffix=**} can be rewritten as /content/{format}/{country}/{suffix}. At least one non-empty routeRules[].matchRules[].path_template_match is required. Only one of path_prefix_rewrite or path_template_rewrite may be specified. + * If specified, the pattern rewrites the URL path (based on the :path + * header) using the HTTP template syntax. + * A corresponding + * path_template_match must be specified. Any template variables must exist in + * the path_template_match field. + * - -At least one variable must be specified in the path_template_match + * field + * - You can omit variables from the rewritten URL + * - The * and ** operators cannot be matched + * unless they have a corresponding variable name - e.g. + * {format=*} or {var=**}. + * For example, a path_template_match of /static/{format=**} + * could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a + * rewrite, so that /{country}/{format}/{suffix=**} can be + * rewritten as /content/{format}/{country}/{suffix}. + * At least + * one non-empty routeRules[].matchRules[].path_template_match is + * required. + * Only one of path_prefix_rewrite orpath_template_rewrite may be specified. * } */ public function __construct($data = NULL) { @@ -54,7 +99,9 @@ public function __construct($data = NULL) { } /** - * Before forwarding the request to the selected service, the request's host header is replaced with contents of hostRewrite. The value must be from 1 to 255 characters. + * Before forwarding the request to the selected service, the request's + * host header is replaced with contents of hostRewrite. + * The value must be from 1 to 255 characters. * * Generated from protobuf field optional string host_rewrite = 159819253; * @return string @@ -75,7 +122,9 @@ public function clearHostRewrite() } /** - * Before forwarding the request to the selected service, the request's host header is replaced with contents of hostRewrite. The value must be from 1 to 255 characters. + * Before forwarding the request to the selected service, the request's + * host header is replaced with contents of hostRewrite. + * The value must be from 1 to 255 characters. * * Generated from protobuf field optional string host_rewrite = 159819253; * @param string $var @@ -90,7 +139,9 @@ public function setHostRewrite($var) } /** - * Before forwarding the request to the selected backend service, the matching portion of the request's path is replaced by pathPrefixRewrite. The value must be from 1 to 1024 characters. + * Before forwarding the request to the selected backend service, the + * matching portion of the request's path is replaced bypathPrefixRewrite. + * The value must be from 1 to 1024 characters. * * Generated from protobuf field optional string path_prefix_rewrite = 41186361; * @return string @@ -111,7 +162,9 @@ public function clearPathPrefixRewrite() } /** - * Before forwarding the request to the selected backend service, the matching portion of the request's path is replaced by pathPrefixRewrite. The value must be from 1 to 1024 characters. + * Before forwarding the request to the selected backend service, the + * matching portion of the request's path is replaced bypathPrefixRewrite. + * The value must be from 1 to 1024 characters. * * Generated from protobuf field optional string path_prefix_rewrite = 41186361; * @param string $var @@ -126,7 +179,25 @@ public function setPathPrefixRewrite($var) } /** - * If specified, the pattern rewrites the URL path (based on the :path header) using the HTTP template syntax. A corresponding path_template_match must be specified. Any template variables must exist in the path_template_match field. - -At least one variable must be specified in the path_template_match field - You can omit variables from the rewritten URL - The * and ** operators cannot be matched unless they have a corresponding variable name - e.g. {format=*} or {var=**}. For example, a path_template_match of /static/{format=**} could be rewritten as /static/content/{format} to prefix /content to the URL. Variables can also be re-ordered in a rewrite, so that /{country}/{format}/{suffix=**} can be rewritten as /content/{format}/{country}/{suffix}. At least one non-empty routeRules[].matchRules[].path_template_match is required. Only one of path_prefix_rewrite or path_template_rewrite may be specified. + * If specified, the pattern rewrites the URL path (based on the :path + * header) using the HTTP template syntax. + * A corresponding + * path_template_match must be specified. Any template variables must exist in + * the path_template_match field. + * - -At least one variable must be specified in the path_template_match + * field + * - You can omit variables from the rewritten URL + * - The * and ** operators cannot be matched + * unless they have a corresponding variable name - e.g. + * {format=*} or {var=**}. + * For example, a path_template_match of /static/{format=**} + * could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a + * rewrite, so that /{country}/{format}/{suffix=**} can be + * rewritten as /content/{format}/{country}/{suffix}. + * At least + * one non-empty routeRules[].matchRules[].path_template_match is + * required. + * Only one of path_prefix_rewrite orpath_template_rewrite may be specified. * * Generated from protobuf field optional string path_template_rewrite = 423409569; * @return string @@ -147,7 +218,25 @@ public function clearPathTemplateRewrite() } /** - * If specified, the pattern rewrites the URL path (based on the :path header) using the HTTP template syntax. A corresponding path_template_match must be specified. Any template variables must exist in the path_template_match field. - -At least one variable must be specified in the path_template_match field - You can omit variables from the rewritten URL - The * and ** operators cannot be matched unless they have a corresponding variable name - e.g. {format=*} or {var=**}. For example, a path_template_match of /static/{format=**} could be rewritten as /static/content/{format} to prefix /content to the URL. Variables can also be re-ordered in a rewrite, so that /{country}/{format}/{suffix=**} can be rewritten as /content/{format}/{country}/{suffix}. At least one non-empty routeRules[].matchRules[].path_template_match is required. Only one of path_prefix_rewrite or path_template_rewrite may be specified. + * If specified, the pattern rewrites the URL path (based on the :path + * header) using the HTTP template syntax. + * A corresponding + * path_template_match must be specified. Any template variables must exist in + * the path_template_match field. + * - -At least one variable must be specified in the path_template_match + * field + * - You can omit variables from the rewritten URL + * - The * and ** operators cannot be matched + * unless they have a corresponding variable name - e.g. + * {format=*} or {var=**}. + * For example, a path_template_match of /static/{format=**} + * could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a + * rewrite, so that /{country}/{format}/{suffix=**} can be + * rewritten as /content/{format}/{country}/{suffix}. + * At least + * one non-empty routeRules[].matchRules[].path_template_match is + * required. + * Only one of path_prefix_rewrite orpath_template_rewrite may be specified. * * Generated from protobuf field optional string path_template_rewrite = 423409569; * @param string $var diff --git a/Compute/src/V1/UsableSubnetwork.php b/Compute/src/V1/UsableSubnetwork.php index b391db81e31d..77222181b13e 100644 --- a/Compute/src/V1/UsableSubnetwork.php +++ b/Compute/src/V1/UsableSubnetwork.php @@ -16,13 +16,15 @@ class UsableSubnetwork extends \Google\Protobuf\Internal\Message { /** - * [Output Only] The external IPv6 address range that is assigned to this subnetwork. + * [Output Only] The external IPv6 address range that is assigned to this + * subnetwork. * * Generated from protobuf field optional string external_ipv6_prefix = 139299190; */ protected $external_ipv6_prefix = null; /** - * [Output Only] The internal IPv6 address range that is assigned to this subnetwork. + * [Output Only] The internal IPv6 address range that is assigned to this + * subnetwork. * * Generated from protobuf field optional string internal_ipv6_prefix = 506270056; */ @@ -34,7 +36,9 @@ class UsableSubnetwork extends \Google\Protobuf\Internal\Message */ protected $ip_cidr_range = null; /** - * The access type of IPv6 address this subnet holds. It's immutable and can only be specified during creation or the first time the subnet is updated into IPV4_IPV6 dual stack. + * The access type of IPv6 address this subnet holds. It's immutable and can + * only be specified during creation or the first time the subnet is updated + * into IPV4_IPV6 dual stack. * Check the Ipv6AccessType enum for the list of possible values. * * Generated from protobuf field optional string ipv6_access_type = 504658653; @@ -54,7 +58,12 @@ class UsableSubnetwork extends \Google\Protobuf\Internal\Message */ protected $purpose = null; /** - * The role of subnetwork. Currently, this field is only used when purpose is set to GLOBAL_MANAGED_PROXY or REGIONAL_MANAGED_PROXY. The value can be set to ACTIVE or BACKUP. An ACTIVE subnetwork is one that is currently being used for Envoy-based load balancers in a region. A BACKUP subnetwork is one that is ready to be promoted to ACTIVE or is currently draining. This field can be updated with a patch request. + * The role of subnetwork. Currently, this field is only used when + * purpose is set to GLOBAL_MANAGED_PROXY orREGIONAL_MANAGED_PROXY. The value can be set toACTIVE or BACKUP. An ACTIVE + * subnetwork is one that is currently being used for Envoy-based load + * balancers in a region. A BACKUP subnetwork is one that is + * ready to be promoted to ACTIVE or is currently draining. + * This field can be updated with a patch request. * Check the Role enum for the list of possible values. * * Generated from protobuf field optional string role = 3506294; @@ -67,7 +76,10 @@ class UsableSubnetwork extends \Google\Protobuf\Internal\Message */ private $secondary_ip_ranges; /** - * The stack type for the subnet. If set to IPV4_ONLY, new VMs in the subnet are assigned IPv4 addresses only. If set to IPV4_IPV6, new VMs in the subnet can be assigned both IPv4 and IPv6 addresses. If not specified, IPV4_ONLY is used. This field can be both set at resource creation time and updated using patch. + * The stack type for the subnet. If set to IPV4_ONLY, new VMs + * in the subnet are assigned IPv4 addresses only. If set toIPV4_IPV6, new VMs in the subnet can be assigned both IPv4 and + * IPv6 addresses. If not specified, IPV4_ONLY is used. + * This field can be both set at resource creation time and updated usingpatch. * Check the StackType enum for the list of possible values. * * Generated from protobuf field optional string stack_type = 425908881; @@ -87,13 +99,17 @@ class UsableSubnetwork extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $external_ipv6_prefix - * [Output Only] The external IPv6 address range that is assigned to this subnetwork. + * [Output Only] The external IPv6 address range that is assigned to this + * subnetwork. * @type string $internal_ipv6_prefix - * [Output Only] The internal IPv6 address range that is assigned to this subnetwork. + * [Output Only] The internal IPv6 address range that is assigned to this + * subnetwork. * @type string $ip_cidr_range * The range of internal addresses that are owned by this subnetwork. * @type string $ipv6_access_type - * The access type of IPv6 address this subnet holds. It's immutable and can only be specified during creation or the first time the subnet is updated into IPV4_IPV6 dual stack. + * The access type of IPv6 address this subnet holds. It's immutable and can + * only be specified during creation or the first time the subnet is updated + * into IPV4_IPV6 dual stack. * Check the Ipv6AccessType enum for the list of possible values. * @type string $network * Network URL. @@ -101,12 +117,20 @@ class UsableSubnetwork extends \Google\Protobuf\Internal\Message * * Check the Purpose enum for the list of possible values. * @type string $role - * The role of subnetwork. Currently, this field is only used when purpose is set to GLOBAL_MANAGED_PROXY or REGIONAL_MANAGED_PROXY. The value can be set to ACTIVE or BACKUP. An ACTIVE subnetwork is one that is currently being used for Envoy-based load balancers in a region. A BACKUP subnetwork is one that is ready to be promoted to ACTIVE or is currently draining. This field can be updated with a patch request. + * The role of subnetwork. Currently, this field is only used when + * purpose is set to GLOBAL_MANAGED_PROXY orREGIONAL_MANAGED_PROXY. The value can be set toACTIVE or BACKUP. An ACTIVE + * subnetwork is one that is currently being used for Envoy-based load + * balancers in a region. A BACKUP subnetwork is one that is + * ready to be promoted to ACTIVE or is currently draining. + * This field can be updated with a patch request. * Check the Role enum for the list of possible values. * @type array<\Google\Cloud\Compute\V1\UsableSubnetworkSecondaryRange>|\Google\Protobuf\Internal\RepeatedField $secondary_ip_ranges * Secondary IP ranges. * @type string $stack_type - * The stack type for the subnet. If set to IPV4_ONLY, new VMs in the subnet are assigned IPv4 addresses only. If set to IPV4_IPV6, new VMs in the subnet can be assigned both IPv4 and IPv6 addresses. If not specified, IPV4_ONLY is used. This field can be both set at resource creation time and updated using patch. + * The stack type for the subnet. If set to IPV4_ONLY, new VMs + * in the subnet are assigned IPv4 addresses only. If set toIPV4_IPV6, new VMs in the subnet can be assigned both IPv4 and + * IPv6 addresses. If not specified, IPV4_ONLY is used. + * This field can be both set at resource creation time and updated usingpatch. * Check the StackType enum for the list of possible values. * @type string $subnetwork * Subnetwork URL. @@ -118,7 +142,8 @@ public function __construct($data = NULL) { } /** - * [Output Only] The external IPv6 address range that is assigned to this subnetwork. + * [Output Only] The external IPv6 address range that is assigned to this + * subnetwork. * * Generated from protobuf field optional string external_ipv6_prefix = 139299190; * @return string @@ -139,7 +164,8 @@ public function clearExternalIpv6Prefix() } /** - * [Output Only] The external IPv6 address range that is assigned to this subnetwork. + * [Output Only] The external IPv6 address range that is assigned to this + * subnetwork. * * Generated from protobuf field optional string external_ipv6_prefix = 139299190; * @param string $var @@ -154,7 +180,8 @@ public function setExternalIpv6Prefix($var) } /** - * [Output Only] The internal IPv6 address range that is assigned to this subnetwork. + * [Output Only] The internal IPv6 address range that is assigned to this + * subnetwork. * * Generated from protobuf field optional string internal_ipv6_prefix = 506270056; * @return string @@ -175,7 +202,8 @@ public function clearInternalIpv6Prefix() } /** - * [Output Only] The internal IPv6 address range that is assigned to this subnetwork. + * [Output Only] The internal IPv6 address range that is assigned to this + * subnetwork. * * Generated from protobuf field optional string internal_ipv6_prefix = 506270056; * @param string $var @@ -226,7 +254,9 @@ public function setIpCidrRange($var) } /** - * The access type of IPv6 address this subnet holds. It's immutable and can only be specified during creation or the first time the subnet is updated into IPV4_IPV6 dual stack. + * The access type of IPv6 address this subnet holds. It's immutable and can + * only be specified during creation or the first time the subnet is updated + * into IPV4_IPV6 dual stack. * Check the Ipv6AccessType enum for the list of possible values. * * Generated from protobuf field optional string ipv6_access_type = 504658653; @@ -248,7 +278,9 @@ public function clearIpv6AccessType() } /** - * The access type of IPv6 address this subnet holds. It's immutable and can only be specified during creation or the first time the subnet is updated into IPV4_IPV6 dual stack. + * The access type of IPv6 address this subnet holds. It's immutable and can + * only be specified during creation or the first time the subnet is updated + * into IPV4_IPV6 dual stack. * Check the Ipv6AccessType enum for the list of possible values. * * Generated from protobuf field optional string ipv6_access_type = 504658653; @@ -338,7 +370,12 @@ public function setPurpose($var) } /** - * The role of subnetwork. Currently, this field is only used when purpose is set to GLOBAL_MANAGED_PROXY or REGIONAL_MANAGED_PROXY. The value can be set to ACTIVE or BACKUP. An ACTIVE subnetwork is one that is currently being used for Envoy-based load balancers in a region. A BACKUP subnetwork is one that is ready to be promoted to ACTIVE or is currently draining. This field can be updated with a patch request. + * The role of subnetwork. Currently, this field is only used when + * purpose is set to GLOBAL_MANAGED_PROXY orREGIONAL_MANAGED_PROXY. The value can be set toACTIVE or BACKUP. An ACTIVE + * subnetwork is one that is currently being used for Envoy-based load + * balancers in a region. A BACKUP subnetwork is one that is + * ready to be promoted to ACTIVE or is currently draining. + * This field can be updated with a patch request. * Check the Role enum for the list of possible values. * * Generated from protobuf field optional string role = 3506294; @@ -360,7 +397,12 @@ public function clearRole() } /** - * The role of subnetwork. Currently, this field is only used when purpose is set to GLOBAL_MANAGED_PROXY or REGIONAL_MANAGED_PROXY. The value can be set to ACTIVE or BACKUP. An ACTIVE subnetwork is one that is currently being used for Envoy-based load balancers in a region. A BACKUP subnetwork is one that is ready to be promoted to ACTIVE or is currently draining. This field can be updated with a patch request. + * The role of subnetwork. Currently, this field is only used when + * purpose is set to GLOBAL_MANAGED_PROXY orREGIONAL_MANAGED_PROXY. The value can be set toACTIVE or BACKUP. An ACTIVE + * subnetwork is one that is currently being used for Envoy-based load + * balancers in a region. A BACKUP subnetwork is one that is + * ready to be promoted to ACTIVE or is currently draining. + * This field can be updated with a patch request. * Check the Role enum for the list of possible values. * * Generated from protobuf field optional string role = 3506294; @@ -402,7 +444,10 @@ public function setSecondaryIpRanges($var) } /** - * The stack type for the subnet. If set to IPV4_ONLY, new VMs in the subnet are assigned IPv4 addresses only. If set to IPV4_IPV6, new VMs in the subnet can be assigned both IPv4 and IPv6 addresses. If not specified, IPV4_ONLY is used. This field can be both set at resource creation time and updated using patch. + * The stack type for the subnet. If set to IPV4_ONLY, new VMs + * in the subnet are assigned IPv4 addresses only. If set toIPV4_IPV6, new VMs in the subnet can be assigned both IPv4 and + * IPv6 addresses. If not specified, IPV4_ONLY is used. + * This field can be both set at resource creation time and updated usingpatch. * Check the StackType enum for the list of possible values. * * Generated from protobuf field optional string stack_type = 425908881; @@ -424,7 +469,10 @@ public function clearStackType() } /** - * The stack type for the subnet. If set to IPV4_ONLY, new VMs in the subnet are assigned IPv4 addresses only. If set to IPV4_IPV6, new VMs in the subnet can be assigned both IPv4 and IPv6 addresses. If not specified, IPV4_ONLY is used. This field can be both set at resource creation time and updated using patch. + * The stack type for the subnet. If set to IPV4_ONLY, new VMs + * in the subnet are assigned IPv4 addresses only. If set toIPV4_IPV6, new VMs in the subnet can be assigned both IPv4 and + * IPv6 addresses. If not specified, IPV4_ONLY is used. + * This field can be both set at resource creation time and updated usingpatch. * Check the StackType enum for the list of possible values. * * Generated from protobuf field optional string stack_type = 425908881; diff --git a/Compute/src/V1/UsableSubnetwork/Ipv6AccessType.php b/Compute/src/V1/UsableSubnetwork/Ipv6AccessType.php index a2406e1a1f2f..9767ef524cbe 100644 --- a/Compute/src/V1/UsableSubnetwork/Ipv6AccessType.php +++ b/Compute/src/V1/UsableSubnetwork/Ipv6AccessType.php @@ -7,7 +7,9 @@ use UnexpectedValueException; /** - * The access type of IPv6 address this subnet holds. It's immutable and can only be specified during creation or the first time the subnet is updated into IPV4_IPV6 dual stack. + * The access type of IPv6 address this subnet holds. It's immutable and can + * only be specified during creation or the first time the subnet is updated + * into IPV4_IPV6 dual stack. * * Protobuf type google.cloud.compute.v1.UsableSubnetwork.Ipv6AccessType */ @@ -20,13 +22,15 @@ class Ipv6AccessType */ const UNDEFINED_IPV6_ACCESS_TYPE = 0; /** - * VMs on this subnet will be assigned IPv6 addresses that are accessible via the Internet, as well as the VPC network. + * VMs on this subnet will be assigned IPv6 addresses that are accessible + * via the Internet, as well as the VPC network. * * Generated from protobuf enum EXTERNAL = 35607499; */ const EXTERNAL = 35607499; /** - * VMs on this subnet will be assigned IPv6 addresses that are only accessible over the VPC network. + * VMs on this subnet will be assigned IPv6 addresses that are only + * accessible over the VPC network. * * Generated from protobuf enum INTERNAL = 279295677; */ diff --git a/Compute/src/V1/UsableSubnetwork/Purpose.php b/Compute/src/V1/UsableSubnetwork/Purpose.php index b64543923d28..79881642c9fa 100644 --- a/Compute/src/V1/UsableSubnetwork/Purpose.php +++ b/Compute/src/V1/UsableSubnetwork/Purpose.php @@ -25,13 +25,16 @@ class Purpose */ const GLOBAL_MANAGED_PROXY = 236463602; /** - * Subnet reserved for Internal HTTP(S) Load Balancing. This is a legacy purpose, please use REGIONAL_MANAGED_PROXY instead. + * Subnet reserved for Internal HTTP(S) Load Balancing. This is a legacy + * purpose, please use REGIONAL_MANAGED_PROXY instead. * * Generated from protobuf enum INTERNAL_HTTPS_LOAD_BALANCER = 248748889; */ const INTERNAL_HTTPS_LOAD_BALANCER = 248748889; /** - * Subnetwork will be used for Migration from one peered VPC to another. (a transient state of subnetwork while migrating resources from one project to another). + * Subnetwork will be used for Migration from one peered VPC to another. + * (a transient state of subnetwork + * while migrating resources from one project to another). * * Generated from protobuf enum PEER_MIGRATION = 491902225; */ diff --git a/Compute/src/V1/UsableSubnetwork/Role.php b/Compute/src/V1/UsableSubnetwork/Role.php index bcca58ffe90c..e53c359433e6 100644 --- a/Compute/src/V1/UsableSubnetwork/Role.php +++ b/Compute/src/V1/UsableSubnetwork/Role.php @@ -7,7 +7,12 @@ use UnexpectedValueException; /** - * The role of subnetwork. Currently, this field is only used when purpose is set to GLOBAL_MANAGED_PROXY or REGIONAL_MANAGED_PROXY. The value can be set to ACTIVE or BACKUP. An ACTIVE subnetwork is one that is currently being used for Envoy-based load balancers in a region. A BACKUP subnetwork is one that is ready to be promoted to ACTIVE or is currently draining. This field can be updated with a patch request. + * The role of subnetwork. Currently, this field is only used when + * purpose is set to GLOBAL_MANAGED_PROXY orREGIONAL_MANAGED_PROXY. The value can be set toACTIVE or BACKUP. An ACTIVE + * subnetwork is one that is currently being used for Envoy-based load + * balancers in a region. A BACKUP subnetwork is one that is + * ready to be promoted to ACTIVE or is currently draining. + * This field can be updated with a patch request. * * Protobuf type google.cloud.compute.v1.UsableSubnetwork.Role */ diff --git a/Compute/src/V1/UsableSubnetwork/StackType.php b/Compute/src/V1/UsableSubnetwork/StackType.php index 87d458ded8c4..cde26acae02d 100644 --- a/Compute/src/V1/UsableSubnetwork/StackType.php +++ b/Compute/src/V1/UsableSubnetwork/StackType.php @@ -7,7 +7,10 @@ use UnexpectedValueException; /** - * The stack type for the subnet. If set to IPV4_ONLY, new VMs in the subnet are assigned IPv4 addresses only. If set to IPV4_IPV6, new VMs in the subnet can be assigned both IPv4 and IPv6 addresses. If not specified, IPV4_ONLY is used. This field can be both set at resource creation time and updated using patch. + * The stack type for the subnet. If set to IPV4_ONLY, new VMs + * in the subnet are assigned IPv4 addresses only. If set toIPV4_IPV6, new VMs in the subnet can be assigned both IPv4 and + * IPv6 addresses. If not specified, IPV4_ONLY is used. + * This field can be both set at resource creation time and updated usingpatch. * * Protobuf type google.cloud.compute.v1.UsableSubnetwork.StackType */ diff --git a/Compute/src/V1/UsableSubnetworkSecondaryRange.php b/Compute/src/V1/UsableSubnetworkSecondaryRange.php index c39bbac9b2d5..209d04e85156 100644 --- a/Compute/src/V1/UsableSubnetworkSecondaryRange.php +++ b/Compute/src/V1/UsableSubnetworkSecondaryRange.php @@ -22,7 +22,10 @@ class UsableSubnetworkSecondaryRange extends \Google\Protobuf\Internal\Message */ protected $ip_cidr_range = null; /** - * The name associated with this subnetwork secondary range, used when adding an alias IP range to a VM instance. The name must be 1-63 characters long, and comply with RFC1035. The name must be unique within the subnetwork. + * The name associated with this subnetwork secondary range, used when adding + * an alias IP range to a VM instance. + * The name must be 1-63 characters long, and comply withRFC1035. + * The name must be unique within the subnetwork. * * Generated from protobuf field optional string range_name = 332216397; */ @@ -37,7 +40,10 @@ class UsableSubnetworkSecondaryRange extends \Google\Protobuf\Internal\Message * @type string $ip_cidr_range * The range of IP addresses belonging to this subnetwork secondary range. * @type string $range_name - * The name associated with this subnetwork secondary range, used when adding an alias IP range to a VM instance. The name must be 1-63 characters long, and comply with RFC1035. The name must be unique within the subnetwork. + * The name associated with this subnetwork secondary range, used when adding + * an alias IP range to a VM instance. + * The name must be 1-63 characters long, and comply withRFC1035. + * The name must be unique within the subnetwork. * } */ public function __construct($data = NULL) { @@ -82,7 +88,10 @@ public function setIpCidrRange($var) } /** - * The name associated with this subnetwork secondary range, used when adding an alias IP range to a VM instance. The name must be 1-63 characters long, and comply with RFC1035. The name must be unique within the subnetwork. + * The name associated with this subnetwork secondary range, used when adding + * an alias IP range to a VM instance. + * The name must be 1-63 characters long, and comply withRFC1035. + * The name must be unique within the subnetwork. * * Generated from protobuf field optional string range_name = 332216397; * @return string @@ -103,7 +112,10 @@ public function clearRangeName() } /** - * The name associated with this subnetwork secondary range, used when adding an alias IP range to a VM instance. The name must be 1-63 characters long, and comply with RFC1035. The name must be unique within the subnetwork. + * The name associated with this subnetwork secondary range, used when adding + * an alias IP range to a VM instance. + * The name must be 1-63 characters long, and comply withRFC1035. + * The name must be unique within the subnetwork. * * Generated from protobuf field optional string range_name = 332216397; * @param string $var diff --git a/Compute/src/V1/UsableSubnetworksAggregatedList.php b/Compute/src/V1/UsableSubnetworksAggregatedList.php index 733ce4b703d1..5aa15e5b9ceb 100644 --- a/Compute/src/V1/UsableSubnetworksAggregatedList.php +++ b/Compute/src/V1/UsableSubnetworksAggregatedList.php @@ -15,7 +15,8 @@ class UsableSubnetworksAggregatedList extends \Google\Protobuf\Internal\Message { /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional string id = 3355; */ @@ -27,19 +28,27 @@ class UsableSubnetworksAggregatedList extends \Google\Protobuf\Internal\Message */ private $items; /** - * [Output Only] Type of resource. Always compute#usableSubnetworksAggregatedList for aggregated lists of usable subnetworks. + * [Output Only] Type of resource. Alwayscompute#usableSubnetworksAggregatedList for aggregated lists + * of usable subnetworks. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. In special cases listUsable may return 0 subnetworks and nextPageToken which still should be used to get the next page of results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. + * In special cases listUsable may return 0 subnetworks andnextPageToken which still should be used to get the + * next page of results. * * Generated from protobuf field optional string next_page_token = 79797525; */ protected $next_page_token = null; /** - * [Output Only] Informational warning messages for failures encountered from scopes. + * [Output Only] Informational warning messages for failures encountered from + * scopes. * * Generated from protobuf field repeated .google.cloud.compute.v1.SubnetworksScopedWarning scoped_warnings = 215878438; */ @@ -70,15 +79,24 @@ class UsableSubnetworksAggregatedList extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $id - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * @type array<\Google\Cloud\Compute\V1\UsableSubnetwork>|\Google\Protobuf\Internal\RepeatedField $items * [Output] A list of usable subnetwork URLs. * @type string $kind - * [Output Only] Type of resource. Always compute#usableSubnetworksAggregatedList for aggregated lists of usable subnetworks. + * [Output Only] Type of resource. Alwayscompute#usableSubnetworksAggregatedList for aggregated lists + * of usable subnetworks. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. In special cases listUsable may return 0 subnetworks and nextPageToken which still should be used to get the next page of results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. + * In special cases listUsable may return 0 subnetworks andnextPageToken which still should be used to get the + * next page of results. * @type array<\Google\Cloud\Compute\V1\SubnetworksScopedWarning>|\Google\Protobuf\Internal\RepeatedField $scoped_warnings - * [Output Only] Informational warning messages for failures encountered from scopes. + * [Output Only] Informational warning messages for failures encountered from + * scopes. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type array|\Google\Protobuf\Internal\RepeatedField $unreachables @@ -93,7 +111,8 @@ public function __construct($data = NULL) { } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional string id = 3355; * @return string @@ -114,7 +133,8 @@ public function clearId() } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional string id = 3355; * @param string $var @@ -155,7 +175,8 @@ public function setItems($var) } /** - * [Output Only] Type of resource. Always compute#usableSubnetworksAggregatedList for aggregated lists of usable subnetworks. + * [Output Only] Type of resource. Alwayscompute#usableSubnetworksAggregatedList for aggregated lists + * of usable subnetworks. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -176,7 +197,8 @@ public function clearKind() } /** - * [Output Only] Type of resource. Always compute#usableSubnetworksAggregatedList for aggregated lists of usable subnetworks. + * [Output Only] Type of resource. Alwayscompute#usableSubnetworksAggregatedList for aggregated lists + * of usable subnetworks. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -191,7 +213,13 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. In special cases listUsable may return 0 subnetworks and nextPageToken which still should be used to get the next page of results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. + * In special cases listUsable may return 0 subnetworks andnextPageToken which still should be used to get the + * next page of results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -212,7 +240,13 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. In special cases listUsable may return 0 subnetworks and nextPageToken which still should be used to get the next page of results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. + * In special cases listUsable may return 0 subnetworks andnextPageToken which still should be used to get the + * next page of results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var @@ -227,7 +261,8 @@ public function setNextPageToken($var) } /** - * [Output Only] Informational warning messages for failures encountered from scopes. + * [Output Only] Informational warning messages for failures encountered from + * scopes. * * Generated from protobuf field repeated .google.cloud.compute.v1.SubnetworksScopedWarning scoped_warnings = 215878438; * @return \Google\Protobuf\Internal\RepeatedField @@ -238,7 +273,8 @@ public function getScopedWarnings() } /** - * [Output Only] Informational warning messages for failures encountered from scopes. + * [Output Only] Informational warning messages for failures encountered from + * scopes. * * Generated from protobuf field repeated .google.cloud.compute.v1.SubnetworksScopedWarning scoped_warnings = 215878438; * @param array<\Google\Cloud\Compute\V1\SubnetworksScopedWarning>|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/UsageExportLocation.php b/Compute/src/V1/UsageExportLocation.php index 063bc5e2dc0b..b5df3e6f1016 100644 --- a/Compute/src/V1/UsageExportLocation.php +++ b/Compute/src/V1/UsageExportLocation.php @@ -9,20 +9,27 @@ use Google\Protobuf\Internal\GPBUtil; /** - * The location in Cloud Storage and naming method of the daily usage report. Contains bucket_name and report_name prefix. + * The location in Cloud Storage and naming method of the daily usage + * report. Contains bucket_name and report_name prefix. * * Generated from protobuf message google.cloud.compute.v1.UsageExportLocation */ class UsageExportLocation extends \Google\Protobuf\Internal\Message { /** - * The name of an existing bucket in Cloud Storage where the usage report object is stored. The Google Service Account is granted write access to this bucket. This can either be the bucket name by itself, such as example-bucket, or the bucket name with gs:// or https://storage.googleapis.com/ in front of it, such as gs://example-bucket. + * The name of an existing bucket in Cloud Storage where the usage report + * object is stored. The Google Service Account is granted write access to + * this bucket. This can either be the bucket name by itself, such asexample-bucket, or the bucket name with gs:// + * or https://storage.googleapis.com/ in front of it, such + * as gs://example-bucket. * * Generated from protobuf field optional string bucket_name = 283610048; */ protected $bucket_name = null; /** - * An optional prefix for the name of the usage report object stored in bucketName. If not supplied, defaults to usage_gce. The report is stored as a CSV file named report_name_prefix_gce_YYYYMMDD.csv where YYYYMMDD is the day of the usage according to Pacific Time. If you supply a prefix, it should conform to Cloud Storage object naming conventions. + * An optional prefix for the name of the usage report object stored inbucketName. If not supplied, defaults tousage_gce. The report is stored as a CSV file namedreport_name_prefix_gce_YYYYMMDD.csv whereYYYYMMDD is the day of the usage according to Pacific Time. + * If you supply a prefix, it should conform to Cloud Storageobject naming + * conventions. * * Generated from protobuf field optional string report_name_prefix = 320198715; */ @@ -35,9 +42,15 @@ class UsageExportLocation extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $bucket_name - * The name of an existing bucket in Cloud Storage where the usage report object is stored. The Google Service Account is granted write access to this bucket. This can either be the bucket name by itself, such as example-bucket, or the bucket name with gs:// or https://storage.googleapis.com/ in front of it, such as gs://example-bucket. + * The name of an existing bucket in Cloud Storage where the usage report + * object is stored. The Google Service Account is granted write access to + * this bucket. This can either be the bucket name by itself, such asexample-bucket, or the bucket name with gs:// + * or https://storage.googleapis.com/ in front of it, such + * as gs://example-bucket. * @type string $report_name_prefix - * An optional prefix for the name of the usage report object stored in bucketName. If not supplied, defaults to usage_gce. The report is stored as a CSV file named report_name_prefix_gce_YYYYMMDD.csv where YYYYMMDD is the day of the usage according to Pacific Time. If you supply a prefix, it should conform to Cloud Storage object naming conventions. + * An optional prefix for the name of the usage report object stored inbucketName. If not supplied, defaults tousage_gce. The report is stored as a CSV file namedreport_name_prefix_gce_YYYYMMDD.csv whereYYYYMMDD is the day of the usage according to Pacific Time. + * If you supply a prefix, it should conform to Cloud Storageobject naming + * conventions. * } */ public function __construct($data = NULL) { @@ -46,7 +59,11 @@ public function __construct($data = NULL) { } /** - * The name of an existing bucket in Cloud Storage where the usage report object is stored. The Google Service Account is granted write access to this bucket. This can either be the bucket name by itself, such as example-bucket, or the bucket name with gs:// or https://storage.googleapis.com/ in front of it, such as gs://example-bucket. + * The name of an existing bucket in Cloud Storage where the usage report + * object is stored. The Google Service Account is granted write access to + * this bucket. This can either be the bucket name by itself, such asexample-bucket, or the bucket name with gs:// + * or https://storage.googleapis.com/ in front of it, such + * as gs://example-bucket. * * Generated from protobuf field optional string bucket_name = 283610048; * @return string @@ -67,7 +84,11 @@ public function clearBucketName() } /** - * The name of an existing bucket in Cloud Storage where the usage report object is stored. The Google Service Account is granted write access to this bucket. This can either be the bucket name by itself, such as example-bucket, or the bucket name with gs:// or https://storage.googleapis.com/ in front of it, such as gs://example-bucket. + * The name of an existing bucket in Cloud Storage where the usage report + * object is stored. The Google Service Account is granted write access to + * this bucket. This can either be the bucket name by itself, such asexample-bucket, or the bucket name with gs:// + * or https://storage.googleapis.com/ in front of it, such + * as gs://example-bucket. * * Generated from protobuf field optional string bucket_name = 283610048; * @param string $var @@ -82,7 +103,9 @@ public function setBucketName($var) } /** - * An optional prefix for the name of the usage report object stored in bucketName. If not supplied, defaults to usage_gce. The report is stored as a CSV file named report_name_prefix_gce_YYYYMMDD.csv where YYYYMMDD is the day of the usage according to Pacific Time. If you supply a prefix, it should conform to Cloud Storage object naming conventions. + * An optional prefix for the name of the usage report object stored inbucketName. If not supplied, defaults tousage_gce. The report is stored as a CSV file namedreport_name_prefix_gce_YYYYMMDD.csv whereYYYYMMDD is the day of the usage according to Pacific Time. + * If you supply a prefix, it should conform to Cloud Storageobject naming + * conventions. * * Generated from protobuf field optional string report_name_prefix = 320198715; * @return string @@ -103,7 +126,9 @@ public function clearReportNamePrefix() } /** - * An optional prefix for the name of the usage report object stored in bucketName. If not supplied, defaults to usage_gce. The report is stored as a CSV file named report_name_prefix_gce_YYYYMMDD.csv where YYYYMMDD is the day of the usage according to Pacific Time. If you supply a prefix, it should conform to Cloud Storage object naming conventions. + * An optional prefix for the name of the usage report object stored inbucketName. If not supplied, defaults tousage_gce. The report is stored as a CSV file namedreport_name_prefix_gce_YYYYMMDD.csv whereYYYYMMDD is the day of the usage according to Pacific Time. + * If you supply a prefix, it should conform to Cloud Storageobject naming + * conventions. * * Generated from protobuf field optional string report_name_prefix = 320198715; * @param string $var diff --git a/Compute/src/V1/VmEndpointNatMappingsInterfaceNatMappings.php b/Compute/src/V1/VmEndpointNatMappingsInterfaceNatMappings.php index 5f3539e10a13..afa73dfdb152 100644 --- a/Compute/src/V1/VmEndpointNatMappingsInterfaceNatMappings.php +++ b/Compute/src/V1/VmEndpointNatMappingsInterfaceNatMappings.php @@ -16,25 +16,34 @@ class VmEndpointNatMappingsInterfaceNatMappings extends \Google\Protobuf\Internal\Message { /** - * List of all drain IP:port-range mappings assigned to this interface. These ranges are inclusive, that is, both the first and the last ports can be used for NAT. Example: ["2.2.2.2:12345-12355", "1.1.1.1:2234-2234"]. + * List of all drain IP:port-range mappings assigned to this interface. + * These ranges are inclusive, that is, both the first and the last + * ports can be used for NAT. Example: ["2.2.2.2:12345-12355", + * "1.1.1.1:2234-2234"]. * * Generated from protobuf field repeated string drain_nat_ip_port_ranges = 395440577; */ private $drain_nat_ip_port_ranges; /** - * A list of all IP:port-range mappings assigned to this interface. These ranges are inclusive, that is, both the first and the last ports can be used for NAT. Example: ["2.2.2.2:12345-12355", "1.1.1.1:2234-2234"]. + * A list of all IP:port-range mappings assigned to this interface. + * These ranges are inclusive, that is, both the first and the last + * ports can be used for NAT. Example: ["2.2.2.2:12345-12355", + * "1.1.1.1:2234-2234"]. * * Generated from protobuf field repeated string nat_ip_port_ranges = 531830810; */ private $nat_ip_port_ranges; /** - * Total number of drain ports across all NAT IPs allocated to this interface. It equals to the aggregated port number in the field drain_nat_ip_port_ranges. + * Total number of drain ports across all NAT IPs allocated to this + * interface. It equals to the aggregated port number in the field + * drain_nat_ip_port_ranges. * * Generated from protobuf field optional int32 num_total_drain_nat_ports = 335532793; */ protected $num_total_drain_nat_ports = null; /** - * Total number of ports across all NAT IPs allocated to this interface. It equals to the aggregated port number in the field nat_ip_port_ranges. + * Total number of ports across all NAT IPs allocated to this interface. + * It equals to the aggregated port number in the field nat_ip_port_ranges. * * Generated from protobuf field optional int32 num_total_nat_ports = 299904384; */ @@ -46,7 +55,9 @@ class VmEndpointNatMappingsInterfaceNatMappings extends \Google\Protobuf\Interna */ private $rule_mappings; /** - * Alias IP range for this interface endpoint. It will be a private (RFC 1918) IP range. Examples: "10.33.4.55/32", or "192.168.5.0/24". + * Alias IP range for this interface endpoint. + * It will be a private (RFC 1918) IP range. + * Examples: "10.33.4.55/32", or "192.168.5.0/24". * * Generated from protobuf field optional string source_alias_ip_range = 440340952; */ @@ -65,17 +76,28 @@ class VmEndpointNatMappingsInterfaceNatMappings extends \Google\Protobuf\Interna * Optional. Data for populating the Message object. * * @type array|\Google\Protobuf\Internal\RepeatedField $drain_nat_ip_port_ranges - * List of all drain IP:port-range mappings assigned to this interface. These ranges are inclusive, that is, both the first and the last ports can be used for NAT. Example: ["2.2.2.2:12345-12355", "1.1.1.1:2234-2234"]. + * List of all drain IP:port-range mappings assigned to this interface. + * These ranges are inclusive, that is, both the first and the last + * ports can be used for NAT. Example: ["2.2.2.2:12345-12355", + * "1.1.1.1:2234-2234"]. * @type array|\Google\Protobuf\Internal\RepeatedField $nat_ip_port_ranges - * A list of all IP:port-range mappings assigned to this interface. These ranges are inclusive, that is, both the first and the last ports can be used for NAT. Example: ["2.2.2.2:12345-12355", "1.1.1.1:2234-2234"]. + * A list of all IP:port-range mappings assigned to this interface. + * These ranges are inclusive, that is, both the first and the last + * ports can be used for NAT. Example: ["2.2.2.2:12345-12355", + * "1.1.1.1:2234-2234"]. * @type int $num_total_drain_nat_ports - * Total number of drain ports across all NAT IPs allocated to this interface. It equals to the aggregated port number in the field drain_nat_ip_port_ranges. + * Total number of drain ports across all NAT IPs allocated to this + * interface. It equals to the aggregated port number in the field + * drain_nat_ip_port_ranges. * @type int $num_total_nat_ports - * Total number of ports across all NAT IPs allocated to this interface. It equals to the aggregated port number in the field nat_ip_port_ranges. + * Total number of ports across all NAT IPs allocated to this interface. + * It equals to the aggregated port number in the field nat_ip_port_ranges. * @type array<\Google\Cloud\Compute\V1\VmEndpointNatMappingsInterfaceNatMappingsNatRuleMappings>|\Google\Protobuf\Internal\RepeatedField $rule_mappings * Information about mappings provided by rules in this NAT. * @type string $source_alias_ip_range - * Alias IP range for this interface endpoint. It will be a private (RFC 1918) IP range. Examples: "10.33.4.55/32", or "192.168.5.0/24". + * Alias IP range for this interface endpoint. + * It will be a private (RFC 1918) IP range. + * Examples: "10.33.4.55/32", or "192.168.5.0/24". * @type string $source_virtual_ip * Primary IP of the VM for this NIC. * } @@ -86,7 +108,10 @@ public function __construct($data = NULL) { } /** - * List of all drain IP:port-range mappings assigned to this interface. These ranges are inclusive, that is, both the first and the last ports can be used for NAT. Example: ["2.2.2.2:12345-12355", "1.1.1.1:2234-2234"]. + * List of all drain IP:port-range mappings assigned to this interface. + * These ranges are inclusive, that is, both the first and the last + * ports can be used for NAT. Example: ["2.2.2.2:12345-12355", + * "1.1.1.1:2234-2234"]. * * Generated from protobuf field repeated string drain_nat_ip_port_ranges = 395440577; * @return \Google\Protobuf\Internal\RepeatedField @@ -97,7 +122,10 @@ public function getDrainNatIpPortRanges() } /** - * List of all drain IP:port-range mappings assigned to this interface. These ranges are inclusive, that is, both the first and the last ports can be used for NAT. Example: ["2.2.2.2:12345-12355", "1.1.1.1:2234-2234"]. + * List of all drain IP:port-range mappings assigned to this interface. + * These ranges are inclusive, that is, both the first and the last + * ports can be used for NAT. Example: ["2.2.2.2:12345-12355", + * "1.1.1.1:2234-2234"]. * * Generated from protobuf field repeated string drain_nat_ip_port_ranges = 395440577; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -112,7 +140,10 @@ public function setDrainNatIpPortRanges($var) } /** - * A list of all IP:port-range mappings assigned to this interface. These ranges are inclusive, that is, both the first and the last ports can be used for NAT. Example: ["2.2.2.2:12345-12355", "1.1.1.1:2234-2234"]. + * A list of all IP:port-range mappings assigned to this interface. + * These ranges are inclusive, that is, both the first and the last + * ports can be used for NAT. Example: ["2.2.2.2:12345-12355", + * "1.1.1.1:2234-2234"]. * * Generated from protobuf field repeated string nat_ip_port_ranges = 531830810; * @return \Google\Protobuf\Internal\RepeatedField @@ -123,7 +154,10 @@ public function getNatIpPortRanges() } /** - * A list of all IP:port-range mappings assigned to this interface. These ranges are inclusive, that is, both the first and the last ports can be used for NAT. Example: ["2.2.2.2:12345-12355", "1.1.1.1:2234-2234"]. + * A list of all IP:port-range mappings assigned to this interface. + * These ranges are inclusive, that is, both the first and the last + * ports can be used for NAT. Example: ["2.2.2.2:12345-12355", + * "1.1.1.1:2234-2234"]. * * Generated from protobuf field repeated string nat_ip_port_ranges = 531830810; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -138,7 +172,9 @@ public function setNatIpPortRanges($var) } /** - * Total number of drain ports across all NAT IPs allocated to this interface. It equals to the aggregated port number in the field drain_nat_ip_port_ranges. + * Total number of drain ports across all NAT IPs allocated to this + * interface. It equals to the aggregated port number in the field + * drain_nat_ip_port_ranges. * * Generated from protobuf field optional int32 num_total_drain_nat_ports = 335532793; * @return int @@ -159,7 +195,9 @@ public function clearNumTotalDrainNatPorts() } /** - * Total number of drain ports across all NAT IPs allocated to this interface. It equals to the aggregated port number in the field drain_nat_ip_port_ranges. + * Total number of drain ports across all NAT IPs allocated to this + * interface. It equals to the aggregated port number in the field + * drain_nat_ip_port_ranges. * * Generated from protobuf field optional int32 num_total_drain_nat_ports = 335532793; * @param int $var @@ -174,7 +212,8 @@ public function setNumTotalDrainNatPorts($var) } /** - * Total number of ports across all NAT IPs allocated to this interface. It equals to the aggregated port number in the field nat_ip_port_ranges. + * Total number of ports across all NAT IPs allocated to this interface. + * It equals to the aggregated port number in the field nat_ip_port_ranges. * * Generated from protobuf field optional int32 num_total_nat_ports = 299904384; * @return int @@ -195,7 +234,8 @@ public function clearNumTotalNatPorts() } /** - * Total number of ports across all NAT IPs allocated to this interface. It equals to the aggregated port number in the field nat_ip_port_ranges. + * Total number of ports across all NAT IPs allocated to this interface. + * It equals to the aggregated port number in the field nat_ip_port_ranges. * * Generated from protobuf field optional int32 num_total_nat_ports = 299904384; * @param int $var @@ -236,7 +276,9 @@ public function setRuleMappings($var) } /** - * Alias IP range for this interface endpoint. It will be a private (RFC 1918) IP range. Examples: "10.33.4.55/32", or "192.168.5.0/24". + * Alias IP range for this interface endpoint. + * It will be a private (RFC 1918) IP range. + * Examples: "10.33.4.55/32", or "192.168.5.0/24". * * Generated from protobuf field optional string source_alias_ip_range = 440340952; * @return string @@ -257,7 +299,9 @@ public function clearSourceAliasIpRange() } /** - * Alias IP range for this interface endpoint. It will be a private (RFC 1918) IP range. Examples: "10.33.4.55/32", or "192.168.5.0/24". + * Alias IP range for this interface endpoint. + * It will be a private (RFC 1918) IP range. + * Examples: "10.33.4.55/32", or "192.168.5.0/24". * * Generated from protobuf field optional string source_alias_ip_range = 440340952; * @param string $var diff --git a/Compute/src/V1/VmEndpointNatMappingsInterfaceNatMappingsNatRuleMappings.php b/Compute/src/V1/VmEndpointNatMappingsInterfaceNatMappingsNatRuleMappings.php index a476d240816d..a6179948f1d0 100644 --- a/Compute/src/V1/VmEndpointNatMappingsInterfaceNatMappingsNatRuleMappings.php +++ b/Compute/src/V1/VmEndpointNatMappingsInterfaceNatMappingsNatRuleMappings.php @@ -16,25 +16,38 @@ class VmEndpointNatMappingsInterfaceNatMappingsNatRuleMappings extends \Google\Protobuf\Internal\Message { /** - * List of all drain IP:port-range mappings assigned to this interface by this rule. These ranges are inclusive, that is, both the first and the last ports can be used for NAT. Example: ["2.2.2.2:12345-12355", "1.1.1.1:2234-2234"]. + * List of all drain IP:port-range mappings assigned to this interface + * by this rule. + * These ranges are inclusive, that is, both the first and the last + * ports can be used for NAT. Example: ["2.2.2.2:12345-12355", + * "1.1.1.1:2234-2234"]. * * Generated from protobuf field repeated string drain_nat_ip_port_ranges = 395440577; */ private $drain_nat_ip_port_ranges; /** - * A list of all IP:port-range mappings assigned to this interface by this rule. These ranges are inclusive, that is, both the first and the last ports can be used for NAT. Example: ["2.2.2.2:12345-12355", "1.1.1.1:2234-2234"]. + * A list of all IP:port-range mappings assigned to this interface by this + * rule. + * These ranges are inclusive, that is, both the first and the last + * ports can be used for NAT. Example: ["2.2.2.2:12345-12355", + * "1.1.1.1:2234-2234"]. * * Generated from protobuf field repeated string nat_ip_port_ranges = 531830810; */ private $nat_ip_port_ranges; /** - * Total number of drain ports across all NAT IPs allocated to this interface by this rule. It equals the aggregated port number in the field drain_nat_ip_port_ranges. + * Total number of drain ports across all NAT IPs allocated to this + * interface by this rule. + * It equals the aggregated port number in the field + * drain_nat_ip_port_ranges. * * Generated from protobuf field optional int32 num_total_drain_nat_ports = 335532793; */ protected $num_total_drain_nat_ports = null; /** - * Total number of ports across all NAT IPs allocated to this interface by this rule. It equals the aggregated port number in the field nat_ip_port_ranges. + * Total number of ports across all NAT IPs allocated to this interface + * by this rule. + * It equals the aggregated port number in the field nat_ip_port_ranges. * * Generated from protobuf field optional int32 num_total_nat_ports = 299904384; */ @@ -53,13 +66,26 @@ class VmEndpointNatMappingsInterfaceNatMappingsNatRuleMappings extends \Google\P * Optional. Data for populating the Message object. * * @type array|\Google\Protobuf\Internal\RepeatedField $drain_nat_ip_port_ranges - * List of all drain IP:port-range mappings assigned to this interface by this rule. These ranges are inclusive, that is, both the first and the last ports can be used for NAT. Example: ["2.2.2.2:12345-12355", "1.1.1.1:2234-2234"]. + * List of all drain IP:port-range mappings assigned to this interface + * by this rule. + * These ranges are inclusive, that is, both the first and the last + * ports can be used for NAT. Example: ["2.2.2.2:12345-12355", + * "1.1.1.1:2234-2234"]. * @type array|\Google\Protobuf\Internal\RepeatedField $nat_ip_port_ranges - * A list of all IP:port-range mappings assigned to this interface by this rule. These ranges are inclusive, that is, both the first and the last ports can be used for NAT. Example: ["2.2.2.2:12345-12355", "1.1.1.1:2234-2234"]. + * A list of all IP:port-range mappings assigned to this interface by this + * rule. + * These ranges are inclusive, that is, both the first and the last + * ports can be used for NAT. Example: ["2.2.2.2:12345-12355", + * "1.1.1.1:2234-2234"]. * @type int $num_total_drain_nat_ports - * Total number of drain ports across all NAT IPs allocated to this interface by this rule. It equals the aggregated port number in the field drain_nat_ip_port_ranges. + * Total number of drain ports across all NAT IPs allocated to this + * interface by this rule. + * It equals the aggregated port number in the field + * drain_nat_ip_port_ranges. * @type int $num_total_nat_ports - * Total number of ports across all NAT IPs allocated to this interface by this rule. It equals the aggregated port number in the field nat_ip_port_ranges. + * Total number of ports across all NAT IPs allocated to this interface + * by this rule. + * It equals the aggregated port number in the field nat_ip_port_ranges. * @type int $rule_number * Rule number of the NAT Rule. * } @@ -70,7 +96,11 @@ public function __construct($data = NULL) { } /** - * List of all drain IP:port-range mappings assigned to this interface by this rule. These ranges are inclusive, that is, both the first and the last ports can be used for NAT. Example: ["2.2.2.2:12345-12355", "1.1.1.1:2234-2234"]. + * List of all drain IP:port-range mappings assigned to this interface + * by this rule. + * These ranges are inclusive, that is, both the first and the last + * ports can be used for NAT. Example: ["2.2.2.2:12345-12355", + * "1.1.1.1:2234-2234"]. * * Generated from protobuf field repeated string drain_nat_ip_port_ranges = 395440577; * @return \Google\Protobuf\Internal\RepeatedField @@ -81,7 +111,11 @@ public function getDrainNatIpPortRanges() } /** - * List of all drain IP:port-range mappings assigned to this interface by this rule. These ranges are inclusive, that is, both the first and the last ports can be used for NAT. Example: ["2.2.2.2:12345-12355", "1.1.1.1:2234-2234"]. + * List of all drain IP:port-range mappings assigned to this interface + * by this rule. + * These ranges are inclusive, that is, both the first and the last + * ports can be used for NAT. Example: ["2.2.2.2:12345-12355", + * "1.1.1.1:2234-2234"]. * * Generated from protobuf field repeated string drain_nat_ip_port_ranges = 395440577; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -96,7 +130,11 @@ public function setDrainNatIpPortRanges($var) } /** - * A list of all IP:port-range mappings assigned to this interface by this rule. These ranges are inclusive, that is, both the first and the last ports can be used for NAT. Example: ["2.2.2.2:12345-12355", "1.1.1.1:2234-2234"]. + * A list of all IP:port-range mappings assigned to this interface by this + * rule. + * These ranges are inclusive, that is, both the first and the last + * ports can be used for NAT. Example: ["2.2.2.2:12345-12355", + * "1.1.1.1:2234-2234"]. * * Generated from protobuf field repeated string nat_ip_port_ranges = 531830810; * @return \Google\Protobuf\Internal\RepeatedField @@ -107,7 +145,11 @@ public function getNatIpPortRanges() } /** - * A list of all IP:port-range mappings assigned to this interface by this rule. These ranges are inclusive, that is, both the first and the last ports can be used for NAT. Example: ["2.2.2.2:12345-12355", "1.1.1.1:2234-2234"]. + * A list of all IP:port-range mappings assigned to this interface by this + * rule. + * These ranges are inclusive, that is, both the first and the last + * ports can be used for NAT. Example: ["2.2.2.2:12345-12355", + * "1.1.1.1:2234-2234"]. * * Generated from protobuf field repeated string nat_ip_port_ranges = 531830810; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -122,7 +164,10 @@ public function setNatIpPortRanges($var) } /** - * Total number of drain ports across all NAT IPs allocated to this interface by this rule. It equals the aggregated port number in the field drain_nat_ip_port_ranges. + * Total number of drain ports across all NAT IPs allocated to this + * interface by this rule. + * It equals the aggregated port number in the field + * drain_nat_ip_port_ranges. * * Generated from protobuf field optional int32 num_total_drain_nat_ports = 335532793; * @return int @@ -143,7 +188,10 @@ public function clearNumTotalDrainNatPorts() } /** - * Total number of drain ports across all NAT IPs allocated to this interface by this rule. It equals the aggregated port number in the field drain_nat_ip_port_ranges. + * Total number of drain ports across all NAT IPs allocated to this + * interface by this rule. + * It equals the aggregated port number in the field + * drain_nat_ip_port_ranges. * * Generated from protobuf field optional int32 num_total_drain_nat_ports = 335532793; * @param int $var @@ -158,7 +206,9 @@ public function setNumTotalDrainNatPorts($var) } /** - * Total number of ports across all NAT IPs allocated to this interface by this rule. It equals the aggregated port number in the field nat_ip_port_ranges. + * Total number of ports across all NAT IPs allocated to this interface + * by this rule. + * It equals the aggregated port number in the field nat_ip_port_ranges. * * Generated from protobuf field optional int32 num_total_nat_ports = 299904384; * @return int @@ -179,7 +229,9 @@ public function clearNumTotalNatPorts() } /** - * Total number of ports across all NAT IPs allocated to this interface by this rule. It equals the aggregated port number in the field nat_ip_port_ranges. + * Total number of ports across all NAT IPs allocated to this interface + * by this rule. + * It equals the aggregated port number in the field nat_ip_port_ranges. * * Generated from protobuf field optional int32 num_total_nat_ports = 299904384; * @param int $var diff --git a/Compute/src/V1/VmEndpointNatMappingsList.php b/Compute/src/V1/VmEndpointNatMappingsList.php index 408901e98ba1..f6eb35bee11e 100644 --- a/Compute/src/V1/VmEndpointNatMappingsList.php +++ b/Compute/src/V1/VmEndpointNatMappingsList.php @@ -16,19 +16,25 @@ class VmEndpointNatMappingsList extends \Google\Protobuf\Internal\Message { /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional string id = 3355; */ protected $id = null; /** - * [Output Only] Type of resource. Always compute#vmEndpointNatMappingsList for lists of Nat mappings of VM endpoints. + * [Output Only] Type of resource. Alwayscompute#vmEndpointNatMappingsList for lists of Nat mappings of + * VM endpoints. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -59,11 +65,17 @@ class VmEndpointNatMappingsList extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $id - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * @type string $kind - * [Output Only] Type of resource. Always compute#vmEndpointNatMappingsList for lists of Nat mappings of VM endpoints. + * [Output Only] Type of resource. Alwayscompute#vmEndpointNatMappingsList for lists of Nat mappings of + * VM endpoints. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type array<\Google\Cloud\Compute\V1\VmEndpointNatMappings>|\Google\Protobuf\Internal\RepeatedField $result * [Output Only] A list of Nat mapping information of VM endpoints. * @type string $self_link @@ -78,7 +90,8 @@ public function __construct($data = NULL) { } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional string id = 3355; * @return string @@ -99,7 +112,8 @@ public function clearId() } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional string id = 3355; * @param string $var @@ -114,7 +128,8 @@ public function setId($var) } /** - * [Output Only] Type of resource. Always compute#vmEndpointNatMappingsList for lists of Nat mappings of VM endpoints. + * [Output Only] Type of resource. Alwayscompute#vmEndpointNatMappingsList for lists of Nat mappings of + * VM endpoints. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -135,7 +150,8 @@ public function clearKind() } /** - * [Output Only] Type of resource. Always compute#vmEndpointNatMappingsList for lists of Nat mappings of VM endpoints. + * [Output Only] Type of resource. Alwayscompute#vmEndpointNatMappingsList for lists of Nat mappings of + * VM endpoints. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -150,7 +166,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -171,7 +191,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/VpnGateway.php b/Compute/src/V1/VpnGateway.php index 293a5a2297df..3d364f68aa5c 100644 --- a/Compute/src/V1/VpnGateway.php +++ b/Compute/src/V1/VpnGateway.php @@ -9,63 +9,88 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Represents a HA VPN gateway. HA VPN is a high-availability (HA) Cloud VPN solution that lets you securely connect your on-premises network to your Google Cloud Virtual Private Cloud network through an IPsec VPN connection in a single region. For more information about Cloud HA VPN solutions, see Cloud VPN topologies . + * Represents a HA VPN gateway. + * HA VPN is a high-availability (HA) Cloud VPN solution that lets you securely + * connect your on-premises network to your Google Cloud Virtual Private Cloud + * network through an IPsec VPN connection in a single region. + * For more information about Cloud HA VPN solutions, see + * Cloud VPN topologies . * * Generated from protobuf message google.cloud.compute.v1.VpnGateway */ class VpnGateway extends \Google\Protobuf\Internal\Message { /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; */ protected $creation_timestamp = null; /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; */ protected $description = null; /** - * The IP family of the gateway IPs for the HA-VPN gateway interfaces. If not specified, IPV4 will be used. + * The IP family of the gateway IPs for the HA-VPN gateway interfaces. If not + * specified, IPV4 will be used. * Check the GatewayIpVersion enum for the list of possible values. * * Generated from protobuf field optional string gateway_ip_version = 65074843; */ protected $gateway_ip_version = null; /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; */ protected $id = null; /** - * [Output Only] Type of resource. Always compute#vpnGateway for VPN gateways. + * [Output Only] Type of resource. Always compute#vpnGateway for + * VPN gateways. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * A fingerprint for the labels being applied to this VpnGateway, which is essentially a hash of the labels set used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a VpnGateway. + * A fingerprint for the labels being applied to this VpnGateway, which + * is essentially a hash of the labels set used for optimistic locking. The + * fingerprint is initially generated by Compute Engine and changes after + * every request to modify or update labels. You must always provide an + * up-to-date fingerprint hash in order to update or change labels, + * otherwise the request will fail with error412 conditionNotMet. + * To see the latest fingerprint, make a get() request to + * retrieve a VpnGateway. * * Generated from protobuf field optional string label_fingerprint = 178124825; */ protected $label_fingerprint = null; /** - * Labels for this resource. These can only be added or modified by the setLabels method. Each label key/value pair must comply with RFC1035. Label values may be empty. + * Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035. + * Label values may be empty. * * Generated from protobuf field map labels = 500195327; */ private $labels; /** - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * * Generated from protobuf field optional string name = 3373707; */ protected $name = null; /** - * URL of the network to which this VPN gateway is attached. Provided by the client when the VPN gateway is created. + * URL of the network to which this VPN gateway is attached. Provided by the + * client when the VPN gateway is created. * * Generated from protobuf field optional string network = 232872494; */ @@ -83,7 +108,8 @@ class VpnGateway extends \Google\Protobuf\Internal\Message */ protected $self_link = null; /** - * The stack type for this VPN gateway to identify the IP protocols that are enabled. Possible values are: IPV4_ONLY, IPV4_IPV6, IPV6_ONLY. If not specified, IPV4_ONLY is used if the gateway IP version is IPV4, or IPV4_IPV6 if the gateway IP version is IPV6. + * The stack type for this VPN gateway to identify the IP protocols that are + * enabled. Possible values are: IPV4_ONLY,IPV4_IPV6, IPV6_ONLY. If not specified,IPV4_ONLY is used if the gateway IP version isIPV4, or IPV4_IPV6 if the gateway IP version isIPV6. * Check the StackType enum for the list of possible values. * * Generated from protobuf field optional string stack_type = 425908881; @@ -103,30 +129,51 @@ class VpnGateway extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $creation_timestamp - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * @type string $description - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * @type string $gateway_ip_version - * The IP family of the gateway IPs for the HA-VPN gateway interfaces. If not specified, IPV4 will be used. + * The IP family of the gateway IPs for the HA-VPN gateway interfaces. If not + * specified, IPV4 will be used. * Check the GatewayIpVersion enum for the list of possible values. * @type int|string $id - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * @type string $kind - * [Output Only] Type of resource. Always compute#vpnGateway for VPN gateways. + * [Output Only] Type of resource. Always compute#vpnGateway for + * VPN gateways. * @type string $label_fingerprint - * A fingerprint for the labels being applied to this VpnGateway, which is essentially a hash of the labels set used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a VpnGateway. + * A fingerprint for the labels being applied to this VpnGateway, which + * is essentially a hash of the labels set used for optimistic locking. The + * fingerprint is initially generated by Compute Engine and changes after + * every request to modify or update labels. You must always provide an + * up-to-date fingerprint hash in order to update or change labels, + * otherwise the request will fail with error412 conditionNotMet. + * To see the latest fingerprint, make a get() request to + * retrieve a VpnGateway. * @type array|\Google\Protobuf\Internal\MapField $labels - * Labels for this resource. These can only be added or modified by the setLabels method. Each label key/value pair must comply with RFC1035. Label values may be empty. + * Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035. + * Label values may be empty. * @type string $name - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * @type string $network - * URL of the network to which this VPN gateway is attached. Provided by the client when the VPN gateway is created. + * URL of the network to which this VPN gateway is attached. Provided by the + * client when the VPN gateway is created. * @type string $region * [Output Only] URL of the region where the VPN gateway resides. * @type string $self_link * [Output Only] Server-defined URL for the resource. * @type string $stack_type - * The stack type for this VPN gateway to identify the IP protocols that are enabled. Possible values are: IPV4_ONLY, IPV4_IPV6, IPV6_ONLY. If not specified, IPV4_ONLY is used if the gateway IP version is IPV4, or IPV4_IPV6 if the gateway IP version is IPV6. + * The stack type for this VPN gateway to identify the IP protocols that are + * enabled. Possible values are: IPV4_ONLY,IPV4_IPV6, IPV6_ONLY. If not specified,IPV4_ONLY is used if the gateway IP version isIPV4, or IPV4_IPV6 if the gateway IP version isIPV6. * Check the StackType enum for the list of possible values. * @type array<\Google\Cloud\Compute\V1\VpnGatewayVpnGatewayInterface>|\Google\Protobuf\Internal\RepeatedField $vpn_interfaces * The list of VPN interfaces associated with this VPN gateway. @@ -138,7 +185,8 @@ public function __construct($data = NULL) { } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @return string @@ -159,7 +207,8 @@ public function clearCreationTimestamp() } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @param string $var @@ -174,7 +223,8 @@ public function setCreationTimestamp($var) } /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @return string @@ -195,7 +245,8 @@ public function clearDescription() } /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @param string $var @@ -210,7 +261,8 @@ public function setDescription($var) } /** - * The IP family of the gateway IPs for the HA-VPN gateway interfaces. If not specified, IPV4 will be used. + * The IP family of the gateway IPs for the HA-VPN gateway interfaces. If not + * specified, IPV4 will be used. * Check the GatewayIpVersion enum for the list of possible values. * * Generated from protobuf field optional string gateway_ip_version = 65074843; @@ -232,7 +284,8 @@ public function clearGatewayIpVersion() } /** - * The IP family of the gateway IPs for the HA-VPN gateway interfaces. If not specified, IPV4 will be used. + * The IP family of the gateway IPs for the HA-VPN gateway interfaces. If not + * specified, IPV4 will be used. * Check the GatewayIpVersion enum for the list of possible values. * * Generated from protobuf field optional string gateway_ip_version = 65074843; @@ -248,7 +301,8 @@ public function setGatewayIpVersion($var) } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @return int|string @@ -269,7 +323,8 @@ public function clearId() } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @param int|string $var @@ -284,7 +339,8 @@ public function setId($var) } /** - * [Output Only] Type of resource. Always compute#vpnGateway for VPN gateways. + * [Output Only] Type of resource. Always compute#vpnGateway for + * VPN gateways. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -305,7 +361,8 @@ public function clearKind() } /** - * [Output Only] Type of resource. Always compute#vpnGateway for VPN gateways. + * [Output Only] Type of resource. Always compute#vpnGateway for + * VPN gateways. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -320,7 +377,14 @@ public function setKind($var) } /** - * A fingerprint for the labels being applied to this VpnGateway, which is essentially a hash of the labels set used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a VpnGateway. + * A fingerprint for the labels being applied to this VpnGateway, which + * is essentially a hash of the labels set used for optimistic locking. The + * fingerprint is initially generated by Compute Engine and changes after + * every request to modify or update labels. You must always provide an + * up-to-date fingerprint hash in order to update or change labels, + * otherwise the request will fail with error412 conditionNotMet. + * To see the latest fingerprint, make a get() request to + * retrieve a VpnGateway. * * Generated from protobuf field optional string label_fingerprint = 178124825; * @return string @@ -341,7 +405,14 @@ public function clearLabelFingerprint() } /** - * A fingerprint for the labels being applied to this VpnGateway, which is essentially a hash of the labels set used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a VpnGateway. + * A fingerprint for the labels being applied to this VpnGateway, which + * is essentially a hash of the labels set used for optimistic locking. The + * fingerprint is initially generated by Compute Engine and changes after + * every request to modify or update labels. You must always provide an + * up-to-date fingerprint hash in order to update or change labels, + * otherwise the request will fail with error412 conditionNotMet. + * To see the latest fingerprint, make a get() request to + * retrieve a VpnGateway. * * Generated from protobuf field optional string label_fingerprint = 178124825; * @param string $var @@ -356,7 +427,8 @@ public function setLabelFingerprint($var) } /** - * Labels for this resource. These can only be added or modified by the setLabels method. Each label key/value pair must comply with RFC1035. Label values may be empty. + * Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035. + * Label values may be empty. * * Generated from protobuf field map labels = 500195327; * @return \Google\Protobuf\Internal\MapField @@ -367,7 +439,8 @@ public function getLabels() } /** - * Labels for this resource. These can only be added or modified by the setLabels method. Each label key/value pair must comply with RFC1035. Label values may be empty. + * Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035. + * Label values may be empty. * * Generated from protobuf field map labels = 500195327; * @param array|\Google\Protobuf\Internal\MapField $var @@ -382,7 +455,13 @@ public function setLabels($var) } /** - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * * Generated from protobuf field optional string name = 3373707; * @return string @@ -403,7 +482,13 @@ public function clearName() } /** - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * * Generated from protobuf field optional string name = 3373707; * @param string $var @@ -418,7 +503,8 @@ public function setName($var) } /** - * URL of the network to which this VPN gateway is attached. Provided by the client when the VPN gateway is created. + * URL of the network to which this VPN gateway is attached. Provided by the + * client when the VPN gateway is created. * * Generated from protobuf field optional string network = 232872494; * @return string @@ -439,7 +525,8 @@ public function clearNetwork() } /** - * URL of the network to which this VPN gateway is attached. Provided by the client when the VPN gateway is created. + * URL of the network to which this VPN gateway is attached. Provided by the + * client when the VPN gateway is created. * * Generated from protobuf field optional string network = 232872494; * @param string $var @@ -526,7 +613,8 @@ public function setSelfLink($var) } /** - * The stack type for this VPN gateway to identify the IP protocols that are enabled. Possible values are: IPV4_ONLY, IPV4_IPV6, IPV6_ONLY. If not specified, IPV4_ONLY is used if the gateway IP version is IPV4, or IPV4_IPV6 if the gateway IP version is IPV6. + * The stack type for this VPN gateway to identify the IP protocols that are + * enabled. Possible values are: IPV4_ONLY,IPV4_IPV6, IPV6_ONLY. If not specified,IPV4_ONLY is used if the gateway IP version isIPV4, or IPV4_IPV6 if the gateway IP version isIPV6. * Check the StackType enum for the list of possible values. * * Generated from protobuf field optional string stack_type = 425908881; @@ -548,7 +636,8 @@ public function clearStackType() } /** - * The stack type for this VPN gateway to identify the IP protocols that are enabled. Possible values are: IPV4_ONLY, IPV4_IPV6, IPV6_ONLY. If not specified, IPV4_ONLY is used if the gateway IP version is IPV4, or IPV4_IPV6 if the gateway IP version is IPV6. + * The stack type for this VPN gateway to identify the IP protocols that are + * enabled. Possible values are: IPV4_ONLY,IPV4_IPV6, IPV6_ONLY. If not specified,IPV4_ONLY is used if the gateway IP version isIPV4, or IPV4_IPV6 if the gateway IP version isIPV6. * Check the StackType enum for the list of possible values. * * Generated from protobuf field optional string stack_type = 425908881; diff --git a/Compute/src/V1/VpnGateway/GatewayIpVersion.php b/Compute/src/V1/VpnGateway/GatewayIpVersion.php index 1aaf797de42d..ed5e8bfec1f8 100644 --- a/Compute/src/V1/VpnGateway/GatewayIpVersion.php +++ b/Compute/src/V1/VpnGateway/GatewayIpVersion.php @@ -7,7 +7,8 @@ use UnexpectedValueException; /** - * The IP family of the gateway IPs for the HA-VPN gateway interfaces. If not specified, IPV4 will be used. + * The IP family of the gateway IPs for the HA-VPN gateway interfaces. If not + * specified, IPV4 will be used. * * Protobuf type google.cloud.compute.v1.VpnGateway.GatewayIpVersion */ diff --git a/Compute/src/V1/VpnGateway/StackType.php b/Compute/src/V1/VpnGateway/StackType.php index d672cbc2762f..2f8fa00c554b 100644 --- a/Compute/src/V1/VpnGateway/StackType.php +++ b/Compute/src/V1/VpnGateway/StackType.php @@ -7,7 +7,8 @@ use UnexpectedValueException; /** - * The stack type for this VPN gateway to identify the IP protocols that are enabled. Possible values are: IPV4_ONLY, IPV4_IPV6, IPV6_ONLY. If not specified, IPV4_ONLY is used if the gateway IP version is IPV4, or IPV4_IPV6 if the gateway IP version is IPV6. + * The stack type for this VPN gateway to identify the IP protocols that are + * enabled. Possible values are: IPV4_ONLY,IPV4_IPV6, IPV6_ONLY. If not specified,IPV4_ONLY is used if the gateway IP version isIPV4, or IPV4_IPV6 if the gateway IP version isIPV6. * * Protobuf type google.cloud.compute.v1.VpnGateway.StackType */ diff --git a/Compute/src/V1/VpnGatewayAggregatedList.php b/Compute/src/V1/VpnGatewayAggregatedList.php index 48ab61859ccd..ed58fc248b98 100644 --- a/Compute/src/V1/VpnGatewayAggregatedList.php +++ b/Compute/src/V1/VpnGatewayAggregatedList.php @@ -27,13 +27,18 @@ class VpnGatewayAggregatedList extends \Google\Protobuf\Internal\Message */ private $items; /** - * [Output Only] Type of resource. Always compute#vpnGateway for VPN gateways. + * [Output Only] Type of resource. Always compute#vpnGateway for + * VPN gateways. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -68,9 +73,14 @@ class VpnGatewayAggregatedList extends \Google\Protobuf\Internal\Message * @type array|\Google\Protobuf\Internal\MapField $items * A list of VpnGateway resources. * @type string $kind - * [Output Only] Type of resource. Always compute#vpnGateway for VPN gateways. + * [Output Only] Type of resource. Always compute#vpnGateway for + * VPN gateways. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type array|\Google\Protobuf\Internal\RepeatedField $unreachables @@ -147,7 +157,8 @@ public function setItems($var) } /** - * [Output Only] Type of resource. Always compute#vpnGateway for VPN gateways. + * [Output Only] Type of resource. Always compute#vpnGateway for + * VPN gateways. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -168,7 +179,8 @@ public function clearKind() } /** - * [Output Only] Type of resource. Always compute#vpnGateway for VPN gateways. + * [Output Only] Type of resource. Always compute#vpnGateway for + * VPN gateways. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -183,7 +195,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -204,7 +220,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/VpnGatewayList.php b/Compute/src/V1/VpnGatewayList.php index e8f3c09a57f8..ce11616770f1 100644 --- a/Compute/src/V1/VpnGatewayList.php +++ b/Compute/src/V1/VpnGatewayList.php @@ -28,13 +28,18 @@ class VpnGatewayList extends \Google\Protobuf\Internal\Message */ private $items; /** - * [Output Only] Type of resource. Always compute#vpnGateway for VPN gateways. + * [Output Only] Type of resource. Always compute#vpnGateway for + * VPN gateways. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -63,9 +68,14 @@ class VpnGatewayList extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\VpnGateway>|\Google\Protobuf\Internal\RepeatedField $items * A list of VpnGateway resources. * @type string $kind - * [Output Only] Type of resource. Always compute#vpnGateway for VPN gateways. + * [Output Only] Type of resource. Always compute#vpnGateway for + * VPN gateways. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type \Google\Cloud\Compute\V1\Warning $warning @@ -140,7 +150,8 @@ public function setItems($var) } /** - * [Output Only] Type of resource. Always compute#vpnGateway for VPN gateways. + * [Output Only] Type of resource. Always compute#vpnGateway for + * VPN gateways. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -161,7 +172,8 @@ public function clearKind() } /** - * [Output Only] Type of resource. Always compute#vpnGateway for VPN gateways. + * [Output Only] Type of resource. Always compute#vpnGateway for + * VPN gateways. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -176,7 +188,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -197,7 +213,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/VpnGatewayStatusHighAvailabilityRequirementState.php b/Compute/src/V1/VpnGatewayStatusHighAvailabilityRequirementState.php index fd2c5c8dab40..1be211e2be78 100644 --- a/Compute/src/V1/VpnGatewayStatusHighAvailabilityRequirementState.php +++ b/Compute/src/V1/VpnGatewayStatusHighAvailabilityRequirementState.php @@ -9,21 +9,25 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Describes the high availability requirement state for the VPN connection between this Cloud VPN gateway and a peer gateway. + * Describes the high availability requirement state for the VPN connection + * between this Cloud VPN gateway and a peer gateway. * * Generated from protobuf message google.cloud.compute.v1.VpnGatewayStatusHighAvailabilityRequirementState */ class VpnGatewayStatusHighAvailabilityRequirementState extends \Google\Protobuf\Internal\Message { /** - * Indicates the high availability requirement state for the VPN connection. Valid values are CONNECTION_REDUNDANCY_MET, CONNECTION_REDUNDANCY_NOT_MET. + * Indicates the high availability requirement state for the VPN connection. + * Valid values are CONNECTION_REDUNDANCY_MET,CONNECTION_REDUNDANCY_NOT_MET. * Check the State enum for the list of possible values. * * Generated from protobuf field optional string state = 109757585; */ protected $state = null; /** - * Indicates the reason why the VPN connection does not meet the high availability redundancy criteria/requirement. Valid values is INCOMPLETE_TUNNELS_COVERAGE. + * Indicates the reason why the VPN connection does not meet the high + * availability redundancy criteria/requirement. + * Valid values is INCOMPLETE_TUNNELS_COVERAGE. * Check the UnsatisfiedReason enum for the list of possible values. * * Generated from protobuf field optional string unsatisfied_reason = 55016330; @@ -37,10 +41,13 @@ class VpnGatewayStatusHighAvailabilityRequirementState extends \Google\Protobuf\ * Optional. Data for populating the Message object. * * @type string $state - * Indicates the high availability requirement state for the VPN connection. Valid values are CONNECTION_REDUNDANCY_MET, CONNECTION_REDUNDANCY_NOT_MET. + * Indicates the high availability requirement state for the VPN connection. + * Valid values are CONNECTION_REDUNDANCY_MET,CONNECTION_REDUNDANCY_NOT_MET. * Check the State enum for the list of possible values. * @type string $unsatisfied_reason - * Indicates the reason why the VPN connection does not meet the high availability redundancy criteria/requirement. Valid values is INCOMPLETE_TUNNELS_COVERAGE. + * Indicates the reason why the VPN connection does not meet the high + * availability redundancy criteria/requirement. + * Valid values is INCOMPLETE_TUNNELS_COVERAGE. * Check the UnsatisfiedReason enum for the list of possible values. * } */ @@ -50,7 +57,8 @@ public function __construct($data = NULL) { } /** - * Indicates the high availability requirement state for the VPN connection. Valid values are CONNECTION_REDUNDANCY_MET, CONNECTION_REDUNDANCY_NOT_MET. + * Indicates the high availability requirement state for the VPN connection. + * Valid values are CONNECTION_REDUNDANCY_MET,CONNECTION_REDUNDANCY_NOT_MET. * Check the State enum for the list of possible values. * * Generated from protobuf field optional string state = 109757585; @@ -72,7 +80,8 @@ public function clearState() } /** - * Indicates the high availability requirement state for the VPN connection. Valid values are CONNECTION_REDUNDANCY_MET, CONNECTION_REDUNDANCY_NOT_MET. + * Indicates the high availability requirement state for the VPN connection. + * Valid values are CONNECTION_REDUNDANCY_MET,CONNECTION_REDUNDANCY_NOT_MET. * Check the State enum for the list of possible values. * * Generated from protobuf field optional string state = 109757585; @@ -88,7 +97,9 @@ public function setState($var) } /** - * Indicates the reason why the VPN connection does not meet the high availability redundancy criteria/requirement. Valid values is INCOMPLETE_TUNNELS_COVERAGE. + * Indicates the reason why the VPN connection does not meet the high + * availability redundancy criteria/requirement. + * Valid values is INCOMPLETE_TUNNELS_COVERAGE. * Check the UnsatisfiedReason enum for the list of possible values. * * Generated from protobuf field optional string unsatisfied_reason = 55016330; @@ -110,7 +121,9 @@ public function clearUnsatisfiedReason() } /** - * Indicates the reason why the VPN connection does not meet the high availability redundancy criteria/requirement. Valid values is INCOMPLETE_TUNNELS_COVERAGE. + * Indicates the reason why the VPN connection does not meet the high + * availability redundancy criteria/requirement. + * Valid values is INCOMPLETE_TUNNELS_COVERAGE. * Check the UnsatisfiedReason enum for the list of possible values. * * Generated from protobuf field optional string unsatisfied_reason = 55016330; diff --git a/Compute/src/V1/VpnGatewayStatusHighAvailabilityRequirementState/State.php b/Compute/src/V1/VpnGatewayStatusHighAvailabilityRequirementState/State.php index 32f74de1086d..857754810db5 100644 --- a/Compute/src/V1/VpnGatewayStatusHighAvailabilityRequirementState/State.php +++ b/Compute/src/V1/VpnGatewayStatusHighAvailabilityRequirementState/State.php @@ -7,7 +7,8 @@ use UnexpectedValueException; /** - * Indicates the high availability requirement state for the VPN connection. Valid values are CONNECTION_REDUNDANCY_MET, CONNECTION_REDUNDANCY_NOT_MET. + * Indicates the high availability requirement state for the VPN connection. + * Valid values are CONNECTION_REDUNDANCY_MET,CONNECTION_REDUNDANCY_NOT_MET. * * Protobuf type google.cloud.compute.v1.VpnGatewayStatusHighAvailabilityRequirementState.State */ @@ -20,13 +21,19 @@ class State */ const UNDEFINED_STATE = 0; /** - * VPN tunnels are configured with adequate redundancy from Cloud VPN gateway to the peer VPN gateway. For both GCP-to-non-GCP and GCP-to-GCP connections, the adequate redundancy is a pre-requirement for users to get 99.99% availability on GCP side; please note that for any connection, end-to-end 99.99% availability is subject to proper configuration on the peer VPN gateway. + * VPN tunnels are configured with adequate redundancy from Cloud VPN + * gateway to the peer VPN gateway. For both GCP-to-non-GCP and GCP-to-GCP + * connections, the adequate redundancy is a pre-requirement for users to + * get 99.99% availability on GCP side; please note that for any + * connection, end-to-end 99.99% availability is subject to proper + * configuration on the peer VPN gateway. * * Generated from protobuf enum CONNECTION_REDUNDANCY_MET = 505242907; */ const CONNECTION_REDUNDANCY_MET = 505242907; /** - * VPN tunnels are not configured with adequate redundancy from the Cloud VPN gateway to the peer gateway + * VPN tunnels are not configured with adequate redundancy from the Cloud + * VPN gateway to the peer gateway * * Generated from protobuf enum CONNECTION_REDUNDANCY_NOT_MET = 511863311; */ diff --git a/Compute/src/V1/VpnGatewayStatusHighAvailabilityRequirementState/UnsatisfiedReason.php b/Compute/src/V1/VpnGatewayStatusHighAvailabilityRequirementState/UnsatisfiedReason.php index 11775bc9d58f..68fe8eca8944 100644 --- a/Compute/src/V1/VpnGatewayStatusHighAvailabilityRequirementState/UnsatisfiedReason.php +++ b/Compute/src/V1/VpnGatewayStatusHighAvailabilityRequirementState/UnsatisfiedReason.php @@ -7,7 +7,9 @@ use UnexpectedValueException; /** - * Indicates the reason why the VPN connection does not meet the high availability redundancy criteria/requirement. Valid values is INCOMPLETE_TUNNELS_COVERAGE. + * Indicates the reason why the VPN connection does not meet the high + * availability redundancy criteria/requirement. + * Valid values is INCOMPLETE_TUNNELS_COVERAGE. * * Protobuf type google.cloud.compute.v1.VpnGatewayStatusHighAvailabilityRequirementState.UnsatisfiedReason */ diff --git a/Compute/src/V1/VpnGatewayStatusTunnel.php b/Compute/src/V1/VpnGatewayStatusTunnel.php index e595e651818a..a5db4d4e5101 100644 --- a/Compute/src/V1/VpnGatewayStatusTunnel.php +++ b/Compute/src/V1/VpnGatewayStatusTunnel.php @@ -22,7 +22,9 @@ class VpnGatewayStatusTunnel extends \Google\Protobuf\Internal\Message */ protected $local_gateway_interface = null; /** - * The peer gateway interface this VPN tunnel is connected to, the peer gateway could either be an external VPN gateway or a Google Cloud VPN gateway. + * The peer gateway interface this VPN tunnel is connected to, the peer + * gateway could either be an external VPN gateway or a Google Cloud + * VPN gateway. * * Generated from protobuf field optional uint32 peer_gateway_interface = 214380385; */ @@ -43,7 +45,9 @@ class VpnGatewayStatusTunnel extends \Google\Protobuf\Internal\Message * @type int $local_gateway_interface * The VPN gateway interface this VPN tunnel is associated with. * @type int $peer_gateway_interface - * The peer gateway interface this VPN tunnel is connected to, the peer gateway could either be an external VPN gateway or a Google Cloud VPN gateway. + * The peer gateway interface this VPN tunnel is connected to, the peer + * gateway could either be an external VPN gateway or a Google Cloud + * VPN gateway. * @type string $tunnel_url * URL reference to the VPN tunnel. * } @@ -90,7 +94,9 @@ public function setLocalGatewayInterface($var) } /** - * The peer gateway interface this VPN tunnel is connected to, the peer gateway could either be an external VPN gateway or a Google Cloud VPN gateway. + * The peer gateway interface this VPN tunnel is connected to, the peer + * gateway could either be an external VPN gateway or a Google Cloud + * VPN gateway. * * Generated from protobuf field optional uint32 peer_gateway_interface = 214380385; * @return int @@ -111,7 +117,9 @@ public function clearPeerGatewayInterface() } /** - * The peer gateway interface this VPN tunnel is connected to, the peer gateway could either be an external VPN gateway or a Google Cloud VPN gateway. + * The peer gateway interface this VPN tunnel is connected to, the peer + * gateway could either be an external VPN gateway or a Google Cloud + * VPN gateway. * * Generated from protobuf field optional uint32 peer_gateway_interface = 214380385; * @param int $var diff --git a/Compute/src/V1/VpnGatewayStatusVpnConnection.php b/Compute/src/V1/VpnGatewayStatusVpnConnection.php index f44ae0e51774..d6fde5621aa6 100644 --- a/Compute/src/V1/VpnGatewayStatusVpnConnection.php +++ b/Compute/src/V1/VpnGatewayStatusVpnConnection.php @@ -9,20 +9,26 @@ use Google\Protobuf\Internal\GPBUtil; /** - * A VPN connection contains all VPN tunnels connected from this VpnGateway to the same peer gateway. The peer gateway could either be an external VPN gateway or a Google Cloud VPN gateway. + * A VPN connection contains all VPN tunnels connected from this VpnGateway + * to the same peer gateway. The peer gateway could either be an external VPN + * gateway or a Google Cloud VPN gateway. * * Generated from protobuf message google.cloud.compute.v1.VpnGatewayStatusVpnConnection */ class VpnGatewayStatusVpnConnection extends \Google\Protobuf\Internal\Message { /** - * URL reference to the peer external VPN gateways to which the VPN tunnels in this VPN connection are connected. This field is mutually exclusive with peer_gcp_gateway. + * URL reference to the peer external VPN gateways to which the VPN tunnels + * in this VPN connection are connected. + * This field is mutually exclusive with peer_gcp_gateway. * * Generated from protobuf field optional string peer_external_gateway = 384956173; */ protected $peer_external_gateway = null; /** - * URL reference to the peer side VPN gateways to which the VPN tunnels in this VPN connection are connected. This field is mutually exclusive with peer_gcp_gateway. + * URL reference to the peer side VPN gateways to which the VPN tunnels in + * this VPN connection are connected. + * This field is mutually exclusive with peer_gcp_gateway. * * Generated from protobuf field optional string peer_gcp_gateway = 281867452; */ @@ -47,9 +53,13 @@ class VpnGatewayStatusVpnConnection extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $peer_external_gateway - * URL reference to the peer external VPN gateways to which the VPN tunnels in this VPN connection are connected. This field is mutually exclusive with peer_gcp_gateway. + * URL reference to the peer external VPN gateways to which the VPN tunnels + * in this VPN connection are connected. + * This field is mutually exclusive with peer_gcp_gateway. * @type string $peer_gcp_gateway - * URL reference to the peer side VPN gateways to which the VPN tunnels in this VPN connection are connected. This field is mutually exclusive with peer_gcp_gateway. + * URL reference to the peer side VPN gateways to which the VPN tunnels in + * this VPN connection are connected. + * This field is mutually exclusive with peer_gcp_gateway. * @type \Google\Cloud\Compute\V1\VpnGatewayStatusHighAvailabilityRequirementState $state * HighAvailabilityRequirementState for the VPN connection. * @type array<\Google\Cloud\Compute\V1\VpnGatewayStatusTunnel>|\Google\Protobuf\Internal\RepeatedField $tunnels @@ -62,7 +72,9 @@ public function __construct($data = NULL) { } /** - * URL reference to the peer external VPN gateways to which the VPN tunnels in this VPN connection are connected. This field is mutually exclusive with peer_gcp_gateway. + * URL reference to the peer external VPN gateways to which the VPN tunnels + * in this VPN connection are connected. + * This field is mutually exclusive with peer_gcp_gateway. * * Generated from protobuf field optional string peer_external_gateway = 384956173; * @return string @@ -83,7 +95,9 @@ public function clearPeerExternalGateway() } /** - * URL reference to the peer external VPN gateways to which the VPN tunnels in this VPN connection are connected. This field is mutually exclusive with peer_gcp_gateway. + * URL reference to the peer external VPN gateways to which the VPN tunnels + * in this VPN connection are connected. + * This field is mutually exclusive with peer_gcp_gateway. * * Generated from protobuf field optional string peer_external_gateway = 384956173; * @param string $var @@ -98,7 +112,9 @@ public function setPeerExternalGateway($var) } /** - * URL reference to the peer side VPN gateways to which the VPN tunnels in this VPN connection are connected. This field is mutually exclusive with peer_gcp_gateway. + * URL reference to the peer side VPN gateways to which the VPN tunnels in + * this VPN connection are connected. + * This field is mutually exclusive with peer_gcp_gateway. * * Generated from protobuf field optional string peer_gcp_gateway = 281867452; * @return string @@ -119,7 +135,9 @@ public function clearPeerGcpGateway() } /** - * URL reference to the peer side VPN gateways to which the VPN tunnels in this VPN connection are connected. This field is mutually exclusive with peer_gcp_gateway. + * URL reference to the peer side VPN gateways to which the VPN tunnels in + * this VPN connection are connected. + * This field is mutually exclusive with peer_gcp_gateway. * * Generated from protobuf field optional string peer_gcp_gateway = 281867452; * @param string $var diff --git a/Compute/src/V1/VpnGatewayVpnGatewayInterface.php b/Compute/src/V1/VpnGatewayVpnGatewayInterface.php index 8e8c3d89a3e8..ea19827a2acc 100644 --- a/Compute/src/V1/VpnGatewayVpnGatewayInterface.php +++ b/Compute/src/V1/VpnGatewayVpnGatewayInterface.php @@ -16,25 +16,43 @@ class VpnGatewayVpnGatewayInterface extends \Google\Protobuf\Internal\Message { /** - * [Output Only] Numeric identifier for this VPN interface associated with the VPN gateway. + * [Output Only] Numeric identifier for this VPN interface associated with + * the VPN gateway. * * Generated from protobuf field optional uint32 id = 3355; */ protected $id = null; /** - * URL of the VLAN attachment (interconnectAttachment) resource for this VPN gateway interface. When the value of this field is present, the VPN gateway is used for HA VPN over Cloud Interconnect; all egress or ingress traffic for this VPN gateway interface goes through the specified VLAN attachment resource. + * URL of the VLAN attachment (interconnectAttachment) resource for this + * VPN gateway interface. When the value of this field is present, the VPN + * gateway is used for HA VPN over Cloud Interconnect; all egress + * or ingress traffic for this VPN gateway interface goes through the + * specified VLAN attachment resource. * * Generated from protobuf field optional string interconnect_attachment = 308135284; */ protected $interconnect_attachment = null; /** - * [Output Only] IP address for this VPN interface associated with the VPN gateway. The IP address could be either a regional external IP address or a regional internal IP address. The two IP addresses for a VPN gateway must be all regional external or regional internal IP addresses. There cannot be a mix of regional external IP addresses and regional internal IP addresses. For HA VPN over Cloud Interconnect, the IP addresses for both interfaces could either be regional internal IP addresses or regional external IP addresses. For regular (non HA VPN over Cloud Interconnect) HA VPN tunnels, the IP address must be a regional external IP address. + * [Output Only] IP address for this VPN interface associated with the VPN + * gateway. + * The IP address could be either a regional external IP address or + * a regional internal IP address. The two IP addresses for a VPN gateway + * must be all regional external or regional internal IP addresses. There + * cannot be a mix of regional external IP addresses and regional internal + * IP addresses. For HA VPN over Cloud Interconnect, the IP addresses + * for both interfaces could either be regional internal IP addresses or + * regional external IP addresses. For regular (non HA VPN over Cloud + * Interconnect) HA VPN tunnels, the IP address must be a regional external + * IP address. * * Generated from protobuf field optional string ip_address = 406272220; */ protected $ip_address = null; /** - * [Output Only] IPv6 address for this VPN interface associated with the VPN gateway. The IPv6 address must be a regional external IPv6 address. The format is RFC 5952 format (e.g. 2001:db8::2d9:51:0:0). + * [Output Only] IPv6 address for this VPN interface associated with the VPN + * gateway. + * The IPv6 address must be a regional external IPv6 address. The format is + * RFC 5952 format (e.g. 2001:db8::2d9:51:0:0). * * Generated from protobuf field optional string ipv6_address = 341563804; */ @@ -47,13 +65,31 @@ class VpnGatewayVpnGatewayInterface extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type int $id - * [Output Only] Numeric identifier for this VPN interface associated with the VPN gateway. + * [Output Only] Numeric identifier for this VPN interface associated with + * the VPN gateway. * @type string $interconnect_attachment - * URL of the VLAN attachment (interconnectAttachment) resource for this VPN gateway interface. When the value of this field is present, the VPN gateway is used for HA VPN over Cloud Interconnect; all egress or ingress traffic for this VPN gateway interface goes through the specified VLAN attachment resource. + * URL of the VLAN attachment (interconnectAttachment) resource for this + * VPN gateway interface. When the value of this field is present, the VPN + * gateway is used for HA VPN over Cloud Interconnect; all egress + * or ingress traffic for this VPN gateway interface goes through the + * specified VLAN attachment resource. * @type string $ip_address - * [Output Only] IP address for this VPN interface associated with the VPN gateway. The IP address could be either a regional external IP address or a regional internal IP address. The two IP addresses for a VPN gateway must be all regional external or regional internal IP addresses. There cannot be a mix of regional external IP addresses and regional internal IP addresses. For HA VPN over Cloud Interconnect, the IP addresses for both interfaces could either be regional internal IP addresses or regional external IP addresses. For regular (non HA VPN over Cloud Interconnect) HA VPN tunnels, the IP address must be a regional external IP address. + * [Output Only] IP address for this VPN interface associated with the VPN + * gateway. + * The IP address could be either a regional external IP address or + * a regional internal IP address. The two IP addresses for a VPN gateway + * must be all regional external or regional internal IP addresses. There + * cannot be a mix of regional external IP addresses and regional internal + * IP addresses. For HA VPN over Cloud Interconnect, the IP addresses + * for both interfaces could either be regional internal IP addresses or + * regional external IP addresses. For regular (non HA VPN over Cloud + * Interconnect) HA VPN tunnels, the IP address must be a regional external + * IP address. * @type string $ipv6_address - * [Output Only] IPv6 address for this VPN interface associated with the VPN gateway. The IPv6 address must be a regional external IPv6 address. The format is RFC 5952 format (e.g. 2001:db8::2d9:51:0:0). + * [Output Only] IPv6 address for this VPN interface associated with the VPN + * gateway. + * The IPv6 address must be a regional external IPv6 address. The format is + * RFC 5952 format (e.g. 2001:db8::2d9:51:0:0). * } */ public function __construct($data = NULL) { @@ -62,7 +98,8 @@ public function __construct($data = NULL) { } /** - * [Output Only] Numeric identifier for this VPN interface associated with the VPN gateway. + * [Output Only] Numeric identifier for this VPN interface associated with + * the VPN gateway. * * Generated from protobuf field optional uint32 id = 3355; * @return int @@ -83,7 +120,8 @@ public function clearId() } /** - * [Output Only] Numeric identifier for this VPN interface associated with the VPN gateway. + * [Output Only] Numeric identifier for this VPN interface associated with + * the VPN gateway. * * Generated from protobuf field optional uint32 id = 3355; * @param int $var @@ -98,7 +136,11 @@ public function setId($var) } /** - * URL of the VLAN attachment (interconnectAttachment) resource for this VPN gateway interface. When the value of this field is present, the VPN gateway is used for HA VPN over Cloud Interconnect; all egress or ingress traffic for this VPN gateway interface goes through the specified VLAN attachment resource. + * URL of the VLAN attachment (interconnectAttachment) resource for this + * VPN gateway interface. When the value of this field is present, the VPN + * gateway is used for HA VPN over Cloud Interconnect; all egress + * or ingress traffic for this VPN gateway interface goes through the + * specified VLAN attachment resource. * * Generated from protobuf field optional string interconnect_attachment = 308135284; * @return string @@ -119,7 +161,11 @@ public function clearInterconnectAttachment() } /** - * URL of the VLAN attachment (interconnectAttachment) resource for this VPN gateway interface. When the value of this field is present, the VPN gateway is used for HA VPN over Cloud Interconnect; all egress or ingress traffic for this VPN gateway interface goes through the specified VLAN attachment resource. + * URL of the VLAN attachment (interconnectAttachment) resource for this + * VPN gateway interface. When the value of this field is present, the VPN + * gateway is used for HA VPN over Cloud Interconnect; all egress + * or ingress traffic for this VPN gateway interface goes through the + * specified VLAN attachment resource. * * Generated from protobuf field optional string interconnect_attachment = 308135284; * @param string $var @@ -134,7 +180,17 @@ public function setInterconnectAttachment($var) } /** - * [Output Only] IP address for this VPN interface associated with the VPN gateway. The IP address could be either a regional external IP address or a regional internal IP address. The two IP addresses for a VPN gateway must be all regional external or regional internal IP addresses. There cannot be a mix of regional external IP addresses and regional internal IP addresses. For HA VPN over Cloud Interconnect, the IP addresses for both interfaces could either be regional internal IP addresses or regional external IP addresses. For regular (non HA VPN over Cloud Interconnect) HA VPN tunnels, the IP address must be a regional external IP address. + * [Output Only] IP address for this VPN interface associated with the VPN + * gateway. + * The IP address could be either a regional external IP address or + * a regional internal IP address. The two IP addresses for a VPN gateway + * must be all regional external or regional internal IP addresses. There + * cannot be a mix of regional external IP addresses and regional internal + * IP addresses. For HA VPN over Cloud Interconnect, the IP addresses + * for both interfaces could either be regional internal IP addresses or + * regional external IP addresses. For regular (non HA VPN over Cloud + * Interconnect) HA VPN tunnels, the IP address must be a regional external + * IP address. * * Generated from protobuf field optional string ip_address = 406272220; * @return string @@ -155,7 +211,17 @@ public function clearIpAddress() } /** - * [Output Only] IP address for this VPN interface associated with the VPN gateway. The IP address could be either a regional external IP address or a regional internal IP address. The two IP addresses for a VPN gateway must be all regional external or regional internal IP addresses. There cannot be a mix of regional external IP addresses and regional internal IP addresses. For HA VPN over Cloud Interconnect, the IP addresses for both interfaces could either be regional internal IP addresses or regional external IP addresses. For regular (non HA VPN over Cloud Interconnect) HA VPN tunnels, the IP address must be a regional external IP address. + * [Output Only] IP address for this VPN interface associated with the VPN + * gateway. + * The IP address could be either a regional external IP address or + * a regional internal IP address. The two IP addresses for a VPN gateway + * must be all regional external or regional internal IP addresses. There + * cannot be a mix of regional external IP addresses and regional internal + * IP addresses. For HA VPN over Cloud Interconnect, the IP addresses + * for both interfaces could either be regional internal IP addresses or + * regional external IP addresses. For regular (non HA VPN over Cloud + * Interconnect) HA VPN tunnels, the IP address must be a regional external + * IP address. * * Generated from protobuf field optional string ip_address = 406272220; * @param string $var @@ -170,7 +236,10 @@ public function setIpAddress($var) } /** - * [Output Only] IPv6 address for this VPN interface associated with the VPN gateway. The IPv6 address must be a regional external IPv6 address. The format is RFC 5952 format (e.g. 2001:db8::2d9:51:0:0). + * [Output Only] IPv6 address for this VPN interface associated with the VPN + * gateway. + * The IPv6 address must be a regional external IPv6 address. The format is + * RFC 5952 format (e.g. 2001:db8::2d9:51:0:0). * * Generated from protobuf field optional string ipv6_address = 341563804; * @return string @@ -191,7 +260,10 @@ public function clearIpv6Address() } /** - * [Output Only] IPv6 address for this VPN interface associated with the VPN gateway. The IPv6 address must be a regional external IPv6 address. The format is RFC 5952 format (e.g. 2001:db8::2d9:51:0:0). + * [Output Only] IPv6 address for this VPN interface associated with the VPN + * gateway. + * The IPv6 address must be a regional external IPv6 address. The format is + * RFC 5952 format (e.g. 2001:db8::2d9:51:0:0). * * Generated from protobuf field optional string ipv6_address = 341563804; * @param string $var diff --git a/Compute/src/V1/VpnGatewaysScopedList.php b/Compute/src/V1/VpnGatewaysScopedList.php index 73f7dd6427c1..62a12f1260f0 100644 --- a/Compute/src/V1/VpnGatewaysScopedList.php +++ b/Compute/src/V1/VpnGatewaysScopedList.php @@ -21,7 +21,8 @@ class VpnGatewaysScopedList extends \Google\Protobuf\Internal\Message */ private $vpn_gateways; /** - * [Output Only] Informational warning which replaces the list of addresses when the list is empty. + * [Output Only] Informational warning which replaces the list of addresses + * when the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; */ @@ -36,7 +37,8 @@ class VpnGatewaysScopedList extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\VpnGateway>|\Google\Protobuf\Internal\RepeatedField $vpn_gateways * [Output Only] A list of VPN gateways contained in this scope. * @type \Google\Cloud\Compute\V1\Warning $warning - * [Output Only] Informational warning which replaces the list of addresses when the list is empty. + * [Output Only] Informational warning which replaces the list of addresses + * when the list is empty. * } */ public function __construct($data = NULL) { @@ -71,7 +73,8 @@ public function setVpnGateways($var) } /** - * [Output Only] Informational warning which replaces the list of addresses when the list is empty. + * [Output Only] Informational warning which replaces the list of addresses + * when the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; * @return \Google\Cloud\Compute\V1\Warning|null @@ -92,7 +95,8 @@ public function clearWarning() } /** - * [Output Only] Informational warning which replaces the list of addresses when the list is empty. + * [Output Only] Informational warning which replaces the list of addresses + * when the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; * @param \Google\Cloud\Compute\V1\Warning $var diff --git a/Compute/src/V1/VpnTunnel.php b/Compute/src/V1/VpnTunnel.php index 1e42a350ee2f..ab340ea50d55 100644 --- a/Compute/src/V1/VpnTunnel.php +++ b/Compute/src/V1/VpnTunnel.php @@ -9,26 +9,31 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Represents a Cloud VPN Tunnel resource. For more information about VPN, read the the Cloud VPN Overview. + * Represents a Cloud VPN Tunnel resource. + * For more information about VPN, read the + * the Cloud VPN Overview. * * Generated from protobuf message google.cloud.compute.v1.VpnTunnel */ class VpnTunnel extends \Google\Protobuf\Internal\Message { /** - * User specified list of ciphers to use for the phase 1 and phase 2 of the IKE protocol. + * User specified list of ciphers to use for the phase 1 and phase 2 of the + * IKE protocol. * * Generated from protobuf field optional .google.cloud.compute.v1.VpnTunnelCipherSuite cipher_suite = 443788228; */ protected $cipher_suite = null; /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; */ protected $creation_timestamp = null; /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; */ @@ -40,79 +45,119 @@ class VpnTunnel extends \Google\Protobuf\Internal\Message */ protected $detailed_status = null; /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; */ protected $id = null; /** - * IKE protocol version to use when establishing the VPN tunnel with the peer VPN gateway. Acceptable IKE versions are 1 or 2. The default version is 2. + * IKE protocol version to use when establishing the VPN tunnel with the peer + * VPN gateway. Acceptable IKE versions are 1 or 2. + * The default version is 2. * * Generated from protobuf field optional int32 ike_version = 218376220; */ protected $ike_version = null; /** - * [Output Only] Type of resource. Always compute#vpnTunnel for VPN tunnels. + * [Output Only] Type of resource. Always compute#vpnTunnel for + * VPN tunnels. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * A fingerprint for the labels being applied to this VpnTunnel, which is essentially a hash of the labels set used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a VpnTunnel. + * A fingerprint for the labels being applied to this VpnTunnel, which is + * essentially a hash of the labels set used for optimistic locking. The + * fingerprint is initially generated by Compute Engine and changes after + * every request to modify or update labels. You must always provide an + * up-to-date fingerprint hash in order to update or change labels, + * otherwise the request will fail with error412 conditionNotMet. + * To see the latest fingerprint, make a get() request to + * retrieve a VpnTunnel. * * Generated from protobuf field optional string label_fingerprint = 178124825; */ protected $label_fingerprint = null; /** - * Labels for this resource. These can only be added or modified by the setLabels method. Each label key/value pair must comply with RFC1035. Label values may be empty. + * Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035. + * Label values may be empty. * * Generated from protobuf field map labels = 500195327; */ private $labels; /** - * Local traffic selector to use when establishing the VPN tunnel with the peer VPN gateway. The value should be a CIDR formatted string, for example: 192.168.0.0/16. The ranges must be disjoint. Only IPv4 is supported for Classic VPN tunnels. This field is output only for HA VPN tunnels. + * Local traffic selector to use when establishing the VPN tunnel with the + * peer VPN gateway. The value should be a CIDR formatted string, for + * example: 192.168.0.0/16. The ranges must be disjoint. + * Only IPv4 is supported for Classic VPN tunnels. This field is output only + * for HA VPN tunnels. * * Generated from protobuf field repeated string local_traffic_selector = 317314613; */ private $local_traffic_selector; /** - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * * Generated from protobuf field optional string name = 3373707; */ protected $name = null; /** - * URL of the peer side external VPN gateway to which this VPN tunnel is connected. Provided by the client when the VPN tunnel is created. This field is exclusive with the field peerGcpGateway. + * URL of the peer side external VPN gateway to which this VPN tunnel is + * connected. + * Provided by the client when the VPN tunnel is created. + * This field is exclusive with the field peerGcpGateway. * * Generated from protobuf field optional string peer_external_gateway = 384956173; */ protected $peer_external_gateway = null; /** - * The interface ID of the external VPN gateway to which this VPN tunnel is connected. Provided by the client when the VPN tunnel is created. Possible values are: `0`, `1`, `2`, `3`. The number of IDs in use depends on the external VPN gateway redundancy type. + * The interface ID of the external VPN gateway to which this VPN tunnel is + * connected. Provided by the client when the VPN tunnel is created. + * Possible values are: `0`, `1`, `2`, `3`. The number of IDs in use + * depends on the external VPN gateway redundancy type. * * Generated from protobuf field optional int32 peer_external_gateway_interface = 452768391; */ protected $peer_external_gateway_interface = null; /** - * URL of the peer side HA VPN gateway to which this VPN tunnel is connected. Provided by the client when the VPN tunnel is created. This field can be used when creating highly available VPN from VPC network to VPC network, the field is exclusive with the field peerExternalGateway. If provided, the VPN tunnel will automatically use the same vpnGatewayInterface ID in the peer Google Cloud VPN gateway. + * URL of the peer side HA VPN gateway to which this VPN tunnel + * is connected. Provided by the client when the VPN tunnel is created. + * This field can be used when creating highly available VPN from VPC network + * to VPC network, the field is exclusive with the field peerExternalGateway. + * If provided, the VPN tunnel will automatically use the same + * vpnGatewayInterface ID in the peer Google Cloud VPN gateway. * * Generated from protobuf field optional string peer_gcp_gateway = 281867452; */ protected $peer_gcp_gateway = null; /** - * IP address of the peer VPN gateway. Only IPv4 is supported. This field can be set only for Classic VPN tunnels. + * IP address of the peer VPN gateway. Only IPv4 is supported. This field can + * be set only for Classic VPN tunnels. * * Generated from protobuf field optional string peer_ip = 383249700; */ protected $peer_ip = null; /** - * [Output Only] URL of the region where the VPN tunnel resides. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * [Output Only] URL of the region where the VPN tunnel resides. + * You must specify this field as part of the HTTP request URL. It is + * not settable as a field in the request body. * * Generated from protobuf field optional string region = 138946292; */ protected $region = null; /** - * Remote traffic selectors to use when establishing the VPN tunnel with the peer VPN gateway. The value should be a CIDR formatted string, for example: 192.168.0.0/16. The ranges should be disjoint. Only IPv4 is supported for Classic VPN tunnels. This field is output only for HA VPN tunnels. + * Remote traffic selectors to use when establishing the VPN tunnel with + * the peer VPN gateway. The value should be a CIDR formatted string, + * for example: 192.168.0.0/16. The ranges should be disjoint. Only IPv4 is + * supported for Classic VPN tunnels. This field is output only for HA VPN + * tunnels. * * Generated from protobuf field repeated string remote_traffic_selector = 358887098; */ @@ -130,7 +175,8 @@ class VpnTunnel extends \Google\Protobuf\Internal\Message */ protected $self_link = null; /** - * Shared secret used to set the secure session between the Cloud VPN gateway and the peer VPN gateway. + * Shared secret used to set the secure session between the Cloud VPN gateway + * and the peer VPN gateway. * * Generated from protobuf field optional string shared_secret = 381932490; */ @@ -142,26 +188,63 @@ class VpnTunnel extends \Google\Protobuf\Internal\Message */ protected $shared_secret_hash = null; /** - * [Output Only] The status of the VPN tunnel, which can be one of the following: - PROVISIONING: Resource is being allocated for the VPN tunnel. - WAITING_FOR_FULL_CONFIG: Waiting to receive all VPN-related configs from the user. Network, TargetVpnGateway, VpnTunnel, ForwardingRule, and Route resources are needed to setup the VPN tunnel. - FIRST_HANDSHAKE: Successful first handshake with the peer VPN. - ESTABLISHED: Secure session is successfully established with the peer VPN. - NETWORK_ERROR: Deprecated, replaced by NO_INCOMING_PACKETS - AUTHORIZATION_ERROR: Auth error (for example, bad shared secret). - NEGOTIATION_FAILURE: Handshake failed. - DEPROVISIONING: Resources are being deallocated for the VPN tunnel. - FAILED: Tunnel creation has failed and the tunnel is not ready to be used. - NO_INCOMING_PACKETS: No incoming packets from peer. - REJECTED: Tunnel configuration was rejected, can be result of being denied access. - ALLOCATING_RESOURCES: Cloud VPN is in the process of allocating all required resources. - STOPPED: Tunnel is stopped due to its Forwarding Rules being deleted for Classic VPN tunnels or the project is in frozen state. - PEER_IDENTITY_MISMATCH: Peer identity does not match peer IP, probably behind NAT. - TS_NARROWING_NOT_ALLOWED: Traffic selector narrowing not allowed for an HA-VPN tunnel. + * [Output Only] The status of the VPN tunnel, which can be one of the + * following: + * - PROVISIONING: Resource is being allocated for the VPN tunnel. + * - WAITING_FOR_FULL_CONFIG: Waiting to receive all VPN-related configs + * from + * the user. Network, TargetVpnGateway, VpnTunnel, ForwardingRule, and Route + * resources are needed to setup the VPN tunnel. + * - FIRST_HANDSHAKE: Successful first handshake with the peer VPN. + * - ESTABLISHED: Secure session is successfully established with the peer + * VPN. + * - NETWORK_ERROR: Deprecated, replaced by + * NO_INCOMING_PACKETS + * - AUTHORIZATION_ERROR: Auth error (for example, + * bad shared secret). + * - NEGOTIATION_FAILURE: Handshake failed. + * - DEPROVISIONING: Resources are being deallocated for the VPN + * tunnel. + * - FAILED: Tunnel creation has failed and the tunnel is not + * ready to be used. + * - NO_INCOMING_PACKETS: No incoming packets from + * peer. + * - REJECTED: Tunnel configuration was rejected, can be result + * of being denied access. + * - ALLOCATING_RESOURCES: Cloud VPN is in the + * process of allocating all required resources. + * - STOPPED: Tunnel is stopped due to its Forwarding Rules being deleted + * for Classic VPN tunnels or the project is in frozen state. + * - PEER_IDENTITY_MISMATCH: Peer identity does not match peer IP, + * probably behind NAT. + * - TS_NARROWING_NOT_ALLOWED: Traffic selector + * narrowing not allowed for an HA-VPN tunnel. * Check the Status enum for the list of possible values. * * Generated from protobuf field optional string status = 181260274; */ protected $status = null; /** - * URL of the Target VPN gateway with which this VPN tunnel is associated. Provided by the client when the VPN tunnel is created. This field can be set only for Classic VPN tunnels. + * URL of the Target VPN gateway with which this VPN tunnel is associated. + * Provided by the client when the VPN tunnel is created. + * This field can be set only for Classic VPN tunnels. * * Generated from protobuf field optional string target_vpn_gateway = 532512843; */ protected $target_vpn_gateway = null; /** - * URL of the VPN gateway with which this VPN tunnel is associated. Provided by the client when the VPN tunnel is created. This must be used (instead of target_vpn_gateway) if a High Availability VPN gateway resource is created. + * URL of the VPN gateway with which this VPN tunnel is associated. + * Provided by the client when the VPN tunnel is created. This must be + * used (instead of target_vpn_gateway) if a High Availability VPN gateway + * resource is created. * * Generated from protobuf field optional string vpn_gateway = 406684153; */ protected $vpn_gateway = null; /** - * The interface ID of the VPN gateway with which this VPN tunnel is associated. Possible values are: `0`, `1`. + * The interface ID of the VPN gateway with which this VPN tunnel is + * associated. + * Possible values are: `0`, `1`. * * Generated from protobuf field optional int32 vpn_gateway_interface = 95979123; */ @@ -174,56 +257,137 @@ class VpnTunnel extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type \Google\Cloud\Compute\V1\VpnTunnelCipherSuite $cipher_suite - * User specified list of ciphers to use for the phase 1 and phase 2 of the IKE protocol. + * User specified list of ciphers to use for the phase 1 and phase 2 of the + * IKE protocol. * @type string $creation_timestamp - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * @type string $description - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * @type string $detailed_status * [Output Only] Detailed status message for the VPN tunnel. * @type int|string $id - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * @type int $ike_version - * IKE protocol version to use when establishing the VPN tunnel with the peer VPN gateway. Acceptable IKE versions are 1 or 2. The default version is 2. + * IKE protocol version to use when establishing the VPN tunnel with the peer + * VPN gateway. Acceptable IKE versions are 1 or 2. + * The default version is 2. * @type string $kind - * [Output Only] Type of resource. Always compute#vpnTunnel for VPN tunnels. + * [Output Only] Type of resource. Always compute#vpnTunnel for + * VPN tunnels. * @type string $label_fingerprint - * A fingerprint for the labels being applied to this VpnTunnel, which is essentially a hash of the labels set used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a VpnTunnel. + * A fingerprint for the labels being applied to this VpnTunnel, which is + * essentially a hash of the labels set used for optimistic locking. The + * fingerprint is initially generated by Compute Engine and changes after + * every request to modify or update labels. You must always provide an + * up-to-date fingerprint hash in order to update or change labels, + * otherwise the request will fail with error412 conditionNotMet. + * To see the latest fingerprint, make a get() request to + * retrieve a VpnTunnel. * @type array|\Google\Protobuf\Internal\MapField $labels - * Labels for this resource. These can only be added or modified by the setLabels method. Each label key/value pair must comply with RFC1035. Label values may be empty. + * Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035. + * Label values may be empty. * @type array|\Google\Protobuf\Internal\RepeatedField $local_traffic_selector - * Local traffic selector to use when establishing the VPN tunnel with the peer VPN gateway. The value should be a CIDR formatted string, for example: 192.168.0.0/16. The ranges must be disjoint. Only IPv4 is supported for Classic VPN tunnels. This field is output only for HA VPN tunnels. + * Local traffic selector to use when establishing the VPN tunnel with the + * peer VPN gateway. The value should be a CIDR formatted string, for + * example: 192.168.0.0/16. The ranges must be disjoint. + * Only IPv4 is supported for Classic VPN tunnels. This field is output only + * for HA VPN tunnels. * @type string $name - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * @type string $peer_external_gateway - * URL of the peer side external VPN gateway to which this VPN tunnel is connected. Provided by the client when the VPN tunnel is created. This field is exclusive with the field peerGcpGateway. + * URL of the peer side external VPN gateway to which this VPN tunnel is + * connected. + * Provided by the client when the VPN tunnel is created. + * This field is exclusive with the field peerGcpGateway. * @type int $peer_external_gateway_interface - * The interface ID of the external VPN gateway to which this VPN tunnel is connected. Provided by the client when the VPN tunnel is created. Possible values are: `0`, `1`, `2`, `3`. The number of IDs in use depends on the external VPN gateway redundancy type. + * The interface ID of the external VPN gateway to which this VPN tunnel is + * connected. Provided by the client when the VPN tunnel is created. + * Possible values are: `0`, `1`, `2`, `3`. The number of IDs in use + * depends on the external VPN gateway redundancy type. * @type string $peer_gcp_gateway - * URL of the peer side HA VPN gateway to which this VPN tunnel is connected. Provided by the client when the VPN tunnel is created. This field can be used when creating highly available VPN from VPC network to VPC network, the field is exclusive with the field peerExternalGateway. If provided, the VPN tunnel will automatically use the same vpnGatewayInterface ID in the peer Google Cloud VPN gateway. + * URL of the peer side HA VPN gateway to which this VPN tunnel + * is connected. Provided by the client when the VPN tunnel is created. + * This field can be used when creating highly available VPN from VPC network + * to VPC network, the field is exclusive with the field peerExternalGateway. + * If provided, the VPN tunnel will automatically use the same + * vpnGatewayInterface ID in the peer Google Cloud VPN gateway. * @type string $peer_ip - * IP address of the peer VPN gateway. Only IPv4 is supported. This field can be set only for Classic VPN tunnels. + * IP address of the peer VPN gateway. Only IPv4 is supported. This field can + * be set only for Classic VPN tunnels. * @type string $region - * [Output Only] URL of the region where the VPN tunnel resides. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * [Output Only] URL of the region where the VPN tunnel resides. + * You must specify this field as part of the HTTP request URL. It is + * not settable as a field in the request body. * @type array|\Google\Protobuf\Internal\RepeatedField $remote_traffic_selector - * Remote traffic selectors to use when establishing the VPN tunnel with the peer VPN gateway. The value should be a CIDR formatted string, for example: 192.168.0.0/16. The ranges should be disjoint. Only IPv4 is supported for Classic VPN tunnels. This field is output only for HA VPN tunnels. + * Remote traffic selectors to use when establishing the VPN tunnel with + * the peer VPN gateway. The value should be a CIDR formatted string, + * for example: 192.168.0.0/16. The ranges should be disjoint. Only IPv4 is + * supported for Classic VPN tunnels. This field is output only for HA VPN + * tunnels. * @type string $router * URL of the router resource to be used for dynamic routing. * @type string $self_link * [Output Only] Server-defined URL for the resource. * @type string $shared_secret - * Shared secret used to set the secure session between the Cloud VPN gateway and the peer VPN gateway. + * Shared secret used to set the secure session between the Cloud VPN gateway + * and the peer VPN gateway. * @type string $shared_secret_hash * Hash of the shared secret. * @type string $status - * [Output Only] The status of the VPN tunnel, which can be one of the following: - PROVISIONING: Resource is being allocated for the VPN tunnel. - WAITING_FOR_FULL_CONFIG: Waiting to receive all VPN-related configs from the user. Network, TargetVpnGateway, VpnTunnel, ForwardingRule, and Route resources are needed to setup the VPN tunnel. - FIRST_HANDSHAKE: Successful first handshake with the peer VPN. - ESTABLISHED: Secure session is successfully established with the peer VPN. - NETWORK_ERROR: Deprecated, replaced by NO_INCOMING_PACKETS - AUTHORIZATION_ERROR: Auth error (for example, bad shared secret). - NEGOTIATION_FAILURE: Handshake failed. - DEPROVISIONING: Resources are being deallocated for the VPN tunnel. - FAILED: Tunnel creation has failed and the tunnel is not ready to be used. - NO_INCOMING_PACKETS: No incoming packets from peer. - REJECTED: Tunnel configuration was rejected, can be result of being denied access. - ALLOCATING_RESOURCES: Cloud VPN is in the process of allocating all required resources. - STOPPED: Tunnel is stopped due to its Forwarding Rules being deleted for Classic VPN tunnels or the project is in frozen state. - PEER_IDENTITY_MISMATCH: Peer identity does not match peer IP, probably behind NAT. - TS_NARROWING_NOT_ALLOWED: Traffic selector narrowing not allowed for an HA-VPN tunnel. + * [Output Only] The status of the VPN tunnel, which can be one of the + * following: + * - PROVISIONING: Resource is being allocated for the VPN tunnel. + * - WAITING_FOR_FULL_CONFIG: Waiting to receive all VPN-related configs + * from + * the user. Network, TargetVpnGateway, VpnTunnel, ForwardingRule, and Route + * resources are needed to setup the VPN tunnel. + * - FIRST_HANDSHAKE: Successful first handshake with the peer VPN. + * - ESTABLISHED: Secure session is successfully established with the peer + * VPN. + * - NETWORK_ERROR: Deprecated, replaced by + * NO_INCOMING_PACKETS + * - AUTHORIZATION_ERROR: Auth error (for example, + * bad shared secret). + * - NEGOTIATION_FAILURE: Handshake failed. + * - DEPROVISIONING: Resources are being deallocated for the VPN + * tunnel. + * - FAILED: Tunnel creation has failed and the tunnel is not + * ready to be used. + * - NO_INCOMING_PACKETS: No incoming packets from + * peer. + * - REJECTED: Tunnel configuration was rejected, can be result + * of being denied access. + * - ALLOCATING_RESOURCES: Cloud VPN is in the + * process of allocating all required resources. + * - STOPPED: Tunnel is stopped due to its Forwarding Rules being deleted + * for Classic VPN tunnels or the project is in frozen state. + * - PEER_IDENTITY_MISMATCH: Peer identity does not match peer IP, + * probably behind NAT. + * - TS_NARROWING_NOT_ALLOWED: Traffic selector + * narrowing not allowed for an HA-VPN tunnel. * Check the Status enum for the list of possible values. * @type string $target_vpn_gateway - * URL of the Target VPN gateway with which this VPN tunnel is associated. Provided by the client when the VPN tunnel is created. This field can be set only for Classic VPN tunnels. + * URL of the Target VPN gateway with which this VPN tunnel is associated. + * Provided by the client when the VPN tunnel is created. + * This field can be set only for Classic VPN tunnels. * @type string $vpn_gateway - * URL of the VPN gateway with which this VPN tunnel is associated. Provided by the client when the VPN tunnel is created. This must be used (instead of target_vpn_gateway) if a High Availability VPN gateway resource is created. + * URL of the VPN gateway with which this VPN tunnel is associated. + * Provided by the client when the VPN tunnel is created. This must be + * used (instead of target_vpn_gateway) if a High Availability VPN gateway + * resource is created. * @type int $vpn_gateway_interface - * The interface ID of the VPN gateway with which this VPN tunnel is associated. Possible values are: `0`, `1`. + * The interface ID of the VPN gateway with which this VPN tunnel is + * associated. + * Possible values are: `0`, `1`. * } */ public function __construct($data = NULL) { @@ -232,7 +396,8 @@ public function __construct($data = NULL) { } /** - * User specified list of ciphers to use for the phase 1 and phase 2 of the IKE protocol. + * User specified list of ciphers to use for the phase 1 and phase 2 of the + * IKE protocol. * * Generated from protobuf field optional .google.cloud.compute.v1.VpnTunnelCipherSuite cipher_suite = 443788228; * @return \Google\Cloud\Compute\V1\VpnTunnelCipherSuite|null @@ -253,7 +418,8 @@ public function clearCipherSuite() } /** - * User specified list of ciphers to use for the phase 1 and phase 2 of the IKE protocol. + * User specified list of ciphers to use for the phase 1 and phase 2 of the + * IKE protocol. * * Generated from protobuf field optional .google.cloud.compute.v1.VpnTunnelCipherSuite cipher_suite = 443788228; * @param \Google\Cloud\Compute\V1\VpnTunnelCipherSuite $var @@ -268,7 +434,8 @@ public function setCipherSuite($var) } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @return string @@ -289,7 +456,8 @@ public function clearCreationTimestamp() } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @param string $var @@ -304,7 +472,8 @@ public function setCreationTimestamp($var) } /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @return string @@ -325,7 +494,8 @@ public function clearDescription() } /** - * An optional description of this resource. Provide this property when you create the resource. + * An optional description of this resource. Provide this property when you + * create the resource. * * Generated from protobuf field optional string description = 422937596; * @param string $var @@ -376,7 +546,8 @@ public function setDetailedStatus($var) } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @return int|string @@ -397,7 +568,8 @@ public function clearId() } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @param int|string $var @@ -412,7 +584,9 @@ public function setId($var) } /** - * IKE protocol version to use when establishing the VPN tunnel with the peer VPN gateway. Acceptable IKE versions are 1 or 2. The default version is 2. + * IKE protocol version to use when establishing the VPN tunnel with the peer + * VPN gateway. Acceptable IKE versions are 1 or 2. + * The default version is 2. * * Generated from protobuf field optional int32 ike_version = 218376220; * @return int @@ -433,7 +607,9 @@ public function clearIkeVersion() } /** - * IKE protocol version to use when establishing the VPN tunnel with the peer VPN gateway. Acceptable IKE versions are 1 or 2. The default version is 2. + * IKE protocol version to use when establishing the VPN tunnel with the peer + * VPN gateway. Acceptable IKE versions are 1 or 2. + * The default version is 2. * * Generated from protobuf field optional int32 ike_version = 218376220; * @param int $var @@ -448,7 +624,8 @@ public function setIkeVersion($var) } /** - * [Output Only] Type of resource. Always compute#vpnTunnel for VPN tunnels. + * [Output Only] Type of resource. Always compute#vpnTunnel for + * VPN tunnels. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -469,7 +646,8 @@ public function clearKind() } /** - * [Output Only] Type of resource. Always compute#vpnTunnel for VPN tunnels. + * [Output Only] Type of resource. Always compute#vpnTunnel for + * VPN tunnels. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -484,7 +662,14 @@ public function setKind($var) } /** - * A fingerprint for the labels being applied to this VpnTunnel, which is essentially a hash of the labels set used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a VpnTunnel. + * A fingerprint for the labels being applied to this VpnTunnel, which is + * essentially a hash of the labels set used for optimistic locking. The + * fingerprint is initially generated by Compute Engine and changes after + * every request to modify or update labels. You must always provide an + * up-to-date fingerprint hash in order to update or change labels, + * otherwise the request will fail with error412 conditionNotMet. + * To see the latest fingerprint, make a get() request to + * retrieve a VpnTunnel. * * Generated from protobuf field optional string label_fingerprint = 178124825; * @return string @@ -505,7 +690,14 @@ public function clearLabelFingerprint() } /** - * A fingerprint for the labels being applied to this VpnTunnel, which is essentially a hash of the labels set used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a VpnTunnel. + * A fingerprint for the labels being applied to this VpnTunnel, which is + * essentially a hash of the labels set used for optimistic locking. The + * fingerprint is initially generated by Compute Engine and changes after + * every request to modify or update labels. You must always provide an + * up-to-date fingerprint hash in order to update or change labels, + * otherwise the request will fail with error412 conditionNotMet. + * To see the latest fingerprint, make a get() request to + * retrieve a VpnTunnel. * * Generated from protobuf field optional string label_fingerprint = 178124825; * @param string $var @@ -520,7 +712,8 @@ public function setLabelFingerprint($var) } /** - * Labels for this resource. These can only be added or modified by the setLabels method. Each label key/value pair must comply with RFC1035. Label values may be empty. + * Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035. + * Label values may be empty. * * Generated from protobuf field map labels = 500195327; * @return \Google\Protobuf\Internal\MapField @@ -531,7 +724,8 @@ public function getLabels() } /** - * Labels for this resource. These can only be added or modified by the setLabels method. Each label key/value pair must comply with RFC1035. Label values may be empty. + * Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035. + * Label values may be empty. * * Generated from protobuf field map labels = 500195327; * @param array|\Google\Protobuf\Internal\MapField $var @@ -546,7 +740,11 @@ public function setLabels($var) } /** - * Local traffic selector to use when establishing the VPN tunnel with the peer VPN gateway. The value should be a CIDR formatted string, for example: 192.168.0.0/16. The ranges must be disjoint. Only IPv4 is supported for Classic VPN tunnels. This field is output only for HA VPN tunnels. + * Local traffic selector to use when establishing the VPN tunnel with the + * peer VPN gateway. The value should be a CIDR formatted string, for + * example: 192.168.0.0/16. The ranges must be disjoint. + * Only IPv4 is supported for Classic VPN tunnels. This field is output only + * for HA VPN tunnels. * * Generated from protobuf field repeated string local_traffic_selector = 317314613; * @return \Google\Protobuf\Internal\RepeatedField @@ -557,7 +755,11 @@ public function getLocalTrafficSelector() } /** - * Local traffic selector to use when establishing the VPN tunnel with the peer VPN gateway. The value should be a CIDR formatted string, for example: 192.168.0.0/16. The ranges must be disjoint. Only IPv4 is supported for Classic VPN tunnels. This field is output only for HA VPN tunnels. + * Local traffic selector to use when establishing the VPN tunnel with the + * peer VPN gateway. The value should be a CIDR formatted string, for + * example: 192.168.0.0/16. The ranges must be disjoint. + * Only IPv4 is supported for Classic VPN tunnels. This field is output only + * for HA VPN tunnels. * * Generated from protobuf field repeated string local_traffic_selector = 317314613; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -572,7 +774,13 @@ public function setLocalTrafficSelector($var) } /** - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * * Generated from protobuf field optional string name = 3373707; * @return string @@ -593,7 +801,13 @@ public function clearName() } /** - * Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. * * Generated from protobuf field optional string name = 3373707; * @param string $var @@ -608,7 +822,10 @@ public function setName($var) } /** - * URL of the peer side external VPN gateway to which this VPN tunnel is connected. Provided by the client when the VPN tunnel is created. This field is exclusive with the field peerGcpGateway. + * URL of the peer side external VPN gateway to which this VPN tunnel is + * connected. + * Provided by the client when the VPN tunnel is created. + * This field is exclusive with the field peerGcpGateway. * * Generated from protobuf field optional string peer_external_gateway = 384956173; * @return string @@ -629,7 +846,10 @@ public function clearPeerExternalGateway() } /** - * URL of the peer side external VPN gateway to which this VPN tunnel is connected. Provided by the client when the VPN tunnel is created. This field is exclusive with the field peerGcpGateway. + * URL of the peer side external VPN gateway to which this VPN tunnel is + * connected. + * Provided by the client when the VPN tunnel is created. + * This field is exclusive with the field peerGcpGateway. * * Generated from protobuf field optional string peer_external_gateway = 384956173; * @param string $var @@ -644,7 +864,10 @@ public function setPeerExternalGateway($var) } /** - * The interface ID of the external VPN gateway to which this VPN tunnel is connected. Provided by the client when the VPN tunnel is created. Possible values are: `0`, `1`, `2`, `3`. The number of IDs in use depends on the external VPN gateway redundancy type. + * The interface ID of the external VPN gateway to which this VPN tunnel is + * connected. Provided by the client when the VPN tunnel is created. + * Possible values are: `0`, `1`, `2`, `3`. The number of IDs in use + * depends on the external VPN gateway redundancy type. * * Generated from protobuf field optional int32 peer_external_gateway_interface = 452768391; * @return int @@ -665,7 +888,10 @@ public function clearPeerExternalGatewayInterface() } /** - * The interface ID of the external VPN gateway to which this VPN tunnel is connected. Provided by the client when the VPN tunnel is created. Possible values are: `0`, `1`, `2`, `3`. The number of IDs in use depends on the external VPN gateway redundancy type. + * The interface ID of the external VPN gateway to which this VPN tunnel is + * connected. Provided by the client when the VPN tunnel is created. + * Possible values are: `0`, `1`, `2`, `3`. The number of IDs in use + * depends on the external VPN gateway redundancy type. * * Generated from protobuf field optional int32 peer_external_gateway_interface = 452768391; * @param int $var @@ -680,7 +906,12 @@ public function setPeerExternalGatewayInterface($var) } /** - * URL of the peer side HA VPN gateway to which this VPN tunnel is connected. Provided by the client when the VPN tunnel is created. This field can be used when creating highly available VPN from VPC network to VPC network, the field is exclusive with the field peerExternalGateway. If provided, the VPN tunnel will automatically use the same vpnGatewayInterface ID in the peer Google Cloud VPN gateway. + * URL of the peer side HA VPN gateway to which this VPN tunnel + * is connected. Provided by the client when the VPN tunnel is created. + * This field can be used when creating highly available VPN from VPC network + * to VPC network, the field is exclusive with the field peerExternalGateway. + * If provided, the VPN tunnel will automatically use the same + * vpnGatewayInterface ID in the peer Google Cloud VPN gateway. * * Generated from protobuf field optional string peer_gcp_gateway = 281867452; * @return string @@ -701,7 +932,12 @@ public function clearPeerGcpGateway() } /** - * URL of the peer side HA VPN gateway to which this VPN tunnel is connected. Provided by the client when the VPN tunnel is created. This field can be used when creating highly available VPN from VPC network to VPC network, the field is exclusive with the field peerExternalGateway. If provided, the VPN tunnel will automatically use the same vpnGatewayInterface ID in the peer Google Cloud VPN gateway. + * URL of the peer side HA VPN gateway to which this VPN tunnel + * is connected. Provided by the client when the VPN tunnel is created. + * This field can be used when creating highly available VPN from VPC network + * to VPC network, the field is exclusive with the field peerExternalGateway. + * If provided, the VPN tunnel will automatically use the same + * vpnGatewayInterface ID in the peer Google Cloud VPN gateway. * * Generated from protobuf field optional string peer_gcp_gateway = 281867452; * @param string $var @@ -716,7 +952,8 @@ public function setPeerGcpGateway($var) } /** - * IP address of the peer VPN gateway. Only IPv4 is supported. This field can be set only for Classic VPN tunnels. + * IP address of the peer VPN gateway. Only IPv4 is supported. This field can + * be set only for Classic VPN tunnels. * * Generated from protobuf field optional string peer_ip = 383249700; * @return string @@ -737,7 +974,8 @@ public function clearPeerIp() } /** - * IP address of the peer VPN gateway. Only IPv4 is supported. This field can be set only for Classic VPN tunnels. + * IP address of the peer VPN gateway. Only IPv4 is supported. This field can + * be set only for Classic VPN tunnels. * * Generated from protobuf field optional string peer_ip = 383249700; * @param string $var @@ -752,7 +990,9 @@ public function setPeerIp($var) } /** - * [Output Only] URL of the region where the VPN tunnel resides. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * [Output Only] URL of the region where the VPN tunnel resides. + * You must specify this field as part of the HTTP request URL. It is + * not settable as a field in the request body. * * Generated from protobuf field optional string region = 138946292; * @return string @@ -773,7 +1013,9 @@ public function clearRegion() } /** - * [Output Only] URL of the region where the VPN tunnel resides. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. + * [Output Only] URL of the region where the VPN tunnel resides. + * You must specify this field as part of the HTTP request URL. It is + * not settable as a field in the request body. * * Generated from protobuf field optional string region = 138946292; * @param string $var @@ -788,7 +1030,11 @@ public function setRegion($var) } /** - * Remote traffic selectors to use when establishing the VPN tunnel with the peer VPN gateway. The value should be a CIDR formatted string, for example: 192.168.0.0/16. The ranges should be disjoint. Only IPv4 is supported for Classic VPN tunnels. This field is output only for HA VPN tunnels. + * Remote traffic selectors to use when establishing the VPN tunnel with + * the peer VPN gateway. The value should be a CIDR formatted string, + * for example: 192.168.0.0/16. The ranges should be disjoint. Only IPv4 is + * supported for Classic VPN tunnels. This field is output only for HA VPN + * tunnels. * * Generated from protobuf field repeated string remote_traffic_selector = 358887098; * @return \Google\Protobuf\Internal\RepeatedField @@ -799,7 +1045,11 @@ public function getRemoteTrafficSelector() } /** - * Remote traffic selectors to use when establishing the VPN tunnel with the peer VPN gateway. The value should be a CIDR formatted string, for example: 192.168.0.0/16. The ranges should be disjoint. Only IPv4 is supported for Classic VPN tunnels. This field is output only for HA VPN tunnels. + * Remote traffic selectors to use when establishing the VPN tunnel with + * the peer VPN gateway. The value should be a CIDR formatted string, + * for example: 192.168.0.0/16. The ranges should be disjoint. Only IPv4 is + * supported for Classic VPN tunnels. This field is output only for HA VPN + * tunnels. * * Generated from protobuf field repeated string remote_traffic_selector = 358887098; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -886,7 +1136,8 @@ public function setSelfLink($var) } /** - * Shared secret used to set the secure session between the Cloud VPN gateway and the peer VPN gateway. + * Shared secret used to set the secure session between the Cloud VPN gateway + * and the peer VPN gateway. * * Generated from protobuf field optional string shared_secret = 381932490; * @return string @@ -907,7 +1158,8 @@ public function clearSharedSecret() } /** - * Shared secret used to set the secure session between the Cloud VPN gateway and the peer VPN gateway. + * Shared secret used to set the secure session between the Cloud VPN gateway + * and the peer VPN gateway. * * Generated from protobuf field optional string shared_secret = 381932490; * @param string $var @@ -958,7 +1210,37 @@ public function setSharedSecretHash($var) } /** - * [Output Only] The status of the VPN tunnel, which can be one of the following: - PROVISIONING: Resource is being allocated for the VPN tunnel. - WAITING_FOR_FULL_CONFIG: Waiting to receive all VPN-related configs from the user. Network, TargetVpnGateway, VpnTunnel, ForwardingRule, and Route resources are needed to setup the VPN tunnel. - FIRST_HANDSHAKE: Successful first handshake with the peer VPN. - ESTABLISHED: Secure session is successfully established with the peer VPN. - NETWORK_ERROR: Deprecated, replaced by NO_INCOMING_PACKETS - AUTHORIZATION_ERROR: Auth error (for example, bad shared secret). - NEGOTIATION_FAILURE: Handshake failed. - DEPROVISIONING: Resources are being deallocated for the VPN tunnel. - FAILED: Tunnel creation has failed and the tunnel is not ready to be used. - NO_INCOMING_PACKETS: No incoming packets from peer. - REJECTED: Tunnel configuration was rejected, can be result of being denied access. - ALLOCATING_RESOURCES: Cloud VPN is in the process of allocating all required resources. - STOPPED: Tunnel is stopped due to its Forwarding Rules being deleted for Classic VPN tunnels or the project is in frozen state. - PEER_IDENTITY_MISMATCH: Peer identity does not match peer IP, probably behind NAT. - TS_NARROWING_NOT_ALLOWED: Traffic selector narrowing not allowed for an HA-VPN tunnel. + * [Output Only] The status of the VPN tunnel, which can be one of the + * following: + * - PROVISIONING: Resource is being allocated for the VPN tunnel. + * - WAITING_FOR_FULL_CONFIG: Waiting to receive all VPN-related configs + * from + * the user. Network, TargetVpnGateway, VpnTunnel, ForwardingRule, and Route + * resources are needed to setup the VPN tunnel. + * - FIRST_HANDSHAKE: Successful first handshake with the peer VPN. + * - ESTABLISHED: Secure session is successfully established with the peer + * VPN. + * - NETWORK_ERROR: Deprecated, replaced by + * NO_INCOMING_PACKETS + * - AUTHORIZATION_ERROR: Auth error (for example, + * bad shared secret). + * - NEGOTIATION_FAILURE: Handshake failed. + * - DEPROVISIONING: Resources are being deallocated for the VPN + * tunnel. + * - FAILED: Tunnel creation has failed and the tunnel is not + * ready to be used. + * - NO_INCOMING_PACKETS: No incoming packets from + * peer. + * - REJECTED: Tunnel configuration was rejected, can be result + * of being denied access. + * - ALLOCATING_RESOURCES: Cloud VPN is in the + * process of allocating all required resources. + * - STOPPED: Tunnel is stopped due to its Forwarding Rules being deleted + * for Classic VPN tunnels or the project is in frozen state. + * - PEER_IDENTITY_MISMATCH: Peer identity does not match peer IP, + * probably behind NAT. + * - TS_NARROWING_NOT_ALLOWED: Traffic selector + * narrowing not allowed for an HA-VPN tunnel. * Check the Status enum for the list of possible values. * * Generated from protobuf field optional string status = 181260274; @@ -980,7 +1262,37 @@ public function clearStatus() } /** - * [Output Only] The status of the VPN tunnel, which can be one of the following: - PROVISIONING: Resource is being allocated for the VPN tunnel. - WAITING_FOR_FULL_CONFIG: Waiting to receive all VPN-related configs from the user. Network, TargetVpnGateway, VpnTunnel, ForwardingRule, and Route resources are needed to setup the VPN tunnel. - FIRST_HANDSHAKE: Successful first handshake with the peer VPN. - ESTABLISHED: Secure session is successfully established with the peer VPN. - NETWORK_ERROR: Deprecated, replaced by NO_INCOMING_PACKETS - AUTHORIZATION_ERROR: Auth error (for example, bad shared secret). - NEGOTIATION_FAILURE: Handshake failed. - DEPROVISIONING: Resources are being deallocated for the VPN tunnel. - FAILED: Tunnel creation has failed and the tunnel is not ready to be used. - NO_INCOMING_PACKETS: No incoming packets from peer. - REJECTED: Tunnel configuration was rejected, can be result of being denied access. - ALLOCATING_RESOURCES: Cloud VPN is in the process of allocating all required resources. - STOPPED: Tunnel is stopped due to its Forwarding Rules being deleted for Classic VPN tunnels or the project is in frozen state. - PEER_IDENTITY_MISMATCH: Peer identity does not match peer IP, probably behind NAT. - TS_NARROWING_NOT_ALLOWED: Traffic selector narrowing not allowed for an HA-VPN tunnel. + * [Output Only] The status of the VPN tunnel, which can be one of the + * following: + * - PROVISIONING: Resource is being allocated for the VPN tunnel. + * - WAITING_FOR_FULL_CONFIG: Waiting to receive all VPN-related configs + * from + * the user. Network, TargetVpnGateway, VpnTunnel, ForwardingRule, and Route + * resources are needed to setup the VPN tunnel. + * - FIRST_HANDSHAKE: Successful first handshake with the peer VPN. + * - ESTABLISHED: Secure session is successfully established with the peer + * VPN. + * - NETWORK_ERROR: Deprecated, replaced by + * NO_INCOMING_PACKETS + * - AUTHORIZATION_ERROR: Auth error (for example, + * bad shared secret). + * - NEGOTIATION_FAILURE: Handshake failed. + * - DEPROVISIONING: Resources are being deallocated for the VPN + * tunnel. + * - FAILED: Tunnel creation has failed and the tunnel is not + * ready to be used. + * - NO_INCOMING_PACKETS: No incoming packets from + * peer. + * - REJECTED: Tunnel configuration was rejected, can be result + * of being denied access. + * - ALLOCATING_RESOURCES: Cloud VPN is in the + * process of allocating all required resources. + * - STOPPED: Tunnel is stopped due to its Forwarding Rules being deleted + * for Classic VPN tunnels or the project is in frozen state. + * - PEER_IDENTITY_MISMATCH: Peer identity does not match peer IP, + * probably behind NAT. + * - TS_NARROWING_NOT_ALLOWED: Traffic selector + * narrowing not allowed for an HA-VPN tunnel. * Check the Status enum for the list of possible values. * * Generated from protobuf field optional string status = 181260274; @@ -996,7 +1308,9 @@ public function setStatus($var) } /** - * URL of the Target VPN gateway with which this VPN tunnel is associated. Provided by the client when the VPN tunnel is created. This field can be set only for Classic VPN tunnels. + * URL of the Target VPN gateway with which this VPN tunnel is associated. + * Provided by the client when the VPN tunnel is created. + * This field can be set only for Classic VPN tunnels. * * Generated from protobuf field optional string target_vpn_gateway = 532512843; * @return string @@ -1017,7 +1331,9 @@ public function clearTargetVpnGateway() } /** - * URL of the Target VPN gateway with which this VPN tunnel is associated. Provided by the client when the VPN tunnel is created. This field can be set only for Classic VPN tunnels. + * URL of the Target VPN gateway with which this VPN tunnel is associated. + * Provided by the client when the VPN tunnel is created. + * This field can be set only for Classic VPN tunnels. * * Generated from protobuf field optional string target_vpn_gateway = 532512843; * @param string $var @@ -1032,7 +1348,10 @@ public function setTargetVpnGateway($var) } /** - * URL of the VPN gateway with which this VPN tunnel is associated. Provided by the client when the VPN tunnel is created. This must be used (instead of target_vpn_gateway) if a High Availability VPN gateway resource is created. + * URL of the VPN gateway with which this VPN tunnel is associated. + * Provided by the client when the VPN tunnel is created. This must be + * used (instead of target_vpn_gateway) if a High Availability VPN gateway + * resource is created. * * Generated from protobuf field optional string vpn_gateway = 406684153; * @return string @@ -1053,7 +1372,10 @@ public function clearVpnGateway() } /** - * URL of the VPN gateway with which this VPN tunnel is associated. Provided by the client when the VPN tunnel is created. This must be used (instead of target_vpn_gateway) if a High Availability VPN gateway resource is created. + * URL of the VPN gateway with which this VPN tunnel is associated. + * Provided by the client when the VPN tunnel is created. This must be + * used (instead of target_vpn_gateway) if a High Availability VPN gateway + * resource is created. * * Generated from protobuf field optional string vpn_gateway = 406684153; * @param string $var @@ -1068,7 +1390,9 @@ public function setVpnGateway($var) } /** - * The interface ID of the VPN gateway with which this VPN tunnel is associated. Possible values are: `0`, `1`. + * The interface ID of the VPN gateway with which this VPN tunnel is + * associated. + * Possible values are: `0`, `1`. * * Generated from protobuf field optional int32 vpn_gateway_interface = 95979123; * @return int @@ -1089,7 +1413,9 @@ public function clearVpnGatewayInterface() } /** - * The interface ID of the VPN gateway with which this VPN tunnel is associated. Possible values are: `0`, `1`. + * The interface ID of the VPN gateway with which this VPN tunnel is + * associated. + * Possible values are: `0`, `1`. * * Generated from protobuf field optional int32 vpn_gateway_interface = 95979123; * @param int $var diff --git a/Compute/src/V1/VpnTunnel/Status.php b/Compute/src/V1/VpnTunnel/Status.php index 7a61187f184d..4b9ca688f6c8 100644 --- a/Compute/src/V1/VpnTunnel/Status.php +++ b/Compute/src/V1/VpnTunnel/Status.php @@ -7,7 +7,37 @@ use UnexpectedValueException; /** - * [Output Only] The status of the VPN tunnel, which can be one of the following: - PROVISIONING: Resource is being allocated for the VPN tunnel. - WAITING_FOR_FULL_CONFIG: Waiting to receive all VPN-related configs from the user. Network, TargetVpnGateway, VpnTunnel, ForwardingRule, and Route resources are needed to setup the VPN tunnel. - FIRST_HANDSHAKE: Successful first handshake with the peer VPN. - ESTABLISHED: Secure session is successfully established with the peer VPN. - NETWORK_ERROR: Deprecated, replaced by NO_INCOMING_PACKETS - AUTHORIZATION_ERROR: Auth error (for example, bad shared secret). - NEGOTIATION_FAILURE: Handshake failed. - DEPROVISIONING: Resources are being deallocated for the VPN tunnel. - FAILED: Tunnel creation has failed and the tunnel is not ready to be used. - NO_INCOMING_PACKETS: No incoming packets from peer. - REJECTED: Tunnel configuration was rejected, can be result of being denied access. - ALLOCATING_RESOURCES: Cloud VPN is in the process of allocating all required resources. - STOPPED: Tunnel is stopped due to its Forwarding Rules being deleted for Classic VPN tunnels or the project is in frozen state. - PEER_IDENTITY_MISMATCH: Peer identity does not match peer IP, probably behind NAT. - TS_NARROWING_NOT_ALLOWED: Traffic selector narrowing not allowed for an HA-VPN tunnel. + * [Output Only] The status of the VPN tunnel, which can be one of the + * following: + * - PROVISIONING: Resource is being allocated for the VPN tunnel. + * - WAITING_FOR_FULL_CONFIG: Waiting to receive all VPN-related configs + * from + * the user. Network, TargetVpnGateway, VpnTunnel, ForwardingRule, and Route + * resources are needed to setup the VPN tunnel. + * - FIRST_HANDSHAKE: Successful first handshake with the peer VPN. + * - ESTABLISHED: Secure session is successfully established with the peer + * VPN. + * - NETWORK_ERROR: Deprecated, replaced by + * NO_INCOMING_PACKETS + * - AUTHORIZATION_ERROR: Auth error (for example, + * bad shared secret). + * - NEGOTIATION_FAILURE: Handshake failed. + * - DEPROVISIONING: Resources are being deallocated for the VPN + * tunnel. + * - FAILED: Tunnel creation has failed and the tunnel is not + * ready to be used. + * - NO_INCOMING_PACKETS: No incoming packets from + * peer. + * - REJECTED: Tunnel configuration was rejected, can be result + * of being denied access. + * - ALLOCATING_RESOURCES: Cloud VPN is in the + * process of allocating all required resources. + * - STOPPED: Tunnel is stopped due to its Forwarding Rules being deleted + * for Classic VPN tunnels or the project is in frozen state. + * - PEER_IDENTITY_MISMATCH: Peer identity does not match peer IP, + * probably behind NAT. + * - TS_NARROWING_NOT_ALLOWED: Traffic selector + * narrowing not allowed for an HA-VPN tunnel. * * Protobuf type google.cloud.compute.v1.VpnTunnel.Status */ @@ -20,7 +50,8 @@ class Status */ const UNDEFINED_STATUS = 0; /** - * Cloud VPN is in the process of allocating all required resources (specifically, a borg task). + * Cloud VPN is in the process of allocating all required resources + * (specifically, a borg task). * * Generated from protobuf enum ALLOCATING_RESOURCES = 320922816; */ @@ -92,7 +123,9 @@ class Status */ const STOPPED = 444276141; /** - * Waiting to receive all VPN-related configs from user. Network, TargetVpnGateway, VpnTunnel, ForwardingRule and Route resources are needed to setup VPN tunnel. + * Waiting to receive all VPN-related configs from user. Network, + * TargetVpnGateway, VpnTunnel, ForwardingRule and Route resources are + * needed to setup VPN tunnel. * * Generated from protobuf enum WAITING_FOR_FULL_CONFIG = 41640522; */ diff --git a/Compute/src/V1/VpnTunnelAggregatedList.php b/Compute/src/V1/VpnTunnelAggregatedList.php index d7621fbfabf3..1db01fca6bdf 100644 --- a/Compute/src/V1/VpnTunnelAggregatedList.php +++ b/Compute/src/V1/VpnTunnelAggregatedList.php @@ -27,13 +27,18 @@ class VpnTunnelAggregatedList extends \Google\Protobuf\Internal\Message */ private $items; /** - * [Output Only] Type of resource. Always compute#vpnTunnel for VPN tunnels. + * [Output Only] Type of resource. Always compute#vpnTunnel for + * VPN tunnels. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -68,9 +73,14 @@ class VpnTunnelAggregatedList extends \Google\Protobuf\Internal\Message * @type array|\Google\Protobuf\Internal\MapField $items * A list of VpnTunnelsScopedList resources. * @type string $kind - * [Output Only] Type of resource. Always compute#vpnTunnel for VPN tunnels. + * [Output Only] Type of resource. Always compute#vpnTunnel for + * VPN tunnels. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type array|\Google\Protobuf\Internal\RepeatedField $unreachables @@ -147,7 +157,8 @@ public function setItems($var) } /** - * [Output Only] Type of resource. Always compute#vpnTunnel for VPN tunnels. + * [Output Only] Type of resource. Always compute#vpnTunnel for + * VPN tunnels. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -168,7 +179,8 @@ public function clearKind() } /** - * [Output Only] Type of resource. Always compute#vpnTunnel for VPN tunnels. + * [Output Only] Type of resource. Always compute#vpnTunnel for + * VPN tunnels. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -183,7 +195,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -204,7 +220,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/VpnTunnelList.php b/Compute/src/V1/VpnTunnelList.php index 1ed0b01deeb7..9d492a50d2f0 100644 --- a/Compute/src/V1/VpnTunnelList.php +++ b/Compute/src/V1/VpnTunnelList.php @@ -28,13 +28,18 @@ class VpnTunnelList extends \Google\Protobuf\Internal\Message */ private $items; /** - * [Output Only] Type of resource. Always compute#vpnTunnel for VPN tunnels. + * [Output Only] Type of resource. Always compute#vpnTunnel for + * VPN tunnels. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -63,9 +68,14 @@ class VpnTunnelList extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\VpnTunnel>|\Google\Protobuf\Internal\RepeatedField $items * A list of VpnTunnel resources. * @type string $kind - * [Output Only] Type of resource. Always compute#vpnTunnel for VPN tunnels. + * [Output Only] Type of resource. Always compute#vpnTunnel for + * VPN tunnels. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type \Google\Cloud\Compute\V1\Warning $warning @@ -140,7 +150,8 @@ public function setItems($var) } /** - * [Output Only] Type of resource. Always compute#vpnTunnel for VPN tunnels. + * [Output Only] Type of resource. Always compute#vpnTunnel for + * VPN tunnels. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -161,7 +172,8 @@ public function clearKind() } /** - * [Output Only] Type of resource. Always compute#vpnTunnel for VPN tunnels. + * [Output Only] Type of resource. Always compute#vpnTunnel for + * VPN tunnels. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -176,7 +188,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -197,7 +213,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/VpnTunnelsScopedList.php b/Compute/src/V1/VpnTunnelsScopedList.php index 2b38f71560da..7ec925ba56bc 100644 --- a/Compute/src/V1/VpnTunnelsScopedList.php +++ b/Compute/src/V1/VpnTunnelsScopedList.php @@ -21,7 +21,8 @@ class VpnTunnelsScopedList extends \Google\Protobuf\Internal\Message */ private $vpn_tunnels; /** - * Informational warning which replaces the list of addresses when the list is empty. + * Informational warning which replaces the list of addresses when + * the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; */ @@ -36,7 +37,8 @@ class VpnTunnelsScopedList extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\VpnTunnel>|\Google\Protobuf\Internal\RepeatedField $vpn_tunnels * A list of VPN tunnels contained in this scope. * @type \Google\Cloud\Compute\V1\Warning $warning - * Informational warning which replaces the list of addresses when the list is empty. + * Informational warning which replaces the list of addresses when + * the list is empty. * } */ public function __construct($data = NULL) { @@ -71,7 +73,8 @@ public function setVpnTunnels($var) } /** - * Informational warning which replaces the list of addresses when the list is empty. + * Informational warning which replaces the list of addresses when + * the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; * @return \Google\Cloud\Compute\V1\Warning|null @@ -92,7 +95,8 @@ public function clearWarning() } /** - * Informational warning which replaces the list of addresses when the list is empty. + * Informational warning which replaces the list of addresses when + * the list is empty. * * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; * @param \Google\Cloud\Compute\V1\Warning $var diff --git a/Compute/src/V1/WafExpressionSet.php b/Compute/src/V1/WafExpressionSet.php index 877303386e84..da03b65fc5d3 100644 --- a/Compute/src/V1/WafExpressionSet.php +++ b/Compute/src/V1/WafExpressionSet.php @@ -15,7 +15,12 @@ class WafExpressionSet extends \Google\Protobuf\Internal\Message { /** - * A list of alternate IDs. The format should be: - E.g. XSS-stable Generic suffix like "stable" is particularly useful if a policy likes to avail newer set of expressions without having to change the policy. A given alias name can't be used for more than one entity set. + * A list of alternate IDs. The format should be: + * - E.g. XSS-stable + * Generic suffix like "stable" is particularly useful if a policy + * likes to avail newer set of expressions without having to change + * the policy. + * A given alias name can't be used for more than one entity set. * * Generated from protobuf field repeated string aliases = 159207166; */ @@ -27,7 +32,9 @@ class WafExpressionSet extends \Google\Protobuf\Internal\Message */ private $expressions; /** - * Google specified expression set ID. The format should be: - E.g. XSS-20170329 required + * Google specified expression set ID. The format should be: + * - E.g. XSS-20170329 + * required * * Generated from protobuf field optional string id = 3355; */ @@ -40,11 +47,18 @@ class WafExpressionSet extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type array|\Google\Protobuf\Internal\RepeatedField $aliases - * A list of alternate IDs. The format should be: - E.g. XSS-stable Generic suffix like "stable" is particularly useful if a policy likes to avail newer set of expressions without having to change the policy. A given alias name can't be used for more than one entity set. + * A list of alternate IDs. The format should be: + * - E.g. XSS-stable + * Generic suffix like "stable" is particularly useful if a policy + * likes to avail newer set of expressions without having to change + * the policy. + * A given alias name can't be used for more than one entity set. * @type array<\Google\Cloud\Compute\V1\WafExpressionSetExpression>|\Google\Protobuf\Internal\RepeatedField $expressions * List of available expressions. * @type string $id - * Google specified expression set ID. The format should be: - E.g. XSS-20170329 required + * Google specified expression set ID. The format should be: + * - E.g. XSS-20170329 + * required * } */ public function __construct($data = NULL) { @@ -53,7 +67,12 @@ public function __construct($data = NULL) { } /** - * A list of alternate IDs. The format should be: - E.g. XSS-stable Generic suffix like "stable" is particularly useful if a policy likes to avail newer set of expressions without having to change the policy. A given alias name can't be used for more than one entity set. + * A list of alternate IDs. The format should be: + * - E.g. XSS-stable + * Generic suffix like "stable" is particularly useful if a policy + * likes to avail newer set of expressions without having to change + * the policy. + * A given alias name can't be used for more than one entity set. * * Generated from protobuf field repeated string aliases = 159207166; * @return \Google\Protobuf\Internal\RepeatedField @@ -64,7 +83,12 @@ public function getAliases() } /** - * A list of alternate IDs. The format should be: - E.g. XSS-stable Generic suffix like "stable" is particularly useful if a policy likes to avail newer set of expressions without having to change the policy. A given alias name can't be used for more than one entity set. + * A list of alternate IDs. The format should be: + * - E.g. XSS-stable + * Generic suffix like "stable" is particularly useful if a policy + * likes to avail newer set of expressions without having to change + * the policy. + * A given alias name can't be used for more than one entity set. * * Generated from protobuf field repeated string aliases = 159207166; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -105,7 +129,9 @@ public function setExpressions($var) } /** - * Google specified expression set ID. The format should be: - E.g. XSS-20170329 required + * Google specified expression set ID. The format should be: + * - E.g. XSS-20170329 + * required * * Generated from protobuf field optional string id = 3355; * @return string @@ -126,7 +152,9 @@ public function clearId() } /** - * Google specified expression set ID. The format should be: - E.g. XSS-20170329 required + * Google specified expression set ID. The format should be: + * - E.g. XSS-20170329 + * required * * Generated from protobuf field optional string id = 3355; * @param string $var diff --git a/Compute/src/V1/WafExpressionSetExpression.php b/Compute/src/V1/WafExpressionSetExpression.php index d0fe342d00eb..cef9bc6393df 100644 --- a/Compute/src/V1/WafExpressionSetExpression.php +++ b/Compute/src/V1/WafExpressionSetExpression.php @@ -15,13 +15,21 @@ class WafExpressionSetExpression extends \Google\Protobuf\Internal\Message { /** - * Expression ID should uniquely identify the origin of the expression. E.g. owasp-crs-v020901-id973337 identifies Owasp core rule set version 2.9.1 rule id 973337. The ID could be used to determine the individual attack definition that has been detected. It could also be used to exclude it from the policy in case of false positive. required + * Expression ID should uniquely identify the origin of the expression. + * E.g. owasp-crs-v020901-id973337 identifies Owasp core rule set + * version 2.9.1 rule id 973337. + * The ID could be used to determine the individual attack definition + * that has been detected. It could also be used to exclude it from + * the policy in case of false positive. + * required * * Generated from protobuf field optional string id = 3355; */ protected $id = null; /** - * The sensitivity value associated with the WAF rule ID. This corresponds to the ModSecurity paranoia level, ranging from 1 to 4. 0 is reserved for opt-in only rules. + * The sensitivity value associated with the WAF rule ID. This corresponds + * to the ModSecurity paranoia level, ranging from 1 to 4. 0 is reserved for + * opt-in only rules. * * Generated from protobuf field optional int32 sensitivity = 27532959; */ @@ -34,9 +42,17 @@ class WafExpressionSetExpression extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $id - * Expression ID should uniquely identify the origin of the expression. E.g. owasp-crs-v020901-id973337 identifies Owasp core rule set version 2.9.1 rule id 973337. The ID could be used to determine the individual attack definition that has been detected. It could also be used to exclude it from the policy in case of false positive. required + * Expression ID should uniquely identify the origin of the expression. + * E.g. owasp-crs-v020901-id973337 identifies Owasp core rule set + * version 2.9.1 rule id 973337. + * The ID could be used to determine the individual attack definition + * that has been detected. It could also be used to exclude it from + * the policy in case of false positive. + * required * @type int $sensitivity - * The sensitivity value associated with the WAF rule ID. This corresponds to the ModSecurity paranoia level, ranging from 1 to 4. 0 is reserved for opt-in only rules. + * The sensitivity value associated with the WAF rule ID. This corresponds + * to the ModSecurity paranoia level, ranging from 1 to 4. 0 is reserved for + * opt-in only rules. * } */ public function __construct($data = NULL) { @@ -45,7 +61,13 @@ public function __construct($data = NULL) { } /** - * Expression ID should uniquely identify the origin of the expression. E.g. owasp-crs-v020901-id973337 identifies Owasp core rule set version 2.9.1 rule id 973337. The ID could be used to determine the individual attack definition that has been detected. It could also be used to exclude it from the policy in case of false positive. required + * Expression ID should uniquely identify the origin of the expression. + * E.g. owasp-crs-v020901-id973337 identifies Owasp core rule set + * version 2.9.1 rule id 973337. + * The ID could be used to determine the individual attack definition + * that has been detected. It could also be used to exclude it from + * the policy in case of false positive. + * required * * Generated from protobuf field optional string id = 3355; * @return string @@ -66,7 +88,13 @@ public function clearId() } /** - * Expression ID should uniquely identify the origin of the expression. E.g. owasp-crs-v020901-id973337 identifies Owasp core rule set version 2.9.1 rule id 973337. The ID could be used to determine the individual attack definition that has been detected. It could also be used to exclude it from the policy in case of false positive. required + * Expression ID should uniquely identify the origin of the expression. + * E.g. owasp-crs-v020901-id973337 identifies Owasp core rule set + * version 2.9.1 rule id 973337. + * The ID could be used to determine the individual attack definition + * that has been detected. It could also be used to exclude it from + * the policy in case of false positive. + * required * * Generated from protobuf field optional string id = 3355; * @param string $var @@ -81,7 +109,9 @@ public function setId($var) } /** - * The sensitivity value associated with the WAF rule ID. This corresponds to the ModSecurity paranoia level, ranging from 1 to 4. 0 is reserved for opt-in only rules. + * The sensitivity value associated with the WAF rule ID. This corresponds + * to the ModSecurity paranoia level, ranging from 1 to 4. 0 is reserved for + * opt-in only rules. * * Generated from protobuf field optional int32 sensitivity = 27532959; * @return int @@ -102,7 +132,9 @@ public function clearSensitivity() } /** - * The sensitivity value associated with the WAF rule ID. This corresponds to the ModSecurity paranoia level, ranging from 1 to 4. 0 is reserved for opt-in only rules. + * The sensitivity value associated with the WAF rule ID. This corresponds + * to the ModSecurity paranoia level, ranging from 1 to 4. 0 is reserved for + * opt-in only rules. * * Generated from protobuf field optional int32 sensitivity = 27532959; * @param int $var diff --git a/Compute/src/V1/WaitGlobalOperationRequest.php b/Compute/src/V1/WaitGlobalOperationRequest.php index 37b5652b88e6..a50072457050 100644 --- a/Compute/src/V1/WaitGlobalOperationRequest.php +++ b/Compute/src/V1/WaitGlobalOperationRequest.php @@ -16,7 +16,8 @@ class WaitGlobalOperationRequest extends \Google\Protobuf\Internal\Message { /** - * Name of the Operations resource to return, or its unique numeric identifier. + * Name of the Operations resource to return, or its unique numeric + * identifier. * * Generated from protobuf field string operation = 52090215 [(.google.api.field_behavior) = REQUIRED]; */ @@ -30,7 +31,8 @@ class WaitGlobalOperationRequest extends \Google\Protobuf\Internal\Message /** * @param string $project Project ID for this request. - * @param string $operation Name of the Operations resource to return, or its unique numeric identifier. + * @param string $operation Name of the Operations resource to return, or its unique numeric + * identifier. * * @return \Google\Cloud\Compute\V1\WaitGlobalOperationRequest * @@ -50,7 +52,8 @@ public static function build(string $project, string $operation): self * Optional. Data for populating the Message object. * * @type string $operation - * Name of the Operations resource to return, or its unique numeric identifier. + * Name of the Operations resource to return, or its unique numeric + * identifier. * @type string $project * Project ID for this request. * } @@ -61,7 +64,8 @@ public function __construct($data = NULL) { } /** - * Name of the Operations resource to return, or its unique numeric identifier. + * Name of the Operations resource to return, or its unique numeric + * identifier. * * Generated from protobuf field string operation = 52090215 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -72,7 +76,8 @@ public function getOperation() } /** - * Name of the Operations resource to return, or its unique numeric identifier. + * Name of the Operations resource to return, or its unique numeric + * identifier. * * Generated from protobuf field string operation = 52090215 [(.google.api.field_behavior) = REQUIRED]; * @param string $var diff --git a/Compute/src/V1/WaitRegionOperationRequest.php b/Compute/src/V1/WaitRegionOperationRequest.php index 65f6bda9e111..c77ab371a504 100644 --- a/Compute/src/V1/WaitRegionOperationRequest.php +++ b/Compute/src/V1/WaitRegionOperationRequest.php @@ -16,7 +16,8 @@ class WaitRegionOperationRequest extends \Google\Protobuf\Internal\Message { /** - * Name of the Operations resource to return, or its unique numeric identifier. + * Name of the Operations resource to return, or its unique numeric + * identifier. * * Generated from protobuf field string operation = 52090215 [(.google.api.field_behavior) = REQUIRED]; */ @@ -37,7 +38,8 @@ class WaitRegionOperationRequest extends \Google\Protobuf\Internal\Message /** * @param string $project Project ID for this request. * @param string $region Name of the region for this request. - * @param string $operation Name of the Operations resource to return, or its unique numeric identifier. + * @param string $operation Name of the Operations resource to return, or its unique numeric + * identifier. * * @return \Google\Cloud\Compute\V1\WaitRegionOperationRequest * @@ -58,7 +60,8 @@ public static function build(string $project, string $region, string $operation) * Optional. Data for populating the Message object. * * @type string $operation - * Name of the Operations resource to return, or its unique numeric identifier. + * Name of the Operations resource to return, or its unique numeric + * identifier. * @type string $project * Project ID for this request. * @type string $region @@ -71,7 +74,8 @@ public function __construct($data = NULL) { } /** - * Name of the Operations resource to return, or its unique numeric identifier. + * Name of the Operations resource to return, or its unique numeric + * identifier. * * Generated from protobuf field string operation = 52090215 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -82,7 +86,8 @@ public function getOperation() } /** - * Name of the Operations resource to return, or its unique numeric identifier. + * Name of the Operations resource to return, or its unique numeric + * identifier. * * Generated from protobuf field string operation = 52090215 [(.google.api.field_behavior) = REQUIRED]; * @param string $var diff --git a/Compute/src/V1/WaitZoneOperationRequest.php b/Compute/src/V1/WaitZoneOperationRequest.php index 338ec4c5312c..9b038ddaa45a 100644 --- a/Compute/src/V1/WaitZoneOperationRequest.php +++ b/Compute/src/V1/WaitZoneOperationRequest.php @@ -16,7 +16,8 @@ class WaitZoneOperationRequest extends \Google\Protobuf\Internal\Message { /** - * Name of the Operations resource to return, or its unique numeric identifier. + * Name of the Operations resource to return, or its unique numeric + * identifier. * * Generated from protobuf field string operation = 52090215 [(.google.api.field_behavior) = REQUIRED]; */ @@ -37,7 +38,8 @@ class WaitZoneOperationRequest extends \Google\Protobuf\Internal\Message /** * @param string $project Project ID for this request. * @param string $zone Name of the zone for this request. - * @param string $operation Name of the Operations resource to return, or its unique numeric identifier. + * @param string $operation Name of the Operations resource to return, or its unique numeric + * identifier. * * @return \Google\Cloud\Compute\V1\WaitZoneOperationRequest * @@ -58,7 +60,8 @@ public static function build(string $project, string $zone, string $operation): * Optional. Data for populating the Message object. * * @type string $operation - * Name of the Operations resource to return, or its unique numeric identifier. + * Name of the Operations resource to return, or its unique numeric + * identifier. * @type string $project * Project ID for this request. * @type string $zone @@ -71,7 +74,8 @@ public function __construct($data = NULL) { } /** - * Name of the Operations resource to return, or its unique numeric identifier. + * Name of the Operations resource to return, or its unique numeric + * identifier. * * Generated from protobuf field string operation = 52090215 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -82,7 +86,8 @@ public function getOperation() } /** - * Name of the Operations resource to return, or its unique numeric identifier. + * Name of the Operations resource to return, or its unique numeric + * identifier. * * Generated from protobuf field string operation = 52090215 [(.google.api.field_behavior) = REQUIRED]; * @param string $var diff --git a/Compute/src/V1/Warning.php b/Compute/src/V1/Warning.php index b272184e022d..1b8f164691a2 100644 --- a/Compute/src/V1/Warning.php +++ b/Compute/src/V1/Warning.php @@ -16,14 +16,22 @@ class Warning extends \Google\Protobuf\Internal\Message { /** - * [Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response. + * [Output Only] A warning code, if applicable. For example, Compute + * Engine returns NO_RESULTS_ON_PAGE if there + * are no results in the response. * Check the Code enum for the list of possible values. * * Generated from protobuf field optional string code = 3059181; */ protected $code = null; /** - * [Output Only] Metadata about this warning in key: value format. For example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + * [Output Only] Metadata about this warning in key: + * value format. For example: + * "data": [ + * { + * "key": "scope", + * "value": "zones/us-east1-d" + * } * * Generated from protobuf field repeated .google.cloud.compute.v1.Data data = 3076010; */ @@ -42,10 +50,18 @@ class Warning extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $code - * [Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response. + * [Output Only] A warning code, if applicable. For example, Compute + * Engine returns NO_RESULTS_ON_PAGE if there + * are no results in the response. * Check the Code enum for the list of possible values. * @type array<\Google\Cloud\Compute\V1\Data>|\Google\Protobuf\Internal\RepeatedField $data - * [Output Only] Metadata about this warning in key: value format. For example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + * [Output Only] Metadata about this warning in key: + * value format. For example: + * "data": [ + * { + * "key": "scope", + * "value": "zones/us-east1-d" + * } * @type string $message * [Output Only] A human-readable description of the warning code. * } @@ -56,7 +72,9 @@ public function __construct($data = NULL) { } /** - * [Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response. + * [Output Only] A warning code, if applicable. For example, Compute + * Engine returns NO_RESULTS_ON_PAGE if there + * are no results in the response. * Check the Code enum for the list of possible values. * * Generated from protobuf field optional string code = 3059181; @@ -78,7 +96,9 @@ public function clearCode() } /** - * [Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response. + * [Output Only] A warning code, if applicable. For example, Compute + * Engine returns NO_RESULTS_ON_PAGE if there + * are no results in the response. * Check the Code enum for the list of possible values. * * Generated from protobuf field optional string code = 3059181; @@ -94,7 +114,13 @@ public function setCode($var) } /** - * [Output Only] Metadata about this warning in key: value format. For example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + * [Output Only] Metadata about this warning in key: + * value format. For example: + * "data": [ + * { + * "key": "scope", + * "value": "zones/us-east1-d" + * } * * Generated from protobuf field repeated .google.cloud.compute.v1.Data data = 3076010; * @return \Google\Protobuf\Internal\RepeatedField @@ -105,7 +131,13 @@ public function getData() } /** - * [Output Only] Metadata about this warning in key: value format. For example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + * [Output Only] Metadata about this warning in key: + * value format. For example: + * "data": [ + * { + * "key": "scope", + * "value": "zones/us-east1-d" + * } * * Generated from protobuf field repeated .google.cloud.compute.v1.Data data = 3076010; * @param array<\Google\Cloud\Compute\V1\Data>|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/Warning/Code.php b/Compute/src/V1/Warning/Code.php index b8450860eacd..14c66feff673 100644 --- a/Compute/src/V1/Warning/Code.php +++ b/Compute/src/V1/Warning/Code.php @@ -7,7 +7,9 @@ use UnexpectedValueException; /** - * [Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response. + * [Output Only] A warning code, if applicable. For example, Compute + * Engine returns NO_RESULTS_ON_PAGE if there + * are no results in the response. * * Protobuf type google.cloud.compute.v1.Warning.Code */ @@ -20,7 +22,8 @@ class Code */ const UNDEFINED_CODE = 0; /** - * Warning about failed cleanup of transient changes made by a failed operation. + * Warning about failed cleanup of transient changes made by a failed + * operation. * * Generated from protobuf enum CLEANUP_FAILED = 150308440; */ @@ -32,7 +35,8 @@ class Code */ const DEPRECATED_RESOURCE_USED = 391835586; /** - * When deploying and at least one of the resources has a type marked as deprecated + * When deploying and at least one of the resources has a type marked as + * deprecated * * Generated from protobuf enum DEPRECATED_TYPE_USED = 346526230; */ @@ -44,7 +48,8 @@ class Code */ const DISK_SIZE_LARGER_THAN_IMAGE_SIZE = 369442967; /** - * When deploying and at least one of the resources has a type marked as experimental + * When deploying and at least one of the resources has a type marked as + * experimental * * Generated from protobuf enum EXPERIMENTAL_TYPE_USED = 451954443; */ @@ -56,7 +61,8 @@ class Code */ const EXTERNAL_API_WARNING = 175546307; /** - * Warning that value of a field has been overridden. Deprecated unused field. + * Warning that value of a field has been overridden. + * Deprecated unused field. * * Generated from protobuf enum FIELD_VALUE_OVERRIDEN = 329669423; */ @@ -68,7 +74,8 @@ class Code */ const INJECTED_KERNELS_DEPRECATED = 417377419; /** - * A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2. + * A WEIGHTED_MAGLEV backend service is associated with a health check that is + * not of type HTTP/HTTPS/HTTP2. * * Generated from protobuf enum INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB = 401542606; */ @@ -80,7 +87,9 @@ class Code */ const LARGE_DEPLOYMENT_WARNING = 481440678; /** - * Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter. + * Resource can't be retrieved due to list overhead quota exceed + * which captures the amount of resources filtered out by + * user-defined list filter. * * Generated from protobuf enum LIST_OVERHEAD_QUOTA_EXCEED = 47618117; */ @@ -92,7 +101,8 @@ class Code */ const MISSING_TYPE_DEPENDENCY = 344505463; /** - * The route's nextHopIp address is not assigned to an instance on the network. + * The route's nextHopIp address is not assigned to an instance on the + * network. * * Generated from protobuf enum NEXT_HOP_ADDRESS_NOT_ASSIGNED = 324964999; */ @@ -104,7 +114,8 @@ class Code */ const NEXT_HOP_CANNOT_IP_FORWARD = 383382887; /** - * The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route. + * The route's nextHopInstance URL refers to an instance that does not have an + * ipv6 interface on the same network as the route. * * Generated from protobuf enum NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE = 146748434; */ @@ -116,7 +127,8 @@ class Code */ const NEXT_HOP_INSTANCE_NOT_FOUND = 464250446; /** - * The route's nextHopInstance URL refers to an instance that is not on the same network as the route. + * The route's nextHopInstance URL refers to an instance that is not on the + * same network as the route. * * Generated from protobuf enum NEXT_HOP_INSTANCE_NOT_ON_NETWORK = 243758146; */ @@ -128,7 +140,8 @@ class Code */ const NEXT_HOP_NOT_RUNNING = 417081265; /** - * Error which is not critical. We decided to continue the process despite the mentioned error. + * Error which is not critical. We decided to continue the process despite + * the mentioned error. * * Generated from protobuf enum NOT_CRITICAL_ERROR = 105763924; */ @@ -146,13 +159,15 @@ class Code */ const PARTIAL_SUCCESS = 39966469; /** - * Quota information is not available to client requests (e.g: regions.list). + * Quota information is not available to client requests (e.g: + * regions.list). * * Generated from protobuf enum QUOTA_INFO_UNAVAILABLE = 304294182; */ const QUOTA_INFO_UNAVAILABLE = 304294182; /** - * The user attempted to use a resource that requires a TOS they have not accepted. + * The user attempted to use a resource that requires a TOS they have not + * accepted. * * Generated from protobuf enum REQUIRED_TOS_AGREEMENT = 3745539; */ @@ -164,7 +179,8 @@ class Code */ const RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING = 496728641; /** - * One or more of the resources set to auto-delete could not be deleted because they were in use. + * One or more of the resources set to auto-delete could not be deleted + * because they were in use. * * Generated from protobuf enum RESOURCE_NOT_DELETED = 168598460; */ @@ -176,7 +192,9 @@ class Code */ const SCHEMA_VALIDATION_IGNORED = 275245642; /** - * Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group. + * Instance template used in instance group manager is valid as such, but + * its application does not make a lot of sense, because it allows only + * single instance in instance group. * * Generated from protobuf enum SINGLE_INSTANCE_PROPERTY_TEMPLATE = 268305617; */ diff --git a/Compute/src/V1/Warnings.php b/Compute/src/V1/Warnings.php index 09c309f0e52f..b405a5733758 100644 --- a/Compute/src/V1/Warnings.php +++ b/Compute/src/V1/Warnings.php @@ -15,14 +15,22 @@ class Warnings extends \Google\Protobuf\Internal\Message { /** - * [Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response. + * [Output Only] A warning code, if applicable. For example, Compute + * Engine returns NO_RESULTS_ON_PAGE if there + * are no results in the response. * Check the Code enum for the list of possible values. * * Generated from protobuf field optional string code = 3059181; */ protected $code = null; /** - * [Output Only] Metadata about this warning in key: value format. For example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + * [Output Only] Metadata about this warning in key: + * value format. For example: + * "data": [ + * { + * "key": "scope", + * "value": "zones/us-east1-d" + * } * * Generated from protobuf field repeated .google.cloud.compute.v1.Data data = 3076010; */ @@ -41,10 +49,18 @@ class Warnings extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $code - * [Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response. + * [Output Only] A warning code, if applicable. For example, Compute + * Engine returns NO_RESULTS_ON_PAGE if there + * are no results in the response. * Check the Code enum for the list of possible values. * @type array<\Google\Cloud\Compute\V1\Data>|\Google\Protobuf\Internal\RepeatedField $data - * [Output Only] Metadata about this warning in key: value format. For example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + * [Output Only] Metadata about this warning in key: + * value format. For example: + * "data": [ + * { + * "key": "scope", + * "value": "zones/us-east1-d" + * } * @type string $message * [Output Only] A human-readable description of the warning code. * } @@ -55,7 +71,9 @@ public function __construct($data = NULL) { } /** - * [Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response. + * [Output Only] A warning code, if applicable. For example, Compute + * Engine returns NO_RESULTS_ON_PAGE if there + * are no results in the response. * Check the Code enum for the list of possible values. * * Generated from protobuf field optional string code = 3059181; @@ -77,7 +95,9 @@ public function clearCode() } /** - * [Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response. + * [Output Only] A warning code, if applicable. For example, Compute + * Engine returns NO_RESULTS_ON_PAGE if there + * are no results in the response. * Check the Code enum for the list of possible values. * * Generated from protobuf field optional string code = 3059181; @@ -93,7 +113,13 @@ public function setCode($var) } /** - * [Output Only] Metadata about this warning in key: value format. For example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + * [Output Only] Metadata about this warning in key: + * value format. For example: + * "data": [ + * { + * "key": "scope", + * "value": "zones/us-east1-d" + * } * * Generated from protobuf field repeated .google.cloud.compute.v1.Data data = 3076010; * @return \Google\Protobuf\Internal\RepeatedField @@ -104,7 +130,13 @@ public function getData() } /** - * [Output Only] Metadata about this warning in key: value format. For example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + * [Output Only] Metadata about this warning in key: + * value format. For example: + * "data": [ + * { + * "key": "scope", + * "value": "zones/us-east1-d" + * } * * Generated from protobuf field repeated .google.cloud.compute.v1.Data data = 3076010; * @param array<\Google\Cloud\Compute\V1\Data>|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Compute/src/V1/Warnings/Code.php b/Compute/src/V1/Warnings/Code.php index af69ad22779f..e263c00b7a44 100644 --- a/Compute/src/V1/Warnings/Code.php +++ b/Compute/src/V1/Warnings/Code.php @@ -7,7 +7,9 @@ use UnexpectedValueException; /** - * [Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response. + * [Output Only] A warning code, if applicable. For example, Compute + * Engine returns NO_RESULTS_ON_PAGE if there + * are no results in the response. * * Protobuf type google.cloud.compute.v1.Warnings.Code */ @@ -20,7 +22,8 @@ class Code */ const UNDEFINED_CODE = 0; /** - * Warning about failed cleanup of transient changes made by a failed operation. + * Warning about failed cleanup of transient changes made by a failed + * operation. * * Generated from protobuf enum CLEANUP_FAILED = 150308440; */ @@ -32,7 +35,8 @@ class Code */ const DEPRECATED_RESOURCE_USED = 391835586; /** - * When deploying and at least one of the resources has a type marked as deprecated + * When deploying and at least one of the resources has a type marked as + * deprecated * * Generated from protobuf enum DEPRECATED_TYPE_USED = 346526230; */ @@ -44,7 +48,8 @@ class Code */ const DISK_SIZE_LARGER_THAN_IMAGE_SIZE = 369442967; /** - * When deploying and at least one of the resources has a type marked as experimental + * When deploying and at least one of the resources has a type marked as + * experimental * * Generated from protobuf enum EXPERIMENTAL_TYPE_USED = 451954443; */ @@ -56,7 +61,8 @@ class Code */ const EXTERNAL_API_WARNING = 175546307; /** - * Warning that value of a field has been overridden. Deprecated unused field. + * Warning that value of a field has been overridden. + * Deprecated unused field. * * Generated from protobuf enum FIELD_VALUE_OVERRIDEN = 329669423; */ @@ -68,7 +74,8 @@ class Code */ const INJECTED_KERNELS_DEPRECATED = 417377419; /** - * A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2. + * A WEIGHTED_MAGLEV backend service is associated with a health check that is + * not of type HTTP/HTTPS/HTTP2. * * Generated from protobuf enum INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB = 401542606; */ @@ -80,7 +87,9 @@ class Code */ const LARGE_DEPLOYMENT_WARNING = 481440678; /** - * Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter. + * Resource can't be retrieved due to list overhead quota exceed + * which captures the amount of resources filtered out by + * user-defined list filter. * * Generated from protobuf enum LIST_OVERHEAD_QUOTA_EXCEED = 47618117; */ @@ -92,7 +101,8 @@ class Code */ const MISSING_TYPE_DEPENDENCY = 344505463; /** - * The route's nextHopIp address is not assigned to an instance on the network. + * The route's nextHopIp address is not assigned to an instance on the + * network. * * Generated from protobuf enum NEXT_HOP_ADDRESS_NOT_ASSIGNED = 324964999; */ @@ -104,7 +114,8 @@ class Code */ const NEXT_HOP_CANNOT_IP_FORWARD = 383382887; /** - * The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route. + * The route's nextHopInstance URL refers to an instance that does not have an + * ipv6 interface on the same network as the route. * * Generated from protobuf enum NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE = 146748434; */ @@ -116,7 +127,8 @@ class Code */ const NEXT_HOP_INSTANCE_NOT_FOUND = 464250446; /** - * The route's nextHopInstance URL refers to an instance that is not on the same network as the route. + * The route's nextHopInstance URL refers to an instance that is not on the + * same network as the route. * * Generated from protobuf enum NEXT_HOP_INSTANCE_NOT_ON_NETWORK = 243758146; */ @@ -128,7 +140,8 @@ class Code */ const NEXT_HOP_NOT_RUNNING = 417081265; /** - * Error which is not critical. We decided to continue the process despite the mentioned error. + * Error which is not critical. We decided to continue the process despite + * the mentioned error. * * Generated from protobuf enum NOT_CRITICAL_ERROR = 105763924; */ @@ -146,13 +159,15 @@ class Code */ const PARTIAL_SUCCESS = 39966469; /** - * Quota information is not available to client requests (e.g: regions.list). + * Quota information is not available to client requests (e.g: + * regions.list). * * Generated from protobuf enum QUOTA_INFO_UNAVAILABLE = 304294182; */ const QUOTA_INFO_UNAVAILABLE = 304294182; /** - * The user attempted to use a resource that requires a TOS they have not accepted. + * The user attempted to use a resource that requires a TOS they have not + * accepted. * * Generated from protobuf enum REQUIRED_TOS_AGREEMENT = 3745539; */ @@ -164,7 +179,8 @@ class Code */ const RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING = 496728641; /** - * One or more of the resources set to auto-delete could not be deleted because they were in use. + * One or more of the resources set to auto-delete could not be deleted + * because they were in use. * * Generated from protobuf enum RESOURCE_NOT_DELETED = 168598460; */ @@ -176,7 +192,9 @@ class Code */ const SCHEMA_VALIDATION_IGNORED = 275245642; /** - * Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group. + * Instance template used in instance group manager is valid as such, but + * its application does not make a lot of sense, because it allows only + * single instance in instance group. * * Generated from protobuf enum SINGLE_INSTANCE_PROPERTY_TEMPLATE = 268305617; */ diff --git a/Compute/src/V1/WeightedBackendService.php b/Compute/src/V1/WeightedBackendService.php index 94cb56256ff7..b5ca18a1a1ed 100644 --- a/Compute/src/V1/WeightedBackendService.php +++ b/Compute/src/V1/WeightedBackendService.php @@ -9,26 +9,48 @@ use Google\Protobuf\Internal\GPBUtil; /** - * In contrast to a single BackendService in HttpRouteAction to which all matching traffic is directed to, WeightedBackendService allows traffic to be split across multiple backend services. The volume of traffic for each backend service is proportional to the weight specified in each WeightedBackendService + * In contrast to a single BackendService in + * HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across + * multiple backend services. The volume of traffic for each + * backend service is proportional to the weight specified + * in each WeightedBackendService * * Generated from protobuf message google.cloud.compute.v1.WeightedBackendService */ class WeightedBackendService extends \Google\Protobuf\Internal\Message { /** - * The full or partial URL to the default BackendService resource. Before forwarding the request to backendService, the load balancer applies any relevant headerActions specified as part of this backendServiceWeight. + * The full or partial URL to the default BackendService + * resource. Before + * forwarding the request to backendService, the load balancer + * applies any relevant headerActions specified as part of thisbackendServiceWeight. * * Generated from protobuf field optional string backend_service = 306946058; */ protected $backend_service = null; /** - * Specifies changes to request and response headers that need to take effect for the selected backendService. headerAction specified here take effect before headerAction in the enclosing HttpRouteRule, PathMatcher and UrlMap. headerAction is not supported for load balancers that have their loadBalancingScheme set to EXTERNAL. Not supported when the URL map is bound to a target gRPC proxy that has validateForProxyless field set to true. + * Specifies changes to request and response headers that need to take + * effect for the selected backendService. + * headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap. + * headerAction is not supported for load balancers that have + * their loadBalancingScheme set to EXTERNAL. + * Not supported when the URL map is bound to a target gRPC proxy that + * has validateForProxyless field set to true. * * Generated from protobuf field optional .google.cloud.compute.v1.HttpHeaderAction header_action = 328077352; */ protected $header_action = null; /** - * Specifies the fraction of traffic sent to a backend service, computed as weight / (sum of all weightedBackendService weights in routeAction) . The selection of a backend service is determined only for new traffic. Once a user's request has been directed to a backend service, subsequent requests are sent to the same backend service as determined by the backend service's session affinity policy. Don't configure session affinity if you're using weighted traffic splitting. If you do, the weighted traffic splitting configuration takes precedence. The value must be from 0 to 1000. + * Specifies the fraction of traffic sent to a backend service, + * computed asweight / (sum of all weightedBackendService weights in routeAction). + * The selection of a backend service is determined only for new traffic. + * Once a user's request has been directed to a backend service, + * subsequent requests are sent to the same backend service as + * determined by the backend service's session affinity policy. + * Don't configure session affinity if you're using weighted traffic + * splitting. If you do, the weighted traffic splitting configuration takes + * precedence. + * The value must be from 0 to 1000. * * Generated from protobuf field optional uint32 weight = 282149496; */ @@ -41,11 +63,29 @@ class WeightedBackendService extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $backend_service - * The full or partial URL to the default BackendService resource. Before forwarding the request to backendService, the load balancer applies any relevant headerActions specified as part of this backendServiceWeight. + * The full or partial URL to the default BackendService + * resource. Before + * forwarding the request to backendService, the load balancer + * applies any relevant headerActions specified as part of thisbackendServiceWeight. * @type \Google\Cloud\Compute\V1\HttpHeaderAction $header_action - * Specifies changes to request and response headers that need to take effect for the selected backendService. headerAction specified here take effect before headerAction in the enclosing HttpRouteRule, PathMatcher and UrlMap. headerAction is not supported for load balancers that have their loadBalancingScheme set to EXTERNAL. Not supported when the URL map is bound to a target gRPC proxy that has validateForProxyless field set to true. + * Specifies changes to request and response headers that need to take + * effect for the selected backendService. + * headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap. + * headerAction is not supported for load balancers that have + * their loadBalancingScheme set to EXTERNAL. + * Not supported when the URL map is bound to a target gRPC proxy that + * has validateForProxyless field set to true. * @type int $weight - * Specifies the fraction of traffic sent to a backend service, computed as weight / (sum of all weightedBackendService weights in routeAction) . The selection of a backend service is determined only for new traffic. Once a user's request has been directed to a backend service, subsequent requests are sent to the same backend service as determined by the backend service's session affinity policy. Don't configure session affinity if you're using weighted traffic splitting. If you do, the weighted traffic splitting configuration takes precedence. The value must be from 0 to 1000. + * Specifies the fraction of traffic sent to a backend service, + * computed asweight / (sum of all weightedBackendService weights in routeAction). + * The selection of a backend service is determined only for new traffic. + * Once a user's request has been directed to a backend service, + * subsequent requests are sent to the same backend service as + * determined by the backend service's session affinity policy. + * Don't configure session affinity if you're using weighted traffic + * splitting. If you do, the weighted traffic splitting configuration takes + * precedence. + * The value must be from 0 to 1000. * } */ public function __construct($data = NULL) { @@ -54,7 +94,10 @@ public function __construct($data = NULL) { } /** - * The full or partial URL to the default BackendService resource. Before forwarding the request to backendService, the load balancer applies any relevant headerActions specified as part of this backendServiceWeight. + * The full or partial URL to the default BackendService + * resource. Before + * forwarding the request to backendService, the load balancer + * applies any relevant headerActions specified as part of thisbackendServiceWeight. * * Generated from protobuf field optional string backend_service = 306946058; * @return string @@ -75,7 +118,10 @@ public function clearBackendService() } /** - * The full or partial URL to the default BackendService resource. Before forwarding the request to backendService, the load balancer applies any relevant headerActions specified as part of this backendServiceWeight. + * The full or partial URL to the default BackendService + * resource. Before + * forwarding the request to backendService, the load balancer + * applies any relevant headerActions specified as part of thisbackendServiceWeight. * * Generated from protobuf field optional string backend_service = 306946058; * @param string $var @@ -90,7 +136,13 @@ public function setBackendService($var) } /** - * Specifies changes to request and response headers that need to take effect for the selected backendService. headerAction specified here take effect before headerAction in the enclosing HttpRouteRule, PathMatcher and UrlMap. headerAction is not supported for load balancers that have their loadBalancingScheme set to EXTERNAL. Not supported when the URL map is bound to a target gRPC proxy that has validateForProxyless field set to true. + * Specifies changes to request and response headers that need to take + * effect for the selected backendService. + * headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap. + * headerAction is not supported for load balancers that have + * their loadBalancingScheme set to EXTERNAL. + * Not supported when the URL map is bound to a target gRPC proxy that + * has validateForProxyless field set to true. * * Generated from protobuf field optional .google.cloud.compute.v1.HttpHeaderAction header_action = 328077352; * @return \Google\Cloud\Compute\V1\HttpHeaderAction|null @@ -111,7 +163,13 @@ public function clearHeaderAction() } /** - * Specifies changes to request and response headers that need to take effect for the selected backendService. headerAction specified here take effect before headerAction in the enclosing HttpRouteRule, PathMatcher and UrlMap. headerAction is not supported for load balancers that have their loadBalancingScheme set to EXTERNAL. Not supported when the URL map is bound to a target gRPC proxy that has validateForProxyless field set to true. + * Specifies changes to request and response headers that need to take + * effect for the selected backendService. + * headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap. + * headerAction is not supported for load balancers that have + * their loadBalancingScheme set to EXTERNAL. + * Not supported when the URL map is bound to a target gRPC proxy that + * has validateForProxyless field set to true. * * Generated from protobuf field optional .google.cloud.compute.v1.HttpHeaderAction header_action = 328077352; * @param \Google\Cloud\Compute\V1\HttpHeaderAction $var @@ -126,7 +184,16 @@ public function setHeaderAction($var) } /** - * Specifies the fraction of traffic sent to a backend service, computed as weight / (sum of all weightedBackendService weights in routeAction) . The selection of a backend service is determined only for new traffic. Once a user's request has been directed to a backend service, subsequent requests are sent to the same backend service as determined by the backend service's session affinity policy. Don't configure session affinity if you're using weighted traffic splitting. If you do, the weighted traffic splitting configuration takes precedence. The value must be from 0 to 1000. + * Specifies the fraction of traffic sent to a backend service, + * computed asweight / (sum of all weightedBackendService weights in routeAction). + * The selection of a backend service is determined only for new traffic. + * Once a user's request has been directed to a backend service, + * subsequent requests are sent to the same backend service as + * determined by the backend service's session affinity policy. + * Don't configure session affinity if you're using weighted traffic + * splitting. If you do, the weighted traffic splitting configuration takes + * precedence. + * The value must be from 0 to 1000. * * Generated from protobuf field optional uint32 weight = 282149496; * @return int @@ -147,7 +214,16 @@ public function clearWeight() } /** - * Specifies the fraction of traffic sent to a backend service, computed as weight / (sum of all weightedBackendService weights in routeAction) . The selection of a backend service is determined only for new traffic. Once a user's request has been directed to a backend service, subsequent requests are sent to the same backend service as determined by the backend service's session affinity policy. Don't configure session affinity if you're using weighted traffic splitting. If you do, the weighted traffic splitting configuration takes precedence. The value must be from 0 to 1000. + * Specifies the fraction of traffic sent to a backend service, + * computed asweight / (sum of all weightedBackendService weights in routeAction). + * The selection of a backend service is determined only for new traffic. + * Once a user's request has been directed to a backend service, + * subsequent requests are sent to the same backend service as + * determined by the backend service's session affinity policy. + * Don't configure session affinity if you're using weighted traffic + * splitting. If you do, the weighted traffic splitting configuration takes + * precedence. + * The value must be from 0 to 1000. * * Generated from protobuf field optional uint32 weight = 282149496; * @param int $var diff --git a/Compute/src/V1/Wire.php b/Compute/src/V1/Wire.php new file mode 100644 index 000000000000..bf00a0dc03bb --- /dev/null +++ b/Compute/src/V1/Wire.php @@ -0,0 +1,243 @@ +google.cloud.compute.v1.Wire + */ +class Wire extends \Google\Protobuf\Internal\Message +{ + /** + * [Output Only] Indicates whether the wire is enabled. + * When false, the wire is disabled. When true and when the wire group of + * the wire is also enabled, the wire is enabled. Defaults to true. + * + * Generated from protobuf field optional bool admin_enabled = 445675089; + */ + protected $admin_enabled = null; + /** + * Wire endpoints are specific Interconnect connections. + * + * Generated from protobuf field repeated .google.cloud.compute.v1.WireEndpoint endpoints = 287085950; + */ + private $endpoints; + /** + * [Output Only] A label that identifies the wire. The format of this label + * combines the existing labels of the wire group endpoints and Interconnect + * connections used by this wire in alphabetical order as follows: + * `ENDPOINT_A+CONNECTION_A1,ENDPOINT_B+CONNECTION_B1`, where: + * - ENDPOINT_A and ENDPOINT_B: are the labels + * that you entered as map keys when you specified the wire group endpoint + * objects. + * - CONNECTION_A1 and CONNECTION_B1: are the + * labels that you entered as map keys when you specified the wire group + * Interconnect objects. + * + * Generated from protobuf field optional string label = 102727412; + */ + protected $label = null; + /** + * [Output Only] Properties of the wire. + * + * Generated from protobuf field optional .google.cloud.compute.v1.WireProperties wire_properties = 303111469; + */ + protected $wire_properties = null; + + /** + * Constructor. + * + * @param array $data { + * Optional. Data for populating the Message object. + * + * @type bool $admin_enabled + * [Output Only] Indicates whether the wire is enabled. + * When false, the wire is disabled. When true and when the wire group of + * the wire is also enabled, the wire is enabled. Defaults to true. + * @type array<\Google\Cloud\Compute\V1\WireEndpoint>|\Google\Protobuf\Internal\RepeatedField $endpoints + * Wire endpoints are specific Interconnect connections. + * @type string $label + * [Output Only] A label that identifies the wire. The format of this label + * combines the existing labels of the wire group endpoints and Interconnect + * connections used by this wire in alphabetical order as follows: + * `ENDPOINT_A+CONNECTION_A1,ENDPOINT_B+CONNECTION_B1`, where: + * - ENDPOINT_A and ENDPOINT_B: are the labels + * that you entered as map keys when you specified the wire group endpoint + * objects. + * - CONNECTION_A1 and CONNECTION_B1: are the + * labels that you entered as map keys when you specified the wire group + * Interconnect objects. + * @type \Google\Cloud\Compute\V1\WireProperties $wire_properties + * [Output Only] Properties of the wire. + * } + */ + public function __construct($data = NULL) { + \GPBMetadata\Google\Cloud\Compute\V1\Compute::initOnce(); + parent::__construct($data); + } + + /** + * [Output Only] Indicates whether the wire is enabled. + * When false, the wire is disabled. When true and when the wire group of + * the wire is also enabled, the wire is enabled. Defaults to true. + * + * Generated from protobuf field optional bool admin_enabled = 445675089; + * @return bool + */ + public function getAdminEnabled() + { + return isset($this->admin_enabled) ? $this->admin_enabled : false; + } + + public function hasAdminEnabled() + { + return isset($this->admin_enabled); + } + + public function clearAdminEnabled() + { + unset($this->admin_enabled); + } + + /** + * [Output Only] Indicates whether the wire is enabled. + * When false, the wire is disabled. When true and when the wire group of + * the wire is also enabled, the wire is enabled. Defaults to true. + * + * Generated from protobuf field optional bool admin_enabled = 445675089; + * @param bool $var + * @return $this + */ + public function setAdminEnabled($var) + { + GPBUtil::checkBool($var); + $this->admin_enabled = $var; + + return $this; + } + + /** + * Wire endpoints are specific Interconnect connections. + * + * Generated from protobuf field repeated .google.cloud.compute.v1.WireEndpoint endpoints = 287085950; + * @return \Google\Protobuf\Internal\RepeatedField + */ + public function getEndpoints() + { + return $this->endpoints; + } + + /** + * Wire endpoints are specific Interconnect connections. + * + * Generated from protobuf field repeated .google.cloud.compute.v1.WireEndpoint endpoints = 287085950; + * @param array<\Google\Cloud\Compute\V1\WireEndpoint>|\Google\Protobuf\Internal\RepeatedField $var + * @return $this + */ + public function setEndpoints($var) + { + $arr = GPBUtil::checkRepeatedField($var, \Google\Protobuf\Internal\GPBType::MESSAGE, \Google\Cloud\Compute\V1\WireEndpoint::class); + $this->endpoints = $arr; + + return $this; + } + + /** + * [Output Only] A label that identifies the wire. The format of this label + * combines the existing labels of the wire group endpoints and Interconnect + * connections used by this wire in alphabetical order as follows: + * `ENDPOINT_A+CONNECTION_A1,ENDPOINT_B+CONNECTION_B1`, where: + * - ENDPOINT_A and ENDPOINT_B: are the labels + * that you entered as map keys when you specified the wire group endpoint + * objects. + * - CONNECTION_A1 and CONNECTION_B1: are the + * labels that you entered as map keys when you specified the wire group + * Interconnect objects. + * + * Generated from protobuf field optional string label = 102727412; + * @return string + */ + public function getLabel() + { + return isset($this->label) ? $this->label : ''; + } + + public function hasLabel() + { + return isset($this->label); + } + + public function clearLabel() + { + unset($this->label); + } + + /** + * [Output Only] A label that identifies the wire. The format of this label + * combines the existing labels of the wire group endpoints and Interconnect + * connections used by this wire in alphabetical order as follows: + * `ENDPOINT_A+CONNECTION_A1,ENDPOINT_B+CONNECTION_B1`, where: + * - ENDPOINT_A and ENDPOINT_B: are the labels + * that you entered as map keys when you specified the wire group endpoint + * objects. + * - CONNECTION_A1 and CONNECTION_B1: are the + * labels that you entered as map keys when you specified the wire group + * Interconnect objects. + * + * Generated from protobuf field optional string label = 102727412; + * @param string $var + * @return $this + */ + public function setLabel($var) + { + GPBUtil::checkString($var, True); + $this->label = $var; + + return $this; + } + + /** + * [Output Only] Properties of the wire. + * + * Generated from protobuf field optional .google.cloud.compute.v1.WireProperties wire_properties = 303111469; + * @return \Google\Cloud\Compute\V1\WireProperties|null + */ + public function getWireProperties() + { + return $this->wire_properties; + } + + public function hasWireProperties() + { + return isset($this->wire_properties); + } + + public function clearWireProperties() + { + unset($this->wire_properties); + } + + /** + * [Output Only] Properties of the wire. + * + * Generated from protobuf field optional .google.cloud.compute.v1.WireProperties wire_properties = 303111469; + * @param \Google\Cloud\Compute\V1\WireProperties $var + * @return $this + */ + public function setWireProperties($var) + { + GPBUtil::checkMessage($var, \Google\Cloud\Compute\V1\WireProperties::class); + $this->wire_properties = $var; + + return $this; + } + +} + diff --git a/Compute/src/V1/WireEndpoint.php b/Compute/src/V1/WireEndpoint.php new file mode 100644 index 000000000000..95285c70d9c1 --- /dev/null +++ b/Compute/src/V1/WireEndpoint.php @@ -0,0 +1,107 @@ +google.cloud.compute.v1.WireEndpoint + */ +class WireEndpoint extends \Google\Protobuf\Internal\Message +{ + /** + * Generated from protobuf field optional string interconnect = 224601230; + */ + protected $interconnect = null; + /** + * Generated from protobuf field optional int32 vlan_tag = 514640574; + */ + protected $vlan_tag = null; + + /** + * Constructor. + * + * @param array $data { + * Optional. Data for populating the Message object. + * + * @type string $interconnect + * @type int $vlan_tag + * } + */ + public function __construct($data = NULL) { + \GPBMetadata\Google\Cloud\Compute\V1\Compute::initOnce(); + parent::__construct($data); + } + + /** + * Generated from protobuf field optional string interconnect = 224601230; + * @return string + */ + public function getInterconnect() + { + return isset($this->interconnect) ? $this->interconnect : ''; + } + + public function hasInterconnect() + { + return isset($this->interconnect); + } + + public function clearInterconnect() + { + unset($this->interconnect); + } + + /** + * Generated from protobuf field optional string interconnect = 224601230; + * @param string $var + * @return $this + */ + public function setInterconnect($var) + { + GPBUtil::checkString($var, True); + $this->interconnect = $var; + + return $this; + } + + /** + * Generated from protobuf field optional int32 vlan_tag = 514640574; + * @return int + */ + public function getVlanTag() + { + return isset($this->vlan_tag) ? $this->vlan_tag : 0; + } + + public function hasVlanTag() + { + return isset($this->vlan_tag); + } + + public function clearVlanTag() + { + unset($this->vlan_tag); + } + + /** + * Generated from protobuf field optional int32 vlan_tag = 514640574; + * @param int $var + * @return $this + */ + public function setVlanTag($var) + { + GPBUtil::checkInt32($var); + $this->vlan_tag = $var; + + return $this; + } + +} + diff --git a/Compute/src/V1/WireGroup.php b/Compute/src/V1/WireGroup.php new file mode 100644 index 000000000000..838e39ee885c --- /dev/null +++ b/Compute/src/V1/WireGroup.php @@ -0,0 +1,597 @@ +google.cloud.compute.v1.WireGroup + */ +class WireGroup extends \Google\Protobuf\Internal\Message +{ + /** + * Indicates whether the wires in the wire group are enabled. When false, the + * wires in the wire group are disabled. When true and when + * there is simultaneously no wire-specific override of `adminEnabled` to + * false, a given wire is enabled. Defaults to true. + * + * Generated from protobuf field optional bool admin_enabled = 445675089; + */ + protected $admin_enabled = null; + /** + * [Output Only] Creation timestamp inRFC3339 + * text format. + * + * Generated from protobuf field optional string creation_timestamp = 30525366; + */ + protected $creation_timestamp = null; + /** + * An optional description of the wire group. + * + * Generated from protobuf field optional string description = 422937596; + */ + protected $description = null; + /** + * A map that contains the logical endpoints of the wire group. Specify + * key-value pairs for the map as follows: + * - Key: an RFC1035 user-specified label. + * - Value: an Endpoint object. + * + * Generated from protobuf field map endpoints = 287085950; + */ + private $endpoints; + /** + * [Output Only] The unique identifier for the resource type. The server + * generates this identifier. + * + * Generated from protobuf field optional uint64 id = 3355; + */ + protected $id = null; + /** + * [Output Only] Type of the resource. Alwayscompute#wireGroups for wire groups. + * + * Generated from protobuf field optional string kind = 3292052; + */ + protected $kind = null; + /** + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. + * + * Generated from protobuf field optional string name = 3373707; + */ + protected $name = null; + /** + * [Output Only] Indicates whether there are wire changes yet to be processed. + * + * Generated from protobuf field optional bool reconciling = 432155787; + */ + protected $reconciling = null; + /** + * [Output Only] Server-defined URL for the resource. + * + * Generated from protobuf field optional string self_link = 456214797; + */ + protected $self_link = null; + /** + * Topology details for the wire group configuration. + * + * Generated from protobuf field optional .google.cloud.compute.v1.WireGroupTopology topology = 122274415; + */ + protected $topology = null; + /** + * Properties for all wires in the wire group. + * + * Generated from protobuf field optional .google.cloud.compute.v1.WireProperties wire_properties = 303111469; + */ + protected $wire_properties = null; + /** + * The single/redundant wire(s) managed by the wire group. + * + * Generated from protobuf field repeated .google.cloud.compute.v1.Wire wires = 113139854; + */ + private $wires; + + /** + * Constructor. + * + * @param array $data { + * Optional. Data for populating the Message object. + * + * @type bool $admin_enabled + * Indicates whether the wires in the wire group are enabled. When false, the + * wires in the wire group are disabled. When true and when + * there is simultaneously no wire-specific override of `adminEnabled` to + * false, a given wire is enabled. Defaults to true. + * @type string $creation_timestamp + * [Output Only] Creation timestamp inRFC3339 + * text format. + * @type string $description + * An optional description of the wire group. + * @type array|\Google\Protobuf\Internal\MapField $endpoints + * A map that contains the logical endpoints of the wire group. Specify + * key-value pairs for the map as follows: + * - Key: an RFC1035 user-specified label. + * - Value: an Endpoint object. + * @type int|string $id + * [Output Only] The unique identifier for the resource type. The server + * generates this identifier. + * @type string $kind + * [Output Only] Type of the resource. Alwayscompute#wireGroups for wire groups. + * @type string $name + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. + * @type bool $reconciling + * [Output Only] Indicates whether there are wire changes yet to be processed. + * @type string $self_link + * [Output Only] Server-defined URL for the resource. + * @type \Google\Cloud\Compute\V1\WireGroupTopology $topology + * Topology details for the wire group configuration. + * @type \Google\Cloud\Compute\V1\WireProperties $wire_properties + * Properties for all wires in the wire group. + * @type array<\Google\Cloud\Compute\V1\Wire>|\Google\Protobuf\Internal\RepeatedField $wires + * The single/redundant wire(s) managed by the wire group. + * } + */ + public function __construct($data = NULL) { + \GPBMetadata\Google\Cloud\Compute\V1\Compute::initOnce(); + parent::__construct($data); + } + + /** + * Indicates whether the wires in the wire group are enabled. When false, the + * wires in the wire group are disabled. When true and when + * there is simultaneously no wire-specific override of `adminEnabled` to + * false, a given wire is enabled. Defaults to true. + * + * Generated from protobuf field optional bool admin_enabled = 445675089; + * @return bool + */ + public function getAdminEnabled() + { + return isset($this->admin_enabled) ? $this->admin_enabled : false; + } + + public function hasAdminEnabled() + { + return isset($this->admin_enabled); + } + + public function clearAdminEnabled() + { + unset($this->admin_enabled); + } + + /** + * Indicates whether the wires in the wire group are enabled. When false, the + * wires in the wire group are disabled. When true and when + * there is simultaneously no wire-specific override of `adminEnabled` to + * false, a given wire is enabled. Defaults to true. + * + * Generated from protobuf field optional bool admin_enabled = 445675089; + * @param bool $var + * @return $this + */ + public function setAdminEnabled($var) + { + GPBUtil::checkBool($var); + $this->admin_enabled = $var; + + return $this; + } + + /** + * [Output Only] Creation timestamp inRFC3339 + * text format. + * + * Generated from protobuf field optional string creation_timestamp = 30525366; + * @return string + */ + public function getCreationTimestamp() + { + return isset($this->creation_timestamp) ? $this->creation_timestamp : ''; + } + + public function hasCreationTimestamp() + { + return isset($this->creation_timestamp); + } + + public function clearCreationTimestamp() + { + unset($this->creation_timestamp); + } + + /** + * [Output Only] Creation timestamp inRFC3339 + * text format. + * + * Generated from protobuf field optional string creation_timestamp = 30525366; + * @param string $var + * @return $this + */ + public function setCreationTimestamp($var) + { + GPBUtil::checkString($var, True); + $this->creation_timestamp = $var; + + return $this; + } + + /** + * An optional description of the wire group. + * + * Generated from protobuf field optional string description = 422937596; + * @return string + */ + public function getDescription() + { + return isset($this->description) ? $this->description : ''; + } + + public function hasDescription() + { + return isset($this->description); + } + + public function clearDescription() + { + unset($this->description); + } + + /** + * An optional description of the wire group. + * + * Generated from protobuf field optional string description = 422937596; + * @param string $var + * @return $this + */ + public function setDescription($var) + { + GPBUtil::checkString($var, True); + $this->description = $var; + + return $this; + } + + /** + * A map that contains the logical endpoints of the wire group. Specify + * key-value pairs for the map as follows: + * - Key: an RFC1035 user-specified label. + * - Value: an Endpoint object. + * + * Generated from protobuf field map endpoints = 287085950; + * @return \Google\Protobuf\Internal\MapField + */ + public function getEndpoints() + { + return $this->endpoints; + } + + /** + * A map that contains the logical endpoints of the wire group. Specify + * key-value pairs for the map as follows: + * - Key: an RFC1035 user-specified label. + * - Value: an Endpoint object. + * + * Generated from protobuf field map endpoints = 287085950; + * @param array|\Google\Protobuf\Internal\MapField $var + * @return $this + */ + public function setEndpoints($var) + { + $arr = GPBUtil::checkMapField($var, \Google\Protobuf\Internal\GPBType::STRING, \Google\Protobuf\Internal\GPBType::MESSAGE, \Google\Cloud\Compute\V1\WireGroupEndpoint::class); + $this->endpoints = $arr; + + return $this; + } + + /** + * [Output Only] The unique identifier for the resource type. The server + * generates this identifier. + * + * Generated from protobuf field optional uint64 id = 3355; + * @return int|string + */ + public function getId() + { + return isset($this->id) ? $this->id : 0; + } + + public function hasId() + { + return isset($this->id); + } + + public function clearId() + { + unset($this->id); + } + + /** + * [Output Only] The unique identifier for the resource type. The server + * generates this identifier. + * + * Generated from protobuf field optional uint64 id = 3355; + * @param int|string $var + * @return $this + */ + public function setId($var) + { + GPBUtil::checkUint64($var); + $this->id = $var; + + return $this; + } + + /** + * [Output Only] Type of the resource. Alwayscompute#wireGroups for wire groups. + * + * Generated from protobuf field optional string kind = 3292052; + * @return string + */ + public function getKind() + { + return isset($this->kind) ? $this->kind : ''; + } + + public function hasKind() + { + return isset($this->kind); + } + + public function clearKind() + { + unset($this->kind); + } + + /** + * [Output Only] Type of the resource. Alwayscompute#wireGroups for wire groups. + * + * Generated from protobuf field optional string kind = 3292052; + * @param string $var + * @return $this + */ + public function setKind($var) + { + GPBUtil::checkString($var, True); + $this->kind = $var; + + return $this; + } + + /** + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. + * + * Generated from protobuf field optional string name = 3373707; + * @return string + */ + public function getName() + { + return isset($this->name) ? $this->name : ''; + } + + public function hasName() + { + return isset($this->name); + } + + public function clearName() + { + unset($this->name); + } + + /** + * Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply withRFC1035. + * Specifically, the name must be 1-63 characters long and match the regular + * expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + * character must be a lowercase letter, and all following characters must + * be a dash, lowercase letter, or digit, except the last character, which + * cannot be a dash. + * + * Generated from protobuf field optional string name = 3373707; + * @param string $var + * @return $this + */ + public function setName($var) + { + GPBUtil::checkString($var, True); + $this->name = $var; + + return $this; + } + + /** + * [Output Only] Indicates whether there are wire changes yet to be processed. + * + * Generated from protobuf field optional bool reconciling = 432155787; + * @return bool + */ + public function getReconciling() + { + return isset($this->reconciling) ? $this->reconciling : false; + } + + public function hasReconciling() + { + return isset($this->reconciling); + } + + public function clearReconciling() + { + unset($this->reconciling); + } + + /** + * [Output Only] Indicates whether there are wire changes yet to be processed. + * + * Generated from protobuf field optional bool reconciling = 432155787; + * @param bool $var + * @return $this + */ + public function setReconciling($var) + { + GPBUtil::checkBool($var); + $this->reconciling = $var; + + return $this; + } + + /** + * [Output Only] Server-defined URL for the resource. + * + * Generated from protobuf field optional string self_link = 456214797; + * @return string + */ + public function getSelfLink() + { + return isset($this->self_link) ? $this->self_link : ''; + } + + public function hasSelfLink() + { + return isset($this->self_link); + } + + public function clearSelfLink() + { + unset($this->self_link); + } + + /** + * [Output Only] Server-defined URL for the resource. + * + * Generated from protobuf field optional string self_link = 456214797; + * @param string $var + * @return $this + */ + public function setSelfLink($var) + { + GPBUtil::checkString($var, True); + $this->self_link = $var; + + return $this; + } + + /** + * Topology details for the wire group configuration. + * + * Generated from protobuf field optional .google.cloud.compute.v1.WireGroupTopology topology = 122274415; + * @return \Google\Cloud\Compute\V1\WireGroupTopology|null + */ + public function getTopology() + { + return $this->topology; + } + + public function hasTopology() + { + return isset($this->topology); + } + + public function clearTopology() + { + unset($this->topology); + } + + /** + * Topology details for the wire group configuration. + * + * Generated from protobuf field optional .google.cloud.compute.v1.WireGroupTopology topology = 122274415; + * @param \Google\Cloud\Compute\V1\WireGroupTopology $var + * @return $this + */ + public function setTopology($var) + { + GPBUtil::checkMessage($var, \Google\Cloud\Compute\V1\WireGroupTopology::class); + $this->topology = $var; + + return $this; + } + + /** + * Properties for all wires in the wire group. + * + * Generated from protobuf field optional .google.cloud.compute.v1.WireProperties wire_properties = 303111469; + * @return \Google\Cloud\Compute\V1\WireProperties|null + */ + public function getWireProperties() + { + return $this->wire_properties; + } + + public function hasWireProperties() + { + return isset($this->wire_properties); + } + + public function clearWireProperties() + { + unset($this->wire_properties); + } + + /** + * Properties for all wires in the wire group. + * + * Generated from protobuf field optional .google.cloud.compute.v1.WireProperties wire_properties = 303111469; + * @param \Google\Cloud\Compute\V1\WireProperties $var + * @return $this + */ + public function setWireProperties($var) + { + GPBUtil::checkMessage($var, \Google\Cloud\Compute\V1\WireProperties::class); + $this->wire_properties = $var; + + return $this; + } + + /** + * The single/redundant wire(s) managed by the wire group. + * + * Generated from protobuf field repeated .google.cloud.compute.v1.Wire wires = 113139854; + * @return \Google\Protobuf\Internal\RepeatedField + */ + public function getWires() + { + return $this->wires; + } + + /** + * The single/redundant wire(s) managed by the wire group. + * + * Generated from protobuf field repeated .google.cloud.compute.v1.Wire wires = 113139854; + * @param array<\Google\Cloud\Compute\V1\Wire>|\Google\Protobuf\Internal\RepeatedField $var + * @return $this + */ + public function setWires($var) + { + $arr = GPBUtil::checkRepeatedField($var, \Google\Protobuf\Internal\GPBType::MESSAGE, \Google\Cloud\Compute\V1\Wire::class); + $this->wires = $arr; + + return $this; + } + +} + diff --git a/Compute/src/V1/WireGroupEndpoint.php b/Compute/src/V1/WireGroupEndpoint.php new file mode 100644 index 000000000000..e8297f61748a --- /dev/null +++ b/Compute/src/V1/WireGroupEndpoint.php @@ -0,0 +1,81 @@ +google.cloud.compute.v1.WireGroupEndpoint + */ +class WireGroupEndpoint extends \Google\Protobuf\Internal\Message +{ + /** + * A map that contains the redundant Interconnect connections. Specify + * key-value pairs for the map as follows: + * - Key: an RFC1035 user-specified label. + * - Value: an Interconnect object. + * + * Generated from protobuf field map interconnects = 520187301; + */ + private $interconnects; + + /** + * Constructor. + * + * @param array $data { + * Optional. Data for populating the Message object. + * + * @type array|\Google\Protobuf\Internal\MapField $interconnects + * A map that contains the redundant Interconnect connections. Specify + * key-value pairs for the map as follows: + * - Key: an RFC1035 user-specified label. + * - Value: an Interconnect object. + * } + */ + public function __construct($data = NULL) { + \GPBMetadata\Google\Cloud\Compute\V1\Compute::initOnce(); + parent::__construct($data); + } + + /** + * A map that contains the redundant Interconnect connections. Specify + * key-value pairs for the map as follows: + * - Key: an RFC1035 user-specified label. + * - Value: an Interconnect object. + * + * Generated from protobuf field map interconnects = 520187301; + * @return \Google\Protobuf\Internal\MapField + */ + public function getInterconnects() + { + return $this->interconnects; + } + + /** + * A map that contains the redundant Interconnect connections. Specify + * key-value pairs for the map as follows: + * - Key: an RFC1035 user-specified label. + * - Value: an Interconnect object. + * + * Generated from protobuf field map interconnects = 520187301; + * @param array|\Google\Protobuf\Internal\MapField $var + * @return $this + */ + public function setInterconnects($var) + { + $arr = GPBUtil::checkMapField($var, \Google\Protobuf\Internal\GPBType::STRING, \Google\Protobuf\Internal\GPBType::MESSAGE, \Google\Cloud\Compute\V1\WireGroupEndpointInterconnect::class); + $this->interconnects = $arr; + + return $this; + } + +} + diff --git a/Compute/src/V1/WireGroupEndpointInterconnect.php b/Compute/src/V1/WireGroupEndpointInterconnect.php new file mode 100644 index 000000000000..265a6678fe5d --- /dev/null +++ b/Compute/src/V1/WireGroupEndpointInterconnect.php @@ -0,0 +1,191 @@ +google.cloud.compute.v1.WireGroupEndpointInterconnect + */ +class WireGroupEndpointInterconnect extends \Google\Protobuf\Internal\Message +{ + /** + * Required. An Interconnect connection. You can specify the connection as + * a partial or full URL. If the connection is in a different project from + * the cross-site network, use a format that specifies the project. See + * the following examples of partial and full URLs: + * global/interconnects/NAME + * projects/PROJECT_ID/global/interconnects/NAME + * - + * https://compute.googleapis.com/compute/projects/PROJECT_ID/global/interconnects/NAME + * + * Generated from protobuf field optional string interconnect = 224601230; + */ + protected $interconnect = null; + /** + * Required. To configure the wire group for VLAN mode, enter a VLAN tag, + * which is a number from `2` to `4093`. You can autoallocate a tag by + * entering `0`. To configure the wire group for port mode, enter `-1`. + * Review the following guidelines: + * - A VLAN tag must be unique for an Interconnect connection across all + * attachments and wire groups. + * - Both endpoints of a wire must use the same VLAN tag value. + * - Single wire and redundant type wire groups must have only one + * VLAN tag. + * - Port mode pseudowires must have a single VLAN tag with a value of + * `-1` for both endpoints. + * - Box and cross type wire groups must have two VLAN tags. The first + * is for the same-zone pseudowire, and the second is for the cross-zone + * pseudowire. + * + * Generated from protobuf field repeated int32 vlan_tags = 384601461; + */ + private $vlan_tags; + + /** + * Constructor. + * + * @param array $data { + * Optional. Data for populating the Message object. + * + * @type string $interconnect + * Required. An Interconnect connection. You can specify the connection as + * a partial or full URL. If the connection is in a different project from + * the cross-site network, use a format that specifies the project. See + * the following examples of partial and full URLs: + * global/interconnects/NAME + * projects/PROJECT_ID/global/interconnects/NAME + * - + * https://compute.googleapis.com/compute/projects/PROJECT_ID/global/interconnects/NAME + * @type array|\Google\Protobuf\Internal\RepeatedField $vlan_tags + * Required. To configure the wire group for VLAN mode, enter a VLAN tag, + * which is a number from `2` to `4093`. You can autoallocate a tag by + * entering `0`. To configure the wire group for port mode, enter `-1`. + * Review the following guidelines: + * - A VLAN tag must be unique for an Interconnect connection across all + * attachments and wire groups. + * - Both endpoints of a wire must use the same VLAN tag value. + * - Single wire and redundant type wire groups must have only one + * VLAN tag. + * - Port mode pseudowires must have a single VLAN tag with a value of + * `-1` for both endpoints. + * - Box and cross type wire groups must have two VLAN tags. The first + * is for the same-zone pseudowire, and the second is for the cross-zone + * pseudowire. + * } + */ + public function __construct($data = NULL) { + \GPBMetadata\Google\Cloud\Compute\V1\Compute::initOnce(); + parent::__construct($data); + } + + /** + * Required. An Interconnect connection. You can specify the connection as + * a partial or full URL. If the connection is in a different project from + * the cross-site network, use a format that specifies the project. See + * the following examples of partial and full URLs: + * global/interconnects/NAME + * projects/PROJECT_ID/global/interconnects/NAME + * - + * https://compute.googleapis.com/compute/projects/PROJECT_ID/global/interconnects/NAME + * + * Generated from protobuf field optional string interconnect = 224601230; + * @return string + */ + public function getInterconnect() + { + return isset($this->interconnect) ? $this->interconnect : ''; + } + + public function hasInterconnect() + { + return isset($this->interconnect); + } + + public function clearInterconnect() + { + unset($this->interconnect); + } + + /** + * Required. An Interconnect connection. You can specify the connection as + * a partial or full URL. If the connection is in a different project from + * the cross-site network, use a format that specifies the project. See + * the following examples of partial and full URLs: + * global/interconnects/NAME + * projects/PROJECT_ID/global/interconnects/NAME + * - + * https://compute.googleapis.com/compute/projects/PROJECT_ID/global/interconnects/NAME + * + * Generated from protobuf field optional string interconnect = 224601230; + * @param string $var + * @return $this + */ + public function setInterconnect($var) + { + GPBUtil::checkString($var, True); + $this->interconnect = $var; + + return $this; + } + + /** + * Required. To configure the wire group for VLAN mode, enter a VLAN tag, + * which is a number from `2` to `4093`. You can autoallocate a tag by + * entering `0`. To configure the wire group for port mode, enter `-1`. + * Review the following guidelines: + * - A VLAN tag must be unique for an Interconnect connection across all + * attachments and wire groups. + * - Both endpoints of a wire must use the same VLAN tag value. + * - Single wire and redundant type wire groups must have only one + * VLAN tag. + * - Port mode pseudowires must have a single VLAN tag with a value of + * `-1` for both endpoints. + * - Box and cross type wire groups must have two VLAN tags. The first + * is for the same-zone pseudowire, and the second is for the cross-zone + * pseudowire. + * + * Generated from protobuf field repeated int32 vlan_tags = 384601461; + * @return \Google\Protobuf\Internal\RepeatedField + */ + public function getVlanTags() + { + return $this->vlan_tags; + } + + /** + * Required. To configure the wire group for VLAN mode, enter a VLAN tag, + * which is a number from `2` to `4093`. You can autoallocate a tag by + * entering `0`. To configure the wire group for port mode, enter `-1`. + * Review the following guidelines: + * - A VLAN tag must be unique for an Interconnect connection across all + * attachments and wire groups. + * - Both endpoints of a wire must use the same VLAN tag value. + * - Single wire and redundant type wire groups must have only one + * VLAN tag. + * - Port mode pseudowires must have a single VLAN tag with a value of + * `-1` for both endpoints. + * - Box and cross type wire groups must have two VLAN tags. The first + * is for the same-zone pseudowire, and the second is for the cross-zone + * pseudowire. + * + * Generated from protobuf field repeated int32 vlan_tags = 384601461; + * @param array|\Google\Protobuf\Internal\RepeatedField $var + * @return $this + */ + public function setVlanTags($var) + { + $arr = GPBUtil::checkRepeatedField($var, \Google\Protobuf\Internal\GPBType::INT32); + $this->vlan_tags = $arr; + + return $this; + } + +} + diff --git a/Compute/src/V1/WireGroupList.php b/Compute/src/V1/WireGroupList.php new file mode 100644 index 000000000000..fcd94e30e1b1 --- /dev/null +++ b/Compute/src/V1/WireGroupList.php @@ -0,0 +1,378 @@ +google.cloud.compute.v1.WireGroupList + */ +class WireGroupList extends \Google\Protobuf\Internal\Message +{ + /** + * Generated from protobuf field optional string etag = 3123477; + */ + protected $etag = null; + /** + * [Output Only] Unique identifier for the resource; defined by the server. + * + * Generated from protobuf field optional string id = 3355; + */ + protected $id = null; + /** + * A list of wire group resources. + * + * Generated from protobuf field repeated .google.cloud.compute.v1.WireGroup items = 100526016; + */ + private $items; + /** + * [Output Only] Type of the resource. Alwayscompute#wireGroups for wire groups. + * + * Generated from protobuf field optional string kind = 3292052; + */ + protected $kind = null; + /** + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. + * + * Generated from protobuf field optional string next_page_token = 79797525; + */ + protected $next_page_token = null; + /** + * [Output Only] Server-defined URL for this resource. + * + * Generated from protobuf field optional string self_link = 456214797; + */ + protected $self_link = null; + /** + * [Output Only] Unreachable resources. + * end_interface: MixerListResponseWithEtagBuilder + * + * Generated from protobuf field repeated string unreachables = 243372063; + */ + private $unreachables; + /** + * [Output Only] Informational warning message. + * + * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; + */ + protected $warning = null; + + /** + * Constructor. + * + * @param array $data { + * Optional. Data for populating the Message object. + * + * @type string $etag + * @type string $id + * [Output Only] Unique identifier for the resource; defined by the server. + * @type array<\Google\Cloud\Compute\V1\WireGroup>|\Google\Protobuf\Internal\RepeatedField $items + * A list of wire group resources. + * @type string $kind + * [Output Only] Type of the resource. Alwayscompute#wireGroups for wire groups. + * @type string $next_page_token + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. + * @type string $self_link + * [Output Only] Server-defined URL for this resource. + * @type array|\Google\Protobuf\Internal\RepeatedField $unreachables + * [Output Only] Unreachable resources. + * end_interface: MixerListResponseWithEtagBuilder + * @type \Google\Cloud\Compute\V1\Warning $warning + * [Output Only] Informational warning message. + * } + */ + public function __construct($data = NULL) { + \GPBMetadata\Google\Cloud\Compute\V1\Compute::initOnce(); + parent::__construct($data); + } + + /** + * Generated from protobuf field optional string etag = 3123477; + * @return string + */ + public function getEtag() + { + return isset($this->etag) ? $this->etag : ''; + } + + public function hasEtag() + { + return isset($this->etag); + } + + public function clearEtag() + { + unset($this->etag); + } + + /** + * Generated from protobuf field optional string etag = 3123477; + * @param string $var + * @return $this + */ + public function setEtag($var) + { + GPBUtil::checkString($var, True); + $this->etag = $var; + + return $this; + } + + /** + * [Output Only] Unique identifier for the resource; defined by the server. + * + * Generated from protobuf field optional string id = 3355; + * @return string + */ + public function getId() + { + return isset($this->id) ? $this->id : ''; + } + + public function hasId() + { + return isset($this->id); + } + + public function clearId() + { + unset($this->id); + } + + /** + * [Output Only] Unique identifier for the resource; defined by the server. + * + * Generated from protobuf field optional string id = 3355; + * @param string $var + * @return $this + */ + public function setId($var) + { + GPBUtil::checkString($var, True); + $this->id = $var; + + return $this; + } + + /** + * A list of wire group resources. + * + * Generated from protobuf field repeated .google.cloud.compute.v1.WireGroup items = 100526016; + * @return \Google\Protobuf\Internal\RepeatedField + */ + public function getItems() + { + return $this->items; + } + + /** + * A list of wire group resources. + * + * Generated from protobuf field repeated .google.cloud.compute.v1.WireGroup items = 100526016; + * @param array<\Google\Cloud\Compute\V1\WireGroup>|\Google\Protobuf\Internal\RepeatedField $var + * @return $this + */ + public function setItems($var) + { + $arr = GPBUtil::checkRepeatedField($var, \Google\Protobuf\Internal\GPBType::MESSAGE, \Google\Cloud\Compute\V1\WireGroup::class); + $this->items = $arr; + + return $this; + } + + /** + * [Output Only] Type of the resource. Alwayscompute#wireGroups for wire groups. + * + * Generated from protobuf field optional string kind = 3292052; + * @return string + */ + public function getKind() + { + return isset($this->kind) ? $this->kind : ''; + } + + public function hasKind() + { + return isset($this->kind); + } + + public function clearKind() + { + unset($this->kind); + } + + /** + * [Output Only] Type of the resource. Alwayscompute#wireGroups for wire groups. + * + * Generated from protobuf field optional string kind = 3292052; + * @param string $var + * @return $this + */ + public function setKind($var) + { + GPBUtil::checkString($var, True); + $this->kind = $var; + + return $this; + } + + /** + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. + * + * Generated from protobuf field optional string next_page_token = 79797525; + * @return string + */ + public function getNextPageToken() + { + return isset($this->next_page_token) ? $this->next_page_token : ''; + } + + public function hasNextPageToken() + { + return isset($this->next_page_token); + } + + public function clearNextPageToken() + { + unset($this->next_page_token); + } + + /** + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. + * + * Generated from protobuf field optional string next_page_token = 79797525; + * @param string $var + * @return $this + */ + public function setNextPageToken($var) + { + GPBUtil::checkString($var, True); + $this->next_page_token = $var; + + return $this; + } + + /** + * [Output Only] Server-defined URL for this resource. + * + * Generated from protobuf field optional string self_link = 456214797; + * @return string + */ + public function getSelfLink() + { + return isset($this->self_link) ? $this->self_link : ''; + } + + public function hasSelfLink() + { + return isset($this->self_link); + } + + public function clearSelfLink() + { + unset($this->self_link); + } + + /** + * [Output Only] Server-defined URL for this resource. + * + * Generated from protobuf field optional string self_link = 456214797; + * @param string $var + * @return $this + */ + public function setSelfLink($var) + { + GPBUtil::checkString($var, True); + $this->self_link = $var; + + return $this; + } + + /** + * [Output Only] Unreachable resources. + * end_interface: MixerListResponseWithEtagBuilder + * + * Generated from protobuf field repeated string unreachables = 243372063; + * @return \Google\Protobuf\Internal\RepeatedField + */ + public function getUnreachables() + { + return $this->unreachables; + } + + /** + * [Output Only] Unreachable resources. + * end_interface: MixerListResponseWithEtagBuilder + * + * Generated from protobuf field repeated string unreachables = 243372063; + * @param array|\Google\Protobuf\Internal\RepeatedField $var + * @return $this + */ + public function setUnreachables($var) + { + $arr = GPBUtil::checkRepeatedField($var, \Google\Protobuf\Internal\GPBType::STRING); + $this->unreachables = $arr; + + return $this; + } + + /** + * [Output Only] Informational warning message. + * + * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; + * @return \Google\Cloud\Compute\V1\Warning|null + */ + public function getWarning() + { + return $this->warning; + } + + public function hasWarning() + { + return isset($this->warning); + } + + public function clearWarning() + { + unset($this->warning); + } + + /** + * [Output Only] Informational warning message. + * + * Generated from protobuf field optional .google.cloud.compute.v1.Warning warning = 50704284; + * @param \Google\Cloud\Compute\V1\Warning $var + * @return $this + */ + public function setWarning($var) + { + GPBUtil::checkMessage($var, \Google\Cloud\Compute\V1\Warning::class); + $this->warning = $var; + + return $this; + } + +} + diff --git a/Compute/src/V1/WireGroupTopology.php b/Compute/src/V1/WireGroupTopology.php new file mode 100644 index 000000000000..4819e645f52f --- /dev/null +++ b/Compute/src/V1/WireGroupTopology.php @@ -0,0 +1,67 @@ +google.cloud.compute.v1.WireGroupTopology + */ +class WireGroupTopology extends \Google\Protobuf\Internal\Message +{ + /** + * Topology details for all endpoints in the wire group. + * + * Generated from protobuf field repeated .google.cloud.compute.v1.WireGroupTopologyEndpoint endpoints = 287085950; + */ + private $endpoints; + + /** + * Constructor. + * + * @param array $data { + * Optional. Data for populating the Message object. + * + * @type array<\Google\Cloud\Compute\V1\WireGroupTopologyEndpoint>|\Google\Protobuf\Internal\RepeatedField $endpoints + * Topology details for all endpoints in the wire group. + * } + */ + public function __construct($data = NULL) { + \GPBMetadata\Google\Cloud\Compute\V1\Compute::initOnce(); + parent::__construct($data); + } + + /** + * Topology details for all endpoints in the wire group. + * + * Generated from protobuf field repeated .google.cloud.compute.v1.WireGroupTopologyEndpoint endpoints = 287085950; + * @return \Google\Protobuf\Internal\RepeatedField + */ + public function getEndpoints() + { + return $this->endpoints; + } + + /** + * Topology details for all endpoints in the wire group. + * + * Generated from protobuf field repeated .google.cloud.compute.v1.WireGroupTopologyEndpoint endpoints = 287085950; + * @param array<\Google\Cloud\Compute\V1\WireGroupTopologyEndpoint>|\Google\Protobuf\Internal\RepeatedField $var + * @return $this + */ + public function setEndpoints($var) + { + $arr = GPBUtil::checkRepeatedField($var, \Google\Protobuf\Internal\GPBType::MESSAGE, \Google\Cloud\Compute\V1\WireGroupTopologyEndpoint::class); + $this->endpoints = $arr; + + return $this; + } + +} + diff --git a/Compute/src/V1/WireGroupTopologyEndpoint.php b/Compute/src/V1/WireGroupTopologyEndpoint.php new file mode 100644 index 000000000000..0bce48e0f82d --- /dev/null +++ b/Compute/src/V1/WireGroupTopologyEndpoint.php @@ -0,0 +1,125 @@ +google.cloud.compute.v1.WireGroupTopologyEndpoint + */ +class WireGroupTopologyEndpoint extends \Google\Protobuf\Internal\Message +{ + /** + * The InterconnectLocation.city (metropolitan area designator) that all + * interconnects are located in. + * + * Generated from protobuf field optional string city = 3053931; + */ + protected $city = null; + /** + * Endpoint label from the wire group. + * + * Generated from protobuf field optional string label = 102727412; + */ + protected $label = null; + + /** + * Constructor. + * + * @param array $data { + * Optional. Data for populating the Message object. + * + * @type string $city + * The InterconnectLocation.city (metropolitan area designator) that all + * interconnects are located in. + * @type string $label + * Endpoint label from the wire group. + * } + */ + public function __construct($data = NULL) { + \GPBMetadata\Google\Cloud\Compute\V1\Compute::initOnce(); + parent::__construct($data); + } + + /** + * The InterconnectLocation.city (metropolitan area designator) that all + * interconnects are located in. + * + * Generated from protobuf field optional string city = 3053931; + * @return string + */ + public function getCity() + { + return isset($this->city) ? $this->city : ''; + } + + public function hasCity() + { + return isset($this->city); + } + + public function clearCity() + { + unset($this->city); + } + + /** + * The InterconnectLocation.city (metropolitan area designator) that all + * interconnects are located in. + * + * Generated from protobuf field optional string city = 3053931; + * @param string $var + * @return $this + */ + public function setCity($var) + { + GPBUtil::checkString($var, True); + $this->city = $var; + + return $this; + } + + /** + * Endpoint label from the wire group. + * + * Generated from protobuf field optional string label = 102727412; + * @return string + */ + public function getLabel() + { + return isset($this->label) ? $this->label : ''; + } + + public function hasLabel() + { + return isset($this->label); + } + + public function clearLabel() + { + unset($this->label); + } + + /** + * Endpoint label from the wire group. + * + * Generated from protobuf field optional string label = 102727412; + * @param string $var + * @return $this + */ + public function setLabel($var) + { + GPBUtil::checkString($var, True); + $this->label = $var; + + return $this; + } + +} + diff --git a/Compute/src/V1/WireProperties.php b/Compute/src/V1/WireProperties.php new file mode 100644 index 000000000000..3f2cc5af5408 --- /dev/null +++ b/Compute/src/V1/WireProperties.php @@ -0,0 +1,221 @@ +google.cloud.compute.v1.WireProperties + */ +class WireProperties extends \Google\Protobuf\Internal\Message +{ + /** + * The configuration of the bandwidth allocation, one of the following: + * - ALLOCATE_PER_WIRE: configures a separate unmetered bandwidth allocation + * (and associated charges) for each wire in the group. + * - SHARED_WITH_WIRE_GROUP: this is the default behavior, which configures + * one unmetered bandwidth allocation for the wire group. The unmetered + * bandwidth is divided equally across each wire in the group, but dynamic + * throttling reallocates unused unmetered bandwidth from unused or underused + * wires to other wires in the group. + * Check the BandwidthAllocation enum for the list of possible values. + * + * Generated from protobuf field optional string bandwidth_allocation = 90651950; + */ + protected $bandwidth_allocation = null; + /** + * The unmetered bandwidth in Gigabits per second, using decimal units. `10` + * is 10 Gbps, `100` is 100 Gbps. The bandwidth must be greater than 0. + * + * Generated from protobuf field optional int64 bandwidth_unmetered = 272650017; + */ + protected $bandwidth_unmetered = null; + /** + * Response when a fault is detected in a pseudowire: + * - NONE: default. + * - DISABLE_PORT: set the port line protocol down when inline probes + * detect a fault. This setting is only permitted on port mode + * pseudowires. + * Check the FaultResponse enum for the list of possible values. + * + * Generated from protobuf field optional string fault_response = 353587646; + */ + protected $fault_response = null; + + /** + * Constructor. + * + * @param array $data { + * Optional. Data for populating the Message object. + * + * @type string $bandwidth_allocation + * The configuration of the bandwidth allocation, one of the following: + * - ALLOCATE_PER_WIRE: configures a separate unmetered bandwidth allocation + * (and associated charges) for each wire in the group. + * - SHARED_WITH_WIRE_GROUP: this is the default behavior, which configures + * one unmetered bandwidth allocation for the wire group. The unmetered + * bandwidth is divided equally across each wire in the group, but dynamic + * throttling reallocates unused unmetered bandwidth from unused or underused + * wires to other wires in the group. + * Check the BandwidthAllocation enum for the list of possible values. + * @type int|string $bandwidth_unmetered + * The unmetered bandwidth in Gigabits per second, using decimal units. `10` + * is 10 Gbps, `100` is 100 Gbps. The bandwidth must be greater than 0. + * @type string $fault_response + * Response when a fault is detected in a pseudowire: + * - NONE: default. + * - DISABLE_PORT: set the port line protocol down when inline probes + * detect a fault. This setting is only permitted on port mode + * pseudowires. + * Check the FaultResponse enum for the list of possible values. + * } + */ + public function __construct($data = NULL) { + \GPBMetadata\Google\Cloud\Compute\V1\Compute::initOnce(); + parent::__construct($data); + } + + /** + * The configuration of the bandwidth allocation, one of the following: + * - ALLOCATE_PER_WIRE: configures a separate unmetered bandwidth allocation + * (and associated charges) for each wire in the group. + * - SHARED_WITH_WIRE_GROUP: this is the default behavior, which configures + * one unmetered bandwidth allocation for the wire group. The unmetered + * bandwidth is divided equally across each wire in the group, but dynamic + * throttling reallocates unused unmetered bandwidth from unused or underused + * wires to other wires in the group. + * Check the BandwidthAllocation enum for the list of possible values. + * + * Generated from protobuf field optional string bandwidth_allocation = 90651950; + * @return string + */ + public function getBandwidthAllocation() + { + return isset($this->bandwidth_allocation) ? $this->bandwidth_allocation : ''; + } + + public function hasBandwidthAllocation() + { + return isset($this->bandwidth_allocation); + } + + public function clearBandwidthAllocation() + { + unset($this->bandwidth_allocation); + } + + /** + * The configuration of the bandwidth allocation, one of the following: + * - ALLOCATE_PER_WIRE: configures a separate unmetered bandwidth allocation + * (and associated charges) for each wire in the group. + * - SHARED_WITH_WIRE_GROUP: this is the default behavior, which configures + * one unmetered bandwidth allocation for the wire group. The unmetered + * bandwidth is divided equally across each wire in the group, but dynamic + * throttling reallocates unused unmetered bandwidth from unused or underused + * wires to other wires in the group. + * Check the BandwidthAllocation enum for the list of possible values. + * + * Generated from protobuf field optional string bandwidth_allocation = 90651950; + * @param string $var + * @return $this + */ + public function setBandwidthAllocation($var) + { + GPBUtil::checkString($var, True); + $this->bandwidth_allocation = $var; + + return $this; + } + + /** + * The unmetered bandwidth in Gigabits per second, using decimal units. `10` + * is 10 Gbps, `100` is 100 Gbps. The bandwidth must be greater than 0. + * + * Generated from protobuf field optional int64 bandwidth_unmetered = 272650017; + * @return int|string + */ + public function getBandwidthUnmetered() + { + return isset($this->bandwidth_unmetered) ? $this->bandwidth_unmetered : 0; + } + + public function hasBandwidthUnmetered() + { + return isset($this->bandwidth_unmetered); + } + + public function clearBandwidthUnmetered() + { + unset($this->bandwidth_unmetered); + } + + /** + * The unmetered bandwidth in Gigabits per second, using decimal units. `10` + * is 10 Gbps, `100` is 100 Gbps. The bandwidth must be greater than 0. + * + * Generated from protobuf field optional int64 bandwidth_unmetered = 272650017; + * @param int|string $var + * @return $this + */ + public function setBandwidthUnmetered($var) + { + GPBUtil::checkInt64($var); + $this->bandwidth_unmetered = $var; + + return $this; + } + + /** + * Response when a fault is detected in a pseudowire: + * - NONE: default. + * - DISABLE_PORT: set the port line protocol down when inline probes + * detect a fault. This setting is only permitted on port mode + * pseudowires. + * Check the FaultResponse enum for the list of possible values. + * + * Generated from protobuf field optional string fault_response = 353587646; + * @return string + */ + public function getFaultResponse() + { + return isset($this->fault_response) ? $this->fault_response : ''; + } + + public function hasFaultResponse() + { + return isset($this->fault_response); + } + + public function clearFaultResponse() + { + unset($this->fault_response); + } + + /** + * Response when a fault is detected in a pseudowire: + * - NONE: default. + * - DISABLE_PORT: set the port line protocol down when inline probes + * detect a fault. This setting is only permitted on port mode + * pseudowires. + * Check the FaultResponse enum for the list of possible values. + * + * Generated from protobuf field optional string fault_response = 353587646; + * @param string $var + * @return $this + */ + public function setFaultResponse($var) + { + GPBUtil::checkString($var, True); + $this->fault_response = $var; + + return $this; + } + +} + diff --git a/Compute/src/V1/WireProperties/BandwidthAllocation.php b/Compute/src/V1/WireProperties/BandwidthAllocation.php new file mode 100644 index 000000000000..24db24c0bbc8 --- /dev/null +++ b/Compute/src/V1/WireProperties/BandwidthAllocation.php @@ -0,0 +1,74 @@ +google.cloud.compute.v1.WireProperties.BandwidthAllocation + */ +class BandwidthAllocation +{ + /** + * A value indicating that the enum field is not set. + * + * Generated from protobuf enum UNDEFINED_BANDWIDTH_ALLOCATION = 0; + */ + const UNDEFINED_BANDWIDTH_ALLOCATION = 0; + /** + * Configures a separate unmetered bandwidth allocation (and associated + * charges) for each wire in the group. + * + * Generated from protobuf enum ALLOCATE_PER_WIRE = 358730057; + */ + const ALLOCATE_PER_WIRE = 358730057; + /** + * This is the default behavior. Configures one unmetered bandwidth + * allocation for the wire group. The unmetered bandwidth is divided equally + * across each wire in the group, but dynamic throttling reallocates unused + * unmetered bandwidth from unused or underused wires to other wires in the + * group. + * + * Generated from protobuf enum SHARED_WITH_WIRE_GROUP = 286454628; + */ + const SHARED_WITH_WIRE_GROUP = 286454628; + + private static $valueToName = [ + self::UNDEFINED_BANDWIDTH_ALLOCATION => 'UNDEFINED_BANDWIDTH_ALLOCATION', + self::ALLOCATE_PER_WIRE => 'ALLOCATE_PER_WIRE', + self::SHARED_WITH_WIRE_GROUP => 'SHARED_WITH_WIRE_GROUP', + ]; + + public static function name($value) + { + if (!isset(self::$valueToName[$value])) { + throw new UnexpectedValueException(sprintf( + 'Enum %s has no name defined for value %s', __CLASS__, $value)); + } + return self::$valueToName[$value]; + } + + + public static function value($name) + { + $const = __CLASS__ . '::' . strtoupper($name); + if (!defined($const)) { + throw new UnexpectedValueException(sprintf( + 'Enum %s has no value defined for name %s', __CLASS__, $name)); + } + return constant($const); + } +} + + diff --git a/Compute/src/V1/WireProperties/FaultResponse.php b/Compute/src/V1/WireProperties/FaultResponse.php new file mode 100644 index 000000000000..14af2cbf7340 --- /dev/null +++ b/Compute/src/V1/WireProperties/FaultResponse.php @@ -0,0 +1,67 @@ +google.cloud.compute.v1.WireProperties.FaultResponse + */ +class FaultResponse +{ + /** + * A value indicating that the enum field is not set. + * + * Generated from protobuf enum UNDEFINED_FAULT_RESPONSE = 0; + */ + const UNDEFINED_FAULT_RESPONSE = 0; + /** + * Set the port line protocol down when inline probes detect a fault. This + * setting is only permitted on port mode pseudowires. + * + * Generated from protobuf enum DISABLE_PORT = 287086488; + */ + const DISABLE_PORT = 287086488; + /** + * Default. + * + * Generated from protobuf enum NONE = 2402104; + */ + const NONE = 2402104; + + private static $valueToName = [ + self::UNDEFINED_FAULT_RESPONSE => 'UNDEFINED_FAULT_RESPONSE', + self::DISABLE_PORT => 'DISABLE_PORT', + self::NONE => 'NONE', + ]; + + public static function name($value) + { + if (!isset(self::$valueToName[$value])) { + throw new UnexpectedValueException(sprintf( + 'Enum %s has no name defined for value %s', __CLASS__, $value)); + } + return self::$valueToName[$value]; + } + + + public static function value($name) + { + $const = __CLASS__ . '::' . strtoupper($name); + if (!defined($const)) { + throw new UnexpectedValueException(sprintf( + 'Enum %s has no value defined for name %s', __CLASS__, $name)); + } + return constant($const); + } +} + + diff --git a/Compute/src/V1/WithdrawPublicAdvertisedPrefixeRequest.php b/Compute/src/V1/WithdrawPublicAdvertisedPrefixeRequest.php index dac4a8d5701b..e55a130fe044 100644 --- a/Compute/src/V1/WithdrawPublicAdvertisedPrefixeRequest.php +++ b/Compute/src/V1/WithdrawPublicAdvertisedPrefixeRequest.php @@ -28,7 +28,17 @@ class WithdrawPublicAdvertisedPrefixeRequest extends \Google\Protobuf\Internal\M */ protected $public_advertised_prefix = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -60,7 +70,17 @@ public static function build(string $project, string $publicAdvertisedPrefix): s * @type string $public_advertised_prefix * The name of the public advertised prefix. It should comply with RFC1035. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -121,7 +141,17 @@ public function setPublicAdvertisedPrefix($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -142,7 +172,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/WithdrawPublicDelegatedPrefixeRequest.php b/Compute/src/V1/WithdrawPublicDelegatedPrefixeRequest.php index 5d0a726412fb..a3f63a6964f9 100644 --- a/Compute/src/V1/WithdrawPublicDelegatedPrefixeRequest.php +++ b/Compute/src/V1/WithdrawPublicDelegatedPrefixeRequest.php @@ -28,13 +28,24 @@ class WithdrawPublicDelegatedPrefixeRequest extends \Google\Protobuf\Internal\Me */ protected $public_delegated_prefix = ''; /** - * The name of the region where the public delegated prefix is located. It should comply with RFC1035. + * The name of theregion where + * the public delegated prefix is located. It should comply with RFC1035. * * Generated from protobuf field string region = 138946292 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "region"]; */ protected $region = ''; /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; */ @@ -42,7 +53,8 @@ class WithdrawPublicDelegatedPrefixeRequest extends \Google\Protobuf\Internal\Me /** * @param string $project Project ID for this request. - * @param string $region The name of the region where the public delegated prefix is located. It should comply with RFC1035. + * @param string $region The name of theregion where + * the public delegated prefix is located. It should comply with RFC1035. * @param string $publicDelegatedPrefix The name of the public delegated prefix. It should comply with RFC1035. * * @return \Google\Cloud\Compute\V1\WithdrawPublicDelegatedPrefixeRequest @@ -68,9 +80,20 @@ public static function build(string $project, string $region, string $publicDele * @type string $public_delegated_prefix * The name of the public delegated prefix. It should comply with RFC1035. * @type string $region - * The name of the region where the public delegated prefix is located. It should comply with RFC1035. + * The name of theregion where + * the public delegated prefix is located. It should comply with RFC1035. * @type string $request_id - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * } */ public function __construct($data = NULL) { @@ -131,7 +154,8 @@ public function setPublicDelegatedPrefix($var) } /** - * The name of the region where the public delegated prefix is located. It should comply with RFC1035. + * The name of theregion where + * the public delegated prefix is located. It should comply with RFC1035. * * Generated from protobuf field string region = 138946292 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "region"]; * @return string @@ -142,7 +166,8 @@ public function getRegion() } /** - * The name of the region where the public delegated prefix is located. It should comply with RFC1035. + * The name of theregion where + * the public delegated prefix is located. It should comply with RFC1035. * * Generated from protobuf field string region = 138946292 [(.google.api.field_behavior) = REQUIRED, (.google.cloud.operation_request_field) = "region"]; * @param string $var @@ -157,7 +182,17 @@ public function setRegion($var) } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @return string @@ -178,7 +213,17 @@ public function clearRequestId() } /** - * An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). + * An optional request ID to identify requests. Specify a unique request ID so + * that if you must retry your request, the server will know to ignore the + * request if it has already been completed. + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same + * request ID, the server can check if original operation with the same + * request ID was received, and if so, will ignore the second request. This + * prevents clients from accidentally creating duplicate commitments. + * The request ID must be + * a valid UUID with the exception that zero UUID is not supported + * (00000000-0000-0000-0000-000000000000). * * Generated from protobuf field optional string request_id = 37109963; * @param string $var diff --git a/Compute/src/V1/XpnHostList.php b/Compute/src/V1/XpnHostList.php index 816740c08dcb..bccf53252f71 100644 --- a/Compute/src/V1/XpnHostList.php +++ b/Compute/src/V1/XpnHostList.php @@ -27,13 +27,18 @@ class XpnHostList extends \Google\Protobuf\Internal\Message */ private $items; /** - * [Output Only] Type of resource. Always compute#xpnHostList for lists of shared VPC hosts. + * [Output Only] Type of resource. Always compute#xpnHostList for + * lists of shared VPC hosts. * * Generated from protobuf field optional string kind = 3292052; */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -62,9 +67,14 @@ class XpnHostList extends \Google\Protobuf\Internal\Message * @type array<\Google\Cloud\Compute\V1\Project>|\Google\Protobuf\Internal\RepeatedField $items * [Output Only] A list of shared VPC host project URLs. * @type string $kind - * [Output Only] Type of resource. Always compute#xpnHostList for lists of shared VPC hosts. + * [Output Only] Type of resource. Always compute#xpnHostList for + * lists of shared VPC hosts. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type \Google\Cloud\Compute\V1\Warning $warning @@ -139,7 +149,8 @@ public function setItems($var) } /** - * [Output Only] Type of resource. Always compute#xpnHostList for lists of shared VPC hosts. + * [Output Only] Type of resource. Always compute#xpnHostList for + * lists of shared VPC hosts. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -160,7 +171,8 @@ public function clearKind() } /** - * [Output Only] Type of resource. Always compute#xpnHostList for lists of shared VPC hosts. + * [Output Only] Type of resource. Always compute#xpnHostList for + * lists of shared VPC hosts. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -175,7 +187,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -196,7 +212,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/XpnResourceId.php b/Compute/src/V1/XpnResourceId.php index 638f0d858964..ed1e5eeec166 100644 --- a/Compute/src/V1/XpnResourceId.php +++ b/Compute/src/V1/XpnResourceId.php @@ -16,7 +16,9 @@ class XpnResourceId extends \Google\Protobuf\Internal\Message { /** - * The ID of the service resource. In the case of projects, this field supports project id (e.g., my-project-123) and project number (e.g. 12345678). + * The ID of the service resource. In the case of projects, this field + * supports project id (e.g., my-project-123) and project number + * (e.g. 12345678). * * Generated from protobuf field optional string id = 3355; */ @@ -36,7 +38,9 @@ class XpnResourceId extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $id - * The ID of the service resource. In the case of projects, this field supports project id (e.g., my-project-123) and project number (e.g. 12345678). + * The ID of the service resource. In the case of projects, this field + * supports project id (e.g., my-project-123) and project number + * (e.g. 12345678). * @type string $type * The type of the service resource. * Check the Type enum for the list of possible values. @@ -48,7 +52,9 @@ public function __construct($data = NULL) { } /** - * The ID of the service resource. In the case of projects, this field supports project id (e.g., my-project-123) and project number (e.g. 12345678). + * The ID of the service resource. In the case of projects, this field + * supports project id (e.g., my-project-123) and project number + * (e.g. 12345678). * * Generated from protobuf field optional string id = 3355; * @return string @@ -69,7 +75,9 @@ public function clearId() } /** - * The ID of the service resource. In the case of projects, this field supports project id (e.g., my-project-123) and project number (e.g. 12345678). + * The ID of the service resource. In the case of projects, this field + * supports project id (e.g., my-project-123) and project number + * (e.g. 12345678). * * Generated from protobuf field optional string id = 3355; * @param string $var diff --git a/Compute/src/V1/Zone.php b/Compute/src/V1/Zone.php index 21d3b92d004a..484da1d832f1 100644 --- a/Compute/src/V1/Zone.php +++ b/Compute/src/V1/Zone.php @@ -9,7 +9,10 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Represents a Zone resource. A zone is a deployment area. These deployment areas are subsets of a region. For example the zone us-east1-b is located in the us-east1 region. For more information, read Regions and Zones. + * Represents a Zone resource. + * A zone is a deployment area. These deployment areas are subsets of a region. + * For example the zone us-east1-b is located in theus-east1 region. For more information, readRegions and + * Zones. * * Generated from protobuf message google.cloud.compute.v1.Zone */ @@ -22,7 +25,8 @@ class Zone extends \Google\Protobuf\Internal\Message */ private $available_cpu_platforms; /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; */ @@ -40,13 +44,15 @@ class Zone extends \Google\Protobuf\Internal\Message */ protected $description = null; /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; */ protected $id = null; /** - * [Output Only] Type of the resource. Always compute#zone for zones. + * [Output Only] Type of the resource. Always compute#zone for + * zones. * * Generated from protobuf field optional string kind = 3292052; */ @@ -70,7 +76,7 @@ class Zone extends \Google\Protobuf\Internal\Message */ protected $self_link = null; /** - * [Output Only] Status of the zone, either UP or DOWN. + * [Output Only] Status of the zone, either UP orDOWN. * Check the Status enum for the list of possible values. * * Generated from protobuf field optional string status = 181260274; @@ -92,15 +98,18 @@ class Zone extends \Google\Protobuf\Internal\Message * @type array|\Google\Protobuf\Internal\RepeatedField $available_cpu_platforms * [Output Only] Available cpu/platform selections for the zone. * @type string $creation_timestamp - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * @type \Google\Cloud\Compute\V1\DeprecationStatus $deprecated * [Output Only] The deprecation status associated with this zone. * @type string $description * [Output Only] Textual description of the resource. * @type int|string $id - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * @type string $kind - * [Output Only] Type of the resource. Always compute#zone for zones. + * [Output Only] Type of the resource. Always compute#zone for + * zones. * @type string $name * [Output Only] Name of the resource. * @type string $region @@ -108,7 +117,7 @@ class Zone extends \Google\Protobuf\Internal\Message * @type string $self_link * [Output Only] Server-defined URL for the resource. * @type string $status - * [Output Only] Status of the zone, either UP or DOWN. + * [Output Only] Status of the zone, either UP orDOWN. * Check the Status enum for the list of possible values. * @type bool $supports_pzs * [Output Only] Reserved for future use. @@ -146,7 +155,8 @@ public function setAvailableCpuPlatforms($var) } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @return string @@ -167,7 +177,8 @@ public function clearCreationTimestamp() } /** - * [Output Only] Creation timestamp in RFC3339 text format. + * [Output Only] Creation timestamp inRFC3339 + * text format. * * Generated from protobuf field optional string creation_timestamp = 30525366; * @param string $var @@ -254,7 +265,8 @@ public function setDescription($var) } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @return int|string @@ -275,7 +287,8 @@ public function clearId() } /** - * [Output Only] The unique identifier for the resource. This identifier is defined by the server. + * [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. * * Generated from protobuf field optional uint64 id = 3355; * @param int|string $var @@ -290,7 +303,8 @@ public function setId($var) } /** - * [Output Only] Type of the resource. Always compute#zone for zones. + * [Output Only] Type of the resource. Always compute#zone for + * zones. * * Generated from protobuf field optional string kind = 3292052; * @return string @@ -311,7 +325,8 @@ public function clearKind() } /** - * [Output Only] Type of the resource. Always compute#zone for zones. + * [Output Only] Type of the resource. Always compute#zone for + * zones. * * Generated from protobuf field optional string kind = 3292052; * @param string $var @@ -434,7 +449,7 @@ public function setSelfLink($var) } /** - * [Output Only] Status of the zone, either UP or DOWN. + * [Output Only] Status of the zone, either UP orDOWN. * Check the Status enum for the list of possible values. * * Generated from protobuf field optional string status = 181260274; @@ -456,7 +471,7 @@ public function clearStatus() } /** - * [Output Only] Status of the zone, either UP or DOWN. + * [Output Only] Status of the zone, either UP orDOWN. * Check the Status enum for the list of possible values. * * Generated from protobuf field optional string status = 181260274; diff --git a/Compute/src/V1/Zone/Status.php b/Compute/src/V1/Zone/Status.php index 118b1246d9dd..c5f4d9a622e0 100644 --- a/Compute/src/V1/Zone/Status.php +++ b/Compute/src/V1/Zone/Status.php @@ -7,7 +7,7 @@ use UnexpectedValueException; /** - * [Output Only] Status of the zone, either UP or DOWN. + * [Output Only] Status of the zone, either UP orDOWN. * * Protobuf type google.cloud.compute.v1.Zone.Status */ diff --git a/Compute/src/V1/ZoneList.php b/Compute/src/V1/ZoneList.php index 3e7eef263caa..6148eb177936 100644 --- a/Compute/src/V1/ZoneList.php +++ b/Compute/src/V1/ZoneList.php @@ -34,7 +34,11 @@ class ZoneList extends \Google\Protobuf\Internal\Message */ protected $kind = null; /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; */ @@ -65,7 +69,11 @@ class ZoneList extends \Google\Protobuf\Internal\Message * @type string $kind * Type of resource. * @type string $next_page_token - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * @type string $self_link * [Output Only] Server-defined URL for this resource. * @type \Google\Cloud\Compute\V1\Warning $warning @@ -176,7 +184,11 @@ public function setKind($var) } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @return string @@ -197,7 +209,11 @@ public function clearNextPageToken() } /** - * [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. * * Generated from protobuf field optional string next_page_token = 79797525; * @param string $var diff --git a/Compute/src/V1/ZoneSetLabelsRequest.php b/Compute/src/V1/ZoneSetLabelsRequest.php index 9b2bf910ddc4..68c51b51f6dc 100644 --- a/Compute/src/V1/ZoneSetLabelsRequest.php +++ b/Compute/src/V1/ZoneSetLabelsRequest.php @@ -15,7 +15,12 @@ class ZoneSetLabelsRequest extends \Google\Protobuf\Internal\Message { /** - * The fingerprint of the previous set of labels for this resource, used to detect conflicts. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels. Make a get() request to the resource to get the latest fingerprint. + * The fingerprint of the previous set of labels for this resource, + * used to detect conflicts. The fingerprint is initially generated by Compute + * Engine and changes after every request to modify or update labels. You must + * always provide an up-to-date fingerprint hash in order to update or change + * labels. Make a get() request to the resource to get the latest + * fingerprint. * * Generated from protobuf field optional string label_fingerprint = 178124825; */ @@ -34,7 +39,12 @@ class ZoneSetLabelsRequest extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $label_fingerprint - * The fingerprint of the previous set of labels for this resource, used to detect conflicts. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels. Make a get() request to the resource to get the latest fingerprint. + * The fingerprint of the previous set of labels for this resource, + * used to detect conflicts. The fingerprint is initially generated by Compute + * Engine and changes after every request to modify or update labels. You must + * always provide an up-to-date fingerprint hash in order to update or change + * labels. Make a get() request to the resource to get the latest + * fingerprint. * @type array|\Google\Protobuf\Internal\MapField $labels * The labels to set for this resource. * } @@ -45,7 +55,12 @@ public function __construct($data = NULL) { } /** - * The fingerprint of the previous set of labels for this resource, used to detect conflicts. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels. Make a get() request to the resource to get the latest fingerprint. + * The fingerprint of the previous set of labels for this resource, + * used to detect conflicts. The fingerprint is initially generated by Compute + * Engine and changes after every request to modify or update labels. You must + * always provide an up-to-date fingerprint hash in order to update or change + * labels. Make a get() request to the resource to get the latest + * fingerprint. * * Generated from protobuf field optional string label_fingerprint = 178124825; * @return string @@ -66,7 +81,12 @@ public function clearLabelFingerprint() } /** - * The fingerprint of the previous set of labels for this resource, used to detect conflicts. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels. Make a get() request to the resource to get the latest fingerprint. + * The fingerprint of the previous set of labels for this resource, + * used to detect conflicts. The fingerprint is initially generated by Compute + * Engine and changes after every request to modify or update labels. You must + * always provide an up-to-date fingerprint hash in order to update or change + * labels. Make a get() request to the resource to get the latest + * fingerprint. * * Generated from protobuf field optional string label_fingerprint = 178124825; * @param string $var diff --git a/Compute/src/V1/ZoneSetNestedPolicyRequest.php b/Compute/src/V1/ZoneSetNestedPolicyRequest.php new file mode 100644 index 000000000000..f53415b7af80 --- /dev/null +++ b/Compute/src/V1/ZoneSetNestedPolicyRequest.php @@ -0,0 +1,170 @@ +google.cloud.compute.v1.ZoneSetNestedPolicyRequest + */ +class ZoneSetNestedPolicyRequest extends \Google\Protobuf\Internal\Message +{ + /** + * Flatten Policy to create a backwacd compatible wire-format. + * Deprecated. Use 'policy' to specify bindings. + * + * Generated from protobuf field repeated .google.cloud.compute.v1.Binding bindings = 403251854; + */ + private $bindings; + /** + * Flatten Policy to create a backward compatible wire-format. + * Deprecated. Use 'policy' to specify the etag. + * + * Generated from protobuf field optional string etag = 3123477; + */ + protected $etag = null; + /** + * REQUIRED: The complete policy to be applied to the 'resource'. The size of + * the policy is limited to a few 10s of KB. An empty policy is in general a + * valid policy but certain services (like Projects) might reject them. + * + * Generated from protobuf field optional .google.cloud.compute.v1.Policy policy = 91071794; + */ + protected $policy = null; + + /** + * Constructor. + * + * @param array $data { + * Optional. Data for populating the Message object. + * + * @type array<\Google\Cloud\Compute\V1\Binding>|\Google\Protobuf\Internal\RepeatedField $bindings + * Flatten Policy to create a backwacd compatible wire-format. + * Deprecated. Use 'policy' to specify bindings. + * @type string $etag + * Flatten Policy to create a backward compatible wire-format. + * Deprecated. Use 'policy' to specify the etag. + * @type \Google\Cloud\Compute\V1\Policy $policy + * REQUIRED: The complete policy to be applied to the 'resource'. The size of + * the policy is limited to a few 10s of KB. An empty policy is in general a + * valid policy but certain services (like Projects) might reject them. + * } + */ + public function __construct($data = NULL) { + \GPBMetadata\Google\Cloud\Compute\V1\Compute::initOnce(); + parent::__construct($data); + } + + /** + * Flatten Policy to create a backwacd compatible wire-format. + * Deprecated. Use 'policy' to specify bindings. + * + * Generated from protobuf field repeated .google.cloud.compute.v1.Binding bindings = 403251854; + * @return \Google\Protobuf\Internal\RepeatedField + */ + public function getBindings() + { + return $this->bindings; + } + + /** + * Flatten Policy to create a backwacd compatible wire-format. + * Deprecated. Use 'policy' to specify bindings. + * + * Generated from protobuf field repeated .google.cloud.compute.v1.Binding bindings = 403251854; + * @param array<\Google\Cloud\Compute\V1\Binding>|\Google\Protobuf\Internal\RepeatedField $var + * @return $this + */ + public function setBindings($var) + { + $arr = GPBUtil::checkRepeatedField($var, \Google\Protobuf\Internal\GPBType::MESSAGE, \Google\Cloud\Compute\V1\Binding::class); + $this->bindings = $arr; + + return $this; + } + + /** + * Flatten Policy to create a backward compatible wire-format. + * Deprecated. Use 'policy' to specify the etag. + * + * Generated from protobuf field optional string etag = 3123477; + * @return string + */ + public function getEtag() + { + return isset($this->etag) ? $this->etag : ''; + } + + public function hasEtag() + { + return isset($this->etag); + } + + public function clearEtag() + { + unset($this->etag); + } + + /** + * Flatten Policy to create a backward compatible wire-format. + * Deprecated. Use 'policy' to specify the etag. + * + * Generated from protobuf field optional string etag = 3123477; + * @param string $var + * @return $this + */ + public function setEtag($var) + { + GPBUtil::checkString($var, True); + $this->etag = $var; + + return $this; + } + + /** + * REQUIRED: The complete policy to be applied to the 'resource'. The size of + * the policy is limited to a few 10s of KB. An empty policy is in general a + * valid policy but certain services (like Projects) might reject them. + * + * Generated from protobuf field optional .google.cloud.compute.v1.Policy policy = 91071794; + * @return \Google\Cloud\Compute\V1\Policy|null + */ + public function getPolicy() + { + return $this->policy; + } + + public function hasPolicy() + { + return isset($this->policy); + } + + public function clearPolicy() + { + unset($this->policy); + } + + /** + * REQUIRED: The complete policy to be applied to the 'resource'. The size of + * the policy is limited to a few 10s of KB. An empty policy is in general a + * valid policy but certain services (like Projects) might reject them. + * + * Generated from protobuf field optional .google.cloud.compute.v1.Policy policy = 91071794; + * @param \Google\Cloud\Compute\V1\Policy $var + * @return $this + */ + public function setPolicy($var) + { + GPBUtil::checkMessage($var, \Google\Cloud\Compute\V1\Policy::class); + $this->policy = $var; + + return $this; + } + +} + diff --git a/Compute/src/V1/ZoneSetPolicyRequest.php b/Compute/src/V1/ZoneSetPolicyRequest.php index 722230f9c1a4..8260b296850e 100644 --- a/Compute/src/V1/ZoneSetPolicyRequest.php +++ b/Compute/src/V1/ZoneSetPolicyRequest.php @@ -15,19 +15,23 @@ class ZoneSetPolicyRequest extends \Google\Protobuf\Internal\Message { /** - * Flatten Policy to create a backwacd compatible wire-format. Deprecated. Use 'policy' to specify bindings. + * Flatten Policy to create a backwacd compatible wire-format. + * Deprecated. Use 'policy' to specify bindings. * * Generated from protobuf field repeated .google.cloud.compute.v1.Binding bindings = 403251854; */ private $bindings; /** - * Flatten Policy to create a backward compatible wire-format. Deprecated. Use 'policy' to specify the etag. + * Flatten Policy to create a backward compatible wire-format. + * Deprecated. Use 'policy' to specify the etag. * * Generated from protobuf field optional string etag = 3123477; */ protected $etag = null; /** - * REQUIRED: The complete policy to be applied to the 'resource'. The size of the policy is limited to a few 10s of KB. An empty policy is in general a valid policy but certain services (like Projects) might reject them. + * REQUIRED: The complete policy to be applied to the 'resource'. The size of + * the policy is limited to a few 10s of KB. An empty policy is in general a + * valid policy but certain services (like Projects) might reject them. * * Generated from protobuf field optional .google.cloud.compute.v1.Policy policy = 91071794; */ @@ -40,11 +44,15 @@ class ZoneSetPolicyRequest extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type array<\Google\Cloud\Compute\V1\Binding>|\Google\Protobuf\Internal\RepeatedField $bindings - * Flatten Policy to create a backwacd compatible wire-format. Deprecated. Use 'policy' to specify bindings. + * Flatten Policy to create a backwacd compatible wire-format. + * Deprecated. Use 'policy' to specify bindings. * @type string $etag - * Flatten Policy to create a backward compatible wire-format. Deprecated. Use 'policy' to specify the etag. + * Flatten Policy to create a backward compatible wire-format. + * Deprecated. Use 'policy' to specify the etag. * @type \Google\Cloud\Compute\V1\Policy $policy - * REQUIRED: The complete policy to be applied to the 'resource'. The size of the policy is limited to a few 10s of KB. An empty policy is in general a valid policy but certain services (like Projects) might reject them. + * REQUIRED: The complete policy to be applied to the 'resource'. The size of + * the policy is limited to a few 10s of KB. An empty policy is in general a + * valid policy but certain services (like Projects) might reject them. * } */ public function __construct($data = NULL) { @@ -53,7 +61,8 @@ public function __construct($data = NULL) { } /** - * Flatten Policy to create a backwacd compatible wire-format. Deprecated. Use 'policy' to specify bindings. + * Flatten Policy to create a backwacd compatible wire-format. + * Deprecated. Use 'policy' to specify bindings. * * Generated from protobuf field repeated .google.cloud.compute.v1.Binding bindings = 403251854; * @return \Google\Protobuf\Internal\RepeatedField @@ -64,7 +73,8 @@ public function getBindings() } /** - * Flatten Policy to create a backwacd compatible wire-format. Deprecated. Use 'policy' to specify bindings. + * Flatten Policy to create a backwacd compatible wire-format. + * Deprecated. Use 'policy' to specify bindings. * * Generated from protobuf field repeated .google.cloud.compute.v1.Binding bindings = 403251854; * @param array<\Google\Cloud\Compute\V1\Binding>|\Google\Protobuf\Internal\RepeatedField $var @@ -79,7 +89,8 @@ public function setBindings($var) } /** - * Flatten Policy to create a backward compatible wire-format. Deprecated. Use 'policy' to specify the etag. + * Flatten Policy to create a backward compatible wire-format. + * Deprecated. Use 'policy' to specify the etag. * * Generated from protobuf field optional string etag = 3123477; * @return string @@ -100,7 +111,8 @@ public function clearEtag() } /** - * Flatten Policy to create a backward compatible wire-format. Deprecated. Use 'policy' to specify the etag. + * Flatten Policy to create a backward compatible wire-format. + * Deprecated. Use 'policy' to specify the etag. * * Generated from protobuf field optional string etag = 3123477; * @param string $var @@ -115,7 +127,9 @@ public function setEtag($var) } /** - * REQUIRED: The complete policy to be applied to the 'resource'. The size of the policy is limited to a few 10s of KB. An empty policy is in general a valid policy but certain services (like Projects) might reject them. + * REQUIRED: The complete policy to be applied to the 'resource'. The size of + * the policy is limited to a few 10s of KB. An empty policy is in general a + * valid policy but certain services (like Projects) might reject them. * * Generated from protobuf field optional .google.cloud.compute.v1.Policy policy = 91071794; * @return \Google\Cloud\Compute\V1\Policy|null @@ -136,7 +150,9 @@ public function clearPolicy() } /** - * REQUIRED: The complete policy to be applied to the 'resource'. The size of the policy is limited to a few 10s of KB. An empty policy is in general a valid policy but certain services (like Projects) might reject them. + * REQUIRED: The complete policy to be applied to the 'resource'. The size of + * the policy is limited to a few 10s of KB. An empty policy is in general a + * valid policy but certain services (like Projects) might reject them. * * Generated from protobuf field optional .google.cloud.compute.v1.Policy policy = 91071794; * @param \Google\Cloud\Compute\V1\Policy $var diff --git a/Compute/src/V1/gapic_metadata.json b/Compute/src/V1/gapic_metadata.json index 67627547e83d..c747287dd935 100644 --- a/Compute/src/V1/gapic_metadata.json +++ b/Compute/src/V1/gapic_metadata.json @@ -285,6 +285,40 @@ } } }, + "CrossSiteNetworks": { + "clients": { + "grpc": { + "libraryClient": "CrossSiteNetworksGapicClient", + "rpcs": { + "Delete": { + "methods": [ + "delete" + ] + }, + "Get": { + "methods": [ + "get" + ] + }, + "Insert": { + "methods": [ + "insert" + ] + }, + "List": { + "methods": [ + "list" + ] + }, + "Patch": { + "methods": [ + "patch" + ] + } + } + } + } + }, "DiskTypes": { "clients": { "grpc": { @@ -581,6 +615,11 @@ "patch" ] }, + "TestIamPermissions": { + "methods": [ + "testIamPermissions" + ] + }, "Update": { "methods": [ "update" @@ -639,6 +678,50 @@ } } }, + "FutureReservations": { + "clients": { + "grpc": { + "libraryClient": "FutureReservationsGapicClient", + "rpcs": { + "AggregatedList": { + "methods": [ + "aggregatedList" + ] + }, + "Cancel": { + "methods": [ + "cancel" + ] + }, + "Delete": { + "methods": [ + "delete" + ] + }, + "Get": { + "methods": [ + "get" + ] + }, + "Insert": { + "methods": [ + "insert" + ] + }, + "List": { + "methods": [ + "list" + ] + }, + "Update": { + "methods": [ + "update" + ] + } + } + } + } + }, "GlobalAddresses": { "clients": { "grpc": { @@ -3903,6 +3986,11 @@ "get" ] }, + "GetIamPolicy": { + "methods": [ + "getIamPolicy" + ] + }, "List": { "methods": [ "list" @@ -3912,6 +4000,16 @@ "methods": [ "performMaintenance" ] + }, + "SetIamPolicy": { + "methods": [ + "setIamPolicy" + ] + }, + "TestIamPermissions": { + "methods": [ + "testIamPermissions" + ] } } } @@ -3927,6 +4025,11 @@ "get" ] }, + "GetIamPolicy": { + "methods": [ + "getIamPolicy" + ] + }, "List": { "methods": [ "list" @@ -3941,6 +4044,16 @@ "methods": [ "reportFaulty" ] + }, + "SetIamPolicy": { + "methods": [ + "setIamPolicy" + ] + }, + "TestIamPermissions": { + "methods": [ + "testIamPermissions" + ] } } } @@ -5147,6 +5260,40 @@ } } }, + "WireGroups": { + "clients": { + "grpc": { + "libraryClient": "WireGroupsGapicClient", + "rpcs": { + "Delete": { + "methods": [ + "delete" + ] + }, + "Get": { + "methods": [ + "get" + ] + }, + "Insert": { + "methods": [ + "insert" + ] + }, + "List": { + "methods": [ + "list" + ] + }, + "Patch": { + "methods": [ + "patch" + ] + } + } + } + } + }, "ZoneOperations": { "clients": { "grpc": { diff --git a/Compute/src/V1/resources/cross_site_networks_client_config.json b/Compute/src/V1/resources/cross_site_networks_client_config.json new file mode 100644 index 000000000000..8e1a9eb4d55f --- /dev/null +++ b/Compute/src/V1/resources/cross_site_networks_client_config.json @@ -0,0 +1,70 @@ +{ + "interfaces": { + "google.cloud.compute.v1.CrossSiteNetworks": { + "retry_codes": { + "no_retry_codes": [], + "retry_policy_1_codes": [ + "DEADLINE_EXCEEDED", + "UNAVAILABLE" + ], + "no_retry_1_codes": [] + }, + "retry_params": { + "no_retry_params": { + "initial_retry_delay_millis": 0, + "retry_delay_multiplier": 0.0, + "max_retry_delay_millis": 0, + "initial_rpc_timeout_millis": 0, + "rpc_timeout_multiplier": 1.0, + "max_rpc_timeout_millis": 0, + "total_timeout_millis": 0 + }, + "retry_policy_1_params": { + "initial_retry_delay_millis": 100, + "retry_delay_multiplier": 1.3, + "max_retry_delay_millis": 60000, + "initial_rpc_timeout_millis": 600000, + "rpc_timeout_multiplier": 1.0, + "max_rpc_timeout_millis": 600000, + "total_timeout_millis": 600000 + }, + "no_retry_1_params": { + "initial_retry_delay_millis": 0, + "retry_delay_multiplier": 0.0, + "max_retry_delay_millis": 0, + "initial_rpc_timeout_millis": 600000, + "rpc_timeout_multiplier": 1.0, + "max_rpc_timeout_millis": 600000, + "total_timeout_millis": 600000 + } + }, + "methods": { + "Delete": { + "timeout_millis": 600000, + "retry_codes_name": "no_retry_1_codes", + "retry_params_name": "no_retry_1_params" + }, + "Get": { + "timeout_millis": 600000, + "retry_codes_name": "retry_policy_1_codes", + "retry_params_name": "retry_policy_1_params" + }, + "Insert": { + "timeout_millis": 600000, + "retry_codes_name": "no_retry_1_codes", + "retry_params_name": "no_retry_1_params" + }, + "List": { + "timeout_millis": 600000, + "retry_codes_name": "retry_policy_1_codes", + "retry_params_name": "retry_policy_1_params" + }, + "Patch": { + "timeout_millis": 600000, + "retry_codes_name": "no_retry_1_codes", + "retry_params_name": "no_retry_1_params" + } + } + } + } +} diff --git a/Compute/src/V1/resources/cross_site_networks_descriptor_config.php b/Compute/src/V1/resources/cross_site_networks_descriptor_config.php new file mode 100644 index 000000000000..819059d74daf --- /dev/null +++ b/Compute/src/V1/resources/cross_site_networks_descriptor_config.php @@ -0,0 +1,162 @@ + [ + 'google.cloud.compute.v1.CrossSiteNetworks' => [ + 'Delete' => [ + 'longRunning' => [ + 'additionalArgumentMethods' => [ + 'getProject', + ], + 'getOperationMethod' => 'get', + 'cancelOperationMethod' => null, + 'deleteOperationMethod' => 'delete', + 'operationErrorCodeMethod' => 'getHttpErrorStatusCode', + 'operationErrorMessageMethod' => 'getHttpErrorMessage', + 'operationNameMethod' => 'getName', + 'operationStatusMethod' => 'getStatus', + 'operationStatusDoneValue' => \Google\Cloud\Compute\V1\Operation\Status::DONE, + 'getOperationRequest' => '\Google\Cloud\Compute\V1\GetGlobalOperationRequest', + 'cancelOperationRequest' => null, + 'deleteOperationRequest' => '\Google\Cloud\Compute\V1\DeleteGlobalOperationRequest', + ], + 'responseType' => 'Google\Cloud\Compute\V1\Operation', + 'callType' => \Google\ApiCore\Call::LONGRUNNING_CALL, + 'headerParams' => [ + [ + 'keyName' => 'project', + 'fieldAccessors' => [ + 'getProject', + ], + ], + [ + 'keyName' => 'cross_site_network', + 'fieldAccessors' => [ + 'getCrossSiteNetwork', + ], + ], + ], + ], + 'Insert' => [ + 'longRunning' => [ + 'additionalArgumentMethods' => [ + 'getProject', + ], + 'getOperationMethod' => 'get', + 'cancelOperationMethod' => null, + 'deleteOperationMethod' => 'delete', + 'operationErrorCodeMethod' => 'getHttpErrorStatusCode', + 'operationErrorMessageMethod' => 'getHttpErrorMessage', + 'operationNameMethod' => 'getName', + 'operationStatusMethod' => 'getStatus', + 'operationStatusDoneValue' => \Google\Cloud\Compute\V1\Operation\Status::DONE, + 'getOperationRequest' => '\Google\Cloud\Compute\V1\GetGlobalOperationRequest', + 'cancelOperationRequest' => null, + 'deleteOperationRequest' => '\Google\Cloud\Compute\V1\DeleteGlobalOperationRequest', + ], + 'responseType' => 'Google\Cloud\Compute\V1\Operation', + 'callType' => \Google\ApiCore\Call::LONGRUNNING_CALL, + 'headerParams' => [ + [ + 'keyName' => 'project', + 'fieldAccessors' => [ + 'getProject', + ], + ], + ], + ], + 'Patch' => [ + 'longRunning' => [ + 'additionalArgumentMethods' => [ + 'getProject', + ], + 'getOperationMethod' => 'get', + 'cancelOperationMethod' => null, + 'deleteOperationMethod' => 'delete', + 'operationErrorCodeMethod' => 'getHttpErrorStatusCode', + 'operationErrorMessageMethod' => 'getHttpErrorMessage', + 'operationNameMethod' => 'getName', + 'operationStatusMethod' => 'getStatus', + 'operationStatusDoneValue' => \Google\Cloud\Compute\V1\Operation\Status::DONE, + 'getOperationRequest' => '\Google\Cloud\Compute\V1\GetGlobalOperationRequest', + 'cancelOperationRequest' => null, + 'deleteOperationRequest' => '\Google\Cloud\Compute\V1\DeleteGlobalOperationRequest', + ], + 'responseType' => 'Google\Cloud\Compute\V1\Operation', + 'callType' => \Google\ApiCore\Call::LONGRUNNING_CALL, + 'headerParams' => [ + [ + 'keyName' => 'project', + 'fieldAccessors' => [ + 'getProject', + ], + ], + [ + 'keyName' => 'cross_site_network', + 'fieldAccessors' => [ + 'getCrossSiteNetwork', + ], + ], + ], + ], + 'Get' => [ + 'callType' => \Google\ApiCore\Call::UNARY_CALL, + 'responseType' => 'Google\Cloud\Compute\V1\CrossSiteNetwork', + 'headerParams' => [ + [ + 'keyName' => 'project', + 'fieldAccessors' => [ + 'getProject', + ], + ], + [ + 'keyName' => 'cross_site_network', + 'fieldAccessors' => [ + 'getCrossSiteNetwork', + ], + ], + ], + ], + 'List' => [ + 'pageStreaming' => [ + 'requestPageTokenGetMethod' => 'getPageToken', + 'requestPageTokenSetMethod' => 'setPageToken', + 'requestPageSizeGetMethod' => 'getMaxResults', + 'requestPageSizeSetMethod' => 'setMaxResults', + 'responsePageTokenGetMethod' => 'getNextPageToken', + 'resourcesGetMethod' => 'getItems', + ], + 'callType' => \Google\ApiCore\Call::PAGINATED_CALL, + 'responseType' => 'Google\Cloud\Compute\V1\CrossSiteNetworkList', + 'headerParams' => [ + [ + 'keyName' => 'project', + 'fieldAccessors' => [ + 'getProject', + ], + ], + ], + ], + ], + ], +]; diff --git a/Compute/src/V1/resources/cross_site_networks_rest_client_config.php b/Compute/src/V1/resources/cross_site_networks_rest_client_config.php new file mode 100644 index 000000000000..89b0c6ea1c6f --- /dev/null +++ b/Compute/src/V1/resources/cross_site_networks_rest_client_config.php @@ -0,0 +1,172 @@ + [ + 'google.cloud.compute.v1.CrossSiteNetworks' => [ + 'Delete' => [ + 'method' => 'delete', + 'uriTemplate' => '/compute/v1/projects/{project}/global/crossSiteNetworks/{cross_site_network}', + 'placeholders' => [ + 'cross_site_network' => [ + 'getters' => [ + 'getCrossSiteNetwork', + ], + ], + 'project' => [ + 'getters' => [ + 'getProject', + ], + ], + ], + ], + 'Get' => [ + 'method' => 'get', + 'uriTemplate' => '/compute/v1/projects/{project}/global/crossSiteNetworks/{cross_site_network}', + 'placeholders' => [ + 'cross_site_network' => [ + 'getters' => [ + 'getCrossSiteNetwork', + ], + ], + 'project' => [ + 'getters' => [ + 'getProject', + ], + ], + ], + ], + 'Insert' => [ + 'method' => 'post', + 'uriTemplate' => '/compute/v1/projects/{project}/global/crossSiteNetworks', + 'body' => 'cross_site_network_resource', + 'placeholders' => [ + 'project' => [ + 'getters' => [ + 'getProject', + ], + ], + ], + ], + 'List' => [ + 'method' => 'get', + 'uriTemplate' => '/compute/v1/projects/{project}/global/crossSiteNetworks', + 'placeholders' => [ + 'project' => [ + 'getters' => [ + 'getProject', + ], + ], + ], + ], + 'Patch' => [ + 'method' => 'patch', + 'uriTemplate' => '/compute/v1/projects/{project}/global/crossSiteNetworks/{cross_site_network}', + 'body' => 'cross_site_network_resource', + 'placeholders' => [ + 'cross_site_network' => [ + 'getters' => [ + 'getCrossSiteNetwork', + ], + ], + 'project' => [ + 'getters' => [ + 'getProject', + ], + ], + ], + ], + ], + 'google.cloud.compute.v1.GlobalOperations' => [ + 'AggregatedList' => [ + 'method' => 'get', + 'uriTemplate' => '/compute/v1/projects/{project}/aggregated/operations', + 'placeholders' => [ + 'project' => [ + 'getters' => [ + 'getProject', + ], + ], + ], + ], + 'Delete' => [ + 'method' => 'delete', + 'uriTemplate' => '/compute/v1/projects/{project}/global/operations/{operation}', + 'placeholders' => [ + 'operation' => [ + 'getters' => [ + 'getOperation', + ], + ], + 'project' => [ + 'getters' => [ + 'getProject', + ], + ], + ], + ], + 'Get' => [ + 'method' => 'get', + 'uriTemplate' => '/compute/v1/projects/{project}/global/operations/{operation}', + 'placeholders' => [ + 'operation' => [ + 'getters' => [ + 'getOperation', + ], + ], + 'project' => [ + 'getters' => [ + 'getProject', + ], + ], + ], + ], + 'List' => [ + 'method' => 'get', + 'uriTemplate' => '/compute/v1/projects/{project}/global/operations', + 'placeholders' => [ + 'project' => [ + 'getters' => [ + 'getProject', + ], + ], + ], + ], + 'Wait' => [ + 'method' => 'post', + 'uriTemplate' => '/compute/v1/projects/{project}/global/operations/{operation}/wait', + 'placeholders' => [ + 'operation' => [ + 'getters' => [ + 'getOperation', + ], + ], + 'project' => [ + 'getters' => [ + 'getProject', + ], + ], + ], + ], + ], + ], +]; diff --git a/Compute/src/V1/resources/firewalls_client_config.json b/Compute/src/V1/resources/firewalls_client_config.json index d5ab78984678..fef75a9d3bfa 100644 --- a/Compute/src/V1/resources/firewalls_client_config.json +++ b/Compute/src/V1/resources/firewalls_client_config.json @@ -64,6 +64,11 @@ "retry_codes_name": "no_retry_1_codes", "retry_params_name": "no_retry_1_params" }, + "TestIamPermissions": { + "timeout_millis": 600000, + "retry_codes_name": "no_retry_1_codes", + "retry_params_name": "no_retry_1_params" + }, "Update": { "timeout_millis": 600000, "retry_codes_name": "no_retry_1_codes", diff --git a/Compute/src/V1/resources/firewalls_descriptor_config.php b/Compute/src/V1/resources/firewalls_descriptor_config.php index 5852b3b80da5..dcaaea3aa5d5 100644 --- a/Compute/src/V1/resources/firewalls_descriptor_config.php +++ b/Compute/src/V1/resources/firewalls_descriptor_config.php @@ -191,6 +191,24 @@ ], ], ], + 'TestIamPermissions' => [ + 'callType' => \Google\ApiCore\Call::UNARY_CALL, + 'responseType' => 'Google\Cloud\Compute\V1\TestPermissionsResponse', + 'headerParams' => [ + [ + 'keyName' => 'project', + 'fieldAccessors' => [ + 'getProject', + ], + ], + [ + 'keyName' => 'resource', + 'fieldAccessors' => [ + 'getResource', + ], + ], + ], + ], ], ], ]; diff --git a/Compute/src/V1/resources/firewalls_rest_client_config.php b/Compute/src/V1/resources/firewalls_rest_client_config.php index 9d458a3611ff..868cfc54e553 100644 --- a/Compute/src/V1/resources/firewalls_rest_client_config.php +++ b/Compute/src/V1/resources/firewalls_rest_client_config.php @@ -95,6 +95,23 @@ ], ], ], + 'TestIamPermissions' => [ + 'method' => 'post', + 'uriTemplate' => '/compute/v1/projects/{project}/global/firewalls/{resource}/testIamPermissions', + 'body' => 'test_permissions_request_resource', + 'placeholders' => [ + 'project' => [ + 'getters' => [ + 'getProject', + ], + ], + 'resource' => [ + 'getters' => [ + 'getResource', + ], + ], + ], + ], 'Update' => [ 'method' => 'put', 'uriTemplate' => '/compute/v1/projects/{project}/global/firewalls/{firewall}', diff --git a/Compute/src/V1/resources/future_reservations_client_config.json b/Compute/src/V1/resources/future_reservations_client_config.json new file mode 100644 index 000000000000..eab94c6d8806 --- /dev/null +++ b/Compute/src/V1/resources/future_reservations_client_config.json @@ -0,0 +1,80 @@ +{ + "interfaces": { + "google.cloud.compute.v1.FutureReservations": { + "retry_codes": { + "no_retry_codes": [], + "retry_policy_1_codes": [ + "DEADLINE_EXCEEDED", + "UNAVAILABLE" + ], + "no_retry_1_codes": [] + }, + "retry_params": { + "no_retry_params": { + "initial_retry_delay_millis": 0, + "retry_delay_multiplier": 0.0, + "max_retry_delay_millis": 0, + "initial_rpc_timeout_millis": 0, + "rpc_timeout_multiplier": 1.0, + "max_rpc_timeout_millis": 0, + "total_timeout_millis": 0 + }, + "retry_policy_1_params": { + "initial_retry_delay_millis": 100, + "retry_delay_multiplier": 1.3, + "max_retry_delay_millis": 60000, + "initial_rpc_timeout_millis": 600000, + "rpc_timeout_multiplier": 1.0, + "max_rpc_timeout_millis": 600000, + "total_timeout_millis": 600000 + }, + "no_retry_1_params": { + "initial_retry_delay_millis": 0, + "retry_delay_multiplier": 0.0, + "max_retry_delay_millis": 0, + "initial_rpc_timeout_millis": 600000, + "rpc_timeout_multiplier": 1.0, + "max_rpc_timeout_millis": 600000, + "total_timeout_millis": 600000 + } + }, + "methods": { + "AggregatedList": { + "timeout_millis": 600000, + "retry_codes_name": "retry_policy_1_codes", + "retry_params_name": "retry_policy_1_params" + }, + "Cancel": { + "timeout_millis": 600000, + "retry_codes_name": "no_retry_1_codes", + "retry_params_name": "no_retry_1_params" + }, + "Delete": { + "timeout_millis": 600000, + "retry_codes_name": "no_retry_1_codes", + "retry_params_name": "no_retry_1_params" + }, + "Get": { + "timeout_millis": 600000, + "retry_codes_name": "retry_policy_1_codes", + "retry_params_name": "retry_policy_1_params" + }, + "Insert": { + "timeout_millis": 600000, + "retry_codes_name": "no_retry_1_codes", + "retry_params_name": "no_retry_1_params" + }, + "List": { + "timeout_millis": 600000, + "retry_codes_name": "retry_policy_1_codes", + "retry_params_name": "retry_policy_1_params" + }, + "Update": { + "timeout_millis": 600000, + "retry_codes_name": "no_retry_1_codes", + "retry_params_name": "no_retry_1_params" + } + } + } + } +} diff --git a/Compute/src/V1/resources/future_reservations_descriptor_config.php b/Compute/src/V1/resources/future_reservations_descriptor_config.php new file mode 100644 index 000000000000..2081a4cf03af --- /dev/null +++ b/Compute/src/V1/resources/future_reservations_descriptor_config.php @@ -0,0 +1,256 @@ + [ + 'google.cloud.compute.v1.FutureReservations' => [ + 'Cancel' => [ + 'longRunning' => [ + 'additionalArgumentMethods' => [ + 'getProject', + 'getZone', + ], + 'getOperationMethod' => 'get', + 'cancelOperationMethod' => null, + 'deleteOperationMethod' => 'delete', + 'operationErrorCodeMethod' => 'getHttpErrorStatusCode', + 'operationErrorMessageMethod' => 'getHttpErrorMessage', + 'operationNameMethod' => 'getName', + 'operationStatusMethod' => 'getStatus', + 'operationStatusDoneValue' => \Google\Cloud\Compute\V1\Operation\Status::DONE, + 'getOperationRequest' => '\Google\Cloud\Compute\V1\GetZoneOperationRequest', + 'cancelOperationRequest' => null, + 'deleteOperationRequest' => '\Google\Cloud\Compute\V1\DeleteZoneOperationRequest', + ], + 'responseType' => 'Google\Cloud\Compute\V1\Operation', + 'callType' => \Google\ApiCore\Call::LONGRUNNING_CALL, + 'headerParams' => [ + [ + 'keyName' => 'project', + 'fieldAccessors' => [ + 'getProject', + ], + ], + [ + 'keyName' => 'zone', + 'fieldAccessors' => [ + 'getZone', + ], + ], + [ + 'keyName' => 'future_reservation', + 'fieldAccessors' => [ + 'getFutureReservation', + ], + ], + ], + ], + 'Delete' => [ + 'longRunning' => [ + 'additionalArgumentMethods' => [ + 'getProject', + 'getZone', + ], + 'getOperationMethod' => 'get', + 'cancelOperationMethod' => null, + 'deleteOperationMethod' => 'delete', + 'operationErrorCodeMethod' => 'getHttpErrorStatusCode', + 'operationErrorMessageMethod' => 'getHttpErrorMessage', + 'operationNameMethod' => 'getName', + 'operationStatusMethod' => 'getStatus', + 'operationStatusDoneValue' => \Google\Cloud\Compute\V1\Operation\Status::DONE, + 'getOperationRequest' => '\Google\Cloud\Compute\V1\GetZoneOperationRequest', + 'cancelOperationRequest' => null, + 'deleteOperationRequest' => '\Google\Cloud\Compute\V1\DeleteZoneOperationRequest', + ], + 'responseType' => 'Google\Cloud\Compute\V1\Operation', + 'callType' => \Google\ApiCore\Call::LONGRUNNING_CALL, + 'headerParams' => [ + [ + 'keyName' => 'project', + 'fieldAccessors' => [ + 'getProject', + ], + ], + [ + 'keyName' => 'zone', + 'fieldAccessors' => [ + 'getZone', + ], + ], + [ + 'keyName' => 'future_reservation', + 'fieldAccessors' => [ + 'getFutureReservation', + ], + ], + ], + ], + 'Insert' => [ + 'longRunning' => [ + 'additionalArgumentMethods' => [ + 'getProject', + 'getZone', + ], + 'getOperationMethod' => 'get', + 'cancelOperationMethod' => null, + 'deleteOperationMethod' => 'delete', + 'operationErrorCodeMethod' => 'getHttpErrorStatusCode', + 'operationErrorMessageMethod' => 'getHttpErrorMessage', + 'operationNameMethod' => 'getName', + 'operationStatusMethod' => 'getStatus', + 'operationStatusDoneValue' => \Google\Cloud\Compute\V1\Operation\Status::DONE, + 'getOperationRequest' => '\Google\Cloud\Compute\V1\GetZoneOperationRequest', + 'cancelOperationRequest' => null, + 'deleteOperationRequest' => '\Google\Cloud\Compute\V1\DeleteZoneOperationRequest', + ], + 'responseType' => 'Google\Cloud\Compute\V1\Operation', + 'callType' => \Google\ApiCore\Call::LONGRUNNING_CALL, + 'headerParams' => [ + [ + 'keyName' => 'project', + 'fieldAccessors' => [ + 'getProject', + ], + ], + [ + 'keyName' => 'zone', + 'fieldAccessors' => [ + 'getZone', + ], + ], + ], + ], + 'Update' => [ + 'longRunning' => [ + 'additionalArgumentMethods' => [ + 'getProject', + 'getZone', + ], + 'getOperationMethod' => 'get', + 'cancelOperationMethod' => null, + 'deleteOperationMethod' => 'delete', + 'operationErrorCodeMethod' => 'getHttpErrorStatusCode', + 'operationErrorMessageMethod' => 'getHttpErrorMessage', + 'operationNameMethod' => 'getName', + 'operationStatusMethod' => 'getStatus', + 'operationStatusDoneValue' => \Google\Cloud\Compute\V1\Operation\Status::DONE, + 'getOperationRequest' => '\Google\Cloud\Compute\V1\GetZoneOperationRequest', + 'cancelOperationRequest' => null, + 'deleteOperationRequest' => '\Google\Cloud\Compute\V1\DeleteZoneOperationRequest', + ], + 'responseType' => 'Google\Cloud\Compute\V1\Operation', + 'callType' => \Google\ApiCore\Call::LONGRUNNING_CALL, + 'headerParams' => [ + [ + 'keyName' => 'project', + 'fieldAccessors' => [ + 'getProject', + ], + ], + [ + 'keyName' => 'zone', + 'fieldAccessors' => [ + 'getZone', + ], + ], + [ + 'keyName' => 'future_reservation', + 'fieldAccessors' => [ + 'getFutureReservation', + ], + ], + ], + ], + 'AggregatedList' => [ + 'pageStreaming' => [ + 'requestPageTokenGetMethod' => 'getPageToken', + 'requestPageTokenSetMethod' => 'setPageToken', + 'requestPageSizeGetMethod' => 'getMaxResults', + 'requestPageSizeSetMethod' => 'setMaxResults', + 'responsePageTokenGetMethod' => 'getNextPageToken', + 'resourcesGetMethod' => 'getItems', + ], + 'callType' => \Google\ApiCore\Call::PAGINATED_CALL, + 'responseType' => 'Google\Cloud\Compute\V1\FutureReservationsAggregatedListResponse', + 'headerParams' => [ + [ + 'keyName' => 'project', + 'fieldAccessors' => [ + 'getProject', + ], + ], + ], + ], + 'Get' => [ + 'callType' => \Google\ApiCore\Call::UNARY_CALL, + 'responseType' => 'Google\Cloud\Compute\V1\FutureReservation', + 'headerParams' => [ + [ + 'keyName' => 'project', + 'fieldAccessors' => [ + 'getProject', + ], + ], + [ + 'keyName' => 'zone', + 'fieldAccessors' => [ + 'getZone', + ], + ], + [ + 'keyName' => 'future_reservation', + 'fieldAccessors' => [ + 'getFutureReservation', + ], + ], + ], + ], + 'List' => [ + 'pageStreaming' => [ + 'requestPageTokenGetMethod' => 'getPageToken', + 'requestPageTokenSetMethod' => 'setPageToken', + 'requestPageSizeGetMethod' => 'getMaxResults', + 'requestPageSizeSetMethod' => 'setMaxResults', + 'responsePageTokenGetMethod' => 'getNextPageToken', + 'resourcesGetMethod' => 'getItems', + ], + 'callType' => \Google\ApiCore\Call::PAGINATED_CALL, + 'responseType' => 'Google\Cloud\Compute\V1\FutureReservationsListResponse', + 'headerParams' => [ + [ + 'keyName' => 'project', + 'fieldAccessors' => [ + 'getProject', + ], + ], + [ + 'keyName' => 'zone', + 'fieldAccessors' => [ + 'getZone', + ], + ], + ], + ], + ], + ], +]; diff --git a/Compute/src/V1/resources/future_reservations_rest_client_config.php b/Compute/src/V1/resources/future_reservations_rest_client_config.php new file mode 100644 index 000000000000..ffa29d70950b --- /dev/null +++ b/Compute/src/V1/resources/future_reservations_rest_client_config.php @@ -0,0 +1,238 @@ + [ + 'google.cloud.compute.v1.FutureReservations' => [ + 'AggregatedList' => [ + 'method' => 'get', + 'uriTemplate' => '/compute/v1/projects/{project}/aggregated/futureReservations', + 'placeholders' => [ + 'project' => [ + 'getters' => [ + 'getProject', + ], + ], + ], + ], + 'Cancel' => [ + 'method' => 'post', + 'uriTemplate' => '/compute/v1/projects/{project}/zones/{zone}/futureReservations/{future_reservation}/cancel', + 'placeholders' => [ + 'future_reservation' => [ + 'getters' => [ + 'getFutureReservation', + ], + ], + 'project' => [ + 'getters' => [ + 'getProject', + ], + ], + 'zone' => [ + 'getters' => [ + 'getZone', + ], + ], + ], + ], + 'Delete' => [ + 'method' => 'delete', + 'uriTemplate' => '/compute/v1/projects/{project}/zones/{zone}/futureReservations/{future_reservation}', + 'placeholders' => [ + 'future_reservation' => [ + 'getters' => [ + 'getFutureReservation', + ], + ], + 'project' => [ + 'getters' => [ + 'getProject', + ], + ], + 'zone' => [ + 'getters' => [ + 'getZone', + ], + ], + ], + ], + 'Get' => [ + 'method' => 'get', + 'uriTemplate' => '/compute/v1/projects/{project}/zones/{zone}/futureReservations/{future_reservation}', + 'placeholders' => [ + 'future_reservation' => [ + 'getters' => [ + 'getFutureReservation', + ], + ], + 'project' => [ + 'getters' => [ + 'getProject', + ], + ], + 'zone' => [ + 'getters' => [ + 'getZone', + ], + ], + ], + ], + 'Insert' => [ + 'method' => 'post', + 'uriTemplate' => '/compute/v1/projects/{project}/zones/{zone}/futureReservations', + 'body' => 'future_reservation_resource', + 'placeholders' => [ + 'project' => [ + 'getters' => [ + 'getProject', + ], + ], + 'zone' => [ + 'getters' => [ + 'getZone', + ], + ], + ], + ], + 'List' => [ + 'method' => 'get', + 'uriTemplate' => '/compute/v1/projects/{project}/zones/{zone}/futureReservations', + 'placeholders' => [ + 'project' => [ + 'getters' => [ + 'getProject', + ], + ], + 'zone' => [ + 'getters' => [ + 'getZone', + ], + ], + ], + ], + 'Update' => [ + 'method' => 'patch', + 'uriTemplate' => '/compute/v1/projects/{project}/zones/{zone}/futureReservations/{future_reservation}', + 'body' => 'future_reservation_resource', + 'placeholders' => [ + 'future_reservation' => [ + 'getters' => [ + 'getFutureReservation', + ], + ], + 'project' => [ + 'getters' => [ + 'getProject', + ], + ], + 'zone' => [ + 'getters' => [ + 'getZone', + ], + ], + ], + ], + ], + 'google.cloud.compute.v1.ZoneOperations' => [ + 'Delete' => [ + 'method' => 'delete', + 'uriTemplate' => '/compute/v1/projects/{project}/zones/{zone}/operations/{operation}', + 'placeholders' => [ + 'operation' => [ + 'getters' => [ + 'getOperation', + ], + ], + 'project' => [ + 'getters' => [ + 'getProject', + ], + ], + 'zone' => [ + 'getters' => [ + 'getZone', + ], + ], + ], + ], + 'Get' => [ + 'method' => 'get', + 'uriTemplate' => '/compute/v1/projects/{project}/zones/{zone}/operations/{operation}', + 'placeholders' => [ + 'operation' => [ + 'getters' => [ + 'getOperation', + ], + ], + 'project' => [ + 'getters' => [ + 'getProject', + ], + ], + 'zone' => [ + 'getters' => [ + 'getZone', + ], + ], + ], + ], + 'List' => [ + 'method' => 'get', + 'uriTemplate' => '/compute/v1/projects/{project}/zones/{zone}/operations', + 'placeholders' => [ + 'project' => [ + 'getters' => [ + 'getProject', + ], + ], + 'zone' => [ + 'getters' => [ + 'getZone', + ], + ], + ], + ], + 'Wait' => [ + 'method' => 'post', + 'uriTemplate' => '/compute/v1/projects/{project}/zones/{zone}/operations/{operation}/wait', + 'placeholders' => [ + 'operation' => [ + 'getters' => [ + 'getOperation', + ], + ], + 'project' => [ + 'getters' => [ + 'getProject', + ], + ], + 'zone' => [ + 'getters' => [ + 'getZone', + ], + ], + ], + ], + ], + ], +]; diff --git a/Compute/src/V1/resources/reservation_blocks_client_config.json b/Compute/src/V1/resources/reservation_blocks_client_config.json index 27b103c17a11..77b7674ef224 100644 --- a/Compute/src/V1/resources/reservation_blocks_client_config.json +++ b/Compute/src/V1/resources/reservation_blocks_client_config.json @@ -44,6 +44,11 @@ "retry_codes_name": "retry_policy_1_codes", "retry_params_name": "retry_policy_1_params" }, + "GetIamPolicy": { + "timeout_millis": 600000, + "retry_codes_name": "retry_policy_1_codes", + "retry_params_name": "retry_policy_1_params" + }, "List": { "timeout_millis": 600000, "retry_codes_name": "retry_policy_1_codes", @@ -53,6 +58,16 @@ "timeout_millis": 600000, "retry_codes_name": "no_retry_1_codes", "retry_params_name": "no_retry_1_params" + }, + "SetIamPolicy": { + "timeout_millis": 600000, + "retry_codes_name": "no_retry_1_codes", + "retry_params_name": "no_retry_1_params" + }, + "TestIamPermissions": { + "timeout_millis": 600000, + "retry_codes_name": "no_retry_1_codes", + "retry_params_name": "no_retry_1_params" } } } diff --git a/Compute/src/V1/resources/reservation_blocks_descriptor_config.php b/Compute/src/V1/resources/reservation_blocks_descriptor_config.php index b8dfca7c428a..982b36ec7d89 100644 --- a/Compute/src/V1/resources/reservation_blocks_descriptor_config.php +++ b/Compute/src/V1/resources/reservation_blocks_descriptor_config.php @@ -100,6 +100,36 @@ ], ], ], + 'GetIamPolicy' => [ + 'callType' => \Google\ApiCore\Call::UNARY_CALL, + 'responseType' => 'Google\Cloud\Compute\V1\Policy', + 'headerParams' => [ + [ + 'keyName' => 'project', + 'fieldAccessors' => [ + 'getProject', + ], + ], + [ + 'keyName' => 'zone', + 'fieldAccessors' => [ + 'getZone', + ], + ], + [ + 'keyName' => 'parent_resource', + 'fieldAccessors' => [ + 'getParentResource', + ], + ], + [ + 'keyName' => 'resource', + 'fieldAccessors' => [ + 'getResource', + ], + ], + ], + ], 'List' => [ 'pageStreaming' => [ 'requestPageTokenGetMethod' => 'getPageToken', @@ -132,6 +162,66 @@ ], ], ], + 'SetIamPolicy' => [ + 'callType' => \Google\ApiCore\Call::UNARY_CALL, + 'responseType' => 'Google\Cloud\Compute\V1\Policy', + 'headerParams' => [ + [ + 'keyName' => 'project', + 'fieldAccessors' => [ + 'getProject', + ], + ], + [ + 'keyName' => 'zone', + 'fieldAccessors' => [ + 'getZone', + ], + ], + [ + 'keyName' => 'parent_resource', + 'fieldAccessors' => [ + 'getParentResource', + ], + ], + [ + 'keyName' => 'resource', + 'fieldAccessors' => [ + 'getResource', + ], + ], + ], + ], + 'TestIamPermissions' => [ + 'callType' => \Google\ApiCore\Call::UNARY_CALL, + 'responseType' => 'Google\Cloud\Compute\V1\TestPermissionsResponse', + 'headerParams' => [ + [ + 'keyName' => 'project', + 'fieldAccessors' => [ + 'getProject', + ], + ], + [ + 'keyName' => 'zone', + 'fieldAccessors' => [ + 'getZone', + ], + ], + [ + 'keyName' => 'parent_resource', + 'fieldAccessors' => [ + 'getParentResource', + ], + ], + [ + 'keyName' => 'resource', + 'fieldAccessors' => [ + 'getResource', + ], + ], + ], + ], ], ], ]; diff --git a/Compute/src/V1/resources/reservation_blocks_rest_client_config.php b/Compute/src/V1/resources/reservation_blocks_rest_client_config.php index ae031d7ca164..a8fec54c8d82 100644 --- a/Compute/src/V1/resources/reservation_blocks_rest_client_config.php +++ b/Compute/src/V1/resources/reservation_blocks_rest_client_config.php @@ -49,6 +49,32 @@ ], ], ], + 'GetIamPolicy' => [ + 'method' => 'get', + 'uriTemplate' => '/compute/v1/projects/{project}/zones/{zone}/reservations/{parent_resource}/reservationBlocks/{resource}/getIamPolicy', + 'placeholders' => [ + 'parent_resource' => [ + 'getters' => [ + 'getParentResource', + ], + ], + 'project' => [ + 'getters' => [ + 'getProject', + ], + ], + 'resource' => [ + 'getters' => [ + 'getResource', + ], + ], + 'zone' => [ + 'getters' => [ + 'getZone', + ], + ], + ], + ], 'List' => [ 'method' => 'get', 'uriTemplate' => '/compute/v1/projects/{project}/zones/{zone}/reservations/{reservation}/reservationBlocks', @@ -97,6 +123,60 @@ ], ], ], + 'SetIamPolicy' => [ + 'method' => 'post', + 'uriTemplate' => '/compute/v1/projects/{project}/zones/{zone}/reservations/{parent_resource}/reservationBlocks/{resource}/setIamPolicy', + 'body' => 'zone_set_nested_policy_request_resource', + 'placeholders' => [ + 'parent_resource' => [ + 'getters' => [ + 'getParentResource', + ], + ], + 'project' => [ + 'getters' => [ + 'getProject', + ], + ], + 'resource' => [ + 'getters' => [ + 'getResource', + ], + ], + 'zone' => [ + 'getters' => [ + 'getZone', + ], + ], + ], + ], + 'TestIamPermissions' => [ + 'method' => 'post', + 'uriTemplate' => '/compute/v1/projects/{project}/zones/{zone}/reservations/{parent_resource}/reservationBlocks/{resource}/testIamPermissions', + 'body' => 'test_permissions_request_resource', + 'placeholders' => [ + 'parent_resource' => [ + 'getters' => [ + 'getParentResource', + ], + ], + 'project' => [ + 'getters' => [ + 'getProject', + ], + ], + 'resource' => [ + 'getters' => [ + 'getResource', + ], + ], + 'zone' => [ + 'getters' => [ + 'getZone', + ], + ], + ], + ], ], 'google.cloud.compute.v1.ZoneOperations' => [ 'Delete' => [ diff --git a/Compute/src/V1/resources/reservation_sub_blocks_client_config.json b/Compute/src/V1/resources/reservation_sub_blocks_client_config.json index 34224ca98ff9..b4cf2ee5e636 100644 --- a/Compute/src/V1/resources/reservation_sub_blocks_client_config.json +++ b/Compute/src/V1/resources/reservation_sub_blocks_client_config.json @@ -44,6 +44,11 @@ "retry_codes_name": "retry_policy_1_codes", "retry_params_name": "retry_policy_1_params" }, + "GetIamPolicy": { + "timeout_millis": 600000, + "retry_codes_name": "retry_policy_1_codes", + "retry_params_name": "retry_policy_1_params" + }, "List": { "timeout_millis": 600000, "retry_codes_name": "retry_policy_1_codes", @@ -58,6 +63,16 @@ "timeout_millis": 600000, "retry_codes_name": "no_retry_1_codes", "retry_params_name": "no_retry_1_params" + }, + "SetIamPolicy": { + "timeout_millis": 600000, + "retry_codes_name": "no_retry_1_codes", + "retry_params_name": "no_retry_1_params" + }, + "TestIamPermissions": { + "timeout_millis": 600000, + "retry_codes_name": "no_retry_1_codes", + "retry_params_name": "no_retry_1_params" } } } diff --git a/Compute/src/V1/resources/reservation_sub_blocks_descriptor_config.php b/Compute/src/V1/resources/reservation_sub_blocks_descriptor_config.php index 50b500b943f9..cb1945e3d2e2 100644 --- a/Compute/src/V1/resources/reservation_sub_blocks_descriptor_config.php +++ b/Compute/src/V1/resources/reservation_sub_blocks_descriptor_config.php @@ -147,6 +147,36 @@ ], ], ], + 'GetIamPolicy' => [ + 'callType' => \Google\ApiCore\Call::UNARY_CALL, + 'responseType' => 'Google\Cloud\Compute\V1\Policy', + 'headerParams' => [ + [ + 'keyName' => 'project', + 'fieldAccessors' => [ + 'getProject', + ], + ], + [ + 'keyName' => 'zone', + 'fieldAccessors' => [ + 'getZone', + ], + ], + [ + 'keyName' => 'parent_resource', + 'fieldAccessors' => [ + 'getParentResource', + ], + ], + [ + 'keyName' => 'resource', + 'fieldAccessors' => [ + 'getResource', + ], + ], + ], + ], 'List' => [ 'pageStreaming' => [ 'requestPageTokenGetMethod' => 'getPageToken', @@ -179,6 +209,66 @@ ], ], ], + 'SetIamPolicy' => [ + 'callType' => \Google\ApiCore\Call::UNARY_CALL, + 'responseType' => 'Google\Cloud\Compute\V1\Policy', + 'headerParams' => [ + [ + 'keyName' => 'project', + 'fieldAccessors' => [ + 'getProject', + ], + ], + [ + 'keyName' => 'zone', + 'fieldAccessors' => [ + 'getZone', + ], + ], + [ + 'keyName' => 'parent_resource', + 'fieldAccessors' => [ + 'getParentResource', + ], + ], + [ + 'keyName' => 'resource', + 'fieldAccessors' => [ + 'getResource', + ], + ], + ], + ], + 'TestIamPermissions' => [ + 'callType' => \Google\ApiCore\Call::UNARY_CALL, + 'responseType' => 'Google\Cloud\Compute\V1\TestPermissionsResponse', + 'headerParams' => [ + [ + 'keyName' => 'project', + 'fieldAccessors' => [ + 'getProject', + ], + ], + [ + 'keyName' => 'zone', + 'fieldAccessors' => [ + 'getZone', + ], + ], + [ + 'keyName' => 'parent_resource', + 'fieldAccessors' => [ + 'getParentResource', + ], + ], + [ + 'keyName' => 'resource', + 'fieldAccessors' => [ + 'getResource', + ], + ], + ], + ], ], ], ]; diff --git a/Compute/src/V1/resources/reservation_sub_blocks_rest_client_config.php b/Compute/src/V1/resources/reservation_sub_blocks_rest_client_config.php index c38e1ea5bf5f..8406f410b3c0 100644 --- a/Compute/src/V1/resources/reservation_sub_blocks_rest_client_config.php +++ b/Compute/src/V1/resources/reservation_sub_blocks_rest_client_config.php @@ -49,6 +49,32 @@ ], ], ], + 'GetIamPolicy' => [ + 'method' => 'get', + 'uriTemplate' => '/compute/v1/projects/{project}/zones/{zone}/{parent_resource}/reservationSubBlocks/{resource}/getIamPolicy', + 'placeholders' => [ + 'parent_resource' => [ + 'getters' => [ + 'getParentResource', + ], + ], + 'project' => [ + 'getters' => [ + 'getProject', + ], + ], + 'resource' => [ + 'getters' => [ + 'getResource', + ], + ], + 'zone' => [ + 'getters' => [ + 'getZone', + ], + ], + ], + ], 'List' => [ 'method' => 'get', 'uriTemplate' => '/compute/v1/projects/{project}/zones/{zone}/{parent_name}/reservationSubBlocks', @@ -123,6 +149,60 @@ ], ], ], + 'SetIamPolicy' => [ + 'method' => 'post', + 'uriTemplate' => '/compute/v1/projects/{project}/zones/{zone}/{parent_resource}/reservationSubBlocks/{resource}/setIamPolicy', + 'body' => 'zone_set_nested_policy_request_resource', + 'placeholders' => [ + 'parent_resource' => [ + 'getters' => [ + 'getParentResource', + ], + ], + 'project' => [ + 'getters' => [ + 'getProject', + ], + ], + 'resource' => [ + 'getters' => [ + 'getResource', + ], + ], + 'zone' => [ + 'getters' => [ + 'getZone', + ], + ], + ], + ], + 'TestIamPermissions' => [ + 'method' => 'post', + 'uriTemplate' => '/compute/v1/projects/{project}/zones/{zone}/{parent_resource}/reservationSubBlocks/{resource}/testIamPermissions', + 'body' => 'test_permissions_request_resource', + 'placeholders' => [ + 'parent_resource' => [ + 'getters' => [ + 'getParentResource', + ], + ], + 'project' => [ + 'getters' => [ + 'getProject', + ], + ], + 'resource' => [ + 'getters' => [ + 'getResource', + ], + ], + 'zone' => [ + 'getters' => [ + 'getZone', + ], + ], + ], + ], ], 'google.cloud.compute.v1.ZoneOperations' => [ 'Delete' => [ diff --git a/Compute/src/V1/resources/wire_groups_client_config.json b/Compute/src/V1/resources/wire_groups_client_config.json new file mode 100644 index 000000000000..270773c55a72 --- /dev/null +++ b/Compute/src/V1/resources/wire_groups_client_config.json @@ -0,0 +1,70 @@ +{ + "interfaces": { + "google.cloud.compute.v1.WireGroups": { + "retry_codes": { + "no_retry_codes": [], + "retry_policy_1_codes": [ + "DEADLINE_EXCEEDED", + "UNAVAILABLE" + ], + "no_retry_1_codes": [] + }, + "retry_params": { + "no_retry_params": { + "initial_retry_delay_millis": 0, + "retry_delay_multiplier": 0.0, + "max_retry_delay_millis": 0, + "initial_rpc_timeout_millis": 0, + "rpc_timeout_multiplier": 1.0, + "max_rpc_timeout_millis": 0, + "total_timeout_millis": 0 + }, + "retry_policy_1_params": { + "initial_retry_delay_millis": 100, + "retry_delay_multiplier": 1.3, + "max_retry_delay_millis": 60000, + "initial_rpc_timeout_millis": 600000, + "rpc_timeout_multiplier": 1.0, + "max_rpc_timeout_millis": 600000, + "total_timeout_millis": 600000 + }, + "no_retry_1_params": { + "initial_retry_delay_millis": 0, + "retry_delay_multiplier": 0.0, + "max_retry_delay_millis": 0, + "initial_rpc_timeout_millis": 600000, + "rpc_timeout_multiplier": 1.0, + "max_rpc_timeout_millis": 600000, + "total_timeout_millis": 600000 + } + }, + "methods": { + "Delete": { + "timeout_millis": 600000, + "retry_codes_name": "no_retry_1_codes", + "retry_params_name": "no_retry_1_params" + }, + "Get": { + "timeout_millis": 600000, + "retry_codes_name": "retry_policy_1_codes", + "retry_params_name": "retry_policy_1_params" + }, + "Insert": { + "timeout_millis": 600000, + "retry_codes_name": "no_retry_1_codes", + "retry_params_name": "no_retry_1_params" + }, + "List": { + "timeout_millis": 600000, + "retry_codes_name": "retry_policy_1_codes", + "retry_params_name": "retry_policy_1_params" + }, + "Patch": { + "timeout_millis": 600000, + "retry_codes_name": "no_retry_1_codes", + "retry_params_name": "no_retry_1_params" + } + } + } + } +} diff --git a/Compute/src/V1/resources/wire_groups_descriptor_config.php b/Compute/src/V1/resources/wire_groups_descriptor_config.php new file mode 100644 index 000000000000..3e718323f5b6 --- /dev/null +++ b/Compute/src/V1/resources/wire_groups_descriptor_config.php @@ -0,0 +1,192 @@ + [ + 'google.cloud.compute.v1.WireGroups' => [ + 'Delete' => [ + 'longRunning' => [ + 'additionalArgumentMethods' => [ + 'getProject', + ], + 'getOperationMethod' => 'get', + 'cancelOperationMethod' => null, + 'deleteOperationMethod' => 'delete', + 'operationErrorCodeMethod' => 'getHttpErrorStatusCode', + 'operationErrorMessageMethod' => 'getHttpErrorMessage', + 'operationNameMethod' => 'getName', + 'operationStatusMethod' => 'getStatus', + 'operationStatusDoneValue' => \Google\Cloud\Compute\V1\Operation\Status::DONE, + 'getOperationRequest' => '\Google\Cloud\Compute\V1\GetGlobalOperationRequest', + 'cancelOperationRequest' => null, + 'deleteOperationRequest' => '\Google\Cloud\Compute\V1\DeleteGlobalOperationRequest', + ], + 'responseType' => 'Google\Cloud\Compute\V1\Operation', + 'callType' => \Google\ApiCore\Call::LONGRUNNING_CALL, + 'headerParams' => [ + [ + 'keyName' => 'project', + 'fieldAccessors' => [ + 'getProject', + ], + ], + [ + 'keyName' => 'cross_site_network', + 'fieldAccessors' => [ + 'getCrossSiteNetwork', + ], + ], + [ + 'keyName' => 'wire_group', + 'fieldAccessors' => [ + 'getWireGroup', + ], + ], + ], + ], + 'Insert' => [ + 'longRunning' => [ + 'additionalArgumentMethods' => [ + 'getProject', + ], + 'getOperationMethod' => 'get', + 'cancelOperationMethod' => null, + 'deleteOperationMethod' => 'delete', + 'operationErrorCodeMethod' => 'getHttpErrorStatusCode', + 'operationErrorMessageMethod' => 'getHttpErrorMessage', + 'operationNameMethod' => 'getName', + 'operationStatusMethod' => 'getStatus', + 'operationStatusDoneValue' => \Google\Cloud\Compute\V1\Operation\Status::DONE, + 'getOperationRequest' => '\Google\Cloud\Compute\V1\GetGlobalOperationRequest', + 'cancelOperationRequest' => null, + 'deleteOperationRequest' => '\Google\Cloud\Compute\V1\DeleteGlobalOperationRequest', + ], + 'responseType' => 'Google\Cloud\Compute\V1\Operation', + 'callType' => \Google\ApiCore\Call::LONGRUNNING_CALL, + 'headerParams' => [ + [ + 'keyName' => 'project', + 'fieldAccessors' => [ + 'getProject', + ], + ], + [ + 'keyName' => 'cross_site_network', + 'fieldAccessors' => [ + 'getCrossSiteNetwork', + ], + ], + ], + ], + 'Patch' => [ + 'longRunning' => [ + 'additionalArgumentMethods' => [ + 'getProject', + ], + 'getOperationMethod' => 'get', + 'cancelOperationMethod' => null, + 'deleteOperationMethod' => 'delete', + 'operationErrorCodeMethod' => 'getHttpErrorStatusCode', + 'operationErrorMessageMethod' => 'getHttpErrorMessage', + 'operationNameMethod' => 'getName', + 'operationStatusMethod' => 'getStatus', + 'operationStatusDoneValue' => \Google\Cloud\Compute\V1\Operation\Status::DONE, + 'getOperationRequest' => '\Google\Cloud\Compute\V1\GetGlobalOperationRequest', + 'cancelOperationRequest' => null, + 'deleteOperationRequest' => '\Google\Cloud\Compute\V1\DeleteGlobalOperationRequest', + ], + 'responseType' => 'Google\Cloud\Compute\V1\Operation', + 'callType' => \Google\ApiCore\Call::LONGRUNNING_CALL, + 'headerParams' => [ + [ + 'keyName' => 'project', + 'fieldAccessors' => [ + 'getProject', + ], + ], + [ + 'keyName' => 'cross_site_network', + 'fieldAccessors' => [ + 'getCrossSiteNetwork', + ], + ], + [ + 'keyName' => 'wire_group', + 'fieldAccessors' => [ + 'getWireGroup', + ], + ], + ], + ], + 'Get' => [ + 'callType' => \Google\ApiCore\Call::UNARY_CALL, + 'responseType' => 'Google\Cloud\Compute\V1\WireGroup', + 'headerParams' => [ + [ + 'keyName' => 'project', + 'fieldAccessors' => [ + 'getProject', + ], + ], + [ + 'keyName' => 'cross_site_network', + 'fieldAccessors' => [ + 'getCrossSiteNetwork', + ], + ], + [ + 'keyName' => 'wire_group', + 'fieldAccessors' => [ + 'getWireGroup', + ], + ], + ], + ], + 'List' => [ + 'pageStreaming' => [ + 'requestPageTokenGetMethod' => 'getPageToken', + 'requestPageTokenSetMethod' => 'setPageToken', + 'requestPageSizeGetMethod' => 'getMaxResults', + 'requestPageSizeSetMethod' => 'setMaxResults', + 'responsePageTokenGetMethod' => 'getNextPageToken', + 'resourcesGetMethod' => 'getItems', + ], + 'callType' => \Google\ApiCore\Call::PAGINATED_CALL, + 'responseType' => 'Google\Cloud\Compute\V1\WireGroupList', + 'headerParams' => [ + [ + 'keyName' => 'project', + 'fieldAccessors' => [ + 'getProject', + ], + ], + [ + 'keyName' => 'cross_site_network', + 'fieldAccessors' => [ + 'getCrossSiteNetwork', + ], + ], + ], + ], + ], + ], +]; diff --git a/Compute/src/V1/resources/wire_groups_rest_client_config.php b/Compute/src/V1/resources/wire_groups_rest_client_config.php new file mode 100644 index 000000000000..7cfea696ac24 --- /dev/null +++ b/Compute/src/V1/resources/wire_groups_rest_client_config.php @@ -0,0 +1,197 @@ + [ + 'google.cloud.compute.v1.WireGroups' => [ + 'Delete' => [ + 'method' => 'delete', + 'uriTemplate' => '/compute/v1/projects/{project}/global/crossSiteNetworks/{cross_site_network}/wireGroups/{wire_group}', + 'placeholders' => [ + 'cross_site_network' => [ + 'getters' => [ + 'getCrossSiteNetwork', + ], + ], + 'project' => [ + 'getters' => [ + 'getProject', + ], + ], + 'wire_group' => [ + 'getters' => [ + 'getWireGroup', + ], + ], + ], + ], + 'Get' => [ + 'method' => 'get', + 'uriTemplate' => '/compute/v1/projects/{project}/global/crossSiteNetworks/{cross_site_network}/wireGroups/{wire_group}', + 'placeholders' => [ + 'cross_site_network' => [ + 'getters' => [ + 'getCrossSiteNetwork', + ], + ], + 'project' => [ + 'getters' => [ + 'getProject', + ], + ], + 'wire_group' => [ + 'getters' => [ + 'getWireGroup', + ], + ], + ], + ], + 'Insert' => [ + 'method' => 'post', + 'uriTemplate' => '/compute/v1/projects/{project}/global/crossSiteNetworks/{cross_site_network}/wireGroups', + 'body' => 'wire_group_resource', + 'placeholders' => [ + 'cross_site_network' => [ + 'getters' => [ + 'getCrossSiteNetwork', + ], + ], + 'project' => [ + 'getters' => [ + 'getProject', + ], + ], + ], + ], + 'List' => [ + 'method' => 'get', + 'uriTemplate' => '/compute/v1/projects/{project}/global/crossSiteNetworks/{cross_site_network}/wireGroups', + 'placeholders' => [ + 'cross_site_network' => [ + 'getters' => [ + 'getCrossSiteNetwork', + ], + ], + 'project' => [ + 'getters' => [ + 'getProject', + ], + ], + ], + ], + 'Patch' => [ + 'method' => 'patch', + 'uriTemplate' => '/compute/v1/projects/{project}/global/crossSiteNetworks/{cross_site_network}/wireGroups/{wire_group}', + 'body' => 'wire_group_resource', + 'placeholders' => [ + 'cross_site_network' => [ + 'getters' => [ + 'getCrossSiteNetwork', + ], + ], + 'project' => [ + 'getters' => [ + 'getProject', + ], + ], + 'wire_group' => [ + 'getters' => [ + 'getWireGroup', + ], + ], + ], + ], + ], + 'google.cloud.compute.v1.GlobalOperations' => [ + 'AggregatedList' => [ + 'method' => 'get', + 'uriTemplate' => '/compute/v1/projects/{project}/aggregated/operations', + 'placeholders' => [ + 'project' => [ + 'getters' => [ + 'getProject', + ], + ], + ], + ], + 'Delete' => [ + 'method' => 'delete', + 'uriTemplate' => '/compute/v1/projects/{project}/global/operations/{operation}', + 'placeholders' => [ + 'operation' => [ + 'getters' => [ + 'getOperation', + ], + ], + 'project' => [ + 'getters' => [ + 'getProject', + ], + ], + ], + ], + 'Get' => [ + 'method' => 'get', + 'uriTemplate' => '/compute/v1/projects/{project}/global/operations/{operation}', + 'placeholders' => [ + 'operation' => [ + 'getters' => [ + 'getOperation', + ], + ], + 'project' => [ + 'getters' => [ + 'getProject', + ], + ], + ], + ], + 'List' => [ + 'method' => 'get', + 'uriTemplate' => '/compute/v1/projects/{project}/global/operations', + 'placeholders' => [ + 'project' => [ + 'getters' => [ + 'getProject', + ], + ], + ], + ], + 'Wait' => [ + 'method' => 'post', + 'uriTemplate' => '/compute/v1/projects/{project}/global/operations/{operation}/wait', + 'placeholders' => [ + 'operation' => [ + 'getters' => [ + 'getOperation', + ], + ], + 'project' => [ + 'getters' => [ + 'getProject', + ], + ], + ], + ], + ], + ], +]; diff --git a/Compute/tests/Unit/V1/Client/CrossSiteNetworksClientTest.php b/Compute/tests/Unit/V1/Client/CrossSiteNetworksClientTest.php new file mode 100644 index 000000000000..293eecbe2ab9 --- /dev/null +++ b/Compute/tests/Unit/V1/Client/CrossSiteNetworksClientTest.php @@ -0,0 +1,663 @@ +getMockBuilder(CredentialsWrapper::class) + ->disableOriginalConstructor() + ->getMock(); + } + + /** @return CrossSiteNetworksClient */ + private function createClient(array $options = []) + { + $options += [ + 'credentials' => $this->createCredentials(), + ]; + return new CrossSiteNetworksClient($options); + } + + /** @test */ + public function deleteTest() + { + $operationsTransport = $this->createTransport(); + $operationsClient = new GlobalOperationsClient([ + 'apiEndpoint' => '', + 'transport' => $operationsTransport, + 'credentials' => $this->createCredentials(), + ]); + $transport = $this->createTransport(); + $gapicClient = $this->createClient([ + 'transport' => $transport, + 'operationsClient' => $operationsClient, + ]); + $this->assertTrue($transport->isExhausted()); + $this->assertTrue($operationsTransport->isExhausted()); + // Mock response + $incompleteOperation = new Operation(); + $incompleteOperation->setName('customOperations/deleteTest'); + $incompleteOperation->setStatus(Status::RUNNING); + $transport->addResponse($incompleteOperation); + $completeOperation = new Operation(); + $completeOperation->setName('customOperations/deleteTest'); + $completeOperation->setStatus(Status::DONE); + $operationsTransport->addResponse($completeOperation); + // Mock request + $crossSiteNetwork = 'crossSiteNetwork-965549355'; + $project = 'project-309310695'; + $request = (new DeleteCrossSiteNetworkRequest())->setCrossSiteNetwork($crossSiteNetwork)->setProject($project); + $response = $gapicClient->delete($request); + $this->assertFalse($response->isDone()); + $apiRequests = $transport->popReceivedCalls(); + $this->assertSame(1, count($apiRequests)); + $operationsRequestsEmpty = $operationsTransport->popReceivedCalls(); + $this->assertSame(0, count($operationsRequestsEmpty)); + $actualApiFuncCall = $apiRequests[0]->getFuncCall(); + $actualApiRequestObject = $apiRequests[0]->getRequestObject(); + $this->assertSame('/google.cloud.compute.v1.CrossSiteNetworks/Delete', $actualApiFuncCall); + $actualValue = $actualApiRequestObject->getCrossSiteNetwork(); + $this->assertProtobufEquals($crossSiteNetwork, $actualValue); + $actualValue = $actualApiRequestObject->getProject(); + $this->assertProtobufEquals($project, $actualValue); + $expectedOperationsRequestObject = new GetGlobalOperationRequest(); + $expectedOperationsRequestObject->setOperation($completeOperation->getName()); + $expectedOperationsRequestObject->setProject($project); + $response->pollUntilComplete([ + 'initialPollDelayMillis' => 1, + ]); + $this->assertTrue($response->isDone()); + $apiRequestsEmpty = $transport->popReceivedCalls(); + $this->assertSame(0, count($apiRequestsEmpty)); + $operationsRequests = $operationsTransport->popReceivedCalls(); + $this->assertSame(1, count($operationsRequests)); + $actualOperationsFuncCall = $operationsRequests[0]->getFuncCall(); + $actualOperationsRequestObject = $operationsRequests[0]->getRequestObject(); + $this->assertSame('/google.cloud.compute.v1.GlobalOperations/Get', $actualOperationsFuncCall); + $this->assertEquals($expectedOperationsRequestObject, $actualOperationsRequestObject); + $this->assertTrue($transport->isExhausted()); + $this->assertTrue($operationsTransport->isExhausted()); + } + + /** @test */ + public function deleteExceptionTest() + { + $operationsTransport = $this->createTransport(); + $operationsClient = new GlobalOperationsClient([ + 'apiEndpoint' => '', + 'transport' => $operationsTransport, + 'credentials' => $this->createCredentials(), + ]); + $transport = $this->createTransport(); + $gapicClient = $this->createClient([ + 'transport' => $transport, + 'operationsClient' => $operationsClient, + ]); + $this->assertTrue($transport->isExhausted()); + $this->assertTrue($operationsTransport->isExhausted()); + // Mock response + $incompleteOperation = new Operation(); + $incompleteOperation->setName('customOperations/deleteExceptionTest'); + $incompleteOperation->setStatus(Status::RUNNING); + $transport->addResponse($incompleteOperation); + $status = new stdClass(); + $status->code = Code::DATA_LOSS; + $status->details = 'internal error'; + $expectedExceptionMessage = json_encode( + [ + 'message' => 'internal error', + 'code' => Code::DATA_LOSS, + 'status' => 'DATA_LOSS', + 'details' => [], + ], + JSON_PRETTY_PRINT + ); + $operationsTransport->addResponse(null, $status); + // Mock request + $crossSiteNetwork = 'crossSiteNetwork-965549355'; + $project = 'project-309310695'; + $request = (new DeleteCrossSiteNetworkRequest())->setCrossSiteNetwork($crossSiteNetwork)->setProject($project); + $response = $gapicClient->delete($request); + $this->assertFalse($response->isDone()); + $this->assertNull($response->getResult()); + try { + $response->pollUntilComplete([ + 'initialPollDelayMillis' => 1, + ]); + // If the pollUntilComplete() method call did not throw, fail the test + $this->fail('Expected an ApiException, but no exception was thrown.'); + } catch (ApiException $ex) { + $this->assertEquals($status->code, $ex->getCode()); + $this->assertEquals($expectedExceptionMessage, $ex->getMessage()); + } + // Call popReceivedCalls to ensure the stubs are exhausted + $transport->popReceivedCalls(); + $operationsTransport->popReceivedCalls(); + $this->assertTrue($transport->isExhausted()); + $this->assertTrue($operationsTransport->isExhausted()); + } + + /** @test */ + public function getTest() + { + $transport = $this->createTransport(); + $gapicClient = $this->createClient([ + 'transport' => $transport, + ]); + $this->assertTrue($transport->isExhausted()); + // Mock response + $creationTimestamp = 'creationTimestamp567396278'; + $description = 'description-1724546052'; + $id = 3355; + $kind = 'kind3292052'; + $name = 'name3373707'; + $selfLink = 'selfLink-1691268851'; + $expectedResponse = new CrossSiteNetwork(); + $expectedResponse->setCreationTimestamp($creationTimestamp); + $expectedResponse->setDescription($description); + $expectedResponse->setId($id); + $expectedResponse->setKind($kind); + $expectedResponse->setName($name); + $expectedResponse->setSelfLink($selfLink); + $transport->addResponse($expectedResponse); + // Mock request + $crossSiteNetwork = 'crossSiteNetwork-965549355'; + $project = 'project-309310695'; + $request = (new GetCrossSiteNetworkRequest())->setCrossSiteNetwork($crossSiteNetwork)->setProject($project); + $response = $gapicClient->get($request); + $this->assertEquals($expectedResponse, $response); + $actualRequests = $transport->popReceivedCalls(); + $this->assertSame(1, count($actualRequests)); + $actualFuncCall = $actualRequests[0]->getFuncCall(); + $actualRequestObject = $actualRequests[0]->getRequestObject(); + $this->assertSame('/google.cloud.compute.v1.CrossSiteNetworks/Get', $actualFuncCall); + $actualValue = $actualRequestObject->getCrossSiteNetwork(); + $this->assertProtobufEquals($crossSiteNetwork, $actualValue); + $actualValue = $actualRequestObject->getProject(); + $this->assertProtobufEquals($project, $actualValue); + $this->assertTrue($transport->isExhausted()); + } + + /** @test */ + public function getExceptionTest() + { + $transport = $this->createTransport(); + $gapicClient = $this->createClient([ + 'transport' => $transport, + ]); + $this->assertTrue($transport->isExhausted()); + $status = new stdClass(); + $status->code = Code::DATA_LOSS; + $status->details = 'internal error'; + $expectedExceptionMessage = json_encode( + [ + 'message' => 'internal error', + 'code' => Code::DATA_LOSS, + 'status' => 'DATA_LOSS', + 'details' => [], + ], + JSON_PRETTY_PRINT + ); + $transport->addResponse(null, $status); + // Mock request + $crossSiteNetwork = 'crossSiteNetwork-965549355'; + $project = 'project-309310695'; + $request = (new GetCrossSiteNetworkRequest())->setCrossSiteNetwork($crossSiteNetwork)->setProject($project); + try { + $gapicClient->get($request); + // If the $gapicClient method call did not throw, fail the test + $this->fail('Expected an ApiException, but no exception was thrown.'); + } catch (ApiException $ex) { + $this->assertEquals($status->code, $ex->getCode()); + $this->assertEquals($expectedExceptionMessage, $ex->getMessage()); + } + // Call popReceivedCalls to ensure the stub is exhausted + $transport->popReceivedCalls(); + $this->assertTrue($transport->isExhausted()); + } + + /** @test */ + public function insertTest() + { + $operationsTransport = $this->createTransport(); + $operationsClient = new GlobalOperationsClient([ + 'apiEndpoint' => '', + 'transport' => $operationsTransport, + 'credentials' => $this->createCredentials(), + ]); + $transport = $this->createTransport(); + $gapicClient = $this->createClient([ + 'transport' => $transport, + 'operationsClient' => $operationsClient, + ]); + $this->assertTrue($transport->isExhausted()); + $this->assertTrue($operationsTransport->isExhausted()); + // Mock response + $incompleteOperation = new Operation(); + $incompleteOperation->setName('customOperations/insertTest'); + $incompleteOperation->setStatus(Status::RUNNING); + $transport->addResponse($incompleteOperation); + $completeOperation = new Operation(); + $completeOperation->setName('customOperations/insertTest'); + $completeOperation->setStatus(Status::DONE); + $operationsTransport->addResponse($completeOperation); + // Mock request + $crossSiteNetworkResource = new CrossSiteNetwork(); + $project = 'project-309310695'; + $request = (new InsertCrossSiteNetworkRequest()) + ->setCrossSiteNetworkResource($crossSiteNetworkResource) + ->setProject($project); + $response = $gapicClient->insert($request); + $this->assertFalse($response->isDone()); + $apiRequests = $transport->popReceivedCalls(); + $this->assertSame(1, count($apiRequests)); + $operationsRequestsEmpty = $operationsTransport->popReceivedCalls(); + $this->assertSame(0, count($operationsRequestsEmpty)); + $actualApiFuncCall = $apiRequests[0]->getFuncCall(); + $actualApiRequestObject = $apiRequests[0]->getRequestObject(); + $this->assertSame('/google.cloud.compute.v1.CrossSiteNetworks/Insert', $actualApiFuncCall); + $actualValue = $actualApiRequestObject->getCrossSiteNetworkResource(); + $this->assertProtobufEquals($crossSiteNetworkResource, $actualValue); + $actualValue = $actualApiRequestObject->getProject(); + $this->assertProtobufEquals($project, $actualValue); + $expectedOperationsRequestObject = new GetGlobalOperationRequest(); + $expectedOperationsRequestObject->setOperation($completeOperation->getName()); + $expectedOperationsRequestObject->setProject($project); + $response->pollUntilComplete([ + 'initialPollDelayMillis' => 1, + ]); + $this->assertTrue($response->isDone()); + $apiRequestsEmpty = $transport->popReceivedCalls(); + $this->assertSame(0, count($apiRequestsEmpty)); + $operationsRequests = $operationsTransport->popReceivedCalls(); + $this->assertSame(1, count($operationsRequests)); + $actualOperationsFuncCall = $operationsRequests[0]->getFuncCall(); + $actualOperationsRequestObject = $operationsRequests[0]->getRequestObject(); + $this->assertSame('/google.cloud.compute.v1.GlobalOperations/Get', $actualOperationsFuncCall); + $this->assertEquals($expectedOperationsRequestObject, $actualOperationsRequestObject); + $this->assertTrue($transport->isExhausted()); + $this->assertTrue($operationsTransport->isExhausted()); + } + + /** @test */ + public function insertExceptionTest() + { + $operationsTransport = $this->createTransport(); + $operationsClient = new GlobalOperationsClient([ + 'apiEndpoint' => '', + 'transport' => $operationsTransport, + 'credentials' => $this->createCredentials(), + ]); + $transport = $this->createTransport(); + $gapicClient = $this->createClient([ + 'transport' => $transport, + 'operationsClient' => $operationsClient, + ]); + $this->assertTrue($transport->isExhausted()); + $this->assertTrue($operationsTransport->isExhausted()); + // Mock response + $incompleteOperation = new Operation(); + $incompleteOperation->setName('customOperations/insertExceptionTest'); + $incompleteOperation->setStatus(Status::RUNNING); + $transport->addResponse($incompleteOperation); + $status = new stdClass(); + $status->code = Code::DATA_LOSS; + $status->details = 'internal error'; + $expectedExceptionMessage = json_encode( + [ + 'message' => 'internal error', + 'code' => Code::DATA_LOSS, + 'status' => 'DATA_LOSS', + 'details' => [], + ], + JSON_PRETTY_PRINT + ); + $operationsTransport->addResponse(null, $status); + // Mock request + $crossSiteNetworkResource = new CrossSiteNetwork(); + $project = 'project-309310695'; + $request = (new InsertCrossSiteNetworkRequest()) + ->setCrossSiteNetworkResource($crossSiteNetworkResource) + ->setProject($project); + $response = $gapicClient->insert($request); + $this->assertFalse($response->isDone()); + $this->assertNull($response->getResult()); + try { + $response->pollUntilComplete([ + 'initialPollDelayMillis' => 1, + ]); + // If the pollUntilComplete() method call did not throw, fail the test + $this->fail('Expected an ApiException, but no exception was thrown.'); + } catch (ApiException $ex) { + $this->assertEquals($status->code, $ex->getCode()); + $this->assertEquals($expectedExceptionMessage, $ex->getMessage()); + } + // Call popReceivedCalls to ensure the stubs are exhausted + $transport->popReceivedCalls(); + $operationsTransport->popReceivedCalls(); + $this->assertTrue($transport->isExhausted()); + $this->assertTrue($operationsTransport->isExhausted()); + } + + /** @test */ + public function listTest() + { + $transport = $this->createTransport(); + $gapicClient = $this->createClient([ + 'transport' => $transport, + ]); + $this->assertTrue($transport->isExhausted()); + // Mock response + $etag = 'etag3123477'; + $id = 'id3355'; + $kind = 'kind3292052'; + $nextPageToken = ''; + $selfLink = 'selfLink-1691268851'; + $itemsElement = new CrossSiteNetwork(); + $items = [$itemsElement]; + $expectedResponse = new CrossSiteNetworkList(); + $expectedResponse->setEtag($etag); + $expectedResponse->setId($id); + $expectedResponse->setKind($kind); + $expectedResponse->setNextPageToken($nextPageToken); + $expectedResponse->setSelfLink($selfLink); + $expectedResponse->setItems($items); + $transport->addResponse($expectedResponse); + // Mock request + $project = 'project-309310695'; + $request = (new ListCrossSiteNetworksRequest())->setProject($project); + $response = $gapicClient->list($request); + $this->assertEquals($expectedResponse, $response->getPage()->getResponseObject()); + $resources = iterator_to_array($response->iterateAllElements()); + $this->assertSame(1, count($resources)); + $this->assertEquals($expectedResponse->getItems()[0], $resources[0]); + $actualRequests = $transport->popReceivedCalls(); + $this->assertSame(1, count($actualRequests)); + $actualFuncCall = $actualRequests[0]->getFuncCall(); + $actualRequestObject = $actualRequests[0]->getRequestObject(); + $this->assertSame('/google.cloud.compute.v1.CrossSiteNetworks/List', $actualFuncCall); + $actualValue = $actualRequestObject->getProject(); + $this->assertProtobufEquals($project, $actualValue); + $this->assertTrue($transport->isExhausted()); + } + + /** @test */ + public function listExceptionTest() + { + $transport = $this->createTransport(); + $gapicClient = $this->createClient([ + 'transport' => $transport, + ]); + $this->assertTrue($transport->isExhausted()); + $status = new stdClass(); + $status->code = Code::DATA_LOSS; + $status->details = 'internal error'; + $expectedExceptionMessage = json_encode( + [ + 'message' => 'internal error', + 'code' => Code::DATA_LOSS, + 'status' => 'DATA_LOSS', + 'details' => [], + ], + JSON_PRETTY_PRINT + ); + $transport->addResponse(null, $status); + // Mock request + $project = 'project-309310695'; + $request = (new ListCrossSiteNetworksRequest())->setProject($project); + try { + $gapicClient->list($request); + // If the $gapicClient method call did not throw, fail the test + $this->fail('Expected an ApiException, but no exception was thrown.'); + } catch (ApiException $ex) { + $this->assertEquals($status->code, $ex->getCode()); + $this->assertEquals($expectedExceptionMessage, $ex->getMessage()); + } + // Call popReceivedCalls to ensure the stub is exhausted + $transport->popReceivedCalls(); + $this->assertTrue($transport->isExhausted()); + } + + /** @test */ + public function patchTest() + { + $operationsTransport = $this->createTransport(); + $operationsClient = new GlobalOperationsClient([ + 'apiEndpoint' => '', + 'transport' => $operationsTransport, + 'credentials' => $this->createCredentials(), + ]); + $transport = $this->createTransport(); + $gapicClient = $this->createClient([ + 'transport' => $transport, + 'operationsClient' => $operationsClient, + ]); + $this->assertTrue($transport->isExhausted()); + $this->assertTrue($operationsTransport->isExhausted()); + // Mock response + $incompleteOperation = new Operation(); + $incompleteOperation->setName('customOperations/patchTest'); + $incompleteOperation->setStatus(Status::RUNNING); + $transport->addResponse($incompleteOperation); + $completeOperation = new Operation(); + $completeOperation->setName('customOperations/patchTest'); + $completeOperation->setStatus(Status::DONE); + $operationsTransport->addResponse($completeOperation); + // Mock request + $crossSiteNetwork = 'crossSiteNetwork-965549355'; + $crossSiteNetworkResource = new CrossSiteNetwork(); + $project = 'project-309310695'; + $request = (new PatchCrossSiteNetworkRequest()) + ->setCrossSiteNetwork($crossSiteNetwork) + ->setCrossSiteNetworkResource($crossSiteNetworkResource) + ->setProject($project); + $response = $gapicClient->patch($request); + $this->assertFalse($response->isDone()); + $apiRequests = $transport->popReceivedCalls(); + $this->assertSame(1, count($apiRequests)); + $operationsRequestsEmpty = $operationsTransport->popReceivedCalls(); + $this->assertSame(0, count($operationsRequestsEmpty)); + $actualApiFuncCall = $apiRequests[0]->getFuncCall(); + $actualApiRequestObject = $apiRequests[0]->getRequestObject(); + $this->assertSame('/google.cloud.compute.v1.CrossSiteNetworks/Patch', $actualApiFuncCall); + $actualValue = $actualApiRequestObject->getCrossSiteNetwork(); + $this->assertProtobufEquals($crossSiteNetwork, $actualValue); + $actualValue = $actualApiRequestObject->getCrossSiteNetworkResource(); + $this->assertProtobufEquals($crossSiteNetworkResource, $actualValue); + $actualValue = $actualApiRequestObject->getProject(); + $this->assertProtobufEquals($project, $actualValue); + $expectedOperationsRequestObject = new GetGlobalOperationRequest(); + $expectedOperationsRequestObject->setOperation($completeOperation->getName()); + $expectedOperationsRequestObject->setProject($project); + $response->pollUntilComplete([ + 'initialPollDelayMillis' => 1, + ]); + $this->assertTrue($response->isDone()); + $apiRequestsEmpty = $transport->popReceivedCalls(); + $this->assertSame(0, count($apiRequestsEmpty)); + $operationsRequests = $operationsTransport->popReceivedCalls(); + $this->assertSame(1, count($operationsRequests)); + $actualOperationsFuncCall = $operationsRequests[0]->getFuncCall(); + $actualOperationsRequestObject = $operationsRequests[0]->getRequestObject(); + $this->assertSame('/google.cloud.compute.v1.GlobalOperations/Get', $actualOperationsFuncCall); + $this->assertEquals($expectedOperationsRequestObject, $actualOperationsRequestObject); + $this->assertTrue($transport->isExhausted()); + $this->assertTrue($operationsTransport->isExhausted()); + } + + /** @test */ + public function patchExceptionTest() + { + $operationsTransport = $this->createTransport(); + $operationsClient = new GlobalOperationsClient([ + 'apiEndpoint' => '', + 'transport' => $operationsTransport, + 'credentials' => $this->createCredentials(), + ]); + $transport = $this->createTransport(); + $gapicClient = $this->createClient([ + 'transport' => $transport, + 'operationsClient' => $operationsClient, + ]); + $this->assertTrue($transport->isExhausted()); + $this->assertTrue($operationsTransport->isExhausted()); + // Mock response + $incompleteOperation = new Operation(); + $incompleteOperation->setName('customOperations/patchExceptionTest'); + $incompleteOperation->setStatus(Status::RUNNING); + $transport->addResponse($incompleteOperation); + $status = new stdClass(); + $status->code = Code::DATA_LOSS; + $status->details = 'internal error'; + $expectedExceptionMessage = json_encode( + [ + 'message' => 'internal error', + 'code' => Code::DATA_LOSS, + 'status' => 'DATA_LOSS', + 'details' => [], + ], + JSON_PRETTY_PRINT + ); + $operationsTransport->addResponse(null, $status); + // Mock request + $crossSiteNetwork = 'crossSiteNetwork-965549355'; + $crossSiteNetworkResource = new CrossSiteNetwork(); + $project = 'project-309310695'; + $request = (new PatchCrossSiteNetworkRequest()) + ->setCrossSiteNetwork($crossSiteNetwork) + ->setCrossSiteNetworkResource($crossSiteNetworkResource) + ->setProject($project); + $response = $gapicClient->patch($request); + $this->assertFalse($response->isDone()); + $this->assertNull($response->getResult()); + try { + $response->pollUntilComplete([ + 'initialPollDelayMillis' => 1, + ]); + // If the pollUntilComplete() method call did not throw, fail the test + $this->fail('Expected an ApiException, but no exception was thrown.'); + } catch (ApiException $ex) { + $this->assertEquals($status->code, $ex->getCode()); + $this->assertEquals($expectedExceptionMessage, $ex->getMessage()); + } + // Call popReceivedCalls to ensure the stubs are exhausted + $transport->popReceivedCalls(); + $operationsTransport->popReceivedCalls(); + $this->assertTrue($transport->isExhausted()); + $this->assertTrue($operationsTransport->isExhausted()); + } + + /** @test */ + public function deleteAsyncTest() + { + $operationsTransport = $this->createTransport(); + $operationsClient = new GlobalOperationsClient([ + 'apiEndpoint' => '', + 'transport' => $operationsTransport, + 'credentials' => $this->createCredentials(), + ]); + $transport = $this->createTransport(); + $gapicClient = $this->createClient([ + 'transport' => $transport, + 'operationsClient' => $operationsClient, + ]); + $this->assertTrue($transport->isExhausted()); + $this->assertTrue($operationsTransport->isExhausted()); + // Mock response + $incompleteOperation = new Operation(); + $incompleteOperation->setName('customOperations/deleteAsyncTest'); + $incompleteOperation->setStatus(Status::RUNNING); + $transport->addResponse($incompleteOperation); + $completeOperation = new Operation(); + $completeOperation->setName('customOperations/deleteAsyncTest'); + $completeOperation->setStatus(Status::DONE); + $operationsTransport->addResponse($completeOperation); + // Mock request + $crossSiteNetwork = 'crossSiteNetwork-965549355'; + $project = 'project-309310695'; + $request = (new DeleteCrossSiteNetworkRequest())->setCrossSiteNetwork($crossSiteNetwork)->setProject($project); + $response = $gapicClient->delete($request); + $this->assertFalse($response->isDone()); + $apiRequests = $transport->popReceivedCalls(); + $this->assertSame(1, count($apiRequests)); + $operationsRequestsEmpty = $operationsTransport->popReceivedCalls(); + $this->assertSame(0, count($operationsRequestsEmpty)); + $actualApiFuncCall = $apiRequests[0]->getFuncCall(); + $actualApiRequestObject = $apiRequests[0]->getRequestObject(); + $this->assertSame('/google.cloud.compute.v1.CrossSiteNetworks/Delete', $actualApiFuncCall); + $actualValue = $actualApiRequestObject->getCrossSiteNetwork(); + $this->assertProtobufEquals($crossSiteNetwork, $actualValue); + $actualValue = $actualApiRequestObject->getProject(); + $this->assertProtobufEquals($project, $actualValue); + $expectedOperationsRequestObject = new GetGlobalOperationRequest(); + $expectedOperationsRequestObject->setOperation($completeOperation->getName()); + $expectedOperationsRequestObject->setProject($project); + $response->pollUntilComplete([ + 'initialPollDelayMillis' => 1, + ]); + $this->assertTrue($response->isDone()); + $apiRequestsEmpty = $transport->popReceivedCalls(); + $this->assertSame(0, count($apiRequestsEmpty)); + $operationsRequests = $operationsTransport->popReceivedCalls(); + $this->assertSame(1, count($operationsRequests)); + $actualOperationsFuncCall = $operationsRequests[0]->getFuncCall(); + $actualOperationsRequestObject = $operationsRequests[0]->getRequestObject(); + $this->assertSame('/google.cloud.compute.v1.GlobalOperations/Get', $actualOperationsFuncCall); + $this->assertEquals($expectedOperationsRequestObject, $actualOperationsRequestObject); + $this->assertTrue($transport->isExhausted()); + $this->assertTrue($operationsTransport->isExhausted()); + } +} diff --git a/Compute/tests/Unit/V1/Client/FirewallPoliciesClientTest.php b/Compute/tests/Unit/V1/Client/FirewallPoliciesClientTest.php index 6750a3ab8a13..e71aecaf3c17 100644 --- a/Compute/tests/Unit/V1/Client/FirewallPoliciesClientTest.php +++ b/Compute/tests/Unit/V1/Client/FirewallPoliciesClientTest.php @@ -580,6 +580,7 @@ public function getTest() $kind = 'kind3292052'; $name = 'name3373707'; $parent = 'parent-995424086'; + $policyType = 'policyType-2129325529'; $region = 'region-934795532'; $ruleTupleCount = 388342037; $selfLink = 'selfLink-1691268851'; @@ -594,6 +595,7 @@ public function getTest() $expectedResponse->setKind($kind); $expectedResponse->setName($name); $expectedResponse->setParent($parent); + $expectedResponse->setPolicyType($policyType); $expectedResponse->setRegion($region); $expectedResponse->setRuleTupleCount($ruleTupleCount); $expectedResponse->setSelfLink($selfLink); diff --git a/Compute/tests/Unit/V1/Client/FirewallsClientTest.php b/Compute/tests/Unit/V1/Client/FirewallsClientTest.php index 93cbaf191fbf..d6c9c8eecf73 100644 --- a/Compute/tests/Unit/V1/Client/FirewallsClientTest.php +++ b/Compute/tests/Unit/V1/Client/FirewallsClientTest.php @@ -38,6 +38,9 @@ use Google\Cloud\Compute\V1\Operation; use Google\Cloud\Compute\V1\Operation\Status; use Google\Cloud\Compute\V1\PatchFirewallRequest; +use Google\Cloud\Compute\V1\TestIamPermissionsFirewallRequest; +use Google\Cloud\Compute\V1\TestPermissionsRequest; +use Google\Cloud\Compute\V1\TestPermissionsResponse; use Google\Cloud\Compute\V1\UpdateFirewallRequest; use Google\Rpc\Code; use stdClass; @@ -603,6 +606,83 @@ public function patchExceptionTest() $this->assertTrue($operationsTransport->isExhausted()); } + /** @test */ + public function testIamPermissionsTest() + { + $transport = $this->createTransport(); + $gapicClient = $this->createClient([ + 'transport' => $transport, + ]); + $this->assertTrue($transport->isExhausted()); + // Mock response + $expectedResponse = new TestPermissionsResponse(); + $transport->addResponse($expectedResponse); + // Mock request + $project = 'project-309310695'; + $resource = 'resource-341064690'; + $testPermissionsRequestResource = new TestPermissionsRequest(); + $request = (new TestIamPermissionsFirewallRequest()) + ->setProject($project) + ->setResource($resource) + ->setTestPermissionsRequestResource($testPermissionsRequestResource); + $response = $gapicClient->testIamPermissions($request); + $this->assertEquals($expectedResponse, $response); + $actualRequests = $transport->popReceivedCalls(); + $this->assertSame(1, count($actualRequests)); + $actualFuncCall = $actualRequests[0]->getFuncCall(); + $actualRequestObject = $actualRequests[0]->getRequestObject(); + $this->assertSame('/google.cloud.compute.v1.Firewalls/TestIamPermissions', $actualFuncCall); + $actualValue = $actualRequestObject->getProject(); + $this->assertProtobufEquals($project, $actualValue); + $actualValue = $actualRequestObject->getResource(); + $this->assertProtobufEquals($resource, $actualValue); + $actualValue = $actualRequestObject->getTestPermissionsRequestResource(); + $this->assertProtobufEquals($testPermissionsRequestResource, $actualValue); + $this->assertTrue($transport->isExhausted()); + } + + /** @test */ + public function testIamPermissionsExceptionTest() + { + $transport = $this->createTransport(); + $gapicClient = $this->createClient([ + 'transport' => $transport, + ]); + $this->assertTrue($transport->isExhausted()); + $status = new stdClass(); + $status->code = Code::DATA_LOSS; + $status->details = 'internal error'; + $expectedExceptionMessage = json_encode( + [ + 'message' => 'internal error', + 'code' => Code::DATA_LOSS, + 'status' => 'DATA_LOSS', + 'details' => [], + ], + JSON_PRETTY_PRINT + ); + $transport->addResponse(null, $status); + // Mock request + $project = 'project-309310695'; + $resource = 'resource-341064690'; + $testPermissionsRequestResource = new TestPermissionsRequest(); + $request = (new TestIamPermissionsFirewallRequest()) + ->setProject($project) + ->setResource($resource) + ->setTestPermissionsRequestResource($testPermissionsRequestResource); + try { + $gapicClient->testIamPermissions($request); + // If the $gapicClient method call did not throw, fail the test + $this->fail('Expected an ApiException, but no exception was thrown.'); + } catch (ApiException $ex) { + $this->assertEquals($status->code, $ex->getCode()); + $this->assertEquals($expectedExceptionMessage, $ex->getMessage()); + } + // Call popReceivedCalls to ensure the stub is exhausted + $transport->popReceivedCalls(); + $this->assertTrue($transport->isExhausted()); + } + /** @test */ public function updateTest() { diff --git a/Compute/tests/Unit/V1/Client/FutureReservationsClientTest.php b/Compute/tests/Unit/V1/Client/FutureReservationsClientTest.php new file mode 100644 index 000000000000..08c9f62d5a4b --- /dev/null +++ b/Compute/tests/Unit/V1/Client/FutureReservationsClientTest.php @@ -0,0 +1,926 @@ +getMockBuilder(CredentialsWrapper::class) + ->disableOriginalConstructor() + ->getMock(); + } + + /** @return FutureReservationsClient */ + private function createClient(array $options = []) + { + $options += [ + 'credentials' => $this->createCredentials(), + ]; + return new FutureReservationsClient($options); + } + + /** @test */ + public function aggregatedListTest() + { + $transport = $this->createTransport(); + $gapicClient = $this->createClient([ + 'transport' => $transport, + ]); + $this->assertTrue($transport->isExhausted()); + // Mock response + $etag = 'etag3123477'; + $id = 'id3355'; + $kind = 'kind3292052'; + $nextPageToken = ''; + $selfLink = 'selfLink-1691268851'; + $items = [ + 'itemsKey' => new FutureReservationsScopedList(), + ]; + $expectedResponse = new FutureReservationsAggregatedListResponse(); + $expectedResponse->setEtag($etag); + $expectedResponse->setId($id); + $expectedResponse->setKind($kind); + $expectedResponse->setNextPageToken($nextPageToken); + $expectedResponse->setSelfLink($selfLink); + $expectedResponse->setItems($items); + $transport->addResponse($expectedResponse); + // Mock request + $project = 'project-309310695'; + $request = (new AggregatedListFutureReservationsRequest())->setProject($project); + $response = $gapicClient->aggregatedList($request); + $this->assertEquals($expectedResponse, $response->getPage()->getResponseObject()); + $resources = iterator_to_array($response->iterateAllElements()); + $this->assertSame(1, count($resources)); + $this->assertArrayHasKey('itemsKey', $expectedResponse->getItems()); + $this->assertArrayHasKey('itemsKey', $resources); + $this->assertEquals($expectedResponse->getItems()['itemsKey'], $resources['itemsKey']); + $actualRequests = $transport->popReceivedCalls(); + $this->assertSame(1, count($actualRequests)); + $actualFuncCall = $actualRequests[0]->getFuncCall(); + $actualRequestObject = $actualRequests[0]->getRequestObject(); + $this->assertSame('/google.cloud.compute.v1.FutureReservations/AggregatedList', $actualFuncCall); + $actualValue = $actualRequestObject->getProject(); + $this->assertProtobufEquals($project, $actualValue); + $this->assertTrue($transport->isExhausted()); + } + + /** @test */ + public function aggregatedListExceptionTest() + { + $transport = $this->createTransport(); + $gapicClient = $this->createClient([ + 'transport' => $transport, + ]); + $this->assertTrue($transport->isExhausted()); + $status = new stdClass(); + $status->code = Code::DATA_LOSS; + $status->details = 'internal error'; + $expectedExceptionMessage = json_encode( + [ + 'message' => 'internal error', + 'code' => Code::DATA_LOSS, + 'status' => 'DATA_LOSS', + 'details' => [], + ], + JSON_PRETTY_PRINT + ); + $transport->addResponse(null, $status); + // Mock request + $project = 'project-309310695'; + $request = (new AggregatedListFutureReservationsRequest())->setProject($project); + try { + $gapicClient->aggregatedList($request); + // If the $gapicClient method call did not throw, fail the test + $this->fail('Expected an ApiException, but no exception was thrown.'); + } catch (ApiException $ex) { + $this->assertEquals($status->code, $ex->getCode()); + $this->assertEquals($expectedExceptionMessage, $ex->getMessage()); + } + // Call popReceivedCalls to ensure the stub is exhausted + $transport->popReceivedCalls(); + $this->assertTrue($transport->isExhausted()); + } + + /** @test */ + public function cancelTest() + { + $operationsTransport = $this->createTransport(); + $operationsClient = new ZoneOperationsClient([ + 'apiEndpoint' => '', + 'transport' => $operationsTransport, + 'credentials' => $this->createCredentials(), + ]); + $transport = $this->createTransport(); + $gapicClient = $this->createClient([ + 'transport' => $transport, + 'operationsClient' => $operationsClient, + ]); + $this->assertTrue($transport->isExhausted()); + $this->assertTrue($operationsTransport->isExhausted()); + // Mock response + $incompleteOperation = new Operation(); + $incompleteOperation->setName('customOperations/cancelTest'); + $incompleteOperation->setStatus(Status::RUNNING); + $transport->addResponse($incompleteOperation); + $completeOperation = new Operation(); + $completeOperation->setName('customOperations/cancelTest'); + $completeOperation->setStatus(Status::DONE); + $operationsTransport->addResponse($completeOperation); + // Mock request + $futureReservation = 'futureReservation-1554406576'; + $project = 'project-309310695'; + $zone = 'zone3744684'; + $request = (new CancelFutureReservationRequest()) + ->setFutureReservation($futureReservation) + ->setProject($project) + ->setZone($zone); + $response = $gapicClient->cancel($request); + $this->assertFalse($response->isDone()); + $apiRequests = $transport->popReceivedCalls(); + $this->assertSame(1, count($apiRequests)); + $operationsRequestsEmpty = $operationsTransport->popReceivedCalls(); + $this->assertSame(0, count($operationsRequestsEmpty)); + $actualApiFuncCall = $apiRequests[0]->getFuncCall(); + $actualApiRequestObject = $apiRequests[0]->getRequestObject(); + $this->assertSame('/google.cloud.compute.v1.FutureReservations/Cancel', $actualApiFuncCall); + $actualValue = $actualApiRequestObject->getFutureReservation(); + $this->assertProtobufEquals($futureReservation, $actualValue); + $actualValue = $actualApiRequestObject->getProject(); + $this->assertProtobufEquals($project, $actualValue); + $actualValue = $actualApiRequestObject->getZone(); + $this->assertProtobufEquals($zone, $actualValue); + $expectedOperationsRequestObject = new GetZoneOperationRequest(); + $expectedOperationsRequestObject->setOperation($completeOperation->getName()); + $expectedOperationsRequestObject->setProject($project); + $expectedOperationsRequestObject->setZone($zone); + $response->pollUntilComplete([ + 'initialPollDelayMillis' => 1, + ]); + $this->assertTrue($response->isDone()); + $apiRequestsEmpty = $transport->popReceivedCalls(); + $this->assertSame(0, count($apiRequestsEmpty)); + $operationsRequests = $operationsTransport->popReceivedCalls(); + $this->assertSame(1, count($operationsRequests)); + $actualOperationsFuncCall = $operationsRequests[0]->getFuncCall(); + $actualOperationsRequestObject = $operationsRequests[0]->getRequestObject(); + $this->assertSame('/google.cloud.compute.v1.ZoneOperations/Get', $actualOperationsFuncCall); + $this->assertEquals($expectedOperationsRequestObject, $actualOperationsRequestObject); + $this->assertTrue($transport->isExhausted()); + $this->assertTrue($operationsTransport->isExhausted()); + } + + /** @test */ + public function cancelExceptionTest() + { + $operationsTransport = $this->createTransport(); + $operationsClient = new ZoneOperationsClient([ + 'apiEndpoint' => '', + 'transport' => $operationsTransport, + 'credentials' => $this->createCredentials(), + ]); + $transport = $this->createTransport(); + $gapicClient = $this->createClient([ + 'transport' => $transport, + 'operationsClient' => $operationsClient, + ]); + $this->assertTrue($transport->isExhausted()); + $this->assertTrue($operationsTransport->isExhausted()); + // Mock response + $incompleteOperation = new Operation(); + $incompleteOperation->setName('customOperations/cancelExceptionTest'); + $incompleteOperation->setStatus(Status::RUNNING); + $transport->addResponse($incompleteOperation); + $status = new stdClass(); + $status->code = Code::DATA_LOSS; + $status->details = 'internal error'; + $expectedExceptionMessage = json_encode( + [ + 'message' => 'internal error', + 'code' => Code::DATA_LOSS, + 'status' => 'DATA_LOSS', + 'details' => [], + ], + JSON_PRETTY_PRINT + ); + $operationsTransport->addResponse(null, $status); + // Mock request + $futureReservation = 'futureReservation-1554406576'; + $project = 'project-309310695'; + $zone = 'zone3744684'; + $request = (new CancelFutureReservationRequest()) + ->setFutureReservation($futureReservation) + ->setProject($project) + ->setZone($zone); + $response = $gapicClient->cancel($request); + $this->assertFalse($response->isDone()); + $this->assertNull($response->getResult()); + try { + $response->pollUntilComplete([ + 'initialPollDelayMillis' => 1, + ]); + // If the pollUntilComplete() method call did not throw, fail the test + $this->fail('Expected an ApiException, but no exception was thrown.'); + } catch (ApiException $ex) { + $this->assertEquals($status->code, $ex->getCode()); + $this->assertEquals($expectedExceptionMessage, $ex->getMessage()); + } + // Call popReceivedCalls to ensure the stubs are exhausted + $transport->popReceivedCalls(); + $operationsTransport->popReceivedCalls(); + $this->assertTrue($transport->isExhausted()); + $this->assertTrue($operationsTransport->isExhausted()); + } + + /** @test */ + public function deleteTest() + { + $operationsTransport = $this->createTransport(); + $operationsClient = new ZoneOperationsClient([ + 'apiEndpoint' => '', + 'transport' => $operationsTransport, + 'credentials' => $this->createCredentials(), + ]); + $transport = $this->createTransport(); + $gapicClient = $this->createClient([ + 'transport' => $transport, + 'operationsClient' => $operationsClient, + ]); + $this->assertTrue($transport->isExhausted()); + $this->assertTrue($operationsTransport->isExhausted()); + // Mock response + $incompleteOperation = new Operation(); + $incompleteOperation->setName('customOperations/deleteTest'); + $incompleteOperation->setStatus(Status::RUNNING); + $transport->addResponse($incompleteOperation); + $completeOperation = new Operation(); + $completeOperation->setName('customOperations/deleteTest'); + $completeOperation->setStatus(Status::DONE); + $operationsTransport->addResponse($completeOperation); + // Mock request + $futureReservation = 'futureReservation-1554406576'; + $project = 'project-309310695'; + $zone = 'zone3744684'; + $request = (new DeleteFutureReservationRequest()) + ->setFutureReservation($futureReservation) + ->setProject($project) + ->setZone($zone); + $response = $gapicClient->delete($request); + $this->assertFalse($response->isDone()); + $apiRequests = $transport->popReceivedCalls(); + $this->assertSame(1, count($apiRequests)); + $operationsRequestsEmpty = $operationsTransport->popReceivedCalls(); + $this->assertSame(0, count($operationsRequestsEmpty)); + $actualApiFuncCall = $apiRequests[0]->getFuncCall(); + $actualApiRequestObject = $apiRequests[0]->getRequestObject(); + $this->assertSame('/google.cloud.compute.v1.FutureReservations/Delete', $actualApiFuncCall); + $actualValue = $actualApiRequestObject->getFutureReservation(); + $this->assertProtobufEquals($futureReservation, $actualValue); + $actualValue = $actualApiRequestObject->getProject(); + $this->assertProtobufEquals($project, $actualValue); + $actualValue = $actualApiRequestObject->getZone(); + $this->assertProtobufEquals($zone, $actualValue); + $expectedOperationsRequestObject = new GetZoneOperationRequest(); + $expectedOperationsRequestObject->setOperation($completeOperation->getName()); + $expectedOperationsRequestObject->setProject($project); + $expectedOperationsRequestObject->setZone($zone); + $response->pollUntilComplete([ + 'initialPollDelayMillis' => 1, + ]); + $this->assertTrue($response->isDone()); + $apiRequestsEmpty = $transport->popReceivedCalls(); + $this->assertSame(0, count($apiRequestsEmpty)); + $operationsRequests = $operationsTransport->popReceivedCalls(); + $this->assertSame(1, count($operationsRequests)); + $actualOperationsFuncCall = $operationsRequests[0]->getFuncCall(); + $actualOperationsRequestObject = $operationsRequests[0]->getRequestObject(); + $this->assertSame('/google.cloud.compute.v1.ZoneOperations/Get', $actualOperationsFuncCall); + $this->assertEquals($expectedOperationsRequestObject, $actualOperationsRequestObject); + $this->assertTrue($transport->isExhausted()); + $this->assertTrue($operationsTransport->isExhausted()); + } + + /** @test */ + public function deleteExceptionTest() + { + $operationsTransport = $this->createTransport(); + $operationsClient = new ZoneOperationsClient([ + 'apiEndpoint' => '', + 'transport' => $operationsTransport, + 'credentials' => $this->createCredentials(), + ]); + $transport = $this->createTransport(); + $gapicClient = $this->createClient([ + 'transport' => $transport, + 'operationsClient' => $operationsClient, + ]); + $this->assertTrue($transport->isExhausted()); + $this->assertTrue($operationsTransport->isExhausted()); + // Mock response + $incompleteOperation = new Operation(); + $incompleteOperation->setName('customOperations/deleteExceptionTest'); + $incompleteOperation->setStatus(Status::RUNNING); + $transport->addResponse($incompleteOperation); + $status = new stdClass(); + $status->code = Code::DATA_LOSS; + $status->details = 'internal error'; + $expectedExceptionMessage = json_encode( + [ + 'message' => 'internal error', + 'code' => Code::DATA_LOSS, + 'status' => 'DATA_LOSS', + 'details' => [], + ], + JSON_PRETTY_PRINT + ); + $operationsTransport->addResponse(null, $status); + // Mock request + $futureReservation = 'futureReservation-1554406576'; + $project = 'project-309310695'; + $zone = 'zone3744684'; + $request = (new DeleteFutureReservationRequest()) + ->setFutureReservation($futureReservation) + ->setProject($project) + ->setZone($zone); + $response = $gapicClient->delete($request); + $this->assertFalse($response->isDone()); + $this->assertNull($response->getResult()); + try { + $response->pollUntilComplete([ + 'initialPollDelayMillis' => 1, + ]); + // If the pollUntilComplete() method call did not throw, fail the test + $this->fail('Expected an ApiException, but no exception was thrown.'); + } catch (ApiException $ex) { + $this->assertEquals($status->code, $ex->getCode()); + $this->assertEquals($expectedExceptionMessage, $ex->getMessage()); + } + // Call popReceivedCalls to ensure the stubs are exhausted + $transport->popReceivedCalls(); + $operationsTransport->popReceivedCalls(); + $this->assertTrue($transport->isExhausted()); + $this->assertTrue($operationsTransport->isExhausted()); + } + + /** @test */ + public function getTest() + { + $transport = $this->createTransport(); + $gapicClient = $this->createClient([ + 'transport' => $transport, + ]); + $this->assertTrue($transport->isExhausted()); + // Mock response + $autoCreatedReservationsDeleteTime = 'autoCreatedReservationsDeleteTime-294015792'; + $autoDeleteAutoCreatedReservations = true; + $creationTimestamp = 'creationTimestamp567396278'; + $deploymentType = 'deploymentType2007335028'; + $description = 'description-1724546052'; + $enableEmergentMaintenance = false; + $id = 3355; + $kind = 'kind3292052'; + $name = 'name3373707'; + $namePrefix = 'namePrefix236409542'; + $planningStatus = 'planningStatus1630327572'; + $reservationMode = 'reservationMode-1870189002'; + $reservationName = 'reservationName-1870172386'; + $schedulingType = 'schedulingType199835397'; + $selfLink = 'selfLink-1691268851'; + $selfLinkWithId = 'selfLinkWithId-1029220862'; + $specificReservationRequired = false; + $zone2 = 'zone2-696322977'; + $expectedResponse = new FutureReservation(); + $expectedResponse->setAutoCreatedReservationsDeleteTime($autoCreatedReservationsDeleteTime); + $expectedResponse->setAutoDeleteAutoCreatedReservations($autoDeleteAutoCreatedReservations); + $expectedResponse->setCreationTimestamp($creationTimestamp); + $expectedResponse->setDeploymentType($deploymentType); + $expectedResponse->setDescription($description); + $expectedResponse->setEnableEmergentMaintenance($enableEmergentMaintenance); + $expectedResponse->setId($id); + $expectedResponse->setKind($kind); + $expectedResponse->setName($name); + $expectedResponse->setNamePrefix($namePrefix); + $expectedResponse->setPlanningStatus($planningStatus); + $expectedResponse->setReservationMode($reservationMode); + $expectedResponse->setReservationName($reservationName); + $expectedResponse->setSchedulingType($schedulingType); + $expectedResponse->setSelfLink($selfLink); + $expectedResponse->setSelfLinkWithId($selfLinkWithId); + $expectedResponse->setSpecificReservationRequired($specificReservationRequired); + $expectedResponse->setZone($zone2); + $transport->addResponse($expectedResponse); + // Mock request + $futureReservation = 'futureReservation-1554406576'; + $project = 'project-309310695'; + $zone = 'zone3744684'; + $request = (new GetFutureReservationRequest()) + ->setFutureReservation($futureReservation) + ->setProject($project) + ->setZone($zone); + $response = $gapicClient->get($request); + $this->assertEquals($expectedResponse, $response); + $actualRequests = $transport->popReceivedCalls(); + $this->assertSame(1, count($actualRequests)); + $actualFuncCall = $actualRequests[0]->getFuncCall(); + $actualRequestObject = $actualRequests[0]->getRequestObject(); + $this->assertSame('/google.cloud.compute.v1.FutureReservations/Get', $actualFuncCall); + $actualValue = $actualRequestObject->getFutureReservation(); + $this->assertProtobufEquals($futureReservation, $actualValue); + $actualValue = $actualRequestObject->getProject(); + $this->assertProtobufEquals($project, $actualValue); + $actualValue = $actualRequestObject->getZone(); + $this->assertProtobufEquals($zone, $actualValue); + $this->assertTrue($transport->isExhausted()); + } + + /** @test */ + public function getExceptionTest() + { + $transport = $this->createTransport(); + $gapicClient = $this->createClient([ + 'transport' => $transport, + ]); + $this->assertTrue($transport->isExhausted()); + $status = new stdClass(); + $status->code = Code::DATA_LOSS; + $status->details = 'internal error'; + $expectedExceptionMessage = json_encode( + [ + 'message' => 'internal error', + 'code' => Code::DATA_LOSS, + 'status' => 'DATA_LOSS', + 'details' => [], + ], + JSON_PRETTY_PRINT + ); + $transport->addResponse(null, $status); + // Mock request + $futureReservation = 'futureReservation-1554406576'; + $project = 'project-309310695'; + $zone = 'zone3744684'; + $request = (new GetFutureReservationRequest()) + ->setFutureReservation($futureReservation) + ->setProject($project) + ->setZone($zone); + try { + $gapicClient->get($request); + // If the $gapicClient method call did not throw, fail the test + $this->fail('Expected an ApiException, but no exception was thrown.'); + } catch (ApiException $ex) { + $this->assertEquals($status->code, $ex->getCode()); + $this->assertEquals($expectedExceptionMessage, $ex->getMessage()); + } + // Call popReceivedCalls to ensure the stub is exhausted + $transport->popReceivedCalls(); + $this->assertTrue($transport->isExhausted()); + } + + /** @test */ + public function insertTest() + { + $operationsTransport = $this->createTransport(); + $operationsClient = new ZoneOperationsClient([ + 'apiEndpoint' => '', + 'transport' => $operationsTransport, + 'credentials' => $this->createCredentials(), + ]); + $transport = $this->createTransport(); + $gapicClient = $this->createClient([ + 'transport' => $transport, + 'operationsClient' => $operationsClient, + ]); + $this->assertTrue($transport->isExhausted()); + $this->assertTrue($operationsTransport->isExhausted()); + // Mock response + $incompleteOperation = new Operation(); + $incompleteOperation->setName('customOperations/insertTest'); + $incompleteOperation->setStatus(Status::RUNNING); + $transport->addResponse($incompleteOperation); + $completeOperation = new Operation(); + $completeOperation->setName('customOperations/insertTest'); + $completeOperation->setStatus(Status::DONE); + $operationsTransport->addResponse($completeOperation); + // Mock request + $futureReservationResource = new FutureReservation(); + $project = 'project-309310695'; + $zone = 'zone3744684'; + $request = (new InsertFutureReservationRequest()) + ->setFutureReservationResource($futureReservationResource) + ->setProject($project) + ->setZone($zone); + $response = $gapicClient->insert($request); + $this->assertFalse($response->isDone()); + $apiRequests = $transport->popReceivedCalls(); + $this->assertSame(1, count($apiRequests)); + $operationsRequestsEmpty = $operationsTransport->popReceivedCalls(); + $this->assertSame(0, count($operationsRequestsEmpty)); + $actualApiFuncCall = $apiRequests[0]->getFuncCall(); + $actualApiRequestObject = $apiRequests[0]->getRequestObject(); + $this->assertSame('/google.cloud.compute.v1.FutureReservations/Insert', $actualApiFuncCall); + $actualValue = $actualApiRequestObject->getFutureReservationResource(); + $this->assertProtobufEquals($futureReservationResource, $actualValue); + $actualValue = $actualApiRequestObject->getProject(); + $this->assertProtobufEquals($project, $actualValue); + $actualValue = $actualApiRequestObject->getZone(); + $this->assertProtobufEquals($zone, $actualValue); + $expectedOperationsRequestObject = new GetZoneOperationRequest(); + $expectedOperationsRequestObject->setOperation($completeOperation->getName()); + $expectedOperationsRequestObject->setProject($project); + $expectedOperationsRequestObject->setZone($zone); + $response->pollUntilComplete([ + 'initialPollDelayMillis' => 1, + ]); + $this->assertTrue($response->isDone()); + $apiRequestsEmpty = $transport->popReceivedCalls(); + $this->assertSame(0, count($apiRequestsEmpty)); + $operationsRequests = $operationsTransport->popReceivedCalls(); + $this->assertSame(1, count($operationsRequests)); + $actualOperationsFuncCall = $operationsRequests[0]->getFuncCall(); + $actualOperationsRequestObject = $operationsRequests[0]->getRequestObject(); + $this->assertSame('/google.cloud.compute.v1.ZoneOperations/Get', $actualOperationsFuncCall); + $this->assertEquals($expectedOperationsRequestObject, $actualOperationsRequestObject); + $this->assertTrue($transport->isExhausted()); + $this->assertTrue($operationsTransport->isExhausted()); + } + + /** @test */ + public function insertExceptionTest() + { + $operationsTransport = $this->createTransport(); + $operationsClient = new ZoneOperationsClient([ + 'apiEndpoint' => '', + 'transport' => $operationsTransport, + 'credentials' => $this->createCredentials(), + ]); + $transport = $this->createTransport(); + $gapicClient = $this->createClient([ + 'transport' => $transport, + 'operationsClient' => $operationsClient, + ]); + $this->assertTrue($transport->isExhausted()); + $this->assertTrue($operationsTransport->isExhausted()); + // Mock response + $incompleteOperation = new Operation(); + $incompleteOperation->setName('customOperations/insertExceptionTest'); + $incompleteOperation->setStatus(Status::RUNNING); + $transport->addResponse($incompleteOperation); + $status = new stdClass(); + $status->code = Code::DATA_LOSS; + $status->details = 'internal error'; + $expectedExceptionMessage = json_encode( + [ + 'message' => 'internal error', + 'code' => Code::DATA_LOSS, + 'status' => 'DATA_LOSS', + 'details' => [], + ], + JSON_PRETTY_PRINT + ); + $operationsTransport->addResponse(null, $status); + // Mock request + $futureReservationResource = new FutureReservation(); + $project = 'project-309310695'; + $zone = 'zone3744684'; + $request = (new InsertFutureReservationRequest()) + ->setFutureReservationResource($futureReservationResource) + ->setProject($project) + ->setZone($zone); + $response = $gapicClient->insert($request); + $this->assertFalse($response->isDone()); + $this->assertNull($response->getResult()); + try { + $response->pollUntilComplete([ + 'initialPollDelayMillis' => 1, + ]); + // If the pollUntilComplete() method call did not throw, fail the test + $this->fail('Expected an ApiException, but no exception was thrown.'); + } catch (ApiException $ex) { + $this->assertEquals($status->code, $ex->getCode()); + $this->assertEquals($expectedExceptionMessage, $ex->getMessage()); + } + // Call popReceivedCalls to ensure the stubs are exhausted + $transport->popReceivedCalls(); + $operationsTransport->popReceivedCalls(); + $this->assertTrue($transport->isExhausted()); + $this->assertTrue($operationsTransport->isExhausted()); + } + + /** @test */ + public function listTest() + { + $transport = $this->createTransport(); + $gapicClient = $this->createClient([ + 'transport' => $transport, + ]); + $this->assertTrue($transport->isExhausted()); + // Mock response + $etag = 'etag3123477'; + $id = 'id3355'; + $kind = 'kind3292052'; + $nextPageToken = ''; + $selfLink = 'selfLink-1691268851'; + $itemsElement = new FutureReservation(); + $items = [$itemsElement]; + $expectedResponse = new FutureReservationsListResponse(); + $expectedResponse->setEtag($etag); + $expectedResponse->setId($id); + $expectedResponse->setKind($kind); + $expectedResponse->setNextPageToken($nextPageToken); + $expectedResponse->setSelfLink($selfLink); + $expectedResponse->setItems($items); + $transport->addResponse($expectedResponse); + // Mock request + $project = 'project-309310695'; + $zone = 'zone3744684'; + $request = (new ListFutureReservationsRequest())->setProject($project)->setZone($zone); + $response = $gapicClient->list($request); + $this->assertEquals($expectedResponse, $response->getPage()->getResponseObject()); + $resources = iterator_to_array($response->iterateAllElements()); + $this->assertSame(1, count($resources)); + $this->assertEquals($expectedResponse->getItems()[0], $resources[0]); + $actualRequests = $transport->popReceivedCalls(); + $this->assertSame(1, count($actualRequests)); + $actualFuncCall = $actualRequests[0]->getFuncCall(); + $actualRequestObject = $actualRequests[0]->getRequestObject(); + $this->assertSame('/google.cloud.compute.v1.FutureReservations/List', $actualFuncCall); + $actualValue = $actualRequestObject->getProject(); + $this->assertProtobufEquals($project, $actualValue); + $actualValue = $actualRequestObject->getZone(); + $this->assertProtobufEquals($zone, $actualValue); + $this->assertTrue($transport->isExhausted()); + } + + /** @test */ + public function listExceptionTest() + { + $transport = $this->createTransport(); + $gapicClient = $this->createClient([ + 'transport' => $transport, + ]); + $this->assertTrue($transport->isExhausted()); + $status = new stdClass(); + $status->code = Code::DATA_LOSS; + $status->details = 'internal error'; + $expectedExceptionMessage = json_encode( + [ + 'message' => 'internal error', + 'code' => Code::DATA_LOSS, + 'status' => 'DATA_LOSS', + 'details' => [], + ], + JSON_PRETTY_PRINT + ); + $transport->addResponse(null, $status); + // Mock request + $project = 'project-309310695'; + $zone = 'zone3744684'; + $request = (new ListFutureReservationsRequest())->setProject($project)->setZone($zone); + try { + $gapicClient->list($request); + // If the $gapicClient method call did not throw, fail the test + $this->fail('Expected an ApiException, but no exception was thrown.'); + } catch (ApiException $ex) { + $this->assertEquals($status->code, $ex->getCode()); + $this->assertEquals($expectedExceptionMessage, $ex->getMessage()); + } + // Call popReceivedCalls to ensure the stub is exhausted + $transport->popReceivedCalls(); + $this->assertTrue($transport->isExhausted()); + } + + /** @test */ + public function updateTest() + { + $operationsTransport = $this->createTransport(); + $operationsClient = new ZoneOperationsClient([ + 'apiEndpoint' => '', + 'transport' => $operationsTransport, + 'credentials' => $this->createCredentials(), + ]); + $transport = $this->createTransport(); + $gapicClient = $this->createClient([ + 'transport' => $transport, + 'operationsClient' => $operationsClient, + ]); + $this->assertTrue($transport->isExhausted()); + $this->assertTrue($operationsTransport->isExhausted()); + // Mock response + $incompleteOperation = new Operation(); + $incompleteOperation->setName('customOperations/updateTest'); + $incompleteOperation->setStatus(Status::RUNNING); + $transport->addResponse($incompleteOperation); + $completeOperation = new Operation(); + $completeOperation->setName('customOperations/updateTest'); + $completeOperation->setStatus(Status::DONE); + $operationsTransport->addResponse($completeOperation); + // Mock request + $futureReservation = 'futureReservation-1554406576'; + $futureReservationResource = new FutureReservation(); + $project = 'project-309310695'; + $zone = 'zone3744684'; + $request = (new UpdateFutureReservationRequest()) + ->setFutureReservation($futureReservation) + ->setFutureReservationResource($futureReservationResource) + ->setProject($project) + ->setZone($zone); + $response = $gapicClient->update($request); + $this->assertFalse($response->isDone()); + $apiRequests = $transport->popReceivedCalls(); + $this->assertSame(1, count($apiRequests)); + $operationsRequestsEmpty = $operationsTransport->popReceivedCalls(); + $this->assertSame(0, count($operationsRequestsEmpty)); + $actualApiFuncCall = $apiRequests[0]->getFuncCall(); + $actualApiRequestObject = $apiRequests[0]->getRequestObject(); + $this->assertSame('/google.cloud.compute.v1.FutureReservations/Update', $actualApiFuncCall); + $actualValue = $actualApiRequestObject->getFutureReservation(); + $this->assertProtobufEquals($futureReservation, $actualValue); + $actualValue = $actualApiRequestObject->getFutureReservationResource(); + $this->assertProtobufEquals($futureReservationResource, $actualValue); + $actualValue = $actualApiRequestObject->getProject(); + $this->assertProtobufEquals($project, $actualValue); + $actualValue = $actualApiRequestObject->getZone(); + $this->assertProtobufEquals($zone, $actualValue); + $expectedOperationsRequestObject = new GetZoneOperationRequest(); + $expectedOperationsRequestObject->setOperation($completeOperation->getName()); + $expectedOperationsRequestObject->setProject($project); + $expectedOperationsRequestObject->setZone($zone); + $response->pollUntilComplete([ + 'initialPollDelayMillis' => 1, + ]); + $this->assertTrue($response->isDone()); + $apiRequestsEmpty = $transport->popReceivedCalls(); + $this->assertSame(0, count($apiRequestsEmpty)); + $operationsRequests = $operationsTransport->popReceivedCalls(); + $this->assertSame(1, count($operationsRequests)); + $actualOperationsFuncCall = $operationsRequests[0]->getFuncCall(); + $actualOperationsRequestObject = $operationsRequests[0]->getRequestObject(); + $this->assertSame('/google.cloud.compute.v1.ZoneOperations/Get', $actualOperationsFuncCall); + $this->assertEquals($expectedOperationsRequestObject, $actualOperationsRequestObject); + $this->assertTrue($transport->isExhausted()); + $this->assertTrue($operationsTransport->isExhausted()); + } + + /** @test */ + public function updateExceptionTest() + { + $operationsTransport = $this->createTransport(); + $operationsClient = new ZoneOperationsClient([ + 'apiEndpoint' => '', + 'transport' => $operationsTransport, + 'credentials' => $this->createCredentials(), + ]); + $transport = $this->createTransport(); + $gapicClient = $this->createClient([ + 'transport' => $transport, + 'operationsClient' => $operationsClient, + ]); + $this->assertTrue($transport->isExhausted()); + $this->assertTrue($operationsTransport->isExhausted()); + // Mock response + $incompleteOperation = new Operation(); + $incompleteOperation->setName('customOperations/updateExceptionTest'); + $incompleteOperation->setStatus(Status::RUNNING); + $transport->addResponse($incompleteOperation); + $status = new stdClass(); + $status->code = Code::DATA_LOSS; + $status->details = 'internal error'; + $expectedExceptionMessage = json_encode( + [ + 'message' => 'internal error', + 'code' => Code::DATA_LOSS, + 'status' => 'DATA_LOSS', + 'details' => [], + ], + JSON_PRETTY_PRINT + ); + $operationsTransport->addResponse(null, $status); + // Mock request + $futureReservation = 'futureReservation-1554406576'; + $futureReservationResource = new FutureReservation(); + $project = 'project-309310695'; + $zone = 'zone3744684'; + $request = (new UpdateFutureReservationRequest()) + ->setFutureReservation($futureReservation) + ->setFutureReservationResource($futureReservationResource) + ->setProject($project) + ->setZone($zone); + $response = $gapicClient->update($request); + $this->assertFalse($response->isDone()); + $this->assertNull($response->getResult()); + try { + $response->pollUntilComplete([ + 'initialPollDelayMillis' => 1, + ]); + // If the pollUntilComplete() method call did not throw, fail the test + $this->fail('Expected an ApiException, but no exception was thrown.'); + } catch (ApiException $ex) { + $this->assertEquals($status->code, $ex->getCode()); + $this->assertEquals($expectedExceptionMessage, $ex->getMessage()); + } + // Call popReceivedCalls to ensure the stubs are exhausted + $transport->popReceivedCalls(); + $operationsTransport->popReceivedCalls(); + $this->assertTrue($transport->isExhausted()); + $this->assertTrue($operationsTransport->isExhausted()); + } + + /** @test */ + public function aggregatedListAsyncTest() + { + $transport = $this->createTransport(); + $gapicClient = $this->createClient([ + 'transport' => $transport, + ]); + $this->assertTrue($transport->isExhausted()); + // Mock response + $etag = 'etag3123477'; + $id = 'id3355'; + $kind = 'kind3292052'; + $nextPageToken = ''; + $selfLink = 'selfLink-1691268851'; + $items = [ + 'itemsKey' => new FutureReservationsScopedList(), + ]; + $expectedResponse = new FutureReservationsAggregatedListResponse(); + $expectedResponse->setEtag($etag); + $expectedResponse->setId($id); + $expectedResponse->setKind($kind); + $expectedResponse->setNextPageToken($nextPageToken); + $expectedResponse->setSelfLink($selfLink); + $expectedResponse->setItems($items); + $transport->addResponse($expectedResponse); + // Mock request + $project = 'project-309310695'; + $request = (new AggregatedListFutureReservationsRequest())->setProject($project); + $response = $gapicClient->aggregatedListAsync($request)->wait(); + $this->assertEquals($expectedResponse, $response->getPage()->getResponseObject()); + $resources = iterator_to_array($response->iterateAllElements()); + $this->assertSame(1, count($resources)); + $this->assertArrayHasKey('itemsKey', $expectedResponse->getItems()); + $this->assertArrayHasKey('itemsKey', $resources); + $this->assertEquals($expectedResponse->getItems()['itemsKey'], $resources['itemsKey']); + $actualRequests = $transport->popReceivedCalls(); + $this->assertSame(1, count($actualRequests)); + $actualFuncCall = $actualRequests[0]->getFuncCall(); + $actualRequestObject = $actualRequests[0]->getRequestObject(); + $this->assertSame('/google.cloud.compute.v1.FutureReservations/AggregatedList', $actualFuncCall); + $actualValue = $actualRequestObject->getProject(); + $this->assertProtobufEquals($project, $actualValue); + $this->assertTrue($transport->isExhausted()); + } +} diff --git a/Compute/tests/Unit/V1/Client/GlobalPublicDelegatedPrefixesClientTest.php b/Compute/tests/Unit/V1/Client/GlobalPublicDelegatedPrefixesClientTest.php index 12fa9f52c42d..703487ef227b 100644 --- a/Compute/tests/Unit/V1/Client/GlobalPublicDelegatedPrefixesClientTest.php +++ b/Compute/tests/Unit/V1/Client/GlobalPublicDelegatedPrefixesClientTest.php @@ -210,6 +210,7 @@ public function getTest() $fingerprint = 'fingerprint-1375934236'; $id = 3355; $ipCidrRange = 'ipCidrRange-2049366326'; + $ipv6AccessType = 'ipv6AccessType-569083171'; $isLiveMigration = true; $kind = 'kind3292052'; $mode = 'mode3357091'; @@ -226,6 +227,7 @@ public function getTest() $expectedResponse->setFingerprint($fingerprint); $expectedResponse->setId($id); $expectedResponse->setIpCidrRange($ipCidrRange); + $expectedResponse->setIpv6AccessType($ipv6AccessType); $expectedResponse->setIsLiveMigration($isLiveMigration); $expectedResponse->setKind($kind); $expectedResponse->setMode($mode); diff --git a/Compute/tests/Unit/V1/Client/NetworkFirewallPoliciesClientTest.php b/Compute/tests/Unit/V1/Client/NetworkFirewallPoliciesClientTest.php index fdbc259934f7..d4624f2d9199 100644 --- a/Compute/tests/Unit/V1/Client/NetworkFirewallPoliciesClientTest.php +++ b/Compute/tests/Unit/V1/Client/NetworkFirewallPoliciesClientTest.php @@ -824,6 +824,7 @@ public function getTest() $kind = 'kind3292052'; $name = 'name3373707'; $parent = 'parent-995424086'; + $policyType = 'policyType-2129325529'; $region = 'region-934795532'; $ruleTupleCount = 388342037; $selfLink = 'selfLink-1691268851'; @@ -838,6 +839,7 @@ public function getTest() $expectedResponse->setKind($kind); $expectedResponse->setName($name); $expectedResponse->setParent($parent); + $expectedResponse->setPolicyType($policyType); $expectedResponse->setRegion($region); $expectedResponse->setRuleTupleCount($ruleTupleCount); $expectedResponse->setSelfLink($selfLink); diff --git a/Compute/tests/Unit/V1/Client/OrganizationSecurityPoliciesClientTest.php b/Compute/tests/Unit/V1/Client/OrganizationSecurityPoliciesClientTest.php index b266c2a28b69..6dcfb694ca02 100644 --- a/Compute/tests/Unit/V1/Client/OrganizationSecurityPoliciesClientTest.php +++ b/Compute/tests/Unit/V1/Client/OrganizationSecurityPoliciesClientTest.php @@ -574,6 +574,7 @@ public function getTest() $kind = 'kind3292052'; $labelFingerprint = 'labelFingerprint714995737'; $name = 'name3373707'; + $parent = 'parent-995424086'; $region = 'region-934795532'; $selfLink = 'selfLink-1691268851'; $shortName = 'shortName1565793390'; @@ -586,6 +587,7 @@ public function getTest() $expectedResponse->setKind($kind); $expectedResponse->setLabelFingerprint($labelFingerprint); $expectedResponse->setName($name); + $expectedResponse->setParent($parent); $expectedResponse->setRegion($region); $expectedResponse->setSelfLink($selfLink); $expectedResponse->setShortName($shortName); diff --git a/Compute/tests/Unit/V1/Client/PublicAdvertisedPrefixesClientTest.php b/Compute/tests/Unit/V1/Client/PublicAdvertisedPrefixesClientTest.php index a7d5a9252eec..6e05c8b08525 100644 --- a/Compute/tests/Unit/V1/Client/PublicAdvertisedPrefixesClientTest.php +++ b/Compute/tests/Unit/V1/Client/PublicAdvertisedPrefixesClientTest.php @@ -335,6 +335,7 @@ public function getTest() $fingerprint = 'fingerprint-1375934236'; $id = 3355; $ipCidrRange = 'ipCidrRange-2049366326'; + $ipv6AccessType = 'ipv6AccessType-569083171'; $kind = 'kind3292052'; $name = 'name3373707'; $pdpScope = 'pdpScope1061135697'; @@ -349,6 +350,7 @@ public function getTest() $expectedResponse->setFingerprint($fingerprint); $expectedResponse->setId($id); $expectedResponse->setIpCidrRange($ipCidrRange); + $expectedResponse->setIpv6AccessType($ipv6AccessType); $expectedResponse->setKind($kind); $expectedResponse->setName($name); $expectedResponse->setPdpScope($pdpScope); diff --git a/Compute/tests/Unit/V1/Client/PublicDelegatedPrefixesClientTest.php b/Compute/tests/Unit/V1/Client/PublicDelegatedPrefixesClientTest.php index dd8c3d4e1cdf..056c99004dde 100644 --- a/Compute/tests/Unit/V1/Client/PublicDelegatedPrefixesClientTest.php +++ b/Compute/tests/Unit/V1/Client/PublicDelegatedPrefixesClientTest.php @@ -432,6 +432,7 @@ public function getTest() $fingerprint = 'fingerprint-1375934236'; $id = 3355; $ipCidrRange = 'ipCidrRange-2049366326'; + $ipv6AccessType = 'ipv6AccessType-569083171'; $isLiveMigration = true; $kind = 'kind3292052'; $mode = 'mode3357091'; @@ -448,6 +449,7 @@ public function getTest() $expectedResponse->setFingerprint($fingerprint); $expectedResponse->setId($id); $expectedResponse->setIpCidrRange($ipCidrRange); + $expectedResponse->setIpv6AccessType($ipv6AccessType); $expectedResponse->setIsLiveMigration($isLiveMigration); $expectedResponse->setKind($kind); $expectedResponse->setMode($mode); diff --git a/Compute/tests/Unit/V1/Client/RegionNetworkFirewallPoliciesClientTest.php b/Compute/tests/Unit/V1/Client/RegionNetworkFirewallPoliciesClientTest.php index 548c2eecad4f..7c4968455589 100644 --- a/Compute/tests/Unit/V1/Client/RegionNetworkFirewallPoliciesClientTest.php +++ b/Compute/tests/Unit/V1/Client/RegionNetworkFirewallPoliciesClientTest.php @@ -639,6 +639,7 @@ public function getTest() $kind = 'kind3292052'; $name = 'name3373707'; $parent = 'parent-995424086'; + $policyType = 'policyType-2129325529'; $region2 = 'region2-690338393'; $ruleTupleCount = 388342037; $selfLink = 'selfLink-1691268851'; @@ -653,6 +654,7 @@ public function getTest() $expectedResponse->setKind($kind); $expectedResponse->setName($name); $expectedResponse->setParent($parent); + $expectedResponse->setPolicyType($policyType); $expectedResponse->setRegion($region2); $expectedResponse->setRuleTupleCount($ruleTupleCount); $expectedResponse->setSelfLink($selfLink); diff --git a/Compute/tests/Unit/V1/Client/RegionSecurityPoliciesClientTest.php b/Compute/tests/Unit/V1/Client/RegionSecurityPoliciesClientTest.php index b6e2d5ed28af..36cc6a904212 100644 --- a/Compute/tests/Unit/V1/Client/RegionSecurityPoliciesClientTest.php +++ b/Compute/tests/Unit/V1/Client/RegionSecurityPoliciesClientTest.php @@ -360,6 +360,7 @@ public function getTest() $kind = 'kind3292052'; $labelFingerprint = 'labelFingerprint714995737'; $name = 'name3373707'; + $parent = 'parent-995424086'; $region2 = 'region2-690338393'; $selfLink = 'selfLink-1691268851'; $shortName = 'shortName1565793390'; @@ -372,6 +373,7 @@ public function getTest() $expectedResponse->setKind($kind); $expectedResponse->setLabelFingerprint($labelFingerprint); $expectedResponse->setName($name); + $expectedResponse->setParent($parent); $expectedResponse->setRegion($region2); $expectedResponse->setSelfLink($selfLink); $expectedResponse->setShortName($shortName); diff --git a/Compute/tests/Unit/V1/Client/ReservationBlocksClientTest.php b/Compute/tests/Unit/V1/Client/ReservationBlocksClientTest.php index 1e81ced5c234..985d738a6c7d 100644 --- a/Compute/tests/Unit/V1/Client/ReservationBlocksClientTest.php +++ b/Compute/tests/Unit/V1/Client/ReservationBlocksClientTest.php @@ -28,16 +28,23 @@ use Google\ApiCore\Testing\MockTransport; use Google\Cloud\Compute\V1\Client\ReservationBlocksClient; use Google\Cloud\Compute\V1\Client\ZoneOperationsClient; +use Google\Cloud\Compute\V1\GetIamPolicyReservationBlockRequest; use Google\Cloud\Compute\V1\GetReservationBlockRequest; use Google\Cloud\Compute\V1\GetZoneOperationRequest; use Google\Cloud\Compute\V1\ListReservationBlocksRequest; use Google\Cloud\Compute\V1\Operation; use Google\Cloud\Compute\V1\Operation\Status; use Google\Cloud\Compute\V1\PerformMaintenanceReservationBlockRequest; +use Google\Cloud\Compute\V1\Policy; use Google\Cloud\Compute\V1\ReservationBlock; use Google\Cloud\Compute\V1\ReservationBlocksGetResponse; use Google\Cloud\Compute\V1\ReservationBlocksListResponse; use Google\Cloud\Compute\V1\ReservationsBlocksPerformMaintenanceRequest; +use Google\Cloud\Compute\V1\SetIamPolicyReservationBlockRequest; +use Google\Cloud\Compute\V1\TestIamPermissionsReservationBlockRequest; +use Google\Cloud\Compute\V1\TestPermissionsRequest; +use Google\Cloud\Compute\V1\TestPermissionsResponse; +use Google\Cloud\Compute\V1\ZoneSetNestedPolicyRequest; use Google\Rpc\Code; use stdClass; @@ -154,6 +161,95 @@ public function getExceptionTest() $this->assertTrue($transport->isExhausted()); } + /** @test */ + public function getIamPolicyTest() + { + $transport = $this->createTransport(); + $gapicClient = $this->createClient([ + 'transport' => $transport, + ]); + $this->assertTrue($transport->isExhausted()); + // Mock response + $etag = 'etag3123477'; + $iamOwned = false; + $version = 351608024; + $expectedResponse = new Policy(); + $expectedResponse->setEtag($etag); + $expectedResponse->setIamOwned($iamOwned); + $expectedResponse->setVersion($version); + $transport->addResponse($expectedResponse); + // Mock request + $parentResource = 'parentResource-1055650813'; + $project = 'project-309310695'; + $resource = 'resource-341064690'; + $zone = 'zone3744684'; + $request = (new GetIamPolicyReservationBlockRequest()) + ->setParentResource($parentResource) + ->setProject($project) + ->setResource($resource) + ->setZone($zone); + $response = $gapicClient->getIamPolicy($request); + $this->assertEquals($expectedResponse, $response); + $actualRequests = $transport->popReceivedCalls(); + $this->assertSame(1, count($actualRequests)); + $actualFuncCall = $actualRequests[0]->getFuncCall(); + $actualRequestObject = $actualRequests[0]->getRequestObject(); + $this->assertSame('/google.cloud.compute.v1.ReservationBlocks/GetIamPolicy', $actualFuncCall); + $actualValue = $actualRequestObject->getParentResource(); + $this->assertProtobufEquals($parentResource, $actualValue); + $actualValue = $actualRequestObject->getProject(); + $this->assertProtobufEquals($project, $actualValue); + $actualValue = $actualRequestObject->getResource(); + $this->assertProtobufEquals($resource, $actualValue); + $actualValue = $actualRequestObject->getZone(); + $this->assertProtobufEquals($zone, $actualValue); + $this->assertTrue($transport->isExhausted()); + } + + /** @test */ + public function getIamPolicyExceptionTest() + { + $transport = $this->createTransport(); + $gapicClient = $this->createClient([ + 'transport' => $transport, + ]); + $this->assertTrue($transport->isExhausted()); + $status = new stdClass(); + $status->code = Code::DATA_LOSS; + $status->details = 'internal error'; + $expectedExceptionMessage = json_encode( + [ + 'message' => 'internal error', + 'code' => Code::DATA_LOSS, + 'status' => 'DATA_LOSS', + 'details' => [], + ], + JSON_PRETTY_PRINT + ); + $transport->addResponse(null, $status); + // Mock request + $parentResource = 'parentResource-1055650813'; + $project = 'project-309310695'; + $resource = 'resource-341064690'; + $zone = 'zone3744684'; + $request = (new GetIamPolicyReservationBlockRequest()) + ->setParentResource($parentResource) + ->setProject($project) + ->setResource($resource) + ->setZone($zone); + try { + $gapicClient->getIamPolicy($request); + // If the $gapicClient method call did not throw, fail the test + $this->fail('Expected an ApiException, but no exception was thrown.'); + } catch (ApiException $ex) { + $this->assertEquals($status->code, $ex->getCode()); + $this->assertEquals($expectedExceptionMessage, $ex->getMessage()); + } + // Call popReceivedCalls to ensure the stub is exhausted + $transport->popReceivedCalls(); + $this->assertTrue($transport->isExhausted()); + } + /** @test */ public function listTest() { @@ -391,6 +487,190 @@ public function performMaintenanceExceptionTest() $this->assertTrue($operationsTransport->isExhausted()); } + /** @test */ + public function setIamPolicyTest() + { + $transport = $this->createTransport(); + $gapicClient = $this->createClient([ + 'transport' => $transport, + ]); + $this->assertTrue($transport->isExhausted()); + // Mock response + $etag = 'etag3123477'; + $iamOwned = false; + $version = 351608024; + $expectedResponse = new Policy(); + $expectedResponse->setEtag($etag); + $expectedResponse->setIamOwned($iamOwned); + $expectedResponse->setVersion($version); + $transport->addResponse($expectedResponse); + // Mock request + $parentResource = 'parentResource-1055650813'; + $project = 'project-309310695'; + $resource = 'resource-341064690'; + $zone = 'zone3744684'; + $zoneSetNestedPolicyRequestResource = new ZoneSetNestedPolicyRequest(); + $request = (new SetIamPolicyReservationBlockRequest()) + ->setParentResource($parentResource) + ->setProject($project) + ->setResource($resource) + ->setZone($zone) + ->setZoneSetNestedPolicyRequestResource($zoneSetNestedPolicyRequestResource); + $response = $gapicClient->setIamPolicy($request); + $this->assertEquals($expectedResponse, $response); + $actualRequests = $transport->popReceivedCalls(); + $this->assertSame(1, count($actualRequests)); + $actualFuncCall = $actualRequests[0]->getFuncCall(); + $actualRequestObject = $actualRequests[0]->getRequestObject(); + $this->assertSame('/google.cloud.compute.v1.ReservationBlocks/SetIamPolicy', $actualFuncCall); + $actualValue = $actualRequestObject->getParentResource(); + $this->assertProtobufEquals($parentResource, $actualValue); + $actualValue = $actualRequestObject->getProject(); + $this->assertProtobufEquals($project, $actualValue); + $actualValue = $actualRequestObject->getResource(); + $this->assertProtobufEquals($resource, $actualValue); + $actualValue = $actualRequestObject->getZone(); + $this->assertProtobufEquals($zone, $actualValue); + $actualValue = $actualRequestObject->getZoneSetNestedPolicyRequestResource(); + $this->assertProtobufEquals($zoneSetNestedPolicyRequestResource, $actualValue); + $this->assertTrue($transport->isExhausted()); + } + + /** @test */ + public function setIamPolicyExceptionTest() + { + $transport = $this->createTransport(); + $gapicClient = $this->createClient([ + 'transport' => $transport, + ]); + $this->assertTrue($transport->isExhausted()); + $status = new stdClass(); + $status->code = Code::DATA_LOSS; + $status->details = 'internal error'; + $expectedExceptionMessage = json_encode( + [ + 'message' => 'internal error', + 'code' => Code::DATA_LOSS, + 'status' => 'DATA_LOSS', + 'details' => [], + ], + JSON_PRETTY_PRINT + ); + $transport->addResponse(null, $status); + // Mock request + $parentResource = 'parentResource-1055650813'; + $project = 'project-309310695'; + $resource = 'resource-341064690'; + $zone = 'zone3744684'; + $zoneSetNestedPolicyRequestResource = new ZoneSetNestedPolicyRequest(); + $request = (new SetIamPolicyReservationBlockRequest()) + ->setParentResource($parentResource) + ->setProject($project) + ->setResource($resource) + ->setZone($zone) + ->setZoneSetNestedPolicyRequestResource($zoneSetNestedPolicyRequestResource); + try { + $gapicClient->setIamPolicy($request); + // If the $gapicClient method call did not throw, fail the test + $this->fail('Expected an ApiException, but no exception was thrown.'); + } catch (ApiException $ex) { + $this->assertEquals($status->code, $ex->getCode()); + $this->assertEquals($expectedExceptionMessage, $ex->getMessage()); + } + // Call popReceivedCalls to ensure the stub is exhausted + $transport->popReceivedCalls(); + $this->assertTrue($transport->isExhausted()); + } + + /** @test */ + public function testIamPermissionsTest() + { + $transport = $this->createTransport(); + $gapicClient = $this->createClient([ + 'transport' => $transport, + ]); + $this->assertTrue($transport->isExhausted()); + // Mock response + $expectedResponse = new TestPermissionsResponse(); + $transport->addResponse($expectedResponse); + // Mock request + $parentResource = 'parentResource-1055650813'; + $project = 'project-309310695'; + $resource = 'resource-341064690'; + $testPermissionsRequestResource = new TestPermissionsRequest(); + $zone = 'zone3744684'; + $request = (new TestIamPermissionsReservationBlockRequest()) + ->setParentResource($parentResource) + ->setProject($project) + ->setResource($resource) + ->setTestPermissionsRequestResource($testPermissionsRequestResource) + ->setZone($zone); + $response = $gapicClient->testIamPermissions($request); + $this->assertEquals($expectedResponse, $response); + $actualRequests = $transport->popReceivedCalls(); + $this->assertSame(1, count($actualRequests)); + $actualFuncCall = $actualRequests[0]->getFuncCall(); + $actualRequestObject = $actualRequests[0]->getRequestObject(); + $this->assertSame('/google.cloud.compute.v1.ReservationBlocks/TestIamPermissions', $actualFuncCall); + $actualValue = $actualRequestObject->getParentResource(); + $this->assertProtobufEquals($parentResource, $actualValue); + $actualValue = $actualRequestObject->getProject(); + $this->assertProtobufEquals($project, $actualValue); + $actualValue = $actualRequestObject->getResource(); + $this->assertProtobufEquals($resource, $actualValue); + $actualValue = $actualRequestObject->getTestPermissionsRequestResource(); + $this->assertProtobufEquals($testPermissionsRequestResource, $actualValue); + $actualValue = $actualRequestObject->getZone(); + $this->assertProtobufEquals($zone, $actualValue); + $this->assertTrue($transport->isExhausted()); + } + + /** @test */ + public function testIamPermissionsExceptionTest() + { + $transport = $this->createTransport(); + $gapicClient = $this->createClient([ + 'transport' => $transport, + ]); + $this->assertTrue($transport->isExhausted()); + $status = new stdClass(); + $status->code = Code::DATA_LOSS; + $status->details = 'internal error'; + $expectedExceptionMessage = json_encode( + [ + 'message' => 'internal error', + 'code' => Code::DATA_LOSS, + 'status' => 'DATA_LOSS', + 'details' => [], + ], + JSON_PRETTY_PRINT + ); + $transport->addResponse(null, $status); + // Mock request + $parentResource = 'parentResource-1055650813'; + $project = 'project-309310695'; + $resource = 'resource-341064690'; + $testPermissionsRequestResource = new TestPermissionsRequest(); + $zone = 'zone3744684'; + $request = (new TestIamPermissionsReservationBlockRequest()) + ->setParentResource($parentResource) + ->setProject($project) + ->setResource($resource) + ->setTestPermissionsRequestResource($testPermissionsRequestResource) + ->setZone($zone); + try { + $gapicClient->testIamPermissions($request); + // If the $gapicClient method call did not throw, fail the test + $this->fail('Expected an ApiException, but no exception was thrown.'); + } catch (ApiException $ex) { + $this->assertEquals($status->code, $ex->getCode()); + $this->assertEquals($expectedExceptionMessage, $ex->getMessage()); + } + // Call popReceivedCalls to ensure the stub is exhausted + $transport->popReceivedCalls(); + $this->assertTrue($transport->isExhausted()); + } + /** @test */ public function getAsyncTest() { diff --git a/Compute/tests/Unit/V1/Client/ReservationSubBlocksClientTest.php b/Compute/tests/Unit/V1/Client/ReservationSubBlocksClientTest.php index 8c09fb35d0ff..929c0361e69c 100644 --- a/Compute/tests/Unit/V1/Client/ReservationSubBlocksClientTest.php +++ b/Compute/tests/Unit/V1/Client/ReservationSubBlocksClientTest.php @@ -28,17 +28,24 @@ use Google\ApiCore\Testing\MockTransport; use Google\Cloud\Compute\V1\Client\ReservationSubBlocksClient; use Google\Cloud\Compute\V1\Client\ZoneOperationsClient; +use Google\Cloud\Compute\V1\GetIamPolicyReservationSubBlockRequest; use Google\Cloud\Compute\V1\GetReservationSubBlockRequest; use Google\Cloud\Compute\V1\GetZoneOperationRequest; use Google\Cloud\Compute\V1\ListReservationSubBlocksRequest; use Google\Cloud\Compute\V1\Operation; use Google\Cloud\Compute\V1\Operation\Status; use Google\Cloud\Compute\V1\PerformMaintenanceReservationSubBlockRequest; +use Google\Cloud\Compute\V1\Policy; use Google\Cloud\Compute\V1\ReportFaultyReservationSubBlockRequest; use Google\Cloud\Compute\V1\ReservationSubBlock; use Google\Cloud\Compute\V1\ReservationSubBlocksGetResponse; use Google\Cloud\Compute\V1\ReservationSubBlocksListResponse; use Google\Cloud\Compute\V1\ReservationSubBlocksReportFaultyRequest; +use Google\Cloud\Compute\V1\SetIamPolicyReservationSubBlockRequest; +use Google\Cloud\Compute\V1\TestIamPermissionsReservationSubBlockRequest; +use Google\Cloud\Compute\V1\TestPermissionsRequest; +use Google\Cloud\Compute\V1\TestPermissionsResponse; +use Google\Cloud\Compute\V1\ZoneSetNestedPolicyRequest; use Google\Rpc\Code; use stdClass; @@ -155,6 +162,95 @@ public function getExceptionTest() $this->assertTrue($transport->isExhausted()); } + /** @test */ + public function getIamPolicyTest() + { + $transport = $this->createTransport(); + $gapicClient = $this->createClient([ + 'transport' => $transport, + ]); + $this->assertTrue($transport->isExhausted()); + // Mock response + $etag = 'etag3123477'; + $iamOwned = false; + $version = 351608024; + $expectedResponse = new Policy(); + $expectedResponse->setEtag($etag); + $expectedResponse->setIamOwned($iamOwned); + $expectedResponse->setVersion($version); + $transport->addResponse($expectedResponse); + // Mock request + $parentResource = 'parentResource-1055650813'; + $project = 'project-309310695'; + $resource = 'resource-341064690'; + $zone = 'zone3744684'; + $request = (new GetIamPolicyReservationSubBlockRequest()) + ->setParentResource($parentResource) + ->setProject($project) + ->setResource($resource) + ->setZone($zone); + $response = $gapicClient->getIamPolicy($request); + $this->assertEquals($expectedResponse, $response); + $actualRequests = $transport->popReceivedCalls(); + $this->assertSame(1, count($actualRequests)); + $actualFuncCall = $actualRequests[0]->getFuncCall(); + $actualRequestObject = $actualRequests[0]->getRequestObject(); + $this->assertSame('/google.cloud.compute.v1.ReservationSubBlocks/GetIamPolicy', $actualFuncCall); + $actualValue = $actualRequestObject->getParentResource(); + $this->assertProtobufEquals($parentResource, $actualValue); + $actualValue = $actualRequestObject->getProject(); + $this->assertProtobufEquals($project, $actualValue); + $actualValue = $actualRequestObject->getResource(); + $this->assertProtobufEquals($resource, $actualValue); + $actualValue = $actualRequestObject->getZone(); + $this->assertProtobufEquals($zone, $actualValue); + $this->assertTrue($transport->isExhausted()); + } + + /** @test */ + public function getIamPolicyExceptionTest() + { + $transport = $this->createTransport(); + $gapicClient = $this->createClient([ + 'transport' => $transport, + ]); + $this->assertTrue($transport->isExhausted()); + $status = new stdClass(); + $status->code = Code::DATA_LOSS; + $status->details = 'internal error'; + $expectedExceptionMessage = json_encode( + [ + 'message' => 'internal error', + 'code' => Code::DATA_LOSS, + 'status' => 'DATA_LOSS', + 'details' => [], + ], + JSON_PRETTY_PRINT + ); + $transport->addResponse(null, $status); + // Mock request + $parentResource = 'parentResource-1055650813'; + $project = 'project-309310695'; + $resource = 'resource-341064690'; + $zone = 'zone3744684'; + $request = (new GetIamPolicyReservationSubBlockRequest()) + ->setParentResource($parentResource) + ->setProject($project) + ->setResource($resource) + ->setZone($zone); + try { + $gapicClient->getIamPolicy($request); + // If the $gapicClient method call did not throw, fail the test + $this->fail('Expected an ApiException, but no exception was thrown.'); + } catch (ApiException $ex) { + $this->assertEquals($status->code, $ex->getCode()); + $this->assertEquals($expectedExceptionMessage, $ex->getMessage()); + } + // Call popReceivedCalls to ensure the stub is exhausted + $transport->popReceivedCalls(); + $this->assertTrue($transport->isExhausted()); + } + /** @test */ public function listTest() { @@ -524,6 +620,190 @@ public function reportFaultyExceptionTest() $this->assertTrue($operationsTransport->isExhausted()); } + /** @test */ + public function setIamPolicyTest() + { + $transport = $this->createTransport(); + $gapicClient = $this->createClient([ + 'transport' => $transport, + ]); + $this->assertTrue($transport->isExhausted()); + // Mock response + $etag = 'etag3123477'; + $iamOwned = false; + $version = 351608024; + $expectedResponse = new Policy(); + $expectedResponse->setEtag($etag); + $expectedResponse->setIamOwned($iamOwned); + $expectedResponse->setVersion($version); + $transport->addResponse($expectedResponse); + // Mock request + $parentResource = 'parentResource-1055650813'; + $project = 'project-309310695'; + $resource = 'resource-341064690'; + $zone = 'zone3744684'; + $zoneSetNestedPolicyRequestResource = new ZoneSetNestedPolicyRequest(); + $request = (new SetIamPolicyReservationSubBlockRequest()) + ->setParentResource($parentResource) + ->setProject($project) + ->setResource($resource) + ->setZone($zone) + ->setZoneSetNestedPolicyRequestResource($zoneSetNestedPolicyRequestResource); + $response = $gapicClient->setIamPolicy($request); + $this->assertEquals($expectedResponse, $response); + $actualRequests = $transport->popReceivedCalls(); + $this->assertSame(1, count($actualRequests)); + $actualFuncCall = $actualRequests[0]->getFuncCall(); + $actualRequestObject = $actualRequests[0]->getRequestObject(); + $this->assertSame('/google.cloud.compute.v1.ReservationSubBlocks/SetIamPolicy', $actualFuncCall); + $actualValue = $actualRequestObject->getParentResource(); + $this->assertProtobufEquals($parentResource, $actualValue); + $actualValue = $actualRequestObject->getProject(); + $this->assertProtobufEquals($project, $actualValue); + $actualValue = $actualRequestObject->getResource(); + $this->assertProtobufEquals($resource, $actualValue); + $actualValue = $actualRequestObject->getZone(); + $this->assertProtobufEquals($zone, $actualValue); + $actualValue = $actualRequestObject->getZoneSetNestedPolicyRequestResource(); + $this->assertProtobufEquals($zoneSetNestedPolicyRequestResource, $actualValue); + $this->assertTrue($transport->isExhausted()); + } + + /** @test */ + public function setIamPolicyExceptionTest() + { + $transport = $this->createTransport(); + $gapicClient = $this->createClient([ + 'transport' => $transport, + ]); + $this->assertTrue($transport->isExhausted()); + $status = new stdClass(); + $status->code = Code::DATA_LOSS; + $status->details = 'internal error'; + $expectedExceptionMessage = json_encode( + [ + 'message' => 'internal error', + 'code' => Code::DATA_LOSS, + 'status' => 'DATA_LOSS', + 'details' => [], + ], + JSON_PRETTY_PRINT + ); + $transport->addResponse(null, $status); + // Mock request + $parentResource = 'parentResource-1055650813'; + $project = 'project-309310695'; + $resource = 'resource-341064690'; + $zone = 'zone3744684'; + $zoneSetNestedPolicyRequestResource = new ZoneSetNestedPolicyRequest(); + $request = (new SetIamPolicyReservationSubBlockRequest()) + ->setParentResource($parentResource) + ->setProject($project) + ->setResource($resource) + ->setZone($zone) + ->setZoneSetNestedPolicyRequestResource($zoneSetNestedPolicyRequestResource); + try { + $gapicClient->setIamPolicy($request); + // If the $gapicClient method call did not throw, fail the test + $this->fail('Expected an ApiException, but no exception was thrown.'); + } catch (ApiException $ex) { + $this->assertEquals($status->code, $ex->getCode()); + $this->assertEquals($expectedExceptionMessage, $ex->getMessage()); + } + // Call popReceivedCalls to ensure the stub is exhausted + $transport->popReceivedCalls(); + $this->assertTrue($transport->isExhausted()); + } + + /** @test */ + public function testIamPermissionsTest() + { + $transport = $this->createTransport(); + $gapicClient = $this->createClient([ + 'transport' => $transport, + ]); + $this->assertTrue($transport->isExhausted()); + // Mock response + $expectedResponse = new TestPermissionsResponse(); + $transport->addResponse($expectedResponse); + // Mock request + $parentResource = 'parentResource-1055650813'; + $project = 'project-309310695'; + $resource = 'resource-341064690'; + $testPermissionsRequestResource = new TestPermissionsRequest(); + $zone = 'zone3744684'; + $request = (new TestIamPermissionsReservationSubBlockRequest()) + ->setParentResource($parentResource) + ->setProject($project) + ->setResource($resource) + ->setTestPermissionsRequestResource($testPermissionsRequestResource) + ->setZone($zone); + $response = $gapicClient->testIamPermissions($request); + $this->assertEquals($expectedResponse, $response); + $actualRequests = $transport->popReceivedCalls(); + $this->assertSame(1, count($actualRequests)); + $actualFuncCall = $actualRequests[0]->getFuncCall(); + $actualRequestObject = $actualRequests[0]->getRequestObject(); + $this->assertSame('/google.cloud.compute.v1.ReservationSubBlocks/TestIamPermissions', $actualFuncCall); + $actualValue = $actualRequestObject->getParentResource(); + $this->assertProtobufEquals($parentResource, $actualValue); + $actualValue = $actualRequestObject->getProject(); + $this->assertProtobufEquals($project, $actualValue); + $actualValue = $actualRequestObject->getResource(); + $this->assertProtobufEquals($resource, $actualValue); + $actualValue = $actualRequestObject->getTestPermissionsRequestResource(); + $this->assertProtobufEquals($testPermissionsRequestResource, $actualValue); + $actualValue = $actualRequestObject->getZone(); + $this->assertProtobufEquals($zone, $actualValue); + $this->assertTrue($transport->isExhausted()); + } + + /** @test */ + public function testIamPermissionsExceptionTest() + { + $transport = $this->createTransport(); + $gapicClient = $this->createClient([ + 'transport' => $transport, + ]); + $this->assertTrue($transport->isExhausted()); + $status = new stdClass(); + $status->code = Code::DATA_LOSS; + $status->details = 'internal error'; + $expectedExceptionMessage = json_encode( + [ + 'message' => 'internal error', + 'code' => Code::DATA_LOSS, + 'status' => 'DATA_LOSS', + 'details' => [], + ], + JSON_PRETTY_PRINT + ); + $transport->addResponse(null, $status); + // Mock request + $parentResource = 'parentResource-1055650813'; + $project = 'project-309310695'; + $resource = 'resource-341064690'; + $testPermissionsRequestResource = new TestPermissionsRequest(); + $zone = 'zone3744684'; + $request = (new TestIamPermissionsReservationSubBlockRequest()) + ->setParentResource($parentResource) + ->setProject($project) + ->setResource($resource) + ->setTestPermissionsRequestResource($testPermissionsRequestResource) + ->setZone($zone); + try { + $gapicClient->testIamPermissions($request); + // If the $gapicClient method call did not throw, fail the test + $this->fail('Expected an ApiException, but no exception was thrown.'); + } catch (ApiException $ex) { + $this->assertEquals($status->code, $ex->getCode()); + $this->assertEquals($expectedExceptionMessage, $ex->getMessage()); + } + // Call popReceivedCalls to ensure the stub is exhausted + $transport->popReceivedCalls(); + $this->assertTrue($transport->isExhausted()); + } + /** @test */ public function getAsyncTest() { diff --git a/Compute/tests/Unit/V1/Client/ReservationsClientTest.php b/Compute/tests/Unit/V1/Client/ReservationsClientTest.php index 847e13d3479d..35513daeb619 100644 --- a/Compute/tests/Unit/V1/Client/ReservationsClientTest.php +++ b/Compute/tests/Unit/V1/Client/ReservationsClientTest.php @@ -313,6 +313,7 @@ public function getTest() $id = 3355; $kind = 'kind3292052'; $name = 'name3373707'; + $protectionTier = 'protectionTier2114572168'; $satisfiesPzs = false; $schedulingType = 'schedulingType199835397'; $selfLink = 'selfLink-1691268851'; @@ -329,6 +330,7 @@ public function getTest() $expectedResponse->setId($id); $expectedResponse->setKind($kind); $expectedResponse->setName($name); + $expectedResponse->setProtectionTier($protectionTier); $expectedResponse->setSatisfiesPzs($satisfiesPzs); $expectedResponse->setSchedulingType($schedulingType); $expectedResponse->setSelfLink($selfLink); diff --git a/Compute/tests/Unit/V1/Client/SecurityPoliciesClientTest.php b/Compute/tests/Unit/V1/Client/SecurityPoliciesClientTest.php index 49fb7ac36fe3..78e5a34c8363 100644 --- a/Compute/tests/Unit/V1/Client/SecurityPoliciesClientTest.php +++ b/Compute/tests/Unit/V1/Client/SecurityPoliciesClientTest.php @@ -429,6 +429,7 @@ public function getTest() $kind = 'kind3292052'; $labelFingerprint = 'labelFingerprint714995737'; $name = 'name3373707'; + $parent = 'parent-995424086'; $region = 'region-934795532'; $selfLink = 'selfLink-1691268851'; $shortName = 'shortName1565793390'; @@ -441,6 +442,7 @@ public function getTest() $expectedResponse->setKind($kind); $expectedResponse->setLabelFingerprint($labelFingerprint); $expectedResponse->setName($name); + $expectedResponse->setParent($parent); $expectedResponse->setRegion($region); $expectedResponse->setSelfLink($selfLink); $expectedResponse->setShortName($shortName); diff --git a/Compute/tests/Unit/V1/Client/WireGroupsClientTest.php b/Compute/tests/Unit/V1/Client/WireGroupsClientTest.php new file mode 100644 index 000000000000..2c618d39dec0 --- /dev/null +++ b/Compute/tests/Unit/V1/Client/WireGroupsClientTest.php @@ -0,0 +1,709 @@ +getMockBuilder(CredentialsWrapper::class) + ->disableOriginalConstructor() + ->getMock(); + } + + /** @return WireGroupsClient */ + private function createClient(array $options = []) + { + $options += [ + 'credentials' => $this->createCredentials(), + ]; + return new WireGroupsClient($options); + } + + /** @test */ + public function deleteTest() + { + $operationsTransport = $this->createTransport(); + $operationsClient = new GlobalOperationsClient([ + 'apiEndpoint' => '', + 'transport' => $operationsTransport, + 'credentials' => $this->createCredentials(), + ]); + $transport = $this->createTransport(); + $gapicClient = $this->createClient([ + 'transport' => $transport, + 'operationsClient' => $operationsClient, + ]); + $this->assertTrue($transport->isExhausted()); + $this->assertTrue($operationsTransport->isExhausted()); + // Mock response + $incompleteOperation = new Operation(); + $incompleteOperation->setName('customOperations/deleteTest'); + $incompleteOperation->setStatus(Status::RUNNING); + $transport->addResponse($incompleteOperation); + $completeOperation = new Operation(); + $completeOperation->setName('customOperations/deleteTest'); + $completeOperation->setStatus(Status::DONE); + $operationsTransport->addResponse($completeOperation); + // Mock request + $crossSiteNetwork = 'crossSiteNetwork-965549355'; + $project = 'project-309310695'; + $wireGroup = 'wireGroup659411525'; + $request = (new DeleteWireGroupRequest()) + ->setCrossSiteNetwork($crossSiteNetwork) + ->setProject($project) + ->setWireGroup($wireGroup); + $response = $gapicClient->delete($request); + $this->assertFalse($response->isDone()); + $apiRequests = $transport->popReceivedCalls(); + $this->assertSame(1, count($apiRequests)); + $operationsRequestsEmpty = $operationsTransport->popReceivedCalls(); + $this->assertSame(0, count($operationsRequestsEmpty)); + $actualApiFuncCall = $apiRequests[0]->getFuncCall(); + $actualApiRequestObject = $apiRequests[0]->getRequestObject(); + $this->assertSame('/google.cloud.compute.v1.WireGroups/Delete', $actualApiFuncCall); + $actualValue = $actualApiRequestObject->getCrossSiteNetwork(); + $this->assertProtobufEquals($crossSiteNetwork, $actualValue); + $actualValue = $actualApiRequestObject->getProject(); + $this->assertProtobufEquals($project, $actualValue); + $actualValue = $actualApiRequestObject->getWireGroup(); + $this->assertProtobufEquals($wireGroup, $actualValue); + $expectedOperationsRequestObject = new GetGlobalOperationRequest(); + $expectedOperationsRequestObject->setOperation($completeOperation->getName()); + $expectedOperationsRequestObject->setProject($project); + $response->pollUntilComplete([ + 'initialPollDelayMillis' => 1, + ]); + $this->assertTrue($response->isDone()); + $apiRequestsEmpty = $transport->popReceivedCalls(); + $this->assertSame(0, count($apiRequestsEmpty)); + $operationsRequests = $operationsTransport->popReceivedCalls(); + $this->assertSame(1, count($operationsRequests)); + $actualOperationsFuncCall = $operationsRequests[0]->getFuncCall(); + $actualOperationsRequestObject = $operationsRequests[0]->getRequestObject(); + $this->assertSame('/google.cloud.compute.v1.GlobalOperations/Get', $actualOperationsFuncCall); + $this->assertEquals($expectedOperationsRequestObject, $actualOperationsRequestObject); + $this->assertTrue($transport->isExhausted()); + $this->assertTrue($operationsTransport->isExhausted()); + } + + /** @test */ + public function deleteExceptionTest() + { + $operationsTransport = $this->createTransport(); + $operationsClient = new GlobalOperationsClient([ + 'apiEndpoint' => '', + 'transport' => $operationsTransport, + 'credentials' => $this->createCredentials(), + ]); + $transport = $this->createTransport(); + $gapicClient = $this->createClient([ + 'transport' => $transport, + 'operationsClient' => $operationsClient, + ]); + $this->assertTrue($transport->isExhausted()); + $this->assertTrue($operationsTransport->isExhausted()); + // Mock response + $incompleteOperation = new Operation(); + $incompleteOperation->setName('customOperations/deleteExceptionTest'); + $incompleteOperation->setStatus(Status::RUNNING); + $transport->addResponse($incompleteOperation); + $status = new stdClass(); + $status->code = Code::DATA_LOSS; + $status->details = 'internal error'; + $expectedExceptionMessage = json_encode( + [ + 'message' => 'internal error', + 'code' => Code::DATA_LOSS, + 'status' => 'DATA_LOSS', + 'details' => [], + ], + JSON_PRETTY_PRINT + ); + $operationsTransport->addResponse(null, $status); + // Mock request + $crossSiteNetwork = 'crossSiteNetwork-965549355'; + $project = 'project-309310695'; + $wireGroup = 'wireGroup659411525'; + $request = (new DeleteWireGroupRequest()) + ->setCrossSiteNetwork($crossSiteNetwork) + ->setProject($project) + ->setWireGroup($wireGroup); + $response = $gapicClient->delete($request); + $this->assertFalse($response->isDone()); + $this->assertNull($response->getResult()); + try { + $response->pollUntilComplete([ + 'initialPollDelayMillis' => 1, + ]); + // If the pollUntilComplete() method call did not throw, fail the test + $this->fail('Expected an ApiException, but no exception was thrown.'); + } catch (ApiException $ex) { + $this->assertEquals($status->code, $ex->getCode()); + $this->assertEquals($expectedExceptionMessage, $ex->getMessage()); + } + // Call popReceivedCalls to ensure the stubs are exhausted + $transport->popReceivedCalls(); + $operationsTransport->popReceivedCalls(); + $this->assertTrue($transport->isExhausted()); + $this->assertTrue($operationsTransport->isExhausted()); + } + + /** @test */ + public function getTest() + { + $transport = $this->createTransport(); + $gapicClient = $this->createClient([ + 'transport' => $transport, + ]); + $this->assertTrue($transport->isExhausted()); + // Mock response + $adminEnabled = false; + $creationTimestamp = 'creationTimestamp567396278'; + $description = 'description-1724546052'; + $id = 3355; + $kind = 'kind3292052'; + $name = 'name3373707'; + $reconciling = false; + $selfLink = 'selfLink-1691268851'; + $expectedResponse = new WireGroup(); + $expectedResponse->setAdminEnabled($adminEnabled); + $expectedResponse->setCreationTimestamp($creationTimestamp); + $expectedResponse->setDescription($description); + $expectedResponse->setId($id); + $expectedResponse->setKind($kind); + $expectedResponse->setName($name); + $expectedResponse->setReconciling($reconciling); + $expectedResponse->setSelfLink($selfLink); + $transport->addResponse($expectedResponse); + // Mock request + $crossSiteNetwork = 'crossSiteNetwork-965549355'; + $project = 'project-309310695'; + $wireGroup = 'wireGroup659411525'; + $request = (new GetWireGroupRequest()) + ->setCrossSiteNetwork($crossSiteNetwork) + ->setProject($project) + ->setWireGroup($wireGroup); + $response = $gapicClient->get($request); + $this->assertEquals($expectedResponse, $response); + $actualRequests = $transport->popReceivedCalls(); + $this->assertSame(1, count($actualRequests)); + $actualFuncCall = $actualRequests[0]->getFuncCall(); + $actualRequestObject = $actualRequests[0]->getRequestObject(); + $this->assertSame('/google.cloud.compute.v1.WireGroups/Get', $actualFuncCall); + $actualValue = $actualRequestObject->getCrossSiteNetwork(); + $this->assertProtobufEquals($crossSiteNetwork, $actualValue); + $actualValue = $actualRequestObject->getProject(); + $this->assertProtobufEquals($project, $actualValue); + $actualValue = $actualRequestObject->getWireGroup(); + $this->assertProtobufEquals($wireGroup, $actualValue); + $this->assertTrue($transport->isExhausted()); + } + + /** @test */ + public function getExceptionTest() + { + $transport = $this->createTransport(); + $gapicClient = $this->createClient([ + 'transport' => $transport, + ]); + $this->assertTrue($transport->isExhausted()); + $status = new stdClass(); + $status->code = Code::DATA_LOSS; + $status->details = 'internal error'; + $expectedExceptionMessage = json_encode( + [ + 'message' => 'internal error', + 'code' => Code::DATA_LOSS, + 'status' => 'DATA_LOSS', + 'details' => [], + ], + JSON_PRETTY_PRINT + ); + $transport->addResponse(null, $status); + // Mock request + $crossSiteNetwork = 'crossSiteNetwork-965549355'; + $project = 'project-309310695'; + $wireGroup = 'wireGroup659411525'; + $request = (new GetWireGroupRequest()) + ->setCrossSiteNetwork($crossSiteNetwork) + ->setProject($project) + ->setWireGroup($wireGroup); + try { + $gapicClient->get($request); + // If the $gapicClient method call did not throw, fail the test + $this->fail('Expected an ApiException, but no exception was thrown.'); + } catch (ApiException $ex) { + $this->assertEquals($status->code, $ex->getCode()); + $this->assertEquals($expectedExceptionMessage, $ex->getMessage()); + } + // Call popReceivedCalls to ensure the stub is exhausted + $transport->popReceivedCalls(); + $this->assertTrue($transport->isExhausted()); + } + + /** @test */ + public function insertTest() + { + $operationsTransport = $this->createTransport(); + $operationsClient = new GlobalOperationsClient([ + 'apiEndpoint' => '', + 'transport' => $operationsTransport, + 'credentials' => $this->createCredentials(), + ]); + $transport = $this->createTransport(); + $gapicClient = $this->createClient([ + 'transport' => $transport, + 'operationsClient' => $operationsClient, + ]); + $this->assertTrue($transport->isExhausted()); + $this->assertTrue($operationsTransport->isExhausted()); + // Mock response + $incompleteOperation = new Operation(); + $incompleteOperation->setName('customOperations/insertTest'); + $incompleteOperation->setStatus(Status::RUNNING); + $transport->addResponse($incompleteOperation); + $completeOperation = new Operation(); + $completeOperation->setName('customOperations/insertTest'); + $completeOperation->setStatus(Status::DONE); + $operationsTransport->addResponse($completeOperation); + // Mock request + $crossSiteNetwork = 'crossSiteNetwork-965549355'; + $project = 'project-309310695'; + $wireGroupResource = new WireGroup(); + $request = (new InsertWireGroupRequest()) + ->setCrossSiteNetwork($crossSiteNetwork) + ->setProject($project) + ->setWireGroupResource($wireGroupResource); + $response = $gapicClient->insert($request); + $this->assertFalse($response->isDone()); + $apiRequests = $transport->popReceivedCalls(); + $this->assertSame(1, count($apiRequests)); + $operationsRequestsEmpty = $operationsTransport->popReceivedCalls(); + $this->assertSame(0, count($operationsRequestsEmpty)); + $actualApiFuncCall = $apiRequests[0]->getFuncCall(); + $actualApiRequestObject = $apiRequests[0]->getRequestObject(); + $this->assertSame('/google.cloud.compute.v1.WireGroups/Insert', $actualApiFuncCall); + $actualValue = $actualApiRequestObject->getCrossSiteNetwork(); + $this->assertProtobufEquals($crossSiteNetwork, $actualValue); + $actualValue = $actualApiRequestObject->getProject(); + $this->assertProtobufEquals($project, $actualValue); + $actualValue = $actualApiRequestObject->getWireGroupResource(); + $this->assertProtobufEquals($wireGroupResource, $actualValue); + $expectedOperationsRequestObject = new GetGlobalOperationRequest(); + $expectedOperationsRequestObject->setOperation($completeOperation->getName()); + $expectedOperationsRequestObject->setProject($project); + $response->pollUntilComplete([ + 'initialPollDelayMillis' => 1, + ]); + $this->assertTrue($response->isDone()); + $apiRequestsEmpty = $transport->popReceivedCalls(); + $this->assertSame(0, count($apiRequestsEmpty)); + $operationsRequests = $operationsTransport->popReceivedCalls(); + $this->assertSame(1, count($operationsRequests)); + $actualOperationsFuncCall = $operationsRequests[0]->getFuncCall(); + $actualOperationsRequestObject = $operationsRequests[0]->getRequestObject(); + $this->assertSame('/google.cloud.compute.v1.GlobalOperations/Get', $actualOperationsFuncCall); + $this->assertEquals($expectedOperationsRequestObject, $actualOperationsRequestObject); + $this->assertTrue($transport->isExhausted()); + $this->assertTrue($operationsTransport->isExhausted()); + } + + /** @test */ + public function insertExceptionTest() + { + $operationsTransport = $this->createTransport(); + $operationsClient = new GlobalOperationsClient([ + 'apiEndpoint' => '', + 'transport' => $operationsTransport, + 'credentials' => $this->createCredentials(), + ]); + $transport = $this->createTransport(); + $gapicClient = $this->createClient([ + 'transport' => $transport, + 'operationsClient' => $operationsClient, + ]); + $this->assertTrue($transport->isExhausted()); + $this->assertTrue($operationsTransport->isExhausted()); + // Mock response + $incompleteOperation = new Operation(); + $incompleteOperation->setName('customOperations/insertExceptionTest'); + $incompleteOperation->setStatus(Status::RUNNING); + $transport->addResponse($incompleteOperation); + $status = new stdClass(); + $status->code = Code::DATA_LOSS; + $status->details = 'internal error'; + $expectedExceptionMessage = json_encode( + [ + 'message' => 'internal error', + 'code' => Code::DATA_LOSS, + 'status' => 'DATA_LOSS', + 'details' => [], + ], + JSON_PRETTY_PRINT + ); + $operationsTransport->addResponse(null, $status); + // Mock request + $crossSiteNetwork = 'crossSiteNetwork-965549355'; + $project = 'project-309310695'; + $wireGroupResource = new WireGroup(); + $request = (new InsertWireGroupRequest()) + ->setCrossSiteNetwork($crossSiteNetwork) + ->setProject($project) + ->setWireGroupResource($wireGroupResource); + $response = $gapicClient->insert($request); + $this->assertFalse($response->isDone()); + $this->assertNull($response->getResult()); + try { + $response->pollUntilComplete([ + 'initialPollDelayMillis' => 1, + ]); + // If the pollUntilComplete() method call did not throw, fail the test + $this->fail('Expected an ApiException, but no exception was thrown.'); + } catch (ApiException $ex) { + $this->assertEquals($status->code, $ex->getCode()); + $this->assertEquals($expectedExceptionMessage, $ex->getMessage()); + } + // Call popReceivedCalls to ensure the stubs are exhausted + $transport->popReceivedCalls(); + $operationsTransport->popReceivedCalls(); + $this->assertTrue($transport->isExhausted()); + $this->assertTrue($operationsTransport->isExhausted()); + } + + /** @test */ + public function listTest() + { + $transport = $this->createTransport(); + $gapicClient = $this->createClient([ + 'transport' => $transport, + ]); + $this->assertTrue($transport->isExhausted()); + // Mock response + $etag = 'etag3123477'; + $id = 'id3355'; + $kind = 'kind3292052'; + $nextPageToken = ''; + $selfLink = 'selfLink-1691268851'; + $itemsElement = new WireGroup(); + $items = [$itemsElement]; + $expectedResponse = new WireGroupList(); + $expectedResponse->setEtag($etag); + $expectedResponse->setId($id); + $expectedResponse->setKind($kind); + $expectedResponse->setNextPageToken($nextPageToken); + $expectedResponse->setSelfLink($selfLink); + $expectedResponse->setItems($items); + $transport->addResponse($expectedResponse); + // Mock request + $crossSiteNetwork = 'crossSiteNetwork-965549355'; + $project = 'project-309310695'; + $request = (new ListWireGroupsRequest())->setCrossSiteNetwork($crossSiteNetwork)->setProject($project); + $response = $gapicClient->list($request); + $this->assertEquals($expectedResponse, $response->getPage()->getResponseObject()); + $resources = iterator_to_array($response->iterateAllElements()); + $this->assertSame(1, count($resources)); + $this->assertEquals($expectedResponse->getItems()[0], $resources[0]); + $actualRequests = $transport->popReceivedCalls(); + $this->assertSame(1, count($actualRequests)); + $actualFuncCall = $actualRequests[0]->getFuncCall(); + $actualRequestObject = $actualRequests[0]->getRequestObject(); + $this->assertSame('/google.cloud.compute.v1.WireGroups/List', $actualFuncCall); + $actualValue = $actualRequestObject->getCrossSiteNetwork(); + $this->assertProtobufEquals($crossSiteNetwork, $actualValue); + $actualValue = $actualRequestObject->getProject(); + $this->assertProtobufEquals($project, $actualValue); + $this->assertTrue($transport->isExhausted()); + } + + /** @test */ + public function listExceptionTest() + { + $transport = $this->createTransport(); + $gapicClient = $this->createClient([ + 'transport' => $transport, + ]); + $this->assertTrue($transport->isExhausted()); + $status = new stdClass(); + $status->code = Code::DATA_LOSS; + $status->details = 'internal error'; + $expectedExceptionMessage = json_encode( + [ + 'message' => 'internal error', + 'code' => Code::DATA_LOSS, + 'status' => 'DATA_LOSS', + 'details' => [], + ], + JSON_PRETTY_PRINT + ); + $transport->addResponse(null, $status); + // Mock request + $crossSiteNetwork = 'crossSiteNetwork-965549355'; + $project = 'project-309310695'; + $request = (new ListWireGroupsRequest())->setCrossSiteNetwork($crossSiteNetwork)->setProject($project); + try { + $gapicClient->list($request); + // If the $gapicClient method call did not throw, fail the test + $this->fail('Expected an ApiException, but no exception was thrown.'); + } catch (ApiException $ex) { + $this->assertEquals($status->code, $ex->getCode()); + $this->assertEquals($expectedExceptionMessage, $ex->getMessage()); + } + // Call popReceivedCalls to ensure the stub is exhausted + $transport->popReceivedCalls(); + $this->assertTrue($transport->isExhausted()); + } + + /** @test */ + public function patchTest() + { + $operationsTransport = $this->createTransport(); + $operationsClient = new GlobalOperationsClient([ + 'apiEndpoint' => '', + 'transport' => $operationsTransport, + 'credentials' => $this->createCredentials(), + ]); + $transport = $this->createTransport(); + $gapicClient = $this->createClient([ + 'transport' => $transport, + 'operationsClient' => $operationsClient, + ]); + $this->assertTrue($transport->isExhausted()); + $this->assertTrue($operationsTransport->isExhausted()); + // Mock response + $incompleteOperation = new Operation(); + $incompleteOperation->setName('customOperations/patchTest'); + $incompleteOperation->setStatus(Status::RUNNING); + $transport->addResponse($incompleteOperation); + $completeOperation = new Operation(); + $completeOperation->setName('customOperations/patchTest'); + $completeOperation->setStatus(Status::DONE); + $operationsTransport->addResponse($completeOperation); + // Mock request + $crossSiteNetwork = 'crossSiteNetwork-965549355'; + $project = 'project-309310695'; + $wireGroup = 'wireGroup659411525'; + $wireGroupResource = new WireGroup(); + $request = (new PatchWireGroupRequest()) + ->setCrossSiteNetwork($crossSiteNetwork) + ->setProject($project) + ->setWireGroup($wireGroup) + ->setWireGroupResource($wireGroupResource); + $response = $gapicClient->patch($request); + $this->assertFalse($response->isDone()); + $apiRequests = $transport->popReceivedCalls(); + $this->assertSame(1, count($apiRequests)); + $operationsRequestsEmpty = $operationsTransport->popReceivedCalls(); + $this->assertSame(0, count($operationsRequestsEmpty)); + $actualApiFuncCall = $apiRequests[0]->getFuncCall(); + $actualApiRequestObject = $apiRequests[0]->getRequestObject(); + $this->assertSame('/google.cloud.compute.v1.WireGroups/Patch', $actualApiFuncCall); + $actualValue = $actualApiRequestObject->getCrossSiteNetwork(); + $this->assertProtobufEquals($crossSiteNetwork, $actualValue); + $actualValue = $actualApiRequestObject->getProject(); + $this->assertProtobufEquals($project, $actualValue); + $actualValue = $actualApiRequestObject->getWireGroup(); + $this->assertProtobufEquals($wireGroup, $actualValue); + $actualValue = $actualApiRequestObject->getWireGroupResource(); + $this->assertProtobufEquals($wireGroupResource, $actualValue); + $expectedOperationsRequestObject = new GetGlobalOperationRequest(); + $expectedOperationsRequestObject->setOperation($completeOperation->getName()); + $expectedOperationsRequestObject->setProject($project); + $response->pollUntilComplete([ + 'initialPollDelayMillis' => 1, + ]); + $this->assertTrue($response->isDone()); + $apiRequestsEmpty = $transport->popReceivedCalls(); + $this->assertSame(0, count($apiRequestsEmpty)); + $operationsRequests = $operationsTransport->popReceivedCalls(); + $this->assertSame(1, count($operationsRequests)); + $actualOperationsFuncCall = $operationsRequests[0]->getFuncCall(); + $actualOperationsRequestObject = $operationsRequests[0]->getRequestObject(); + $this->assertSame('/google.cloud.compute.v1.GlobalOperations/Get', $actualOperationsFuncCall); + $this->assertEquals($expectedOperationsRequestObject, $actualOperationsRequestObject); + $this->assertTrue($transport->isExhausted()); + $this->assertTrue($operationsTransport->isExhausted()); + } + + /** @test */ + public function patchExceptionTest() + { + $operationsTransport = $this->createTransport(); + $operationsClient = new GlobalOperationsClient([ + 'apiEndpoint' => '', + 'transport' => $operationsTransport, + 'credentials' => $this->createCredentials(), + ]); + $transport = $this->createTransport(); + $gapicClient = $this->createClient([ + 'transport' => $transport, + 'operationsClient' => $operationsClient, + ]); + $this->assertTrue($transport->isExhausted()); + $this->assertTrue($operationsTransport->isExhausted()); + // Mock response + $incompleteOperation = new Operation(); + $incompleteOperation->setName('customOperations/patchExceptionTest'); + $incompleteOperation->setStatus(Status::RUNNING); + $transport->addResponse($incompleteOperation); + $status = new stdClass(); + $status->code = Code::DATA_LOSS; + $status->details = 'internal error'; + $expectedExceptionMessage = json_encode( + [ + 'message' => 'internal error', + 'code' => Code::DATA_LOSS, + 'status' => 'DATA_LOSS', + 'details' => [], + ], + JSON_PRETTY_PRINT + ); + $operationsTransport->addResponse(null, $status); + // Mock request + $crossSiteNetwork = 'crossSiteNetwork-965549355'; + $project = 'project-309310695'; + $wireGroup = 'wireGroup659411525'; + $wireGroupResource = new WireGroup(); + $request = (new PatchWireGroupRequest()) + ->setCrossSiteNetwork($crossSiteNetwork) + ->setProject($project) + ->setWireGroup($wireGroup) + ->setWireGroupResource($wireGroupResource); + $response = $gapicClient->patch($request); + $this->assertFalse($response->isDone()); + $this->assertNull($response->getResult()); + try { + $response->pollUntilComplete([ + 'initialPollDelayMillis' => 1, + ]); + // If the pollUntilComplete() method call did not throw, fail the test + $this->fail('Expected an ApiException, but no exception was thrown.'); + } catch (ApiException $ex) { + $this->assertEquals($status->code, $ex->getCode()); + $this->assertEquals($expectedExceptionMessage, $ex->getMessage()); + } + // Call popReceivedCalls to ensure the stubs are exhausted + $transport->popReceivedCalls(); + $operationsTransport->popReceivedCalls(); + $this->assertTrue($transport->isExhausted()); + $this->assertTrue($operationsTransport->isExhausted()); + } + + /** @test */ + public function deleteAsyncTest() + { + $operationsTransport = $this->createTransport(); + $operationsClient = new GlobalOperationsClient([ + 'apiEndpoint' => '', + 'transport' => $operationsTransport, + 'credentials' => $this->createCredentials(), + ]); + $transport = $this->createTransport(); + $gapicClient = $this->createClient([ + 'transport' => $transport, + 'operationsClient' => $operationsClient, + ]); + $this->assertTrue($transport->isExhausted()); + $this->assertTrue($operationsTransport->isExhausted()); + // Mock response + $incompleteOperation = new Operation(); + $incompleteOperation->setName('customOperations/deleteAsyncTest'); + $incompleteOperation->setStatus(Status::RUNNING); + $transport->addResponse($incompleteOperation); + $completeOperation = new Operation(); + $completeOperation->setName('customOperations/deleteAsyncTest'); + $completeOperation->setStatus(Status::DONE); + $operationsTransport->addResponse($completeOperation); + // Mock request + $crossSiteNetwork = 'crossSiteNetwork-965549355'; + $project = 'project-309310695'; + $wireGroup = 'wireGroup659411525'; + $request = (new DeleteWireGroupRequest()) + ->setCrossSiteNetwork($crossSiteNetwork) + ->setProject($project) + ->setWireGroup($wireGroup); + $response = $gapicClient->delete($request); + $this->assertFalse($response->isDone()); + $apiRequests = $transport->popReceivedCalls(); + $this->assertSame(1, count($apiRequests)); + $operationsRequestsEmpty = $operationsTransport->popReceivedCalls(); + $this->assertSame(0, count($operationsRequestsEmpty)); + $actualApiFuncCall = $apiRequests[0]->getFuncCall(); + $actualApiRequestObject = $apiRequests[0]->getRequestObject(); + $this->assertSame('/google.cloud.compute.v1.WireGroups/Delete', $actualApiFuncCall); + $actualValue = $actualApiRequestObject->getCrossSiteNetwork(); + $this->assertProtobufEquals($crossSiteNetwork, $actualValue); + $actualValue = $actualApiRequestObject->getProject(); + $this->assertProtobufEquals($project, $actualValue); + $actualValue = $actualApiRequestObject->getWireGroup(); + $this->assertProtobufEquals($wireGroup, $actualValue); + $expectedOperationsRequestObject = new GetGlobalOperationRequest(); + $expectedOperationsRequestObject->setOperation($completeOperation->getName()); + $expectedOperationsRequestObject->setProject($project); + $response->pollUntilComplete([ + 'initialPollDelayMillis' => 1, + ]); + $this->assertTrue($response->isDone()); + $apiRequestsEmpty = $transport->popReceivedCalls(); + $this->assertSame(0, count($apiRequestsEmpty)); + $operationsRequests = $operationsTransport->popReceivedCalls(); + $this->assertSame(1, count($operationsRequests)); + $actualOperationsFuncCall = $operationsRequests[0]->getFuncCall(); + $actualOperationsRequestObject = $operationsRequests[0]->getRequestObject(); + $this->assertSame('/google.cloud.compute.v1.GlobalOperations/Get', $actualOperationsFuncCall); + $this->assertEquals($expectedOperationsRequestObject, $actualOperationsRequestObject); + $this->assertTrue($transport->isExhausted()); + $this->assertTrue($operationsTransport->isExhausted()); + } +} diff --git a/Core/src/CallTrait.php b/Core/src/CallTrait.php deleted file mode 100644 index dd7485f52134..000000000000 --- a/Core/src/CallTrait.php +++ /dev/null @@ -1,40 +0,0 @@ -info()[$name])) { - trigger_error(sprintf( - 'Call to undefined method %s::%s', - __CLASS__, - $name - ), E_USER_ERROR); - } - - return $this->info()[$name]; - } -} diff --git a/Core/src/Report/CloudRunJobMetadataProvider.php b/Core/src/Report/CloudRunJobMetadataProvider.php index fe8d94ef4cbd..234aefb46f3d 100644 --- a/Core/src/Report/CloudRunJobMetadataProvider.php +++ b/Core/src/Report/CloudRunJobMetadataProvider.php @@ -80,7 +80,7 @@ public function __construct(array $env, ?Metadata $metadata = null) : null; $this->metadata = $metadata ?? new Metadata(); - $this->region = \basename($this->metadata->get('instance/region')); + $this->region = \basename($this->metadata->get('instance/region') ?? ''); $this->instanceId = $this->metadata->get('instance/id'); } diff --git a/Core/src/Report/CloudRunServiceMetadataProvider.php b/Core/src/Report/CloudRunServiceMetadataProvider.php index ece4061fd1ac..66bc824c4270 100644 --- a/Core/src/Report/CloudRunServiceMetadataProvider.php +++ b/Core/src/Report/CloudRunServiceMetadataProvider.php @@ -73,7 +73,7 @@ public function __construct(array $env, ?Metadata $metadata = null) : null; $this->metadata = $metadata ?? new Metadata(); - $this->region = \basename($this->metadata->get('instance/region')); + $this->region = \basename($this->metadata->get('instance/region') ?? ''); $this->instanceId = $this->metadata->get('instance/id'); } diff --git a/Core/tests/Unit/CallTraitTest.php b/Core/tests/Unit/CallTraitTest.php deleted file mode 100644 index a1bf7096ccc9..000000000000 --- a/Core/tests/Unit/CallTraitTest.php +++ /dev/null @@ -1,64 +0,0 @@ - 'bar']); - - $this->assertEquals('bar', $t->foo()); - } - - public function testErr() - { - set_error_handler(static function (int $errno, string $errstr): never { - throw new Exception($errstr, $errno); - }, E_USER_ERROR); - $this->expectException(Exception::class); - - $t = new CallTraitStub(['foo' => 'bar']); - - $t->bar(); - } -} - -//@codingStandardsIgnoreStart -class CallTraitStub -{ - use CallTrait; - - public function __construct(array $data) - { - $this->info = $data; - } - - public function info() - { - return $this->info; - } -} -//@codingStandardsIgnoreEnd diff --git a/Core/tests/Unit/RequestBuilderTest.php b/Core/tests/Unit/RequestBuilderTest.php index 53349573317a..98f7c6e6cbe5 100644 --- a/Core/tests/Unit/RequestBuilderTest.php +++ b/Core/tests/Unit/RequestBuilderTest.php @@ -27,6 +27,8 @@ */ class RequestBuilderTest extends TestCase { + public $builder; + public function setUp(): void { $this->builder = new RequestBuilder( diff --git a/Core/tests/Unit/SysvTraitTest.php b/Core/tests/Unit/SysvTraitTest.php index 9862b8c9882e..e566acb200a2 100644 --- a/Core/tests/Unit/SysvTraitTest.php +++ b/Core/tests/Unit/SysvTraitTest.php @@ -26,6 +26,8 @@ */ class SysvTraitTest extends TestCase { + public $impl; + public function setUp(): void { $this->impl = TestHelpers::impl(SysvTrait::class); diff --git a/Eventarc/metadata/V1/GoogleApiSource.php b/Eventarc/metadata/V1/GoogleApiSource.php index 2d3a1acb1c57..4279b7d84478 100644 Binary files a/Eventarc/metadata/V1/GoogleApiSource.php and b/Eventarc/metadata/V1/GoogleApiSource.php differ diff --git a/Eventarc/metadata/V1/Trigger.php b/Eventarc/metadata/V1/Trigger.php index eb525c86b192..faad974e9845 100644 Binary files a/Eventarc/metadata/V1/Trigger.php and b/Eventarc/metadata/V1/Trigger.php differ diff --git a/Eventarc/src/V1/Client/EventarcClient.php b/Eventarc/src/V1/Client/EventarcClient.php index 8ccb37e02377..7bd25270a833 100644 --- a/Eventarc/src/V1/Client/EventarcClient.php +++ b/Eventarc/src/V1/Client/EventarcClient.php @@ -178,9 +178,7 @@ final class EventarcClient private const CODEGEN_NAME = 'gapic'; /** The default scopes required by the service. */ - public static $serviceScopes = [ - 'https://www.googleapis.com/auth/cloud-platform', - ]; + public static $serviceScopes = ['https://www.googleapis.com/auth/cloud-platform']; private $operationsClient; @@ -721,8 +719,10 @@ public function createChannel(CreateChannelRequest $request, array $callOptions * * @throws ApiException Thrown if the API call fails. */ - public function createChannelConnection(CreateChannelConnectionRequest $request, array $callOptions = []): OperationResponse - { + public function createChannelConnection( + CreateChannelConnectionRequest $request, + array $callOptions = [] + ): OperationResponse { return $this->startApiCall('CreateChannelConnection', $request, $callOptions)->wait(); } @@ -773,8 +773,10 @@ public function createEnrollment(CreateEnrollmentRequest $request, array $callOp * * @throws ApiException Thrown if the API call fails. */ - public function createGoogleApiSource(CreateGoogleApiSourceRequest $request, array $callOptions = []): OperationResponse - { + public function createGoogleApiSource( + CreateGoogleApiSourceRequest $request, + array $callOptions = [] + ): OperationResponse { return $this->startApiCall('CreateGoogleApiSource', $request, $callOptions)->wait(); } @@ -903,8 +905,10 @@ public function deleteChannel(DeleteChannelRequest $request, array $callOptions * * @throws ApiException Thrown if the API call fails. */ - public function deleteChannelConnection(DeleteChannelConnectionRequest $request, array $callOptions = []): OperationResponse - { + public function deleteChannelConnection( + DeleteChannelConnectionRequest $request, + array $callOptions = [] + ): OperationResponse { return $this->startApiCall('DeleteChannelConnection', $request, $callOptions)->wait(); } @@ -955,8 +959,10 @@ public function deleteEnrollment(DeleteEnrollmentRequest $request, array $callOp * * @throws ApiException Thrown if the API call fails. */ - public function deleteGoogleApiSource(DeleteGoogleApiSourceRequest $request, array $callOptions = []): OperationResponse - { + public function deleteGoogleApiSource( + DeleteGoogleApiSourceRequest $request, + array $callOptions = [] + ): OperationResponse { return $this->startApiCall('DeleteGoogleApiSource', $request, $callOptions)->wait(); } @@ -1085,8 +1091,10 @@ public function getChannel(GetChannelRequest $request, array $callOptions = []): * * @throws ApiException Thrown if the API call fails. */ - public function getChannelConnection(GetChannelConnectionRequest $request, array $callOptions = []): ChannelConnection - { + public function getChannelConnection( + GetChannelConnectionRequest $request, + array $callOptions = [] + ): ChannelConnection { return $this->startApiCall('GetChannelConnection', $request, $callOptions)->wait(); } @@ -1165,8 +1173,10 @@ public function getGoogleApiSource(GetGoogleApiSourceRequest $request, array $ca * * @throws ApiException Thrown if the API call fails. */ - public function getGoogleChannelConfig(GetGoogleChannelConfigRequest $request, array $callOptions = []): GoogleChannelConfig - { + public function getGoogleChannelConfig( + GetGoogleChannelConfigRequest $request, + array $callOptions = [] + ): GoogleChannelConfig { return $this->startApiCall('GetGoogleChannelConfig', $request, $callOptions)->wait(); } @@ -1295,8 +1305,10 @@ public function getTrigger(GetTriggerRequest $request, array $callOptions = []): * * @throws ApiException Thrown if the API call fails. */ - public function listChannelConnections(ListChannelConnectionsRequest $request, array $callOptions = []): PagedListResponse - { + public function listChannelConnections( + ListChannelConnectionsRequest $request, + array $callOptions = [] + ): PagedListResponse { return $this->startApiCall('ListChannelConnections', $request, $callOptions); } @@ -1373,8 +1385,10 @@ public function listEnrollments(ListEnrollmentsRequest $request, array $callOpti * * @throws ApiException Thrown if the API call fails. */ - public function listGoogleApiSources(ListGoogleApiSourcesRequest $request, array $callOptions = []): PagedListResponse - { + public function listGoogleApiSources( + ListGoogleApiSourcesRequest $request, + array $callOptions = [] + ): PagedListResponse { return $this->startApiCall('ListGoogleApiSources', $request, $callOptions); } @@ -1399,8 +1413,10 @@ public function listGoogleApiSources(ListGoogleApiSourcesRequest $request, array * * @throws ApiException Thrown if the API call fails. */ - public function listMessageBusEnrollments(ListMessageBusEnrollmentsRequest $request, array $callOptions = []): PagedListResponse - { + public function listMessageBusEnrollments( + ListMessageBusEnrollmentsRequest $request, + array $callOptions = [] + ): PagedListResponse { return $this->startApiCall('ListMessageBusEnrollments', $request, $callOptions); } @@ -1581,8 +1597,10 @@ public function updateEnrollment(UpdateEnrollmentRequest $request, array $callOp * * @throws ApiException Thrown if the API call fails. */ - public function updateGoogleApiSource(UpdateGoogleApiSourceRequest $request, array $callOptions = []): OperationResponse - { + public function updateGoogleApiSource( + UpdateGoogleApiSourceRequest $request, + array $callOptions = [] + ): OperationResponse { return $this->startApiCall('UpdateGoogleApiSource', $request, $callOptions)->wait(); } @@ -1607,8 +1625,10 @@ public function updateGoogleApiSource(UpdateGoogleApiSourceRequest $request, arr * * @throws ApiException Thrown if the API call fails. */ - public function updateGoogleChannelConfig(UpdateGoogleChannelConfigRequest $request, array $callOptions = []): GoogleChannelConfig - { + public function updateGoogleChannelConfig( + UpdateGoogleChannelConfigRequest $request, + array $callOptions = [] + ): GoogleChannelConfig { return $this->startApiCall('UpdateGoogleChannelConfig', $request, $callOptions)->wait(); } @@ -1826,8 +1846,10 @@ public function setIamPolicy(SetIamPolicyRequest $request, array $callOptions = * * @throws ApiException Thrown if the API call fails. */ - public function testIamPermissions(TestIamPermissionsRequest $request, array $callOptions = []): TestIamPermissionsResponse - { + public function testIamPermissions( + TestIamPermissionsRequest $request, + array $callOptions = [] + ): TestIamPermissionsResponse { return $this->startApiCall('TestIamPermissions', $request, $callOptions)->wait(); } } diff --git a/Eventarc/src/V1/GoogleApiSource.php b/Eventarc/src/V1/GoogleApiSource.php index 4ddd79e5c6a8..de11e800b333 100644 --- a/Eventarc/src/V1/GoogleApiSource.php +++ b/Eventarc/src/V1/GoogleApiSource.php @@ -92,6 +92,7 @@ class GoogleApiSource extends \Google\Protobuf\Internal\Message * Generated from protobuf field .google.cloud.eventarc.v1.LoggingConfig logging_config = 11 [(.google.api.field_behavior) = OPTIONAL]; */ protected $logging_config = null; + protected $wide_scope_subscription; /** * Constructor. @@ -132,6 +133,13 @@ class GoogleApiSource extends \Google\Protobuf\Internal\Message * `projects/*/locations/*/keyRings/*/cryptoKeys/*`. * @type \Google\Cloud\Eventarc\V1\LoggingConfig $logging_config * Optional. Config to control Platform logging for the GoogleApiSource. + * @type \Google\Cloud\Eventarc\V1\GoogleApiSource\OrganizationSubscription $organization_subscription + * Optional. Config to enable subscribing to events from all projects in the + * GoogleApiSource's org. + * @type \Google\Cloud\Eventarc\V1\GoogleApiSource\ProjectSubscriptions $project_subscriptions + * Optional. Config to enable subscribing to all events from a list of + * projects. + * All the projects must be in the same org as the GoogleApiSource. * } */ public function __construct($data = NULL) { @@ -477,5 +485,81 @@ public function setLoggingConfig($var) return $this; } + /** + * Optional. Config to enable subscribing to events from all projects in the + * GoogleApiSource's org. + * + * Generated from protobuf field .google.cloud.eventarc.v1.GoogleApiSource.OrganizationSubscription organization_subscription = 12 [(.google.api.field_behavior) = OPTIONAL]; + * @return \Google\Cloud\Eventarc\V1\GoogleApiSource\OrganizationSubscription|null + */ + public function getOrganizationSubscription() + { + return $this->readOneof(12); + } + + public function hasOrganizationSubscription() + { + return $this->hasOneof(12); + } + + /** + * Optional. Config to enable subscribing to events from all projects in the + * GoogleApiSource's org. + * + * Generated from protobuf field .google.cloud.eventarc.v1.GoogleApiSource.OrganizationSubscription organization_subscription = 12 [(.google.api.field_behavior) = OPTIONAL]; + * @param \Google\Cloud\Eventarc\V1\GoogleApiSource\OrganizationSubscription $var + * @return $this + */ + public function setOrganizationSubscription($var) + { + GPBUtil::checkMessage($var, \Google\Cloud\Eventarc\V1\GoogleApiSource\OrganizationSubscription::class); + $this->writeOneof(12, $var); + + return $this; + } + + /** + * Optional. Config to enable subscribing to all events from a list of + * projects. + * All the projects must be in the same org as the GoogleApiSource. + * + * Generated from protobuf field .google.cloud.eventarc.v1.GoogleApiSource.ProjectSubscriptions project_subscriptions = 13 [(.google.api.field_behavior) = OPTIONAL]; + * @return \Google\Cloud\Eventarc\V1\GoogleApiSource\ProjectSubscriptions|null + */ + public function getProjectSubscriptions() + { + return $this->readOneof(13); + } + + public function hasProjectSubscriptions() + { + return $this->hasOneof(13); + } + + /** + * Optional. Config to enable subscribing to all events from a list of + * projects. + * All the projects must be in the same org as the GoogleApiSource. + * + * Generated from protobuf field .google.cloud.eventarc.v1.GoogleApiSource.ProjectSubscriptions project_subscriptions = 13 [(.google.api.field_behavior) = OPTIONAL]; + * @param \Google\Cloud\Eventarc\V1\GoogleApiSource\ProjectSubscriptions $var + * @return $this + */ + public function setProjectSubscriptions($var) + { + GPBUtil::checkMessage($var, \Google\Cloud\Eventarc\V1\GoogleApiSource\ProjectSubscriptions::class); + $this->writeOneof(13, $var); + + return $this; + } + + /** + * @return string + */ + public function getWideScopeSubscription() + { + return $this->whichOneof("wide_scope_subscription"); + } + } diff --git a/Eventarc/src/V1/GoogleApiSource/OrganizationSubscription.php b/Eventarc/src/V1/GoogleApiSource/OrganizationSubscription.php new file mode 100644 index 000000000000..11399c1456eb --- /dev/null +++ b/Eventarc/src/V1/GoogleApiSource/OrganizationSubscription.php @@ -0,0 +1,68 @@ +google.cloud.eventarc.v1.GoogleApiSource.OrganizationSubscription + */ +class OrganizationSubscription extends \Google\Protobuf\Internal\Message +{ + /** + * Required. Enable org level subscription. + * + * Generated from protobuf field bool enabled = 1 [(.google.api.field_behavior) = REQUIRED]; + */ + protected $enabled = false; + + /** + * Constructor. + * + * @param array $data { + * Optional. Data for populating the Message object. + * + * @type bool $enabled + * Required. Enable org level subscription. + * } + */ + public function __construct($data = NULL) { + \GPBMetadata\Google\Cloud\Eventarc\V1\GoogleApiSource::initOnce(); + parent::__construct($data); + } + + /** + * Required. Enable org level subscription. + * + * Generated from protobuf field bool enabled = 1 [(.google.api.field_behavior) = REQUIRED]; + * @return bool + */ + public function getEnabled() + { + return $this->enabled; + } + + /** + * Required. Enable org level subscription. + * + * Generated from protobuf field bool enabled = 1 [(.google.api.field_behavior) = REQUIRED]; + * @param bool $var + * @return $this + */ + public function setEnabled($var) + { + GPBUtil::checkBool($var); + $this->enabled = $var; + + return $this; + } + +} + + diff --git a/Eventarc/src/V1/GoogleApiSource/ProjectSubscriptions.php b/Eventarc/src/V1/GoogleApiSource/ProjectSubscriptions.php new file mode 100644 index 000000000000..bbc3551622e3 --- /dev/null +++ b/Eventarc/src/V1/GoogleApiSource/ProjectSubscriptions.php @@ -0,0 +1,84 @@ +google.cloud.eventarc.v1.GoogleApiSource.ProjectSubscriptions + */ +class ProjectSubscriptions extends \Google\Protobuf\Internal\Message +{ + /** + * Required. A list of projects to receive events from. + * All the projects must be in the same org. The listed projects should have + * the format project/{identifier} where identifier can be either the + * project id for project number. A single list may contain both formats. At + * most 100 projects can be listed. + * + * Generated from protobuf field repeated string list = 1 [(.google.api.field_behavior) = REQUIRED]; + */ + private $list; + + /** + * Constructor. + * + * @param array $data { + * Optional. Data for populating the Message object. + * + * @type array|\Google\Protobuf\Internal\RepeatedField $list + * Required. A list of projects to receive events from. + * All the projects must be in the same org. The listed projects should have + * the format project/{identifier} where identifier can be either the + * project id for project number. A single list may contain both formats. At + * most 100 projects can be listed. + * } + */ + public function __construct($data = NULL) { + \GPBMetadata\Google\Cloud\Eventarc\V1\GoogleApiSource::initOnce(); + parent::__construct($data); + } + + /** + * Required. A list of projects to receive events from. + * All the projects must be in the same org. The listed projects should have + * the format project/{identifier} where identifier can be either the + * project id for project number. A single list may contain both formats. At + * most 100 projects can be listed. + * + * Generated from protobuf field repeated string list = 1 [(.google.api.field_behavior) = REQUIRED]; + * @return \Google\Protobuf\Internal\RepeatedField + */ + public function getList() + { + return $this->list; + } + + /** + * Required. A list of projects to receive events from. + * All the projects must be in the same org. The listed projects should have + * the format project/{identifier} where identifier can be either the + * project id for project number. A single list may contain both formats. At + * most 100 projects can be listed. + * + * Generated from protobuf field repeated string list = 1 [(.google.api.field_behavior) = REQUIRED]; + * @param array|\Google\Protobuf\Internal\RepeatedField $var + * @return $this + */ + public function setList($var) + { + $arr = GPBUtil::checkRepeatedField($var, \Google\Protobuf\Internal\GPBType::STRING); + $this->list = $arr; + + return $this; + } + +} + + diff --git a/Eventarc/src/V1/Trigger.php b/Eventarc/src/V1/Trigger.php index 9a7a92ad8544..fdb60379e7ce 100644 --- a/Eventarc/src/V1/Trigger.php +++ b/Eventarc/src/V1/Trigger.php @@ -114,6 +114,14 @@ class Trigger extends \Google\Protobuf\Internal\Message * Generated from protobuf field bool satisfies_pzs = 19 [(.google.api.field_behavior) = OUTPUT_ONLY]; */ protected $satisfies_pzs = false; + /** + * Optional. The retry policy to use in the Trigger. + * If unset, event delivery will be retried for up to 24 hours by default: + * https://cloud.google.com/eventarc/docs/retry-events + * + * Generated from protobuf field .google.cloud.eventarc.v1.Trigger.RetryPolicy retry_policy = 20 [(.google.api.field_behavior) = OPTIONAL]; + */ + protected $retry_policy = null; /** * Output only. This checksum is computed by the server based on the value of * other fields, and might be sent only on create requests to ensure that the @@ -176,6 +184,10 @@ class Trigger extends \Google\Protobuf\Internal\Message * @type bool $satisfies_pzs * Output only. Whether or not this Trigger satisfies the requirements of * physical zone separation + * @type \Google\Cloud\Eventarc\V1\Trigger\RetryPolicy $retry_policy + * Optional. The retry policy to use in the Trigger. + * If unset, event delivery will be retried for up to 24 hours by default: + * https://cloud.google.com/eventarc/docs/retry-events * @type string $etag * Output only. This checksum is computed by the server based on the value of * other fields, and might be sent only on create requests to ensure that the @@ -607,6 +619,46 @@ public function setSatisfiesPzs($var) return $this; } + /** + * Optional. The retry policy to use in the Trigger. + * If unset, event delivery will be retried for up to 24 hours by default: + * https://cloud.google.com/eventarc/docs/retry-events + * + * Generated from protobuf field .google.cloud.eventarc.v1.Trigger.RetryPolicy retry_policy = 20 [(.google.api.field_behavior) = OPTIONAL]; + * @return \Google\Cloud\Eventarc\V1\Trigger\RetryPolicy|null + */ + public function getRetryPolicy() + { + return $this->retry_policy; + } + + public function hasRetryPolicy() + { + return isset($this->retry_policy); + } + + public function clearRetryPolicy() + { + unset($this->retry_policy); + } + + /** + * Optional. The retry policy to use in the Trigger. + * If unset, event delivery will be retried for up to 24 hours by default: + * https://cloud.google.com/eventarc/docs/retry-events + * + * Generated from protobuf field .google.cloud.eventarc.v1.Trigger.RetryPolicy retry_policy = 20 [(.google.api.field_behavior) = OPTIONAL]; + * @param \Google\Cloud\Eventarc\V1\Trigger\RetryPolicy $var + * @return $this + */ + public function setRetryPolicy($var) + { + GPBUtil::checkMessage($var, \Google\Cloud\Eventarc\V1\Trigger\RetryPolicy::class); + $this->retry_policy = $var; + + return $this; + } + /** * Output only. This checksum is computed by the server based on the value of * other fields, and might be sent only on create requests to ensure that the diff --git a/Eventarc/src/V1/Trigger/RetryPolicy.php b/Eventarc/src/V1/Trigger/RetryPolicy.php new file mode 100644 index 000000000000..603b6eb18276 --- /dev/null +++ b/Eventarc/src/V1/Trigger/RetryPolicy.php @@ -0,0 +1,73 @@ +google.cloud.eventarc.v1.Trigger.RetryPolicy + */ +class RetryPolicy extends \Google\Protobuf\Internal\Message +{ + /** + * Optional. The maximum number of delivery attempts for any message. The + * only valid value is 1. + * + * Generated from protobuf field int32 max_attempts = 1 [(.google.api.field_behavior) = OPTIONAL]; + */ + protected $max_attempts = 0; + + /** + * Constructor. + * + * @param array $data { + * Optional. Data for populating the Message object. + * + * @type int $max_attempts + * Optional. The maximum number of delivery attempts for any message. The + * only valid value is 1. + * } + */ + public function __construct($data = NULL) { + \GPBMetadata\Google\Cloud\Eventarc\V1\Trigger::initOnce(); + parent::__construct($data); + } + + /** + * Optional. The maximum number of delivery attempts for any message. The + * only valid value is 1. + * + * Generated from protobuf field int32 max_attempts = 1 [(.google.api.field_behavior) = OPTIONAL]; + * @return int + */ + public function getMaxAttempts() + { + return $this->max_attempts; + } + + /** + * Optional. The maximum number of delivery attempts for any message. The + * only valid value is 1. + * + * Generated from protobuf field int32 max_attempts = 1 [(.google.api.field_behavior) = OPTIONAL]; + * @param int $var + * @return $this + */ + public function setMaxAttempts($var) + { + GPBUtil::checkInt32($var); + $this->max_attempts = $var; + + return $this; + } + +} + + diff --git a/GkeMultiCloud/metadata/V1/AttachedResources.php b/GkeMultiCloud/metadata/V1/AttachedResources.php index 4a1950e312ef..947e067d8992 100644 Binary files a/GkeMultiCloud/metadata/V1/AttachedResources.php and b/GkeMultiCloud/metadata/V1/AttachedResources.php differ diff --git a/GkeMultiCloud/metadata/V1/AttachedService.php b/GkeMultiCloud/metadata/V1/AttachedService.php index 5bbcada37da6..abe146cd9664 100644 --- a/GkeMultiCloud/metadata/V1/AttachedService.php +++ b/GkeMultiCloud/metadata/V1/AttachedService.php @@ -25,7 +25,7 @@ public static function initOnce() { \GPBMetadata\Google\Protobuf\FieldMask::initOnce(); $pool->internalAddGeneratedFile( ' -( +( 4google/cloud/gkemulticloud/v1/attached_service.protogoogle.cloud.gkemulticloud.v1google/api/client.protogoogle/api/field_behavior.protogoogle/api/resource.proto6google/cloud/gkemulticloud/v1/attached_resources.proto4google/cloud/gkemulticloud/v1/common_resources.proto#google/longrunning/operations.protogoogle/protobuf/empty.proto google/protobuf/field_mask.proto" -GenerateAttachedClusterInstallManifestRequestD parent ( B4AA.,gkemulticloud.googleapis.com/AttachedCluster @@ -83,13 +83,15 @@ public static function initOnce() { scope ( BA! requested_token_type ( BA options - ( BA"i -)GenerateAttachedClusterAgentTokenResponse - access_token (  + ( BA" +)GenerateAttachedClusterAgentTokenResponse" + access_token ( R access_token -expires_in ( +expires_in (R +expires_in -token_type ( 2 +token_type ( R +token_type2 AttachedClusters CreateAttachedCluster;.google.cloud.gkemulticloud.v1.CreateAttachedClusterRequest.google.longrunning.Operation"A$ AttachedClusterOperationMetadataA+parent,attached_cluster,attached_cluster_idH"4/v1/{parent=projects/*/locations/*}/attachedClusters:attached_cluster diff --git a/GkeMultiCloud/metadata/V1/AwsResources.php b/GkeMultiCloud/metadata/V1/AwsResources.php index c45c3fbfda31..9376e94b320f 100644 Binary files a/GkeMultiCloud/metadata/V1/AwsResources.php and b/GkeMultiCloud/metadata/V1/AwsResources.php differ diff --git a/GkeMultiCloud/metadata/V1/AwsService.php b/GkeMultiCloud/metadata/V1/AwsService.php index 754f9ac6a9db..db5cde622bd4 100644 --- a/GkeMultiCloud/metadata/V1/AwsService.php +++ b/GkeMultiCloud/metadata/V1/AwsService.php @@ -26,81 +26,81 @@ public static function initOnce() { \GPBMetadata\Google\Protobuf\Timestamp::initOnce(); $pool->internalAddGeneratedFile( ' -9 -/google/cloud/gkemulticloud/v1/aws_service.protogoogle.cloud.gkemulticloud.v1google/api/client.protogoogle/api/field_behavior.protogoogle/api/resource.proto1google/cloud/gkemulticloud/v1/aws_resources.proto4google/cloud/gkemulticloud/v1/common_resources.proto#google/longrunning/operations.protogoogle/protobuf/empty.proto google/protobuf/field_mask.protogoogle/protobuf/timestamp.proto" +: +/google/cloud/gkemulticloud/v1/aws_service.protogoogle.cloud.gkemulticloud.v1google/api/client.protogoogle/api/field_behavior.protogoogle/api/resource.proto1google/cloud/gkemulticloud/v1/aws_resources.proto4google/cloud/gkemulticloud/v1/common_resources.proto#google/longrunning/operations.protogoogle/protobuf/empty.proto google/protobuf/field_mask.protogoogle/protobuf/timestamp.proto" CreateAwsClusterRequest? parent ( B/AA)\'gkemulticloud.googleapis.com/AwsClusterC aws_cluster ( 2).google.cloud.gkemulticloud.v1.AwsClusterBA aws_cluster_id ( BA - validate_only (" + validate_only (:" UpdateAwsClusterRequestC aws_cluster ( 2).google.cloud.gkemulticloud.v1.AwsClusterBA validate_only (4 - update_mask ( 2.google.protobuf.FieldMaskBA"U + update_mask ( 2.google.protobuf.FieldMaskBA:"Y GetAwsClusterRequest= name ( B/AA) -\'gkemulticloud.googleapis.com/AwsCluster" +\'gkemulticloud.googleapis.com/AwsCluster:" ListAwsClustersRequest? parent ( B/AA)\'gkemulticloud.googleapis.com/AwsCluster page_size ( -page_token ( "s +page_token ( :"w ListAwsClustersResponse? aws_clusters ( 2).google.cloud.gkemulticloud.v1.AwsCluster -next_page_token ( " +next_page_token ( :" DeleteAwsClusterRequest= name ( B/AA) \'gkemulticloud.googleapis.com/AwsCluster validate_only ( allow_missing ( ignore_errors (BA -etag ( " +etag ( :" CreateAwsNodePoolRequest@ parent ( B0AA*(gkemulticloud.googleapis.com/AwsNodePoolF aws_node_pool ( 2*.google.cloud.gkemulticloud.v1.AwsNodePoolBA aws_node_pool_id ( BA - validate_only (" + validate_only (:" UpdateAwsNodePoolRequestF aws_node_pool ( 2*.google.cloud.gkemulticloud.v1.AwsNodePoolBA validate_only (4 - update_mask ( 2.google.protobuf.FieldMaskBA"| + update_mask ( 2.google.protobuf.FieldMaskBA:" RollbackAwsNodePoolUpdateRequest> name ( B0AA* (gkemulticloud.googleapis.com/AwsNodePool - respect_pdb (BA"W + respect_pdb (BA:"[ GetAwsNodePoolRequest> name ( B0AA* -(gkemulticloud.googleapis.com/AwsNodePool" +(gkemulticloud.googleapis.com/AwsNodePool:" ListAwsNodePoolsRequest@ parent ( B0AA*(gkemulticloud.googleapis.com/AwsNodePool page_size ( -page_token ( "w +page_token ( :"{ ListAwsNodePoolsResponseB aws_node_pools ( 2*.google.cloud.gkemulticloud.v1.AwsNodePool -next_page_token ( " +next_page_token ( :" DeleteAwsNodePoolRequest> name ( B0AA* (gkemulticloud.googleapis.com/AwsNodePool validate_only ( allow_missing ( ignore_errors (BA -etag ( "a +etag ( :"e GetAwsOpenIdConfigRequestD aws_cluster ( B/AA) -\'gkemulticloud.googleapis.com/AwsCluster"` +\'gkemulticloud.googleapis.com/AwsCluster:"d GetAwsJsonWebKeysRequestD aws_cluster ( B/AA) -\'gkemulticloud.googleapis.com/AwsCluster"_ +\'gkemulticloud.googleapis.com/AwsCluster:"c GetAwsServerConfigRequestB name ( B4AA. -,gkemulticloud.googleapis.com/AwsServerConfig"e +,gkemulticloud.googleapis.com/AwsServerConfig:"i GenerateAwsAccessTokenRequestD aws_cluster ( B/AA) -\'gkemulticloud.googleapis.com/AwsCluster"u +\'gkemulticloud.googleapis.com/AwsCluster:"y GenerateAwsAccessTokenResponse access_token ( BA8 -expiration_time ( 2.google.protobuf.TimestampBA" +expiration_time ( 2.google.protobuf.TimestampBA:" #GenerateAwsClusterAgentTokenRequestD aws_cluster ( B/AA) \'gkemulticloud.googleapis.com/AwsCluster @@ -114,39 +114,41 @@ public static function initOnce() { scope ( BA! requested_token_type ( BA options - ( BA"d -$GenerateAwsClusterAgentTokenResponse - access_token (  + ( BA:" +$GenerateAwsClusterAgentTokenResponse" + access_token ( R access_token -expires_in ( +expires_in (R +expires_in -token_type ( 2 - AwsClusters -CreateAwsCluster6.google.cloud.gkemulticloud.v1.CreateAwsClusterRequest.google.longrunning.Operation"A +token_type ( R +token_type:2 + AwsClusters +CreateAwsCluster6.google.cloud.gkemulticloud.v1.CreateAwsClusterRequest.google.longrunning.Operation"A -AwsClusterOperationMetadataA!parent,aws_cluster,aws_cluster_id>"//v1/{parent=projects/*/locations/*}/awsClusters: aws_cluster -UpdateAwsCluster6.google.cloud.gkemulticloud.v1.UpdateAwsClusterRequest.google.longrunning.Operation"A +AwsClusterOperationMetadataA!parent,aws_cluster,aws_cluster_id>"//v1/{parent=projects/*/locations/*}/awsClusters: aws_cluster +UpdateAwsCluster6.google.cloud.gkemulticloud.v1.UpdateAwsClusterRequest.google.longrunning.Operation"A -AwsClusterOperationMetadataAaws_cluster,update_maskJ2;/v1/{aws_cluster.name=projects/*/locations/*/awsClusters/*}: aws_cluster - GetAwsCluster3.google.cloud.gkemulticloud.v1.GetAwsClusterRequest).google.cloud.gkemulticloud.v1.AwsCluster">Aname1//v1/{name=projects/*/locations/*/awsClusters/*} -ListAwsClusters5.google.cloud.gkemulticloud.v1.ListAwsClustersRequest6.google.cloud.gkemulticloud.v1.ListAwsClustersResponse"@Aparent1//v1/{parent=projects/*/locations/*}/awsClusters -DeleteAwsCluster6.google.cloud.gkemulticloud.v1.DeleteAwsClusterRequest.google.longrunning.Operation"kA* -google.protobuf.EmptyOperationMetadataAname1*//v1/{name=projects/*/locations/*/awsClusters/*} -GenerateAwsClusterAgentTokenB.google.cloud.gkemulticloud.v1.GenerateAwsClusterAgentTokenRequestC.google.cloud.gkemulticloud.v1.GenerateAwsClusterAgentTokenResponse"^X"S/v1/{aws_cluster=projects/*/locations/*/awsClusters/*}:generateAwsClusterAgentToken:* -GenerateAwsAccessToken<.google.cloud.gkemulticloud.v1.GenerateAwsAccessTokenRequest=.google.cloud.gkemulticloud.v1.GenerateAwsAccessTokenResponse"UOM/v1/{aws_cluster=projects/*/locations/*/awsClusters/*}:generateAwsAccessToken -CreateAwsNodePool7.google.cloud.gkemulticloud.v1.CreateAwsNodePoolRequest.google.longrunning.Operation"A - AwsNodePoolOperationMetadataA%parent,aws_node_pool,aws_node_pool_idO">/v1/{parent=projects/*/locations/*/awsClusters/*}/awsNodePools: aws_node_pool -UpdateAwsNodePool7.google.cloud.gkemulticloud.v1.UpdateAwsNodePoolRequest.google.longrunning.Operation"A - AwsNodePoolOperationMetadataAaws_node_pool,update_mask]2L/v1/{aws_node_pool.name=projects/*/locations/*/awsClusters/*/awsNodePools/*}: aws_node_pool -RollbackAwsNodePoolUpdate?.google.cloud.gkemulticloud.v1.RollbackAwsNodePoolUpdateRequest.google.longrunning.Operation"|A - AwsNodePoolOperationMetadataAnameL"G/v1/{name=projects/*/locations/*/awsClusters/*/awsNodePools/*}:rollback:* -GetAwsNodePool4.google.cloud.gkemulticloud.v1.GetAwsNodePoolRequest*.google.cloud.gkemulticloud.v1.AwsNodePool"MAname@>/v1/{name=projects/*/locations/*/awsClusters/*/awsNodePools/*} -ListAwsNodePools6.google.cloud.gkemulticloud.v1.ListAwsNodePoolsRequest7.google.cloud.gkemulticloud.v1.ListAwsNodePoolsResponse"OAparent@>/v1/{parent=projects/*/locations/*/awsClusters/*}/awsNodePools -DeleteAwsNodePool7.google.cloud.gkemulticloud.v1.DeleteAwsNodePoolRequest.google.longrunning.Operation"zA* -google.protobuf.EmptyOperationMetadataAname@*>/v1/{name=projects/*/locations/*/awsClusters/*/awsNodePools/*} -GetAwsOpenIdConfig8.google.cloud.gkemulticloud.v1.GetAwsOpenIdConfigRequest..google.cloud.gkemulticloud.v1.AwsOpenIdConfig"_YW/v1/{aws_cluster=projects/*/locations/*/awsClusters/*}/.well-known/openid-configuration -GetAwsJsonWebKeys7.google.cloud.gkemulticloud.v1.GetAwsJsonWebKeysRequest-.google.cloud.gkemulticloud.v1.AwsJsonWebKeys"C=;/v1/{aws_cluster=projects/*/locations/*/awsClusters/*}/jwks -GetAwsServerConfig8.google.cloud.gkemulticloud.v1.GetAwsServerConfigRequest..google.cloud.gkemulticloud.v1.AwsServerConfig"@Aname31/v1/{name=projects/*/locations/*/awsServerConfig}PAgkemulticloud.googleapis.comA.https://www.googleapis.com/auth/cloud-platformB +AwsClusterOperationMetadataAaws_cluster,update_maskJ2;/v1/{aws_cluster.name=projects/*/locations/*/awsClusters/*}: aws_cluster + GetAwsCluster3.google.cloud.gkemulticloud.v1.GetAwsClusterRequest).google.cloud.gkemulticloud.v1.AwsCluster"AAname1//v1/{name=projects/*/locations/*/awsClusters/*} +ListAwsClusters5.google.cloud.gkemulticloud.v1.ListAwsClustersRequest6.google.cloud.gkemulticloud.v1.ListAwsClustersResponse"CAparent1//v1/{parent=projects/*/locations/*}/awsClusters +DeleteAwsCluster6.google.cloud.gkemulticloud.v1.DeleteAwsClusterRequest.google.longrunning.Operation"nA* +google.protobuf.EmptyOperationMetadataAname1*//v1/{name=projects/*/locations/*/awsClusters/*} +GenerateAwsClusterAgentTokenB.google.cloud.gkemulticloud.v1.GenerateAwsClusterAgentTokenRequestC.google.cloud.gkemulticloud.v1.GenerateAwsClusterAgentTokenResponse"aX"S/v1/{aws_cluster=projects/*/locations/*/awsClusters/*}:generateAwsClusterAgentToken:* +GenerateAwsAccessToken<.google.cloud.gkemulticloud.v1.GenerateAwsAccessTokenRequest=.google.cloud.gkemulticloud.v1.GenerateAwsAccessTokenResponse"XOM/v1/{aws_cluster=projects/*/locations/*/awsClusters/*}:generateAwsAccessToken +CreateAwsNodePool7.google.cloud.gkemulticloud.v1.CreateAwsNodePoolRequest.google.longrunning.Operation"A + AwsNodePoolOperationMetadataA%parent,aws_node_pool,aws_node_pool_idO">/v1/{parent=projects/*/locations/*/awsClusters/*}/awsNodePools: aws_node_pool +UpdateAwsNodePool7.google.cloud.gkemulticloud.v1.UpdateAwsNodePoolRequest.google.longrunning.Operation"A + AwsNodePoolOperationMetadataAaws_node_pool,update_mask]2L/v1/{aws_node_pool.name=projects/*/locations/*/awsClusters/*/awsNodePools/*}: aws_node_pool +RollbackAwsNodePoolUpdate?.google.cloud.gkemulticloud.v1.RollbackAwsNodePoolUpdateRequest.google.longrunning.Operation"A + AwsNodePoolOperationMetadataAnameL"G/v1/{name=projects/*/locations/*/awsClusters/*/awsNodePools/*}:rollback:* +GetAwsNodePool4.google.cloud.gkemulticloud.v1.GetAwsNodePoolRequest*.google.cloud.gkemulticloud.v1.AwsNodePool"PAname@>/v1/{name=projects/*/locations/*/awsClusters/*/awsNodePools/*} +ListAwsNodePools6.google.cloud.gkemulticloud.v1.ListAwsNodePoolsRequest7.google.cloud.gkemulticloud.v1.ListAwsNodePoolsResponse"RAparent@>/v1/{parent=projects/*/locations/*/awsClusters/*}/awsNodePools +DeleteAwsNodePool7.google.cloud.gkemulticloud.v1.DeleteAwsNodePoolRequest.google.longrunning.Operation"}A* +google.protobuf.EmptyOperationMetadataAname@*>/v1/{name=projects/*/locations/*/awsClusters/*/awsNodePools/*} +GetAwsOpenIdConfig8.google.cloud.gkemulticloud.v1.GetAwsOpenIdConfigRequest..google.cloud.gkemulticloud.v1.AwsOpenIdConfig"bYW/v1/{aws_cluster=projects/*/locations/*/awsClusters/*}/.well-known/openid-configuration +GetAwsJsonWebKeys7.google.cloud.gkemulticloud.v1.GetAwsJsonWebKeysRequest-.google.cloud.gkemulticloud.v1.AwsJsonWebKeys"F=;/v1/{aws_cluster=projects/*/locations/*/awsClusters/*}/jwks +GetAwsServerConfig8.google.cloud.gkemulticloud.v1.GetAwsServerConfigRequest..google.cloud.gkemulticloud.v1.AwsServerConfig"CAname31/v1/{name=projects/*/locations/*/awsServerConfig}SAgkemulticloud.googleapis.comA.https://www.googleapis.com/auth/cloud-platformB !com.google.cloud.gkemulticloud.v1BAwsServiceProtoPZGcloud.google.com/go/gkemulticloud/apiv1/gkemulticloudpb;gkemulticloudpbGoogle.Cloud.GkeMultiCloud.V1Google\\Cloud\\GkeMultiCloud\\V1 Google::Cloud::GkeMultiCloud::V1bproto3' , true); diff --git a/GkeMultiCloud/metadata/V1/AzureResources.php b/GkeMultiCloud/metadata/V1/AzureResources.php index 5666e4e33faa..a16420d65b22 100644 Binary files a/GkeMultiCloud/metadata/V1/AzureResources.php and b/GkeMultiCloud/metadata/V1/AzureResources.php differ diff --git a/GkeMultiCloud/metadata/V1/AzureService.php b/GkeMultiCloud/metadata/V1/AzureService.php index b6b507c9edfc..bbb23398d388 100644 --- a/GkeMultiCloud/metadata/V1/AzureService.php +++ b/GkeMultiCloud/metadata/V1/AzureService.php @@ -26,98 +26,98 @@ public static function initOnce() { \GPBMetadata\Google\Protobuf\Timestamp::initOnce(); $pool->internalAddGeneratedFile( ' -D -1google/cloud/gkemulticloud/v1/azure_service.protogoogle.cloud.gkemulticloud.v1google/api/client.protogoogle/api/field_behavior.protogoogle/api/resource.proto3google/cloud/gkemulticloud/v1/azure_resources.proto4google/cloud/gkemulticloud/v1/common_resources.proto#google/longrunning/operations.protogoogle/protobuf/empty.proto google/protobuf/field_mask.protogoogle/protobuf/timestamp.proto" +F +1google/cloud/gkemulticloud/v1/azure_service.protogoogle.cloud.gkemulticloud.v1google/api/client.protogoogle/api/field_behavior.protogoogle/api/resource.proto3google/cloud/gkemulticloud/v1/azure_resources.proto4google/cloud/gkemulticloud/v1/common_resources.proto#google/longrunning/operations.protogoogle/protobuf/empty.proto google/protobuf/field_mask.protogoogle/protobuf/timestamp.proto" CreateAzureClusterRequestA parent ( B1AA+)gkemulticloud.googleapis.com/AzureClusterG azure_cluster ( 2+.google.cloud.gkemulticloud.v1.AzureClusterBA azure_cluster_id ( BA - validate_only (" + validate_only (:" UpdateAzureClusterRequestG azure_cluster ( 2+.google.cloud.gkemulticloud.v1.AzureClusterBA validate_only (4 - update_mask ( 2.google.protobuf.FieldMaskBA"Y + update_mask ( 2.google.protobuf.FieldMaskBA:"] GetAzureClusterRequest? name ( B1AA+ -)gkemulticloud.googleapis.com/AzureCluster" +)gkemulticloud.googleapis.com/AzureCluster:" ListAzureClustersRequestA parent ( B1AA+)gkemulticloud.googleapis.com/AzureCluster page_size ( -page_token ( "y +page_token ( :"} ListAzureClustersResponseC azure_clusters ( 2+.google.cloud.gkemulticloud.v1.AzureCluster -next_page_token ( " +next_page_token ( :" DeleteAzureClusterRequest? name ( B1AA+ )gkemulticloud.googleapis.com/AzureCluster allow_missing ( validate_only ( etag (  - ignore_errors (BA" + ignore_errors (BA:" CreateAzureNodePoolRequestB parent ( B2AA,*gkemulticloud.googleapis.com/AzureNodePoolJ azure_node_pool ( 2,.google.cloud.gkemulticloud.v1.AzureNodePoolBA azure_node_pool_id ( BA - validate_only (" + validate_only (:" UpdateAzureNodePoolRequestJ azure_node_pool ( 2,.google.cloud.gkemulticloud.v1.AzureNodePoolBA validate_only (4 - update_mask ( 2.google.protobuf.FieldMaskBA"[ + update_mask ( 2.google.protobuf.FieldMaskBA:"_ GetAzureNodePoolRequest@ name ( B2AA, -*gkemulticloud.googleapis.com/AzureNodePool" +*gkemulticloud.googleapis.com/AzureNodePool:" ListAzureNodePoolsRequestB parent ( B2AA,*gkemulticloud.googleapis.com/AzureNodePool page_size ( -page_token ( "} +page_token ( :" ListAzureNodePoolsResponseF azure_node_pools ( 2,.google.cloud.gkemulticloud.v1.AzureNodePool -next_page_token ( " +next_page_token ( :" DeleteAzureNodePoolRequest@ name ( B2AA, *gkemulticloud.googleapis.com/AzureNodePool validate_only ( allow_missing ( etag (  - ignore_errors (BA"g + ignore_errors (BA:"k GetAzureOpenIdConfigRequestH azure_cluster ( B1AA+ -)gkemulticloud.googleapis.com/AzureCluster"f +)gkemulticloud.googleapis.com/AzureCluster:"j GetAzureJsonWebKeysRequestH azure_cluster ( B1AA+ -)gkemulticloud.googleapis.com/AzureCluster"c +)gkemulticloud.googleapis.com/AzureCluster:"g GetAzureServerConfigRequestD name ( B6AA0 -.gkemulticloud.googleapis.com/AzureServerConfig" +.gkemulticloud.googleapis.com/AzureServerConfig:" CreateAzureClientRequest@ parent ( B0AA*(gkemulticloud.googleapis.com/AzureClientE azure_client ( 2*.google.cloud.gkemulticloud.v1.AzureClientBA azure_client_id ( BA - validate_only ("W + validate_only (:"[ GetAzureClientRequest> name ( B0AA* -(gkemulticloud.googleapis.com/AzureClient" +(gkemulticloud.googleapis.com/AzureClient:" ListAzureClientsRequest@ parent ( B0AA*(gkemulticloud.googleapis.com/AzureClient page_size ( -page_token ( "v +page_token ( :"z ListAzureClientsResponseA azure_clients ( 2*.google.cloud.gkemulticloud.v1.AzureClient -next_page_token ( " +next_page_token ( :" DeleteAzureClientRequest> name ( B0AA* (gkemulticloud.googleapis.com/AzureClient allow_missing ( - validate_only ("k + validate_only (:"o GenerateAzureAccessTokenRequestH azure_cluster ( B1AA+ -)gkemulticloud.googleapis.com/AzureCluster"w +)gkemulticloud.googleapis.com/AzureCluster:"{ GenerateAzureAccessTokenResponse access_token ( BA8 -expiration_time ( 2.google.protobuf.TimestampBA" +expiration_time ( 2.google.protobuf.TimestampBA:" %GenerateAzureClusterAgentTokenRequestH azure_cluster ( B1AA+ )gkemulticloud.googleapis.com/AzureCluster @@ -131,41 +131,43 @@ public static function initOnce() { scope ( BA! requested_token_type ( BA options - ( BA"f -&GenerateAzureClusterAgentTokenResponse - access_token (  + ( BA:" +&GenerateAzureClusterAgentTokenResponse" + access_token ( R access_token -expires_in ( +expires_in (R +expires_in -token_type ( 2# - AzureClusters -CreateAzureClient7.google.cloud.gkemulticloud.v1.CreateAzureClientRequest.google.longrunning.Operation"A - AzureClientOperationMetadataA#parent,azure_client,azure_client_id@"0/v1/{parent=projects/*/locations/*}/azureClients: azure_client -GetAzureClient4.google.cloud.gkemulticloud.v1.GetAzureClientRequest*.google.cloud.gkemulticloud.v1.AzureClient"?Aname20/v1/{name=projects/*/locations/*/azureClients/*} -ListAzureClients6.google.cloud.gkemulticloud.v1.ListAzureClientsRequest7.google.cloud.gkemulticloud.v1.ListAzureClientsResponse"AAparent20/v1/{parent=projects/*/locations/*}/azureClients -DeleteAzureClient7.google.cloud.gkemulticloud.v1.DeleteAzureClientRequest.google.longrunning.Operation"lA* -google.protobuf.EmptyOperationMetadataAname2*0/v1/{name=projects/*/locations/*/azureClients/*} -CreateAzureCluster8.google.cloud.gkemulticloud.v1.CreateAzureClusterRequest.google.longrunning.Operation"A! - AzureClusterOperationMetadataA%parent,azure_cluster,azure_cluster_idB"1/v1/{parent=projects/*/locations/*}/azureClusters: azure_cluster -UpdateAzureCluster8.google.cloud.gkemulticloud.v1.UpdateAzureClusterRequest.google.longrunning.Operation"A! - AzureClusterOperationMetadataAazure_cluster,update_maskP2?/v1/{azure_cluster.name=projects/*/locations/*/azureClusters/*}: azure_cluster -GetAzureCluster5.google.cloud.gkemulticloud.v1.GetAzureClusterRequest+.google.cloud.gkemulticloud.v1.AzureCluster"@Aname31/v1/{name=projects/*/locations/*/azureClusters/*} -ListAzureClusters7.google.cloud.gkemulticloud.v1.ListAzureClustersRequest8.google.cloud.gkemulticloud.v1.ListAzureClustersResponse"BAparent31/v1/{parent=projects/*/locations/*}/azureClusters -DeleteAzureCluster8.google.cloud.gkemulticloud.v1.DeleteAzureClusterRequest.google.longrunning.Operation"mA* -google.protobuf.EmptyOperationMetadataAname3*1/v1/{name=projects/*/locations/*/azureClusters/*} -GenerateAzureClusterAgentTokenD.google.cloud.gkemulticloud.v1.GenerateAzureClusterAgentTokenRequestE.google.cloud.gkemulticloud.v1.GenerateAzureClusterAgentTokenResponse"d^"Y/v1/{azure_cluster=projects/*/locations/*/azureClusters/*}:generateAzureClusterAgentToken:* -GenerateAzureAccessToken>.google.cloud.gkemulticloud.v1.GenerateAzureAccessTokenRequest?.google.cloud.gkemulticloud.v1.GenerateAzureAccessTokenResponse"[US/v1/{azure_cluster=projects/*/locations/*/azureClusters/*}:generateAzureAccessToken -CreateAzureNodePool9.google.cloud.gkemulticloud.v1.CreateAzureNodePoolRequest.google.longrunning.Operation"A" - AzureNodePoolOperationMetadataA)parent,azure_node_pool,azure_node_pool_idU"B/v1/{parent=projects/*/locations/*/azureClusters/*}/azureNodePools:azure_node_pool -UpdateAzureNodePool9.google.cloud.gkemulticloud.v1.UpdateAzureNodePoolRequest.google.longrunning.Operation"A" - AzureNodePoolOperationMetadataAazure_node_pool,update_maske2R/v1/{azure_node_pool.name=projects/*/locations/*/azureClusters/*/azureNodePools/*}:azure_node_pool -GetAzureNodePool6.google.cloud.gkemulticloud.v1.GetAzureNodePoolRequest,.google.cloud.gkemulticloud.v1.AzureNodePool"QAnameDB/v1/{name=projects/*/locations/*/azureClusters/*/azureNodePools/*} -ListAzureNodePools8.google.cloud.gkemulticloud.v1.ListAzureNodePoolsRequest9.google.cloud.gkemulticloud.v1.ListAzureNodePoolsResponse"SAparentDB/v1/{parent=projects/*/locations/*/azureClusters/*}/azureNodePools -DeleteAzureNodePool9.google.cloud.gkemulticloud.v1.DeleteAzureNodePoolRequest.google.longrunning.Operation"~A* -google.protobuf.EmptyOperationMetadataAnameD*B/v1/{name=projects/*/locations/*/azureClusters/*/azureNodePools/*} -GetAzureOpenIdConfig:.google.cloud.gkemulticloud.v1.GetAzureOpenIdConfigRequest0.google.cloud.gkemulticloud.v1.AzureOpenIdConfig"sA azure_cluster][/v1/{azure_cluster=projects/*/locations/*/azureClusters/*}/.well-known/openid-configuration -GetAzureJsonWebKeys9.google.cloud.gkemulticloud.v1.GetAzureJsonWebKeysRequest/.google.cloud.gkemulticloud.v1.AzureJsonWebKeys"WA azure_clusterA?/v1/{azure_cluster=projects/*/locations/*/azureClusters/*}/jwks -GetAzureServerConfig:.google.cloud.gkemulticloud.v1.GetAzureServerConfigRequest0.google.cloud.gkemulticloud.v1.AzureServerConfig"BAname53/v1/{name=projects/*/locations/*/azureServerConfig}PAgkemulticloud.googleapis.comA.https://www.googleapis.com/auth/cloud-platformB +token_type ( R +token_type:2$ + AzureClusters +CreateAzureClient7.google.cloud.gkemulticloud.v1.CreateAzureClientRequest.google.longrunning.Operation"A + AzureClientOperationMetadataA#parent,azure_client,azure_client_id@"0/v1/{parent=projects/*/locations/*}/azureClients: azure_client +GetAzureClient4.google.cloud.gkemulticloud.v1.GetAzureClientRequest*.google.cloud.gkemulticloud.v1.AzureClient"BAname20/v1/{name=projects/*/locations/*/azureClients/*} +ListAzureClients6.google.cloud.gkemulticloud.v1.ListAzureClientsRequest7.google.cloud.gkemulticloud.v1.ListAzureClientsResponse"DAparent20/v1/{parent=projects/*/locations/*}/azureClients +DeleteAzureClient7.google.cloud.gkemulticloud.v1.DeleteAzureClientRequest.google.longrunning.Operation"oA* +google.protobuf.EmptyOperationMetadataAname2*0/v1/{name=projects/*/locations/*/azureClients/*} +CreateAzureCluster8.google.cloud.gkemulticloud.v1.CreateAzureClusterRequest.google.longrunning.Operation"A! + AzureClusterOperationMetadataA%parent,azure_cluster,azure_cluster_idB"1/v1/{parent=projects/*/locations/*}/azureClusters: azure_cluster +UpdateAzureCluster8.google.cloud.gkemulticloud.v1.UpdateAzureClusterRequest.google.longrunning.Operation"A! + AzureClusterOperationMetadataAazure_cluster,update_maskP2?/v1/{azure_cluster.name=projects/*/locations/*/azureClusters/*}: azure_cluster +GetAzureCluster5.google.cloud.gkemulticloud.v1.GetAzureClusterRequest+.google.cloud.gkemulticloud.v1.AzureCluster"CAname31/v1/{name=projects/*/locations/*/azureClusters/*} +ListAzureClusters7.google.cloud.gkemulticloud.v1.ListAzureClustersRequest8.google.cloud.gkemulticloud.v1.ListAzureClustersResponse"EAparent31/v1/{parent=projects/*/locations/*}/azureClusters +DeleteAzureCluster8.google.cloud.gkemulticloud.v1.DeleteAzureClusterRequest.google.longrunning.Operation"pA* +google.protobuf.EmptyOperationMetadataAname3*1/v1/{name=projects/*/locations/*/azureClusters/*} +GenerateAzureClusterAgentTokenD.google.cloud.gkemulticloud.v1.GenerateAzureClusterAgentTokenRequestE.google.cloud.gkemulticloud.v1.GenerateAzureClusterAgentTokenResponse"g^"Y/v1/{azure_cluster=projects/*/locations/*/azureClusters/*}:generateAzureClusterAgentToken:* +GenerateAzureAccessToken>.google.cloud.gkemulticloud.v1.GenerateAzureAccessTokenRequest?.google.cloud.gkemulticloud.v1.GenerateAzureAccessTokenResponse"^US/v1/{azure_cluster=projects/*/locations/*/azureClusters/*}:generateAzureAccessToken +CreateAzureNodePool9.google.cloud.gkemulticloud.v1.CreateAzureNodePoolRequest.google.longrunning.Operation"A" + AzureNodePoolOperationMetadataA)parent,azure_node_pool,azure_node_pool_idU"B/v1/{parent=projects/*/locations/*/azureClusters/*}/azureNodePools:azure_node_pool +UpdateAzureNodePool9.google.cloud.gkemulticloud.v1.UpdateAzureNodePoolRequest.google.longrunning.Operation"A" + AzureNodePoolOperationMetadataAazure_node_pool,update_maske2R/v1/{azure_node_pool.name=projects/*/locations/*/azureClusters/*/azureNodePools/*}:azure_node_pool +GetAzureNodePool6.google.cloud.gkemulticloud.v1.GetAzureNodePoolRequest,.google.cloud.gkemulticloud.v1.AzureNodePool"TAnameDB/v1/{name=projects/*/locations/*/azureClusters/*/azureNodePools/*} +ListAzureNodePools8.google.cloud.gkemulticloud.v1.ListAzureNodePoolsRequest9.google.cloud.gkemulticloud.v1.ListAzureNodePoolsResponse"VAparentDB/v1/{parent=projects/*/locations/*/azureClusters/*}/azureNodePools +DeleteAzureNodePool9.google.cloud.gkemulticloud.v1.DeleteAzureNodePoolRequest.google.longrunning.Operation"A* +google.protobuf.EmptyOperationMetadataAnameD*B/v1/{name=projects/*/locations/*/azureClusters/*/azureNodePools/*} +GetAzureOpenIdConfig:.google.cloud.gkemulticloud.v1.GetAzureOpenIdConfigRequest0.google.cloud.gkemulticloud.v1.AzureOpenIdConfig"vA azure_cluster][/v1/{azure_cluster=projects/*/locations/*/azureClusters/*}/.well-known/openid-configuration +GetAzureJsonWebKeys9.google.cloud.gkemulticloud.v1.GetAzureJsonWebKeysRequest/.google.cloud.gkemulticloud.v1.AzureJsonWebKeys"ZA azure_clusterA?/v1/{azure_cluster=projects/*/locations/*/azureClusters/*}/jwks +GetAzureServerConfig:.google.cloud.gkemulticloud.v1.GetAzureServerConfigRequest0.google.cloud.gkemulticloud.v1.AzureServerConfig"EAname53/v1/{name=projects/*/locations/*/azureServerConfig}SAgkemulticloud.googleapis.comA.https://www.googleapis.com/auth/cloud-platformB !com.google.cloud.gkemulticloud.v1BAzureServiceProtoPZGcloud.google.com/go/gkemulticloud/apiv1/gkemulticloudpb;gkemulticloudpbGoogle.Cloud.GkeMultiCloud.V1Google\\Cloud\\GkeMultiCloud\\V1 Google::Cloud::GkeMultiCloud::V1bproto3' , true); diff --git a/GkeMultiCloud/src/V1/AttachedCluster.php b/GkeMultiCloud/src/V1/AttachedCluster.php index 1a479d207771..7852c848c858 100644 --- a/GkeMultiCloud/src/V1/AttachedCluster.php +++ b/GkeMultiCloud/src/V1/AttachedCluster.php @@ -175,14 +175,15 @@ class AttachedCluster extends \Google\Protobuf\Internal\Message */ protected $security_posture_config = null; /** - * Optional. Input only. Tag keys/values directly bound to this resource. - * Tag key must be specified in the format / + * Optional. Input only. Tag keys and values directly bound to this resource. + * The tag key must be specified in the format + * `/,` * where the tag namespace is the ID of the organization or name of the - * project that the tag key is defined in. - * The short name of a tag key or value can have a maximum length of 256 - * characters. The permitted character set for the short name includes UTF-8 - * encoded Unicode characters except single quotes ('), double quotes ("), - * backslashes (\), and forward slashes (/). + * project that the tag key is defined in. The short name of a tag key or + * value can have a maximum length of 256 characters. The permitted character + * set for the short name includes UTF-8 encoded Unicode characters except + * single quotation marks (`'`), double quotation marks (`"`), backslashes + * (`\`), and forward slashes (`/`). * See * [Tags](https://cloud.google.com/resource-manager/docs/tags/tags-overview) * for more details on Google Cloud Platform tags. @@ -190,6 +191,13 @@ class AttachedCluster extends \Google\Protobuf\Internal\Message * Generated from protobuf field map tags = 27 [(.google.api.field_behavior) = OPTIONAL, (.google.api.field_behavior) = INPUT_ONLY]; */ private $tags; + /** + * Optional. Kubernetes configurations for auto-installed components on the + * cluster. + * + * Generated from protobuf field .google.cloud.gkemulticloud.v1.SystemComponentsConfig system_components_config = 28 [(.google.api.field_behavior) = OPTIONAL]; + */ + protected $system_components_config = null; /** * Constructor. @@ -265,17 +273,21 @@ class AttachedCluster extends \Google\Protobuf\Internal\Message * @type \Google\Cloud\GkeMultiCloud\V1\SecurityPostureConfig $security_posture_config * Optional. Security Posture configuration for this cluster. * @type array|\Google\Protobuf\Internal\MapField $tags - * Optional. Input only. Tag keys/values directly bound to this resource. - * Tag key must be specified in the format / + * Optional. Input only. Tag keys and values directly bound to this resource. + * The tag key must be specified in the format + * `/,` * where the tag namespace is the ID of the organization or name of the - * project that the tag key is defined in. - * The short name of a tag key or value can have a maximum length of 256 - * characters. The permitted character set for the short name includes UTF-8 - * encoded Unicode characters except single quotes ('), double quotes ("), - * backslashes (\), and forward slashes (/). + * project that the tag key is defined in. The short name of a tag key or + * value can have a maximum length of 256 characters. The permitted character + * set for the short name includes UTF-8 encoded Unicode characters except + * single quotation marks (`'`), double quotation marks (`"`), backslashes + * (`\`), and forward slashes (`/`). * See * [Tags](https://cloud.google.com/resource-manager/docs/tags/tags-overview) * for more details on Google Cloud Platform tags. + * @type \Google\Cloud\GkeMultiCloud\V1\SystemComponentsConfig $system_components_config + * Optional. Kubernetes configurations for auto-installed components on the + * cluster. * } */ public function __construct($data = NULL) { @@ -1034,14 +1046,15 @@ public function setSecurityPostureConfig($var) } /** - * Optional. Input only. Tag keys/values directly bound to this resource. - * Tag key must be specified in the format / + * Optional. Input only. Tag keys and values directly bound to this resource. + * The tag key must be specified in the format + * `/,` * where the tag namespace is the ID of the organization or name of the - * project that the tag key is defined in. - * The short name of a tag key or value can have a maximum length of 256 - * characters. The permitted character set for the short name includes UTF-8 - * encoded Unicode characters except single quotes ('), double quotes ("), - * backslashes (\), and forward slashes (/). + * project that the tag key is defined in. The short name of a tag key or + * value can have a maximum length of 256 characters. The permitted character + * set for the short name includes UTF-8 encoded Unicode characters except + * single quotation marks (`'`), double quotation marks (`"`), backslashes + * (`\`), and forward slashes (`/`). * See * [Tags](https://cloud.google.com/resource-manager/docs/tags/tags-overview) * for more details on Google Cloud Platform tags. @@ -1055,14 +1068,15 @@ public function getTags() } /** - * Optional. Input only. Tag keys/values directly bound to this resource. - * Tag key must be specified in the format / + * Optional. Input only. Tag keys and values directly bound to this resource. + * The tag key must be specified in the format + * `/,` * where the tag namespace is the ID of the organization or name of the - * project that the tag key is defined in. - * The short name of a tag key or value can have a maximum length of 256 - * characters. The permitted character set for the short name includes UTF-8 - * encoded Unicode characters except single quotes ('), double quotes ("), - * backslashes (\), and forward slashes (/). + * project that the tag key is defined in. The short name of a tag key or + * value can have a maximum length of 256 characters. The permitted character + * set for the short name includes UTF-8 encoded Unicode characters except + * single quotation marks (`'`), double quotation marks (`"`), backslashes + * (`\`), and forward slashes (`/`). * See * [Tags](https://cloud.google.com/resource-manager/docs/tags/tags-overview) * for more details on Google Cloud Platform tags. @@ -1079,5 +1093,43 @@ public function setTags($var) return $this; } + /** + * Optional. Kubernetes configurations for auto-installed components on the + * cluster. + * + * Generated from protobuf field .google.cloud.gkemulticloud.v1.SystemComponentsConfig system_components_config = 28 [(.google.api.field_behavior) = OPTIONAL]; + * @return \Google\Cloud\GkeMultiCloud\V1\SystemComponentsConfig|null + */ + public function getSystemComponentsConfig() + { + return $this->system_components_config; + } + + public function hasSystemComponentsConfig() + { + return isset($this->system_components_config); + } + + public function clearSystemComponentsConfig() + { + unset($this->system_components_config); + } + + /** + * Optional. Kubernetes configurations for auto-installed components on the + * cluster. + * + * Generated from protobuf field .google.cloud.gkemulticloud.v1.SystemComponentsConfig system_components_config = 28 [(.google.api.field_behavior) = OPTIONAL]; + * @param \Google\Cloud\GkeMultiCloud\V1\SystemComponentsConfig $var + * @return $this + */ + public function setSystemComponentsConfig($var) + { + GPBUtil::checkMessage($var, \Google\Cloud\GkeMultiCloud\V1\SystemComponentsConfig::class); + $this->system_components_config = $var; + + return $this; + } + } diff --git a/GkeMultiCloud/src/V1/AttachedPlatformVersionInfo.php b/GkeMultiCloud/src/V1/AttachedPlatformVersionInfo.php index a81ade67a335..96f772999165 100644 --- a/GkeMultiCloud/src/V1/AttachedPlatformVersionInfo.php +++ b/GkeMultiCloud/src/V1/AttachedPlatformVersionInfo.php @@ -21,6 +21,36 @@ class AttachedPlatformVersionInfo extends \Google\Protobuf\Internal\Message * Generated from protobuf field string version = 1; */ protected $version = ''; + /** + * Optional. True if the version is available for attachedcluster creation. If + * a version is enabled, it can be used to attach new clusters. + * + * Generated from protobuf field bool enabled = 3 [(.google.api.field_behavior) = OPTIONAL]; + */ + protected $enabled = false; + /** + * Optional. True if this cluster version belongs to a minor version that has + * reached its end of life and is no longer in scope to receive security and + * bug fixes. + * + * Generated from protobuf field bool end_of_life = 4 [(.google.api.field_behavior) = OPTIONAL]; + */ + protected $end_of_life = false; + /** + * Optional. The estimated date (in Pacific Time) when this cluster version + * will reach its end of life. Or if this version is no longer supported (the + * `end_of_life` field is true), this is the actual date (in Pacific time) + * when the version reached its end of life. + * + * Generated from protobuf field .google.type.Date end_of_life_date = 5 [(.google.api.field_behavior) = OPTIONAL]; + */ + protected $end_of_life_date = null; + /** + * Optional. The date (in Pacific Time) when the cluster version was released. + * + * Generated from protobuf field .google.type.Date release_date = 6 [(.google.api.field_behavior) = OPTIONAL]; + */ + protected $release_date = null; /** * Constructor. @@ -30,6 +60,20 @@ class AttachedPlatformVersionInfo extends \Google\Protobuf\Internal\Message * * @type string $version * Platform version name. + * @type bool $enabled + * Optional. True if the version is available for attachedcluster creation. If + * a version is enabled, it can be used to attach new clusters. + * @type bool $end_of_life + * Optional. True if this cluster version belongs to a minor version that has + * reached its end of life and is no longer in scope to receive security and + * bug fixes. + * @type \Google\Type\Date $end_of_life_date + * Optional. The estimated date (in Pacific Time) when this cluster version + * will reach its end of life. Or if this version is no longer supported (the + * `end_of_life` field is true), this is the actual date (in Pacific time) + * when the version reached its end of life. + * @type \Google\Type\Date $release_date + * Optional. The date (in Pacific Time) when the cluster version was released. * } */ public function __construct($data = NULL) { @@ -63,5 +107,141 @@ public function setVersion($var) return $this; } + /** + * Optional. True if the version is available for attachedcluster creation. If + * a version is enabled, it can be used to attach new clusters. + * + * Generated from protobuf field bool enabled = 3 [(.google.api.field_behavior) = OPTIONAL]; + * @return bool + */ + public function getEnabled() + { + return $this->enabled; + } + + /** + * Optional. True if the version is available for attachedcluster creation. If + * a version is enabled, it can be used to attach new clusters. + * + * Generated from protobuf field bool enabled = 3 [(.google.api.field_behavior) = OPTIONAL]; + * @param bool $var + * @return $this + */ + public function setEnabled($var) + { + GPBUtil::checkBool($var); + $this->enabled = $var; + + return $this; + } + + /** + * Optional. True if this cluster version belongs to a minor version that has + * reached its end of life and is no longer in scope to receive security and + * bug fixes. + * + * Generated from protobuf field bool end_of_life = 4 [(.google.api.field_behavior) = OPTIONAL]; + * @return bool + */ + public function getEndOfLife() + { + return $this->end_of_life; + } + + /** + * Optional. True if this cluster version belongs to a minor version that has + * reached its end of life and is no longer in scope to receive security and + * bug fixes. + * + * Generated from protobuf field bool end_of_life = 4 [(.google.api.field_behavior) = OPTIONAL]; + * @param bool $var + * @return $this + */ + public function setEndOfLife($var) + { + GPBUtil::checkBool($var); + $this->end_of_life = $var; + + return $this; + } + + /** + * Optional. The estimated date (in Pacific Time) when this cluster version + * will reach its end of life. Or if this version is no longer supported (the + * `end_of_life` field is true), this is the actual date (in Pacific time) + * when the version reached its end of life. + * + * Generated from protobuf field .google.type.Date end_of_life_date = 5 [(.google.api.field_behavior) = OPTIONAL]; + * @return \Google\Type\Date|null + */ + public function getEndOfLifeDate() + { + return $this->end_of_life_date; + } + + public function hasEndOfLifeDate() + { + return isset($this->end_of_life_date); + } + + public function clearEndOfLifeDate() + { + unset($this->end_of_life_date); + } + + /** + * Optional. The estimated date (in Pacific Time) when this cluster version + * will reach its end of life. Or if this version is no longer supported (the + * `end_of_life` field is true), this is the actual date (in Pacific time) + * when the version reached its end of life. + * + * Generated from protobuf field .google.type.Date end_of_life_date = 5 [(.google.api.field_behavior) = OPTIONAL]; + * @param \Google\Type\Date $var + * @return $this + */ + public function setEndOfLifeDate($var) + { + GPBUtil::checkMessage($var, \Google\Type\Date::class); + $this->end_of_life_date = $var; + + return $this; + } + + /** + * Optional. The date (in Pacific Time) when the cluster version was released. + * + * Generated from protobuf field .google.type.Date release_date = 6 [(.google.api.field_behavior) = OPTIONAL]; + * @return \Google\Type\Date|null + */ + public function getReleaseDate() + { + return $this->release_date; + } + + public function hasReleaseDate() + { + return isset($this->release_date); + } + + public function clearReleaseDate() + { + unset($this->release_date); + } + + /** + * Optional. The date (in Pacific Time) when the cluster version was released. + * + * Generated from protobuf field .google.type.Date release_date = 6 [(.google.api.field_behavior) = OPTIONAL]; + * @param \Google\Type\Date $var + * @return $this + */ + public function setReleaseDate($var) + { + GPBUtil::checkMessage($var, \Google\Type\Date::class); + $this->release_date = $var; + + return $this; + } + } diff --git a/GkeMultiCloud/src/V1/AwsAuthorization.php b/GkeMultiCloud/src/V1/AwsAuthorization.php index 25f25a6866ee..c4e129dda538 100644 --- a/GkeMultiCloud/src/V1/AwsAuthorization.php +++ b/GkeMultiCloud/src/V1/AwsAuthorization.php @@ -11,6 +11,7 @@ /** * Configuration related to the cluster RBAC settings. * + * @deprecated * Generated from protobuf message google.cloud.gkemulticloud.v1.AwsAuthorization */ class AwsAuthorization extends \Google\Protobuf\Internal\Message diff --git a/GkeMultiCloud/src/V1/AwsAutoscalingGroupMetricsCollection.php b/GkeMultiCloud/src/V1/AwsAutoscalingGroupMetricsCollection.php index dddb1fd5dc97..cd5c36eaf20f 100644 --- a/GkeMultiCloud/src/V1/AwsAutoscalingGroupMetricsCollection.php +++ b/GkeMultiCloud/src/V1/AwsAutoscalingGroupMetricsCollection.php @@ -12,6 +12,7 @@ * Configuration related to CloudWatch metrics collection in an AWS * Auto Scaling group. * + * @deprecated * Generated from protobuf message google.cloud.gkemulticloud.v1.AwsAutoscalingGroupMetricsCollection */ class AwsAutoscalingGroupMetricsCollection extends \Google\Protobuf\Internal\Message diff --git a/GkeMultiCloud/src/V1/AwsCluster.php b/GkeMultiCloud/src/V1/AwsCluster.php index 68baa291c95b..d6db6c9bf3f3 100644 --- a/GkeMultiCloud/src/V1/AwsCluster.php +++ b/GkeMultiCloud/src/V1/AwsCluster.php @@ -11,6 +11,7 @@ /** * An Anthos cluster running on AWS. * + * @deprecated * Generated from protobuf message google.cloud.gkemulticloud.v1.AwsCluster */ class AwsCluster extends \Google\Protobuf\Internal\Message diff --git a/GkeMultiCloud/src/V1/AwsClusterError.php b/GkeMultiCloud/src/V1/AwsClusterError.php index f40a291a78f8..6fec54853532 100644 --- a/GkeMultiCloud/src/V1/AwsClusterError.php +++ b/GkeMultiCloud/src/V1/AwsClusterError.php @@ -11,6 +11,7 @@ /** * AwsClusterError describes errors found on AWS clusters. * + * @deprecated * Generated from protobuf message google.cloud.gkemulticloud.v1.AwsClusterError */ class AwsClusterError extends \Google\Protobuf\Internal\Message diff --git a/GkeMultiCloud/src/V1/AwsClusterGroup.php b/GkeMultiCloud/src/V1/AwsClusterGroup.php index 6c954b94c1b2..b390f121f5a7 100644 --- a/GkeMultiCloud/src/V1/AwsClusterGroup.php +++ b/GkeMultiCloud/src/V1/AwsClusterGroup.php @@ -11,6 +11,7 @@ /** * Identities of a group-type subject for AWS clusters. * + * @deprecated * Generated from protobuf message google.cloud.gkemulticloud.v1.AwsClusterGroup */ class AwsClusterGroup extends \Google\Protobuf\Internal\Message diff --git a/GkeMultiCloud/src/V1/AwsClusterNetworking.php b/GkeMultiCloud/src/V1/AwsClusterNetworking.php index 9301c3f5e52d..51b7e2f324bc 100644 --- a/GkeMultiCloud/src/V1/AwsClusterNetworking.php +++ b/GkeMultiCloud/src/V1/AwsClusterNetworking.php @@ -13,6 +13,7 @@ * Anthos clusters on AWS run on a single VPC. This includes control * plane replicas and node pool nodes. * + * @deprecated * Generated from protobuf message google.cloud.gkemulticloud.v1.AwsClusterNetworking */ class AwsClusterNetworking extends \Google\Protobuf\Internal\Message diff --git a/GkeMultiCloud/src/V1/AwsClusterUser.php b/GkeMultiCloud/src/V1/AwsClusterUser.php index 005bd094c801..3c8eb7a36b00 100644 --- a/GkeMultiCloud/src/V1/AwsClusterUser.php +++ b/GkeMultiCloud/src/V1/AwsClusterUser.php @@ -11,6 +11,7 @@ /** * Identities of a user-type subject for AWS clusters. * + * @deprecated * Generated from protobuf message google.cloud.gkemulticloud.v1.AwsClusterUser */ class AwsClusterUser extends \Google\Protobuf\Internal\Message diff --git a/GkeMultiCloud/src/V1/AwsConfigEncryption.php b/GkeMultiCloud/src/V1/AwsConfigEncryption.php index ed4be8aef12a..8f7cb3fd7176 100644 --- a/GkeMultiCloud/src/V1/AwsConfigEncryption.php +++ b/GkeMultiCloud/src/V1/AwsConfigEncryption.php @@ -11,6 +11,7 @@ /** * Config encryption for user data. * + * @deprecated * Generated from protobuf message google.cloud.gkemulticloud.v1.AwsConfigEncryption */ class AwsConfigEncryption extends \Google\Protobuf\Internal\Message diff --git a/GkeMultiCloud/src/V1/AwsControlPlane.php b/GkeMultiCloud/src/V1/AwsControlPlane.php index 826ee8af1a67..c0d7286ef98f 100644 --- a/GkeMultiCloud/src/V1/AwsControlPlane.php +++ b/GkeMultiCloud/src/V1/AwsControlPlane.php @@ -11,6 +11,7 @@ /** * ControlPlane defines common parameters between control plane nodes. * + * @deprecated * Generated from protobuf message google.cloud.gkemulticloud.v1.AwsControlPlane */ class AwsControlPlane extends \Google\Protobuf\Internal\Message diff --git a/GkeMultiCloud/src/V1/AwsDatabaseEncryption.php b/GkeMultiCloud/src/V1/AwsDatabaseEncryption.php index e7e0ce60bd12..88fa42581b47 100644 --- a/GkeMultiCloud/src/V1/AwsDatabaseEncryption.php +++ b/GkeMultiCloud/src/V1/AwsDatabaseEncryption.php @@ -11,6 +11,7 @@ /** * Configuration related to application-layer secrets encryption. * + * @deprecated * Generated from protobuf message google.cloud.gkemulticloud.v1.AwsDatabaseEncryption */ class AwsDatabaseEncryption extends \Google\Protobuf\Internal\Message diff --git a/GkeMultiCloud/src/V1/AwsInstancePlacement.php b/GkeMultiCloud/src/V1/AwsInstancePlacement.php index e2eccd85ae67..2b92365d8095 100644 --- a/GkeMultiCloud/src/V1/AwsInstancePlacement.php +++ b/GkeMultiCloud/src/V1/AwsInstancePlacement.php @@ -14,6 +14,7 @@ * * T3 instances that use the unlimited CPU credit option don't support host * tenancy. * + * @deprecated * Generated from protobuf message google.cloud.gkemulticloud.v1.AwsInstancePlacement */ class AwsInstancePlacement extends \Google\Protobuf\Internal\Message diff --git a/GkeMultiCloud/src/V1/AwsJsonWebKeys.php b/GkeMultiCloud/src/V1/AwsJsonWebKeys.php index 507b3ad8de02..cd66551cc6b8 100644 --- a/GkeMultiCloud/src/V1/AwsJsonWebKeys.php +++ b/GkeMultiCloud/src/V1/AwsJsonWebKeys.php @@ -11,6 +11,7 @@ /** * AwsJsonWebKeys is a valid JSON Web Key Set as specififed in RFC 7517. * + * @deprecated * Generated from protobuf message google.cloud.gkemulticloud.v1.AwsJsonWebKeys */ class AwsJsonWebKeys extends \Google\Protobuf\Internal\Message diff --git a/GkeMultiCloud/src/V1/AwsK8sVersionInfo.php b/GkeMultiCloud/src/V1/AwsK8sVersionInfo.php index 9e560d4e09ec..8b7a0376758a 100644 --- a/GkeMultiCloud/src/V1/AwsK8sVersionInfo.php +++ b/GkeMultiCloud/src/V1/AwsK8sVersionInfo.php @@ -11,6 +11,7 @@ /** * Kubernetes version information of GKE cluster on AWS. * + * @deprecated * Generated from protobuf message google.cloud.gkemulticloud.v1.AwsK8sVersionInfo */ class AwsK8sVersionInfo extends \Google\Protobuf\Internal\Message diff --git a/GkeMultiCloud/src/V1/AwsNodeConfig.php b/GkeMultiCloud/src/V1/AwsNodeConfig.php index 9b48cad7dd0b..bb717c533c3f 100644 --- a/GkeMultiCloud/src/V1/AwsNodeConfig.php +++ b/GkeMultiCloud/src/V1/AwsNodeConfig.php @@ -11,6 +11,7 @@ /** * Parameters that describe the nodes in a cluster. * + * @deprecated * Generated from protobuf message google.cloud.gkemulticloud.v1.AwsNodeConfig */ class AwsNodeConfig extends \Google\Protobuf\Internal\Message diff --git a/GkeMultiCloud/src/V1/AwsNodeManagement.php b/GkeMultiCloud/src/V1/AwsNodeManagement.php index 881f7bcf2ef8..e468162dc03c 100644 --- a/GkeMultiCloud/src/V1/AwsNodeManagement.php +++ b/GkeMultiCloud/src/V1/AwsNodeManagement.php @@ -12,6 +12,7 @@ * AwsNodeManagement defines the set of node management features turned on for * an AWS node pool. * + * @deprecated * Generated from protobuf message google.cloud.gkemulticloud.v1.AwsNodeManagement */ class AwsNodeManagement extends \Google\Protobuf\Internal\Message diff --git a/GkeMultiCloud/src/V1/AwsNodePool.php b/GkeMultiCloud/src/V1/AwsNodePool.php index 7ece9f98386a..7cbc678d289e 100644 --- a/GkeMultiCloud/src/V1/AwsNodePool.php +++ b/GkeMultiCloud/src/V1/AwsNodePool.php @@ -11,6 +11,7 @@ /** * An Anthos node pool running on AWS. * + * @deprecated * Generated from protobuf message google.cloud.gkemulticloud.v1.AwsNodePool */ class AwsNodePool extends \Google\Protobuf\Internal\Message diff --git a/GkeMultiCloud/src/V1/AwsNodePoolAutoscaling.php b/GkeMultiCloud/src/V1/AwsNodePoolAutoscaling.php index fa2cda6ccf53..c7bcf64db490 100644 --- a/GkeMultiCloud/src/V1/AwsNodePoolAutoscaling.php +++ b/GkeMultiCloud/src/V1/AwsNodePoolAutoscaling.php @@ -12,6 +12,7 @@ * AwsNodePoolAutoscaling contains information required by cluster autoscaler * to adjust the size of the node pool to the current cluster usage. * + * @deprecated * Generated from protobuf message google.cloud.gkemulticloud.v1.AwsNodePoolAutoscaling */ class AwsNodePoolAutoscaling extends \Google\Protobuf\Internal\Message diff --git a/GkeMultiCloud/src/V1/AwsNodePoolError.php b/GkeMultiCloud/src/V1/AwsNodePoolError.php index c5a04b7d3934..c661bc9d710b 100644 --- a/GkeMultiCloud/src/V1/AwsNodePoolError.php +++ b/GkeMultiCloud/src/V1/AwsNodePoolError.php @@ -11,6 +11,7 @@ /** * AwsNodePoolError describes errors found on AWS node pools. * + * @deprecated * Generated from protobuf message google.cloud.gkemulticloud.v1.AwsNodePoolError */ class AwsNodePoolError extends \Google\Protobuf\Internal\Message diff --git a/GkeMultiCloud/src/V1/AwsOpenIdConfig.php b/GkeMultiCloud/src/V1/AwsOpenIdConfig.php index 01857611cf0f..74d370c1b5f0 100644 --- a/GkeMultiCloud/src/V1/AwsOpenIdConfig.php +++ b/GkeMultiCloud/src/V1/AwsOpenIdConfig.php @@ -12,6 +12,7 @@ * AwsOpenIdConfig is an OIDC discovery document for the cluster. * See the OpenID Connect Discovery 1.0 specification for details. * + * @deprecated * Generated from protobuf message google.cloud.gkemulticloud.v1.AwsOpenIdConfig */ class AwsOpenIdConfig extends \Google\Protobuf\Internal\Message @@ -25,37 +26,37 @@ class AwsOpenIdConfig extends \Google\Protobuf\Internal\Message /** * JSON Web Key uri. * - * Generated from protobuf field string jwks_uri = 2; + * Generated from protobuf field string jwks_uri = 2 [json_name = "jwks_uri"]; */ protected $jwks_uri = ''; /** * Supported response types. * - * Generated from protobuf field repeated string response_types_supported = 3; + * Generated from protobuf field repeated string response_types_supported = 3 [json_name = "response_types_supported"]; */ private $response_types_supported; /** * Supported subject types. * - * Generated from protobuf field repeated string subject_types_supported = 4; + * Generated from protobuf field repeated string subject_types_supported = 4 [json_name = "subject_types_supported"]; */ private $subject_types_supported; /** * supported ID Token signing Algorithms. * - * Generated from protobuf field repeated string id_token_signing_alg_values_supported = 5; + * Generated from protobuf field repeated string id_token_signing_alg_values_supported = 5 [json_name = "id_token_signing_alg_values_supported"]; */ private $id_token_signing_alg_values_supported; /** * Supported claims. * - * Generated from protobuf field repeated string claims_supported = 6; + * Generated from protobuf field repeated string claims_supported = 6 [json_name = "claims_supported"]; */ private $claims_supported; /** * Supported grant types. * - * Generated from protobuf field repeated string grant_types = 7; + * Generated from protobuf field repeated string grant_types = 7 [json_name = "grant_types"]; */ private $grant_types; @@ -115,7 +116,7 @@ public function setIssuer($var) /** * JSON Web Key uri. * - * Generated from protobuf field string jwks_uri = 2; + * Generated from protobuf field string jwks_uri = 2 [json_name = "jwks_uri"]; * @return string */ public function getJwksUri() @@ -126,7 +127,7 @@ public function getJwksUri() /** * JSON Web Key uri. * - * Generated from protobuf field string jwks_uri = 2; + * Generated from protobuf field string jwks_uri = 2 [json_name = "jwks_uri"]; * @param string $var * @return $this */ @@ -141,7 +142,7 @@ public function setJwksUri($var) /** * Supported response types. * - * Generated from protobuf field repeated string response_types_supported = 3; + * Generated from protobuf field repeated string response_types_supported = 3 [json_name = "response_types_supported"]; * @return \Google\Protobuf\Internal\RepeatedField */ public function getResponseTypesSupported() @@ -152,7 +153,7 @@ public function getResponseTypesSupported() /** * Supported response types. * - * Generated from protobuf field repeated string response_types_supported = 3; + * Generated from protobuf field repeated string response_types_supported = 3 [json_name = "response_types_supported"]; * @param array|\Google\Protobuf\Internal\RepeatedField $var * @return $this */ @@ -167,7 +168,7 @@ public function setResponseTypesSupported($var) /** * Supported subject types. * - * Generated from protobuf field repeated string subject_types_supported = 4; + * Generated from protobuf field repeated string subject_types_supported = 4 [json_name = "subject_types_supported"]; * @return \Google\Protobuf\Internal\RepeatedField */ public function getSubjectTypesSupported() @@ -178,7 +179,7 @@ public function getSubjectTypesSupported() /** * Supported subject types. * - * Generated from protobuf field repeated string subject_types_supported = 4; + * Generated from protobuf field repeated string subject_types_supported = 4 [json_name = "subject_types_supported"]; * @param array|\Google\Protobuf\Internal\RepeatedField $var * @return $this */ @@ -193,7 +194,7 @@ public function setSubjectTypesSupported($var) /** * supported ID Token signing Algorithms. * - * Generated from protobuf field repeated string id_token_signing_alg_values_supported = 5; + * Generated from protobuf field repeated string id_token_signing_alg_values_supported = 5 [json_name = "id_token_signing_alg_values_supported"]; * @return \Google\Protobuf\Internal\RepeatedField */ public function getIdTokenSigningAlgValuesSupported() @@ -204,7 +205,7 @@ public function getIdTokenSigningAlgValuesSupported() /** * supported ID Token signing Algorithms. * - * Generated from protobuf field repeated string id_token_signing_alg_values_supported = 5; + * Generated from protobuf field repeated string id_token_signing_alg_values_supported = 5 [json_name = "id_token_signing_alg_values_supported"]; * @param array|\Google\Protobuf\Internal\RepeatedField $var * @return $this */ @@ -219,7 +220,7 @@ public function setIdTokenSigningAlgValuesSupported($var) /** * Supported claims. * - * Generated from protobuf field repeated string claims_supported = 6; + * Generated from protobuf field repeated string claims_supported = 6 [json_name = "claims_supported"]; * @return \Google\Protobuf\Internal\RepeatedField */ public function getClaimsSupported() @@ -230,7 +231,7 @@ public function getClaimsSupported() /** * Supported claims. * - * Generated from protobuf field repeated string claims_supported = 6; + * Generated from protobuf field repeated string claims_supported = 6 [json_name = "claims_supported"]; * @param array|\Google\Protobuf\Internal\RepeatedField $var * @return $this */ @@ -245,7 +246,7 @@ public function setClaimsSupported($var) /** * Supported grant types. * - * Generated from protobuf field repeated string grant_types = 7; + * Generated from protobuf field repeated string grant_types = 7 [json_name = "grant_types"]; * @return \Google\Protobuf\Internal\RepeatedField */ public function getGrantTypes() @@ -256,7 +257,7 @@ public function getGrantTypes() /** * Supported grant types. * - * Generated from protobuf field repeated string grant_types = 7; + * Generated from protobuf field repeated string grant_types = 7 [json_name = "grant_types"]; * @param array|\Google\Protobuf\Internal\RepeatedField $var * @return $this */ diff --git a/GkeMultiCloud/src/V1/AwsProxyConfig.php b/GkeMultiCloud/src/V1/AwsProxyConfig.php index 25712e08c4ae..a7df476f5ffc 100644 --- a/GkeMultiCloud/src/V1/AwsProxyConfig.php +++ b/GkeMultiCloud/src/V1/AwsProxyConfig.php @@ -11,6 +11,7 @@ /** * Details of a proxy config stored in AWS Secret Manager. * + * @deprecated * Generated from protobuf message google.cloud.gkemulticloud.v1.AwsProxyConfig */ class AwsProxyConfig extends \Google\Protobuf\Internal\Message diff --git a/GkeMultiCloud/src/V1/AwsServerConfig.php b/GkeMultiCloud/src/V1/AwsServerConfig.php index 04d329be8dfa..5f89537bd9d2 100644 --- a/GkeMultiCloud/src/V1/AwsServerConfig.php +++ b/GkeMultiCloud/src/V1/AwsServerConfig.php @@ -11,6 +11,7 @@ /** * AwsServerConfig is the configuration of GKE cluster on AWS. * + * @deprecated * Generated from protobuf message google.cloud.gkemulticloud.v1.AwsServerConfig */ class AwsServerConfig extends \Google\Protobuf\Internal\Message diff --git a/GkeMultiCloud/src/V1/AwsServicesAuthentication.php b/GkeMultiCloud/src/V1/AwsServicesAuthentication.php index cef249ad091f..6cb9dc3dd07a 100644 --- a/GkeMultiCloud/src/V1/AwsServicesAuthentication.php +++ b/GkeMultiCloud/src/V1/AwsServicesAuthentication.php @@ -11,6 +11,7 @@ /** * Authentication configuration for the management of AWS resources. * + * @deprecated * Generated from protobuf message google.cloud.gkemulticloud.v1.AwsServicesAuthentication */ class AwsServicesAuthentication extends \Google\Protobuf\Internal\Message diff --git a/GkeMultiCloud/src/V1/AwsSshConfig.php b/GkeMultiCloud/src/V1/AwsSshConfig.php index a3e356328b16..fdaf3e0c65a9 100644 --- a/GkeMultiCloud/src/V1/AwsSshConfig.php +++ b/GkeMultiCloud/src/V1/AwsSshConfig.php @@ -11,6 +11,7 @@ /** * SSH configuration for AWS resources. * + * @deprecated * Generated from protobuf message google.cloud.gkemulticloud.v1.AwsSshConfig */ class AwsSshConfig extends \Google\Protobuf\Internal\Message diff --git a/GkeMultiCloud/src/V1/AwsVolumeTemplate.php b/GkeMultiCloud/src/V1/AwsVolumeTemplate.php index 4a6ca5810edc..75a5fc9e18c7 100644 --- a/GkeMultiCloud/src/V1/AwsVolumeTemplate.php +++ b/GkeMultiCloud/src/V1/AwsVolumeTemplate.php @@ -11,6 +11,7 @@ /** * Configuration template for AWS EBS volumes. * + * @deprecated * Generated from protobuf message google.cloud.gkemulticloud.v1.AwsVolumeTemplate */ class AwsVolumeTemplate extends \Google\Protobuf\Internal\Message @@ -40,7 +41,7 @@ class AwsVolumeTemplate extends \Google\Protobuf\Internal\Message /** * Optional. The throughput that the volume supports, in MiB/s. Only valid if * volume_type is GP3. - * If the volume_type is GP3 and this is not speficied, it defaults to 125. + * If the volume_type is GP3 and this is not specified, it defaults to 125. * * Generated from protobuf field int32 throughput = 5 [(.google.api.field_behavior) = OPTIONAL]; */ @@ -74,7 +75,7 @@ class AwsVolumeTemplate extends \Google\Protobuf\Internal\Message * @type int $throughput * Optional. The throughput that the volume supports, in MiB/s. Only valid if * volume_type is GP3. - * If the volume_type is GP3 and this is not speficied, it defaults to 125. + * If the volume_type is GP3 and this is not specified, it defaults to 125. * @type string $kms_key_arn * Optional. The Amazon Resource Name (ARN) of the Customer Managed Key (CMK) * used to encrypt AWS EBS volumes. @@ -176,7 +177,7 @@ public function setIops($var) /** * Optional. The throughput that the volume supports, in MiB/s. Only valid if * volume_type is GP3. - * If the volume_type is GP3 and this is not speficied, it defaults to 125. + * If the volume_type is GP3 and this is not specified, it defaults to 125. * * Generated from protobuf field int32 throughput = 5 [(.google.api.field_behavior) = OPTIONAL]; * @return int @@ -189,7 +190,7 @@ public function getThroughput() /** * Optional. The throughput that the volume supports, in MiB/s. Only valid if * volume_type is GP3. - * If the volume_type is GP3 and this is not speficied, it defaults to 125. + * If the volume_type is GP3 and this is not specified, it defaults to 125. * * Generated from protobuf field int32 throughput = 5 [(.google.api.field_behavior) = OPTIONAL]; * @param int $var diff --git a/GkeMultiCloud/src/V1/AzureAuthorization.php b/GkeMultiCloud/src/V1/AzureAuthorization.php index 25a4862f0652..fffece44f47b 100644 --- a/GkeMultiCloud/src/V1/AzureAuthorization.php +++ b/GkeMultiCloud/src/V1/AzureAuthorization.php @@ -11,6 +11,7 @@ /** * Configuration related to the cluster RBAC settings. * + * @deprecated * Generated from protobuf message google.cloud.gkemulticloud.v1.AzureAuthorization */ class AzureAuthorization extends \Google\Protobuf\Internal\Message diff --git a/GkeMultiCloud/src/V1/AzureClient.php b/GkeMultiCloud/src/V1/AzureClient.php index 002830ccfddd..a22d4f00adba 100644 --- a/GkeMultiCloud/src/V1/AzureClient.php +++ b/GkeMultiCloud/src/V1/AzureClient.php @@ -19,6 +19,7 @@ * Each `AzureClient` resource is bound to a single Azure Active Directory * Application and tenant. * + * @deprecated * Generated from protobuf message google.cloud.gkemulticloud.v1.AzureClient */ class AzureClient extends \Google\Protobuf\Internal\Message diff --git a/GkeMultiCloud/src/V1/AzureCluster.php b/GkeMultiCloud/src/V1/AzureCluster.php index fb3117ed00b6..77e30a8c4c0f 100644 --- a/GkeMultiCloud/src/V1/AzureCluster.php +++ b/GkeMultiCloud/src/V1/AzureCluster.php @@ -11,6 +11,7 @@ /** * An Anthos cluster running on Azure. * + * @deprecated * Generated from protobuf message google.cloud.gkemulticloud.v1.AzureCluster */ class AzureCluster extends \Google\Protobuf\Internal\Message diff --git a/GkeMultiCloud/src/V1/AzureClusterError.php b/GkeMultiCloud/src/V1/AzureClusterError.php index cf9a9b6b2e5d..bdf9b50129af 100644 --- a/GkeMultiCloud/src/V1/AzureClusterError.php +++ b/GkeMultiCloud/src/V1/AzureClusterError.php @@ -11,6 +11,7 @@ /** * AzureClusterError describes errors found on Azure clusters. * + * @deprecated * Generated from protobuf message google.cloud.gkemulticloud.v1.AzureClusterError */ class AzureClusterError extends \Google\Protobuf\Internal\Message diff --git a/GkeMultiCloud/src/V1/AzureClusterGroup.php b/GkeMultiCloud/src/V1/AzureClusterGroup.php index dee74b296f31..6c31fdeacb52 100644 --- a/GkeMultiCloud/src/V1/AzureClusterGroup.php +++ b/GkeMultiCloud/src/V1/AzureClusterGroup.php @@ -11,6 +11,7 @@ /** * Identities of a group-type subject for Azure clusters. * + * @deprecated * Generated from protobuf message google.cloud.gkemulticloud.v1.AzureClusterGroup */ class AzureClusterGroup extends \Google\Protobuf\Internal\Message diff --git a/GkeMultiCloud/src/V1/AzureClusterNetworking.php b/GkeMultiCloud/src/V1/AzureClusterNetworking.php index c4425dee6e7c..0855e55e21f2 100644 --- a/GkeMultiCloud/src/V1/AzureClusterNetworking.php +++ b/GkeMultiCloud/src/V1/AzureClusterNetworking.php @@ -11,6 +11,7 @@ /** * ClusterNetworking contains cluster-wide networking configuration. * + * @deprecated * Generated from protobuf message google.cloud.gkemulticloud.v1.AzureClusterNetworking */ class AzureClusterNetworking extends \Google\Protobuf\Internal\Message diff --git a/GkeMultiCloud/src/V1/AzureClusterResources.php b/GkeMultiCloud/src/V1/AzureClusterResources.php index ca301cadedac..6ace5c10711a 100644 --- a/GkeMultiCloud/src/V1/AzureClusterResources.php +++ b/GkeMultiCloud/src/V1/AzureClusterResources.php @@ -12,6 +12,7 @@ * Managed Azure resources for the cluster. * The values could change and be empty, depending on the state of the cluster. * + * @deprecated * Generated from protobuf message google.cloud.gkemulticloud.v1.AzureClusterResources */ class AzureClusterResources extends \Google\Protobuf\Internal\Message diff --git a/GkeMultiCloud/src/V1/AzureClusterUser.php b/GkeMultiCloud/src/V1/AzureClusterUser.php index 3aecd59fbf61..6873cb8c51f4 100644 --- a/GkeMultiCloud/src/V1/AzureClusterUser.php +++ b/GkeMultiCloud/src/V1/AzureClusterUser.php @@ -11,6 +11,7 @@ /** * Identities of a user-type subject for Azure clusters. * + * @deprecated * Generated from protobuf message google.cloud.gkemulticloud.v1.AzureClusterUser */ class AzureClusterUser extends \Google\Protobuf\Internal\Message diff --git a/GkeMultiCloud/src/V1/AzureConfigEncryption.php b/GkeMultiCloud/src/V1/AzureConfigEncryption.php index f90fcdd501a4..e58b6638a250 100644 --- a/GkeMultiCloud/src/V1/AzureConfigEncryption.php +++ b/GkeMultiCloud/src/V1/AzureConfigEncryption.php @@ -13,6 +13,7 @@ * Azure VM bootstrap secret is envelope encrypted with the provided key vault * key. * + * @deprecated * Generated from protobuf message google.cloud.gkemulticloud.v1.AzureConfigEncryption */ class AzureConfigEncryption extends \Google\Protobuf\Internal\Message diff --git a/GkeMultiCloud/src/V1/AzureControlPlane.php b/GkeMultiCloud/src/V1/AzureControlPlane.php index 92f3fed0095f..1a86cb335b53 100644 --- a/GkeMultiCloud/src/V1/AzureControlPlane.php +++ b/GkeMultiCloud/src/V1/AzureControlPlane.php @@ -11,6 +11,7 @@ /** * AzureControlPlane represents the control plane configurations. * + * @deprecated * Generated from protobuf message google.cloud.gkemulticloud.v1.AzureControlPlane */ class AzureControlPlane extends \Google\Protobuf\Internal\Message diff --git a/GkeMultiCloud/src/V1/AzureDatabaseEncryption.php b/GkeMultiCloud/src/V1/AzureDatabaseEncryption.php index 21c7b8009267..09ae2bb937ef 100644 --- a/GkeMultiCloud/src/V1/AzureDatabaseEncryption.php +++ b/GkeMultiCloud/src/V1/AzureDatabaseEncryption.php @@ -13,6 +13,7 @@ * Anthos clusters on Azure encrypts your Kubernetes data at rest * in etcd using Azure Key Vault. * + * @deprecated * Generated from protobuf message google.cloud.gkemulticloud.v1.AzureDatabaseEncryption */ class AzureDatabaseEncryption extends \Google\Protobuf\Internal\Message diff --git a/GkeMultiCloud/src/V1/AzureDiskTemplate.php b/GkeMultiCloud/src/V1/AzureDiskTemplate.php index f3c1a39446b7..69b6a299d9d7 100644 --- a/GkeMultiCloud/src/V1/AzureDiskTemplate.php +++ b/GkeMultiCloud/src/V1/AzureDiskTemplate.php @@ -11,6 +11,7 @@ /** * Configuration for Azure Disks. * + * @deprecated * Generated from protobuf message google.cloud.gkemulticloud.v1.AzureDiskTemplate */ class AzureDiskTemplate extends \Google\Protobuf\Internal\Message diff --git a/GkeMultiCloud/src/V1/AzureJsonWebKeys.php b/GkeMultiCloud/src/V1/AzureJsonWebKeys.php index bc3324265977..7409b7385da3 100644 --- a/GkeMultiCloud/src/V1/AzureJsonWebKeys.php +++ b/GkeMultiCloud/src/V1/AzureJsonWebKeys.php @@ -11,6 +11,7 @@ /** * AzureJsonWebKeys is a valid JSON Web Key Set as specififed in RFC 7517. * + * @deprecated * Generated from protobuf message google.cloud.gkemulticloud.v1.AzureJsonWebKeys */ class AzureJsonWebKeys extends \Google\Protobuf\Internal\Message diff --git a/GkeMultiCloud/src/V1/AzureK8sVersionInfo.php b/GkeMultiCloud/src/V1/AzureK8sVersionInfo.php index c454dce8f80f..d54015034aba 100644 --- a/GkeMultiCloud/src/V1/AzureK8sVersionInfo.php +++ b/GkeMultiCloud/src/V1/AzureK8sVersionInfo.php @@ -11,6 +11,7 @@ /** * Kubernetes version information of GKE cluster on Azure. * + * @deprecated * Generated from protobuf message google.cloud.gkemulticloud.v1.AzureK8sVersionInfo */ class AzureK8sVersionInfo extends \Google\Protobuf\Internal\Message diff --git a/GkeMultiCloud/src/V1/AzureNodeConfig.php b/GkeMultiCloud/src/V1/AzureNodeConfig.php index 8167a17060ad..b0ef155befa7 100644 --- a/GkeMultiCloud/src/V1/AzureNodeConfig.php +++ b/GkeMultiCloud/src/V1/AzureNodeConfig.php @@ -12,6 +12,7 @@ * Parameters that describe the configuration of all node machines * on a given node pool. * + * @deprecated * Generated from protobuf message google.cloud.gkemulticloud.v1.AzureNodeConfig */ class AzureNodeConfig extends \Google\Protobuf\Internal\Message diff --git a/GkeMultiCloud/src/V1/AzureNodeManagement.php b/GkeMultiCloud/src/V1/AzureNodeManagement.php index fafb582d67b4..5f06e82d1702 100644 --- a/GkeMultiCloud/src/V1/AzureNodeManagement.php +++ b/GkeMultiCloud/src/V1/AzureNodeManagement.php @@ -12,6 +12,7 @@ * AzureNodeManagement defines the set of node management features turned on for * an Azure node pool. * + * @deprecated * Generated from protobuf message google.cloud.gkemulticloud.v1.AzureNodeManagement */ class AzureNodeManagement extends \Google\Protobuf\Internal\Message diff --git a/GkeMultiCloud/src/V1/AzureNodePool.php b/GkeMultiCloud/src/V1/AzureNodePool.php index d2fd28ceca6e..0aa33d11af51 100644 --- a/GkeMultiCloud/src/V1/AzureNodePool.php +++ b/GkeMultiCloud/src/V1/AzureNodePool.php @@ -11,6 +11,7 @@ /** * An Anthos node pool running on Azure. * + * @deprecated * Generated from protobuf message google.cloud.gkemulticloud.v1.AzureNodePool */ class AzureNodePool extends \Google\Protobuf\Internal\Message diff --git a/GkeMultiCloud/src/V1/AzureNodePoolAutoscaling.php b/GkeMultiCloud/src/V1/AzureNodePoolAutoscaling.php index 2688e11da544..c9d4170ce7a4 100644 --- a/GkeMultiCloud/src/V1/AzureNodePoolAutoscaling.php +++ b/GkeMultiCloud/src/V1/AzureNodePoolAutoscaling.php @@ -13,6 +13,7 @@ * The Kubernetes cluster autoscaler will automatically adjust the * size of the node pool based on the cluster load. * + * @deprecated * Generated from protobuf message google.cloud.gkemulticloud.v1.AzureNodePoolAutoscaling */ class AzureNodePoolAutoscaling extends \Google\Protobuf\Internal\Message diff --git a/GkeMultiCloud/src/V1/AzureNodePoolError.php b/GkeMultiCloud/src/V1/AzureNodePoolError.php index 854ce75b671a..b34aa907c9a3 100644 --- a/GkeMultiCloud/src/V1/AzureNodePoolError.php +++ b/GkeMultiCloud/src/V1/AzureNodePoolError.php @@ -11,6 +11,7 @@ /** * AzureNodePoolError describes errors found on Azure node pools. * + * @deprecated * Generated from protobuf message google.cloud.gkemulticloud.v1.AzureNodePoolError */ class AzureNodePoolError extends \Google\Protobuf\Internal\Message diff --git a/GkeMultiCloud/src/V1/AzureOpenIdConfig.php b/GkeMultiCloud/src/V1/AzureOpenIdConfig.php index cad099ee30e3..09796b25ce8a 100644 --- a/GkeMultiCloud/src/V1/AzureOpenIdConfig.php +++ b/GkeMultiCloud/src/V1/AzureOpenIdConfig.php @@ -12,6 +12,7 @@ * AzureOpenIdConfig is an OIDC discovery document for the cluster. * See the OpenID Connect Discovery 1.0 specification for details. * + * @deprecated * Generated from protobuf message google.cloud.gkemulticloud.v1.AzureOpenIdConfig */ class AzureOpenIdConfig extends \Google\Protobuf\Internal\Message @@ -25,37 +26,37 @@ class AzureOpenIdConfig extends \Google\Protobuf\Internal\Message /** * JSON Web Key uri. * - * Generated from protobuf field string jwks_uri = 2; + * Generated from protobuf field string jwks_uri = 2 [json_name = "jwks_uri"]; */ protected $jwks_uri = ''; /** * Supported response types. * - * Generated from protobuf field repeated string response_types_supported = 3; + * Generated from protobuf field repeated string response_types_supported = 3 [json_name = "response_types_supported"]; */ private $response_types_supported; /** * Supported subject types. * - * Generated from protobuf field repeated string subject_types_supported = 4; + * Generated from protobuf field repeated string subject_types_supported = 4 [json_name = "subject_types_supported"]; */ private $subject_types_supported; /** * supported ID Token signing Algorithms. * - * Generated from protobuf field repeated string id_token_signing_alg_values_supported = 5; + * Generated from protobuf field repeated string id_token_signing_alg_values_supported = 5 [json_name = "id_token_signing_alg_values_supported"]; */ private $id_token_signing_alg_values_supported; /** * Supported claims. * - * Generated from protobuf field repeated string claims_supported = 6; + * Generated from protobuf field repeated string claims_supported = 6 [json_name = "claims_supported"]; */ private $claims_supported; /** * Supported grant types. * - * Generated from protobuf field repeated string grant_types = 7; + * Generated from protobuf field repeated string grant_types = 7 [json_name = "grant_types"]; */ private $grant_types; @@ -115,7 +116,7 @@ public function setIssuer($var) /** * JSON Web Key uri. * - * Generated from protobuf field string jwks_uri = 2; + * Generated from protobuf field string jwks_uri = 2 [json_name = "jwks_uri"]; * @return string */ public function getJwksUri() @@ -126,7 +127,7 @@ public function getJwksUri() /** * JSON Web Key uri. * - * Generated from protobuf field string jwks_uri = 2; + * Generated from protobuf field string jwks_uri = 2 [json_name = "jwks_uri"]; * @param string $var * @return $this */ @@ -141,7 +142,7 @@ public function setJwksUri($var) /** * Supported response types. * - * Generated from protobuf field repeated string response_types_supported = 3; + * Generated from protobuf field repeated string response_types_supported = 3 [json_name = "response_types_supported"]; * @return \Google\Protobuf\Internal\RepeatedField */ public function getResponseTypesSupported() @@ -152,7 +153,7 @@ public function getResponseTypesSupported() /** * Supported response types. * - * Generated from protobuf field repeated string response_types_supported = 3; + * Generated from protobuf field repeated string response_types_supported = 3 [json_name = "response_types_supported"]; * @param array|\Google\Protobuf\Internal\RepeatedField $var * @return $this */ @@ -167,7 +168,7 @@ public function setResponseTypesSupported($var) /** * Supported subject types. * - * Generated from protobuf field repeated string subject_types_supported = 4; + * Generated from protobuf field repeated string subject_types_supported = 4 [json_name = "subject_types_supported"]; * @return \Google\Protobuf\Internal\RepeatedField */ public function getSubjectTypesSupported() @@ -178,7 +179,7 @@ public function getSubjectTypesSupported() /** * Supported subject types. * - * Generated from protobuf field repeated string subject_types_supported = 4; + * Generated from protobuf field repeated string subject_types_supported = 4 [json_name = "subject_types_supported"]; * @param array|\Google\Protobuf\Internal\RepeatedField $var * @return $this */ @@ -193,7 +194,7 @@ public function setSubjectTypesSupported($var) /** * supported ID Token signing Algorithms. * - * Generated from protobuf field repeated string id_token_signing_alg_values_supported = 5; + * Generated from protobuf field repeated string id_token_signing_alg_values_supported = 5 [json_name = "id_token_signing_alg_values_supported"]; * @return \Google\Protobuf\Internal\RepeatedField */ public function getIdTokenSigningAlgValuesSupported() @@ -204,7 +205,7 @@ public function getIdTokenSigningAlgValuesSupported() /** * supported ID Token signing Algorithms. * - * Generated from protobuf field repeated string id_token_signing_alg_values_supported = 5; + * Generated from protobuf field repeated string id_token_signing_alg_values_supported = 5 [json_name = "id_token_signing_alg_values_supported"]; * @param array|\Google\Protobuf\Internal\RepeatedField $var * @return $this */ @@ -219,7 +220,7 @@ public function setIdTokenSigningAlgValuesSupported($var) /** * Supported claims. * - * Generated from protobuf field repeated string claims_supported = 6; + * Generated from protobuf field repeated string claims_supported = 6 [json_name = "claims_supported"]; * @return \Google\Protobuf\Internal\RepeatedField */ public function getClaimsSupported() @@ -230,7 +231,7 @@ public function getClaimsSupported() /** * Supported claims. * - * Generated from protobuf field repeated string claims_supported = 6; + * Generated from protobuf field repeated string claims_supported = 6 [json_name = "claims_supported"]; * @param array|\Google\Protobuf\Internal\RepeatedField $var * @return $this */ @@ -245,7 +246,7 @@ public function setClaimsSupported($var) /** * Supported grant types. * - * Generated from protobuf field repeated string grant_types = 7; + * Generated from protobuf field repeated string grant_types = 7 [json_name = "grant_types"]; * @return \Google\Protobuf\Internal\RepeatedField */ public function getGrantTypes() @@ -256,7 +257,7 @@ public function getGrantTypes() /** * Supported grant types. * - * Generated from protobuf field repeated string grant_types = 7; + * Generated from protobuf field repeated string grant_types = 7 [json_name = "grant_types"]; * @param array|\Google\Protobuf\Internal\RepeatedField $var * @return $this */ diff --git a/GkeMultiCloud/src/V1/AzureProxyConfig.php b/GkeMultiCloud/src/V1/AzureProxyConfig.php index 18b6b84acf57..f92a3a6a58fc 100644 --- a/GkeMultiCloud/src/V1/AzureProxyConfig.php +++ b/GkeMultiCloud/src/V1/AzureProxyConfig.php @@ -11,6 +11,7 @@ /** * Details of a proxy config stored in Azure Key Vault. * + * @deprecated * Generated from protobuf message google.cloud.gkemulticloud.v1.AzureProxyConfig */ class AzureProxyConfig extends \Google\Protobuf\Internal\Message diff --git a/GkeMultiCloud/src/V1/AzureServerConfig.php b/GkeMultiCloud/src/V1/AzureServerConfig.php index b16a42166e59..3fcde8a361b5 100644 --- a/GkeMultiCloud/src/V1/AzureServerConfig.php +++ b/GkeMultiCloud/src/V1/AzureServerConfig.php @@ -12,6 +12,7 @@ * AzureServerConfig contains information about a Google Cloud location, such as * supported Azure regions and Kubernetes versions. * + * @deprecated * Generated from protobuf message google.cloud.gkemulticloud.v1.AzureServerConfig */ class AzureServerConfig extends \Google\Protobuf\Internal\Message diff --git a/GkeMultiCloud/src/V1/AzureServicesAuthentication.php b/GkeMultiCloud/src/V1/AzureServicesAuthentication.php index b5a17552ed8f..493907ef9432 100644 --- a/GkeMultiCloud/src/V1/AzureServicesAuthentication.php +++ b/GkeMultiCloud/src/V1/AzureServicesAuthentication.php @@ -11,6 +11,7 @@ /** * Authentication configuration for the management of Azure resources. * + * @deprecated * Generated from protobuf message google.cloud.gkemulticloud.v1.AzureServicesAuthentication */ class AzureServicesAuthentication extends \Google\Protobuf\Internal\Message diff --git a/GkeMultiCloud/src/V1/AzureSshConfig.php b/GkeMultiCloud/src/V1/AzureSshConfig.php index 1327e9f14c97..7975e25eddab 100644 --- a/GkeMultiCloud/src/V1/AzureSshConfig.php +++ b/GkeMultiCloud/src/V1/AzureSshConfig.php @@ -11,6 +11,7 @@ /** * SSH configuration for Azure resources. * + * @deprecated * Generated from protobuf message google.cloud.gkemulticloud.v1.AzureSshConfig */ class AzureSshConfig extends \Google\Protobuf\Internal\Message diff --git a/GkeMultiCloud/src/V1/Client/AttachedClustersClient.php b/GkeMultiCloud/src/V1/Client/AttachedClustersClient.php index 429f5551d63a..444490b8ac55 100644 --- a/GkeMultiCloud/src/V1/Client/AttachedClustersClient.php +++ b/GkeMultiCloud/src/V1/Client/AttachedClustersClient.php @@ -101,9 +101,7 @@ final class AttachedClustersClient private const CODEGEN_NAME = 'gapic'; /** The default scopes required by the service. */ - public static $serviceScopes = [ - 'https://www.googleapis.com/auth/cloud-platform', - ]; + public static $serviceScopes = ['https://www.googleapis.com/auth/cloud-platform']; private $operationsClient; @@ -367,8 +365,10 @@ public function __call($method, $args) * * @throws ApiException Thrown if the API call fails. */ - public function createAttachedCluster(CreateAttachedClusterRequest $request, array $callOptions = []): OperationResponse - { + public function createAttachedCluster( + CreateAttachedClusterRequest $request, + array $callOptions = [] + ): OperationResponse { return $this->startApiCall('CreateAttachedCluster', $request, $callOptions)->wait(); } @@ -399,8 +399,10 @@ public function createAttachedCluster(CreateAttachedClusterRequest $request, arr * * @throws ApiException Thrown if the API call fails. */ - public function deleteAttachedCluster(DeleteAttachedClusterRequest $request, array $callOptions = []): OperationResponse - { + public function deleteAttachedCluster( + DeleteAttachedClusterRequest $request, + array $callOptions = [] + ): OperationResponse { return $this->startApiCall('DeleteAttachedCluster', $request, $callOptions)->wait(); } @@ -426,8 +428,10 @@ public function deleteAttachedCluster(DeleteAttachedClusterRequest $request, arr * * @throws ApiException Thrown if the API call fails. */ - public function generateAttachedClusterAgentToken(GenerateAttachedClusterAgentTokenRequest $request, array $callOptions = []): GenerateAttachedClusterAgentTokenResponse - { + public function generateAttachedClusterAgentToken( + GenerateAttachedClusterAgentTokenRequest $request, + array $callOptions = [] + ): GenerateAttachedClusterAgentTokenResponse { return $this->startApiCall('GenerateAttachedClusterAgentToken', $request, $callOptions)->wait(); } @@ -453,8 +457,10 @@ public function generateAttachedClusterAgentToken(GenerateAttachedClusterAgentTo * * @throws ApiException Thrown if the API call fails. */ - public function generateAttachedClusterInstallManifest(GenerateAttachedClusterInstallManifestRequest $request, array $callOptions = []): GenerateAttachedClusterInstallManifestResponse - { + public function generateAttachedClusterInstallManifest( + GenerateAttachedClusterInstallManifestRequest $request, + array $callOptions = [] + ): GenerateAttachedClusterInstallManifestResponse { return $this->startApiCall('GenerateAttachedClusterInstallManifest', $request, $callOptions)->wait(); } @@ -508,8 +514,10 @@ public function getAttachedCluster(GetAttachedClusterRequest $request, array $ca * * @throws ApiException Thrown if the API call fails. */ - public function getAttachedServerConfig(GetAttachedServerConfigRequest $request, array $callOptions = []): AttachedServerConfig - { + public function getAttachedServerConfig( + GetAttachedServerConfigRequest $request, + array $callOptions = [] + ): AttachedServerConfig { return $this->startApiCall('GetAttachedServerConfig', $request, $callOptions)->wait(); } @@ -544,8 +552,10 @@ public function getAttachedServerConfig(GetAttachedServerConfigRequest $request, * * @throws ApiException Thrown if the API call fails. */ - public function importAttachedCluster(ImportAttachedClusterRequest $request, array $callOptions = []): OperationResponse - { + public function importAttachedCluster( + ImportAttachedClusterRequest $request, + array $callOptions = [] + ): OperationResponse { return $this->startApiCall('ImportAttachedCluster', $request, $callOptions)->wait(); } @@ -572,8 +582,10 @@ public function importAttachedCluster(ImportAttachedClusterRequest $request, arr * * @throws ApiException Thrown if the API call fails. */ - public function listAttachedClusters(ListAttachedClustersRequest $request, array $callOptions = []): PagedListResponse - { + public function listAttachedClusters( + ListAttachedClustersRequest $request, + array $callOptions = [] + ): PagedListResponse { return $this->startApiCall('ListAttachedClusters', $request, $callOptions); } @@ -600,8 +612,10 @@ public function listAttachedClusters(ListAttachedClustersRequest $request, array * * @throws ApiException Thrown if the API call fails. */ - public function updateAttachedCluster(UpdateAttachedClusterRequest $request, array $callOptions = []): OperationResponse - { + public function updateAttachedCluster( + UpdateAttachedClusterRequest $request, + array $callOptions = [] + ): OperationResponse { return $this->startApiCall('UpdateAttachedCluster', $request, $callOptions)->wait(); } } diff --git a/GkeMultiCloud/src/V1/Client/AwsClustersClient.php b/GkeMultiCloud/src/V1/Client/AwsClustersClient.php index 644019de8011..60c5a89200a8 100644 --- a/GkeMultiCloud/src/V1/Client/AwsClustersClient.php +++ b/GkeMultiCloud/src/V1/Client/AwsClustersClient.php @@ -75,6 +75,8 @@ * name, and additionally a parseName method to extract the individual identifiers * contained within formatted names that are returned by the API. * + * @deprecated This class will be removed in the next major version update. + * * @method PromiseInterface createAwsClusterAsync(CreateAwsClusterRequest $request, array $optionalArgs = []) * @method PromiseInterface createAwsNodePoolAsync(CreateAwsNodePoolRequest $request, array $optionalArgs = []) * @method PromiseInterface deleteAwsClusterAsync(DeleteAwsClusterRequest $request, array $optionalArgs = []) @@ -117,9 +119,7 @@ final class AwsClustersClient private const CODEGEN_NAME = 'gapic'; /** The default scopes required by the service. */ - public static $serviceScopes = [ - 'https://www.googleapis.com/auth/cloud-platform', - ]; + public static $serviceScopes = ['https://www.googleapis.com/auth/cloud-platform']; private $operationsClient; @@ -220,8 +220,12 @@ public static function awsClusterName(string $project, string $location, string * * @return string The formatted aws_node_pool resource. */ - public static function awsNodePoolName(string $project, string $location, string $awsCluster, string $awsNodePool): string - { + public static function awsNodePoolName( + string $project, + string $location, + string $awsCluster, + string $awsNodePool + ): string { return self::getPathTemplate('awsNodePool')->render([ 'project' => $project, 'location' => $location, @@ -402,6 +406,8 @@ public function __call($method, $args) * @return OperationResponse * * @throws ApiException Thrown if the API call fails. + * + * @deprecated This method will be removed in the next major version update. */ public function createAwsCluster(CreateAwsClusterRequest $request, array $callOptions = []): OperationResponse { @@ -433,6 +439,8 @@ public function createAwsCluster(CreateAwsClusterRequest $request, array $callOp * @return OperationResponse * * @throws ApiException Thrown if the API call fails. + * + * @deprecated This method will be removed in the next major version update. */ public function createAwsNodePool(CreateAwsNodePoolRequest $request, array $callOptions = []): OperationResponse { @@ -467,6 +475,8 @@ public function createAwsNodePool(CreateAwsNodePoolRequest $request, array $call * @return OperationResponse * * @throws ApiException Thrown if the API call fails. + * + * @deprecated This method will be removed in the next major version update. */ public function deleteAwsCluster(DeleteAwsClusterRequest $request, array $callOptions = []): OperationResponse { @@ -498,6 +508,8 @@ public function deleteAwsCluster(DeleteAwsClusterRequest $request, array $callOp * @return OperationResponse * * @throws ApiException Thrown if the API call fails. + * + * @deprecated This method will be removed in the next major version update. */ public function deleteAwsNodePool(DeleteAwsNodePoolRequest $request, array $callOptions = []): OperationResponse { @@ -525,9 +537,13 @@ public function deleteAwsNodePool(DeleteAwsNodePoolRequest $request, array $call * @return GenerateAwsAccessTokenResponse * * @throws ApiException Thrown if the API call fails. + * + * @deprecated This method will be removed in the next major version update. */ - public function generateAwsAccessToken(GenerateAwsAccessTokenRequest $request, array $callOptions = []): GenerateAwsAccessTokenResponse - { + public function generateAwsAccessToken( + GenerateAwsAccessTokenRequest $request, + array $callOptions = [] + ): GenerateAwsAccessTokenResponse { return $this->startApiCall('GenerateAwsAccessToken', $request, $callOptions)->wait(); } @@ -552,9 +568,13 @@ public function generateAwsAccessToken(GenerateAwsAccessTokenRequest $request, a * @return GenerateAwsClusterAgentTokenResponse * * @throws ApiException Thrown if the API call fails. + * + * @deprecated This method will be removed in the next major version update. */ - public function generateAwsClusterAgentToken(GenerateAwsClusterAgentTokenRequest $request, array $callOptions = []): GenerateAwsClusterAgentTokenResponse - { + public function generateAwsClusterAgentToken( + GenerateAwsClusterAgentTokenRequest $request, + array $callOptions = [] + ): GenerateAwsClusterAgentTokenResponse { return $this->startApiCall('GenerateAwsClusterAgentToken', $request, $callOptions)->wait(); } @@ -579,6 +599,8 @@ public function generateAwsClusterAgentToken(GenerateAwsClusterAgentTokenRequest * @return AwsCluster * * @throws ApiException Thrown if the API call fails. + * + * @deprecated This method will be removed in the next major version update. */ public function getAwsCluster(GetAwsClusterRequest $request, array $callOptions = []): AwsCluster { @@ -606,6 +628,8 @@ public function getAwsCluster(GetAwsClusterRequest $request, array $callOptions * @return AwsJsonWebKeys * * @throws ApiException Thrown if the API call fails. + * + * @deprecated This method will be removed in the next major version update. */ public function getAwsJsonWebKeys(GetAwsJsonWebKeysRequest $request, array $callOptions = []): AwsJsonWebKeys { @@ -633,6 +657,8 @@ public function getAwsJsonWebKeys(GetAwsJsonWebKeysRequest $request, array $call * @return AwsNodePool * * @throws ApiException Thrown if the API call fails. + * + * @deprecated This method will be removed in the next major version update. */ public function getAwsNodePool(GetAwsNodePoolRequest $request, array $callOptions = []): AwsNodePool { @@ -663,6 +689,8 @@ public function getAwsNodePool(GetAwsNodePoolRequest $request, array $callOption * @return AwsOpenIdConfig * * @throws ApiException Thrown if the API call fails. + * + * @deprecated This method will be removed in the next major version update. */ public function getAwsOpenIdConfig(GetAwsOpenIdConfigRequest $request, array $callOptions = []): AwsOpenIdConfig { @@ -690,6 +718,8 @@ public function getAwsOpenIdConfig(GetAwsOpenIdConfigRequest $request, array $ca * @return AwsServerConfig * * @throws ApiException Thrown if the API call fails. + * + * @deprecated This method will be removed in the next major version update. */ public function getAwsServerConfig(GetAwsServerConfigRequest $request, array $callOptions = []): AwsServerConfig { @@ -717,6 +747,8 @@ public function getAwsServerConfig(GetAwsServerConfigRequest $request, array $ca * @return PagedListResponse * * @throws ApiException Thrown if the API call fails. + * + * @deprecated This method will be removed in the next major version update. */ public function listAwsClusters(ListAwsClustersRequest $request, array $callOptions = []): PagedListResponse { @@ -745,6 +777,8 @@ public function listAwsClusters(ListAwsClustersRequest $request, array $callOpti * @return PagedListResponse * * @throws ApiException Thrown if the API call fails. + * + * @deprecated This method will be removed in the next major version update. */ public function listAwsNodePools(ListAwsNodePoolsRequest $request, array $callOptions = []): PagedListResponse { @@ -777,9 +811,13 @@ public function listAwsNodePools(ListAwsNodePoolsRequest $request, array $callOp * @return OperationResponse * * @throws ApiException Thrown if the API call fails. + * + * @deprecated This method will be removed in the next major version update. */ - public function rollbackAwsNodePoolUpdate(RollbackAwsNodePoolUpdateRequest $request, array $callOptions = []): OperationResponse - { + public function rollbackAwsNodePoolUpdate( + RollbackAwsNodePoolUpdateRequest $request, + array $callOptions = [] + ): OperationResponse { return $this->startApiCall('RollbackAwsNodePoolUpdate', $request, $callOptions)->wait(); } @@ -803,6 +841,8 @@ public function rollbackAwsNodePoolUpdate(RollbackAwsNodePoolUpdateRequest $requ * @return OperationResponse * * @throws ApiException Thrown if the API call fails. + * + * @deprecated This method will be removed in the next major version update. */ public function updateAwsCluster(UpdateAwsClusterRequest $request, array $callOptions = []): OperationResponse { @@ -829,6 +869,8 @@ public function updateAwsCluster(UpdateAwsClusterRequest $request, array $callOp * @return OperationResponse * * @throws ApiException Thrown if the API call fails. + * + * @deprecated This method will be removed in the next major version update. */ public function updateAwsNodePool(UpdateAwsNodePoolRequest $request, array $callOptions = []): OperationResponse { diff --git a/GkeMultiCloud/src/V1/Client/AzureClustersClient.php b/GkeMultiCloud/src/V1/Client/AzureClustersClient.php index c257605c6a2c..c782e5f50e4c 100644 --- a/GkeMultiCloud/src/V1/Client/AzureClustersClient.php +++ b/GkeMultiCloud/src/V1/Client/AzureClustersClient.php @@ -79,6 +79,8 @@ * name, and additionally a parseName method to extract the individual identifiers * contained within formatted names that are returned by the API. * + * @deprecated This class will be removed in the next major version update. + * * @method PromiseInterface createAzureClientAsync(CreateAzureClientRequest $request, array $optionalArgs = []) * @method PromiseInterface createAzureClusterAsync(CreateAzureClusterRequest $request, array $optionalArgs = []) * @method PromiseInterface createAzureNodePoolAsync(CreateAzureNodePoolRequest $request, array $optionalArgs = []) @@ -124,9 +126,7 @@ final class AzureClustersClient private const CODEGEN_NAME = 'gapic'; /** The default scopes required by the service. */ - public static $serviceScopes = [ - 'https://www.googleapis.com/auth/cloud-platform', - ]; + public static $serviceScopes = ['https://www.googleapis.com/auth/cloud-platform']; private $operationsClient; @@ -246,8 +246,12 @@ public static function azureClusterName(string $project, string $location, strin * * @return string The formatted azure_node_pool resource. */ - public static function azureNodePoolName(string $project, string $location, string $azureCluster, string $azureNodePool): string - { + public static function azureNodePoolName( + string $project, + string $location, + string $azureCluster, + string $azureNodePool + ): string { return self::getPathTemplate('azureNodePool')->render([ 'project' => $project, 'location' => $location, @@ -433,6 +437,8 @@ public function __call($method, $args) * @return OperationResponse * * @throws ApiException Thrown if the API call fails. + * + * @deprecated This method will be removed in the next major version update. */ public function createAzureClient(CreateAzureClientRequest $request, array $callOptions = []): OperationResponse { @@ -464,6 +470,8 @@ public function createAzureClient(CreateAzureClientRequest $request, array $call * @return OperationResponse * * @throws ApiException Thrown if the API call fails. + * + * @deprecated This method will be removed in the next major version update. */ public function createAzureCluster(CreateAzureClusterRequest $request, array $callOptions = []): OperationResponse { @@ -496,6 +504,8 @@ public function createAzureCluster(CreateAzureClusterRequest $request, array $ca * @return OperationResponse * * @throws ApiException Thrown if the API call fails. + * + * @deprecated This method will be removed in the next major version update. */ public function createAzureNodePool(CreateAzureNodePoolRequest $request, array $callOptions = []): OperationResponse { @@ -530,6 +540,8 @@ public function createAzureNodePool(CreateAzureNodePoolRequest $request, array $ * @return OperationResponse * * @throws ApiException Thrown if the API call fails. + * + * @deprecated This method will be removed in the next major version update. */ public function deleteAzureClient(DeleteAzureClientRequest $request, array $callOptions = []): OperationResponse { @@ -564,6 +576,8 @@ public function deleteAzureClient(DeleteAzureClientRequest $request, array $call * @return OperationResponse * * @throws ApiException Thrown if the API call fails. + * + * @deprecated This method will be removed in the next major version update. */ public function deleteAzureCluster(DeleteAzureClusterRequest $request, array $callOptions = []): OperationResponse { @@ -595,6 +609,8 @@ public function deleteAzureCluster(DeleteAzureClusterRequest $request, array $ca * @return OperationResponse * * @throws ApiException Thrown if the API call fails. + * + * @deprecated This method will be removed in the next major version update. */ public function deleteAzureNodePool(DeleteAzureNodePoolRequest $request, array $callOptions = []): OperationResponse { @@ -623,9 +639,13 @@ public function deleteAzureNodePool(DeleteAzureNodePoolRequest $request, array $ * @return GenerateAzureAccessTokenResponse * * @throws ApiException Thrown if the API call fails. + * + * @deprecated This method will be removed in the next major version update. */ - public function generateAzureAccessToken(GenerateAzureAccessTokenRequest $request, array $callOptions = []): GenerateAzureAccessTokenResponse - { + public function generateAzureAccessToken( + GenerateAzureAccessTokenRequest $request, + array $callOptions = [] + ): GenerateAzureAccessTokenResponse { return $this->startApiCall('GenerateAzureAccessToken', $request, $callOptions)->wait(); } @@ -650,9 +670,13 @@ public function generateAzureAccessToken(GenerateAzureAccessTokenRequest $reques * @return GenerateAzureClusterAgentTokenResponse * * @throws ApiException Thrown if the API call fails. + * + * @deprecated This method will be removed in the next major version update. */ - public function generateAzureClusterAgentToken(GenerateAzureClusterAgentTokenRequest $request, array $callOptions = []): GenerateAzureClusterAgentTokenResponse - { + public function generateAzureClusterAgentToken( + GenerateAzureClusterAgentTokenRequest $request, + array $callOptions = [] + ): GenerateAzureClusterAgentTokenResponse { return $this->startApiCall('GenerateAzureClusterAgentToken', $request, $callOptions)->wait(); } @@ -677,6 +701,8 @@ public function generateAzureClusterAgentToken(GenerateAzureClusterAgentTokenReq * @return AzureClient * * @throws ApiException Thrown if the API call fails. + * + * @deprecated This method will be removed in the next major version update. */ public function getAzureClient(GetAzureClientRequest $request, array $callOptions = []): AzureClient { @@ -704,6 +730,8 @@ public function getAzureClient(GetAzureClientRequest $request, array $callOption * @return AzureCluster * * @throws ApiException Thrown if the API call fails. + * + * @deprecated This method will be removed in the next major version update. */ public function getAzureCluster(GetAzureClusterRequest $request, array $callOptions = []): AzureCluster { @@ -731,6 +759,8 @@ public function getAzureCluster(GetAzureClusterRequest $request, array $callOpti * @return AzureJsonWebKeys * * @throws ApiException Thrown if the API call fails. + * + * @deprecated This method will be removed in the next major version update. */ public function getAzureJsonWebKeys(GetAzureJsonWebKeysRequest $request, array $callOptions = []): AzureJsonWebKeys { @@ -758,6 +788,8 @@ public function getAzureJsonWebKeys(GetAzureJsonWebKeysRequest $request, array $ * @return AzureNodePool * * @throws ApiException Thrown if the API call fails. + * + * @deprecated This method will be removed in the next major version update. */ public function getAzureNodePool(GetAzureNodePoolRequest $request, array $callOptions = []): AzureNodePool { @@ -788,9 +820,13 @@ public function getAzureNodePool(GetAzureNodePoolRequest $request, array $callOp * @return AzureOpenIdConfig * * @throws ApiException Thrown if the API call fails. + * + * @deprecated This method will be removed in the next major version update. */ - public function getAzureOpenIdConfig(GetAzureOpenIdConfigRequest $request, array $callOptions = []): AzureOpenIdConfig - { + public function getAzureOpenIdConfig( + GetAzureOpenIdConfigRequest $request, + array $callOptions = [] + ): AzureOpenIdConfig { return $this->startApiCall('GetAzureOpenIdConfig', $request, $callOptions)->wait(); } @@ -815,9 +851,13 @@ public function getAzureOpenIdConfig(GetAzureOpenIdConfigRequest $request, array * @return AzureServerConfig * * @throws ApiException Thrown if the API call fails. + * + * @deprecated This method will be removed in the next major version update. */ - public function getAzureServerConfig(GetAzureServerConfigRequest $request, array $callOptions = []): AzureServerConfig - { + public function getAzureServerConfig( + GetAzureServerConfigRequest $request, + array $callOptions = [] + ): AzureServerConfig { return $this->startApiCall('GetAzureServerConfig', $request, $callOptions)->wait(); } @@ -842,6 +882,8 @@ public function getAzureServerConfig(GetAzureServerConfigRequest $request, array * @return PagedListResponse * * @throws ApiException Thrown if the API call fails. + * + * @deprecated This method will be removed in the next major version update. */ public function listAzureClients(ListAzureClientsRequest $request, array $callOptions = []): PagedListResponse { @@ -869,6 +911,8 @@ public function listAzureClients(ListAzureClientsRequest $request, array $callOp * @return PagedListResponse * * @throws ApiException Thrown if the API call fails. + * + * @deprecated This method will be removed in the next major version update. */ public function listAzureClusters(ListAzureClustersRequest $request, array $callOptions = []): PagedListResponse { @@ -897,6 +941,8 @@ public function listAzureClusters(ListAzureClustersRequest $request, array $call * @return PagedListResponse * * @throws ApiException Thrown if the API call fails. + * + * @deprecated This method will be removed in the next major version update. */ public function listAzureNodePools(ListAzureNodePoolsRequest $request, array $callOptions = []): PagedListResponse { @@ -923,6 +969,8 @@ public function listAzureNodePools(ListAzureNodePoolsRequest $request, array $ca * @return OperationResponse * * @throws ApiException Thrown if the API call fails. + * + * @deprecated This method will be removed in the next major version update. */ public function updateAzureCluster(UpdateAzureClusterRequest $request, array $callOptions = []): OperationResponse { @@ -949,6 +997,8 @@ public function updateAzureCluster(UpdateAzureClusterRequest $request, array $ca * @return OperationResponse * * @throws ApiException Thrown if the API call fails. + * + * @deprecated This method will be removed in the next major version update. */ public function updateAzureNodePool(UpdateAzureNodePoolRequest $request, array $callOptions = []): OperationResponse { diff --git a/GkeMultiCloud/src/V1/CreateAwsClusterRequest.php b/GkeMultiCloud/src/V1/CreateAwsClusterRequest.php index 2421c4f73fba..31275f9d7fa4 100644 --- a/GkeMultiCloud/src/V1/CreateAwsClusterRequest.php +++ b/GkeMultiCloud/src/V1/CreateAwsClusterRequest.php @@ -11,6 +11,7 @@ /** * Request message for `AwsClusters.CreateAwsCluster` method. * + * @deprecated * Generated from protobuf message google.cloud.gkemulticloud.v1.CreateAwsClusterRequest */ class CreateAwsClusterRequest extends \Google\Protobuf\Internal\Message diff --git a/GkeMultiCloud/src/V1/CreateAwsNodePoolRequest.php b/GkeMultiCloud/src/V1/CreateAwsNodePoolRequest.php index 0a50ccd7b646..8ac675fa0c76 100644 --- a/GkeMultiCloud/src/V1/CreateAwsNodePoolRequest.php +++ b/GkeMultiCloud/src/V1/CreateAwsNodePoolRequest.php @@ -11,6 +11,7 @@ /** * Response message for `AwsClusters.CreateAwsNodePool` method. * + * @deprecated * Generated from protobuf message google.cloud.gkemulticloud.v1.CreateAwsNodePoolRequest */ class CreateAwsNodePoolRequest extends \Google\Protobuf\Internal\Message diff --git a/GkeMultiCloud/src/V1/CreateAzureClientRequest.php b/GkeMultiCloud/src/V1/CreateAzureClientRequest.php index 79ffc0e05dc3..850d278b3691 100644 --- a/GkeMultiCloud/src/V1/CreateAzureClientRequest.php +++ b/GkeMultiCloud/src/V1/CreateAzureClientRequest.php @@ -11,6 +11,7 @@ /** * Request message for `AzureClusters.CreateAzureClient` method. * + * @deprecated * Generated from protobuf message google.cloud.gkemulticloud.v1.CreateAzureClientRequest */ class CreateAzureClientRequest extends \Google\Protobuf\Internal\Message diff --git a/GkeMultiCloud/src/V1/CreateAzureClusterRequest.php b/GkeMultiCloud/src/V1/CreateAzureClusterRequest.php index 4a91100acf58..b80b0b996e12 100644 --- a/GkeMultiCloud/src/V1/CreateAzureClusterRequest.php +++ b/GkeMultiCloud/src/V1/CreateAzureClusterRequest.php @@ -11,6 +11,7 @@ /** * Request message for `AzureClusters.CreateAzureCluster` method. * + * @deprecated * Generated from protobuf message google.cloud.gkemulticloud.v1.CreateAzureClusterRequest */ class CreateAzureClusterRequest extends \Google\Protobuf\Internal\Message diff --git a/GkeMultiCloud/src/V1/CreateAzureNodePoolRequest.php b/GkeMultiCloud/src/V1/CreateAzureNodePoolRequest.php index 916c7caa6c2a..1318fa26f108 100644 --- a/GkeMultiCloud/src/V1/CreateAzureNodePoolRequest.php +++ b/GkeMultiCloud/src/V1/CreateAzureNodePoolRequest.php @@ -11,6 +11,7 @@ /** * Response message for `AzureClusters.CreateAzureNodePool` method. * + * @deprecated * Generated from protobuf message google.cloud.gkemulticloud.v1.CreateAzureNodePoolRequest */ class CreateAzureNodePoolRequest extends \Google\Protobuf\Internal\Message diff --git a/GkeMultiCloud/src/V1/DeleteAwsClusterRequest.php b/GkeMultiCloud/src/V1/DeleteAwsClusterRequest.php index af66bc8b136a..45e043fbe924 100644 --- a/GkeMultiCloud/src/V1/DeleteAwsClusterRequest.php +++ b/GkeMultiCloud/src/V1/DeleteAwsClusterRequest.php @@ -11,6 +11,7 @@ /** * Request message for `AwsClusters.DeleteAwsCluster` method. * + * @deprecated * Generated from protobuf message google.cloud.gkemulticloud.v1.DeleteAwsClusterRequest */ class DeleteAwsClusterRequest extends \Google\Protobuf\Internal\Message diff --git a/GkeMultiCloud/src/V1/DeleteAwsNodePoolRequest.php b/GkeMultiCloud/src/V1/DeleteAwsNodePoolRequest.php index c4c621f59cdc..70249dfa6e61 100644 --- a/GkeMultiCloud/src/V1/DeleteAwsNodePoolRequest.php +++ b/GkeMultiCloud/src/V1/DeleteAwsNodePoolRequest.php @@ -11,6 +11,7 @@ /** * Request message for `AwsClusters.DeleteAwsNodePool` method. * + * @deprecated * Generated from protobuf message google.cloud.gkemulticloud.v1.DeleteAwsNodePoolRequest */ class DeleteAwsNodePoolRequest extends \Google\Protobuf\Internal\Message diff --git a/GkeMultiCloud/src/V1/DeleteAzureClientRequest.php b/GkeMultiCloud/src/V1/DeleteAzureClientRequest.php index 37807fa3dee7..a135f8a390b8 100644 --- a/GkeMultiCloud/src/V1/DeleteAzureClientRequest.php +++ b/GkeMultiCloud/src/V1/DeleteAzureClientRequest.php @@ -11,6 +11,7 @@ /** * Request message for `AzureClusters.DeleteAzureClient` method. * + * @deprecated * Generated from protobuf message google.cloud.gkemulticloud.v1.DeleteAzureClientRequest */ class DeleteAzureClientRequest extends \Google\Protobuf\Internal\Message diff --git a/GkeMultiCloud/src/V1/DeleteAzureClusterRequest.php b/GkeMultiCloud/src/V1/DeleteAzureClusterRequest.php index 4d3907269d12..e1ea1a37ed10 100644 --- a/GkeMultiCloud/src/V1/DeleteAzureClusterRequest.php +++ b/GkeMultiCloud/src/V1/DeleteAzureClusterRequest.php @@ -11,6 +11,7 @@ /** * Request message for `AzureClusters.DeleteAzureCluster` method. * + * @deprecated * Generated from protobuf message google.cloud.gkemulticloud.v1.DeleteAzureClusterRequest */ class DeleteAzureClusterRequest extends \Google\Protobuf\Internal\Message diff --git a/GkeMultiCloud/src/V1/DeleteAzureNodePoolRequest.php b/GkeMultiCloud/src/V1/DeleteAzureNodePoolRequest.php index a27b26f73fd0..f150775a95d5 100644 --- a/GkeMultiCloud/src/V1/DeleteAzureNodePoolRequest.php +++ b/GkeMultiCloud/src/V1/DeleteAzureNodePoolRequest.php @@ -11,6 +11,7 @@ /** * Request message for `AzureClusters.DeleteAzureNodePool` method. * + * @deprecated * Generated from protobuf message google.cloud.gkemulticloud.v1.DeleteAzureNodePoolRequest */ class DeleteAzureNodePoolRequest extends \Google\Protobuf\Internal\Message diff --git a/GkeMultiCloud/src/V1/GenerateAttachedClusterAgentTokenResponse.php b/GkeMultiCloud/src/V1/GenerateAttachedClusterAgentTokenResponse.php index 913a5f2ab892..63f87cc58f63 100644 --- a/GkeMultiCloud/src/V1/GenerateAttachedClusterAgentTokenResponse.php +++ b/GkeMultiCloud/src/V1/GenerateAttachedClusterAgentTokenResponse.php @@ -14,15 +14,15 @@ class GenerateAttachedClusterAgentTokenResponse extends \Google\Protobuf\Internal\Message { /** - * Generated from protobuf field string access_token = 1; + * Generated from protobuf field string access_token = 1 [json_name = "access_token"]; */ protected $access_token = ''; /** - * Generated from protobuf field int32 expires_in = 2; + * Generated from protobuf field int32 expires_in = 2 [json_name = "expires_in"]; */ protected $expires_in = 0; /** - * Generated from protobuf field string token_type = 3; + * Generated from protobuf field string token_type = 3 [json_name = "token_type"]; */ protected $token_type = ''; @@ -43,7 +43,7 @@ public function __construct($data = NULL) { } /** - * Generated from protobuf field string access_token = 1; + * Generated from protobuf field string access_token = 1 [json_name = "access_token"]; * @return string */ public function getAccessToken() @@ -52,7 +52,7 @@ public function getAccessToken() } /** - * Generated from protobuf field string access_token = 1; + * Generated from protobuf field string access_token = 1 [json_name = "access_token"]; * @param string $var * @return $this */ @@ -65,7 +65,7 @@ public function setAccessToken($var) } /** - * Generated from protobuf field int32 expires_in = 2; + * Generated from protobuf field int32 expires_in = 2 [json_name = "expires_in"]; * @return int */ public function getExpiresIn() @@ -74,7 +74,7 @@ public function getExpiresIn() } /** - * Generated from protobuf field int32 expires_in = 2; + * Generated from protobuf field int32 expires_in = 2 [json_name = "expires_in"]; * @param int $var * @return $this */ @@ -87,7 +87,7 @@ public function setExpiresIn($var) } /** - * Generated from protobuf field string token_type = 3; + * Generated from protobuf field string token_type = 3 [json_name = "token_type"]; * @return string */ public function getTokenType() @@ -96,7 +96,7 @@ public function getTokenType() } /** - * Generated from protobuf field string token_type = 3; + * Generated from protobuf field string token_type = 3 [json_name = "token_type"]; * @param string $var * @return $this */ diff --git a/GkeMultiCloud/src/V1/GenerateAwsAccessTokenRequest.php b/GkeMultiCloud/src/V1/GenerateAwsAccessTokenRequest.php index d3d109e81257..ececfba6d2fa 100644 --- a/GkeMultiCloud/src/V1/GenerateAwsAccessTokenRequest.php +++ b/GkeMultiCloud/src/V1/GenerateAwsAccessTokenRequest.php @@ -11,6 +11,7 @@ /** * Request message for `AwsClusters.GenerateAwsAccessToken` method. * + * @deprecated * Generated from protobuf message google.cloud.gkemulticloud.v1.GenerateAwsAccessTokenRequest */ class GenerateAwsAccessTokenRequest extends \Google\Protobuf\Internal\Message diff --git a/GkeMultiCloud/src/V1/GenerateAwsAccessTokenResponse.php b/GkeMultiCloud/src/V1/GenerateAwsAccessTokenResponse.php index 35f1695ffc34..089137e9f470 100644 --- a/GkeMultiCloud/src/V1/GenerateAwsAccessTokenResponse.php +++ b/GkeMultiCloud/src/V1/GenerateAwsAccessTokenResponse.php @@ -11,6 +11,7 @@ /** * Response message for `AwsClusters.GenerateAwsAccessToken` method. * + * @deprecated * Generated from protobuf message google.cloud.gkemulticloud.v1.GenerateAwsAccessTokenResponse */ class GenerateAwsAccessTokenResponse extends \Google\Protobuf\Internal\Message diff --git a/GkeMultiCloud/src/V1/GenerateAwsClusterAgentTokenRequest.php b/GkeMultiCloud/src/V1/GenerateAwsClusterAgentTokenRequest.php index 16461659a451..6645134be7db 100644 --- a/GkeMultiCloud/src/V1/GenerateAwsClusterAgentTokenRequest.php +++ b/GkeMultiCloud/src/V1/GenerateAwsClusterAgentTokenRequest.php @@ -9,6 +9,7 @@ use Google\Protobuf\Internal\GPBUtil; /** + * @deprecated * Generated from protobuf message google.cloud.gkemulticloud.v1.GenerateAwsClusterAgentTokenRequest */ class GenerateAwsClusterAgentTokenRequest extends \Google\Protobuf\Internal\Message diff --git a/GkeMultiCloud/src/V1/GenerateAwsClusterAgentTokenResponse.php b/GkeMultiCloud/src/V1/GenerateAwsClusterAgentTokenResponse.php index 0a5d0bafb1b3..1b65086b2e10 100644 --- a/GkeMultiCloud/src/V1/GenerateAwsClusterAgentTokenResponse.php +++ b/GkeMultiCloud/src/V1/GenerateAwsClusterAgentTokenResponse.php @@ -9,20 +9,21 @@ use Google\Protobuf\Internal\GPBUtil; /** + * @deprecated * Generated from protobuf message google.cloud.gkemulticloud.v1.GenerateAwsClusterAgentTokenResponse */ class GenerateAwsClusterAgentTokenResponse extends \Google\Protobuf\Internal\Message { /** - * Generated from protobuf field string access_token = 1; + * Generated from protobuf field string access_token = 1 [json_name = "access_token"]; */ protected $access_token = ''; /** - * Generated from protobuf field int32 expires_in = 2; + * Generated from protobuf field int32 expires_in = 2 [json_name = "expires_in"]; */ protected $expires_in = 0; /** - * Generated from protobuf field string token_type = 3; + * Generated from protobuf field string token_type = 3 [json_name = "token_type"]; */ protected $token_type = ''; @@ -43,7 +44,7 @@ public function __construct($data = NULL) { } /** - * Generated from protobuf field string access_token = 1; + * Generated from protobuf field string access_token = 1 [json_name = "access_token"]; * @return string */ public function getAccessToken() @@ -52,7 +53,7 @@ public function getAccessToken() } /** - * Generated from protobuf field string access_token = 1; + * Generated from protobuf field string access_token = 1 [json_name = "access_token"]; * @param string $var * @return $this */ @@ -65,7 +66,7 @@ public function setAccessToken($var) } /** - * Generated from protobuf field int32 expires_in = 2; + * Generated from protobuf field int32 expires_in = 2 [json_name = "expires_in"]; * @return int */ public function getExpiresIn() @@ -74,7 +75,7 @@ public function getExpiresIn() } /** - * Generated from protobuf field int32 expires_in = 2; + * Generated from protobuf field int32 expires_in = 2 [json_name = "expires_in"]; * @param int $var * @return $this */ @@ -87,7 +88,7 @@ public function setExpiresIn($var) } /** - * Generated from protobuf field string token_type = 3; + * Generated from protobuf field string token_type = 3 [json_name = "token_type"]; * @return string */ public function getTokenType() @@ -96,7 +97,7 @@ public function getTokenType() } /** - * Generated from protobuf field string token_type = 3; + * Generated from protobuf field string token_type = 3 [json_name = "token_type"]; * @param string $var * @return $this */ diff --git a/GkeMultiCloud/src/V1/GenerateAzureAccessTokenRequest.php b/GkeMultiCloud/src/V1/GenerateAzureAccessTokenRequest.php index f189dbc3a504..0c2e9589071f 100644 --- a/GkeMultiCloud/src/V1/GenerateAzureAccessTokenRequest.php +++ b/GkeMultiCloud/src/V1/GenerateAzureAccessTokenRequest.php @@ -11,6 +11,7 @@ /** * Request message for `AzureClusters.GenerateAzureAccessToken` method. * + * @deprecated * Generated from protobuf message google.cloud.gkemulticloud.v1.GenerateAzureAccessTokenRequest */ class GenerateAzureAccessTokenRequest extends \Google\Protobuf\Internal\Message diff --git a/GkeMultiCloud/src/V1/GenerateAzureAccessTokenResponse.php b/GkeMultiCloud/src/V1/GenerateAzureAccessTokenResponse.php index 4371394919c5..83ea6c11aa6b 100644 --- a/GkeMultiCloud/src/V1/GenerateAzureAccessTokenResponse.php +++ b/GkeMultiCloud/src/V1/GenerateAzureAccessTokenResponse.php @@ -11,6 +11,7 @@ /** * Response message for `AzureClusters.GenerateAzureAccessToken` method. * + * @deprecated * Generated from protobuf message google.cloud.gkemulticloud.v1.GenerateAzureAccessTokenResponse */ class GenerateAzureAccessTokenResponse extends \Google\Protobuf\Internal\Message diff --git a/GkeMultiCloud/src/V1/GenerateAzureClusterAgentTokenRequest.php b/GkeMultiCloud/src/V1/GenerateAzureClusterAgentTokenRequest.php index d19114785203..85c34f8482b9 100644 --- a/GkeMultiCloud/src/V1/GenerateAzureClusterAgentTokenRequest.php +++ b/GkeMultiCloud/src/V1/GenerateAzureClusterAgentTokenRequest.php @@ -9,6 +9,7 @@ use Google\Protobuf\Internal\GPBUtil; /** + * @deprecated * Generated from protobuf message google.cloud.gkemulticloud.v1.GenerateAzureClusterAgentTokenRequest */ class GenerateAzureClusterAgentTokenRequest extends \Google\Protobuf\Internal\Message diff --git a/GkeMultiCloud/src/V1/GenerateAzureClusterAgentTokenResponse.php b/GkeMultiCloud/src/V1/GenerateAzureClusterAgentTokenResponse.php index beb176c6239a..8b3c2defc6fc 100644 --- a/GkeMultiCloud/src/V1/GenerateAzureClusterAgentTokenResponse.php +++ b/GkeMultiCloud/src/V1/GenerateAzureClusterAgentTokenResponse.php @@ -9,20 +9,21 @@ use Google\Protobuf\Internal\GPBUtil; /** + * @deprecated * Generated from protobuf message google.cloud.gkemulticloud.v1.GenerateAzureClusterAgentTokenResponse */ class GenerateAzureClusterAgentTokenResponse extends \Google\Protobuf\Internal\Message { /** - * Generated from protobuf field string access_token = 1; + * Generated from protobuf field string access_token = 1 [json_name = "access_token"]; */ protected $access_token = ''; /** - * Generated from protobuf field int32 expires_in = 2; + * Generated from protobuf field int32 expires_in = 2 [json_name = "expires_in"]; */ protected $expires_in = 0; /** - * Generated from protobuf field string token_type = 3; + * Generated from protobuf field string token_type = 3 [json_name = "token_type"]; */ protected $token_type = ''; @@ -43,7 +44,7 @@ public function __construct($data = NULL) { } /** - * Generated from protobuf field string access_token = 1; + * Generated from protobuf field string access_token = 1 [json_name = "access_token"]; * @return string */ public function getAccessToken() @@ -52,7 +53,7 @@ public function getAccessToken() } /** - * Generated from protobuf field string access_token = 1; + * Generated from protobuf field string access_token = 1 [json_name = "access_token"]; * @param string $var * @return $this */ @@ -65,7 +66,7 @@ public function setAccessToken($var) } /** - * Generated from protobuf field int32 expires_in = 2; + * Generated from protobuf field int32 expires_in = 2 [json_name = "expires_in"]; * @return int */ public function getExpiresIn() @@ -74,7 +75,7 @@ public function getExpiresIn() } /** - * Generated from protobuf field int32 expires_in = 2; + * Generated from protobuf field int32 expires_in = 2 [json_name = "expires_in"]; * @param int $var * @return $this */ @@ -87,7 +88,7 @@ public function setExpiresIn($var) } /** - * Generated from protobuf field string token_type = 3; + * Generated from protobuf field string token_type = 3 [json_name = "token_type"]; * @return string */ public function getTokenType() @@ -96,7 +97,7 @@ public function getTokenType() } /** - * Generated from protobuf field string token_type = 3; + * Generated from protobuf field string token_type = 3 [json_name = "token_type"]; * @param string $var * @return $this */ diff --git a/GkeMultiCloud/src/V1/GetAwsClusterRequest.php b/GkeMultiCloud/src/V1/GetAwsClusterRequest.php index 1a522d11bbb5..0aac198b1693 100644 --- a/GkeMultiCloud/src/V1/GetAwsClusterRequest.php +++ b/GkeMultiCloud/src/V1/GetAwsClusterRequest.php @@ -11,6 +11,7 @@ /** * Request message for `AwsClusters.GetAwsCluster` method. * + * @deprecated * Generated from protobuf message google.cloud.gkemulticloud.v1.GetAwsClusterRequest */ class GetAwsClusterRequest extends \Google\Protobuf\Internal\Message diff --git a/GkeMultiCloud/src/V1/GetAwsJsonWebKeysRequest.php b/GkeMultiCloud/src/V1/GetAwsJsonWebKeysRequest.php index 7e334e021db1..0adf291a3b59 100644 --- a/GkeMultiCloud/src/V1/GetAwsJsonWebKeysRequest.php +++ b/GkeMultiCloud/src/V1/GetAwsJsonWebKeysRequest.php @@ -14,6 +14,7 @@ * document returned by getOpenIDConfig. See the OpenID Connect * Discovery 1.0 specification for details. * + * @deprecated * Generated from protobuf message google.cloud.gkemulticloud.v1.GetAwsJsonWebKeysRequest */ class GetAwsJsonWebKeysRequest extends \Google\Protobuf\Internal\Message diff --git a/GkeMultiCloud/src/V1/GetAwsNodePoolRequest.php b/GkeMultiCloud/src/V1/GetAwsNodePoolRequest.php index 549d270d9f3e..c2de6b925f30 100644 --- a/GkeMultiCloud/src/V1/GetAwsNodePoolRequest.php +++ b/GkeMultiCloud/src/V1/GetAwsNodePoolRequest.php @@ -11,6 +11,7 @@ /** * Request message for `AwsClusters.GetAwsNodePool` method. * + * @deprecated * Generated from protobuf message google.cloud.gkemulticloud.v1.GetAwsNodePoolRequest */ class GetAwsNodePoolRequest extends \Google\Protobuf\Internal\Message diff --git a/GkeMultiCloud/src/V1/GetAwsOpenIdConfigRequest.php b/GkeMultiCloud/src/V1/GetAwsOpenIdConfigRequest.php index e1e5b395ff9f..c50160c82cf5 100644 --- a/GkeMultiCloud/src/V1/GetAwsOpenIdConfigRequest.php +++ b/GkeMultiCloud/src/V1/GetAwsOpenIdConfigRequest.php @@ -12,6 +12,7 @@ * GetAwsOpenIdConfigRequest gets the OIDC discovery document for the * cluster. See the OpenID Connect Discovery 1.0 specification for details. * + * @deprecated * Generated from protobuf message google.cloud.gkemulticloud.v1.GetAwsOpenIdConfigRequest */ class GetAwsOpenIdConfigRequest extends \Google\Protobuf\Internal\Message diff --git a/GkeMultiCloud/src/V1/GetAwsServerConfigRequest.php b/GkeMultiCloud/src/V1/GetAwsServerConfigRequest.php index fe925dd0cc05..ff1f3065b207 100644 --- a/GkeMultiCloud/src/V1/GetAwsServerConfigRequest.php +++ b/GkeMultiCloud/src/V1/GetAwsServerConfigRequest.php @@ -11,6 +11,7 @@ /** * GetAwsServerConfigRequest gets the server config of GKE cluster on AWS. * + * @deprecated * Generated from protobuf message google.cloud.gkemulticloud.v1.GetAwsServerConfigRequest */ class GetAwsServerConfigRequest extends \Google\Protobuf\Internal\Message diff --git a/GkeMultiCloud/src/V1/GetAzureClientRequest.php b/GkeMultiCloud/src/V1/GetAzureClientRequest.php index ce520b46f6bd..402b53c64dfc 100644 --- a/GkeMultiCloud/src/V1/GetAzureClientRequest.php +++ b/GkeMultiCloud/src/V1/GetAzureClientRequest.php @@ -11,6 +11,7 @@ /** * Request message for `AzureClusters.GetAzureClient` method. * + * @deprecated * Generated from protobuf message google.cloud.gkemulticloud.v1.GetAzureClientRequest */ class GetAzureClientRequest extends \Google\Protobuf\Internal\Message diff --git a/GkeMultiCloud/src/V1/GetAzureClusterRequest.php b/GkeMultiCloud/src/V1/GetAzureClusterRequest.php index c0403c71bf54..7abfe7a6b296 100644 --- a/GkeMultiCloud/src/V1/GetAzureClusterRequest.php +++ b/GkeMultiCloud/src/V1/GetAzureClusterRequest.php @@ -11,6 +11,7 @@ /** * Request message for `AzureClusters.GetAzureCluster` method. * + * @deprecated * Generated from protobuf message google.cloud.gkemulticloud.v1.GetAzureClusterRequest */ class GetAzureClusterRequest extends \Google\Protobuf\Internal\Message diff --git a/GkeMultiCloud/src/V1/GetAzureJsonWebKeysRequest.php b/GkeMultiCloud/src/V1/GetAzureJsonWebKeysRequest.php index 75a740ad73d9..ee580195d82e 100644 --- a/GkeMultiCloud/src/V1/GetAzureJsonWebKeysRequest.php +++ b/GkeMultiCloud/src/V1/GetAzureJsonWebKeysRequest.php @@ -14,6 +14,7 @@ * document returned by getOpenIDConfig. See the OpenID Connect * Discovery 1.0 specification for details. * + * @deprecated * Generated from protobuf message google.cloud.gkemulticloud.v1.GetAzureJsonWebKeysRequest */ class GetAzureJsonWebKeysRequest extends \Google\Protobuf\Internal\Message diff --git a/GkeMultiCloud/src/V1/GetAzureNodePoolRequest.php b/GkeMultiCloud/src/V1/GetAzureNodePoolRequest.php index d491eade7bca..4342b82b977f 100644 --- a/GkeMultiCloud/src/V1/GetAzureNodePoolRequest.php +++ b/GkeMultiCloud/src/V1/GetAzureNodePoolRequest.php @@ -11,6 +11,7 @@ /** * Request message for `AzureClusters.GetAzureNodePool` method. * + * @deprecated * Generated from protobuf message google.cloud.gkemulticloud.v1.GetAzureNodePoolRequest */ class GetAzureNodePoolRequest extends \Google\Protobuf\Internal\Message diff --git a/GkeMultiCloud/src/V1/GetAzureOpenIdConfigRequest.php b/GkeMultiCloud/src/V1/GetAzureOpenIdConfigRequest.php index bb7336cfb5ff..31ed63b50db1 100644 --- a/GkeMultiCloud/src/V1/GetAzureOpenIdConfigRequest.php +++ b/GkeMultiCloud/src/V1/GetAzureOpenIdConfigRequest.php @@ -12,6 +12,7 @@ * GetAzureOpenIdConfigRequest gets the OIDC discovery document for the * cluster. See the OpenID Connect Discovery 1.0 specification for details. * + * @deprecated * Generated from protobuf message google.cloud.gkemulticloud.v1.GetAzureOpenIdConfigRequest */ class GetAzureOpenIdConfigRequest extends \Google\Protobuf\Internal\Message diff --git a/GkeMultiCloud/src/V1/GetAzureServerConfigRequest.php b/GkeMultiCloud/src/V1/GetAzureServerConfigRequest.php index 933aca070c01..295a88ba4545 100644 --- a/GkeMultiCloud/src/V1/GetAzureServerConfigRequest.php +++ b/GkeMultiCloud/src/V1/GetAzureServerConfigRequest.php @@ -11,6 +11,7 @@ /** * GetAzureServerConfigRequest gets the server config of GKE cluster on Azure. * + * @deprecated * Generated from protobuf message google.cloud.gkemulticloud.v1.GetAzureServerConfigRequest */ class GetAzureServerConfigRequest extends \Google\Protobuf\Internal\Message diff --git a/GkeMultiCloud/src/V1/Label.php b/GkeMultiCloud/src/V1/Label.php new file mode 100644 index 000000000000..5476ef90fb96 --- /dev/null +++ b/GkeMultiCloud/src/V1/Label.php @@ -0,0 +1,102 @@ +google.cloud.gkemulticloud.v1.Label + */ +class Label extends \Google\Protobuf\Internal\Message +{ + /** + * This is the key of the label. + * + * Generated from protobuf field string key = 1; + */ + protected $key = ''; + /** + * This is the value of the label. + * + * Generated from protobuf field string value = 2; + */ + protected $value = ''; + + /** + * Constructor. + * + * @param array $data { + * Optional. Data for populating the Message object. + * + * @type string $key + * This is the key of the label. + * @type string $value + * This is the value of the label. + * } + */ + public function __construct($data = NULL) { + \GPBMetadata\Google\Cloud\Gkemulticloud\V1\AttachedResources::initOnce(); + parent::__construct($data); + } + + /** + * This is the key of the label. + * + * Generated from protobuf field string key = 1; + * @return string + */ + public function getKey() + { + return $this->key; + } + + /** + * This is the key of the label. + * + * Generated from protobuf field string key = 1; + * @param string $var + * @return $this + */ + public function setKey($var) + { + GPBUtil::checkString($var, True); + $this->key = $var; + + return $this; + } + + /** + * This is the value of the label. + * + * Generated from protobuf field string value = 2; + * @return string + */ + public function getValue() + { + return $this->value; + } + + /** + * This is the value of the label. + * + * Generated from protobuf field string value = 2; + * @param string $var + * @return $this + */ + public function setValue($var) + { + GPBUtil::checkString($var, True); + $this->value = $var; + + return $this; + } + +} + diff --git a/GkeMultiCloud/src/V1/ListAwsClustersRequest.php b/GkeMultiCloud/src/V1/ListAwsClustersRequest.php index cabd399a840b..ee3ef7fd8bdc 100644 --- a/GkeMultiCloud/src/V1/ListAwsClustersRequest.php +++ b/GkeMultiCloud/src/V1/ListAwsClustersRequest.php @@ -11,6 +11,7 @@ /** * Request message for `AwsClusters.ListAwsClusters` method. * + * @deprecated * Generated from protobuf message google.cloud.gkemulticloud.v1.ListAwsClustersRequest */ class ListAwsClustersRequest extends \Google\Protobuf\Internal\Message diff --git a/GkeMultiCloud/src/V1/ListAwsClustersResponse.php b/GkeMultiCloud/src/V1/ListAwsClustersResponse.php index cf2c1a17dca9..d353a9eb2916 100644 --- a/GkeMultiCloud/src/V1/ListAwsClustersResponse.php +++ b/GkeMultiCloud/src/V1/ListAwsClustersResponse.php @@ -11,6 +11,7 @@ /** * Response message for `AwsClusters.ListAwsClusters` method. * + * @deprecated * Generated from protobuf message google.cloud.gkemulticloud.v1.ListAwsClustersResponse */ class ListAwsClustersResponse extends \Google\Protobuf\Internal\Message diff --git a/GkeMultiCloud/src/V1/ListAwsNodePoolsRequest.php b/GkeMultiCloud/src/V1/ListAwsNodePoolsRequest.php index ec512d71b6af..1659c12f18dd 100644 --- a/GkeMultiCloud/src/V1/ListAwsNodePoolsRequest.php +++ b/GkeMultiCloud/src/V1/ListAwsNodePoolsRequest.php @@ -11,6 +11,7 @@ /** * Request message for `AwsClusters.ListAwsNodePools` method. * + * @deprecated * Generated from protobuf message google.cloud.gkemulticloud.v1.ListAwsNodePoolsRequest */ class ListAwsNodePoolsRequest extends \Google\Protobuf\Internal\Message diff --git a/GkeMultiCloud/src/V1/ListAwsNodePoolsResponse.php b/GkeMultiCloud/src/V1/ListAwsNodePoolsResponse.php index e6a681467d5a..bb416e5325b8 100644 --- a/GkeMultiCloud/src/V1/ListAwsNodePoolsResponse.php +++ b/GkeMultiCloud/src/V1/ListAwsNodePoolsResponse.php @@ -11,6 +11,7 @@ /** * Response message for `AwsClusters.ListAwsNodePools` method. * + * @deprecated * Generated from protobuf message google.cloud.gkemulticloud.v1.ListAwsNodePoolsResponse */ class ListAwsNodePoolsResponse extends \Google\Protobuf\Internal\Message diff --git a/GkeMultiCloud/src/V1/ListAzureClientsRequest.php b/GkeMultiCloud/src/V1/ListAzureClientsRequest.php index 721195797caf..a9517c6120c6 100644 --- a/GkeMultiCloud/src/V1/ListAzureClientsRequest.php +++ b/GkeMultiCloud/src/V1/ListAzureClientsRequest.php @@ -11,6 +11,7 @@ /** * Request message for `AzureClusters.ListAzureClients` method. * + * @deprecated * Generated from protobuf message google.cloud.gkemulticloud.v1.ListAzureClientsRequest */ class ListAzureClientsRequest extends \Google\Protobuf\Internal\Message diff --git a/GkeMultiCloud/src/V1/ListAzureClientsResponse.php b/GkeMultiCloud/src/V1/ListAzureClientsResponse.php index 6ec3fccc2c48..49d258f13288 100644 --- a/GkeMultiCloud/src/V1/ListAzureClientsResponse.php +++ b/GkeMultiCloud/src/V1/ListAzureClientsResponse.php @@ -11,6 +11,7 @@ /** * Response message for `AzureClusters.ListAzureClients` method. * + * @deprecated * Generated from protobuf message google.cloud.gkemulticloud.v1.ListAzureClientsResponse */ class ListAzureClientsResponse extends \Google\Protobuf\Internal\Message diff --git a/GkeMultiCloud/src/V1/ListAzureClustersRequest.php b/GkeMultiCloud/src/V1/ListAzureClustersRequest.php index c8d3b2bc6110..31c763f69016 100644 --- a/GkeMultiCloud/src/V1/ListAzureClustersRequest.php +++ b/GkeMultiCloud/src/V1/ListAzureClustersRequest.php @@ -11,6 +11,7 @@ /** * Request message for `AzureClusters.ListAzureClusters` method. * + * @deprecated * Generated from protobuf message google.cloud.gkemulticloud.v1.ListAzureClustersRequest */ class ListAzureClustersRequest extends \Google\Protobuf\Internal\Message diff --git a/GkeMultiCloud/src/V1/ListAzureClustersResponse.php b/GkeMultiCloud/src/V1/ListAzureClustersResponse.php index ed2af0dfa8b5..7e593e8a332f 100644 --- a/GkeMultiCloud/src/V1/ListAzureClustersResponse.php +++ b/GkeMultiCloud/src/V1/ListAzureClustersResponse.php @@ -11,6 +11,7 @@ /** * Response message for `AzureClusters.ListAzureClusters` method. * + * @deprecated * Generated from protobuf message google.cloud.gkemulticloud.v1.ListAzureClustersResponse */ class ListAzureClustersResponse extends \Google\Protobuf\Internal\Message diff --git a/GkeMultiCloud/src/V1/ListAzureNodePoolsRequest.php b/GkeMultiCloud/src/V1/ListAzureNodePoolsRequest.php index 4a48b8d5a27d..9296e27806b7 100644 --- a/GkeMultiCloud/src/V1/ListAzureNodePoolsRequest.php +++ b/GkeMultiCloud/src/V1/ListAzureNodePoolsRequest.php @@ -11,6 +11,7 @@ /** * Request message for `AzureClusters.ListAzureNodePools` method. * + * @deprecated * Generated from protobuf message google.cloud.gkemulticloud.v1.ListAzureNodePoolsRequest */ class ListAzureNodePoolsRequest extends \Google\Protobuf\Internal\Message diff --git a/GkeMultiCloud/src/V1/ListAzureNodePoolsResponse.php b/GkeMultiCloud/src/V1/ListAzureNodePoolsResponse.php index dba3b96d705d..48ff9bcaa46d 100644 --- a/GkeMultiCloud/src/V1/ListAzureNodePoolsResponse.php +++ b/GkeMultiCloud/src/V1/ListAzureNodePoolsResponse.php @@ -11,6 +11,7 @@ /** * Response message for `AzureClusters.ListAzureNodePools` method. * + * @deprecated * Generated from protobuf message google.cloud.gkemulticloud.v1.ListAzureNodePoolsResponse */ class ListAzureNodePoolsResponse extends \Google\Protobuf\Internal\Message diff --git a/GkeMultiCloud/src/V1/OperationMetadata.php b/GkeMultiCloud/src/V1/OperationMetadata.php index e28118d3c762..3377f4a12f7a 100644 --- a/GkeMultiCloud/src/V1/OperationMetadata.php +++ b/GkeMultiCloud/src/V1/OperationMetadata.php @@ -54,9 +54,8 @@ class OperationMetadata extends \Google\Protobuf\Internal\Message */ protected $verb = ''; /** - * Output only. Identifies whether it has been requested cancellation - * for the operation. Operations that have successfully been cancelled - * have + * Output only. Identifies whether cancellation has been requested for the + * operation. Operations that have successfully been cancelled have * [google.longrunning.Operation.error][google.longrunning.Operation.error] * value with a [google.rpc.Status.code][google.rpc.Status.code] of 1, * corresponding to `Code.CANCELLED`. @@ -86,9 +85,8 @@ class OperationMetadata extends \Google\Protobuf\Internal\Message * Output only. The verb associated with the API method which triggered this * operation. Possible values are "create", "delete", "update" and "import". * @type bool $requested_cancellation - * Output only. Identifies whether it has been requested cancellation - * for the operation. Operations that have successfully been cancelled - * have + * Output only. Identifies whether cancellation has been requested for the + * operation. Operations that have successfully been cancelled have * [google.longrunning.Operation.error][google.longrunning.Operation.error] * value with a [google.rpc.Status.code][google.rpc.Status.code] of 1, * corresponding to `Code.CANCELLED`. @@ -280,9 +278,8 @@ public function setVerb($var) } /** - * Output only. Identifies whether it has been requested cancellation - * for the operation. Operations that have successfully been cancelled - * have + * Output only. Identifies whether cancellation has been requested for the + * operation. Operations that have successfully been cancelled have * [google.longrunning.Operation.error][google.longrunning.Operation.error] * value with a [google.rpc.Status.code][google.rpc.Status.code] of 1, * corresponding to `Code.CANCELLED`. @@ -296,9 +293,8 @@ public function getRequestedCancellation() } /** - * Output only. Identifies whether it has been requested cancellation - * for the operation. Operations that have successfully been cancelled - * have + * Output only. Identifies whether cancellation has been requested for the + * operation. Operations that have successfully been cancelled have * [google.longrunning.Operation.error][google.longrunning.Operation.error] * value with a [google.rpc.Status.code][google.rpc.Status.code] of 1, * corresponding to `Code.CANCELLED`. diff --git a/GkeMultiCloud/src/V1/ReplicaPlacement.php b/GkeMultiCloud/src/V1/ReplicaPlacement.php index c78be2466d12..98ff59c19a29 100644 --- a/GkeMultiCloud/src/V1/ReplicaPlacement.php +++ b/GkeMultiCloud/src/V1/ReplicaPlacement.php @@ -11,6 +11,7 @@ /** * Configuration for the placement of a control plane replica. * + * @deprecated * Generated from protobuf message google.cloud.gkemulticloud.v1.ReplicaPlacement */ class ReplicaPlacement extends \Google\Protobuf\Internal\Message diff --git a/GkeMultiCloud/src/V1/RollbackAwsNodePoolUpdateRequest.php b/GkeMultiCloud/src/V1/RollbackAwsNodePoolUpdateRequest.php index 6d5b8a8bbc0d..f18c75d472ec 100644 --- a/GkeMultiCloud/src/V1/RollbackAwsNodePoolUpdateRequest.php +++ b/GkeMultiCloud/src/V1/RollbackAwsNodePoolUpdateRequest.php @@ -11,6 +11,7 @@ /** * Request message for `AwsClusters.RollbackAwsNodePoolUpdate` method. * + * @deprecated * Generated from protobuf message google.cloud.gkemulticloud.v1.RollbackAwsNodePoolUpdateRequest */ class RollbackAwsNodePoolUpdateRequest extends \Google\Protobuf\Internal\Message diff --git a/GkeMultiCloud/src/V1/SpotConfig.php b/GkeMultiCloud/src/V1/SpotConfig.php index b618a0428969..3252f6a3326e 100644 --- a/GkeMultiCloud/src/V1/SpotConfig.php +++ b/GkeMultiCloud/src/V1/SpotConfig.php @@ -11,6 +11,7 @@ /** * SpotConfig has configuration info for Spot node. * + * @deprecated * Generated from protobuf message google.cloud.gkemulticloud.v1.SpotConfig */ class SpotConfig extends \Google\Protobuf\Internal\Message diff --git a/GkeMultiCloud/src/V1/SurgeSettings.php b/GkeMultiCloud/src/V1/SurgeSettings.php index 80494e596f75..ba4f2808807e 100644 --- a/GkeMultiCloud/src/V1/SurgeSettings.php +++ b/GkeMultiCloud/src/V1/SurgeSettings.php @@ -11,6 +11,7 @@ /** * SurgeSettings contains the parameters for Surge update. * + * @deprecated * Generated from protobuf message google.cloud.gkemulticloud.v1.SurgeSettings */ class SurgeSettings extends \Google\Protobuf\Internal\Message diff --git a/GkeMultiCloud/src/V1/SystemComponentsConfig.php b/GkeMultiCloud/src/V1/SystemComponentsConfig.php new file mode 100644 index 000000000000..0af72fbebc34 --- /dev/null +++ b/GkeMultiCloud/src/V1/SystemComponentsConfig.php @@ -0,0 +1,102 @@ +google.cloud.gkemulticloud.v1.SystemComponentsConfig + */ +class SystemComponentsConfig extends \Google\Protobuf\Internal\Message +{ + /** + * Sets custom tolerations for pods created by auto-installed components. + * + * Generated from protobuf field repeated .google.cloud.gkemulticloud.v1.Toleration tolerations = 1; + */ + private $tolerations; + /** + * Sets custom labels for pods created by auto-installed components. + * + * Generated from protobuf field repeated .google.cloud.gkemulticloud.v1.Label labels = 2; + */ + private $labels; + + /** + * Constructor. + * + * @param array $data { + * Optional. Data for populating the Message object. + * + * @type array<\Google\Cloud\GkeMultiCloud\V1\Toleration>|\Google\Protobuf\Internal\RepeatedField $tolerations + * Sets custom tolerations for pods created by auto-installed components. + * @type array<\Google\Cloud\GkeMultiCloud\V1\Label>|\Google\Protobuf\Internal\RepeatedField $labels + * Sets custom labels for pods created by auto-installed components. + * } + */ + public function __construct($data = NULL) { + \GPBMetadata\Google\Cloud\Gkemulticloud\V1\AttachedResources::initOnce(); + parent::__construct($data); + } + + /** + * Sets custom tolerations for pods created by auto-installed components. + * + * Generated from protobuf field repeated .google.cloud.gkemulticloud.v1.Toleration tolerations = 1; + * @return \Google\Protobuf\Internal\RepeatedField + */ + public function getTolerations() + { + return $this->tolerations; + } + + /** + * Sets custom tolerations for pods created by auto-installed components. + * + * Generated from protobuf field repeated .google.cloud.gkemulticloud.v1.Toleration tolerations = 1; + * @param array<\Google\Cloud\GkeMultiCloud\V1\Toleration>|\Google\Protobuf\Internal\RepeatedField $var + * @return $this + */ + public function setTolerations($var) + { + $arr = GPBUtil::checkRepeatedField($var, \Google\Protobuf\Internal\GPBType::MESSAGE, \Google\Cloud\GkeMultiCloud\V1\Toleration::class); + $this->tolerations = $arr; + + return $this; + } + + /** + * Sets custom labels for pods created by auto-installed components. + * + * Generated from protobuf field repeated .google.cloud.gkemulticloud.v1.Label labels = 2; + * @return \Google\Protobuf\Internal\RepeatedField + */ + public function getLabels() + { + return $this->labels; + } + + /** + * Sets custom labels for pods created by auto-installed components. + * + * Generated from protobuf field repeated .google.cloud.gkemulticloud.v1.Label labels = 2; + * @param array<\Google\Cloud\GkeMultiCloud\V1\Label>|\Google\Protobuf\Internal\RepeatedField $var + * @return $this + */ + public function setLabels($var) + { + $arr = GPBUtil::checkRepeatedField($var, \Google\Protobuf\Internal\GPBType::MESSAGE, \Google\Cloud\GkeMultiCloud\V1\Label::class); + $this->labels = $arr; + + return $this; + } + +} + diff --git a/GkeMultiCloud/src/V1/Toleration.php b/GkeMultiCloud/src/V1/Toleration.php new file mode 100644 index 000000000000..94e8dedae9eb --- /dev/null +++ b/GkeMultiCloud/src/V1/Toleration.php @@ -0,0 +1,170 @@ +google.cloud.gkemulticloud.v1.Toleration + */ +class Toleration extends \Google\Protobuf\Internal\Message +{ + /** + * Key is the taint key that the toleration applies to. + * + * Generated from protobuf field string key = 1; + */ + protected $key = ''; + /** + * Value is the taint value that the toleration applies to. + * + * Generated from protobuf field string value = 2; + */ + protected $value = ''; + /** + * KeyOperator represents a key's relationship to the value e.g. 'Exist'. + * + * Generated from protobuf field .google.cloud.gkemulticloud.v1.Toleration.KeyOperator key_operator = 3; + */ + protected $key_operator = 0; + /** + * Effect indicates the taint effect to match e.g. 'NoSchedule' + * + * Generated from protobuf field .google.cloud.gkemulticloud.v1.Toleration.Effect effect = 4; + */ + protected $effect = 0; + + /** + * Constructor. + * + * @param array $data { + * Optional. Data for populating the Message object. + * + * @type string $key + * Key is the taint key that the toleration applies to. + * @type string $value + * Value is the taint value that the toleration applies to. + * @type int $key_operator + * KeyOperator represents a key's relationship to the value e.g. 'Exist'. + * @type int $effect + * Effect indicates the taint effect to match e.g. 'NoSchedule' + * } + */ + public function __construct($data = NULL) { + \GPBMetadata\Google\Cloud\Gkemulticloud\V1\AttachedResources::initOnce(); + parent::__construct($data); + } + + /** + * Key is the taint key that the toleration applies to. + * + * Generated from protobuf field string key = 1; + * @return string + */ + public function getKey() + { + return $this->key; + } + + /** + * Key is the taint key that the toleration applies to. + * + * Generated from protobuf field string key = 1; + * @param string $var + * @return $this + */ + public function setKey($var) + { + GPBUtil::checkString($var, True); + $this->key = $var; + + return $this; + } + + /** + * Value is the taint value that the toleration applies to. + * + * Generated from protobuf field string value = 2; + * @return string + */ + public function getValue() + { + return $this->value; + } + + /** + * Value is the taint value that the toleration applies to. + * + * Generated from protobuf field string value = 2; + * @param string $var + * @return $this + */ + public function setValue($var) + { + GPBUtil::checkString($var, True); + $this->value = $var; + + return $this; + } + + /** + * KeyOperator represents a key's relationship to the value e.g. 'Exist'. + * + * Generated from protobuf field .google.cloud.gkemulticloud.v1.Toleration.KeyOperator key_operator = 3; + * @return int + */ + public function getKeyOperator() + { + return $this->key_operator; + } + + /** + * KeyOperator represents a key's relationship to the value e.g. 'Exist'. + * + * Generated from protobuf field .google.cloud.gkemulticloud.v1.Toleration.KeyOperator key_operator = 3; + * @param int $var + * @return $this + */ + public function setKeyOperator($var) + { + GPBUtil::checkEnum($var, \Google\Cloud\GkeMultiCloud\V1\Toleration\KeyOperator::class); + $this->key_operator = $var; + + return $this; + } + + /** + * Effect indicates the taint effect to match e.g. 'NoSchedule' + * + * Generated from protobuf field .google.cloud.gkemulticloud.v1.Toleration.Effect effect = 4; + * @return int + */ + public function getEffect() + { + return $this->effect; + } + + /** + * Effect indicates the taint effect to match e.g. 'NoSchedule' + * + * Generated from protobuf field .google.cloud.gkemulticloud.v1.Toleration.Effect effect = 4; + * @param int $var + * @return $this + */ + public function setEffect($var) + { + GPBUtil::checkEnum($var, \Google\Cloud\GkeMultiCloud\V1\Toleration\Effect::class); + $this->effect = $var; + + return $this; + } + +} + diff --git a/GkeMultiCloud/src/V1/Toleration/Effect.php b/GkeMultiCloud/src/V1/Toleration/Effect.php new file mode 100644 index 000000000000..78e09e63c264 --- /dev/null +++ b/GkeMultiCloud/src/V1/Toleration/Effect.php @@ -0,0 +1,69 @@ +google.cloud.gkemulticloud.v1.Toleration.Effect + */ +class Effect +{ + /** + * Effect is not specified. + * + * Generated from protobuf enum EFFECT_UNSPECIFIED = 0; + */ + const EFFECT_UNSPECIFIED = 0; + /** + * Effect maps to 'NoSchedule'. + * + * Generated from protobuf enum EFFECT_NO_SCHEDULE = 1; + */ + const EFFECT_NO_SCHEDULE = 1; + /** + * Effect maps to 'PreferNoSchedule'. + * + * Generated from protobuf enum EFFECT_PREFER_NO_SCHEDULE = 2; + */ + const EFFECT_PREFER_NO_SCHEDULE = 2; + /** + * Effect maps to 'NoExecute'. + * + * Generated from protobuf enum EFFECT_NO_EXECUTE = 3; + */ + const EFFECT_NO_EXECUTE = 3; + + private static $valueToName = [ + self::EFFECT_UNSPECIFIED => 'EFFECT_UNSPECIFIED', + self::EFFECT_NO_SCHEDULE => 'EFFECT_NO_SCHEDULE', + self::EFFECT_PREFER_NO_SCHEDULE => 'EFFECT_PREFER_NO_SCHEDULE', + self::EFFECT_NO_EXECUTE => 'EFFECT_NO_EXECUTE', + ]; + + public static function name($value) + { + if (!isset(self::$valueToName[$value])) { + throw new UnexpectedValueException(sprintf( + 'Enum %s has no name defined for value %s', __CLASS__, $value)); + } + return self::$valueToName[$value]; + } + + + public static function value($name) + { + $const = __CLASS__ . '::' . strtoupper($name); + if (!defined($const)) { + throw new UnexpectedValueException(sprintf( + 'Enum %s has no value defined for name %s', __CLASS__, $name)); + } + return constant($const); + } +} + + diff --git a/GkeMultiCloud/src/V1/Toleration/KeyOperator.php b/GkeMultiCloud/src/V1/Toleration/KeyOperator.php new file mode 100644 index 000000000000..d4349b83ed42 --- /dev/null +++ b/GkeMultiCloud/src/V1/Toleration/KeyOperator.php @@ -0,0 +1,62 @@ +google.cloud.gkemulticloud.v1.Toleration.KeyOperator + */ +class KeyOperator +{ + /** + * Operator is not specified. + * + * Generated from protobuf enum KEY_OPERATOR_UNSPECIFIED = 0; + */ + const KEY_OPERATOR_UNSPECIFIED = 0; + /** + * Operator maps to 'Equal'. + * + * Generated from protobuf enum KEY_OPERATOR_EQUAL = 1; + */ + const KEY_OPERATOR_EQUAL = 1; + /** + * Operator maps to 'Exists'. + * + * Generated from protobuf enum KEY_OPERATOR_EXISTS = 2; + */ + const KEY_OPERATOR_EXISTS = 2; + + private static $valueToName = [ + self::KEY_OPERATOR_UNSPECIFIED => 'KEY_OPERATOR_UNSPECIFIED', + self::KEY_OPERATOR_EQUAL => 'KEY_OPERATOR_EQUAL', + self::KEY_OPERATOR_EXISTS => 'KEY_OPERATOR_EXISTS', + ]; + + public static function name($value) + { + if (!isset(self::$valueToName[$value])) { + throw new UnexpectedValueException(sprintf( + 'Enum %s has no name defined for value %s', __CLASS__, $value)); + } + return self::$valueToName[$value]; + } + + + public static function value($name) + { + $const = __CLASS__ . '::' . strtoupper($name); + if (!defined($const)) { + throw new UnexpectedValueException(sprintf( + 'Enum %s has no value defined for name %s', __CLASS__, $name)); + } + return constant($const); + } +} + + diff --git a/GkeMultiCloud/src/V1/UpdateAwsClusterRequest.php b/GkeMultiCloud/src/V1/UpdateAwsClusterRequest.php index 401b27d1d3e5..c946993825ec 100644 --- a/GkeMultiCloud/src/V1/UpdateAwsClusterRequest.php +++ b/GkeMultiCloud/src/V1/UpdateAwsClusterRequest.php @@ -11,6 +11,7 @@ /** * Request message for `AwsClusters.UpdateAwsCluster` method. * + * @deprecated * Generated from protobuf message google.cloud.gkemulticloud.v1.UpdateAwsClusterRequest */ class UpdateAwsClusterRequest extends \Google\Protobuf\Internal\Message diff --git a/GkeMultiCloud/src/V1/UpdateAwsNodePoolRequest.php b/GkeMultiCloud/src/V1/UpdateAwsNodePoolRequest.php index e118a1b99de6..c396bf07507c 100644 --- a/GkeMultiCloud/src/V1/UpdateAwsNodePoolRequest.php +++ b/GkeMultiCloud/src/V1/UpdateAwsNodePoolRequest.php @@ -11,6 +11,7 @@ /** * Request message for `AwsClusters.UpdateAwsNodePool` method. * + * @deprecated * Generated from protobuf message google.cloud.gkemulticloud.v1.UpdateAwsNodePoolRequest */ class UpdateAwsNodePoolRequest extends \Google\Protobuf\Internal\Message diff --git a/GkeMultiCloud/src/V1/UpdateAzureClusterRequest.php b/GkeMultiCloud/src/V1/UpdateAzureClusterRequest.php index 19ebd29cfa43..2ffeaee715ec 100644 --- a/GkeMultiCloud/src/V1/UpdateAzureClusterRequest.php +++ b/GkeMultiCloud/src/V1/UpdateAzureClusterRequest.php @@ -11,6 +11,7 @@ /** * Request message for `AzureClusters.UpdateAzureCluster` method. * + * @deprecated * Generated from protobuf message google.cloud.gkemulticloud.v1.UpdateAzureClusterRequest */ class UpdateAzureClusterRequest extends \Google\Protobuf\Internal\Message diff --git a/GkeMultiCloud/src/V1/UpdateAzureNodePoolRequest.php b/GkeMultiCloud/src/V1/UpdateAzureNodePoolRequest.php index bb297a85b6dd..ab4127906755 100644 --- a/GkeMultiCloud/src/V1/UpdateAzureNodePoolRequest.php +++ b/GkeMultiCloud/src/V1/UpdateAzureNodePoolRequest.php @@ -11,6 +11,7 @@ /** * Request message for `AzureClusters.UpdateAzureNodePool` method. * + * @deprecated * Generated from protobuf message google.cloud.gkemulticloud.v1.UpdateAzureNodePoolRequest */ class UpdateAzureNodePoolRequest extends \Google\Protobuf\Internal\Message diff --git a/GkeMultiCloud/src/V1/UpdateSettings.php b/GkeMultiCloud/src/V1/UpdateSettings.php index 69dd63b604e0..70b09431148f 100644 --- a/GkeMultiCloud/src/V1/UpdateSettings.php +++ b/GkeMultiCloud/src/V1/UpdateSettings.php @@ -30,6 +30,7 @@ * 3. (max_surge + max_unavailable) determines the level of parallelism (i.e., * the number of nodes being updated at the same time). * + * @deprecated * Generated from protobuf message google.cloud.gkemulticloud.v1.UpdateSettings */ class UpdateSettings extends \Google\Protobuf\Internal\Message diff --git a/Logging/tests/Unit/PsrLoggerBatchTest.php b/Logging/tests/Unit/PsrLoggerBatchTest.php index 40e69c9753ff..b739bfcc4fe4 100644 --- a/Logging/tests/Unit/PsrLoggerBatchTest.php +++ b/Logging/tests/Unit/PsrLoggerBatchTest.php @@ -81,7 +81,7 @@ public function testSend( new \ReflectionClass('\\Google\\Cloud\\Logging\\PsrLogger'); $prop = $class->getProperty('loggers'); $prop->setAccessible(true); - $prop = $prop->setValue([$logName => $logger]); + $prop = $prop->setValue(null, [$logName => $logger]); $psrBatchLogger->send([new Entry()]); rewind($temp); $output = stream_get_contents($temp); diff --git a/Parallelstore/metadata/V1/Parallelstore.php b/Parallelstore/metadata/V1/Parallelstore.php index a2407c947202..5d067e1cd5f8 100644 Binary files a/Parallelstore/metadata/V1/Parallelstore.php and b/Parallelstore/metadata/V1/Parallelstore.php differ diff --git a/Parallelstore/src/V1/Client/ParallelstoreClient.php b/Parallelstore/src/V1/Client/ParallelstoreClient.php index 71a61accce32..79a0d8fd7115 100644 --- a/Parallelstore/src/V1/Client/ParallelstoreClient.php +++ b/Parallelstore/src/V1/Client/ParallelstoreClient.php @@ -113,9 +113,7 @@ final class ParallelstoreClient private const CODEGEN_NAME = 'gapic'; /** The default scopes required by the service. */ - public static $serviceScopes = [ - 'https://www.googleapis.com/auth/cloud-platform', - ]; + public static $serviceScopes = ['https://www.googleapis.com/auth/cloud-platform']; private $operationsClient; diff --git a/Parallelstore/src/V1/CreateInstanceRequest.php b/Parallelstore/src/V1/CreateInstanceRequest.php index 602bfbf612b0..a9eaa2903de8 100644 --- a/Parallelstore/src/V1/CreateInstanceRequest.php +++ b/Parallelstore/src/V1/CreateInstanceRequest.php @@ -45,8 +45,8 @@ class CreateInstanceRequest extends \Google\Protobuf\Internal\Message * request ID so that if you must retry your request, the server will know to * ignore the request if it has already been completed. The server will * guarantee that for at least 60 minutes since the first request. - * For example, consider a situation where you make an initial request and t - * he request times out. If you make the request again with the same request + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same request * ID, the server can check if original operation with the same request ID * was received, and if so, will ignore the second request. This prevents * clients from accidentally creating duplicate commitments. @@ -107,8 +107,8 @@ public static function build(string $parent, \Google\Cloud\Parallelstore\V1\Inst * request ID so that if you must retry your request, the server will know to * ignore the request if it has already been completed. The server will * guarantee that for at least 60 minutes since the first request. - * For example, consider a situation where you make an initial request and t - * he request times out. If you make the request again with the same request + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same request * ID, the server can check if original operation with the same request ID * was received, and if so, will ignore the second request. This prevents * clients from accidentally creating duplicate commitments. @@ -228,8 +228,8 @@ public function setInstance($var) * request ID so that if you must retry your request, the server will know to * ignore the request if it has already been completed. The server will * guarantee that for at least 60 minutes since the first request. - * For example, consider a situation where you make an initial request and t - * he request times out. If you make the request again with the same request + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same request * ID, the server can check if original operation with the same request ID * was received, and if so, will ignore the second request. This prevents * clients from accidentally creating duplicate commitments. @@ -249,8 +249,8 @@ public function getRequestId() * request ID so that if you must retry your request, the server will know to * ignore the request if it has already been completed. The server will * guarantee that for at least 60 minutes since the first request. - * For example, consider a situation where you make an initial request and t - * he request times out. If you make the request again with the same request + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same request * ID, the server can check if original operation with the same request ID * was received, and if so, will ignore the second request. This prevents * clients from accidentally creating duplicate commitments. diff --git a/Parallelstore/src/V1/DeleteInstanceRequest.php b/Parallelstore/src/V1/DeleteInstanceRequest.php index af5164d5b835..2307fbdf4225 100644 --- a/Parallelstore/src/V1/DeleteInstanceRequest.php +++ b/Parallelstore/src/V1/DeleteInstanceRequest.php @@ -26,8 +26,8 @@ class DeleteInstanceRequest extends \Google\Protobuf\Internal\Message * request ID so that if you must retry your request, the server will know to * ignore the request if it has already been completed. The server will * guarantee that for at least 60 minutes after the first request. - * For example, consider a situation where you make an initial request and t - * he request times out. If you make the request again with the same request + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same request * ID, the server can check if original operation with the same request ID * was received, and if so, will ignore the second request. This prevents * clients from accidentally creating duplicate commitments. @@ -65,8 +65,8 @@ public static function build(string $name): self * request ID so that if you must retry your request, the server will know to * ignore the request if it has already been completed. The server will * guarantee that for at least 60 minutes after the first request. - * For example, consider a situation where you make an initial request and t - * he request times out. If you make the request again with the same request + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same request * ID, the server can check if original operation with the same request ID * was received, and if so, will ignore the second request. This prevents * clients from accidentally creating duplicate commitments. @@ -110,8 +110,8 @@ public function setName($var) * request ID so that if you must retry your request, the server will know to * ignore the request if it has already been completed. The server will * guarantee that for at least 60 minutes after the first request. - * For example, consider a situation where you make an initial request and t - * he request times out. If you make the request again with the same request + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same request * ID, the server can check if original operation with the same request ID * was received, and if so, will ignore the second request. This prevents * clients from accidentally creating duplicate commitments. @@ -131,8 +131,8 @@ public function getRequestId() * request ID so that if you must retry your request, the server will know to * ignore the request if it has already been completed. The server will * guarantee that for at least 60 minutes after the first request. - * For example, consider a situation where you make an initial request and t - * he request times out. If you make the request again with the same request + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same request * ID, the server can check if original operation with the same request ID * was received, and if so, will ignore the second request. This prevents * clients from accidentally creating duplicate commitments. diff --git a/Parallelstore/src/V1/ExportDataRequest.php b/Parallelstore/src/V1/ExportDataRequest.php index 25a1ed7d4d1e..aa7d297283bd 100644 --- a/Parallelstore/src/V1/ExportDataRequest.php +++ b/Parallelstore/src/V1/ExportDataRequest.php @@ -26,8 +26,8 @@ class ExportDataRequest extends \Google\Protobuf\Internal\Message * request ID so that if you must retry your request, the server will know to * ignore the request if it has already been completed. The server will * guarantee that for at least 60 minutes since the first request. - * For example, consider a situation where you make an initial request and t - * he request times out. If you make the request again with the same request + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same request * ID, the server can check if original operation with the same request ID * was received, and if so, will ignore the second request. This prevents * clients from accidentally creating duplicate commitments. @@ -50,6 +50,12 @@ class ExportDataRequest extends \Google\Protobuf\Internal\Message * Generated from protobuf field string service_account = 5 [(.google.api.field_behavior) = OPTIONAL, (.google.api.resource_reference) = { */ protected $service_account = ''; + /** + * Optional. The metadata options for the export data. + * + * Generated from protobuf field .google.cloud.parallelstore.v1.TransferMetadataOptions metadata_options = 6 [(.google.api.field_behavior) = OPTIONAL]; + */ + protected $metadata_options = null; protected $source; protected $destination; @@ -70,8 +76,8 @@ class ExportDataRequest extends \Google\Protobuf\Internal\Message * request ID so that if you must retry your request, the server will know to * ignore the request if it has already been completed. The server will * guarantee that for at least 60 minutes since the first request. - * For example, consider a situation where you make an initial request and t - * he request times out. If you make the request again with the same request + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same request * ID, the server can check if original operation with the same request ID * was received, and if so, will ignore the second request. This prevents * clients from accidentally creating duplicate commitments. @@ -86,6 +92,8 @@ class ExportDataRequest extends \Google\Protobuf\Internal\Message * * `projects/-/serviceAccounts/{EMAIL_ADDRESS_OR_UNIQUE_ID}` * If unspecified, the Parallelstore service agent is used: * `service-@gcp-sa-parallelstore.iam.gserviceaccount.com` + * @type \Google\Cloud\Parallelstore\V1\TransferMetadataOptions $metadata_options + * Optional. The metadata options for the export data. * } */ public function __construct($data = NULL) { @@ -186,8 +194,8 @@ public function setName($var) * request ID so that if you must retry your request, the server will know to * ignore the request if it has already been completed. The server will * guarantee that for at least 60 minutes since the first request. - * For example, consider a situation where you make an initial request and t - * he request times out. If you make the request again with the same request + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same request * ID, the server can check if original operation with the same request ID * was received, and if so, will ignore the second request. This prevents * clients from accidentally creating duplicate commitments. @@ -207,8 +215,8 @@ public function getRequestId() * request ID so that if you must retry your request, the server will know to * ignore the request if it has already been completed. The server will * guarantee that for at least 60 minutes since the first request. - * For example, consider a situation where you make an initial request and t - * he request times out. If you make the request again with the same request + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same request * ID, the server can check if original operation with the same request ID * was received, and if so, will ignore the second request. This prevents * clients from accidentally creating duplicate commitments. @@ -267,6 +275,42 @@ public function setServiceAccount($var) return $this; } + /** + * Optional. The metadata options for the export data. + * + * Generated from protobuf field .google.cloud.parallelstore.v1.TransferMetadataOptions metadata_options = 6 [(.google.api.field_behavior) = OPTIONAL]; + * @return \Google\Cloud\Parallelstore\V1\TransferMetadataOptions|null + */ + public function getMetadataOptions() + { + return $this->metadata_options; + } + + public function hasMetadataOptions() + { + return isset($this->metadata_options); + } + + public function clearMetadataOptions() + { + unset($this->metadata_options); + } + + /** + * Optional. The metadata options for the export data. + * + * Generated from protobuf field .google.cloud.parallelstore.v1.TransferMetadataOptions metadata_options = 6 [(.google.api.field_behavior) = OPTIONAL]; + * @param \Google\Cloud\Parallelstore\V1\TransferMetadataOptions $var + * @return $this + */ + public function setMetadataOptions($var) + { + GPBUtil::checkMessage($var, \Google\Cloud\Parallelstore\V1\TransferMetadataOptions::class); + $this->metadata_options = $var; + + return $this; + } + /** * @return string */ diff --git a/Parallelstore/src/V1/ImportDataRequest.php b/Parallelstore/src/V1/ImportDataRequest.php index e9822439ab58..c06126f07306 100644 --- a/Parallelstore/src/V1/ImportDataRequest.php +++ b/Parallelstore/src/V1/ImportDataRequest.php @@ -26,8 +26,8 @@ class ImportDataRequest extends \Google\Protobuf\Internal\Message * request ID so that if you must retry your request, the server will know to * ignore the request if it has already been completed. The server will * guarantee that for at least 60 minutes since the first request. - * For example, consider a situation where you make an initial request and t - * he request times out. If you make the request again with the same request + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same request * ID, the server can check if original operation with the same request ID * was received, and if so, will ignore the second request. This prevents * clients from accidentally creating duplicate commitments. @@ -50,6 +50,12 @@ class ImportDataRequest extends \Google\Protobuf\Internal\Message * Generated from protobuf field string service_account = 5 [(.google.api.field_behavior) = OPTIONAL, (.google.api.resource_reference) = { */ protected $service_account = ''; + /** + * Optional. The transfer metadata options for the import data. + * + * Generated from protobuf field .google.cloud.parallelstore.v1.TransferMetadataOptions metadata_options = 6 [(.google.api.field_behavior) = OPTIONAL]; + */ + protected $metadata_options = null; protected $source; protected $destination; @@ -70,8 +76,8 @@ class ImportDataRequest extends \Google\Protobuf\Internal\Message * request ID so that if you must retry your request, the server will know to * ignore the request if it has already been completed. The server will * guarantee that for at least 60 minutes since the first request. - * For example, consider a situation where you make an initial request and t - * he request times out. If you make the request again with the same request + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same request * ID, the server can check if original operation with the same request ID * was received, and if so, will ignore the second request. This prevents * clients from accidentally creating duplicate commitments. @@ -86,6 +92,8 @@ class ImportDataRequest extends \Google\Protobuf\Internal\Message * * `projects/-/serviceAccounts/{EMAIL_ADDRESS_OR_UNIQUE_ID}` * If unspecified, the Parallelstore service agent is used: * `service-@gcp-sa-parallelstore.iam.gserviceaccount.com` + * @type \Google\Cloud\Parallelstore\V1\TransferMetadataOptions $metadata_options + * Optional. The transfer metadata options for the import data. * } */ public function __construct($data = NULL) { @@ -186,8 +194,8 @@ public function setName($var) * request ID so that if you must retry your request, the server will know to * ignore the request if it has already been completed. The server will * guarantee that for at least 60 minutes since the first request. - * For example, consider a situation where you make an initial request and t - * he request times out. If you make the request again with the same request + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same request * ID, the server can check if original operation with the same request ID * was received, and if so, will ignore the second request. This prevents * clients from accidentally creating duplicate commitments. @@ -207,8 +215,8 @@ public function getRequestId() * request ID so that if you must retry your request, the server will know to * ignore the request if it has already been completed. The server will * guarantee that for at least 60 minutes since the first request. - * For example, consider a situation where you make an initial request and t - * he request times out. If you make the request again with the same request + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same request * ID, the server can check if original operation with the same request ID * was received, and if so, will ignore the second request. This prevents * clients from accidentally creating duplicate commitments. @@ -267,6 +275,42 @@ public function setServiceAccount($var) return $this; } + /** + * Optional. The transfer metadata options for the import data. + * + * Generated from protobuf field .google.cloud.parallelstore.v1.TransferMetadataOptions metadata_options = 6 [(.google.api.field_behavior) = OPTIONAL]; + * @return \Google\Cloud\Parallelstore\V1\TransferMetadataOptions|null + */ + public function getMetadataOptions() + { + return $this->metadata_options; + } + + public function hasMetadataOptions() + { + return isset($this->metadata_options); + } + + public function clearMetadataOptions() + { + unset($this->metadata_options); + } + + /** + * Optional. The transfer metadata options for the import data. + * + * Generated from protobuf field .google.cloud.parallelstore.v1.TransferMetadataOptions metadata_options = 6 [(.google.api.field_behavior) = OPTIONAL]; + * @param \Google\Cloud\Parallelstore\V1\TransferMetadataOptions $var + * @return $this + */ + public function setMetadataOptions($var) + { + GPBUtil::checkMessage($var, \Google\Cloud\Parallelstore\V1\TransferMetadataOptions::class); + $this->metadata_options = $var; + + return $this; + } + /** * @return string */ diff --git a/Parallelstore/src/V1/Instance.php b/Parallelstore/src/V1/Instance.php index 0ac280825429..6cff19226f2f 100644 --- a/Parallelstore/src/V1/Instance.php +++ b/Parallelstore/src/V1/Instance.php @@ -64,8 +64,8 @@ class Instance extends \Google\Protobuf\Internal\Message */ protected $capacity_gib = 0; /** - * Output only. Deprecated 'daos_version' field. - * Output only. The version of DAOS software running in the instance. + * Output only. Deprecated: The version of DAOS software running in the + * instance. * * Generated from protobuf field string daos_version = 9 [deprecated = true, (.google.api.field_behavior) = OUTPUT_ONLY]; * @deprecated @@ -162,8 +162,8 @@ class Instance extends \Google\Protobuf\Internal\Message * Allowed values are between 12000 and 100000, in multiples of 4000; e.g., * 12000, 16000, 20000, ... * @type string $daos_version - * Output only. Deprecated 'daos_version' field. - * Output only. The version of DAOS software running in the instance. + * Output only. Deprecated: The version of DAOS software running in the + * instance. * @type array|\Google\Protobuf\Internal\RepeatedField $access_points * Output only. A list of IPv4 addresses used for client side configuration. * @type string $network @@ -421,8 +421,8 @@ public function setCapacityGib($var) } /** - * Output only. Deprecated 'daos_version' field. - * Output only. The version of DAOS software running in the instance. + * Output only. Deprecated: The version of DAOS software running in the + * instance. * * Generated from protobuf field string daos_version = 9 [deprecated = true, (.google.api.field_behavior) = OUTPUT_ONLY]; * @return string @@ -437,8 +437,8 @@ public function getDaosVersion() } /** - * Output only. Deprecated 'daos_version' field. - * Output only. The version of DAOS software running in the instance. + * Output only. Deprecated: The version of DAOS software running in the + * instance. * * Generated from protobuf field string daos_version = 9 [deprecated = true, (.google.api.field_behavior) = OUTPUT_ONLY]; * @param string $var diff --git a/Parallelstore/src/V1/TransferCounters.php b/Parallelstore/src/V1/TransferCounters.php index 365737555ca9..749cd95053c6 100644 --- a/Parallelstore/src/V1/TransferCounters.php +++ b/Parallelstore/src/V1/TransferCounters.php @@ -58,13 +58,13 @@ class TransferCounters extends \Google\Protobuf\Internal\Message */ protected $bytes_copied = 0; /** - * Objects that are failed to write to the data destination. + * Objects that failed to be written to the data destination. * * Generated from protobuf field int64 objects_failed = 7; */ protected $objects_failed = 0; /** - * Bytes that are failed to write to the data destination. + * Bytes that failed to be written to the data destination. * * Generated from protobuf field int64 bytes_failed = 8; */ @@ -95,9 +95,9 @@ class TransferCounters extends \Google\Protobuf\Internal\Message * @type int|string $bytes_copied * Bytes that are copied to the data destination. * @type int|string $objects_failed - * Objects that are failed to write to the data destination. + * Objects that failed to be written to the data destination. * @type int|string $bytes_failed - * Bytes that are failed to write to the data destination. + * Bytes that failed to be written to the data destination. * } */ public function __construct($data = NULL) { @@ -274,7 +274,7 @@ public function setBytesCopied($var) } /** - * Objects that are failed to write to the data destination. + * Objects that failed to be written to the data destination. * * Generated from protobuf field int64 objects_failed = 7; * @return int|string @@ -285,7 +285,7 @@ public function getObjectsFailed() } /** - * Objects that are failed to write to the data destination. + * Objects that failed to be written to the data destination. * * Generated from protobuf field int64 objects_failed = 7; * @param int|string $var @@ -300,7 +300,7 @@ public function setObjectsFailed($var) } /** - * Bytes that are failed to write to the data destination. + * Bytes that failed to be written to the data destination. * * Generated from protobuf field int64 bytes_failed = 8; * @return int|string @@ -311,7 +311,7 @@ public function getBytesFailed() } /** - * Bytes that are failed to write to the data destination. + * Bytes that failed to be written to the data destination. * * Generated from protobuf field int64 bytes_failed = 8; * @param int|string $var diff --git a/Parallelstore/src/V1/TransferMetadataOptions.php b/Parallelstore/src/V1/TransferMetadataOptions.php new file mode 100644 index 000000000000..3c48ec605871 --- /dev/null +++ b/Parallelstore/src/V1/TransferMetadataOptions.php @@ -0,0 +1,135 @@ +google.cloud.parallelstore.v1.TransferMetadataOptions + */ +class TransferMetadataOptions extends \Google\Protobuf\Internal\Message +{ + /** + * Optional. The UID preservation behavior. + * + * Generated from protobuf field .google.cloud.parallelstore.v1.TransferMetadataOptions.Uid uid = 1 [(.google.api.field_behavior) = OPTIONAL]; + */ + protected $uid = 0; + /** + * Optional. The GID preservation behavior. + * + * Generated from protobuf field .google.cloud.parallelstore.v1.TransferMetadataOptions.Gid gid = 2 [(.google.api.field_behavior) = OPTIONAL]; + */ + protected $gid = 0; + /** + * Optional. The mode preservation behavior. + * + * Generated from protobuf field .google.cloud.parallelstore.v1.TransferMetadataOptions.Mode mode = 3 [(.google.api.field_behavior) = OPTIONAL]; + */ + protected $mode = 0; + + /** + * Constructor. + * + * @param array $data { + * Optional. Data for populating the Message object. + * + * @type int $uid + * Optional. The UID preservation behavior. + * @type int $gid + * Optional. The GID preservation behavior. + * @type int $mode + * Optional. The mode preservation behavior. + * } + */ + public function __construct($data = NULL) { + \GPBMetadata\Google\Cloud\Parallelstore\V1\Parallelstore::initOnce(); + parent::__construct($data); + } + + /** + * Optional. The UID preservation behavior. + * + * Generated from protobuf field .google.cloud.parallelstore.v1.TransferMetadataOptions.Uid uid = 1 [(.google.api.field_behavior) = OPTIONAL]; + * @return int + */ + public function getUid() + { + return $this->uid; + } + + /** + * Optional. The UID preservation behavior. + * + * Generated from protobuf field .google.cloud.parallelstore.v1.TransferMetadataOptions.Uid uid = 1 [(.google.api.field_behavior) = OPTIONAL]; + * @param int $var + * @return $this + */ + public function setUid($var) + { + GPBUtil::checkEnum($var, \Google\Cloud\Parallelstore\V1\TransferMetadataOptions\Uid::class); + $this->uid = $var; + + return $this; + } + + /** + * Optional. The GID preservation behavior. + * + * Generated from protobuf field .google.cloud.parallelstore.v1.TransferMetadataOptions.Gid gid = 2 [(.google.api.field_behavior) = OPTIONAL]; + * @return int + */ + public function getGid() + { + return $this->gid; + } + + /** + * Optional. The GID preservation behavior. + * + * Generated from protobuf field .google.cloud.parallelstore.v1.TransferMetadataOptions.Gid gid = 2 [(.google.api.field_behavior) = OPTIONAL]; + * @param int $var + * @return $this + */ + public function setGid($var) + { + GPBUtil::checkEnum($var, \Google\Cloud\Parallelstore\V1\TransferMetadataOptions\Gid::class); + $this->gid = $var; + + return $this; + } + + /** + * Optional. The mode preservation behavior. + * + * Generated from protobuf field .google.cloud.parallelstore.v1.TransferMetadataOptions.Mode mode = 3 [(.google.api.field_behavior) = OPTIONAL]; + * @return int + */ + public function getMode() + { + return $this->mode; + } + + /** + * Optional. The mode preservation behavior. + * + * Generated from protobuf field .google.cloud.parallelstore.v1.TransferMetadataOptions.Mode mode = 3 [(.google.api.field_behavior) = OPTIONAL]; + * @param int $var + * @return $this + */ + public function setMode($var) + { + GPBUtil::checkEnum($var, \Google\Cloud\Parallelstore\V1\TransferMetadataOptions\Mode::class); + $this->mode = $var; + + return $this; + } + +} + diff --git a/Parallelstore/src/V1/TransferMetadataOptions/Gid.php b/Parallelstore/src/V1/TransferMetadataOptions/Gid.php new file mode 100644 index 000000000000..0710ef21bb1d --- /dev/null +++ b/Parallelstore/src/V1/TransferMetadataOptions/Gid.php @@ -0,0 +1,62 @@ +google.cloud.parallelstore.v1.TransferMetadataOptions.Gid + */ +class Gid +{ + /** + * default is GID_NUMBER_PRESERVE. + * + * Generated from protobuf enum GID_UNSPECIFIED = 0; + */ + const GID_UNSPECIFIED = 0; + /** + * Do not preserve GID during a transfer job. + * + * Generated from protobuf enum GID_SKIP = 1; + */ + const GID_SKIP = 1; + /** + * Preserve GID that is in number format during a transfer job. + * + * Generated from protobuf enum GID_NUMBER_PRESERVE = 2; + */ + const GID_NUMBER_PRESERVE = 2; + + private static $valueToName = [ + self::GID_UNSPECIFIED => 'GID_UNSPECIFIED', + self::GID_SKIP => 'GID_SKIP', + self::GID_NUMBER_PRESERVE => 'GID_NUMBER_PRESERVE', + ]; + + public static function name($value) + { + if (!isset(self::$valueToName[$value])) { + throw new UnexpectedValueException(sprintf( + 'Enum %s has no name defined for value %s', __CLASS__, $value)); + } + return self::$valueToName[$value]; + } + + + public static function value($name) + { + $const = __CLASS__ . '::' . strtoupper($name); + if (!defined($const)) { + throw new UnexpectedValueException(sprintf( + 'Enum %s has no value defined for name %s', __CLASS__, $name)); + } + return constant($const); + } +} + + diff --git a/Parallelstore/src/V1/TransferMetadataOptions/Mode.php b/Parallelstore/src/V1/TransferMetadataOptions/Mode.php new file mode 100644 index 000000000000..73c8c92ca7a5 --- /dev/null +++ b/Parallelstore/src/V1/TransferMetadataOptions/Mode.php @@ -0,0 +1,62 @@ +google.cloud.parallelstore.v1.TransferMetadataOptions.Mode + */ +class Mode +{ + /** + * default is MODE_PRESERVE. + * + * Generated from protobuf enum MODE_UNSPECIFIED = 0; + */ + const MODE_UNSPECIFIED = 0; + /** + * Do not preserve mode during a transfer job. + * + * Generated from protobuf enum MODE_SKIP = 1; + */ + const MODE_SKIP = 1; + /** + * Preserve mode during a transfer job. + * + * Generated from protobuf enum MODE_PRESERVE = 2; + */ + const MODE_PRESERVE = 2; + + private static $valueToName = [ + self::MODE_UNSPECIFIED => 'MODE_UNSPECIFIED', + self::MODE_SKIP => 'MODE_SKIP', + self::MODE_PRESERVE => 'MODE_PRESERVE', + ]; + + public static function name($value) + { + if (!isset(self::$valueToName[$value])) { + throw new UnexpectedValueException(sprintf( + 'Enum %s has no name defined for value %s', __CLASS__, $value)); + } + return self::$valueToName[$value]; + } + + + public static function value($name) + { + $const = __CLASS__ . '::' . strtoupper($name); + if (!defined($const)) { + throw new UnexpectedValueException(sprintf( + 'Enum %s has no value defined for name %s', __CLASS__, $name)); + } + return constant($const); + } +} + + diff --git a/Parallelstore/src/V1/TransferMetadataOptions/Uid.php b/Parallelstore/src/V1/TransferMetadataOptions/Uid.php new file mode 100644 index 000000000000..344b4e15c521 --- /dev/null +++ b/Parallelstore/src/V1/TransferMetadataOptions/Uid.php @@ -0,0 +1,62 @@ +google.cloud.parallelstore.v1.TransferMetadataOptions.Uid + */ +class Uid +{ + /** + * default is UID_NUMBER_PRESERVE. + * + * Generated from protobuf enum UID_UNSPECIFIED = 0; + */ + const UID_UNSPECIFIED = 0; + /** + * Do not preserve UID during a transfer job. + * + * Generated from protobuf enum UID_SKIP = 1; + */ + const UID_SKIP = 1; + /** + * Preserve UID that is in number format during a transfer job. + * + * Generated from protobuf enum UID_NUMBER_PRESERVE = 2; + */ + const UID_NUMBER_PRESERVE = 2; + + private static $valueToName = [ + self::UID_UNSPECIFIED => 'UID_UNSPECIFIED', + self::UID_SKIP => 'UID_SKIP', + self::UID_NUMBER_PRESERVE => 'UID_NUMBER_PRESERVE', + ]; + + public static function name($value) + { + if (!isset(self::$valueToName[$value])) { + throw new UnexpectedValueException(sprintf( + 'Enum %s has no name defined for value %s', __CLASS__, $value)); + } + return self::$valueToName[$value]; + } + + + public static function value($name) + { + $const = __CLASS__ . '::' . strtoupper($name); + if (!defined($const)) { + throw new UnexpectedValueException(sprintf( + 'Enum %s has no value defined for name %s', __CLASS__, $name)); + } + return constant($const); + } +} + + diff --git a/Parallelstore/src/V1/UpdateInstanceRequest.php b/Parallelstore/src/V1/UpdateInstanceRequest.php index e2e23b6223a6..4ba5ee7a86cc 100644 --- a/Parallelstore/src/V1/UpdateInstanceRequest.php +++ b/Parallelstore/src/V1/UpdateInstanceRequest.php @@ -35,8 +35,8 @@ class UpdateInstanceRequest extends \Google\Protobuf\Internal\Message * request ID so that if you must retry your request, the server will know to * ignore the request if it has already been completed. The server will * guarantee that for at least 60 minutes since the first request. - * For example, consider a situation where you make an initial request and t - * he request times out. If you make the request again with the same request + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same request * ID, the server can check if original operation with the same request ID * was received, and if so, will ignore the second request. This prevents * clients from accidentally creating duplicate commitments. @@ -83,8 +83,8 @@ public static function build(\Google\Cloud\Parallelstore\V1\Instance $instance, * request ID so that if you must retry your request, the server will know to * ignore the request if it has already been completed. The server will * guarantee that for at least 60 minutes since the first request. - * For example, consider a situation where you make an initial request and t - * he request times out. If you make the request again with the same request + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same request * ID, the server can check if original operation with the same request ID * was received, and if so, will ignore the second request. This prevents * clients from accidentally creating duplicate commitments. @@ -180,8 +180,8 @@ public function setInstance($var) * request ID so that if you must retry your request, the server will know to * ignore the request if it has already been completed. The server will * guarantee that for at least 60 minutes since the first request. - * For example, consider a situation where you make an initial request and t - * he request times out. If you make the request again with the same request + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same request * ID, the server can check if original operation with the same request ID * was received, and if so, will ignore the second request. This prevents * clients from accidentally creating duplicate commitments. @@ -201,8 +201,8 @@ public function getRequestId() * request ID so that if you must retry your request, the server will know to * ignore the request if it has already been completed. The server will * guarantee that for at least 60 minutes since the first request. - * For example, consider a situation where you make an initial request and t - * he request times out. If you make the request again with the same request + * For example, consider a situation where you make an initial request and + * the request times out. If you make the request again with the same request * ID, the server can check if original operation with the same request ID * was received, and if so, will ignore the second request. This prevents * clients from accidentally creating duplicate commitments. diff --git a/Parallelstore/src/V1beta/Client/ParallelstoreClient.php b/Parallelstore/src/V1beta/Client/ParallelstoreClient.php index 7572cd8550d6..ba8e36b8bc7e 100644 --- a/Parallelstore/src/V1beta/Client/ParallelstoreClient.php +++ b/Parallelstore/src/V1beta/Client/ParallelstoreClient.php @@ -117,9 +117,7 @@ final class ParallelstoreClient private const CODEGEN_NAME = 'gapic'; /** The default scopes required by the service. */ - public static $serviceScopes = [ - 'https://www.googleapis.com/auth/cloud-platform', - ]; + public static $serviceScopes = ['https://www.googleapis.com/auth/cloud-platform']; private $operationsClient; diff --git a/ShoppingMerchantAccounts/metadata/V1/Regions.php b/ShoppingMerchantAccounts/metadata/V1/Regions.php index ecef3c3bdb01..1d7f4b91ca91 100644 Binary files a/ShoppingMerchantAccounts/metadata/V1/Regions.php and b/ShoppingMerchantAccounts/metadata/V1/Regions.php differ diff --git a/ShoppingMerchantAccounts/src/V1/Region.php b/ShoppingMerchantAccounts/src/V1/Region.php index 28ccc4929ec8..ceda78ee0751 100644 --- a/ShoppingMerchantAccounts/src/V1/Region.php +++ b/ShoppingMerchantAccounts/src/V1/Region.php @@ -59,6 +59,12 @@ class Region extends \Google\Protobuf\Internal\Message * Generated from protobuf field .google.protobuf.BoolValue shipping_eligible = 6 [(.google.api.field_behavior) = OUTPUT_ONLY]; */ protected $shipping_eligible = null; + /** + * Optional. A radius area that defines the region area. + * + * Generated from protobuf field .google.shopping.merchant.accounts.v1.Region.RadiusArea radius_area = 7 [(.google.api.field_behavior) = OPTIONAL]; + */ + protected $radius_area = null; /** * Constructor. @@ -81,6 +87,8 @@ class Region extends \Google\Protobuf\Internal\Message * @type \Google\Protobuf\BoolValue $shipping_eligible * Output only. Indicates if the region is eligible for use in the Shipping * Services configuration. + * @type \Google\Shopping\Merchant\Accounts\V1\Region\RadiusArea $radius_area + * Optional. A radius area that defines the region area. * } */ public function __construct($data = NULL) { @@ -358,5 +366,41 @@ public function setShippingEligibleUnwrapped($var) $this->writeWrapperValue("shipping_eligible", $var); return $this;} + /** + * Optional. A radius area that defines the region area. + * + * Generated from protobuf field .google.shopping.merchant.accounts.v1.Region.RadiusArea radius_area = 7 [(.google.api.field_behavior) = OPTIONAL]; + * @return \Google\Shopping\Merchant\Accounts\V1\Region\RadiusArea|null + */ + public function getRadiusArea() + { + return $this->radius_area; + } + + public function hasRadiusArea() + { + return isset($this->radius_area); + } + + public function clearRadiusArea() + { + unset($this->radius_area); + } + + /** + * Optional. A radius area that defines the region area. + * + * Generated from protobuf field .google.shopping.merchant.accounts.v1.Region.RadiusArea radius_area = 7 [(.google.api.field_behavior) = OPTIONAL]; + * @param \Google\Shopping\Merchant\Accounts\V1\Region\RadiusArea $var + * @return $this + */ + public function setRadiusArea($var) + { + GPBUtil::checkMessage($var, \Google\Shopping\Merchant\Accounts\V1\Region\RadiusArea::class); + $this->radius_area = $var; + + return $this; + } + } diff --git a/ShoppingMerchantAccounts/src/V1/Region/RadiusArea.php b/ShoppingMerchantAccounts/src/V1/Region/RadiusArea.php new file mode 100644 index 000000000000..47740678958f --- /dev/null +++ b/ShoppingMerchantAccounts/src/V1/Region/RadiusArea.php @@ -0,0 +1,192 @@ +google.shopping.merchant.accounts.v1.Region.RadiusArea + */ +class RadiusArea extends \Google\Protobuf\Internal\Message +{ + /** + * Required. [CLDR territory + * code](http://www.unicode.org/repos/cldr/tags/latest/common/main/en.xml) + * or the country the radius area applies to. + * + * Generated from protobuf field string region_code = 1 [(.google.api.field_behavior) = REQUIRED]; + */ + protected $region_code = ''; + /** + * Required. The center of the radius area. It represents a + * latitude/longitude pair in decimal degrees format. + * + * Generated from protobuf field .google.type.LatLng lat_lng = 2 [(.google.api.field_behavior) = REQUIRED]; + */ + protected $lat_lng = null; + /** + * Required. The radius distance of the area. + * + * Generated from protobuf field double radius = 3 [(.google.api.field_behavior) = REQUIRED]; + */ + protected $radius = 0.0; + /** + * Optional. The unit of the radius. + * + * Generated from protobuf field .google.shopping.merchant.accounts.v1.Region.RadiusArea.RadiusUnits radius_units = 4 [(.google.api.field_behavior) = OPTIONAL]; + */ + protected $radius_units = 0; + + /** + * Constructor. + * + * @param array $data { + * Optional. Data for populating the Message object. + * + * @type string $region_code + * Required. [CLDR territory + * code](http://www.unicode.org/repos/cldr/tags/latest/common/main/en.xml) + * or the country the radius area applies to. + * @type \Google\Type\LatLng $lat_lng + * Required. The center of the radius area. It represents a + * latitude/longitude pair in decimal degrees format. + * @type float $radius + * Required. The radius distance of the area. + * @type int $radius_units + * Optional. The unit of the radius. + * } + */ + public function __construct($data = NULL) { + \GPBMetadata\Google\Shopping\Merchant\Accounts\V1\Regions::initOnce(); + parent::__construct($data); + } + + /** + * Required. [CLDR territory + * code](http://www.unicode.org/repos/cldr/tags/latest/common/main/en.xml) + * or the country the radius area applies to. + * + * Generated from protobuf field string region_code = 1 [(.google.api.field_behavior) = REQUIRED]; + * @return string + */ + public function getRegionCode() + { + return $this->region_code; + } + + /** + * Required. [CLDR territory + * code](http://www.unicode.org/repos/cldr/tags/latest/common/main/en.xml) + * or the country the radius area applies to. + * + * Generated from protobuf field string region_code = 1 [(.google.api.field_behavior) = REQUIRED]; + * @param string $var + * @return $this + */ + public function setRegionCode($var) + { + GPBUtil::checkString($var, True); + $this->region_code = $var; + + return $this; + } + + /** + * Required. The center of the radius area. It represents a + * latitude/longitude pair in decimal degrees format. + * + * Generated from protobuf field .google.type.LatLng lat_lng = 2 [(.google.api.field_behavior) = REQUIRED]; + * @return \Google\Type\LatLng|null + */ + public function getLatLng() + { + return $this->lat_lng; + } + + public function hasLatLng() + { + return isset($this->lat_lng); + } + + public function clearLatLng() + { + unset($this->lat_lng); + } + + /** + * Required. The center of the radius area. It represents a + * latitude/longitude pair in decimal degrees format. + * + * Generated from protobuf field .google.type.LatLng lat_lng = 2 [(.google.api.field_behavior) = REQUIRED]; + * @param \Google\Type\LatLng $var + * @return $this + */ + public function setLatLng($var) + { + GPBUtil::checkMessage($var, \Google\Type\LatLng::class); + $this->lat_lng = $var; + + return $this; + } + + /** + * Required. The radius distance of the area. + * + * Generated from protobuf field double radius = 3 [(.google.api.field_behavior) = REQUIRED]; + * @return float + */ + public function getRadius() + { + return $this->radius; + } + + /** + * Required. The radius distance of the area. + * + * Generated from protobuf field double radius = 3 [(.google.api.field_behavior) = REQUIRED]; + * @param float $var + * @return $this + */ + public function setRadius($var) + { + GPBUtil::checkDouble($var); + $this->radius = $var; + + return $this; + } + + /** + * Optional. The unit of the radius. + * + * Generated from protobuf field .google.shopping.merchant.accounts.v1.Region.RadiusArea.RadiusUnits radius_units = 4 [(.google.api.field_behavior) = OPTIONAL]; + * @return int + */ + public function getRadiusUnits() + { + return $this->radius_units; + } + + /** + * Optional. The unit of the radius. + * + * Generated from protobuf field .google.shopping.merchant.accounts.v1.Region.RadiusArea.RadiusUnits radius_units = 4 [(.google.api.field_behavior) = OPTIONAL]; + * @param int $var + * @return $this + */ + public function setRadiusUnits($var) + { + GPBUtil::checkEnum($var, \Google\Shopping\Merchant\Accounts\V1\Region\RadiusArea\RadiusUnits::class); + $this->radius_units = $var; + + return $this; + } + +} + + diff --git a/ShoppingMerchantAccounts/src/V1/Region/RadiusArea/RadiusUnits.php b/ShoppingMerchantAccounts/src/V1/Region/RadiusArea/RadiusUnits.php new file mode 100644 index 000000000000..055c8ec1b65b --- /dev/null +++ b/ShoppingMerchantAccounts/src/V1/Region/RadiusArea/RadiusUnits.php @@ -0,0 +1,62 @@ +google.shopping.merchant.accounts.v1.Region.RadiusArea.RadiusUnits + */ +class RadiusUnits +{ + /** + * Unused default value + * + * Generated from protobuf enum RADIUS_UNITS_UNSPECIFIED = 0; + */ + const RADIUS_UNITS_UNSPECIFIED = 0; + /** + * The distance is measured in miles. + * + * Generated from protobuf enum MILES = 1; + */ + const MILES = 1; + /** + * The distance is measured in kilometers. + * + * Generated from protobuf enum KILOMETERS = 2; + */ + const KILOMETERS = 2; + + private static $valueToName = [ + self::RADIUS_UNITS_UNSPECIFIED => 'RADIUS_UNITS_UNSPECIFIED', + self::MILES => 'MILES', + self::KILOMETERS => 'KILOMETERS', + ]; + + public static function name($value) + { + if (!isset(self::$valueToName[$value])) { + throw new UnexpectedValueException(sprintf( + 'Enum %s has no name defined for value %s', __CLASS__, $value)); + } + return self::$valueToName[$value]; + } + + + public static function value($name) + { + $const = __CLASS__ . '::' . strtoupper($name); + if (!defined($const)) { + throw new UnexpectedValueException(sprintf( + 'Enum %s has no value defined for name %s', __CLASS__, $name)); + } + return constant($const); + } +} + + diff --git a/Spanner/src/V1/RoutingHint.php b/Spanner/src/V1/RoutingHint.php index 679665307432..40c84823d8db 100644 --- a/Spanner/src/V1/RoutingHint.php +++ b/Spanner/src/V1/RoutingHint.php @@ -105,10 +105,8 @@ class RoutingHint extends \Google\Protobuf\Internal\Message */ private $skipped_tablet_uid; /** - * If present, the client's current location. In the Spanner managed service, - * this should be the name of a Google Cloud zone or region, such as - * "us-central1". In Spanner Omni, this should correspond to a previously - * created location. + * If present, the client's current location. This should be the name of a + * Google Cloud zone or region, such as "us-central1". * If absent, the client's location will be assumed to be the same as the * location of the server the client ends up connected to. * Locations are primarily valuable for clients that connect from regions @@ -167,10 +165,8 @@ class RoutingHint extends \Google\Protobuf\Internal\Message * tablets, with their incarnations. The server may include a `CacheUpdate` * with new locations for those tablets. * @type string $client_location - * If present, the client's current location. In the Spanner managed service, - * this should be the name of a Google Cloud zone or region, such as - * "us-central1". In Spanner Omni, this should correspond to a previously - * created location. + * If present, the client's current location. This should be the name of a + * Google Cloud zone or region, such as "us-central1". * If absent, the client's location will be assumed to be the same as the * location of the server the client ends up connected to. * Locations are primarily valuable for clients that connect from regions @@ -465,10 +461,8 @@ public function setSkippedTabletUid($var) } /** - * If present, the client's current location. In the Spanner managed service, - * this should be the name of a Google Cloud zone or region, such as - * "us-central1". In Spanner Omni, this should correspond to a previously - * created location. + * If present, the client's current location. This should be the name of a + * Google Cloud zone or region, such as "us-central1". * If absent, the client's location will be assumed to be the same as the * location of the server the client ends up connected to. * Locations are primarily valuable for clients that connect from regions @@ -483,10 +477,8 @@ public function getClientLocation() } /** - * If present, the client's current location. In the Spanner managed service, - * this should be the name of a Google Cloud zone or region, such as - * "us-central1". In Spanner Omni, this should correspond to a previously - * created location. + * If present, the client's current location. This should be the name of a + * Google Cloud zone or region, such as "us-central1". * If absent, the client's location will be assumed to be the same as the * location of the server the client ends up connected to. * Locations are primarily valuable for clients that connect from regions diff --git a/Spanner/src/V1/Tablet.php b/Spanner/src/V1/Tablet.php index 06e19d219bb7..329292b50413 100644 --- a/Spanner/src/V1/Tablet.php +++ b/Spanner/src/V1/Tablet.php @@ -32,9 +32,8 @@ class Tablet extends \Google\Protobuf\Internal\Message */ protected $server_address = ''; /** - * Where this tablet is located. In the Spanner managed service, this is the - * name of a region, such as "us-central1". In Spanner Omni, this is a - * previously created location. + * Where this tablet is located. This is the name of a Google Cloud region, + * such as "us-central1". * * Generated from protobuf field string location = 3; */ @@ -113,9 +112,8 @@ class Tablet extends \Google\Protobuf\Internal\Message * The address of the server that is serving this tablet -- either an IP * address or DNS hostname and a port number. * @type string $location - * Where this tablet is located. In the Spanner managed service, this is the - * name of a region, such as "us-central1". In Spanner Omni, this is a - * previously created location. + * Where this tablet is located. This is the name of a Google Cloud region, + * such as "us-central1". * @type int $role * The role of the tablet. * @type string $incarnation @@ -224,9 +222,8 @@ public function setServerAddress($var) } /** - * Where this tablet is located. In the Spanner managed service, this is the - * name of a region, such as "us-central1". In Spanner Omni, this is a - * previously created location. + * Where this tablet is located. This is the name of a Google Cloud region, + * such as "us-central1". * * Generated from protobuf field string location = 3; * @return string @@ -237,9 +234,8 @@ public function getLocation() } /** - * Where this tablet is located. In the Spanner managed service, this is the - * name of a region, such as "us-central1". In Spanner Omni, this is a - * previously created location. + * Where this tablet is located. This is the name of a Google Cloud region, + * such as "us-central1". * * Generated from protobuf field string location = 3; * @param string $var diff --git a/Storage/src/BucketIterator.php b/Storage/src/BucketIterator.php new file mode 100644 index 000000000000..3f1164ceddd8 --- /dev/null +++ b/Storage/src/BucketIterator.php @@ -0,0 +1,50 @@ + + */ + public function unreachable() + { + return $this->unreachable->getArrayCopy(); + } +} diff --git a/Storage/src/Connection/ServiceDefinition/storage-v1.json b/Storage/src/Connection/ServiceDefinition/storage-v1.json index 431263d70189..52aa9050a729 100644 --- a/Storage/src/Connection/ServiceDefinition/storage-v1.json +++ b/Storage/src/Connection/ServiceDefinition/storage-v1.json @@ -745,6 +745,13 @@ "$ref": "Bucket" } }, + "unreachable": { + "type": "array", + "description": "The list of bucket resource names that could not be reached during the listing operation.", + "items": { + "type": "string" + } + }, "kind": { "type": "string", "description": "The kind of item this is. For lists of buckets, this is always storage#buckets.", @@ -2528,6 +2535,11 @@ "type": "boolean", "description": "If set to true, only soft-deleted bucket versions are listed as distinct results in order of bucket name and generation number. The default value is false.", "location": "query" + }, + "returnPartialSuccess": { + "type": "boolean", + "description": "If true, returns a partial list of buckets. The `unreachable` field will contain buckets that were not reachable.", + "location": "query" } }, "parameterOrder": [ diff --git a/Storage/src/SigningHelper.php b/Storage/src/SigningHelper.php index 6f4292e722fe..8e1d4778175f 100644 --- a/Storage/src/SigningHelper.php +++ b/Storage/src/SigningHelper.php @@ -198,7 +198,7 @@ public function v2Sign(ConnectionInterface $connection, $expires, $resource, $ge // urlencode parameter values foreach ($params as &$value) { - $value = rawurlencode($value); + $value = rawurlencode($value ?? ''); } $params = $this->addCommonParams($generation, $params, $options); @@ -346,7 +346,7 @@ public function v4Sign(ConnectionInterface $connection, $expires, $resource, $ge fn () => $credentials->signBlob($stringToSign, [ 'forceOpenssl' => $options['forceOpenssl'] ]) - ))); + ) ?? '')); // Construct the modified resource name. If a custom hostname is provided, // this will remove the bucket name from the resource. diff --git a/Storage/src/StorageClient.php b/Storage/src/StorageClient.php index 0018aea3a4dd..35c07f7dd0aa 100644 --- a/Storage/src/StorageClient.php +++ b/Storage/src/StorageClient.php @@ -273,24 +273,37 @@ public function bucket($name, $userProject = false, array $options = []) * If false, `$options.userProject` will be used ONLY for the * listBuckets operation. If `$options.userProject` is not set, * this option has no effect. **Defaults to** `true`. + * @type bool $returnPartialSuccess If true, the returned iterator will contain an + * `unreachable` property with a list of buckets that were not retrieved. + * **Note:** If set to false (default) and unreachable buckets are found, + * the operation will throw an exception. + * * } - * @return ItemIterator + * @return BucketIterator * @throws GoogleException When a project ID has not been detected. */ public function buckets(array $options = []) { $this->requireProjectId(); - $resultLimit = $this->pluck('resultLimit', $options, false); - $bucketUserProject = $this->pluck('bucketUserProject', $options, false); - $bucketUserProject = !is_null($bucketUserProject) - ? $bucketUserProject - : true; - $userProject = (isset($options['userProject']) && $bucketUserProject) - ? $options['userProject'] - : null; - - return new ItemIterator( + $bucketUserProject = $this->pluck('bucketUserProject', $options, null) ?? true; + $userProject = $bucketUserProject ? ($options['userProject'] ?? null) : null; + + $unreachable = new \ArrayObject(); + + $apiCall = [$this->connection, 'listBuckets']; + $callDelegate = function (array $args) use ($apiCall, $unreachable) { + $response = call_user_func($apiCall, $args); + if (isset($response['unreachable']) && is_array($response['unreachable'])) { + $current = $unreachable->getArrayCopy(); + $updated = array_unique(array_merge($current, $response['unreachable'])); + $unreachable->exchangeArray($updated); + } + return $response; + }; + + // Return the new BucketIterator with the wrapped unreachable bucket + return new BucketIterator( new PageIterator( function (array $bucket) use ($userProject) { return new Bucket( @@ -299,10 +312,11 @@ function (array $bucket) use ($userProject) { $bucket + ['requesterProjectId' => $userProject] ); }, - [$this->connection, 'listBuckets'], + $callDelegate, $options + ['project' => $this->projectId], ['resultLimit' => $resultLimit] - ) + ), + $unreachable ); } diff --git a/Storage/tests/Unit/StorageClientTest.php b/Storage/tests/Unit/StorageClientTest.php index afa5f80f3980..9f8b5ea117c7 100644 --- a/Storage/tests/Unit/StorageClientTest.php +++ b/Storage/tests/Unit/StorageClientTest.php @@ -46,6 +46,8 @@ class StorageClientTest extends TestCase use ProphecyTrait; const PROJECT = 'my-project'; + + public $client; public $connection; public function setUp(): void @@ -416,7 +418,7 @@ public function testRetriesConfiguration( } $objects = iterator_to_array($client->bucket('myBucket')->objects()); - + $this->assertEquals('file.txt', $objects[0]->name()); $this->assertEquals($expectedRemainingResponses, $mockHandler->count()); } @@ -574,7 +576,7 @@ public function testDelayFunctionsConfiguration() ]); $objects = iterator_to_array($client->bucket('myBucket')->objects()); - + $this->assertEquals('file.txt', $objects[0]->name()); $this->assertEquals([100, 200], $capturedDelays); } @@ -622,7 +624,7 @@ public function testRetryListenerConfiguration() ]; $mockHandler = new MockHandler($mockResponses); $handlerStack = HandlerStack::create($mockHandler); - + $requestHistory = []; $handlerStack->push(\GuzzleHttp\Middleware::history($requestHistory)); $guzzleClient = new \GuzzleHttp\Client(['handler' => $handlerStack]); @@ -656,6 +658,100 @@ public function testRetryListenerConfiguration() $this->assertFalse($requestHistory[0]['request']->hasHeader('X-Retry-Attempt')); $this->assertEquals('1', $requestHistory[1]['request']->getHeaderLine('X-Retry-Attempt')); } + + public function testListBucketsReturnPartialSuccess() + { + $expectedUnreachable = [ + 'projects/_/buckets/unreachable-1', + 'projects/_/buckets/unreachable-2', + ]; + + $this->connection->listBuckets( + Argument::withEntry('returnPartialSuccess', true) + )->willReturn([ + 'nextPageToken' => 'token', + 'unreachable' => $expectedUnreachable, + 'items' => [ + ['name' => 'bucket1'] + ] + ], [ + 'items' => [ + ['name' => 'bucket2'] + ] + ]); + + $this->connection->projectId() + ->willReturn(self::PROJECT); + + $this->client->___setProperty('connection', $this->connection->reveal()); + $responseWrapper = $this->client->buckets(['returnPartialSuccess' => true]); + + $this->assertInstanceOf( + \Google\Cloud\Storage\BucketIterator::class, + $responseWrapper + ); + $bucket = iterator_to_array($responseWrapper); + + $this->assertCount(2, $bucket); + $this->assertEquals('bucket1', $bucket[0]->name()); + $this->assertEquals('bucket2', $bucket[1]->name()); + $this->assertNotEmpty($responseWrapper->unreachable()); + $this->assertEquals($expectedUnreachable, $responseWrapper->unreachable()); + } + + public function testBucketsIgnoresUnreachableWhenPartialSuccessIsFalse() + { + $this->connection->listBuckets( + Argument::withEntry('returnPartialSuccess', false) + )->willReturn([ + 'nextPageToken' => 'token', + 'items' => [ + ['name' => 'bucket1'] + ] + ], [ + 'items' => [ + ['name' => 'bucket2'] + ] + ]); + + $this->connection->projectId() + ->willReturn(self::PROJECT); + $this->client->___setProperty('connection', $this->connection->reveal()); + $responseWrapper = $this->client->buckets(['returnPartialSuccess' => false]); + $bucket = iterator_to_array($responseWrapper); + + $this->assertCount(2, $bucket); + $this->assertEquals('bucket1', $bucket[0]->name()); + $this->assertEquals('bucket2', $bucket[1]->name()); + $this->assertEmpty($responseWrapper->unreachable()); + } + + public function testBucketsIgnoresUnreachableWhenOptionIsAbsent() + { + $this->connection->listBuckets( + Argument::withEntry('project', self::PROJECT) + )->willReturn([ + 'nextPageToken' => 'token', + 'items' => [ + ['name' => 'bucket1'] + ] + ], [ + 'items' => [ + ['name' => 'bucket2'] + ] + ]); + + $this->connection->projectId() + ->willReturn(self::PROJECT); + $this->client->___setProperty('connection', $this->connection->reveal()); + $responseWrapper = $this->client->buckets(); + $bucket = iterator_to_array($responseWrapper); + + $this->assertCount(2, $bucket); + $this->assertEquals('bucket1', $bucket[0]->name()); + $this->assertEquals('bucket2', $bucket[1]->name()); + $this->assertEmpty($responseWrapper->unreachable()); + } } //@codingStandardsIgnoreStart diff --git a/Storage/tests/Unit/StreamWrapperTest.php b/Storage/tests/Unit/StreamWrapperTest.php index 40868e52a552..03c24009d809 100644 --- a/Storage/tests/Unit/StreamWrapperTest.php +++ b/Storage/tests/Unit/StreamWrapperTest.php @@ -37,9 +37,8 @@ class StreamWrapperTest extends TestCase { use ProphecyTrait; - private $originalDefaultContext; - - private $connection; + public $bucket; + public $client; public function setUp(): void { diff --git a/phpunit.xml.dist b/phpunit.xml.dist index a6c856045372..cc85a8755277 100644 --- a/phpunit.xml.dist +++ b/phpunit.xml.dist @@ -1,5 +1,12 @@ - + */src